Merge pull request #2958 from embassy-rs/embassy-book-refactor

Embassy book refactor

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/pages/hal.adoc b/docs/pages/hal.adoc
new file mode 100644
index 000000000..14b85e1f1
--- /dev/null
+++ b/docs/pages/hal.adoc
@@ -0,0 +1,14 @@
+= Hardware Abstraction Layer (HAL)
+
+Embassy provides HALs for several microcontroller families:
+
+* `embassy-nrf` for the nRF microcontrollers from Nordic Semiconductor
+* `embassy-stm32` for STM32 microcontrollers from ST Microelectronics
+* `embassy-rp` for the Raspberry Pi RP2040 microcontrollers
+
+These HALs implement async/await functionality for most peripherals while also implementing the
+async traits in `embedded-hal` and `embedded-hal-async`. You can also use these HALs with another executor.
+
+For the ESP32 series, there is an link:https://github.com/esp-rs/esp-hal[esp-hal] which you can use.
+
+For the WCH 32-bit RISC-V series, there is an link:https://github.com/ch32-rs/ch32-hal[ch32-hal], which you can use.