diff mbox series

dt-bindings: input: ariel-pwrbutton: use spi-peripheral-props.yaml

Message ID 20220727164230.385614-1-krzysztof.kozlowski@linaro.org (mailing list archive)
State Under Review
Commit e4bb7fee188dab08b7e589fff7616716cdbd5c3b
Headers show
Series dt-bindings: input: ariel-pwrbutton: use spi-peripheral-props.yaml | expand

Commit Message

Krzysztof Kozlowski July 27, 2022, 4:42 p.m. UTC
Instead of listing directly properties typical for SPI peripherals,
reference the spi-peripheral-props.yaml schema.  This allows using all
properties typical for SPI-connected devices, even these which device
bindings author did not tried yet.

Remove the spi-* properties which now come via spi-peripheral-props.yaml
schema, except for the cases when device schema adds some constraints
like maximum frequency.

While changing additionalProperties->unevaluatedProperties, put it in
typical place, just before example DTS.a

The binding references also input.yaml and lists explicitly allowed
properties, thus here reference only spi-peripheral-props.yaml for
purpose of documenting the SPI slave device and bringing
spi-max-frequency type validation.

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

---

Technically, this depends on [1] merged to SPI tree, if we want to
preserve existing behavior of not allowing SPI CPHA and CPOL in each of
schemas in this patch.

If this patch comes independently via different tree, the SPI CPHA and
CPOL will be allowed for brief period of time, before [1] is merged.
This will not have negative impact, just DT schema checks will be
loosened for that period.

[1] https://lore.kernel.org/all/20220722191539.90641-2-krzysztof.kozlowski@linaro.org/
---
 Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml | 1 +
 1 file changed, 1 insertion(+)

Comments

Rob Herring (Arm) July 28, 2022, 3:19 p.m. UTC | #1
On Wed, 27 Jul 2022 18:42:30 +0200, Krzysztof Kozlowski wrote:
> Instead of listing directly properties typical for SPI peripherals,
> reference the spi-peripheral-props.yaml schema.  This allows using all
> properties typical for SPI-connected devices, even these which device
> bindings author did not tried yet.
> 
> Remove the spi-* properties which now come via spi-peripheral-props.yaml
> schema, except for the cases when device schema adds some constraints
> like maximum frequency.
> 
> While changing additionalProperties->unevaluatedProperties, put it in
> typical place, just before example DTS.a
> 
> The binding references also input.yaml and lists explicitly allowed
> properties, thus here reference only spi-peripheral-props.yaml for
> purpose of documenting the SPI slave device and bringing
> spi-max-frequency type validation.
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> 
> ---
> 
> Technically, this depends on [1] merged to SPI tree, if we want to
> preserve existing behavior of not allowing SPI CPHA and CPOL in each of
> schemas in this patch.
> 
> If this patch comes independently via different tree, the SPI CPHA and
> CPOL will be allowed for brief period of time, before [1] is merged.
> This will not have negative impact, just DT schema checks will be
> loosened for that period.
> 
> [1] https://lore.kernel.org/all/20220722191539.90641-2-krzysztof.kozlowski@linaro.org/
> ---
>  Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml | 1 +
>  1 file changed, 1 insertion(+)
> 

Acked-by: Rob Herring <robh@kernel.org>
Dmitry Torokhov July 28, 2022, 8:16 p.m. UTC | #2
On Wed, Jul 27, 2022 at 06:42:30PM +0200, Krzysztof Kozlowski wrote:
> Instead of listing directly properties typical for SPI peripherals,
> reference the spi-peripheral-props.yaml schema.  This allows using all
> properties typical for SPI-connected devices, even these which device
> bindings author did not tried yet.
> 
> Remove the spi-* properties which now come via spi-peripheral-props.yaml
> schema, except for the cases when device schema adds some constraints
> like maximum frequency.
> 
> While changing additionalProperties->unevaluatedProperties, put it in
> typical place, just before example DTS.a
> 
> The binding references also input.yaml and lists explicitly allowed
> properties, thus here reference only spi-peripheral-props.yaml for
> purpose of documenting the SPI slave device and bringing
> spi-max-frequency type validation.
> 
> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> 

Applied, thank you.
Dmitry Torokhov Aug. 10, 2022, 10:57 p.m. UTC | #3
On Thu, Jul 28, 2022 at 09:19:42AM -0600, Rob Herring wrote:
> On Wed, 27 Jul 2022 18:42:30 +0200, Krzysztof Kozlowski wrote:
> > Instead of listing directly properties typical for SPI peripherals,
> > reference the spi-peripheral-props.yaml schema.  This allows using all
> > properties typical for SPI-connected devices, even these which device
> > bindings author did not tried yet.
> > 
> > Remove the spi-* properties which now come via spi-peripheral-props.yaml
> > schema, except for the cases when device schema adds some constraints
> > like maximum frequency.
> > 
> > While changing additionalProperties->unevaluatedProperties, put it in
> > typical place, just before example DTS.a
> > 
> > The binding references also input.yaml and lists explicitly allowed
> > properties, thus here reference only spi-peripheral-props.yaml for
> > purpose of documenting the SPI slave device and bringing
> > spi-max-frequency type validation.
> > 
> > Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> > 
> > ---
> > 
> > Technically, this depends on [1] merged to SPI tree, if we want to
> > preserve existing behavior of not allowing SPI CPHA and CPOL in each of
> > schemas in this patch.

Could we merge this through SPI tree as well?

