laokaiyao ffb40a89d9 adc_cali: supported channel compensation of adc calibration on esp32c6 vor 2 Jahren
..
adc_hal.h 73791ff4e0 adc: fix adc continuous driver conv_frame_size not bigger than 4092 issue vor 2 Jahren
adc_hal_common.h 5b523a3313 esp_adc: new esp_adc component and adc drivers vor 3 Jahren
adc_oneshot_hal.h 5653018cd1 esp_adc: support selecting clock source for oneshot driver vor 3 Jahren
adc_types.h b7053b46ef esp32h4: remove esp32h4 target from peripherals vor 2 Jahren
adc_types_private.h b7053b46ef esp32h4: remove esp32h4 target from peripherals vor 2 Jahren
aes_hal.h 51169b0e0c AES/SHA: use GDMA driver instead of LL vor 5 Jahren
aes_types.h 457ce080ae AES: refactor and add HAL layer vor 5 Jahren
apm_hal.h 8d0f6dab0f apm: added support for APM on esp32c6 vor 3 Jahren
apm_types.h 8d0f6dab0f apm: added support for APM on esp32c6 vor 3 Jahren
brownout_hal.h 56a2d0b8a2 BOD: Bringup for ESP32C6 vor 3 Jahren
cache_hal.h fda9746bb8 esp_mm: cache_msync API vor 2 Jahren
cache_types.h c1cbd7bbf6 cache/mmu: implememnt cache and mmu hal APIs in bootloader vor 3 Jahren
clk_tree_hal.h 2c9aa4559c clk_tree: Add a general API to get the frequency of different clocks vor 3 Jahren
dac_types.h 8ef9fd4623 dac: optimize the dma stratege vor 3 Jahren
dma_types.h 73791ff4e0 adc: fix adc continuous driver conv_frame_size not bigger than 4092 issue vor 2 Jahren
ds_hal.h f80d6f8c21 Digital Signature support for S3 vor 4 Jahren
ecc_hal.h a485b1cb67 esp32h2: Add support for ECC hardware accelerator vor 2 Jahren
ecc_types.h a485b1cb67 esp32h2: Add support for ECC hardware accelerator vor 2 Jahren
ecdsa_hal.h d634970ed1 ecdsa: Support multiple ECDSA keys vor 2 Jahren
ecdsa_types.h d345c684ba esp32h2: Add support for ECDSA peripheral vor 2 Jahren
efuse_hal.h ffb40a89d9 adc_cali: supported channel compensation of adc calibration on esp32c6 vor 2 Jahren
emac_hal.h 621d5ef724 fixed emac soc structs names to be able to build under C++ vor 2 Jahren
esp_flash_err.h 5425ef4ee4 hal: extract hal component from soc component vor 5 Jahren
eth_types.h 8da2e4088c esp_eth: Update esp32's EMAC API to decouple driver and vendor config vor 4 Jahren
etm_hal.h fb26d0e11f etm: added etm channel allocator vor 3 Jahren
gdma_hal.h 83d16aa00c gdma: support IRAM interrupt vor 4 Jahren
gdma_types.h f534247a00 driver: add parallel IO TX driver vor 2 Jahren
glitch_filter_types.h ca1b182b25 glitch_filter: support derive clock source form IO MUX vor 3 Jahren
gpio_hal.h 51777a6862 gpio: Fix io hold functionality on esp32c6 and esp32h2 vor 2 Jahren
gpio_types.h b7053b46ef esp32h4: remove esp32h4 target from peripherals vor 2 Jahren
hmac_hal.h 1c233cc508 hmac_hal: Merge hmac hal layer for different into one vor 3 Jahren
i2c_hal.h 803fc3fbe0 I2C: Add i2c support for ESP32C6 vor 3 Jahren
i2c_types.h ec742abb25 lp-i2c: Added support for LP I2C peripheral to LP core vor 2 Jahren
i2s_hal.h 039af72058 i2s: fixed typo 'philip' vor 3 Jahren
i2s_types.h fa9b022f68 i2s: support 4 line pdm rx on esp32s3 vor 3 Jahren
ieee802154_common_ll.h c8c1cd1c55 ieee802154: support driver opensrc vor 2 Jahren
lcd_hal.h 454d658309 rgb_lcd: workaround pclk polarity bug by setting mo>=2 vor 3 Jahren
lcd_types.h fc1aa2848b rgb_lcd: support yuv converter vor 3 Jahren
ledc_hal.h fcc6514dde ledc: Add an all-in-one HAL function to set fade parameters, and refactor ledc_ll_get_max_duty function vor 2 Jahren
ledc_types.h ad55230b0a ledc: Add support for esp32h2; Refactor ledc driver clock source selection related code vor 3 Jahren
lp_timer_types.h c0ddaa5920 lp_timer: add hal-layer codes for esp32c6 vor 3 Jahren
mcpwm_hal.h f7ff7ac4d0 mcpwm: clean up hal driver and add doc vor 3 Jahren
mcpwm_types.h c4e84751a5 driver: fix public header exceptions for driver vor 3 Jahren
memprot_types.h 7cb9304b65 Clean IRAM and DRAM address space conversion macros vor 3 Jahren
mmu_hal.h bae6680207 mmu: hal function to init, and hal function to unmap all vor 2 Jahren
mmu_types.h 82ee8403b6 mmu: mmu_hal_check_valid_ext_vaddr_region vor 3 Jahren
modem_clock_hal.h 485f2882d1 modem_clock: rename modem_clock_lp_timer to ble_rtc_timer vor 2 Jahren
modem_clock_types.h 63af1e9631 modem clock(driver): implemented the modem clock driver for esp32c6 vor 3 Jahren
mpi_hal.h 4ae1ea7b9f bignum: refactored the hardware abstraction of the mpi peripheral vor 2 Jahren
mpi_types.h 4ae1ea7b9f bignum: refactored the hardware abstraction of the mpi peripheral vor 2 Jahren
mpu_hal.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) vor 5 Jahren
mpu_types.h 58c3f6a421 hal: explicitly include soc_caps.h vor 5 Jahren
parlio_hal.h f534247a00 driver: add parallel IO TX driver vor 2 Jahren
parlio_types.h f534247a00 driver: add parallel IO TX driver vor 2 Jahren
pau_hal.h 5850cd7492 pau: implement the pau regdma hal&ll layer for esp32c6 vor 3 Jahren
pau_types.h d3e0e3e3b6 pau: implement the pau regdma driver for esp32c6 vor 3 Jahren
pcnt_hal.h ec8defaa96 pulse_cnt: new driver for PCNT peripheral vor 3 Jahren
pcnt_types.h ec8defaa96 pulse_cnt: new driver for PCNT peripheral vor 3 Jahren
pmu_types.h 6c1f58f135 pmu: add hal layer codes for esp32c6 vor 3 Jahren
readme.md 5425ef4ee4 hal: extract hal component from soc component vor 5 Jahren
rmt_hal.h 2fb43820c2 driver_ng: implement new rmt driver vor 3 Jahren
rmt_types.h d82981c437 rmt: use gpio_num_t to define gpio number vor 2 Jahren
rtc_hal.h 9eae151f7c esp32c6: bringup deepsleep examples vor 2 Jahren
rtc_io_hal.h 9eae151f7c esp32c6: bringup deepsleep examples vor 2 Jahren
rtc_io_types.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) vor 5 Jahren
sdio_slave_hal.h f1de9faa71 sdio: c6 support vor 3 Jahren
sdio_slave_types.h 507864c4f1 sdio_slave: allow disabling highspeed mode vor 3 Jahren
sdm_hal.h 4154eaec93 sdm: clean up soc/hal/ll code vor 3 Jahren
sdm_types.h 4154eaec93 sdm: clean up soc/hal/ll code vor 3 Jahren
sha_hal.h 51169b0e0c AES/SHA: use GDMA driver instead of LL vor 5 Jahren
sha_types.h b7053b46ef esp32h4: remove esp32h4 target from peripherals vor 2 Jahren
spi_flash_encrypt_hal.h 0d81edb174 spi_flash: refactoring flash encryption into new api vor 4 Jahren
spi_flash_hal.h ed96dadd06 spi_flash: 2nd stage for supporting flash suspend. (1). Support more esp chips (2). Improve real-time performance (3). Making timing more stable (4) Add documents vor 2 Jahren
spi_flash_types.h ed96dadd06 spi_flash: 2nd stage for supporting flash suspend. (1). Support more esp chips (2). Improve real-time performance (3). Making timing more stable (4) Add documents vor 2 Jahren
spi_hal.h 184145817c spi_master: add feature spi periph clk source selectable vor 3 Jahren
spi_slave_hal.h ea0b839302 spi: limit esp32 dma workaround only on esp32 vor 3 Jahren
spi_slave_hd_hal.h 66ca403bc6 spi_slave: support spi slave hd append mode on chips other than s2 vor 2 Jahren
spi_types.h 184145817c spi_master: add feature spi periph clk source selectable vor 3 Jahren
systimer_hal.h 63f852adc8 hal: Adds hal/ll func for SYSTIMER to select clock source: XTAL or RC_FAST_CLK vor 3 Jahren
systimer_types.h cd21058097 C/Cxx: unify static assertions with the macro ESP_STATIC_ASSERT vor 3 Jahren
temperature_sensor_types.h 4154eaec93 sdm: clean up soc/hal/ll code vor 3 Jahren
timer_hal.h a1030307f1 gptimer: bringup driver on esp32c6 vor 3 Jahren
timer_types.h 00b6ec28b2 gptimer: support etm event and task vor 3 Jahren
touch_sensor_hal.h a5b09cf015 rtc_clk: Clean up some clock related enum and macro in soc/rtc.h, replace with new ones in vor 3 Jahren
touch_sensor_types.h 869bed1bb5 soc: don't expose unstable soc header files in public api vor 4 Jahren
twai_hal.h a25123f703 twai: bringup on esp32c6 vor 3 Jahren
twai_types.h a18d7e24d6 Fix initialization macros for twai_timing_config_t not setting .clk_src and .brp vor 2 Jahren
uart_hal.h b69f983525 uart: Fix two TX concurrency issues vor 3 Jahren
uart_types.h 8138f8bb02 driver: remove deprecated code vor 3 Jahren
uhci_types.h c053ef0541 examples: added support of ESP32-S3 chip in controller_hci_uart example vor 4 Jahren
usb_dwc_hal.h d333833f59 usb_host: Rename struct/ll/hal symbols to use "usb_dwc" prefix vor 3 Jahren
usb_dwc_ll.h d333833f59 usb_host: Rename struct/ll/hal symbols to use "usb_dwc" prefix vor 3 Jahren
usb_hal.h 5425ef4ee4 hal: extract hal component from soc component vor 5 Jahren
usb_phy_hal.h 1fcd639224 usb: Add usb_phy driver to support operations on USB PHY vor 4 Jahren
usb_phy_types.h 1fcd639224 usb: Add usb_phy driver to support operations on USB PHY vor 4 Jahren
usb_types_private.h accbaee57c Add USB Host Library vor 4 Jahren
wdt_hal.h 9c37441b17 wdt: refactor wdt codes to use unified type vor 3 Jahren
wdt_types.h 5e9e8c396f wdt: add support for WDTs on C6 vor 3 Jahren
xt_wdt_hal.h 4869b3cd4a WDT: Add support for XTAL32K Watchdog timer vor 4 Jahren

readme.md

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.