1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/pwm/pwm-rockchip.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Rockchip PWM controller
8
9maintainers:
10  - Heiko Stuebner <heiko@sntech.de>
11
12properties:
13  compatible:
14    oneOf:
15      - const: rockchip,rk2928-pwm
16      - const: rockchip,rk3288-pwm
17      - const: rockchip,rk3328-pwm
18      - const: rockchip,vop-pwm
19      - items:
20          - const: rockchip,rk3036-pwm
21          - const: rockchip,rk2928-pwm
22      - items:
23          - enum:
24              - rockchip,rk3368-pwm
25              - rockchip,rk3399-pwm
26              - rockchip,rv1108-pwm
27          - const: rockchip,rk3288-pwm
28      - items:
29          - enum:
30              - rockchip,px30-pwm
31              - rockchip,rk3308-pwm
32              - rockchip,rk3568-pwm
33          - const: rockchip,rk3328-pwm
34
35  reg:
36    maxItems: 1
37
38  clocks:
39    minItems: 1
40    maxItems: 2
41
42  clock-names:
43    maxItems: 2
44
45  "#pwm-cells":
46    enum: [2, 3]
47    description:
48      Must be 2 (rk2928) or 3 (rk3288 and later).
49      See pwm.yaml for a description of the cell format.
50
51required:
52  - compatible
53  - reg
54  - "#pwm-cells"
55
56if:
57  properties:
58    compatible:
59      contains:
60        enum:
61          - rockchip,rk3328-pwm
62          - rockchip,rv1108-pwm
63
64then:
65  properties:
66    clocks:
67      items:
68        - description: Used to derive the functional clock for the device.
69        - description: Used as the APB bus clock.
70
71    clock-names:
72      items:
73        - const: pwm
74        - const: pclk
75
76  required:
77    - clocks
78    - clock-names
79
80else:
81  properties:
82    clocks:
83      maxItems: 1
84      description:
85        Used both to derive the functional clock
86        for the device and as the bus clock.
87
88  required:
89    - clocks
90
91additionalProperties: false
92
93examples:
94  - |
95    #include <dt-bindings/clock/rk3188-cru-common.h>
96    pwm0: pwm@20030000 {
97      compatible = "rockchip,rk2928-pwm";
98      reg = <0x20030000 0x10>;
99      clocks = <&cru PCLK_PWM01>;
100      #pwm-cells = <2>;
101    };
102