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.0 export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\2.12.0 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 ディスカバリーであることを示しています。-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 | QUL_TARGET_TOOLCHAIN_DIR CMake キャッシュエントリーを使用して、使用するツールチェーンの場所を指定する必要があります。-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-bitに設定する。-DQUL_COLOR_DEPTH=16 注意: この変数が設定されていない場合、プラットフォームの設定中にデフォルトの色深度が使用されます。 |
注: Qt Quick Ultraliteプロジェクトでは、CMAKE_BUILD_TYPE はデフォルトでMinSizeRel に設定されています。MinSizeRel は、Qt Quick Ultraliteに同梱されているビルド済みプラットフォーム・ライブラリに使用されるビルドタイプです。ビルドタイプを変更するには（例えばRelease に）、-DCMAKE_BUILD_TYPE=Release オプションを付けて CMake を起動します。詳細については、CMAKE_BUILD_TYPEを参照してください。
