[PATCH v2 3/6] dt: bindings: add bindings for msa memory region

[PATCH v2 3/6] dt: bindings: add bindings for msa memory region

[Govind Singh]

Add device tree binding documentation details of msa
memory region for ath10k qmi client for SDM845/APQ8098
SoC into "qcom,ath10k.txt".

Signed-off-by: Govind Singh <govinds-sgV2jX0FEOL9JmXXK+q4OQ@public.gmane.org>
---
 .../devicetree/bindings/net/wireless/qcom,ath10k.txt          | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
index 7fd4e8ce4149..0efc47f4ba34 100644
--- a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
+++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
@@ -56,6 +56,8 @@ Optional properties:
 				     the length can vary between hw versions.
 - <supply-name>-supply: handle to the regulator device tree node
 			   optional "supply-name" is "vdd-0.8-cx-mx".
+- msa-fixed-region: phandle, specifier to children of reserved MSA memory.
+- msa-size: MSA memory size for fw internal use.
 
 Example (to supply the calibration data alone):
 
@@ -133,6 +135,8 @@ wifi@18000000 {
 		compatible = "qcom,wcn3990-wifi";
 		reg = <0x18800000 0x800000>;
 		reg-names = "membase";
+		msa-fixed-region = <&wlan_msa_mem>;
+		msa-size = <0x100000>;
 		clocks = <&clock_gcc clk_aggre2_noc_clk>;
 		clock-names = "smmu_aggre2_noc_clk"
 		interrupts =
-- 
2.17.0

Re: [PATCH v2 3/6] dt: bindings: add bindings for msa memory region

[Brian Norris]

+ Rob

On Tue, Jun 05, 2018 at 06:06:16PM +0530, Govind Singh wrote:
> Add device tree binding documentation details of msa
> memory region for ath10k qmi client for SDM845/APQ8098
> SoC into "qcom,ath10k.txt".
> 
> Signed-off-by: Govind Singh <govinds-sgV2jX0FEOL9JmXXK+q4OQ@public.gmane.org>
> ---
>  .../devicetree/bindings/net/wireless/qcom,ath10k.txt          | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
> index 7fd4e8ce4149..0efc47f4ba34 100644
> --- a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
> +++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
> @@ -56,6 +56,8 @@ Optional properties:
>  				     the length can vary between hw versions.
>  - <supply-name>-supply: handle to the regulator device tree node
>  			   optional "supply-name" is "vdd-0.8-cx-mx".
> +- msa-fixed-region: phandle, specifier to children of reserved MSA memory.

As in reserved-memory/reserved-memory.txt? Might refer to that doc here.
Or is this some other kind of reserved memory?

If the former, it's normally called just "memory-region", although
that does seem somewhat non-descriptive...

> +- msa-size: MSA memory size for fw internal use.

Do you really need both of these? It seems like your code uses one or
the other, not both. In which case, this is not a very good description,
because it sounds like they would go together.

Also, if you're not using standard/generic properties (e.g., the
aforementioned "memory-region" binding), you typically should use a
vendor prefix, like "qcom,msa-size".

Brian

>  
>  Example (to supply the calibration data alone):
>  
> @@ -133,6 +135,8 @@ wifi@18000000 {
>  		compatible = "qcom,wcn3990-wifi";
>  		reg = <0x18800000 0x800000>;
>  		reg-names = "membase";
> +		msa-fixed-region = <&wlan_msa_mem>;
> +		msa-size = <0x100000>;
>  		clocks = <&clock_gcc clk_aggre2_noc_clk>;
>  		clock-names = "smmu_aggre2_noc_clk"
>  		interrupts =
> -- 
> 2.17.0
> 

Re: [PATCH v2 3/6] dt: bindings: add bindings for msa memory region

[Kalle Valo]

Brian Norris <briannorris-F7+t8E8rja9g9hUCZPvPmw@public.gmane.org> writes:

> + Rob
>
> On Tue, Jun 05, 2018 at 06:06:16PM +0530, Govind Singh wrote:
>> Add device tree binding documentation details of msa
>> memory region for ath10k qmi client for SDM845/APQ8098
>> SoC into "qcom,ath10k.txt".
>> 
>> Signed-off-by: Govind Singh <govinds-sgV2jX0FEOL9JmXXK+q4OQ@public.gmane.org>
>> ---
>>  .../devicetree/bindings/net/wireless/qcom,ath10k.txt          | 4 ++++
>>  1 file changed, 4 insertions(+)
>> 
>> diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
>> index 7fd4e8ce4149..0efc47f4ba34 100644
>> --- a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
>> +++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
>> @@ -56,6 +56,8 @@ Optional properties:
>>  				     the length can vary between hw versions.
>>  - <supply-name>-supply: handle to the regulator device tree node
>>  			   optional "supply-name" is "vdd-0.8-cx-mx".
>> +- msa-fixed-region: phandle, specifier to children of reserved MSA memory.
>
> As in reserved-memory/reserved-memory.txt? Might refer to that doc here.
> Or is this some other kind of reserved memory?
>
> If the former, it's normally called just "memory-region", although
> that does seem somewhat non-descriptive...
>
>> +- msa-size: MSA memory size for fw internal use.
>
> Do you really need both of these? It seems like your code uses one or
> the other, not both. In which case, this is not a very good description,
> because it sounds like they would go together.
>
> Also, if you're not using standard/generic properties (e.g., the
> aforementioned "memory-region" binding), you typically should use a
> vendor prefix, like "qcom,msa-size".

