Dynamic PCLK source IDs

.github/workflows/build-bsp.yml

@@ -8,7 +8,7 @@ jobs:
       matrix: ${{ steps.set-matrix.outputs.matrix }}
     steps:
     - name: Checkout sources
-      uses: actions/checkout@v5
+      uses: actions/checkout@v7
     - id: set-matrix
       uses: ./.github/actions/list-BSPs
 
@@ -26,7 +26,7 @@ jobs:
       matrix: ${{fromJson(needs.setup.outputs.matrix)}}
     steps:
     - name: Checkout sources
-      uses: actions/checkout@v5
+      uses: actions/checkout@v7
 
     - name: Install Rust
       run: |
@@ -60,7 +60,7 @@ jobs:
         $(${clippy_invocation})
 
     - name: Done
-      uses: actions/upload-artifact@v5
+      uses: actions/upload-artifact@v7
       with:
         # name needs to be unique in the workspace
         name: "${{ matrix.bsp.name }}-${{ matrix.toolchain }}"
@@ -71,7 +71,7 @@ jobs:
     needs: [setup, build]
     steps:
       - name: Download artifacts
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v8
         with:
           path: successful-jobs
       - name: Do checks

.github/workflows/build-hal.yml

@@ -8,7 +8,7 @@ jobs:
       matrix: ${{ steps.set-matrix.outputs.matrix }}
     steps:
     - name: Checkout sources
-      uses: actions/checkout@v5
+      uses: actions/checkout@v7
     - id: set-matrix
       uses: ./.github/actions/list-HAL-variants
 
@@ -20,7 +20,7 @@ jobs:
       matrix: ${{fromJson(needs.setup.outputs.matrix)}}
     steps:
     - name: Checkout sources
-      uses: actions/checkout@v5
+      uses: actions/checkout@v7
 
     - name: Install Rust
       run: |

.github/workflows/check-docs.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout sources
-        uses: actions/checkout@v5
+        uses: actions/checkout@v7
       - name: Install Rust
         run: |
           rustup set profile minimal

.github/workflows/generate-docs.yml

@@ -12,7 +12,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout sources
-        uses: actions/checkout@v5
+        uses: actions/checkout@v7
 
       - name: Install Rust
         run: |
@@ -80,7 +80,7 @@ jobs:
           echo '  </body>' >> "${docs_path}/index.html"
           echo '</html>' >> "${docs_path}/index.html"
       - name: Checkout pages branch
-        uses: actions/checkout@v5
+        uses: actions/checkout@v7
         with:
           ref: gh-pages
           path: gh-pages

.github/workflows/release-crates.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v5
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
 

.github/workflows/rustfmt.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout sources
-        uses: actions/checkout@v5
+        uses: actions/checkout@v7
       - name: Install Rust
         run: |
           rustup set profile minimal

Cargo.toml

@@ -7,6 +7,8 @@ members = [
 	"pac/*",
 	"boards/*",
 ]
+# Fragments of example files, referenced by `include!()` from BSP examples
+exclude = ["boards/examples"]
 
 [profile.dev]
 debug = true

README.md

