Qtの基礎 - Bluetooth Low Energy - 版の履歴

Wiki: /* アドバタイジングデータの主要要素 */

2025-01-05T14:26:21Z

アドバタイジングデータの主要要素

← 古い版		2025年1月5日 (日) 23:26時点における版
144行目:		144行目:
	* AD Data (可変長)		* AD Data (可変長)
	<br>		<br>
			[[ファイル:Qt BLE 3.png\|フレームなし\|中央]]
			<br>

	==== その他 (通信特性 / セキュリティ等) ====		==== その他 (通信特性 / セキュリティ等) ====
	* 通信特性		* 通信特性

Wiki: /* 使用例 */

2024-12-17T16:58:09Z

使用例

← 古い版		2024年12月18日 (水) 01:58時点における版
1,111行目:		1,111行目:

	private:		private:
	controller;		QLowEnergyController controller;
	reconnectTimer;		QTimer reconnectTimer;
	QBluetoothDeviceInfo currentDevice;		QBluetoothDeviceInfo currentDevice;
	bool autoReconnect = false;		bool autoReconnect = false;
1,236行目:		1,236行目:
	reconnectTimer.setSingleShot(true);		reconnectTimer.setSingleShot(true);

	connect(reconnectTimer~~.get(),~~ &QTimer::timeout, this, &BLEConnection::onReconnectTimeout);		connect(&reconnectTimer &QTimer::timeout, this, &BLEConnection::onReconnectTimeout);
	}		}

Wiki: /* 使用例 */

2024-12-17T16:56:31Z

使用例

← 古い版		2024年12月18日 (水) 01:56時点における版
1,104行目:		1,104行目:
	#include <QLowEnergyCharacteristic>		#include <QLowEnergyCharacteristic>
	#include <QTimer>		#include <QTimer>
	~~#include <memory>~~
	#include <QDebug>		#include <QDebug>

1,112行目:		1,111行目:

	private:		private:
	~~std::unique_ptr<QLowEnergyController>~~ controller;		controller;
	~~std::unique_ptr<QTimer>~~ reconnectTimer;		reconnectTimer;
	QBluetoothDeviceInfo currentDevice;		QBluetoothDeviceInfo currentDevice;
	bool autoReconnect = false;		bool autoReconnect = false;
1,119行目:		1,118行目:
	void connectControllerSignals()		void connectControllerSignals()
	{		{
	connect(controller~~.get()~~, &QLowEnergyController::connected, this, &BLEConnection::onConnected);		connect(&controller, &QLowEnergyController::connected, this, &BLEConnection::onConnected);
	connect(controller~~.get()~~, &QLowEnergyController::disconnected, this, &BLEConnection::onDisconnected);		connect(&controller, &QLowEnergyController::disconnected, this, &BLEConnection::onDisconnected);
	connect(controller~~.get()~~, &QLowEnergyController::serviceDiscovered, this, &BLEConnection::onServiceDiscovered);		connect(&controller, &QLowEnergyController::serviceDiscovered, this, &BLEConnection::onServiceDiscovered);
	connect(controller~~.get()~~, static_cast<void(QLowEnergyController::*)(QLowEnergyController::Error)>(&QLowEnergyController::error), this, &BLEConnection::onError);		connect(&controller, static_cast<void(QLowEnergyController::*)(QLowEnergyController::Error)>(&QLowEnergyController::error), this, &BLEConnection::onError);
	connect(controller~~.get()~~, &QLowEnergyController::stateChanged, this, &BLEConnection::onStateChanged);		connect(&controller, &QLowEnergyController::stateChanged, this, &BLEConnection::onStateChanged);
	}		}

1,234行目:		1,233行目:
	{		{
	// 再接続タイマの初期化		// 再接続タイマの初期化
	reconnectTimer ~~= std::make_unique<QTimer>(this);~~		reconnectTimer.setInterval(5000); // 5秒間隔で再接続
	~~reconnectTimer->~~setInterval(5000); // 5秒間隔で再接続		reconnectTimer.setSingleShot(true);
	reconnectTimer->setSingleShot(true);

	connect(reconnectTimer.get(), &QTimer::timeout, this, &BLEConnection::onReconnectTimeout);		connect(reconnectTimer.get(), &QTimer::timeout, this, &BLEConnection::onReconnectTimeout);
1,248行目:		1,246行目:

	// コントローラの初期化		// コントローラの初期化
	~~controller = std::make_unique<QLowEnergyController>(device, this);~~
	connectControllerSignals();		connectControllerSignals();

	// 接続パラメータの設定		// 接続パラメータの設定
	controller->setRemoteAddressType(QLowEnergyController::PublicAddress);		controller.setRemoteAddressType(QLowEnergyController::PublicAddress);

	// 接続開始		// 接続開始
	controller->connectToDevice();		controller.connectToDevice();
	currentDevice = device;		currentDevice = device;
	}		}
