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

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

公開

2026年10月17日

はじめに

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 で対応させながら 進めるのが、このハンズオンの狙いです。

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/>組み直す"]

完成するもの

機能 内容
アドバタイズ 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 章の設計は、そちらとほぼ同じ形にそろえています。