Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
tjh.dev
kernel
os
linux
1/* SPDX-License-Identifier: (GPL-2.0-only OR BSD-3-Clause) */
2/*
3 * This file is provided under a dual BSD/GPLv2 license. When using or
4 * redistributing this file, you may do so under either license.
5 *
6 * Copyright(c) 2019 Intel Corporation. All rights reserved.
7 *
8 * Author: Ranjani Sridharan <ranjani.sridharan@linux.intel.com>
9 */
10
11#ifndef __SOUND_SOC_SOF_AUDIO_H
12#define __SOUND_SOC_SOF_AUDIO_H
13
14#include <linux/workqueue.h>
15
16#include <sound/soc.h>
17#include <sound/control.h>
18#include <sound/sof/stream.h> /* needs to be included before control.h */
19#include <sound/sof/control.h>
20#include <sound/sof/dai.h>
21#include <sound/sof/topology.h>
22#include "sof-priv.h"
23
24#define SOF_AUDIO_PCM_DRV_NAME "sof-audio-component"
25
26/* max number of FE PCMs before BEs */
27#define SOF_BE_PCM_BASE 16
28
29#define DMA_CHAN_INVALID 0xFFFFFFFF
30
31/* PCM stream, mapped to FW component */
32struct snd_sof_pcm_stream {
33 u32 comp_id;
34 struct snd_dma_buffer page_table;
35 struct sof_ipc_stream_posn posn;
36 struct snd_pcm_substream *substream;
37 struct work_struct period_elapsed_work;
38 bool d0i3_compatible; /* DSP can be in D0I3 when this pcm is opened */
39 /*
40 * flag to indicate that the DSP pipelines should be kept
41 * active or not while suspending the stream
42 */
43 bool suspend_ignored;
44};
45
46/* ALSA SOF PCM device */
47struct snd_sof_pcm {
48 struct snd_soc_component *scomp;
49 struct snd_soc_tplg_pcm pcm;
50 struct snd_sof_pcm_stream stream[2];
51 struct list_head list; /* list in sdev pcm list */
52 struct snd_pcm_hw_params params[2];
53 bool prepared[2]; /* PCM_PARAMS set successfully */
54};
55
56struct snd_sof_led_control {
57 unsigned int use_led;
58 unsigned int direction;
59 int led_value;
60};
61
62/* ALSA SOF Kcontrol device */
63struct snd_sof_control {
64 struct snd_soc_component *scomp;
65 int comp_id;
66 int min_volume_step; /* min volume step for volume_table */
67 int max_volume_step; /* max volume step for volume_table */
68 int num_channels;
69 u32 readback_offset; /* offset to mmapped data if used */
70 struct sof_ipc_ctrl_data *control_data;
71 u32 size; /* cdata size */
72 enum sof_ipc_ctrl_cmd cmd;
73 u32 *volume_table; /* volume table computed from tlv data*/
74
75 struct list_head list; /* list in sdev control list */
76
77 struct snd_sof_led_control led_ctl;
78};
79
80/* ASoC SOF DAPM widget */
81struct snd_sof_widget {
82 struct snd_soc_component *scomp;
83 int comp_id;
84 int pipeline_id;
85 int complete;
86 int core;
87 int id;
88
89 struct snd_soc_dapm_widget *widget;
90 struct list_head list; /* list in sdev widget list */
91
92 /* extended data for UUID components */
93 struct sof_ipc_comp_ext comp_ext;
94
95 void *private; /* core does not touch this */
96};
97
98/* ASoC SOF DAPM route */
99struct snd_sof_route {
100 struct snd_soc_component *scomp;
101
102 struct snd_soc_dapm_route *route;
103 struct list_head list; /* list in sdev route list */
104
105 void *private;
106};
107
108/* ASoC DAI device */
109struct snd_sof_dai {
110 struct snd_soc_component *scomp;
111 const char *name;
112 const char *cpu_dai_name;
113
114 struct sof_ipc_comp_dai comp_dai;
115 int number_configs;
116 int current_config;
117 struct sof_ipc_dai_config *dai_config;
118 struct list_head list; /* list in sdev dai list */
119};
120
121/*
122 * Kcontrols.
123 */
124
125int snd_sof_volume_get(struct snd_kcontrol *kcontrol,
126 struct snd_ctl_elem_value *ucontrol);
127int snd_sof_volume_put(struct snd_kcontrol *kcontrol,
128 struct snd_ctl_elem_value *ucontrol);
129int snd_sof_volume_info(struct snd_kcontrol *kcontrol,
130 struct snd_ctl_elem_info *uinfo);
131int snd_sof_switch_get(struct snd_kcontrol *kcontrol,
132 struct snd_ctl_elem_value *ucontrol);
133int snd_sof_switch_put(struct snd_kcontrol *kcontrol,
134 struct snd_ctl_elem_value *ucontrol);
135int snd_sof_enum_get(struct snd_kcontrol *kcontrol,
136 struct snd_ctl_elem_value *ucontrol);
137int snd_sof_enum_put(struct snd_kcontrol *kcontrol,
138 struct snd_ctl_elem_value *ucontrol);
139int snd_sof_bytes_get(struct snd_kcontrol *kcontrol,
140 struct snd_ctl_elem_value *ucontrol);
141int snd_sof_bytes_put(struct snd_kcontrol *kcontrol,
142 struct snd_ctl_elem_value *ucontrol);
143int snd_sof_bytes_ext_put(struct snd_kcontrol *kcontrol,
144 const unsigned int __user *binary_data,
145 unsigned int size);
146int snd_sof_bytes_ext_get(struct snd_kcontrol *kcontrol,
147 unsigned int __user *binary_data,
148 unsigned int size);
149int snd_sof_bytes_ext_volatile_get(struct snd_kcontrol *kcontrol, unsigned int __user *binary_data,
150 unsigned int size);
151
152/*
153 * Topology.
154 * There is no snd_sof_free_topology since topology components will
155 * be freed by snd_soc_unregister_component,
156 */
157int snd_sof_load_topology(struct snd_soc_component *scomp, const char *file);
158int snd_sof_complete_pipeline(struct device *dev,
159 struct snd_sof_widget *swidget);
160
161int sof_load_pipeline_ipc(struct device *dev,
162 struct sof_ipc_pipe_new *pipeline,
163 struct sof_ipc_comp_reply *r);
164int sof_pipeline_core_enable(struct snd_sof_dev *sdev,
165 const struct snd_sof_widget *swidget);
166
167/*
168 * Stream IPC
169 */
170int snd_sof_ipc_stream_posn(struct snd_soc_component *scomp,
171 struct snd_sof_pcm *spcm, int direction,
172 struct sof_ipc_stream_posn *posn);
173
174struct snd_sof_widget *snd_sof_find_swidget(struct snd_soc_component *scomp,
175 const char *name);
176struct snd_sof_widget *
177snd_sof_find_swidget_sname(struct snd_soc_component *scomp,
178 const char *pcm_name, int dir);
179struct snd_sof_dai *snd_sof_find_dai(struct snd_soc_component *scomp,
180 const char *name);
181
182static inline
183struct snd_sof_pcm *snd_sof_find_spcm_dai(struct snd_soc_component *scomp,
184 struct snd_soc_pcm_runtime *rtd)
185{
186 struct snd_sof_dev *sdev = snd_soc_component_get_drvdata(scomp);
187
188 struct snd_sof_pcm *spcm = NULL;
189
190 list_for_each_entry(spcm, &sdev->pcm_list, list) {
191 if (le32_to_cpu(spcm->pcm.dai_id) == rtd->dai_link->id)
192 return spcm;
193 }
194
195 return NULL;
196}
197
198struct snd_sof_pcm *snd_sof_find_spcm_name(struct snd_soc_component *scomp,
199 const char *name);
200struct snd_sof_pcm *snd_sof_find_spcm_comp(struct snd_soc_component *scomp,
201 unsigned int comp_id,
202 int *direction);
203struct snd_sof_pcm *snd_sof_find_spcm_pcm_id(struct snd_soc_component *scomp,
204 unsigned int pcm_id);
205const struct sof_ipc_pipe_new *snd_sof_pipeline_find(struct snd_sof_dev *sdev,
206 int pipeline_id);
207void snd_sof_pcm_period_elapsed(struct snd_pcm_substream *substream);
208void snd_sof_pcm_period_elapsed_work(struct work_struct *work);
209
210/*
211 * Mixer IPC
212 */
213int snd_sof_ipc_set_get_comp_data(struct snd_sof_control *scontrol,
214 u32 ipc_cmd,
215 enum sof_ipc_ctrl_type ctrl_type,
216 enum sof_ipc_ctrl_cmd ctrl_cmd,
217 bool send);
218
219/* DAI link fixup */
220int sof_pcm_dai_link_fixup(struct snd_soc_pcm_runtime *rtd, struct snd_pcm_hw_params *params);
221
222/* PM */
223int sof_restore_pipelines(struct device *dev);
224int sof_set_hw_params_upon_resume(struct device *dev);
225bool snd_sof_stream_suspend_ignored(struct snd_sof_dev *sdev);
226bool snd_sof_dsp_only_d0i3_compatible_stream_active(struct snd_sof_dev *sdev);
227
228/* Machine driver enumeration */
229int sof_machine_register(struct snd_sof_dev *sdev, void *pdata);
230void sof_machine_unregister(struct snd_sof_dev *sdev, void *pdata);
231
232#endif