vmwgfx: Add comments for buffer pinning code
[linux-2.6.git] / sound / soc / codecs / wm8523.c
blob4fd4d8dca0fc0af31439371fbab9040794162095
1 /*
2 * wm8523.c -- WM8523 ALSA SoC Audio driver
4 * Copyright 2009 Wolfson Microelectronics plc
6 * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License version 2 as
11 * published by the Free Software Foundation.
14 #include <linux/module.h>
15 #include <linux/moduleparam.h>
16 #include <linux/init.h>
17 #include <linux/delay.h>
18 #include <linux/pm.h>
19 #include <linux/i2c.h>
20 #include <linux/platform_device.h>
21 #include <linux/regulator/consumer.h>
22 #include <linux/slab.h>
23 #include <sound/core.h>
24 #include <sound/pcm.h>
25 #include <sound/pcm_params.h>
26 #include <sound/soc.h>
27 #include <sound/initval.h>
28 #include <sound/tlv.h>
30 #include "wm8523.h"
32 #define WM8523_NUM_SUPPLIES 2
33 static const char *wm8523_supply_names[WM8523_NUM_SUPPLIES] = {
34 "AVDD",
35 "LINEVDD",
38 #define WM8523_NUM_RATES 7
40 /* codec private data */
41 struct wm8523_priv {
42 enum snd_soc_control_type control_type;
43 struct regulator_bulk_data supplies[WM8523_NUM_SUPPLIES];
44 unsigned int sysclk;
45 unsigned int rate_constraint_list[WM8523_NUM_RATES];
46 struct snd_pcm_hw_constraint_list rate_constraint;
49 static const u16 wm8523_reg[WM8523_REGISTER_COUNT] = {
50 0x8523, /* R0 - DEVICE_ID */
51 0x0001, /* R1 - REVISION */
52 0x0000, /* R2 - PSCTRL1 */
53 0x1812, /* R3 - AIF_CTRL1 */
54 0x0000, /* R4 - AIF_CTRL2 */
55 0x0001, /* R5 - DAC_CTRL3 */
56 0x0190, /* R6 - DAC_GAINL */
57 0x0190, /* R7 - DAC_GAINR */
58 0x0000, /* R8 - ZERO_DETECT */
61 static int wm8523_volatile_register(struct snd_soc_codec *codec, unsigned int reg)
63 switch (reg) {
64 case WM8523_DEVICE_ID:
65 case WM8523_REVISION:
66 return 1;
67 default:
68 return 0;
72 static int wm8523_reset(struct snd_soc_codec *codec)
74 return snd_soc_write(codec, WM8523_DEVICE_ID, 0);
77 static const DECLARE_TLV_DB_SCALE(dac_tlv, -10000, 25, 0);
79 static const char *wm8523_zd_count_text[] = {
80 "1024",
81 "2048",
84 static const struct soc_enum wm8523_zc_count =
85 SOC_ENUM_SINGLE(WM8523_ZERO_DETECT, 0, 2, wm8523_zd_count_text);
87 static const struct snd_kcontrol_new wm8523_snd_controls[] = {
88 SOC_DOUBLE_R_TLV("Playback Volume", WM8523_DAC_GAINL, WM8523_DAC_GAINR,
89 0, 448, 0, dac_tlv),
90 SOC_SINGLE("ZC Switch", WM8523_DAC_CTRL3, 4, 1, 0),
91 SOC_SINGLE("Playback Deemphasis Switch", WM8523_AIF_CTRL1, 8, 1, 0),
92 SOC_DOUBLE("Playback Switch", WM8523_DAC_CTRL3, 2, 3, 1, 1),
93 SOC_SINGLE("Volume Ramp Up Switch", WM8523_DAC_CTRL3, 1, 1, 0),
94 SOC_SINGLE("Volume Ramp Down Switch", WM8523_DAC_CTRL3, 0, 1, 0),
95 SOC_ENUM("Zero Detect Count", wm8523_zc_count),
98 static const struct snd_soc_dapm_widget wm8523_dapm_widgets[] = {
99 SND_SOC_DAPM_DAC("DAC", "Playback", SND_SOC_NOPM, 0, 0),
100 SND_SOC_DAPM_OUTPUT("LINEVOUTL"),
101 SND_SOC_DAPM_OUTPUT("LINEVOUTR"),
104 static const struct snd_soc_dapm_route intercon[] = {
105 { "LINEVOUTL", NULL, "DAC" },
106 { "LINEVOUTR", NULL, "DAC" },
109 static int wm8523_add_widgets(struct snd_soc_codec *codec)
111 struct snd_soc_dapm_context *dapm = &codec->dapm;
113 snd_soc_dapm_new_controls(dapm, wm8523_dapm_widgets,
114 ARRAY_SIZE(wm8523_dapm_widgets));
115 snd_soc_dapm_add_routes(dapm, intercon, ARRAY_SIZE(intercon));
117 return 0;
120 static struct {
121 int value;
122 int ratio;
123 } lrclk_ratios[WM8523_NUM_RATES] = {
124 { 1, 128 },
125 { 2, 192 },
126 { 3, 256 },
127 { 4, 384 },
128 { 5, 512 },
129 { 6, 768 },
130 { 7, 1152 },
133 static int wm8523_startup(struct snd_pcm_substream *substream,
134 struct snd_soc_dai *dai)
136 struct snd_soc_codec *codec = dai->codec;
137 struct wm8523_priv *wm8523 = snd_soc_codec_get_drvdata(codec);
139 /* The set of sample rates that can be supported depends on the
140 * MCLK supplied to the CODEC - enforce this.
142 if (!wm8523->sysclk) {
143 dev_err(codec->dev,
144 "No MCLK configured, call set_sysclk() on init\n");
145 return -EINVAL;
148 snd_pcm_hw_constraint_list(substream->runtime, 0,
149 SNDRV_PCM_HW_PARAM_RATE,
150 &wm8523->rate_constraint);
152 return 0;
155 static int wm8523_hw_params(struct snd_pcm_substream *substream,
156 struct snd_pcm_hw_params *params,
157 struct snd_soc_dai *dai)
159 struct snd_soc_pcm_runtime *rtd = substream->private_data;
160 struct snd_soc_codec *codec = rtd->codec;
161 struct wm8523_priv *wm8523 = snd_soc_codec_get_drvdata(codec);
162 int i;
163 u16 aifctrl1 = snd_soc_read(codec, WM8523_AIF_CTRL1);
164 u16 aifctrl2 = snd_soc_read(codec, WM8523_AIF_CTRL2);
166 /* Find a supported LRCLK ratio */
167 for (i = 0; i < ARRAY_SIZE(lrclk_ratios); i++) {
168 if (wm8523->sysclk / params_rate(params) ==
169 lrclk_ratios[i].ratio)
170 break;
173 /* Should never happen, should be handled by constraints */
174 if (i == ARRAY_SIZE(lrclk_ratios)) {
175 dev_err(codec->dev, "MCLK/fs ratio %d unsupported\n",
176 wm8523->sysclk / params_rate(params));
177 return -EINVAL;
180 aifctrl2 &= ~WM8523_SR_MASK;
181 aifctrl2 |= lrclk_ratios[i].value;
183 aifctrl1 &= ~WM8523_WL_MASK;
184 switch (params_format(params)) {
185 case SNDRV_PCM_FORMAT_S16_LE:
186 break;
187 case SNDRV_PCM_FORMAT_S20_3LE:
188 aifctrl1 |= 0x8;
189 break;
190 case SNDRV_PCM_FORMAT_S24_LE:
191 aifctrl1 |= 0x10;
192 break;
193 case SNDRV_PCM_FORMAT_S32_LE:
194 aifctrl1 |= 0x18;
195 break;
198 snd_soc_write(codec, WM8523_AIF_CTRL1, aifctrl1);
199 snd_soc_write(codec, WM8523_AIF_CTRL2, aifctrl2);
201 return 0;
204 static int wm8523_set_dai_sysclk(struct snd_soc_dai *codec_dai,
205 int clk_id, unsigned int freq, int dir)
207 struct snd_soc_codec *codec = codec_dai->codec;
208 struct wm8523_priv *wm8523 = snd_soc_codec_get_drvdata(codec);
209 unsigned int val;
210 int i;
212 wm8523->sysclk = freq;
214 wm8523->rate_constraint.count = 0;
215 for (i = 0; i < ARRAY_SIZE(lrclk_ratios); i++) {
216 val = freq / lrclk_ratios[i].ratio;
217 /* Check that it's a standard rate since core can't
218 * cope with others and having the odd rates confuses
219 * constraint matching.
221 switch (val) {
222 case 8000:
223 case 11025:
224 case 16000:
225 case 22050:
226 case 32000:
227 case 44100:
228 case 48000:
229 case 64000:
230 case 88200:
231 case 96000:
232 case 176400:
233 case 192000:
234 dev_dbg(codec->dev, "Supported sample rate: %dHz\n",
235 val);
236 wm8523->rate_constraint_list[i] = val;
237 wm8523->rate_constraint.count++;
238 break;
239 default:
240 dev_dbg(codec->dev, "Skipping sample rate: %dHz\n",
241 val);
245 /* Need at least one supported rate... */
246 if (wm8523->rate_constraint.count == 0)
247 return -EINVAL;
249 return 0;
253 static int wm8523_set_dai_fmt(struct snd_soc_dai *codec_dai,
254 unsigned int fmt)
256 struct snd_soc_codec *codec = codec_dai->codec;
257 u16 aifctrl1 = snd_soc_read(codec, WM8523_AIF_CTRL1);
259 aifctrl1 &= ~(WM8523_BCLK_INV_MASK | WM8523_LRCLK_INV_MASK |
260 WM8523_FMT_MASK | WM8523_AIF_MSTR_MASK);
262 switch (fmt & SND_SOC_DAIFMT_MASTER_MASK) {
263 case SND_SOC_DAIFMT_CBM_CFM:
264 aifctrl1 |= WM8523_AIF_MSTR;
265 break;
266 case SND_SOC_DAIFMT_CBS_CFS:
267 break;
268 default:
269 return -EINVAL;
272 switch (fmt & SND_SOC_DAIFMT_FORMAT_MASK) {
273 case SND_SOC_DAIFMT_I2S:
274 aifctrl1 |= 0x0002;
275 break;
276 case SND_SOC_DAIFMT_RIGHT_J:
277 break;
278 case SND_SOC_DAIFMT_LEFT_J:
279 aifctrl1 |= 0x0001;
280 break;
281 case SND_SOC_DAIFMT_DSP_A:
282 aifctrl1 |= 0x0003;
283 break;
284 case SND_SOC_DAIFMT_DSP_B:
285 aifctrl1 |= 0x0023;
286 break;
287 default:
288 return -EINVAL;
291 switch (fmt & SND_SOC_DAIFMT_INV_MASK) {
292 case SND_SOC_DAIFMT_NB_NF:
293 break;
294 case SND_SOC_DAIFMT_IB_IF:
295 aifctrl1 |= WM8523_BCLK_INV | WM8523_LRCLK_INV;
296 break;
297 case SND_SOC_DAIFMT_IB_NF:
298 aifctrl1 |= WM8523_BCLK_INV;
299 break;
300 case SND_SOC_DAIFMT_NB_IF:
301 aifctrl1 |= WM8523_LRCLK_INV;
302 break;
303 default:
304 return -EINVAL;
307 snd_soc_write(codec, WM8523_AIF_CTRL1, aifctrl1);
309 return 0;
312 static int wm8523_set_bias_level(struct snd_soc_codec *codec,
313 enum snd_soc_bias_level level)
315 struct wm8523_priv *wm8523 = snd_soc_codec_get_drvdata(codec);
316 u16 *reg_cache = codec->reg_cache;
317 int ret, i;
319 switch (level) {
320 case SND_SOC_BIAS_ON:
321 break;
323 case SND_SOC_BIAS_PREPARE:
324 /* Full power on */
325 snd_soc_update_bits(codec, WM8523_PSCTRL1,
326 WM8523_SYS_ENA_MASK, 3);
327 break;
329 case SND_SOC_BIAS_STANDBY:
330 if (codec->dapm.bias_level == SND_SOC_BIAS_OFF) {
331 ret = regulator_bulk_enable(ARRAY_SIZE(wm8523->supplies),
332 wm8523->supplies);
333 if (ret != 0) {
334 dev_err(codec->dev,
335 "Failed to enable supplies: %d\n",
336 ret);
337 return ret;
340 /* Initial power up */
341 snd_soc_update_bits(codec, WM8523_PSCTRL1,
342 WM8523_SYS_ENA_MASK, 1);
344 /* Sync back default/cached values */
345 for (i = WM8523_AIF_CTRL1;
346 i < WM8523_MAX_REGISTER; i++)
347 snd_soc_write(codec, i, reg_cache[i]);
350 msleep(100);
353 /* Power up to mute */
354 snd_soc_update_bits(codec, WM8523_PSCTRL1,
355 WM8523_SYS_ENA_MASK, 2);
357 break;
359 case SND_SOC_BIAS_OFF:
360 /* The chip runs through the power down sequence for us. */
361 snd_soc_update_bits(codec, WM8523_PSCTRL1,
362 WM8523_SYS_ENA_MASK, 0);
363 msleep(100);
365 regulator_bulk_disable(ARRAY_SIZE(wm8523->supplies),
366 wm8523->supplies);
367 break;
369 codec->dapm.bias_level = level;
370 return 0;
373 #define WM8523_RATES SNDRV_PCM_RATE_8000_192000
375 #define WM8523_FORMATS (SNDRV_PCM_FMTBIT_S16_LE | SNDRV_PCM_FMTBIT_S20_3LE |\
376 SNDRV_PCM_FMTBIT_S24_LE | SNDRV_PCM_FMTBIT_S32_LE)
378 static struct snd_soc_dai_ops wm8523_dai_ops = {
379 .startup = wm8523_startup,
380 .hw_params = wm8523_hw_params,
381 .set_sysclk = wm8523_set_dai_sysclk,
382 .set_fmt = wm8523_set_dai_fmt,
385 static struct snd_soc_dai_driver wm8523_dai = {
386 .name = "wm8523-hifi",
387 .playback = {
388 .stream_name = "Playback",
389 .channels_min = 2, /* Mono modes not yet supported */
390 .channels_max = 2,
391 .rates = WM8523_RATES,
392 .formats = WM8523_FORMATS,
394 .ops = &wm8523_dai_ops,
397 #ifdef CONFIG_PM
398 static int wm8523_suspend(struct snd_soc_codec *codec, pm_message_t state)
400 wm8523_set_bias_level(codec, SND_SOC_BIAS_OFF);
401 return 0;
404 static int wm8523_resume(struct snd_soc_codec *codec)
406 wm8523_set_bias_level(codec, SND_SOC_BIAS_STANDBY);
407 return 0;
409 #else
410 #define wm8523_suspend NULL
411 #define wm8523_resume NULL
412 #endif
414 static int wm8523_probe(struct snd_soc_codec *codec)
416 struct wm8523_priv *wm8523 = snd_soc_codec_get_drvdata(codec);
417 int ret, i;
419 codec->hw_write = (hw_write_t)i2c_master_send;
420 wm8523->rate_constraint.list = &wm8523->rate_constraint_list[0];
421 wm8523->rate_constraint.count =
422 ARRAY_SIZE(wm8523->rate_constraint_list);
424 ret = snd_soc_codec_set_cache_io(codec, 8, 16, wm8523->control_type);
425 if (ret != 0) {
426 dev_err(codec->dev, "Failed to set cache I/O: %d\n", ret);
427 return ret;
430 for (i = 0; i < ARRAY_SIZE(wm8523->supplies); i++)
431 wm8523->supplies[i].supply = wm8523_supply_names[i];
433 ret = regulator_bulk_get(codec->dev, ARRAY_SIZE(wm8523->supplies),
434 wm8523->supplies);
435 if (ret != 0) {
436 dev_err(codec->dev, "Failed to request supplies: %d\n", ret);
437 return ret;
440 ret = regulator_bulk_enable(ARRAY_SIZE(wm8523->supplies),
441 wm8523->supplies);
442 if (ret != 0) {
443 dev_err(codec->dev, "Failed to enable supplies: %d\n", ret);
444 goto err_get;
447 ret = snd_soc_read(codec, WM8523_DEVICE_ID);
448 if (ret < 0) {
449 dev_err(codec->dev, "Failed to read ID register\n");
450 goto err_enable;
452 if (ret != wm8523_reg[WM8523_DEVICE_ID]) {
453 dev_err(codec->dev, "Device is not a WM8523, ID is %x\n", ret);
454 ret = -EINVAL;
455 goto err_enable;
458 ret = snd_soc_read(codec, WM8523_REVISION);
459 if (ret < 0) {
460 dev_err(codec->dev, "Failed to read revision register\n");
461 goto err_enable;
463 dev_info(codec->dev, "revision %c\n",
464 (ret & WM8523_CHIP_REV_MASK) + 'A');
466 ret = wm8523_reset(codec);
467 if (ret < 0) {
468 dev_err(codec->dev, "Failed to issue reset\n");
469 goto err_enable;
472 /* Change some default settings - latch VU and enable ZC */
473 snd_soc_update_bits(codec, WM8523_DAC_GAINR,
474 WM8523_DACR_VU, WM8523_DACR_VU);
475 snd_soc_update_bits(codec, WM8523_DAC_CTRL3, WM8523_ZC, WM8523_ZC);
477 wm8523_set_bias_level(codec, SND_SOC_BIAS_STANDBY);
479 /* Bias level configuration will have done an extra enable */
480 regulator_bulk_disable(ARRAY_SIZE(wm8523->supplies), wm8523->supplies);
482 snd_soc_add_controls(codec, wm8523_snd_controls,
483 ARRAY_SIZE(wm8523_snd_controls));
484 wm8523_add_widgets(codec);
486 return 0;
488 err_enable:
489 regulator_bulk_disable(ARRAY_SIZE(wm8523->supplies), wm8523->supplies);
490 err_get:
491 regulator_bulk_free(ARRAY_SIZE(wm8523->supplies), wm8523->supplies);
493 return ret;
496 static int wm8523_remove(struct snd_soc_codec *codec)
498 struct wm8523_priv *wm8523 = snd_soc_codec_get_drvdata(codec);
500 wm8523_set_bias_level(codec, SND_SOC_BIAS_OFF);
501 regulator_bulk_free(ARRAY_SIZE(wm8523->supplies), wm8523->supplies);
502 return 0;
505 static struct snd_soc_codec_driver soc_codec_dev_wm8523 = {
506 .probe = wm8523_probe,
507 .remove = wm8523_remove,
508 .suspend = wm8523_suspend,
509 .resume = wm8523_resume,
510 .set_bias_level = wm8523_set_bias_level,
511 .reg_cache_size = WM8523_REGISTER_COUNT,
512 .reg_word_size = sizeof(u16),
513 .reg_cache_default = wm8523_reg,
514 .volatile_register = wm8523_volatile_register,
517 #if defined(CONFIG_I2C) || defined(CONFIG_I2C_MODULE)
518 static __devinit int wm8523_i2c_probe(struct i2c_client *i2c,
519 const struct i2c_device_id *id)
521 struct wm8523_priv *wm8523;
522 int ret;
524 wm8523 = kzalloc(sizeof(struct wm8523_priv), GFP_KERNEL);
525 if (wm8523 == NULL)
526 return -ENOMEM;
528 i2c_set_clientdata(i2c, wm8523);
529 wm8523->control_type = SND_SOC_I2C;
531 ret = snd_soc_register_codec(&i2c->dev,
532 &soc_codec_dev_wm8523, &wm8523_dai, 1);
533 if (ret < 0)
534 kfree(wm8523);
535 return ret;
539 static __devexit int wm8523_i2c_remove(struct i2c_client *client)
541 snd_soc_unregister_codec(&client->dev);
542 kfree(i2c_get_clientdata(client));
543 return 0;
546 static const struct i2c_device_id wm8523_i2c_id[] = {
547 { "wm8523", 0 },
550 MODULE_DEVICE_TABLE(i2c, wm8523_i2c_id);
552 static struct i2c_driver wm8523_i2c_driver = {
553 .driver = {
554 .name = "wm8523-codec",
555 .owner = THIS_MODULE,
557 .probe = wm8523_i2c_probe,
558 .remove = __devexit_p(wm8523_i2c_remove),
559 .id_table = wm8523_i2c_id,
561 #endif
563 static int __init wm8523_modinit(void)
565 int ret;
566 #if defined(CONFIG_I2C) || defined(CONFIG_I2C_MODULE)
567 ret = i2c_add_driver(&wm8523_i2c_driver);
568 if (ret != 0) {
569 printk(KERN_ERR "Failed to register WM8523 I2C driver: %d\n",
570 ret);
572 #endif
573 return 0;
575 module_init(wm8523_modinit);
577 static void __exit wm8523_exit(void)
579 #if defined(CONFIG_I2C) || defined(CONFIG_I2C_MODULE)
580 i2c_del_driver(&wm8523_i2c_driver);
581 #endif
583 module_exit(wm8523_exit);
585 MODULE_DESCRIPTION("ASoC WM8523 driver");
586 MODULE_AUTHOR("Mark Brown <broonie@opensource.wolfsonmicro.com>");
587 MODULE_LICENSE("GPL");