root/sound/soc/sof/intel/hda.h
/* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */
/*
 * This file is provided under a dual BSD/GPLv2 license.  When using or
 * redistributing this file, you may do so under either license.
 *
 * Copyright(c) 2017 Intel Corporation
 *
 * Author: Liam Girdwood <liam.r.girdwood@linux.intel.com>
 */

#ifndef __SOF_INTEL_HDA_H
#define __SOF_INTEL_HDA_H

#include <linux/completion.h>
#include <linux/soundwire/sdw.h>
#include <linux/soundwire/sdw_intel.h>
#include <sound/compress_driver.h>
#include <sound/hda_codec.h>
#include <sound/hdaudio_ext.h>
#include "../sof-client-probes.h"
#include "../sof-audio.h"
#include "shim.h"

/* PCI registers */
#define PCI_TCSEL                       0x44
#define PCI_PGCTL                       PCI_TCSEL
#define PCI_CGCTL                       0x48

/* PCI_PGCTL bits */
#define PCI_PGCTL_ADSPPGD               BIT(2)
#define PCI_PGCTL_LSRMD_MASK            BIT(4)

/* PCI_CGCTL bits */
#define PCI_CGCTL_MISCBDCGE_MASK        BIT(6)
#define PCI_CGCTL_ADSPDCGE              BIT(1)

/* Legacy HDA registers and bits used - widths are variable */
#define SOF_HDA_GCAP                    0x0
#define SOF_HDA_GCTL                    0x8
/* accept unsol. response enable */
#define SOF_HDA_GCTL_UNSOL              BIT(8)
#define SOF_HDA_LLCH                    0x14
#define SOF_HDA_INTCTL                  0x20
#define SOF_HDA_INTSTS                  0x24
#define SOF_HDA_WAKESTS                 0x0E
#define SOF_HDA_WAKESTS_INT_MASK        ((1 << 8) - 1)
#define SOF_HDA_RIRBSTS                 0x5d

/* SOF_HDA_GCTL register bist */
#define SOF_HDA_GCTL_RESET              BIT(0)

/* SOF_HDA_INCTL regs */
#define SOF_HDA_INT_GLOBAL_EN           BIT(31)
#define SOF_HDA_INT_CTRL_EN             BIT(30)
#define SOF_HDA_INT_ALL_STREAM          0xff

/* SOF_HDA_INTSTS regs */
#define SOF_HDA_INTSTS_GIS              BIT(31)

#define SOF_HDA_MAX_CAPS                10
#define SOF_HDA_CAP_ID_OFF              16
#define SOF_HDA_CAP_ID_MASK             GENMASK(SOF_HDA_CAP_ID_OFF + 11,\
                                                SOF_HDA_CAP_ID_OFF)
#define SOF_HDA_CAP_NEXT_MASK           0xFFFF

#define SOF_HDA_GTS_CAP_ID                      0x1
#define SOF_HDA_ML_CAP_ID                       0x2

#define SOF_HDA_PP_CAP_ID               0x3
#define SOF_HDA_REG_PP_PPCH             0x10
#define SOF_HDA_REG_PP_PPCTL            0x04
#define SOF_HDA_REG_PP_PPSTS            0x08
#define SOF_HDA_PPCTL_PIE               BIT(31)
#define SOF_HDA_PPCTL_GPROCEN           BIT(30)

/*Vendor Specific Registers*/
#define SOF_HDA_VS_D0I3C                0x104A

/* D0I3C Register fields */
#define SOF_HDA_VS_D0I3C_CIP            BIT(0) /* Command-In-Progress */
#define SOF_HDA_VS_D0I3C_I3             BIT(2) /* D0i3 enable bit */

/* DPIB entry size: 8 Bytes = 2 DWords */
#define SOF_HDA_DPIB_ENTRY_SIZE 0x8

#define SOF_HDA_SPIB_CAP_ID             0x4
#define SOF_HDA_DRSM_CAP_ID             0x5

#define SOF_HDA_SPIB_BASE               0x08
#define SOF_HDA_SPIB_INTERVAL           0x08
#define SOF_HDA_SPIB_SPIB               0x00
#define SOF_HDA_SPIB_MAXFIFO            0x04

#define SOF_HDA_PPHC_BASE               0x10
#define SOF_HDA_PPHC_INTERVAL           0x10

#define SOF_HDA_PPLC_BASE               0x10
#define SOF_HDA_PPLC_MULTI              0x10
#define SOF_HDA_PPLC_INTERVAL           0x10

#define SOF_HDA_DRSM_BASE               0x08
#define SOF_HDA_DRSM_INTERVAL           0x08

/* Descriptor error interrupt */
#define SOF_HDA_CL_DMA_SD_INT_DESC_ERR          0x10

/* FIFO error interrupt */
#define SOF_HDA_CL_DMA_SD_INT_FIFO_ERR          0x08

/* Buffer completion interrupt */
#define SOF_HDA_CL_DMA_SD_INT_COMPLETE          0x04

#define SOF_HDA_CL_DMA_SD_INT_MASK \
        (SOF_HDA_CL_DMA_SD_INT_DESC_ERR | \
        SOF_HDA_CL_DMA_SD_INT_FIFO_ERR | \
        SOF_HDA_CL_DMA_SD_INT_COMPLETE)
#define SOF_HDA_SD_CTL_DMA_START                0x02 /* Stream DMA start bit */

/* Intel HD Audio Code Loader DMA Registers */
#define SOF_HDA_ADSP_LOADER_BASE                0x80
#define SOF_HDA_ADSP_DPLBASE                    0x70
#define SOF_HDA_ADSP_DPUBASE                    0x74
#define SOF_HDA_ADSP_DPLBASE_ENABLE             0x01

/* Stream Registers */
#define SOF_HDA_ADSP_REG_SD_CTL                 0x00
#define SOF_HDA_ADSP_REG_SD_STS                 0x03
#define SOF_HDA_ADSP_REG_SD_LPIB                0x04
#define SOF_HDA_ADSP_REG_SD_CBL                 0x08
#define SOF_HDA_ADSP_REG_SD_LVI                 0x0C
#define SOF_HDA_ADSP_REG_SD_FIFOW               0x0E
#define SOF_HDA_ADSP_REG_SD_FIFOSIZE            0x10
#define SOF_HDA_ADSP_REG_SD_FORMAT              0x12
#define SOF_HDA_ADSP_REG_SD_FIFOL               0x14
#define SOF_HDA_ADSP_REG_SD_BDLPL               0x18
#define SOF_HDA_ADSP_REG_SD_BDLPU               0x1C
#define SOF_HDA_ADSP_SD_ENTRY_SIZE              0x20

/* SDxFIFOS FIFOS */
#define SOF_HDA_SD_FIFOSIZE_FIFOS_MASK          GENMASK(15, 0)

