linux/drivers/regulator/stm32-vrefbuf.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * Copyright (C) STMicroelectronics 2017
   4 *
   5 * Author: Fabrice Gasnier <fabrice.gasnier@st.com>
   6 */
   7
   8#include <linux/bitfield.h>
   9#include <linux/clk.h>
  10#include <linux/io.h>
  11#include <linux/iopoll.h>
  12#include <linux/module.h>
  13#include <linux/of_device.h>
  14#include <linux/platform_device.h>
  15#include <linux/regulator/driver.h>
  16#include <linux/regulator/of_regulator.h>
  17#include <linux/pm_runtime.h>
  18
  19/* STM32 VREFBUF registers */
  20#define STM32_VREFBUF_CSR               0x00
  21
  22/* STM32 VREFBUF CSR bitfields */
  23#define STM32_VRS                       GENMASK(6, 4)
  24#define STM32_VRR                       BIT(3)
  25#define STM32_HIZ                       BIT(1)
  26#define STM32_ENVR                      BIT(0)
  27
  28#define STM32_VREFBUF_AUTO_SUSPEND_DELAY_MS     10
  29
  30struct stm32_vrefbuf {
  31        void __iomem *base;
  32        struct clk *clk;
  33        struct device *dev;
  34};
  35
  36static const unsigned int stm32_vrefbuf_voltages[] = {
  37        /* Matches resp. VRS = 000b, 001b, 010b, 011b */
  38        2500000, 2048000, 1800000, 1500000,
  39};
  40
  41static int stm32_vrefbuf_enable(struct regulator_dev *rdev)
  42{
  43        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
  44        u32 val;
  45        int ret;
  46
  47        ret = pm_runtime_get_sync(priv->dev);
  48        if (ret < 0) {
  49                pm_runtime_put_noidle(priv->dev);
  50                return ret;
  51        }
  52
  53        val = readl_relaxed(priv->base + STM32_VREFBUF_CSR);
  54        val = (val & ~STM32_HIZ) | STM32_ENVR;
  55        writel_relaxed(val, priv->base + STM32_VREFBUF_CSR);
  56
  57        /*
  58         * Vrefbuf startup time depends on external capacitor: wait here for
  59         * VRR to be set. That means output has reached expected value.
  60         * ~650us sleep should be enough for caps up to 1.5uF. Use 10ms as
  61         * arbitrary timeout.
  62         */
  63        ret = readl_poll_timeout(priv->base + STM32_VREFBUF_CSR, val,
  64                                 val & STM32_VRR, 650, 10000);
  65        if (ret) {
  66                dev_err(&rdev->dev, "stm32 vrefbuf timed out!\n");
  67                val = readl_relaxed(priv->base + STM32_VREFBUF_CSR);
  68                val = (val & ~STM32_ENVR) | STM32_HIZ;
  69                writel_relaxed(val, priv->base + STM32_VREFBUF_CSR);
  70        }
  71
  72        pm_runtime_mark_last_busy(priv->dev);
  73        pm_runtime_put_autosuspend(priv->dev);
  74
  75        return ret;
  76}
  77
  78static int stm32_vrefbuf_disable(struct regulator_dev *rdev)
  79{
  80        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
  81        u32 val;
  82        int ret;
  83
  84        ret = pm_runtime_get_sync(priv->dev);
  85        if (ret < 0) {
  86                pm_runtime_put_noidle(priv->dev);
  87                return ret;
  88        }
  89
  90        val = readl_relaxed(priv->base + STM32_VREFBUF_CSR);
  91        val = (val & ~STM32_ENVR) | STM32_HIZ;
  92        writel_relaxed(val, priv->base + STM32_VREFBUF_CSR);
  93
  94        pm_runtime_mark_last_busy(priv->dev);
  95        pm_runtime_put_autosuspend(priv->dev);
  96
  97        return 0;
  98}
  99
 100static int stm32_vrefbuf_is_enabled(struct regulator_dev *rdev)
 101{
 102        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
 103        int ret;
 104
 105        ret = pm_runtime_get_sync(priv->dev);
 106        if (ret < 0) {
 107                pm_runtime_put_noidle(priv->dev);
 108                return ret;
 109        }
 110
 111        ret = readl_relaxed(priv->base + STM32_VREFBUF_CSR) & STM32_ENVR;
 112
 113        pm_runtime_mark_last_busy(priv->dev);
 114        pm_runtime_put_autosuspend(priv->dev);
 115
 116        return ret;
 117}
 118
 119static int stm32_vrefbuf_set_voltage_sel(struct regulator_dev *rdev,
 120                                         unsigned sel)
 121{
 122        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
 123        u32 val;
 124        int ret;
 125
 126        ret = pm_runtime_get_sync(priv->dev);
 127        if (ret < 0) {
 128                pm_runtime_put_noidle(priv->dev);
 129                return ret;
 130        }
 131
 132        val = readl_relaxed(priv->base + STM32_VREFBUF_CSR);
 133        val = (val & ~STM32_VRS) | FIELD_PREP(STM32_VRS, sel);
 134        writel_relaxed(val, priv->base + STM32_VREFBUF_CSR);
 135
 136        pm_runtime_mark_last_busy(priv->dev);
 137        pm_runtime_put_autosuspend(priv->dev);
 138
 139        return 0;
 140}
 141
 142static int stm32_vrefbuf_get_voltage_sel(struct regulator_dev *rdev)
 143{
 144        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
 145        u32 val;
 146        int ret;
 147
 148        ret = pm_runtime_get_sync(priv->dev);
 149        if (ret < 0) {
 150                pm_runtime_put_noidle(priv->dev);
 151                return ret;
 152        }
 153
 154        val = readl_relaxed(priv->base + STM32_VREFBUF_CSR);
 155        ret = FIELD_GET(STM32_VRS, val);
 156
 157        pm_runtime_mark_last_busy(priv->dev);
 158        pm_runtime_put_autosuspend(priv->dev);
 159
 160        return ret;
 161}
 162
 163static const struct regulator_ops stm32_vrefbuf_volt_ops = {
 164        .enable         = stm32_vrefbuf_enable,
 165        .disable        = stm32_vrefbuf_disable,
 166        .is_enabled     = stm32_vrefbuf_is_enabled,
 167        .get_voltage_sel = stm32_vrefbuf_get_voltage_sel,
 168        .set_voltage_sel = stm32_vrefbuf_set_voltage_sel,
 169        .list_voltage   = regulator_list_voltage_table,
 170};
 171
 172static const struct regulator_desc stm32_vrefbuf_regu = {
 173        .name = "vref",
 174        .supply_name = "vdda",
 175        .volt_table = stm32_vrefbuf_voltages,
 176        .n_voltages = ARRAY_SIZE(stm32_vrefbuf_voltages),
 177        .ops = &stm32_vrefbuf_volt_ops,
 178        .type = REGULATOR_VOLTAGE,
 179        .owner = THIS_MODULE,
 180};
 181
 182static int stm32_vrefbuf_probe(struct platform_device *pdev)
 183{
 184        struct resource *res;
 185        struct stm32_vrefbuf *priv;
 186        struct regulator_config config = { };
 187        struct regulator_dev *rdev;
 188        int ret;
 189
 190        priv = devm_kzalloc(&pdev->dev, sizeof(*priv), GFP_KERNEL);
 191        if (!priv)
 192                return -ENOMEM;
 193        priv->dev = &pdev->dev;
 194
 195        res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
 196        priv->base = devm_ioremap_resource(&pdev->dev, res);
 197        if (IS_ERR(priv->base))
 198                return PTR_ERR(priv->base);
 199
 200        priv->clk = devm_clk_get(&pdev->dev, NULL);
 201        if (IS_ERR(priv->clk))
 202                return PTR_ERR(priv->clk);
 203
 204        pm_runtime_get_noresume(&pdev->dev);
 205        pm_runtime_set_active(&pdev->dev);
 206        pm_runtime_set_autosuspend_delay(&pdev->dev,
 207                                         STM32_VREFBUF_AUTO_SUSPEND_DELAY_MS);
 208        pm_runtime_use_autosuspend(&pdev->dev);
 209        pm_runtime_enable(&pdev->dev);
 210
 211        ret = clk_prepare_enable(priv->clk);
 212        if (ret) {
 213                dev_err(&pdev->dev, "clk prepare failed with error %d\n", ret);
 214                goto err_pm_stop;
 215        }
 216
 217        config.dev = &pdev->dev;
 218        config.driver_data = priv;
 219        config.of_node = pdev->dev.of_node;
 220        config.init_data = of_get_regulator_init_data(&pdev->dev,
 221                                                      pdev->dev.of_node,
 222                                                      &stm32_vrefbuf_regu);
 223
 224        rdev = regulator_register(&stm32_vrefbuf_regu, &config);
 225        if (IS_ERR(rdev)) {
 226                ret = PTR_ERR(rdev);
 227                dev_err(&pdev->dev, "register failed with error %d\n", ret);
 228                goto err_clk_dis;
 229        }
 230        platform_set_drvdata(pdev, rdev);
 231
 232        pm_runtime_mark_last_busy(&pdev->dev);
 233        pm_runtime_put_autosuspend(&pdev->dev);
 234
 235        return 0;
 236
 237err_clk_dis:
 238        clk_disable_unprepare(priv->clk);
 239err_pm_stop:
 240        pm_runtime_disable(&pdev->dev);
 241        pm_runtime_set_suspended(&pdev->dev);
 242        pm_runtime_put_noidle(&pdev->dev);
 243
 244        return ret;
 245}
 246
 247static int stm32_vrefbuf_remove(struct platform_device *pdev)
 248{
 249        struct regulator_dev *rdev = platform_get_drvdata(pdev);
 250        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
 251
 252        pm_runtime_get_sync(&pdev->dev);
 253        regulator_unregister(rdev);
 254        clk_disable_unprepare(priv->clk);
 255        pm_runtime_disable(&pdev->dev);
 256        pm_runtime_set_suspended(&pdev->dev);
 257        pm_runtime_put_noidle(&pdev->dev);
 258
 259        return 0;
 260};
 261
 262static int __maybe_unused stm32_vrefbuf_runtime_suspend(struct device *dev)
 263{
 264        struct regulator_dev *rdev = dev_get_drvdata(dev);
 265        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
 266
 267        clk_disable_unprepare(priv->clk);
 268
 269        return 0;
 270}
 271
 272static int __maybe_unused stm32_vrefbuf_runtime_resume(struct device *dev)
 273{
 274        struct regulator_dev *rdev = dev_get_drvdata(dev);
 275        struct stm32_vrefbuf *priv = rdev_get_drvdata(rdev);
 276
 277        return clk_prepare_enable(priv->clk);
 278}
 279
 280static const struct dev_pm_ops stm32_vrefbuf_pm_ops = {
 281        SET_SYSTEM_SLEEP_PM_OPS(pm_runtime_force_suspend,
 282                                pm_runtime_force_resume)
 283        SET_RUNTIME_PM_OPS(stm32_vrefbuf_runtime_suspend,
 284                           stm32_vrefbuf_runtime_resume,
 285                           NULL)
 286};
 287
 288static const struct of_device_id stm32_vrefbuf_of_match[] = {
 289        { .compatible = "st,stm32-vrefbuf", },
 290        {},
 291};
 292MODULE_DEVICE_TABLE(of, stm32_vrefbuf_of_match);
 293
 294static struct platform_driver stm32_vrefbuf_driver = {
 295        .probe = stm32_vrefbuf_probe,
 296        .remove = stm32_vrefbuf_remove,
 297        .driver = {
 298                .name  = "stm32-vrefbuf",
 299                .of_match_table = of_match_ptr(stm32_vrefbuf_of_match),
 300                .pm = &stm32_vrefbuf_pm_ops,
 301        },
 302};
 303module_platform_driver(stm32_vrefbuf_driver);
 304
 305MODULE_LICENSE("GPL v2");
 306MODULE_AUTHOR("Fabrice Gasnier <fabrice.gasnier@st.com>");
 307MODULE_DESCRIPTION("STMicroelectronics STM32 VREFBUF driver");
 308MODULE_ALIAS("platform:stm32-vrefbuf");
 309