esp-idf/components/hal/include/hal
Michael (XIAO Xufeng) 6f99b8da73 Merge branch 'bugfix/gpio_pin_num_fix_v4.3' into 'release/v4.3'
gpio: Fix some gpio pin num errors on esp32s2 and esp32c3 (backport v4.3)

See merge request espressif/esp-idf!17109
2022-02-23 03:28:15 +00:00
..
adc_hal.h adc: apply adc power API to adc driver 2021-03-26 17:41:20 +08:00
adc_types.h adc: refactor adc single read api on esp32c3 2021-03-26 13:26:19 +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 soc: combine xxx_caps.h into one soc_caps.h 2020-10-17 16:10:15 +08:00
cpu_hal.h light sleep: dfs support for esp32c3 2021-01-19 14:50:58 +08:00
cpu_types.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
dac_hal.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
dac_types.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
dma_types.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
ds_hal.h [Peripheral/Security] DS peripheral driver 2021-01-05 12:26:59 +08:00
esp_flash_err.h hal: extract hal component from soc component 2020-09-01 13:25:32 +08:00
gdma_hal.h gdma: dynamic alloc DMA channels 2021-01-13 10:52:27 +08:00
gpio_hal.h gpio: Disable USB JTAG when setting pins 18 and 19 as GPIOs on ESP32C3 2021-04-12 17:45:06 +08:00
gpio_types.h gpio: Fix some gpio pin num errors on esp32s2 and esp32c3 2022-02-10 20:27:43 +08:00
hal_defs.h soc/ll: workaround compiler bug that generate 8/16 bits inst instead of 32 bits one 2021-10-12 10:42:04 +08:00
i2c_hal.h global: fix sign-compare warnings 2021-01-12 14:05:08 +08:00
i2c_types.h i2c: Add supports on esp32s3 2020-11-12 11:32:45 +08:00
i2s_hal.h soc: combine xxx_caps.h into one soc_caps.h 2020-10-17 16:10:15 +08:00
i2s_types.h i2s: fix write failure issue in slave mode 2021-10-13 10:22:26 +08:00
interrupt_controller_hal.h interrupt: removed descriptor table from esp32c3 interrupt hal. 2021-01-05 15:39:46 +08:00
interrupt_controller_types.h interrupt: added INTC FLEXIBLE capabillity to esp32c3 CPU caps 2021-01-05 15:39:46 +08:00
ledc_hal.h hal: update link to HAL readme.md 2020-09-11 15:48:08 +08:00
ledc_types.h hal: Add initial ESP32-C3 support 2020-11-30 15:23:15 +11:00
mcpwm_hal.h hal: update link to HAL readme.md 2020-09-11 15:48:08 +08:00
mcpwm_types.h Update components/hal/include/hal/mcpwm_types.h 2021-08-03 15:20:47 +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 Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
pcnt_types.h hal: explicitly include soc_caps.h 2021-01-07 10:13:17 +08:00
readme.md hal: extract hal component from soc component 2020-09-01 13:25:32 +08:00
rmt_hal.h rmt: split TX and RX in LL driver 2020-11-05 19:00:55 +08:00
rmt_types.h rmt: split TX and RX in LL driver 2020-11-05 19:00:55 +08:00
rtc_hal.h esp_system: support gpio wakeup from deep sleep on esp32c3 2021-02-26 17:08:22 +08:00
rtc_io_hal.h esp_system: support gpio wakeup from deep sleep on esp32c3 2021-02-26 17:08:22 +08:00
rtc_io_types.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
sdio_slave_hal.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
sdio_slave_ll.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
sdio_slave_types.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
sha_hal.h AES/SHA: use GDMA driver instead of LL 2021-01-19 11:02:51 +08:00
sha_types.h hal: Add initial ESP32-C3 support 2020-11-30 15:23:15 +11:00
sigmadelta_hal.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
sigmadelta_types.h sigma_delta: add periph signal list and support esp32-s3 2020-10-29 11:06:28 +08:00
soc_hal.h [freertos] Silence sign-conversion warning 2021-01-14 10:54:15 +11:00
spi_flash_hal.h spi_flash: fix cs line setup to make the flash driver more stable 2021-06-15 15:27:51 +08:00
spi_flash_types.h spi_flash: make spiflash compatible with ESP32C3 and ESP32S3 ROM 2021-03-19 16:37:34 +08:00
spi_hal.h spi: remove HSPI macro on esp32c3 and esp32s3 2021-04-06 15:30:28 +08:00
spi_slave_hal.h spi: remove HSPI macro on esp32c3 and esp32s3 2021-04-06 15:30:28 +08:00
spi_slave_hd_hal.h spi_slv_hd: add hal_trans_finish comments for clarifying risk 2021-02-26 10:39:12 +08:00
spi_types.h spi_slave_hd: add callback after data is loaded to the DMA for segment mode 2021-04-28 08:20:55 +00:00
systimer_hal.h freertos: stall systimer while CPU is in debug mode 2021-01-24 11:32:17 +00:00
systimer_types.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
timer_hal.h modbus: fix esp restart does not reset timer groups periph (backport v4.3) 2022-02-16 04:05:37 +00:00
timer_types.h timergroup: move interrupt index into peripheral description file 2020-11-03 18:16:50 +08:00
touch_sensor_hal.h Whitespace: Automated whitespace fixes (large commit) 2020-11-11 07:36:35 +00:00
touch_sensor_types.h hal: Add initial ESP32-C3 support 2020-11-30 15:23:15 +11:00
twai_hal.h TWAI: FIFO overrun handling and errata workarounds 2021-04-26 19:35:13 +08:00
twai_types.h TWAI: Fix incorrect configuration initializers for low speed bit rates 2021-07-19 17:13:34 +08:00
uart_hal.h uart: fix esp32c3 uart output garbage value after resetting 2021-07-21 15:31:50 +08:00
uart_types.h uart: add uart support on esp32s3 2020-11-24 19:12:51 +08:00
usb_hal.h hal: extract hal component from soc component 2020-09-01 13:25:32 +08:00
usb_types.h Add USB Host registers and types and LL layer 2020-12-24 19:43:42 +08:00
wdt_hal.h soc: combine xxx_caps.h into one soc_caps.h 2020-10-17 16:10:15 +08:00
wdt_types.h hal: extract hal component from soc component 2020-09-01 13:25:32 +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.