概要

このトピックでは、Qt Quick Ultralite でサポートされているInfineon PSOC™ Edge プラットフォームの使用を開始するために必要なすべての情報を提供します。

「Infineon Online Software Delivery Tool」を使用して、Qt for MCUs のデモアプリケーションをフラッシュしてください。Infineon およびQt Groupによって開発されたこれらのアプリケーションは、EVKの高性能なグラフィックス機能を実証するものです。

対応バージョン

Qt Quick Ultraliteは、ModusToolbox Tools Package バージョン3.7.0での動作確認が完了しています。

前提条件のインストール

開発環境をセットアップする前に、前提条件をインストールしてください。

Infineon PSOC Edge E84 評価キット

• Qt Quick Ultralite 2.12.3
• Qt Quick UltraliteInfineon PSOC Edge E84 評価キット プラットフォームパッケージ
• Infineon PSOC Edge E84 評価キット
• Infineon ModusToolbox ソフトウェア
  • ModusToolbox ツールパッケージ 3.7.0
  • ModusToolbox 用 Eclipse IDE 2025.8.0 以降
  • ModusToolbox Edge Protect セキュリティスイート 1.6.1
  • ModusToolbox プログラミングツール 1.7.0
  • GNU Arm GCC 14.2.1 または LLVM Embedded Toolchain for Arm 19.1.5

ModusToolboxプロジェクトの準備

ModusToolboxプロジェクトでQt Quick Ultraliteを実行するには、追加の設定が必要です。空のPSOC Edgeアプリケーションに加えて、以下の設定が必要です。

ライブラリ

ModusToolboxのLibrary Manager 内にあるproj_cm55に対して、以下のライブラリを追加してください：

QSPIの設定

Qt Quick UltraliteでPSRAMを動作させるには、ModusToolboxのQSPI Configurator に以下のQSPI設定を追加してください：

デバイス設定

ModusToolboxで以下の設定を変更してくださいDevice Configurator

グラフィックスを有効にする

Peripherals -> System で、「Graphics 」を有効にし、以下のパラメータ値を変更してください：

I2Cクロック周波数とデータ転送速度の変更

Peripherals -> Communication で、Serial Communication Block (SCB) 0 を有効にし、パラメータを以下の値に変更してください：

「Actual Data Rate 」セクションの値はクロック設定に依存しており、ここでは変更できません。これらの値を変更するには、Clocks -> Dividers -> Peripheral -> Peri 0 -> Peri 0 Clock Group 1 -> 16 bit -> 16 bit Divider 0 内の「16 bit Divider 0 clk (CYBSP_I2C_CONTROLLER_CLK_DIV) 」で以下のパラメータを設定してください：

Qt Quick Ultralite用PSRAMメモリ領域を有効にする

Peripherals -> Communication -> Quad Serial memory Interface (QSPI) 1 -> QSPI 1 Core 0 が有効になっていることを確認してください。Memory -> Memory Regions に移動し、Serial Memory Interface block 1, memory 2 (S70KS1283) を開き、UNALLOCATED 領域の横にある「Plus 」ボタンをクリックして、「Add region 」を選択します。新しい領域に対して、以下のプロパティを設定します：

「OK 」をクリックして、リージョンを作成します。

こちらの手順に従って、Qt Quick Ultralite で PSRAM サポートを有効にしてください。

プロジェクトの設定

プロジェクトがQt Quick Ultraliteに対応するには、以下の変更が必要です：

• proj_cm55 にFreeRTOSConfig.h が存在する場合は、それを削除してください。エクスポートされたQt Quick Ultralite アプリケーションには、Qt Quick Ultralite 用に事前設定されたFreeRTOSConfig.h ファイルが含まれています。
• 追加

  COMPONENTS+=GFXSS

  common.mk に追加してください。

アプリケーションのビルド

環境の設定

アプリケーションをビルドする前に、以下の環境変数を設定してください：

export QUL_ROOT=$HOME/Qt/QtMCUs/2.12.3

set QUL_ROOT=C:\Qt\QtMCUs\2.12.3

「Qt Quick Ultralite」アプリケーションのエクスポート

qmlprojectexporter を使用してアプリケーションコードをエクスポートします：

$QUL_ROOT/bin/qmlprojectexporter \
/path/to/your/project.qmlproject \
--boarddefaults=$QUL_ROOT/platform/boards/infineon/psoc-edge-e84-freertos/cmake/BoardDefaults_16bpp_default.qmlprojectconfig \
--toolchain GNU \
--platform psoc-edge-e84-freertos \
--extend-project /path/to/mtw/your_ModusToolbox_application_project/proj_cm55/Makefile \
--project-type ModusToolbox \
--generate-entrypoint \
--platform-metadata $QUL_ROOT/lib/QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Linux_armgcc-export.json

$QUL_ROOT/bin/qmlprojectexporter \
/path/to/your/project.qmlproject \
--boarddefaults=$QUL_ROOT/platform/boards/infineon/psoc-edge-e84-freertos/cmake/BoardDefaults_16bpp_default.qmlprojectconfig \
--toolchain LLVM \
--platform psoc-edge-e84-freertos \
--extend-project /path/to/mtw/your_ModusToolbox_application_project/proj_cm55/Makefile \
--project-type ModusToolbox \
--generate-entrypoint \
--platform-metadata $QUL_ROOT/lib/QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Linux_llvm-arm-export.json

