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

CMakeマニュアル CMakeの始め方

C

Renesas RAボード用CMakeマニュアル

CMake ビルドツールは、開発プロジェクトのビルドプロセスを簡素化します。Makefile や Visual Studio プロジェクトファイルなどのビルドシステムを自動的に生成します。

CMakeは、独自のドキュメントを備えたサードパーティ製ツールです。このトピックでは、Renesas RAボード向けのアプリケーションを開発する際に、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

ビルド構成

Renesas のRAボード向けアプリケーションを開発する際は、以下のCMake変数を設定してください。

EK-RA8D1用の開発環境のセットアップ

EK-RA8D1用に、以下のCMake変数を設定してください。

変数手順
Qul_ROOT Qul_ROOT をQt for MCUs SDKのインストールパスに設定します。 
-DQul_ROOT=$QUL_ROOT
-DQul_ROOT=%QUL_ROOT%

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

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

同様に、EK-RA8D1 上の FreeRTOS OS上のxml-ph-0000@deepl.internalをターゲットとしていることを示しています。

-DQUL_PLATFORM=ek-ra8d1-freertos

注： 他のボードやOSを対象とする場合は 、「サポートされているプラットフォーム」を参照してください。

CMAKE_TOOLCHAIN_FILE CMAKE_TOOLCHAIN_FILE をArm GCCまたはIARツールチェーンに設定してください。 
-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 ` を使用して、ツールチェーンの保存先を設定してください。 
-DQUL_TARGET_TOOLCHAIN_DIR=/path/to/the/toolchain
-DQUL_TARGET_TOOLCHAIN_DIR=C:\path\to\the\toolchain
QUL_COLOR_DEPTHQUL_COLOR_DEPTH を使用して、プラットフォームがサポートする色深度を設定します。EK-RA8D1 のリファレンスポートは、16bpp の色深度をサポートしています。
-DQUL_COLOR_DEPTH=16

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

QUL_BOARD_SDK_DIRこの変数を、Renesas のフレキシブル・ソフトウェア・パッケージ（FSP）のインストールパスに設定します。

例：

-DQUL_BOARD_SDK_DIR=$QUL_TOOLS/Renesas/fsp-<version>
-DQUL_BOARD_SDK_DIR=%QUL_TOOLS%\Renesas\fsp-<version>
FREERTOS_DIR FreeRTOS のソースコードへの絶対パス。これは ターゲットでのみ必要です。 上のボードに関する詳細については、FreeRTOS FreeRTOSFreeRTOS platformsを参照してください。 
-DFREERTOS_DIR=$QUL_TOOLS/Renesas/FreeRTOS-Kernel<version>
-DFREERTOS_DIR=%QUL_ROOT%/Renesas/FreeRTOS-Kernel<version>
JLINK_PATH JLINK_PATH のCMakeキャッシュエントリを、SEGGER J-Linkがデフォルトの場所にインストールされていない場合は、そのインストールパスに設定してください。

例：

-DJLINK_PATH=/opt/SEGGER/JLink
-DJLINK_PATH=C:\tools\SEGGER\JLink

注意事項

  • 入力値にスペースが含まれていないことを確認してください。
  • J-Linkソフトウェアキットが検出された場合、フラッシュターゲットを作成します。

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

CMake マニュアル CMake の入門

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