From: "Mylène Josserand" <mylene.josserand@free-electrons.com> To: lgirdwood@gmail.com, broonie@kernel.org, perex@perex.cz, tiwai@suse.com, maxime.ripard@free-electrons.com, wens@csie.org, mturquette@baylibre.com, sboyd@codeaurora.org, mark.rutland@arm.com, robh+dt@kernel.org Cc: linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-clk@vger.kernel.org, alsa-devel@alsa-project.org, devicetree@vger.kernel.org, linux-sunxi@googlegroups.com, thomas.petazzoni@free-electrons.com, mylene.josserand@free-electrons.com, alexandre.belloni@free-electrons.com Subject: [PATCH v2 07/10] dt-bindings: sound: Add sun8i audio documentation Date: Tue, 17 Jan 2017 15:02:27 +0100 [thread overview] Message-ID: <20170117140230.23142-8-mylene.josserand@free-electrons.com> (raw) In-Reply-To: <20170117140230.23142-1-mylene.josserand@free-electrons.com> Add the documentation for dt-binding of the digital audio codec driver and the audio card driver for Sun8i SoCs. Signed-off-by: Mylène Josserand <mylene.josserand@free-electrons.com> --- .../devicetree/bindings/sound/sun8i-codec.txt | 76 ++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/sun8i-codec.txt diff --git a/Documentation/devicetree/bindings/sound/sun8i-codec.txt b/Documentation/devicetree/bindings/sound/sun8i-codec.txt new file mode 100644 index 000000000000..ce3c05219e33 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/sun8i-codec.txt @@ -0,0 +1,76 @@ +Allwinner SUN8I audio codec +------------------------------------ + +On Sun8i SoCs, and particularly on A33, the audio is separated in +different parts: + - A DAI driver. It uses the "sun4i-i2s" driver which is + documented here: + Documentation/devicetree/bindings/sound/sun4i-i2s.txt + - An analog part of the codec which is handled as PRCM registers. + See Documentation/devicetree/bindings/sound/sun8i-codec-analog.txt + - An digital part of the codec which is documented in this current + binding documentation. + - And finally, an audio card which links all the above components. + The simple-audio card will be used. + See Documentation/devicetree/bindings/sound/simple-card.txt + +This bindings documentation exposes Sun8i codec (digital part). + +Required properties: +- compatible: must be "allwinner,sun8i-a33-codec" +- reg: must contain the registers location and length +- interrupts: must contain the codec interrupt +- clocks: a list of phandle + clock-specifer pairs, one for each entry + in clock-names. +- clock-names: should contain followings: + - "bus": the parent APB clock for this controller + - "mod": the parent module clock + +Example: +codec: codec@01c22e00 { + #sound-dai-cells = <0>; + compatible = "allwinner,sun8i-a33-codec"; + reg = <0x01c22e00 0x400>; + interrupts = <GIC_SPI 29 IRQ_TYPE_LEVEL_HIGH>; + clocks = <&ccu CLK_BUS_CODEC>, <&ccu CLK_AC_DIG>; + clock-names = "bus", "mod"; + status = "disabled"; +}; + +Here is an example to add a sound card and the codec binding on sun8i SoCs that +are similar to A33 using simple-card: + + sound { + compatible = "simple-audio-card"; + simple-audio-card,name = "Sun8i Audio Card"; + simple-audio-card,format = "i2s"; + simple-audio-card,frame-master = <&link_codec>; + simple-audio-card,bitclock-master = <&link_codec>; + simple-audio-card,mclk-fs = <512>; + simple-audio-card,aux-devs = <&codec_analog>; + simple-audio-card,routing = + "Left DAC", "Digital Left DAC", + "Right DAC", "Digital Right DAC"; + + simple-audio-card,cpu { + sound-dai = <&dai>; + }; + + link_codec: simple-audio-card,codec { + sound-dai = <&codec>; + }; + + soc@01c00000 { + [...] + + codec: codec@01c22e00 { + #sound-dai-cells = <0>; + compatible = "allwinner,sun8i-a33-codec"; + reg = <0x01c22e00 0x400>; + interrupts = <GIC_SPI 29 IRQ_TYPE_LEVEL_HIGH>; + clocks = <&ccu CLK_BUS_CODEC>, <&ccu CLK_AC_DIG>; + clock-names = "bus", "mod"; + status = "disabled"; + }; + }; + -- 2.11.0
WARNING: multiple messages have this Message-ID (diff)
From: mylene.josserand@free-electrons.com (Mylène Josserand) To: linux-arm-kernel@lists.infradead.org Subject: [PATCH v2 07/10] dt-bindings: sound: Add sun8i audio documentation Date: Tue, 17 Jan 2017 15:02:27 +0100 [thread overview] Message-ID: <20170117140230.23142-8-mylene.josserand@free-electrons.com> (raw) In-Reply-To: <20170117140230.23142-1-mylene.josserand@free-electrons.com> Add the documentation for dt-binding of the digital audio codec driver and the audio card driver for Sun8i SoCs. Signed-off-by: Myl?ne Josserand <mylene.josserand@free-electrons.com> --- .../devicetree/bindings/sound/sun8i-codec.txt | 76 ++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/sun8i-codec.txt diff --git a/Documentation/devicetree/bindings/sound/sun8i-codec.txt b/Documentation/devicetree/bindings/sound/sun8i-codec.txt new file mode 100644 index 000000000000..ce3c05219e33 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/sun8i-codec.txt @@ -0,0 +1,76 @@ +Allwinner SUN8I audio codec +------------------------------------ + +On Sun8i SoCs, and particularly on A33, the audio is separated in +different parts: + - A DAI driver. It uses the "sun4i-i2s" driver which is + documented here: + Documentation/devicetree/bindings/sound/sun4i-i2s.txt + - An analog part of the codec which is handled as PRCM registers. + See Documentation/devicetree/bindings/sound/sun8i-codec-analog.txt + - An digital part of the codec which is documented in this current + binding documentation. + - And finally, an audio card which links all the above components. + The simple-audio card will be used. + See Documentation/devicetree/bindings/sound/simple-card.txt + +This bindings documentation exposes Sun8i codec (digital part). + +Required properties: +- compatible: must be "allwinner,sun8i-a33-codec" +- reg: must contain the registers location and length +- interrupts: must contain the codec interrupt +- clocks: a list of phandle + clock-specifer pairs, one for each entry + in clock-names. +- clock-names: should contain followings: + - "bus": the parent APB clock for this controller + - "mod": the parent module clock + +Example: +codec: codec at 01c22e00 { + #sound-dai-cells = <0>; + compatible = "allwinner,sun8i-a33-codec"; + reg = <0x01c22e00 0x400>; + interrupts = <GIC_SPI 29 IRQ_TYPE_LEVEL_HIGH>; + clocks = <&ccu CLK_BUS_CODEC>, <&ccu CLK_AC_DIG>; + clock-names = "bus", "mod"; + status = "disabled"; +}; + +Here is an example to add a sound card and the codec binding on sun8i SoCs that +are similar to A33 using simple-card: + + sound { + compatible = "simple-audio-card"; + simple-audio-card,name = "Sun8i Audio Card"; + simple-audio-card,format = "i2s"; + simple-audio-card,frame-master = <&link_codec>; + simple-audio-card,bitclock-master = <&link_codec>; + simple-audio-card,mclk-fs = <512>; + simple-audio-card,aux-devs = <&codec_analog>; + simple-audio-card,routing = + "Left DAC", "Digital Left DAC", + "Right DAC", "Digital Right DAC"; + + simple-audio-card,cpu { + sound-dai = <&dai>; + }; + + link_codec: simple-audio-card,codec { + sound-dai = <&codec>; + }; + + soc at 01c00000 { + [...] + + codec: codec at 01c22e00 { + #sound-dai-cells = <0>; + compatible = "allwinner,sun8i-a33-codec"; + reg = <0x01c22e00 0x400>; + interrupts = <GIC_SPI 29 IRQ_TYPE_LEVEL_HIGH>; + clocks = <&ccu CLK_BUS_CODEC>, <&ccu CLK_AC_DIG>; + clock-names = "bus", "mod"; + status = "disabled"; + }; + }; + -- 2.11.0
next prev parent reply other threads:[~2017-01-17 14:05 UTC|newest] Thread overview: 66+ messages / expand[flat|nested] mbox.gz Atom feed top 2017-01-17 14:02 [PATCH v2 00/10] Add sun8i A33 audio driver Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 14:02 ` [PATCH v2 01/10] ASoC: sun4i-i2s: Increase DMA max burst to 8 Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 16:41 ` Maxime Ripard 2017-01-17 16:41 ` Maxime Ripard 2017-01-17 16:41 ` Maxime Ripard 2017-01-17 18:44 ` Applied "ASoC: sun4i-i2s: Increase DMA max burst to 8" to the asoc tree Mark Brown 2017-01-17 18:44 ` Mark Brown 2017-01-17 18:44 ` Mark Brown 2017-01-17 14:02 ` [PATCH v2 02/10] clk: ccu-sun8i-a33: Add CLK_SET_RATE_PARENT to ac-dig Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 16:44 ` Maxime Ripard 2017-01-17 16:44 ` Maxime Ripard 2017-01-17 16:44 ` Maxime Ripard 2017-01-18 7:58 ` Mylene Josserand 2017-01-18 7:58 ` Mylene Josserand 2017-01-17 14:02 ` [PATCH v2 03/10] dt-bindings: sound: Add new reset compatible for sun4i-i2s Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 16:46 ` Maxime Ripard 2017-01-17 16:46 ` Maxime Ripard 2017-01-17 16:46 ` Maxime Ripard 2017-01-18 8:23 ` Mylene Josserand 2017-01-18 8:23 ` Mylene Josserand 2017-01-17 14:02 ` [PATCH v2 04/10] ASoC: sun4i-i2s: Add quirks to handle new compatible for reset Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 16:47 ` Maxime Ripard 2017-01-17 16:47 ` Maxime Ripard 2017-01-17 16:47 ` Maxime Ripard 2017-01-17 14:02 ` [PATCH v2 05/10] ASoC: Add sun8i digital audio codec Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 16:20 ` Mylene Josserand 2017-01-17 16:20 ` Mylene Josserand 2017-01-17 14:02 ` [PATCH v2 06/10] ASoC: sun8i-codec-analog: Add amplifier event to fix first delay Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 16:49 ` Maxime Ripard 2017-01-17 16:49 ` Maxime Ripard 2017-01-17 16:49 ` Maxime Ripard 2017-02-03 12:03 ` Applied "ASoC: sun8i-codec-analog: Add amplifier event to fix first delay" to the asoc tree Mark Brown 2017-02-03 12:03 ` Mark Brown 2017-02-03 12:03 ` Mark Brown 2017-01-17 14:02 ` Mylène Josserand [this message] 2017-01-17 14:02 ` [PATCH v2 07/10] dt-bindings: sound: Add sun8i audio documentation Mylène Josserand 2017-01-17 16:50 ` Mark Brown 2017-01-17 16:50 ` Mark Brown 2017-01-18 8:25 ` Mylene Josserand 2017-01-18 8:25 ` Mylene Josserand 2017-01-17 16:51 ` Maxime Ripard 2017-01-17 16:51 ` Maxime Ripard 2017-01-17 16:51 ` Maxime Ripard 2017-01-17 14:02 ` [PATCH v2 08/10] ARM: dts: sun8i: Add audio codec, dai and card for A33 Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 16:58 ` Maxime Ripard 2017-01-17 16:58 ` Maxime Ripard 2017-01-17 16:58 ` Maxime Ripard 2017-01-17 14:02 ` [PATCH v2 09/10] ARM: dts: sun8i: parrot: Enable audio nodes Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 14:02 ` [PATCH v2 10/10] ARM: dts: sun8i: sinlinx: " Mylène Josserand 2017-01-17 14:02 ` Mylène Josserand 2017-01-17 17:14 [PATCH v2 07/10] dt-bindings: sound: Add sun8i audio documentation Icenowy Zheng 2017-01-17 17:14 ` Icenowy Zheng
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20170117140230.23142-8-mylene.josserand@free-electrons.com \ --to=mylene.josserand@free-electrons.com \ --cc=alexandre.belloni@free-electrons.com \ --cc=alsa-devel@alsa-project.org \ --cc=broonie@kernel.org \ --cc=devicetree@vger.kernel.org \ --cc=lgirdwood@gmail.com \ --cc=linux-arm-kernel@lists.infradead.org \ --cc=linux-clk@vger.kernel.org \ --cc=linux-kernel@vger.kernel.org \ --cc=linux-sunxi@googlegroups.com \ --cc=mark.rutland@arm.com \ --cc=maxime.ripard@free-electrons.com \ --cc=mturquette@baylibre.com \ --cc=perex@perex.cz \ --cc=robh+dt@kernel.org \ --cc=sboyd@codeaurora.org \ --cc=thomas.petazzoni@free-electrons.com \ --cc=tiwai@suse.com \ --cc=wens@csie.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.