%QUL_ROOT%\bin\qmlprojectexporter ^
C:\path\to\your\project.qmlproject ^
--boarddefaults=%QUL_ROOT%\platform\boards\infineon\psoc-edge-e84-freertos\cmake\BoardDefaults_16bpp_default.qmlprojectconfig ^
--toolchain GNU ^
--platform psoc-edge-e84-freertos ^
--extend-project C:\path\to\mtw\your_ModusToolbox_application_project\proj_cm55\Makefile ^
--project-type ModusToolbox ^
--generate-entrypoint ^
--platform-metadata %QUL_ROOT%\lib\QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Windows_armgcc-export.json

%QUL_ROOT%\bin\qmlprojectexporter ^
C:\path\to\your\project.qmlproject ^
--boarddefaults=%QUL_ROOT%\platform\boards\infineon\psoc-edge-e84-freertos\cmake\BoardDefaults_16bpp_default.qmlprojectconfig ^
--toolchain LLVM ^
--platform psoc-edge-e84-freertos ^
--extend-project C:\path\to\mtw\your_ModusToolbox_application_project\proj_cm55\Makefile ^
--project-type ModusToolbox ^
--generate-entrypoint ^
--platform-metadata %QUL_ROOT%\lib\QulPlatformTargets_psoc-edge-e84-freertos_16bpp_Windows_llvm-arm-export.json

エクスポートが正常に完了した場合、ModusToolbox プロジェクトの `proj_cm55` 配下に `QtMCUs ` ディレクトリが作成されているはずです。

proj_cm55/Makefile を編集し、## QUL BEGIN ## というコメントの直前にFREERTOS_DIR 変数を追加してください:

FREERTOS_DIR=$(patsubst %/,%,$(CY_GETLIBS_SHARED_PATH))/$(CY_GETLIBS_SHARED_NAME)/freertos/release-v10.6.202/Source

Qt Quick のUltraliteアプリケーションで異なるバリアントのセレクタを使用する場合は、qmlprojectexporter の--selector 引数にそれらを追加してください。たとえば、Qt Quick のUltraliteサーモスタットデモでは、以下のセレクタが使用されています:

--selector normal,small

Infineon のPSOC Edgeプラットフォームのデフォルト設定では、Release 構成でビルドされたQt Quick Ultraliteライブラリがエクスポートされます。別のビルド構成（Debug など）でQt Quick Ultraliteライブラリをビルドした場合は、qmlprojectexporter コマンドに--qul-build-type引数を追加して、ビルドタイプを上書きしてください:

--qul-build-type Debug

Qt Quick Ultraliteに同梱されているいくつかのサンプルでは、アプリケーションコード内にmain() 関数が含まれていません。main() 関数を追加する場合を除き、これらのサンプルをエクスポートする際には--generate-entrypoint引数を使用してください。Qt Quick Ultraliteを初期化するmain() 関数の記述に関する詳細については、「アプリケーションでのQt Quick Ultraliteの実行」を参照してください。

qmlprojectexporter およびQmlProjectの詳細については、qmlprojectexporterのドキュメントおよび『QmlProjectマニュアル』を参照してください。

ModusToolbox プロジェクトのビルドとフラッシュ

Eclipse IDE for ModusToolbox からアプリケーションをビルドおよびフラッシュするには、以下の手順に従ってください。

1. ModusToolboxプロジェクトを選択します。
2. Quick Panel -> <ModusToolbox project name> から「Build Application 」をクリックして、プロジェクトをビルドします。
3. Quick Panel -> Launches から「<ModusToolbox project name> Program Application 」をクリックし、アプリケーションをボードに書き込みます。

デバッグ

デバッグメッセージの読み取り

デフォルトでは、Qt Quick Ultralite は、qul_printf およびQul::PlatformInterface::log 呼び出しからのすべての出力を仮想シリアルポートにリダイレクトします。この仮想シリアルポートには、USB を使用してホストマシンからアクセスできます。初期のプロジェクト設定では、出力ボーレートは 115200 bps です。

UARTポートの速度を変更するには、以下の変更を行ってください。

Peripheral -> Communication -> Serial Communication Block (SCB) 2 （CYBSP_DEBUG_UART ）内で、以下の値を変更してください：

Actual Baud Rate が希望のボーレートと一致していることを確認してください：

Clocks -> Dividers -> Peripheral -> Peri 0 -> Peri 0 Clock Group 1 -> 16 bit -> 16 bit Divider 1 （CYBSP_DEBUG_UART_CLK_DIV ）を変更することで、実際のボーレートを変更できます：

デバッガの使用

以下の手順は、Eclipse IDE for ModusToolbox でプロジェクトをデバッグする方法を示しています:

1. ModusToolbox プロジェクトを選択します。
2. Quick Panel -> Launches から「<ModusToolbox project name> Debug MultiCore 」をクリックして、デバッガーを起動します。

proj_cm55サブプロジェクトを選択し、続いて [Quick Panel -> Launches] から [<ModusToolbox project name> Debug ] を選択することで、デバッグの対象を M55 プロジェクトのみに限定することができます。

ボード固有の情報

現在サポートされているInfineon PSOC Edgeターゲットを以下に示します。Qt Quick Ultraliteでサポートされているすべてのターゲットの詳細については、「サポート対象のターゲットボードおよび開発ホスト」を参照してください。

Tier 2: 検証済みターゲット

リソースキャッシュポリシー

デフォルトでは、アプリケーションのリソースデータは起動時に SDRAM にコピーされます。これらのリソースをフラッシュメモリに保持し、起動時に RAM に読み込まないようにするには、qmlproject ファイルに次の QmlProject オプションを追加してください:

MCU.Config {
    resourceCachePolicy: "NoCaching"
}

あるいは、次のように個々のイメージに対してのみ有効にすることもできます:

ImageFiles {
    files: [
        "big/button.png"
    ]
    MCU.resourceCachePolicy: "NoCaching"
}