Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18;
IronPort-SDR: WV4os3pfZ6cZd/F+isGOSsgdRoZqlZmoe1Jd/BcmuciyzyoKjZnW4A3/ZkfTuKfu3bwxoV7UsS
 dxmt/Mk8IbEGPFoCSZMmFu6o/7YkmXqI2RpMHMfvNkemSlldRuMdf/M7XGOS3pHY0IiBZRtxFS
 Djvvopcgp0EDhVva1LFzXTFRtnoZgr1PqUg5cKPHq2xy3VCRUAQ/Hcdf7CWGW+KjnZkkkRUuNH
 Oe/Dh6VGD1L+Ly528+CvkZiK3be3O6s7W4gRuL6ThaH0Z9ImGxCb01P0J3DOLJ5CDbnuMP4zYf
 fPs=
Subject: Re: [PATCH 1/3] dt-bindings: watchdog: sama5d4-wdt: convert to yaml
To:     Eugen Hristev <eugen.hristev@microchip.com>,
        <wim@linux-watchdog.org>, <linux@roeck-us.net>,
        <robh+dt@kernel.org>
CC:     <linux-watchdog@vger.kernel.org>, <devicetree@vger.kernel.org>,
        <linux-arm-kernel@lists.infradead.org>,
        <linux-kernel@vger.kernel.org>
References: <20210527100120.266796-1-eugen.hristev@microchip.com>
From:   Nicolas Ferre <nicolas.ferre@microchip.com>
Organization: microchip
Message-ID: <2360b414-6a92-2952-8eec-954497f84bae@microchip.com>
Date:   Sun, 6 Jun 2021 18:52:58 +0200
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101
 Thunderbird/78.8.1
MIME-Version: 1.0
In-Reply-To: <20210527100120.266796-1-eugen.hristev@microchip.com>
Content-Type: text/plain; charset="windows-1252"; format=flowed
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Precedence: bulk

On 27/05/2021 at 12:01, Eugen Hristev wrote:
> Convert the old txt binding to yaml format.
> 
> Signed-off-by: Eugen Hristev <eugen.hristev@microchip.com>

Series queued on at91-dt for 5.14. Will be sent to arm-soc soon.
Thanks, best regards,
   Nicolas

> ---
>   .../bindings/watchdog/atmel,sama5d4-wdt.yaml  | 73 +++++++++++++++++++
>   .../bindings/watchdog/atmel-sama5d4-wdt.txt   | 34 ---------
>   2 files changed, 73 insertions(+), 34 deletions(-)
>   create mode 100644 Documentation/devicetree/bindings/watchdog/atmel,sama5d4-wdt.yaml
>   delete mode 100644 Documentation/devicetree/bindings/watchdog/atmel-sama5d4-wdt.txt
> 
> diff --git a/Documentation/devicetree/bindings/watchdog/atmel,sama5d4-wdt.yaml b/Documentation/devicetree/bindings/watchdog/atmel,sama5d4-wdt.yaml
> new file mode 100644
> index 000000000000..0d0ab81da040
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/watchdog/atmel,sama5d4-wdt.yaml
> @@ -0,0 +1,73 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/watchdog/atmel,sama5d4-wdt.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Atmel SAMA5D4 Watchdog Timer (WDT) Controller
> +
> +maintainers:
> +  - Eugen Hristev <eugen.hristev@microchip.com>
> +
> +allOf:
> +  - $ref: "watchdog.yaml#"
> +
> +properties:
> +  compatible:
> +    enum:
> +      - atmel,sama5d4-wdt
> +      - microchip,sam9x60-wdt
> +
> +  reg:
> +    maxItems: 1
> +
> +  atmel,watchdog-type:
> +    $ref: /schemas/types.yaml#/definitions/string
> +    description: should be hardware or software.
> +    oneOf:
> +      - description:
> +          Enable watchdog fault reset. A watchdog fault triggers
> +          watchdog reset.
> +        const: hardware
> +      - description:
> +          Enable watchdog fault interrupt. A watchdog fault asserts
> +          watchdog interrupt.
> +        const: software
> +    default: hardware
> +
> +  atmel,idle-halt:
> +    $ref: /schemas/types.yaml#/definitions/flag
> +    description: |
> +      present if you want to stop the watchdog when the CPU is in idle state.
> +      CAUTION: This property should be used with care, it actually makes the
> +      watchdog not counting when the CPU is in idle state, therefore the
> +      watchdog reset time depends on mean CPU usage and will not reset at all
> +      if the CPU stop working while it is in idle state, which is probably
> +      not what you want.
> +
> +  atmel,dbg-halt:
> +    $ref: /schemas/types.yaml#/definitions/flag
> +    description: |
> +      present if you want to stop the watchdog when the CPU is in debug state.
> +
> +required:
> +  - compatible
> +  - reg
> +
> +unevaluatedProperties: false
> +
> +examples:
> +  - |
> +    #include <dt-bindings/interrupt-controller/irq.h>
> +
> +    watchdog@fc068640 {
> +      compatible = "atmel,sama5d4-wdt";
> +      reg = <0xfc068640 0x10>;
> +      interrupts = <4 IRQ_TYPE_LEVEL_HIGH 5>;
> +      timeout-sec = <10>;
> +      atmel,watchdog-type = "hardware";
> +      atmel,dbg-halt;
> +      atmel,idle-halt;
> +    };
> +
> +...
> diff --git a/Documentation/devicetree/bindings/watchdog/atmel-sama5d4-wdt.txt b/Documentation/devicetree/bindings/watchdog/atmel-sama5d4-wdt.txt
> deleted file mode 100644
> index 44727fcc2729..000000000000
> --- a/Documentation/devicetree/bindings/watchdog/atmel-sama5d4-wdt.txt
> +++ /dev/null
> @@ -1,34 +0,0 @@
> -* Atmel SAMA5D4 Watchdog Timer (WDT) Controller
> -
> -Required properties:
> -- compatible: "atmel,sama5d4-wdt" or "microchip,sam9x60-wdt"
> -- reg: base physical address and length of memory mapped region.
> -
> -Optional properties:
> -- timeout-sec: watchdog timeout value (in seconds).
> -- interrupts: interrupt number to the CPU.
> -- atmel,watchdog-type: should be "hardware" or "software".
> -	"hardware": enable watchdog fault reset. A watchdog fault triggers
> -		    watchdog reset.
> -	"software": enable watchdog fault interrupt. A watchdog fault asserts
> -		    watchdog interrupt.
> -- atmel,idle-halt: present if you want to stop the watchdog when the CPU is
> -		   in idle state.
> -	CAUTION: This property should be used with care, it actually makes the
> -	watchdog not counting when the CPU is in idle state, therefore the
> -	watchdog reset time depends on mean CPU usage and will not reset at all
> -	if the CPU stop working while it is in idle state, which is probably
> -	not what you want.
> -- atmel,dbg-halt: present if you want to stop the watchdog when the CPU is
> -		  in debug state.
> -
> -Example:
> -	watchdog@fc068640 {
> -		compatible = "atmel,sama5d4-wdt";
> -		reg = <0xfc068640 0x10>;
> -		interrupts = <4 IRQ_TYPE_LEVEL_HIGH 5>;
> -		timeout-sec = <10>;
> -		atmel,watchdog-type = "hardware";
> -		atmel,dbg-halt;
> -		atmel,idle-halt;
> -	};
> 


-- 
Nicolas Ferre