diff mbox series

[v4,1/3] dt-bindings: net: can: renesas,rcar-canfd: Document RZ/G2L SoC

Message ID 20210727133022.634-2-prabhakar.mahadev-lad.rj@bp.renesas.com
State Accepted
Commit 1aa5a06c0a5dbebd0351ffe5db77c06e9089e4fc
Headers show
Series Renesas RZ/G2L CANFD support | expand

Commit Message

Prabhakar Mahadev Lad July 27, 2021, 1:30 p.m. UTC
Add CANFD binding documentation for Renesas RZ/G2L SoC.

Signed-off-by: Lad Prabhakar <prabhakar.mahadev-lad.rj@bp.renesas.com>
Reviewed-by: Biju Das <biju.das.jz@bp.renesas.com>
Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>
Reviewed-by: Rob Herring <robh@kernel.org>
---
 .../bindings/net/can/renesas,rcar-canfd.yaml  | 69 +++++++++++++++++--
 1 file changed, 63 insertions(+), 6 deletions(-)

Comments

Marc Kleine-Budde Aug. 9, 2021, 1:26 p.m. UTC | #1
On 27.07.2021 14:30:20, Lad Prabhakar wrote:
> Add CANFD binding documentation for Renesas RZ/G2L SoC.

> 

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

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

> Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>

> Reviewed-by: Rob Herring <robh@kernel.org>

> ---

>  .../bindings/net/can/renesas,rcar-canfd.yaml  | 69 +++++++++++++++++--

>  1 file changed, 63 insertions(+), 6 deletions(-)

> 

> diff --git a/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml b/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml

> index 0b33ba9ccb47..546c6e6d2fb0 100644

> --- a/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml

> +++ b/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml

> @@ -30,13 +30,15 @@ properties:

>                - renesas,r8a77995-canfd     # R-Car D3

>            - const: renesas,rcar-gen3-canfd # R-Car Gen3 and RZ/G2

>  

> +      - items:

> +          - enum:

> +              - renesas,r9a07g044-canfd    # RZ/G2{L,LC}

> +          - const: renesas,rzg2l-canfd     # RZ/G2L family

> +

>    reg:

>      maxItems: 1

>  

> -  interrupts:

> -    items:

> -      - description: Channel interrupt

> -      - description: Global interrupt

> +  interrupts: true

>  

>    clocks:

>      maxItems: 3

> @@ -50,8 +52,7 @@ properties:

>    power-domains:

>      maxItems: 1

>  

> -  resets:

> -    maxItems: 1

> +  resets: true

>  

>    renesas,no-can-fd:

>      $ref: /schemas/types.yaml#/definitions/flag

> @@ -91,6 +92,62 @@ required:

>    - channel0

>    - channel1

>  

> +if:

> +  properties:

> +    compatible:

> +      contains:

> +        enum:

> +          - renesas,rzg2l-canfd

> +then:

> +  properties:

> +    interrupts:

> +      items:

> +        - description: CAN global error interrupt

> +        - description: CAN receive FIFO interrupt

> +        - description: CAN0 error interrupt

> +        - description: CAN0 transmit interrupt

> +        - description: CAN0 transmit/receive FIFO receive completion interrupt

> +        - description: CAN1 error interrupt

> +        - description: CAN1 transmit interrupt

> +        - description: CAN1 transmit/receive FIFO receive completion interrupt

> +

> +    interrupt-names:

> +      items:

> +        - const: g_err

> +        - const: g_recc

> +        - const: ch0_err

> +        - const: ch0_rec

> +        - const: ch0_trx

> +        - const: ch1_err

> +        - const: ch1_rec

> +        - const: ch1_trx

> +

> +    resets:

> +      maxItems: 2

> +

> +    reset-names:

> +      items:

> +        - const: rstp_n

> +        - const: rstc_n

> +

> +  required:

> +    - interrupt-names

> +    - reset-names

> +else:

> +  properties:

> +    interrupts:

> +      items:

> +        - description: Channel interrupt

> +        - description: Global interrupt

> +

> +    interrupt-names:

> +      items:

> +        - const: ch_int

> +        - const: g_int


