flowchart TB P["GATT Server(ESP32-C3)"] P --> S1["サービス: GAP (0x1800)"] P --> S2["サービス: GATT (0x1801)"] P --> S3["サービス: 独自 (c0a60001-…)"] S1 --> C11["Device Name (0x2A00)"] S1 --> C12["Appearance (0x2A01)"] S3 --> C1["キャラクタリスティック: Counter<br/>Read / Notify"] S3 --> C2["キャラクタリスティック: Command<br/>Write / Notify"] C1 --> D1["ディスクリプタ: CCCD (0x2902)"] C2 --> D2["ディスクリプタ: CCCD (0x2902)"]
3 ATT と GATT:データのやりとりの枠組み
接続したあと、データは ATT というプロトコルで、GATT という構造に沿ってやりとりされます。BLE を自作するときに一番お世話になるのがこの 2 つです。
3.1 ATT:属性の表
ATT (Attribute Protocol) では、GATT Server(ペリフェラル)が 属性 (Attribute) の表 を持ち、GATT Client(スマホ)がそれを読み書きします。1 つの属性は次の 4 つでできています。
| 要素 | 内容 |
|---|---|
| ハンドル | 16 bit の通し番号(0x0001〜0xFFFF)。表の行番号 |
| タイプ | 属性の種類を表す UUID |
| 値 | データ本体(可変長) |
| パーミッション | 読める・書ける・暗号化が必要・認証が必要… |
Client は「ハンドル 0x0012 を読む」「ハンドル 0x0015 に書く」のように、ハンドルで 属性を指定します。
3.1.1 ATT の主な操作
| 操作 | 方向 | 応答 | 用途 |
|---|---|---|---|
| Read Request | Client → Server | Read Response | 値を読む |
| Write Request | Client → Server | Write Response | 値を書く(成功・失敗が返る) |
| Write Command | Client → Server | なし | 値を書く(速いが、届いたかはわからない) |
| Handle Value Notification | Server → Client | なし | 値の変化を 知らせる(Notify) |
| Handle Value Indication | Server → Client | Confirmation | 値の変化を知らせ、受け取りの確認をもらう(Indicate) |
| Exchange MTU | Client → Server | Response | 1 パケットの最大長(MTU)を交渉 |
Server から Client へ自発的に送れるのは Notify と Indicate だけ です。ペリフェラルから「1 秒ごとにデータを送る」には、このどちらかを使います。
3.2 GATT:サービスとキャラクタリスティック
ATT の属性の表は、そのままでは単なる行の並びです。GATT (Generic Attribute Profile) は、その表を サービス → キャラクタリスティック → ディスクリプタ の入れ子構造として使う決まりごとです。
| 用語 | 意味 | 例 |
|---|---|---|
| サービス | 関連する機能のまとまり | 心拍サービス、バッテリーサービス、独自サービス |
| キャラクタリスティック | 1 つの値の入れ物。読み書き・通知の単位 | 心拍数、バッテリー残量、カウンタ |
| ディスクリプタ | キャラクタリスティックの付加情報 | CCCD(通知の購読設定)、説明文 |
3.2.1 属性の表として見ると
このハンズオンの独自サービスは、ATT の表では次のような行になります(ハンドルの番号は例です。実際の値は登録順で決まります)。
| ハンドル | タイプ (UUID) | 値 | 意味 |
|---|---|---|---|
| 0x000A | 0x2800 Primary Service |
c0a60001-… |
サービス宣言 |
| 0x000B | 0x2803 Characteristic |
プロパティ 0x12, 値ハンドル 0x000C, UUID c0a60002-… |
キャラクタリスティック宣言 |
| 0x000C | c0a60002-… |
カウンタの値(4 バイト) | 値 |
| 0x000D | 0x2902 CCCD |
00 00 / 01 00 |
購読設定 |
| 0x000E | 0x2803 Characteristic |
プロパティ 0x18, 値ハンドル 0x000F, UUID c0a60003-… |
キャラクタリスティック宣言 |
| 0x000F | c0a60003-… |
(書き込まれたコマンド) | 値 |
| 0x0010 | 0x2902 CCCD |
00 00 / 01 00 |
購読設定 |
1 つのキャラクタリスティックは 宣言・値・(ディスクリプタ)の複数の行 でできています。NimBLE でキャラクタリスティックを登録したとき、val_handle に返ってくるのは 値の行のハンドル です。Notify するときや、どのキャラクタリスティックへのアクセスかを判定するときに、このハンドルを使います。
Client は接続後、この表を サービス探索 (Service Discovery) で読み取ってから操作します。nRF Connect で接続すると最初に一覧が表示されるのは、この探索の結果です。
3.2.2 プロパティ
キャラクタリスティック宣言の プロパティ は、そのキャラクタリスティックで 何ができるか を Client に知らせるビットの組み合わせです。
| ビット | 名前 | NimBLE のフラグ |
|---|---|---|
0x02 |
Read | BLE_GATT_CHR_F_READ |
0x04 |
Write Without Response | BLE_GATT_CHR_F_WRITE_NO_RSP |
0x08 |
Write | BLE_GATT_CHR_F_WRITE |
0x10 |
Notify | BLE_GATT_CHR_F_NOTIFY |
0x20 |
Indicate | BLE_GATT_CHR_F_INDICATE |
Counter は Read + Notify で 0x12、Command は Write + Notify で 0x18 になります。
プロパティ は「この操作に対応している」という 宣言(Client への案内)です。パーミッション は「この条件を満たさなければ拒否する」という アクセス制御 で、Client からは見えません。NimBLE の BLE_GATT_CHR_F_READ_ENC(暗号化が必要)などはパーミッション側のフラグです(第 9 章)。
3.2.3 CCCD:Notify の購読スイッチ
Notify / Indicate は、Server が勝手に送ってよいものではありません。Client が CCCD(Client Characteristic Configuration Descriptor, UUID 0x2902)に書き込んで 購読を有効にしたときだけ 送れます。
| CCCD の値 | 意味 |
|---|---|
00 00 |
購読しない(初期値) |
01 00 |
Notify を購読 |
02 00 |
Indicate を購読 |
sequenceDiagram
participant C as スマホ (GATT Client)
participant S as ESP32-C3 (GATT Server)
C->>S: Write Request: CCCD(0x000D) = 01 00
S-->>C: Write Response
Note over S: BLE_GAP_EVENT_SUBSCRIBE (cur_notify=1)
loop 1 秒ごと
S->>C: Handle Value Notification: handle 0x000C, 値
end
C->>S: Write Request: CCCD(0x000D) = 00 00
Note over S: BLE_GAP_EVENT_SUBSCRIBE (cur_notify=0)
- CCCD は 接続ごと・Client ごと の値です。切断すると(ボンディングしていなければ)購読は解除されます
- nRF Connect の「↓↓↓」アイコン、Web Bluetooth の
startNotifications()は、どちらも この CCCD に01 00を書き込む 操作です - NimBLE は CCCD を自動で作り、書き込まれると
BLE_GAP_EVENT_SUBSCRIBEイベントで知らせてくれます
3.2.4 Notify と Indicate
| Notify | Indicate | |
|---|---|---|
| 受け取り確認 | なし | あり(Confirmation が返るまで次を送れない) |
| 速さ | 速い(1 接続イベントで複数送れる) | 遅い(1 往復ごとに 1 件) |
| 確実さ | Link Layer では再送されるので、接続が保たれていれば届く。ただし アプリが受け取って処理したか はわからない | Client の ATT 層が受け取ったことが確認できる |
| 向いている用途 | センサ値の連続送信 | 設定変更の通知、取りこぼしたくないイベント |
このハンズオンでは Notify を使います。
3.3 UUID
サービスやキャラクタリスティックの種類は UUID で表します。
3.3.1 16 bit UUID と Bluetooth Base UUID
Bluetooth SIG が定めた標準のサービス・キャラクタリスティックには、16 bit の短い UUID が割り当てられています。
| UUID | 名前 |
|---|---|
0x180D |
Heart Rate サービス |
0x180F |
Battery サービス |
0x2A19 |
Battery Level キャラクタリスティック |
0x2902 |
CCCD |
16 bit UUID は、実は Bluetooth Base UUID の一部を置き換えた 128 bit UUID の省略形です。
0000xxxx-0000-1000-8000-00805F9B34FB
^^^^ ここに 16 bit UUID が入る
3.3.2 独自の 128 bit UUID
自分で作るサービスには、ランダムに生成した 128 bit UUID を使います(uuidgen コマンドや、Python の uuid.uuid4() で作れる)。このハンズオンでは、
| 用途 | UUID |
|---|---|
| サービス | c0a60001-18ff-4cd1-afce-4832ee44bcb7 |
| Counter | c0a60002-18ff-4cd1-afce-4832ee44bcb7 |
| Command | c0a60003-18ff-4cd1-afce-4832ee44bcb7 |
のように、1 つのベース UUID の 3〜4 バイト目を変えて 連番にしています。
ネットのサンプルでよく見かける 6e400001-b5a3-f393-e0a9-e50e24dcca9e は、Nordic の UART サービス (NUS) の UUID です。これを別の意味で使うと、nRF Connect などのツールが「UART の RX / TX」として表示し、混乱のもとになります。独自のサービスには、自分で生成した UUID を使いましょう。
3.3.3 バイト順に注意
128 bit UUID を バイト列 として扱うとき、BLE の中では リトルエンディアン(逆順) で並びます。NimBLE の BLE_UUID128_INIT() も、最後のバイトから 書きます。
// c0a60001-18ff-4cd1-afce-4832ee44bcb7
BLE_UUID128_INIT(0xb7, 0xbc, 0x44, 0xee, 0x32, 0x48, 0xce, 0xaf,
0xd1, 0x4c, 0xff, 0x18, 0x01, 0x00, 0xa6, 0xc0);
// ^^^^^^^^^^^^^^^^^^^^^^ 先頭の c0a60001 が最後に来る3.4 MTU と 1 回で送れる長さ
ATT_MTU は、ATT の 1 パケットの最大長です。
- 既定値は 23 バイト。Notify のヘッダ(オペコード 1 + ハンドル 2)を引いた 20 バイト が、1 回の Notify で送れる値の長さ
- 接続後、Client が Exchange MTU を送ると、両者の希望の小さい方に決まる。ESP-IDF の NimBLE は既定で 256 を希望する(
CONFIG_BT_NIMBLE_ATT_PREFERRED_MTU) - iOS や Android は接続直後に MTU 交渉をすることが多く、185 や 247 などに広がる。NimBLE では
BLE_GAP_EVENT_MTUで知らされる
このハンズオンの応答は最長 9 バイトなので、既定の 20 バイトに収まります。20 バイトを超えるデータを送る設計にするなら、MTU に頼らず分割する か、MTU が広がったことを確認してから送ります。
- ATT は ハンドルで指定する属性の表 の読み書き
- GATT は表を サービス → キャラクタリスティック → ディスクリプタ として使う決まり
- Server から送れるのは Notify / Indicate だけで、Client が CCCD に書いて購読したときだけ送れる
- 独自サービスには 自分で生成した 128 bit UUID。バイト列は 逆順
- 1 回の Notify は既定で 20 バイト まで