flowchart TB S["サービス<br/>1c6865f9-…"] --> RX["RX キャラクタリスティック (Write)<br/>9e32b171-…<br/>スマホ → デバイス: コマンド"] S --> TX["TX キャラクタリスティック (Notify)<br/>02b89422-…<br/>デバイス → スマホ: 応答・測定データ"]
7 イベントの発生源 ③:BLE
7.1 BLE の基本用語
| 用語 | 意味 |
|---|---|
| Peripheral(ペリフェラル) | 接続を待つ側。このデバイス |
| Central(セントラル) | 接続しに行く側。スマホ・PC |
| アドバタイズ | ペリフェラルが「ここにいます」と周期的に発信するパケット。名前やサービス UUID を載せる |
| GATT | 接続後のデータのやりとりの枠組み。サービス の中に キャラクタリスティック(値の入れ物)がある |
| Write | セントラル → ペリフェラルへ値を書き込む |
| Notify | ペリフェラル → セントラルへ値を送る(セントラルが購読を有効にしている場合のみ) |
| UUID | サービス・キャラクタリスティックの識別子。独自のものは 128 bit のランダムな値を使う |
7.2 このサンプルの GATT 構成
1 つのサービスに コマンドを受ける RX と 応答を返す TX の 2 つのキャラクタリスティックを置く、シンプルな構成です(Nordic UART Service と同じ考え方)。
7.3 実装
#ifndef DRV_BLE_H
#define DRV_BLE_H
#include <Arduino.h>
// サービスとキャラクタリスティックの UUID(このハンズオン用に生成したもの)
#define BLE_SERVICE_UUID "1c6865f9-d683-423a-ab14-7bfcbe71ca56"
#define BLE_RX_CHARA_UUID "9e32b171-c5a8-429e-af49-79eebdb398c2" // スマホ → デバイス (Write)
#define BLE_TX_CHARA_UUID "02b89422-f15b-4388-a22e-ddaa5a100258" // デバイス → スマホ (Notify)
#define BLE_DEVICE_NAME "HANDSON_NRF52"
void ble_init();
bool ble_is_connected();
// TX キャラクタリスティックで送信(接続中かつ Notify が有効なときだけ送る)
bool ble_send(const uint8_t *data, uint16_t len);
#endif // DRV_BLE_H#include "drv_ble.h"
#include "app_event.h"
#include <bluefruit.h>
static BLEService s_service(BLE_SERVICE_UUID);
static BLECharacteristic s_rx(BLE_RX_CHARA_UUID);
static BLECharacteristic s_tx(BLE_TX_CHARA_UUID);
static volatile bool s_connected = false;
// --- コールバック(BLE タスクの中で呼ばれる。ここでもイベントを積むだけ) -----
static void on_connect(uint16_t conn_handle)
{
s_connected = true;
event_post(EVT_BLE_CONNECTED);
}
static void on_disconnect(uint16_t conn_handle, uint8_t reason)
{
s_connected = false;
event_post(EVT_BLE_DISCONNECTED, &reason, 1);
}
// コマンド形式: [グループ, コマンド, 引数...]
// 0x00 0x01 : 機器情報取得
// 0x01 0x00 : 測定開始
// 0x01 0x01 : 測定停止
// 0x02 0x01 : 最新値取得
static void on_rx_write(uint16_t conn_hdl, BLECharacteristic *chr, uint8_t *data, uint16_t len)
{
if (len < 2)
return;
uint16_t cmd = ((uint16_t)data[0] << 8) | data[1];
const uint8_t *args = data + 2;
uint8_t args_len = (uint8_t)(len - 2);
switch (cmd)
{
case 0x0001: event_post(EVT_BLE_CMD_GET_INFO, args, args_len); break;
case 0x0100: event_post(EVT_BLE_CMD_MEAS_START, args, args_len); break;
case 0x0101: event_post(EVT_BLE_CMD_MEAS_STOP, args, args_len); break;
case 0x0201: event_post(EVT_BLE_CMD_GET_LATEST, args, args_len); break;
default: break; // 未知のコマンドは捨てる
}
}
void ble_init()
{
Bluefruit.begin();
Bluefruit.autoConnLed(false); // LED はアプリ側(ui_update)で制御する
Bluefruit.setTxPower(0);
Bluefruit.setName(BLE_DEVICE_NAME);
Bluefruit.Periph.setConnectCallback(on_connect);
Bluefruit.Periph.setDisconnectCallback(on_disconnect);
s_service.begin();
s_tx.setProperties(CHR_PROPS_NOTIFY);
s_tx.setPermission(SECMODE_OPEN, SECMODE_NO_ACCESS);
s_tx.setMaxLen(20);
s_tx.begin();
s_rx.setProperties(CHR_PROPS_WRITE | CHR_PROPS_WRITE_WO_RESP);
s_rx.setPermission(SECMODE_OPEN, SECMODE_OPEN);
s_rx.setMaxLen(20);
s_rx.setWriteCallback(on_rx_write);
s_rx.begin();
Bluefruit.Advertising.addFlags(BLE_GAP_ADV_FLAGS_LE_ONLY_GENERAL_DISC_MODE);
Bluefruit.Advertising.addTxPower();
Bluefruit.Advertising.addService(s_service);
Bluefruit.ScanResponse.addName();
Bluefruit.Advertising.restartOnDisconnect(true);
Bluefruit.Advertising.setInterval(160, 800); // 0.625 ms 単位: 100 ms(高速)〜 500 ms(低速)
Bluefruit.Advertising.setFastTimeout(30); // 最初の 30 秒は高速アドバタイズ
Bluefruit.Advertising.start(0); // 0 = 止めずに続ける
}
bool ble_is_connected()
{
return s_connected;
}
bool ble_send(const uint8_t *data, uint16_t len)
{
if (!s_connected || !s_tx.notifyEnabled())
return false;
return s_tx.notify(data, len);
}7.3.1 コールバックはイベントに変換するだけ
Bluefruit ライブラリのコールバック(接続・切断・書き込み)は、BLE のイベントを処理するタスク の中で呼ばれます。ここで重い処理をすると BLE 通信全体が滞るので、
- 接続・切断 →
EVT_BLE_CONNECTED/EVT_BLE_DISCONNECTED - 書き込み → コマンドを解釈して 対応するイベント ID に変換し、引数をペイロードとして積む
だけにしています。コマンドの意味(何をするか)は、状態遷移テーブルのハンドラが決めます。同じ「測定開始」コマンドでも、待機中なら測定を始め、測定中なら無視する —— という振る舞いが、BLE のコードを触らずにテーブルだけで決まります。
7.3.2 接続状態のフラグ
s_connected は、コールバックの中でイベントを積む 前に 更新しています。LED 表示(ui_update())や送信可否の判断(ble_send())は 「今、接続しているか」 を知りたいだけなので、フラグを直接読みます。一方、「接続されたときに何かする」という処理は、イベント(EVT_BLE_CONNECTED)のハンドラに書きます。
7.4 コマンドと応答のプロトコル
自作の BLE デバイスでは、バイト列の形式(プロトコル) を自分で決める必要があります。このサンプルでは、先頭 2 バイトで種類を表しています。
7.4.1 コマンド(スマホ → デバイス, RX に Write)
| バイト列 | 意味 | 対応するイベント |
|---|---|---|
00 01 |
機器情報取得 | EVT_BLE_CMD_GET_INFO |
01 00 |
測定開始 | EVT_BLE_CMD_MEAS_START |
01 01 |
測定停止 | EVT_BLE_CMD_MEAS_STOP |
02 01 |
最新値取得 | EVT_BLE_CMD_GET_LATEST |
7.4.2 応答・通知(デバイス → スマホ, TX の Notify)
| バイト列 | 意味 |
|---|---|
80 01 MJ MN PT |
機器情報(ファームウェアのバージョン) |
80 02 LL HH |
最新の合成加速度 [mg](リトルエンディアン 16 bit) |
81 00 SL SH N ML MH XL XH |
測定中に毎秒送る集計: 通し番号 (16 bit)、サンプル数、平均 [mg]、最大 [mg] |
#include "app_meas.h"
#include "drv_ble.h"
volatile uint16_t g_latest_acc_mg = 0;
MeasSummary g_last_summary = {};
static uint16_t s_seq = 0;
static uint8_t s_n = 0;
static uint32_t s_sum = 0;
static uint16_t s_max = 0;
void meas_begin()
{
s_seq = 0;
s_n = 0;
s_sum = 0;
s_max = 0;
g_last_summary = {};
}
void meas_add_sample(uint16_t acc_mg)
{
s_n++;
s_sum += acc_mg;
if (acc_mg > s_max)
s_max = acc_mg;
}
MeasSummary meas_close_second()
{
MeasSummary s;
s.seq = s_seq++;
s.n = s_n;
s.mean_mg = (s_n > 0) ? (uint16_t)(s_sum / s_n) : 0;
s.max_mg = s_max;
s_n = 0;
s_sum = 0;
s_max = 0;
g_last_summary = s;
return s;
}
// --- BLE 応答 ---------------------------------------------------------
// 応答の先頭 2 バイトは「種別」: 0x80 = 応答, 0x81 = 通知(測定データ)
void reply_info()
{
uint8_t buf[5] = {0x80, 0x01, FW_VERSION_MAJOR, FW_VERSION_MINOR, FW_VERSION_PATCH};
ble_send(buf, sizeof(buf));
}
void reply_latest()
{
uint16_t v = g_latest_acc_mg;
uint8_t buf[4] = {0x80, 0x02, (uint8_t)(v & 0xff), (uint8_t)(v >> 8)};
ble_send(buf, sizeof(buf));
}
void notify_summary(const MeasSummary &s)
{
uint8_t buf[9] = {
0x81, 0x00,
(uint8_t)(s.seq & 0xff), (uint8_t)(s.seq >> 8),
s.n,
(uint8_t)(s.mean_mg & 0xff), (uint8_t)(s.mean_mg >> 8),
(uint8_t)(s.max_mg & 0xff), (uint8_t)(s.max_mg >> 8),
};
ble_send(buf, sizeof(buf));
}
ヒントプロトコル設計のコツ
- 先頭に種類を表すバイト を置き、受け手が分岐しやすくする
- 多バイトの数値は エンディアン(バイト順) を決めて明記する(nRF52840 も JavaScript の
DataViewもリトルエンディアンを扱いやすい) - 1 回の Notify に入るのは、既定では 20 バイト(ATT MTU 23 − ヘッダ 3)。それを超えるデータは、MTU を大きくする交渉をするか、分割して送る
- 将来の拡張のため、バージョン取得コマンド を最初から用意しておく
7.5 アドバタイズの設定
| 設定 | 値 | 意味 |
|---|---|---|
setInterval(160, 800) |
100 ms / 500 ms | 高速モードと低速モードのアドバタイズ間隔(0.625 ms 単位) |
setFastTimeout(30) |
30 秒 | 起動・切断後の最初の 30 秒だけ高速で発信し、その後は低速にして省電力 |
restartOnDisconnect(true) |
切断されたら自動でアドバタイズを再開 |
アドバタイズ間隔が短いほど 見つかりやすく、接続が速い 代わりに、消費電力が増えます。
7.6 動作確認
スマホアプリ nRF Connect for Mobile(Nordic 製, iOS / Android)で確認できます。
- スキャンして
HANDSON_NRF52に接続する - TX キャラクタリスティック(
02b89422-…)の Notify を有効 にする - RX キャラクタリスティック(
9e32b171-…)に0001を書き込む → TX に80 01 01 00 00(バージョン 1.0.0)が届く 0100を書き込むと測定が始まり、LED が赤の点滅になり、毎秒81 00 …が届く
PC の Chrome / Edge からは、第 9 章の BLE コンソール を使って、このページから直接操作できます。