Re: [PATCH 1/2] dt-bindings: usb: parade,ps5511: Disallow unevaluated properties

[Krzysztof Kozlowski]

On 12/01/2026 21:20, Rob Herring wrote:
> On Mon, Jan 12, 2026 at 10:01:50AM +0100, Krzysztof Kozlowski wrote:
>> Review given to v2 [1] of commit fc259b024cb3 ("dt-bindings: usb: Add
>> binding for PS5511 hub controller") asked to use unevaluatedProperties,
>> but this was ignored by the author probably because current dtschema
>> does not allow to use both additionalProperties and
>> unevaluatedProperties.  As an effect, this binding does not end with
>> unevaluatedProperties and allows any properties to be added.
>>
>> Fix this by reverting the approach suggested at v2 review and using
>> simpler definition of "reg" constraints.
>>
>> Link: https://lore.kernel.org/r/20250416180023.GB3327258-robh@xxxxxxxxxx/ [1]
>> Fixes: fc259b024cb3 ("dt-bindings: usb: Add binding for PS5511 hub controller")
>> Cc: <stable@xxxxxxxxxxxxxxx>
>> Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxxxxxxxx>
>> ---
>>  .../devicetree/bindings/usb/parade,ps5511.yaml       | 12 ++++++------
>>  1 file changed, 6 insertions(+), 6 deletions(-)
>>
>> diff --git a/Documentation/devicetree/bindings/usb/parade,ps5511.yaml b/Documentation/devicetree/bindings/usb/parade,ps5511.yaml
>> index 10d002f09db8..154d779e507a 100644
>> --- a/Documentation/devicetree/bindings/usb/parade,ps5511.yaml
>> +++ b/Documentation/devicetree/bindings/usb/parade,ps5511.yaml
>> @@ -15,6 +15,10 @@ properties:
>>        - usb1da0,5511
>>        - usb1da0,55a1
>>  
>> +  reg:
>> +    minimum: 1
>> +    maximum: 5
>> +
> 
> This 'reg' would be the upstream USB port. We have no idea what its 
> constraints are for the value.

Indeed.

> 
>>    reset-gpios:
>>      items:
>>        - description: GPIO specifier for RESETB pin.
>> @@ -41,12 +45,6 @@ properties:
>>              minimum: 1
>>              maximum: 5
>>  
>> -additionalProperties:
>> -  properties:
>> -    reg:
>> -      minimum: 1
>> -      maximum: 5
> 
> Removing this is wrong. This is defining the number of downstream USB 
> ports for this hub.
> 
> What's wrong here is 'type: object' is missing, so any property that's 
> not a object passes (no, 'properties' doesn't imply it's an object).
> 
> We should fix dtschema to allow additionalProperties when not a 
> boolean property to coexist with unevaluatedProperties. I'll look into 
> it.

I see your commit. I will send v2 of this.

Best regards,
Krzysztof