1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3 * Copyright (C) 2016 Freescale Semiconductor, Inc.
4 * Copyright 2017-2018 NXP
5 * Dong Aisheng <aisheng.dong@nxp.com>
6 *
7 * Implementation of the SCU based Power Domains
8 *
9 * NOTE: a better implementation suggested by Ulf Hansson is using a
10 * single global power domain and implement the ->attach|detach_dev()
11 * callback for the genpd and use the regular of_genpd_add_provider_simple().
12 * From within the ->attach_dev(), we could get the OF node for
13 * the device that is being attached and then parse the power-domain
14 * cell containing the "resource id" and store that in the per device
15 * struct generic_pm_domain_data (we have void pointer there for
16 * storing these kind of things).
17 *
18 * Additionally, we need to implement the ->stop() and ->start()
19 * callbacks of genpd, which is where you "power on/off" devices,
20 * rather than using the above ->power_on|off() callbacks.
21 *
22 * However, there're two known issues:
23 * 1. The ->attach_dev() of power domain infrastructure still does
24 * not support multi domains case as the struct device *dev passed
25 * in is a virtual PD device, it does not help for parsing the real
26 * device resource id from device tree, so it's unware of which
27 * real sub power domain of device should be attached.
28 *
29 * The framework needs some proper extension to support multi power
30 * domain cases.
31 *
32 * Update: Genpd assigns the ->of_node for the virtual device before it
33 * invokes ->attach_dev() callback, hence parsing for device resources via
34 * DT should work fine.
35 *
36 * 2. It also breaks most of current drivers as the driver probe sequence
37 * behavior changed if removing ->power_on|off() callback and use
38 * ->start() and ->stop() instead. genpd_dev_pm_attach will only power
39 * up the domain and attach device, but will not call .start() which
40 * relies on device runtime pm. That means the device power is still
41 * not up before running driver probe function. For SCU enabled
42 * platforms, all device drivers accessing registers/clock without power
43 * domain enabled will trigger a HW access error. That means we need fix
44 * most drivers probe sequence with proper runtime pm.
45 *
46 * Update: Runtime PM support isn't necessary. Instead, this can easily be
47 * fixed in drivers by adding a call to dev_pm_domain_start() during probe.
48 *
49 * In summary, the second part needs to be addressed via minor updates to the
50 * relevant drivers, before the "single global power domain" model can be used.
51 *
52 */
53
54 #include <dt-bindings/firmware/imx/rsrc.h>
55 #include <linux/firmware/imx/sci.h>
56 #include <linux/firmware/imx/svc/rm.h>
57 #include <linux/io.h>
58 #include <linux/module.h>
59 #include <linux/of.h>
60 #include <linux/of_address.h>
61 #include <linux/of_platform.h>
62 #include <linux/platform_device.h>
63 #include <linux/pm.h>
64 #include <linux/pm_domain.h>
65 #include <linux/slab.h>
66
67 /* SCU Power Mode Protocol definition */
68 struct imx_sc_msg_req_set_resource_power_mode {
69 struct imx_sc_rpc_msg hdr;
70 u16 resource;
71 u8 mode;
72 } __packed __aligned(4);
73
74 #define IMX_SCU_PD_NAME_SIZE 20
75 struct imx_sc_pm_domain {
76 struct generic_pm_domain pd;
77 char name[IMX_SCU_PD_NAME_SIZE];
78 u32 rsrc;
79 };
80
81 struct imx_sc_pd_range {
82 char *name;
83 u32 rsrc;
84 u8 num;
85
86 /* add domain index */
87 bool postfix;
88 u8 start_from;
89 };
90
91 struct imx_sc_pd_soc {
92 const struct imx_sc_pd_range *pd_ranges;
93 u8 num_ranges;
94 };
95
96 static int imx_con_rsrc;
97
98 static const struct imx_sc_pd_range imx8qxp_scu_pd_ranges[] = {
99 /* LSIO SS */
100 { "pwm", IMX_SC_R_PWM_0, 8, true, 0 },
101 { "gpio", IMX_SC_R_GPIO_0, 8, true, 0 },
102 { "gpt", IMX_SC_R_GPT_0, 5, true, 0 },
103 { "kpp", IMX_SC_R_KPP, 1, false, 0 },
104 { "fspi", IMX_SC_R_FSPI_0, 2, true, 0 },
105 { "mu_a", IMX_SC_R_MU_0A, 14, true, 0 },
106 { "mu_b", IMX_SC_R_MU_5B, 9, true, 5 },
107
108 /* CONN SS */
109 { "usb", IMX_SC_R_USB_0, 2, true, 0 },
110 { "usb0phy", IMX_SC_R_USB_0_PHY, 1, false, 0 },
111 { "usb2", IMX_SC_R_USB_2, 1, false, 0 },
112 { "usb2phy", IMX_SC_R_USB_2_PHY, 1, false, 0 },
113 { "sdhc", IMX_SC_R_SDHC_0, 3, true, 0 },
114 { "enet", IMX_SC_R_ENET_0, 2, true, 0 },
115 { "nand", IMX_SC_R_NAND, 1, false, 0 },
116 { "mlb", IMX_SC_R_MLB_0, 1, true, 0 },
117
118 /* AUDIO SS */
119 { "audio-pll0", IMX_SC_R_AUDIO_PLL_0, 1, false, 0 },
120 { "audio-pll1", IMX_SC_R_AUDIO_PLL_1, 1, false, 0 },
121 { "audio-clk-0", IMX_SC_R_AUDIO_CLK_0, 1, false, 0 },
122 { "audio-clk-1", IMX_SC_R_AUDIO_CLK_1, 1, false, 0 },
123 { "dma0-ch", IMX_SC_R_DMA_0_CH0, 16, true, 0 },
124 { "dma1-ch", IMX_SC_R_DMA_1_CH0, 16, true, 0 },
125 { "dma2-ch", IMX_SC_R_DMA_2_CH0, 5, true, 0 },
126 { "asrc0", IMX_SC_R_ASRC_0, 1, false, 0 },
127 { "asrc1", IMX_SC_R_ASRC_1, 1, false, 0 },
128 { "esai0", IMX_SC_R_ESAI_0, 1, false, 0 },
129 { "spdif0", IMX_SC_R_SPDIF_0, 1, false, 0 },
130 { "spdif1", IMX_SC_R_SPDIF_1, 1, false, 0 },
131 { "sai", IMX_SC_R_SAI_0, 3, true, 0 },
132 { "sai3", IMX_SC_R_SAI_3, 1, false, 0 },
133 { "sai4", IMX_SC_R_SAI_4, 1, false, 0 },
134 { "sai5", IMX_SC_R_SAI_5, 1, false, 0 },
135 { "sai6", IMX_SC_R_SAI_6, 1, false, 0 },
136 { "sai7", IMX_SC_R_SAI_7, 1, false, 0 },
137 { "amix", IMX_SC_R_AMIX, 1, false, 0 },
138 { "mqs0", IMX_SC_R_MQS_0, 1, false, 0 },
139 { "dsp", IMX_SC_R_DSP, 1, false, 0 },
140 { "dsp-ram", IMX_SC_R_DSP_RAM, 1, false, 0 },
141
142 /* DMA SS */
143 { "can", IMX_SC_R_CAN_0, 3, true, 0 },
144 { "ftm", IMX_SC_R_FTM_0, 2, true, 0 },
145 { "lpi2c", IMX_SC_R_I2C_0, 4, true, 0 },
146 { "adc", IMX_SC_R_ADC_0, 2, true, 0 },
147 { "lcd", IMX_SC_R_LCD_0, 1, true, 0 },
148 { "lcd0-pwm", IMX_SC_R_LCD_0_PWM_0, 1, true, 0 },
149 { "lpuart", IMX_SC_R_UART_0, 4, true, 0 },
150 { "lpspi", IMX_SC_R_SPI_0, 4, true, 0 },
151 { "irqstr_dsp", IMX_SC_R_IRQSTR_DSP, 1, false, 0 },
152
153 /* VPU SS */
154 { "vpu", IMX_SC_R_VPU, 1, false, 0 },
155 { "vpu-pid", IMX_SC_R_VPU_PID0, 8, true, 0 },
156 { "vpu-dec0", IMX_SC_R_VPU_DEC_0, 1, false, 0 },
157 { "vpu-enc0", IMX_SC_R_VPU_ENC_0, 1, false, 0 },
158
159 /* GPU SS */
160 { "gpu0-pid", IMX_SC_R_GPU_0_PID0, 4, true, 0 },
161
162 /* HSIO SS */
163 { "pcie-b", IMX_SC_R_PCIE_B, 1, false, 0 },
164 { "serdes-1", IMX_SC_R_SERDES_1, 1, false, 0 },
165 { "hsio-gpio", IMX_SC_R_HSIO_GPIO, 1, false, 0 },
166
167 /* MIPI SS */
168 { "mipi0", IMX_SC_R_MIPI_0, 1, false, 0 },
169 { "mipi0-pwm0", IMX_SC_R_MIPI_0_PWM_0, 1, false, 0 },
170 { "mipi0-i2c", IMX_SC_R_MIPI_0_I2C_0, 2, true, 0 },
171
172 { "mipi1", IMX_SC_R_MIPI_1, 1, false, 0 },
173 { "mipi1-pwm0", IMX_SC_R_MIPI_1_PWM_0, 1, false, 0 },
174 { "mipi1-i2c", IMX_SC_R_MIPI_1_I2C_0, 2, true, 0 },
175
176 /* LVDS SS */
177 { "lvds0", IMX_SC_R_LVDS_0, 1, false, 0 },
178 { "lvds1", IMX_SC_R_LVDS_1, 1, false, 0 },
179
180 /* DC SS */
181 { "dc0", IMX_SC_R_DC_0, 1, false, 0 },
182 { "dc0-pll", IMX_SC_R_DC_0_PLL_0, 2, true, 0 },
183 { "dc0-video", IMX_SC_R_DC_0_VIDEO0, 2, true, 0 },
184
185 /* CM40 SS */
186 { "cm40-i2c", IMX_SC_R_M4_0_I2C, 1, false, 0 },
187 { "cm40-intmux", IMX_SC_R_M4_0_INTMUX, 1, false, 0 },
188 { "cm40-pid", IMX_SC_R_M4_0_PID0, 5, true, 0},
189 { "cm40-mu-a1", IMX_SC_R_M4_0_MU_1A, 1, false, 0},
190 { "cm40-lpuart", IMX_SC_R_M4_0_UART, 1, false, 0},
191
192 /* CM41 SS */
193 { "cm41-i2c", IMX_SC_R_M4_1_I2C, 1, false, 0 },
194 { "cm41-intmux", IMX_SC_R_M4_1_INTMUX, 1, false, 0 },
195 { "cm41-pid", IMX_SC_R_M4_1_PID0, 5, true, 0},
196 { "cm41-mu-a1", IMX_SC_R_M4_1_MU_1A, 1, false, 0},
197 { "cm41-lpuart", IMX_SC_R_M4_1_UART, 1, false, 0},
198
199 /* IMAGE SS */
200 { "img-jpegdec-mp", IMX_SC_R_MJPEG_DEC_MP, 1, false, 0 },
201 { "img-jpegdec-s0", IMX_SC_R_MJPEG_DEC_S0, 4, true, 0 },
202 { "img-jpegenc-mp", IMX_SC_R_MJPEG_ENC_MP, 1, false, 0 },
203 { "img-jpegenc-s0", IMX_SC_R_MJPEG_ENC_S0, 4, true, 0 },
204 };
205
206 static const struct imx_sc_pd_soc imx8qxp_scu_pd = {
207 .pd_ranges = imx8qxp_scu_pd_ranges,
208 .num_ranges = ARRAY_SIZE(imx8qxp_scu_pd_ranges),
209 };
210
211 static struct imx_sc_ipc *pm_ipc_handle;
212
213 static inline struct imx_sc_pm_domain *
to_imx_sc_pd(struct generic_pm_domain * genpd)214 to_imx_sc_pd(struct generic_pm_domain *genpd)
215 {
216 return container_of(genpd, struct imx_sc_pm_domain, pd);
217 }
218
imx_sc_pd_get_console_rsrc(void)219 static void imx_sc_pd_get_console_rsrc(void)
220 {
221 struct of_phandle_args specs;
222 int ret;
223
224 if (!of_stdout)
225 return;
226
227 ret = of_parse_phandle_with_args(of_stdout, "power-domains",
228 "#power-domain-cells",
229 0, &specs);
230 if (ret)
231 return;
232
233 imx_con_rsrc = specs.args[0];
234 }
235
imx_sc_pd_power(struct generic_pm_domain * domain,bool power_on)236 static int imx_sc_pd_power(struct generic_pm_domain *domain, bool power_on)
237 {
238 struct imx_sc_msg_req_set_resource_power_mode msg;
239 struct imx_sc_rpc_msg *hdr = &msg.hdr;
240 struct imx_sc_pm_domain *pd;
241 int ret;
242
243 pd = to_imx_sc_pd(domain);
244
245 hdr->ver = IMX_SC_RPC_VERSION;
246 hdr->svc = IMX_SC_RPC_SVC_PM;
247 hdr->func = IMX_SC_PM_FUNC_SET_RESOURCE_POWER_MODE;
248 hdr->size = 2;
249
250 msg.resource = pd->rsrc;
251 msg.mode = power_on ? IMX_SC_PM_PW_MODE_ON : IMX_SC_PM_PW_MODE_LP;
252
253 ret = imx_scu_call_rpc(pm_ipc_handle, &msg, true);
254 if (ret)
255 dev_err(&domain->dev, "failed to power %s resource %d ret %d\n",
256 power_on ? "up" : "off", pd->rsrc, ret);
257
258 return ret;
259 }
260
imx_sc_pd_power_on(struct generic_pm_domain * domain)261 static int imx_sc_pd_power_on(struct generic_pm_domain *domain)
262 {
263 return imx_sc_pd_power(domain, true);
264 }
265
imx_sc_pd_power_off(struct generic_pm_domain * domain)266 static int imx_sc_pd_power_off(struct generic_pm_domain *domain)
267 {
268 return imx_sc_pd_power(domain, false);
269 }
270
imx_scu_pd_xlate(struct of_phandle_args * spec,void * data)271 static struct generic_pm_domain *imx_scu_pd_xlate(struct of_phandle_args *spec,
272 void *data)
273 {
274 struct generic_pm_domain *domain = ERR_PTR(-ENOENT);
275 struct genpd_onecell_data *pd_data = data;
276 unsigned int i;
277
278 for (i = 0; i < pd_data->num_domains; i++) {
279 struct imx_sc_pm_domain *sc_pd;
280
281 sc_pd = to_imx_sc_pd(pd_data->domains[i]);
282 if (sc_pd->rsrc == spec->args[0]) {
283 domain = &sc_pd->pd;
284 break;
285 }
286 }
287
288 return domain;
289 }
290
291 static struct imx_sc_pm_domain *
imx_scu_add_pm_domain(struct device * dev,int idx,const struct imx_sc_pd_range * pd_ranges)292 imx_scu_add_pm_domain(struct device *dev, int idx,
293 const struct imx_sc_pd_range *pd_ranges)
294 {
295 struct imx_sc_pm_domain *sc_pd;
296 bool is_off = true;
297 int ret;
298
299 if (!imx_sc_rm_is_resource_owned(pm_ipc_handle, pd_ranges->rsrc + idx))
300 return NULL;
301
302 sc_pd = devm_kzalloc(dev, sizeof(*sc_pd), GFP_KERNEL);
303 if (!sc_pd)
304 return ERR_PTR(-ENOMEM);
305
306 sc_pd->rsrc = pd_ranges->rsrc + idx;
307 sc_pd->pd.power_off = imx_sc_pd_power_off;
308 sc_pd->pd.power_on = imx_sc_pd_power_on;
309
310 if (pd_ranges->postfix)
311 snprintf(sc_pd->name, sizeof(sc_pd->name),
312 "%s%i", pd_ranges->name, pd_ranges->start_from + idx);
313 else
314 snprintf(sc_pd->name, sizeof(sc_pd->name),
315 "%s", pd_ranges->name);
316
317 sc_pd->pd.name = sc_pd->name;
318 if (imx_con_rsrc == sc_pd->rsrc) {
319 sc_pd->pd.flags = GENPD_FLAG_RPM_ALWAYS_ON;
320 is_off = false;
321 }
322
323 if (sc_pd->rsrc >= IMX_SC_R_LAST) {
324 dev_warn(dev, "invalid pd %s rsrc id %d found",
325 sc_pd->name, sc_pd->rsrc);
326
327 devm_kfree(dev, sc_pd);
328 return NULL;
329 }
330
331 ret = pm_genpd_init(&sc_pd->pd, NULL, is_off);
332 if (ret) {
333 dev_warn(dev, "failed to init pd %s rsrc id %d",
334 sc_pd->name, sc_pd->rsrc);
335 devm_kfree(dev, sc_pd);
336 return NULL;
337 }
338
339 return sc_pd;
340 }
341
imx_scu_init_pm_domains(struct device * dev,const struct imx_sc_pd_soc * pd_soc)342 static int imx_scu_init_pm_domains(struct device *dev,
343 const struct imx_sc_pd_soc *pd_soc)
344 {
345 const struct imx_sc_pd_range *pd_ranges = pd_soc->pd_ranges;
346 struct generic_pm_domain **domains;
347 struct genpd_onecell_data *pd_data;
348 struct imx_sc_pm_domain *sc_pd;
349 u32 count = 0;
350 int i, j;
351
352 for (i = 0; i < pd_soc->num_ranges; i++)
353 count += pd_ranges[i].num;
354
355 domains = devm_kcalloc(dev, count, sizeof(*domains), GFP_KERNEL);
356 if (!domains)
357 return -ENOMEM;
358
359 pd_data = devm_kzalloc(dev, sizeof(*pd_data), GFP_KERNEL);
360 if (!pd_data)
361 return -ENOMEM;
362
363 count = 0;
364 for (i = 0; i < pd_soc->num_ranges; i++) {
365 for (j = 0; j < pd_ranges[i].num; j++) {
366 sc_pd = imx_scu_add_pm_domain(dev, j, &pd_ranges[i]);
367 if (IS_ERR_OR_NULL(sc_pd))
368 continue;
369
370 domains[count++] = &sc_pd->pd;
371 dev_dbg(dev, "added power domain %s\n", sc_pd->pd.name);
372 }
373 }
374
375 pd_data->domains = domains;
376 pd_data->num_domains = count;
377 pd_data->xlate = imx_scu_pd_xlate;
378
379 of_genpd_add_provider_onecell(dev->of_node, pd_data);
380
381 return 0;
382 }
383
imx_sc_pd_probe(struct platform_device * pdev)384 static int imx_sc_pd_probe(struct platform_device *pdev)
385 {
386 const struct imx_sc_pd_soc *pd_soc;
387 int ret;
388
389 ret = imx_scu_get_handle(&pm_ipc_handle);
390 if (ret)
391 return ret;
392
393 pd_soc = of_device_get_match_data(&pdev->dev);
394 if (!pd_soc)
395 return -ENODEV;
396
397 imx_sc_pd_get_console_rsrc();
398
399 return imx_scu_init_pm_domains(&pdev->dev, pd_soc);
400 }
401
402 static const struct of_device_id imx_sc_pd_match[] = {
403 { .compatible = "fsl,imx8qxp-scu-pd", &imx8qxp_scu_pd},
404 { .compatible = "fsl,scu-pd", &imx8qxp_scu_pd},
405 { /* sentinel */ }
406 };
407
408 static struct platform_driver imx_sc_pd_driver = {
409 .driver = {
410 .name = "imx-scu-pd",
411 .of_match_table = imx_sc_pd_match,
412 },
413 .probe = imx_sc_pd_probe,
414 };
415 builtin_platform_driver(imx_sc_pd_driver);
416
417 MODULE_AUTHOR("Dong Aisheng <aisheng.dong@nxp.com>");
418 MODULE_DESCRIPTION("IMX SCU Power Domain driver");
419 MODULE_LICENSE("GPL v2");
420