Logo Search packages:      
Sourcecode: alsa-driver version File versions  Download package

hpi.h

Go to the documentation of this file.
/******************************************************************************

    AudioScience HPI driver
    Copyright (C) 1997-2003  AudioScience Inc. <support@audioscience.com>

    This program is free software; you can redistribute it and/or modify
    it under the terms of version 2 of the GNU General Public License as
    published by the Free Software Foundation;

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

*/
/** \file hpi.h

 AudioScience Hardware Programming Interface (HPI)
 public API definition.

 The HPI is a low-level hardware abstraction layer to all
 AudioScience digital audio adapters
*/
/*
 You must define one operating system that the HPI is to be compiled under
 HPI_OS_WIN32_USER   32bit Windows
 HPI_OS_DSP_C6000    DSP TI C6000  (automatically set)
 HPI_OS_WDM          Windows WDM kernel driver
 HPI_OS_LINUX        Linux userspace
 HPI_OS_LINUX_KERNEL Linux kernel (automatically set)

(C) Copyright AudioScience Inc. 1998-2010
******************************************************************************/
#ifndef _HPI_H_
#define _HPI_H_
/* HPI Version
If HPI_VER_MINOR is odd then its a development release not intended for the
public. If HPI_VER_MINOR is even then is a release version
i.e 3.05.02 is a development version
*/
#define HPI_VERSION_CONSTRUCTOR(maj, min, rel) \
      ((maj << 16) + (min << 8) + rel)

#define HPI_VER_MAJOR(v) ((int)(v >> 16))
#define HPI_VER_MINOR(v) ((int)((v >> 8) & 0xFF))
#define HPI_VER_RELEASE(v) ((int)(v & 0xFF))

/* Use single digits for versions less that 10 to avoid octal. */
#define HPI_VER HPI_VERSION_CONSTRUCTOR(4L, 3, 18)

/* Library version as documented in hpi-api-versions.txt */
#define HPI_LIB_VER  HPI_VERSION_CONSTRUCTOR(9, 0, 0)

