Bluetooth 使用方法

note

この文書は AI によって翻訳されています。内容に不正確な点や改善すべき点がございましたら、文書下部のコメント欄または以下の Issue ページにてご報告ください。
https://github.com/Seeed-Studio/wiki-documents/issues

Seeed Studio XIAO ESP32C6 の Bluetooth 使用方法

Seeed Studio XIAO ESP32C6

今すぐ購入 🖱️

Seeed Studio XIAO ESP32C6 は、Bluetooth 5、BLE、およびメッシュネットワーキングをサポートする強力な開発ボードであり、ワイヤレス接続を必要とする幅広い IoT アプリケーションに最適です。優れた RF パフォーマンスを備えた XIAO ESP32C6 は、さまざまな距離で信頼性が高く高速なワイヤレス通信を提供でき、短距離および長距離のワイヤレスアプリケーションの両方に対応する汎用的なソリューションです。このチュートリアルでは、XIAO ESP32C6 の Bluetooth 機能の基本的な特徴、例えば近くの Bluetooth デバイスをスキャンする方法、Bluetooth 接続を確立する方法、Bluetooth 接続を介してデータを送受信する方法に焦点を当てます。

Bluetooth Low Energy (BLE) の使用方法

Bluetooth Low Energy（略して BLE）は、電力を節約するための Bluetooth のバリアントです。BLE の主な用途は、少量のデータ（低帯域幅）の短距離伝送です。常にオンの状態である Bluetooth とは異なり、BLE は接続が開始されるとき以外は常にスリープモードのままです。

その特性により、BLE はコイン電池で動作し、定期的に少量のデータを交換する必要があるアプリケーションに適しています。例えば、BLE は医療、フィットネス、トラッキング、ビーコン、セキュリティ、ホームオートメーション業界で非常に役立ちます。

これにより、非常に低い電力消費を実現します。BLE は Bluetooth に比べて約 100 倍少ない電力を消費します（使用ケースによります）。

XIAO ESP32C6 の BLE 部分については、以下の 3 つのセクションでその使用方法を紹介します。

いくつかの基本概念 -- BLE プログラムの実行プロセスや考え方を理解するために、BLE で頻繁に使用される可能性のあるいくつかの概念を最初に学びます。
BLE スキャナー -- このセクションでは、近くの Bluetooth デバイスを検索し、それらをシリアルモニターに出力する方法を説明します。
BLE サーバー/クライアント -- このセクションでは、XIAO ESP32C6 をサーバーおよびクライアントとして使用し、指定されたデータメッセージを送受信する方法を説明します。また、スマートフォンから XIAO にメッセージを送受信する方法も説明します。
BLE センサーデータ交換 -- このチュートリアルの最後のセクションでは、センサーの例を通じて、センサーデータを BLE 経由で送信する方法を説明します。

いくつかの基本概念

サーバーとクライアント

Bluetooth Low Energy では、デバイスにはサーバーとクライアントの 2 種類があります。XIAO ESP32C6 はクライアントまたはサーバーのいずれかとして動作できます。

サーバーは自分の存在を広告し、他のデバイスに見つけられるようにし、クライアントが読み取れるデータを含みます。クライアントは近くのデバイスをスキャンし、目的のサーバーを見つけると接続を確立し、受信データをリッスンします。これをポイントツーポイント通信と呼びます。

アトリビュート

アトリビュート（Attribute）は実際にはデータの一部です。各 Bluetooth デバイスはサービスを提供するために使用され、サービスはデータの集合体であり、この集合体はデータベースと呼ぶことができます。データベース内の各エントリがアトリビュートです。ここでは、アトリビュートをデータエントリと訳します。Bluetooth デバイスをテーブルとして想像すると、テーブル内の各行がアトリビュートです。

GATT

2 つの Bluetooth デバイスが接続を確立するとき、通信方法を決定するためのプロトコルが必要です。GATT（Generic Attribute Profile）は、Bluetooth デバイス間でデータがどのように送信されるかを定義するプロトコルです。

GATT プロトコルでは、デバイスの機能とプロパティは、サービス、キャラクタリスティック、およびディスクリプタと呼ばれる構造に編成されています。サービスは、デバイスが提供する関連機能と特徴のセットを表します。各サービスには複数のキャラクタリスティックを含めることができ、これらはサービスの特定のプロパティや動作（例：センサーデータや制御コマンド）を定義します。各キャラクタリスティックには一意の識別子と値があり、通信のために読み取りまたは書き込みが可能です。ディスクリプタは、キャラクタリスティックのメタデータ（例：キャラクタリスティック値の形式やアクセス許可）を記述するために使用されます。

