1.. zephyr:board:: samd20_xpro
2
3Overview
4********
5
6The SAM D20 Xplained Pro evaluation kit is ideal for evaluation and
7prototyping with the SAM D20 Cortex®-M0+ processor-based
8microcontrollers. The kit includes Atmel’s Embedded Debugger (EDBG),
9which provides a full debug interface without the need for additional
10hardware.
11
12Hardware
13********
14
15- SAMD20J18 ARM Cortex-M0+ processor at 48 MHz
16- 32.768 kHz crystal oscillator
17- 256 KiB flash memory and 32 KiB of RAM
18- One yellow user LED
19- One mechanical user push button
20- One reset button
21- On-board USB based EDBG unit with serial console
22
23Supported Features
24==================
25
26The samd20_xpro board configuration supports the following hardware
27features:
28
29.. list-table::
30    :header-rows: 1
31
32    * - Interface
33      - Controller
34      - Driver / Component
35    * - NVIC
36      - on-chip
37      - nested vector interrupt controller
38    * - Flash
39      - on-chip
40      - Can be used with LittleFS to store files
41    * - SYSTICK
42      - on-chip
43      - systick
44    * - WDT
45      - on-chip
46      - Watchdog
47    * - ADC
48      - on-chip
49      - Analog to Digital Converter
50    * - GPIO
51      - on-chip
52      - I/O ports
53    * - USART
54      - on-chip
55      - Serial ports
56    * - I2C
57      - on-chip
58      - I2C ports
59    * - SPI
60      - on-chip
61      - Serial Peripheral Interface ports
62
63Other hardware features are not currently supported by Zephyr.
64
65The default configuration can be found in the Kconfig
66:zephyr_file:`boards/atmel/sam0/samd20_xpro/samd20_xpro_defconfig`.
67
68Connections and IOs
69===================
70
71The `Microchip website`_ has detailed information about board
72connections. Download the `SAM D20 Xplained Pro Schematic`_ for more detail.
73
74System Clock
75============
76
77The SAMD20 MCU is configured to use the 32.768 kHz external oscillator
78with the on-chip PLL generating the 48 MHz system clock.
79
80Serial Port
81===========
82
83The SAMD20 MCU has 6 SERCOM based USARTs. One of the USARTs
84(SERCOM3) is connected to the onboard Atmel Embedded Debugger (EDBG).
85SERCOM4 is available on the EXT1 connector.
86
87SPI Port
88========
89
90The SAMD20 MCU has 6 SERCOM based SPIs. On the SAM D20 Xplained Pro,
91SERCOM0 is available on the EXT1 connector.
92
93Programming and Debugging
94*************************
95
96The SAM D20 Xplained Pro comes with a Atmel Embedded Debugger (EDBG).  This
97provides a debug interface to the SAMD20 chip and is supported by
98OpenOCD.
99
100Flashing
101========
102
103#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
104
105   .. zephyr-app-commands::
106      :zephyr-app: samples/hello_world
107      :board: samd20_xpro
108      :goals: build
109      :compact:
110
111#. Connect the SAM D20 Xplained Pro to your host computer using the USB debug
112   port.
113
114#. Run your favorite terminal program to listen for output. Under Linux the
115   terminal should be :code:`/dev/ttyACM0`. For example:
116
117   .. code-block:: console
118
119      $ minicom -D /dev/ttyACM0 -o
120
121   The -o option tells minicom not to send the modem initialization
122   string. Connection should be configured as follows:
123
124   - Speed: 115200
125   - Data: 8 bits
126   - Parity: None
127   - Stop bits: 1
128
129#. To flash an image:
130
131   .. zephyr-app-commands::
132      :zephyr-app: samples/hello_world
133      :board: samd20_xpro
134      :goals: flash
135      :compact:
136
137   You should see "Hello World! samd20_xpro" in your terminal.
138
139References
140**********
141
142.. target-notes::
143
144.. _Microchip Technology:
145    https://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ATSAMD20-XPRO
146
147.. _Microchip website:
148    https://www.microchip.com/DevelopmentTools/ProductDetails.aspx?PartNO=ATSAMD20-XPRO
149
150.. _SAM D20 Xplained Pro Schematic:
151    http://ww1.microchip.com/downloads/en/DeviceDoc/SAMD20-Xplained-Pro_Design-Documentation.zip
152