esp-idf/components/esp_system
Angus Gratton cef3b26a91 Merge branch 'refactor/move_from_esp_system' into 'master'
Movements from esp_system

Closes IDF-2165

See merge request espressif/esp-idf!12695
2021-04-08 10:16:08 +00:00
..
include esp_system: move sleep modes to esp_hw_support, power down light sleep to esp_pm 2021-04-07 17:53:37 +08:00
port Merge branch 'refactor/move_from_esp_system' into 'master' 2021-04-08 10:16:08 +00:00
test esp_system: move intr_alloc 2021-04-07 17:53:37 +08:00
app.lf esp32: move common fragment definitions 2021-03-31 19:17:33 +08:00
CMakeLists.txt esp_system: move sleep modes to esp_hw_support, power down light sleep to esp_pm 2021-04-07 17:53:37 +08:00
component.mk esp_system: move sleep modes to esp_hw_support, power down light sleep to esp_pm 2021-04-07 17:53:37 +08:00
crosscore_int.c esp32: move crosscore int 2021-03-31 19:13:03 +08:00
dbg_stubs.c esp_common: move dbg stubs 2021-02-24 12:16:37 +08:00
esp_err.c esp_common: move esp_err 2021-02-24 12:16:37 +08:00
esp_system.c esp32: move system api to esp_system 2021-03-31 19:13:03 +08:00
fpga_overrides.c esp_common: other movements 2021-02-24 12:16:37 +08:00
freertos_hooks.c esp_common: move freertos hooks 2021-02-24 12:16:37 +08:00
int_wdt.c esp_common: move task, int wdt 2021-02-24 12:16:37 +08:00
Kconfig esp_system: move sleep modes to esp_hw_support, power down light sleep to esp_pm 2021-04-07 17:53:37 +08:00
linker.lf esp32: move system api to esp_system 2021-03-31 19:13:03 +08:00
panic.c esp_common: move configs 2021-02-24 12:16:37 +08:00
README.md esp_system: add notes on timekeeping 2021-03-25 16:09:33 +08:00
sdkconfig.rename esp_common: move configs 2021-02-24 12:16:37 +08:00
stack_check.c esp_common: move stack check 2021-02-24 12:16:37 +08:00
startup.c Merge branch 'doc/general_notes' into 'master' 2021-04-05 23:51:25 +00:00
system_time.c esp32c3: Apply one-liner/small changes for ESP32-C3 2020-12-01 10:58:50 +11:00
task_wdt.c wdt: Updates 2021-03-18 02:31:28 +08:00

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.