/* CL: Software Position Based FIFO Capability Registers */
#define SOF_DSP_REG_CL_SPBFIFO \
        (SOF_HDA_ADSP_LOADER_BASE + 0x20)
#define SOF_HDA_ADSP_REG_CL_SPBFIFO_SPBFCH      0x0
#define SOF_HDA_ADSP_REG_CL_SPBFIFO_SPBFCCTL    0x4
#define SOF_HDA_ADSP_REG_CL_SPBFIFO_SPIB        0x8
#define SOF_HDA_ADSP_REG_CL_SPBFIFO_MAXFIFOS    0xc

/* Stream Number */
#define SOF_HDA_CL_SD_CTL_STREAM_TAG_SHIFT      20
#define SOF_HDA_CL_SD_CTL_STREAM_TAG_MASK \
        GENMASK(SOF_HDA_CL_SD_CTL_STREAM_TAG_SHIFT + 3,\
                SOF_HDA_CL_SD_CTL_STREAM_TAG_SHIFT)

#define HDA_DSP_HDA_BAR                         0
#define HDA_DSP_PP_BAR                          1
#define HDA_DSP_SPIB_BAR                        2
#define HDA_DSP_DRSM_BAR                        3
#define HDA_DSP_BAR                             4

#define SRAM_WINDOW_OFFSET(x)                   (0x80000 + (x) * 0x20000)

#define HDA_DSP_MBOX_OFFSET                     SRAM_WINDOW_OFFSET(0)

#define HDA_DSP_PANIC_OFFSET(x) \
        (((x) & 0xFFFFFF) + HDA_DSP_MBOX_OFFSET)

/* SRAM window 0 FW "registers" */
#define HDA_DSP_SRAM_REG_ROM_STATUS             (HDA_DSP_MBOX_OFFSET + 0x0)
#define HDA_DSP_SRAM_REG_ROM_ERROR              (HDA_DSP_MBOX_OFFSET + 0x4)
/* FW and ROM share offset 4 */
#define HDA_DSP_SRAM_REG_FW_STATUS              (HDA_DSP_MBOX_OFFSET + 0x4)
#define HDA_DSP_SRAM_REG_FW_TRACEP              (HDA_DSP_MBOX_OFFSET + 0x8)
#define HDA_DSP_SRAM_REG_FW_END                 (HDA_DSP_MBOX_OFFSET + 0xc)

#define HDA_DSP_MBOX_UPLINK_OFFSET              0x81000

#define HDA_DSP_STREAM_RESET_TIMEOUT            300
/*
 * Timeout in us, for setting the stream RUN bit, during
 * start/stop the stream. The timeout expires if new RUN bit
 * value cannot be read back within the specified time.
 */
#define HDA_DSP_STREAM_RUN_TIMEOUT              300

#define HDA_DSP_SPIB_ENABLE                     1
#define HDA_DSP_SPIB_DISABLE                    0

#define SOF_HDA_MAX_BUFFER_SIZE                 (32 * PAGE_SIZE)

#define HDA_DSP_STACK_DUMP_SIZE                 32

/* ROM/FW status register */
#define FSR_STATE_MASK                          GENMASK(23, 0)
#define FSR_WAIT_STATE_MASK                     GENMASK(27, 24)
#define FSR_MODULE_MASK                         GENMASK(30, 28)
#define FSR_HALTED                              BIT(31)
#define FSR_TO_STATE_CODE(x)                    ((x) & FSR_STATE_MASK)
#define FSR_TO_WAIT_STATE_CODE(x)               (((x) & FSR_WAIT_STATE_MASK) >> 24)
#define FSR_TO_MODULE_CODE(x)                   (((x) & FSR_MODULE_MASK) >> 28)

/* Wait states */
#define FSR_WAIT_FOR_IPC_BUSY                   0x1
#define FSR_WAIT_FOR_IPC_DONE                   0x2
#define FSR_WAIT_FOR_CACHE_INVALIDATION         0x3
#define FSR_WAIT_FOR_LP_SRAM_OFF                0x4
#define FSR_WAIT_FOR_DMA_BUFFER_FULL            0x5
#define FSR_WAIT_FOR_CSE_CSR                    0x6

/* Module codes */
#define FSR_MOD_ROM                             0x0
#define FSR_MOD_ROM_BYP                         0x1
#define FSR_MOD_BASE_FW                         0x2
#define FSR_MOD_LP_BOOT                         0x3
#define FSR_MOD_BRNGUP                          0x4
#define FSR_MOD_ROM_EXT                         0x5

/* State codes (module dependent) */
/* Module independent states */
#define FSR_STATE_INIT                          0x0
#define FSR_STATE_INIT_DONE                     0x1
#define FSR_STATE_FW_ENTERED                    0x5

/* ROM states */
#define FSR_STATE_ROM_INIT                      FSR_STATE_INIT
#define FSR_STATE_ROM_INIT_DONE                 FSR_STATE_INIT_DONE
#define FSR_STATE_ROM_CSE_MANIFEST_LOADED       0x2
#define FSR_STATE_ROM_FW_MANIFEST_LOADED        0x3
#define FSR_STATE_ROM_FW_FW_LOADED              0x4
#define FSR_STATE_ROM_FW_ENTERED                FSR_STATE_FW_ENTERED
#define FSR_STATE_ROM_VERIFY_FEATURE_MASK       0x6
#define FSR_STATE_ROM_GET_LOAD_OFFSET           0x7
#define FSR_STATE_ROM_FETCH_ROM_EXT             0x8
#define FSR_STATE_ROM_FETCH_ROM_EXT_DONE        0x9
#define FSR_STATE_ROM_BASEFW_ENTERED            0xf /* SKL */

/* (ROM) CSE states */
#define FSR_STATE_ROM_CSE_IMR_REQUEST                   0x10
#define FSR_STATE_ROM_CSE_IMR_GRANTED                   0x11
#define FSR_STATE_ROM_CSE_VALIDATE_IMAGE_REQUEST        0x12
#define FSR_STATE_ROM_CSE_IMAGE_VALIDATED               0x13

#define FSR_STATE_ROM_CSE_IPC_IFACE_INIT        0x20
#define FSR_STATE_ROM_CSE_IPC_RESET_PHASE_1     0x21
#define FSR_STATE_ROM_CSE_IPC_OPERATIONAL_ENTRY 0x22
#define FSR_STATE_ROM_CSE_IPC_OPERATIONAL       0x23
#define FSR_STATE_ROM_CSE_IPC_DOWN              0x24

/* BRINGUP (or BRNGUP) states */
#define FSR_STATE_BRINGUP_INIT                  FSR_STATE_INIT
#define FSR_STATE_BRINGUP_INIT_DONE             FSR_STATE_INIT_DONE
#define FSR_STATE_BRINGUP_HPSRAM_LOAD           0x2
#define FSR_STATE_BRINGUP_UNPACK_START          0X3
#define FSR_STATE_BRINGUP_IMR_RESTORE           0x4
#define FSR_STATE_BRINGUP_FW_ENTERED            FSR_STATE_FW_ENTERED