> > 
> > If this patch comes independently via different tree, the SPI CPHA and
> > CPOL will be allowed for brief period of time, before [1] is merged.
> > This will not have negative impact, just DT schema checks will be
> > loosened for that period.
> > 
> > [1] https://lore.kernel.org/all/20220722191539.90641-2-krzysztof.kozlowski@linaro.org/
> > ---
> >  Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml | 1 +
> >  1 file changed, 1 insertion(+)
> > 
> 
> Acked-by: Rob Herring <robh@kernel.org>

Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
Krzysztof Kozlowski Aug. 11, 2022, 6:21 a.m. UTC | #4
On 11/08/2022 01:57, Dmitry Torokhov wrote:
> On Thu, Jul 28, 2022 at 09:19:42AM -0600, Rob Herring wrote:
>> On Wed, 27 Jul 2022 18:42:30 +0200, Krzysztof Kozlowski wrote:
>>> Instead of listing directly properties typical for SPI peripherals,
>>> reference the spi-peripheral-props.yaml schema.  This allows using all
>>> properties typical for SPI-connected devices, even these which device
>>> bindings author did not tried yet.
>>>
>>> Remove the spi-* properties which now come via spi-peripheral-props.yaml
>>> schema, except for the cases when device schema adds some constraints
>>> like maximum frequency.
>>>
>>> While changing additionalProperties->unevaluatedProperties, put it in
>>> typical place, just before example DTS.a
>>>
>>> The binding references also input.yaml and lists explicitly allowed
>>> properties, thus here reference only spi-peripheral-props.yaml for
>>> purpose of documenting the SPI slave device and bringing
>>> spi-max-frequency type validation.
>>>
>>> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
>>>
>>> ---
>>>
>>> Technically, this depends on [1] merged to SPI tree, if we want to
>>> preserve existing behavior of not allowing SPI CPHA and CPOL in each of
>>> schemas in this patch.
> 
> Could we merge this through SPI tree as well?
> 
>>>
>>> If this patch comes independently via different tree, the SPI CPHA and
>>> CPOL will be allowed for brief period of time, before [1] is merged.
>>> This will not have negative impact, just DT schema checks will be
>>> loosened for that period.
>>>
>>> [1] https://lore.kernel.org/all/20220722191539.90641-2-krzysztof.kozlowski@linaro.org/
>>> ---
>>>  Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml | 1 +
>>>  1 file changed, 1 insertion(+)
>>>
>>
>> Acked-by: Rob Herring <robh@kernel.org>
> 
> Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
> 

There is no dependency anymore (and actually that time it was not really
dependency), so you can take it freely for next cycle.

Best regards,
Krzysztof
Dmitry Torokhov Aug. 11, 2022, 6:20 p.m. UTC | #5
On Thu, Aug 11, 2022 at 09:21:35AM +0300, Krzysztof Kozlowski wrote:
> On 11/08/2022 01:57, Dmitry Torokhov wrote:
> > On Thu, Jul 28, 2022 at 09:19:42AM -0600, Rob Herring wrote:
> >> On Wed, 27 Jul 2022 18:42:30 +0200, Krzysztof Kozlowski wrote:
> >>> Instead of listing directly properties typical for SPI peripherals,
> >>> reference the spi-peripheral-props.yaml schema.  This allows using all
> >>> properties typical for SPI-connected devices, even these which device
> >>> bindings author did not tried yet.
> >>>
> >>> Remove the spi-* properties which now come via spi-peripheral-props.yaml
> >>> schema, except for the cases when device schema adds some constraints
> >>> like maximum frequency.
> >>>
> >>> While changing additionalProperties->unevaluatedProperties, put it in
> >>> typical place, just before example DTS.a
> >>>
> >>> The binding references also input.yaml and lists explicitly allowed
> >>> properties, thus here reference only spi-peripheral-props.yaml for
> >>> purpose of documenting the SPI slave device and bringing
> >>> spi-max-frequency type validation.
> >>>
> >>> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org>
> >>>
> >>> ---
> >>>
> >>> Technically, this depends on [1] merged to SPI tree, if we want to
> >>> preserve existing behavior of not allowing SPI CPHA and CPOL in each of
> >>> schemas in this patch.
> > 
> > Could we merge this through SPI tree as well?
> > 
> >>>
> >>> If this patch comes independently via different tree, the SPI CPHA and
> >>> CPOL will be allowed for brief period of time, before [1] is merged.
> >>> This will not have negative impact, just DT schema checks will be
> >>> loosened for that period.
> >>>
> >>> [1] https://lore.kernel.org/all/20220722191539.90641-2-krzysztof.kozlowski@linaro.org/
> >>> ---
> >>>  Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml | 1 +
> >>>  1 file changed, 1 insertion(+)
> >>>
> >>
> >> Acked-by: Rob Herring <robh@kernel.org>
> > 
> > Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com>
> > 
> 
> There is no dependency anymore (and actually that time it was not really
> dependency), so you can take it freely for next cycle.

Hm, it turns out I already applied it and even included in pull request
for Linus. But for some reason my "applied" email was not bcc-ed to me
and so I got terribly confused.
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml b/Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml
index b4ad829d7383..442f623bb294 100644
--- a/Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml
+++ b/Documentation/devicetree/bindings/input/ariel-pwrbutton.yaml
@@ -17,6 +17,7 @@  description: |
 
 allOf:
   - $ref: input.yaml#
+  - $ref: /schemas/spi/spi-peripheral-props.yaml#
 
 properties:
   compatible: