flowchart TB
subgraph Host["ホスト(ESP-IDF では NimBLE)"]
direction TB
GAP["GAP<br/>見つける・つなぐ・役割"]
GATT["GATT<br/>サービスとキャラクタリスティック"]
SM["SM (Security Manager)<br/>ペアリング・鍵"]
ATT["ATT<br/>属性の読み書き"]
L2CAP["L2CAP<br/>多重化・分割"]
GATT --> ATT --> L2CAP
SM --> L2CAP
GAP -.-> L2CAP
end
HCI["HCI(ホストとコントローラの境界)"]
subgraph Ctrl["コントローラ(Espressif 提供のバイナリ)"]
direction TB
LL["Link Layer<br/>アドバタイズ・接続・再送・暗号化"]
PHY["PHY<br/>2.4 GHz 無線"]
LL --> PHY
end
L2CAP --> HCI --> LL
2 BLE の全体像:役割・アドバタイズ・接続
この章と次の章では、コードを書く前に BLE の仕組みを整理します。ここで出てくる言葉(GAP、アドバタイズ、接続間隔、ATT、GATT、CCCD…)は、NimBLE の API 名にそのまま出てきます。
2.1 BLE と Bluetooth Classic
Bluetooth には大きく 2 つの方式があります。
| Bluetooth Classic (BR/EDR) | Bluetooth Low Energy (BLE) | |
|---|---|---|
| 主な用途 | ワイヤレスイヤホン、スピーカー(音声のストリーミング) | センサ、ウェアラブル、ビーコン、スマートロック |
| 通信のしかた | つなぎっぱなしで大量のデータを流す | 短いデータを、ときどき やりとりする |
| 消費電力 | 大きい | 小さい(ボタン電池で数か月〜数年も可能) |
| チャネル | 1 MHz 幅 × 79 | 2 MHz 幅 × 40 |
両者は同じ 2.4 GHz 帯を使いますが、互換性はありません。ESP32-C3 は BLE だけに対応しています。
2.2 プロトコルスタック
BLE は、役割の違う層を積み重ねた プロトコルスタック でできています。
| 層 | 役割 | このハンズオンで触る API |
|---|---|---|
| PHY | 電波の送受信(1 Mbps が基本、BLE 5 では 2 Mbps・Coded も) | — |
| Link Layer (LL) | アドバタイズ、接続の維持、パケットの再送、暗号化(AES-CCM) | — |
| HCI | ホストとコントローラの間のコマンドとイベントの決まりごと | — |
| L2CAP | 上位のプロトコル(ATT・SM)のデータを 1 本のリンクに載せ分ける | — |
| ATT | 「属性」の読み書きのプロトコル | エラーコード BLE_ATT_ERR_* |
| GATT | ATT の上に「サービス・キャラクタリスティック」の構造を定義 | ble_gatts_*、struct ble_gatt_svc_def |
| SM | ペアリング、鍵の生成・配布・保存 | ble_hs_cfg.sm_*、ble_sm_inject_io() |
| GAP | デバイスの発見・接続・役割・接続パラメータ | ble_gap_*、BLE_GAP_EVENT_* |
下の 3 つ(PHY・LL)を コントローラ、上(L2CAP 以上)を ホスト と呼びます。ESP32-C3 では、コントローラは Espressif が提供するバイナリで、ホストとして NimBLE(または Bluedroid)を選びます(第 4 章)。
2.3 GAP の役割
GAP (Generic Access Profile) は、「誰が発信し、誰が探し、誰が接続を始めるか」という 役割 を決めます。
| 役割 | 動作 | 例 |
|---|---|---|
| Broadcaster | アドバタイズを出すだけ(接続は受けない) | ビーコン |
| Observer | アドバタイズを受信するだけ | ビーコンのスキャナ |
| Peripheral | アドバタイズを出し、接続を受け入れる | センサ、ウェアラブル(このハンズオンの ESP32-C3) |
| Central | スキャンして、接続を始める | スマホ、PC |
GAP の Peripheral / Central は「接続の役割」、GATT の Server / Client は「データの持ち主と利用者」の役割です(第 3 章)。多くの場合は Peripheral = GATT Server、Central = GATT Client ですが、仕様上は独立しています。たとえばスマホ(Central)が時刻サービスを持ち、ウェアラブル(Peripheral)が GATT Client としてそれを読む、という構成もありえます。
2.4 アドバタイズ
2.4.1 3 つのアドバタイズチャネル
BLE は 2.4 GHz 帯を 40 チャネル に分けて使います。そのうち 3 つ(37・38・39)がアドバタイズ専用、残りの 37 個が接続後のデータ通信用です。
flowchart LR A37["ch 37<br/>2402 MHz"] --- D["データ ch 0〜10"] --- A38["ch 38<br/>2426 MHz"] --- D2["データ ch 11〜36"] --- A39["ch 39<br/>2480 MHz"]
アドバタイズ用の 3 チャネルは、Wi-Fi のよく使うチャネル(1・6・11)の 中心から外れた位置(帯域の端やすき間)に置かれていて、Wi-Fi の影響を受けにくくなっています。ペリフェラルは、アドバタイズ間隔 ごとに 3 チャネルへ順に同じパケットを送ります。
2.4.2 アドバタイズ間隔
| 間隔 | 長所 | 短所 |
|---|---|---|
| 短い(20〜100 ms) | すぐ見つかる、接続が速い | 消費電力が大きい |
| 長い(1〜10 s) | 消費電力が小さい | 見つかるまで時間がかかる |
仕様上は 20 ms〜約 10.24 s で、0.625 ms 単位で指定します。実際の送信間隔には、他のデバイスとぶつかり続けないよう 0〜10 ms のランダムな遅延 が足されます。このハンズオンでは 100〜150 ms にしています。
2.4.3 アドバタイズパケットの中身
従来型(Legacy)のアドバタイズで載せられるデータは 最大 31 バイト です。その中に AD 構造 と呼ばれる「長さ・種類・データ」の組を並べます。
| Len | Type | Data ... | Len | Type | Data ... | ...
| 02 | 01 | 06 | 11 | 07 | (128bit UUID 16B) |
└ Flags: 一般発見可能 + BR/EDR 非対応 └ 128 bit サービス UUID の完全なリスト
よく使う AD タイプ:
| Type | 名前 | 内容 |
|---|---|---|
0x01 |
Flags | 発見モード(0x02 = 一般発見可能)、BR/EDR 非対応(0x04)など |
0x03 / 0x02 |
16 bit サービス UUID(完全 / 一部) | 標準サービス(心拍 0x180D など) |
0x07 / 0x06 |
128 bit サービス UUID(完全 / 一部) | 独自サービス |
0x09 / 0x08 |
名前(完全 / 短縮) | デバイス名 |
0x0A |
TX Power Level | 送信電力 [dBm](距離の推定に使う) |
0xFF |
Manufacturer Specific Data | 先頭 2 バイトが会社 ID。ビーコンなどで使う |
31 バイトはすぐに埋まります。Flags(3 バイト)+ 128 bit UUID(18 バイト)で 21 バイト、残りは 10 バイトなので、HANDSON-C3-XXXX(15 文字 + 2 = 17 バイト)は入りません。そこで次の仕組みを使います。
2.4.4 スキャン応答
Central が アクティブスキャン をしていると、アドバタイズを受け取ったあと Scan Request を送ってきます。ペリフェラルはそれに Scan Response(さらに最大 31 バイト)で応えます。
sequenceDiagram participant P as ESP32-C3 (Peripheral) participant C as スマホ (Central) P->>C: ADV_IND(Flags + サービス UUID)ch 37/38/39 C->>P: SCAN_REQ(アクティブスキャン時) P->>C: SCAN_RSP(デバイス名) Note over C: 一覧に名前とUUIDが表示される C->>P: CONNECT_IND(接続要求) Note over P,C: ここから接続状態。データチャネルへ
このハンズオンでは、アドバタイズにサービス UUID、スキャン応答に名前 を入れています(Step 3 以降)。サービス UUID をアドバタイズに入れておくと、Central 側が「このサービスを持つデバイスだけ」を絞り込んで探せます(第 11 章の Web Bluetooth で使う)。
2.4.5 アドバタイズの種類
| PDU | 接続できる? | スキャン応答? | 用途 |
|---|---|---|---|
| ADV_IND | ○ | ○ | 一般的なペリフェラル(このハンズオン) |
| ADV_DIRECT_IND | 特定の相手だけ | × | 既知の相手へ素早く再接続 |
| ADV_SCAN_IND | × | ○ | 接続しないが追加情報は出す |
| ADV_NONCONN_IND | × | × | ビーコン |
NimBLE では、ble_gap_adv_params の conn_mode(接続可否)と disc_mode(発見モード)の組み合わせで決まります。
2.5 接続
2.5.1 接続イベントと接続間隔
接続すると、Central と Peripheral は 接続間隔 (Connection Interval) ごとに決まったタイミングで起き、データをやりとりします。この 1 回分を 接続イベント と呼びます。接続イベントのたびに使うデータチャネルを変えていく(周波数ホッピング)ので、混信に強くなっています。
sequenceDiagram participant C as Central participant P as Peripheral Note over C,P: 接続イベント #1(ch 12) C->>P: パケット(空でもよい) P->>C: パケット(Notify など) Note over C,P: … 接続間隔(例: 30 ms)だけ眠る … Note over C,P: 接続イベント #2(ch 31) C->>P: パケット P->>C: パケット
| パラメータ | 範囲 | 意味 |
|---|---|---|
| 接続間隔 | 7.5 ms〜4 s(1.25 ms 単位) | 短いほど応答が速く、データを多く送れるが、電力を食う |
| Peripheral Latency | 0〜499 回 | Peripheral が「送るものがなければ」連続してサボってよい接続イベントの回数 |
| Supervision Timeout | 100 ms〜32 s(10 ms 単位) | この時間パケットが届かなければ 切断 とみなす |
接続間隔は Central(スマホ・PC)が決めます。Peripheral は「この範囲にしてほしい」と 接続パラメータ更新 を要求できますが、受け入れるかは Central 次第です。iOS や Android は、OS の方針(省電力・他の接続との兼ね合い)で値を選びます。
このハンズオンでは 1 秒ごとに Notify しますが、パケットが実際に飛ぶのは 次の接続イベント です。接続間隔が 30 ms なら最大 30 ms 遅れます。逆に、接続間隔より短い周期で大量に Notify しても、1 回の接続イベントで送れるパケット数には限りがあるので、送信待ちがたまっていきます。
2.5.2 切断の理由
切断されると、理由を表すコードが届きます(NimBLE では BLE_GAP_EVENT_DISCONNECT の reason)。NimBLE は HCI のエラーコードに 0x200 を足した値で報告します。
reason |
HCI エラー | よくある原因 |
|---|---|---|
0x208 |
Connection Timeout (0x08) | 電波が届かなくなった(Supervision Timeout) |
0x213 |
Remote User Terminated (0x13) | 相手(スマホ)が切断した |
0x216 |
Local Host Terminated (0x16) | 自分から切断した |
0x23e |
Failed to be Established (0x3E) | 接続の確立に失敗した |
2.6 アドレス
BLE デバイスは 48 bit の Bluetooth デバイスアドレス で識別されます。
| 種類 | 内容 |
|---|---|
| Public | IEEE から割り当てられた固定アドレス(Wi-Fi の MAC アドレスと同じ考え方) |
| Random Static | 起動ごと、または製品ごとに決める固定のランダムアドレス |
| Resolvable Private (RPA) | 一定時間ごとに変わるアドレス。IRK(鍵)を知っている相手だけが、元のデバイスを特定できる |
| Non-resolvable Private | 変わり続けるアドレス。誰も特定できない |
スマホは プライバシー保護のため RPA を使います。そのため、ペリフェラル側から見ると、スマホのアドレスは毎回違って見えます。ペアリング時に IRK を交換 しておくと、アドレスが変わっても「前にペアリングしたあのスマホだ」とわかります(第 8 章)。
ESP32-C3 は eFuse に書かれた Public アドレス を持っています。このハンズオンでは、その下位 2 バイトをデバイス名に付けて、同じ部屋に何台あっても区別できるようにしています。
- BLE は ホスト(GAP/GATT/ATT/SM) と コントローラ(LL/PHY) に分かれる
- ペリフェラルは 3 つのチャネルで アドバタイズ し、セントラルが 接続 を始める
- アドバタイズは 31 バイト。入りきらない情報は スキャン応答 へ
- 接続後は 接続間隔 ごとにデータをやりとりする。接続間隔を決めるのは セントラル