11  ブラウザから操作する:Web Bluetooth コンソール

Web Bluetooth API を使うと、ブラウザの JavaScript から BLE デバイスに接続できます。このページの下のコンソールで、Step 6(または Step 5)を書き込んだ ESP32-C3 を操作してみましょう。

警告動作環境
  • Chrome / Edge(Windows・macOS・Linux・Android)で動きます。iPhone / iPad の Safari、Firefox は非対応 です
  • HTTPS のページ(またはローカルの localhost)でのみ動きます
  • 接続は、ボタンのクリックなどユーザーの操作から始める必要があります
  • ペアリングのダイアログ(パスキーの入力)は OS が表示します。OS やバージョンによって表示のされ方が異なります。うまくいかない場合は、先に OS の Bluetooth 設定から HANDSON-C3-XXXX とペアリング してから接続してください

11.1 コンソール

未接続
カウンタ (Notify)
—
PING 応答
—
STATUS: カウンタ / 起動から
—
Notify の受信間隔
—
Counter の Notify の受信間隔 [ms](1000 ms からのずれは、接続間隔やブラウザ・OS の処理による)
ログ

ヒントやってみよう
  1. 「接続」を押し、一覧から自分の HANDSON-C3-XXXX を選ぶ(一覧には、サービス UUID c0a60001-… をアドバタイズしているデバイスだけが出る)
  2. 初回は パスキーの入力 を求められる。シリアルモニタに出ている 123456 を入力しよう
  3. カウンタが 1 秒ごとに増え、グラフに 受信間隔 が描かれる。ちょうど 1000 ms にならないのはなぜか考えよう
  4. 「PING」「STATUS」「未定義」を押して、応答を確かめよう。STATUS のカウンタと、Notify のカウンタは一致しているか?
  5. シリアルモニタで、MAIN: STATE_CONNECTED <- EVT_BLE_CMD_PING のような イベントの流れ を確認しよう

11.2 コードのポイント

device = await navigator.bluetooth.requestDevice({ filters: [{ services: [SERVICE] }] });
const server = await device.gatt.connect();
const svc = await server.getPrimaryService(SERVICE);
counterChr = await svc.getCharacteristic(COUNTER);
cmdChr = await svc.getCharacteristic(COMMAND);
counterChr.addEventListener("characteristicvaluechanged", e => onCounter(e.target.value));
await counterChr.startNotifications();
Web Bluetooth BLE で起きること ファームウェア側
requestDevice({ filters: [{ services }] }) スキャンし、アドバタイズにそのサービス UUID があるデバイスだけを表示 アドバタイズの uuids128
gatt.connect() 接続 BLE_GAP_EVENT_CONNECT
getPrimaryService() / getCharacteristic() サービス探索 gatt_svcs[] の定義
startNotifications() CCCD に 01 00 を書く。未ペアリングならエラーが返り、OS がペアリングを始める BLE_GAP_EVENT_SUBSCRIBE、PASSKEY_ACTION
writeValueWithResponse() Write Request BLE_GATT_ACCESS_OP_WRITE_CHR
characteristicvaluechanged Notify を受信 ble_gatts_notify_custom()
  • 受け取った値は DataView。getUint32(offset, true) の true は リトルエンディアン の指定
  • Web Bluetooth では、GATT の操作を同時に 2 つ実行するとエラー になる(GATT operation already in progress)。このコンソールでは、Promise をつないで 直列化 している
ノート受信間隔が 1000 ms ちょうどにならない理由

ESP32-C3 は esp_timer で正確に 1 秒ごとに Notify を キューに積みます が、実際に電波が出るのは 次の接続イベント です(第 2 章)。さらに受信側でも、OS の Bluetooth スタック → ブラウザ → JavaScript と渡される間に遅れが入ります。接続間隔が 30 ms なら、±30 ms 程度のばらつきが出ます。