Blob: org.bluez.AdvertisementMonitorManager.rst

Blob id: 3860429b0cee7c80646fa751429e2d844828035b

Size: 2.6 KB

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
=====================================
org.bluez.AdvertisementMonitorManager
=====================================

---------------------------------------------------------
BlueZ D-Bus AdvertisementMonitorManager API documentation
---------------------------------------------------------

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

Interface
=========

:Service:	org.bluez
:Interface:	org.bluez.AdvertisementMonitorManager1 [experimental]
:Object path:	/org/bluez/{hci0,hci1,...}

Methods
-------

void RegisterMonitor(object application)
````````````````````````````````````````

Registers the root path of a hierarchy of advertisement monitors implementing
**org.bluez.AdvertisementMonitor(5)**.

The application object path together with the D-Bus ystem bus connection ID
define the identification of the application registering advertisement monitors.

Once a root path is registered by a client via this method, the client can
freely expose/unexpose advertisement monitors without re-registering the root
path again.

After use, the client should call **UnregisterMonitor()** method to invalidate
the advertisement monitors.

Possible errors:

:org.bluez.Error.InvalidArguments:
:org.bluez.Error.AlreadyExists:
:org.bluez.Error.Failed:

void UnregisterMonitor(object application)
``````````````````````````````````````````

Unregisters a hierarchy of advertisement monitors that has been previously
registered with **RegisterMonitor()**. The object path parameter must match the
same value that has been used on registration.

Upon unregistration, the advertisement monitor(s) should expect to receive
**Release()** method as the signal that the advertisement monitor(s) has been
deactivated.

Possible errors:

:org.bluez.Error.InvalidArguments:
:org.bluez.Error.DoesNotExist:

Properties
----------

array{string} SupportedMonitorTypes [read-only]
```````````````````````````````````````````````

This lists the supported types of advertisement monitors. An application
should check this before instantiate and expose an object of
**org.bluez.AdvertisementMonitor(5)**.

Possible values:

:"or_patterns":

	Patterns with logic OR applied. With this type, property **Patterns**
	must exist and has at least one pattern.

array{string} SupportedFeatures [read-only]
```````````````````````````````````````````

This lists the features of advertisement monitoring supported by
**bluetoothd(8)**.

Possible values:

:"controller-patterns":

	If the controller is capable of performing advertisement monitoring by
	patterns, **bluetoothd(8)** would offload the patterns to the controller
	to reduce power consumption.