esp-idf/components/soc/include/hal
Michael (XIAO Xufeng) 8a9dc46b14 Merge branch 'bugfix/spi_master_add_dummy_check' into 'master'
spi_master: add dummy check when both mosi and miso are set

Closes IDF-1872 and IDF-266

See merge request espressif/esp-idf!9406
2020-08-23 12:47:18 +08:00
..
adc_hal.h driver(adc): esp32s2 support API adc2_vref_to_gpio 2020-07-01 06:21:45 +00:00
adc_types.h soc: placeholder for esp32s3 HAL driver 2020-08-07 11:59:00 +08:00
brownout_hal.h esp32, esp32s2beta: move brownout.c to esp_common 2020-01-23 13:44:19 +01:00
cpu_hal.h soc: add hal api to set exception vector table base address 2020-03-06 20:23:30 +08:00
cpu_types.h soc: create abstraction for cpu related operations 2020-02-27 07:14:19 +05:00
dac_hal.h Driver(adc): Disable the synchronization operation function of ADC1 and DAC 2020-06-01 16:23:47 +08:00
dac_types.h driver(adc/dac): fix adc dac driver for esp32s2 2020-04-01 12:41:51 +08:00
esp_flash_err.h Fix error code collision and CI check 2019-08-29 08:14:08 +00:00
gpio_hal.h bugfix(gpio):fix esp32 s2 rtc io issue 2019-11-27 17:18:20 +08:00
gpio_types.h doc: add peripheral_types.h as API reference for peripheral docs 2020-05-11 11:20:39 +08:00
hal_defs.h mcpwm: add HAL layer support 2019-11-25 00:36:30 +08:00
i2c_hal.h bugfix(i2c): fix I2C driver breaking change issue. 2019-12-04 15:51:36 +08:00
i2c_types.h docs: Resolve doxygen & Sphinx warnings 2020-02-07 16:37:45 +11:00
i2s_hal.h driver(I2S): Fix I2S reset issue 2020-07-09 15:42:09 +00:00
i2s_types.h driver(I2S): Fix i2s_comm_format_t configuration parameter does not match the TRM bug. 2020-05-18 19:55:30 +08:00
ledc_hal.h feat(ledc): refactor ledc driver 2019-11-21 16:25:22 +08:00
ledc_types.h Merge branch 'bugfix/ledc_driver_enums' into 'master' 2020-01-10 15:34:43 +08:00
mcpwm_hal.h mcpwm: add HAL layer support 2019-11-25 00:36:30 +08:00
mcpwm_types.h driver/mcpwm: add an option to capture on both edges. 2020-08-03 14:58:45 +08:00
mpu_hal.h soc: remove param checking in cpu related abstractions 2020-02-27 07:15:15 +05:00
mpu_types.h soc: create abstraction for cpu related operations 2020-02-27 07:14:19 +05:00
pcnt_hal.h refactor(pcnt): add hal pcnt driver 2019-11-18 14:35:46 +08:00
pcnt_types.h bugfix(pcnt): fix driver ut pcnt 2020-02-26 16:52:53 +08:00
readme.md spi_slave: add HAL support 2019-05-20 07:34:34 +00:00
rmt_hal.h driver(RMT): Fix the breaking change issue of RMT driver introduced by refactoring. 2020-05-19 11:39:38 +08:00
rmt_types.h rmt: prefix caps name with SOC_ 2020-03-25 17:14:00 +08:00
rtc_hal.h soc: ll and hal for sleep related code 2020-08-17 19:09:24 +08:00
rtc_io_hal.h soc: ll and hal for sleep related code 2020-08-17 19:09:24 +08:00
rtc_io_types.h rtcio: add hal for driver 2019-11-21 10:40:49 +08:00
sdio_slave_hal.h sdio_slave: support HAL layer 2019-12-13 18:33:15 +08:00
sdio_slave_ll.h sdio_slave: support HAL layer 2019-12-13 18:33:15 +08:00
sdio_slave_types.h sdio_slave: support HAL layer 2019-12-13 18:33:15 +08:00
sigmadelta_hal.h refactor(sigmadelta): add hal sigmadelta driver 2019-11-21 11:53:07 +08:00
sigmadelta_types.h refactor(sigmadelta): add hal sigmadelta driver 2019-11-21 11:53:07 +08:00
soc_hal.h soc: ll and hal for sleep related code 2020-08-17 19:09:24 +08:00
spi_flash_hal.h spi: fix cs num support for different SPI hosts. 2020-07-27 12:27:03 +08:00
spi_flash_types.h esp_flash: refactor to make host driver function a const table 2020-07-13 03:10:00 +08:00
spi_hal.h spi_master: rename the hal layer function that calculates clock and timing 2020-08-17 17:04:07 +08:00
spi_slave_hal.h spi: multichip support 2019-06-22 19:08:47 +08:00
spi_slave_hd_hal.h spi_slave_hd: new driver for spi slave in half duplex mode 2020-07-11 00:00:50 +08:00
spi_types.h soc: placeholder for esp32s3 HAL driver 2020-08-07 11:59:00 +08:00
systimer_hal.h soc: placeholder for esp32s3 HAL driver 2020-08-07 11:59:00 +08:00
systimer_types.h esp32s3: clk, memory layout 2020-07-27 13:05:22 +08:00
timer_hal.h timer_group: update hal api && fix intr_enable 2020-04-23 19:29:15 +08:00
timer_types.h timer_group: update hal api && fix intr_enable 2020-04-23 19:29:15 +08:00
touch_sensor_hal.h Driver(touch): fix touch sensor driver for esp32s2. 2020-03-25 22:45:57 +08:00
touch_sensor_types.h soc: ll and hal for sleep related code 2020-08-17 19:09:24 +08:00
twai_hal.h TWAI: Add ESP32-S2 support 2020-06-30 16:56:03 +08:00
twai_types.h TWAI: Simplify caps header 2020-08-10 17:01:32 +08:00
uart_hal.h driver(uart): fix uart module reset issue 2020-06-01 11:01:26 +08:00
uart_types.h driver(uart): fix uart_set_line_inverse breaking change issue 2020-02-24 11:36:31 +08:00
usb_hal.h soc: add USB peripheral register definitions, hal level, reg map, etc 2020-02-10 08:33:39 +00:00
wdt_hal.h WDT: Add LL and HAL for watchdog timers 2020-03-26 02:14:02 +08:00
wdt_types.h WDT: Add LL and HAL for watchdog timers 2020-03-26 02:14:02 +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.