GUI (Qt6)

As of Dec 12, 2022

Install QT Creator

Download Qt: Get Qt Online Installer

Create a Qt account if you don't have one. We are using the Community (Open Source) version of QT. It is free for non-commercial use.

If you are upgrading from QT5, you can just open the MaintenanceTool, in the Qt Folder, or Start Menu. Add the new checked items below.

When you will get to Select Components choose the following options. You can come back and add / remove items later using their maintenance tool if you missed one or added too many.

Under Select Categories check Latest supported releases and click Filter

Under Qt 6.4.1 choose MinGW 11.2.0 64Bit and Qt Serial Port

Under Developer and Designer Tools, add MinGW 11.2.0 64-bit

Complete the installation wizard.

Open Qt Creator and Load the Project File

Choose File -> Open File or Project

After cloning the Git repository using these instruction: Firmware Setup.

Choose

/src/gui/HeadTracker.pro

When you will open it for the first time, it will ask how do you want to configure it. If you have multiple choices be sure to check the Desktop Qt 6.4.1 MinGW 64-bit option and click Configure Project

If you already had the project compiling on Qt5, just add the new kit from Projects

In Qt set the Release or Debug mode. You will probably want Debug.

Click the Play Button . It should compile and run the project. Use the Debug Play Button if you want to connect it to the debugger, set breakpoints and monitor expressions.

Other Notes

Qt uses a Shadow build by default. Which means it builds everything in a separate folder. You need to add an item into that folder for the firmware list to work. I added it before a release.

Default shadow build folder

gui/build-HeadTracker-Desktop_Qt_6_4_1_MinGW_64_bit-Debug

There is no background since it's run from the shadow build folder. Copy stylesheet.css and Background.svg from gui/src/css into the output folder. Which when building in debug mode will be in gui/build-HeadTracker-Desktop_Qt_6_4_1_MinGW_64_bit-Debug/debug.

You need to create a sources.ini (The firmware sources). The below file will allow you to see all the current online firmware in the GUI list. You can also add a localfirmware.ini if you want.

sources.ini

[General]
Online v2.0x=https://raw.githubusercontent.com/dlktdr/HeadTracker/master/firmware/bin/firmware20.ini
Online v0.9x=https://raw.githubusercontent.com/dlktdr/HeadTracker/master/firmware/bin/firmware09.ini
Online v0.8x=https://raw.githubusercontent.com/dlktdr/HeadTracker/master/firmware/bin/firmware08.ini
Online v0.7x=https://raw.githubusercontent.com/dlktdr/HeadTracker/master/firmware/bin/firmware04.ini
Shipped=file://localfirmware.ini

localfirmware.ini

[Arduino%20Nano%20BLE%2033%20-%20Version%200.9]
Filename=file://BLE v0.9.bin
Version=0.9
Notes=Visit https://github.com/dlktdr/headtracker

[Arduino%20Nano%20BLE%2033%20-%20Version%201.0%20ONLINE]
Filename=https://raw.githubusercontent.com/dlktdr/HeadTracker/master/firmware/bin/BLE v0.9.bin
Version=0.9
Notes=Visit https://github.com/dlktdr/headtracker

[Debugger 1.0 RC1]
Filename=file://Y:/Programming/HeadTracker/HeadTracker - CombineFW/firmware/src/Nano33BLE/.pio/build/HeadTracker_Nano33BLE/firmware.bin
Version=1.0
Notes=Combine FW

[Debugger 0.9]
Filename=file://Y:/Programming/HeadTracker/HeadTracker - Master/firmware/src/Nano33BLE/.pio/build/HeadTracker_Nano33BLE/firmware.bin
Version=0.93
Notes=Master FW

[Para Master v1.4]
Filename=file://Y:/Programming/HeadTracker/Para_Master/para_master/.pio/build/Para_Master/firmware.bin
Version=1.4
Notes=Master FW

[Zephyr 2.0 BIN]
Filename=file://Y:/Programming/HeadTracker/HeadTracker_Zypher/.pio/build/Head_Tracker_Zypher/firmware.bin
Version=2.0
Notes=Zephyr Master

You can customize this file so it will directly grab from you firmware build folder, so you can just click upload firmware to use the one just compiled. See the last section on how to do this.