Commit b0b8d558 authored by Lokesh Vutla's avatar Lokesh Vutla Committed by Thierry Reding
Browse files

dt-bindings: pwm: pwm-tiecap: Convert to json schema 



Convert the tiecap binding to DT schema format using json-schema.
Along with this conversion the following changes are included:
- 'clock' and 'clock-names' properties are marked required as
   driver fails to probe without these properties
- Dropped ti,am33xx-ecap as it is no longer applicable.
- 'power-domains' property is introduced and marked as optional.

Signed-off-by: default avatarLokesh Vutla <lokeshvutla@ti.com>
Reviewed-by: default avatarRob Herring <robh@kernel.org>
Signed-off-by: default avatarThierry Reding <thierry.reding@gmail.com>
parent 76982e47

Documentation/devicetree/bindings/pwm/pwm-tiecap.txt

deleted100644 → 0
+0 −51
Original line number Diff line number Diff line 
TI SOC ECAP based APWM controller



Required properties:

- compatible: Must be "ti,<soc>-ecap".

  for am33xx - compatible = "ti,am3352-ecap", "ti,am33xx-ecap";

  for am4372 - compatible = "ti,am4372-ecap", "ti,am3352-ecap", "ti,am33xx-ecap";

  for da850  - compatible = "ti,da850-ecap", "ti,am3352-ecap", "ti,am33xx-ecap";

  for dra746 - compatible = "ti,dra746-ecap", "ti,am3352-ecap";

  for 66ak2g - compatible = "ti,k2g-ecap", "ti,am3352-ecap";

  for am654  - compatible = "ti,am654-ecap", "ti,am3352-ecap";

- #pwm-cells: should be 3. See pwm.yaml in this directory for a description of

  the cells format. The PWM channel index ranges from 0 to 4. The only third

  cell flag supported by this binding is PWM_POLARITY_INVERTED.

- reg: physical base address and size of the registers map.



Optional properties:

- clocks: Handle to the ECAP's functional clock.

- clock-names: Must be set to "fck".



Example:



ecap0: ecap@48300100 { /* ECAP on am33xx */

	compatible = "ti,am3352-ecap", "ti,am33xx-ecap";

	#pwm-cells = <3>;

	reg = <0x48300100 0x80>;

	clocks = <&l4ls_gclk>;

	clock-names = "fck";

};



ecap0: ecap@48300100 { /* ECAP on am4372 */

	compatible = "ti,am4372-ecap", "ti,am3352-ecap", "ti,am33xx-ecap";

	#pwm-cells = <3>;

	reg = <0x48300100 0x80>;

	ti,hwmods = "ecap0";

	clocks = <&l4ls_gclk>;

	clock-names = "fck";

};



ecap0: ecap@1f06000 { /* ECAP on da850 */

	compatible = "ti,da850-ecap", "ti,am3352-ecap", "ti,am33xx-ecap";

	#pwm-cells = <3>;

	reg = <0x1f06000 0x80>;

};



ecap0: ecap@4843e100 {

	compatible = "ti,dra746-ecap", "ti,am3352-ecap";

	#pwm-cells = <3>;

	reg = <0x4843e100 0x80>;

	clocks = <&l4_root_clk_div>;

	clock-names = "fck";

};

Documentation/devicetree/bindings/pwm/pwm-tiecap.yaml

0 → 100644
+63 −0
Original line number Diff line number Diff line 
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

%YAML 1.2

---

$id: http://devicetree.org/schemas/pwm/pwm-tiecap.yaml#

$schema: http://devicetree.org/meta-schemas/core.yaml#



title: TI SOC ECAP based APWM controller



maintainers:

  - Vignesh R <vigneshr@ti.com>



allOf:

  - $ref: pwm.yaml#



properties:

  compatible:

    oneOf:

      - const: ti,am3352-ecap

      - items:

          - enum:

              - ti,da850-ecap

              - ti,am4372-ecap

              - ti,dra746-ecap

              - ti,k2g-ecap

              - ti,am654-ecap

          - const: ti,am3352-ecap



  reg:

    maxItems: 1



  "#pwm-cells":

    const: 3

    description: |

      See pwm.yaml in this directory for a description of the cells format.

      The only third cell flag supported by this binding is PWM_POLARITY_INVERTED.



  clock-names:

    const: fck



  clocks:

    maxItems: 1



  power-domains:

    maxItems: 1



required:

  - compatible

  - reg

  - "#pwm-cells"

  - clocks

  - clock-names



additionalProperties: false



examples:

  - |

    ecap0: pwm@48300100 { /* ECAP on am33xx */

        compatible = "ti,am3352-ecap";

        #pwm-cells = <3>;

        reg = <0x48300100 0x80>;

        clocks = <&l4ls_gclk>;

        clock-names = "fck";

    };