asound.h 36 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933
  1. /*
  2. * Advanced Linux Sound Architecture - ALSA - Driver
  3. * Copyright (c) 1994-2003 by Jaroslav Kysela <perex@suse.cz>,
  4. * Abramo Bagnara <abramo@alsa-project.org>
  5. *
  6. *
  7. * This program is free software; you can redistribute it and/or modify
  8. * it under the terms of the GNU General Public License as published by
  9. * the Free Software Foundation; either version 2 of the License, or
  10. * (at your option) any later version.
  11. *
  12. * This program is distributed in the hope that it will be useful,
  13. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  15. * GNU General Public License for more details.
  16. *
  17. * You should have received a copy of the GNU General Public License
  18. * along with this program; if not, write to the Free Software
  19. * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  20. *
  21. */
  22. #ifndef __SOUND_ASOUND_H
  23. #define __SOUND_ASOUND_H
  24. #if defined(LINUX) || defined(__LINUX__) || defined(__linux__)
  25. #include <linux/ioctl.h>
  26. #ifdef __KERNEL__
  27. #include <linux/types.h>
  28. #include <linux/time.h>
  29. #include <asm/byteorder.h>
  30. #ifdef __LITTLE_ENDIAN
  31. #define SNDRV_LITTLE_ENDIAN
  32. #else
  33. #ifdef __BIG_ENDIAN
  34. #define SNDRV_BIG_ENDIAN
  35. #else
  36. #error "Unsupported endian..."
  37. #endif
  38. #endif
  39. #else /* !__KERNEL__ */
  40. #include <endian.h>
  41. #if __BYTE_ORDER == __LITTLE_ENDIAN
  42. #define SNDRV_LITTLE_ENDIAN
  43. #elif __BYTE_ORDER == __BIG_ENDIAN
  44. #define SNDRV_BIG_ENDIAN
  45. #else
  46. #error "Unsupported endian..."
  47. #endif
  48. #endif /* __KERNEL **/
  49. #endif /* LINUX */
  50. #ifndef __KERNEL__
  51. #include <sys/time.h>
  52. #include <sys/types.h>
  53. #endif
  54. /*
  55. * protocol version
  56. */
  57. #define SNDRV_PROTOCOL_VERSION(major, minor, subminor) (((major)<<16)|((minor)<<8)|(subminor))
  58. #define SNDRV_PROTOCOL_MAJOR(version) (((version)>>16)&0xffff)
  59. #define SNDRV_PROTOCOL_MINOR(version) (((version)>>8)&0xff)
  60. #define SNDRV_PROTOCOL_MICRO(version) ((version)&0xff)
  61. #define SNDRV_PROTOCOL_INCOMPATIBLE(kversion, uversion) \
  62. (SNDRV_PROTOCOL_MAJOR(kversion) != SNDRV_PROTOCOL_MAJOR(uversion) || \
  63. (SNDRV_PROTOCOL_MAJOR(kversion) == SNDRV_PROTOCOL_MAJOR(uversion) && \
  64. SNDRV_PROTOCOL_MINOR(kversion) != SNDRV_PROTOCOL_MINOR(uversion)))
  65. /****************************************************************************
  66. * *
  67. * Digital audio interface *
  68. * *
  69. ****************************************************************************/
  70. struct sndrv_aes_iec958 {
  71. unsigned char status[24]; /* AES/IEC958 channel status bits */
  72. unsigned char subcode[147]; /* AES/IEC958 subcode bits */
  73. unsigned char pad; /* nothing */
  74. unsigned char dig_subframe[4]; /* AES/IEC958 subframe bits */
  75. };
  76. /****************************************************************************
  77. * *
  78. * Section for driver hardware dependent interface - /dev/snd/hw? *
  79. * *
  80. ****************************************************************************/
  81. #define SNDRV_HWDEP_VERSION SNDRV_PROTOCOL_VERSION(1, 0, 1)
  82. enum sndrv_hwdep_iface {
  83. SNDRV_HWDEP_IFACE_OPL2 = 0,
  84. SNDRV_HWDEP_IFACE_OPL3,
  85. SNDRV_HWDEP_IFACE_OPL4,
  86. SNDRV_HWDEP_IFACE_SB16CSP, /* Creative Signal Processor */
  87. SNDRV_HWDEP_IFACE_EMU10K1, /* FX8010 processor in EMU10K1 chip */
  88. SNDRV_HWDEP_IFACE_YSS225, /* Yamaha FX processor */
  89. SNDRV_HWDEP_IFACE_ICS2115, /* Wavetable synth */
  90. SNDRV_HWDEP_IFACE_SSCAPE, /* Ensoniq SoundScape ISA card (MC68EC000) */
  91. SNDRV_HWDEP_IFACE_VX, /* Digigram VX cards */
  92. SNDRV_HWDEP_IFACE_MIXART, /* Digigram miXart cards */
  93. SNDRV_HWDEP_IFACE_USX2Y, /* Tascam US122, US224 & US428 usb */
  94. SNDRV_HWDEP_IFACE_EMUX_WAVETABLE, /* EmuX wavetable */
  95. SNDRV_HWDEP_IFACE_BLUETOOTH, /* Bluetooth audio */
  96. SNDRV_HWDEP_IFACE_USX2Y_PCM, /* Tascam US122, US224 & US428 rawusb pcm */
  97. SNDRV_HWDEP_IFACE_PCXHR, /* Digigram PCXHR */
  98. SNDRV_HWDEP_IFACE_SB_RC, /* SB Extigy/Audigy2NX remote control */
  99. /* Don't forget to change the following: */
  100. SNDRV_HWDEP_IFACE_LAST = SNDRV_HWDEP_IFACE_SB_RC
  101. };
  102. struct sndrv_hwdep_info {
  103. unsigned int device; /* WR: device number */
  104. int card; /* R: card number */
  105. unsigned char id[64]; /* ID (user selectable) */
  106. unsigned char name[80]; /* hwdep name */
  107. enum sndrv_hwdep_iface iface; /* hwdep interface */
  108. unsigned char reserved[64]; /* reserved for future */
  109. };
  110. /* generic DSP loader */
  111. struct sndrv_hwdep_dsp_status {
  112. unsigned int version; /* R: driver-specific version */
  113. unsigned char id[32]; /* R: driver-specific ID string */
  114. unsigned int num_dsps; /* R: number of DSP images to transfer */
  115. unsigned int dsp_loaded; /* R: bit flags indicating the loaded DSPs */
  116. unsigned int chip_ready; /* R: 1 = initialization finished */
  117. unsigned char reserved[16]; /* reserved for future use */
  118. };
  119. struct sndrv_hwdep_dsp_image {
  120. unsigned int index; /* W: DSP index */
  121. unsigned char name[64]; /* W: ID (e.g. file name) */
  122. unsigned char __user *image; /* W: binary image */
  123. size_t length; /* W: size of image in bytes */
  124. unsigned long driver_data; /* W: driver-specific data */
  125. };
  126. enum {
  127. SNDRV_HWDEP_IOCTL_PVERSION = _IOR ('H', 0x00, int),
  128. SNDRV_HWDEP_IOCTL_INFO = _IOR ('H', 0x01, struct sndrv_hwdep_info),
  129. SNDRV_HWDEP_IOCTL_DSP_STATUS = _IOR('H', 0x02, struct sndrv_hwdep_dsp_status),
  130. SNDRV_HWDEP_IOCTL_DSP_LOAD = _IOW('H', 0x03, struct sndrv_hwdep_dsp_image)
  131. };
  132. /*****************************************************************************
  133. * *
  134. * Digital Audio (PCM) interface - /dev/snd/pcm?? *
  135. * *
  136. *****************************************************************************/
  137. #define SNDRV_PCM_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 7)
  138. typedef unsigned long sndrv_pcm_uframes_t;
  139. typedef long sndrv_pcm_sframes_t;
  140. enum sndrv_pcm_class {
  141. SNDRV_PCM_CLASS_GENERIC = 0, /* standard mono or stereo device */
  142. SNDRV_PCM_CLASS_MULTI, /* multichannel device */
  143. SNDRV_PCM_CLASS_MODEM, /* software modem class */
  144. SNDRV_PCM_CLASS_DIGITIZER, /* digitizer class */
  145. /* Don't forget to change the following: */
  146. SNDRV_PCM_CLASS_LAST = SNDRV_PCM_CLASS_DIGITIZER,
  147. };
  148. enum sndrv_pcm_subclass {
  149. SNDRV_PCM_SUBCLASS_GENERIC_MIX = 0, /* mono or stereo subdevices are mixed together */
  150. SNDRV_PCM_SUBCLASS_MULTI_MIX, /* multichannel subdevices are mixed together */
  151. /* Don't forget to change the following: */
  152. SNDRV_PCM_SUBCLASS_LAST = SNDRV_PCM_SUBCLASS_MULTI_MIX,
  153. };
  154. enum sndrv_pcm_stream {
  155. SNDRV_PCM_STREAM_PLAYBACK = 0,
  156. SNDRV_PCM_STREAM_CAPTURE,
  157. SNDRV_PCM_STREAM_LAST = SNDRV_PCM_STREAM_CAPTURE,
  158. };
  159. enum sndrv_pcm_access {
  160. SNDRV_PCM_ACCESS_MMAP_INTERLEAVED = 0, /* interleaved mmap */
  161. SNDRV_PCM_ACCESS_MMAP_NONINTERLEAVED, /* noninterleaved mmap */
  162. SNDRV_PCM_ACCESS_MMAP_COMPLEX, /* complex mmap */
  163. SNDRV_PCM_ACCESS_RW_INTERLEAVED, /* readi/writei */
  164. SNDRV_PCM_ACCESS_RW_NONINTERLEAVED, /* readn/writen */
  165. SNDRV_PCM_ACCESS_LAST = SNDRV_PCM_ACCESS_RW_NONINTERLEAVED,
  166. };
  167. enum sndrv_pcm_format {
  168. SNDRV_PCM_FORMAT_S8 = 0,
  169. SNDRV_PCM_FORMAT_U8,
  170. SNDRV_PCM_FORMAT_S16_LE,
  171. SNDRV_PCM_FORMAT_S16_BE,
  172. SNDRV_PCM_FORMAT_U16_LE,
  173. SNDRV_PCM_FORMAT_U16_BE,
  174. SNDRV_PCM_FORMAT_S24_LE, /* low three bytes */
  175. SNDRV_PCM_FORMAT_S24_BE, /* low three bytes */
  176. SNDRV_PCM_FORMAT_U24_LE, /* low three bytes */
  177. SNDRV_PCM_FORMAT_U24_BE, /* low three bytes */
  178. SNDRV_PCM_FORMAT_S32_LE,
  179. SNDRV_PCM_FORMAT_S32_BE,
  180. SNDRV_PCM_FORMAT_U32_LE,
  181. SNDRV_PCM_FORMAT_U32_BE,
  182. SNDRV_PCM_FORMAT_FLOAT_LE, /* 4-byte float, IEEE-754 32-bit, range -1.0 to 1.0 */
  183. SNDRV_PCM_FORMAT_FLOAT_BE, /* 4-byte float, IEEE-754 32-bit, range -1.0 to 1.0 */
  184. SNDRV_PCM_FORMAT_FLOAT64_LE, /* 8-byte float, IEEE-754 64-bit, range -1.0 to 1.0 */
  185. SNDRV_PCM_FORMAT_FLOAT64_BE, /* 8-byte float, IEEE-754 64-bit, range -1.0 to 1.0 */
  186. SNDRV_PCM_FORMAT_IEC958_SUBFRAME_LE, /* IEC-958 subframe, Little Endian */
  187. SNDRV_PCM_FORMAT_IEC958_SUBFRAME_BE, /* IEC-958 subframe, Big Endian */
  188. SNDRV_PCM_FORMAT_MU_LAW,
  189. SNDRV_PCM_FORMAT_A_LAW,
  190. SNDRV_PCM_FORMAT_IMA_ADPCM,
  191. SNDRV_PCM_FORMAT_MPEG,
  192. SNDRV_PCM_FORMAT_GSM,
  193. SNDRV_PCM_FORMAT_SPECIAL = 31,
  194. SNDRV_PCM_FORMAT_S24_3LE = 32, /* in three bytes */
  195. SNDRV_PCM_FORMAT_S24_3BE, /* in three bytes */
  196. SNDRV_PCM_FORMAT_U24_3LE, /* in three bytes */
  197. SNDRV_PCM_FORMAT_U24_3BE, /* in three bytes */
  198. SNDRV_PCM_FORMAT_S20_3LE, /* in three bytes */
  199. SNDRV_PCM_FORMAT_S20_3BE, /* in three bytes */
  200. SNDRV_PCM_FORMAT_U20_3LE, /* in three bytes */
  201. SNDRV_PCM_FORMAT_U20_3BE, /* in three bytes */
  202. SNDRV_PCM_FORMAT_S18_3LE, /* in three bytes */
  203. SNDRV_PCM_FORMAT_S18_3BE, /* in three bytes */
  204. SNDRV_PCM_FORMAT_U18_3LE, /* in three bytes */
  205. SNDRV_PCM_FORMAT_U18_3BE, /* in three bytes */
  206. SNDRV_PCM_FORMAT_LAST = SNDRV_PCM_FORMAT_U18_3BE,
  207. #ifdef SNDRV_LITTLE_ENDIAN
  208. SNDRV_PCM_FORMAT_S16 = SNDRV_PCM_FORMAT_S16_LE,
  209. SNDRV_PCM_FORMAT_U16 = SNDRV_PCM_FORMAT_U16_LE,
  210. SNDRV_PCM_FORMAT_S24 = SNDRV_PCM_FORMAT_S24_LE,
  211. SNDRV_PCM_FORMAT_U24 = SNDRV_PCM_FORMAT_U24_LE,
  212. SNDRV_PCM_FORMAT_S32 = SNDRV_PCM_FORMAT_S32_LE,
  213. SNDRV_PCM_FORMAT_U32 = SNDRV_PCM_FORMAT_U32_LE,
  214. SNDRV_PCM_FORMAT_FLOAT = SNDRV_PCM_FORMAT_FLOAT_LE,
  215. SNDRV_PCM_FORMAT_FLOAT64 = SNDRV_PCM_FORMAT_FLOAT64_LE,
  216. SNDRV_PCM_FORMAT_IEC958_SUBFRAME = SNDRV_PCM_FORMAT_IEC958_SUBFRAME_LE,
  217. #endif
  218. #ifdef SNDRV_BIG_ENDIAN
  219. SNDRV_PCM_FORMAT_S16 = SNDRV_PCM_FORMAT_S16_BE,
  220. SNDRV_PCM_FORMAT_U16 = SNDRV_PCM_FORMAT_U16_BE,
  221. SNDRV_PCM_FORMAT_S24 = SNDRV_PCM_FORMAT_S24_BE,
  222. SNDRV_PCM_FORMAT_U24 = SNDRV_PCM_FORMAT_U24_BE,
  223. SNDRV_PCM_FORMAT_S32 = SNDRV_PCM_FORMAT_S32_BE,
  224. SNDRV_PCM_FORMAT_U32 = SNDRV_PCM_FORMAT_U32_BE,
  225. SNDRV_PCM_FORMAT_FLOAT = SNDRV_PCM_FORMAT_FLOAT_BE,
  226. SNDRV_PCM_FORMAT_FLOAT64 = SNDRV_PCM_FORMAT_FLOAT64_BE,
  227. SNDRV_PCM_FORMAT_IEC958_SUBFRAME = SNDRV_PCM_FORMAT_IEC958_SUBFRAME_BE,
  228. #endif
  229. };
  230. enum sndrv_pcm_subformat {
  231. SNDRV_PCM_SUBFORMAT_STD = 0,
  232. SNDRV_PCM_SUBFORMAT_LAST = SNDRV_PCM_SUBFORMAT_STD,
  233. };
  234. #define SNDRV_PCM_INFO_MMAP 0x00000001 /* hardware supports mmap */
  235. #define SNDRV_PCM_INFO_MMAP_VALID 0x00000002 /* period data are valid during transfer */
  236. #define SNDRV_PCM_INFO_DOUBLE 0x00000004 /* Double buffering needed for PCM start/stop */
  237. #define SNDRV_PCM_INFO_BATCH 0x00000010 /* double buffering */
  238. #define SNDRV_PCM_INFO_INTERLEAVED 0x00000100 /* channels are interleaved */
  239. #define SNDRV_PCM_INFO_NONINTERLEAVED 0x00000200 /* channels are not interleaved */
  240. #define SNDRV_PCM_INFO_COMPLEX 0x00000400 /* complex frame organization (mmap only) */
  241. #define SNDRV_PCM_INFO_BLOCK_TRANSFER 0x00010000 /* hardware transfer block of samples */
  242. #define SNDRV_PCM_INFO_OVERRANGE 0x00020000 /* hardware supports ADC (capture) overrange detection */
  243. #define SNDRV_PCM_INFO_RESUME 0x00040000 /* hardware supports stream resume after suspend */
  244. #define SNDRV_PCM_INFO_PAUSE 0x00080000 /* pause ioctl is supported */
  245. #define SNDRV_PCM_INFO_HALF_DUPLEX 0x00100000 /* only half duplex */
  246. #define SNDRV_PCM_INFO_JOINT_DUPLEX 0x00200000 /* playback and capture stream are somewhat correlated */
  247. #define SNDRV_PCM_INFO_SYNC_START 0x00400000 /* pcm support some kind of sync go */
  248. enum sndrv_pcm_state {
  249. SNDRV_PCM_STATE_OPEN = 0, /* stream is open */
  250. SNDRV_PCM_STATE_SETUP, /* stream has a setup */
  251. SNDRV_PCM_STATE_PREPARED, /* stream is ready to start */
  252. SNDRV_PCM_STATE_RUNNING, /* stream is running */
  253. SNDRV_PCM_STATE_XRUN, /* stream reached an xrun */
  254. SNDRV_PCM_STATE_DRAINING, /* stream is draining */
  255. SNDRV_PCM_STATE_PAUSED, /* stream is paused */
  256. SNDRV_PCM_STATE_SUSPENDED, /* hardware is suspended */
  257. SNDRV_PCM_STATE_DISCONNECTED, /* hardware is disconnected */
  258. SNDRV_PCM_STATE_LAST = SNDRV_PCM_STATE_DISCONNECTED,
  259. };
  260. enum {
  261. SNDRV_PCM_MMAP_OFFSET_DATA = 0x00000000,
  262. SNDRV_PCM_MMAP_OFFSET_STATUS = 0x80000000,
  263. SNDRV_PCM_MMAP_OFFSET_CONTROL = 0x81000000,
  264. };
  265. union sndrv_pcm_sync_id {
  266. unsigned char id[16];
  267. unsigned short id16[8];
  268. unsigned int id32[4];
  269. };
  270. struct sndrv_pcm_info {
  271. unsigned int device; /* RO/WR (control): device number */
  272. unsigned int subdevice; /* RO/WR (control): subdevice number */
  273. enum sndrv_pcm_stream stream; /* RO/WR (control): stream number */
  274. int card; /* R: card number */
  275. unsigned char id[64]; /* ID (user selectable) */
  276. unsigned char name[80]; /* name of this device */
  277. unsigned char subname[32]; /* subdevice name */
  278. enum sndrv_pcm_class dev_class; /* SNDRV_PCM_CLASS_* */
  279. enum sndrv_pcm_subclass dev_subclass; /* SNDRV_PCM_SUBCLASS_* */
  280. unsigned int subdevices_count;
  281. unsigned int subdevices_avail;
  282. union sndrv_pcm_sync_id sync; /* hardware synchronization ID */
  283. unsigned char reserved[64]; /* reserved for future... */
  284. };
  285. enum sndrv_pcm_hw_param {
  286. SNDRV_PCM_HW_PARAM_ACCESS = 0, /* Access type */
  287. SNDRV_PCM_HW_PARAM_FIRST_MASK = SNDRV_PCM_HW_PARAM_ACCESS,
  288. SNDRV_PCM_HW_PARAM_FORMAT, /* Format */
  289. SNDRV_PCM_HW_PARAM_SUBFORMAT, /* Subformat */
  290. SNDRV_PCM_HW_PARAM_LAST_MASK = SNDRV_PCM_HW_PARAM_SUBFORMAT,
  291. SNDRV_PCM_HW_PARAM_SAMPLE_BITS = 8, /* Bits per sample */
  292. SNDRV_PCM_HW_PARAM_FIRST_INTERVAL = SNDRV_PCM_HW_PARAM_SAMPLE_BITS,
  293. SNDRV_PCM_HW_PARAM_FRAME_BITS, /* Bits per frame */
  294. SNDRV_PCM_HW_PARAM_CHANNELS, /* Channels */
  295. SNDRV_PCM_HW_PARAM_RATE, /* Approx rate */
  296. SNDRV_PCM_HW_PARAM_PERIOD_TIME, /* Approx distance between interrupts
  297. in us */
  298. SNDRV_PCM_HW_PARAM_PERIOD_SIZE, /* Approx frames between interrupts */
  299. SNDRV_PCM_HW_PARAM_PERIOD_BYTES, /* Approx bytes between interrupts */
  300. SNDRV_PCM_HW_PARAM_PERIODS, /* Approx interrupts per buffer */
  301. SNDRV_PCM_HW_PARAM_BUFFER_TIME, /* Approx duration of buffer in us */
  302. SNDRV_PCM_HW_PARAM_BUFFER_SIZE, /* Size of buffer in frames */
  303. SNDRV_PCM_HW_PARAM_BUFFER_BYTES, /* Size of buffer in bytes */
  304. SNDRV_PCM_HW_PARAM_TICK_TIME, /* Approx tick duration in us */
  305. SNDRV_PCM_HW_PARAM_LAST_INTERVAL = SNDRV_PCM_HW_PARAM_TICK_TIME
  306. };
  307. #define SNDRV_PCM_HW_PARAMS_NORESAMPLE (1<<0) /* avoid rate resampling */
  308. struct sndrv_interval {
  309. unsigned int min, max;
  310. unsigned int openmin:1,
  311. openmax:1,
  312. integer:1,
  313. empty:1;
  314. };
  315. #define SNDRV_MASK_MAX 256
  316. struct sndrv_mask {
  317. u_int32_t bits[(SNDRV_MASK_MAX+31)/32];
  318. };
  319. struct sndrv_pcm_hw_params {
  320. unsigned int flags;
  321. struct sndrv_mask masks[SNDRV_PCM_HW_PARAM_LAST_MASK -
  322. SNDRV_PCM_HW_PARAM_FIRST_MASK + 1];
  323. struct sndrv_mask mres[5]; /* reserved masks */
  324. struct sndrv_interval intervals[SNDRV_PCM_HW_PARAM_LAST_INTERVAL -
  325. SNDRV_PCM_HW_PARAM_FIRST_INTERVAL + 1];
  326. struct sndrv_interval ires[9]; /* reserved intervals */
  327. unsigned int rmask; /* W: requested masks */
  328. unsigned int cmask; /* R: changed masks */
  329. unsigned int info; /* R: Info flags for returned setup */
  330. unsigned int msbits; /* R: used most significant bits */
  331. unsigned int rate_num; /* R: rate numerator */
  332. unsigned int rate_den; /* R: rate denominator */
  333. sndrv_pcm_uframes_t fifo_size; /* R: chip FIFO size in frames */
  334. unsigned char reserved[64]; /* reserved for future */
  335. };
  336. enum sndrv_pcm_tstamp {
  337. SNDRV_PCM_TSTAMP_NONE = 0,
  338. SNDRV_PCM_TSTAMP_MMAP,
  339. SNDRV_PCM_TSTAMP_LAST = SNDRV_PCM_TSTAMP_MMAP,
  340. };
  341. struct sndrv_pcm_sw_params {
  342. enum sndrv_pcm_tstamp tstamp_mode; /* timestamp mode */
  343. unsigned int period_step;
  344. unsigned int sleep_min; /* min ticks to sleep */
  345. sndrv_pcm_uframes_t avail_min; /* min avail frames for wakeup */
  346. sndrv_pcm_uframes_t xfer_align; /* xfer size need to be a multiple */
  347. sndrv_pcm_uframes_t start_threshold; /* min hw_avail frames for automatic start */
  348. sndrv_pcm_uframes_t stop_threshold; /* min avail frames for automatic stop */
  349. sndrv_pcm_uframes_t silence_threshold; /* min distance from noise for silence filling */
  350. sndrv_pcm_uframes_t silence_size; /* silence block size */
  351. sndrv_pcm_uframes_t boundary; /* pointers wrap point */
  352. unsigned char reserved[64]; /* reserved for future */
  353. };
  354. struct sndrv_pcm_channel_info {
  355. unsigned int channel;
  356. off_t offset; /* mmap offset */
  357. unsigned int first; /* offset to first sample in bits */
  358. unsigned int step; /* samples distance in bits */
  359. };
  360. struct sndrv_pcm_status {
  361. enum sndrv_pcm_state state; /* stream state */
  362. struct timespec trigger_tstamp; /* time when stream was started/stopped/paused */
  363. struct timespec tstamp; /* reference timestamp */
  364. sndrv_pcm_uframes_t appl_ptr; /* appl ptr */
  365. sndrv_pcm_uframes_t hw_ptr; /* hw ptr */
  366. sndrv_pcm_sframes_t delay; /* current delay in frames */
  367. sndrv_pcm_uframes_t avail; /* number of frames available */
  368. sndrv_pcm_uframes_t avail_max; /* max frames available on hw since last status */
  369. sndrv_pcm_uframes_t overrange; /* count of ADC (capture) overrange detections from last status */
  370. enum sndrv_pcm_state suspended_state; /* suspended stream state */
  371. unsigned char reserved[60]; /* must be filled with zero */
  372. };
  373. struct sndrv_pcm_mmap_status {
  374. enum sndrv_pcm_state state; /* RO: state - SNDRV_PCM_STATE_XXXX */
  375. int pad1; /* Needed for 64 bit alignment */
  376. sndrv_pcm_uframes_t hw_ptr; /* RO: hw ptr (0...boundary-1) */
  377. struct timespec tstamp; /* Timestamp */
  378. enum sndrv_pcm_state suspended_state; /* RO: suspended stream state */
  379. };
  380. struct sndrv_pcm_mmap_control {
  381. sndrv_pcm_uframes_t appl_ptr; /* RW: appl ptr (0...boundary-1) */
  382. sndrv_pcm_uframes_t avail_min; /* RW: min available frames for wakeup */
  383. };
  384. #define SNDRV_PCM_SYNC_PTR_HWSYNC (1<<0) /* execute hwsync */
  385. #define SNDRV_PCM_SYNC_PTR_APPL (1<<1) /* get appl_ptr from driver (r/w op) */
  386. #define SNDRV_PCM_SYNC_PTR_AVAIL_MIN (1<<2) /* get avail_min from driver */
  387. struct sndrv_pcm_sync_ptr {
  388. unsigned int flags;
  389. union {
  390. struct sndrv_pcm_mmap_status status;
  391. unsigned char reserved[64];
  392. } s;
  393. union {
  394. struct sndrv_pcm_mmap_control control;
  395. unsigned char reserved[64];
  396. } c;
  397. };
  398. struct sndrv_xferi {
  399. sndrv_pcm_sframes_t result;
  400. void __user *buf;
  401. sndrv_pcm_uframes_t frames;
  402. };
  403. struct sndrv_xfern {
  404. sndrv_pcm_sframes_t result;
  405. void __user * __user *bufs;
  406. sndrv_pcm_uframes_t frames;
  407. };
  408. enum {
  409. SNDRV_PCM_IOCTL_PVERSION = _IOR('A', 0x00, int),
  410. SNDRV_PCM_IOCTL_INFO = _IOR('A', 0x01, struct sndrv_pcm_info),
  411. SNDRV_PCM_IOCTL_TSTAMP = _IOW('A', 0x02, int),
  412. SNDRV_PCM_IOCTL_HW_REFINE = _IOWR('A', 0x10, struct sndrv_pcm_hw_params),
  413. SNDRV_PCM_IOCTL_HW_PARAMS = _IOWR('A', 0x11, struct sndrv_pcm_hw_params),
  414. SNDRV_PCM_IOCTL_HW_FREE = _IO('A', 0x12),
  415. SNDRV_PCM_IOCTL_SW_PARAMS = _IOWR('A', 0x13, struct sndrv_pcm_sw_params),
  416. SNDRV_PCM_IOCTL_STATUS = _IOR('A', 0x20, struct sndrv_pcm_status),
  417. SNDRV_PCM_IOCTL_DELAY = _IOR('A', 0x21, sndrv_pcm_sframes_t),
  418. SNDRV_PCM_IOCTL_HWSYNC = _IO('A', 0x22),
  419. SNDRV_PCM_IOCTL_SYNC_PTR = _IOWR('A', 0x23, struct sndrv_pcm_sync_ptr),
  420. SNDRV_PCM_IOCTL_CHANNEL_INFO = _IOR('A', 0x32, struct sndrv_pcm_channel_info),
  421. SNDRV_PCM_IOCTL_PREPARE = _IO('A', 0x40),
  422. SNDRV_PCM_IOCTL_RESET = _IO('A', 0x41),
  423. SNDRV_PCM_IOCTL_START = _IO('A', 0x42),
  424. SNDRV_PCM_IOCTL_DROP = _IO('A', 0x43),
  425. SNDRV_PCM_IOCTL_DRAIN = _IO('A', 0x44),
  426. SNDRV_PCM_IOCTL_PAUSE = _IOW('A', 0x45, int),
  427. SNDRV_PCM_IOCTL_REWIND = _IOW('A', 0x46, sndrv_pcm_uframes_t),
  428. SNDRV_PCM_IOCTL_RESUME = _IO('A', 0x47),
  429. SNDRV_PCM_IOCTL_XRUN = _IO('A', 0x48),
  430. SNDRV_PCM_IOCTL_FORWARD = _IOW('A', 0x49, sndrv_pcm_uframes_t),
  431. SNDRV_PCM_IOCTL_WRITEI_FRAMES = _IOW('A', 0x50, struct sndrv_xferi),
  432. SNDRV_PCM_IOCTL_READI_FRAMES = _IOR('A', 0x51, struct sndrv_xferi),
  433. SNDRV_PCM_IOCTL_WRITEN_FRAMES = _IOW('A', 0x52, struct sndrv_xfern),
  434. SNDRV_PCM_IOCTL_READN_FRAMES = _IOR('A', 0x53, struct sndrv_xfern),
  435. SNDRV_PCM_IOCTL_LINK = _IOW('A', 0x60, int),
  436. SNDRV_PCM_IOCTL_UNLINK = _IO('A', 0x61),
  437. };
  438. /* Trick to make alsa-lib/acinclude.m4 happy */
  439. #define SNDRV_PCM_IOCTL_REWIND SNDRV_PCM_IOCTL_REWIND
  440. /*****************************************************************************
  441. * *
  442. * MIDI v1.0 interface *
  443. * *
  444. *****************************************************************************/
  445. /*
  446. * Raw MIDI section - /dev/snd/midi??
  447. */
  448. #define SNDRV_RAWMIDI_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 0)
  449. enum sndrv_rawmidi_stream {
  450. SNDRV_RAWMIDI_STREAM_OUTPUT = 0,
  451. SNDRV_RAWMIDI_STREAM_INPUT,
  452. SNDRV_RAWMIDI_STREAM_LAST = SNDRV_RAWMIDI_STREAM_INPUT,
  453. };
  454. #define SNDRV_RAWMIDI_INFO_OUTPUT 0x00000001
  455. #define SNDRV_RAWMIDI_INFO_INPUT 0x00000002
  456. #define SNDRV_RAWMIDI_INFO_DUPLEX 0x00000004
  457. struct sndrv_rawmidi_info {
  458. unsigned int device; /* RO/WR (control): device number */
  459. unsigned int subdevice; /* RO/WR (control): subdevice number */
  460. enum sndrv_rawmidi_stream stream; /* WR: stream */
  461. int card; /* R: card number */
  462. unsigned int flags; /* SNDRV_RAWMIDI_INFO_XXXX */
  463. unsigned char id[64]; /* ID (user selectable) */
  464. unsigned char name[80]; /* name of device */
  465. unsigned char subname[32]; /* name of active or selected subdevice */
  466. unsigned int subdevices_count;
  467. unsigned int subdevices_avail;
  468. unsigned char reserved[64]; /* reserved for future use */
  469. };
  470. struct sndrv_rawmidi_params {
  471. enum sndrv_rawmidi_stream stream;
  472. size_t buffer_size; /* queue size in bytes */
  473. size_t avail_min; /* minimum avail bytes for wakeup */
  474. unsigned int no_active_sensing: 1; /* do not send active sensing byte in close() */
  475. unsigned char reserved[16]; /* reserved for future use */
  476. };
  477. struct sndrv_rawmidi_status {
  478. enum sndrv_rawmidi_stream stream;
  479. struct timespec tstamp; /* Timestamp */
  480. size_t avail; /* available bytes */
  481. size_t xruns; /* count of overruns since last status (in bytes) */
  482. unsigned char reserved[16]; /* reserved for future use */
  483. };
  484. enum {
  485. SNDRV_RAWMIDI_IOCTL_PVERSION = _IOR('W', 0x00, int),
  486. SNDRV_RAWMIDI_IOCTL_INFO = _IOR('W', 0x01, struct sndrv_rawmidi_info),
  487. SNDRV_RAWMIDI_IOCTL_PARAMS = _IOWR('W', 0x10, struct sndrv_rawmidi_params),
  488. SNDRV_RAWMIDI_IOCTL_STATUS = _IOWR('W', 0x20, struct sndrv_rawmidi_status),
  489. SNDRV_RAWMIDI_IOCTL_DROP = _IOW('W', 0x30, int),
  490. SNDRV_RAWMIDI_IOCTL_DRAIN = _IOW('W', 0x31, int),
  491. };
  492. /*
  493. * Timer section - /dev/snd/timer
  494. */
  495. #define SNDRV_TIMER_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 5)
  496. enum sndrv_timer_class {
  497. SNDRV_TIMER_CLASS_NONE = -1,
  498. SNDRV_TIMER_CLASS_SLAVE = 0,
  499. SNDRV_TIMER_CLASS_GLOBAL,
  500. SNDRV_TIMER_CLASS_CARD,
  501. SNDRV_TIMER_CLASS_PCM,
  502. SNDRV_TIMER_CLASS_LAST = SNDRV_TIMER_CLASS_PCM,
  503. };
  504. /* slave timer classes */
  505. enum sndrv_timer_slave_class {
  506. SNDRV_TIMER_SCLASS_NONE = 0,
  507. SNDRV_TIMER_SCLASS_APPLICATION,
  508. SNDRV_TIMER_SCLASS_SEQUENCER, /* alias */
  509. SNDRV_TIMER_SCLASS_OSS_SEQUENCER, /* alias */
  510. SNDRV_TIMER_SCLASS_LAST = SNDRV_TIMER_SCLASS_OSS_SEQUENCER,
  511. };
  512. /* global timers (device member) */
  513. #define SNDRV_TIMER_GLOBAL_SYSTEM 0
  514. #define SNDRV_TIMER_GLOBAL_RTC 1
  515. #define SNDRV_TIMER_GLOBAL_HPET 2
  516. /* info flags */
  517. #define SNDRV_TIMER_FLG_SLAVE (1<<0) /* cannot be controlled */
  518. struct sndrv_timer_id {
  519. enum sndrv_timer_class dev_class;
  520. enum sndrv_timer_slave_class dev_sclass;
  521. int card;
  522. int device;
  523. int subdevice;
  524. };
  525. struct sndrv_timer_ginfo {
  526. struct sndrv_timer_id tid; /* requested timer ID */
  527. unsigned int flags; /* timer flags - SNDRV_TIMER_FLG_* */
  528. int card; /* card number */
  529. unsigned char id[64]; /* timer identification */
  530. unsigned char name[80]; /* timer name */
  531. unsigned long reserved0; /* reserved for future use */
  532. unsigned long resolution; /* average period resolution in ns */
  533. unsigned long resolution_min; /* minimal period resolution in ns */
  534. unsigned long resolution_max; /* maximal period resolution in ns */
  535. unsigned int clients; /* active timer clients */
  536. unsigned char reserved[32];
  537. };
  538. struct sndrv_timer_gparams {
  539. struct sndrv_timer_id tid; /* requested timer ID */
  540. unsigned long period_num; /* requested precise period duration (in seconds) - numerator */
  541. unsigned long period_den; /* requested precise period duration (in seconds) - denominator */
  542. unsigned char reserved[32];
  543. };
  544. struct sndrv_timer_gstatus {
  545. struct sndrv_timer_id tid; /* requested timer ID */
  546. unsigned long resolution; /* current period resolution in ns */
  547. unsigned long resolution_num; /* precise current period resolution (in seconds) - numerator */
  548. unsigned long resolution_den; /* precise current period resolution (in seconds) - denominator */
  549. unsigned char reserved[32];
  550. };
  551. struct sndrv_timer_select {
  552. struct sndrv_timer_id id; /* bind to timer ID */
  553. unsigned char reserved[32]; /* reserved */
  554. };
  555. struct sndrv_timer_info {
  556. unsigned int flags; /* timer flags - SNDRV_TIMER_FLG_* */
  557. int card; /* card number */
  558. unsigned char id[64]; /* timer identificator */
  559. unsigned char name[80]; /* timer name */
  560. unsigned long reserved0; /* reserved for future use */
  561. unsigned long resolution; /* average period resolution in ns */
  562. unsigned char reserved[64]; /* reserved */
  563. };
  564. #define SNDRV_TIMER_PSFLG_AUTO (1<<0) /* auto start, otherwise one-shot */
  565. #define SNDRV_TIMER_PSFLG_EXCLUSIVE (1<<1) /* exclusive use, precise start/stop/pause/continue */
  566. #define SNDRV_TIMER_PSFLG_EARLY_EVENT (1<<2) /* write early event to the poll queue */
  567. struct sndrv_timer_params {
  568. unsigned int flags; /* flags - SNDRV_MIXER_PSFLG_* */
  569. unsigned int ticks; /* requested resolution in ticks */
  570. unsigned int queue_size; /* total size of queue (32-1024) */
  571. unsigned int reserved0; /* reserved, was: failure locations */
  572. unsigned int filter; /* event filter (bitmask of SNDRV_TIMER_EVENT_*) */
  573. unsigned char reserved[60]; /* reserved */
  574. };
  575. struct sndrv_timer_status {
  576. struct timespec tstamp; /* Timestamp - last update */
  577. unsigned int resolution; /* current period resolution in ns */
  578. unsigned int lost; /* counter of master tick lost */
  579. unsigned int overrun; /* count of read queue overruns */
  580. unsigned int queue; /* used queue size */
  581. unsigned char reserved[64]; /* reserved */
  582. };
  583. enum {
  584. SNDRV_TIMER_IOCTL_PVERSION = _IOR('T', 0x00, int),
  585. SNDRV_TIMER_IOCTL_NEXT_DEVICE = _IOWR('T', 0x01, struct sndrv_timer_id),
  586. SNDRV_TIMER_IOCTL_TREAD = _IOW('T', 0x02, int),
  587. SNDRV_TIMER_IOCTL_GINFO = _IOWR('T', 0x03, struct sndrv_timer_ginfo),
  588. SNDRV_TIMER_IOCTL_GPARAMS = _IOW('T', 0x04, struct sndrv_timer_gparams),
  589. SNDRV_TIMER_IOCTL_GSTATUS = _IOWR('T', 0x05, struct sndrv_timer_gstatus),
  590. SNDRV_TIMER_IOCTL_SELECT = _IOW('T', 0x10, struct sndrv_timer_select),
  591. SNDRV_TIMER_IOCTL_INFO = _IOR('T', 0x11, struct sndrv_timer_info),
  592. SNDRV_TIMER_IOCTL_PARAMS = _IOW('T', 0x12, struct sndrv_timer_params),
  593. SNDRV_TIMER_IOCTL_STATUS = _IOR('T', 0x14, struct sndrv_timer_status),
  594. /* The following four ioctls are changed since 1.0.9 due to confliction */
  595. SNDRV_TIMER_IOCTL_START = _IO('T', 0xa0),
  596. SNDRV_TIMER_IOCTL_STOP = _IO('T', 0xa1),
  597. SNDRV_TIMER_IOCTL_CONTINUE = _IO('T', 0xa2),
  598. SNDRV_TIMER_IOCTL_PAUSE = _IO('T', 0xa3),
  599. };
  600. struct sndrv_timer_read {
  601. unsigned int resolution;
  602. unsigned int ticks;
  603. };
  604. enum sndrv_timer_event {
  605. SNDRV_TIMER_EVENT_RESOLUTION = 0, /* val = resolution in ns */
  606. SNDRV_TIMER_EVENT_TICK, /* val = ticks */
  607. SNDRV_TIMER_EVENT_START, /* val = resolution in ns */
  608. SNDRV_TIMER_EVENT_STOP, /* val = 0 */
  609. SNDRV_TIMER_EVENT_CONTINUE, /* val = resolution in ns */
  610. SNDRV_TIMER_EVENT_PAUSE, /* val = 0 */
  611. SNDRV_TIMER_EVENT_EARLY, /* val = 0, early event */
  612. SNDRV_TIMER_EVENT_SUSPEND, /* val = 0 */
  613. SNDRV_TIMER_EVENT_RESUME, /* val = resolution in ns */
  614. /* master timer events for slave timer instances */
  615. SNDRV_TIMER_EVENT_MSTART = SNDRV_TIMER_EVENT_START + 10,
  616. SNDRV_TIMER_EVENT_MSTOP = SNDRV_TIMER_EVENT_STOP + 10,
  617. SNDRV_TIMER_EVENT_MCONTINUE = SNDRV_TIMER_EVENT_CONTINUE + 10,
  618. SNDRV_TIMER_EVENT_MPAUSE = SNDRV_TIMER_EVENT_PAUSE + 10,
  619. SNDRV_TIMER_EVENT_MSUSPEND = SNDRV_TIMER_EVENT_SUSPEND + 10,
  620. SNDRV_TIMER_EVENT_MRESUME = SNDRV_TIMER_EVENT_RESUME + 10,
  621. };
  622. struct sndrv_timer_tread {
  623. enum sndrv_timer_event event;
  624. struct timespec tstamp;
  625. unsigned int val;
  626. };
  627. /****************************************************************************
  628. * *
  629. * Section for driver control interface - /dev/snd/control? *
  630. * *
  631. ****************************************************************************/
  632. #define SNDRV_CTL_VERSION SNDRV_PROTOCOL_VERSION(2, 0, 3)
  633. struct sndrv_ctl_card_info {
  634. int card; /* card number */
  635. int pad; /* reserved for future (was type) */
  636. unsigned char id[16]; /* ID of card (user selectable) */
  637. unsigned char driver[16]; /* Driver name */
  638. unsigned char name[32]; /* Short name of soundcard */
  639. unsigned char longname[80]; /* name + info text about soundcard */
  640. unsigned char reserved_[16]; /* reserved for future (was ID of mixer) */
  641. unsigned char mixername[80]; /* visual mixer identification */
  642. unsigned char components[80]; /* card components / fine identification, delimited with one space (AC97 etc..) */
  643. unsigned char reserved[48]; /* reserved for future */
  644. };
  645. enum sndrv_ctl_elem_type {
  646. SNDRV_CTL_ELEM_TYPE_NONE = 0, /* invalid */
  647. SNDRV_CTL_ELEM_TYPE_BOOLEAN, /* boolean type */
  648. SNDRV_CTL_ELEM_TYPE_INTEGER, /* integer type */
  649. SNDRV_CTL_ELEM_TYPE_ENUMERATED, /* enumerated type */
  650. SNDRV_CTL_ELEM_TYPE_BYTES, /* byte array */
  651. SNDRV_CTL_ELEM_TYPE_IEC958, /* IEC958 (S/PDIF) setup */
  652. SNDRV_CTL_ELEM_TYPE_INTEGER64, /* 64-bit integer type */
  653. SNDRV_CTL_ELEM_TYPE_LAST = SNDRV_CTL_ELEM_TYPE_INTEGER64,
  654. };
  655. enum sndrv_ctl_elem_iface {
  656. SNDRV_CTL_ELEM_IFACE_CARD = 0, /* global control */
  657. SNDRV_CTL_ELEM_IFACE_HWDEP, /* hardware dependent device */
  658. SNDRV_CTL_ELEM_IFACE_MIXER, /* virtual mixer device */
  659. SNDRV_CTL_ELEM_IFACE_PCM, /* PCM device */
  660. SNDRV_CTL_ELEM_IFACE_RAWMIDI, /* RawMidi device */
  661. SNDRV_CTL_ELEM_IFACE_TIMER, /* timer device */
  662. SNDRV_CTL_ELEM_IFACE_SEQUENCER, /* sequencer client */
  663. SNDRV_CTL_ELEM_IFACE_LAST = SNDRV_CTL_ELEM_IFACE_SEQUENCER,
  664. };
  665. #define SNDRV_CTL_ELEM_ACCESS_READ (1<<0)
  666. #define SNDRV_CTL_ELEM_ACCESS_WRITE (1<<1)
  667. #define SNDRV_CTL_ELEM_ACCESS_READWRITE (SNDRV_CTL_ELEM_ACCESS_READ|SNDRV_CTL_ELEM_ACCESS_WRITE)
  668. #define SNDRV_CTL_ELEM_ACCESS_VOLATILE (1<<2) /* control value may be changed without a notification */
  669. #define SNDRV_CTL_ELEM_ACCESS_TIMESTAMP (1<<2) /* when was control changed */
  670. #define SNDRV_CTL_ELEM_ACCESS_INACTIVE (1<<8) /* control does actually nothing, but may be updated */
  671. #define SNDRV_CTL_ELEM_ACCESS_LOCK (1<<9) /* write lock */
  672. #define SNDRV_CTL_ELEM_ACCESS_OWNER (1<<10) /* write lock owner */
  673. #define SNDRV_CTL_ELEM_ACCESS_USER (1<<29) /* user space element */
  674. #define SNDRV_CTL_ELEM_ACCESS_DINDIRECT (1<<30) /* indirect access for matrix dimensions in the info structure */
  675. #define SNDRV_CTL_ELEM_ACCESS_INDIRECT (1<<31) /* indirect access for element value in the value structure */
  676. /* for further details see the ACPI and PCI power management specification */
  677. #define SNDRV_CTL_POWER_D0 0x0000 /* full On */
  678. #define SNDRV_CTL_POWER_D1 0x0100 /* partial On */
  679. #define SNDRV_CTL_POWER_D2 0x0200 /* partial On */
  680. #define SNDRV_CTL_POWER_D3 0x0300 /* Off */
  681. #define SNDRV_CTL_POWER_D3hot (SNDRV_CTL_POWER_D3|0x0000) /* Off, with power */
  682. #define SNDRV_CTL_POWER_D3cold (SNDRV_CTL_POWER_D3|0x0001) /* Off, without power */
  683. struct sndrv_ctl_elem_id {
  684. unsigned int numid; /* numeric identifier, zero = invalid */
  685. enum sndrv_ctl_elem_iface iface; /* interface identifier */
  686. unsigned int device; /* device/client number */
  687. unsigned int subdevice; /* subdevice (substream) number */
  688. unsigned char name[44]; /* ASCII name of item */
  689. unsigned int index; /* index of item */
  690. };
  691. struct sndrv_ctl_elem_list {
  692. unsigned int offset; /* W: first element ID to get */
  693. unsigned int space; /* W: count of element IDs to get */
  694. unsigned int used; /* R: count of element IDs set */
  695. unsigned int count; /* R: count of all elements */
  696. struct sndrv_ctl_elem_id __user *pids; /* R: IDs */
  697. unsigned char reserved[50];
  698. };
  699. struct sndrv_ctl_elem_info {
  700. struct sndrv_ctl_elem_id id; /* W: element ID */
  701. enum sndrv_ctl_elem_type type; /* R: value type - SNDRV_CTL_ELEM_TYPE_* */
  702. unsigned int access; /* R: value access (bitmask) - SNDRV_CTL_ELEM_ACCESS_* */
  703. unsigned int count; /* count of values */
  704. pid_t owner; /* owner's PID of this control */
  705. union {
  706. struct {
  707. long min; /* R: minimum value */
  708. long max; /* R: maximum value */
  709. long step; /* R: step (0 variable) */
  710. } integer;
  711. struct {
  712. long long min; /* R: minimum value */
  713. long long max; /* R: maximum value */
  714. long long step; /* R: step (0 variable) */
  715. } integer64;
  716. struct {
  717. unsigned int items; /* R: number of items */
  718. unsigned int item; /* W: item number */
  719. char name[64]; /* R: value name */
  720. } enumerated;
  721. unsigned char reserved[128];
  722. } value;
  723. union {
  724. unsigned short d[4]; /* dimensions */
  725. unsigned short *d_ptr; /* indirect */
  726. } dimen;
  727. unsigned char reserved[64-4*sizeof(unsigned short)];
  728. };
  729. struct sndrv_ctl_elem_value {
  730. struct sndrv_ctl_elem_id id; /* W: element ID */
  731. unsigned int indirect: 1; /* W: use indirect pointer (xxx_ptr member) */
  732. union {
  733. union {
  734. long value[128];
  735. long *value_ptr;
  736. } integer;
  737. union {
  738. long long value[64];
  739. long long *value_ptr;
  740. } integer64;
  741. union {
  742. unsigned int item[128];
  743. unsigned int *item_ptr;
  744. } enumerated;
  745. union {
  746. unsigned char data[512];
  747. unsigned char *data_ptr;
  748. } bytes;
  749. struct sndrv_aes_iec958 iec958;
  750. } value; /* RO */
  751. struct timespec tstamp;
  752. unsigned char reserved[128-sizeof(struct timespec)];
  753. };
  754. enum {
  755. SNDRV_CTL_IOCTL_PVERSION = _IOR('U', 0x00, int),
  756. SNDRV_CTL_IOCTL_CARD_INFO = _IOR('U', 0x01, struct sndrv_ctl_card_info),
  757. SNDRV_CTL_IOCTL_ELEM_LIST = _IOWR('U', 0x10, struct sndrv_ctl_elem_list),
  758. SNDRV_CTL_IOCTL_ELEM_INFO = _IOWR('U', 0x11, struct sndrv_ctl_elem_info),
  759. SNDRV_CTL_IOCTL_ELEM_READ = _IOWR('U', 0x12, struct sndrv_ctl_elem_value),
  760. SNDRV_CTL_IOCTL_ELEM_WRITE = _IOWR('U', 0x13, struct sndrv_ctl_elem_value),
  761. SNDRV_CTL_IOCTL_ELEM_LOCK = _IOW('U', 0x14, struct sndrv_ctl_elem_id),
  762. SNDRV_CTL_IOCTL_ELEM_UNLOCK = _IOW('U', 0x15, struct sndrv_ctl_elem_id),
  763. SNDRV_CTL_IOCTL_SUBSCRIBE_EVENTS = _IOWR('U', 0x16, int),
  764. SNDRV_CTL_IOCTL_ELEM_ADD = _IOWR('U', 0x17, struct sndrv_ctl_elem_info),
  765. SNDRV_CTL_IOCTL_ELEM_REPLACE = _IOWR('U', 0x18, struct sndrv_ctl_elem_info),
  766. SNDRV_CTL_IOCTL_ELEM_REMOVE = _IOWR('U', 0x19, struct sndrv_ctl_elem_id),
  767. SNDRV_CTL_IOCTL_HWDEP_NEXT_DEVICE = _IOWR('U', 0x20, int),
  768. SNDRV_CTL_IOCTL_HWDEP_INFO = _IOR('U', 0x21, struct sndrv_hwdep_info),
  769. SNDRV_CTL_IOCTL_PCM_NEXT_DEVICE = _IOR('U', 0x30, int),
  770. SNDRV_CTL_IOCTL_PCM_INFO = _IOWR('U', 0x31, struct sndrv_pcm_info),
  771. SNDRV_CTL_IOCTL_PCM_PREFER_SUBDEVICE = _IOW('U', 0x32, int),
  772. SNDRV_CTL_IOCTL_RAWMIDI_NEXT_DEVICE = _IOWR('U', 0x40, int),
  773. SNDRV_CTL_IOCTL_RAWMIDI_INFO = _IOWR('U', 0x41, struct sndrv_rawmidi_info),
  774. SNDRV_CTL_IOCTL_RAWMIDI_PREFER_SUBDEVICE = _IOW('U', 0x42, int),
  775. SNDRV_CTL_IOCTL_POWER = _IOWR('U', 0xd0, int),
  776. SNDRV_CTL_IOCTL_POWER_STATE = _IOR('U', 0xd1, int),
  777. };
  778. /*
  779. * Read interface.
  780. */
  781. enum sndrv_ctl_event_type {
  782. SNDRV_CTL_EVENT_ELEM = 0,
  783. SNDRV_CTL_EVENT_LAST = SNDRV_CTL_EVENT_ELEM,
  784. };
  785. #define SNDRV_CTL_EVENT_MASK_VALUE (1<<0) /* element value was changed */
  786. #define SNDRV_CTL_EVENT_MASK_INFO (1<<1) /* element info was changed */
  787. #define SNDRV_CTL_EVENT_MASK_ADD (1<<2) /* element was added */
  788. #define SNDRV_CTL_EVENT_MASK_REMOVE (~0U) /* element was removed */
  789. struct sndrv_ctl_event {
  790. enum sndrv_ctl_event_type type; /* event type - SNDRV_CTL_EVENT_* */
  791. union {
  792. struct {
  793. unsigned int mask;
  794. struct sndrv_ctl_elem_id id;
  795. } elem;
  796. unsigned char data8[60];
  797. } data;
  798. };
  799. /*
  800. * Control names
  801. */
  802. #define SNDRV_CTL_NAME_NONE ""
  803. #define SNDRV_CTL_NAME_PLAYBACK "Playback "
  804. #define SNDRV_CTL_NAME_CAPTURE "Capture "
  805. #define SNDRV_CTL_NAME_IEC958_NONE ""
  806. #define SNDRV_CTL_NAME_IEC958_SWITCH "Switch"
  807. #define SNDRV_CTL_NAME_IEC958_VOLUME "Volume"
  808. #define SNDRV_CTL_NAME_IEC958_DEFAULT "Default"
  809. #define SNDRV_CTL_NAME_IEC958_MASK "Mask"
  810. #define SNDRV_CTL_NAME_IEC958_CON_MASK "Con Mask"
  811. #define SNDRV_CTL_NAME_IEC958_PRO_MASK "Pro Mask"
  812. #define SNDRV_CTL_NAME_IEC958_PCM_STREAM "PCM Stream"
  813. #define SNDRV_CTL_NAME_IEC958(expl,direction,what) "IEC958 " expl SNDRV_CTL_NAME_##direction SNDRV_CTL_NAME_IEC958_##what
  814. /*
  815. *
  816. */
  817. struct sndrv_xferv {
  818. const struct iovec *vector;
  819. unsigned long count;
  820. };
  821. enum {
  822. SNDRV_IOCTL_READV = _IOW('K', 0x00, struct sndrv_xferv),
  823. SNDRV_IOCTL_WRITEV = _IOW('K', 0x01, struct sndrv_xferv),
  824. };
  825. #endif /* __SOUND_ASOUND_H */