はじめに

2022年12月23日にATOMS3が(日本で)発売になり、入手することができたので、Moddable SDKのターゲットデバイスに追加する過程をメモに残します。(2022年12月27日に入手)

以前、M5StickC Plusを追加したことがあったので、おおよその見当はついていましたが、いくつかハマりどころがありました。

開発環境の構築

こちらの記事を参考に、サンプルコードが動作することを確認しました。
M5AtomS3ではなく、M5Unifiedで動作を確認しました。

液晶ディスプレイ(液晶ドライバ)

ATOMS3のMCUはESP32-S3で、扱うのは初めてでしたが、Moddable SDKのターゲットデバイスにESP32-S3-DevKitC、Adafruit QT Py ESP32-S3、Adafruit ESP32-S3 TFT Featherが登録されていましたので、参考にしました。

液晶ディスプレイはGC9107で、こちらも扱うのは初めてでしたが、事前にデータシートにアクセスできたのと、ST7789互換という情報をいただいたので、あまり心配していませんでしたが、結果的に動かすまで一苦労ありました。

仕様調査

ST7789のinitコードでは動作しなかったので、サンプルコードが動作したM5Unifiedのinitコードを確認しました。
実際にはM5GFXの中でinitコードを確認することができます。

そのままのinitコードでは、最初、動かなかったので、同じ液晶ディスプレイを使用しているLILYGO T-QTのinitコードを確認しました。

initコードは似ていますが、部分的に異なっています。また、データシートに記載されていないコマンドコードもあり、解釈が難航しました。(コマンドコードの意味が判明していないものが残りました)
結果的にInter register enable 1 (FEh)、Inter register enable 2 (EFh)のコマンドコードを送るタイミングを調整(遅延の時間を変更)して、動くようになりました。

表示位置のズレは(行方向の)オフセット値を調整し、回転操作(ローテーション)も問題ないことを確認しました。

表示色(色味)のズレ

動作テストも終盤になり、(Node-RED MCU Dashboardの)表示色がおかしいことに気づきました。

(M5Stack FIREは色味が異なっていますが、正面から見ると正常で、見る角度によって色味が変わっています。)

色指定の順番(RGB、BGR)と色の反転(DISPLAY Inversion)を疑い、データシートを参考にして、initコードを変更したところ、問題を解消できました。

M5GFXのinitコード → 色指定をRGB→BGR、DISPLAY InversionをON→OFFへ変更
LILYGO T-QTのinitコード → DISPLAY InversionをON→OFFへ変更

GC9107の設定を追加し、パラメータシート(比較表)を更新しました。

6軸IMU (MPU6886)

最初、M5Atom Matrixと同じ設定をしたところ、Y軸の向きが反転していると指摘をいただきました。

M5StickC Plusで液晶ディスプレイ表示を見ながら動作を確認しました。

setup-target.jsの中でX軸、Y軸、Z軸の向きと値を入れ替えて問題を解消できました。

ついでに、ボタンが1つしかないので、ボタンを押す度にAccelとGyroの表示を切り替えるサンプルコードを作成しました。

さいごに

一通りテストで問題が出なくなったので、プルリク(PR)を送りました！

Moddable SDKのサンプルコード(piu/balls、piu/images)
Node-RED MCUフロー(コアノード、ネットワーク接続)、Sensorノード(I2Cでdefault(GroveポートにM5 ENV Ⅲ Unit)、internal(MPU6886))、rpi-gpioノード(ボタン)、Dashboardノード(ボタン、テキスト、ゲージ)