summaryrefslogtreecommitdiff
path: root/PROTOCOL
diff options
context:
space:
mode:
authorDavid Henningsson <david.henningsson@canonical.com>2012-02-23 07:17:06 +0100
committerArun Raghavan <arun.raghavan@collabora.co.uk>2012-03-11 12:23:46 +0530
commit793f46320e98aa10dca16bcc1b3a421a4f2b6b7e (patch)
treef6ec07a1375137a9f0d4aea5ada097f4263ba92d /PROTOCOL
parent752ae7285e0fafb5a9b7eba16f925f88980f8100 (diff)
introspect: Expose port info per card to clients
For volume control UIs to be able to show ports in inactive profiles, expose all ports together with the card info. This includes updating the protocol and the client API to show the connection between ports and for which profiles the ports are relevant. Update protocol to 26. Signed-off-by: David Henningsson <david.henningsson@canonical.com>
Diffstat (limited to 'PROTOCOL')
-rw-r--r--PROTOCOL23
1 files changed, 23 insertions, 0 deletions
diff --git a/PROTOCOL b/PROTOCOL
index f437829d8..acd53ba7e 100644
--- a/PROTOCOL
+++ b/PROTOCOL
@@ -299,6 +299,29 @@ The field is added once for every port.
When port availability changes, send a subscription event for the
owning card.
+## v26, implemented by >= 2.0
+
+In reply from PA_COMMAND_GET_CARD_INFO (and thus
+PA_COMMAND_GET_CARD_INFO_LIST), the following is added:
+
+ uint32_t n_ports
+
+...followed by n_ports extended port entries, which look like this:
+
+ string name
+ string description
+ uint32_t priority
+ uint32_t available
+ uint8_t direction
+ proplist
+ uint32_t n_profiles
+ string profile_name_1
+ ...
+ string profile_name_n
+
+Profile names must match earlier sent profile names for the same card.
+
+
#### If you just changed the protocol, read this
## module-tunnel depends on the sink/source/sink-input/source-input protocol
## internals, so if you changed these, you might have broken module-tunnel.