GATT プロトコルを使用することで、Bluetooth デバイスはセンサーデータの送信やリモートデバイスの制御など、さまざまなアプリケーションシナリオで通信できます。

BLE キャラクタリスティック

ATT（Attribute Protocol）は、アトリビュートプロトコルの正式名称です。最終的に、ATT は一連の ATT コマンド（リクエストおよびレスポンスコマンド）で構成されます。ATT は Bluetooth の最上位層であり、Bluetooth パケットを解析する際に最も使用される部分です。

ATTコマンドは正式にはATT PDU（プロトコルデータユニット）として知られています。これには4つのカテゴリがあります：読み取り、書き込み、通知、そして指示です。これらのコマンドは2つのタイプに分けることができます。応答が必要な場合はリクエストが続きます。一方、ACK（確認応答）のみが必要で応答が不要な場合はリクエストが続きません。

サービスとキャラクタリスティックはGATT層で定義されています。サービス側はサービスを提供し、サービスはデータであり、データは属性です。サービスとキャラクタリスティックはデータの論理的な表現であり、ユーザーが見ることのできるデータは最終的にサービスとキャラクタリスティックに変換されます。

モバイルの視点からサービスとキャラクタリスティックがどのように見えるかを見てみましょう。nRF Connectは各パケットがどのように見えるべきかを非常に視覚的に示してくれるアプリケーションです。

ご覧の通り、Bluetooth仕様では、各特定のBluetoothアプリケーションは複数のサービスで構成されており、各サービスは複数のキャラクタリスティックで構成されています。キャラクタリスティックはUUID、プロパティ、そして値で構成されています。

プロパティはキャラクタリスティックに対する操作の種類と権限を記述するために使用されます。例えば、読み取り、書き込み、通知などをサポートするかどうかを示します。これはATT PDUに含まれる4つのカテゴリと似ています。

UUID

各サービス、キャラクタリスティック、そしてディスクリプタにはUUID（ユニバーサルユニーク識別子）が存在します。UUIDは128ビット（16バイト）の一意の番号です。例えば：

ea094cbd-3695-4205-b32d-70c1dea93c35

Bluetooth Special Interest Group (SIG)で指定されたすべてのタイプ、サービス、プロファイルには短縮されたUUIDがあります。しかし、アプリケーションが独自のUUIDを必要とする場合は、このUUID生成ウェブサイトを使用して生成できます。

BLEスキャナー

XIAO ESP32C6 BLEスキャナーを作成するのは簡単です。以下はスキャナーを作成するサンプルプログラムです。

#include <BLEDevice.h>
#include <BLEUtils.h>
#include <BLEScan.h>
#include <BLEAdvertisedDevice.h>

int scanTime = 5; //秒単位
BLEScan* pBLEScan;

class MyAdvertisedDeviceCallbacks: public BLEAdvertisedDeviceCallbacks {
    void onResult(BLEAdvertisedDevice advertisedDevice) {
      Serial.printf("Advertised Device: %s \n", advertisedDevice.toString().c_str());
    }
};

void setup() {
  Serial.begin(115200);
  Serial.println("Scanning...");

  BLEDevice::init("");
  pBLEScan = BLEDevice::getScan(); //新しいスキャンを作成
  pBLEScan->setAdvertisedDeviceCallbacks(new MyAdvertisedDeviceCallbacks());
  pBLEScan->setActiveScan(true); //アクティブスキャンはより多くの電力を使用しますが、結果をより早く取得します
  pBLEScan->setInterval(100);
  pBLEScan->setWindow(99);  // setInterval値以下または同等
}

void loop() {
  // 繰り返し実行するメインコードをここに記述
  BLEScanResults foundDevices = *pBLEScan->start(scanTime, false);
  Serial.print("Devices found: ");
  Serial.println(foundDevices.getCount());
  Serial.println("Scan done!");
  pBLEScan->clearResults();   // BLEScanバッファから結果を削除してメモリを解放
  delay(10000);
}

次にXIAO ESP32C6マザーボードを選択してプログラムをアップロードします。プログラムが正常に動作すれば、シリアルモニターを開いてボーレートを115200に設定すると、以下の結果が表示されます。

このプログラムはスキャンされたBluetoothデバイスの名前、MACアドレス、製造者データ、信号を出力します。

プログラムの注釈

必要なBLE機能のライブラリをインポートすることから始まります。

次に、BLEAdvertisedDeviceCallbacksクラスを継承したMyAdvertisedDeviceCallbacksというクラスを定義します。このクラスには、スキャン中に広告されたBluetoothデバイスが見つかったときに呼び出されるonResultという関数があります。この関数はデバイスの情報をシリアルポートに出力します。このクラスはスキャン中にBluetoothデバイス情報を処理するために使用できます。