1,270行目:		1,267行目:
	try {		try {
	if (controller) {		if (controller) {
	controller->disconnectFromDevice();		controller.disconnectFromDevice();
	reconnectTimer->stop();		reconnectTimer.stop();
	}		}
	}		}
1,286行目:		1,283行目:
	autoReconnect = enable;		autoReconnect = enable;
	if (!enable) {		if (!enable) {
	reconnectTimer->stop();		reconnectTimer.stop();
	}		}
	}		}
1,301行目:		1,298行目:
	{		{
	qDebug() << "デバイスに接続";		qDebug() << "デバイスに接続";
	reconnectTimer->stop();		reconnectTimer.stop();
	emit connected();		emit connected();

	// サービスの探索を開始		// サービスの探索を開始
	controller->discoverServices();		controller.discoverServices();
	}		}

1,316行目:		1,313行目:
	if (autoReconnect) {		if (autoReconnect) {
	qDebug() << "再接続を試行...";		qDebug() << "再接続を試行...";
	reconnectTimer->start();		reconnectTimer.start();
	}		}
	}		}
1,324行目:		1,321行目:
	qDebug() << "サービスを発見: " << uuid.toString();		qDebug() << "サービスを発見: " << uuid.toString();

	QLowEnergyService* service = controller->createServiceObject(uuid, this);		QLowEnergyService* service = controller.createServiceObject(uuid, this);
	if (service) {		if (service) {
	connectServiceSignals(service);		connectServiceSignals(service);
1,337行目:		1,334行目:
	emit errorOccurred(errorMessage);		emit errorOccurred(errorMessage);

	if (autoReconnect && error != QLowEnergyController::InvalidBluetoothAdapterError) reconnectTimer->start();		if (autoReconnect && error != QLowEnergyController::InvalidBluetoothAdapterError) reconnectTimer.start();
	}		}

1,350行目:		1,347行目:
	if (autoReconnect && currentDevice.isValid()) {		if (autoReconnect && currentDevice.isValid()) {
	qDebug() << "再接続を試行...";		qDebug() << "再接続を試行...";
	controller->connectToDevice();		controller.connectToDevice();
	}		}
	}		}

Wiki: /* 使用例 */

2024-12-17T16:51:22Z

使用例

@@ 526行目: / 526行目: @@
 <br>
 ==== 使用例 ====
   <syntaxhighlight lang="c++">
   // BLEのサービス探索を管理するクラス
@@ 626行目: / 658行目: @@
+     {
         // タイムアウトタイマの初期化
         discoveryTimeout.setInterval(10000);  // 10秒のタイムアウト
         discoveryTimeout.setSingleShot(true);
-        connect(discoveryTimeout.get(), &QTimer::timeout, this, &BLEServiceDiscovery::onDiscoveryTimeout);
+        connect(&discoveryTimeout, &QTimer::timeout, this, &BLEServiceDiscovery::onDiscoveryTimeout);
+     }
@@ 641行目: / 672行目: @@
            // コントローラの初期化
            connectControllerSignals();

Wiki: /* 使用例 */

2024-12-17T16:35:58Z

使用例

← 古い版		2024年12月18日 (水) 01:35時点における版
627行目:		627行目:
	// タイムアウトタイマの初期化		// タイムアウトタイマの初期化
	discoveryTimeout = std::make_unique<QTimer>(this);		discoveryTimeout = std::make_unique<QTimer>(this);
	discoveryTimeout->setInterval(10000); // 10秒のタイムアウト		discoveryTimeout.setInterval(10000); // 10秒のタイムアウト
	discoveryTimeout->setSingleShot(true);		discoveryTimeout.setSingleShot(true);

	connect(discoveryTimeout.get(), &QTimer::timeout, this, &BLEServiceDiscovery::onDiscoveryTimeout);		connect(discoveryTimeout.get(), &QTimer::timeout, this, &BLEServiceDiscovery::onDiscoveryTimeout);
