xref: /kernel/linux/linux-5.10/sound/soc/soc-ac97.c (revision 8c2ecf20)
1// SPDX-License-Identifier: GPL-2.0+
2//
3// soc-ac97.c  --  ALSA SoC Audio Layer AC97 support
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/ctype.h>
15#include <linux/delay.h>
16#include <linux/export.h>
17#include <linux/gpio.h>
18#include <linux/gpio/driver.h>
19#include <linux/init.h>
20#include <linux/of_gpio.h>
21#include <linux/of.h>
22#include <linux/pinctrl/consumer.h>
23#include <linux/slab.h>
24#include <sound/ac97_codec.h>
25#include <sound/soc.h>
26
27struct snd_ac97_reset_cfg {
28	struct pinctrl *pctl;
29	struct pinctrl_state *pstate_reset;
30	struct pinctrl_state *pstate_warm_reset;
31	struct pinctrl_state *pstate_run;
32	int gpio_sdata;
33	int gpio_sync;
34	int gpio_reset;
35};
36
37struct snd_ac97_gpio_priv {
38#ifdef CONFIG_GPIOLIB
39	struct gpio_chip gpio_chip;
40#endif
41	unsigned int gpios_set;
42	struct snd_soc_component *component;
43};
44
45static struct snd_ac97_bus soc_ac97_bus = {
46	.ops = NULL, /* Gets initialized in snd_soc_set_ac97_ops() */
47};
48
49static void soc_ac97_device_release(struct device *dev)
50{
51	kfree(to_ac97_t(dev));
52}
53
54#ifdef CONFIG_GPIOLIB
55static inline struct snd_soc_component *gpio_to_component(struct gpio_chip *chip)
56{
57	struct snd_ac97_gpio_priv *gpio_priv = gpiochip_get_data(chip);
58
59	return gpio_priv->component;
60}
61
62static int snd_soc_ac97_gpio_request(struct gpio_chip *chip, unsigned offset)
63{
64	if (offset >= AC97_NUM_GPIOS)
65		return -EINVAL;
66
67	return 0;
68}
69
70static int snd_soc_ac97_gpio_direction_in(struct gpio_chip *chip,
71					  unsigned offset)
72{
73	struct snd_soc_component *component = gpio_to_component(chip);
74
75	dev_dbg(component->dev, "set gpio %d to output\n", offset);
76	return snd_soc_component_update_bits(component, AC97_GPIO_CFG,
77				   1 << offset, 1 << offset);
78}
79
80static int snd_soc_ac97_gpio_get(struct gpio_chip *chip, unsigned offset)
81{
82	struct snd_soc_component *component = gpio_to_component(chip);
83	int ret;
84
85	ret = snd_soc_component_read(component, AC97_GPIO_STATUS);
86
87	dev_dbg(component->dev, "get gpio %d : %d\n", offset,
88		ret & (1 << offset));
89
90	return !!(ret & (1 << offset));
91}
92
93static void snd_soc_ac97_gpio_set(struct gpio_chip *chip, unsigned offset,
94				  int value)
95{
96	struct snd_ac97_gpio_priv *gpio_priv = gpiochip_get_data(chip);
97	struct snd_soc_component *component = gpio_to_component(chip);
98
99	gpio_priv->gpios_set &= ~(1 << offset);
100	gpio_priv->gpios_set |= (!!value) << offset;
101	snd_soc_component_write(component, AC97_GPIO_STATUS,
102				gpio_priv->gpios_set);
103	dev_dbg(component->dev, "set gpio %d to %d\n", offset, !!value);
104}
105
106static int snd_soc_ac97_gpio_direction_out(struct gpio_chip *chip,
107				     unsigned offset, int value)
108{
109	struct snd_soc_component *component = gpio_to_component(chip);
110
111	dev_dbg(component->dev, "set gpio %d to output\n", offset);
112	snd_soc_ac97_gpio_set(chip, offset, value);
113	return snd_soc_component_update_bits(component, AC97_GPIO_CFG,
114					     1 << offset, 0);
115}
116
117static const struct gpio_chip snd_soc_ac97_gpio_chip = {
118	.label			= "snd_soc_ac97",
119	.owner			= THIS_MODULE,
120	.request		= snd_soc_ac97_gpio_request,
121	.direction_input	= snd_soc_ac97_gpio_direction_in,
122	.get			= snd_soc_ac97_gpio_get,
123	.direction_output	= snd_soc_ac97_gpio_direction_out,
124	.set			= snd_soc_ac97_gpio_set,
125	.can_sleep		= 1,
126};
127
128static int snd_soc_ac97_init_gpio(struct snd_ac97 *ac97,
129				  struct snd_soc_component *component)
130{
131	struct snd_ac97_gpio_priv *gpio_priv;
132	int ret;
133
134	gpio_priv = devm_kzalloc(component->dev, sizeof(*gpio_priv), GFP_KERNEL);
135	if (!gpio_priv)
136		return -ENOMEM;
137	ac97->gpio_priv = gpio_priv;
138	gpio_priv->component = component;
139	gpio_priv->gpio_chip = snd_soc_ac97_gpio_chip;
140	gpio_priv->gpio_chip.ngpio = AC97_NUM_GPIOS;
141	gpio_priv->gpio_chip.parent = component->dev;
142	gpio_priv->gpio_chip.base = -1;
143
144	ret = gpiochip_add_data(&gpio_priv->gpio_chip, gpio_priv);
145	if (ret != 0)
146		dev_err(component->dev, "Failed to add GPIOs: %d\n", ret);
147	return ret;
148}
149
150static void snd_soc_ac97_free_gpio(struct snd_ac97 *ac97)
151{
152	gpiochip_remove(&ac97->gpio_priv->gpio_chip);
153}
154#else
155static int snd_soc_ac97_init_gpio(struct snd_ac97 *ac97,
156				  struct snd_soc_component *component)
157{
158	return 0;
159}
160
161static void snd_soc_ac97_free_gpio(struct snd_ac97 *ac97)
162{
163}
164#endif
165
166/**
167 * snd_soc_alloc_ac97_component() - Allocate new a AC'97 device
168 * @component: The COMPONENT for which to create the AC'97 device
169 *
170 * Allocated a new snd_ac97 device and intializes it, but does not yet register
171 * it. The caller is responsible to either call device_add(&ac97->dev) to
172 * register the device, or to call put_device(&ac97->dev) to free the device.
173 *
174 * Returns: A snd_ac97 device or a PTR_ERR in case of an error.
175 */
176struct snd_ac97 *snd_soc_alloc_ac97_component(struct snd_soc_component *component)
177{
178	struct snd_ac97 *ac97;
179
180	ac97 = kzalloc(sizeof(struct snd_ac97), GFP_KERNEL);
181	if (ac97 == NULL)
182		return ERR_PTR(-ENOMEM);
183
184	ac97->bus = &soc_ac97_bus;
185	ac97->num = 0;
186
187	ac97->dev.bus = &ac97_bus_type;
188	ac97->dev.parent = component->card->dev;
189	ac97->dev.release = soc_ac97_device_release;
190
191	dev_set_name(&ac97->dev, "%d-%d:%s",
192		     component->card->snd_card->number, 0,
193		     component->name);
194
195	device_initialize(&ac97->dev);
196
197	return ac97;
198}
199EXPORT_SYMBOL(snd_soc_alloc_ac97_component);
200
201/**
202 * snd_soc_new_ac97_component - initailise AC97 device
203 * @component: audio component
204 * @id: The expected device ID
205 * @id_mask: Mask that is applied to the device ID before comparing with @id
206 *
207 * Initialises AC97 component resources for use by ad-hoc devices only.
208 *
209 * If @id is not 0 this function will reset the device, then read the ID from
210 * the device and check if it matches the expected ID. If it doesn't match an
211 * error will be returned and device will not be registered.
212 *
213 * Returns: A PTR_ERR() on failure or a valid snd_ac97 struct on success.
214 */
215struct snd_ac97 *snd_soc_new_ac97_component(struct snd_soc_component *component,
216	unsigned int id, unsigned int id_mask)
217{
218	struct snd_ac97 *ac97;
219	int ret;
220
221	ac97 = snd_soc_alloc_ac97_component(component);
222	if (IS_ERR(ac97))
223		return ac97;
224
225	if (id) {
226		ret = snd_ac97_reset(ac97, false, id, id_mask);
227		if (ret < 0) {
228			dev_err(component->dev, "Failed to reset AC97 device: %d\n",
229				ret);
230			goto err_put_device;
231		}
232	}
233
234	ret = device_add(&ac97->dev);
235	if (ret)
236		goto err_put_device;
237
238	ret = snd_soc_ac97_init_gpio(ac97, component);
239	if (ret)
240		goto err_put_device;
241
242	return ac97;
243
244err_put_device:
245	put_device(&ac97->dev);
246	return ERR_PTR(ret);
247}
248EXPORT_SYMBOL_GPL(snd_soc_new_ac97_component);
249
250/**
251 * snd_soc_free_ac97_component - free AC97 component device
252 * @ac97: snd_ac97 device to be freed
253 *
254 * Frees AC97 component device resources.
255 */
256void snd_soc_free_ac97_component(struct snd_ac97 *ac97)
257{
258	snd_soc_ac97_free_gpio(ac97);
259	device_del(&ac97->dev);
260	ac97->bus = NULL;
261	put_device(&ac97->dev);
262}
263EXPORT_SYMBOL_GPL(snd_soc_free_ac97_component);
264
265static struct snd_ac97_reset_cfg snd_ac97_rst_cfg;
266
267static void snd_soc_ac97_warm_reset(struct snd_ac97 *ac97)
268{
269	struct pinctrl *pctl = snd_ac97_rst_cfg.pctl;
270
271	pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_warm_reset);
272
273	gpio_direction_output(snd_ac97_rst_cfg.gpio_sync, 1);
274
275	udelay(10);
276
277	gpio_direction_output(snd_ac97_rst_cfg.gpio_sync, 0);
278
279	pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_run);
280	msleep(2);
281}
282
283static void snd_soc_ac97_reset(struct snd_ac97 *ac97)
284{
285	struct pinctrl *pctl = snd_ac97_rst_cfg.pctl;
286
287	pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_reset);
288
289	gpio_direction_output(snd_ac97_rst_cfg.gpio_sync, 0);
290	gpio_direction_output(snd_ac97_rst_cfg.gpio_sdata, 0);
291	gpio_direction_output(snd_ac97_rst_cfg.gpio_reset, 0);
292
293	udelay(10);
294
295	gpio_direction_output(snd_ac97_rst_cfg.gpio_reset, 1);
296
297	pinctrl_select_state(pctl, snd_ac97_rst_cfg.pstate_run);
298	msleep(2);
299}
300
301static int snd_soc_ac97_parse_pinctl(struct device *dev,
302		struct snd_ac97_reset_cfg *cfg)
303{
304	struct pinctrl *p;
305	struct pinctrl_state *state;
306	int gpio;
307	int ret;
308
309	p = devm_pinctrl_get(dev);
310	if (IS_ERR(p)) {
311		dev_err(dev, "Failed to get pinctrl\n");
312		return PTR_ERR(p);
313	}
314	cfg->pctl = p;
315
316	state = pinctrl_lookup_state(p, "ac97-reset");
317	if (IS_ERR(state)) {
318		dev_err(dev, "Can't find pinctrl state ac97-reset\n");
319		return PTR_ERR(state);
320	}
321	cfg->pstate_reset = state;
322
323	state = pinctrl_lookup_state(p, "ac97-warm-reset");
324	if (IS_ERR(state)) {
325		dev_err(dev, "Can't find pinctrl state ac97-warm-reset\n");
326		return PTR_ERR(state);
327	}
328	cfg->pstate_warm_reset = state;
329
330	state = pinctrl_lookup_state(p, "ac97-running");
331	if (IS_ERR(state)) {
332		dev_err(dev, "Can't find pinctrl state ac97-running\n");
333		return PTR_ERR(state);
334	}
335	cfg->pstate_run = state;
336
337	gpio = of_get_named_gpio(dev->of_node, "ac97-gpios", 0);
338	if (gpio < 0) {
339		dev_err(dev, "Can't find ac97-sync gpio\n");
340		return gpio;
341	}
342	ret = devm_gpio_request(dev, gpio, "AC97 link sync");
343	if (ret) {
344		dev_err(dev, "Failed requesting ac97-sync gpio\n");
345		return ret;
346	}
347	cfg->gpio_sync = gpio;
348
349	gpio = of_get_named_gpio(dev->of_node, "ac97-gpios", 1);
350	if (gpio < 0) {
351		dev_err(dev, "Can't find ac97-sdata gpio %d\n", gpio);
352		return gpio;
353	}
354	ret = devm_gpio_request(dev, gpio, "AC97 link sdata");
355	if (ret) {
356		dev_err(dev, "Failed requesting ac97-sdata gpio\n");
357		return ret;
358	}
359	cfg->gpio_sdata = gpio;
360
361	gpio = of_get_named_gpio(dev->of_node, "ac97-gpios", 2);
362	if (gpio < 0) {
363		dev_err(dev, "Can't find ac97-reset gpio\n");
364		return gpio;
365	}
366	ret = devm_gpio_request(dev, gpio, "AC97 link reset");
367	if (ret) {
368		dev_err(dev, "Failed requesting ac97-reset gpio\n");
369		return ret;
370	}
371	cfg->gpio_reset = gpio;
372
373	return 0;
374}
375
376struct snd_ac97_bus_ops *soc_ac97_ops;
377EXPORT_SYMBOL_GPL(soc_ac97_ops);
378
379int snd_soc_set_ac97_ops(struct snd_ac97_bus_ops *ops)
380{
381	if (ops == soc_ac97_ops)
382		return 0;
383
384	if (soc_ac97_ops && ops)
385		return -EBUSY;
386
387	soc_ac97_ops = ops;
388	soc_ac97_bus.ops = ops;
389
390	return 0;
391}
392EXPORT_SYMBOL_GPL(snd_soc_set_ac97_ops);
393
394/**
395 * snd_soc_set_ac97_ops_of_reset - Set ac97 ops with generic ac97 reset functions
396 * @ops: bus ops
397 * @pdev: platform device
398 *
399 * This function sets the reset and warm_reset properties of ops and parses
400 * the device node of pdev to get pinctrl states and gpio numbers to use.
401 */
402int snd_soc_set_ac97_ops_of_reset(struct snd_ac97_bus_ops *ops,
403		struct platform_device *pdev)
404{
405	struct device *dev = &pdev->dev;
406	struct snd_ac97_reset_cfg cfg;
407	int ret;
408
409	ret = snd_soc_ac97_parse_pinctl(dev, &cfg);
410	if (ret)
411		return ret;
412
413	ret = snd_soc_set_ac97_ops(ops);
414	if (ret)
415		return ret;
416
417	ops->warm_reset = snd_soc_ac97_warm_reset;
418	ops->reset = snd_soc_ac97_reset;
419
420	snd_ac97_rst_cfg = cfg;
421	return 0;
422}
423EXPORT_SYMBOL_GPL(snd_soc_set_ac97_ops_of_reset);
424