class MyAdvertisedDeviceCallbacks: public BLEAdvertisedDeviceCallbacks {
    void onResult(BLEAdvertisedDevice advertisedDevice) {
      Serial.printf("Advertised Device: %s \n", advertisedDevice.toString().c_str());
    }
};

Setup関数では、指定されたパラメータ（スキャン間隔とウィンドウ値を含む）でBLEスキャンを設定します。また、BLEデバイスを初期化し、スキャン中に見つかった広告デバイスを処理するためのコールバック関数を設定します。

BLEDevice::init("");
pBLEScan = BLEDevice::getScan();
pBLEScan->setAdvertisedDeviceCallbacks(new MyAdvertisedDeviceCallbacks());
pBLEScan->setActiveScan(true);
pBLEScan->setInterval(100);
pBLEScan->setWindow(99);

最後に、loop関数では、指定されたスキャン時間とブロッキングフラグでBLEスキャンを開始します。その後、見つかったデバイスの数をシリアルポートに出力し、結果バッファをクリアしてメモリを解放します。

BLEScanResults foundDevices = *pBLEScan->start(scanTime, false);
Serial.print("Devices found: ");
Serial.println(foundDevices.getCount());
Serial.println("Scan done!");
pBLEScan->clearResults();

BLEサーバー/クライアント

前述のように、XIAO ESP32C6はサーバーとしてもクライアントとしても動作できます。サーバーとしてのプログラムとその使用方法を見てみましょう。以下のプログラムをXIAOにアップロードすると、サーバーとして動作し、接続されたすべてのBluetoothデバイスに「Hello World」メッセージを送信します。

// サーバーコード
#include <BLEDevice.h>
#include <BLEUtils.h>
#include <BLEServer.h>

#define SERVICE_UUID        "4fafc201-1fb5-459e-8fcc-c5c9c331914b"
#define CHARACTERISTIC_UUID "beb5483e-36e1-4688-b7f5-ea07361b26a8"

void setup() {
  Serial.begin(115200);
  Serial.println("Starting BLE work!");

  BLEDevice::init("XIAO_ESP32C6");
  BLEServer *pServer = BLEDevice::createServer();
  BLEService *pService = pServer->createService(SERVICE_UUID);
  BLECharacteristic *pCharacteristic = pService->createCharacteristic(
                                         CHARACTERISTIC_UUID,
                                         BLECharacteristic::PROPERTY_READ |
                                         BLECharacteristic::PROPERTY_WRITE
                                       );

  pCharacteristic->setValue("Hello World");
  pService->start();
  // BLEAdvertising *pAdvertising = pServer->getAdvertising();  // これは後方互換性のためにまだ動作します
  BLEAdvertising *pAdvertising = BLEDevice::getAdvertising();
  pAdvertising->addServiceUUID(SERVICE_UUID);
  pAdvertising->setScanResponse(true);
  pAdvertising->setMinPreferred(0x06);  // iPhone接続問題を解決するための関数
  pAdvertising->setMinPreferred(0x12);
  BLEDevice::startAdvertising();
  Serial.println("Characteristic defined! Now you can read it in your phone!");
}

void loop() {
  // 繰り返し実行するメインコードをここに記述
  delay(2000);
}

一方で、主要なモバイルアプリストアで nRF Connect アプリを検索してダウンロードすることができます。このアプリを使用すると、スマートフォンでBluetoothデバイスを検索して接続することができます。

Android: nRF Connect
IOS: nRF Connect

ソフトウェアをダウンロードした後、以下の手順に従って XIAO ESP32C6 を検索して接続します。接続後、広告された "Hello World" を確認することができます。

別の XIAO ESP32C6 をクライアントとして使用し、サーバーからメッセージを受信したい場合は、以下の手順を使用してクライアント XIAO を設定できます。

// クライアントコード
#include "BLEDevice.h"
//#include "BLEScan.h"

// 接続したいリモートサービスのUUID
static BLEUUID serviceUUID("4fafc201-1fb5-459e-8fcc-c5c9c331914b");
// 関心のあるリモートサービスの特性UUID
static BLEUUID    charUUID("beb5483e-36e1-4688-b7f5-ea07361b26a8");

static boolean doConnect = false;
static boolean connected = false;
static boolean doScan = false;
static BLERemoteCharacteristic* pRemoteCharacteristic;
static BLEAdvertisedDevice* myDevice;

