1Renesas R-Car sound
2
3=============================================
4* Modules
5=============================================
6
7Renesas R-Car and RZ/G sound is constructed from below modules
8(for Gen2 or later)
9
10 SCU		: Sampling Rate Converter Unit
11  - SRC		: Sampling Rate Converter
12  - CMD
13   - CTU	: Channel Transfer Unit
14   - MIX	: Mixer
15   - DVC	: Digital Volume and Mute Function
16 SSIU		: Serial Sound Interface Unit
17 SSI		: Serial Sound Interface
18
19See detail of each module's channels, connection, limitation on datasheet
20
21=============================================
22* Multi channel
23=============================================
24
25Multi channel is supported by Multi-SSI, or TDM-SSI.
26
27 Multi-SSI	: 6ch case, you can use stereo x 3 SSI
28 TDM-SSI	: 6ch case, you can use TDM
29
30=============================================
31* Enable/Disable each modules
32=============================================
33
34See datasheet to check SRC/CTU/MIX/DVC connect-limitation.
35DT controls enabling/disabling module.
36${LINUX}/arch/arm/boot/dts/r8a7790-lager.dts can be good example.
37This is example of
38
39Playback: [MEM] -> [SRC2] -> [DVC0] -> [SSIU0/SSI0] -> [codec]
40Capture:  [MEM] <- [DVC1] <- [SRC3] <- [SSIU1/SSI1] <- [codec]
41
42see "Example: simple sound card"
43
44You can use below.
45${LINUX}/arch/arm/boot/dts/r8a7790.dts can be good example.
46
47	&src0	&ctu00	&mix0	&dvc0	&ssi0
48	&src1	&ctu01	&mix1	&dvc1	&ssi1
49	&src2	&ctu02			&ssi2
50	&src3	&ctu03			&ssi3
51	&src4				&ssi4
52	&src5	&ctu10			&ssi5
53	&src6	&ctu11			&ssi6
54	&src7	&ctu12			&ssi7
55	&src8	&ctu13			&ssi8
56	&src9				&ssi9
57
58=============================================
59* SRC (Sampling Rate Converter)
60=============================================
61
62 [xx]Hz        [yy]Hz
63 ------> [SRC] ------>
64
65SRC can convert [xx]Hz to [yy]Hz. Then, it has below 2 modes
66
67 Asynchronous mode:	input data / output data are based on different clocks.
68			you can use this mode on Playback / Capture
69 Synchronous mode:	input data / output data are based on same clocks.
70			This mode will be used if system doesn't have its input clock,
71			for example digital TV case.
72			you can use this mode on Playback
73
74------------------
75**     Asynchronous mode
76------------------
77
78You need to use "simple-scu-audio-card" or "audio-graph-scu-card" for it.
79see "Example: simple sound card for Asynchronous mode"
80
81------------------
82**     Synchronous mode
83------------------
84
85	> amixer set "SRC Out Rate" on
86	> aplay xxxx.wav
87	> amixer set "SRC Out Rate" 48000
88	> amixer set "SRC Out Rate" 44100
89
90=============================================
91* CTU (Channel Transfer Unit)
92=============================================
93
94 [xx]ch        [yy]ch
95 ------> [CTU] -------->
96
97CTU can convert [xx]ch to [yy]ch, or exchange outputed channel.
98CTU conversion needs matrix settings.
99For more detail information, see below
100
101	Renesas R-Car datasheet
102	 - Sampling Rate Converter Unit (SCU)
103	  - SCU Operation
104	   - CMD Block
105	    - Functional Blocks in CMD
106
107	Renesas R-Car datasheet
108	 - Sampling Rate Converter Unit (SCU)
109	  - Register Description
110	   - CTUn Scale Value exx Register (CTUn_SVxxR)
111
112	${LINUX}/sound/soc/sh/rcar/ctu.c
113	 - comment of header
114
115You need to use "simple-scu-audio-card" or "audio-graph-scu-card" for it.
116see "Example: simple sound card for channel convert"
117
118Ex) Exchange output channel
119 Input -> Output
120  1ch  ->  0ch
121  0ch  ->  1ch
122
123  example of using matrix
124	output 0ch = (input 0ch x 0) + (input 1ch x 1)
125	output 1ch = (input 0ch x 1) + (input 1ch x 0)
126
127	amixer set "CTU Reset" on
128	amixer set "CTU Pass" 9,10
129	amixer set "CTU SV0" 0,4194304
130	amixer set "CTU SV1" 4194304,0
131
132 example of changing connection
133	amixer set "CTU Reset" on
134	amixer set "CTU Pass" 2,1
135
136=============================================
137* MIX (Mixer)
138=============================================
139
140MIX merges 2 sounds path. You can see 2 sound interface on system,
141and these sounds will be merged by MIX.
142
143	aplay -D plughw:0,0 xxxx.wav &
144	aplay -D plughw:0,1 yyyy.wav
145
146You need to use "simple-scu-audio-card" or "audio-graph-scu-card" for it.
147Ex)
148	[MEM] -> [SRC1] -> [CTU02] -+-> [MIX0] -> [DVC0] -> [SSI0]
149	                            |
150	[MEM] -> [SRC2] -> [CTU03] -+
151
152see "Example: simple sound card for MIXer"
153
154=============================================
155* DVC (Digital Volume and Mute Function)
156=============================================
157
158DVC controls Playback/Capture volume.
159
160Playback Volume
161	amixer set "DVC Out" 100%
162
163Capture Volume
164	amixer set "DVC In" 100%
165
166Playback Mute
167	amixer set "DVC Out Mute" on
168
169Capture Mute
170	amixer set "DVC In Mute" on
171
172Volume Ramp
173	amixer set "DVC Out Ramp Up Rate"   "0.125 dB/64 steps"
174	amixer set "DVC Out Ramp Down Rate" "0.125 dB/512 steps"
175	amixer set "DVC Out Ramp" on
176	aplay xxx.wav &
177	amixer set "DVC Out"  80%  // Volume Down
178	amixer set "DVC Out" 100%  // Volume Up
179
180=============================================
181* SSIU (Serial Sound Interface Unit)
182=============================================
183
184SSIU can avoid some under/over run error, because it has some buffer.
185But you can't use it if SSI was PIO mode.
186In DMA mode, you can select not to use SSIU by using "no-busif" via SSI.
187
188SSIU handles BUSIF which will be used for TDM Split mode.
189This driver is assuming that audio-graph card will be used.
190
191TDM Split mode merges 4 sounds. You can see 4 sound interface on system,
192and these sounds will be merged SSIU/SSI.
193
194	aplay -D plughw:0,0 xxxx.wav &
195	aplay -D plughw:0,1 xxxx.wav &
196	aplay -D plughw:0,2 xxxx.wav &
197	aplay -D plughw:0,3 xxxx.wav
198
199	          2ch                     8ch
200	[MEM] -> [SSIU 30] -+-> [SSIU 3] --> [Codec]
201	          2ch       |
202	[MEM] -> [SSIU 31] -+
203	          2ch       |
204	[MEM] -> [SSIU 32] -+
205	          2ch       |
206	[MEM] -> [SSIU 33] -+
207
208see "Example: simple sound card for TDM Split"
209
210=============================================
211* SSI (Serial Sound Interface)
212=============================================
213
214**  PIO mode
215
216You can use PIO mode which is for connection check by using.
217Note: The system will drop non-SSI modules in PIO mode
218even though if DT is selecting other modules.
219
220	&ssi0 {
221		pio-transfer
222	};
223
224** DMA mode without SSIU
225
226You can use DMA without SSIU.
227Note: under/over run, or noise are likely to occur
228
229	&ssi0 {
230		no-busif;
231	};
232
233** PIN sharing
234
235Each SSI can share WS pin. It is based on platform.
236This is example if SSI1 want to share WS pin with SSI0
237
238	&ssi1 {
239		shared-pin;
240	};
241
242** Multi-SSI
243
244You can use Multi-SSI.
245This is example of SSI0/SSI1/SSI2 (= for 6ch)
246
247see "Example: simple sound card for Multi channel"
248
249** TDM-SSI
250
251You can use TDM with SSI.
252This is example of TDM 6ch.
253Driver can automatically switches TDM <-> stereo mode in this case.
254
255see "Example: simple sound card for TDM"
256
257=============================================
258Required properties:
259=============================================
260
261- compatible			: "renesas,rcar_sound-<soctype>", fallbacks
262				  "renesas,rcar_sound-gen1" if generation1, and
263				  "renesas,rcar_sound-gen2" if generation2 (or RZ/G1)
264				  "renesas,rcar_sound-gen3" if generation3 (or RZ/G2)
265				  Examples with soctypes are:
266				    - "renesas,rcar_sound-r8a7743" (RZ/G1M)
267				    - "renesas,rcar_sound-r8a7744" (RZ/G1N)
268				    - "renesas,rcar_sound-r8a7745" (RZ/G1E)
269				    - "renesas,rcar_sound-r8a77470" (RZ/G1C)
270				    - "renesas,rcar_sound-r8a774a1" (RZ/G2M)
271				    - "renesas,rcar_sound-r8a774c0" (RZ/G2E)
272				    - "renesas,rcar_sound-r8a7778" (R-Car M1A)
273				    - "renesas,rcar_sound-r8a7779" (R-Car H1)
274				    - "renesas,rcar_sound-r8a7790" (R-Car H2)
275				    - "renesas,rcar_sound-r8a7791" (R-Car M2-W)
276				    - "renesas,rcar_sound-r8a7793" (R-Car M2-N)
277				    - "renesas,rcar_sound-r8a7794" (R-Car E2)
278				    - "renesas,rcar_sound-r8a7795" (R-Car H3)
279				    - "renesas,rcar_sound-r8a7796" (R-Car M3-W)
280				    - "renesas,rcar_sound-r8a77965" (R-Car M3-N)
281				    - "renesas,rcar_sound-r8a77990" (R-Car E3)
282				    - "renesas,rcar_sound-r8a77995" (R-Car D3)
283- reg				: Should contain the register physical address.
284				  required register is
285				   SRU/ADG/SSI      if generation1
286				   SRU/ADG/SSIU/SSI/AUDIO-DMAC-periperi if generation2/generation3
287				   Select extended AUDIO-DMAC-periperi address if SoC has it,
288				   otherwise select normal AUDIO-DMAC-periperi address.
289- reg-names			: Should contain the register names.
290				   scu/adg/ssi	if generation1
291				   scu/adg/ssiu/ssi/audmapp if generation2/generation3
292- rcar_sound,ssi		: Should contain SSI feature.
293				  The number of SSI subnode should be same as HW.
294				  see below for detail.
295- rcar_sound,ssiu		: Should contain SSIU feature.
296				  The number of SSIU subnode should be same as HW.
297				  see below for detail.
298- rcar_sound,src		: Should contain SRC feature.
299				  The number of SRC subnode should be same as HW.
300				  see below for detail.
301- rcar_sound,ctu		: Should contain CTU feature.
302				  The number of CTU subnode should be same as HW.
303				  see below for detail.
304- rcar_sound,mix		: Should contain MIX feature.
305				  The number of MIX subnode should be same as HW.
306				  see below for detail.
307- rcar_sound,dvc		: Should contain DVC feature.
308				  The number of DVC subnode should be same as HW.
309				  see below for detail.
310- rcar_sound,dai		: DAI contents.
311				  The number of DAI subnode should be same as HW.
312				  see below for detail.
313- #sound-dai-cells		: it must be 0 if your system is using single DAI
314				  it must be 1 if your system is using multi  DAI
315- clocks			: References to SSI/SRC/MIX/CTU/DVC/AUDIO_CLK clocks.
316- clock-names			: List of necessary clock names.
317				  "ssi-all", "ssi.X", "src.X", "mix.X", "ctu.X",
318				  "dvc.X", "clk_a", "clk_b", "clk_c", "clk_i"
319
320Optional properties:
321- #clock-cells			: it must be 0 if your system has audio_clkout
322				  it must be 1 if your system has audio_clkout0/1/2/3
323- clock-frequency		: for all audio_clkout0/1/2/3
324- clkout-lr-asynchronous	: boolean property. it indicates that audio_clkoutn
325				  is asynchronizes with lr-clock.
326- resets			: References to SSI resets.
327- reset-names			: List of valid reset names.
328				  "ssi-all", "ssi.X"
329
330SSI subnode properties:
331- interrupts			: Should contain SSI interrupt for PIO transfer
332- shared-pin			: if shared clock pin
333- pio-transfer			: use PIO transfer mode
334- no-busif			: BUSIF is not ussed when [mem -> SSI] via DMA case
335- dma				: Should contain Audio DMAC entry
336- dma-names			: SSI  case "rx"  (=playback), "tx"  (=capture)
337				  Deprecated: see SSIU subnode properties
338				  SSIU case "rxu" (=playback), "txu" (=capture)
339
340SSIU subnode properties:
341- dma				: Should contain Audio DMAC entry
342- dma-names			: "rx" (=playback), "tx" (=capture)
343
344SRC subnode properties:
345- dma				: Should contain Audio DMAC entry
346- dma-names			: "rx" (=playback), "tx" (=capture)
347
348DVC subnode properties:
349- dma				: Should contain Audio DMAC entry
350- dma-names			: "tx" (=playback/capture)
351
352DAI subnode properties:
353- playback			: list of playback modules
354- capture			: list of capture  modules
355
356
357=============================================
358Example:
359=============================================
360
361rcar_sound: sound@ec500000 {
362	#sound-dai-cells = <1>;
363	compatible = "renesas,rcar_sound-r8a7791", "renesas,rcar_sound-gen2";
364	reg =	<0 0xec500000 0 0x1000>, /* SCU */
365		<0 0xec5a0000 0 0x100>,  /* ADG */
366		<0 0xec540000 0 0x1000>, /* SSIU */
367		<0 0xec541000 0 0x1280>, /* SSI */
368		<0 0xec740000 0 0x200>;  /* Audio DMAC peri peri*/
369	reg-names = "scu", "adg", "ssiu", "ssi", "audmapp";
370
371	clocks = <&mstp10_clks R8A7790_CLK_SSI_ALL>,
372		<&mstp10_clks R8A7790_CLK_SSI9>, <&mstp10_clks R8A7790_CLK_SSI8>,
373		<&mstp10_clks R8A7790_CLK_SSI7>, <&mstp10_clks R8A7790_CLK_SSI6>,
374		<&mstp10_clks R8A7790_CLK_SSI5>, <&mstp10_clks R8A7790_CLK_SSI4>,
375		<&mstp10_clks R8A7790_CLK_SSI3>, <&mstp10_clks R8A7790_CLK_SSI2>,
376		<&mstp10_clks R8A7790_CLK_SSI1>, <&mstp10_clks R8A7790_CLK_SSI0>,
377		<&mstp10_clks R8A7790_CLK_SCU_SRC9>, <&mstp10_clks R8A7790_CLK_SCU_SRC8>,
378		<&mstp10_clks R8A7790_CLK_SCU_SRC7>, <&mstp10_clks R8A7790_CLK_SCU_SRC6>,
379		<&mstp10_clks R8A7790_CLK_SCU_SRC5>, <&mstp10_clks R8A7790_CLK_SCU_SRC4>,
380		<&mstp10_clks R8A7790_CLK_SCU_SRC3>, <&mstp10_clks R8A7790_CLK_SCU_SRC2>,
381		<&mstp10_clks R8A7790_CLK_SCU_SRC1>, <&mstp10_clks R8A7790_CLK_SCU_SRC0>,
382		<&mstp10_clks R8A7790_CLK_SCU_DVC0>, <&mstp10_clks R8A7790_CLK_SCU_DVC1>,
383		<&audio_clk_a>, <&audio_clk_b>, <&audio_clk_c>, <&m2_clk>;
384	clock-names = "ssi-all",
385			"ssi.9", "ssi.8", "ssi.7", "ssi.6", "ssi.5",
386			"ssi.4", "ssi.3", "ssi.2", "ssi.1", "ssi.0",
387			"src.9", "src.8", "src.7", "src.6", "src.5",
388			"src.4", "src.3", "src.2", "src.1", "src.0",
389			"dvc.0", "dvc.1",
390			"clk_a", "clk_b", "clk_c", "clk_i";
391
392	rcar_sound,dvc {
393		dvc0: dvc-0 {
394			dmas = <&audma0 0xbc>;
395			dma-names = "tx";
396		};
397		dvc1: dvc-1 {
398			dmas = <&audma0 0xbe>;
399			dma-names = "tx";
400		};
401	};
402
403	rcar_sound,mix {
404		mix0: mix-0 { };
405		mix1: mix-1 { };
406	};
407
408	rcar_sound,ctu {
409		ctu00: ctu-0 { };
410		ctu01: ctu-1 { };
411		ctu02: ctu-2 { };
412		ctu03: ctu-3 { };
413		ctu10: ctu-4 { };
414		ctu11: ctu-5 { };
415		ctu12: ctu-6 { };
416		ctu13: ctu-7 { };
417	};
418
419	rcar_sound,src {
420		src0: src-0 {
421			interrupts = <0 352 IRQ_TYPE_LEVEL_HIGH>;
422			dmas = <&audma0 0x85>, <&audma1 0x9a>;
423			dma-names = "rx", "tx";
424		};
425		src1: src-1 {
426			interrupts = <0 353 IRQ_TYPE_LEVEL_HIGH>;
427			dmas = <&audma0 0x87>, <&audma1 0x9c>;
428			dma-names = "rx", "tx";
429		};
430		src2: src-2 {
431			interrupts = <0 354 IRQ_TYPE_LEVEL_HIGH>;
432			dmas = <&audma0 0x89>, <&audma1 0x9e>;
433			dma-names = "rx", "tx";
434		};
435		src3: src-3 {
436			interrupts = <0 355 IRQ_TYPE_LEVEL_HIGH>;
437			dmas = <&audma0 0x8b>, <&audma1 0xa0>;
438			dma-names = "rx", "tx";
439		};
440		src4: src-4 {
441			interrupts = <0 356 IRQ_TYPE_LEVEL_HIGH>;
442			dmas = <&audma0 0x8d>, <&audma1 0xb0>;
443			dma-names = "rx", "tx";
444		};
445		src5: src-5 {
446			interrupts = <0 357 IRQ_TYPE_LEVEL_HIGH>;
447			dmas = <&audma0 0x8f>, <&audma1 0xb2>;
448			dma-names = "rx", "tx";
449		};
450		src6: src-6 {
451			interrupts = <0 358 IRQ_TYPE_LEVEL_HIGH>;
452			dmas = <&audma0 0x91>, <&audma1 0xb4>;
453			dma-names = "rx", "tx";
454		};
455		src7: src-7 {
456			interrupts = <0 359 IRQ_TYPE_LEVEL_HIGH>;
457			dmas = <&audma0 0x93>, <&audma1 0xb6>;
458			dma-names = "rx", "tx";
459		};
460		src8: src-8 {
461			interrupts = <0 360 IRQ_TYPE_LEVEL_HIGH>;
462			dmas = <&audma0 0x95>, <&audma1 0xb8>;
463			dma-names = "rx", "tx";
464		};
465		src9: src-9 {
466			interrupts = <0 361 IRQ_TYPE_LEVEL_HIGH>;
467			dmas = <&audma0 0x97>, <&audma1 0xba>;
468			dma-names = "rx", "tx";
469		};
470	};
471
472	rcar_sound,ssiu {
473		ssiu00: ssiu-0 {
474			dmas = <&audma0 0x15>, <&audma1 0x16>;
475			dma-names = "rx", "tx";
476		};
477		ssiu01: ssiu-1 {
478			dmas = <&audma0 0x35>, <&audma1 0x36>;
479			dma-names = "rx", "tx";
480		};
481
482		...
483
484		ssiu95: ssiu-49 {
485			dmas = <&audma0 0xA5>, <&audma1 0xA6>;
486			dma-names = "rx", "tx";
487		};
488		ssiu96: ssiu-50 {
489			dmas = <&audma0 0xA7>, <&audma1 0xA8>;
490			dma-names = "rx", "tx";
491		};
492		ssiu97: ssiu-51 {
493			dmas = <&audma0 0xA9>, <&audma1 0xAA>;
494			dma-names = "rx", "tx";
495		};
496	};
497
498	rcar_sound,ssi {
499		ssi0: ssi-0 {
500			interrupts = <0 370 IRQ_TYPE_LEVEL_HIGH>;
501			dmas = <&audma0 0x01>, <&audma1 0x02>;
502			dma-names = "rx", "tx";
503		};
504		ssi1: ssi-1 {
505			interrupts = <0 371 IRQ_TYPE_LEVEL_HIGH>;
506			dmas = <&audma0 0x03>, <&audma1 0x04>;
507			dma-names = "rx", "tx";
508		};
509
510		...
511
512		ssi8: ssi-8 {
513			interrupts = <0 378 IRQ_TYPE_LEVEL_HIGH>;
514			dmas = <&audma0 0x11>, <&audma1 0x12>;
515			dma-names = "rx", "tx";
516		};
517		ssi9: ssi-9 {
518			interrupts = <0 379 IRQ_TYPE_LEVEL_HIGH>;
519			dmas = <&audma0 0x13>, <&audma1 0x14>;
520			dma-names = "rx", "tx";
521		};
522	};
523
524	rcar_sound,dai {
525		dai0 {
526			playback = <&ssi5 &src5>;
527			capture  = <&ssi6>;
528		};
529		dai1 {
530			playback = <&ssi3>;
531		};
532		dai2 {
533			capture  = <&ssi4>;
534		};
535		dai3 {
536			playback = <&ssi7>;
537		};
538		dai4 {
539			capture  = <&ssi8>;
540		};
541	};
542};
543
544=============================================
545Example: simple sound card
546=============================================
547
548	rsnd_ak4643: sound {
549		compatible = "simple-audio-card";
550
551		simple-audio-card,format = "left_j";
552		simple-audio-card,bitclock-master = <&sndcodec>;
553		simple-audio-card,frame-master = <&sndcodec>;
554
555		sndcpu: simple-audio-card,cpu {
556			sound-dai = <&rcar_sound>;
557		};
558
559		sndcodec: simple-audio-card,codec {
560			sound-dai = <&ak4643>;
561			clocks = <&audio_clock>;
562		};
563	};
564
565&rcar_sound {
566	pinctrl-0 = <&sound_pins &sound_clk_pins>;
567	pinctrl-names = "default";
568
569	/* Single DAI */
570	#sound-dai-cells = <0>;
571
572
573	rcar_sound,dai {
574		dai0 {
575			playback = <&ssi0 &src2 &dvc0>;
576			capture  = <&ssi1 &src3 &dvc1>;
577		};
578	};
579};
580
581&ssi1 {
582	shared-pin;
583};
584
585=============================================
586Example: simple sound card for Asynchronous mode
587=============================================
588
589sound {
590	compatible = "simple-scu-audio-card";
591	...
592	/*
593	 * SRC Asynchronous mode setting
594	 * Playback:
595	 * All input data will be converted to 48kHz
596	 * Capture:
597	 * Inputed 48kHz data will be converted to
598	 * system specified Hz
599	 */
600	simple-audio-card,convert-rate = <48000>;
601	...
602	simple-audio-card,cpu {
603		sound-dai = <&rcar_sound>;
604	};
605	simple-audio-card,codec {
606		...
607	};
608};
609
610=============================================
611Example: simple sound card for channel convert
612=============================================
613
614sound {
615	compatible = "simple-scu-audio-card";
616	...
617	/*
618	 * CTU setting
619	 * All input data will be converted to 2ch
620	 * as output data
621	 */
622	simple-audio-card,convert-channels = <2>;
623	...
624	simple-audio-card,cpu {
625		sound-dai = <&rcar_sound>;
626	};
627	simple-audio-card,codec {
628		...
629	};
630};
631
632=============================================
633Example: simple sound card for MIXer
634=============================================
635
636sound {
637	compatible = "simple-scu-audio-card";
638	...
639	simple-audio-card,cpu@0 {
640		sound-dai = <&rcar_sound 0>;
641	};
642	simple-audio-card,cpu@1 {
643		sound-dai = <&rcar_sound 1>;
644	};
645	simple-audio-card,codec {
646		...
647	};
648};
649
650&rcar_sound {
651	...
652	rcar_sound,dai {
653		dai0 {
654			playback = <&src1 &ctu02 &mix0 &dvc0 &ssi0>;
655		};
656		dai1 {
657			playback = <&src2 &ctu03 &mix0 &dvc0 &ssi0>;
658		};
659	};
660};
661
662=============================================
663Example: simple sound card for TDM
664=============================================
665
666rsnd_tdm: sound {
667	compatible = "simple-audio-card";
668
669	simple-audio-card,format = "left_j";
670	simple-audio-card,bitclock-master = <&sndcodec>;
671	simple-audio-card,frame-master = <&sndcodec>;
672
673	sndcpu: simple-audio-card,cpu {
674		sound-dai = <&rcar_sound>;
675		dai-tdm-slot-num = <6>;
676	};
677
678	sndcodec: simple-audio-card,codec {
679		sound-dai = <&xxx>;
680	};
681};
682
683=============================================
684Example: simple sound card for TDM Split
685=============================================
686
687sound_card: sound {
688	compatible = "audio-graph-scu-card";
689	prefix = "xxxx";
690	routing = "xxxx Playback", "DAI0 Playback",
691		  "xxxx Playback", "DAI1 Playback",
692		  "xxxx Playback", "DAI2 Playback",
693		  "xxxx Playback", "DAI3 Playback";
694	convert-channels = <8>; /* TDM Split */
695
696	dais = <&rsnd_port0     /* playback ch1/ch2 */
697		&rsnd_port1     /* playback ch3/ch4 */
698		&rsnd_port2     /* playback ch5/ch6 */
699		&rsnd_port3     /* playback ch7/ch8 */
700		>;
701};
702
703audio-codec {
704	...
705	port {
706		codec_0: endpoint@1 {
707			remote-endpoint = <&rsnd_ep0>;
708		};
709		codec_1: endpoint@2 {
710			remote-endpoint = <&rsnd_ep1>;
711		};
712		codec_2: endpoint@3 {
713			remote-endpoint = <&rsnd_ep2>;
714		};
715		codec_3: endpoint@4 {
716			remote-endpoint = <&rsnd_ep3>;
717		};
718	};
719};
720
721&rcar_sound {
722	...
723	ports {
724		rsnd_port0: port@0 {
725			rsnd_ep0: endpoint {
726				remote-endpoint = <&codec_0>;
727				...
728				playback = <&ssiu30 &ssi3>;
729			};
730		};
731		rsnd_port1: port@1 {
732			rsnd_ep1: endpoint {
733				remote-endpoint = <&codec_1>;
734				...
735				playback = <&ssiu31 &ssi3>;
736			};
737		};
738		rsnd_port2: port@2 {
739			rsnd_ep2: endpoint {
740				remote-endpoint = <&codec_2>;
741				...
742				playback = <&ssiu32 &ssi3>;
743			};
744		};
745		rsnd_port3: port@3 {
746			rsnd_ep3: endpoint {
747				remote-endpoint = <&codec_3>;
748				...
749				playback = <&ssiu33 &ssi3>;
750			};
751		};
752	};
753};
754
755=============================================
756Example: simple sound card for Multi channel
757=============================================
758
759&rcar_sound {
760	pinctrl-0 = <&sound_pins &sound_clk_pins>;
761	pinctrl-names = "default";
762
763	/* Single DAI */
764	#sound-dai-cells = <0>;
765
766
767	rcar_sound,dai {
768		dai0 {
769			playback = <&ssi0 &ssi1 &ssi2 &src0 &dvc0>;
770		};
771	};
772};
773