diff mbox series

dt-bindings: interrupt-controller: convert loongson,ls1x-intc.txt to json-schema

Message ID 20230218122236.1919465-1-keguang.zhang@gmail.com (mailing list archive)
State Superseded
Headers show
Series dt-bindings: interrupt-controller: convert loongson,ls1x-intc.txt to json-schema | expand

Commit Message

Keguang Zhang Feb. 18, 2023, 12:22 p.m. UTC
Convert the Loongson1 interrupt controller dt-bindings to json-schema.

Signed-off-by: Keguang Zhang <keguang.zhang@gmail.com>
---
 .../loongson,ls1x-intc.txt                    | 24 ---------
 .../loongson,ls1x-intc.yaml                   | 51 +++++++++++++++++++
 2 files changed, 51 insertions(+), 24 deletions(-)
 delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
 create mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml


base-commit: 25eba1598c8e1e804c02e3a0da50782c50c11c41

Comments

Krzysztof Kozlowski Feb. 20, 2023, 8:04 a.m. UTC | #1
On 18/02/2023 13:22, Keguang Zhang wrote:
> Convert the Loongson1 interrupt controller dt-bindings to json-schema.
> 
> Signed-off-by: Keguang Zhang <keguang.zhang@gmail.com>
> ---
>  .../loongson,ls1x-intc.txt                    | 24 ---------
>  .../loongson,ls1x-intc.yaml                   | 51 +++++++++++++++++++
>  2 files changed, 51 insertions(+), 24 deletions(-)
>  delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
>  create mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> 
> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> deleted file mode 100644
> index a63ed9fcb535..000000000000
> --- a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> +++ /dev/null
> @@ -1,24 +0,0 @@
> -Loongson ls1x Interrupt Controller
> -
> -Required properties:
> -
> -- compatible : should be "loongson,ls1x-intc". Valid strings are:
> -
> -- reg : Specifies base physical address and size of the registers.
> -- interrupt-controller : Identifies the node as an interrupt controller
> -- #interrupt-cells : Specifies the number of cells needed to encode an
> -  interrupt source. The value shall be 2.
> -- interrupts : Specifies the CPU interrupt the controller is connected to.
> -
> -Example:
> -
> -intc: interrupt-controller@1fd01040 {
> -	compatible = "loongson,ls1x-intc";
> -	reg = <0x1fd01040 0x18>;
> -
> -	interrupt-controller;
> -	#interrupt-cells = <2>;
> -
> -	interrupt-parent = <&cpu_intc>;
> -	interrupts = <2>;
> -};
> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> new file mode 100644
> index 000000000000..4cea3ee9fbb1
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> @@ -0,0 +1,51 @@
> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> +%YAML 1.2
> +---
> +$id: http://devicetree.org/schemas/interrupt-controller/loongson,ls1x-intc.yaml#
> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> +
> +title: Loongson-1 Interrupt Controller

You changed the title, so this binding now will cover all Loonson-1
interrupt controllers?

> +
> +maintainers:
> +  - Keguang Zhang <keguang.zhang@gmail.com>
> +
> +description: |

Drop |

> +  Loongson-1 interrupt controller is connected to the MIPS core interrupt
> +  controller, which controls several groups of interrupts.
> +


