Update to embedded-hal 1.0 (#1723)

Now that the new version of `microbit-v2` and friends are finally
released, we can use `embedded-hal` 1.0 for the bare metal morning.

Author: qwandor

src/bare-metal/microcontrollers/embedded-hal.md

@@ -1,25 +1,36 @@
 # `embedded-hal`
 
-The [`embedded-hal`](https://crates.io/crates/embedded-hal) crate provides a
-number of traits covering common microcontroller peripherals.
+The [`embedded-hal`] crate provides a number of traits covering common
+microcontroller peripherals:
 
 - GPIO
-- ADC
-- I2C, SPI, UART, CAN
-- RNG
-- Timers
-- Watchdogs
+- PWM
+- Delay timers
+- I2C and SPI buses and devices
 
-Other crates then implement
-[drivers](https://github.com/rust-embedded/awesome-embedded-rust#driver-crates)
-in terms of these traits, e.g. an accelerometer driver might need an I2C or SPI
-bus implementation.
+Similar traits for byte streams (e.g. UARTs), CAN buses and RNGs and broken out
+into [`embedded-io`], [`embedded-can`] and [`rand_core`] respectively.
+
+Other crates then implement [drivers] in terms of these traits, e.g. an
+accelerometer driver might need an I2C or SPI device instance.
 
 <details>
 
+- The traits cover using the peripherals but not initialising or configuring
+  them, as initialisation and configuration is usually highly platform-specific.
 - There are implementations for many microcontrollers, as well as other
   platforms such as Linux on Raspberry Pi.
-- There is work in progress on an `async` version of `embedded-hal`, but it
-  isn't stable yet.
+- [`embedded-hal-async`] provides async versions of the traits.
+- [`embedded-hal-nb`] provides another approach to non-blocking I/O, based on
+  the [`nb`] crate.
 
 </details>
+
+[drivers]: https://github.com/rust-embedded/awesome-embedded-rust#driver-crates
+[`embedded-can`]: https://crates.io/crates/embedded-can
+[`embedded-hal`]: https://crates.io/crates/embedded-hal
+[`embedded-hal-async`]: https://crates.io/crates/embedded-hal-async
+[`embedded-hal-nb`]: https://crates.io/crates/embedded-hal-nb
+[`embedded-io`]: https://crates.io/crates/embedded-io
+[`nb`]: https://crates.io/crates/nb
+[`rand_core`]: https://crates.io/crates/rand_core

src/bare-metal/microcontrollers/examples/Cargo.lock

@@ -7,10 +7,10 @@ edition = "2021"
 publish = false
 
 [dependencies]
-cortex-m-rt = "0.7.3"
+cortex-m-rt = "0.7.4"
 embedded-hal = "1.0.0"
-microbit-v2 = "0.13.0"
-nrf52833-hal = "0.17.0"
+microbit-v2 = "0.14.0"
+nrf52833-hal = "0.17.1"
 nrf52833-pac = { version = "0.12.2", features = ["rt"] }
 panic-halt = "0.2.0"
 

src/bare-metal/microcontrollers/examples/Cargo.toml

@@ -19,7 +19,7 @@
 extern crate panic_halt as _;
 
 use cortex_m_rt::entry;
-use microbit::hal::prelude::*;
+use embedded_hal::digital::OutputPin;
 use microbit::Board;
 
 #[entry]