メイン・コンテンツまでスキップ

ドライバ

[Driver]セクションでは、TouchGFX ALのさまざまな役割に対応するドライバを開発者が選択できます。

TouchGFX Generatorの[Driver]設定

アプリケーション・ティック・ソース​

アプリケーションのアプリケーション・ティック・ソースは、アプリケーションを前進させる方法を定義します。開発者は以下のオプションを使用できます。

  • LTDC - [Display]グループでインタフェースとして[LTDC]を選択した場合、[Application Tick Source]を[LTDC]にできます。つまり、TouchGFX GeneratorがTouchGFXGeneratedHALクラスにドライバ関数(LTDC割込みハンドラ)を生成し、それがOSWrappers::signalVSync()を呼び出してアプリケーションを前進させます。
  • Custom and FMC - この場合、OSWrappers::signalVSync()を繰り返し呼び出すことでアプリケーションを前進させるハンドラを、開発者が実装する必要があります。
Further reading
カスタムのアプリケーション・ティック・ソースの実装方法の詳細については、「FMC & SPIディスプレイ・インタフェース」シナリオを参照してください。

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は、マイクロコントローラがサポートする場合、STM32CubeMXの「Multimedia」カテゴリで有効になります。

最適な性能を得るため、DMA2D v3を実装したプラットフォーム(STM32H5Fx/H5Exシリーズなど)ではコマンドリスト・モードでこれをアクティブ化する必要があります。

DMA2Dをサポートするマイクロコントローラに対して、コマンドリスト・モードでDMA2Dを有効にします。

Further reading
DMA2DとDMA2D v3との違いの詳細については、「 グラフィック・アクセラレータ」セクションを参照してください。

TouchGFX Generatorによって生成されるDMA2D(Chrom-ART)ドライバは、TransferCompleteInterruptの受信方法として次の2つをサポートしています。

  1. STM32Cube HALドライバを使用して、dma2dハンドラにコールバック関数hdma2d.XferCpltCallbackを登録する。
  2. DMA2D_IRQHandler()割込みハンドラを直接使用する。

この2つの方法を切り替えるには、DMA2D IP用のSTM32CubeMXのNVIC設定で、DMA2Dグローバル割込みを有効化 / 無効化します。

STM32CubeMXのSystem CoreカテゴリにあるNVIC設定で、DMA2Dグローバル割込みを有効化 / 無効化する

グローバル割込みを有効化するとオプション1のコードが生成され、グローバル割込みを無効化するとオプション2のコードが生成されます。

