boards/atmel/sam/sam_e70_xplained/doc/index.rst
.. zephyr:board:: sam_e70_xplained
Overview
The SAM E70 Xplained evaluation kit is a development platform to evaluate the Atmel SAM E70 series microcontrollers. The current version allows to use both IC variations ATSAME70Q21A(B).
Hardware
.. zephyr:board-supported-hw::
The SAME70-XPLD User Guide_ has detailed information about board connections.
The SAM E70 MCU is configured to use the 12 MHz external oscillator on the board with the on-chip PLL to generate a 300 MHz system clock.
The ATSAME70Q21 MCU has five UARTs and three USARTs. One of the USARTs is configured for the console and is available as a Virtual COM Port via EDBG USB chip.
Programming and Debugging
.. zephyr:board-supported-runners::
Flashing the Zephyr project onto SAM E70 MCU requires the OpenOCD tool_.
Support for Atmel SAM E microcontroller series was added in OpenOCD release
0.10.0, which was added in Zephyr SDK 0.9.2.
By default a factory new SAM E70 chip will boot SAM-BA boot loader located in the ROM, not the flashed image. This is determined by the value of GPNVM1 (General-Purpose NVM bit 1). The flash procedure will ensure that GPNVM1 is set to 1 changing the default behavior to boot from Flash.
If your chip has a security bit GPNVM0 set you will be unable to program flash memory or connect to it via a debug interface. The only way to clear GPNVM0 is to perform a chip erase procedure that will erase all GPNVM bits and the full contents of the SAM E70 flash memory:
#. 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:
#. Connect the SAM E70 Xplained board to your host computer using the
USB debug port. Then build and flash the :zephyr:code-sample:hello_world
application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: sam_e70_xplained/same70q21 :goals: build flash
You should see "Hello World! sam_e70_xplained" in your terminal.
#. To use the SoC variation B IC, you need type "sam_e70_xplained/same70q21b".
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: sam_e70_xplained/same70q21b :goals: build flash
You should see "Hello World! sam_e70_xplained" in your terminal.
You can flash the image using an external debug adapter such as J-Link
or ULINK, connected to the 20-pin JTAG header. Supply the name of the
debug adapter (e.g., jlink) via an OPENOCD_INTERFACE environment
variable. OpenOCD will look for the appropriate interface
configuration in an interface/$(OPENOCD_INTERFACE).cfg file on its
internal search path.
You can debug an application in the usual way. Here is an example for the
:zephyr:code-sample:hello_world application.
.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: sam_e70_xplained/same70q21 :maybe-skip-config: :goals: debug
References
SAM E70 Product Page: http://www.atmel.com/products/microcontrollers/arm/sam-e.aspx
.. _SAME70-XPLD User Guide: http://www.atmel.com/Images/Atmel-44050-Cortex-M7-Microcontroller-SAM-E70-XPLD-Xplained_User-guide.pdf
.. _OpenOCD tool: http://openocd.org/
.. _SAM-BA: http://www.atmel.com/tools/ATMELSAM-BAIN-SYSTEMPROGRAMMER.aspx