diff mbox series

[v4,1/8] dt-bindings: counter: Add new ti,am62-eqep compatible

Message ID 20240610144637.477954-2-jm@ti.com (mailing list archive)
State New, archived
Headers show
Series Enable eQEP DT support for Sitara K3 platforms | expand

Commit Message

Judith Mendez June 10, 2024, 2:46 p.m. UTC 
Add new compatible ti,am62-eqep for TI K3 devices. If a device
uses this compatible, require power-domains property.

Since there is only one functional and interface clock for eqep,
clock-names is not really required, so removed from required
section, make it optional for ti,am3352-eqep compatible, and
update the example.

The clock-name also changed for TI K3 SoCs so do not allow
clock-names property for the new compatible.

While we are here, add an example using ti,am62-eqep compatible.

Signed-off-by: Judith Mendez <jm@ti.com>
Acked-by: Conor Dooley <conor.dooley@microchip.com>
Reviewed-by: David Lechner <david@lechnology.com>
---
Changes since v3:
- No change
---
 .../devicetree/bindings/counter/ti-eqep.yaml  | 44 ++++++++++++++++---
 1 file changed, 39 insertions(+), 5 deletions(-)

Comments

Krzysztof Kozlowski June 10, 2024, 2:58 p.m. UTC | #1 
On 10/06/2024 16:46, Judith Mendez wrote:
> Add new compatible ti,am62-eqep for TI K3 devices. If a device
> uses this compatible, require power-domains property.
> 
> Since there is only one functional and interface clock for eqep,
> clock-names is not really required, so removed from required
> section, make it optional for ti,am3352-eqep compatible, and
> update the example.
> 

...


>          interrupts = <79>;
>      };
>  
> +  - |
> +    #include <dt-bindings/interrupt-controller/irq.h>
> +    #include <dt-bindings/interrupt-controller/arm-gic.h>
> +    #include <dt-bindings/soc/ti,sci_pm_domain.h>
> +
> +    bus {
> +        #address-cells = <2>;
> +        #size-cells = <2>;
> +        eqep1: counter@23210000 {

No need for label

> +          compatible = "ti,am62-eqep";
> +          reg = <0x00 0x23210000 0x00 0x100>;
> +          power-domains = <&k3_pds 60 TI_SCI_PD_EXCLUSIVE>;
> +          clocks = <&k3_clks 60 0>;
> +          interrupts = <GIC_SPI 117 IRQ_TYPE_EDGE_RISING>;
> +          status = "disabled";

Drop... which also points to another comment - since this was no-op and
example is basically the same, then just don't add it. No point.

> +        };
> +    };
>  ...

Best regards,
Krzysztof
Judith Mendez June 10, 2024, 10:13 p.m. UTC | #2 
Hi Krzysztof,