Note
  • DMA2Dのグローバル割込みを使用する場合は、「IRQハンドラ」が「DMA2D HALハンドラ」を呼び出すことを確認します。これはデフォルトの動作です。
  • グローバル割込みが有効で、DMA2Dの「IRQハンドラ」と「HALハンドラの呼び出し」が無効になっている場合、登録されたコールバックが呼び出されません。
  • 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:

    GFXPAND is enabled in the Multimedia category in STM32CubeMX, for MCUs that support it.

    • The GFXPAND peripheral must be activated in STM32CubeMX.
    • The framebuffer pixel format must be RGB565, RGB888, or ARGB8888.
    Note
    The GFXPAND option is only visible if the MCU has the GFXPAND peripheral and the selected framebuffer pixel format is supported.

    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
    See the Image compression on Chrom-DEC article for more information about using Chrom-DEC with TouchGFX and configuring DMA channels.

    When GFXPAND is enabled, the setting Scratch Buffer Size appears in the TouchGFX Generator:

    GFXPAND Decoder settings

    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]カテゴリでこれを有効にする必要があります。

    GPU2Dは、マイクロコントローラがサポートする場合、STM32CubeMXの「Multimedia」カテゴリで有効になります。

    Note
    GPU2Dオプションは、STM32CubeMXで、自分のプロジェクトのMultimediaセクションでGPU2Dが有効になっている場合のみ表示されます。

    有効にすると、TouchGFX Generatorに新しいセクション([GPU2D Driver])が表示されます。

    [GPU2D Driver]設定

    [GPU2D Command List Size]を設定すると、GPU2Dで使用されるコマンド・リストのサイズがバイト単位で設定されます。

    Note
    アプリケーションで[Hardware]オプションを選択してベクタ・レンダリングも有効にしている場合は、 TouchGFX Generatorにより、ベクタ・レンダリング操作を実行するための*stencil buffer*用にメモリ・プールがもう1つ作成されます。このメモリ・プールのサイズは(ディスプレイ幅 xディスプレイ高さのバイト数)+ 5KBのマージンです。したがって、より多くのRAMが消費されます。 [Software]オプションを選択すると、パフォーマンスの低下と引き換えにRAMを節約できます。

    リアルタイム・オペレーティング・システム​

    開発者は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
    ベア・メタル・アプリケーションの実行時にTouchGFX Generatorによって生成されるコードの詳細については、「リアルタイム・オペレーティング・システム」シナリオを参照してください。

    FreeRTOS​

    TouchGFX GeneratorでCMSIS_RTOS_V1またはCMSIS_RTOS_V2を選択できるようにするには、STM32CubeMXの[Middleware and Software Packs]カテゴリでFreeRTOSを有効にする必要があります。

    STM32CubeMXプロジェクトでFreeRTOSを有効化

    一部のTouchGFX Board Setupは、デフォルトでFreeRTOSミドルウェアを使用するように設定されていません。ThreadXまたはNoOS(STM32U599など)を使用するように設定されています。それでもこれらのTouchGFX Board SetupでFreeRTOSを使用したい場合は、STM32CubeMXの[Software Packs Components Selector]でX-CUBE-FreeROTSパックをダウンロードし、有効にする必要があります。

    [Software Packs Components Selector]でFreeRTOSを有効化

    Further reading
    TouchGFXアプリケーション向けにFreeRTOS(CMSIS_RTOS_V1およびCMSIS_RTOS_V2)を設定する方法については、「リアルタイム・オペレーティング・システム」シナリオを参照してください。

    ThreadX​

    ThreadXを有効にするには、X-CUBEソフトウェア・パックを選択するか、STM32CubeMXからネイティブのThreadXミドルウェアを有効にします(選択したマイクロコントローラ・デバイスで使用可能な場合)。

    開発者は、ThreadXがX-CUBEソフトウェア・パックとして設定されているのか、または特定のマイクロコントローラ・ファミリのネイティブのThreadXミドルウェアとして設定されているのかを確認する必要があります。

    Note
  • すべての新しいSTM32マイクロコントローラ・デバイスでは、デフォルトで、STM32CubeMXの「Middleware」カテゴリからThreadXを直接サポートします。追加のパックをダウンロードする必要はありません。 TouchGFX Board Supportパッケージは、ThreadXミドルウェアを使用するか(可能な場合)、X-CUBE-AZRTOSソフトウェア・パックを使用する方向に徐々に移行します。
  • ThreadXサポートを提供するX-CUBE-AZRTOS-XXソフトウェア・パッケージは、すでに広い範囲のSTM32マイクロコントローラ・ファミリで使用可能になっており、STM32CubeMXの[Embedded Software Packages Manager]で見つけることができます。
  • 次のセクションでは、ThreadXをミドルウェアとして、またはAZRTOSソフトウェア・パックとしてアプリケーション用に有効化する方法を示します。

    [Middleware and Software Packs]カテゴリからThreadXを有効にする​

    TouchGFX GeneratorでThreadXを選択できるようにするには、STM32CubeMXの[Middleware and Software Packs]カテゴリでThreadXを有効にする必要があります。

    STM32CubeMXプロジェクトの[Middleware and Software Packs]カテゴリで、ThreadXを有効化

    ThreadXを有効にすると、TouchGFX GeneratorでThreadXオプションが使用できるようになります。

    Further reading
    TouchGFXアプリケーション向けにThreadXをネイティブ・ミドルウェアとして設定する方法については、「リアルタイム・オペレーティング・システム」シナリオを参照してください。

    X-CUBEソフトウェア・パックからThreadXを有効にする​

    TouchGFX GeneratorでThreadXを選択できるようにするには、STM32CubeMXのソフトウェア・パック・コンポーネント・セレクタでAZRTOSソフトウェア・パックを有効にする必要があります。プロジェクト内で[Select Components]ボタンをクリックするか、 STM32CubeMXのプロジェクト・メニューでAlt + o を押します。

    STM32CubeMXで[Additional Software]を選択

    次の図は、プロジェクトに対してAZRTOSソフトウェア・パックを有効化する方法を示しています。 [RTOS ThreadX]を選択し、[Core]チェック・ボックスをオンにしてThreadXを有効にします。まだの場合は、パッケージをダウンロードしてインストールします。

    X-CUBE-AZRTOSソフトウェア・パックからThreadXを有効にする

    ThreadX Software Packをプロジェクトに追加すると、STM32CubeMXのプロジェクト・メニューの左側にある[Middleware and Software Packs]カテゴリの下に該当のX-CUBEが表示されます。

    X-CUBE-AZRTOSからThreadXをSTM32CubeMXプロジェクトで有効化

    ThreadXを有効にすると、TouchGFX Generatorでオプションとして選択できるようになります。また、選択後は、[Memory Pool Size]と[Memory Stack Size]の値が表示されます。

    TouchGFX GeneratorでThreadXを選択

    これらの値は、スレッド・リソースを格納するのに十分大きい必要があります。

    Further reading
    TouchGFXアプリケーション向けにThreadXをX-CUBEとして設定する方法については、「リアルタイム・オペレーティング・システム」シナリオを参照してください。

    その他のCMSIS準拠OS​

    STM32CubeMXが提供可能なOS(FreeRTOSおよびThreadX)以外のCMSIS準拠OSを必要とする開発者は、RTOSの設定とタスク定義を手動で行う必要があります。 TouchGFX Generatorが空のOSWrappersインタフェースを生成し、開発者はこれを実装する必要があります。通常、以下のステップを手動で行う必要があります。

    1. RTOSを設定する。
    2. OSWrappersインタフェースを実装する。
    3. TouchGFXを実行するためのタスクを定義する(MX_TouchGFX_Process)。
    4. スケジューラを起動する。

    MX_TouchGFX_Processを呼び出して、タスク・ハンドラ内で TouchGFX Engineのメイン・ループを開始します。

    void MX_TouchGFX_Process(void);