From: Javier Martinez Canillas <javier.martinez@collabora.co.uk> To: Lee Jones <lee.jones@linaro.org> Cc: Mark Brown <broonie@kernel.org>, Mike Turquette <mturquette@linaro.org>, Liam Girdwood <lgirdwood@gmail.com>, Alessandro Zummo <a.zummo@towertech.it>, Kukjin Kim <kgene.kim@samsung.com>, Doug Anderson <dianders@chromium.org>, Olof Johansson <olof@lixom.net>, Tomeu Vizoso <tomeu.vizoso@collabora.com>, Krzysztof Kozlowski <k.kozlowski@samsung.com>, Yadwinder Singh Brar <yadi.brar01@gmail.com>, Tushar Behera <trblinux@gmail.com>, Andreas Farber <afaerber@suse.de>, linux-arm-kernel@lists.infradead.org, devicetree@vger.kernel.org, linux-samsung-soc@vger.kernel.org, linux-kernel@vger.kernel.org, Javier Martinez Canillas <javier.martinez@collabora.co.uk> Subject: [PATCH v7 22/24] clk: max77802: Add DT binding documentation Date: Fri, 4 Jul 2014 22:24:25 +0200 [thread overview] Message-ID: <1404505467-26526-23-git-send-email-javier.martinez@collabora.co.uk> (raw) In-Reply-To: <1404505467-26526-1-git-send-email-javier.martinez@collabora.co.uk> Add Device Tree binding documentation for the clocks outputs in the Maxim 77802 Power Management IC. Signed-off-by: Javier Martinez Canillas <javier.martinez@collabora.co.uk> --- Changes since v6: None Changes since v5: - Fix typo error in DT binding. Suggested by Andreas Farber. - Add "clock-output-names" as an optional property since now is supported. Changes since v4: None Changes since v3: - Don't use the same clock driver name in clock-names since it's a consumer concept and most probably will be different. Suggested by Doug Anderson. Changes since v2: - Split the DT binding documentation in a separate patch. --- .../devicetree/bindings/clock/maxim,max77802.txt | 44 ++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/maxim,max77802.txt diff --git a/Documentation/devicetree/bindings/clock/maxim,max77802.txt b/Documentation/devicetree/bindings/clock/maxim,max77802.txt new file mode 100644 index 0000000..c6dc783 --- /dev/null +++ b/Documentation/devicetree/bindings/clock/maxim,max77802.txt @@ -0,0 +1,44 @@ +Binding for Maxim MAX77802 32k clock generator block + +This is a part of device tree bindings of MAX77802 multi-function device. +More information can be found in bindings/mfd/max77802.txt file. + +The MAX77802 contains two 32.768khz clock outputs that can be controlled +(gated/ungated) over I2C. + +Following properties should be present in main device node of the MFD chip. + +Required properties: +- #clock-cells: From common clock binding; shall be set to 1. + +Optional properties: +- clock-output-names: From common clock binding. + +Each clock is assigned an identifier and client nodes can use this identifier +to specify the clock which they consume. Following indices are allowed: + - 0: 32khz_ap clock, + - 1: 32khz_cp clock. + +Clocks are defined as preprocessor macros in dt-bindings/clock/maxim,max77802.h +header and can be used in device tree sources. + +Example: Node of the MFD chip + + max77802: max77802@09 { + compatible = "maxim,max77802"; + interrupt-parent = <&wakeup_eint>; + interrupts = <26 0>; + reg = <0x09>; + #clock-cells = <1>; + + /* ... */ + }; + +Example: Clock consumer node + + foo@0 { + compatible = "bar,foo"; + /* ... */ + clock-names = "my-clock"; + clocks = <&max77802 MAX77802_CLK_32K_AP>; + }; -- 2.0.0.rc2
WARNING: multiple messages have this Message-ID (diff)
From: javier.martinez@collabora.co.uk (Javier Martinez Canillas) To: linux-arm-kernel@lists.infradead.org Subject: [PATCH v7 22/24] clk: max77802: Add DT binding documentation Date: Fri, 4 Jul 2014 22:24:25 +0200 [thread overview] Message-ID: <1404505467-26526-23-git-send-email-javier.martinez@collabora.co.uk> (raw) In-Reply-To: <1404505467-26526-1-git-send-email-javier.martinez@collabora.co.uk> Add Device Tree binding documentation for the clocks outputs in the Maxim 77802 Power Management IC. Signed-off-by: Javier Martinez Canillas <javier.martinez@collabora.co.uk> --- Changes since v6: None Changes since v5: - Fix typo error in DT binding. Suggested by Andreas Farber. - Add "clock-output-names" as an optional property since now is supported. Changes since v4: None Changes since v3: - Don't use the same clock driver name in clock-names since it's a consumer concept and most probably will be different. Suggested by Doug Anderson. Changes since v2: - Split the DT binding documentation in a separate patch. --- .../devicetree/bindings/clock/maxim,max77802.txt | 44 ++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/maxim,max77802.txt diff --git a/Documentation/devicetree/bindings/clock/maxim,max77802.txt b/Documentation/devicetree/bindings/clock/maxim,max77802.txt new file mode 100644 index 0000000..c6dc783 --- /dev/null +++ b/Documentation/devicetree/bindings/clock/maxim,max77802.txt @@ -0,0 +1,44 @@ +Binding for Maxim MAX77802 32k clock generator block + +This is a part of device tree bindings of MAX77802 multi-function device. +More information can be found in bindings/mfd/max77802.txt file. + +The MAX77802 contains two 32.768khz clock outputs that can be controlled +(gated/ungated) over I2C. + +Following properties should be present in main device node of the MFD chip. + +Required properties: +- #clock-cells: From common clock binding; shall be set to 1. + +Optional properties: +- clock-output-names: From common clock binding. + +Each clock is assigned an identifier and client nodes can use this identifier +to specify the clock which they consume. Following indices are allowed: + - 0: 32khz_ap clock, + - 1: 32khz_cp clock. + +Clocks are defined as preprocessor macros in dt-bindings/clock/maxim,max77802.h +header and can be used in device tree sources. + +Example: Node of the MFD chip + + max77802: max77802 at 09 { + compatible = "maxim,max77802"; + interrupt-parent = <&wakeup_eint>; + interrupts = <26 0>; + reg = <0x09>; + #clock-cells = <1>; + + /* ... */ + }; + +Example: Clock consumer node + + foo at 0 { + compatible = "bar,foo"; + /* ... */ + clock-names = "my-clock"; + clocks = <&max77802 MAX77802_CLK_32K_AP>; + }; -- 2.0.0.rc2
next prev parent reply other threads:[~2014-07-04 20:27 UTC|newest] Thread overview: 124+ messages / expand[flat|nested] mbox.gz Atom feed top 2014-07-04 20:24 [PATCH v7 00/24] Add Maxim 77802 PMIC support Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 01/24] mfd: max77686: Convert to use regmap_irq Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-18 8:17 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-04 20:24 ` [PATCH v7 02/24] mfd: max77686: Add power management support Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-09 14:44 ` Lee Jones 2014-07-09 14:44 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-04 20:24 ` [PATCH v7 03/24] mfd: max77686: Don't define dummy function if OF isn't enabled Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-09 14:50 ` Lee Jones 2014-07-09 14:50 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-04 20:24 ` [PATCH v7 04/24] mfd: max77686: Make platform data over-rule DT Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-09 14:52 ` Lee Jones 2014-07-09 14:52 ` Lee Jones 2014-07-09 18:15 ` Javier Martinez Canillas 2014-07-09 18:15 ` Javier Martinez Canillas 2014-07-18 8:17 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-18 8:17 ` Lee Jones 2014-07-04 20:24 ` [PATCH v7 05/24] mfd: max77686: Return correct error when pdata isn't found Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-09 14:53 ` Lee Jones 2014-07-09 14:53 ` Lee Jones 2014-07-18 8:18 ` Lee Jones 2014-07-18 8:18 ` Lee Jones 2014-07-18 8:18 ` Lee Jones 2014-07-04 20:24 ` [PATCH v7 06/24] mfd: max77686: Make error checking consistent Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-09 14:54 ` Lee Jones 2014-07-09 14:54 ` Lee Jones 2014-07-18 8:18 ` Lee Jones 2014-07-18 8:18 ` Lee Jones 2014-07-04 20:24 ` [PATCH v7 07/24] mfd: max77686: Remove unneeded OOM error message Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-18 8:18 ` Lee Jones 2014-07-18 8:18 ` Lee Jones 2014-07-18 8:18 ` Lee Jones 2014-07-04 20:24 ` [PATCH v7 08/24] mfd: max77686: Add Dynamic Voltage Scaling (DVS) support Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-09 15:13 ` Lee Jones 2014-07-09 15:13 ` Lee Jones 2014-07-09 18:40 ` Javier Martinez Canillas 2014-07-09 18:40 ` Javier Martinez Canillas 2014-07-10 9:46 ` Linus Walleij 2014-07-10 9:46 ` Linus Walleij 2014-07-11 0:51 ` Javier Martinez Canillas 2014-07-10 9:59 ` amit daniel kachhap 2014-07-10 9:59 ` amit daniel kachhap 2014-07-10 9:59 ` amit daniel kachhap 2014-07-11 1:45 ` Javier Martinez Canillas 2014-07-11 1:45 ` Javier Martinez Canillas 2014-07-11 1:45 ` Javier Martinez Canillas 2014-07-11 4:02 ` Doug Anderson 2014-07-11 4:02 ` Doug Anderson 2014-07-11 4:02 ` Doug Anderson 2014-07-11 9:37 ` amit daniel kachhap 2014-07-11 9:37 ` amit daniel kachhap 2014-07-11 9:37 ` amit daniel kachhap 2014-07-11 9:43 ` Tomasz Figa 2014-07-11 9:43 ` Tomasz Figa 2014-07-11 9:43 ` Tomasz Figa 2014-07-11 10:15 ` Javier Martinez Canillas 2014-07-11 10:15 ` Javier Martinez Canillas 2014-07-11 10:15 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 09/24] rtc: max77686: Allow the max77686 rtc to wakeup the system Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 10/24] rtc: max77686: Remove dead code for SMPL and WTSR Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-07 6:09 ` Krzysztof Kozlowski 2014-07-07 6:09 ` Krzysztof Kozlowski 2014-07-04 20:24 ` [PATCH v7 11/24] clk: max77686: Add DT include for MAX77686 PMIC clock Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 12/24] clk: Add generic driver for Maxim PMIC clocks Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 13/24] clk: max77686: Convert to the generic max clock driver Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 14/24] clk: max77686: Improve Maxim 77686 PMIC clocks binding Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 15/24] regmap: Add regmap_reg_copy function Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 16/24] regulator: max77686: Setup DVS-related GPIOs on probe Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 17/24] mfd: max77686: Add documentation for DVS bindings Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 18/24] mfd: max77686: Add Maxim 77802 PMIC support Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-09 15:31 ` Lee Jones 2014-07-09 15:31 ` Lee Jones 2014-07-09 18:43 ` Javier Martinez Canillas 2014-07-09 18:43 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 19/24] mfd: max77802: Add DT binding documentation Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 20/24] regulator: Add driver for Maxim 77802 PMIC regulators Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 21/24] clk: Add driver for Maxim 77802 PMIC clocks Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas [this message] 2014-07-04 20:24 ` [PATCH v7 22/24] clk: max77802: Add DT binding documentation Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 23/24] rtc: Add driver for Maxim 77802 PMIC Real-Time-Clock Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas 2014-07-07 6:06 ` Krzysztof Kozlowski 2014-07-07 6:06 ` Krzysztof Kozlowski 2014-07-07 6:57 ` Javier Martinez Canillas 2014-07-07 6:57 ` Javier Martinez Canillas 2014-07-07 6:57 ` Javier Martinez Canillas 2014-07-04 20:24 ` [PATCH v7 24/24] ARM: dts: Add max77802 to exynos5420-peach-pit and exynos5800-peach-pi Javier Martinez Canillas 2014-07-04 20:24 ` Javier Martinez Canillas
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=1404505467-26526-23-git-send-email-javier.martinez@collabora.co.uk \ --to=javier.martinez@collabora.co.uk \ --cc=a.zummo@towertech.it \ --cc=afaerber@suse.de \ --cc=broonie@kernel.org \ --cc=devicetree@vger.kernel.org \ --cc=dianders@chromium.org \ --cc=k.kozlowski@samsung.com \ --cc=kgene.kim@samsung.com \ --cc=lee.jones@linaro.org \ --cc=lgirdwood@gmail.com \ --cc=linux-arm-kernel@lists.infradead.org \ --cc=linux-kernel@vger.kernel.org \ --cc=linux-samsung-soc@vger.kernel.org \ --cc=mturquette@linaro.org \ --cc=olof@lixom.net \ --cc=tomeu.vizoso@collabora.com \ --cc=trblinux@gmail.com \ --cc=yadi.brar01@gmail.com \ /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.