root/drivers/regulator/mt6316-regulator.c
// SPDX-License-Identifier: GPL-2.0
//
// Copyright (c) 2024 MediaTek Inc.
// Copyright (c) 2025 Collabora Ltd
//                    AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>

#include <linux/module.h>
#include <linux/of.h>
#include <linux/regmap.h>
#include <linux/spmi.h>

#include <linux/regulator/driver.h>
#include <linux/regulator/machine.h>
#include <linux/regulator/of_regulator.h>

#define MT6316_BUCK_MODE_AUTO                   0
#define MT6316_BUCK_MODE_FORCE_PWM              1
#define MT6316_BUCK_MODE_LP                     2

#define MT6316_CHIP_ID                          0x20b
#define MT6316_BUCK_TOP_CON0                    0x1440
#define EN_SET_OFFSET                           0x1
#define EN_CLR_OFFSET                           0x2

#define MT6316_BUCK_TOP_CON1                    0x1443

#define MT6316_BUCK_TOP_ELR0                    0x1448
#define MT6316_BUCK_TOP_ELR2                    0x144a
#define MT6316_BUCK_TOP_ELR4                    0x144c
#define MT6316_BUCK_TOP_ELR6                    0x144e
#define MT6316_VSEL_MASK                        GENMASK(8, 0)

#define MT6316_VBUCK1_DBG                       0x14a8
#define MT6316_VBUCK2_DBG                       0x1528
#define MT6316_VBUCK3_DBG                       0x15a8
#define MT6316_VBUCK4_DBG                       0x1628
#define MT6316_BUCK_QI                          BIT(0)

#define MT6316_BUCK_TOP_4PHASE_TOP_ANA_CON0     0x1688
#define MT6316_BUCK_TOP_4PHASE_TOP_ELR_0        0x1690

enum mt6316_type {
        MT6316_TYPE_2PHASE,
        MT6316_TYPE_3PHASE,
        MT6316_TYPE_4PHASE
};

/**
 * struct mt6316_regulator_info - MT6316 regulators information
 * @desc: Regulator description structure
 * @debug_reg: Debug register for regulator status
 * @lp_mode_reg: Low Power mode register (normal/idle)
 * @lp_mode_mask: Low Power mode regulator mask
 * @modeset_reg: AUTO/PWM mode register
 * @modeset_mask: AUTO/PWM regulator mask
 */
struct mt6316_regulator_info {
        struct regulator_desc desc;
        u16 debug_reg;
        u16 lp_mode_reg;
        u16 lp_mode_mask;
        u16 modeset_reg;
        u16 modeset_mask;
};

#define MT6316_BUCK(match, vreg_id, min, max, step, vs_reg)             \
{                                                                       \
        .desc = {                                                       \
                .name = match,                                          \
                .of_match = of_match_ptr(match),                        \
                .ops = &mt6316_vreg_setclr_ops,                         \
                .type = REGULATOR_VOLTAGE,                              \
                .owner = THIS_MODULE,                                   \
                .n_voltages = (max - min) / step + 1,                   \
                .min_uV = min,                                          \
                .uV_step = step,                                        \
                .enable_reg = MT6316_BUCK_TOP_CON0,                     \
                .enable_mask = BIT(vreg_id - 1),                        \
                .vsel_reg = vs_reg,                                     \
                .vsel_mask = MT6316_VSEL_MASK,                          \
                .of_map_mode = mt6316_map_mode,                         \
        },                                                              \
        .lp_mode_reg = MT6316_BUCK_TOP_CON1,                            \
        .lp_mode_mask = BIT(vreg_id - 1),                               \
        .modeset_reg = MT6316_BUCK_TOP_4PHASE_TOP_ANA_CON0,             \
        .modeset_mask = BIT(vreg_id - 1),                               \
        .debug_reg = MT6316_VBUCK##vreg_id##_DBG,                       \
}

/* Values in some MT6316 registers are big endian, 9 bits long... */
static inline u16 mt6316_be9_to_cpu(u16 val)
{
        return ((val >> 8) & BIT(0)) | ((val & GENMASK(7, 0)) << 1);
}

static inline u16 mt6316_cpu_to_be9(u16 val)
{
        return ((val & BIT(0)) << 8) | (val >> 1);
}

static unsigned int mt6316_map_mode(u32 mode)
{
        switch (mode) {
        case MT6316_BUCK_MODE_AUTO:
                return REGULATOR_MODE_NORMAL;
        case MT6316_BUCK_MODE_FORCE_PWM:
                return REGULATOR_MODE_FAST;
        case MT6316_BUCK_MODE_LP:
                return REGULATOR_MODE_IDLE;
        default:
                return REGULATOR_MODE_INVALID;
        }
}

