Re: [PATCH v9 2/6] arm64: hi6220: Document devicetree bindings for Hisilicon hi6220 SoC

2015-06-04 Thread Bintian

On 2015/6/4 12:36, Rob Herring wrote:

On Fri, May 29, 2015 at 8:50 PM, Bintian Wang  wrote:

This patch adds documentation for the devicetree bindings used by the
DT files of Hisilicon hi6220 SoC mobile platform.

Signed-off-by: Bintian Wang 
Suggested-by: Arnd Bergmann 
Acked-by: Haojian Zhuang 
Acked-by: Stephen Boyd 


Acked-by: Rob Herring 

One minor comment below.

Thank you Rob, I will fix in version 10.

BR,

Bintian


---
  .../bindings/arm/hisilicon/hisilicon.txt   |   87 
  1 file changed, 87 insertions(+)

diff --git a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt 
b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
index 35b1bd4..f67d0f3 100644
--- a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
+++ b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
@@ -1,5 +1,8 @@
  Hisilicon Platforms Device Tree Bindings
  
+Hi6220 SoC
+Required root node properties:
+   - compatible = "hisilicon,hi6220";

  Hi4511 Board
  Required root node properties:
@@ -13,6 +16,9 @@ HiP01 ca9x2 Board
  Required root node properties:
 - compatible = "hisilicon,hip01-ca9x2";

+HiKey Board
+Required root node properties:
+   - compatible = "hisilicon,hi6220-hikey", "hisilicon,hi6220";

  Hisilicon system controller

@@ -41,6 +47,87 @@ Example:
 };

  ---
+Hisilicon Hi6220 system controller
+
+Required properties:
+- compatible : "hisilicon,hi6220-sysctrl"
+- reg : Register address and size
+- #clock-cells: should be set to 1, many clock registers are defined
+  under this controller and this property must be present.
+
+Hisilicon designs this controller as one of the system controllers,
+its main functions are the same as Hisilicon system controller, but
+the register offset of some core modules are different.
+
+Example:
+   /*for Hi6220*/
+   sys_ctrl: sys_ctrl {


You should have the unit address in the name here. Same with the
follow examples.


+   compatible = "hisilicon,hi6220-sysctrl", "syscon";
+   reg = <0x0 0xf703 0x0 0x2000>;
+   #clock-cells = <1>;
+   };
+
+
+Hisilicon Hi6220 Power Always ON domain controller
+
+Required properties:
+- compatible : "hisilicon,hi6220-aoctrl"
+- reg : Register address and size
+- #clock-cells: should be set to 1, many clock registers are defined
+  under this controller and this property must be present.
+
+Hisilicon designs this system controller to control the power always
+on domain for mobile platform.
+
+Example:
+   /*for Hi6220*/
+   ao_ctrl: ao_ctrl {
+   compatible = "hisilicon,hi6220-aoctrl", "syscon";
+   reg = <0x0 0xf780 0x0 0x2000>;
+   #clock-cells = <1>;
+   };
+
+
+Hisilicon Hi6220 Media domain controller
+
+Required properties:
+- compatible : "hisilicon,hi6220-mediactrl"
+- reg : Register address and size
+- #clock-cells: should be set to 1, many clock registers are defined
+  under this controller and this property must be present.
+
+Hisilicon designs this system controller to control the multimedia
+domain(e.g. codec, G3D ...) for mobile platform.
+
+Example:
+   /*for Hi6220*/
+   media_ctrl: media_ctrl {
+   compatible = "hisilicon,hi6220-mediactrl", "syscon";
+   reg = <0x0 0xf441 0x0 0x1000>;
+   #clock-cells = <1>;
+   };
+
+
+Hisilicon Hi6220 Power Management domain controller
+
+Required properties:
+- compatible : "hisilicon,hi6220-pmctrl"
+- reg : Register address and size
+- #clock-cells: should be set to 1, some clock registers are define
+  under this controller and this property must be present.
+
+Hisilicon designs this system controller to control the power management
+domain for mobile platform.
+
+Example:
+   /*for Hi6220*/
+   pm_ctrl: pm_ctrl {
+   compatible = "hisilicon,hi6220-pmctrl", "syscon";
+   reg = <0x0 0xf7032000 0x0 0x1000>;
+   #clock-cells = <1>;
+   };
+
+---
  Hisilicon HiP01 system controller

  Required properties:
--
1.7.9.5



.



--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/


Re: [PATCH v9 2/6] arm64: hi6220: Document devicetree bindings for Hisilicon hi6220 SoC

2015-06-04 Thread Bintian

