diff mbox series

[1/4] dt-bindings: cache: qcom,llcc: add num-banks property

Message ID 20240903-qcs8300_llcc_driver-v1-1-228659bdf067@quicinc.com
State Changes Requested
Headers show
Series soc: qcom: llcc: Add llcc support for the QCS8300 platform | expand

Commit Message

Jingyi Wang Sept. 3, 2024, 6:21 a.m. UTC
Add a property "num-banks" for errata.

Signed-off-by: Jingyi Wang <quic_jingyw@quicinc.com>
---
 Documentation/devicetree/bindings/cache/qcom,llcc.yaml | 5 +++++
 1 file changed, 5 insertions(+)

Comments

Krzysztof Kozlowski Sept. 3, 2024, 7:10 a.m. UTC | #1
On Tue, Sep 03, 2024 at 02:21:29PM +0800, Jingyi Wang wrote:
> Add a property "num-banks" for errata.

This you said in commit subject and we see in the diff. You *MUST*
explain why.

> 
> Signed-off-by: Jingyi Wang <quic_jingyw@quicinc.com>
> ---
>  Documentation/devicetree/bindings/cache/qcom,llcc.yaml | 5 +++++
>  1 file changed, 5 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
> index 68ea5f70b75f..03241b719c98 100644
> --- a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
> +++ b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
> @@ -56,6 +56,11 @@ properties:
>      items:
>        - const: multi-chan-ddr
>  
> +  num-banks:

No vendor prefix? So this is generic property? Then add to some common
schema with proper explanation WHY.

> +    $ref: /schemas/types.yaml#/definitions/uint32
> +    description:
> +      The num of llcc banks

And what are llcc (or LLCC?) banks?


Best regards,
Krzysztof
Jingyi Wang Sept. 3, 2024, 7:30 a.m. UTC | #2
On 9/3/2024 3:10 PM, Krzysztof Kozlowski wrote:
> On Tue, Sep 03, 2024 at 02:21:29PM +0800, Jingyi Wang wrote:
>> Add a property "num-banks" for errata.
> 
> This you said in commit subject and we see in the diff. You *MUST*
> explain why.
> 
>>
>> Signed-off-by: Jingyi Wang <quic_jingyw@quicinc.com>
>> ---
>>  Documentation/devicetree/bindings/cache/qcom,llcc.yaml | 5 +++++
>>  1 file changed, 5 insertions(+)
>>
>> diff --git a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>> index 68ea5f70b75f..03241b719c98 100644
>> --- a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>> +++ b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>> @@ -56,6 +56,11 @@ properties:
>>      items:
>>        - const: multi-chan-ddr
>>  
>> +  num-banks:
> 
> No vendor prefix? So this is generic property? Then add to some common
> schema with proper explanation WHY.
> 
>> +    $ref: /schemas/types.yaml#/definitions/uint32
>> +    description:
>> +      The num of llcc banks
> 
> And what are llcc (or LLCC?) banks?
> 
> 
Will add the vendor prefix and description in the next series.
> Best regards,
> Krzysztof
> 
Thanks,
Jingyi
Krzysztof Kozlowski Sept. 3, 2024, 8 a.m. UTC | #3
On 03/09/2024 09:30, Jingyi Wang wrote:
> 
> 
> On 9/3/2024 3:10 PM, Krzysztof Kozlowski wrote:
>> On Tue, Sep 03, 2024 at 02:21:29PM +0800, Jingyi Wang wrote:
>>> Add a property "num-banks" for errata.
>>
>> This you said in commit subject and we see in the diff. You *MUST*
>> explain why.
>>
>>>
>>> Signed-off-by: Jingyi Wang <quic_jingyw@quicinc.com>
>>> ---
>>>  Documentation/devicetree/bindings/cache/qcom,llcc.yaml | 5 +++++
>>>  1 file changed, 5 insertions(+)
>>>
>>> diff --git a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>>> index 68ea5f70b75f..03241b719c98 100644
>>> --- a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>>> +++ b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>>> @@ -56,6 +56,11 @@ properties:
>>>      items:
>>>        - const: multi-chan-ddr
>>>  
>>> +  num-banks:
>>
>> No vendor prefix? So this is generic property? Then add to some common
>> schema with proper explanation WHY.
>>
>>> +    $ref: /schemas/types.yaml#/definitions/uint32
>>> +    description:
>>> +      The num of llcc banks
>>
>> And what are llcc (or LLCC?) banks?
>>
>>
> Will add the vendor prefix and description in the next series.