static int mt6316_vreg_enable_setclr(struct regulator_dev *rdev)
{
        return regmap_write(rdev->regmap, rdev->desc->enable_reg + EN_SET_OFFSET,
                            rdev->desc->enable_mask);
}

static int mt6316_vreg_disable_setclr(struct regulator_dev *rdev)
{
        return regmap_write(rdev->regmap, rdev->desc->enable_reg + EN_CLR_OFFSET,
                            rdev->desc->enable_mask);
}

static int mt6316_regulator_set_voltage_sel(struct regulator_dev *rdev, unsigned int selector)
{
        u16 val = mt6316_cpu_to_be9(selector);

        return regmap_bulk_write(rdev->regmap, rdev->desc->vsel_reg, &val, sizeof(val));
}

static int mt6316_regulator_get_voltage_sel(struct regulator_dev *rdev)
{
        u16 val;
        int ret;

        ret = regmap_bulk_read(rdev->regmap, rdev->desc->vsel_reg, &val, sizeof(val));
        if (ret)
                return ret;

        return mt6316_be9_to_cpu(val & rdev->desc->vsel_mask);
}

static int mt6316_regulator_get_status(struct regulator_dev *rdev)
{
        struct mt6316_regulator_info *info = rdev_get_drvdata(rdev);
        u32 val;
        int ret;

        ret = regmap_read(rdev->regmap, info->debug_reg, &val);
        if (ret)
                return ret;

        return val & MT6316_BUCK_QI ? REGULATOR_STATUS_ON : REGULATOR_STATUS_OFF;
}

static unsigned int mt6316_regulator_get_mode(struct regulator_dev *rdev)
{
        struct mt6316_regulator_info *info = rdev_get_drvdata(rdev);
        unsigned int val;
        int ret;

        ret = regmap_read(rdev->regmap, info->modeset_reg, &val);
        if (ret) {
                dev_err(&rdev->dev, "Failed to get mode: %d\n", ret);
                return ret;
        }

        if ((val & info->modeset_mask) == info->modeset_mask)
                return REGULATOR_MODE_FAST;

        ret = regmap_read(rdev->regmap, info->lp_mode_reg, &val);
        val &= info->lp_mode_mask;
        if (ret) {
                dev_err(&rdev->dev, "Failed to get lp mode: %d\n", ret);
                return ret;
        }

        return val ? REGULATOR_MODE_IDLE : REGULATOR_MODE_NORMAL;
}

static int mt6316_regulator_set_mode(struct regulator_dev *rdev,
                                     unsigned int mode)
{
        struct mt6316_regulator_info *info = rdev_get_drvdata(rdev);
        struct regmap *regmap = rdev->regmap;
        int cur_mode, ret;

        switch (mode) {
        case REGULATOR_MODE_FAST:
                ret = regmap_set_bits(regmap, info->modeset_reg, info->modeset_mask);
                break;
        case REGULATOR_MODE_NORMAL:
                cur_mode = mt6316_regulator_get_mode(rdev);
                if (cur_mode < 0) {
                        ret = cur_mode;
                        break;
                }

                if (cur_mode == REGULATOR_MODE_FAST) {
                        ret = regmap_clear_bits(regmap, info->modeset_reg, info->modeset_mask);
                        break;
                } else if (cur_mode == REGULATOR_MODE_IDLE) {
                        ret = regmap_clear_bits(regmap, info->lp_mode_reg, info->lp_mode_mask);
                        if (ret == 0)
                                usleep_range(100, 200);
                } else {
                        ret = 0;
                }
                break;
        case REGULATOR_MODE_IDLE:
                ret = regmap_set_bits(regmap, info->lp_mode_reg, info->lp_mode_mask);
                break;
        default:
                ret = -EINVAL;
        }

        if (ret) {
                dev_err(&rdev->dev, "Failed to set mode %u: %d\n", mode, ret);
                return ret;
        }

        return 0;
}

static const struct regulator_ops mt6316_vreg_setclr_ops = {
        .list_voltage = regulator_list_voltage_linear,
        .map_voltage = regulator_map_voltage_linear,
        .set_voltage_sel = mt6316_regulator_set_voltage_sel,
        .get_voltage_sel = mt6316_regulator_get_voltage_sel,
        .set_voltage_time_sel = regulator_set_voltage_time_sel,
        .enable = mt6316_vreg_enable_setclr,
        .disable = mt6316_vreg_disable_setclr,
        .is_enabled = regulator_is_enabled_regmap,
        .get_status = mt6316_regulator_get_status,
        .set_mode = mt6316_regulator_set_mode,
        .get_mode = mt6316_regulator_get_mode,
};

