2 * Copyright (c) by Jaroslav Kysela <perex@perex.cz>,
4 * Definitions for EMU10K1 (SB Live!) chips
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #ifndef _UAPI__SOUND_EMU10K1_H
23 #define _UAPI__SOUND_EMU10K1_H
25 #include <linux/types.h>
26 #include <sound/asound.h>
32 #define EMU10K1_CARD_CREATIVE 0x00000000
33 #define EMU10K1_CARD_EMUAPS 0x00000001
35 #define EMU10K1_FX8010_PCM_COUNT 8
38 #define iMAC0 0x00 /* R = A + (X * Y >> 31) ; saturation */
39 #define iMAC1 0x01 /* R = A + (-X * Y >> 31) ; saturation */
40 #define iMAC2 0x02 /* R = A + (X * Y >> 31) ; wraparound */
41 #define iMAC3 0x03 /* R = A + (-X * Y >> 31) ; wraparound */
42 #define iMACINT0 0x04 /* R = A + X * Y ; saturation */
43 #define iMACINT1 0x05 /* R = A + X * Y ; wraparound (31-bit) */
44 #define iACC3 0x06 /* R = A + X + Y ; saturation */
45 #define iMACMV 0x07 /* R = A, acc += X * Y >> 31 */
46 #define iANDXOR 0x08 /* R = (A & X) ^ Y */
47 #define iTSTNEG 0x09 /* R = (A >= Y) ? X : ~X */
48 #define iLIMITGE 0x0a /* R = (A >= Y) ? X : Y */
49 #define iLIMITLT 0x0b /* R = (A < Y) ? X : Y */
50 #define iLOG 0x0c /* R = linear_data, A (log_data), X (max_exp), Y (format_word) */
51 #define iEXP 0x0d /* R = log_data, A (linear_data), X (max_exp), Y (format_word) */
52 #define iINTERP 0x0e /* R = A + (X * (Y - A) >> 31) ; saturation */
53 #define iSKIP 0x0f /* R = A (cc_reg), X (count), Y (cc_test) */
56 #define FXBUS(x) (0x00 + (x)) /* x = 0x00 - 0x0f */
57 #define EXTIN(x) (0x10 + (x)) /* x = 0x00 - 0x0f */
58 #define EXTOUT(x) (0x20 + (x)) /* x = 0x00 - 0x0f physical outs -> FXWC low 16 bits */
59 #define FXBUS2(x) (0x30 + (x)) /* x = 0x00 - 0x0f copies of fx buses for capture -> FXWC high 16 bits */
60 /* NB: 0x31 and 0x32 are shared with Center/LFE on SB live 5.1 */
62 #define C_00000000 0x40
63 #define C_00000001 0x41
64 #define C_00000002 0x42
65 #define C_00000003 0x43
66 #define C_00000004 0x44
67 #define C_00000008 0x45
68 #define C_00000010 0x46
69 #define C_00000020 0x47
70 #define C_00000100 0x48
71 #define C_00010000 0x49
72 #define C_00080000 0x4a
73 #define C_10000000 0x4b
74 #define C_20000000 0x4c
75 #define C_40000000 0x4d
76 #define C_80000000 0x4e
77 #define C_7fffffff 0x4f
78 #define C_ffffffff 0x50
79 #define C_fffffffe 0x51
80 #define C_c0000000 0x52
81 #define C_4f1bbcdc 0x53
82 #define C_5a7ef9db 0x54
83 #define C_00100000 0x55 /* ?? */
84 #define GPR_ACCU 0x56 /* ACCUM, accumulator */
85 #define GPR_COND 0x57 /* CCR, condition register */
86 #define GPR_NOISE0 0x58 /* noise source */
87 #define GPR_NOISE1 0x59 /* noise source */
88 #define GPR_IRQ 0x5a /* IRQ register */
89 #define GPR_DBAC 0x5b /* TRAM Delay Base Address Counter */
90 #define GPR(x) (FXGPREGBASE + (x)) /* free GPRs: x = 0x00 - 0xff */
91 #define ITRAM_DATA(x) (TANKMEMDATAREGBASE + 0x00 + (x)) /* x = 0x00 - 0x7f */
92 #define ETRAM_DATA(x) (TANKMEMDATAREGBASE + 0x80 + (x)) /* x = 0x00 - 0x1f */
93 #define ITRAM_ADDR(x) (TANKMEMADDRREGBASE + 0x00 + (x)) /* x = 0x00 - 0x7f */
94 #define ETRAM_ADDR(x) (TANKMEMADDRREGBASE + 0x80 + (x)) /* x = 0x00 - 0x1f */
96 #define A_ITRAM_DATA(x) (TANKMEMDATAREGBASE + 0x00 + (x)) /* x = 0x00 - 0xbf */
97 #define A_ETRAM_DATA(x) (TANKMEMDATAREGBASE + 0xc0 + (x)) /* x = 0x00 - 0x3f */
98 #define A_ITRAM_ADDR(x) (TANKMEMADDRREGBASE + 0x00 + (x)) /* x = 0x00 - 0xbf */
99 #define A_ETRAM_ADDR(x) (TANKMEMADDRREGBASE + 0xc0 + (x)) /* x = 0x00 - 0x3f */
100 #define A_ITRAM_CTL(x) (A_TANKMEMCTLREGBASE + 0x00 + (x)) /* x = 0x00 - 0xbf */
101 #define A_ETRAM_CTL(x) (A_TANKMEMCTLREGBASE + 0xc0 + (x)) /* x = 0x00 - 0x3f */
103 #define A_FXBUS(x) (0x00 + (x)) /* x = 0x00 - 0x3f FX buses */
104 #define A_EXTIN(x) (0x40 + (x)) /* x = 0x00 - 0x0f physical ins */
105 #define A_P16VIN(x) (0x50 + (x)) /* x = 0x00 - 0x0f p16v ins (A2 only) "EMU32 inputs" */
106 #define A_EXTOUT(x) (0x60 + (x)) /* x = 0x00 - 0x1f physical outs -> A_FXWC1 0x79-7f unknown */
107 #define A_FXBUS2(x) (0x80 + (x)) /* x = 0x00 - 0x1f extra outs used for EFX capture -> A_FXWC2 */
108 #define A_EMU32OUTH(x) (0xa0 + (x)) /* x = 0x00 - 0x0f "EMU32_OUT_10 - _1F" - ??? */
109 #define A_EMU32OUTL(x) (0xb0 + (x)) /* x = 0x00 - 0x0f "EMU32_OUT_1 - _F" - ??? */
110 #define A3_EMU32IN(x) (0x160 + (x)) /* x = 0x00 - 0x3f "EMU32_IN_00 - _3F" - Only when .device = 0x0008 */
111 #define A3_EMU32OUT(x) (0x1E0 + (x)) /* x = 0x00 - 0x0f "EMU32_OUT_00 - _3F" - Only when .device = 0x0008 */
112 #define A_GPR(x) (A_FXGPREGBASE + (x))
114 /* cc_reg constants */
115 #define CC_REG_NORMALIZED C_00000001
116 #define CC_REG_BORROW C_00000002
117 #define CC_REG_MINUS C_00000004
118 #define CC_REG_ZERO C_00000008
119 #define CC_REG_SATURATE C_00000010
120 #define CC_REG_NONZERO C_00000100
123 #define FXBUS_PCM_LEFT 0x00
124 #define FXBUS_PCM_RIGHT 0x01
125 #define FXBUS_PCM_LEFT_REAR 0x02
126 #define FXBUS_PCM_RIGHT_REAR 0x03
127 #define FXBUS_MIDI_LEFT 0x04
128 #define FXBUS_MIDI_RIGHT 0x05
129 #define FXBUS_PCM_CENTER 0x06
130 #define FXBUS_PCM_LFE 0x07
131 #define FXBUS_PCM_LEFT_FRONT 0x08
132 #define FXBUS_PCM_RIGHT_FRONT 0x09
133 #define FXBUS_MIDI_REVERB 0x0c
134 #define FXBUS_MIDI_CHORUS 0x0d
135 #define FXBUS_PCM_LEFT_SIDE 0x0e
136 #define FXBUS_PCM_RIGHT_SIDE 0x0f
137 #define FXBUS_PT_LEFT 0x14
138 #define FXBUS_PT_RIGHT 0x15
141 #define EXTIN_AC97_L 0x00 /* AC'97 capture channel - left */
142 #define EXTIN_AC97_R 0x01 /* AC'97 capture channel - right */
143 #define EXTIN_SPDIF_CD_L 0x02 /* internal S/PDIF CD - onboard - left */
144 #define EXTIN_SPDIF_CD_R 0x03 /* internal S/PDIF CD - onboard - right */
145 #define EXTIN_ZOOM_L 0x04 /* Zoom Video I2S - left */
146 #define EXTIN_ZOOM_R 0x05 /* Zoom Video I2S - right */
147 #define EXTIN_TOSLINK_L 0x06 /* LiveDrive - TOSLink Optical - left */
148 #define EXTIN_TOSLINK_R 0x07 /* LiveDrive - TOSLink Optical - right */
149 #define EXTIN_LINE1_L 0x08 /* LiveDrive - Line/Mic 1 - left */
150 #define EXTIN_LINE1_R 0x09 /* LiveDrive - Line/Mic 1 - right */
151 #define EXTIN_COAX_SPDIF_L 0x0a /* LiveDrive - Coaxial S/PDIF - left */
152 #define EXTIN_COAX_SPDIF_R 0x0b /* LiveDrive - Coaxial S/PDIF - right */
153 #define EXTIN_LINE2_L 0x0c /* LiveDrive - Line/Mic 2 - left */
154 #define EXTIN_LINE2_R 0x0d /* LiveDrive - Line/Mic 2 - right */
157 #define EXTOUT_AC97_L 0x00 /* AC'97 playback channel - left */
158 #define EXTOUT_AC97_R 0x01 /* AC'97 playback channel - right */
159 #define EXTOUT_TOSLINK_L 0x02 /* LiveDrive - TOSLink Optical - left */
160 #define EXTOUT_TOSLINK_R 0x03 /* LiveDrive - TOSLink Optical - right */
161 #define EXTOUT_AC97_CENTER 0x04 /* SB Live 5.1 - center */
162 #define EXTOUT_AC97_LFE 0x05 /* SB Live 5.1 - LFE */
163 #define EXTOUT_HEADPHONE_L 0x06 /* LiveDrive - Headphone - left */
164 #define EXTOUT_HEADPHONE_R 0x07 /* LiveDrive - Headphone - right */
165 #define EXTOUT_REAR_L 0x08 /* Rear channel - left */
166 #define EXTOUT_REAR_R 0x09 /* Rear channel - right */
167 #define EXTOUT_ADC_CAP_L 0x0a /* ADC Capture buffer - left */
168 #define EXTOUT_ADC_CAP_R 0x0b /* ADC Capture buffer - right */
169 #define EXTOUT_MIC_CAP 0x0c /* MIC Capture buffer */
170 #define EXTOUT_AC97_REAR_L 0x0d /* SB Live 5.1 (c) 2003 - Rear Left */
171 #define EXTOUT_AC97_REAR_R 0x0e /* SB Live 5.1 (c) 2003 - Rear Right */
172 #define EXTOUT_ACENTER 0x11 /* Analog Center */
173 #define EXTOUT_ALFE 0x12 /* Analog LFE */
176 #define A_EXTIN_AC97_L 0x00 /* AC'97 capture channel - left */
177 #define A_EXTIN_AC97_R 0x01 /* AC'97 capture channel - right */
178 #define A_EXTIN_SPDIF_CD_L 0x02 /* digital CD left */
179 #define A_EXTIN_SPDIF_CD_R 0x03 /* digital CD left */
180 #define A_EXTIN_OPT_SPDIF_L 0x04 /* audigy drive Optical SPDIF - left */
181 #define A_EXTIN_OPT_SPDIF_R 0x05 /* right */
182 #define A_EXTIN_LINE2_L 0x08 /* audigy drive line2/mic2 - left */
183 #define A_EXTIN_LINE2_R 0x09 /* right */
184 #define A_EXTIN_ADC_L 0x0a /* Philips ADC - left */
185 #define A_EXTIN_ADC_R 0x0b /* right */
186 #define A_EXTIN_AUX2_L 0x0c /* audigy drive aux2 - left */
187 #define A_EXTIN_AUX2_R 0x0d /* - right */
189 /* Audigiy Outputs */
190 #define A_EXTOUT_FRONT_L 0x00 /* digital front left */
191 #define A_EXTOUT_FRONT_R 0x01 /* right */
192 #define A_EXTOUT_CENTER 0x02 /* digital front center */
193 #define A_EXTOUT_LFE 0x03 /* digital front lfe */
194 #define A_EXTOUT_HEADPHONE_L 0x04 /* headphone audigy drive left */
195 #define A_EXTOUT_HEADPHONE_R 0x05 /* right */
196 #define A_EXTOUT_REAR_L 0x06 /* digital rear left */
197 #define A_EXTOUT_REAR_R 0x07 /* right */
198 #define A_EXTOUT_AFRONT_L 0x08 /* analog front left */
199 #define A_EXTOUT_AFRONT_R 0x09 /* right */
200 #define A_EXTOUT_ACENTER 0x0a /* analog center */
201 #define A_EXTOUT_ALFE 0x0b /* analog LFE */
202 #define A_EXTOUT_ASIDE_L 0x0c /* analog side left - Audigy 2 ZS */
203 #define A_EXTOUT_ASIDE_R 0x0d /* right - Audigy 2 ZS */
204 #define A_EXTOUT_AREAR_L 0x0e /* analog rear left */
205 #define A_EXTOUT_AREAR_R 0x0f /* right */
206 #define A_EXTOUT_AC97_L 0x10 /* AC97 left (front) */
207 #define A_EXTOUT_AC97_R 0x11 /* right */
208 #define A_EXTOUT_ADC_CAP_L 0x16 /* ADC capture buffer left */
209 #define A_EXTOUT_ADC_CAP_R 0x17 /* right */
210 #define A_EXTOUT_MIC_CAP 0x18 /* Mic capture buffer */
212 /* Audigy constants */
213 #define A_C_00000000 0xc0
214 #define A_C_00000001 0xc1
215 #define A_C_00000002 0xc2
216 #define A_C_00000003 0xc3
217 #define A_C_00000004 0xc4
218 #define A_C_00000008 0xc5
219 #define A_C_00000010 0xc6
220 #define A_C_00000020 0xc7
221 #define A_C_00000100 0xc8
222 #define A_C_00010000 0xc9
223 #define A_C_00000800 0xca
224 #define A_C_10000000 0xcb
225 #define A_C_20000000 0xcc
226 #define A_C_40000000 0xcd
227 #define A_C_80000000 0xce
228 #define A_C_7fffffff 0xcf
229 #define A_C_ffffffff 0xd0
230 #define A_C_fffffffe 0xd1
231 #define A_C_c0000000 0xd2
232 #define A_C_4f1bbcdc 0xd3
233 #define A_C_5a7ef9db 0xd4
234 #define A_C_00100000 0xd5
235 #define A_GPR_ACCU 0xd6 /* ACCUM, accumulator */
236 #define A_GPR_COND 0xd7 /* CCR, condition register */
237 #define A_GPR_NOISE0 0xd8 /* noise source */
238 #define A_GPR_NOISE1 0xd9 /* noise source */
239 #define A_GPR_IRQ 0xda /* IRQ register */
240 #define A_GPR_DBAC 0xdb /* TRAM Delay Base Address Counter - internal */
241 #define A_GPR_DBACE 0xde /* TRAM Delay Base Address Counter - external */
243 /* definitions for debug register */
244 #define EMU10K1_DBG_ZC 0x80000000 /* zero tram counter */
245 #define EMU10K1_DBG_SATURATION_OCCURED 0x02000000 /* saturation control */
246 #define EMU10K1_DBG_SATURATION_ADDR 0x01ff0000 /* saturation address */
247 #define EMU10K1_DBG_SINGLE_STEP 0x00008000 /* single step mode */
248 #define EMU10K1_DBG_STEP 0x00004000 /* start single step */
249 #define EMU10K1_DBG_CONDITION_CODE 0x00003e00 /* condition code */
250 #define EMU10K1_DBG_SINGLE_STEP_ADDR 0x000001ff /* single step address */
252 /* tank memory address line */
254 #define TANKMEMADDRREG_ADDR_MASK 0x000fffff /* 20 bit tank address field */
255 #define TANKMEMADDRREG_CLEAR 0x00800000 /* Clear tank memory */
256 #define TANKMEMADDRREG_ALIGN 0x00400000 /* Align read or write relative to tank access */
257 #define TANKMEMADDRREG_WRITE 0x00200000 /* Write to tank memory */
258 #define TANKMEMADDRREG_READ 0x00100000 /* Read from tank memory */
261 struct snd_emu10k1_fx8010_info
{
262 unsigned int internal_tram_size
; /* in samples */
263 unsigned int external_tram_size
; /* in samples */
264 char fxbus_names
[16][32]; /* names of FXBUSes */
265 char extin_names
[16][32]; /* names of external inputs */
266 char extout_names
[32][32]; /* names of external outputs */
267 unsigned int gpr_controls
; /* count of GPR controls */
270 #define EMU10K1_GPR_TRANSLATION_NONE 0
271 #define EMU10K1_GPR_TRANSLATION_TABLE100 1
272 #define EMU10K1_GPR_TRANSLATION_BASS 2
273 #define EMU10K1_GPR_TRANSLATION_TREBLE 3
274 #define EMU10K1_GPR_TRANSLATION_ONOFF 4
276 struct snd_emu10k1_fx8010_control_gpr
{
277 struct snd_ctl_elem_id id
; /* full control ID definition */
278 unsigned int vcount
; /* visible count */
279 unsigned int count
; /* count of GPR (1..16) */
280 unsigned short gpr
[32]; /* GPR number(s) */
281 unsigned int value
[32]; /* initial values */
282 unsigned int min
; /* minimum range */
283 unsigned int max
; /* maximum range */
284 unsigned int translation
; /* translation type (EMU10K1_GPR_TRANSLATION*) */
285 const unsigned int *tlv
;
288 /* old ABI without TLV support */
289 struct snd_emu10k1_fx8010_control_old_gpr
{
290 struct snd_ctl_elem_id id
;
293 unsigned short gpr
[32];
294 unsigned int value
[32];
297 unsigned int translation
;
300 struct snd_emu10k1_fx8010_code
{
303 DECLARE_BITMAP(gpr_valid
, 0x200); /* bitmask of valid initializers */
304 __u32 __user
*gpr_map
; /* initializers */
306 unsigned int gpr_add_control_count
; /* count of GPR controls to add/replace */
307 struct snd_emu10k1_fx8010_control_gpr __user
*gpr_add_controls
; /* GPR controls to add/replace */
309 unsigned int gpr_del_control_count
; /* count of GPR controls to remove */
310 struct snd_ctl_elem_id __user
*gpr_del_controls
; /* IDs of GPR controls to remove */
312 unsigned int gpr_list_control_count
; /* count of GPR controls to list */
313 unsigned int gpr_list_control_total
; /* total count of GPR controls */
314 struct snd_emu10k1_fx8010_control_gpr __user
*gpr_list_controls
; /* listed GPR controls */
316 DECLARE_BITMAP(tram_valid
, 0x100); /* bitmask of valid initializers */
317 __u32 __user
*tram_data_map
; /* data initializers */
318 __u32 __user
*tram_addr_map
; /* map initializers */
320 DECLARE_BITMAP(code_valid
, 1024); /* bitmask of valid instructions */
321 __u32 __user
*code
; /* one instruction - 64 bits */
324 struct snd_emu10k1_fx8010_tram
{
325 unsigned int address
; /* 31.bit == 1 -> external TRAM */
326 unsigned int size
; /* size in samples (4 bytes) */
327 unsigned int *samples
; /* pointer to samples (20-bit) */
328 /* NULL->clear memory */
331 struct snd_emu10k1_fx8010_pcm_rec
{
332 unsigned int substream
; /* substream number */
333 unsigned int res1
; /* reserved */
334 unsigned int channels
; /* 16-bit channels count, zero = remove this substream */
335 unsigned int tram_start
; /* ring buffer position in TRAM (in samples) */
336 unsigned int buffer_size
; /* count of buffered samples */
337 unsigned short gpr_size
; /* GPR containing size of ringbuffer in samples (host) */
338 unsigned short gpr_ptr
; /* GPR containing current pointer in the ring buffer (host = reset, FX8010) */
339 unsigned short gpr_count
; /* GPR containing count of samples between two interrupts (host) */
340 unsigned short gpr_tmpcount
; /* GPR containing current count of samples to interrupt (host = set, FX8010) */
341 unsigned short gpr_trigger
; /* GPR containing trigger (activate) information (host) */
342 unsigned short gpr_running
; /* GPR containing info if PCM is running (FX8010) */
343 unsigned char pad
; /* reserved */
344 unsigned char etram
[32]; /* external TRAM address & data (one per channel) */
345 unsigned int res2
; /* reserved */
348 #define SNDRV_EMU10K1_VERSION SNDRV_PROTOCOL_VERSION(1, 0, 1)
350 #define SNDRV_EMU10K1_IOCTL_INFO _IOR ('H', 0x10, struct snd_emu10k1_fx8010_info)
351 #define SNDRV_EMU10K1_IOCTL_CODE_POKE _IOW ('H', 0x11, struct snd_emu10k1_fx8010_code)
352 #define SNDRV_EMU10K1_IOCTL_CODE_PEEK _IOWR('H', 0x12, struct snd_emu10k1_fx8010_code)
353 #define SNDRV_EMU10K1_IOCTL_TRAM_SETUP _IOW ('H', 0x20, int)
354 #define SNDRV_EMU10K1_IOCTL_TRAM_POKE _IOW ('H', 0x21, struct snd_emu10k1_fx8010_tram)
355 #define SNDRV_EMU10K1_IOCTL_TRAM_PEEK _IOWR('H', 0x22, struct snd_emu10k1_fx8010_tram)
356 #define SNDRV_EMU10K1_IOCTL_PCM_POKE _IOW ('H', 0x30, struct snd_emu10k1_fx8010_pcm_rec)
357 #define SNDRV_EMU10K1_IOCTL_PCM_PEEK _IOWR('H', 0x31, struct snd_emu10k1_fx8010_pcm_rec)
358 #define SNDRV_EMU10K1_IOCTL_PVERSION _IOR ('H', 0x40, int)
359 #define SNDRV_EMU10K1_IOCTL_STOP _IO ('H', 0x80)
360 #define SNDRV_EMU10K1_IOCTL_CONTINUE _IO ('H', 0x81)
361 #define SNDRV_EMU10K1_IOCTL_ZERO_TRAM_COUNTER _IO ('H', 0x82)
362 #define SNDRV_EMU10K1_IOCTL_SINGLE_STEP _IOW ('H', 0x83, int)
363 #define SNDRV_EMU10K1_IOCTL_DBG_READ _IOR ('H', 0x84, int)
365 /* typedefs for compatibility to user-space */
366 typedef struct snd_emu10k1_fx8010_info emu10k1_fx8010_info_t
;
367 typedef struct snd_emu10k1_fx8010_control_gpr emu10k1_fx8010_control_gpr_t
;
368 typedef struct snd_emu10k1_fx8010_code emu10k1_fx8010_code_t
;
369 typedef struct snd_emu10k1_fx8010_tram emu10k1_fx8010_tram_t
;
370 typedef struct snd_emu10k1_fx8010_pcm_rec emu10k1_fx8010_pcm_t
;
372 #endif /* _UAPI__SOUND_EMU10K1_H */