#ifdef __cplusplus
/* *INDENT-OFF* */
extern "C" {
/* *INDENT-ON* */
#endif

#include <linux/types.h>
#define HPI_EXCLUDE_DEPRECATED

/******************************************************************************/
/******************************************************************************/
/********       HPI API DEFINITIONS                                       *****/
/******************************************************************************/
/******************************************************************************/
/*******************************************/
/**  Audio format types
\ingroup stream
*/
00076 enum HPI_FORMATS {
/** Used internally on adapter. */
00078       HPI_FORMAT_MIXER_NATIVE = 0,
/** 8-bit unsigned PCM. Windows equivalent is WAVE_FORMAT_PCM. */
00080       HPI_FORMAT_PCM8_UNSIGNED = 1,
/** 16-bit signed PCM. Windows equivalent is WAVE_FORMAT_PCM. */
00082       HPI_FORMAT_PCM16_SIGNED = 2,
/** MPEG-1 Layer-1. */
00084       HPI_FORMAT_MPEG_L1 = 3,
/** MPEG-1 Layer-2.

Windows equivalent is WAVE_FORMAT_MPEG.

The following table shows what combinations of mode and bitrate are possible:

<table border=1 cellspacing=0 cellpadding=5>
<tr>
<td><p><b>Bitrate (kbs)</b></p>
<td><p><b>Mono</b></p>
<td><p><b>Stereo,<br>Joint Stereo or<br>Dual Channel</b></p>

<tr><td>32<td>X<td>_
<tr><td>40<td>_<td>_
<tr><td>48<td>X<td>_
<tr><td>56<td>X<td>_
<tr><td>64<td>X<td>X
<tr><td>80<td>X<td>_
<tr><td>96<td>X<td>X
<tr><td>112<td>X<td>X
<tr><td>128<td>X<td>X
<tr><td>160<td>X<td>X
<tr><td>192<td>X<td>X
<tr><td>224<td>_<td>X
<tr><td>256<td>-<td>X
<tr><td>320<td>-<td>X
<tr><td>384<td>_<td>X
</table>
*/
00114       HPI_FORMAT_MPEG_L2 = 4,
/** MPEG-1 Layer-3.
Windows equivalent is WAVE_FORMAT_MPEG.

The following table shows what combinations of mode and bitrate are possible:

<table border=1 cellspacing=0 cellpadding=5>
<tr>
<td><p><b>Bitrate (kbs)</b></p>
<td><p><b>Mono<br>Stereo @ 8,<br>11.025 and<br>12kHz*</b></p>
<td><p><b>Mono<br>Stereo @ 16,<br>22.050 and<br>24kHz*</b></p>
<td><p><b>Mono<br>Stereo @ 32,<br>44.1 and<br>48kHz</b></p>

<tr><td>16<td>X<td>X<td>_
<tr><td>24<td>X<td>X<td>_
<tr><td>32<td>X<td>X<td>X
<tr><td>40<td>X<td>X<td>X
<tr><td>48<td>X<td>X<td>X
<tr><td>56<td>X<td>X<td>X
<tr><td>64<td>X<td>X<td>X
<tr><td>80<td>_<td>X<td>X
<tr><td>96<td>_<td>X<td>X
<tr><td>112<td>_<td>X<td>X
<tr><td>128<td>_<td>X<td>X
<tr><td>144<td>_<td>X<td>_
<tr><td>160<td>_<td>X<td>X
<tr><td>192<td>_<td>_<td>X
<tr><td>224<td>_<td>_<td>X
<tr><td>256<td>-<td>_<td>X
<tr><td>320<td>-<td>_<td>X
</table>
\b * Available on the ASI6000 series only
*/
00147       HPI_FORMAT_MPEG_L3 = 5,
/** Dolby AC-2. */
00149       HPI_FORMAT_DOLBY_AC2 = 6,
/** Dolbt AC-3. */
00151       HPI_FORMAT_DOLBY_AC3 = 7,
/** 16-bit PCM big-endian. */
00153       HPI_FORMAT_PCM16_BIGENDIAN = 8,
/** TAGIT-1 algorithm - hits. */
00155       HPI_FORMAT_AA_TAGIT1_HITS = 9,
/** TAGIT-1 algorithm - inserts. */
00157       HPI_FORMAT_AA_TAGIT1_INSERTS = 10,
/** 32-bit signed PCM. Windows equivalent is WAVE_FORMAT_PCM.
Each sample is a 32bit word. The most significant 24 bits contain a 24-bit
sample and the least significant 8 bits are set to 0.
*/
00162       HPI_FORMAT_PCM32_SIGNED = 11,
/** Raw bitstream - unknown format. */
00164       HPI_FORMAT_RAW_BITSTREAM = 12,
/** TAGIT-1 algorithm hits - extended. */
00166       HPI_FORMAT_AA_TAGIT1_HITS_EX1 = 13,
/** 32-bit PCM as an IEEE float. Windows equivalent is WAVE_FORMAT_IEEE_FLOAT.
Each sample is a 32bit word in IEEE754 floating point format.
The range is +1.0 to -1.0, which corresponds to digital fullscale.
*/
00171       HPI_FORMAT_PCM32_FLOAT = 14,
/** 24-bit PCM signed. Windows equivalent is WAVE_FORMAT_PCM. */
00173       HPI_FORMAT_PCM24_SIGNED = 15,
/** OEM format 1 - private. */
00175       HPI_FORMAT_OEM1 = 16,
/** OEM format 2 - private. */
00177       HPI_FORMAT_OEM2 = 17,
/** Undefined format. */
00179       HPI_FORMAT_UNDEFINED = 0xffff
};

/******************************************* in/out Stream states */
/*******************************************/
/** Stream States
\ingroup stream
*/
00187 enum HPI_STREAM_STATES {
      /** State stopped - stream is stopped. */
00189       HPI_STATE_STOPPED = 1,
      /** State playing - stream is playing audio. */
00191       HPI_STATE_PLAYING = 2,
      /** State recording - stream is recording. */
00193       HPI_STATE_RECORDING = 3,
      /** State drained - playing stream ran out of data to play. */
00195       HPI_STATE_DRAINED = 4,
      /** State generate sine - to be implemented. */
00197       HPI_STATE_SINEGEN = 5,
      /** State wait - used for inter-card sync to mean waiting for all
            cards to be ready. */
00200       HPI_STATE_WAIT = 6
};
/******************************************* mixer source node types */
/** Source node types
\ingroup mixer
*/
00206 enum HPI_SOURCENODES {
      /** This define can be used instead of 0 to indicate
      that there is no valid source node. A control that
      exists on a destination node can be searched for using a source
      node value of either 0, or HPI_SOURCENODE_NONE */
00211       HPI_SOURCENODE_NONE = 100,
      /** \deprecated Use HPI_SOURCENODE_NONE instead. */
00213       HPI_SOURCENODE_BASE = 100,
      /** Out Stream (Play) node. */
00215       HPI_SOURCENODE_OSTREAM = 101,
      /** Line in node - could be analog, AES/EBU or network. */
00217       HPI_SOURCENODE_LINEIN = 102,
00218       HPI_SOURCENODE_AESEBU_IN = 103,          /**< AES/EBU input node. */
00219       HPI_SOURCENODE_TUNER = 104,        /**< tuner node. */
00220       HPI_SOURCENODE_RF = 105,           /**< RF input node. */
00221       HPI_SOURCENODE_CLOCK_SOURCE = 106,   /**< clock source node. */
00222       HPI_SOURCENODE_RAW_BITSTREAM = 107,  /**< raw bitstream node. */
00223       HPI_SOURCENODE_MICROPHONE = 108,     /**< microphone node. */
      /** Cobranet input node -
          Audio samples come from the Cobranet network and into the device. */
00226       HPI_SOURCENODE_COBRANET = 109,
00227       HPI_SOURCENODE_ANALOG = 110,       /**< analog input node. */
00228       HPI_SOURCENODE_ADAPTER = 111,      /**< adapter node. */
      /* !!!Update this  AND hpidebug.h if you add a new sourcenode type!!! */
00230       HPI_SOURCENODE_LAST_INDEX = 111          /**< largest ID */
            /* AX6 max sourcenode types = 15 */
};

/******************************************* mixer dest node types */
/** Destination node types
\ingroup mixer
*/
00238 enum HPI_DESTNODES {
      /** This define can be used instead of 0 to indicate
      that there is no valid destination node. A control that
      exists on a source node can be searched for using a destination
      node value of either 0, or HPI_DESTNODE_NONE */
00243       HPI_DESTNODE_NONE = 200,
      /** \deprecated Use HPI_DESTNODE_NONE instead. */
00245       HPI_DESTNODE_BASE = 200,
      /** In Stream (Record) node. */
00247       HPI_DESTNODE_ISTREAM = 201,
00248       HPI_DESTNODE_LINEOUT = 202,       /**< line out node. */
00249       HPI_DESTNODE_AESEBU_OUT = 203,           /**< AES/EBU output node. */
00250       HPI_DESTNODE_RF = 204,             /**< RF output node. */
00251       HPI_DESTNODE_SPEAKER = 205,        /**< speaker output node. */
      /** Cobranet output node -
          Audio samples from the device are sent out on the Cobranet network.*/
00254       HPI_DESTNODE_COBRANET = 206,
00255       HPI_DESTNODE_ANALOG = 207,         /**< analog output node. */

      /* !!!Update this AND hpidebug.h if you add a new destnode type!!! */
00258       HPI_DESTNODE_LAST_INDEX = 207      /**< largest ID */
            /* AX6 max destnode types = 15 */
};

/*******************************************/
/** Mixer control types
\ingroup mixer
*/
00266 enum HPI_CONTROLS {
00267       HPI_CONTROL_GENERIC = 0,      /**< generic control. */
00268       HPI_CONTROL_CONNECTION = 1, /**< A connection between nodes. */
00269       HPI_CONTROL_VOLUME = 2,       /**< volume control - works in dB_fs. */
00270       HPI_CONTROL_METER = 3,  /**< peak meter control. */
      HPI_CONTROL_MUTE = 4,   /*mute control - not used at present. */
00272       HPI_CONTROL_MULTIPLEXER = 5,  /**< multiplexer control. */

00274       HPI_CONTROL_AESEBU_TRANSMITTER = 6, /**< AES/EBU transmitter control. */
      HPI_CONTROL_AESEBUTX = HPI_CONTROL_AESEBU_TRANSMITTER,

00277       HPI_CONTROL_AESEBU_RECEIVER = 7, /**< AES/EBU receiver control. */
      HPI_CONTROL_AESEBURX = HPI_CONTROL_AESEBU_RECEIVER,

00280       HPI_CONTROL_LEVEL = 8, /**< level/trim control - works in d_bu. */
00281       HPI_CONTROL_TUNER = 9,  /**< tuner control. */
/*      HPI_CONTROL_ONOFFSWITCH =       10 */
00283       HPI_CONTROL_VOX = 11,   /**< vox control. */
/*      HPI_CONTROL_AES18_TRANSMITTER = 12 */
/*      HPI_CONTROL_AES18_RECEIVER = 13 */
/*      HPI_CONTROL_AES18_BLOCKGENERATOR  = 14 */
00287       HPI_CONTROL_CHANNEL_MODE = 15,      /**< channel mode control. */

00289       HPI_CONTROL_BITSTREAM = 16,   /**< bitstream control. */
00290       HPI_CONTROL_SAMPLECLOCK = 17, /**< sample clock control. */
00291       HPI_CONTROL_MICROPHONE = 18,  /**< microphone control. */
00292       HPI_CONTROL_PARAMETRIC_EQ = 19,     /**< parametric EQ control. */
      HPI_CONTROL_EQUALIZER = HPI_CONTROL_PARAMETRIC_EQ,

00295       HPI_CONTROL_COMPANDER = 20,   /**< compander control. */
00296       HPI_CONTROL_COBRANET = 21,    /**< cobranet control. */
00297       HPI_CONTROL_TONEDETECTOR = 22,      /**< tone detector control. */
00298       HPI_CONTROL_SILENCEDETECTOR = 23,   /**< silence detector control. */
00299       HPI_CONTROL_PAD = 24,   /**< tuner PAD control. */
00300       HPI_CONTROL_SRC = 25,   /**< samplerate converter control. */
00301       HPI_CONTROL_UNIVERSAL = 26,   /**< universal control. */

/*  !!! Update this AND hpidebug.h if you add a new control type!!!*/
00304       HPI_CONTROL_LAST_INDEX = 26 /**<highest control type ID */
/* WARNING types 256 or greater impact bit packing in all AX6 DSP code */
};

/* Shorthand names that match attribute names */

/******************************************* ADAPTER ATTRIBUTES ****/

/** Adapter properties
These are used in HPI_AdapterSetProperty() and HPI_AdapterGetProperty()
\ingroup adapter
*/
00316 enum HPI_ADAPTER_PROPERTIES {
/** \internal Used in dwProperty field of HPI_AdapterSetProperty() and
HPI_AdapterGetProperty(). This errata applies to all ASI6000 cards with both
analog and digital outputs. The CS4224 A/D+D/A has a one sample delay between
left and right channels on both its input (ADC) and output (DAC).
More details are available in Cirrus Logic errata ER284B2.
PDF available from www.cirrus.com, released by Cirrus in 2001.
*/
00324       HPI_ADAPTER_PROPERTY_ERRATA_1 = 1,

/** Adapter grouping property
Indicates whether the adapter supports the grouping API (for ASIO and SSX2)
*/
00329       HPI_ADAPTER_PROPERTY_GROUPING = 2,

/** Driver SSX2 property
Tells the kernel driver to turn on SSX2 stream mapping.
This feature is not used by the DSP. In fact the call is completely processed
by the driver and is not passed on to the DSP at all.
*/
00336       HPI_ADAPTER_PROPERTY_ENABLE_SSX2 = 3,

/** Adapter SSX2 property
Indicates the state of the adapter's SSX2 setting. This setting is stored in
non-volatile memory on the adapter. A typical call sequence would be to use
HPI_ADAPTER_PROPERTY_SSX2_SETTING to set SSX2 on the adapter and then to reload
the driver. The driver would query HPI_ADAPTER_PROPERTY_SSX2_SETTING during startup
and if SSX2 is set, it would then call HPI_ADAPTER_PROPERTY_ENABLE_SSX2 to enable
SSX2 stream mapping within the kernel level of the driver.
*/
00346       HPI_ADAPTER_PROPERTY_SSX2_SETTING = 4,

/** Base number for readonly properties */
00349       HPI_ADAPTER_PROPERTY_READONLYBASE = 256,

/** Readonly adapter latency property.
This property returns in the input and output latency in samples.
Property 1 is the estimated input latency
in samples, while Property 2 is that output latency in  samples.
*/
00356       HPI_ADAPTER_PROPERTY_LATENCY = 256,

/** Readonly adapter granularity property.
The granulariy is the smallest size chunk of stereo samples that is processed by
the adapter.
This property returns the record granularity in samples in Property 1.
Property 2 returns the play granularity.
*/
00364       HPI_ADAPTER_PROPERTY_GRANULARITY = 257,

/** Readonly adapter number of current channels property.
Property 1 is the number of record channels per record device.
Property 2 is the number of play channels per playback device.*/
00369       HPI_ADAPTER_PROPERTY_CURCHANNELS = 258,

/** Readonly adapter software version.
The SOFTWARE_VERSION property returns the version of the software running
on the adapter as Major.Minor.Release.
Property 1 contains Major in bits 15..8 and Minor in bits 7..0.
Property 2 contains Release in bits 7..0. */
00376       HPI_ADAPTER_PROPERTY_SOFTWARE_VERSION = 259,

/** Readonly adapter MAC address MSBs.
The MAC_ADDRESS_MSB property returns
the most significant 32 bits of the MAC address.
Property 1 contains bits 47..32 of the MAC address.
Property 2 contains bits 31..16 of the MAC address. */
00383       HPI_ADAPTER_PROPERTY_MAC_ADDRESS_MSB = 260,

/** Readonly adapter MAC address LSBs
The MAC_ADDRESS_LSB property returns
the least significant 16 bits of the MAC address.
Property 1 contains bits 15..0 of the MAC address. */
00389       HPI_ADAPTER_PROPERTY_MAC_ADDRESS_LSB = 261,

/** Readonly extended adapter type number
The EXTENDED_ADAPTER_TYPE property returns the 4 digits of an extended
adapter type, i.e ASI8920-0022, 0022 is the extended type.
The digits are returned as ASCII characters rather than the hex digits that
are returned for the main type
Property 1 returns the 1st two (left most) digits, i.e "00"
in the example above, the upper byte being the left most digit.
Property 2 returns the 2nd two digits, i.e "22" in the example above*/
00399       HPI_ADAPTER_PROPERTY_EXTENDED_ADAPTER_TYPE = 262,

/** Readonly debug log buffer information */
00402       HPI_ADAPTER_PROPERTY_LOGTABLEN = 263,
      HPI_ADAPTER_PROPERTY_LOGTABBEG = 264,

/** Readonly adapter IP address
For 192.168.1.101
Property 1 returns the 1st two (left most) digits, i.e 192*256 + 168
in the example above, the upper byte being the left most digit.
Property 2 returns the 2nd two digits, i.e 1*256 + 101 in the example above, */
00410       HPI_ADAPTER_PROPERTY_IP_ADDRESS = 265,

/** Readonly adapter buffer processed count. Returns a buffer processed count
that is incremented every time all buffers for all streams are updated. This
is useful for checking completion of all stream operations across the adapter
when using grouped streams.
*/
00417       HPI_ADAPTER_PROPERTY_BUFFER_UPDATE_COUNT = 266,

/** Readonly mixer and stream intervals

These intervals are  measured in mixer frames.
To convert to time, divide  by the adapter samplerate.

The mixer interval is the number of frames processed in one mixer iteration.
The stream update interval is the interval at which streams check for and
process data, and BBM host buffer counters are updated.

Property 1 is the mixer interval in mixer frames.
Property 2 is the stream update interval in mixer frames.
*/
00431       HPI_ADAPTER_PROPERTY_INTERVAL = 267,
/** Adapter capabilities 1
Property 1 - adapter can do multichannel (SSX1)
Property 2 - adapter can do stream grouping (supports SSX2)
*/
00436       HPI_ADAPTER_PROPERTY_CAPS1 = 268,
/** Adapter capabilities 2
Property 1 - adapter can do samplerate conversion (MRX)
Property 2 - adapter can do timestretch (TSX)
*/
00441       HPI_ADAPTER_PROPERTY_CAPS2 = 269
};

/** Adapter mode commands

Used in wQueryOrSet field of HPI_AdapterSetModeEx().
\ingroup adapter
*/
00449 enum HPI_ADAPTER_MODE_CMDS {
      HPI_ADAPTER_MODE_SET = 0,
      HPI_ADAPTER_MODE_QUERY = 1
};

/** Adapter Modes
      These are used by HPI_AdapterSetModeEx()

\warning - more than 16 possible modes breaks
a bitmask in the Windows WAVE DLL
\ingroup adapter
*/
00461 enum HPI_ADAPTER_MODES {
/** 4 outstream mode.
- ASI6114: 1 instream
- ASI6044: 4 instreams
- ASI6012: 1 instream
- ASI6102: no instreams
- ASI6022, ASI6122: 2 instreams
- ASI5111, ASI5101: 2 instreams
- ASI652x, ASI662x: 2 instreams
- ASI654x, ASI664x: 4 instreams
*/
00472       HPI_ADAPTER_MODE_4OSTREAM = 1,

/** 6 outstream mode.
- ASI6012: 1 instream,
- ASI6022, ASI6122: 2 instreams
- ASI652x, ASI662x: 4 instreams
*/
00479       HPI_ADAPTER_MODE_6OSTREAM = 2,

/** 8 outstream mode.
- ASI6114: 8 instreams
- ASI6118: 8 instreams
- ASI6585: 8 instreams
*/
00486       HPI_ADAPTER_MODE_8OSTREAM = 3,

/** 16 outstream mode.
- ASI6416 16 instreams
- ASI6518, ASI6618 16 instreams
- ASI6118 16 mono out and in streams
*/
00493       HPI_ADAPTER_MODE_16OSTREAM = 4,

/** one outstream mode.
- ASI5111 1 outstream, 1 instream
*/
00498       HPI_ADAPTER_MODE_1OSTREAM = 5,

/** ASI504X mode 1. 12 outstream, 4 instream 0 to 48kHz sample rates
      (see ASI504X datasheet for more info).
*/
00503       HPI_ADAPTER_MODE_1 = 6,

/** ASI504X mode 2. 4 outstreams, 4 instreams at 0 to 192kHz sample rates
      (see ASI504X datasheet for more info).
*/
00508       HPI_ADAPTER_MODE_2 = 7,

/** ASI504X mode 3. 4 outstreams, 4 instreams at 0 to 192kHz sample rates
      (see ASI504X datasheet for more info).
*/
00513       HPI_ADAPTER_MODE_3 = 8,

/** ASI504X multichannel mode.
      2 outstreams -> 4 line outs = 1 to 8 channel streams),
      4 lineins -> 1 instream (1 to 8 channel streams) at 0-48kHz.
      For more info see the SSX Specification.
*/
00520       HPI_ADAPTER_MODE_MULTICHANNEL = 9,

/** 12 outstream mode.
- ASI6514, ASI6614: 2 instreams
- ASI6540,ASI6544: 8 instreams
- ASI6640,ASI6644: 8 instreams
*/
00527       HPI_ADAPTER_MODE_12OSTREAM = 10,

/** 9 outstream mode.
- ASI6044: 8 instreams
*/
00532       HPI_ADAPTER_MODE_9OSTREAM = 11,

/** mono mode.
- ASI6416: 16 outstreams/instreams
- ASI5402: 2 outstreams/instreams
*/
00538       HPI_ADAPTER_MODE_MONO = 12,

/** Low latency mode.
- ASI6416/ASI6316: 1 16 channel outstream and instream
*/
00543       HPI_ADAPTER_MODE_LOW_LATENCY = 13
};

/* Note, adapters can have more than one capability -
encoding as bitfield is recommended. */
#define HPI_CAPABILITY_NONE             (0)
#define HPI_CAPABILITY_MPEG_LAYER3      (1)

/* Set this equal to maximum capability index,
Must not be greater than 32 - see axnvdef.h */
#define HPI_CAPABILITY_MAX                      1
/* #define HPI_CAPABILITY_AAC              2 */

/******************************************* STREAM ATTRIBUTES ****/

/** MPEG Ancillary Data modes

The mode for the ancillary data insertion or extraction to operate in.
\ingroup stream
*/
00563 enum HPI_MPEG_ANC_MODES {
      /** the MPEG frames have energy information stored in them (5 bytes per stereo frame, 3 per mono) */
00565       HPI_MPEG_ANC_HASENERGY = 0,
      /** the entire ancillary data field is taken up by data from the Anc data buffer
      On encode, the encoder will insert the energy bytes before filling the remainder
      of the ancillary data space with data from the ancillary data buffer.
      */
00570       HPI_MPEG_ANC_RAW = 1
};

/** Ancillary Data Alignment
\ingroup instream
*/
00576 enum HPI_ISTREAM_MPEG_ANC_ALIGNS {
      /** data is packed against the end of data, then padded to the end of frame */
00578       HPI_MPEG_ANC_ALIGN_LEFT = 0,
      /** data is packed against the end of the frame */
00580       HPI_MPEG_ANC_ALIGN_RIGHT = 1
};

/** MPEG modes
MPEG modes - can be used optionally for HPI_FormatCreate()
parameter dwAttributes.

Using any mode setting other than HPI_MPEG_MODE_DEFAULT
with single channel format will return an error.
\ingroup stream
*/
00591 enum HPI_MPEG_MODES {
/** Causes the MPEG-1 Layer II bitstream to be recorded
in single_channel mode when the number of channels is 1 and in stereo when the
number of channels is 2. */
00595       HPI_MPEG_MODE_DEFAULT = 0,
      /** Standard stereo without joint-stereo compression */
00597       HPI_MPEG_MODE_STEREO = 1,
      /** Joint stereo  */
00599       HPI_MPEG_MODE_JOINTSTEREO = 2,
      /** Left and Right channels are completely independent */
00601       HPI_MPEG_MODE_DUALCHANNEL = 3
};
/******************************************* MIXER ATTRIBUTES ****/

/* \defgroup mixer_flags Mixer flags for HPI_MIXER_GET_CONTROL_MULTIPLE_VALUES
{
*/
#define HPI_MIXER_GET_CONTROL_MULTIPLE_CHANGED  (0)
#define HPI_MIXER_GET_CONTROL_MULTIPLE_RESET    (1)
/*}*/

/** Commands used by HPI_MixerStore()
\ingroup mixer
*/
00615 enum HPI_MIXER_STORE_COMMAND {
/** Save all mixer control settings. */
00617       HPI_MIXER_STORE_SAVE = 1,
/** Restore all controls from saved. */
00619       HPI_MIXER_STORE_RESTORE = 2,
/** Delete saved control settings. */
00621       HPI_MIXER_STORE_DELETE = 3,
/** Enable auto storage of some control settings. */
00623       HPI_MIXER_STORE_ENABLE = 4,
/** Disable auto storage of some control settings. */
00625       HPI_MIXER_STORE_DISABLE = 5,
/** Save the attributes of a single control. */
00627       HPI_MIXER_STORE_SAVE_SINGLE = 6
};

/************************************* CONTROL ATTRIBUTE VALUES ****/
/** Used by mixer plugin enable functions

E.g. HPI_ParametricEQ_SetState()
\ingroup mixer
*/
00636 enum HPI_SWITCH_STATES {
00637       HPI_SWITCH_OFF = 0,     /**< turn the mixer plugin on. */
00638       HPI_SWITCH_ON = 1 /**< turn the mixer plugin off. */
};

/* Volume control special gain values */
/** volumes units are 100ths of a dB
\ingroup volume
*/
00645 #define HPI_UNITS_PER_dB                100
/** turns volume control OFF or MUTE
\ingroup volume
*/
00649 #define HPI_GAIN_OFF                    (-100 * HPI_UNITS_PER_dB)

/** value returned for no signal
\ingroup meter
*/
00654 #define HPI_METER_MINIMUM               (-150 * HPI_UNITS_PER_dB)

/** autofade profiles
\ingroup volume
*/
00659 enum HPI_VOLUME_AUTOFADES {
/** log fade - dB attenuation changes linearly over time */
00661       HPI_VOLUME_AUTOFADE_LOG = 2,
/** linear fade - amplitude changes linearly */
00663       HPI_VOLUME_AUTOFADE_LINEAR = 3
};

/** The physical encoding format of the AESEBU I/O.

Used in HPI_AESEBU_Transmitter_SetFormat(), HPI_AESEBU_Receiver_SetFormat()
along with related Get and Query functions
\ingroup aestx
*/
00672 enum HPI_AESEBU_FORMATS {
/** AES/EBU physical format - AES/EBU balanced "professional"  */
00674       HPI_AESEBU_FORMAT_AESEBU = 1,
/** AES/EBU physical format - S/PDIF unbalanced "consumer"      */
00676       HPI_AESEBU_FORMAT_SPDIF = 2
};

/** AES/EBU error status bits

Returned by HPI_AESEBU_Receiver_GetErrorStatus()
\ingroup aesrx
*/
00684 enum HPI_AESEBU_ERRORS {
/**  bit0: 1 when PLL is not locked */
00686       HPI_AESEBU_ERROR_NOT_LOCKED = 0x01,
/**  bit1: 1 when signal quality is poor */
00688       HPI_AESEBU_ERROR_POOR_QUALITY = 0x02,
/** bit2: 1 when there is a parity error */
00690       HPI_AESEBU_ERROR_PARITY_ERROR = 0x04,
/**  bit3: 1 when there is a bi-phase coding violation */
00692       HPI_AESEBU_ERROR_BIPHASE_VIOLATION = 0x08,
/**  bit4: 1 when the validity bit is high */
00694       HPI_AESEBU_ERROR_VALIDITY = 0x10,
/**  bit5: 1 when the CRC error bit is high */
00696       HPI_AESEBU_ERROR_CRC = 0x20
};

/** \addtogroup pad
\{
*/
/** The text string containing the station/channel combination. */
00703 #define HPI_PAD_CHANNEL_NAME_LEN        16
/** The text string containing the artist. */
00705 #define HPI_PAD_ARTIST_LEN              64
/** The text string containing the title. */
00707 #define HPI_PAD_TITLE_LEN               64
/** The text string containing the comment. */
00709 #define HPI_PAD_COMMENT_LEN             256
/** The PTY when the tuner has not recieved any PTY. */
00711 #define HPI_PAD_PROGRAM_TYPE_INVALID    0xffff
/** \} */

/** Data types for PTY string translation.
\ingroup rds
*/
00717 enum eHPI_RDS_type {
00718       HPI_RDS_DATATYPE_RDS = 0,     /**< RDS bitstream.*/
00719       HPI_RDS_DATATYPE_RBDS = 1     /**< RBDS bitstream.*/
};

/** Tuner bands

Used for HPI_Tuner_SetBand(),HPI_Tuner_GetBand()
\ingroup tuner
*/
00727 enum HPI_TUNER_BAND {
00728       HPI_TUNER_BAND_AM = 1,   /**< AM band */
00729       HPI_TUNER_BAND_FM = 2,   /**< FM band (mono) */
00730       HPI_TUNER_BAND_TV_NTSC_M = 3,  /**< NTSC-M TV band*/
      HPI_TUNER_BAND_TV = 3,  /* use TV_NTSC_M */
00732       HPI_TUNER_BAND_FM_STEREO = 4,  /**< FM band (stereo) */
00733       HPI_TUNER_BAND_AUX = 5,  /**< auxiliary input */
00734       HPI_TUNER_BAND_TV_PAL_BG = 6,  /**< PAL-B/G TV band*/
00735       HPI_TUNER_BAND_TV_PAL_I = 7,   /**< PAL-I TV band*/
00736       HPI_TUNER_BAND_TV_PAL_DK = 8,  /**< PAL-D/K TV band*/
00737       HPI_TUNER_BAND_TV_SECAM_L = 9,       /**< SECAM-L TV band*/
00738       HPI_TUNER_BAND_LAST = 9 /**< the index of the last tuner band. */
};

/** Tuner mode attributes

Used by HPI_Tuner_SetMode(), HPI_Tuner_GetMode()
\ingroup tuner

*/
00747 enum HPI_TUNER_MODES {
00748       HPI_TUNER_MODE_RSS = 1, /**< tuner mode attribute RSS */
00749       HPI_TUNER_MODE_RDS = 2  /**< tuner mode attribute RBDS/RDS */
};

/** Tuner mode attribute values

Used by HPI_Tuner_SetMode(), HPI_Tuner_GetMode()
\ingroup tuner
*/
00757 enum HPI_TUNER_MODE_VALUES {
/* RSS attribute values */
00759       HPI_TUNER_MODE_RSS_DISABLE = 0,     /**< tuner mode attribute RSS disable */
00760       HPI_TUNER_MODE_RSS_ENABLE = 1,      /**< tuner mode attribute RSS enable */

/* RDS mode attributes */
00763       HPI_TUNER_MODE_RDS_DISABLE = 0,     /**< tuner mode attribute RDS - disabled */
00764       HPI_TUNER_MODE_RDS_RDS = 1,  /**< tuner mode attribute RDS - RDS mode */
00765       HPI_TUNER_MODE_RDS_RBDS = 2 /**< tuner mode attribute RDS - RBDS mode */
};

/** Tuner Level settings
\ingroup tuner
*/
00771 enum HPI_TUNER_LEVEL {
      HPI_TUNER_LEVEL_AVERAGE = 0,
      HPI_TUNER_LEVEL_RAW = 1
};

/** Tuner Status Bits

These bitfield values are returned by a call to HPI_Tuner_GetStatus().
Multiple fields are returned from a single call.
\ingroup tuner
*/
00782 enum HPI_TUNER_STATUS_BITS {
00783       HPI_TUNER_VIDEO_COLOR_PRESENT = 0x0001,   /**< video color is present. */
00784       HPI_TUNER_VIDEO_IS_60HZ = 0x0020,   /**< 60 hz video detected. */
00785       HPI_TUNER_VIDEO_HORZ_SYNC_MISSING = 0x0040,     /**< video HSYNC is missing. */
00786       HPI_TUNER_VIDEO_STATUS_VALID = 0x0100,    /**< video status is valid. */
00787       HPI_TUNER_PLL_LOCKED = 0x1000,            /**< the tuner's PLL is locked. */
00788       HPI_TUNER_FM_STEREO = 0x2000,       /**< tuner reports back FM stereo. */
00789       HPI_TUNER_DIGITAL = 0x0200,         /**< tuner reports digital programming. */
00790       HPI_TUNER_MULTIPROGRAM = 0x0400           /**< tuner reports multiple programs. */
};

/** Channel Modes
Used for HPI_ChannelModeSet/Get()
\ingroup channelmode
*/
00797 enum HPI_CHANNEL_MODES {
/** Left channel out = left channel in, Right channel out = right channel in. */
00799       HPI_CHANNEL_MODE_NORMAL = 1,
/** Left channel out = right channel in, Right channel out = left channel in. */
00801       HPI_CHANNEL_MODE_SWAP = 2,
/** Left channel out = left channel in, Right channel out = left channel in. */
00803       HPI_CHANNEL_MODE_LEFT_TO_STEREO = 3,
/** Left channel out = right channel in, Right channel out = right channel in.*/
00805       HPI_CHANNEL_MODE_RIGHT_TO_STEREO = 4,
/** Left channel out = (left channel in + right channel in)/2,
    Right channel out = mute. */
00808       HPI_CHANNEL_MODE_STEREO_TO_LEFT = 5,
/** Left channel out = mute,
    Right channel out = (right channel in + left channel in)/2. */
00811       HPI_CHANNEL_MODE_STEREO_TO_RIGHT = 6,
      HPI_CHANNEL_MODE_LAST = 6
};

/** SampleClock source values
\ingroup sampleclock
*/
00818 enum HPI_SAMPLECLOCK_SOURCES {
/** The sampleclock output is derived from its local samplerate generator.
    The local samplerate may be set using HPI_SampleClock_SetLocalRate(). */
00821       HPI_SAMPLECLOCK_SOURCE_LOCAL = 1,
/** \deprecated Use HPI_SAMPLECLOCK_SOURCE_LOCAL instead */
00823       HPI_SAMPLECLOCK_SOURCE_ADAPTER = 1,
/** The adapter is clocked from a dedicated AES/EBU SampleClock input.*/
00825       HPI_SAMPLECLOCK_SOURCE_AESEBU_SYNC = 2,
/** From external wordclock connector */
00827       HPI_SAMPLECLOCK_SOURCE_WORD = 3,
/** Board-to-board header */
00829       HPI_SAMPLECLOCK_SOURCE_WORD_HEADER = 4,
/** FUTURE - SMPTE clock. */
00831       HPI_SAMPLECLOCK_SOURCE_SMPTE = 5,
/** One of the aesebu inputs */
00833       HPI_SAMPLECLOCK_SOURCE_AESEBU_INPUT = 6,
/** \deprecated The first aesebu input with a valid signal
Superseded by separate Auto enable flag
*/
00837       HPI_SAMPLECLOCK_SOURCE_AESEBU_AUTO = 7,
/** From a network interface e.g. Cobranet or Livewire at either 48 or 96kHz */
00839       HPI_SAMPLECLOCK_SOURCE_NETWORK = 8,
/** From previous adjacent module (ASI2416 only)*/
00841       HPI_SAMPLECLOCK_SOURCE_PREV_MODULE = 10,
/*! Update this if you add a new clock source.*/
00843       HPI_SAMPLECLOCK_SOURCE_LAST = 10
};

/** Equalizer filter types. Used by HPI_ParametricEQ_SetBand()
\ingroup parmeq
*/
00849 enum HPI_FILTER_TYPE {
00850       HPI_FILTER_TYPE_BYPASS = 0,   /**< filter is turned off */

00852       HPI_FILTER_TYPE_LOWSHELF = 1, /**< EQ low shelf */
00853       HPI_FILTER_TYPE_HIGHSHELF = 2,      /**< EQ high shelf */
00854       HPI_FILTER_TYPE_EQ_BAND = 3,  /**< EQ gain */

00856       HPI_FILTER_TYPE_LOWPASS = 4,  /**< standard low pass */
00857       HPI_FILTER_TYPE_HIGHPASS = 5, /**< standard high pass */
00858       HPI_FILTER_TYPE_BANDPASS = 6, /**< standard band pass */
00859       HPI_FILTER_TYPE_BANDSTOP = 7  /**< standard band stop/notch */
};

/** Async Event sources
\ingroup async
*/
00865 enum ASYNC_EVENT_SOURCES {
00866       HPI_ASYNC_EVENT_GPIO = 1,     /**< GPIO event. */
00867       HPI_ASYNC_EVENT_SILENCE = 2,  /**< silence event detected. */
00868       HPI_ASYNC_EVENT_TONE = 3      /**< tone event detected. */
};
/*******************************************/
/** HPI Error codes

Almost all HPI functions return an error code
A return value of zero means there was no error.
Otherwise one of these error codes is returned.
Error codes can be converted to a descriptive string using HPI_GetErrorText()

\note When a new error code is added HPI_GetErrorText() MUST be updated.
\note Codes 1-100 are reserved for driver use
\ingroup utility
*/
00882 enum HPI_ERROR_CODES {
      /** Message type does not exist. */
00884       HPI_ERROR_INVALID_TYPE = 100,
      /** Object type does not exist. */
00886       HPI_ERROR_INVALID_OBJ = 101,
      /** Function does not exist. */
00888       HPI_ERROR_INVALID_FUNC = 102,
      /** The specified object (adapter/Stream) does not exist. */
00890       HPI_ERROR_INVALID_OBJ_INDEX = 103,
      /** Trying to access an object that has not been opened yet. */
00892       HPI_ERROR_OBJ_NOT_OPEN = 104,
      /** Trying to open an already open object. */
00894       HPI_ERROR_OBJ_ALREADY_OPEN = 105,
      /** PCI, ISA resource not valid. */
00896       HPI_ERROR_INVALID_RESOURCE = 106,
      /** GetInfo call from SubSysFindAdapters failed. */
00898       HPI_ERROR_SUBSYSFINDADAPTERS_GETINFO = 107,
      /** Default response was never updated with actual error code. */
00900       HPI_ERROR_INVALID_RESPONSE = 108,
      /** wSize field of response was not updated,
      indicating that the message was not processed. */
00903       HPI_ERROR_PROCESSING_MESSAGE = 109,
      /** The network did not respond in a timely manner. */
00905       HPI_ERROR_NETWORK_TIMEOUT = 110,
      /** An HPI handle is invalid (uninitialised?). */
00907       HPI_ERROR_INVALID_HANDLE = 111,
      /** A function or attribute has not been implemented yet. */
00909       HPI_ERROR_UNIMPLEMENTED = 112,
      /** There are too many clients attempting to access a network resource. */
00911       HPI_ERROR_NETWORK_TOO_MANY_CLIENTS = 113,
      /** Response buffer passed to HPI_Message was smaller than returned response */
00913       HPI_ERROR_RESPONSE_BUFFER_TOO_SMALL = 114,
      /** The returned response did not match the sent message */
00915       HPI_ERROR_RESPONSE_MISMATCH = 115,

      /** Too many adapters.*/
00918       HPI_ERROR_TOO_MANY_ADAPTERS = 200,
      /** Bad adpater. */
00920       HPI_ERROR_BAD_ADAPTER = 201,
      /** Adapter number out of range or not set properly. */
00922       HPI_ERROR_BAD_ADAPTER_NUMBER = 202,
      /** 2 adapters with the same adapter number. */
00924       HPI_DUPLICATE_ADAPTER_NUMBER = 203,
      /** DSP code failed to bootload. */
00926       HPI_ERROR_DSP_BOOTLOAD = 204,
      /** Adapter failed DSP code self test. */
00928       HPI_ERROR_DSP_SELFTEST = 205,
      /** Couldn't find or open the DSP code file. */
00930       HPI_ERROR_DSP_FILE_NOT_FOUND = 206,
      /** Internal DSP hardware error. */
00932       HPI_ERROR_DSP_HARDWARE = 207,
      /** Could not allocate memory in DOS. */
00934       HPI_ERROR_DOS_MEMORY_ALLOC = 208,
      /** Could not allocate memory */
00936       HPI_ERROR_MEMORY_ALLOC = 208,
      /** Failed to correctly load/config PLD .*/
00938       HPI_ERROR_PLD_LOAD = 209,
      /** Unexpected end of file, block length too big etc. */
00940       HPI_ERROR_DSP_FILE_FORMAT = 210,

      /** Found but could not open DSP code file. */
00943       HPI_ERROR_DSP_FILE_ACCESS_DENIED = 211,
      /** First DSP code section header not found in DSP file. */
00945       HPI_ERROR_DSP_FILE_NO_HEADER = 212,
      /** File read operation on DSP code file failed. */
00947       HPI_ERROR_DSP_FILE_READ_ERROR = 213,
      /** DSP code for adapter family not found. */
00949       HPI_ERROR_DSP_SECTION_NOT_FOUND = 214,
      /** Other OS specific error opening DSP file. */
00951       HPI_ERROR_DSP_FILE_OTHER_ERROR = 215,
      /** Sharing violation opening DSP code file. */
00953       HPI_ERROR_DSP_FILE_SHARING_VIOLATION = 216,
      /** DSP code section header had size == 0. */
00955       HPI_ERROR_DSP_FILE_NULL_HEADER = 217,

      /** Base number for flash errors. */
00958       HPI_ERROR_FLASH = 220,

      /** Flash has bad checksum */
00961       HPI_ERROR_BAD_CHECKSUM = (HPI_ERROR_FLASH + 1),
      HPI_ERROR_BAD_SEQUENCE = (HPI_ERROR_FLASH + 2),
      HPI_ERROR_FLASH_ERASE = (HPI_ERROR_FLASH + 3),
      HPI_ERROR_FLASH_PROGRAM = (HPI_ERROR_FLASH + 4),
      HPI_ERROR_FLASH_VERIFY = (HPI_ERROR_FLASH + 5),
      HPI_ERROR_FLASH_TYPE = (HPI_ERROR_FLASH + 6),
      HPI_ERROR_FLASH_START = (HPI_ERROR_FLASH + 7),

      /** Reserved for OEMs. */
00970       HPI_ERROR_RESERVED_1 = 290,

      /** Stream does not exist. */
00973       HPI_ERROR_INVALID_STREAM = 300,
      /** Invalid compression format. */
00975       HPI_ERROR_INVALID_FORMAT = 301,
      /** Invalid format samplerate */
00977       HPI_ERROR_INVALID_SAMPLERATE = 302,
      /** Invalid format number of channels. */
00979       HPI_ERROR_INVALID_CHANNELS = 303,
      /** Invalid format bitrate. */
00981       HPI_ERROR_INVALID_BITRATE = 304,
      /** Invalid datasize used for stream read/write. */
00983       HPI_ERROR_INVALID_DATASIZE = 305,
      /** Stream buffer is full during stream write. */
00985       HPI_ERROR_BUFFER_FULL = 306,
      /** Stream buffer is empty during stream read. */
00987       HPI_ERROR_BUFFER_EMPTY = 307,
      /** Invalid datasize used for stream read/write. */
00989       HPI_ERROR_INVALID_DATA_TRANSFER = 308,
      /** Packet ordering error for stream read/write. */
00991       HPI_ERROR_INVALID_PACKET_ORDER = 309,

      /** Object can't do requested operation in its current
      state, eg set format, change rec mux state while recording.*/
00995       HPI_ERROR_INVALID_OPERATION = 310,

      /** Where an SRG is shared amongst streams, an incompatible samplerate is one
      that is different to any currently playing or recording stream. */
00999       HPI_ERROR_INCOMPATIBLE_SAMPLERATE = 311,
      /** Adapter mode is illegal.*/
01001       HPI_ERROR_BAD_ADAPTER_MODE = 312,

      /** There have been too many attempts to set the adapter's
      capabilities (using bad keys), the card should be returned
      to ASI if further capabilities updates are required */
01006       HPI_ERROR_TOO_MANY_CAPABILITY_CHANGE_ATTEMPTS = 313,
      /** Streams on different adapters cannot be grouped. */
01008       HPI_ERROR_NO_INTERADAPTER_GROUPS = 314,
      /** Streams on different DSPs cannot be grouped. */
01010       HPI_ERROR_NO_INTERDSP_GROUPS = 315,

      /** Invalid mixer node for this adapter. */
01013       HPI_ERROR_INVALID_NODE = 400,
      /** Invalid control. */
01015       HPI_ERROR_INVALID_CONTROL = 401,
      /** Invalid control value was passed. */
01017       HPI_ERROR_INVALID_CONTROL_VALUE = 402,
      /** Control attribute not supported by this control. */
01019       HPI_ERROR_INVALID_CONTROL_ATTRIBUTE = 403,
      /** Control is disabled. */
01021       HPI_ERROR_CONTROL_DISABLED = 404,
      /** I2C transaction failed due to a missing ACK. */
01023       HPI_ERROR_CONTROL_I2C_MISSING_ACK = 405,
      /** Control attribute is valid, but not supported by this hardware. */
01025       HPI_ERROR_UNSUPPORTED_CONTROL_ATTRIBUTE = 406,
      /** Control is busy, or coming out of
      reset and cannot be accessed at this time. */
01028       HPI_ERROR_CONTROL_NOT_READY = 407,

      /** Non volatile memory */
01031       HPI_ERROR_NVMEM_BUSY = 450,
      HPI_ERROR_NVMEM_FULL = 451,
      HPI_ERROR_NVMEM_FAIL = 452,

      /** I2C */
01036       HPI_ERROR_I2C_MISSING_ACK = HPI_ERROR_CONTROL_I2C_MISSING_ACK,
      HPI_ERROR_I2C_BAD_ADR = 460,

      /** Entity errors */
01040       HPI_ERROR_ENTITY_TYPE_MISMATCH = 470,
      HPI_ERROR_ENTITY_ITEM_COUNT = 471,
      HPI_ERROR_ENTITY_TYPE_INVALID = 472,
      HPI_ERROR_ENTITY_ROLE_INVALID = 473,

      /* AES18 specific errors were 500..507 */

      /** custom error to use for debugging */
01048       HPI_ERROR_CUSTOM = 600,

      /** hpioct32.c can't obtain mutex */
01051       HPI_ERROR_MUTEX_TIMEOUT = 700,

      /** errors from HPI backends have values >= this */
01054       HPI_ERROR_BACKEND_BASE = 900,

      /** indicates a cached u16 value is invalid. */
01057       HPI_ERROR_ILLEGAL_CACHE_VALUE = 0xffff
};

/** \defgroup maximums HPI maximum values
\{
*/
/** Maximum number of adapters per HPI sub-system
   WARNING: modifying this value changes the response structure size.*/
01065 #define HPI_MAX_ADAPTERS                20
/** Maximum number of in or out streams per adapter */
01067 #define HPI_MAX_STREAMS                 16
#define HPI_MAX_CHANNELS                2 /* per stream */
#define HPI_MAX_NODES                   8 /* per mixer ? */
#define HPI_MAX_CONTROLS                4 /* per node ? */
/** maximum number of ancillary bytes per MPEG frame */
01072 #define HPI_MAX_ANC_BYTES_PER_FRAME     (64)
#define HPI_STRING_LEN                  16

/** Velocity units */
01076 #define HPI_OSTREAM_VELOCITY_UNITS      4096
/** OutStream timescale units */
01078 #define HPI_OSTREAM_TIMESCALE_UNITS     10000
/** OutStream timescale passthrough - turns timescaling on in passthough mode */
01080 #define HPI_OSTREAM_TIMESCALE_PASSTHROUGH       99999

/**\}*/

/* ////////////////////////////////////////////////////////////////////// */
/* STRUCTURES */
#ifndef DISABLE_PRAGMA_PACK1
#pragma pack(push, 1)
#endif

/** Structure containing sample format information.
    See also HPI_FormatCreate().
  */
01093 struct hpi_format {
      u32 sample_rate;
01095                         /**< 11025, 32000, 44100 ... */
01096       u32 bit_rate;           /**< for MPEG */
      u32 attributes;
01098                         /**< Stereo/JointStereo/Mono */
      u16 mode_legacy;
01100                         /**< Legacy ancillary mode or idle bit  */
01101       u16 unused;       /**< unused */
01102       u16 channels; /**< 1,2..., (or ancillary mode or idle bit */
01103       u16 format;   /**< HPI_FORMAT_PCM16, _MPEG etc. see #HPI_FORMATS. */
};

struct hpi_anc_frame {
      u32 valid_bits_in_this_frame;
      u8 b_data[HPI_MAX_ANC_BYTES_PER_FRAME];
};

/** An object for containing a single async event.
*/
01113 struct hpi_async_event {
01114       u16 event_type;   /**< type of event. \sa async_event  */
01115       u16 sequence;  /**< sequence number, allows lost event detection */
01116       u32 state;    /**< new state */
01117       u32 h_object;      /**< handle to the object returning the event. */
      union {
            struct {
01120                   u16 index; /**< GPIO bit index. */
            } gpio;
            struct {
01123                   u16 node_index;   /**< what node is the control on ? */
01124                   u16 node_type;    /**< what type of node is the control on ? */
            } control;
      } u;
};

/*/////////////////////////////////////////////////////////////////////////// */
/* Public HPI Entity related definitions                                     */

struct hpi_entity;

enum e_entity_type {
      entity_type_null,
      entity_type_sequence,   /* sequence of potentially heterogeneous TLV entities */

      entity_type_reference,  /* refers to a TLV entity or NULL */

      entity_type_int,  /* 32 bit */
      entity_type_float,      /* ieee754 binary 32 bit encoding */
      entity_type_double,

      entity_type_cstring,
      entity_type_octet,
      entity_type_ip4_address,
      entity_type_ip6_address,
      entity_type_mac_address,

      LAST_ENTITY_TYPE
};

enum e_entity_role {
      entity_role_null,
      entity_role_value,
      entity_role_classname,

      entity_role_units,
      entity_role_flags,
      entity_role_range,

      entity_role_mapping,
      entity_role_enum,

      entity_role_instance_of,
      entity_role_depends_on,
      entity_role_member_of_group,
      entity_role_value_constraint,
      entity_role_parameter_port,

      entity_role_block,
      entity_role_node_group,
      entity_role_audio_port,
      entity_role_clock_port,
      LAST_ENTITY_ROLE
};

/* skip host side function declarations for
   DSP compile and documentation extraction */

struct hpi_hsubsys {
      int not_really_used;
};

#ifndef DISABLE_PRAGMA_PACK1
#pragma pack(pop)
#endif

/*////////////////////////////////////////////////////////////////////////// */
/* HPI FUNCTIONS */

/*/////////////////////////// */
/* DATA and FORMAT and STREAM */

u16 hpi_stream_estimate_buffer_size(struct hpi_format *pF,
      u32 host_polling_rate_in_milli_seconds, u32 *recommended_buffer_size);

/*/////////// */
/* SUB SYSTEM */
struct hpi_hsubsys *hpi_subsys_create(void
      );

void hpi_subsys_free(const struct hpi_hsubsys *ph_subsys);

u16 hpi_subsys_get_version(const struct hpi_hsubsys *ph_subsys,
      u32 *pversion);

u16 hpi_subsys_get_version_ex(const struct hpi_hsubsys *ph_subsys,
      u32 *pversion_ex);

u16 hpi_subsys_get_info(const struct hpi_hsubsys *ph_subsys, u32 *pversion,
      u16 *pw_num_adapters, u16 aw_adapter_list[], u16 list_length);

u16 hpi_subsys_find_adapters(const struct hpi_hsubsys *ph_subsys,
      u16 *pw_num_adapters, u16 aw_adapter_list[], u16 list_length);

u16 hpi_subsys_get_num_adapters(const struct hpi_hsubsys *ph_subsys,
      int *pn_num_adapters);

u16 hpi_subsys_get_adapter(const struct hpi_hsubsys *ph_subsys, int iterator,
      u32 *padapter_index, u16 *pw_adapter_type);

u16 hpi_subsys_ssx2_bypass(const struct hpi_hsubsys *ph_subsys, u16 bypass);

u16 hpi_subsys_set_host_network_interface(const struct hpi_hsubsys *ph_subsys,
      const char *sz_interface);

/*///////// */
/* ADAPTER */

u16 hpi_adapter_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index);

