zephyr/drivers/regulator/regulator_axp192.c

394 lines
12 KiB
C

/*
* Copyright (c) 2021 NXP
* Copyright (c) 2023 Martin Kiepfer <mrmarteng@teleschirm.org>
* SPDX-License-Identifier: Apache-2.0
*/
#define DT_DRV_COMPAT x_powers_axp192_regulator
#include <errno.h>
#include <zephyr/kernel.h>
#include <zephyr/drivers/i2c.h>
#include <zephyr/drivers/regulator.h>
#include <zephyr/sys/linear_range.h>
#include <zephyr/sys/util.h>
#include <zephyr/dt-bindings/regulator/axp192.h>
#include <zephyr/logging/log.h>
#include <zephyr/logging/log_instance.h>
#include <zephyr/drivers/mfd/axp192.h>
LOG_MODULE_REGISTER(regulator_axp192, CONFIG_REGULATOR_LOG_LEVEL);
/* Output control registers */
#define AXP192_REG_EXTEN_DCDC2_CONTROL 0x10U
#define AXP192_REG_DCDC123_LDO23_CONTROL 0x12U
#define AXP192_REG_DCDC2_VOLTAGE 0x23U
#define AXP192_REG_DCDC2_SLOPE 0x25U
#define AXP192_REG_DCDC1_VOLTAGE 0x26U
#define AXP192_REG_DCDC3_VOLTAGE 0x27U
#define AXP192_REG_LDO23_VOLTAGE 0x28U
#define AXP192_REG_DCDC123_WORKMODE 0x80U
#define AXP192_REG_GPIO0_CONTROL 0x90U
#define AXP192_REG_LDOIO0_VOLTAGE 0x91U
struct regulator_axp192_desc {
const uint8_t enable_reg;
const uint8_t enable_mask;
const uint8_t enable_val;
const uint8_t vsel_reg;
const uint8_t vsel_mask;
const uint8_t vsel_bitpos;
const int32_t max_ua;
const uint8_t workmode_reg;
const uint8_t workmode_mask;
const uint8_t workmode_pwm_val;
const uint8_t num_ranges;
const struct linear_range *ranges;
};
struct regulator_axp192_data {
struct regulator_common_data data;
};
struct regulator_axp192_config {
struct regulator_common_config common;
const struct regulator_axp192_desc *desc;
const struct device *mfd;
const struct i2c_dt_spec i2c;
LOG_INSTANCE_PTR_DECLARE(log);
};
static const struct linear_range dcdc1_ranges[] = {
LINEAR_RANGE_INIT(700000U, 25000U, 0x00U, 0x7FU),
};
__maybe_unused static const struct regulator_axp192_desc dcdc1_desc = {
.enable_reg = AXP192_REG_DCDC123_LDO23_CONTROL,
.enable_mask = 0x01U,
.enable_val = 0x01U,
.vsel_reg = AXP192_REG_DCDC1_VOLTAGE,
.vsel_mask = 0x7FU,
.vsel_bitpos = 0U,
.max_ua = 1200000U,
.workmode_reg = AXP192_REG_DCDC123_WORKMODE,
.workmode_mask = 0x08U,
.workmode_pwm_val = 0x08U,
.ranges = dcdc1_ranges,
.num_ranges = ARRAY_SIZE(dcdc1_ranges),
};
static const struct linear_range dcdc2_ranges[] = {
LINEAR_RANGE_INIT(700000U, 25000U, 0x00U, 0x3FU),
};
__maybe_unused static const struct regulator_axp192_desc dcdc2_desc = {
.enable_reg = AXP192_REG_EXTEN_DCDC2_CONTROL,
.enable_mask = 0x01U,
.enable_val = 0x01U,
.vsel_reg = AXP192_REG_DCDC2_VOLTAGE,
.vsel_mask = 0x3FU,
.vsel_bitpos = 0U,
.max_ua = 1600000U,
.workmode_reg = AXP192_REG_DCDC123_WORKMODE,
.workmode_mask = 0x04U,
.workmode_pwm_val = 0x04U,
.ranges = dcdc2_ranges,
.num_ranges = ARRAY_SIZE(dcdc2_ranges),
};
static const struct linear_range dcdc3_ranges[] = {
LINEAR_RANGE_INIT(700000U, 25000U, 0x00U, 0x7FU),
};
__maybe_unused static const struct regulator_axp192_desc dcdc3_desc = {
.enable_reg = AXP192_REG_DCDC123_LDO23_CONTROL,
.enable_mask = 0x02U,
.enable_val = 0x02U,
.vsel_reg = AXP192_REG_DCDC3_VOLTAGE,
.vsel_mask = 0x7FU,
.vsel_bitpos = 0U,
.max_ua = 700000U,
.workmode_reg = AXP192_REG_DCDC123_WORKMODE,
.workmode_mask = 0x02U,
.workmode_pwm_val = 0x02U,
.ranges = dcdc3_ranges,
.num_ranges = ARRAY_SIZE(dcdc3_ranges),
};
static const struct linear_range ldoio0_ranges[] = {
LINEAR_RANGE_INIT(1800000u, 100000u, 0x00u, 0x0Fu),
};
__maybe_unused static const struct regulator_axp192_desc ldoio0_desc = {
.enable_reg = AXP192_REG_GPIO0_CONTROL,
.enable_mask = 0x07u,
.enable_val = 0x03u,
.vsel_reg = AXP192_REG_LDOIO0_VOLTAGE,
.vsel_mask = 0xF0u,
.vsel_bitpos = 4u,
.max_ua = 50000u,
.workmode_reg = 0u,
.workmode_mask = 0u,
.ranges = ldoio0_ranges,
.num_ranges = ARRAY_SIZE(ldoio0_ranges),
};
static const struct linear_range ldo2_ranges[] = {
LINEAR_RANGE_INIT(1800000U, 100000U, 0x00U, 0x0FU),
};
__maybe_unused static const struct regulator_axp192_desc ldo2_desc = {
.enable_reg = AXP192_REG_DCDC123_LDO23_CONTROL,
.enable_mask = 0x04U,
.enable_val = 0x04U,
.vsel_reg = AXP192_REG_LDO23_VOLTAGE,
.vsel_mask = 0xF0U,
.vsel_bitpos = 4U,
.max_ua = 200000U,
.workmode_reg = 0U,
.workmode_mask = 0U,
.ranges = ldo2_ranges,
.num_ranges = ARRAY_SIZE(ldo2_ranges),
};
static const struct linear_range ldo3_ranges[] = {
LINEAR_RANGE_INIT(1800000U, 100000U, 0x00U, 0x0FU),
};
__maybe_unused static const struct regulator_axp192_desc ldo3_desc = {
.enable_reg = AXP192_REG_DCDC123_LDO23_CONTROL,
.enable_mask = 0x08U,
.enable_val = 0x08U,
.vsel_reg = AXP192_REG_LDO23_VOLTAGE,
.vsel_mask = 0x0FU,
.vsel_bitpos = 0U,
.max_ua = 200000U,
.workmode_reg = 0U,
.workmode_mask = 0U,
.ranges = ldo3_ranges,
.num_ranges = ARRAY_SIZE(ldo3_ranges),
};
static int axp192_enable(const struct device *dev)
{
const struct regulator_axp192_config *config = dev->config;
int ret;
LOG_INST_DBG(config->log, "Enabling regulator");
LOG_INST_DBG(config->log, "[0x%02x]=0x%02x mask=0x%02x", config->desc->enable_reg,
config->desc->enable_val, config->desc->enable_mask);
/* special case for LDOIO0, which is multiplexed with GPIO0 */
if (config->desc->enable_reg == AXP192_REG_GPIO0_CONTROL) {
ret = mfd_axp192_gpio_func_ctrl(config->mfd, dev, 0, AXP192_GPIO_FUNC_LDO);
} else {
ret = i2c_reg_update_byte_dt(&config->i2c, config->desc->enable_reg,
config->desc->enable_mask, config->desc->enable_val);
}
if (ret != 0) {
LOG_INST_ERR(config->log, "Failed to enable regulator");
}
return ret;
}
static int axp192_disable(const struct device *dev)
{
const struct regulator_axp192_config *config = dev->config;
int ret;
LOG_INST_DBG(config->log, "Disabling regulator");
LOG_INST_DBG(config->log, "[0x%02x]=0 mask=0x%x", config->desc->enable_reg,
config->desc->enable_mask);
/* special case for LDOIO0, which is multiplexed with GPIO0 */
if (config->desc->enable_reg == AXP192_REG_GPIO0_CONTROL) {
ret = mfd_axp192_gpio_func_ctrl(config->mfd, dev, 0, AXP192_GPIO_FUNC_OUTPUT_LOW);
} else {
ret = i2c_reg_update_byte_dt(&config->i2c, config->desc->enable_reg,
config->desc->enable_mask, 0u);
}
if (ret != 0) {
LOG_INST_ERR(config->log, "Failed to disable regulator");
}
return ret;
}
static unsigned int axp192_count_voltages(const struct device *dev)
{
const struct regulator_axp192_config *config = dev->config;
return linear_range_group_values_count(config->desc->ranges, config->desc->num_ranges);
}
static int axp192_list_voltage(const struct device *dev, unsigned int idx, int32_t *volt_uv)
{
const struct regulator_axp192_config *config = dev->config;
return linear_range_group_get_value(config->desc->ranges, config->desc->num_ranges, idx,
volt_uv);
}
static int axp192_set_voltage(const struct device *dev, int32_t min_uv, int32_t max_uv)
{
const struct regulator_axp192_config *config = dev->config;
uint16_t idx;
int ret;
LOG_INST_DBG(config->log, "voltage = [min=%d, max=%d]", min_uv, max_uv);
/* set voltage */
ret = linear_range_group_get_win_index(config->desc->ranges, config->desc->num_ranges,
min_uv, max_uv, &idx);
if (ret != 0) {
LOG_INST_ERR(config->log, "No voltage range window could be detected");
return ret;
}
idx <<= config->desc->vsel_bitpos;
LOG_INST_DBG(config->log, "[0x%x]=0x%x mask=0x%x", config->desc->vsel_reg, idx,
config->desc->vsel_mask);
ret = i2c_reg_update_byte_dt(&config->i2c, config->desc->vsel_reg, config->desc->vsel_mask,
(uint8_t)idx);
if (ret != 0) {
LOG_INST_ERR(config->log, "Failed to set regulator voltage");
}
return ret;
}
static int axp192_get_voltage(const struct device *dev, int32_t *volt_uv)
{
const struct regulator_axp192_config *config = dev->config;
int ret;
uint8_t raw_reg;
/* read voltage */
ret = i2c_reg_read_byte_dt(&config->i2c, config->desc->vsel_reg, &raw_reg);
if (ret != 0) {
return ret;
}
raw_reg = (raw_reg & config->desc->vsel_mask) >> config->desc->vsel_bitpos;
ret = linear_range_group_get_value(config->desc->ranges, config->desc->num_ranges, raw_reg,
volt_uv);
return ret;
}
static int axp192_set_mode(const struct device *dev, regulator_mode_t mode)
{
const struct regulator_axp192_config *config = dev->config;
int ret;
/* setting workmode is only possible for DCDC1-3 */
if ((mode == AXP192_DCDC_MODE_PWM) && (config->desc->workmode_reg != 0)) {
/* configure PWM mode */
LOG_INST_DBG(config->log, "PWM mode enabled");
ret = i2c_reg_update_byte_dt(&config->i2c, config->desc->workmode_reg,
config->desc->workmode_mask,
config->desc->workmode_pwm_val);
if (ret != 0) {
return ret;
}
} else if (mode == AXP192_DCDC_MODE_AUTO) {
/* configure AUTO mode (default) */
if (config->desc->workmode_reg != 0) {
ret = i2c_reg_update_byte_dt(&config->i2c, config->desc->workmode_reg,
config->desc->workmode_mask, 0u);
if (ret != 0) {
return ret;
}
} else {
/* AUTO is default mode for LDOs that cannot be configured */
return 0;
}
} else {
LOG_INST_ERR(config->log, "Setting DCDC workmode failed");
return -ENOTSUP;
}
return 0;
}
static int axp192_get_current_limit(const struct device *dev, int32_t *curr_ua)
{
const struct regulator_axp192_config *config = dev->config;
*curr_ua = config->desc->max_ua;
return 0;
}
static struct regulator_driver_api api = {
.enable = axp192_enable,
.disable = axp192_disable,
.count_voltages = axp192_count_voltages,
.list_voltage = axp192_list_voltage,
.set_voltage = axp192_set_voltage,
.get_voltage = axp192_get_voltage,
.set_mode = axp192_set_mode,
.get_current_limit = axp192_get_current_limit,
};
static int regulator_axp192_init(const struct device *dev)
{
const struct regulator_axp192_config *config = dev->config;
uint8_t enabled_val;
bool is_enabled;
int ret = 0;
regulator_common_data_init(dev);
if (!device_is_ready(config->mfd)) {
LOG_INST_ERR(config->log, "Parent instance not ready!");
return -ENODEV;
}
/* read regulator state */
ret = i2c_reg_read_byte_dt(&config->i2c, config->desc->enable_reg, &enabled_val);
if (ret != 0) {
LOG_INST_ERR(config->log, "Reading enable status failed!");
return ret;
}
is_enabled = ((enabled_val & config->desc->enable_mask) == config->desc->enable_val);
LOG_INST_DBG(config->log, "is_enabled: %d", is_enabled);
return regulator_common_init(dev, is_enabled);
}
#define REGULATOR_AXP192_DEFINE(node_id, id, name) \
static struct regulator_axp192_data data_##id; \
LOG_INSTANCE_REGISTER(name, node_id, CONFIG_REGULATOR_LOG_LEVEL); \
static const struct regulator_axp192_config config_##id = { \
.common = REGULATOR_DT_COMMON_CONFIG_INIT(node_id), \
.desc = &name##_desc, \
.mfd = DEVICE_DT_GET(DT_GPARENT(node_id)), \
.i2c = I2C_DT_SPEC_GET(DT_GPARENT(node_id)), \
LOG_INSTANCE_PTR_INIT(log, name, node_id)}; \
DEVICE_DT_DEFINE(node_id, regulator_axp192_init, NULL, &data_##id, &config_##id, \
POST_KERNEL, CONFIG_REGULATOR_AXP192_INIT_PRIORITY, &api);
#define REGULATOR_AXP192_DEFINE_COND(inst, child) \
COND_CODE_1(DT_NODE_EXISTS(DT_INST_CHILD(inst, child)), \
(REGULATOR_AXP192_DEFINE(DT_INST_CHILD(inst, child), child##inst, child)), ())
#define REGULATOR_AXP192_DEFINE_ALL(inst) \
REGULATOR_AXP192_DEFINE_COND(inst, dcdc1) \
REGULATOR_AXP192_DEFINE_COND(inst, dcdc2) \
REGULATOR_AXP192_DEFINE_COND(inst, dcdc3) \
REGULATOR_AXP192_DEFINE_COND(inst, ldoio0) \
REGULATOR_AXP192_DEFINE_COND(inst, ldo2) \
REGULATOR_AXP192_DEFINE_COND(inst, ldo3)
DT_INST_FOREACH_STATUS_OKAY(REGULATOR_AXP192_DEFINE_ALL)