2015-11-16 09:23:16

by huangdaode

[permalink] [raw]
Subject: [PATCH v2 net-next] net: hisilicon: fix binding document of mdio

This patch explains the occasion of "hisilcon,mdio" and
"hisilicon,hns-mdio" according to Arnd's comments.
and reformat it according to comments from Rob<[email protected]>.

chang log:

v2:
1) reformat the style.
2) make it more clearity.

v1:
initial version.

Signed-off-by: huangdaode <[email protected]>
---
Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt | 7 ++++++-
1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
index 9c23fdf..4942d20 100644
--- a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
+++ b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
@@ -1,7 +1,12 @@
Hisilicon MDIO bus controller

Properties:
-- compatible: "hisilicon,mdio","hisilicon,hns-mdio".
+- compatible: can be one of:
+ "hisilicon,hns-mdio"
+ "hisilicon,mdio"
+ "hisilicon,hns-mdio" is recommendly to be used for hip05 and later SOCs,
+ while "hisilicon,mdio" is optional for backwards compatibility, only
+ support for hip04 Soc.
- reg: The base address of the MDIO bus controller register bank.
- #address-cells: Must be <1>.
- #size-cells: Must be <0>. MDIO addresses have no size component.
--
1.9.1


2015-11-16 09:39:58

by Arnd Bergmann

[permalink] [raw]
Subject: Re: [PATCH v2 net-next] net: hisilicon: fix binding document of mdio

On Monday 16 November 2015 17:38:24 huangdaode wrote:
> This patch explains the occasion of "hisilcon,mdio" and
> "hisilicon,hns-mdio" according to Arnd's comments.
> and reformat it according to comments from Rob<[email protected]>.
>
> chang log:
>
> v2:
> 1) reformat the style.
> 2) make it more clearity.
>
> v1:
> initial version.
>
> Signed-off-by: huangdaode <[email protected]>
> ---

The new version looks ok, but your changelog above is formatted
incorrectly. Please put only the contents you want in the git history
above the '---' line and your Signed-off-by, but put the parts that
refer to previous versions of the submission below the ---.

> Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
> index 9c23fdf..4942d20 100644
> --- a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
> +++ b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
> @@ -1,7 +1,12 @@
> Hisilicon MDIO bus controller
>
> Properties:
> -- compatible: "hisilicon,mdio","hisilicon,hns-mdio".
> +- compatible: can be one of:
> + "hisilicon,hns-mdio"
> + "hisilicon,mdio"
> + "hisilicon,hns-mdio" is recommendly to be used for hip05 and later SOCs,
> + while "hisilicon,mdio" is optional for backwards compatibility, only
> + support for hip04 Soc.
> - reg: The base address of the MDIO bus controller register bank.
> - #address-cells: Must be <1>.
> - #size-cells: Must be <0>. MDIO addresses have no size component.
>

2015-11-16 15:20:59

by Rob Herring (Arm)

[permalink] [raw]
Subject: Re: [PATCH v2 net-next] net: hisilicon: fix binding document of mdio

On Mon, Nov 16, 2015 at 05:38:24PM +0800, huangdaode wrote:
> This patch explains the occasion of "hisilcon,mdio" and
> "hisilicon,hns-mdio" according to Arnd's comments.
> and reformat it according to comments from Rob<[email protected]>.
>
> chang log:
>
> v2:
> 1) reformat the style.
> 2) make it more clearity.
>
> v1:
> initial version.
>
> Signed-off-by: huangdaode <[email protected]>
> ---
> Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt | 7 ++++++-
> 1 file changed, 6 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
> index 9c23fdf..4942d20 100644
> --- a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
> +++ b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
> @@ -1,7 +1,12 @@
> Hisilicon MDIO bus controller
>
> Properties:
> -- compatible: "hisilicon,mdio","hisilicon,hns-mdio".
> +- compatible: can be one of:
> + "hisilicon,hns-mdio"
> + "hisilicon,mdio"
> + "hisilicon,hns-mdio" is recommendly to be used for hip05 and later SOCs,

s/recommendly/recommended/

> + while "hisilicon,mdio" is optional for backwards compatibility, only
> + support for hip04 Soc.

...compatibility only on hip04 SOC.

