1 /* SPDX-License-Identifier: GPL-2.0-or-later * <<
2 #ifndef __SOUND_WM8776_H 1 #ifndef __SOUND_WM8776_H
3 #define __SOUND_WM8776_H 2 #define __SOUND_WM8776_H
4 3
5 /* 4 /*
6 * ALSA driver for ICEnsemble VT17xx 5 * ALSA driver for ICEnsemble VT17xx
7 * 6 *
8 * Lowlevel functions for WM8776 codec 7 * Lowlevel functions for WM8776 codec
9 * 8 *
10 * Copyright (c) 2012 Ondrej Zary <linux@ 9 * Copyright (c) 2012 Ondrej Zary <linux@rainbow-software.org>
>> 10 *
>> 11 * This program is free software; you can redistribute it and/or modify
>> 12 * it under the terms of the GNU General Public License as published by
>> 13 * the Free Software Foundation; either version 2 of the License, or
>> 14 * (at your option) any later version.
>> 15 *
>> 16 * This program is distributed in the hope that it will be useful,
>> 17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
>> 18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
>> 19 * GNU General Public License for more details.
>> 20 *
>> 21 * You should have received a copy of the GNU General Public License
>> 22 * along with this program; if not, write to the Free Software
>> 23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
>> 24 *
11 */ 25 */
12 26
13 #define WM8776_REG_HPLVOL 0x00 27 #define WM8776_REG_HPLVOL 0x00
14 #define WM8776_REG_HPRVOL 0x01 28 #define WM8776_REG_HPRVOL 0x01
15 #define WM8776_REG_HPMASTER 0x02 29 #define WM8776_REG_HPMASTER 0x02
16 #define WM8776_HPVOL_MASK 0x17f 30 #define WM8776_HPVOL_MASK 0x17f /* incl. update bit */
17 #define WM8776_VOL_HPZCEN (1 << 31 #define WM8776_VOL_HPZCEN (1 << 7) /* zero cross detect */
18 #define WM8776_VOL_UPDATE (1 << 32 #define WM8776_VOL_UPDATE (1 << 8) /* update volume */
19 #define WM8776_REG_DACLVOL 0x03 33 #define WM8776_REG_DACLVOL 0x03
20 #define WM8776_REG_DACRVOL 0x04 34 #define WM8776_REG_DACRVOL 0x04
21 #define WM8776_REG_DACMASTER 0x05 35 #define WM8776_REG_DACMASTER 0x05
22 #define WM8776_DACVOL_MASK 0x1ff 36 #define WM8776_DACVOL_MASK 0x1ff /* incl. update bit */
23 #define WM8776_REG_PHASESWAP 0x06 37 #define WM8776_REG_PHASESWAP 0x06
24 #define WM8776_PHASE_INVERTL (1 << 38 #define WM8776_PHASE_INVERTL (1 << 0)
25 #define WM8776_PHASE_INVERTR (1 << 39 #define WM8776_PHASE_INVERTR (1 << 1)
26 #define WM8776_REG_DACCTRL1 0x07 40 #define WM8776_REG_DACCTRL1 0x07
27 #define WM8776_DAC_DZCEN (1 << 41 #define WM8776_DAC_DZCEN (1 << 0)
28 #define WM8776_DAC_ATC (1 << 42 #define WM8776_DAC_ATC (1 << 1)
29 #define WM8776_DAC_IZD (1 << 43 #define WM8776_DAC_IZD (1 << 2)
30 #define WM8776_DAC_TOD (1 << 44 #define WM8776_DAC_TOD (1 << 3)
31 #define WM8776_DAC_PL_MASK 0xf0 45 #define WM8776_DAC_PL_MASK 0xf0
32 #define WM8776_DAC_PL_LL (1 << 46 #define WM8776_DAC_PL_LL (1 << 4) /* L chan: L signal */
33 #define WM8776_DAC_PL_LR (2 << 47 #define WM8776_DAC_PL_LR (2 << 4) /* L chan: R signal */
34 #define WM8776_DAC_PL_LB (3 << 48 #define WM8776_DAC_PL_LB (3 << 4) /* L chan: both */
35 #define WM8776_DAC_PL_RL (1 << 49 #define WM8776_DAC_PL_RL (1 << 6) /* R chan: L signal */
36 #define WM8776_DAC_PL_RR (2 << 50 #define WM8776_DAC_PL_RR (2 << 6) /* R chan: R signal */
37 #define WM8776_DAC_PL_RB (3 << 51 #define WM8776_DAC_PL_RB (3 << 6) /* R chan: both */
38 #define WM8776_REG_DACMUTE 0x08 52 #define WM8776_REG_DACMUTE 0x08
39 #define WM8776_DACMUTE (1 << 53 #define WM8776_DACMUTE (1 << 0)
40 #define WM8776_REG_DACCTRL2 0x09 54 #define WM8776_REG_DACCTRL2 0x09
41 #define WM8776_DAC2_DEEMPH (1 << 55 #define WM8776_DAC2_DEEMPH (1 << 0)
42 #define WM8776_DAC2_ZFLAG_DISABLE (0 << 56 #define WM8776_DAC2_ZFLAG_DISABLE (0 << 1)
43 #define WM8776_DAC2_ZFLAG_OWN (1 << 57 #define WM8776_DAC2_ZFLAG_OWN (1 << 1)
44 #define WM8776_DAC2_ZFLAG_BOTH (2 << 58 #define WM8776_DAC2_ZFLAG_BOTH (2 << 1)
45 #define WM8776_DAC2_ZFLAG_EITHER (3 << 59 #define WM8776_DAC2_ZFLAG_EITHER (3 << 1)
46 #define WM8776_REG_DACIFCTRL 0x0a 60 #define WM8776_REG_DACIFCTRL 0x0a
47 #define WM8776_FMT_RIGHTJ (0 << 61 #define WM8776_FMT_RIGHTJ (0 << 0)
48 #define WM8776_FMT_LEFTJ (1 << 62 #define WM8776_FMT_LEFTJ (1 << 0)
49 #define WM8776_FMT_I2S (2 << 63 #define WM8776_FMT_I2S (2 << 0)
50 #define WM8776_FMT_DSP (3 << 64 #define WM8776_FMT_DSP (3 << 0)
51 #define WM8776_FMT_DSP_LATE (1 << 65 #define WM8776_FMT_DSP_LATE (1 << 2) /* in DSP mode */
52 #define WM8776_FMT_LRC_INVERTED (1 << 66 #define WM8776_FMT_LRC_INVERTED (1 << 2) /* in other modes */
53 #define WM8776_FMT_BCLK_INVERTED (1 << 67 #define WM8776_FMT_BCLK_INVERTED (1 << 3)
54 #define WM8776_FMT_16BIT (0 << 68 #define WM8776_FMT_16BIT (0 << 4)
55 #define WM8776_FMT_20BIT (1 << 69 #define WM8776_FMT_20BIT (1 << 4)
56 #define WM8776_FMT_24BIT (2 << 70 #define WM8776_FMT_24BIT (2 << 4)
57 #define WM8776_FMT_32BIT (3 << 71 #define WM8776_FMT_32BIT (3 << 4)
58 #define WM8776_REG_ADCIFCTRL 0x0b 72 #define WM8776_REG_ADCIFCTRL 0x0b
59 #define WM8776_FMT_ADCMCLK_INVERTED (1 << 73 #define WM8776_FMT_ADCMCLK_INVERTED (1 << 6)
60 #define WM8776_FMT_ADCHPD (1 << 74 #define WM8776_FMT_ADCHPD (1 << 8)
61 #define WM8776_REG_MSTRCTRL 0x0c 75 #define WM8776_REG_MSTRCTRL 0x0c
62 #define WM8776_IF_ADC256FS (2 << 76 #define WM8776_IF_ADC256FS (2 << 0)
63 #define WM8776_IF_ADC384FS (3 << 77 #define WM8776_IF_ADC384FS (3 << 0)
64 #define WM8776_IF_ADC512FS (4 << 78 #define WM8776_IF_ADC512FS (4 << 0)
65 #define WM8776_IF_ADC768FS (5 << 79 #define WM8776_IF_ADC768FS (5 << 0)
66 #define WM8776_IF_OVERSAMP64 (1 << 80 #define WM8776_IF_OVERSAMP64 (1 << 3)
67 #define WM8776_IF_DAC128FS (0 << 81 #define WM8776_IF_DAC128FS (0 << 4)
68 #define WM8776_IF_DAC192FS (1 << 82 #define WM8776_IF_DAC192FS (1 << 4)
69 #define WM8776_IF_DAC256FS (2 << 83 #define WM8776_IF_DAC256FS (2 << 4)
70 #define WM8776_IF_DAC384FS (3 << 84 #define WM8776_IF_DAC384FS (3 << 4)
71 #define WM8776_IF_DAC512FS (4 << 85 #define WM8776_IF_DAC512FS (4 << 4)
72 #define WM8776_IF_DAC768FS (5 << 86 #define WM8776_IF_DAC768FS (5 << 4)
73 #define WM8776_IF_DAC_MASTER (1 << 87 #define WM8776_IF_DAC_MASTER (1 << 7)
74 #define WM8776_IF_ADC_MASTER (1 << 88 #define WM8776_IF_ADC_MASTER (1 << 8)
75 #define WM8776_REG_PWRDOWN 0x0d 89 #define WM8776_REG_PWRDOWN 0x0d
76 #define WM8776_PWR_PDWN (1 << 90 #define WM8776_PWR_PDWN (1 << 0)
77 #define WM8776_PWR_ADCPD (1 << 91 #define WM8776_PWR_ADCPD (1 << 1)
78 #define WM8776_PWR_DACPD (1 << 92 #define WM8776_PWR_DACPD (1 << 2)
79 #define WM8776_PWR_HPPD (1 << 93 #define WM8776_PWR_HPPD (1 << 3)
80 #define WM8776_PWR_AINPD (1 << 94 #define WM8776_PWR_AINPD (1 << 6)
81 #define WM8776_REG_ADCLVOL 0x0e 95 #define WM8776_REG_ADCLVOL 0x0e
82 #define WM8776_REG_ADCRVOL 0x0f 96 #define WM8776_REG_ADCRVOL 0x0f
83 #define WM8776_ADC_GAIN_MASK 0xff 97 #define WM8776_ADC_GAIN_MASK 0xff
84 #define WM8776_ADC_ZCEN (1 << 98 #define WM8776_ADC_ZCEN (1 << 8)
85 #define WM8776_REG_ALCCTRL1 0x10 99 #define WM8776_REG_ALCCTRL1 0x10
86 #define WM8776_ALC1_LCT_MASK 0x0f 100 #define WM8776_ALC1_LCT_MASK 0x0f /* 0=-16dB, 1=-15dB..15=-1dB */
87 #define WM8776_ALC1_MAXGAIN_MASK 0x70 101 #define WM8776_ALC1_MAXGAIN_MASK 0x70 /* 0,1=0dB, 2=+4dB...7=+24dB */
88 #define WM8776_ALC1_LCSEL_MASK 0x180 102 #define WM8776_ALC1_LCSEL_MASK 0x180
89 #define WM8776_ALC1_LCSEL_LIMITER (0 << 103 #define WM8776_ALC1_LCSEL_LIMITER (0 << 7)
90 #define WM8776_ALC1_LCSEL_ALCR (1 << 104 #define WM8776_ALC1_LCSEL_ALCR (1 << 7)
91 #define WM8776_ALC1_LCSEL_ALCL (2 << 105 #define WM8776_ALC1_LCSEL_ALCL (2 << 7)
92 #define WM8776_ALC1_LCSEL_ALCSTEREO (3 << 106 #define WM8776_ALC1_LCSEL_ALCSTEREO (3 << 7)
93 #define WM8776_REG_ALCCTRL2 0x11 107 #define WM8776_REG_ALCCTRL2 0x11
94 #define WM8776_ALC2_HOLD_MASK 0x0f 108 #define WM8776_ALC2_HOLD_MASK 0x0f /*0=0ms, 1=2.67ms, 2=5.33ms.. */
95 #define WM8776_ALC2_ZCEN (1 << 109 #define WM8776_ALC2_ZCEN (1 << 7)
96 #define WM8776_ALC2_LCEN (1 << 110 #define WM8776_ALC2_LCEN (1 << 8)
97 #define WM8776_REG_ALCCTRL3 0x12 111 #define WM8776_REG_ALCCTRL3 0x12
98 #define WM8776_ALC3_ATK_MASK 0x0f 112 #define WM8776_ALC3_ATK_MASK 0x0f
99 #define WM8776_ALC3_DCY_MASK 0xf0 113 #define WM8776_ALC3_DCY_MASK 0xf0
100 #define WM8776_ALC3_FDECAY (1 << 114 #define WM8776_ALC3_FDECAY (1 << 8)
101 #define WM8776_REG_NOISEGATE 0x13 115 #define WM8776_REG_NOISEGATE 0x13
102 #define WM8776_NGAT_ENABLE (1 << 116 #define WM8776_NGAT_ENABLE (1 << 0)
103 #define WM8776_NGAT_THR_MASK 0x1c 117 #define WM8776_NGAT_THR_MASK 0x1c /*0=-78dB, 1=-72dB...7=-36dB */
104 #define WM8776_REG_LIMITER 0x14 118 #define WM8776_REG_LIMITER 0x14
105 #define WM8776_LIM_MAXATTEN_MASK 0x0f 119 #define WM8776_LIM_MAXATTEN_MASK 0x0f
106 #define WM8776_LIM_TRANWIN_MASK 0x70 120 #define WM8776_LIM_TRANWIN_MASK 0x70 /*0=0us, 1=62.5us, 2=125us.. */
107 #define WM8776_REG_ADCMUX 0x15 121 #define WM8776_REG_ADCMUX 0x15
108 #define WM8776_ADC_MUX_AIN1 (1 << 122 #define WM8776_ADC_MUX_AIN1 (1 << 0)
109 #define WM8776_ADC_MUX_AIN2 (1 << 123 #define WM8776_ADC_MUX_AIN2 (1 << 1)
110 #define WM8776_ADC_MUX_AIN3 (1 << 124 #define WM8776_ADC_MUX_AIN3 (1 << 2)
111 #define WM8776_ADC_MUX_AIN4 (1 << 125 #define WM8776_ADC_MUX_AIN4 (1 << 3)
112 #define WM8776_ADC_MUX_AIN5 (1 << 126 #define WM8776_ADC_MUX_AIN5 (1 << 4)
113 #define WM8776_ADC_MUTER (1 << 127 #define WM8776_ADC_MUTER (1 << 6)
114 #define WM8776_ADC_MUTEL (1 << 128 #define WM8776_ADC_MUTEL (1 << 7)
115 #define WM8776_ADC_LRBOTH (1 << 129 #define WM8776_ADC_LRBOTH (1 << 8)
116 #define WM8776_REG_OUTMUX 0x16 130 #define WM8776_REG_OUTMUX 0x16
117 #define WM8776_OUTMUX_DAC (1 << 131 #define WM8776_OUTMUX_DAC (1 << 0)
118 #define WM8776_OUTMUX_AUX (1 << 132 #define WM8776_OUTMUX_AUX (1 << 1)
119 #define WM8776_OUTMUX_BYPASS (1 << 133 #define WM8776_OUTMUX_BYPASS (1 << 2)
120 #define WM8776_REG_RESET 0x17 134 #define WM8776_REG_RESET 0x17
121 135
122 #define WM8776_REG_COUNT 0x17 /* don 136 #define WM8776_REG_COUNT 0x17 /* don't cache the RESET register */
123 137
124 struct snd_wm8776; 138 struct snd_wm8776;
125 139
126 struct snd_wm8776_ops { 140 struct snd_wm8776_ops {
127 void (*write)(struct snd_wm8776 *wm, u 141 void (*write)(struct snd_wm8776 *wm, u8 addr, u8 data);
128 }; 142 };
129 143
130 enum snd_wm8776_ctl_id { 144 enum snd_wm8776_ctl_id {
131 WM8776_CTL_DAC_VOL, 145 WM8776_CTL_DAC_VOL,
132 WM8776_CTL_DAC_SW, 146 WM8776_CTL_DAC_SW,
133 WM8776_CTL_DAC_ZC_SW, 147 WM8776_CTL_DAC_ZC_SW,
134 WM8776_CTL_HP_VOL, 148 WM8776_CTL_HP_VOL,
135 WM8776_CTL_HP_SW, 149 WM8776_CTL_HP_SW,
136 WM8776_CTL_HP_ZC_SW, 150 WM8776_CTL_HP_ZC_SW,
137 WM8776_CTL_AUX_SW, 151 WM8776_CTL_AUX_SW,
138 WM8776_CTL_BYPASS_SW, 152 WM8776_CTL_BYPASS_SW,
139 WM8776_CTL_DAC_IZD_SW, 153 WM8776_CTL_DAC_IZD_SW,
140 WM8776_CTL_PHASE_SW, 154 WM8776_CTL_PHASE_SW,
141 WM8776_CTL_DEEMPH_SW, 155 WM8776_CTL_DEEMPH_SW,
142 WM8776_CTL_ADC_VOL, 156 WM8776_CTL_ADC_VOL,
143 WM8776_CTL_ADC_SW, 157 WM8776_CTL_ADC_SW,
144 WM8776_CTL_INPUT1_SW, 158 WM8776_CTL_INPUT1_SW,
145 WM8776_CTL_INPUT2_SW, 159 WM8776_CTL_INPUT2_SW,
146 WM8776_CTL_INPUT3_SW, 160 WM8776_CTL_INPUT3_SW,
147 WM8776_CTL_INPUT4_SW, 161 WM8776_CTL_INPUT4_SW,
148 WM8776_CTL_INPUT5_SW, 162 WM8776_CTL_INPUT5_SW,
149 WM8776_CTL_AGC_SEL, 163 WM8776_CTL_AGC_SEL,
150 WM8776_CTL_LIM_THR, 164 WM8776_CTL_LIM_THR,
151 WM8776_CTL_LIM_ATK, 165 WM8776_CTL_LIM_ATK,
152 WM8776_CTL_LIM_DCY, 166 WM8776_CTL_LIM_DCY,
153 WM8776_CTL_LIM_TRANWIN, 167 WM8776_CTL_LIM_TRANWIN,
154 WM8776_CTL_LIM_MAXATTN, 168 WM8776_CTL_LIM_MAXATTN,
155 WM8776_CTL_ALC_TGT, 169 WM8776_CTL_ALC_TGT,
156 WM8776_CTL_ALC_ATK, 170 WM8776_CTL_ALC_ATK,
157 WM8776_CTL_ALC_DCY, 171 WM8776_CTL_ALC_DCY,
158 WM8776_CTL_ALC_MAXGAIN, 172 WM8776_CTL_ALC_MAXGAIN,
159 WM8776_CTL_ALC_MAXATTN, 173 WM8776_CTL_ALC_MAXATTN,
160 WM8776_CTL_ALC_HLD, 174 WM8776_CTL_ALC_HLD,
161 WM8776_CTL_NGT_SW, 175 WM8776_CTL_NGT_SW,
162 WM8776_CTL_NGT_THR, 176 WM8776_CTL_NGT_THR,
163 177
164 WM8776_CTL_COUNT, 178 WM8776_CTL_COUNT,
165 }; 179 };
166 180
167 #define WM8776_ENUM_MAX 16 181 #define WM8776_ENUM_MAX 16
168 182
169 #define WM8776_FLAG_STEREO (1 << 0) 183 #define WM8776_FLAG_STEREO (1 << 0)
170 #define WM8776_FLAG_VOL_UPDATE (1 << 1) 184 #define WM8776_FLAG_VOL_UPDATE (1 << 1)
171 #define WM8776_FLAG_INVERT (1 << 2) 185 #define WM8776_FLAG_INVERT (1 << 2)
172 #define WM8776_FLAG_LIM (1 << 3) 186 #define WM8776_FLAG_LIM (1 << 3)
173 #define WM8776_FLAG_ALC (1 << 4) 187 #define WM8776_FLAG_ALC (1 << 4)
174 188
175 struct snd_wm8776_ctl { 189 struct snd_wm8776_ctl {
176 const char *name; 190 const char *name;
177 snd_ctl_elem_type_t type; 191 snd_ctl_elem_type_t type;
178 const char *const enum_names[WM8776_EN 192 const char *const enum_names[WM8776_ENUM_MAX];
179 const unsigned int *tlv; 193 const unsigned int *tlv;
180 u16 reg1, reg2, mask1, mask2, min, max 194 u16 reg1, reg2, mask1, mask2, min, max, flags;
181 void (*set)(struct snd_wm8776 *wm, u16 195 void (*set)(struct snd_wm8776 *wm, u16 ch1, u16 ch2);
182 void (*get)(struct snd_wm8776 *wm, u16 196 void (*get)(struct snd_wm8776 *wm, u16 *ch1, u16 *ch2);
183 }; 197 };
184 198
185 enum snd_wm8776_agc_mode { 199 enum snd_wm8776_agc_mode {
186 WM8776_AGC_OFF, 200 WM8776_AGC_OFF,
187 WM8776_AGC_LIM, 201 WM8776_AGC_LIM,
188 WM8776_AGC_ALC_R, 202 WM8776_AGC_ALC_R,
189 WM8776_AGC_ALC_L, 203 WM8776_AGC_ALC_L,
190 WM8776_AGC_ALC_STEREO 204 WM8776_AGC_ALC_STEREO
191 }; 205 };
192 206
193 struct snd_wm8776 { 207 struct snd_wm8776 {
194 struct snd_card *card; 208 struct snd_card *card;
195 struct snd_wm8776_ctl ctl[WM8776_CTL_C 209 struct snd_wm8776_ctl ctl[WM8776_CTL_COUNT];
196 enum snd_wm8776_agc_mode agc_mode; 210 enum snd_wm8776_agc_mode agc_mode;
197 struct snd_wm8776_ops ops; 211 struct snd_wm8776_ops ops;
198 u16 regs[WM8776_REG_COUNT]; /* 9-b 212 u16 regs[WM8776_REG_COUNT]; /* 9-bit registers */
199 }; 213 };
200 214
201 215
202 216
203 void snd_wm8776_init(struct snd_wm8776 *wm); 217 void snd_wm8776_init(struct snd_wm8776 *wm);
204 void snd_wm8776_resume(struct snd_wm8776 *wm); 218 void snd_wm8776_resume(struct snd_wm8776 *wm);
205 void snd_wm8776_set_power(struct snd_wm8776 *w 219 void snd_wm8776_set_power(struct snd_wm8776 *wm, u16 power);
206 void snd_wm8776_volume_restore(struct snd_wm87 220 void snd_wm8776_volume_restore(struct snd_wm8776 *wm);
207 int snd_wm8776_build_controls(struct snd_wm877 221 int snd_wm8776_build_controls(struct snd_wm8776 *wm);
208 222
209 #endif /* __SOUND_WM8776_H */ 223 #endif /* __SOUND_WM8776_H */
210 224
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.