static void notifyCallback(
  BLERemoteCharacteristic* pBLERemoteCharacteristic,
  uint8_t* pData,
  size_t length,
  bool isNotify) {
    Serial.print("特性の通知コールバック: ");
    Serial.print(pBLERemoteCharacteristic->getUUID().toString().c_str());
    Serial.print(" データ長: ");
    Serial.println(length);
    Serial.print("データ: ");
    Serial.write(pData, length);
    Serial.println();
}

class MyClientCallback : public BLEClientCallbacks {
  void onConnect(BLEClient* pclient) {
  }

  void onDisconnect(BLEClient* pclient) {
    connected = false;
    Serial.println("切断されました");
  }
};

bool connectToServer() {
    Serial.print("接続を形成中: ");
    Serial.println(myDevice->getAddress().toString().c_str());
    
    BLEClient*  pClient  = BLEDevice::createClient();
    Serial.println(" - クライアント作成完了");

    pClient->setClientCallbacks(new MyClientCallback());

    // リモートBLEサーバーに接続
    pClient->connect(myDevice);  // BLEAdvertisedDeviceを渡すと、ピアデバイスアドレスのタイプ（パブリックまたはプライベート）が認識されます
    Serial.println(" - サーバーに接続しました");
    pClient->setMTU(517); // クライアントがサーバーから最大MTUを要求するよう設定（デフォルトは23）

    // リモートBLEサーバー内のサービスへの参照を取得
    BLERemoteService* pRemoteService = pClient->getService(serviceUUID);
    if (pRemoteService == nullptr) {
      Serial.print("サービスUUIDが見つかりませんでした: ");
      Serial.println(serviceUUID.toString().c_str());
      pClient->disconnect();
      return false;
    }
    Serial.println(" - サービスが見つかりました");

    // リモートBLEサーバー内の特性への参照を取得
    pRemoteCharacteristic = pRemoteService->getCharacteristic(charUUID);
    if (pRemoteCharacteristic == nullptr) {
      Serial.print("特性UUIDが見つかりませんでした: ");
      Serial.println(charUUID.toString().c_str());
      pClient->disconnect();
      return false;
    }
    Serial.println(" - 特性が見つかりました");

    // 特性の値を読み取る
    if(pRemoteCharacteristic->canRead()) {
      String value = pRemoteCharacteristic->readValue();
      Serial.print("特性の値: ");
      Serial.println(value);
    }

    if(pRemoteCharacteristic->canNotify())
      pRemoteCharacteristic->registerForNotify(notifyCallback);

    connected = true;
    return true;
}
/**
 * BLEサーバーをスキャンし、目的のサービスを広告している最初のサーバーを見つけます。
 */
class MyAdvertisedDeviceCallbacks: public BLEAdvertisedDeviceCallbacks {
 /**
   * 広告しているBLEサーバーごとに呼び出されます。
   */
  void onResult(BLEAdvertisedDevice advertisedDevice) {
    Serial.print("BLE広告デバイスが見つかりました: ");
    Serial.println(advertisedDevice.toString().c_str());

    // デバイスが目的のサービスを含んでいるか確認
    if (advertisedDevice.haveServiceUUID() && advertisedDevice.isAdvertisingService(serviceUUID)) {

      BLEDevice::getScan()->stop();
      myDevice = new BLEAdvertisedDevice(advertisedDevice);
      doConnect = true;
      doScan = true;

    } // サーバーが見つかりました
  } // onResult
}; // MyAdvertisedDeviceCallbacks

void setup() {
  Serial.begin(115200);
  Serial.println("Arduino BLEクライアントアプリケーションを開始...");
  BLEDevice::init("");

  // スキャナーを取得し、新しいデバイスを検出した際に使用するコールバックを設定
  // アクティブスキャンを指定し、スキャンを5秒間実行
  BLEScan* pBLEScan = BLEDevice::getScan();
  pBLEScan->setAdvertisedDeviceCallbacks(new MyAdvertisedDeviceCallbacks());
  pBLEScan->setInterval(1349);
  pBLEScan->setWindow(449);
  pBLEScan->setActiveScan(true);
  pBLEScan->start(5, false);
} // setup終了

// Arduinoのメインループ関数
void loop() {
  // "doConnect" フラグがtrueの場合、目的のBLEサーバーをスキャンして接続
  // 接続後、connectedフラグをtrueに設定
  if (doConnect == true) {
    if (connectToServer()) {
      Serial.println("BLEサーバーに接続しました。");
    } else {
      Serial.println("サーバーへの接続に失敗しました。これ以上何もしません。");
    }
    doConnect = false;
  }

  // ピアBLEサーバーに接続している場合、現在の起動時間を特性に更新
  if (connected) {
    String newValue = "起動からの時間: " + String(millis()/1000);
    Serial.println("新しい特性値を設定: \"" + newValue + "\"");
    
    // 特性の値を文字列として設定
    pRemoteCharacteristic->writeValue(newValue.c_str(), newValue.length());
  }else if(doScan){
    BLEDevice::getScan()->start(0);  // 切断後にスキャンを開始する例（Arduinoでより良い方法がある可能性あり）
  }
  
  delay(1000); // ループ間で1秒遅延
} // loop終了

