Hardware requirements

  • Micro USB cable

  • MIMXRT700-EVK

  • Personal Computer

  • TFT Proto 5” CAPACITIVE board HW REV 1.01 by Mikroelektronika. (Named as SSD1963 panel in project. Not necessary if use MIPI panel)

  • NXP “RK055HDMIPI4M” MIPI Rectangular Display (RK055AHD091) (Not necessary if use other panel)

  • RK055IQH091 MIPI panel (Not necessary if use other panel)

  • NXP “RK055MHD091A0-CTG” MIPI Rectangular Display (RK055MHD091) (Not necessary if use other panel)

  • NXP “G1120B0MIPI” MIPI Circular Display (RM67162) (Not necessary if use other panel)

  • RaspberryPi Panel (Not necessary if use other panel)

  • ZC143AC72MIPI DBI panel (CO5300) (Not necessary if use other panel)

Board settings

To use TFT Proto 5” panel: Connect panel to J4. Make sure to connect JP7 2&3 to use 3.3v interface.

To use MIPI panel: Connect MIPI panel to J52.

To use Raspberry panel: Connect the panel to J8. Then connect the panel’s 5V pin to JP43-1, GND pin to JP43-2. Make sure the R75, R76, R79, R80 are connected.

Prepare the Demo

  1. Connect a USB cable between the host PC and the OpenSDA USB port on the target board.

  2. Open a serial terminal with the following settings:

    • 115200 baud rate

    • 8 data bits

    • No parity

    • One stop bit

    • No flow control

  3. Download the program to the target board.

  4. Either press the reset button on your board or launch the debugger in your IDE to begin running the demo.

Project Configuration

This project supports different panels and pixel formats, there are two methods to configure.

  1. Configure by Kconfig, passing configuration flags during build: west build ....

  2. OR configure by modifing the macros in configure file mcux_config.h.

NOTE: The mcux_config.h is generated by Kconfig, if Kconfig is used, don’t modify mcux_config.h directly, because the manual changes will be overwritten by Kconfig. NOTE: When the macros to be modified don’t exist in the mcux_config.h, add them directly in mcux_config.h.

Steps to select the panel

Please read section Project Configuration to know the configuration methods first.

The demo uses “RK055MHD091A0-CTG” MIPI rectangular panel (RK055MHD091) by default. The panel can be switched by using west build option or modifying mcux_config.h.

Panel

west build option

mcux_config.h DEMO_PANEL

TFT Proto 5” CAPACITIVE (SSD1963)

-DCONFIG_TFT_PROTO_5=y

4

RK055HDMIPI4M MIPI Rectangular (RK055AHD091)

-DCONFIG_RK055AHD091=y

0

MIPI RK055IQH091 panel

-DCONFIG_RK055IQH091=y

1

G1120B0MIPI MIPI Circular (RM67162)

-DCONFIG_G1120B0MIPI=y

3

RK055MHD091A0-CTG MIPI Rectanglular (RK055MHD091, default)

-DCONFIG_RK055MHD091=y

2

RaspberryPi

-DCONFIG_RASPI_7INCH=y

5

ZC143AC72MIPI MIPI Circular (CO5300)

-DCONFIG_ZC143AC72MIPI=y

6

Panel configuration

Please read section Project Configuration to know the configuration methods first.

TFT Proto 5” CAPACITIVE Panel (SSD1963)

Pixel format

  • By Kconfig

    • RGB565(default): Use build parameter -DCONFIG_LV_COLOR_DEPTH_16=y or omit.

    • RGB888: Use build parameter -DCONFIG_LV_COLOR_DEPTH_24=y

  • Or By modifying mcux_config.h. If the macros don’t exist, add them directly.

    • RGB565(default)

      #define CONFIG_LV_COLOR_DEPTH 16
#define CONFIG_LV_DRAW_BUF_ALIGN 64
#define DEMO_SSD1963_BUFFER_FORMAT 0

    • RGB888

      #define CONFIG_LV_COLOR_DEPTH 24
#define CONFIG_LV_DRAW_BUF_ALIGN 192
#define DEMO_SSD1963_BUFFER_FORMAT 1

