esp-idf/components/esp_system
Mahavir Jain 94bf4710fa
fix(esp32h2): program use_hardware_k efuse bit for ECDSA key purpose
In ESP32-H2, the ECDSA peripheral by default uses the TRNG (hardware)
generated k value but it can be overridden to software supplied k.
This can happen through by overriding the `ECDSA_SOFTWARE_SET_K` bit
in the configuration register. Even though the HAL API is not exposed
for this but still it could be achieved by direct register
programming. And for this scenario, if sufficiently random k is not
supplied by the software then it could posses a security risk.

In this change, we are unconditionally programming the efuse
`ESP_EFUSE_ECDSA_FORCE_USE_HARDWARE_K` bit during startup security
checks itself. Additionally, same is ensured in the `esp_efuse_write_key`
API as well. This always enforces the hardware k mode in the ECDSA
peripheral and ensures strongest possible security.
2023-11-15 09:42:26 +05:30
..
include feat(wdt): add multicore support for WDTs on RISCV 2023-10-23 18:26:08 +08:00
ld fix: Fix ESP32-P4 lp_reserved_seg origin 2023-10-25 08:09:33 +02:00
port Merge branch 'task/freertos_deprecate_xtaskgetaffinity' into 'master' 2023-11-13 20:23:49 +08:00
task_wdt change(freertos/idf): Deprecate some FreeRTOS IDF addition functions 2023-11-03 14:54:06 +01:00
test_apps Merge branch 'feature/freertos_expose_list_integrity_check_option' into 'master' 2023-11-14 21:27:19 +08:00
test_eh_frame_parser
CMakeLists.txt refactor(system): removed dependency on driver from g1 components 2023-11-13 15:42:48 +08:00
Kconfig fix(console): enable to select UART1 port for console output 2023-11-09 22:32:49 +08:00
README.md
app.lf
check_system_init_priorities.py
crosscore_int.c feat(wdt): add multicore support for WDTs on RISCV 2023-10-23 18:26:08 +08:00
debug_stubs.c
eh_frame_parser.c
esp_err.c
esp_ipc.c
esp_system.c
fpga_overrides.c
freertos_hooks.c
hw_stack_guard.c
int_wdt.c
linker.lf
panic.c
sdkconfig.rename
sdkconfig.rename.esp32
sdkconfig.rename.esp32c3
sdkconfig.rename.esp32s2
sdkconfig.rename.esp32s3
stack_check.c
startup.c fix(esp32h2): program use_hardware_k efuse bit for ECDSA key purpose 2023-11-15 09:42:26 +05:30
system_init_fn.txt
system_time.c
systick_etm.c
ubsan.c
xt_wdt.c

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.

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.