Re: [PATCH v5 4/9] dt-bindings: clock: imx: Add documentation for i.MXRT1050 clock
From: Rob Herring <robh@kernel.org>
Date: 2021-12-16 15:58:10
Also in:
linux-arm-kernel, linux-clk, linux-devicetree, linux-mmc, linux-serial, lkml
On Wed, Dec 15, 2021 at 05:05:33PM -0500, Jesse Taube wrote:
quoted hunk ↗ jump to hunk
From: Jesse Taube <redacted> Add DT binding documentation for i.MXRT1050 clock driver. Cc: Giulio Benetti <giulio.benetti@benettiengineering.com> Signed-off-by: Jesse Taube <redacted> --- V1->V2: * Replace macros with values V2->V3: * Remove anatop * Use lpuart not gpt * include imxrt1050-clock.h * 2 space tabs to 4 * Remove oneOf enum * Change maxItems to 2 V3->V4: * Nothing done V4->V5: * Remove extra newline * Rename ccm to clock-controller * Change minItems to const * Change minItems to description * Rename file to add 1050 * Change commit description to just 1050 --- .../bindings/clock/imxrt1050-clock.yaml | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 Documentation/devicetree/bindings/clock/imxrt1050-clock.yamldiff --git a/Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml b/Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml new file mode 100644 index 000000000000..8caf0572733b --- /dev/null +++ b/Documentation/devicetree/bindings/clock/imxrt1050-clock.yaml@@ -0,0 +1,66 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/clock/imxrt1050-clock.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Clock bindings for Freescale i.MXRT + +maintainers: + - Giulio Benetti <giulio.benetti@benettiengineering.com> + - Jesse Taube <Mr.Bossman075@gmail.com> + +description: | + The clock consumer should specify the desired clock by having the clock + ID in its "clocks" phandle cell. See include/dt-bindings/clock/imxrt*-clock.h + for the full list of i.MXRT clock IDs. + +properties: + compatible: + const: fsl,imxrt1050-ccm + + reg: + maxItems: 1 + + interrupts: + maxItems: 2 + + clocks: + description: 24m osc
maxItems: 1 With that, Reviewed-by: Rob Herring <robh@kernel.org>
+
+ clock-names:
+ const: osc
+
+ '#clock-cells':
+ const: 1
+
+required:
+ - compatible
+ - reg
+ - interrupts
+ - clocks
+ - clock-names
+ - '#clock-cells'
+
+additionalProperties: false
+
+examples:
+ - |
+ #include <dt-bindings/clock/imxrt1050-clock.h>
+
+ clks: clock-controller@400fc000 {
+ compatible = "fsl,imxrt1050-ccm";
+ reg = <0x400fc000 0x4000>;
+ interrupts = <95>, <96>;
+ clocks = <&osc>;
+ clock-names = "osc";
+ #clock-cells = <1>;
+ };
+
+ lpuart1: serial@40184000 {
+ compatible = "fsl,imxrt1050-lpuart";
+ reg = <0x40184000 0x4000>;
+ interrupts = <20>;
+ clocks = <&clks IMXRT1050_CLK_LPUART1>;
+ clock-names = "ipg";
+ };
--
2.34.1