u16 hpi_adapter_close(const struct hpi_hsubsys *ph_subsys, u16 adapter_index);

u16 hpi_adapter_get_info(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 *pw_num_outstreams, u16 *pw_num_instreams,
      u16 *pw_version, u32 *pserial_number, u16 *pw_adapter_type);

u16 hpi_adapter_get_module_by_index(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 module_index, u16 *pw_num_outputs,
      u16 *pw_num_inputs, u16 *pw_version, u32 *pserial_number,
      u16 *pw_module_type, u32 *ph_module);

u16 hpi_adapter_set_mode(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u32 adapter_mode);

u16 hpi_adapter_set_mode_ex(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u32 adapter_mode, u16 query_or_set);

u16 hpi_adapter_get_mode(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u32 *padapter_mode);

u16 hpi_adapter_get_assert(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 *assert_present, char *psz_assert,
      u16 *pw_line_number);

u16 hpi_adapter_get_assert_ex(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 *assert_present, char *psz_assert,
      u32 *pline_number, u16 *pw_assert_on_dsp);

u16 hpi_adapter_test_assert(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 assert_id);

u16 hpi_adapter_enable_capability(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 capability, u32 key);

u16 hpi_adapter_self_test(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index);

u16 hpi_adapter_debug_read(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u32 dsp_address, char *p_bytes, int *count_bytes);

