xref: /linux/Documentation/devicetree/bindings/watchdog/snps,dw-wdt.yaml (revision 7f71507851fc7764b36a3221839607d3a45c2025) 
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              - rockchip,rv1126-wdt
36          - const: snps,dw-wdt
37
38  reg:
39    maxItems: 1
40
41  interrupts:
42    description: DW Watchdog pre-timeout interrupt
43    maxItems: 1
44
45  clocks:
46    minItems: 1
47    items:
48      - description: Watchdog timer reference clock
49      - description: APB3 interface clock
50
51  clock-names:
52    minItems: 1
53    items:
54      - const: tclk
55      - const: pclk
56
57  resets:
58    description: Phandle to the DW Watchdog reset lane
59    maxItems: 1
60
61  snps,watchdog-tops:
62    $ref: /schemas/types.yaml#/definitions/uint32-array
63    description: |
64      DW APB Watchdog custom timer intervals - Timeout Period ranges (TOPs).
65      Each TOP is a number loaded into the watchdog counter at the moment of
66      the timer restart. The counter decrementing happens each tick of the
67      reference clock. Therefore the TOPs array is equivalent to an array of
68      the timer expiration intervals supported by the DW APB Watchdog. Note
69      DW APB Watchdog IP-core might be synthesized with fixed TOP values,
70      in which case this property is unnecessary with default TOPs utilized.
71    default: [0x0001000 0x0002000 0x0004000 0x0008000
72      0x0010000 0x0020000 0x0040000 0x0080000
73      0x0100000 0x0200000 0x0400000 0x0800000
74      0x1000000 0x2000000 0x4000000 0x8000000]
75    minItems: 16
76    maxItems: 16
77
78required:
79  - compatible
80  - reg
81  - clocks
82
83unevaluatedProperties: false
84
85examples:
86  - |
87    watchdog@ffd02000 {
88        compatible = "snps,dw-wdt";
89        reg = <0xffd02000 0x1000>;
90        interrupts = <0 171 4>;
91        clocks = <&per_base_clk>;
92        resets = <&wdt_rst>;
93    };
94
95  - |
96    watchdog@ffd02000 {
97        compatible = "snps,dw-wdt";
98        reg = <0xffd02000 0x1000>;
99        interrupts = <0 171 4>;
100        clocks = <&per_base_clk>;
101        clock-names = "tclk";
102        snps,watchdog-tops = <0x000000FF 0x000001FF 0x000003FF
103                              0x000007FF 0x0000FFFF 0x0001FFFF
104                              0x0003FFFF 0x0007FFFF 0x000FFFFF
105                              0x001FFFFF 0x003FFFFF 0x007FFFFF
106                              0x00FFFFFF 0x01FFFFFF 0x03FFFFFF
107                              0x07FFFFFF>;
108    };
109...
110