=====================
org.bluez.GattService
=====================

-------------------------------------------------
BlueZ D-Bus GattService API documentation
-------------------------------------------------

:Version: BlueZ
:Date: October 2023
:Manual section: 5
:Manual group: Linux System Administration

Description
===========

GATT local/server and remote/client services share the same high-level D-Bus
API.

Local/Server refers to GATT based service exported by a plugin or an external
application.

Remote/Client refers to GATT services exported by the peer.

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
----------

string UUID [read-only]
```````````````````````

128-bit service UUID.

boolean Primary [read-only]
```````````````````````````

Indicates whether or not this GATT service is a primary service. If false, the
service is secondary.

object Device [read-only, optional]
```````````````````````````````````

Object path of the Bluetooth device the service belongs to. Only present on
services from remote devices.

array{object} Includes [read-only, optional]
````````````````````````````````````````````

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.