On 2015/6/4 12:36, Rob Herring wrote:

On Fri, May 29, 2015 at 8:50 PM, Bintian Wang bintian.w...@huawei.com wrote:

This patch adds documentation for the devicetree bindings used by the
DT files of Hisilicon hi6220 SoC mobile platform.

Signed-off-by: Bintian Wang bintian.w...@huawei.com
Suggested-by: Arnd Bergmann a...@arndb.de
Acked-by: Haojian Zhuang haojian.zhu...@linaro.org
Acked-by: Stephen Boyd sb...@codeaurora.org


Acked-by: Rob Herring r...@kernel.org

One minor comment below.

Thank you Rob, I will fix in version 10.

BR,

Bintian


---
  .../bindings/arm/hisilicon/hisilicon.txt   |   87 
  1 file changed, 87 insertions(+)

diff --git a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt 
b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
index 35b1bd4..f67d0f3 100644
--- a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
+++ b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
@@ -1,5 +1,8 @@
  Hisilicon Platforms Device Tree Bindings
  
+Hi6220 SoC
+Required root node properties:
+   - compatible = hisilicon,hi6220;

  Hi4511 Board
  Required root node properties:
@@ -13,6 +16,9 @@ HiP01 ca9x2 Board
  Required root node properties:
 - compatible = hisilicon,hip01-ca9x2;

+HiKey Board
+Required root node properties:
+   - compatible = hisilicon,hi6220-hikey, hisilicon,hi6220;

  Hisilicon system controller

@@ -41,6 +47,87 @@ Example:
 };

  ---
+Hisilicon Hi6220 system controller
+
+Required properties:
+- compatible : hisilicon,hi6220-sysctrl
+- reg : Register address and size
+- #clock-cells: should be set to 1, many clock registers are defined
+  under this controller and this property must be present.
+
+Hisilicon designs this controller as one of the system controllers,
+its main functions are the same as Hisilicon system controller, but
+the register offset of some core modules are different.
+
+Example:
+   /*for Hi6220*/
+   sys_ctrl: sys_ctrl {


You should have the unit address in the name here. Same with the
follow examples.


+   compatible = hisilicon,hi6220-sysctrl, syscon;
+   reg = 0x0 0xf703 0x0 0x2000;
+   #clock-cells = 1;
+   };
+
+
+Hisilicon Hi6220 Power Always ON domain controller
+
+Required properties:
+- compatible : hisilicon,hi6220-aoctrl
+- reg : Register address and size
+- #clock-cells: should be set to 1, many clock registers are defined
+  under this controller and this property must be present.
+
+Hisilicon designs this system controller to control the power always
+on domain for mobile platform.
+
+Example:
+   /*for Hi6220*/
+   ao_ctrl: ao_ctrl {
+   compatible = hisilicon,hi6220-aoctrl, syscon;
+   reg = 0x0 0xf780 0x0 0x2000;
+   #clock-cells = 1;
+   };
+
+
+Hisilicon Hi6220 Media domain controller
+
+Required properties:
+- compatible : hisilicon,hi6220-mediactrl
+- reg : Register address and size
+- #clock-cells: should be set to 1, many clock registers are defined
+  under this controller and this property must be present.
+
+Hisilicon designs this system controller to control the multimedia
+domain(e.g. codec, G3D ...) for mobile platform.
+
+Example:
+   /*for Hi6220*/
+   media_ctrl: media_ctrl {
+   compatible = hisilicon,hi6220-mediactrl, syscon;
+   reg = 0x0 0xf441 0x0 0x1000;
+   #clock-cells = 1;
+   };
+
+
+Hisilicon Hi6220 Power Management domain controller
+
+Required properties:
+- compatible : hisilicon,hi6220-pmctrl
+- reg : Register address and size
+- #clock-cells: should be set to 1, some clock registers are define
+  under this controller and this property must be present.
+
+Hisilicon designs this system controller to control the power management
+domain for mobile platform.
+
+Example:
+   /*for Hi6220*/
+   pm_ctrl: pm_ctrl {
+   compatible = hisilicon,hi6220-pmctrl, syscon;
+   reg = 0x0 0xf7032000 0x0 0x1000;
+   #clock-cells = 1;
+   };
+
+---
  Hisilicon HiP01 system controller

  Required properties:
--
1.7.9.5



.



--
To unsubscribe from this list: send the line unsubscribe linux-kernel in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/


Re: [PATCH v9 2/6] arm64: hi6220: Document devicetree bindings for Hisilicon hi6220 SoC

