2 * Driver for Digigram pcxhr compatible soundcards
6 * Copyright (c) 2004 by Digigram <alsa@digigram.com>
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.
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.
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
23 #include <sound/driver.h>
24 #include <linux/interrupt.h>
25 #include <linux/vmalloc.h>
26 #include <linux/firmware.h>
27 #include <linux/pci.h>
29 #include <sound/core.h>
30 #include <sound/hwdep.h>
32 #include "pcxhr_mixer.h"
33 #include "pcxhr_hwdep.h"
34 #include "pcxhr_core.h"
37 #if defined(CONFIG_FW_LOADER) || defined(CONFIG_FW_LOADER_MODULE)
38 #if !defined(CONFIG_USE_PCXHRLOADER) && !defined(CONFIG_SND_PCXHR) /* built-in kernel */
39 #define SND_PCXHR_FW_LOADER /* use the standard firmware loader */
45 * get basic information and init pcxhr card
48 static int pcxhr_init_board(struct pcxhr_mgr *mgr)
54 /* calc the number of all streams used */
55 if (mgr->mono_capture)
56 card_streams = mgr->capture_chips * 2;
58 card_streams = mgr->capture_chips;
59 card_streams += mgr->playback_chips * PCXHR_PLAYBACK_STREAMS;
61 /* enable interrupts */
62 pcxhr_enable_dsp(mgr);
64 pcxhr_init_rmh(&rmh, CMD_SUPPORTED);
65 err = pcxhr_send_msg(mgr, &rmh);
68 /* test 8 or 12 phys out */
69 snd_assert((rmh.stat[0] & MASK_FIRST_FIELD) == mgr->playback_chips*2,
71 /* test 8 or 2 phys in */
72 snd_assert(((rmh.stat[0] >> (2*FIELD_SIZE)) & MASK_FIRST_FIELD) ==
73 mgr->capture_chips * 2, return -EINVAL);
74 /* test max nb substream per board */
75 snd_assert((rmh.stat[1] & 0x5F) >= card_streams, return -EINVAL);
76 /* test max nb substream per pipe */
77 snd_assert(((rmh.stat[1]>>7)&0x5F) >= PCXHR_PLAYBACK_STREAMS, return -EINVAL);
79 pcxhr_init_rmh(&rmh, CMD_VERSION);
80 /* firmware num for DSP */
81 rmh.cmd[0] |= mgr->firmware_num;
82 /* transfer granularity in samples (should be multiple of 48) */
83 rmh.cmd[1] = (1<<23) + PCXHR_GRANULARITY;
85 err = pcxhr_send_msg(mgr, &rmh);
88 snd_printdd("PCXHR DSP version is %d.%d.%d\n",
89 (rmh.stat[0]>>16)&0xff, (rmh.stat[0]>>8)&0xff, rmh.stat[0]&0xff);
90 mgr->dsp_version = rmh.stat[0];
93 pcxhr_init_rmh(&rmh, CMD_ACCESS_IO_READ);
94 rmh.cmd[0] |= IO_NUM_REG_STATUS;
95 rmh.cmd[1] = REG_STATUS_OPTIONS;
97 err = pcxhr_send_msg(mgr, &rmh);
101 if ((rmh.stat[1] & REG_STATUS_OPT_DAUGHTER_MASK) == REG_STATUS_OPT_ANALOG_BOARD)
102 mgr->board_has_analog = 1; /* analog addon board available */
104 /* analog addon board not available -> no support for instance */
108 err = pcxhr_write_io_num_reg_cont(mgr, REG_CONT_UNMUTE_INPUTS,
109 REG_CONT_UNMUTE_INPUTS, NULL);
113 pcxhr_init_rmh(&rmh, CMD_ACCESS_IO_READ); /* a write to IO_NUM_REG_MUTE_OUT mutes! */
114 rmh.cmd[0] |= IO_NUM_REG_MUTE_OUT;
115 err = pcxhr_send_msg(mgr, &rmh);
119 void pcxhr_reset_board(struct pcxhr_mgr *mgr)
121 struct pcxhr_rmh rmh;
123 if (mgr->dsp_loaded & (1 << PCXHR_FIRMWARE_DSP_MAIN_INDEX)) {
125 /* a read to IO_NUM_REG_MUTE_OUT register unmutes! */
126 pcxhr_init_rmh(&rmh, CMD_ACCESS_IO_WRITE);
127 rmh.cmd[0] |= IO_NUM_REG_MUTE_OUT;
128 pcxhr_send_msg(mgr, &rmh);
130 pcxhr_write_io_num_reg_cont(mgr, REG_CONT_UNMUTE_INPUTS, 0, NULL);
132 /* reset pcxhr dsp */
133 if (mgr->dsp_loaded & ( 1 << PCXHR_FIRMWARE_DSP_EPRM_INDEX))
134 pcxhr_reset_dsp(mgr);
135 /* reset second xilinx */
136 if (mgr->dsp_loaded & ( 1 << PCXHR_FIRMWARE_XLX_COM_INDEX))
137 pcxhr_reset_xilinx_com(mgr);
143 * allocate a playback/capture pipe (pcmp0/pcmc0)
145 static int pcxhr_dsp_allocate_pipe( struct pcxhr_mgr *mgr, struct pcxhr_pipe *pipe,
146 int is_capture, int pin)
148 int stream_count, audio_count;
150 struct pcxhr_rmh rmh;
154 if (mgr->mono_capture)
159 stream_count = PCXHR_PLAYBACK_STREAMS;
160 audio_count = 2; /* always stereo */
162 snd_printdd("snd_add_ref_pipe pin(%d) pcm%c0\n", pin, is_capture ? 'c' : 'p');
163 pipe->is_capture = is_capture;
164 pipe->first_audio = pin;
165 /* define pipe (P_PCM_ONLY_MASK (0x020000) is not necessary) */
166 pcxhr_init_rmh(&rmh, CMD_RES_PIPE);
167 pcxhr_set_pipe_cmd_params(&rmh, is_capture, pin, audio_count, stream_count);
168 err = pcxhr_send_msg(mgr, &rmh);
170 snd_printk(KERN_ERR "error pipe allocation (CMD_RES_PIPE) err=%x!\n", err );
173 pipe->status = PCXHR_PIPE_DEFINED;
179 * free playback/capture pipe (pcmp0/pcmc0)
182 static int pcxhr_dsp_free_pipe( struct pcxhr_mgr *mgr, struct pcxhr_pipe *pipe)
184 struct pcxhr_rmh rmh;
185 int capture_mask = 0;
186 int playback_mask = 0;
189 if (pipe->is_capture)
190 capture_mask = (1 << pipe->first_audio);
192 playback_mask = (1 << pipe->first_audio);
195 err = pcxhr_set_pipe_state(mgr, playback_mask, capture_mask, 0);
197 snd_printk(KERN_ERR "error stopping pipe!\n");
198 /* release the pipe */
199 pcxhr_init_rmh(&rmh, CMD_FREE_PIPE);
200 pcxhr_set_pipe_cmd_params(&rmh, pipe->is_capture, pipe->first_audio, 0, 0);
201 err = pcxhr_send_msg(mgr, &rmh);
203 snd_printk(KERN_ERR "error pipe release (CMD_FREE_PIPE) err(%x)\n", err);
204 pipe->status = PCXHR_PIPE_UNDEFINED;
210 static int pcxhr_config_pipes(struct pcxhr_mgr *mgr)
213 struct snd_pcxhr *chip;
214 struct pcxhr_pipe *pipe;
216 /* allocate the pipes on the dsp */
217 for (i = 0; i < mgr->num_cards; i++) {
219 if (chip->nb_streams_play) {
220 pipe = &chip->playback_pipe;
221 err = pcxhr_dsp_allocate_pipe( mgr, pipe, 0, i*2);
224 for(j = 0; j < chip->nb_streams_play; j++)
225 chip->playback_stream[j].pipe = pipe;
227 for (j = 0; j < chip->nb_streams_capt; j++) {
228 pipe = &chip->capture_pipe[j];
229 err = pcxhr_dsp_allocate_pipe(mgr, pipe, 1, i*2 + j);
232 chip->capture_stream[j].pipe = pipe;
238 static int pcxhr_start_pipes(struct pcxhr_mgr *mgr)
241 struct snd_pcxhr *chip;
242 int playback_mask = 0;
243 int capture_mask = 0;
245 /* start all the pipes on the dsp */
246 for (i = 0; i < mgr->num_cards; i++) {
248 if (chip->nb_streams_play)
249 playback_mask |= (1 << chip->playback_pipe.first_audio);
250 for (j = 0; j < chip->nb_streams_capt; j++)
251 capture_mask |= (1 << chip->capture_pipe[j].first_audio);
253 return pcxhr_set_pipe_state(mgr, playback_mask, capture_mask, 1);
257 static int pcxhr_dsp_load(struct pcxhr_mgr *mgr, int index, const struct firmware *dsp)
261 snd_printdd("loading dsp [%d] size = %Zd\n", index, dsp->size);
264 case PCXHR_FIRMWARE_XLX_INT_INDEX:
265 pcxhr_reset_xilinx_com(mgr);
266 return pcxhr_load_xilinx_binary(mgr, dsp, 0);
268 case PCXHR_FIRMWARE_XLX_COM_INDEX:
269 pcxhr_reset_xilinx_com(mgr);
270 return pcxhr_load_xilinx_binary(mgr, dsp, 1);
272 case PCXHR_FIRMWARE_DSP_EPRM_INDEX:
273 pcxhr_reset_dsp(mgr);
274 return pcxhr_load_eeprom_binary(mgr, dsp);
276 case PCXHR_FIRMWARE_DSP_BOOT_INDEX:
277 return pcxhr_load_boot_binary(mgr, dsp);
279 case PCXHR_FIRMWARE_DSP_MAIN_INDEX:
280 err = pcxhr_load_dsp_binary(mgr, dsp);
283 break; /* continue with first init */
285 snd_printk(KERN_ERR "wrong file index\n");
287 } /* end of switch file index*/
289 /* first communication with embedded */
290 err = pcxhr_init_board(mgr);
292 snd_printk(KERN_ERR "pcxhr could not be set up\n");
295 err = pcxhr_config_pipes(mgr);
297 snd_printk(KERN_ERR "pcxhr pipes could not be set up\n");
300 /* create devices and mixer in accordance with HW options*/
301 for (card_index = 0; card_index < mgr->num_cards; card_index++) {
302 struct snd_pcxhr *chip = mgr->chip[card_index];
304 if ((err = pcxhr_create_pcm(chip)) < 0)
307 if (card_index == 0) {
308 if ((err = pcxhr_create_mixer(chip->mgr)) < 0)
311 if ((err = snd_card_register(chip->card)) < 0)
314 err = pcxhr_start_pipes(mgr);
316 snd_printk(KERN_ERR "pcxhr pipes could not be started\n");
319 snd_printdd("pcxhr firmware downloaded and successfully set up\n");
327 #ifdef SND_PCXHR_FW_LOADER
329 int pcxhr_setup_firmware(struct pcxhr_mgr *mgr)
331 static char *fw_files[5] = {
340 const struct firmware *fw_entry;
343 for (i = 0; i < ARRAY_SIZE(fw_files); i++) {
344 sprintf(path, "pcxhr/%s", fw_files[i]);
345 if (request_firmware(&fw_entry, path, &mgr->pci->dev)) {
346 snd_printk(KERN_ERR "pcxhr: can't load firmware %s\n", path);
349 /* fake hwdep dsp record */
350 err = pcxhr_dsp_load(mgr, i, fw_entry);
351 release_firmware(fw_entry);
354 mgr->dsp_loaded |= 1 << i;
359 MODULE_FIRMWARE("pcxhr/xi_1_882.dat");
360 MODULE_FIRMWARE("pcxhr/xc_1_882.dat");
361 MODULE_FIRMWARE("pcxhr/e321_512.e56");
362 MODULE_FIRMWARE("pcxhr/b321_512.b56");
363 MODULE_FIRMWARE("pcxhr/d321_512.d56");
365 #else /* old style firmware loading */
367 /* pcxhr hwdep interface id string */
368 #define PCXHR_HWDEP_ID "pcxhr loader"
371 static int pcxhr_hwdep_dsp_status(struct snd_hwdep *hw,
372 struct snd_hwdep_dsp_status *info)
374 strcpy(info->id, "pcxhr");
375 info->num_dsps = PCXHR_FIRMWARE_FILES_MAX_INDEX;
377 if (hw->dsp_loaded & (1 << PCXHR_FIRMWARE_DSP_MAIN_INDEX))
378 info->chip_ready = 1;
380 info->version = PCXHR_DRIVER_VERSION;
384 static int pcxhr_hwdep_dsp_load(struct snd_hwdep *hw,
385 struct snd_hwdep_dsp_image *dsp)
387 struct pcxhr_mgr *mgr = hw->private_data;
391 fw.size = dsp->length;
392 fw.data = vmalloc(fw.size);
394 snd_printk(KERN_ERR "pcxhr: cannot allocate dsp image (%lu bytes)\n",
395 (unsigned long)fw.size);
398 if (copy_from_user(fw.data, dsp->image, dsp->length)) {
402 err = pcxhr_dsp_load(mgr, dsp->index, &fw);
406 mgr->dsp_loaded |= 1 << dsp->index;
410 static int pcxhr_hwdep_open(struct snd_hwdep *hw, struct file *file)
415 static int pcxhr_hwdep_release(struct snd_hwdep *hw, struct file *file)
420 int pcxhr_setup_firmware(struct pcxhr_mgr *mgr)
423 struct snd_hwdep *hw;
425 /* only create hwdep interface for first cardX (see "index" module parameter)*/
426 if ((err = snd_hwdep_new(mgr->chip[0]->card, PCXHR_HWDEP_ID, 0, &hw)) < 0)
429 hw->iface = SNDRV_HWDEP_IFACE_PCXHR;
430 hw->private_data = mgr;
431 hw->ops.open = pcxhr_hwdep_open;
432 hw->ops.release = pcxhr_hwdep_release;
433 hw->ops.dsp_status = pcxhr_hwdep_dsp_status;
434 hw->ops.dsp_load = pcxhr_hwdep_dsp_load;
437 sprintf(hw->name, PCXHR_HWDEP_ID);
439 if ((err = snd_card_register(mgr->chip[0]->card)) < 0)
444 #endif /* SND_PCXHR_FW_LOADER */