1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Driver for ESS Solo-1 (ES1938, ES1946, ES1969) soundcard
4 * Copyright (c) by Jaromir Koutek <miri@punknet.cz>,
5 * Jaroslav Kysela <perex@perex.cz>,
6 * Thomas Sailer <sailer@ife.ee.ethz.ch>,
7 * Abramo Bagnara <abramo@alsa-project.org>,
8 * Markus Gruber <gruber@eikon.tum.de>
10 * Rewritten from sonicvibes.c source.
13 * Rewrite better spinlocks
18 - Capture data is written unaligned starting from dma_base + 1 so I need to
19 disable mmap and to add a copy callback.
20 - After several cycle of the following:
21 while : ; do arecord -d1 -f cd -t raw | aplay -f cd ; done
22 a "playback write error (DMA or IRQ trouble?)" may happen.
23 This is due to playback interrupts not generated.
24 I suspect a timing issue.
25 - Sometimes the interrupt handler is invoked wrongly during playback.
26 This generates some harmless "Unexpected hw_pointer: wrong interrupt
28 I've seen that using small period sizes.
35 #include <linux/init.h>
36 #include <linux/interrupt.h>
37 #include <linux/pci.h>
38 #include <linux/slab.h>
39 #include <linux/gameport.h>
40 #include <linux/module.h>
41 #include <linux/delay.h>
42 #include <linux/dma-mapping.h>
44 #include <sound/core.h>
45 #include <sound/control.h>
46 #include <sound/pcm.h>
47 #include <sound/opl3.h>
48 #include <sound/mpu401.h>
49 #include <sound/initval.h>
50 #include <sound/tlv.h>
52 MODULE_AUTHOR("Jaromir Koutek <miri@punknet.cz>");
53 MODULE_DESCRIPTION("ESS Solo-1");
54 MODULE_LICENSE("GPL");
56 #if IS_REACHABLE(CONFIG_GAMEPORT)
57 #define SUPPORT_JOYSTICK 1
60 static int index[SNDRV_CARDS] = SNDRV_DEFAULT_IDX; /* Index 0-MAX */
61 static char *id[SNDRV_CARDS] = SNDRV_DEFAULT_STR; /* ID for this card */
62 static bool enable[SNDRV_CARDS] = SNDRV_DEFAULT_ENABLE_PNP; /* Enable this card */
64 module_param_array(index, int, NULL, 0444);
65 MODULE_PARM_DESC(index, "Index value for ESS Solo-1 soundcard.");
66 module_param_array(id, charp, NULL, 0444);
67 MODULE_PARM_DESC(id, "ID string for ESS Solo-1 soundcard.");
68 module_param_array(enable, bool, NULL, 0444);
69 MODULE_PARM_DESC(enable, "Enable ESS Solo-1 soundcard.");
71 #define SLIO_REG(chip, x) ((chip)->io_port + ESSIO_REG_##x)
73 #define SLDM_REG(chip, x) ((chip)->ddma_port + ESSDM_REG_##x)
75 #define SLSB_REG(chip, x) ((chip)->sb_port + ESSSB_REG_##x)
77 #define SL_PCI_LEGACYCONTROL 0x40
78 #define SL_PCI_CONFIG 0x50
79 #define SL_PCI_DDMACONTROL 0x60
81 #define ESSIO_REG_AUDIO2DMAADDR 0
82 #define ESSIO_REG_AUDIO2DMACOUNT 4
83 #define ESSIO_REG_AUDIO2MODE 6
84 #define ESSIO_REG_IRQCONTROL 7
86 #define ESSDM_REG_DMAADDR 0x00
87 #define ESSDM_REG_DMACOUNT 0x04
88 #define ESSDM_REG_DMACOMMAND 0x08
89 #define ESSDM_REG_DMASTATUS 0x08
90 #define ESSDM_REG_DMAMODE 0x0b
91 #define ESSDM_REG_DMACLEAR 0x0d
92 #define ESSDM_REG_DMAMASK 0x0f
94 #define ESSSB_REG_FMLOWADDR 0x00
95 #define ESSSB_REG_FMHIGHADDR 0x02
96 #define ESSSB_REG_MIXERADDR 0x04
97 #define ESSSB_REG_MIXERDATA 0x05
99 #define ESSSB_IREG_AUDIO1 0x14
100 #define ESSSB_IREG_MICMIX 0x1a
101 #define ESSSB_IREG_RECSRC 0x1c
102 #define ESSSB_IREG_MASTER 0x32
103 #define ESSSB_IREG_FM 0x36
104 #define ESSSB_IREG_AUXACD 0x38
105 #define ESSSB_IREG_AUXB 0x3a
106 #define ESSSB_IREG_PCSPEAKER 0x3c
107 #define ESSSB_IREG_LINE 0x3e
108 #define ESSSB_IREG_SPATCONTROL 0x50
109 #define ESSSB_IREG_SPATLEVEL 0x52
110 #define ESSSB_IREG_MASTER_LEFT 0x60
111 #define ESSSB_IREG_MASTER_RIGHT 0x62
112 #define ESSSB_IREG_MPU401CONTROL 0x64
113 #define ESSSB_IREG_MICMIXRECORD 0x68
114 #define ESSSB_IREG_AUDIO2RECORD 0x69
115 #define ESSSB_IREG_AUXACDRECORD 0x6a
116 #define ESSSB_IREG_FMRECORD 0x6b
117 #define ESSSB_IREG_AUXBRECORD 0x6c
118 #define ESSSB_IREG_MONO 0x6d
119 #define ESSSB_IREG_LINERECORD 0x6e
120 #define ESSSB_IREG_MONORECORD 0x6f
121 #define ESSSB_IREG_AUDIO2SAMPLE 0x70
122 #define ESSSB_IREG_AUDIO2MODE 0x71
123 #define ESSSB_IREG_AUDIO2FILTER 0x72
124 #define ESSSB_IREG_AUDIO2TCOUNTL 0x74
125 #define ESSSB_IREG_AUDIO2TCOUNTH 0x76
126 #define ESSSB_IREG_AUDIO2CONTROL1 0x78
127 #define ESSSB_IREG_AUDIO2CONTROL2 0x7a
128 #define ESSSB_IREG_AUDIO2 0x7c
130 #define ESSSB_REG_RESET 0x06
132 #define ESSSB_REG_READDATA 0x0a
133 #define ESSSB_REG_WRITEDATA 0x0c
134 #define ESSSB_REG_READSTATUS 0x0c
136 #define ESSSB_REG_STATUS 0x0e
138 #define ESS_CMD_EXTSAMPLERATE 0xa1
139 #define ESS_CMD_FILTERDIV 0xa2
140 #define ESS_CMD_DMACNTRELOADL 0xa4
141 #define ESS_CMD_DMACNTRELOADH 0xa5
142 #define ESS_CMD_ANALOGCONTROL 0xa8
143 #define ESS_CMD_IRQCONTROL 0xb1
144 #define ESS_CMD_DRQCONTROL 0xb2
145 #define ESS_CMD_RECLEVEL 0xb4
146 #define ESS_CMD_SETFORMAT 0xb6
147 #define ESS_CMD_SETFORMAT2 0xb7
148 #define ESS_CMD_DMACONTROL 0xb8
149 #define ESS_CMD_DMATYPE 0xb9
150 #define ESS_CMD_OFFSETLEFT 0xba
151 #define ESS_CMD_OFFSETRIGHT 0xbb
152 #define ESS_CMD_READREG 0xc0
153 #define ESS_CMD_ENABLEEXT 0xc6
154 #define ESS_CMD_PAUSEDMA 0xd0
155 #define ESS_CMD_ENABLEAUDIO1 0xd1
156 #define ESS_CMD_STOPAUDIO1 0xd3
157 #define ESS_CMD_AUDIO1STATUS 0xd8
158 #define ESS_CMD_CONTDMA 0xd4
159 #define ESS_CMD_TESTIRQ 0xf2
161 #define ESS_RECSRC_MIC 0
162 #define ESS_RECSRC_AUXACD 2
163 #define ESS_RECSRC_AUXB 5
164 #define ESS_RECSRC_LINE 6
165 #define ESS_RECSRC_NONE 7
175 #define SAVED_REG_SIZE 32 /* max. number of registers to save */
180 unsigned long io_port;
181 unsigned long sb_port;
182 unsigned long vc_port;
183 unsigned long mpu_port;
184 unsigned long game_port;
185 unsigned long ddma_port;
187 unsigned char irqmask;
188 unsigned char revision;
190 struct snd_kcontrol *hw_volume;
191 struct snd_kcontrol *hw_switch;
192 struct snd_kcontrol *master_volume;
193 struct snd_kcontrol *master_switch;
196 struct snd_card *card;
198 struct snd_pcm_substream *capture_substream;
199 struct snd_pcm_substream *playback1_substream;
200 struct snd_pcm_substream *playback2_substream;
201 struct snd_rawmidi *rmidi;
203 unsigned int dma1_size;
204 unsigned int dma2_size;
205 unsigned int dma1_start;
206 unsigned int dma2_start;
207 unsigned int dma1_shift;
208 unsigned int dma2_shift;
209 unsigned int last_capture_dmaaddr;
213 spinlock_t mixer_lock;
214 struct snd_info_entry *proc_entry;
216 #ifdef SUPPORT_JOYSTICK
217 struct gameport *gameport;
219 #ifdef CONFIG_PM_SLEEP
220 unsigned char saved_regs[SAVED_REG_SIZE];
224 static irqreturn_t snd_es1938_interrupt(int irq, void *dev_id);
226 static const struct pci_device_id snd_es1938_ids[] = {
227 { PCI_VDEVICE(ESS, 0x1969), 0, }, /* Solo-1 */
231 MODULE_DEVICE_TABLE(pci, snd_es1938_ids);
233 #define RESET_LOOP_TIMEOUT 0x10000
234 #define WRITE_LOOP_TIMEOUT 0x10000
235 #define GET_LOOP_TIMEOUT 0x01000
237 /* -----------------------------------------------------------------
238 * Write to a mixer register
239 * -----------------------------------------------------------------*/
240 static void snd_es1938_mixer_write(struct es1938 *chip, unsigned char reg, unsigned char val)
243 spin_lock_irqsave(&chip->mixer_lock, flags);
244 outb(reg, SLSB_REG(chip, MIXERADDR));
245 outb(val, SLSB_REG(chip, MIXERDATA));
246 spin_unlock_irqrestore(&chip->mixer_lock, flags);
247 dev_dbg(chip->card->dev, "Mixer reg %02x set to %02x\n", reg, val);
250 /* -----------------------------------------------------------------
251 * Read from a mixer register
252 * -----------------------------------------------------------------*/
253 static int snd_es1938_mixer_read(struct es1938 *chip, unsigned char reg)
257 spin_lock_irqsave(&chip->mixer_lock, flags);
258 outb(reg, SLSB_REG(chip, MIXERADDR));
259 data = inb(SLSB_REG(chip, MIXERDATA));
260 spin_unlock_irqrestore(&chip->mixer_lock, flags);
261 dev_dbg(chip->card->dev, "Mixer reg %02x now is %02x\n", reg, data);
265 /* -----------------------------------------------------------------
266 * Write to some bits of a mixer register (return old value)
267 * -----------------------------------------------------------------*/
268 static int snd_es1938_mixer_bits(struct es1938 *chip, unsigned char reg,
269 unsigned char mask, unsigned char val)
272 unsigned char old, new, oval;
273 spin_lock_irqsave(&chip->mixer_lock, flags);
274 outb(reg, SLSB_REG(chip, MIXERADDR));
275 old = inb(SLSB_REG(chip, MIXERDATA));
278 new = (old & ~mask) | (val & mask);
279 outb(new, SLSB_REG(chip, MIXERDATA));
280 dev_dbg(chip->card->dev,
281 "Mixer reg %02x was %02x, set to %02x\n",
284 spin_unlock_irqrestore(&chip->mixer_lock, flags);
288 /* -----------------------------------------------------------------
289 * Write command to Controller Registers
290 * -----------------------------------------------------------------*/
291 static void snd_es1938_write_cmd(struct es1938 *chip, unsigned char cmd)
295 for (i = 0; i < WRITE_LOOP_TIMEOUT; i++) {
296 v = inb(SLSB_REG(chip, READSTATUS));
298 outb(cmd, SLSB_REG(chip, WRITEDATA));
302 dev_err(chip->card->dev,
303 "snd_es1938_write_cmd timeout (0x02%x/0x02%x)\n", cmd, v);
306 /* -----------------------------------------------------------------
307 * Read the Read Data Buffer
308 * -----------------------------------------------------------------*/
309 static int snd_es1938_get_byte(struct es1938 *chip)
313 for (i = GET_LOOP_TIMEOUT; i; i--) {
314 v = inb(SLSB_REG(chip, STATUS));
316 return inb(SLSB_REG(chip, READDATA));
318 dev_err(chip->card->dev, "get_byte timeout: status 0x02%x\n", v);
322 /* -----------------------------------------------------------------
323 * Write value cmd register
324 * -----------------------------------------------------------------*/
325 static void snd_es1938_write(struct es1938 *chip, unsigned char reg, unsigned char val)
328 spin_lock_irqsave(&chip->reg_lock, flags);
329 snd_es1938_write_cmd(chip, reg);
330 snd_es1938_write_cmd(chip, val);
331 spin_unlock_irqrestore(&chip->reg_lock, flags);
332 dev_dbg(chip->card->dev, "Reg %02x set to %02x\n", reg, val);
335 /* -----------------------------------------------------------------
336 * Read data from cmd register and return it
337 * -----------------------------------------------------------------*/
338 static unsigned char snd_es1938_read(struct es1938 *chip, unsigned char reg)
342 spin_lock_irqsave(&chip->reg_lock, flags);
343 snd_es1938_write_cmd(chip, ESS_CMD_READREG);
344 snd_es1938_write_cmd(chip, reg);
345 val = snd_es1938_get_byte(chip);
346 spin_unlock_irqrestore(&chip->reg_lock, flags);
347 dev_dbg(chip->card->dev, "Reg %02x now is %02x\n", reg, val);
351 /* -----------------------------------------------------------------
352 * Write data to cmd register and return old value
353 * -----------------------------------------------------------------*/
354 static int snd_es1938_bits(struct es1938 *chip, unsigned char reg, unsigned char mask,
358 unsigned char old, new, oval;
359 spin_lock_irqsave(&chip->reg_lock, flags);
360 snd_es1938_write_cmd(chip, ESS_CMD_READREG);
361 snd_es1938_write_cmd(chip, reg);
362 old = snd_es1938_get_byte(chip);
365 snd_es1938_write_cmd(chip, reg);
366 new = (old & ~mask) | (val & mask);
367 snd_es1938_write_cmd(chip, new);
368 dev_dbg(chip->card->dev, "Reg %02x was %02x, set to %02x\n",
371 spin_unlock_irqrestore(&chip->reg_lock, flags);
375 /* --------------------------------------------------------------------
377 * --------------------------------------------------------------------*/
378 static void snd_es1938_reset(struct es1938 *chip)
382 outb(3, SLSB_REG(chip, RESET));
383 inb(SLSB_REG(chip, RESET));
384 outb(0, SLSB_REG(chip, RESET));
385 for (i = 0; i < RESET_LOOP_TIMEOUT; i++) {
386 if (inb(SLSB_REG(chip, STATUS)) & 0x80) {
387 if (inb(SLSB_REG(chip, READDATA)) == 0xaa)
391 dev_err(chip->card->dev, "ESS Solo-1 reset failed\n");
394 snd_es1938_write_cmd(chip, ESS_CMD_ENABLEEXT);
396 /* Demand transfer DMA: 4 bytes per DMA request */
397 snd_es1938_write(chip, ESS_CMD_DMATYPE, 2);
399 /* Change behaviour of register A1
401 2nd channel DAC asynchronous */
402 snd_es1938_mixer_write(chip, ESSSB_IREG_AUDIO2MODE, 0x32);
403 /* enable/select DMA channel and IRQ channel */
404 snd_es1938_bits(chip, ESS_CMD_IRQCONTROL, 0xf0, 0x50);
405 snd_es1938_bits(chip, ESS_CMD_DRQCONTROL, 0xf0, 0x50);
406 snd_es1938_write_cmd(chip, ESS_CMD_ENABLEAUDIO1);
407 /* Set spatializer parameters to recommended values */
408 snd_es1938_mixer_write(chip, 0x54, 0x8f);
409 snd_es1938_mixer_write(chip, 0x56, 0x95);
410 snd_es1938_mixer_write(chip, 0x58, 0x94);
411 snd_es1938_mixer_write(chip, 0x5a, 0x80);
414 /* --------------------------------------------------------------------
416 * --------------------------------------------------------------------*/
417 static void snd_es1938_reset_fifo(struct es1938 *chip)
419 outb(2, SLSB_REG(chip, RESET));
420 outb(0, SLSB_REG(chip, RESET));
423 static const struct snd_ratnum clocks[2] = {
438 static const struct snd_pcm_hw_constraint_ratnums hw_constraints_clocks = {
444 static void snd_es1938_rate_set(struct es1938 *chip,
445 struct snd_pcm_substream *substream,
448 unsigned int bits, div0;
449 struct snd_pcm_runtime *runtime = substream->runtime;
450 if (runtime->rate_num == clocks[0].num)
451 bits = 128 - runtime->rate_den;
453 bits = 256 - runtime->rate_den;
455 /* set filter register */
456 div0 = 256 - 7160000*20/(8*82*runtime->rate);
459 snd_es1938_mixer_write(chip, 0x70, bits);
460 snd_es1938_mixer_write(chip, 0x72, div0);
462 snd_es1938_write(chip, 0xA1, bits);
463 snd_es1938_write(chip, 0xA2, div0);
467 /* --------------------------------------------------------------------
468 * Configure Solo1 builtin DMA Controller
469 * --------------------------------------------------------------------*/
471 static void snd_es1938_playback1_setdma(struct es1938 *chip)
473 outb(0x00, SLIO_REG(chip, AUDIO2MODE));
474 outl(chip->dma2_start, SLIO_REG(chip, AUDIO2DMAADDR));
475 outw(0, SLIO_REG(chip, AUDIO2DMACOUNT));
476 outw(chip->dma2_size, SLIO_REG(chip, AUDIO2DMACOUNT));
479 static void snd_es1938_playback2_setdma(struct es1938 *chip)
481 /* Enable DMA controller */
482 outb(0xc4, SLDM_REG(chip, DMACOMMAND));
483 /* 1. Master reset */
484 outb(0, SLDM_REG(chip, DMACLEAR));
486 outb(1, SLDM_REG(chip, DMAMASK));
487 outb(0x18, SLDM_REG(chip, DMAMODE));
488 outl(chip->dma1_start, SLDM_REG(chip, DMAADDR));
489 outw(chip->dma1_size - 1, SLDM_REG(chip, DMACOUNT));
491 outb(0, SLDM_REG(chip, DMAMASK));
494 static void snd_es1938_capture_setdma(struct es1938 *chip)
496 /* Enable DMA controller */
497 outb(0xc4, SLDM_REG(chip, DMACOMMAND));
498 /* 1. Master reset */
499 outb(0, SLDM_REG(chip, DMACLEAR));
501 outb(1, SLDM_REG(chip, DMAMASK));
502 outb(0x14, SLDM_REG(chip, DMAMODE));
503 outl(chip->dma1_start, SLDM_REG(chip, DMAADDR));
504 chip->last_capture_dmaaddr = chip->dma1_start;
505 outw(chip->dma1_size - 1, SLDM_REG(chip, DMACOUNT));
507 outb(0, SLDM_REG(chip, DMAMASK));
510 /* ----------------------------------------------------------------------
515 static int snd_es1938_capture_trigger(struct snd_pcm_substream *substream,
518 struct es1938 *chip = snd_pcm_substream_chip(substream);
521 case SNDRV_PCM_TRIGGER_START:
522 case SNDRV_PCM_TRIGGER_RESUME:
524 chip->active |= ADC1;
526 case SNDRV_PCM_TRIGGER_STOP:
527 case SNDRV_PCM_TRIGGER_SUSPEND:
529 chip->active &= ~ADC1;
534 snd_es1938_write(chip, ESS_CMD_DMACONTROL, val);
538 static int snd_es1938_playback1_trigger(struct snd_pcm_substream *substream,
541 struct es1938 *chip = snd_pcm_substream_chip(substream);
543 case SNDRV_PCM_TRIGGER_START:
544 case SNDRV_PCM_TRIGGER_RESUME:
545 /* According to the documentation this should be:
546 0x13 but that value may randomly swap stereo channels */
547 snd_es1938_mixer_write(chip, ESSSB_IREG_AUDIO2CONTROL1, 0x92);
549 snd_es1938_mixer_write(chip, ESSSB_IREG_AUDIO2CONTROL1, 0x93);
550 /* This two stage init gives the FIFO -> DAC connection time to
551 * settle before first data from DMA flows in. This should ensure
552 * no swapping of stereo channels. Report a bug if otherwise :-) */
553 outb(0x0a, SLIO_REG(chip, AUDIO2MODE));
554 chip->active |= DAC2;
556 case SNDRV_PCM_TRIGGER_STOP:
557 case SNDRV_PCM_TRIGGER_SUSPEND:
558 outb(0, SLIO_REG(chip, AUDIO2MODE));
559 snd_es1938_mixer_write(chip, ESSSB_IREG_AUDIO2CONTROL1, 0);
560 chip->active &= ~DAC2;
568 static int snd_es1938_playback2_trigger(struct snd_pcm_substream *substream,
571 struct es1938 *chip = snd_pcm_substream_chip(substream);
574 case SNDRV_PCM_TRIGGER_START:
575 case SNDRV_PCM_TRIGGER_RESUME:
577 chip->active |= DAC1;
579 case SNDRV_PCM_TRIGGER_STOP:
580 case SNDRV_PCM_TRIGGER_SUSPEND:
582 chip->active &= ~DAC1;
587 snd_es1938_write(chip, ESS_CMD_DMACONTROL, val);
591 static int snd_es1938_playback_trigger(struct snd_pcm_substream *substream,
594 switch (substream->number) {
596 return snd_es1938_playback1_trigger(substream, cmd);
598 return snd_es1938_playback2_trigger(substream, cmd);
604 /* --------------------------------------------------------------------
605 * First channel for Extended Mode Audio 1 ADC Operation
606 * --------------------------------------------------------------------*/
607 static int snd_es1938_capture_prepare(struct snd_pcm_substream *substream)
609 struct es1938 *chip = snd_pcm_substream_chip(substream);
610 struct snd_pcm_runtime *runtime = substream->runtime;
612 unsigned int size = snd_pcm_lib_buffer_bytes(substream);
613 unsigned int count = snd_pcm_lib_period_bytes(substream);
615 chip->dma1_size = size;
616 chip->dma1_start = runtime->dma_addr;
618 mono = (runtime->channels > 1) ? 0 : 1;
619 is8 = snd_pcm_format_width(runtime->format) == 16 ? 0 : 1;
620 u = snd_pcm_format_unsigned(runtime->format);
622 chip->dma1_shift = 2 - mono - is8;
624 snd_es1938_reset_fifo(chip);
627 snd_es1938_bits(chip, ESS_CMD_ANALOGCONTROL, 0x03, (mono ? 2 : 1));
629 /* set clock and counters */
630 snd_es1938_rate_set(chip, substream, ADC1);
632 count = 0x10000 - count;
633 snd_es1938_write(chip, ESS_CMD_DMACNTRELOADL, count & 0xff);
634 snd_es1938_write(chip, ESS_CMD_DMACNTRELOADH, count >> 8);
636 /* initialize and configure ADC */
637 snd_es1938_write(chip, ESS_CMD_SETFORMAT2, u ? 0x51 : 0x71);
638 snd_es1938_write(chip, ESS_CMD_SETFORMAT2, 0x90 |
640 (is8 ? 0x00 : 0x04) |
641 (mono ? 0x40 : 0x08));
643 // snd_es1938_reset_fifo(chip);
645 /* 11. configure system interrupt controller and DMA controller */
646 snd_es1938_capture_setdma(chip);
652 /* ------------------------------------------------------------------------------
653 * Second Audio channel DAC Operation
654 * ------------------------------------------------------------------------------*/
655 static int snd_es1938_playback1_prepare(struct snd_pcm_substream *substream)
657 struct es1938 *chip = snd_pcm_substream_chip(substream);
658 struct snd_pcm_runtime *runtime = substream->runtime;
660 unsigned int size = snd_pcm_lib_buffer_bytes(substream);
661 unsigned int count = snd_pcm_lib_period_bytes(substream);
663 chip->dma2_size = size;
664 chip->dma2_start = runtime->dma_addr;
666 mono = (runtime->channels > 1) ? 0 : 1;
667 is8 = snd_pcm_format_width(runtime->format) == 16 ? 0 : 1;
668 u = snd_pcm_format_unsigned(runtime->format);
670 chip->dma2_shift = 2 - mono - is8;
672 snd_es1938_reset_fifo(chip);
674 /* set clock and counters */
675 snd_es1938_rate_set(chip, substream, DAC2);
678 count = 0x10000 - count;
679 snd_es1938_mixer_write(chip, ESSSB_IREG_AUDIO2TCOUNTL, count & 0xff);
680 snd_es1938_mixer_write(chip, ESSSB_IREG_AUDIO2TCOUNTH, count >> 8);
682 /* initialize and configure Audio 2 DAC */
683 snd_es1938_mixer_write(chip, ESSSB_IREG_AUDIO2CONTROL2, 0x40 | (u ? 0 : 4) |
684 (mono ? 0 : 2) | (is8 ? 0 : 1));
687 snd_es1938_playback1_setdma(chip);
692 static int snd_es1938_playback2_prepare(struct snd_pcm_substream *substream)
694 struct es1938 *chip = snd_pcm_substream_chip(substream);
695 struct snd_pcm_runtime *runtime = substream->runtime;
697 unsigned int size = snd_pcm_lib_buffer_bytes(substream);
698 unsigned int count = snd_pcm_lib_period_bytes(substream);
700 chip->dma1_size = size;
701 chip->dma1_start = runtime->dma_addr;
703 mono = (runtime->channels > 1) ? 0 : 1;
704 is8 = snd_pcm_format_width(runtime->format) == 16 ? 0 : 1;
705 u = snd_pcm_format_unsigned(runtime->format);
707 chip->dma1_shift = 2 - mono - is8;
709 count = 0x10000 - count;
712 snd_es1938_reset_fifo(chip);
714 snd_es1938_bits(chip, ESS_CMD_ANALOGCONTROL, 0x03, (mono ? 2 : 1));
716 /* set clock and counters */
717 snd_es1938_rate_set(chip, substream, DAC1);
718 snd_es1938_write(chip, ESS_CMD_DMACNTRELOADL, count & 0xff);
719 snd_es1938_write(chip, ESS_CMD_DMACNTRELOADH, count >> 8);
721 /* initialized and configure DAC */
722 snd_es1938_write(chip, ESS_CMD_SETFORMAT, u ? 0x80 : 0x00);
723 snd_es1938_write(chip, ESS_CMD_SETFORMAT, u ? 0x51 : 0x71);
724 snd_es1938_write(chip, ESS_CMD_SETFORMAT2,
725 0x90 | (mono ? 0x40 : 0x08) |
726 (is8 ? 0x00 : 0x04) | (u ? 0x00 : 0x20));
729 snd_es1938_playback2_setdma(chip);
734 static int snd_es1938_playback_prepare(struct snd_pcm_substream *substream)
736 switch (substream->number) {
738 return snd_es1938_playback1_prepare(substream);
740 return snd_es1938_playback2_prepare(substream);
746 /* during the incrementing of dma counters the DMA register reads sometimes
747 returns garbage. To ensure a valid hw pointer, the following checks which
748 should be very unlikely to fail are used:
749 - is the current DMA address in the valid DMA range ?
750 - is the sum of DMA address and DMA counter pointing to the last DMA byte ?
751 One can argue this could differ by one byte depending on which register is
752 updated first, so the implementation below allows for that.
754 static snd_pcm_uframes_t snd_es1938_capture_pointer(struct snd_pcm_substream *substream)
756 struct es1938 *chip = snd_pcm_substream_chip(substream);
760 /* This stuff is *needed*, don't ask why - AB */
761 old = inw(SLDM_REG(chip, DMACOUNT));
762 while ((new = inw(SLDM_REG(chip, DMACOUNT))) != old)
764 ptr = chip->dma1_size - 1 - new;
769 ptr = inl(SLDM_REG(chip, DMAADDR));
770 count = inw(SLDM_REG(chip, DMACOUNT));
771 diff = chip->dma1_start + chip->dma1_size - ptr - count;
773 if (diff > 3 || ptr < chip->dma1_start
774 || ptr >= chip->dma1_start+chip->dma1_size)
775 ptr = chip->last_capture_dmaaddr; /* bad, use last saved */
777 chip->last_capture_dmaaddr = ptr; /* good, remember it */
779 ptr -= chip->dma1_start;
781 return ptr >> chip->dma1_shift;
784 static snd_pcm_uframes_t snd_es1938_playback1_pointer(struct snd_pcm_substream *substream)
786 struct es1938 *chip = snd_pcm_substream_chip(substream);
789 ptr = chip->dma2_size - inw(SLIO_REG(chip, AUDIO2DMACOUNT));
791 ptr = inl(SLIO_REG(chip, AUDIO2DMAADDR)) - chip->dma2_start;
793 return ptr >> chip->dma2_shift;
796 static snd_pcm_uframes_t snd_es1938_playback2_pointer(struct snd_pcm_substream *substream)
798 struct es1938 *chip = snd_pcm_substream_chip(substream);
802 /* This stuff is *needed*, don't ask why - AB */
803 old = inw(SLDM_REG(chip, DMACOUNT));
804 while ((new = inw(SLDM_REG(chip, DMACOUNT))) != old)
806 ptr = chip->dma1_size - 1 - new;
808 ptr = inl(SLDM_REG(chip, DMAADDR)) - chip->dma1_start;
810 return ptr >> chip->dma1_shift;
813 static snd_pcm_uframes_t snd_es1938_playback_pointer(struct snd_pcm_substream *substream)
815 switch (substream->number) {
817 return snd_es1938_playback1_pointer(substream);
819 return snd_es1938_playback2_pointer(substream);
825 static int snd_es1938_capture_copy(struct snd_pcm_substream *substream,
826 int channel, unsigned long pos,
827 struct iov_iter *dst, unsigned long count)
829 struct snd_pcm_runtime *runtime = substream->runtime;
830 struct es1938 *chip = snd_pcm_substream_chip(substream);
832 if (snd_BUG_ON(pos + count > chip->dma1_size))
834 if (pos + count < chip->dma1_size) {
835 if (copy_to_iter(runtime->dma_area + pos + 1, count, dst) != count)
838 if (copy_to_iter(runtime->dma_area + pos + 1, count - 1, dst) != count - 1)
840 if (copy_to_iter(runtime->dma_area, 1, dst) != 1)
846 /* ----------------------------------------------------------------------
847 * Audio1 Capture (ADC)
848 * ----------------------------------------------------------------------*/
849 static const struct snd_pcm_hardware snd_es1938_capture =
851 .info = (SNDRV_PCM_INFO_INTERLEAVED |
852 SNDRV_PCM_INFO_BLOCK_TRANSFER),
853 .formats = (SNDRV_PCM_FMTBIT_U8 | SNDRV_PCM_FMTBIT_S16_LE |
854 SNDRV_PCM_FMTBIT_S8 | SNDRV_PCM_FMTBIT_U16_LE),
855 .rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000,
860 .buffer_bytes_max = 0x8000, /* DMA controller screws on higher values */
861 .period_bytes_min = 64,
862 .period_bytes_max = 0x8000,
868 /* -----------------------------------------------------------------------
869 * Audio2 Playback (DAC)
870 * -----------------------------------------------------------------------*/
871 static const struct snd_pcm_hardware snd_es1938_playback =
873 .info = (SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED |
874 SNDRV_PCM_INFO_BLOCK_TRANSFER |
875 SNDRV_PCM_INFO_MMAP_VALID),
876 .formats = (SNDRV_PCM_FMTBIT_U8 | SNDRV_PCM_FMTBIT_S16_LE |
877 SNDRV_PCM_FMTBIT_S8 | SNDRV_PCM_FMTBIT_U16_LE),
878 .rates = SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000,
883 .buffer_bytes_max = 0x8000, /* DMA controller screws on higher values */
884 .period_bytes_min = 64,
885 .period_bytes_max = 0x8000,
891 static int snd_es1938_capture_open(struct snd_pcm_substream *substream)
893 struct es1938 *chip = snd_pcm_substream_chip(substream);
894 struct snd_pcm_runtime *runtime = substream->runtime;
896 if (chip->playback2_substream)
898 chip->capture_substream = substream;
899 runtime->hw = snd_es1938_capture;
900 snd_pcm_hw_constraint_ratnums(runtime, 0, SNDRV_PCM_HW_PARAM_RATE,
901 &hw_constraints_clocks);
902 snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_BUFFER_BYTES, 0, 0xff00);
906 static int snd_es1938_playback_open(struct snd_pcm_substream *substream)
908 struct es1938 *chip = snd_pcm_substream_chip(substream);
909 struct snd_pcm_runtime *runtime = substream->runtime;
911 switch (substream->number) {
913 chip->playback1_substream = substream;
916 if (chip->capture_substream)
918 chip->playback2_substream = substream;
924 runtime->hw = snd_es1938_playback;
925 snd_pcm_hw_constraint_ratnums(runtime, 0, SNDRV_PCM_HW_PARAM_RATE,
926 &hw_constraints_clocks);
927 snd_pcm_hw_constraint_minmax(runtime, SNDRV_PCM_HW_PARAM_BUFFER_BYTES, 0, 0xff00);
931 static int snd_es1938_capture_close(struct snd_pcm_substream *substream)
933 struct es1938 *chip = snd_pcm_substream_chip(substream);
935 chip->capture_substream = NULL;
939 static int snd_es1938_playback_close(struct snd_pcm_substream *substream)
941 struct es1938 *chip = snd_pcm_substream_chip(substream);
943 switch (substream->number) {
945 chip->playback1_substream = NULL;
948 chip->playback2_substream = NULL;
957 static const struct snd_pcm_ops snd_es1938_playback_ops = {
958 .open = snd_es1938_playback_open,
959 .close = snd_es1938_playback_close,
960 .prepare = snd_es1938_playback_prepare,
961 .trigger = snd_es1938_playback_trigger,
962 .pointer = snd_es1938_playback_pointer,
965 static const struct snd_pcm_ops snd_es1938_capture_ops = {
966 .open = snd_es1938_capture_open,
967 .close = snd_es1938_capture_close,
968 .prepare = snd_es1938_capture_prepare,
969 .trigger = snd_es1938_capture_trigger,
970 .pointer = snd_es1938_capture_pointer,
971 .copy = snd_es1938_capture_copy,
974 static int snd_es1938_new_pcm(struct es1938 *chip, int device)
979 err = snd_pcm_new(chip->card, "es-1938-1946", device, 2, 1, &pcm);
982 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &snd_es1938_playback_ops);
983 snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &snd_es1938_capture_ops);
985 pcm->private_data = chip;
987 strcpy(pcm->name, "ESS Solo-1");
989 snd_pcm_set_managed_buffer_all(pcm, SNDRV_DMA_TYPE_DEV,
990 &chip->pci->dev, 64*1024, 64*1024);
996 /* -------------------------------------------------------------------
1001 static int snd_es1938_info_mux(struct snd_kcontrol *kcontrol,
1002 struct snd_ctl_elem_info *uinfo)
1004 static const char * const texts[8] = {
1005 "Mic", "Mic Master", "CD", "AOUT",
1006 "Mic1", "Mix", "Line", "Master"
1009 return snd_ctl_enum_info(uinfo, 1, 8, texts);
1012 static int snd_es1938_get_mux(struct snd_kcontrol *kcontrol,
1013 struct snd_ctl_elem_value *ucontrol)
1015 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1016 ucontrol->value.enumerated.item[0] = snd_es1938_mixer_read(chip, 0x1c) & 0x07;
1020 static int snd_es1938_put_mux(struct snd_kcontrol *kcontrol,
1021 struct snd_ctl_elem_value *ucontrol)
1023 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1024 unsigned char val = ucontrol->value.enumerated.item[0];
1028 return snd_es1938_mixer_bits(chip, 0x1c, 0x07, val) != val;
1031 #define snd_es1938_info_spatializer_enable snd_ctl_boolean_mono_info
1033 static int snd_es1938_get_spatializer_enable(struct snd_kcontrol *kcontrol,
1034 struct snd_ctl_elem_value *ucontrol)
1036 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1037 unsigned char val = snd_es1938_mixer_read(chip, 0x50);
1038 ucontrol->value.integer.value[0] = !!(val & 8);
1042 static int snd_es1938_put_spatializer_enable(struct snd_kcontrol *kcontrol,
1043 struct snd_ctl_elem_value *ucontrol)
1045 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1046 unsigned char oval, nval;
1048 nval = ucontrol->value.integer.value[0] ? 0x0c : 0x04;
1049 oval = snd_es1938_mixer_read(chip, 0x50) & 0x0c;
1050 change = nval != oval;
1052 snd_es1938_mixer_write(chip, 0x50, nval & ~0x04);
1053 snd_es1938_mixer_write(chip, 0x50, nval);
1058 static int snd_es1938_info_hw_volume(struct snd_kcontrol *kcontrol,
1059 struct snd_ctl_elem_info *uinfo)
1061 uinfo->type = SNDRV_CTL_ELEM_TYPE_INTEGER;
1063 uinfo->value.integer.min = 0;
1064 uinfo->value.integer.max = 63;
1068 static int snd_es1938_get_hw_volume(struct snd_kcontrol *kcontrol,
1069 struct snd_ctl_elem_value *ucontrol)
1071 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1072 ucontrol->value.integer.value[0] = snd_es1938_mixer_read(chip, 0x61) & 0x3f;
1073 ucontrol->value.integer.value[1] = snd_es1938_mixer_read(chip, 0x63) & 0x3f;
1077 #define snd_es1938_info_hw_switch snd_ctl_boolean_stereo_info
1079 static int snd_es1938_get_hw_switch(struct snd_kcontrol *kcontrol,
1080 struct snd_ctl_elem_value *ucontrol)
1082 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1083 ucontrol->value.integer.value[0] = !(snd_es1938_mixer_read(chip, 0x61) & 0x40);
1084 ucontrol->value.integer.value[1] = !(snd_es1938_mixer_read(chip, 0x63) & 0x40);
1088 static void snd_es1938_hwv_free(struct snd_kcontrol *kcontrol)
1090 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1091 chip->master_volume = NULL;
1092 chip->master_switch = NULL;
1093 chip->hw_volume = NULL;
1094 chip->hw_switch = NULL;
1097 static int snd_es1938_reg_bits(struct es1938 *chip, unsigned char reg,
1098 unsigned char mask, unsigned char val)
1101 return snd_es1938_mixer_bits(chip, reg, mask, val);
1103 return snd_es1938_bits(chip, reg, mask, val);
1106 static int snd_es1938_reg_read(struct es1938 *chip, unsigned char reg)
1109 return snd_es1938_mixer_read(chip, reg);
1111 return snd_es1938_read(chip, reg);
1114 #define ES1938_SINGLE_TLV(xname, xindex, reg, shift, mask, invert, xtlv) \
1115 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
1116 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | SNDRV_CTL_ELEM_ACCESS_TLV_READ,\
1117 .name = xname, .index = xindex, \
1118 .info = snd_es1938_info_single, \
1119 .get = snd_es1938_get_single, .put = snd_es1938_put_single, \
1120 .private_value = reg | (shift << 8) | (mask << 16) | (invert << 24), \
1121 .tlv = { .p = xtlv } }
1122 #define ES1938_SINGLE(xname, xindex, reg, shift, mask, invert) \
1123 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xindex, \
1124 .info = snd_es1938_info_single, \
1125 .get = snd_es1938_get_single, .put = snd_es1938_put_single, \
1126 .private_value = reg | (shift << 8) | (mask << 16) | (invert << 24) }
1128 static int snd_es1938_info_single(struct snd_kcontrol *kcontrol,
1129 struct snd_ctl_elem_info *uinfo)
1131 int mask = (kcontrol->private_value >> 16) & 0xff;
1133 uinfo->type = mask == 1 ? SNDRV_CTL_ELEM_TYPE_BOOLEAN : SNDRV_CTL_ELEM_TYPE_INTEGER;
1135 uinfo->value.integer.min = 0;
1136 uinfo->value.integer.max = mask;
1140 static int snd_es1938_get_single(struct snd_kcontrol *kcontrol,
1141 struct snd_ctl_elem_value *ucontrol)
1143 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1144 int reg = kcontrol->private_value & 0xff;
1145 int shift = (kcontrol->private_value >> 8) & 0xff;
1146 int mask = (kcontrol->private_value >> 16) & 0xff;
1147 int invert = (kcontrol->private_value >> 24) & 0xff;
1150 val = snd_es1938_reg_read(chip, reg);
1151 ucontrol->value.integer.value[0] = (val >> shift) & mask;
1153 ucontrol->value.integer.value[0] = mask - ucontrol->value.integer.value[0];
1157 static int snd_es1938_put_single(struct snd_kcontrol *kcontrol,
1158 struct snd_ctl_elem_value *ucontrol)
1160 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1161 int reg = kcontrol->private_value & 0xff;
1162 int shift = (kcontrol->private_value >> 8) & 0xff;
1163 int mask = (kcontrol->private_value >> 16) & 0xff;
1164 int invert = (kcontrol->private_value >> 24) & 0xff;
1167 val = (ucontrol->value.integer.value[0] & mask);
1172 return snd_es1938_reg_bits(chip, reg, mask, val) != val;
1175 #define ES1938_DOUBLE_TLV(xname, xindex, left_reg, right_reg, shift_left, shift_right, mask, invert, xtlv) \
1176 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, \
1177 .access = SNDRV_CTL_ELEM_ACCESS_READWRITE | SNDRV_CTL_ELEM_ACCESS_TLV_READ,\
1178 .name = xname, .index = xindex, \
1179 .info = snd_es1938_info_double, \
1180 .get = snd_es1938_get_double, .put = snd_es1938_put_double, \
1181 .private_value = left_reg | (right_reg << 8) | (shift_left << 16) | (shift_right << 19) | (mask << 24) | (invert << 22), \
1182 .tlv = { .p = xtlv } }
1183 #define ES1938_DOUBLE(xname, xindex, left_reg, right_reg, shift_left, shift_right, mask, invert) \
1184 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xindex, \
1185 .info = snd_es1938_info_double, \
1186 .get = snd_es1938_get_double, .put = snd_es1938_put_double, \
1187 .private_value = left_reg | (right_reg << 8) | (shift_left << 16) | (shift_right << 19) | (mask << 24) | (invert << 22) }
1189 static int snd_es1938_info_double(struct snd_kcontrol *kcontrol,
1190 struct snd_ctl_elem_info *uinfo)
1192 int mask = (kcontrol->private_value >> 24) & 0xff;
1194 uinfo->type = mask == 1 ? SNDRV_CTL_ELEM_TYPE_BOOLEAN : SNDRV_CTL_ELEM_TYPE_INTEGER;
1196 uinfo->value.integer.min = 0;
1197 uinfo->value.integer.max = mask;
1201 static int snd_es1938_get_double(struct snd_kcontrol *kcontrol,
1202 struct snd_ctl_elem_value *ucontrol)
1204 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1205 int left_reg = kcontrol->private_value & 0xff;
1206 int right_reg = (kcontrol->private_value >> 8) & 0xff;
1207 int shift_left = (kcontrol->private_value >> 16) & 0x07;
1208 int shift_right = (kcontrol->private_value >> 19) & 0x07;
1209 int mask = (kcontrol->private_value >> 24) & 0xff;
1210 int invert = (kcontrol->private_value >> 22) & 1;
1211 unsigned char left, right;
1213 left = snd_es1938_reg_read(chip, left_reg);
1214 if (left_reg != right_reg)
1215 right = snd_es1938_reg_read(chip, right_reg);
1218 ucontrol->value.integer.value[0] = (left >> shift_left) & mask;
1219 ucontrol->value.integer.value[1] = (right >> shift_right) & mask;
1221 ucontrol->value.integer.value[0] = mask - ucontrol->value.integer.value[0];
1222 ucontrol->value.integer.value[1] = mask - ucontrol->value.integer.value[1];
1227 static int snd_es1938_put_double(struct snd_kcontrol *kcontrol,
1228 struct snd_ctl_elem_value *ucontrol)
1230 struct es1938 *chip = snd_kcontrol_chip(kcontrol);
1231 int left_reg = kcontrol->private_value & 0xff;
1232 int right_reg = (kcontrol->private_value >> 8) & 0xff;
1233 int shift_left = (kcontrol->private_value >> 16) & 0x07;
1234 int shift_right = (kcontrol->private_value >> 19) & 0x07;
1235 int mask = (kcontrol->private_value >> 24) & 0xff;
1236 int invert = (kcontrol->private_value >> 22) & 1;
1238 unsigned char val1, val2, mask1, mask2;
1240 val1 = ucontrol->value.integer.value[0] & mask;
1241 val2 = ucontrol->value.integer.value[1] & mask;
1246 val1 <<= shift_left;
1247 val2 <<= shift_right;
1248 mask1 = mask << shift_left;
1249 mask2 = mask << shift_right;
1250 if (left_reg != right_reg) {
1252 if (snd_es1938_reg_bits(chip, left_reg, mask1, val1) != val1)
1254 if (snd_es1938_reg_bits(chip, right_reg, mask2, val2) != val2)
1257 change = (snd_es1938_reg_bits(chip, left_reg, mask1 | mask2,
1258 val1 | val2) != (val1 | val2));
1263 static const DECLARE_TLV_DB_RANGE(db_scale_master,
1264 0, 54, TLV_DB_SCALE_ITEM(-3600, 50, 1),
1265 54, 63, TLV_DB_SCALE_ITEM(-900, 100, 0),
1268 static const DECLARE_TLV_DB_RANGE(db_scale_audio1,
1269 0, 8, TLV_DB_SCALE_ITEM(-3300, 300, 1),
1270 8, 15, TLV_DB_SCALE_ITEM(-900, 150, 0),
1273 static const DECLARE_TLV_DB_RANGE(db_scale_audio2,
1274 0, 8, TLV_DB_SCALE_ITEM(-3450, 300, 1),
1275 8, 15, TLV_DB_SCALE_ITEM(-1050, 150, 0),
1278 static const DECLARE_TLV_DB_RANGE(db_scale_mic,
1279 0, 8, TLV_DB_SCALE_ITEM(-2400, 300, 1),
1280 8, 15, TLV_DB_SCALE_ITEM(0, 150, 0),
1283 static const DECLARE_TLV_DB_RANGE(db_scale_line,
1284 0, 8, TLV_DB_SCALE_ITEM(-3150, 300, 1),
1285 8, 15, TLV_DB_SCALE_ITEM(-750, 150, 0),
1288 static const DECLARE_TLV_DB_SCALE(db_scale_capture, 0, 150, 0);
1290 static const struct snd_kcontrol_new snd_es1938_controls[] = {
1291 ES1938_DOUBLE_TLV("Master Playback Volume", 0, 0x60, 0x62, 0, 0, 63, 0,
1293 ES1938_DOUBLE("Master Playback Switch", 0, 0x60, 0x62, 6, 6, 1, 1),
1295 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
1296 .name = "Hardware Master Playback Volume",
1297 .access = SNDRV_CTL_ELEM_ACCESS_READ,
1298 .info = snd_es1938_info_hw_volume,
1299 .get = snd_es1938_get_hw_volume,
1302 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
1303 .access = (SNDRV_CTL_ELEM_ACCESS_READ |
1304 SNDRV_CTL_ELEM_ACCESS_TLV_READ),
1305 .name = "Hardware Master Playback Switch",
1306 .info = snd_es1938_info_hw_switch,
1307 .get = snd_es1938_get_hw_switch,
1308 .tlv = { .p = db_scale_master },
1310 ES1938_SINGLE("Hardware Volume Split", 0, 0x64, 7, 1, 0),
1311 ES1938_DOUBLE_TLV("Line Playback Volume", 0, 0x3e, 0x3e, 4, 0, 15, 0,
1313 ES1938_DOUBLE("CD Playback Volume", 0, 0x38, 0x38, 4, 0, 15, 0),
1314 ES1938_DOUBLE_TLV("FM Playback Volume", 0, 0x36, 0x36, 4, 0, 15, 0,
1316 ES1938_DOUBLE_TLV("Mono Playback Volume", 0, 0x6d, 0x6d, 4, 0, 15, 0,
1318 ES1938_DOUBLE_TLV("Mic Playback Volume", 0, 0x1a, 0x1a, 4, 0, 15, 0,
1320 ES1938_DOUBLE_TLV("Aux Playback Volume", 0, 0x3a, 0x3a, 4, 0, 15, 0,
1322 ES1938_DOUBLE_TLV("Capture Volume", 0, 0xb4, 0xb4, 4, 0, 15, 0,
1324 ES1938_SINGLE("Beep Volume", 0, 0x3c, 0, 7, 0),
1325 ES1938_SINGLE("Record Monitor", 0, 0xa8, 3, 1, 0),
1326 ES1938_SINGLE("Capture Switch", 0, 0x1c, 4, 1, 1),
1328 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
1329 .name = "Capture Source",
1330 .info = snd_es1938_info_mux,
1331 .get = snd_es1938_get_mux,
1332 .put = snd_es1938_put_mux,
1334 ES1938_DOUBLE_TLV("Mono Input Playback Volume", 0, 0x6d, 0x6d, 4, 0, 15, 0,
1336 ES1938_DOUBLE_TLV("PCM Capture Volume", 0, 0x69, 0x69, 4, 0, 15, 0,
1338 ES1938_DOUBLE_TLV("Mic Capture Volume", 0, 0x68, 0x68, 4, 0, 15, 0,
1340 ES1938_DOUBLE_TLV("Line Capture Volume", 0, 0x6e, 0x6e, 4, 0, 15, 0,
1342 ES1938_DOUBLE_TLV("FM Capture Volume", 0, 0x6b, 0x6b, 4, 0, 15, 0,
1344 ES1938_DOUBLE_TLV("Mono Capture Volume", 0, 0x6f, 0x6f, 4, 0, 15, 0,
1346 ES1938_DOUBLE_TLV("CD Capture Volume", 0, 0x6a, 0x6a, 4, 0, 15, 0,
1348 ES1938_DOUBLE_TLV("Aux Capture Volume", 0, 0x6c, 0x6c, 4, 0, 15, 0,
1350 ES1938_DOUBLE_TLV("PCM Playback Volume", 0, 0x7c, 0x7c, 4, 0, 15, 0,
1352 ES1938_DOUBLE_TLV("PCM Playback Volume", 1, 0x14, 0x14, 4, 0, 15, 0,
1354 ES1938_SINGLE("3D Control - Level", 0, 0x52, 0, 63, 0),
1356 .iface = SNDRV_CTL_ELEM_IFACE_MIXER,
1357 .name = "3D Control - Switch",
1358 .info = snd_es1938_info_spatializer_enable,
1359 .get = snd_es1938_get_spatializer_enable,
1360 .put = snd_es1938_put_spatializer_enable,
1362 ES1938_SINGLE("Mic Boost (+26dB)", 0, 0x7d, 3, 1, 0)
1366 /* ---------------------------------------------------------------------------- */
1367 /* ---------------------------------------------------------------------------- */
1370 * initialize the chip - used by resume callback, too
1372 static void snd_es1938_chip_init(struct es1938 *chip)
1375 snd_es1938_reset(chip);
1377 /* configure native mode */
1379 /* enable bus master */
1380 pci_set_master(chip->pci);
1382 /* disable legacy audio */
1383 pci_write_config_word(chip->pci, SL_PCI_LEGACYCONTROL, 0x805f);
1386 pci_write_config_word(chip->pci, SL_PCI_DDMACONTROL, chip->ddma_port | 1);
1388 /* set DMA/IRQ policy */
1389 pci_write_config_dword(chip->pci, SL_PCI_CONFIG, 0);
1391 /* enable Audio 1, Audio 2, MPU401 IRQ and HW volume IRQ*/
1392 outb(0xf0, SLIO_REG(chip, IRQCONTROL));
1395 outb(0, SLDM_REG(chip, DMACLEAR));
1398 #ifdef CONFIG_PM_SLEEP
1403 static const unsigned char saved_regs[SAVED_REG_SIZE+1] = {
1404 0x14, 0x1a, 0x1c, 0x3a, 0x3c, 0x3e, 0x36, 0x38,
1405 0x50, 0x52, 0x60, 0x61, 0x62, 0x63, 0x64, 0x68,
1406 0x69, 0x6a, 0x6b, 0x6d, 0x6e, 0x6f, 0x7c, 0x7d,
1411 static int es1938_suspend(struct device *dev)
1413 struct snd_card *card = dev_get_drvdata(dev);
1414 struct es1938 *chip = card->private_data;
1415 const unsigned char *s;
1418 snd_power_change_state(card, SNDRV_CTL_POWER_D3hot);
1420 /* save mixer-related registers */
1421 for (s = saved_regs, d = chip->saved_regs; *s; s++, d++)
1422 *d = snd_es1938_reg_read(chip, *s);
1424 outb(0x00, SLIO_REG(chip, IRQCONTROL)); /* disable irqs */
1425 if (chip->irq >= 0) {
1426 free_irq(chip->irq, chip);
1428 card->sync_irq = -1;
1433 static int es1938_resume(struct device *dev)
1435 struct pci_dev *pci = to_pci_dev(dev);
1436 struct snd_card *card = dev_get_drvdata(dev);
1437 struct es1938 *chip = card->private_data;
1438 const unsigned char *s;
1441 if (request_irq(pci->irq, snd_es1938_interrupt,
1442 IRQF_SHARED, KBUILD_MODNAME, chip)) {
1443 dev_err(dev, "unable to grab IRQ %d, disabling device\n",
1445 snd_card_disconnect(card);
1448 chip->irq = pci->irq;
1449 card->sync_irq = chip->irq;
1450 snd_es1938_chip_init(chip);
1452 /* restore mixer-related registers */
1453 for (s = saved_regs, d = chip->saved_regs; *s; s++, d++) {
1455 snd_es1938_mixer_write(chip, *s, *d);
1457 snd_es1938_write(chip, *s, *d);
1460 snd_power_change_state(card, SNDRV_CTL_POWER_D0);
1464 static SIMPLE_DEV_PM_OPS(es1938_pm, es1938_suspend, es1938_resume);
1465 #define ES1938_PM_OPS &es1938_pm
1467 #define ES1938_PM_OPS NULL
1468 #endif /* CONFIG_PM_SLEEP */
1470 #ifdef SUPPORT_JOYSTICK
1471 static int snd_es1938_create_gameport(struct es1938 *chip)
1473 struct gameport *gp;
1475 chip->gameport = gp = gameport_allocate_port();
1477 dev_err(chip->card->dev,
1478 "cannot allocate memory for gameport\n");
1482 gameport_set_name(gp, "ES1938");
1483 gameport_set_phys(gp, "pci%s/gameport0", pci_name(chip->pci));
1484 gameport_set_dev_parent(gp, &chip->pci->dev);
1485 gp->io = chip->game_port;
1487 gameport_register_port(gp);
1492 static void snd_es1938_free_gameport(struct es1938 *chip)
1494 if (chip->gameport) {
1495 gameport_unregister_port(chip->gameport);
1496 chip->gameport = NULL;
1500 static inline int snd_es1938_create_gameport(struct es1938 *chip) { return -ENOSYS; }
1501 static inline void snd_es1938_free_gameport(struct es1938 *chip) { }
1502 #endif /* SUPPORT_JOYSTICK */
1504 static void snd_es1938_free(struct snd_card *card)
1506 struct es1938 *chip = card->private_data;
1509 outb(0x00, SLIO_REG(chip, IRQCONTROL));
1511 snd_es1938_mixer_bits(chip, ESSSB_IREG_MPU401CONTROL, 0x40, 0);
1513 snd_es1938_free_gameport(chip);
1516 free_irq(chip->irq, chip);
1519 static int snd_es1938_create(struct snd_card *card,
1520 struct pci_dev *pci)
1522 struct es1938 *chip = card->private_data;
1525 /* enable PCI device */
1526 err = pcim_enable_device(pci);
1529 /* check, if we can restrict PCI DMA transfers to 24 bits */
1530 if (dma_set_mask_and_coherent(&pci->dev, DMA_BIT_MASK(24))) {
1532 "architecture does not support 24bit PCI busmaster DMA\n");
1536 spin_lock_init(&chip->reg_lock);
1537 spin_lock_init(&chip->mixer_lock);
1541 err = pci_request_regions(pci, "ESS Solo-1");
1544 chip->io_port = pci_resource_start(pci, 0);
1545 chip->sb_port = pci_resource_start(pci, 1);
1546 chip->vc_port = pci_resource_start(pci, 2);
1547 chip->mpu_port = pci_resource_start(pci, 3);
1548 chip->game_port = pci_resource_start(pci, 4);
1549 /* still use non-managed irq handler as it's re-acquired at PM resume */
1550 if (request_irq(pci->irq, snd_es1938_interrupt, IRQF_SHARED,
1551 KBUILD_MODNAME, chip)) {
1552 dev_err(card->dev, "unable to grab IRQ %d\n", pci->irq);
1555 chip->irq = pci->irq;
1556 card->sync_irq = chip->irq;
1557 card->private_free = snd_es1938_free;
1559 "create: io: 0x%lx, sb: 0x%lx, vc: 0x%lx, mpu: 0x%lx, game: 0x%lx\n",
1560 chip->io_port, chip->sb_port, chip->vc_port, chip->mpu_port, chip->game_port);
1562 chip->ddma_port = chip->vc_port + 0x00; /* fix from Thomas Sailer */
1564 snd_es1938_chip_init(chip);
1568 /* --------------------------------------------------------------------
1570 * -------------------------------------------------------------------- */
1571 static irqreturn_t snd_es1938_interrupt(int irq, void *dev_id)
1573 struct es1938 *chip = dev_id;
1574 unsigned char status;
1575 __always_unused unsigned char audiostatus;
1578 status = inb(SLIO_REG(chip, IRQCONTROL));
1580 dev_dbg(chip->card->dev,
1581 "Es1938debug - interrupt status: =0x%x\n", status);
1585 if (status & 0x10) {
1587 dev_dbg(chip->card->dev,
1588 "Es1938debug - AUDIO channel 1 interrupt\n");
1589 dev_dbg(chip->card->dev,
1590 "Es1938debug - AUDIO channel 1 DMAC DMA count: %u\n",
1591 inw(SLDM_REG(chip, DMACOUNT)));
1592 dev_dbg(chip->card->dev,
1593 "Es1938debug - AUDIO channel 1 DMAC DMA base: %u\n",
1594 inl(SLDM_REG(chip, DMAADDR)));
1595 dev_dbg(chip->card->dev,
1596 "Es1938debug - AUDIO channel 1 DMAC DMA status: 0x%x\n",
1597 inl(SLDM_REG(chip, DMASTATUS)));
1601 audiostatus = inb(SLSB_REG(chip, STATUS));
1602 if (chip->active & ADC1)
1603 snd_pcm_period_elapsed(chip->capture_substream);
1604 else if (chip->active & DAC1)
1605 snd_pcm_period_elapsed(chip->playback2_substream);
1609 if (status & 0x20) {
1611 dev_dbg(chip->card->dev,
1612 "Es1938debug - AUDIO channel 2 interrupt\n");
1613 dev_dbg(chip->card->dev,
1614 "Es1938debug - AUDIO channel 2 DMAC DMA count: %u\n",
1615 inw(SLIO_REG(chip, AUDIO2DMACOUNT)));
1616 dev_dbg(chip->card->dev,
1617 "Es1938debug - AUDIO channel 2 DMAC DMA base: %u\n",
1618 inl(SLIO_REG(chip, AUDIO2DMAADDR)));
1623 snd_es1938_mixer_bits(chip, ESSSB_IREG_AUDIO2CONTROL2, 0x80, 0);
1624 if (chip->active & DAC2)
1625 snd_pcm_period_elapsed(chip->playback1_substream);
1628 /* Hardware volume */
1629 if (status & 0x40) {
1630 int split = snd_es1938_mixer_read(chip, 0x64) & 0x80;
1632 snd_ctl_notify(chip->card, SNDRV_CTL_EVENT_MASK_VALUE, &chip->hw_switch->id);
1633 snd_ctl_notify(chip->card, SNDRV_CTL_EVENT_MASK_VALUE, &chip->hw_volume->id);
1635 snd_ctl_notify(chip->card, SNDRV_CTL_EVENT_MASK_VALUE,
1636 &chip->master_switch->id);
1637 snd_ctl_notify(chip->card, SNDRV_CTL_EVENT_MASK_VALUE,
1638 &chip->master_volume->id);
1641 snd_es1938_mixer_write(chip, 0x66, 0x00);
1645 if (status & 0x80) {
1646 // the following line is evil! It switches off MIDI interrupt handling after the first interrupt received.
1647 // replacing the last 0 by 0x40 works for ESS-Solo1, but just doing nothing works as well!
1648 // andreas@flying-snail.de
1649 // snd_es1938_mixer_bits(chip, ESSSB_IREG_MPU401CONTROL, 0x40, 0); /* ack? */
1652 snd_mpu401_uart_interrupt(irq, chip->rmidi->private_data);
1655 return IRQ_RETVAL(handled);
1658 #define ES1938_DMA_SIZE 64
1660 static int snd_es1938_mixer(struct es1938 *chip)
1662 struct snd_card *card;
1668 strcpy(card->mixername, "ESS Solo-1");
1670 for (idx = 0; idx < ARRAY_SIZE(snd_es1938_controls); idx++) {
1671 struct snd_kcontrol *kctl;
1672 kctl = snd_ctl_new1(&snd_es1938_controls[idx], chip);
1675 chip->master_volume = kctl;
1676 kctl->private_free = snd_es1938_hwv_free;
1679 chip->master_switch = kctl;
1680 kctl->private_free = snd_es1938_hwv_free;
1683 chip->hw_volume = kctl;
1684 kctl->private_free = snd_es1938_hwv_free;
1687 chip->hw_switch = kctl;
1688 kctl->private_free = snd_es1938_hwv_free;
1691 err = snd_ctl_add(card, kctl);
1699 static int __snd_es1938_probe(struct pci_dev *pci,
1700 const struct pci_device_id *pci_id)
1703 struct snd_card *card;
1704 struct es1938 *chip;
1705 struct snd_opl3 *opl3;
1708 if (dev >= SNDRV_CARDS)
1715 err = snd_devm_card_new(&pci->dev, index[dev], id[dev], THIS_MODULE,
1716 sizeof(*chip), &card);
1719 chip = card->private_data;
1721 for (idx = 0; idx < 5; idx++)
1722 if (pci_resource_start(pci, idx) == 0 ||
1723 !(pci_resource_flags(pci, idx) & IORESOURCE_IO))
1726 err = snd_es1938_create(card, pci);
1730 strcpy(card->driver, "ES1938");
1731 strcpy(card->shortname, "ESS ES1938 (Solo-1)");
1732 sprintf(card->longname, "%s rev %i, irq %i",
1737 err = snd_es1938_new_pcm(chip, 0);
1740 err = snd_es1938_mixer(chip);
1743 if (snd_opl3_create(card,
1744 SLSB_REG(chip, FMLOWADDR),
1745 SLSB_REG(chip, FMHIGHADDR),
1746 OPL3_HW_OPL3, 1, &opl3) < 0) {
1747 dev_err(card->dev, "OPL3 not detected at 0x%lx\n",
1748 SLSB_REG(chip, FMLOWADDR));
1750 err = snd_opl3_timer_new(opl3, 0, 1);
1753 err = snd_opl3_hwdep_new(opl3, 0, 1, NULL);
1757 if (snd_mpu401_uart_new(card, 0, MPU401_HW_MPU401,
1759 MPU401_INFO_INTEGRATED | MPU401_INFO_IRQ_HOOK,
1760 -1, &chip->rmidi) < 0) {
1761 dev_err(card->dev, "unable to initialize MPU-401\n");
1763 // this line is vital for MIDI interrupt handling on ess-solo1
1764 // andreas@flying-snail.de
1765 snd_es1938_mixer_bits(chip, ESSSB_IREG_MPU401CONTROL, 0x40, 0x40);
1768 snd_es1938_create_gameport(chip);
1770 err = snd_card_register(card);
1774 pci_set_drvdata(pci, card);
1779 static int snd_es1938_probe(struct pci_dev *pci,
1780 const struct pci_device_id *pci_id)
1782 return snd_card_free_on_error(&pci->dev, __snd_es1938_probe(pci, pci_id));
1785 static struct pci_driver es1938_driver = {
1786 .name = KBUILD_MODNAME,
1787 .id_table = snd_es1938_ids,
1788 .probe = snd_es1938_probe,
1790 .pm = ES1938_PM_OPS,
1794 module_pci_driver(es1938_driver);