Skip to content
Branch: master
Find file History

README.md

OpenThread on SAMR21 Example

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.

Toolchain

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

Build Examples

  1. Download Advanced Software Framework (ASF).
  1. Unzip it to /third_party/microchip folder
$ unzip asf-standalone-archive-3.45.0.85.zip 
$ cp xdk-asf-3.45.0 -rf  <path-to-openthread>/third_party/microchip/asf
  1. Build OpenThread Firmware (CLI example) on SAMR21 platform.
$ cd <path-to-openthread>
$ ./bootstrap
$ make -f examples/Makefile-samr21
  1. This example can be built for other SAMR21 based modules e.g.:

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.

Flash Binaries

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

Run the example with SAM R21 Xplained Pro boards

  1. Flash two SAM R21 Xplained Pro boards with the CLI example firmware (as shown above).

  2. 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
  3. 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

    
    
  4. 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 panid 0x8f28
    Done
    > dataset commit active
    Done
    > routerselectionjitter 1
    Done
    > ifconfig up
    Done
    > thread start
    Done
    
    wait a couple of seconds...
    
    > state
    router
    Done
  5. 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
  6. 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.

Other boards

Verification

The following toolchain has been used for testing and verification:

  • gcc version 7.3.1
  • Advanced Software Framework (ASF) version 3.45.0
You can’t perform that action at this time.