WithHappySTM32G0xのラインナップは、Value/Access/Access&Encryptionの3製品です。本稿は、このSTM32G0xのADC利用法を解説します。時短に役立つ資料を表1にリストアップしました。STM32G0のADCトレーニング資料。全20ページの内容は判り易く良書。STM32CubeMXを使い生成可能なSTM32G0x公式サンプルプロジェクト一覧表。8個、HALとLL混在1個のADC公式STM32CubeMXプロジェクト掲載アプリケーションノート。全STM32MCUのADCを精度よく使う方法アプリケーションノート。3資料と数は少ないですが、ADC内容は盛り沢山です。STM32G0xのADC公式サンプルプロジェクトAN5110とオンライントレーニング資料を中心に、AN2834も参照するアプローチで解説します。トレーニング資料P18に特徴の比較があります。STM32G0とSTM32F0のADC差分(※説明のため着色しています。出典:ADCオンライントレーニング資料)先ず、Conversion:ADC変換時間が0.4usと高速になった点。64MHz動作(F0は48MHz)ですが2倍以上高速です。watchdog対応数が増え、バッテリー動作に備え低圧側に動作電圧が広がっています。ハードウェアオーバーサンプリングと高度なシーケンサーが新しい機能です。普通のSTM32F0と同じADC制御もできますが、これら新機能を使いこなし、コアMCU負担を減らすように制御すると上手い使い方と言えるでしょう。トレーニング資料は英文ですが、ポイントを抑えた非常に良くできた資料です。筆者の下手な解説より資料を読んで頂くと、STM32G0xのADCの使い方が判ると思います。APIによるADCの使い方を習得します。(1)~(3)を参照してください。APIを使ったADCプロジェクト一覧(出典:AN5110)Descriptionを読むと、大別して4種類のサンプルプロジェクトがあることが解ります。AN5110は、Examples_LLフォルダを名前順に表示したもので、MXアイコン付き8個を制御別に解り易く並び変えたものが表2です。なし4種類を整理すると、最も基本のADCプロジェクトが1です。1のSingleConversion_TriggerSoftwareは、ソフトウェアトリガでADCを開始し、ポーリングでデータ取得、データ転送にDMA転送、割込みなどの応用例があります。タイマをトリガにDMA転送の発展例もあります。ADC処理回数は1回です。2のContinuousConversionは、1のADC処理回数の連続形で、LowPowerでの応用例があります。Mode説明が、トレーニング資料P11にあります。3のOversamplingは、新機能のサンプルプロジェクトです。Oversampling説明が、トレーニング資料P12にあります。4のAnalogWatchdogも、新機能の3個AnalogWatchdogを使ったサンプルプロジェクトです。※AnalogWatchdog説明が、トレーニング資料P13にあります。ADCサンプルプロジェクトだけでもおなか一杯で、しかも、これでもADCの豊富な機能の一部抜粋です。省電力動作や、実際に接続するアナログセンサ出力への対応、加えてAN2834記載の変換精度向上なども考慮すると、ADCだけでも上手く使うのはかなりのスキルや経験が必要なのが分ります。いう時は、最も基本のADC_SingleConversion_TriggerSWを先ず理解し、プライオリティに応じて順次ステップアップするのが常套手段です。プライオリティ無しの手当たり次第の理解は、消化不良を起こします😂。※なおSTM32G0x専用テンプレートは、このADC_SingleConversion_TriggerSWを実装予定です。ADC_SingleConversion_TriggerSW_InitのSW4STM32インポート※統合開発環境SW4STM32とコード生成ツールSTM32CubeMXは、Windowsパソコンへインストール済みとします。インストール方法は、関連投稿を参照してください。ADC_SingleConversion_TriggerSW_Initを使って、STM32G0xのADC使い方を説明します。サンプルプロジェクト:ADC_SingleConversion_TriggerSW_InitをIDE:SW4STM32へインポートする方法は色々あります。簡単な方法が下記です。STM32Cube\Repository\STM32Cube_FW_G0_V1.1.0\Projects\NUCLEO-G071RB\Examples_LL\ADC\ADC_SingleConversion_TriggerSW_Initフォルダを開き、ADC_SingleConversion_TriggerSW_Init.iocをクリックすると、STM32CubeMXが起動します。Manager>Projectで、Toolchain/IDEをSW4STM32へ変えます。SettingsタブでADCや周辺回路のLL利用を確認しておきます。Projectをクリックすると、SW4STM32が起動します。project...が表示されればインポート完了です。SW2STM32インポート成功時ダイアログ4.SW4STM32でreadme.txtを開くとインポートしたプロジェクト内容が解ります。A2接続の、0から3.3Vまでのアナログ入力電圧を、ソフトウェアトリガでADCスタートし、ADC完了ポーリングでデータ変換完了を確認するのがこのプロジェクトです。評価ボード単独でもアナログ入力電圧は不定ですが、動作可能です。main.cを見た方は、ソースコード行数が多いのでビックリするかもしれません。以下のSTM32CubeMX(以下MX)生成ソースコードの構造を押さえて読めば簡単です。*/で囲まれている従って、サンプルプロジェクトのユーザコード/コメント部分は、「ユーザの代わりにSTMが作成したコードと明示的に説明を加えた箇所」です。注意して読みましょう。それ以外のMX生成部分は、コメントを眺める程度で十分です。サンプルプロジェクトmain.c解説ソースコードが読めると、サンプルプロジェクト内の重要関数も解ります。ADC_SingleConversion_TriggerSW_Initの場合は、L121のConversionStartPoll_ADC_GrpRegular(void)とL120のActivate_ADC(void)が重要関数です。API開発時の汎用関数です。ADC_SingleConversion_TriggerSW_Initのmain.c解説。重要関数と汎用関数に分けて読む。L121へカーソルを移動し、F3を押すとConversionStartPoll_ADC_GrpRegular(void)の定義場所へ簡単に移動できます。ConversionStartPoll_ADC_GrpRegular()本体ConversionStartPoll_ADC_GrpRegular(void)は、本来ユーザが作成する関数を、STMが代わりに作成した信頼性が高い関数です。ユーザが利用しない手はありません。ライセンス上も問題なく使えます。STMが明示的に付けたコメントがありますので、自分の開発ソースコードへ利用・活用できるようにコメントを読んで内容を理解しておきましょう。内容理解には、readme.txtやトレーニング資料も役立ちます。同様に、もう1つの重要関数:Activate_ADC(void)も利用・活用できるように理解しましょう。以上のように重要関数を理解すると、サンプルプロジェクト:ADC_SingleConversion_TriggerSW_Initが示した処理内容とその中から利用できる関数を、自分が開発するプロジェクトの代替関数(≒一種の部品)として使えるようになります。公式サンプルプロジェクトは、この「高信頼部品の宝庫」です。部品を利用すれば、開発速度が上がります。作法」も明示STMコメントが示しています。ユーザは、どこに、何を、追記すべきか前章は、ADC_SingleConversion_TriggerSW_Initを使って、サンプルプロジェクトソースコード:main.cの理解方法を示しました。一般的な周辺回路のユーザ追記箇所は、前章のように主としてmain.cの無限ループです。周辺回路の初期設定(前章で言えばMX_ADC1_Init(void)やMX_GPIO_Init(void))は、STM32CubeMXが担うからです。サンプルプロジェクトには、周辺回路に割込みやDMAを利用した例もあります。(3)で示した割込みNVIC利用時のユーザ追記箇所と、本稿で示した周辺回路ユーザ追記箇所の2つに分けてソースコードを理解します。STM32CubeMXが自動生成したソースコードの、「どこに、何を、ユーザが追記すべきか」は、本章で示した方法でサンプルプロジェクトを理解すれば、自然に解るようになります。逆に、「どこに、何を、追記すべきか」かが解らないなら、まだサンプルプロジェクト理解が足りないと言えます。公式サンプルプロジェクトのソースコードを作成するのは、STM32CubeMXと「ユーザ代替のSTMプロフェッショナル」です。両者の役割、作成部分やソースコード構造を理解するのがユーザ開発の第一歩です。ここでは、表2の中で最も基本のADC_SingleConversion_TriggerSWサンプルプロジェクトを使って、STM32G0xのADC利用法を解説しました。ADCサンプルプロジェクトは他にも多数あります。自分の開発プライオリティに応じて、他プロジェクトも同様に理解し、ステップアップすれば良いでしょう。STM32G0x専用テンプレートの目的MCUソフトウェア開発は、0から着手するのではなく、コード生成ツール:STM32CubeMX活用や前章で示した公式サンプルプロジェクトの部品利用・活用で、効率的に早く開発する、いわゆるプロトタイプ開発が主流です。プロトタイプ開発をしないと、競合他社とのビジネスには不利です。プロトタイプ開発は、開発スピードが要求されます。何がしかの動作確認済みテンプレート(ひな形)と評価ボード、詳しい説明資料があれば、開発着手時のつまずきや手間が省け、より検討すべき項目に時間が割けます。このテンプレートが、弊社汎用マイコンテンプレートです。MCU「STM32G0xシリーズ専用」テンプレートで、STM32MCUで汎用性がある上記テンプレートとは異なりますが、目的や役割は汎用と同じです。MCUテンプレート開発STM32G0x専用テンプレートには、本稿で示したADC重要関数や、USB経由のADC変換データパソコン出力、パソコンからの評価ボードLED点滅制御など、STM32G0x開発着手時に最低限必要な機能や部品をあらかじめテンプレートに実装済みです。STM32G0x専用テンプレートをサンプルプロジェクトとの差分で説明すると、複数サンプルプロジェクトが実装済みで、プロトタイプ開発着手のレベルにより近いプロジェクト、これがテンプレートとも言えます。各種サンプルプロジェクト追加や削除が簡単なのも特徴です。理解できるよう詳細な解説資料付きで提供します。STM32G0x専用テンプレートを利用すると、STM32G0xプロトタイプ開発を即座に始められます。STM32G0x専用テンプレートは、近日中に発売予定です。APIの違いを説明します。専用テンプレートはLL、汎用テンプレートはHALを使う理由がお判りになると思います。API関連資料一覧のUM2319の最初のページに、LLとHALの定義が示されています。APIを利用するソフトウェア(=アプリケーション)はそのMCU専用になります。API利用アプリケーションはSTM32MCU間で汎用的に使えます。HALの方が現代的で少ないユーザ記述でアプリケーション開発ができ、さらに汎用なので開発労力が無駄にならない利点があります。HALが隠蔽している制御の分Flash(ROM)やRAM容量が必要で、LLに比べ低速です。モーター制御など高速処理が必要な部分にはLLの方が向いているかもしれません。API相対比較表を再掲します。HALとLL比較(※説明のため着色しています。APIの利点は、ハードウェア性能を活かし少ない容量で高性能アプリケーション開発ができる点です。これは、小Flashで高性能なSTM32G0xデバイスに最適と言えるでしょう。現状はSTM32G0xが「単独デバイス」でSTM32F0/F1両方のMCU性能をカバーしているので「専用テンプレートが最適」だと言えます。「STM32G0xシリーズに更に高性能なSTM32G1xデバイス」が発売されれば、移植性が高いHALでSTM32G0xソフトウェア開発を行う方が良くなる可能性はあります。API利用の販売中汎用STM32FxテンプレートをSTM32G0xデバイスへ適用すれば済みます。汎用性を示すこの適用例は、近く投稿する予定です。APIメリットを示すデバイス例としてSTM32G0xを選び、専用テンプレートを開発中です。APIに比べどの程度小さくなるかを実例で示します。これも前の投稿STM32CubeMXの使い方で示したように、一般的にはLLの方がHAL比60~80%小さくなると言われます。59%小さく実現できることが判ります。API混合利用時の注意点AN5110には、LLとHAL両方を混在させた公式サンプルプロジェクトのExamples_MIXがNucleo-G071RBでも9例と少ないながら掲載されています。LLとHAL混在利用の公式サンプルプロジェクト(出典:AN5110)LLとHALを混在利用時は、色々な注意点があります。UM2319の5章に詳細がありますが、一部抜粋します。・同じ周辺回路をHALとLLで混在制御するのは避ける・LLはHALがハンドルしているレジスタを上書きすることがあるので注意また、UM2303の2章にLLとHALの示すアーキテクチャが示されています。Architecture(※説明のため着色しています。出典:UM2303)つまり、上層HALが下層LLを利用する場合がある訳です。LLは、HALがどのように周辺回路を制御しているかを知ることなく直接ハードウェアレジスタにアクセスします。混在時はレジスタ競合などの詳細な注意がAPI利用者側で必要です。利用時LLとHAL混在利用は、Examples_MIXの9例を除いては避けた方が良さそうです。Package)も、同じ理由でSTM32G0x専用テンプレートには使いません。※以上は、同一周辺回路でLLとHALを混在利用する場合の注意点です。I2CはHAL、GPIOはLLの場合などです。この場合でも、HALがLLを利用することを考慮すると、アプリケーションレベルでの安全側評価では混在は避け、LLまたはHALに統一して利用する方が無難だと思います。APIのみで開発します。従って、STM32G0xデバイス専用のアプリケーションとなります。APIを使っていますので、STM32MCUで汎用的に使えるアプリケーションです。※このSTM32Fxテンプレート汎用性を示すため、STM32G0xデバイスへこの汎用テンプレートを適用した例を示す予定です。LLとHAL混在アプリケーション開発は、レジスタアクセス競合などの詳細注意が、API利用アプリケーション側で必要です。公式サンプルプロジェクトExamples_MIXで示されたやむを得ない場合を除いては、避けた方が無難です。API利用法を3回に分けて投稿します。API初期化処理です。Layer)APIでもこの2構成は同じです。LLとHALに関するSTマイクロエレクトロニクス(以下STM)資料は数多くあります。API利用を推薦」していると思います。MCUハードウェア差を隠蔽でき、開発ソフトウェア移植性にも優れているからです。APIがデフォルトです。API関連資料は、投稿時点では未だ少ない状況で、リストアップすると表1の4個程度です。近くより小ピン小容量のSTM32G0xがリリースされますので、もっと多くなると期待しています。API関連はありませんが、BSPやUSB制御をSTM32G0x専用テンプレートでも使う可能性を考慮して追加しました。API関連資料4+1個の範囲でその利用法をまとめます。STM32CubeMXで生成可能なSTM32G0公式サンプルプロジェクトの一覧表。APIのみ、HALとLL混在などに区分けされたアプリケーションノート。API解説章の理解が必要です。API利用法は、実践的アプローチから着手し、不明な点やレファレンスが必要な時にUM2319を参照することにします。API利用例:AN5110のExamples_LLSTM32G0x専用テンプレート動作確認評価ボードは、Nucleo-G071RBです。API利用サンプルプロジェクト数が75個と掲載ボード中最も多いので前章アプローチに最適です。APIサンプルプロジェクトから、2つのGPIOプロジェクトに着目します。この2プロジェクトは、どちらも評価ボード実装済みLD4を250ms毎に点滅させます。2つのGPIOサンプルプロジェクト差(※説明のため着色しています)MXアイコンが付いているGPIO_InfiniteLedToggling_Initは、STM32CubeMXで生成可能、GPIO_InfiniteLedTogglingは生成不可です。Function)です。両者ソースコードの初期化処理を下図に示します。GPIO_InfiniteLedToggling_Init(左)とGPIO_InfiniteLedToggling(右)の初期化処理の差MX_GPIO_Init()が、STM32CubeMX生成可能プロジェクト、Configure_GPIO()が、生成不可プロジェクトの初期化処理です。Library)です。※()内は、筆者が追記。MX_GPIO_Init()は、STM32CubeMXが生成した初期化処理で、MX_が接頭語として付いていることからLLとHAL混在時でも使える関数です。Configure_GPIO()は、MX_GPIO_Init()と同じ機能ながら少ないソースコードで記述できています。その結果、Configure_GPIO()の方が、MX_GPIO_Init()よりも高性能で小サイズとなります(初期化処理以外は、どちらも同じ)。MX_GPIO_Init()は、付属オリジナルSTM32CubeMXプロジェクトに変更を加えた時にでも中身はSTM32CubeMXが自動生成する関数で置換えられるだけで、MX_GPIO_Init()はそのまま残ります。Configure_GPIO()は中身のユーザ修正が必要です。結局、STM32CubeMXで生成可能なGPIO_InfiniteLedToggling_Iniプロジェクトは、ユーザが何らかの変更を加えても初期化処理をSTM32CubeMX任せにでき、無限ループ内にある変更処理に集中できる訳です。APIの利用切替えが周辺回路毎に設定可能です。APIのみ利用するプロジェクトでも、初期化処理関数の接頭語には、後々の周辺回路のHAL利用・変更・追加などに備えてML_を付けるのだと推測します。STM32CubeMX任せにすると、ユーザ自作よりも多少サイズが犠牲になります。公式サンプルプロジェクト応用が簡単にできることを考慮すると、その差を十分補える効果があります。APIを利用するSTM32G0x専用テンプレートの初期化処理は、STM32CubeMX任せにします。STM32G0x専用テンプレート用STM32CubeMXプロジェクトも添付いたしますので専用テンプレート応用・流用は簡単となります(汎用STM32Fxテンプレートは、既にテンプレート用STM32CubeMXプロジェクト添付済みです)。MCUであること、そのテンプレート開発も汎用STM32Fxテンプレートと異なること、これら理由を説明します。まとめはじめに内容をまとめた表1と表2、図1を示し、次章からその詳細理由を説明します。MCUテンプレート開発が得策だということです。テンプレート開発方向性。同じメインストリームMCUでもSTM32G0xデバイスは専用性、STM32Fxデバイスは汎用性重視。MCUと従来MCUの最も異なる点は、製造プロセスです。STM32G0xは70nm、STM32Fxは120nmの製造プロセスです。製造プロセスによる性能差は、Intelプロセサでお馴染みだと思います。簡単に言うと、製造プロセスを小さくすると、全く同じMCUでも、動作周波数が上がり、消費電力は下がる、販売コストも下がるなど、良いこと尽くめの効果が期待できます。STM32G0xは、Cortex-M0の電力消費を改良しCortex-M3の良さを取り入れたCortex-M0+コアを採用しています。コアと製造プロセスの両方でCortex-M0のSTM32F0デバイスを上回り、動作周波数をCortex-M3のSTM32F1デバイス72MHzに近い60MHzとしたことで、STM32F1と同程度の高性能なのに超低電力動作します。MCUに相応しい周辺回路を実装しています(3タイプあるデバイスで実装周辺回路を変え、低価格供給中)。STM32G0xデバイスとSTM32F0/F1デバイスのハードウェア差をまとめたのが表1です。STM32G0x出現で、STM32F1/F0デバイスで開発する意味は、低下したとも言えるでしょう。※但し、他デバイスへの移植性・流用性を重視した開発ならSTM32F1/F0デバイスを使い汎用STM32Fxテンプレート使う意味は依然として大きいです。現在はSTMから何のアナウンスもありませんが、STM32G0xと同じ70nm製造プロセスでCortex-M3/≦100MHzの上位デバイスSTM32G1xが発売されれば、なおさら低下します。関連投稿に上記特徴の出典などがあります。Layer)APIを使い、万一性能不足などでデバイスを変える事態が生じても、同じソフトウェアを使えます。従って、STM32F0とSTM32F1の両デバイスで動作するアプリケーションが、ほんの少しの修正で素早く作成できます。これは、HALのおかげです。HALがデバイスや周辺回路差を吸収するため、アプリケーション側は移植性の高いシンプルな記述ができるのです。Layer)に比べ大きくなります。関連投稿:STM32CubeMXの使い方、STM32CubeMXの2種ドライバライブラリの章参照HALを使うと言うことは、たとえデバイスが変わっても開発したソフトウェアとその労力を無駄にせず、流用・応用できることが最大のメリットです。汎用「STM32Fxテンプレート」は、この流用・応用に適したテンプレートです。動作確認評価ボードは、STM32F072RBとSTM32F103RBのみですが、全ての汎用STM32Fxデバイスへ応用できます。ここで示したSTM32G0xデバイスにもこのHALを使う手法は適用可能です。STM32G0x専用のテンプレートです。APIは、使用デバイスにより異なるので専用テンプレートになります。STM32G1xデバイスが持つCortex-M0からCortex-M3までをカバーする広い適用力と超低電力動作を活かすには、ソフトウェア開発にHAL比60~80%の高速処理のLLを使った方が得策と判断しました。MCUテンプレートです。※但し、流用性が高い一部機能には、HAL活用も考慮中です。LLとHALは混在可能です。MCUテンプレートと汎用STM32Fxテンプレートの違いをまとめたのが表2、テンプレート開発の方向性を示したのが図1です。MCUテンプレートの動作確認評価ボードには、Nucleo-G071RB(¥1,203)を予定しています。MCUテンプレート評価ボードの3要件を再掲します。単独ではNGですが、Arduinoコネクタに何らかのIoTサービスシールドを追加することで満たす予定です。評価ボードNucleo-G071RB。64ピンパッケージでも電源供給が2本のみのなのでアートワーク担当者が喜ぶ。Kitや、暗号化処理サービスを示すSTM32G081B-EVALは、両方ともR3要件を満たしますが、価格要件R1<¥3,000を満たさないので利用を断念しました。