Commit 540742fb authored by Dong Aisheng's avatar Dong Aisheng Committed by Shawn Guo
Browse files

dt-bindings: clock: imx-lpcg: add support to parse clocks from device tree 



MX8QM and MX8QXP LPCG Clocks are mostly the same except they may reside
in different subsystems across CPUs and also vary a bit on the availability.

Same as SCU clock, we want to move the clock definition into device tree
which can fully decouple the dependency of Clock ID definition from device
tree and make us be able to write a fully generic lpcg clock driver.

And we can also use the existence of clock nodes in device tree to address
the device and clock availability differences across different SoCs.

Cc: Sascha Hauer <kernel@pengutronix.de>
Cc: Michael Turquette <mturquette@baylibre.com>
Cc: devicetree@vger.kernel.org
Cc: Shawn Guo <shawnguo@kernel.org>
Cc: Rob Herring <robh@kernel.org>
Cc: Stephen Boyd <sboyd@kernel.org>
Signed-off-by: default avatarDong Aisheng <aisheng.dong@nxp.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Reviewed-by: default avatarStephen Boyd <sboyd@kernel.org>
Signed-off-by: default avatarShawn Guo <shawnguo@kernel.org>
parent 02f5bea9

Documentation/devicetree/bindings/clock/imx8qxp-lpcg.yaml

+60 −19
Original line number Diff line number Diff line
@@ -21,11 +21,17 @@ description: | 


  The clock consumer should specify the desired clock by having the clock

  ID in its "clocks" phandle cell. See the full list of clock IDs from:

  include/dt-bindings/clock/imx8-clock.h

  include/dt-bindings/clock/imx8-lpcg.h



properties:

  compatible:

    enum:

    oneOf:

      - const: fsl,imx8qxp-lpcg

      - items:

          - enum:

            - fsl,imx8qm-lpcg

          - const: fsl,imx8qxp-lpcg

      - enum:

        - fsl,imx8qxp-lpcg-adma

        - fsl,imx8qxp-lpcg-conn

        - fsl,imx8qxp-lpcg-dc
@@ -35,13 +41,38 @@ properties: 
        - fsl,imx8qxp-lpcg-img

        - fsl,imx8qxp-lpcg-lsio

        - fsl,imx8qxp-lpcg-vpu



        deprecated: true

  reg:

    maxItems: 1



  '#clock-cells':

    const: 1



  clocks:

    description: |

      Input parent clocks phandle array for each clock

    minItems: 1

    maxItems: 8



  clock-indices:

    description: |

      An integer array indicating the bit offset for each clock.

      Refer to <include/dt-bindings/clock/imx8-lpcg.h> for the

      supported LPCG clock indices.

    minItems: 1

    maxItems: 8



  clock-output-names:

    description: |

      Shall be the corresponding names of the outputs.

      NOTE this property must be specified in the same order

      as the clock-indices property.

    minItems: 1

    maxItems: 8



  power-domains:

    maxItems: 1



required:

  - compatible

  - reg
@@ -51,23 +82,33 @@ additionalProperties: false 


examples:

  - |

    #include <dt-bindings/clock/imx8-clock.h>

    #include <dt-bindings/clock/imx8-lpcg.h>

    #include <dt-bindings/firmware/imx/rsrc.h>

    #include <dt-bindings/interrupt-controller/arm-gic.h>



    clock-controller@5b200000 {

        compatible = "fsl,imx8qxp-lpcg-conn";

        reg = <0x5b200000 0xb0000>;

    sdhc0_lpcg: clock-controller@5b200000 {

        compatible = "fsl,imx8qxp-lpcg";

        reg = <0x5b200000 0x10000>;

        #clock-cells = <1>;

        clocks = <&sdhc0_clk IMX_SC_PM_CLK_PER>,

                 <&conn_ipg_clk>,

                 <&conn_axi_clk>;

        clock-indices = <IMX_LPCG_CLK_0>,

                        <IMX_LPCG_CLK_4>,

                        <IMX_LPCG_CLK_5>;

        clock-output-names = "sdhc0_lpcg_per_clk",

                             "sdhc0_lpcg_ipg_clk",

                             "sdhc0_lpcg_ahb_clk";

        power-domains = <&pd IMX_SC_R_SDHC_0>;

    };



    mmc@5b010000 {

        compatible = "fsl,imx8qxp-usdhc", "fsl,imx7d-usdhc";

        interrupts = <GIC_SPI 232 IRQ_TYPE_LEVEL_HIGH>;

        reg = <0x5b010000 0x10000>;

        clocks = <&conn_lpcg IMX_CONN_LPCG_SDHC0_IPG_CLK>,

                 <&conn_lpcg IMX_CONN_LPCG_SDHC0_PER_CLK>,

                 <&conn_lpcg IMX_CONN_LPCG_SDHC0_HCLK>;

        clocks = <&sdhc0_lpcg IMX_LPCG_CLK_4>,

                 <&sdhc0_lpcg IMX_LPCG_CLK_0>,

                 <&sdhc0_lpcg IMX_LPCG_CLK_5>;

        clock-names = "ipg", "per", "ahb";

        power-domains = <&pd IMX_SC_R_SDHC_0>;

    };

include/dt-bindings/clock/imx8-lpcg.h

0 → 100644
+14 −0
Original line number Diff line number Diff line 
/* SPDX-License-Identifier: GPL-2.0+ */

/*

 * Copyright 2019-2020 NXP

 *   Dong Aisheng <aisheng.dong@nxp.com>

 */



#define IMX_LPCG_CLK_0	0

#define IMX_LPCG_CLK_1	4

#define IMX_LPCG_CLK_2	8

#define IMX_LPCG_CLK_3	12

#define IMX_LPCG_CLK_4	16

#define IMX_LPCG_CLK_5	20

#define IMX_LPCG_CLK_6	24

#define IMX_LPCG_CLK_7	28