michaelh/zephyr
1
0
Fork 0
Code Releases Activity

drivers: regulator: add mode specific configuration functions for PMIC

Browse source 
Add mode specific PMIC configuration functions, to allow consumers to
configure target voltages of each regulator mode. This will allow users
to enable or disable, as well as set target voltages for regulator modes
without actually entering that mode.

This feature can be useful for power managment applications where the
consumer may want to switch the regulator to low power mode at a later
time.

Signed-off-by: Daniel DeGrasse <daniel.degrasse@nxp.com>
This commit is contained in:
Daniel DeGrasse 2022-10-13 12:08:37 -05:00 • committed by Carles Cufí
commit f10ec43808
2 changed files with 234 additions and 45 deletions
Download patch file Download diff file Expand all files Collapse all files

232
drivers/regulator/regulator_pmic.c
View file

@ -103,6 +103,70 @@ static int regulator_modify_register(const struct device *dev,
return i2c_reg_write_byte_dt(&conf->i2c, reg, reg_current);
}
/*
* Internal helper function- gets the voltage from a regulator, with an
* offset applied to the vsel_reg. Useful to support reading voltages
* in another target mode
*/
static int regulator_get_voltage_offset(const struct device *dev, uint32_t off)
{
const struct regulator_config *config = dev->config;
struct regulator_data *data = dev->data;
int rc, i = 0;
uint8_t raw_reg;
rc = regulator_read_register(dev, config->vsel_reg + off, &raw_reg);
if (rc) {
return rc;
}
raw_reg &= config->vsel_mask;
/* Locate the voltage value in the voltage table */
while (i < config->num_voltages &&
raw_reg != data->voltages[i].reg_val){
i++;
}
if (i == config->num_voltages) {
LOG_WRN("Regulator vsel reg has unknown value");
return -EIO;
}
return data->voltages[i].uV;
}
/**
* Internal helper function- sets the voltage for a regulator, with an
* offset applied to the vsel_reg. Useful to support setting voltages in
* another target mode.
*/
static int regulator_set_voltage_offset(const struct device *dev, int min_uV,
int max_uV, uint32_t off)
{
const struct regulator_config *config = dev->config;
struct regulator_data *data = dev->data;
int i = 0;
if (!regulator_is_supported_voltage(dev, min_uV, max_uV) ||
min_uV > max_uV) {
return -EINVAL;
}
/* Find closest supported voltage */
while (i < config->num_voltages && min_uV > data->voltages[i].uV) {
i++;
}
if (data->voltages[i].uV > max_uV) {
LOG_DBG("Regulator could not satisfy voltage range, too narrow");
return -EINVAL;
}
if (i == config->num_voltages) {
LOG_WRN("Regulator could not locate supported voltage,"
"but voltage is in range.");
return -EINVAL;
}
LOG_DBG("Setting regulator %s to %duV", dev->name,
data->voltages[i].uV);
return regulator_modify_register(dev, config->vsel_reg + off,
config->vsel_mask, data->voltages[i].reg_val);
}
/**
* Part of the extended regulator consumer API
@ -159,59 +223,17 @@ int regulator_is_supported_voltage(const struct device *dev,
*/
int regulator_set_voltage(const struct device *dev, int min_uV, int max_uV)
{
const struct regulator_config *config = dev->config;
struct regulator_data *data = dev->data;
int i = 0;
if (!regulator_is_supported_voltage(dev, min_uV, max_uV) ||
min_uV > max_uV) {
return -EINVAL;
}
/* Find closest supported voltage */
while (i < config->num_voltages && min_uV > data->voltages[i].uV) {
i++;
}
if (data->voltages[i].uV > max_uV) {
LOG_DBG("Regulator could not satisfy voltage range, too narrow");
return -EINVAL;
}
if (i == config->num_voltages) {
LOG_WRN("Regulator could not locate supported voltage,"
"but voltage is in range.");
return -EINVAL;
}
LOG_DBG("Setting regulator %s to %duV", dev->name,
data->voltages[i].uV);
return regulator_modify_register(dev, config->vsel_reg,
config->vsel_mask, data->voltages[i].reg_val);
return regulator_set_voltage_offset(dev, min_uV, max_uV, 0);
}
/**
* Part of the extended regulator consumer API
* Gets the current output voltage in uV
*/
int regulator_get_voltage(const struct device *dev)
{
const struct regulator_config *config = dev->config;
struct regulator_data *data = dev->data;
int rc, i = 0;
uint8_t raw_reg;
rc = regulator_read_register(dev, config->vsel_reg, &raw_reg);
if (rc) {
return rc;
}
raw_reg &= config->vsel_mask;
/* Locate the voltage value in the voltage table */
while (i < config->num_voltages &&
raw_reg != data->voltages[i].reg_val){
i++;
}
if (i == config->num_voltages) {
LOG_WRN("Regulator vsel reg has unknown value");
return -EIO;
}
return data->voltages[i].uV;
return regulator_get_voltage_offset(dev, 0);
}
/**
@ -271,6 +293,126 @@ int regulator_get_current_limit(const struct device *dev)
return data->current_levels[i].uA;
}
/*
* Part of the extended regulator consumer API.
* sets the target voltage for a given regulator mode. This mode does
* not need to be the active mode. This API can be used to configure
* voltages for a mode, then the regulator can be switched to that mode
* with the regulator_set_mode api
*/
int regulator_set_mode_voltage(const struct device *dev, uint32_t mode,
uint32_t min_uV, uint32_t max_uV)
{
const struct regulator_config *config = dev->config;
uint8_t i, sel_off;
if (config->num_modes == 0) {
return -ENOTSUP;
}
/* Search for mode ID in allowed modes. */
for (i = 0 ; i < config->num_modes; i++) {
if (config->allowed_modes[i] == mode) {
break;
}
}
if (i == config->num_modes) {
/* Mode was not found */
return -EINVAL;
}
sel_off = ((mode & PMIC_MODE_OFFSET_MASK) >> PMIC_MODE_OFFSET_SHIFT);
return regulator_set_voltage_offset(dev, min_uV, max_uV, sel_off);
}
/*
* Part of the extended regulator consumer API.
* Disables the regulator in a given mode. Does not implement the
* onoff service, as this is incompatible with multiple mode operation
*/
int regulator_mode_disable(const struct device *dev, uint32_t mode)
{
const struct regulator_config *config = dev->config;
uint8_t i, sel_off, dis_val;
if (config->num_modes == 0) {
return -ENOTSUP;
}
/* Search for mode ID in allowed modes. */
for (i = 0 ; i < config->num_modes; i++) {
if (config->allowed_modes[i] == mode) {
break;
}
}
if (i == config->num_modes) {
/* Mode was not found */
return -EINVAL;
}
sel_off = ((mode & PMIC_MODE_OFFSET_MASK) >> PMIC_MODE_OFFSET_SHIFT);
dis_val = config->enable_inverted ? config->enable_val : 0;
return regulator_modify_register(dev, config->enable_reg + sel_off,
config->enable_mask, dis_val);
}
/*
* Part of the extended regulator consumer API.
* Enables the regulator in a given mode. Does not implement the
* onoff service, as this is incompatible with multiple mode operation
*/
int regulator_mode_enable(const struct device *dev, uint32_t mode)
{
const struct regulator_config *config = dev->config;
uint8_t i, sel_off, en_val;
if (config->num_modes == 0) {
return -ENOTSUP;
}
/* Search for mode ID in allowed modes. */
for (i = 0 ; i < config->num_modes; i++) {
if (config->allowed_modes[i] == mode) {
break;
}
}
if (i == config->num_modes) {
/* Mode was not found */
return -EINVAL;
}
sel_off = ((mode & PMIC_MODE_OFFSET_MASK) >> PMIC_MODE_OFFSET_SHIFT);
en_val = config->enable_inverted ? 0 : config->enable_val;
return regulator_modify_register(dev, config->enable_reg + sel_off,
config->enable_mask, en_val);
}
/*
* Part of the extended regulator consumer API.
* gets the target voltage for a given regulator mode. This mode does
* not need to be the active mode. This API can be used to read voltages
* from a regulator mode other than the default.
*/
int regulator_get_mode_voltage(const struct device *dev, uint32_t mode)
{
const struct regulator_config *config = dev->config;
uint8_t i, sel_off;
if (config->num_modes == 0) {
return -ENOTSUP;
}
/* Search for mode ID in allowed modes. */
for (i = 0 ; i < config->num_modes; i++) {
if (config->allowed_modes[i] == mode) {
break;
}
}
if (i == config->num_modes) {
/* Mode was not found */
return -EINVAL;
}
sel_off = ((mode & PMIC_MODE_OFFSET_MASK) >> PMIC_MODE_OFFSET_SHIFT);
return regulator_get_voltage_offset(dev, sel_off);
}
/*
* Part of the extended regulator consumer API
* switches the regulator to a given mode. This API will apply a mode for