ドライバ
[Driver]セクションでは、TouchGFX ALのさまざまな役割に対応するドライバを開発者が選択できます。
アプリケーション・ティック・ソース
アプリケーションのアプリケーション・ティック・ソースは、アプリケーションを前進させる方法を定義します。開発者は以下のオプションを使用できます。
- LTDC - [Display]グループでインタフェースとして[LTDC]を選択した場合、[Application Tick Source]を[LTDC]にできます。つまり、TouchGFX Generatorが
TouchGFXGeneratedHALクラスにドライバ関数(LTDC割込みハンドラ)を生成し、それがOSWrappers::signalVSync()を呼び出してアプリケーションを前進させます。 - Custom and FMC - この場合、
OSWrappers::signalVSync()を繰り返し呼び出すことでアプリケーションを前進させるハンドラを、開発者が実装する必要があります。
Further reading
DMA2Dアクセラレータ(Chrom-ART)
DMA2Dグラフィック・アクセラレーションに関して、開発者には次の3つのオプションがあります。
- No - アプリケーションはCPUのみを使用して描画します。
- Yes - アプリケーションは可能であればChrom-ARTチップを使用してピクセルの移動やブレンドを行い、CPUサイクルを解放します。 TouchGFX Generatorによってドライバが生成されるので、開発者によるアクションは必要ありません。
- Custom - TouchGFX Generatorは汎用のTouchGFX DMAクラスを生成します。これはメンバー関数を含むTouchGFX EngineのDMAインタフェースから継承するもので、カスタム・グラフィック・アクセラレータの場合、開発者はこれを実装する必要があります。
TouchGFX GeneratorでDMA2Dアクセラレータを選択できるようにするには、STM32CubeMXの[Multimedia]カテゴリでこれを有効にする必要があります。
最適な性能を得るため、DMA2D v3を実装したプラットフォーム(STM32H5Fx/H5Exシリーズなど)ではコマンドリスト・モードでこれをアクティブ化する必要があります。
Further reading
TouchGFX Generatorによって生成されるDMA2D(Chrom-ART)ドライバは、TransferCompleteInterruptの受信方法として次の2つをサポートしています。
- STM32Cube HALドライバを使用して、dma2dハンドラにコールバック関数
hdma2d.XferCpltCallbackを登録する。 DMA2D_IRQHandler()割込みハンドラを直接使用する。
この2つの方法を切り替えるには、DMA2D IP用のSTM32CubeMXのNVIC設定で、DMA2Dグローバル割込みを有効化 / 無効化します。
グローバル割込みを有効化するとオプション1のコードが生成され、グローバル割込みを無効化するとオプション2のコードが生成されます。
Note
GFXPAND Decoder (Chrom-DEC)
GFXPAND (Chrom-DEC) is a compressed graphics decoder capable of accelerating the decompression of L8 RLE and RGB (QOI and QOI565) compressed images. It works together with the DMA2D (Chrom-ART) accelerator to draw compressed images to the framebuffer, freeing up CPU cycles. これは、RGB565、RGB888、ARGB8888フォーマットのフレームバッファをサポートします。 GFXPAND is currently available on STM32U3A6 MCUs.
The developer has two options when it comes to GFXPAND decoding:
- No - Compressed images are decompressed using only the CPU.
- Yes - The application uses the Chrom-DEC decoder to decompress L8 RLE and RGB compressed images when they are drawn. TouchGFX Generatorによってドライバが生成されるので、開発者によるアクションは必要ありません。
To be able to select Use GFXPAND decoder (Chrom-DEC) in TouchGFX Generator, the following conditions must be met:
- The GFXPAND peripheral must be activated in STM32CubeMX.
- The framebuffer pixel format must be RGB565, RGB888, or ARGB8888.
Note
The GFXPAND driver generated by TouchGFX Generator uses two DMA channels to transfer data to and from the GFXPAND. A DMA channel must be configured for both the GFXPAND input and the GFXPAND output in the GFXPAND configuration in STM32CubeMX. The interrupt for the DMA channel used for the GFXPAND output must be enabled in the NVIC settings.
Further reading
When GFXPAND is enabled, the setting Scratch Buffer Size appears in the TouchGFX Generator:
The setting Scratch Buffer Size sets the size in bytes of each of the two scratch buffers used by the GFXPAND driver. The default size is 960 bytes and the minimum size is 256 bytes. The scratch buffers are used when the decompressed pixels must be alpha blended and/or have unaligned destination addresses. The pixels in the scratch buffer are processed by DMA2D before being written to the framebuffer while the other buffer is filled by the GFXPAND. Otherwise, the decompressed pixels are transferred directly to the framebuffer. Generally, larger scratchbuffers improve render performance.
The size must be a multiple of 16 bytes when the framebuffer format is 16 bpp or 32 bpp, and a multiple of 48 bytes when the framebuffer format is 24 bpp.
GPU2Dアクセラレータ(NeoChrom)
GPU2D(NeoChrom)は、テクスチャ・マッピングやベクタ・レンダリングなど、TouchGFXの多くの描画操作を高速化するグラフィック・アクセラレータ機能です。これは、RGB565、RGB888、ARGB8888フォーマットのフレームバッファをサポートします。
GPU2Dグラフィック・アクセラレーションに関して、開発者には次の2つのオプションがあります。
- No - アプリケーションはCPUのみを使用して描画します。
- Yes - アプリケーションは使用可能な場合にNeoChromチップを使用して、TouchGFXによって行われる多くの描画操作を高速化します。 TouchGFX Generatorによってドライバが生成されるので、開発者によるアクションは必要ありません。
TouchGFX GeneratorでGPU2Dアクセラレータを選択できるようにするには、STM32CubeMXの[Multimedia]カテゴリでこれを有効にする必要があります。
Note
有効にすると、TouchGFX Generatorに新しいセクション([GPU2D Driver])が表示されます。
[GPU2D Command List Size]を設定すると、GPU2Dで使用されるコマンド・リストのサイズがバイト単位で設定されます。
Note
リアルタイム・オペレーティング・システム
開発者はTouchGFXで任意のRTOSを使用できます(OSなしも含む)。「抽象化レイヤ・アーキテクチャ」で説明したように、TouchGFX EngineはOSWrappersインタフェースを使用して、ユーザが選択したRTOSと、メイン・イベント・ループおよびフレームバッファのアクセスを同期させます。開発者がTouchGFX Generatorでオペレーティング・システムを選択した場合、選択したOSのプリミティブを介して内部同期するためのコードが生成されます。それでも、特にスタック・サイズを決定するために、STM32CubeMXを介してオペレーティング・システムを設定する必要があります。
FreeRTOS(CMSIS OS V1およびV2)およびThreadX(ネイティブ・ミドルウェアまたはAzure RTOSソフトウェア・パック)はSTM32CubeMXから直接設定可能で、TouchGFX Generatorはタスク定義とTouchGFX RTOSドライバの両方の生成済みコードをユーザに提供します。 TouchGFX Generatorは、CMSIS V1およびCMSIS V2準拠のRTOSドライバを生成可能で、これらは任意のCMSIS準拠のRTOS、ThreadXのドライバ、およびオペレーティング・システムなし(No OS)のベア・メタル動作用のドライバとの組み合わせで機能します。
No OS
オペレーティング・システムなしでTouchGFXを実行する必要がある場合、STM32CubeMXでオペレーティング・システムが[Middleware and Software Packs]カテゴリで有効になっていない、あるいはX-CUBEとして選択されていなければ、TouchGFX Generatorで[No OS]オプションが有効になります。
Further reading
FreeRTOS
TouchGFX GeneratorでCMSIS_RTOS_V1またはCMSIS_RTOS_V2を選択できるようにするには、STM32CubeMXの[Middleware and Software Packs]カテゴリでFreeRTOSを有効にする必要があります。
一部のTouchGFX Board Setupは、デフォルトでFreeRTOSミドルウェアを使用するように設定されていません。ThreadXまたはNoOS(STM32U599など)を使用するように設定されています。それでもこれらのTouchGFX Board SetupでFreeRTOSを使用したい場合は、STM32CubeMXの[Software Packs Components Selector]でX-CUBE-FreeROTSパックをダウンロードし、有効にする必要があります。
Further reading
ThreadX
ThreadXを有効にするには、X-CUBEソフトウェア・パックを選択するか、STM32CubeMXからネイティブのThreadXミドルウェアを有効にします(選択したマイクロコントローラ・デバイスで使用可能な場合)。
開発者は、ThreadXがX-CUBEソフトウェア・パックとして設定されているのか、または特定のマイクロコントローラ・ファミリのネイティブのThreadXミドルウェアとして設定されているのかを確認する必要があります。
Note
次のセクションでは、ThreadXをミドルウェアとして、またはAZRTOSソフトウェア・パックとしてアプリケーション用に有効化する方法を示します。
[Middleware and Software Packs]カテゴリからThreadXを有効にする
TouchGFX GeneratorでThreadXを選択できるようにするには、STM32CubeMXの[Middleware and Software Packs]カテゴリでThreadXを有効にする必要があります。
ThreadXを有効にすると、TouchGFX GeneratorでThreadXオプションが使用できるようになります。
Further reading
X-CUBEソフトウェア・パックからThreadXを有効にする
TouchGFX GeneratorでThreadXを選択できるようにするには、STM32CubeMXのソフトウェア・パック・コンポーネント・セレクタでAZRTOSソフトウェア・パックを有効にする必要があります。プロジェクト内で[Select Components]ボタンをクリックするか、 STM32CubeMXのプロジェクト・メニューでAlt + o を押します。
次の図は、プロジェクトに対してAZRTOSソフトウェア・パックを有効化する方法を示しています。 [RTOS ThreadX]を選択し、[Core]チェック・ボックスをオンにしてThreadXを有効にします。まだの場合は、パッケージをダウンロードしてインストールします。
ThreadX Software Packをプロジェクトに追加すると、STM32CubeMXのプロジェクト・メニューの左側にある[Middleware and Software Packs]カテゴリの下に該当のX-CUBEが表示されます。
ThreadXを有効にすると、TouchGFX Generatorでオプションとして選択できるようになります。また、選択後は、[Memory Pool Size]と[Memory Stack Size]の値が表示されます。
これらの値は、スレッド・リソースを格納するのに十分大きい必要があります。
Further reading
その他のCMSIS準拠OS
STM32CubeMXが提供可能なOS(FreeRTOSおよびThreadX)以外のCMSIS準拠OSを必要とする開発者は、RTOSの設定とタスク定義を手動で行う必要があります。 TouchGFX Generatorが空のOSWrappersインタフェースを生成し、開発者はこれを実装する必要があります。通常、以下のステップを手動で行う必要があります。
- RTOSを設定する。
OSWrappersインタフェースを実装する。- TouchGFXを実行するためのタスクを定義する(
MX_TouchGFX_Process)。 - スケジューラを起動する。
MX_TouchGFX_Processを呼び出して、タスク・ハンドラ内で TouchGFX Engineのメイン・ループを開始します。
void MX_TouchGFX_Process(void);