u16 hpi_adapter_set_property(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 property, u16 paramter1, u16 paramter2);

u16 hpi_adapter_get_property(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 property, u16 *pw_paramter1,
      u16 *pw_paramter2);

u16 hpi_adapter_enumerate_property(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 index, u16 what_to_enumerate,
      u16 property_index, u32 *psetting);

/*////////////// */
/* NonVol Memory */
u16 hpi_nv_memory_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index,
      u32 *ph_nv_memory, u16 *pw_size_in_bytes);

u16 hpi_nv_memory_read_byte(const struct hpi_hsubsys *ph_subsys,
      u32 h_nv_memory, u16 index, u16 *pw_data);

u16 hpi_nv_memory_write_byte(const struct hpi_hsubsys *ph_subsys,
      u32 h_nv_memory, u16 index, u16 data);

/*////////////// */
/* Digital I/O */
u16 hpi_gpio_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index,
      u32 *ph_gpio, u16 *pw_number_input_bits, u16 *pw_number_output_bits);

u16 hpi_gpio_read_bit(const struct hpi_hsubsys *ph_subsys, u32 h_gpio,
      u16 bit_index, u16 *pw_bit_data);

u16 hpi_gpio_read_all_bits(const struct hpi_hsubsys *ph_subsys, u32 h_gpio,
      u16 aw_all_bit_data[4]
      );

