esp-idf/components/hal/include/hal
2022-12-29 14:46:16 +08:00
..
adc_hal_common.h esp_adc: new esp_adc component and adc drivers 2022-07-15 18:31:00 +08:00
adc_hal.h adc: support ADC on esp32c6 (hal) 2022-12-23 11:24:06 +08:00
adc_oneshot_hal.h esp_adc: new esp_adc component and adc drivers 2022-07-15 18:31:00 +08:00
adc_types_private.h adc: add ADC target test for esp32c6 2022-12-23 14:05:56 +08:00
adc_types.h adc: support ADC on esp32c6 (driver/test/example) 2022-12-23 11:24:06 +08:00
aes_hal.h AES/SHA: use GDMA driver instead of LL 2021-01-19 11:02:51 +08:00
aes_types.h AES: refactor and add HAL layer 2020-12-10 09:04:47 +00:00
brownout_hal.h spi_flash: Making XMC flash works more stable when brownout detected 2022-06-02 10:38:55 +08:00
cache_hal.h cache/mmu: implememnt cache and mmu hal APIs in bootloader 2022-03-11 22:43:11 +08:00
cache_types.h cache/mmu: implememnt cache and mmu hal APIs in bootloader 2022-03-11 22:43:11 +08:00
dac_types.h dac: optimize the dma stratege 2022-10-25 17:14:59 +08:00
dma_types.h C/Cxx: unify static assertions with the macro ESP_STATIC_ASSERT 2022-11-21 16:18:08 +08:00
ds_hal.h Digital Signature support for S3 2021-09-02 11:59:24 +05:30
ecc_hal.h esp32c2/hal: Added ECC HAL layer 2022-03-08 14:05:23 +00:00
ecc_types.h esp32c2/hal: Added ECC HAL layer 2022-03-08 14:05:23 +00:00
efuse_hal.h efuse: Adds major and minor versions and others 2022-07-05 14:38:27 +08:00
emac_hal.h Merge branch 'feature/emac_buff' into 'master' 2022-11-24 00:48:19 +08:00
esp_flash_err.h hal: extract hal component from soc component 2020-09-01 13:25:32 +08:00
eth_types.h esp_eth: Update esp32's EMAC API to decouple driver and vendor config 2022-02-14 16:17:29 +00:00
etm_hal.h etm: added etm channel allocator 2022-11-23 15:31:33 +08:00
gdma_hal.h gdma: support IRAM interrupt 2021-11-08 16:14:51 +08:00
gdma_types.h gdma: support etm extension 2022-11-23 15:32:34 +08:00
glitch_filter_types.h glitch_filter: support derive clock source form IO MUX 2022-12-29 14:46:16 +08:00
gpio_hal.h gpio: Fix IO hold function related problems 2022-11-11 20:39:04 +08:00
gpio_types.h ESP32-H2: Last MR for g0 component support, (only hal left) 2022-12-05 17:32:21 +08:00
hmac_hal.h hmac_hal: Merge hmac hal layer for different into one 2022-11-24 16:04:26 +05:30
i2c_hal.h I2C: Add i2c support for ESP32C6 2022-11-07 14:12:53 +08:00
i2c_types.h I2C: Refactor i2c hal and ll 2022-09-01 15:53:59 +08:00
i2s_hal.h i2s: fixed typo 'philip' 2022-11-21 15:58:06 +08:00
i2s_types.h i2s: support 4 line pdm rx on esp32s3 2022-11-04 15:46:34 +08:00
lcd_hal.h rgb_lcd: workaround pclk polarity bug by setting mo>=2 2022-07-21 13:06:09 +00:00
lcd_types.h rgb_lcd: support yuv converter 2022-08-17 06:33:06 +00:00
ledc_hal.h ledc: Move ledc unit test to test_apps pytest framework 2022-12-21 12:04:42 +08:00
ledc_types.h ledc: Add basic support for esp32c6 2022-12-07 18:40:50 +08:00
mcpwm_hal.h mcpwm: clean up hal driver and add doc 2022-06-02 15:01:18 +08:00
mcpwm_types.h driver: fix public header exceptions for driver 2022-07-22 00:12:36 +00:00
memprot_types.h Clean IRAM and DRAM address space conversion macros 2022-07-29 17:07:39 +08:00
mmu_hal.h MMU: Add configurable mmu page size support on ESP32C2 2022-06-08 19:34:31 +08:00
mmu_types.h esp32c6: add hal support 2022-09-01 12:37:51 +08:00
modem_clock_types.h modem clock(driver): implemented the modem clock driver for esp32c6 2022-12-27 21:31:59 +08:00
mpu_hal.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
mpu_types.h hal: explicitly include soc_caps.h 2021-01-07 10:13:17 +08:00
pcnt_hal.h pulse_cnt: new driver for PCNT peripheral 2022-03-03 22:38:32 +08:00
pcnt_types.h pulse_cnt: new driver for PCNT peripheral 2022-03-03 22:38:32 +08:00
readme.md hal: extract hal component from soc component 2020-09-01 13:25:32 +08:00
rmt_hal.h driver_ng: implement new rmt driver 2022-05-07 10:34:50 +00:00
rmt_types.h sdm: clean up soc/hal/ll code 2022-07-20 14:59:50 +08:00
rtc_hal.h gpio: Fix IO hold function related problems 2022-11-11 20:39:04 +08:00
rtc_io_hal.h rtcio: support rtcio on c6 2022-12-22 14:14:38 +08:00
rtc_io_types.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
sdio_slave_hal.h sdio_slave: allow disabling highspeed mode 2022-09-27 18:38:35 +08:00
sdio_slave_ll.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
sdio_slave_types.h sdio_slave: allow disabling highspeed mode 2022-09-27 18:38:35 +08:00
sdm_hal.h sdm: clean up soc/hal/ll code 2022-07-20 14:59:50 +08:00
sdm_types.h sdm: clean up soc/hal/ll code 2022-07-20 14:59:50 +08:00
sha_hal.h AES/SHA: use GDMA driver instead of LL 2021-01-19 11:02:51 +08:00
sha_types.h ESP32-H2: Last MR for g0 component support, (only hal left) 2022-12-05 17:32:21 +08:00
spi_flash_encrypt_hal.h spi_flash: refactoring flash encryption into new api 2021-04-25 17:09:25 +08:00
spi_flash_hal.h C/Cxx: unify static assertions with the macro ESP_STATIC_ASSERT 2022-11-21 16:18:08 +08:00
spi_flash_types.h spi_flash: refactor the spi_flash clock configuration, and add support for esp32c2 2022-04-26 15:22:37 +08:00
spi_hal.h spi: support spi on 8684 2022-01-12 11:30:29 +08:00
spi_slave_hal.h spi: limit esp32 dma workaround only on esp32 2022-11-14 16:01:48 +08:00
spi_slave_hd_hal.h spi_slv_hd: add hal_trans_finish comments for clarifying risk 2021-02-24 12:01:31 +08:00
spi_types.h SPI : fix wrong dummy cycle on quad mode and put get-command function in spi_ll.h 2022-08-23 10:46:56 +08:00
systimer_hal.h hal: Adds hal/ll func for SYSTIMER to select clock source: XTAL or RC_FAST_CLK 2022-11-22 20:29:19 +08:00
systimer_types.h C/Cxx: unify static assertions with the macro ESP_STATIC_ASSERT 2022-11-21 16:18:08 +08:00
temperature_sensor_types.h sdm: clean up soc/hal/ll code 2022-07-20 14:59:50 +08:00
timer_hal.h gptimer: bringup driver on esp32c6 2022-09-13 10:50:58 +08:00
timer_types.h gptimer: support etm event and task 2022-11-23 15:31:33 +08:00
touch_sensor_hal.h rtc_clk: Clean up some clock related enum and macro in soc/rtc.h, replace with new ones in 2022-05-24 22:59:41 +08:00
touch_sensor_types.h soc: don't expose unstable soc header files in public api 2022-01-06 23:10:22 +08:00
twai_hal.h twai: bringup on esp32c6 2022-11-04 17:40:29 +08:00
twai_types.h twai: bringup on esp32c6 2022-11-04 17:40:29 +08:00
uart_hal.h uart: move frequency of clock sources out of HAL 2022-08-15 18:55:43 +00:00
uart_types.h driver: remove deprecated code 2022-05-19 11:31:53 +08:00
uhci_types.h examples: added support of ESP32-S3 chip in controller_hci_uart example 2021-08-26 14:24:32 +08:00
usb_dwc_hal.h usb_host: Rename struct/ll/hal symbols to use "usb_dwc" prefix 2022-09-16 16:45:26 +08:00
usb_dwc_ll.h usb_host: Rename struct/ll/hal symbols to use "usb_dwc" prefix 2022-09-16 16:45:26 +08:00
usb_hal.h hal: extract hal component from soc component 2020-09-01 13:25:32 +08:00
usb_phy_hal.h usb: Add usb_phy driver to support operations on USB PHY 2021-09-13 12:39:56 +08:00
usb_phy_types.h usb: Add usb_phy driver to support operations on USB PHY 2021-09-13 12:39:56 +08:00
usb_types_private.h Add USB Host Library 2021-08-24 23:28:00 +08:00
wdt_hal.h ESP32-H2: Last MR for g0 component support, (only hal left) 2022-12-05 17:32:21 +08:00
wdt_types.h hal: extract hal component from soc component 2020-09-01 13:25:32 +08:00
xt_wdt_hal.h WDT: Add support for XTAL32K Watchdog timer 2021-09-02 09:09:00 +08:00

HAL Layer Readme

The HAL layer is designed to be used by the drivers. We don't guarantee the stability and back-compatibility among versions. The HAL layer may update very frequently with the driver. Please don't use them in the applications or treat them as stable APIs.

The HAL layer consists of two layers: HAL (upper) and Lowlevel(bottom). The HAL layer defines the steps and data required by the peripheral. The lowlevel is a translation layer converting general conceptions to register configurations.

Lowlevel

This layer should be all static inline. The first argument of LL functions is usually a pointer to the beginning address of the peripheral register. Each chip should have its own LL layer. The functions in this layer should be atomic and independent from each other so that the upper layer can change/perform one of the options/operation without touching the others.

HAL

This layer should depend on the operating system as little as possible. It's a wrapping of LL functions, so that the upper layer can combine basic steps into different working ways (polling, non-polling, interrupt, etc.). Without using queues/locks/delay/loop/etc., this layer can be easily port to other os or simulation systems.

To get better performance and better porting ability, contexts are used to hold sustainable data and pass the parameters.

To develop your own driver, it is suggested to copy the HAL layer to your own code and keep them until manual update.