BLE Uart通信 (XIAO ESP32S3)
BLE Uart通信の舞台裏はclass Handy_BLE_Uartに任して便利に使う

2026.11.17 2025.7.12 Coskx Lab  

1 はじめに

ESP32でBluetooth Low Energy(BLE)通信(Nordic UART Service仕様)を行います。
ESP32はPeripheralとして働き,Centralとして働くAndroidデバイスと通信します。 BLE Uart通信に関するめんどうな記述をクラスHandy_BLE_Uartに任せ,初期化関数呼び出し,送信,受信を自分で記述するようにします。
(iPhoneやWindowsPCとのBLE通信も可能で,付録として本ページ本文の後ろに載せています。)
iPhone→ 付録2 WindowsPC→ 付録3



BLEコネクション通信では,Central(or Master or Observer)とPeripheral(or Slave or Broadcaster)の間で通信が行われます。
ここでは,AndroidをCentral,XIAO-ESP32S3をPeripheralとして使うことにします。
(PeripheralはServer,CentralはClientと説明されることもあります。)

Nordic UART Service (NUS)を使って通信します。
UUID定義は次の通りです。
SERVICE_UUID           6E400001-B5A3-F393-E0A9-E50E24DCCA9E
CHARACTERISTIC_UUID_RX 6E400002-B5A3-F393-E0A9-E50E24DCCA9E
CHARACTERISTIC_UUID_TX 6E400003-B5A3-F393-E0A9-E50E24DCCA9E

起動手順は次のようになります。

  1. Peripheralはアドバタイジングを行い,デバイス名やデバイスアドレスなどを発信します
    (この作業は面倒ですが,クラスHandy_BLE_Uartが行うので,プログラムは簡単になっています)
  2. Centralはスキャンして,アドバタイジングしているデバイスを見つけ,リストで表示します
  3. ユーザはCentralのリスト表示からデバイスを選択して,Centralから接続要求します
  4. Peripheralが接続を確認する(クラスHandy_BLE_Uartが行う)と,交信可能となります
  5. (交信が終了したら,ユーザはCentralから切断要求します)

なお,ここで紹介する交信例では,Central側の通信アプリは,アプリ起動の度に通信相手を探して接続するようになっているため,ペアリングを必要としていません。
ただし,Peripheral側がペアリング・ボンディングを要求する設定になっている場合は,Central側の通信アプリが接続動作の際に,Central側の設定機構(OSの一部)がペアリング・ボンディングを行ないます。(ユーザの作業が必要です)

2 使用環境

3 準備

3.1 ArduinoIDE

(1)jsonファイルのURL設定
Arduino IDEのメニューバーから[ファイルFile] -> [環境設定(Preferences)]
Additional board manager URLsに
https://espressif.github.io/arduino-esp32/package_esp32_index.json
を設定してOK
(2)ボードパッケージ(ボードサービスパッケージ)のインストール
ツール[Tools] > ボード[Board] > Boards Manager
検索boxに「ESP」を入力すると複数のボード候補が出てくるので
esp32 by Espressif Systems
をinstall
(3)ツール[Tools] > ボード[Board]でESP32を探すとXIAO ESP32S3が見つかるので,これを選ぶ。

3.2 XIAO ESP32S3

XIAO ESP32S3の説明書を読んで,ArduinoIDEで制作したプログラムをXIAO ESP32S3に転送する方法を確認しておきます。
(USBケーブルでつないで書き込むだけです。)

4 XIAO ESP32S3のスケッチコード(Peripheralプログラム)

プログラム例の動作
(1)ESP32S3側がbleuart.begin() でアドバタイジングします。
 自分の名前を送信しながら「私はここです。誰か見つけて!」という動作です。
 (この作業は舞台裏ラッパークラスで進行するので,プログラムコードには現れません)
(2)この時,スマホなどのターミナルソフトが,ESP32S3のアドバタイズを
 見つけるので,スマホ側でユーザが接続(コネクト)操作をすると,接続が完成します。
 (この作業は舞台裏ラッパークラス内で進行しています)
(3)コネクトが完成した後,通信相手の機器から文字列を受け取り,
 文字列が「go」だったら,現在時刻(起動してからmilli秒)を1秒ごとに送信し,
 文字列が「stop」だったら現在時刻の送信をやめます。

