Documentation/devicetree/bindings/watchdog/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
   7 title: Synopsys Designware Watchdog Timer
   8
   9 maintainers:
  10   - Jamie Iles <jamie@jamieiles.com>
  11
  12 allOf:
  13   - $ref: watchdog.yaml#
  14
  15 properties:
  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
  77 required:
  78   - compatible
  79   - reg
  80   - clocks
  81
  82 unevaluatedProperties: false
  83
  84 examples:
  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 ...