On 6/10/24 9:58 AM, Krzysztof Kozlowski wrote:
> On 10/06/2024 16:46, Judith Mendez wrote:
>> Add new compatible ti,am62-eqep for TI K3 devices. If a device
>> uses this compatible, require power-domains property.
>>
>> Since there is only one functional and interface clock for eqep,
>> clock-names is not really required, so removed from required
>> section, make it optional for ti,am3352-eqep compatible, and
>> update the example.
>>
> 
> ...
> 
> 
>>           interrupts = <79>;
>>       };
>>   
>> +  - |
>> +    #include <dt-bindings/interrupt-controller/irq.h>
>> +    #include <dt-bindings/interrupt-controller/arm-gic.h>
>> +    #include <dt-bindings/soc/ti,sci_pm_domain.h>
>> +
>> +    bus {
>> +        #address-cells = <2>;
>> +        #size-cells = <2>;
>> +        eqep1: counter@23210000 {
> 
> No need for label
> 
>> +          compatible = "ti,am62-eqep";
>> +          reg = <0x00 0x23210000 0x00 0x100>;
>> +          power-domains = <&k3_pds 60 TI_SCI_PD_EXCLUSIVE>;
>> +          clocks = <&k3_clks 60 0>;
>> +          interrupts = <GIC_SPI 117 IRQ_TYPE_EDGE_RISING>;
>> +          status = "disabled";
> 
> Drop... which also points to another comment - since this was no-op and
> example is basically the same, then just don't add it. No point.

Ok, then I will drop the new example, thanks.

BTW..
In the existing example for ti,am3352-eqep compatible,
do you know if it is appropriate to drop clock-names
from the example if it is no longer required?

~ Judith

> 
>> +        };
>> +    };
>>   ...
> 
> Best regards,
> Krzysztof
>
Krzysztof Kozlowski June 11, 2024, 6:51 a.m. UTC | #3 
On 11/06/2024 00:13, Judith Mendez wrote:
> 
> Hi Krzysztof,
> 
> On 6/10/24 9:58 AM, Krzysztof Kozlowski wrote:
>> On 10/06/2024 16:46, Judith Mendez wrote:
>>> Add new compatible ti,am62-eqep for TI K3 devices. If a device
>>> uses this compatible, require power-domains property.
>>>
>>> Since there is only one functional and interface clock for eqep,
>>> clock-names is not really required, so removed from required
>>> section, make it optional for ti,am3352-eqep compatible, and
>>> update the example.
>>>
>>
>> ...
>>
>>
>>>           interrupts = <79>;
>>>       };
>>>   
>>> +  - |
>>> +    #include <dt-bindings/interrupt-controller/irq.h>
>>> +    #include <dt-bindings/interrupt-controller/arm-gic.h>
>>> +    #include <dt-bindings/soc/ti,sci_pm_domain.h>
>>> +
>>> +    bus {
>>> +        #address-cells = <2>;
>>> +        #size-cells = <2>;
>>> +        eqep1: counter@23210000 {
>>
>> No need for label
>>
>>> +          compatible = "ti,am62-eqep";
>>> +          reg = <0x00 0x23210000 0x00 0x100>;
>>> +          power-domains = <&k3_pds 60 TI_SCI_PD_EXCLUSIVE>;
>>> +          clocks = <&k3_clks 60 0>;
>>> +          interrupts = <GIC_SPI 117 IRQ_TYPE_EDGE_RISING>;
>>> +          status = "disabled";
>>
>> Drop... which also points to another comment - since this was no-op and
>> example is basically the same, then just don't add it. No point.
> 
> Ok, then I will drop the new example, thanks.
> 
> BTW..
> In the existing example for ti,am3352-eqep compatible,
> do you know if it is appropriate to drop clock-names
> from the example if it is no longer required?
> 

It does not really matter.

Best regards,
Krzysztof
Judith Mendez June 11, 2024, 1:52 p.m. UTC | #4 
Hi,

On 6/11/24 1:51 AM, Krzysztof Kozlowski wrote:
> On 11/06/2024 00:13, Judith Mendez wrote:
>>
>> Hi Krzysztof,
>>
>> On 6/10/24 9:58 AM, Krzysztof Kozlowski wrote:
>>> On 10/06/2024 16:46, Judith Mendez wrote:
>>>> Add new compatible ti,am62-eqep for TI K3 devices. If a device
>>>> uses this compatible, require power-domains property.
>>>>
>>>> Since there is only one functional and interface clock for eqep,
>>>> clock-names is not really required, so removed from required
>>>> section, make it optional for ti,am3352-eqep compatible, and
>>>> update the example.
>>>>
>>>
>>> ...
>>>
>>>
>>>>            interrupts = <79>;
>>>>        };
>>>>    
>>>> +  - |
>>>> +    #include <dt-bindings/interrupt-controller/irq.h>
>>>> +    #include <dt-bindings/interrupt-controller/arm-gic.h>
>>>> +    #include <dt-bindings/soc/ti,sci_pm_domain.h>
>>>> +
>>>> +    bus {
>>>> +        #address-cells = <2>;
>>>> +        #size-cells = <2>;
>>>> +        eqep1: counter@23210000 {
>>>
>>> No need for label
>>>
>>>> +          compatible = "ti,am62-eqep";
>>>> +          reg = <0x00 0x23210000 0x00 0x100>;
>>>> +          power-domains = <&k3_pds 60 TI_SCI_PD_EXCLUSIVE>;
>>>> +          clocks = <&k3_clks 60 0>;
>>>> +          interrupts = <GIC_SPI 117 IRQ_TYPE_EDGE_RISING>;
>>>> +          status = "disabled";
>>>
>>> Drop... which also points to another comment - since this was no-op and
>>> example is basically the same, then just don't add it. No point.
>>
>> Ok, then I will drop the new example, thanks.
>>
>> BTW..
>> In the existing example for ti,am3352-eqep compatible,
>> do you know if it is appropriate to drop clock-names
>> from the example if it is no longer required?
>>
> 
> It does not really matter.
> 
Understood, thanks.

> Best regards,
> Krzysztof
>
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/counter/ti-eqep.yaml b/Documentation/devicetree/bindings/counter/ti-eqep.yaml
index 85f1ff83afe72..54611e06064a2 100644
--- a/Documentation/devicetree/bindings/counter/ti-eqep.yaml
+++ b/Documentation/devicetree/bindings/counter/ti-eqep.yaml
@@ -11,7 +11,9 @@  maintainers:
 
 properties:
   compatible:
-    const: ti,am3352-eqep
+    enum:
+      - ti,am3352-eqep
+      - ti,am62-eqep
 
   reg:
     maxItems: 1
@@ -21,19 +23,35 @@  properties:
     maxItems: 1
 
   clocks:
-    description: The clock that determines the SYSCLKOUT rate for the eQEP
-      peripheral.
+    description: The functional and interface clock that determines the clock
+      rate for the eQEP peripheral.
     maxItems: 1
 
   clock-names:
     const: sysclkout
 
+  power-domains:
+    maxItems: 1
+
+allOf:
+  - if:
+      properties:
+        compatible:
+          contains:
+            enum:
+              - ti,am62-eqep
+    then:
+      properties:
+        clock-names: false
+
+      required:
+        - power-domains
+
 required:
   - compatible
   - reg
   - interrupts
   - clocks
-  - clock-names
 
 additionalProperties: false
 
@@ -43,8 +61,24 @@  examples:
         compatible = "ti,am3352-eqep";
         reg = <0x180 0x80>;
         clocks = <&l4ls_gclk>;
-        clock-names = "sysclkout";
         interrupts = <79>;
     };
 
+  - |
+    #include <dt-bindings/interrupt-controller/irq.h>
+    #include <dt-bindings/interrupt-controller/arm-gic.h>
+    #include <dt-bindings/soc/ti,sci_pm_domain.h>
+
+    bus {
+        #address-cells = <2>;
+        #size-cells = <2>;
+        eqep1: counter@23210000 {
+          compatible = "ti,am62-eqep";
+          reg = <0x00 0x23210000 0x00 0x100>;
+          power-domains = <&k3_pds 60 TI_SCI_PD_EXCLUSIVE>;
+          clocks = <&k3_clks 60 0>;
+          interrupts = <GIC_SPI 117 IRQ_TYPE_EDGE_RISING>;
+          status = "disabled";
+        };
+    };
 ...