u16 hpi_gpio_write_bit(const struct hpi_hsubsys *ph_subsys, u32 h_gpio,
      u16 bit_index, u16 bit_data);

u16 hpi_gpio_write_status(const struct hpi_hsubsys *ph_subsys, u32 h_gpio,
      u16 aw_all_bit_data[4]
      );

/**********************/
/* Async Event Object */
/**********************/
u16 hpi_async_event_open(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u32 *ph_async);

u16 hpi_async_event_close(const struct hpi_hsubsys *ph_subsys, u32 h_async);

u16 hpi_async_event_wait(const struct hpi_hsubsys *ph_subsys, u32 h_async,
      u16 maximum_events, struct hpi_async_event *p_events,
      u16 *pw_number_returned);

u16 hpi_async_event_get_count(const struct hpi_hsubsys *ph_subsys,
      u32 h_async, u16 *pw_count);

u16 hpi_async_event_get(const struct hpi_hsubsys *ph_subsys, u32 h_async,
      u16 maximum_events, struct hpi_async_event *p_events,
      u16 *pw_number_returned);

/*/////////// */
/* WATCH-DOG  */
u16 hpi_watchdog_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index,
      u32 *ph_watchdog);

u16 hpi_watchdog_set_time(const struct hpi_hsubsys *ph_subsys, u32 h_watchdog,
      u32 time_millisec);