Best regards,
Krzysztof
Keguang Zhang Feb. 20, 2023, 10:25 a.m. UTC | #2
On Mon, Feb 20, 2023 at 4:04 PM Krzysztof Kozlowski
<krzysztof.kozlowski@linaro.org> wrote:
>
> On 18/02/2023 13:22, Keguang Zhang wrote:
> > Convert the Loongson1 interrupt controller dt-bindings to json-schema.
> >
> > Signed-off-by: Keguang Zhang <keguang.zhang@gmail.com>
> > ---
> >  .../loongson,ls1x-intc.txt                    | 24 ---------
> >  .../loongson,ls1x-intc.yaml                   | 51 +++++++++++++++++++
> >  2 files changed, 51 insertions(+), 24 deletions(-)
> >  delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> >  create mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> >
> > diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> > deleted file mode 100644
> > index a63ed9fcb535..000000000000
> > --- a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> > +++ /dev/null
> > @@ -1,24 +0,0 @@
> > -Loongson ls1x Interrupt Controller
> > -
> > -Required properties:
> > -
> > -- compatible : should be "loongson,ls1x-intc". Valid strings are:
> > -
> > -- reg : Specifies base physical address and size of the registers.
> > -- interrupt-controller : Identifies the node as an interrupt controller
> > -- #interrupt-cells : Specifies the number of cells needed to encode an
> > -  interrupt source. The value shall be 2.
> > -- interrupts : Specifies the CPU interrupt the controller is connected to.
> > -
> > -Example:
> > -
> > -intc: interrupt-controller@1fd01040 {
> > -     compatible = "loongson,ls1x-intc";
> > -     reg = <0x1fd01040 0x18>;
> > -
> > -     interrupt-controller;
> > -     #interrupt-cells = <2>;
> > -
> > -     interrupt-parent = <&cpu_intc>;
> > -     interrupts = <2>;
> > -};
> > diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> > new file mode 100644
> > index 000000000000..4cea3ee9fbb1
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> > @@ -0,0 +1,51 @@
> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > +%YAML 1.2
> > +---
> > +$id: http://devicetree.org/schemas/interrupt-controller/loongson,ls1x-intc.yaml#
> > +$schema: http://devicetree.org/meta-schemas/core.yaml#
> > +
> > +title: Loongson-1 Interrupt Controller
>
> You changed the title, so this binding now will cover all Loonson-1
> interrupt controllers?
>
Yes.

> > +
> > +maintainers:
> > +  - Keguang Zhang <keguang.zhang@gmail.com>
> > +
> > +description: |
>
> Drop |
>
Will do.


> > +  Loongson-1 interrupt controller is connected to the MIPS core interrupt
> > +  controller, which controls several groups of interrupts.
> > +
>
>
> Best regards,
> Krzysztof
>


--
Best regards,

Kelvin Cheung
Krzysztof Kozlowski Feb. 20, 2023, 10:28 a.m. UTC | #3
On 20/02/2023 11:25, Kelvin Cheung wrote:
> On Mon, Feb 20, 2023 at 4:04 PM Krzysztof Kozlowski
> <krzysztof.kozlowski@linaro.org> wrote:
>>
>> On 18/02/2023 13:22, Keguang Zhang wrote:
>>> Convert the Loongson1 interrupt controller dt-bindings to json-schema.
>>>
>>> Signed-off-by: Keguang Zhang <keguang.zhang@gmail.com>
>>> ---
>>>  .../loongson,ls1x-intc.txt                    | 24 ---------
>>>  .../loongson,ls1x-intc.yaml                   | 51 +++++++++++++++++++
>>>  2 files changed, 51 insertions(+), 24 deletions(-)
>>>  delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
>>>  create mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
>>>
>>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
>>> deleted file mode 100644
>>> index a63ed9fcb535..000000000000
>>> --- a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
>>> +++ /dev/null
>>> @@ -1,24 +0,0 @@
>>> -Loongson ls1x Interrupt Controller
>>> -
>>> -Required properties:
>>> -
>>> -- compatible : should be "loongson,ls1x-intc". Valid strings are:
>>> -
>>> -- reg : Specifies base physical address and size of the registers.
>>> -- interrupt-controller : Identifies the node as an interrupt controller
>>> -- #interrupt-cells : Specifies the number of cells needed to encode an
>>> -  interrupt source. The value shall be 2.
>>> -- interrupts : Specifies the CPU interrupt the controller is connected to.
>>> -
>>> -Example:
>>> -
>>> -intc: interrupt-controller@1fd01040 {
>>> -     compatible = "loongson,ls1x-intc";
>>> -     reg = <0x1fd01040 0x18>;
>>> -
>>> -     interrupt-controller;
>>> -     #interrupt-cells = <2>;
>>> -
>>> -     interrupt-parent = <&cpu_intc>;
>>> -     interrupts = <2>;
>>> -};
>>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
>>> new file mode 100644
>>> index 000000000000..4cea3ee9fbb1
>>> --- /dev/null
>>> +++ b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
>>> @@ -0,0 +1,51 @@
>>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>>> +%YAML 1.2
>>> +---
>>> +$id: http://devicetree.org/schemas/interrupt-controller/loongson,ls1x-intc.yaml#
>>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
>>> +
>>> +title: Loongson-1 Interrupt Controller
>>
>> You changed the title, so this binding now will cover all Loonson-1
>> interrupt controllers?
>>
> Yes.

