C
STM ボード用CMakeマニュアル
CMake ビルドツールは、開発プロジェクトのビルドプロセスを簡素化します。Makefile や Visual Studio プロジェクトファイルなどのビルドシステムを自動的に生成します。
CMakeは、独自のドキュメントを備えたサードパーティ製ツールです。このトピックでは、STM ボード向けのアプリケーションを開発する際、Qt Quick UltraliteでCMakeを使用する方法について説明します。
QUL_ROOT 以下のコマンドラインの例では、QUL_TOOLS および が、あたかも環境変数として設定されているかのように使用されています。例：
export QUL_ROOT=$HOME/Qt/QtMCUs/2.12.3 export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\2.12.3 set QUL_TOOLS=C:\Qt\Tools\QtMCUs
コマンドラインの設定
コマンドラインから作業を開始するには、System PATH に以下の変更を加えてください。
- STM32CubeProgがデフォルトの場所にインストールされていない場合は、
System PATHにインストールディレクトリを追加してください。 ST-LINK_gdbserver.exeディレクトリをSystem PATH<STM32_CUBE_IDE_INSTALL_PATH>\stm32cubeide_1.3.0\plugins\com.st.stm32cube.ide.mcu.externaltools.stlink-gdb-server.win32_1.3.0.202002181050\tools\bin
ここで、
<STM32_CUBE_IDE_INSTALL_PATH>は Cube IDE のインストールパスです。注：STM32CubeIDEは オプションであり、オンチップデバッグを行う場合にのみ必要です。
ビルド設定
STM ボード向けのアプリケーションを開発する際は、以下のCMake変数を設定してください。
| 変数 | 値 |
|---|---|
| Qul_ROOT | Qul_ROOT を、Qt for MCUs SDK のインストールパスに設定します。-DQul_ROOT=%QUL_ROOT% 注: この CMake 変数は、パッケージ名と一致させる必要があるため、意図的に大文字と小文字が混在しています。 |
| QUL_PLATFORM | プラットフォーム名には、ターゲットとするボードとOSを指定する必要があります。これは、選択したボード名とターゲットとするOSを組み合わせたものです。以下の例にあるプラットフォーム名は、ターゲットがベアメタル上のSTM32H750b discoveryであることを示しています。-DQUL_PLATFORM=stm32h750b-discovery-baremetal 注: 別のボードやOSをターゲットにしたい場合は 、「サポートされているプラットフォーム」を参照してください。 |
FREERTOS_DIR | FreeRTOS のソースディレクトリへの絶対パスです。これはFreeRTOS ターゲットでのみ必要です。FreeRTOS 上のボードに関する詳細については、「FreeRTOS プラットフォーム」を参照してください。-DFREERTOS_DIR=< FreeRTOS directory path > |
| CMAKE_TOOLCHAIN_FILE | たとえば、Arm GCC ツールチェーンの設定ファイルに設定します。
-DCMAKE_TOOLCHAIN_FILE=$QUL_ROOT/lib/cmake/Qul/toolchain/armgcc.cmake -DCMAKE_TOOLCHAIN_FILE=%QUL_ROOT%\lib\cmake\Qul\toolchain\armgcc.cmake |
| QUL_TARGET_TOOLCHAIN_DIR | 使用するツールチェーンの場所を指定するには、CMakeキャッシュエントリ「QUL_TARGET_TOOLCHAIN_DIR」を使用する必要があります。-DQUL_TARGET_TOOLCHAIN_DIR=c:\path\to\the\toolchain |
| QUL_BOARD_SDK_DIR | 例えば、STM32F769I SDKのインストールパスに設定します。-DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\STM\STM32Cube_FW_F7_<version> |
| QUL_COLOR_DEPTH | 選択したプラットフォームでサポートされている色深度。たとえば、16 ビットに設定します。-DQUL_COLOR_DEPTH=16 注： この変数が設定されていない場合 、プラットフォームの設定時にはデフォルトの色深度が使用されます。 |
注： Qt Quick Ultraliteプロジェクトでは 、CMAKE_BUILD_TYPE はデフォルトでMinSizeRel に設定されています。MinSizeRel は、Qt Quick Ultralite に同梱されている事前ビルド済みプラットフォームライブラリに使用されるビルドタイプです。ビルドタイプを変更するには（たとえばRelease に変更する場合など）、-DCMAKE_BUILD_TYPE=Release オプションを指定して CMake を実行してください。詳細については、CMAKE_BUILD_TYPE を参照してください。
特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。
