From: Neil Armstrong <neil.armstrong@linaro.org>
To: Rob Herring <robh@kernel.org>, Heiner Kallweit <hkallweit1@gmail.com>
Cc: Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
Kevin Hilman <khilman@baylibre.com>,
Jerome Brunet <jbrunet@baylibre.com>,
Martin Blumenstingl <martin.blumenstingl@googlemail.com>,
Thomas Gleixner <tglx@linutronix.de>,
Marc Zyngier <maz@kernel.org>,
"devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
"linux-arm-kernel@lists.infradead.org"
<linux-arm-kernel@lists.infradead.org>,
"open list:ARM/Amlogic Meson..."
<linux-amlogic@lists.infradead.org>
Subject: Re: [PATCH v3] dt-bindings: interrupt-controller: Convert Amlogic Meson GPIO interrupt controller binding
Date: Wed, 1 Feb 2023 11:21:57 +0100 [thread overview]
Message-ID: <1601ad73-a593-6fc5-c6f5-a84cc39e8f6b@linaro.org> (raw)
In-Reply-To: <20230201020337.GA2311900-robh@kernel.org>
On 01/02/2023 03:03, Rob Herring wrote:
> On Mon, Jan 30, 2023 at 09:53:21PM +0100, Heiner Kallweit wrote:
>> Convert Amlogic Meson GPIO interrupt controller binding to yaml.
>>
>> Signed-off-by: Heiner Kallweit <hkallweit1@gmail.com>
>> ---
>> v2:
>> - consider that more than one compatible may be set
>> - remove bus part from example
>> v3:
>> - remove minItem/maxItem properties for compatible
>> ---
>> .../amlogic,meson-gpio-intc.txt | 38 ---------
>> .../amlogic,meson-gpio-intc.yaml | 84 +++++++++++++++++++
>> 2 files changed, 84 insertions(+), 38 deletions(-)
>> delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.txt
>> create mode 100644 Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.yaml
>>
>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.txt b/Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.txt
>> deleted file mode 100644
>> index bde63f8f0..000000000
>> --- a/Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.txt
>> +++ /dev/null
>> @@ -1,38 +0,0 @@
>> -Amlogic meson GPIO interrupt controller
>> -
>> -Meson SoCs contains an interrupt controller which is able to watch the SoC
>> -pads and generate an interrupt on edge or level. The controller is essentially
>> -a 256 pads to 8 GIC interrupt multiplexer, with a filter block to select edge
>> -or level and polarity. It does not expose all 256 mux inputs because the
>> -documentation shows that the upper part is not mapped to any pad. The actual
>> -number of interrupt exposed depends on the SoC.
>> -
>> -Required properties:
>> -
>> -- compatible : must have "amlogic,meson8-gpio-intc" and either
>> - "amlogic,meson8-gpio-intc" for meson8 SoCs (S802) or
>> - "amlogic,meson8b-gpio-intc" for meson8b SoCs (S805) or
>> - "amlogic,meson-gxbb-gpio-intc" for GXBB SoCs (S905) or
>> - "amlogic,meson-gxl-gpio-intc" for GXL SoCs (S905X, S912)
>> - "amlogic,meson-axg-gpio-intc" for AXG SoCs (A113D, A113X)
>> - "amlogic,meson-g12a-gpio-intc" for G12A SoCs (S905D2, S905X2, S905Y2)
>> - "amlogic,meson-sm1-gpio-intc" for SM1 SoCs (S905D3, S905X3, S905Y3)
>> - "amlogic,meson-a1-gpio-intc" for A1 SoCs (A113L)
>> - "amlogic,meson-s4-gpio-intc" for S4 SoCs (S802X2, S905Y4, S805X2G, S905W2)
>> -- 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 must be 2.
>> -- meson,channel-interrupts: Array with the 8 upstream hwirq numbers. These
>> - are the hwirqs used on the parent interrupt controller.
>> -
>> -Example:
>> -
>> -gpio_interrupt: interrupt-controller@9880 {
>> - compatible = "amlogic,meson-gxbb-gpio-intc",
>> - "amlogic,meson-gpio-intc";
>> - reg = <0x0 0x9880 0x0 0x10>;
>> - interrupt-controller;
>> - #interrupt-cells = <2>;
>> - meson,channel-interrupts = <64 65 66 67 68 69 70 71>;
>> -};
>> diff --git a/Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.yaml b/Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.yaml
>> new file mode 100644
>> index 000000000..da55a2d25
>> --- /dev/null
>> +++ b/Documentation/devicetree/bindings/interrupt-controller/amlogic,meson-gpio-intc.yaml
>> @@ -0,0 +1,84 @@
>> +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
>> +%YAML 1.2
>> +---
>> +$id: http://devicetree.org/schemas/interrupt-controller/amlogic,meson-gpio-intc.yaml#
>> +$schema: http://devicetree.org/meta-schemas/core.yaml#
>> +
>> +title: Amlogic Meson GPIO interrupt controller
>> +
>> +maintainers:
>> + - Heiner Kallweit <hkallweit1@gmail.com>
>> +
>> +description: |
>> + Meson SoCs contains an interrupt controller which is able to watch the SoC
>> + pads and generate an interrupt on edge or level. The controller is essentially
>> + a 256 pads to 8 GIC interrupt multiplexer, with a filter block to select edge
>> + or level and polarity. It does not expose all 256 mux inputs because the
>> + documentation shows that the upper part is not mapped to any pad. The actual
>> + number of interrupt exposed depends on the SoC.
>> +
>> +allOf:
>> + - $ref: /schemas/interrupt-controller.yaml#
>> +
>> +properties:
>> + compatible:
>> + oneOf:
>> + - items:
>> + - enum:
>> + - amlogic,meson-gpio-intc
>> + - amlogic,meson8-gpio-intc
>> + - amlogic,meson8b-gpio-intc
>> + - amlogic,meson-gxbb-gpio-intc
>> + - amlogic,meson-gxl-gpio-intc
>> + - amlogic,meson-axg-gpio-intc
>> + - amlogic,meson-g12a-gpio-intc
>> + - amlogic,meson-sm1-gpio-intc
>> + - amlogic,meson-a1-gpio-intc
>> + - amlogic,meson-s4-gpio-intc
>> + - items:
>> + - enum:
>> + - amlogic,meson8-gpio-intc
>
> We allow this with or without a fallback? Again, that should not be
> allowed and any dts files fixed.
I'm not very open onto removing any compatible to the current DTs
>
>> + - amlogic,meson-axg-gpio-intc
>> + - amlogic,meson-g12a-gpio-intc
>> + - amlogic,meson-sm1-gpio-intc
>> + - amlogic,meson-s4-gpio-intc
>> + - const: amlogic,meson-gpio-intc
>> + - items:
>> + - const: amlogic,meson-gpio-intc
>> + - enum:
>> + - amlogic,meson8b-gpio-intc
>> + - amlogic,meson-gxbb-gpio-intc
>> + - amlogic,meson-gxl-gpio-intc
>
> This looks wrong. The order is most specific to least specific
> compatible. amlogic,meson-gpio-intc is more specific (or a superset of)
> than amlogic,meson8b-gpio-intc?
But changing order is OK I suppose.
Neil
>
>> +
>> + reg:
>> + maxItems: 1
>> +
>> + interrupt-controller: true
>> +
>> + "#interrupt-cells":
>> + const: 2
>> +
>> + amlogic,channel-interrupts:
>
> This was 'meson', not 'amlogic'. You can't just change things.
>
> Really, 'interrupts' should have been used here, but oh well.
>
>> + description: Array with the upstream hwirq numbers
>> + minItems: 8
>> + maxItems: 12
>> + $ref: /schemas/types.yaml#/definitions/uint32-array
>> +
>> +required:
>> + - compatible
>> + - reg
>> + - interrupt-controller
>> + - "#interrupt-cells"
>> + - amlogic,channel-interrupts
>> +
>> +additionalProperties: false
>> +
>> +examples:
>> + - |
>> + interrupt-controller@9880 {
>> + compatible = "amlogic,meson-gxbb-gpio-intc";
>> + reg = <0x9880 0x10>;
>> + interrupt-controller;
>> + #interrupt-cells = <2>;
>> + amlogic,channel-interrupts = <64 65 66 67 68 69 70 71>;
>> + };
>> --
>> 2.39.1
>>
next prev parent reply other threads:[~2023-02-01 10:22 UTC|newest]
Thread overview: 46+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-01-23 21:22 [PATCH 0/8] soc: amlogic: switch bindings to yaml and adjust some dtbs's Heiner Kallweit
2023-01-23 21:23 ` [PATCH 1/8] arm64: dts: meson-gx: Remove invalid pwm compatible Heiner Kallweit
2023-01-23 21:24 ` [PATCH 2/8] arm64: dts: amlogic: Fix non-compliant SD/SDIO node names Heiner Kallweit
2023-01-24 7:17 ` Neil Armstrong
2023-01-23 21:25 ` [PATCH 3/8] arm64: dts: meson-gx: Set only one compatible string for mmc Heiner Kallweit
2023-01-23 21:27 ` [PATCH 4/8] arm64: dts: amlogic: Remove invalid compatible string amlogic,meson-gpio-intc Heiner Kallweit
2023-01-23 21:28 ` [PATCH 5/8] dt-bindings: rtc: Add Amlogic Meson vrtc controller binding Heiner Kallweit
2023-01-25 19:19 ` Rob Herring
2023-01-23 21:29 ` [PATCH 6/8] dt-bindings: pwm: Add Amlogic Meson PWM binding Heiner Kallweit
2023-01-24 1:22 ` Rob Herring
2023-01-25 19:22 ` Rob Herring
2023-01-23 21:30 ` [PATCH 7/8] dt-bindings: interrupt-controller: Add Amlogic Meson GPIO interrupt controller binding Heiner Kallweit
2023-01-24 1:22 ` Rob Herring
2023-01-24 7:03 ` Heiner Kallweit
2023-01-25 16:46 ` Rob Herring
2023-01-23 21:30 ` [PATCH 8/8] dt-bindings: pinctrl: Add Amlogic Meson pinctrl binding Heiner Kallweit
2023-01-24 1:22 ` Rob Herring
2023-01-24 7:14 ` Heiner Kallweit
2023-01-24 7:16 ` [PATCH 0/8] soc: amlogic: switch bindings to yaml and adjust some dtbs's Neil Armstrong
2023-01-24 9:20 ` Heiner Kallweit
2023-01-26 7:40 ` Uwe Kleine-König
2023-01-24 8:22 ` (subset) " Neil Armstrong
2023-01-25 22:24 ` [PATCH v2] dt-bindings: rtc: Convert Amlogic Meson vrtc controller binding Heiner Kallweit
2023-01-30 17:09 ` Rob Herring
2023-02-09 22:16 ` (subset) " Alexandre Belloni
2023-01-25 22:28 ` [PATCH v2] dt-bindings: pwm: Convert Amlogic Meson PWM binding Heiner Kallweit
2023-01-30 17:16 ` Rob Herring
2023-01-27 21:14 ` [PATCH v2] dt-bindings: interrupt-controller: Convert Amlogic Meson GPIO interrupt controller binding Heiner Kallweit
2023-01-27 21:16 ` [PATCH v2] dt-bindings: pinctrl: Convert Amlogic Meson pinctrl binding Heiner Kallweit
2023-01-30 20:34 ` [PATCH v3] dt-bindings: pwm: Convert Amlogic Meson PWM binding Heiner Kallweit
2023-01-30 21:21 ` Rob Herring
2023-02-01 7:35 ` Krzysztof Kozlowski
2023-01-30 20:53 ` [PATCH v3] dt-bindings: interrupt-controller: Convert Amlogic Meson GPIO interrupt controller binding Heiner Kallweit
2023-02-01 2:03 ` Rob Herring
2023-02-01 6:47 ` Heiner Kallweit
2023-02-01 10:21 ` Neil Armstrong [this message]
2023-01-30 21:00 ` [PATCH v3] dt-bindings: pinctrl: Convert Amlogic Meson pinctrl binding Heiner Kallweit
2023-02-01 2:06 ` Rob Herring
2023-02-01 22:13 ` Heiner Kallweit
2023-02-04 22:56 ` Martin Blumenstingl
2023-02-05 0:05 ` Heiner Kallweit
2023-02-05 7:57 ` Neil Armstrong
2023-02-05 16:54 ` Heiner Kallweit
2023-02-06 9:30 ` Neil Armstrong
2023-02-01 10:56 ` Neil Armstrong
2023-06-22 7:57 ` [PATCH 0/8] soc: amlogic: switch bindings to yaml and adjust some dtbs's Neil Armstrong
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1601ad73-a593-6fc5-c6f5-a84cc39e8f6b@linaro.org \
--to=neil.armstrong@linaro.org \
--cc=devicetree@vger.kernel.org \
--cc=hkallweit1@gmail.com \
--cc=jbrunet@baylibre.com \
--cc=khilman@baylibre.com \
--cc=krzysztof.kozlowski+dt@linaro.org \
--cc=linux-amlogic@lists.infradead.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=martin.blumenstingl@googlemail.com \
--cc=maz@kernel.org \
--cc=robh@kernel.org \
--cc=tglx@linutronix.de \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).