OK, then with the dropped |


Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>



Best regards,
Krzysztof
Keguang Zhang Feb. 20, 2023, 10:36 a.m. UTC | #4
On Mon, Feb 20, 2023 at 6:28 PM Krzysztof Kozlowski
<krzysztof.kozlowski@linaro.org> wrote:
>
> On 20/02/2023 11:25, Kelvin Cheung wrote:
> > On Mon, Feb 20, 2023 at 4:04 PM Krzysztof Kozlowski
> > <krzysztof.kozlowski@linaro.org> wrote:
> >>
> >> On 18/02/2023 13:22, Keguang Zhang wrote:
> >>> Convert the Loongson1 interrupt controller dt-bindings to json-schema.
> >>>
> >>> Signed-off-by: Keguang Zhang <keguang.zhang@gmail.com>
> >>> ---
> >>>  .../loongson,ls1x-intc.txt                    | 24 ---------
> >>>  .../loongson,ls1x-intc.yaml                   | 51 +++++++++++++++++++
> >>>  2 files changed, 51 insertions(+), 24 deletions(-)
> >>>  delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> >>>  create mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> >>>
> >>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> >>> deleted file mode 100644
> >>> index a63ed9fcb535..000000000000
> >>> --- a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> >>> +++ /dev/null
> >>> @@ -1,24 +0,0 @@
> >>> -Loongson ls1x Interrupt Controller
> >>> -
> >>> -Required properties:
> >>> -
> >>> -- compatible : should be "loongson,ls1x-intc". Valid strings are:
> >>> -
> >>> -- reg : Specifies base physical address and size of the registers.
> >>> -- interrupt-controller : Identifies the node as an interrupt controller
> >>> -- #interrupt-cells : Specifies the number of cells needed to encode an
> >>> -  interrupt source. The value shall be 2.
> >>> -- interrupts : Specifies the CPU interrupt the controller is connected to.
> >>> -
> >>> -Example:
> >>> -
> >>> -intc: interrupt-controller@1fd01040 {
> >>> -     compatible = "loongson,ls1x-intc";
> >>> -     reg = <0x1fd01040 0x18>;
> >>> -
> >>> -     interrupt-controller;
> >>> -     #interrupt-cells = <2>;
> >>> -
> >>> -     interrupt-parent = <&cpu_intc>;
> >>> -     interrupts = <2>;
> >>> -};
> >>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> >>> new file mode 100644
> >>> index 000000000000..4cea3ee9fbb1
> >>> --- /dev/null
> >>> +++ b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> >>> @@ -0,0 +1,51 @@
> >>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> >>> +%YAML 1.2
> >>> +---
> >>> +$id: http://devicetree.org/schemas/interrupt-controller/loongson,ls1x-intc.yaml#
> >>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> >>> +
> >>> +title: Loongson-1 Interrupt Controller
> >>
> >> You changed the title, so this binding now will cover all Loonson-1
> >> interrupt controllers?
> >>
> > Yes.
>
> OK, then with the dropped |
>
Sorry.
Should I send the patch V2 to drop the description part?
>
> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>
>
>
> Best regards,
> Krzysztof
>
Krzysztof Kozlowski Feb. 20, 2023, 10:40 a.m. UTC | #5
On 20/02/2023 11:36, Kelvin Cheung wrote:
> On Mon, Feb 20, 2023 at 6:28 PM Krzysztof Kozlowski
> <krzysztof.kozlowski@linaro.org> wrote:
>>
>> On 20/02/2023 11:25, Kelvin Cheung wrote:
>>> On Mon, Feb 20, 2023 at 4:04 PM Krzysztof Kozlowski
>>> <krzysztof.kozlowski@linaro.org> wrote:
>>>>
>>>> On 18/02/2023 13:22, Keguang Zhang wrote:
>>>>> Convert the Loongson1 interrupt controller dt-bindings to json-schema.
>>>>>
>>>>> Signed-off-by: Keguang Zhang <keguang.zhang@gmail.com>
>>>>> ---
>>>>>  .../loongson,ls1x-intc.txt                    | 24 ---------
>>>>>  .../loongson,ls1x-intc.yaml                   | 51 +++++++++++++++++++
>>>>>  2 files changed, 51 insertions(+), 24 deletions(-)
>>>>>  delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
>>>>>  create mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
>>>>>
>>>>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
>>>>> deleted file mode 100644
>>>>> index a63ed9fcb535..000000000000
>>>>> --- a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
>>>>> +++ /dev/null
>>>>> @@ -1,24 +0,0 @@
>>>>> -Loongson ls1x Interrupt Controller
>>>>> -
>>>>> -Required properties:
>>>>> -
>>>>> -- compatible : should be "loongson,ls1x-intc". Valid strings are:
>>>>> -
>>>>> -- reg : Specifies base physical address and size of the registers.
>>>>> -- interrupt-controller : Identifies the node as an interrupt controller
>>>>> -- #interrupt-cells : Specifies the number of cells needed to encode an
>>>>> -  interrupt source. The value shall be 2.
>>>>> -- interrupts : Specifies the CPU interrupt the controller is connected to.
>>>>> -
>>>>> -Example:
>>>>> -
>>>>> -intc: interrupt-controller@1fd01040 {
>>>>> -     compatible = "loongson,ls1x-intc";
>>>>> -     reg = <0x1fd01040 0x18>;
>>>>> -
>>>>> -     interrupt-controller;
>>>>> -     #interrupt-cells = <2>;
>>>>> -
>>>>> -     interrupt-parent = <&cpu_intc>;
>>>>> -     interrupts = <2>;
>>>>> -};
>>>>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
>>>>> new file mode 100644
>>>>> index 000000000000..4cea3ee9fbb1
>>>>> --- /dev/null
>>>>> +++ b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
>>>>> @@ -0,0 +1,51 @@
>>>>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>>>>> +%YAML 1.2
>>>>> +---
>>>>> +$id: http://devicetree.org/schemas/interrupt-controller/loongson,ls1x-intc.yaml#
>>>>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
>>>>> +
>>>>> +title: Loongson-1 Interrupt Controller
>>>>
>>>> You changed the title, so this binding now will cover all Loonson-1
>>>> interrupt controllers?
>>>>
>>> Yes.
>>
>> OK, then with the dropped |
>>
> Sorry.
> Should I send the patch V2 to drop the description part?

