blob: 3accdbb408322f33cbadf16534d03197fc62fa0f [file] [log] [blame]
Subrata Banik2871e0e2020-09-27 11:30:58 +05301/* SPDX-License-Identifier: GPL-2.0-only */
2
3#include <assert.h>
Subrata Banik99289a82020-12-22 10:54:44 +05304#include <cbfs.h>
Subrata Banik2871e0e2020-09-27 11:30:58 +05305#include <console/console.h>
6#include <device/device.h>
7#include <device/pci.h>
V Sowmya458708f2021-07-09 22:11:04 +05308#include <device/pci_ids.h>
Subrata Banik2871e0e2020-09-27 11:30:58 +05309#include <fsp/api.h>
10#include <fsp/ppi/mp_service_ppi.h>
11#include <fsp/util.h>
Sean Rhodesbc35bed2021-07-13 13:36:28 +010012#include <option.h>
Tim Wawrzynczak43607e42021-05-18 09:04:42 -060013#include <intelblocks/irq.h>
Subrata Banik2871e0e2020-09-27 11:30:58 +053014#include <intelblocks/lpss.h>
15#include <intelblocks/xdci.h>
16#include <intelpch/lockdown.h>
Deepti Deshatty8e7facf2021-05-12 17:45:37 +053017#include <intelblocks/tcss.h>
Subrata Banik2871e0e2020-09-27 11:30:58 +053018#include <soc/gpio_soc_defs.h>
19#include <soc/intel/common/vbt.h>
20#include <soc/pci_devs.h>
Eric Lai5b302b22020-12-05 16:49:43 +080021#include <soc/pcie.h>
Subrata Banik2871e0e2020-09-27 11:30:58 +053022#include <soc/ramstage.h>
23#include <soc/soc_chip.h>
Tim Wawrzynczak43607e42021-05-18 09:04:42 -060024#include <stdlib.h>
Subrata Banik2871e0e2020-09-27 11:30:58 +053025#include <string.h>
Sean Rhodesbc35bed2021-07-13 13:36:28 +010026#include <types.h>
Subrata Banik2871e0e2020-09-27 11:30:58 +053027
28/* THC assignment definition */
29#define THC_NONE 0
30#define THC_0 1
31#define THC_1 2
32
33/* SATA DEVSLP idle timeout default values */
34#define DEF_DMVAL 15
35#define DEF_DITOVAL 625
36
V Sowmya458708f2021-07-09 22:11:04 +053037/* VccIn Aux Imon IccMax values in mA */
38#define MILLIAMPS_TO_AMPS 1000
39#define ICC_MAX_ID_ADL_P_3_MA 34250
40#define ICC_MAX_ID_ADL_P_5_MA 32000
41#define ICC_MAX_ID_ADL_P_7_MA 32000
42
Tim Wawrzynczakc0e82e72021-06-17 12:42:35 -060043/*
44 * ME End of Post configuration
45 * 0 - Disable EOP.
46 * 1 - Send in PEI (Applicable for FSP in API mode)
47 * 2 - Send in DXE (Not applicable for FSP in API mode)
48 */
49enum fsp_end_of_post {
50 EOP_DISABLE = 0,
51 EOP_PEI = 1,
52 EOP_DXE = 2,
53};
54
Tim Wawrzynczak43607e42021-05-18 09:04:42 -060055static const struct slot_irq_constraints irq_constraints[] = {
56 {
57 .slot = SA_DEV_SLOT_IGD,
58 .fns = {
Tim Wawrzynczak82225b82021-07-09 10:23:10 -060059 /* INTERRUPT_PIN is RO/0x01 */
60 FIXED_INT_ANY_PIRQ(SA_DEVFN_IGD, PCI_INT_A),
Tim Wawrzynczak43607e42021-05-18 09:04:42 -060061 },
62 },
63 {
64 .slot = SA_DEV_SLOT_DPTF,
65 .fns = {
66 ANY_PIRQ(SA_DEVFN_DPTF),
67 },
68 },
69 {
70 .slot = SA_DEV_SLOT_IPU,
71 .fns = {
Tim Wawrzynczak82225b82021-07-09 10:23:10 -060072 /* INTERRUPT_PIN is RO/0x01, and INTERRUPT_LINE is RW,
73 but S0ix fails when not set to 16 (b/193434192) */
74 FIXED_INT_PIRQ(SA_DEVFN_IPU, PCI_INT_A, PIRQ_A),
Tim Wawrzynczak43607e42021-05-18 09:04:42 -060075 },
76 },
77 {
78 .slot = SA_DEV_SLOT_CPU_6,
79 .fns = {
Tim Wawrzynczak82225b82021-07-09 10:23:10 -060080 FIXED_INT_PIRQ(SA_DEVFN_CPU_PCIE6_0, PCI_INT_A, PIRQ_A),
81 FIXED_INT_PIRQ(SA_DEVFN_CPU_PCIE6_2, PCI_INT_C, PIRQ_C),
Tim Wawrzynczak43607e42021-05-18 09:04:42 -060082 },
83 },
84 {
85 .slot = SA_DEV_SLOT_TBT,
86 .fns = {
87 ANY_PIRQ(SA_DEVFN_TBT0),
88 ANY_PIRQ(SA_DEVFN_TBT1),
89 ANY_PIRQ(SA_DEVFN_TBT2),
90 ANY_PIRQ(SA_DEVFN_TBT3),
91 },
92 },
93 {
Tim Wawrzynczak82225b82021-07-09 10:23:10 -060094 .slot = SA_DEV_SLOT_GNA,
95 .fns = {
96 /* INTERRUPT_PIN is RO/0x01 */
97 FIXED_INT_ANY_PIRQ(SA_DEVFN_GNA, PCI_INT_A),
98 },
99 },
100 {
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600101 .slot = SA_DEV_SLOT_TCSS,
102 .fns = {
103 ANY_PIRQ(SA_DEVFN_TCSS_XHCI),
Tim Wawrzynczak82225b82021-07-09 10:23:10 -0600104 ANY_PIRQ(SA_DEVFN_TCSS_XDCI),
105 },
106 },
107 {
108 .slot = PCH_DEV_SLOT_SIO0,
109 .fns = {
110 DIRECT_IRQ(PCH_DEVFN_I2C6),
111 DIRECT_IRQ(PCH_DEVFN_I2C7),
112 ANY_PIRQ(PCH_DEVFN_THC0),
113 ANY_PIRQ(PCH_DEVFN_THC1),
114 },
115 },
116 {
117 .slot = PCH_DEV_SLOT_SIO6,
118 .fns = {
119 DIRECT_IRQ(PCH_DEVFN_UART3),
120 DIRECT_IRQ(PCH_DEVFN_UART4),
121 DIRECT_IRQ(PCH_DEVFN_UART5),
122 DIRECT_IRQ(PCH_DEVFN_UART6),
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600123 },
124 },
125 {
126 .slot = PCH_DEV_SLOT_ISH,
127 .fns = {
128 DIRECT_IRQ(PCH_DEVFN_ISH),
129 DIRECT_IRQ(PCH_DEVFN_GSPI2),
Tim Wawrzynczak82225b82021-07-09 10:23:10 -0600130 ANY_PIRQ(PCH_DEVFN_UFS),
131 },
132 },
133 {
134 .slot = PCH_DEV_SLOT_SIO2,
135 .fns = {
136 DIRECT_IRQ(PCH_DEVFN_GSPI3),
137 DIRECT_IRQ(PCH_DEVFN_GSPI4),
138 DIRECT_IRQ(PCH_DEVFN_GSPI5),
139 DIRECT_IRQ(PCH_DEVFN_GSPI6),
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600140 },
141 },
142 {
143 .slot = PCH_DEV_SLOT_XHCI,
144 .fns = {
145 ANY_PIRQ(PCH_DEVFN_XHCI),
Tim Wawrzynczak82225b82021-07-09 10:23:10 -0600146 DIRECT_IRQ(PCH_DEVFN_USBOTG),
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600147 ANY_PIRQ(PCH_DEVFN_CNVI_WIFI),
148 },
149 },
150 {
151 .slot = PCH_DEV_SLOT_SIO3,
152 .fns = {
153 DIRECT_IRQ(PCH_DEVFN_I2C0),
154 DIRECT_IRQ(PCH_DEVFN_I2C1),
155 DIRECT_IRQ(PCH_DEVFN_I2C2),
156 DIRECT_IRQ(PCH_DEVFN_I2C3),
157 },
158 },
159 {
160 .slot = PCH_DEV_SLOT_CSE,
161 .fns = {
162 ANY_PIRQ(PCH_DEVFN_CSE),
163 ANY_PIRQ(PCH_DEVFN_CSE_2),
164 ANY_PIRQ(PCH_DEVFN_CSE_IDER),
165 ANY_PIRQ(PCH_DEVFN_CSE_KT),
166 ANY_PIRQ(PCH_DEVFN_CSE_3),
167 ANY_PIRQ(PCH_DEVFN_CSE_4),
168 },
169 },
170 {
171 .slot = PCH_DEV_SLOT_SATA,
172 .fns = {
173 ANY_PIRQ(PCH_DEVFN_SATA),
174 },
175 },
176 {
177 .slot = PCH_DEV_SLOT_SIO4,
178 .fns = {
179 DIRECT_IRQ(PCH_DEVFN_I2C4),
180 DIRECT_IRQ(PCH_DEVFN_I2C5),
181 DIRECT_IRQ(PCH_DEVFN_UART2),
182 },
183 },
184 {
185 .slot = PCH_DEV_SLOT_PCIE,
186 .fns = {
187 FIXED_INT_PIRQ(PCH_DEVFN_PCIE1, PCI_INT_A, PIRQ_A),
188 FIXED_INT_PIRQ(PCH_DEVFN_PCIE2, PCI_INT_B, PIRQ_B),
189 FIXED_INT_PIRQ(PCH_DEVFN_PCIE3, PCI_INT_C, PIRQ_C),
190 FIXED_INT_PIRQ(PCH_DEVFN_PCIE4, PCI_INT_D, PIRQ_D),
191 FIXED_INT_PIRQ(PCH_DEVFN_PCIE5, PCI_INT_A, PIRQ_A),
192 FIXED_INT_PIRQ(PCH_DEVFN_PCIE6, PCI_INT_B, PIRQ_B),
193 FIXED_INT_PIRQ(PCH_DEVFN_PCIE7, PCI_INT_C, PIRQ_C),
194 FIXED_INT_PIRQ(PCH_DEVFN_PCIE8, PCI_INT_D, PIRQ_D),
195 },
196 },
197 {
198 .slot = PCH_DEV_SLOT_PCIE_1,
199 .fns = {
200 FIXED_INT_PIRQ(PCH_DEVFN_PCIE9, PCI_INT_A, PIRQ_A),
201 FIXED_INT_PIRQ(PCH_DEVFN_PCIE10, PCI_INT_B, PIRQ_B),
202 FIXED_INT_PIRQ(PCH_DEVFN_PCIE11, PCI_INT_C, PIRQ_C),
203 FIXED_INT_PIRQ(PCH_DEVFN_PCIE12, PCI_INT_D, PIRQ_D),
204 },
205 },
206 {
207 .slot = PCH_DEV_SLOT_SIO5,
208 .fns = {
Tim Wawrzynczak82225b82021-07-09 10:23:10 -0600209 /* UART0 shares an interrupt line with TSN0, so must use
210 a PIRQ */
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600211 FIXED_INT_ANY_PIRQ(PCH_DEVFN_UART0, PCI_INT_A),
Tim Wawrzynczak82225b82021-07-09 10:23:10 -0600212 /* UART1 shares an interrupt line with TSN1, so must use
213 a PIRQ */
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600214 FIXED_INT_ANY_PIRQ(PCH_DEVFN_UART1, PCI_INT_B),
Tim Wawrzynczak82225b82021-07-09 10:23:10 -0600215 DIRECT_IRQ(PCH_DEVFN_GSPI0),
216 DIRECT_IRQ(PCH_DEVFN_GSPI1),
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600217 },
218 },
219 {
220 .slot = PCH_DEV_SLOT_ESPI,
221 .fns = {
222 ANY_PIRQ(PCH_DEVFN_HDA),
223 ANY_PIRQ(PCH_DEVFN_SMBUS),
224 ANY_PIRQ(PCH_DEVFN_GBE),
Tim Wawrzynczak82225b82021-07-09 10:23:10 -0600225 /* INTERRUPT_PIN is RO/0x01 */
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600226 FIXED_INT_ANY_PIRQ(PCH_DEVFN_TRACEHUB, PCI_INT_A),
227 },
228 },
229};
230
231static const SI_PCH_DEVICE_INTERRUPT_CONFIG *pci_irq_to_fsp(size_t *out_count)
232{
233 const struct pci_irq_entry *entry = get_cached_pci_irqs();
234 SI_PCH_DEVICE_INTERRUPT_CONFIG *config;
235 size_t pch_total = 0;
236 size_t cfg_count = 0;
237
238 if (!entry)
239 return NULL;
240
241 /* Count PCH devices */
242 while (entry) {
243 if (PCI_SLOT(entry->devfn) >= MIN_PCH_SLOT)
244 ++pch_total;
245 entry = entry->next;
246 }
247
248 /* Convert PCH device entries to FSP format */
249 config = calloc(pch_total, sizeof(*config));
250 entry = get_cached_pci_irqs();
251 while (entry) {
252 if (PCI_SLOT(entry->devfn) < MIN_PCH_SLOT) {
253 entry = entry->next;
254 continue;
255 }
256
257 config[cfg_count].Device = PCI_SLOT(entry->devfn);
258 config[cfg_count].Function = PCI_FUNC(entry->devfn);
259 config[cfg_count].IntX = (SI_PCH_INT_PIN)entry->pin;
260 config[cfg_count].Irq = entry->irq;
261 ++cfg_count;
262
263 entry = entry->next;
264 }
265
266 *out_count = cfg_count;
267
268 return config;
269}
270
Subrata Banik2871e0e2020-09-27 11:30:58 +0530271/*
272 * Chip config parameter PcieRpL1Substates uses (UPD value + 1)
273 * because UPD value of 0 for PcieRpL1Substates means disabled for FSP.
274 * In order to ensure that mainboard setting does not disable L1 substates
275 * incorrectly, chip config parameter values are offset by 1 with 0 meaning
276 * use FSP UPD default. get_l1_substate_control() ensures that the right UPD
277 * value is set in fsp_params.
278 * 0: Use FSP UPD default
279 * 1: Disable L1 substates
280 * 2: Use L1.1
281 * 3: Use L1.2 (FSP UPD default)
282 */
283static int get_l1_substate_control(enum L1_substates_control ctl)
284{
285 if ((ctl > L1_SS_L1_2) || (ctl == L1_SS_FSP_DEFAULT))
286 ctl = L1_SS_L1_2;
287 return ctl - 1;
288}
289
V Sowmya458708f2021-07-09 22:11:04 +0530290/* This function returns the VccIn Aux Imon IccMax values for ADL-P SKU's */
291static uint16_t get_vccin_aux_imon_iccmax(void)
292{
293 uint16_t mch_id = 0;
294
295 if (!mch_id) {
296 struct device *dev = pcidev_path_on_root(SA_DEVFN_ROOT);
297 mch_id = dev ? pci_read_config16(dev, PCI_DEVICE_ID) : 0xffff;
298 }
299
300 switch (mch_id) {
301 case PCI_DEVICE_ID_INTEL_ADL_P_ID_3:
302 return ICC_MAX_ID_ADL_P_3_MA;
303 case PCI_DEVICE_ID_INTEL_ADL_P_ID_5:
304 return ICC_MAX_ID_ADL_P_5_MA;
305 case PCI_DEVICE_ID_INTEL_ADL_P_ID_7:
306 return ICC_MAX_ID_ADL_P_7_MA;
307 default:
308 printk(BIOS_ERR, "Unknown MCH ID: 0x%4x, skipping VccInAuxImonIccMax config\n",
309 mch_id);
310 return 0;
311 }
312}
313
Subrata Banikb03cadf2021-06-09 22:19:04 +0530314__weak void mainboard_update_soc_chip_config(struct soc_intel_alderlake_config *config)
Subrata Banik2871e0e2020-09-27 11:30:58 +0530315{
Subrata Banikb03cadf2021-06-09 22:19:04 +0530316 /* Override settings per board. */
317}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530318
Subrata Banikb03cadf2021-06-09 22:19:04 +0530319static void fill_fsps_lpss_params(FSP_S_CONFIG *s_cfg,
320 const struct soc_intel_alderlake_config *config)
321{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530322 for (int i = 0; i < CONFIG_SOC_INTEL_I2C_DEV_MAX; i++)
Subrata Banikc0983c92021-06-15 13:02:01 +0530323 s_cfg->SerialIoI2cMode[i] = config->SerialIoI2cMode[i];
Subrata Banik2871e0e2020-09-27 11:30:58 +0530324
325 for (int i = 0; i < CONFIG_SOC_INTEL_COMMON_BLOCK_GSPI_MAX; i++) {
Subrata Banikc0983c92021-06-15 13:02:01 +0530326 s_cfg->SerialIoSpiMode[i] = config->SerialIoGSpiMode[i];
327 s_cfg->SerialIoSpiCsMode[i] = config->SerialIoGSpiCsMode[i];
328 s_cfg->SerialIoSpiCsState[i] = config->SerialIoGSpiCsState[i];
Subrata Banik2871e0e2020-09-27 11:30:58 +0530329 }
330
331 for (int i = 0; i < CONFIG_SOC_INTEL_UART_DEV_MAX; i++)
Subrata Banikc0983c92021-06-15 13:02:01 +0530332 s_cfg->SerialIoUartMode[i] = config->SerialIoUartMode[i];
Subrata Banik2871e0e2020-09-27 11:30:58 +0530333}
334
Subrata Banikb03cadf2021-06-09 22:19:04 +0530335static void fill_fsps_cpu_params(FSP_S_CONFIG *s_cfg,
336 const struct soc_intel_alderlake_config *config)
Subrata Banik2871e0e2020-09-27 11:30:58 +0530337{
Subrata Banik99289a82020-12-22 10:54:44 +0530338 const struct microcode *microcode_file;
339 size_t microcode_len;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530340
Subrata Banikb03cadf2021-06-09 22:19:04 +0530341 /* Locate microcode and pass to FSP-S for 2nd microcode loading */
Subrata Banik99289a82020-12-22 10:54:44 +0530342 microcode_file = cbfs_map("cpu_microcode_blob.bin", &microcode_len);
343
344 if ((microcode_file != NULL) && (microcode_len != 0)) {
345 /* Update CPU Microcode patch base address/size */
Subrata Banikc0983c92021-06-15 13:02:01 +0530346 s_cfg->MicrocodeRegionBase = (uint32_t)microcode_file;
347 s_cfg->MicrocodeRegionSize = (uint32_t)microcode_len;
Subrata Banik99289a82020-12-22 10:54:44 +0530348 }
349
Subrata Banikb03cadf2021-06-09 22:19:04 +0530350 /* Use coreboot MP PPI services if Kconfig is enabled */
351 if (CONFIG(USE_INTEL_FSP_TO_CALL_COREBOOT_PUBLISH_MP_PPI))
352 s_cfg->CpuMpPpi = (uintptr_t) mp_fill_ppi_services_data();
353}
354
355static void fill_fsps_igd_params(FSP_S_CONFIG *s_cfg,
356 const struct soc_intel_alderlake_config *config)
357{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530358 /* Load VBT before devicetree-specific config. */
Subrata Banikc0983c92021-06-15 13:02:01 +0530359 s_cfg->GraphicsConfigPtr = (uintptr_t)vbt_get();
Subrata Banik2871e0e2020-09-27 11:30:58 +0530360
361 /* Check if IGD is present and fill Graphics init param accordingly */
Subrata Banikc0983c92021-06-15 13:02:01 +0530362 s_cfg->PeiGraphicsPeimInit = CONFIG(RUN_FSP_GOP) && is_devfn_enabled(SA_DEVFN_IGD);
363 s_cfg->LidStatus = CONFIG(RUN_FSP_GOP);
Subrata Banikb03cadf2021-06-09 22:19:04 +0530364}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530365
Subrata Banikb03cadf2021-06-09 22:19:04 +0530366static void fill_fsps_tcss_params(FSP_S_CONFIG *s_cfg,
367 const struct soc_intel_alderlake_config *config)
368{
Subrata Banikc0983c92021-06-15 13:02:01 +0530369 s_cfg->TcssAuxOri = config->TcssAuxOri;
Deepti Deshatty8e7facf2021-05-12 17:45:37 +0530370
371 /* Explicitly clear this field to avoid using defaults */
Subrata Banikc0983c92021-06-15 13:02:01 +0530372 memset(s_cfg->IomTypeCPortPadCfg, 0, sizeof(s_cfg->IomTypeCPortPadCfg));
Subrata Banik2871e0e2020-09-27 11:30:58 +0530373
374 /*
375 * Set FSPS UPD ITbtConnectTopologyTimeoutInMs with value 0. FSP will
376 * evaluate this UPD value and skip sending command. There will be no
377 * delay for command completion.
378 */
Subrata Banikc0983c92021-06-15 13:02:01 +0530379 s_cfg->ITbtConnectTopologyTimeoutInMs = 0;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530380
Subrata Banikb03cadf2021-06-09 22:19:04 +0530381 /* D3Hot and D3Cold for TCSS */
382 s_cfg->D3HotEnable = !config->TcssD3HotDisable;
383 s_cfg->D3ColdEnable = !config->TcssD3ColdDisable;
Bernardo Perez Priego421ce562021-06-09 09:40:31 -0700384
385 s_cfg->UsbTcPortEn = 0;
386 for (int i = 0; i < MAX_TYPE_C_PORTS; i++) {
387 /* TCSS xHCI --> Root Hub --> Type-C Port */
388 const struct device_path port_path[] = {
389 {.type = DEVICE_PATH_PCI, .pci.devfn = SA_DEVFN_TCSS_XHCI},
390 {.type = DEVICE_PATH_USB, .usb.port_type = 0, .usb.port_id = 0},
391 {.type = DEVICE_PATH_USB, .usb.port_type = 3, .usb.port_id = i} };
392 const struct device *port = find_dev_nested_path(pci_root_bus(), port_path,
393 ARRAY_SIZE(port_path));
394
395 if (is_dev_enabled(port))
396 s_cfg->UsbTcPortEn |= BIT(i);
397 }
Subrata Banikb03cadf2021-06-09 22:19:04 +0530398}
399
400static void fill_fsps_chipset_lockdown_params(FSP_S_CONFIG *s_cfg,
401 const struct soc_intel_alderlake_config *config)
402{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530403 /* Chipset Lockdown */
Felix Singerf9d7dc72021-05-03 02:33:15 +0200404 const bool lockdown_by_fsp = get_lockdown_config() == CHIPSET_LOCKDOWN_FSP;
405 s_cfg->PchLockDownGlobalSmi = lockdown_by_fsp;
406 s_cfg->PchLockDownBiosInterface = lockdown_by_fsp;
407 s_cfg->PchUnlockGpioPads = !lockdown_by_fsp;
408 s_cfg->RtcMemoryLock = lockdown_by_fsp;
Tim Wawrzynczakc0e82e72021-06-17 12:42:35 -0600409
410 /* coreboot will send EOP before loading payload */
411 s_cfg->EndOfPostMessage = EOP_DISABLE;
Subrata Banikb03cadf2021-06-09 22:19:04 +0530412}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530413
Subrata Banikb03cadf2021-06-09 22:19:04 +0530414static void fill_fsps_xhci_params(FSP_S_CONFIG *s_cfg,
415 const struct soc_intel_alderlake_config *config)
416{
417 int i;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530418 /* USB */
419 for (i = 0; i < ARRAY_SIZE(config->usb2_ports); i++) {
Subrata Banikc0983c92021-06-15 13:02:01 +0530420 s_cfg->PortUsb20Enable[i] = config->usb2_ports[i].enable;
421 s_cfg->Usb2PhyPetxiset[i] = config->usb2_ports[i].pre_emp_bias;
422 s_cfg->Usb2PhyTxiset[i] = config->usb2_ports[i].tx_bias;
423 s_cfg->Usb2PhyPredeemp[i] = config->usb2_ports[i].tx_emp_enable;
424 s_cfg->Usb2PhyPehalfbit[i] = config->usb2_ports[i].pre_emp_bit;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530425
426 if (config->usb2_ports[i].enable)
Subrata Banikc0983c92021-06-15 13:02:01 +0530427 s_cfg->Usb2OverCurrentPin[i] = config->usb2_ports[i].ocpin;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530428 else
Subrata Banikc0983c92021-06-15 13:02:01 +0530429 s_cfg->Usb2OverCurrentPin[i] = OC_SKIP;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530430 }
431
432 for (i = 0; i < ARRAY_SIZE(config->usb3_ports); i++) {
Subrata Banikc0983c92021-06-15 13:02:01 +0530433 s_cfg->PortUsb30Enable[i] = config->usb3_ports[i].enable;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530434 if (config->usb3_ports[i].enable)
Subrata Banikc0983c92021-06-15 13:02:01 +0530435 s_cfg->Usb3OverCurrentPin[i] = config->usb3_ports[i].ocpin;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530436 else
Subrata Banikc0983c92021-06-15 13:02:01 +0530437 s_cfg->Usb3OverCurrentPin[i] = OC_SKIP;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530438
439 if (config->usb3_ports[i].tx_de_emp) {
Subrata Banikc0983c92021-06-15 13:02:01 +0530440 s_cfg->Usb3HsioTxDeEmphEnable[i] = 1;
441 s_cfg->Usb3HsioTxDeEmph[i] = config->usb3_ports[i].tx_de_emp;
Subrata Banik2871e0e2020-09-27 11:30:58 +0530442 }
443 if (config->usb3_ports[i].tx_downscale_amp) {
Subrata Banikc0983c92021-06-15 13:02:01 +0530444 s_cfg->Usb3HsioTxDownscaleAmpEnable[i] = 1;
445 s_cfg->Usb3HsioTxDownscaleAmp[i] =
Subrata Banik2871e0e2020-09-27 11:30:58 +0530446 config->usb3_ports[i].tx_downscale_amp;
447 }
448 }
449
Maulik V Vaghela69353502021-04-14 14:01:02 +0530450 for (i = 0; i < ARRAY_SIZE(config->tcss_ports); i++) {
451 if (config->tcss_ports[i].enable)
Subrata Banikc0983c92021-06-15 13:02:01 +0530452 s_cfg->CpuUsb3OverCurrentPin[i] = config->tcss_ports[i].ocpin;
Maulik V Vaghela69353502021-04-14 14:01:02 +0530453 }
Subrata Banikb03cadf2021-06-09 22:19:04 +0530454}
Maulik V Vaghela69353502021-04-14 14:01:02 +0530455
Subrata Banikb03cadf2021-06-09 22:19:04 +0530456static void fill_fsps_xdci_params(FSP_S_CONFIG *s_cfg,
457 const struct soc_intel_alderlake_config *config)
458{
Angel Ponsc7cfe0b2021-06-23 12:39:22 +0200459 s_cfg->XdciEnable = xdci_can_enable(PCH_DEVFN_USBOTG);
Subrata Banikb03cadf2021-06-09 22:19:04 +0530460}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530461
Subrata Banikb03cadf2021-06-09 22:19:04 +0530462static void fill_fsps_uart_params(FSP_S_CONFIG *s_cfg,
463 const struct soc_intel_alderlake_config *config)
464{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530465 /* PCH UART selection for FSP Debug */
Subrata Banikc0983c92021-06-15 13:02:01 +0530466 s_cfg->SerialIoDebugUartNumber = CONFIG_UART_FOR_CONSOLE;
467 ASSERT(ARRAY_SIZE(s_cfg->SerialIoUartAutoFlow) > CONFIG_UART_FOR_CONSOLE);
468 s_cfg->SerialIoUartAutoFlow[CONFIG_UART_FOR_CONSOLE] = 0;
Subrata Banikb03cadf2021-06-09 22:19:04 +0530469}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530470
Subrata Banikb03cadf2021-06-09 22:19:04 +0530471static void fill_fsps_sata_params(FSP_S_CONFIG *s_cfg,
472 const struct soc_intel_alderlake_config *config)
473{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530474 /* SATA */
Subrata Banikc0983c92021-06-15 13:02:01 +0530475 s_cfg->SataEnable = is_devfn_enabled(PCH_DEVFN_SATA);
476 if (s_cfg->SataEnable) {
477 s_cfg->SataMode = config->SataMode;
478 s_cfg->SataSalpSupport = config->SataSalpSupport;
479 memcpy(s_cfg->SataPortsEnable, config->SataPortsEnable,
480 sizeof(s_cfg->SataPortsEnable));
481 memcpy(s_cfg->SataPortsDevSlp, config->SataPortsDevSlp,
482 sizeof(s_cfg->SataPortsDevSlp));
Subrata Banik2871e0e2020-09-27 11:30:58 +0530483 }
484
485 /*
Subrata Banikb03cadf2021-06-09 22:19:04 +0530486 * Power Optimizer for SATA.
487 * SataPwrOptimizeDisable is default to 0.
Subrata Banik2871e0e2020-09-27 11:30:58 +0530488 * Boards not needing the optimizers explicitly disables them by setting
489 * these disable variables to 1 in devicetree overrides.
490 */
Subrata Banikc0983c92021-06-15 13:02:01 +0530491 s_cfg->SataPwrOptEnable = !(config->SataPwrOptimizeDisable);
Subrata Banik2871e0e2020-09-27 11:30:58 +0530492 /*
493 * Enable DEVSLP Idle Timeout settings DmVal and DitoVal.
494 * SataPortsDmVal is the DITO multiplier. Default is 15.
495 * SataPortsDitoVal is the DEVSLP Idle Timeout (DITO), Default is 625ms.
496 * The default values can be changed from devicetree.
497 */
Subrata Banikb03cadf2021-06-09 22:19:04 +0530498 for (size_t i = 0; i < ARRAY_SIZE(config->SataPortsEnableDitoConfig); i++) {
Subrata Banik2871e0e2020-09-27 11:30:58 +0530499 if (config->SataPortsEnableDitoConfig[i]) {
Subrata Banikc0983c92021-06-15 13:02:01 +0530500 s_cfg->SataPortsDmVal[i] = config->SataPortsDmVal[i];
501 s_cfg->SataPortsDitoVal[i] = config->SataPortsDitoVal[i];
Subrata Banik2871e0e2020-09-27 11:30:58 +0530502 }
503 }
Subrata Banikb03cadf2021-06-09 22:19:04 +0530504}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530505
Subrata Banikb03cadf2021-06-09 22:19:04 +0530506static void fill_fsps_thermal_params(FSP_S_CONFIG *s_cfg,
507 const struct soc_intel_alderlake_config *config)
508{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530509 /* Enable TCPU for processor thermal control */
Subrata Banikc0983c92021-06-15 13:02:01 +0530510 s_cfg->Device4Enable = is_devfn_enabled(SA_DEVFN_DPTF);
Subrata Banik2871e0e2020-09-27 11:30:58 +0530511
512 /* Set TccActivationOffset */
Subrata Banikc0983c92021-06-15 13:02:01 +0530513 s_cfg->TccActivationOffset = config->tcc_offset;
Subrata Banikb03cadf2021-06-09 22:19:04 +0530514}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530515
Subrata Banikb03cadf2021-06-09 22:19:04 +0530516static void fill_fsps_lan_params(FSP_S_CONFIG *s_cfg,
517 const struct soc_intel_alderlake_config *config)
518{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530519 /* LAN */
Subrata Banikc0983c92021-06-15 13:02:01 +0530520 s_cfg->PchLanEnable = is_devfn_enabled(PCH_DEVFN_GBE);
Subrata Banikb03cadf2021-06-09 22:19:04 +0530521}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530522
Subrata Banikb03cadf2021-06-09 22:19:04 +0530523static void fill_fsps_cnvi_params(FSP_S_CONFIG *s_cfg,
524 const struct soc_intel_alderlake_config *config)
525{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530526 /* CNVi */
Subrata Banikc0983c92021-06-15 13:02:01 +0530527 s_cfg->CnviMode = is_devfn_enabled(PCH_DEVFN_CNVI_WIFI);
528 s_cfg->CnviBtCore = config->CnviBtCore;
529 s_cfg->CnviBtAudioOffload = config->CnviBtAudioOffload;
Cliff Huangbc1941f2021-02-10 17:41:41 -0800530 /* Assert if CNVi BT is enabled without CNVi being enabled. */
Subrata Banikc0983c92021-06-15 13:02:01 +0530531 assert(s_cfg->CnviMode || !s_cfg->CnviBtCore);
Cliff Huangbc1941f2021-02-10 17:41:41 -0800532 /* Assert if CNVi BT offload is enabled without CNVi BT being enabled. */
Subrata Banikc0983c92021-06-15 13:02:01 +0530533 assert(s_cfg->CnviBtCore || !s_cfg->CnviBtAudioOffload);
Subrata Banikb03cadf2021-06-09 22:19:04 +0530534}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530535
Subrata Banikb03cadf2021-06-09 22:19:04 +0530536static void fill_fsps_vmd_params(FSP_S_CONFIG *s_cfg,
537 const struct soc_intel_alderlake_config *config)
538{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530539 /* VMD */
Subrata Banikc0983c92021-06-15 13:02:01 +0530540 s_cfg->VmdEnable = is_devfn_enabled(SA_DEVFN_VMD);
Subrata Banikb03cadf2021-06-09 22:19:04 +0530541}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530542
Subrata Banikb03cadf2021-06-09 22:19:04 +0530543static void fill_fsps_thc_params(FSP_S_CONFIG *s_cfg,
544 const struct soc_intel_alderlake_config *config)
545{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530546 /* THC */
Subrata Banikc0983c92021-06-15 13:02:01 +0530547 s_cfg->ThcPort0Assignment = is_devfn_enabled(PCH_DEVFN_THC0) ? THC_0 : THC_NONE;
548 s_cfg->ThcPort1Assignment = is_devfn_enabled(PCH_DEVFN_THC1) ? THC_1 : THC_NONE;
Subrata Banikb03cadf2021-06-09 22:19:04 +0530549}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530550
Subrata Banikb03cadf2021-06-09 22:19:04 +0530551static void fill_fsps_tbt_params(FSP_S_CONFIG *s_cfg,
552 const struct soc_intel_alderlake_config *config)
553{
Bernardo Perez Priego095f97b2021-05-18 18:39:19 -0700554 /* USB4/TBT */
Subrata Banikb03cadf2021-06-09 22:19:04 +0530555 for (int i = 0; i < ARRAY_SIZE(s_cfg->ITbtPcieRootPortEn); i++)
Subrata Banikc0983c92021-06-15 13:02:01 +0530556 s_cfg->ITbtPcieRootPortEn[i] = is_devfn_enabled(SA_DEVFN_TBT(i));
Subrata Banikb03cadf2021-06-09 22:19:04 +0530557}
Bernardo Perez Priego095f97b2021-05-18 18:39:19 -0700558
Subrata Banikb03cadf2021-06-09 22:19:04 +0530559static void fill_fsps_8254_params(FSP_S_CONFIG *s_cfg,
560 const struct soc_intel_alderlake_config *config)
561{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530562 /* Legacy 8254 timer support */
Sean Rhodesbc35bed2021-07-13 13:36:28 +0100563 bool use_8254 = get_uint_option("legacy_8254_timer", CONFIG(USE_LEGACY_8254_TIMER));
564 s_cfg->Enable8254ClockGating = !use_8254;
565 s_cfg->Enable8254ClockGatingOnS3 = !use_8254;
Subrata Banikb03cadf2021-06-09 22:19:04 +0530566}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530567
Subrata Banikb03cadf2021-06-09 22:19:04 +0530568static void fill_fsps_storage_params(FSP_S_CONFIG *s_cfg,
569 const struct soc_intel_alderlake_config *config)
570{
Subrata Banik2871e0e2020-09-27 11:30:58 +0530571 /* Enable Hybrid storage auto detection */
Subrata Banikc0983c92021-06-15 13:02:01 +0530572 s_cfg->HybridStorageMode = config->HybridStorageMode;
Subrata Banikb03cadf2021-06-09 22:19:04 +0530573}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530574
Subrata Banikb03cadf2021-06-09 22:19:04 +0530575static void fill_fsps_pcie_params(FSP_S_CONFIG *s_cfg,
576 const struct soc_intel_alderlake_config *config)
577{
578 uint32_t enable_mask = pcie_rp_enable_mask(get_pch_pcie_rp_table());
579 for (int i = 0; i < CONFIG_MAX_PCH_ROOT_PORTS; i++) {
Eric Lai5b302b22020-12-05 16:49:43 +0800580 if (!(enable_mask & BIT(i)))
581 continue;
582 const struct pcie_rp_config *rp_cfg = &config->pch_pcie_rp[i];
Subrata Banikc0983c92021-06-15 13:02:01 +0530583 s_cfg->PcieRpL1Substates[i] =
Eric Lai5b302b22020-12-05 16:49:43 +0800584 get_l1_substate_control(rp_cfg->PcieRpL1Substates);
Subrata Banikc0983c92021-06-15 13:02:01 +0530585 s_cfg->PcieRpLtrEnable[i] = !!(rp_cfg->flags & PCIE_RP_LTR);
586 s_cfg->PcieRpAdvancedErrorReporting[i] = !!(rp_cfg->flags & PCIE_RP_AER);
587 s_cfg->PcieRpHotPlug[i] = !!(rp_cfg->flags & PCIE_RP_HOTPLUG);
588 s_cfg->PcieRpClkReqDetect[i] = !!(rp_cfg->flags & PCIE_RP_CLK_REQ_DETECT);
Subrata Banik2871e0e2020-09-27 11:30:58 +0530589 }
Subrata Banikb03cadf2021-06-09 22:19:04 +0530590}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530591
Subrata Banikb03cadf2021-06-09 22:19:04 +0530592static void fill_fsps_misc_power_params(FSP_S_CONFIG *s_cfg,
593 const struct soc_intel_alderlake_config *config)
594{
595 /*
596 * Power Optimizer for DMI
597 * DmiPwrOptimizeDisable is default to 0.
598 * Boards not needing the optimizers explicitly disables them by setting
599 * these disable variables to 1 in devicetree overrides.
600 */
601 s_cfg->PchPwrOptEnable = !(config->DmiPwrOptimizeDisable);
Subrata Banikc0983c92021-06-15 13:02:01 +0530602 s_cfg->PmSupport = 1;
603 s_cfg->Hwp = 1;
604 s_cfg->Cx = 1;
605 s_cfg->PsOnEnable = 1;
V Sowmya844dcb32021-06-21 10:03:53 +0530606 /* Enable the energy efficient turbo mode */
607 s_cfg->EnergyEfficientTurbo = 1;
V Sowmyaaf429062021-06-21 10:23:33 +0530608 s_cfg->PkgCStateLimit = LIMIT_AUTO;
V Sowmya458708f2021-07-09 22:11:04 +0530609
610 /* VccIn Aux Imon IccMax. Values are in 1/4 Amp increments and range is 0-512. */
611 s_cfg->VccInAuxImonIccImax = get_vccin_aux_imon_iccmax() * 4 / MILLIAMPS_TO_AMPS;
V Sowmyac6d71662021-07-15 08:11:08 +0530612
613 /* VrConfig Settings for IA and GT domains */
614 for (size_t i = 0; i < ARRAY_SIZE(config->domain_vr_config); i++)
615 fill_vr_domain_config(s_cfg, i, &config->domain_vr_config[i]);
Subrata Banik6f1cb402021-06-09 22:11:12 +0530616}
Subrata Banik2871e0e2020-09-27 11:30:58 +0530617
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600618static void fill_fsps_irq_params(FSP_S_CONFIG *s_cfg,
619 const struct soc_intel_alderlake_config *config)
620{
621 if (!assign_pci_irqs(irq_constraints, ARRAY_SIZE(irq_constraints)))
622 die("ERROR: Unable to assign PCI IRQs, and no _PRT table available\n");
623
624 size_t pch_count = 0;
625 const SI_PCH_DEVICE_INTERRUPT_CONFIG *upd_irqs = pci_irq_to_fsp(&pch_count);
626
627 s_cfg->DevIntConfigPtr = (UINT32)((uintptr_t)upd_irqs);
628 s_cfg->NumOfDevIntConfig = pch_count;
629 printk(BIOS_INFO, "IRQ: Using dynamically assigned PCI IO-APIC IRQs\n");
630}
631
V Sowmya418d37e2021-06-21 08:47:17 +0530632static void fill_fsps_fivr_params(FSP_S_CONFIG *s_cfg,
633 const struct soc_intel_alderlake_config *config)
634{
635 /* PCH FIVR settings override */
636 if (!config->ext_fivr_settings.configure_ext_fivr)
637 return;
638
639 s_cfg->PchFivrExtV1p05RailEnabledStates =
640 config->ext_fivr_settings.v1p05_enable_bitmap;
641
642 s_cfg->PchFivrExtV1p05RailSupportedVoltageStates =
643 config->ext_fivr_settings.v1p05_supported_voltage_bitmap;
644
645 s_cfg->PchFivrExtVnnRailEnabledStates =
646 config->ext_fivr_settings.vnn_enable_bitmap;
647
648 s_cfg->PchFivrExtVnnRailSupportedVoltageStates =
649 config->ext_fivr_settings.vnn_supported_voltage_bitmap;
650
651 s_cfg->PchFivrExtVnnRailSxEnabledStates =
652 config->ext_fivr_settings.vnn_enable_bitmap;
653
654 /* Convert the voltages to increments of 2.5mv */
655 s_cfg->PchFivrExtV1p05RailVoltage =
656 (config->ext_fivr_settings.v1p05_voltage_mv * 10) / 25;
657
658 s_cfg->PchFivrExtVnnRailVoltage =
659 (config->ext_fivr_settings.vnn_voltage_mv * 10) / 25;
660
661 s_cfg->PchFivrExtVnnRailSxVoltage =
662 (config->ext_fivr_settings.vnn_sx_voltage_mv * 10 / 25);
663
664 s_cfg->PchFivrExtV1p05RailIccMaximum =
665 config->ext_fivr_settings.v1p05_icc_max_ma;
666
667 s_cfg->PchFivrExtVnnRailIccMaximum =
668 config->ext_fivr_settings.vnn_icc_max_ma;
669}
670
Subrata Banik6f1cb402021-06-09 22:11:12 +0530671static void arch_silicon_init_params(FSPS_ARCH_UPD *s_arch_cfg)
672{
673 /* EnableMultiPhaseSiliconInit for running MultiPhaseSiInit */
674 s_arch_cfg->EnableMultiPhaseSiliconInit = 1;
675}
676
Subrata Banikb03cadf2021-06-09 22:19:04 +0530677static void soc_silicon_init_params(FSP_S_CONFIG *s_cfg,
678 struct soc_intel_alderlake_config *config)
679{
680 /* Override settings per board if required. */
681 mainboard_update_soc_chip_config(config);
682
V Sowmya6464c2a2021-06-25 10:20:25 +0530683 const void (*fill_fsps_params[])(FSP_S_CONFIG *s_cfg,
Subrata Banikb03cadf2021-06-09 22:19:04 +0530684 const struct soc_intel_alderlake_config *config) = {
685 fill_fsps_lpss_params,
686 fill_fsps_cpu_params,
687 fill_fsps_igd_params,
688 fill_fsps_tcss_params,
689 fill_fsps_chipset_lockdown_params,
690 fill_fsps_xhci_params,
691 fill_fsps_xdci_params,
692 fill_fsps_uart_params,
693 fill_fsps_sata_params,
694 fill_fsps_thermal_params,
695 fill_fsps_lan_params,
696 fill_fsps_cnvi_params,
697 fill_fsps_vmd_params,
698 fill_fsps_thc_params,
699 fill_fsps_tbt_params,
700 fill_fsps_8254_params,
701 fill_fsps_storage_params,
702 fill_fsps_pcie_params,
703 fill_fsps_misc_power_params,
Tim Wawrzynczak43607e42021-05-18 09:04:42 -0600704 fill_fsps_irq_params,
V Sowmya418d37e2021-06-21 08:47:17 +0530705 fill_fsps_fivr_params,
Subrata Banikb03cadf2021-06-09 22:19:04 +0530706 };
707
708 for (size_t i = 0; i < ARRAY_SIZE(fill_fsps_params); i++)
709 fill_fsps_params[i](s_cfg, config);
710}
711
Subrata Banik6f1cb402021-06-09 22:11:12 +0530712/* UPD parameters to be initialized before SiliconInit */
713void platform_fsp_silicon_init_params_cb(FSPS_UPD *supd)
714{
715 struct soc_intel_alderlake_config *config;
Subrata Banikc0983c92021-06-15 13:02:01 +0530716 FSP_S_CONFIG *s_cfg = &supd->FspsConfig;
Subrata Banik6f1cb402021-06-09 22:11:12 +0530717 FSPS_ARCH_UPD *s_arch_cfg = &supd->FspsArchUpd;
718
719 config = config_of_soc();
Subrata Banik6f1cb402021-06-09 22:11:12 +0530720 arch_silicon_init_params(s_arch_cfg);
Subrata Banikc0983c92021-06-15 13:02:01 +0530721 soc_silicon_init_params(s_cfg, config);
722 mainboard_silicon_init_params(s_cfg);
Subrata Banik2871e0e2020-09-27 11:30:58 +0530723}
724
Subrata Banik2871e0e2020-09-27 11:30:58 +0530725/*
726 * Callbacks for SoC/Mainboard specific overrides for FspMultiPhaseSiInit
727 * This platform supports below MultiPhaseSIInit Phase(s):
728 * Phase | FSP return point | Purpose
729 * ------- + ------------------------------------------------ + -------------------------------
730 * 1 | After TCSS initialization completed | for TCSS specific init
731 */
732void platform_fsp_multi_phase_init_cb(uint32_t phase_index)
733{
734 switch (phase_index) {
735 case 1:
736 /* TCSS specific initialization here */
Deepti Deshatty8e7facf2021-05-12 17:45:37 +0530737 printk(BIOS_DEBUG, "FSP MultiPhaseSiInit %s/%s called\n",
738 __FILE__, __func__);
739
740 if (CONFIG(SOC_INTEL_COMMON_BLOCK_TCSS)) {
741 const config_t *config = config_of_soc();
742 tcss_configure(config->typec_aux_bias_pads);
743 }
Subrata Banik2871e0e2020-09-27 11:30:58 +0530744 break;
745 default:
746 break;
747 }
748}
749
750/* Mainboard GPIO Configuration */
Subrata Banikc0983c92021-06-15 13:02:01 +0530751__weak void mainboard_silicon_init_params(FSP_S_CONFIG *s_cfg)
Subrata Banik2871e0e2020-09-27 11:30:58 +0530752{
753 printk(BIOS_DEBUG, "WEAK: %s/%s called\n", __FILE__, __func__);
754}