xref: /linux/include/sound/soc_sdw_utils.h (revision 3fd6c59042dbba50391e30862beac979491145fe)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * This file incorporates work covered by the following copyright notice:
4  * Copyright (c) 2020 Intel Corporation
5  * Copyright(c) 2024 Advanced Micro Devices, Inc.
6  *
7  */
8 
9 #ifndef SOC_SDW_UTILS_H
10 #define SOC_SDW_UTILS_H
11 
12 #include <sound/soc.h>
13 #include <sound/soc-acpi.h>
14 
15 #define SOC_SDW_MAX_DAI_NUM             8
16 #define SOC_SDW_MAX_NO_PROPS		2
17 #define SOC_SDW_JACK_JDSRC(quirk)	((quirk) & GENMASK(3, 0))
18 
19 /* If a CODEC has an optional speaker output, this quirk will enable it */
20 #define SOC_SDW_CODEC_SPKR			BIT(15)
21 /*
22  * If the CODEC has additional devices attached directly to it.
23  *
24  * For the cs42l43:
25  *   - 0 - No speaker output
26  *   - SOC_SDW_CODEC_SPKR - CODEC internal speaker
27  *   - SOC_SDW_SIDECAR_AMPS - 2x Sidecar amplifiers + CODEC internal speaker
28  *   - SOC_SDW_CODEC_SPKR | SOF_SIDECAR_AMPS - Not currently supported
29  */
30 #define SOC_SDW_SIDECAR_AMPS		BIT(16)
31 #define SOC_SDW_CODEC_MIC		BIT(17)
32 
33 #define SOC_SDW_UNUSED_DAI_ID		-1
34 #define SOC_SDW_JACK_OUT_DAI_ID		0
35 #define SOC_SDW_JACK_IN_DAI_ID		1
36 #define SOC_SDW_AMP_OUT_DAI_ID		2
37 #define SOC_SDW_AMP_IN_DAI_ID		3
38 #define SOC_SDW_DMIC_DAI_ID		4
39 
40 #define SOC_SDW_DAI_TYPE_JACK		0
41 #define SOC_SDW_DAI_TYPE_AMP		1
42 #define SOC_SDW_DAI_TYPE_MIC		2
43 
44 struct asoc_sdw_codec_info;
45 
46 struct asoc_sdw_dai_info {
47 	const bool direction[2]; /* playback & capture support */
48 	const char *dai_name;
49 	const int dai_type;
50 	const int dailink[2]; /* dailink id for each direction */
51 	const struct snd_kcontrol_new *controls;
52 	const int num_controls;
53 	const struct snd_soc_dapm_widget *widgets;
54 	const int num_widgets;
55 	int  (*init)(struct snd_soc_card *card,
56 		     struct snd_soc_dai_link *dai_links,
57 		     struct asoc_sdw_codec_info *info,
58 		     bool playback);
59 	int (*exit)(struct snd_soc_card *card, struct snd_soc_dai_link *dai_link);
60 	int (*rtd_init)(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
61 	bool rtd_init_done; /* Indicate that the rtd_init callback is done */
62 	unsigned long quirk;
63 	bool quirk_exclude;
64 };
65 
66 struct asoc_sdw_codec_info {
67 	const int part_id;
68 	const int version_id;
69 	const char *codec_name;
70 	int amp_num;
71 	const u8 acpi_id[ACPI_ID_LEN];
72 	const bool ignore_internal_dmic;
73 	const struct snd_soc_ops *ops;
74 	struct asoc_sdw_dai_info dais[SOC_SDW_MAX_DAI_NUM];
75 	const int dai_num;
76 
77 	int (*codec_card_late_probe)(struct snd_soc_card *card);
78 
79 	int  (*count_sidecar)(struct snd_soc_card *card,
80 			      int *num_dais, int *num_devs);
81 	int  (*add_sidecar)(struct snd_soc_card *card,
82 			    struct snd_soc_dai_link **dai_links,
83 			    struct snd_soc_codec_conf **codec_conf);
84 };
85 
86 struct asoc_sdw_mc_private {
87 	struct snd_soc_card card;
88 	struct snd_soc_jack sdw_headset;
89 	struct device *headset_codec_dev; /* only one headset per card */
90 	struct device *amp_dev1, *amp_dev2;
91 	bool append_dai_type;
92 	bool ignore_internal_dmic;
93 	void *private;
94 	unsigned long mc_quirk;
95 	int codec_info_list_count;
96 };
97 
98 struct asoc_sdw_endpoint {
99 	struct list_head list;
100 
101 	u32 link_mask;
102 	const char *codec_name;
103 	const char *name_prefix;
104 	bool include_sidecar;
105 
106 	struct asoc_sdw_codec_info *codec_info;
107 	const struct asoc_sdw_dai_info *dai_info;
108 };
109 
110 struct asoc_sdw_dailink {
111 	bool initialised;
112 
113 	u8 group_id;
114 	u32 link_mask[SNDRV_PCM_STREAM_LAST + 1];
115 	int num_devs[SNDRV_PCM_STREAM_LAST + 1];
116 	struct list_head endpoints;
117 };
118 
119 extern struct asoc_sdw_codec_info codec_info_list[];
120 int asoc_sdw_get_codec_info_list_count(void);
121 
122 int asoc_sdw_startup(struct snd_pcm_substream *substream);
123 int asoc_sdw_prepare(struct snd_pcm_substream *substream);
124 int asoc_sdw_prepare(struct snd_pcm_substream *substream);
125 int asoc_sdw_trigger(struct snd_pcm_substream *substream, int cmd);
126 int asoc_sdw_hw_params(struct snd_pcm_substream *substream,
127 		       struct snd_pcm_hw_params *params);
128 int asoc_sdw_hw_free(struct snd_pcm_substream *substream);
129 void asoc_sdw_shutdown(struct snd_pcm_substream *substream);
130 
131 const char *asoc_sdw_get_codec_name(struct device *dev,
132 				    const struct asoc_sdw_codec_info *codec_info,
133 				    const struct snd_soc_acpi_link_adr *adr_link,
134 				    int adr_index);
135 
136 struct asoc_sdw_codec_info *asoc_sdw_find_codec_info_part(const u64 adr);
137 
138 struct asoc_sdw_codec_info *asoc_sdw_find_codec_info_acpi(const u8 *acpi_id);
139 
140 struct asoc_sdw_codec_info *asoc_sdw_find_codec_info_dai(const char *dai_name,
141 							 int *dai_index);
142 
143 struct snd_soc_dai_link *asoc_sdw_mc_find_codec_dai_used(struct snd_soc_card *card,
144 							 const char *dai_name);
145 
146 void asoc_sdw_mc_dailink_exit_loop(struct snd_soc_card *card);
147 
148 int asoc_sdw_card_late_probe(struct snd_soc_card *card);
149 
150 void asoc_sdw_init_dai_link(struct device *dev, struct snd_soc_dai_link *dai_links,
151 			    int *be_id, char *name, int playback, int capture,
152 			    struct snd_soc_dai_link_component *cpus, int cpus_num,
153 			    struct snd_soc_dai_link_component *platform_component,
154 			    int num_platforms, struct snd_soc_dai_link_component *codecs,
155 			    int codecs_num, int no_pcm,
156 			    int (*init)(struct snd_soc_pcm_runtime *rtd),
157 			    const struct snd_soc_ops *ops);
158 
159 int asoc_sdw_init_simple_dai_link(struct device *dev, struct snd_soc_dai_link *dai_links,
160 				  int *be_id, char *name, int playback, int capture,
161 				  const char *cpu_dai_name, const char *platform_comp_name,
162 				  int num_platforms, const char *codec_name,
163 				  const char *codec_dai_name, int no_pcm,
164 				  int (*init)(struct snd_soc_pcm_runtime *rtd),
165 				  const struct snd_soc_ops *ops);
166 
167 int asoc_sdw_count_sdw_endpoints(struct snd_soc_card *card, int *num_devs, int *num_ends);
168 
169 struct asoc_sdw_dailink *asoc_sdw_find_dailink(struct asoc_sdw_dailink *dailinks,
170 					       const struct snd_soc_acpi_endpoint *new);
171 
172 int asoc_sdw_parse_sdw_endpoints(struct snd_soc_card *card,
173 				 struct asoc_sdw_dailink *soc_dais,
174 				 struct asoc_sdw_endpoint *soc_ends,
175 				 int *num_devs);
176 
177 int asoc_sdw_rtd_init(struct snd_soc_pcm_runtime *rtd);
178 
179 /* DMIC support */
180 int asoc_sdw_dmic_init(struct snd_soc_pcm_runtime *rtd);
181 
182 /* RT711 support */
183 int asoc_sdw_rt711_init(struct snd_soc_card *card,
184 			struct snd_soc_dai_link *dai_links,
185 			struct asoc_sdw_codec_info *info,
186 			bool playback);
187 int asoc_sdw_rt711_exit(struct snd_soc_card *card, struct snd_soc_dai_link *dai_link);
188 
189 /* RT711-SDCA support */
190 int asoc_sdw_rt_sdca_jack_init(struct snd_soc_card *card,
191 			       struct snd_soc_dai_link *dai_links,
192 			       struct asoc_sdw_codec_info *info,
193 			       bool playback);
194 int asoc_sdw_rt_sdca_jack_exit(struct snd_soc_card *card, struct snd_soc_dai_link *dai_link);
195 
196 /* RT1308 I2S support */
197 extern const struct snd_soc_ops soc_sdw_rt1308_i2s_ops;
198 
199 /* generic amp support */
200 int asoc_sdw_rt_amp_init(struct snd_soc_card *card,
201 			 struct snd_soc_dai_link *dai_links,
202 			 struct asoc_sdw_codec_info *info,
203 			 bool playback);
204 int asoc_sdw_rt_amp_exit(struct snd_soc_card *card, struct snd_soc_dai_link *dai_link);
205 
206 /* CS42L43 support */
207 int asoc_sdw_cs42l43_spk_init(struct snd_soc_card *card,
208 			      struct snd_soc_dai_link *dai_links,
209 			      struct asoc_sdw_codec_info *info,
210 			      bool playback);
211 
212 /* CS AMP support */
213 int asoc_sdw_bridge_cs35l56_count_sidecar(struct snd_soc_card *card,
214 					  int *num_dais, int *num_devs);
215 int asoc_sdw_bridge_cs35l56_add_sidecar(struct snd_soc_card *card,
216 					struct snd_soc_dai_link **dai_links,
217 					struct snd_soc_codec_conf **codec_conf);
218 int asoc_sdw_bridge_cs35l56_spk_init(struct snd_soc_card *card,
219 				     struct snd_soc_dai_link *dai_links,
220 				     struct asoc_sdw_codec_info *info,
221 				     bool playback);
222 
223 int asoc_sdw_cs_amp_init(struct snd_soc_card *card,
224 			 struct snd_soc_dai_link *dai_links,
225 			 struct asoc_sdw_codec_info *info,
226 			 bool playback);
227 
228 /* MAXIM codec support */
229 int asoc_sdw_maxim_init(struct snd_soc_card *card,
230 			struct snd_soc_dai_link *dai_links,
231 			struct asoc_sdw_codec_info *info,
232 			bool playback);
233 
234 /* dai_link init callbacks */
235 int asoc_sdw_rt_dmic_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
236 int asoc_sdw_rt_sdca_jack_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
237 int asoc_sdw_rt_amp_spk_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
238 int asoc_sdw_rt700_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
239 int asoc_sdw_rt711_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
240 int asoc_sdw_rt_mf_sdca_spk_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
241 int asoc_sdw_rt5682_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
242 int asoc_sdw_cs42l42_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
243 int asoc_sdw_cs42l43_hs_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
244 int asoc_sdw_cs42l43_spk_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
245 int asoc_sdw_cs42l43_dmic_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
246 int asoc_sdw_cs_spk_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
247 int asoc_sdw_maxim_spk_rtd_init(struct snd_soc_pcm_runtime *rtd, struct snd_soc_dai *dai);
248 
249 #endif
250