[EXT] Re: [PATCH v2 1/2] dt-bindings: phy: mxs-usb-phy: convert to DT schema format
Xu Yang
xu.yang_2 at nxp.com
Thu Jun 8 03:30:38 PDT 2023
Hi Stefan,
> -----Original Message-----
> From: Stefan Wahren <stefan.wahren at i2se.com>
> Sent: Thursday, June 8, 2023 3:56 PM
> To: Xu Yang <xu.yang_2 at nxp.com>; robh+dt at kernel.org; krzysztof.kozlowski+dt at linaro.org; conor+dt at kernel.org
> Cc: shawnguo at kernel.org; s.hauer at pengutronix.de; kernel at pengutronix.de; festevam at gmail.com; dl-linux-imx <linux-
> imx at nxp.com>; linux-phy at lists.infradead.org; devicetree at vger.kernel.org; linux-arm-kernel at lists.infradead.org; linux-
> usb at vger.kernel.org; Jun Li <jun.li at nxp.com>
> Subject: [EXT] Re: [PATCH v2 1/2] dt-bindings: phy: mxs-usb-phy: convert to DT schema format
>
> Caution: This is an external email. Please take care when clicking links or opening attachments. When in doubt, report the
> message using the 'Report this email' button
>
>
> Hi Xu,
>
> Am 08.06.23 um 05:36 schrieb Xu Yang:
> > Convert the binding to DT schema format. Besides, this also add other
> > optional properties not contained in txt file.
> >
> > Signed-off-by: Xu Yang <xu.yang_2 at nxp.com>
> >
> > ---
> > Changes in v2:
> > - change filename to fsl,mxs-usbphy.yaml
> > - add other optional properties
> > - narrow fsl,anatop to imx6
> > - use additionalProperties
> > ---
> > .../bindings/phy/fsl,mxs-usbphy.yaml | 128 ++++++++++++++++++
> > .../devicetree/bindings/phy/mxs-usb-phy.txt | 33 -----
> > 2 files changed, 128 insertions(+), 33 deletions(-)
> > create mode 100644 Documentation/devicetree/bindings/phy/fsl,mxs-usbphy.yaml
> > delete mode 100644 Documentation/devicetree/bindings/phy/mxs-usb-phy.txt
> >
> > diff --git a/Documentation/devicetree/bindings/phy/fsl,mxs-usbphy.yaml
> b/Documentation/devicetree/bindings/phy/fsl,mxs-usbphy.yaml
> > new file mode 100644
> > index 000000000000..1b6b19fdf491
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/phy/fsl,mxs-usbphy.yaml
> > @@ -0,0 +1,128 @@
> > +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
> > +%YAML 1.2
> > +---
> > +$id:
> http://devicetree.org/schemas/phy/fsl,mxs-
> usbphy.yaml%23&data=05%7C01%7Cxu.yang_2%40nxp.com%7C5df4d949f975469013b408db67f5d46c%7C686ea1d3bc2b4c
> 6fa92cd99c5c301635%7C0%7C0%7C638218077754788407%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjo
> iV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=8Sz8tK9GVQqE6ywVLpxPB8YDFQvygZvj6s1NjZk
> hbzU%3D&reserved=0
> > +$schema: http://devicetree.org/meta-
> schemas%2Fcore.yaml%23&data=05%7C01%7Cxu.yang_2%40nxp.com%7C5df4d949f975469013b408db67f5d46c%7C686ea1
> d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C638218077754788407%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMD
> AiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&sdata=iaX16VnSJnvU%2F0tcnRgsdnTxMsD89
> 5r4WquGsCFt9Qo%3D&reserved=0
> > +
> > +title: Freescale MXS USB Phy Device
> > +
> > +maintainers:
> > + - Xu Yang <xu.yang_2 at nxp.com>
> > +
> > +properties:
> > + compatible:
> > + oneOf:
> > + - enum:
> > + - fsl,imx23-usbphy
> > + - fsl,vf610-usbphy
> > + - fsl,imx7ulp-usbphy
>
> on the one side the fsl,imx7ulp-usbphy has an individual compatible
>
> > + - items:
> > + - enum:
> > + - fsl,imx28-usbphy
> > + - fsl,imx6ul-usbphy
> > + - fsl,imx6sl-usbphy
> > + - fsl,imx6sx-usbphy
> > + - fsl,imx6q-usbphy
> > + - const: fsl,imx23-usbphy
> > + - items:
> > + - const: fsl,imx6sll-usbphy
> > + - const: fsl,imx6ul-usbphy
> > + - const: fsl,imx23-usbphy
> > + - items:
> > + - const: fsl,imx7ulp-usbphy
> > + - const: fsl,imx6ul-usbphy
>
> on the other side this should be compatible to imx6ul. So at least one
> definition seems to be unnecessary.
>
> Looking at usb/phy/phy-mxs-usb.c suggests me that fsl,imx7ulp-usbphy is
> not directly compatible to fsl,imx6ul-usbphy, because the platform data
> is different. So maybe the using dts* files should be fixed instead?
The imx7ulp and imx6ul only has minor difference. In general, imx7ulp
is compatilbe with imx6ul. We don't need to modify both dts file and
this doc here. So the validation of existing dtb would not fail.
Thanks,
Xu Yang
>
> > + - items:
> > + - const: fsl,imx8dxl-usbphy
> > + - const: fsl,imx7ulp-usbphy
> > +
> > + reg:
> > + minItems: 1
> > + maxItems: 2
> > +
> > + interrupts:
> > + minItems: 1
> > + maxItems: 2
> > +
> > + clocks:
> > + maxItems: 1
> > +
> > + '#phy-cells':
> > + const: 0
> > +
> > + power-domains:
> > + maxItems: 1
> > +
> > + fsl,anatop:
> > + description:
> > + phandle for anatop register, it is only for imx6 SoC series.
> > + $ref: /schemas/types.yaml#/definitions/phandle
> > +
> > + phy-3p0-supply:
> > + description:
> > + One of USB PHY's power supply. Can be used to keep a good signal
> > + quality.
> > +
> > + fsl,tx-cal-45-dn-ohms:
> > + description:
> > + Resistance (in ohms) of switchable high-speed trimming resistor
> > + connected in parallel with the 45 ohm resistor that terminates
> > + the DN output signal.
> > + minimum: 35
> > + maximum: 54
> > + default: 45
> > +
> > + fsl,tx-cal-45-dp-ohms:
> > + description:
> > + Resistance (in ohms) of switchable high-speed trimming resistor
> > + connected in parallel with the 45 ohm resistor that terminates
> > + the DP output signal.
> > + minimum: 35
> > + maximum: 54
> > + default: 45
> > +
> > + fsl,tx-d-cal:
> > + description:
> > + Current trimming value (as a percentage) of the 17.78 mA TX
> > + reference current.
> > + $ref: /schemas/types.yaml#/definitions/uint32
> > + minimum: 79
> > + maximum: 119
> > + default: 100
> > +
> > +required:
> > + - compatible
> > + - reg
> > + - clocks
> > +
> > +allOf:
> > + - if:
> > + properties:
> > + compatible:
> > + oneOf:
> > + - enum:
> > + - fsl,imx6sl-usbphy
> > + - fsl,imx6sx-usbphy
> > + - fsl,imx6sll-usbphy
> > + - fsl,imx6q-usbphy
> > + - fsl,vf610-usbphy
> > + - items:
> > + - const: fsl,imx6ul-usbphy
> > + - const: fsl,imx23-usbphy
> > + then:
> > + required:
> > + - fsl,anatop
> > +
> > +additionalProperties: false
> > +
> > +examples:
> > + - |
> > + #include <dt-bindings/interrupt-controller/arm-gic.h>
> > +
> > + usbphy1: usb-phy at 20c9000 {
> > + compatible = "fsl,imx6q-usbphy", "fsl,imx23-usbphy";
> > + reg = <0x020c9000 0x1000>;
> > + interrupts = <GIC_SPI 44 IRQ_TYPE_LEVEL_HIGH>;
> > + fsl,anatop = <&anatop>;
> > + };
> > +
> > +...
> > diff --git a/Documentation/devicetree/bindings/phy/mxs-usb-phy.txt b/Documentation/devicetree/bindings/phy/mxs-
> usb-phy.txt
> > deleted file mode 100644
> > index 70c813b0755f..000000000000
> > --- a/Documentation/devicetree/bindings/phy/mxs-usb-phy.txt
> > +++ /dev/null
> > @@ -1,33 +0,0 @@
> > -* Freescale MXS USB Phy Device
> > -
> > -Required properties:
> > -- compatible: should contain:
> > - * "fsl,imx23-usbphy" for imx23 and imx28
> > - * "fsl,imx6q-usbphy" for imx6dq and imx6dl
> > - * "fsl,imx6sl-usbphy" for imx6sl
> > - * "fsl,vf610-usbphy" for Vybrid vf610
> > - * "fsl,imx6sx-usbphy" for imx6sx
> > - * "fsl,imx7ulp-usbphy" for imx7ulp
> > - * "fsl,imx8dxl-usbphy" for imx8dxl
> > - "fsl,imx23-usbphy" is still a fallback for other strings
> > -- reg: Should contain registers location and length
> > -- interrupts: Should contain phy interrupt
> > -- fsl,anatop: phandle for anatop register, it is only for imx6 SoC series
> > -
> > -Optional properties:
> > -- fsl,tx-cal-45-dn-ohms: Integer [35-54]. Resistance (in ohms) of switchable
> > - high-speed trimming resistor connected in parallel with the 45 ohm resistor
> > - that terminates the DN output signal. Default: 45
> > -- fsl,tx-cal-45-dp-ohms: Integer [35-54]. Resistance (in ohms) of switchable
> > - high-speed trimming resistor connected in parallel with the 45 ohm resistor
> > - that terminates the DP output signal. Default: 45
> > -- fsl,tx-d-cal: Integer [79-119]. Current trimming value (as a percentage) of
> > - the 17.78mA TX reference current. Default: 100
> > -
> > -Example:
> > -usbphy1: usb-phy at 20c9000 {
> > - compatible = "fsl,imx6q-usbphy", "fsl,imx23-usbphy";
> > - reg = <0x020c9000 0x1000>;
> > - interrupts = <0 44 0x04>;
> > - fsl,anatop = <&anatop>;
> > -};
More information about the linux-phy
mailing list