BLE Uart通信舞台裏はclass Handy_BLE

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

ESP32でBLE Uart通信を行いますが，BLE Uart通信に関する記述をクラス化し，初期化，送信，受信を自分で記述するようにします。
ここではAndroidデバイスとの通信を例として載せましたが，iOS機器やWindowsPC相手の通信も可能です。
BLE UART Profileを使って通信します。（Bluetooth Classicではありません。）

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

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

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

３．１　ArduinoIDE

(1)Arduino IDEのメニューバーから[ファイルFile] -> [環境設定(Preferences)]
Additional board manager URLsに
https://files.seeedstudio.com/arduino/package_seeeduino_boards_index.json
および
https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
を設定してOK
(2)ツール[Tools] > ボード[Board] > Boards Manager
検索boxに「ESP」を入力すると複数のボード候補が出てくるので
esp32 by Espressif Systems
をinstall
(3)ツール[Tools] > ボード[Board]でESP32を探すとXIAO ESP32S3が見つかるので，これを選ぶ。

３．２　XIAO ESP32S3

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

プログラムでは，BLEスタックを初期化して，通信先が接続操作を行うと接続が完了します。
　(1)ESP32S3側がbleuart.begin() でアドバタイジングします。
　　（自分の名前を送信しながら私はここです。誰か見つけて！）
　(2)この時，スマホなどのターミナルソフトが，ESP32S3のアドバタイジングを
　　見つけるので，スマホ側が接続（コネクト）操作をすると，接続が完成します。

このプログラムでは，コネクトが完成した後，通信相手の機器から文字列を受け取り，文字列が「go」だったら，現在時刻（起動してからmilli秒）を１秒ごとに送信し，文字列が「stop」だったら現在時刻の送信をやめます。

このプログラムでは受信時にやるべきことを記述した関数は，void StringReceptionReport(String str)としました。送られてくるstrが受信した文字列です。（受信時にやるべきことを記述した関数の名前は別のものでもOKです）
やるべきこととは，「go」「stop」によりブール変数「requested」のtrue falseを切り替えることです。
ESP32S3側が送信するときは，関数transferString()を使います。

DEVICENAME "eps32-uart-demo"
は自分の名前です。通信相手のAndroidスマホなどから見つけてもらう名前です。初期化の時点で決定します。

このプログラムではBLE通信の面倒なところをクラスHandy_BLE_Uartにして別ファイルに書いています。

クラスHandy_BLE_Uartの定義は「Handy_BLE_Uart.h」と「Handy_BLE_Uart.cpp」に書かれています。
ダウンロード，解凍して次のプログラムコードBLE_uart_DEMO.inoと同じフォルダに入れてください。

　　Handy_BLE_Uartのダウンロード

なお，ペアリング・ボンディングを要求したい場合は，クラスHandy_BLE_Uart.cppの中のコメントアウトされている#defineを有効に戻せばよいようになっています。
６桁のpasskeyも#defineのところに書きます。

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

　　　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'");
//初期化
//引数：自分のデバイス名登録，受信文字列のエコーバックの有無
bleuart.begin(DEVICENAME, true);
delay(1000);
}

bool requested = false;

void loop() {
bleuart.RegularWorkInLoop();
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);
if (str.indexOf("go") == 0) requested = true;
else if (str.indexOf("stop") == 0) requested = false;
}

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

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があって，表示内容を保存の時使います。

先に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通信画面

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

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

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

Android playから，"Bluefruit Connect"をダウンロードしてインストールします。

　　"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付きでの保存になります。

アプリ"BLE_serial_terminal"はWindowsPC用のターミナルアプリです。

先に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"で出来ます。

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

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