Command-line Setup for STM Boards
Assuming that the prerequisites are installed, the following subsections provide instructions to set up your environment using the command line.
To get started from the command line, make the following changes to
- Add STM32CubeProg install directory to
System PATHif it is not installed in the default location.
ST-LINK_gdbserver.exedirectory to your
<STM32_CUBE_IDE_INSTALL_PATH>is the Cube IDE install path.
Note: STM32CubeIDE is optional and required only for on-chip debugging purposes.
Note: This page uses
QUL_TOOLS in command line examples as if they were set as environment variables. They could be set for example:
export QUL_ROOT=$HOME/Qt/QtMCUs/2.0.0 export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\2.0.0 set QUL_TOOLS=C:\Qt\Tools\QtMCUs
Configure the following CMake variables. For more information, see the CMake Manual.
|Qul_ROOT||Set the |
Note: This CMake variable is intentionally mixed-case since it needs to match the package name.
|QUL_PLATFORM||The platform must be set to the corresponding board and the OS you plan to use. For example, set the variable for |
|CMAKE_TOOLCHAIN_FILE||For example, set it to the Arm GCC toolchain configuration file.|
|QUL_TARGET_TOOLCHAIN_DIR||QUL_TARGET_TOOLCHAIN_DIR cmake cache entry needs to be used to provide the location of the used toolchain.|
|QUL_BOARD_SDK_DIR||For example, set it to the STM32F769I SDK install path|
|QUL_COLOR_DEPTH||The color depth supported by the platform you have chosen. For example, set it to 16-bit.|
Note: If this variable is not set, default color depth is used while configuring for the platform.
Note: in a Qt Quick Ultralite project the
CMAKE_BUILD_TYPE CMake argument is by default set to
MinSizeRel is the build type used for the pre-built platform libraries shipped with Qt Quick Ultralite. If you want to change the build type (e.g. to
Release) you can do so by invoking cmake with
-DCMAKE_BUILD_TYPE=Release. Please refer to this page for more information.
The following command builds the
minimal example for the
STM32F469I discovery board:
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_9 -DQUL_BOARD_SDK_DIR=$QUL_TOOLS/STM/STM32Cube_FW_F4_V1.25.0 -DQUL_PLATFORM=STM32F469I-DISCOVERY-baremetal 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_9 -DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\STM\STM32Cube_FW_F4_V1.25.0 -DQUL_PLATFORM=STM32F469I-DISCOVERY-baremetal 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 other STM boards that are supported by Qt Quick Ultralite.
Available under certain Qt licenses.
Find out more.