本記事について

M5Stackの開発手法は Arduino や UIFlow, PlatformIO等複数ある。
2023/06時点でM5AtomS3の体系的な本はなく、どうやって始めるべきか分からなかった。

とりあえずHelloWorldしたいと思い、
Visual Studio Codeを用いたM5Unifiedの導入方法
をやってみたところ、以下の図のようにHelloWorldすることができた。

多少戸惑うところもあったため、手順ごとに実践したメモを残す。

環境・準備するもの

MacBook Air M2
macOS 13.3
AtomS3
mac と Atom を繋げるための type C ケーブル
VSCode (記事のVSCodeのインストールは省略)

PlatformIO のインストール

参照記事の通りだが、インストールに5分程度かかった気がする(うろ覚え)

プロジェクト作成〜ビルド

プロジェクト作成

参照記事通り

プロジェクトウィザードへの入力

Use default locationのはてなマークは見ておいた方がいい。
デフォルトでは以下のパスに入力した Name でプロジェクトが作られる。

~/Documents/PlatformIO/Projects

Frameworkは最初何も選択できない。しかし、Board で AtomS3 を選択すると Framework から Arduino を選択できるようになる。

事前に Arduino IDE インストールしなくてもいいのかな？と思っていたが必要なかった。

で、Finish を押すとプロジェクトが作られるのだが、5分程度かかった。
(初回だったから何かインストールしてたのかもしれない)

途中で VSCode クリックしたら進行中が消えて何の表示もされなかった。
プロジェクトフォルダは作られていたため、そのフォルダに移動して VSCode を開き直した。

開く時も5分くらいかかった。(ここも何かインストールしてたような感じがある)

VSCodeの出力は以下のようになっていて、一番上の
Resolving m5stack-atoms3 dependencies...に時間がかかった。

Resolving m5stack-atoms3 dependencies...
Already up-to-date.
Updating metadata for the vscode IDE...
Project has been successfully updated!

待てば終わるので放置をすること。

ライブラリをプロジェクトに追加する

参照記事通り。ライブラリのインストールはわりとすぐ終わったと思う

プログラムをビルドする

当たり前といえばそうだが、書き込む前に AtomS3 に type C　ケーブルで mac と AtomS3 を接続する必要がある。

繋ぐと、 AtomS3 の画面に「Wi-fi 接続するためにタッチしてね(うろ覚え)」のようなメッセージが表示されるが無視する。

ビルド・書き込みはすぐおわる。

AtomS3 の画面が小さいため「Hello World!」ではなく「Hello W」になっているのが趣がある。

Serialの確認

PlatformIO の Serial Monitor でデータが送られてくることが確認できなかった。
USBSerialを使用したらできた。

main.cpp

#include <M5Unified.h> // M5Unifiedライブラリをプログラムで使用可能にします。

// グローバル変数（プログラム全体で使用する変数の定義をします。）
uint32_t count;


// setup関数は起動時に一度だけ実行されます。
// 主に初期化処理を記述します。
void setup() {

  auto cfg = M5.config();       // M5Stack初期設定用の構造体を代入
  // configを設定する場合はここで設定
  // 例
  // cfg.external_spk = true;

  M5.begin(cfg);                           // M5デバイスの初期化
  USBSerial.begin(115200);                 // シリアルモニターの初期化
  M5.Display.setTextSize(3);               // テキストサイズを変更
  M5.Display.print("Hello World!!");       // 画面にHello World!!と1行表示
  USBSerial.println("Hello World!!");         // シリアルモニターにHello World!!と1行表示
  count = 0;                               // countを初期化

}

// loop関数は起動している間ずっと繰り返し実行されます。
// センサーから値を取得したり、画面を書き換える動作等をおこないます。
void loop() {

  M5.Display.setCursor(0, 20);              // 文字の描画座標（カーソル位置）を設定
  M5.Display.printf("COUNT: %d\n", count);  // countを画面に表示
  USBSerial.printf("COUNT: %d\n", count);      // countをシリアルに表示
  count++;                                  // countを1増やす
  delay(1000);                              // 1秒待つ

}

参考