flowchart LR S1["Step 1<br/>Hello ESP-IDF"] --> S2["Step 2<br/>アドバタイズ"] S2 --> S3["Step 3<br/>GATT と Notify"] S3 --> S4["Step 4<br/>コマンドと応答"] S4 --> S5["Step 5<br/>パスキーペアリング"] S5 --> S6["Step 6<br/>イベント駆動に<br/>組み直す"]
ESP32-C3 × ESP-IDF BLE ハンズオン
NimBLE で Notify・コマンド・ペアリングを作り、イベント駆動に組み直す
はじめに
English version available — Read in English (machine-assisted translation by generative AI).
このハンズオンでは、Espressif の ESP32-C3 と公式開発フレームワーク ESP-IDF を使って、BLE (Bluetooth Low Energy) のペリフェラル(スマホや PC から接続される側のデバイス)を一から作ります。
Arduino でも BLE は動かせますが、ライブラリが多くのことを隠しているため、
- なぜアドバタイズに名前が入りきらないのか
- Notify が届かないのは、何が足りないのか
- ペアリングのダイアログが出たり出なかったりするのはなぜか
といった疑問にぶつかると、どこを見ればよいかわからなくなりがちです。ESP-IDF の BLE スタック NimBLE は、BLE の仕様の言葉(GAP・GATT・ATT・Security Manager)をほぼそのまま API にしています。仕様の言葉とコードを 1 対 1 で対応させながら 進めるのが、このハンズオンの狙いです。
完成するもの
| 機能 | 内容 |
|---|---|
| アドバタイズ | HANDSON-C3-XXXX(XXXX はデバイスごとに異なる)という名前で発信し、接続を待つ |
| Notify | 接続中、1 秒ごとにカウンタ値をスマホ・PC に送る |
| コマンド | 0x00 を書き込むと PONG、0x01 を書き込むとカウンタと起動からの秒数が返る |
| ペアリング | 6 桁のパスキー(123456)を入力しないと、データの読み書きも購読もできない。一度ペアリングすれば次からは不要(ボンディング) |
| 構成 | 最終的に イベントキュー + 状態遷移テーブル のイベント駆動構成にする |
| ブラウザ | 第 11 章の BLE コンソール から、このページ上でデバイスを操作できる(Chrome / Edge) |
サンプルファームウェア
firmware.zip — ESP-IDF プロジェクト 6 つ(step1_hello 〜 step6_event_driven)。各ステップは単独でビルド・書き込みできます。
各章のコードは、このサンプルファームウェアのソースファイルをそのまま表示しています。ESP-IDF v6.0.1 でビルドを確認しています。
対象読者
- C 言語の基本(関数、構造体、ポインタ、
switch)がわかる方 - Arduino などでマイコンを触ったことがある方
- BLE を「なんとなく」使ったことはあるが、仕組みをきちんと理解したい方
必要なもの
| もの | 備考 |
|---|---|
| ESP32-C3 搭載ボード | Seeed Studio XIAO ESP32C3、ESP32-C3-DevKitM-1 など。XIAO はアンテナを必ず取り付ける |
| USB ケーブル | データ通信対応のもの |
| PC | macOS / Windows / Linux。ESP-IDF v6 をインストールする(第 1 章) |
| スマホ | nRF Connect for Mobile(Nordic Semiconductor 製, iOS / Android, 無料)をインストール |
| Chrome または Edge(PC / Android) | 第 11 章の BLE コンソール用(iPhone / iPad の Safari は Web Bluetooth 非対応) |
章構成
| 章 | 内容 | ステップ | 目安時間 |
|---|---|---|---|
| 1 | 開発環境と ESP-IDF の基本 | Step 1 | 40分 |
| 2 | BLE の全体像:役割・アドバタイズ・接続 | — | 30分 |
| 3 | ATT と GATT:データのやりとりの枠組み | — | 30分 |
| 4 | ESP-IDF の BLE スタック NimBLE | — | 20分 |
| 5 | アドバタイズして接続を待つ | Step 2 | 30分 |
| 6 | GATT サービスを作り、Notify する | Step 3 | 40分 |
| 7 | コマンドを受け取って応答する | Step 4 | 30分 |
| 8 | BLE のセキュリティ:ペアリングとボンディング | — | 30分 |
| 9 | パスキーペアリングを実装する | Step 5 | 40分 |
| 10 | イベント駆動に組み直す | Step 6 | 40分 |
| 11 | ブラウザから操作する:Web Bluetooth コンソール | Step 6 | 20分 |
| 12 | トラブルシューティング | — | 適宜 |
| 13 | 確認問題と発展課題 | — | 30分 |
第 2〜4 章と第 8 章は仕組みの解説です。手を動かすのを先にしたい場合は、第 5 章から始めて、わからない言葉が出てきたら戻ってきてください。
講義用の要点スライドは こちら。
同じイベント駆動の設計を、Arduino(Adafruit nRF52 コア)+ XIAO nRF52840 で扱った nRF52840 イベント駆動ファームウェア ハンズオン もあります。第 10 章の設計は、そちらとほぼ同じ形にそろえています。