Yes, please, with my tag.

https://elixir.bootlin.com/linux/v5.17/source/Documentation/process/submitting-patches.rst#L540


Best regards,
Krzysztof
Keguang Zhang Feb. 20, 2023, 10:54 a.m. UTC | #6
On Mon, Feb 20, 2023 at 6:40 PM Krzysztof Kozlowski
<krzysztof.kozlowski@linaro.org> wrote:
>
> On 20/02/2023 11:36, Kelvin Cheung wrote:
> > On Mon, Feb 20, 2023 at 6:28 PM Krzysztof Kozlowski
> > <krzysztof.kozlowski@linaro.org> wrote:
> >>
> >> On 20/02/2023 11:25, Kelvin Cheung wrote:
> >>> On Mon, Feb 20, 2023 at 4:04 PM Krzysztof Kozlowski
> >>> <krzysztof.kozlowski@linaro.org> wrote:
> >>>>
> >>>> On 18/02/2023 13:22, Keguang Zhang wrote:
> >>>>> Convert the Loongson1 interrupt controller dt-bindings to json-schema.
> >>>>>
> >>>>> Signed-off-by: Keguang Zhang <keguang.zhang@gmail.com>
> >>>>> ---
> >>>>>  .../loongson,ls1x-intc.txt                    | 24 ---------
> >>>>>  .../loongson,ls1x-intc.yaml                   | 51 +++++++++++++++++++
> >>>>>  2 files changed, 51 insertions(+), 24 deletions(-)
> >>>>>  delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> >>>>>  create mode 100644 Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> >>>>>
> >>>>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> >>>>> deleted file mode 100644
> >>>>> index a63ed9fcb535..000000000000
> >>>>> --- a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
> >>>>> +++ /dev/null
> >>>>> @@ -1,24 +0,0 @@
> >>>>> -Loongson ls1x Interrupt Controller
> >>>>> -
> >>>>> -Required properties:
> >>>>> -
> >>>>> -- compatible : should be "loongson,ls1x-intc". Valid strings are:
> >>>>> -
> >>>>> -- reg : Specifies base physical address and size of the registers.
> >>>>> -- interrupt-controller : Identifies the node as an interrupt controller
> >>>>> -- #interrupt-cells : Specifies the number of cells needed to encode an
> >>>>> -  interrupt source. The value shall be 2.
> >>>>> -- interrupts : Specifies the CPU interrupt the controller is connected to.
> >>>>> -
> >>>>> -Example:
> >>>>> -
> >>>>> -intc: interrupt-controller@1fd01040 {
> >>>>> -     compatible = "loongson,ls1x-intc";
> >>>>> -     reg = <0x1fd01040 0x18>;
> >>>>> -
> >>>>> -     interrupt-controller;
> >>>>> -     #interrupt-cells = <2>;
> >>>>> -
> >>>>> -     interrupt-parent = <&cpu_intc>;
> >>>>> -     interrupts = <2>;
> >>>>> -};
> >>>>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> >>>>> new file mode 100644
> >>>>> index 000000000000..4cea3ee9fbb1
> >>>>> --- /dev/null
> >>>>> +++ b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
> >>>>> @@ -0,0 +1,51 @@
> >>>>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> >>>>> +%YAML 1.2
> >>>>> +---
> >>>>> +$id: http://devicetree.org/schemas/interrupt-controller/loongson,ls1x-intc.yaml#
> >>>>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
> >>>>> +
> >>>>> +title: Loongson-1 Interrupt Controller
> >>>>
> >>>> You changed the title, so this binding now will cover all Loonson-1
> >>>> interrupt controllers?
> >>>>
> >>> Yes.
> >>
> >> OK, then with the dropped |
> >>
> > Sorry.
> > Should I send the patch V2 to drop the description part?
>
> Yes, please, with my tag.