Devicetree folks, any comments? I would like to apply this via my
ath.git tree but need help with the review.

Full patch here:

https://patchwork.kernel.org/patch/10448169/

-- 
Kalle Valo

Re: [PATCH v2 3/6] dt: bindings: add bindings for msa memory region

[Mark Rutland]

On Tue, Jul 03, 2018 at 06:42:24PM +0300, Kalle Valo wrote:
> Brian Norris <briannorris-F7+t8E8rja9g9hUCZPvPmw@public.gmane.org> writes:
> 
> > + Rob
> >
> > On Tue, Jun 05, 2018 at 06:06:16PM +0530, Govind Singh wrote:
> >> Add device tree binding documentation details of msa
> >> memory region for ath10k qmi client for SDM845/APQ8098
> >> SoC into "qcom,ath10k.txt".
> >> 
> >> Signed-off-by: Govind Singh <govinds-sgV2jX0FEOL9JmXXK+q4OQ@public.gmane.org>
> >> ---
> >>  .../devicetree/bindings/net/wireless/qcom,ath10k.txt          | 4 ++++
> >>  1 file changed, 4 insertions(+)
> >> 
> >> diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
> >> index 7fd4e8ce4149..0efc47f4ba34 100644
> >> --- a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
> >> +++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
> >> @@ -56,6 +56,8 @@ Optional properties:
> >>  				     the length can vary between hw versions.
> >>  - <supply-name>-supply: handle to the regulator device tree node
> >>  			   optional "supply-name" is "vdd-0.8-cx-mx".
> >> +- msa-fixed-region: phandle, specifier to children of reserved MSA memory.
> >
> > As in reserved-memory/reserved-memory.txt? Might refer to that doc here.
> > Or is this some other kind of reserved memory?
> >
> > If the former, it's normally called just "memory-region", although
> > that does seem somewhat non-descriptive...
> >
> >> +- msa-size: MSA memory size for fw internal use.
> >
> > Do you really need both of these? It seems like your code uses one or
> > the other, not both. In which case, this is not a very good description,
> > because it sounds like they would go together.
> >
> > Also, if you're not using standard/generic properties (e.g., the
> > aforementioned "memory-region" binding), you typically should use a
> > vendor prefix, like "qcom,msa-size".
> 
> Devicetree folks, any comments? I would like to apply this via my
> ath.git tree but need help with the review.

I think Brian's comments w.r.t msa-size and msa-fixed-region both stand.
It would be good if Govind could answer his questions.

Thanks,
Mark.

Re: [PATCH v2 3/6] dt: bindings: add bindings for msa memory region

[Govind Singh]

On 2018-07-03 21:31, Mark Rutland wrote:
> On Tue, Jul 03, 2018 at 06:42:24PM +0300, Kalle Valo wrote:
>> Brian Norris <briannorris-F7+t8E8rja9g9hUCZPvPmw@public.gmane.org> writes:
>> 
>> > + Rob
>> >
>> > On Tue, Jun 05, 2018 at 06:06:16PM +0530, Govind Singh wrote:
>> >> Add device tree binding documentation details of msa
>> >> memory region for ath10k qmi client for SDM845/APQ8098
>> >> SoC into "qcom,ath10k.txt".
>> >>
>> >> Signed-off-by: Govind Singh <govinds-sgV2jX0FEOL9JmXXK+q4OQ@public.gmane.org>
>> >> ---
>> >>  .../devicetree/bindings/net/wireless/qcom,ath10k.txt          | 4 ++++
>> >>  1 file changed, 4 insertions(+)
>> >>
>> >> diff --git a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
>> >> index 7fd4e8ce4149..0efc47f4ba34 100644
>> >> --- a/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
>> >> +++ b/Documentation/devicetree/bindings/net/wireless/qcom,ath10k.txt
>> >> @@ -56,6 +56,8 @@ Optional properties:
>> >>  				     the length can vary between hw versions.
>> >>  - <supply-name>-supply: handle to the regulator device tree node
>> >>  			   optional "supply-name" is "vdd-0.8-cx-mx".
>> >> +- msa-fixed-region: phandle, specifier to children of reserved MSA memory.
>> >
>> > As in reserved-memory/reserved-memory.txt? Might refer to that doc here.
>> > Or is this some other kind of reserved memory?
>> >

sure, i will give reference to reserved-memory.txt.

>> > If the former, it's normally called just "memory-region", although
>> > that does seem somewhat non-descriptive...
>> >
>> >> +- msa-size: MSA memory size for fw internal use.
>> >
>> > Do you really need both of these? It seems like your code uses one or
>> > the other, not both. In which case, this is not a very good description,
>> > because it sounds like they would go together.
>> >
>> > Also, if you're not using standard/generic properties (e.g., the
>> > aforementioned "memory-region" binding), you typically should use a
>> > vendor prefix, like "qcom,msa-size".
>> 
>> Devicetree folks, any comments? I would like to apply this via my
>> ath.git tree but need help with the review.
> 
> I think Brian's comments w.r.t msa-size and msa-fixed-region both 
> stand.
> It would be good if Govind could answer his questions.
> 

As Brian suggested, i am planing to remove msa-size and keep only 
msa-fixed-region.


Thanks
Govind