上記のプログラムは、XIAO をクライアントとして動作させ、近くのBluetoothデバイスを検索します。BluetoothデバイスのUUIDが指定したUUIDと一致すると、そのデバイスに接続し、特性値を取得します。

プログラムの注釈

BLEサーバーのサンプルコードがどのように動作するかを簡単に見てみましょう。まず、BLE機能に必要なライブラリをインポートすることから始まります。その後、サービスと特性のUUIDを定義する必要があります。

#define SERVICE_UUID "4fafc201-1fb5-459e-8fcc-c5c9c331914b"
#define CHARACTERISTIC_UUID "beb5483e-36e1-4688-b7f5-ea07361b26a8"

デフォルトのUUIDをそのまま使用することもできますし、uuidgenerator.net にアクセスして、サービスや特性用のランダムなUUIDを生成することもできます。

次に、「XIAO_ESP32C6」という名前のBLEデバイスを作成します。この名前は自由に変更可能です。その後、BLEデバイスをサーバーとして設定します。その後、前述のUUIDを使用してBLEサーバーのサービスを作成します。

BLEServer *pServer = BLEDevice::createServer();
BLEService *pService = pServer->createService(SERVICE_UUID);

次に、そのサービスの特性を設定します。前述のUUIDを使用し、特性のプロパティを引数として渡す必要があります。この場合、プロパティは「READ」と「WRITE」です。

BLECharacteristic *pCharacteristic = pService->createCharacteristic(
                                     CHARACTERISTIC_UUID,
                                     BLECharacteristic::PROPERTY_READ |
                                     BLECharacteristic::PROPERTY_WRITE
                                     );

特性を作成した後、setValue() メソッドを使用してその値を設定できます。この例では、値を「Hello World」というテキストに設定しています。このテキストは自由に変更可能です。将来のプロジェクトでは、このテキストをセンサーの読み取り値やランプの状態などにすることができます。

最後に、サービスと広告を開始し、他のBLEデバイスがこのBLEデバイスをスキャンして見つけられるようにします。

BLEAdvertising *pAdvertising = pServer->getAdvertising();
pAdvertising->start();

これはBLEサーバーを作成するための簡単な例です。このコードでは loop() 内で何も行われていませんが、新しいクライアントが接続した際に何が起こるかを追加することができます（BLE_notify の例を参考にしてください）。

BLEセンサーのデータ交換

次に、実際のケースを完成させるために現実世界に移ります。このケースでは、XIAO ESP32C6が光強度センサーに接続し、Bluetoothを介して光センサーの値を別のXIAO ESP32C6に送信し、拡張ボードの画面に表示します。

配線の利便性を考慮して、2つのXIAO拡張ボードを使用します。サンプルプログラムは参考用であり、実際のプロジェクトのニーズに応じて製品を選択できます。

Seeed Studio XIAO ESP32C6	Seeed Studio XIAO用拡張ベース（Grove OLED付き）	Grove - デジタル光センサー - TSL2561

今すぐ購入 🖱️	今すぐ購入 🖱️	今すぐ購入 🖱️

上記のハードウェア準備に加えて、以下のライブラリを準備し、Arduino IDE環境にダウンロードして追加する必要があります。

OLEDディスプレイ用ライブラリ u8g2:

ライブラリをダウンロード

Grove - デジタル光センサー - TSL2561 ライブラリ:

ライブラリをダウンロード

2つの XIAO を準備する必要があります。一方はサーバーとして、もう一方はクライアントとして使用します。以下はサーバーとしてのサンプルプログラムです。サーバーとしての XIAO の主なタスクは以下の通りです。

まず、光センサーからリアルタイムの値を取得する。
次に、Bluetoothサーバーを作成する。
その後、Bluetoothを通じて光強度の値を広告する。
最後に、リアルタイムの光強度を表示し、送信する。

// サーバー
#include <BLEDevice.h>
#include <BLEUtils.h>
#include <BLE2902.h>
#include <BLEServer.h>
#include <Wire.h>
#include <Digital_Light_TSL2561.h>
#include <Arduino.h>
#include <U8x8lib.h>
#include <Wire.h>

// リセットなしのOLEDディスプレイ
U8X8_SSD1306_128X64_NONAME_HW_I2C u8x8(/* clock=*/ SCL, /* data=*/ SDA, /* reset=*/ U8X8_PIN_NONE);