Thanks for your time.
>
> https://elixir.bootlin.com/linux/v5.17/source/Documentation/process/submitting-patches.rst#L540
>
>
> Best regards,
> Krzysztof
>
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
deleted file mode 100644
index a63ed9fcb535..000000000000
--- a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.txt
+++ /dev/null
@@ -1,24 +0,0 @@ 
-Loongson ls1x Interrupt Controller
-
-Required properties:
-
-- compatible : should be "loongson,ls1x-intc". Valid strings are:
-
-- reg : Specifies base physical address and size of the registers.
-- interrupt-controller : Identifies the node as an interrupt controller
-- #interrupt-cells : Specifies the number of cells needed to encode an
-  interrupt source. The value shall be 2.
-- interrupts : Specifies the CPU interrupt the controller is connected to.
-
-Example:
-
-intc: interrupt-controller@1fd01040 {
-	compatible = "loongson,ls1x-intc";
-	reg = <0x1fd01040 0x18>;
-
-	interrupt-controller;
-	#interrupt-cells = <2>;
-
-	interrupt-parent = <&cpu_intc>;
-	interrupts = <2>;
-};
diff --git a/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
new file mode 100644
index 000000000000..4cea3ee9fbb1
--- /dev/null
+++ b/Documentation/devicetree/bindings/interrupt-controller/loongson,ls1x-intc.yaml
@@ -0,0 +1,51 @@ 
+# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
+%YAML 1.2
+---
+$id: http://devicetree.org/schemas/interrupt-controller/loongson,ls1x-intc.yaml#
+$schema: http://devicetree.org/meta-schemas/core.yaml#
+
+title: Loongson-1 Interrupt Controller
+
+maintainers:
+  - Keguang Zhang <keguang.zhang@gmail.com>
+
+description: |
+  Loongson-1 interrupt controller is connected to the MIPS core interrupt
+  controller, which controls several groups of interrupts.
+
+properties:
+  compatible:
+    const: loongson,ls1x-intc
+
+  reg:
+    maxItems: 1
+
+  interrupt-controller: true
+
+  '#interrupt-cells':
+    const: 2
+
+  interrupts:
+    maxItems: 1
+
+required:
+  - compatible
+  - reg
+  - interrupt-controller
+  - '#interrupt-cells'
+  - interrupts
+
+additionalProperties: false
+
+examples:
+  - |
+    intc0: interrupt-controller@1fd01040 {
+        compatible = "loongson,ls1x-intc";
+        reg = <0x1fd01040 0x18>;
+
+        interrupt-controller;
+        #interrupt-cells = <2>;
+
+        interrupt-parent = <&cpu_intc>;
+        interrupts = <2>;
+    };