1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
2 /*
3  * skl-tplg-interface.h - Intel DSP FW private data interface
4  *
5  * Copyright (C) 2015 Intel Corp
6  * Author: Jeeja KP <jeeja.kp@intel.com>
7  *	    Nilofer, Samreen <samreen.nilofer@intel.com>
8  */
9 
10 #ifndef __HDA_TPLG_INTERFACE_H__
11 #define __HDA_TPLG_INTERFACE_H__
12 
13 #include <linux/types.h>
14 
15 /*
16  * Default types range from 0~12. type can range from 0 to 0xff
17  * SST types start at higher to avoid any overlapping in future
18  */
19 #define SKL_CONTROL_TYPE_BYTE_TLV	0x100
20 #define SKL_CONTROL_TYPE_MIC_SELECT	0x102
21 #define SKL_CONTROL_TYPE_MULTI_IO_SELECT	0x103
22 #define SKL_CONTROL_TYPE_MULTI_IO_SELECT_DMIC	0x104
23 
24 #define HDA_SST_CFG_MAX	900 /* size of copier cfg*/
25 #define MAX_IN_QUEUE 8
26 #define MAX_OUT_QUEUE 8
27 
28 #define SKL_UUID_STR_SZ 40
29 /* Event types goes here */
30 /* Reserve event type 0 for no event handlers */
31 enum skl_event_types {
32 	SKL_EVENT_NONE = 0,
33 	SKL_MIXER_EVENT,
34 	SKL_MUX_EVENT,
35 	SKL_VMIXER_EVENT,
36 	SKL_PGA_EVENT
37 };
38 
39 /**
40  * enum skl_ch_cfg - channel configuration
41  *
42  * @SKL_CH_CFG_MONO:	One channel only
43  * @SKL_CH_CFG_STEREO:	L & R
44  * @SKL_CH_CFG_2_1:	L, R & LFE
45  * @SKL_CH_CFG_3_0:	L, C & R
46  * @SKL_CH_CFG_3_1:	L, C, R & LFE
47  * @SKL_CH_CFG_QUATRO:	L, R, Ls & Rs
48  * @SKL_CH_CFG_4_0:	L, C, R & Cs
49  * @SKL_CH_CFG_5_0:	L, C, R, Ls & Rs
50  * @SKL_CH_CFG_5_1:	L, C, R, Ls, Rs & LFE
51  * @SKL_CH_CFG_DUAL_MONO: One channel replicated in two
52  * @SKL_CH_CFG_I2S_DUAL_STEREO_0: Stereo(L,R) in 4 slots, 1st stream:[ L, R, -, - ]
53  * @SKL_CH_CFG_I2S_DUAL_STEREO_1: Stereo(L,R) in 4 slots, 2nd stream:[ -, -, L, R ]
54  * @SKL_CH_CFG_INVALID:	Invalid
55  */
56 enum skl_ch_cfg {
57 	SKL_CH_CFG_MONO = 0,
58 	SKL_CH_CFG_STEREO = 1,
59 	SKL_CH_CFG_2_1 = 2,
60 	SKL_CH_CFG_3_0 = 3,
61 	SKL_CH_CFG_3_1 = 4,
62 	SKL_CH_CFG_QUATRO = 5,
63 	SKL_CH_CFG_4_0 = 6,
64 	SKL_CH_CFG_5_0 = 7,
65 	SKL_CH_CFG_5_1 = 8,
66 	SKL_CH_CFG_DUAL_MONO = 9,
67 	SKL_CH_CFG_I2S_DUAL_STEREO_0 = 10,
68 	SKL_CH_CFG_I2S_DUAL_STEREO_1 = 11,
69 	SKL_CH_CFG_4_CHANNEL = 12,
70 	SKL_CH_CFG_INVALID
71 };
72 
73 enum skl_module_type {
74 	SKL_MODULE_TYPE_MIXER = 0,
75 	SKL_MODULE_TYPE_COPIER,
76 	SKL_MODULE_TYPE_UPDWMIX,
77 	SKL_MODULE_TYPE_SRCINT,
78 	SKL_MODULE_TYPE_ALGO,
79 	SKL_MODULE_TYPE_BASE_OUTFMT,
80 	SKL_MODULE_TYPE_KPB,
81 	SKL_MODULE_TYPE_MIC_SELECT,
82 };
83 
84 enum skl_core_affinity {
85 	SKL_AFFINITY_CORE_0 = 0,
86 	SKL_AFFINITY_CORE_1,
87 	SKL_AFFINITY_CORE_MAX
88 };
89 
90 enum skl_pipe_conn_type {
91 	SKL_PIPE_CONN_TYPE_NONE = 0,
92 	SKL_PIPE_CONN_TYPE_FE,
93 	SKL_PIPE_CONN_TYPE_BE
94 };
95 
96 enum skl_hw_conn_type {
97 	SKL_CONN_NONE = 0,
98 	SKL_CONN_SOURCE = 1,
99 	SKL_CONN_SINK = 2
100 };
101 
102 enum skl_dev_type {
103 	SKL_DEVICE_BT = 0x0,
104 	SKL_DEVICE_DMIC = 0x1,
105 	SKL_DEVICE_I2S = 0x2,
106 	SKL_DEVICE_SLIMBUS = 0x3,
107 	SKL_DEVICE_HDALINK = 0x4,
108 	SKL_DEVICE_HDAHOST = 0x5,
109 	SKL_DEVICE_NONE
110 };
111 
112 /**
113  * enum skl_interleaving - interleaving style
114  *
115  * @SKL_INTERLEAVING_PER_CHANNEL: [s1_ch1...s1_chN,...,sM_ch1...sM_chN]
116  * @SKL_INTERLEAVING_PER_SAMPLE: [s1_ch1...sM_ch1,...,s1_chN...sM_chN]
117  */
118 enum skl_interleaving {
119 	SKL_INTERLEAVING_PER_CHANNEL = 0,
120 	SKL_INTERLEAVING_PER_SAMPLE = 1,
121 };
122 
123 enum skl_sample_type {
124 	SKL_SAMPLE_TYPE_INT_MSB = 0,
125 	SKL_SAMPLE_TYPE_INT_LSB = 1,
126 	SKL_SAMPLE_TYPE_INT_SIGNED = 2,
127 	SKL_SAMPLE_TYPE_INT_UNSIGNED = 3,
128 	SKL_SAMPLE_TYPE_FLOAT = 4
129 };
130 
131 enum module_pin_type {
132 	/* All pins of the module takes same PCM inputs or outputs
133 	* e.g. mixout
134 	*/
135 	SKL_PIN_TYPE_HOMOGENEOUS,
136 	/* All pins of the module takes different PCM inputs or outputs
137 	* e.g mux
138 	*/
139 	SKL_PIN_TYPE_HETEROGENEOUS,
140 };
141 
142 enum skl_module_param_type {
143 	SKL_PARAM_DEFAULT = 0,
144 	SKL_PARAM_INIT,
145 	SKL_PARAM_SET,
146 	SKL_PARAM_BIND
147 };
148 
149 struct skl_dfw_algo_data {
150 	uint32_t set_params:2;
151 	uint32_t rsvd:30;
152 	uint32_t param_id;
153 	uint32_t max;
154 	char params[0];
155 } __packed;
156 
157 enum skl_tkn_dir {
158 	SKL_DIR_IN,
159 	SKL_DIR_OUT
160 };
161 
162 enum skl_tuple_type {
163 	SKL_TYPE_TUPLE,
164 	SKL_TYPE_DATA
165 };
166 
167 /* v4 configuration data */
168 
169 struct skl_dfw_v4_module_pin {
170 	uint16_t module_id;
171 	uint16_t instance_id;
172 } __packed;
173 
174 struct skl_dfw_v4_module_fmt {
175 	uint32_t channels;
176 	uint32_t freq;
177 	uint32_t bit_depth;
178 	uint32_t valid_bit_depth;
179 	uint32_t ch_cfg;
180 	uint32_t interleaving_style;
181 	uint32_t sample_type;
182 	uint32_t ch_map;
183 } __packed;
184 
185 struct skl_dfw_v4_module_caps {
186 	uint32_t set_params:2;
187 	uint32_t rsvd:30;
188 	uint32_t param_id;
189 	uint32_t caps_size;
190 	uint32_t caps[HDA_SST_CFG_MAX];
191 } __packed;
192 
193 struct skl_dfw_v4_pipe {
194 	uint8_t pipe_id;
195 	uint8_t pipe_priority;
196 	uint16_t conn_type:4;
197 	uint16_t rsvd:4;
198 	uint16_t memory_pages:8;
199 } __packed;
200 
201 struct skl_dfw_v4_module {
202 	char uuid[SKL_UUID_STR_SZ];
203 
204 	uint16_t module_id;
205 	uint16_t instance_id;
206 	uint32_t max_mcps;
207 	uint32_t mem_pages;
208 	uint32_t obs;
209 	uint32_t ibs;
210 	uint32_t vbus_id;
211 
212 	uint32_t max_in_queue:8;
213 	uint32_t max_out_queue:8;
214 	uint32_t time_slot:8;
215 	uint32_t core_id:4;
216 	uint32_t rsvd1:4;
217 
218 	uint32_t module_type:8;
219 	uint32_t conn_type:4;
220 	uint32_t dev_type:4;
221 	uint32_t hw_conn_type:4;
222 	uint32_t rsvd2:12;
223 
224 	uint32_t params_fixup:8;
225 	uint32_t converter:8;
226 	uint32_t input_pin_type:1;
227 	uint32_t output_pin_type:1;
228 	uint32_t is_dynamic_in_pin:1;
229 	uint32_t is_dynamic_out_pin:1;
230 	uint32_t is_loadable:1;
231 	uint32_t rsvd3:11;
232 
233 	struct skl_dfw_v4_pipe pipe;
234 	struct skl_dfw_v4_module_fmt in_fmt[MAX_IN_QUEUE];
235 	struct skl_dfw_v4_module_fmt out_fmt[MAX_OUT_QUEUE];
236 	struct skl_dfw_v4_module_pin in_pin[MAX_IN_QUEUE];
237 	struct skl_dfw_v4_module_pin out_pin[MAX_OUT_QUEUE];
238 	struct skl_dfw_v4_module_caps caps;
239 } __packed;
240 
241 #endif
242