x86/speculation/mds: Fix documentation typo
[linux/fpc-iii.git] / sound / soc / codecs / cs35l35.h
blob621bfef70d03668883f281d86cce73389120e810
1 /*
2 * cs35l35.h -- CS35L35 ALSA SoC audio driver
4 * Copyright 2016 Cirrus Logic, Inc.
6 * Author: Brian Austin <brian.austin@cirrus.com>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
14 #ifndef __CS35L35_H__
15 #define __CS35L35_H__
17 #define CS35L35_FIRSTREG 0x01
18 #define CS35L35_LASTREG 0x7E
19 #define CS35L35_CHIP_ID 0x00035A35
20 #define CS35L35_DEVID_AB 0x01 /* Device ID A & B [RO] */
21 #define CS35L35_DEVID_CD 0x02 /* Device ID C & D [RO] */
22 #define CS35L35_DEVID_E 0x03 /* Device ID E [RO] */
23 #define CS35L35_FAB_ID 0x04 /* Fab ID [RO] */
24 #define CS35L35_REV_ID 0x05 /* Revision ID [RO] */
25 #define CS35L35_PWRCTL1 0x06 /* Power Ctl 1 */
26 #define CS35L35_PWRCTL2 0x07 /* Power Ctl 2 */
27 #define CS35L35_PWRCTL3 0x08 /* Power Ctl 3 */
28 #define CS35L35_CLK_CTL1 0x0A /* Clocking Ctl 1 */
29 #define CS35L35_CLK_CTL2 0x0B /* Clocking Ctl 2 */
30 #define CS35L35_CLK_CTL3 0x0C /* Clocking Ctl 3 */
31 #define CS35L35_SP_FMT_CTL1 0x0D /* Serial Port Format CTL1 */
32 #define CS35L35_SP_FMT_CTL2 0x0E /* Serial Port Format CTL2 */
33 #define CS35L35_SP_FMT_CTL3 0x0F /* Serial Port Format CTL3 */
34 #define CS35L35_MAG_COMP_CTL 0x13 /* Magnitude Comp CTL */
35 #define CS35L35_AMP_INP_DRV_CTL 0x14 /* Amp Input Drive Ctl */
36 #define CS35L35_AMP_DIG_VOL_CTL 0x15 /* Amplifier Dig Volume Ctl */
37 #define CS35L35_AMP_DIG_VOL 0x16 /* Amplifier Dig Volume */
38 #define CS35L35_ADV_DIG_VOL 0x17 /* Advisory Digital Volume */
39 #define CS35L35_PROTECT_CTL 0x18 /* Amp Gain - Prot Ctl Param */
40 #define CS35L35_AMP_GAIN_AUD_CTL 0x19 /* Amp Serial Port Gain Ctl */
41 #define CS35L35_AMP_GAIN_PDM_CTL 0x1A /* Amplifier Gain PDM Ctl */
42 #define CS35L35_AMP_GAIN_ADV_CTL 0x1B /* Amplifier Gain Ctl */
43 #define CS35L35_GPI_CTL 0x1C /* GPI Ctl */
44 #define CS35L35_BST_CVTR_V_CTL 0x1D /* Boost Conv Voltage Ctl */
45 #define CS35L35_BST_PEAK_I 0x1E /* Boost Conv Peak Current */
46 #define CS35L35_BST_RAMP_CTL 0x20 /* Boost Conv Soft Ramp Ctl */
47 #define CS35L35_BST_CONV_COEF_1 0x21 /* Boost Conv Coefficients 1 */
48 #define CS35L35_BST_CONV_COEF_2 0x22 /* Boost Conv Coefficients 2 */
49 #define CS35L35_BST_CONV_SLOPE_COMP 0x23 /* Boost Conv Slope Comp */
50 #define CS35L35_BST_CONV_SW_FREQ 0x24 /* Boost Conv L BST SW Freq */
51 #define CS35L35_CLASS_H_CTL 0x30 /* CLS H Control */
52 #define CS35L35_CLASS_H_HEADRM_CTL 0x31 /* CLS H Headroom Ctl */
53 #define CS35L35_CLASS_H_RELEASE_RATE 0x32 /* CLS H Release Rate */
54 #define CS35L35_CLASS_H_FET_DRIVE_CTL 0x33 /* CLS H Weak FET Drive Ctl */
55 #define CS35L35_CLASS_H_VP_CTL 0x34 /* CLS H VP Ctl */
56 #define CS35L35_CLASS_H_STATUS 0x38 /* CLS H Status */
57 #define CS35L35_VPBR_CTL 0x3A /* VPBR Ctl */
58 #define CS35L35_VPBR_VOL_CTL 0x3B /* VPBR Volume Ctl */
59 #define CS35L35_VPBR_TIMING_CTL 0x3C /* VPBR Timing Ctl */
60 #define CS35L35_VPBR_MODE_VOL_CTL 0x3D /* VPBR Mode/Attack Vol Ctl */
61 #define CS35L35_VPBR_ATTEN_STATUS 0x4B /* VPBR Attenuation Status */
62 #define CS35L35_SPKR_MON_CTL 0x4E /* Speaker Monitoring Ctl */
63 #define CS35L35_IMON_SCALE_CTL 0x51 /* IMON Scale Ctl */
64 #define CS35L35_AUDIN_RXLOC_CTL 0x52 /* Audio Input RX Loc Ctl */
65 #define CS35L35_ADVIN_RXLOC_CTL 0x53 /* Advisory Input RX Loc Ctl */
66 #define CS35L35_VMON_TXLOC_CTL 0x54 /* VMON TX Loc Ctl */
67 #define CS35L35_IMON_TXLOC_CTL 0x55 /* IMON TX Loc Ctl */
68 #define CS35L35_VPMON_TXLOC_CTL 0x56 /* VPMON TX Loc Ctl */
69 #define CS35L35_VBSTMON_TXLOC_CTL 0x57 /* VBSTMON TX Loc Ctl */
70 #define CS35L35_VPBR_STATUS_TXLOC_CTL 0x58 /* VPBR Status TX Loc Ctl */
71 #define CS35L35_ZERO_FILL_LOC_CTL 0x59 /* Zero Fill Loc Ctl */
72 #define CS35L35_AUDIN_DEPTH_CTL 0x5A /* Audio Input Depth Ctl */
73 #define CS35L35_SPKMON_DEPTH_CTL 0x5B /* SPK Mon Output Depth Ctl */
74 #define CS35L35_SUPMON_DEPTH_CTL 0x5C /* Supply Mon Out Depth Ctl */
75 #define CS35L35_ZEROFILL_DEPTH_CTL 0x5D /* Zero Fill Mon Output Ctl */
76 #define CS35L35_MULT_DEV_SYNCH1 0x62 /* Multidevice Synch */
77 #define CS35L35_MULT_DEV_SYNCH2 0x63 /* Multidevice Synch 2 */
78 #define CS35L35_PROT_RELEASE_CTL 0x64 /* Protection Release Ctl */
79 #define CS35L35_DIAG_MODE_REG_LOCK 0x68 /* Diagnostic Mode Reg Lock */
80 #define CS35L35_DIAG_MODE_CTL_1 0x69 /* Diagnostic Mode Ctl 1 */
81 #define CS35L35_DIAG_MODE_CTL_2 0x6A /* Diagnostic Mode Ctl 2 */
82 #define CS35L35_INT_MASK_1 0x70 /* Interrupt Mask 1 */
83 #define CS35L35_INT_MASK_2 0x71 /* Interrupt Mask 2 */
84 #define CS35L35_INT_MASK_3 0x72 /* Interrupt Mask 3 */
85 #define CS35L35_INT_MASK_4 0x73 /* Interrupt Mask 4 */
86 #define CS35L35_INT_STATUS_1 0x74 /* Interrupt Status 1 */
87 #define CS35L35_INT_STATUS_2 0x75 /* Interrupt Status 2 */
88 #define CS35L35_INT_STATUS_3 0x76 /* Interrupt Status 3 */
89 #define CS35L35_INT_STATUS_4 0x77 /* Interrupt Status 4 */
90 #define CS35L35_PLL_STATUS 0x78 /* PLL Status */
91 #define CS35L35_OTP_TRIM_STATUS 0x7E /* OTP Trim Status */
93 #define CS35L35_MAX_REGISTER 0x7F
95 /* CS35L35_PWRCTL1 */
96 #define CS35L35_SFT_RST 0x80
97 #define CS35L35_DISCHG_FLT 0x02
98 #define CS35L35_PDN_ALL 0x01
100 /* CS35L35_PWRCTL2 */
101 #define CS35L35_PDN_VMON 0x80
102 #define CS35L35_PDN_IMON 0x40
103 #define CS35L35_PDN_CLASSH 0x20
104 #define CS35L35_PDN_VPBR 0x10
105 #define CS35L35_PDN_BST 0x04
106 #define CS35L35_PDN_AMP 0x01
108 /* CS35L35_PWRCTL3 */
109 #define CS35L35_PDN_VBSTMON_OUT 0x10
110 #define CS35L35_PDN_VMON_OUT 0x08
112 #define CS35L35_AUDIN_DEPTH_MASK 0x03
113 #define CS35L35_AUDIN_DEPTH_SHIFT 0
114 #define CS35L35_ADVIN_DEPTH_MASK 0x0C
115 #define CS35L35_ADVIN_DEPTH_SHIFT 2
116 #define CS35L35_SDIN_DEPTH_8 0x01
117 #define CS35L35_SDIN_DEPTH_16 0x02
118 #define CS35L35_SDIN_DEPTH_24 0x03
120 #define CS35L35_SDOUT_DEPTH_8 0x01
121 #define CS35L35_SDOUT_DEPTH_12 0x02
122 #define CS35L35_SDOUT_DEPTH_16 0x03
124 #define CS35L35_AUD_IN_LR_MASK 0x80
125 #define CS35L35_AUD_IN_LR_SHIFT 7
126 #define CS35L35_ADV_IN_LR_MASK 0x80
127 #define CS35L35_ADV_IN_LR_SHIFT 7
128 #define CS35L35_AUD_IN_LOC_MASK 0x0F
129 #define CS35L35_AUD_IN_LOC_SHIFT 0
130 #define CS35L35_ADV_IN_LOC_MASK 0x0F
131 #define CS35L35_ADV_IN_LOC_SHIFT 0
133 #define CS35L35_IMON_DEPTH_MASK 0x03
134 #define CS35L35_IMON_DEPTH_SHIFT 0
135 #define CS35L35_VMON_DEPTH_MASK 0x0C
136 #define CS35L35_VMON_DEPTH_SHIFT 2
137 #define CS35L35_VBSTMON_DEPTH_MASK 0x03
138 #define CS35L35_VBSTMON_DEPTH_SHIFT 0
139 #define CS35L35_VPMON_DEPTH_MASK 0x0C
140 #define CS35L35_VPMON_DEPTH_SHIFT 2
141 #define CS35L35_VPBRSTAT_DEPTH_MASK 0x30
142 #define CS35L35_VPBRSTAT_DEPTH_SHIFT 4
143 #define CS35L35_ZEROFILL_DEPTH_MASK 0x03
144 #define CS35L35_ZEROFILL_DEPTH_SHIFT 0x00
146 #define CS35L35_MON_TXLOC_MASK 0x3F
147 #define CS35L35_MON_TXLOC_SHIFT 0
148 #define CS35L35_MON_FRM_MASK 0x80
149 #define CS35L35_MON_FRM_SHIFT 7
151 #define CS35L35_IMON_SCALE_MASK 0xF8
152 #define CS35L35_IMON_SCALE_SHIFT 3
154 #define CS35L35_MS_MASK 0x80
155 #define CS35L35_MS_SHIFT 7
156 #define CS35L35_SPMODE_MASK 0x40
157 #define CS35L35_SP_DRV_MASK 0x10
158 #define CS35L35_SP_DRV_SHIFT 4
159 #define CS35L35_CLK_CTL2_MASK 0xFF
160 #define CS35L35_PDM_MODE_MASK 0x40
161 #define CS35L35_PDM_MODE_SHIFT 6
162 #define CS35L35_CLK_SOURCE_MASK 0x03
163 #define CS35L35_CLK_SOURCE_SHIFT 0
164 #define CS35L35_CLK_SOURCE_MCLK 0
165 #define CS35L35_CLK_SOURCE_SCLK 1
166 #define CS35L35_CLK_SOURCE_PDM 2
168 #define CS35L35_SP_SCLKS_MASK 0x0F
169 #define CS35L35_SP_SCLKS_SHIFT 0x00
170 #define CS35L35_SP_SCLKS_16FS 0x03
171 #define CS35L35_SP_SCLKS_32FS 0x07
172 #define CS35L35_SP_SCLKS_48FS 0x0B
173 #define CS35L35_SP_SCLKS_64FS 0x0F
174 #define CS35L35_SP_RATE_MASK 0xC0
176 #define CS35L35_PDN_BST_MASK 0x06
177 #define CS35L35_PDN_BST_FETON_SHIFT 1
178 #define CS35L35_PDN_BST_FETOFF_SHIFT 2
179 #define CS35L35_PWR2_PDN_MASK 0xE0
180 #define CS35L35_PWR3_PDN_MASK 0x1E
181 #define CS35L35_PDN_ALL_MASK 0x01
182 #define CS35L35_DISCHG_FILT_MASK 0x02
183 #define CS35L35_DISCHG_FILT_SHIFT 1
184 #define CS35L35_MCLK_DIS_MASK 0x04
185 #define CS35L35_MCLK_DIS_SHIFT 2
187 #define CS35L35_BST_CTL_MASK 0x7F
188 #define CS35L35_BST_CTL_SHIFT 0
189 #define CS35L35_BST_IPK_MASK 0x1F
190 #define CS35L35_BST_IPK_SHIFT 0
191 #define CS35L35_AMP_MUTE_MASK 0x20
192 #define CS35L35_AMP_MUTE_SHIFT 5
193 #define CS35L35_AMP_GAIN_ZC_MASK 0x10
194 #define CS35L35_AMP_GAIN_ZC_SHIFT 4
196 #define CS35L35_AMP_DIGSFT_MASK 0x02
197 #define CS35L35_AMP_DIGSFT_SHIFT 1
199 /* CS35L35_SP_FMT_CTL3 */
200 #define CS35L35_SP_I2S_DRV_MASK 0x03
201 #define CS35L35_SP_I2S_DRV_SHIFT 0
203 /* Boost Converter Config */
204 #define CS35L35_BST_CONV_COEFF_MASK 0xFF
205 #define CS35L35_BST_CONV_SLOPE_MASK 0xFF
206 #define CS35L35_BST_CONV_LBST_MASK 0x03
207 #define CS35L35_BST_CONV_SWFREQ_MASK 0xF0
209 /* Class H Algorithm Control */
210 #define CS35L35_CH_STEREO_MASK 0x40
211 #define CS35L35_CH_STEREO_SHIFT 6
212 #define CS35L35_CH_BST_OVR_MASK 0x04
213 #define CS35L35_CH_BST_OVR_SHIFT 2
214 #define CS35L35_CH_BST_LIM_MASK 0x08
215 #define CS35L35_CH_BST_LIM_SHIFT 3
216 #define CS35L35_CH_MEM_DEPTH_MASK 0x01
217 #define CS35L35_CH_MEM_DEPTH_SHIFT 0
218 #define CS35L35_CH_HDRM_CTL_MASK 0x3F
219 #define CS35L35_CH_HDRM_CTL_SHIFT 0
220 #define CS35L35_CH_REL_RATE_MASK 0xFF
221 #define CS35L35_CH_REL_RATE_SHIFT 0
222 #define CS35L35_CH_WKFET_DIS_MASK 0x80
223 #define CS35L35_CH_WKFET_DIS_SHIFT 7
224 #define CS35L35_CH_WKFET_DEL_MASK 0x70
225 #define CS35L35_CH_WKFET_DEL_SHIFT 4
226 #define CS35L35_CH_WKFET_THLD_MASK 0x0F
227 #define CS35L35_CH_WKFET_THLD_SHIFT 0
228 #define CS35L35_CH_VP_AUTO_MASK 0x80
229 #define CS35L35_CH_VP_AUTO_SHIFT 7
230 #define CS35L35_CH_VP_RATE_MASK 0x60
231 #define CS35L35_CH_VP_RATE_SHIFT 5
232 #define CS35L35_CH_VP_MAN_MASK 0x1F
233 #define CS35L35_CH_VP_MAN_SHIFT 0
235 /* CS35L35_PROT_RELEASE_CTL */
236 #define CS35L35_CAL_ERR_RLS 0x80
237 #define CS35L35_SHORT_RLS 0x04
238 #define CS35L35_OTW_RLS 0x02
239 #define CS35L35_OTE_RLS 0x01
241 /* INT Mask Registers */
242 #define CS35L35_INT1_CRIT_MASK 0x38
243 #define CS35L35_INT2_CRIT_MASK 0xEF
244 #define CS35L35_INT3_CRIT_MASK 0xEE
245 #define CS35L35_INT4_CRIT_MASK 0xFF
247 /* PDN DONE Masks */
248 #define CS35L35_M_PDN_DONE_SHIFT 4
249 #define CS35L35_M_PDN_DONE_MASK 0x10
251 /* CS35L35_INT_1 */
252 #define CS35L35_CAL_ERR 0x80
253 #define CS35L35_OTP_ERR 0x40
254 #define CS35L35_LRCLK_ERR 0x20
255 #define CS35L35_SPCLK_ERR 0x10
256 #define CS35L35_MCLK_ERR 0x08
257 #define CS35L35_AMP_SHORT 0x04
258 #define CS35L35_OTW 0x02
259 #define CS35L35_OTE 0x01
261 /* CS35L35_INT_2 */
262 #define CS35L35_PDN_DONE 0x10
263 #define CS35L35_VPBR_ERR 0x02
264 #define CS35L35_VPBR_CLR 0x01
266 /* CS35L35_INT_3 */
267 #define CS35L35_BST_HIGH 0x10
268 #define CS35L35_BST_HIGH_FLAG 0x08
269 #define CS35L35_BST_IPK_FLAG 0x04
270 #define CS35L35_LBST_SHORT 0x01
272 /* CS35L35_INT_4 */
273 #define CS35L35_VMON_OVFL 0x08
274 #define CS35L35_IMON_OVFL 0x04
276 #define CS35L35_FORMATS (SNDRV_PCM_FMTBIT_U8 | SNDRV_PCM_FMTBIT_S16_LE | \
277 SNDRV_PCM_FMTBIT_S24_LE | SNDRV_PCM_FMTBIT_S32_LE)
279 struct cs35l35_private {
280 struct device *dev;
281 struct cs35l35_platform_data pdata;
282 struct regmap *regmap;
283 struct regulator_bulk_data supplies[2];
284 int num_supplies;
285 int sysclk;
286 int sclk;
287 bool pdm_mode;
288 bool i2s_mode;
289 bool slave_mode;
290 /* GPIO for /RST */
291 struct gpio_desc *reset_gpio;
292 struct completion pdn_done;
295 static const char * const cs35l35_supplies[] = {
296 "VA",
297 "VP",
300 #endif