include/linux/soundwire/sdw_intel.h

   1 /* SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) */
   2 /* Copyright(c) 2015-17 Intel Corporation. */
   3
   4 #ifndef __SDW_INTEL_H
   5 #define __SDW_INTEL_H
   6
   7 #include <linux/irqreturn.h>
   8 #include <linux/soundwire/sdw.h>
   9
  10 /*********************************************************************
  11  * cAVS and ACE1.x definitions
  12  *********************************************************************/
  13
  14 #define SDW_SHIM_BASE                   0x2C000
  15 #define SDW_ALH_BASE                    0x2C800
  16 #define SDW_SHIM_BASE_ACE               0x38000
  17 #define SDW_ALH_BASE_ACE                0x24000
  18 #define SDW_LINK_BASE                   0x30000
  19 #define SDW_LINK_SIZE                   0x10000
  20
  21 /* Intel SHIM Registers Definition */
  22 /* LCAP */
  23 #define SDW_SHIM_LCAP                   0x0
  24 #define SDW_SHIM_LCAP_LCOUNT_MASK       GENMASK(2, 0)
  25 #define SDW_SHIM_LCAP_MLCS_MASK         BIT(8)
  26
  27 /* LCTL */
  28 #define SDW_SHIM_LCTL                   0x4
  29
  30 #define SDW_SHIM_LCTL_SPA               BIT(0)
  31 #define SDW_SHIM_LCTL_SPA_MASK          GENMASK(3, 0)
  32 #define SDW_SHIM_LCTL_CPA               BIT(8)
  33 #define SDW_SHIM_LCTL_CPA_MASK          GENMASK(11, 8)
  34 #define SDW_SHIM_LCTL_MLCS_MASK         GENMASK(29, 27)
  35 #define SDW_SHIM_MLCS_XTAL_CLK          0x0
  36 #define SDW_SHIM_MLCS_CARDINAL_CLK      0x1
  37 #define SDW_SHIM_MLCS_AUDIO_PLL_CLK     0x2
  38
  39 /* SYNC */
  40 #define SDW_SHIM_SYNC                   0xC
  41
  42 #define SDW_SHIM_SYNC_SYNCPRD_VAL_24            (24000 / SDW_CADENCE_GSYNC_KHZ - 1)
  43 #define SDW_SHIM_SYNC_SYNCPRD_VAL_24_576        (24576 / SDW_CADENCE_GSYNC_KHZ - 1)
  44 #define SDW_SHIM_SYNC_SYNCPRD_VAL_38_4          (38400 / SDW_CADENCE_GSYNC_KHZ - 1)
  45 #define SDW_SHIM_SYNC_SYNCPRD_VAL_96            (96000 / SDW_CADENCE_GSYNC_KHZ - 1)
  46 #define SDW_SHIM_SYNC_SYNCPRD           GENMASK(14, 0)
  47 #define SDW_SHIM_SYNC_SYNCCPU           BIT(15)
  48 #define SDW_SHIM_SYNC_CMDSYNC_MASK      GENMASK(19, 16)
  49 #define SDW_SHIM_SYNC_CMDSYNC           BIT(16)
  50 #define SDW_SHIM_SYNC_SYNCGO            BIT(24)
  51
  52 /* Control stream capabililities and channel mask */
  53 #define SDW_SHIM_CTLSCAP(x)             (0x010 + 0x60 * (x))
  54 #define SDW_SHIM_CTLS0CM(x)             (0x012 + 0x60 * (x))
  55 #define SDW_SHIM_CTLS1CM(x)             (0x014 + 0x60 * (x))
  56 #define SDW_SHIM_CTLS2CM(x)             (0x016 + 0x60 * (x))
  57 #define SDW_SHIM_CTLS3CM(x)             (0x018 + 0x60 * (x))
  58
  59 /* PCM Stream capabilities */
  60 #define SDW_SHIM_PCMSCAP(x)             (0x020 + 0x60 * (x))
  61
  62 #define SDW_SHIM_PCMSCAP_ISS            GENMASK(3, 0)
  63 #define SDW_SHIM_PCMSCAP_OSS            GENMASK(7, 4)
  64 #define SDW_SHIM_PCMSCAP_BSS            GENMASK(12, 8)
  65
  66 /* PCM Stream Channel Map */
  67 #define SDW_SHIM_PCMSYCHM(x, y)         (0x022 + (0x60 * (x)) + (0x2 * (y)))
  68
  69 /* PCM Stream Channel Count */
  70 #define SDW_SHIM_PCMSYCHC(x, y)         (0x042 + (0x60 * (x)) + (0x2 * (y)))
  71
  72 #define SDW_SHIM_PCMSYCM_LCHN           GENMASK(3, 0)
  73 #define SDW_SHIM_PCMSYCM_HCHN           GENMASK(7, 4)
  74 #define SDW_SHIM_PCMSYCM_STREAM         GENMASK(13, 8)
  75 #define SDW_SHIM_PCMSYCM_DIR            BIT(15)
  76
  77 /* IO control */
  78 #define SDW_SHIM_IOCTL(x)               (0x06C + 0x60 * (x))
  79
  80 #define SDW_SHIM_IOCTL_MIF              BIT(0)
  81 #define SDW_SHIM_IOCTL_CO               BIT(1)
  82 #define SDW_SHIM_IOCTL_COE              BIT(2)
  83 #define SDW_SHIM_IOCTL_DO               BIT(3)
  84 #define SDW_SHIM_IOCTL_DOE              BIT(4)
  85 #define SDW_SHIM_IOCTL_BKE              BIT(5)
  86 #define SDW_SHIM_IOCTL_WPDD             BIT(6)
  87 #define SDW_SHIM_IOCTL_CIBD             BIT(8)
  88 #define SDW_SHIM_IOCTL_DIBD             BIT(9)
  89
  90 /* Wake Enable*/
  91 #define SDW_SHIM_WAKEEN                 0x190
  92
  93 #define SDW_SHIM_WAKEEN_ENABLE          BIT(0)
  94
  95 /* Wake Status */
  96 #define SDW_SHIM_WAKESTS                0x192
  97
  98 #define SDW_SHIM_WAKESTS_STATUS         BIT(0)
  99
 100 /* AC Timing control */
 101 #define SDW_SHIM_CTMCTL(x)              (0x06E + 0x60 * (x))
 102
 103 #define SDW_SHIM_CTMCTL_DACTQE          BIT(0)
 104 #define SDW_SHIM_CTMCTL_DODS            BIT(1)
 105 #define SDW_SHIM_CTMCTL_DOAIS           GENMASK(4, 3)
 106
 107 /* Intel ALH Register definitions */
 108 #define SDW_ALH_STRMZCFG(x)             (0x000 + (0x4 * (x)))
 109 #define SDW_ALH_NUM_STREAMS             64
 110
 111 #define SDW_ALH_STRMZCFG_DMAT_VAL       0x3
 112 #define SDW_ALH_STRMZCFG_DMAT           GENMASK(7, 0)
 113 #define SDW_ALH_STRMZCFG_CHN            GENMASK(19, 16)
 114
 115 /*********************************************************************
 116  * ACE2.x definitions for SHIM registers - only accessible when the
 117  * HDAudio extended link LCTL.SPA/CPA = 1.
 118  *********************************************************************/
 119 /* x variable is link index */
 120 #define SDW_SHIM2_GENERIC_BASE(x)       (0x00030000 + 0x8000 * (x))
 121 #define SDW_IP_BASE(x)                  (0x00030100 + 0x8000 * (x))
 122 #define SDW_SHIM2_VS_BASE(x)            (0x00036000 + 0x8000 * (x))
 123
 124 /* SHIM2 Generic Registers */
 125 /* Read-only capabilities */
 126 #define SDW_SHIM2_LECAP                 0x00
 127 #define SDW_SHIM2_LECAP_HDS             BIT(0)          /* unset -> Host mode */
 128 #define SDW_SHIM2_LECAP_MLC             GENMASK(3, 1)   /* Number of Lanes */
 129
 130 /* PCM Stream capabilities */
 131 #define SDW_SHIM2_PCMSCAP               0x10
 132 #define SDW_SHIM2_PCMSCAP_ISS           GENMASK(3, 0)   /* Input-only streams */
 133 #define SDW_SHIM2_PCMSCAP_OSS           GENMASK(7, 4)   /* Output-only streams */
 134 #define SDW_SHIM2_PCMSCAP_BSS           GENMASK(12, 8)  /* Bidirectional streams */
 135
 136 /* Read-only PCM Stream Channel Count, y variable is stream */
 137 #define SDW_SHIM2_PCMSYCHC(y)           (0x14 + (0x4 * (y)))
 138 #define SDW_SHIM2_PCMSYCHC_CS           GENMASK(3, 0)   /* Channels Supported */
 139
 140 /* PCM Stream Channel Map */
 141 #define SDW_SHIM2_PCMSYCHM(y)           (0x16 + (0x4 * (y)))
 142 #define SDW_SHIM2_PCMSYCHM_LCHAN        GENMASK(3, 0)   /* Lowest channel used by the FIFO port */
 143 #define SDW_SHIM2_PCMSYCHM_HCHAN        GENMASK(7, 4)   /* Lowest channel used by the FIFO port */
 144 #define SDW_SHIM2_PCMSYCHM_STRM         GENMASK(13, 8)  /* HDaudio stream tag */
 145 #define SDW_SHIM2_PCMSYCHM_DIR          BIT(15)         /* HDaudio stream direction */
 146
 147 /* SHIM2 vendor-specific registers */
 148 #define SDW_SHIM2_INTEL_VS_LVSCTL       0x04
 149 #define SDW_SHIM2_INTEL_VS_LVSCTL_FCG   BIT(26)
 150 #define SDW_SHIM2_INTEL_VS_LVSCTL_MLCS  GENMASK(29, 27)
 151 #define SDW_SHIM2_INTEL_VS_LVSCTL_DCGD  BIT(30)
 152 #define SDW_SHIM2_INTEL_VS_LVSCTL_ICGD  BIT(31)
 153
 154 #define SDW_SHIM2_MLCS_XTAL_CLK         0x0
 155 #define SDW_SHIM2_MLCS_CARDINAL_CLK     0x1
 156 #define SDW_SHIM2_MLCS_AUDIO_PLL_CLK    0x2
 157 #define SDW_SHIM2_MLCS_MCLK_INPUT_CLK   0x3
 158 #define SDW_SHIM2_MLCS_WOV_RING_OSC_CLK 0x4
 159
 160 #define SDW_SHIM2_INTEL_VS_WAKEEN       0x08
 161 #define SDW_SHIM2_INTEL_VS_WAKEEN_PWE   BIT(0)
 162
 163 #define SDW_SHIM2_INTEL_VS_WAKESTS      0x0A
 164 #define SDW_SHIM2_INTEL_VS_WAKEEN_PWS   BIT(0)
 165
 166 #define SDW_SHIM2_INTEL_VS_IOCTL        0x0C
 167 #define SDW_SHIM2_INTEL_VS_IOCTL_MIF    BIT(0)
 168 #define SDW_SHIM2_INTEL_VS_IOCTL_CO     BIT(1)
 169 #define SDW_SHIM2_INTEL_VS_IOCTL_COE    BIT(2)
 170 #define SDW_SHIM2_INTEL_VS_IOCTL_DO     BIT(3)
 171 #define SDW_SHIM2_INTEL_VS_IOCTL_DOE    BIT(4)
 172 #define SDW_SHIM2_INTEL_VS_IOCTL_BKE    BIT(5)
 173 #define SDW_SHIM2_INTEL_VS_IOCTL_WPDD   BIT(6)
 174 #define SDW_SHIM2_INTEL_VS_IOCTL_ODC    BIT(7)
 175 #define SDW_SHIM2_INTEL_VS_IOCTL_CIBD   BIT(8)
 176 #define SDW_SHIM2_INTEL_VS_IOCTL_DIBD   BIT(9)
 177 #define SDW_SHIM2_INTEL_VS_IOCTL_HAMIFD BIT(10)
 178
 179 #define SDW_SHIM2_INTEL_VS_ACTMCTL      0x0E
 180 #define SDW_SHIM2_INTEL_VS_ACTMCTL_DACTQE       BIT(0)
 181 #define SDW_SHIM2_INTEL_VS_ACTMCTL_DODS         BIT(1)
 182 #define SDW_SHIM2_INTEL_VS_ACTMCTL_DODSE        BIT(2)
 183 #define SDW_SHIM2_INTEL_VS_ACTMCTL_DOAIS        GENMASK(4, 3)
 184 #define SDW_SHIM2_INTEL_VS_ACTMCTL_DOAISE       BIT(5)
 185
 186 /**
 187  * struct sdw_intel_stream_params_data: configuration passed during
 188  * the @params_stream callback, e.g. for interaction with DSP
 189  * firmware.
 190  */
 191 struct sdw_intel_stream_params_data {
 192         struct snd_pcm_substream *substream;
 193         struct snd_soc_dai *dai;
 194         struct snd_pcm_hw_params *hw_params;
 195         int link_id;
 196         int alh_stream_id;
 197 };
 198
 199 /**
 200  * struct sdw_intel_stream_free_data: configuration passed during
 201  * the @free_stream callback, e.g. for interaction with DSP
 202  * firmware.
 203  */
 204 struct sdw_intel_stream_free_data {
 205         struct snd_pcm_substream *substream;
 206         struct snd_soc_dai *dai;
 207         int link_id;
 208 };
 209
 210 /**
 211  * struct sdw_intel_ops: Intel audio driver callback ops
 212  *
 213  */
 214 struct sdw_intel_ops {
 215         int (*params_stream)(struct device *dev,
 216                              struct sdw_intel_stream_params_data *params_data);
 217         int (*free_stream)(struct device *dev,
 218                            struct sdw_intel_stream_free_data *free_data);
 219         int (*trigger)(struct snd_pcm_substream *substream, int cmd, struct snd_soc_dai *dai);
 220 };
 221
 222 /**
 223  * struct sdw_intel_acpi_info - Soundwire Intel information found in ACPI tables
 224  * @handle: ACPI controller handle
 225  * @count: link count found with "sdw-master-count" property
 226  * @link_mask: bit-wise mask listing links enabled by BIOS menu
 227  *
 228  * this structure could be expanded to e.g. provide all the _ADR
 229  * information in case the link_mask is not sufficient to identify
 230  * platform capabilities.
 231  */
 232 struct sdw_intel_acpi_info {
 233         acpi_handle handle;
 234         int count;
 235         u32 link_mask;
 236 };
 237
 238 struct sdw_intel_link_dev;
 239
 240 /* Intel clock-stop/pm_runtime quirk definitions */
 241
 242 /*
 243  * Force the clock to remain on during pm_runtime suspend. This might
 244  * be needed if Slave devices do not have an alternate clock source or
 245  * if the latency requirements are very strict.
 246  */
 247 #define SDW_INTEL_CLK_STOP_NOT_ALLOWED          BIT(0)
 248
 249 /*
 250  * Stop the bus during pm_runtime suspend. If set, a complete bus
 251  * reset and re-enumeration will be performed when the bus
 252  * restarts. This mode shall not be used if Slave devices can generate
 253  * in-band wakes.
 254  */
 255 #define SDW_INTEL_CLK_STOP_TEARDOWN             BIT(1)
 256
 257 /*
 258  * Stop the bus during pm_suspend if Slaves are not wake capable
 259  * (e.g. speaker amplifiers). The clock-stop mode is typically
 260  * slightly higher power than when the IP is completely powered-off.
 261  */
 262 #define SDW_INTEL_CLK_STOP_WAKE_CAPABLE_ONLY    BIT(2)
 263
 264 /*
 265  * Require a bus reset (and complete re-enumeration) when exiting
 266  * clock stop modes. This may be needed if the controller power was
 267  * turned off and all context lost. This quirk shall not be used if a
 268  * Slave device needs to remain enumerated and keep its context,
 269  * e.g. to provide the reasons for the wake, report acoustic events or
 270  * pass a history buffer.
 271  */
 272 #define SDW_INTEL_CLK_STOP_BUS_RESET            BIT(3)
 273
 274 struct hdac_bus;
 275
 276 /**
 277  * struct sdw_intel_ctx - context allocated by the controller
 278  * driver probe
 279  * @count: link count
 280  * @mmio_base: mmio base of SoundWire registers, only used to check
 281  * hardware capabilities after all power dependencies are settled.
 282  * @link_mask: bit-wise mask listing SoundWire links reported by the
 283  * Controller
 284  * @num_slaves: total number of devices exposed across all enabled links
 285  * @handle: ACPI parent handle
 286  * @ldev: information for each link (controller-specific and kept
 287  * opaque here)
 288  * @ids: array of slave_id, representing Slaves exposed across all enabled
 289  * links
 290  * @link_list: list to handle interrupts across all links
 291  * @shim_lock: mutex to handle concurrent rmw access to shared SHIM registers.
 292  * @shim_mask: flags to track initialization of SHIM shared registers
 293  * @shim_base: sdw shim base.
 294  * @alh_base: sdw alh base.
 295  */
 296 struct sdw_intel_ctx {
 297         int count;
 298         void __iomem *mmio_base;
 299         u32 link_mask;
 300         int num_slaves;
 301         acpi_handle handle;
 302         struct sdw_intel_link_dev **ldev;
 303         struct sdw_extended_slave_id *ids;
 304         struct list_head link_list;
 305         struct mutex shim_lock; /* lock for access to shared SHIM registers */
 306         u32 shim_mask;
 307         u32 shim_base;
 308         u32 alh_base;
 309 };
 310
 311 /**
 312  * struct sdw_intel_res - Soundwire Intel global resource structure,
 313  * typically populated by the DSP driver
 314  *
 315  * @hw_ops: abstraction for platform ops
 316  * @count: link count
 317  * @mmio_base: mmio base of SoundWire registers
 318  * @irq: interrupt number
 319  * @handle: ACPI parent handle
 320  * @parent: parent device
 321  * @ops: callback ops
 322  * @dev: device implementing hwparams and free callbacks
 323  * @link_mask: bit-wise mask listing links selected by the DSP driver
 324  * This mask may be a subset of the one reported by the controller since
 325  * machine-specific quirks are handled in the DSP driver.
 326  * @clock_stop_quirks: mask array of possible behaviors requested by the
 327  * DSP driver. The quirks are common for all links for now.
 328  * @shim_base: sdw shim base.
 329  * @alh_base: sdw alh base.
 330  * @ext: extended HDaudio link support
 331  * @hbus: hdac_bus pointer, needed for power management
 332  * @eml_lock: mutex protecting shared registers in the HDaudio multi-link
 333  * space
 334  */
 335 struct sdw_intel_res {
 336         const struct sdw_intel_hw_ops *hw_ops;
 337         int count;
 338         void __iomem *mmio_base;
 339         int irq;
 340         acpi_handle handle;
 341         struct device *parent;
 342         const struct sdw_intel_ops *ops;
 343         struct device *dev;
 344         u32 link_mask;
 345         u32 clock_stop_quirks;
 346         u32 shim_base;
 347         u32 alh_base;
 348         bool ext;
 349         struct hdac_bus *hbus;
 350         struct mutex *eml_lock;
 351 };
 352
 353 /*
 354  * On Intel platforms, the SoundWire IP has dependencies on power
 355  * rails shared with the DSP, and the initialization steps are split
 356  * in three. First an ACPI scan to check what the firmware describes
 357  * in DSDT tables, then an allocation step (with no hardware
 358  * configuration but with all the relevant devices created) and last
 359  * the actual hardware configuration. The final stage is a global
 360  * interrupt enable which is controlled by the DSP driver. Splitting
 361  * these phases helps simplify the boot flow and make early decisions
 362  * on e.g. which machine driver to select (I2S mode, HDaudio or
 363  * SoundWire).
 364  */
 365 int sdw_intel_acpi_scan(acpi_handle *parent_handle,
 366                         struct sdw_intel_acpi_info *info);
 367
 368 void sdw_intel_process_wakeen_event(struct sdw_intel_ctx *ctx);
 369
 370 struct sdw_intel_ctx *
 371 sdw_intel_probe(struct sdw_intel_res *res);
 372
 373 int sdw_intel_startup(struct sdw_intel_ctx *ctx);
 374
 375 void sdw_intel_exit(struct sdw_intel_ctx *ctx);
 376
 377 irqreturn_t sdw_intel_thread(int irq, void *dev_id);
 378
 379 #define SDW_INTEL_QUIRK_MASK_BUS_DISABLE      BIT(1)
 380
 381 struct sdw_intel;
 382
 383 /* struct intel_sdw_hw_ops - SoundWire ops for Intel platforms.
 384  * @debugfs_init: initialize all debugfs capabilities
 385  * @debugfs_exit: close and cleanup debugfs capabilities
 386  * @register_dai: read all PDI information and register DAIs
 387  * @check_clock_stop: throw error message if clock is not stopped.
 388  * @start_bus: normal start
 389  * @start_bus_after_reset: start after reset
 390  * @start_bus_after_clock_stop: start after mode0 clock stop
 391  * @stop_bus: stop all bus
 392  * @link_power_up: power-up using chip-specific helpers
 393  * @link_power_down: power-down with chip-specific helpers
 394  * @shim_check_wake: check if a wake was received
 395  * @shim_wake: enable/disable in-band wake management
 396  * @pre_bank_switch: helper for bus management
 397  * @post_bank_switch: helper for bus management
 398  * @sync_arm: helper for multi-link synchronization
 399  * @sync_go_unlocked: helper for multi-link synchronization -
 400  * shim_lock is assumed to be locked at higher level
 401  * @sync_go: helper for multi-link synchronization
 402  * @sync_check_cmdsync_unlocked: helper for multi-link synchronization
 403  * and bank switch - shim_lock is assumed to be locked at higher level
 404  * @program_sdi: helper for codec command/control based on dev_num
 405  */
 406 struct sdw_intel_hw_ops {
 407         void (*debugfs_init)(struct sdw_intel *sdw);
 408         void (*debugfs_exit)(struct sdw_intel *sdw);
 409
 410         int (*register_dai)(struct sdw_intel *sdw);
 411
 412         void (*check_clock_stop)(struct sdw_intel *sdw);
 413         int (*start_bus)(struct sdw_intel *sdw);
 414         int (*start_bus_after_reset)(struct sdw_intel *sdw);
 415         int (*start_bus_after_clock_stop)(struct sdw_intel *sdw);
 416         int (*stop_bus)(struct sdw_intel *sdw, bool clock_stop);
 417
 418         int (*link_power_up)(struct sdw_intel *sdw);
 419         int (*link_power_down)(struct sdw_intel *sdw);
 420
 421         int  (*shim_check_wake)(struct sdw_intel *sdw);
 422         void (*shim_wake)(struct sdw_intel *sdw, bool wake_enable);
 423
 424         int (*pre_bank_switch)(struct sdw_intel *sdw);
 425         int (*post_bank_switch)(struct sdw_intel *sdw);
 426
 427         void (*sync_arm)(struct sdw_intel *sdw);
 428         int (*sync_go_unlocked)(struct sdw_intel *sdw);
 429         int (*sync_go)(struct sdw_intel *sdw);
 430         bool (*sync_check_cmdsync_unlocked)(struct sdw_intel *sdw);
 431
 432         void (*program_sdi)(struct sdw_intel *sdw, int dev_num);
 433 };
 434
 435 extern const struct sdw_intel_hw_ops sdw_intel_cnl_hw_ops;
 436 extern const struct sdw_intel_hw_ops sdw_intel_lnl_hw_ops;
 437
 438 /*
 439  * IDA min selected to allow for 5 unconstrained devices per link,
 440  * and 6 system-unique Device Numbers for wake-capable devices.
 441  */
 442
 443 #define SDW_INTEL_DEV_NUM_IDA_MIN           6
 444
 445 #endif