xref: /openbmc/linux/sound/isa/es1688/es1688_lib.c (revision 854577ac)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>
4  *  Routines for control of ESS ES1688/688/488 chip
5  */
6 
7 #include <linux/init.h>
8 #include <linux/interrupt.h>
9 #include <linux/delay.h>
10 #include <linux/slab.h>
11 #include <linux/ioport.h>
12 #include <linux/module.h>
13 #include <linux/io.h>
14 #include <sound/core.h>
15 #include <sound/es1688.h>
16 #include <sound/initval.h>
17 
18 #include <asm/dma.h>
19 
20 MODULE_AUTHOR("Jaroslav Kysela <perex@perex.cz>");
21 MODULE_DESCRIPTION("ESS ESx688 lowlevel module");
22 MODULE_LICENSE("GPL");
23 
24 static int snd_es1688_dsp_command(struct snd_es1688 *chip, unsigned char val)
25 {
26 	int i;
27 
28 	for (i = 10000; i; i--)
29 		if ((inb(ES1688P(chip, STATUS)) & 0x80) == 0) {
30 			outb(val, ES1688P(chip, COMMAND));
31 			return 1;
32 		}
33 #ifdef CONFIG_SND_DEBUG
34 	printk(KERN_DEBUG "snd_es1688_dsp_command: timeout (0x%x)\n", val);
35 #endif
36 	return 0;
37 }
38 
39 static int snd_es1688_dsp_get_byte(struct snd_es1688 *chip)
40 {
41 	int i;
42 
43 	for (i = 1000; i; i--)
44 		if (inb(ES1688P(chip, DATA_AVAIL)) & 0x80)
45 			return inb(ES1688P(chip, READ));
46 	snd_printd("es1688 get byte failed: 0x%lx = 0x%x!!!\n", ES1688P(chip, DATA_AVAIL), inb(ES1688P(chip, DATA_AVAIL)));
47 	return -ENODEV;
48 }
49 
50 static int snd_es1688_write(struct snd_es1688 *chip,
51 			    unsigned char reg, unsigned char data)
52 {
53 	if (!snd_es1688_dsp_command(chip, reg))
54 		return 0;
55 	return snd_es1688_dsp_command(chip, data);
56 }
57 
58 static int snd_es1688_read(struct snd_es1688 *chip, unsigned char reg)
59 {
60 	/* Read a byte from an extended mode register of ES1688 */
61 	if (!snd_es1688_dsp_command(chip, 0xc0))
62 		return -1;
63 	if (!snd_es1688_dsp_command(chip, reg))
64 		return -1;
65 	return snd_es1688_dsp_get_byte(chip);
66 }
67 
68 void snd_es1688_mixer_write(struct snd_es1688 *chip,
69 			    unsigned char reg, unsigned char data)
70 {
71 	outb(reg, ES1688P(chip, MIXER_ADDR));
72 	udelay(10);
73 	outb(data, ES1688P(chip, MIXER_DATA));
74 	udelay(10);
75 }
76 
77 static unsigned char snd_es1688_mixer_read(struct snd_es1688 *chip, unsigned char reg)
78 {
79 	unsigned char result;
80 
81 	outb(reg, ES1688P(chip, MIXER_ADDR));
82 	udelay(10);
83 	result = inb(ES1688P(chip, MIXER_DATA));
84 	udelay(10);
85 	return result;
86 }
87 
88 int snd_es1688_reset(struct snd_es1688 *chip)
89 {
90 	int i;
91 
92 	outb(3, ES1688P(chip, RESET));		/* valid only for ESS chips, SB -> 1 */
93 	udelay(10);
94 	outb(0, ES1688P(chip, RESET));
95 	udelay(30);
96 	for (i = 0; i < 1000 && !(inb(ES1688P(chip, DATA_AVAIL)) & 0x80); i++);
97 	if (inb(ES1688P(chip, READ)) != 0xaa) {
98 		snd_printd("ess_reset at 0x%lx: failed!!!\n", chip->port);
99 		return -ENODEV;
100 	}
101 	snd_es1688_dsp_command(chip, 0xc6);	/* enable extended mode */
102 	return 0;
103 }
104 EXPORT_SYMBOL(snd_es1688_reset);
105 
106 static int snd_es1688_probe(struct snd_es1688 *chip)
107 {
108 	unsigned long flags;
109 	unsigned short major, minor;
110 	int i;
111 
112 	/*
113 	 *  initialization sequence
114 	 */
115 
116 	spin_lock_irqsave(&chip->reg_lock, flags);	/* Some ESS1688 cards need this */
117 	inb(ES1688P(chip, ENABLE1));	/* ENABLE1 */
118 	inb(ES1688P(chip, ENABLE1));	/* ENABLE1 */
119 	inb(ES1688P(chip, ENABLE1));	/* ENABLE1 */
120 	inb(ES1688P(chip, ENABLE2));	/* ENABLE2 */
121 	inb(ES1688P(chip, ENABLE1));	/* ENABLE1 */
122 	inb(ES1688P(chip, ENABLE2));	/* ENABLE2 */
123 	inb(ES1688P(chip, ENABLE1));	/* ENABLE1 */
124 	inb(ES1688P(chip, ENABLE1));	/* ENABLE1 */
125 	inb(ES1688P(chip, ENABLE2));	/* ENABLE2 */
126 	inb(ES1688P(chip, ENABLE1));	/* ENABLE1 */
127 	inb(ES1688P(chip, ENABLE0));	/* ENABLE0 */
128 
129 	if (snd_es1688_reset(chip) < 0) {
130 		snd_printdd("ESS: [0x%lx] reset failed... 0x%x\n", chip->port, inb(ES1688P(chip, READ)));
131 		spin_unlock_irqrestore(&chip->reg_lock, flags);
132 		return -ENODEV;
133 	}
134 	snd_es1688_dsp_command(chip, 0xe7);	/* return identification */
135 
136 	for (i = 1000, major = minor = 0; i; i--) {
137 		if (inb(ES1688P(chip, DATA_AVAIL)) & 0x80) {
138 			if (major == 0) {
139 				major = inb(ES1688P(chip, READ));
140 			} else {
141 				minor = inb(ES1688P(chip, READ));
142 			}
143 		}
144 	}
145 
146 	spin_unlock_irqrestore(&chip->reg_lock, flags);
147 
148 	snd_printdd("ESS: [0x%lx] found.. major = 0x%x, minor = 0x%x\n", chip->port, major, minor);
149 
150 	chip->version = (major << 8) | minor;
151 	if (!chip->version)
152 		return -ENODEV;	/* probably SB */
153 
154 	switch (chip->version & 0xfff0) {
155 	case 0x4880:
156 		snd_printk(KERN_ERR "[0x%lx] ESS: AudioDrive ES488 detected, "
157 			   "but driver is in another place\n", chip->port);
158 		return -ENODEV;
159 	case 0x6880:
160 		break;
161 	default:
162 		snd_printk(KERN_ERR "[0x%lx] ESS: unknown AudioDrive chip "
163 			   "with version 0x%x (Jazz16 soundcard?)\n",
164 			   chip->port, chip->version);
165 		return -ENODEV;
166 	}
167 
168 	spin_lock_irqsave(&chip->reg_lock, flags);
169 	snd_es1688_write(chip, 0xb1, 0x10);	/* disable IRQ */
170 	snd_es1688_write(chip, 0xb2, 0x00);	/* disable DMA */
171 	spin_unlock_irqrestore(&chip->reg_lock, flags);
172 
173 	/* enable joystick, but disable OPL3 */
174 	spin_lock_irqsave(&chip->mixer_lock, flags);
175 	snd_es1688_mixer_write(chip, 0x40, 0x01);
176 	spin_unlock_irqrestore(&chip->mixer_lock, flags);
177 
178 	return 0;
179 }
180 
181 static int snd_es1688_init(struct snd_es1688 * chip, int enable)
182 {
183 	static const int irqs[16] = {-1, -1, 0, -1, -1, 1, -1, 2, -1, 0, 3, -1, -1, -1, -1, -1};
184 	unsigned long flags;
185 	int cfg, irq_bits, dma, dma_bits, tmp, tmp1;
186 
187 	/* ok.. setup MPU-401 port and joystick and OPL3 */
188 	cfg = 0x01;		/* enable joystick, but disable OPL3 */
189 	if (enable && chip->mpu_port >= 0x300 && chip->mpu_irq > 0 && chip->hardware != ES1688_HW_688) {
190 		tmp = (chip->mpu_port & 0x0f0) >> 4;
191 		if (tmp <= 3) {
192 			switch (chip->mpu_irq) {
193 			case 9:
194 				tmp1 = 4;
195 				break;
196 			case 5:
197 				tmp1 = 5;
198 				break;
199 			case 7:
200 				tmp1 = 6;
201 				break;
202 			case 10:
203 				tmp1 = 7;
204 				break;
205 			default:
206 				tmp1 = 0;
207 			}
208 			if (tmp1) {
209 				cfg |= (tmp << 3) | (tmp1 << 5);
210 			}
211 		}
212 	}
213 #if 0
214 	snd_printk(KERN_DEBUG "mpu cfg = 0x%x\n", cfg);
215 #endif
216 	spin_lock_irqsave(&chip->reg_lock, flags);
217 	snd_es1688_mixer_write(chip, 0x40, cfg);
218 	spin_unlock_irqrestore(&chip->reg_lock, flags);
219 	/* --- */
220 	spin_lock_irqsave(&chip->reg_lock, flags);
221 	snd_es1688_read(chip, 0xb1);
222 	snd_es1688_read(chip, 0xb2);
223 	spin_unlock_irqrestore(&chip->reg_lock, flags);
224 	if (enable) {
225 		cfg = 0xf0;	/* enable only DMA counter interrupt */
226 		irq_bits = irqs[chip->irq & 0x0f];
227 		if (irq_bits < 0) {
228 			snd_printk(KERN_ERR "[0x%lx] ESS: bad IRQ %d "
229 				   "for ES1688 chip!!\n",
230 				   chip->port, chip->irq);
231 #if 0
232 			irq_bits = 0;
233 			cfg = 0x10;
234 #endif
235 			return -EINVAL;
236 		}
237 		spin_lock_irqsave(&chip->reg_lock, flags);
238 		snd_es1688_write(chip, 0xb1, cfg | (irq_bits << 2));
239 		spin_unlock_irqrestore(&chip->reg_lock, flags);
240 		cfg = 0xf0;	/* extended mode DMA enable */
241 		dma = chip->dma8;
242 		if (dma > 3 || dma == 2) {
243 			snd_printk(KERN_ERR "[0x%lx] ESS: bad DMA channel %d "
244 				   "for ES1688 chip!!\n", chip->port, dma);
245 #if 0
246 			dma_bits = 0;
247 			cfg = 0x00;	/* disable all DMA */
248 #endif
249 			return -EINVAL;
250 		} else {
251 			dma_bits = dma;
252 			if (dma != 3)
253 				dma_bits++;
254 		}
255 		spin_lock_irqsave(&chip->reg_lock, flags);
256 		snd_es1688_write(chip, 0xb2, cfg | (dma_bits << 2));
257 		spin_unlock_irqrestore(&chip->reg_lock, flags);
258 	} else {
259 		spin_lock_irqsave(&chip->reg_lock, flags);
260 		snd_es1688_write(chip, 0xb1, 0x10);	/* disable IRQ */
261 		snd_es1688_write(chip, 0xb2, 0x00);	/* disable DMA */
262 		spin_unlock_irqrestore(&chip->reg_lock, flags);
263 	}
264 	spin_lock_irqsave(&chip->reg_lock, flags);
265 	snd_es1688_read(chip, 0xb1);
266 	snd_es1688_read(chip, 0xb2);
267 	snd_es1688_reset(chip);
268 	spin_unlock_irqrestore(&chip->reg_lock, flags);
269 	return 0;
270 }
271 
272 /*
273 
274  */
275 
276 static const struct snd_ratnum clocks[2] = {
277 	{
278 		.num = 795444,
279 		.den_min = 1,
280 		.den_max = 128,
281 		.den_step = 1,
282 	},
283 	{
284 		.num = 397722,
285 		.den_min = 1,
286 		.den_max = 128,
287 		.den_step = 1,
288 	}
289 };
290 
291 static const struct snd_pcm_hw_constraint_ratnums hw_constraints_clocks  = {
292 	.nrats = 2,
293 	.rats = clocks,
294 };
295 
296 static void snd_es1688_set_rate(struct snd_es1688 *chip, struct snd_pcm_substream *substream)
297 {
298 	struct snd_pcm_runtime *runtime = substream->runtime;
299 	unsigned int bits, divider;
300 
301 	if (runtime->rate_num == clocks[0].num)
302 		bits = 256 - runtime->rate_den;
303 	else
304 		bits = 128 - runtime->rate_den;
305 	/* set filter register */
306 	divider = 256 - 7160000*20/(8*82*runtime->rate);
307 	/* write result to hardware */
308 	snd_es1688_write(chip, 0xa1, bits);
309 	snd_es1688_write(chip, 0xa2, divider);
310 }
311 
312 static int snd_es1688_trigger(struct snd_es1688 *chip, int cmd, unsigned char value)
313 {
314 	int val;
315 
316 	if (cmd == SNDRV_PCM_TRIGGER_STOP) {
317 		value = 0x00;
318 	} else if (cmd != SNDRV_PCM_TRIGGER_START) {
319 		return -EINVAL;
320 	}
321 	spin_lock(&chip->reg_lock);
322 	chip->trigger_value = value;
323 	val = snd_es1688_read(chip, 0xb8);
324 	if ((val < 0) || (val & 0x0f) == value) {
325 		spin_unlock(&chip->reg_lock);
326 		return -EINVAL;	/* something is wrong */
327 	}
328 #if 0
329 	printk(KERN_DEBUG "trigger: val = 0x%x, value = 0x%x\n", val, value);
330 	printk(KERN_DEBUG "trigger: pointer = 0x%x\n",
331 	       snd_dma_pointer(chip->dma8, chip->dma_size));
332 #endif
333 	snd_es1688_write(chip, 0xb8, (val & 0xf0) | value);
334 	spin_unlock(&chip->reg_lock);
335 	return 0;
336 }
337 
338 static int snd_es1688_playback_prepare(struct snd_pcm_substream *substream)
339 {
340 	unsigned long flags;
341 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
342 	struct snd_pcm_runtime *runtime = substream->runtime;
343 	unsigned int size = snd_pcm_lib_buffer_bytes(substream);
344 	unsigned int count = snd_pcm_lib_period_bytes(substream);
345 
346 	chip->dma_size = size;
347 	spin_lock_irqsave(&chip->reg_lock, flags);
348 	snd_es1688_reset(chip);
349 	snd_es1688_set_rate(chip, substream);
350 	snd_es1688_write(chip, 0xb8, 4);	/* auto init DMA mode */
351 	snd_es1688_write(chip, 0xa8, (snd_es1688_read(chip, 0xa8) & ~0x03) | (3 - runtime->channels));
352 	snd_es1688_write(chip, 0xb9, 2);	/* demand mode (4 bytes/request) */
353 	if (runtime->channels == 1) {
354 		if (snd_pcm_format_width(runtime->format) == 8) {
355 			/* 8. bit mono */
356 			snd_es1688_write(chip, 0xb6, 0x80);
357 			snd_es1688_write(chip, 0xb7, 0x51);
358 			snd_es1688_write(chip, 0xb7, 0xd0);
359 		} else {
360 			/* 16. bit mono */
361 			snd_es1688_write(chip, 0xb6, 0x00);
362 			snd_es1688_write(chip, 0xb7, 0x71);
363 			snd_es1688_write(chip, 0xb7, 0xf4);
364 		}
365 	} else {
366 		if (snd_pcm_format_width(runtime->format) == 8) {
367 			/* 8. bit stereo */
368 			snd_es1688_write(chip, 0xb6, 0x80);
369 			snd_es1688_write(chip, 0xb7, 0x51);
370 			snd_es1688_write(chip, 0xb7, 0x98);
371 		} else {
372 			/* 16. bit stereo */
373 			snd_es1688_write(chip, 0xb6, 0x00);
374 			snd_es1688_write(chip, 0xb7, 0x71);
375 			snd_es1688_write(chip, 0xb7, 0xbc);
376 		}
377 	}
378 	snd_es1688_write(chip, 0xb1, (snd_es1688_read(chip, 0xb1) & 0x0f) | 0x50);
379 	snd_es1688_write(chip, 0xb2, (snd_es1688_read(chip, 0xb2) & 0x0f) | 0x50);
380 	snd_es1688_dsp_command(chip, ES1688_DSP_CMD_SPKON);
381 	spin_unlock_irqrestore(&chip->reg_lock, flags);
382 	/* --- */
383 	count = -count;
384 	snd_dma_program(chip->dma8, runtime->dma_addr, size, DMA_MODE_WRITE | DMA_AUTOINIT);
385 	spin_lock_irqsave(&chip->reg_lock, flags);
386 	snd_es1688_write(chip, 0xa4, (unsigned char) count);
387 	snd_es1688_write(chip, 0xa5, (unsigned char) (count >> 8));
388 	spin_unlock_irqrestore(&chip->reg_lock, flags);
389 	return 0;
390 }
391 
392 static int snd_es1688_playback_trigger(struct snd_pcm_substream *substream,
393 				       int cmd)
394 {
395 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
396 	return snd_es1688_trigger(chip, cmd, 0x05);
397 }
398 
399 static int snd_es1688_capture_prepare(struct snd_pcm_substream *substream)
400 {
401 	unsigned long flags;
402 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
403 	struct snd_pcm_runtime *runtime = substream->runtime;
404 	unsigned int size = snd_pcm_lib_buffer_bytes(substream);
405 	unsigned int count = snd_pcm_lib_period_bytes(substream);
406 
407 	chip->dma_size = size;
408 	spin_lock_irqsave(&chip->reg_lock, flags);
409 	snd_es1688_reset(chip);
410 	snd_es1688_set_rate(chip, substream);
411 	snd_es1688_dsp_command(chip, ES1688_DSP_CMD_SPKOFF);
412 	snd_es1688_write(chip, 0xb8, 0x0e);	/* auto init DMA mode */
413 	snd_es1688_write(chip, 0xa8, (snd_es1688_read(chip, 0xa8) & ~0x03) | (3 - runtime->channels));
414 	snd_es1688_write(chip, 0xb9, 2);	/* demand mode (4 bytes/request) */
415 	if (runtime->channels == 1) {
416 		if (snd_pcm_format_width(runtime->format) == 8) {
417 			/* 8. bit mono */
418 			snd_es1688_write(chip, 0xb7, 0x51);
419 			snd_es1688_write(chip, 0xb7, 0xd0);
420 		} else {
421 			/* 16. bit mono */
422 			snd_es1688_write(chip, 0xb7, 0x71);
423 			snd_es1688_write(chip, 0xb7, 0xf4);
424 		}
425 	} else {
426 		if (snd_pcm_format_width(runtime->format) == 8) {
427 			/* 8. bit stereo */
428 			snd_es1688_write(chip, 0xb7, 0x51);
429 			snd_es1688_write(chip, 0xb7, 0x98);
430 		} else {
431 			/* 16. bit stereo */
432 			snd_es1688_write(chip, 0xb7, 0x71);
433 			snd_es1688_write(chip, 0xb7, 0xbc);
434 		}
435 	}
436 	snd_es1688_write(chip, 0xb1, (snd_es1688_read(chip, 0xb1) & 0x0f) | 0x50);
437 	snd_es1688_write(chip, 0xb2, (snd_es1688_read(chip, 0xb2) & 0x0f) | 0x50);
438 	spin_unlock_irqrestore(&chip->reg_lock, flags);
439 	/* --- */
440 	count = -count;
441 	snd_dma_program(chip->dma8, runtime->dma_addr, size, DMA_MODE_READ | DMA_AUTOINIT);
442 	spin_lock_irqsave(&chip->reg_lock, flags);
443 	snd_es1688_write(chip, 0xa4, (unsigned char) count);
444 	snd_es1688_write(chip, 0xa5, (unsigned char) (count >> 8));
445 	spin_unlock_irqrestore(&chip->reg_lock, flags);
446 	return 0;
447 }
448 
449 static int snd_es1688_capture_trigger(struct snd_pcm_substream *substream,
450 				      int cmd)
451 {
452 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
453 	return snd_es1688_trigger(chip, cmd, 0x0f);
454 }
455 
456 static irqreturn_t snd_es1688_interrupt(int irq, void *dev_id)
457 {
458 	struct snd_es1688 *chip = dev_id;
459 
460 	if (chip->trigger_value == 0x05)	/* ok.. playback is active */
461 		snd_pcm_period_elapsed(chip->playback_substream);
462 	if (chip->trigger_value == 0x0f)	/* ok.. capture is active */
463 		snd_pcm_period_elapsed(chip->capture_substream);
464 
465 	inb(ES1688P(chip, DATA_AVAIL));	/* ack interrupt */
466 	return IRQ_HANDLED;
467 }
468 
469 static snd_pcm_uframes_t snd_es1688_playback_pointer(struct snd_pcm_substream *substream)
470 {
471 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
472 	size_t ptr;
473 
474 	if (chip->trigger_value != 0x05)
475 		return 0;
476 	ptr = snd_dma_pointer(chip->dma8, chip->dma_size);
477 	return bytes_to_frames(substream->runtime, ptr);
478 }
479 
480 static snd_pcm_uframes_t snd_es1688_capture_pointer(struct snd_pcm_substream *substream)
481 {
482 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
483 	size_t ptr;
484 
485 	if (chip->trigger_value != 0x0f)
486 		return 0;
487 	ptr = snd_dma_pointer(chip->dma8, chip->dma_size);
488 	return bytes_to_frames(substream->runtime, ptr);
489 }
490 
491 /*
492 
493  */
494 
495 static const struct snd_pcm_hardware snd_es1688_playback =
496 {
497 	.info =			(SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED |
498 				 SNDRV_PCM_INFO_MMAP_VALID),
499 	.formats =		SNDRV_PCM_FMTBIT_U8 | SNDRV_PCM_FMTBIT_S16_LE,
500 	.rates =		SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000,
501 	.rate_min =		4000,
502 	.rate_max =		48000,
503 	.channels_min =		1,
504 	.channels_max =		2,
505 	.buffer_bytes_max =	65536,
506 	.period_bytes_min =	64,
507 	.period_bytes_max =	65536,
508 	.periods_min =		1,
509 	.periods_max =		1024,
510 	.fifo_size =		0,
511 };
512 
513 static const struct snd_pcm_hardware snd_es1688_capture =
514 {
515 	.info =			(SNDRV_PCM_INFO_MMAP | SNDRV_PCM_INFO_INTERLEAVED |
516 				 SNDRV_PCM_INFO_MMAP_VALID),
517 	.formats =		SNDRV_PCM_FMTBIT_U8 | SNDRV_PCM_FMTBIT_S16_LE,
518 	.rates =		SNDRV_PCM_RATE_CONTINUOUS | SNDRV_PCM_RATE_8000_48000,
519 	.rate_min =		4000,
520 	.rate_max =		48000,
521 	.channels_min =		1,
522 	.channels_max =		2,
523 	.buffer_bytes_max =	65536,
524 	.period_bytes_min =	64,
525 	.period_bytes_max =	65536,
526 	.periods_min =		1,
527 	.periods_max =		1024,
528 	.fifo_size =		0,
529 };
530 
531 /*
532 
533  */
534 
535 static int snd_es1688_playback_open(struct snd_pcm_substream *substream)
536 {
537 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
538 	struct snd_pcm_runtime *runtime = substream->runtime;
539 
540 	if (chip->capture_substream != NULL)
541 		return -EAGAIN;
542 	chip->playback_substream = substream;
543 	runtime->hw = snd_es1688_playback;
544 	snd_pcm_hw_constraint_ratnums(runtime, 0, SNDRV_PCM_HW_PARAM_RATE,
545 				      &hw_constraints_clocks);
546 	return 0;
547 }
548 
549 static int snd_es1688_capture_open(struct snd_pcm_substream *substream)
550 {
551 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
552 	struct snd_pcm_runtime *runtime = substream->runtime;
553 
554 	if (chip->playback_substream != NULL)
555 		return -EAGAIN;
556 	chip->capture_substream = substream;
557 	runtime->hw = snd_es1688_capture;
558 	snd_pcm_hw_constraint_ratnums(runtime, 0, SNDRV_PCM_HW_PARAM_RATE,
559 				      &hw_constraints_clocks);
560 	return 0;
561 }
562 
563 static int snd_es1688_playback_close(struct snd_pcm_substream *substream)
564 {
565 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
566 
567 	chip->playback_substream = NULL;
568 	return 0;
569 }
570 
571 static int snd_es1688_capture_close(struct snd_pcm_substream *substream)
572 {
573 	struct snd_es1688 *chip = snd_pcm_substream_chip(substream);
574 
575 	chip->capture_substream = NULL;
576 	return 0;
577 }
578 
579 static int snd_es1688_free(struct snd_es1688 *chip)
580 {
581 	if (chip->hardware != ES1688_HW_UNDEF)
582 		snd_es1688_init(chip, 0);
583 	return 0;
584 }
585 
586 static int snd_es1688_dev_free(struct snd_device *device)
587 {
588 	struct snd_es1688 *chip = device->device_data;
589 	return snd_es1688_free(chip);
590 }
591 
592 static const char *snd_es1688_chip_id(struct snd_es1688 *chip)
593 {
594 	static char tmp[16];
595 	sprintf(tmp, "ES%s688 rev %i", chip->hardware == ES1688_HW_688 ? "" : "1", chip->version & 0x0f);
596 	return tmp;
597 }
598 
599 int snd_es1688_create(struct snd_card *card,
600 		      struct snd_es1688 *chip,
601 		      unsigned long port,
602 		      unsigned long mpu_port,
603 		      int irq,
604 		      int mpu_irq,
605 		      int dma8,
606 		      unsigned short hardware)
607 {
608 	static const struct snd_device_ops ops = {
609 		.dev_free =	snd_es1688_dev_free,
610 	};
611 
612 	int err;
613 
614 	if (chip == NULL)
615 		return -ENOMEM;
616 	chip->irq = -1;
617 	chip->dma8 = -1;
618 	chip->hardware = ES1688_HW_UNDEF;
619 
620 	if (!devm_request_region(card->dev, port + 4, 12, "ES1688")) {
621 		snd_printk(KERN_ERR "es1688: can't grab port 0x%lx\n", port + 4);
622 		return -EBUSY;
623 	}
624 
625 	err = devm_request_irq(card->dev, irq, snd_es1688_interrupt, 0,
626 			       "ES1688", (void *) chip);
627 	if (err < 0) {
628 		snd_printk(KERN_ERR "es1688: can't grab IRQ %d\n", irq);
629 		return err;
630 	}
631 
632 	chip->irq = irq;
633 	card->sync_irq = chip->irq;
634 	err = snd_devm_request_dma(card->dev, dma8, "ES1688");
635 
636 	if (err < 0) {
637 		snd_printk(KERN_ERR "es1688: can't grab DMA8 %d\n", dma8);
638 		return err;
639 	}
640 	chip->dma8 = dma8;
641 
642 	spin_lock_init(&chip->reg_lock);
643 	spin_lock_init(&chip->mixer_lock);
644 	chip->port = port;
645 	mpu_port &= ~0x000f;
646 	if (mpu_port < 0x300 || mpu_port > 0x330)
647 		mpu_port = 0;
648 	chip->mpu_port = mpu_port;
649 	chip->mpu_irq = mpu_irq;
650 	chip->hardware = hardware;
651 
652 	err = snd_es1688_probe(chip);
653 	if (err < 0)
654 		return err;
655 
656 	err = snd_es1688_init(chip, 1);
657 	if (err < 0)
658 		return err;
659 
660 	/* Register device */
661 	err = snd_device_new(card, SNDRV_DEV_LOWLEVEL, chip, &ops);
662 	return err;
663 }
664 
665 static const struct snd_pcm_ops snd_es1688_playback_ops = {
666 	.open =			snd_es1688_playback_open,
667 	.close =		snd_es1688_playback_close,
668 	.prepare =		snd_es1688_playback_prepare,
669 	.trigger =		snd_es1688_playback_trigger,
670 	.pointer =		snd_es1688_playback_pointer,
671 };
672 
673 static const struct snd_pcm_ops snd_es1688_capture_ops = {
674 	.open =			snd_es1688_capture_open,
675 	.close =		snd_es1688_capture_close,
676 	.prepare =		snd_es1688_capture_prepare,
677 	.trigger =		snd_es1688_capture_trigger,
678 	.pointer =		snd_es1688_capture_pointer,
679 };
680 
681 int snd_es1688_pcm(struct snd_card *card, struct snd_es1688 *chip, int device)
682 {
683 	struct snd_pcm *pcm;
684 	int err;
685 
686 	err = snd_pcm_new(card, "ESx688", device, 1, 1, &pcm);
687 	if (err < 0)
688 		return err;
689 
690 	snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_PLAYBACK, &snd_es1688_playback_ops);
691 	snd_pcm_set_ops(pcm, SNDRV_PCM_STREAM_CAPTURE, &snd_es1688_capture_ops);
692 
693 	pcm->private_data = chip;
694 	pcm->info_flags = SNDRV_PCM_INFO_HALF_DUPLEX;
695 	strcpy(pcm->name, snd_es1688_chip_id(chip));
696 	chip->pcm = pcm;
697 
698 	snd_pcm_set_managed_buffer_all(pcm, SNDRV_DMA_TYPE_DEV, card->dev,
699 				       64*1024, 64*1024);
700 	return 0;
701 }
702 
703 /*
704  *  MIXER part
705  */
706 
707 static int snd_es1688_info_mux(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo)
708 {
709 	static const char * const texts[8] = {
710 		"Mic", "Mic Master", "CD", "AOUT",
711 		"Mic1", "Mix", "Line", "Master"
712 	};
713 
714 	return snd_ctl_enum_info(uinfo, 1, 8, texts);
715 }
716 
717 static int snd_es1688_get_mux(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
718 {
719 	struct snd_es1688 *chip = snd_kcontrol_chip(kcontrol);
720 	ucontrol->value.enumerated.item[0] = snd_es1688_mixer_read(chip, ES1688_REC_DEV) & 7;
721 	return 0;
722 }
723 
724 static int snd_es1688_put_mux(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
725 {
726 	struct snd_es1688 *chip = snd_kcontrol_chip(kcontrol);
727 	unsigned long flags;
728 	unsigned char oval, nval;
729 	int change;
730 
731 	if (ucontrol->value.enumerated.item[0] > 8)
732 		return -EINVAL;
733 	spin_lock_irqsave(&chip->reg_lock, flags);
734 	oval = snd_es1688_mixer_read(chip, ES1688_REC_DEV);
735 	nval = (ucontrol->value.enumerated.item[0] & 7) | (oval & ~15);
736 	change = nval != oval;
737 	if (change)
738 		snd_es1688_mixer_write(chip, ES1688_REC_DEV, nval);
739 	spin_unlock_irqrestore(&chip->reg_lock, flags);
740 	return change;
741 }
742 
743 #define ES1688_SINGLE(xname, xindex, reg, shift, mask, invert) \
744 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xindex, \
745   .info = snd_es1688_info_single, \
746   .get = snd_es1688_get_single, .put = snd_es1688_put_single, \
747   .private_value = reg | (shift << 8) | (mask << 16) | (invert << 24) }
748 
749 static int snd_es1688_info_single(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo)
750 {
751 	int mask = (kcontrol->private_value >> 16) & 0xff;
752 
753 	uinfo->type = mask == 1 ? SNDRV_CTL_ELEM_TYPE_BOOLEAN : SNDRV_CTL_ELEM_TYPE_INTEGER;
754 	uinfo->count = 1;
755 	uinfo->value.integer.min = 0;
756 	uinfo->value.integer.max = mask;
757 	return 0;
758 }
759 
760 static int snd_es1688_get_single(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
761 {
762 	struct snd_es1688 *chip = snd_kcontrol_chip(kcontrol);
763 	unsigned long flags;
764 	int reg = kcontrol->private_value & 0xff;
765 	int shift = (kcontrol->private_value >> 8) & 0xff;
766 	int mask = (kcontrol->private_value >> 16) & 0xff;
767 	int invert = (kcontrol->private_value >> 24) & 0xff;
768 
769 	spin_lock_irqsave(&chip->reg_lock, flags);
770 	ucontrol->value.integer.value[0] = (snd_es1688_mixer_read(chip, reg) >> shift) & mask;
771 	spin_unlock_irqrestore(&chip->reg_lock, flags);
772 	if (invert)
773 		ucontrol->value.integer.value[0] = mask - ucontrol->value.integer.value[0];
774 	return 0;
775 }
776 
777 static int snd_es1688_put_single(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
778 {
779 	struct snd_es1688 *chip = snd_kcontrol_chip(kcontrol);
780 	unsigned long flags;
781 	int reg = kcontrol->private_value & 0xff;
782 	int shift = (kcontrol->private_value >> 8) & 0xff;
783 	int mask = (kcontrol->private_value >> 16) & 0xff;
784 	int invert = (kcontrol->private_value >> 24) & 0xff;
785 	int change;
786 	unsigned char oval, nval;
787 
788 	nval = (ucontrol->value.integer.value[0] & mask);
789 	if (invert)
790 		nval = mask - nval;
791 	nval <<= shift;
792 	spin_lock_irqsave(&chip->reg_lock, flags);
793 	oval = snd_es1688_mixer_read(chip, reg);
794 	nval = (oval & ~(mask << shift)) | nval;
795 	change = nval != oval;
796 	if (change)
797 		snd_es1688_mixer_write(chip, reg, nval);
798 	spin_unlock_irqrestore(&chip->reg_lock, flags);
799 	return change;
800 }
801 
802 #define ES1688_DOUBLE(xname, xindex, left_reg, right_reg, shift_left, shift_right, mask, invert) \
803 { .iface = SNDRV_CTL_ELEM_IFACE_MIXER, .name = xname, .index = xindex, \
804   .info = snd_es1688_info_double, \
805   .get = snd_es1688_get_double, .put = snd_es1688_put_double, \
806   .private_value = left_reg | (right_reg << 8) | (shift_left << 16) | (shift_right << 19) | (mask << 24) | (invert << 22) }
807 
808 static int snd_es1688_info_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_info *uinfo)
809 {
810 	int mask = (kcontrol->private_value >> 24) & 0xff;
811 
812 	uinfo->type = mask == 1 ? SNDRV_CTL_ELEM_TYPE_BOOLEAN : SNDRV_CTL_ELEM_TYPE_INTEGER;
813 	uinfo->count = 2;
814 	uinfo->value.integer.min = 0;
815 	uinfo->value.integer.max = mask;
816 	return 0;
817 }
818 
819 static int snd_es1688_get_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
820 {
821 	struct snd_es1688 *chip = snd_kcontrol_chip(kcontrol);
822 	unsigned long flags;
823 	int left_reg = kcontrol->private_value & 0xff;
824 	int right_reg = (kcontrol->private_value >> 8) & 0xff;
825 	int shift_left = (kcontrol->private_value >> 16) & 0x07;
826 	int shift_right = (kcontrol->private_value >> 19) & 0x07;
827 	int mask = (kcontrol->private_value >> 24) & 0xff;
828 	int invert = (kcontrol->private_value >> 22) & 1;
829 	unsigned char left, right;
830 
831 	spin_lock_irqsave(&chip->reg_lock, flags);
832 	if (left_reg < 0xa0)
833 		left = snd_es1688_mixer_read(chip, left_reg);
834 	else
835 		left = snd_es1688_read(chip, left_reg);
836 	if (left_reg != right_reg) {
837 		if (right_reg < 0xa0)
838 			right = snd_es1688_mixer_read(chip, right_reg);
839 		else
840 			right = snd_es1688_read(chip, right_reg);
841 	} else
842 		right = left;
843 	spin_unlock_irqrestore(&chip->reg_lock, flags);
844 	ucontrol->value.integer.value[0] = (left >> shift_left) & mask;
845 	ucontrol->value.integer.value[1] = (right >> shift_right) & mask;
846 	if (invert) {
847 		ucontrol->value.integer.value[0] = mask - ucontrol->value.integer.value[0];
848 		ucontrol->value.integer.value[1] = mask - ucontrol->value.integer.value[1];
849 	}
850 	return 0;
851 }
852 
853 static int snd_es1688_put_double(struct snd_kcontrol *kcontrol, struct snd_ctl_elem_value *ucontrol)
854 {
855 	struct snd_es1688 *chip = snd_kcontrol_chip(kcontrol);
856 	unsigned long flags;
857 	int left_reg = kcontrol->private_value & 0xff;
858 	int right_reg = (kcontrol->private_value >> 8) & 0xff;
859 	int shift_left = (kcontrol->private_value >> 16) & 0x07;
860 	int shift_right = (kcontrol->private_value >> 19) & 0x07;
861 	int mask = (kcontrol->private_value >> 24) & 0xff;
862 	int invert = (kcontrol->private_value >> 22) & 1;
863 	int change;
864 	unsigned char val1, val2, oval1, oval2;
865 
866 	val1 = ucontrol->value.integer.value[0] & mask;
867 	val2 = ucontrol->value.integer.value[1] & mask;
868 	if (invert) {
869 		val1 = mask - val1;
870 		val2 = mask - val2;
871 	}
872 	val1 <<= shift_left;
873 	val2 <<= shift_right;
874 	spin_lock_irqsave(&chip->reg_lock, flags);
875 	if (left_reg != right_reg) {
876 		if (left_reg < 0xa0)
877 			oval1 = snd_es1688_mixer_read(chip, left_reg);
878 		else
879 			oval1 = snd_es1688_read(chip, left_reg);
880 		if (right_reg < 0xa0)
881 			oval2 = snd_es1688_mixer_read(chip, right_reg);
882 		else
883 			oval2 = snd_es1688_read(chip, right_reg);
884 		val1 = (oval1 & ~(mask << shift_left)) | val1;
885 		val2 = (oval2 & ~(mask << shift_right)) | val2;
886 		change = val1 != oval1 || val2 != oval2;
887 		if (change) {
888 			if (left_reg < 0xa0)
889 				snd_es1688_mixer_write(chip, left_reg, val1);
890 			else
891 				snd_es1688_write(chip, left_reg, val1);
892 			if (right_reg < 0xa0)
893 				snd_es1688_mixer_write(chip, right_reg, val1);
894 			else
895 				snd_es1688_write(chip, right_reg, val1);
896 		}
897 	} else {
898 		if (left_reg < 0xa0)
899 			oval1 = snd_es1688_mixer_read(chip, left_reg);
900 		else
901 			oval1 = snd_es1688_read(chip, left_reg);
902 		val1 = (oval1 & ~((mask << shift_left) | (mask << shift_right))) | val1 | val2;
903 		change = val1 != oval1;
904 		if (change) {
905 			if (left_reg < 0xa0)
906 				snd_es1688_mixer_write(chip, left_reg, val1);
907 			else
908 				snd_es1688_write(chip, left_reg, val1);
909 		}
910 
911 	}
912 	spin_unlock_irqrestore(&chip->reg_lock, flags);
913 	return change;
914 }
915 
916 static const struct snd_kcontrol_new snd_es1688_controls[] = {
917 ES1688_DOUBLE("Master Playback Volume", 0, ES1688_MASTER_DEV, ES1688_MASTER_DEV, 4, 0, 15, 0),
918 ES1688_DOUBLE("PCM Playback Volume", 0, ES1688_PCM_DEV, ES1688_PCM_DEV, 4, 0, 15, 0),
919 ES1688_DOUBLE("Line Playback Volume", 0, ES1688_LINE_DEV, ES1688_LINE_DEV, 4, 0, 15, 0),
920 ES1688_DOUBLE("CD Playback Volume", 0, ES1688_CD_DEV, ES1688_CD_DEV, 4, 0, 15, 0),
921 ES1688_DOUBLE("FM Playback Volume", 0, ES1688_FM_DEV, ES1688_FM_DEV, 4, 0, 15, 0),
922 ES1688_DOUBLE("Mic Playback Volume", 0, ES1688_MIC_DEV, ES1688_MIC_DEV, 4, 0, 15, 0),
923 ES1688_DOUBLE("Aux Playback Volume", 0, ES1688_AUX_DEV, ES1688_AUX_DEV, 4, 0, 15, 0),
924 ES1688_SINGLE("Beep Playback Volume", 0, ES1688_SPEAKER_DEV, 0, 7, 0),
925 ES1688_DOUBLE("Capture Volume", 0, ES1688_RECLEV_DEV, ES1688_RECLEV_DEV, 4, 0, 15, 0),
926 ES1688_SINGLE("Capture Switch", 0, ES1688_REC_DEV, 4, 1, 1),
927 {
928 	.iface = SNDRV_CTL_ELEM_IFACE_MIXER,
929 	.name = "Capture Source",
930 	.info = snd_es1688_info_mux,
931 	.get = snd_es1688_get_mux,
932 	.put = snd_es1688_put_mux,
933 },
934 };
935 
936 #define ES1688_INIT_TABLE_SIZE (sizeof(snd_es1688_init_table)/2)
937 
938 static const unsigned char snd_es1688_init_table[][2] = {
939 	{ ES1688_MASTER_DEV, 0 },
940 	{ ES1688_PCM_DEV, 0 },
941 	{ ES1688_LINE_DEV, 0 },
942 	{ ES1688_CD_DEV, 0 },
943 	{ ES1688_FM_DEV, 0 },
944 	{ ES1688_MIC_DEV, 0 },
945 	{ ES1688_AUX_DEV, 0 },
946 	{ ES1688_SPEAKER_DEV, 0 },
947 	{ ES1688_RECLEV_DEV, 0 },
948 	{ ES1688_REC_DEV, 0x17 }
949 };
950 
951 int snd_es1688_mixer(struct snd_card *card, struct snd_es1688 *chip)
952 {
953 	unsigned int idx;
954 	int err;
955 	unsigned char reg, val;
956 
957 	if (snd_BUG_ON(!chip || !card))
958 		return -EINVAL;
959 
960 	strcpy(card->mixername, snd_es1688_chip_id(chip));
961 
962 	for (idx = 0; idx < ARRAY_SIZE(snd_es1688_controls); idx++) {
963 		err = snd_ctl_add(card, snd_ctl_new1(&snd_es1688_controls[idx], chip));
964 		if (err < 0)
965 			return err;
966 	}
967 	for (idx = 0; idx < ES1688_INIT_TABLE_SIZE; idx++) {
968 		reg = snd_es1688_init_table[idx][0];
969 		val = snd_es1688_init_table[idx][1];
970 		if (reg < 0xa0)
971 			snd_es1688_mixer_write(chip, reg, val);
972 		else
973 			snd_es1688_write(chip, reg, val);
974 	}
975 	return 0;
976 }
977 
978 EXPORT_SYMBOL(snd_es1688_mixer_write);
979 EXPORT_SYMBOL(snd_es1688_create);
980 EXPORT_SYMBOL(snd_es1688_pcm);
981 EXPORT_SYMBOL(snd_es1688_mixer);
982