diff mbox series

[v3,07/11] dt-bindings: phy: renesas,usb2-phy: Document RZ/G2L phy bindings

Message ID 20210630073013.22415-8-biju.das.jz@bp.renesas.com
State New
Headers show
Series Add USB2.0 support | expand

Commit Message

Biju Das June 30, 2021, 7:30 a.m. UTC
Document USB phy bindings for RZ/G2L SoC.

RZ/G2L USB2.0 phy uses line ctrl register for OTG_ID pin changes. Apart
from this it uses a different OTG-BC interrupt bit for device recognition.

Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>
Reviewed-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
---
v2->v3
 * Created a new compatible for RZ/G2L as per Geert's suggestion.
 * Added resets required properties for RZ/G2L SoC.
---
 .../bindings/phy/renesas,usb2-phy.yaml         | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

Comments

Rob Herring July 14, 2021, 9:21 p.m. UTC | #1
On Wed, Jun 30, 2021 at 11:29:36AM +0200, Geert Uytterhoeven wrote:
> Hi Biju,

> 

> Thanks for your patch!

> 

> On Wed, Jun 30, 2021 at 9:31 AM Biju Das <biju.das.jz@bp.renesas.com> wrote:

> > Document USB phy bindings for RZ/G2L SoC.

> >

> > RZ/G2L USB2.0 phy uses line ctrl register for OTG_ID pin changes. Apart

> > from this it uses a different OTG-BC interrupt bit for device recognition.

> 

> Nothing about resets? But see below...

> 

> >

> > Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>

> > Reviewed-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>

> > ---

> > v2->v3

> >  * Created a new compatible for RZ/G2L as per Geert's suggestion.

> >  * Added resets required properties for RZ/G2L SoC.

> > ---

> >  .../bindings/phy/renesas,usb2-phy.yaml         | 18 ++++++++++++++++++

> >  1 file changed, 18 insertions(+)

> >

> > diff --git a/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml b/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

> > index d5dc5a3cdceb..a7e585ff28dc 100644

> > --- a/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

> > +++ b/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

> > @@ -30,6 +30,9 @@ properties:

> >                - renesas,usb2-phy-r8a77995 # R-Car D3

> >            - const: renesas,rcar-gen3-usb2-phy

> >

> > +      - items:

> > +          - const: renesas,usb2-phy-r9a07g044 # RZ/G2{L,LC}

> > +

> >    reg:

> >      maxItems: 1

> >

> > @@ -91,6 +94,21 @@ required:

> >    - clocks

> >    - '#phy-cells'

> >

> > +allOf:

> > +  - if:

> > +      properties:

> > +        compatible:

> > +          contains:

> > +            const: renesas,usb2-phy-r9a07g044

> > +    then:

> > +      properties:

> > +        resets:

> > +          items:

> > +            - description: USB phy reset

> > +            - description: reset of USB 2.0 host side

> 

> Do you need the second reset?

> Looking at your .dtsi patch, the second reset is shared with ehci/ohci,

> so perhaps it makes sense to drop it from the phy node?


The existing binding has the host reset (and peripheral, but no phy 
reset). Was that a mistake too? Smells like collecting resources the 
driver happens to want, not what the h/w connections are.

Rob
Biju Das July 18, 2021, 8:29 a.m. UTC | #2
Hi Rob,

> -----Original Message-----

> Subject: Re: [PATCH v3 07/11] dt-bindings: phy: renesas,usb2-phy: Document

> RZ/G2L phy bindings

> 

> On Wed, Jun 30, 2021 at 11:29:36AM +0200, Geert Uytterhoeven wrote:

> > Hi Biju,

> >

> > Thanks for your patch!

> >

> > On Wed, Jun 30, 2021 at 9:31 AM Biju Das <biju.das.jz@bp.renesas.com>

> wrote:

> > > Document USB phy bindings for RZ/G2L SoC.

> > >

> > > RZ/G2L USB2.0 phy uses line ctrl register for OTG_ID pin changes.

> > > Apart from this it uses a different OTG-BC interrupt bit for device

> recognition.

> >

> > Nothing about resets? But see below...

> >

> > >

> > > Signed-off-by: Biju Das <biju.das.jz@bp.renesas.com>

> > > Reviewed-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>

> > > ---

> > > v2->v3

> > >  * Created a new compatible for RZ/G2L as per Geert's suggestion.

> > >  * Added resets required properties for RZ/G2L SoC.

> > > ---

> > >  .../bindings/phy/renesas,usb2-phy.yaml         | 18

> ++++++++++++++++++

> > >  1 file changed, 18 insertions(+)

> > >

> > > diff --git

> > > a/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

> > > b/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

> > > index d5dc5a3cdceb..a7e585ff28dc 100644

> > > --- a/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

> > > +++ b/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml

> > > @@ -30,6 +30,9 @@ properties:

> > >                - renesas,usb2-phy-r8a77995 # R-Car D3

> > >            - const: renesas,rcar-gen3-usb2-phy

> > >

> > > +      - items:

> > > +          - const: renesas,usb2-phy-r9a07g044 # RZ/G2{L,LC}

> > > +

> > >    reg:

> > >      maxItems: 1

> > >

> > > @@ -91,6 +94,21 @@ required:

> > >    - clocks

> > >    - '#phy-cells'

> > >

> > > +allOf:

> > > +  - if:

> > > +      properties:

> > > +        compatible:

> > > +          contains:

> > > +            const: renesas,usb2-phy-r9a07g044

> > > +    then:

> > > +      properties:

> > > +        resets:

> > > +          items:

> > > +            - description: USB phy reset

> > > +            - description: reset of USB 2.0 host side

> >

> > Do you need the second reset?

> > Looking at your .dtsi patch, the second reset is shared with

> > ehci/ohci, so perhaps it makes sense to drop it from the phy node?

> 

> The existing binding has the host reset (and peripheral, but no phy

> reset). Was that a mistake too? Smells like collecting resources the

> driver happens to want, not what the h/w connections are.


On that SoC's there is no USBPHY control IP to control the reset. But PHY
is part of either host block or peripheral block. On RZ/G2L as well PHY is
part of Host block but we have dedicated IP to control the reset.

Regards,
Biju
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml b/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml
index d5dc5a3cdceb..a7e585ff28dc 100644
--- a/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml
+++ b/Documentation/devicetree/bindings/phy/renesas,usb2-phy.yaml
@@ -30,6 +30,9 @@  properties:
               - renesas,usb2-phy-r8a77995 # R-Car D3
           - const: renesas,rcar-gen3-usb2-phy
 
+      - items:
+          - const: renesas,usb2-phy-r9a07g044 # RZ/G2{L,LC}
+
   reg:
     maxItems: 1
 
@@ -91,6 +94,21 @@  required:
   - clocks
   - '#phy-cells'
 
+allOf:
+  - if:
+      properties:
+        compatible:
+          contains:
+            const: renesas,usb2-phy-r9a07g044
+    then:
+      properties:
+        resets:
+          items:
+            - description: USB phy reset
+            - description: reset of USB 2.0 host side
+      required:
+        - resets
+
 additionalProperties: false
 
 examples: