Board: SAML21 xpro
WARNING: This entry will be deprecated. All content has been moved to doc.riot-os.org
SAML21 Xplained Pro is an ultra-low power evaluation board by Atmel featuring a ATSAML21J18A SoC. The SoC includes a SAML21 ARM Cortex-M0+ micro-controller. For programming the MCU comes with 32Kb of RAM and 256Kb of flash memory.
The saml21-xpro is available from various hardware vendors for ~50USD (as of oct. 2015).
Please note: ATMEL's most recent SAML21s are the
B variant, or
ATSAML21J18B. Because the driver changes are mostly small, throughout this reference the device will continue to be referred to as the
|Frequency||up to 48MHz|
|ADCs||1x 12-bit (20 channels)|
|UARTs||max 6 (shared with SPI and I2C)|
|SPIs||max 6 (see UART)|
|I2Cs||max 6 (see UART)|
|Vcc||1.8V - 3.6V|
|Board Manual||Board Manual|
1 User button and 1 LED:
|MCU||saml21||partly||PLL clock not implemented|
Flashing the device
Connect the device to your Micro-USB cable using the port labeled as EDBG.
The standard method for flashing RIOT to the saml21-xpro is using OpenOCD. Please note that even the latest official OpenOCD (v0.9 at the time of this writing) does not support B-variant SAML21 devices.
If you attempt to flash a board, and OpenOCD throws a
Couldn't find part correspoding to DID XXXXXXXX error, you will need to compile your own OpenOCD from source.
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.
On Linux you will have to add a udev rule for hidraw, like
echo 'KERNEL=="hidraw*", SUBSYSTEM=="hidraw", MODE="0664", GROUP="plugdev"' \ | sudo tee -a /etc/udev/rules.d/99-usb.rules sudo service udev restart
yaourt -S hidapi-git yaourt -S openocd-git # edit PKGBUILD, add "cmsis-dap hidapi-libusb" to "_features"
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 SAML21: http://watr.li/samr21-dev-setup-ubuntu.html
For using the saml21-xpro board we strongly recommend the usage of the GNU Tools for ARM Embedded Processors toolchain.
Known Issues / Problems
The default stack sizes have not been tuned properly yet. If in doubt why your application crashes try increasing the default stack sizes and use
ps to find out how much stack is being used.
Tracked in https://github.com/RIOT-OS/RIOT/issues/2228
Not flashable by OpenOCD anymore
It can happen that OpenOCD is not able to program the board, because of wrong clock configuration or low power modes. In this case you can use this little tool to erase the flash. Just follow the instructions to build it and run
./edbg -e to erase the flash. Then press the reset button and you're able to program via OpenOCD again.