/* ROM  status/error values */
#define HDA_DSP_ROM_CSE_ERROR                   40
#define HDA_DSP_ROM_CSE_WRONG_RESPONSE          41
#define HDA_DSP_ROM_IMR_TO_SMALL                42
#define HDA_DSP_ROM_BASE_FW_NOT_FOUND           43
#define HDA_DSP_ROM_CSE_VALIDATION_FAILED       44
#define HDA_DSP_ROM_IPC_FATAL_ERROR             45
#define HDA_DSP_ROM_L2_CACHE_ERROR              46
#define HDA_DSP_ROM_LOAD_OFFSET_TO_SMALL        47
#define HDA_DSP_ROM_API_PTR_INVALID             50
#define HDA_DSP_ROM_BASEFW_INCOMPAT             51
#define HDA_DSP_ROM_UNHANDLED_INTERRUPT         0xBEE00000
#define HDA_DSP_ROM_MEMORY_HOLE_ECC             0xECC00000
#define HDA_DSP_ROM_KERNEL_EXCEPTION            0xCAFE0000
#define HDA_DSP_ROM_USER_EXCEPTION              0xBEEF0000
#define HDA_DSP_ROM_UNEXPECTED_RESET            0xDECAF000
#define HDA_DSP_ROM_NULL_FW_ENTRY               0x4c4c4e55

#define HDA_DSP_ROM_IPC_CONTROL                 0x01000000
#define HDA_DSP_ROM_IPC_PURGE_FW                0x00004000

/* various timeout values */
#define HDA_DSP_PU_TIMEOUT              50
#define HDA_DSP_PD_TIMEOUT              50
#define HDA_DSP_RESET_TIMEOUT_US        50000
#define HDA_DSP_BASEFW_TIMEOUT_US       3000000
#define HDA_DSP_INIT_TIMEOUT_US 500000
#define HDA_DSP_CTRL_RESET_TIMEOUT              100
#define HDA_DSP_WAIT_TIMEOUT            500     /* 500 msec */
#define HDA_DSP_REG_POLL_INTERVAL_US            500     /* 0.5 msec */
#define HDA_DSP_REG_POLL_RETRY_COUNT            50

#define HDA_DSP_ADSPIC_IPC                      BIT(0)
#define HDA_DSP_ADSPIS_IPC                      BIT(0)

/* Intel HD Audio General DSP Registers */
#define HDA_DSP_GEN_BASE                0x0
#define HDA_DSP_REG_ADSPCS              (HDA_DSP_GEN_BASE + 0x04)
#define HDA_DSP_REG_ADSPIC              (HDA_DSP_GEN_BASE + 0x08)
#define HDA_DSP_REG_ADSPIS              (HDA_DSP_GEN_BASE + 0x0C)
#define HDA_DSP_REG_ADSPIC2             (HDA_DSP_GEN_BASE + 0x10)
#define HDA_DSP_REG_ADSPIS2             (HDA_DSP_GEN_BASE + 0x14)

#define HDA_DSP_REG_ADSPIC2_SNDW        BIT(5)
#define HDA_DSP_REG_ADSPIS2_SNDW        BIT(5)

/* Intel HD Audio Inter-Processor Communication Registers */
#define HDA_DSP_IPC_BASE                0x40
#define HDA_DSP_REG_HIPCT               (HDA_DSP_IPC_BASE + 0x00)
#define HDA_DSP_REG_HIPCTE              (HDA_DSP_IPC_BASE + 0x04)
#define HDA_DSP_REG_HIPCI               (HDA_DSP_IPC_BASE + 0x08)
#define HDA_DSP_REG_HIPCIE              (HDA_DSP_IPC_BASE + 0x0C)
#define HDA_DSP_REG_HIPCCTL             (HDA_DSP_IPC_BASE + 0x10)

/* Intel Vendor Specific Registers */
#define HDA_VS_INTEL_EM2                0x1030
#define HDA_VS_INTEL_EM2_L1SEN          BIT(13)
#define HDA_VS_INTEL_LTRP               0x1048
#define HDA_VS_INTEL_LTRP_GB_MASK       0x3F

/*  HIPCI */
#define HDA_DSP_REG_HIPCI_BUSY          BIT(31)
#define HDA_DSP_REG_HIPCI_MSG_MASK      0x7FFFFFFF

/* HIPCIE */
#define HDA_DSP_REG_HIPCIE_DONE BIT(30)
#define HDA_DSP_REG_HIPCIE_MSG_MASK     0x3FFFFFFF

/* HIPCCTL */
#define HDA_DSP_REG_HIPCCTL_DONE        BIT(1)
#define HDA_DSP_REG_HIPCCTL_BUSY        BIT(0)

/* HIPCT */
#define HDA_DSP_REG_HIPCT_BUSY          BIT(31)
#define HDA_DSP_REG_HIPCT_MSG_MASK      0x7FFFFFFF

/* HIPCTE */
#define HDA_DSP_REG_HIPCTE_MSG_MASK     0x3FFFFFFF

#define HDA_DSP_ADSPIC_CL_DMA           BIT(1)
#define HDA_DSP_ADSPIS_CL_DMA           BIT(1)

/* Delay before scheduling D0i3 entry */
#define BXT_D0I3_DELAY 5000

#define FW_CL_STREAM_NUMBER             0x1
#define HDA_FW_BOOT_ATTEMPTS            3

/* ADSPCS - Audio DSP Control & Status */

/*
 * Core Reset - asserted high
 * CRST Mask for a given core mask pattern, cm
 */
#define HDA_DSP_ADSPCS_CRST_SHIFT       0
#define HDA_DSP_ADSPCS_CRST_MASK(cm)    ((cm) << HDA_DSP_ADSPCS_CRST_SHIFT)

/*
 * Core run/stall - when set to '1' core is stalled
 * CSTALL Mask for a given core mask pattern, cm
 */
#define HDA_DSP_ADSPCS_CSTALL_SHIFT     8
#define HDA_DSP_ADSPCS_CSTALL_MASK(cm)  ((cm) << HDA_DSP_ADSPCS_CSTALL_SHIFT)

/*
 * Set Power Active - when set to '1' turn cores on
 * SPA Mask for a given core mask pattern, cm
 */
#define HDA_DSP_ADSPCS_SPA_SHIFT        16
#define HDA_DSP_ADSPCS_SPA_MASK(cm)     ((cm) << HDA_DSP_ADSPCS_SPA_SHIFT)

/*
 * Current Power Active - power status of cores, set by hardware
 * CPA Mask for a given core mask pattern, cm
 */