645行目:		645行目:

	// 接続開始		// 接続開始
	controller->connectToDevice();		controller.connectToDevice();
	discoveryTimeout->start();		discoveryTimeout.start();
	}		}
	catch (const std::exception &e) {		catch (const std::exception &e) {
660行目:		660行目:
	try {		try {
	if (controller) {		if (controller) {
	controller->disconnectFromDevice();		controller.disconnectFromDevice();
	discoveryTimeout->stop();		discoveryTimeout.stop();
	}		}
	}		}
682行目:		682行目:
	{		{
	qDebug() << "デバイスに接続";		qDebug() << "デバイスに接続";
	discoveryTimeout->stop();		discoveryTimeout.stop();

	// サービス探索の開始		// サービス探索の開始
	controller->discoverServices();		controller.discoverServices();
	}		}

692行目:		692行目:
	{		{
	qDebug() << "デバイスから切断";		qDebug() << "デバイスから切断";
	discoveryTimeout->stop();		discoveryTimeout.stop();
	}		}

701行目:		701行目:

	// サービスオブジェクトの作成		// サービスオブジェクトの作成
	QLowEnergyService* service = controller->createServiceObject(uuid, this);		QLowEnergyService* service = controller.createServiceObject(uuid, this);
	if (service) {		if (service) {
	connectServiceSignals(service);		connectServiceSignals(service);
712行目:		712行目:
	{		{
	qDebug() << "サービス探索が完了";		qDebug() << "サービス探索が完了";
	discoveryTimeout->stop();		discoveryTimeout.stop();
	emit discoveryComplete();		emit discoveryComplete();
	}		}

Wiki: /* 使用例 */

2024-12-17T16:33:57Z

使用例

← 古い版		2024年12月18日 (水) 01:33時点における版
527行目:		527行目:
	==== 使用例 ====		==== 使用例 ====
	<syntaxhighlight lang="c++">		<syntaxhighlight lang="c++">
			// BLEのサービス探索を管理するクラス
			// BLEデバイスへの接続, サービスの探索と監視

	#include <QObject>		#include <QObject>
	#include <QLowEnergyController>		#include <QLowEnergyController>
	#include <QLowEnergyService>		#include <QLowEnergyService>
	#include <QTimer>		#include <QTimer>
	~~#include <memory>~~
	#include <QDebug>		#include <QDebug>

539行目:		541行目:

	private:		private:
	~~std::unique_ptr<~~QLowEnergyController> controller;		QLowEnergyController controller; // BLE接続とサービス探索を制御するコントローラ
	~~std::unique_ptr<~~QTimer> discoveryTimeout;		QTimer discoveryTimeout; // サービス探索のタイムアウトを管理するタイマ

			// コントローラの各種シグナルを接続
			// 接続 / 切断, サービス探索の進行状況, 状態変更, エラー
	void connectControllerSignals()		void connectControllerSignals()
	{		{
	connect(controller~~.get()~~, &QLowEnergyController::connected, this, &BLEServiceDiscovery::onConnected);		connect(&controller, &QLowEnergyController::connected, this, &BLEServiceDiscovery::onConnected);
	connect(controller~~.get()~~, &QLowEnergyController::disconnected, this, &BLEServiceDiscovery::onDisconnected);		connect(&controller, &QLowEnergyController::disconnected, this, &BLEServiceDiscovery::onDisconnected);
	connect(controller~~.get()~~, &QLowEnergyController::serviceDiscovered, this, &BLEServiceDiscovery::onServiceDiscovered);		connect(&controller, &QLowEnergyController::serviceDiscovered, this, &BLEServiceDiscovery::onServiceDiscovered);
	connect(controller~~.get()~~, &QLowEnergyController::discoveryFinished, this, &BLEServiceDiscovery::onDiscoveryFinished);		connect(&controller, &QLowEnergyController::discoveryFinished, this, &BLEServiceDiscovery::onDiscoveryFinished);
	connect(controller~~.get()~~, static_cast<void(QLowEnergyController::*)(QLowEnergyController::Error)>(&QLowEnergyController::error), this, &BLEServiceDiscovery::onError);		connect(&controller, static_cast<void(QLowEnergyController::*)(QLowEnergyController::Error)>(&QLowEnergyController::error), this, &BLEServiceDiscovery::onError);
	connect(controller~~.get()~~, &QLowEnergyController::stateChanged, this, &BLEServiceDiscovery::onStateChanged);		connect(&controller, &QLowEnergyController::stateChanged, this, &BLEServiceDiscovery::onStateChanged);
	}		}

			// 個別のBLEサービスに対するシグナル
			// 状態変更とエラーイベントを監視してログを出力する
	void connectServiceSignals(QLowEnergyService *service)		void connectServiceSignals(QLowEnergyService *service)
	{		{
563行目:		569行目:
	}		}

			// エラーコードの変換
	QString getErrorMessage(QLowEnergyController::Error error)		QString getErrorMessage(QLowEnergyController::Error error)
	{		{
627行目:		634行目:

	// デバイスへの接続とサービス探索の開始		// デバイスへの接続とサービス探索の開始
	void startDiscovery(const QBluetoothDeviceInfo& device)		// コントローラの初期化, シグナルの接続, デバイスへの接続開始, タイムアウトタイマの開始
			void startDiscovery(const QBluetoothDeviceInfo &device)
	{		{
	try {		try {
647行目:		655行目:
	}		}

	// 探索を停止		// 探索を停止 (タイムアウトタイマも停止)
	void stopDiscovery()		void stopDiscovery()
	{		{
664行目:		672行目:

	signals:		signals:
	void serviceDiscovered(QLowEnergyService *service);		void serviceDiscovered(QLowEnergyService *service); // 新しいサービスが発見された時に発行
	void discoveryComplete();		void discoveryComplete(); // 全てのサービス探索が完了した時に発行
	void errorOccurred(const QString &error);		void errorOccurred(const QString &error); // エラーが発生した時に発行
	void connectionStateChanged(QLowEnergyController::ControllerState state);		void connectionStateChanged(QLowEnergyController::ControllerState state); // 接続状態が変更された時に発行

	private slots:		private slots:
			// デバイスへの接続が完了した時 (タイムアウトタイマを停止して、サービス探索を開始)
	void onConnected()		void onConnected()
	{		{
679行目:		688行目:
	}		}

			// デバイスから切断された時 (タイムアウトタイマを停止)
	void onDisconnected()		void onDisconnected()
	{		{
685行目:		695行目:
	}		}

			// 新しいサービスが発見された時
	void onServiceDiscovered(const QBluetoothUuid& uuid)		void onServiceDiscovered(const QBluetoothUuid& uuid)
	{		{
697行目:		708行目:
	}		}

			// サービス探索が完了した時
	void onDiscoveryFinished()		void onDiscoveryFinished()
	{		{
704行目:		716行目:
	}		}

			// エラーが発生した時
	void onError(QLowEnergyController::Error error)		void onError(QLowEnergyController::Error error)
	{		{
711行目:		724行目:
	}		}

			// タイムアウトが発生した時 (探索を停止して、エラーとして通知)
	void onDiscoveryTimeout()		void onDiscoveryTimeout()
	{		{
718行目:		732行目:
	}		}

			// 接続状態が変更された時 (状態の変更をログ出力して、通知)
	void onStateChanged(QLowEnergyController::ControllerState state)		void onStateChanged(QLowEnergyController::ControllerState state)
	{		{

Wiki: /* = 組み合わせ */

2024-12-17T16:15:54Z

= 組み合わせ

← 古い版		2024年12月18日 (水) 01:15時点における版
845行目:		845行目:
	</syntaxhighlight>		</syntaxhighlight>
	<br>		<br>
	===== 組み合わせ ====		===== 組み合わせ =====
	<syntaxhighlight lang="c++">		<syntaxhighlight lang="c++">
	// BLEデバイスとのペアリング操作を管理するクラス		// BLEデバイスとのペアリング操作を管理するクラス

Wiki: /* 使用例 */

2024-12-17T16:13:30Z

使用例

差分を表示

Wiki: /* 使用例 */

2024-12-17T15:18:10Z

使用例

@@ 165行目: / 165行目: @@
 <br>
 ==== 使用例 ====
   <syntaxhighlight lang="c++">
   // BLEデバイスのスキャンを管理するクラス

Wiki: /* 使用例 */

2024-12-17T14:49:58Z

使用例

← 古い版		2024年12月17日 (火) 23:49時点における版
190行目:		190行目:
	{		{
	// デバイス探索エージェントのシグナル接続		// デバイス探索エージェントのシグナル接続
	connect(discoveryAgent~~.get()~~, &QBluetoothDeviceDiscoveryAgent::deviceDiscovered, this, &BLEDeviceScanner::onDeviceDiscovered);		connect(&discoveryAgent, &QBluetoothDeviceDiscoveryAgent::deviceDiscovered, this, &BLEDeviceScanner::onDeviceDiscovered);
	connect(discoveryAgent~~.get()~~, &QBluetoothDeviceDiscoveryAgent::finished, this, &BLEDeviceScanner::onScanFinished);		connect(&discoveryAgent, &QBluetoothDeviceDiscoveryAgent::finished, this, &BLEDeviceScanner::onScanFinished);
	connect(discoveryAgent~~.get()~~, static_cast<void(QBluetoothDeviceDiscoveryAgent::*)(QBluetoothDeviceDiscoveryAgent::Error)>(&QBluetoothDeviceDiscoveryAgent::error),		connect(&discoveryAgent, static_cast<void(QBluetoothDeviceDiscoveryAgent::*)(QBluetoothDeviceDiscoveryAgent::Error)>(&QBluetoothDeviceDiscoveryAgent::error),
	this, &BLEDeviceScanner::onError);		this, &BLEDeviceScanner::onError);

333行目:		333行目:
	if (isContinuousScan) {		if (isContinuousScan) {
	QTimer::singleShot(1000, this, [this]() {		QTimer::singleShot(1000, this, [this]() {
	discoveryAgent->start(QBluetoothDeviceDiscoveryAgent::LowEnergyMethod);		discoveryAgent.start(QBluetoothDeviceDiscoveryAgent::LowEnergyMethod);
	});		});
	}		}
349行目:		349行目:
	if (isContinuousScan) {		if (isContinuousScan) {
	QTimer::singleShot(5000, this, [this]() {		QTimer::singleShot(5000, this, [this]() {
	discoveryAgent->start(QBluetoothDeviceDiscoveryAgent::LowEnergyMethod);		discoveryAgent.start(QBluetoothDeviceDiscoveryAgent::LowEnergyMethod);
	});		});
	}		}

Wiki: /* 使用例 */

2024-12-17T14:48:41Z

使用例

差分を表示

Wiki: /* データの送受信 */

2024-11-18T19:15:37Z

データの送受信

差分を表示

Wiki: /* データの送受信 */

2024-11-18T19:01:01Z

データの送受信

@@ 1,067行目: / 1,067行目: @@
 == データの送受信 ==
 以下の例では、BLEを使用してデータの送受信を行っている。<br>
 <br>

Wiki: /* Classic Bluetoothとの違い */

2024-11-18T19:00:41Z

Classic Bluetoothとの違い

← 古い版		2024年11月19日 (火) 04:00時点における版
805行目:		805行目:
	* Indicate		* Indicate
	*: Notifyと同様、確認応答あり		*: Notifyと同様、確認応答あり
	~~<br>~~
	~~==== Classic Bluetoothとの違い ====~~
	* キャラクタリスティックの操作が基本
	* 読み取り
	*: readCharacteristicメソッド
	* 書き込み
	*: writeCharacteristicメソッド
	* 通知
	*: characteristicChangedシグナルで受信
	<br>		<br>
	==== 使用例 ====		==== 使用例 ====

Wiki: /* 接続の確立と維持 */

2024-11-18T18:59:25Z

接続の確立と維持

差分を表示

Wiki: /* Classic Bluetoothとの主な違い */

2024-11-18T18:33:41Z

Classic Bluetoothとの主な違い

差分を表示

Wiki: /* ペアリング管理 (ボンディング) */

2024-11-18T18:21:19Z

ペアリング管理 (ボンディング)

@@ 587行目: / 587行目: @@
 == ペアリング管理 (ボンディング) ==
-以下に示すように、セキュリティレベルが定義されている。<br>
+==== セキュリティレベル ====
 * Just Works
 *: 最も簡単であるが、セキュリティは低い。
 * Passkey Entry
 *: PINコードを使用する。
 * Out of Band
-*: NFC等の別の通信手段を使用する。
+*: NFC / QRコード等の別チャネルの通信によりでペアリング情報を交換する。
 * Numeric Comparison
-*: 両デバイスで同じ数字を確認する。
+*: 両デバイスで6桁の数字を表示・確認する。
 <br>
-Classic Bluetoothとの違いを以下に示す。<br>
+==== ボンディング管理の要素 ====
-* 接続パラメータの設定が可能
+* LTK (Long Term Key)
 *: 接続間隔、レイテンシ、タイムアウト等
-* 省電力モードの制御
+*: Connection Interval: 7.5ミリ秒～4秒
-* 接続状態の監視
+*: Slave Latencyが設定可能である。
 <br><br>

Wiki: /* サービスディスカバリ */

2024-11-18T18:05:56Z

サービスディスカバリ

← 古い版		2024年11月19日 (火) 03:05時点における版
337行目:		337行目:
	特定のBluetoothデバイスが提供するサービスを探索するプロセスである。<br>		特定のBluetoothデバイスが提供するサービスを探索するプロセスである。<br>
	<br>		<br>
			==== GATT階層構造 ====
	BLEでは、GATT (Generic Attribute Profile) という階層構造を持つ。<br>		BLEでは、GATT (Generic Attribute Profile) という階層構造を持つ。<br>
			Classic Bluetoothとは異なり、キャラクタリスティックとディスクリプタの概念が追加されている。<br>
			<br>
	* サービス		* サービス
	*: デバイスの機能をグループ化 (例: 心拍計測、温度センサ等)		*: デバイスの機能をグループ化 (例: 心拍計測、温度センサ等)
367行目:		370行目:
	UUIDは16-bit (標準) または 128-bit (カスタム) である。<br>		UUIDは16-bit (標準) または 128-bit (カスタム) である。<br>
	<br>		<br>
	# BLEサービスディスカバリの手順		==== BLEサービスディスカバリの手順 ====
			# GAP (Generic Access Profile) によるデバイススキャン
	1. GAP (Generic Access Profile) によるデバイススキャン		# デバイスへの接続
	2. デバイスへの接続		# GATTサービスの列挙
	3. GATTサービスの列挙		# 各サービス内のキャラクタリスティック探索
	4. 各サービス内のキャラクタリスティック探索		# 必要に応じてディスクリプタ探索
	5. 必要に応じてディスクリプタ探索
	<br>		<br>
	~~BLEでは、~~<code>QLowEnergyService</code>~~クラスでより複雑なサービス階層を管理する。<br>~~		Qtでは、<code>QLowEnergyService</code>クラスを使用して、BLEの複雑なサービス階層を管理する。<br>
	~~キャラクタリスティックとディスクリプタの概念が追加されている。~~<br>
	<br>		<br>
	Classic Bluetoothとの違いを以下に示す。<br>		Classic Bluetoothとの違いを以下に示す。<br>
	* ~~QLowEnergyControllerクラスを使用~~		* <code>QLowEnergyController::connectToDevice</code>メソッドで接続する。
	* ~~connectToDeviceメソッドで接続する~~		* <code>QLowEnergyController::discoveryFinished</code>シグナルで探索完了を検知する。
	* ~~discoveryFinishedシグナルで探索完了を検知する~~		* <code>QLowEnergyController::createServiceObject</code>メソッドを使用して、サービスオブジェクトを生成する。
	* createServiceObjectメソッドを使用して、サービスオブジェクトを生成する
	<br>		<br>
	==== 使用例 ====		==== 使用例 ====

Wiki: /* サービスディスカバリ */

2024-11-18T17:56:06Z

サービスディスカバリ

← 古い版		2024年11月19日 (火) 02:56時点における版
351行目:		351行目:

	Profile		Profile
	└── Service (1..n) # Primary ~~/ Secondaryの2種類のサービスタイプ~~		└── Service (1..n) # Primary Service (メインとなる独立したサービス)
	~~└──~~ Characteristic (1..n)		│ # デバイスの主要な機能を表現
	└── Descriptor (0..n)		│ # 他のサービスに依存しない
			│ # 例: 心拍計測、温度センサ等
			├── Include (0..n) # Secondary Serviceへの参照
			├── Characteristic (1..n)
			│ └── Descriptor (0..n)
			├── Secondary Service 1 (0..n) # バッテリー監視 (Primaryサービスをサポートする補助的なサービス)
			└── Secondary Service 2 (0..n) # デバイス診断 (Primaryサービスをサポートする補助的なサービス)
			# Secondary Serviceは、単独では意味を持たない
			# 必ず1つ以上のPrimary Serviceに関連付けられる
	<br>		<br>
	サービスディスカバリでは、これらの階層構造を探索して、利用可能な機能を特定する。<br>		サービスディスカバリでは、これらの階層構造を探索して、利用可能な機能を特定する。<br>

Wiki: /* サービスディスカバリ */

2024-11-18T17:39:59Z

サービスディスカバリ

← 古い版		2024年11月19日 (火) 02:39時点における版
340行目:		340行目:
	* サービス		* サービス
	*: デバイスの機能をグループ化 (例: 心拍計測、温度センサ等)		*: デバイスの機能をグループ化 (例: 心拍計測、温度センサ等)
			*: キャラクタリスティックは各サービスに1つ以上必要である。
	* キャラクタリスティック		* キャラクタリスティック
	*: 実際のデータ値や操作 (例: 心拍値、温度値、設定値等)		*: 実際のデータ値や操作 (例: 心拍値、温度値、設定値等)
			*: キャラクタリスティックは、各サービスに1つ以上必要である。
	* ディスクリプタ		* ディスクリプタ
	*: キャラクタリスティックの追加情報 (単位や説明等)		*: キャラクタリスティックの追加情報 (単位や説明等)
			*: ディスクリプタは必須ではなく、オプショナル (0個以上) である。
			<br>
			# GATT階層構造

			Profile
			└── Service (1..n) # Primary / Secondaryの2種類のサービスタイプ
			└── Characteristic (1..n)
			└── Descriptor (0..n)
	<br>		<br>
	サービスディスカバリでは、これらの階層構造を探索して、利用可能な機能を特定する。<br>		サービスディスカバリでは、これらの階層構造を探索して、利用可能な機能を特定する。<br>
	標準的なサービスには決められたUUIDが割り当てられている。(例: 心拍サービス、電池残量サービス等)<br>		標準的なサービスには決められたUUIDが割り当てられている。(例: 心拍サービス、電池残量サービス等)<br>
			UUIDは16-bit (標準) または 128-bit (カスタム) である。<br>
			<br>
			# BLEサービスディスカバリの手順

			1. GAP (Generic Access Profile) によるデバイススキャン
			2. デバイスへの接続
			3. GATTサービスの列挙
			4. 各サービス内のキャラクタリスティック探索
			5. 必要に応じてディスクリプタ探索
	<br>		<br>
	BLEでは、<code>QLowEnergyService</code>クラスでより複雑なサービス階層を管理する。<br>		BLEでは、<code>QLowEnergyService</code>クラスでより複雑なサービス階層を管理する。<br>

Wiki: /* サービスディスカバリ */

2024-11-18T17:32:57Z

サービスディスカバリ

差分を表示

Wiki: /* デバイススキャンと検出 */

2024-11-18T17:07:13Z

デバイススキャンと検出

← 古い版		2024年11月19日 (火) 02:07時点における版
93行目:		93行目:
	<u>BLEペリフェラル (アドバタイザ) デバイスがアドバタイズメントと呼ばれる特別なブロードキャストパケットを定期的に発信して</u>、セントラル (スキャナ) デバイスがそれをスキャンする。<br>		<u>BLEペリフェラル (アドバタイザ) デバイスがアドバタイズメントと呼ばれる特別なブロードキャストパケットを定期的に発信して</u>、セントラル (スキャナ) デバイスがそれをスキャンする。<br>
	スキャンを行うのはセントラル側、アドバタイズメントパケットを発信するのはペリフェラル側である。<br>		スキャンを行うのはセントラル側、アドバタイズメントパケットを発信するのはペリフェラル側である。<br>
			<br>
			[[ファイル:Qt BLE 1.png\|フレームなし\|中央]]
	<br>		<br>
	このアドバタイジングパケットには、以下に示す情報が含まれる。<br>		このアドバタイジングパケットには、以下に示す情報が含まれる。<br>
126行目:		128行目:
	* アドバタイジングアドレス (6バイト)		* アドバタイジングアドレス (6バイト)
	* アドバタイジングデータ (最大31バイト)		* アドバタイジングデータ (最大31バイト)
			<br>
			[[ファイル:Qt BLE 2.png\|フレームなし\|中央]]
	<br>		<br>
	==== アドバタイジングデータの主要要素 ====		==== アドバタイジングデータの主要要素 ====

Wiki: /* デバイススキャンと検出 */

2024-11-18T17:01:40Z

デバイススキャンと検出

差分を表示

2024年11月18日 (月) 07:14にWikiによる

2024-11-18T07:14:36Z

差分を表示

Wiki: /* 概要 */

2024-11-17T21:02:24Z

概要

@@ 45行目: / 45行目: @@
 <u>ソフトウェアの要件 (データ量、通信頻度、電力消費等) に応じて適切な方式を選択する必要がある。</u><br>
 <u>また、多くのモダンなBluetoothデバイスはBLEを採用する傾向にあり、特に省電力性が重要な場合はBLEが推奨される。</u><br>
 <br><br>

Wiki: /* サービスディスカバリ */

2024-11-17T01:38:15Z

サービスディスカバリ

← 古い版		2024年11月17日 (日) 10:38時点における版
98行目:		98行目:
	サービスディスカバリでは、これらの階層構造を探索して、利用可能な機能を特定する。<br>		サービスディスカバリでは、これらの階層構造を探索して、利用可能な機能を特定する。<br>
	標準的なサービスには決められたUUIDが割り当てられている。(例: 心拍サービス、電池残量サービス等)<br>		標準的なサービスには決められたUUIDが割り当てられている。(例: 心拍サービス、電池残量サービス等)<br>
			<br>
			BLEでは、<code>QLowEnergyService</code>クラスでより複雑なサービス階層を管理する。<br>
			キャラクタリスティックとディスクリプタの概念が追加されている。<br>
	<br><br>		<br><br>

Wiki: /* デバイススキャンと検出 */

2024-11-17T01:33:28Z

デバイススキャンと検出

← 古い版		2024年11月17日 (日) 10:33時点における版
81行目:		81行目:
	また、スキャン時間や範囲を設定可能であり、バッテリー消費とスキャン精度のバランスを取ることができる。<br>		また、スキャン時間や範囲を設定可能であり、バッテリー消費とスキャン精度のバランスを取ることができる。<br>
	<br>		<br>
	~~Classic Bluetoothでは、~~<code>QBluetoothDeviceDiscoveryAgent</code>を使用するが、<code>LowEnergyDiscoveryTimeout</code>の設定が必要となる。<br>		<u>BLEでは、同様の<code>QBluetoothDeviceDiscoveryAgent</code>を使用するが、<code>LowEnergyDiscoveryTimeout</code>の設定が必要となる。</u><br>
	また、フィルタリングでBLEデバイスのみを検出する。<br>		また、フィルタリングでBLEデバイスのみを検出する。<br>
	<br><br>		<br><br>

Wiki: ページの作成:「== 概要 == QtのBluetoothサポートは、Qt Bluetoothモジュールを通じて提供されている。
Qt Bluetoothモジュールは、クロスプラットフォームなBluetooth通信機能を実現するための包括的なAPIセットとなっている。

主要なコンポーネントとして、Classic BluetoothとBluetooth Low Energy (BLE) の両方をサポートしている。 * Classic Bluetooth : 従来型の高帯域幅通信 BLE…」

2024-11-17T01:32:26Z

ページの作成:「== 概要 == QtのBluetoothサポートは、Qt Bluetoothモジュールを通じて提供されている。 Qt Bluetoothモジュールは、クロスプラットフォームなBluetooth通信機能を実現するための包括的なAPIセットとなっている。 主要なコンポーネントとして、Classic BluetoothとBluetooth Low Energy (BLE) の両方をサポートしている。 * Classic Bluetooth *: 従来型の高帯域幅通信 * BLE…」

新規ページ

== 概要 ==
QtのBluetoothサポートは、Qt Bluetoothモジュールを通じて提供されている。 
Qt Bluetoothモジュールは、クロスプラットフォームなBluetooth通信機能を実現するための包括的なAPIセットとなっている。 
 
主要なコンポーネントとして、Classic BluetoothとBluetooth Low Energy (BLE) の両方をサポートしている。
* Classic Bluetooth
*: 従来型の高帯域幅通信
* BLE
*: 省電力デバイスとの通信
 
デバイスの検出と管理において、Qt Bluetoothモジュールは以下に示す機能を提供している。 
* デバイススキャンと検出
* サービスディスカバリ
* ペアリング管理
* 接続の確立と維持
 
上記の機能は相互に関連しており、アプリケーションでは以下に示すような流れで使用される。 
# まず、デバイススキャンを行い、周囲のデバイスを探索する。
# 目的のデバイスが存在する場合、サービスディスカバリでそのデバイスの機能を確認する。
# 次に、必要に応じてペアリングを実行する。
# 最後に、接続を確立してデータ通信を開始する。
 
Classic Bluetoothでの通信では、RFCOMMプロトコルを使用したシリアルポート型の通信が可能である。 
これは QBluetoothSocketクラスを通じて実装されており、TCP/IPソケットに似た使い方ができる。 
 
BLEについては、GATT (Generic Attribute Profile) プロトコルをベースとしたサービスとキャラクタリスティックの概念を使用する。 
QLowEnergyControllerクラスがBLE通信の中心的な役割を果たしており、デバイスとの接続やデータのやり取りを管理する。 
 
セキュリティ面においては、ペアリング、セキュアな接続の確立、暗号化等の機能が組み込まれている。 
また、プラットフォーム固有のセキュリティ要件にも対応している。 
 
実装する場合の注意点として、OSごとの権限設定や制限事項への対応が必要となる。 
特に、モバイルプラットフォームでは適切な権限の設定が重要である。 
また、Bluetooth機能の有無やステータスの確認も必要である。 
 
エラーハンドリングについては、接続の切断、タイムアウト、デバイスが見つからない場合等、様々な状況に対応する必要がある。 
 
Qt Bluetoothモジュールは、これらの状況を適切に検出して、シグナル / スロットメカニズムを通じて通知する仕組みを提供している。 
 
※Bluetooth Low Energyを使用する場合の注意 
* サービスUUIDおよびキャラクタリスティックUUIDの理解が重要である。
* データサイズの制限を考慮する必要がある。(一般的に20[byte]程度)
* 非同期処理が基本となるため、シグナル/スロットの適切な設計が重要である。
 
ソフトウェアの要件 (データ量、通信頻度、電力消費等) に応じて適切な方式を選択する必要がある。 
また、多くのモダンなBluetoothデバイスはBLEを採用する傾向にあり、特に省電力性が重要な場合はBLEが推奨される。 
 

== Bluetooth Low Energy (BLE) の特徴 ==
BLEは、<code>QLowEnergyController</code>クラスを使用した通信である。 
 
GATT (Generic Attribute Profile) プロトコルを使用しており、サービス、キャラクタリスティック、ディスクリプタという階層構造を持つ。 
 
BLEは、Classic Bluetoothとは異なるアーキテクチャと通信モデルを採用しているため、別のAPIとクラスを使用する必要がある。 
BLEで使用するQtクラスを、以下に示す。 
* QLowEnergyControllerクラス
*: BLEデバイスとの接続を管理する。
* QLowEnergyServiceクラス
*: BLEサービスを表現する。
* QLowEnergyCharacteristicクラス
*: データの読み書きを行う最小単位
 
BLEでは、短いデータパケットの断続的な送受信する。 
また、Notify / Indicateによる省電力なデータ更新を行う。 
 

== デバイススキャンと検出 ==
デバイススキャンは、周囲のBluetooth対応デバイスを探索するプロセスである。 
このプロセスでは、アクティブに電波を送信して応答を待つアクティブスキャン、他のデバイスからのアドバタイズメントを受信するパッシブスキャンの2種類がある。 
* アクティブスキャン
* パッシブスキャン
 
BLEデバイスのスキャン中は、アドバタイズメントと呼ばれる特別なブロードキャストパケットを発信する。 
このアドバタイズメントパケットには、以下に示す情報が含まれる。 
* デバイス名
* メーカー固有データ
* 提供するサービスのUUID
* 電波強度 (RSSI)
* その他のカスタムデータ
 
また、スキャン時間や範囲を設定可能であり、バッテリー消費とスキャン精度のバランスを取ることができる。 
 
Classic Bluetoothでは、<code>QBluetoothDeviceDiscoveryAgent</code>を使用するが、<code>LowEnergyDiscoveryTimeout</code>の設定が必要となる。 
また、フィルタリングでBLEデバイスのみを検出する。 
 

== サービスディスカバリ ==
特定のBluetoothデバイスが提供するサービスを探索するプロセスである。 
 
BLEでは、GATT (Generic Attribute Profile) という階層構造を持つ。 
* サービス
*: デバイスの機能をグループ化 (例: 心拍計測、温度センサ等)
* キャラクタリスティック
*: 実際のデータ値や操作 (例: 心拍値、温度値、設定値等)
* ディスクリプタ
*: キャラクタリスティックの追加情報 (単位や説明等)
 
サービスディスカバリでは、これらの階層構造を探索して、利用可能な機能を特定する。 
標準的なサービスには決められたUUIDが割り当てられている。(例: 心拍サービス、電池残量サービス等) 
 

{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:Qt]]