audio.h revision 30692c65c4174412c90e79489e98ab85c1a7412f 
1/*
2 * audio.h
3 *
4 * Copyright (C) 2000 Ralph  Metzler <ralph@convergence.de>
5 *                  & Marcus Metzler <marcus@convergence.de>
6 *                    for convergence integrated media GmbH
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Lesser Public License
10 * as published by the Free Software Foundation; either version 2.1
11 * of the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 * GNU General Public License for more details.
17 *
18 * You should have received a copy of the GNU Lesser General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
21 *
22 */
23
24#ifndef _DVBAUDIO_H_
25#define _DVBAUDIO_H_
26
27#include <linux/types.h>
28
29typedef enum {
30	AUDIO_SOURCE_DEMUX, /* Select the demux as the main source */
31	AUDIO_SOURCE_MEMORY /* Select internal memory as the main source */
32} audio_stream_source_t;
33
34
35typedef enum {
36	AUDIO_STOPPED,      /* Device is stopped */
37	AUDIO_PLAYING,      /* Device is currently playing */
38	AUDIO_PAUSED        /* Device is paused */
39} audio_play_state_t;
40
41
42typedef enum {
43	AUDIO_STEREO,
44	AUDIO_MONO_LEFT,
45	AUDIO_MONO_RIGHT,
46	AUDIO_MONO,
47	AUDIO_STEREO_SWAPPED
48} audio_channel_select_t;
49
50
51typedef struct audio_mixer {
52	unsigned int volume_left;
53	unsigned int volume_right;
54  // what else do we need? bass, pass-through, ...
55} audio_mixer_t;
56
57
58typedef struct audio_status {
59	int                    AV_sync_state;  /* sync audio and video? */
60	int                    mute_state;     /* audio is muted */
61	audio_play_state_t     play_state;     /* current playback state */
62	audio_stream_source_t  stream_source;  /* current stream source */
63	audio_channel_select_t channel_select; /* currently selected channel */
64	int                    bypass_mode;    /* pass on audio data to */
65	audio_mixer_t	       mixer_state;    /* current mixer state */
66} audio_status_t;                              /* separate decoder hardware */
67
68
69typedef
70struct audio_karaoke {  /* if Vocal1 or Vocal2 are non-zero, they get mixed  */
71	int vocal1;    /* into left and right t at 70% each */
72	int vocal2;    /* if both, Vocal1 and Vocal2 are non-zero, Vocal1 gets*/
73	int melody;    /* mixed into the left channel and */
74		       /* Vocal2 into the right channel at 100% each. */
75		       /* if Melody is non-zero, the melody channel gets mixed*/
76} audio_karaoke_t;     /* into left and right  */
77
78
79typedef __u16 audio_attributes_t;
80/*   bits: descr. */
81/*   15-13 audio coding mode (0=ac3, 2=mpeg1, 3=mpeg2ext, 4=LPCM, 6=DTS, */
82/*   12    multichannel extension */
83/*   11-10 audio type (0=not spec, 1=language included) */
84/*    9- 8 audio application mode (0=not spec, 1=karaoke, 2=surround) */
85/*    7- 6 Quantization / DRC (mpeg audio: 1=DRC exists)(lpcm: 0=16bit,  */
86/*    5- 4 Sample frequency fs (0=48kHz, 1=96kHz) */
87/*    2- 0 number of audio channels (n+1 channels) */
88
89
90/* for GET_CAPABILITIES and SET_FORMAT, the latter should only set one bit */
91#define AUDIO_CAP_DTS    1
92#define AUDIO_CAP_LPCM   2
93#define AUDIO_CAP_MP1    4
94#define AUDIO_CAP_MP2    8
95#define AUDIO_CAP_MP3   16
96#define AUDIO_CAP_AAC   32
97#define AUDIO_CAP_OGG   64
98#define AUDIO_CAP_SDDS 128
99#define AUDIO_CAP_AC3  256
100
101#define AUDIO_STOP                 _IO('o', 1)
102#define AUDIO_PLAY                 _IO('o', 2)
103#define AUDIO_PAUSE                _IO('o', 3)
104#define AUDIO_CONTINUE             _IO('o', 4)
105#define AUDIO_SELECT_SOURCE        _IO('o', 5)
106#define AUDIO_SET_MUTE             _IO('o', 6)
107#define AUDIO_SET_AV_SYNC          _IO('o', 7)
108#define AUDIO_SET_BYPASS_MODE      _IO('o', 8)
109#define AUDIO_CHANNEL_SELECT       _IO('o', 9)
110#define AUDIO_GET_STATUS           _IOR('o', 10, audio_status_t)
111
112#define AUDIO_GET_CAPABILITIES     _IOR('o', 11, unsigned int)
113#define AUDIO_CLEAR_BUFFER         _IO('o',  12)
114#define AUDIO_SET_ID               _IO('o', 13)
115#define AUDIO_SET_MIXER            _IOW('o', 14, audio_mixer_t)
116#define AUDIO_SET_STREAMTYPE       _IO('o', 15)
117#define AUDIO_SET_EXT_ID           _IO('o', 16)
118#define AUDIO_SET_ATTRIBUTES       _IOW('o', 17, audio_attributes_t)
119#define AUDIO_SET_KARAOKE          _IOW('o', 18, audio_karaoke_t)
120
121/**
122 * AUDIO_GET_PTS
123 *
124 * Read the 33 bit presentation time stamp as defined
125 * in ITU T-REC-H.222.0 / ISO/IEC 13818-1.
126 *
127 * The PTS should belong to the currently played
128 * frame if possible, but may also be a value close to it
129 * like the PTS of the last decoded frame or the last PTS
130 * extracted by the PES parser.
131 */
132#define AUDIO_GET_PTS              _IOR('o', 19, __u64)
133#define AUDIO_BILINGUAL_CHANNEL_SELECT _IO('o', 20)
134
135#endif /* _DVBAUDIO_H_ */
136