2015-06-03 Thread Rob Herring
On Fri, May 29, 2015 at 8:50 PM, Bintian Wang  wrote:
> This patch adds documentation for the devicetree bindings used by the
> DT files of Hisilicon hi6220 SoC mobile platform.
>
> Signed-off-by: Bintian Wang 
> Suggested-by: Arnd Bergmann 
> Acked-by: Haojian Zhuang 
> Acked-by: Stephen Boyd 

Acked-by: Rob Herring 

One minor comment below.

> ---
>  .../bindings/arm/hisilicon/hisilicon.txt   |   87 
> 
>  1 file changed, 87 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt 
> b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
> index 35b1bd4..f67d0f3 100644
> --- a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
> +++ b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
> @@ -1,5 +1,8 @@
>  Hisilicon Platforms Device Tree Bindings
>  
> +Hi6220 SoC
> +Required root node properties:
> +   - compatible = "hisilicon,hi6220";
>
>  Hi4511 Board
>  Required root node properties:
> @@ -13,6 +16,9 @@ HiP01 ca9x2 Board
>  Required root node properties:
> - compatible = "hisilicon,hip01-ca9x2";
>
> +HiKey Board
> +Required root node properties:
> +   - compatible = "hisilicon,hi6220-hikey", "hisilicon,hi6220";
>
>  Hisilicon system controller
>
> @@ -41,6 +47,87 @@ Example:
> };
>
>  ---
> +Hisilicon Hi6220 system controller
> +
> +Required properties:
> +- compatible : "hisilicon,hi6220-sysctrl"
> +- reg : Register address and size
> +- #clock-cells: should be set to 1, many clock registers are defined
> +  under this controller and this property must be present.
> +
> +Hisilicon designs this controller as one of the system controllers,
> +its main functions are the same as Hisilicon system controller, but
> +the register offset of some core modules are different.
> +
> +Example:
> +   /*for Hi6220*/
> +   sys_ctrl: sys_ctrl {

You should have the unit address in the name here. Same with the
follow examples.

> +   compatible = "hisilicon,hi6220-sysctrl", "syscon";
> +   reg = <0x0 0xf703 0x0 0x2000>;
> +   #clock-cells = <1>;
> +   };
> +
> +
> +Hisilicon Hi6220 Power Always ON domain controller
> +
> +Required properties:
> +- compatible : "hisilicon,hi6220-aoctrl"
> +- reg : Register address and size
> +- #clock-cells: should be set to 1, many clock registers are defined
> +  under this controller and this property must be present.
> +
> +Hisilicon designs this system controller to control the power always
> +on domain for mobile platform.
> +
> +Example:
> +   /*for Hi6220*/
> +   ao_ctrl: ao_ctrl {
> +   compatible = "hisilicon,hi6220-aoctrl", "syscon";
> +   reg = <0x0 0xf780 0x0 0x2000>;
> +   #clock-cells = <1>;
> +   };
> +
> +
> +Hisilicon Hi6220 Media domain controller
> +
> +Required properties:
> +- compatible : "hisilicon,hi6220-mediactrl"
> +- reg : Register address and size
> +- #clock-cells: should be set to 1, many clock registers are defined
> +  under this controller and this property must be present.
> +
> +Hisilicon designs this system controller to control the multimedia
> +domain(e.g. codec, G3D ...) for mobile platform.
> +
> +Example:
> +   /*for Hi6220*/
> +   media_ctrl: media_ctrl {
> +   compatible = "hisilicon,hi6220-mediactrl", "syscon";
> +   reg = <0x0 0xf441 0x0 0x1000>;
> +   #clock-cells = <1>;
> +   };
> +
> +
> +Hisilicon Hi6220 Power Management domain controller
> +
> +Required properties:
> +- compatible : "hisilicon,hi6220-pmctrl"
> +- reg : Register address and size
> +- #clock-cells: should be set to 1, some clock registers are define
> +  under this controller and this property must be present.
> +
> +Hisilicon designs this system controller to control the power management
> +domain for mobile platform.
> +
> +Example:
> +   /*for Hi6220*/
> +   pm_ctrl: pm_ctrl {
> +   compatible = "hisilicon,hi6220-pmctrl", "syscon";
> +   reg = <0x0 0xf7032000 0x0 0x1000>;
> +   #clock-cells = <1>;
> +   };
> +
> +---
>  Hisilicon HiP01 system controller
>
>  Required properties:
> --
> 1.7.9.5
>
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/


Re: [PATCH v9 2/6] arm64: hi6220: Document devicetree bindings for Hisilicon hi6220 SoC

