| BlueZ D-Bus Profile API description |
| *********************************** |
| |
| |
| Profile Manager hierarchy |
| ========================= |
| |
| Service org.bluez |
| Interface org.bluez.ProfileManager1 |
| Object path /org/bluez |
| |
| void RegisterProfile(object profile, string uuid, dict options) |
| |
| This registers a profile implementation. |
| |
| If an application disconnects from the bus all |
| its registered profiles will be removed. |
| |
| HFP HS UUID: 0000111e-0000-1000-8000-00805f9b34fb |
| |
| Default RFCOMM channel is 6. And this requires |
| authentication. |
| |
| Available options: |
| |
| string Name |
| |
| Human readable name for the profile |
| |
| string Service |
| |
| The primary service class UUID |
| (if different from the actual |
| profile UUID) |
| |
| string Role |
| |
| For asymmetric profiles that do not |
| have UUIDs available to uniquely |
| identify each side this |
| parameter allows specifying the |
| precise local role. |
| |
| Possible values: "client", "server" |
| |
| uint16 Channel |
| |
| RFCOMM channel number that is used |
| for client and server UUIDs. |
| |
| If applicable it will be used in the |
| SDP record as well. |
| |
| uint16 PSM |
| |
| PSM number that is used for client |
| and server UUIDs. |
| |
| If applicable it will be used in the |
| SDP record as well. |
| |
| boolean RequireAuthentication |
| |
| Pairing is required before connections |
| will be established. No devices will |
| be connected if not paired. |
| |
| boolean RequireAuthorization |
| |
| Request authorization before any |
| connection will be established. |
| |
| boolean AutoConnect |
| |
| In case of a client UUID this will |
| force connection of the RFCOMM or |
| L2CAP channels when a remote device |
| is connected. |
| |
| string ServiceRecord |
| |
| Provide a manual SDP record. |
| |
| uint16 Version |
| |
| Profile version (for SDP record) |
| |
| uint16 Features |
| |
| Profile features (for SDP record) |
| |
| Possible errors: org.bluez.Error.InvalidArguments |
| org.bluez.Error.AlreadyExists |
| |
| void UnregisterProfile(object profile) |
| |
| This unregisters the profile that has been previously |
| registered. The object path parameter must match the |
| same value that has been used on registration. |
| |
| Possible errors: org.bluez.Error.DoesNotExist |
| |
| |
| Profile hierarchy |
| ================= |
| |
| Service unique name |
| Interface org.bluez.Profile1 |
| Object path freely definable |
| |
| Methods void Release() [noreply] |
| |
| This method gets called when the service daemon |
| unregisters the profile. A profile can use it to do |
| cleanup tasks. There is no need to unregister the |
| profile, because when this method gets called it has |
| already been unregistered. |
| |
| void NewConnection(object device, fd, dict fd_properties) |
| |
| This method gets called when a new service level |
| connection has been made and authorized. |
| |
| Common fd_properties: |
| |
| uint16 Version Profile version (optional) |
| uint16 Features Profile features (optional) |
| |
| Possible errors: org.bluez.Error.Rejected |
| org.bluez.Error.Canceled |
| |
| void RequestDisconnection(object device) |
| |
| This method gets called when a profile gets |
| disconnected. |
| |
| The file descriptor is no longer owned by the service |
| daemon and the profile implementation needs to take |
| care of cleaning up all connections. |
| |
| If multiple file descriptors are indicated via |
| NewConnection, it is expected that all of them |
| are disconnected before returning from this |
| method call. |
| |
| Possible errors: org.bluez.Error.Rejected |
| org.bluez.Error.Canceled |
