First draft of the Service API.

1 files changed, 63 insertions, 0 deletions

diff --git a/hcid/dbus-api.txt b/hcid/dbus-api.txt
index c1f66b03..546ae7ac 100644
--- a/hcid/dbus-api.txt
+++ b/hcid/dbus-api.txt
@@ -159,6 +159,15 @@ Methods		uint32 InterfaceVersion()
 
 			Returns list of service connection identifiers.
 
+		void RegisterService(string path)
+
+		void UnregisterService(string path)
+
+		void RegisterShadowService(string path)
+
+		void UnregisterShadowService(string path)
+
+
 Signals		void AdapterAdded(string path)
 
 			Parameter is object path of added adapter.
@@ -956,6 +965,38 @@ Methods		void RegisterDefaultPasskeyAgent(string path)
 			Possible errors: org.bluez.Error.DoesNotExist
 
 
+Service hierarchy (experimental)
+================================
+
+Service		org.bluez
+Interface	org.bluez.Service
+Object path	/org/bluez
+
+Methods		array{string} GetInterfaceNames()
+
+		string GetConnectionName()
+
+		string GetName()
+
+		string GetDescription()
+
+		void Start()
+
+		void Stop()
+
+		boolean IsRunning()
+
+		array{string} ListUsers(string address)
+
+		void RemoveUser(string address)
+
+		void SetTrusted(string address)
+
+		boolean IsTrusted(string address)
+
+		void RemoveTrust(string address)
+
+
 PasskeyAgent hierarchy
 ======================
 
@@ -1004,6 +1045,28 @@ Methods		string Request(string path, string address, boolean numeric)
 			gets called it has already been unregistered.
 
 
+ServiceAgent hierarchy (experimental)
+=====================================
+
+Service		unique name
+Interface	org.bluez.ServiceAgent
+Object path	freely definable
+
+Methods		array{string} Interfaces()
+
+		string Name()
+
+		string Description()
+
+		void Start()
+
+		void Stop()
+
+		array{byte} Record()
+
+		void Release()
+
+
 RFCOMM hierarchy (experimental)
 ===============================