1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 /* -*- linux-c -*- * 3 * 4 * ALSA driver for the digigram lx6464es interface 5 * adapted upstream headers 6 * 7 * Copyright (c) 2009 Tim Blechmann <tim@klingt.org> 8 */ 9 10 #ifndef LX_DEFS_H 11 #define LX_DEFS_H 12 13 /* code adapted from ethersound.h */ 14 #define XES_FREQ_COUNT8_MASK 0x00001FFF /* compteur 25MHz entre 8 ech. */ 15 #define XES_FREQ_COUNT8_44_MIN 0x00001288 /* 25M / 16 * [ 44k - ( 44.1k + 48k ) / 2 ] 17 * * 8 */ 18 #define XES_FREQ_COUNT8_44_MAX 0x000010F0 /* 25M / [ ( 44.1k + 48k ) / 2 ] 19 * * 8 */ 20 #define XES_FREQ_COUNT8_48_MAX 0x00000F08 /* 25M / 21 * [ 48k + ( 44.1k + 48k ) / 2 ] 22 * * 8 */ 23 24 /* code adapted from LXES_registers.h */ 25 26 #define IOCR_OUTPUTS_OFFSET 0 /* (rw) offset for the number of OUTs in the 27 * ConfES register. */ 28 #define IOCR_INPUTS_OFFSET 8 /* (rw) offset for the number of INs in the 29 * ConfES register. */ 30 #define FREQ_RATIO_OFFSET 19 /* (rw) offset for frequency ratio in the 31 * ConfES register. */ 32 #define FREQ_RATIO_SINGLE_MODE 0x01 /* value for single mode frequency ratio: 33 * sample rate = frequency rate. */ 34 35 #define CONFES_READ_PART_MASK 0x00070000 36 #define CONFES_WRITE_PART_MASK 0x00F80000 37 38 /* code adapted from if_drv_mb.h */ 39 40 #define MASK_SYS_STATUS_ERROR (1L << 31) /* events that lead to a PCI irq if 41 * not yet pending */ 42 #define MASK_SYS_STATUS_URUN (1L << 30) 43 #define MASK_SYS_STATUS_ORUN (1L << 29) 44 #define MASK_SYS_STATUS_EOBO (1L << 28) 45 #define MASK_SYS_STATUS_EOBI (1L << 27) 46 #define MASK_SYS_STATUS_FREQ (1L << 26) 47 #define MASK_SYS_STATUS_ESA (1L << 25) /* reserved, this is set by the 48 * XES */ 49 #define MASK_SYS_STATUS_TIMER (1L << 24) 50 51 #define MASK_SYS_ASYNC_EVENTS (MASK_SYS_STATUS_ERROR | \ 52 MASK_SYS_STATUS_URUN | \ 53 MASK_SYS_STATUS_ORUN | \ 54 MASK_SYS_STATUS_EOBO | \ 55 MASK_SYS_STATUS_EOBI | \ 56 MASK_SYS_STATUS_FREQ | \ 57 MASK_SYS_STATUS_ESA) 58 59 #define MASK_SYS_PCI_EVENTS (MASK_SYS_ASYNC_EVENTS | \ 60 MASK_SYS_STATUS_TIMER) 61 62 #define MASK_SYS_TIMER_COUNT 0x0000FFFF 63 64 #define MASK_SYS_STATUS_EOT_PLX (1L << 22) /* event that remains 65 * internal: reserved fo end 66 * of plx dma */ 67 #define MASK_SYS_STATUS_XES (1L << 21) /* event that remains 68 * internal: pending XES 69 * IRQ */ 70 #define MASK_SYS_STATUS_CMD_DONE (1L << 20) /* alternate command 71 * management: notify driver 72 * instead of polling */ 73 74 75 #define MAX_STREAM_BUFFER 5 /* max amount of stream buffers. */ 76 77 #define MICROBLAZE_IBL_MIN 32 78 #define MICROBLAZE_IBL_DEFAULT 128 79 #define MICROBLAZE_IBL_MAX 512 80 /* #define MASK_GRANULARITY (2*MICROBLAZE_IBL_MAX-1) */ 81 82 83 84 /* command opcodes, see reference for details */ 85 86 /* 87 the capture bit position in the object_id field in driver commands 88 depends upon the number of managed channels. For now, 64 IN + 64 OUT are 89 supported. HOwever, the communication protocol forsees 1024 channels, hence 90 bit 10 indicates a capture (input) object). 91 */ 92 #define ID_IS_CAPTURE (1L << 10) 93 #define ID_OFFSET 13 /* object ID is at the 13th bit in the 94 * 1st command word.*/ 95 #define ID_CH_MASK 0x3F 96 #define OPCODE_OFFSET 24 /* offset of the command opcode in the first 97 * command word.*/ 98 99 enum cmd_mb_opcodes { 100 CMD_00_INFO_DEBUG = 0x00, 101 CMD_01_GET_SYS_CFG = 0x01, 102 CMD_02_SET_GRANULARITY = 0x02, 103 CMD_03_SET_TIMER_IRQ = 0x03, 104 CMD_04_GET_EVENT = 0x04, 105 CMD_05_GET_PIPES = 0x05, 106 107 CMD_06_ALLOCATE_PIPE = 0x06, 108 CMD_07_RELEASE_PIPE = 0x07, 109 CMD_08_ASK_BUFFERS = 0x08, 110 CMD_09_STOP_PIPE = 0x09, 111 CMD_0A_GET_PIPE_SPL_COUNT = 0x0a, 112 CMD_0B_TOGGLE_PIPE_STATE = 0x0b, 113 114 CMD_0C_DEF_STREAM = 0x0c, 115 CMD_0D_SET_MUTE = 0x0d, 116 CMD_0E_GET_STREAM_SPL_COUNT = 0x0e, 117 CMD_0F_UPDATE_BUFFER = 0x0f, 118 CMD_10_GET_BUFFER = 0x10, 119 CMD_11_CANCEL_BUFFER = 0x11, 120 CMD_12_GET_PEAK = 0x12, 121 CMD_13_SET_STREAM_STATE = 0x13, 122 CMD_14_INVALID = 0x14, 123 }; 124 125 /* pipe states */ 126 enum pipe_state_t { 127 PSTATE_IDLE = 0, /* the pipe is not processed in the XES_IRQ 128 * (free or stopped, or paused). */ 129 PSTATE_RUN = 1, /* sustained play/record state. */ 130 PSTATE_PURGE = 2, /* the ES channels are now off, render pipes do 131 * not DMA, record pipe do a last DMA. */ 132 PSTATE_ACQUIRE = 3, /* the ES channels are now on, render pipes do 133 * not yet increase their sample count, record 134 * pipes do not DMA. */ 135 PSTATE_CLOSING = 4, /* the pipe is releasing, and may not yet 136 * receive an "alloc" command. */ 137 }; 138 139 /* stream states */ 140 enum stream_state_t { 141 SSTATE_STOP = 0x00, /* setting to stop resets the stream spl 142 * count.*/ 143 SSTATE_RUN = (0x01 << 0), /* start DMA and spl count handling. */ 144 SSTATE_PAUSE = (0x01 << 1), /* pause DMA and spl count handling. */ 145 }; 146 147 /* buffer flags */ 148 enum buffer_flags { 149 BF_VALID = 0x80, /* set if the buffer is valid, clear if free.*/ 150 BF_CURRENT = 0x40, /* set if this is the current buffer (there is 151 * always a current buffer).*/ 152 BF_NOTIFY_EOB = 0x20, /* set if this buffer must cause a PCI event 153 * when finished.*/ 154 BF_CIRCULAR = 0x10, /* set if buffer[1] must be copied to buffer[0] 155 * by the end of this buffer.*/ 156 BF_64BITS_ADR = 0x08, /* set if the hi part of the address is valid.*/ 157 BF_xx = 0x04, /* future extension.*/ 158 BF_EOB = 0x02, /* set if finished, but not yet free.*/ 159 BF_PAUSE = 0x01, /* pause stream at buffer end.*/ 160 BF_ZERO = 0x00, /* no flags (init).*/ 161 }; 162 163 /* 164 * Stream Flags definitions 165 */ 166 enum stream_flags { 167 SF_ZERO = 0x00000000, /* no flags (stream invalid). */ 168 SF_VALID = 0x10000000, /* the stream has a valid DMA_conf 169 * info (setstreamformat). */ 170 SF_XRUN = 0x20000000, /* the stream is un x-run state. */ 171 SF_START = 0x40000000, /* the DMA is running.*/ 172 SF_ASIO = 0x80000000, /* ASIO.*/ 173 }; 174 175 176 #define MASK_SPL_COUNT_HI 0x00FFFFFF /* 4 MSBits are status bits */ 177 #define PSTATE_OFFSET 28 /* 4 MSBits are status bits */ 178 179 180 #define MASK_STREAM_HAS_MAPPING (1L << 12) 181 #define MASK_STREAM_IS_ASIO (1L << 9) 182 #define STREAM_FMT_OFFSET 10 /* the stream fmt bits start at the 10th 183 * bit in the command word. */ 184 185 #define STREAM_FMT_16b 0x02 186 #define STREAM_FMT_intel 0x01 187 188 #define FREQ_FIELD_OFFSET 15 /* offset of the freq field in the response 189 * word */ 190 191 #define BUFF_FLAGS_OFFSET 24 /* offset of the buffer flags in the 192 * response word. */ 193 #define MASK_DATA_SIZE 0x00FFFFFF /* this must match the field size of 194 * datasize in the buffer_t structure. */ 195 196 #define MASK_BUFFER_ID 0xFF /* the cancel command awaits a buffer ID, 197 * may be 0xFF for "current". */ 198 199 200 /* code adapted from PcxErr_e.h */ 201 202 /* Bits masks */ 203 204 #define ERROR_MASK 0x8000 205 206 #define SOURCE_MASK 0x7800 207 208 #define E_SOURCE_BOARD 0x4000 /* 8 >> 1 */ 209 #define E_SOURCE_DRV 0x2000 /* 4 >> 1 */ 210 #define E_SOURCE_API 0x1000 /* 2 >> 1 */ 211 /* Error tools */ 212 #define E_SOURCE_TOOLS 0x0800 /* 1 >> 1 */ 213 /* Error pcxaudio */ 214 #define E_SOURCE_AUDIO 0x1800 /* 3 >> 1 */ 215 /* Error virtual pcx */ 216 #define E_SOURCE_VPCX 0x2800 /* 5 >> 1 */ 217 /* Error dispatcher */ 218 #define E_SOURCE_DISPATCHER 0x3000 /* 6 >> 1 */ 219 /* Error from CobraNet firmware */ 220 #define E_SOURCE_COBRANET 0x3800 /* 7 >> 1 */ 221 222 #define E_SOURCE_USER 0x7800 223 224 #define CLASS_MASK 0x0700 225 226 #define CODE_MASK 0x00FF 227 228 /* Bits values */ 229 230 /* Values for the error/warning bit */ 231 #define ERROR_VALUE 0x8000 232 #define WARNING_VALUE 0x0000 233 234 /* Class values */ 235 #define E_CLASS_GENERAL 0x0000 236 #define E_CLASS_INVALID_CMD 0x0100 237 #define E_CLASS_INVALID_STD_OBJECT 0x0200 238 #define E_CLASS_RSRC_IMPOSSIBLE 0x0300 239 #define E_CLASS_WRONG_CONTEXT 0x0400 240 #define E_CLASS_BAD_SPECIFIC_PARAMETER 0x0500 241 #define E_CLASS_REAL_TIME_ERROR 0x0600 242 #define E_CLASS_DIRECTSHOW 0x0700 243 #define E_CLASS_FREE 0x0700 244 245 246 /* Complete DRV error code for the general class */ 247 #define ED_GN (ERROR_VALUE | E_SOURCE_DRV | E_CLASS_GENERAL) 248 #define ED_CONCURRENCY (ED_GN | 0x01) 249 #define ED_DSP_CRASHED (ED_GN | 0x02) 250 #define ED_UNKNOWN_BOARD (ED_GN | 0x03) 251 #define ED_NOT_INSTALLED (ED_GN | 0x04) 252 #define ED_CANNOT_OPEN_SVC_MANAGER (ED_GN | 0x05) 253 #define ED_CANNOT_READ_REGISTRY (ED_GN | 0x06) 254 #define ED_DSP_VERSION_MISMATCH (ED_GN | 0x07) 255 #define ED_UNAVAILABLE_FEATURE (ED_GN | 0x08) 256 #define ED_CANCELLED (ED_GN | 0x09) 257 #define ED_NO_RESPONSE_AT_IRQA (ED_GN | 0x10) 258 #define ED_INVALID_ADDRESS (ED_GN | 0x11) 259 #define ED_DSP_CORRUPTED (ED_GN | 0x12) 260 #define ED_PENDING_OPERATION (ED_GN | 0x13) 261 #define ED_NET_ALLOCATE_MEMORY_IMPOSSIBLE (ED_GN | 0x14) 262 #define ED_NET_REGISTER_ERROR (ED_GN | 0x15) 263 #define ED_NET_THREAD_ERROR (ED_GN | 0x16) 264 #define ED_NET_OPEN_ERROR (ED_GN | 0x17) 265 #define ED_NET_CLOSE_ERROR (ED_GN | 0x18) 266 #define ED_NET_NO_MORE_PACKET (ED_GN | 0x19) 267 #define ED_NET_NO_MORE_BUFFER (ED_GN | 0x1A) 268 #define ED_NET_SEND_ERROR (ED_GN | 0x1B) 269 #define ED_NET_RECEIVE_ERROR (ED_GN | 0x1C) 270 #define ED_NET_WRONG_MSG_SIZE (ED_GN | 0x1D) 271 #define ED_NET_WAIT_ERROR (ED_GN | 0x1E) 272 #define ED_NET_EEPROM_ERROR (ED_GN | 0x1F) 273 #define ED_INVALID_RS232_COM_NUMBER (ED_GN | 0x20) 274 #define ED_INVALID_RS232_INIT (ED_GN | 0x21) 275 #define ED_FILE_ERROR (ED_GN | 0x22) 276 #define ED_INVALID_GPIO_CMD (ED_GN | 0x23) 277 #define ED_RS232_ALREADY_OPENED (ED_GN | 0x24) 278 #define ED_RS232_NOT_OPENED (ED_GN | 0x25) 279 #define ED_GPIO_ALREADY_OPENED (ED_GN | 0x26) 280 #define ED_GPIO_NOT_OPENED (ED_GN | 0x27) 281 #define ED_REGISTRY_ERROR (ED_GN | 0x28) /* <- NCX */ 282 #define ED_INVALID_SERVICE (ED_GN | 0x29) /* <- NCX */ 283 284 #define ED_READ_FILE_ALREADY_OPENED (ED_GN | 0x2a) /* <- Decalage 285 * pour RCX 286 * (old 0x28) 287 * */ 288 #define ED_READ_FILE_INVALID_COMMAND (ED_GN | 0x2b) /* ~ */ 289 #define ED_READ_FILE_INVALID_PARAMETER (ED_GN | 0x2c) /* ~ */ 290 #define ED_READ_FILE_ALREADY_CLOSED (ED_GN | 0x2d) /* ~ */ 291 #define ED_READ_FILE_NO_INFORMATION (ED_GN | 0x2e) /* ~ */ 292 #define ED_READ_FILE_INVALID_HANDLE (ED_GN | 0x2f) /* ~ */ 293 #define ED_READ_FILE_END_OF_FILE (ED_GN | 0x30) /* ~ */ 294 #define ED_READ_FILE_ERROR (ED_GN | 0x31) /* ~ */ 295 296 #define ED_DSP_CRASHED_EXC_DSPSTACK_OVERFLOW (ED_GN | 0x32) /* <- Decalage pour 297 * PCX (old 0x14) */ 298 #define ED_DSP_CRASHED_EXC_SYSSTACK_OVERFLOW (ED_GN | 0x33) /* ~ */ 299 #define ED_DSP_CRASHED_EXC_ILLEGAL (ED_GN | 0x34) /* ~ */ 300 #define ED_DSP_CRASHED_EXC_TIMER_REENTRY (ED_GN | 0x35) /* ~ */ 301 #define ED_DSP_CRASHED_EXC_FATAL_ERROR (ED_GN | 0x36) /* ~ */ 302 303 #define ED_FLASH_PCCARD_NOT_PRESENT (ED_GN | 0x37) 304 305 #define ED_NO_CURRENT_CLOCK (ED_GN | 0x38) 306 307 /* Complete DRV error code for real time class */ 308 #define ED_RT (ERROR_VALUE | E_SOURCE_DRV | E_CLASS_REAL_TIME_ERROR) 309 #define ED_DSP_TIMED_OUT (ED_RT | 0x01) 310 #define ED_DSP_CHK_TIMED_OUT (ED_RT | 0x02) 311 #define ED_STREAM_OVERRUN (ED_RT | 0x03) 312 #define ED_DSP_BUSY (ED_RT | 0x04) 313 #define ED_DSP_SEMAPHORE_TIME_OUT (ED_RT | 0x05) 314 #define ED_BOARD_TIME_OUT (ED_RT | 0x06) 315 #define ED_XILINX_ERROR (ED_RT | 0x07) 316 #define ED_COBRANET_ITF_NOT_RESPONDING (ED_RT | 0x08) 317 318 /* Complete BOARD error code for the invaid standard object class */ 319 #define EB_ISO (ERROR_VALUE | E_SOURCE_BOARD | \ 320 E_CLASS_INVALID_STD_OBJECT) 321 #define EB_INVALID_EFFECT (EB_ISO | 0x00) 322 #define EB_INVALID_PIPE (EB_ISO | 0x40) 323 #define EB_INVALID_STREAM (EB_ISO | 0x80) 324 #define EB_INVALID_AUDIO (EB_ISO | 0xC0) 325 326 /* Complete BOARD error code for impossible resource allocation class */ 327 #define EB_RI (ERROR_VALUE | E_SOURCE_BOARD | E_CLASS_RSRC_IMPOSSIBLE) 328 #define EB_ALLOCATE_ALL_STREAM_TRANSFERT_BUFFERS_IMPOSSIBLE (EB_RI | 0x01) 329 #define EB_ALLOCATE_PIPE_SAMPLE_BUFFER_IMPOSSIBLE (EB_RI | 0x02) 330 331 #define EB_ALLOCATE_MEM_STREAM_IMPOSSIBLE \ 332 EB_ALLOCATE_ALL_STREAM_TRANSFERT_BUFFERS_IMPOSSIBLE 333 #define EB_ALLOCATE_MEM_PIPE_IMPOSSIBLE \ 334 EB_ALLOCATE_PIPE_SAMPLE_BUFFER_IMPOSSIBLE 335 336 #define EB_ALLOCATE_DIFFERED_CMD_IMPOSSIBLE (EB_RI | 0x03) 337 #define EB_TOO_MANY_DIFFERED_CMD (EB_RI | 0x04) 338 #define EB_RBUFFERS_TABLE_OVERFLOW (EB_RI | 0x05) 339 #define EB_ALLOCATE_EFFECTS_IMPOSSIBLE (EB_RI | 0x08) 340 #define EB_ALLOCATE_EFFECT_POS_IMPOSSIBLE (EB_RI | 0x09) 341 #define EB_RBUFFER_NOT_AVAILABLE (EB_RI | 0x0A) 342 #define EB_ALLOCATE_CONTEXT_LIII_IMPOSSIBLE (EB_RI | 0x0B) 343 #define EB_STATUS_DIALOG_IMPOSSIBLE (EB_RI | 0x1D) 344 #define EB_CONTROL_CMD_IMPOSSIBLE (EB_RI | 0x1E) 345 #define EB_STATUS_SEND_IMPOSSIBLE (EB_RI | 0x1F) 346 #define EB_ALLOCATE_PIPE_IMPOSSIBLE (EB_RI | 0x40) 347 #define EB_ALLOCATE_STREAM_IMPOSSIBLE (EB_RI | 0x80) 348 #define EB_ALLOCATE_AUDIO_IMPOSSIBLE (EB_RI | 0xC0) 349 350 /* Complete BOARD error code for wrong call context class */ 351 #define EB_WCC (ERROR_VALUE | E_SOURCE_BOARD | E_CLASS_WRONG_CONTEXT) 352 #define EB_CMD_REFUSED (EB_WCC | 0x00) 353 #define EB_START_STREAM_REFUSED (EB_WCC | 0xFC) 354 #define EB_SPC_REFUSED (EB_WCC | 0xFD) 355 #define EB_CSN_REFUSED (EB_WCC | 0xFE) 356 #define EB_CSE_REFUSED (EB_WCC | 0xFF) 357 358 359 360 361 #endif /* LX_DEFS_H */ 362