STマイクロエレクトロニクス）STM32MCUを使ってRTOS開発時のSTM32CubeMX、HAL、CMSIS RTOSの3注意点について示します。前編が、STM32CubeMXとHALについてです。CMSIS RTOSは、別途後編で示します。
STM32CubeMXとHAL の注意点を解説した後、サンプルプロジェクトで実例を示すという順番で説明します。
ソースコード生成ツール：STM32CubeMX
STマイクロのソースコード生成ツール：STM32CubeMX（以下CubeMX）は、MCU内蔵周辺回路の初期設定やAPIを、GUIベースで自動生成する非常に便利なツールです。
※MCUベンダのAPI生成ツールを比較した関連投稿は、コチラ をご覧ください。
CubeMX生成APIは、ハードウェアを抽象化し、STM32MCU間で最大限の高いソフトウェア移植性を狙ったHAL （Hardware Abstraction Layer）と、よりハードウェアに近くHALよりも高速・軽量なエキスパート向けLL（Low-layer）の2種類から選択可能です。
HALとLL比較（※説明のため着色しています。出典：STM32 Embedded Software Overvire） 一般的に、HAL APIが好まれます。というのは、このLL APIを利用し開発した2019年6月発売のSTM32G0xテンプレートV1の売上げはゼロでした。対策に、LL APIからHAL APIに変更し再開発した2020年6月発売のSTM32G0xテンプレートV2は、人気があるからです。
これらCubeMXの各種GUI設定や選択APIは、CubeMXファイル（.ico）に構成ファイルとして纏められます。
STM32MCU新規プロジェクト開発時に、この既成CubeMXファイル（.ico）を利用すると、ゼロから着手するのに比べ、効率的かつ間違いなく周辺回路や初期設定ができるため、利用価値の高いファイルです。
特に、ベアメタル比、さらに多くのCubeMX設定が必要となるRTOS開発では、既成CubeMXファイルを再利用するメリットがより高まります。同時に、生成コードの意味も理解しておく必要があります。
HALタイムベース
HALには、他ベンダにない便利なAPI：HAL_Delayがあります。
例えば、10msの待ち処理を行う場合、他ベンダなら、MCUコア速度に応じて適当にループ回数を調整したループ処理で10ms相当の遅延を自作します。しかし、HAL APIならば、HAL_Delay(10)の記述だけで、MCUコア速度に依存しない正確な10ms遅延が実現できます。
これは、HAL自身が、MCU内蔵タイマ：SysTickの利用を前提に設計されているからです。遅延処理を例に説明しましたが、STM32のHAL APIsは、SysTickと強く結びついています。
もちろん、HAL APIをベアメタル開発で利用する場合は、この結びつきに何ら問題はありません。
RTOSタイムベース
FreeRTOSも、タスク（スレッド）状態遷移タイムベースに、SysTickを使います。
これは、FreeRTOSだけでなく他のRTOSでも同じです。SysTickは、その名称が示すようにMCUシステムレベルのタイムベース専用タイマです。
従って、STM32MCUでRTOS開発を行い、かつHAL APIを利用する場合には、RTOS側でSysTickを使うのが、名称に基づいた本来の使い方です。
HALタイムベース変更
そこで、STM32RTOS開発でHAL利用の場合は、HALのタイムベースを、デフォルト使用のSysTickから別のタイマへ変更する必要が生じます。この変更に伴う手動設定も当然必要となります。
＊ ＊ ＊
ここまでが、STM32RTOS開発におけるSTM32CubeMXとHALに関する注意点です。
STM32RTOS開発実例
STM32RTOS開発実例に、評価ボード：NUCLEO-G474RE （Cortex-M4/170MHz、Flash/512KB、RAM/96KB）でRTOS開発する場合を示します。
NUCLEO-G071RB （Cortex-M0+/64MHz、Flash/128KB、RAM/32KB）でRTOS開発する時でも同様です。しかも、RTOSサンプルプロジェクトは、STM32G071RBの方が（発売が古いためか？）多いので、NUCLEO-G071RBをお持ちの方は、是非ご自身で試してみてください。
FreeRTOS Example Selector
STM32CubeIDEのFile>STM32 Projectで、新規プロジェクト作成パネルを表示します（最新情報更新のため、表示に少し時間がかかる場合があります）。Example Selectorタブを選択、Middleware>FreeRTOSにチェックを入れ、NUCLEO-G474REのFreeRTOS_Queuesを選択したのが下図です。
NUCLEO-G474REのFreeRTOS_Queues 右上欄、Noteの内容が、前半までに示した注意点のことです。参照先UM1722 Rev3 は、CMSIS RTOSとFreeRTOSの関係があるのみです。このCMSIS RTOSについては、別途後編で説明します。
Nextをクリックし、FreeRTOS_Queuesサンプルプロジェクトを新規作成します。
さて、FreeRTOS Examples Listが318アイテム（STM32CubeIDE v1.6.1時）もあるので、Exportをクリックし、出力されたExcelファイルをBoardでフィルタリング、NUCLEO-G071RBとNUCLEO-G474REを抽出したのが下図です。
FreeRTOS Example List 緑に色付けしたNUCLEO-G071RBの方が、FreeRTOSサンプルプロジェクト数が多いことが判ります。開発予定のSTM版FreeRTOSアプリケーションテンプレートは、Cortex-M4コアが対象ですので、本稿ではNUCLEO-G474REのFreeRTOS_Queuesを実例として使いました。
FreeRTOS_QueuesのSTM32CubeMXファイル
FreeRTOS_QueuesサンプルプロジェクトのCubeMX構成ファイル：FreeRTOS_Queues.icoが下図です。グレー文字は変更不可、黒文字は変更可能を示します。
FreeRTOS_Queues.ico TIM6がグレーなのは、HALタイムベース変更先がTIM6だからです。Kernel settings CPU CLOCK HZのSystemCoreClockがグレーなのは、RTOSタイムベースがSysTickだからです。つまり、本来の名称に基づいたSysTickがRTOS側で使われ、HALの新タイムベースにTIM6が割当済みであることが解ります。
FreeRTOS APIは、変更不可のグレーCMSIS V1です。ここは、後編で説明します。
デフォルトDisabledのUSE IDEL HOOKを、Enabledに変更し、ソースコード自動生成のGenerate Code（Alt+K）を実行してください。
HALタイムベースTIM6変更結果
FreeRTOS_QueseのTIM6とHook関数 app_freertos.cのL62に、Hook関数：vApplicationIdleHoolのひな型が自動生成済みです。ここへWFIを追記すれば、FreeRTOSアイドル時に低電力動作ができます。コチラ のNXP版関連投稿Step5: FreeRTOS低電力動作追記と同じです。
main.cのL289は、TIM6満了時動作です。HAL_IncTick()が自動生成済みです。ベアメタル開発のSysTickからTIM6へHALタイムベースが変更されたことが解ります。
そのTIM6は、stm32g4xx_hal_timebase_tim.cで、1MHz＝1ms満了に初期設定済みです。
つまり、STM32RTOS開発でHAL利用時に必要となる変更が、「全てCubeMXで自動生成済み」なのが解ります。
※上図は、USE_TICK_HOOKもEnabledへ変更した例です。Disabledへ戻すなどして、CubeMX自動生成ファイルが変化することを確かめてください。
この実例のように、CubeMX付属RTOSサンプルプロジェクトのCubeMXファイル（*.ico）を再利用すれば、周辺回路や初期設定ミスを防ぎ、RTOS新規アプリケーション開発が容易になることが解ります。
まとめ
STM32MCUでRTOS開発を行う時の3注意点、STM32CubeMX、HAL、CMSIS RTOSのうち、前編としてSTM32CubeMX、HALの2注意点とサンプルプロジェクトを使ってその実例を示しました。
RTOS開発では、既成STM32CubeMXファイル再利用価値が高まること、HALタイムベース変更の必要性がご理解頂けたと思います。3つ目のCMSIS RTOS関連は後編で示します。
あとがき
ベアメタル開発経験者であっても、STM32RTOS開発時、CubeMXのNoteを読むだけで、ベアメタル開発では何の問題も無かったHAL タイムベース変更理由が解り、その結果生じるCubeMXファイルや自動生成ソースコードの中身が理解できる方は、少ないと思います。本稿は、この変更理由と生成コードに説明を加えました。
STM32CubeMXは、STM32MCU開発に必須で強力なAPI生成ツールです。が、時々、説明不足を感じます。問題は、どのレベル読者を相手にするかです。エキスパートなら説明不要ですが、初心者ならゼロから説明しても解らないかもしれません。文章による組込み技術説明が、難しいのが根本原因でしょう😂。
そんな組込み開発ですが、文章だけでなく、「実際に評価ボードと手足を使って慣れてくると、案外すんなり簡単に理解、習得できる方が多いのも組込み開発」です。
販売中のNXP版FreeRTOSアプリケーションテンプレート にも、本稿同様、詳しいFreeRTOS解説を付けています（一部ダウンロード可能）。FreeRTOS開発を手軽に試せ、習得を支援するツールです。
