esp_hal Documentation
esp_hal
Peripheral Support Matrix Per-chip feature completeness and API stability
API Stability:
Stable
🚧 Unstable
⚠️ Planned overhaul
— Not supported
Chip Support:
Supported
Partial support
❌ Not supported
— Not available
Underlined icons open the peripheral's tracking issue on GitHub.
GPIO 4 drivers
Serial interfaces 23 drivers
| Driver | API | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C5 | ESP32-C6 | ESP32-C61 | ESP32-H2 | ESP32-H4 | ESP32-P4 | ESP32-S2 | ESP32-S3 | ESP32-S31 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| UART | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ⚒️ | ✔️ | ✔️ | ✔️ | ✔️ |
| LP UART | 🚧 | — | — | — | ❌ | ⚒️ | — | — | — | ❌ | — | — | ❌ |
| UHCI | 🚧 | ❌ | — | ⚒️ | ⚒️ | ⚒️ | — | ⚒️ | ❌ | ⚒️ | ❌ | ⚒️ | ⚒️ |
| I2C master | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ⚒️ | ✔️ | ✔️ | ✔️ | ✔️ |
| LP I2C master | 🚧 | ❌ | — | — | ⚒️ | ⚒️ | — | — | — | ⚒️ | ❌ | ⚒️ | ❌ |
| I2C slave | 🚧 | ❌ | — | ⚒️ | ❌ | ⚒️ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| I3C master | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
| I3C slave | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
| SPI master | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ✔️ | ⚒️ | ✔️ | ✔️ | ✔️ | ✔️ |
| SPI slave | 🚧 | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ❌ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| LP SPI master | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
| LP SPI slave | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
| I2S | 🚧 | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| LP I2S | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
| PARL_IO | 🚧 | — | — | — | ⚒️ | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | — | — | ⚒️ |
| RMT | 🚧 | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | — | ⚒️ | ❌ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| SDMMC/SDIO host | 🚧 | ⚒️ | — | — | — | — | — | — | — | ⚒️ | — | ⚒️ | ⚒️ |
| SDIO slave | — | ❌ | — | — | ❌ | ❌ | ❌ | — | — | — | — | — | — |
| TWAI | 🚧 | ⚒️ | — | ⚒️ | — | ⚒️ | — | ⚒️ | — | ❌ | ⚒️ | ⚒️ | — |
| CANFD | 🚧 | — | — | — | ⚒️ | — | — | — | ❌ | — | — | — | ❌ |
| USB OTG FS | 🚧 | — | — | — | — | — | — | — | ❌ | ⚒️ | ⚒️ | ⚒️ | — |
| USB OTG HS | 🚧 | — | — | — | — | — | — | — | — | ⚒️ | — | — | ⚒️ |
| USB Serial/JTAG | 🚧 | — | — | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | — | ⚒️ | ⚒️ |
Wireless and networking 4 drivers
Display and camera 5 drivers
Signal processing 8 drivers
| Driver | API | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C5 | ESP32-C6 | ESP32-C61 | ESP32-H2 | ESP32-H4 | ESP32-P4 | ESP32-S2 | ESP32-S3 | ESP32-S31 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Bit Scrambler | — | — | — | — | ❌ | — | — | — | — | ❌ | — | — | ❌ |
| Image Signal Processor | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
| Pixel Processing Accelerator | 🚧 | — | — | — | — | — | — | — | — | ❌ | — | — | ⚒️ |
| JPEG Codec | — | — | — | — | — | — | — | — | — | ❌ | — | — | ❌ |
| H.264 encoder | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
| Audio Sample Rate Converter | — | — | — | — | — | — | — | — | ❌ | — | — | — | ❌ |
| CORDIC accelerator | 🚧 | — | — | — | — | — | — | — | — | — | — | — | ⚒️ |
| Voice Activity Detection | — | — | — | — | — | — | — | — | — | ❌ | — | — | — |
Analog 5 drivers
Timers and motor control 7 drivers
| Driver | API | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C5 | ESP32-C6 | ESP32-C61 | ESP32-H2 | ESP32-H4 | ESP32-P4 | ESP32-S2 | ESP32-S3 | ESP32-S31 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| LEDC | ⚠️ | ⚒️ | ⚒️ | ⚒️ | ❌ | ⚒️ | ❌ | ⚒️ | ❌ | ❌ | ⚒️ | ⚒️ | ❌ |
| MCPWM | 🚧 | ⚒️ | — | — | ❌ | ⚒️ | — | ⚒️ | ❌ | ❌ | — | ⚒️ | ❌ |
| PCNT | 🚧 | ⚒️ | — | — | ⚒️ | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| RTC Timekeeping | 🚧 | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| SDM | 🚧 | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | — | ⚒️ | ❌ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| SYSTIMER | 🚧 | — | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| Timers | 🚧 | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
Cryptography and security 9 drivers
| Driver | API | ESP32 | ESP32-C2 | ESP32-C3 | ESP32-C5 | ESP32-C6 | ESP32-C61 | ESP32-H2 | ESP32-H4 | ESP32-P4 | ESP32-S2 | ESP32-S3 | ESP32-S31 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| AES | 🚧 | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | — | ⚒️ | ❌ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| RSA Digital Signature | — | — | — | ❌ | ❌ | ❌ | — | ❌ | — | ❌ | ❌ | ❌ | ❌ |
| ECDSA Digital Signature | — | — | — | — | ❌ | — | ❌ | ❌ | ❌ | ❌ | — | — | ❌ |
| ECC | 🚧 | — | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ❌ | ⚒️ | — | — | ⚒️ |
| HMAC | 🚧 | — | — | ⚒️ | ❌ | ⚒️ | — | ⚒️ | ❌ | ❌ | ⚒️ | ⚒️ | ❌ |
| Key Manager | — | — | — | — | ❌ | — | — | — | ❌ | ❌ | — | — | ❌ |
| RNG | ✔️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| RSA | 🚧 | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | — | ⚒️ | — | ⚒️ | ⚒️ | ⚒️ | ⚒️ |
| SHA | 🚧 | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ⚒️ | ❌ | ⚒️ | ⚒️ | ⚒️ | ⚒️ |