Are you adding the new interrupt-names to the existing DTs, too?
Otherwise this patch will generate more warnings in the existing DTs.

regards,
Marc

-- 
Pengutronix e.K.                 | Marc Kleine-Budde           |
Embedded Linux                   | https://www.pengutronix.de  |
Vertretung West/Dortmund         | Phone: +49-231-2826-924     |
Amtsgericht Hildesheim, HRA 2686 | Fax:   +49-5121-206917-5555 |
Lad, Prabhakar Aug. 9, 2021, 3:48 p.m. UTC | #2
Hi Marc,

On Mon, Aug 9, 2021 at 2:26 PM Marc Kleine-Budde <mkl@pengutronix.de> wrote:
>

> On 27.07.2021 14:30:20, Lad Prabhakar wrote:

> > Add CANFD binding documentation for Renesas RZ/G2L SoC.

> >

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

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

> > Reviewed-by: Geert Uytterhoeven <geert+renesas@glider.be>

> > Reviewed-by: Rob Herring <robh@kernel.org>

> > ---

> >  .../bindings/net/can/renesas,rcar-canfd.yaml  | 69 +++++++++++++++++--

> >  1 file changed, 63 insertions(+), 6 deletions(-)

> >

> > diff --git a/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml b/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml

> > index 0b33ba9ccb47..546c6e6d2fb0 100644

> > --- a/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml

> > +++ b/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml

> > @@ -30,13 +30,15 @@ properties:

> >                - renesas,r8a77995-canfd     # R-Car D3

> >            - const: renesas,rcar-gen3-canfd # R-Car Gen3 and RZ/G2

> >

> > +      - items:

> > +          - enum:

> > +              - renesas,r9a07g044-canfd    # RZ/G2{L,LC}

> > +          - const: renesas,rzg2l-canfd     # RZ/G2L family

> > +

> >    reg:

> >      maxItems: 1

> >

> > -  interrupts:

> > -    items:

> > -      - description: Channel interrupt

> > -      - description: Global interrupt

> > +  interrupts: true

> >

> >    clocks:

> >      maxItems: 3

> > @@ -50,8 +52,7 @@ properties:

> >    power-domains:

> >      maxItems: 1

> >

> > -  resets:

> > -    maxItems: 1

> > +  resets: true

> >

> >    renesas,no-can-fd:

> >      $ref: /schemas/types.yaml#/definitions/flag

> > @@ -91,6 +92,62 @@ required:

> >    - channel0

> >    - channel1

> >

> > +if:

> > +  properties:

> > +    compatible:

> > +      contains:

> > +        enum:

> > +          - renesas,rzg2l-canfd

> > +then:

> > +  properties:

> > +    interrupts:

> > +      items:

> > +        - description: CAN global error interrupt

> > +        - description: CAN receive FIFO interrupt

> > +        - description: CAN0 error interrupt

> > +        - description: CAN0 transmit interrupt

> > +        - description: CAN0 transmit/receive FIFO receive completion interrupt

> > +        - description: CAN1 error interrupt

> > +        - description: CAN1 transmit interrupt

> > +        - description: CAN1 transmit/receive FIFO receive completion interrupt

> > +

> > +    interrupt-names:

> > +      items:

> > +        - const: g_err

> > +        - const: g_recc

> > +        - const: ch0_err

> > +        - const: ch0_rec

> > +        - const: ch0_trx

> > +        - const: ch1_err

> > +        - const: ch1_rec

> > +        - const: ch1_trx

> > +

> > +    resets:

> > +      maxItems: 2

> > +

> > +    reset-names:

> > +      items:

> > +        - const: rstp_n

> > +        - const: rstc_n

> > +

> > +  required:

> > +    - interrupt-names

> > +    - reset-names

> > +else:

> > +  properties:

> > +    interrupts:

> > +      items:

> > +        - description: Channel interrupt

> > +        - description: Global interrupt

> > +

> > +    interrupt-names:

> > +      items:

> > +        - const: ch_int

> > +        - const: g_int

>

> Are you adding the new interrupt-names to the existing DTs, too?

> Otherwise this patch will generate more warnings in the existing DTs.

