Skip to contentSkip to conversation

power: X-Powers PMIC regulator support

PATCH In review Samuel Holland 3 participants 9 messages Jan 21, 2023 – Jan 23, 2023

lore
Share & tools
lore
#0 lore raw

v2 cover power: X-Powers PMIC regulator support

This series adds a driver for the regulators in X-Powers AXPxxx PMICs. It supports everything except regulators shared with GPIO pins. Those have a different register interface, so they may need a separate driver.

Regulator setup in U-Boot proper is needed for Ethernet and HDMI/LCD display output. For some SoCs (H616), this driver could possibly be used for the DRAM regulator setup done in SPL. Older SoCs do all of their regulator setup in SPL. Some of that is probably necessary, but I think a lot of it is not and can be deferred to U-Boot proper or Linux; that's just where it was convenient to initialize the PMIC at the time.

The main goal here is to replace the corresponding code in TF-A, both because of TF-A size constraints, and because the TF-A code is too simple/overzealous and breaks EPHY power sequencing on some boards.

Changes in v2:
- Dual-license the driver
- Add a comment about the requirements for the voltage table
- Fix AXP22x ALDO3 enable bit position

Samuel Holland (3):
power: pmic: axp: Provide a variant ID in the driver data
power: regulator: Add a driver for AXP PMIC regulators
power: pmic: axp: Bind regulators from the DT

 drivers/power/pmic/axp.c                |  36 ++-
 drivers/power/regulator/Kconfig         |  14 ++
 drivers/power/regulator/Makefile        |   1 +
 drivers/power/regulator/axp_regulator.c | 312 ++++++++++++++++++++++++
 include/axp_pmic.h                      |  12 +
 5 files changed, 366 insertions(+), 9 deletions(-)
 create mode 100644 drivers/power/regulator/axp_regulator.c
Signature · 1 line
2.37.4
#1 lore raw

PATCH v2 1/3 power: pmic: axp: Provide a variant ID in the driver data

Subordinate regulator drivers can use this enumerated ID instead of matching the compatible string again.

---

(no changes since v1)

 drivers/power/pmic/axp.c | 18 +++++++++---------
 include/axp_pmic.h       | 12 ++++++++++++
 2 files changed, 21 insertions(+), 9 deletions(-)
drivers/power/pmic/axp.c +9 -9
index 0f2b24a8b5..e0005994e2 100644
@@ -64,15 +64,15 @@ static int axp_pmic_bind(struct udevice *dev)
 }
 
 static const struct udevice_id axp_pmic_ids[] = {
-	{ .compatible = "x-powers,axp152" },
-	{ .compatible = "x-powers,axp202" },
-	{ .compatible = "x-powers,axp209" },
-	{ .compatible = "x-powers,axp221" },
-	{ .compatible = "x-powers,axp223" },
-	{ .compatible = "x-powers,axp803" },
-	{ .compatible = "x-powers,axp806" },
-	{ .compatible = "x-powers,axp809" },
-	{ .compatible = "x-powers,axp813" },
+	{ .compatible = "x-powers,axp152", .data = AXP152_ID },
+	{ .compatible = "x-powers,axp202", .data = AXP202_ID },
+	{ .compatible = "x-powers,axp209", .data = AXP209_ID },
+	{ .compatible = "x-powers,axp221", .data = AXP221_ID },
+	{ .compatible = "x-powers,axp223", .data = AXP223_ID },
+	{ .compatible = "x-powers,axp803", .data = AXP803_ID },
+	{ .compatible = "x-powers,axp806", .data = AXP806_ID },
+	{ .compatible = "x-powers,axp809", .data = AXP809_ID },
+	{ .compatible = "x-powers,axp813", .data = AXP813_ID },
 	{ }
 };
 
include/axp_pmic.h +12 -0
index 01ebba6347..4ac6486583 100644
@@ -26,6 +26,18 @@
 #define AXP_PMIC_SEC_DEVICE_ADDR	0x745
 #define AXP_PMIC_SEC_RUNTIME_ADDR	0x3a
 
+enum {
+	AXP152_ID,
+	AXP202_ID,
+	AXP209_ID,
+	AXP221_ID,
+	AXP223_ID,
+	AXP803_ID,
+	AXP806_ID,
+	AXP809_ID,
+	AXP813_ID,
+};
+
 int axp_set_dcdc1(unsigned int mvolt);
 int axp_set_dcdc2(unsigned int mvolt);
 int axp_set_dcdc3(unsigned int mvolt);
Signature · 1 line
2.37.4
#2 lore raw

PATCH v2 2/3 power: regulator: Add a driver for AXP PMIC regulators

In reply to Samuel Holland

This driver handles most voltage regulators found in X-Powers AXP PMICs. It is based on, and intended to replace, the regulator driver in TF-A.

AXP PMIC regulators can be divided into 6 categories:
- Switches without voltage control => fully supported.
- Single linear range => fully supported.
- Two linear ranges, "step" and "2 * step" => fully supported.
- Two linear ranges, "step" and "5 * step" => only the first range is supported. No boards are known to use the second range.
- Non-linear voltage values => fully supported.
- LDOs shared with GPIO pins => not supported.

---

Changes in v2:
- Dual-license the driver
- Add a comment about the requirements for the voltage table
- Fix AXP22x ALDO3 enable bit position

 drivers/power/regulator/Kconfig         |  14 ++
 drivers/power/regulator/Makefile        |   1 +
 drivers/power/regulator/axp_regulator.c | 312 ++++++++++++++++++++++++
 3 files changed, 327 insertions(+)
 create mode 100644 drivers/power/regulator/axp_regulator.c
drivers/power/regulator/Kconfig +14 -0
index c02e6377d8..c346d03507 100644
@@ -43,6 +43,20 @@ config REGULATOR_AS3722
 	  but does not yet support change voltages. Currently this must be
 	  done using direct register writes to the PMIC.
 
+config REGULATOR_AXP
+	bool "Enable driver for X-Powers AXP PMIC regulators"
+	depends on DM_REGULATOR && PMIC_AXP
+	help
+	  Enable support for the regulators (DCDCs, LDOs) in the
+	  X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
+config SPL_REGULATOR_AXP
+	bool "Enable driver for X-Powers AXP PMIC regulators in SPL"
+	depends on SPL_DM_REGULATOR && SPL_PMIC_AXP
+	help
+	  Enable support in SPL for the regulators (DCDCs, LDOs) in the
+	  X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
 config DM_REGULATOR_BD71837
 	bool "Enable Driver Model for ROHM BD71837/BD71847 regulators"
 	depends on DM_REGULATOR && DM_PMIC_BD71837
drivers/power/regulator/Makefile +1 -0
index 68e4c0f9dd..2d97e1033a 100644
@@ -7,6 +7,7 @@
 obj-$(CONFIG_$(SPL_)DM_REGULATOR) += regulator-uclass.o
 obj-$(CONFIG_REGULATOR_ACT8846) += act8846.o
 obj-$(CONFIG_REGULATOR_AS3722)	+= as3722_regulator.o
+obj-$(CONFIG_$(SPL_)REGULATOR_AXP) += axp_regulator.o
 obj-$(CONFIG_$(SPL_)DM_REGULATOR_DA9063) += da9063.o
 obj-$(CONFIG_DM_REGULATOR_MAX77686) += max77686.o
 obj-$(CONFIG_DM_REGULATOR_NPCM8XX) += npcm8xx_regulator.o
drivers/power/regulator/axp_regulator.c new file +312 -0

312 lines not on this page · raw message

Signature · 1 line
2.37.4
Reviewed-by on v2 2/3
#3 lore raw

Re: [PATCH v2 2/3] power: regulator: Add a driver for AXP PMIC regulators

On Sat, 21 Jan 2023 17:13:05 -0600
Samuel Holland <[email protected]> wrote:

Hi Samuel,

Quoted 12 lines

This driver handles most voltage regulators found in X-Powers AXP PMICs. It is based on, and intended to replace, the regulator driver in TF-A.

AXP PMIC regulators can be divided into 6 categories:
- Switches without voltage control => fully supported.
- Single linear range => fully supported.
- Two linear ranges, "step" and "2 * step" => fully supported.
- Two linear ranges, "step" and "5 * step" => only the first range is supported. No boards are known to use the second range.
- Non-linear voltage values => fully supported.
- LDOs shared with GPIO pins => not supported.

Quoted 7 lines

---

Changes in v2:
- Dual-license the driver
- Add a comment about the requirements for the voltage table
- Fix AXP22x ALDO3 enable bit position

many thanks for the respin and the changes, looks good to me now:

Cheers,
Andre

