esp-idf/components/esp_system
Darian Leung a73dd07d12 esp_hw_support: Fix esp_light_sleep_start() deadlock
esp_light_sleep_start() will stall the other CPU via esp_ipc_isr_stall_other_cpu(). After stalling the other CPU,
will call esp_clk_... API which themselves take locks. If the other stalled CPU is holding those locks, this will
result in a deadlock.

This commit adds a workaround calling esp_clk_private_lock() to take the lock before stalling the other CPU.
2022-08-10 18:52:32 +08:00
..
include esp_hw_support: Fix esp_light_sleep_start() deadlock 2022-08-10 18:52:32 +08:00
ld esp_system: allow defining priorities for startup functions 2022-07-12 16:58:14 +02:00
port kconfig: refactor xtal freq kconfig to common configuration item 2022-08-05 19:12:29 +08:00
test build system: re-add -Wno-format as private flag for some components 2022-08-03 16:42:47 +04:00
test_apps docs: changes docs supported targets tables 2022-07-14 08:26:32 +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
.build-test-rules.yml feat: use standalone project idf-build-apps for find/build apps utils 2022-07-14 08:26:31 +08:00
CMakeLists.txt build system: re-add -Wno-format as private flag for some components 2022-08-03 16:42:47 +04:00
Kconfig kconfig: refactor xtal freq kconfig to common configuration item 2022-08-05 19:12:29 +08:00
README.md esp_system: add notes on timekeeping 2021-03-25 16:09:33 +08:00
app.lf esp32: move common fragment definitions 2021-03-31 19:17:33 +08:00
check_system_init_priorities.py esp_system: add a script to check the startup priorities 2022-07-12 16:58:14 +02:00
crosscore_int.c Task WDT: Interuptee task stack is now used for backtracing, regardless of the CPU core 2022-08-02 12:41:14 +08: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_system: fix address printed by ESP_ERROR_CHECK 2022-07-12 17:01:47 +02:00
esp_ipc.c ipc: Increase stacksize when compiling with -O0 2022-07-18 13:55:03 +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 hal: Deprecate interrupt_controller_hal.h, cpu_hal.h and cpu_ll.h interfaces 2022-07-22 00:06:06 +08:00
int_wdt.c hal: Deprecate interrupt_controller_hal.h, cpu_hal.h and cpu_ll.h interfaces 2022-07-22 00:06:06 +08:00
linker.lf esp_system: usb_console: fix restart when Wi-Fi is working 2022-07-28 17:15:03 +02:00
panic.c Task WDT: Interuptee task stack is now used for backtracing, regardless of the CPU core 2022-08-02 12:41:14 +08:00
sdkconfig.rename system: move kconfig options out of target component 2022-03-02 01:22:26 +00:00
sdkconfig.rename.esp32 kconfig: move remaining kconfig options out of target component 2022-05-23 17:57:45 +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 system: moved placement of disable rom log efuse in startup flow 2022-08-01 11:16:17 +08:00
system_init_fn.txt esp_system: usb_console: fix restart when Wi-Fi is working 2022-07-28 17:15:03 +02:00
system_time.c esp8684: rename target to esp32c2 2022-01-19 11:08:57 +08:00
task_wdt.c Task WDT: Interuptee task stack is now used for backtracing, regardless of the CPU core 2022-08-02 12:41:14 +08:00
ubsan.c hal: Deprecate interrupt_controller_hal.h, cpu_hal.h and cpu_ll.h interfaces 2022-07-22 00:06:06 +08:00
xt_wdt.c bugfix (esp_system): made xt_wdt spinlock static 2022-07-22 08:17:59 +00: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.