>

For non RZ/G2L family interrupt-names property is not marked as
required property so dtbs_check won't complain. Once we have added
interrupt names in all the SoC DTSI's we will mark it as required
property for the rest of the SoC's.

Cheers,
Prabhakar

> regards,

> Marc

>

> --

> Pengutronix e.K.                 | Marc Kleine-Budde           |

> Embedded Linux                   | https://www.pengutronix.de  |

> Vertretung West/Dortmund         | Phone: +49-231-2826-924     |

> Amtsgericht Hildesheim, HRA 2686 | Fax:   +49-5121-206917-5555 |
Marc Kleine-Budde Aug. 9, 2021, 6:13 p.m. UTC | #3
On 09.08.2021 16:48:20, Lad, Prabhakar wrote:
> > > +    interrupt-names:

> > > +      items:

> > > +        - const: ch_int

> > > +        - const: g_int

> >

> > Are you adding the new interrupt-names to the existing DTs, too?

> > Otherwise this patch will generate more warnings in the existing DTs.

> >

> For non RZ/G2L family interrupt-names property is not marked as

> required property so dtbs_check won't complain. Once we have added

> interrupt names in all the SoC DTSI's we will mark it as required

> property for the rest of the SoC's.


That makes sense! Thanks for the explanation.

regards,
Marc

-- 
Pengutronix e.K.                 | Marc Kleine-Budde           |
Embedded Linux                   | https://www.pengutronix.de  |
Vertretung West/Dortmund         | Phone: +49-231-2826-924     |
Amtsgericht Hildesheim, HRA 2686 | Fax:   +49-5121-206917-5555 |
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml b/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml
index 0b33ba9ccb47..546c6e6d2fb0 100644
--- a/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml
+++ b/Documentation/devicetree/bindings/net/can/renesas,rcar-canfd.yaml
@@ -30,13 +30,15 @@  properties:
               - renesas,r8a77995-canfd     # R-Car D3
           - const: renesas,rcar-gen3-canfd # R-Car Gen3 and RZ/G2
 
+      - items:
+          - enum:
+              - renesas,r9a07g044-canfd    # RZ/G2{L,LC}
+          - const: renesas,rzg2l-canfd     # RZ/G2L family
+
   reg:
     maxItems: 1
 
-  interrupts:
-    items:
-      - description: Channel interrupt
-      - description: Global interrupt
+  interrupts: true
 
   clocks:
     maxItems: 3
@@ -50,8 +52,7 @@  properties:
   power-domains:
     maxItems: 1
 
-  resets:
-    maxItems: 1
+  resets: true
 
   renesas,no-can-fd:
     $ref: /schemas/types.yaml#/definitions/flag
@@ -91,6 +92,62 @@  required:
   - channel0
   - channel1
 
+if:
+  properties:
+    compatible:
+      contains:
+        enum:
+          - renesas,rzg2l-canfd
+then:
+  properties:
+    interrupts:
+      items:
+        - description: CAN global error interrupt
+        - description: CAN receive FIFO interrupt
+        - description: CAN0 error interrupt
+        - description: CAN0 transmit interrupt
+        - description: CAN0 transmit/receive FIFO receive completion interrupt
+        - description: CAN1 error interrupt
+        - description: CAN1 transmit interrupt
+        - description: CAN1 transmit/receive FIFO receive completion interrupt
+
+    interrupt-names:
+      items:
+        - const: g_err
+        - const: g_recc
+        - const: ch0_err
+        - const: ch0_rec
+        - const: ch0_trx
+        - const: ch1_err
+        - const: ch1_rec
+        - const: ch1_trx
+
+    resets:
+      maxItems: 2
+
+    reset-names:
+      items:
+        - const: rstp_n
+        - const: rstc_n
+
+  required:
+    - interrupt-names
+    - reset-names
+else:
+  properties:
+    interrupts:
+      items:
+        - description: Channel interrupt
+        - description: Global interrupt
+
+    interrupt-names:
+      items:
+        - const: ch_int
+        - const: g_int
+
+    resets:
+      maxItems: 1
+
 unevaluatedProperties: false
 
 examples: