Li Hang Fan 7de5c312a3 Update components/hal/include/hal/mcpwm_types.h 4 年 前
..
adc_hal.h f48346f22f adc: apply adc power API to adc driver 5 年 前
adc_types.h f1be501271 adc: refactor adc single read api on esp32c3 5 年 前
aes_hal.h 51169b0e0c AES/SHA: use GDMA driver instead of LL 5 年 前
aes_types.h 457ce080ae AES: refactor and add HAL layer 5 年 前
brownout_hal.h 647dea9395 soc: combine xxx_caps.h into one soc_caps.h 5 年 前
cpu_hal.h 355dd10257 light sleep: dfs support for esp32c3 5 年 前
cpu_types.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
dac_hal.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
dac_types.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
dma_types.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
ds_hal.h e532a29288 [Peripheral/Security] DS peripheral driver 5 年 前
esp_flash_err.h 5425ef4ee4 hal: extract hal component from soc component 5 年 前
gdma_hal.h e6d23a35ec gdma: dynamic alloc DMA channels 5 年 前
gpio_hal.h 84dc42c4b0 gpio: Disable USB JTAG when setting pins 18 and 19 as GPIOs on ESP32C3 5 年 前
gpio_types.h 5795075460 gpio: enable GPIO19 on ESP32C3 boards 5 年 前
hal_defs.h 5425ef4ee4 hal: extract hal component from soc component 5 年 前
i2c_hal.h 753a929525 global: fix sign-compare warnings 5 年 前
i2c_types.h 6eee601cf6 i2c: Add supports on esp32s3 5 年 前
i2s_hal.h 647dea9395 soc: combine xxx_caps.h into one soc_caps.h 5 年 前
i2s_types.h 7df1cad1d6 docs: This MR does the following updates: 5 年 前
interrupt_controller_hal.h 72e4655d4e interrupt: removed descriptor table from esp32c3 interrupt hal. 5 年 前
interrupt_controller_types.h 5d316ac142 interrupt: added INTC FLEXIBLE capabillity to esp32c3 CPU caps 5 年 前
ledc_hal.h b2f390df01 hal: update link to HAL readme.md 5 年 前
ledc_types.h 7c08be5771 hal: Add initial ESP32-C3 support 5 年 前
mcpwm_hal.h b2f390df01 hal: update link to HAL readme.md 5 年 前
mcpwm_types.h 7de5c312a3 Update components/hal/include/hal/mcpwm_types.h 4 年 前
mpu_hal.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
mpu_types.h 58c3f6a421 hal: explicitly include soc_caps.h 5 年 前
pcnt_hal.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
pcnt_types.h 58c3f6a421 hal: explicitly include soc_caps.h 5 年 前
readme.md 5425ef4ee4 hal: extract hal component from soc component 5 年 前
rmt_hal.h ff976867b3 rmt: split TX and RX in LL driver 5 年 前
rmt_types.h ff976867b3 rmt: split TX and RX in LL driver 5 年 前
rtc_hal.h 198d350fe5 esp_system: support gpio wakeup from deep sleep on esp32c3 5 年 前
rtc_io_hal.h 198d350fe5 esp_system: support gpio wakeup from deep sleep on esp32c3 5 年 前
rtc_io_types.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
sdio_slave_hal.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
sdio_slave_ll.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
sdio_slave_types.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
sha_hal.h 51169b0e0c AES/SHA: use GDMA driver instead of LL 5 年 前
sha_types.h 7c08be5771 hal: Add initial ESP32-C3 support 5 年 前
sigmadelta_hal.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
sigmadelta_types.h 17808b3ff8 sigma_delta: add periph signal list and support esp32-s3 5 年 前
soc_hal.h ff2d9fd96c [freertos] Silence sign-conversion warning 5 年 前
spi_flash_hal.h 9c7d2c7595 spi_flash: fix cs line setup to make the flash driver more stable 4 年 前
spi_flash_types.h a643ea9432 spi_flash: make spiflash compatible with ESP32C3 and ESP32S3 ROM 5 年 前
spi_hal.h 670b057b04 spi: remove HSPI macro on esp32c3 and esp32s3 5 年 前
spi_slave_hal.h 670b057b04 spi: remove HSPI macro on esp32c3 and esp32s3 5 年 前
spi_slave_hd_hal.h 3e9cd49d32 spi_slv_hd: add hal_trans_finish comments for clarifying risk 5 年 前
spi_types.h 20993109e8 spi_slave_hd: add callback after data is loaded to the DMA for segment mode 4 年 前
systimer_hal.h d7bac619ec freertos: stall systimer while CPU is in debug mode 5 年 前
systimer_types.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
timer_hal.h 1966f00f0b soc: updates caps usage 5 年 前
timer_types.h e4c8ec6174 timergroup: move interrupt index into peripheral description file 5 年 前
touch_sensor_hal.h 66fb5a29bb Whitespace: Automated whitespace fixes (large commit) 5 年 前
touch_sensor_types.h 7c08be5771 hal: Add initial ESP32-C3 support 5 年 前
twai_hal.h 07291fdd27 TWAI: FIFO overrun handling and errata workarounds 4 年 前
twai_types.h e701c98e27 TWAI: Fix incorrect configuration initializers for low speed bit rates 4 年 前
uart_hal.h 427fe1bcde uart: fix esp32c3 uart output garbage value after resetting 4 年 前
uart_types.h fb8b905539 uart: add uart support on esp32s3 5 年 前
usb_hal.h 5425ef4ee4 hal: extract hal component from soc component 5 年 前
usb_types.h 602a747b31 Add USB Host registers and types and LL layer 5 年 前
wdt_hal.h 647dea9395 soc: combine xxx_caps.h into one soc_caps.h 5 年 前
wdt_types.h 5425ef4ee4 hal: extract hal component from soc component 5 年 前

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.