xiao_m0

Crates.ioxiao_m0
lib.rsxiao_m0
version0.13.0
sourcesrc
created_at2020-06-05 21:50:50.26327
updated_at2024-10-18 20:28:19.644267
descriptionBoard support crate for the Seeed Studio Seeeduino XIAO
homepage
repositoryhttps://github.com/atsamd-rs/atsamd
max_upload_size
id250471
size51,539
owners (github:atsamd-rs:owners)

documentation

README

Seeeduino XIAO Board Support Crate

This crate provides a type-safe API for working with the Seeed Studio Seeeduino XIAO.

Prerequisites

  • Install the cross compile toolchain rustup target add thumbv6m-none-eabi
  • Install the cargo-hf2 tool however your platform requires

Uploading an example

Check out the repository for examples.

  • Be in this directory cd boards/xiao_m0
  • Put your device in bootloader mode by bridging the RST pads twice in quick succession. The orange LED will pulse when the device is in bootloader mode.
  • Build and upload in one step: cargo hf2 --release --example blink
    • Note that if you're using an older cargo-hf2 that you'll need to specify the VID/PID when flashing: cargo hf2 --vid 0x2886 --pid 0x002f --release --example blink

If you are on Linux and hf2 fails to flash your board even if it is connected and in bootloader mode, you might need to add some udev rules if you have not done that yet.

The example for adafruit boards is shown here.

You might want to have all the hf2 related rules in a single file, i.e. /etc/udev/rules.d/99-hf2-boards.rules, or have a different rules file for each vendor. The rules for Seeeduino boards look like this:

#seeeduino rules
ATTRS{idVendor}=="2886", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEM=="usb", ATTRS{idVendor}=="2886", MODE="0666"
SUBSYSTEM=="tty", ATTRS{idVendor}=="2886", MODE="0666"

After adding the rules remember to reboot or run:

sudo udevadm control --reload-rules
sudo udevadm trigger

For more information on hf2 and other methods of uploading your code, take a look at the base project README.

Commit count: 827

cargo fmt