linux/soundwire/sdw_intel.h

1 /* SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) */
2 /* Copyright(c) 2015-17 Intel Corporation. */
43 #define SDW_SHIM_SYNC_SYNCPRD_VAL_24		(24000 / SDW_CADENCE_GSYNC_KHZ - 1)
44 #define SDW_SHIM_SYNC_SYNCPRD_VAL_24_576	(24576 / SDW_CADENCE_GSYNC_KHZ - 1)
45 #define SDW_SHIM_SYNC_SYNCPRD_VAL_38_4		(38400 / SDW_CADENCE_GSYNC_KHZ - 1)
46 #define SDW_SHIM_SYNC_SYNCPRD_VAL_96		(96000 / SDW_CADENCE_GSYNC_KHZ - 1)
117  * ACE2.x definitions for SHIM registers - only accessible when the
118  * HDAudio extended link LCTL.SPA/CPA = 1.
120 /* x variable is link index */
126 /* Read-only capabilities */
128 #define SDW_SHIM2_LECAP_HDS		BIT(0)		/* unset -> Host mode */
133 #define SDW_SHIM2_PCMSCAP_ISS		GENMASK(3, 0)	/* Input-only streams */
134 #define SDW_SHIM2_PCMSCAP_OSS		GENMASK(7, 4)	/* Output-only streams */
137 /* Read-only PCM Stream Channel Count, y variable is stream */
148 /* SHIM2 vendor-specific registers */
194  * the @params_stream callback, e.g. for interaction with DSP
207  * the @free_stream callback, e.g. for interaction with DSP
229  * struct sdw_intel_acpi_info - Soundwire Intel information found in ACPI tables
231  * @count: link count found with "sdw-master-count" or "sdw-manager-list" property
232  * @link_mask: bit-wise mask listing links enabled by BIOS menu
234  * this structure could be expanded to e.g. provide all the _ADR
246 /* Intel clock-stop/pm_runtime quirk definitions */
257  * reset and re-enumeration will be performed when the bus
259  * in-band wakes.
265  * (e.g. speaker amplifiers). The clock-stop mode is typically
266  * slightly higher power than when the IP is completely powered-off.
271  * Require a bus reset (and complete re-enumeration) when exiting
275  * e.g. to provide the reasons for the wake, report acoustic events or
283  * struct sdw_intel_ctx - context allocated by the controller
285  * @count: link count
288  * @link_mask: bit-wise mask listing SoundWire links reported by the
291  * @ldev: information for each link (controller-specific and kept
315  * struct sdw_intel_res - Soundwire Intel global resource structure,
319  * @count: link count
326  * @link_mask: bit-wise mask listing links selected by the DSP driver
328  * machine-specific quirks are handled in the DSP driver.
333  * @ext: extended HDaudio link support
335  * @eml_lock: mutex protecting shared registers in the HDaudio multi-link
365  * on e.g. which machine driver to select (I2S mode, HDaudio or
386 /* struct intel_sdw_hw_ops - SoundWire ops for Intel platforms.
389  * @get_link_count: fetch link count from hardware registers
396  * @link_power_up: power-up using chip-specific helpers
397  * @link_power_down: power-down with chip-specific helpers
399  * @shim_wake: enable/disable in-band wake management
402  * @sync_arm: helper for multi-link synchronization
403  * @sync_go_unlocked: helper for multi-link synchronization -
405  * @sync_go: helper for multi-link synchronization
406  * @sync_check_cmdsync_unlocked: helper for multi-link synchronization
407  * and bank switch - shim_lock is assumed to be locked at higher level
449  * IDA min selected to allow for 5 unconstrained devices per link,
450  * and 6 system-unique Device Numbers for wake-capable devices.