From 600dcbc158d1ed2f9540c9b835d9c08789c2324c Mon Sep 17 00:00:00 2001
From: Luiz Augusto Von Dentz <luiz.dentz-von@nokia.com>
Date: Mon, 4 Jan 2010 14:51:28 +0200
Subject: [PATCH 2/2] Add media API

Media API is a replacement for the internal audio IPC which is no longer
necessary as DBUS 1.4 and newer are capable of tranfering file descriptors.
---
 doc/audio-api.txt |   16 +++++++++++++++
 doc/media-api.txt |   55 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 71 insertions(+), 0 deletions(-)
 create mode 100644 doc/media-api.txt

diff --git a/doc/audio-api.txt b/doc/audio-api.txt
index 1f09cd5..59efdc8 100644
--- a/doc/audio-api.txt
+++ b/doc/audio-api.txt
@@ -456,3 +456,19 @@ properties	boolean Connected [readonly]
 		uint16 MicrophoneGain  [readonly]
 
 			The speaker gain when available.
+
+Stream hierarchy
+================
+
+Service		org.bluez
+Interface	org.bluez.Stream
+Object path	[variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX/streamX
+
+Methods		int Acquire(object endpoint)
+
+			Acquire stream file descriptor using end point type
+			property as access type.
+
+		void Release(object endpoint)
+
+			Releases file descriptor
diff --git a/doc/media-api.txt b/doc/media-api.txt
new file mode 100644
index 0000000..9818cda
--- /dev/null
+++ b/doc/media-api.txt
@@ -0,0 +1,55 @@
+BlueZ D-Bus Media API description
+*********************************
+
+Media hierarchy
+===============
+
+Service		org.bluez
+Interface	org.bluez.Media
+Object path	[variable prefix]/{hci0,hci1,...}
+
+Methods		void RegisterStreamEndPoint(object endpoint, dict properties)
+
+			Register a local end point to sender, the sender can
+			register as many end points as it likes.
+
+			Note: If the sender disconnects the end points are
+			automatically unregistered.
+
+		void UnregisterStreamEndPoint(object endpoint)
+
+			Unregister sender end point
+
+StreamEndPoint hierarchy
+========================
+
+Service		unique name
+Interface	org.bluez.StreamEndPoint
+Object path	freely definable
+
+Methods		dict GetProperties()
+
+			Returns all properties for the interface. See the
+			properties section for available properties.
+
+		void SetConfiguration(object stream, array{bytes} configuration)
+
+			Set configuration for the stream
+
+		void ClearConfiguration()
+
+			Clear any configuration set.
+
+Properties	string Media [readonly]
+
+			Possible values: "audio" or "video"
+
+		string Type [readonly]
+
+			Possible values: "source", "sink" or "?"
+
+		array{bytes} Capabilities [readonly]
+
+			Capabilities blob as in avdtp spec. This is copied as
+			it is to avdtp GET_CAPABILITIES command, so the size
+			and byte order must match.
-- 
1.6.3.3