u16 hpi_watchdog_ping(const struct hpi_hsubsys *ph_subsys, u32 h_watchdog);

/**************/
/* OUT STREAM */
/**************/
u16 hpi_outstream_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index,
      u16 outstream_index, u32 *ph_outstream);

u16 hpi_outstream_close(const struct hpi_hsubsys *ph_subsys, u32 h_outstream);

u16 hpi_outstream_get_info_ex(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u16 *pw_state, u32 *pbuffer_size, u32 *pdata_to_play,
      u32 *psamples_played, u32 *pauxiliary_data_to_play);

u16 hpi_outstream_write_buf(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, const u8 *pb_write_buf, u32 bytes_to_write,
      const struct hpi_format *p_format);

u16 hpi_outstream_start(const struct hpi_hsubsys *ph_subsys, u32 h_outstream);

u16 hpi_outstream_wait_start(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream);

u16 hpi_outstream_stop(const struct hpi_hsubsys *ph_subsys, u32 h_outstream);

u16 hpi_outstream_sinegen(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream);

u16 hpi_outstream_reset(const struct hpi_hsubsys *ph_subsys, u32 h_outstream);

u16 hpi_outstream_query_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, struct hpi_format *p_format);

u16 hpi_outstream_set_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, struct hpi_format *p_format);

u16 hpi_outstream_set_punch_in_out(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u32 punch_in_sample, u32 punch_out_sample);

u16 hpi_outstream_set_velocity(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, short velocity);

u16 hpi_outstream_ancillary_reset(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u16 mode);

u16 hpi_outstream_ancillary_get_info(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u32 *pframes_available);

