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