1
/******************************************************************************
3
AudioScience HPI driver
4
Copyright (C) 1997-2011 AudioScience Inc. <support@audioscience.com>
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;
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.
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
22
AudioScience Hardware Programming Interface (HPI)
23
public API definition.
25
The HPI is a low-level hardware abstraction layer to all
26
AudioScience digital audio adapters
28
(C) Copyright AudioScience Inc. 1998-2010
34
#include <linux/types.h>
35
#define HPI_BUILD_KERNEL_MODE
37
/******************************************************************************/
38
/******** HPI API DEFINITIONS *****/
39
/******************************************************************************/
41
/*******************************************/
42
/** Audio format types
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,
56
Windows equivalent is WAVE_FORMAT_MPEG.
58
The following table shows what combinations of mode and bitrate are possible:
60
<table border=1 cellspacing=0 cellpadding=5>
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>
83
HPI_FORMAT_MPEG_L2 = 4,
85
Windows equivalent is WAVE_FORMAT_MPEG.
87
The following table shows what combinations of mode and bitrate are possible:
89
<table border=1 cellspacing=0 cellpadding=5>
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>
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
114
\b * Available on the ASI6000 series only
116
HPI_FORMAT_MPEG_L3 = 5,
118
HPI_FORMAT_DOLBY_AC2 = 6,
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.
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.
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
151
/*******************************************/
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. */
170
/*******************************************/
171
/** Source node types
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,
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. */
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,
198
HPI_SOURCENODE_INTERNAL = 113, /**< node internal to the device. */
199
HPI_SOURCENODE_AVB = 114, /**< AVB input stream */
200
HPI_SOURCENODE_BLULINK = 115, /**< BLU-link input channel */
201
/* !!!Update this AND hpidebug.h if you add a new sourcenode type!!! */
202
HPI_SOURCENODE_LAST_INDEX = 115 /**< largest ID */
203
/* AX6 max sourcenode types = 15 */
206
/*******************************************/
207
/** Destination node types
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,
216
/** In Stream (Record) node. */
217
HPI_DESTNODE_ISTREAM = 201,
218
HPI_DESTNODE_LINEOUT = 202, /**< line out node. */
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. */
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,
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. */
232
/* !!!Update this AND hpidebug.h if you add a new destnode type!!! */
233
HPI_DESTNODE_LAST_INDEX = 211 /**< largest ID */
234
/* AX6 max destnode types = 15 */
237
/*******************************************/
238
/** Mixer control types
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. */
249
HPI_CONTROL_AESEBU_TRANSMITTER = 6, /**< AES/EBU transmitter control */
250
HPI_CONTROL_AESEBUTX = 6, /* HPI_CONTROL_AESEBU_TRANSMITTER */
252
HPI_CONTROL_AESEBU_RECEIVER = 7, /**< AES/EBU receiver control. */
253
HPI_CONTROL_AESEBURX = 7, /* HPI_CONTROL_AESEBU_RECEIVER */
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. */
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. */
268
HPI_CONTROL_EQUALIZER = 19, /*HPI_CONTROL_PARAMETRIC_EQ */
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. */
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 */
283
/*******************************************/
284
/** Adapter properties
285
These are used in HPI_AdapterSetProperty() and HPI_AdapterGetProperty()
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.
296
HPI_ADAPTER_PROPERTY_ERRATA_1 = 1,
298
/** Adapter grouping property
299
Indicates whether the adapter supports the grouping API (for ASIO and SSX2)
301
HPI_ADAPTER_PROPERTY_GROUPING = 2,
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.
308
HPI_ADAPTER_PROPERTY_ENABLE_SSX2 = 3,
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
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.
318
HPI_ADAPTER_PROPERTY_SSX2_SETTING = 4,
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.
327
HPI_ADAPTER_PROPERTY_IRQ_RATE = 5,
329
/** Base number for readonly properties */
330
HPI_ADAPTER_PROPERTY_READONLYBASE = 256,
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.
337
HPI_ADAPTER_PROPERTY_LATENCY = 256,
339
/** Readonly adapter granularity property.
340
The granulariy is the smallest size chunk of stereo samples that is processed by
342
This property returns the record granularity in samples in Property 1.
343
Property 2 returns the play granularity.
345
HPI_ADAPTER_PROPERTY_GRANULARITY = 257,
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,
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,
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,
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,
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,
382
/** Readonly debug log buffer information */
383
HPI_ADAPTER_PROPERTY_LOGTABLEN = 263,
384
HPI_ADAPTER_PROPERTY_LOGTABBEG = 264,
386
/** Readonly adapter IP address
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,
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.
398
HPI_ADAPTER_PROPERTY_BUFFER_UPDATE_COUNT = 266,
400
/** Readonly mixer and stream intervals
402
These intervals are measured in mixer frames.
403
To convert to time, divide by the adapter samplerate.
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.
409
Property 1 is the mixer interval in mixer frames.
410
Property 2 is the stream update interval in mixer frames.
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)
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)
422
HPI_ADAPTER_PROPERTY_CAPS2 = 269,
424
/** Readonly adapter sync header connection count.
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
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.
439
HPI_ADAPTER_PROPERTY_SUPPORTS_IRQ = 272,
440
/** Readonly supports firmware updating.
441
Indicates that the adapter implements an interface to update firmware
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
451
HPI_ADAPTER_PROPERTY_FIRMWARE_ID = 274
454
/** Adapter mode commands
456
Used in wQueryOrSet parameter of HPI_AdapterSetModeEx().
459
enum HPI_ADAPTER_MODE_CMDS {
460
/** Set the mode to the given parameter */
461
HPI_ADAPTER_MODE_SET = 0,
462
/** Return 0 or error depending whether mode is valid,
463
but don't set the mode */
464
HPI_ADAPTER_MODE_QUERY = 1
468
These are used by HPI_AdapterSetModeEx()
470
\warning - more than 16 possible modes breaks
471
a bitmask in the Windows WAVE DLL
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
485
HPI_ADAPTER_MODE_4OSTREAM = 1,
487
/** 6 outstream mode.
488
- ASI6012: 1 instream,
489
- ASI6022, ASI6122: 2 instreams
490
- ASI652x, ASI662x: 4 instreams
492
HPI_ADAPTER_MODE_6OSTREAM = 2,
494
/** 8 outstream mode.
495
- ASI6114: 8 instreams
496
- ASI6118: 8 instreams
497
- ASI6585: 8 instreams
499
HPI_ADAPTER_MODE_8OSTREAM = 3,
501
/** 16 outstream mode.
502
- ASI6416 16 instreams
503
- ASI6518, ASI6618 16 instreams
504
- ASI6118 16 mono out and in streams
506
HPI_ADAPTER_MODE_16OSTREAM = 4,
508
/** one outstream mode.
509
- ASI5111 1 outstream, 1 instream
511
HPI_ADAPTER_MODE_1OSTREAM = 5,
513
/** ASI504X mode 1. 12 outstream, 4 instream 0 to 48kHz sample rates
514
(see ASI504X datasheet for more info).
516
HPI_ADAPTER_MODE_1 = 6,
518
/** ASI504X mode 2. 4 outstreams, 4 instreams at 0 to 192kHz sample rates
519
(see ASI504X datasheet for more info).
521
HPI_ADAPTER_MODE_2 = 7,
523
/** ASI504X mode 3. 4 outstreams, 4 instreams at 0 to 192kHz sample rates
524
(see ASI504X datasheet for more info).
526
HPI_ADAPTER_MODE_3 = 8,
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.
533
HPI_ADAPTER_MODE_MULTICHANNEL = 9,
535
/** 12 outstream mode.
536
- ASI6514, ASI6614: 2 instreams
537
- ASI6540,ASI6544: 8 instreams
538
- ASI6640,ASI6644: 8 instreams
540
HPI_ADAPTER_MODE_12OSTREAM = 10,
542
/** 9 outstream mode.
543
- ASI6044: 8 instreams
545
HPI_ADAPTER_MODE_9OSTREAM = 11,
548
- ASI6416: 16 outstreams/instreams
549
- ASI5402: 2 outstreams/instreams
551
HPI_ADAPTER_MODE_MONO = 12,
553
/** Low latency mode.
554
- ASI6416/ASI6316: 1 16 channel outstream and instream
556
HPI_ADAPTER_MODE_LOW_LATENCY = 13
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)
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 */
569
/******************************************* STREAM ATTRIBUTES ****/
571
/** MPEG Ancillary Data modes
573
The mode for the ancillary data insertion or extraction to operate in.
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.
586
/** Ancillary Data Alignment
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
597
MPEG modes - can be used optionally for HPI_FormatCreate()
598
parameter dwAttributes.
600
Using any mode setting other than HPI_MPEG_MODE_DEFAULT
601
with single channel format will return an error.
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,
612
HPI_MPEG_MODE_JOINTSTEREO = 2,
613
/** Left and Right channels are completely independent */
614
HPI_MPEG_MODE_DUALCHANNEL = 3
616
/******************************************* MIXER ATTRIBUTES ****/
618
/* \defgroup mixer_flags Mixer flags for HPI_MIXER_GET_CONTROL_MULTIPLE_VALUES
621
#define HPI_MIXER_GET_CONTROL_MULTIPLE_CHANGED (0)
622
#define HPI_MIXER_GET_CONTROL_MULTIPLE_RESET (1)
625
/** Commands used by HPI_MixerStore()
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,
639
/** Unimplemented - save the attributes of a single control. */
640
HPI_MIXER_STORE_SAVE_SINGLE = 6
643
/****************************/
644
/* CONTROL ATTRIBUTE VALUES */
645
/****************************/
647
/** Used by mixer plugin enable functions
649
E.g. HPI_ParametricEq_SetState()
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. */
657
/* Volume control special gain values */
659
/** volumes units are 100ths of a dB
662
#define HPI_UNITS_PER_dB 100
663
/** turns volume control OFF or MUTE
666
#define HPI_GAIN_OFF (-100 * HPI_UNITS_PER_dB)
668
/** channel mask specifying all channels
671
#define HPI_BITMASK_ALL_CHANNELS (0xFFFFFFFF)
673
/** value returned for no signal
676
#define HPI_METER_MINIMUM (-150 * HPI_UNITS_PER_dB)
678
/** autofade profiles
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
688
/** The physical encoding format of the AESEBU I/O.
690
Used in HPI_Aesebu_Transmitter_SetFormat(), HPI_Aesebu_Receiver_SetFormat()
691
along with related Get and Query functions
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
701
/** AES/EBU error status bits
703
Returned by HPI_Aesebu_Receiver_GetErrorStatus()
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
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
732
/** The PTY when the tuner has not received any PTY. */
733
#define HPI_PAD_PROGRAM_TYPE_INVALID 0xffff
736
/** Data types for PTY string translation.
740
HPI_RDS_DATATYPE_RDS = 0, /**< RDS bitstream.*/
741
HPI_RDS_DATATYPE_RBDS = 1 /**< RBDS bitstream.*/
746
Used for HPI_Tuner_SetBand(),HPI_Tuner_GetBand()
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*/
760
HPI_TUNER_BAND_DAB = 10,
761
HPI_TUNER_BAND_LAST = 10 /**< the index of the last tuner band. */
764
/** Tuner mode attributes
766
Used by HPI_Tuner_SetMode(), HPI_Tuner_GetMode()
770
enum HPI_TUNER_MODES {
771
HPI_TUNER_MODE_RSS = 1, /**< control RSS */
772
HPI_TUNER_MODE_RDS = 2 /**< control RBDS/RDS */
775
/** Tuner mode attribute values
777
Used by HPI_Tuner_SetMode(), HPI_Tuner_GetMode()
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 */
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 */
791
/** Tuner Status Bits
793
These bitfield values are returned by a call to HPI_Tuner_GetStatus().
794
Multiple fields are returned from a single call.
797
enum HPI_TUNER_STATUS_BITS {
798
HPI_TUNER_VIDEO_COLOR_PRESENT = 0x0001, /**< video color is present. */
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. */
809
Used for HPI_ChannelModeSet/Get()
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
830
/** SampleClock source values
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,
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,
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,
851
/** Blu link sample clock*/
852
HPI_SAMPLECLOCK_SOURCE_BLULINK = 11,
853
/*! Update this if you add a new clock source.*/
854
HPI_SAMPLECLOCK_SOURCE_LAST = 11
857
/** Equalizer filter types. Used by HPI_ParametricEq_SetBand()
860
enum HPI_FILTER_TYPE {
861
HPI_FILTER_TYPE_BYPASS = 0, /**< filter is turned off */
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 */
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 */
873
/** Async Event sources
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. */
881
/*******************************************/
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()
889
\note When a new error code is added HPI_GetErrorText() MUST be updated.
890
\note Codes 1-100 are reserved for driver use
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,
900
/** The specified object does not exist. */
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,
908
/* HPI_ERROR_SUBSYSFINDADAPTERS_GETINFO= 107 */
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,
916
/* An HPI handle is invalid (uninitialised?). */
917
HPI_ERROR_INVALID_HANDLE = 111,
918
/** A function or attribute has not been implemented yet. */
919
HPI_ERROR_UNIMPLEMENTED = 112,
920
/** There are too many clients attempting
921
to access a network resource. */
922
HPI_ERROR_NETWORK_TOO_MANY_CLIENTS = 113,
923
/** Response buffer passed to HPI_Message
924
was smaller than returned response.
925
wSpecificError field of hpi response contains the required size.
927
HPI_ERROR_RESPONSE_BUFFER_TOO_SMALL = 114,
928
/** The returned response did not match the sent message */
929
HPI_ERROR_RESPONSE_MISMATCH = 115,
930
/** A control setting that should have been cached was not. */
931
HPI_ERROR_CONTROL_CACHING = 116,
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.
936
HPI_ERROR_MESSAGE_BUFFER_TOO_SMALL = 117,
938
/* HPI_ERROR_TOO_MANY_ADAPTERS= 200 */
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. */
944
HPI_ERROR_DUPLICATE_ADAPTER_NUMBER = 203,
945
/** DSP code failed to bootload. Usually a DSP memory test failure. */
946
HPI_ERROR_DSP_BOOTLOAD = 204,
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,
951
/** Could not allocate memory */
952
HPI_ERROR_MEMORY_ALLOC = 208,
953
/** Failed to correctly load/config PLD. (unused) */
954
HPI_ERROR_PLD_LOAD = 209,
955
/** Unexpected end of file, block length too big etc. */
956
HPI_ERROR_DSP_FILE_FORMAT = 210,
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,
962
/* HPI_ERROR_DSP_FILE_READ_ERROR= 213, */
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,
972
/* HPI_ERROR_FLASH = 220, */
974
/** Flash has bad checksum */
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,
982
HPI_ERROR_FLASH_READ = 228,
983
HPI_ERROR_FLASH_READ_NO_FILE = 229,
984
HPI_ERROR_FLASH_SIZE = 230,
986
/** Reserved for OEMs. */
987
HPI_ERROR_RESERVED_1 = 290,
989
/* HPI_ERROR_INVALID_STREAM = 300 use HPI_ERROR_INVALID_OBJ_INDEX */
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,
1000
/* HPI_ERROR_BUFFER_FULL = 306 use HPI_ERROR_INVALID_DATASIZE */
1001
/* HPI_ERROR_BUFFER_EMPTY = 307 use HPI_ERROR_INVALID_DATASIZE */
1002
/** Null data pointer used for stream read/write. */
1003
HPI_ERROR_INVALID_DATA_POINTER = 308,
1004
/** Packet ordering error for stream read/write. */
1005
HPI_ERROR_INVALID_PACKET_ORDER = 309,
1007
/** Object can't do requested operation in its current
1008
state, eg set format, change rec mux state while recording.*/
1009
HPI_ERROR_INVALID_OPERATION = 310,
1011
/** Where a SRG is shared amongst streams, an incompatible samplerate
1012
is one that is different to any currently active stream. */
1013
HPI_ERROR_INCOMPATIBLE_SAMPLERATE = 311,
1014
/** Adapter mode is illegal.*/
1015
HPI_ERROR_BAD_ADAPTER_MODE = 312,
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,
1025
/** Stream wait cancelled before threshold reached. */
1026
HPI_ERROR_WAIT_CANCELLED = 316,
1027
/** A character string is invalid. */
1028
HPI_ERROR_INVALID_STRING = 317,
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,
1042
HPI_ERROR_I2C_MISSING_ACK = 405,
1043
/** Control is busy, or coming out of
1044
reset and cannot be accessed at this time. */
1045
HPI_ERROR_CONTROL_NOT_READY = 407,
1047
/** Non volatile memory */
1048
HPI_ERROR_NVMEM_BUSY = 450,
1049
HPI_ERROR_NVMEM_FULL = 451,
1050
HPI_ERROR_NVMEM_FAIL = 452,
1053
HPI_ERROR_I2C_BAD_ADR = 460,
1055
/** Entity type did not match requested type */
1056
HPI_ERROR_ENTITY_TYPE_MISMATCH = 470,
1057
/** Entity item count did not match requested count */
1058
HPI_ERROR_ENTITY_ITEM_COUNT = 471,
1059
/** Entity type is not one of the valid types */
1060
HPI_ERROR_ENTITY_TYPE_INVALID = 472,
1061
/** Entity role is not one of the valid roles */
1062
HPI_ERROR_ENTITY_ROLE_INVALID = 473,
1063
/** Entity size doesn't match target size */
1064
HPI_ERROR_ENTITY_SIZE_MISMATCH = 474,
1066
/* AES18 specific errors were 500..507 */
1068
/** custom error to use for debugging */
1069
HPI_ERROR_CUSTOM = 600,
1071
/** hpioct32.c can't obtain mutex */
1072
HPI_ERROR_MUTEX_TIMEOUT = 700,
1074
/** Backend errors used to be greater than this.
1075
\deprecated Now, all backends return only errors defined here in hpi.h
1077
HPI_ERROR_BACKEND_BASE = 900,
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.
1088
/** \defgroup maximums HPI maximum values
1091
/** Maximum number of PCI HPI adapters */
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
1102
/** Networked adapters have index >= 100 */
1103
#define HPI_MIN_NETWORK_ADAPTER_IDX 100
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
1116
#ifndef DISABLE_PRAGMA_PACK1
1117
#pragma pack(push, 1)
1120
/** Structure containing sample format information.
1121
See also HPI_FormatCreate().
1125
/**< 11025, 32000, 44100 ... */
1126
u32 bit_rate; /**< for MPEG */
1128
/**< Stereo/JointStereo/Mono */
1130
/**< Legacy ancillary mode or idle bit */
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. */
1136
struct hpi_anc_frame {
1137
u32 valid_bits_in_this_frame;
1138
u8 b_data[HPI_MAX_ANC_BYTES_PER_FRAME];
1141
/** An object for containing a single async event.
1143
struct hpi_async_event {
1144
u16 event_type; /**< type of event. \sa async_event */
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. */
1150
u16 index; /**< GPIO bit index. */
1153
u16 node_index; /**< what node is the control on ? */
1154
u16 node_type; /**< what type of node is the control on ? */
1159
#ifndef DISABLE_PRAGMA_PACK1
1168
u16 hpi_stream_estimate_buffer_size(struct hpi_format *pF,
1169
u32 host_polling_rate_in_milli_seconds, u32 *recommended_buffer_size);
1175
u16 hpi_subsys_get_version_ex(u32 *pversion_ex);
1177
u16 hpi_subsys_get_num_adapters(int *pn_num_adapters);
1179
u16 hpi_subsys_get_adapter(int iterator, u32 *padapter_index,
1180
u16 *pw_adapter_type);
1186
u16 hpi_adapter_open(u16 adapter_index);
1188
u16 hpi_adapter_close(u16 adapter_index);
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);
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);
1198
u16 hpi_adapter_set_mode(u16 adapter_index, u32 adapter_mode);
1200
u16 hpi_adapter_set_mode_ex(u16 adapter_index, u32 adapter_mode,
1203
u16 hpi_adapter_get_mode(u16 adapter_index, u32 *padapter_mode);
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);
1209
u16 hpi_adapter_test_assert(u16 adapter_index, u16 assert_id);
1211
u16 hpi_adapter_enable_capability(u16 adapter_index, u16 capability, u32 key);
1213
u16 hpi_adapter_self_test(u16 adapter_index);
1215
u16 hpi_adapter_debug_read(u16 adapter_index, u32 dsp_address, char *p_bytes,
1218
u16 hpi_adapter_set_property(u16 adapter_index, u16 property, u16 paramter1,
1221
u16 hpi_adapter_get_property(u16 adapter_index, u16 property,
1222
u16 *pw_paramter1, u16 *pw_paramter2);
1224
u16 hpi_adapter_enumerate_property(u16 adapter_index, u16 index,
1225
u16 what_to_enumerate, u16 property_index, u32 *psetting);
1229
u16 hpi_outstream_open(u16 adapter_index, u16 outstream_index,
1232
u16 hpi_outstream_close(u32 h_outstream);
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);
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);
1241
u16 hpi_outstream_start(u32 h_outstream);
1243
u16 hpi_outstream_wait_start(u32 h_outstream);
1245
u16 hpi_outstream_stop(u32 h_outstream);
1247
u16 hpi_outstream_sinegen(u32 h_outstream);
1249
u16 hpi_outstream_reset(u32 h_outstream);
1251
u16 hpi_outstream_query_format(u32 h_outstream, struct hpi_format *p_format);
1253
u16 hpi_outstream_set_format(u32 h_outstream, struct hpi_format *p_format);
1255
u16 hpi_outstream_set_punch_in_out(u32 h_outstream, u32 punch_in_sample,
1256
u32 punch_out_sample);
1258
u16 hpi_outstream_set_velocity(u32 h_outstream, short velocity);
1260
u16 hpi_outstream_ancillary_reset(u32 h_outstream, u16 mode);
1262
u16 hpi_outstream_ancillary_get_info(u32 h_outstream, u32 *pframes_available);
1264
u16 hpi_outstream_ancillary_read(u32 h_outstream,
1265
struct hpi_anc_frame *p_anc_frame_buffer,
1266
u32 anc_frame_buffer_size_in_bytes,
1267
u32 number_of_ancillary_frames_to_read);
1269
u16 hpi_outstream_set_time_scale(u32 h_outstream, u32 time_scaleX10000);
1271
u16 hpi_outstream_host_buffer_allocate(u32 h_outstream, u32 size_in_bytes);
1273
u16 hpi_outstream_host_buffer_free(u32 h_outstream);
1275
u16 hpi_outstream_group_add(u32 h_outstream, u32 h_stream);
1277
u16 hpi_outstream_group_get_map(u32 h_outstream, u32 *poutstream_map,
1278
u32 *pinstream_map);
1280
u16 hpi_outstream_group_reset(u32 h_outstream);
1285
u16 hpi_instream_open(u16 adapter_index, u16 instream_index,
1288
u16 hpi_instream_close(u32 h_instream);
1290
u16 hpi_instream_query_format(u32 h_instream,
1291
const struct hpi_format *p_format);
1293
u16 hpi_instream_set_format(u32 h_instream,
1294
const struct hpi_format *p_format);
1296
u16 hpi_instream_read_buf(u32 h_instream, u8 *pb_read_buf, u32 bytes_to_read);
1298
u16 hpi_instream_start(u32 h_instream);
1300
u16 hpi_instream_wait_start(u32 h_instream);
1302
u16 hpi_instream_stop(u32 h_instream);
1304
u16 hpi_instream_reset(u32 h_instream);
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);
1310
u16 hpi_instream_ancillary_reset(u32 h_instream, u16 bytes_per_frame,
1311
u16 mode, u16 alignment, u16 idle_bit);
1313
u16 hpi_instream_ancillary_get_info(u32 h_instream, u32 *pframe_space);
1315
u16 hpi_instream_ancillary_write(u32 h_instream,
1316
const struct hpi_anc_frame *p_anc_frame_buffer,
1317
u32 anc_frame_buffer_size_in_bytes,
1318
u32 number_of_ancillary_frames_to_write);
1320
u16 hpi_instream_host_buffer_allocate(u32 h_instream, u32 size_in_bytes);
1322
u16 hpi_instream_host_buffer_free(u32 h_instream);
1324
u16 hpi_instream_group_add(u32 h_instream, u32 h_stream);
1326
u16 hpi_instream_group_get_map(u32 h_instream, u32 *poutstream_map,
1327
u32 *pinstream_map);
1329
u16 hpi_instream_group_reset(u32 h_instream);
1334
u16 hpi_mixer_open(u16 adapter_index, u32 *ph_mixer);
1336
u16 hpi_mixer_close(u32 h_mixer);
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);
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);
1346
u16 hpi_mixer_store(u32 h_mixer, enum HPI_MIXER_STORE_COMMAND command,
1351
/******************/
1352
/* Volume control */
1353
/******************/
1354
u16 hpi_volume_set_gain(u32 h_control, short an_gain0_01dB[HPI_MAX_CHANNELS]
1357
u16 hpi_volume_get_gain(u32 h_control,
1358
short an_gain0_01dB_out[HPI_MAX_CHANNELS]
1361
u16 hpi_volume_set_mute(u32 h_control, u32 mute);
1363
u16 hpi_volume_get_mute(u32 h_control, u32 *mute);
1365
#define hpi_volume_get_range hpi_volume_query_range
1366
u16 hpi_volume_query_range(u32 h_control, short *min_gain_01dB,
1367
short *max_gain_01dB, short *step_gain_01dB);
1369
u16 hpi_volume_query_channels(const u32 h_control, u32 *p_channels);
1371
u16 hpi_volume_auto_fade(u32 h_control,
1372
short an_stop_gain0_01dB[HPI_MAX_CHANNELS], u32 duration_ms);
1374
u16 hpi_volume_auto_fade_profile(u32 h_control,
1375
short an_stop_gain0_01dB[HPI_MAX_CHANNELS], u32 duration_ms,
1378
u16 hpi_volume_query_auto_fade_profile(const u32 h_control, const u32 i,
1384
u16 hpi_level_query_range(u32 h_control, short *min_gain_01dB,
1385
short *max_gain_01dB, short *step_gain_01dB);
1387
u16 hpi_level_set_gain(u32 h_control, short an_gain0_01dB[HPI_MAX_CHANNELS]
1390
u16 hpi_level_get_gain(u32 h_control,
1391
short an_gain0_01dB_out[HPI_MAX_CHANNELS]
1397
u16 hpi_meter_query_channels(const u32 h_meter, u32 *p_channels);
1399
u16 hpi_meter_get_peak(u32 h_control,
1400
short an_peak0_01dB_out[HPI_MAX_CHANNELS]
1403
u16 hpi_meter_get_rms(u32 h_control, short an_peak0_01dB_out[HPI_MAX_CHANNELS]
1406
u16 hpi_meter_set_peak_ballistics(u32 h_control, u16 attack, u16 decay);
1408
u16 hpi_meter_set_rms_ballistics(u32 h_control, u16 attack, u16 decay);
1410
u16 hpi_meter_get_peak_ballistics(u32 h_control, u16 *attack, u16 *decay);
1412
u16 hpi_meter_get_rms_ballistics(u32 h_control, u16 *attack, u16 *decay);
1414
/************************/
1415
/* ChannelMode control */
1416
/************************/
1417
u16 hpi_channel_mode_query_mode(const u32 h_mode, const u32 index,
1420
u16 hpi_channel_mode_set(u32 h_control, u16 mode);
1422
u16 hpi_channel_mode_get(u32 h_control, u16 *mode);
1427
u16 hpi_tuner_query_band(const u32 h_tuner, const u32 index, u16 *pw_band);
1429
u16 hpi_tuner_set_band(u32 h_control, u16 band);
1431
u16 hpi_tuner_get_band(u32 h_control, u16 *pw_band);
1433
u16 hpi_tuner_query_frequency(const u32 h_tuner, const u32 index,
1434
const u16 band, u32 *pfreq);
1436
u16 hpi_tuner_set_frequency(u32 h_control, u32 freq_ink_hz);
1438
u16 hpi_tuner_get_frequency(u32 h_control, u32 *pw_freq_ink_hz);
1440
u16 hpi_tuner_get_rf_level(u32 h_control, short *pw_level);
1442
u16 hpi_tuner_get_raw_rf_level(u32 h_control, short *pw_level);
1444
u16 hpi_tuner_query_gain(const u32 h_tuner, const u32 index, u16 *pw_gain);
1446
u16 hpi_tuner_set_gain(u32 h_control, short gain);
1448
u16 hpi_tuner_get_gain(u32 h_control, short *pn_gain);
1450
u16 hpi_tuner_get_status(u32 h_control, u16 *pw_status_mask, u16 *pw_status);
1452
u16 hpi_tuner_set_mode(u32 h_control, u32 mode, u32 value);
1454
u16 hpi_tuner_get_mode(u32 h_control, u32 mode, u32 *pn_value);
1456
u16 hpi_tuner_get_rds(u32 h_control, char *p_rds_data);
1458
u16 hpi_tuner_query_deemphasis(const u32 h_tuner, const u32 index,
1459
const u16 band, u32 *pdeemphasis);
1461
u16 hpi_tuner_set_deemphasis(u32 h_control, u32 deemphasis);
1462
u16 hpi_tuner_get_deemphasis(u32 h_control, u32 *pdeemphasis);
1464
u16 hpi_tuner_query_program(const u32 h_tuner, u32 *pbitmap_program);
1466
u16 hpi_tuner_set_program(u32 h_control, u32 program);
1468
u16 hpi_tuner_get_program(u32 h_control, u32 *pprogram);
1470
u16 hpi_tuner_get_hd_radio_dsp_version(u32 h_control, char *psz_dsp_version,
1471
const u32 string_size);
1473
u16 hpi_tuner_get_hd_radio_sdk_version(u32 h_control, char *psz_sdk_version,
1474
const u32 string_size);
1476
u16 hpi_tuner_get_hd_radio_signal_quality(u32 h_control, u32 *pquality);
1478
u16 hpi_tuner_get_hd_radio_signal_blend(u32 h_control, u32 *pblend);
1480
u16 hpi_tuner_set_hd_radio_signal_blend(u32 h_control, const u32 blend);
1486
u16 hpi_pad_get_channel_name(u32 h_control, char *psz_string,
1487
const u32 string_length);
1489
u16 hpi_pad_get_artist(u32 h_control, char *psz_string,
1490
const u32 string_length);
1492
u16 hpi_pad_get_title(u32 h_control, char *psz_string,
1493
const u32 string_length);
1495
u16 hpi_pad_get_comment(u32 h_control, char *psz_string,
1496
const u32 string_length);
1498
u16 hpi_pad_get_program_type(u32 h_control, u32 *ppTY);
1500
u16 hpi_pad_get_rdsPI(u32 h_control, u32 *ppI);
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);
1505
/****************************/
1506
/* AES/EBU Receiver control */
1507
/****************************/
1508
u16 hpi_aesebu_receiver_query_format(const u32 h_aes_rx, const u32 index,
1511
u16 hpi_aesebu_receiver_set_format(u32 h_control, u16 source);
1513
u16 hpi_aesebu_receiver_get_format(u32 h_control, u16 *pw_source);
1515
u16 hpi_aesebu_receiver_get_sample_rate(u32 h_control, u32 *psample_rate);
1517
u16 hpi_aesebu_receiver_get_user_data(u32 h_control, u16 index, u16 *pw_data);
1519
u16 hpi_aesebu_receiver_get_channel_status(u32 h_control, u16 index,
1522
u16 hpi_aesebu_receiver_get_error_status(u32 h_control, u16 *pw_error_data);
1524
/*******************************/
1525
/* AES/EBU Transmitter control */
1526
/*******************************/
1527
u16 hpi_aesebu_transmitter_set_sample_rate(u32 h_control, u32 sample_rate);
1529
u16 hpi_aesebu_transmitter_set_user_data(u32 h_control, u16 index, u16 data);
1531
u16 hpi_aesebu_transmitter_set_channel_status(u32 h_control, u16 index,
1534
u16 hpi_aesebu_transmitter_get_channel_status(u32 h_control, u16 index,
1537
u16 hpi_aesebu_transmitter_query_format(const u32 h_aes_tx, const u32 index,
1540
u16 hpi_aesebu_transmitter_set_format(u32 h_control, u16 output_format);
1542
u16 hpi_aesebu_transmitter_get_format(u32 h_control, u16 *pw_output_format);
1544
/***********************/
1545
/* Multiplexer control */
1546
/***********************/
1547
u16 hpi_multiplexer_set_source(u32 h_control, u16 source_node_type,
1548
u16 source_node_index);
1550
u16 hpi_multiplexer_get_source(u32 h_control, u16 *source_node_type,
1551
u16 *source_node_index);
1553
u16 hpi_multiplexer_query_source(u32 h_control, u16 index,
1554
u16 *source_node_type, u16 *source_node_index);
1559
u16 hpi_vox_set_threshold(u32 h_control, short an_gain0_01dB);
1561
u16 hpi_vox_get_threshold(u32 h_control, short *an_gain0_01dB);
1563
/*********************/
1564
/* Bitstream control */
1565
/*********************/
1566
u16 hpi_bitstream_set_clock_edge(u32 h_control, u16 edge_type);
1568
u16 hpi_bitstream_set_data_polarity(u32 h_control, u16 polarity);
1570
u16 hpi_bitstream_get_activity(u32 h_control, u16 *pw_clk_activity,
1571
u16 *pw_data_activity);
1573
/***********************/
1574
/* SampleClock control */
1575
/***********************/
1577
u16 hpi_sample_clock_query_source(const u32 h_clock, const u32 index,
1580
u16 hpi_sample_clock_set_source(u32 h_control, u16 source);
1582
u16 hpi_sample_clock_get_source(u32 h_control, u16 *pw_source);
1584
u16 hpi_sample_clock_query_source_index(const u32 h_clock, const u32 index,
1585
const u32 source, u16 *pw_source_index);
1587
u16 hpi_sample_clock_set_source_index(u32 h_control, u16 source_index);
1589
u16 hpi_sample_clock_get_source_index(u32 h_control, u16 *pw_source_index);
1591
u16 hpi_sample_clock_get_sample_rate(u32 h_control, u32 *psample_rate);
1593
u16 hpi_sample_clock_query_local_rate(const u32 h_clock, const u32 index,
1596
u16 hpi_sample_clock_set_local_rate(u32 h_control, u32 sample_rate);
1598
u16 hpi_sample_clock_get_local_rate(u32 h_control, u32 *psample_rate);
1600
u16 hpi_sample_clock_set_auto(u32 h_control, u32 enable);
1602
u16 hpi_sample_clock_get_auto(u32 h_control, u32 *penable);
1604
u16 hpi_sample_clock_set_local_rate_lock(u32 h_control, u32 lock);
1606
u16 hpi_sample_clock_get_local_rate_lock(u32 h_control, u32 *plock);
1608
/***********************/
1609
/* Microphone control */
1610
/***********************/
1611
u16 hpi_microphone_set_phantom_power(u32 h_control, u16 on_off);
1613
u16 hpi_microphone_get_phantom_power(u32 h_control, u16 *pw_on_off);
1615
/********************************/
1616
/* Parametric Equalizer control */
1617
/********************************/
1618
u16 hpi_parametric_eq_get_info(u32 h_control, u16 *pw_number_of_bands,
1621
u16 hpi_parametric_eq_set_state(u32 h_control, u16 on_off);
1623
u16 hpi_parametric_eq_set_band(u32 h_control, u16 index, u16 type,
1624
u32 frequency_hz, short q100, short gain0_01dB);
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);
1629
u16 hpi_parametric_eq_get_coeffs(u32 h_control, u16 index, short coeffs[5]
1632
/*******************************/
1633
/* Compressor Expander control */
1634
/*******************************/
1636
u16 hpi_compander_set_enable(u32 h_control, u32 on);
1638
u16 hpi_compander_get_enable(u32 h_control, u32 *pon);
1640
u16 hpi_compander_set_makeup_gain(u32 h_control, short makeup_gain0_01dB);
1642
u16 hpi_compander_get_makeup_gain(u32 h_control, short *pn_makeup_gain0_01dB);
1644
u16 hpi_compander_set_attack_time_constant(u32 h_control, u32 index,
1647
u16 hpi_compander_get_attack_time_constant(u32 h_control, u32 index,
1650
u16 hpi_compander_set_decay_time_constant(u32 h_control, u32 index,
1653
u16 hpi_compander_get_decay_time_constant(u32 h_control, u32 index,
1656
u16 hpi_compander_set_threshold(u32 h_control, u32 index,
1657
short threshold0_01dB);
1659
u16 hpi_compander_get_threshold(u32 h_control, u32 index,
1660
short *pn_threshold0_01dB);
1662
u16 hpi_compander_set_ratio(u32 h_control, u32 index, u32 ratio100);
1664
u16 hpi_compander_get_ratio(u32 h_control, u32 index, u32 *pw_ratio100);
1666
/********************/
1667
/* Cobranet control */
1668
/********************/
1669
u16 hpi_cobranet_hmi_write(u32 h_control, u32 hmi_address, u32 byte_count,
1672
u16 hpi_cobranet_hmi_read(u32 h_control, u32 hmi_address, u32 max_byte_count,
1673
u32 *pbyte_count, u8 *pb_data);
1675
u16 hpi_cobranet_hmi_get_status(u32 h_control, u32 *pstatus,
1676
u32 *preadable_size, u32 *pwriteable_size);
1678
u16 hpi_cobranet_get_ip_address(u32 h_control, u32 *pdw_ip_address);
1680
u16 hpi_cobranet_set_ip_address(u32 h_control, u32 dw_ip_address);
1682
u16 hpi_cobranet_get_static_ip_address(u32 h_control, u32 *pdw_ip_address);
1684
u16 hpi_cobranet_set_static_ip_address(u32 h_control, u32 dw_ip_address);
1686
u16 hpi_cobranet_get_macaddress(u32 h_control, u32 *p_mac_msbs,
1689
/*************************/
1690
/* Tone Detector control */
1691
/*************************/
1692
u16 hpi_tone_detector_get_state(u32 hC, u32 *state);
1694
u16 hpi_tone_detector_set_enable(u32 hC, u32 enable);
1696
u16 hpi_tone_detector_get_enable(u32 hC, u32 *enable);
1698
u16 hpi_tone_detector_set_event_enable(u32 hC, u32 event_enable);
1700
u16 hpi_tone_detector_get_event_enable(u32 hC, u32 *event_enable);
1702
u16 hpi_tone_detector_set_threshold(u32 hC, int threshold);
1704
u16 hpi_tone_detector_get_threshold(u32 hC, int *threshold);
1706
u16 hpi_tone_detector_get_frequency(u32 hC, u32 index, u32 *frequency);
1708
/****************************/
1709
/* Silence Detector control */
1710
/****************************/
1711
u16 hpi_silence_detector_get_state(u32 hC, u32 *state);
1713
u16 hpi_silence_detector_set_enable(u32 hC, u32 enable);
1715
u16 hpi_silence_detector_get_enable(u32 hC, u32 *enable);
1717
u16 hpi_silence_detector_set_event_enable(u32 hC, u32 event_enable);
1719
u16 hpi_silence_detector_get_event_enable(u32 hC, u32 *event_enable);
1721
u16 hpi_silence_detector_set_delay(u32 hC, u32 delay);
1723
u16 hpi_silence_detector_get_delay(u32 hC, u32 *delay);
1725
u16 hpi_silence_detector_set_threshold(u32 hC, int threshold);
1727
u16 hpi_silence_detector_get_threshold(u32 hC, int *threshold);
1728
/*********************/
1729
/* Utility functions */
1730
/*********************/
1732
u16 hpi_format_create(struct hpi_format *p_format, u16 channels, u16 format,
1733
u32 sample_rate, u32 bit_rate, u32 attributes);