.. zephyr:board:: mimxrt1050_evk

Overview

The i.MX RT1050 is a new processor family featuring NXP's advanced implementation of the ARM Cortex-M7 Core. It provides high CPU performance and real-time response.

The i.MX RT1050 provides various memory interfaces, including SDRAM, Raw NAND FLASH, NOR FLASH, SD/eMMC, Quad SPI, HyperBus and a wide range of other interfaces for connecting peripherals, such as WLAN, Bluetooth™, GPS, displays, and camera sensors. As with other i.MX processors, i.MX RT1050 also has rich audio and video features, including LCD display, basic 2D graphics, camera interface, SPDIF, and I2S audio interface.

Hardware

MIMXRT1052DVL6A MCU (600 MHz, 512 KB TCM)
Memory
- 256 KB SDRAM
- 64 Mbit QSPI Flash
- 512 Mbit Hyper Flash
Display
- LCD connector
- Touch connector
Ethernet
- 10/100 Mbit/s Ethernet PHY
USB
- USB 2.0 OTG connector
- USB 2.0 host connector
Audio
- 3.5 mm audio stereo headphone jack
- Board-mounted microphone
- Left and right speaker out connectors
Power
- 5 V DC jack
Debug
- JTAG 20-pin connector
- OpenSDA with DAPLink
Sensor
- FXOS8700CQ 6-axis e-compass
- CMOS camera sensor interface
Expansion port
- Arduino interface
CAN bus connector

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

i.MX RT1050 Website_
i.MX RT1050 Datasheet_
i.MX RT1050 Reference Manual_
MIMXRT1050-EVK Website_
MIMXRT1050-EVK User Guide_
MIMXRT1050-EVK Schematics_

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 mimxrt1050_evk board.

Shields for Supported Features

Some features in the table above are tested with Zephyr shields. These shields are tested on this board:

:ref:rk043fn02h_ct and :ref:rk043fn66hs_ctg - support the Display interface.
:ref:dvp_fpc24_mt9m114 - supports the CSI video/camera interface.

Connections and IOs

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

.. note:: In order to use the SPI peripheral on this board, resistors R278, R279, R280, and R281 must be populated with zero ohm resistors

System Clock

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

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 MIMXRT1050 SoC has eight UARTs. LPUART1 is configured for the console, LPUART3 for the Bluetooth Host Controller Interface (BT HCI), and the remaining are not used.

USB

The RT1050 SoC has two USB OTG (USBOTG) controllers that supports both device and host functions through its micro USB connectors. Only USB device function is supported in Zephyr at the moment.

Board Targets

This board has two variants that can be targeted, depending on which flash to set as zephyr,flash:

mimxrt1050_evk/mimxrt1052/hyperflash is the default variant for the out of box setup of the board using hyperflash.
mimxrt1050_evk/mimxrt1052/qspi is for a board that has been reworked to use the qspi flash instead of hyperflash.

Programming and Debugging

.. zephyr:board-supported-runners::

.. note:: Newer revisions of this board use :ref:lpc-link2-onboard-debug-probe, while older revisions use the :ref:opensda-onboard-debug-probe. Schematic revisions A/A1 use the K20 OpenSDA probe, and B/B1 use the LPC-Link2 LPC4322 probe.

This board supports 3 debug host tools. Please install your preferred host tool, then follow the instructions in Configuring a Debug Probe (Schematic A/A1)_ or Configuring a Debug Probe (Schematic B/B1)_, depending on board schematic revision to configure the board appropriately.

:ref:linkserver-debug-host-tools (Default, NXP Supported)
:ref:jlink-debug-host-tools (NXP Supported)
: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 (Schematic A/A1)

For the RT1050 Schematic Rev A, J32/J33 are the SWD isolation jumpers, SW4 is the reset button, and J21 is the 20 pin JTAG/SWD header.

.. include:: ../../common/opensda-debug.rst.inc

Configuring a Debug Probe (Schematic B/B1)

For the RT1050 Schematic Rev B, J47/J48 are the SWD isolation jumpers, J42 is the DFU mode jumper, and J21 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 J30 and J31 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 J28.

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: mimxrt1050_evk//hyperflash :goals: flash

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

.. code-block:: console

***** Booting Zephyr OS v1.14.0-rc1 ***** Hello World! mimxrt1050_evk//hyperflash

Debugging

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

.. zephyr-app-commands:: :zephyr-app: samples/hello_world :board: mimxrt1050_evk//hyperflash :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! mimxrt1050_evk//hyperflash

Troubleshooting

If the debug probe fails to connect with the following error, it's possible that the boot header in HyperFlash is invalid or corrupted. The boot header is configured by :kconfig:option:CONFIG_NXP_IMXRT_BOOT_HEADER.

.. code-block:: console

Remote debugging using :2331 Remote communication error. Target disconnected.: Connection reset by peer. "monitor" command not supported by this target. "monitor" command not supported by this target. You can't do that when your target is `exec' (gdb) Could not connect to target. Please check power, connection and settings.

You can fix it by erasing and reprogramming the HyperFlash with the following steps:

#. Set the SW7 DIP switches to ON-ON-ON-OFF to prevent booting from HyperFlash.

#. Reset by pressing SW4

#. Run west debug or west flash again with a known working Zephyr application.

#. Set the SW7 DIP switches to OFF-ON-ON-OFF to boot from HyperFlash.

#. Reset by pressing SW4

Board Revisions

The original MIMXRT1050-EVK (rev A0) board was updated with a newer MIMXRT1050-EVKB (rev A1) board, with these major hardware differences:

SoC changed from MIMXRT1052DVL6\ A to MIMXRT1052DVL6\ B
Hardware bug fixes for: power, interfaces, and memory
Arduino headers included

For more details, please see the following NXP i.MXRT1050 A0 to A1 Migration Guide_.

Current Zephyr build supports the new MIMXRT1050-EVKB

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

.. _MIMXRT1050-EVK Website: https://www.nxp.com/products/microcontrollers-and-processors/arm-based-processors-and-mcus/i.mx-applications-processors/i.mx-rt-series/i.mx-rt1050-evaluation-kit:MIMXRT1050-EVK

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

.. _MIMXRT1050-EVK Schematics: https://www.nxp.com/webapp/Download?colCode=MIMXRT1050-EVK-DESIGNFILES

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

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

.. _i.MX RT1050 Reference Manual: https://www.nxp.com/docs/en/reference-manual/IMXRT1050RM.pdf

.. _OpenSDA J-Link MIMXRT1050-EVK-Hyperflash Firmware: https://www.segger.com/downloads/jlink/OpenSDA_MIMXRT1050-EVK-Hyperflash

.. _NXP i.MXRT1050 A0 to A1 Migration Guide: https://www.nxp.com/docs/en/nxp/application-notes/AN12146.pdf

.. _Enable QSPI flash support in SEGGER JLink: https://wiki.segger.com/i.MXRT1050#QSPI_flash