.. zephyr:board:: mimxrt1020_evk

Overview

The i.MX RT1020 expands the i.MX RT crossover processor families by providing high-performance feature set in low-cost LQFP packages, further simplifying board design and layout for customers. The i.MX RT1020 runs on the Arm® Cortex®-M7 core at 500 MHz.

Hardware

MIMXRT1021DAG5A MCU
Memory
- 256 Mbit SDRAM
- 64 Mbit QSPI Flash
- TF socket for SD card
Connectivity
- 10/100 Mbit/s Ethernet PHY
- Micro USB host and OTG connectors
- CAN transceivers
- Arduino interface
Audio
- Audio Codec
- 4-pole audio headphone jack
- Microphone
- External speaker connection
Power
- 5 V DC jack
Debug
- JTAG 20-pin connector
- OpenSDA with DAPLink

For more information about the MIMXRT1020 SoC and MIMXRT1020-EVK board, see these references:

i.MX RT1020 Website_
i.MX RT1020 Datasheet_
i.MX RT1020 Reference Manual_
MIMXRT1020-EVK Website_
MIMXRT1020-EVK User Guide_
MIMXRT1020-EVK Design Files_

External Memory

This platform has the following external memories:

Supported Features

.. zephyr:board-supported-hw::

.. note::

For additional features not yet supported, please also refer to the :zephyr:board:mimxrt1064_evk , which is the superset board in NXP's i.MX RT10xx family. NXP prioritizes enabling the superset board with NXP's Full Platform Support for Zephyr. Therefore, the mimxrt1064_evk board may have additional features already supported, which can also be re-used on this mimxrt1020_evk board.

Connections and I/Os

The MIMXRT1020 SoC has five pairs of pinmux/gpio controllers.

System Clock

The MIMXRT1020 SoC is configured to use SysTick as the system clock source, running at 500MHz.

When power management is enabled, the 32 KHz low frequency oscillator on the board will be used as a source for the GPT timer to generate a system clock. This clock enables lower power states, at the cost of reduced resolution

Serial Port

The MIMXRT1020 SoC has eight UARTs. LPUART1 is configured for the console, LPUART2 for the Bluetooth Host Controller Interface (BT HCI), and the remaining are not used.

Programming and Debugging

.. zephyr:board-supported-runners::

This board supports 3 debug host tools. Please install your preferred host tool, then follow the instructions in Configuring a Debug Probe_ to configure the board appropriately.

:ref:linkserver-debug-host-tools (Default, Supported by NXP)
:ref:jlink-debug-host-tools (Supported by NXP)
:ref:pyocd-debug-host-tools (Not supported by NXP)

Once the host tool and board are configured, build and flash applications as usual (see :ref:build_an_application and :ref:application_run for more details).

Configuring a Debug Probe

For the RT1020, J47/J48 are the SWD isolation jumpers, J42 is the DFU mode jumper, and J16 is the 20 pin JTAG/SWD header.

.. include:: ../../common/rt1xxx-lpclink2-debug.rst.inc

Configuring a Console

Regardless of your choice in debug probe, we will use the OpenSDA microcontroller as a usb-to-serial adapter for the serial console. Check that jumpers J25 and J26 are on (they are on by default when boards ship from the factory) to connect UART signals to the OpenSDA microcontroller.

Connect a USB cable from your PC to J23.

Use the following settings with your serial terminal of choice (minicom, putty, etc.):

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

Flashing

Here is an example for the :zephyr:code-sample:hello_world application.

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

Open a serial terminal, reset the board (press the SW5 button), and you should see the following message in the terminal:

.. code-block:: console

***** Booting Zephyr OS v1.14.0-rc1 ***** Hello World! mimxrt1020_evk

Debugging

Here is an example for the :zephyr:code-sample:hello_world application.

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: mimxrt1020_evk :goals: debug

Open a serial terminal, step through the application in your debugger, and you should see the following message in the terminal:

.. code-block:: console

***** Booting Zephyr OS v1.14.0-rc1 ***** Hello World! mimxrt1020_evk

.. include:: ../../common/board-footer.rst.inc

.. _MIMXRT1020-EVK Website: https://www.nxp.com/support/developer-resources/run-time-software/i.mx-developer-resources/i.mx-rt1020-evaluation-kit:MIMXRT1020-EVK

.. _MIMXRT1020-EVK User Guide: https://www.nxp.com/webapp/Download?colCode=MIMXRT1020EVKHUG

.. _MIMXRT1020-EVK Design Files: https://www.nxp.com/webapp/Download?colCode=MIMXRT1020-EVK-Design-Files

.. _i.MX RT1020 Website: https://www.nxp.com/products/processors-and-microcontrollers/arm-based-processors-and-mcus/i.mx-applications-processors/i.mx-rt-series/i.mx-rt1020-crossover-processor-with-arm-cortex-m7-core:i.MX-RT1020

.. _i.MX RT1020 Datasheet: https://www.nxp.com/docs/en/data-sheet/IMXRT1020CEC.pdf

.. _i.MX RT1020 Reference Manual: https://www.nxp.com/webapp/Download?colCode=IMXRT1020RM

.. _OpenSDA J-Link MIMXRT1020-EVK Firmware: https://www.segger.com/downloads/jlink/OpenSDA_MIMXRT1020-EVK