SimplePublish for SAM C21 Xplained Pro

The QSL includes a SimplePublish example for the Atmel Atmel SAM C21 Xplained Pro evaluation kit. This is given as an Atmel Studio 7 project based on the Atmel Software Framework (ASF).

The main.c code itself is similar to the one for the Raspberry Pi, with the addition of a watchdog timer and initialization of a second serial port to enable debug prints (the watchdog is for demonstration purposes only, and can be removed as the user see fit). A yellow LED on the Xplained Pro board is also toggled to indicate whether the mote has connected to a network or not.

...

Prepare the SAM C21 Xplained Pro

...

The Xplained Pro has three extension headers (EXT1, EXT2, EXT3) with pins as listed in Table 7: Connect the mote to one of the headers, as per the mapping in Table 8. In Figure 6 you can see the mote connected to EXT1, but it does not matter which one you use: The pins for UART RX/TX on all three headers are connected to the same pins on the SAM C21.

...

Connect a USB cable from your computer to the USB-micro port labeled DEBUG USB: This is the port on the top of the Xplained Pro board (visible in both Figure 5 and Figure 6), and is used to program, debug and power the board.

...

...

Compile and Run

Navigate to the SimplePublish example directory at examples/samc21_xplained_pro/SimplePublish SimplePublish/ and open the SimplePublish.atsln solution file in Atmel Studio 7. This should open the project with everything set up for you. Since the Xplained Pro has an embedded debugger, you do not have to select any tool: Atmel Studio should detect that the board is connected via USB.

Now, simply press the  symbol (Ctrl+Alt+F5) to compile and run the program, and you should see prints appearing on the debug terminal you opened.

...

Although the provided code is written specifically for the ATSAMC21J18A on the SAM C21 Xplained Pro evaluation kit, it should be pretty straightforward to port it to similar architectures that support the same ASF modules. Correctly configuring the available serial ports (SERCOM USART) in serial.c/.h should be the only thing that might require some adaptation. We therefore give a quick guide on how to set up a new ASF project.

...

1. Open the ASF Wizard: ASF > ASF Wizard (Ctrl+W)
2. Select the correct project in the drop down menu (if not already selected).
   You should now see two windows with Available vs Selected Modules.

3. Select and Add >> all the modules listed in Table 9.

   Note
   Make sure to select the correct mode when adding certain modules (you can change the mode of already selected modules too).

4.  Press Apply.

...

Table 9: ASF modules used in the SimplePublish example code.

Add Platform Specific Files (as Copy)

1. In the Soution Explorer window (right side), right click the folder src > Add > Existing Item...
   Image Added
2. Navigate to the SimplePublish example source directory: examples/samc21_xplained_pro/SimplePublish/src/
3. Select all the .c files and press Add (you do not need to add asf.h).
4. Press Ok to overwrite the default main.c file.

Add QSL and C Library Files (as Link

...

Create folder

Add as link

Add to Directories in Toolchain

Restart Atmel Studio (Directory Bug...)

Add Platform Specific Files

Add as copy

Make necessary adaptations

...

)

1. In the Soution Explorer window (right side), right click the folder src > Add > New Folder
2. Name it sm_clib
3. Right click the folder you just created > Add > Existing Item...
4. Navigate to the C Library directory in the repository: sm_clib/sm_clib/
5. Select all the .c and .h files, except those for the manager/wireless heart:
   dn_ipmg.c/.h
   dn_serial_mg.c/.h
   dn_whmt.c/.h
6.  Click the down-arrow next to Add and select Add As Link
   Image Added 
7. Repeat the previous steps with an sm_qsl folder for the QSL (but this time, add everything in sm_qsl/)

8. Restart Atmel Studio and reopen your solution/project.
   The two directories with the linked files should now have been moved to a subdirectory with the same name as your project.

   Info

   If you don't restart, you will later see that building the project fails: Inspecting the autogenerated makefile unveils that Atmel Studio attempts to build object files for the linked files in the non-existing subdirectory. Attempting to correct the makefile is futile, as Atmel Studio overwrites any manual changes. This seems to be a bug that only happens with files that are added "... As Link", but does not seem to have any other effects than the need for a restart and tolerating the unnecessary sub-directory in the Solution Explorer.

Add QSL and C Library Directories to Toolchain

1. In the Soution Explorer window (right side), right click your project > Properties (Alt+F7)
2. Toolchain > ARM/GNU C Compiler > Directories
3. Press the Image Added icon and then the (...) button

4. Again browse to the C Library in the repository: sm_clib/sm_clib/ and press Select Folder

   Note
   Make sure that you add a relative path to sm_clib/sm_clib/ and not just the top sm_clib/ directory.

5. Press OK.

6. Repeat the previous steps for the QSL in the repository: sm_qsl/

7. Press Ctrl+S to save your changes

Make necessary adaptations

Finally, you need to dive into the serial port configuration in serial.h and serial.c and make any necessary adaptations. Consult the datasheet of your platform for details (look for SERCOM USART).