スタートアップガイド

概要

CHIRIMEN with micro:bitをはじめてつかうときの流れを解説します。

準備するもの

Bluetooth (4.0 以上) 対応コンピュータ＋ Web Bluetooth API をサポートする (Blink エンジン採用) ブラウザ
- Windows10/macOS/Linux PC: Chrome, Chromium, Egde (Dev リリース), Brave などのブラウザ
- Android スマートフォン/タブレット： Chrome, VideoMark Browser などのブラウザ
- Raspberry Pi などのシングルボードコンピュータ: Raspbian や (Chirimen for Raspberry Pi3 で Chromium ブラウザ
- Note: Bluetooth が載っていない PC でも Bluetooth USB ドングルで使えるものがあります。(Windows10 PC+エレコムLBT-UAN05C2など)
micro:bit (秋月電子通商, Switch Science, Amazon などで購入可能です。2000円程)
microUSB ケーブル (PC と micro:bit を繋いでサポートプログラムを書き込んだり、micro:bitの電源用に必要)
micro:bit 用ブレークアウトボード（micro:bitのエッジコネクタをピンヘッダに変換するパーツ。いろいろ種類があります。数百円～）
試したい例に応じたジャンパー線、パーツなど
- CHIRIMEN スターターキットを使うと、GPIO 入出力と、I2C 温度センサ (ADT7410)の例が試せます

L チカに必要となるパーツ

ブレッドボード × 1
リード付き LED × 1
リード付き抵抗器 (150Ω-1KΩ) x 1 (赤色LEDは大きい抵抗値でも点灯します)
ジャンパーワイヤー (オス-メス) x 2

micro:bitのピンのことを知る

micro:bitにはGPIO等の端子が備わっていますが、ブレッドボードを接続するのに便利なピンヘッダではなく、少し独特なエッジコネクタになっています。GPIO0～2と、GND及び3Vは大きな端子になっていて、ワニ口クリップなどで簡単にLEDなどをつなぐことができますが、CHIRIMEN with micro:bitではこれ(GPIO端子)に加えて、I2C端子(SCL,SDA)を使った例が多いです。これらはとても細い端子(下図の19番(SCL)と20番の端子(SDA))なので、先述のブレークアウトボードが便利です。

micro:bitのピン配置

micro:bit オリジナルページ：https://makecode.microbit.org/device/pins

ブレークアウトボードの使い方

ブレークアウトボードにはmicro:bitのすべての端子にアクセスできるピンヘッダが付けられています。脇には端子の名称も印刷されています。ブレークアウトボードの例

micro:bitのエッジコネクタをブレークアウトボードに差し込みます。ブレークアウトボードをmicro:bitに接続した写真

Examplesや以降の解説の実体配線図では、ブレークアウトボードは省略されています。GPIO番号やSCL,SDA,GND,3V(3.3V,VDD)などの端子の名称をもとにつないでください。

mircro:bit に CHIRIMEN サポートプログラムを書き込む

CHIRIMEN with micro:bit では WebGPIO/WebI2C API を後述の Polyfill ライブラリと合わせて利用することでアプリケーションを開発します。各 API を呼び出すとライブラリ内では Web Bluetooth API を用いて micro:bit と通信しますが、micro:bit 側には PC からの制御命令を受け取るため専用の CHIRIMEN サポートプログラムを書き込んでおく必要があります。

こちらのページにアクセスして、micro:bitにサポートプログラムを書き込みます。
書き込み方は通常のmicro:bit用プログラムと全く同じです。
- [編集]ボタンを押す
- [ダウンロード]ボタンを押し、サポートプログラムをダウンロード
- micro:bitをUSBでPCに接続 (USBドライブとしてPC上にマウント)
- ダウンロードしたプログラムをマウントしたmicro:bit USBドライブにコピー
- 自動的に再起動しインストール完了。　♡がmicro:bitに表示されます
- これで準備完了です！ USBケーブルを外して次に進みましょう。(micro:bitのプログラムは電源を落としても消えません)

なお、このCHIRIMEN用のサポートプログラムは、micro:bit上で動かす他のプログラムと同じ動作環境(makecode)で構築してありますので、CHIRIMEN with micro:bitを使わないときは、特別な手順は必要なく自由に他のプログラムと置き換えることができます。

ブラウザの設定を確認

コンピュータと micro:bit との無線通信に利用する Web Bluetooth API はまだ実験的な実装という扱いであり、ブラウザや環境によっては有効化されていません。Chrome などのブラウザで chrome://flags ページを開き Experimental Web Platform features が有効になっていることを確認、無効の場合は有効化してからブラウザを再起動 (環境によっては設定変更後に一度 Bluetooth のオンオフも) してください。開発者ツールのコンソールで navigator.bluetooth オブジェクトが見えるようになっていれば有効化されています。

LEDを点滅させてみる

以下の実体配線図のように配線しましょう。(ブレークアウトボードは省略しています)
micro:bitにUSBケーブルをつなぎ、電源を供給します。(PCのUSBポートからも電源供給可能) ♡がmicro:bitに表示されます
こちらのページにアクセス
[Connect]ボタンを押して、micro:bitとペアリングします　ペアリングが成功すると◇マークがmicro:bitに表示されます
LEDが点滅します

プログラムの解説

ソースコードはこちら
<script type="text/javascript" src="https://chirimen.org/chirimen-micro-bit/polyfill/microBitBLE.js"></script> でCHIRIMEN with micro:bit用のWebGPIO, WebI2C APIのポリフィルライブラリをロードしています。
microBitBle = await microBitBleFactory.connect(); でmicro:bitにBluetooth接続します。

以下でmicro:bitのGPIO-0番端子を出力に設定して初期化します。この端子はgpioPort0という変数でアクセスできるようになります。

var gpioAccess = await microBitBle.requestGPIOAccess();
var mbGpioPorts = gpioAccess.ports;
gpioPort0 = mbGpioPorts.get(0);
await gpioPort0.export("out"); //port0 out

await gpioPort0.write(gpio0Val);　でGPIO-0の出力のHigh(点灯) / Low(消灯)を指定します。

次にやること

こちらのExamplesを試してみましょう。

chirimen-micro-bit

CHIRIMEN with micro:bit