> - reg: The base address of the MDIO bus controller register bank.
> - #address-cells: Must be <1>.
> - #size-cells: Must be <0>. MDIO addresses have no size component.
> --
> 1.9.1
>
> --
> To unsubscribe from this list: send the line "unsubscribe devicetree" in
> the body of a message to [email protected]
> More majordomo info at http://vger.kernel.org/majordomo-info.html

2015-11-18 01:42:31

by huangdaode

[permalink] [raw]
Subject: Re: [PATCH v2 net-next] net: hisilicon: fix binding document of mdio

On 2015/11/16 17:38, Arnd Bergmann wrote:
> On Monday 16 November 2015 17:38:24 huangdaode wrote:
>> This patch explains the occasion of "hisilcon,mdio" and
>> "hisilicon,hns-mdio" according to Arnd's comments.
>> and reformat it according to comments from Rob<[email protected]>.
>>
>> chang log:
>>
>> v2:
>> 1) reformat the style.
>> 2) make it more clearity.
>>
>> v1:
>> initial version.
>>
>> Signed-off-by: huangdaode <[email protected]>
>> ---
> The new version looks ok, but your changelog above is formatted
> incorrectly. Please put only the contents you want in the git history
> above the '---' line and your Signed-off-by, but put the parts that
> refer to previous versions of the submission below the ---.

Got it.
thanks Arnd.

Daode

>> Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt | 7 ++++++-
>> 1 file changed, 6 insertions(+), 1 deletion(-)
>>
>> diff --git a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
>> index 9c23fdf..4942d20 100644
>> --- a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
>> +++ b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
>> @@ -1,7 +1,12 @@
>> Hisilicon MDIO bus controller
>>
>> Properties:
>> -- compatible: "hisilicon,mdio","hisilicon,hns-mdio".
>> +- compatible: can be one of:
>> + "hisilicon,hns-mdio"
>> + "hisilicon,mdio"
>> + "hisilicon,hns-mdio" is recommendly to be used for hip05 and later SOCs,
>> + while "hisilicon,mdio" is optional for backwards compatibility, only
>> + support for hip04 Soc.
>> - reg: The base address of the MDIO bus controller register bank.
>> - #address-cells: Must be <1>.
>> - #size-cells: Must be <0>. MDIO addresses have no size component.
>>
>
> .
>


--
Best Regards
Daode Huang

2015-11-18 01:44:40

by huangdaode

[permalink] [raw]
Subject: Re: [PATCH v2 net-next] net: hisilicon: fix binding document of mdio

On 2015/11/16 23:20, Rob Herring wrote:
> On Mon, Nov 16, 2015 at 05:38:24PM +0800, huangdaode wrote:
>> This patch explains the occasion of "hisilcon,mdio" and
>> "hisilicon,hns-mdio" according to Arnd's comments.
>> and reformat it according to comments from Rob<[email protected]>.
>>
>> chang log:
>>
>> v2:
>> 1) reformat the style.
>> 2) make it more clearity.
>>
>> v1:
>> initial version.
>>
>> Signed-off-by: huangdaode <[email protected]>
>> ---
>> Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt | 7 ++++++-
>> 1 file changed, 6 insertions(+), 1 deletion(-)
>>
>> diff --git a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
>> index 9c23fdf..4942d20 100644
>> --- a/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
>> +++ b/Documentation/devicetree/bindings/net/hisilicon-hns-mdio.txt
>> @@ -1,7 +1,12 @@
>> Hisilicon MDIO bus controller
>>
>> Properties:
>> -- compatible: "hisilicon,mdio","hisilicon,hns-mdio".
>> +- compatible: can be one of:
>> + "hisilicon,hns-mdio"
>> + "hisilicon,mdio"
>> + "hisilicon,hns-mdio" is recommendly to be used for hip05 and later SOCs,
> s/recommendly/recommended/
>
>> + while "hisilicon,mdio" is optional for backwards compatibility, only
>> + support for hip04 Soc.
> ...compatibility only on hip04 SOC.
>
>> - reg: The base address of the MDIO bus controller register bank.
>> - #address-cells: Must be <1>.
>> - #size-cells: Must be <0>. MDIO addresses have no size component.
>> --
>> 1.9.1
>>
>> --
>> To unsubscribe from this list: send the line "unsubscribe devicetree" in
>> the body of a message to [email protected]
>> More majordomo info at http://vger.kernel.org/majordomo-info.html

Agreed.
Will fix this in v3 patch.

thanks
Daode.

> .
>


--
Best Regards
Daode Huang