You did not provide rationale nor answer to concerns so far.

Best regards,
Krzysztof
Jingyi Wang Sept. 3, 2024, 8:38 a.m. UTC | #4
On 9/3/2024 4:00 PM, Krzysztof Kozlowski wrote:
> On 03/09/2024 09:30, Jingyi Wang wrote:
>>
>>
>> On 9/3/2024 3:10 PM, Krzysztof Kozlowski wrote:
>>> On Tue, Sep 03, 2024 at 02:21:29PM +0800, Jingyi Wang wrote:
>>>> Add a property "num-banks" for errata.
>>>
>>> This you said in commit subject and we see in the diff. You *MUST*
>>> explain why.
>>>
Usually the num of LLCC banks is read from hardware, but there is errata
on some SoCs to get the wrong bank num from LLCC_COMMON_STATUS0. Add a
property "num-banks" to indicate the accurate data.
>>>>
>>>> Signed-off-by: Jingyi Wang <quic_jingyw@quicinc.com>
>>>> ---
>>>>  Documentation/devicetree/bindings/cache/qcom,llcc.yaml | 5 +++++
>>>>  1 file changed, 5 insertions(+)
>>>>
>>>> diff --git a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>>>> index 68ea5f70b75f..03241b719c98 100644
>>>> --- a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>>>> +++ b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
>>>> @@ -56,6 +56,11 @@ properties:
>>>>      items:
>>>>        - const: multi-chan-ddr
>>>>  
>>>> +  num-banks:
>>>
>>> No vendor prefix? So this is generic property? Then add to some common
>>> schema with proper explanation WHY.
>>>

will qcom,num-banks be okay?

>>>> +    $ref: /schemas/types.yaml#/definitions/uint32
>>>> +    description:
>>>> +      The num of llcc banks
>>>
>>> And what are llcc (or LLCC?) banks?
>>>
>>>

LLCC banks means LLCC register regions with same memory size and reg offset
and different memory base for LLCC configuration.

>> Will add the vendor prefix and description in the next series.
> 
> You did not provide rationale nor answer to concerns so far.
> 
> Best regards,
> Krzysztof
> 
Thanks,
Jingyi
Krzysztof Kozlowski Sept. 3, 2024, 8:56 a.m. UTC | #5
On 03/09/2024 10:38, Jingyi Wang wrote:
> 
> 
> On 9/3/2024 4:00 PM, Krzysztof Kozlowski wrote:
>> On 03/09/2024 09:30, Jingyi Wang wrote:
>>>
>>>
>>> On 9/3/2024 3:10 PM, Krzysztof Kozlowski wrote:
>>>> On Tue, Sep 03, 2024 at 02:21:29PM +0800, Jingyi Wang wrote:
>>>>> Add a property "num-banks" for errata.
>>>>
>>>> This you said in commit subject and we see in the diff. You *MUST*
>>>> explain why.
>>>>
> Usually the num of LLCC banks is read from hardware, but there is errata
> on some SoCs to get the wrong bank num from LLCC_COMMON_STATUS0. Add a
> property "num-banks" to indicate the accurate data.

You have compatible for that. Anyway, your future patch must clearly
explain the problem in details.

Best regards,
Krzysztof
diff mbox series

Patch

diff --git a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
index 68ea5f70b75f..03241b719c98 100644
--- a/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
+++ b/Documentation/devicetree/bindings/cache/qcom,llcc.yaml
@@ -56,6 +56,11 @@  properties:
     items:
       - const: multi-chan-ddr
 
+  num-banks:
+    $ref: /schemas/types.yaml#/definitions/uint32
+    description:
+      The num of llcc banks
+
 required:
   - compatible
   - reg