path: root/include/alsa/asoundef.h

/**
 * \file include/asoundef.h
 * \brief Application interface library for the ALSA driver
 * \author Jaroslav Kysela <perex@perex.cz>
 * \author Abramo Bagnara <abramo@alsa-project.org>
 * \author Takashi Iwai <tiwai@suse.de>
 * \date 1998-2001
 *
 * Definitions of constants for the ALSA driver
 */
/*
 *   This library is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU Lesser General Public License as
 *   published by the Free Software Foundation; either version 2.1 of
 *   the License, or (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU Lesser General Public License for more details.
 *
 *   You should have received a copy of the GNU Lesser General Public
 *   License along with this library; if not, write to the Free Software
 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 */

#ifndef __ALSA_ASOUNDEF_H
#define __ALSA_ASOUNDEF_H

#ifdef __cplusplus
extern "C" {
#endif

/**
 * \defgroup Digital_Audio_Interface Constants for Digital Audio Interfaces
 * AES/IEC958 channel status bits.
 * \{
 */

#define IEC958_AES0_PROFESSIONAL        (1<<0)  /**< 0 = consumer, 1 = professional */
#define IEC958_AES0_NONAUDIO            (1<<1)  /**< 0 = audio, 1 = non-audio */
#define IEC958_AES0_PRO_EMPHASIS        (7<<2)  /**< mask - emphasis */
#define IEC958_AES0_PRO_EMPHASIS_NOTID  (0<<2)  /**< emphasis not indicated */
#define IEC958_AES0_PRO_EMPHASIS_NONE   (1<<2)  /**< no emphasis */
#define IEC958_AES0_PRO_EMPHASIS_5015   (3<<2)  /**< 50/15us emphasis */
#define IEC958_AES0_PRO_EMPHASIS_CCITT  (7<<2)  /**< CCITT J.17 emphasis */
#define IEC958_AES0_PRO_FREQ_UNLOCKED   (1<<5)  /**< source sample frequency: 0 = locked, 1 = unlocked */
#define IEC958_AES0_PRO_FS              (3<<6)  /**< mask - sample frequency */
#define IEC958_AES0_PRO_FS_NOTID        (0<<6)  /**< fs not indicated */
#define IEC958_AES0_PRO_FS_44100        (1<<6)  /**< 44.1kHz */
#define IEC958_AES0_PRO_FS_48000        (2<<6)  /**< 48kHz */
#define IEC958_AES0_PRO_FS_32000        (3<<6)  /**< 32kHz */
#define IEC958_AES0_CON_NOT_COPYRIGHT   (1<<2)  /**< 0 = copyright, 1 = not copyright */
#define IEC958_AES0_CON_EMPHASIS        (7<<3)  /**< mask - emphasis */
#define IEC958_AES0_CON_EMPHASIS_NONE   (0<<3)  /**< no emphasis */
#define IEC958_AES0_CON_EMPHASIS_5015   (1<<3)  /**< 50/15us emphasis */
#define IEC958_AES0_CON_MODE            (3<<6)  /**< mask - mode */
#define IEC958_AES1_PRO_MODE            (15<<0) /**< mask - channel mode */
#define IEC958_AES1_PRO_MODE_NOTID      (0<<0)  /**< mode not indicated */
#define IEC958_AES1_PRO_MODE_STEREOPHONIC (2<<0) /**< stereophonic - ch A is left */
#define IEC958_AES1_PRO_MODE_SINGLE     (4<<0)  /**< single channel */
#define IEC958_AES1_PRO_MODE_TWO        (8<<0)  /**< two channels */
#define IEC958_AES1_PRO_MODE_PRIMARY    (12<<0) /**< primary/secondary */
#define IEC958_AES1_PRO_MODE_BYTE3      (15<<0) /**< vector to byte 3 */
#define IEC958_AES1_PRO_USERBITS        (15<<4) /**< mask - user bits */
#define IEC958_AES1_PRO_USERBITS_NOTID  (0<<4)  /**< user bits not indicated */
#define IEC958_AES1_PRO_USERBITS_192    (8<<4)  /**< 192-bit structure */
#define IEC958_AES1_PRO_USERBITS_UDEF   (12<<4) /**< user defined application */
#define IEC958_AES1_CON_CATEGORY        0x7f    /**< consumer category */
#define IEC958_AES1_CON_GENERAL         0x00    /**< general category */
#define IEC958_AES1_CON_LASEROPT_MASK   0x07    /**< Laser-optical mask */
#define IEC958_AES1_CON_LASEROPT_ID     0x01    /**< Laser-optical ID */
#define IEC958_AES1_CON_IEC908_CD       (IEC958_AES1_CON_LASEROPT_ID|0x00)      /**< IEC958 CD compatible device */
#define IEC958_AES1_CON_NON_IEC908_CD   (IEC958_AES1_CON_LASEROPT_ID|0x08)      /**< non-IEC958 CD compatible device */
#define IEC958_AES1_CON_MINI_DISC       (IEC958_AES1_CON_LASEROPT_ID|0x48)      /**< Mini-Disc device */
#define IEC958_AES1_CON_DVD             (IEC958_AES1_CON_LASEROPT_ID|0x18)      /**< DVD device */
#define IEC958_AES1_CON_LASTEROPT_OTHER (IEC958_AES1_CON_LASEROPT_ID|0x78)      /**< Other laser-optical product */
#define IEC958_AES1_CON_DIGDIGCONV_MASK 0x07    /**< digital<->digital converter mask */
#define IEC958_AES1_CON_DIGDIGCONV_ID   0x02    /**< digital<->digital converter id */
#define IEC958_AES1_CON_PCM_CODER       (IEC958_AES1_CON_DIGDIGCONV_ID|0x00)    /**< PCM coder */
#define IEC958_AES1_CON_MIXER           (IEC958_AES1_CON_DIGDIGCONV_ID|0x10)    /**< Digital signal mixer */
#define IEC958_AES1_CON_RATE_CONVERTER  (IEC958_AES1_CON_DIGDIGCONV_ID|0x18)    /**< Rate converter */
#define IEC958_AES1_CON_SAMPLER         (IEC958_AES1_CON_DIGDIGCONV_ID|0x20)    /**< PCM sampler */
#define IEC958_AES1_CON_DSP             (IEC958_AES1_CON_DIGDIGCONV_ID|0x28)    /**< Digital sound processor */
#define IEC958_AES1_CON_DIGDIGCONV_OTHER (IEC958_AES1_CON_DIGDIGCONV_ID|0x78)   /**< Other digital<->digital product */
#define IEC958_AES1_CON_MAGNETIC_MASK   0x07    /**< Magnetic device mask */
#define IEC958_AES1_CON_MAGNETIC_ID     0x03    /**< Magnetic device ID */
#define IEC958_AES1_CON_DAT             (IEC958_AES1_CON_MAGNETIC_ID|0x00)      /**< Digital Audio Tape */
#define IEC958_AES1_CON_VCR             (IEC958_AES1_CON_MAGNETIC_ID|0x08)      /**< Video recorder */
#define IEC958_AES1_CON_DCC             (IEC958_AES1_CON_MAGNETIC_ID|0x40)      /**< Digital compact cassette */
#define IEC958_AES1_CON_MAGNETIC_DISC   (IEC958_AES1_CON_MAGNETIC_ID|0x18)      /**< Magnetic disc digital audio device */
#define IEC958_AES1_CON_MAGNETIC_OTHER  (IEC958_AES1_CON_MAGNETIC_ID|0x78)      /**< Other magnetic device */
#define IEC958_AES1_CON_BROADCAST1_MASK 0x07    /**< Broadcast mask */
#define IEC958_AES1_CON_BROADCAST1_ID   0x04    /**< Broadcast ID */
#define IEC958_AES1_CON_DAB_JAPAN       (IEC958_AES1_CON_BROADCAST1_ID|0x00)    /**< Digital audio broadcast (Japan) */
#define IEC958_AES1_CON_DAB_EUROPE      (IEC958_AES1_CON_BROADCAST1_ID|0x08)    /**< Digital audio broadcast (Europe) */
#define IEC958_AES1_CON_DAB_USA         (IEC958_AES1_CON_BROADCAST1_ID|0x60)    /**< Digital audio broadcast (USA) */
#define IEC958_AES1_CON_SOFTWARE        (IEC958_AES1_CON_BROADCAST1_ID|0x40)    /**< Electronic software delivery */
#define IEC958_AES1_CON_IEC62105        (IEC958_AES1_CON_BROADCAST1_ID|0x20)    /**< Used by another standard (IEC 62105) */
#define IEC958_AES1_CON_BROADCAST1_OTHER (IEC958_AES1_CON_BROADCAST1_ID|0x78)   /**< Other broadcast product */
#define IEC958_AES1_CON_BROADCAST2_MASK 0x0f    /**< Broadcast alternative mask */
#define IEC958_AES1_CON_BROADCAST2_ID   0x0e    /**< Broadcast alternative ID */
#define IEC958_AES1_CON_MUSICAL_MASK    0x07    /**< Musical device mask */
#define IEC958_AES1_CON_MUSICAL_ID      0x05    /**< Musical device ID */
#define IEC958_AES1_CON_SYNTHESIZER     (IEC958_AES1_CON_MUSICAL_ID|0x00)       /**< Synthesizer */
#define IEC958_AES1_CON_MICROPHONE      (IEC958_AES1_CON_MUSICAL_ID|0x08)       /**< Microphone */
#define IEC958_AES1_CON_MUSICAL_OTHER   (IEC958_AES1_CON_MUSICAL_ID|0x78)       /**< Other musical device */
#define IEC958_AES1_CON_ADC_MASK        0x1f    /**< ADC Mask */
#define IEC958_AES1_CON_ADC_ID          0x06    /**< ADC ID */
#define IEC958_AES1_CON_ADC             (IEC958_AES1_CON_ADC_ID|0x00)   /**< ADC without copyright information */
#define IEC958_AES1_CON_ADC_OTHER       (IEC958_AES1_CON_ADC_ID|0x60)   /**< Other ADC product (with no copyright information) */
#define IEC958_AES1_CON_ADC_COPYRIGHT_MASK 0x1f /**< ADC Copyright mask */
#define IEC958_AES1_CON_ADC_COPYRIGHT_ID 0x16   /**< ADC Copyright ID */
#define IEC958_AES1_CON_ADC_COPYRIGHT   (IEC958_AES1_CON_ADC_COPYRIGHT_ID|0x00) /**< ADC with copyright information */
#define IEC958_AES1_CON_ADC_COPYRIGHT_OTHER (IEC958_AES1_CON_ADC_COPYRIGHT_ID|0x60)     /**< Other ADC with copyright information product */
#define IEC958_AES1_CON_SOLIDMEM_MASK   0x0f    /**< Solid memory based products mask */
#define IEC958_AES1_CON_SOLIDMEM_ID     0x08    /**< Solid memory based products ID */
#define IEC958_AES1_CON_SOLIDMEM_DIGITAL_RECORDER_PLAYER (IEC958_AES1_CON_SOLIDMEM_ID|0x00)     /**< Digital audio recorder and player using solid state memory */
#define IEC958_AES1_CON_SOLIDMEM_OTHER  (IEC958_AES1_CON_SOLIDMEM_ID|0x70)      /**< Other solid state memory based product */
#define IEC958_AES1_CON_EXPERIMENTAL    0x40    /**< experimental category */
#define IEC958_AES1_CON_ORIGINAL        (1<<7)  /**< this bits depends on the category code */
#define IEC958_AES2_PRO_SBITS           (7<<0)  /**< mask - sample bits */
#define IEC958_AES2_PRO_SBITS_20        (2<<0)  /**< 20-bit - coordination */
#define IEC958_AES2_PRO_SBITS_24        (4<<0)  /**< 24-bit - main audio */
#define IEC958_AES2_PRO_SBITS_UDEF      (6<<0)  /**< user defined application */
#define IEC958_AES2_PRO_WORDLEN         (7<<3)  /**< mask - source word length */
#define IEC958_AES2_PRO_WORDLEN_NOTID   (0<<3)  /**< source word length not indicated */
#define IEC958_AES2_PRO_WORDLEN_22_18   (2<<3)  /**< 22-bit or 18-bit */
#define IEC958_AES2_PRO_WORDLEN_23_19   (4<<3)  /**< 23-bit or 19-bit */
#define IEC958_AES2_PRO_WORDLEN_24_20   (5<<3)  /**< 24-bit or 20-bit */
#define IEC958_AES2_PRO_WORDLEN_20_16   (6<<3)  /**< 20-bit or 16-bit */
#define IEC958_AES2_CON_SOURCE          (15<<0) /**< mask - source number */
#define IEC958_AES2_CON_SOURCE_UNSPEC   (0<<0)  /**< source number unspecified */
#define IEC958_AES2_CON_CHANNEL         (15<<4) /**< mask - channel number */
#define IEC958_AES2_CON_CHANNEL_UNSPEC  (0<<4)  /**< channel number unspecified */
#define IEC958_AES3_CON_FS              (15<<0) /**< mask - sample frequency */
#define IEC958_AES3_CON_FS_44100        (0<<0)  /**< 44.1kHz */
#define IEC958_AES3_CON_FS_NOTID        (1<<0)  /**< sample frequency non indicated */
#define IEC958_AES3_CON_FS_48000        (2<<0)  /**< 48kHz */
#define IEC958_AES3_CON_FS_32000        (3<<0)  /**< 32kHz */
#define IEC958_AES3_CON_FS_22050        (4<<0)  /**< 22.05kHz */
#define IEC958_AES3_CON_FS_24000        (6<<0)  /*