// BLEサーバー名（サーバースケッチを実行している他のESP32の名前）
#define bleServerName "XIAOESP32C6_BLE"

BLECharacteristic *pCharacteristic;
bool deviceConnected = false;

int light_val = 0;

class MyServerCallbacks: public BLEServerCallbacks {
  void onConnect(BLEServer* pServer) {
    deviceConnected = true;
  };
  
  void onDisconnect(BLEServer* pServer) {
    deviceConnected = false;
  }
};

void setup() {
  Serial.begin(115200);
  
  // OLEDディスプレイのセットアップ
  u8x8.begin();
  u8x8.setFlipMode(1);

  u8x8.setFont(u8x8_font_chroma48medium8_r);
  u8x8.drawString(0, 3, "Starting...");

  Wire.begin();
  TSL2561.init();
  
  BLEDevice::init(bleServerName);
  BLEServer *pServer = BLEDevice::createServer();
  pServer->setCallbacks(new MyServerCallbacks());
  
  BLEService *pService = pServer->createService(BLEUUID((uint16_t)0x181A)); // 環境センサー
  pCharacteristic = pService->createCharacteristic(
    BLEUUID((uint16_t)0x2A59), // アナログ出力
    BLECharacteristic::PROPERTY_NOTIFY
  );
  pCharacteristic->addDescriptor(new BLE2902());
  
  pService->start();
  BLEAdvertising *pAdvertising = BLEDevice::getAdvertising();
  pAdvertising->addServiceUUID(pService->getUUID());
  pAdvertising->setScanResponse(true);
  pAdvertising->setMinPreferred(0x0);
  pAdvertising->setMinPreferred(0x1F);
  BLEDevice::startAdvertising();
  u8x8.clearDisplay();
}

void loop() {
  if (deviceConnected) {
    light_val = TSL2561.readVisibleLux();
    pCharacteristic->setValue(light_val);
    pCharacteristic->notify();
    u8x8.setFont(u8x8_font_chroma48medium8_r);
    u8x8.setCursor(0, 0);
    u8x8.print("Light Value:");
    u8x8.clearLine(2);
    u8x8.setCursor(0, 2);
    u8x8.print(light_val);
    u8x8.drawString(0, 4, "Sending...");
    delay(10); // Bluetoothスタックが混雑するのを防ぐため、パケット送信を制限
  }
}

プログラムを1つの XIAO にアップロードした後、プログラムが正常に動作する場合、スマートフォンを取り出してnRF Connect APPを使用してXIAOESP32C6_BLEという名前のBluetoothデバイスを検索し、接続して以下のボタンをクリックすると、センサーのデータ情報を受信できます。

ここで、ソフトウェアの操作方法が前の例とは少し異なることに気付くでしょう。一般的にセンサーの種類のメッセージを送信する場合、notifyプロパティを使用してメッセージの効率を確保することを選択します。

次に、もう1つの XIAO を取り出し、データを収集して表示するクライアントとして使用します。

// クライアント
#include <BLEDevice.h>
#include <BLEUtils.h>
#include <BLEClient.h>
#include <BLEServer.h>
#include <Arduino.h>
#include <U8x8lib.h>
#include <Wire.h>

// リセットなしのOLEDディスプレイ
U8X8_SSD1306_128X64_NONAME_HW_I2C u8x8(/* clock=*/ SCL, /* data=*/ SDA, /* reset=*/ U8X8_PIN_NONE);

BLEClient*  pClient;
bool doconnect = false;

// BLEサーバー名（サーバースケッチを実行している他のESP32の名前）
#define bleServerName "XIAOESP32C6_BLE"

// 周辺デバイスのアドレス。スキャン中に見つかります...
static BLEAddress *pServerAddress;

BLEUUID serviceUUID("181A"); // 環境センサー
BLEUUID charUUID("2A59");    // アナログ出力

char light_val[1024];

// 他のデバイスの広告が受信されたときに呼び出されるコールバック関数
class MyAdvertisedDeviceCallbacks: public BLEAdvertisedDeviceCallbacks {
  void onResult(BLEAdvertisedDevice advertisedDevice) {
    if (advertisedDevice.getName() == bleServerName) { // 広告主の名前が一致するか確認
      advertisedDevice.getScan()->stop(); // スキャンを停止、目的のデバイスを発見
      pServerAddress = new BLEAddress(advertisedDevice.getAddress()); // 広告主のアドレスを取得
      Serial.println("Device found. Connecting!");
    }
  }
};

