esp-idf/components/esp_hw_support
Jiang Jiang Jian a8f833a912 Merge branch 'fix/fix_pmu_power_domain_initialize_order_v5.1' into 'release/v5.1'
fix(esp_hw_support): fix pmu power domain initialize order (v5.1)

See merge request espressif/esp-idf!30152
2024-04-10 17:23:55 +08:00
..
dma feat(esp_hw_support): support gdma register context sleep retention 2024-02-23 18:30:17 +08:00
include fix(esp_hw_support): move deepsleep phy callback before PLL disable 2024-04-03 14:11:18 +08:00
port Merge branch 'fix/fix_pmu_power_domain_initialize_order_v5.1' into 'release/v5.1' 2024-04-10 17:23:55 +08:00
test_apps spi_flash: fixed issue that enabling HPM-DC by default may cause app unable to restart 2024-03-12 10:48:08 +08:00
.build-test-rules.yml ci: move linux host tests to test app folder 2023-03-27 17:41:44 +08:00
adc_share_hw_ctrl.c fix(tsens,adc): Fix issue that disable adc will make temperature sensor crash, 2024-02-28 12:35:59 +08:00
clk_ctrl_os.c esp_clk_tree: Rename clk_tree_xxx to esp_clk_tree_xxx, add compilation warning to clk_tree.h 2023-04-27 11:11:18 +00:00
CMakeLists.txt feat(esp_hw_support): support gdma register context sleep retention 2024-02-23 18:30:17 +08:00
cpu.c fix(riscv): supports 1 byte and larger than 64byte range watchpoint setting 2023-11-16 20:40:04 +08:00
esp_clk.c Merge branch 'bugfix/incorrect_time_after_ota_v5.1' into 'release/v5.1' 2023-07-03 20:37:40 +08:00
esp_dpa_protection.c crypto: add support for DPA protection configuration in C6/H2 2023-06-08 20:37:03 +05:30
esp_ds.c esp32h4: remove esp32h4 target from peripherals 2023-04-26 18:53:10 +08:00
esp_etm.c etm: added etm channel allocator 2022-11-23 15:31:33 +08:00
esp_gpio_reserve.c gpio: support runtime preserve 2023-03-17 11:59:49 +08:00
esp_hmac.c fix(esp_hw_support): update hmac toggle method due to discrepency in ROM code 2024-03-12 12:27:39 +05:30
esp_memory_utils.c esp_hw_support: Update memory ptr location/property checks 2023-04-26 04:01:38 +00:00
hw_random.c bugfix: remove the workaround implemented in MR 22773 about the lp_timer 2023-07-11 14:53:02 +08:00
intr_alloc.c fix(esp_hw_support): Fix esp_intr_free when taks has no core affinity 2024-02-26 12:05:32 +02:00
Kconfig Merge branch 'bugfix/fix_c6_wakeup_access_flash_v5.1' into 'release/v5.1' 2024-03-05 10:58:14 +08:00
linker.lf fix(esp_hw_support): fix lightsleep current leakage on usb-phy controlled pad 2023-11-16 20:03:30 +08:00
mac_addr.c feat(mac): Add a configuration to set custom MAC as base MAC 2023-12-07 14:15:40 +08:00
modem_clock.c fix(esp_hw_support): re-initialize icg map in modem_clock_module_enable 2023-12-08 14:22:36 +08:00
mspi_timing_config.h mspi: support 120M DDR flash and psram on S3 (experimental) 2023-04-03 10:30:50 +08:00
mspi_timing_tuning.c change(mspi): remove s3 120mhz sdr warning 2023-09-27 14:57:07 +08:00
periph_ctrl.c change(hal): remove useless code from periph_ll_wifi_bt_module_enable_clk 2023-11-10 11:15:49 +08:00
README.md doc: add api reference for etm driver 2022-11-23 15:32:34 +08:00
regi2c_ctrl.c fix(regi2c): wrong ADC_CALI_PD_WORKAROUND on c6, h2 2023-07-12 17:28:01 +08:00
revision.c soc: Move revision MAX/MIN static assert to esp_hw_support 2023-08-17 15:26:23 +08:00
rtc_module.c ESP32H2: Introduce new chip target esp32h2, hello_world example supported 2022-12-29 12:29:14 +08:00
rtc_wdt.c esp_hw_support: Removes efuse dependency 2022-11-25 19:27:33 +08:00
sar_periph_ctrl_common.c fix(tsens): 300us delay in phy cause extra power consumption 2024-02-28 12:36:04 +08:00
sdkconfig.rename kconfig: also parse target specific sdkconfig.rename.TARGET files 2022-01-31 11:36:08 +08:00
sdkconfig.rename.esp32 change(esp_hw_support/sleep): rename ESP_SLEEP_DEEP_SLEEP_WAKEUP_DELAY 2023-12-27 15:36:20 +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 kconfig: move remaining kconfig options out of target component 2022-05-23 17:57:45 +08:00
sdkconfig.rename.esp32s3 change(esp_hw_support/sleep): rename ESP_SLEEP_DEEP_SLEEP_WAKEUP_DELAY 2023-12-27 15:36:20 +08:00
sleep_clock.c change(pm): change macro SOC_PM_RETENTION_HAS_REGDMA_POWER_BUG 2023-12-19 11:44:23 +08:00
sleep_console.c fix(esp_hw_support): fix lightsleep current leakage on usb-phy controlled pad 2023-11-16 20:03:30 +08:00
sleep_cpu_asm.S feat(PowerManagement/lightsleep): Define and export a strong symbol of rv_core_critical_regs_restore 2023-11-02 11:05:38 +00:00
sleep_cpu.c feat(PowerManagement/lightsleep): Support ESP_SLEEP_EVENT_CALLBACKS 2023-11-02 11:05:38 +00:00
sleep_event.c change(pm): Change sleep callback implement 2023-11-02 11:05:38 +00:00
sleep_gpio.c feat(pm/deepsleep): Support EXT1 wakeup for esp32h2 deep_sleep 2023-08-03 16:46:55 +08:00
sleep_modem.c fix(pm): place extra link opt in iram 2023-12-14 11:17:54 +08:00
sleep_modes.c fix(esp_hw_support): move deepsleep phy callback before PLL disable 2024-04-03 14:11:18 +08:00
sleep_retention.c feat(pm): support PMU trigger regdma when PU TOP 2024-01-16 14:01:22 +08:00
sleep_system_peripheral.c Revert "feat(volt): chip auto adjust volt for esp32c6 & esp32h2" 2023-10-16 14:35:41 +08:00
sleep_wake_stub.c esp32h4: remove esp32h4 target from peripherals 2023-04-26 18:53:10 +08:00

