forked from torvalds/linux
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
ASoC: Intel: AVS - Audio DSP for cAVS
Merge series from Cezary Rojewski <[email protected]>: A continuation of cleanup work of Intel SST solutions found in sound/soc/intel/. With two major chapters released last year catpt [1] and removal of haswell solution [2], time has come for Skylake-driver. Througout 2019, 2020 and 2021 Skylake-driver has had many fixes applied and even attempts of refactors as seen in fundamental overhaul [3], IPC flow adjustments [4] and LARGE_CONFIG overhaul [5] series. Unfortunately, story repeats itself - problems are found within the core of a driver. Painting it with different colors does not change the fact that is it still a house of cards. As changes needed to address those issues would make Skylake solution incompatible with its previous revisions, a decision has been made to provide a new solution instead. In time it would deprecate and replace Skylake-driver. That solution has been called AVS - from AudioDSP architecture name: Audio-Voice-Speech. It is meant to provide support for the exact same range of platforms as its predecessor: SKL, KBL, AML and APL. Note: this series is dependent upon HDA-series [6] which exposes several codec-organization functions allowing for reduced code size on avs-driver side. Note: this series does not add fully functional driver as its size would get out of control. Here, focus is put on adding IPC protocol and code loading code.
- Loading branch information
Showing
19 changed files
with
3,857 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| # SPDX-License-Identifier: GPL-2.0-only | ||
|
|
||
| snd-soc-avs-objs := dsp.o ipc.o messages.o utils.o core.o loader.o | ||
| snd-soc-avs-objs += cldma.o | ||
|
|
||
| obj-$(CONFIG_SND_SOC_INTEL_AVS) += snd-soc-avs.o |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,247 @@ | ||
| /* SPDX-License-Identifier: GPL-2.0-only */ | ||
| /* | ||
| * Copyright(c) 2021-2022 Intel Corporation. All rights reserved. | ||
| * | ||
| * Authors: Cezary Rojewski <[email protected]> | ||
| * Amadeusz Slawinski <[email protected]> | ||
| */ | ||
|
|
||
| #ifndef __SOUND_SOC_INTEL_AVS_H | ||
| #define __SOUND_SOC_INTEL_AVS_H | ||
|
|
||
| #include <linux/device.h> | ||
| #include <linux/firmware.h> | ||
| #include <sound/hda_codec.h> | ||
| #include <sound/hda_register.h> | ||
| #include "messages.h" | ||
| #include "registers.h" | ||
|
|
||
| struct avs_dev; | ||
|
|
||
| /* | ||
| * struct avs_dsp_ops - Platform-specific DSP operations | ||
| * | ||
| * @power: Power on or off DSP cores | ||
| * @reset: Enter or exit reset state on DSP cores | ||
| * @stall: Stall or run DSP cores | ||
| * @irq_handler: Top half of IPC servicing | ||
| * @irq_thread: Bottom half of IPC servicing | ||
| * @int_control: Enable or disable IPC interrupts | ||
| */ | ||
| struct avs_dsp_ops { | ||
| int (* const power)(struct avs_dev *, u32, bool); | ||
| int (* const reset)(struct avs_dev *, u32, bool); | ||
| int (* const stall)(struct avs_dev *, u32, bool); | ||
| irqreturn_t (* const irq_handler)(int, void *); | ||
| irqreturn_t (* const irq_thread)(int, void *); | ||
| void (* const int_control)(struct avs_dev *, bool); | ||
| int (* const load_basefw)(struct avs_dev *, struct firmware *); | ||
| int (* const load_lib)(struct avs_dev *, struct firmware *, u32); | ||
| int (* const transfer_mods)(struct avs_dev *, bool, struct avs_module_entry *, u32); | ||
| }; | ||
|
|
||
| #define avs_dsp_op(adev, op, ...) \ | ||
| ((adev)->spec->dsp_ops->op(adev, ## __VA_ARGS__)) | ||
|
|
||
| #define AVS_PLATATTR_CLDMA BIT_ULL(0) | ||
| #define AVS_PLATATTR_IMR BIT_ULL(1) | ||
|
|
||
| #define avs_platattr_test(adev, attr) \ | ||
| ((adev)->spec->attributes & AVS_PLATATTR_##attr) | ||
|
|
||
| /* Platform specific descriptor */ | ||
| struct avs_spec { | ||
| const char *name; | ||
|
|
||
| const struct avs_dsp_ops *const dsp_ops; | ||
| struct avs_fw_version min_fw_version; /* anything below is rejected */ | ||
|
|
||
| const u32 core_init_mask; /* used during DSP boot */ | ||
| const u64 attributes; /* bitmask of AVS_PLATATTR_* */ | ||
| const u32 sram_base_offset; | ||
| const u32 sram_window_size; | ||
| const u32 rom_status; | ||
| }; | ||
|
|
||
| struct avs_fw_entry { | ||
| char *name; | ||
| const struct firmware *fw; | ||
|
|
||
| struct list_head node; | ||
| }; | ||
|
|
||
| /* | ||
| * struct avs_dev - Intel HD-Audio driver data | ||
| * | ||
| * @dev: PCI device | ||
| * @dsp_ba: DSP bar address | ||
| * @spec: platform-specific descriptor | ||
| * @fw_cfg: Firmware configuration, obtained through FW_CONFIG message | ||
| * @hw_cfg: Hardware configuration, obtained through HW_CONFIG message | ||
| * @mods_info: Available module-types, obtained through MODULES_INFO message | ||
| * @mod_idas: Module instance ID pool, one per module-type | ||
| * @modres_mutex: For synchronizing any @mods_info updates | ||
| * @ppl_ida: Pipeline instance ID pool | ||
| * @fw_list: List of libraries loaded, including base firmware | ||
| */ | ||
| struct avs_dev { | ||
| struct hda_bus base; | ||
| struct device *dev; | ||
|
|
||
| void __iomem *dsp_ba; | ||
| const struct avs_spec *spec; | ||
| struct avs_ipc *ipc; | ||
|
|
||
| struct avs_fw_cfg fw_cfg; | ||
| struct avs_hw_cfg hw_cfg; | ||
| struct avs_mods_info *mods_info; | ||
| struct ida **mod_idas; | ||
| struct mutex modres_mutex; | ||
| struct ida ppl_ida; | ||
| struct list_head fw_list; | ||
| int *core_refs; /* reference count per core */ | ||
| char **lib_names; | ||
|
|
||
| struct completion fw_ready; | ||
| }; | ||
|
|
||
| /* from hda_bus to avs_dev */ | ||
| #define hda_to_avs(hda) container_of(hda, struct avs_dev, base) | ||
| /* from hdac_bus to avs_dev */ | ||
| #define hdac_to_avs(hdac) hda_to_avs(to_hda_bus(hdac)) | ||
| /* from device to avs_dev */ | ||
| #define to_avs_dev(dev) \ | ||
| ({ \ | ||
| struct hdac_bus *__bus = dev_get_drvdata(dev); \ | ||
| hdac_to_avs(__bus); \ | ||
| }) | ||
|
|
||
| int avs_dsp_core_power(struct avs_dev *adev, u32 core_mask, bool power); | ||
| int avs_dsp_core_reset(struct avs_dev *adev, u32 core_mask, bool reset); | ||
| int avs_dsp_core_stall(struct avs_dev *adev, u32 core_mask, bool stall); | ||
| int avs_dsp_core_enable(struct avs_dev *adev, u32 core_mask); | ||
| int avs_dsp_core_disable(struct avs_dev *adev, u32 core_mask); | ||
|
|
||
| /* Inter Process Communication */ | ||
|
|
||
| struct avs_ipc_msg { | ||
| union { | ||
| u64 header; | ||
| union avs_global_msg glb; | ||
| union avs_reply_msg rsp; | ||
| }; | ||
| void *data; | ||
| size_t size; | ||
| }; | ||
|
|
||
| /* | ||
| * struct avs_ipc - DSP IPC context | ||
| * | ||
| * @dev: PCI device | ||
| * @rx: Reply message cache | ||
| * @default_timeout_ms: default message timeout in MS | ||
| * @ready: whether firmware is ready and communication is open | ||
| * @rx_completed: whether RX for previously sent TX has been received | ||
| * @rx_lock: for serializing manipulation of rx_* fields | ||
| * @msg_lock: for synchronizing request handling | ||
| * @done_completion: DONE-part of IPC i.e. ROM and ACKs from FW | ||
| * @busy_completion: BUSY-part of IPC i.e. receiving responses from FW | ||
| */ | ||
| struct avs_ipc { | ||
| struct device *dev; | ||
|
|
||
| struct avs_ipc_msg rx; | ||
| u32 default_timeout_ms; | ||
| bool ready; | ||
|
|
||
| bool rx_completed; | ||
| spinlock_t rx_lock; | ||
| struct mutex msg_mutex; | ||
| struct completion done_completion; | ||
| struct completion busy_completion; | ||
| }; | ||
|
|
||
| #define AVS_EIPC EREMOTEIO | ||
| /* | ||
| * IPC handlers may return positive value (firmware error code) what denotes | ||
| * successful HOST <-> DSP communication yet failure to process specific request. | ||
| * | ||
| * Below macro converts returned value to linux kernel error code. | ||
| * All IPC callers MUST use it as soon as firmware error code is consumed. | ||
| */ | ||
| #define AVS_IPC_RET(ret) \ | ||
| (((ret) <= 0) ? (ret) : -AVS_EIPC) | ||
|
|
||
| static inline void avs_ipc_err(struct avs_dev *adev, struct avs_ipc_msg *tx, | ||
| const char *name, int error) | ||
| { | ||
| /* | ||
| * If IPC channel is blocked e.g.: due to ongoing recovery, | ||
| * -EPERM error code is expected and thus it's not an actual error. | ||
| */ | ||
| if (error == -EPERM) | ||
| dev_dbg(adev->dev, "%s 0x%08x 0x%08x failed: %d\n", name, | ||
| tx->glb.primary, tx->glb.ext.val, error); | ||
| else | ||
| dev_err(adev->dev, "%s 0x%08x 0x%08x failed: %d\n", name, | ||
| tx->glb.primary, tx->glb.ext.val, error); | ||
| } | ||
|
|
||
| irqreturn_t avs_dsp_irq_handler(int irq, void *dev_id); | ||
| irqreturn_t avs_dsp_irq_thread(int irq, void *dev_id); | ||
| void avs_dsp_process_response(struct avs_dev *adev, u64 header); | ||
| int avs_dsp_send_msg_timeout(struct avs_dev *adev, | ||
| struct avs_ipc_msg *request, | ||
| struct avs_ipc_msg *reply, int timeout); | ||
| int avs_dsp_send_msg(struct avs_dev *adev, | ||
| struct avs_ipc_msg *request, struct avs_ipc_msg *reply); | ||
| int avs_dsp_send_rom_msg_timeout(struct avs_dev *adev, | ||
| struct avs_ipc_msg *request, int timeout); | ||
| int avs_dsp_send_rom_msg(struct avs_dev *adev, struct avs_ipc_msg *request); | ||
| void avs_dsp_interrupt_control(struct avs_dev *adev, bool enable); | ||
| int avs_ipc_init(struct avs_ipc *ipc, struct device *dev); | ||
| void avs_ipc_block(struct avs_ipc *ipc); | ||
|
|
||
| /* Firmware resources management */ | ||
|
|
||
| int avs_get_module_entry(struct avs_dev *adev, const guid_t *uuid, struct avs_module_entry *entry); | ||
| int avs_get_module_id_entry(struct avs_dev *adev, u32 module_id, struct avs_module_entry *entry); | ||
| int avs_get_module_id(struct avs_dev *adev, const guid_t *uuid); | ||
| bool avs_is_module_ida_empty(struct avs_dev *adev, u32 module_id); | ||
|
|
||
| int avs_module_info_init(struct avs_dev *adev, bool purge); | ||
| void avs_module_info_free(struct avs_dev *adev); | ||
| int avs_module_id_alloc(struct avs_dev *adev, u16 module_id); | ||
| void avs_module_id_free(struct avs_dev *adev, u16 module_id, u8 instance_id); | ||
| int avs_request_firmware(struct avs_dev *adev, const struct firmware **fw_p, const char *name); | ||
| void avs_release_last_firmware(struct avs_dev *adev); | ||
| void avs_release_firmwares(struct avs_dev *adev); | ||
|
|
||
| int avs_dsp_init_module(struct avs_dev *adev, u16 module_id, u8 ppl_instance_id, | ||
| u8 core_id, u8 domain, void *param, u32 param_size, | ||
| u16 *instance_id); | ||
| void avs_dsp_delete_module(struct avs_dev *adev, u16 module_id, u16 instance_id, | ||
| u8 ppl_instance_id, u8 core_id); | ||
| int avs_dsp_create_pipeline(struct avs_dev *adev, u16 req_size, u8 priority, | ||
| bool lp, u16 attributes, u8 *instance_id); | ||
| int avs_dsp_delete_pipeline(struct avs_dev *adev, u8 instance_id); | ||
|
|
||
| /* Firmware loading */ | ||
|
|
||
| void avs_hda_clock_gating_enable(struct avs_dev *adev, bool enable); | ||
| void avs_hda_power_gating_enable(struct avs_dev *adev, bool enable); | ||
| void avs_hda_l1sen_enable(struct avs_dev *adev, bool enable); | ||
|
|
||
| int avs_dsp_boot_firmware(struct avs_dev *adev, bool purge); | ||
| int avs_dsp_first_boot_firmware(struct avs_dev *adev); | ||
|
|
||
| int avs_cldma_load_basefw(struct avs_dev *adev, struct firmware *fw); | ||
| int avs_cldma_load_library(struct avs_dev *adev, struct firmware *lib, u32 id); | ||
| int avs_cldma_transfer_modules(struct avs_dev *adev, bool load, | ||
| struct avs_module_entry *mods, u32 num_mods); | ||
| int avs_hda_load_basefw(struct avs_dev *adev, struct firmware *fw); | ||
| int avs_hda_load_library(struct avs_dev *adev, struct firmware *lib, u32 id); | ||
| int avs_hda_transfer_modules(struct avs_dev *adev, bool load, | ||
| struct avs_module_entry *mods, u32 num_mods); | ||
|
|
||
| #endif /* __SOUND_SOC_INTEL_AVS_H */ |
Oops, something went wrong.