@@ -10,16 +10,16 @@ This repository holds various crates that support/enable working with Microchip
 
 The Hardware Abstraction Layer (HAL - [![Crates.io](https://img.shields.io/crates/v/atsamd_hal.svg)](https://crates.io/crates/atsamd_hal)) crate encodes a type-safe layer over the raw PACs. This crate implements traits specified by the [embedded-hal](https://github.com/rust-embedded/embedded-hal) project, making it compatible with various drivers in the embedded Rust ecosystem.  Cargo features are used to enable support for specific hardware variations and features.  Online documentation for commonly-used feature sets is provided:
 
-| Chip family | Documented features               |
-|:------------|:----------------------------------|
-| [samd11c]   | samd11c dma defmt async           |
-| [samd11d]   | samd11d dma defmt async           |
-| [samd21g]   | samd21g usb dma defmt async       |
-| [samd21j]   | samd21j usb dma defmt async       |
-| [samd51g]   | samd51g usb sdmmc dma defmt async |
-| [samd51j]   | samd51j usb sdmmc dma defmt async |
-| [samd51n]   | samd51n usb sdmmc dma defmt async |
-| [samd51p]   | samd51p usb sdmmc dma defmt async |
+| Chip family | Documented features                              |
+|:------------|:-------------------------------------------------|
+| [samd11c]   | samd11c dma defmt async undoc-features           |
+| [samd11d]   | samd11d dma defmt async undoc-features           |
+| [samd21g]   | samd21g usb dma defmt async undoc-features       |
+| [samd21j]   | samd21j usb dma defmt async undoc-features       |
+| [samd51g]   | samd51g usb sdmmc dma defmt async undoc-features |
+| [samd51j]   | samd51j usb sdmmc dma defmt async undoc-features |
+| [samd51n]   | samd51n usb sdmmc dma defmt async undoc-features |
+| [samd51p]   | samd51p usb sdmmc dma defmt async undoc-features |
 
 [samd11c]: https://atsamd-rs.github.io/atsamd/samd11c/thumbv6m-none-eabi/doc/atsamd_hal/index.html
 [samd11d]: https://atsamd-rs.github.io/atsamd/samd11d/thumbv6m-none-eabi/doc/atsamd_hal/index.html
@@ -153,6 +153,38 @@ If you'd like to build all the same things that the CI would build but on your l
 $ ./build-all.py
 ```
 
+## Undocumented chip features
+
+Some development board manufacturers, such as Adafruit, sell some boards with pin multiplexing configurations that aren't
+explicitly allowed by the datasheet. As a convenience, we offer the option to enable these undocumented features by opting
+into the `undoc-features` Cargo feature. Note that even though these have shown to work in at least some situations, we do not
+provide any guarantees with respect to those.
+
+Currently, we provide these features undocumented features:
+
+### SAMD21:
+
+* Mark `PA00` as I2C-capable according to `circuit_playground_express`.
+
+* Mark `PA01` as I2C-capable according to `circuit_playground_express`.
+
+* Mark `PB02` as I2C-capable according to `circuit_playground_express`.
+
+* Mark `PB03` as I2C-capable according to `circuit_playground_express`.
+
+### SAMx5x devices:
+* `UndocIoSet1`: Implement an undocumented `IoSet` for PA16, PA17, PB22 &
+  PB23 configured for `Sercom1`. The `pygamer` & `feather_m4` use this
+  combination, but it is not listed as valid in the datasheet.
+
+* `UndocIoSet2`: Implement an undocumented `IoSet` for PA00, PA01, PB22 &
+  PB23 configured for `Sercom1`. The `itsybitsy_m4` uses this combination,
+  but it is not listed as valid in the datasheet.
+
+* Mark `PB02` as I2C-capable according to `metro_m4`.
+
+* Mark `PB03` as I2C-capable according to `metro_m4`.
+
 ## Running and debugging firmware on target hardware
 
 See our wiki page about [loading code onto the device](https://github.com/atsamd-rs/atsamd/wiki/Loading-code-onto-the-device).

atsamd-hal-macros/devices.yaml

@@ -21,7 +21,9 @@ families:
       - serial-numbers
       - dsu
       - clock
-      - gclk
+      - xosc32k
+      - xosc: { count: 1 }
+      - gclk: { count: 6 }
       - pm
       - sysctrl
       - wdt
@@ -53,7 +55,9 @@ families:
       - serial-numbers
       - dsu
       - clock
-      - gclk
+      - xosc32k: { except: ["samd21el", "samd21gl"] }
+      - xosc: { count: 1 }
+      - gclk: { count: 8 }
       - pm
       - sysctrl
       - wdt
@@ -96,7 +100,9 @@ families:
       - cmcc
       - dsu
       - clock
-      - gclk
+      - xosc32k
+      - xosc: { count: 2 }
+      - gclk: { count: 12 }
       - mclk
       - rstc
       - ramecc

boards/arduino_nano33iot/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.8.0](https://github.com/atsamd-rs/atsamd/compare/arduino_nano33iot-0.7.2...arduino_nano33iot-0.8.0) - 2025-12-29
+
+### Dependencies
+
+- *(nano33iot)* [**breaking**] Update nano33iot HAL dependency to 0.23.0 ([#971](https://github.com/atsamd-rs/atsamd/pull/971))
+
 ## [0.7.2](https://github.com/atsamd-rs/atsamd/compare/arduino_nano33iot-0.7.1...arduino_nano33iot-0.7.2) - 2024-10-17
 
 ### Refactored

boards/arduino_nano33iot/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "arduino_nano33iot"
-version = "0.7.2"
+version = "0.8.0"
 authors = ["Gus Wynn <[email protected]>"]
 description = "Board Support crate for the Arduino Nano 33 IOT"
 keywords = ["no-std", "arm", "cortex-m", "embedded-hal", "arduino"]
@@ -15,11 +15,12 @@ version = "0.7"
 optional = true
 
 [dependencies.atsamd-hal]
-version = "0.14"
+version = "0.23.0"
 default-features = false
+features = ["undoc-features"]
 
 [dependencies.usb-device]
-version = "0.2"
+version = "0.3.2"
 optional = true
 
 [dependencies.rand]
@@ -28,10 +29,10 @@ default-features = false
 features = ["small_rng"]
 
 [dev-dependencies]
-cortex-m = "0.7"
-usbd-serial = "0.1"
-panic-halt = "0.2"
-panic-semihosting = "0.5"
+cortex-m = { version = "0.7", features = ["critical-section-single-core"] }
+usbd-serial = "0.2.2"
+panic-halt = "1.0.0"
+panic-semihosting = "0.6"
 embedded-graphics = "0.7"
 st7735-lcd = "0.8"
 ssd1306 = { version = "0.7", features = ["graphics"] }
@@ -41,7 +42,6 @@ ssd1306 = { version = "0.7", features = ["graphics"] }
 default = ["rt", "atsamd-hal/samd21g"]
 rt = ["cortex-m-rt", "atsamd-hal/samd21g-rt"]
 usb = ["atsamd-hal/usb", "usb-device"]
-unproven = ["atsamd-hal/unproven"]
 use_semihosting = []
 
 # for cargo flash
@@ -53,7 +53,7 @@ name = "blinky_basic"
 
 [[example]]
 name = "usb_logging"
-required-features = ["usb", "unproven"]
+required-features = ["usb"]
 
 [[example]]
 name = "serial"

boards/arduino_nano33iot/examples/blinky_basic.rs

@@ -20,12 +20,12 @@ fn main() -> ! {
     let mut peripherals = Peripherals::take().unwrap();
     let core = CorePeripherals::take().unwrap();
     let mut clocks = GenericClockController::with_internal_32kosc(
-        peripherals.GCLK,
-        &mut peripherals.PM,
-        &mut peripherals.SYSCTRL,
-        &mut peripherals.NVMCTRL,
+        peripherals.gclk,
+        &mut peripherals.pm,
+        &mut peripherals.sysctrl,
+        &mut peripherals.nvmctrl,
     );
-    let pins = bsp::Pins::new(peripherals.PORT);
+    let pins = bsp::Pins::new(peripherals.port);
     let mut led: bsp::Led = pins.led_sck.into();
     let mut delay = Delay::new(core.SYST, &mut clocks);
 

boards/arduino_nano33iot/examples/i2c_ssd1306.rs

@@ -28,7 +28,6 @@ use hal::clock::GenericClockController;
 use hal::delay::Delay;
 use hal::pac::{CorePeripherals, Peripherals};
 use hal::prelude::*;
-use hal::time::KiloHertz;
 
 use ssd1306::{prelude::*, I2CDisplayInterface, Ssd1306};
 
@@ -42,21 +41,21 @@ fn main() -> ! {
     let mut peripherals = Peripherals::take().unwrap();
     let core = CorePeripherals::take().unwrap();
     let mut clocks = GenericClockController::with_internal_32kosc(
-        peripherals.GCLK,
-        &mut peripherals.PM,
-        &mut peripherals.SYSCTRL,
-        &mut peripherals.NVMCTRL,
+        peripherals.gclk,
+        &mut peripherals.pm,
+        &mut peripherals.sysctrl,
+        &mut peripherals.nvmctrl,
     );
-    let pins = bsp::Pins::new(peripherals.PORT);
+    let pins = bsp::Pins::new(peripherals.port);
     let mut delay = Delay::new(core.SYST, &mut clocks);
 
     delay.delay_ms(BOOT_DELAY_MS);
 
     let i2c = bsp::i2c_master(
         &mut clocks,
-        KiloHertz(400),
-        peripherals.SERCOM4,
-        &mut peripherals.PM,
+        400.kHz(),
+        peripherals.sercom4,
+        &mut peripherals.pm,
         pins.sda,
         pins.scl,
     );

boards/arduino_nano33iot/examples/serial.rs

@@ -20,19 +20,19 @@ fn main() -> ! {
     let mut peripherals = Peripherals::take().unwrap();
     let core = CorePeripherals::take().unwrap();
     let mut clocks = GenericClockController::with_internal_32kosc(
-        peripherals.GCLK,
-        &mut peripherals.PM,
-        &mut peripherals.SYSCTRL,
-        &mut peripherals.NVMCTRL,
+        peripherals.gclk,
+        &mut peripherals.pm,
+        &mut peripherals.sysctrl,
+        &mut peripherals.nvmctrl,
     );
-    let pins = bsp::Pins::new(peripherals.PORT);
+    let pins = bsp::Pins::new(peripherals.port);
     let mut delay = Delay::new(core.SYST, &mut clocks);
 
     let mut uart = bsp::uart(
         &mut clocks,
-        9600.hz(),
-        peripherals.SERCOM5,
-        &mut peripherals.PM,
+        9600.Hz(),
+        peripherals.sercom5,
+        &mut peripherals.pm,
         pins.rx,
         pins.tx,
     );

boards/arduino_nano33iot/examples/spi_st7735.rs

@@ -17,7 +17,6 @@ use hal::clock::GenericClockController;
 use hal::delay::Delay;
 use hal::pac::{CorePeripherals, Peripherals};
 use hal::prelude::*;
-use hal::time::MegaHertz;
 
 use embedded_graphics::{
     image::{Image, ImageRaw, ImageRawLE},
@@ -35,21 +34,21 @@ fn main() -> ! {
     let mut peripherals = Peripherals::take().unwrap();
     let core = CorePeripherals::take().unwrap();
     let mut clocks = GenericClockController::with_internal_32kosc(
-        peripherals.GCLK,
-        &mut peripherals.PM,
-        &mut peripherals.SYSCTRL,
-        &mut peripherals.NVMCTRL,
+        peripherals.gclk,
+        &mut peripherals.pm,
+        &mut peripherals.sysctrl,
+        &mut peripherals.nvmctrl,
     );
-    let pins = bsp::Pins::new(peripherals.PORT);
+    let pins = bsp::Pins::new(peripherals.port);
     let mut delay = Delay::new(core.SYST, &mut clocks);
 
     delay.delay_ms(BOOT_DELAY_MS);
 
     let spi = bsp::spi_master(
         &mut clocks,
-        MegaHertz(16),
-        peripherals.SERCOM1,
-        &mut peripherals.PM,
+        16.MHz(),
+        peripherals.sercom1,
+        &mut peripherals.pm,
         pins.led_sck,
         pins.mosi,
         pins.miso,