include/sound/ak4114.h

   1 #ifndef __SOUND_AK4114_H
   2 #define __SOUND_AK4114_H
   3
   4 /*
   5  *  Routines for Asahi Kasei AK4114
   6  *  Copyright (c) by Jaroslav Kysela <perex@suse.cz>,
   7  *
   8  *
   9  *   This program is free software; you can redistribute it and/or modify
  10  *   it under the terms of the GNU General Public License as published by
  11  *   the Free Software Foundation; either version 2 of the License, or
  12  *   (at your option) any later version.
  13  *
  14  *   This program is distributed in the hope that it will be useful,
  15  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  *   GNU General Public License for more details.
  18  *
  19  *   You should have received a copy of the GNU General Public License
  20  *   along with this program; if not, write to the Free Software
  21  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  22  *
  23  */
  24
  25 /* AK4114 registers */
  26 #define AK4114_REG_PWRDN        0x00    /* power down */
  27 #define AK4114_REG_FORMAT       0x01    /* format control */
  28 #define AK4114_REG_IO0          0x02    /* input/output control */
  29 #define AK4114_REG_IO1          0x03    /* input/output control */
  30 #define AK4114_REG_INT0_MASK    0x04    /* interrupt0 mask */
  31 #define AK4114_REG_INT1_MASK    0x05    /* interrupt1 mask */
  32 #define AK4114_REG_RCS0         0x06    /* receiver status 0 */
  33 #define AK4114_REG_RCS1         0x07    /* receiver status 1 */
  34 #define AK4114_REG_RXCSB0       0x08    /* RX channel status byte 0 */
  35 #define AK4114_REG_RXCSB1       0x09    /* RX channel status byte 1 */
  36 #define AK4114_REG_RXCSB2       0x0a    /* RX channel status byte 2 */
  37 #define AK4114_REG_RXCSB3       0x0b    /* RX channel status byte 3 */
  38 #define AK4114_REG_RXCSB4       0x0c    /* RX channel status byte 4 */
  39 #define AK4114_REG_TXCSB0       0x0d    /* TX channel status byte 0 */
  40 #define AK4114_REG_TXCSB1       0x0e    /* TX channel status byte 1 */
  41 #define AK4114_REG_TXCSB2       0x0f    /* TX channel status byte 2 */
  42 #define AK4114_REG_TXCSB3       0x10    /* TX channel status byte 3 */
  43 #define AK4114_REG_TXCSB4       0x11    /* TX channel status byte 4 */
  44 #define AK4114_REG_Pc0          0x12    /* burst preamble Pc byte 0 */
  45 #define AK4114_REG_Pc1          0x13    /* burst preamble Pc byte 1 */
  46 #define AK4114_REG_Pd0          0x14    /* burst preamble Pd byte 0 */
  47 #define AK4114_REG_Pd1          0x15    /* burst preamble Pd byte 1 */
  48 #define AK4114_REG_QSUB_ADDR    0x16    /* Q-subcode address + control */
  49 #define AK4114_REG_QSUB_TRACK   0x17    /* Q-subcode track */
  50 #define AK4114_REG_QSUB_INDEX   0x18    /* Q-subcode index */
  51 #define AK4114_REG_QSUB_MINUTE  0x19    /* Q-subcode minute */
  52 #define AK4114_REG_QSUB_SECOND  0x1a    /* Q-subcode second */
  53 #define AK4114_REG_QSUB_FRAME   0x1b    /* Q-subcode frame */
  54 #define AK4114_REG_QSUB_ZERO    0x1c    /* Q-subcode zero */
  55 #define AK4114_REG_QSUB_ABSMIN  0x1d    /* Q-subcode absolute minute */
  56 #define AK4114_REG_QSUB_ABSSEC  0x1e    /* Q-subcode absolute second */
  57 #define AK4114_REG_QSUB_ABSFRM  0x1f    /* Q-subcode absolute frame */
  58
  59 /* sizes */
  60 #define AK4114_REG_RXCSB_SIZE   ((AK4114_REG_RXCSB4-AK4114_REG_RXCSB0)+1)
  61 #define AK4114_REG_TXCSB_SIZE   ((AK4114_REG_TXCSB4-AK4114_REG_TXCSB0)+1)
  62 #define AK4114_REG_QSUB_SIZE    ((AK4114_REG_QSUB_ABSFRM-AK4114_REG_QSUB_ADDR)+1)
  63
  64 /* AK4117_REG_PWRDN bits */
  65 #define AK4114_CS12             (1<<7)  /* Channel Status Select */
  66 #define AK4114_BCU              (1<<6)  /* Block Start & C/U Output Mode */
  67 #define AK4114_CM1              (1<<5)  /* Master Clock Operation Select */
  68 #define AK4114_CM0              (1<<4)  /* Master Clock Operation Select */
  69 #define AK4114_OCKS1            (1<<3)  /* Master Clock Frequency Select */
  70 #define AK4114_OCKS0            (1<<2)  /* Master Clock Frequency Select */
  71 #define AK4114_PWN              (1<<1)  /* 0 = power down, 1 = normal operation */
  72 #define AK4114_RST              (1<<0)  /* 0 = reset & initialize (except this register), 1 = normal operation */
  73
  74 /* AK4114_REQ_FORMAT bits */
  75 #define AK4114_MONO             (1<<7)  /* Double Sampling Frequency Mode: 0 = stereo, 1 = mono */
  76 #define AK4114_DIF2             (1<<6)  /* Audio Data Control */
  77 #define AK4114_DIF1             (1<<5)  /* Audio Data Control */
  78 #define AK4114_DIF0             (1<<4)  /* Audio Data Control */
  79 #define AK4114_DIF_16R          (0)                             /* STDO: 16-bit, right justified */
  80 #define AK4114_DIF_18R          (AK4114_DIF0)                   /* STDO: 18-bit, right justified */
  81 #define AK4114_DIF_20R          (AK4114_DIF1)                   /* STDO: 20-bit, right justified */
  82 #define AK4114_DIF_24R          (AK4114_DIF1|AK4114_DIF0)       /* STDO: 24-bit, right justified */
  83 #define AK4114_DIF_24L          (AK4114_DIF2)                   /* STDO: 24-bit, left justified */
  84 #define AK4114_DIF_24I2S        (AK4114_DIF2|AK4114_DIF0)       /* STDO: I2S */
  85 #define AK4114_DIF_I24L         (AK4114_DIF2|AK4114_DIF1)       /* STDO: 24-bit, left justified; LRCLK, BICK = Input */
  86 #define AK4114_DIF_I24I2S       (AK4114_DIF2|AK4114_DIF1|AK4114_DIF0) /* STDO: I2S;  LRCLK, BICK = Input */
  87 #define AK4114_DEAU             (1<<3)  /* Deemphasis Autodetect Enable (1 = enable) */
  88 #define AK4114_DEM1             (1<<2)  /* 32kHz-48kHz Deemphasis Control */
  89 #define AK4114_DEM0             (1<<1)  /* 32kHz-48kHz Deemphasis Control */
  90 #define AK4114_DEM_44KHZ        (0)
  91 #define AK4114_DEM_48KHZ        (AK4114_DEM1)
  92 #define AK4114_DEM_32KHZ        (AK4114_DEM0|AK4114_DEM1)
  93 #define AK4114_DEM_96KHZ        (AK4114_DEM1)   /* DFS must be set */
  94 #define AK4114_DFS              (1<<0)  /* 96kHz Deemphasis Control */
  95
  96 /* AK4114_REG_IO0 */
  97 #define AK4114_TX1E             (1<<7)  /* TX1 Output Enable (1 = enable) */
  98 #define AK4114_OPS12            (1<<2)  /* Output Though Data Selector for TX1 pin */
  99 #define AK4114_OPS11            (1<<1)  /* Output Though Data Selector for TX1 pin */
 100 #define AK4114_OPS10            (1<<0)  /* Output Though Data Selector for TX1 pin */
 101 #define AK4114_TX0E             (1<<3)  /* TX0 Output Enable (1 = enable) */
 102 #define AK4114_OPS02            (1<<2)  /* Output Though Data Selector for TX0 pin */
 103 #define AK4114_OPS01            (1<<1)  /* Output Though Data Selector for TX0 pin */
 104 #define AK4114_OPS00            (1<<0)  /* Output Though Data Selector for TX0 pin */
 105
 106 /* AK4114_REG_IO1 */
 107 #define AK4114_EFH1             (1<<7)  /* Interrupt 0 pin Hold */
 108 #define AK4114_EFH0             (1<<6)  /* Interrupt 0 pin Hold */
 109 #define AK4114_EFH_512          (0)
 110 #define AK4114_EFH_1024         (AK4114_EFH0)
 111 #define AK4114_EFH_2048         (AK4114_EFH1)
 112 #define AK4114_EFH_4096         (AK4114_EFH1|AK4114_EFH0)
 113 #define AK4114_UDIT             (1<<5)  /* U-bit Control for DIT (0 = fixed '0', 1 = recovered) */
 114 #define AK4114_TLR              (1<<4)  /* Double Sampling Frequency Select for DIT (0 = L channel, 1 = R channel) */
 115 #define AK4114_DIT              (1<<3)  /* TX1 out: 0 = Through Data (RX data), 1 = Transmit Data (DAUX data) */
 116 #define AK4114_IPS2             (1<<2)  /* Input Recovery Data Select */
 117 #define AK4114_IPS1             (1<<1)  /* Input Recovery Data Select */
 118 #define AK4114_IPS0             (1<<0)  /* Input Recovery Data Select */
 119 #define AK4114_IPS(x)           ((x)&7)
 120
 121 /* AK4114_REG_INT0_MASK && AK4114_REG_INT1_MASK*/
 122 #define AK4117_MQI              (1<<7)  /* mask enable for QINT bit */
 123 #define AK4117_MAT              (1<<6)  /* mask enable for AUTO bit */
 124 #define AK4117_MCI              (1<<5)  /* mask enable for CINT bit */
 125 #define AK4117_MUL              (1<<4)  /* mask enable for UNLOCK bit */
 126 #define AK4117_MDTS             (1<<3)  /* mask enable for DTSCD bit */
 127 #define AK4117_MPE              (1<<2)  /* mask enable for PEM bit */
 128 #define AK4117_MAN              (1<<1)  /* mask enable for AUDN bit */
 129 #define AK4117_MPR              (1<<0)  /* mask enable for PAR bit */
 130
 131 /* AK4114_REG_RCS0 */
 132 #define AK4114_QINT             (1<<7)  /* Q-subcode buffer interrupt, 0 = no change, 1 = changed */
 133 #define AK4114_AUTO             (1<<6)  /* Non-PCM or DTS stream auto detection, 0 = no detect, 1 = detect */
 134 #define AK4114_CINT             (1<<5)  /* channel status buffer interrupt, 0 = no change, 1 = change */
 135 #define AK4114_UNLCK            (1<<4)  /* PLL lock status, 0 = lock, 1 = unlock */
 136 #define AK4114_DTSCD            (1<<3)  /* DTS-CD Detect, 0 = No detect, 1 = Detect */
 137 #define AK4114_PEM              (1<<2)  /* Pre-emphasis Detect, 0 = OFF, 1 = ON */
 138 #define AK4114_AUDION           (1<<1)  /* audio bit output, 0 = audio, 1 = non-audio */
 139 #define AK4114_PAR              (1<<0)  /* parity error or biphase error status, 0 = no error, 1 = error */
 140
 141 /* AK4114_REG_RCS1 */
 142 #define AK4114_FS3              (1<<7)  /* sampling frequency detection */
 143 #define AK4114_FS2              (1<<6)
 144 #define AK4114_FS1              (1<<5)
 145 #define AK4114_FS0              (1<<4)
 146 #define AK4114_FS_44100HZ       (0)
 147 #define AK4114_FS_48000HZ       (AK4114_FS1)
 148 #define AK4114_FS_32000HZ       (AK4114_FS1|AK4114_FS0)
 149 #define AK4114_FS_88200HZ       (AK4114_FS3)
 150 #define AK4114_FS_96000HZ       (AK4114_FS3|AK4114_FS1)
 151 #define AK4114_FS_176400HZ      (AK4114_FS3|AK4114_FS2)
 152 #define AK4114_FS_192000HZ      (AK4114_FS3|AK4114_FS2|AK4114_FS1)
 153 #define AK4114_V                (1<<3)  /* Validity of Channel Status, 0 = Valid, 1 = Invalid */
 154 #define AK4114_QCRC             (1<<1)  /* CRC for Q-subcode, 0 = no error, 1 = error */
 155 #define AK4114_CCRC             (1<<0)  /* CRC for channel status, 0 = no error, 1 = error */
 156
 157 /* flags for snd_ak4114_check_rate_and_errors() */
 158 #define AK4114_CHECK_NO_STAT    (1<<0)  /* no statistics */
 159 #define AK4114_CHECK_NO_RATE    (1<<1)  /* no rate check */
 160
 161 #define AK4114_CONTROLS         15
 162
 163 typedef void (ak4114_write_t)(void *private_data, unsigned char addr, unsigned char data);
 164 typedef unsigned char (ak4114_read_t)(void *private_data, unsigned char addr);
 165
 166 struct ak4114 {
 167         struct snd_card *card;
 168         ak4114_write_t * write;
 169         ak4114_read_t * read;
 170         void * private_data;
 171         unsigned int init: 1;
 172         spinlock_t lock;
 173         unsigned char regmap[7];
 174         unsigned char txcsb[5];
 175         struct snd_kcontrol *kctls[AK4114_CONTROLS];
 176         struct snd_pcm_substream *playback_substream;
 177         struct snd_pcm_substream *capture_substream;
 178         unsigned long parity_errors;
 179         unsigned long v_bit_errors;
 180         unsigned long qcrc_errors;
 181         unsigned long ccrc_errors;
 182         unsigned char rcs0;
 183         unsigned char rcs1;
 184         struct delayed_work work;
 185         void *change_callback_private;
 186         void (*change_callback)(struct ak4114 *ak4114, unsigned char c0, unsigned char c1);
 187 };
 188
 189 int snd_ak4114_create(struct snd_card *card,
 190                       ak4114_read_t *read, ak4114_write_t *write,
 191                       const unsigned char pgm[7], const unsigned char txcsb[5],
 192                       void *private_data, struct ak4114 **r_ak4114);
 193 void snd_ak4114_reg_write(struct ak4114 *ak4114, unsigned char reg, unsigned char mask, unsigned char val);
 194 void snd_ak4114_reinit(struct ak4114 *ak4114);
 195 int snd_ak4114_build(struct ak4114 *ak4114,
 196                      struct snd_pcm_substream *playback_substream,
 197                      struct snd_pcm_substream *capture_substream);
 198 int snd_ak4114_external_rate(struct ak4114 *ak4114);
 199 int snd_ak4114_check_rate_and_errors(struct ak4114 *ak4114, unsigned int flags);
 200
 201 #endif /* __SOUND_AK4114_H */
 202