2015-06-03 Thread Rob Herring
On Fri, May 29, 2015 at 8:50 PM, Bintian Wang bintian.w...@huawei.com wrote:
 This patch adds documentation for the devicetree bindings used by the
 DT files of Hisilicon hi6220 SoC mobile platform.

 Signed-off-by: Bintian Wang bintian.w...@huawei.com
 Suggested-by: Arnd Bergmann a...@arndb.de
 Acked-by: Haojian Zhuang haojian.zhu...@linaro.org
 Acked-by: Stephen Boyd sb...@codeaurora.org

Acked-by: Rob Herring r...@kernel.org

One minor comment below.

 ---
  .../bindings/arm/hisilicon/hisilicon.txt   |   87 
 
  1 file changed, 87 insertions(+)

 diff --git a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt 
 b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
 index 35b1bd4..f67d0f3 100644
 --- a/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
 +++ b/Documentation/devicetree/bindings/arm/hisilicon/hisilicon.txt
 @@ -1,5 +1,8 @@
  Hisilicon Platforms Device Tree Bindings
  
 +Hi6220 SoC
 +Required root node properties:
 +   - compatible = hisilicon,hi6220;

  Hi4511 Board
  Required root node properties:
 @@ -13,6 +16,9 @@ HiP01 ca9x2 Board
  Required root node properties:
 - compatible = hisilicon,hip01-ca9x2;

 +HiKey Board
 +Required root node properties:
 +   - compatible = hisilicon,hi6220-hikey, hisilicon,hi6220;

  Hisilicon system controller

 @@ -41,6 +47,87 @@ Example:
 };

  ---
 +Hisilicon Hi6220 system controller
 +
 +Required properties:
 +- compatible : hisilicon,hi6220-sysctrl
 +- reg : Register address and size
 +- #clock-cells: should be set to 1, many clock registers are defined
 +  under this controller and this property must be present.
 +
 +Hisilicon designs this controller as one of the system controllers,
 +its main functions are the same as Hisilicon system controller, but
 +the register offset of some core modules are different.
 +
 +Example:
 +   /*for Hi6220*/
 +   sys_ctrl: sys_ctrl {

You should have the unit address in the name here. Same with the
follow examples.

 +   compatible = hisilicon,hi6220-sysctrl, syscon;
 +   reg = 0x0 0xf703 0x0 0x2000;
 +   #clock-cells = 1;
 +   };
 +
 +
 +Hisilicon Hi6220 Power Always ON domain controller
 +
 +Required properties:
 +- compatible : hisilicon,hi6220-aoctrl
 +- reg : Register address and size
 +- #clock-cells: should be set to 1, many clock registers are defined
 +  under this controller and this property must be present.
 +
 +Hisilicon designs this system controller to control the power always
 +on domain for mobile platform.
 +
 +Example:
 +   /*for Hi6220*/
 +   ao_ctrl: ao_ctrl {
 +   compatible = hisilicon,hi6220-aoctrl, syscon;
 +   reg = 0x0 0xf780 0x0 0x2000;
 +   #clock-cells = 1;
 +   };
 +
 +
 +Hisilicon Hi6220 Media domain controller
 +
 +Required properties:
 +- compatible : hisilicon,hi6220-mediactrl
 +- reg : Register address and size
 +- #clock-cells: should be set to 1, many clock registers are defined
 +  under this controller and this property must be present.
 +
 +Hisilicon designs this system controller to control the multimedia
 +domain(e.g. codec, G3D ...) for mobile platform.
 +
 +Example:
 +   /*for Hi6220*/
 +   media_ctrl: media_ctrl {
 +   compatible = hisilicon,hi6220-mediactrl, syscon;
 +   reg = 0x0 0xf441 0x0 0x1000;
 +   #clock-cells = 1;
 +   };
 +
 +
 +Hisilicon Hi6220 Power Management domain controller
 +
 +Required properties:
 +- compatible : hisilicon,hi6220-pmctrl
 +- reg : Register address and size
 +- #clock-cells: should be set to 1, some clock registers are define
 +  under this controller and this property must be present.
 +
 +Hisilicon designs this system controller to control the power management
 +domain for mobile platform.
 +
 +Example:
 +   /*for Hi6220*/
 +   pm_ctrl: pm_ctrl {
 +   compatible = hisilicon,hi6220-pmctrl, syscon;
 +   reg = 0x0 0xf7032000 0x0 0x1000;
 +   #clock-cells = 1;
 +   };
 +
 +---
  Hisilicon HiP01 system controller

  Required properties:
 --
 1.7.9.5

--
To unsubscribe from this list: send the line unsubscribe linux-kernel in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/