diff mbox

[v5,1/5] doc: bindings: Add document for mfd hi665x PMIC

Message ID 1452514817-118311-2-git-send-email-puck.chen@hisilicon.com
State Superseded
Headers show

Commit Message

Chen Feng Jan. 11, 2016, 12:20 p.m. UTC
Add document for mfd driver hi655x pmic driver

Signed-off-by: Chen Feng <puck.chen@hisilicon.com>

Signed-off-by: Fei Wang <w.f@huawei.com>

Signed-off-by: Xinwei Kong <kong.kongxinwei@hisilicon.com>

---
 .../devicetree/bindings/mfd/hisilicon,hi655x.txt   | 28 ++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt

-- 
1.9.1

Comments

Lee Jones Jan. 25, 2016, 12:53 p.m. UTC | #1
On Mon, 11 Jan 2016, Chen Feng wrote:

> Add document for mfd driver hi655x pmic driver

> 

> Signed-off-by: Chen Feng <puck.chen@hisilicon.com>

> Signed-off-by: Fei Wang <w.f@huawei.com>

> Signed-off-by: Xinwei Kong <kong.kongxinwei@hisilicon.com>

> ---

>  .../devicetree/bindings/mfd/hisilicon,hi655x.txt   | 28 ++++++++++++++++++++++

>  1 file changed, 28 insertions(+)

>  create mode 100644 Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt

> 

> diff --git a/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt b/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt

> new file mode 100644

> index 0000000..3180c40

> --- /dev/null

> +++ b/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt

> @@ -0,0 +1,28 @@

> +Hisilicon hi655x Power Management Integrated Circuit (PMIC)

> +

> +The hardware layout for access PMIC Hi655x from AP SoC Hi6220.

> +Between PMIC Hi655x and Hi6220, the physical signal channel is SSI.

> +We can use memory-mapped I/O to communicate.

> +

> ++----------------+             +-------------+

> +|                |             |             |

> +|    Hi6220      |   SSI bus   |   Hi655x    |

> +|                |-------------|             |

> +|                |(REGMAP_MMIO)|             |

> ++----------------+             +-------------+

> +

> +Required properties:

> +- compatible: Should be "hisilicon,hi655x-pmic"

> +- reg: Base address of PMIC on hi6220 soc


SoC

> +- interrupt-controller: Hi655x has internal IRQs (has own IRQ domain).

> +- pmic-gpios: The gpio used by pmic irq.


PMIC IRQ

> +

> +Example:

> +	pmic: pmic@f8000000 {

> +		compatible = "hisilicon,hi655x-pmic";

> +		reg = <0x0 0xf8000000 0x0 0x1000>;

> +		#interrupt-cells = <2>;

> +		interrupt-controller;

> +		pmic-gpios = <&gpio1 2 0>;


What's the last cell for here?  If they are flags, there is probably a
#define you can use in dt-include.

> +		status = "disabled";


What's the point in disabling example code?

> +	}


-- 
Lee Jones
Linaro STMicroelectronics Landing Team Lead
Linaro.org │ Open source software for ARM SoCs
Follow Linaro: Facebook | Twitter | Blog
Chen Feng Jan. 26, 2016, 6:26 a.m. UTC | #2
On 2016/1/25 20:53, Lee Jones wrote:
> On Mon, 11 Jan 2016, Chen Feng wrote:

> 

>> Add document for mfd driver hi655x pmic driver

>>

>> Signed-off-by: Chen Feng <puck.chen@hisilicon.com>

>> Signed-off-by: Fei Wang <w.f@huawei.com>

>> Signed-off-by: Xinwei Kong <kong.kongxinwei@hisilicon.com>

>> ---

>>  .../devicetree/bindings/mfd/hisilicon,hi655x.txt   | 28 ++++++++++++++++++++++

>>  1 file changed, 28 insertions(+)

>>  create mode 100644 Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt

>>

>> diff --git a/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt b/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt

>> new file mode 100644

>> index 0000000..3180c40

>> --- /dev/null

>> +++ b/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt

>> @@ -0,0 +1,28 @@

>> +Hisilicon hi655x Power Management Integrated Circuit (PMIC)

>> +

>> +The hardware layout for access PMIC Hi655x from AP SoC Hi6220.

>> +Between PMIC Hi655x and Hi6220, the physical signal channel is SSI.

>> +We can use memory-mapped I/O to communicate.

>> +

>> ++----------------+             +-------------+

>> +|                |             |             |

>> +|    Hi6220      |   SSI bus   |   Hi655x    |

>> +|                |-------------|             |

>> +|                |(REGMAP_MMIO)|             |

>> ++----------------+             +-------------+

>> +

>> +Required properties:

>> +- compatible: Should be "hisilicon,hi655x-pmic"

>> +- reg: Base address of PMIC on hi6220 soc

> 

> SoC

> 

>> +- interrupt-controller: Hi655x has internal IRQs (has own IRQ domain).

>> +- pmic-gpios: The gpio used by pmic irq.

> 

> PMIC IRQ

> 

>> +

>> +Example:

>> +	pmic: pmic@f8000000 {

>> +		compatible = "hisilicon,hi655x-pmic";

>> +		reg = <0x0 0xf8000000 0x0 0x1000>;

>> +		#interrupt-cells = <2>;

>> +		interrupt-controller;

>> +		pmic-gpios = <&gpio1 2 0>;

> 

> What's the last cell for here?  If they are flags, there is probably a

> #define you can use in dt-include.

ok, I will use the irq flag in dt-include.
> 

>> +		status = "disabled";

> 

> What's the point in disabling example code?

It's just copy from the dts, I will drop this.
> 

>> +	}

>
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt b/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt
new file mode 100644
index 0000000..3180c40
--- /dev/null
+++ b/Documentation/devicetree/bindings/mfd/hisilicon,hi655x.txt
@@ -0,0 +1,28 @@ 
+Hisilicon hi655x Power Management Integrated Circuit (PMIC)
+
+The hardware layout for access PMIC Hi655x from AP SoC Hi6220.
+Between PMIC Hi655x and Hi6220, the physical signal channel is SSI.
+We can use memory-mapped I/O to communicate.
+
++----------------+             +-------------+
+|                |             |             |
+|    Hi6220      |   SSI bus   |   Hi655x    |
+|                |-------------|             |
+|                |(REGMAP_MMIO)|             |
++----------------+             +-------------+
+
+Required properties:
+- compatible: Should be "hisilicon,hi655x-pmic"
+- reg: Base address of PMIC on hi6220 soc
+- interrupt-controller: Hi655x has internal IRQs (has own IRQ domain).
+- pmic-gpios: The gpio used by pmic irq.
+
+Example:
+	pmic: pmic@f8000000 {
+		compatible = "hisilicon,hi655x-pmic";
+		reg = <0x0 0xf8000000 0x0 0x1000>;
+		#interrupt-cells = <2>;
+		interrupt-controller;
+		pmic-gpios = <&gpio1 2 0>;
+		status = "disabled";
+	}