esp-idf/components/esp_system
Jiang Jiang Jian 945af68d74 Merge branch 'feature/esp32c61_light_sleep_support_stage_3' into 'master'
feat(esp_hw_support): esp32c61 sleep support (Stage 3:  support system peripheral sleep retention)

Closes IDF-10384, IDF-10382, and IDF-11004

See merge request espressif/esp-idf!33298
2024-09-21 16:09:36 +08:00
..
include Merge branch 'docs/cpu_lockup' into 'master' 2024-08-27 10:36:11 +08:00
ld Merge branch 'fix/keep-got-sections-for-riscv' into 'master' 2024-09-06 19:21:06 +08:00
port Merge branch 'feature/esp32c61_light_sleep_support_stage_deepsleep' into 'master' 2024-09-20 15:30:30 +08:00
task_wdt fix(system): fixed warnings related to ununsed var if asserts disabled 2024-08-26 10:25:04 +08:00
test_apps Merge branch 'feature/c6_misc_core' into 'master' 2024-09-12 09:46:30 +08:00
test_eh_frame_parser refactor(system): removed esp_system from astyle ignore list and reformated it 2024-01-30 15:17:15 +08:00
app.lf feat(tcm): added tcm basic support on esp32p4 2023-07-25 05:59:10 +00:00
check_system_init_priorities.py fix(esp_system): sort system init priorities also by filename 2024-08-11 20:21:35 +02:00
CMakeLists.txt fix(esp_security): keep esp_security as private dependency for esp_hw_support 2024-08-20 12:35:22 +08:00
crosscore_int.c feat(freertos): Introduced new Kconfig option CONFIG_FREERTOS_NUMBER_OF_CORES 2024-02-09 09:11:28 +01:00
eh_frame_parser.c refactor(system): removed esp_system from astyle ignore list and reformated it 2024-01-30 15:17:15 +08:00
esp_err.c fix(all): remove unused header includes 2024-03-25 13:58:40 +08:00
esp_ipc.c feat(ipc): Adds a new no blocking IPC call 2024-03-22 19:49:42 +02:00
esp_system.c feat(freertos/smp): Update other IDF components to be compatible with FreeRTOS v11.0.1 2024-03-05 15:44:12 +08:00
fpga_overrides_clk.c fix(esp_security): keep esp_security as private dependency for esp_hw_support 2024-08-20 12:35:22 +08:00
fpga_overrides_rng.c change(fpga): added bypass rng configuration 2023-12-05 11:38:35 +08:00
freertos_hooks.c feat(freertos): Introduced new Kconfig option CONFIG_FREERTOS_NUMBER_OF_CORES 2024-02-09 09:11:28 +01:00
hw_stack_guard.c feat(system): esp32p4: support hw stack guard 2024-03-21 14:30:21 +04:00
int_wdt.c feat(esp_hw_support): support top domain powered down during sleep for esp32c5 2024-08-28 10:44:08 +08:00
Kconfig feat(esp_system,ulp): Make LP core reserved memory optionally executable in HP core 2024-09-10 12:17:38 +08:00
linker.lf change(image): move image_process driver from bootloader_support to esp_system 2024-05-22 15:56:07 +08:00
panic.c fix(esp_system): fix GCC 14 analyzer warnings 2024-09-08 13:53:52 +07:00
README.md brownout: Disable the hardware BOD when BOD interrupt is enabled 2023-04-21 10:22:59 +08:00
sdkconfig.rename TWDT: Use the new TWDT Kconfig options in the examples and tests 2023-02-17 11:22:25 +08: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.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 refactor(system): removed esp_system from astyle ignore list and reformated it 2024-01-30 15:17:15 +08:00
startup_funcs.c refactor(esp_psram): Decouple psram init from esp_system 2024-03-11 11:50:43 +01:00
startup.c fix(esp_system): fix GCC 14 analyzer warnings 2024-09-08 13:53:52 +07:00
system_init_fn.txt fix(esp_hw_support): fix mmu memory powered down issue by software backup and restore mmu table content 2024-09-20 14:07:18 +08:00
system_time.c feat(esp32c61): new chip add system and esp_timer support 2024-03-21 11:31:15 +08:00
systick_etm.c systimer: assign counter and alarm in esp_hw_support 2023-01-10 17:05:49 +08:00
ubsan.c refactor(system): removed esp_system from astyle ignore list and reformated it 2024-01-30 15:17:15 +08:00
xt_wdt.c esp_system: fix and reenable no-format warning 2023-03-28 13:42:44 +02: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.

Brownout

on some boards, we name BOD1 as ana_bod, to unify the usage, using BOD1 in following passage.

BOD1 will be a little faster then BOD0, but BOD0 can be widely used(can reset rf, flash, or using interrupt, etc.) So, in IDF code, we use BOD1 in bootloader and BOD0 in the app.