u16 hpi_outstream_ancillary_read(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, struct hpi_anc_frame *p_anc_frame_buffer,
      u32 anc_frame_buffer_size_in_bytes,
      u32 number_of_ancillary_frames_to_read);

u16 hpi_outstream_set_time_scale(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u32 time_scaleX10000);

u16 hpi_outstream_host_buffer_allocate(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u32 size_in_bytes);

u16 hpi_outstream_host_buffer_free(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream);

u16 hpi_outstream_group_add(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u32 h_stream);

u16 hpi_outstream_group_get_map(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream, u32 *poutstream_map, u32 *pinstream_map);

u16 hpi_outstream_group_reset(const struct hpi_hsubsys *ph_subsys,
      u32 h_outstream);

/*////////// */
/* IN_STREAM */
u16 hpi_instream_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index,
      u16 instream_index, u32 *ph_instream);

u16 hpi_instream_close(const struct hpi_hsubsys *ph_subsys, u32 h_instream);

u16 hpi_instream_query_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, const struct hpi_format *p_format);

u16 hpi_instream_set_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, const struct hpi_format *p_format);

u16 hpi_instream_read_buf(const struct hpi_hsubsys *ph_subsys, u32 h_instream,
      u8 *pb_read_buf, u32 bytes_to_read);

u16 hpi_instream_start(const struct hpi_hsubsys *ph_subsys, u32 h_instream);

u16 hpi_instream_wait_start(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream);

u16 hpi_instream_stop(const struct hpi_hsubsys *ph_subsys, u32 h_instream);

u16 hpi_instream_reset(const struct hpi_hsubsys *ph_subsys, u32 h_instream);

u16 hpi_instream_get_info_ex(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, u16 *pw_state, u32 *pbuffer_size, u32 *pdata_recorded,
      u32 *psamples_recorded, u32 *pauxiliary_data_recorded);

u16 hpi_instream_ancillary_reset(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, u16 bytes_per_frame, u16 mode, u16 alignment,
      u16 idle_bit);

u16 hpi_instream_ancillary_get_info(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, u32 *pframe_space);

u16 hpi_instream_ancillary_write(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, const struct hpi_anc_frame *p_anc_frame_buffer,
      u32 anc_frame_buffer_size_in_bytes,
      u32 number_of_ancillary_frames_to_write);

u16 hpi_instream_host_buffer_allocate(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, u32 size_in_bytes);

u16 hpi_instream_host_buffer_free(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream);

u16 hpi_instream_group_add(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, u32 h_stream);

u16 hpi_instream_group_get_map(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream, u32 *poutstream_map, u32 *pinstream_map);

u16 hpi_instream_group_reset(const struct hpi_hsubsys *ph_subsys,
      u32 h_instream);

/*********/
/* MIXER */
/*********/
u16 hpi_mixer_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index,
      u32 *ph_mixer);

u16 hpi_mixer_close(const struct hpi_hsubsys *ph_subsys, u32 h_mixer);

u16 hpi_mixer_get_control(const struct hpi_hsubsys *ph_subsys, u32 h_mixer,
      u16 src_node_type, u16 src_node_type_index, u16 dst_node_type,
      u16 dst_node_type_index, u16 control_type, u32 *ph_control);

u16 hpi_mixer_get_control_by_index(const struct hpi_hsubsys *ph_subsys,
      u32 h_mixer, u16 control_index, u16 *pw_src_node_type,
      u16 *pw_src_node_index, u16 *pw_dst_node_type, u16 *pw_dst_node_index,
      u16 *pw_control_type, u32 *ph_control);

u16 hpi_mixer_store(const struct hpi_hsubsys *ph_subsys, u32 h_mixer,
      enum HPI_MIXER_STORE_COMMAND command, u16 index);
/*************************/
/* mixer CONTROLS                */
/*************************/
/*************************/
/* volume control                */
/*************************/
u16 hpi_volume_set_gain(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_gain0_01dB[HPI_MAX_CHANNELS]
      );

u16 hpi_volume_get_gain(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_gain0_01dB_out[HPI_MAX_CHANNELS]
      );

#define hpi_volume_get_range hpi_volume_query_range
u16 hpi_volume_query_range(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short *min_gain_01dB, short *max_gain_01dB, short *step_gain_01dB);

u16 hpi_volume_query_channels(const struct hpi_hsubsys *ph_subsys,
      const u32 h_volume, u32 *p_channels);

u16 hpi_volume_auto_fade(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_stop_gain0_01dB[HPI_MAX_CHANNELS], u32 duration_ms);

u16 hpi_volume_auto_fade_profile(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, short an_stop_gain0_01dB[HPI_MAX_CHANNELS],
      u32 duration_ms, u16 profile);

/*************************/
/* level control         */
/*************************/
u16 hpi_level_query_range(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short *min_gain_01dB, short *max_gain_01dB, short *step_gain_01dB);

u16 hpi_level_set_gain(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_gain0_01dB[HPI_MAX_CHANNELS]
      );

u16 hpi_level_get_gain(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_gain0_01dB_out[HPI_MAX_CHANNELS]
      );

/*************************/
/* meter control                 */
/*************************/
u16 hpi_meter_query_channels(const struct hpi_hsubsys *ph_subsys,
      const u32 h_meter, u32 *p_channels);

u16 hpi_meter_get_peak(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_peak0_01dB_out[HPI_MAX_CHANNELS]
      );

u16 hpi_meter_get_rms(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_peak0_01dB_out[HPI_MAX_CHANNELS]
      );

u16 hpi_meter_set_peak_ballistics(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 attack, u16 decay);

u16 hpi_meter_set_rms_ballistics(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 attack, u16 decay);

u16 hpi_meter_get_peak_ballistics(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *attack, u16 *decay);

u16 hpi_meter_get_rms_ballistics(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *attack, u16 *decay);

/*************************/
/* channel mode control  */
/*************************/
u16 hpi_channel_mode_query_mode(const struct hpi_hsubsys *ph_subsys,
      const u32 h_mode, const u32 index, u16 *pw_mode);

u16 hpi_channel_mode_set(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u16 mode);

u16 hpi_channel_mode_get(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u16 *mode);

/*************************/
/* Tuner control                 */
/*************************/
u16 hpi_tuner_query_band(const struct hpi_hsubsys *ph_subsys,
      const u32 h_tuner, const u32 index, u16 *pw_band);

u16 hpi_tuner_set_band(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u16 band);

u16 hpi_tuner_get_band(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u16 *pw_band);

u16 hpi_tuner_query_frequency(const struct hpi_hsubsys *ph_subsys,
      const u32 h_tuner, const u32 index, const u16 band, u32 *pfreq);

u16 hpi_tuner_set_frequency(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 freq_ink_hz);

u16 hpi_tuner_get_frequency(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *pw_freq_ink_hz);

u16 hpi_tuner_getRF_level(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short *pw_level);

u16 hpi_tuner_get_rawRF_level(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, short *pw_level);

u16 hpi_tuner_query_gain(const struct hpi_hsubsys *ph_subsys,
      const u32 h_tuner, const u32 index, u16 *pw_gain);

u16 hpi_tuner_set_gain(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short gain);

u16 hpi_tuner_get_gain(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short *pn_gain);

u16 hpi_tuner_get_status(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u16 *pw_status_mask, u16 *pw_status);

u16 hpi_tuner_set_mode(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u32 mode, u32 value);

u16 hpi_tuner_get_mode(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u32 mode, u32 *pn_value);

u16 hpi_tuner_getRDS(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      char *p_rds_data);

u16 hpi_tuner_query_deemphasis(const struct hpi_hsubsys *ph_subsys,
      const u32 h_tuner, const u32 index, const u16 band, u32 *pdeemphasis);

u16 hpi_tuner_set_deemphasis(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 deemphasis);
u16 hpi_tuner_get_deemphasis(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *pdeemphasis);

u16 hpi_tuner_query_program(const struct hpi_hsubsys *ph_subsys,
      const u32 h_tuner, u32 *pbitmap_program);

u16 hpi_tuner_set_program(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u32 program);

u16 hpi_tuner_get_program(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u32 *pprogram);

u16 hpi_tuner_get_hd_radio_dsp_version(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, char *psz_dsp_version, const u32 string_size);

u16 hpi_tuner_get_hd_radio_sdk_version(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, char *psz_sdk_version, const u32 string_size);

u16 hpi_tuner_get_hd_radio_signal_quality(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *pquality);

/****************************/
/* PADs control             */
/****************************/

u16 HPI_PAD__get_channel_name(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, char *psz_string, const u32 string_length);

u16 HPI_PAD__get_artist(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      char *psz_string, const u32 string_length);

u16 HPI_PAD__get_title(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      char *psz_string, const u32 string_length);

u16 HPI_PAD__get_comment(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      char *psz_string, const u32 string_length);

u16 HPI_PAD__get_program_type(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *ppTY);

u16 HPI_PAD__get_rdsPI(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u32 *ppI);

u16 HPI_PAD__get_program_type_string(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, const u32 data_type, const u32 pTY, char *psz_string,
      const u32 string_length);

/****************************/
/* AES/EBU Receiver control */
/****************************/
u16 HPI_AESEBU__receiver_query_format(const struct hpi_hsubsys *ph_subsys,
      const u32 h_aes_rx, const u32 index, u16 *pw_format);

u16 HPI_AESEBU__receiver_set_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 source);

u16 HPI_AESEBU__receiver_get_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_source);

u16 HPI_AESEBU__receiver_get_sample_rate(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *psample_rate);

u16 HPI_AESEBU__receiver_get_user_data(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 index, u16 *pw_data);

u16 HPI_AESEBU__receiver_get_channel_status(const struct hpi_hsubsys
      *ph_subsys, u32 h_control, u16 index, u16 *pw_data);

u16 HPI_AESEBU__receiver_get_error_status(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_error_data);

/*******************************/
/* AES/EBU Transmitter control */
/*******************************/
u16 HPI_AESEBU__transmitter_set_sample_rate(const struct hpi_hsubsys
      *ph_subsys, u32 h_control, u32 sample_rate);

u16 HPI_AESEBU__transmitter_set_user_data(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 index, u16 data);

u16 HPI_AESEBU__transmitter_set_channel_status(const struct hpi_hsubsys
      *ph_subsys, u32 h_control, u16 index, u16 data);

