From b0ecfaebb0bc43f0b34e7c310cdd21429de782f5 Mon Sep 17 00:00:00 2001 From: Dylan Laduranty Date: Tue, 23 Apr 2024 15:18:15 +0200 Subject: [PATCH] boards/samd21-xpro: update board documentation Signed-off-by: Dylan Laduranty --- boards/samd21-xpro/doc.txt | 34 ++++++++++++++-------------------- 1 file changed, 14 insertions(+), 20 deletions(-) diff --git a/boards/samd21-xpro/doc.txt b/boards/samd21-xpro/doc.txt index e687c92e88..58c543ecb7 100644 --- a/boards/samd21-xpro/doc.txt +++ b/boards/samd21-xpro/doc.txt @@ -11,7 +11,7 @@ controller. For programming the MCU comes with 32Kb of RAM and 256Kb of flash memory. The samd21-xpro is available from various hardware vendors for ~30USD (as of -2017May). +2017 May). ## Hardware @@ -50,31 +50,30 @@ The samd21-xpro is available from various hardware vendors for ~30USD (as of | Device | ID | Supported | Comments | |:------------- |:------------- |:------------- |:------------- | -| MCU | samd21 | partly | DFLL clock not implemented | +| MCU | samd21 | yes | | | Low-level driver | GPIO | yes | | | | ADC | yes | | | | PWM | yes | | | | UART | yes | | -| | I2C | unknown | | -| | SPI | yes | | -| | USB | no | | +| | I2C | yes | | +| | SPI | yes | | +| | USB | yes | | | | RTT | yes | | -| | RTC | yes | | -| | RNG | unknown | | -| | Timer | yes | | - - +| | RTC | yes | | +| | Timer | yes | | ## Flashing the device Connect the device to your Micro-USB cable using the port labeled as *DEBUG USB*. -The standard method for flashing RIOT to the samd21-xpro is using OpenOCD. +The standard method for flashing RIOT to the samd21-xpro is using [edbg](https://github.com/ataradov/edbg). +by calling: `make BOARD=samd21-xpro -C tests/leds flash` -Refer to https://github.com/RIOT-OS/RIOT/wiki/OpenOCD for general -instructions on building OpenOCD and make sure "cmsis-dap" and "hidapi-libusb" -are enabled. +Note that on Linux, you will need libudev-dev package to be installed. + +Users can also use openOCD to flash and/or debug the board using: +`PROGRAMMER=openocd make BOARD=samd21-xpro -C tests/leds flash` On Linux you will have to add a **udev** rule for hidraw, like ``` @@ -87,6 +86,7 @@ sudo service udev restart ### Arch Linux With yaourt: ``` +yaourt -S libudev0 yaourt -S hidapi-git yaourt -S openocd-git # edit PKGBUILD, add "cmsis-dap hidapi-libusb" to "_features" @@ -97,12 +97,6 @@ Although this refers to setting up the SAMR21, this guide is still very helpful to understanding how to set up a solid RIOT development environment for the SAMD21: http://watr.li/samr21-dev-setup-ubuntu.html -## Supported Toolchains - -For using the samd21-xpro board we strongly recommend the usage of the -[GNU Tools for ARM Embedded Processors](https://launchpad.net/gcc-arm-embedded) -toolchain. - ## Known Issues / Problems */