org.bluez.GattService(5)

📦
version 5.87 · 9 versions
, in arch rolling, nixpkgs unstable, ubuntu stonking

💖 NAME 💖

org.bluez.GattService — the BlueZ D-Bus GattService API documentation, bestie. This is the manual page org.bluez.GattService(5), hanging out in Linux System Administration, and it’s here to explain the GATT service D-Bus situation. 🫶✨

✨ DESCRIPTION ✨

Okay so listen: GATT local/server and remote/client services share the same high-level D-Bus API. Same API, different side of the story. 💅

Local/Server means a GATT based service that’s exported by a plugin or an external application. That’s the home-team situation. 🏠

Remote/Client means GATT services exported by the peer. That’s the other side of the Bluetooth connection. 🦋

🦋 INTERFACE 🦋

💙 Client

  • Service: org.bluez
  • Interface: org.bluez.GattService1
  • Object path: [variable prefix]/{hci0,hci1,...}/dev_{BDADDR}/service#
  • Used by: bluetoothctl-gatt(1)

💜 Server

  • Service: unique name
  • Interface: org.bluez.GattService1
  • Object path: freely definable

💅 Properties 💅

Property time, bestie. These are the properties this interface brings to the group chat:

  • string UUID [read-only] — the 128-bit service UUID. 💖
  • boolean Primary [read-only] — tells you whether or not this GATT service is a primary service. If it’s false, the service is secondary. No cap.
  • object Device [read-only, optional] — the object path of the Bluetooth device the service belongs to. Only present on services from remote devices. 🌈
  • array{object} Includes [read-only, optional] — an array of object paths representing the included services of this service. 🎀
  • uint16 Handle [read-only] (client only) — service handle. 🧚
  • uint16 Handle [read-write, optional] (Server Only) — service handle. When available in the server it would attempt to use to allocate into the database which may fail; to auto allocate the value 0x0000 shall be used, which will cause the allocated handle to be set once registered. 💀✨

mwah 💋 — this page is brought to you by BlueZ (source/version) and October 2023 (date), with org.bluez.GattService(5) doing its little bow. xoxo, bestie 🫶🎀

📦 where this page comes from