hal/doc/spec hal-spec.xml.in,1.32,1.33

[David Zeuthen]

Update of /cvs/hal/hal/doc/spec
In directory gabe:/tmp/cvs-serv17769/doc/spec

Modified Files:
	hal-spec.xml.in 
Log Message:
2005-02-28  Richard Hughes  <richard at hughsie.com>

	* doc/spec/hal-spec.xml.in: Added ALSA namespace

	* hald/linux2/classdev.c (sound_add, sound_compute_udi): New
	functions to handle ALSA devices.
 
	* ChangeLog: Updated my email address in this file.



Index: hal-spec.xml.in
===================================================================
RCS file: /cvs/hal/hal/doc/spec/hal-spec.xml.in,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -d -r1.32 -r1.33
--- hal-spec.xml.in	4 Feb 2005 05:24:25 -0000	1.32
+++ hal-spec.xml.in	1 Mar 2005 20:49:50 -0000	1.33
@@ -2811,6 +2811,103 @@
       </informaltable>
     </sect2>
 
+   <sect2 id="device-properties-alsa">
+      <title><literal>alsa</literal> namespace</title>
+      <para>
+
+       Device objects with the capability <literal>alsa</literal>
+       represent all the streams available through ALSA on a soundcard.
+
+      </para>
+      <informaltable>
+        <tgroup cols="2">
+          <thead>
+            <row>
+              <entry>Key (type)</entry>
+              <entry>Values</entry>
+              <entry>Mandatory</entry>
+              <entry>Description</entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry><literal>alsa.card</literal> (int)</entry>
+              <entry></entry>
+              <entry>Yes</entry>
+              <entry>
+               Card number in system as registered by ALSA.
+             </entry>
+            </row>
+            <row>
+              <entry><literal>alsa.device</literal> (int)</entry>
+              <entry></entry>
+              <entry>Yes</entry>
+              <entry>
+               Device number assigned by ALSA for the current card.
+             </entry>
+            </row>
+            <row>
+              <entry><literal>alsa.id</literal> (string)</entry>
+              <entry>
+                Examples: <literal>I82801DBICH4</literal>, <literal>MP3</literal>
+              </entry>
+              <entry>No</entry>
+              <entry>
+               The ALSA ID used to represent the device.
+             </entry>
+           </row>
+            <row>
+              <entry><literal>alsa.physical_device</literal> (int)</entry>
+              <entry></entry>
+              <entry>Yes</entry>
+              <entry>
+               The physical device the ALSA stream is bound to.
+             </entry>
+           </row>
+            <row>
+              <entry><literal>alsa.type</literal> (string)</entry>
+              <entry></entry>
+              <entry>Yes</entry>
+              <entry>
+               The type of the stream.
+             </entry>
+            </row>
+           <row>
+             <entry></entry>
+             <entry><literal>control</literal></entry>
+             <entry></entry>
+             <entry>
+               Stream is control device.
+             </entry>
+           </row>
+           <row>
+             <entry></entry>
+             <entry><literal>capture</literal></entry>
+             <entry></entry>
+             <entry>
+               Stream is capture device.
+             </entry>
+           </row>
+           <row>
+             <entry></entry>
+             <entry><literal>playback</literal></entry>
+             <entry></entry>
+             <entry>
+               Stream is playback device.
+             </entry>
+           </row>
+           <row>
+             <entry></entry>
+             <entry><literal>unknown</literal></entry>
+             <entry></entry>
+             <entry>
+               Stream is unknown device.
+             </entry>
+           </row>
+          </tbody>
+        </tgroup>
+      </informaltable>
+    </sect2>
 
     <sect2 id="device-properties-camera">
       <title><literal>camera</literal> namespace</title>