Developers_プログラム作成・VMコンパイル・書き込み - gfd-dennou-club/mrubyc-esp32 GitHub Wiki
はじめに
マイコンで mruby/c を使う場合,マイコンの開発環境に mruby/c 関連のソースを加えて,VM をコンパイルすることになる. 本リポジトリでは,ESP32 マイコンの公式開発環境 (ESP-IDF 環境, C 言語) のソースツリーに mruby/c 関連のソースコードを 加え,C 言語と mruby/c コードを一緒にコンパイルしている.この時,メインプログラムはあくまで C 言語側である. なお,Ruby では RubyGems, mruby では mrbgems としてそれぞれライブラリ管理の仕組みが存在するが, mruby/c では同等な拡張ポイントはない.
本リポジトリのディレクトリ構造は,ESP-IDF の標準形に準拠している. main 以下に C 言語のファイル,components 以下にユーザの拡張ライブラリを置くことになっているため, mruby/c の VM を make するためのソースコードは components 以下に置いている. また,本リポジトリ独自の mruby/c ソースを置くためのディレクトリとして mrblib を用意している.
$ tree -L 4 iotex-mrubyc-esp32/
mrubyc-template-esp32/
├── Makefile
├── bin 実行ファイル
├── components 外部リポジトリから取り込んだソースの置き場
│ └── mrubyc mruby/c の VM のソースなど
..........(中略)...............
├── main C 言語のソース置き場
│ ├── component.mk
│ └ mrbc_esp32_gpio.c
│ └ mrbc_esp32_gpio.h
..........(中略)...............
│ └── main.c メインプログラム (C 言語側)
└── mrblib リポジトリ独自の Ruby ソース置き場 (クラス定義)
│ ├── adc.rb
│ ├── gpio.rb
..........(中略)...............
└── src メインプログラム (Ruby 側)
├── master.rb
└── slave.rb
環境設定
VM のコンパイルとマイコンへの書き出し
リポジトリをクローンする.
$ git clone https://github.com/gfd-dennou-club/mrubyc-esp32.git
$ cd mrubyc-esp32
ESP-IDF の環境変数を export する.上記の通りにインストールしていれば ~/esp/esp-idf/export.sh に 環境変数設定用のスクリプトが存在する.別のディレクトリに esp-idf をインストールした場合には, ~/esp/esp-idf の部分を適切に書き換えて欲しい.
$ source ~/esp/esp-idf/export.sh
make menuconfig で "Serial flasher config" と "mrubyc-esp32 Configuration" の項目を確認してから,make, make flash する.
$ make menuconfig
"Serial flasher config" において,ESP32 マイコンのデバイス名を指定する.
"mrubyc-esp32 Configuration" において,ESP32 マイコンのどの機能を有効にするか選択する (動作確認の時は特に変更する必要はない).
make コマンドで VM がコンパイルされる.
$ make
make flash コマンドで VM がマイコンへの書き込まれる
マイコンの書き込み
$ make flash
プログラムの作成と実行 [シングルタスク]
メインプログラムは master.rb に設置する. 以下は "Hello World" を定期的に表示するだけのプログラムとなっている.
$ cat src/master.rb
while true
puts "Hello World!"
sleep 5
end
make spiffs で master.rb をコンパイルしてマイコンに書き込む. さらに,make monitor でモニタ出力,を行うことができる. モニタ出力を止めるときは Ctrl-] を打鍵する.spiffs と monitor は同時に make の引数として与えることができる.
$ make spiffs monitor
プログラムの作成と実行 [マルチタスク]
mrubyc-esp32 リポジトリで配布している VM はマルチタスクに対応している.マルチタスクで動かす場合には, src ディレクトリ以下の master.rb と slave.rb の 2 つに,並行して動作させるプログラムを書きこめばよい. なお,シングルタスクでの動作に戻す場合は,src/slave.rb ファイルの中身を全てコメントアウトすれば良い.
Ruby コードの作成
マスターとスレーブで異なる周期で Hello World を表示するだけでなく,スレーブで設定した変数をマスターで表示する サンプルプログラムは以下のようになる. なお,共有変数として使いたい変数には,変数名の先頭に $ (ドル) 記号を付すこと.
$ vi src/master.rb
$msg = "ESP32"
while true
puts "hello world from #{$msg} (master)"
sleep 1 # 1 秒おき
end
$ vi src/slave.rb
i = 1
while true
puts "hello world from ESP32 (slave) #{i}"
if ( i % 2 == 0 )
$msg = "hoge"
else
$msg = "peke"
end
i += 1
sleep 5 # 5 秒おき
end
作成した ruby コードのコンパイルとマイコンへの書き込み
master.rb および slave.rb を書き換えるたびにコンパイルとマイコンへの書き込みを実行する.これは make spiffs というコマンドでまとめて行うことができる.
$ make spiffs
Toolchain path: /home/user/.espressif/tools/xtensa-esp32-elf/esp-2020r3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
Toolchain version: esp-2020r3
Compiler version: 8.4.0
.... 以下略 ....
モニタ出力の確認
モニタ出力の確認は make monitor コマンドで行うことができる.モニタを終了する場合は Ctrl-] を打鍵すること (コントロールキーと ] キーを同時に押すこと). 以下の例は,コンパイル・マイコンへの書き込み・モニタ出力を同時に行うものとなっている.
$ make spiffs monitor
Toolchain path: /home/user/.espressif/tools/xtensa-esp32-elf/esp-2020r3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
Toolchain version: esp-2020r3
Compiler version: 8.4.0
...(中略)...
hello world from ESP32 (master)
hello world from ESP32 (slave) 1
hello world from peke (master)
hello world from peke (master)
hello world from peke (master)
hello world from peke (master)
hello world from ESP32 (slave) 2
hello world from hoge (master)
hello world from hoge (master)
hello world from hoge (master)
hello world from hoge (master)
hello world from hoge (master)
hello world from ESP32 (slave) 3
hello world from peke (master)
hello world from peke (master)
hello world from peke (master)
hello world from peke (master)
hello world from peke (master)
hello world from ESP32 (slave) 4
hello world from hoge (master)
hello world from hoge (master)
...(以下略)...