DBusBluez.xml

<!--
# Copyright (c) 2020 Project CHIP Authors
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

# This file is constructed based on the BlueZ D-Bus API documentation
# available at: https://git.kernel.org/pub/scm/bluetooth/bluez.git/tree/doc
#
# It does not contain all exported interfaces, but only those that are
# relevant for the Matter GATT service and advertisement management. Also,
# some properties and methods not used by Matter are omitted in order to
# decrease the size of Matter SDK library.
-->
<!DOCTYPE node PUBLIC
  "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
  "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">

<node>

  <interface name="org.bluez.Adapter1">
    <method name="StartDiscovery" />
    <method name="StopDiscovery" />
    <method name="SetDiscoveryFilter">
      <arg name="properties" type="a{sv}" direction="in" />
    </method>
    <method name="RemoveDevice">
      <arg name="device" type="o" direction="in" />
    </method>
    <property name="Address" type="s" access="read" />
    <property name="Name" type="s" access="read" />
    <property name="Alias" type="s" access="readwrite" />
    <property name="Class" type="u" access="read" />
    <property name="Powered" type="b" access="readwrite" />
    <property name="Discoverable" type="b" access="readwrite" />
  </interface>

  <interface name="org.bluez.Device1">
    <method name="Disconnect" />
    <method name="Connect" />
    <property name="Address" type="s" access="read" />
    <property name="Connected" type="b" access="read" />
    <property name="Adapter" type="o" access="read" />
    <property name="ServiceData" type="a{sv}" access="read" />
    <property name="ServicesResolved" type="b" access="read" />
  </interface>

  <interface name="org.bluez.GattManager1">
    <method name="RegisterApplication">
      <arg name="application" type="o" direction="in" />
      <arg name="options" type="a{sv}" direction="in" />
    </method>
    <method name="UnregisterApplication">
      <arg name="application" type="o" direction="in" />
    </method>
  </interface>

  <!--
  This interface shall be exported by Matter GATT application and registered
  with org.bluez.GattManager1.RegisterApplication method.
  -->
  <interface name="org.bluez.GattService1">
    <property name="UUID" type="s" access="read" />
    <property name="Device" type="o" access="read" />
    <property name="Primary" type="b" access="read" />
    <!-- <property name="Includes" type="ao" access="read" /> -->
  </interface>

  <!--
  This interface shall be exported by Matter GATT application and linked
  with org.bluez.GattService1 object via the Service property.
  -->
  <interface name="org.bluez.GattCharacteristic1">
    <method name="ReadValue">
      <arg name="options" type="a{sv}" direction="in"/>
      <arg name="value" type="ay" direction="out">
        <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
      </arg>
    </method>
    <method name="WriteValue">
      <arg name="value" type="ay" direction="in">
        <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
      </arg>
      <arg name="options" type="a{sv}" direction="in"/>
    </method>
    <method name="AcquireWrite">
      <annotation name="org.gtk.GDBus.C.UnixFD" value="true" />
      <arg name="options" type="a{sv}" direction="in" />
      <arg name="fd" type="h" direction="out" />
      <arg name="mtu" type="q" direction="out" />
    </method>
    <method name="AcquireNotify">
      <annotation name="org.gtk.GDBus.C.UnixFD" value="true" />
      <arg name="options" type="a{sv}" direction="in" />
      <arg name="fd" type="h" direction="out" />
      <arg name="mtu" type="q" direction="out" />
    </method>
    <method name="StartNotify" />
    <method name="StopNotify" />
    <method name="Confirm" />
    <property name="UUID" type="s" access="read" />
    <property name="Service" type="o" access="read" />
    <property name="Value" type="ay" access="read">
      <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
    </property>
    <property name="Notifying" type="b" access="read" />
    <property name="Flags" type="as" access="read" />
    <property name="WriteAcquired" type="b" access="read" />
    <property name="NotifyAcquired" type="b" access="read" />
  </interface>

  <!--
  This interface shall be exported by Matter GATT application and linked
  with org.bluez.GattCharacteristic1 object via the Characteristic property.
  -->
  <interface name="org.bluez.GattDescriptor1">
    <method name="ReadValue">
      <arg name="options" type="a{sv}" direction="in"/>
      <arg name="value" type="ay" direction="out">
        <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
      </arg>
    </method>
    <method name="WriteValue">
      <arg name="value" type="ay" direction="in">
        <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
      </arg>
      <arg name="options" type="a{sv}" direction="in"/>
    </method>
    <property name="UUID" type="s" access="read" />
    <property name="Characteristic" type="o" access="read" />
    <property name="Value" type="ay" access="read">
      <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
    </property>
  </interface>

  <!--
  This interface shall be exported by Matter GATT application and registered
  with org.bluez.LEAdvertisingManager1.RegisterAdvertisement method.
  -->
  <interface name="org.bluez.LEAdvertisement1">
    <method name="Release"/>
    <property name="Type" type="s" access="read"/>
    <property name="ServiceUUIDs" type="as" access="read">
      <annotation name="org.gtk.GDBus.C.ForceGVariant" value="true"/>
    </property>
    <property name="ManufacturerData" type="a{qv}" access="read"/>
    <property name="SolicitUUIDs" type="as" access="read"/>
    <property name="ServiceData" type="a{sv}" access="read"/>
    <property name="Data" type="a{yay}" access="read"/>
    <property name="Discoverable" type="b" access="read"/>
    <!--
    Do not expose discoverable timeout property, so BlueZ will set it
    internally to zero, effectively disabling the timeout. Because of BlueZ
    bug, which is not fixed until BlueZ 5.73, exposing discoverable timeout
    as zero will timeout the advertisement immediately.

    <property name="DiscoverableTimeout" type="q" access="read"/>
    -->
    <property name="Includes" type="as" access="read"/>
    <property name="LocalName" type="s" access="read"/>
    <property name="Appearance" type="q" access="read"/>
    <!--
    Do not expose duration, so BlueZ will use the internal default value.

    <property name="Duration" type="q" access="read"/>
    -->
    <!--
    Do not expose timeout property, so BlueZ will not call the Release()
    method after a timeout.

    <property name="Timeout" type="q" access="read"/>
    -->
    <!--
    We are not using SecondaryChannel property, so we do not expose it.

    <property name="SecondaryChannel" type="s" access="read"/>
    -->
    <property name="MinInterval" type="u" access="read"/>
    <property name="MaxInterval" type="u" access="read"/>
  </interface>

  <interface name="org.bluez.LEAdvertisingManager1">
    <method name="RegisterAdvertisement">
      <arg name="advertisement" type="o" direction="in" />
      <arg name="options" type="a{sv}" direction="in" />
    </method>
    <method name="UnregisterAdvertisement">
      <arg name="service" type="o" direction="in" />
    </method>
  </interface>

</node>