/* * Copyright (c) 2021 NXP * Copyright (c) 2023 Martin Kiepfer * SPDX-License-Identifier: Apache-2.0 */ #define DT_DRV_COMPAT x_powers_axp192_regulator #include #include #include #include #include #include #include #include #include #include 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)