に示すように，“Hello World”という文字が，M5Stackの液晶ディスプレイに表示されたら成功です．
VIDEO
(a)“HelloWorld.py”と表示される
(b)実験動画
写真4 図13のPythonソースコード“HelloWorld.py”を実行したところ
M5Stackの液晶ディスプレイに“Hello World”という文字列が表示される
1. マイコンに1行ずつソースコードを処理させてみよう
マイコンに“1+1”の計算をお願いする
MicroPythonファームウェアを組み込んだM5StackとパソコンをUSBケーブルで接続して，Thonnyを起動します．するとシェルにプロンプト“>>>”が表示されます(図15 )．これは，M5Stackは，Pythonで記述されたソースコードを受け入れる準備が整っていることを意味します．
図15 M5StackにMicroPythonファームウェアを書き込んだら，Pythonの開発環境 Thonnyを立ち上げる
シェルにプロンプト“>>>”が表示される
最初に簡単なソースコードを入力してみましょう．
図16 に示すように，シェルの“>>>”に“1+1”と書き込んでリターンを押してください．シェルに演算結果の“2”が表示されるでしょう．この“1+1”の演算はパソコン内ではなく，M5Stack内のESP32マイコンが実行したことに注意してください．
図16 初めてのマイコン制御！シェルにM5Stackに“1＋1”を計算させるソースコードを入力してみる
パソコンからPythonで記述されたソースコードがM5StackのESP32マイコンに送り込まれ，ESP32マイコンはこのソースコードをバイナリ・コードに変換して実行しました．そして，演算結果をパソコンに送り返しました．
このように，シェルを使えば，自分の記述した文字をM5Stackに直接送り込んで，ESP32マイコンを操作できます．
整数か浮動小数かを自動判定してくれる
足し算したいときは，例えば“c = a+b”というふうに記述します．a，b，cは，さまざまな値になる代表値なので「変数」と呼びます．さらに，a，b，cが数の場合には数値型変数と呼びます．テキストが変数として入る場合は，文字型変数と呼びます．
数値型変数には次の2種類あります．
どちらを選ぶかによって，マイコンの演算効率が変わるため，通常はコーディングの最初の部分で選択し定義します．しかしPythonは，数値型変数が発生した時点で，数値の状態からどちらの型にするかを自動で判別して定義してくれます．これを「動的型付け」と呼んでいます．例えば，演算する数値に浮動小数が含まれていたり，割り算が含まれていたりしたら，結果の変数は浮動小数点型に自動で選択されます．
Pythonが変数を動的型付けするところを実際に見てみましょう
図17 に示すように，シェルから“a=1，b=1.0”と入力して，ESP32マイコンに，“c=a+a，d=a+b，e=a*a，f=a/a”という演算を実行させてみます．
図17 Pythonは，整数と浮動小数を自動で判定してくれる
M5Stackに整数(1)と浮動小数(1.0)を定義して簡単な計算をさせてみた
cは，1という整数どうしの足し合わせなので，cも整数です．dは，1という整数と1.0という浮動小数の足し合わせなので浮動小数です．結果を見ると，“c=2，d=2.0”となっています．同じように，eは整数どうしの掛け算なので整数です．fは，整数どうしの演算ですが，割り算なので浮動小数になります．結果は，“e=1，f=1.0”になります．
このようにPythonは，整数型か浮動小数型なのかを数値で判断して，変数型を自動的に定義します．
図18 に示すように，シェルの“>>>”から“type(変数名)”と入力すると，整数型は“int”，浮動小数型は“float”と表示され，変数の型を調べることができます．
図18 “type関数”を使うと，変数がどのような型に定義されたかを調べられる
2. マイコンに一括で全ソースを実行させてみよう
続いて，コード・エディタを使って，ソースコードを一括実行します．コード・エディタを使えば，シェルではできなかったソースコードの保存[Save]や読み込み[Open]も可能です．
ソースコードの説明
図19(a) に示すのは，さきほど紹介した“Hello World”を表示するソースコードです．十数行の短いものです．
(a)このように記述すると…
(b)“Hello World”と表示される
図19 コード・エディタを使って記述した一連のプログラムを一括して実行する
液晶ディスプレイに“Hello World”という文字列を表示するプログラムを一括処理する．“display”モジュールをインポートして初期設定を行った
1～4行目の’’’～’’’で囲んだ部分は自分用のメモです．M5Stackはこの部分を無視します．Python系の言語では，プログラム処理に関係しないコメント文をプログラム内に記述できます．
5行目は，ディスプレイを制御する関数モジュール“display”を読み込んでいます(インポートという)．5行目の“#”もコメント命令です．#”以降がコメントです．
6～9行目は，M5Stackの液晶ディスプレイの表示モードの設定です．initメソッドを使って，ディスプレイの種類やESP32マイコンとの接続ピン番号などを設定します．意味は次のとおりです．
液晶ディスプレイの種類(tft.M5STACK)
液晶ディスプレイにつながるマイコンのGPIO端子の番号
bgr(カラー・コードの種類)
back_l(バックライトのON/OFF)パラメータ
文字や絵など，実際の表示情報は，10～12行目の3行で指定します．
10行目のtft.clear()メソッドで画面の文字や絵をすべて消します．
11行目で表示するフォント(tft.FONT_DejaVu24)の設定を行います．
12行目で(80，100)の位置に，“Hello World”という文字を表示します，デフォルトの文字色は緑色ですが，“Hello World”の後ろに“,tft.設定色”を追加すると，文字の色を変えることができます．
コード・エディタとシェルの併用
Thonnyのシェルを使うと，コード・エディタでPythonプログラムを実行した後に，ソースコードを追加して実行することができます．
“Hello World”をディスプレイに表示するプログラム[図19(b) ]を実行した後に，図20(a) に示すように，シェルから追加で文字表示する命令を実行すると，図20(b) のように．“Hello World”の下に“MicroPython”と言う文字列が追加されます．
(a)このように記述すると…
(b)“Hello World"の下に“MicroPython”という文字が追加される
図20 シェルを使うとコードを追加できる
開発環境Thonnyのコード・エディタでいったんプログラムを実行したあと，シェルを使ってプログラムを追加実行できる
3. M5Stackにsinやlogなどの計算をさせてみよう
ソースコードの冒頭で「関数ライブラリを読み込め」と宣言する
Python系言語では，sinやlogなどの関数を集めたものを「モジュール」と呼んでいます．同様にMicroPythonファームウェアも，モジュールを備えています．
図21 に示すように，シェルから“help('modules')”と入力すると，Pythonが標準で備えているモジュールの一覧が表示されます．
図21 Pythonが備えるモジュールのいろいろ
Pythonでは関数を集めたプログラムをモジュールと呼ぶ．シェルに“help('modules')”と入力すると，Pythonが備える標準モジュールの一覧が表示される．ソースコードの冒頭にインポート文を記述すれば利用できる
これらを使うときは，ソースコードの冒頭でimport命令を使って宣言します．モジュールを宣言しないで，関数を使おうとするとエラーが出ます．
マイコンにsinの計算を実行させる
数学関数モジュール“math”をimport命令で宣言し，mathモジュールにある“sin”を使ってみましょう．シェルでmathモジュールをインポートして，sin(π/2)を計算します．
図22(a) では，数学関数モジュール“math”をインポートしています．sin()はメソッドで，sin(π/2)は“math.sin(math.pi/2)”と記述します．()の中で，もう一度，mathモジュールを呼び出して，piメソッドを利用して3.14を得ています．
(a)演算モジュール“math”を読み込んで，sin(π/2)を計算せよ」と入力してみた
(b)モジュールを読み込まずに，Sin(n/2)を計算させようとするとエラーが出る
(c)このように命令を記述することもできる
図22 Pythonが備える数学関数モジュールを使ってみる
モジュールは“import”命令を使って呼び出す．この前処理をしないでメソッドを実行するとエラーが出る
実行すると，M5Stackが計算を実行して，シェルに“1.0”という答えを帰してきます．一度リセット[STOP]を押して，再度sin(π/2)を計算してみてください．
mathモジュールをインポートしないで，sin(π/2)を計算を実行すると，図22(b) のようにエラーが発生します．MicroPythonでは，[STOP]アイコンを押していったんインタープリタ処理を停止させると，今までインポートしたモジュールはすべて破棄されます．この状態になると，mathモジュールのsinメソッドはもう使えません．使うとエラーが発生します．
モジュールをインポートする方法はほかにもあり，図22(c) に示すように「from モジュール名 import 関数名」というふうにも記述できます．“from math import sin,pi”と記述して，モジュールの中で必要なメソッドだけをインポートすると，モジュール名が省略されソースコードが見やすくなります．例えば，sin関数は“sin(pi/2)”というふうにシンプルに記述できます．
MicroPythonモジュールの使い方の詳細は，loboris/MicroPython公式ホームページが参考になります(図23 )．
図23 MicroPythonファームウェアで使用できる命令の使い方や実行例は，loboris/MicroPythonホームページで参照できる
プログラミングで壁にぶつかったとき頼りになる
4. M5Stackが計算した結果をThonnyで取り込んでグラフ化してみる
図24(a) は，mathモジュールのsin関数を使ってsin波形の表示を行うPythonのソースコードです．
(a)ソースコード
(b)計算結果
図24 M5Stackにsinを計算させてみた
“print( )”を使うと，シェルに演算結果が表示される．さらにThonnyのPlotter機能を使うと波形も表示される
1行目で，演算関数モジュール“math”と時間管理モジュール“utime”をインポートします．
2行目では，for文を使って，0～360°まで15°ずつ変化させています．
3～5行目のインデントされた部分は，処理が繰り返されます．3行目でsinの値[°]を計算します．sinを計算するときに，math.radians ()関数を使って角度[°]をラジアン[rad]に変換します．print関数を使って演算結果(5行目)をシェルに表示します．文字列フォーマット’{0:1.3f}’.format(y)を使って，シェルに表示する数値の桁数を制限しています．
文字列フォーマットは，表示する数値を見やすくするときに使います．文字列フォーマットで用いる“1.3f”は，浮動小数型数値を整数部1桁，小数部3桁の形にすることを意味しています．
4行目で0.2秒間の停止(スリープ)を命令しています．これは，Thonnyが波形をプロット表示し終えるまでの待ち時間です．Thonnyの[View]-[plotter]と選ぶと，シェルに表示された数値をもとに波形が表示されます．
5行目の“print”と書くことで，M5Stackは0～360°まで15°きざみで計算をして結果をシェルに送り返してきます．
Thonnyには，シェルに表示された数値をグラフ化する機能“Plotter”が備わっています．Thonnyの起動画面にて，[View]-[Plotter]を選ぶと起動します[図24(b) ]．
5. マイコンの入出力端子を制御して電気信号を出し入れしてみよう
周辺回路と信号を入出力するための関数を使う
パソコンやスマホが搭載するCPUと異なり，マイコンには電気信号を入出力する多くの周辺回路「ペリフェラル」が備わっています．
H/L信号を入出力できる汎用端子(GPIO，General Purposer Input Output)
A-Dコンバータ，D-Aコンバータなどのアナログ信号の入出力回路
I$^2$C，SPI，UARTなどの規格化されたデータ通信制御回路
Pythonには，これらのペリフェラルを動かすために，“machine”モジュールというライブラリが備わっています．
M5Stackのボタンを押すと，シェルに“Button A”と表示されるプログラムを作る
(a) に示すように，M5Stackは3つの押しボタンを装備しており，これらは，M5Stackの内部でESP32マイコンのGPIO端子(GPIO37～GPIO39)に接続されています[図25(b) ]．
(a)外観
(b)M5Stack内部の回路
図25 M5Stackの押しボタンとESP32マイコンの接続
M5Stackの押しボタンはESP32マイコンのGPIO端子に接続されている．GPIOピンの変換を読み取ることで，ESP32マイコンはボタンが押されたかどうかを判断する
各ボタンと連動するスイッチ回路は，3.3V電源にプルアップされた状態でESP32マイコンの各GPIO端子に接続されています．ボタンのスイッチを押さないと，GPIO端子には3.3V，つまりHレベル(1)が入力されます．ボタンを押すと，GPIO端子には0V，つまりLレベル(0)が入力されます．マイコンは，GPIO端子の電位をチェックすれば，ボタンが押されたかどうかを判断することができます．
ソースコードの説明
図26(a) に，Button Aが押されたかどうかを検出するソースコードを示します．Button Aを押すと，シェルに“Button A”と表示されるプログラムです．押していない間は“No Push”と表示されます．
図26 押しボタンが押されたかどうかを検出する関数“machine”
ボタンAに接続されたGPIO端子(39ピン)のH/Lを0.1秒ごとに調べて，ボタンが押されたと判断したらThonnyのシェルに“Button A”と表示する
1行目で，machineモジュールのPinメソッドをインポートしています．この記述で，M5StackはButton Aに接続されているGPIO端子(39番ピン)の状態を読みに行きます．
2行目で，時間を管理のutimeモジュールをインポートしています．
3行目で，ボタンAの信号をGPIO39ピンで取得するための設定を行います．
4行目以下は，while文を使って，5～9行目を延々と繰り返します．走り出したら止まらない設定です．5～9行目を延々と繰り返します．
5～9行目は，if～else文を使ってボタンが押されたか，押されていないかを判断して，処理を切り換えています．ボタンAが押されると0，つまり“L”になるので，5行目のif文で判断して，6行目のシェルに“Button A”と表示する処理を行います．それ以外は“No Push”と表示します．シェルに“Button A”を表示するときは，“＼ｒ”を使って左に詰めて表示し，“end=’ ’”を使って改行を行い，命令を付け加えます．
このような処理を行うと，毎回シェルの同じ場所に表示されるようになり，見やすくなります．ボタンAが押されていない場合は，else文以下の表示が行われ，“No Pμsh”が表示されます．
if～else文が終了すると，0.1秒スリープして(9行目)，再び5行目に戻り，同様の動作を繰り返します．このように一定時間ごとにボタン状態を見に行く制御方法を「ポーリング方式」と呼びます．
処理の繰り返し
特別な処理を記述しなければ，プログラムは上から下に向かって順次実行されます．
「制御文」を使うと，その流れを変えることができます．例えば，同じ処理を複数回繰り返したり，条件によって演算処理を切り換えたりできます．ボタンAが押されたらプログラムAを起動し，ボタンBが押されたらプログラムBを起動するということができるのです．センサの計測値によって，演算式を切り換えることも可能です．
よく使う制御文は次の3つです．
①for文 ②while文 ③if文
これらを上手に活用すると，プログラムで複雑な動作を実現できます．
①for文
図27 に示すのは，決められた処理を複数回繰り返したいときに利用するfor文の基本型式です．「変数」に「範囲」の値が順次代入され，「処理文」に記述した命令が繰り返されます．連続した範囲を表す方法としてよくrange関数を用います．
range(stop)
range(start,stop[,step])
range関数の表記方法は上記の2とおりです．引数“step”は省略でき，省略すると1と自動的に判断されます．
図27 繰り返し命令for文の書き方
制御文で変数の範囲を示し，処理範囲の命令を繰り返す．処理部はインデントを設けて，繰り返す範囲を明確にする
図28 ～図30 は，for文を用いた繰り返し動作のプログラムの例で，range関数を使って変数iの範囲を決めています．range関数の表記方法は，
図28 for文を使ったプログラムの記述例 ①
繰り返し命令for文の変数の指定にはrange関数を使うと便利
図29 for文を使ったプログラムの記述例 ②
range関数にはrange(stop)とrange(start,stop[,step])の2通りの記述方法がある．条件に合わせて記述する
図30 for文を使ったプログラムの記述例 ③
range関数の引数stepを－1に設定すると，変数をカウントダウンできる
図28 と図29 はどちらも，変数iに，0から4まで1ずつ増す値が入力されつつ，“print(i)”を5回繰り返すプログラムです．
“range(start, stop, step)”の“step”を省略すると，“step”は自動的に1が代入されます．図30 に示すように，“step”に-1を代入すると，“start”の値が1ずつ減少します．
図29 は“range(start,stop[,step])”という文法を使った記述です．変数の範囲は同じく“0，1，2，3，4”です．
図30 の“range(5,0,－1)”も，“range(start,stop[,step])”の表示方法です．Stepが－1になっていて減少を表します．変数の範囲は“5，4，3，2，1”です．
制御文の行の最後に“：(コロン)”を付けると，次の行以降からインデントが挿入されます．インデントをやめるまでの部分に記述された命令が処理範囲になります．
C言語では，処理範囲を“中括弧｛ ｝”で記述します．Python系言語のインデントはC言語の｛ ｝と同じ意味合いですが，C言語よりも少ない行数で記述できます．
②while文
図31 に示すのは，ある決めた条件が満たされたら，特定の処理を繰り返すwhile文の基本型式です．「条件式」に記述した内容が満たされている(True)なら，「処理」に記述した内容が実行されます．条件式が満たされていない(False)なら，処理部分は実行されません．インデントを挿入した行からやめた行までが処理範囲と判断されます．
図31 While文の書き方
続けて記述した条件が真(True)なら，処理範囲で指定した命令文を繰り返し実行する
表2 に，条件式に記述できる比較演算子を示します．処理部分を繰り返す条件を自由に設定できます．andやorなどの論理演算子を組み合わせれば，複数の条件を組み合わせることも可能です．
表2 while文の条件式に使用できる比較演算子のいろいろ
andやorなどの論理演算子を使って複数の比較演算子を組み合わせることもできる
図32 に示すのは，シェルに表示された数字が1ずつ大きくなるカウントアップ・タイマのソースコードです．while True制御文は，いったん処理が始まると，Thonnyの[STOP]アイコンを押して強制終了しないと止まりません．
(a)ソースコード
(b)実行結果
図32 While文で記述したカウントアップ・タイマ
数字(t)が0から1ずつ大きくなっていくプログラム．while文の条件式が真(True)の場合，whileループ範囲を実行する．ここに示すプログラムは，条件式がTrueになっているため，リセットを掛けるまで無限に制御範囲を実行する
1行目で，時間管理のutimeモジュールをインポートしています．
2行目で，“t=0”と値を決めて，3行目以降はwhile文で以下4～6行目を繰り返します．while文の条件式はTrueなので，延々とループを繰り返します．
4行目で，tに1を加算して，5行目でシェルに表示します．1秒待ってまた1を加算してシェルに表示します．シェルに表示する際は，“＼r”と“end=’ ’”という記述を追加しているため，いつもシェルの同じ場所に数字が表示されます．
③if文
図33 に示すのは，条件によって処理の内容を切り換える制御文の基本型式です．
図33 if文の書き方
if～elif～elseの形で記述する．条件式には，while文で紹介した比較演算子や論理演算子が使える
“if”，“elif”，“else”の3つの予約語を使います．ifやelifの後に記述した「条件文」に合致したら，次の行の「処理」を実行します．制御文の最後には必ず“：(コロン)”を添えます．コロンを付けた次の行から，インデントを挿入して「処理」を記述します．インデントを挿入した行からやめた行までが処理範囲と判断されます．
図34 に示すのは，数字を大きさで仕分けするプログラムです．Thonnyの実行ボタン「▶」を押すと，80以上ならA，50～79ならB，49以下ならCというふうに乱数の大きさが分類されてシェルに表示されます．
(a)ソースコード
(b)実行結果
図34 if文の記述例
乱数関数を使って発生した数値をランク付けするプログラム
プログラムの説明
1行目で，0～100の数字のように乱数を発生させるモジュールrandomモジュールをインポートしています．
2行目で，0～100までの整数をランダムに発生させる変数 n を設定しています．
3～8行目で，if～elif～else文を使って，変数nの値をA，B，Cにランク付けしています．
3行目で，80以上はA，5行目で80未満で50以上をBと判断しています．
7行目のelseは，3行目と5行目で該当しない場合にCになります．
関数をカスタム定義する「def文」
よく使う一連の処理を関数にして登録しておくと，プログラムがシンプルで見やすくなります．またシェルに，登録しておいた独自関数を1行記述して呼び出すと，本来複数行を要する処理が一括で実行されます．
図35 に独自の関数を定義する制御文「def」の基本形式を示します．
図35 独自の関数を定義するときに使うdef文の書き方
関数を実行するときに複数の引数を受け渡すことができる．関数内で処理した値を戻り値として返すこともできる
図36 に示すのは，M5Stackの液晶ディスプレイに表示された数値が1ずつ小さくなるプログラムです．
図36 独自の関数「カウントダウン・タイマ」を作ってみよう
プログラムの説明
1行目で，表示用の“displayモジュール”と時間を管理する“utimeモジュール”をインポートします．
2行目でディスプレイを使用する設定を行います．
3～6行目は，次の4つを設定します．
表示モジュールの使用するディスプレイの型
画面の大きさ．デフォルト値(width=240，height=320)を使うなら省略可
ピン番号
パラメータ
7行目で表示するフォントの大きさなどを指定しています．“dist”が大きさを変える変数です．今回は7セグメント数字を使います．
7セグメント文字の大きさは，引数のdistとwidthの数値で設定できます．
8行目から12行目までは関数の定義です．
8行目は，カウントダウン関数“cd(n)”です．括弧の中のnは，関数内で演算に使用するために引き渡す値です．引数はいくつでもOKです．今回はcだけです．その処理の内容は，続く9～12行目にfor文を使って，引数で引き渡されたnから1ずつ減らす，というふうに記述しています．
10行目ではディスプレイの表示を消しています．
11行目では，(120，80)の位置に変数iを7セグメントのフォント文字で表示します．
12行目の“utime.sleep(1)”は「1秒停止せよ」という命令です．1秒間スリープして変数iが0になるまで繰り返します．この行まではすべてモジュール設定や関数定義です．
実際のメインのプログラムは，13行目のcd(10)だけです．cd(10)が実行されると，関数cdが呼び出され引数n=10として関数に引き渡され，そして関数cdの動作を行います．
写真5 にプログラムを実行したところを示します．処理が終わると，シェルにプロンプト“>>>”が表示されます．
VIDEO
(a)カウントダウン・プログラムを実行する
(b)実験動画
写真5 図36のプログラムを実行したところ
シェルからカウントダウン・タイマcd()を実行したところ
フルカラー電飾リング「NeoPixel」を光らせる
数珠つなぎの16個のLEDの色や点灯を自在に制御する
写真6 に示すのは，複数のフルカラーLEDを実装した電飾モジュール「NeoPixel」です．1個のフルカラーLEDチップ(WS2812B，Worldsemi製)は，赤色，緑色，青色の3個のLED素子と，シリアル・データ通信とLEDの点灯を制御する回路が一体になっています．このチップを複数個搭載したテープ状，リング状，パネル状のものが製品化されています．
写真6 LEDチップがたくさん実装され，色とりどりに輝く電飾デバイス NeoPixel
赤，緑，青のLED素子と制御回路を内蔵したカラーLEDチップを複数搭載している
ESP32マイコンから，シリアル・データを送り込むことで，点灯させるLEDを指定したり，そのLEDの色や輝度を変えたりできます．
Pythonは，NeoPixel専用のライブラリを標準で備えています．マイコン・ビギナの第一歩といえば「Lチカ」ですが，ここでは「Neoピカ」をやってみます．
M5Stackから全16個のLEDチップに点灯制御データを配る
図37 に，M5StackとNeoPixelに搭載されている16個のカラーLED “WS2812B”との接続を示します．
図37 M5StackとNeoPixelの電気的な接続
WS2812Bは，VDD，Dout，VSS，Dinの4つの端子を備えています．16個の各LEDチップのDout端子とDin端子は，シリアルで数珠繋ぎになっています．つまり，1番目のLEDチップ(LED1)のDout端子は次段のLEDチップ(LED2)のDin端子に接続されています．続くLEDチップも同様に接続されています．最大1024個のLEDを接続できます(今回は16個)．
図38 に示すのは，16個の各LEDチップに配信される制御データのタイミングです．
図38 NeoPixelの全16個のLEDチップに配信される制御データ
各LEDチップには24ビット・データ(GRBの順で各8ビット)がシリアルで配られる．M5Stackから，1番目のLEDチップのDin端子に制御信号をシリアルで入力する．最初の24ビットは1番目のLEDが抜き取り，残りを2番目のLEDに送る．2番目以降のLEDも同じ動作をする
1つのLEDチップに，赤色(8ビット)，緑色(8ビット)，青色(8ビット)の点灯制御データ(全24ビット)を用意して配ります．LED1は，Din端子から入力されたシリアル・データの先頭24ビット分を自分用に取り込みます．残りをDout端子からLED2のDin端子に向けて送り出します．LED2も同様に，先頭の24ビットを自分用に取り込み，残りをLED3に送り出します．WS2812Bは，24ビットのデータを解釈して，赤色，緑色，青色の各LEDの輝度を調節します．
M5Stackから送出する，16個のLEDの点灯制御データの間隔は50μs以下にします．間隔が50μs以上になると，WS2812Bが「データの転送動作は終了した」と判断して，送られてくるデータを次のLEDに転送する処理を停止します．
実験① LED1を赤色に光らせる
[手順1]ハードウェアの準備
図37 に示したように，3本の配線を使ってM5StackとNeoPixcelを次のように接続します．写真7 に外観を示します．
NeoPixelのVSS端子とM5Stackのグラウンド(GND)
NeoPixelのVDD端子とM5Stackの5V
NeoPixelのDin端子とM5StackのGPIO端子(22番ピン)
写真7 M5StackとNeoPixelを接続したところ
前述のようにPythonは，NeoPixelの各LEDチップにシリアル・データを配信する専用の命令を“machine”モジュールのメソッドに備えています．
[手順2]ソースコードを記述する
ハードウェアの制御ライブラリ「machineモジュール」をソースコードの冒頭で呼び出し(インポート)ます．続けて，制御命令(メソッド)を使って引数を指定することで，点灯させたいLEDの位置番号を選んだり，色を付けたり，明るさを調整したりすることができます．
図39 に示すのは，LED1を赤色に光らせるプログラムです．
図39 1番のLEDチップを赤色に，2番目を緑色に…というふうに点灯させてみよう
赤(R)，緑(G)，青(B)の光量のバランスを変えると，紫色や黄色などの中間色で光らせることができます．LEDの制御命令は，“set(pos，color)”メソッドで指定します．“pos”は，LEDの位置番号を示す引数です．今回使ったNeoPixelは16個のLEDチップを備えているので，1～16の整数値になります．引数“color”には，RGBカラー・コード(#rrggbbの形式)を入力します．これは，赤(8ビット，0～255)，緑(8ビット，0～255)，青(8ビット，0～255)の各光量を表す24ビットの値です．
よく使う色は，“np.指定職”を使って簡単に設定できます．次の15色が定義されています．BLACKは消灯を意味しています．
WHITE，LIME，BLUE，YELLOW，CYAN，MAGENTA，SILVER，GRAY，MAROON，OLIVE，GREEN，PURPLE，TEAL，NAVY，BLACK
プログラムの説明
1行目で，自作ハードウェア制御モジュール“machine”と時間管理モジュール“utime”をインポートします．
2行目は，NeoPixelを制御する関数(メソッド)を呼び出しています．「NeoPixelの16個のカラーLEDの制御線は，ESP32マイコンのGPIO22端子に接続されているよ」と，M5Stackに教えています．
この設定を行うと，16個の全LEDに「消灯せよ」という命令が自動的に配られます．これは“np.clear()”メソッドと同じ処理です．
3行目の“utime.sleep_ms(1)”は「1ms間プログラムを静止せよ」という命令です．16個の全LEDチップに制御信号を送られるまでに数百μsかかるため，NeoPixelに命令を送った後，1ms程度の待ち時間を設けます．
4行目では，1番目の位置のLEDに赤色の制御データを送ります．
プログラムが終了すると，1番目のLEDが赤く光ります．この状態のまま[STOP]アイコンを押さなければ，インポートしたモジュールやNeoPixelの設定はアクティブ状態が保たれるので，シェルからnp.setメソッドを使って各位置LEDの色を設定できます．
[手順3]やってみよう
図39 に示すプログラムを動かして，Thonnyのシェルから次のコマンドを入力してください．“>>> np.set(1，np.指定色)”の記述を書き換えると，LED1の発光色が変化します(写真8 )．同様にシェルを使って，LED2やLED3の色を変化させてみてください．
写真8 図39のソースコードを実行したところ
LED1，LED3，LED5が赤色に，LED2，LED4が緑色に光る
動画1 は，1番のLEDの色を赤や緑色に変化させる実験動画です．
VIDEO
動画1 M5StackでNeoPixcelの1つのLEDチップを赤色や緑色，青色に光らせる
続いて，for文を使ってソースコードを記述して，16個の全LEDを好きな色に点灯させてみましょう．図40 に示すのは，奇数番号のLED(LED1，LED3，LED5…)を赤色に，偶数番号のLED(LED2，LED4…)を緑色に点灯させるプログラムです(写真9)．
図40 奇数番号のLED(LED1，LED3，LED5…)を赤色に，偶数番号のLED(LED2，LED4…)を緑色に点灯させるプログラム
VIDEO
(a)NeoPixcelの16個の全LEDを赤色，緑色というふうに交互に点灯させる
(b)実験動画
写真9 図40のソースコードを実行したところ
プログラムの説明
1行目で，machineモジュール，utimeモジュールをインポートし，NeoPixelの初期設定を行っています．
3行目で，プログラムを1ms間休止させます．NeoPixel初期設定に数百μsかかるからです．
4～8行目では，for文を使ってNeoPixelに色設定データを送っています．for文は“range(start,stop,step)”関数を使って変数iの範囲を指定します．startには1，stopには16，stepには2，変数iに1，3，5…15という奇数が入ります．
5行目で奇数番目の位置のLEDを赤色にセットし，7行目で偶数番目の位置のLEDを緑色に設定します．6行目と8行目の1ms間の停止は，NeoPixelの全LEDチップに制御データを配る(数百μs)のを待っています．
実験② LEDを1個だけ点灯させて時計方向に回転させる
前述のとおり，LEDの発光は“set(pos，color)”メソッドで制御できます．
メソッドの第1引数(pos)は，LEDの位置番号です．LED1を点灯させたいときは“pos=1”，LED16を点灯させたいときは“pos=16”と記述します．
図41 に示すのは，まずLED1を赤色に点灯させ，続けてLED1を消灯して，LED2を赤色に点灯させ，これを繰り返すプログラムです．for文を使って引数“pos”を1から16まで変更します，“pos”が16になったら，また1に戻します．実験結果を写真10 に示します．
図41 1個のLEDを点灯させて時計方向に回転させるプログラム
for文を使う
VIDEO
(a)点灯するLEDが時計方向に回転する
(b)実験動画
写真10 図41のソースコードを実行したところ
プログラムの説明
1～3行目までは，NeoPixelの初期設定です．
4行目で，“while 1：”と記述して，whileの制御文を常に1(True)に設定しています．これで，いったん走り出したら止まらなくなります．
5行目以降は，変数iの値をrange関数で1～16まで変化させるfor文です．6～9行目のインデントされた部分がfor文が有効な範囲です．
6行目のnp.clearメソッドで，16個すべてのLEDを消します．1ms停止した後，8行目でfor文の変数i番目のLEDを赤色に光らせます．
この状態で0.2秒間停止して，6行目のfor文の最初の動作に戻ります．変数iが16になったら一連の動作が終了します．whileの条件文が1なので，最初からfor文が繰り返されます．いったん走り出したらもう止まりません．
実験③ LEDを1個だけ点灯させて反時計方向に回転させる
実験②は，LED1，LED2，LED3というふうに光るLEDを時計方向に移り変わらせました．これを逆回転，つまり反時計方向に回転させてみます．
実験②では，“for i in range(1，17，1):”と記述して，発光するLEDを1番から16番に1つずつカウントアップしていましたから，これを“for i in range(17，1，－1):”に書き換えてカウントダウンすればよさそうです．
間違ったプログラム
図42 のように“for i in range(17,1,－1):”とシェルに記述してリターンを押してください．インデントが自動的に挿入されるので，print(i)命令を記述して，変数iをシェルに表示して確認します．インデントが挿入される制御文の処理範囲を確定させると，勝手にfor文が起動して変数iが表示されます．
図42 LEDを1個だけ点灯させて反時計方向に回転させるプログラム(未完成版)
LED1が消えたままになっている
iは16から1になるのだろう，と期待していたのに，17から2に変化していました．これではLED1は消えたままです．
正解のプログラム
図43 に示します．“for i in range(16，0，-1):”と記述します．図41 のソースコードとほぼ同じですが，5行目のfor文のrange関数の引数が違います．
図43 LEDを1個だけ点灯させて反時計方向に回転させるプログラム(完成版)
位置を示す変数iを16から1にカウントダウンする
range関数の引数をstart= 16, stop= 0, step= -1 に設定すると，for文の変数iが“16，15，…2，1”というふうに－1ずつ減り，LEDの発光位置が反時計方向に回ります．
実験④ M5Stackのボタンで発光色を変える
ボタンが押されたら関数を指定して起動する
M5Stackが備えるAのボタンを押したら全LEDが赤色に，Bのボタンを押したら全LEDが緑色に，Cのボタンを押したら全LEDが青色に点灯するプログラムを作ってみましょう．
図44 にソースコードを，写真11に実験のようすを示します．
図44 M5Stackの3つのボタンで発光色を変えるプログラム
A，B，Cの各ボタンが押された信号をトリガとして，赤色，緑色，青色の指定色を発光する関数を駆動する
(a)Button Bを押すと，NeoPixelの全LEDが緑色に光る
VIDEO
(b)実験動画
写真11 図44のソースコードを実行しButton Bを押したところ
全LEDが緑色に点灯する
プログラムの説明
1～11行目は，モジュールのインポート文やボタンが押されたときの動作を定義する制御文です．15～17行目は，ボタンが押されたときの動作を記述しています．
1行目で，machineモジュールと utimeモジュールをインポートします．
2行目の“from…”の箇所で，machineモジュールのPinメソッドをインポートします．
3行目と4行目で，NeoPixelを制御できるように設定します．
5～10行目はボタンが押されたときに実行する関数を定義しています．ボタンAが押されたときは関数BtA(p)，ボタンBが押されたときは関数BtB(p)，ボタンCが押されたときは関数BtC(p)が実行されます．各関数の引数pは，押されたボタン状態の情報が入っています．引数pから押されたボタンの情報を取り出して，関数の内部処理に使うこともできます．今回は使用しません．
各ボタンが押されたときに光る色を引数として，color(設定色)関数を実行するです．color関数の引数で設定色を指定すると，NeoPixelの16個のLEDがすべて設定色で光ります．
11～14行目はcolor関数の記述です．
11行目でcolor関数を定義します．引数は1つでc(設定色のカラー・コード)とします．12行目のfor文を使って，16個すべてのLEDに引数cのカラー・コードを設定データとして送ります．
15～17行目は，A，B，Cの各ボタンのON/OFF状態をマイコンのGPIO端子に伝えて，ボタンが押されたら，プログラムの処理に割り入って指定の関数を処理するように設定しています．ハードウェア端子でソフトウェア処理の流れに割り入ることを「外部割り込み」と呼びます．この方法を利用することで各ボタンの端子を常時監視する必要がなくなります．
15行目は，ボタンAがつながるピン番号(39)，ピンの使用モード(入力：Pin.IN)を設定しています．割り込み設定を行う時はピン設定以外に“handler”と“trigger”の引数を設定します．
GPIOピンの2つの引数“handler”と“trigger”を使って初期設定すると，ボタンが押されたことをマイコンが検知するようになります．“handler”は，割り込みが発生したときに呼び出す関数(BtA)です．“trigger”は，トリガをかける条件を設定する引数です．“trigger=Pin.IRQ_RISING”と記述すると，信号が立ち上がったとき，つまりボタンから指が離されたときにトリガをかける，というふうに動作します．“handler”は，トリガ検出後に起動する関数を指定しており，A，B，Cの各ボタンごとに変えています．
参考文献・ウェブサイト
M5STACKホームページ https://m5stack.com/
MicroPythonホームページ https://micropython.org/
Lobo MicroPythonウェブサイト https://github.com/loboris/MicroPython_ESP32_psRAM_LoBo/
Espressif Systems社ホームページ https://www.espressif.com/
シリコンラボラトリーズ社ホームページ https://www.silabs.com/
Thonnyホームページ https://thonny.org/
WS2812Bデータシート，Worldsemi．http://www.world-semi.com
(c)2021 Uta Taguchi All Right Reserved.
