include/linux/dvb/audio.h

   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 #ifdef __KERNEL__
  28 #include <linux/types.h>
  29 #else
  30 #include <stdint.h>
  31 #endif
  32
  33
  34 typedef enum {
  35         AUDIO_SOURCE_DEMUX, /* Select the demux as the main source */
  36         AUDIO_SOURCE_MEMORY /* Select internal memory as the main source */
  37 } audio_stream_source_t;
  38
  39
  40 typedef enum {
  41         AUDIO_STOPPED,      /* Device is stopped */
  42         AUDIO_PLAYING,      /* Device is currently playing */
  43         AUDIO_PAUSED        /* Device is paused */
  44 } audio_play_state_t;
  45
  46
  47 typedef enum {
  48         AUDIO_STEREO,
  49         AUDIO_MONO_LEFT,
  50         AUDIO_MONO_RIGHT
  51 } audio_channel_select_t;
  52
  53
  54 typedef struct audio_mixer {
  55         unsigned int volume_left;
  56         unsigned int volume_right;
  57   // what else do we need? bass, pass-through, ...
  58 } audio_mixer_t;
  59
  60
  61 typedef struct audio_status {
  62         int                    AV_sync_state;  /* sync audio and video? */
  63         int                    mute_state;     /* audio is muted */
  64         audio_play_state_t     play_state;     /* current playback state */
  65         audio_stream_source_t  stream_source;  /* current stream source */
  66         audio_channel_select_t channel_select; /* currently selected channel */
  67         int                    bypass_mode;    /* pass on audio data to */
  68         audio_mixer_t          mixer_state;    /* current mixer state */
  69 } audio_status_t;                              /* separate decoder hardware */
  70
  71
  72 typedef
  73 struct audio_karaoke{  /* if Vocal1 or Vocal2 are non-zero, they get mixed  */
  74         int vocal1;    /* into left and right t at 70% each */
  75         int vocal2;    /* if both, Vocal1 and Vocal2 are non-zero, Vocal1 gets*/
  76         int melody;    /* mixed into the left channel and */
  77                        /* Vocal2 into the right channel at 100% each. */
  78                        /* if Melody is non-zero, the melody channel gets mixed*/
  79 } audio_karaoke_t;     /* into left and right  */
  80
  81
  82 typedef uint16_t audio_attributes_t;
  83 /*   bits: descr. */
  84 /*   15-13 audio coding mode (0=ac3, 2=mpeg1, 3=mpeg2ext, 4=LPCM, 6=DTS, */
  85 /*   12    multichannel extension */
  86 /*   11-10 audio type (0=not spec, 1=language included) */
  87 /*    9- 8 audio application mode (0=not spec, 1=karaoke, 2=surround) */
  88 /*    7- 6 Quantization / DRC (mpeg audio: 1=DRC exists)(lpcm: 0=16bit,  */
  89 /*    5- 4 Sample frequency fs (0=48kHz, 1=96kHz) */
  90 /*    2- 0 number of audio channels (n+1 channels) */
  91
  92
  93 /* for GET_CAPABILITIES and SET_FORMAT, the latter should only set one bit */
  94 #define AUDIO_CAP_DTS    1
  95 #define AUDIO_CAP_LPCM   2
  96 #define AUDIO_CAP_MP1    4
  97 #define AUDIO_CAP_MP2    8
  98 #define AUDIO_CAP_MP3   16
  99 #define AUDIO_CAP_AAC   32
 100 #define AUDIO_CAP_OGG   64
 101 #define AUDIO_CAP_SDDS 128
 102 #define AUDIO_CAP_AC3  256
 103
 104 #define AUDIO_STOP                 _IO('o', 1)
 105 #define AUDIO_PLAY                 _IO('o', 2)
 106 #define AUDIO_PAUSE                _IO('o', 3)
 107 #define AUDIO_CONTINUE             _IO('o', 4)
 108 #define AUDIO_SELECT_SOURCE        _IO('o', 5)
 109 #define AUDIO_SET_MUTE             _IO('o', 6)
 110 #define AUDIO_SET_AV_SYNC          _IO('o', 7)
 111 #define AUDIO_SET_BYPASS_MODE      _IO('o', 8)
 112 #define AUDIO_CHANNEL_SELECT       _IO('o', 9)
 113 #define AUDIO_GET_STATUS           _IOR('o', 10, audio_status_t)
 114
 115 #define AUDIO_GET_CAPABILITIES     _IOR('o', 11, unsigned int)
 116 #define AUDIO_CLEAR_BUFFER         _IO('o',  12)
 117 #define AUDIO_SET_ID               _IO('o', 13)
 118 #define AUDIO_SET_MIXER            _IOW('o', 14, audio_mixer_t)
 119 #define AUDIO_SET_STREAMTYPE       _IO('o', 15)
 120 #define AUDIO_SET_EXT_ID           _IO('o', 16)
 121 #define AUDIO_SET_ATTRIBUTES       _IOW('o', 17, audio_attributes_t)
 122 #define AUDIO_SET_KARAOKE          _IOW('o', 18, audio_karaoke_t)
 123
 124 /**
 125  * AUDIO_GET_PTS
 126  *
 127  * Read the 33 bit presentation time stamp as defined
 128  * in ITU T-REC-H.222.0 / ISO/IEC 13818-1.
 129  *
 130  * The PTS should belong to the currently played
 131  * frame if possible, but may also be a value close to it
 132  * like the PTS of the last decoded frame or the last PTS
 133  * extracted by the PES parser.
 134  */
 135 #define AUDIO_GET_PTS              _IOR('o', 19, __u64)
 136
 137 #endif /* _DVBAUDIO_H_ */