Take the following steps to prepare a Raspberry Pi 3 for Boot to Qt.

Note: It is important that you repeat the steps in this section after you update Qt for Device Creation.

The image containing Boot to Qt stack for Raspberry Pi 3 is included in the SDK, ready to be copied to an SD card.

Preparing an SD Card

An SD card of at least 1 GB capacity is sufficient.

Plug in the SD card or reader to the development host, and use the following command on Linux to find out its device name:

lsblk -d

Removable devices such as SD cards have the value '1' in the RM column.

Typical device names for SD cards include sdb and mmcblk0. The full device path is /dev/ followed by the name.

On Windows, use the following command to get the SD cards device name:

wmic logicaldisk where "drivetype=2 and access=0" get deviceid, volumename

Warning: Make sure to select the correct device, because selecting the wrong one can result in a wiped hard drive.

Installing the Boot to Qt Image

Install Using the Flashing Wizard

Qt for Device Creation includes an easy to use application for setting up a supported device for Boot to Qt. In Qt Creator, select Tools > Flash Boot to Qt Device and follow the step-by-step instructions.

On Linux, you can alternatively install the image from the command line using the instructions below.

Install from the Command Line

To write the image to the SD card, ensure that no partitions on the SD card are mounted:

umount /dev/<device_name>

Then, enter the following command to deploy the image:

cd <INSTALL_DIR>
sudo dd bs=4k if=5.8/Boot2Qt/raspberrypi3/images/b2qt-embedded-qt5-image-raspberrypi3.img of=/dev/<device_name>

After the image has been deployed, insert the SD card, power on the device and check that the Boot to Qt welcome screen and/or demo appear.

Configuring a Device Kit in Qt Creator

After you have prepared the hardware, you must set up the development tools in Qt Creator for your device. Connect your device to the network via an Ethernet cable and launch Qt Creator. In Qt Creator:

1. Select Tools > Options > Devices > Add.
2. Select Boot2Qt Device > Start Wizard.
3. Enter the device name and network address (IPv4). You can check the device address in the Launcher Settings when the device is running the Boot to Qt demo.
4. Select Finish.

You also have to configure the correct device to be used for each build and run kit:

1. Select Tools > Options > Build & Run > Kits.
2. Select one of the predefined kits starting with Boot to Qt... that matches the type of your device.
3. Select the correct device in the Device field.
4. Select OK.

You are now ready to start developing for your device. For more information, see Building and Running an Example.