ESP32-C3 × ESP-IDF BLE ハンズオン

NimBLE で Notify・コマンド・ペアリングを作り、イベント駆動に組み直す

今日のゴール

  1. BLE の GAP / GATT / ATT / SM の役割を説明できる
  2. NimBLE で アドバタイズ・GATT サービス・Notify を実装できる
  3. Write でコマンド を受け、応答を返せる
  4. パスキーペアリング とボンディングを実装し、アクセスを保護できる
  5. イベントキュー + 状態遷移テーブル で構成を整理できる

ステップ

flowchart LR
  S1["1 Hello"] --> S2["2 アドバタイズ"] --> S3["3 Notify"] --> S4["4 コマンド"] --> S5["5 ペアリング"] --> S6["6 イベント駆動"]

  • 各ステップは 独立した ESP-IDF プロジェクト(ESP-IDF v6.0.1)
  • 確認は nRF Connect と Web Bluetooth コンソール

1. BLE のしくみ

スタック

層 役割 NimBLE
GAP 見つける・つなぐ ble_gap_*、BLE_GAP_EVENT_*
GATT サービス・キャラクタリスティック ble_gatt_svc_def
ATT 属性(ハンドル)の読み書き BLE_ATT_ERR_*
SM ペアリング・鍵 ble_hs_cfg.sm_*
LL / PHY アドバタイズ・接続・暗号化 コントローラ(バイナリ)

アドバタイズと接続

  • ch 37 / 38 / 39 で発信。データは 31 バイトまで
    • 入らない名前は スキャン応答 へ
  • 接続後は 接続間隔 ごとに通信。決めるのは Central
  • 切断されたら 自分でアドバタイズを再開

GATT

flowchart TB
  S["サービス c0a60001-…"] --> C1["Counter<br/>Read / Notify"]
  S --> C2["Command<br/>Write / Notify"]
  C1 --> D1["CCCD 0x2902"]
  C2 --> D2["CCCD 0x2902"]

  • Server から送れるのは Notify / Indicate だけ
  • CCCD に 01 00 が書かれたときだけ送れる
  • 独自 UUID は 自分で生成。バイト列は 逆順
  • 1 回の Notify は既定 20 バイト(MTU 23)

2. NimBLE

動き方

  • ホストは 専用タスク。コールバックもその中
    • 待たない・重いことをしない
  • BLE の API は sync_cb のあと から
  • サービスは 静的な表 で定義し、ホスト起動前に登録
  • ble_gatts_notify_custom() に渡した mbuf は NimBLE が解放

sdkconfig の罠

  • BLE は 既定で無効。sdkconfig.defaults に CONFIG_BT_ENABLED=y など
  • sdkconfig が既にあると defaults は効かない
    • → sdkconfig を消して作り直す

3. セキュリティ

ペアリングとボンディング

  • ペアリング = 鍵を作る、ボンディング = 鍵を保存する
  • DisplayOnly(ESP32-C3)× KeyboardDisplay(スマホ)→ Passkey Entry
  • LE Secure Connections(ECDH)なら盗聴で鍵は漏れない
  • 固定パスキーは学習用。製品は 毎回ランダム

アクセス制御

#define SECURE_READ   (READ | READ_ENC | READ_AUTHEN)
#define SECURE_WRITE  (WRITE | WRITE_ENC | WRITE_AUTHEN)
#define SECURE_NOTIFY (NOTIFY | NOTIFY_INDICATE_ENC | NOTIFY_INDICATE_AUTHEN)
  • *_ENC = 暗号化必須、*_AUTHEN = MITM 保護つきの鍵が必須
  • CCCD は別の属性 → NOTIFY_INDICATE_* を付けないと未ペアリングでも購読できる
  • 片方だけボンドを消すと失敗 → 両方そろえて消す

4. イベント駆動

構成

flowchart LR
  GAP["GAP"] -->|enqueue| Q[("キュー")]
  GATT["GATT Write"] -->|enqueue| Q
  TMR["esp_timer 1s"] -->|enqueue| Q
  Q -->|dequeue| L["main ループ"]
  L --> T["table[状態][イベント]"]
  T --> H["ハンドラ → 次の状態"]

  • ドライバ(ホストタスク)は 積むだけ、すぐ返す
  • 状態を変えるのは ループの 1 か所

状態遷移表

状態 CONNECTED DISCONNECTED CMD_PING CMD_STATUS TIMER_1S
IDLE → CONNECTED — — — +1
CONNECTED — → IDLE PONG 状態 +1, Notify
  • 「—」= NULL = 無視
  • 機能追加 = イベントを足し、すべての行のセルを決める

まとめ

  • BLE は 仕様の言葉 で理解すると、NimBLE の API がそのまま読める
  • Notify は CCCD の購読 が前提
  • 守るなら パーミッションフラグ。CCCD も忘れずに
  • コールバックは 積むだけ、処理は 状態遷移テーブル で