1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * StarFive JH71XX PMU (Power Management Unit) Controller Driver
5 * Copyright (C) 2022 StarFive Technology Co., Ltd.
8 #include <linux/interrupt.h>
10 #include <linux/iopoll.h>
11 #include <linux/module.h>
13 #include <linux/of_device.h>
14 #include <linux/platform_device.h>
15 #include <linux/pm_domain.h>
16 #include <dt-bindings/power/starfive,jh7110-pmu.h>
19 #define JH71XX_PMU_SW_TURN_ON_POWER 0x0C
20 #define JH71XX_PMU_SW_TURN_OFF_POWER 0x10
21 #define JH71XX_PMU_SW_ENCOURAGE 0x44
22 #define JH71XX_PMU_TIMER_INT_MASK 0x48
23 #define JH71XX_PMU_CURR_POWER_MODE 0x80
24 #define JH71XX_PMU_EVENT_STATUS 0x88
25 #define JH71XX_PMU_INT_STATUS 0x8C
27 /* sw encourage cfg */
28 #define JH71XX_PMU_SW_ENCOURAGE_EN_LO 0x05
29 #define JH71XX_PMU_SW_ENCOURAGE_EN_HI 0x50
30 #define JH71XX_PMU_SW_ENCOURAGE_DIS_LO 0x0A
31 #define JH71XX_PMU_SW_ENCOURAGE_DIS_HI 0xA0
32 #define JH71XX_PMU_SW_ENCOURAGE_ON 0xFF
35 #define JH71XX_PMU_INT_SEQ_DONE BIT(0)
36 #define JH71XX_PMU_INT_HW_REQ BIT(1)
37 #define JH71XX_PMU_INT_SW_FAIL GENMASK(3, 2)
38 #define JH71XX_PMU_INT_HW_FAIL GENMASK(5, 4)
39 #define JH71XX_PMU_INT_PCH_FAIL GENMASK(8, 6)
40 #define JH71XX_PMU_INT_ALL_MASK GENMASK(8, 0)
43 * The time required for switching power status is based on the time
44 * to turn on the largest domain's power, which is at microsecond level
46 #define JH71XX_PMU_TIMEOUT_US 100
48 struct jh71xx_domain_info {
49 const char * const name;
54 struct jh71xx_pmu_match_data {
55 const struct jh71xx_domain_info *domain_info;
61 const struct jh71xx_pmu_match_data *match_data;
63 struct generic_pm_domain **genpd;
64 struct genpd_onecell_data genpd_data;
66 spinlock_t lock; /* protects pmu reg */
69 struct jh71xx_pmu_dev {
70 const struct jh71xx_domain_info *domain_info;
71 struct jh71xx_pmu *pmu;
72 struct generic_pm_domain genpd;
75 static int jh71xx_pmu_get_state(struct jh71xx_pmu_dev *pmd, u32 mask, bool *is_on)
77 struct jh71xx_pmu *pmu = pmd->pmu;
82 *is_on = readl(pmu->base + JH71XX_PMU_CURR_POWER_MODE) & mask;
87 static int jh71xx_pmu_set_state(struct jh71xx_pmu_dev *pmd, u32 mask, bool on)
89 struct jh71xx_pmu *pmu = pmd->pmu;
98 ret = jh71xx_pmu_get_state(pmd, mask, &is_on);
100 dev_dbg(pmu->dev, "unable to get current state for %s\n",
106 dev_dbg(pmu->dev, "pm domain [%s] is already %sable status.\n",
107 pmd->genpd.name, on ? "en" : "dis");
111 spin_lock_irqsave(&pmu->lock, flags);
114 * The PMU accepts software encourage to switch power mode in the following 2 steps:
116 * 1.Configure the register SW_TURN_ON_POWER (offset 0x0c) by writing 1 to
117 * the bit corresponding to the power domain that will be turned on
118 * and writing 0 to the others.
119 * Likewise, configure the register SW_TURN_OFF_POWER (offset 0x10) by
120 * writing 1 to the bit corresponding to the power domain that will be
121 * turned off and writing 0 to the others.
124 mode = JH71XX_PMU_SW_TURN_ON_POWER;
125 encourage_lo = JH71XX_PMU_SW_ENCOURAGE_EN_LO;
126 encourage_hi = JH71XX_PMU_SW_ENCOURAGE_EN_HI;
128 mode = JH71XX_PMU_SW_TURN_OFF_POWER;
129 encourage_lo = JH71XX_PMU_SW_ENCOURAGE_DIS_LO;
130 encourage_hi = JH71XX_PMU_SW_ENCOURAGE_DIS_HI;
133 writel(mask, pmu->base + mode);
136 * 2.Write SW encourage command sequence to the Software Encourage Reg (offset 0x44)
137 * First write SW_MODE_ENCOURAGE_ON to JH71XX_PMU_SW_ENCOURAGE. This will reset
138 * the state machine which parses the command sequence. This register must be
139 * written every time software wants to power on/off a domain.
140 * Then write the lower bits of the command sequence, followed by the upper
141 * bits. The sequence differs between powering on & off a domain.
143 writel(JH71XX_PMU_SW_ENCOURAGE_ON, pmu->base + JH71XX_PMU_SW_ENCOURAGE);
144 writel(encourage_lo, pmu->base + JH71XX_PMU_SW_ENCOURAGE);
145 writel(encourage_hi, pmu->base + JH71XX_PMU_SW_ENCOURAGE);
147 spin_unlock_irqrestore(&pmu->lock, flags);
149 /* Wait for the power domain bit to be enabled / disabled */
151 ret = readl_poll_timeout_atomic(pmu->base + JH71XX_PMU_CURR_POWER_MODE,
153 1, JH71XX_PMU_TIMEOUT_US);
155 ret = readl_poll_timeout_atomic(pmu->base + JH71XX_PMU_CURR_POWER_MODE,
157 1, JH71XX_PMU_TIMEOUT_US);
161 dev_err(pmu->dev, "%s: failed to power %s\n",
162 pmd->genpd.name, on ? "on" : "off");
169 static int jh71xx_pmu_on(struct generic_pm_domain *genpd)
171 struct jh71xx_pmu_dev *pmd = container_of(genpd,
172 struct jh71xx_pmu_dev, genpd);
173 u32 pwr_mask = BIT(pmd->domain_info->bit);
175 return jh71xx_pmu_set_state(pmd, pwr_mask, true);
178 static int jh71xx_pmu_off(struct generic_pm_domain *genpd)
180 struct jh71xx_pmu_dev *pmd = container_of(genpd,
181 struct jh71xx_pmu_dev, genpd);
182 u32 pwr_mask = BIT(pmd->domain_info->bit);
184 return jh71xx_pmu_set_state(pmd, pwr_mask, false);
187 static void jh71xx_pmu_int_enable(struct jh71xx_pmu *pmu, u32 mask, bool enable)
192 spin_lock_irqsave(&pmu->lock, flags);
193 val = readl(pmu->base + JH71XX_PMU_TIMER_INT_MASK);
200 writel(val, pmu->base + JH71XX_PMU_TIMER_INT_MASK);
201 spin_unlock_irqrestore(&pmu->lock, flags);
204 static irqreturn_t jh71xx_pmu_interrupt(int irq, void *data)
206 struct jh71xx_pmu *pmu = data;
209 val = readl(pmu->base + JH71XX_PMU_INT_STATUS);
211 if (val & JH71XX_PMU_INT_SEQ_DONE)
212 dev_dbg(pmu->dev, "sequence done.\n");
213 if (val & JH71XX_PMU_INT_HW_REQ)
214 dev_dbg(pmu->dev, "hardware encourage requestion.\n");
215 if (val & JH71XX_PMU_INT_SW_FAIL)
216 dev_err(pmu->dev, "software encourage fail.\n");
217 if (val & JH71XX_PMU_INT_HW_FAIL)
218 dev_err(pmu->dev, "hardware encourage fail.\n");
219 if (val & JH71XX_PMU_INT_PCH_FAIL)
220 dev_err(pmu->dev, "p-channel fail event.\n");
222 /* clear interrupts */
223 writel(val, pmu->base + JH71XX_PMU_INT_STATUS);
224 writel(val, pmu->base + JH71XX_PMU_EVENT_STATUS);
229 static int jh71xx_pmu_init_domain(struct jh71xx_pmu *pmu, int index)
231 struct jh71xx_pmu_dev *pmd;
236 pmd = devm_kzalloc(pmu->dev, sizeof(*pmd), GFP_KERNEL);
240 pmd->domain_info = &pmu->match_data->domain_info[index];
242 pwr_mask = BIT(pmd->domain_info->bit);
244 pmd->genpd.name = pmd->domain_info->name;
245 pmd->genpd.flags = pmd->domain_info->flags;
247 ret = jh71xx_pmu_get_state(pmd, pwr_mask, &is_on);
249 dev_warn(pmu->dev, "unable to get current state for %s\n",
252 pmd->genpd.power_on = jh71xx_pmu_on;
253 pmd->genpd.power_off = jh71xx_pmu_off;
254 pm_genpd_init(&pmd->genpd, NULL, !is_on);
256 pmu->genpd_data.domains[index] = &pmd->genpd;
261 static int jh71xx_pmu_probe(struct platform_device *pdev)
263 struct device *dev = &pdev->dev;
264 struct device_node *np = dev->of_node;
265 const struct jh71xx_pmu_match_data *match_data;
266 struct jh71xx_pmu *pmu;
270 pmu = devm_kzalloc(dev, sizeof(*pmu), GFP_KERNEL);
274 pmu->base = devm_platform_ioremap_resource(pdev, 0);
275 if (IS_ERR(pmu->base))
276 return PTR_ERR(pmu->base);
278 pmu->irq = platform_get_irq(pdev, 0);
282 ret = devm_request_irq(dev, pmu->irq, jh71xx_pmu_interrupt,
285 dev_err(dev, "failed to request irq\n");
287 match_data = of_device_get_match_data(dev);
291 pmu->genpd = devm_kcalloc(dev, match_data->num_domains,
292 sizeof(struct generic_pm_domain *),
298 pmu->match_data = match_data;
299 pmu->genpd_data.domains = pmu->genpd;
300 pmu->genpd_data.num_domains = match_data->num_domains;
302 for (i = 0; i < match_data->num_domains; i++) {
303 ret = jh71xx_pmu_init_domain(pmu, i);
305 dev_err(dev, "failed to initialize power domain\n");
310 spin_lock_init(&pmu->lock);
311 jh71xx_pmu_int_enable(pmu, JH71XX_PMU_INT_ALL_MASK & ~JH71XX_PMU_INT_PCH_FAIL, true);
313 ret = of_genpd_add_provider_onecell(np, &pmu->genpd_data);
315 dev_err(dev, "failed to register genpd driver: %d\n", ret);
319 dev_dbg(dev, "registered %u power domains\n", i);
324 static const struct jh71xx_domain_info jh7110_power_domains[] = {
325 [JH7110_PD_SYSTOP] = {
328 .flags = GENPD_FLAG_ALWAYS_ON,
333 .flags = GENPD_FLAG_ALWAYS_ON,
357 static const struct jh71xx_pmu_match_data jh7110_pmu = {
358 .num_domains = ARRAY_SIZE(jh7110_power_domains),
359 .domain_info = jh7110_power_domains,
362 static const struct of_device_id jh71xx_pmu_of_match[] = {
364 .compatible = "starfive,jh7110-pmu",
365 .data = (void *)&jh7110_pmu,
371 static struct platform_driver jh71xx_pmu_driver = {
372 .probe = jh71xx_pmu_probe,
374 .name = "jh71xx-pmu",
375 .of_match_table = jh71xx_pmu_of_match,
376 .suppress_bind_attrs = true,
379 builtin_platform_driver(jh71xx_pmu_driver);
381 MODULE_AUTHOR("Walker Chen <walker.chen@starfivetech.com>");
382 MODULE_DESCRIPTION("StarFive JH71XX PMU Driver");
383 MODULE_LICENSE("GPL");