#define HDA_DSP_ADSPCS_CPA_SHIFT        24
#define HDA_DSP_ADSPCS_CPA_MASK(cm)     ((cm) << HDA_DSP_ADSPCS_CPA_SHIFT)

/*
 * Mask for a given number of cores
 * nc = number of supported cores
 */
#define SOF_DSP_CORES_MASK(nc)  GENMASK(((nc) - 1), 0)

/* Intel HD Audio Inter-Processor Communication Registers for Cannonlake*/
#define CNL_DSP_IPC_BASE                0xc0
#define CNL_DSP_REG_HIPCTDR             (CNL_DSP_IPC_BASE + 0x00)
#define CNL_DSP_REG_HIPCTDA             (CNL_DSP_IPC_BASE + 0x04)
#define CNL_DSP_REG_HIPCTDD             (CNL_DSP_IPC_BASE + 0x08)
#define CNL_DSP_REG_HIPCIDR             (CNL_DSP_IPC_BASE + 0x10)
#define CNL_DSP_REG_HIPCIDA             (CNL_DSP_IPC_BASE + 0x14)
#define CNL_DSP_REG_HIPCIDD             (CNL_DSP_IPC_BASE + 0x18)
#define CNL_DSP_REG_HIPCCTL             (CNL_DSP_IPC_BASE + 0x28)

/*  HIPCI */
#define CNL_DSP_REG_HIPCIDR_BUSY                BIT(31)
#define CNL_DSP_REG_HIPCIDR_MSG_MASK    0x7FFFFFFF

/* HIPCIE */
#define CNL_DSP_REG_HIPCIDA_DONE        BIT(31)
#define CNL_DSP_REG_HIPCIDA_MSG_MASK    0x7FFFFFFF

/* HIPCCTL */
#define CNL_DSP_REG_HIPCCTL_DONE        BIT(1)
#define CNL_DSP_REG_HIPCCTL_BUSY        BIT(0)

/* HIPCT */
#define CNL_DSP_REG_HIPCTDR_BUSY                BIT(31)
#define CNL_DSP_REG_HIPCTDR_MSG_MASK    0x7FFFFFFF

/* HIPCTDA */
#define CNL_DSP_REG_HIPCTDA_DONE        BIT(31)
#define CNL_DSP_REG_HIPCTDA_MSG_MASK    0x7FFFFFFF

/* HIPCTDD */
#define CNL_DSP_REG_HIPCTDD_MSG_MASK    0x7FFFFFFF

/* BDL */
#define HDA_DSP_BDL_SIZE                        4096
#define HDA_DSP_MAX_BDL_ENTRIES                 \
        (HDA_DSP_BDL_SIZE / sizeof(struct sof_intel_dsp_bdl))

/* Number of DAIs */
#define SOF_SKL_NUM_DAIS_NOCODEC        9

#if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA_AUDIO_CODEC)
#define SOF_SKL_NUM_DAIS                16
#else
#define SOF_SKL_NUM_DAIS                SOF_SKL_NUM_DAIS_NOCODEC
#endif

/* Intel HD Audio SRAM Window 0*/
#define HDA_DSP_SRAM_REG_ROM_STATUS_SKL 0x8000
#define HDA_ADSP_SRAM0_BASE_SKL         0x8000

/* Firmware status window */
#define HDA_ADSP_FW_STATUS_SKL          HDA_ADSP_SRAM0_BASE_SKL
#define HDA_ADSP_ERROR_CODE_SKL         (HDA_ADSP_FW_STATUS_SKL + 0x4)

/* Host Device Memory Space */
#define APL_SSP_BASE_OFFSET     0x2000
#define CNL_SSP_BASE_OFFSET     0x10000

/* Host Device Memory Size of a Single SSP */
#define SSP_DEV_MEM_SIZE        0x1000

/* SSP Count of the Platform */
#define APL_SSP_COUNT           6
#define CNL_SSP_COUNT           3
#define ICL_SSP_COUNT           6
#define TGL_SSP_COUNT           3
#define MTL_SSP_COUNT           3

/* SSP Registers */
#define SSP_SSC1_OFFSET         0x4
#define SSP_SET_SCLK_CONSUMER   BIT(25)
#define SSP_SET_SFRM_CONSUMER   BIT(24)
#define SSP_SET_CBP_CFP         (SSP_SET_SCLK_CONSUMER | SSP_SET_SFRM_CONSUMER)

#define HDA_EXT_ADDR            0
#define HDA_EXT_CODEC(x) ((x) & BIT(HDA_EXT_ADDR))
#define HDA_IDISP_ADDR          2
#define HDA_IDISP_CODEC(x) ((x) & BIT(HDA_IDISP_ADDR))

struct sof_intel_dsp_bdl {
        __le32 addr_l;
        __le32 addr_h;
        __le32 size;
        __le32 ioc;
} __attribute((packed));

#define SOF_HDA_PLAYBACK_STREAMS        16
#define SOF_HDA_CAPTURE_STREAMS         16
#define SOF_HDA_PLAYBACK                0
#define SOF_HDA_CAPTURE                 1

/* stream flags */
#define SOF_HDA_STREAM_DMI_L1_COMPATIBLE        1

/*
 * Time in ms for opportunistic D0I3 entry delay.
 * This has been deliberately chosen to be long to avoid race conditions.
 * Could be optimized in future.
 */
#define SOF_HDA_D0I3_WORK_DELAY_MS      5000

/* HDA DSP D0 substate */
enum sof_hda_D0_substate {
        SOF_HDA_DSP_PM_D0I0,    /* default D0 substate */
        SOF_HDA_DSP_PM_D0I3,    /* low power D0 substate */
};

struct sof_ace3_mic_privacy {
        bool active;
        struct work_struct work;
};

/* represents DSP HDA controller frontend - i.e. host facing control */
struct sof_intel_hda_dev {
        bool imrboot_supported;
        bool skip_imr_boot;
        bool booted_from_imr;

        int boot_iteration;

        /*
         * DMA buffers for base firmware download. By default the buffers are
         * allocated once and kept through the lifetime of the driver.
         * See module parameter: persistent_cl_buffer
         */
        struct snd_dma_buffer cl_dmab;
        bool cl_dmab_contains_basefw;
        struct snd_dma_buffer iccmax_dmab;

        struct hda_bus hbus;

        /* hw config */
        const struct sof_intel_dsp_desc *desc;

        /* trace */
        struct hdac_ext_stream *dtrace_stream;

        /* if position update IPC needed */
        u32 no_ipc_position;

        /* the maximum number of streams (playback + capture) supported */
        u32 stream_max;

        /* PM related */
        bool l1_disabled;/* is DMI link L1 disabled? */

        /* DMIC device */
        struct platform_device *dmic_dev;

