0f2dd1eff9
Split `i2c.h` into three pieces to ease reuse of the generic defi-
nitions. No code is changed.
* `i2c.h` - keeps the generic definitions
* `i2c_simple.h` - holds the current, limited to one controller driver
per board, devicetree independent I2C interface
* `i2c_bus.h` - will become the devicetree compatible interface for
native I2C (e.g. non-SMBus) controllers
Change-Id: I382d45c70f9314588663e1284f264f877469c74d
Signed-off-by: Nico Huber <nico.huber@secunet.com>
Reviewed-on: https://review.coreboot.org/20845
Tested-by: build bot (Jenkins) <no-reply@coreboot.org>
Reviewed-by: Aaron Durbin <adurbin@chromium.org>
323 lines
8.6 KiB
C
323 lines
8.6 KiB
C
/*
|
|
* Driver for X-Powers AXP 209 Power Management Unit
|
|
*
|
|
* Despite axp209_read/write only working on a byte at a time, there is no such
|
|
* limitation in the AXP209.
|
|
*
|
|
* Copyright (C) 2013 Alexandru Gagniuc <mr.nuke.me@gmail.com>
|
|
* Subject to the GNU GPL v2, or (at your option) any later version.
|
|
*/
|
|
|
|
#include "axp209.h"
|
|
#include "chip.h"
|
|
|
|
#include <console/console.h>
|
|
#include <device/device.h>
|
|
#include <device/i2c_simple.h>
|
|
|
|
/* Hide these definitions from the rest of the source, so keep them here */
|
|
enum registers {
|
|
REG_POWER_STATUS = 0x00,
|
|
REG_POWER_MODE = 0x01,
|
|
REG_OTG_VBUS = 0x02,
|
|
REG_CHIP_ID = 0x03,
|
|
REG_CHIP_PWROUT_CTL = 0x12,
|
|
REG_DCDC2_VOLTAGE = 0x23,
|
|
REG_DCDC2_LDO3_CTL = 0x25,
|
|
REG_DCDC3_VOLTAGE = 0x27,
|
|
REG_LDO24_VOLTAGE = 0x28,
|
|
REG_LDO3_VOLTAGE = 0x29,
|
|
REG_VBUS_IPSOUT = 0x30,
|
|
REG_PWROFF_VOLTAGE = 0x31,
|
|
REG_SHTDWN_SETTING = 0x32,
|
|
};
|
|
|
|
/* REG_LDO24_VOLTAGE definitions */
|
|
#define REG_LDO24_VOLTAGE_LDO2_MASK (0xf << 4)
|
|
#define REG_LDO24_VOLTAGE_LDO2_VAL(x) ((x << 4) & REG_LDO24_VOLTAGE_LDO2_MASK)
|
|
#define REG_LDO24_VOLTAGE_LDO4_MASK (0xf << 0)
|
|
#define REG_LDO24_VOLTAGE_LDO4_VAL(x) ((x << 0) & REG_LDO24_VOLTAGE_LDO4_MASK)
|
|
|
|
/*
|
|
* Read and write accessors. We only work on one register at a time, but there
|
|
* is no limitation on the AXP209 as to how many registers we may read or write
|
|
* in one transaction.
|
|
* These return the number of bytes read/written, or an error code. In this
|
|
* case, they return 1 on success, or an error code otherwise. This is done to
|
|
* work with I2C drivers that return either 0 on success or the number of bytes
|
|
* actually transferred.
|
|
*/
|
|
static int axp209_read(u8 bus, u8 reg, u8 *val)
|
|
{
|
|
if (i2c_readb(bus, AXP209_I2C_ADDR, reg, val) < 0)
|
|
return CB_ERR;
|
|
return 1;
|
|
}
|
|
|
|
static int axp209_write(u8 bus, u8 reg, u8 val)
|
|
{
|
|
if (i2c_writeb(bus, AXP209_I2C_ADDR, reg, val) < 0)
|
|
return CB_ERR;
|
|
return 1;
|
|
}
|
|
|
|
/**
|
|
* \brief Identify and initialize an AXP209 on the I2C bus
|
|
*
|
|
* @param[in] bus I2C bus to which the AXP209 is connected
|
|
* @return CB_SUCCES on if an AXP209 is found, or an error code otherwise.
|
|
*/
|
|
enum cb_err axp209_init(u8 bus)
|
|
{
|
|
u8 id;
|
|
|
|
if (axp209_read(bus, REG_CHIP_ID, &id) != 1)
|
|
return CB_ERR;
|
|
|
|
/* From U-Boot code : Low 4 bits is chip version */
|
|
if ((id & 0x0f) != 0x1) {
|
|
printk(BIOS_ERR, "[axp209] ID 0x%x does not match\n", id);
|
|
return CB_ERR;
|
|
}
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* \brief Configure the output voltage of DC-DC2 converter
|
|
*
|
|
* If the requested voltage is not available, the next lowest voltage will
|
|
* be applied.
|
|
* Valid values are between 700mV and 2275mV
|
|
*
|
|
* @param[in] millivolts voltage in mV units.
|
|
* @param[in] bus I2C bus to which the AXP209 is connected
|
|
* @return CB_SUCCES on success,
|
|
* CB_ERR_ARG if voltage is out of range, or an error code otherwise.
|
|
*/
|
|
enum cb_err axp209_set_dcdc2_voltage(u8 bus, u16 millivolts)
|
|
{
|
|
u8 val;
|
|
|
|
if (millivolts < 700 || millivolts > 2275)
|
|
return CB_ERR_ARG;
|
|
|
|
val = (millivolts - 700) / 25;
|
|
|
|
if (axp209_write(bus, REG_DCDC2_VOLTAGE, val) != 1)
|
|
return CB_ERR;
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* \brief Configure the output voltage of DC-DC3 converter
|
|
*
|
|
* If the requested voltage is not available, the next lowest voltage will
|
|
* be applied.
|
|
* Valid values are between 700mV and 3500mV
|
|
*
|
|
* @param[in] millivolts voltage in mV units.
|
|
* @param[in] bus I2C bus to which the AXP209 is connected
|
|
* @return CB_SUCCES on success,
|
|
* CB_ERR_ARG if voltage is out of range, or an error code otherwise.
|
|
*/
|
|
enum cb_err axp209_set_dcdc3_voltage(u8 bus, u16 millivolts)
|
|
{
|
|
u8 val;
|
|
|
|
if (millivolts < 700 || millivolts > 3500)
|
|
return CB_ERR_ARG;
|
|
|
|
val = (millivolts - 700) / 25;
|
|
|
|
if (axp209_write(bus, REG_DCDC3_VOLTAGE, val) != 1)
|
|
return CB_ERR;
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* \brief Configure the output voltage of LDO2 regulator
|
|
*
|
|
* If the requested voltage is not available, the next lowest voltage will
|
|
* be applied.
|
|
* Valid values are between 700mV and 3300mV
|
|
*
|
|
* @param[in] millivolts voltage in mV units.
|
|
* @param[in] bus I2C bus to which the AXP209 is connected
|
|
* @return CB_SUCCES on success,
|
|
* CB_ERR_ARG if voltage is out of range, or an error code otherwise.
|
|
*/
|
|
enum cb_err axp209_set_ldo2_voltage(u8 bus, u16 millivolts)
|
|
{
|
|
u8 reg8, val;
|
|
|
|
if (millivolts < 1800 || millivolts > 3300)
|
|
return CB_ERR_ARG;
|
|
|
|
/* Try to read the register first, and stop here on error */
|
|
if (axp209_read(bus, REG_LDO24_VOLTAGE, ®8) != 1)
|
|
return CB_ERR;
|
|
|
|
val = (millivolts - 1800) / 100;
|
|
reg8 &= ~REG_LDO24_VOLTAGE_LDO2_MASK;
|
|
reg8 |= REG_LDO24_VOLTAGE_LDO2_VAL(val);
|
|
|
|
if (axp209_write(bus, REG_LDO24_VOLTAGE, reg8) != 1)
|
|
return CB_ERR;
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* \brief Configure the output voltage of LDO4 regulator
|
|
*
|
|
* If the requested voltage is not available, the next lowest voltage will
|
|
* be applied.
|
|
* Valid values are between 700mV and 3500mV. Datasheet lists maximum voltage at
|
|
* 2250mV, but hardware samples go as high as 3500mV.
|
|
*
|
|
* @param[in] millivolts voltage in mV units.
|
|
* @param[in] bus I2C bus to which the AXP209 is connected
|
|
* @return CB_SUCCES on success,
|
|
* CB_ERR_ARG if voltage is out of range, or an error code otherwise.
|
|
*/
|
|
enum cb_err axp209_set_ldo3_voltage(u8 bus, u16 millivolts)
|
|
{
|
|
u8 val;
|
|
|
|
/* Datasheet lists 2250 max, but PMU will output up to 3500mV */
|
|
if (millivolts < 700 || millivolts > 3500)
|
|
return CB_ERR_ARG;
|
|
|
|
val = (millivolts - 700) / 25;
|
|
|
|
if (axp209_write(bus, REG_LDO3_VOLTAGE, val) != 1)
|
|
return CB_ERR;
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* \brief Configure the output voltage of DC-DC2 converter
|
|
*
|
|
* If the requested voltage is not available, the next lowest voltage will
|
|
* be applied.
|
|
* Valid values are between 1250V and 3300mV
|
|
*
|
|
* @param[in] millivolts voltage in mV units.
|
|
* @param[in] bus I2C bus to which the AXP209 is connected
|
|
* @return CB_SUCCES on success,
|
|
* CB_ERR_ARG if voltage is out of range, or an error code otherwise.
|
|
*/
|
|
enum cb_err axp209_set_ldo4_voltage(u8 bus, u16 millivolts)
|
|
{
|
|
u8 reg8, val;
|
|
|
|
if (millivolts < 1250 || millivolts > 3300)
|
|
return CB_ERR_ARG;
|
|
|
|
/* Try to read the register first, and stop here on error */
|
|
if (axp209_read(bus, REG_LDO24_VOLTAGE, ®8) != 1)
|
|
return CB_ERR;
|
|
|
|
if (millivolts <= 2000)
|
|
val = (millivolts - 1200) / 100;
|
|
else if (millivolts <= 2700)
|
|
val = 9 + (millivolts - 2500) / 100;
|
|
else if (millivolts <= 2800)
|
|
val = 11;
|
|
else
|
|
val = 12 + (millivolts - 3000) / 100;
|
|
|
|
reg8 &= ~REG_LDO24_VOLTAGE_LDO4_MASK;
|
|
reg8 |= REG_LDO24_VOLTAGE_LDO4_VAL(val);
|
|
|
|
if (axp209_write(bus, REG_LDO24_VOLTAGE, reg8) != 1)
|
|
return CB_ERR;
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
static const struct {
|
|
enum cb_err (*set_voltage) (u8 bus, u16 mv);
|
|
const char *name;
|
|
} vtable[] = { {
|
|
.set_voltage = axp209_set_dcdc2_voltage,
|
|
.name = "DCDC2",
|
|
}, {
|
|
.set_voltage = axp209_set_dcdc3_voltage,
|
|
.name = "DCDC3",
|
|
}, {
|
|
.set_voltage = axp209_set_ldo2_voltage,
|
|
.name = "LDO2",
|
|
}, {
|
|
.set_voltage = axp209_set_ldo3_voltage,
|
|
.name = "LDO3",
|
|
}, {
|
|
.set_voltage = axp209_set_ldo4_voltage,
|
|
.name = "LDO4",
|
|
}
|
|
};
|
|
|
|
static enum cb_err set_rail(u8 bus, int idx, u16 mv)
|
|
{
|
|
enum cb_err err;
|
|
const char *name = vtable[idx].name;
|
|
|
|
/* If voltage isn't specified, don't touch the rail */
|
|
if (mv == 0) {
|
|
printk(BIOS_DEBUG, "[axp209] Skipping %s configuration\n",
|
|
name);
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
if ((err = vtable[idx].set_voltage(bus, mv) != CB_SUCCESS)) {
|
|
printk(BIOS_ERR, "[axp209] Failed to set %s to %u mv\n",
|
|
name, mv);
|
|
return err;
|
|
}
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* \brief Configure all voltage rails
|
|
*
|
|
* Configure all converters and regulators from devicetree config. If any of the
|
|
* voltages are not declared (i.e. are zero), the respective rail will not be
|
|
* reconfigured, and retain its powerup voltage.
|
|
*
|
|
* @param[in] cfg pointer to @ref drivers_xpowers_axp209_config structure
|
|
* @param[in] bus I2C bus to which the AXP209 is connected
|
|
* @return CB_SUCCES on success, or an error code otherwise.
|
|
*/
|
|
enum cb_err axp209_set_voltages(u8 bus, const struct
|
|
drivers_xpowers_axp209_config *cfg)
|
|
{
|
|
enum cb_err err;
|
|
|
|
/* Don't worry about what the error is. Console prints that */
|
|
err = set_rail(bus, 0, cfg->dcdc2_voltage_mv);
|
|
err |= set_rail(bus, 1, cfg->dcdc3_voltage_mv);
|
|
err |= set_rail(bus, 2, cfg->ldo2_voltage_mv);
|
|
err |= set_rail(bus, 3, cfg->ldo3_voltage_mv);
|
|
err |= set_rail(bus, 4, cfg->ldo4_voltage_mv);
|
|
|
|
if (err != CB_SUCCESS)
|
|
return CB_ERR;
|
|
|
|
return CB_SUCCESS;
|
|
}
|
|
|
|
/*
|
|
* Usually, the AXP209 is enabled and configured in romstage, so there is no
|
|
* need for a full ramstage driver. Hence .enable_dev is NULL.
|
|
*/
|
|
#ifndef __PRE_RAM__
|
|
struct chip_operations drivers_xpowers_axp209_config = {
|
|
CHIP_NAME("X-Powers AXP 209 Power Management Unit")
|
|
.enable_dev = NULL,
|
|
};
|
|
#endif /* __PRE_RAM__ */
|