de13103f0b
Add .. zephyr:board-supported-runners:: to the Programming and Debugging section of the documentation for each board that has one such section, as this is the most natural place to put it. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
148 lines
3.7 KiB
ReStructuredText
148 lines
3.7 KiB
ReStructuredText
.. zephyr:board:: samd21_xpro
|
|
|
|
Overview
|
|
********
|
|
|
|
The SAM D21 Xplained Pro evaluation kit is ideal for evaluation and
|
|
prototyping with the SAM D21 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
|
|
********
|
|
|
|
- SAMD21J18 ARM Cortex-M0+ processor at 48 MHz
|
|
- 32.768 kHz crystal oscillator
|
|
- 256 KiB flash memory and 32 KiB of RAM
|
|
- 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 D21 Xplained Pro evaluation kit has 3 GPIO controllers. These
|
|
controllers are responsible for pin muxing, input/output, pull-up, etc.
|
|
|
|
For more details please refer to `SAM D21 Family Datasheet`_ and the `SAM D21
|
|
Xplained Pro Schematic`_.
|
|
|
|
.. image:: img/ATSAMD21-XPRO-pinout.jpg
|
|
:align: center
|
|
:alt: SAMD21-XPRO-pinout
|
|
|
|
Default Zephyr Peripheral Mapping:
|
|
----------------------------------
|
|
- SERCOM0 USART TX : PA10
|
|
- SERCOM0 USART RX : PA11
|
|
- SERCOM1 USART TX : PA16
|
|
- SERCOM1 USART RX : PA19
|
|
- SERCOM2 I2C SDA : PA08
|
|
- SERCOM2 I2C SCL : PA09
|
|
- SERCOM3 USART TX : PA22
|
|
- SERCOM3 USART RX : PA23
|
|
- 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 : PB30
|
|
|
|
System Clock
|
|
============
|
|
|
|
The SAMD21 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 SAMD21 MCU has six SERCOM based USARTs with three configured as USARTs in
|
|
this BSP. SERCOM3 is the default Zephyr console.
|
|
|
|
- SERCOM0 9600 8n1
|
|
- SERCOM1 115200 8n1
|
|
- SERCOM3 115200 8n1 connected to the onboard Atmel Embedded Debugger (EDBG)
|
|
|
|
PWM
|
|
===
|
|
|
|
The SAMD21 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 SAMD21 MCU has 6 SERCOM based SPIs. On the SAM D21 Xplained Pro,
|
|
SERCOM5 is connected to an 8 megabit SPI flash.
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
|
|
.. zephyr:board-supported-runners::
|
|
|
|
The SAM D21 Xplained Pro comes with a Atmel Embedded Debugger (EDBG). This
|
|
provides a debug interface to the SAMD21 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: samd21_xpro
|
|
:goals: build
|
|
:compact:
|
|
|
|
#. Connect the SAM D21 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
|
|
|
|
$ minicom -D /dev/ttyACM0 -o
|
|
|
|
The -o option tells minicom not to send the modem initialization
|
|
string. Connection should be configured as follows:
|
|
|
|
- Speed: 115200
|
|
- Data: 8 bits
|
|
- Parity: None
|
|
- Stop bits: 1
|
|
|
|
#. To flash an image:
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/hello_world
|
|
:board: samd21_xpro
|
|
:goals: flash
|
|
:compact:
|
|
|
|
You should see "Hello World! samd21_xpro" in your terminal.
|
|
|
|
References
|
|
**********
|
|
|
|
.. target-notes::
|
|
|
|
.. _Microchip Technology:
|
|
http://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ATSAMD21-XPRO
|
|
|
|
.. _SAM D21 Family Datasheet:
|
|
http://ww1.microchip.com/downloads/en/DeviceDoc/SAM-D21-Family-Datasheet-DS40001882C.pdf
|
|
|
|
.. _SAM D21 Xplained Pro Schematic:
|
|
http://ww1.microchip.com/downloads/en/DeviceDoc/SAMD21-Xplained-Pro_Design-Documentation.zip
|