esp-idf/components/esp_system
Angus Gratton 69309c88a0 Merge branch 'bugfix/fix_c3_typos' into 'master'
esp32c3: fix typos of c3 path

See merge request espressif/esp-idf!13318
2021-04-23 13:05:09 +00:00
..
include
port esp32c3: fix typos of c3 path 2021-04-23 18:11:39 +08:00
test
CMakeLists.txt system: add option to enable undefined behavior sanitizer (UBSAN) 2021-04-22 23:33:45 +02:00
Kconfig panic: handlers can now be placed in flash 2021-04-15 11:58:46 +08:00
README.md
app.lf
component.mk system: add option to enable undefined behavior sanitizer (UBSAN) 2021-04-22 23:33:45 +02:00
crosscore_int.c
dbg_stubs.c
esp_err.c
esp_system.c
fpga_overrides.c
freertos_hooks.c
int_wdt.c
linker.lf system: add option to enable undefined behavior sanitizer (UBSAN) 2021-04-22 23:33:45 +02:00
panic.c system: add option to enable undefined behavior sanitizer (UBSAN) 2021-04-22 23:33:45 +02:00
sdkconfig.rename
stack_check.c
startup.c
system_time.c
task_wdt.c
ubsan.c system: add option to enable undefined behavior sanitizer (UBSAN) 2021-04-22 23:33:45 +02:00

README.md

System Notes

Timekeeping

The following are the timekeeping mechanisms available and their differences:

  1. System time (esp_system_get_time)

Time with the origin at g_startup_time. The implementation is not handled by esp_system, but it does provide a default implementation using RTC timer. Currently, esp_timer provides system time, since the hardware timers are under the control of that component. However, no matter the underlying timer, the system time provider should maintain the definition of having the origin point at g_startup_time.

  1. esp_timer time (esp_timer_get_time)

This is the time read from an underlying hardware timer, controlled through config. Origin is at the point where the underlying timer starts counting.

  1. newlib time (gettimeofday)

Timekeeping function in standard library. Can be set (settimeofday) or moved forward/backward (adjtime); with the possibility of the changes being made persistent through config. Currently implemented in terms of system time, as the point of origin is fixed. If persistence is enabled, RTC time is also used in conjuction with system time.

  1. RTC time (esp_rtc_get_time_us)

Time read from RTC timer.