xref: /openbmc/linux/sound/soc/soc-ops.c (revision fbb6b31a)
1 // SPDX-License-Identifier: GPL-2.0+
2 //
3 // soc-ops.c  --  Generic ASoC operations
4 //
5 // Copyright 2005 Wolfson Microelectronics PLC.
6 // Copyright 2005 Openedhand Ltd.
7 // Copyright (C) 2010 Slimlogic Ltd.
8 // Copyright (C) 2010 Texas Instruments Inc.
9 //
10 // Author: Liam Girdwood <lrg@slimlogic.co.uk>
11 //         with code, comments and ideas from :-
12 //         Richard Purdie <richard@openedhand.com>
13 
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/bitops.h>
20 #include <linux/ctype.h>
21 #include <linux/slab.h>
22 #include <sound/core.h>
23 #include <sound/jack.h>
24 #include <sound/pcm.h>
25 #include <sound/pcm_params.h>
26 #include <sound/soc.h>
27 #include <sound/soc-dpcm.h>
28 #include <sound/initval.h>
29 
30 /**
31  * snd_soc_info_enum_double - enumerated double mixer info callback
32  * @kcontrol: mixer control
33  * @uinfo: control element information
34  *
35  * Callback to provide information about a double enumerated
36  * mixer control.
37  *
38  * Returns 0 for success.
39  */
40 int snd_soc_info_enum_double(struct snd_kcontrol *kcontrol,
41 	struct snd_ctl_elem_info *uinfo)
42 {
43 	struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
44 
45 	return snd_ctl_enum_info(uinfo, e->shift_l == e->shift_r ? 1 : 2,
46 				 e->items, e->texts);
47 }
48 EXPORT_SYMBOL_GPL(snd_soc_info_enum_double);
49 
50 /**
51  * snd_soc_get_enum_double - enumerated double mixer get callback
52  * @kcontrol: mixer control
53  * @ucontrol: control element information
54  *
55  * Callback to get the value of a double enumerated mixer.
56  *
57  * Returns 0 for success.
58  */
59 int snd_soc_get_enum_double(struct snd_kcontrol *kcontrol,
60 	struct snd_ctl_elem_value *ucontrol)
61 {
62 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
63 	struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
64 	unsigned int val, item;
65 	unsigned int reg_val;
66 
67 	reg_val = snd_soc_component_read(component, e->reg);
68 	val = (reg_val >> e->shift_l) & e->mask;
69 	item = snd_soc_enum_val_to_item(e, val);
70 	ucontrol->value.enumerated.item[0] = item;
71 	if (e->shift_l != e->shift_r) {
72 		val = (reg_val >> e->shift_r) & e->mask;
73 		item = snd_soc_enum_val_to_item(e, val);
74 		ucontrol->value.enumerated.item[1] = item;
75 	}
76 
77 	return 0;
78 }
79 EXPORT_SYMBOL_GPL(snd_soc_get_enum_double);
80 
81 /**
82  * snd_soc_put_enum_double - enumerated double mixer put callback
83  * @kcontrol: mixer control
84  * @ucontrol: control element information
85  *
86  * Callback to set the value of a double enumerated mixer.
87  *
88  * Returns 0 for success.
89  */
90 int snd_soc_put_enum_double(struct snd_kcontrol *kcontrol,
91 	struct snd_ctl_elem_value *ucontrol)
92 {
93 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
94 	struct soc_enum *e = (struct soc_enum *)kcontrol->private_value;
95 	unsigned int *item = ucontrol->value.enumerated.item;
96 	unsigned int val;
97 	unsigned int mask;
98 
99 	if (item[0] >= e->items)
100 		return -EINVAL;
101 	val = snd_soc_enum_item_to_val(e, item[0]) << e->shift_l;
102 	mask = e->mask << e->shift_l;
103 	if (e->shift_l != e->shift_r) {
104 		if (item[1] >= e->items)
105 			return -EINVAL;
106 		val |= snd_soc_enum_item_to_val(e, item[1]) << e->shift_r;
107 		mask |= e->mask << e->shift_r;
108 	}
109 
110 	return snd_soc_component_update_bits(component, e->reg, mask, val);
111 }
112 EXPORT_SYMBOL_GPL(snd_soc_put_enum_double);
113 
114 /**
115  * snd_soc_read_signed - Read a codec register and interpret as signed value
116  * @component: component
117  * @reg: Register to read
118  * @mask: Mask to use after shifting the register value
119  * @shift: Right shift of register value
120  * @sign_bit: Bit that describes if a number is negative or not.
121  * @signed_val: Pointer to where the read value should be stored
122  *
123  * This functions reads a codec register. The register value is shifted right
124  * by 'shift' bits and masked with the given 'mask'. Afterwards it translates
125  * the given registervalue into a signed integer if sign_bit is non-zero.
126  *
127  * Returns 0 on sucess, otherwise an error value
128  */
129 static int snd_soc_read_signed(struct snd_soc_component *component,
130 	unsigned int reg, unsigned int mask, unsigned int shift,
131 	unsigned int sign_bit, int *signed_val)
132 {
133 	int ret;
134 	unsigned int val;
135 
136 	val = snd_soc_component_read(component, reg);
137 	val = (val >> shift) & mask;
138 
139 	if (!sign_bit) {
140 		*signed_val = val;
141 		return 0;
142 	}
143 
144 	/* non-negative number */
145 	if (!(val & BIT(sign_bit))) {
146 		*signed_val = val;
147 		return 0;
148 	}
149 
150 	ret = val;
151 
152 	/*
153 	 * The register most probably does not contain a full-sized int.
154 	 * Instead we have an arbitrary number of bits in a signed
155 	 * representation which has to be translated into a full-sized int.
156 	 * This is done by filling up all bits above the sign-bit.
157 	 */
158 	ret |= ~((int)(BIT(sign_bit) - 1));
159 
160 	*signed_val = ret;
161 
162 	return 0;
163 }
164 
165 /**
166  * snd_soc_info_volsw - single mixer info callback
167  * @kcontrol: mixer control
168  * @uinfo: control element information
169  *
170  * Callback to provide information about a single mixer control, or a double
171  * mixer control that spans 2 registers.
172  *
173  * Returns 0 for success.
174  */
175 int snd_soc_info_volsw(struct snd_kcontrol *kcontrol,
176 	struct snd_ctl_elem_info *uinfo)
177 {
178 	struct soc_mixer_control *mc =
179 		(struct soc_mixer_control *)kcontrol->private_value;
180 	int platform_max;
181 
182 	if (!mc->platform_max)
183 		mc->platform_max = mc->max;
184 	platform_max = mc->platform_max;
185 
186 	if (platform_max == 1 && !strstr(kcontrol->id.name, " Volume"))
187 		uinfo->type = SNDRV_CTL_ELEM_TYPE_BOOLEAN;
188 	else
189 		uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
190 
191 	uinfo->count = snd_soc_volsw_is_stereo(mc) ? 2 : 1;
192 	uinfo->value.integer.min = 0;
193 	uinfo->value.integer.max = platform_max - mc->min;
194 	return 0;
195 }
196 EXPORT_SYMBOL_GPL(snd_soc_info_volsw);
197 
198 /**
199  * snd_soc_info_volsw_sx - Mixer info callback for SX TLV controls
200  * @kcontrol: mixer control
201  * @uinfo: control element information
202  *
203  * Callback to provide information about a single mixer control, or a double
204  * mixer control that spans 2 registers of the SX TLV type. SX TLV controls
205  * have a range that represents both positive and negative values either side
206  * of zero but without a sign bit.
207  *
208  * Returns 0 for success.
209  */
210 int snd_soc_info_volsw_sx(struct snd_kcontrol *kcontrol,
211 			  struct snd_ctl_elem_info *uinfo)
212 {
213 	struct soc_mixer_control *mc =
214 		(struct soc_mixer_control *)kcontrol->private_value;
215 
216 	snd_soc_info_volsw(kcontrol, uinfo);
217 	/* Max represents the number of levels in an SX control not the
218 	 * maximum value, so add the minimum value back on
219 	 */
220 	uinfo->value.integer.max += mc->min;
221 
222 	return 0;
223 }
224 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_sx);
225 
226 /**
227  * snd_soc_get_volsw - single mixer get callback
228  * @kcontrol: mixer control
229  * @ucontrol: control element information
230  *
231  * Callback to get the value of a single mixer control, or a double mixer
232  * control that spans 2 registers.
233  *
234  * Returns 0 for success.
235  */
236 int snd_soc_get_volsw(struct snd_kcontrol *kcontrol,
237 	struct snd_ctl_elem_value *ucontrol)
238 {
239 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
240 	struct soc_mixer_control *mc =
241 		(struct soc_mixer_control *)kcontrol->private_value;
242 	unsigned int reg = mc->reg;
243 	unsigned int reg2 = mc->rreg;
244 	unsigned int shift = mc->shift;
245 	unsigned int rshift = mc->rshift;
246 	int max = mc->max;
247 	int min = mc->min;
248 	int sign_bit = mc->sign_bit;
249 	unsigned int mask = (1 << fls(max)) - 1;
250 	unsigned int invert = mc->invert;
251 	int val;
252 	int ret;
253 
254 	if (sign_bit)
255 		mask = BIT(sign_bit + 1) - 1;
256 
257 	ret = snd_soc_read_signed(component, reg, mask, shift, sign_bit, &val);
258 	if (ret)
259 		return ret;
260 
261 	ucontrol->value.integer.value[0] = val - min;
262 	if (invert)
263 		ucontrol->value.integer.value[0] =
264 			max - ucontrol->value.integer.value[0];
265 
266 	if (snd_soc_volsw_is_stereo(mc)) {
267 		if (reg == reg2)
268 			ret = snd_soc_read_signed(component, reg, mask, rshift,
269 				sign_bit, &val);
270 		else
271 			ret = snd_soc_read_signed(component, reg2, mask, shift,
272 				sign_bit, &val);
273 		if (ret)
274 			return ret;
275 
276 		ucontrol->value.integer.value[1] = val - min;
277 		if (invert)
278 			ucontrol->value.integer.value[1] =
279 				max - ucontrol->value.integer.value[1];
280 	}
281 
282 	return 0;
283 }
284 EXPORT_SYMBOL_GPL(snd_soc_get_volsw);
285 
286 /**
287  * snd_soc_put_volsw - single mixer put callback
288  * @kcontrol: mixer control
289  * @ucontrol: control element information
290  *
291  * Callback to set the value of a single mixer control, or a double mixer
292  * control that spans 2 registers.
293  *
294  * Returns 0 for success.
295  */
296 int snd_soc_put_volsw(struct snd_kcontrol *kcontrol,
297 	struct snd_ctl_elem_value *ucontrol)
298 {
299 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
300 	struct soc_mixer_control *mc =
301 		(struct soc_mixer_control *)kcontrol->private_value;
302 	unsigned int reg = mc->reg;
303 	unsigned int reg2 = mc->rreg;
304 	unsigned int shift = mc->shift;
305 	unsigned int rshift = mc->rshift;
306 	int max = mc->max;
307 	int min = mc->min;
308 	unsigned int sign_bit = mc->sign_bit;
309 	unsigned int mask = (1 << fls(max)) - 1;
310 	unsigned int invert = mc->invert;
311 	int err, ret;
312 	bool type_2r = false;
313 	unsigned int val2 = 0;
314 	unsigned int val, val_mask;
315 
316 	if (sign_bit)
317 		mask = BIT(sign_bit + 1) - 1;
318 
319 	if (ucontrol->value.integer.value[0] < 0)
320 		return -EINVAL;
321 	val = ucontrol->value.integer.value[0];
322 	if (mc->platform_max && ((int)val + min) > mc->platform_max)
323 		return -EINVAL;
324 	if (val > max - min)
325 		return -EINVAL;
326 	val = (val + min) & mask;
327 	if (invert)
328 		val = max - val;
329 	val_mask = mask << shift;
330 	val = val << shift;
331 	if (snd_soc_volsw_is_stereo(mc)) {
332 		if (ucontrol->value.integer.value[1] < 0)
333 			return -EINVAL;
334 		val2 = ucontrol->value.integer.value[1];
335 		if (mc->platform_max && ((int)val2 + min) > mc->platform_max)
336 			return -EINVAL;
337 		if (val2 > max - min)
338 			return -EINVAL;
339 		val2 = (val2 + min) & mask;
340 		if (invert)
341 			val2 = max - val2;
342 		if (reg == reg2) {
343 			val_mask |= mask << rshift;
344 			val |= val2 << rshift;
345 		} else {
346 			val2 = val2 << shift;
347 			type_2r = true;
348 		}
349 	}
350 	err = snd_soc_component_update_bits(component, reg, val_mask, val);
351 	if (err < 0)
352 		return err;
353 	ret = err;
354 
355 	if (type_2r) {
356 		err = snd_soc_component_update_bits(component, reg2, val_mask,
357 						    val2);
358 		/* Don't discard any error code or drop change flag */
359 		if (ret == 0 || err < 0) {
360 			ret = err;
361 		}
362 	}
363 
364 	return ret;
365 }
366 EXPORT_SYMBOL_GPL(snd_soc_put_volsw);
367 
368 /**
369  * snd_soc_get_volsw_sx - single mixer get callback
370  * @kcontrol: mixer control
371  * @ucontrol: control element information
372  *
373  * Callback to get the value of a single mixer control, or a double mixer
374  * control that spans 2 registers.
375  *
376  * Returns 0 for success.
377  */
378 int snd_soc_get_volsw_sx(struct snd_kcontrol *kcontrol,
379 		      struct snd_ctl_elem_value *ucontrol)
380 {
381 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
382 	struct soc_mixer_control *mc =
383 	    (struct soc_mixer_control *)kcontrol->private_value;
384 	unsigned int reg = mc->reg;
385 	unsigned int reg2 = mc->rreg;
386 	unsigned int shift = mc->shift;
387 	unsigned int rshift = mc->rshift;
388 	int max = mc->max;
389 	int min = mc->min;
390 	unsigned int mask = (1U << (fls(min + max) - 1)) - 1;
391 	unsigned int val;
392 
393 	val = snd_soc_component_read(component, reg);
394 	ucontrol->value.integer.value[0] = ((val >> shift) - min) & mask;
395 
396 	if (snd_soc_volsw_is_stereo(mc)) {
397 		val = snd_soc_component_read(component, reg2);
398 		val = ((val >> rshift) - min) & mask;
399 		ucontrol->value.integer.value[1] = val;
400 	}
401 
402 	return 0;
403 }
404 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_sx);
405 
406 /**
407  * snd_soc_put_volsw_sx - double mixer set callback
408  * @kcontrol: mixer control
409  * @ucontrol: control element information
410  *
411  * Callback to set the value of a double mixer control that spans 2 registers.
412  *
413  * Returns 0 for success.
414  */
415 int snd_soc_put_volsw_sx(struct snd_kcontrol *kcontrol,
416 			 struct snd_ctl_elem_value *ucontrol)
417 {
418 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
419 	struct soc_mixer_control *mc =
420 	    (struct soc_mixer_control *)kcontrol->private_value;
421 
422 	unsigned int reg = mc->reg;
423 	unsigned int reg2 = mc->rreg;
424 	unsigned int shift = mc->shift;
425 	unsigned int rshift = mc->rshift;
426 	int max = mc->max;
427 	int min = mc->min;
428 	unsigned int mask = (1U << (fls(min + max) - 1)) - 1;
429 	int err = 0;
430 	int ret;
431 	unsigned int val, val_mask;
432 
433 	if (ucontrol->value.integer.value[0] < 0)
434 		return -EINVAL;
435 	val = ucontrol->value.integer.value[0];
436 	if (mc->platform_max && val > mc->platform_max)
437 		return -EINVAL;
438 	if (val > max - min)
439 		return -EINVAL;
440 	val_mask = mask << shift;
441 	val = (val + min) & mask;
442 	val = val << shift;
443 
444 	err = snd_soc_component_update_bits(component, reg, val_mask, val);
445 	if (err < 0)
446 		return err;
447 	ret = err;
448 
449 	if (snd_soc_volsw_is_stereo(mc)) {
450 		unsigned int val2;
451 
452 		val_mask = mask << rshift;
453 		val2 = (ucontrol->value.integer.value[1] + min) & mask;
454 		val2 = val2 << rshift;
455 
456 		err = snd_soc_component_update_bits(component, reg2, val_mask,
457 			val2);
458 
459 		/* Don't discard any error code or drop change flag */
460 		if (ret == 0 || err < 0) {
461 			ret = err;
462 		}
463 	}
464 	return ret;
465 }
466 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_sx);
467 
468 /**
469  * snd_soc_info_volsw_range - single mixer info callback with range.
470  * @kcontrol: mixer control
471  * @uinfo: control element information
472  *
473  * Callback to provide information, within a range, about a single
474  * mixer control.
475  *
476  * returns 0 for success.
477  */
478 int snd_soc_info_volsw_range(struct snd_kcontrol *kcontrol,
479 	struct snd_ctl_elem_info *uinfo)
480 {
481 	struct soc_mixer_control *mc =
482 		(struct soc_mixer_control *)kcontrol->private_value;
483 	int platform_max;
484 	int min = mc->min;
485 
486 	if (!mc->platform_max)
487 		mc->platform_max = mc->max;
488 	platform_max = mc->platform_max;
489 
490 	uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
491 	uinfo->count = snd_soc_volsw_is_stereo(mc) ? 2 : 1;
492 	uinfo->value.integer.min = 0;
493 	uinfo->value.integer.max = platform_max - min;
494 
495 	return 0;
496 }
497 EXPORT_SYMBOL_GPL(snd_soc_info_volsw_range);
498 
499 /**
500  * snd_soc_put_volsw_range - single mixer put value callback with range.
501  * @kcontrol: mixer control
502  * @ucontrol: control element information
503  *
504  * Callback to set the value, within a range, for a single mixer control.
505  *
506  * Returns 0 for success.
507  */
508 int snd_soc_put_volsw_range(struct snd_kcontrol *kcontrol,
509 	struct snd_ctl_elem_value *ucontrol)
510 {
511 	struct soc_mixer_control *mc =
512 		(struct soc_mixer_control *)kcontrol->private_value;
513 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
514 	unsigned int reg = mc->reg;
515 	unsigned int rreg = mc->rreg;
516 	unsigned int shift = mc->shift;
517 	int min = mc->min;
518 	int max = mc->max;
519 	unsigned int mask = (1 << fls(max)) - 1;
520 	unsigned int invert = mc->invert;
521 	unsigned int val, val_mask;
522 	int err, ret, tmp;
523 
524 	tmp = ucontrol->value.integer.value[0];
525 	if (tmp < 0)
526 		return -EINVAL;
527 	if (mc->platform_max && tmp > mc->platform_max)
528 		return -EINVAL;
529 	if (tmp > mc->max - mc->min + 1)
530 		return -EINVAL;
531 
532 	if (invert)
533 		val = (max - ucontrol->value.integer.value[0]) & mask;
534 	else
535 		val = ((ucontrol->value.integer.value[0] + min) & mask);
536 	val_mask = mask << shift;
537 	val = val << shift;
538 
539 	err = snd_soc_component_update_bits(component, reg, val_mask, val);
540 	if (err < 0)
541 		return err;
542 	ret = err;
543 
544 	if (snd_soc_volsw_is_stereo(mc)) {
545 		tmp = ucontrol->value.integer.value[1];
546 		if (tmp < 0)
547 			return -EINVAL;
548 		if (mc->platform_max && tmp > mc->platform_max)
549 			return -EINVAL;
550 		if (tmp > mc->max - mc->min + 1)
551 			return -EINVAL;
552 
553 		if (invert)
554 			val = (max - ucontrol->value.integer.value[1]) & mask;
555 		else
556 			val = ((ucontrol->value.integer.value[1] + min) & mask);
557 		val_mask = mask << shift;
558 		val = val << shift;
559 
560 		err = snd_soc_component_update_bits(component, rreg, val_mask,
561 			val);
562 		/* Don't discard any error code or drop change flag */
563 		if (ret == 0 || err < 0) {
564 			ret = err;
565 		}
566 	}
567 
568 	return ret;
569 }
570 EXPORT_SYMBOL_GPL(snd_soc_put_volsw_range);
571 
572 /**
573  * snd_soc_get_volsw_range - single mixer get callback with range
574  * @kcontrol: mixer control
575  * @ucontrol: control element information
576  *
577  * Callback to get the value, within a range, of a single mixer control.
578  *
579  * Returns 0 for success.
580  */
581 int snd_soc_get_volsw_range(struct snd_kcontrol *kcontrol,
582 	struct snd_ctl_elem_value *ucontrol)
583 {
584 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
585 	struct soc_mixer_control *mc =
586 		(struct soc_mixer_control *)kcontrol->private_value;
587 	unsigned int reg = mc->reg;
588 	unsigned int rreg = mc->rreg;
589 	unsigned int shift = mc->shift;
590 	int min = mc->min;
591 	int max = mc->max;
592 	unsigned int mask = (1 << fls(max)) - 1;
593 	unsigned int invert = mc->invert;
594 	unsigned int val;
595 
596 	val = snd_soc_component_read(component, reg);
597 	ucontrol->value.integer.value[0] = (val >> shift) & mask;
598 	if (invert)
599 		ucontrol->value.integer.value[0] =
600 			max - ucontrol->value.integer.value[0];
601 	else
602 		ucontrol->value.integer.value[0] =
603 			ucontrol->value.integer.value[0] - min;
604 
605 	if (snd_soc_volsw_is_stereo(mc)) {
606 		val = snd_soc_component_read(component, rreg);
607 		ucontrol->value.integer.value[1] = (val >> shift) & mask;
608 		if (invert)
609 			ucontrol->value.integer.value[1] =
610 				max - ucontrol->value.integer.value[1];
611 		else
612 			ucontrol->value.integer.value[1] =
613 				ucontrol->value.integer.value[1] - min;
614 	}
615 
616 	return 0;
617 }
618 EXPORT_SYMBOL_GPL(snd_soc_get_volsw_range);
619 
620 /**
621  * snd_soc_limit_volume - Set new limit to an existing volume control.
622  *
623  * @card: where to look for the control
624  * @name: Name of the control
625  * @max: new maximum limit
626  *
627  * Return 0 for success, else error.
628  */
629 int snd_soc_limit_volume(struct snd_soc_card *card,
630 	const char *name, int max)
631 {
632 	struct snd_kcontrol *kctl;
633 	int ret = -EINVAL;
634 
635 	/* Sanity check for name and max */
636 	if (unlikely(!name || max <= 0))
637 		return -EINVAL;
638 
639 	kctl = snd_soc_card_get_kcontrol(card, name);
640 	if (kctl) {
641 		struct soc_mixer_control *mc = (struct soc_mixer_control *)kctl->private_value;
642 		if (max <= mc->max) {
643 			mc->platform_max = max;
644 			ret = 0;
645 		}
646 	}
647 	return ret;
648 }
649 EXPORT_SYMBOL_GPL(snd_soc_limit_volume);
650 
651 int snd_soc_bytes_info(struct snd_kcontrol *kcontrol,
652 		       struct snd_ctl_elem_info *uinfo)
653 {
654 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
655 	struct soc_bytes *params = (void *)kcontrol->private_value;
656 
657 	uinfo->type = SNDRV_CTL_ELEM_TYPE_BYTES;
658 	uinfo->count = params->num_regs * component->val_bytes;
659 
660 	return 0;
661 }
662 EXPORT_SYMBOL_GPL(snd_soc_bytes_info);
663 
664 int snd_soc_bytes_get(struct snd_kcontrol *kcontrol,
665 		      struct snd_ctl_elem_value *ucontrol)
666 {
667 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
668 	struct soc_bytes *params = (void *)kcontrol->private_value;
669 	int ret;
670 
671 	if (component->regmap)
672 		ret = regmap_raw_read(component->regmap, params->base,
673 				      ucontrol->value.bytes.data,
674 				      params->num_regs * component->val_bytes);
675 	else
676 		ret = -EINVAL;
677 
678 	/* Hide any masked bytes to ensure consistent data reporting */
679 	if (ret == 0 && params->mask) {
680 		switch (component->val_bytes) {
681 		case 1:
682 			ucontrol->value.bytes.data[0] &= ~params->mask;
683 			break;
684 		case 2:
685 			((u16 *)(&ucontrol->value.bytes.data))[0]
686 				&= cpu_to_be16(~params->mask);
687 			break;
688 		case 4:
689 			((u32 *)(&ucontrol->value.bytes.data))[0]
690 				&= cpu_to_be32(~params->mask);
691 			break;
692 		default:
693 			return -EINVAL;
694 		}
695 	}
696 
697 	return ret;
698 }
699 EXPORT_SYMBOL_GPL(snd_soc_bytes_get);
700 
701 int snd_soc_bytes_put(struct snd_kcontrol *kcontrol,
702 		      struct snd_ctl_elem_value *ucontrol)
703 {
704 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
705 	struct soc_bytes *params = (void *)kcontrol->private_value;
706 	int ret, len;
707 	unsigned int val, mask;
708 	void *data;
709 
710 	if (!component->regmap || !params->num_regs)
711 		return -EINVAL;
712 
713 	len = params->num_regs * component->val_bytes;
714 
715 	data = kmemdup(ucontrol->value.bytes.data, len, GFP_KERNEL | GFP_DMA);
716 	if (!data)
717 		return -ENOMEM;
718 
719 	/*
720 	 * If we've got a mask then we need to preserve the register
721 	 * bits.  We shouldn't modify the incoming data so take a
722 	 * copy.
723 	 */
724 	if (params->mask) {
725 		ret = regmap_read(component->regmap, params->base, &val);
726 		if (ret != 0)
727 			goto out;
728 
729 		val &= params->mask;
730 
731 		switch (component->val_bytes) {
732 		case 1:
733 			((u8 *)data)[0] &= ~params->mask;
734 			((u8 *)data)[0] |= val;
735 			break;
736 		case 2:
737 			mask = ~params->mask;
738 			ret = regmap_parse_val(component->regmap,
739 							&mask, &mask);
740 			if (ret != 0)
741 				goto out;
742 
743 			((u16 *)data)[0] &= mask;
744 
745 			ret = regmap_parse_val(component->regmap,
746 							&val, &val);
747 			if (ret != 0)
748 				goto out;
749 
750 			((u16 *)data)[0] |= val;
751 			break;
752 		case 4:
753 			mask = ~params->mask;
754 			ret = regmap_parse_val(component->regmap,
755 							&mask, &mask);
756 			if (ret != 0)
757 				goto out;
758 
759 			((u32 *)data)[0] &= mask;
760 
761 			ret = regmap_parse_val(component->regmap,
762 							&val, &val);
763 			if (ret != 0)
764 				goto out;
765 
766 			((u32 *)data)[0] |= val;
767 			break;
768 		default:
769 			ret = -EINVAL;
770 			goto out;
771 		}
772 	}
773 
774 	ret = regmap_raw_write(component->regmap, params->base,
775 			       data, len);
776 
777 out:
778 	kfree(data);
779 
780 	return ret;
781 }
782 EXPORT_SYMBOL_GPL(snd_soc_bytes_put);
783 
784 int snd_soc_bytes_info_ext(struct snd_kcontrol *kcontrol,
785 			struct snd_ctl_elem_info *ucontrol)
786 {
787 	struct soc_bytes_ext *params = (void *)kcontrol->private_value;
788 
789 	ucontrol->type = SNDRV_CTL_ELEM_TYPE_BYTES;
790 	ucontrol->count = params->max;
791 
792 	return 0;
793 }
794 EXPORT_SYMBOL_GPL(snd_soc_bytes_info_ext);
795 
796 int snd_soc_bytes_tlv_callback(struct snd_kcontrol *kcontrol, int op_flag,
797 				unsigned int size, unsigned int __user *tlv)
798 {
799 	struct soc_bytes_ext *params = (void *)kcontrol->private_value;
800 	unsigned int count = size < params->max ? size : params->max;
801 	int ret = -ENXIO;
802 
803 	switch (op_flag) {
804 	case SNDRV_CTL_TLV_OP_READ:
805 		if (params->get)
806 			ret = params->get(kcontrol, tlv, count);
807 		break;
808 	case SNDRV_CTL_TLV_OP_WRITE:
809 		if (params->put)
810 			ret = params->put(kcontrol, tlv, count);
811 		break;
812 	}
813 	return ret;
814 }
815 EXPORT_SYMBOL_GPL(snd_soc_bytes_tlv_callback);
816 
817 /**
818  * snd_soc_info_xr_sx - signed multi register info callback
819  * @kcontrol: mreg control
820  * @uinfo: control element information
821  *
822  * Callback to provide information of a control that can
823  * span multiple codec registers which together
824  * forms a single signed value in a MSB/LSB manner.
825  *
826  * Returns 0 for success.
827  */
828 int snd_soc_info_xr_sx(struct snd_kcontrol *kcontrol,
829 	struct snd_ctl_elem_info *uinfo)
830 {
831 	struct soc_mreg_control *mc =
832 		(struct soc_mreg_control *)kcontrol->private_value;
833 	uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
834 	uinfo->count = 1;
835 	uinfo->value.integer.min = mc->min;
836 	uinfo->value.integer.max = mc->max;
837 
838 	return 0;
839 }
840 EXPORT_SYMBOL_GPL(snd_soc_info_xr_sx);
841 
842 /**
843  * snd_soc_get_xr_sx - signed multi register get callback
844  * @kcontrol: mreg control
845  * @ucontrol: control element information
846  *
847  * Callback to get the value of a control that can span
848  * multiple codec registers which together forms a single
849  * signed value in a MSB/LSB manner. The control supports
850  * specifying total no of bits used to allow for bitfields
851  * across the multiple codec registers.
852  *
853  * Returns 0 for success.
854  */
855 int snd_soc_get_xr_sx(struct snd_kcontrol *kcontrol,
856 	struct snd_ctl_elem_value *ucontrol)
857 {
858 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
859 	struct soc_mreg_control *mc =
860 		(struct soc_mreg_control *)kcontrol->private_value;
861 	unsigned int regbase = mc->regbase;
862 	unsigned int regcount = mc->regcount;
863 	unsigned int regwshift = component->val_bytes * BITS_PER_BYTE;
864 	unsigned int regwmask = (1UL<<regwshift)-1;
865 	unsigned int invert = mc->invert;
866 	unsigned long mask = (1UL<<mc->nbits)-1;
867 	long min = mc->min;
868 	long max = mc->max;
869 	long val = 0;
870 	unsigned int i;
871 
872 	for (i = 0; i < regcount; i++) {
873 		unsigned int regval = snd_soc_component_read(component, regbase+i);
874 		val |= (regval & regwmask) << (regwshift*(regcount-i-1));
875 	}
876 	val &= mask;
877 	if (min < 0 && val > max)
878 		val |= ~mask;
879 	if (invert)
880 		val = max - val;
881 	ucontrol->value.integer.value[0] = val;
882 
883 	return 0;
884 }
885 EXPORT_SYMBOL_GPL(snd_soc_get_xr_sx);
886 
887 /**
888  * snd_soc_put_xr_sx - signed multi register get callback
889  * @kcontrol: mreg control
890  * @ucontrol: control element information
891  *
892  * Callback to set the value of a control that can span
893  * multiple codec registers which together forms a single
894  * signed value in a MSB/LSB manner. The control supports
895  * specifying total no of bits used to allow for bitfields
896  * across the multiple codec registers.
897  *
898  * Returns 0 for success.
899  */
900 int snd_soc_put_xr_sx(struct snd_kcontrol *kcontrol,
901 	struct snd_ctl_elem_value *ucontrol)
902 {
903 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
904 	struct soc_mreg_control *mc =
905 		(struct soc_mreg_control *)kcontrol->private_value;
906 	unsigned int regbase = mc->regbase;
907 	unsigned int regcount = mc->regcount;
908 	unsigned int regwshift = component->val_bytes * BITS_PER_BYTE;
909 	unsigned int regwmask = (1UL<<regwshift)-1;
910 	unsigned int invert = mc->invert;
911 	unsigned long mask = (1UL<<mc->nbits)-1;
912 	long max = mc->max;
913 	long val = ucontrol->value.integer.value[0];
914 	int ret = 0;
915 	unsigned int i;
916 
917 	if (val < mc->min || val > mc->max)
918 		return -EINVAL;
919 	if (invert)
920 		val = max - val;
921 	val &= mask;
922 	for (i = 0; i < regcount; i++) {
923 		unsigned int regval = (val >> (regwshift*(regcount-i-1))) & regwmask;
924 		unsigned int regmask = (mask >> (regwshift*(regcount-i-1))) & regwmask;
925 		int err = snd_soc_component_update_bits(component, regbase+i,
926 							regmask, regval);
927 		if (err < 0)
928 			return err;
929 		if (err > 0)
930 			ret = err;
931 	}
932 
933 	return ret;
934 }
935 EXPORT_SYMBOL_GPL(snd_soc_put_xr_sx);
936 
937 /**
938  * snd_soc_get_strobe - strobe get callback
939  * @kcontrol: mixer control
940  * @ucontrol: control element information
941  *
942  * Callback get the value of a strobe mixer control.
943  *
944  * Returns 0 for success.
945  */
946 int snd_soc_get_strobe(struct snd_kcontrol *kcontrol,
947 	struct snd_ctl_elem_value *ucontrol)
948 {
949 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
950 	struct soc_mixer_control *mc =
951 		(struct soc_mixer_control *)kcontrol->private_value;
952 	unsigned int reg = mc->reg;
953 	unsigned int shift = mc->shift;
954 	unsigned int mask = 1 << shift;
955 	unsigned int invert = mc->invert != 0;
956 	unsigned int val;
957 
958 	val = snd_soc_component_read(component, reg);
959 	val &= mask;
960 
961 	if (shift != 0 && val != 0)
962 		val = val >> shift;
963 	ucontrol->value.enumerated.item[0] = val ^ invert;
964 
965 	return 0;
966 }
967 EXPORT_SYMBOL_GPL(snd_soc_get_strobe);
968 
969 /**
970  * snd_soc_put_strobe - strobe put callback
971  * @kcontrol: mixer control
972  * @ucontrol: control element information
973  *
974  * Callback strobe a register bit to high then low (or the inverse)
975  * in one pass of a single mixer enum control.
976  *
977  * Returns 1 for success.
978  */
979 int snd_soc_put_strobe(struct snd_kcontrol *kcontrol,
980 	struct snd_ctl_elem_value *ucontrol)
981 {
982 	struct snd_soc_component *component = snd_kcontrol_chip(kcontrol);
983 	struct soc_mixer_control *mc =
984 		(struct soc_mixer_control *)kcontrol->private_value;
985 	unsigned int reg = mc->reg;
986 	unsigned int shift = mc->shift;
987 	unsigned int mask = 1 << shift;
988 	unsigned int invert = mc->invert != 0;
989 	unsigned int strobe = ucontrol->value.enumerated.item[0] != 0;
990 	unsigned int val1 = (strobe ^ invert) ? mask : 0;
991 	unsigned int val2 = (strobe ^ invert) ? 0 : mask;
992 	int err;
993 
994 	err = snd_soc_component_update_bits(component, reg, mask, val1);
995 	if (err < 0)
996 		return err;
997 
998 	return snd_soc_component_update_bits(component, reg, mask, val2);
999 }
1000 EXPORT_SYMBOL_GPL(snd_soc_put_strobe);
1001