// OLEDディスプレイに最新のセンサー読み取り値を表示する関数
void printReadings(){
  u8x8.setFont(u8x8_font_chroma48medium8_r);
  u8x8.setCursor(0, 0);
  u8x8.print("Light Value:");
  u8x8.drawString(0, 2, light_val);
}

void setup() {
  Serial.begin(115200);
  // OLEDディスプレイのセットアップ
  u8x8.begin();
  u8x8.setFlipMode(1);

  u8x8.setFont(u8x8_font_chroma48medium8_r);
  u8x8.drawString(0, 3, "Starting...");
  
  Serial.println("Starting BLE client...");

  BLEDevice::init("XIAOESP32C6_Client");

  // スキャナーを取得し、デバイス検出時に通知するコールバックを設定
  BLEScan* pBLEScan = BLEDevice::getScan();
  pBLEScan->setAdvertisedDeviceCallbacks(new MyAdvertisedDeviceCallbacks());
  pBLEScan->setActiveScan(true);
  pBLEScan->start(30);

  pClient = BLEDevice::createClient();
  // リモートBLEサーバーに接続
  pClient->connect(*pServerAddress);
  Serial.println(" - Connected to server");

  // リモートBLEサーバー内のサービスへの参照を取得
  BLERemoteService* pRemoteService = pClient->getService(serviceUUID);
  if (pRemoteService == nullptr) {
    u8x8.clearDisplay();
    u8x8.drawString(0, 3, "False UUID");
    Serial.print("Failed to find our service UUID: ");
    Serial.println(serviceUUID.toString().c_str());
    return;
  }

  // リモートBLEサーバー内のサービスの特性への参照を取得
  BLERemoteCharacteristic* pCharacteristic = pRemoteService->getCharacteristic(charUUID);
  if (pCharacteristic == nullptr) {
    u8x8.clearDisplay();
    u8x8.drawString(0, 3, "False UUID");
    Serial.print("Failed to find our characteristic UUID");
    return;
  }
  Serial.println(" - Found light value characteristics");
  u8x8.clearDisplay();
  u8x8.drawString(0, 3, "Connected!");
  
  pCharacteristic->registerForNotify([](BLERemoteCharacteristic* pBLERemoteCharacteristic, uint8_t* pData, size_t length, bool isNotify) {
    Serial.println("Notify received");
    Serial.print("Value: ");
    Serial.println(*pData);
    snprintf(light_val, sizeof(light_val), "%d", *pData);
  });

  doconnect = true;
  u8x8.clearDisplay();
  u8x8.drawString(0, 4, "Receiving...");
}

void loop() {
  if (doconnect) {
    BLERemoteService* pRemoteService = pClient->getService(serviceUUID);
    BLERemoteCharacteristic* pCharacteristic = pRemoteService->getCharacteristic(charUUID);
    pCharacteristic->registerForNotify([](BLERemoteCharacteristic* pBLERemoteCharacteristic, uint8_t* pData, size_t length, bool isNotify) {
      Serial.println("Notify received");
      Serial.print("Value: ");
      Serial.println(*pData);
      snprintf(light_val, sizeof(light_val), "%d", *pData);
    });
  }
  printReadings();
  delay(1000);
  u8x8.clearLine(2);
}

上記の例を使用する際は、まずサーバープログラムをアップロードし、正常に動作していることを確認してからクライアントプログラムを使用することをお勧めします。プログラムが正常に動作すると、以下の結果が表示されます。

プログラムの注釈

上記のプログラムについて、重要な部分を選んで説明します。まずはサーバープログラムから始めます。

プログラムの冒頭で、Bluetoothサーバーの名前を定義します。この名前は任意に設定できますが、後でこの名前を頼りにBluetoothデバイスを検索する必要があるため、覚えておく必要があります。

#define bleServerName "XIAOESP32C6_BLE"

チュートリアルの前のセクションで説明したように、サーバーの下にはCharacteristicがあり、Characteristicの下には値やその他の内容があります。そのため、広告を作成する際にはこの原則に従う必要があります。

BLEService *pService = pServer->createService(BLEUUID((uint16_t)0x181A)); // 環境センサー
  pCharacteristic = pService->createCharacteristic(
    BLEUUID((uint16_t)0x2A59), // アナログ出力
    BLECharacteristic::PROPERTY_NOTIFY
  );
  pCharacteristic->addDescriptor(new BLE2902());

上記のプログラムでは、createService()を使用してサーバーを作成していることがわかります。パラメータは特定のUUIDで、0x181Aです。GATTの規則では、0x181Aは環境モニタリングタイプのデータを示し、同じCharacteristicのUUIDである0x2A59にも特別な意味があります。GATTでは、これがアナログ出力を示します。これは光センサーの値に適しているため、ここではこのように定義しています。GATTが準備している特定のUUIDの意味については、こちらを参照してください。

