Overview

This topic provides all the necessary information to get started on the Infineon PSOC™ Edge platforms supported by Qt Quick Ultralite.

Use the Infineon Online Software Delivery Tool to flash Qt for MCUs demos. These applications, developed by Infineon and Qt Group, showcase the high-performance graphics capabilities of the EVK.

Compatible versions

Qt Quick Ultralite has been tested with ModusToolbox Tools Package version 3.7.0.

Installing prerequisites

Install the prerequisites before setting up your development environment.

Infineon PSOC Edge E84 Evaluation Kit

• Qt Quick Ultralite 2.12.1
• Qt Quick Ultralite Infineon PSOC Edge E84 Evaluation Kit platform package
• Infineon PSOC Edge E84 Evaluation Kit
• Infineon ModusToolbox Software
  • ModusToolbox Tools Package 3.7.0
  • Eclipse IDE for ModusToolbox 2025.8.0 or newer
  • ModusToolbox Edge Protect Security Suite 1.6.1
  • ModusToolbox Programming Tools 1.7.0
  • GNU Arm GCC 14.2.1 or LLVM Embedded Toolchain for Arm 19.1.5

Preparing a ModusToolbox project

ModusToolbox projects require additional configuration to run Qt Quick Ultralite. The following configurations are required on top of an empty PSOC Edge application.

Libraries

Add the following libraries for the proj_cm55 in the ModusToolbox Library Manager:

QSPI configuration

Add the following QSPI configuration in the ModusToolbox QSPI Configurator to get PSRAM working in Qt Quick Ultralite:

Device configuration

Change the following configurations in the ModusToolbox Device Configurator

Enable graphics

In Peripherals -> System, enable Graphics and change the following parameter values:

Change I2C clock frequency and data rate

In Peripherals -> Communication, enable Serial Communication Block (SCB) 0 and change the parameters to the following parameter values:

The values in Actual Data Rate section are dependent on the clock config and cannot be changed here. You can change the values by setting the following parameters for the 16 bit Divider 0 clk (CYBSP_I2C_CONTROLLER_CLK_DIV) in Clocks -> Dividers -> Peripheral -> Peri 0 -> Peri 0 Clock Group 1 -> 16 bit -> 16 bit Divider 0:

Enable PSRAM memory region for Qt Quick Ultralite

Ensure Peripherals -> Communication -> Quad Serial memory Interface (QSPI) 1 -> QSPI 1 Core 0 is enabled. Go to Memory -> Memory Regions, open the Serial Memory Interface block 1, memory 2 (S70KS1283) and click the Plus button next to the UNALLOCATED region and select Add region. Set the following properties for the new region:

Click OK to create the region.

Enable PSRAM support in Qt Quick Ultralite by following the instructions here.

Project configuration

The following changes are needed for the project to support Qt Quick Ultralite:

• Remove FreeRTOSConfig.h if it exists in the proj_cm55. Exported Qt Quick Ultralite applications come with a FreeRTOSConfig.h file that is preconfigured for Qt Quick Ultralite.
• Add

  COMPONENTS+=GFXSS

  to the common.mk.

Building the application

Setting up the environment

Before building the application, set the following environment variables:

export QUL_ROOT=$HOME/Qt/QtMCUs/2.12.1

set QUL_ROOT=C:\Qt\QtMCUs\2.12.1

Exporting the Qt Quick Ultralite application

Export the application code using the qmlprojectexporter:

$QUL_ROOT/bin/qmlprojectexporter \
/path/to/your/project.qmlproject \
--boarddefaults=$QUL_ROOT/platform/boards/infineon/psoc-edge-e84-freertos/cmake/BoardDefaults_16bpp_default.qmlprojectconfig \
--toolchain GNU \
--platform psoc-edge-e84-freertos \
--extend-project /path/to/mtw/your_ModusToolbox_application_project/proj_cm55/Makefile \
--project-type ModusToolbox \
--generate-entrypoint \
--platform-metadata $QUL_ROOT/lib/QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Linux_armgcc-export.json

$QUL_ROOT/bin/qmlprojectexporter \
/path/to/your/project.qmlproject \
--boarddefaults=$QUL_ROOT/platform/boards/infineon/psoc-edge-e84-freertos/cmake/BoardDefaults_16bpp_default.qmlprojectconfig \
--toolchain LLVM \
--platform psoc-edge-e84-freertos \
--extend-project /path/to/mtw/your_ModusToolbox_application_project/proj_cm55/Makefile \
--project-type ModusToolbox \
--generate-entrypoint \
--platform-metadata $QUL_ROOT/lib/QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Linux_llvm-arm-export.json

