boards: arm: add board support for mimxrt1010_evk

#

# Copyright (c) 2019, NXP

#

# SPDX-License-Identifier: Apache-2.0

#

zephyr_library()

zephyr_library_include_directories(${ZEPHYR_BASE}/drivers)

zephyr_library_sources(pinmux.c)

#

# Copyright (c) 2019, NXP

#

# SPDX-License-Identifier: Apache-2.0

#

config BOARD_MIMXRT1010_EVK

	bool "NXP MIMXRT1010-EVK"

	depends on SOC_SERIES_IMX_RT

	select SOC_PART_NUMBER_MIMXRT1011DAE5A

# Kconfig - MIMXRT1010-EVK board

#

# Copyright (c) 2019, NXP

#

# SPDX-License-Identifier: Apache-2.0

#

if BOARD_MIMXRT1010_EVK

config BOARD

	default "mimxrt1010_evk" if BOARD_MIMXRT1010_EVK

choice CODE_LOCATION

	default CODE_FLEXSPI

endchoice

if GPIO_MCUX_IGPIO

config GPIO_MCUX_IGPIO_1

	default y

config GPIO_MCUX_IGPIO_2

	default y

endif # GPIO_MCUX_IGPIO

if I2C_MCUX_LPI2C

config I2C_1

	default y

endif # I2C_MCUX_LPI2C

if UART_MCUX_LPUART

config UART_MCUX_LPUART_1

	default y

endif # UART_MCUX_LPUART

endif # BOARD_MIMXRT1010_EVK

#

# Copyright (c) 2019, NXP

#

# SPDX-License-Identifier: Apache-2.0

#

set_ifndef(OPENSDA_FW jlink)

if(OPENSDA_FW STREQUAL jlink)

  board_set_debugger_ifnset(jlink)

  board_set_flasher_ifnset(jlink)

endif()

board_runner_args(jlink "--device=MIMXRT1011")

include(${ZEPHYR_BASE}/boards/common/jlink.board.cmake)

.. _mimxrt1010_evk:

NXP MIMXRT1010-EVK

##################

Overview

********

The i.MX RT1010 offers a new entry-point into the i.MX RT crossover processor

series by providing the lowest-cost LQFP package option, combined with the

high performance and ease-of-use known throughout the entire i.MX RT series.

This device is fully supported by NXP’s MCUXpresso Software and Tools.

.. image:: ./mimxrt1010_evk.jpg

   :width: 720px

   :align: center

   :alt: MIMXRT1010-EVK

Hardware

********

- MIMXRT1011DAE5A MCU

- Memory

  - 128 Mbit QSPI Flash

- Connectivity

  - Micro USB host and OTG connectors

  - Arduino interface

- Audio

  - Audio Codec

  - 4-pole audio headphone jack

  - External speaker connection

  - Microphone

- Debug

  - JTAG 10-pin connector

  - OpenSDA with DAPLink

For more information about the MIMXRT1010 SoC and MIMXRT1010-EVK board, see

these references:

- `i.MX RT1010 Website`_

- `i.MX RT1010 Datasheet`_

- `i.MX RT1010 Reference Manual`_

- `MIMXRT1010-EVK Website`_

- `MIMXRT1010-EVK Quick Reference Guide`_

- `MIMXRT1010-EVK Design Files`_

Supported Features

==================

The mimxrt1010_evk board configuration supports the following hardware

features:

+-----------+------------+-------------------------------------+

| Interface | Controller | Driver/Component                    |

+===========+============+=====================================+

| NVIC      | on-chip    | nested vector interrupt controller  |

+-----------+------------+-------------------------------------+

| SYSTICK   | on-chip    | systick                             |

+-----------+------------+-------------------------------------+

| GPIO      | on-chip    | gpio                                |

+-----------+------------+-------------------------------------+

| I2C       | on-chip    | i2c                                 |

+-----------+------------+-------------------------------------+

| UART      | on-chip    | serial port-polling;                |

|           |            | serial port-interrupt               |

+-----------+------------+-------------------------------------+

The default configuration can be found in the defconfig file:

``boards/arm/mimxrt1010_evk/mimxrt1010_evk_defconfig``

Other hardware features are not currently supported by the port.

Connections and I/Os

====================

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

+---------------+-----------------+---------------------------+

| Name          | Function        | Usage                     |

+===============+=================+===========================+

| GPIO_11       | GPIO            | LED                       |

+---------------+-----------------+---------------------------+

| GPIO_SD_05    | GPIO            | SW4                       |

+---------------+-----------------+---------------------------+

| GPIO_10       | LPUART1_TX      | UART Console              |

+---------------+-----------------+---------------------------+

| GPIO_09       | LPUART1_RX      | UART Console              |

+---------------+-----------------+---------------------------+

| GPIO_01       | LPI2C1_SDA      | I2C SDA                   |

+---------------+-----------------+---------------------------+

| GPIO_02       | LPI2C1_CLK      | I2C SCL                   |

+---------------+-----------------+---------------------------+

System Clock

============

The MIMXRT1010 SoC is configured to use the 24 MHz external oscillator on the

board with the on-chip PLL to generate a 500 MHz core clock.

Serial Port

===========

The MIMXRT1010 SoC has four UARTs. ``LPUART1`` is configured for the console,

and the remaining are not used.

Programming and Debugging

*************************

Build and flash applications as usual (see :ref:`build_an_application` and

:ref:`application_run` for more details).

Configuring a Debug Probe

=========================

A debug probe is used for both flashing and debugging the board. This board is

configured by default to use the :ref:`opensda-daplink-onboard-debug-probe`,

however the :ref:`pyocd-debug-host-tools` do not yet support programming the

external flashes on this board so you must reconfigure the board for one of the

following debug probes instead.

:ref:`jlink-external-debug-probe`

-------------------------------------------

Install the :ref:`jlink-debug-host-tools` and make sure they are in your search

path.

Attach a J-Link 10-pin connector to J55. Check that jumpers J61 and J62 are

**off** (they are on by default when boards ship from the factory) to ensure

SWD signals are disconnected from the OpenSDA microcontroller.

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 J31 and J32 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 J41.

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 :ref:`hello_world` application.

.. zephyr-app-commands::

    :zephyr-app: samples/hello_world

    :board: mimxrt1010_evk

    :goals: flash

Open a serial terminal, reset the board (press the SW9 button), and you should

see the following message in the terminal:

.. code-block:: console

    Hello World! mimxrt1010_evk

.. _MIMXRT1010-EVK Website:

   https://www.nxp.com/MIMXRT1010-EVK

.. _MIMXRT1010-EVK Quick Reference Guide:

   https://www.nxp.com/docs/en/quick-reference-guide/iMX-RT1010-EVK-QSG.pdf

.. _MIMXRT1010-EVK Design Files:

   https://www.nxp.com/downloads/en/printed-circuit-boards/IMXRT1010-EVK-DESIGN-FILES.7z

.. _i.MX RT1010 Website:

   https://www.nxp.com/imxrt1010

.. _i.MX RT1010 Datasheet:

   https://www.nxp.com/docs/en/data-sheet/IMXRT1010CEC.pdf

.. _i.MX RT1010 Reference Manual:

   https://www.nxp.com/docs/en/reference-manual/IMXRT1010RM.pdf