Driven Peripheral

  • By Kconfig

    • Driven by LCDIF(default): Use build parameter -DCONFIG_DEMO_PANEL_TFT_PROTO_5_LCDIF=y or omit.

    • Driven by FlexIO: Use build parameter -DCONFIG_DEMO_PANEL_TFT_PROTO_5_FLEXIO=y

  • Or By modifying mcux_config.h. If the macros don’t exist, add them directly.

    • Driven by LCDIF(default)

      #define SSD1963_DRIVEN_BY 1

    • Driven by FlexIO

      #define SSD1963_DRIVEN_BY 0

RK055HDMIPI4M MIPI Rectangular Panel (RK055AHD091)

Pixel format

  • By Kconfig

    • RGB565(default): Use build parameter -DCONFIG_LV_COLOR_DEPTH_16=y or omit.

    • XRGB888: Use build parameter -DCONFIG_LV_COLOR_DEPTH_32=y

  • Or By modifying mcux_config.h. If the macros don’t exist, add them directly.

    • RGB565(default)

      #define CONFIG_LV_COLOR_DEPTH 16
#define CONFIG_LV_DRAW_BUF_ALIGN 64
#define DEMO_RK055AHD091_USE_XRGB8888 0

    • XRGB888

      #define CONFIG_LV_COLOR_DEPTH 32
#define CONFIG_LV_DRAW_BUF_ALIGN 64
#define DEMO_RK055AHD091_USE_XRGB8888 1

RK055MHD091A0-CTG MIPI Rectanglular Panel (RK055MHD091)

Pixel format

  • By Kconfig

    • RGB565(default): Use build parameter -DCONFIG_LV_COLOR_DEPTH_16=y or omit.

    • XRGB888: Use build parameter -DCONFIG_LV_COLOR_DEPTH_32=y

  • Or By modifying mcux_config.h. If the macros don’t exist, add them directly.

    • RGB565(default)

      #define CONFIG_LV_COLOR_DEPTH 16
#define CONFIG_LV_DRAW_BUF_ALIGN 64
#define DEMO_RK055MHD091_USE_XRGB8888 0

    • XRGB888

      #define CONFIG_LV_COLOR_DEPTH 32
#define CONFIG_LV_DRAW_BUF_ALIGN 64
#define DEMO_RK055MHD091_USE_XRGB8888 1

G1120B0MIPI MIPI Circular Panel (RM67162)

Pixel format

  • By Kconfig

    • RGB565(default): Use build parameter -DCONFIG_LV_COLOR_DEPTH_16=y or omit.

    • RGB888: Use build parameter -DCONFIG_LV_COLOR_DEPTH_24=y

  • Or By modifying mcux_config.h. If the macros don’t exist, add them directly.

    • RGB565(default)

      #define CONFIG_LV_COLOR_DEPTH 16
#define CONFIG_LV_DRAW_BUF_ALIGN 64
#define DEMO_RM67162_BUFFER_FORMAT 0

    • RGB888

      #define CONFIG_LV_COLOR_DEPTH 24
#define CONFIG_LV_DRAW_BUF_ALIGN 192
#define DEMO_RM67162_BUFFER_FORMAT 1

ZC143AC72MIPI MIPI Circular Panel (CO5300)

Pixel format

  • By Kconfig

    • RGB565(default): Use build parameter -DCONFIG_LV_COLOR_DEPTH_16=y or omit.

    • RGB888: Use build parameter -DCONFIG_LV_COLOR_DEPTH_24=y

  • Or By modifying mcux_config.h. If the macros don’t exist, add them directly.

    • RGB565(default)

      #define CONFIG_LV_COLOR_DEPTH 16
#define CONFIG_LV_DRAW_BUF_ALIGN 64
#define DEMO_CO5300_BUFFER_FORMAT 0

    • RGB888

      #define CONFIG_LV_COLOR_DEPTH 24
#define CONFIG_LV_DRAW_BUF_ALIGN 192
#define DEMO_CO5300_BUFFER_FORMAT 1

MIPI RK055IQH091 Rectangular Panel

Pixel format

  • Only RGB565 is supported

RaspberryPi

Pixel format

  • Only RGB565 is supported

Running the demo

There is tearing effect when using the SSD1963 panel, because the panel video buffer could not be fully updated during fresh interval.