Re: [PATCH 1/3] dt-bindings: usb: snps,dwc3: document usb-psy-name

[Krzysztof Kozlowski]

On Tue, Oct 13, 2026 at 06:29:25PM +0800, Qianhui Xu wrote:
> From: Xu Qianhui <xiaqinghuan@xxxxxxxxxxxxxxxx>
> 
> The dwc3 driver looks up "usb-psy-name" to find the power supply which
> accepts the input current limit requested by the gadget after USB

It does it for ACPI, no?

> configuration, and while the bus is suspended or resumed
> (dwc3_vbus_draw_work()), but the property is not described by any
> binding:
> 
>   $ git grep -n usb-psy-name -- Documentation/
>   (no match)
> 
> As a result, any DTS using it fails dtbs_check.  The property is read

No. Just run:

git grep usb-psy-name

There is no isngle usage of it.

> from the DWC3 device node, which for the single-node flavours (e.g.
> qcom,snps-dwc3.yaml) is the node that $refs this file, so document it
> here.
> 
> Signed-off-by: Xu Qianhui <xiaqinghuan@xxxxxxxxxxxxxxxx>
> ---
>  .../devicetree/bindings/usb/snps,dwc3-common.yaml          | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/usb/snps,dwc3-common.yaml b/Documentation/devicetree/bindings/usb/snps,dwc3-common.yaml
> index 6c0b8b6538..6609a709c1 100644
> --- a/Documentation/devicetree/bindings/usb/snps,dwc3-common.yaml
> +++ b/Documentation/devicetree/bindings/usb/snps,dwc3-common.yaml
> @@ -51,6 +51,13 @@ properties:
>        - items:
>            pattern: "^usb(2-([0-9]|1[0-4])|3-[0-3])$"
>  
> +  usb-psy-name:
> +    description:
> +      Name of the USB power supply accepting the input current limit
> +      requested by the gadget after USB configuration, and during bus
> +      suspend and resume.

Power supplies are not referenced by names, but phandles.

Best regards,
Krzysztof