renegade-project/linux-next
2
0
Fork 0
mirror of https://github.com/edk2-porting/linux-next.git synced 2024-12-23 20:53:53 +08:00
Code
d4620087d2
linux-next/sound/pci/asihpi/hpi_internal.h
Thomas Gleixner 07d7fe7bd6 treewide: Replace GPLv2 boilerplate/reference with SPDX - rule 273 
Based on 1 normalized pattern(s):

  this program is free software you can redistribute it and or modify
  it under the terms of version 2 of the gnu general public license as
  published by the free software foundation this program is
  distributed in the hope that it will be useful but without any
  warranty without even the implied warranty of merchantability or
  fitness for a particular purpose see the gnu general public license
  for more details you should have received a copy of the gnu general
  public license along with this program if not write to the free
  software foundation inc 59 temple place suite 330 boston ma 02111
  1307 usa

extracted by the scancode license scanner the SPDX license identifier

  GPL-2.0-only

has been chosen to replace the boilerplate/reference in 24 file(s).

Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
Reviewed-by: Richard Fontana <rfontana@redhat.com>
Reviewed-by: Alexios Zavras <alexios.zavras@intel.com>
Reviewed-by: Allison Randal <allison@lohutok.net>
Cc: linux-spdx@vger.kernel.org
Link: https://lkml.kernel.org/r/20190529141334.606756275@linutronix.de
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
2019-06-05 17:30:30 +02:00

1425 lines
41 KiB
C
Raw Blame History

