On Mon, Nov 18, 2019 at 08:54:56AM +0200, Matti Vaittinen wrote: > ROHM BD71828 Power management IC integrates 7 buck converters, 7 LDOs, > a real-time clock (RTC), 3 GPO/regulator control pins, HALL input > and a 32.768 kHz clock gate. > > Document the dt bindings drivers are using. > > Signed-off-by: Matti Vaittinen <matti.vaittinen@xxxxxxxxxxxxxxxxx> > --- > > No changes from v4 > > .../bindings/mfd/rohm,bd71828-pmic.yaml | 249 ++++++++++++++++++ > 1 file changed, 249 insertions(+) > create mode 100644 Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml > > diff --git a/Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml b/Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml > new file mode 100644 > index 000000000000..17ea9fa463e8 > --- /dev/null > +++ b/Documentation/devicetree/bindings/mfd/rohm,bd71828-pmic.yaml > @@ -0,0 +1,249 @@ > +# SPDX-License-Identifier: GPL-2.0-only > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/mfd/rohm,bd71828-pmic.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: ROHM BD71828 Power Management Integrated Circuit bindings > + > +maintainers: > + - Matti Vaittinen <matti.vaittinen@xxxxxxxxxxxxxxxxx> > + > +description: | > + BD71828GW is a single-chip power management IC for battery-powered portable > + devices. The IC integrates 7 buck converters, 7 LDOs, and a 1500 mA > + single-cell linear charger. Also included is a Coulomb counter, a real-time > + clock (RTC), and a 32.768 kHz clock gate. > + > + The BD71828 RUN state is divided into 4 configurable run-levels named RUN0, > + RUN1, RUN2 and RUN3. Bucks 1, 2, 6 and 7 can be either controlled individually > + via I2C, or some/all of them can be bound to run-levels and controlled as a > + group. If bucks are controlled individually these run-levels are ignored. See > + ../regulator/rohm,bd71828-regulator.yaml for how to define regulator voltages > + for run-levels. Run-levels can be changed by I2C or GPIO depending on PMIC's > + OTP configuration. > + > +properties: > + compatible: > + const: rohm,bd71828 > + > + reg: > + description: > + I2C slave address. > + maxItems: 1 > + > + interrupts: > + maxItems: 1 > + description: > + The interrupt line the device is connected to. The description here is not too useful, I'd drop it. > + > + gpio-controller: true > + # Indicate BD71828 acts as a GPIO controller. > + > + "#gpio-cells": > + const: 2 > + description: | > + The first cell is the pin number and the second cell is used to specify > + flags. See ../gpio/gpio.txt for more information. > + > + clocks: > + maxItems: 1 > + description: > + The parent clock connected to PMIC. The description here is not too useful, I'd drop it. > + > + "#clock-cells": > + const: 0 > + > + rohm,charger-sense-resistor-ohms: > + minimum: 10000000 > + maximum: 50000000 > + description: | > + BD71827 and BD71828 have SAR ADC for measuring charging currents. > + External sense resistor (RSENSE in data sheet) should be used. If some > + other but 30MOhm resistor is used the resistance value should be given > + here in Ohms. > + > + regulators: > + $ref: ../regulator/rohm,bd71828-regulator.yaml > + description: > + List of child nodes that specify the regulators. > + > + leds: > + $ref: ../leds/rohm,bd71828-leds.yaml > + > + rohm,dvs-vsel-gpios: > + maxItems: 2 > + description: | > + GPIOs used to control PMIC run-levels. Should describe two GPIOs. > + (See run-level control in data-sheet). If this property is omitted but > + some bucks are marked to be controlled by run-levels - then OTP option > + allowing run-level control via I2C is assumed. > + > + gpio-reserved-ranges: > + description: | > + Usage of BD71828 GPIO pins can be changed via OTP. This property can be > + used to mark the pins which should not be configured for GPIO. Please see > + the ../gpio/gpio.txt for more information. > + > +required: > + - compatible > + - reg > + - interrupts > + - clocks > + - "#clock-cells" > + - regulators > + - gpio-controller > + - "#gpio-cells"
