Back to Qt.io
Contact Us Blog Download Qt
このページでは

CMakeマニュアル CMakeの始め方

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.2
export QUL_TOOLS=$HOME/Qt/Tools/QtMCUs
set QUL_ROOT=C:\Qt\QtMCUs\2.12.2
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_ROOTQul_ROOT を、Qt for MCUs SDK のインストールパスに設定します。
-DQul_ROOT=%QUL_ROOT%

注：このCMake変数は 、パッケージ名と一致させる必要があるため、意図的に大文字と小文字が混在しています。

QUL_PLATFORMプラットフォーム名には、ターゲットとするボードとOSを指定する必要があります。これは、選択したボード名とターゲットとするOSを組み合わせたものです。以下の例にあるプラットフォーム名は、ターゲットがベアメタル上のSTM32H750b discoveryであることを示しています。
-DQUL_PLATFORM=stm32h750b-discovery-baremetal

注： 別のボードやOSをターゲットにしたい場合は 、「サポートされているプラットフォーム」を参照してください。

FREERTOS_DIRFreeRTOS のソースディレクトリへの絶対パスです。これは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_DIRQUL_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 ビットに設定します。
-DQUL_COLOR_DEPTH=16

注： この変数が設定されていない場合 、プラットフォームの設定時にはデフォルトの色深度が使用されます。

注： Qt Quick Ultraliteプロジェクトでは 、CMAKE_BUILD_TYPE はデフォルトでMinSizeRel に設定されています。MinSizeRel は、Qt Quick Ultralite に同梱されている事前ビルド済みプラットフォームライブラリに使用されるビルドタイプです。ビルドタイプを変更するには（たとえばRelease に変更する場合など）、-DCMAKE_BUILD_TYPE=Release オプションを指定して CMake を実行してください。詳細については、CMAKE_BUILD_TYPE を参照してください。

CMake マニュアル CMake の入門

特定の Qt ライセンスの下で利用可能です。
詳細はこちらをご覧ください。