Message ID | 1391707641-13543-2-git-send-email-t.figa@samsung.com |
---|---|
State | Superseded, archived |
Headers | show |
Hi, Oops, I have forgotten to add suppress-cc to git send-email and the series went outside the intended audience... Please disregard these patches. Sorry for the noise. Best regards, Tomasz On 06.02.2014 18:27, Tomasz Figa wrote: > From: Krzysztof Kozlowski <k.kozlowski@samsung.com> > > Add document describing device tree bindings for MAX14577 MFD driver > (for both MAX14577 and MAX77836 chipsets). > > Signed-off-by: Krzysztof Kozlowski <k.kozlowski@samsung.com> > Cc: Kyungmin Park <kyungmin.park@samsung.com> > Cc: Tomasz Figa <t.figa@samsung.com> > Cc: Marek Szyprowski <m.szyprowski@samsung.com> > Cc: devicetree@vger.kernel.org > Cc: Rob Herring <robh+dt@kernel.org> > Cc: Pawel Moll <pawel.moll@arm.com> > Cc: Mark Rutland <mark.rutland@arm.com> > --- > Documentation/devicetree/bindings/mfd/max14577.txt | 149 ++++++++++++++++++++ > 1 file changed, 149 insertions(+) > create mode 100644 Documentation/devicetree/bindings/mfd/max14577.txt > > diff --git a/Documentation/devicetree/bindings/mfd/max14577.txt b/Documentation/devicetree/bindings/mfd/max14577.txt > new file mode 100644 > index 0000000..f59a4f3 > --- /dev/null > +++ b/Documentation/devicetree/bindings/mfd/max14577.txt > @@ -0,0 +1,149 @@ > +Maxim MAX14577/77836 Multi-Function Device > + > +MAX14577 is a Multi-Function Device with Micro-USB Interface Circuit, Li+ > +Battery Charger and SFOUT LDO output for powering USB devices. It is > +interfaced to host controller using I2C. > + > +MAX77836 additionally contains PMIC (with two LDO regulators) and Fuel Gauge. > + > + > +Required properties: > +- compatible : Must be "maxim,max14577" or "maxim,max77836". > +- reg : I2C slave address for the max14577 chip (0x25 for max14577/max77836) > +- interrupts : IRQ line for the chip. > +- interrupt-parent : The parent interrupt controller. > + > + > +Optional nodes: > +- max14577-muic/max77836-muic : > + Node used only by extcon consumers. > + Required properties: > + - compatible : "maxim,max14577-muic" or "maxim,max77836-muic" > + > +- regulators : > + Required properties: > + - compatible : "maxim,max14577-regulator" > + or "maxim,max77836-regulator" > + > + May contain a sub-node per regulator from the list below. Each > + sub-node should contain the constraints and initialization information > + for that regulator. See regulator.txt for a description of standard > + properties for these sub-nodes. > + > + List of valid regulator names: > + - for max14577: CHARGER, SAFEOUT. > + - for max77836: CHARGER, SAFEOUT, LDO1, LDO2. > + > + The SAFEOUT is a fixed voltage regulator so there is no need to specify > + voltages for it. > + > + - charger : > + Required properties: > + - compatible : "maxim,max14577-charger" > + or "maxim,max77836-charger" > + - maxim,fast-charge-timer : Timer in hours to trigger the > + INT3/MBCCHGERR interrupt; Valid values: > + - 5, 6 or 7 (hours), > + - 0 to disable. > + - maxim,fast-charge-uamp : Current in uA for Fast Charge; > + Valid values: > + - for max14577: 90000 - 950000; > + - for max77836: 45000 - 475000; > + - maxim,eoc-uamp : Current in uA for End-Of-Charge mode; > + Valid values: > + - for max14577: 50000 - 200000; > + - for max77836: 5000 - 10000; > + - maxim,ovp-uvolt : OverVoltage Protection Threshold in uV; > + In an overvoltage condition, INT asserts and charging > + stops. Valid values: > + - 6000000, 6500000, 7000000, 7500000; > + - maxim,constant-uvolt : Battery Constant Voltage in uV; > + Valid values: > + - 4000000 - 4280000; > + - 4350000; > + > + > +Example: > + > +#include <dt-bindings/interrupt-controller/irq.h> > + > +max14577@25 { > + compatible = "maxim,max14577"; > + reg = <0x25>; > + interrupt-parent = <&gpx1>; > + interrupts = <5 IRQ_TYPE_NONE>; > + > + muic: max14577-muic { > + compatible = "maxim,max14577-muic"; > + }; > + > + regulators { > + compatible = "maxim,max14577-regulator"; > + > + SAFEOUT { > + regulator-name = "SAFEOUT"; > + }; > + CHARGER { > + regulator-name = "CHARGER"; > + regulator-min-microamp = <90000>; > + regulator-max-microamp = <950000>; > + regulator-boot-on; > + }; > + }; > + > + charger { > + compatible = "maxim,max14577-charger"; > + > + maxim,fast-charge-timer = <6>; > + maxim,constant-uvolt = <4350000>; > + maxim,fast-charge-uamp = <450000>; > + maxim,eoc-uamp = <50000>; > + maxim,ovp-uvolt = <6500000>; > + }; > +}; > + > + > +max77836@25 { > + compatible = "maxim,max77836"; > + reg = <0x25>; > + interrupt-parent = <&gpx1>; > + interrupts = <5 IRQ_TYPE_NONE>; > + > + muic: max77836-muic { > + compatible = "maxim,max77836-muic"; > + }; > + > + regulators { > + compatible = "maxim,max77836-regulator"; > + > + SAFEOUT { > + regulator-name = "SAFEOUT"; > + }; > + CHARGER { > + regulator-name = "CHARGER"; > + regulator-min-microamp = <90000>; > + regulator-max-microamp = <950000>; > + regulator-boot-on; > + }; > + LDO1 { > + regulator-name = "LDO1"; > + regulator-min-microvolt = <2700000>; > + regulator-max-microvolt = <2700000>; > + }; > + LDO2 { > + regulator-name = "LDO2"; > + regulator-min-microvolt = <800000>; > + regulator-max-microvolt = <3950000>; > + }; > + }; > + > + charger { > + compatible = "maxim,max77836-charger"; > + > + maxim,fast-charge-timer = <6>; > + maxim,constant-uvolt = <4350000>; > + maxim,fast-charge-uamp = <225000>; > + maxim,eoc-uamp = <7500>; > + maxim,ovp-uvolt = <6500000>; > + }; > +}; > -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
diff --git a/Documentation/devicetree/bindings/mfd/max14577.txt b/Documentation/devicetree/bindings/mfd/max14577.txt new file mode 100644 index 0000000..f59a4f3 --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/max14577.txt @@ -0,0 +1,149 @@ +Maxim MAX14577/77836 Multi-Function Device + +MAX14577 is a Multi-Function Device with Micro-USB Interface Circuit, Li+ +Battery Charger and SFOUT LDO output for powering USB devices. It is +interfaced to host controller using I2C. + +MAX77836 additionally contains PMIC (with two LDO regulators) and Fuel Gauge. + + +Required properties: +- compatible : Must be "maxim,max14577" or "maxim,max77836". +- reg : I2C slave address for the max14577 chip (0x25 for max14577/max77836) +- interrupts : IRQ line for the chip. +- interrupt-parent : The parent interrupt controller. + + +Optional nodes: +- max14577-muic/max77836-muic : + Node used only by extcon consumers. + Required properties: + - compatible : "maxim,max14577-muic" or "maxim,max77836-muic" + +- regulators : + Required properties: + - compatible : "maxim,max14577-regulator" + or "maxim,max77836-regulator" + + May contain a sub-node per regulator from the list below. Each + sub-node should contain the constraints and initialization information + for that regulator. See regulator.txt for a description of standard + properties for these sub-nodes. + + List of valid regulator names: + - for max14577: CHARGER, SAFEOUT. + - for max77836: CHARGER, SAFEOUT, LDO1, LDO2. + + The SAFEOUT is a fixed voltage regulator so there is no need to specify + voltages for it. + + - charger : + Required properties: + - compatible : "maxim,max14577-charger" + or "maxim,max77836-charger" + - maxim,fast-charge-timer : Timer in hours to trigger the + INT3/MBCCHGERR interrupt; Valid values: + - 5, 6 or 7 (hours), + - 0 to disable. + - maxim,fast-charge-uamp : Current in uA for Fast Charge; + Valid values: + - for max14577: 90000 - 950000; + - for max77836: 45000 - 475000; + - maxim,eoc-uamp : Current in uA for End-Of-Charge mode; + Valid values: + - for max14577: 50000 - 200000; + - for max77836: 5000 - 10000; + - maxim,ovp-uvolt : OverVoltage Protection Threshold in uV; + In an overvoltage condition, INT asserts and charging + stops. Valid values: + - 6000000, 6500000, 7000000, 7500000; + - maxim,constant-uvolt : Battery Constant Voltage in uV; + Valid values: + - 4000000 - 4280000; + - 4350000; + + +Example: + +#include <dt-bindings/interrupt-controller/irq.h> + +max14577@25 { + compatible = "maxim,max14577"; + reg = <0x25>; + interrupt-parent = <&gpx1>; + interrupts = <5 IRQ_TYPE_NONE>; + + muic: max14577-muic { + compatible = "maxim,max14577-muic"; + }; + + regulators { + compatible = "maxim,max14577-regulator"; + + SAFEOUT { + regulator-name = "SAFEOUT"; + }; + CHARGER { + regulator-name = "CHARGER"; + regulator-min-microamp = <90000>; + regulator-max-microamp = <950000>; + regulator-boot-on; + }; + }; + + charger { + compatible = "maxim,max14577-charger"; + + maxim,fast-charge-timer = <6>; + maxim,constant-uvolt = <4350000>; + maxim,fast-charge-uamp = <450000>; + maxim,eoc-uamp = <50000>; + maxim,ovp-uvolt = <6500000>; + }; +}; + + +max77836@25 { + compatible = "maxim,max77836"; + reg = <0x25>; + interrupt-parent = <&gpx1>; + interrupts = <5 IRQ_TYPE_NONE>; + + muic: max77836-muic { + compatible = "maxim,max77836-muic"; + }; + + regulators { + compatible = "maxim,max77836-regulator"; + + SAFEOUT { + regulator-name = "SAFEOUT"; + }; + CHARGER { + regulator-name = "CHARGER"; + regulator-min-microamp = <90000>; + regulator-max-microamp = <950000>; + regulator-boot-on; + }; + LDO1 { + regulator-name = "LDO1"; + regulator-min-microvolt = <2700000>; + regulator-max-microvolt = <2700000>; + }; + LDO2 { + regulator-name = "LDO2"; + regulator-min-microvolt = <800000>; + regulator-max-microvolt = <3950000>; + }; + }; + + charger { + compatible = "maxim,max77836-charger"; + + maxim,fast-charge-timer = <6>; + maxim,constant-uvolt = <4350000>; + maxim,fast-charge-uamp = <225000>; + maxim,eoc-uamp = <7500>; + maxim,ovp-uvolt = <6500000>; + }; +};