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.

Setting up development environment

Before you start, ensure that the following prerequisites for the Windows development host are met:

  • MSVC compiler v19.16 (Visual Studio 2017 15.9.9 or newer)
  • CMake v3.13 or newer (you can install it using the Qt Online installer)

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.

Enable Qt Creator plugins

To enable development for MCU, ensure that the appropriate plugins are enabled:

  1. Select Help > About Plugins and choose Bare Metal and MCU Support (experimental) plugins from the list.
  2. Restart Qt Creator to apply changes

Create a kit for Qt for MCUs

To build and run your application for MCU, you must create a kit in Qt Creator:

  1. Select Tools > Options > Devices > MCU
  2. Select Qt for MCUs - Desktop 32bpp as the target.
  3. If not already set, provide the path to the Qt for MCUs installation directory.
  4. Click Apply.

Creating the project

Now, assuming that your development environment is ready, the following list guides you through the process:

  1. Open Qt Creator and select File > New file or Project.
  2. Choose the Application (Qt for MCU) > MCU Support template.

  3. Select Choose and give a Name to the project.

    \eHelloMCU for example

  4. Select Next and follow the wizard to create the project.

After you select Finish on the project wizard, your project explorer looks like this:

Notice (1) that the wizard creates the necessary files, including the HelloMCU.qml file. This QML file (2) defines a Rectangle containing the Text item with the text, "Hello World".

Modify the Text item

The Text item's font.pixelSize is set to 14 by default. Try increasing the font size to 18 and also color to 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:

pragma main;
import QtQuick 2.0

Rectangle {
    width: 480
    height: 272
    color: "black"
    Text {
        anchors.centerIn: parent
        color: "teal"
        text: "Hello World!"
        font.pixelSize: 18

Now, run the application to see how it looks.

Run on a target hardware

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.