%QUL_ROOT%\bin\qmlprojectexporter ^
C:\path\to\your\project.qmlproject ^
--boarddefaults=%QUL_ROOT%\platform\boards\infineon\psoc-edge-e84-freertos\cmake\BoardDefaults_16bpp_default.qmlprojectconfig ^
--toolchain GNU ^
--platform psoc-edge-e84-freertos ^
--extend-project C:\path\to\mtw\your_ModusToolbox_application_project\proj_cm55\Makefile ^
--project-type ModusToolbox ^
--generate-entrypoint ^
--platform-metadata %QUL_ROOT%\lib\QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Windows_armgcc-export.json

%QUL_ROOT%\bin\qmlprojectexporter ^
C:\path\to\your\project.qmlproject ^
--boarddefaults=%QUL_ROOT%\platform\boards\infineon\psoc-edge-e84-freertos\cmake\BoardDefaults_16bpp_default.qmlprojectconfig ^
--toolchain LLVM ^
--platform psoc-edge-e84-freertos ^
--extend-project C:\path\to\mtw\your_ModusToolbox_application_project\proj_cm55\Makefile ^
--project-type ModusToolbox ^
--generate-entrypoint ^
--platform-metadata %QUL_ROOT%\lib\QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Windows_llvm-arm-export.json

If the export was successful, the ModusToolbox project should have a QtMCUs directory created under proj_cm55.

Edit the proj_cm55/Makefile and add the FREERTOS_DIR variable right before ## QUL BEGIN ## comment:

FREERTOS_DIR=$(patsubst %/,%,$(CY_GETLIBS_SHARED_PATH))/$(CY_GETLIBS_SHARED_NAME)/freertos/release-v10.6.202/Source

If the Qt Quick Ultralite application uses selectors for different variants, add them with the --selector argument for qmlprojectexporter. For example, the Qt Quick Ultralite Thermostat Demo uses the following selectors:

--selector normal,small

The default configuration for Infineon PSOC Edge platforms is to export Qt Quick Ultralite libraries that are built with Release configuration. If you have built Qt Quick Ultralite libraries with a different build configuration (such as Debug), override the build type by adding --qul-build-type argument to the qmlprojectexporter command:

--qul-build-type Debug

Several examples shipped with Qt Quick Ultralite do not have main() function in the application code. Use the --generate-entrypoint argument while exporting these examples, unless you are adding a main() function. For more information about writing a main() function initializing Qt Quick Ultralite, see Running Qt Quick Ultralite in applications.

See the qmlprojectexporter documentation and QmlProject Manual for more information about qmlprojectexporter and QmlProject.

Building and flashing the ModusToolbox project

Follow these steps to build and flash the application from the Eclipse IDE for ModusToolbox:

1. Select the ModusToolbox project.
2. Click Build Application from Quick Panel -> <ModusToolbox project name> to build the project.
3. Click <ModusToolbox project name> Program Application from Quick Panel -> Launches to flash the application to the board.

Debugging

Reading debug messages

By default, Qt Quick Ultralite redirects all the output from qul_printf and Qul::PlatformInterface::log calls to a virtual serial port, which you can access on the host machine using USB. The initial project configuration outputs with a baud rate of 115200 bps.

Make the following changes to change the speed of the UART port:

In Peripheral -> Communication -> Serial Communication Block (SCB) 2 (CYBSP_DEBUG_UART) change the following values:

Make sure the Actual Baud Rate matches the desired baud rate:

You can change the actual baud rate by changing the Clocks -> Dividers -> Peripheral -> Peri 0 -> Peri 0 Clock Group 1 -> 16 bit -> 16 bit Divider 1 (CYBSP_DEBUG_UART_CLK_DIV):

Using a debugger

The following steps show how to debug a project in Eclipse IDE for ModusToolbox:

1. Select the ModusToolbox project.
2. Click <ModusToolbox project name> Debug MultiCore from Quick Panel -> Launches to launch the debugger.

You can limit debugging to cover only the M55 project by selecting the proj_cm55 subproject, followed by <ModusToolbox project name> Debug from Quick Panel -> Launches.

Board-specific information

The currently supported Infineon PSOC Edge targets are listed below. For more information on all the targets supported by Qt Quick Ultralite, see Supported target boards and development hosts.

Tier 2: Verified targets

Resource cache policy

By default, an application's resource data is copied to SDRAM on startup. In order to retain these resources in flash and not load them to RAM on startup, add the following QmlProject option to your qmlproject file:

MCU.Config {
    resourceCachePolicy: "NoCaching"
}

Alternatively, it can be enabled only for individual images like this:

ImageFiles {
    files: [
        "big/button.png"
    ]
    MCU.resourceCachePolicy: "NoCaching"
}