ラッパークラスHandy_BLE_Uart
プログラムではアドバタイジングを含むBLE通信の面倒なところをラッパークラスHandy_BLE_Uartに任せることにして,別ファイルに書いています。
ラッパークラスHandy_BLE_Uartの定義は「Handy_BLE_Uart.h」と「Handy_BLE_Uart.cpp」に書かれています。
ダウンロード,解凍して次のプログラムコードBLE_uart_DEMO.inoと同じフォルダに入れてください。

  Handy_BLE_Uartのダウンロード
  ※2026.11.7更新 Ver 3.8

フォルダBLE_uart_DEMOにプログラムBLE_uart_DEMO.ino,Handy_BLE_Uart.h,Handy_BLE_Uart.cppを入れたところを示します。 そうすると,ArduinoIDEの画面の上部にそれぞれのファイル名が表示されるようになり,クリックするとArduinoIDEでファイルの中を見ることができます。



デバイス名
通信相手のAndroidスマホなどから見つけてもらう自分(ESP32S3)の名前が必要です。 ラッパークラスHandy_BLE_Uartの初期化の時点で決定しますので,プログラムの最初に書いておきます。 DEVICENAME "eps32-uart-demo"

ペアリング・ボンディング
なお,ペアリング・ボンディングを要求したい場合は,プログラムBLE_uart_DEMO.inoの 初期化のときに
bleuart.begin(DEVICENAME);
ではなく
bleuart.begin(DEVICENAME, 123456);
のように6桁のパスキーを追加します。(デフォルトでパスキーは必ず6桁の数です。)

コールバック方式とポーリング方式
受信時の扱いはコールバック方式とポーリング方式があります。

〇コールバック方式では,setup()で受信時に呼び出してもらう関数の名前を登録しておき, 受信時には,他の作業とは無関係にその関数を呼び出してもらいます。
その関数は引数に文字列変数を持っていて,その文字列が受信した文字列です。
その関数内には最小限必要な作業を記述します。
受信頻度が低い場合にはこの方式が都合がよいです。
「5 XIAO ESP32S3のスケッチコード」参照

〇ポーリング方式ではsetup()ではなにもしませんが,loop()中で,受信しているかどうかを専用関数で問い合わせ, 受信していたら改めて受信文字列を別の専用関数で受け取って必要な作業を行います。
「6 XIAO ESP32S3のスケッチコード」参照

ラッパークラスHandy_BLE_Uartでは,受信用,送信用のタスクが動作しているため,CPUの負担はどちらの方式も同じです。
ポーリング方式ではloop()の起動周期でしか(loop()内のdelay()に多くを依存します),受信をチェックできないことが前提のプログラムになります。


5 XIAO ESP32S3のスケッチコード(コールバック方式のPeripheralプログラム)

コールバック方式での記述は次の特徴があります。
(1)受信時に受信文字列を伴って呼び出される関数を作ります。
この関数内では受信文字列に対応した最小限の作業を記述します。
関数の名前は任意です。
次のスケッチコードでは関数void processReceivedString(String str)になっています。
(2)setup()内でクラスHandy_BLE_Uartのインスタンスbleuartを初期化しますが, その時に文字列受信関数をインスタンスbleuartに登録します。
 bleuart.setCallbackFunc(StringReceptionReport);


   BLE_uart_DEMO.ino(コールバック方式)のプログラムコード

//BLE_uart_DEMO.ino//
//XIAO-ESP32S3

#include <Handy_BLE_Uart.h>

#define DEVICENAME "eps32-uart-demo"

Handy_BLE_Uart bleuart;

void setup() {
  Serial.begin(115200);
  delay(300);
  //受信時に呼び出されるコールバック関数の登録 必須
  bleuart.setCallbackFunc(StringReceptionReport);
  //接続時にCentralに送信する最初のメッセージの設定 必要があったら記述
  bleuart.setInitialMessage("send me 'go' or 'stop'");
  //初期化 (パスキーによるペアリングを行う場合は6桁(必ず6桁)のパスキーを付ける)
  //引数:自分のデバイス名登録,(パスキー)
  bleuart.begin(DEVICENAME);
  //bleuart.begin(DEVICENAME, 123456);
  delay(1000);
}

bool requested = false;

void loop() {
  if (bleuart.isConnected()) {
    //Centralに接続中の場合
    if (requested) {
      long currenttime = millis();
      //文字列 String(currenttime) を送信
      //起動からの経過時間をミリ秒で表示
      bleuart.transferString(String(currenttime));
    }
  } else {
    requested = false;
  }
  delay(1000);
}

