Add support for the ESP32-H2

[jessebraham]

I'll be taking care of this one as well (possibly in collaboration with some colleague(s)), and this likely won't happen until the new year, but just wanted to create a tracking issue regardless.

Status

• [x] Create an SVD
• [x] Create a PAC
• [x] Add support to ancillary crates (esp-backtrace, esp-println)
• [x] Create a HAL package
• [x] Final review and publication (in progress)

[jessebraham]

I've begun work on HAL support for this device.

[jessebraham]

Development will take place in this branch until the changes are ready to merge into main:
https://github.com/esp-rs/esp-hal/tree/feature/esp32h2

[jessebraham]

Merged #482 today which begins adding support for the H2. A few more PRs will likely be merged to this branch before merging into main.

I will periodically rebase the feature/esp32h2 branch on main until we're ready to merge.

[jessebraham]

Initial support for this device has been merged into main. We will continue to add support for additional peripherals in the coming weeks.

We can track the status roughly by tracking which examples are working:

• [x] adc
• [x] advanced_serial
• [x] aes
• [x] blinky
• [x] blinky_erased_pins
• [x] debug_assist
• [x] embassy_hello_world
• [x] embassy_i2c
• [x] embassy_serial
• [x] embassy_spi
• [x] embassy_wait
• [x] gpio_interrupt
• [x] hello_rgb
• [x] hello_world
• [x] i2c_bmp180_calibration_data
• [x] i2c_display
• [x] i2s_read
• [x] i2s_sound
• [x] interrupt_preemption
• [x] ledc
• [x] mcpwm
• [x] pcnt_encoder
• [x] pulse_control
• [x] qspi_flash
• [x] ram
• [x] read_efuse
• [x] rng
• [x] rsa
• [x] rtc_time
• [x] rtc_watchdog
• [x] serial_interrupts
• [x] sha
• [x] software_interrupts
• [x] spi_eh1_device_loopback
• [x] spi_eh1_loopback
• [x] spi_halfduplex_read_manufacturer_id
• [x] spi_loopback
• [x] spi_loopback_dma
• [x] systimer
• [x] timer_interrupt
• [x] usb_serial_jtag
• [x] watchdog

In addition to the above examples, we must also address the direct-boot feature:

• [x] Fix the direct-boot feature and re-enable in CI

Once all the above items have been completed, we need to do a final pass of review, cleanup, documentation, etc.

• [x] Final review and cleanup prior to publishing
  • Make sure Cargo.toml and README.md are in good shape
  • Eliminate any warnings that may still be present
  • Use a published version of the PAC (when available)

[jessebraham]

I will start working on the six SPI-related examples: embassy_spi, spi_eh1_device_loopback, spi_eh1_loopback, spi_halfduplex_read_manufacturer_id, spi_loopback, and spi_loopback_dma.

[SergioGasquez]

I'm working on RSA and SHA

Also, I've tried to add support for RNG but the bootloader that we currently use does not have bootloader_random_enable/bootloader_random_disable implemented yet, hence RNG can't work. We'll need to check if there is a more recent bootloader or wait until those methods are implemented.

[SergioGasquez]

Also, I've tried to add support for RNG but the bootloader that we currently use does not have bootloader_random_enable/bootloader_random_disable implemented yet, hence RNG can't work. We'll need to check if there is a more recent bootloader or wait until those methods are implemented.

Just tried with the latest esp-idf bootloader, and it still does not implement those methods, here is how I tried it:

1. Downloaded esp-idf master
2. Installed it for esp32h2
3. Built, flash and monitored (idf.py flash monitor) one of the examples (get-started/blink)

Results in:

I (23) boot: ESP-IDF v5.2-dev-503-g17451f1fb3 2nd stage bootloader
...
W (48) bootloader_random: bootloader_random_enable() has not been implemented yet
...
I (155) boot: Disabling RNG early entropy source...
W (160) bootloader_random: bootloader_random_disable() has not been implemented yet

Update: did some more research on this end and ESP-IDF has also this issue tracked under https://github.com/espressif/esp-idf/issues/11038, once that IDF-6274 is fixed, we may add it.

[jessebraham]

Added a few more examples in #548 (advanced_serial, embassy_hello_world, systimer, usb_serial_jtag).

The SPI examples are "done" but there are some issues to be debugged, so still in-progress.

EDIT: figured out the issues, see #549 for SPI examples.

[SergioGasquez]

Working on PCNT!

[jessebraham]

Working on all the interrupt-related examples (ie. those with interrupt in their names)

(See #557)

[SergioGasquez]

Working on RMT!

[playfulFence]

I'll take i2s! (both read and sound)

[JurajSadel]

I will look into LEDC

[SergioGasquez]

Im working in debug_assist

[JurajSadel]

I'm working on ADC 😅

[JurajSadel]

Looking into timer_interrupt example

[JurajSadel]

I'll look into i2s

[jessebraham]

With #597 merged we have completed all examples for this device!

We should done one final round of review (clean up any warnings, etc.) and verify that all examples are still working (this is in-progress) and then I think we're good for our first release!

Thanks to everybody who contributed to supporting this device!

[jessebraham]

esp32h2-hal@0.1.0 has been published!