From mboxrd@z Thu Jan 1 00:00:00 1970 From: Rob Herring Subject: Re: [PATCH 11/12] dt-bindings: clock: add imx8qxp clock binding doc Date: Tue, 1 May 2018 10:37:27 -0500 Message-ID: <20180501153727.GA21845@rob-hp-laptop> References: <1524855403-15301-1-git-send-email-aisheng.dong@nxp.com> <1524855403-15301-12-git-send-email-aisheng.dong@nxp.com> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Return-path: Content-Disposition: inline In-Reply-To: <1524855403-15301-12-git-send-email-aisheng.dong@nxp.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=m.gmane.org@lists.infradead.org To: Dong Aisheng Cc: Mark Rutland , devicetree@vger.kernel.org, sboyd@kernel.org, mturquette@baylibre.com, linux-imx@nxp.com, kernel@pengutronix.de, fabio.estevam@nxp.com, shawnguo@kernel.org, linux-clk@vger.kernel.org, linux-arm-kernel@lists.infradead.org List-Id: devicetree@vger.kernel.org On Sat, Apr 28, 2018 at 02:56:42AM +0800, Dong Aisheng wrote: > Add imx8qxp clock binding doc. > > Cc: Shawn Guo > Cc: Sascha Hauer > Cc: Fabio Estevam > Cc: Stephen Boyd > Cc: Michael Turquette > Cc: Rob Herring > Cc: Mark Rutland > Cc: devicetree@vger.kernel.org > Signed-off-by: Dong Aisheng > --- > .../devicetree/bindings/clock/imx8qxp-clk.txt | 39 +++ > include/dt-bindings/clock/imx8qxp-clock.h | 362 +++++++++++++++++++++ > 2 files changed, 401 insertions(+) > create mode 100644 Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > create mode 100644 include/dt-bindings/clock/imx8qxp-clock.h > > diff --git a/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt b/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > new file mode 100644 > index 0000000..5e365d7 > --- /dev/null > +++ b/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > @@ -0,0 +1,39 @@ > +NXP i.MX8QXP Clocks Based on SCFW > +-------------------------------------------------------------------- > + > +Some i.MX SoCs contain a system controller that is responsible for > +providing clock control service for the IPs. Communication between > +the host processor running an OS and the system controller happens > +through a SCU protocol [1]. > + > +[1] Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt > + > +Required properties: > + > +- compatible: Should be "fsl,imx8qxp-clock". > +- #clock-cells: Should be <1>. There's no reason for this node. Just make the parent (SCU) a clock provider. > + > +The clock consumer should specify the desired clock by having the clock > +ID in its "clocks" phandle cell. > +See include/dt-bindings/clock/imx8qxp-clock.h > +for the full list of i.MX8QXP clock IDs. > + > +Examples: > + > +#include > + > +clk: clk { > + compatible = "fsl,imx8qxp-clk"; > + #clock-cells = <1>; > +}; > + > +i2c0: i2c@5a800000 { > + compatible = "fsl,imx8qxp-lpi2c", "fsl,imx7ulp-lpi2c"; > + reg = <0x0 0x5a800000 0x0 0x4000>; > + interrupts = ; > + interrupt-parent = <&gic>; > + clocks = <&clk IMX8QXP_I2C0_CLK>, > + <&clk IMX8QXP_I2C0_IPG_CLK>; > + clock-names = "per", "ipg"; > + ... > +}; From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Return-Path: Date: Tue, 1 May 2018 10:37:27 -0500 From: Rob Herring To: Dong Aisheng Cc: linux-clk@vger.kernel.org, linux-arm-kernel@lists.infradead.org, sboyd@kernel.org, mturquette@baylibre.com, shawnguo@kernel.org, fabio.estevam@nxp.com, linux-imx@nxp.com, kernel@pengutronix.de, Mark Rutland , devicetree@vger.kernel.org Subject: Re: [PATCH 11/12] dt-bindings: clock: add imx8qxp clock binding doc Message-ID: <20180501153727.GA21845@rob-hp-laptop> References: <1524855403-15301-1-git-send-email-aisheng.dong@nxp.com> <1524855403-15301-12-git-send-email-aisheng.dong@nxp.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii In-Reply-To: <1524855403-15301-12-git-send-email-aisheng.dong@nxp.com> List-ID: On Sat, Apr 28, 2018 at 02:56:42AM +0800, Dong Aisheng wrote: > Add imx8qxp clock binding doc. > > Cc: Shawn Guo > Cc: Sascha Hauer > Cc: Fabio Estevam > Cc: Stephen Boyd > Cc: Michael Turquette > Cc: Rob Herring > Cc: Mark Rutland > Cc: devicetree@vger.kernel.org > Signed-off-by: Dong Aisheng > --- > .../devicetree/bindings/clock/imx8qxp-clk.txt | 39 +++ > include/dt-bindings/clock/imx8qxp-clock.h | 362 +++++++++++++++++++++ > 2 files changed, 401 insertions(+) > create mode 100644 Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > create mode 100644 include/dt-bindings/clock/imx8qxp-clock.h > > diff --git a/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt b/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > new file mode 100644 > index 0000000..5e365d7 > --- /dev/null > +++ b/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > @@ -0,0 +1,39 @@ > +NXP i.MX8QXP Clocks Based on SCFW > +-------------------------------------------------------------------- > + > +Some i.MX SoCs contain a system controller that is responsible for > +providing clock control service for the IPs. Communication between > +the host processor running an OS and the system controller happens > +through a SCU protocol [1]. > + > +[1] Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt > + > +Required properties: > + > +- compatible: Should be "fsl,imx8qxp-clock". > +- #clock-cells: Should be <1>. There's no reason for this node. Just make the parent (SCU) a clock provider. > + > +The clock consumer should specify the desired clock by having the clock > +ID in its "clocks" phandle cell. > +See include/dt-bindings/clock/imx8qxp-clock.h > +for the full list of i.MX8QXP clock IDs. > + > +Examples: > + > +#include > + > +clk: clk { > + compatible = "fsl,imx8qxp-clk"; > + #clock-cells = <1>; > +}; > + > +i2c0: i2c@5a800000 { > + compatible = "fsl,imx8qxp-lpi2c", "fsl,imx7ulp-lpi2c"; > + reg = <0x0 0x5a800000 0x0 0x4000>; > + interrupts = ; > + interrupt-parent = <&gic>; > + clocks = <&clk IMX8QXP_I2C0_CLK>, > + <&clk IMX8QXP_I2C0_IPG_CLK>; > + clock-names = "per", "ipg"; > + ... > +}; From mboxrd@z Thu Jan 1 00:00:00 1970 From: robh@kernel.org (Rob Herring) Date: Tue, 1 May 2018 10:37:27 -0500 Subject: [PATCH 11/12] dt-bindings: clock: add imx8qxp clock binding doc In-Reply-To: <1524855403-15301-12-git-send-email-aisheng.dong@nxp.com> References: <1524855403-15301-1-git-send-email-aisheng.dong@nxp.com> <1524855403-15301-12-git-send-email-aisheng.dong@nxp.com> Message-ID: <20180501153727.GA21845@rob-hp-laptop> To: linux-arm-kernel@lists.infradead.org List-Id: linux-arm-kernel.lists.infradead.org On Sat, Apr 28, 2018 at 02:56:42AM +0800, Dong Aisheng wrote: > Add imx8qxp clock binding doc. > > Cc: Shawn Guo > Cc: Sascha Hauer > Cc: Fabio Estevam > Cc: Stephen Boyd > Cc: Michael Turquette > Cc: Rob Herring > Cc: Mark Rutland > Cc: devicetree at vger.kernel.org > Signed-off-by: Dong Aisheng > --- > .../devicetree/bindings/clock/imx8qxp-clk.txt | 39 +++ > include/dt-bindings/clock/imx8qxp-clock.h | 362 +++++++++++++++++++++ > 2 files changed, 401 insertions(+) > create mode 100644 Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > create mode 100644 include/dt-bindings/clock/imx8qxp-clock.h > > diff --git a/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt b/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > new file mode 100644 > index 0000000..5e365d7 > --- /dev/null > +++ b/Documentation/devicetree/bindings/clock/imx8qxp-clk.txt > @@ -0,0 +1,39 @@ > +NXP i.MX8QXP Clocks Based on SCFW > +-------------------------------------------------------------------- > + > +Some i.MX SoCs contain a system controller that is responsible for > +providing clock control service for the IPs. Communication between > +the host processor running an OS and the system controller happens > +through a SCU protocol [1]. > + > +[1] Documentation/devicetree/bindings/arm/freescale/fsl,scu.txt > + > +Required properties: > + > +- compatible: Should be "fsl,imx8qxp-clock". > +- #clock-cells: Should be <1>. There's no reason for this node. Just make the parent (SCU) a clock provider. > + > +The clock consumer should specify the desired clock by having the clock > +ID in its "clocks" phandle cell. > +See include/dt-bindings/clock/imx8qxp-clock.h > +for the full list of i.MX8QXP clock IDs. > + > +Examples: > + > +#include > + > +clk: clk { > + compatible = "fsl,imx8qxp-clk"; > + #clock-cells = <1>; > +}; > + > +i2c0: i2c at 5a800000 { > + compatible = "fsl,imx8qxp-lpi2c", "fsl,imx7ulp-lpi2c"; > + reg = <0x0 0x5a800000 0x0 0x4000>; > + interrupts = ; > + interrupt-parent = <&gic>; > + clocks = <&clk IMX8QXP_I2C0_CLK>, > + <&clk IMX8QXP_I2C0_IPG_CLK>; > + clock-names = "per", "ipg"; > + ... > +};