According to the 'generic-ehci.yaml' schema, the name of the first phy
in an EHCI node must be "usb", however the 'usb@5e000' node in the
'armada-37xx.dtsi' uses "usb2-utmi-host-phy" instead.

This causes dtbs_check warnings like the following ones:

  arch/arm64/boot/dts/marvell/armada-3720-atlas-v5.dtb: usb@5e000 (marvell,armada-3700-ehci): phy-names:0: 'usb' was expected
      from schema $id: http://devicetree.org/schemas/usb/generic-ehci.yaml
  arch/arm64/boot/dts/marvell/armada-3720-db.dtb: usb@5e000 (marvell,armada-3700-ehci): phy-names:0: 'usb' was expected
      from schema $id: http://devicetree.org/schemas/usb/generic-ehci.yaml
  arch/arm64/boot/dts/marvell/armada-3720-eDPU.dtb: usb@5e000 (marvell,armada-3700-ehci): phy-names:0: 'usb' was expected
      from schema $id: http://devicetree.org/schemas/usb/generic-ehci.yaml
  ...

Use "usb" as a name for the phy to avoid the warnings.

No functional change, the USB interface works after the change:

    [    1.472393] orion-ehci d005e000.usb: EHCI Host Controller
    [    1.477847] orion-ehci d005e000.usb: new USB bus registered, assigned bus number 1
    [    1.487127] orion-ehci d005e000.usb: irq 40, io mem 0xd005e000
    [    1.505759] orion-ehci d005e000.usb: USB 2.0 started, EHCI 1.00
    [    1.512493] hub 1-0:1.0: USB hub found
    [    1.516434] hub 1-0:1.0: 1 port detected
    ...
    [    4.175746] usb 1-1: new high-speed USB device number 2 using orion-ehci
    [    4.347643] usb-storage 1-1:1.0: USB Mass Storage device detected
    [    4.359972] scsi host0: usb-storage 1-1:1.0
    [    5.367100] scsi 0:0:0:0: Direct-Access     ADATA    USB Flash Drive  1.00 PQ: 0 ANSI: 6
    [    5.387091] sd 0:0:0:0: [sda] 30869504 512-byte logical blocks: (15.8 GB/14.7 GiB)
    [    5.398420] sd 0:0:0:0: [sda] Write Protect is off
    [    5.408108] sd 0:0:0:0: [sda] Write cache: disabled, read cache: disabled, doesn't support DPO or FUA
    [    5.477359]  sda: sda1
    [    5.480037] sd 0:0:0:0: [sda] Attached SCSI removable disk

Signed-off-by: Gabor Juhos <j4g8y7@gmail.com>
---
 arch/arm64/boot/dts/marvell/armada-37xx.dtsi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/arch/arm64/boot/dts/marvell/armada-37xx.dtsi b/arch/arm64/boot/dts/marvell/armada-37xx.dtsi
index 87f9367aec1227c2c6de52f358d51bcff758c147..a8d10e4de81619c44ccbe0f08e69707dc28005a3 100644
--- a/arch/arm64/boot/dts/marvell/armada-37xx.dtsi
+++ b/arch/arm64/boot/dts/marvell/armada-37xx.dtsi
@@ -396,7 +396,7 @@ usb2: usb@5e000 {
 				marvell,usb-misc-reg = <&usb2_syscon>;
 				interrupts = <GIC_SPI 17 IRQ_TYPE_LEVEL_HIGH>;
 				phys = <&usb2_utmi_host_phy>;
-				phy-names = "usb2-utmi-host-phy";
+				phy-names = "usb";
 				status = "disabled";
 			};
 

---
base-commit: fcaf733ca526b69595ed1d227e2cc59ddd24eff7
change-id: 20260217-armada-37xx-fix-ehci-phy-name-cdfc108b2473

Best regards,
-- 
Gabor Juhos <j4g8y7@gmail.com>

Gabor Juhos <j4g8y7@gmail.com> writes:

