snps,dw-wdt.yaml

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