//受信時に呼び出されるコールバック関数
void StringReceptionReport(String str) {
  Serial.println("RX_Value = " + str);
  //開発初期の確認用エコーバック 不要になったらコメントアウトして送信を減らす
  bleuart.transferString(str);
  if (str.indexOf("go") == 0) requested = true;
  else if (str.indexOf("stop") == 0) requested = false;
}

プログラムコードに関して補足します。
(1)setup中では,
  〇受信時に呼び出されるコールバック関数の登録
   bleuart.setCallbackFunc()
  〇接続時にCentralに送信するメッセージの設定
   bleuart.setInitialMessage()
  〇初期化
  bleuart.begin()
 の3つを行い,loop中では
  〇centralに接続中なら何かの仕事をします
   if (bleuart.isConnected()) {
 で作業を記述します。
(2)centralへ文字列を送信するときは
  bleuart.transferString()
 を使います。
(3)centralから文字列を受信した場合はsetup()で登録したコールバック関数
  StringReceptionReport()
 が舞台裏(クラスHandy_BLE_Uartのインスタンスbleuart)から呼び出されます。


参考 よくあるサンプルプログラムコード

ここでは細かな説明をしませんが,ラッパークラスHandy_BLE_Uartを使用しないで, すべてを1つのプログラムコードとして記述すると次のようになります。

   BLE_uart_justtest.inoのプログラムコード   



6 XIAO ESP32S3のスケッチコード(ポーリング方式のPeripheralプログラム)

〇ポーリング方式ではsetup()でcallback関数登録が不要です。loop()中で,受信しているかどうかを専用関数で問い合わせ, 受信していたら改めて別の専用関数で受信文字列を受け取って必要な作業を行います。
    if (bleuart.ReceivedStringReady()) { //Polling
        processReceivedString(bleuart.getReceivedString());
    }

ポーリング方式でのプログラムコードは次のようになります。


   BLE_uart_DEMO2.ino(ポーリング方式)のプログラムコード

//BLE_uart_DEMO2.ino//
//XIAO-ESP32S3

#include <Handy_BLE_Uart.h>

#define DEVICENAME "eps32-uart-demo"

Handy_BLE_Uart bleuart;

void setup() {
  Serial.begin(115200);
  delay(300);
  //接続時にCentralに送信する最初のメッセージの設定 必要があったら記述
  bleuart.setInitialMessage("send me 'go' or 'stop'");
  //初期化 (パスキーによるペアリングを行う場合は6桁(必ず6桁)のパスキーを付ける)
  //引数:自分のデバイス名登録,(パスキー)
  bleuart.begin(DEVICENAME);
  //bleuart.begin(DEVICENAME, 123456);
  delay(1000);
}

bool requested = false;

void loop() {
  if (bleuart.isConnected()) {
    if (bleuart.ReceivedStringReady()) { //Polling
      processReceivedString(bleuart.getReceivedString());
    }
    //Centralに接続中の場合
    if (requested) {
      long currenttime = millis();
      //文字列 String(currenttime) を送信
      //起動からの経過時間をミリ秒で表示
      bleuart.transferString(String(currenttime));
    }
  } else {
    requested = false;
  }
  delay(1000);
}

//受信文字列の処理
void processReceivedString(String str) {
  Serial.println("RX_Value = " + str);
  //開発初期の確認用エコーバック 不要になったらコメントアウトして送信を減らす
  bleuart.transferString(str);
  if (str.indexOf("go") == 0) requested = true;
  else if (str.indexOf("stop") == 0) requested = false;
}

7 Androidスマホアプリ"Serial Bluetooth Terminal"の準備

Google Playから,"Serial Bluetooth Terminal"をダウンロードしてインストールします。

  "Serial Bluetooth Terminal"のアイコン

最初の起動で,メニュー等の探検をします。
〇左上三本線メニューでは
settings→terminal→Show timestampをONにしておくとよいでしょう。
settings→terminal→Buffer sizeは表示内容を保存する作業メモリのサイズです。できるだけ大きくとるのが良いと思います。(200kBでは100文字のデータ約2000行分です。場合によっては無制限もあり)
settings→Receiveは,NLを設定してください。
settings→Send→Local echoはONが標準です。自分が送信した文字列も表示されます。
settings→Misc.→Save....は表示内容(LOG)保存先フォルダの設定です。
〇右上3点メニューには
Data→Saveがあって,表示内容を保存の時使います。

8 XiaoESP32S3と"Serial Bluetooth Terminal"の通信

事前のペアリング作業は不要です。
先にXiaoESP32S3に電源を与え,立ち上げておきます。(XiaoESP32S3はアドバタイジング中となる)

その後,"Serial Bluetooth Terminal"で 左上三本線メニューでDevices→BluetoothLE→SCAN で付近のBLEデバイスを見つけて表示してくれます。
ここでは,XiaoESP32S3のプログラムの
   #define DEVICENAME "eps32-uart-demo"
でつけた名前"eps32-uart-demo"が見つかるのでこれをタップします。

  Serial Bluetooth Terminalデバイス選択画面

これでコネクトが完成します。

"Serial Bluetooth Terminal"から"go"を送信すると,1秒ごとに時刻データが送信されてきます。
"Serial Bluetooth Terminal"から"stop"を送信すると,データ送信が止まります。
画面上の受信データは,右上3点メニューからData→Saveでファイル保存することができます。

"Serial Bluetooth Terminal"から"go"や"stop"を送信するときは,画面下部のテキストボックスに入力して送信ボタンをタップするか,予めマクロボタンに"go"や"stop"の文字列を登録(マクロボタンのタップ&ホールドで登録出来る)しておいて,それらのボタンをタップます。
次の通信画面では,予めマクロボタンに"go"や"stop"の文字列が登録されています。


    Serial Bluetooth Terminal通信画面

9 まとめ

ESP32S3でBLEuart通信する舞台裏作業をラッパークラスHandy_BLE_Uartに封入して,メイン側プログラムの負担を減らしました。
Androidスマホからの指令によって文字列をXIAO ESP32S3が送るプログラム例を示しました。



この記事ではAndroidスマホのアプリ"Serial Bluetooth Terminal"を使いました。
Androidスマホでは,他にも"Bluefruit Connect"というアプリがあり,同じような使い方が出来ます。 → 付録1
iPhoneにもアプリ"Bluefruit Connect"がありAndroid版"Bluefruit Connect"と同じ使い方ができます。
WindowsPCにも同様なアプリ"BLE_serial_terminal"があり,同様の使い方ができます。 → 付録2
接続作業などは以下を参考にしてください。
  iOSデバイスとの接続
  WindowsPCとの接続

追加情報

ボードパッケージ「ESP32 by Espressif Systems Ver3.3.6」ではBLE関連のライブラリが動作不調になりましたが,「ESP32 by Espressif Systems Ver3.3.7」で解消されました。
これによって,ESP32の標準ライブラリのBLEが舞台裏でNimBLEに変更されています。

NimBLE用として開発されたライブラリNimBLE-Arduino/h2zero 2.4.0は,これまでNimBLEを使う際の標準的なライブラリでした。しかしセキュリティ・ペアリング・ボンディングが,このライブラを利用した機器同士でしか動作が保証されないため,ESP32の標準ライブラリのBLEを使用するのが良いと思われます。
20260218




      付録 目次

付録1 Android版,iOS版 共通アプリ "Bluefruit Connect"
付録2 iOSアプリ "Serial BLE Console"
付録3 WindowsPCアプリ "BLE_serial_terminal"

付録1 Android版,iOS版 共通アプリ "Bluefruit Connect"

アプリ"Bluefruit Connect"にはAndroid版とiOS版があり,同じ操作で使うことができて便利です。

付録 1-1 アプリ"Bluefruit Connect"の準備

Android playあるいはApp Storeから,"Bluefruit Connect"をダウンロードしてインストールします。

  "Bluefruit Connect"のアイコン

付録 1-2 XiaoESP32S3と"Bluefruit Connect"の通信

事前のペアリング作業は不要です。
先にXiaoESP32S3に電源を与え,立ち上げておきます。

その後,"Bluefruit Connect"を立ち上げると最初にSelect Deviceの画面になります。
ここでは,XiaoESP32S3のプログラムの
   #define DEVICENAME "eps32-uart-demo"
でつけた名前"eps32-uart-demo"が見つかるのでconnectボタンをタップします。

  Bluefruit Connectデバイス選択画面

次にModulesと書かれたモジュール選択画面になりますので,UARTを選択します。

  Bluefruit Connectモジュール選択画面

UARTの白い画面になったら,"Bluefruit Connect"から"go"を送信すると,1秒ごとにデータが送信されてきます。
"Bluefruit Connect"から"stop"を送信すると,データ送信が止まります。
"Bluefruit Connect"から"go"や"stop"を送信するときは,画面下部のテキストボックスに入力してSENDボタンをタップします。


    Bluefruit Connect通信画面

画面上の送受信データの表示形式は,右上メニューからDisplay Modeで切り替えられます。
(time stamp付きの表示もできます。)

画面上の送受信データのファイルへの保存は,右上メニューからExportで出来ます。
保存形式をcsvにするとtime stamp付きでの保存になります。

なお,このアプリでは「Bluefruit Connectモジュール選択画面」で「Controller」を選択すると次のようなコントロールパッドが表示され,ボタンタッチ開始と終了に対応して文字列が送信されます。
送信される文字列は「!B507」のような形式で画面上部に表示されています。この文字列は固定でカスタマイズすることはできないようです。


    Control Pad通信画面




付録2 iOSアプリ "Serial BLE Console"

iPhone,iPadで使用できるBLEターミナルアプリ(無料)でApp Storeから入手可能です。
(同アプリのAndroid版もあり,Google Playから入手可能です。)
カスタマイズ可能なボタンが100個ほどあります。
Androidスマホのアプリ"Serial Bluetooth Terminal"とほとんど同じことができそうです。
私はiPhoneユーザではないので知人の高校の先生に接続+双方向送受信をチェックをしてもらいました。
iPhoneのbluetoothを有効にし,アプリにbluetoothの利用を許可してください。

事前のペアリング作業は不要です。
先にXiaoESP32S3に電源を与え,立ち上げておきます。

アプリ起動後,最初に周辺デバイスをスキャンします。
ここでは,XiaoESP32S3のプログラムの
   #define DEVICENAME "eps32-uart-demo"
でつけた名前"eps32-uart-demo"が見つかるのでこれをクリックして選択します。
UARTの画面になったら,"Serial BLE Console"から"go"を送信すると,1秒ごとにデータが送信されてきます。
"Serial BLE Console"から"stop"を送信すると,データ送信が止まります。
これは想定された動作です。
"Serial BLE Console"から"go"や"stop"を送信するときは,画面下部のEnter command・・・と書いてあるテキストボックスに入力して,紙飛行機型のSENDボタンをタップします。

入手先(無料)   Serial BLE Console"
  
    画面イメージとアプリアイコン

    動作の様子




付録3 WindowsPCアプリ"BLE_serial_terminal"

アプリ"BLE_serial_terminal"はWindowsPC用のターミナルアプリです。
WindowsPCにはbluetooth(4.2以上)が使えることが必要です。
次のように使います。


付録 3-1 WindowsPCアプリ"BLE_serial_terminal"の準備

Githubから"BLE_serial_terminal"β版をダウンロードします。(無料)
  Github "BLE_serial_terminal"


  "BLE_serial_terminal"のアイコン

付録 3-2 XiaoESP32S3と"BLE_serial_terminal"の通信

事前のペアリング作業は不要です。
先にXiaoESP32S3に電源を与え,立ち上げておきます。

その後,"BLE_serial_terminal.exe"を立ち上げるとすぐにBruetoothLEデバイスをスキャンして選択リストに表示します。
ここでは,XiaoESP32S3のプログラムの
   #define DEVICENAME "eps32-uart-demo"
でつけた名前"eps32-uart-demo"が見つかるのでこれをクリックして選択します。
見つからなかったら,ボタン"Scan BLE Dev"をクリックして,にBruetoothLEデバイスを再スキャンします。

選択したら,ボタンConnectをクリックします。>connectedが表示されたら,通信準備完了です。
"Time Stamp"および"Local Echo"のオプションをONにしておくとよいでしょう。

"BLE_serial_terminal"から"go"を送信すると,1秒ごとにデータが送信されてきます。
"BLE_serial_terminal"から"stop"を送信すると,データ送信が止まります。
"BLE_serial_terminal"から"go"や"stop"を送信するときは,画面上部のテキストボックスに入力してボタンSendをクリックします。

"BLE_serial_terminal"から"go"や"stop"を送信するときは,画面下部のテキストボックスに入力して送信ボタンをタップするか,予めマクロボタンに"go"や"stop"の文字列を登録(マクロボタンを右ボタンクリックで登録出来る)しておいて,それらのボタンをクリックします。
次の通信画面では,予めマクロボタンに"go"や"stop"の文字列が登録されています。


    BLE_serial_terminal 通信画面

画面上の送受信データのファイルへの保存は,右上のボタン"Save Log"で出来ます。