1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 #ifndef __SOUND_SB_H 3 #define __SOUND_SB_H 4 5 /* 6 * Header file for SoundBlaster cards 7 * Copyright (c) by Jaroslav Kysela <perex@perex.cz> 8 */ 9 10 #include <sound/pcm.h> 11 #include <sound/rawmidi.h> 12 #include <linux/interrupt.h> 13 #include <linux/io.h> 14 15 enum sb_hw_type { 16 SB_HW_AUTO, 17 SB_HW_10, 18 SB_HW_20, 19 SB_HW_201, 20 SB_HW_PRO, 21 SB_HW_JAZZ16, /* Media Vision Jazz16 */ 22 SB_HW_16, 23 SB_HW_16CSP, /* SB16 with CSP chip */ 24 SB_HW_ALS100, /* Avance Logic ALS100 chip */ 25 SB_HW_ALS4000, /* Avance Logic ALS4000 chip */ 26 SB_HW_DT019X, /* Diamond Tech. DT-019X / Avance Logic ALS-007 */ 27 SB_HW_CS5530, /* Cyrix/NatSemi 5530 VSA1 */ 28 }; 29 30 #define SB_OPEN_PCM 0x01 31 #define SB_OPEN_MIDI_INPUT 0x02 32 #define SB_OPEN_MIDI_OUTPUT 0x04 33 #define SB_OPEN_MIDI_INPUT_TRIGGER 0x08 34 #define SB_OPEN_MIDI_OUTPUT_TRIGGER 0x10 35 36 #define SB_MODE_HALT 0x00 37 #define SB_MODE_PLAYBACK_8 0x01 38 #define SB_MODE_PLAYBACK_16 0x02 39 #define SB_MODE_PLAYBACK (SB_MODE_PLAYBACK_8 | SB_MODE_PLAYBACK_16) 40 #define SB_MODE_CAPTURE_8 0x04 41 #define SB_MODE_CAPTURE_16 0x08 42 #define SB_MODE_CAPTURE (SB_MODE_CAPTURE_8 | SB_MODE_CAPTURE_16) 43 44 #define SB_RATE_LOCK_PLAYBACK 0x10 45 #define SB_RATE_LOCK_CAPTURE 0x20 46 #define SB_RATE_LOCK (SB_RATE_LOCK_PLAYBACK | SB_RATE_LOCK_CAPTURE) 47 48 #define SB_MPU_INPUT 1 49 50 struct snd_sb { 51 unsigned long port; /* base port of DSP chip */ 52 struct resource *res_port; 53 unsigned long mpu_port; /* MPU port for SB DSP 4.0+ */ 54 int irq; /* IRQ number of DSP chip */ 55 int dma8; /* 8-bit DMA */ 56 int dma16; /* 16-bit DMA */ 57 unsigned short version; /* version of DSP chip */ 58 enum sb_hw_type hardware; /* see to SB_HW_XXXX */ 59 60 unsigned long alt_port; /* alternate port (ALS4000) */ 61 struct pci_dev *pci; /* ALS4000 */ 62 63 unsigned int open; /* see to SB_OPEN_XXXX for sb8 */ 64 /* also SNDRV_SB_CSP_MODE_XXX for sb16_csp */ 65 unsigned int mode; /* current mode of stream */ 66 unsigned int force_mode16; /* force 16-bit mode of streams */ 67 unsigned int locked_rate; /* sb16 duplex */ 68 unsigned int playback_format; 69 unsigned int capture_format; 70 struct timer_list midi_timer; 71 unsigned int p_dma_size; 72 unsigned int p_period_size; 73 unsigned int c_dma_size; 74 unsigned int c_period_size; 75 76 spinlock_t mixer_lock; 77 78 char name[32]; 79 80 void *csp; /* used only when CONFIG_SND_SB16_CSP is set */ 81 82 struct snd_card *card; 83 struct snd_pcm *pcm; 84 struct snd_pcm_substream *playback_substream; 85 struct snd_pcm_substream *capture_substream; 86 87 struct snd_rawmidi *rmidi; 88 struct snd_rawmidi_substream *midi_substream_input; 89 struct snd_rawmidi_substream *midi_substream_output; 90 irq_handler_t rmidi_callback; 91 92 spinlock_t reg_lock; 93 spinlock_t open_lock; 94 spinlock_t midi_input_lock; 95 96 struct snd_info_entry *proc_entry; 97 98 #ifdef CONFIG_PM 99 unsigned char saved_regs[0x20]; 100 #endif 101 }; 102 103 /* I/O ports */ 104 105 #define SBP(chip, x) ((chip)->port + s_b_SB_##x) 106 #define SBP1(port, x) ((port) + s_b_SB_##x) 107 108 #define s_b_SB_RESET 0x6 109 #define s_b_SB_READ 0xa 110 #define s_b_SB_WRITE 0xc 111 #define s_b_SB_COMMAND 0xc 112 #define s_b_SB_STATUS 0xc 113 #define s_b_SB_DATA_AVAIL 0xe 114 #define s_b_SB_DATA_AVAIL_16 0xf 115 #define s_b_SB_MIXER_ADDR 0x4 116 #define s_b_SB_MIXER_DATA 0x5 117 #define s_b_SB_OPL3_LEFT 0x0 118 #define s_b_SB_OPL3_RIGHT 0x2 119 #define s_b_SB_OPL3_BOTH 0x8 120 121 #define SB_DSP_OUTPUT 0x14 122 #define SB_DSP_INPUT 0x24 123 #define SB_DSP_BLOCK_SIZE 0x48 124 #define SB_DSP_HI_OUTPUT 0x91 125 #define SB_DSP_HI_INPUT 0x99 126 #define SB_DSP_LO_OUTPUT_AUTO 0x1c 127 #define SB_DSP_LO_INPUT_AUTO 0x2c 128 #define SB_DSP_HI_OUTPUT_AUTO 0x90 129 #define SB_DSP_HI_INPUT_AUTO 0x98 130 #define SB_DSP_IMMED_INT 0xf2 131 #define SB_DSP_GET_VERSION 0xe1 132 #define SB_DSP_SPEAKER_ON 0xd1 133 #define SB_DSP_SPEAKER_OFF 0xd3 134 #define SB_DSP_DMA8_OFF 0xd0 135 #define SB_DSP_DMA8_ON 0xd4 136 #define SB_DSP_DMA8_EXIT 0xda 137 #define SB_DSP_DMA16_OFF 0xd5 138 #define SB_DSP_DMA16_ON 0xd6 139 #define SB_DSP_DMA16_EXIT 0xd9 140 #define SB_DSP_SAMPLE_RATE 0x40 141 #define SB_DSP_SAMPLE_RATE_OUT 0x41 142 #define SB_DSP_SAMPLE_RATE_IN 0x42 143 #define SB_DSP_MONO_8BIT 0xa0 144 #define SB_DSP_MONO_16BIT 0xa4 145 #define SB_DSP_STEREO_8BIT 0xa8 146 #define SB_DSP_STEREO_16BIT 0xac 147 148 #define SB_DSP_MIDI_INPUT_IRQ 0x31 149 #define SB_DSP_MIDI_UART_IRQ 0x35 150 #define SB_DSP_MIDI_OUTPUT 0x38 151 152 #define SB_DSP4_OUT8_AI 0xc6 153 #define SB_DSP4_IN8_AI 0xce 154 #define SB_DSP4_OUT16_AI 0xb6 155 #define SB_DSP4_IN16_AI 0xbe 156 #define SB_DSP4_MODE_UNS_MONO 0x00 157 #define SB_DSP4_MODE_SIGN_MONO 0x10 158 #define SB_DSP4_MODE_UNS_STEREO 0x20 159 #define SB_DSP4_MODE_SIGN_STEREO 0x30 160 161 #define SB_DSP4_OUTPUT 0x3c 162 #define SB_DSP4_INPUT_LEFT 0x3d 163 #define SB_DSP4_INPUT_RIGHT 0x3e 164 165 /* registers for SB 2.0 mixer */ 166 #define SB_DSP20_MASTER_DEV 0x02 167 #define SB_DSP20_PCM_DEV 0x0A 168 #define SB_DSP20_CD_DEV 0x08 169 #define SB_DSP20_FM_DEV 0x06 170 171 /* registers for SB PRO mixer */ 172 #define SB_DSP_MASTER_DEV 0x22 173 #define SB_DSP_PCM_DEV 0x04 174 #define SB_DSP_LINE_DEV 0x2e 175 #define SB_DSP_CD_DEV 0x28 176 #define SB_DSP_FM_DEV 0x26 177 #define SB_DSP_MIC_DEV 0x0a 178 #define SB_DSP_CAPTURE_SOURCE 0x0c 179 #define SB_DSP_CAPTURE_FILT 0x0c 180 #define SB_DSP_PLAYBACK_FILT 0x0e 181 #define SB_DSP_STEREO_SW 0x0e 182 183 #define SB_DSP_MIXS_MIC0 0x00 /* same as MIC */ 184 #define SB_DSP_MIXS_CD 0x01 185 #define SB_DSP_MIXS_MIC 0x02 186 #define SB_DSP_MIXS_LINE 0x03 187 188 /* registers (only for left channel) for SB 16 mixer */ 189 #define SB_DSP4_MASTER_DEV 0x30 190 #define SB_DSP4_BASS_DEV 0x46 191 #define SB_DSP4_TREBLE_DEV 0x44 192 #define SB_DSP4_SYNTH_DEV 0x34 193 #define SB_DSP4_PCM_DEV 0x32 194 #define SB_DSP4_SPEAKER_DEV 0x3b 195 #define SB_DSP4_LINE_DEV 0x38 196 #define SB_DSP4_MIC_DEV 0x3a 197 #define SB_DSP4_OUTPUT_SW 0x3c 198 #define SB_DSP4_CD_DEV 0x36 199 #define SB_DSP4_IGAIN_DEV 0x3f 200 #define SB_DSP4_OGAIN_DEV 0x41 201 #define SB_DSP4_MIC_AGC 0x43 202 203 /* additional registers for SB 16 mixer */ 204 #define SB_DSP4_IRQSETUP 0x80 205 #define SB_DSP4_DMASETUP 0x81 206 #define SB_DSP4_IRQSTATUS 0x82 207 #define SB_DSP4_MPUSETUP 0x84 208 209 #define SB_DSP4_3DSE 0x90 210 211 /* Registers for DT-019x / ALS-007 mixer */ 212 #define SB_DT019X_MASTER_DEV 0x62 213 #define SB_DT019X_PCM_DEV 0x64 214 #define SB_DT019X_SYNTH_DEV 0x66 215 #define SB_DT019X_CD_DEV 0x68 216 #define SB_DT019X_MIC_DEV 0x6a 217 #define SB_DT019X_SPKR_DEV 0x6a 218 #define SB_DT019X_LINE_DEV 0x6e 219 #define SB_DT019X_OUTPUT_SW2 0x4c 220 #define SB_DT019X_CAPTURE_SW 0x6c 221 222 #define SB_DT019X_CAP_CD 0x02 223 #define SB_DT019X_CAP_MIC 0x04 224 #define SB_DT019X_CAP_LINE 0x06 225 #define SB_DT019X_CAP_SYNTH 0x07 226 #define SB_DT019X_CAP_MAIN 0x07 227 228 #define SB_ALS4000_MONO_IO_CTRL 0x4b 229 #define SB_ALS4000_OUT_MIXER_CTRL_2 0x4c 230 #define SB_ALS4000_MIC_IN_GAIN 0x4d 231 #define SB_ALS4000_ANALOG_REFRNC_VOLT_CTRL 0x4e 232 #define SB_ALS4000_FMDAC 0x4f 233 #define SB_ALS4000_3D_SND_FX 0x50 234 #define SB_ALS4000_3D_TIME_DELAY 0x51 235 #define SB_ALS4000_3D_AUTO_MUTE 0x52 236 #define SB_ALS4000_ANALOG_BLOCK_CTRL 0x53 237 #define SB_ALS4000_3D_DELAYLINE_PATTERN 0x54 238 #define SB_ALS4000_CR3_CONFIGURATION 0xc3 /* bit 7 is Digital Loop Enable */ 239 #define SB_ALS4000_QSOUND 0xdb 240 241 /* IRQ setting bitmap */ 242 #define SB_IRQSETUP_IRQ9 0x01 243 #define SB_IRQSETUP_IRQ5 0x02 244 #define SB_IRQSETUP_IRQ7 0x04 245 #define SB_IRQSETUP_IRQ10 0x08 246 247 /* IRQ types */ 248 #define SB_IRQTYPE_8BIT 0x01 249 #define SB_IRQTYPE_16BIT 0x02 250 #define SB_IRQTYPE_MPUIN 0x04 251 #define ALS4K_IRQTYPE_CR1E_DMA 0x20 252 253 /* DMA setting bitmap */ 254 #define SB_DMASETUP_DMA0 0x01 255 #define SB_DMASETUP_DMA1 0x02 256 #define SB_DMASETUP_DMA3 0x08 257 #define SB_DMASETUP_DMA5 0x20 258 #define SB_DMASETUP_DMA6 0x40 259 #define SB_DMASETUP_DMA7 0x80 260 261 /* 262 * 263 */ 264 265 static inline void snd_sb_ack_8bit(struct snd_sb *chip) 266 { 267 inb(SBP(chip, DATA_AVAIL)); 268 } 269 270 static inline void snd_sb_ack_16bit(struct snd_sb *chip) 271 { 272 inb(SBP(chip, DATA_AVAIL_16)); 273 } 274 275 /* sb_common.c */ 276 int snd_sbdsp_command(struct snd_sb *chip, unsigned char val); 277 int snd_sbdsp_get_byte(struct snd_sb *chip); 278 int snd_sbdsp_reset(struct snd_sb *chip); 279 int snd_sbdsp_create(struct snd_card *card, 280 unsigned long port, 281 int irq, 282 irq_handler_t irq_handler, 283 int dma8, int dma16, 284 unsigned short hardware, 285 struct snd_sb **r_chip); 286 /* sb_mixer.c */ 287 void snd_sbmixer_write(struct snd_sb *chip, unsigned char reg, unsigned char data); 288 unsigned char snd_sbmixer_read(struct snd_sb *chip, unsigned char reg); 289 int snd_sbmixer_new(struct snd_sb *chip); 290 #ifdef CONFIG_PM 291 void snd_sbmixer_suspend(struct snd_sb *chip); 292 void snd_sbmixer_resume(struct snd_sb *chip); 293 #else 294 static inline void snd_sbmixer_suspend(struct snd_sb *chip) {} 295 static inline void snd_sbmixer_resume(struct snd_sb *chip) {} 296 #endif 297 298 /* sb8_init.c */ 299 int snd_sb8dsp_pcm(struct snd_sb *chip, int device); 300 /* sb8.c */ 301 irqreturn_t snd_sb8dsp_interrupt(struct snd_sb *chip); 302 int snd_sb8_playback_open(struct snd_pcm_substream *substream); 303 int snd_sb8_capture_open(struct snd_pcm_substream *substream); 304 int snd_sb8_playback_close(struct snd_pcm_substream *substream); 305 int snd_sb8_capture_close(struct snd_pcm_substream *substream); 306 /* midi8.c */ 307 irqreturn_t snd_sb8dsp_midi_interrupt(struct snd_sb *chip); 308 int snd_sb8dsp_midi(struct snd_sb *chip, int device); 309 310 /* sb16_init.c */ 311 int snd_sb16dsp_pcm(struct snd_sb *chip, int device); 312 const struct snd_pcm_ops *snd_sb16dsp_get_pcm_ops(int direction); 313 int snd_sb16dsp_configure(struct snd_sb *chip); 314 /* sb16.c */ 315 irqreturn_t snd_sb16dsp_interrupt(int irq, void *dev_id); 316 317 /* exported mixer stuffs */ 318 enum { 319 SB_MIX_SINGLE, 320 SB_MIX_DOUBLE, 321 SB_MIX_INPUT_SW, 322 SB_MIX_CAPTURE_PRO, 323 SB_MIX_CAPTURE_DT019X, 324 SB_MIX_MONO_CAPTURE_ALS4K 325 }; 326 327 #define SB_MIXVAL_DOUBLE(left_reg, right_reg, left_shift, right_shift, mask) \ 328 ((left_reg) | ((right_reg) << 8) | ((left_shift) << 16) | ((right_shift) << 19) | ((mask) << 24)) 329 #define SB_MIXVAL_SINGLE(reg, shift, mask) \ 330 ((reg) | ((shift) << 16) | ((mask) << 24)) 331 #define SB_MIXVAL_INPUT_SW(reg1, reg2, left_shift, right_shift) \ 332 ((reg1) | ((reg2) << 8) | ((left_shift) << 16) | ((right_shift) << 24)) 333 334 int snd_sbmixer_add_ctl(struct snd_sb *chip, const char *name, int index, int type, unsigned long value); 335 336 /* for ease of use */ 337 struct sbmix_elem { 338 const char *name; 339 int type; 340 unsigned long private_value; 341 }; 342 343 #define SB_SINGLE(xname, reg, shift, mask) \ 344 { .name = xname, \ 345 .type = SB_MIX_SINGLE, \ 346 .private_value = SB_MIXVAL_SINGLE(reg, shift, mask) } 347 348 #define SB_DOUBLE(xname, left_reg, right_reg, left_shift, right_shift, mask) \ 349 { .name = xname, \ 350 .type = SB_MIX_DOUBLE, \ 351 .private_value = SB_MIXVAL_DOUBLE(left_reg, right_reg, left_shift, right_shift, mask) } 352 353 #define SB16_INPUT_SW(xname, reg1, reg2, left_shift, right_shift) \ 354 { .name = xname, \ 355 .type = SB_MIX_INPUT_SW, \ 356 .private_value = SB_MIXVAL_INPUT_SW(reg1, reg2, left_shift, right_shift) } 357 358 static inline int snd_sbmixer_add_ctl_elem(struct snd_sb *chip, const struct sbmix_elem *c) 359 { 360 return snd_sbmixer_add_ctl(chip, c->name, 0, c->type, c->private_value); 361 } 362 363 #endif /* __SOUND_SB_H */ 364