xref: /linux/Documentation/devicetree/bindings/watchdog/snps,dw-wdt.yaml (revision 3a39d672e7f48b8d6b91a09afa4b55352773b4b5) 
1# SPDX-License-Identifier: GPL-2.0-only
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/watchdog/snps,dw-wdt.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Synopsys Designware Watchdog Timer
8
9maintainers:
10  - Jamie Iles <jamie@jamieiles.com>
11
12allOf:
13  - $ref: watchdog.yaml#
14
15properties:
16  compatible:
17    oneOf:
18      - const: snps,dw-wdt
19      - items:
20          - enum:
21              - rockchip,px30-wdt
22              - rockchip,rk3066-wdt
23              - rockchip,rk3128-wdt
24              - rockchip,rk3188-wdt
25              - rockchip,rk3228-wdt
26              - rockchip,rk3288-wdt
27              - rockchip,rk3308-wdt
28              - rockchip,rk3328-wdt
29              - rockchip,rk3368-wdt
30              - rockchip,rk3399-wdt
31              - rockchip,rk3568-wdt
32              - rockchip,rk3576-wdt
33              - rockchip,rk3588-wdt
34              - rockchip,rv1108-wdt
35          - const: snps,dw-wdt
36
37  reg:
38    maxItems: 1
39
40  interrupts:
41    description: DW Watchdog pre-timeout interrupt
42    maxItems: 1
43
44  clocks:
45    minItems: 1
46    items:
47      - description: Watchdog timer reference clock
48      - description: APB3 interface clock
49
50  clock-names:
51    minItems: 1
52    items:
53      - const: tclk
54      - const: pclk
55
56  resets:
57    description: Phandle to the DW Watchdog reset lane
58    maxItems: 1
59
60  snps,watchdog-tops:
61    $ref: /schemas/types.yaml#/definitions/uint32-array
62    description: |
63      DW APB Watchdog custom timer intervals - Timeout Period ranges (TOPs).
64      Each TOP is a number loaded into the watchdog counter at the moment of
65      the timer restart. The counter decrementing happens each tick of the
66      reference clock. Therefore the TOPs array is equivalent to an array of
67      the timer expiration intervals supported by the DW APB Watchdog. Note
68      DW APB Watchdog IP-core might be synthesized with fixed TOP values,
69      in which case this property is unnecessary with default TOPs utilized.
70    default: [0x0001000 0x0002000 0x0004000 0x0008000
71      0x0010000 0x0020000 0x0040000 0x0080000
72      0x0100000 0x0200000 0x0400000 0x0800000
73      0x1000000 0x2000000 0x4000000 0x8000000]
74    minItems: 16
75    maxItems: 16
76
77required:
78  - compatible
79  - reg
80  - clocks
81
82unevaluatedProperties: false
83
84examples:
85  - |
86    watchdog@ffd02000 {
87        compatible = "snps,dw-wdt";
88        reg = <0xffd02000 0x1000>;
89        interrupts = <0 171 4>;
90        clocks = <&per_base_clk>;
91        resets = <&wdt_rst>;
92    };
93
94  - |
95    watchdog@ffd02000 {
96        compatible = "snps,dw-wdt";
97        reg = <0xffd02000 0x1000>;
98        interrupts = <0 171 4>;
99        clocks = <&per_base_clk>;
100        clock-names = "tclk";
101        snps,watchdog-tops = <0x000000FF 0x000001FF 0x000003FF
102                              0x000007FF 0x0000FFFF 0x0001FFFF
103                              0x0003FFFF 0x0007FFFF 0x000FFFFF
104                              0x001FFFFF 0x003FFFFF 0x007FFFFF
105                              0x00FFFFFF 0x01FFFFFF 0x03FFFFFF
106                              0x07FFFFFF>;
107    };
108...
109