xref: /openbmc/linux/sound/pci/pcxhr/pcxhr_hwdep.c (revision d78c317f)
1 /*
2  * Driver for Digigram pcxhr compatible soundcards
3  *
4  * hwdep device manager
5  *
6  * Copyright (c) 2004 by Digigram <alsa@digigram.com>
7  *
8  *   This program is free software; you can redistribute it and/or modify
9  *   it under the terms of the GNU General Public License as published by
10  *   the Free Software Foundation; either version 2 of the License, or
11  *   (at your option) any later version.
12  *
13  *   This program is distributed in the hope that it will be useful,
14  *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  *   GNU General Public License for more details.
17  *
18  *   You should have received a copy of the GNU General Public License
19  *   along with this program; if not, write to the Free Software
20  *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
21  */
22 
23 #include <linux/interrupt.h>
24 #include <linux/vmalloc.h>
25 #include <linux/firmware.h>
26 #include <linux/pci.h>
27 #include <linux/module.h>
28 #include <asm/io.h>
29 #include <sound/core.h>
30 #include <sound/hwdep.h>
31 #include "pcxhr.h"
32 #include "pcxhr_mixer.h"
33 #include "pcxhr_hwdep.h"
34 #include "pcxhr_core.h"
35 #include "pcxhr_mix22.h"
36 
37 
38 #if defined(CONFIG_FW_LOADER) || defined(CONFIG_FW_LOADER_MODULE)
39 #if !defined(CONFIG_USE_PCXHRLOADER) && !defined(CONFIG_SND_PCXHR) /* built-in kernel */
40 #define SND_PCXHR_FW_LOADER	/* use the standard firmware loader */
41 #endif
42 #endif
43 
44 
45 static int pcxhr_sub_init(struct pcxhr_mgr *mgr);
46 /*
47  * get basic information and init pcxhr card
48  */
49 static int pcxhr_init_board(struct pcxhr_mgr *mgr)
50 {
51 	int err;
52 	struct pcxhr_rmh rmh;
53 	int card_streams;
54 
55 	/* calc the number of all streams used */
56 	if (mgr->mono_capture)
57 		card_streams = mgr->capture_chips * 2;
58 	else
59 		card_streams = mgr->capture_chips;
60 	card_streams += mgr->playback_chips * PCXHR_PLAYBACK_STREAMS;
61 
62 	/* enable interrupts */
63 	pcxhr_enable_dsp(mgr);
64 
65 	pcxhr_init_rmh(&rmh, CMD_SUPPORTED);
66 	err = pcxhr_send_msg(mgr, &rmh);
67 	if (err)
68 		return err;
69 	/* test 8 or 12 phys out */
70 	if ((rmh.stat[0] & MASK_FIRST_FIELD) != mgr->playback_chips * 2)
71 		return -EINVAL;
72 	/* test 8 or 2 phys in */
73 	if (((rmh.stat[0] >> (2 * FIELD_SIZE)) & MASK_FIRST_FIELD) <
74 	    mgr->capture_chips * 2)
75 		return -EINVAL;
76 	/* test max nb substream per board */
77 	if ((rmh.stat[1] & 0x5F) < card_streams)
78 		return -EINVAL;
79 	/* test max nb substream per pipe */
80 	if (((rmh.stat[1] >> 7) & 0x5F) < PCXHR_PLAYBACK_STREAMS)
81 		return -EINVAL;
82 	snd_printdd("supported formats : playback=%x capture=%x\n",
83 		    rmh.stat[2], rmh.stat[3]);
84 
85 	pcxhr_init_rmh(&rmh, CMD_VERSION);
86 	/* firmware num for DSP */
87 	rmh.cmd[0] |= mgr->firmware_num;
88 	/* transfer granularity in samples (should be multiple of 48) */
89 	rmh.cmd[1] = (1<<23) + mgr->granularity;
90 	rmh.cmd_len = 2;
91 	err = pcxhr_send_msg(mgr, &rmh);
92 	if (err)
93 		return err;
94 	snd_printdd("PCXHR DSP version is %d.%d.%d\n", (rmh.stat[0]>>16)&0xff,
95 		    (rmh.stat[0]>>8)&0xff, rmh.stat[0]&0xff);
96 	mgr->dsp_version = rmh.stat[0];
97 
98 	if (mgr->is_hr_stereo)
99 		err = hr222_sub_init(mgr);
100 	else
101 		err = pcxhr_sub_init(mgr);
102 	return err;
103 }
104 
105 static int pcxhr_sub_init(struct pcxhr_mgr *mgr)
106 {
107 	int err;
108 	struct pcxhr_rmh rmh;
109 
110 	/* get options */
111 	pcxhr_init_rmh(&rmh, CMD_ACCESS_IO_READ);
112 	rmh.cmd[0] |= IO_NUM_REG_STATUS;
113 	rmh.cmd[1]  = REG_STATUS_OPTIONS;
114 	rmh.cmd_len = 2;
115 	err = pcxhr_send_msg(mgr, &rmh);
116 	if (err)
117 		return err;
118 
119 	if ((rmh.stat[1] & REG_STATUS_OPT_DAUGHTER_MASK) ==
120 	    REG_STATUS_OPT_ANALOG_BOARD)
121 		mgr->board_has_analog = 1;	/* analog addon board found */
122 
123 	/* unmute inputs */
124 	err = pcxhr_write_io_num_reg_cont(mgr, REG_CONT_UNMUTE_INPUTS,
125 					  REG_CONT_UNMUTE_INPUTS, NULL);
126 	if (err)
127 		return err;
128 	/* unmute outputs (a write to IO_NUM_REG_MUTE_OUT mutes!) */
129 	pcxhr_init_rmh(&rmh, CMD_ACCESS_IO_READ);
130 	rmh.cmd[0] |= IO_NUM_REG_MUTE_OUT;
131 	if (DSP_EXT_CMD_SET(mgr)) {
132 		rmh.cmd[1]  = 1;	/* unmute digital plugs */
133 		rmh.cmd_len = 2;
134 	}
135 	err = pcxhr_send_msg(mgr, &rmh);
136 	return err;
137 }
138 
139 void pcxhr_reset_board(struct pcxhr_mgr *mgr)
140 {
141 	struct pcxhr_rmh rmh;
142 
143 	if (mgr->dsp_loaded & (1 << PCXHR_FIRMWARE_DSP_MAIN_INDEX)) {
144 		/* mute outputs */
145 	    if (!mgr->is_hr_stereo) {
146 		/* a read to IO_NUM_REG_MUTE_OUT register unmutes! */
147 		pcxhr_init_rmh(&rmh, CMD_ACCESS_IO_WRITE);
148 		rmh.cmd[0] |= IO_NUM_REG_MUTE_OUT;
149 		pcxhr_send_msg(mgr, &rmh);
150 		/* mute inputs */
151 		pcxhr_write_io_num_reg_cont(mgr, REG_CONT_UNMUTE_INPUTS,
152 					    0, NULL);
153 	    }
154 		/* stereo cards mute with reset of dsp */
155 	}
156 	/* reset pcxhr dsp */
157 	if (mgr->dsp_loaded & (1 << PCXHR_FIRMWARE_DSP_EPRM_INDEX))
158 		pcxhr_reset_dsp(mgr);
159 	/* reset second xilinx */
160 	if (mgr->dsp_loaded & (1 << PCXHR_FIRMWARE_XLX_COM_INDEX)) {
161 		pcxhr_reset_xilinx_com(mgr);
162 		mgr->dsp_loaded = 1;
163 	}
164 	return;
165 }
166 
167 
168 /*
169  *  allocate a playback/capture pipe (pcmp0/pcmc0)
170  */
171 static int pcxhr_dsp_allocate_pipe(struct pcxhr_mgr *mgr,
172 				   struct pcxhr_pipe *pipe,
173 				   int is_capture, int pin)
174 {
175 	int stream_count, audio_count;
176 	int err;
177 	struct pcxhr_rmh rmh;
178 
179 	if (is_capture) {
180 		stream_count = 1;
181 		if (mgr->mono_capture)
182 			audio_count = 1;
183 		else
184 			audio_count = 2;
185 	} else {
186 		stream_count = PCXHR_PLAYBACK_STREAMS;
187 		audio_count = 2;	/* always stereo */
188 	}
189 	snd_printdd("snd_add_ref_pipe pin(%d) pcm%c0\n",
190 		    pin, is_capture ? 'c' : 'p');
191 	pipe->is_capture = is_capture;
192 	pipe->first_audio = pin;
193 	/* define pipe (P_PCM_ONLY_MASK (0x020000) is not necessary) */
194 	pcxhr_init_rmh(&rmh, CMD_RES_PIPE);
195 	pcxhr_set_pipe_cmd_params(&rmh, is_capture, pin,
196 				  audio_count, stream_count);
197 	rmh.cmd[1] |= 0x020000; /* add P_PCM_ONLY_MASK */
198 	if (DSP_EXT_CMD_SET(mgr)) {
199 		/* add channel mask to command */
200 	  rmh.cmd[rmh.cmd_len++] = (audio_count == 1) ? 0x01 : 0x03;
201 	}
202 	err = pcxhr_send_msg(mgr, &rmh);
203 	if (err < 0) {
204 		snd_printk(KERN_ERR "error pipe allocation "
205 			   "(CMD_RES_PIPE) err=%x!\n", err);
206 		return err;
207 	}
208 	pipe->status = PCXHR_PIPE_DEFINED;
209 
210 	return 0;
211 }
212 
213 /*
214  *  free playback/capture pipe (pcmp0/pcmc0)
215  */
216 #if 0
217 static int pcxhr_dsp_free_pipe( struct pcxhr_mgr *mgr, struct pcxhr_pipe *pipe)
218 {
219 	struct pcxhr_rmh rmh;
220 	int capture_mask = 0;
221 	int playback_mask = 0;
222 	int err = 0;
223 
224 	if (pipe->is_capture)
225 		capture_mask  = (1 << pipe->first_audio);
226 	else
227 		playback_mask = (1 << pipe->first_audio);
228 
229 	/* stop one pipe */
230 	err = pcxhr_set_pipe_state(mgr, playback_mask, capture_mask, 0);
231 	if (err < 0)
232 		snd_printk(KERN_ERR "error stopping pipe!\n");
233 	/* release the pipe */
234 	pcxhr_init_rmh(&rmh, CMD_FREE_PIPE);
235 	pcxhr_set_pipe_cmd_params(&rmh, pipe->is_capture, pipe->first_audio,
236 				  0, 0);
237 	err = pcxhr_send_msg(mgr, &rmh);
238 	if (err < 0)
239 		snd_printk(KERN_ERR "error pipe release "
240 			   "(CMD_FREE_PIPE) err(%x)\n", err);
241 	pipe->status = PCXHR_PIPE_UNDEFINED;
242 	return err;
243 }
244 #endif
245 
246 
247 static int pcxhr_config_pipes(struct pcxhr_mgr *mgr)
248 {
249 	int err, i, j;
250 	struct snd_pcxhr *chip;
251 	struct pcxhr_pipe *pipe;
252 
253 	/* allocate the pipes on the dsp */
254 	for (i = 0; i < mgr->num_cards; i++) {
255 		chip = mgr->chip[i];
256 		if (chip->nb_streams_play) {
257 			pipe = &chip->playback_pipe;
258 			err = pcxhr_dsp_allocate_pipe( mgr, pipe, 0, i*2);
259 			if (err)
260 				return err;
261 			for(j = 0; j < chip->nb_streams_play; j++)
262 				chip->playback_stream[j].pipe = pipe;
263 		}
264 		for (j = 0; j < chip->nb_streams_capt; j++) {
265 			pipe = &chip->capture_pipe[j];
266 			err = pcxhr_dsp_allocate_pipe(mgr, pipe, 1, i*2 + j);
267 			if (err)
268 				return err;
269 			chip->capture_stream[j].pipe = pipe;
270 		}
271 	}
272 	return 0;
273 }
274 
275 static int pcxhr_start_pipes(struct pcxhr_mgr *mgr)
276 {
277 	int i, j;
278 	struct snd_pcxhr *chip;
279 	int playback_mask = 0;
280 	int capture_mask = 0;
281 
282 	/* start all the pipes on the dsp */
283 	for (i = 0; i < mgr->num_cards; i++) {
284 		chip = mgr->chip[i];
285 		if (chip->nb_streams_play)
286 			playback_mask |= 1 << chip->playback_pipe.first_audio;
287 		for (j = 0; j < chip->nb_streams_capt; j++)
288 			capture_mask |= 1 << chip->capture_pipe[j].first_audio;
289 	}
290 	return pcxhr_set_pipe_state(mgr, playback_mask, capture_mask, 1);
291 }
292 
293 
294 static int pcxhr_dsp_load(struct pcxhr_mgr *mgr, int index,
295 			  const struct firmware *dsp)
296 {
297 	int err, card_index;
298 
299 	snd_printdd("loading dsp [%d] size = %Zd\n", index, dsp->size);
300 
301 	switch (index) {
302 	case PCXHR_FIRMWARE_XLX_INT_INDEX:
303 		pcxhr_reset_xilinx_com(mgr);
304 		return pcxhr_load_xilinx_binary(mgr, dsp, 0);
305 
306 	case PCXHR_FIRMWARE_XLX_COM_INDEX:
307 		pcxhr_reset_xilinx_com(mgr);
308 		return pcxhr_load_xilinx_binary(mgr, dsp, 1);
309 
310 	case PCXHR_FIRMWARE_DSP_EPRM_INDEX:
311 		pcxhr_reset_dsp(mgr);
312 		return pcxhr_load_eeprom_binary(mgr, dsp);
313 
314 	case PCXHR_FIRMWARE_DSP_BOOT_INDEX:
315 		return pcxhr_load_boot_binary(mgr, dsp);
316 
317 	case PCXHR_FIRMWARE_DSP_MAIN_INDEX:
318 		err = pcxhr_load_dsp_binary(mgr, dsp);
319 		if (err)
320 			return err;
321 		break;	/* continue with first init */
322 	default:
323 		snd_printk(KERN_ERR "wrong file index\n");
324 		return -EFAULT;
325 	} /* end of switch file index*/
326 
327 	/* first communication with embedded */
328 	err = pcxhr_init_board(mgr);
329         if (err < 0) {
330 		snd_printk(KERN_ERR "pcxhr could not be set up\n");
331 		return err;
332 	}
333 	err = pcxhr_config_pipes(mgr);
334         if (err < 0) {
335 		snd_printk(KERN_ERR "pcxhr pipes could not be set up\n");
336 		return err;
337 	}
338        	/* create devices and mixer in accordance with HW options*/
339         for (card_index = 0; card_index < mgr->num_cards; card_index++) {
340 		struct snd_pcxhr *chip = mgr->chip[card_index];
341 
342 		if ((err = pcxhr_create_pcm(chip)) < 0)
343 			return err;
344 
345 		if (card_index == 0) {
346 			if ((err = pcxhr_create_mixer(chip->mgr)) < 0)
347 				return err;
348 		}
349 		if ((err = snd_card_register(chip->card)) < 0)
350 			return err;
351 	}
352 	err = pcxhr_start_pipes(mgr);
353         if (err < 0) {
354 		snd_printk(KERN_ERR "pcxhr pipes could not be started\n");
355 		return err;
356 	}
357 	snd_printdd("pcxhr firmware downloaded and successfully set up\n");
358 
359 	return 0;
360 }
361 
362 /*
363  * fw loader entry
364  */
365 #ifdef SND_PCXHR_FW_LOADER
366 
367 int pcxhr_setup_firmware(struct pcxhr_mgr *mgr)
368 {
369 	static char *fw_files[][5] = {
370 	[0] = { "xlxint.dat", "xlxc882hr.dat",
371 		"dspe882.e56", "dspb882hr.b56", "dspd882.d56" },
372 	[1] = { "xlxint.dat", "xlxc882e.dat",
373 		"dspe882.e56", "dspb882e.b56", "dspd882.d56" },
374 	[2] = { "xlxint.dat", "xlxc1222hr.dat",
375 		"dspe882.e56", "dspb1222hr.b56", "dspd1222.d56" },
376 	[3] = { "xlxint.dat", "xlxc1222e.dat",
377 		"dspe882.e56", "dspb1222e.b56", "dspd1222.d56" },
378 	[4] = { NULL, "xlxc222.dat",
379 		"dspe924.e56", "dspb924.b56", "dspd222.d56" },
380 	[5] = { NULL, "xlxc924.dat",
381 		"dspe924.e56", "dspb924.b56", "dspd222.d56" },
382 	};
383 	char path[32];
384 
385 	const struct firmware *fw_entry;
386 	int i, err;
387 	int fw_set = mgr->fw_file_set;
388 
389 	for (i = 0; i < 5; i++) {
390 		if (!fw_files[fw_set][i])
391 			continue;
392 		sprintf(path, "pcxhr/%s", fw_files[fw_set][i]);
393 		if (request_firmware(&fw_entry, path, &mgr->pci->dev)) {
394 			snd_printk(KERN_ERR "pcxhr: can't load firmware %s\n",
395 				   path);
396 			return -ENOENT;
397 		}
398 		/* fake hwdep dsp record */
399 		err = pcxhr_dsp_load(mgr, i, fw_entry);
400 		release_firmware(fw_entry);
401 		if (err < 0)
402 			return err;
403 		mgr->dsp_loaded |= 1 << i;
404 	}
405 	return 0;
406 }
407 
408 MODULE_FIRMWARE("pcxhr/xlxint.dat");
409 MODULE_FIRMWARE("pcxhr/xlxc882hr.dat");
410 MODULE_FIRMWARE("pcxhr/xlxc882e.dat");
411 MODULE_FIRMWARE("pcxhr/dspe882.e56");
412 MODULE_FIRMWARE("pcxhr/dspb882hr.b56");
413 MODULE_FIRMWARE("pcxhr/dspb882e.b56");
414 MODULE_FIRMWARE("pcxhr/dspd882.d56");
415 
416 MODULE_FIRMWARE("pcxhr/xlxc1222hr.dat");
417 MODULE_FIRMWARE("pcxhr/xlxc1222e.dat");
418 MODULE_FIRMWARE("pcxhr/dspb1222hr.b56");
419 MODULE_FIRMWARE("pcxhr/dspb1222e.b56");
420 MODULE_FIRMWARE("pcxhr/dspd1222.d56");
421 
422 MODULE_FIRMWARE("pcxhr/xlxc222.dat");
423 MODULE_FIRMWARE("pcxhr/xlxc924.dat");
424 MODULE_FIRMWARE("pcxhr/dspe924.e56");
425 MODULE_FIRMWARE("pcxhr/dspb924.b56");
426 MODULE_FIRMWARE("pcxhr/dspd222.d56");
427 
428 
429 #else /* old style firmware loading */
430 
431 /* pcxhr hwdep interface id string */
432 #define PCXHR_HWDEP_ID       "pcxhr loader"
433 
434 
435 static int pcxhr_hwdep_dsp_status(struct snd_hwdep *hw,
436 				  struct snd_hwdep_dsp_status *info)
437 {
438 	struct pcxhr_mgr *mgr = hw->private_data;
439 	sprintf(info->id, "pcxhr%d", mgr->fw_file_set);
440         info->num_dsps = PCXHR_FIRMWARE_FILES_MAX_INDEX;
441 
442 	if (hw->dsp_loaded & (1 << PCXHR_FIRMWARE_DSP_MAIN_INDEX))
443 		info->chip_ready = 1;
444 
445 	info->version = PCXHR_DRIVER_VERSION;
446 	return 0;
447 }
448 
449 static int pcxhr_hwdep_dsp_load(struct snd_hwdep *hw,
450 				struct snd_hwdep_dsp_image *dsp)
451 {
452 	struct pcxhr_mgr *mgr = hw->private_data;
453 	int err;
454 	struct firmware fw;
455 
456 	fw.size = dsp->length;
457 	fw.data = vmalloc(fw.size);
458 	if (! fw.data) {
459 		snd_printk(KERN_ERR "pcxhr: cannot allocate dsp image "
460 			   "(%lu bytes)\n", (unsigned long)fw.size);
461 		return -ENOMEM;
462 	}
463 	if (copy_from_user((void *)fw.data, dsp->image, dsp->length)) {
464 		vfree(fw.data);
465 		return -EFAULT;
466 	}
467 	err = pcxhr_dsp_load(mgr, dsp->index, &fw);
468 	vfree(fw.data);
469 	if (err < 0)
470 		return err;
471 	mgr->dsp_loaded |= 1 << dsp->index;
472 	return 0;
473 }
474 
475 int pcxhr_setup_firmware(struct pcxhr_mgr *mgr)
476 {
477 	int err;
478 	struct snd_hwdep *hw;
479 
480 	/* only create hwdep interface for first cardX
481 	 * (see "index" module parameter)
482 	 */
483 	err = snd_hwdep_new(mgr->chip[0]->card, PCXHR_HWDEP_ID, 0, &hw);
484 	if (err < 0)
485 		return err;
486 
487 	hw->iface = SNDRV_HWDEP_IFACE_PCXHR;
488 	hw->private_data = mgr;
489 	hw->ops.dsp_status = pcxhr_hwdep_dsp_status;
490 	hw->ops.dsp_load = pcxhr_hwdep_dsp_load;
491 	hw->exclusive = 1;
492 	/* stereo cards don't need fw_file_0 -> dsp_loaded = 1 */
493 	hw->dsp_loaded = mgr->is_hr_stereo ? 1 : 0;
494 	mgr->dsp_loaded = 0;
495 	sprintf(hw->name, PCXHR_HWDEP_ID);
496 
497 	err = snd_card_register(mgr->chip[0]->card);
498 	if (err < 0)
499 		return err;
500 	return 0;
501 }
502 
503 #endif /* SND_PCXHR_FW_LOADER */
504