1 // SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) 2 // 3 // This file is provided under a dual BSD/GPLv2 license. When using or 4 // redistributing this file, you may do so under either license. 5 // 6 // Copyright(c) 2018 Intel Corporation. All rights reserved. 7 // 8 // Author: Liam Girdwood <[email protected]> 9 // 10 11 #include <linux/firmware.h> 12 #include <linux/dmi.h> 13 #include <linux/module.h> 14 #include <linux/pci.h> 15 #include <linux/platform_data/x86/soc.h> 16 #include <linux/pm_runtime.h> 17 #include <sound/soc-acpi.h> 18 #include <sound/soc-acpi-intel-match.h> 19 #include <sound/sof.h> 20 #include "ops.h" 21 #include "sof-pci-dev.h" 22 23 static char *fw_path; 24 module_param(fw_path, charp, 0444); 25 MODULE_PARM_DESC(fw_path, "alternate path for SOF firmware."); 26 27 static char *fw_filename; 28 module_param(fw_filename, charp, 0444); 29 MODULE_PARM_DESC(fw_filename, "alternate filename for SOF firmware."); 30 31 static char *lib_path; 32 module_param(lib_path, charp, 0444); 33 MODULE_PARM_DESC(lib_path, "alternate path for SOF firmware libraries."); 34 35 static char *tplg_path; 36 module_param(tplg_path, charp, 0444); 37 MODULE_PARM_DESC(tplg_path, "alternate path for SOF topology."); 38 39 static char *tplg_filename; 40 module_param(tplg_filename, charp, 0444); 41 MODULE_PARM_DESC(tplg_filename, "alternate filename for SOF topology."); 42 43 static int sof_pci_debug; 44 module_param_named(sof_pci_debug, sof_pci_debug, int, 0444); 45 MODULE_PARM_DESC(sof_pci_debug, "SOF PCI debug options (0x0 all off)"); 46 47 static int sof_pci_ipc_type = -1; 48 module_param_named(ipc_type, sof_pci_ipc_type, int, 0444); 49 MODULE_PARM_DESC(ipc_type, "Force SOF IPC type. 0 - IPC3, 1 - IPC4"); 50 51 static const char *sof_dmi_override_tplg_name; 52 static bool sof_dmi_use_community_key; 53 54 #define SOF_PCI_DISABLE_PM_RUNTIME BIT(0) 55 56 static int sof_tplg_cb(const struct dmi_system_id *id) 57 { 58 sof_dmi_override_tplg_name = id->driver_data; 59 return 1; 60 } 61 62 static const struct dmi_system_id sof_tplg_table[] = { 63 { 64 .callback = sof_tplg_cb, 65 .matches = { 66 DMI_MATCH(DMI_PRODUCT_FAMILY, "Google_Volteer"), 67 DMI_MATCH(DMI_OEM_STRING, "AUDIO-MAX98373_ALC5682I_I2S_UP4"), 68 }, 69 .driver_data = "sof-tgl-rt5682-ssp0-max98373-ssp2.tplg", 70 }, 71 { 72 .callback = sof_tplg_cb, 73 .matches = { 74 DMI_MATCH(DMI_SYS_VENDOR, "Intel Corporation"), 75 DMI_MATCH(DMI_PRODUCT_NAME, "Alder Lake Client Platform"), 76 DMI_MATCH(DMI_OEM_STRING, "AUDIO-ADL_MAX98373_ALC5682I_I2S"), 77 }, 78 .driver_data = "sof-adl-rt5682-ssp0-max98373-ssp2.tplg", 79 }, 80 { 81 .callback = sof_tplg_cb, 82 .matches = { 83 DMI_MATCH(DMI_PRODUCT_FAMILY, "Google_Brya"), 84 DMI_MATCH(DMI_OEM_STRING, "AUDIO-MAX98390_ALC5682I_I2S"), 85 }, 86 .driver_data = "sof-adl-max98390-ssp2-rt5682-ssp0.tplg", 87 }, 88 { 89 .callback = sof_tplg_cb, 90 .matches = { 91 DMI_MATCH(DMI_PRODUCT_FAMILY, "Google_Brya"), 92 DMI_MATCH(DMI_OEM_STRING, "AUDIO_AMP-MAX98360_ALC5682VS_I2S_2WAY"), 93 }, 94 .driver_data = "sof-adl-max98360a-rt5682-2way.tplg", 95 }, 96 { 97 .callback = sof_tplg_cb, 98 .matches = { 99 DMI_MATCH(DMI_PRODUCT_FAMILY, "Google_Brya"), 100 DMI_MATCH(DMI_OEM_STRING, "AUDIO-AUDIO_MAX98357_ALC5682I_I2S_2WAY"), 101 }, 102 .driver_data = "sof-adl-max98357a-rt5682-2way.tplg", 103 }, 104 { 105 .callback = sof_tplg_cb, 106 .matches = { 107 DMI_MATCH(DMI_PRODUCT_FAMILY, "Google_Brya"), 108 DMI_MATCH(DMI_OEM_STRING, "AUDIO-MAX98360_ALC5682I_I2S_AMP_SSP2"), 109 }, 110 .driver_data = "sof-adl-max98357a-rt5682.tplg", 111 }, 112 {} 113 }; 114 115 /* all Up boards use the community key */ 116 static int up_use_community_key(const struct dmi_system_id *id) 117 { 118 sof_dmi_use_community_key = true; 119 return 1; 120 } 121 122 /* 123 * For ApolloLake Chromebooks we want to force the use of the Intel production key. 124 * All newer platforms use the community key 125 */ 126 static int chromebook_use_community_key(const struct dmi_system_id *id) 127 { 128 if (!soc_intel_is_apl()) 129 sof_dmi_use_community_key = true; 130 return 1; 131 } 132 133 static const struct dmi_system_id community_key_platforms[] = { 134 { 135 .ident = "Up boards", 136 .callback = up_use_community_key, 137 .matches = { 138 DMI_MATCH(DMI_SYS_VENDOR, "AAEON"), 139 } 140 }, 141 { 142 .ident = "Google Chromebooks", 143 .callback = chromebook_use_community_key, 144 .matches = { 145 DMI_MATCH(DMI_PRODUCT_FAMILY, "Google"), 146 } 147 }, 148 { 149 .ident = "Google firmware", 150 .callback = chromebook_use_community_key, 151 .matches = { 152 DMI_MATCH(DMI_BIOS_VERSION, "Google"), 153 } 154 }, 155 {}, 156 }; 157 158 const struct dev_pm_ops sof_pci_pm = { 159 .prepare = snd_sof_prepare, 160 .complete = snd_sof_complete, 161 SET_SYSTEM_SLEEP_PM_OPS(snd_sof_suspend, snd_sof_resume) 162 SET_RUNTIME_PM_OPS(snd_sof_runtime_suspend, snd_sof_runtime_resume, 163 snd_sof_runtime_idle) 164 }; 165 EXPORT_SYMBOL_NS(sof_pci_pm, SND_SOC_SOF_PCI_DEV); 166 167 static void sof_pci_probe_complete(struct device *dev) 168 { 169 dev_dbg(dev, "Completing SOF PCI probe"); 170 171 if (sof_pci_debug & SOF_PCI_DISABLE_PM_RUNTIME) 172 return; 173 174 /* allow runtime_pm */ 175 pm_runtime_set_autosuspend_delay(dev, SND_SOF_SUSPEND_DELAY_MS); 176 pm_runtime_use_autosuspend(dev); 177 178 /* 179 * runtime pm for pci device is "forbidden" by default. 180 * so call pm_runtime_allow() to enable it. 181 */ 182 pm_runtime_allow(dev); 183 184 /* mark last_busy for pm_runtime to make sure not suspend immediately */ 185 pm_runtime_mark_last_busy(dev); 186 187 /* follow recommendation in pci-driver.c to decrement usage counter */ 188 pm_runtime_put_noidle(dev); 189 } 190 191 int sof_pci_probe(struct pci_dev *pci, const struct pci_device_id *pci_id) 192 { 193 struct sof_loadable_file_profile *path_override; 194 struct device *dev = &pci->dev; 195 const struct sof_dev_desc *desc = 196 (const struct sof_dev_desc *)pci_id->driver_data; 197 struct snd_sof_pdata *sof_pdata; 198 int ret; 199 200 dev_dbg(&pci->dev, "PCI DSP detected"); 201 202 if (!desc) { 203 dev_err(dev, "error: no matching PCI descriptor\n"); 204 return -ENODEV; 205 } 206 207 if (!desc->ops) { 208 dev_err(dev, "error: no matching PCI descriptor ops\n"); 209 return -ENODEV; 210 } 211 212 sof_pdata = devm_kzalloc(dev, sizeof(*sof_pdata), GFP_KERNEL); 213 if (!sof_pdata) 214 return -ENOMEM; 215 216 ret = pcim_enable_device(pci); 217 if (ret < 0) 218 return ret; 219 220 ret = pci_request_regions(pci, "Audio DSP"); 221 if (ret < 0) 222 return ret; 223 224 sof_pdata->name = pci_name(pci); 225 226 /* PCI defines a vendor ID of 0xFFFF as invalid. */ 227 if (pci->subsystem_vendor != 0xFFFF) { 228 sof_pdata->subsystem_vendor = pci->subsystem_vendor; 229 sof_pdata->subsystem_device = pci->subsystem_device; 230 sof_pdata->subsystem_id_set = true; 231 } 232 233 sof_pdata->desc = desc; 234 sof_pdata->dev = dev; 235 236 sof_pdata->ipc_type = desc->ipc_default; 237 238 if (sof_pci_ipc_type < 0) { 239 sof_pdata->ipc_type = desc->ipc_default; 240 } else { 241 dev_info(dev, "overriding default IPC %d to requested %d\n", 242 desc->ipc_default, sof_pci_ipc_type); 243 if (sof_pci_ipc_type >= SOF_IPC_TYPE_COUNT) { 244 dev_err(dev, "invalid request value %d\n", sof_pci_ipc_type); 245 ret = -EINVAL; 246 goto out; 247 } 248 if (!(BIT(sof_pci_ipc_type) & desc->ipc_supported_mask)) { 249 dev_err(dev, "invalid request value %d, supported mask is %#x\n", 250 sof_pci_ipc_type, desc->ipc_supported_mask); 251 ret = -EINVAL; 252 goto out; 253 } 254 sof_pdata->ipc_type = sof_pci_ipc_type; 255 } 256 257 if (fw_filename) { 258 sof_pdata->fw_filename = fw_filename; 259 260 dev_dbg(dev, "Module parameter used, changed fw filename to %s\n", 261 sof_pdata->fw_filename); 262 } else { 263 sof_pdata->fw_filename = desc->default_fw_filename[sof_pdata->ipc_type]; 264 } 265 266 /* 267 * for platforms using the SOF community key, change the 268 * default path automatically to pick the right files from the 269 * linux-firmware tree. This can be overridden with the 270 * fw_path kernel parameter, e.g. for developers. 271 */ 272 273 /* alternate fw and tplg filenames ? */ 274 if (fw_path) { 275 sof_pdata->fw_filename_prefix = fw_path; 276 277 dev_dbg(dev, 278 "Module parameter used, changed fw path to %s\n", 279 sof_pdata->fw_filename_prefix); 280 281 } else if (dmi_check_system(community_key_platforms) && sof_dmi_use_community_key) { 282 sof_pdata->fw_filename_prefix = 283 devm_kasprintf(dev, GFP_KERNEL, "%s/%s", 284 sof_pdata->desc->default_fw_path[sof_pdata->ipc_type], 285 "community"); 286 287 dev_dbg(dev, 288 "Platform uses community key, changed fw path to %s\n", 289 sof_pdata->fw_filename_prefix); 290 } else { 291 sof_pdata->fw_filename_prefix = 292 sof_pdata->desc->default_fw_path[sof_pdata->ipc_type]; 293 } 294 295 if (lib_path) { 296 sof_pdata->fw_lib_prefix = lib_path; 297 298 dev_dbg(dev, "Module parameter used, changed fw_lib path to %s\n", 299 sof_pdata->fw_lib_prefix); 300 301 } else if (sof_pdata->desc->default_lib_path[sof_pdata->ipc_type]) { 302 if (dmi_check_system(community_key_platforms) && sof_dmi_use_community_key) { 303 sof_pdata->fw_lib_prefix = 304 devm_kasprintf(dev, GFP_KERNEL, "%s/%s", 305 sof_pdata->desc->default_lib_path[sof_pdata->ipc_type], 306 "community"); 307 308 dev_dbg(dev, 309 "Platform uses community key, changed fw_lib path to %s\n", 310 sof_pdata->fw_lib_prefix); 311 } else { 312 sof_pdata->fw_lib_prefix = 313 sof_pdata->desc->default_lib_path[sof_pdata->ipc_type]; 314 } 315 } 316 317 if (tplg_path) 318 sof_pdata->tplg_filename_prefix = tplg_path; 319 else 320 sof_pdata->tplg_filename_prefix = 321 sof_pdata->desc->default_tplg_path[sof_pdata->ipc_type]; 322 323 /* 324 * the topology filename will be provided in the machine descriptor, unless 325 * it is overridden by a module parameter or DMI quirk. 326 */ 327 if (tplg_filename) { 328 sof_pdata->tplg_filename = tplg_filename; 329 330 dev_dbg(dev, "Module parameter used, changed tplg filename to %s\n", 331 sof_pdata->tplg_filename); 332 } else { 333 dmi_check_system(sof_tplg_table); 334 if (sof_dmi_override_tplg_name) 335 sof_pdata->tplg_filename = sof_dmi_override_tplg_name; 336 } 337 338 path_override = &sof_pdata->ipc_file_profile_base; 339 path_override->ipc_type = sof_pdata->ipc_type; 340 path_override->fw_path = fw_path; 341 path_override->fw_name = fw_filename; 342 path_override->fw_lib_path = lib_path; 343 path_override->tplg_path = tplg_path; 344 path_override->tplg_name = sof_pdata->tplg_filename; 345 346 if (dmi_check_system(community_key_platforms) && 347 sof_dmi_use_community_key) { 348 path_override->fw_path_postfix = "community"; 349 path_override->fw_lib_path_postfix = "community"; 350 } 351 352 /* set callback to be called on successful device probe to enable runtime_pm */ 353 sof_pdata->sof_probe_complete = sof_pci_probe_complete; 354 355 /* call sof helper for DSP hardware probe */ 356 ret = snd_sof_device_probe(dev, sof_pdata); 357 358 out: 359 if (ret) 360 pci_release_regions(pci); 361 362 return ret; 363 } 364 EXPORT_SYMBOL_NS(sof_pci_probe, SND_SOC_SOF_PCI_DEV); 365 366 void sof_pci_remove(struct pci_dev *pci) 367 { 368 /* call sof helper for DSP hardware remove */ 369 snd_sof_device_remove(&pci->dev); 370 371 /* follow recommendation in pci-driver.c to increment usage counter */ 372 if (snd_sof_device_probe_completed(&pci->dev) && 373 !(sof_pci_debug & SOF_PCI_DISABLE_PM_RUNTIME)) 374 pm_runtime_get_noresume(&pci->dev); 375 376 /* release pci regions and disable device */ 377 pci_release_regions(pci); 378 } 379 EXPORT_SYMBOL_NS(sof_pci_remove, SND_SOC_SOF_PCI_DEV); 380 381 void sof_pci_shutdown(struct pci_dev *pci) 382 { 383 snd_sof_device_shutdown(&pci->dev); 384 } 385 EXPORT_SYMBOL_NS(sof_pci_shutdown, SND_SOC_SOF_PCI_DEV); 386 387 MODULE_LICENSE("Dual BSD/GPL"); 388