C
開発ホストのセットアップ
Qt for MCUs はLinuxとWindowsのホスト環境をサポートしています。以下のサブセクションでは、これらのホスト・プラットフォームのセットアップ情報を提供します。
前提条件
Qt for MCUsQt アカウントページからダウンロードできるQt Online Installer を使用してQt for MCUs をインストールできます。
- CMake 3.21.1 またはそれ以降 (Qt Online Installer を使ってインストールできます)
- GNU Make
デスクトップ上でアプリケーションをテストするためにデスクトップ・ターゲットをビルドする場合:
- GNU Compiler Collection v7.4.0以降。
- 新しいPerl互換正規表現ライブラリ - 16ビット (libpcre2-16-0)
これらの前提条件はすべて、以下のコマンドを使用してインストールできます:
sudo apt update sudo apt install build-essential cmake libpcre2-16-0
- CMake 3.21.1以降(Qt Online Installer を使ってインストールできます。)
デスクトップ上でアプリケーションをテストするためにデスクトップ・ターゲットをビルドする場合:
注意: Linuxでは、g++-12 を使用せずにgcc-12 をインストールした場合、インクルード・パスにGCCヘッダがあると、qmlinterfacegenerator を実行したときにC++ヘッダ('cstdint' file not found )が欠落します。この問題を解決するには、gcc-12 を削除するか、g++-12 をインストールしてください。
Qt Creator セットアップ
以下の手順は、LinuxとWindowsプラットフォームでQt Creator をセットアップするのに役立ちます。
Qt Creator IDEを使用してMCU向けに開発するには、MCUプラグインが必要です。Qt Online Installer 、Qt for MCUs SDKをインストールすると、デフォルトでMCUプラグインが有効になります。
MCU上でアプリケーションをビルドして実行するには、キットを作成する必要があります:
- Edit > Preferences > Devices > MCU を選択してください。
注: MCU タブが表示されない場合は、Help > About Plugins を選択してMcuSupportプラグインを有効にし、Qt Creator を再起動して変更を適用します。
- まだ設定されていない場合は、Qt for MCUs のインストール・ディレクトリへのパスを指定します。

- を選択します。 Target supported by the Qt for MCUs SDK.例えば Qt for MCUs 2.12.0 - Desktop 32bpp.
- Requirements セクションで、プラットフォーム固有の要件が満たされていることを確認します。
- キットを自動的に作成するには、Automatically create kits for all available targets on start を選択します。
注: Create Kit およびUpdate Kit を使用して、手動でキットを作成/更新することもできます。
- 自動的にキットを作成する場合は、Apply を選択し、Qt Creator を再起動します。
コマンドラインの設定
QUL_ROOT およびQUL_TOOLS は、以下のコマンドラインの例では環境変数として設定されているかのように使用されています。例えば
export QUL_ROOT=$HOME/Qt/QtMCUs/2.12.0 export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\2.12.0 set QUL_TOOLS=C:\Qt\Tools\QtMCUs
プロジェクトのセットアップ
プロジェクトを設定するには、コマンドプロンプトからCMakeを実行します。プロジェクト・ディレクトリに移動し、%QUL_ROOT%\demos\thermo デモを例として、以下のコマンドを入力します。
cd $QUL_ROOT/demos/thermo mkdir build_linuxqt cd build_linuxqt cmake .. -DQUL_PLATFORM=Qt -DQul_ROOT=$QUL_ROOT
cd %QUL_ROOT%\demos\thermo mkdir build_winqt cd build_winqt cmake .. -DQUL_PLATFORM=Qt -DQUL_COMPILER_NAME=msvc -DQul_ROOT=%QUL_ROOT%
注: MSVC (msvc) と MinGW (gnu) のツールチェーンは、QUL_COMPILER_NAME CMake オプションを使用して選択できます。
MinGW ツールチェーンを使用するためにQUL_COMPILER_NAME=gnu CMake オプションを渡す場合は、以下に示すように、Ninja またはMinGW Makefiles ジェネレーターを明示的に選択してください。Visual Studioがインストールされている場合、CMakeはデフォルトでVisual Studioジェネレーターを使用するためです。
cmake .. -G "Ninja" -DQUL_PLATFORM=Qt -DQUL_COMPILER_NAME=gnu -DQul_ROOT=%QUL_ROOT%
これらのコマンドは、前提条件をチェックし、プロジェクトを構成します。
ビルド
ビルドするには、以下のコマンドを使用します:
cmake --build . --target thermo_big --config Release
注意: Qtプラットフォーム用のビルド済みライブラリは、DebugとReleaseコンフィギュレーションでのみ利用可能です。Windowsでは、他のビルドタイプではリンクエラーが発生する可能性があります。
アプリケーションの実行
サーモスタット・アプリケーションをビルドしたら、実行してみましょう:
デモはWindows用のQtアプリケーションとしてビルドされています。./thermo_big
thermo デモは Windows 用の Qt アプリケーションとしてビルドされているため、実行するにはPATH にある Qt ランタイム・ライブラリが必要です。Qt for MCUs はこれらの必要な Qt ライブラリをすべて提供しているため、PATH に追加する必要があります。
set PATH=%QUL_ROOT%\lib\msvc;%PATH% set QT_QPA_PLATFORM_PLUGIN_PATH=%QUL_ROOT%\lib\msvc
注意: MinGWツールチェーン用のQtランタイムライブラリは、QUL_ROOT\lib\gnu にインストールされています。
PATHに必要なライブラリが追加されたら、アプリケーションを実行します:
%QUL_ROOT%\demos\thermo\build_winqt>Release\thermo_big.exe
注: MinGWツールチェーンを使用している場合は、ビルドディレクトリに実行ファイルがあります。
サーモスタット・アプリケーションのウィンドウは次のようになります:

Windows上のVisual Studioのセットアップ
プロジェクトのセットアップ
プロジェクトを設定するには、コマンドライン設定のセクションの指示に従ってください。
Visual Studioでソリューションを開く
Microsoft Visual Studio を使用してプロジェクトを操作するには、CMake によって作成されたソリューションをbuild_winqtフォルダから開きます。

ソリューションのツリー構造が表示されます。

これはWindows Qtプロジェクトなので、実行するにはQtのランタイムライブラリが必要です。ビルドされたアプリケーションでこれらを利用できるようにするには、ランタイム環境を設定する必要があります。そのためには
- プロジェクトを選択したまま、または右クリックして、コンテキストメニューからProperties を選択します。
- General > Debugging を選択します。
- Environment に、Qt ライブラリを含むディレクトリを指す変数
PATHとQT_QPA_PLATFORM_PLUGIN_PATHを追加します。Qt ライブラリはQUL_ROOTのlib\msvcディレクトリにインストールされます。例えばPATH=%QUL_ROOT%\lib\msvc QT_QPA_PLATFORM_PLUGIN_PATH=%QUL_ROOT%\lib\msvc
このステップの後(%QUL_ROOT%はC:∕QtMCUs∕に設定されたと仮定)、プロジェク トのプロパティ・ウィンドウは次のようになります:

ビルドと実行
変更を適用してアプリケーションをビルドし、実行します。画面にサーモスタットのデモが表示されるはずです。