事前準備 (2022年度：arduino-cli + VSCode)

M5StickC Plus に、プログラムを書き込むには、おもに以下の方法があります。

Arduino IDE
arduino-cli (Command-Line Interface)
PlatformIO

2021年度は1. の方法を用いましたが、初期設定が若干面倒なのと、エディタの編集機能が弱いので、今年は arduino-cli を用いる方法を推奨します。ただし、arduino-cli はビルドと書き込みのみで、ファイル編集ができませんので、別途エディタとして Visual Studio Code を導入します。余力がある人は、Visual Studio Code に Arduino拡張機能を追加して設定すると、ボタン一つで書き込みできる（Arduino IDEに近い）操作感を得ることができます。

注釈

M5StickC Plusは、2017年に発売されたM5StickC の後継版です。ディスプレイサイズと解像度、バッテリ容量が向上しています。また、ブザーも追加されているため、簡単な音を本体のみで鳴らすことができます。

注釈

UIFlowという、Webベースのブロックプログラミング環境もありますが、本実験では柔軟性と拡張性を重視し、Arduino/arduino-cli を使用します。Arduino/arduino-cli ではC言語でプログラムを記述します。

以下、こまかいですが、

arduino-cli のインストール
arduino-cli でボード情報とライブラリのインストール
サンプルファイルのコンパイルと転送
Visual Studio Code のインストール
Arduino拡張機能の追加と設定

の順に、説明します。

(1) arduino-cli のインストール

arduino-cli をインストールします。

Windows の場合

Git for Windows をインストールしてください。Setup時にいろいろ訊かれますが、すべてそのまま「Next」を押して進めて大丈夫です。
Git Bash を起動して、ターミナルに以下のコマンドを入力してください（図 1 ）。（この下の灰色のテキストエリアの右端の四角アイコンを押すと、コマンドをコピーできます。）
```
curl -fsSL https://raw.githubusercontent.com/arduino/arduino-cli/master/install.sh | sh
```

図 1 arduino-cli のインストールコマンド実行後の画面（例）

Mac の場合

Homebrew パッケージマネージャをまだ入れていない場合は、インストールしてください。ターミナルを開き、以下のコマンドを実行します。
```
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
続けて、ターミナルで、以下のコマンドを実行してください。
```
brew update
brew install git arduino-cli
```

(2) arduino-cli でボード情報とライブラリのインストール

(3) サンプルファイルのコンパイルと書き込み

ここで (2) と (3) を行う準備として、サンプルファイルと設定ファイルを三浦の Git リポジトリからダウンロードします。ターミナル (or Git Bash) で以下のコマンドを実行してください。
```
git clone https://git.istlab.info/git/miura250/M5StickCPlus_FactoryTest2022.git
cd M5StickCPlus_FactoryTest2022
ls -al
```

（cd のあとのフォルダ名が長いので、途中でTabキーを押して補完することをおすすめします。） ls -al の結果は、図 2 のようになります。

図 2 サンプルファイルの中身を確認

以下のコマンドを入力すると、(2) arduino-cli でM5StickCPlusの開発をするための準備として、「ボード情報とライブラリのインストール」を行います。
```
./setup.sh
```

注釈

setup.sh は事前準備のときの 1回だけ実行すればOKです。その後、ライブラリが必要となり、追加でダウンロードするときは、arduino-cli lib install XXXX コマンドを実行してください。

以下のコマンドを入力すると、(3) のサンプルファイル（FactoryTest2022）の「コンパイル」を行います（図 3）。
```
./compile.sh
```

警告

M5StickCPlus本体がない事前準備の段階で、できるのは、ここまでです。 以下の「書き込み」は、本体をUSB接続したあとで、行う作業になります。次のステップとして、(4)のVisual Studio Code のインストールに進んでください。

以下のコマンドを入力すると、(3) の「書き込み」を行います（図 3）。 ただし「書き込み」は、M5StickCPlus本体をUSB接続していないと失敗します。
```
./upload.sh
```

注釈

今後、ソースコード(ここでは、FactoryTest2022.ino)を編集していくと、「コンパイル」と「書き込み」を頻繁に実行することになります。その場合、以下のように && でつなげて1回のコマンド入力でも実行できます。

./compile.sh && ./upload.sh

図 3 コンパイルと書き込み(upload)を行っている様子

(4) Visual Studio Code のインストール

Windows の場合は、Microsoft Store で、Visual Studio Code のインストールができます。Mac の場合は、インストーラーでダウンロードしてください。

(5) Arduino拡張機能の追加と設定

必須ではないですが、できれば次のページを参考に、 Arduino拡張機能の追加と設定をしておくとよいでしょう。

この設定をしておくと、ソースコード編集→保存→右上のボタン　で、書き込みができます。

注釈

この設定をしない場合でも、(3) のコマンドライン（またはシェルスクリプト）を修正・実行すれば、書き込みができます。