.. zephyr:board:: saml21_xpro

Overview

The SAM L21 Xplained Pro evaluation kit is ideal for evaluation and prototyping with the SAM L21 Cortex®-M0+ processor-based microcontrollers. The kit includes Atmel’s Embedded Debugger (EDBG), which provides a full debug interface without the need for additional hardware.

Hardware

• SAML21J18 ARM Cortex-M0+ processor at 48 MHz
• 32.768 kHz crystal oscillator
• 256 KiB flash memory, 32 KiB of SRAM, 8KB Low Power SRAM
• One yellow user LED
• One mechanical user push button
• One reset button
• On-board USB based EDBG unit with serial console

Supported Features

.. zephyr:board-supported-hw::

Pin Mapping

The SAM L21 Xplained Pro evaluation kit has 2 GPIO controllers. These controllers are responsible for pin muxing, input/output, pull-up, etc.

For more details please refer to SAM L21 Family Datasheet_ and the SAM L21 Xplained Pro Schematic_.

.. image:: img/atsaml21-xpro-pinout.jpg :align: center :alt: SAML21-XPRO-pinout

Default Zephyr Peripheral Mapping:

• SERCOM0 SPI MISO : PA04
• SERCOM0 SPI MOSI : PA06
• SERCOM0 SPI SCK : PA07
• SERCOM1 USART TX : PA18
• SERCOM1 USART RX : PA19
• SERCOM2 I2C SDA : PA08
• SERCOM2 I2C SCL : PA09
• SERCOM3 USART TX : PA22
• SERCOM3 USART RX : PA23
• SERCOM4 USART TX : PB08
• SERCOM4 USART RX : PB09
• SERCOM5 SPI MISO : PB16
• SERCOM5 SPI MOSI : PB22
• SERCOM5 SPI SCK : PB23
• USB DP : PA25
• USB DM : PA24
• GPIO SPI CS : PB17
• GPIO/PWM LED0 : PB10

System Clock

The SAML21 MCU is configured to use the 32.768 kHz external oscillator with the on-chip PLL generating the 48 MHz system clock.

Serial Port

The SAML21 MCU has six SERCOM based USARTs with two configured as USARTs in this BSP. SERCOM3 is the default Zephyr console.

• SERCOM1 115200 8n1 - connected to EXT2 and EXT3
• SERCOM3 115200 8n1 - connected to the onboard Atmel Embedded Debugger (EDBG)
• SERCOM4 115200 8n1 - connected to EXT1

PWM

The SAML21 MCU has 3 TCC based PWM units with up to 4 outputs each and a period of 24 bits or 16 bits. If :code:CONFIG_PWM_SAM0_TCC is enabled then LED0 is driven by TCC0 instead of by GPIO.

SPI Port

The SAML21 MCU has 6 SERCOM based SPIs, with two configured as SPI in this BSP.

• SERCOM0 - connected to EXT1
• SERCOM5 - connected to EXT2 and EXT3

Programming and Debugging

.. zephyr:board-supported-runners::

The SAM L21 Xplained Pro comes with a Atmel Embedded Debugger (EDBG). This provides a debug interface to the SAML21 chip and is supported by OpenOCD.

Flashing

#. Build the Zephyr kernel and the hello_world sample application:

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: saml21_xpro :goals: build :compact:

#. Connect the SAM L21 Xplained Pro to your host computer using the USB debug port.

#. Run your favorite terminal program to listen for output. Under Linux the terminal should be :code:/dev/ttyACM0. For example:

.. code-block:: console

  $ picocom -b 115200 /dev/ttyACM0

• Speed: 115200
• Data: 8 bits
• Parity: None
• Stop bits: 1

#. To flash an image:

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: saml21_xpro :goals: flash :compact:

You should see "Hello World! saml21_xpro" in your terminal.

References

.. target-notes::

.. _Microchip website: https://www.microchip.com/en-us/development-tool/atsaml21-xpro-b

.. _SAM L21 Family Datasheet: https://ww1.microchip.com/downloads/en/DeviceDoc/SAM_L21_Family_DataSheet_DS60001477C.pdf

.. _SAM L21 Xplained Pro Schematic: https://ww1.microchip.com/downloads/en/DeviceDoc/SAML21-Xplained-Pro_Design-Documentation.zip