1 // SPDX-License-Identifier: GPL-2.0-only
3 * Intel Atom SoC Power Management Controller Driver
4 * Copyright (c) 2014-2015,2017,2022 Intel Corporation.
7 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
9 #include <linux/debugfs.h>
10 #include <linux/device.h>
11 #include <linux/dmi.h>
12 #include <linux/init.h>
14 #include <linux/platform_data/x86/clk-pmc-atom.h>
15 #include <linux/platform_data/x86/pmc_atom.h>
16 #include <linux/platform_data/x86/simatic-ipc.h>
17 #include <linux/platform_device.h>
18 #include <linux/pci.h>
19 #include <linux/seq_file.h>
27 const struct pmc_bit_map *d3_sts_0;
28 const struct pmc_bit_map *d3_sts_1;
29 const struct pmc_bit_map *func_dis;
30 const struct pmc_bit_map *func_dis_2;
31 const struct pmc_bit_map *pss;
35 const struct pmc_reg_map *map;
36 const struct pmc_clk *clks;
42 const struct pmc_reg_map *map;
43 #ifdef CONFIG_DEBUG_FS
44 struct dentry *dbgfs_dir;
45 #endif /* CONFIG_DEBUG_FS */
49 static struct pmc_dev pmc_device;
50 static u32 acpi_base_addr;
52 static const struct pmc_clk byt_clks[] = {
61 .parent_name = "xtal",
66 static const struct pmc_clk cht_clks[] = {
75 static const struct pmc_bit_map d3_sts_0_map[] = {
76 {"LPSS1_F0_DMA", BIT_LPSS1_F0_DMA},
77 {"LPSS1_F1_PWM1", BIT_LPSS1_F1_PWM1},
78 {"LPSS1_F2_PWM2", BIT_LPSS1_F2_PWM2},
79 {"LPSS1_F3_HSUART1", BIT_LPSS1_F3_HSUART1},
80 {"LPSS1_F4_HSUART2", BIT_LPSS1_F4_HSUART2},
81 {"LPSS1_F5_SPI", BIT_LPSS1_F5_SPI},
82 {"LPSS1_F6_Reserved", BIT_LPSS1_F6_XXX},
83 {"LPSS1_F7_Reserved", BIT_LPSS1_F7_XXX},
84 {"SCC_EMMC", BIT_SCC_EMMC},
85 {"SCC_SDIO", BIT_SCC_SDIO},
86 {"SCC_SDCARD", BIT_SCC_SDCARD},
87 {"SCC_MIPI", BIT_SCC_MIPI},
94 {"USB_EHCI", BIT_USB_EHCI},
96 {"PCIE_PORT0", BIT_PCIE_PORT0},
97 {"PCIE_PORT1", BIT_PCIE_PORT1},
98 {"PCIE_PORT2", BIT_PCIE_PORT2},
99 {"PCIE_PORT3", BIT_PCIE_PORT3},
100 {"LPSS2_F0_DMA", BIT_LPSS2_F0_DMA},
101 {"LPSS2_F1_I2C1", BIT_LPSS2_F1_I2C1},
102 {"LPSS2_F2_I2C2", BIT_LPSS2_F2_I2C2},
103 {"LPSS2_F3_I2C3", BIT_LPSS2_F3_I2C3},
104 {"LPSS2_F3_I2C4", BIT_LPSS2_F4_I2C4},
105 {"LPSS2_F5_I2C5", BIT_LPSS2_F5_I2C5},
106 {"LPSS2_F6_I2C6", BIT_LPSS2_F6_I2C6},
107 {"LPSS2_F7_I2C7", BIT_LPSS2_F7_I2C7},
111 static struct pmc_bit_map byt_d3_sts_1_map[] = {
113 {"OTG_SS_PHY", BIT_OTG_SS_PHY},
114 {"USH_SS_PHY", BIT_USH_SS_PHY},
119 static struct pmc_bit_map cht_d3_sts_1_map[] = {
121 {"GMM", BIT_STS_GMM},
122 {"ISH", BIT_STS_ISH},
126 static struct pmc_bit_map cht_func_dis_2_map[] = {
133 static const struct pmc_bit_map byt_pss_map[] = {
134 {"GBE", PMC_PSS_BIT_GBE},
135 {"SATA", PMC_PSS_BIT_SATA},
136 {"HDA", PMC_PSS_BIT_HDA},
137 {"SEC", PMC_PSS_BIT_SEC},
138 {"PCIE", PMC_PSS_BIT_PCIE},
139 {"LPSS", PMC_PSS_BIT_LPSS},
140 {"LPE", PMC_PSS_BIT_LPE},
141 {"DFX", PMC_PSS_BIT_DFX},
142 {"USH_CTRL", PMC_PSS_BIT_USH_CTRL},
143 {"USH_SUS", PMC_PSS_BIT_USH_SUS},
144 {"USH_VCCS", PMC_PSS_BIT_USH_VCCS},
145 {"USH_VCCA", PMC_PSS_BIT_USH_VCCA},
146 {"OTG_CTRL", PMC_PSS_BIT_OTG_CTRL},
147 {"OTG_VCCS", PMC_PSS_BIT_OTG_VCCS},
148 {"OTG_VCCA_CLK", PMC_PSS_BIT_OTG_VCCA_CLK},
149 {"OTG_VCCA", PMC_PSS_BIT_OTG_VCCA},
150 {"USB", PMC_PSS_BIT_USB},
151 {"USB_SUS", PMC_PSS_BIT_USB_SUS},
155 static const struct pmc_bit_map cht_pss_map[] = {
156 {"SATA", PMC_PSS_BIT_SATA},
157 {"HDA", PMC_PSS_BIT_HDA},
158 {"SEC", PMC_PSS_BIT_SEC},
159 {"PCIE", PMC_PSS_BIT_PCIE},
160 {"LPSS", PMC_PSS_BIT_LPSS},
161 {"LPE", PMC_PSS_BIT_LPE},
162 {"UFS", PMC_PSS_BIT_CHT_UFS},
163 {"UXD", PMC_PSS_BIT_CHT_UXD},
164 {"UXD_FD", PMC_PSS_BIT_CHT_UXD_FD},
165 {"UX_ENG", PMC_PSS_BIT_CHT_UX_ENG},
166 {"USB_SUS", PMC_PSS_BIT_CHT_USB_SUS},
167 {"GMM", PMC_PSS_BIT_CHT_GMM},
168 {"ISH", PMC_PSS_BIT_CHT_ISH},
169 {"DFX_MASTER", PMC_PSS_BIT_CHT_DFX_MASTER},
170 {"DFX_CLUSTER1", PMC_PSS_BIT_CHT_DFX_CLUSTER1},
171 {"DFX_CLUSTER2", PMC_PSS_BIT_CHT_DFX_CLUSTER2},
172 {"DFX_CLUSTER3", PMC_PSS_BIT_CHT_DFX_CLUSTER3},
173 {"DFX_CLUSTER4", PMC_PSS_BIT_CHT_DFX_CLUSTER4},
174 {"DFX_CLUSTER5", PMC_PSS_BIT_CHT_DFX_CLUSTER5},
178 static const struct pmc_reg_map byt_reg_map = {
179 .d3_sts_0 = d3_sts_0_map,
180 .d3_sts_1 = byt_d3_sts_1_map,
181 .func_dis = d3_sts_0_map,
182 .func_dis_2 = byt_d3_sts_1_map,
186 static const struct pmc_reg_map cht_reg_map = {
187 .d3_sts_0 = d3_sts_0_map,
188 .d3_sts_1 = cht_d3_sts_1_map,
189 .func_dis = d3_sts_0_map,
190 .func_dis_2 = cht_func_dis_2_map,
194 static const struct pmc_data byt_data = {
199 static const struct pmc_data cht_data = {
204 static inline u32 pmc_reg_read(struct pmc_dev *pmc, int reg_offset)
206 return readl(pmc->regmap + reg_offset);
209 static inline void pmc_reg_write(struct pmc_dev *pmc, int reg_offset, u32 val)
211 writel(val, pmc->regmap + reg_offset);
214 int pmc_atom_read(int offset, u32 *value)
216 struct pmc_dev *pmc = &pmc_device;
221 *value = pmc_reg_read(pmc, offset);
225 static void pmc_power_off(void)
230 pr_info("Preparing to enter system sleep state S5\n");
232 pm1_cnt_port = acpi_base_addr + PM1_CNT;
234 pm1_cnt_value = inl(pm1_cnt_port);
235 pm1_cnt_value &= ~SLEEP_TYPE_MASK;
236 pm1_cnt_value |= SLEEP_TYPE_S5;
237 pm1_cnt_value |= SLEEP_ENABLE;
239 outl(pm1_cnt_value, pm1_cnt_port);
242 static void pmc_hw_reg_setup(struct pmc_dev *pmc)
245 * Disable PMC S0IX_WAKE_EN events coming from:
247 * - GPIO_SUS ored dedicated IRQs
248 * - GPIO_SCORE ored dedicated IRQs
249 * - GPIO_SUS shared IRQ
250 * - GPIO_SCORE shared IRQ
252 pmc_reg_write(pmc, PMC_S0IX_WAKE_EN, (u32)PMC_WAKE_EN_SETTING);
255 #ifdef CONFIG_DEBUG_FS
256 static void pmc_dev_state_print(struct seq_file *s, int reg_index,
257 u32 sts, const struct pmc_bit_map *sts_map,
258 u32 fd, const struct pmc_bit_map *fd_map)
260 int offset = PMC_REG_BIT_WIDTH * reg_index;
263 for (index = 0; sts_map[index].name; index++) {
264 seq_printf(s, "Dev: %-2d - %-32s\tState: %s [%s]\n",
265 offset + index, sts_map[index].name,
266 fd_map[index].bit_mask & fd ? "Disabled" : "Enabled ",
267 sts_map[index].bit_mask & sts ? "D3" : "D0");
271 static int pmc_dev_state_show(struct seq_file *s, void *unused)
273 struct pmc_dev *pmc = s->private;
274 const struct pmc_reg_map *m = pmc->map;
275 u32 func_dis, func_dis_2;
276 u32 d3_sts_0, d3_sts_1;
278 func_dis = pmc_reg_read(pmc, PMC_FUNC_DIS);
279 func_dis_2 = pmc_reg_read(pmc, PMC_FUNC_DIS_2);
280 d3_sts_0 = pmc_reg_read(pmc, PMC_D3_STS_0);
281 d3_sts_1 = pmc_reg_read(pmc, PMC_D3_STS_1);
284 pmc_dev_state_print(s, 0, d3_sts_0, m->d3_sts_0, func_dis, m->func_dis);
287 pmc_dev_state_print(s, 1, d3_sts_1, m->d3_sts_1, func_dis_2, m->func_dis_2);
292 DEFINE_SHOW_ATTRIBUTE(pmc_dev_state);
294 static int pmc_pss_state_show(struct seq_file *s, void *unused)
296 struct pmc_dev *pmc = s->private;
297 const struct pmc_bit_map *map = pmc->map->pss;
298 u32 pss = pmc_reg_read(pmc, PMC_PSS);
301 for (index = 0; map[index].name; index++) {
302 seq_printf(s, "Island: %-2d - %-32s\tState: %s\n",
303 index, map[index].name,
304 map[index].bit_mask & pss ? "Off" : "On");
309 DEFINE_SHOW_ATTRIBUTE(pmc_pss_state);
311 static int pmc_sleep_tmr_show(struct seq_file *s, void *unused)
313 struct pmc_dev *pmc = s->private;
314 u64 s0ir_tmr, s0i1_tmr, s0i2_tmr, s0i3_tmr, s0_tmr;
316 s0ir_tmr = (u64)pmc_reg_read(pmc, PMC_S0IR_TMR) << PMC_TMR_SHIFT;
317 s0i1_tmr = (u64)pmc_reg_read(pmc, PMC_S0I1_TMR) << PMC_TMR_SHIFT;
318 s0i2_tmr = (u64)pmc_reg_read(pmc, PMC_S0I2_TMR) << PMC_TMR_SHIFT;
319 s0i3_tmr = (u64)pmc_reg_read(pmc, PMC_S0I3_TMR) << PMC_TMR_SHIFT;
320 s0_tmr = (u64)pmc_reg_read(pmc, PMC_S0_TMR) << PMC_TMR_SHIFT;
322 seq_printf(s, "S0IR Residency:\t%lldus\n", s0ir_tmr);
323 seq_printf(s, "S0I1 Residency:\t%lldus\n", s0i1_tmr);
324 seq_printf(s, "S0I2 Residency:\t%lldus\n", s0i2_tmr);
325 seq_printf(s, "S0I3 Residency:\t%lldus\n", s0i3_tmr);
326 seq_printf(s, "S0 Residency:\t%lldus\n", s0_tmr);
330 DEFINE_SHOW_ATTRIBUTE(pmc_sleep_tmr);
332 static void pmc_dbgfs_register(struct pmc_dev *pmc)
336 dir = debugfs_create_dir("pmc_atom", NULL);
338 pmc->dbgfs_dir = dir;
340 debugfs_create_file("dev_state", S_IFREG | S_IRUGO, dir, pmc,
341 &pmc_dev_state_fops);
342 debugfs_create_file("pss_state", S_IFREG | S_IRUGO, dir, pmc,
343 &pmc_pss_state_fops);
344 debugfs_create_file("sleep_state", S_IFREG | S_IRUGO, dir, pmc,
345 &pmc_sleep_tmr_fops);
348 static void pmc_dbgfs_register(struct pmc_dev *pmc)
351 #endif /* CONFIG_DEBUG_FS */
353 static bool pmc_clk_is_critical = true;
355 static int dmi_callback(const struct dmi_system_id *d)
357 pr_info("%s: PMC critical clocks quirk enabled\n", d->ident);
362 static int dmi_callback_siemens(const struct dmi_system_id *d)
366 if (dmi_walk(simatic_ipc_find_dmi_entry_helper, &st_id))
369 if (st_id == SIMATIC_IPC_IPC227E || st_id == SIMATIC_IPC_IPC277E)
370 return dmi_callback(d);
373 pmc_clk_is_critical = false;
378 * Some systems need one or more of their pmc_plt_clks to be
379 * marked as critical.
381 static const struct dmi_system_id critclk_systems[] = {
383 /* pmc_plt_clk0 is used for an external HSIC USB HUB */
384 .ident = "MPL CEC1x",
385 .callback = dmi_callback,
387 DMI_MATCH(DMI_SYS_VENDOR, "MPL AG"),
388 DMI_MATCH(DMI_PRODUCT_NAME, "CEC10 Family"),
393 * Lex System / Lex Computech Co. makes a lot of Bay Trail
394 * based embedded boards which often come with multiple
395 * ethernet controllers using multiple pmc_plt_clks. See:
396 * https://www.lex.com.tw/products/embedded-ipc-board/
398 .ident = "Lex BayTrail",
399 .callback = dmi_callback,
401 DMI_MATCH(DMI_SYS_VENDOR, "Lex BayTrail"),
405 /* pmc_plt_clk* - are used for ethernet controllers */
406 .ident = "Beckhoff Baytrail",
407 .callback = dmi_callback,
409 DMI_MATCH(DMI_SYS_VENDOR, "Beckhoff Automation"),
410 DMI_MATCH(DMI_PRODUCT_FAMILY, "CBxx63"),
414 .ident = "SIEMENS AG",
415 .callback = dmi_callback_siemens,
417 DMI_MATCH(DMI_SYS_VENDOR, "SIEMENS AG"),
423 static int pmc_setup_clks(struct pci_dev *pdev, void __iomem *pmc_regmap,
424 const struct pmc_data *pmc_data)
426 struct platform_device *clkdev;
427 struct pmc_clk_data *clk_data;
429 clk_data = kzalloc(sizeof(*clk_data), GFP_KERNEL);
433 clk_data->base = pmc_regmap; /* offset is added by client */
434 clk_data->clks = pmc_data->clks;
435 if (dmi_check_system(critclk_systems))
436 clk_data->critical = pmc_clk_is_critical;
438 clkdev = platform_device_register_data(&pdev->dev, "clk-pmc-atom",
440 clk_data, sizeof(*clk_data));
441 if (IS_ERR(clkdev)) {
443 return PTR_ERR(clkdev);
451 static int pmc_setup_dev(struct pci_dev *pdev, const struct pci_device_id *ent)
453 struct pmc_dev *pmc = &pmc_device;
454 const struct pmc_data *data = (struct pmc_data *)ent->driver_data;
455 const struct pmc_reg_map *map = data->map;
458 /* Obtain ACPI base address */
459 pci_read_config_dword(pdev, ACPI_BASE_ADDR_OFFSET, &acpi_base_addr);
460 acpi_base_addr &= ACPI_BASE_ADDR_MASK;
462 /* Install power off function */
463 if (acpi_base_addr != 0 && pm_power_off == NULL)
464 pm_power_off = pmc_power_off;
466 pci_read_config_dword(pdev, PMC_BASE_ADDR_OFFSET, &pmc->base_addr);
467 pmc->base_addr &= PMC_BASE_ADDR_MASK;
469 pmc->regmap = ioremap(pmc->base_addr, PMC_MMIO_REG_LEN);
471 dev_err(&pdev->dev, "error: ioremap failed\n");
477 /* PMC hardware registers setup */
478 pmc_hw_reg_setup(pmc);
480 pmc_dbgfs_register(pmc);
482 /* Register platform clocks - PMC_PLT_CLK [0..5] */
483 ret = pmc_setup_clks(pdev, pmc->regmap, data);
485 dev_warn(&pdev->dev, "platform clocks register failed: %d\n",
492 /* Data for PCI driver interface used by pci_match_id() call below */
493 static const struct pci_device_id pmc_pci_ids[] = {
494 { PCI_VDEVICE(INTEL, PCI_DEVICE_ID_VLV_PMC), (kernel_ulong_t)&byt_data },
495 { PCI_VDEVICE(INTEL, PCI_DEVICE_ID_CHT_PMC), (kernel_ulong_t)&cht_data },
499 static int __init pmc_atom_init(void)
501 struct pci_dev *pdev = NULL;
502 const struct pci_device_id *ent;
505 * We look for our device - PCU PMC.
506 * We assume that there is maximum one device.
508 * We can't use plain pci_driver mechanism,
509 * as the device is really a multiple function device,
510 * main driver that binds to the pci_device is lpc_ich
511 * and have to find & bind to the device this way.
513 for_each_pci_dev(pdev) {
514 ent = pci_match_id(pmc_pci_ids, pdev);
516 return pmc_setup_dev(pdev, ent);
518 /* Device not found */
522 device_initcall(pmc_atom_init);
526 MODULE_DESCRIPTION("Intel Atom SoC Power Management Controller Interface");
527 MODULE_LICENSE("GPL v2");