esp_hw_support (G1 component)

This component contains hardware-related operations for supporting the system. These operations are one level above that of hal in that:

  1. it uses system services such as memory allocation, logging, scheduling
  2. it may be multi-step operations involving/affecting multiple parts of the SoC
  3. it offers a service for other components vary from multiple layers (G1, G2 and G3) of ESP-IDF

Implementations that don't fit other components cleanly, but are not worth creating a new component for (yet) may also be placed here as long as they don't pull dependencies other than the core system components.

Event-Task Service (esp_etm)

esp_etm driver design

esp_etm driver is divided into two parts:

  • The core driver, which focuses on ETM channel allocation and offers APIs to connect the channel with ETM tasks and ETM events that come from other peripherals.
  • Peripheral side extensions, e.g. GPTimer support generating different kinds of ETM events, and accept multiple ETM tasks. These extensions are implemented in the peripheral driver, and can be located in different components. Usually, the task and event extensions will simply inherit the interface that defined in the core driver.

See the following class diagram, we take the GPIO and GPTimer as the example to illustrate the architecture of esp_etm driver.

classDiagram
    esp_etm_channel_t "1" --> "1" esp_etm_event_t : Has
    esp_etm_channel_t "1" --> "1" esp_etm_task_t : Has
    class esp_etm_channel_t {
        -int chan_id
        -esp_etm_event_t event
        -esp_etm_task_t task
        +enable() esp_err_t
        +disable() esp_err_t
        +connect(event, task) esp_err_t
        +dump() esp_err_t
    }

    class esp_etm_event_t {
        <<interface>>
        #int event_id
        #etm_trigger_peripheral_t trig_periph
        #del() esp_err_t
    }

    class esp_etm_task_t {
        <<interface>>
        #int task_id
        #etm_trigger_peripheral_t trig_periph
        #del() esp_err_t
    }

    gpio_etm_event_t --|> esp_etm_event_t : Inheritance
    class gpio_etm_event_t {
        -int chan_id
        +bind_gpio(gpio_num_t gpio) esp_err_t
    }

    gpio_etm_task_t --|> esp_etm_task_t : Inheritance
    class gpio_etm_task_t {
        -int chan_id
        +add_gpio(gpio_num) esp_err_t
        +rm_gpio(gpio_num) esp_err_t
    }

    gptimer_t "1" --> "1..*" gptimer_etm_event_t : Has
    gptimer_t "1" --> "1..*" gptimer_etm_task_t : Has
    class gptimer_t {
        -gptimer_etm_event_t[] events
        -gptimer_etm_task_t[] tasks
    }

    gptimer_etm_event_t --|> esp_etm_event_t : Inheritance
    class gptimer_etm_event_t {
    }

    gptimer_etm_task_t --|> esp_etm_task_t : Inheritance
    class gptimer_etm_task_t {
    }