/* MT6316BP/VP - 2+2 phase buck */
static struct mt6316_regulator_info mt6316bv_regulators[] = {
        MT6316_BUCK("vbuck12", 1, 0, 1277500, 2500, MT6316_BUCK_TOP_ELR0),
        MT6316_BUCK("vbuck34", 3, 0, 1277500, 2500, MT6316_BUCK_TOP_ELR4),
};

/* MT6316CP/HP/KP - 3+1 phase buck */
static struct mt6316_regulator_info mt6316chk_regulators[] = {
        MT6316_BUCK("vbuck124", 1, 0, 1277500, 2500, MT6316_BUCK_TOP_ELR0),
        MT6316_BUCK("vbuck3", 3, 0, 1277500, 2500, MT6316_BUCK_TOP_ELR4),
};

/* MT6316DP/TP - 4 phase buck */
static struct mt6316_regulator_info mt6316dt_regulators[] = {
        MT6316_BUCK("vbuck1234", 1, 0, 1277500, 2500, MT6316_BUCK_TOP_ELR0),
};

static const struct regmap_config mt6316_spmi_regmap_config = {
        .reg_bits       = 16,
        .val_bits       = 8,
        .max_register   = 0x1700,
        .fast_io        = true,
};

static int mt6316_regulator_probe(struct spmi_device *sdev)
{
        struct regulator_config config = {};
        struct mt6316_regulator_info *info;
        struct regulator_dev *rdev;
        enum mt6316_type type;
        int num_vregs, ret;
        unsigned int i;
        u32 chip_id;

        config.regmap = devm_regmap_init_spmi_ext(sdev, &mt6316_spmi_regmap_config);
        if (IS_ERR(config.regmap))
                return PTR_ERR(config.regmap);

        /*
         * The first read is expected to fail: this PMIC needs to be woken up
         * and that can be done with any activity over the SPMI bus.
         */
        regmap_read(config.regmap, MT6316_CHIP_ID, &chip_id);

        /* The second read, instead, shall not fail! */
        ret = regmap_read(config.regmap, MT6316_CHIP_ID, &chip_id);
        if (ret) {
                dev_err(&sdev->dev, "Cannot read Chip ID!\n");
                return ret;
        }
        dev_dbg(&sdev->dev, "Chip ID: 0x%x\n", chip_id);

        config.dev = &sdev->dev;

        type = (uintptr_t)device_get_match_data(&sdev->dev);
        switch (type) {
        case MT6316_TYPE_2PHASE:
                info = mt6316bv_regulators;
                num_vregs = ARRAY_SIZE(mt6316bv_regulators);
                break;
        case MT6316_TYPE_3PHASE:
                info = mt6316chk_regulators;
                num_vregs = ARRAY_SIZE(mt6316chk_regulators);
                break;
        case MT6316_TYPE_4PHASE:
                info = mt6316dt_regulators;
                num_vregs = ARRAY_SIZE(mt6316dt_regulators);
                break;
        default:
                return -EINVAL;
        }

        for (i = 0; i < num_vregs; i++) {
                config.driver_data = &info[i];

                rdev = devm_regulator_register(&sdev->dev, &info[i].desc, &config);
                if (IS_ERR(rdev))
                        return dev_err_probe(&sdev->dev, PTR_ERR(rdev),
                                             "failed to register %s\n", info[i].desc.name);
        }

        return 0;
}

static const struct of_device_id mt6316_regulator_match[] = {
        { .compatible = "mediatek,mt6316b-regulator", .data = (void *)MT6316_TYPE_2PHASE },
        { .compatible = "mediatek,mt6316c-regulator", .data = (void *)MT6316_TYPE_3PHASE },
        { .compatible = "mediatek,mt6316d-regulator", .data = (void *)MT6316_TYPE_4PHASE },
        { /* sentinel */ }
};

static struct spmi_driver mt6316_regulator_driver = {
        .driver = {
                .name = "mt6316-regulator",
                .probe_type = PROBE_PREFER_ASYNCHRONOUS,
                .of_match_table = mt6316_regulator_match,
        },
        .probe = mt6316_regulator_probe,
};
module_spmi_driver(mt6316_regulator_driver);

MODULE_AUTHOR("AngeloGioacchino Del Regno <angelogioacchino.delregno@collabora.com>");
MODULE_DESCRIPTION("Regulator Driver for MediaTek MT6316 PMIC");
MODULE_LICENSE("GPL");