This topic provides board-specific information about for NXP's i.MX RT1060 Evaluation Kit. Assuming that you have set up the development environment as per the intructions in getting started.

Board features

• MIMXRT1062DVL6B MCU featuring 600MHz ARM® Cortex®-M7 core, 4-MBytes Flash, 1024-kbytes RAM
• 4.3" 480x272 16-bit RGB565 Touch Display
• 256-Mbit SDRAM memory
• 512-Mbit Hyper Flash
• 64-Mbit QSPI Flash
• Socket for SD card

Supported color depths

The reference port for this board supports 16bpp color depth. The board family supports 24bpp and 32bpp framebuffers, but the reference boards have only 16 lines physically connected to the LCD interface, so only 16 bpp is supported. See QUL_COLOR_DEPTH and Color depth for more information.

Prebuilt demos and examples

The package for NXP i.MX RT1060 Eval Kit board comes with the following prebuilt demos and examples

• BareMetal
  • thermo

You can find it in the demos_images directory.

See the Flashing Instructions for NXP boards section on how to flash the binaries to the board.

Reading debug messages

By default, the output of qul_printf and Qul::PlatformInterface::log calls are redirected to a virtual serial port, which is exposed on the host machine via USB.

Debugging

• For convenience, you can set an environment variable that points to the Redlink tool, which is part of the MCUXpresso IDE. LinuxWindows

  export REDLINK=$MCUXPRESSO_IDE_PATH/ide/LinkServer/binaries/crt_emu_cm_redlink

  set REDLINK=%MCUXPRESSO_IDE_PATH%\ide\LinkServer\binaries\crt_emu_cm_redlink

  Where, MCUXPRESSO_IDE_PATH is an environment variable pointing to the MCUXpresso IDE installation directory.

  Note: In MCUXpresso IDE versions 11.8 and older the crt_emu_cm_redlink binary is installed to the IDE itself and can be accessed from <MCUXPRESSO_IDE_PATH>/ide/binaries/crt_emu_cm_redlink.

• Open a terminal window and run the following command: LinuxWindows

  $REDLINK --server :50032 --mi -2 -vc -p MIMXRT1062xxxxB --ConnectScript RT1060_connect.scp --flash-driver= -x ./platform/boards/nxp/mimxrt1060-evkb-baremetal/cmake

  %REDLINK% --server :50032 --mi -2 -vc -p MIMXRT1062xxxxB --ConnectScript RT1060_connect.scp --flash-driver= -x .\platform\boards\nxp\mimxrt1060-evkb-baremetal\cmake

  GDB Server is now listening for TCP connections on port, 50032.

  Note: To change TCP port used by redlink_server, change --server :50032 to different value.

• Run arm-none-eabi-gdb in a separate console LinuxWindows

  /path/to/bin/arm-none-eabi-gdb <PATH_TO>/your_app.elf

  C:\path\to\bin\arm-none-eabi-gdb.exe <PATH_TO>\your_app.elf

• Connect to the target via the gdbserver in the arm-none-eabi-gdb console using

  (gdb) target remote :50032

• Alternatively, flash the target device from the arm-none-eabi-gdb console using the following command:

  (gdb) load

Known issues

• The interrupted program does not resume its execution while debugging. It must be restarted using the mon reset halt command.

RLE decompression

For performance reasons, opaque RLE images with opacity applied are decompressed into intermediate buffers of a limited size, before blending them using PXP onto the framebuffer in SDRAM.

Performance can be improved to some degree by increasing the size of qul_scratch_buffer in platform_nxp.cpp, at the cost of more RAM usage.