projects / deliverable / linux.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
ALSA: asihpi - Fix minor typos and spelling
[deliverable/linux.git] / sound / pci / asihpi / hpi_internal.h
CommitLineData
719f82d3
EB		 1/******************************************************************************
2
3 AudioScience HPI driver
4 Copyright (C) 1997-2010 AudioScience Inc. <support@audioscience.com>
5
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of version 2 of the GNU General Public License as
8 published by the Free Software Foundation;
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18
19HPI internal definitions
20
21(C) Copyright AudioScience Inc. 1996-2009
22******************************************************************************/
23
24#ifndef _HPI_INTERNAL_H_
25#define _HPI_INTERNAL_H_
26
27#include "hpi.h"
28/** maximum number of memory regions mapped to an adapter */
29#define HPI_MAX_ADAPTER_MEM_SPACES (2)
30
3285ea10 31/* Each OS needs its own hpios.h */
719f82d3
EB		 32#include "hpios.h"
33
34/* physical memory allocation */
719f82d3
EB		 35
36/** Allocate and map an area of locked memory for bus master DMA operations.
37
38On success, *pLockedMemeHandle is a valid handle, and 0 is returned
39On error *pLockedMemHandle marked invalid, non-zero returned.
40
41If this function succeeds, then HpiOs_LockedMem_GetVirtAddr() and
42HpiOs_LockedMem_GetPyhsAddr() will always succed on the returned handle.
43*/
44u16 hpios_locked_mem_alloc(struct consistent_dma_area *p_locked_mem_handle,
45 /**< memory handle */
3285ea10 46 u32 size, /**< Size in bytes to allocate */
719f82d3
EB		 47 struct pci_dev *p_os_reference
48 /**< OS specific data required for memory allocation */
49 );
50
51/** Free mapping and memory represented by LockedMemHandle
52
53Frees any resources, then invalidates the handle.
54Returns 0 on success, 1 if handle is invalid.
55
56*/
57u16 hpios_locked_mem_free(struct consistent_dma_area *locked_mem_handle);
58
59/** Get the physical PCI address of memory represented by LockedMemHandle.
60
61If handle is invalid *pPhysicalAddr is set to zero and return 1
62*/
63u16 hpios_locked_mem_get_phys_addr(struct consistent_dma_area
64 *locked_mem_handle, u32 *p_physical_addr);
65
66/** Get the CPU address of of memory represented by LockedMemHandle.
67
68If handle is NULL *ppvVirtualAddr is set to NULL and return 1
69*/
70u16 hpios_locked_mem_get_virt_addr(struct consistent_dma_area
71 *locked_mem_handle, void **ppv_virtual_addr);
72
73/** Check that handle is valid
74i.e it represents a valid memory area
75*/
76u16 hpios_locked_mem_valid(struct consistent_dma_area *locked_mem_handle);
77
78/* timing/delay */
79void hpios_delay_micro_seconds(u32 num_micro_sec);
80
81struct hpi_message;
82struct hpi_response;
83
84typedef void hpi_handler_func(struct hpi_message *, struct hpi_response *);
85
86/* If the assert fails, compiler complains
87 something like size of array `msg' is negative.
88 Unlike linux BUILD_BUG_ON, this works outside function scope.
89*/
90#define compile_time_assert(cond, msg) \
91 typedef char ASSERT_##msg[(cond) ? 1 : -1]
92
719f82d3
EB		 93/******************************************* bus types */
94enum HPI_BUSES {
95 HPI_BUS_ISAPNP = 1,
96 HPI_BUS_PCI = 2,
97 HPI_BUS_USB = 3,
98 HPI_BUS_NET = 4
99};
100
ba94455c
EB		 101enum HPI_SUBSYS_OPTIONS {
102 /* 0, 256 are invalid, 1..255 reserved for global options */
103 HPI_SUBSYS_OPT_NET_ENABLE = 257,
104 HPI_SUBSYS_OPT_NET_BROADCAST = 258,
105 HPI_SUBSYS_OPT_NET_UNICAST = 259,
106 HPI_SUBSYS_OPT_NET_ADDR = 260,
107 HPI_SUBSYS_OPT_NET_MASK = 261,
108 HPI_SUBSYS_OPT_NET_ADAPTER_ADDRESS_ADD = 262
109};
110
fc3a3990
EB		 111/** Volume flags
112*/
113enum HPI_VOLUME_FLAGS {
114 /** Set if the volume control is muted */
115 HPI_VOLUME_FLAG_MUTED = (1 << 0),
116 /** Set if the volume control has a mute function */
117 HPI_VOLUME_FLAG_HAS_MUTE = (1 << 1),
118 /** Set if volume control can do autofading */
119 HPI_VOLUME_FLAG_HAS_AUTOFADE = (1 << 2)
120 /* Note Flags >= (1<<8) are for DSP internal use only */
121};
122
719f82d3
EB		 123/******************************************* CONTROL ATTRIBUTES ****/
124/* (in order of control type ID */
125
108ccb3f 126/* This allows for 255 control types, 256 unique attributes each */
3285ea10 127#define HPI_CTL_ATTR(ctl, ai) ((HPI_CONTROL_##ctl << 8) + ai)
719f82d3
EB		 128
129/* Get the sub-index of the attribute for a control type */
3285ea10 130#define HPI_CTL_ATTR_INDEX(i) (i & 0xff)
719f82d3 131
108ccb3f 132/* Extract the control from the control attribute */
3285ea10 133#define HPI_CTL_ATTR_CONTROL(i) (i >> 8)
719f82d3
EB		 134
135/** Enable event generation for a control.
1360=disable, 1=enable
137\note generic to all controls that can generate events
138*/
3285ea10
EB		 139
140/** Unique identifiers for every control attribute
719f82d3 141*/
3285ea10
EB		 142enum HPI_CONTROL_ATTRIBUTES {
143 HPI_GENERIC_ENABLE = HPI_CTL_ATTR(GENERIC, 1),
144 HPI_GENERIC_EVENT_ENABLE = HPI_CTL_ATTR(GENERIC, 2),
145
146 HPI_VOLUME_GAIN = HPI_CTL_ATTR(VOLUME, 1),
147 HPI_VOLUME_AUTOFADE = HPI_CTL_ATTR(VOLUME, 2),
fc3a3990
EB		 148 HPI_VOLUME_MUTE = HPI_CTL_ATTR(VOLUME, 3),
149 HPI_VOLUME_GAIN_AND_FLAGS = HPI_CTL_ATTR(VOLUME, 4),
3285ea10
EB		 150 HPI_VOLUME_NUM_CHANNELS = HPI_CTL_ATTR(VOLUME, 6),
151 HPI_VOLUME_RANGE = HPI_CTL_ATTR(VOLUME, 10),
152
153 HPI_METER_RMS = HPI_CTL_ATTR(METER, 1),
154 HPI_METER_PEAK = HPI_CTL_ATTR(METER, 2),
155 HPI_METER_RMS_BALLISTICS = HPI_CTL_ATTR(METER, 3),
156 HPI_METER_PEAK_BALLISTICS = HPI_CTL_ATTR(METER, 4),
157 HPI_METER_NUM_CHANNELS = HPI_CTL_ATTR(METER, 5),
158
159 HPI_MULTIPLEXER_SOURCE = HPI_CTL_ATTR(MULTIPLEXER, 1),
160 HPI_MULTIPLEXER_QUERYSOURCE = HPI_CTL_ATTR(MULTIPLEXER, 2),
161
162 HPI_AESEBUTX_FORMAT = HPI_CTL_ATTR(AESEBUTX, 1),
163 HPI_AESEBUTX_SAMPLERATE = HPI_CTL_ATTR(AESEBUTX, 3),
164 HPI_AESEBUTX_CHANNELSTATUS = HPI_CTL_ATTR(AESEBUTX, 4),
165 HPI_AESEBUTX_USERDATA = HPI_CTL_ATTR(AESEBUTX, 5),
166
167 HPI_AESEBURX_FORMAT = HPI_CTL_ATTR(AESEBURX, 1),
168 HPI_AESEBURX_ERRORSTATUS = HPI_CTL_ATTR(AESEBURX, 2),
169 HPI_AESEBURX_SAMPLERATE = HPI_CTL_ATTR(AESEBURX, 3),
170 HPI_AESEBURX_CHANNELSTATUS = HPI_CTL_ATTR(AESEBURX, 4),
171 HPI_AESEBURX_USERDATA = HPI_CTL_ATTR(AESEBURX, 5),
172
173 HPI_LEVEL_GAIN = HPI_CTL_ATTR(LEVEL, 1),
174 HPI_LEVEL_RANGE = HPI_CTL_ATTR(LEVEL, 10),
175
176 HPI_TUNER_BAND = HPI_CTL_ATTR(TUNER, 1),
177 HPI_TUNER_FREQ = HPI_CTL_ATTR(TUNER, 2),
178 HPI_TUNER_LEVEL_AVG = HPI_CTL_ATTR(TUNER, 3),
179 HPI_TUNER_LEVEL_RAW = HPI_CTL_ATTR(TUNER, 4),
180 HPI_TUNER_SNR = HPI_CTL_ATTR(TUNER, 5),
181 HPI_TUNER_GAIN = HPI_CTL_ATTR(TUNER, 6),
182 HPI_TUNER_STATUS = HPI_CTL_ATTR(TUNER, 7),
183 HPI_TUNER_MODE = HPI_CTL_ATTR(TUNER, 8),
184 HPI_TUNER_RDS = HPI_CTL_ATTR(TUNER, 9),
185 HPI_TUNER_DEEMPHASIS = HPI_CTL_ATTR(TUNER, 10),
186 HPI_TUNER_PROGRAM = HPI_CTL_ATTR(TUNER, 11),
187 HPI_TUNER_HDRADIO_SIGNAL_QUALITY = HPI_CTL_ATTR(TUNER, 12),
188 HPI_TUNER_HDRADIO_SDK_VERSION = HPI_CTL_ATTR(TUNER, 13),
189 HPI_TUNER_HDRADIO_DSP_VERSION = HPI_CTL_ATTR(TUNER, 14),
190 HPI_TUNER_HDRADIO_BLEND = HPI_CTL_ATTR(TUNER, 15),
191
192 HPI_VOX_THRESHOLD = HPI_CTL_ATTR(VOX, 1),
193
194 HPI_CHANNEL_MODE_MODE = HPI_CTL_ATTR(CHANNEL_MODE, 1),
195
196 HPI_BITSTREAM_DATA_POLARITY = HPI_CTL_ATTR(BITSTREAM, 1),
197 HPI_BITSTREAM_CLOCK_EDGE = HPI_CTL_ATTR(BITSTREAM, 2),
198 HPI_BITSTREAM_CLOCK_SOURCE = HPI_CTL_ATTR(BITSTREAM, 3),
199 HPI_BITSTREAM_ACTIVITY = HPI_CTL_ATTR(BITSTREAM, 4),
200
201 HPI_SAMPLECLOCK_SOURCE = HPI_CTL_ATTR(SAMPLECLOCK, 1),
202 HPI_SAMPLECLOCK_SAMPLERATE = HPI_CTL_ATTR(SAMPLECLOCK, 2),
203 HPI_SAMPLECLOCK_SOURCE_INDEX = HPI_CTL_ATTR(SAMPLECLOCK, 3),
204 HPI_SAMPLECLOCK_LOCAL_SAMPLERATE = HPI_CTL_ATTR(SAMPLECLOCK, 4),
205 HPI_SAMPLECLOCK_AUTO = HPI_CTL_ATTR(SAMPLECLOCK, 5),
206 HPI_SAMPLECLOCK_LOCAL_LOCK = HPI_CTL_ATTR(SAMPLECLOCK, 6),
207
208 HPI_MICROPHONE_PHANTOM_POWER = HPI_CTL_ATTR(MICROPHONE, 1),
209
210 HPI_EQUALIZER_NUM_FILTERS = HPI_CTL_ATTR(EQUALIZER, 1),
211 HPI_EQUALIZER_FILTER = HPI_CTL_ATTR(EQUALIZER, 2),
212 HPI_EQUALIZER_COEFFICIENTS = HPI_CTL_ATTR(EQUALIZER, 3),
213
214 HPI_COMPANDER_PARAMS = HPI_CTL_ATTR(COMPANDER, 1),
215 HPI_COMPANDER_MAKEUPGAIN = HPI_CTL_ATTR(COMPANDER, 2),
216 HPI_COMPANDER_THRESHOLD = HPI_CTL_ATTR(COMPANDER, 3),
217 HPI_COMPANDER_RATIO = HPI_CTL_ATTR(COMPANDER, 4),
218 HPI_COMPANDER_ATTACK = HPI_CTL_ATTR(COMPANDER, 5),
219 HPI_COMPANDER_DECAY = HPI_CTL_ATTR(COMPANDER, 6),
220
221 HPI_COBRANET_SET = HPI_CTL_ATTR(COBRANET, 1),
222 HPI_COBRANET_GET = HPI_CTL_ATTR(COBRANET, 2),
58fbf77f
EB		 223 /*HPI_COBRANET_SET_DATA = HPI_CTL_ATTR(COBRANET, 3), */
224 /*HPI_COBRANET_GET_DATA = HPI_CTL_ATTR(COBRANET, 4), */
3285ea10
EB		 225 HPI_COBRANET_GET_STATUS = HPI_CTL_ATTR(COBRANET, 5),
226 HPI_COBRANET_SEND_PACKET = HPI_CTL_ATTR(COBRANET, 6),
227 HPI_COBRANET_GET_PACKET = HPI_CTL_ATTR(COBRANET, 7),
228
229 HPI_TONEDETECTOR_THRESHOLD = HPI_CTL_ATTR(TONEDETECTOR, 1),
230 HPI_TONEDETECTOR_STATE = HPI_CTL_ATTR(TONEDETECTOR, 2),
231 HPI_TONEDETECTOR_FREQUENCY = HPI_CTL_ATTR(TONEDETECTOR, 3),
232
233 HPI_SILENCEDETECTOR_THRESHOLD = HPI_CTL_ATTR(SILENCEDETECTOR, 1),
234 HPI_SILENCEDETECTOR_STATE = HPI_CTL_ATTR(SILENCEDETECTOR, 2),
235 HPI_SILENCEDETECTOR_DELAY = HPI_CTL_ATTR(SILENCEDETECTOR, 3),
236
237 HPI_PAD_CHANNEL_NAME = HPI_CTL_ATTR(PAD, 1),
238 HPI_PAD_ARTIST = HPI_CTL_ATTR(PAD, 2),
239 HPI_PAD_TITLE = HPI_CTL_ATTR(PAD, 3),
240 HPI_PAD_COMMENT = HPI_CTL_ATTR(PAD, 4),
241 HPI_PAD_PROGRAM_TYPE = HPI_CTL_ATTR(PAD, 5),
242 HPI_PAD_PROGRAM_ID = HPI_CTL_ATTR(PAD, 6),
243 HPI_PAD_TA_SUPPORT = HPI_CTL_ATTR(PAD, 7),
244 HPI_PAD_TA_ACTIVE = HPI_CTL_ATTR(PAD, 8)
245};
719f82d3
EB		 246
247#define HPI_POLARITY_POSITIVE 0
248#define HPI_POLARITY_NEGATIVE 1
249
719f82d3
EB		 250/*------------------------------------------------------------
251 Cobranet Chip Bridge - copied from HMI.H
252------------------------------------------------------------*/
253#define HPI_COBRANET_HMI_cobra_bridge 0x20000
254#define HPI_COBRANET_HMI_cobra_bridge_tx_pkt_buf \
255 (HPI_COBRANET_HMI_cobra_bridge + 0x1000)
256#define HPI_COBRANET_HMI_cobra_bridge_rx_pkt_buf \
257 (HPI_COBRANET_HMI_cobra_bridge + 0x2000)
258#define HPI_COBRANET_HMI_cobra_if_table1 0x110000
259#define HPI_COBRANET_HMI_cobra_if_phy_address \
260 (HPI_COBRANET_HMI_cobra_if_table1 + 0xd)
261#define HPI_COBRANET_HMI_cobra_protocolIP 0x72000
262#define HPI_COBRANET_HMI_cobra_ip_mon_currentIP \
263 (HPI_COBRANET_HMI_cobra_protocolIP + 0x0)
264#define HPI_COBRANET_HMI_cobra_ip_mon_staticIP \
265 (HPI_COBRANET_HMI_cobra_protocolIP + 0x2)
266#define HPI_COBRANET_HMI_cobra_sys 0x100000
267#define HPI_COBRANET_HMI_cobra_sys_desc \
268 (HPI_COBRANET_HMI_cobra_sys + 0x0)
269#define HPI_COBRANET_HMI_cobra_sys_objectID \
270 (HPI_COBRANET_HMI_cobra_sys + 0x100)
271#define HPI_COBRANET_HMI_cobra_sys_contact \
272 (HPI_COBRANET_HMI_cobra_sys + 0x200)
273#define HPI_COBRANET_HMI_cobra_sys_name \
274 (HPI_COBRANET_HMI_cobra_sys + 0x300)
275#define HPI_COBRANET_HMI_cobra_sys_location \
276 (HPI_COBRANET_HMI_cobra_sys + 0x400)
277
278/*------------------------------------------------------------
279 Cobranet Chip Status bits
280------------------------------------------------------------*/
281#define HPI_COBRANET_HMI_STATUS_RXPACKET 2
282#define HPI_COBRANET_HMI_STATUS_TXPACKET 3
283
284/*------------------------------------------------------------
285 Ethernet header size
286------------------------------------------------------------*/
287#define HPI_ETHERNET_HEADER_SIZE (16)
288
289/* These defines are used to fill in protocol information for an Ethernet packet
290 sent using HMI on CS18102 */
6d0b898e 291/** ID supplied by Cirrus for ASI packets. */
719f82d3
EB		 292#define HPI_ETHERNET_PACKET_ID 0x85
293/** Simple packet - no special routing required */
294#define HPI_ETHERNET_PACKET_V1 0x01
295/** This packet must make its way to the host across the HPI interface */
296#define HPI_ETHERNET_PACKET_HOSTED_VIA_HMI 0x20
297/** This packet must make its way to the host across the HPI interface */
298#define HPI_ETHERNET_PACKET_HOSTED_VIA_HMI_V1 0x21
299/** This packet must make its way to the host across the HPI interface */
300#define HPI_ETHERNET_PACKET_HOSTED_VIA_HPI 0x40
301/** This packet must make its way to the host across the HPI interface */
302#define HPI_ETHERNET_PACKET_HOSTED_VIA_HPI_V1 0x41
303
6d0b898e 304#define HPI_ETHERNET_UDP_PORT 44600 /**< HPI UDP service */
719f82d3 305
a287ca2a
EB		 306/** Default network timeout in milli-seconds. */
307#define HPI_ETHERNET_TIMEOUT_MS 500
719f82d3 308
3285ea10
EB		 309/** Locked memory buffer alloc/free phases */
310enum HPI_BUFFER_CMDS {
311 /** use one message to allocate or free physical memory */
312 HPI_BUFFER_CMD_EXTERNAL = 0,
313 /** alloc physical memory */
314 HPI_BUFFER_CMD_INTERNAL_ALLOC = 1,
315 /** send physical memory address to adapter */
316 HPI_BUFFER_CMD_INTERNAL_GRANTADAPTER = 2,
317 /** notify adapter to stop using physical buffer */
318 HPI_BUFFER_CMD_INTERNAL_REVOKEADAPTER = 3,
319 /** free physical buffer */
320 HPI_BUFFER_CMD_INTERNAL_FREE = 4
321};
719f82d3
EB		 322
323/*****************************************************************************/
324/*****************************************************************************/
325/******** HPI LOW LEVEL MESSAGES *******/
326/*****************************************************************************/
327/*****************************************************************************/
328/** Pnp ids */
329/** "ASI" - actual is "ASX" - need to change */
330#define HPI_ID_ISAPNP_AUDIOSCIENCE 0x0669
331/** PCI vendor ID that AudioScience uses */
332#define HPI_PCI_VENDOR_ID_AUDIOSCIENCE 0x175C
333/** PCI vendor ID that the DSP56301 has */
334#define HPI_PCI_VENDOR_ID_MOTOROLA 0x1057
335/** PCI vendor ID that TI uses */
336#define HPI_PCI_VENDOR_ID_TI 0x104C
337
338#define HPI_PCI_DEV_ID_PCI2040 0xAC60
339/** TI's C6205 PCI interface has this ID */
340#define HPI_PCI_DEV_ID_DSP6205 0xA106
341
342#define HPI_USB_VENDOR_ID_AUDIOSCIENCE 0x1257
343#define HPI_USB_W2K_TAG 0x57495341 /* "ASIW" */
344#define HPI_USB_LINUX_TAG 0x4C495341 /* "ASIL" */
345
3285ea10
EB		 346/** Invalid Adapter index
347Used in HPI messages that are not addressed to a specific adapter
348Used in DLL to indicate device not present
349*/
350#define HPI_ADAPTER_INDEX_INVALID 0xFFFF
351
719f82d3
EB		 352/** First 2 hex digits define the adapter family */
353#define HPI_ADAPTER_FAMILY_MASK 0xff00
5a498ef1 354#define HPI_MODULE_FAMILY_MASK 0xfff0
719f82d3
EB		 355
356#define HPI_ADAPTER_FAMILY_ASI(f) (f & HPI_ADAPTER_FAMILY_MASK)
5a498ef1 357#define HPI_MODULE_FAMILY_ASI(f) (f & HPI_MODULE_FAMILY_MASK)
719f82d3
EB		 358#define HPI_ADAPTER_ASI(f) (f)
359
3285ea10 360enum HPI_MESSAGE_TYPES {
82b5774f 361 HPI_TYPE_REQUEST = 1,
3285ea10
EB		 362 HPI_TYPE_RESPONSE = 2,
363 HPI_TYPE_DATA = 3,
364 HPI_TYPE_SSX2BYPASS_MESSAGE = 4
365};
366
367enum HPI_OBJECT_TYPES {
368 HPI_OBJ_SUBSYSTEM = 1,
369 HPI_OBJ_ADAPTER = 2,
370 HPI_OBJ_OSTREAM = 3,
371 HPI_OBJ_ISTREAM = 4,
372 HPI_OBJ_MIXER = 5,
373 HPI_OBJ_NODE = 6,
374 HPI_OBJ_CONTROL = 7,
375 HPI_OBJ_NVMEMORY = 8,
376 HPI_OBJ_GPIO = 9,
377 HPI_OBJ_WATCHDOG = 10,
378 HPI_OBJ_CLOCK = 11,
379 HPI_OBJ_PROFILE = 12,
58fbf77f 380 /* HPI_ OBJ_ CONTROLEX = 13, */
3285ea10
EB		 381 HPI_OBJ_ASYNCEVENT = 14
382#define HPI_OBJ_MAXINDEX 14
383};
384
385#define HPI_OBJ_FUNCTION_SPACING 0x100
a287ca2a 386#define HPI_FUNC_ID(obj, i) (HPI_OBJ_##obj * HPI_OBJ_FUNCTION_SPACING + i)
3285ea10 387
719f82d3
EB		 388#define HPI_EXTRACT_INDEX(fn) (fn & 0xff)
389
3285ea10
EB		 390enum HPI_FUNCTION_IDS {
391 HPI_SUBSYS_OPEN = HPI_FUNC_ID(SUBSYSTEM, 1),
392 HPI_SUBSYS_GET_VERSION = HPI_FUNC_ID(SUBSYSTEM, 2),
393 HPI_SUBSYS_GET_INFO = HPI_FUNC_ID(SUBSYSTEM, 3),
6d0b898e 394 /* HPI_SUBSYS_FIND_ADAPTERS = HPI_FUNC_ID(SUBSYSTEM, 4), */
3285ea10
EB		 395 HPI_SUBSYS_CREATE_ADAPTER = HPI_FUNC_ID(SUBSYSTEM, 5),
396 HPI_SUBSYS_CLOSE = HPI_FUNC_ID(SUBSYSTEM, 6),
6d0b898e 397 /* HPI_SUBSYS_DELETE_ADAPTER = HPI_FUNC_ID(SUBSYSTEM, 7), */
3285ea10
EB		 398 HPI_SUBSYS_DRIVER_LOAD = HPI_FUNC_ID(SUBSYSTEM, 8),
399 HPI_SUBSYS_DRIVER_UNLOAD = HPI_FUNC_ID(SUBSYSTEM, 9),
6d0b898e
EB		 400 /* HPI_SUBSYS_READ_PORT_8 = HPI_FUNC_ID(SUBSYSTEM, 10), */
401 /* HPI_SUBSYS_WRITE_PORT_8 = HPI_FUNC_ID(SUBSYSTEM, 11), */
3285ea10
EB		 402 HPI_SUBSYS_GET_NUM_ADAPTERS = HPI_FUNC_ID(SUBSYSTEM, 12),
403 HPI_SUBSYS_GET_ADAPTER = HPI_FUNC_ID(SUBSYSTEM, 13),
404 HPI_SUBSYS_SET_NETWORK_INTERFACE = HPI_FUNC_ID(SUBSYSTEM, 14),
405 HPI_SUBSYS_OPTION_INFO = HPI_FUNC_ID(SUBSYSTEM, 15),
406 HPI_SUBSYS_OPTION_GET = HPI_FUNC_ID(SUBSYSTEM, 16),
407 HPI_SUBSYS_OPTION_SET = HPI_FUNC_ID(SUBSYSTEM, 17),
408#define HPI_SUBSYS_FUNCTION_COUNT 17
409
410 HPI_ADAPTER_OPEN = HPI_FUNC_ID(ADAPTER, 1),
411 HPI_ADAPTER_CLOSE = HPI_FUNC_ID(ADAPTER, 2),
412 HPI_ADAPTER_GET_INFO = HPI_FUNC_ID(ADAPTER, 3),
413 HPI_ADAPTER_GET_ASSERT = HPI_FUNC_ID(ADAPTER, 4),
414 HPI_ADAPTER_TEST_ASSERT = HPI_FUNC_ID(ADAPTER, 5),
415 HPI_ADAPTER_SET_MODE = HPI_FUNC_ID(ADAPTER, 6),
416 HPI_ADAPTER_GET_MODE = HPI_FUNC_ID(ADAPTER, 7),
417 HPI_ADAPTER_ENABLE_CAPABILITY = HPI_FUNC_ID(ADAPTER, 8),
418 HPI_ADAPTER_SELFTEST = HPI_FUNC_ID(ADAPTER, 9),
419 HPI_ADAPTER_FIND_OBJECT = HPI_FUNC_ID(ADAPTER, 10),
420 HPI_ADAPTER_QUERY_FLASH = HPI_FUNC_ID(ADAPTER, 11),
421 HPI_ADAPTER_START_FLASH = HPI_FUNC_ID(ADAPTER, 12),
422 HPI_ADAPTER_PROGRAM_FLASH = HPI_FUNC_ID(ADAPTER, 13),
423 HPI_ADAPTER_SET_PROPERTY = HPI_FUNC_ID(ADAPTER, 14),
424 HPI_ADAPTER_GET_PROPERTY = HPI_FUNC_ID(ADAPTER, 15),
425 HPI_ADAPTER_ENUM_PROPERTY = HPI_FUNC_ID(ADAPTER, 16),
426 HPI_ADAPTER_MODULE_INFO = HPI_FUNC_ID(ADAPTER, 17),
427 HPI_ADAPTER_DEBUG_READ = HPI_FUNC_ID(ADAPTER, 18),
bd33c1ca
EB		 428 HPI_ADAPTER_IRQ_QUERY_AND_CLEAR = HPI_FUNC_ID(ADAPTER, 19),
429 HPI_ADAPTER_IRQ_CALLBACK = HPI_FUNC_ID(ADAPTER, 20),
6d0b898e
EB		 430 HPI_ADAPTER_DELETE = HPI_FUNC_ID(ADAPTER, 21),
431#define HPI_ADAPTER_FUNCTION_COUNT 21
3285ea10
EB		 432
433 HPI_OSTREAM_OPEN = HPI_FUNC_ID(OSTREAM, 1),
434 HPI_OSTREAM_CLOSE = HPI_FUNC_ID(OSTREAM, 2),
435 HPI_OSTREAM_WRITE = HPI_FUNC_ID(OSTREAM, 3),
436 HPI_OSTREAM_START = HPI_FUNC_ID(OSTREAM, 4),
437 HPI_OSTREAM_STOP = HPI_FUNC_ID(OSTREAM, 5),
438 HPI_OSTREAM_RESET = HPI_FUNC_ID(OSTREAM, 6),
439 HPI_OSTREAM_GET_INFO = HPI_FUNC_ID(OSTREAM, 7),
440 HPI_OSTREAM_QUERY_FORMAT = HPI_FUNC_ID(OSTREAM, 8),
441 HPI_OSTREAM_DATA = HPI_FUNC_ID(OSTREAM, 9),
442 HPI_OSTREAM_SET_VELOCITY = HPI_FUNC_ID(OSTREAM, 10),
443 HPI_OSTREAM_SET_PUNCHINOUT = HPI_FUNC_ID(OSTREAM, 11),
444 HPI_OSTREAM_SINEGEN = HPI_FUNC_ID(OSTREAM, 12),
445 HPI_OSTREAM_ANC_RESET = HPI_FUNC_ID(OSTREAM, 13),
446 HPI_OSTREAM_ANC_GET_INFO = HPI_FUNC_ID(OSTREAM, 14),
447 HPI_OSTREAM_ANC_READ = HPI_FUNC_ID(OSTREAM, 15),
448 HPI_OSTREAM_SET_TIMESCALE = HPI_FUNC_ID(OSTREAM, 16),
449 HPI_OSTREAM_SET_FORMAT = HPI_FUNC_ID(OSTREAM, 17),
450 HPI_OSTREAM_HOSTBUFFER_ALLOC = HPI_FUNC_ID(OSTREAM, 18),
451 HPI_OSTREAM_HOSTBUFFER_FREE = HPI_FUNC_ID(OSTREAM, 19),
452 HPI_OSTREAM_GROUP_ADD = HPI_FUNC_ID(OSTREAM, 20),
453 HPI_OSTREAM_GROUP_GETMAP = HPI_FUNC_ID(OSTREAM, 21),
454 HPI_OSTREAM_GROUP_RESET = HPI_FUNC_ID(OSTREAM, 22),
455 HPI_OSTREAM_HOSTBUFFER_GET_INFO = HPI_FUNC_ID(OSTREAM, 23),
456 HPI_OSTREAM_WAIT_START = HPI_FUNC_ID(OSTREAM, 24),
bd33c1ca
EB		 457 HPI_OSTREAM_WAIT = HPI_FUNC_ID(OSTREAM, 25),
458#define HPI_OSTREAM_FUNCTION_COUNT 25
3285ea10
EB		 459
460 HPI_ISTREAM_OPEN = HPI_FUNC_ID(ISTREAM, 1),
461 HPI_ISTREAM_CLOSE = HPI_FUNC_ID(ISTREAM, 2),
462 HPI_ISTREAM_SET_FORMAT = HPI_FUNC_ID(ISTREAM, 3),
463 HPI_ISTREAM_READ = HPI_FUNC_ID(ISTREAM, 4),
464 HPI_ISTREAM_START = HPI_FUNC_ID(ISTREAM, 5),
465 HPI_ISTREAM_STOP = HPI_FUNC_ID(ISTREAM, 6),
466 HPI_ISTREAM_RESET = HPI_FUNC_ID(ISTREAM, 7),
467 HPI_ISTREAM_GET_INFO = HPI_FUNC_ID(ISTREAM, 8),
468 HPI_ISTREAM_QUERY_FORMAT = HPI_FUNC_ID(ISTREAM, 9),
469 HPI_ISTREAM_ANC_RESET = HPI_FUNC_ID(ISTREAM, 10),
470 HPI_ISTREAM_ANC_GET_INFO = HPI_FUNC_ID(ISTREAM, 11),
471 HPI_ISTREAM_ANC_WRITE = HPI_FUNC_ID(ISTREAM, 12),
472 HPI_ISTREAM_HOSTBUFFER_ALLOC = HPI_FUNC_ID(ISTREAM, 13),
473 HPI_ISTREAM_HOSTBUFFER_FREE = HPI_FUNC_ID(ISTREAM, 14),
474 HPI_ISTREAM_GROUP_ADD = HPI_FUNC_ID(ISTREAM, 15),
475 HPI_ISTREAM_GROUP_GETMAP = HPI_FUNC_ID(ISTREAM, 16),
476 HPI_ISTREAM_GROUP_RESET = HPI_FUNC_ID(ISTREAM, 17),
477 HPI_ISTREAM_HOSTBUFFER_GET_INFO = HPI_FUNC_ID(ISTREAM, 18),
478 HPI_ISTREAM_WAIT_START = HPI_FUNC_ID(ISTREAM, 19),
bd33c1ca
EB		 479 HPI_ISTREAM_WAIT = HPI_FUNC_ID(ISTREAM, 20),
480#define HPI_ISTREAM_FUNCTION_COUNT 20
3285ea10 481
719f82d3
EB		 482/* NOTE:
483 GET_NODE_INFO, SET_CONNECTION, GET_CONNECTIONS are not currently used */
3285ea10
EB		 484 HPI_MIXER_OPEN = HPI_FUNC_ID(MIXER, 1),
485 HPI_MIXER_CLOSE = HPI_FUNC_ID(MIXER, 2),
486 HPI_MIXER_GET_INFO = HPI_FUNC_ID(MIXER, 3),
487 HPI_MIXER_GET_NODE_INFO = HPI_FUNC_ID(MIXER, 4),
488 HPI_MIXER_GET_CONTROL = HPI_FUNC_ID(MIXER, 5),
489 HPI_MIXER_SET_CONNECTION = HPI_FUNC_ID(MIXER, 6),
490 HPI_MIXER_GET_CONNECTIONS = HPI_FUNC_ID(MIXER, 7),
491 HPI_MIXER_GET_CONTROL_BY_INDEX = HPI_FUNC_ID(MIXER, 8),
492 HPI_MIXER_GET_CONTROL_ARRAY_BY_INDEX = HPI_FUNC_ID(MIXER, 9),
493 HPI_MIXER_GET_CONTROL_MULTIPLE_VALUES = HPI_FUNC_ID(MIXER, 10),
494 HPI_MIXER_STORE = HPI_FUNC_ID(MIXER, 11),
bd33c1ca
EB		 495 HPI_MIXER_GET_CACHE_INFO = HPI_FUNC_ID(MIXER, 12),
496#define HPI_MIXER_FUNCTION_COUNT 12
3285ea10
EB		 497
498 HPI_CONTROL_GET_INFO = HPI_FUNC_ID(CONTROL, 1),
499 HPI_CONTROL_GET_STATE = HPI_FUNC_ID(CONTROL, 2),
500 HPI_CONTROL_SET_STATE = HPI_FUNC_ID(CONTROL, 3),
719f82d3 501#define HPI_CONTROL_FUNCTION_COUNT 3
3285ea10
EB		 502
503 HPI_NVMEMORY_OPEN = HPI_FUNC_ID(NVMEMORY, 1),
504 HPI_NVMEMORY_READ_BYTE = HPI_FUNC_ID(NVMEMORY, 2),
505 HPI_NVMEMORY_WRITE_BYTE = HPI_FUNC_ID(NVMEMORY, 3),
719f82d3 506#define HPI_NVMEMORY_FUNCTION_COUNT 3
3285ea10
EB		 507
508 HPI_GPIO_OPEN = HPI_FUNC_ID(GPIO, 1),
509 HPI_GPIO_READ_BIT = HPI_FUNC_ID(GPIO, 2),
510 HPI_GPIO_WRITE_BIT = HPI_FUNC_ID(GPIO, 3),
511 HPI_GPIO_READ_ALL = HPI_FUNC_ID(GPIO, 4),
512 HPI_GPIO_WRITE_STATUS = HPI_FUNC_ID(GPIO, 5),
719f82d3 513#define HPI_GPIO_FUNCTION_COUNT 5
3285ea10
EB		 514
515 HPI_ASYNCEVENT_OPEN = HPI_FUNC_ID(ASYNCEVENT, 1),
516 HPI_ASYNCEVENT_CLOSE = HPI_FUNC_ID(ASYNCEVENT, 2),
517 HPI_ASYNCEVENT_WAIT = HPI_FUNC_ID(ASYNCEVENT, 3),
518 HPI_ASYNCEVENT_GETCOUNT = HPI_FUNC_ID(ASYNCEVENT, 4),
519 HPI_ASYNCEVENT_GET = HPI_FUNC_ID(ASYNCEVENT, 5),
520 HPI_ASYNCEVENT_SENDEVENTS = HPI_FUNC_ID(ASYNCEVENT, 6),
719f82d3 521#define HPI_ASYNCEVENT_FUNCTION_COUNT 6
3285ea10
EB		 522
523 HPI_WATCHDOG_OPEN = HPI_FUNC_ID(WATCHDOG, 1),
524 HPI_WATCHDOG_SET_TIME = HPI_FUNC_ID(WATCHDOG, 2),
525 HPI_WATCHDOG_PING = HPI_FUNC_ID(WATCHDOG, 3),
526
527 HPI_CLOCK_OPEN = HPI_FUNC_ID(CLOCK, 1),
528 HPI_CLOCK_SET_TIME = HPI_FUNC_ID(CLOCK, 2),
529 HPI_CLOCK_GET_TIME = HPI_FUNC_ID(CLOCK, 3),
530
531 HPI_PROFILE_OPEN_ALL = HPI_FUNC_ID(PROFILE, 1),
532 HPI_PROFILE_START_ALL = HPI_FUNC_ID(PROFILE, 2),
533 HPI_PROFILE_STOP_ALL = HPI_FUNC_ID(PROFILE, 3),
534 HPI_PROFILE_GET = HPI_FUNC_ID(PROFILE, 4),
535 HPI_PROFILE_GET_IDLECOUNT = HPI_FUNC_ID(PROFILE, 5),
536 HPI_PROFILE_GET_NAME = HPI_FUNC_ID(PROFILE, 6),
537 HPI_PROFILE_GET_UTILIZATION = HPI_FUNC_ID(PROFILE, 7)
719f82d3 538#define HPI_PROFILE_FUNCTION_COUNT 7
3285ea10 539};
719f82d3
EB		 540
541/* ////////////////////////////////////////////////////////////////////// */
542/* STRUCTURES */
543#ifndef DISABLE_PRAGMA_PACK1
544#pragma pack(push, 1)
545#endif
546
547/** PCI bus resource */
548struct hpi_pci {
549 u32 __iomem *ap_mem_base[HPI_MAX_ADAPTER_MEM_SPACES];
3285ea10 550 struct pci_dev *pci_dev;
719f82d3
EB		 551};
552
553struct hpi_resource {
554 union {
555 const struct hpi_pci *pci;
556 const char *net_if;
557 } r;
558#ifndef HPI64BIT /* keep structure size constant */
559 u32 pad_to64;
560#endif
561 u16 bus_type; /* HPI_BUS_PNPISA, _PCI, _USB etc */
562 u16 padding;
563
564};
565
566/** Format info used inside struct hpi_message
567 Not the same as public API struct hpi_format */
568struct hpi_msg_format {
1d595d2a
EB		 569 u32 sample_rate; /**< 11025, 32000, 44100 etc. */
570 u32 bit_rate; /**< for MPEG */
571 u32 attributes; /**< stereo/joint_stereo/mono */
572 u16 channels; /**< 1,2..., (or ancillary mode or idle bit */
719f82d3
EB		 573 u16 format; /**< HPI_FORMAT_PCM16, _MPEG etc. see \ref HPI_FORMATS. */
574};
575
576/** Buffer+format structure.
577 Must be kept 7 * 32 bits to match public struct hpi_datastruct */
578struct hpi_msg_data {
579 struct hpi_msg_format format;
580 u8 *pb_data;
581#ifndef HPI64BIT
582 u32 padding;
583#endif
584 u32 data_size;
585};
586
587/** struct hpi_datastructure used up to 3.04 driver */
588struct hpi_data_legacy32 {
589 struct hpi_format format;
590 u32 pb_data;
591 u32 data_size;
592};
593
594#ifdef HPI64BIT
595/* Compatibility version of struct hpi_data*/
596struct hpi_data_compat32 {
597 struct hpi_msg_format format;
598 u32 pb_data;
599 u32 padding;
600 u32 data_size;
601};
602#endif
603
604struct hpi_buffer {
938c565a 605 /** placeholder for backward compatibility (see dwBufferSize) */
719f82d3 606 struct hpi_msg_format reserved;
1d595d2a 607 u32 command; /**< HPI_BUFFER_CMD_xxx*/
719f82d3
EB		 608 u32 pci_address; /**< PCI physical address of buffer for DSP DMA */
609 u32 buffer_size; /**< must line up with data_size of HPI_DATA*/
610};
611
612/*/////////////////////////////////////////////////////////////////////////// */
613/* This is used for background buffer bus mastering stream buffers. */
614struct hpi_hostbuffer_status {
615 u32 samples_processed;
616 u32 auxiliary_data_available;
617 u32 stream_state;
618 /* DSP index in to the host bus master buffer. */
619 u32 dSP_index;
620 /* Host index in to the host bus master buffer. */
621 u32 host_index;
622 u32 size_in_bytes;
623};
624
625struct hpi_streamid {
626 u16 object_type;
627 /**< Type of object, HPI_OBJ_OSTREAM or HPI_OBJ_ISTREAM. */
628 u16 stream_index; /**< outstream or instream index. */
629};
630
631struct hpi_punchinout {
632 u32 punch_in_sample;
633 u32 punch_out_sample;
634};
635
636struct hpi_subsys_msg {
637 struct hpi_resource resource;
638};
639
640struct hpi_subsys_res {
641 u32 version;
2f918a64
EB		 642 u32 data; /* extended version */
643 u16 num_adapters;
719f82d3 644 u16 adapter_index;
2f918a64
EB		 645 u16 adapter_type;
646 u16 pad16;
719f82d3
EB		 647};
648
719f82d3 649union hpi_adapterx_msg {
719f82d3 650 struct {
3285ea10
EB		 651 u32 dsp_address;
652 u32 count_bytes;
653 } debug_read;
719f82d3 654 struct {
3285ea10
EB		 655 u32 adapter_mode;
656 u16 query_or_set;
657 } mode;
658 struct {
659 u16 index;
660 } module_info;
719f82d3
EB		 661 struct {
662 u32 checksum;
663 u16 sequence;
664 u16 length;
665 u16 offset; /**< offset from start of msg to data */
666 u16 unused;
667 } program_flash;
3285ea10
EB		 668 struct {
669 u16 index;
670 u16 what;
671 u16 property_index;
672 } property_enum;
719f82d3
EB		 673 struct {
674 u16 property;
675 u16 parameter1;
676 u16 parameter2;
677 } property_set;
678 struct {
3285ea10
EB		 679 u32 offset;
680 } query_flash;
719f82d3 681 struct {
3285ea10
EB		 682 u32 pad32;
683 u16 key1;
684 u16 key2;
685 } restart;
719f82d3 686 struct {
3285ea10
EB		 687 u32 offset;
688 u32 length;
689 u32 key;
690 } start_flash;
691 struct {
692 u32 pad32;
693 u16 value;
694 } test_assert;
bd33c1ca
EB		 695 struct {
696 u32 yes;
697 } irq_query;
719f82d3
EB		 698};
699
700struct hpi_adapter_res {
701 u32 serial_number;
702 u16 adapter_type;
3285ea10 703 u16 adapter_index;
719f82d3
EB		 704 u16 num_instreams;
705 u16 num_outstreams;
706 u16 num_mixers;
707 u16 version;
708 u8 sz_adapter_assert[HPI_STRING_LEN];
709};
710
711union hpi_adapterx_res {
3285ea10 712 struct hpi_adapter_res info;
719f82d3 713 struct {
3285ea10
EB		 714 u32 p1;
715 u16 count;
716 u16 dsp_index;
717 u32 p2;
718 u32 dsp_msg_addr;
719 char sz_message[HPI_STRING_LEN];
720 } assert;
721 struct {
722 u32 adapter_mode;
723 } mode;
719f82d3
EB		 724 struct {
725 u16 sequence;
726 } program_flash;
727 struct {
728 u16 parameter1;
729 u16 parameter2;
730 } property_get;
3285ea10
EB		 731 struct {
732 u32 checksum;
733 u32 length;
734 u32 version;
735 } query_flash;
bd33c1ca
EB		 736 struct {
737 u32 yes;
738 } irq_query;
719f82d3
EB		 739};
740
741struct hpi_stream_msg {
742 union {
743 struct hpi_msg_data data;
744 struct hpi_data_legacy32 data32;
745 u16 velocity;
746 struct hpi_punchinout pio;
747 u32 time_scale;
748 struct hpi_buffer buffer;
749 struct hpi_streamid stream;
bd33c1ca 750 u32 threshold_bytes;
719f82d3
EB		 751 } u;
752};
753
754struct hpi_stream_res {
755 union {
756 struct {
757 /* size of hardware buffer */
758 u32 buffer_size;
759 /* OutStream - data to play,
760 InStream - data recorded */
761 u32 data_available;
762 /* OutStream - samples played,
763 InStream - samples recorded */
764 u32 samples_transferred;
765 /* Adapter - OutStream - data to play,
766 InStream - data recorded */
767 u32 auxiliary_data_available;
768 u16 state; /* HPI_STATE_PLAYING, _STATE_STOPPED */
769 u16 padding;
770 } stream_info;
771 struct {
772 u32 buffer_size;
773 u32 data_available;
774 u32 samples_transfered;
775 u16 state;
776 u16 outstream_index;
777 u16 instream_index;
778 u16 padding;
779 u32 auxiliary_data_available;
780 } legacy_stream_info;
781 struct {
782 /* bitmap of grouped OutStreams */
783 u32 outstream_group_map;
784 /* bitmap of grouped InStreams */
785 u32 instream_group_map;
786 } group_info;
787 struct {
788 /* pointer to the buffer */
789 u8 *p_buffer;
790 /* pointer to the hostbuffer status */
791 struct hpi_hostbuffer_status *p_status;
792 } hostbuffer_info;
793 } u;
794};
795
796struct hpi_mixer_msg {
797 u16 control_index;
798 u16 control_type; /* = HPI_CONTROL_METER _VOLUME etc */
3285ea10 799 u16 padding1; /* Maintain alignment of subsequent fields */
719f82d3
EB		 800 u16 node_type1; /* = HPI_SOURCENODE_LINEIN etc */
801 u16 node_index1; /* = 0..N */
802 u16 node_type2;
803 u16 node_index2;
804 u16 padding2; /* round to 4 bytes */
805};
806
807struct hpi_mixer_res {
808 u16 src_node_type; /* = HPI_SOURCENODE_LINEIN etc */
809 u16 src_node_index; /* = 0..N */
810 u16 dst_node_type;
811 u16 dst_node_index;
812 /* Also controlType for MixerGetControlByIndex */
813 u16 control_index;
814 /* may indicate which DSP the control is located on */
815 u16 dsp_index;
816};
817
818union hpi_mixerx_msg {
819 struct {
820 u16 starting_index;
821 u16 flags;
822 u32 length_in_bytes; /* length in bytes of p_data */
823 u32 p_data; /* pointer to a data array */
824 } gcabi;
825 struct {
826 u16 command;
827 u16 index;
828 } store; /* for HPI_MIXER_STORE message */
829};
830
831union hpi_mixerx_res {
832 struct {
833 u32 bytes_returned; /* size of items returned */
834 u32 p_data; /* pointer to data array */
835 u16 more_to_do; /* indicates if there is more to do */
836 } gcabi;
bd33c1ca
EB		 837 struct {
838 u32 total_controls; /* count of controls in the mixer */
839 u32 cache_controls; /* count of controls in the cac */
840 u32 cache_bytes; /* size of cache */
841 } cache_info;
719f82d3
EB		 842};
843
844struct hpi_control_msg {
845 u16 attribute; /* control attribute or property */
846 u16 saved_index;
847 u32 param1; /* generic parameter 1 */
848 u32 param2; /* generic parameter 2 */
849 short an_log_value[HPI_MAX_CHANNELS];
850};
851
852struct hpi_control_union_msg {
853 u16 attribute; /* control attribute or property */
854 u16 saved_index; /* only used in ctrl save/restore */
855 union {
856 struct {
857 u32 param1; /* generic parameter 1 */
858 u32 param2; /* generic parameter 2 */
859 short an_log_value[HPI_MAX_CHANNELS];
860 } old;
861 union {
862 u32 frequency;
863 u32 gain;
864 u32 band;
865 u32 deemphasis;
866 u32 program;
867 struct {
868 u32 mode;
869 u32 value;
870 } mode;
5a498ef1 871 u32 blend;
719f82d3
EB		 872 } tuner;
873 } u;
874};
875
876struct hpi_control_res {
877 /* Could make union. dwParam, anLogValue never used in same response */
878 u32 param1;
879 u32 param2;
880 short an_log_value[HPI_MAX_CHANNELS];
881};
882
883union hpi_control_union_res {
884 struct {
885 u32 param1;
886 u32 param2;
887 short an_log_value[HPI_MAX_CHANNELS];
888 } old;
889 union {
890 u32 band;
891 u32 frequency;
892 u32 gain;
719f82d3
EB		 893 u32 deemphasis;
894 struct {
895 u32 data[2];
896 u32 bLER;
897 } rds;
3285ea10
EB		 898 short s_level;
899 struct {
900 u16 value;
901 u16 mask;
902 } status;
719f82d3
EB		 903 } tuner;
904 struct {
905 char sz_data[8];
906 u32 remaining_chars;
907 } chars8;
908 char c_data12[12];
719f82d3 909 union {
58fbf77f
EB		 910 struct {
911 u32 status;
912 u32 readable_size;
913 u32 writeable_size;
914 } status;
915 } cobranet;
719f82d3
EB		 916};
917
918struct hpi_nvmemory_msg {
919 u16 address;
920 u16 data;
921};
922
923struct hpi_nvmemory_res {
924 u16 size_in_bytes;
925 u16 data;
926};
927
928struct hpi_gpio_msg {
929 u16 bit_index;
930 u16 bit_data;
931};
932
933struct hpi_gpio_res {
934 u16 number_input_bits;
935 u16 number_output_bits;
936 u16 bit_data[4];
937};
938
939struct hpi_async_msg {
940 u32 events;
941 u16 maximum_events;
942 u16 padding;
943};
944
945struct hpi_async_res {
946 union {
947 struct {
948 u16 count;
949 } count;
950 struct {
951 u32 events;
952 u16 number_returned;
953 u16 padding;
954 } get;
955 struct hpi_async_event event;
956 } u;
957};
958
959struct hpi_watchdog_msg {
960 u32 time_ms;
961};
962
963struct hpi_watchdog_res {
964 u32 time_ms;
965};
966
967struct hpi_clock_msg {
968 u16 hours;
969 u16 minutes;
970 u16 seconds;
971 u16 milli_seconds;
972};
973
974struct hpi_clock_res {
975 u16 size_in_bytes;
976 u16 hours;
977 u16 minutes;
978 u16 seconds;
979 u16 milli_seconds;
980 u16 padding;
981};
982
983struct hpi_profile_msg {
984 u16 bin_index;
985 u16 padding;
986};
987
988struct hpi_profile_res_open {
989 u16 max_profiles;
990};
991
992struct hpi_profile_res_time {
3285ea10 993 u32 total_tick_count;
719f82d3 994 u32 call_count;
3285ea10
EB		 995 u32 max_tick_count;
996 u32 ticks_per_millisecond;
997 u16 profile_interval;
719f82d3
EB		 998};
999
1000struct hpi_profile_res_name {
1001 u8 sz_name[32];
1002};
1003
1004struct hpi_profile_res {
1005 union {
1006 struct hpi_profile_res_open o;
1007 struct hpi_profile_res_time t;
1008 struct hpi_profile_res_name n;
1009 } u;
1010};
1011
1012struct hpi_message_header {
1013 u16 size; /* total size in bytes */
1014 u8 type; /* HPI_TYPE_MESSAGE */
1015 u8 version; /* message version */
1016 u16 object; /* HPI_OBJ_* */
1017 u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1018 u16 adapter_index; /* the adapter index */
1019 u16 obj_index; /* */
1020};
1021
1022struct hpi_message {
1023 /* following fields must match HPI_MESSAGE_HEADER */
1024 u16 size; /* total size in bytes */
1025 u8 type; /* HPI_TYPE_MESSAGE */
1026 u8 version; /* message version */
1027 u16 object; /* HPI_OBJ_* */
1028 u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1029 u16 adapter_index; /* the adapter index */
1030 u16 obj_index; /* */
1031 union {
1032 struct hpi_subsys_msg s;
719f82d3
EB		 1033 union hpi_adapterx_msg ax;
1034 struct hpi_stream_msg d;
1035 struct hpi_mixer_msg m;
1036 union hpi_mixerx_msg mx; /* extended mixer; */
1037 struct hpi_control_msg c; /* mixer control; */
1038 /* identical to struct hpi_control_msg,
1039 but field naming is improved */
1040 struct hpi_control_union_msg cu;
719f82d3
EB		 1041 struct hpi_nvmemory_msg n;
1042 struct hpi_gpio_msg l; /* digital i/o */
1043 struct hpi_watchdog_msg w;
1044 struct hpi_clock_msg t; /* dsp time */
1045 struct hpi_profile_msg p;
1046 struct hpi_async_msg as;
1047 char fixed_size[32];
1048 } u;
1049};
1050
1051#define HPI_MESSAGE_SIZE_BY_OBJECT { \
3285ea10 1052 sizeof(struct hpi_message_header) , /* Default, no object type 0 */ \
719f82d3
EB		 1053 sizeof(struct hpi_message_header) + sizeof(struct hpi_subsys_msg),\
1054 sizeof(struct hpi_message_header) + sizeof(union hpi_adapterx_msg),\
1055 sizeof(struct hpi_message_header) + sizeof(struct hpi_stream_msg),\
1056 sizeof(struct hpi_message_header) + sizeof(struct hpi_stream_msg),\
1057 sizeof(struct hpi_message_header) + sizeof(struct hpi_mixer_msg),\
1058 sizeof(struct hpi_message_header) , /* no node message */ \
1059 sizeof(struct hpi_message_header) + sizeof(struct hpi_control_msg),\
1060 sizeof(struct hpi_message_header) + sizeof(struct hpi_nvmemory_msg),\
1061 sizeof(struct hpi_message_header) + sizeof(struct hpi_gpio_msg),\
1062 sizeof(struct hpi_message_header) + sizeof(struct hpi_watchdog_msg),\
1063 sizeof(struct hpi_message_header) + sizeof(struct hpi_clock_msg),\
1064 sizeof(struct hpi_message_header) + sizeof(struct hpi_profile_msg),\
58fbf77f 1065 sizeof(struct hpi_message_header), /* controlx obj removed */ \
719f82d3
EB		 1066 sizeof(struct hpi_message_header) + sizeof(struct hpi_async_msg) \
1067}
1068
1d595d2a
EB		 1069/*
1070Note that the wSpecificError error field should be inspected and potentially
1071reported whenever HPI_ERROR_DSP_COMMUNICATION or HPI_ERROR_DSP_BOOTLOAD is
1072returned in wError.
1073*/
719f82d3
EB		 1074struct hpi_response_header {
1075 u16 size;
1076 u8 type; /* HPI_TYPE_RESPONSE */
1077 u8 version; /* response version */
1078 u16 object; /* HPI_OBJ_* */
1079 u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1080 u16 error; /* HPI_ERROR_xxx */
1081 u16 specific_error; /* adapter specific error */
1082};
1083
1084struct hpi_response {
1085/* following fields must match HPI_RESPONSE_HEADER */
1086 u16 size;
1087 u8 type; /* HPI_TYPE_RESPONSE */
1088 u8 version; /* response version */
1089 u16 object; /* HPI_OBJ_* */
1090 u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
1091 u16 error; /* HPI_ERROR_xxx */
1092 u16 specific_error; /* adapter specific error */
1093 union {
1094 struct hpi_subsys_res s;
719f82d3
EB		 1095 union hpi_adapterx_res ax;
1096 struct hpi_stream_res d;
1097 struct hpi_mixer_res m;
1098 union hpi_mixerx_res mx; /* extended mixer; */
1099 struct hpi_control_res c; /* mixer control; */
1100 /* identical to hpi_control_res, but field naming is improved */
1101 union hpi_control_union_res cu;
719f82d3
EB		 1102 struct hpi_nvmemory_res n;
1103 struct hpi_gpio_res l; /* digital i/o */
1104 struct hpi_watchdog_res w;
1105 struct hpi_clock_res t; /* dsp time */
1106 struct hpi_profile_res p;
1107 struct hpi_async_res as;
1108 u8 bytes[52];
1109 } u;
1110};
1111
1112#define HPI_RESPONSE_SIZE_BY_OBJECT { \
3285ea10 1113 sizeof(struct hpi_response_header) ,/* Default, no object type 0 */ \
719f82d3
EB		 1114 sizeof(struct hpi_response_header) + sizeof(struct hpi_subsys_res),\
1115 sizeof(struct hpi_response_header) + sizeof(union hpi_adapterx_res),\
1116 sizeof(struct hpi_response_header) + sizeof(struct hpi_stream_res),\
1117 sizeof(struct hpi_response_header) + sizeof(struct hpi_stream_res),\
1118 sizeof(struct hpi_response_header) + sizeof(struct hpi_mixer_res),\
1119 sizeof(struct hpi_response_header) , /* no node response */ \
1120 sizeof(struct hpi_response_header) + sizeof(struct hpi_control_res),\
1121 sizeof(struct hpi_response_header) + sizeof(struct hpi_nvmemory_res),\
1122 sizeof(struct hpi_response_header) + sizeof(struct hpi_gpio_res),\
1123 sizeof(struct hpi_response_header) + sizeof(struct hpi_watchdog_res),\
1124 sizeof(struct hpi_response_header) + sizeof(struct hpi_clock_res),\
1125 sizeof(struct hpi_response_header) + sizeof(struct hpi_profile_res),\
58fbf77f 1126 sizeof(struct hpi_response_header), /* controlx obj removed */ \
719f82d3
EB		 1127 sizeof(struct hpi_response_header) + sizeof(struct hpi_async_res) \
1128}
1129
ba94455c 1130/*********************** version 1 message/response **************************/
719f82d3
EB		 1131#define HPINET_ETHERNET_DATA_SIZE (1500)
1132#define HPINET_IP_HDR_SIZE (20)
1133#define HPINET_IP_DATA_SIZE (HPINET_ETHERNET_DATA_SIZE - HPINET_IP_HDR_SIZE)
1134#define HPINET_UDP_HDR_SIZE (8)
1135#define HPINET_UDP_DATA_SIZE (HPINET_IP_DATA_SIZE - HPINET_UDP_HDR_SIZE)
1136#define HPINET_ASI_HDR_SIZE (2)
1137#define HPINET_ASI_DATA_SIZE (HPINET_UDP_DATA_SIZE - HPINET_ASI_HDR_SIZE)
1138
1139#define HPI_MAX_PAYLOAD_SIZE (HPINET_ASI_DATA_SIZE - 2)
1140
1141/* New style message/response, but still V0 compatible */
1142struct hpi_msg_adapter_get_info {
1143 struct hpi_message_header h;
1144};
1145
1146struct hpi_res_adapter_get_info {
1147 struct hpi_response_header h; /*v0 */
1148 struct hpi_adapter_res p;
1149};
1150
1151/* padding is so these are same size as v0 hpi_message */
1152struct hpi_msg_adapter_query_flash {
1153 struct hpi_message_header h;
1154 u32 offset;
1155 u8 pad_to_version0_size[sizeof(struct hpi_message) - /* V0 res */
1156 sizeof(struct hpi_message_header) - 1 * sizeof(u32)];
1157};
1158
1159/* padding is so these are same size as v0 hpi_response */
1160struct hpi_res_adapter_query_flash {
1161 struct hpi_response_header h;
1162 u32 checksum;
1163 u32 length;
1164 u32 version;
1165 u8 pad_to_version0_size[sizeof(struct hpi_response) - /* V0 res */
1166 sizeof(struct hpi_response_header) - 3 * sizeof(u32)];
1167};
1168
1169struct hpi_msg_adapter_start_flash {
1170 struct hpi_message_header h;
1171 u32 offset;
1172 u32 length;
1173 u32 key;
1174 u8 pad_to_version0_size[sizeof(struct hpi_message) - /* V0 res */
1175 sizeof(struct hpi_message_header) - 3 * sizeof(u32)];
1176};
1177
1178struct hpi_res_adapter_start_flash {
1179 struct hpi_response_header h;
1180 u8 pad_to_version0_size[sizeof(struct hpi_response) - /* V0 res */
1181 sizeof(struct hpi_response_header)];
1182};
1183
1184struct hpi_msg_adapter_program_flash_payload {
1185 u32 checksum;
1186 u16 sequence;
1187 u16 length;
1188 u16 offset; /**< offset from start of msg to data */
1189 u16 unused;
1190 /* ensure sizeof(header + payload) == sizeof(hpi_message_V0)
1191 because old firmware expects data after message of this size */
1192 u8 pad_to_version0_size[sizeof(struct hpi_message) - /* V0 message */
1193 sizeof(struct hpi_message_header) - sizeof(u32) -
1194 4 * sizeof(u16)];
1195};
1196
1197struct hpi_msg_adapter_program_flash {
1198 struct hpi_message_header h;
1199 struct hpi_msg_adapter_program_flash_payload p;
1200 u32 data[256];
1201};
1202
1203struct hpi_res_adapter_program_flash {
1204 struct hpi_response_header h;
1205 u16 sequence;
1206 u8 pad_to_version0_size[sizeof(struct hpi_response) - /* V0 res */
1207 sizeof(struct hpi_response_header) - sizeof(u16)];
1208};
1209
3285ea10
EB		 1210struct hpi_msg_adapter_debug_read {
1211 struct hpi_message_header h;
1212 u32 dsp_address;
1213 u32 count_bytes;
1214};
1215
1216struct hpi_res_adapter_debug_read {
1217 struct hpi_response_header h;
1218 u8 bytes[256];
1219};
1220
58fbf77f
EB		 1221struct hpi_msg_cobranet_hmi {
1222 u16 attribute;
1223 u16 padding;
1224 u32 hmi_address;
1225 u32 byte_count;
1226};
1227
1228struct hpi_msg_cobranet_hmiwrite {
1229 struct hpi_message_header h;
1230 struct hpi_msg_cobranet_hmi p;
1231 u8 bytes[256];
1232};
1233
1234struct hpi_msg_cobranet_hmiread {
1235 struct hpi_message_header h;
1236 struct hpi_msg_cobranet_hmi p;
1237};
1238
1239struct hpi_res_cobranet_hmiread {
1240 struct hpi_response_header h;
1241 u32 byte_count;
1242 u8 bytes[256];
1243};
1244
719f82d3
EB		 1245#if 1
1246#define hpi_message_header_v1 hpi_message_header
1247#define hpi_response_header_v1 hpi_response_header
1248#else
1249/* V1 headers in Addition to v0 headers */
1250struct hpi_message_header_v1 {
1251 struct hpi_message_header h0;
1252/* struct {
1253} h1; */
1254};
1255
1256struct hpi_response_header_v1 {
1257 struct hpi_response_header h0;
1258 struct {
1259 u16 adapter_index; /* the adapter index */
1260 u16 obj_index; /* object index */
1261 } h1;
1262};
1263#endif
1264
719f82d3
EB		 1265struct hpi_msg_payload_v0 {
1266 struct hpi_message_header h;
1267 union {
1268 struct hpi_subsys_msg s;
719f82d3
EB		 1269 union hpi_adapterx_msg ax;
1270 struct hpi_stream_msg d;
1271 struct hpi_mixer_msg m;
1272 union hpi_mixerx_msg mx;
1273 struct hpi_control_msg c;
1274 struct hpi_control_union_msg cu;
719f82d3
EB		 1275 struct hpi_nvmemory_msg n;
1276 struct hpi_gpio_msg l;
1277 struct hpi_watchdog_msg w;
1278 struct hpi_clock_msg t;
1279 struct hpi_profile_msg p;
1280 struct hpi_async_msg as;
1281 } u;
1282};
1283
1284struct hpi_res_payload_v0 {
1285 struct hpi_response_header h;
1286 union {
1287 struct hpi_subsys_res s;
719f82d3
EB		 1288 union hpi_adapterx_res ax;
1289 struct hpi_stream_res d;
1290 struct hpi_mixer_res m;
1291 union hpi_mixerx_res mx;
1292 struct hpi_control_res c;
1293 union hpi_control_union_res cu;
719f82d3
EB		 1294 struct hpi_nvmemory_res n;
1295 struct hpi_gpio_res l;
1296 struct hpi_watchdog_res w;
1297 struct hpi_clock_res t;
1298 struct hpi_profile_res p;
1299 struct hpi_async_res as;
1300 } u;
1301};
1302
1303union hpi_message_buffer_v1 {
1304 struct hpi_message m0; /* version 0 */
1305 struct hpi_message_header_v1 h;
3285ea10 1306 u8 buf[HPI_MAX_PAYLOAD_SIZE];
719f82d3
EB		 1307};
1308
1309union hpi_response_buffer_v1 {
1310 struct hpi_response r0; /* version 0 */
1311 struct hpi_response_header_v1 h;
3285ea10 1312 u8 buf[HPI_MAX_PAYLOAD_SIZE];
719f82d3
EB		 1313};
1314
1315compile_time_assert((sizeof(union hpi_message_buffer_v1) <=
1316 HPI_MAX_PAYLOAD_SIZE), message_buffer_ok);
1317compile_time_assert((sizeof(union hpi_response_buffer_v1) <=
1318 HPI_MAX_PAYLOAD_SIZE), response_buffer_ok);
1319
1320/*////////////////////////////////////////////////////////////////////////// */
1321/* declarations for compact control calls */
1322struct hpi_control_defn {
1323 u8 type;
1324 u8 channels;
1325 u8 src_node_type;
1326 u8 src_node_index;
1327 u8 dest_node_type;
1328 u8 dest_node_index;
1329};
1330
1331/*////////////////////////////////////////////////////////////////////////// */
1332/* declarations for control caching (internal to HPI<->DSP interaction) */
1333
3285ea10
EB		 1334/** indicates a cached u16 value is invalid. */
1335#define HPI_CACHE_INVALID_UINT16 0xFFFF
1336/** indicates a cached short value is invalid. */
1337#define HPI_CACHE_INVALID_SHORT -32768
1338
719f82d3
EB		 1339/** A compact representation of (part of) a controls state.
1340Used for efficient transfer of the control state
1341between DSP and host or across a network
1342*/
1343struct hpi_control_cache_info {
1344 /** one of HPI_CONTROL_* */
1345 u8 control_type;
1346 /** The total size of cached information in 32-bit words. */
1347 u8 size_in32bit_words;
1348 /** The original index of the control on the DSP */
1349 u16 control_index;
1350};
1351
3285ea10
EB		 1352struct hpi_control_cache_vol {
1353 struct hpi_control_cache_info i;
1354 short an_log[2];
fc3a3990
EB		 1355 unsigned short flags;
1356 char padding[2];
3285ea10
EB		 1357};
1358
1359struct hpi_control_cache_meter {
1360 struct hpi_control_cache_info i;
1361 short an_log_peak[2];
1362 short an_logRMS[2];
1363};
1364
1365struct hpi_control_cache_channelmode {
1366 struct hpi_control_cache_info i;
1367 u16 mode;
1368 char temp_padding[6];
1369};
1370
1371struct hpi_control_cache_mux {
1372 struct hpi_control_cache_info i;
1373 u16 source_node_type;
1374 u16 source_node_index;
1375 char temp_padding[4];
1376};
1377
1378struct hpi_control_cache_level {
1379 struct hpi_control_cache_info i;
1380 short an_log[2];
1381 char temp_padding[4];
1382};
1383
1384struct hpi_control_cache_tuner {
1385 struct hpi_control_cache_info i;
1386 u32 freq_ink_hz;
1387 u16 band;
1388 short s_level_avg;
1389};
1390
1391struct hpi_control_cache_aes3rx {
1392 struct hpi_control_cache_info i;
1393 u32 error_status;
1394 u32 format;
1395};
1396
1397struct hpi_control_cache_aes3tx {
1398 struct hpi_control_cache_info i;
1399 u32 format;
1400 char temp_padding[4];
1401};
1402
1403struct hpi_control_cache_tonedetector {
1404 struct hpi_control_cache_info i;
1405 u16 state;
1406 char temp_padding[6];
1407};
1408
1409struct hpi_control_cache_silencedetector {
1410 struct hpi_control_cache_info i;
1411 u32 state;
1412 char temp_padding[4];
1413};
1414
1415struct hpi_control_cache_sampleclock {
1416 struct hpi_control_cache_info i;
1417 u16 source;
1418 u16 source_index;
1419 u32 sample_rate;
1420};
1421
1422struct hpi_control_cache_microphone {
1423 struct hpi_control_cache_info i;
1424 u16 phantom_state;
1425 char temp_padding[6];
1426};
1427
3285ea10 1428struct hpi_control_cache_single {
719f82d3 1429 union {
3285ea10
EB		 1430 struct hpi_control_cache_info i;
1431 struct hpi_control_cache_vol vol;
1432 struct hpi_control_cache_meter meter;
1433 struct hpi_control_cache_channelmode mode;
1434 struct hpi_control_cache_mux mux;
1435 struct hpi_control_cache_level level;
1436 struct hpi_control_cache_tuner tuner;
1437 struct hpi_control_cache_aes3rx aes3rx;
1438 struct hpi_control_cache_aes3tx aes3tx;
1439 struct hpi_control_cache_tonedetector tone;
1440 struct hpi_control_cache_silencedetector silence;
1441 struct hpi_control_cache_sampleclock clk;
1442 struct hpi_control_cache_microphone microphone;
719f82d3
EB		 1443 } u;
1444};
1445
1446struct hpi_control_cache_pad {
1447 struct hpi_control_cache_info i;
1448 u32 field_valid_flags;
1449 u8 c_channel[8];
1450 u8 c_artist[40];
1451 u8 c_title[40];
1452 u8 c_comment[200];
1453 u32 pTY;
1454 u32 pI;
1455 u32 traffic_supported;
1456 u32 traffic_anouncement;
1457};
1458
ba94455c 1459/* 2^N sized FIFO buffer (internal to HPI<->DSP interaction) */
719f82d3
EB		 1460struct hpi_fifo_buffer {
1461 u32 size;
1462 u32 dSP_index;
1463 u32 host_index;
1464};
1465
1466#ifndef DISABLE_PRAGMA_PACK1
1467#pragma pack(pop)
1468#endif
1469
1470/* skip host side function declarations for DSP
1471 compile and documentation extraction */
1472
1473char hpi_handle_object(const u32 handle);
1474
1475void hpi_handle_to_indexes(const u32 handle, u16 *pw_adapter_index,
1476 u16 *pw_object_index);
1477
1478u32 hpi_indexes_to_handle(const char c_object, const u16 adapter_index,
1479 const u16 object_index);
1480
1481/*////////////////////////////////////////////////////////////////////////// */
1482
1483/* main HPI entry point */
ba94455c 1484void hpi_send_recv(struct hpi_message *phm, struct hpi_response *phr);
719f82d3 1485
719f82d3 1486/* used in PnP OS/driver */
ba94455c
EB		 1487u16 hpi_subsys_create_adapter(const struct hpi_resource *p_resource,
1488 u16 *pw_adapter_index);
719f82d3 1489
ba94455c 1490u16 hpi_outstream_host_buffer_get_info(u32 h_outstream, u8 **pp_buffer,
719f82d3
EB		 1491 struct hpi_hostbuffer_status **pp_status);
1492
ba94455c 1493u16 hpi_instream_host_buffer_get_info(u32 h_instream, u8 **pp_buffer,
719f82d3
EB		 1494 struct hpi_hostbuffer_status **pp_status);
1495
1496u16 hpi_adapter_restart(u16 adapter_index);
1497
1498/*
1499The following 3 functions were last declared in header files for
1500driver 3.10. HPI_ControlQuery() used to be the recommended way
1501of getting a volume range. Declared here for binary asihpi32.dll
1502compatibility.
1503*/
1504
1505void hpi_format_to_msg(struct hpi_msg_format *pMF,
1506 const struct hpi_format *pF);
1507void hpi_stream_response_to_legacy(struct hpi_stream_res *pSR);
1508
1509/*////////////////////////////////////////////////////////////////////////// */
1510/* declarations for individual HPI entry points */
719f82d3
EB		 1511hpi_handler_func HPI_6000;
1512hpi_handler_func HPI_6205;
719f82d3
EB		 1513
1514#endif /* _HPI_INTERNAL_H_ */
Linux kernel - Deliverables
This page took 0.196414 seconds and 5 git commands to generate.