u16 HPI_AESEBU__transmitter_get_channel_status(const struct hpi_hsubsys
      *ph_subsys, u32 h_control, u16 index, u16 *pw_data);

u16 HPI_AESEBU__transmitter_query_format(const struct hpi_hsubsys *ph_subsys,
      const u32 h_aes_tx, const u32 index, u16 *pw_format);

u16 HPI_AESEBU__transmitter_set_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 output_format);

u16 HPI_AESEBU__transmitter_get_format(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_output_format);

/***********************/
/* multiplexer control */
/***********************/
u16 hpi_multiplexer_set_source(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 source_node_type, u16 source_node_index);

u16 hpi_multiplexer_get_source(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *source_node_type, u16 *source_node_index);

u16 hpi_multiplexer_query_source(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 index, u16 *source_node_type,
      u16 *source_node_index);

/***************/
/* VOX control */
/***************/
u16 hpi_vox_set_threshold(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short an_gain0_01dB);

u16 hpi_vox_get_threshold(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      short *an_gain0_01dB);

/*********************/
/* Bitstream control */
/*********************/
u16 hpi_bitstream_set_clock_edge(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 edge_type);

u16 hpi_bitstream_set_data_polarity(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 polarity);

u16 hpi_bitstream_get_activity(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_clk_activity, u16 *pw_data_activity);

/***********************/
/* SampleClock control */
/***********************/

u16 hpi_sample_clock_query_source(const struct hpi_hsubsys *ph_subsys,
      const u32 h_clock, const u32 index, u16 *pw_source);

u16 hpi_sample_clock_set_source(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 source);

u16 hpi_sample_clock_get_source(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_source);

u16 hpi_sample_clock_query_source_index(const struct hpi_hsubsys *ph_subsys,
      const u32 h_clock, const u32 index, const u32 source,
      u16 *pw_source_index);

u16 hpi_sample_clock_set_source_index(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 source_index);

u16 hpi_sample_clock_get_source_index(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_source_index);

u16 hpi_sample_clock_get_sample_rate(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *psample_rate);

u16 hpi_sample_clock_query_local_rate(const struct hpi_hsubsys *ph_subsys,
      const u32 h_clock, const u32 index, u32 *psource);

u16 hpi_sample_clock_set_local_rate(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 sample_rate);

u16 hpi_sample_clock_get_local_rate(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *psample_rate);

u16 hpi_sample_clock_set_auto(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 enable);

u16 hpi_sample_clock_get_auto(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *penable);

u16 hpi_sample_clock_set_local_rate_lock(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 lock);

u16 hpi_sample_clock_get_local_rate_lock(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *plock);

/***********************/
/* Microphone control */
/***********************/
u16 hpi_microphone_set_phantom_power(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 on_off);

u16 hpi_microphone_get_phantom_power(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_on_off);

/*******************************
  Parametric Equalizer control
*******************************/
u16 hpi_parametricEQ__get_info(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 *pw_number_of_bands, u16 *pw_enabled);

u16 hpi_parametricEQ__set_state(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 on_off);

u16 hpi_parametricEQ__set_band(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 index, u16 type, u32 frequency_hz, short q100,
      short gain0_01dB);

u16 hpi_parametricEQ__get_band(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 index, u16 *pn_type, u32 *pfrequency_hz,
      short *pnQ100, short *pn_gain0_01dB);

u16 hpi_parametricEQ__get_coeffs(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u16 index, short coeffs[5]
      );

/*******************************
  Compressor Expander control
*******************************/

u16 hpi_compander_set(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u16 attack, u16 decay, short ratio100, short threshold0_01dB,
      short makeup_gain0_01dB);

u16 hpi_compander_get(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u16 *pw_attack, u16 *pw_decay, short *pw_ratio100,
      short *pn_threshold0_01dB, short *pn_makeup_gain0_01dB);

/*******************************
  Cobranet HMI control
*******************************/
u16 hpi_cobranet_hmi_write(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u32 hmi_address, u32 byte_count, u8 *pb_data);

u16 hpi_cobranet_hmi_read(const struct hpi_hsubsys *ph_subsys, u32 h_control,
      u32 hmi_address, u32 max_byte_count, u32 *pbyte_count, u8 *pb_data);

u16 hpi_cobranet_hmi_get_status(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *pstatus, u32 *preadable_size,
      u32 *pwriteable_size);

/*Read the current IP address
*/
u16 hpi_cobranet_getI_paddress(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *pi_paddress);

/* Write the current IP address
*/
u16 hpi_cobranet_setI_paddress(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 i_paddress);

/* Read the static IP address
*/
u16 hpi_cobranet_get_staticI_paddress(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *pi_paddress);

/* Write the static IP address
*/
u16 hpi_cobranet_set_staticI_paddress(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 i_paddress);

/* Read the MAC address
*/
u16 hpi_cobranet_getMA_caddress(const struct hpi_hsubsys *ph_subsys,
      u32 h_control, u32 *pmAC_MS_bs, u32 *pmAC_LS_bs);

/*******************************
  Tone Detector control
*******************************/
u16 hpi_tone_detector_get_state(const struct hpi_hsubsys *ph_subsys, u32 hC,
      u32 *state);

u16 hpi_tone_detector_set_enable(const struct hpi_hsubsys *ph_subsys, u32 hC,
      u32 enable);

u16 hpi_tone_detector_get_enable(const struct hpi_hsubsys *ph_subsys, u32 hC,
      u32 *enable);

u16 hpi_tone_detector_set_event_enable(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 event_enable);

u16 hpi_tone_detector_get_event_enable(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 *event_enable);

u16 hpi_tone_detector_set_threshold(const struct hpi_hsubsys *ph_subsys,
      u32 hC, int threshold);

u16 hpi_tone_detector_get_threshold(const struct hpi_hsubsys *ph_subsys,
      u32 hC, int *threshold);

u16 hpi_tone_detector_get_frequency(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 index, u32 *frequency);

/*******************************
  Silence Detector control
*******************************/
u16 hpi_silence_detector_get_state(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 *state);

u16 hpi_silence_detector_set_enable(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 enable);

u16 hpi_silence_detector_get_enable(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 *enable);

u16 hpi_silence_detector_set_event_enable(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 event_enable);

u16 hpi_silence_detector_get_event_enable(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 *event_enable);

u16 hpi_silence_detector_set_delay(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 delay);

u16 hpi_silence_detector_get_delay(const struct hpi_hsubsys *ph_subsys,
      u32 hC, u32 *delay);

u16 hpi_silence_detector_set_threshold(const struct hpi_hsubsys *ph_subsys,
      u32 hC, int threshold);

u16 hpi_silence_detector_get_threshold(const struct hpi_hsubsys *ph_subsys,
      u32 hC, int *threshold);

/*******************************
  Universal control
*******************************/
u16 hpi_entity_find_next(struct hpi_entity *container_entity,
      enum e_entity_type type, enum e_entity_role role, int recursive_flag,
      struct hpi_entity **current_match);

u16 hpi_entity_copy_value_from(struct hpi_entity *entity,
      enum e_entity_type type, size_t item_count, void *value_dst_p);

u16 hpi_entity_unpack(struct hpi_entity *entity, enum e_entity_type *type,
      size_t *items, enum e_entity_role *role, void **value);

u16 hpi_entity_alloc_and_pack(const enum e_entity_type type,
      const size_t item_count, const enum e_entity_role role, void *value,
      struct hpi_entity **entity);

void hpi_entity_free(struct hpi_entity *entity);

u16 hpi_universal_info(const struct hpi_hsubsys *ph_subsys, u32 hC,
      struct hpi_entity **info);

u16 hpi_universal_get(const struct hpi_hsubsys *ph_subsys, u32 hC,
      struct hpi_entity **value);

u16 hpi_universal_set(const struct hpi_hsubsys *ph_subsys, u32 hC,
      struct hpi_entity *value);

/*/////////// */
/* DSP CLOCK  */
/*/////////// */
u16 hpi_clock_open(const struct hpi_hsubsys *ph_subsys, u16 adapter_index,
      u32 *ph_dsp_clock);

u16 hpi_clock_set_time(const struct hpi_hsubsys *ph_subsys, u32 h_clock,
      u16 hour, u16 minute, u16 second, u16 milli_second);

u16 hpi_clock_get_time(const struct hpi_hsubsys *ph_subsys, u32 h_clock,
      u16 *pw_hour, u16 *pw_minute, u16 *pw_second, u16 *pw_milli_second);

/*/////////// */
/* PROFILE        */
/*/////////// */
u16 hpi_profile_open_all(const struct hpi_hsubsys *ph_subsys,
      u16 adapter_index, u16 profile_index, u32 *ph_profile,
      u16 *pw_max_profiles);

u16 hpi_profile_get(const struct hpi_hsubsys *ph_subsys, u32 h_profile,
      u16 index, u16 *pw_seconds, u32 *pmicro_seconds, u32 *pcall_count,
      u32 *pmax_micro_seconds, u32 *pmin_micro_seconds);

u16 hpi_profile_start_all(const struct hpi_hsubsys *ph_subsys, u32 h_profile);

u16 hpi_profile_stop_all(const struct hpi_hsubsys *ph_subsys, u32 h_profile);

u16 hpi_profile_get_name(const struct hpi_hsubsys *ph_subsys, u32 h_profile,
      u16 index, char *sz_profile_name, u16 profile_name_length);

u16 hpi_profile_get_utilization(const struct hpi_hsubsys *ph_subsys,
      u32 h_profile, u32 *putilization);

/*//////////////////// */
/* UTILITY functions */

u16 hpi_format_create(struct hpi_format *p_format, u16 channels, u16 format,
      u32 sample_rate, u32 bit_rate, u32 attributes);

/* Until it's verified, this function is for Windows OSs only */

#ifdef __cplusplus
/* *INDENT-OFF* */
}
/* *INDENT-ON* */
#endif
#endif       /*_H_HPI_ */
/*
///////////////////////////////////////////////////////////////////////////////
// See CVS for history.  Last complete set in rev 1.146
////////////////////////////////////////////////////////////////////////////////
*/

Generated by  Doxygen 1.6.0   Back to index