xref: /freebsd/sys/contrib/device-tree/Bindings/mfd/da9062.txt (revision 8bab661a3316d8bd9b9fbd11a3b4371b91507bd2)

* Dialog DA9062 Power Management Integrated Circuit (PMIC)

Product information for the DA9062 and DA9061 devices can be found here:
- https://www.dialog-semiconductor.com/products/da9062
- https://www.dialog-semiconductor.com/products/da9061

The DA9062 PMIC consists of:

Device                   Supply Names    Description
------                   ------------    -----------
da9062-regulator        :               : LDOs & BUCKs
da9062-rtc              :               : Real-Time Clock
da9062-onkey            :               : On Key
da9062-watchdog         :               : Watchdog Timer
da9062-thermal          :               : Thermal
da9062-gpio             :               : GPIOs

The DA9061 PMIC consists of:

Device                   Supply Names    Description
------                   ------------    -----------
da9062-regulator        :               : LDOs & BUCKs
da9062-onkey            :               : On Key
da9062-watchdog         :               : Watchdog Timer
da9062-thermal          :               : Thermal

======

Required properties:

- compatible : Should be
    "dlg,da9062" for DA9062
    "dlg,da9061" for DA9061
- reg : Specifies the I2C slave address (this defaults to 0x58 but it can be
  modified to match the chip's OTP settings).

Optional properties:

- gpio-controller : Marks the device as a gpio controller.
- #gpio-cells     : Should be two. The first cell is the pin number and the
                    second cell is used to specify the gpio polarity.

See Documentation/devicetree/bindings/gpio/gpio.txt for further information on
GPIO bindings.

- interrupts : IRQ line information.
- interrupt-controller

See Documentation/devicetree/bindings/interrupt-controller/interrupts.txt for
further information on IRQ bindings.

Sub-nodes:

- regulators : This node defines the settings for the LDOs and BUCKs.
  The DA9062 regulators are bound using their names listed below:

    buck1    : BUCK_1
    buck2    : BUCK_2
    buck3    : BUCK_3
    buck4    : BUCK_4
    ldo1     : LDO_1
    ldo2     : LDO_2
    ldo3     : LDO_3
    ldo4     : LDO_4

  The DA9061 regulators are bound using their names listed below:

    buck1    : BUCK_1
    buck2    : BUCK_2
    buck3    : BUCK_3
    ldo1     : LDO_1
    ldo2     : LDO_2
    ldo3     : LDO_3
    ldo4     : LDO_4

  The component follows the standard regulator framework and the bindings
  details of individual regulator device can be found in:
  Documentation/devicetree/bindings/regulator/regulator.txt

  regulator-initial-mode may be specified for buck regulators using mode values
  from include/dt-bindings/regulator/dlg,da9063-regulator.h.

- rtc : This node defines settings required for the Real-Time Clock associated
  with the DA9062. There are currently no entries in this binding, however
  compatible = "dlg,da9062-rtc" should be added if a node is created.

- onkey : See ../input/da9062-onkey.txt

- watchdog: See ../watchdog/da9062-wdt.txt

- thermal : See ../thermal/da9062-thermal.txt

Example:

	pmic0: da9062@58 {
		compatible = "dlg,da9062";
		reg = <0x58>;
		interrupt-parent = <&gpio6>;
		interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
		interrupt-controller;

		rtc {
			compatible = "dlg,da9062-rtc";
		};

		regulators {
			DA9062_BUCK1: buck1 {
				regulator-name = "BUCK1";
				regulator-min-microvolt = <300000>;
				regulator-max-microvolt = <1570000>;
				regulator-min-microamp = <500000>;
				regulator-max-microamp = <2000000>;
				regulator-initial-mode = <DA9063_BUCK_MODE_SYNC>;
				regulator-boot-on;
			};
			DA9062_LDO1: ldo1 {
				regulator-name = "LDO_1";
				regulator-min-microvolt = <900000>;
				regulator-max-microvolt = <3600000>;
				regulator-boot-on;
			};
		};
	};