2008-05-29 17:07:06 +08:00
|
|
|
BlueZ D-Bus Network API description
|
|
|
|
|
***********************************
|
|
|
|
|
|
2010-01-02 09:08:17 +08:00
|
|
|
Copyright (C) 2004-2010 Marcel Holtmann <marcel@holtmann.org>
|
2008-05-29 17:07:06 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Network hierarchy
|
|
|
|
|
=================
|
|
|
|
|
|
|
|
|
|
Service org.bluez
|
|
|
|
|
Interface org.bluez.Network
|
2008-09-06 11:17:37 +08:00
|
|
|
Object path [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX
|
2008-05-29 17:07:06 +08:00
|
|
|
|
2008-05-30 16:00:55 +08:00
|
|
|
Methods string Connect(string uuid)
|
2008-05-29 17:07:06 +08:00
|
|
|
|
2008-05-30 16:00:55 +08:00
|
|
|
Connect to the network device and return the network
|
2010-02-03 02:20:59 +08:00
|
|
|
interface name. Examples of the interface name are
|
|
|
|
|
bnep0, bnep1 etc.
|
2008-05-29 17:07:06 +08:00
|
|
|
|
2009-08-11 14:19:13 +08:00
|
|
|
uuid can be either one of "gn", "panu" or "nap" (case
|
|
|
|
|
insensitive) or a traditional string representation of
|
|
|
|
|
UUID or a hexadecimal number.
|
|
|
|
|
|
|
|
|
|
The connection will be closed and network device
|
|
|
|
|
released either upon calling Disconnect() or when
|
|
|
|
|
the client disappears from the message bus.
|
|
|
|
|
|
2008-05-29 17:07:06 +08:00
|
|
|
Possible errors: org.bluez.Error.AlreadyConnected
|
2008-05-30 16:00:55 +08:00
|
|
|
org.bluez.Error.ConnectionAttemptFailed
|
2008-05-29 17:07:06 +08:00
|
|
|
|
|
|
|
|
void Disconnect()
|
|
|
|
|
|
|
|
|
|
Disconnect from the network device.
|
|
|
|
|
|
2008-05-30 05:15:47 +08:00
|
|
|
To abort a connection attempt in case of errors or
|
|
|
|
|
timeouts in the client it is fine to call this method.
|
|
|
|
|
|
2008-05-29 17:07:06 +08:00
|
|
|
Possible errors: org.bluez.Error.Failed
|
|
|
|
|
|
2008-10-03 06:45:27 +08:00
|
|
|
dict GetProperties()
|
2008-05-29 17:07:06 +08:00
|
|
|
|
2008-10-03 06:45:27 +08:00
|
|
|
Returns all properties for the interface. See the
|
|
|
|
|
properties section for available properties.
|
|
|
|
|
|
2008-12-02 02:50:15 +08:00
|
|
|
Signals PropertyChanged(string name, variant value)
|
2008-10-03 06:45:27 +08:00
|
|
|
|
|
|
|
|
This signal indicates a changed value of the given
|
|
|
|
|
property.
|
|
|
|
|
|
|
|
|
|
Properties boolean Connected [readonly]
|
|
|
|
|
|
|
|
|
|
Indicates if the device is connected.
|
|
|
|
|
|
2010-02-03 02:20:59 +08:00
|
|
|
string Interface [readonly]
|
2008-10-03 06:45:27 +08:00
|
|
|
|
|
|
|
|
Indicates the network interface name when available.
|
|
|
|
|
|
|
|
|
|
string UUID [readonly]
|
|
|
|
|
|
|
|
|
|
Indicates the connection role when available.
|
2008-09-02 05:23:15 +08:00
|
|
|
|
|
|
|
|
|
2010-07-13 10:08:19 +08:00
|
|
|
Network server hierarchy
|
|
|
|
|
========================
|
|
|
|
|
|
|
|
|
|
Service org.bluez
|
|
|
|
|
Interface org.bluez.NetworkServer
|
|
|
|
|
Object path /org/bluez/{hci0,hci1,...}
|
|
|
|
|
|
|
|
|
|
Methods void Register(string uuid, string bridge)
|
|
|
|
|
|
|
|
|
|
Register server for the provided UUID. Every new
|
|
|
|
|
connection to this server will be added the bridge
|
|
|
|
|
interface.
|
|
|
|
|
|
|
|
|
|
Valid UUIDs are "gn", "panu" or "nap".
|
|
|
|
|
|
|
|
|
|
void Unregister(string uuid)
|
|
|
|
|
|
|
|
|
|
Unregister the server for provided UUID.
|
|
|
|
|
|
|
|
|
|
All servers will be automatically unregistered when
|
|
|
|
|
the calling application terminates.
|
