C

Command-line Setup for NXP Boards

Assuming that the prerequisites are installed, the following subsections provide instructions to set up your environment using the command line.

This page uses QUL_ROOT and QUL_TOOLS in command line examples as if they were set as environment variables. For example:

export QUL_ROOT=$HOME/Qt/QtMCUs/dev
export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\dev
set QUL_TOOLS=C:\Qt\Tools\QtMCUs

Build configuration

Configure the following CMake variables. For more information, see the CMake Manual.

VariableValue
Qul_ROOTSet the Qul_ROOT to the Qt for MCUs SDK install path.
-DQul_ROOT=%QUL_ROOT%

Note: This CMake variable is intentionally mixed-case since it needs to match the package name.

QUL_PLATFORMThe platform must be set to the corresponding board and the OS you plan to use. For example, set the variable for MIMXRT1050-EVK on baremetal.
-DQUL_PLATFORM=mimxrt1050-evk-baremetal
CMAKE_TOOLCHAIN_FILEFor example, set it to the Arm GCC toolchain configuration file.
-DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake
-DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake
QUL_TARGET_TOOLCHAIN_DIRQUL_TARGET_TOOLCHAIN_DIR cmake cache entry needs to be used to provide the location of the used toolchain.
-DQUL_TARGET_TOOLCHAIN_DIR=C:\path\to\the\toolchain
QUL_BOARD_SDK_DIRFor example, set it to the MIMXRT1050-EVKB SDK install path
-DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\NXP\SDK_<version>_EVKB-IMXRT1050
QUL_COLOR_DEPTHThe color depth supported by the platform you have chosen. For example, set it to 16-bit.
-DQUL_COLOR_DEPTH=16

Note: If this variable is not set, default color depth is used while configuring for the platform.

MCUXPRESSO_IDE_PATHSet the MCUXPRESSO_IDE_PATH CMake cache entry to your MCUXpresso IDE installation path.

Flash targets are created if the NXP_Flash_tool is found under MCUXPRESSO_IDE_PATH.

Note: In a Qt Quick Ultralite project, CMAKE_BUILD_TYPE is set to MinSizeRel by default. MinSizeRel is the build type used for the prebuilt platform libraries shipped with Qt Quick Ultralite. To change the build type (to Release for example), invoke CMake with the -DCMAKE_BUILD_TYPE=Release option. For more information, see CMAKE_BUILD_TYPE.

Building applications with prebuilt Qt Quick Ultralite libraries

The following example commands are used to build the minimal example for MIMXRT1050-EVK:

cd $QUL_ROOT/examples/minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=$QUL_ROOT -DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake -DQUL_TARGET_TOOLCHAIN_DIR=$QUL_TOOLS/arm_gcc_10 -DQUL_BOARD_SDK_DIR=$QUL_TOOLS/NXP/SDK_2.12.0_EVKB-IMXRT1050 -DQUL_PLATFORM=MIMXRT1050-EVK-baremetal -DMCUXPRESSO_IDE_PATH=/path/to/the/MCUXpressoIDE
cmake --build .
cd %QUL_ROOT%\examples\minimal
mkdir build
cd build
cmake .. -G "Ninja" -DCMAKE_BUILD_TYPE=MinSizeRel -DQul_ROOT=%QUL_ROOT% -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake -DQUL_TARGET_TOOLCHAIN_DIR=%QUL_TOOLS%\arm_gcc_10 -DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\NXP\SDK_2.12.0_EVKB-IMXRT1050 -DQUL_PLATFORM=MIMXRT1050-EVK-baremetal -DMCUXPRESSO_IDE_PATH=C:\path\to\the\MCUXpressoIDE
cmake --build .

Once you have successfully built the minimal example application, use the following command to flash it:

cmake --build . --target flash_minimal

The same procedure applies to any other application.

Available under certain Qt licenses.
Find out more.