esp-idf/components/esp_system
Song Ruo Jing 10b41d7a24 Merge branch 'refactor/soc_rtc_h_file' into 'master'
refactor(rtc): move soc/rtc.h from soc to esp_hw_support component

Closes IDF-8941

See merge request espressif/esp-idf!28238
2024-01-26 20:20:20 +08:00
..
include docs(esp_system): Document limitations of esp_execute_shared_stack_function 2024-01-25 19:02:25 +08:00
ld fix(bootloader): Fix compilation issue in bootloader build during verbose+sb+fe 2024-01-18 12:15:15 +05:30
port refactor(rtc): move soc/rtc.h from soc to esp_hw_support component 2024-01-25 19:15:33 +08:00
task_wdt feat(coredump): save twdt panic output to coredump elf file 2023-12-05 13:28:51 +01:00
test_apps fix(uart,usj...): Fix wrong serial number that has been parsed to rom functions, 2024-01-18 10:51:51 +08:00
test_eh_frame_parser refactor(tools): Tidy up core component files copyright ignore 2024-01-22 18:07:35 +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 refactor(startup): implement registration of core init functions 2023-11-27 10:20:51 +01:00
CMakeLists.txt fix(system): fixed -fstack-protector issue on P4 2024-01-25 11:12:35 +08:00
crosscore_int.c refactor(riscv): refactor crosscore interrupt 2024-01-18 16:27:36 +08:00
debug_stubs.c esp_system: fix and reenable no-format warning 2023-03-28 13:42:44 +02:00
eh_frame_parser.c fix(esp_system): fix gcc 13.1.0 warnings 2023-10-09 12:13:02 +04:00
esp_err.c feature: add ram loadable app support 2023-02-01 17:57:22 +08:00
esp_ipc.c refactor(freertos): Refactor usage of portBASE_TYPE to BaseType_t 2023-07-31 17:10:34 +02:00
esp_system.c System: remove digital-system reset within OS restart when Memprot on 2023-06-26 20:22:59 +02:00
fpga_overrides_clk.c fix(uart,usj...): Fix wrong serial number that has been parsed to rom functions, 2024-01-18 10:51:51 +08:00
fpga_overrides_rng.c change(fpga): added bypass rng configuration 2023-12-05 11:38:35 +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
hw_stack_guard.c refactor(riscv): added a new API for the interrupts 2024-01-18 16:36:53 +08:00
int_wdt.c feat(gptimer): use RCC atomic block to enable/reset peripheral 2023-08-22 17:05:35 +08:00
Kconfig fix(uart,usj...): Fix wrong serial number that has been parsed to rom functions, 2024-01-18 10:51:51 +08:00
linker.lf fix(panic): fixed cache error being reported as illegal instruction 2023-12-04 10:49:00 +08:00
panic.c feat(esp32c5): support esp32c5 beta3 48M xtal 2024-01-09 13:11:11 +08: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 esp_system: fix placement of __stack_chk_fail from flash to RAM 2022-12-07 08:49:12 +01:00
startup_funcs.c feat(esp32c5): support esp32c5 beta3 48M xtal 2024-01-09 13:11:11 +08:00
startup.c refactor(startup): implement registration of core init functions 2023-11-27 10:20:51 +01:00
system_init_fn.txt refactor(usb_serial_jtag): make usb_serial_jtag as component 2024-01-05 19:42:04 +08:00
system_time.c feat(esp32c5): add system related supports 2024-01-02 11:17:11 +08:00
systick_etm.c systimer: assign counter and alarm in esp_hw_support 2023-01-10 17:05:49 +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 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.