1 /******************************************************************************
3 AudioScience HPI driver
4 Copyright (C) 1997-2010 AudioScience Inc. <support@audioscience.com>
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of version 2 of the GNU General Public License as
8 published by the Free Software Foundation;
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
19 HPI internal definitions
21 (C) Copyright AudioScience Inc. 1996-2009
22 ******************************************************************************/
24 #ifndef _HPI_INTERNAL_H_
25 #define _HPI_INTERNAL_H_
28 /** maximum number of memory regions mapped to an adapter */
29 #define HPI_MAX_ADAPTER_MEM_SPACES (2)
31 /* Each OS needs its own hpios.h */
34 /* physical memory allocation */
35 void hpios_locked_mem_init(void
37 void hpios_locked_mem_free_all(void
39 #define hpios_locked_mem_prepare(a, b, c, d);
40 #define hpios_locked_mem_unprepare(a)
42 /** Allocate and map an area of locked memory for bus master DMA operations.
44 On success, *pLockedMemeHandle is a valid handle, and 0 is returned
45 On error *pLockedMemHandle marked invalid, non-zero returned.
47 If this function succeeds, then HpiOs_LockedMem_GetVirtAddr() and
48 HpiOs_LockedMem_GetPyhsAddr() will always succed on the returned handle.
50 u16
hpios_locked_mem_alloc(struct consistent_dma_area
*p_locked_mem_handle
,
52 u32 size
, /**< Size in bytes to allocate */
53 struct pci_dev
*p_os_reference
54 /**< OS specific data required for memory allocation */
57 /** Free mapping and memory represented by LockedMemHandle
59 Frees any resources, then invalidates the handle.
60 Returns 0 on success, 1 if handle is invalid.
63 u16
hpios_locked_mem_free(struct consistent_dma_area
*locked_mem_handle
);
65 /** Get the physical PCI address of memory represented by LockedMemHandle.
67 If handle is invalid *pPhysicalAddr is set to zero and return 1
69 u16
hpios_locked_mem_get_phys_addr(struct consistent_dma_area
70 *locked_mem_handle
, u32
*p_physical_addr
);
72 /** Get the CPU address of of memory represented by LockedMemHandle.
74 If handle is NULL *ppvVirtualAddr is set to NULL and return 1
76 u16
hpios_locked_mem_get_virt_addr(struct consistent_dma_area
77 *locked_mem_handle
, void **ppv_virtual_addr
);
79 /** Check that handle is valid
80 i.e it represents a valid memory area
82 u16
hpios_locked_mem_valid(struct consistent_dma_area
*locked_mem_handle
);
85 void hpios_delay_micro_seconds(u32 num_micro_sec
);
90 typedef void hpi_handler_func(struct hpi_message
*, struct hpi_response
*);
92 /* If the assert fails, compiler complains
93 something like size of array `msg' is negative.
94 Unlike linux BUILD_BUG_ON, this works outside function scope.
96 #define compile_time_assert(cond, msg) \
97 typedef char ASSERT_##msg[(cond) ? 1 : -1]
99 /******************************************* bus types */
107 enum HPI_SUBSYS_OPTIONS
{
108 /* 0, 256 are invalid, 1..255 reserved for global options */
109 HPI_SUBSYS_OPT_NET_ENABLE
= 257,
110 HPI_SUBSYS_OPT_NET_BROADCAST
= 258,
111 HPI_SUBSYS_OPT_NET_UNICAST
= 259,
112 HPI_SUBSYS_OPT_NET_ADDR
= 260,
113 HPI_SUBSYS_OPT_NET_MASK
= 261,
114 HPI_SUBSYS_OPT_NET_ADAPTER_ADDRESS_ADD
= 262
119 enum HPI_VOLUME_FLAGS
{
120 /** Set if the volume control is muted */
121 HPI_VOLUME_FLAG_MUTED
= (1 << 0),
122 /** Set if the volume control has a mute function */
123 HPI_VOLUME_FLAG_HAS_MUTE
= (1 << 1),
124 /** Set if volume control can do autofading */
125 HPI_VOLUME_FLAG_HAS_AUTOFADE
= (1 << 2)
126 /* Note Flags >= (1<<8) are for DSP internal use only */
129 /******************************************* CONTROL ATTRIBUTES ****/
130 /* (in order of control type ID */
132 /* This allows for 255 control types, 256 unique attributes each */
133 #define HPI_CTL_ATTR(ctl, ai) ((HPI_CONTROL_##ctl << 8) + ai)
135 /* Get the sub-index of the attribute for a control type */
136 #define HPI_CTL_ATTR_INDEX(i) (i & 0xff)
138 /* Extract the control from the control attribute */
139 #define HPI_CTL_ATTR_CONTROL(i) (i >> 8)
141 /** Enable event generation for a control.
143 \note generic to all controls that can generate events
146 /** Unique identifiers for every control attribute
148 enum HPI_CONTROL_ATTRIBUTES
{
149 HPI_GENERIC_ENABLE
= HPI_CTL_ATTR(GENERIC
, 1),
150 HPI_GENERIC_EVENT_ENABLE
= HPI_CTL_ATTR(GENERIC
, 2),
152 HPI_VOLUME_GAIN
= HPI_CTL_ATTR(VOLUME
, 1),
153 HPI_VOLUME_AUTOFADE
= HPI_CTL_ATTR(VOLUME
, 2),
154 HPI_VOLUME_MUTE
= HPI_CTL_ATTR(VOLUME
, 3),
155 HPI_VOLUME_GAIN_AND_FLAGS
= HPI_CTL_ATTR(VOLUME
, 4),
156 HPI_VOLUME_NUM_CHANNELS
= HPI_CTL_ATTR(VOLUME
, 6),
157 HPI_VOLUME_RANGE
= HPI_CTL_ATTR(VOLUME
, 10),
159 HPI_METER_RMS
= HPI_CTL_ATTR(METER
, 1),
160 HPI_METER_PEAK
= HPI_CTL_ATTR(METER
, 2),
161 HPI_METER_RMS_BALLISTICS
= HPI_CTL_ATTR(METER
, 3),
162 HPI_METER_PEAK_BALLISTICS
= HPI_CTL_ATTR(METER
, 4),
163 HPI_METER_NUM_CHANNELS
= HPI_CTL_ATTR(METER
, 5),
165 HPI_MULTIPLEXER_SOURCE
= HPI_CTL_ATTR(MULTIPLEXER
, 1),
166 HPI_MULTIPLEXER_QUERYSOURCE
= HPI_CTL_ATTR(MULTIPLEXER
, 2),
168 HPI_AESEBUTX_FORMAT
= HPI_CTL_ATTR(AESEBUTX
, 1),
169 HPI_AESEBUTX_SAMPLERATE
= HPI_CTL_ATTR(AESEBUTX
, 3),
170 HPI_AESEBUTX_CHANNELSTATUS
= HPI_CTL_ATTR(AESEBUTX
, 4),
171 HPI_AESEBUTX_USERDATA
= HPI_CTL_ATTR(AESEBUTX
, 5),
173 HPI_AESEBURX_FORMAT
= HPI_CTL_ATTR(AESEBURX
, 1),
174 HPI_AESEBURX_ERRORSTATUS
= HPI_CTL_ATTR(AESEBURX
, 2),
175 HPI_AESEBURX_SAMPLERATE
= HPI_CTL_ATTR(AESEBURX
, 3),
176 HPI_AESEBURX_CHANNELSTATUS
= HPI_CTL_ATTR(AESEBURX
, 4),
177 HPI_AESEBURX_USERDATA
= HPI_CTL_ATTR(AESEBURX
, 5),
179 HPI_LEVEL_GAIN
= HPI_CTL_ATTR(LEVEL
, 1),
180 HPI_LEVEL_RANGE
= HPI_CTL_ATTR(LEVEL
, 10),
182 HPI_TUNER_BAND
= HPI_CTL_ATTR(TUNER
, 1),
183 HPI_TUNER_FREQ
= HPI_CTL_ATTR(TUNER
, 2),
184 HPI_TUNER_LEVEL_AVG
= HPI_CTL_ATTR(TUNER
, 3),
185 HPI_TUNER_LEVEL_RAW
= HPI_CTL_ATTR(TUNER
, 4),
186 HPI_TUNER_SNR
= HPI_CTL_ATTR(TUNER
, 5),
187 HPI_TUNER_GAIN
= HPI_CTL_ATTR(TUNER
, 6),
188 HPI_TUNER_STATUS
= HPI_CTL_ATTR(TUNER
, 7),
189 HPI_TUNER_MODE
= HPI_CTL_ATTR(TUNER
, 8),
190 HPI_TUNER_RDS
= HPI_CTL_ATTR(TUNER
, 9),
191 HPI_TUNER_DEEMPHASIS
= HPI_CTL_ATTR(TUNER
, 10),
192 HPI_TUNER_PROGRAM
= HPI_CTL_ATTR(TUNER
, 11),
193 HPI_TUNER_HDRADIO_SIGNAL_QUALITY
= HPI_CTL_ATTR(TUNER
, 12),
194 HPI_TUNER_HDRADIO_SDK_VERSION
= HPI_CTL_ATTR(TUNER
, 13),
195 HPI_TUNER_HDRADIO_DSP_VERSION
= HPI_CTL_ATTR(TUNER
, 14),
196 HPI_TUNER_HDRADIO_BLEND
= HPI_CTL_ATTR(TUNER
, 15),
198 HPI_VOX_THRESHOLD
= HPI_CTL_ATTR(VOX
, 1),
200 HPI_CHANNEL_MODE_MODE
= HPI_CTL_ATTR(CHANNEL_MODE
, 1),
202 HPI_BITSTREAM_DATA_POLARITY
= HPI_CTL_ATTR(BITSTREAM
, 1),
203 HPI_BITSTREAM_CLOCK_EDGE
= HPI_CTL_ATTR(BITSTREAM
, 2),
204 HPI_BITSTREAM_CLOCK_SOURCE
= HPI_CTL_ATTR(BITSTREAM
, 3),
205 HPI_BITSTREAM_ACTIVITY
= HPI_CTL_ATTR(BITSTREAM
, 4),
207 HPI_SAMPLECLOCK_SOURCE
= HPI_CTL_ATTR(SAMPLECLOCK
, 1),
208 HPI_SAMPLECLOCK_SAMPLERATE
= HPI_CTL_ATTR(SAMPLECLOCK
, 2),
209 HPI_SAMPLECLOCK_SOURCE_INDEX
= HPI_CTL_ATTR(SAMPLECLOCK
, 3),
210 HPI_SAMPLECLOCK_LOCAL_SAMPLERATE
= HPI_CTL_ATTR(SAMPLECLOCK
, 4),
211 HPI_SAMPLECLOCK_AUTO
= HPI_CTL_ATTR(SAMPLECLOCK
, 5),
212 HPI_SAMPLECLOCK_LOCAL_LOCK
= HPI_CTL_ATTR(SAMPLECLOCK
, 6),
214 HPI_MICROPHONE_PHANTOM_POWER
= HPI_CTL_ATTR(MICROPHONE
, 1),
216 HPI_EQUALIZER_NUM_FILTERS
= HPI_CTL_ATTR(EQUALIZER
, 1),
217 HPI_EQUALIZER_FILTER
= HPI_CTL_ATTR(EQUALIZER
, 2),
218 HPI_EQUALIZER_COEFFICIENTS
= HPI_CTL_ATTR(EQUALIZER
, 3),
220 HPI_COMPANDER_PARAMS
= HPI_CTL_ATTR(COMPANDER
, 1),
221 HPI_COMPANDER_MAKEUPGAIN
= HPI_CTL_ATTR(COMPANDER
, 2),
222 HPI_COMPANDER_THRESHOLD
= HPI_CTL_ATTR(COMPANDER
, 3),
223 HPI_COMPANDER_RATIO
= HPI_CTL_ATTR(COMPANDER
, 4),
224 HPI_COMPANDER_ATTACK
= HPI_CTL_ATTR(COMPANDER
, 5),
225 HPI_COMPANDER_DECAY
= HPI_CTL_ATTR(COMPANDER
, 6),
227 HPI_COBRANET_SET
= HPI_CTL_ATTR(COBRANET
, 1),
228 HPI_COBRANET_GET
= HPI_CTL_ATTR(COBRANET
, 2),
229 HPI_COBRANET_SET_DATA
= HPI_CTL_ATTR(COBRANET
, 3),
230 HPI_COBRANET_GET_DATA
= HPI_CTL_ATTR(COBRANET
, 4),
231 HPI_COBRANET_GET_STATUS
= HPI_CTL_ATTR(COBRANET
, 5),
232 HPI_COBRANET_SEND_PACKET
= HPI_CTL_ATTR(COBRANET
, 6),
233 HPI_COBRANET_GET_PACKET
= HPI_CTL_ATTR(COBRANET
, 7),
235 HPI_TONEDETECTOR_THRESHOLD
= HPI_CTL_ATTR(TONEDETECTOR
, 1),
236 HPI_TONEDETECTOR_STATE
= HPI_CTL_ATTR(TONEDETECTOR
, 2),
237 HPI_TONEDETECTOR_FREQUENCY
= HPI_CTL_ATTR(TONEDETECTOR
, 3),
239 HPI_SILENCEDETECTOR_THRESHOLD
= HPI_CTL_ATTR(SILENCEDETECTOR
, 1),
240 HPI_SILENCEDETECTOR_STATE
= HPI_CTL_ATTR(SILENCEDETECTOR
, 2),
241 HPI_SILENCEDETECTOR_DELAY
= HPI_CTL_ATTR(SILENCEDETECTOR
, 3),
243 HPI_PAD_CHANNEL_NAME
= HPI_CTL_ATTR(PAD
, 1),
244 HPI_PAD_ARTIST
= HPI_CTL_ATTR(PAD
, 2),
245 HPI_PAD_TITLE
= HPI_CTL_ATTR(PAD
, 3),
246 HPI_PAD_COMMENT
= HPI_CTL_ATTR(PAD
, 4),
247 HPI_PAD_PROGRAM_TYPE
= HPI_CTL_ATTR(PAD
, 5),
248 HPI_PAD_PROGRAM_ID
= HPI_CTL_ATTR(PAD
, 6),
249 HPI_PAD_TA_SUPPORT
= HPI_CTL_ATTR(PAD
, 7),
250 HPI_PAD_TA_ACTIVE
= HPI_CTL_ATTR(PAD
, 8)
253 #define HPI_POLARITY_POSITIVE 0
254 #define HPI_POLARITY_NEGATIVE 1
256 /*------------------------------------------------------------
257 Cobranet Chip Bridge - copied from HMI.H
258 ------------------------------------------------------------*/
259 #define HPI_COBRANET_HMI_cobra_bridge 0x20000
260 #define HPI_COBRANET_HMI_cobra_bridge_tx_pkt_buf \
261 (HPI_COBRANET_HMI_cobra_bridge + 0x1000)
262 #define HPI_COBRANET_HMI_cobra_bridge_rx_pkt_buf \
263 (HPI_COBRANET_HMI_cobra_bridge + 0x2000)
264 #define HPI_COBRANET_HMI_cobra_if_table1 0x110000
265 #define HPI_COBRANET_HMI_cobra_if_phy_address \
266 (HPI_COBRANET_HMI_cobra_if_table1 + 0xd)
267 #define HPI_COBRANET_HMI_cobra_protocolIP 0x72000
268 #define HPI_COBRANET_HMI_cobra_ip_mon_currentIP \
269 (HPI_COBRANET_HMI_cobra_protocolIP + 0x0)
270 #define HPI_COBRANET_HMI_cobra_ip_mon_staticIP \
271 (HPI_COBRANET_HMI_cobra_protocolIP + 0x2)
272 #define HPI_COBRANET_HMI_cobra_sys 0x100000
273 #define HPI_COBRANET_HMI_cobra_sys_desc \
274 (HPI_COBRANET_HMI_cobra_sys + 0x0)
275 #define HPI_COBRANET_HMI_cobra_sys_objectID \
276 (HPI_COBRANET_HMI_cobra_sys + 0x100)
277 #define HPI_COBRANET_HMI_cobra_sys_contact \
278 (HPI_COBRANET_HMI_cobra_sys + 0x200)
279 #define HPI_COBRANET_HMI_cobra_sys_name \
280 (HPI_COBRANET_HMI_cobra_sys + 0x300)
281 #define HPI_COBRANET_HMI_cobra_sys_location \
282 (HPI_COBRANET_HMI_cobra_sys + 0x400)
284 /*------------------------------------------------------------
285 Cobranet Chip Status bits
286 ------------------------------------------------------------*/
287 #define HPI_COBRANET_HMI_STATUS_RXPACKET 2
288 #define HPI_COBRANET_HMI_STATUS_TXPACKET 3
290 /*------------------------------------------------------------
292 ------------------------------------------------------------*/
293 #define HPI_ETHERNET_HEADER_SIZE (16)
295 /* These defines are used to fill in protocol information for an Ethernet packet
296 sent using HMI on CS18102 */
297 /** ID supplied by Cirrius for ASI packets. */
298 #define HPI_ETHERNET_PACKET_ID 0x85
299 /** Simple packet - no special routing required */
300 #define HPI_ETHERNET_PACKET_V1 0x01
301 /** This packet must make its way to the host across the HPI interface */
302 #define HPI_ETHERNET_PACKET_HOSTED_VIA_HMI 0x20
303 /** This packet must make its way to the host across the HPI interface */
304 #define HPI_ETHERNET_PACKET_HOSTED_VIA_HMI_V1 0x21
305 /** This packet must make its way to the host across the HPI interface */
306 #define HPI_ETHERNET_PACKET_HOSTED_VIA_HPI 0x40
307 /** This packet must make its way to the host across the HPI interface */
308 #define HPI_ETHERNET_PACKET_HOSTED_VIA_HPI_V1 0x41
310 #define HPI_ETHERNET_UDP_PORT (44600) /*!< UDP messaging port */
312 /** Default network timeout in milli-seconds. */
313 #define HPI_ETHERNET_TIMEOUT_MS 500
315 /** Locked memory buffer alloc/free phases */
316 enum HPI_BUFFER_CMDS
{
317 /** use one message to allocate or free physical memory */
318 HPI_BUFFER_CMD_EXTERNAL
= 0,
319 /** alloc physical memory */
320 HPI_BUFFER_CMD_INTERNAL_ALLOC
= 1,
321 /** send physical memory address to adapter */
322 HPI_BUFFER_CMD_INTERNAL_GRANTADAPTER
= 2,
323 /** notify adapter to stop using physical buffer */
324 HPI_BUFFER_CMD_INTERNAL_REVOKEADAPTER
= 3,
325 /** free physical buffer */
326 HPI_BUFFER_CMD_INTERNAL_FREE
= 4
329 /*****************************************************************************/
330 /*****************************************************************************/
331 /******** HPI LOW LEVEL MESSAGES *******/
332 /*****************************************************************************/
333 /*****************************************************************************/
335 /** "ASI" - actual is "ASX" - need to change */
336 #define HPI_ID_ISAPNP_AUDIOSCIENCE 0x0669
337 /** PCI vendor ID that AudioScience uses */
338 #define HPI_PCI_VENDOR_ID_AUDIOSCIENCE 0x175C
339 /** PCI vendor ID that the DSP56301 has */
340 #define HPI_PCI_VENDOR_ID_MOTOROLA 0x1057
341 /** PCI vendor ID that TI uses */
342 #define HPI_PCI_VENDOR_ID_TI 0x104C
344 #define HPI_PCI_DEV_ID_PCI2040 0xAC60
345 /** TI's C6205 PCI interface has this ID */
346 #define HPI_PCI_DEV_ID_DSP6205 0xA106
348 #define HPI_USB_VENDOR_ID_AUDIOSCIENCE 0x1257
349 #define HPI_USB_W2K_TAG 0x57495341 /* "ASIW" */
350 #define HPI_USB_LINUX_TAG 0x4C495341 /* "ASIL" */
352 /** Invalid Adapter index
353 Used in HPI messages that are not addressed to a specific adapter
354 Used in DLL to indicate device not present
356 #define HPI_ADAPTER_INDEX_INVALID 0xFFFF
358 /** First 2 hex digits define the adapter family */
359 #define HPI_ADAPTER_FAMILY_MASK 0xff00
360 #define HPI_MODULE_FAMILY_MASK 0xfff0
362 #define HPI_ADAPTER_FAMILY_ASI(f) (f & HPI_ADAPTER_FAMILY_MASK)
363 #define HPI_MODULE_FAMILY_ASI(f) (f & HPI_MODULE_FAMILY_MASK)
364 #define HPI_ADAPTER_ASI(f) (f)
366 enum HPI_MESSAGE_TYPES
{
367 HPI_TYPE_MESSAGE
= 1,
368 HPI_TYPE_RESPONSE
= 2,
370 HPI_TYPE_SSX2BYPASS_MESSAGE
= 4
373 enum HPI_OBJECT_TYPES
{
374 HPI_OBJ_SUBSYSTEM
= 1,
381 HPI_OBJ_NVMEMORY
= 8,
383 HPI_OBJ_WATCHDOG
= 10,
385 HPI_OBJ_PROFILE
= 12,
386 HPI_OBJ_CONTROLEX
= 13,
387 HPI_OBJ_ASYNCEVENT
= 14
388 #define HPI_OBJ_MAXINDEX 14
391 #define HPI_OBJ_FUNCTION_SPACING 0x100
392 #define HPI_FUNC_ID(obj, i) (HPI_OBJ_##obj * HPI_OBJ_FUNCTION_SPACING + i)
394 #define HPI_EXTRACT_INDEX(fn) (fn & 0xff)
396 enum HPI_FUNCTION_IDS
{
397 HPI_SUBSYS_OPEN
= HPI_FUNC_ID(SUBSYSTEM
, 1),
398 HPI_SUBSYS_GET_VERSION
= HPI_FUNC_ID(SUBSYSTEM
, 2),
399 HPI_SUBSYS_GET_INFO
= HPI_FUNC_ID(SUBSYSTEM
, 3),
400 HPI_SUBSYS_FIND_ADAPTERS
= HPI_FUNC_ID(SUBSYSTEM
, 4),
401 HPI_SUBSYS_CREATE_ADAPTER
= HPI_FUNC_ID(SUBSYSTEM
, 5),
402 HPI_SUBSYS_CLOSE
= HPI_FUNC_ID(SUBSYSTEM
, 6),
403 HPI_SUBSYS_DELETE_ADAPTER
= HPI_FUNC_ID(SUBSYSTEM
, 7),
404 HPI_SUBSYS_DRIVER_LOAD
= HPI_FUNC_ID(SUBSYSTEM
, 8),
405 HPI_SUBSYS_DRIVER_UNLOAD
= HPI_FUNC_ID(SUBSYSTEM
, 9),
406 HPI_SUBSYS_READ_PORT_8
= HPI_FUNC_ID(SUBSYSTEM
, 10),
407 HPI_SUBSYS_WRITE_PORT_8
= HPI_FUNC_ID(SUBSYSTEM
, 11),
408 HPI_SUBSYS_GET_NUM_ADAPTERS
= HPI_FUNC_ID(SUBSYSTEM
, 12),
409 HPI_SUBSYS_GET_ADAPTER
= HPI_FUNC_ID(SUBSYSTEM
, 13),
410 HPI_SUBSYS_SET_NETWORK_INTERFACE
= HPI_FUNC_ID(SUBSYSTEM
, 14),
411 HPI_SUBSYS_OPTION_INFO
= HPI_FUNC_ID(SUBSYSTEM
, 15),
412 HPI_SUBSYS_OPTION_GET
= HPI_FUNC_ID(SUBSYSTEM
, 16),
413 HPI_SUBSYS_OPTION_SET
= HPI_FUNC_ID(SUBSYSTEM
, 17),
414 #define HPI_SUBSYS_FUNCTION_COUNT 17
416 HPI_ADAPTER_OPEN
= HPI_FUNC_ID(ADAPTER
, 1),
417 HPI_ADAPTER_CLOSE
= HPI_FUNC_ID(ADAPTER
, 2),
418 HPI_ADAPTER_GET_INFO
= HPI_FUNC_ID(ADAPTER
, 3),
419 HPI_ADAPTER_GET_ASSERT
= HPI_FUNC_ID(ADAPTER
, 4),
420 HPI_ADAPTER_TEST_ASSERT
= HPI_FUNC_ID(ADAPTER
, 5),
421 HPI_ADAPTER_SET_MODE
= HPI_FUNC_ID(ADAPTER
, 6),
422 HPI_ADAPTER_GET_MODE
= HPI_FUNC_ID(ADAPTER
, 7),
423 HPI_ADAPTER_ENABLE_CAPABILITY
= HPI_FUNC_ID(ADAPTER
, 8),
424 HPI_ADAPTER_SELFTEST
= HPI_FUNC_ID(ADAPTER
, 9),
425 HPI_ADAPTER_FIND_OBJECT
= HPI_FUNC_ID(ADAPTER
, 10),
426 HPI_ADAPTER_QUERY_FLASH
= HPI_FUNC_ID(ADAPTER
, 11),
427 HPI_ADAPTER_START_FLASH
= HPI_FUNC_ID(ADAPTER
, 12),
428 HPI_ADAPTER_PROGRAM_FLASH
= HPI_FUNC_ID(ADAPTER
, 13),
429 HPI_ADAPTER_SET_PROPERTY
= HPI_FUNC_ID(ADAPTER
, 14),
430 HPI_ADAPTER_GET_PROPERTY
= HPI_FUNC_ID(ADAPTER
, 15),
431 HPI_ADAPTER_ENUM_PROPERTY
= HPI_FUNC_ID(ADAPTER
, 16),
432 HPI_ADAPTER_MODULE_INFO
= HPI_FUNC_ID(ADAPTER
, 17),
433 HPI_ADAPTER_DEBUG_READ
= HPI_FUNC_ID(ADAPTER
, 18),
434 HPI_ADAPTER_IRQ_QUERY_AND_CLEAR
= HPI_FUNC_ID(ADAPTER
, 19),
435 HPI_ADAPTER_IRQ_CALLBACK
= HPI_FUNC_ID(ADAPTER
, 20),
436 #define HPI_ADAPTER_FUNCTION_COUNT 20
438 HPI_OSTREAM_OPEN
= HPI_FUNC_ID(OSTREAM
, 1),
439 HPI_OSTREAM_CLOSE
= HPI_FUNC_ID(OSTREAM
, 2),
440 HPI_OSTREAM_WRITE
= HPI_FUNC_ID(OSTREAM
, 3),
441 HPI_OSTREAM_START
= HPI_FUNC_ID(OSTREAM
, 4),
442 HPI_OSTREAM_STOP
= HPI_FUNC_ID(OSTREAM
, 5),
443 HPI_OSTREAM_RESET
= HPI_FUNC_ID(OSTREAM
, 6),
444 HPI_OSTREAM_GET_INFO
= HPI_FUNC_ID(OSTREAM
, 7),
445 HPI_OSTREAM_QUERY_FORMAT
= HPI_FUNC_ID(OSTREAM
, 8),
446 HPI_OSTREAM_DATA
= HPI_FUNC_ID(OSTREAM
, 9),
447 HPI_OSTREAM_SET_VELOCITY
= HPI_FUNC_ID(OSTREAM
, 10),
448 HPI_OSTREAM_SET_PUNCHINOUT
= HPI_FUNC_ID(OSTREAM
, 11),
449 HPI_OSTREAM_SINEGEN
= HPI_FUNC_ID(OSTREAM
, 12),
450 HPI_OSTREAM_ANC_RESET
= HPI_FUNC_ID(OSTREAM
, 13),
451 HPI_OSTREAM_ANC_GET_INFO
= HPI_FUNC_ID(OSTREAM
, 14),
452 HPI_OSTREAM_ANC_READ
= HPI_FUNC_ID(OSTREAM
, 15),
453 HPI_OSTREAM_SET_TIMESCALE
= HPI_FUNC_ID(OSTREAM
, 16),
454 HPI_OSTREAM_SET_FORMAT
= HPI_FUNC_ID(OSTREAM
, 17),
455 HPI_OSTREAM_HOSTBUFFER_ALLOC
= HPI_FUNC_ID(OSTREAM
, 18),
456 HPI_OSTREAM_HOSTBUFFER_FREE
= HPI_FUNC_ID(OSTREAM
, 19),
457 HPI_OSTREAM_GROUP_ADD
= HPI_FUNC_ID(OSTREAM
, 20),
458 HPI_OSTREAM_GROUP_GETMAP
= HPI_FUNC_ID(OSTREAM
, 21),
459 HPI_OSTREAM_GROUP_RESET
= HPI_FUNC_ID(OSTREAM
, 22),
460 HPI_OSTREAM_HOSTBUFFER_GET_INFO
= HPI_FUNC_ID(OSTREAM
, 23),
461 HPI_OSTREAM_WAIT_START
= HPI_FUNC_ID(OSTREAM
, 24),
462 HPI_OSTREAM_WAIT
= HPI_FUNC_ID(OSTREAM
, 25),
463 #define HPI_OSTREAM_FUNCTION_COUNT 25
465 HPI_ISTREAM_OPEN
= HPI_FUNC_ID(ISTREAM
, 1),
466 HPI_ISTREAM_CLOSE
= HPI_FUNC_ID(ISTREAM
, 2),
467 HPI_ISTREAM_SET_FORMAT
= HPI_FUNC_ID(ISTREAM
, 3),
468 HPI_ISTREAM_READ
= HPI_FUNC_ID(ISTREAM
, 4),
469 HPI_ISTREAM_START
= HPI_FUNC_ID(ISTREAM
, 5),
470 HPI_ISTREAM_STOP
= HPI_FUNC_ID(ISTREAM
, 6),
471 HPI_ISTREAM_RESET
= HPI_FUNC_ID(ISTREAM
, 7),
472 HPI_ISTREAM_GET_INFO
= HPI_FUNC_ID(ISTREAM
, 8),
473 HPI_ISTREAM_QUERY_FORMAT
= HPI_FUNC_ID(ISTREAM
, 9),
474 HPI_ISTREAM_ANC_RESET
= HPI_FUNC_ID(ISTREAM
, 10),
475 HPI_ISTREAM_ANC_GET_INFO
= HPI_FUNC_ID(ISTREAM
, 11),
476 HPI_ISTREAM_ANC_WRITE
= HPI_FUNC_ID(ISTREAM
, 12),
477 HPI_ISTREAM_HOSTBUFFER_ALLOC
= HPI_FUNC_ID(ISTREAM
, 13),
478 HPI_ISTREAM_HOSTBUFFER_FREE
= HPI_FUNC_ID(ISTREAM
, 14),
479 HPI_ISTREAM_GROUP_ADD
= HPI_FUNC_ID(ISTREAM
, 15),
480 HPI_ISTREAM_GROUP_GETMAP
= HPI_FUNC_ID(ISTREAM
, 16),
481 HPI_ISTREAM_GROUP_RESET
= HPI_FUNC_ID(ISTREAM
, 17),
482 HPI_ISTREAM_HOSTBUFFER_GET_INFO
= HPI_FUNC_ID(ISTREAM
, 18),
483 HPI_ISTREAM_WAIT_START
= HPI_FUNC_ID(ISTREAM
, 19),
484 HPI_ISTREAM_WAIT
= HPI_FUNC_ID(ISTREAM
, 20),
485 #define HPI_ISTREAM_FUNCTION_COUNT 20
488 GET_NODE_INFO, SET_CONNECTION, GET_CONNECTIONS are not currently used */
489 HPI_MIXER_OPEN
= HPI_FUNC_ID(MIXER
, 1),
490 HPI_MIXER_CLOSE
= HPI_FUNC_ID(MIXER
, 2),
491 HPI_MIXER_GET_INFO
= HPI_FUNC_ID(MIXER
, 3),
492 HPI_MIXER_GET_NODE_INFO
= HPI_FUNC_ID(MIXER
, 4),
493 HPI_MIXER_GET_CONTROL
= HPI_FUNC_ID(MIXER
, 5),
494 HPI_MIXER_SET_CONNECTION
= HPI_FUNC_ID(MIXER
, 6),
495 HPI_MIXER_GET_CONNECTIONS
= HPI_FUNC_ID(MIXER
, 7),
496 HPI_MIXER_GET_CONTROL_BY_INDEX
= HPI_FUNC_ID(MIXER
, 8),
497 HPI_MIXER_GET_CONTROL_ARRAY_BY_INDEX
= HPI_FUNC_ID(MIXER
, 9),
498 HPI_MIXER_GET_CONTROL_MULTIPLE_VALUES
= HPI_FUNC_ID(MIXER
, 10),
499 HPI_MIXER_STORE
= HPI_FUNC_ID(MIXER
, 11),
500 HPI_MIXER_GET_CACHE_INFO
= HPI_FUNC_ID(MIXER
, 12),
501 #define HPI_MIXER_FUNCTION_COUNT 12
503 HPI_CONTROL_GET_INFO
= HPI_FUNC_ID(CONTROL
, 1),
504 HPI_CONTROL_GET_STATE
= HPI_FUNC_ID(CONTROL
, 2),
505 HPI_CONTROL_SET_STATE
= HPI_FUNC_ID(CONTROL
, 3),
506 #define HPI_CONTROL_FUNCTION_COUNT 3
508 HPI_NVMEMORY_OPEN
= HPI_FUNC_ID(NVMEMORY
, 1),
509 HPI_NVMEMORY_READ_BYTE
= HPI_FUNC_ID(NVMEMORY
, 2),
510 HPI_NVMEMORY_WRITE_BYTE
= HPI_FUNC_ID(NVMEMORY
, 3),
511 #define HPI_NVMEMORY_FUNCTION_COUNT 3
513 HPI_GPIO_OPEN
= HPI_FUNC_ID(GPIO
, 1),
514 HPI_GPIO_READ_BIT
= HPI_FUNC_ID(GPIO
, 2),
515 HPI_GPIO_WRITE_BIT
= HPI_FUNC_ID(GPIO
, 3),
516 HPI_GPIO_READ_ALL
= HPI_FUNC_ID(GPIO
, 4),
517 HPI_GPIO_WRITE_STATUS
= HPI_FUNC_ID(GPIO
, 5),
518 #define HPI_GPIO_FUNCTION_COUNT 5
520 HPI_ASYNCEVENT_OPEN
= HPI_FUNC_ID(ASYNCEVENT
, 1),
521 HPI_ASYNCEVENT_CLOSE
= HPI_FUNC_ID(ASYNCEVENT
, 2),
522 HPI_ASYNCEVENT_WAIT
= HPI_FUNC_ID(ASYNCEVENT
, 3),
523 HPI_ASYNCEVENT_GETCOUNT
= HPI_FUNC_ID(ASYNCEVENT
, 4),
524 HPI_ASYNCEVENT_GET
= HPI_FUNC_ID(ASYNCEVENT
, 5),
525 HPI_ASYNCEVENT_SENDEVENTS
= HPI_FUNC_ID(ASYNCEVENT
, 6),
526 #define HPI_ASYNCEVENT_FUNCTION_COUNT 6
528 HPI_WATCHDOG_OPEN
= HPI_FUNC_ID(WATCHDOG
, 1),
529 HPI_WATCHDOG_SET_TIME
= HPI_FUNC_ID(WATCHDOG
, 2),
530 HPI_WATCHDOG_PING
= HPI_FUNC_ID(WATCHDOG
, 3),
532 HPI_CLOCK_OPEN
= HPI_FUNC_ID(CLOCK
, 1),
533 HPI_CLOCK_SET_TIME
= HPI_FUNC_ID(CLOCK
, 2),
534 HPI_CLOCK_GET_TIME
= HPI_FUNC_ID(CLOCK
, 3),
536 HPI_PROFILE_OPEN_ALL
= HPI_FUNC_ID(PROFILE
, 1),
537 HPI_PROFILE_START_ALL
= HPI_FUNC_ID(PROFILE
, 2),
538 HPI_PROFILE_STOP_ALL
= HPI_FUNC_ID(PROFILE
, 3),
539 HPI_PROFILE_GET
= HPI_FUNC_ID(PROFILE
, 4),
540 HPI_PROFILE_GET_IDLECOUNT
= HPI_FUNC_ID(PROFILE
, 5),
541 HPI_PROFILE_GET_NAME
= HPI_FUNC_ID(PROFILE
, 6),
542 HPI_PROFILE_GET_UTILIZATION
= HPI_FUNC_ID(PROFILE
, 7)
543 #define HPI_PROFILE_FUNCTION_COUNT 7
546 /* ////////////////////////////////////////////////////////////////////// */
548 #ifndef DISABLE_PRAGMA_PACK1
549 #pragma pack(push, 1)
552 /** PCI bus resource */
554 u32 __iomem
*ap_mem_base
[HPI_MAX_ADAPTER_MEM_SPACES
];
555 struct pci_dev
*pci_dev
;
558 struct hpi_resource
{
560 const struct hpi_pci
*pci
;
563 #ifndef HPI64BIT /* keep structure size constant */
566 u16 bus_type
; /* HPI_BUS_PNPISA, _PCI, _USB etc */
571 /** Format info used inside struct hpi_message
572 Not the same as public API struct hpi_format */
573 struct hpi_msg_format
{
574 u32 sample_rate
; /**< 11025, 32000, 44100 etc. */
575 u32 bit_rate
; /**< for MPEG */
576 u32 attributes
; /**< stereo/joint_stereo/mono */
577 u16 channels
; /**< 1,2..., (or ancillary mode or idle bit */
578 u16 format
; /**< HPI_FORMAT_PCM16, _MPEG etc. see \ref HPI_FORMATS. */
581 /** Buffer+format structure.
582 Must be kept 7 * 32 bits to match public struct hpi_datastruct */
583 struct hpi_msg_data
{
584 struct hpi_msg_format format
;
592 /** struct hpi_datastructure used up to 3.04 driver */
593 struct hpi_data_legacy32
{
594 struct hpi_format format
;
600 /* Compatibility version of struct hpi_data*/
601 struct hpi_data_compat32
{
602 struct hpi_msg_format format
;
610 /** placehoder for backward compatability (see dwBufferSize) */
611 struct hpi_msg_format reserved
;
612 u32 command
; /**< HPI_BUFFER_CMD_xxx*/
613 u32 pci_address
; /**< PCI physical address of buffer for DSP DMA */
614 u32 buffer_size
; /**< must line up with data_size of HPI_DATA*/
617 /*/////////////////////////////////////////////////////////////////////////// */
618 /* This is used for background buffer bus mastering stream buffers. */
619 struct hpi_hostbuffer_status
{
620 u32 samples_processed
;
621 u32 auxiliary_data_available
;
623 /* DSP index in to the host bus master buffer. */
625 /* Host index in to the host bus master buffer. */
630 struct hpi_streamid
{
632 /**< Type of object, HPI_OBJ_OSTREAM or HPI_OBJ_ISTREAM. */
633 u16 stream_index
; /**< outstream or instream index. */
636 struct hpi_punchinout
{
638 u32 punch_out_sample
;
641 struct hpi_subsys_msg
{
642 struct hpi_resource resource
;
645 struct hpi_subsys_res
{
647 u32 data
; /* extended version */
654 union hpi_adapterx_msg
{
670 u16 offset
; /**< offset from start of msg to data */
705 struct hpi_adapter_res
{
713 u8 sz_adapter_assert
[HPI_STRING_LEN
];
716 union hpi_adapterx_res
{
717 struct hpi_adapter_res info
;
724 char sz_message
[HPI_STRING_LEN
];
746 struct hpi_stream_msg
{
748 struct hpi_msg_data data
;
749 struct hpi_data_legacy32 data32
;
751 struct hpi_punchinout pio
;
753 struct hpi_buffer buffer
;
754 struct hpi_streamid stream
;
759 struct hpi_stream_res
{
762 /* size of hardware buffer */
764 /* OutStream - data to play,
765 InStream - data recorded */
767 /* OutStream - samples played,
768 InStream - samples recorded */
769 u32 samples_transferred
;
770 /* Adapter - OutStream - data to play,
771 InStream - data recorded */
772 u32 auxiliary_data_available
;
773 u16 state
; /* HPI_STATE_PLAYING, _STATE_STOPPED */
779 u32 samples_transfered
;
784 u32 auxiliary_data_available
;
785 } legacy_stream_info
;
787 /* bitmap of grouped OutStreams */
788 u32 outstream_group_map
;
789 /* bitmap of grouped InStreams */
790 u32 instream_group_map
;
793 /* pointer to the buffer */
795 /* pointer to the hostbuffer status */
796 struct hpi_hostbuffer_status
*p_status
;
801 struct hpi_mixer_msg
{
803 u16 control_type
; /* = HPI_CONTROL_METER _VOLUME etc */
804 u16 padding1
; /* Maintain alignment of subsequent fields */
805 u16 node_type1
; /* = HPI_SOURCENODE_LINEIN etc */
806 u16 node_index1
; /* = 0..N */
809 u16 padding2
; /* round to 4 bytes */
812 struct hpi_mixer_res
{
813 u16 src_node_type
; /* = HPI_SOURCENODE_LINEIN etc */
814 u16 src_node_index
; /* = 0..N */
817 /* Also controlType for MixerGetControlByIndex */
819 /* may indicate which DSP the control is located on */
823 union hpi_mixerx_msg
{
827 u32 length_in_bytes
; /* length in bytes of p_data */
828 u32 p_data
; /* pointer to a data array */
833 } store
; /* for HPI_MIXER_STORE message */
836 union hpi_mixerx_res
{
838 u32 bytes_returned
; /* size of items returned */
839 u32 p_data
; /* pointer to data array */
840 u16 more_to_do
; /* indicates if there is more to do */
843 u32 total_controls
; /* count of controls in the mixer */
844 u32 cache_controls
; /* count of controls in the cac */
845 u32 cache_bytes
; /* size of cache */
849 struct hpi_control_msg
{
850 u16 attribute
; /* control attribute or property */
852 u32 param1
; /* generic parameter 1 */
853 u32 param2
; /* generic parameter 2 */
854 short an_log_value
[HPI_MAX_CHANNELS
];
857 struct hpi_control_union_msg
{
858 u16 attribute
; /* control attribute or property */
859 u16 saved_index
; /* only used in ctrl save/restore */
862 u32 param1
; /* generic parameter 1 */
863 u32 param2
; /* generic parameter 2 */
864 short an_log_value
[HPI_MAX_CHANNELS
];
881 struct hpi_control_res
{
882 /* Could make union. dwParam, anLogValue never used in same response */
885 short an_log_value
[HPI_MAX_CHANNELS
];
888 union hpi_control_union_res
{
892 short an_log_value
[HPI_MAX_CHANNELS
];
916 /* HPI_CONTROLX_STRUCTURES */
920 /** Used for all HMI variables where max length <= 8 bytes
922 struct hpi_controlx_msg_cobranet_data
{
928 /** Used for string data, and for packet bridge
930 struct hpi_controlx_msg_cobranet_bigdata
{
939 /** Used for PADS control reading of string fields.
941 struct hpi_controlx_msg_pad_data
{
950 /** Used for generic data
953 struct hpi_controlx_msg_generic
{
958 struct hpi_controlx_msg
{
959 u16 attribute
; /* control attribute or property */
962 struct hpi_controlx_msg_cobranet_data cobranet_data
;
963 struct hpi_controlx_msg_cobranet_bigdata cobranet_bigdata
;
964 struct hpi_controlx_msg_generic generic
;
965 struct hpi_controlx_msg_pad_data pad_data
;
966 /*struct param_value universal_value; */
967 /* nothing extra to send for status read */
974 struct hpi_controlx_res_cobranet_data
{
979 struct hpi_controlx_res_cobranet_bigdata
{
983 struct hpi_controlx_res_cobranet_status
{
989 struct hpi_controlx_res_generic
{
994 struct hpi_controlx_res
{
996 struct hpi_controlx_res_cobranet_bigdata cobranet_bigdata
;
997 struct hpi_controlx_res_cobranet_data cobranet_data
;
998 struct hpi_controlx_res_cobranet_status cobranet_status
;
999 struct hpi_controlx_res_generic generic
;
1000 /*struct param_info universal_info; */
1001 /*struct param_value universal_value; */
1005 struct hpi_nvmemory_msg
{
1010 struct hpi_nvmemory_res
{
1015 struct hpi_gpio_msg
{
1020 struct hpi_gpio_res
{
1021 u16 number_input_bits
;
1022 u16 number_output_bits
;
1026 struct hpi_async_msg
{
1032 struct hpi_async_res
{
1039 u16 number_returned
;
1042 struct hpi_async_event event
;
1046 struct hpi_watchdog_msg
{
1050 struct hpi_watchdog_res
{
1054 struct hpi_clock_msg
{
1061 struct hpi_clock_res
{
1070 struct hpi_profile_msg
{
1075 struct hpi_profile_res_open
{
1079 struct hpi_profile_res_time
{
1080 u32 total_tick_count
;
1083 u32 ticks_per_millisecond
;
1084 u16 profile_interval
;
1087 struct hpi_profile_res_name
{
1091 struct hpi_profile_res
{
1093 struct hpi_profile_res_open o
;
1094 struct hpi_profile_res_time t
;
1095 struct hpi_profile_res_name n
;
1099 struct hpi_message_header
{
1100 u16 size
; /* total size in bytes */
1101 u8 type
; /* HPI_TYPE_MESSAGE */
1102 u8 version
; /* message version */
1103 u16 object
; /* HPI_OBJ_* */
1104 u16 function
; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1105 u16 adapter_index
; /* the adapter index */
1106 u16 obj_index
; /* */
1109 struct hpi_message
{
1110 /* following fields must match HPI_MESSAGE_HEADER */
1111 u16 size
; /* total size in bytes */
1112 u8 type
; /* HPI_TYPE_MESSAGE */
1113 u8 version
; /* message version */
1114 u16 object
; /* HPI_OBJ_* */
1115 u16 function
; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1116 u16 adapter_index
; /* the adapter index */
1117 u16 obj_index
; /* */
1119 struct hpi_subsys_msg s
;
1120 union hpi_adapterx_msg ax
;
1121 struct hpi_stream_msg d
;
1122 struct hpi_mixer_msg m
;
1123 union hpi_mixerx_msg mx
; /* extended mixer; */
1124 struct hpi_control_msg c
; /* mixer control; */
1125 /* identical to struct hpi_control_msg,
1126 but field naming is improved */
1127 struct hpi_control_union_msg cu
;
1128 struct hpi_controlx_msg cx
; /* extended mixer control; */
1129 struct hpi_nvmemory_msg n
;
1130 struct hpi_gpio_msg l
; /* digital i/o */
1131 struct hpi_watchdog_msg w
;
1132 struct hpi_clock_msg t
; /* dsp time */
1133 struct hpi_profile_msg p
;
1134 struct hpi_async_msg as
;
1135 char fixed_size
[32];
1139 #define HPI_MESSAGE_SIZE_BY_OBJECT { \
1140 sizeof(struct hpi_message_header) , /* Default, no object type 0 */ \
1141 sizeof(struct hpi_message_header) + sizeof(struct hpi_subsys_msg),\
1142 sizeof(struct hpi_message_header) + sizeof(union hpi_adapterx_msg),\
1143 sizeof(struct hpi_message_header) + sizeof(struct hpi_stream_msg),\
1144 sizeof(struct hpi_message_header) + sizeof(struct hpi_stream_msg),\
1145 sizeof(struct hpi_message_header) + sizeof(struct hpi_mixer_msg),\
1146 sizeof(struct hpi_message_header) , /* no node message */ \
1147 sizeof(struct hpi_message_header) + sizeof(struct hpi_control_msg),\
1148 sizeof(struct hpi_message_header) + sizeof(struct hpi_nvmemory_msg),\
1149 sizeof(struct hpi_message_header) + sizeof(struct hpi_gpio_msg),\
1150 sizeof(struct hpi_message_header) + sizeof(struct hpi_watchdog_msg),\
1151 sizeof(struct hpi_message_header) + sizeof(struct hpi_clock_msg),\
1152 sizeof(struct hpi_message_header) + sizeof(struct hpi_profile_msg),\
1153 sizeof(struct hpi_message_header) + sizeof(struct hpi_controlx_msg),\
1154 sizeof(struct hpi_message_header) + sizeof(struct hpi_async_msg) \
1158 Note that the wSpecificError error field should be inspected and potentially
1159 reported whenever HPI_ERROR_DSP_COMMUNICATION or HPI_ERROR_DSP_BOOTLOAD is
1162 struct hpi_response_header
{
1164 u8 type
; /* HPI_TYPE_RESPONSE */
1165 u8 version
; /* response version */
1166 u16 object
; /* HPI_OBJ_* */
1167 u16 function
; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1168 u16 error
; /* HPI_ERROR_xxx */
1169 u16 specific_error
; /* adapter specific error */
1172 struct hpi_response
{
1173 /* following fields must match HPI_RESPONSE_HEADER */
1175 u8 type
; /* HPI_TYPE_RESPONSE */
1176 u8 version
; /* response version */
1177 u16 object
; /* HPI_OBJ_* */
1178 u16 function
; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1179 u16 error
; /* HPI_ERROR_xxx */
1180 u16 specific_error
; /* adapter specific error */
1182 struct hpi_subsys_res s
;
1183 union hpi_adapterx_res ax
;
1184 struct hpi_stream_res d
;
1185 struct hpi_mixer_res m
;
1186 union hpi_mixerx_res mx
; /* extended mixer; */
1187 struct hpi_control_res c
; /* mixer control; */
1188 /* identical to hpi_control_res, but field naming is improved */
1189 union hpi_control_union_res cu
;
1190 struct hpi_controlx_res cx
; /* extended mixer control; */
1191 struct hpi_nvmemory_res n
;
1192 struct hpi_gpio_res l
; /* digital i/o */
1193 struct hpi_watchdog_res w
;
1194 struct hpi_clock_res t
; /* dsp time */
1195 struct hpi_profile_res p
;
1196 struct hpi_async_res as
;
1201 #define HPI_RESPONSE_SIZE_BY_OBJECT { \
1202 sizeof(struct hpi_response_header) ,/* Default, no object type 0 */ \
1203 sizeof(struct hpi_response_header) + sizeof(struct hpi_subsys_res),\
1204 sizeof(struct hpi_response_header) + sizeof(union hpi_adapterx_res),\
1205 sizeof(struct hpi_response_header) + sizeof(struct hpi_stream_res),\
1206 sizeof(struct hpi_response_header) + sizeof(struct hpi_stream_res),\
1207 sizeof(struct hpi_response_header) + sizeof(struct hpi_mixer_res),\
1208 sizeof(struct hpi_response_header) , /* no node response */ \
1209 sizeof(struct hpi_response_header) + sizeof(struct hpi_control_res),\
1210 sizeof(struct hpi_response_header) + sizeof(struct hpi_nvmemory_res),\
1211 sizeof(struct hpi_response_header) + sizeof(struct hpi_gpio_res),\
1212 sizeof(struct hpi_response_header) + sizeof(struct hpi_watchdog_res),\
1213 sizeof(struct hpi_response_header) + sizeof(struct hpi_clock_res),\
1214 sizeof(struct hpi_response_header) + sizeof(struct hpi_profile_res),\
1215 sizeof(struct hpi_response_header) + sizeof(struct hpi_controlx_res),\
1216 sizeof(struct hpi_response_header) + sizeof(struct hpi_async_res) \
1219 /*********************** version 1 message/response **************************/
1220 #define HPINET_ETHERNET_DATA_SIZE (1500)
1221 #define HPINET_IP_HDR_SIZE (20)
1222 #define HPINET_IP_DATA_SIZE (HPINET_ETHERNET_DATA_SIZE - HPINET_IP_HDR_SIZE)
1223 #define HPINET_UDP_HDR_SIZE (8)
1224 #define HPINET_UDP_DATA_SIZE (HPINET_IP_DATA_SIZE - HPINET_UDP_HDR_SIZE)
1225 #define HPINET_ASI_HDR_SIZE (2)
1226 #define HPINET_ASI_DATA_SIZE (HPINET_UDP_DATA_SIZE - HPINET_ASI_HDR_SIZE)
1228 #define HPI_MAX_PAYLOAD_SIZE (HPINET_ASI_DATA_SIZE - 2)
1230 /* New style message/response, but still V0 compatible */
1231 struct hpi_msg_adapter_get_info
{
1232 struct hpi_message_header h
;
1235 struct hpi_res_adapter_get_info
{
1236 struct hpi_response_header h
; /*v0 */
1237 struct hpi_adapter_res p
;
1240 /* padding is so these are same size as v0 hpi_message */
1241 struct hpi_msg_adapter_query_flash
{
1242 struct hpi_message_header h
;
1244 u8 pad_to_version0_size
[sizeof(struct hpi_message
) - /* V0 res */
1245 sizeof(struct hpi_message_header
) - 1 * sizeof(u32
)];
1248 /* padding is so these are same size as v0 hpi_response */
1249 struct hpi_res_adapter_query_flash
{
1250 struct hpi_response_header h
;
1254 u8 pad_to_version0_size
[sizeof(struct hpi_response
) - /* V0 res */
1255 sizeof(struct hpi_response_header
) - 3 * sizeof(u32
)];
1258 struct hpi_msg_adapter_start_flash
{
1259 struct hpi_message_header h
;
1263 u8 pad_to_version0_size
[sizeof(struct hpi_message
) - /* V0 res */
1264 sizeof(struct hpi_message_header
) - 3 * sizeof(u32
)];
1267 struct hpi_res_adapter_start_flash
{
1268 struct hpi_response_header h
;
1269 u8 pad_to_version0_size
[sizeof(struct hpi_response
) - /* V0 res */
1270 sizeof(struct hpi_response_header
)];
1273 struct hpi_msg_adapter_program_flash_payload
{
1277 u16 offset
; /**< offset from start of msg to data */
1279 /* ensure sizeof(header + payload) == sizeof(hpi_message_V0)
1280 because old firmware expects data after message of this size */
1281 u8 pad_to_version0_size
[sizeof(struct hpi_message
) - /* V0 message */
1282 sizeof(struct hpi_message_header
) - sizeof(u32
) -
1286 struct hpi_msg_adapter_program_flash
{
1287 struct hpi_message_header h
;
1288 struct hpi_msg_adapter_program_flash_payload p
;
1292 struct hpi_res_adapter_program_flash
{
1293 struct hpi_response_header h
;
1295 u8 pad_to_version0_size
[sizeof(struct hpi_response
) - /* V0 res */
1296 sizeof(struct hpi_response_header
) - sizeof(u16
)];
1299 struct hpi_msg_adapter_debug_read
{
1300 struct hpi_message_header h
;
1305 struct hpi_res_adapter_debug_read
{
1306 struct hpi_response_header h
;
1311 #define hpi_message_header_v1 hpi_message_header
1312 #define hpi_response_header_v1 hpi_response_header
1314 /* V1 headers in Addition to v0 headers */
1315 struct hpi_message_header_v1
{
1316 struct hpi_message_header h0
;
1321 struct hpi_response_header_v1
{
1322 struct hpi_response_header h0
;
1324 u16 adapter_index
; /* the adapter index */
1325 u16 obj_index
; /* object index */
1330 struct hpi_msg_payload_v0
{
1331 struct hpi_message_header h
;
1333 struct hpi_subsys_msg s
;
1334 union hpi_adapterx_msg ax
;
1335 struct hpi_stream_msg d
;
1336 struct hpi_mixer_msg m
;
1337 union hpi_mixerx_msg mx
;
1338 struct hpi_control_msg c
;
1339 struct hpi_control_union_msg cu
;
1340 struct hpi_controlx_msg cx
;
1341 struct hpi_nvmemory_msg n
;
1342 struct hpi_gpio_msg l
;
1343 struct hpi_watchdog_msg w
;
1344 struct hpi_clock_msg t
;
1345 struct hpi_profile_msg p
;
1346 struct hpi_async_msg as
;
1350 struct hpi_res_payload_v0
{
1351 struct hpi_response_header h
;
1353 struct hpi_subsys_res s
;
1354 union hpi_adapterx_res ax
;
1355 struct hpi_stream_res d
;
1356 struct hpi_mixer_res m
;
1357 union hpi_mixerx_res mx
;
1358 struct hpi_control_res c
;
1359 union hpi_control_union_res cu
;
1360 struct hpi_controlx_res cx
;
1361 struct hpi_nvmemory_res n
;
1362 struct hpi_gpio_res l
;
1363 struct hpi_watchdog_res w
;
1364 struct hpi_clock_res t
;
1365 struct hpi_profile_res p
;
1366 struct hpi_async_res as
;
1370 union hpi_message_buffer_v1
{
1371 struct hpi_message m0
; /* version 0 */
1372 struct hpi_message_header_v1 h
;
1373 u8 buf
[HPI_MAX_PAYLOAD_SIZE
];
1376 union hpi_response_buffer_v1
{
1377 struct hpi_response r0
; /* version 0 */
1378 struct hpi_response_header_v1 h
;
1379 u8 buf
[HPI_MAX_PAYLOAD_SIZE
];
1382 compile_time_assert((sizeof(union hpi_message_buffer_v1
) <=
1383 HPI_MAX_PAYLOAD_SIZE
), message_buffer_ok
);
1384 compile_time_assert((sizeof(union hpi_response_buffer_v1
) <=
1385 HPI_MAX_PAYLOAD_SIZE
), response_buffer_ok
);
1387 /*////////////////////////////////////////////////////////////////////////// */
1388 /* declarations for compact control calls */
1389 struct hpi_control_defn
{
1398 /*////////////////////////////////////////////////////////////////////////// */
1399 /* declarations for control caching (internal to HPI<->DSP interaction) */
1401 /** indicates a cached u16 value is invalid. */
1402 #define HPI_CACHE_INVALID_UINT16 0xFFFF
1403 /** indicates a cached short value is invalid. */
1404 #define HPI_CACHE_INVALID_SHORT -32768
1406 /** A compact representation of (part of) a controls state.
1407 Used for efficient transfer of the control state
1408 between DSP and host or across a network
1410 struct hpi_control_cache_info
{
1411 /** one of HPI_CONTROL_* */
1413 /** The total size of cached information in 32-bit words. */
1414 u8 size_in32bit_words
;
1415 /** The original index of the control on the DSP */
1419 struct hpi_control_cache_vol
{
1420 struct hpi_control_cache_info i
;
1422 unsigned short flags
;
1426 struct hpi_control_cache_meter
{
1427 struct hpi_control_cache_info i
;
1428 short an_log_peak
[2];
1432 struct hpi_control_cache_channelmode
{
1433 struct hpi_control_cache_info i
;
1435 char temp_padding
[6];
1438 struct hpi_control_cache_mux
{
1439 struct hpi_control_cache_info i
;
1440 u16 source_node_type
;
1441 u16 source_node_index
;
1442 char temp_padding
[4];
1445 struct hpi_control_cache_level
{
1446 struct hpi_control_cache_info i
;
1448 char temp_padding
[4];
1451 struct hpi_control_cache_tuner
{
1452 struct hpi_control_cache_info i
;
1458 struct hpi_control_cache_aes3rx
{
1459 struct hpi_control_cache_info i
;
1464 struct hpi_control_cache_aes3tx
{
1465 struct hpi_control_cache_info i
;
1467 char temp_padding
[4];
1470 struct hpi_control_cache_tonedetector
{
1471 struct hpi_control_cache_info i
;
1473 char temp_padding
[6];
1476 struct hpi_control_cache_silencedetector
{
1477 struct hpi_control_cache_info i
;
1479 char temp_padding
[4];
1482 struct hpi_control_cache_sampleclock
{
1483 struct hpi_control_cache_info i
;
1489 struct hpi_control_cache_microphone
{
1490 struct hpi_control_cache_info i
;
1492 char temp_padding
[6];
1495 struct hpi_control_cache_generic
{
1496 struct hpi_control_cache_info i
;
1501 struct hpi_control_cache_single
{
1503 struct hpi_control_cache_info i
;
1504 struct hpi_control_cache_vol vol
;
1505 struct hpi_control_cache_meter meter
;
1506 struct hpi_control_cache_channelmode mode
;
1507 struct hpi_control_cache_mux mux
;
1508 struct hpi_control_cache_level level
;
1509 struct hpi_control_cache_tuner tuner
;
1510 struct hpi_control_cache_aes3rx aes3rx
;
1511 struct hpi_control_cache_aes3tx aes3tx
;
1512 struct hpi_control_cache_tonedetector tone
;
1513 struct hpi_control_cache_silencedetector silence
;
1514 struct hpi_control_cache_sampleclock clk
;
1515 struct hpi_control_cache_microphone microphone
;
1516 struct hpi_control_cache_generic generic
;
1520 struct hpi_control_cache_pad
{
1521 struct hpi_control_cache_info i
;
1522 u32 field_valid_flags
;
1529 u32 traffic_supported
;
1530 u32 traffic_anouncement
;
1533 /* 2^N sized FIFO buffer (internal to HPI<->DSP interaction) */
1534 struct hpi_fifo_buffer
{
1540 #ifndef DISABLE_PRAGMA_PACK1
1544 /* skip host side function declarations for DSP
1545 compile and documentation extraction */
1547 char hpi_handle_object(const u32 handle
);
1549 void hpi_handle_to_indexes(const u32 handle
, u16
*pw_adapter_index
,
1550 u16
*pw_object_index
);
1552 u32
hpi_indexes_to_handle(const char c_object
, const u16 adapter_index
,
1553 const u16 object_index
);
1555 /*////////////////////////////////////////////////////////////////////////// */
1557 /* main HPI entry point */
1558 void hpi_send_recv(struct hpi_message
*phm
, struct hpi_response
*phr
);
1560 /* used in PnP OS/driver */
1561 u16
hpi_subsys_create_adapter(const struct hpi_resource
*p_resource
,
1562 u16
*pw_adapter_index
);
1564 u16
hpi_subsys_delete_adapter(u16 adapter_index
);
1566 u16
hpi_outstream_host_buffer_get_info(u32 h_outstream
, u8
**pp_buffer
,
1567 struct hpi_hostbuffer_status
**pp_status
);
1569 u16
hpi_instream_host_buffer_get_info(u32 h_instream
, u8
**pp_buffer
,
1570 struct hpi_hostbuffer_status
**pp_status
);
1572 u16
hpi_adapter_restart(u16 adapter_index
);
1575 The following 3 functions were last declared in header files for
1576 driver 3.10. HPI_ControlQuery() used to be the recommended way
1577 of getting a volume range. Declared here for binary asihpi32.dll
1581 void hpi_format_to_msg(struct hpi_msg_format
*pMF
,
1582 const struct hpi_format
*pF
);
1583 void hpi_stream_response_to_legacy(struct hpi_stream_res
*pSR
);
1585 /*////////////////////////////////////////////////////////////////////////// */
1586 /* declarations for individual HPI entry points */
1587 hpi_handler_func HPI_1000
;
1588 hpi_handler_func HPI_6000
;
1589 hpi_handler_func HPI_6205
;
1590 hpi_handler_func HPI_COMMON
;
1592 #endif /* _HPI_INTERNAL_H_ */