xref: /openbmc/linux/sound/soc/sh/rcar/rsnd.h (revision e879a9dd)
1 /*
2  * Renesas R-Car
3  *
4  * Copyright (C) 2013 Renesas Solutions Corp.
5  * Kuninori Morimoto <kuninori.morimoto.gx@renesas.com>
6  *
7  * This program is free software; you can redistribute it and/or modify
8  * it under the terms of the GNU General Public License version 2 as
9  * published by the Free Software Foundation.
10  */
11 #ifndef RSND_H
12 #define RSND_H
13 
14 #include <linux/clk.h>
15 #include <linux/device.h>
16 #include <linux/dma-mapping.h>
17 #include <linux/io.h>
18 #include <linux/list.h>
19 #include <linux/module.h>
20 #include <linux/of_device.h>
21 #include <linux/of_irq.h>
22 #include <linux/sh_dma.h>
23 #include <linux/workqueue.h>
24 #include <sound/rcar_snd.h>
25 #include <sound/soc.h>
26 #include <sound/pcm_params.h>
27 
28 /*
29  *	pseudo register
30  *
31  * The register address offsets SRU/SCU/SSIU on Gen1/Gen2 are very different.
32  * This driver uses pseudo register in order to hide it.
33  * see gen1/gen2 for detail
34  */
35 enum rsnd_reg {
36 	/* SRU/SCU/SSIU */
37 	RSND_REG_SSI_MODE0,
38 	RSND_REG_SSI_MODE1,
39 	RSND_REG_SRC_BUSIF_MODE,
40 	RSND_REG_SRC_ROUTE_MODE0,
41 	RSND_REG_SRC_SWRSR,
42 	RSND_REG_SRC_SRCIR,
43 	RSND_REG_SRC_ADINR,
44 	RSND_REG_SRC_IFSCR,
45 	RSND_REG_SRC_IFSVR,
46 	RSND_REG_SRC_SRCCR,
47 	RSND_REG_SCU_SYS_STATUS0,
48 	RSND_REG_SCU_SYS_INT_EN0,
49 	RSND_REG_CMD_ROUTE_SLCT,
50 	RSND_REG_DVC_SWRSR,
51 	RSND_REG_DVC_DVUIR,
52 	RSND_REG_DVC_ADINR,
53 	RSND_REG_DVC_DVUCR,
54 	RSND_REG_DVC_ZCMCR,
55 	RSND_REG_DVC_VOL0R,
56 	RSND_REG_DVC_VOL1R,
57 	RSND_REG_DVC_DVUER,
58 
59 	/* ADG */
60 	RSND_REG_BRRA,
61 	RSND_REG_BRRB,
62 	RSND_REG_SSICKR,
63 	RSND_REG_AUDIO_CLK_SEL0,
64 	RSND_REG_AUDIO_CLK_SEL1,
65 
66 	/* SSI */
67 	RSND_REG_SSICR,
68 	RSND_REG_SSISR,
69 	RSND_REG_SSITDR,
70 	RSND_REG_SSIRDR,
71 	RSND_REG_SSIWSR,
72 
73 	/* SHARE see below */
74 	RSND_REG_SHARE01,
75 	RSND_REG_SHARE02,
76 	RSND_REG_SHARE03,
77 	RSND_REG_SHARE04,
78 	RSND_REG_SHARE05,
79 	RSND_REG_SHARE06,
80 	RSND_REG_SHARE07,
81 	RSND_REG_SHARE08,
82 	RSND_REG_SHARE09,
83 	RSND_REG_SHARE10,
84 	RSND_REG_SHARE11,
85 	RSND_REG_SHARE12,
86 	RSND_REG_SHARE13,
87 	RSND_REG_SHARE14,
88 	RSND_REG_SHARE15,
89 	RSND_REG_SHARE16,
90 	RSND_REG_SHARE17,
91 	RSND_REG_SHARE18,
92 	RSND_REG_SHARE19,
93 	RSND_REG_SHARE20,
94 	RSND_REG_SHARE21,
95 	RSND_REG_SHARE22,
96 	RSND_REG_SHARE23,
97 	RSND_REG_SHARE24,
98 	RSND_REG_SHARE25,
99 	RSND_REG_SHARE26,
100 	RSND_REG_SHARE27,
101 	RSND_REG_SHARE28,
102 
103 	RSND_REG_MAX,
104 };
105 
106 /* Gen1 only */
107 #define RSND_REG_SRC_ROUTE_SEL		RSND_REG_SHARE01
108 #define RSND_REG_SRC_TMG_SEL0		RSND_REG_SHARE02
109 #define RSND_REG_SRC_TMG_SEL1		RSND_REG_SHARE03
110 #define RSND_REG_SRC_TMG_SEL2		RSND_REG_SHARE04
111 #define RSND_REG_SRC_ROUTE_CTRL		RSND_REG_SHARE05
112 #define RSND_REG_SRC_MNFSR		RSND_REG_SHARE06
113 #define RSND_REG_AUDIO_CLK_SEL3		RSND_REG_SHARE07
114 #define RSND_REG_AUDIO_CLK_SEL4		RSND_REG_SHARE08
115 #define RSND_REG_AUDIO_CLK_SEL5		RSND_REG_SHARE09
116 
117 /* Gen2 only */
118 #define RSND_REG_SRC_CTRL		RSND_REG_SHARE01
119 #define RSND_REG_SSI_CTRL		RSND_REG_SHARE02
120 #define RSND_REG_SSI_BUSIF_MODE		RSND_REG_SHARE03
121 #define RSND_REG_SSI_BUSIF_ADINR	RSND_REG_SHARE04
122 #define RSND_REG_INT_ENABLE		RSND_REG_SHARE05
123 #define RSND_REG_SRC_BSDSR		RSND_REG_SHARE06
124 #define RSND_REG_SRC_BSISR		RSND_REG_SHARE07
125 #define RSND_REG_DIV_EN			RSND_REG_SHARE08
126 #define RSND_REG_SRCIN_TIMSEL0		RSND_REG_SHARE09
127 #define RSND_REG_SRCIN_TIMSEL1		RSND_REG_SHARE10
128 #define RSND_REG_SRCIN_TIMSEL2		RSND_REG_SHARE11
129 #define RSND_REG_SRCIN_TIMSEL3		RSND_REG_SHARE12
130 #define RSND_REG_SRCIN_TIMSEL4		RSND_REG_SHARE13
131 #define RSND_REG_SRCOUT_TIMSEL0		RSND_REG_SHARE14
132 #define RSND_REG_SRCOUT_TIMSEL1		RSND_REG_SHARE15
133 #define RSND_REG_SRCOUT_TIMSEL2		RSND_REG_SHARE16
134 #define RSND_REG_SRCOUT_TIMSEL3		RSND_REG_SHARE17
135 #define RSND_REG_SRCOUT_TIMSEL4		RSND_REG_SHARE18
136 #define RSND_REG_AUDIO_CLK_SEL2		RSND_REG_SHARE19
137 #define RSND_REG_CMD_CTRL		RSND_REG_SHARE20
138 #define RSND_REG_CMDOUT_TIMSEL		RSND_REG_SHARE21
139 #define RSND_REG_BUSIF_DALIGN		RSND_REG_SHARE22
140 #define RSND_REG_DVC_VRCTR		RSND_REG_SHARE23
141 #define RSND_REG_DVC_VRPDR		RSND_REG_SHARE24
142 #define RSND_REG_DVC_VRDBR		RSND_REG_SHARE25
143 #define RSND_REG_SCU_SYS_STATUS1	RSND_REG_SHARE26
144 #define RSND_REG_SCU_SYS_INT_EN1	RSND_REG_SHARE27
145 #define RSND_REG_SRC_INT_ENABLE0	RSND_REG_SHARE28
146 
147 struct rsnd_of_data;
148 struct rsnd_priv;
149 struct rsnd_mod;
150 struct rsnd_dai;
151 struct rsnd_dai_stream;
152 
153 /*
154  *	R-Car basic functions
155  */
156 #define rsnd_mod_read(m, r) \
157 	rsnd_read(rsnd_mod_to_priv(m), m, RSND_REG_##r)
158 #define rsnd_mod_write(m, r, d) \
159 	rsnd_write(rsnd_mod_to_priv(m), m, RSND_REG_##r, d)
160 #define rsnd_mod_bset(m, r, s, d) \
161 	rsnd_bset(rsnd_mod_to_priv(m), m, RSND_REG_##r, s, d)
162 
163 u32 rsnd_read(struct rsnd_priv *priv, struct rsnd_mod *mod, enum rsnd_reg reg);
164 void rsnd_write(struct rsnd_priv *priv, struct rsnd_mod *mod,
165 		enum rsnd_reg reg, u32 data);
166 void rsnd_bset(struct rsnd_priv *priv, struct rsnd_mod *mod, enum rsnd_reg reg,
167 		    u32 mask, u32 data);
168 u32 rsnd_get_adinr(struct rsnd_mod *mod);
169 
170 /*
171  *	R-Car DMA
172  */
173 struct rsnd_dma;
174 struct rsnd_dma_ops {
175 	void (*start)(struct rsnd_dma *dma);
176 	void (*stop)(struct rsnd_dma *dma);
177 	int (*init)(struct rsnd_priv *priv, struct rsnd_dma *dma, int id,
178 		    struct rsnd_mod *mod_from, struct rsnd_mod *mod_to);
179 	void  (*quit)(struct rsnd_dma *dma);
180 };
181 
182 struct rsnd_dmaen {
183 	struct dma_chan		*chan;
184 };
185 
186 struct rsnd_dmapp {
187 	int			dmapp_id;
188 	u32			chcr;
189 };
190 
191 struct rsnd_dma {
192 	struct rsnd_dma_ops	*ops;
193 	dma_addr_t		src_addr;
194 	dma_addr_t		dst_addr;
195 	union {
196 		struct rsnd_dmaen en;
197 		struct rsnd_dmapp pp;
198 	} dma;
199 };
200 #define rsnd_dma_to_dmaen(dma)	(&(dma)->dma.en)
201 #define rsnd_dma_to_dmapp(dma)	(&(dma)->dma.pp)
202 
203 void rsnd_dma_start(struct rsnd_dma *dma);
204 void rsnd_dma_stop(struct rsnd_dma *dma);
205 int rsnd_dma_init(struct rsnd_priv *priv, struct rsnd_dma *dma, int id);
206 void  rsnd_dma_quit(struct rsnd_dma *dma);
207 int rsnd_dma_probe(struct platform_device *pdev,
208 		   const struct rsnd_of_data *of_data,
209 		   struct rsnd_priv *priv);
210 
211 #define rsnd_dma_to_mod(_dma) container_of((_dma), struct rsnd_mod, dma)
212 
213 /*
214  *	R-Car sound mod
215  */
216 enum rsnd_mod_type {
217 	RSND_MOD_DVC = 0,
218 	RSND_MOD_SRC,
219 	RSND_MOD_SSI,
220 	RSND_MOD_MAX,
221 };
222 
223 struct rsnd_mod_ops {
224 	char *name;
225 	char* (*dma_name)(struct rsnd_mod *mod);
226 	int (*probe)(struct rsnd_mod *mod,
227 		     struct rsnd_priv *priv);
228 	int (*remove)(struct rsnd_mod *mod,
229 		      struct rsnd_priv *priv);
230 	int (*init)(struct rsnd_mod *mod,
231 		    struct rsnd_priv *priv);
232 	int (*quit)(struct rsnd_mod *mod,
233 		    struct rsnd_priv *priv);
234 	int (*start)(struct rsnd_mod *mod,
235 		     struct rsnd_priv *priv);
236 	int (*stop)(struct rsnd_mod *mod,
237 		    struct rsnd_priv *priv);
238 	int (*pcm_new)(struct rsnd_mod *mod,
239 		       struct snd_soc_pcm_runtime *rtd);
240 	int (*fallback)(struct rsnd_mod *mod,
241 			struct rsnd_priv *priv);
242 };
243 
244 struct rsnd_dai_stream;
245 struct rsnd_mod {
246 	int id;
247 	enum rsnd_mod_type type;
248 	struct rsnd_mod_ops *ops;
249 	struct rsnd_dma dma;
250 	struct rsnd_dai_stream *io;
251 	struct clk *clk;
252 	u32 status;
253 };
254 /*
255  * status
256  *
257  * bit
258  * 0	0: probe	1: remove
259  * 1	0: init		1: quit
260  * 2	0: start	1: stop
261  * 3	0: pcm_new
262  * 4	0: fallback
263  */
264 #define __rsnd_mod_shift_probe		0
265 #define __rsnd_mod_shift_remove		0
266 #define __rsnd_mod_shift_init		1
267 #define __rsnd_mod_shift_quit		1
268 #define __rsnd_mod_shift_start		2
269 #define __rsnd_mod_shift_stop		2
270 #define __rsnd_mod_shift_pcm_new	3
271 #define __rsnd_mod_shift_fallback	4
272 
273 #define __rsnd_mod_call_probe		0
274 #define __rsnd_mod_call_remove		1
275 #define __rsnd_mod_call_init		0
276 #define __rsnd_mod_call_quit		1
277 #define __rsnd_mod_call_start		0
278 #define __rsnd_mod_call_stop		1
279 #define __rsnd_mod_call_pcm_new		0
280 #define __rsnd_mod_call_fallback	0
281 
282 #define rsnd_mod_to_priv(mod) (rsnd_io_to_priv(rsnd_mod_to_io(mod)))
283 #define rsnd_mod_to_dma(mod) (&(mod)->dma)
284 #define rsnd_mod_to_io(mod) ((mod)->io)
285 #define rsnd_mod_id(mod) ((mod)->id)
286 #define rsnd_mod_hw_start(mod)	clk_prepare_enable((mod)->clk)
287 #define rsnd_mod_hw_stop(mod)	clk_disable_unprepare((mod)->clk)
288 
289 void rsnd_mod_init(struct rsnd_mod *mod,
290 		   struct rsnd_mod_ops *ops,
291 		   struct clk *clk,
292 		   enum rsnd_mod_type type,
293 		   int id);
294 char *rsnd_mod_name(struct rsnd_mod *mod);
295 char *rsnd_mod_dma_name(struct rsnd_mod *mod);
296 
297 /*
298  *	R-Car sound DAI
299  */
300 #define RSND_DAI_NAME_SIZE	16
301 struct rsnd_dai_stream {
302 	struct snd_pcm_substream *substream;
303 	struct rsnd_mod *mod[RSND_MOD_MAX];
304 	struct rsnd_dai_path_info *info; /* rcar_snd.h */
305 	struct rsnd_dai *rdai;
306 	int byte_pos;
307 	int period_pos;
308 	int byte_per_period;
309 	int next_period_byte;
310 };
311 #define rsnd_io_to_mod_ssi(io)	((io)->mod[RSND_MOD_SSI])
312 #define rsnd_io_to_mod_src(io)	((io)->mod[RSND_MOD_SRC])
313 #define rsnd_io_to_mod_dvc(io)	((io)->mod[RSND_MOD_DVC])
314 #define rsnd_io_to_rdai(io)	((io)->rdai)
315 #define rsnd_io_to_priv(io)	(rsnd_rdai_to_priv(rsnd_io_to_rdai(io)))
316 #define rsnd_io_is_play(io)	(&rsnd_io_to_rdai(io)->playback == io)
317 #define rsnd_io_to_runtime(io) ((io)->substream ? \
318 				(io)->substream->runtime : NULL)
319 
320 
321 struct rsnd_dai {
322 	char name[RSND_DAI_NAME_SIZE];
323 	struct rsnd_dai_stream playback;
324 	struct rsnd_dai_stream capture;
325 	struct rsnd_priv *priv;
326 
327 	unsigned int clk_master:1;
328 	unsigned int bit_clk_inv:1;
329 	unsigned int frm_clk_inv:1;
330 	unsigned int sys_delay:1;
331 	unsigned int data_alignment:1;
332 };
333 
334 #define rsnd_rdai_nr(priv) ((priv)->rdai_nr)
335 #define rsnd_rdai_is_clk_master(rdai) ((rdai)->clk_master)
336 #define rsnd_rdai_to_priv(rdai) ((rdai)->priv)
337 #define for_each_rsnd_dai(rdai, priv, i)		\
338 	for (i = 0;					\
339 	     (i < rsnd_rdai_nr(priv)) &&		\
340 	     ((rdai) = rsnd_rdai_get(priv, i));		\
341 	     i++)
342 
343 struct rsnd_dai *rsnd_rdai_get(struct rsnd_priv *priv, int id);
344 
345 void rsnd_dai_pointer_update(struct rsnd_dai_stream *io, int cnt);
346 int rsnd_dai_pointer_offset(struct rsnd_dai_stream *io, int additional);
347 
348 /*
349  *	R-Car Gen1/Gen2
350  */
351 int rsnd_gen_probe(struct platform_device *pdev,
352 		   const struct rsnd_of_data *of_data,
353 		   struct rsnd_priv *priv);
354 void __iomem *rsnd_gen_reg_get(struct rsnd_priv *priv,
355 			       struct rsnd_mod *mod,
356 			       enum rsnd_reg reg);
357 phys_addr_t rsnd_gen_get_phy_addr(struct rsnd_priv *priv, int reg_id);
358 
359 #define rsnd_is_gen1(s)		(((s)->info->flags & RSND_GEN_MASK) == RSND_GEN1)
360 #define rsnd_is_gen2(s)		(((s)->info->flags & RSND_GEN_MASK) == RSND_GEN2)
361 
362 /*
363  *	R-Car ADG
364  */
365 int rsnd_adg_ssi_clk_stop(struct rsnd_mod *mod);
366 int rsnd_adg_ssi_clk_try_start(struct rsnd_mod *mod, unsigned int rate);
367 int rsnd_adg_probe(struct platform_device *pdev,
368 		   const struct rsnd_of_data *of_data,
369 		   struct rsnd_priv *priv);
370 int rsnd_adg_set_convert_clk_gen1(struct rsnd_priv *priv,
371 				  struct rsnd_mod *mod,
372 				  unsigned int src_rate,
373 				  unsigned int dst_rate);
374 int rsnd_adg_set_convert_clk_gen2(struct rsnd_mod *mod,
375 				  struct rsnd_dai_stream *io,
376 				  unsigned int src_rate,
377 				  unsigned int dst_rate);
378 int rsnd_adg_set_convert_timing_gen2(struct rsnd_mod *mod,
379 				     struct rsnd_dai_stream *io);
380 int rsnd_adg_set_cmd_timsel_gen2(struct rsnd_mod *mod,
381 				 struct rsnd_dai_stream *io);
382 
383 /*
384  *	R-Car sound priv
385  */
386 struct rsnd_of_data {
387 	u32 flags;
388 };
389 
390 struct rsnd_priv {
391 
392 	struct platform_device *pdev;
393 	struct rcar_snd_info *info;
394 	spinlock_t lock;
395 
396 	/*
397 	 * below value will be filled on rsnd_gen_probe()
398 	 */
399 	void *gen;
400 
401 	/*
402 	 * below value will be filled on rsnd_src_probe()
403 	 */
404 	void *src;
405 	int src_nr;
406 
407 	/*
408 	 * below value will be filled on rsnd_adg_probe()
409 	 */
410 	void *adg;
411 
412 	/*
413 	 * below value will be filled on rsnd_dma_probe()
414 	 */
415 	void *dma;
416 
417 	/*
418 	 * below value will be filled on rsnd_ssi_probe()
419 	 */
420 	void *ssi;
421 	int ssi_nr;
422 
423 	/*
424 	 * below value will be filled on rsnd_dvc_probe()
425 	 */
426 	void *dvc;
427 	int dvc_nr;
428 
429 	/*
430 	 * below value will be filled on rsnd_dai_probe()
431 	 */
432 	struct snd_soc_dai_driver *daidrv;
433 	struct rsnd_dai *rdai;
434 	int rdai_nr;
435 };
436 
437 #define rsnd_priv_to_pdev(priv)	((priv)->pdev)
438 #define rsnd_priv_to_dev(priv)	(&(rsnd_priv_to_pdev(priv)->dev))
439 #define rsnd_priv_to_info(priv)	((priv)->info)
440 #define rsnd_lock(priv, flags) spin_lock_irqsave(&priv->lock, flags)
441 #define rsnd_unlock(priv, flags) spin_unlock_irqrestore(&priv->lock, flags)
442 
443 /*
444  *	rsnd_kctrl
445  */
446 struct rsnd_kctrl_cfg {
447 	unsigned int max;
448 	unsigned int size;
449 	u32 *val;
450 	const char * const *texts;
451 	void (*update)(struct rsnd_mod *mod);
452 	struct snd_card *card;
453 	struct snd_kcontrol *kctrl;
454 };
455 
456 #define RSND_DVC_CHANNELS	2
457 struct rsnd_kctrl_cfg_m {
458 	struct rsnd_kctrl_cfg cfg;
459 	u32 val[RSND_DVC_CHANNELS];
460 };
461 
462 struct rsnd_kctrl_cfg_s {
463 	struct rsnd_kctrl_cfg cfg;
464 	u32 val;
465 };
466 
467 void _rsnd_kctrl_remove(struct rsnd_kctrl_cfg *cfg);
468 #define rsnd_kctrl_remove(_cfg)	_rsnd_kctrl_remove(&((_cfg).cfg))
469 
470 int rsnd_kctrl_new_m(struct rsnd_mod *mod,
471 		     struct snd_soc_pcm_runtime *rtd,
472 		     const unsigned char *name,
473 		     void (*update)(struct rsnd_mod *mod),
474 		     struct rsnd_kctrl_cfg_m *_cfg,
475 		     u32 max);
476 int rsnd_kctrl_new_s(struct rsnd_mod *mod,
477 		     struct snd_soc_pcm_runtime *rtd,
478 		     const unsigned char *name,
479 		     void (*update)(struct rsnd_mod *mod),
480 		     struct rsnd_kctrl_cfg_s *_cfg,
481 		     u32 max);
482 int rsnd_kctrl_new_e(struct rsnd_mod *mod,
483 		     struct snd_soc_pcm_runtime *rtd,
484 		     const unsigned char *name,
485 		     struct rsnd_kctrl_cfg_s *_cfg,
486 		     void (*update)(struct rsnd_mod *mod),
487 		     const char * const *texts,
488 		     u32 max);
489 
490 /*
491  *	R-Car SRC
492  */
493 int rsnd_src_probe(struct platform_device *pdev,
494 		   const struct rsnd_of_data *of_data,
495 		   struct rsnd_priv *priv);
496 struct rsnd_mod *rsnd_src_mod_get(struct rsnd_priv *priv, int id);
497 unsigned int rsnd_src_get_ssi_rate(struct rsnd_priv *priv,
498 				   struct rsnd_dai_stream *io,
499 				   struct snd_pcm_runtime *runtime);
500 int rsnd_src_ssiu_start(struct rsnd_mod *ssi_mod,
501 			int use_busif);
502 int rsnd_src_ssiu_stop(struct rsnd_mod *ssi_mod);
503 int rsnd_src_ssi_irq_enable(struct rsnd_mod *ssi_mod);
504 int rsnd_src_ssi_irq_disable(struct rsnd_mod *ssi_mod);
505 
506 #define rsnd_src_nr(priv) ((priv)->src_nr)
507 
508 /*
509  *	R-Car SSI
510  */
511 int rsnd_ssi_probe(struct platform_device *pdev,
512 		   const struct rsnd_of_data *of_data,
513 		   struct rsnd_priv *priv);
514 struct rsnd_mod *rsnd_ssi_mod_get(struct rsnd_priv *priv, int id);
515 int rsnd_ssi_is_pin_sharing(struct rsnd_mod *mod);
516 int rsnd_ssi_is_dma_mode(struct rsnd_mod *mod);
517 int rsnd_ssi_use_busif(struct rsnd_mod *mod);
518 
519 /*
520  *	R-Car DVC
521  */
522 int rsnd_dvc_probe(struct platform_device *pdev,
523 		   const struct rsnd_of_data *of_data,
524 		   struct rsnd_priv *priv);
525 void rsnd_dvc_remove(struct platform_device *pdev,
526 		     struct rsnd_priv *priv);
527 struct rsnd_mod *rsnd_dvc_mod_get(struct rsnd_priv *priv, int id);
528 
529 #define rsnd_dvc_nr(priv) ((priv)->dvc_nr)
530 
531 
532 #endif
533