dt-bindings: mfd: Convert X-Powers AXP binding to a schema (239f2bb1) · Commits · EulixOS / Software / Kernel

Documentation/devicetree/bindings/i2c/allwinner,sun6i-a31-p2wi.yaml

+1 −1

Original line number	Diff line number	Diff line
		@@ -55,7 +55,7 @@ examples:
		#size-cells = <0>;

		axp221: pmic@68 {
		compatible = "x-powers,axp221";
		/* compatible = "x-powers,axp221"; */
		reg = <0x68>;
		};
		};

Documentation/devicetree/bindings/mfd/axp20x.txt

deleted100644 → 0

+0 −273

Original line number	Diff line number	Diff line
		AXP family PMIC device tree bindings

		The axp20x family current members :
		axp152 (X-Powers)
		axp202 (X-Powers)
		axp209 (X-Powers)
		axp221 (X-Powers)
		axp223 (X-Powers)
		axp803 (X-Powers)
		axp806 (X-Powers)
		axp809 (X-Powers)
		axp813 (X-Powers)

		The AXP813 is 2 chips packaged into 1. The 2 chips do not share anything
		other than the packaging. Pins are routed separately. As such they should
		be treated as separate entities. The other half is an AC100 RTC/codec
		combo chip. Please see ./ac100.txt for its bindings.

		Required properties:
		- compatible: should be one of:
		* "x-powers,axp152"
		* "x-powers,axp202"
		* "x-powers,axp209"
		* "x-powers,axp221"
		* "x-powers,axp223"
		* "x-powers,axp803"
		* "x-powers,axp806"
		* "x-powers,axp805", "x-powers,axp806"
		* "x-powers,axp305", "x-powers,axp805", "x-powers,axp806"
		* "x-powers,axp809"
		* "x-powers,axp813"
		- reg: The I2C slave address or RSB hardware address for the AXP chip
		- interrupt-controller: The PMIC has its own internal IRQs
		- #interrupt-cells: Should be set to 1

		Supported common regulator properties, see ../regulator/regulator.txt for
		more information:
		- regulator-ramp-delay: sets the ramp up delay in uV/us
		AXP20x/DCDC2: 1600, 800
		AXP20x/LDO3: 1600, 800
		- regulator-soft-start: enable the output at the lowest possible voltage and
		only then set the desired voltage
		AXP20x/LDO3: software-based implementation

		Optional properties:
		- interrupts: SoC NMI / GPIO interrupt connected to the PMIC's IRQ pin
		- x-powers,dcdc-freq: defines the work frequency of DC-DC in KHz
		AXP152/20X: range: 750-1875, Default: 1.5 MHz
		AXP22X/8XX: range: 1800-4050, Default: 3 MHz

		- x-powers,drive-vbus-en: boolean, set this when the N_VBUSEN pin is
		used as an output pin to control an external
		regulator to drive the OTG VBus, rather then
		as an input pin which signals whether the
		board is driving OTG VBus or not.
		(axp221 / axp223 / axp803/ axp813 only)

		- x-powers,self-working-mode and
		x-powers,master-mode: Boolean (axp806 only). Set either of these when the
		PMIC is wired for self-working mode or master mode.
		If neither is set then slave mode is assumed.
		This corresponds to how the MODESET pin is wired.

		- <input>-supply: a phandle to the regulator supply node. May be omitted if
		inputs are unregulated, such as using the IPSOUT output
		from the PMIC.

		- regulators: A node that houses a sub-node for each regulator. Regulators
		not used but preferred to be managed by the OS should be
		listed as well.
		See Documentation/devicetree/bindings/regulator/regulator.txt
		for more information on standard regulator bindings.

		Optional properties for DCDC regulators:
		- x-powers,dcdc-workmode: 1 for PWM mode, 0 for AUTO (PWM/PFM) mode
		Default: Current hardware setting
		The DCDC regulators work in a mixed PWM/PFM mode,
		using PFM under light loads and switching to PWM
		for heavier loads. Forcing PWM mode trades efficiency
		under light loads for lower output noise. This
		probably makes sense for HiFi audio related
		applications that aren't battery constrained.

		AXP202/AXP209 regulators, type, and corresponding input supply names:

		Regulator Type Supply Name Notes
		--------- ---- ----------- -----
		DCDC2 : DC-DC buck : vin2-supply
		DCDC3 : DC-DC buck : vin3-supply
		LDO1 : LDO : acin-supply : always on
		LDO2 : LDO : ldo24in-supply : shared supply
		LDO3 : LDO : ldo3in-supply
		LDO4 : LDO : ldo24in-supply : shared supply
		LDO5 : LDO : ldo5in-supply

		AXP221/AXP223 regulators, type, and corresponding input supply names:

		Regulator Type Supply Name Notes
		--------- ---- ----------- -----
		DCDC1 : DC-DC buck : vin1-supply
		DCDC2 : DC-DC buck : vin2-supply
		DCDC3 : DC-DC buck : vin3-supply
		DCDC4 : DC-DC buck : vin4-supply
		DCDC5 : DC-DC buck : vin5-supply
		DC1SW : On/Off Switch : : DCDC1 secondary output
		DC5LDO : LDO : : input from DCDC5
		ALDO1 : LDO : aldoin-supply : shared supply
		ALDO2 : LDO : aldoin-supply : shared supply
		ALDO3 : LDO : aldoin-supply : shared supply
		DLDO1 : LDO : dldoin-supply : shared supply
		DLDO2 : LDO : dldoin-supply : shared supply
		DLDO3 : LDO : dldoin-supply : shared supply
		DLDO4 : LDO : dldoin-supply : shared supply
		ELDO1 : LDO : eldoin-supply : shared supply
		ELDO2 : LDO : eldoin-supply : shared supply
		ELDO3 : LDO : eldoin-supply : shared supply
		LDO_IO0 : LDO : ips-supply : GPIO 0
		LDO_IO1 : LDO : ips-supply : GPIO 1
		RTC_LDO : LDO : ips-supply : always on
		DRIVEVBUS : Enable output : drivevbus-supply : external regulator

		AXP803 regulators, type, and corresponding input supply names:

		Regulator Type Supply Name Notes
		--------- ---- ----------- -----
		DCDC1 : DC-DC buck : vin1-supply
		DCDC2 : DC-DC buck : vin2-supply : poly-phase capable
		DCDC3 : DC-DC buck : vin3-supply : poly-phase capable
		DCDC4 : DC-DC buck : vin4-supply
		DCDC5 : DC-DC buck : vin5-supply : poly-phase capable
		DCDC6 : DC-DC buck : vin6-supply : poly-phase capable
		DC1SW : On/Off Switch : : DCDC1 secondary output
		ALDO1 : LDO : aldoin-supply : shared supply
		ALDO2 : LDO : aldoin-supply : shared supply
		ALDO3 : LDO : aldoin-supply : shared supply
		DLDO1 : LDO : dldoin-supply : shared supply
		DLDO2 : LDO : dldoin-supply : shared supply
		DLDO3 : LDO : dldoin-supply : shared supply
		DLDO4 : LDO : dldoin-supply : shared supply
		ELDO1 : LDO : eldoin-supply : shared supply
		ELDO2 : LDO : eldoin-supply : shared supply
		ELDO3 : LDO : eldoin-supply : shared supply
		FLDO1 : LDO : fldoin-supply : shared supply
		FLDO2 : LDO : fldoin-supply : shared supply
		LDO_IO0 : LDO : ips-supply : GPIO 0
		LDO_IO1 : LDO : ips-supply : GPIO 1
		RTC_LDO : LDO : ips-supply : always on
		DRIVEVBUS : Enable output : drivevbus-supply : external regulator

		AXP806 regulators, type, and corresponding input supply names:

		Regulator Type Supply Name Notes
		--------- ---- ----------- -----
		DCDCA : DC-DC buck : vina-supply : poly-phase capable
		DCDCB : DC-DC buck : vinb-supply : poly-phase capable
		DCDCC : DC-DC buck : vinc-supply : poly-phase capable
		DCDCD : DC-DC buck : vind-supply : poly-phase capable
		DCDCE : DC-DC buck : vine-supply : poly-phase capable
		ALDO1 : LDO : aldoin-supply : shared supply
		ALDO2 : LDO : aldoin-supply : shared supply
		ALDO3 : LDO : aldoin-supply : shared supply
		BLDO1 : LDO : bldoin-supply : shared supply
		BLDO2 : LDO : bldoin-supply : shared supply
		BLDO3 : LDO : bldoin-supply : shared supply
		BLDO4 : LDO : bldoin-supply : shared supply
		CLDO1 : LDO : cldoin-supply : shared supply
		CLDO2 : LDO : cldoin-supply : shared supply
		CLDO3 : LDO : cldoin-supply : shared supply
		SW : On/Off Switch : swin-supply

		Additionally, the AXP806 DC-DC regulators support poly-phase arrangements
		for higher output current. The possible groupings are: A+B, A+B+C, D+E.

		AXP809 regulators, type, and corresponding input supply names:

		Regulator Type Supply Name Notes
		--------- ---- ----------- -----
		DCDC1 : DC-DC buck : vin1-supply
		DCDC2 : DC-DC buck : vin2-supply
		DCDC3 : DC-DC buck : vin3-supply
		DCDC4 : DC-DC buck : vin4-supply
		DCDC5 : DC-DC buck : vin5-supply
		DC1SW : On/Off Switch : : DCDC1 secondary output
		DC5LDO : LDO : : input from DCDC5
		ALDO1 : LDO : aldoin-supply : shared supply
		ALDO2 : LDO : aldoin-supply : shared supply
		ALDO3 : LDO : aldoin-supply : shared supply
		DLDO1 : LDO : dldoin-supply : shared supply
		DLDO2 : LDO : dldoin-supply : shared supply
		ELDO1 : LDO : eldoin-supply : shared supply
		ELDO2 : LDO : eldoin-supply : shared supply
		ELDO3 : LDO : eldoin-supply : shared supply
		LDO_IO0 : LDO : ips-supply : GPIO 0
		LDO_IO1 : LDO : ips-supply : GPIO 1
		RTC_LDO : LDO : ips-supply : always on
		SW : On/Off Switch : swin-supply

		AXP813 regulators, type, and corresponding input supply names:

		Regulator Type Supply Name Notes
		--------- ---- ----------- -----
		DCDC1 : DC-DC buck : vin1-supply
		DCDC2 : DC-DC buck : vin2-supply : poly-phase capable
		DCDC3 : DC-DC buck : vin3-supply : poly-phase capable
		DCDC4 : DC-DC buck : vin4-supply
		DCDC5 : DC-DC buck : vin5-supply : poly-phase capable
		DCDC6 : DC-DC buck : vin6-supply : poly-phase capable
		DCDC7 : DC-DC buck : vin7-supply
		ALDO1 : LDO : aldoin-supply : shared supply
		ALDO2 : LDO : aldoin-supply : shared supply
		ALDO3 : LDO : aldoin-supply : shared supply
		DLDO1 : LDO : dldoin-supply : shared supply
		DLDO2 : LDO : dldoin-supply : shared supply
		DLDO3 : LDO : dldoin-supply : shared supply
		DLDO4 : LDO : dldoin-supply : shared supply
		ELDO1 : LDO : eldoin-supply : shared supply
		ELDO2 : LDO : eldoin-supply : shared supply
		ELDO3 : LDO : eldoin-supply : shared supply
		FLDO1 : LDO : fldoin-supply : shared supply
		FLDO2 : LDO : fldoin-supply : shared supply
		FLDO3 : LDO : fldoin-supply : shared supply
		LDO_IO0 : LDO : ips-supply : GPIO 0
		LDO_IO1 : LDO : ips-supply : GPIO 1
		RTC_LDO : LDO : ips-supply : always on
		SW : On/Off Switch : swin-supply
		DRIVEVBUS : Enable output : drivevbus-supply : external regulator

		Example:

		axp209: pmic@34 {
		compatible = "x-powers,axp209";
		reg = <0x34>;
		interrupt-parent = <&nmi_intc>;
		interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
		interrupt-controller;
		#interrupt-cells = <1>;

		regulators {
		x-powers,dcdc-freq = <1500>;

		vdd_cpu: dcdc2 {
		regulator-always-on;
		regulator-min-microvolt = <1000000>;
		regulator-max-microvolt = <1450000>;
		regulator-name = "vdd-cpu";
		};

		vdd_int_dll: dcdc3 {
		regulator-always-on;
		regulator-min-microvolt = <1000000>;
		regulator-max-microvolt = <1400000>;
		regulator-name = "vdd-int-dll";
		};

		vdd_rtc: ldo1 {
		regulator-always-on;
		regulator-min-microvolt = <1200000>;
		regulator-max-microvolt = <1400000>;
		regulator-name = "vdd-rtc";
		};

		avcc: ldo2 {
		regulator-always-on;
		regulator-min-microvolt = <2700000>;
		regulator-max-microvolt = <3300000>;
		regulator-name = "avcc";
		};

		ldo3 {
		/* unused but preferred to be managed by OS */
		};
		};
		};

