Re: [PATCH 1/5] dt-bindings: usb: parade,ps8830: Add parade,disable-usb4 property

[Krzysztof Kozlowski]

On Sat, Jul 18, 2026 at 07:06:29PM +0200, Jens Glathe wrote:
> Document a new optional boolean property "parade,disable-usb4".
> When present, the retimer rejects USB4 mode by returning -EOPNOTSUPP,
> forcing a fallback to USB3 + DP Alternate Mode.
> 
> Assisted-by: Grok(xAI):4.3
> Signed-off-by: Jens Glathe <jens.glathe@xxxxxxxxxxxxxxxxxxxxxx>
> ---
>  Documentation/devicetree/bindings/usb/parade,ps8830.yaml | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/usb/parade,ps8830.yaml b/Documentation/devicetree/bindings/usb/parade,ps8830.yaml
> index eaeab1c01a594..44242907461eb 100644
> --- a/Documentation/devicetree/bindings/usb/parade,ps8830.yaml
> +++ b/Documentation/devicetree/bindings/usb/parade,ps8830.yaml
> @@ -66,6 +66,12 @@ properties:
>            Sideband Use (SBU) AUX lines endpoint to the Type-C connector for the purpose of
>            handling altmode muxing and orientation switching.
>  
> +  parade,disable-usb4:
> +    type: boolean
> +    description:
> +      When present, the retimer rejects USB4 mode (returns -EOPNOTSUPP).

You described the desired Linux feature or behavior, not the actual
hardware. The bindings are about the latter, so instead you need to
rephrase the property and its description to match actual hardware
capabilities/features/configuration etc.

> +      This forces the Type-C stack to fall back to USB3 + DP Alternate Mode.
> +
>  required:
>    - compatible
>    - reg
> 
> -- 
> 2.53.0
>