| .. _arduino_zero: |
| |
| Arduino/Genuino Zero |
| #################### |
| |
| Overview |
| ******** |
| |
| The Arduino Zero is a maker-friendly development board with |
| Atmel’s Embedded Debugger (EDBG), which provides a full |
| debug interface without the need for additional hardware. |
| |
| .. image:: img/arduino_zero.png |
| :width: 500px |
| :align: center |
| :alt: Arduino Zero |
| |
| Hardware |
| ******** |
| |
| - ATSAMD21G18A ARM Cortex-M0+ processor at 48 MHz |
| - 32.768 kHz crystal oscillator |
| - 256 KiB flash memory and 32 KiB of RAM |
| - 3 user LEDs |
| - One reset button |
| - On-board USB based EDBG unit with serial console |
| - Native USB port |
| |
| Supported Features |
| ================== |
| |
| The arduino_zero board configuration supports the following hardware |
| features: |
| |
| +-----------+------------+------------------------------------------+ |
| | Interface | Controller | Driver/Component | |
| +===========+============+==========================================+ |
| | NVIC | on-chip | nested vector interrupt controller | |
| +-----------+------------+------------------------------------------+ |
| | Flash | on-chip | Can be used with LittleFS to store files | |
| +-----------+------------+------------------------------------------+ |
| | SYSTICK | on-chip | systick | |
| +-----------+------------+------------------------------------------+ |
| | WDT | on-chip | Watchdog | |
| +-----------+------------+------------------------------------------+ |
| | GPIO | on-chip | I/O ports | |
| +-----------+------------+------------------------------------------+ |
| | PWM | on-chip | Pulse Width Modulation | |
| +-----------+------------+------------------------------------------+ |
| | USART | on-chip | Serial ports | |
| +-----------+------------+------------------------------------------+ |
| | SPI | on-chip | Serial Peripheral Interface ports | |
| +-----------+------------+------------------------------------------+ |
| | USB | on-chip | USB device | |
| +-----------+------------+------------------------------------------+ |
| | DAC | on-chip | Digital to analogue converter | |
| +-----------+------------+------------------------------------------+ |
| |
| Other hardware features are not currently supported by Zephyr. |
| |
| The default configuration can be found in the Kconfig |
| :zephyr_file:`boards/arm/arduino_zero/arduino_zero_defconfig`. |
| |
| Connections and IOs |
| =================== |
| |
| The `Arduino store`_ has detailed information about board |
| connections. Download the `Arduino Zero Schematic`_ for more detail. |
| |
| 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. The internal |
| APB and GCLK unit are set up in the same way as the upstream Arduino |
| libraries. |
| |
| Serial Port |
| =========== |
| |
| The SAMD21 MCU has 6 SERCOM based USARTs. One of the USARTs |
| (SERCOM5) is connected to the onboard Atmel Embedded Debugger (EDBG). |
| SERCOM0 is available on the D0/D1 pins. |
| |
| 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 TCC2 instead of by GPIO. |
| |
| SPI Port |
| ======== |
| |
| The SAMD21 MCU has 6 SERCOM based SPIs. On the Arduino Zero, SERCOM4 |
| is available on the 6 pin connector at the edge of the board. |
| |
| USB Device Port |
| =============== |
| |
| The SAMD21 MCU has a USB device port that can be used to communicate |
| with a host PC. See the :ref:`usb-samples` sample applications for |
| more, such as the :ref:`usb_cdc-acm` sample which sets up a virtual |
| serial port that echos characters back to the host PC. |
| |
| DAC |
| === |
| |
| The SAMD21 MCU has a single channel DAC with 10 bits of resolution. On the |
| Arduino Zero, the DAC is available on pin A0. |
| |
| Programming and Debugging |
| ************************* |
| |
| The Arduino Zero 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 :ref:`hello_world` sample application: |
| |
| .. zephyr-app-commands:: |
| :zephyr-app: samples/hello_world |
| :board: arduino_zero |
| :goals: build |
| :compact: |
| |
| #. Connect the Arduino Zero 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: arduino_zero |
| :goals: flash |
| :compact: |
| |
| You should see "Hello World! arm" in your terminal. |
| |
| References |
| ********** |
| |
| .. target-notes:: |
| |
| .. _Arduino Store: |
| https://store.arduino.cc/genuino-zero |
| |
| .. _Arduino Zero Schematic: |
| https://www.arduino.cc/en/uploads/Main/Zero_V1.0.pdf |