Quick Starter Guide
This topic provides instructions to develop the classic hello world application. It lets you quickly explore the Qt for MCUs offering by creating this simple application. It uses the Qt Creator's new project template that is designed specifically for the MCU platforms.
Before you start, ensure that the following prerequisites for the Windows development host are met:
- MSVC++ compiler v14.16 (Visual Studio 2017 15.9) up to v14.26 (Visual Studio 2019 16.6)
- CMake 3.15 or newer (you can install it using the Qt Online installer)
- Clang 8.0.0 or newer (it's installed as part of Qt Creator)
Note: Add the Clang binary directory to your system
PATH. If you installed Qt Creator using the Qt online installer, clang binaries are installed under
<QT_INSTALL_PATH>\Tools\QtCreator\bin\clang\bin. This step is not needed when using Qt Creator.
In addition, install Qt for MCUs using the Qt online installer that is available for download on Qt account.
Now that the prerequisites are installed, follow the instructions in these sections to set up Qt Creator.
To develop for MCUs using the Qt Creator IDE, the MCU plugin is required. The Qt online installer enables it by default when you install the Qt for MCUs SDK.
To enable or disable the plugin, follow these instructions:
- Select Help > About Plugins and choose the MCU Support plugin from the list.
- Restart Qt Creator to apply changes
To build and run your application on MCUs, you must create a kit:
- Select Tools > Options > Devices > MCU
- If not already set, provide the path to the Qt for MCUs installation directory.
- Select a Target supported by the Qt for MCUs SDK. For example, Qt for MCUs 1.5 - Desktop.
- In the Requirements section, ensure that the platform-specific requirements are met.
- Select Create Kit to create a kit for the selected target. if a kit already exists, remove it first using Remove Kit.
- Click Apply.
Now, assuming that your development environment is ready, the following list guides you through the process:
- Open Qt Creator and select File > New file or Project.
- Choose the Application (Qt for MCU) > MCU Support template.
- Select Choose and give a Name to the project.
- Select Next and follow the wizard to create the project.
After you select Finish on the project wizard, your project explorer looks like this:
The Text item's
font.pixelSize is set to
14 by default. Try increasing the font size to
18 and also
teal for example. You could also set a background color, by setting the
color property of the Rectangle. This is how the QML file looks after you have made these changes:
Now, run the application to see how it looks.
The application is configured to run on the desktop, but you can also retarget it run on a NXP hardware for example. Before you do so, ensure that you have necessary setup to run on any of the supported hardware platforms. To get started on any of these platforms, follow instructions in these topics:
In addition, configure Qt Creator to build and run applications on these targets. For more details, refer to Qt Creator manual.
Once the setup is ready, select Run or use the Ctrl + R keyboard shortcut to see your application running on the target.
Available under certain Qt licenses.
Find out more.