1"""BlueZ D-Busを使ってBLE GATTサービスとLEアドバタイズを提供する。"""
5from typing
import Optional, Any, Dict
7from dbus_fast.aio
import MessageBus, ProxyObject
8from dbus_fast.constants
import BusType
9from dbus_fast
import Variant, MessageType
10from dbus_fast.service
import ServiceInterface, method, dbus_property, PropertyAccess
12from .ble_interface
import IBleGattServer, RawDataCallback
14logger = logging.getLogger(__name__)
17DEFAULT_SERVICE_UUID =
"12345678-1234-1234-1234-123456789abc"
18DEFAULT_CHAR_MISSION_UUID =
"12345678-1234-1234-1234-123456789abd"
19DEFAULT_CHAR_RESPONSE_UUID =
"12345678-1234-1234-1234-123456789abe"
20DEFAULT_DEVICE_NAME =
"MIRS-Robot"
23RESPONSE_NACK = b
"NACK"
26BASE_APP_PATH =
"/com/mirs/app"
27SERVICE_PATH = f
"{BASE_APP_PATH}/service0"
28CHAR_PATH = f
"{SERVICE_PATH}/char0"
29RESP_PATH = f
"{SERVICE_PATH}/char1"
30ADV_PATH =
"/com/mirs/advertisement0"
34 """BlueZへ公開するGATTオブジェクト階層を返すD-Bus ObjectManager。"""
36 def __init__(self, managed_objects: Dict[str, Dict[str, Dict[str, Variant]]]) ->
None:
37 """BlueZへ返すObject Pathとinterfaceの辞書を保持する。"""
38 super().
__init__(
"org.freedesktop.DBus.ObjectManager")
43 """BlueZへ公開するObject Pathとinterfaceの辞書を返す。"""
48 """BLE GATTサービスのUUIDとPrimary属性を公開する。"""
51 """公開するGATTサービスのUUIDを設定する。"""
52 super().
__init__(
"org.bluez.GattService1")
55 @dbus_property(PropertyAccess.READ)
57 """GATTサービスのUUIDを返す。"""
60 @dbus_property(PropertyAccess.READ)
62 """サービスがprimary serviceであることを示す。"""
67 """ミッションデータを書き込むGATT Characteristicを提供する。"""
69 def __init__(self, char_uuid: str, service_path: str, callback: Optional[RawDataCallback] =
None) ->
None:
70 """UUID、所属サービス、書き込み通知先を設定する。"""
71 super().
__init__(
"org.bluez.GattCharacteristic1")
77 def WriteValue(self, value:
"ay", options:
"a{sv}") ->
None:
78 """書き込みバイト列を受信コールバックへ渡す。"""
80 logger.info(f
"📨 WriteValue 受信: {len(raw)} bytes")
84 except Exception
as e:
85 logger.error(f
"コールバック実行中に例外が発生しました: {e}", exc_info=
True)
87 @dbus_property(PropertyAccess.READ)
89 """CharacteristicのUUIDを返す。"""
92 @dbus_property(PropertyAccess.READ)
94 """所属GATTサービスのObject Pathを返す。"""
97 @dbus_property(PropertyAccess.READ)
99 """書き込み可能なCharacteristicであることを示す。"""
104 """クライアントが処理結果を読むためのread専用Characteristic。"""
106 def __init__(self, char_uuid: str, service_path: str) ->
None:
107 """応答CharacteristicのUUIDと所属サービスを設定する。"""
108 super().
__init__(
"org.bluez.GattCharacteristic1")
114 """クライアントへ返す応答Characteristicの値を更新する。"""
115 self.
_value = bytes(value)
119 """現在設定されている処理結果をバイト列で返す。"""
120 return bytearray(self.
_value)
122 @dbus_property(PropertyAccess.READ)
124 """応答CharacteristicのUUIDを返す。"""
127 @dbus_property(PropertyAccess.READ)
129 """所属GATTサービスのObject Pathを返す。"""
132 @dbus_property(PropertyAccess.READ)
134 """読み取り専用Characteristicであることを示す。"""
139 """サービスUUIDとローカル名をアドバタイズするLE Advertisement。"""
141 def __init__(self, service_uuid: str, local_name: str) ->
None:
142 """Advertisementへ含めるサービスUUIDとローカル名を設定する。"""
143 super().
__init__(
"org.bluez.LEAdvertisement1")
149 """BlueZがAdvertisementを解放したことを記録する。"""
150 logger.info(
"BlueZ により Advertisement が解放されました。")
152 @dbus_property(PropertyAccess.READ)
154 """広告形式としてperipheralを返す。"""
157 @dbus_property(PropertyAccess.READ)
159 """アドバタイズ対象のサービスUUIDを返す。"""
162 @dbus_property(PropertyAccess.READ)
164 """アドバタイズに含めるローカル名を返す。"""
169 """BlueZ D-Bus APIを使うLinux向けBLE GATTサーバー実装。"""
173 service_uuid: str = DEFAULT_SERVICE_UUID,
174 char_uuid: str = DEFAULT_CHAR_MISSION_UUID,
175 response_uuid: str = DEFAULT_CHAR_RESPONSE_UUID,
176 device_name: str = DEFAULT_DEVICE_NAME,
178 """サービスUUID、Characteristic UUID、広告名を設定する。"""
185 self.
_bus: Optional[MessageBus] =
None
188 self.
_resp_iface: Optional[GattResponseCharacteristic1Interface] =
None
194 """サービス登録と広告が完了していればTrueを返す。"""
198 """GATT書き込みを通知するコールバックを登録または解除する。"""
204 """応答Characteristicの値をACKまたはNACKへ更新する。"""
209 """BlueZ D-Bus階層から最初に見つかったhciアダプタのPathを返す。
212 RuntimeError: BlueZへ接続できない、またはアダプタがない場合。
215 intr = await bus.introspect(
"org.bluez",
"/org/bluez")
216 except Exception
as e:
217 raise RuntimeError(f
"BlueZ D-Bus 探索失敗 (/org/bluez): {e}")
219 for node
in intr.nodes:
220 if node.name.startswith(
"hci"):
221 return f
"/org/bluez/{node.name}"
222 raise RuntimeError(
"Bluetooth アダプタ (hci0 等) が検出できませんでした。Bluetooth が有効か確認してください。")
225 """GATTサービスをBlueZへ登録し、LEアドバタイズを開始する。"""
227 logger.warning(
"BLE サーバーは既に起動しています。")
230 logger.info(f
"BlueZ GATT Server を起動します (Name: '{self._device_name}', Service: {self._service_uuid})...")
232 self.
_bus = await MessageBus(bus_type=BusType.SYSTEM).connect()
234 logger.info(f
"Bluetooth アダプタ検出: {self._adapter_path}")
238 "org.bluez.GattService1": {
240 "Primary": Variant(
"b",
True),
244 "org.bluez.GattCharacteristic1": {
246 "Service": Variant(
"o", SERVICE_PATH),
247 "Flags": Variant(
"as", [
"write"]),
251 "org.bluez.GattCharacteristic1": {
253 "Service": Variant(
"o", SERVICE_PATH),
254 "Flags": Variant(
"as", [
"read"]),
265 self.
_bus.export(BASE_APP_PATH, om_iface)
266 self.
_bus.export(SERVICE_PATH, svc_iface)
269 self.
_bus.export(ADV_PATH, adv_iface)
274 gatt_mgr = adapter.get_interface(
"org.bluez.GattManager1")
275 await gatt_mgr.call_register_application(BASE_APP_PATH, {})
276 logger.info(
"GATT Application 登録完了")
278 adv_mgr = adapter.get_interface(
"org.bluez.LEAdvertisingManager1")
279 await adv_mgr.call_register_advertisement(ADV_PATH, {})
280 logger.info(f
"BLE Advertisement 開始 (ローカル名: '{self._device_name}')")
285 logger.info(
"デバイス切断監視を開始しました")
288 except Exception
as e:
290 raise RuntimeError(f
"BLE サーバー起動処理でエラーが発生しました: {e}")
from e
293 """BlueZのPropertiesChangedシグナルを受け取り、切断時に再アドバタイズする。"""
296 if (message.message_type != MessageType.SIGNAL
297 or message.interface !=
"org.freedesktop.DBus.Properties"
298 or message.member !=
"PropertiesChanged"):
301 iface_name, changed, _ = message.body
302 if iface_name !=
"org.bluez.Device1":
304 if "Connected" not in changed:
306 connected = changed[
"Connected"].value
308 logger.info(
"デバイス切断を検知しました。アドバタイズを再開します...")
309 loop = asyncio.get_event_loop()
311 except Exception
as e:
312 logger.warning(f
"PropertiesChanged ハンドラで例外: {e}")
316 """切断後にLEアドバタイズを再登録する。"""
320 adv_mgr = self.
_adapter_proxy.get_interface(
"org.bluez.LEAdvertisingManager1")
322 await adv_mgr.call_unregister_advertisement(ADV_PATH)
325 await asyncio.sleep(0.5)
326 await adv_mgr.call_register_advertisement(ADV_PATH, {})
327 logger.info(f
"BLE Advertisement 再開 (ローカル名: '{self._device_name}')")
328 except Exception
as e:
329 logger.error(f
"Advertisement 再開に失敗しました: {e}")
332 """登録済み広告とGATTアプリケーションを解除し、D-Bus接続を閉じる。"""
336 logger.info(
"BlueZ GATT Server を停止しています...")
343 adv_mgr = adapter.get_interface(
"org.bluez.LEAdvertisingManager1")
344 await adv_mgr.call_unregister_advertisement(ADV_PATH)
345 except Exception
as e:
346 logger.debug(f
"Advertisement 解除スキップ/エラー: {e}")
349 gatt_mgr = adapter.get_interface(
"org.bluez.GattManager1")
350 await gatt_mgr.call_unregister_application(BASE_APP_PATH)
351 except Exception
as e:
352 logger.debug(f
"GATT Application 解除スキップ/エラー: {e}")
353 except Exception
as e:
354 logger.debug(f
"D-Bus 終了処理例外: {e}")
357 self.
_bus.disconnect()
367 logger.info(
"BlueZ GATT Server 停止完了")
BLE GATTサーバーの開始・停止・受信通知・応答値の契約。
None stop(self)
BLEアドバタイズとGATTサービスを停止し、通信リソースを解放する。
BlueZ D-Bus APIを使うLinux向けBLE GATTサーバー実装。
str _detect_adapter_path(self, MessageBus bus)
BlueZ D-Bus階層から最初に見つかったhciアダプタのPathを返す。
Optional[ProxyObject] _adapter_proxy
None stop(self)
登録済み広告とGATTアプリケーションを解除し、D-Bus接続を閉じる。
None set_response(self, bytes value)
応答Characteristicの値をACKまたはNACKへ更新する。
None start(self)
GATTサービスをBlueZへ登録し、LEアドバタイズを開始する。
Optional[MessageBus] _bus
Optional[GattCharacteristic1Interface] _char_iface
None _restart_advertisement(self)
切断後にLEアドバタイズを再登録する。
Optional[str] _adapter_path
Optional[GattResponseCharacteristic1Interface] _resp_iface
None set_on_data_received_callback(self, Optional[RawDataCallback] callback)
GATT書き込みを通知するコールバックを登録または解除する。
bool is_running(self)
サービス登録と広告が完了していればTrueを返す。
Optional[RawDataCallback] _callback
None __init__(self, str service_uuid=DEFAULT_SERVICE_UUID, str char_uuid=DEFAULT_CHAR_MISSION_UUID, str response_uuid=DEFAULT_CHAR_RESPONSE_UUID, str device_name=DEFAULT_DEVICE_NAME)
サービスUUID、Characteristic UUID、広告名を設定する。
ミッションデータを書き込むGATT Characteristicを提供する。
None __init__(self, str char_uuid, str service_path, Optional[RawDataCallback] callback=None)
UUID、所属サービス、書き込み通知先を設定する。
"o" Service(self)
所属GATTサービスのObject Pathを返す。
None WriteValue(self, "ay" value, "a{sv}" options)
書き込みバイト列を受信コールバックへ渡す。
"s" UUID(self)
CharacteristicのUUIDを返す。
"as" Flags(self)
書き込み可能なCharacteristicであることを示す。
クライアントが処理結果を読むためのread専用Characteristic。
None __init__(self, str char_uuid, str service_path)
応答CharacteristicのUUIDと所属サービスを設定する。
"as" Flags(self)
読み取り専用Characteristicであることを示す。
None set_value(self, bytes value)
クライアントへ返す応答Characteristicの値を更新する。
"o" Service(self)
所属GATTサービスのObject Pathを返す。
"ay" ReadValue(self, "a{sv}" options)
現在設定されている処理結果をバイト列で返す。
"s" UUID(self)
応答CharacteristicのUUIDを返す。
BLE GATTサービスのUUIDとPrimary属性を公開する。
"b" Primary(self)
サービスがprimary serviceであることを示す。
"s" UUID(self)
GATTサービスのUUIDを返す。
None __init__(self, str service_uuid)
公開するGATTサービスのUUIDを設定する。
サービスUUIDとローカル名をアドバタイズするLE Advertisement。
None Release(self)
BlueZがAdvertisementを解放したことを記録する。
"as" ServiceUUIDs(self)
アドバタイズ対象のサービスUUIDを返す。
"s" Type(self)
広告形式としてperipheralを返す。
"s" LocalName(self)
アドバタイズに含めるローカル名を返す。
None __init__(self, str service_uuid, str local_name)
Advertisementへ含めるサービスUUIDとローカル名を設定する。
BlueZへ公開するGATTオブジェクト階層を返すD-Bus ObjectManager。
None __init__(self, Dict[str, Dict[str, Dict[str, Variant]]] managed_objects)
BlueZへ返すObject Pathとinterfaceの辞書を保持する。
"a{oa{sa{sv}}}" GetManagedObjects(self)
BlueZへ公開するObject Pathとinterfaceの辞書を返す。