Documentation/devicetree/bindings/watchdog/atmel,sama5d4-wdt.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/watchdog/atmel,sama5d4-wdt.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: Atmel SAMA5D4 Watchdog Timer (WDT) Controller
   8
   9 maintainers:
  10   - Eugen Hristev <eugen.hristev@microchip.com>
  11
  12 allOf:
  13   - $ref: "watchdog.yaml#"
  14
  15 properties:
  16   compatible:
  17     enum:
  18       - atmel,sama5d4-wdt
  19       - microchip,sam9x60-wdt
  20       - microchip,sama7g5-wdt
  21
  22   reg:
  23     maxItems: 1
  24
  25   atmel,watchdog-type:
  26     $ref: /schemas/types.yaml#/definitions/string
  27     description: should be hardware or software.
  28     oneOf:
  29       - description:
  30           Enable watchdog fault reset. A watchdog fault triggers
  31           watchdog reset.
  32         const: hardware
  33       - description:
  34           Enable watchdog fault interrupt. A watchdog fault asserts
  35           watchdog interrupt.
  36         const: software
  37     default: hardware
  38
  39   atmel,idle-halt:
  40     $ref: /schemas/types.yaml#/definitions/flag
  41     description: |
  42       present if you want to stop the watchdog when the CPU is in idle state.
  43       CAUTION: This property should be used with care, it actually makes the
  44       watchdog not counting when the CPU is in idle state, therefore the
  45       watchdog reset time depends on mean CPU usage and will not reset at all
  46       if the CPU stop working while it is in idle state, which is probably
  47       not what you want.
  48
  49   atmel,dbg-halt:
  50     $ref: /schemas/types.yaml#/definitions/flag
  51     description: |
  52       present if you want to stop the watchdog when the CPU is in debug state.
  53
  54 required:
  55   - compatible
  56   - reg
  57
  58 unevaluatedProperties: false
  59
  60 examples:
  61   - |
  62     #include <dt-bindings/interrupt-controller/irq.h>
  63
  64     watchdog@fc068640 {
  65       compatible = "atmel,sama5d4-wdt";
  66       reg = <0xfc068640 0x10>;
  67       interrupts = <4 IRQ_TYPE_LEVEL_HIGH 5>;
  68       timeout-sec = <10>;
  69       atmel,watchdog-type = "hardware";
  70       atmel,dbg-halt;
  71       atmel,idle-halt;
  72     };
  73
  74 ...