coreboot
coreboot is an Open Source project aimed at replacing the proprietary BIOS found in most computers.
pmc.c
Go to the documentation of this file.
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 
3 /*
4  * This file is created based on Intel Alder Lake Processor PCH Datasheet
5  * Document number: 621483
6  * Chapter number: 4
7  */
8 
9 #include <acpi/acpigen.h>
10 #include <console/console.h>
11 #include <device/mmio.h>
12 #include <device/device.h>
14 #include <intelblocks/acpi.h>
15 #include <intelblocks/pmc.h>
16 #include <intelblocks/pmc_ipc.h>
17 #include <intelblocks/pmclib.h>
18 #include <intelblocks/rtc.h>
19 #include <soc/cpu.h>
20 #include <soc/pci_devs.h>
21 #include <soc/pm.h>
22 #include <soc/soc_chip.h>
23 #include <stdint.h>
24 #include <bootstate.h>
25 
26 #define PMC_HID "INTC1026"
27 
28 static void config_deep_sX(uint32_t offset, uint32_t mask, int sx, int enable)
29 {
30  uint32_t reg;
31  uint8_t *pmcbase = pmc_mmio_regs();
32 
33  printk(BIOS_DEBUG, "%sabling Deep S%c\n",
34  enable ? "En" : "Dis", sx + '0');
35  reg = read32(pmcbase + offset);
36  if (enable)
37  reg |= mask;
38  else
39  reg &= ~mask;
40  write32(pmcbase + offset, reg);
41 }
42 
43 static void config_deep_s5(int on_ac, int on_dc)
44 {
45  /* Treat S4 the same as S5. */
50 }
51 
52 static void config_deep_s3(int on_ac, int on_dc)
53 {
56 }
57 
58 static void config_deep_sx(uint32_t deepsx_config)
59 {
60  uint32_t reg;
61  uint8_t *pmcbase = pmc_mmio_regs();
62 
63  reg = read32(pmcbase + DSX_CFG);
64  reg &= ~DSX_CFG_MASK;
65  reg |= deepsx_config;
66  write32(pmcbase + DSX_CFG, reg);
67 }
68 
69 static void soc_pmc_enable(struct device *dev)
70 {
71  const config_t *config = config_of_soc();
72 
73  rtc_init();
74 
76  pmc_gpe_init();
77 
78  config_deep_s3(config->deep_s3_enable_ac, config->deep_s3_enable_dc);
79  config_deep_s5(config->deep_s5_enable_ac, config->deep_s5_enable_dc);
80  config_deep_sx(config->deep_sx_config);
81 }
82 
83 static void soc_pmc_read_resources(struct device *dev)
84 {
85  struct resource *res;
86 
87  /* Add the fixed MMIO resource */
89 
90  /* Add the fixed I/O resource */
91  res = new_resource(dev, 1);
94  res->limit = res->base + res->size - 1;
96 }
97 
98 static void soc_pmc_fill_ssdt(const struct device *dev)
99 {
100  const char *scope = acpi_device_scope(dev);
101  const char *name = acpi_device_name(dev);
102  if (!scope || !name)
103  return;
104 
105  acpigen_write_scope(scope);
107 
109  acpigen_write_name_string("_DDN", "Intel(R) Alder Lake IPC Controller");
110 
111  /*
112  * Part of the PCH's reserved 32 MB MMIO range (0xFC800000 - 0xFE7FFFFF).
113  * The PMC gets 0xFE000000 - 0xFE00FFFF.
114  */
115  acpigen_write_name("_CRS");
119 
120  /* Define IPC Write Method */
121  if (CONFIG(PMC_IPC_ACPI_INTERFACE))
123 
124  acpigen_pop_len(); /* PMC Device */
125  acpigen_pop_len(); /* Scope */
126 
127  if (CONFIG(SOC_INTEL_COMMON_BLOCK_ACPI_PEP)) {
128  const struct soc_pmc_lpm adl_pmc_lpm = {
129  .num_substates = 8,
130  .num_req_regs = 6,
131  .lpm_ipc_offset = 0x1000,
132  .req_reg_stride = 0x30,
133  .lpm_enable_mask = get_supported_lpm_mask(),
134  };
135 
137  }
138 
139  printk(BIOS_INFO, "%s: %s at %s\n", acpi_device_path(dev), dev->chip_ops->name,
140  dev_path(dev));
141 }
142 
143 static void soc_pmc_init(struct device *dev)
144 {
145  /*
146  * pmc_set_acpi_mode() should be delayed until BS_DEV_INIT in order
147  * to ensure the ordering does not break the assumptions that other
148  * drivers make about ACPI mode (e.g. Chrome EC). Since it disables
149  * ACPI mode, other drivers may take different actions based on this
150  * (e.g. Chrome EC will flush any pending hostevent bits). Because
151  * TGL has its PMC device available for device_operations, it can be
152  * done from the "ops->init" callback.
153  */
155 
156  /*
157  * Disable ACPI PM timer based on Kconfig
158  *
159  * Disabling ACPI PM timer is necessary for XTAL OSC shutdown.
160  * Disabling ACPI PM timer also switches off TCO
161  */
162  if (!CONFIG(USE_PM_ACPI_TIMER))
164 }
165 
166 static void pm1_enable_pwrbtn_smi(void *unused)
167 {
168  /* Enable power button SMI after BS_DEV_INIT_CHIPS (FSP-S) is done. */
170 }
171 
173 
174 /*
175  * `pmc_final` function is native implementation of equivalent events performed by
176  * each FSP NotifyPhase() API invocations.
177  *
178  *
179  * Clear PMCON status bits (Global Reset/Power Failure/Host Reset Status bits)
180  *
181  * Perform the PMCON status bit clear operation from `.final`
182  * to cover any such chances where later boot stage requested a global
183  * reset and PMCON status bit remains set.
184  */
185 static void pmc_final(struct device *dev)
186 {
188 }
189 
190 struct device_operations pmc_ops = {
192  .set_resources = noop_set_resources,
193  .init = soc_pmc_init,
194  .enable = soc_pmc_enable,
195 #if CONFIG(HAVE_ACPI_TABLES)
196  .acpi_fill_ssdt = soc_pmc_fill_ssdt,
197 #endif
198  .scan_bus = scan_static_bus,
199  .final = pmc_final,
200 };
const char * acpi_device_path(const struct device *dev)
Definition: device.c:144
const char * acpi_device_name(const struct device *dev)
Definition: device.c:49
const char * acpi_device_scope(const struct device *dev)
Definition: device.c:158
void acpigen_pop_len(void)
Definition: acpigen.c:37
void acpigen_write_scope(const char *name)
Definition: acpigen.c:326
void acpigen_write_resourcetemplate_footer(void)
Definition: acpigen.c:1165
void acpigen_write_resourcetemplate_header(void)
Definition: acpigen.c:1147
void acpigen_write_mem32fixed(int readwrite, u32 base, u32 size)
Definition: acpigen.c:1071
void acpigen_write_device(const char *name)
Definition: acpigen.c:769
void acpigen_write_name(const char *name)
Definition: acpigen.c:320
void acpigen_write_name_string(const char *name, const char *string)
Definition: acpigen.c:176
uint8_t * pmc_mmio_regs(void)
Definition: pmutil.c:142
#define PMC_HID
Definition: pmc.c:26
static void config_deep_s5(int on_ac, int on_dc)
Definition: pmc.c:43
static void config_deep_sx(uint32_t deepsx_config)
Definition: pmc.c:58
BOOT_STATE_INIT_ENTRY(BS_DEV_INIT_CHIPS, BS_ON_EXIT, pm1_enable_pwrbtn_smi, NULL)
static void pmc_final(struct device *dev)
Definition: pmc.c:185
struct device_operations pmc_ops
Definition: pmc.c:190
static void soc_pmc_enable(struct device *dev)
Definition: pmc.c:69
static void soc_pmc_read_resources(struct device *dev)
Definition: pmc.c:83
static void pm1_enable_pwrbtn_smi(void *unused)
Definition: pmc.c:166
static void soc_pmc_init(struct device *dev)
Definition: pmc.c:143
static void soc_pmc_fill_ssdt(const struct device *dev)
Definition: pmc.c:98
static void config_deep_s3(int on_ac, int on_dc)
Definition: pmc.c:52
static void config_deep_sX(uint32_t offset, uint32_t mask, int sx, int enable)
Definition: pmc.c:28
const char * name
Definition: mmu.c:92
static void write32(void *addr, uint32_t val)
Definition: mmio.h:40
static uint32_t read32(const void *addr)
Definition: mmio.h:22
@ BS_DEV_INIT_CHIPS
Definition: bootstate.h:79
@ BS_ON_EXIT
Definition: bootstate.h:96
#define KiB
Definition: helpers.h:75
#define PWRBTN_EN
Definition: southbridge.h:36
#define printk(level,...)
Definition: stdlib.h:16
struct resource * new_resource(struct device *dev, unsigned int index)
See if a resource structure already exists for a given index and if not allocate one.
Definition: device_util.c:346
const char * dev_path(const struct device *dev)
Definition: device_util.c:149
@ CONFIG
Definition: dsi_common.h:201
static size_t offset
Definition: flashconsole.c:16
static void noop_set_resources(struct device *dev)
Definition: device.h:74
#define config_of_soc()
Definition: device.h:394
#define mmio_resource(dev, idx, basek, sizek)
Definition: device.h:334
#define setbits8(addr, set)
Definition: mmio.h:19
#define PCH_PWRM_BASE_ADDRESS
Definition: iomap.h:70
#define PCH_PWRM_BASE_SIZE
Definition: iomap.h:71
#define ACPI_BASE_ADDRESS
Definition: iomap.h:99
#define ACPI_BASE_SIZE
Definition: iomap.h:100
#define S3DC_GATE_SUS
Definition: pmc.h:84
#define S4_PWRGATE_POL
Definition: pmc.h:87
#define S4DC_GATE_SUS
Definition: pmc.h:88
#define ACPI_TIM_DIS
Definition: pmc.h:108
#define S3AC_GATE_SUS
Definition: pmc.h:85
#define S3_PWRGATE_POL
Definition: pmc.h:83
#define DSX_CFG_MASK
Definition: pmc.h:101
#define S5_PWRGATE_POL
Definition: pmc.h:91
#define S5AC_GATE_SUS
Definition: pmc.h:93
#define PCH_PWRM_ACPI_TMR_CTL
Definition: pmc.h:107
#define S4AC_GATE_SUS
Definition: pmc.h:89
#define DSX_CFG
Definition: pmc.h:95
#define S5DC_GATE_SUS
Definition: pmc.h:92
#define BIOS_INFO
BIOS_INFO - Expected events.
Definition: loglevel.h:113
#define BIOS_DEBUG
BIOS_DEBUG - Verbose output.
Definition: loglevel.h:128
enum board_config config
Definition: memory.c:448
void generate_acpi_power_engine_with_lpm(const struct soc_pmc_lpm *lpm)
Definition: pep.c:179
void pmc_ipc_acpi_fill_ssdt(void)
Definition: pmc_ipc.c:100
#define IORESOURCE_ASSIGNED
Definition: resource.h:34
#define IORESOURCE_IO
Definition: resource.h:9
u64 resource_t
Definition: resource.h:43
#define IORESOURCE_FIXED
Definition: resource.h:36
void scan_static_bus(struct device *bus)
Definition: root_device.c:89
uint8_t get_supported_lpm_mask(void)
Definition: cpu.c:261
static const int mask[4]
Definition: gpio.c:308
void pmc_set_power_failure_state(bool target_on)
Definition: pmclib.c:623
void pmc_set_acpi_mode(void)
Definition: pmclib.c:754
void pmc_update_pm1_enable(uint16_t events)
Definition: pmclib.c:151
void pmc_clear_pmcon_sts(void)
void pmc_gpe_init(void)
Definition: pmclib.c:535
void rtc_init(void)
Definition: rtc.c:29
#define NULL
Definition: stddef.h:19
unsigned int uint32_t
Definition: stdint.h:14
unsigned char uint8_t
Definition: stdint.h:8
const char * name
Definition: device.h:29
void(* read_resources)(struct device *dev)
Definition: device.h:39
Definition: device.h:107
struct chip_operations * chip_ops
Definition: device.h:144
unsigned long flags
Definition: resource.h:49
resource_t limit
Definition: resource.h:47
resource_t base
Definition: resource.h:45
resource_t size
Definition: resource.h:46
unsigned int num_substates
Definition: acpi.h:109