Documentation/devicetree/bindings/mfd/x-powers,axp152.yaml

0 → 100644

+400 −0

Original line number	Diff line number	Diff line
		# SPDX-License-Identifier: GPL-2.0
		%YAML 1.2
		---
		$id: http://devicetree.org/schemas/mfd/x-powers,axp152.yaml#
		$schema: http://devicetree.org/meta-schemas/core.yaml#

		title: X-Powers AXP PMIC Device Tree Bindings

		maintainers:
		- Chen-Yu Tsai <wens@csie.org>

		allOf:
		- if:
		properties:
		compatible:
		contains:
		enum:
		- x-powers,axp152
		- x-powers,axp202
		- x-powers,axp209

		then:
		properties:
		regulators:
		properties:
		x-powers,dcdc-freq:
		minimum: 750
		maximum: 1875
		default: 1500

		else:
		properties:
		regulators:
		properties:
		x-powers,dcdc-freq:
		minimum: 1800
		maximum: 4050
		default: 3000

		- if:
		properties:
		compatible:
		contains:
		enum:
		- x-powers,axp152
		- x-powers,axp202
		- x-powers,axp209

		then:
		not:
		required:
		- x-powers,drive-vbus-en

		- if:
		not:
		properties:
		compatible:
		contains:
		const: x-powers,axp806

		then:
		allOf:
		- not:
		required:
		- x-powers,self-working-mode

		- not:
		required:
		- x-powers,master-mode

		- if:
		not:
		properties:
		compatible:
		contains:
		const: x-powers,axp305

		then:
		required:
		- interrupts

		properties:
		compatible:
		oneOf:
		- enum:
		- x-powers,axp152
		- x-powers,axp202
		- x-powers,axp209
		- x-powers,axp221
		- x-powers,axp223
		- x-powers,axp803
		- x-powers,axp806
		- x-powers,axp809
		- x-powers,axp813
		- items:
		- const: x-powers,axp805
		- const: x-powers,axp806
		- items:
		- const: x-powers,axp305
		- const: x-powers,axp805
		- const: x-powers,axp806
		- items:
		- const: x-powers,axp818
		- const: x-powers,axp813

		reg:
		maxItems: 1

		interrupts:
		maxItems: 1

		interrupt-controller: true

		"#interrupt-cells":
		const: 1

		x-powers,drive-vbus-en:
		type: boolean
		description: >
		Set this when the N_VBUSEN pin is used as an output pin to control an
		external regulator to drive the OTG VBus, rather then as an input pin
		which signals whether the board is driving OTG VBus or not.

		x-powers,self-working-mode:
		type: boolean
		description: >
		Set this when the PMIC is wired for self-working mode through the MODESET
		pin.

		x-powers,master-mode:
		type: boolean
		description: >
		Set this when the PMIC is wired for master mode through the MODESET pin.

		vin1-supply:
		description: >
		DCDC1 power supply node, if present.

		vin2-supply:
		description: >
		DCDC2 power supply node, if present.

		vin3-supply:
		description: >
		DCDC3 power supply node, if present.

		vin4-supply:
		description: >
		DCDC4 power supply node, if present.

		vin5-supply:
		description: >
		DCDC5 power supply node, if present.

		vin6-supply:
		description: >
		DCDC6 power supply node, if present.

		vin7-supply:
		description: >
		DCDC7 power supply node, if present.

		vina-supply:
		description: >
		DCDCA power supply node, if present.

		vinb-supply:
		description: >
		DCDCB power supply node, if present.

		vinc-supply:
		description: >
		DCDCC power supply node, if present.

		vind-supply:
		description: >
		DCDCD power supply node, if present.

		vine-supply:
		description: >
		DCDCE power supply node, if present.

		acin-supply:
		description: >
		LDO1 power supply node, if present.

		ldo24in-supply:
		description: >
		LDO2 and LDO4 power supply node, if present.

		ldo3in-supply:
		description: >
		LDO3 power supply node, if present.

		ldo5in-supply:
		description: >
		LDO5 power supply node, if present.

		aldoin-supply:
		description: >
		ALDO* power supply node, if present.

		bldoin-supply:
		description: >
		BLDO* power supply node, if present.

		cldoin-supply:
		description: >
		CLDO* power supply node, if present.

		dldoin-supply:
		description: >
		DLDO* power supply node, if present.

		eldoin-supply:
		description: >
		ELDO* power supply node, if present.

		fldoin-supply:
		description: >
		FLDO* power supply node, if present.

		ips-supply:
		description: >
		LDO_IO0, LDO_IO1 and RTC_LDO power supply node, if present.

		drivevbus-supply:
		description: >
		DRIVEVBUS power supply node, if present.

		swin-supply:
		description: >
		SW power supply node, if present.

		adc:
		$ref: /schemas/iio/adc/x-powers,axp209-adc.yaml#

		gpio:
		$ref: /schemas/gpio/x-powers,axp209-gpio.yaml#

		ac-power:
		$ref: /schemas/power/supply/x-powers,axp20x-ac-power-supply.yaml#

		battery-power:
		$ref: /schemas/power/supply/x-powers,axp20x-battery-power-supply.yaml#

		usb-power:
		$ref: /schemas/power/supply/x-powers,axp20x-usb-power-supply.yaml#

		regulators:
		type: object

		properties:
		x-powers,dcdc-freq:
		$ref: /schemas/types.yaml#/definitions/uint32
		description: >
		Defines the work frequency of DC-DC in kHz.

		patternProperties:
		"^(([a-f])?ldo[0-9]\|dcdc[0-7a-e]\|ldo(_\|-)io(0\|1)\|(dc1)?sw\|rtc(_\|-)ldo\|drivevbus\|dc5ldo)$":
		$ref: /schemas/regulator/regulator.yaml#
		type: object

		properties:
		regulator-ramp-delay:
		description: >
		Only 800 and 1600 are valid for the DCDC2 and LDO3 regulators on
		the AXP209.

		regulator-soft-start:
		description: >
		Only valid for the LDO3 regulator.

		x-powers,dcdc-workmode:
		$ref: /schemas/types.yaml#/definitions/uint32
		enum: [0, 1]
		description: >
		Only valid for DCDC regulators. Setup 1 for PWM mode, 0
		for AUTO (PWM/PFM) mode. The DCDC regulators work in a
		mixed PWM/PFM mode, using PFM under light loads and
		switching to PWM for heavier loads. Forcing PWM mode
		trades efficiency under light loads for lower output
		noise. This probably makes sense for HiFi audio related
		applications that aren't battery constrained.

		additionalProperties: false

		required:
		- compatible
		- reg
		- "#interrupt-cells"
		- interrupt-controller

		additionalProperties: false

		examples:
		- \|
		i2c0 {
		#address-cells = <1>;
		#size-cells = <0>;

		pmic@30 {
		compatible = "x-powers,axp152";
		reg = <0x30>;
		interrupts = <0>;
		interrupt-controller;
		#interrupt-cells = <1>;
		};
		};

		- \|
		#include <dt-bindings/interrupt-controller/irq.h>

		i2c0 {
		#address-cells = <1>;
		#size-cells = <0>;

		pmic@34 {
		compatible = "x-powers,axp209";
		reg = <0x34>;
		interrupt-parent = <&nmi_intc>;
		interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
		interrupt-controller;
		#interrupt-cells = <1>;

		ac_power_supply: ac-power {
		compatible = "x-powers,axp202-ac-power-supply";
		};

		axp_adc: adc {
		compatible = "x-powers,axp209-adc";
		#io-channel-cells = <1>;
		};

		axp_gpio: gpio {
		compatible = "x-powers,axp209-gpio";
		gpio-controller;
		#gpio-cells = <2>;

		gpio0-adc-pin {
		pins = "GPIO0";
		function = "adc";
		};
		};

		battery_power_supply: battery-power {
		compatible = "x-powers,axp209-battery-power-supply";
		};

		regulators {
		/* Default work frequency for buck regulators */
		x-powers,dcdc-freq = <1500>;

		reg_dcdc2: dcdc2 {
		regulator-always-on;
		regulator-min-microvolt = <1000000>;
		regulator-max-microvolt = <1450000>;
		regulator-name = "vdd-cpu";
		};

		reg_dcdc3: dcdc3 {
		regulator-always-on;
		regulator-min-microvolt = <1000000>;
		regulator-max-microvolt = <1400000>;
		regulator-name = "vdd-int-dll";
		};

		reg_ldo1: ldo1 {
		/* LDO1 is a fixed output regulator */
		regulator-always-on;
		regulator-min-microvolt = <1300000>;
		regulator-max-microvolt = <1300000>;
		regulator-name = "vdd-rtc";
		};

		reg_ldo2: ldo2 {
		regulator-always-on;
		regulator-min-microvolt = <3000000>;
		regulator-max-microvolt = <3000000>;
		regulator-name = "avcc";
		};

		reg_ldo3: ldo3 {
		regulator-name = "ldo3";
		};

		reg_ldo4: ldo4 {
		regulator-name = "ldo4";
		};

		reg_ldo5: ldo5 {
		regulator-name = "ldo5";
		};
		};

		usb_power_supply: usb-power {
		compatible = "x-powers,axp202-usb-power-supply";
		};
		};
		};