esp-idf/components/esp_system
morris 523c51818c Merge branch 'feature/c2_soc_hwsupport_code' into 'master'
ESP32-C2 (729) RTC update (Clock, PM)

Closes IDF-3833 and IDF-4874

See merge request espressif/esp-idf!17311
2022-05-11 11:23:57 +08:00
..
include Remove IRAM_ATTR from any function declarations 2022-03-22 09:58:50 +00:00
ld esp_common: rename EXT_RAM_ATTR to EXT_RAM_BSS_ATTR to make it clearer 2022-04-19 19:48:00 +08:00
port C2 rtc code 2022-05-09 17:50:54 +08:00
test uart: add default source clock for all targets 2022-05-09 11:26:30 +08:00
test_eh_frame_parser esp_hw_support/esp_system: Re-evaluate header inclusions and include directories 2022-03-07 11:18:08 +05:30
app.lf esp32: move common fragment definitions 2021-03-31 19:17:33 +08:00
CMakeLists.txt Merge branch 'refactor/move_rtc_ctrl_to_esp_hw_support' into 'master' 2022-05-05 11:57:31 +08:00
crosscore_int.c This commit add to GDBstup: 2022-03-01 19:49:24 +03:00
debug_stubs.c debug_stubs: Refactor and add support for RISCV 2021-11-04 01:33:24 +03:00
eh_frame_parser.c esp_hw_support/esp_system: Re-evaluate header inclusions and include directories 2022-03-07 11:18:08 +05:30
esp_err.c esp_common: move esp_err 2021-02-24 12:16:37 +08:00
esp_ipc.c global: fix some potential out-of-bounds issue 2022-04-08 11:05:43 +08:00
esp_system.c freertos: Fix usage of vTaskSuspendAll()/xTaskResumeAll() 2022-03-08 14:59:18 +08:00
fpga_overrides.c ESP8684: add freertos, hal, esp_system support 2021-11-06 17:33:44 +08:00
freertos_hooks.c esp-system: removed esp_phy and nvs dependencies, change app update and pm to weak dependencies 2022-03-22 11:19:32 +08:00
int_wdt.c esp_hw_support/esp_system: Re-evaluate header inclusions and include directories 2022-03-07 11:18:08 +05:30
Kconfig soc: moved kconfig options out of the target component. 2022-04-21 12:09:43 +08:00
linker.lf system: add option to enable undefined behavior sanitizer (UBSAN) 2021-04-22 23:33:45 +02:00
panic.c esp-system: removed esp_phy and nvs dependencies, change app update and pm to weak dependencies 2022-03-22 11:19:32 +08:00
README.md esp_system: add notes on timekeeping 2021-03-25 16:09:33 +08:00
sdkconfig.rename system: move kconfig options out of target component 2022-03-02 01:22:26 +00:00
sdkconfig.rename.esp32 soc: moved kconfig options out of the target component. 2022-04-21 12:09:43 +08:00
sdkconfig.rename.esp32c3 soc: moved kconfig options out of the target component. 2022-04-21 12:09:43 +08:00
sdkconfig.rename.esp32h2 soc: moved kconfig options out of the target component. 2022-04-21 12:09:43 +08:00
sdkconfig.rename.esp32s2 soc: moved kconfig options out of the target component. 2022-04-21 12:09:43 +08:00
sdkconfig.rename.esp32s3 soc: moved kconfig options out of the target component. 2022-04-21 12:09:43 +08:00
stack_check.c esp_hw_support/esp_system: Re-evaluate header inclusions and include directories 2022-03-07 11:18:08 +05:30
startup.c esp_system: make dependencies on vfs and esp_wifi optional 2022-05-02 20:47:17 +02:00
system_time.c esp8684: rename target to esp32c2 2022-01-19 11:08:57 +08:00
task_wdt.c freertos: Remove legacy data types 2022-02-09 23:05:45 +08:00
ubsan.c esp_system: fix ubsan builtins' prototypes to suppress Wbuiltin-declaration-mismatch 2022-03-14 09:31:00 +00:00
xt_wdt.c hw_support: move rtc_ctrl from driver to hw_support 2022-04-29 14:28:09 +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.