RE: [PATCH v2 2/2] mfd: add documentation for ACT8945A DT bindings

[Yang, Wenyou]

Hi Lee,


> -----Original Message-----
> From: Lee Jones [mailto:lee.jones@xxxxxxxxxx]
> Sent: 2016å1æ12æ 16:52
> To: Yang, Wenyou <Wenyou.Yang@xxxxxxxxx>
> Cc: Rob Herring <robh+dt@xxxxxxxxxx>; Pawel Moll <pawel.moll@xxxxxxx>;
> Mark Rutland <mark.rutland@xxxxxxx>; Ian Campbell
> <ijc+devicetree@xxxxxxxxxxxxxx>; Kumar Gala <galak@xxxxxxxxxxxxxx>; Javier
> Martinez Canillas <javier@xxxxxxxxxxxx>; Krzysztof Kozlowski
> <k.kozlowski@xxxxxxxxxxx>; Ferre, Nicolas <Nicolas.FERRE@xxxxxxxxx>;
> linux-arm-kernel@xxxxxxxxxxxxxxxxxxx; linux-kernel@xxxxxxxxxxxxxxx;
> devicetree@xxxxxxxxxxxxxxx
> Subject: Re: [PATCH v2 2/2] mfd: add documentation for ACT8945A DT bindings
> 
> On Tue, 12 Jan 2016, Wenyou Yang wrote:
> 
> > The Active-semi ACT8945A PMIC is a Multi-Function Device, it has two
> > subdevices:
> >  - Regulator
> >  - Charger
> >
> > This patch adds documentation for ACT8945A DT bindings.
> >
> > Signed-off-by: Wenyou Yang <wenyou.yang@xxxxxxxxx>
> > ---
> >
> > Changes in v2:
> >  - use more specific label in Example.
> >  - add pmic and charger nodes in Example.
> >
> >  Documentation/devicetree/bindings/mfd/act8945a.txt |   82
> ++++++++++++++++++++
> >  1 file changed, 82 insertions(+)
> >  create mode 100644 Documentation/devicetree/bindings/mfd/act8945a.txt
> >
> > diff --git a/Documentation/devicetree/bindings/mfd/act8945a.txt
> > b/Documentation/devicetree/bindings/mfd/act8945a.txt
> > new file mode 100644
> > index 0000000..e4a8aaf
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/mfd/act8945a.txt
> > @@ -0,0 +1,82 @@
> > +Device-Tree bindings for Active-semi ACT8945A MFD driver
> > +
> > +Required properties:
> > + - compatible: "active-semi,act8945a".
> > + - reg: the I2C slave address for the ACT8945A chip
> > +
> > +The chip exposes two subdevices:
> > + - a regulators: see ../regulator/act8945a-regulator.txt
> > + - a charger: see ../power/act8945a-charger.txt
> > +
> > +Example:
> > +	act8945a@5b {
> > +		compatible = "active-semi,act8945a";
> > +		reg = <0x5b>;
> > +		status = "okay";
> > +
> > +		pmic {
> > +			compatible = "active-semi,act8945a-regulator";
> > +			active-semi,vsel-high;
> > +
> > +				regulators {
> 
> Your tabbing here is not correct.

Oh, Yes, it is not correct, I will correct it.

Thanks.

> 
> > +					vdd_1v35_reg: DCDC_REG1 {
> > +						regulator-name = "VDD_1V35";
> > +						regulator-min-microvolt =
> <1350000>;
> > +						regulator-max-microvolt =
> <1350000>;
> > +						regulator-always-on;
> > +					};
> > +
> > +					vdd_1v2_reg: DCDC_REG2 {
> > +						regulator-name = "VDD_1V2";
> > +						regulator-min-microvolt =
> <1100000>;
> > +						regulator-max-microvolt =
> <1300000>;
> > +						regulator-always-on;
> > +					};
> > +
> > +					vdd_3v3_reg: DCDC_REG3 {
> > +						regulator-name = "VDD_3V3";
> > +						regulator-min-microvolt =
> <3300000>;
> > +						regulator-max-microvolt =
> <3300000>;
> > +						regulator-always-on;
> > +					};
> > +
> > +					vdd_fuse_reg: LDO_REG1 {
> > +						regulator-name = "VDD_FUSE";
> > +						regulator-min-microvolt =
> <2500000>;
> > +						regulator-max-microvolt =
> <2500000>;
> > +						regulator-always-on;
> > +					};
> > +
> > +					vdd_3v3_lp_reg: LDO_REG2 {
> > +						regulator-name = "VDD_3V3_LP";
> > +						regulator-min-microvolt =
> <3300000>;
> > +						regulator-max-microvolt =
> <3300000>;
> > +						regulator-always-on;
> > +					};
> > +
> > +					vdd_led_reg: LDO_REG3 {
> > +						regulator-name = "VDD_LED";
> > +						regulator-min-microvolt =
> <3300000>;
> > +						regulator-max-microvolt =
> <3300000>;
> > +						regulator-always-on;
> > +					};
> > +
> > +					vdd_sdhc_1v8_reg: LDO_REG4 {
> > +						regulator-name =
> "VDD_SDHC_1V8";
> > +						regulator-min-microvolt =
> <1800000>;
> > +						regulator-max-microvolt =
> <1800000>;
> > +						regulator-always-on;
> > +					};
> > +				};
> > +			};
> > +
> > +		charger {
> > +			compatible = "active-semi,act8945a-charger";
> > +			pinctrl-names = "default";
> > +			pinctrl-0 = <&pinctrl_charger_chglev>;
> > +			active-semi,chglev-gpio = <&pioA 12
> GPIO_ACTIVE_HIGH>;
> > +			active-semi,input_voltage_threshold = <6600>;
> > +			active-semi,precondition_timeout = <40>;
> > +			active-semi,total_timeout = <3>;
> > +		};
> > +	};
> 
> --
> Lee Jones
> Linaro STMicroelectronics Landing Team Lead Linaro.org â Open source
> software for ARM SoCs Follow Linaro: Facebook | Twitter | Blog


Best Regards,
Wenyou Yang