Commit | Line | Data |
---|---|---|
719f82d3 EB |
1 | /****************************************************************************** |
2 | ||
3 | AudioScience HPI driver | |
509a7147 | 4 | Copyright (C) 1997-2011 AudioScience Inc. <support@audioscience.com> |
719f82d3 EB |
5 | |
6 | This program is free software; you can redistribute it and/or modify | |
7 | it under the terms of version 2 of the GNU General Public License as | |
8 | published by the Free Software Foundation; | |
9 | ||
10 | This program is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
13 | GNU General Public License for more details. | |
14 | ||
15 | You should have received a copy of the GNU General Public License | |
16 | along with this program; if not, write to the Free Software | |
17 | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA | |
18 | ||
19 | */ | |
20 | /** \file hpi.h | |
21 | ||
22 | AudioScience Hardware Programming Interface (HPI) | |
23 | public API definition. | |
24 | ||
25 | The HPI is a low-level hardware abstraction layer to all | |
26 | AudioScience digital audio adapters | |
719f82d3 EB |
27 | |
28 | (C) Copyright AudioScience Inc. 1998-2010 | |
ba94455c EB |
29 | */ |
30 | ||
719f82d3 EB |
31 | #ifndef _HPI_H_ |
32 | #define _HPI_H_ | |
719f82d3 EB |
33 | |
34 | #include <linux/types.h> | |
a287ca2a | 35 | #define HPI_BUILD_KERNEL_MODE |
719f82d3 | 36 | |
719f82d3 EB |
37 | /******************************************************************************/ |
38 | /******** HPI API DEFINITIONS *****/ | |
39 | /******************************************************************************/ | |
ad210ad1 | 40 | |
719f82d3 EB |
41 | /*******************************************/ |
42 | /** Audio format types | |
43 | \ingroup stream | |
44 | */ | |
45 | enum HPI_FORMATS { | |
46 | /** Used internally on adapter. */ | |
47 | HPI_FORMAT_MIXER_NATIVE = 0, | |
48 | /** 8-bit unsigned PCM. Windows equivalent is WAVE_FORMAT_PCM. */ | |
49 | HPI_FORMAT_PCM8_UNSIGNED = 1, | |
50 | /** 16-bit signed PCM. Windows equivalent is WAVE_FORMAT_PCM. */ | |
51 | HPI_FORMAT_PCM16_SIGNED = 2, | |
52 | /** MPEG-1 Layer-1. */ | |
53 | HPI_FORMAT_MPEG_L1 = 3, | |
54 | /** MPEG-1 Layer-2. | |
55 | ||
56 | Windows equivalent is WAVE_FORMAT_MPEG. | |
57 | ||
58 | The following table shows what combinations of mode and bitrate are possible: | |
59 | ||
60 | <table border=1 cellspacing=0 cellpadding=5> | |
61 | <tr> | |
62 | <td><p><b>Bitrate (kbs)</b></p> | |
63 | <td><p><b>Mono</b></p> | |
64 | <td><p><b>Stereo,<br>Joint Stereo or<br>Dual Channel</b></p> | |
65 | ||
66 | <tr><td>32<td>X<td>_ | |
67 | <tr><td>40<td>_<td>_ | |
68 | <tr><td>48<td>X<td>_ | |
69 | <tr><td>56<td>X<td>_ | |
70 | <tr><td>64<td>X<td>X | |
71 | <tr><td>80<td>X<td>_ | |
72 | <tr><td>96<td>X<td>X | |
73 | <tr><td>112<td>X<td>X | |
74 | <tr><td>128<td>X<td>X | |
75 | <tr><td>160<td>X<td>X | |
76 | <tr><td>192<td>X<td>X | |
77 | <tr><td>224<td>_<td>X | |
78 | <tr><td>256<td>-<td>X | |
79 | <tr><td>320<td>-<td>X | |
80 | <tr><td>384<td>_<td>X | |
81 | </table> | |
82 | */ | |
83 | HPI_FORMAT_MPEG_L2 = 4, | |
84 | /** MPEG-1 Layer-3. | |
85 | Windows equivalent is WAVE_FORMAT_MPEG. | |
86 | ||
87 | The following table shows what combinations of mode and bitrate are possible: | |
88 | ||
89 | <table border=1 cellspacing=0 cellpadding=5> | |
90 | <tr> | |
91 | <td><p><b>Bitrate (kbs)</b></p> | |
92 | <td><p><b>Mono<br>Stereo @ 8,<br>11.025 and<br>12kHz*</b></p> | |
93 | <td><p><b>Mono<br>Stereo @ 16,<br>22.050 and<br>24kHz*</b></p> | |
94 | <td><p><b>Mono<br>Stereo @ 32,<br>44.1 and<br>48kHz</b></p> | |
95 | ||
96 | <tr><td>16<td>X<td>X<td>_ | |
97 | <tr><td>24<td>X<td>X<td>_ | |
98 | <tr><td>32<td>X<td>X<td>X | |
99 | <tr><td>40<td>X<td>X<td>X | |
100 | <tr><td>48<td>X<td>X<td>X | |
101 | <tr><td>56<td>X<td>X<td>X | |
102 | <tr><td>64<td>X<td>X<td>X | |
103 | <tr><td>80<td>_<td>X<td>X | |
104 | <tr><td>96<td>_<td>X<td>X | |
105 | <tr><td>112<td>_<td>X<td>X | |
106 | <tr><td>128<td>_<td>X<td>X | |
107 | <tr><td>144<td>_<td>X<td>_ | |
108 | <tr><td>160<td>_<td>X<td>X | |
109 | <tr><td>192<td>_<td>_<td>X | |
110 | <tr><td>224<td>_<td>_<td>X | |
111 | <tr><td>256<td>-<td>_<td>X | |
112 | <tr><td>320<td>-<td>_<td>X | |
113 | </table> | |
114 | \b * Available on the ASI6000 series only | |
115 | */ | |
116 | HPI_FORMAT_MPEG_L3 = 5, | |
117 | /** Dolby AC-2. */ | |
118 | HPI_FORMAT_DOLBY_AC2 = 6, | |
119 | /** Dolbt AC-3. */ | |
120 | HPI_FORMAT_DOLBY_AC3 = 7, | |
121 | /** 16-bit PCM big-endian. */ | |
122 | HPI_FORMAT_PCM16_BIGENDIAN = 8, | |
123 | /** TAGIT-1 algorithm - hits. */ | |
124 | HPI_FORMAT_AA_TAGIT1_HITS = 9, | |
125 | /** TAGIT-1 algorithm - inserts. */ | |
126 | HPI_FORMAT_AA_TAGIT1_INSERTS = 10, | |
127 | /** 32-bit signed PCM. Windows equivalent is WAVE_FORMAT_PCM. | |
128 | Each sample is a 32bit word. The most significant 24 bits contain a 24-bit | |
129 | sample and the least significant 8 bits are set to 0. | |
130 | */ | |
131 | HPI_FORMAT_PCM32_SIGNED = 11, | |
132 | /** Raw bitstream - unknown format. */ | |
133 | HPI_FORMAT_RAW_BITSTREAM = 12, | |
134 | /** TAGIT-1 algorithm hits - extended. */ | |
135 | HPI_FORMAT_AA_TAGIT1_HITS_EX1 = 13, | |
136 | /** 32-bit PCM as an IEEE float. Windows equivalent is WAVE_FORMAT_IEEE_FLOAT. | |
137 | Each sample is a 32bit word in IEEE754 floating point format. | |
138 | The range is +1.0 to -1.0, which corresponds to digital fullscale. | |
139 | */ | |
140 | HPI_FORMAT_PCM32_FLOAT = 14, | |
141 | /** 24-bit PCM signed. Windows equivalent is WAVE_FORMAT_PCM. */ | |
142 | HPI_FORMAT_PCM24_SIGNED = 15, | |
143 | /** OEM format 1 - private. */ | |
144 | HPI_FORMAT_OEM1 = 16, | |
145 | /** OEM format 2 - private. */ | |
146 | HPI_FORMAT_OEM2 = 17, | |
147 | /** Undefined format. */ | |
148 | HPI_FORMAT_UNDEFINED = 0xffff | |
149 | }; | |
150 | ||
719f82d3 EB |
151 | /*******************************************/ |
152 | /** Stream States | |
153 | \ingroup stream | |
154 | */ | |
155 | enum HPI_STREAM_STATES { | |
156 | /** State stopped - stream is stopped. */ | |
157 | HPI_STATE_STOPPED = 1, | |
158 | /** State playing - stream is playing audio. */ | |
159 | HPI_STATE_PLAYING = 2, | |
160 | /** State recording - stream is recording. */ | |
161 | HPI_STATE_RECORDING = 3, | |
162 | /** State drained - playing stream ran out of data to play. */ | |
163 | HPI_STATE_DRAINED = 4, | |
164 | /** State generate sine - to be implemented. */ | |
165 | HPI_STATE_SINEGEN = 5, | |
166 | /** State wait - used for inter-card sync to mean waiting for all | |
167 | cards to be ready. */ | |
168 | HPI_STATE_WAIT = 6 | |
169 | }; | |
ba94455c | 170 | /*******************************************/ |
719f82d3 EB |
171 | /** Source node types |
172 | \ingroup mixer | |
173 | */ | |
174 | enum HPI_SOURCENODES { | |
175 | /** This define can be used instead of 0 to indicate | |
176 | that there is no valid source node. A control that | |
177 | exists on a destination node can be searched for using a source | |
178 | node value of either 0, or HPI_SOURCENODE_NONE */ | |
179 | HPI_SOURCENODE_NONE = 100, | |
719f82d3 EB |
180 | /** Out Stream (Play) node. */ |
181 | HPI_SOURCENODE_OSTREAM = 101, | |
182 | /** Line in node - could be analog, AES/EBU or network. */ | |
183 | HPI_SOURCENODE_LINEIN = 102, | |
184 | HPI_SOURCENODE_AESEBU_IN = 103, /**< AES/EBU input node. */ | |
185 | HPI_SOURCENODE_TUNER = 104, /**< tuner node. */ | |
186 | HPI_SOURCENODE_RF = 105, /**< RF input node. */ | |
187 | HPI_SOURCENODE_CLOCK_SOURCE = 106, /**< clock source node. */ | |
188 | HPI_SOURCENODE_RAW_BITSTREAM = 107, /**< raw bitstream node. */ | |
189 | HPI_SOURCENODE_MICROPHONE = 108, /**< microphone node. */ | |
190 | /** Cobranet input node - | |
191 | Audio samples come from the Cobranet network and into the device. */ | |
192 | HPI_SOURCENODE_COBRANET = 109, | |
193 | HPI_SOURCENODE_ANALOG = 110, /**< analog input node. */ | |
194 | HPI_SOURCENODE_ADAPTER = 111, /**< adapter node. */ | |
b7f12482 EB |
195 | /** RTP stream input node - This node is a destination for |
196 | packets of RTP audio samples from other devices. */ | |
197 | HPI_SOURCENODE_RTP_DESTINATION = 112, | |
502f271a | 198 | HPI_SOURCENODE_INTERNAL = 113, /**< node internal to the device. */ |
3872f19d EB |
199 | HPI_SOURCENODE_AVB = 114, /**< AVB input stream */ |
200 | HPI_SOURCENODE_BLULINK = 115, /**< BLU-link input channel */ | |
719f82d3 | 201 | /* !!!Update this AND hpidebug.h if you add a new sourcenode type!!! */ |
3872f19d | 202 | HPI_SOURCENODE_LAST_INDEX = 115 /**< largest ID */ |
719f82d3 EB |
203 | /* AX6 max sourcenode types = 15 */ |
204 | }; | |
205 | ||
ba94455c | 206 | /*******************************************/ |
719f82d3 EB |
207 | /** Destination node types |
208 | \ingroup mixer | |
209 | */ | |
210 | enum HPI_DESTNODES { | |
211 | /** This define can be used instead of 0 to indicate | |
212 | that there is no valid destination node. A control that | |
213 | exists on a source node can be searched for using a destination | |
214 | node value of either 0, or HPI_DESTNODE_NONE */ | |
215 | HPI_DESTNODE_NONE = 200, | |
719f82d3 EB |
216 | /** In Stream (Record) node. */ |
217 | HPI_DESTNODE_ISTREAM = 201, | |
b7f12482 | 218 | HPI_DESTNODE_LINEOUT = 202, /**< line out node. */ |
719f82d3 EB |
219 | HPI_DESTNODE_AESEBU_OUT = 203, /**< AES/EBU output node. */ |
220 | HPI_DESTNODE_RF = 204, /**< RF output node. */ | |
221 | HPI_DESTNODE_SPEAKER = 205, /**< speaker output node. */ | |
222 | /** Cobranet output node - | |
223 | Audio samples from the device are sent out on the Cobranet network.*/ | |
224 | HPI_DESTNODE_COBRANET = 206, | |
225 | HPI_DESTNODE_ANALOG = 207, /**< analog output node. */ | |
b7f12482 EB |
226 | /** RTP stream output node - This node is a source for |
227 | packets of RTP audio samples that are sent to other devices. */ | |
228 | HPI_DESTNODE_RTP_SOURCE = 208, | |
3872f19d EB |
229 | HPI_DESTNODE_AVB = 209, /**< AVB output stream */ |
230 | HPI_DESTNODE_INTERNAL = 210, /**< node internal to the device. */ | |
231 | HPI_DESTNODE_BLULINK = 211, /**< BLU-link output channel. */ | |
719f82d3 | 232 | /* !!!Update this AND hpidebug.h if you add a new destnode type!!! */ |
3872f19d | 233 | HPI_DESTNODE_LAST_INDEX = 211 /**< largest ID */ |
719f82d3 EB |
234 | /* AX6 max destnode types = 15 */ |
235 | }; | |
236 | ||
237 | /*******************************************/ | |
238 | /** Mixer control types | |
239 | \ingroup mixer | |
240 | */ | |
241 | enum HPI_CONTROLS { | |
242 | HPI_CONTROL_GENERIC = 0, /**< generic control. */ | |
243 | HPI_CONTROL_CONNECTION = 1, /**< A connection between nodes. */ | |
244 | HPI_CONTROL_VOLUME = 2, /**< volume control - works in dB_fs. */ | |
245 | HPI_CONTROL_METER = 3, /**< peak meter control. */ | |
246 | HPI_CONTROL_MUTE = 4, /*mute control - not used at present. */ | |
247 | HPI_CONTROL_MULTIPLEXER = 5, /**< multiplexer control. */ | |
248 | ||
ba94455c | 249 | HPI_CONTROL_AESEBU_TRANSMITTER = 6, /**< AES/EBU transmitter control */ |
ad210ad1 | 250 | HPI_CONTROL_AESEBUTX = 6, /* HPI_CONTROL_AESEBU_TRANSMITTER */ |
719f82d3 EB |
251 | |
252 | HPI_CONTROL_AESEBU_RECEIVER = 7, /**< AES/EBU receiver control. */ | |
ad210ad1 | 253 | HPI_CONTROL_AESEBURX = 7, /* HPI_CONTROL_AESEBU_RECEIVER */ |
719f82d3 EB |
254 | |
255 | HPI_CONTROL_LEVEL = 8, /**< level/trim control - works in d_bu. */ | |
256 | HPI_CONTROL_TUNER = 9, /**< tuner control. */ | |
257 | /* HPI_CONTROL_ONOFFSWITCH = 10 */ | |
258 | HPI_CONTROL_VOX = 11, /**< vox control. */ | |
259 | /* HPI_CONTROL_AES18_TRANSMITTER = 12 */ | |
260 | /* HPI_CONTROL_AES18_RECEIVER = 13 */ | |
261 | /* HPI_CONTROL_AES18_BLOCKGENERATOR = 14 */ | |
262 | HPI_CONTROL_CHANNEL_MODE = 15, /**< channel mode control. */ | |
263 | ||
264 | HPI_CONTROL_BITSTREAM = 16, /**< bitstream control. */ | |
265 | HPI_CONTROL_SAMPLECLOCK = 17, /**< sample clock control. */ | |
266 | HPI_CONTROL_MICROPHONE = 18, /**< microphone control. */ | |
267 | HPI_CONTROL_PARAMETRIC_EQ = 19, /**< parametric EQ control. */ | |
ad210ad1 | 268 | HPI_CONTROL_EQUALIZER = 19, /*HPI_CONTROL_PARAMETRIC_EQ */ |
719f82d3 EB |
269 | |
270 | HPI_CONTROL_COMPANDER = 20, /**< compander control. */ | |
271 | HPI_CONTROL_COBRANET = 21, /**< cobranet control. */ | |
272 | HPI_CONTROL_TONEDETECTOR = 22, /**< tone detector control. */ | |
273 | HPI_CONTROL_SILENCEDETECTOR = 23, /**< silence detector control. */ | |
274 | HPI_CONTROL_PAD = 24, /**< tuner PAD control. */ | |
275 | HPI_CONTROL_SRC = 25, /**< samplerate converter control. */ | |
276 | HPI_CONTROL_UNIVERSAL = 26, /**< universal control. */ | |
277 | ||
278 | /* !!! Update this AND hpidebug.h if you add a new control type!!!*/ | |
279 | HPI_CONTROL_LAST_INDEX = 26 /**<highest control type ID */ | |
280 | /* WARNING types 256 or greater impact bit packing in all AX6 DSP code */ | |
281 | }; | |
282 | ||
ba94455c | 283 | /*******************************************/ |
719f82d3 EB |
284 | /** Adapter properties |
285 | These are used in HPI_AdapterSetProperty() and HPI_AdapterGetProperty() | |
286 | \ingroup adapter | |
287 | */ | |
288 | enum HPI_ADAPTER_PROPERTIES { | |
289 | /** \internal Used in dwProperty field of HPI_AdapterSetProperty() and | |
290 | HPI_AdapterGetProperty(). This errata applies to all ASI6000 cards with both | |
291 | analog and digital outputs. The CS4224 A/D+D/A has a one sample delay between | |
292 | left and right channels on both its input (ADC) and output (DAC). | |
293 | More details are available in Cirrus Logic errata ER284B2. | |
294 | PDF available from www.cirrus.com, released by Cirrus in 2001. | |
295 | */ | |
296 | HPI_ADAPTER_PROPERTY_ERRATA_1 = 1, | |
297 | ||
298 | /** Adapter grouping property | |
299 | Indicates whether the adapter supports the grouping API (for ASIO and SSX2) | |
300 | */ | |
301 | HPI_ADAPTER_PROPERTY_GROUPING = 2, | |
302 | ||
303 | /** Driver SSX2 property | |
304 | Tells the kernel driver to turn on SSX2 stream mapping. | |
305 | This feature is not used by the DSP. In fact the call is completely processed | |
306 | by the driver and is not passed on to the DSP at all. | |
307 | */ | |
308 | HPI_ADAPTER_PROPERTY_ENABLE_SSX2 = 3, | |
309 | ||
310 | /** Adapter SSX2 property | |
311 | Indicates the state of the adapter's SSX2 setting. This setting is stored in | |
312 | non-volatile memory on the adapter. A typical call sequence would be to use | |
313 | HPI_ADAPTER_PROPERTY_SSX2_SETTING to set SSX2 on the adapter and then to reload | |
ba94455c EB |
314 | the driver. The driver would query HPI_ADAPTER_PROPERTY_SSX2_SETTING during |
315 | startup and if SSX2 is set, it would then call HPI_ADAPTER_PROPERTY_ENABLE_SSX2 | |
316 | to enable SSX2 stream mapping within the kernel level of the driver. | |
719f82d3 EB |
317 | */ |
318 | HPI_ADAPTER_PROPERTY_SSX2_SETTING = 4, | |
319 | ||
bd33c1ca EB |
320 | /** Enables/disables PCI(e) IRQ. |
321 | A setting of 0 indicates that no interrupts are being generated. A DSP boot | |
322 | this property is set to 0. Setting to a non-zero value specifies the number | |
323 | of frames of audio that should be processed between interrupts. This property | |
324 | should be set to multiple of the mixer interval as read back from the | |
325 | HPI_ADAPTER_PROPERTY_INTERVAL property. | |
326 | */ | |
327 | HPI_ADAPTER_PROPERTY_IRQ_RATE = 5, | |
328 | ||
719f82d3 EB |
329 | /** Base number for readonly properties */ |
330 | HPI_ADAPTER_PROPERTY_READONLYBASE = 256, | |
331 | ||
332 | /** Readonly adapter latency property. | |
333 | This property returns in the input and output latency in samples. | |
334 | Property 1 is the estimated input latency | |
335 | in samples, while Property 2 is that output latency in samples. | |
336 | */ | |
337 | HPI_ADAPTER_PROPERTY_LATENCY = 256, | |
338 | ||
339 | /** Readonly adapter granularity property. | |
340 | The granulariy is the smallest size chunk of stereo samples that is processed by | |
341 | the adapter. | |
342 | This property returns the record granularity in samples in Property 1. | |
343 | Property 2 returns the play granularity. | |
344 | */ | |
345 | HPI_ADAPTER_PROPERTY_GRANULARITY = 257, | |
346 | ||
347 | /** Readonly adapter number of current channels property. | |
348 | Property 1 is the number of record channels per record device. | |
349 | Property 2 is the number of play channels per playback device.*/ | |
350 | HPI_ADAPTER_PROPERTY_CURCHANNELS = 258, | |
351 | ||
352 | /** Readonly adapter software version. | |
353 | The SOFTWARE_VERSION property returns the version of the software running | |
354 | on the adapter as Major.Minor.Release. | |
355 | Property 1 contains Major in bits 15..8 and Minor in bits 7..0. | |
356 | Property 2 contains Release in bits 7..0. */ | |
357 | HPI_ADAPTER_PROPERTY_SOFTWARE_VERSION = 259, | |
358 | ||
359 | /** Readonly adapter MAC address MSBs. | |
360 | The MAC_ADDRESS_MSB property returns | |
361 | the most significant 32 bits of the MAC address. | |
362 | Property 1 contains bits 47..32 of the MAC address. | |
363 | Property 2 contains bits 31..16 of the MAC address. */ | |
364 | HPI_ADAPTER_PROPERTY_MAC_ADDRESS_MSB = 260, | |
365 | ||
366 | /** Readonly adapter MAC address LSBs | |
367 | The MAC_ADDRESS_LSB property returns | |
368 | the least significant 16 bits of the MAC address. | |
369 | Property 1 contains bits 15..0 of the MAC address. */ | |
370 | HPI_ADAPTER_PROPERTY_MAC_ADDRESS_LSB = 261, | |
371 | ||
372 | /** Readonly extended adapter type number | |
373 | The EXTENDED_ADAPTER_TYPE property returns the 4 digits of an extended | |
374 | adapter type, i.e ASI8920-0022, 0022 is the extended type. | |
375 | The digits are returned as ASCII characters rather than the hex digits that | |
376 | are returned for the main type | |
377 | Property 1 returns the 1st two (left most) digits, i.e "00" | |
378 | in the example above, the upper byte being the left most digit. | |
379 | Property 2 returns the 2nd two digits, i.e "22" in the example above*/ | |
380 | HPI_ADAPTER_PROPERTY_EXTENDED_ADAPTER_TYPE = 262, | |
381 | ||
382 | /** Readonly debug log buffer information */ | |
383 | HPI_ADAPTER_PROPERTY_LOGTABLEN = 263, | |
384 | HPI_ADAPTER_PROPERTY_LOGTABBEG = 264, | |
385 | ||
386 | /** Readonly adapter IP address | |
387 | For 192.168.1.101 | |
388 | Property 1 returns the 1st two (left most) digits, i.e 192*256 + 168 | |
389 | in the example above, the upper byte being the left most digit. | |
390 | Property 2 returns the 2nd two digits, i.e 1*256 + 101 in the example above, */ | |
391 | HPI_ADAPTER_PROPERTY_IP_ADDRESS = 265, | |
392 | ||
393 | /** Readonly adapter buffer processed count. Returns a buffer processed count | |
394 | that is incremented every time all buffers for all streams are updated. This | |
395 | is useful for checking completion of all stream operations across the adapter | |
396 | when using grouped streams. | |
397 | */ | |
398 | HPI_ADAPTER_PROPERTY_BUFFER_UPDATE_COUNT = 266, | |
399 | ||
400 | /** Readonly mixer and stream intervals | |
401 | ||
402 | These intervals are measured in mixer frames. | |
403 | To convert to time, divide by the adapter samplerate. | |
404 | ||
405 | The mixer interval is the number of frames processed in one mixer iteration. | |
406 | The stream update interval is the interval at which streams check for and | |
407 | process data, and BBM host buffer counters are updated. | |
408 | ||
409 | Property 1 is the mixer interval in mixer frames. | |
410 | Property 2 is the stream update interval in mixer frames. | |
411 | */ | |
412 | HPI_ADAPTER_PROPERTY_INTERVAL = 267, | |
413 | /** Adapter capabilities 1 | |
414 | Property 1 - adapter can do multichannel (SSX1) | |
415 | Property 2 - adapter can do stream grouping (supports SSX2) | |
416 | */ | |
417 | HPI_ADAPTER_PROPERTY_CAPS1 = 268, | |
418 | /** Adapter capabilities 2 | |
419 | Property 1 - adapter can do samplerate conversion (MRX) | |
420 | Property 2 - adapter can do timestretch (TSX) | |
421 | */ | |
168f1b07 EB |
422 | HPI_ADAPTER_PROPERTY_CAPS2 = 269, |
423 | ||
424 | /** Readonly adapter sync header connection count. | |
425 | */ | |
426 | HPI_ADAPTER_PROPERTY_SYNC_HEADER_CONNECTIONS = 270, | |
427 | /** Readonly supports SSX2 property. | |
428 | Indicates the adapter supports SSX2 in some mode setting. The | |
429 | return value is true (1) or false (0). If the current adapter | |
430 | mode is MONO SSX2 is disabled, even though this property will | |
431 | return true. | |
432 | */ | |
bd33c1ca EB |
433 | HPI_ADAPTER_PROPERTY_SUPPORTS_SSX2 = 271, |
434 | /** Readonly supports PCI(e) IRQ. | |
435 | Indicates that the adapter in it's current mode supports interrupts | |
436 | across the host bus. Note, this does not imply that interrupts are | |
437 | enabled. Instead it indicates that they can be enabled. | |
438 | */ | |
812550e9 EB |
439 | HPI_ADAPTER_PROPERTY_SUPPORTS_IRQ = 272, |
440 | /** Readonly supports firmware updating. | |
441 | Indicates that the adapter implements an interface to update firmware | |
442 | on the adapter. | |
443 | */ | |
444 | HPI_ADAPTER_PROPERTY_SUPPORTS_FW_UPDATE = 273, | |
445 | /** Readonly Firmware IDs | |
446 | Identifiy firmware independent of individual adapter type. | |
447 | May be used as a filter for firmware update images. | |
448 | Property 1 = Bootloader ID | |
449 | Property 2 = Main program ID | |
450 | */ | |
451 | HPI_ADAPTER_PROPERTY_FIRMWARE_ID = 274 | |
719f82d3 EB |
452 | }; |
453 | ||
454 | /** Adapter mode commands | |
455 | ||
0a00044d | 456 | Used in wQueryOrSet parameter of HPI_AdapterSetModeEx(). |
719f82d3 EB |
457 | \ingroup adapter |
458 | */ | |
459 | enum HPI_ADAPTER_MODE_CMDS { | |
0a00044d | 460 | /** Set the mode to the given parameter */ |
719f82d3 | 461 | HPI_ADAPTER_MODE_SET = 0, |
0a00044d EB |
462 | /** Return 0 or error depending whether mode is valid, |
463 | but don't set the mode */ | |
719f82d3 EB |
464 | HPI_ADAPTER_MODE_QUERY = 1 |
465 | }; | |
466 | ||
467 | /** Adapter Modes | |
ba94455c | 468 | These are used by HPI_AdapterSetModeEx() |
719f82d3 EB |
469 | |
470 | \warning - more than 16 possible modes breaks | |
471 | a bitmask in the Windows WAVE DLL | |
472 | \ingroup adapter | |
473 | */ | |
474 | enum HPI_ADAPTER_MODES { | |
475 | /** 4 outstream mode. | |
476 | - ASI6114: 1 instream | |
477 | - ASI6044: 4 instreams | |
478 | - ASI6012: 1 instream | |
479 | - ASI6102: no instreams | |
480 | - ASI6022, ASI6122: 2 instreams | |
481 | - ASI5111, ASI5101: 2 instreams | |
482 | - ASI652x, ASI662x: 2 instreams | |
483 | - ASI654x, ASI664x: 4 instreams | |
484 | */ | |
485 | HPI_ADAPTER_MODE_4OSTREAM = 1, | |
486 | ||
487 | /** 6 outstream mode. | |
488 | - ASI6012: 1 instream, | |
489 | - ASI6022, ASI6122: 2 instreams | |
490 | - ASI652x, ASI662x: 4 instreams | |
491 | */ | |
492 | HPI_ADAPTER_MODE_6OSTREAM = 2, | |
493 | ||
494 | /** 8 outstream mode. | |
495 | - ASI6114: 8 instreams | |
496 | - ASI6118: 8 instreams | |
497 | - ASI6585: 8 instreams | |
498 | */ | |
499 | HPI_ADAPTER_MODE_8OSTREAM = 3, | |
500 | ||
501 | /** 16 outstream mode. | |
502 | - ASI6416 16 instreams | |
503 | - ASI6518, ASI6618 16 instreams | |
504 | - ASI6118 16 mono out and in streams | |
505 | */ | |
506 | HPI_ADAPTER_MODE_16OSTREAM = 4, | |
507 | ||
508 | /** one outstream mode. | |
509 | - ASI5111 1 outstream, 1 instream | |
510 | */ | |
511 | HPI_ADAPTER_MODE_1OSTREAM = 5, | |
512 | ||
513 | /** ASI504X mode 1. 12 outstream, 4 instream 0 to 48kHz sample rates | |
514 | (see ASI504X datasheet for more info). | |
515 | */ | |
516 | HPI_ADAPTER_MODE_1 = 6, | |
517 | ||
518 | /** ASI504X mode 2. 4 outstreams, 4 instreams at 0 to 192kHz sample rates | |
519 | (see ASI504X datasheet for more info). | |
520 | */ | |
521 | HPI_ADAPTER_MODE_2 = 7, | |
522 | ||
523 | /** ASI504X mode 3. 4 outstreams, 4 instreams at 0 to 192kHz sample rates | |
524 | (see ASI504X datasheet for more info). | |
525 | */ | |
526 | HPI_ADAPTER_MODE_3 = 8, | |
527 | ||
528 | /** ASI504X multichannel mode. | |
529 | 2 outstreams -> 4 line outs = 1 to 8 channel streams), | |
530 | 4 lineins -> 1 instream (1 to 8 channel streams) at 0-48kHz. | |
531 | For more info see the SSX Specification. | |
532 | */ | |
533 | HPI_ADAPTER_MODE_MULTICHANNEL = 9, | |
534 | ||
535 | /** 12 outstream mode. | |
536 | - ASI6514, ASI6614: 2 instreams | |
537 | - ASI6540,ASI6544: 8 instreams | |
538 | - ASI6640,ASI6644: 8 instreams | |
539 | */ | |
540 | HPI_ADAPTER_MODE_12OSTREAM = 10, | |
541 | ||
542 | /** 9 outstream mode. | |
543 | - ASI6044: 8 instreams | |
544 | */ | |
545 | HPI_ADAPTER_MODE_9OSTREAM = 11, | |
546 | ||
547 | /** mono mode. | |
548 | - ASI6416: 16 outstreams/instreams | |
549 | - ASI5402: 2 outstreams/instreams | |
550 | */ | |
551 | HPI_ADAPTER_MODE_MONO = 12, | |
552 | ||
553 | /** Low latency mode. | |
554 | - ASI6416/ASI6316: 1 16 channel outstream and instream | |
555 | */ | |
556 | HPI_ADAPTER_MODE_LOW_LATENCY = 13 | |
557 | }; | |
558 | ||
559 | /* Note, adapters can have more than one capability - | |
560 | encoding as bitfield is recommended. */ | |
561 | #define HPI_CAPABILITY_NONE (0) | |
562 | #define HPI_CAPABILITY_MPEG_LAYER3 (1) | |
563 | ||
564 | /* Set this equal to maximum capability index, | |
565 | Must not be greater than 32 - see axnvdef.h */ | |
566 | #define HPI_CAPABILITY_MAX 1 | |
567 | /* #define HPI_CAPABILITY_AAC 2 */ | |
568 | ||
569 | /******************************************* STREAM ATTRIBUTES ****/ | |
570 | ||
571 | /** MPEG Ancillary Data modes | |
572 | ||
573 | The mode for the ancillary data insertion or extraction to operate in. | |
574 | \ingroup stream | |
575 | */ | |
576 | enum HPI_MPEG_ANC_MODES { | |
577 | /** the MPEG frames have energy information stored in them (5 bytes per stereo frame, 3 per mono) */ | |
578 | HPI_MPEG_ANC_HASENERGY = 0, | |
579 | /** the entire ancillary data field is taken up by data from the Anc data buffer | |
580 | On encode, the encoder will insert the energy bytes before filling the remainder | |
581 | of the ancillary data space with data from the ancillary data buffer. | |
582 | */ | |
583 | HPI_MPEG_ANC_RAW = 1 | |
584 | }; | |
585 | ||
586 | /** Ancillary Data Alignment | |
587 | \ingroup instream | |
588 | */ | |
589 | enum HPI_ISTREAM_MPEG_ANC_ALIGNS { | |
590 | /** data is packed against the end of data, then padded to the end of frame */ | |
591 | HPI_MPEG_ANC_ALIGN_LEFT = 0, | |
592 | /** data is packed against the end of the frame */ | |
593 | HPI_MPEG_ANC_ALIGN_RIGHT = 1 | |
594 | }; | |
595 | ||
596 | /** MPEG modes | |
597 | MPEG modes - can be used optionally for HPI_FormatCreate() | |
598 | parameter dwAttributes. | |
599 | ||
600 | Using any mode setting other than HPI_MPEG_MODE_DEFAULT | |
601 | with single channel format will return an error. | |
602 | \ingroup stream | |
603 | */ | |
604 | enum HPI_MPEG_MODES { | |
605 | /** Causes the MPEG-1 Layer II bitstream to be recorded | |
606 | in single_channel mode when the number of channels is 1 and in stereo when the | |
607 | number of channels is 2. */ | |
608 | HPI_MPEG_MODE_DEFAULT = 0, | |
609 | /** Standard stereo without joint-stereo compression */ | |
610 | HPI_MPEG_MODE_STEREO = 1, | |
611 | /** Joint stereo */ | |
612 | HPI_MPEG_MODE_JOINTSTEREO = 2, | |
613 | /** Left and Right channels are completely independent */ | |
614 | HPI_MPEG_MODE_DUALCHANNEL = 3 | |
615 | }; | |
616 | /******************************************* MIXER ATTRIBUTES ****/ | |
617 | ||
618 | /* \defgroup mixer_flags Mixer flags for HPI_MIXER_GET_CONTROL_MULTIPLE_VALUES | |
619 | { | |
620 | */ | |
621 | #define HPI_MIXER_GET_CONTROL_MULTIPLE_CHANGED (0) | |
622 | #define HPI_MIXER_GET_CONTROL_MULTIPLE_RESET (1) | |
623 | /*}*/ | |
624 | ||
625 | /** Commands used by HPI_MixerStore() | |
626 | \ingroup mixer | |
627 | */ | |
628 | enum HPI_MIXER_STORE_COMMAND { | |
629 | /** Save all mixer control settings. */ | |
630 | HPI_MIXER_STORE_SAVE = 1, | |
631 | /** Restore all controls from saved. */ | |
632 | HPI_MIXER_STORE_RESTORE = 2, | |
633 | /** Delete saved control settings. */ | |
634 | HPI_MIXER_STORE_DELETE = 3, | |
635 | /** Enable auto storage of some control settings. */ | |
636 | HPI_MIXER_STORE_ENABLE = 4, | |
637 | /** Disable auto storage of some control settings. */ | |
638 | HPI_MIXER_STORE_DISABLE = 5, | |
812550e9 | 639 | /** Unimplemented - save the attributes of a single control. */ |
719f82d3 EB |
640 | HPI_MIXER_STORE_SAVE_SINGLE = 6 |
641 | }; | |
642 | ||
ba94455c EB |
643 | /****************************/ |
644 | /* CONTROL ATTRIBUTE VALUES */ | |
645 | /****************************/ | |
646 | ||
719f82d3 EB |
647 | /** Used by mixer plugin enable functions |
648 | ||
ba94455c | 649 | E.g. HPI_ParametricEq_SetState() |
719f82d3 EB |
650 | \ingroup mixer |
651 | */ | |
652 | enum HPI_SWITCH_STATES { | |
653 | HPI_SWITCH_OFF = 0, /**< turn the mixer plugin on. */ | |
654 | HPI_SWITCH_ON = 1 /**< turn the mixer plugin off. */ | |
655 | }; | |
656 | ||
657 | /* Volume control special gain values */ | |
ba94455c | 658 | |
719f82d3 EB |
659 | /** volumes units are 100ths of a dB |
660 | \ingroup volume | |
661 | */ | |
662 | #define HPI_UNITS_PER_dB 100 | |
663 | /** turns volume control OFF or MUTE | |
664 | \ingroup volume | |
665 | */ | |
666 | #define HPI_GAIN_OFF (-100 * HPI_UNITS_PER_dB) | |
667 | ||
fc3a3990 EB |
668 | /** channel mask specifying all channels |
669 | \ingroup volume | |
670 | */ | |
671 | #define HPI_BITMASK_ALL_CHANNELS (0xFFFFFFFF) | |
672 | ||
719f82d3 EB |
673 | /** value returned for no signal |
674 | \ingroup meter | |
675 | */ | |
676 | #define HPI_METER_MINIMUM (-150 * HPI_UNITS_PER_dB) | |
677 | ||
678 | /** autofade profiles | |
679 | \ingroup volume | |
680 | */ | |
681 | enum HPI_VOLUME_AUTOFADES { | |
682 | /** log fade - dB attenuation changes linearly over time */ | |
683 | HPI_VOLUME_AUTOFADE_LOG = 2, | |
684 | /** linear fade - amplitude changes linearly */ | |
685 | HPI_VOLUME_AUTOFADE_LINEAR = 3 | |
686 | }; | |
687 | ||
688 | /** The physical encoding format of the AESEBU I/O. | |
689 | ||
ba94455c | 690 | Used in HPI_Aesebu_Transmitter_SetFormat(), HPI_Aesebu_Receiver_SetFormat() |
719f82d3 EB |
691 | along with related Get and Query functions |
692 | \ingroup aestx | |
693 | */ | |
694 | enum HPI_AESEBU_FORMATS { | |
695 | /** AES/EBU physical format - AES/EBU balanced "professional" */ | |
696 | HPI_AESEBU_FORMAT_AESEBU = 1, | |
697 | /** AES/EBU physical format - S/PDIF unbalanced "consumer" */ | |
698 | HPI_AESEBU_FORMAT_SPDIF = 2 | |
699 | }; | |
700 | ||
701 | /** AES/EBU error status bits | |
702 | ||
ba94455c | 703 | Returned by HPI_Aesebu_Receiver_GetErrorStatus() |
719f82d3 EB |
704 | \ingroup aesrx |
705 | */ | |
706 | enum HPI_AESEBU_ERRORS { | |
707 | /** bit0: 1 when PLL is not locked */ | |
708 | HPI_AESEBU_ERROR_NOT_LOCKED = 0x01, | |
709 | /** bit1: 1 when signal quality is poor */ | |
710 | HPI_AESEBU_ERROR_POOR_QUALITY = 0x02, | |
711 | /** bit2: 1 when there is a parity error */ | |
712 | HPI_AESEBU_ERROR_PARITY_ERROR = 0x04, | |
713 | /** bit3: 1 when there is a bi-phase coding violation */ | |
714 | HPI_AESEBU_ERROR_BIPHASE_VIOLATION = 0x08, | |
715 | /** bit4: 1 when the validity bit is high */ | |
716 | HPI_AESEBU_ERROR_VALIDITY = 0x10, | |
717 | /** bit5: 1 when the CRC error bit is high */ | |
718 | HPI_AESEBU_ERROR_CRC = 0x20 | |
719 | }; | |
720 | ||
721 | /** \addtogroup pad | |
722 | \{ | |
723 | */ | |
724 | /** The text string containing the station/channel combination. */ | |
725 | #define HPI_PAD_CHANNEL_NAME_LEN 16 | |
726 | /** The text string containing the artist. */ | |
727 | #define HPI_PAD_ARTIST_LEN 64 | |
728 | /** The text string containing the title. */ | |
729 | #define HPI_PAD_TITLE_LEN 64 | |
730 | /** The text string containing the comment. */ | |
731 | #define HPI_PAD_COMMENT_LEN 256 | |
25985edc | 732 | /** The PTY when the tuner has not received any PTY. */ |
719f82d3 EB |
733 | #define HPI_PAD_PROGRAM_TYPE_INVALID 0xffff |
734 | /** \} */ | |
735 | ||
736 | /** Data types for PTY string translation. | |
737 | \ingroup rds | |
738 | */ | |
739 | enum eHPI_RDS_type { | |
740 | HPI_RDS_DATATYPE_RDS = 0, /**< RDS bitstream.*/ | |
741 | HPI_RDS_DATATYPE_RBDS = 1 /**< RBDS bitstream.*/ | |
742 | }; | |
743 | ||
744 | /** Tuner bands | |
745 | ||
746 | Used for HPI_Tuner_SetBand(),HPI_Tuner_GetBand() | |
747 | \ingroup tuner | |
748 | */ | |
749 | enum HPI_TUNER_BAND { | |
750 | HPI_TUNER_BAND_AM = 1, /**< AM band */ | |
751 | HPI_TUNER_BAND_FM = 2, /**< FM band (mono) */ | |
752 | HPI_TUNER_BAND_TV_NTSC_M = 3, /**< NTSC-M TV band*/ | |
753 | HPI_TUNER_BAND_TV = 3, /* use TV_NTSC_M */ | |
754 | HPI_TUNER_BAND_FM_STEREO = 4, /**< FM band (stereo) */ | |
755 | HPI_TUNER_BAND_AUX = 5, /**< auxiliary input */ | |
756 | HPI_TUNER_BAND_TV_PAL_BG = 6, /**< PAL-B/G TV band*/ | |
757 | HPI_TUNER_BAND_TV_PAL_I = 7, /**< PAL-I TV band*/ | |
758 | HPI_TUNER_BAND_TV_PAL_DK = 8, /**< PAL-D/K TV band*/ | |
759 | HPI_TUNER_BAND_TV_SECAM_L = 9, /**< SECAM-L TV band*/ | |
3872f19d EB |
760 | HPI_TUNER_BAND_DAB = 10, |
761 | HPI_TUNER_BAND_LAST = 10 /**< the index of the last tuner band. */ | |
719f82d3 EB |
762 | }; |
763 | ||
764 | /** Tuner mode attributes | |
765 | ||
766 | Used by HPI_Tuner_SetMode(), HPI_Tuner_GetMode() | |
767 | \ingroup tuner | |
768 | ||
769 | */ | |
770 | enum HPI_TUNER_MODES { | |
771 | HPI_TUNER_MODE_RSS = 1, /**< control RSS */ | |
772 | HPI_TUNER_MODE_RDS = 2 /**< control RBDS/RDS */ | |
773 | }; | |
774 | ||
775 | /** Tuner mode attribute values | |
776 | ||
777 | Used by HPI_Tuner_SetMode(), HPI_Tuner_GetMode() | |
778 | \ingroup tuner | |
779 | */ | |
780 | enum HPI_TUNER_MODE_VALUES { | |
781 | /* RSS attribute values */ | |
782 | HPI_TUNER_MODE_RSS_DISABLE = 0, /**< RSS disable */ | |
783 | HPI_TUNER_MODE_RSS_ENABLE = 1, /**< RSS enable */ | |
784 | ||
785 | /* RDS mode attributes */ | |
786 | HPI_TUNER_MODE_RDS_DISABLE = 0, /**< RDS - disabled */ | |
787 | HPI_TUNER_MODE_RDS_RDS = 1, /**< RDS - RDS mode */ | |
788 | HPI_TUNER_MODE_RDS_RBDS = 2 /**< RDS - RBDS mode */ | |
789 | }; | |
790 | ||
719f82d3 EB |
791 | /** Tuner Status Bits |
792 | ||
793 | These bitfield values are returned by a call to HPI_Tuner_GetStatus(). | |
794 | Multiple fields are returned from a single call. | |
795 | \ingroup tuner | |
796 | */ | |
797 | enum HPI_TUNER_STATUS_BITS { | |
798 | HPI_TUNER_VIDEO_COLOR_PRESENT = 0x0001, /**< video color is present. */ | |
ad210ad1 EB |
799 | HPI_TUNER_VIDEO_IS_60HZ = 0x0020, /**< 60 hz video detected. */ |
800 | HPI_TUNER_VIDEO_HORZ_SYNC_MISSING = 0x0040, /**< video HSYNC is missing. */ | |
801 | HPI_TUNER_VIDEO_STATUS_VALID = 0x0100, /**< video status is valid. */ | |
802 | HPI_TUNER_DIGITAL = 0x0200, /**< tuner reports digital programming. */ | |
803 | HPI_TUNER_MULTIPROGRAM = 0x0400, /**< tuner reports multiple programs. */ | |
804 | HPI_TUNER_PLL_LOCKED = 0x1000, /**< the tuner's PLL is locked. */ | |
805 | HPI_TUNER_FM_STEREO = 0x2000 /**< tuner reports back FM stereo. */ | |
719f82d3 EB |
806 | }; |
807 | ||
808 | /** Channel Modes | |
809 | Used for HPI_ChannelModeSet/Get() | |
810 | \ingroup channelmode | |
811 | */ | |
812 | enum HPI_CHANNEL_MODES { | |
813 | /** Left channel out = left channel in, Right channel out = right channel in. */ | |
814 | HPI_CHANNEL_MODE_NORMAL = 1, | |
815 | /** Left channel out = right channel in, Right channel out = left channel in. */ | |
816 | HPI_CHANNEL_MODE_SWAP = 2, | |
817 | /** Left channel out = left channel in, Right channel out = left channel in. */ | |
818 | HPI_CHANNEL_MODE_LEFT_TO_STEREO = 3, | |
819 | /** Left channel out = right channel in, Right channel out = right channel in.*/ | |
820 | HPI_CHANNEL_MODE_RIGHT_TO_STEREO = 4, | |
821 | /** Left channel out = (left channel in + right channel in)/2, | |
822 | Right channel out = mute. */ | |
823 | HPI_CHANNEL_MODE_STEREO_TO_LEFT = 5, | |
824 | /** Left channel out = mute, | |
825 | Right channel out = (right channel in + left channel in)/2. */ | |
826 | HPI_CHANNEL_MODE_STEREO_TO_RIGHT = 6, | |
827 | HPI_CHANNEL_MODE_LAST = 6 | |
828 | }; | |
829 | ||
830 | /** SampleClock source values | |
831 | \ingroup sampleclock | |
832 | */ | |
833 | enum HPI_SAMPLECLOCK_SOURCES { | |
834 | /** The sampleclock output is derived from its local samplerate generator. | |
835 | The local samplerate may be set using HPI_SampleClock_SetLocalRate(). */ | |
836 | HPI_SAMPLECLOCK_SOURCE_LOCAL = 1, | |
719f82d3 EB |
837 | /** The adapter is clocked from a dedicated AES/EBU SampleClock input.*/ |
838 | HPI_SAMPLECLOCK_SOURCE_AESEBU_SYNC = 2, | |
839 | /** From external wordclock connector */ | |
840 | HPI_SAMPLECLOCK_SOURCE_WORD = 3, | |
841 | /** Board-to-board header */ | |
842 | HPI_SAMPLECLOCK_SOURCE_WORD_HEADER = 4, | |
843 | /** FUTURE - SMPTE clock. */ | |
844 | HPI_SAMPLECLOCK_SOURCE_SMPTE = 5, | |
845 | /** One of the aesebu inputs */ | |
846 | HPI_SAMPLECLOCK_SOURCE_AESEBU_INPUT = 6, | |
719f82d3 EB |
847 | /** From a network interface e.g. Cobranet or Livewire at either 48 or 96kHz */ |
848 | HPI_SAMPLECLOCK_SOURCE_NETWORK = 8, | |
849 | /** From previous adjacent module (ASI2416 only)*/ | |
850 | HPI_SAMPLECLOCK_SOURCE_PREV_MODULE = 10, | |
3872f19d EB |
851 | /** Blu link sample clock*/ |
852 | HPI_SAMPLECLOCK_SOURCE_BLULINK = 11, | |
719f82d3 | 853 | /*! Update this if you add a new clock source.*/ |
3872f19d | 854 | HPI_SAMPLECLOCK_SOURCE_LAST = 11 |
719f82d3 EB |
855 | }; |
856 | ||
ba94455c | 857 | /** Equalizer filter types. Used by HPI_ParametricEq_SetBand() |
719f82d3 EB |
858 | \ingroup parmeq |
859 | */ | |
860 | enum HPI_FILTER_TYPE { | |
861 | HPI_FILTER_TYPE_BYPASS = 0, /**< filter is turned off */ | |
862 | ||
863 | HPI_FILTER_TYPE_LOWSHELF = 1, /**< EQ low shelf */ | |
864 | HPI_FILTER_TYPE_HIGHSHELF = 2, /**< EQ high shelf */ | |
865 | HPI_FILTER_TYPE_EQ_BAND = 3, /**< EQ gain */ | |
866 | ||
867 | HPI_FILTER_TYPE_LOWPASS = 4, /**< standard low pass */ | |
868 | HPI_FILTER_TYPE_HIGHPASS = 5, /**< standard high pass */ | |
869 | HPI_FILTER_TYPE_BANDPASS = 6, /**< standard band pass */ | |
870 | HPI_FILTER_TYPE_BANDSTOP = 7 /**< standard band stop/notch */ | |
871 | }; | |
872 | ||
873 | /** Async Event sources | |
874 | \ingroup async | |
875 | */ | |
876 | enum ASYNC_EVENT_SOURCES { | |
877 | HPI_ASYNC_EVENT_GPIO = 1, /**< GPIO event. */ | |
878 | HPI_ASYNC_EVENT_SILENCE = 2, /**< silence event detected. */ | |
879 | HPI_ASYNC_EVENT_TONE = 3 /**< tone event detected. */ | |
880 | }; | |
881 | /*******************************************/ | |
882 | /** HPI Error codes | |
883 | ||
884 | Almost all HPI functions return an error code | |
885 | A return value of zero means there was no error. | |
886 | Otherwise one of these error codes is returned. | |
887 | Error codes can be converted to a descriptive string using HPI_GetErrorText() | |
888 | ||
889 | \note When a new error code is added HPI_GetErrorText() MUST be updated. | |
890 | \note Codes 1-100 are reserved for driver use | |
891 | \ingroup utility | |
892 | */ | |
893 | enum HPI_ERROR_CODES { | |
894 | /** Message type does not exist. */ | |
895 | HPI_ERROR_INVALID_TYPE = 100, | |
896 | /** Object type does not exist. */ | |
897 | HPI_ERROR_INVALID_OBJ = 101, | |
898 | /** Function does not exist. */ | |
899 | HPI_ERROR_INVALID_FUNC = 102, | |
ba94455c | 900 | /** The specified object does not exist. */ |
719f82d3 EB |
901 | HPI_ERROR_INVALID_OBJ_INDEX = 103, |
902 | /** Trying to access an object that has not been opened yet. */ | |
903 | HPI_ERROR_OBJ_NOT_OPEN = 104, | |
904 | /** Trying to open an already open object. */ | |
905 | HPI_ERROR_OBJ_ALREADY_OPEN = 105, | |
906 | /** PCI, ISA resource not valid. */ | |
907 | HPI_ERROR_INVALID_RESOURCE = 106, | |
0a00044d | 908 | /* HPI_ERROR_SUBSYSFINDADAPTERS_GETINFO= 107 */ |
719f82d3 EB |
909 | /** Default response was never updated with actual error code. */ |
910 | HPI_ERROR_INVALID_RESPONSE = 108, | |
911 | /** wSize field of response was not updated, | |
912 | indicating that the message was not processed. */ | |
913 | HPI_ERROR_PROCESSING_MESSAGE = 109, | |
914 | /** The network did not respond in a timely manner. */ | |
915 | HPI_ERROR_NETWORK_TIMEOUT = 110, | |
ba94455c | 916 | /* An HPI handle is invalid (uninitialised?). */ |
719f82d3 EB |
917 | HPI_ERROR_INVALID_HANDLE = 111, |
918 | /** A function or attribute has not been implemented yet. */ | |
919 | HPI_ERROR_UNIMPLEMENTED = 112, | |
ba94455c EB |
920 | /** There are too many clients attempting |
921 | to access a network resource. */ | |
719f82d3 | 922 | HPI_ERROR_NETWORK_TOO_MANY_CLIENTS = 113, |
ba94455c EB |
923 | /** Response buffer passed to HPI_Message |
924 | was smaller than returned response. | |
925 | wSpecificError field of hpi response contains the required size. | |
926 | */ | |
719f82d3 EB |
927 | HPI_ERROR_RESPONSE_BUFFER_TOO_SMALL = 114, |
928 | /** The returned response did not match the sent message */ | |
929 | HPI_ERROR_RESPONSE_MISMATCH = 115, | |
ad210ad1 EB |
930 | /** A control setting that should have been cached was not. */ |
931 | HPI_ERROR_CONTROL_CACHING = 116, | |
ba94455c EB |
932 | /** A message buffer in the path to the adapter was smaller |
933 | than the message size. | |
934 | wSpecificError field of hpi response contains the actual size. | |
935 | */ | |
936 | HPI_ERROR_MESSAGE_BUFFER_TOO_SMALL = 117, | |
719f82d3 | 937 | |
0a00044d | 938 | /* HPI_ERROR_TOO_MANY_ADAPTERS= 200 */ |
719f82d3 EB |
939 | /** Bad adpater. */ |
940 | HPI_ERROR_BAD_ADAPTER = 201, | |
941 | /** Adapter number out of range or not set properly. */ | |
942 | HPI_ERROR_BAD_ADAPTER_NUMBER = 202, | |
943 | /** 2 adapters with the same adapter number. */ | |
a287ca2a | 944 | HPI_ERROR_DUPLICATE_ADAPTER_NUMBER = 203, |
812550e9 | 945 | /** DSP code failed to bootload. Usually a DSP memory test failure. */ |
719f82d3 | 946 | HPI_ERROR_DSP_BOOTLOAD = 204, |
719f82d3 EB |
947 | /** Couldn't find or open the DSP code file. */ |
948 | HPI_ERROR_DSP_FILE_NOT_FOUND = 206, | |
949 | /** Internal DSP hardware error. */ | |
950 | HPI_ERROR_DSP_HARDWARE = 207, | |
719f82d3 EB |
951 | /** Could not allocate memory */ |
952 | HPI_ERROR_MEMORY_ALLOC = 208, | |
0a00044d | 953 | /** Failed to correctly load/config PLD. (unused) */ |
719f82d3 EB |
954 | HPI_ERROR_PLD_LOAD = 209, |
955 | /** Unexpected end of file, block length too big etc. */ | |
956 | HPI_ERROR_DSP_FILE_FORMAT = 210, | |
957 | ||
958 | /** Found but could not open DSP code file. */ | |
959 | HPI_ERROR_DSP_FILE_ACCESS_DENIED = 211, | |
960 | /** First DSP code section header not found in DSP file. */ | |
961 | HPI_ERROR_DSP_FILE_NO_HEADER = 212, | |
0a00044d | 962 | /* HPI_ERROR_DSP_FILE_READ_ERROR= 213, */ |
719f82d3 EB |
963 | /** DSP code for adapter family not found. */ |
964 | HPI_ERROR_DSP_SECTION_NOT_FOUND = 214, | |
965 | /** Other OS specific error opening DSP file. */ | |
966 | HPI_ERROR_DSP_FILE_OTHER_ERROR = 215, | |
967 | /** Sharing violation opening DSP code file. */ | |
968 | HPI_ERROR_DSP_FILE_SHARING_VIOLATION = 216, | |
969 | /** DSP code section header had size == 0. */ | |
970 | HPI_ERROR_DSP_FILE_NULL_HEADER = 217, | |
971 | ||
0a00044d | 972 | /* HPI_ERROR_FLASH = 220, */ |
719f82d3 EB |
973 | |
974 | /** Flash has bad checksum */ | |
ad210ad1 EB |
975 | HPI_ERROR_BAD_CHECKSUM = 221, |
976 | HPI_ERROR_BAD_SEQUENCE = 222, | |
977 | HPI_ERROR_FLASH_ERASE = 223, | |
978 | HPI_ERROR_FLASH_PROGRAM = 224, | |
979 | HPI_ERROR_FLASH_VERIFY = 225, | |
980 | HPI_ERROR_FLASH_TYPE = 226, | |
981 | HPI_ERROR_FLASH_START = 227, | |
812550e9 EB |
982 | HPI_ERROR_FLASH_READ = 228, |
983 | HPI_ERROR_FLASH_READ_NO_FILE = 229, | |
984 | HPI_ERROR_FLASH_SIZE = 230, | |
719f82d3 EB |
985 | |
986 | /** Reserved for OEMs. */ | |
987 | HPI_ERROR_RESERVED_1 = 290, | |
988 | ||
1d595d2a | 989 | /* HPI_ERROR_INVALID_STREAM = 300 use HPI_ERROR_INVALID_OBJ_INDEX */ |
719f82d3 EB |
990 | /** Invalid compression format. */ |
991 | HPI_ERROR_INVALID_FORMAT = 301, | |
992 | /** Invalid format samplerate */ | |
993 | HPI_ERROR_INVALID_SAMPLERATE = 302, | |
994 | /** Invalid format number of channels. */ | |
995 | HPI_ERROR_INVALID_CHANNELS = 303, | |
996 | /** Invalid format bitrate. */ | |
997 | HPI_ERROR_INVALID_BITRATE = 304, | |
998 | /** Invalid datasize used for stream read/write. */ | |
999 | HPI_ERROR_INVALID_DATASIZE = 305, | |
1d595d2a EB |
1000 | /* HPI_ERROR_BUFFER_FULL = 306 use HPI_ERROR_INVALID_DATASIZE */ |
1001 | /* HPI_ERROR_BUFFER_EMPTY = 307 use HPI_ERROR_INVALID_DATASIZE */ | |
ba94455c EB |
1002 | /** Null data pointer used for stream read/write. */ |
1003 | HPI_ERROR_INVALID_DATA_POINTER = 308, | |
719f82d3 EB |
1004 | /** Packet ordering error for stream read/write. */ |
1005 | HPI_ERROR_INVALID_PACKET_ORDER = 309, | |
1006 | ||
1007 | /** Object can't do requested operation in its current | |
ba94455c | 1008 | state, eg set format, change rec mux state while recording.*/ |
719f82d3 EB |
1009 | HPI_ERROR_INVALID_OPERATION = 310, |
1010 | ||
ba94455c EB |
1011 | /** Where a SRG is shared amongst streams, an incompatible samplerate |
1012 | is one that is different to any currently active stream. */ | |
719f82d3 EB |
1013 | HPI_ERROR_INCOMPATIBLE_SAMPLERATE = 311, |
1014 | /** Adapter mode is illegal.*/ | |
1015 | HPI_ERROR_BAD_ADAPTER_MODE = 312, | |
1016 | ||
1017 | /** There have been too many attempts to set the adapter's | |
1018 | capabilities (using bad keys), the card should be returned | |
1019 | to ASI if further capabilities updates are required */ | |
1020 | HPI_ERROR_TOO_MANY_CAPABILITY_CHANGE_ATTEMPTS = 313, | |
1021 | /** Streams on different adapters cannot be grouped. */ | |
1022 | HPI_ERROR_NO_INTERADAPTER_GROUPS = 314, | |
1023 | /** Streams on different DSPs cannot be grouped. */ | |
1024 | HPI_ERROR_NO_INTERDSP_GROUPS = 315, | |
bd33c1ca EB |
1025 | /** Stream wait cancelled before threshold reached. */ |
1026 | HPI_ERROR_WAIT_CANCELLED = 316, | |
812550e9 EB |
1027 | /** A character string is invalid. */ |
1028 | HPI_ERROR_INVALID_STRING = 317, | |
719f82d3 EB |
1029 | |
1030 | /** Invalid mixer node for this adapter. */ | |
1031 | HPI_ERROR_INVALID_NODE = 400, | |
1032 | /** Invalid control. */ | |
1033 | HPI_ERROR_INVALID_CONTROL = 401, | |
1034 | /** Invalid control value was passed. */ | |
1035 | HPI_ERROR_INVALID_CONTROL_VALUE = 402, | |
1036 | /** Control attribute not supported by this control. */ | |
1037 | HPI_ERROR_INVALID_CONTROL_ATTRIBUTE = 403, | |
1038 | /** Control is disabled. */ | |
1039 | HPI_ERROR_CONTROL_DISABLED = 404, | |
1040 | /** I2C transaction failed due to a missing ACK. */ | |
1041 | HPI_ERROR_CONTROL_I2C_MISSING_ACK = 405, | |
0a00044d | 1042 | HPI_ERROR_I2C_MISSING_ACK = 405, |
719f82d3 EB |
1043 | /** Control is busy, or coming out of |
1044 | reset and cannot be accessed at this time. */ | |
1045 | HPI_ERROR_CONTROL_NOT_READY = 407, | |
1046 | ||
1047 | /** Non volatile memory */ | |
1048 | HPI_ERROR_NVMEM_BUSY = 450, | |
1049 | HPI_ERROR_NVMEM_FULL = 451, | |
1050 | HPI_ERROR_NVMEM_FAIL = 452, | |
1051 | ||
1052 | /** I2C */ | |
719f82d3 EB |
1053 | HPI_ERROR_I2C_BAD_ADR = 460, |
1054 | ||
812550e9 | 1055 | /** Entity type did not match requested type */ |
719f82d3 | 1056 | HPI_ERROR_ENTITY_TYPE_MISMATCH = 470, |
812550e9 | 1057 | /** Entity item count did not match requested count */ |
719f82d3 | 1058 | HPI_ERROR_ENTITY_ITEM_COUNT = 471, |
812550e9 | 1059 | /** Entity type is not one of the valid types */ |
719f82d3 | 1060 | HPI_ERROR_ENTITY_TYPE_INVALID = 472, |
812550e9 | 1061 | /** Entity role is not one of the valid roles */ |
719f82d3 | 1062 | HPI_ERROR_ENTITY_ROLE_INVALID = 473, |
812550e9 | 1063 | /** Entity size doesn't match target size */ |
ad210ad1 | 1064 | HPI_ERROR_ENTITY_SIZE_MISMATCH = 474, |
719f82d3 EB |
1065 | |
1066 | /* AES18 specific errors were 500..507 */ | |
1067 | ||
1068 | /** custom error to use for debugging */ | |
1069 | HPI_ERROR_CUSTOM = 600, | |
1070 | ||
1071 | /** hpioct32.c can't obtain mutex */ | |
1072 | HPI_ERROR_MUTEX_TIMEOUT = 700, | |
1073 | ||
a287ca2a EB |
1074 | /** Backend errors used to be greater than this. |
1075 | \deprecated Now, all backends return only errors defined here in hpi.h | |
1076 | */ | |
1077 | HPI_ERROR_BACKEND_BASE = 900, | |
1078 | ||
1079 | /** Communication with DSP failed */ | |
1080 | HPI_ERROR_DSP_COMMUNICATION = 900 | |
1081 | /* Note that the dsp communication error is set to this value so that | |
1082 | it remains compatible with any software that expects such errors | |
1083 | to be backend errors i.e. >= 900. | |
1084 | Do not define any new error codes with values > 900. | |
1085 | */ | |
719f82d3 EB |
1086 | }; |
1087 | ||
1088 | /** \defgroup maximums HPI maximum values | |
1089 | \{ | |
1090 | */ | |
812550e9 | 1091 | /** Maximum number of PCI HPI adapters */ |
719f82d3 EB |
1092 | #define HPI_MAX_ADAPTERS 20 |
1093 | /** Maximum number of in or out streams per adapter */ | |
1094 | #define HPI_MAX_STREAMS 16 | |
1095 | #define HPI_MAX_CHANNELS 2 /* per stream */ | |
1096 | #define HPI_MAX_NODES 8 /* per mixer ? */ | |
1097 | #define HPI_MAX_CONTROLS 4 /* per node ? */ | |
1098 | /** maximum number of ancillary bytes per MPEG frame */ | |
1099 | #define HPI_MAX_ANC_BYTES_PER_FRAME (64) | |
1100 | #define HPI_STRING_LEN 16 | |
1101 | ||
812550e9 EB |
1102 | /** Networked adapters have index >= 100 */ |
1103 | #define HPI_MIN_NETWORK_ADAPTER_IDX 100 | |
1104 | ||
719f82d3 EB |
1105 | /** Velocity units */ |
1106 | #define HPI_OSTREAM_VELOCITY_UNITS 4096 | |
1107 | /** OutStream timescale units */ | |
1108 | #define HPI_OSTREAM_TIMESCALE_UNITS 10000 | |
1109 | /** OutStream timescale passthrough - turns timescaling on in passthough mode */ | |
1110 | #define HPI_OSTREAM_TIMESCALE_PASSTHROUGH 99999 | |
1111 | ||
1112 | /**\}*/ | |
1113 | ||
ba94455c | 1114 | /**************/ |
719f82d3 EB |
1115 | /* STRUCTURES */ |
1116 | #ifndef DISABLE_PRAGMA_PACK1 | |
1117 | #pragma pack(push, 1) | |
1118 | #endif | |
1119 | ||
1120 | /** Structure containing sample format information. | |
1121 | See also HPI_FormatCreate(). | |
1122 | */ | |
1123 | struct hpi_format { | |
1124 | u32 sample_rate; | |
1125 | /**< 11025, 32000, 44100 ... */ | |
812550e9 | 1126 | u32 bit_rate; /**< for MPEG */ |
719f82d3 EB |
1127 | u32 attributes; |
1128 | /**< Stereo/JointStereo/Mono */ | |
1129 | u16 mode_legacy; | |
1130 | /**< Legacy ancillary mode or idle bit */ | |
812550e9 EB |
1131 | u16 unused; /**< Unused */ |
1132 | u16 channels; /**< 1,2..., (or ancillary mode or idle bit */ | |
1133 | u16 format; /**< HPI_FORMAT_PCM16, _MPEG etc. see #HPI_FORMATS. */ | |
719f82d3 EB |
1134 | }; |
1135 | ||
1136 | struct hpi_anc_frame { | |
1137 | u32 valid_bits_in_this_frame; | |
1138 | u8 b_data[HPI_MAX_ANC_BYTES_PER_FRAME]; | |
1139 | }; | |
1140 | ||
1141 | /** An object for containing a single async event. | |
1142 | */ | |
1143 | struct hpi_async_event { | |
1144 | u16 event_type; /**< type of event. \sa async_event */ | |
1d595d2a EB |
1145 | u16 sequence; /**< Sequence number, allows lost event detection */ |
1146 | u32 state; /**< New state */ | |
1147 | u32 h_object; /**< handle to the object returning the event. */ | |
719f82d3 EB |
1148 | union { |
1149 | struct { | |
1150 | u16 index; /**< GPIO bit index. */ | |
1151 | } gpio; | |
1152 | struct { | |
1153 | u16 node_index; /**< what node is the control on ? */ | |
1d595d2a | 1154 | u16 node_type; /**< what type of node is the control on ? */ |
719f82d3 EB |
1155 | } control; |
1156 | } u; | |
1157 | }; | |
1158 | ||
719f82d3 EB |
1159 | #ifndef DISABLE_PRAGMA_PACK1 |
1160 | #pragma pack(pop) | |
1161 | #endif | |
1162 | ||
ba94455c | 1163 | /*****************/ |
719f82d3 | 1164 | /* HPI FUNCTIONS */ |
ba94455c | 1165 | /*****************/ |
719f82d3 | 1166 | |
ba94455c | 1167 | /* Stream */ |
719f82d3 EB |
1168 | u16 hpi_stream_estimate_buffer_size(struct hpi_format *pF, |
1169 | u32 host_polling_rate_in_milli_seconds, u32 *recommended_buffer_size); | |
1170 | ||
ba94455c EB |
1171 | /*************/ |
1172 | /* SubSystem */ | |
1173 | /*************/ | |
719f82d3 | 1174 | |
ba94455c | 1175 | u16 hpi_subsys_get_version_ex(u32 *pversion_ex); |
719f82d3 | 1176 | |
ba94455c | 1177 | u16 hpi_subsys_get_num_adapters(int *pn_num_adapters); |
719f82d3 | 1178 | |
ba94455c EB |
1179 | u16 hpi_subsys_get_adapter(int iterator, u32 *padapter_index, |
1180 | u16 *pw_adapter_type); | |
719f82d3 | 1181 | |
ba94455c EB |
1182 | /***********/ |
1183 | /* Adapter */ | |
1184 | /***********/ | |
719f82d3 | 1185 | |
ba94455c | 1186 | u16 hpi_adapter_open(u16 adapter_index); |
719f82d3 | 1187 | |
ba94455c | 1188 | u16 hpi_adapter_close(u16 adapter_index); |
719f82d3 | 1189 | |
ba94455c EB |
1190 | u16 hpi_adapter_get_info(u16 adapter_index, u16 *pw_num_outstreams, |
1191 | u16 *pw_num_instreams, u16 *pw_version, u32 *pserial_number, | |
1192 | u16 *pw_adapter_type); | |
719f82d3 | 1193 | |
ba94455c EB |
1194 | u16 hpi_adapter_get_module_by_index(u16 adapter_index, u16 module_index, |
1195 | u16 *pw_num_outputs, u16 *pw_num_inputs, u16 *pw_version, | |
1196 | u32 *pserial_number, u16 *pw_module_type, u32 *ph_module); | |
719f82d3 | 1197 | |
ba94455c | 1198 | u16 hpi_adapter_set_mode(u16 adapter_index, u32 adapter_mode); |
719f82d3 | 1199 | |
ba94455c EB |
1200 | u16 hpi_adapter_set_mode_ex(u16 adapter_index, u32 adapter_mode, |
1201 | u16 query_or_set); | |
719f82d3 | 1202 | |
ba94455c | 1203 | u16 hpi_adapter_get_mode(u16 adapter_index, u32 *padapter_mode); |
719f82d3 | 1204 | |
ba94455c EB |
1205 | u16 hpi_adapter_get_assert2(u16 adapter_index, u16 *p_assert_count, |
1206 | char *psz_assert, u32 *p_param1, u32 *p_param2, | |
1207 | u32 *p_dsp_string_addr, u16 *p_processor_id); | |
719f82d3 | 1208 | |
ba94455c | 1209 | u16 hpi_adapter_test_assert(u16 adapter_index, u16 assert_id); |
719f82d3 | 1210 | |
ba94455c | 1211 | u16 hpi_adapter_enable_capability(u16 adapter_index, u16 capability, u32 key); |
719f82d3 | 1212 | |
ba94455c | 1213 | u16 hpi_adapter_self_test(u16 adapter_index); |
719f82d3 | 1214 | |
ba94455c EB |
1215 | u16 hpi_adapter_debug_read(u16 adapter_index, u32 dsp_address, char *p_bytes, |
1216 | int *count_bytes); | |
719f82d3 | 1217 | |
ba94455c EB |
1218 | u16 hpi_adapter_set_property(u16 adapter_index, u16 property, u16 paramter1, |
1219 | u16 paramter2); | |
719f82d3 | 1220 | |
ba94455c EB |
1221 | u16 hpi_adapter_get_property(u16 adapter_index, u16 property, |
1222 | u16 *pw_paramter1, u16 *pw_paramter2); | |
719f82d3 | 1223 | |
ba94455c EB |
1224 | u16 hpi_adapter_enumerate_property(u16 adapter_index, u16 index, |
1225 | u16 what_to_enumerate, u16 property_index, u32 *psetting); | |
1226 | /*************/ | |
1227 | /* OutStream */ | |
1228 | /*************/ | |
1229 | u16 hpi_outstream_open(u16 adapter_index, u16 outstream_index, | |
1230 | u32 *ph_outstream); | |
719f82d3 | 1231 | |
ba94455c | 1232 | u16 hpi_outstream_close(u32 h_outstream); |
719f82d3 | 1233 | |
ba94455c EB |
1234 | u16 hpi_outstream_get_info_ex(u32 h_outstream, u16 *pw_state, |
1235 | u32 *pbuffer_size, u32 *pdata_to_play, u32 *psamples_played, | |
1236 | u32 *pauxiliary_data_to_play); | |
719f82d3 | 1237 | |
ba94455c EB |
1238 | u16 hpi_outstream_write_buf(u32 h_outstream, const u8 *pb_write_buf, |
1239 | u32 bytes_to_write, const struct hpi_format *p_format); | |
719f82d3 | 1240 | |
ba94455c | 1241 | u16 hpi_outstream_start(u32 h_outstream); |
719f82d3 | 1242 | |
ba94455c | 1243 | u16 hpi_outstream_wait_start(u32 h_outstream); |
719f82d3 | 1244 | |
ba94455c | 1245 | u16 hpi_outstream_stop(u32 h_outstream); |
719f82d3 | 1246 | |
ba94455c | 1247 | u16 hpi_outstream_sinegen(u32 h_outstream); |
719f82d3 | 1248 | |
ba94455c | 1249 | u16 hpi_outstream_reset(u32 h_outstream); |
719f82d3 | 1250 | |
ba94455c | 1251 | u16 hpi_outstream_query_format(u32 h_outstream, struct hpi_format *p_format); |
719f82d3 | 1252 | |
ba94455c | 1253 | u16 hpi_outstream_set_format(u32 h_outstream, struct hpi_format *p_format); |
719f82d3 | 1254 | |
ba94455c EB |
1255 | u16 hpi_outstream_set_punch_in_out(u32 h_outstream, u32 punch_in_sample, |
1256 | u32 punch_out_sample); | |
719f82d3 | 1257 | |
ba94455c | 1258 | u16 hpi_outstream_set_velocity(u32 h_outstream, short velocity); |
719f82d3 | 1259 | |
ba94455c | 1260 | u16 hpi_outstream_ancillary_reset(u32 h_outstream, u16 mode); |
719f82d3 | 1261 | |
ba94455c | 1262 | u16 hpi_outstream_ancillary_get_info(u32 h_outstream, u32 *pframes_available); |
719f82d3 | 1263 | |
ba94455c EB |
1264 | u16 hpi_outstream_ancillary_read(u32 h_outstream, |
1265 | struct hpi_anc_frame *p_anc_frame_buffer, | |
719f82d3 EB |
1266 | u32 anc_frame_buffer_size_in_bytes, |
1267 | u32 number_of_ancillary_frames_to_read); | |
1268 | ||
ba94455c | 1269 | u16 hpi_outstream_set_time_scale(u32 h_outstream, u32 time_scaleX10000); |
719f82d3 | 1270 | |
ba94455c | 1271 | u16 hpi_outstream_host_buffer_allocate(u32 h_outstream, u32 size_in_bytes); |
719f82d3 | 1272 | |
ba94455c | 1273 | u16 hpi_outstream_host_buffer_free(u32 h_outstream); |
719f82d3 | 1274 | |
ba94455c | 1275 | u16 hpi_outstream_group_add(u32 h_outstream, u32 h_stream); |
719f82d3 | 1276 | |
ba94455c EB |
1277 | u16 hpi_outstream_group_get_map(u32 h_outstream, u32 *poutstream_map, |
1278 | u32 *pinstream_map); | |
719f82d3 | 1279 | |
ba94455c | 1280 | u16 hpi_outstream_group_reset(u32 h_outstream); |
719f82d3 | 1281 | |
ba94455c EB |
1282 | /************/ |
1283 | /* InStream */ | |
1284 | /************/ | |
1285 | u16 hpi_instream_open(u16 adapter_index, u16 instream_index, | |
1286 | u32 *ph_instream); | |
719f82d3 | 1287 | |
ba94455c | 1288 | u16 hpi_instream_close(u32 h_instream); |
719f82d3 | 1289 | |
ba94455c EB |
1290 | u16 hpi_instream_query_format(u32 h_instream, |
1291 | const struct hpi_format *p_format); | |
719f82d3 | 1292 | |
ba94455c EB |
1293 | u16 hpi_instream_set_format(u32 h_instream, |
1294 | const struct hpi_format *p_format); | |
719f82d3 | 1295 | |
ba94455c | 1296 | u16 hpi_instream_read_buf(u32 h_instream, u8 *pb_read_buf, u32 bytes_to_read); |
719f82d3 | 1297 | |
ba94455c | 1298 | u16 hpi_instream_start(u32 h_instream); |
719f82d3 | 1299 | |
ba94455c | 1300 | u16 hpi_instream_wait_start(u32 h_instream); |
719f82d3 | 1301 | |
ba94455c | 1302 | u16 hpi_instream_stop(u32 h_instream); |
719f82d3 | 1303 | |
ba94455c | 1304 | u16 hpi_instream_reset(u32 h_instream); |
719f82d3 | 1305 | |
ba94455c EB |
1306 | u16 hpi_instream_get_info_ex(u32 h_instream, u16 *pw_state, u32 *pbuffer_size, |
1307 | u32 *pdata_recorded, u32 *psamples_recorded, | |
1308 | u32 *pauxiliary_data_recorded); | |
719f82d3 | 1309 | |
ba94455c EB |
1310 | u16 hpi_instream_ancillary_reset(u32 h_instream, u16 bytes_per_frame, |
1311 | u16 mode, u16 alignment, u16 idle_bit); | |
719f82d3 | 1312 | |
ba94455c | 1313 | u16 hpi_instream_ancillary_get_info(u32 h_instream, u32 *pframe_space); |
719f82d3 | 1314 | |
ba94455c EB |
1315 | u16 hpi_instream_ancillary_write(u32 h_instream, |
1316 | const struct hpi_anc_frame *p_anc_frame_buffer, | |
719f82d3 EB |
1317 | u32 anc_frame_buffer_size_in_bytes, |
1318 | u32 number_of_ancillary_frames_to_write); | |
1319 | ||
ba94455c | 1320 | u16 hpi_instream_host_buffer_allocate(u32 h_instream, u32 size_in_bytes); |
719f82d3 | 1321 | |
ba94455c | 1322 | u16 hpi_instream_host_buffer_free(u32 h_instream); |
719f82d3 | 1323 | |
ba94455c | 1324 | u16 hpi_instream_group_add(u32 h_instream, u32 h_stream); |
719f82d3 | 1325 | |
ba94455c EB |
1326 | u16 hpi_instream_group_get_map(u32 h_instream, u32 *poutstream_map, |
1327 | u32 *pinstream_map); | |
719f82d3 | 1328 | |
ba94455c | 1329 | u16 hpi_instream_group_reset(u32 h_instream); |
719f82d3 EB |
1330 | |
1331 | /*********/ | |
ba94455c | 1332 | /* Mixer */ |
719f82d3 | 1333 | /*********/ |
ba94455c EB |
1334 | u16 hpi_mixer_open(u16 adapter_index, u32 *ph_mixer); |
1335 | ||
1336 | u16 hpi_mixer_close(u32 h_mixer); | |
1337 | ||
1338 | u16 hpi_mixer_get_control(u32 h_mixer, u16 src_node_type, | |
1339 | u16 src_node_type_index, u16 dst_node_type, u16 dst_node_type_index, | |
1340 | u16 control_type, u32 *ph_control); | |
1341 | ||
1342 | u16 hpi_mixer_get_control_by_index(u32 h_mixer, u16 control_index, | |
1343 | u16 *pw_src_node_type, u16 *pw_src_node_index, u16 *pw_dst_node_type, | |
1344 | u16 *pw_dst_node_index, u16 *pw_control_type, u32 *ph_control); | |
1345 | ||
1346 | u16 hpi_mixer_store(u32 h_mixer, enum HPI_MIXER_STORE_COMMAND command, | |
1347 | u16 index); | |
1348 | /************/ | |
1349 | /* Controls */ | |
1350 | /************/ | |
1351 | /******************/ | |
1352 | /* Volume control */ | |
1353 | /******************/ | |
1354 | u16 hpi_volume_set_gain(u32 h_control, short an_gain0_01dB[HPI_MAX_CHANNELS] | |
719f82d3 EB |
1355 | ); |
1356 | ||
ba94455c | 1357 | u16 hpi_volume_get_gain(u32 h_control, |
719f82d3 EB |
1358 | short an_gain0_01dB_out[HPI_MAX_CHANNELS] |
1359 | ); | |
1360 | ||
fc3a3990 EB |
1361 | u16 hpi_volume_set_mute(u32 h_control, u32 mute); |
1362 | ||
1363 | u16 hpi_volume_get_mute(u32 h_control, u32 *mute); | |
1364 | ||
719f82d3 | 1365 | #define hpi_volume_get_range hpi_volume_query_range |
ba94455c EB |
1366 | u16 hpi_volume_query_range(u32 h_control, short *min_gain_01dB, |
1367 | short *max_gain_01dB, short *step_gain_01dB); | |
719f82d3 | 1368 | |
812550e9 | 1369 | u16 hpi_volume_query_channels(const u32 h_control, u32 *p_channels); |
719f82d3 | 1370 | |
ba94455c | 1371 | u16 hpi_volume_auto_fade(u32 h_control, |
719f82d3 EB |
1372 | short an_stop_gain0_01dB[HPI_MAX_CHANNELS], u32 duration_ms); |
1373 | ||
ba94455c EB |
1374 | u16 hpi_volume_auto_fade_profile(u32 h_control, |
1375 | short an_stop_gain0_01dB[HPI_MAX_CHANNELS], u32 duration_ms, | |
1376 | u16 profile); | |
719f82d3 | 1377 | |
862e1418 EB |
1378 | u16 hpi_volume_query_auto_fade_profile(const u32 h_control, const u32 i, |
1379 | u16 *profile); | |
1380 | ||
ba94455c EB |
1381 | /*****************/ |
1382 | /* Level control */ | |
1383 | /*****************/ | |
1384 | u16 hpi_level_query_range(u32 h_control, short *min_gain_01dB, | |
1385 | short *max_gain_01dB, short *step_gain_01dB); | |
719f82d3 | 1386 | |
ba94455c | 1387 | u16 hpi_level_set_gain(u32 h_control, short an_gain0_01dB[HPI_MAX_CHANNELS] |
719f82d3 EB |
1388 | ); |
1389 | ||
ba94455c | 1390 | u16 hpi_level_get_gain(u32 h_control, |
719f82d3 EB |
1391 | short an_gain0_01dB_out[HPI_MAX_CHANNELS] |
1392 | ); | |
1393 | ||
ba94455c EB |
1394 | /*****************/ |
1395 | /* Meter control */ | |
1396 | /*****************/ | |
1397 | u16 hpi_meter_query_channels(const u32 h_meter, u32 *p_channels); | |
719f82d3 | 1398 | |
ba94455c | 1399 | u16 hpi_meter_get_peak(u32 h_control, |
719f82d3 EB |
1400 | short an_peak0_01dB_out[HPI_MAX_CHANNELS] |
1401 | ); | |
1402 | ||
ba94455c | 1403 | u16 hpi_meter_get_rms(u32 h_control, short an_peak0_01dB_out[HPI_MAX_CHANNELS] |
719f82d3 EB |
1404 | ); |
1405 | ||
ba94455c | 1406 | u16 hpi_meter_set_peak_ballistics(u32 h_control, u16 attack, u16 decay); |
719f82d3 | 1407 | |
ba94455c | 1408 | u16 hpi_meter_set_rms_ballistics(u32 h_control, u16 attack, u16 decay); |
719f82d3 | 1409 | |
ba94455c | 1410 | u16 hpi_meter_get_peak_ballistics(u32 h_control, u16 *attack, u16 *decay); |
719f82d3 | 1411 | |
ba94455c | 1412 | u16 hpi_meter_get_rms_ballistics(u32 h_control, u16 *attack, u16 *decay); |
719f82d3 | 1413 | |
ba94455c EB |
1414 | /************************/ |
1415 | /* ChannelMode control */ | |
1416 | /************************/ | |
1417 | u16 hpi_channel_mode_query_mode(const u32 h_mode, const u32 index, | |
1418 | u16 *pw_mode); | |
719f82d3 | 1419 | |
ba94455c | 1420 | u16 hpi_channel_mode_set(u32 h_control, u16 mode); |
719f82d3 | 1421 | |
ba94455c | 1422 | u16 hpi_channel_mode_get(u32 h_control, u16 *mode); |
719f82d3 | 1423 | |
ba94455c EB |
1424 | /*****************/ |
1425 | /* Tuner control */ | |
1426 | /*****************/ | |
1427 | u16 hpi_tuner_query_band(const u32 h_tuner, const u32 index, u16 *pw_band); | |
719f82d3 | 1428 | |
ba94455c | 1429 | u16 hpi_tuner_set_band(u32 h_control, u16 band); |
719f82d3 | 1430 | |
ba94455c | 1431 | u16 hpi_tuner_get_band(u32 h_control, u16 *pw_band); |
719f82d3 | 1432 | |
ba94455c EB |
1433 | u16 hpi_tuner_query_frequency(const u32 h_tuner, const u32 index, |
1434 | const u16 band, u32 *pfreq); | |
719f82d3 | 1435 | |
ba94455c | 1436 | u16 hpi_tuner_set_frequency(u32 h_control, u32 freq_ink_hz); |
719f82d3 | 1437 | |
ba94455c | 1438 | u16 hpi_tuner_get_frequency(u32 h_control, u32 *pw_freq_ink_hz); |
719f82d3 | 1439 | |
ba94455c | 1440 | u16 hpi_tuner_get_rf_level(u32 h_control, short *pw_level); |
719f82d3 | 1441 | |
ba94455c | 1442 | u16 hpi_tuner_get_raw_rf_level(u32 h_control, short *pw_level); |
719f82d3 | 1443 | |
ba94455c | 1444 | u16 hpi_tuner_query_gain(const u32 h_tuner, const u32 index, u16 *pw_gain); |
719f82d3 | 1445 | |
ba94455c | 1446 | u16 hpi_tuner_set_gain(u32 h_control, short gain); |
719f82d3 | 1447 | |
ba94455c | 1448 | u16 hpi_tuner_get_gain(u32 h_control, short *pn_gain); |
719f82d3 | 1449 | |
ba94455c | 1450 | u16 hpi_tuner_get_status(u32 h_control, u16 *pw_status_mask, u16 *pw_status); |
719f82d3 | 1451 | |
ba94455c | 1452 | u16 hpi_tuner_set_mode(u32 h_control, u32 mode, u32 value); |
719f82d3 | 1453 | |
ba94455c | 1454 | u16 hpi_tuner_get_mode(u32 h_control, u32 mode, u32 *pn_value); |
719f82d3 | 1455 | |
ba94455c | 1456 | u16 hpi_tuner_get_rds(u32 h_control, char *p_rds_data); |
719f82d3 | 1457 | |
ba94455c EB |
1458 | u16 hpi_tuner_query_deemphasis(const u32 h_tuner, const u32 index, |
1459 | const u16 band, u32 *pdeemphasis); | |
719f82d3 | 1460 | |
ba94455c EB |
1461 | u16 hpi_tuner_set_deemphasis(u32 h_control, u32 deemphasis); |
1462 | u16 hpi_tuner_get_deemphasis(u32 h_control, u32 *pdeemphasis); | |
719f82d3 | 1463 | |
ba94455c | 1464 | u16 hpi_tuner_query_program(const u32 h_tuner, u32 *pbitmap_program); |
719f82d3 | 1465 | |
ba94455c | 1466 | u16 hpi_tuner_set_program(u32 h_control, u32 program); |
719f82d3 | 1467 | |
ba94455c | 1468 | u16 hpi_tuner_get_program(u32 h_control, u32 *pprogram); |
719f82d3 | 1469 | |
ba94455c EB |
1470 | u16 hpi_tuner_get_hd_radio_dsp_version(u32 h_control, char *psz_dsp_version, |
1471 | const u32 string_size); | |
719f82d3 | 1472 | |
ba94455c EB |
1473 | u16 hpi_tuner_get_hd_radio_sdk_version(u32 h_control, char *psz_sdk_version, |
1474 | const u32 string_size); | |
719f82d3 | 1475 | |
ba94455c | 1476 | u16 hpi_tuner_get_hd_radio_signal_quality(u32 h_control, u32 *pquality); |
719f82d3 | 1477 | |
ba94455c | 1478 | u16 hpi_tuner_get_hd_radio_signal_blend(u32 h_control, u32 *pblend); |
5a498ef1 | 1479 | |
ba94455c | 1480 | u16 hpi_tuner_set_hd_radio_signal_blend(u32 h_control, const u32 blend); |
5a498ef1 | 1481 | |
ba94455c EB |
1482 | /***************/ |
1483 | /* PAD control */ | |
1484 | /***************/ | |
719f82d3 | 1485 | |
ba94455c EB |
1486 | u16 hpi_pad_get_channel_name(u32 h_control, char *psz_string, |
1487 | const u32 string_length); | |
719f82d3 | 1488 | |
ba94455c EB |
1489 | u16 hpi_pad_get_artist(u32 h_control, char *psz_string, |
1490 | const u32 string_length); | |
719f82d3 | 1491 | |
ba94455c EB |
1492 | u16 hpi_pad_get_title(u32 h_control, char *psz_string, |
1493 | const u32 string_length); | |
719f82d3 | 1494 | |
ba94455c EB |
1495 | u16 hpi_pad_get_comment(u32 h_control, char *psz_string, |
1496 | const u32 string_length); | |
719f82d3 | 1497 | |
ba94455c | 1498 | u16 hpi_pad_get_program_type(u32 h_control, u32 *ppTY); |
719f82d3 | 1499 | |
ba94455c | 1500 | u16 hpi_pad_get_rdsPI(u32 h_control, u32 *ppI); |
719f82d3 | 1501 | |
ba94455c EB |
1502 | u16 hpi_pad_get_program_type_string(u32 h_control, const u32 data_type, |
1503 | const u32 pTY, char *psz_string, const u32 string_length); | |
719f82d3 EB |
1504 | |
1505 | /****************************/ | |
1506 | /* AES/EBU Receiver control */ | |
1507 | /****************************/ | |
ba94455c EB |
1508 | u16 hpi_aesebu_receiver_query_format(const u32 h_aes_rx, const u32 index, |
1509 | u16 *pw_format); | |
719f82d3 | 1510 | |
ba94455c | 1511 | u16 hpi_aesebu_receiver_set_format(u32 h_control, u16 source); |
719f82d3 | 1512 | |
ba94455c | 1513 | u16 hpi_aesebu_receiver_get_format(u32 h_control, u16 *pw_source); |
719f82d3 | 1514 | |
ba94455c | 1515 | u16 hpi_aesebu_receiver_get_sample_rate(u32 h_control, u32 *psample_rate); |
719f82d3 | 1516 | |
ba94455c | 1517 | u16 hpi_aesebu_receiver_get_user_data(u32 h_control, u16 index, u16 *pw_data); |
719f82d3 | 1518 | |
ba94455c EB |
1519 | u16 hpi_aesebu_receiver_get_channel_status(u32 h_control, u16 index, |
1520 | u16 *pw_data); | |
719f82d3 | 1521 | |
ba94455c | 1522 | u16 hpi_aesebu_receiver_get_error_status(u32 h_control, u16 *pw_error_data); |
719f82d3 EB |
1523 | |
1524 | /*******************************/ | |
1525 | /* AES/EBU Transmitter control */ | |
1526 | /*******************************/ | |
ba94455c | 1527 | u16 hpi_aesebu_transmitter_set_sample_rate(u32 h_control, u32 sample_rate); |
719f82d3 | 1528 | |
ba94455c | 1529 | u16 hpi_aesebu_transmitter_set_user_data(u32 h_control, u16 index, u16 data); |
719f82d3 | 1530 | |
ba94455c EB |
1531 | u16 hpi_aesebu_transmitter_set_channel_status(u32 h_control, u16 index, |
1532 | u16 data); | |
719f82d3 | 1533 | |
ba94455c EB |
1534 | u16 hpi_aesebu_transmitter_get_channel_status(u32 h_control, u16 index, |
1535 | u16 *pw_data); | |
719f82d3 | 1536 | |
ba94455c EB |
1537 | u16 hpi_aesebu_transmitter_query_format(const u32 h_aes_tx, const u32 index, |
1538 | u16 *pw_format); | |
719f82d3 | 1539 | |
ba94455c | 1540 | u16 hpi_aesebu_transmitter_set_format(u32 h_control, u16 output_format); |
719f82d3 | 1541 | |
ba94455c | 1542 | u16 hpi_aesebu_transmitter_get_format(u32 h_control, u16 *pw_output_format); |
719f82d3 EB |
1543 | |
1544 | /***********************/ | |
ba94455c | 1545 | /* Multiplexer control */ |
719f82d3 | 1546 | /***********************/ |
ba94455c EB |
1547 | u16 hpi_multiplexer_set_source(u32 h_control, u16 source_node_type, |
1548 | u16 source_node_index); | |
719f82d3 | 1549 | |
ba94455c | 1550 | u16 hpi_multiplexer_get_source(u32 h_control, u16 *source_node_type, |
719f82d3 EB |
1551 | u16 *source_node_index); |
1552 | ||
ba94455c EB |
1553 | u16 hpi_multiplexer_query_source(u32 h_control, u16 index, |
1554 | u16 *source_node_type, u16 *source_node_index); | |
1555 | ||
719f82d3 | 1556 | /***************/ |
ba94455c | 1557 | /* Vox control */ |
719f82d3 | 1558 | /***************/ |
ba94455c | 1559 | u16 hpi_vox_set_threshold(u32 h_control, short an_gain0_01dB); |
719f82d3 | 1560 | |
ba94455c | 1561 | u16 hpi_vox_get_threshold(u32 h_control, short *an_gain0_01dB); |
719f82d3 EB |
1562 | |
1563 | /*********************/ | |
1564 | /* Bitstream control */ | |
1565 | /*********************/ | |
ba94455c | 1566 | u16 hpi_bitstream_set_clock_edge(u32 h_control, u16 edge_type); |
719f82d3 | 1567 | |
ba94455c | 1568 | u16 hpi_bitstream_set_data_polarity(u32 h_control, u16 polarity); |
719f82d3 | 1569 | |
ba94455c EB |
1570 | u16 hpi_bitstream_get_activity(u32 h_control, u16 *pw_clk_activity, |
1571 | u16 *pw_data_activity); | |
719f82d3 EB |
1572 | |
1573 | /***********************/ | |
1574 | /* SampleClock control */ | |
1575 | /***********************/ | |
1576 | ||
ba94455c EB |
1577 | u16 hpi_sample_clock_query_source(const u32 h_clock, const u32 index, |
1578 | u16 *pw_source); | |
719f82d3 | 1579 | |
ba94455c | 1580 | u16 hpi_sample_clock_set_source(u32 h_control, u16 source); |
719f82d3 | 1581 | |
ba94455c | 1582 | u16 hpi_sample_clock_get_source(u32 h_control, u16 *pw_source); |
719f82d3 | 1583 | |
ba94455c EB |
1584 | u16 hpi_sample_clock_query_source_index(const u32 h_clock, const u32 index, |
1585 | const u32 source, u16 *pw_source_index); | |
719f82d3 | 1586 | |
ba94455c | 1587 | u16 hpi_sample_clock_set_source_index(u32 h_control, u16 source_index); |
719f82d3 | 1588 | |
ba94455c | 1589 | u16 hpi_sample_clock_get_source_index(u32 h_control, u16 *pw_source_index); |
719f82d3 | 1590 | |
ba94455c | 1591 | u16 hpi_sample_clock_get_sample_rate(u32 h_control, u32 *psample_rate); |
719f82d3 | 1592 | |
ba94455c EB |
1593 | u16 hpi_sample_clock_query_local_rate(const u32 h_clock, const u32 index, |
1594 | u32 *psource); | |
719f82d3 | 1595 | |
ba94455c | 1596 | u16 hpi_sample_clock_set_local_rate(u32 h_control, u32 sample_rate); |
719f82d3 | 1597 | |
ba94455c | 1598 | u16 hpi_sample_clock_get_local_rate(u32 h_control, u32 *psample_rate); |
719f82d3 | 1599 | |
ba94455c | 1600 | u16 hpi_sample_clock_set_auto(u32 h_control, u32 enable); |
719f82d3 | 1601 | |
ba94455c | 1602 | u16 hpi_sample_clock_get_auto(u32 h_control, u32 *penable); |
719f82d3 | 1603 | |
ba94455c | 1604 | u16 hpi_sample_clock_set_local_rate_lock(u32 h_control, u32 lock); |
719f82d3 | 1605 | |
ba94455c | 1606 | u16 hpi_sample_clock_get_local_rate_lock(u32 h_control, u32 *plock); |
719f82d3 EB |
1607 | |
1608 | /***********************/ | |
1609 | /* Microphone control */ | |
1610 | /***********************/ | |
ba94455c | 1611 | u16 hpi_microphone_set_phantom_power(u32 h_control, u16 on_off); |
719f82d3 | 1612 | |
ba94455c | 1613 | u16 hpi_microphone_get_phantom_power(u32 h_control, u16 *pw_on_off); |
719f82d3 | 1614 | |
ba94455c EB |
1615 | /********************************/ |
1616 | /* Parametric Equalizer control */ | |
1617 | /********************************/ | |
1618 | u16 hpi_parametric_eq_get_info(u32 h_control, u16 *pw_number_of_bands, | |
1619 | u16 *pw_enabled); | |
719f82d3 | 1620 | |
ba94455c | 1621 | u16 hpi_parametric_eq_set_state(u32 h_control, u16 on_off); |
719f82d3 | 1622 | |
ba94455c EB |
1623 | u16 hpi_parametric_eq_set_band(u32 h_control, u16 index, u16 type, |
1624 | u32 frequency_hz, short q100, short gain0_01dB); | |
719f82d3 | 1625 | |
ba94455c EB |
1626 | u16 hpi_parametric_eq_get_band(u32 h_control, u16 index, u16 *pn_type, |
1627 | u32 *pfrequency_hz, short *pnQ100, short *pn_gain0_01dB); | |
719f82d3 | 1628 | |
ba94455c | 1629 | u16 hpi_parametric_eq_get_coeffs(u32 h_control, u16 index, short coeffs[5] |
719f82d3 EB |
1630 | ); |
1631 | ||
ba94455c EB |
1632 | /*******************************/ |
1633 | /* Compressor Expander control */ | |
1634 | /*******************************/ | |
719f82d3 | 1635 | |
ba94455c | 1636 | u16 hpi_compander_set_enable(u32 h_control, u32 on); |
168f1b07 | 1637 | |
ba94455c | 1638 | u16 hpi_compander_get_enable(u32 h_control, u32 *pon); |
168f1b07 | 1639 | |
ba94455c | 1640 | u16 hpi_compander_set_makeup_gain(u32 h_control, short makeup_gain0_01dB); |
168f1b07 | 1641 | |
ba94455c | 1642 | u16 hpi_compander_get_makeup_gain(u32 h_control, short *pn_makeup_gain0_01dB); |
168f1b07 | 1643 | |
ba94455c EB |
1644 | u16 hpi_compander_set_attack_time_constant(u32 h_control, u32 index, |
1645 | u32 attack); | |
168f1b07 | 1646 | |
ba94455c EB |
1647 | u16 hpi_compander_get_attack_time_constant(u32 h_control, u32 index, |
1648 | u32 *pw_attack); | |
168f1b07 | 1649 | |
ba94455c EB |
1650 | u16 hpi_compander_set_decay_time_constant(u32 h_control, u32 index, |
1651 | u32 decay); | |
168f1b07 | 1652 | |
ba94455c EB |
1653 | u16 hpi_compander_get_decay_time_constant(u32 h_control, u32 index, |
1654 | u32 *pw_decay); | |
168f1b07 | 1655 | |
ba94455c EB |
1656 | u16 hpi_compander_set_threshold(u32 h_control, u32 index, |
1657 | short threshold0_01dB); | |
168f1b07 | 1658 | |
ba94455c EB |
1659 | u16 hpi_compander_get_threshold(u32 h_control, u32 index, |
1660 | short *pn_threshold0_01dB); | |
168f1b07 | 1661 | |
ba94455c | 1662 | u16 hpi_compander_set_ratio(u32 h_control, u32 index, u32 ratio100); |
719f82d3 | 1663 | |
ba94455c | 1664 | u16 hpi_compander_get_ratio(u32 h_control, u32 index, u32 *pw_ratio100); |
719f82d3 | 1665 | |
ba94455c EB |
1666 | /********************/ |
1667 | /* Cobranet control */ | |
1668 | /********************/ | |
1669 | u16 hpi_cobranet_hmi_write(u32 h_control, u32 hmi_address, u32 byte_count, | |
1670 | u8 *pb_data); | |
719f82d3 | 1671 | |
ba94455c EB |
1672 | u16 hpi_cobranet_hmi_read(u32 h_control, u32 hmi_address, u32 max_byte_count, |
1673 | u32 *pbyte_count, u8 *pb_data); | |
719f82d3 | 1674 | |
ba94455c EB |
1675 | u16 hpi_cobranet_hmi_get_status(u32 h_control, u32 *pstatus, |
1676 | u32 *preadable_size, u32 *pwriteable_size); | |
719f82d3 | 1677 | |
ba94455c | 1678 | u16 hpi_cobranet_get_ip_address(u32 h_control, u32 *pdw_ip_address); |
719f82d3 | 1679 | |
ba94455c | 1680 | u16 hpi_cobranet_set_ip_address(u32 h_control, u32 dw_ip_address); |
719f82d3 | 1681 | |
ba94455c | 1682 | u16 hpi_cobranet_get_static_ip_address(u32 h_control, u32 *pdw_ip_address); |
719f82d3 | 1683 | |
ba94455c | 1684 | u16 hpi_cobranet_set_static_ip_address(u32 h_control, u32 dw_ip_address); |
719f82d3 | 1685 | |
1d595d2a EB |
1686 | u16 hpi_cobranet_get_macaddress(u32 h_control, u32 *p_mac_msbs, |
1687 | u32 *p_mac_lsbs); | |
719f82d3 | 1688 | |
ba94455c EB |
1689 | /*************************/ |
1690 | /* Tone Detector control */ | |
1691 | /*************************/ | |
1692 | u16 hpi_tone_detector_get_state(u32 hC, u32 *state); | |
719f82d3 | 1693 | |
ba94455c | 1694 | u16 hpi_tone_detector_set_enable(u32 hC, u32 enable); |
719f82d3 | 1695 | |
ba94455c | 1696 | u16 hpi_tone_detector_get_enable(u32 hC, u32 *enable); |
719f82d3 | 1697 | |
ba94455c | 1698 | u16 hpi_tone_detector_set_event_enable(u32 hC, u32 event_enable); |
719f82d3 | 1699 | |
ba94455c | 1700 | u16 hpi_tone_detector_get_event_enable(u32 hC, u32 *event_enable); |
719f82d3 | 1701 | |
ba94455c | 1702 | u16 hpi_tone_detector_set_threshold(u32 hC, int threshold); |
719f82d3 | 1703 | |
ba94455c | 1704 | u16 hpi_tone_detector_get_threshold(u32 hC, int *threshold); |
719f82d3 | 1705 | |
ba94455c | 1706 | u16 hpi_tone_detector_get_frequency(u32 hC, u32 index, u32 *frequency); |
719f82d3 | 1707 | |
ba94455c EB |
1708 | /****************************/ |
1709 | /* Silence Detector control */ | |
1710 | /****************************/ | |
1711 | u16 hpi_silence_detector_get_state(u32 hC, u32 *state); | |
719f82d3 | 1712 | |
ba94455c | 1713 | u16 hpi_silence_detector_set_enable(u32 hC, u32 enable); |
719f82d3 | 1714 | |
ba94455c | 1715 | u16 hpi_silence_detector_get_enable(u32 hC, u32 *enable); |
719f82d3 | 1716 | |
ba94455c | 1717 | u16 hpi_silence_detector_set_event_enable(u32 hC, u32 event_enable); |
719f82d3 | 1718 | |
ba94455c | 1719 | u16 hpi_silence_detector_get_event_enable(u32 hC, u32 *event_enable); |
719f82d3 | 1720 | |
ba94455c | 1721 | u16 hpi_silence_detector_set_delay(u32 hC, u32 delay); |
719f82d3 | 1722 | |
ba94455c | 1723 | u16 hpi_silence_detector_get_delay(u32 hC, u32 *delay); |
719f82d3 | 1724 | |
ba94455c | 1725 | u16 hpi_silence_detector_set_threshold(u32 hC, int threshold); |
719f82d3 | 1726 | |
ba94455c EB |
1727 | u16 hpi_silence_detector_get_threshold(u32 hC, int *threshold); |
1728 | /*********************/ | |
1729 | /* Utility functions */ | |
1730 | /*********************/ | |
719f82d3 EB |
1731 | |
1732 | u16 hpi_format_create(struct hpi_format *p_format, u16 channels, u16 format, | |
1733 | u32 sample_rate, u32 bit_rate, u32 attributes); | |
1734 | ||
ba94455c | 1735 | #endif /*_HPI_H_ */ |