STM32 LittlevGLを使う
LittlevGLは、組み込み機器のGUI向けのグラフィックライブラリです。これを使いこなせれば、きれいな画面や使いやすい操作が実現できると思われます。公式の導入方法ではわかりにくい部分があるので、デモの実行方法をまとめておくことにしました。使用したNucleoボードはNUCLEO-F401REです。※メモリ使用量はRAM46kB、FLASH407kBとなったので、それなりに容量が必要となります。
＜準備＞
まずは以前の記事（STM32 SPI接続タッチパネル付ディスプレイを使う）の手順を行って、ディスプレイの動作確認をします。そしてそのプロジェクトをそのまま利用し、以下の操作をしていきます。
＜ダウンロード＞
- LittlevGL本体(v6.1.1)
右側の [Clone or download] ボタンからZIPダウンロード、解凍
→フォルダ名「lvgl-master」を「lvgl」へ変更後、プロジェクトのIncフォルダへフォルダごとコピー - LittlevGLサンプル集
右側の [Clone or download] ボタンからZIPダウンロード、解凍
→フォルダ名「lv_examples-master」を「lv_examples」へ変更後、プロジェクトのIncフォルダへフォルダごとコピー
＜LittlevGLコンフィグファイル編集＞
- lvglフォルダ内のlv_conf_template.hを開き、下記3か所編集
10行目 #if 1 /*Set it to "1" to enable content*/
23行目 #define LV_HOR_RES_MAX (240)
36行目 #define LV_COLOR_16_SWAP 1
→ファイル名「lv_conf_template.h」を「lv_conf.h」へ変更後、プロジェクトのIncフォルダへ移動 - lv_examplesフォルダ内のlv_ex_conf_templ.hを開き、下記2か所編集
9行目 #if 1 /*Set it to "1" to enable content*/
42行目 #define LV_USE_DEMO 1
→ファイル名「lv_ex_conf_templ.h」を「lv_ex_conf.h」へ変更後、プロジェクトのIncフォルダへ移動
※壁紙画像不使用にするとメモリ使用量を減らせます。→44行目 #define LV_DEMO_WALLPAPER 0
＜main.cファイル編集＞
以前の記事（STM32 SPI接続タッチパネル付ディスプレイを使う）で記述したものは消去し、下記4か所に記載
（参考ページ→How start with the LittlevGL on the Disco F746NG with Mbed）
▼/* USER CODE BEGIN Includes */ の下
#include "ili9341.h"
#include "ili9341_touch.h"
#include "lvgl/lvgl.h"
#include "lv_examples/lv_apps/demo/demo.h"
▼/* USER CODE BEGIN 0 */ の下
lv_disp_buf_t disp_buf; // ディスプレイバッファの構造体
lv_color_t buf_1[ILI9341_WIDTH * 10]; // ディスプレイバッファ1
lv_color_t buf_2[ILI9341_WIDTH * 10]; // ディスプレイバッファ2
lv_disp_drv_t disp_drv; // ディスプレイドライバの構造体
lv_indev_drv_t indev_drv; // タッチパッドドライバの構造体
void my_flush_cb(lv_disp_drv_t * disp_drv, const lv_area_t * area, lv_color_t * color_p) // 画面描画
{
int32_t w = area->x2 - area->x1 + 1;
int32_t h = area->y2 - area->y1 + 1;
ILI9341_DrawImage(area->x1, area->y1, w, h, (uint16_t*)color_p);
lv_disp_flush_ready(disp_drv); // 描画終了をライブラリへ知らせる
}
bool my_input_read(lv_indev_drv_t * drv, lv_indev_data_t * data) // タッチパッドのタッチ検出とタッチ位置取得
{
static uint16_t x = 0, last_x = 0;
static uint16_t y = 0, last_y = 0;
if(ILI9341_TouchPressed())
{
ILI9341_TouchGetCoordinates(&x, &y);
data->point.x = x;
data->point.y = ILI9341_HEIGHT - y; // 上下逆さま
last_x = data->point.x;
last_y = data->point.y;
data->state = LV_INDEV_STATE_PR; // タッチあり
}
else
{
data->point.x = last_x;
data->point.y = last_y;
data->state = LV_INDEV_STATE_REL; // タッチなし
}
return false;
}
void init() // ディスプレイ初期化
{
ILI9341_Unselect();
ILI9341_TouchUnselect();
ILI9341_Init();
}
▼/* USER CODE BEGIN 2 */ の下
init(); // ディスプレイ初期化
lv_init(); // ライブラリ初期化
lv_disp_buf_init(&disp_buf, buf_1, buf_2, ILI9341_WIDTH*10); // ディスプレイバッファ初期化
lv_disp_drv_init(&disp_drv); // ディスプレイドライバ初期化
disp_drv.buffer = &disp_buf; // ディスプレイバッファ登録
disp_drv.flush_cb = my_flush_cb; // 画面描画関数登録
lv_disp_drv_register(&disp_drv); // ディスプレイドライバ登録
lv_indev_drv_init(&indev_drv); // タッチパッドドライバ初期化
indev_drv.type = LV_INDEV_TYPE_POINTER; // 入力タイプをタッチパッドに指定
indev_drv.read_cb = my_input_read; // タッチ検出関数登録
lv_indev_drv_register(&indev_drv); // タッチパッドドライバ登録
demo_create(); // デモ呼び出し
▼/* USER CODE BEGIN 3 */ の下
HAL_Delay(100);
lv_tick_inc(100); // ライブラリへ経過時間を知らせる
lv_task_handler(); // ライブラリ実行（画面更新）
ビルドには1分程度かかる場合があります。SPIの通信速度が遅いので、アニメーションはさすがに無理がありそうです。狭い範囲の表示更新については特に問題なさそうな感じです。
タグ : マイコン
Owm Pedal H7 ソフトウェア編
自作デジタルエフェクター「Owm Pedal H7」の各設定、内部プログラミングをしていきます。
Owm Pedal H7 ハードウェア編はこちら
内部データはGitHubへ
＜開発環境について＞
STM32CubeIDEのバージョン1.1.0ではクロック設定がうまく動作しなかったので、STM32CubeMXを併用していました。バージョン1.2.1では修正されているようで、今のところ問題は起きていません。
main.cファイルを「main.cpp」にリネームすればC++を使うことができます。main.cppに追加記載しているのは下記3か所です。主にuser_main.cppを編集することになります。
「/* USER CODE BEGIN Includes */」の下→#include "user_main.hpp"
「/* USER CODE BEGIN 2 */」の下→mainInit();
「/* USER CODE BEGIN 3 */」の下→mainLoop();
コンパイラの最適化設定を高速動作向けに変更しておきます。
Project→Properties→C/C++ Build→Settings→Tool Settingsタブ
→MCU G++ Compiler→Optimization→Optimization level [Optimize for speed (-Ofast)]
＜STM32CubeIDE iocファイル設定＞
・ST-LINK接続（結線はOwm Pedal ソフトウェア編参照）
Trace and Debug→DEBUG→Debug [Serial Wire]
・処理高速化のためDキャッシュを有効化
System Core→CORTEX_M7→Cortex Interface Settings→CPU DCache : Enabled
・クロック源として外部水晶振動子を使用
System Core→RCC→High Speed Clock (HSE) [Crystal/Ceramic Resonator]
・動作モード設定（480MHz動作のために必要）
System Core→RCC→Power Parameters→Power Regulator Voltage Scale : Power Regulator Voltage Scale 0
▽SPI設定
タッチパネル付ディスプレイの接続はSPIです。詳細は以前の記事（STM32 SPI接続タッチパネル付ディスプレイを使う）をご参照ください。
※通信速度を上げ過ぎるとタッチ位置をうまく取得できないので、本来はディスプレイとタッチを別々のSPIにした方がよいと思われます。
▽SAI設定
Multimedia→SAI1→SAI A→Mode [Asynchronous Slave] I2S/PCM Protocol にチェック
同SAI B→Mode [Synchronous Slave] I2S/PCM Protocol にチェック
SAI A Data Size : 32 Bits
SAI A FIFO Threshold : Half Full
SAI B Audio Mode : Slave Transmit
SAI B Data Size : 32 Bits
SAI B FIFO Threshold : Half Full
NVIC Settingsタブ→SAI1 global interrupt→Enabledにチェック（2020年3月16日追記）
※STM32H7でDMAを利用するのは大変そうなので、今回は利用していません。
→参考ページ：STM32H7でキャッシュ一貫性を保持したDMA転送(Memory-to-Peripheral)
▽クロック設定図
SAIクロックは、オーディオサンプリングレート44.1kHzに対する誤差が少なくなるような設定としました（44.1×2048＝90316.8）。
▽全ピン設定図
＜信号処理＞
Owm Pedalと同じように半分ずつデータ処理しようとしましたが、HalfCpltCallbackが呼び出されないようなので、2つのバッファ配列を準備しました（下図ではaとb、ソースコード内では[0]と[1]）。
mainInit処理の中で最初のSAI受信呼び出しを行います（HAL_SAI_Receive_IT）。その後、受信完了時にHAL_SAI_RxCpltCallbackが呼び出され、その中で次の受信とSAI送信（HAL_SAI_Transmit_IT）を行います。送受信にFIFOを設定しておかないと、処理が連続的にならず途切れ途切れになってしまうことがあります。遅延時間（レイテンシ）実測値は、ブロックサイズ32で2.5ms程度でした。まとめて信号処理ではなく、1サンプルずつ処理するようなやり方をすればバッファ配列は1つで済むかもしれません。
＜SAIエラー対処＞
Owm Pedalのときの反省を生かし、オーディオコーデックV4220Mをマイコンからリセットできるようにしました。mainInit処理内でSAIのエラーが起こった場合、リセット処理するようになっています。ただ、今のところエラーが発生したことがなく、正しい処理なのかわかりません。
＜スイッチ・タッチ検出＞
SAIの割り込みは32ブロックサイズ（約0.7ms）ごとに起こるので、これをタイマーのように利用しています。割り込みが起こるたびにGPIOの状態をチェックし、スイッチ操作やタッチを検出するというやり方です。タッチ検出時はすぐにタッチ位置を算出したいところですが、SPI通信にそれなりに時間がかかるので、タッチ位置関係処理は割り込み内ではなくメインループ処理内に入れています。現状の操作方法は下記の通りです。
・画面上部：パラメータページ切替、長押しでデータ保存（→STM32 内蔵フラッシュメモリへのデータ保存）
・各ノブ部：上側で増加、下側で減少（長押しで10ずつ変化）
・画面下部：長押しでエフェクト切替
・スイッチ：エフェクトオン・オフ
＜エフェクト処理＞
とりあえず6つのエフェクト（オーバードライブ、ディレイ、トレモロ、イコライザ、コーラス、リバーブ）を実装していますが、細かい音質については検討していません。今後別記事で紹介していきたいと考えています。
Owm Pedal H7 ハードウェア編はこちら
内部データはGitHubへ
＜開発環境について＞
STM32CubeIDEのバージョン1.1.0ではクロック設定がうまく動作しなかったので、STM32CubeMXを併用していました。バージョン1.2.1では修正されているようで、今のところ問題は起きていません。
main.cファイルを「main.cpp」にリネームすればC++を使うことができます。main.cppに追加記載しているのは下記3か所です。主にuser_main.cppを編集することになります。
「/* USER CODE BEGIN Includes */」の下→#include "user_main.hpp"
「/* USER CODE BEGIN 2 */」の下→mainInit();
「/* USER CODE BEGIN 3 */」の下→mainLoop();
コンパイラの最適化設定を高速動作向けに変更しておきます。
Project→Properties→C/C++ Build→Settings→Tool Settingsタブ
→MCU G++ Compiler→Optimization→Optimization level [Optimize for speed (-Ofast)]
＜STM32CubeIDE iocファイル設定＞
・ST-LINK接続（結線はOwm Pedal ソフトウェア編参照）
Trace and Debug→DEBUG→Debug [Serial Wire]
・処理高速化のためDキャッシュを有効化
System Core→CORTEX_M7→Cortex Interface Settings→CPU DCache : Enabled
・クロック源として外部水晶振動子を使用
System Core→RCC→High Speed Clock (HSE) [Crystal/Ceramic Resonator]
・動作モード設定（480MHz動作のために必要）
System Core→RCC→Power Parameters→Power Regulator Voltage Scale : Power Regulator Voltage Scale 0
▽SPI設定
タッチパネル付ディスプレイの接続はSPIです。詳細は以前の記事（STM32 SPI接続タッチパネル付ディスプレイを使う）をご参照ください。
※通信速度を上げ過ぎるとタッチ位置をうまく取得できないので、本来はディスプレイとタッチを別々のSPIにした方がよいと思われます。
▽SAI設定
Multimedia→SAI1→SAI A→Mode [Asynchronous Slave] I2S/PCM Protocol にチェック
同SAI B→Mode [Synchronous Slave] I2S/PCM Protocol にチェック
SAI A Data Size : 32 Bits
SAI A FIFO Threshold : Half Full
SAI B Audio Mode : Slave Transmit
SAI B Data Size : 32 Bits
SAI B FIFO Threshold : Half Full
NVIC Settingsタブ→SAI1 global interrupt→Enabledにチェック（2020年3月16日追記）
※STM32H7でDMAを利用するのは大変そうなので、今回は利用していません。
→参考ページ：STM32H7でキャッシュ一貫性を保持したDMA転送(Memory-to-Peripheral)
▽クロック設定図
SAIクロックは、オーディオサンプリングレート44.1kHzに対する誤差が少なくなるような設定としました（44.1×2048＝90316.8）。
▽全ピン設定図
＜信号処理＞
Owm Pedalと同じように半分ずつデータ処理しようとしましたが、HalfCpltCallbackが呼び出されないようなので、2つのバッファ配列を準備しました（下図ではaとb、ソースコード内では[0]と[1]）。
mainInit処理の中で最初のSAI受信呼び出しを行います（HAL_SAI_Receive_IT）。その後、受信完了時にHAL_SAI_RxCpltCallbackが呼び出され、その中で次の受信とSAI送信（HAL_SAI_Transmit_IT）を行います。送受信にFIFOを設定しておかないと、処理が連続的にならず途切れ途切れになってしまうことがあります。遅延時間（レイテンシ）実測値は、ブロックサイズ32で2.5ms程度でした。まとめて信号処理ではなく、1サンプルずつ処理するようなやり方をすればバッファ配列は1つで済むかもしれません。
＜SAIエラー対処＞
Owm Pedalのときの反省を生かし、オーディオコーデックV4220Mをマイコンからリセットできるようにしました。mainInit処理内でSAIのエラーが起こった場合、リセット処理するようになっています。ただ、今のところエラーが発生したことがなく、正しい処理なのかわかりません。
＜スイッチ・タッチ検出＞
SAIの割り込みは32ブロックサイズ（約0.7ms）ごとに起こるので、これをタイマーのように利用しています。割り込みが起こるたびにGPIOの状態をチェックし、スイッチ操作やタッチを検出するというやり方です。タッチ検出時はすぐにタッチ位置を算出したいところですが、SPI通信にそれなりに時間がかかるので、タッチ位置関係処理は割り込み内ではなくメインループ処理内に入れています。現状の操作方法は下記の通りです。
・画面上部：パラメータページ切替、長押しでデータ保存（→STM32 内蔵フラッシュメモリへのデータ保存）
・各ノブ部：上側で増加、下側で減少（長押しで10ずつ変化）
・画面下部：長押しでエフェクト切替
・スイッチ：エフェクトオン・オフ
＜エフェクト処理＞
とりあえず6つのエフェクト（オーバードライブ、ディレイ、トレモロ、イコライザ、コーラス、リバーブ）を実装していますが、細かい音質については検討していません。今後別記事で紹介していきたいと考えています。
Owm Pedal H7 ハードウェア編
STM32F405を搭載した「Owm Pedal」に引き続き、STM32H753とタッチパネル付ディスプレイを備えたデジタルエフェクターを製作しました。今回も穴加工はTabby's工房さんにお願いしました。（Owm Pedal H7 ソフトウェア編はこちら）
▽入出力・電源部 回路図
4回路入りオペアンプOPA1679を使用することにしたので、以前と違い入力部のローパスフィルタが2次になっています。デジタル電源は絶縁型DC-DCコンバータで分離するようにしました。コンバータなしにもできるようにしましたが、ノイズ面でよくないと思われるので非推奨です。
▽マイコン・オーディオコーデック部 回路図
当初はSTM32F722を使っていたのですが、さらなる発展を見据えSTM32H7を使うことにしました。注文時の在庫の関係でSTM32H753にしましたが、STM32H743でも問題ないと思います。今回はオーディオサンプリングレート44.1kHzで、SAIペリフェラルを使います。
▽基板レイアウトについて（KiCadデータはGitHubへ）
上側のマイコン基板は4層にしてみました。JLCPCBの場合、50mm×50mm以内であれば4層でも13ドルで済みます。マイコンは可能な限りピンを引き出していますが、全部は使わないので内側は小さいパッドです。GNDは基本一面プレーンで、基板が2枚に分かれているのでコネクタ部分でGNDを接続することになります。DC-DCコンバータは高さを低くするため寝かせて配置しました。
▽ディスプレイ・スイッチ基板レイアウト
念のためダンピング抵抗を入れています。消費電流がそれなりにあるので、マイコン用とは別に3.3Vを準備しました。ディスプレイの詳細は以前の記事（STM32 SPI接続タッチパネル付ディスプレイを使う）をご参照ください。下写真のように基板を合体させます。
▽周波数特性・ノイズ
ZOOM MS-50Gと特性を比較しました。MS-50GはParaEQを6個並べて+20dBになるよう調節しています。ノイズは1kHz正弦波入力時のものです。
Owm PedalはMS-50Gより高域のノイズが多いように見えますが、MS-50Gはもともと高域が下がっているので、それを加味するとほぼ同じノイズレベルといってよいと思います。Owm Pedal H7では1dB程度ノイズが多いですが原因はよくわかりません。基板設計としては、部品配置に注意すればOwm PedalのようにGNDを1面プレーンにしても問題ないとわかりました。入出力のフィルタも、簡単な1次ローパスフィルタで充分かもしれません。
ZOOM U-22 分解・特性測定
ZOOM U-22というオーディオインターフェイスを購入しました。分解・特性測定を行っておきます。
【分解】
▽中身画像 ZOOM U-22 Handy Audio Interface Gut Shots
以下のICが確認できました。8ピンのオペアンプっぽいICの型番は読み取れませんでした。
・マイコン LPC1820FBD144
・クロックジェネレータ AK8142
・オーディオコーデック TLV320AIC3101
・電源 RT9971
絶縁型DC-DCコンバータを使った電源ではなさそうですがローノイズです。アナログGNDとデジタルGND（と思われる部分）がところどころコンデンサで繋いであるのは、ノイズ対策なのかもしれません。
OUTPUTノブは0.5dB単位で動いているようなのでおそらくデジタル制御です。GAINノブは連続的な動きなのでアナログ回路だと思われます。
※LINE IN使用時GAINノブは無効
【特性測定】
PHONES出力からLINE IN入力へステレオケーブルを接続した状態で特性を測定しました。OUTPUTノブは10です。
Windowsの場合、コントロールパネルのZOOM U-22 Control Panel（またはC:\Program Files\ZOOM\U-22 Driver\zmu22audiocp.exe）から Sampling Rate を 96000 Hz に設定しておきます。
＜PHONE出力＞
最大無歪出力: 約 0.7 Vrms （OUTPUTノブ 10、WaveGene振幅 -5.5dB）
出力インピーダンス: 10 Ω （マニュアルより）
＜LINE IN入力＞
最大無歪入力: 約 0.75 Vrms （CLIP SIGランプが赤に点灯）
入力インピーダンス: 22 kΩ （マニュアルより）
＜WaveGene設定＞
サンプリング周波数: 96000 ビット長: 24 チャンネル数: Stereo
・歪率測定 サイン波 100Hz 1kHz 10kHz FFT用に最適化（FFTサンプル数16384） -6dB
・周波数特性測定 ユーザー波形 FLATSWEEP_016384.WAV -6dB
※WaveGeneサイトにあるサンプリングレート48kHzのユーザー波形サンプルを使っています。本来は96kHz用の波形を用意すべきですが、20kHz以上の周波数も問題ないようなのでそのまま利用しています。
＜WaveSpectra設定＞
Avg: 300
[FFT] サンプルデータ数: 16384 窓関数: なし（矩形）
[再生/録音] フォーマット: 96000 s/s 24 bit Stereo
※DELL製PCでドライバをMMEにした場合、周波数特性が乱れました（別の東芝製PCでは問題なし）。PCやドライバとの相性があるのかもしれません。
▽ノイズレベル（POWER SOURCE: USB）
入力なしの時でも高域にいくつかピークが見えますが、特に問題ないでしょう。電池駆動でもほぼ同じ結果でした。
▽歪率・周波数特性
マニュアルの周波数特性には±2 dB（20 Hz - 40 kHz）と記載がありますが、それよりも良いのではないかと思います。