        /* delayed work to enter D0I3 opportunistically */
        struct delayed_work d0i3_work;

        /* ACPI information stored between scan and probe steps */
        struct sdw_intel_acpi_info info;

        /* sdw context allocated by SoundWire driver */
        struct sdw_intel_ctx *sdw;

        /* FW clock config, 0:HPRO, 1:LPRO */
        bool clk_config_lpro;

        wait_queue_head_t waitq;
        bool code_loading;

        /* Intel NHLT information */
        struct nhlt_acpi_table *nhlt;

        /* work queue for mic privacy state change notification sending */
        struct sof_ace3_mic_privacy mic_privacy;

        /*
         * Pointing to the IPC message if immediate sending was not possible
         * because the downlink communication channel was BUSY at the time.
         * The message will be re-tried when the channel becomes free (the ACK
         * is received from the DSP for the previous message)
         */
        struct snd_sof_ipc_msg *delayed_ipc_tx_msg;
};

static inline struct hdac_bus *sof_to_bus(struct snd_sof_dev *s)
{
        struct sof_intel_hda_dev *hda = s->pdata->hw_pdata;

        return &hda->hbus.core;
}

static inline struct hda_bus *sof_to_hbus(struct snd_sof_dev *s)
{
        struct sof_intel_hda_dev *hda = s->pdata->hw_pdata;

        return &hda->hbus;
}

struct sof_intel_hda_stream {
        struct snd_sof_dev *sdev;
        struct hdac_ext_stream hext_stream;
        struct sof_intel_stream sof_intel_stream;
        int host_reserved; /* reserve host DMA channel */
        u32 flags;
        struct completion ioc;
};

#define hstream_to_sof_hda_stream(hstream) \
        container_of(hstream, struct sof_intel_hda_stream, hext_stream)

#define bus_to_sof_hda(bus) \
        container_of(bus, struct sof_intel_hda_dev, hbus.core)

#define SOF_STREAM_SD_OFFSET(s) \
        (SOF_HDA_ADSP_SD_ENTRY_SIZE * ((s)->index) \
         + SOF_HDA_ADSP_LOADER_BASE)

#define SOF_STREAM_SD_OFFSET_CRST 0x1

/*
 * DAI support
 */
bool hda_is_chain_dma_supported(struct snd_sof_dev *sdev, u32 dai_type);

/*
 * DSP Core services.
 */
int hda_dsp_probe_early(struct snd_sof_dev *sdev);
int hda_dsp_probe(struct snd_sof_dev *sdev);
void hda_dsp_remove(struct snd_sof_dev *sdev);
void hda_dsp_remove_late(struct snd_sof_dev *sdev);
int hda_dsp_core_power_up(struct snd_sof_dev *sdev, unsigned int core_mask);
int hda_dsp_core_run(struct snd_sof_dev *sdev, unsigned int core_mask);
int hda_dsp_enable_core(struct snd_sof_dev *sdev, unsigned int core_mask);
int hda_dsp_core_reset_power_down(struct snd_sof_dev *sdev,
                                  unsigned int core_mask);
int hda_power_down_dsp(struct snd_sof_dev *sdev);
int hda_dsp_core_get(struct snd_sof_dev *sdev, int core);
void hda_dsp_ipc_int_enable(struct snd_sof_dev *sdev);
void hda_dsp_ipc_int_disable(struct snd_sof_dev *sdev);
bool hda_dsp_core_is_enabled(struct snd_sof_dev *sdev, unsigned int core_mask);

int hda_dsp_set_power_state_ipc3(struct snd_sof_dev *sdev,
                                 const struct sof_dsp_power_state *target_state);
int hda_dsp_set_power_state_ipc4(struct snd_sof_dev *sdev,
                                 const struct sof_dsp_power_state *target_state);

int hda_dsp_suspend(struct snd_sof_dev *sdev, u32 target_state);
int hda_dsp_resume(struct snd_sof_dev *sdev);
int hda_dsp_runtime_suspend(struct snd_sof_dev *sdev);
int hda_dsp_runtime_resume(struct snd_sof_dev *sdev);
int hda_dsp_runtime_idle(struct snd_sof_dev *sdev);
int hda_dsp_shutdown_dma_flush(struct snd_sof_dev *sdev);
int hda_dsp_shutdown(struct snd_sof_dev *sdev);
int hda_dsp_set_hw_params_upon_resume(struct snd_sof_dev *sdev);
void hda_dsp_dump(struct snd_sof_dev *sdev, u32 flags);
void hda_ipc4_dsp_dump(struct snd_sof_dev *sdev, u32 flags);
void hda_ipc_dump(struct snd_sof_dev *sdev);
void hda_ipc_irq_dump(struct snd_sof_dev *sdev);
void hda_dsp_d0i3_work(struct work_struct *work);
int hda_dsp_disable_interrupts(struct snd_sof_dev *sdev);
bool hda_check_ipc_irq(struct snd_sof_dev *sdev);
u32 hda_get_interface_mask(struct snd_sof_dev *sdev);

/*
 * DSP PCM Operations.
 */
u32 hda_dsp_get_mult_div(struct snd_sof_dev *sdev, int rate);
u32 hda_dsp_get_bits(struct snd_sof_dev *sdev, int sample_bits);
int hda_dsp_pcm_open(struct snd_sof_dev *sdev,
                     struct snd_pcm_substream *substream);
int hda_dsp_pcm_close(struct snd_sof_dev *sdev,
                      struct snd_pcm_substream *substream);
int hda_dsp_pcm_hw_params(struct snd_sof_dev *sdev,
                          struct snd_pcm_substream *substream,
                          struct snd_pcm_hw_params *params,
                          struct snd_sof_platform_stream_params *platform_params);
int hda_dsp_stream_hw_free(struct snd_sof_dev *sdev,
                           struct snd_pcm_substream *substream);
int hda_dsp_pcm_trigger(struct snd_sof_dev *sdev,
                        struct snd_pcm_substream *substream, int cmd);
snd_pcm_uframes_t hda_dsp_pcm_pointer(struct snd_sof_dev *sdev,
                                      struct snd_pcm_substream *substream);
int hda_dsp_pcm_ack(struct snd_sof_dev *sdev, struct snd_pcm_substream *substream);

/*
 * DSP Stream Operations.
 */

int hda_dsp_stream_init(struct snd_sof_dev *sdev);
void hda_dsp_stream_free(struct snd_sof_dev *sdev);
int hda_dsp_stream_hw_params(struct snd_sof_dev *sdev,
                             struct hdac_ext_stream *hext_stream,
                             struct snd_dma_buffer *dmab,
                             struct snd_pcm_hw_params *params);
int hda_dsp_iccmax_stream_hw_params(struct snd_sof_dev *sdev,
                                    struct hdac_ext_stream *hext_stream,
                                    struct snd_dma_buffer *dmab,
                                    struct snd_pcm_hw_params *params);