もちろん、GATT標準に従わずにUUIDを設定することもできますが、これらの値がユニークであり、クライアントがこれらのUUIDを認識して値を見つける能力に影響を与えないことを確認する必要があります。uuidgenerator.netにアクセスして、サービスやCharacteristic用のランダムなUUIDを作成することができます。

createCharacteristic()関数の2番目のパラメータはプロパティを設定するものです。ここではデータを継続的に送信することを保証するために、PROPERTY_NOTIFYに設定する必要があります。

pCharacteristic->setValue(light_val);
pCharacteristic->notify();

最後に、loop内で光センサーの値を10msごとに広告します。

次はクライアントプログラムです。こちらの方が少し複雑に見えるでしょう。

プログラムの冒頭では、サーバー側で設定した内容と一致していることを確認する必要があります。

// BLEサーバー名（サーバースケッチを実行しているもう一方のESP32の名前）
#define bleServerName "XIAOESP32C6_BLE"

BLEUUID serviceUUID("181A"); // 環境センサー
BLEUUID charUUID("2A59");    // アナログ出力

次にコールバック関数を書きます。この関数の主な役割は、近くのBluetoothデバイスを検索し、提供されたBluetoothデバイス名と比較して一致するものをキャプチャし、そのMACアドレスを取得することです。

class MyAdvertisedDeviceCallbacks: public BLEAdvertisedDeviceCallbacks {
  void onResult(BLEAdvertisedDevice advertisedDevice) {
    if (advertisedDevice.getName() == bleServerName) { // 広告主の名前が一致するか確認
      advertisedDevice.getScan()->stop(); // スキャンを停止、目的のデバイスを発見
      pServerAddress = new BLEAddress(advertisedDevice.getAddress()); // 広告主のアドレスを取得
      Serial.println("デバイスを発見。接続中！");
    }
  }
};

以下の手順は、サーバー内の光強度値を見つけるための鍵となります。まず、サーバーUUIDを見つけ、次にサーバー内のCharacteristicのUUIDを探し、最後に光の値を見つけます。この解析方法はBluetoothのデータ構造と一対一で対応しています。

// リモートBLEサーバー内の目的のサービスへの参照を取得
BLERemoteService* pRemoteService = pClient->getService(serviceUUID);
if (pRemoteService == nullptr) {
  Serial.print("サービスUUIDが見つかりませんでした: ");
  Serial.println(serviceUUID.toString().c_str());
  return;
}

// リモートBLEサーバー内のサービス内のCharacteristicへの参照を取得
BLERemoteCharacteristic* pCharacteristic = pRemoteService->getCharacteristic(charUUID);
if (pCharacteristic == nullptr) {
  Serial.print("Characteristic UUIDが見つかりませんでした");
  return;
}
Serial.println(" - 光値Characteristicを発見");

pCharacteristic->registerForNotify([](BLERemoteCharacteristic* pBLERemoteCharacteristic, uint8_t* pData, size_t length, bool isNotify) {
    Serial.println("通知を受信");
    Serial.print("値: ");
    Serial.println(*pData);
  });

最後に、光の値はポインタpDataに格納されます。

tip

上記の例は、単一センサーの単一値の最も簡単な例を示しています。Bluetoothを介して複数のセンサーや複数のセンサー値を広告したい場合は、以下のチュートリアル例を読むことをお勧めします。

ESP32 BLE Server and Client (Bluetooth Low Energy)

技術サポートと製品ディスカッション

弊社製品をお選びいただきありがとうございます！お客様が弊社製品をスムーズにご利用いただけるよう、さまざまなサポートをご提供しております。異なる好みやニーズに対応するため、いくつかのコミュニケーションチャネルをご用意しています。

Seeed Studio XIAO ESP32C6 の Bluetooth 使用方法

Bluetooth Low Energy (BLE) の使用方法​

いくつかの基本概念​

サーバーとクライアント​

アトリビュート​

GATT​

BLE キャラクタリスティック​

UUID​

BLEスキャナー​

プログラムの注釈​

BLEサーバー/クライアント​

プログラムの注釈​

BLEセンサーのデータ交換​

プログラムの注釈​

技術サポートと製品ディスカッション​

Bluetooth Low Energy (BLE) の使用方法

いくつかの基本概念

サーバーとクライアント

アトリビュート

GATT

BLE キャラクタリスティック

UUID

BLEスキャナー

プログラムの注釈

BLEサーバー/クライアント

プログラムの注釈

BLEセンサーのデータ交換

プログラムの注釈

技術サポートと製品ディスカッション