[PATCH v3 2/2] dt-bindings: soc: ti: pruss: Add documentation for PA_STATS support

[MD Danish Anwar]

On 27/06/24 8:15 pm, Nishanth Menon wrote:
> On 21:03-20240625, MD Danish Anwar wrote:
>> Add documentation for pa-stats node which is syscon regmap for
>> PA_STATS registers. This will be used to dump statistics maintained by
>> ICSSG firmware.
>>
>> Reviewed-by: Krzysztof Kozlowski <krzysztof.kozlowski at linaro.org>
>> Signed-off-by: MD Danish Anwar <danishanwar at ti.com>
>> ---
>>  .../devicetree/bindings/soc/ti/ti,pruss.yaml  | 20 +++++++++++++++++++
>>  1 file changed, 20 insertions(+)
>>
>> diff --git a/Documentation/devicetree/bindings/soc/ti/ti,pruss.yaml b/Documentation/devicetree/bindings/soc/ti/ti,pruss.yaml
>> index c402cb2928e8..3cb1471cc6b6 100644
>> --- a/Documentation/devicetree/bindings/soc/ti/ti,pruss.yaml
>> +++ b/Documentation/devicetree/bindings/soc/ti/ti,pruss.yaml
>> @@ -278,6 +278,26 @@ patternProperties:
>>  
>>      additionalProperties: false
>>  
>> +  ^pa-stats@[a-f0-9]+$:
>> +    description: |
>> +      PA-STATS sub-module represented as a SysCon. PA_STATS is a set of
>> +      registers where different statistics related to ICSSG, are dumped by
>> +      ICSSG firmware. This syscon sub-module will help the device to
>> +      access/read/write those statistics.
>> +
>> +    type: object
>> +
>> +    additionalProperties: false
>> +
>> +    properties:
>> +      compatible:
>> +        items:
>> +          - const: ti,pruss-pa-st
>> +          - const: syscon
>> +
>> +      reg:
>> +        maxItems: 1
>> +
> 
> Is this a patch in a driver series? I do not see the driver part..

No Nishant, this is not a part of driver series. This binding patch is
related to [1] which is merged to net-next. The regmap will not be used
by drivers/soc/ti driver instead once both binding are in, the driver
changes will be needed in drivers/net/ethernet/ti/icssg/icssg_prueth.c
as there is no driver changes needed in drivers/soc/ti, I posted this
patch as stand alone. Considering this binding and [1] they both go to
different tree, I decided to get the bindings in first and in next
kernel cycle when they both are part of mainline linux, I can post the
driver changes.

> if this is a memory map, why doesn't bus model work?
> 

I am just trying to maintain consistency here. pa-stats sub-module is
similar to mii-g-rt and mii-rt. I am adding pa-stats in the same way as
mii-g-rt and mii-rt.

All these three modules are eventually mapping a memory region so that
the icssg driver can use them and read / configure registers.

> 
>>    interrupt-controller@[a-f0-9]+$:
>>      description: |
>>        PRUSS INTC Node. Each PRUSS has a single interrupt controller instance
>> -- 
>> 2.34.1
>>
> 

[1] https://lore.kernel.org/all/20240529115225.630535-1-danishanwar@ti.com/

-- 
Thanks and Regards,
Danish