int hda_dsp_stream_trigger(struct snd_sof_dev *sdev,
                           struct hdac_ext_stream *hext_stream, int cmd);
irqreturn_t hda_dsp_stream_threaded_handler(int irq, void *context);
int hda_dsp_stream_setup_bdl(struct snd_sof_dev *sdev,
                             struct snd_dma_buffer *dmab,
                             struct hdac_stream *hstream);
bool hda_dsp_check_ipc_irq(struct snd_sof_dev *sdev);
bool hda_dsp_check_stream_irq(struct snd_sof_dev *sdev);

snd_pcm_uframes_t hda_dsp_stream_get_position(struct hdac_stream *hstream,
                                              int direction, bool can_sleep);
u64 hda_dsp_get_stream_llp(struct snd_sof_dev *sdev,
                           struct snd_soc_component *component,
                           struct snd_pcm_substream *substream);
u64 hda_dsp_get_stream_ldp(struct snd_sof_dev *sdev,
                           struct snd_soc_component *component,
                           struct snd_pcm_substream *substream);

struct hdac_ext_stream *
        hda_dsp_stream_get(struct snd_sof_dev *sdev, int direction, u32 flags);
struct hdac_ext_stream *
        hda_dsp_stream_pair_get(struct snd_sof_dev *sdev, int direction, u32 flags);
int hda_dsp_stream_put(struct snd_sof_dev *sdev, int direction, int stream_tag);
int hda_dsp_stream_pair_put(struct snd_sof_dev *sdev, int direction, int stream_tag);
int hda_dsp_stream_spib_config(struct snd_sof_dev *sdev,
                               struct hdac_ext_stream *hext_stream,
                               int enable, u32 size);

int hda_ipc_msg_data(struct snd_sof_dev *sdev,
                     struct snd_sof_pcm_stream *sps,
                     void *p, size_t sz);
int hda_set_stream_data_offset(struct snd_sof_dev *sdev,
                               struct snd_sof_pcm_stream *sps,
                               size_t posn_offset);

/*
 * DSP IPC Operations.
 */
int hda_dsp_ipc_send_msg(struct snd_sof_dev *sdev,
                         struct snd_sof_ipc_msg *msg);
void hda_dsp_ipc_get_reply(struct snd_sof_dev *sdev);
int hda_dsp_ipc_get_mailbox_offset(struct snd_sof_dev *sdev);
int hda_dsp_ipc_get_window_offset(struct snd_sof_dev *sdev, u32 id);

irqreturn_t hda_dsp_ipc_irq_thread(int irq, void *context);
int hda_dsp_ipc_cmd_done(struct snd_sof_dev *sdev, int dir);

void hda_dsp_get_state(struct snd_sof_dev *sdev, const char *level);
void hda_dsp_dump_ext_rom_status(struct snd_sof_dev *sdev, const char *level,
                                 u32 flags);

/*
 * DSP Code loader.
 */
int hda_dsp_cl_boot_firmware(struct snd_sof_dev *sdev);
int hda_dsp_cl_boot_firmware_iccmax(struct snd_sof_dev *sdev);
int hda_cl_copy_fw(struct snd_sof_dev *sdev, struct hdac_ext_stream *hext_stream);

struct hdac_ext_stream *hda_cl_prepare(struct device *dev, unsigned int format,
                                       unsigned int size, struct snd_dma_buffer *dmab,
                                       bool persistent_buffer, int direction,
                                       bool is_iccmax);
int hda_cl_trigger(struct device *dev, struct hdac_ext_stream *hext_stream, int cmd);

int hda_cl_cleanup(struct device *dev, struct snd_dma_buffer *dmab,
                   bool persistent_buffer, struct hdac_ext_stream *hext_stream);
int cl_dsp_init(struct snd_sof_dev *sdev, int stream_tag, bool imr_boot);
#define HDA_CL_STREAM_FORMAT 0x40

/* pre and post fw run ops */
int hda_dsp_pre_fw_run(struct snd_sof_dev *sdev);
int hda_dsp_post_fw_run(struct snd_sof_dev *sdev);

/* parse platform specific ext manifest ops */
int hda_dsp_ext_man_get_cavs_config_data(struct snd_sof_dev *sdev,
                                         const struct sof_ext_man_elem_header *hdr);

/*
 * HDA Controller Operations.
 */
int hda_dsp_ctrl_get_caps(struct snd_sof_dev *sdev);
void hda_dsp_ctrl_ppcap_enable(struct snd_sof_dev *sdev, bool enable);
void hda_dsp_ctrl_ppcap_int_enable(struct snd_sof_dev *sdev, bool enable);
int hda_dsp_ctrl_link_reset(struct snd_sof_dev *sdev, bool reset);
void hda_dsp_ctrl_misc_clock_gating(struct snd_sof_dev *sdev, bool enable);
int hda_dsp_ctrl_clock_power_gating(struct snd_sof_dev *sdev, bool enable);
int hda_dsp_ctrl_init_chip(struct snd_sof_dev *sdev, bool detect_codec);
void hda_dsp_ctrl_stop_chip(struct snd_sof_dev *sdev);
/*
 * HDA bus operations.
 */
void sof_hda_bus_init(struct snd_sof_dev *sdev, struct device *dev);
void sof_hda_bus_exit(struct snd_sof_dev *sdev);

#if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA_AUDIO_CODEC)
/*
 * HDA Codec operations.
 */
void hda_codec_probe_bus(struct snd_sof_dev *sdev);
void hda_codec_jack_wake_enable(struct snd_sof_dev *sdev, bool enable);
void hda_codec_jack_check(struct snd_sof_dev *sdev);
void hda_codec_check_for_state_change(struct snd_sof_dev *sdev);
void hda_codec_init_cmd_io(struct snd_sof_dev *sdev);
void hda_codec_resume_cmd_io(struct snd_sof_dev *sdev);
void hda_codec_stop_cmd_io(struct snd_sof_dev *sdev);
void hda_codec_suspend_cmd_io(struct snd_sof_dev *sdev);
void hda_codec_detect_mask(struct snd_sof_dev *sdev);
void hda_codec_rirb_status_clear(struct snd_sof_dev *sdev);
bool hda_codec_check_rirb_status(struct snd_sof_dev *sdev);
void hda_codec_set_codec_wakeup(struct snd_sof_dev *sdev, bool status);
void hda_codec_device_remove(struct snd_sof_dev *sdev);

#else

