mirror of
https://git.kernel.org/pub/scm/bluetooth/bluez.git
synced 2024-12-15 06:55:30 +08:00
153 lines
4.0 KiB
Plaintext
153 lines
4.0 KiB
Plaintext
BlueZ D-Bus Health API description
|
|
**********************************
|
|
|
|
Santiago Carot-Nemesio <sancane@gmail.com>
|
|
José Antonio Santos-Cadenas <santoscadenas@gmail.com>
|
|
Elvis Pfützenreuter <epx@signove.com>
|
|
|
|
HealthManager hierarchy
|
|
=======================
|
|
|
|
Service org.bluez
|
|
Interface org.bluez.HealthManager1
|
|
Object path /org/bluez/
|
|
|
|
Methods object CreateApplication(dict config)
|
|
|
|
Returns the path of the new registered application.
|
|
Application will be closed by the call or implicitly
|
|
when the programs leaves the bus.
|
|
|
|
config:
|
|
uint16 DataType:
|
|
|
|
Mandatory
|
|
|
|
string Role:
|
|
|
|
Mandatory. Possible values: "Source",
|
|
"Sink"
|
|
|
|
string Description:
|
|
|
|
Optional
|
|
|
|
ChannelType:
|
|
|
|
Optional, just for sources. Possible
|
|
values: "Reliable", "Streaming"
|
|
|
|
Possible Errors: org.bluez.Error.InvalidArguments
|
|
|
|
void DestroyApplication(object application)
|
|
|
|
Closes the HDP application identified by the object
|
|
path. Also application will be closed if the process
|
|
that started it leaves the bus. Only the creator of the
|
|
application will be able to destroy it.
|
|
|
|
Possible errors: org.bluez.Error.InvalidArguments
|
|
org.bluez.Error.NotFound
|
|
org.bluez.Error.NotAllowed
|
|
|
|
HealthDevice hierarchy
|
|
======================
|
|
|
|
Service org.bluez
|
|
Interface org.bluez.HealthDevice1
|
|
Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
|
|
|
|
Methods boolean Echo()
|
|
|
|
Sends an echo petition to the remote service. Returns
|
|
True if response matches with the buffer sent. If some
|
|
error is detected False value is returned.
|
|
|
|
Possible errors: org.bluez.Error.InvalidArguments
|
|
org.bluez.Error.OutOfRange
|
|
|
|
object CreateChannel(object application, string configuration)
|
|
|
|
Creates a new data channel. The configuration should
|
|
indicate the channel quality of service using one of
|
|
this values "Reliable", "Streaming", "Any".
|
|
|
|
Returns the object path that identifies the data
|
|
channel that is already connected.
|
|
|
|
Possible errors: org.bluez.Error.InvalidArguments
|
|
org.bluez.Error.HealthError
|
|
|
|
void DestroyChannel(object channel)
|
|
|
|
Destroys the data channel object. Only the creator of
|
|
the channel or the creator of the HealthApplication
|
|
that received the data channel will be able to destroy
|
|
it.
|
|
|
|
Possible errors: org.bluez.Error.InvalidArguments
|
|
org.bluez.Error.NotFound org.bluez.Error.NotAllowed
|
|
|
|
Signals void ChannelConnected(object channel)
|
|
|
|
This signal is launched when a new data channel is
|
|
created or when a known data channel is reconnected.
|
|
|
|
void ChannelDeleted(object channel)
|
|
|
|
This signal is launched when a data channel is deleted.
|
|
|
|
After this signal the data channel path will not be
|
|
valid and its path can be reused for future data
|
|
channels.
|
|
|
|
Properties object MainChannel [readonly]
|
|
|
|
The first reliable channel opened. It is needed by
|
|
upper applications in order to send specific protocol
|
|
data units. The first reliable can change after a
|
|
reconnection.
|
|
|
|
HealthChannel hierarchy
|
|
=======================
|
|
|
|
Service org.bluez
|
|
Interface org.bluez.HealthChannel1
|
|
Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX/chanZZZ
|
|
|
|
Only the process that created the data channel or the creator of the
|
|
HealthApplication that received it will be able to call these methods.
|
|
|
|
Methods fd Acquire()
|
|
|
|
Returns the file descriptor for this data channel. If
|
|
the data channel is not connected it will also
|
|
reconnect.
|
|
|
|
Possible Errors: org.bluez.Error.NotConnected
|
|
org.bluez.Error.NotAllowed
|
|
|
|
void Release()
|
|
|
|
Releases the fd. Application should also need to
|
|
close() it.
|
|
|
|
Possible Errors: org.bluez.Error.NotAcquired
|
|
org.bluez.Error.NotAllowed
|
|
|
|
Properties string Type [readonly]
|
|
|
|
The quality of service of the data channel. ("Reliable"
|
|
or "Streaming")
|
|
|
|
object Device [readonly]
|
|
|
|
Identifies the Remote Device that is connected with.
|
|
Maps with a HealthDevice object.
|
|
|
|
object Application [readonly]
|
|
|
|
Identifies the HealthApplication to which this channel
|
|
is related to (which indirectly defines its role and
|
|
data type).
|