9 ブラウザから操作する:Web Bluetooth コンソール
Web Bluetooth API を使うと、ブラウザの JavaScript から BLE デバイスに接続できます。このページの下のコンソールで、サンプルファームウェアを書き込んだ XIAO を操作してみましょう。
警告動作環境
- Chrome / Edge(Windows・macOS・Linux・Android)で動きます。iPhone / iPad の Safari、Firefox は非対応 です
- HTTPS のページ(またはローカルの
localhost)でのみ動きます - 接続は、ボタンのクリックなどユーザーの操作から始める必要があります
9.1 コンソール
未接続
バージョン
—
最新値
—
通し番号 / サンプル数
—
平均 / 最大
—
測定データ(毎秒の通知, 平均 = 青, 最大 = 赤)
ログ
ヒントやってみよう
- 「接続」を押し、一覧から
HANDSON_NRF52を選ぶ。XIAO の LED が 青の点滅 に変わることを確認しよう - 「機器情報」を押して、
80 01 01 00 00が返ってくることを確認しよう - 「測定開始」を押すと LED が赤の点滅になり、毎秒グラフが更新される。XIAO を振ってみよう
- 測定中に、XIAO のボタンを長押し して止めてみよう。BLE のコマンドとボタンが、同じ状態遷移テーブル を通って処理されていることを実感しよう
- 任意の 16 進に
0300(定義されていないコマンド)を送ってみよう。何が起きるか?
9.2 コードのポイント
device = await navigator.bluetooth.requestDevice({ filters: [{ services: [SERVICE] }] });
const server = await device.gatt.connect();
const svc = await server.getPrimaryService(SERVICE);
rx = await svc.getCharacteristic(RX);
tx = await svc.getCharacteristic(TX);
tx.addEventListener("characteristicvaluechanged", e => onNotify(e.target.value));
await tx.startNotifications();requestDevice()は、ブラウザがデバイス選択ダイアログを出す。サービス UUID でフィルタ すると、アドバタイズにそのサービスを載せているデバイスだけが表示される(ファームのBluefruit.Advertising.addService()が効いている)- 受け取った値は
DataView。getUint16(offset, true)のtrueは リトルエンディアン の指定 - Web Bluetooth では、GATT の操作(読み書き・Notify の開始)を同時に 2 つ実行するとエラー になる(
GATT operation already in progress)。このコンソールでは、Promise をつないで 直列化 している
ノートブラウザ側もイベント駆動
Notify の受信(characteristicvaluechanged)、切断(gattserverdisconnected)、ボタンのクリック —— ブラウザの JavaScript も、イベントを受けて処理する という同じ構造になっています。