Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-18 Thread Rob Herring
On Wed, May 16, 2018 at 04:32:27PM -0700, risha...@codeaurora.org wrote:
> On 2018-05-16 11:08, Stephen Boyd wrote:
> > Quoting risha...@codeaurora.org (2018-05-16 10:33:14)
> > > On 2018-05-16 10:03, Stephen Boyd wrote:
> > > > Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
> > > 
> > > >> +
> > > >> +- max-slices:
> > > >> +   usage: required
> > > >> +   Value Type: 
> > > >> +   Definition: Number of cache slices supported by hardware
> > > >> +
> > > >> +Example:
> > > >> +
> > > >> +   llcc: qcom,llcc@110 {
> > > >
> > > > cache-controller@110 ?
> > > >
> > > We have tried to use consistent naming convention as in llcc_*
> > > everywhere.
> > > Using cache-controller will mix and match the naming convention.
> > > Also in
> > > the documentation it is explained what llcc is and its full form.
> > > 
> > 
> > DT prefers standard node names as opposed to vendor specific node names.
> > Isn't it a cache controller? I fail to see why this can't be done.
> Hi Stephen,
> The driver is vendor specific and also for uniformity purposes we preferred
> to go with this name.

Almost *every* node and driver is vendor specific. Please do as Stephen 
suggested.

Rob


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-18 Thread Rob Herring
On Wed, May 16, 2018 at 04:32:27PM -0700, risha...@codeaurora.org wrote:
> On 2018-05-16 11:08, Stephen Boyd wrote:
> > Quoting risha...@codeaurora.org (2018-05-16 10:33:14)
> > > On 2018-05-16 10:03, Stephen Boyd wrote:
> > > > Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
> > > 
> > > >> +
> > > >> +- max-slices:
> > > >> +   usage: required
> > > >> +   Value Type: 
> > > >> +   Definition: Number of cache slices supported by hardware
> > > >> +
> > > >> +Example:
> > > >> +
> > > >> +   llcc: qcom,llcc@110 {
> > > >
> > > > cache-controller@110 ?
> > > >
> > > We have tried to use consistent naming convention as in llcc_*
> > > everywhere.
> > > Using cache-controller will mix and match the naming convention.
> > > Also in
> > > the documentation it is explained what llcc is and its full form.
> > > 
> > 
> > DT prefers standard node names as opposed to vendor specific node names.
> > Isn't it a cache controller? I fail to see why this can't be done.
> Hi Stephen,
> The driver is vendor specific and also for uniformity purposes we preferred
> to go with this name.

Almost *every* node and driver is vendor specific. Please do as Stephen 
suggested.

Rob


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread rishabhb

On 2018-05-16 11:08, Stephen Boyd wrote:

Quoting risha...@codeaurora.org (2018-05-16 10:33:14)

On 2018-05-16 10:03, Stephen Boyd wrote:
> Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)

>> +
>> +- max-slices:
>> +   usage: required
>> +   Value Type: 
>> +   Definition: Number of cache slices supported by hardware
>> +
>> +Example:
>> +
>> +   llcc: qcom,llcc@110 {
>
> cache-controller@110 ?
>
We have tried to use consistent naming convention as in llcc_*
everywhere.
Using cache-controller will mix and match the naming convention. Also 
in

the documentation it is explained what llcc is and its full form.



DT prefers standard node names as opposed to vendor specific node 
names.

Isn't it a cache controller? I fail to see why this can't be done.

Hi Stephen,
The driver is vendor specific and also for uniformity purposes we 
preferred

to go with this name.


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread rishabhb

On 2018-05-16 11:08, Stephen Boyd wrote:

Quoting risha...@codeaurora.org (2018-05-16 10:33:14)

On 2018-05-16 10:03, Stephen Boyd wrote:
> Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)

>> +
>> +- max-slices:
>> +   usage: required
>> +   Value Type: 
>> +   Definition: Number of cache slices supported by hardware
>> +
>> +Example:
>> +
>> +   llcc: qcom,llcc@110 {
>
> cache-controller@110 ?
>
We have tried to use consistent naming convention as in llcc_*
everywhere.
Using cache-controller will mix and match the naming convention. Also 
in

the documentation it is explained what llcc is and its full form.



DT prefers standard node names as opposed to vendor specific node 
names.

Isn't it a cache controller? I fail to see why this can't be done.

Hi Stephen,
The driver is vendor specific and also for uniformity purposes we 
preferred

to go with this name.


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread Stephen Boyd
Quoting risha...@codeaurora.org (2018-05-16 10:33:14)
> On 2018-05-16 10:03, Stephen Boyd wrote:
> > Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
> 
> >> +
> >> +- max-slices:
> >> +   usage: required
> >> +   Value Type: 
> >> +   Definition: Number of cache slices supported by hardware
> >> +
> >> +Example:
> >> +
> >> +   llcc: qcom,llcc@110 {
> > 
> > cache-controller@110 ?
> > 
> We have tried to use consistent naming convention as in llcc_* 
> everywhere.
> Using cache-controller will mix and match the naming convention. Also in
> the documentation it is explained what llcc is and its full form.
> 

DT prefers standard node names as opposed to vendor specific node names.
Isn't it a cache controller? I fail to see why this can't be done.


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread Stephen Boyd
Quoting risha...@codeaurora.org (2018-05-16 10:33:14)
> On 2018-05-16 10:03, Stephen Boyd wrote:
> > Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
> 
> >> +
> >> +- max-slices:
> >> +   usage: required
> >> +   Value Type: 
> >> +   Definition: Number of cache slices supported by hardware
> >> +
> >> +Example:
> >> +
> >> +   llcc: qcom,llcc@110 {
> > 
> > cache-controller@110 ?
> > 
> We have tried to use consistent naming convention as in llcc_* 
> everywhere.
> Using cache-controller will mix and match the naming convention. Also in
> the documentation it is explained what llcc is and its full form.
> 

DT prefers standard node names as opposed to vendor specific node names.
Isn't it a cache controller? I fail to see why this can't be done.


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread rishabhb

On 2018-05-16 10:03, Stephen Boyd wrote:

Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
diff --git a/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt 
b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt

new file mode 100644
index 000..a586a17
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt
@@ -0,0 +1,32 @@
+== Introduction==
+
+LLCC (Last Level Cache Controller) provides last level of cache 
memory in SOC,
+that can be shared by multiple clients. Clients here are different 
cores in the
+SOC, the idea is to minimize the local caches at the clients and 
migrate to
+common pool of memory. Cache memory is divided into partitions called 
slices
+which are assigned to clients. Clients can query the slice details, 
activate

+and deactivate them.
+
+Properties:
+- compatible:
+   Usage: required
+   Value type: 
+   Definition: must be "qcom,sdm845-llcc"
+
+- reg:
+   Usage: required
+   Value Type: 
+   Definition: Start address and the range of the LLCC registers.


Start address and size?


Yes i'll change it to Start address and size of the register region.


+
+- max-slices:
+   usage: required
+   Value Type: 
+   Definition: Number of cache slices supported by hardware
+
+Example:
+
+   llcc: qcom,llcc@110 {


cache-controller@110 ?

We have tried to use consistent naming convention as in llcc_* 
everywhere.

Using cache-controller will mix and match the naming convention. Also in
the documentation it is explained what llcc is and its full form.


+   compatible = "qcom,sdm845-llcc";
+   reg = <0x110 0x25>;
+   max-slices = <32>;
+   };
--


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread rishabhb

On 2018-05-16 10:03, Stephen Boyd wrote:

Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
diff --git a/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt 
b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt

new file mode 100644
index 000..a586a17
--- /dev/null
+++ b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt
@@ -0,0 +1,32 @@
+== Introduction==
+
+LLCC (Last Level Cache Controller) provides last level of cache 
memory in SOC,
+that can be shared by multiple clients. Clients here are different 
cores in the
+SOC, the idea is to minimize the local caches at the clients and 
migrate to
+common pool of memory. Cache memory is divided into partitions called 
slices
+which are assigned to clients. Clients can query the slice details, 
activate

+and deactivate them.
+
+Properties:
+- compatible:
+   Usage: required
+   Value type: 
+   Definition: must be "qcom,sdm845-llcc"
+
+- reg:
+   Usage: required
+   Value Type: 
+   Definition: Start address and the range of the LLCC registers.


Start address and size?


Yes i'll change it to Start address and size of the register region.


+
+- max-slices:
+   usage: required
+   Value Type: 
+   Definition: Number of cache slices supported by hardware
+
+Example:
+
+   llcc: qcom,llcc@110 {


cache-controller@110 ?

We have tried to use consistent naming convention as in llcc_* 
everywhere.

Using cache-controller will mix and match the naming convention. Also in
the documentation it is explained what llcc is and its full form.


+   compatible = "qcom,sdm845-llcc";
+   reg = <0x110 0x25>;
+   max-slices = <32>;
+   };
--


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread Stephen Boyd
Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
> diff --git a/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt 
> b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt
> new file mode 100644
> index 000..a586a17
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt
> @@ -0,0 +1,32 @@
> +== Introduction==
> +
> +LLCC (Last Level Cache Controller) provides last level of cache memory in 
> SOC,
> +that can be shared by multiple clients. Clients here are different cores in 
> the
> +SOC, the idea is to minimize the local caches at the clients and migrate to
> +common pool of memory. Cache memory is divided into partitions called slices
> +which are assigned to clients. Clients can query the slice details, activate
> +and deactivate them.
> +
> +Properties:
> +- compatible:
> +   Usage: required
> +   Value type: 
> +   Definition: must be "qcom,sdm845-llcc"
> +
> +- reg:
> +   Usage: required
> +   Value Type: 
> +   Definition: Start address and the range of the LLCC registers.

Start address and size?

> +
> +- max-slices:
> +   usage: required
> +   Value Type: 
> +   Definition: Number of cache slices supported by hardware
> +
> +Example:
> +
> +   llcc: qcom,llcc@110 {

cache-controller@110 ?

> +   compatible = "qcom,sdm845-llcc";
> +   reg = <0x110 0x25>;
> +   max-slices = <32>;
> +   };
> -- 


Re: [PATCH v6 1/2] dt-bindings: Documentation for qcom, llcc

2018-05-16 Thread Stephen Boyd
Quoting Rishabh Bhatnagar (2018-05-08 13:22:00)
> diff --git a/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt 
> b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt
> new file mode 100644
> index 000..a586a17
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/arm/msm/qcom,llcc.txt
> @@ -0,0 +1,32 @@
> +== Introduction==
> +
> +LLCC (Last Level Cache Controller) provides last level of cache memory in 
> SOC,
> +that can be shared by multiple clients. Clients here are different cores in 
> the
> +SOC, the idea is to minimize the local caches at the clients and migrate to
> +common pool of memory. Cache memory is divided into partitions called slices
> +which are assigned to clients. Clients can query the slice details, activate
> +and deactivate them.
> +
> +Properties:
> +- compatible:
> +   Usage: required
> +   Value type: 
> +   Definition: must be "qcom,sdm845-llcc"
> +
> +- reg:
> +   Usage: required
> +   Value Type: 
> +   Definition: Start address and the range of the LLCC registers.

Start address and size?

> +
> +- max-slices:
> +   usage: required
> +   Value Type: 
> +   Definition: Number of cache slices supported by hardware
> +
> +Example:
> +
> +   llcc: qcom,llcc@110 {

cache-controller@110 ?

> +   compatible = "qcom,sdm845-llcc";
> +   reg = <0x110 0x25>;
> +   max-slices = <32>;
> +   };
> --