static inline void hda_codec_probe_bus(struct snd_sof_dev *sdev) { }
static inline void hda_codec_jack_wake_enable(struct snd_sof_dev *sdev, bool enable) { }
static inline void hda_codec_jack_check(struct snd_sof_dev *sdev) { }
static inline void hda_codec_check_for_state_change(struct snd_sof_dev *sdev) { }
static inline void hda_codec_init_cmd_io(struct snd_sof_dev *sdev) { }
static inline void hda_codec_resume_cmd_io(struct snd_sof_dev *sdev) { }
static inline void hda_codec_stop_cmd_io(struct snd_sof_dev *sdev) { }
static inline void hda_codec_suspend_cmd_io(struct snd_sof_dev *sdev) { }
static inline void hda_codec_detect_mask(struct snd_sof_dev *sdev) { }
static inline void hda_codec_rirb_status_clear(struct snd_sof_dev *sdev) { }
static inline bool hda_codec_check_rirb_status(struct snd_sof_dev *sdev) { return false; }
static inline void hda_codec_set_codec_wakeup(struct snd_sof_dev *sdev, bool status) { }
static inline void hda_codec_device_remove(struct snd_sof_dev *sdev) { }

#endif /* CONFIG_SND_SOC_SOF_HDA_AUDIO_CODEC */

#if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA_AUDIO_CODEC) && IS_ENABLED(CONFIG_SND_HDA_CODEC_HDMI)

void hda_codec_i915_display_power(struct snd_sof_dev *sdev, bool enable);
int hda_codec_i915_init(struct snd_sof_dev *sdev);
int hda_codec_i915_exit(struct snd_sof_dev *sdev);

#else

static inline void hda_codec_i915_display_power(struct snd_sof_dev *sdev, bool enable) { }
static inline int hda_codec_i915_init(struct snd_sof_dev *sdev) { return 0; }
static inline int hda_codec_i915_exit(struct snd_sof_dev *sdev) { return 0; }

#endif

/*
 * Trace Control.
 */
int hda_dsp_trace_init(struct snd_sof_dev *sdev, struct snd_dma_buffer *dmab,
                       struct sof_ipc_dma_trace_params_ext *dtrace_params);
int hda_dsp_trace_release(struct snd_sof_dev *sdev);
int hda_dsp_trace_trigger(struct snd_sof_dev *sdev, int cmd);

/*
 * SoundWire support
 */
#if IS_ENABLED(CONFIG_SND_SOC_SOF_INTEL_SOUNDWIRE)

int hda_sdw_check_lcount_common(struct snd_sof_dev *sdev);
int hda_sdw_check_lcount_ext(struct snd_sof_dev *sdev);
int hda_sdw_check_lcount(struct snd_sof_dev *sdev);
int hda_sdw_startup(struct snd_sof_dev *sdev);
void hda_common_enable_sdw_irq(struct snd_sof_dev *sdev, bool enable);
void hda_sdw_int_enable(struct snd_sof_dev *sdev, bool enable);
bool hda_sdw_check_wakeen_irq_common(struct snd_sof_dev *sdev);
void hda_sdw_process_wakeen_common(struct snd_sof_dev *sdev);
void hda_sdw_process_wakeen(struct snd_sof_dev *sdev);
bool hda_common_check_sdw_irq(struct snd_sof_dev *sdev);

#else

static inline int hda_sdw_check_lcount_common(struct snd_sof_dev *sdev)
{
        return 0;
}

static inline int hda_sdw_check_lcount_ext(struct snd_sof_dev *sdev)
{
        return 0;
}

static inline int hda_sdw_check_lcount(struct snd_sof_dev *sdev)
{
        return 0;
}

static inline int hda_sdw_startup(struct snd_sof_dev *sdev)
{
        return 0;
}

static inline void hda_common_enable_sdw_irq(struct snd_sof_dev *sdev, bool enable)
{
}

static inline void hda_sdw_int_enable(struct snd_sof_dev *sdev, bool enable)
{
}

static inline bool hda_sdw_check_wakeen_irq_common(struct snd_sof_dev *sdev)
{
        return false;
}

static inline void hda_sdw_process_wakeen_common(struct snd_sof_dev *sdev)
{
}

static inline void hda_sdw_process_wakeen(struct snd_sof_dev *sdev)
{
}

static inline bool hda_common_check_sdw_irq(struct snd_sof_dev *sdev)
{
        return false;
}

#endif

int sdw_hda_dai_hw_params(struct snd_pcm_substream *substream,
                          struct snd_pcm_hw_params *params,
                          struct snd_soc_dai *cpu_dai,
                          int link_id,
                          int intel_alh_id);

int sdw_hda_dai_hw_free(struct snd_pcm_substream *substream,
                        struct snd_soc_dai *cpu_dai,
                        int link_id);

int sdw_hda_dai_trigger(struct snd_pcm_substream *substream, int cmd,
                        struct snd_soc_dai *cpu_dai);

struct hdac_ext_stream *
hda_data_stream_prepare(struct device *dev, unsigned int format, unsigned int size,
                        struct snd_dma_buffer *dmab, bool persistent_buffer, int direction,
                        bool is_iccmax, bool pair);

int hda_data_stream_cleanup(struct device *dev, struct snd_dma_buffer *dmab,
                            bool persistent_buffer, struct hdac_ext_stream *hext_stream, bool pair);

/* common dai driver */
extern struct snd_soc_dai_driver skl_dai[];
int hda_dsp_dais_suspend(struct snd_sof_dev *sdev);

/*
 * Platform Specific HW abstraction Ops.
 */
extern const struct snd_sof_dsp_ops sof_hda_common_ops;

extern struct snd_sof_dsp_ops sof_skl_ops;
int sof_skl_ops_init(struct snd_sof_dev *sdev);
extern struct snd_sof_dsp_ops sof_apl_ops;
int sof_apl_ops_init(struct snd_sof_dev *sdev);
extern struct snd_sof_dsp_ops sof_cnl_ops;
int sof_cnl_ops_init(struct snd_sof_dev *sdev);
extern struct snd_sof_dsp_ops sof_tgl_ops;
int sof_tgl_ops_init(struct snd_sof_dev *sdev);
extern struct snd_sof_dsp_ops sof_icl_ops;
int sof_icl_ops_init(struct snd_sof_dev *sdev);

extern const struct sof_intel_dsp_desc skl_chip_info;
extern const struct sof_intel_dsp_desc apl_chip_info;
extern const struct sof_intel_dsp_desc cnl_chip_info;
extern const struct sof_intel_dsp_desc icl_chip_info;
extern const struct sof_intel_dsp_desc tgl_chip_info;
extern const struct sof_intel_dsp_desc tglh_chip_info;
extern const struct sof_intel_dsp_desc ehl_chip_info;
extern const struct sof_intel_dsp_desc jsl_chip_info;
extern const struct sof_intel_dsp_desc adls_chip_info;
extern const struct sof_intel_dsp_desc mtl_chip_info;
extern const struct sof_intel_dsp_desc arl_s_chip_info;
extern const struct sof_intel_dsp_desc lnl_chip_info;
extern const struct sof_intel_dsp_desc ptl_chip_info;
extern const struct sof_intel_dsp_desc wcl_chip_info;
extern const struct sof_intel_dsp_desc nvl_chip_info;
extern const struct sof_intel_dsp_desc nvl_s_chip_info;

