[PATCH v4 1/2] dt-bindings: arm: stm32: Document st,stm32mp23/25-syscfg subnodes and cells

[Conor Dooley]

On Mon, Aug 31, 2026 at 06:27:21PM +0200, Marek Vasut wrote:
> On 8/31/26 5:05 PM, Conor Dooley wrote:
> 
> Hello Conor,
> 
> > > > Sashiko comment here I believe is valid, the syntax here only works if
> > > > there's only the listed compatible present. It doesn't work with
> > > > fallbacks.
> > > 
> > > This syntax is used all over the place ?
> > > 
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-allOf:
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-  - $ref:
> > > ahci-common.yaml#
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-  - if:
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-      properties:
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-        compatible:
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml:          contains:
> > 
> >                                                                       ^^^^^^^^
> > This is the key difference, you need "contains" for partial matches.
> 
> Uh ... right ... fixed in V5. Thank you.
> 
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-            enum:
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-              -
> > > qcom,apq8064-ahci
> > > Documentation/devicetree/bindings/ata/ahci-platform.yaml-              -
> > > qcom,ipq806x-ahci
> > > 
> > > > pw-bot: changes-requested
> > > > 
> > > > >        then:
> > > > >          required:
> > > > >            - "#clock-cells"
> > > > > +        - "#address-cells"
> > > > > +        - "#size-cells"
> > > > 
> > > > else, false? But I'm also not sure what the benefit is of requiring
> > > > addr/size cells when the child node is not?
> > > The subnodes of this syscfg node have reg property , see [PATCH v4 0/4]
> > > arm64: dts: st: Add STM32MP2 USB support .
> > 
> > Right, but I was questioning why the properties describing the reg
> > property in children is required when the children (and thus the reg
> > property in them) were not made required.
> 
> Do you mean this patternProperties should be made required in here ?
> 
> "
> +patternProperties:
> +  "^phy@[0-9a-f]+$":
> "
> 
> Could you please give me a hint how to do that ? git grep gives me nothing.

I mean, if the phys aren't going to be required I would not make the
cells properties required. I seem to recall a warning that dtbs_check
can emit when there are size/addr cells properties in a node where there
are no children, which is why I questioned this in the first place.

Otherwise, if the phys are to be made required (no idea if they should
be), I can only recall this being done with the non-pattern variant. IOW
required:
  - phy at 0
  - phy at 1

Cheers,
Conor.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 228 bytes
Desc: not available
URL: <http://lists.infradead.org/pipermail/linux-arm-kernel/attachments/20260831/ac1a8544/attachment.sig>