7  イベントの発生源 ③:BLE

7.1 BLE の基本用語

用語 意味
Peripheral(ペリフェラル) 接続を待つ側。このデバイス
Central(セントラル) 接続しに行く側。スマホ・PC
アドバタイズ ペリフェラルが「ここにいます」と周期的に発信するパケット。名前やサービス UUID を載せる
GATT 接続後のデータのやりとりの枠組み。サービス の中に キャラクタリスティック(値の入れ物)がある
Write セントラル → ペリフェラルへ値を書き込む
Notify ペリフェラル → セントラルへ値を送る(セントラルが購読を有効にしている場合のみ)
UUID サービス・キャラクタリスティックの識別子。独自のものは 128 bit のランダムな値を使う

7.2 このサンプルの GATT 構成

flowchart TB
  S["サービス<br/>1c6865f9-…"] --> RX["RX キャラクタリスティック (Write)<br/>9e32b171-…<br/>スマホ → デバイス: コマンド"]
  S --> TX["TX キャラクタリスティック (Notify)<br/>02b89422-…<br/>デバイス → スマホ: 応答・測定データ"]

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)で確認できます。

  1. スキャンして HANDSON_NRF52 に接続する
  2. TX キャラクタリスティック(02b89422-…)の Notify を有効 にする
  3. RX キャラクタリスティック(9e32b171-…)に 0001 を書き込む → TX に 80 01 01 00 00(バージョン 1.0.0)が届く
  4. 0100 を書き込むと測定が始まり、LED が赤の点滅になり、毎秒 81 00 … が届く

PC の Chrome / Edge からは、第 9 章の BLE コンソール を使って、このページから直接操作できます。