/* Probes support */
#if IS_ENABLED(CONFIG_SND_SOC_SOF_HDA_PROBES)
int hda_probes_register(struct snd_sof_dev *sdev);
void hda_probes_unregister(struct snd_sof_dev *sdev);
#else
static inline int hda_probes_register(struct snd_sof_dev *sdev)
{
        return 0;
}

static inline void hda_probes_unregister(struct snd_sof_dev *sdev)
{
}
#endif /* CONFIG_SND_SOC_SOF_HDA_PROBES */

/* SOF client registration for HDA platforms */
int hda_register_clients(struct snd_sof_dev *sdev);
void hda_unregister_clients(struct snd_sof_dev *sdev);

/* machine driver select */
struct snd_soc_acpi_mach *hda_machine_select(struct snd_sof_dev *sdev);
void hda_set_mach_params(struct snd_soc_acpi_mach *mach,
                         struct snd_sof_dev *sdev);

/* PCI driver selection and probe */
int hda_pci_intel_probe(struct pci_dev *pci, const struct pci_device_id *pci_id);

struct snd_sof_dai;
struct sof_ipc_dai_config;

#define SOF_HDA_POSITION_QUIRK_USE_SKYLAKE_LEGACY       (0) /* previous implementation */
#define SOF_HDA_POSITION_QUIRK_USE_DPIB_REGISTERS       (1) /* recommended if VC0 only */
#define SOF_HDA_POSITION_QUIRK_USE_DPIB_DDR_UPDATE      (2) /* recommended with VC0 or VC1 */

extern int sof_hda_position_quirk;

void hda_set_dai_drv_ops(struct snd_sof_dev *sdev, struct snd_sof_dsp_ops *ops);
void hda_ops_free(struct snd_sof_dev *sdev);

/* SKL/KBL */
int hda_dsp_cl_boot_firmware_skl(struct snd_sof_dev *sdev);
int hda_dsp_core_stall_reset(struct snd_sof_dev *sdev, unsigned int core_mask);

/* IPC4 */
irqreturn_t cnl_ipc4_irq_thread(int irq, void *context);
int cnl_ipc4_send_msg(struct snd_sof_dev *sdev, struct snd_sof_ipc_msg *msg);
irqreturn_t hda_dsp_ipc4_irq_thread(int irq, void *context);
bool hda_ipc4_tx_is_busy(struct snd_sof_dev *sdev);
void hda_dsp_ipc4_schedule_d0i3_work(struct sof_intel_hda_dev *hdev,
                                     struct snd_sof_ipc_msg *msg);
int hda_dsp_ipc4_send_msg(struct snd_sof_dev *sdev, struct snd_sof_ipc_msg *msg);
void hda_ipc4_dump(struct snd_sof_dev *sdev);
extern struct sdw_intel_ops sdw_callback;

struct sof_ipc4_fw_library;
int hda_dsp_ipc4_load_library(struct snd_sof_dev *sdev,
                              struct sof_ipc4_fw_library *fw_lib, bool reload);

/**
 * struct hda_dai_widget_dma_ops - DAI DMA ops optional by default unless specified otherwise
 * @get_hext_stream: Mandatory function pointer to get the saved pointer to struct hdac_ext_stream
 * @assign_hext_stream: Function pointer to assign a hdac_ext_stream
 * @release_hext_stream: Function pointer to release the hdac_ext_stream
 * @setup_hext_stream: Function pointer for hdac_ext_stream setup
 * @reset_hext_stream: Function pointer for hdac_ext_stream reset
 * @pre_trigger: Function pointer for DAI DMA pre-trigger actions
 * @trigger: Function pointer for DAI DMA trigger actions
 * @post_trigger: Function pointer for DAI DMA post-trigger actions
 * @codec_dai_set_stream: Function pointer to set codec-side stream information
 * @calc_stream_format: Function pointer to determine stream format from hw_params and
 * for HDaudio codec DAI from the .sig bits
 * @get_hlink: Mandatory function pointer to retrieve hlink, mainly to program LOSIDV
 * for legacy HDaudio links or program HDaudio Extended Link registers.
 */
struct hda_dai_widget_dma_ops {
        struct hdac_ext_stream *(*get_hext_stream)(struct snd_sof_dev *sdev,
                                                   struct snd_soc_dai *cpu_dai,
                                                   struct snd_pcm_substream *substream);
        struct hdac_ext_stream *(*assign_hext_stream)(struct snd_sof_dev *sdev,
                                                      struct snd_soc_dai *cpu_dai,
                                                      struct snd_pcm_substream *substream);
        void (*release_hext_stream)(struct snd_sof_dev *sdev, struct snd_soc_dai *cpu_dai,
                                    struct snd_pcm_substream *substream);
        void (*setup_hext_stream)(struct snd_sof_dev *sdev, struct hdac_ext_stream *hext_stream,
                                  unsigned int format_val);
        void (*reset_hext_stream)(struct snd_sof_dev *sdev, struct hdac_ext_stream *hext_sream);
        int (*pre_trigger)(struct snd_sof_dev *sdev, struct snd_soc_dai *cpu_dai,
                           struct snd_pcm_substream *substream, int cmd);
        int (*trigger)(struct snd_sof_dev *sdev, struct snd_soc_dai *cpu_dai,
                       struct snd_pcm_substream *substream, int cmd);
        int (*post_trigger)(struct snd_sof_dev *sdev, struct snd_soc_dai *cpu_dai,
                            struct snd_pcm_substream *substream, int cmd);
        void (*codec_dai_set_stream)(struct snd_sof_dev *sdev,
                                     struct snd_pcm_substream *substream,
                                     struct hdac_stream *hstream);
        unsigned int (*calc_stream_format)(struct snd_sof_dev *sdev,
                                           struct snd_pcm_substream *substream,
                                           struct snd_pcm_hw_params *params);
        struct hdac_ext_link * (*get_hlink)(struct snd_sof_dev *sdev,
                                            struct snd_pcm_substream *substream);
};

const struct hda_dai_widget_dma_ops *
hda_select_dai_widget_ops(struct snd_sof_dev *sdev, struct snd_sof_widget *swidget);
int hda_dai_config(struct snd_soc_dapm_widget *w, unsigned int flags,
                   struct snd_sof_dai_config_data *data);

static inline struct snd_sof_dev *widget_to_sdev(struct snd_soc_dapm_widget *w)
{
        struct snd_sof_widget *swidget = w->dobj.private;
        struct snd_soc_component *component = swidget->scomp;

        return snd_soc_component_get_drvdata(component);
}

#endif