diff options
author | Russell King <rmk+kernel@arm.linux.org.uk> | 2012-10-11 05:55:04 -0400 |
---|---|---|
committer | Russell King <rmk+kernel@arm.linux.org.uk> | 2012-10-11 05:55:04 -0400 |
commit | a0f0dd57f4a85310d9936f1770a0424b49fef876 (patch) | |
tree | 2f85b8b67dda13d19b02ca39e0fbef921cb1cf8b /Documentation/DocBook/media/dvb/audio.xml | |
parent | 2a552d5e63d7fa602c9a9a0717008737f55625a6 (diff) | |
parent | 846a136881b8f73c1f74250bf6acfaa309cab1f2 (diff) |
Merge branch 'fixes' into for-linus
Conflicts:
arch/arm/kernel/smp.c
Diffstat (limited to 'Documentation/DocBook/media/dvb/audio.xml')
-rw-r--r-- | Documentation/DocBook/media/dvb/audio.xml | 113 |
1 files changed, 112 insertions, 1 deletions
diff --git a/Documentation/DocBook/media/dvb/audio.xml b/Documentation/DocBook/media/dvb/audio.xml index d64386237207..a7ea56c71a27 100644 --- a/Documentation/DocBook/media/dvb/audio.xml +++ b/Documentation/DocBook/media/dvb/audio.xml | |||
@@ -1,12 +1,16 @@ | |||
1 | <title>DVB Audio Device</title> | 1 | <title>DVB Audio Device</title> |
2 | <para>The DVB audio device controls the MPEG2 audio decoder of the DVB hardware. It | 2 | <para>The DVB audio device controls the MPEG2 audio decoder of the DVB hardware. It |
3 | can be accessed through <emphasis role="tt">/dev/dvb/adapter0/audio0</emphasis>. Data types and and | 3 | can be accessed through <emphasis role="tt">/dev/dvb/adapter0/audio0</emphasis>. Data types and and |
4 | ioctl definitions can be accessed by including <emphasis role="tt">linux/dvb/video.h</emphasis> in your | 4 | ioctl definitions can be accessed by including <emphasis role="tt">linux/dvb/audio.h</emphasis> in your |
5 | application. | 5 | application. |
6 | </para> | 6 | </para> |
7 | <para>Please note that some DVB cards don’t have their own MPEG decoder, which results in | 7 | <para>Please note that some DVB cards don’t have their own MPEG decoder, which results in |
8 | the omission of the audio and video device. | 8 | the omission of the audio and video device. |
9 | </para> | 9 | </para> |
10 | <para> | ||
11 | These ioctls were also used by V4L2 to control MPEG decoders implemented in V4L2. The use | ||
12 | of these ioctls for that purpose has been made obsolete and proper V4L2 ioctls or controls | ||
13 | have been created to replace that functionality.</para> | ||
10 | 14 | ||
11 | <section id="audio_data_types"> | 15 | <section id="audio_data_types"> |
12 | <title>Audio Data Types</title> | 16 | <title>Audio Data Types</title> |
@@ -558,6 +562,8 @@ role="subsection"><title>AUDIO_SELECT_SOURCE</title> | |||
558 | role="subsection"><title>AUDIO_SET_MUTE</title> | 562 | role="subsection"><title>AUDIO_SET_MUTE</title> |
559 | <para>DESCRIPTION | 563 | <para>DESCRIPTION |
560 | </para> | 564 | </para> |
565 | <para>This ioctl is for DVB devices only. To control a V4L2 decoder use the V4L2 | ||
566 | &VIDIOC-DECODER-CMD; with the <constant>V4L2_DEC_CMD_START_MUTE_AUDIO</constant> flag instead.</para> | ||
561 | <informaltable><tgroup cols="1"><tbody><row><entry | 567 | <informaltable><tgroup cols="1"><tbody><row><entry |
562 | align="char"> | 568 | align="char"> |
563 | <para>This ioctl call asks the audio device to mute the stream that is currently being | 569 | <para>This ioctl call asks the audio device to mute the stream that is currently being |
@@ -730,6 +736,8 @@ role="subsection"><title>AUDIO_SET_BYPASS_MODE</title> | |||
730 | role="subsection"><title>AUDIO_CHANNEL_SELECT</title> | 736 | role="subsection"><title>AUDIO_CHANNEL_SELECT</title> |
731 | <para>DESCRIPTION | 737 | <para>DESCRIPTION |
732 | </para> | 738 | </para> |
739 | <para>This ioctl is for DVB devices only. To control a V4L2 decoder use the V4L2 | ||
740 | <constant>V4L2_CID_MPEG_AUDIO_DEC_PLAYBACK</constant> control instead.</para> | ||
733 | <informaltable><tgroup cols="1"><tbody><row><entry | 741 | <informaltable><tgroup cols="1"><tbody><row><entry |
734 | align="char"> | 742 | align="char"> |
735 | <para>This ioctl call asks the Audio Device to select the requested channel if possible.</para> | 743 | <para>This ioctl call asks the Audio Device to select the requested channel if possible.</para> |
@@ -772,6 +780,109 @@ role="subsection"><title>AUDIO_CHANNEL_SELECT</title> | |||
772 | </row></tbody></tgroup></informaltable> | 780 | </row></tbody></tgroup></informaltable> |
773 | &return-value-dvb; | 781 | &return-value-dvb; |
774 | 782 | ||
783 | </section><section id="AUDIO_BILINGUAL_CHANNEL_SELECT" | ||
784 | role="subsection"><title>AUDIO_BILINGUAL_CHANNEL_SELECT</title> | ||
785 | <para>DESCRIPTION | ||
786 | </para> | ||
787 | <para>This ioctl is obsolete. Do not use in new drivers. It has been replaced by | ||
788 | the V4L2 <constant>V4L2_CID_MPEG_AUDIO_DEC_MULTILINGUAL_PLAYBACK</constant> control | ||
789 | for MPEG decoders controlled through V4L2.</para> | ||
790 | <informaltable><tgroup cols="1"><tbody><row><entry | ||
791 | align="char"> | ||
792 | <para>This ioctl call asks the Audio Device to select the requested channel for bilingual streams if possible.</para> | ||
793 | </entry> | ||
794 | </row></tbody></tgroup></informaltable> | ||
795 | <para>SYNOPSIS | ||
796 | </para> | ||
797 | <informaltable><tgroup cols="1"><tbody><row><entry | ||
798 | align="char"> | ||
799 | <para>int ioctl(int fd, int request = | ||
800 | AUDIO_BILINGUAL_CHANNEL_SELECT, audio_channel_select_t);</para> | ||
801 | </entry> | ||
802 | </row></tbody></tgroup></informaltable> | ||
803 | <para>PARAMETERS | ||
804 | </para> | ||
805 | <informaltable><tgroup cols="2"><tbody><row><entry | ||
806 | align="char"> | ||
807 | <para>int fd</para> | ||
808 | </entry><entry | ||
809 | align="char"> | ||
810 | <para>File descriptor returned by a previous call to open().</para> | ||
811 | </entry> | ||
812 | </row><row><entry | ||
813 | align="char"> | ||
814 | <para>int request</para> | ||
815 | </entry><entry | ||
816 | align="char"> | ||
817 | <para>Equals AUDIO_BILINGUAL_CHANNEL_SELECT for this | ||
818 | command.</para> | ||
819 | </entry> | ||
820 | </row><row><entry | ||
821 | align="char"> | ||
822 | <para>audio_channel_select_t | ||
823 | ch</para> | ||
824 | </entry><entry | ||
825 | align="char"> | ||
826 | <para>Select the output format of the audio (mono left/right, | ||
827 | stereo).</para> | ||
828 | </entry> | ||
829 | </row> | ||
830 | </tbody></tgroup></informaltable> | ||
831 | &return-value-dvb; | ||
832 | |||
833 | </section><section id="AUDIO_GET_PTS" | ||
834 | role="subsection"><title>AUDIO_GET_PTS</title> | ||
835 | <para>DESCRIPTION | ||
836 | </para> | ||
837 | <para>This ioctl is obsolete. Do not use in new drivers. If you need this functionality, | ||
838 | then please contact the linux-media mailing list (&v4l-ml;).</para> | ||
839 | <informaltable><tgroup cols="1"><tbody><row><entry | ||
840 | align="char"> | ||
841 | <para>This ioctl call asks the Audio Device to return the current PTS timestamp.</para> | ||
842 | </entry> | ||
843 | </row></tbody></tgroup></informaltable> | ||
844 | <para>SYNOPSIS | ||
845 | </para> | ||
846 | <informaltable><tgroup cols="1"><tbody><row><entry | ||
847 | align="char"> | ||
848 | <para>int ioctl(int fd, int request = | ||
849 | AUDIO_GET_PTS, __u64 *pts);</para> | ||
850 | </entry> | ||
851 | </row></tbody></tgroup></informaltable> | ||
852 | <para>PARAMETERS | ||
853 | </para> | ||
854 | <informaltable><tgroup cols="2"><tbody><row><entry | ||
855 | align="char"> | ||
856 | <para>int fd</para> | ||
857 | </entry><entry | ||
858 | align="char"> | ||
859 | <para>File descriptor returned by a previous call to open().</para> | ||
860 | </entry> | ||
861 | </row><row><entry | ||
862 | align="char"> | ||
863 | <para>int request</para> | ||
864 | </entry><entry | ||
865 | align="char"> | ||
866 | <para>Equals AUDIO_GET_PTS for this | ||
867 | command.</para> | ||
868 | </entry> | ||
869 | </row><row><entry | ||
870 | align="char"> | ||
871 | <para>__u64 *pts | ||
872 | </para> | ||
873 | </entry><entry | ||
874 | align="char"> | ||
875 | <para>Returns the 33-bit timestamp as defined in ITU T-REC-H.222.0 / ISO/IEC 13818-1. | ||
876 | </para> | ||
877 | <para> | ||
878 | The PTS should belong to the currently played | ||
879 | frame if possible, but may also be a value close to it | ||
880 | like the PTS of the last decoded frame or the last PTS | ||
881 | extracted by the PES parser.</para> | ||
882 | </entry> | ||
883 | </row></tbody></tgroup></informaltable> | ||
884 | &return-value-dvb; | ||
885 | |||
775 | </section><section id="AUDIO_GET_STATUS" | 886 | </section><section id="AUDIO_GET_STATUS" |
776 | role="subsection"><title>AUDIO_GET_STATUS</title> | 887 | role="subsection"><title>AUDIO_GET_STATUS</title> |
777 | <para>DESCRIPTION | 888 | <para>DESCRIPTION |