Quoted 361 lines
 drivers/power/regulator/Kconfig         |  14 ++
 drivers/power/regulator/Makefile        |   1 +
 drivers/power/regulator/axp_regulator.c | 312 ++++++++++++++++++++++++
 3 files changed, 327 insertions(+)
 create mode 100644 drivers/power/regulator/axp_regulator.c
drivers/power/regulator/Kconfig +14 -0
index c02e6377d8..c346d03507 100644
@@ -43,6 +43,20 @@ config REGULATOR_AS3722
 	  but does not yet support change voltages. Currently this must be
 	  done using direct register writes to the PMIC.
 
+config REGULATOR_AXP
+	bool "Enable driver for X-Powers AXP PMIC regulators"
+	depends on DM_REGULATOR && PMIC_AXP
+	help
+	  Enable support for the regulators (DCDCs, LDOs) in the
+	  X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
+config SPL_REGULATOR_AXP
+	bool "Enable driver for X-Powers AXP PMIC regulators in SPL"
+	depends on SPL_DM_REGULATOR && SPL_PMIC_AXP
+	help
+	  Enable support in SPL for the regulators (DCDCs, LDOs) in the
+	  X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
 config DM_REGULATOR_BD71837
 	bool "Enable Driver Model for ROHM BD71837/BD71847 regulators"
 	depends on DM_REGULATOR && DM_PMIC_BD71837
drivers/power/regulator/Makefile +1 -0
index 68e4c0f9dd..2d97e1033a 100644
@@ -7,6 +7,7 @@
 obj-$(CONFIG_$(SPL_)DM_REGULATOR) += regulator-uclass.o
 obj-$(CONFIG_REGULATOR_ACT8846) += act8846.o
 obj-$(CONFIG_REGULATOR_AS3722)	+= as3722_regulator.o
+obj-$(CONFIG_$(SPL_)REGULATOR_AXP) += axp_regulator.o
 obj-$(CONFIG_$(SPL_)DM_REGULATOR_DA9063) += da9063.o
 obj-$(CONFIG_DM_REGULATOR_MAX77686) += max77686.o
 obj-$(CONFIG_DM_REGULATOR_NPCM8XX) += npcm8xx_regulator.o
