linux-clk.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Lubomir Rintel <lkundrak@v3.sk>
To: Stephen Boyd <sboyd@kernel.org>
Cc: Michael Turquette <mturquette@baylibre.com>,
	Rob Herring <robh+dt@kernel.org>,
	linux-clk@vger.kernel.org, devicetree@vger.kernel.org,
	linux-kernel@vger.kernel.org,
	linux-arm-kernel@lists.infradead.org,
	Lubomir Rintel <lkundrak@v3.sk>
Subject: [PATCH v3 12/13] dt-bindings: clock: Add Marvell MMP Audio Clock Controller binding
Date: Wed, 20 May 2020 00:41:50 +0200	[thread overview]
Message-ID: <20200519224151.2074597-13-lkundrak@v3.sk> (raw)
In-Reply-To: <20200519224151.2074597-1-lkundrak@v3.sk>

This describes the bindings for a controller that generates master and bit
clocks for the I2S interface.

Signed-off-by: Lubomir Rintel <lkundrak@v3.sk>

---
Changes since v1:
- Fix commit message wording
- Define MMP2_CLK_AUDIO_NR_CLKS
- Make clock ids start at 0, not 1
- Fix dt-bindings/clock/marvell,mmp2-audio.h file name
- Rename node from "clocks" to "clock-controller"

 .../clock/marvell,mmp2-audio-clock.yaml       | 74 +++++++++++++++++++
 .../dt-bindings/clock/marvell,mmp2-audio.h    | 10 +++
 2 files changed, 84 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/clock/marvell,mmp2-audio-clock.yaml
 create mode 100644 include/dt-bindings/clock/marvell,mmp2-audio.h

diff --git a/Documentation/devicetree/bindings/clock/marvell,mmp2-audio-clock.yaml b/Documentation/devicetree/bindings/clock/marvell,mmp2-audio-clock.yaml
new file mode 100644
index 000000000000..ab6e82d1d3a9
--- /dev/null
+++ b/Documentation/devicetree/bindings/clock/marvell,mmp2-audio-clock.yaml
@@ -0,0 +1,74 @@
+# SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/clock/marvell,mmp2-audio-clock.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Marvell MMP2 Audio Clock Controller
+
+maintainers:
+  - Lubomir Rintel <lkundrak@v3.sk>
+
+description: |
+  The audio clock controller generates and supplies the clocks to the audio
+  codec.
+
+  Each clock is assigned an identifier and client nodes use this identifier
+  to specify the clock which they consume.
+
+  All these identifiers could be found in
+  <dt-bindings/clock/marvell,mmp2-audio.h>.
+
+properties:
+  compatible:
+    enum:
+      - marvell,mmp2-audio-clock
+
+  reg:
+    maxItems: 1
+
+  clocks:
+    items:
+      - description: Audio subsystem clock
+      - description: The crystal oscillator clock
+      - description: First I2S clock
+      - description: Second I2S clock
+
+  clock-names:
+    items:
+      - const: audio
+      - const: vctcxo
+      - const: i2s0
+      - const: i2s1
+
+  '#clock-cells':
+    const: 1
+
+  power-domains:
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+  - clocks
+  - clock-names
+  - '#clock-cells'
+
+additionalProperties: false
+
+examples:
+  - |
+    #include <dt-bindings/clock/marvell,mmp2-audio.h>
+    #include <dt-bindings/power/marvell,mmp2.h>
+
+    clock-controller@d42a0c30 {
+      compatible = "marvell,mmp2-audio-clock";
+      reg = <0xd42a0c30 0x10>;
+      clock-names = "audio", "vctcxo", "i2s0", "i2s1";
+      clocks = <&soc_clocks MMP2_CLK_AUDIO>,
+               <&soc_clocks MMP2_CLK_VCTCXO>,
+               <&soc_clocks MMP2_CLK_I2S0>,
+               <&soc_clocks MMP2_CLK_I2S1>;
+      power-domains = <&soc_clocks MMP2_POWER_DOMAIN_AUDIO>;
+      #clock-cells = <1>;
+    };
diff --git a/include/dt-bindings/clock/marvell,mmp2-audio.h b/include/dt-bindings/clock/marvell,mmp2-audio.h
new file mode 100644
index 000000000000..20664776f497
--- /dev/null
+++ b/include/dt-bindings/clock/marvell,mmp2-audio.h
@@ -0,0 +1,10 @@
+/* SPDX-License-Identifier: (GPL-2.0+ OR BSD-2-Clause) */
+#ifndef __DT_BINDINGS_CLOCK_MARVELL_MMP2_AUDIO_H
+#define __DT_BINDINGS_CLOCK_MARVELL_MMP2_AUDIO_H
+
+#define MMP2_CLK_AUDIO_SYSCLK		0
+#define MMP2_CLK_AUDIO_SSPA0		1
+#define MMP2_CLK_AUDIO_SSPA1		2
+
+#define MMP2_CLK_AUDIO_NR_CLKS		3
+#endif
-- 
2.26.2


  parent reply	other threads:[~2020-05-19 22:42 UTC|newest]

Thread overview: 30+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-05-19 22:41 [PATCH v3 00/13] MMP2 Clock Updates (GPU, Audio, Power Islands) Lubomir Rintel
2020-05-19 22:41 ` [PATCH v3 01/13] clk: mmp: frac: Do not lose last 4 digits of precision Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 02/13] clk: mmp: frac: Allow setting bits other than the numerator/denominator Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 03/13] dt-bindings: marvell,mmp2: Add clock id for the I2S clocks Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 04/13] dt-bindings: marvell,mmp2: Add clock id for the Audio clock Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 05/13] clk: mmp2: Move thermal register defines up a bit Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 06/13] clk: mmp2: Rename mmp2_pll_init() to mmp2_main_clk_init() Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 07/13] clk: mmp2: Add the I2S clocks Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 08/13] clk: mmp2: Add the audio clock Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 09/13] dt-bindings: clock: Make marvell,mmp2-clock a power controller Lubomir Rintel
2020-05-26 23:05   ` Rob Herring
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 10/13] dt-bindings: marvell,mmp2: Add ids for the power domains Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` [PATCH v3 11/13] clk: mmp2: Add support for power islands Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd
2020-05-19 22:41 ` Lubomir Rintel [this message]
2020-05-26 23:06   ` [PATCH v3 12/13] dt-bindings: clock: Add Marvell MMP Audio Clock Controller binding Rob Herring
2020-05-28  1:01   ` Stephen Boyd
2020-06-04 20:47   ` Rob Herring
2020-05-19 22:41 ` [PATCH v3 13/13] clk: mmp2: Add audio clock controller driver Lubomir Rintel
2020-05-28  1:01   ` Stephen Boyd

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=20200519224151.2074597-13-lkundrak@v3.sk \
    --to=lkundrak@v3.sk \
    --cc=devicetree@vger.kernel.org \
    --cc=linux-arm-kernel@lists.infradead.org \
    --cc=linux-clk@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=mturquette@baylibre.com \
    --cc=robh+dt@kernel.org \
    --cc=sboyd@kernel.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: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).