> According to the 'generic-ehci.yaml' schema, the name of the first phy
> in an EHCI node must be "usb", however the 'usb@5e000' node in the
> 'armada-37xx.dtsi' uses "usb2-utmi-host-phy" instead.
>
> This causes dtbs_check warnings like the following ones:
>
>   arch/arm64/boot/dts/marvell/armada-3720-atlas-v5.dtb: usb@5e000 (marvell,armada-3700-ehci): phy-names:0: 'usb' was expected
>       from schema $id: http://devicetree.org/schemas/usb/generic-ehci.yaml
>   arch/arm64/boot/dts/marvell/armada-3720-db.dtb: usb@5e000 (marvell,armada-3700-ehci): phy-names:0: 'usb' was expected
>       from schema $id: http://devicetree.org/schemas/usb/generic-ehci.yaml
>   arch/arm64/boot/dts/marvell/armada-3720-eDPU.dtb: usb@5e000 (marvell,armada-3700-ehci): phy-names:0: 'usb' was expected
>       from schema $id: http://devicetree.org/schemas/usb/generic-ehci.yaml
>   ...
>
> Use "usb" as a name for the phy to avoid the warnings.
>
> No functional change, the USB interface works after the change:
>
>     [    1.472393] orion-ehci d005e000.usb: EHCI Host Controller
>     [    1.477847] orion-ehci d005e000.usb: new USB bus registered, assigned bus number 1
>     [    1.487127] orion-ehci d005e000.usb: irq 40, io mem 0xd005e000
>     [    1.505759] orion-ehci d005e000.usb: USB 2.0 started, EHCI 1.00
>     [    1.512493] hub 1-0:1.0: USB hub found
>     [    1.516434] hub 1-0:1.0: 1 port detected
>     ...
>     [    4.175746] usb 1-1: new high-speed USB device number 2 using orion-ehci
>     [    4.347643] usb-storage 1-1:1.0: USB Mass Storage device detected
>     [    4.359972] scsi host0: usb-storage 1-1:1.0
>     [    5.367100] scsi 0:0:0:0: Direct-Access     ADATA    USB Flash Drive  1.00 PQ: 0 ANSI: 6
>     [    5.387091] sd 0:0:0:0: [sda] 30869504 512-byte logical blocks: (15.8 GB/14.7 GiB)
>     [    5.398420] sd 0:0:0:0: [sda] Write Protect is off
>     [    5.408108] sd 0:0:0:0: [sda] Write cache: disabled, read cache: disabled, doesn't support DPO or FUA
>     [    5.477359]  sda: sda1
>     [    5.480037] sd 0:0:0:0: [sda] Attached SCSI removable disk
>
> Signed-off-by: Gabor Juhos <j4g8y7@gmail.com>

Applied on mvebu/dt

Thanks,

Gregory
> ---
>  arch/arm64/boot/dts/marvell/armada-37xx.dtsi | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/arch/arm64/boot/dts/marvell/armada-37xx.dtsi b/arch/arm64/boot/dts/marvell/armada-37xx.dtsi
> index 87f9367aec1227c2c6de52f358d51bcff758c147..a8d10e4de81619c44ccbe0f08e69707dc28005a3 100644
> --- a/arch/arm64/boot/dts/marvell/armada-37xx.dtsi
> +++ b/arch/arm64/boot/dts/marvell/armada-37xx.dtsi
> @@ -396,7 +396,7 @@ usb2: usb@5e000 {
>  				marvell,usb-misc-reg = <&usb2_syscon>;
>  				interrupts = <GIC_SPI 17 IRQ_TYPE_LEVEL_HIGH>;
>  				phys = <&usb2_utmi_host_phy>;
> -				phy-names = "usb2-utmi-host-phy";
> +				phy-names = "usb";
>  				status = "disabled";
>  			};
>  
>
> ---
> base-commit: fcaf733ca526b69595ed1d227e2cc59ddd24eff7
> change-id: 20260217-armada-37xx-fix-ehci-phy-name-cdfc108b2473
>
> Best regards,
> -- 
> Gabor Juhos <j4g8y7@gmail.com>
>

-- 
Grégory CLEMENT, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com