This directory contains example platform drivers for the Microchip ATSAMR21G18A based on SAM R21 Xplained Pro Evaluation Kit.
The example platform drivers are intended to present the minimal code necessary to support OpenThread. See the “Run the example with SAMR21 boards” section below for an example using basic OpenThread capabilities.
Download and install the GNU toolchain for ARM Cortex-M.
In a Bash terminal, follow these instructions to install the GNU toolchain and other dependencies.
$ cd <path-to-openthread> $ ./script/bootstrap
$ unzip asf-standalone-archive-3.45.0.85.zip $ cp xdk-asf-3.45.0 -rf <path-to-openthread>/third_party/microchip/asf
$ cd <path-to-openthread> $ ./bootstrap $ make -f examples/Makefile-samr21
To build for these modules set BOARD variable in command line as following:
$ make -f examples/Makefile-samr21 BOARD=<MODULE>
where:
<module> | Board |
|---|---|
SAMR21_XPLAINED_PRO | SAM R21 Xplained Pro Evaluation Kit |
SAMR21G18_MODULE | ATSAMR21G18-MR210UA |
SAMR21B18_MODULE | ATSAMR21B18-MZ210PA |
After a successful build, the elf files are found in <path-to-openthread>/output/samr21/bin.
Compiled binaries may be flashed onto the SAM R21 Xplained Pro using embedded debugger EDBG.
$ openocd -f board/atmel_samr21_xplained_pro.cfg $ cd <path-to-openthread>/output/samr21/bin $ arm-none-eabi-gdb ot-cli-ftd $ (gdb) target remote 127.0.0.1:3333 $ (gdb) load $ (gdb) monitor reset $ (gdb) c
Flash two SAM R21 Xplained Pro boards with the CLI example firmware (as shown above).
Open terminal to first device /dev/ttyACM0 (serial port settings: 115200 8-N-1). Type help for a list of commands.
> help help channel childtimeout contextreusedelay extaddr extpanid ipaddr keysequence leaderweight masterkey mode netdataregister networkidtimeout networkname panid ping prefix releaserouterid rloc16 route routerupgradethreshold scan start state stop whitelist
Start a Thread network as Leader.
> dataset init new Done > dataset Active Timestamp: 1 Channel: 13 Channel Mask: 07fff800 Ext PAN ID: d63e8e3e495ebbc3 Mesh Local Prefix: fd3d:b50b:f96d:722d/64 Master Key: dfd34f0f05cad978ec4e32b0413038ff Network Name: OpenThread-8f28 PAN ID: 0x8f28 PSKc: c23a76e98f1a6483639b1ac1271e2e27 Security Policy: 0, onrcb Done > dataset commit active Done > ifconfig up Done > thread start Done
wait a couple of seconds...
state leader Done
Open terminal to second device /dev/ttyACM1 (serial port settings: 115200 8-N-1) and attach it to the Thread network as a Router.
> dataset masterkey dfd34f0f05cad978ec4e32b0413038ff Done > dataset commit active Done > routerselectionjitter 1 Done > ifconfig up Done > thread start Done wait a couple of seconds... > state router Done
List all IPv6 addresses of Leader.
> ipaddr fd3d:b50b:f96d:722d:0:ff:fe00:fc00 fd3d:b50b:f96d:722d:0:ff:fe00:c00 fd3d:b50b:f96d:722d:7a73:bff6:9093:9117 fe80:0:0:0:6c41:9001:f3d6:4148 Done
Send an ICMPv6 ping to Leader's Mesh-EID IPv6 address.
> ping fd3d:b50b:f96d:722d:7a73:bff6:9093:9117 16 bytes from fd3d:b50b:f96d:722d:558:f56b:d688:799: icmp_seq=1 hlim=64 time=24ms
The above example demonstrates basic OpenThread capabilities. Enable more features/roles (e.g. commissioner, joiner, DHCPv6 Server/Client, etc.) by assigning compile-options before compiling.
$ cd <path-to-openthread> $ ./bootstrap $ make -f examples/Makefile-samr21 COMMISSIONER=1 JOINER=1 DHCP6_CLIENT=1 DHCP6_SERVER=1
For a list of all available commands, visit OpenThread CLI Reference README.md.
The following toolchain has been used for testing and verification: