1/* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */
 2/*
 3 * The MIPI SDCA specification is available for public downloads at
 4 * https://www.mipi.org/mipi-sdca-v1-0-download
 5 *
 6 * Copyright(c) 2024 Intel Corporation
 7 */
 8
 9#ifndef __SDCA_H__
10#define __SDCA_H__
11
12struct sdw_slave;
13
14#define SDCA_MAX_FUNCTION_COUNT 8
15
16/**
17 * sdca_device_desc - short descriptor for an SDCA Function
18 * @adr: ACPI address (used for SDCA register access)
19 * @type: Function topology type
20 * @name: human-readable string
21 */
22struct sdca_function_desc {
23	u64 adr;
24	u32 type;
25	const char *name;
26};
27
28/**
29 * sdca_device_data - structure containing all SDCA related information
30 * @sdca_interface_revision: value read from _DSD property, mainly to check
31 * for changes between silicon versions
32 * @num_functions: total number of supported SDCA functions. Invalid/unsupported
33 * functions will be skipped.
34 * @sdca_func: array of function descriptors
35 */
36struct sdca_device_data {
37	u32 interface_revision;
38	int num_functions;
39	struct sdca_function_desc sdca_func[SDCA_MAX_FUNCTION_COUNT];
40};
41
42enum sdca_quirk {
43	SDCA_QUIRKS_RT712_VB,
44};
45
46#if IS_ENABLED(CONFIG_ACPI) && IS_ENABLED(CONFIG_SND_SOC_SDCA)
47
48void sdca_lookup_functions(struct sdw_slave *slave);
49void sdca_lookup_interface_revision(struct sdw_slave *slave);
50bool sdca_device_quirk_match(struct sdw_slave *slave, enum sdca_quirk quirk);
51
52#else
53
54static inline void sdca_lookup_functions(struct sdw_slave *slave) {}
55static inline void sdca_lookup_interface_revision(struct sdw_slave *slave) {}
56static inline bool sdca_device_quirk_match(struct sdw_slave *slave, enum sdca_quirk quirk)
57{
58	return false;
59}
60#endif
61
62#endif