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) は、その表を サービス → キャラクタリスティック → ディスクリプタ の入れ子構造として使う決まりごとです。

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)"]

用語 意味 例
サービス 関連する機能のまとまり 心拍サービス、バッテリーサービス、独自サービス
キャラクタリスティック 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 バイト目を変えて 連番にしています。

警告よく知られた UUID を流用しない

ネットのサンプルでよく見かける 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 バイト まで