drivers/power/regulator/axp_regulator.c new file +312 -0
new file mode 100644
index 0000000000..02f320eac1
@@ -0,0 +1,312 @@
+// SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
+/*
+ * Copyright (c) 2017-2019, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2018-2023 Samuel Holland <[email protected]>
+ */
+
+#include <axp_pmic.h>
+#include <dm.h>
+#include <errno.h>
+#include <dm/device-internal.h>
+#include <power/pmic.h>
+#include <power/regulator.h>
+
+#define NA 0xff
+
+struct axp_regulator_plat {
+	const char	*name;
+	u8		enable_reg;
+	u8		enable_mask;
+	u8		volt_reg;
+	u8		volt_mask;
+	u16		min_mV;
+	u16		max_mV;
+	u8		step_mV;
+	u8		split;
+	const u16	*table;
+};
+
+static int axp_regulator_get_value(struct udevice *dev)
+{
+	const struct axp_regulator_plat *plat = dev_get_plat(dev);
+	int mV, sel;
+
+	if (plat->volt_reg == NA)
+		return -EINVAL;
+
+	sel = pmic_reg_read(dev->parent, plat->volt_reg);
+	if (sel < 0)
+		return sel;
+
+	sel &= plat->volt_mask;
+	sel >>= ffs(plat->volt_mask) - 1;
+
+	if (plat->table) {
+		mV = plat->table[sel];
+	} else {
+		if (sel > plat->split)
+			sel = plat->split + (sel - plat->split) * 2;
+		mV = plat->min_mV + sel * plat->step_mV;
+	}
+
+	return mV * 1000;
+}
+
+static int axp_regulator_set_value(struct udevice *dev, int uV)
+{
+	const struct axp_regulator_plat *plat = dev_get_plat(dev);
+	int mV = uV / 1000;
+	uint sel, shift;
+
+	if (plat->volt_reg == NA)
+		return -EINVAL;
+	if (mV < plat->min_mV || mV > plat->max_mV)
+		return -EINVAL;
+
+	shift = ffs(plat->volt_mask) - 1;
+
+	if (plat->table) {
+		/*
+		 * The table must be monotonically increasing and
+		 * have an entry for each possible field value.
+		 */
+		sel = plat->volt_mask >> shift;
+		while (sel && plat->table[sel] > mV)
+			sel--;
+	} else {
+		sel = (mV - plat->min_mV) / plat->step_mV;
+		if (sel > plat->split)
+			sel = plat->split + (sel - plat->split) / 2;
+	}
+
+	return pmic_clrsetbits(dev->parent, plat->volt_reg,
+			       plat->volt_mask, sel << shift);
+}
+
+static int axp_regulator_get_enable(struct udevice *dev)
+{
+	const struct axp_regulator_plat *plat = dev_get_plat(dev);
+	int reg;
+
+	reg = pmic_reg_read(dev->parent, plat->enable_reg);
+	if (reg < 0)
+		return reg;
+
+	return (reg & plat->enable_mask) == plat->enable_mask;
+}
+
+static int axp_regulator_set_enable(struct udevice *dev, bool enable)
+{
+	const struct axp_regulator_plat *plat = dev_get_plat(dev);
+
+	return pmic_clrsetbits(dev->parent, plat->enable_reg,
+			       plat->enable_mask,
+			       enable ? plat->enable_mask : 0);
+}
+
+static const struct dm_regulator_ops axp_regulator_ops = {
+	.get_value		= axp_regulator_get_value,
+	.set_value		= axp_regulator_set_value,
+	.get_enable		= axp_regulator_get_enable,
+	.set_enable		= axp_regulator_set_enable,
+};
+
+static const u16 axp152_dcdc1_table[] = {
+	1700, 1800, 1900, 2000, 2100, 2400, 2500, 2600,
+	2700, 2800, 3000, 3100, 3200, 3300, 3400, 3500,
+};
+
+static const u16 axp152_aldo12_table[] = {
+	1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900,
+	2000, 2500, 2700, 2800, 3000, 3100, 3200, 3300,
+};
+
+static const u16 axp152_ldo0_table[] = {
+	5000, 3300, 2800, 2500,
+};
+
+static const struct axp_regulator_plat axp152_regulators[] = {
+	{ "dcdc1", 0x12, BIT(7), 0x26, 0x0f, .table = axp152_dcdc1_table },
+	{ "dcdc2", 0x12, BIT(6), 0x23, 0x3f,  700, 2275,  25, NA },
+	{ "dcdc3", 0x12, BIT(5), 0x27, 0x3f,  700, 3500,  50, NA },
+	{ "dcdc4", 0x12, BIT(4), 0x2b, 0x7f,  700, 3500,  25, NA },
+	{ "aldo1", 0x12, BIT(3), 0x28, 0xf0, .table = axp152_aldo12_table },
+	{ "aldo2", 0x12, BIT(2), 0x28, 0x0f, .table = axp152_aldo12_table },
+	{ "dldo1", 0x12, BIT(1), 0x29, 0x1f,  700, 3500, 100, NA },
+	{ "dldo2", 0x12, BIT(0), 0x2a, 0x1f,  700, 3500, 100, NA },
+	{ "ldo0",  0x15, BIT(7), 0x15, 0x30, .table = axp152_ldo0_table },
+	{ }
+};
+
+static const u16 axp20x_ldo4_table[] = {
+	1250, 1300, 1400, 1500, 1600, 1700, 1800, 1900,
+	2000, 2500, 2700, 2800, 3000, 3100, 3200, 3300,
+};
+
+static const struct axp_regulator_plat axp20x_regulators[] = {
+	{ "dcdc2", 0x12, BIT(4), 0x23, 0x3f,  700, 2275,  25, NA },
+	{ "dcdc3", 0x12, BIT(1), 0x27, 0x7f,  700, 3500,  25, NA },
+	{ "ldo2",  0x12, BIT(2), 0x28, 0xf0, 1800, 3300, 100, NA },
+	{ "ldo3",  0x12, BIT(6), 0x29, 0x7f,  700, 2275,  25, NA },
+	{ "ldo4",  0x12, BIT(3), 0x28, 0x0f, .table = axp20x_ldo4_table },
+	{ }
+};
+
+static const struct axp_regulator_plat axp22x_regulators[] = {
+	{"dc5ldo", 0x10, BIT(0), 0x1c, 0x07,  700, 1400, 100, NA },
+	{ "dcdc1", 0x10, BIT(1), 0x21, 0x1f, 1600, 3400, 100, NA },
+	{ "dcdc2", 0x10, BIT(2), 0x22, 0x3f,  600, 1540,  20, NA },
+	{ "dcdc3", 0x10, BIT(3), 0x23, 0x3f,  600, 1860,  20, NA },
+	{ "dcdc4", 0x10, BIT(4), 0x24, 0x3f,  600, 1540,  20, NA },
+	{ "dcdc5", 0x10, BIT(5), 0x25, 0x1f, 1000, 2550,  50, NA },
+	{ "aldo1", 0x10, BIT(6), 0x28, 0x1f,  700, 3300, 100, NA },
+	{ "aldo2", 0x10, BIT(7), 0x29, 0x1f,  700, 3300, 100, NA },
+	{ "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+	{ "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+	{ "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 3300, 100, NA },
+	{ "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+	{ "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+	{ "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 3300, 100, NA },
+	{ "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 3300, 100, NA },
+	{ "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 3300, 100, NA },
+	{ "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+	{ }
+};
+
+static const struct axp_regulator_plat axp803_regulators[] = {
+	{ "dcdc1", 0x10, BIT(0), 0x20, 0x1f, 1600, 3400, 100, NA },
+	{ "dcdc2", 0x10, BIT(1), 0x21, 0x7f,  500, 1300,  10, 70 },
+	{ "dcdc3", 0x10, BIT(2), 0x22, 0x7f,  500, 1300,  10, 70 },
+	{ "dcdc4", 0x10, BIT(3), 0x23, 0x7f,  500, 1300,  10, 70 },
+	{ "dcdc5", 0x10, BIT(4), 0x24, 0x7f,  800, 1840,  10, 32 },
+	{ "dcdc6", 0x10, BIT(5), 0x25, 0x7f,  600, 1520,  10, 50 },
+	{ "aldo1", 0x13, BIT(5), 0x28, 0x1f,  700, 3300, 100, NA },
+	{ "aldo2", 0x13, BIT(6), 0x29, 0x1f,  700, 3300, 100, NA },
+	{ "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+	{ "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+	{ "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 4200, 100, 27 },
+	{ "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+	{ "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+	{ "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 1900,  50, NA },
+	{ "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 1900,  50, NA },
+	{ "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 1900,  50, NA },
+	{ "fldo1", 0x13, BIT(2), 0x1c, 0x0f,  700, 1450,  50, NA },
+	{ "fldo2", 0x13, BIT(3), 0x1d, 0x0f,  700, 1450,  50, NA },
+	{ "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+	{ }
+};
+
+/*
+ * The "dcdcd" split changes the step size by a factor of 5, not 2;
+ * disallow values above the split to maintain accuracy.
+ */
+static const struct axp_regulator_plat axp806_regulators[] = {
+	{ "dcdca", 0x10, BIT(0), 0x12, 0x7f,  600, 1520,  10, 50 },
+	{ "dcdcb", 0x10, BIT(1), 0x13, 0x1f, 1000, 2550,  50, NA },
+	{ "dcdcc", 0x10, BIT(2), 0x14, 0x7f,  600, 1520,  10, 50 },
+	{ "dcdcd", 0x10, BIT(3), 0x15, 0x3f,  600, 1500,  20, NA },
+	{ "dcdce", 0x10, BIT(4), 0x16, 0x1f, 1100, 3400, 100, NA },
+	{ "aldo1", 0x10, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+	{ "aldo2", 0x10, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+	{ "aldo3", 0x10, BIT(7), 0x19, 0x1f,  700, 3300, 100, NA },
+	{ "bldo1", 0x11, BIT(0), 0x20, 0x0f,  700, 1900, 100, NA },
+	{ "bldo2", 0x11, BIT(1), 0x21, 0x0f,  700, 1900, 100, NA },
+	{ "bldo3", 0x11, BIT(2), 0x22, 0x0f,  700, 1900, 100, NA },
+	{ "bldo4", 0x11, BIT(3), 0x23, 0x0f,  700, 1900, 100, NA },
+	{ "cldo1", 0x11, BIT(4), 0x24, 0x1f,  700, 3300, 100, NA },
+	{ "cldo2", 0x11, BIT(5), 0x25, 0x1f,  700, 4200, 100, 27 },
+	{ "cldo3", 0x11, BIT(6), 0x26, 0x1f,  700, 3300, 100, NA },
+	{ "sw",    0x11, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+	{ }
+};
+
+/*
+ * The "dcdc4" split changes the step size by a factor of 5, not 2;
+ * disallow values above the split to maintain accuracy.
+ */
+static const struct axp_regulator_plat axp809_regulators[] = {
+	{"dc5ldo", 0x10, BIT(0), 0x1c, 0x07,  700, 1400, 100, NA },
+	{ "dcdc1", 0x10, BIT(1), 0x21, 0x1f, 1600, 3400, 100, NA },
+	{ "dcdc2", 0x10, BIT(2), 0x22, 0x3f,  600, 1540,  20, NA },
+	{ "dcdc3", 0x10, BIT(3), 0x23, 0x3f,  600, 1860,  20, NA },
+	{ "dcdc4", 0x10, BIT(4), 0x24, 0x3f,  600, 1540,  20, NA },
+	{ "dcdc5", 0x10, BIT(5), 0x25, 0x1f, 1000, 2550,  50, NA },
+	{ "aldo1", 0x10, BIT(6), 0x28, 0x1f,  700, 3300, 100, NA },
+	{ "aldo2", 0x10, BIT(7), 0x29, 0x1f,  700, 3300, 100, NA },
+	{ "aldo3", 0x12, BIT(5), 0x2a, 0x1f,  700, 3300, 100, NA },
+	{ "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+	{ "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 3300, 100, NA },
+	{ "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 3300, 100, NA },
+	{ "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 3300, 100, NA },
+	{ "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 3300, 100, NA },
+	{ "sw",    0x12, BIT(6),   NA,   NA,   NA,   NA,  NA, NA },
+	{ "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+	{ }
+};
+
+static const struct axp_regulator_plat axp813_regulators[] = {
+	{ "dcdc1", 0x10, BIT(0), 0x20, 0x1f, 1600, 3400, 100, NA },
+	{ "dcdc2", 0x10, BIT(1), 0x21, 0x7f,  500, 1300,  10, 70 },
+	{ "dcdc3", 0x10, BIT(2), 0x22, 0x7f,  500, 1300,  10, 70 },
+	{ "dcdc4", 0x10, BIT(3), 0x23, 0x7f,  500, 1300,  10, 70 },
+	{ "dcdc5", 0x10, BIT(4), 0x24, 0x7f,  800, 1840,  10, 32 },
+	{ "dcdc6", 0x10, BIT(5), 0x25, 0x7f,  600, 1520,  10, 50 },
+	{ "dcdc7", 0x10, BIT(6), 0x26, 0x7f,  600, 1520,  10, 50 },
+	{ "aldo1", 0x13, BIT(5), 0x28, 0x1f,  700, 3300, 100, NA },
+	{ "aldo2", 0x13, BIT(6), 0x29, 0x1f,  700, 3300, 100, NA },
+	{ "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+	{ "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+	{ "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 4200, 100, 27 },
+	{ "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+	{ "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+	{ "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 1900,  50, NA },
+	{ "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 1900,  50, NA },
+	{ "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 1900,  50, NA },
+	{ "fldo1", 0x13, BIT(2), 0x1c, 0x0f,  700, 1450,  50, NA },
+	{ "fldo2", 0x13, BIT(3), 0x1d, 0x0f,  700, 1450,  50, NA },
+	{ "fldo3", 0x13, BIT(4),   NA,   NA,   NA,   NA,  NA, NA },
+	{ }
+};
+
+static const struct axp_regulator_plat *const axp_regulators[] = {
+	[AXP152_ID]	= axp152_regulators,
+	[AXP202_ID]	= axp20x_regulators,
+	[AXP209_ID]	= axp20x_regulators,
+	[AXP221_ID]	= axp22x_regulators,
+	[AXP223_ID]	= axp22x_regulators,
+	[AXP803_ID]	= axp803_regulators,
+	[AXP806_ID]	= axp806_regulators,
+	[AXP809_ID]	= axp809_regulators,
+	[AXP813_ID]	= axp813_regulators,
+};
+
+static int axp_regulator_bind(struct udevice *dev)
+{
+	struct dm_regulator_uclass_plat *uc_plat = dev_get_uclass_plat(dev);
+	ulong id = dev_get_driver_data(dev->parent);
+	const struct axp_regulator_plat *plat;
+
+	for (plat = axp_regulators[id]; plat && plat->name; plat++)
+		if (!strcmp(plat->name, dev->name))
+			break;
+	if (!plat || !plat->name)
+		return -ENODEV;
+
+	dev_set_plat(dev, (void *)plat);
+
+	if (plat->volt_reg == NA)
+		uc_plat->type = REGULATOR_TYPE_FIXED;
+	else if (!strncmp(plat->name, "dcdc", strlen("dcdc")))
+		uc_plat->type = REGULATOR_TYPE_BUCK;
+	else
+		uc_plat->type = REGULATOR_TYPE_LDO;
+
+	return 0;
+}
+
+U_BOOT_DRIVER(axp_regulator) = {
+	.name		= "axp_regulator",
+	.id		= UCLASS_REGULATOR,
+	.bind		= axp_regulator_bind,
+	.ops		= &axp_regulator_ops,
+};
#4 lore raw

Re: [PATCH v2 2/3] power: regulator: Add a driver for AXP PMIC regulators

In reply to Samuel Holland

Hi Samuel,

Quoted 87 lines · Samuel Holland

This driver handles most voltage regulators found in X-Powers AXP PMICs. It is based on, and intended to replace, the regulator driver in TF-A.

AXP PMIC regulators can be divided into 6 categories:
- Switches without voltage control => fully supported.
- Single linear range => fully supported.
- Two linear ranges, "step" and "2 * step" => fully supported.
- Two linear ranges, "step" and "5 * step" => only the first range is supported. No boards are known to use the second range.
- Non-linear voltage values => fully supported.
- LDOs shared with GPIO pins => not supported.

---

Changes in v2:
- Dual-license the driver
- Add a comment about the requirements for the voltage table
- Fix AXP22x ALDO3 enable bit position

 drivers/power/regulator/Kconfig         |  14 ++
 drivers/power/regulator/Makefile        |   1 +
 drivers/power/regulator/axp_regulator.c | 312 ++++++++++++++++++++++++
 3 files changed, 327 insertions(+)
 create mode 100644 drivers/power/regulator/axp_regulator.c
drivers/power/regulator/Kconfig +14 -0
index c02e6377d8..c346d03507 100644
@@ -43,6 +43,20 @@ config REGULATOR_AS3722
          but does not yet support change voltages. Currently this must be
          done using direct register writes to the PMIC.
 
+config REGULATOR_AXP
+       bool "Enable driver for X-Powers AXP PMIC regulators"
+       depends on DM_REGULATOR && PMIC_AXP
+       help
+         Enable support for the regulators (DCDCs, LDOs) in the
+         X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
+config SPL_REGULATOR_AXP
+       bool "Enable driver for X-Powers AXP PMIC regulators in SPL"
+       depends on SPL_DM_REGULATOR && SPL_PMIC_AXP
+       help
+         Enable support in SPL for the regulators (DCDCs, LDOs) in the
+         X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
 config DM_REGULATOR_BD71837
        bool "Enable Driver Model for ROHM BD71837/BD71847 regulators"
        depends on DM_REGULATOR && DM_PMIC_BD71837
drivers/power/regulator/Makefile +1 -0
index 68e4c0f9dd..2d97e1033a 100644
@@ -7,6 +7,7 @@
 obj-$(CONFIG_$(SPL_)DM_REGULATOR) += regulator-uclass.o
 obj-$(CONFIG_REGULATOR_ACT8846) += act8846.o
 obj-$(CONFIG_REGULATOR_AS3722) += as3722_regulator.o
+obj-$(CONFIG_$(SPL_)REGULATOR_AXP) += axp_regulator.o
 obj-$(CONFIG_$(SPL_)DM_REGULATOR_DA9063) += da9063.o
 obj-$(CONFIG_DM_REGULATOR_MAX77686) += max77686.o
 obj-$(CONFIG_DM_REGULATOR_NPCM8XX) += npcm8xx_regulator.o
drivers/power/regulator/axp_regulator.c new file +17 -0
new file mode 100644
index 0000000000..02f320eac1
@@ -0,0 +1,312 @@
+// SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
+/*
+ * Copyright (c) 2017-2019, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2018-2023 Samuel Holland <[email protected]>
+ */
+
+#include <axp_pmic.h>
+#include <dm.h>
+#include <errno.h>
+#include <dm/device-internal.h>
+#include <power/pmic.h>
+#include <power/regulator.h>
+
+#define NA 0xff
+
+struct axp_regulator_plat {
+       const char      *name;

drivers/power/regulator/axp_regulator.c line 27

Quoted 10 lines
drivers/power/regulator/axp_regulator.c new file +10 -0
+       u8              enable_reg;
+       u8              enable_mask;
+       u8              volt_reg;
+       u8              volt_mask;
+       u16             min_mV;
+       u16             max_mV;
+       u8              step_mV;
+       u8              split;
+       const u16       *table;
+};

Please comment struct

Quoted 258 lines
drivers/power/regulator/axp_regulator.c new file +258 -0
+
+static int axp_regulator_get_value(struct udevice *dev)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+       int mV, sel;
+
+       if (plat->volt_reg == NA)
+               return -EINVAL;
+
+       sel = pmic_reg_read(dev->parent, plat->volt_reg);
+       if (sel < 0)
+               return sel;
+
+       sel &= plat->volt_mask;
+       sel >>= ffs(plat->volt_mask) - 1;
+
+       if (plat->table) {
+               mV = plat->table[sel];
+       } else {
+               if (sel > plat->split)
+                       sel = plat->split + (sel - plat->split) * 2;
+               mV = plat->min_mV + sel * plat->step_mV;
+       }
+
+       return mV * 1000;
+}
+
+static int axp_regulator_set_value(struct udevice *dev, int uV)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+       int mV = uV / 1000;
+       uint sel, shift;
+
+       if (plat->volt_reg == NA)
+               return -EINVAL;
+       if (mV < plat->min_mV || mV > plat->max_mV)
+               return -EINVAL;
+
+       shift = ffs(plat->volt_mask) - 1;
+
+       if (plat->table) {
+               /*
+                * The table must be monotonically increasing and
+                * have an entry for each possible field value.
+                */
+               sel = plat->volt_mask >> shift;
+               while (sel && plat->table[sel] > mV)
+                       sel--;
+       } else {
+               sel = (mV - plat->min_mV) / plat->step_mV;
+               if (sel > plat->split)
+                       sel = plat->split + (sel - plat->split) / 2;
+       }
+
+       return pmic_clrsetbits(dev->parent, plat->volt_reg,
+                              plat->volt_mask, sel << shift);
+}
+
+static int axp_regulator_get_enable(struct udevice *dev)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+       int reg;
+
+       reg = pmic_reg_read(dev->parent, plat->enable_reg);
+       if (reg < 0)
+               return reg;
+
+       return (reg & plat->enable_mask) == plat->enable_mask;
+}
+
+static int axp_regulator_set_enable(struct udevice *dev, bool enable)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+
+       return pmic_clrsetbits(dev->parent, plat->enable_reg,
+                              plat->enable_mask,
+                              enable ? plat->enable_mask : 0);
+}
+
+static const struct dm_regulator_ops axp_regulator_ops = {
+       .get_value              = axp_regulator_get_value,
+       .set_value              = axp_regulator_set_value,
+       .get_enable             = axp_regulator_get_enable,
+       .set_enable             = axp_regulator_set_enable,
+};
+
+static const u16 axp152_dcdc1_table[] = {
+       1700, 1800, 1900, 2000, 2100, 2400, 2500, 2600,
+       2700, 2800, 3000, 3100, 3200, 3300, 3400, 3500,
+};
+
+static const u16 axp152_aldo12_table[] = {
+       1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900,
+       2000, 2500, 2700, 2800, 3000, 3100, 3200, 3300,
+};
+
+static const u16 axp152_ldo0_table[] = {
+       5000, 3300, 2800, 2500,
+};
+
+static const struct axp_regulator_plat axp152_regulators[] = {
+       { "dcdc1", 0x12, BIT(7), 0x26, 0x0f, .table = axp152_dcdc1_table },
+       { "dcdc2", 0x12, BIT(6), 0x23, 0x3f,  700, 2275,  25, NA },
+       { "dcdc3", 0x12, BIT(5), 0x27, 0x3f,  700, 3500,  50, NA },
+       { "dcdc4", 0x12, BIT(4), 0x2b, 0x7f,  700, 3500,  25, NA },
+       { "aldo1", 0x12, BIT(3), 0x28, 0xf0, .table = axp152_aldo12_table },
+       { "aldo2", 0x12, BIT(2), 0x28, 0x0f, .table = axp152_aldo12_table },
+       { "dldo1", 0x12, BIT(1), 0x29, 0x1f,  700, 3500, 100, NA },
+       { "dldo2", 0x12, BIT(0), 0x2a, 0x1f,  700, 3500, 100, NA },
+       { "ldo0",  0x15, BIT(7), 0x15, 0x30, .table = axp152_ldo0_table },
+       { }
+};
+
+static const u16 axp20x_ldo4_table[] = {
+       1250, 1300, 1400, 1500, 1600, 1700, 1800, 1900,
+       2000, 2500, 2700, 2800, 3000, 3100, 3200, 3300,
+};
+
+static const struct axp_regulator_plat axp20x_regulators[] = {
+       { "dcdc2", 0x12, BIT(4), 0x23, 0x3f,  700, 2275,  25, NA },
+       { "dcdc3", 0x12, BIT(1), 0x27, 0x7f,  700, 3500,  25, NA },
+       { "ldo2",  0x12, BIT(2), 0x28, 0xf0, 1800, 3300, 100, NA },
+       { "ldo3",  0x12, BIT(6), 0x29, 0x7f,  700, 2275,  25, NA },
+       { "ldo4",  0x12, BIT(3), 0x28, 0x0f, .table = axp20x_ldo4_table },
+       { }
+};
+
+static const struct axp_regulator_plat axp22x_regulators[] = {
+       {"dc5ldo", 0x10, BIT(0), 0x1c, 0x07,  700, 1400, 100, NA },
+       { "dcdc1", 0x10, BIT(1), 0x21, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(2), 0x22, 0x3f,  600, 1540,  20, NA },
+       { "dcdc3", 0x10, BIT(3), 0x23, 0x3f,  600, 1860,  20, NA },
+       { "dcdc4", 0x10, BIT(4), 0x24, 0x3f,  600, 1540,  20, NA },
+       { "dcdc5", 0x10, BIT(5), 0x25, 0x1f, 1000, 2550,  50, NA },
+       { "aldo1", 0x10, BIT(6), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x10, BIT(7), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 3300, 100, NA },
+       { "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 3300, 100, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 3300, 100, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 3300, 100, NA },
+       { "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+static const struct axp_regulator_plat axp803_regulators[] = {
+       { "dcdc1", 0x10, BIT(0), 0x20, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(1), 0x21, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc3", 0x10, BIT(2), 0x22, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc4", 0x10, BIT(3), 0x23, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc5", 0x10, BIT(4), 0x24, 0x7f,  800, 1840,  10, 32 },
+       { "dcdc6", 0x10, BIT(5), 0x25, 0x7f,  600, 1520,  10, 50 },
+       { "aldo1", 0x13, BIT(5), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x13, BIT(6), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 4200, 100, 27 },
+       { "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 1900,  50, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 1900,  50, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 1900,  50, NA },
+       { "fldo1", 0x13, BIT(2), 0x1c, 0x0f,  700, 1450,  50, NA },
+       { "fldo2", 0x13, BIT(3), 0x1d, 0x0f,  700, 1450,  50, NA },
+       { "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+/*
+ * The "dcdcd" split changes the step size by a factor of 5, not 2;
+ * disallow values above the split to maintain accuracy.
+ */
+static const struct axp_regulator_plat axp806_regulators[] = {
+       { "dcdca", 0x10, BIT(0), 0x12, 0x7f,  600, 1520,  10, 50 },
+       { "dcdcb", 0x10, BIT(1), 0x13, 0x1f, 1000, 2550,  50, NA },
+       { "dcdcc", 0x10, BIT(2), 0x14, 0x7f,  600, 1520,  10, 50 },
+       { "dcdcd", 0x10, BIT(3), 0x15, 0x3f,  600, 1500,  20, NA },
+       { "dcdce", 0x10, BIT(4), 0x16, 0x1f, 1100, 3400, 100, NA },
+       { "aldo1", 0x10, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x10, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x10, BIT(7), 0x19, 0x1f,  700, 3300, 100, NA },
+       { "bldo1", 0x11, BIT(0), 0x20, 0x0f,  700, 1900, 100, NA },
+       { "bldo2", 0x11, BIT(1), 0x21, 0x0f,  700, 1900, 100, NA },
+       { "bldo3", 0x11, BIT(2), 0x22, 0x0f,  700, 1900, 100, NA },
+       { "bldo4", 0x11, BIT(3), 0x23, 0x0f,  700, 1900, 100, NA },
+       { "cldo1", 0x11, BIT(4), 0x24, 0x1f,  700, 3300, 100, NA },
+       { "cldo2", 0x11, BIT(5), 0x25, 0x1f,  700, 4200, 100, 27 },
+       { "cldo3", 0x11, BIT(6), 0x26, 0x1f,  700, 3300, 100, NA },
+       { "sw",    0x11, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+/*
+ * The "dcdc4" split changes the step size by a factor of 5, not 2;
+ * disallow values above the split to maintain accuracy.
+ */
+static const struct axp_regulator_plat axp809_regulators[] = {
+       {"dc5ldo", 0x10, BIT(0), 0x1c, 0x07,  700, 1400, 100, NA },
+       { "dcdc1", 0x10, BIT(1), 0x21, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(2), 0x22, 0x3f,  600, 1540,  20, NA },
+       { "dcdc3", 0x10, BIT(3), 0x23, 0x3f,  600, 1860,  20, NA },
+       { "dcdc4", 0x10, BIT(4), 0x24, 0x3f,  600, 1540,  20, NA },
+       { "dcdc5", 0x10, BIT(5), 0x25, 0x1f, 1000, 2550,  50, NA },
+       { "aldo1", 0x10, BIT(6), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x10, BIT(7), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x12, BIT(5), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 3300, 100, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 3300, 100, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 3300, 100, NA },
+       { "sw",    0x12, BIT(6),   NA,   NA,   NA,   NA,  NA, NA },
+       { "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+static const struct axp_regulator_plat axp813_regulators[] = {
+       { "dcdc1", 0x10, BIT(0), 0x20, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(1), 0x21, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc3", 0x10, BIT(2), 0x22, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc4", 0x10, BIT(3), 0x23, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc5", 0x10, BIT(4), 0x24, 0x7f,  800, 1840,  10, 32 },
+       { "dcdc6", 0x10, BIT(5), 0x25, 0x7f,  600, 1520,  10, 50 },
+       { "dcdc7", 0x10, BIT(6), 0x26, 0x7f,  600, 1520,  10, 50 },
+       { "aldo1", 0x13, BIT(5), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x13, BIT(6), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 4200, 100, 27 },
+       { "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 1900,  50, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 1900,  50, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 1900,  50, NA },
+       { "fldo1", 0x13, BIT(2), 0x1c, 0x0f,  700, 1450,  50, NA },
+       { "fldo2", 0x13, BIT(3), 0x1d, 0x0f,  700, 1450,  50, NA },
+       { "fldo3", 0x13, BIT(4),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+static const struct axp_regulator_plat *const axp_regulators[] = {
+       [AXP152_ID]     = axp152_regulators,
+       [AXP202_ID]     = axp20x_regulators,
+       [AXP209_ID]     = axp20x_regulators,
+       [AXP221_ID]     = axp22x_regulators,
+       [AXP223_ID]     = axp22x_regulators,
+       [AXP803_ID]     = axp803_regulators,
+       [AXP806_ID]     = axp806_regulators,
+       [AXP809_ID]     = axp809_regulators,
+       [AXP813_ID]     = axp813_regulators,
+};
+
+static int axp_regulator_bind(struct udevice *dev)
+{
+       struct dm_regulator_uclass_plat *uc_plat = dev_get_uclass_plat(dev);

drivers/power/regulator/axp_regulator.c line 295

Quoted 10 lines
drivers/power/regulator/axp_regulator.c new file +10 -0
+       ulong id = dev_get_driver_data(dev->parent);
+       const struct axp_regulator_plat *plat;
+
+       for (plat = axp_regulators[id]; plat && plat->name; plat++)
+               if (!strcmp(plat->name, dev->name))
+                       break;
+       if (!plat || !plat->name)
+               return -ENODEV;
+
+       dev_set_plat(dev, (void *)plat);

Wow this is really wacky.

Where is the compatible string?

Quoted 18 lines
drivers/power/regulator/axp_regulator.c new file +17 -1
+
+       if (plat->volt_reg == NA)
+               uc_plat->type = REGULATOR_TYPE_FIXED;
+       else if (!strncmp(plat->name, "dcdc", strlen("dcdc")))
+               uc_plat->type = REGULATOR_TYPE_BUCK;
+       else
+               uc_plat->type = REGULATOR_TYPE_LDO;
+
+       return 0;
+}
+
+U_BOOT_DRIVER(axp_regulator) = {
+       .name           = "axp_regulator",
+       .id             = UCLASS_REGULATOR,
+       .bind           = axp_regulator_bind,
+       .ops            = &axp_regulator_ops,
+};
--
Quoted 2 lines

2.37.4

Regards,
Simon

#5 lore raw

Re: [PATCH v2 2/3] power: regulator: Add a driver for AXP PMIC regulators

On Mon, 23 Jan 2023 11:49:53 -0700
Simon Glass <[email protected]> wrote:

Hi Simon,

Quoted 372 lines · Samuel Holland
Quoted 87 lines

This driver handles most voltage regulators found in X-Powers AXP PMICs. It is based on, and intended to replace, the regulator driver in TF-A.

AXP PMIC regulators can be divided into 6 categories:
- Switches without voltage control => fully supported.
- Single linear range => fully supported.
- Two linear ranges, "step" and "2 * step" => fully supported.
- Two linear ranges, "step" and "5 * step" => only the first range is supported. No boards are known to use the second range.
- Non-linear voltage values => fully supported.
- LDOs shared with GPIO pins => not supported.

---

Changes in v2:
- Dual-license the driver
- Add a comment about the requirements for the voltage table
- Fix AXP22x ALDO3 enable bit position

 drivers/power/regulator/Kconfig         |  14 ++
 drivers/power/regulator/Makefile        |   1 +
 drivers/power/regulator/axp_regulator.c | 312 ++++++++++++++++++++++++
 3 files changed, 327 insertions(+)
 create mode 100644 drivers/power/regulator/axp_regulator.c
drivers/power/regulator/Kconfig +14 -0
index c02e6377d8..c346d03507 100644
@@ -43,6 +43,20 @@ config REGULATOR_AS3722
          but does not yet support change voltages. Currently this must be
          done using direct register writes to the PMIC.
 
+config REGULATOR_AXP
+       bool "Enable driver for X-Powers AXP PMIC regulators"
+       depends on DM_REGULATOR && PMIC_AXP
+       help
+         Enable support for the regulators (DCDCs, LDOs) in the
+         X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
+config SPL_REGULATOR_AXP
+       bool "Enable driver for X-Powers AXP PMIC regulators in SPL"
+       depends on SPL_DM_REGULATOR && SPL_PMIC_AXP
+       help
+         Enable support in SPL for the regulators (DCDCs, LDOs) in the
+         X-Powers AXP152, AXP2xx, and AXP8xx PMICs.
+
 config DM_REGULATOR_BD71837
        bool "Enable Driver Model for ROHM BD71837/BD71847 regulators"
        depends on DM_REGULATOR && DM_PMIC_BD71837
drivers/power/regulator/Makefile +1 -0
index 68e4c0f9dd..2d97e1033a 100644
@@ -7,6 +7,7 @@
 obj-$(CONFIG_$(SPL_)DM_REGULATOR) += regulator-uclass.o
 obj-$(CONFIG_REGULATOR_ACT8846) += act8846.o
 obj-$(CONFIG_REGULATOR_AS3722) += as3722_regulator.o
+obj-$(CONFIG_$(SPL_)REGULATOR_AXP) += axp_regulator.o
 obj-$(CONFIG_$(SPL_)DM_REGULATOR_DA9063) += da9063.o
 obj-$(CONFIG_DM_REGULATOR_MAX77686) += max77686.o
 obj-$(CONFIG_DM_REGULATOR_NPCM8XX) += npcm8xx_regulator.o
drivers/power/regulator/axp_regulator.c new file +17 -0
new file mode 100644
index 0000000000..02f320eac1
@@ -0,0 +1,312 @@
+// SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
+/*
+ * Copyright (c) 2017-2019, ARM Limited and Contributors. All rights reserved.
+ * Copyright (c) 2018-2023 Samuel Holland <[email protected]>
+ */
+
+#include <axp_pmic.h>
+#include <dm.h>
+#include <errno.h>
+#include <dm/device-internal.h>
+#include <power/pmic.h>
+#include <power/regulator.h>
+
+#define NA 0xff
+
+struct axp_regulator_plat {
+       const char      *name;

drivers/power/regulator/axp_regulator.c line 27

Quoted 10 lines
drivers/power/regulator/axp_regulator.c new file +10 -0
+       u8              enable_reg;
+       u8              enable_mask;
+       u8              volt_reg;
+       u8              volt_mask;
+       u16             min_mV;
+       u16             max_mV;
+       u8              step_mV;
+       u8              split;
+       const u16       *table;
+};  

Please comment struct

Quoted 258 lines
drivers/power/regulator/axp_regulator.c new file +258 -0
+
+static int axp_regulator_get_value(struct udevice *dev)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+       int mV, sel;
+
+       if (plat->volt_reg == NA)
+               return -EINVAL;
+
+       sel = pmic_reg_read(dev->parent, plat->volt_reg);
+       if (sel < 0)
+               return sel;
+
+       sel &= plat->volt_mask;
+       sel >>= ffs(plat->volt_mask) - 1;
+
+       if (plat->table) {
+               mV = plat->table[sel];
+       } else {
+               if (sel > plat->split)
+                       sel = plat->split + (sel - plat->split) * 2;
+               mV = plat->min_mV + sel * plat->step_mV;
+       }
+
+       return mV * 1000;
+}
+
+static int axp_regulator_set_value(struct udevice *dev, int uV)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+       int mV = uV / 1000;
+       uint sel, shift;
+
+       if (plat->volt_reg == NA)
+               return -EINVAL;
+       if (mV < plat->min_mV || mV > plat->max_mV)
+               return -EINVAL;
+
+       shift = ffs(plat->volt_mask) - 1;
+
+       if (plat->table) {
+               /*
+                * The table must be monotonically increasing and
+                * have an entry for each possible field value.
+                */
+               sel = plat->volt_mask >> shift;
+               while (sel && plat->table[sel] > mV)
+                       sel--;
+       } else {
+               sel = (mV - plat->min_mV) / plat->step_mV;
+               if (sel > plat->split)
+                       sel = plat->split + (sel - plat->split) / 2;
+       }
+
+       return pmic_clrsetbits(dev->parent, plat->volt_reg,
+                              plat->volt_mask, sel << shift);
+}
+
+static int axp_regulator_get_enable(struct udevice *dev)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+       int reg;
+
+       reg = pmic_reg_read(dev->parent, plat->enable_reg);
+       if (reg < 0)
+               return reg;
+
+       return (reg & plat->enable_mask) == plat->enable_mask;
+}
+
+static int axp_regulator_set_enable(struct udevice *dev, bool enable)
+{
+       const struct axp_regulator_plat *plat = dev_get_plat(dev);
+
+       return pmic_clrsetbits(dev->parent, plat->enable_reg,
+                              plat->enable_mask,
+                              enable ? plat->enable_mask : 0);
+}
+
+static const struct dm_regulator_ops axp_regulator_ops = {
+       .get_value              = axp_regulator_get_value,
+       .set_value              = axp_regulator_set_value,
+       .get_enable             = axp_regulator_get_enable,
+       .set_enable             = axp_regulator_set_enable,
+};
+
+static const u16 axp152_dcdc1_table[] = {
+       1700, 1800, 1900, 2000, 2100, 2400, 2500, 2600,
+       2700, 2800, 3000, 3100, 3200, 3300, 3400, 3500,
+};
+
+static const u16 axp152_aldo12_table[] = {
+       1200, 1300, 1400, 1500, 1600, 1700, 1800, 1900,
+       2000, 2500, 2700, 2800, 3000, 3100, 3200, 3300,
+};
+
+static const u16 axp152_ldo0_table[] = {
+       5000, 3300, 2800, 2500,
+};
+
+static const struct axp_regulator_plat axp152_regulators[] = {
+       { "dcdc1", 0x12, BIT(7), 0x26, 0x0f, .table = axp152_dcdc1_table },
+       { "dcdc2", 0x12, BIT(6), 0x23, 0x3f,  700, 2275,  25, NA },
+       { "dcdc3", 0x12, BIT(5), 0x27, 0x3f,  700, 3500,  50, NA },
+       { "dcdc4", 0x12, BIT(4), 0x2b, 0x7f,  700, 3500,  25, NA },
+       { "aldo1", 0x12, BIT(3), 0x28, 0xf0, .table = axp152_aldo12_table },
+       { "aldo2", 0x12, BIT(2), 0x28, 0x0f, .table = axp152_aldo12_table },
+       { "dldo1", 0x12, BIT(1), 0x29, 0x1f,  700, 3500, 100, NA },
+       { "dldo2", 0x12, BIT(0), 0x2a, 0x1f,  700, 3500, 100, NA },
+       { "ldo0",  0x15, BIT(7), 0x15, 0x30, .table = axp152_ldo0_table },
+       { }
+};
+
+static const u16 axp20x_ldo4_table[] = {
+       1250, 1300, 1400, 1500, 1600, 1700, 1800, 1900,
+       2000, 2500, 2700, 2800, 3000, 3100, 3200, 3300,
+};
+
+static const struct axp_regulator_plat axp20x_regulators[] = {
+       { "dcdc2", 0x12, BIT(4), 0x23, 0x3f,  700, 2275,  25, NA },
+       { "dcdc3", 0x12, BIT(1), 0x27, 0x7f,  700, 3500,  25, NA },
+       { "ldo2",  0x12, BIT(2), 0x28, 0xf0, 1800, 3300, 100, NA },
+       { "ldo3",  0x12, BIT(6), 0x29, 0x7f,  700, 2275,  25, NA },
+       { "ldo4",  0x12, BIT(3), 0x28, 0x0f, .table = axp20x_ldo4_table },
+       { }
+};
+
+static const struct axp_regulator_plat axp22x_regulators[] = {
+       {"dc5ldo", 0x10, BIT(0), 0x1c, 0x07,  700, 1400, 100, NA },
+       { "dcdc1", 0x10, BIT(1), 0x21, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(2), 0x22, 0x3f,  600, 1540,  20, NA },
+       { "dcdc3", 0x10, BIT(3), 0x23, 0x3f,  600, 1860,  20, NA },
+       { "dcdc4", 0x10, BIT(4), 0x24, 0x3f,  600, 1540,  20, NA },
+       { "dcdc5", 0x10, BIT(5), 0x25, 0x1f, 1000, 2550,  50, NA },
+       { "aldo1", 0x10, BIT(6), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x10, BIT(7), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 3300, 100, NA },
+       { "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 3300, 100, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 3300, 100, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 3300, 100, NA },
+       { "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+static const struct axp_regulator_plat axp803_regulators[] = {
+       { "dcdc1", 0x10, BIT(0), 0x20, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(1), 0x21, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc3", 0x10, BIT(2), 0x22, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc4", 0x10, BIT(3), 0x23, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc5", 0x10, BIT(4), 0x24, 0x7f,  800, 1840,  10, 32 },
+       { "dcdc6", 0x10, BIT(5), 0x25, 0x7f,  600, 1520,  10, 50 },
+       { "aldo1", 0x13, BIT(5), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x13, BIT(6), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 4200, 100, 27 },
+       { "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 1900,  50, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 1900,  50, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 1900,  50, NA },
+       { "fldo1", 0x13, BIT(2), 0x1c, 0x0f,  700, 1450,  50, NA },
+       { "fldo2", 0x13, BIT(3), 0x1d, 0x0f,  700, 1450,  50, NA },
+       { "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+/*
+ * The "dcdcd" split changes the step size by a factor of 5, not 2;
+ * disallow values above the split to maintain accuracy.
+ */
+static const struct axp_regulator_plat axp806_regulators[] = {
+       { "dcdca", 0x10, BIT(0), 0x12, 0x7f,  600, 1520,  10, 50 },
+       { "dcdcb", 0x10, BIT(1), 0x13, 0x1f, 1000, 2550,  50, NA },
+       { "dcdcc", 0x10, BIT(2), 0x14, 0x7f,  600, 1520,  10, 50 },
+       { "dcdcd", 0x10, BIT(3), 0x15, 0x3f,  600, 1500,  20, NA },
+       { "dcdce", 0x10, BIT(4), 0x16, 0x1f, 1100, 3400, 100, NA },
+       { "aldo1", 0x10, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x10, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x10, BIT(7), 0x19, 0x1f,  700, 3300, 100, NA },
+       { "bldo1", 0x11, BIT(0), 0x20, 0x0f,  700, 1900, 100, NA },
+       { "bldo2", 0x11, BIT(1), 0x21, 0x0f,  700, 1900, 100, NA },
+       { "bldo3", 0x11, BIT(2), 0x22, 0x0f,  700, 1900, 100, NA },
+       { "bldo4", 0x11, BIT(3), 0x23, 0x0f,  700, 1900, 100, NA },
+       { "cldo1", 0x11, BIT(4), 0x24, 0x1f,  700, 3300, 100, NA },
+       { "cldo2", 0x11, BIT(5), 0x25, 0x1f,  700, 4200, 100, 27 },
+       { "cldo3", 0x11, BIT(6), 0x26, 0x1f,  700, 3300, 100, NA },
+       { "sw",    0x11, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+/*
+ * The "dcdc4" split changes the step size by a factor of 5, not 2;
+ * disallow values above the split to maintain accuracy.
+ */
+static const struct axp_regulator_plat axp809_regulators[] = {
+       {"dc5ldo", 0x10, BIT(0), 0x1c, 0x07,  700, 1400, 100, NA },
+       { "dcdc1", 0x10, BIT(1), 0x21, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(2), 0x22, 0x3f,  600, 1540,  20, NA },
+       { "dcdc3", 0x10, BIT(3), 0x23, 0x3f,  600, 1860,  20, NA },
+       { "dcdc4", 0x10, BIT(4), 0x24, 0x3f,  600, 1540,  20, NA },
+       { "dcdc5", 0x10, BIT(5), 0x25, 0x1f, 1000, 2550,  50, NA },
+       { "aldo1", 0x10, BIT(6), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x10, BIT(7), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x12, BIT(5), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 3300, 100, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 3300, 100, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 3300, 100, NA },
+       { "sw",    0x12, BIT(6),   NA,   NA,   NA,   NA,  NA, NA },
+       { "dc1sw", 0x12, BIT(7),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+static const struct axp_regulator_plat axp813_regulators[] = {
+       { "dcdc1", 0x10, BIT(0), 0x20, 0x1f, 1600, 3400, 100, NA },
+       { "dcdc2", 0x10, BIT(1), 0x21, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc3", 0x10, BIT(2), 0x22, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc4", 0x10, BIT(3), 0x23, 0x7f,  500, 1300,  10, 70 },
+       { "dcdc5", 0x10, BIT(4), 0x24, 0x7f,  800, 1840,  10, 32 },
+       { "dcdc6", 0x10, BIT(5), 0x25, 0x7f,  600, 1520,  10, 50 },
+       { "dcdc7", 0x10, BIT(6), 0x26, 0x7f,  600, 1520,  10, 50 },
+       { "aldo1", 0x13, BIT(5), 0x28, 0x1f,  700, 3300, 100, NA },
+       { "aldo2", 0x13, BIT(6), 0x29, 0x1f,  700, 3300, 100, NA },
+       { "aldo3", 0x13, BIT(7), 0x2a, 0x1f,  700, 3300, 100, NA },
+       { "dldo1", 0x12, BIT(3), 0x15, 0x1f,  700, 3300, 100, NA },
+       { "dldo2", 0x12, BIT(4), 0x16, 0x1f,  700, 4200, 100, 27 },
+       { "dldo3", 0x12, BIT(5), 0x17, 0x1f,  700, 3300, 100, NA },
+       { "dldo4", 0x12, BIT(6), 0x18, 0x1f,  700, 3300, 100, NA },
+       { "eldo1", 0x12, BIT(0), 0x19, 0x1f,  700, 1900,  50, NA },
+       { "eldo2", 0x12, BIT(1), 0x1a, 0x1f,  700, 1900,  50, NA },
+       { "eldo3", 0x12, BIT(2), 0x1b, 0x1f,  700, 1900,  50, NA },
+       { "fldo1", 0x13, BIT(2), 0x1c, 0x0f,  700, 1450,  50, NA },
+       { "fldo2", 0x13, BIT(3), 0x1d, 0x0f,  700, 1450,  50, NA },
+       { "fldo3", 0x13, BIT(4),   NA,   NA,   NA,   NA,  NA, NA },
+       { }
+};
+
+static const struct axp_regulator_plat *const axp_regulators[] = {
+       [AXP152_ID]     = axp152_regulators,
+       [AXP202_ID]     = axp20x_regulators,
+       [AXP209_ID]     = axp20x_regulators,
+       [AXP221_ID]     = axp22x_regulators,
+       [AXP223_ID]     = axp22x_regulators,
+       [AXP803_ID]     = axp803_regulators,
+       [AXP806_ID]     = axp806_regulators,
+       [AXP809_ID]     = axp809_regulators,
+       [AXP813_ID]     = axp813_regulators,
+};
+
+static int axp_regulator_bind(struct udevice *dev)
+{
+       struct dm_regulator_uclass_plat *uc_plat = dev_get_uclass_plat(dev);

drivers/power/regulator/axp_regulator.c line 295

Quoted 10 lines
drivers/power/regulator/axp_regulator.c new file +10 -0
+       ulong id = dev_get_driver_data(dev->parent);
+       const struct axp_regulator_plat *plat;
+
+       for (plat = axp_regulators[id]; plat && plat->name; plat++)
+               if (!strcmp(plat->name, dev->name))
+                       break;
+       if (!plat || !plat->name)
+               return -ENODEV;
+
+       dev_set_plat(dev, (void *)plat);  

Wow this is really wacky.

Quoted 1 line

Where is the compatible string?

The whole AXP binding is nothing for the faint of heart, as the AXP is more than regulators (it's modelled as an MFD device in Linux). The compatible strings are in drivers/power/pmic/axp.c, from there we find the regulator children here via pmic_bind_children().

The regulators are subnodes of the main DT node, with their node names ("dldo4") determining their function. This is what the tables above encode, one for each PMIC type. I don't think is "proper DT" by the book (DT node names should not encode offsets), but this is how the binding has been forever, so we have to go with this.

Cheers,
Andre

P.S. I have already queued this for sunxi/master, so if you disagree, let me know now.

Quoted 23 lines
Quoted 18 lines
drivers/power/regulator/axp_regulator.c new file +17 -1
+
+       if (plat->volt_reg == NA)
+               uc_plat->type = REGULATOR_TYPE_FIXED;
+       else if (!strncmp(plat->name, "dcdc", strlen("dcdc")))
+               uc_plat->type = REGULATOR_TYPE_BUCK;
+       else
+               uc_plat->type = REGULATOR_TYPE_LDO;
+
+       return 0;
+}
+
+U_BOOT_DRIVER(axp_regulator) = {
+       .name           = "axp_regulator",
+       .id             = UCLASS_REGULATOR,
+       .bind           = axp_regulator_bind,
+       .ops            = &axp_regulator_ops,
+};
--
Quoted 2 lines

2.37.4

Regards,
Simon

#6 lore raw

PATCH v2 3/3 power: pmic: axp: Bind regulators from the DT

In reply to Samuel Holland

Now that a regulator driver exists for this PMIC, hook it up to the device tree "regulators" subnodes.

---

(no changes since v1)

 drivers/power/pmic/axp.c | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
drivers/power/pmic/axp.c +18 -0
index e0005994e2..025dac24f2 100644
@@ -45,14 +45,32 @@ static struct dm_pmic_ops axp_pmic_ops = {
 	.write		= dm_i2c_write,
 };
 
+static const struct pmic_child_info axp_pmic_child_info[] = {
+	{ "aldo",	"axp_regulator" },
+	{ "bldo",	"axp_regulator" },
+	{ "cldo",	"axp_regulator" },
+	{ "dc",		"axp_regulator" },
+	{ "dldo",	"axp_regulator" },
+	{ "eldo",	"axp_regulator" },
+	{ "fldo",	"axp_regulator" },
+	{ "ldo",	"axp_regulator" },
+	{ "sw",		"axp_regulator" },
+	{ }
+};
+
 static int axp_pmic_bind(struct udevice *dev)
 {
+	ofnode regulators_node;
 	int ret;
 
 	ret = dm_scan_fdt_dev(dev);
 	if (ret)
 		return ret;
 
+	regulators_node = dev_read_subnode(dev, "regulators");
+	if (ofnode_valid(regulators_node))
+		pmic_bind_children(dev, regulators_node, axp_pmic_child_info);
+
 	if (CONFIG_IS_ENABLED(SYSRESET)) {
 		ret = device_bind_driver_to_node(dev, "axp_sysreset", "axp_sysreset",
 						 dev_ofnode(dev), NULL);
Signature · 1 line
2.37.4
Reviewed-by on v2 3/3
#7 lore raw

Re: [PATCH v2 3/3] power: pmic: axp: Bind regulators from the DT

On Sat, 21 Jan 2023 17:13:06 -0600
Samuel Holland <[email protected]> wrote:

Hi,

Quoted 18 lines

Now that a regulator driver exists for this PMIC, hook it up to the device tree "regulators" subnodes.

---

(no changes since v1)

 drivers/power/pmic/axp.c | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
drivers/power/pmic/axp.c +0 -0
index e0005994e2..025dac24f2 100644
@@ -45,14 +45,32 @@ static struct dm_pmic_ops axp_pmic_ops = {
 	.write		= dm_i2c_write,
 };

drivers/power/pmic/axp.c static struct dm_pmic_ops axp_pmic_ops = { · line 56

Quoted 10 lines
drivers/power/pmic/axp.c +9 -0
 
+static const struct pmic_child_info axp_pmic_child_info[] = {
+	{ "aldo",	"axp_regulator" },
+	{ "bldo",	"axp_regulator" },
+	{ "cldo",	"axp_regulator" },
+	{ "dc",		"axp_regulator" },
+	{ "dldo",	"axp_regulator" },
+	{ "eldo",	"axp_regulator" },
+	{ "fldo",	"axp_regulator" },
+	{ "ldo",	"axp_regulator" },

Technically I think this list misses "rtc" (for rtc[_-]ldo), but those are real fixed regulators, and I see only one weird consumer (GPS device in sun8i-a83t-tbs-a711.dts, not relevant to U-Boot), so I think it's fine. Should an actual user emerge, we can always add it.

Cheers,
Andre

Quoted 20 lines
drivers/power/pmic/axp.c +9 -0
+	{ "sw",		"axp_regulator" },
+	{ }
+};
+
 static int axp_pmic_bind(struct udevice *dev)
 {
+	ofnode regulators_node;
 	int ret;
 
 	ret = dm_scan_fdt_dev(dev);
 	if (ret)
 		return ret;
 
+	regulators_node = dev_read_subnode(dev, "regulators");
+	if (ofnode_valid(regulators_node))
+		pmic_bind_children(dev, regulators_node, axp_pmic_child_info);
+
 	if (CONFIG_IS_ENABLED(SYSRESET)) {
 		ret = device_bind_driver_to_node(dev, "axp_sysreset", "axp_sysreset",
 						 dev_ofnode(dev), NULL);
#8 lore raw
In reply to Samuel Holland

On Sat, 21 Jan 2023 17:13:03 -0600
Samuel Holland <[email protected]> wrote:

Hi Samuel,

thanks for re-spinning this!

Quoted 6 lines

This series adds a driver for the regulators in X-Powers AXPxxx PMICs. It supports everything except regulators shared with GPIO pins. Those have a different register interface, so they may need a separate driver.

Regulator setup in U-Boot proper is needed for Ethernet and HDMI/LCD display output.

So I used a BL31 with SUNXI_SETUP_REGULATORS=0 on a Pine64, and with some tweaking of the .config, your HDMI series, my patch to parse phy-supply in sun8i-emac.c, and some delay after that, I could get both Ethernet and HDMI to work. So that seems to be working!

Given that this series does not enable this in any defconfig, I guess there is little risk in merging this. We can then bring this into wider circulation with defconfig/Kconfig patches, after a bit more testing. I am a bit uneasy seeing this code bringing up regulators/setting voltages that were disabled before, so my plan was to let people enable this on their boards manually and report back whether this works, then rolling this maybe by SoC, starting with the A64, maybe H6 (for our beloved OPi PC 3).

Quoted 5 lines

For some SoCs (H616), this driver could possibly be used
for the DRAM regulator setup done in SPL. Older SoCs do all of their regulator setup in SPL. Some of that is probably necessary, but I think a lot of it is not and can be deferred to U-Boot proper or Linux; that's just where it was convenient to initialize the PMIC at the time.

I agree, it sounds quite beneficial to get rid of this ad-hoc SPL AXP setup we do for the older SoCs, but I guess we cannot defer everything to U-Boot proper without further rework. For instance we bump up DCDC2 on A20 to allow clocking the CPU higher, which is done in SPL, but could also wait.
Anyway, it's indeed an optimisation for later, I guess we have bigger fish to fry first.

Quoted 3 lines

The main goal here is to replace the corresponding code in TF-A, both because of TF-A size constraints, and because the TF-A code is too simple/overzealous and breaks EPHY power sequencing on some boards.

I totally agree, and I would focus on the A64 and H6 for this reason first.

So I merged this series, should be part of the first PR for 2023.04.

Cheers,
Andre

Quoted 19 lines

Changes in v2:
- Dual-license the driver
- Add a comment about the requirements for the voltage table
- Fix AXP22x ALDO3 enable bit position

Samuel Holland (3):
power: pmic: axp: Provide a variant ID in the driver data
power: regulator: Add a driver for AXP PMIC regulators
power: pmic: axp: Bind regulators from the DT

 drivers/power/pmic/axp.c                |  36 ++-
 drivers/power/regulator/Kconfig         |  14 ++
 drivers/power/regulator/Makefile        |   1 +
 drivers/power/regulator/axp_regulator.c | 312 ++++++++++++++++++++++++
 include/axp_pmic.h                      |  12 +
 5 files changed, 366 insertions(+), 9 deletions(-)
 create mode 100644 drivers/power/regulator/axp_regulator.c