/* SPDX-License-Identifier: GPL-2.0-only */
/******************************************************************************
AudioScience HPI driver
Copyright (C) 1997-2012 AudioScience Inc. <support@audioscience.com>
HPI internal definitions
(C) Copyright AudioScience Inc. 1996-2009
******************************************************************************/
#ifndef _HPI_INTERNAL_H_
#define _HPI_INTERNAL_H_
#include "hpi.h"
/** maximum number of memory regions mapped to an adapter */
#define HPI_MAX_ADAPTER_MEM_SPACES (2)
/* Each OS needs its own hpios.h */
#include "hpios.h"
/* physical memory allocation */
/** Allocate and map an area of locked memory for bus master DMA operations.
On success, *pLockedMemeHandle is a valid handle, and 0 is returned
On error *pLockedMemHandle marked invalid, non-zero returned.
If this function succeeds, then HpiOs_LockedMem_GetVirtAddr() and
HpiOs_LockedMem_GetPyhsAddr() will always succed on the returned handle.
*/
u16 hpios_locked_mem_alloc(struct consistent_dma_area *p_locked_mem_handle,
/**< memory handle */
u32 size, /**< Size in bytes to allocate */
struct pci_dev *p_os_reference
/**< OS specific data required for memory allocation */
);
/** Free mapping and memory represented by LockedMemHandle
Frees any resources, then invalidates the handle.
Returns 0 on success, 1 if handle is invalid.
*/
u16 hpios_locked_mem_free(struct consistent_dma_area *locked_mem_handle);
/** Get the physical PCI address of memory represented by LockedMemHandle.
If handle is invalid *pPhysicalAddr is set to zero and return 1
*/
u16 hpios_locked_mem_get_phys_addr(struct consistent_dma_area
*locked_mem_handle, u32 *p_physical_addr);
/** Get the CPU address of of memory represented by LockedMemHandle.
If handle is NULL *ppvVirtualAddr is set to NULL and return 1
*/
u16 hpios_locked_mem_get_virt_addr(struct consistent_dma_area
*locked_mem_handle, void **ppv_virtual_addr);
/** Check that handle is valid
i.e it represents a valid memory area
*/
u16 hpios_locked_mem_valid(struct consistent_dma_area *locked_mem_handle);
/* timing/delay */
void hpios_delay_micro_seconds(u32 num_micro_sec);
struct hpi_message;
struct hpi_response;
typedef void hpi_handler_func(struct hpi_message *, struct hpi_response *);
/* If the assert fails, compiler complains
something like size of array `msg' is negative.
Unlike linux BUILD_BUG_ON, this works outside function scope.
*/
#define compile_time_assert(cond, msg) \
typedef char ASSERT_##msg[(cond) ? 1 : -1]
/******************************************* bus types */
enum HPI_BUSES {
HPI_BUS_ISAPNP = 1,
HPI_BUS_PCI = 2,
HPI_BUS_USB = 3,
HPI_BUS_NET = 4
};
enum HPI_SUBSYS_OPTIONS {
/* 0, 256 are invalid, 1..255 reserved for global options */
HPI_SUBSYS_OPT_NET_ENABLE = 257,
HPI_SUBSYS_OPT_NET_BROADCAST = 258,
HPI_SUBSYS_OPT_NET_UNICAST = 259,
HPI_SUBSYS_OPT_NET_ADDR = 260,
HPI_SUBSYS_OPT_NET_MASK = 261,
HPI_SUBSYS_OPT_NET_ADAPTER_ADDRESS_ADD = 262
};
/** Volume flags
*/
enum HPI_VOLUME_FLAGS {
/** Set if the volume control is muted */
HPI_VOLUME_FLAG_MUTED = (1 << 0),
/** Set if the volume control has a mute function */
HPI_VOLUME_FLAG_HAS_MUTE = (1 << 1),
/** Set if volume control can do autofading */
HPI_VOLUME_FLAG_HAS_AUTOFADE = (1 << 2)
/* Note Flags >= (1<<8) are for DSP internal use only */
};
/******************************************* CONTROL ATTRIBUTES ****/
/* (in order of control type ID */
/* This allows for 255 control types, 256 unique attributes each */
#define HPI_CTL_ATTR(ctl, ai) ((HPI_CONTROL_##ctl << 8) + ai)
/* Get the sub-index of the attribute for a control type */
#define HPI_CTL_ATTR_INDEX(i) (i & 0xff)
/* Extract the control from the control attribute */
#define HPI_CTL_ATTR_CONTROL(i) (i >> 8)
/** Enable event generation for a control.
0=disable, 1=enable
\note generic to all controls that can generate events
*/
/** Unique identifiers for every control attribute
*/
enum HPI_CONTROL_ATTRIBUTES {
HPI_GENERIC_ENABLE = HPI_CTL_ATTR(GENERIC, 1),
HPI_GENERIC_EVENT_ENABLE = HPI_CTL_ATTR(GENERIC, 2),
HPI_VOLUME_GAIN = HPI_CTL_ATTR(VOLUME, 1),
HPI_VOLUME_AUTOFADE = HPI_CTL_ATTR(VOLUME, 2),
HPI_VOLUME_MUTE = HPI_CTL_ATTR(VOLUME, 3),
HPI_VOLUME_GAIN_AND_FLAGS = HPI_CTL_ATTR(VOLUME, 4),
HPI_VOLUME_NUM_CHANNELS = HPI_CTL_ATTR(VOLUME, 6),
HPI_VOLUME_RANGE = HPI_CTL_ATTR(VOLUME, 10),
HPI_METER_RMS = HPI_CTL_ATTR(METER, 1),
HPI_METER_PEAK = HPI_CTL_ATTR(METER, 2),
HPI_METER_RMS_BALLISTICS = HPI_CTL_ATTR(METER, 3),
HPI_METER_PEAK_BALLISTICS = HPI_CTL_ATTR(METER, 4),
HPI_METER_NUM_CHANNELS = HPI_CTL_ATTR(METER, 5),
HPI_MULTIPLEXER_SOURCE = HPI_CTL_ATTR(MULTIPLEXER, 1),
HPI_MULTIPLEXER_QUERYSOURCE = HPI_CTL_ATTR(MULTIPLEXER, 2),
HPI_AESEBUTX_FORMAT = HPI_CTL_ATTR(AESEBUTX, 1),
HPI_AESEBUTX_SAMPLERATE = HPI_CTL_ATTR(AESEBUTX, 3),
HPI_AESEBUTX_CHANNELSTATUS = HPI_CTL_ATTR(AESEBUTX, 4),
HPI_AESEBUTX_USERDATA = HPI_CTL_ATTR(AESEBUTX, 5),
HPI_AESEBURX_FORMAT = HPI_CTL_ATTR(AESEBURX, 1),
HPI_AESEBURX_ERRORSTATUS = HPI_CTL_ATTR(AESEBURX, 2),
HPI_AESEBURX_SAMPLERATE = HPI_CTL_ATTR(AESEBURX, 3),
HPI_AESEBURX_CHANNELSTATUS = HPI_CTL_ATTR(AESEBURX, 4),
HPI_AESEBURX_USERDATA = HPI_CTL_ATTR(AESEBURX, 5),
HPI_LEVEL_GAIN = HPI_CTL_ATTR(LEVEL, 1),
HPI_LEVEL_RANGE = HPI_CTL_ATTR(LEVEL, 10),
HPI_TUNER_BAND = HPI_CTL_ATTR(TUNER, 1),
HPI_TUNER_FREQ = HPI_CTL_ATTR(TUNER, 2),
HPI_TUNER_LEVEL_AVG = HPI_CTL_ATTR(TUNER, 3),
HPI_TUNER_LEVEL_RAW = HPI_CTL_ATTR(TUNER, 4),
HPI_TUNER_SNR = HPI_CTL_ATTR(TUNER, 5),
HPI_TUNER_GAIN = HPI_CTL_ATTR(TUNER, 6),
HPI_TUNER_STATUS = HPI_CTL_ATTR(TUNER, 7),
HPI_TUNER_MODE = HPI_CTL_ATTR(TUNER, 8),
HPI_TUNER_RDS = HPI_CTL_ATTR(TUNER, 9),
HPI_TUNER_DEEMPHASIS = HPI_CTL_ATTR(TUNER, 10),
HPI_TUNER_PROGRAM = HPI_CTL_ATTR(TUNER, 11),
HPI_TUNER_HDRADIO_SIGNAL_QUALITY = HPI_CTL_ATTR(TUNER, 12),
HPI_TUNER_HDRADIO_SDK_VERSION = HPI_CTL_ATTR(TUNER, 13),
HPI_TUNER_HDRADIO_DSP_VERSION = HPI_CTL_ATTR(TUNER, 14),
HPI_TUNER_HDRADIO_BLEND = HPI_CTL_ATTR(TUNER, 15),
HPI_VOX_THRESHOLD = HPI_CTL_ATTR(VOX, 1),
HPI_CHANNEL_MODE_MODE = HPI_CTL_ATTR(CHANNEL_MODE, 1),
HPI_BITSTREAM_DATA_POLARITY = HPI_CTL_ATTR(BITSTREAM, 1),
HPI_BITSTREAM_CLOCK_EDGE = HPI_CTL_ATTR(BITSTREAM, 2),
HPI_BITSTREAM_CLOCK_SOURCE = HPI_CTL_ATTR(BITSTREAM, 3),
HPI_BITSTREAM_ACTIVITY = HPI_CTL_ATTR(BITSTREAM, 4),
HPI_SAMPLECLOCK_SOURCE = HPI_CTL_ATTR(SAMPLECLOCK, 1),
HPI_SAMPLECLOCK_SAMPLERATE = HPI_CTL_ATTR(SAMPLECLOCK, 2),
HPI_SAMPLECLOCK_SOURCE_INDEX = HPI_CTL_ATTR(SAMPLECLOCK, 3),
HPI_SAMPLECLOCK_LOCAL_SAMPLERATE = HPI_CTL_ATTR(SAMPLECLOCK, 4),
HPI_SAMPLECLOCK_AUTO = HPI_CTL_ATTR(SAMPLECLOCK, 5),
HPI_SAMPLECLOCK_LOCAL_LOCK = HPI_CTL_ATTR(SAMPLECLOCK, 6),
HPI_MICROPHONE_PHANTOM_POWER = HPI_CTL_ATTR(MICROPHONE, 1),
HPI_EQUALIZER_NUM_FILTERS = HPI_CTL_ATTR(EQUALIZER, 1),
HPI_EQUALIZER_FILTER = HPI_CTL_ATTR(EQUALIZER, 2),
HPI_EQUALIZER_COEFFICIENTS = HPI_CTL_ATTR(EQUALIZER, 3),
HPI_COMPANDER_PARAMS = HPI_CTL_ATTR(COMPANDER, 1),
HPI_COMPANDER_MAKEUPGAIN = HPI_CTL_ATTR(COMPANDER, 2),
HPI_COMPANDER_THRESHOLD = HPI_CTL_ATTR(COMPANDER, 3),
HPI_COMPANDER_RATIO = HPI_CTL_ATTR(COMPANDER, 4),
HPI_COMPANDER_ATTACK = HPI_CTL_ATTR(COMPANDER, 5),
HPI_COMPANDER_DECAY = HPI_CTL_ATTR(COMPANDER, 6),
HPI_COBRANET_SET = HPI_CTL_ATTR(COBRANET, 1),
HPI_COBRANET_GET = HPI_CTL_ATTR(COBRANET, 2),
HPI_COBRANET_GET_STATUS = HPI_CTL_ATTR(COBRANET, 5),
HPI_COBRANET_SEND_PACKET = HPI_CTL_ATTR(COBRANET, 6),
HPI_COBRANET_GET_PACKET = HPI_CTL_ATTR(COBRANET, 7),
HPI_TONEDETECTOR_THRESHOLD = HPI_CTL_ATTR(TONEDETECTOR, 1),
HPI_TONEDETECTOR_STATE = HPI_CTL_ATTR(TONEDETECTOR, 2),
HPI_TONEDETECTOR_FREQUENCY = HPI_CTL_ATTR(TONEDETECTOR, 3),
HPI_SILENCEDETECTOR_THRESHOLD = HPI_CTL_ATTR(SILENCEDETECTOR, 1),
HPI_SILENCEDETECTOR_STATE = HPI_CTL_ATTR(SILENCEDETECTOR, 2),
HPI_SILENCEDETECTOR_DELAY = HPI_CTL_ATTR(SILENCEDETECTOR, 3),
HPI_PAD_CHANNEL_NAME = HPI_CTL_ATTR(PAD, 1),
HPI_PAD_ARTIST = HPI_CTL_ATTR(PAD, 2),
HPI_PAD_TITLE = HPI_CTL_ATTR(PAD, 3),
HPI_PAD_COMMENT = HPI_CTL_ATTR(PAD, 4),
HPI_PAD_PROGRAM_TYPE = HPI_CTL_ATTR(PAD, 5),
HPI_PAD_PROGRAM_ID = HPI_CTL_ATTR(PAD, 6),
HPI_PAD_TA_SUPPORT = HPI_CTL_ATTR(PAD, 7),
HPI_PAD_TA_ACTIVE = HPI_CTL_ATTR(PAD, 8),
HPI_UNIVERSAL_ENTITY = HPI_CTL_ATTR(UNIVERSAL, 1)
};
#define HPI_POLARITY_POSITIVE 0
#define HPI_POLARITY_NEGATIVE 1
/*------------------------------------------------------------
Cobranet Chip Bridge - copied from HMI.H
------------------------------------------------------------*/
#define HPI_COBRANET_HMI_cobra_bridge 0x20000
#define HPI_COBRANET_HMI_cobra_bridge_tx_pkt_buf \
(HPI_COBRANET_HMI_cobra_bridge + 0x1000)
#define HPI_COBRANET_HMI_cobra_bridge_rx_pkt_buf \
(HPI_COBRANET_HMI_cobra_bridge + 0x2000)
#define HPI_COBRANET_HMI_cobra_if_table1 0x110000
#define HPI_COBRANET_HMI_cobra_if_phy_address \
(HPI_COBRANET_HMI_cobra_if_table1 + 0xd)
#define HPI_COBRANET_HMI_cobra_protocolIP 0x72000
#define HPI_COBRANET_HMI_cobra_ip_mon_currentIP \
(HPI_COBRANET_HMI_cobra_protocolIP + 0x0)
#define HPI_COBRANET_HMI_cobra_ip_mon_staticIP \
(HPI_COBRANET_HMI_cobra_protocolIP + 0x2)
#define HPI_COBRANET_HMI_cobra_sys 0x100000
#define HPI_COBRANET_HMI_cobra_sys_desc \
(HPI_COBRANET_HMI_cobra_sys + 0x0)
#define HPI_COBRANET_HMI_cobra_sys_objectID \
(HPI_COBRANET_HMI_cobra_sys + 0x100)
#define HPI_COBRANET_HMI_cobra_sys_contact \
(HPI_COBRANET_HMI_cobra_sys + 0x200)
#define HPI_COBRANET_HMI_cobra_sys_name \
(HPI_COBRANET_HMI_cobra_sys + 0x300)
#define HPI_COBRANET_HMI_cobra_sys_location \
(HPI_COBRANET_HMI_cobra_sys + 0x400)
/*------------------------------------------------------------
Cobranet Chip Status bits
------------------------------------------------------------*/
#define HPI_COBRANET_HMI_STATUS_RXPACKET 2
#define HPI_COBRANET_HMI_STATUS_TXPACKET 3
/*------------------------------------------------------------
Ethernet header size
------------------------------------------------------------*/
#define HPI_ETHERNET_HEADER_SIZE (16)
/* These defines are used to fill in protocol information for an Ethernet packet
sent using HMI on CS18102 */
/** ID supplied by Cirrus for ASI packets. */
#define HPI_ETHERNET_PACKET_ID 0x85
/** Simple packet - no special routing required */
#define HPI_ETHERNET_PACKET_V1 0x01
/** This packet must make its way to the host across the HPI interface */
#define HPI_ETHERNET_PACKET_HOSTED_VIA_HMI 0x20
/** This packet must make its way to the host across the HPI interface */
#define HPI_ETHERNET_PACKET_HOSTED_VIA_HMI_V1 0x21
/** This packet must make its way to the host across the HPI interface */
#define HPI_ETHERNET_PACKET_HOSTED_VIA_HPI 0x40
/** This packet must make its way to the host across the HPI interface */
#define HPI_ETHERNET_PACKET_HOSTED_VIA_HPI_V1 0x41
#define HPI_ETHERNET_UDP_PORT 44600 /**< HPI UDP service */
/** Default network timeout in milli-seconds. */
#define HPI_ETHERNET_TIMEOUT_MS 500
/** Locked memory buffer alloc/free phases */
enum HPI_BUFFER_CMDS {
/** use one message to allocate or free physical memory */
HPI_BUFFER_CMD_EXTERNAL = 0,
/** alloc physical memory */
HPI_BUFFER_CMD_INTERNAL_ALLOC = 1,
/** send physical memory address to adapter */
HPI_BUFFER_CMD_INTERNAL_GRANTADAPTER = 2,
/** notify adapter to stop using physical buffer */
HPI_BUFFER_CMD_INTERNAL_REVOKEADAPTER = 3,
/** free physical buffer */
HPI_BUFFER_CMD_INTERNAL_FREE = 4
};
/*****************************************************************************/
/*****************************************************************************/
/******** HPI LOW LEVEL MESSAGES *******/
/*****************************************************************************/
/*****************************************************************************/
/** Pnp ids */
/** "ASI" - actual is "ASX" - need to change */
#define HPI_ID_ISAPNP_AUDIOSCIENCE 0x0669
/** PCI vendor ID that AudioScience uses */
#define HPI_PCI_VENDOR_ID_AUDIOSCIENCE 0x175C
/** PCI vendor ID that the DSP56301 has */
#define HPI_PCI_VENDOR_ID_MOTOROLA 0x1057
/** PCI vendor ID that TI uses */
#define HPI_PCI_VENDOR_ID_TI 0x104C
#define HPI_PCI_DEV_ID_PCI2040 0xAC60
/** TI's C6205 PCI interface has this ID */
#define HPI_PCI_DEV_ID_DSP6205 0xA106
#define HPI_USB_VENDOR_ID_AUDIOSCIENCE 0x1257
#define HPI_USB_W2K_TAG 0x57495341 /* "ASIW" */
#define HPI_USB_LINUX_TAG 0x4C495341 /* "ASIL" */
/** Invalid Adapter index
Used in HPI messages that are not addressed to a specific adapter
Used in DLL to indicate device not present
*/
#define HPI_ADAPTER_INDEX_INVALID 0xFFFF
/** First 2 hex digits define the adapter family */
#define HPI_ADAPTER_FAMILY_MASK 0xff00
#define HPI_MODULE_FAMILY_MASK 0xfff0
#define HPI_ADAPTER_FAMILY_ASI(f) (f & HPI_ADAPTER_FAMILY_MASK)
#define HPI_MODULE_FAMILY_ASI(f) (f & HPI_MODULE_FAMILY_MASK)
#define HPI_ADAPTER_ASI(f) (f)
enum HPI_MESSAGE_TYPES {
HPI_TYPE_REQUEST = 1,
HPI_TYPE_RESPONSE = 2,
HPI_TYPE_DATA = 3,
HPI_TYPE_SSX2BYPASS_MESSAGE = 4,
HPI_TYPE_COMMAND = 5,
HPI_TYPE_NOTIFICATION = 6
};
enum HPI_OBJECT_TYPES {
HPI_OBJ_SUBSYSTEM = 1,
HPI_OBJ_ADAPTER = 2,
HPI_OBJ_OSTREAM = 3,
HPI_OBJ_ISTREAM = 4,
HPI_OBJ_MIXER = 5,
HPI_OBJ_NODE = 6,
HPI_OBJ_CONTROL = 7,
HPI_OBJ_NVMEMORY = 8,
HPI_OBJ_GPIO = 9,
HPI_OBJ_WATCHDOG = 10,
HPI_OBJ_CLOCK = 11,
HPI_OBJ_PROFILE = 12,
/* HPI_ OBJ_ CONTROLEX = 13, */
HPI_OBJ_ASYNCEVENT = 14
#define HPI_OBJ_MAXINDEX 14
};
#define HPI_OBJ_FUNCTION_SPACING 0x100
#define HPI_FUNC_ID(obj, i) (HPI_OBJ_##obj * HPI_OBJ_FUNCTION_SPACING + i)
#define HPI_EXTRACT_INDEX(fn) (fn & 0xff)
enum HPI_FUNCTION_IDS {
HPI_SUBSYS_OPEN = HPI_FUNC_ID(SUBSYSTEM, 1),
HPI_SUBSYS_GET_VERSION = HPI_FUNC_ID(SUBSYSTEM, 2),
HPI_SUBSYS_GET_INFO = HPI_FUNC_ID(SUBSYSTEM, 3),
HPI_SUBSYS_CREATE_ADAPTER = HPI_FUNC_ID(SUBSYSTEM, 5),
HPI_SUBSYS_CLOSE = HPI_FUNC_ID(SUBSYSTEM, 6),
HPI_SUBSYS_DRIVER_LOAD = HPI_FUNC_ID(SUBSYSTEM, 8),
HPI_SUBSYS_DRIVER_UNLOAD = HPI_FUNC_ID(SUBSYSTEM, 9),
HPI_SUBSYS_GET_NUM_ADAPTERS = HPI_FUNC_ID(SUBSYSTEM, 12),
HPI_SUBSYS_GET_ADAPTER = HPI_FUNC_ID(SUBSYSTEM, 13),
HPI_SUBSYS_SET_NETWORK_INTERFACE = HPI_FUNC_ID(SUBSYSTEM, 14),
HPI_SUBSYS_OPTION_INFO = HPI_FUNC_ID(SUBSYSTEM, 15),
HPI_SUBSYS_OPTION_GET = HPI_FUNC_ID(SUBSYSTEM, 16),
HPI_SUBSYS_OPTION_SET = HPI_FUNC_ID(SUBSYSTEM, 17),
#define HPI_SUBSYS_FUNCTION_COUNT 17
HPI_ADAPTER_OPEN = HPI_FUNC_ID(ADAPTER, 1),
HPI_ADAPTER_CLOSE = HPI_FUNC_ID(ADAPTER, 2),
HPI_ADAPTER_GET_INFO = HPI_FUNC_ID(ADAPTER, 3),
HPI_ADAPTER_GET_ASSERT = HPI_FUNC_ID(ADAPTER, 4),
HPI_ADAPTER_TEST_ASSERT = HPI_FUNC_ID(ADAPTER, 5),
HPI_ADAPTER_SET_MODE = HPI_FUNC_ID(ADAPTER, 6),
HPI_ADAPTER_GET_MODE = HPI_FUNC_ID(ADAPTER, 7),
HPI_ADAPTER_ENABLE_CAPABILITY = HPI_FUNC_ID(ADAPTER, 8),
HPI_ADAPTER_SELFTEST = HPI_FUNC_ID(ADAPTER, 9),
HPI_ADAPTER_FIND_OBJECT = HPI_FUNC_ID(ADAPTER, 10),
HPI_ADAPTER_QUERY_FLASH = HPI_FUNC_ID(ADAPTER, 11),
HPI_ADAPTER_START_FLASH = HPI_FUNC_ID(ADAPTER, 12),
HPI_ADAPTER_PROGRAM_FLASH = HPI_FUNC_ID(ADAPTER, 13),
HPI_ADAPTER_SET_PROPERTY = HPI_FUNC_ID(ADAPTER, 14),
HPI_ADAPTER_GET_PROPERTY = HPI_FUNC_ID(ADAPTER, 15),
HPI_ADAPTER_ENUM_PROPERTY = HPI_FUNC_ID(ADAPTER, 16),
HPI_ADAPTER_MODULE_INFO = HPI_FUNC_ID(ADAPTER, 17),
HPI_ADAPTER_DEBUG_READ = HPI_FUNC_ID(ADAPTER, 18),
HPI_ADAPTER_IRQ_QUERY_AND_CLEAR = HPI_FUNC_ID(ADAPTER, 19),
HPI_ADAPTER_IRQ_CALLBACK = HPI_FUNC_ID(ADAPTER, 20),
HPI_ADAPTER_DELETE = HPI_FUNC_ID(ADAPTER, 21),
HPI_ADAPTER_READ_FLASH = HPI_FUNC_ID(ADAPTER, 22),
HPI_ADAPTER_END_FLASH = HPI_FUNC_ID(ADAPTER, 23),
HPI_ADAPTER_FILESTORE_DELETE_ALL = HPI_FUNC_ID(ADAPTER, 24),
#define HPI_ADAPTER_FUNCTION_COUNT 24
HPI_OSTREAM_OPEN = HPI_FUNC_ID(OSTREAM, 1),
HPI_OSTREAM_CLOSE = HPI_FUNC_ID(OSTREAM, 2),
HPI_OSTREAM_WRITE = HPI_FUNC_ID(OSTREAM, 3),
HPI_OSTREAM_START = HPI_FUNC_ID(OSTREAM, 4),
HPI_OSTREAM_STOP = HPI_FUNC_ID(OSTREAM, 5),
HPI_OSTREAM_RESET = HPI_FUNC_ID(OSTREAM, 6),
HPI_OSTREAM_GET_INFO = HPI_FUNC_ID(OSTREAM, 7),
HPI_OSTREAM_QUERY_FORMAT = HPI_FUNC_ID(OSTREAM, 8),
HPI_OSTREAM_DATA = HPI_FUNC_ID(OSTREAM, 9),
HPI_OSTREAM_SET_VELOCITY = HPI_FUNC_ID(OSTREAM, 10),
HPI_OSTREAM_SET_PUNCHINOUT = HPI_FUNC_ID(OSTREAM, 11),
HPI_OSTREAM_SINEGEN = HPI_FUNC_ID(OSTREAM, 12),
HPI_OSTREAM_ANC_RESET = HPI_FUNC_ID(OSTREAM, 13),
HPI_OSTREAM_ANC_GET_INFO = HPI_FUNC_ID(OSTREAM, 14),
HPI_OSTREAM_ANC_READ = HPI_FUNC_ID(OSTREAM, 15),
HPI_OSTREAM_SET_TIMESCALE = HPI_FUNC_ID(OSTREAM, 16),
HPI_OSTREAM_SET_FORMAT = HPI_FUNC_ID(OSTREAM, 17),
HPI_OSTREAM_HOSTBUFFER_ALLOC = HPI_FUNC_ID(OSTREAM, 18),
HPI_OSTREAM_HOSTBUFFER_FREE = HPI_FUNC_ID(OSTREAM, 19),
HPI_OSTREAM_GROUP_ADD = HPI_FUNC_ID(OSTREAM, 20),
HPI_OSTREAM_GROUP_GETMAP = HPI_FUNC_ID(OSTREAM, 21),
HPI_OSTREAM_GROUP_RESET = HPI_FUNC_ID(OSTREAM, 22),
HPI_OSTREAM_HOSTBUFFER_GET_INFO = HPI_FUNC_ID(OSTREAM, 23),
HPI_OSTREAM_WAIT_START = HPI_FUNC_ID(OSTREAM, 24),
HPI_OSTREAM_WAIT = HPI_FUNC_ID(OSTREAM, 25),
#define HPI_OSTREAM_FUNCTION_COUNT 25
HPI_ISTREAM_OPEN = HPI_FUNC_ID(ISTREAM, 1),
HPI_ISTREAM_CLOSE = HPI_FUNC_ID(ISTREAM, 2),
HPI_ISTREAM_SET_FORMAT = HPI_FUNC_ID(ISTREAM, 3),
HPI_ISTREAM_READ = HPI_FUNC_ID(ISTREAM, 4),
HPI_ISTREAM_START = HPI_FUNC_ID(ISTREAM, 5),
HPI_ISTREAM_STOP = HPI_FUNC_ID(ISTREAM, 6),
HPI_ISTREAM_RESET = HPI_FUNC_ID(ISTREAM, 7),
HPI_ISTREAM_GET_INFO = HPI_FUNC_ID(ISTREAM, 8),
HPI_ISTREAM_QUERY_FORMAT = HPI_FUNC_ID(ISTREAM, 9),
HPI_ISTREAM_ANC_RESET = HPI_FUNC_ID(ISTREAM, 10),
HPI_ISTREAM_ANC_GET_INFO = HPI_FUNC_ID(ISTREAM, 11),
HPI_ISTREAM_ANC_WRITE = HPI_FUNC_ID(ISTREAM, 12),
HPI_ISTREAM_HOSTBUFFER_ALLOC = HPI_FUNC_ID(ISTREAM, 13),
HPI_ISTREAM_HOSTBUFFER_FREE = HPI_FUNC_ID(ISTREAM, 14),
HPI_ISTREAM_GROUP_ADD = HPI_FUNC_ID(ISTREAM, 15),
HPI_ISTREAM_GROUP_GETMAP = HPI_FUNC_ID(ISTREAM, 16),
HPI_ISTREAM_GROUP_RESET = HPI_FUNC_ID(ISTREAM, 17),
HPI_ISTREAM_HOSTBUFFER_GET_INFO = HPI_FUNC_ID(ISTREAM, 18),
HPI_ISTREAM_WAIT_START = HPI_FUNC_ID(ISTREAM, 19),
HPI_ISTREAM_WAIT = HPI_FUNC_ID(ISTREAM, 20),
#define HPI_ISTREAM_FUNCTION_COUNT 20
/* NOTE:
GET_NODE_INFO, SET_CONNECTION, GET_CONNECTIONS are not currently used */
HPI_MIXER_OPEN = HPI_FUNC_ID(MIXER, 1),
HPI_MIXER_CLOSE = HPI_FUNC_ID(MIXER, 2),
HPI_MIXER_GET_INFO = HPI_FUNC_ID(MIXER, 3),
HPI_MIXER_GET_NODE_INFO = HPI_FUNC_ID(MIXER, 4),
HPI_MIXER_GET_CONTROL = HPI_FUNC_ID(MIXER, 5),
HPI_MIXER_SET_CONNECTION = HPI_FUNC_ID(MIXER, 6),
HPI_MIXER_GET_CONNECTIONS = HPI_FUNC_ID(MIXER, 7),
HPI_MIXER_GET_CONTROL_BY_INDEX = HPI_FUNC_ID(MIXER, 8),
HPI_MIXER_GET_CONTROL_ARRAY_BY_INDEX = HPI_FUNC_ID(MIXER, 9),
HPI_MIXER_GET_CONTROL_MULTIPLE_VALUES = HPI_FUNC_ID(MIXER, 10),
HPI_MIXER_STORE = HPI_FUNC_ID(MIXER, 11),
HPI_MIXER_GET_CACHE_INFO = HPI_FUNC_ID(MIXER, 12),
HPI_MIXER_GET_BLOCK_HANDLE = HPI_FUNC_ID(MIXER, 13),
HPI_MIXER_GET_PARAMETER_HANDLE = HPI_FUNC_ID(MIXER, 14),
#define HPI_MIXER_FUNCTION_COUNT 14
HPI_CONTROL_GET_INFO = HPI_FUNC_ID(CONTROL, 1),
HPI_CONTROL_GET_STATE = HPI_FUNC_ID(CONTROL, 2),
HPI_CONTROL_SET_STATE = HPI_FUNC_ID(CONTROL, 3),
#define HPI_CONTROL_FUNCTION_COUNT 3
HPI_NVMEMORY_OPEN = HPI_FUNC_ID(NVMEMORY, 1),
HPI_NVMEMORY_READ_BYTE = HPI_FUNC_ID(NVMEMORY, 2),
HPI_NVMEMORY_WRITE_BYTE = HPI_FUNC_ID(NVMEMORY, 3),
#define HPI_NVMEMORY_FUNCTION_COUNT 3
HPI_GPIO_OPEN = HPI_FUNC_ID(GPIO, 1),
HPI_GPIO_READ_BIT = HPI_FUNC_ID(GPIO, 2),
HPI_GPIO_WRITE_BIT = HPI_FUNC_ID(GPIO, 3),
HPI_GPIO_READ_ALL = HPI_FUNC_ID(GPIO, 4),
HPI_GPIO_WRITE_STATUS = HPI_FUNC_ID(GPIO, 5),
#define HPI_GPIO_FUNCTION_COUNT 5
HPI_ASYNCEVENT_OPEN = HPI_FUNC_ID(ASYNCEVENT, 1),
HPI_ASYNCEVENT_CLOSE = HPI_FUNC_ID(ASYNCEVENT, 2),
HPI_ASYNCEVENT_WAIT = HPI_FUNC_ID(ASYNCEVENT, 3),
HPI_ASYNCEVENT_GETCOUNT = HPI_FUNC_ID(ASYNCEVENT, 4),
HPI_ASYNCEVENT_GET = HPI_FUNC_ID(ASYNCEVENT, 5),
HPI_ASYNCEVENT_SENDEVENTS = HPI_FUNC_ID(ASYNCEVENT, 6),
#define HPI_ASYNCEVENT_FUNCTION_COUNT 6
HPI_WATCHDOG_OPEN = HPI_FUNC_ID(WATCHDOG, 1),
HPI_WATCHDOG_SET_TIME = HPI_FUNC_ID(WATCHDOG, 2),
HPI_WATCHDOG_PING = HPI_FUNC_ID(WATCHDOG, 3),
HPI_CLOCK_OPEN = HPI_FUNC_ID(CLOCK, 1),
HPI_CLOCK_SET_TIME = HPI_FUNC_ID(CLOCK, 2),
HPI_CLOCK_GET_TIME = HPI_FUNC_ID(CLOCK, 3),
HPI_PROFILE_OPEN_ALL = HPI_FUNC_ID(PROFILE, 1),
HPI_PROFILE_START_ALL = HPI_FUNC_ID(PROFILE, 2),
HPI_PROFILE_STOP_ALL = HPI_FUNC_ID(PROFILE, 3),
HPI_PROFILE_GET = HPI_FUNC_ID(PROFILE, 4),
HPI_PROFILE_GET_IDLECOUNT = HPI_FUNC_ID(PROFILE, 5),
HPI_PROFILE_GET_NAME = HPI_FUNC_ID(PROFILE, 6),
HPI_PROFILE_GET_UTILIZATION = HPI_FUNC_ID(PROFILE, 7)
#define HPI_PROFILE_FUNCTION_COUNT 7
};
/* ////////////////////////////////////////////////////////////////////// */
/* STRUCTURES */
#ifndef DISABLE_PRAGMA_PACK1
#pragma pack(push, 1)
#endif
/** PCI bus resource */
struct hpi_pci {
u32 __iomem *ap_mem_base[HPI_MAX_ADAPTER_MEM_SPACES];
struct pci_dev *pci_dev;
};
/** Adapter specification resource */
struct hpi_adapter_specification {
u32 type;
u8 modules[4];
};
struct hpi_resource {
union {
const struct hpi_pci *pci;
const char *net_if;
struct hpi_adapter_specification adapter_spec;
const void *sw_if;
} r;
u16 bus_type; /* HPI_BUS_PNPISA, _PCI, _USB etc */
u16 padding;
};
/** Format info used inside struct hpi_message
Not the same as public API struct hpi_format */
struct hpi_msg_format {
u32 sample_rate; /**< 11025, 32000, 44100 etc. */
u32 bit_rate; /**< for MPEG */
u32 attributes; /**< stereo/joint_stereo/mono */
u16 channels; /**< 1,2..., (or ancillary mode or idle bit */
u16 format; /**< HPI_FORMAT_PCM16, _MPEG etc. see \ref HPI_FORMATS. */
};
/** Buffer+format structure.
Must be kept 7 * 32 bits to match public struct hpi_datastruct */
struct hpi_msg_data {
struct hpi_msg_format format;
u8 *pb_data;
#ifndef CONFIG_64BIT
u32 padding;
#endif
u32 data_size;
};
/** struct hpi_datastructure used up to 3.04 driver */
struct hpi_data_legacy32 {
struct hpi_format format;
u32 pb_data;
u32 data_size;
};
#ifdef CONFIG_64BIT
/* Compatibility version of struct hpi_data*/
struct hpi_data_compat32 {
struct hpi_msg_format format;
u32 pb_data;
u32 padding;
u32 data_size;
};
#endif
struct hpi_buffer {
/** placeholder for backward compatibility (see dwBufferSize) */
struct hpi_msg_format reserved;
u32 command; /**< HPI_BUFFER_CMD_xxx*/
u32 pci_address; /**< PCI physical address of buffer for DSP DMA */
u32 buffer_size; /**< must line up with data_size of HPI_DATA*/
};
/*/////////////////////////////////////////////////////////////////////////// */
/* This is used for background buffer bus mastering stream buffers. */
struct hpi_hostbuffer_status {
u32 samples_processed;
u32 auxiliary_data_available;
u32 stream_state;
/* DSP index in to the host bus master buffer. */
u32 dsp_index;
/* Host index in to the host bus master buffer. */
u32 host_index;
u32 size_in_bytes;
};
struct hpi_streamid {
u16 object_type;
/**< Type of object, HPI_OBJ_OSTREAM or HPI_OBJ_ISTREAM. */
u16 stream_index; /**< outstream or instream index. */
};
struct hpi_punchinout {
u32 punch_in_sample;
u32 punch_out_sample;
};
struct hpi_subsys_msg {
struct hpi_resource resource;
};
struct hpi_subsys_res {
u32 version;
u32 data; /* extended version */
u16 num_adapters;
u16 adapter_index;
u16 adapter_type;
u16 pad16;
};
union hpi_adapterx_msg {
struct {
u32 dsp_address;
u32 count_bytes;
} debug_read;
struct {
u32 adapter_mode;
u16 query_or_set;
} mode;
struct {
u16 index;
} module_info;
struct {
u16 index;
u16 what;
u16 property_index;
} property_enum;
struct {
u16 property;
u16 parameter1;
u16 parameter2;
} property_set;
struct {
u32 pad32;
u16 key1;
u16 key2;
} restart;
struct {
u32 pad32;
u16 value;
} test_assert;
struct {
u32 message;
} irq;
u32 pad[3];
};
struct hpi_adapter_res {
u32 serial_number;
u16 adapter_type;
u16 adapter_index;
u16 num_instreams;
u16 num_outstreams;
u16 num_mixers;
u16 version;
u8 sz_adapter_assert[HPI_STRING_LEN];
};
union hpi_adapterx_res {
struct hpi_adapter_res info;
struct {
u32 p1;
u16 count;
u16 dsp_index;
u32 p2;
u32 dsp_msg_addr;
char sz_message[HPI_STRING_LEN];
} assert;
struct {
u32 adapter_mode;
} mode;
struct {
u16 parameter1;
u16 parameter2;
} property_get;
struct {
u32 yes;
} irq_query;
};
struct hpi_stream_msg {
union {
struct hpi_msg_data data;
struct hpi_data_legacy32 data32;
u16 velocity;
struct hpi_punchinout pio;
u32 time_scale;
struct hpi_buffer buffer;
struct hpi_streamid stream;
u32 threshold_bytes;
} u;
};
struct hpi_stream_res {
union {
struct {
/* size of hardware buffer */
u32 buffer_size;
/* OutStream - data to play,
InStream - data recorded */
u32 data_available;
/* OutStream - samples played,
InStream - samples recorded */
u32 samples_transferred;
/* Adapter - OutStream - data to play,
InStream - data recorded */
u32 auxiliary_data_available;
u16 state; /* HPI_STATE_PLAYING, _STATE_STOPPED */
u16 padding;
} stream_info;
struct {
u32 buffer_size;
u32 data_available;
u32 samples_transfered;
u16 state;
u16 outstream_index;
u16 instream_index;
u16 padding;
u32 auxiliary_data_available;
} legacy_stream_info;
struct {
/* bitmap of grouped OutStreams */
u32 outstream_group_map;
/* bitmap of grouped InStreams */
u32 instream_group_map;
} group_info;
struct {
/* pointer to the buffer */
u8 *p_buffer;
/* pointer to the hostbuffer status */
struct hpi_hostbuffer_status *p_status;
} hostbuffer_info;
} u;
};
struct hpi_mixer_msg {
u16 control_index;
u16 control_type; /* = HPI_CONTROL_METER _VOLUME etc */
u16 padding1; /* Maintain alignment of subsequent fields */
u16 node_type1; /* = HPI_SOURCENODE_LINEIN etc */
u16 node_index1; /* = 0..N */
u16 node_type2;
u16 node_index2;
u16 padding2; /* round to 4 bytes */
};
struct hpi_mixer_res {
u16 src_node_type; /* = HPI_SOURCENODE_LINEIN etc */
u16 src_node_index; /* = 0..N */
u16 dst_node_type;
u16 dst_node_index;
/* Also controlType for MixerGetControlByIndex */
u16 control_index;
/* may indicate which DSP the control is located on */
u16 dsp_index;
};
union hpi_mixerx_msg {
struct {
u16 starting_index;
u16 flags;
u32 length_in_bytes; /* length in bytes of p_data */
u32 p_data; /* pointer to a data array */
} gcabi;
struct {
u16 command;
u16 index;
} store; /* for HPI_MIXER_STORE message */
};
union hpi_mixerx_res {
struct {
u32 bytes_returned; /* size of items returned */
u32 p_data; /* pointer to data array */
u16 more_to_do; /* indicates if there is more to do */
} gcabi;
struct {
u32 total_controls; /* count of controls in the mixer */
u32 cache_controls; /* count of controls in the cac */
u32 cache_bytes; /* size of cache */
} cache_info;
};
struct hpi_control_msg {
u16 attribute; /* control attribute or property */
u16 saved_index;
u32 param1; /* generic parameter 1 */
u32 param2; /* generic parameter 2 */
short an_log_value[HPI_MAX_CHANNELS];
};
struct hpi_control_union_msg {
u16 attribute; /* control attribute or property */
u16 saved_index; /* only used in ctrl save/restore */
union {
struct {
u32 param1; /* generic parameter 1 */
u32 param2; /* generic parameter 2 */
short an_log_value[HPI_MAX_CHANNELS];
} old;
union {
u32 frequency;
u32 gain;
u32 band;
u32 deemphasis;
u32 program;
struct {
u32 mode;
u32 value;
} mode;
u32 blend;
} tuner;
} u;
};
struct hpi_control_res {
/* Could make union. dwParam, anLogValue never used in same response */
u32 param1;
u32 param2;
short an_log_value[HPI_MAX_CHANNELS];
};
union hpi_control_union_res {
struct {
u32 param1;
u32 param2;
short an_log_value[HPI_MAX_CHANNELS];
} old;
union {
u32 band;
u32 frequency;
u32 gain;
u32 deemphasis;
struct {
u32 data[2];
u32 bLER;
} rds;
short s_level;
struct {
u16 value;
u16 mask;
} status;
} tuner;
struct {
char sz_data[8];
u32 remaining_chars;
} chars8;
char c_data12[12];
union {
struct {
u32 status;
u32 readable_size;
u32 writeable_size;
} status;
} cobranet;
};
struct hpi_nvmemory_msg {
u16 address;
u16 data;
};
struct hpi_nvmemory_res {
u16 size_in_bytes;
u16 data;
};
struct hpi_gpio_msg {
u16 bit_index;
u16 bit_data;
};
struct hpi_gpio_res {
u16 number_input_bits;
u16 number_output_bits;
u16 bit_data[4];
};
struct hpi_async_msg {
u32 events;
u16 maximum_events;
u16 padding;
};
struct hpi_async_res {
union {
struct {
u16 count;
} count;
struct {
u32 events;
u16 number_returned;
u16 padding;
} get;
struct hpi_async_event event;
} u;
};
struct hpi_watchdog_msg {
u32 time_ms;
};
struct hpi_watchdog_res {
u32 time_ms;
};
struct hpi_clock_msg {
u16 hours;
u16 minutes;
u16 seconds;
u16 milli_seconds;
};
struct hpi_clock_res {
u16 size_in_bytes;
u16 hours;
u16 minutes;
u16 seconds;
u16 milli_seconds;
u16 padding;
};
struct hpi_profile_msg {
u16 bin_index;
u16 padding;
};
struct hpi_profile_res_open {
u16 max_profiles;
};
struct hpi_profile_res_time {
u32 total_tick_count;
u32 call_count;
u32 max_tick_count;
u32 ticks_per_millisecond;
u16 profile_interval;
};
struct hpi_profile_res_name {
u8 sz_name[32];
};
struct hpi_profile_res {
union {
struct hpi_profile_res_open o;
struct hpi_profile_res_time t;
struct hpi_profile_res_name n;
} u;
};
struct hpi_message_header {
u16 size; /* total size in bytes */
u8 type; /* HPI_TYPE_MESSAGE */
u8 version; /* message version */
u16 object; /* HPI_OBJ_* */
u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
u16 adapter_index; /* the adapter index */
u16 obj_index; /* */
};
struct hpi_message {
/* following fields must match HPI_MESSAGE_HEADER */
u16 size; /* total size in bytes */
u8 type; /* HPI_TYPE_MESSAGE */
u8 version; /* message version */
u16 object; /* HPI_OBJ_* */
u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
u16 adapter_index; /* the adapter index */
u16 obj_index; /* */
union {
struct hpi_subsys_msg s;
union hpi_adapterx_msg ax;
struct hpi_stream_msg d;
struct hpi_mixer_msg m;
union hpi_mixerx_msg mx; /* extended mixer; */
struct hpi_control_msg c; /* mixer control; */
/* identical to struct hpi_control_msg,
but field naming is improved */
struct hpi_control_union_msg cu;
struct hpi_nvmemory_msg n;
struct hpi_gpio_msg l; /* digital i/o */
struct hpi_watchdog_msg w;
struct hpi_clock_msg t; /* dsp time */
struct hpi_profile_msg p;
struct hpi_async_msg as;
char fixed_size[32];
} u;
};
#define HPI_MESSAGE_SIZE_BY_OBJECT { \
sizeof(struct hpi_message_header) , /* Default, no object type 0 */ \
sizeof(struct hpi_message_header) + sizeof(struct hpi_subsys_msg),\
sizeof(struct hpi_message_header) + sizeof(union hpi_adapterx_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_stream_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_stream_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_mixer_msg),\
sizeof(struct hpi_message_header) , /* no node message */ \
sizeof(struct hpi_message_header) + sizeof(struct hpi_control_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_nvmemory_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_gpio_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_watchdog_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_clock_msg),\
sizeof(struct hpi_message_header) + sizeof(struct hpi_profile_msg),\
sizeof(struct hpi_message_header), /* controlx obj removed */ \
sizeof(struct hpi_message_header) + sizeof(struct hpi_async_msg) \
}
/*
Note that the wSpecificError error field should be inspected and potentially
reported whenever HPI_ERROR_DSP_COMMUNICATION or HPI_ERROR_DSP_BOOTLOAD is
returned in wError.
*/
struct hpi_response_header {
u16 size;
u8 type; /* HPI_TYPE_RESPONSE */
u8 version; /* response version */
u16 object; /* HPI_OBJ_* */
u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
u16 error; /* HPI_ERROR_xxx */
u16 specific_error; /* adapter specific error */
};
struct hpi_response {
/* following fields must match HPI_RESPONSE_HEADER */
u16 size;
u8 type; /* HPI_TYPE_RESPONSE */
u8 version; /* response version */
u16 object; /* HPI_OBJ_* */
u16 function; /* HPI_SUBSYS_xxx, HPI_ADAPTER_xxx */
u16 error; /* HPI_ERROR_xxx */
u16 specific_error; /* adapter specific error */
union {
struct hpi_subsys_res s;
union hpi_adapterx_res ax;
struct hpi_stream_res d;
struct hpi_mixer_res m;
union hpi_mixerx_res mx; /* extended mixer; */
struct hpi_control_res c; /* mixer control; */
/* identical to hpi_control_res, but field naming is improved */
union hpi_control_union_res cu;
struct hpi_nvmemory_res n;
struct hpi_gpio_res l; /* digital i/o */
struct hpi_watchdog_res w;
struct hpi_clock_res t; /* dsp time */
struct hpi_profile_res p;
struct hpi_async_res as;
u8 bytes[52];
} u;
};
#define HPI_RESPONSE_SIZE_BY_OBJECT { \
sizeof(struct hpi_response_header) ,/* Default, no object type 0 */ \
sizeof(struct hpi_response_header) + sizeof(struct hpi_subsys_res),\
sizeof(struct hpi_response_header) + sizeof(union hpi_adapterx_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_stream_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_stream_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_mixer_res),\
sizeof(struct hpi_response_header) , /* no node response */ \
sizeof(struct hpi_response_header) + sizeof(struct hpi_control_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_nvmemory_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_gpio_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_watchdog_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_clock_res),\
sizeof(struct hpi_response_header) + sizeof(struct hpi_profile_res),\
sizeof(struct hpi_response_header), /* controlx obj removed */ \
sizeof(struct hpi_response_header) + sizeof(struct hpi_async_res) \
}
/*********************** version 1 message/response **************************/
#define HPINET_ETHERNET_DATA_SIZE (1500)
#define HPINET_IP_HDR_SIZE (20)
#define HPINET_IP_DATA_SIZE (HPINET_ETHERNET_DATA_SIZE - HPINET_IP_HDR_SIZE)
#define HPINET_UDP_HDR_SIZE (8)
#define HPINET_UDP_DATA_SIZE (HPINET_IP_DATA_SIZE - HPINET_UDP_HDR_SIZE)
#define HPINET_ASI_HDR_SIZE (2)
#define HPINET_ASI_DATA_SIZE (HPINET_UDP_DATA_SIZE - HPINET_ASI_HDR_SIZE)
#define HPI_MAX_PAYLOAD_SIZE (HPINET_ASI_DATA_SIZE - 2)
/* New style message/response, but still V0 compatible */
struct hpi_msg_adapter_get_info {
struct hpi_message_header h;
};
struct hpi_res_adapter_get_info {
struct hpi_response_header h; /*v0 */
struct hpi_adapter_res p;
};
struct hpi_res_adapter_debug_read {
struct hpi_response_header h;
u8 bytes[1024];
};
struct hpi_msg_cobranet_hmi {
u16 attribute;
u16 padding;
u32 hmi_address;
u32 byte_count;
};
struct hpi_msg_cobranet_hmiwrite {
struct hpi_message_header h;
struct hpi_msg_cobranet_hmi p;
u8 bytes[256];
};
struct hpi_msg_cobranet_hmiread {
struct hpi_message_header h;
struct hpi_msg_cobranet_hmi p;
};
struct hpi_res_cobranet_hmiread {
struct hpi_response_header h;
u32 byte_count;
u8 bytes[256];
};
#if 1
#define hpi_message_header_v1 hpi_message_header
#define hpi_response_header_v1 hpi_response_header
#else
/* V1 headers in Addition to v0 headers */
struct hpi_message_header_v1 {
struct hpi_message_header h0;
/* struct {
} h1; */
};
struct hpi_response_header_v1 {
struct hpi_response_header h0;
struct {
u16 adapter_index; /* the adapter index */
u16 obj_index; /* object index */
} h1;
};
#endif
struct hpi_msg_payload_v0 {
struct hpi_message_header h;
union {
struct hpi_subsys_msg s;
union hpi_adapterx_msg ax;
struct hpi_stream_msg d;
struct hpi_mixer_msg m;
union hpi_mixerx_msg mx;
struct hpi_control_msg c;
struct hpi_control_union_msg cu;
struct hpi_nvmemory_msg n;
struct hpi_gpio_msg l;
struct hpi_watchdog_msg w;
struct hpi_clock_msg t;
struct hpi_profile_msg p;
struct hpi_async_msg as;
} u;
};
struct hpi_res_payload_v0 {
struct hpi_response_header h;
union {
struct hpi_subsys_res s;
union hpi_adapterx_res ax;
struct hpi_stream_res d;
struct hpi_mixer_res m;
union hpi_mixerx_res mx;
struct hpi_control_res c;
union hpi_control_union_res cu;
struct hpi_nvmemory_res n;
struct hpi_gpio_res l;
struct hpi_watchdog_res w;
struct hpi_clock_res t;
struct hpi_profile_res p;
struct hpi_async_res as;
} u;
};
union hpi_message_buffer_v1 {
struct hpi_message m0; /* version 0 */
struct hpi_message_header_v1 h;
u8 buf[HPI_MAX_PAYLOAD_SIZE];
};
union hpi_response_buffer_v1 {
struct hpi_response r0; /* version 0 */
struct hpi_response_header_v1 h;
u8 buf[HPI_MAX_PAYLOAD_SIZE];
};
compile_time_assert((sizeof(union hpi_message_buffer_v1) <=
HPI_MAX_PAYLOAD_SIZE), message_buffer_ok);
compile_time_assert((sizeof(union hpi_response_buffer_v1) <=
HPI_MAX_PAYLOAD_SIZE), response_buffer_ok);
/*////////////////////////////////////////////////////////////////////////// */
/* declarations for compact control calls */
struct hpi_control_defn {
u8 type;
u8 channels;
u8 src_node_type;
u8 src_node_index;
u8 dest_node_type;
u8 dest_node_index;
};
/*////////////////////////////////////////////////////////////////////////// */
/* declarations for control caching (internal to HPI<->DSP interaction) */
/** indicates a cached u16 value is invalid. */
#define HPI_CACHE_INVALID_UINT16 0xFFFF
/** indicates a cached short value is invalid. */
#define HPI_CACHE_INVALID_SHORT -32768
/** A compact representation of (part of) a controls state.
Used for efficient transfer of the control state
between DSP and host or across a network
*/
struct hpi_control_cache_info {
/** one of HPI_CONTROL_* */
u8 control_type;
/** The total size of cached information in 32-bit words. */
u8 size_in32bit_words;
/** The original index of the control on the DSP */
u16 control_index;
};
struct hpi_control_cache_vol {
struct hpi_control_cache_info i;
short an_log[2];
unsigned short flags;
char padding[2];
};
struct hpi_control_cache_meter {
struct hpi_control_cache_info i;
short an_log_peak[2];
short an_logRMS[2];
};
struct hpi_control_cache_channelmode {
struct hpi_control_cache_info i;
u16 mode;
char temp_padding[6];
};
struct hpi_control_cache_mux {
struct hpi_control_cache_info i;
u16 source_node_type;
u16 source_node_index;
char temp_padding[4];
};
struct hpi_control_cache_level {
struct hpi_control_cache_info i;
short an_log[2];
char temp_padding[4];
};
struct hpi_control_cache_tuner {
struct hpi_control_cache_info i;
u32 freq_ink_hz;
u16 band;
short s_level_avg;
};
struct hpi_control_cache_aes3rx {
struct hpi_control_cache_info i;
u32 error_status;
u32 format;
};
struct hpi_control_cache_aes3tx {
struct hpi_control_cache_info i;
u32 format;
char temp_padding[4];
};
struct hpi_control_cache_tonedetector {
struct hpi_control_cache_info i;
u16 state;
char temp_padding[6];
};
struct hpi_control_cache_silencedetector {
struct hpi_control_cache_info i;
u32 state;
char temp_padding[4];
};
struct hpi_control_cache_sampleclock {
struct hpi_control_cache_info i;
u16 source;
u16 source_index;
u32 sample_rate;
};
struct hpi_control_cache_microphone {
struct hpi_control_cache_info i;
u16 phantom_state;
char temp_padding[6];
};
struct hpi_control_cache_single {
union {
struct hpi_control_cache_info i;
struct hpi_control_cache_vol vol;
struct hpi_control_cache_meter meter;
struct hpi_control_cache_channelmode mode;
struct hpi_control_cache_mux mux;
struct hpi_control_cache_level level;
struct hpi_control_cache_tuner tuner;
struct hpi_control_cache_aes3rx aes3rx;
struct hpi_control_cache_aes3tx aes3tx;
struct hpi_control_cache_tonedetector tone;
struct hpi_control_cache_silencedetector silence;
struct hpi_control_cache_sampleclock clk;
struct hpi_control_cache_microphone microphone;
} u;
};
struct hpi_control_cache_pad {
struct hpi_control_cache_info i;
u32 field_valid_flags;
u8 c_channel[40];
u8 c_artist[100];
u8 c_title[100];
u8 c_comment[200];
u32 pTY;
u32 pI;
u32 traffic_supported;
u32 traffic_anouncement;
};
/* 2^N sized FIFO buffer (internal to HPI<->DSP interaction) */
struct hpi_fifo_buffer {
u32 size;
u32 dsp_index;
u32 host_index;
};
#ifndef DISABLE_PRAGMA_PACK1
#pragma pack(pop)
#endif
/* skip host side function declarations for DSP
compile and documentation extraction */
char hpi_handle_object(const u32 handle);
void hpi_handle_to_indexes(const u32 handle, u16 *pw_adapter_index,
u16 *pw_object_index);
u32 hpi_indexes_to_handle(const char c_object, const u16 adapter_index,
const u16 object_index);
/*////////////////////////////////////////////////////////////////////////// */
/* main HPI entry point */
void hpi_send_recv(struct hpi_message *phm, struct hpi_response *phr);
/* used in PnP OS/driver */
u16 hpi_subsys_create_adapter(const struct hpi_resource *p_resource,
u16 *pw_adapter_index);
u16 hpi_outstream_host_buffer_get_info(u32 h_outstream, u8 **pp_buffer,
struct hpi_hostbuffer_status **pp_status);
u16 hpi_instream_host_buffer_get_info(u32 h_instream, u8 **pp_buffer,
struct hpi_hostbuffer_status **pp_status);
u16 hpi_adapter_restart(u16 adapter_index);
/*
The following 3 functions were last declared in header files for
driver 3.10. HPI_ControlQuery() used to be the recommended way
of getting a volume range. Declared here for binary asihpi32.dll
compatibility.
*/
void hpi_format_to_msg(struct hpi_msg_format *pMF,
const struct hpi_format *pF);
void hpi_stream_response_to_legacy(struct hpi_stream_res *pSR);
/*////////////////////////////////////////////////////////////////////////// */
/* declarations for individual HPI entry points */
hpi_handler_func HPI_6000;
hpi_handler_func HPI_6205;
#endif /* _HPI_INTERNAL_H_ */
View Git Blame Copy Permalink