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 の処理による)
ログ
ヒントやってみよう
- 「接続」を押し、一覧から自分の
HANDSON-C3-XXXXを選ぶ(一覧には、サービス UUIDc0a60001-…をアドバタイズしているデバイスだけが出る) - 初回は パスキーの入力 を求められる。シリアルモニタに出ている
123456を入力しよう - カウンタが 1 秒ごとに増え、グラフに 受信間隔 が描かれる。ちょうど 1000 ms にならないのはなぜか考えよう
- 「PING」「STATUS」「未定義」を押して、応答を確かめよう。STATUS のカウンタと、Notify のカウンタは一致しているか?
- シリアルモニタで、
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 程度のばらつきが出ます。