1 /* Copyright (C) by Paul Barton-Davis 1998-1999
3 * Some portions of this file are taken from work that is
4 * copyright (C) by Hannu Savolainen 1993-1996
6 * This program is distributed under the GNU GENERAL PUBLIC LICENSE (GPL)
7 * Version 2 (June 1991). See the "COPYING" file distributed with this software
12 * An ALSA lowlevel driver for Turtle Beach ICS2115 wavetable synth
13 * (Maui, Tropez, Tropez Plus)
15 * This driver supports the onboard wavetable synthesizer (an ICS2115),
16 * including patch, sample and program loading and unloading, conversion
17 * of GUS patches during loading, and full user-level access to all
18 * WaveFront commands. It tries to provide semi-intelligent patch and
19 * sample management as well.
23 #include <sound/driver.h>
25 #include <linux/interrupt.h>
26 #include <linux/init.h>
27 #include <linux/delay.h>
28 #include <linux/time.h>
29 #include <linux/wait.h>
30 #include <linux/moduleparam.h>
31 #include <sound/core.h>
32 #include <sound/snd_wavefront.h>
33 #include <sound/initval.h>
35 static int wf_raw = 0; /* we normally check for "raw state" to firmware
36 loading. if non-zero, then during driver loading, the
37 state of the board is ignored, and we reset the
38 board and load the firmware anyway.
41 static int fx_raw = 1; /* if this is zero, we'll leave the FX processor in
42 whatever state it is when the driver is loaded.
43 The default is to download the microprogram and
44 associated coefficients to set it up for "default"
45 operation, whatever that means.
48 static int debug_default = 0; /* you can set this to control debugging
49 during driver loading. it takes any combination
50 of the WF_DEBUG_* flags defined in
54 /* XXX this needs to be made firmware and hardware version dependent */
56 static char *ospath = "/etc/sound/wavefront.os"; /* where to find a processed
57 version of the WaveFront OS
60 static int wait_usecs = 150; /* This magic number seems to give pretty optimal
61 throughput based on my limited experimentation.
62 If you want to play around with it and find a better
63 value, be my guest. Remember, the idea is to
64 get a number that causes us to just busy wait
65 for as many WaveFront commands as possible, without
66 coming up with a number so large that we hog the
69 Specifically, with this number, out of about 134,000
70 status waits, only about 250 result in a sleep.
73 static int sleep_interval = 100; /* HZ/sleep_interval seconds per sleep */
74 static int sleep_tries = 50; /* number of times we'll try to sleep */
76 static int reset_time = 2; /* hundreths of a second we wait after a HW
77 reset for the expected interrupt.
80 static int ramcheck_time = 20; /* time in seconds to wait while ROM code
84 static int osrun_time = 10; /* time in seconds we wait for the OS to
87 module_param(wf_raw, int, 0444);
88 MODULE_PARM_DESC(wf_raw, "if non-zero, assume that we need to boot the OS");
89 module_param(fx_raw, int, 0444);
90 MODULE_PARM_DESC(fx_raw, "if non-zero, assume that the FX process needs help");
91 module_param(debug_default, int, 0444);
92 MODULE_PARM_DESC(debug_default, "debug parameters for card initialization");
93 module_param(wait_usecs, int, 0444);
94 MODULE_PARM_DESC(wait_usecs, "how long to wait without sleeping, usecs");
95 module_param(sleep_interval, int, 0444);
96 MODULE_PARM_DESC(sleep_interval, "how long to sleep when waiting for reply");
97 module_param(sleep_tries, int, 0444);
98 MODULE_PARM_DESC(sleep_tries, "how many times to try sleeping during a wait");
99 module_param(ospath, charp, 0444);
100 MODULE_PARM_DESC(ospath, "full pathname to processed ICS2115 OS firmware");
101 module_param(reset_time, int, 0444);
102 MODULE_PARM_DESC(reset_time, "how long to wait for a reset to take effect");
103 module_param(ramcheck_time, int, 0444);
104 MODULE_PARM_DESC(ramcheck_time, "how many seconds to wait for the RAM test");
105 module_param(osrun_time, int, 0444);
106 MODULE_PARM_DESC(osrun_time, "how many seconds to wait for the ICS2115 OS");
108 /* if WF_DEBUG not defined, no run-time debugging messages will
109 be available via the debug flag setting. Given the current
110 beta state of the driver, this will remain set until a future
118 #define DPRINT(cond, ...) \
119 if ((dev->debug & (cond)) == (cond)) { \
120 snd_printk (__VA_ARGS__); \
123 #define DPRINT(cond, args...)
124 #endif /* WF_DEBUG */
126 #define LOGNAME "WaveFront: "
128 /* bitmasks for WaveFront status port value */
130 #define STAT_RINTR_ENABLED 0x01
131 #define STAT_CAN_READ 0x02
132 #define STAT_INTR_READ 0x04
133 #define STAT_WINTR_ENABLED 0x10
134 #define STAT_CAN_WRITE 0x20
135 #define STAT_INTR_WRITE 0x40
137 static int wavefront_delete_sample (snd_wavefront_t *, int sampnum);
138 static int wavefront_find_free_sample (snd_wavefront_t *);
140 struct wavefront_command {
143 unsigned int read_cnt;
144 unsigned int write_cnt;
151 } wavefront_errors[] = {
152 { 0x01, "Bad sample number" },
153 { 0x02, "Out of sample memory" },
154 { 0x03, "Bad patch number" },
155 { 0x04, "Error in number of voices" },
156 { 0x06, "Sample load already in progress" },
157 { 0x0B, "No sample load request pending" },
158 { 0x0E, "Bad MIDI channel number" },
159 { 0x10, "Download Record Error" },
166 static struct wavefront_command wavefront_commands[] = {
167 { WFC_SET_SYNTHVOL, "set synthesizer volume", 0, 1, NEEDS_ACK },
168 { WFC_GET_SYNTHVOL, "get synthesizer volume", 1, 0, 0},
169 { WFC_SET_NVOICES, "set number of voices", 0, 1, NEEDS_ACK },
170 { WFC_GET_NVOICES, "get number of voices", 1, 0, 0 },
171 { WFC_SET_TUNING, "set synthesizer tuning", 0, 2, NEEDS_ACK },
172 { WFC_GET_TUNING, "get synthesizer tuning", 2, 0, 0 },
173 { WFC_DISABLE_CHANNEL, "disable synth channel", 0, 1, NEEDS_ACK },
174 { WFC_ENABLE_CHANNEL, "enable synth channel", 0, 1, NEEDS_ACK },
175 { WFC_GET_CHANNEL_STATUS, "get synth channel status", 3, 0, 0 },
176 { WFC_MISYNTH_OFF, "disable midi-in to synth", 0, 0, NEEDS_ACK },
177 { WFC_MISYNTH_ON, "enable midi-in to synth", 0, 0, NEEDS_ACK },
178 { WFC_VMIDI_ON, "enable virtual midi mode", 0, 0, NEEDS_ACK },
179 { WFC_VMIDI_OFF, "disable virtual midi mode", 0, 0, NEEDS_ACK },
180 { WFC_MIDI_STATUS, "report midi status", 1, 0, 0 },
181 { WFC_FIRMWARE_VERSION, "report firmware version", 2, 0, 0 },
182 { WFC_HARDWARE_VERSION, "report hardware version", 2, 0, 0 },
183 { WFC_GET_NSAMPLES, "report number of samples", 2, 0, 0 },
184 { WFC_INSTOUT_LEVELS, "report instantaneous output levels", 7, 0, 0 },
185 { WFC_PEAKOUT_LEVELS, "report peak output levels", 7, 0, 0 },
186 { WFC_DOWNLOAD_SAMPLE, "download sample",
187 0, WF_SAMPLE_BYTES, NEEDS_ACK },
188 { WFC_DOWNLOAD_BLOCK, "download block", 0, 0, NEEDS_ACK},
189 { WFC_DOWNLOAD_SAMPLE_HEADER, "download sample header",
190 0, WF_SAMPLE_HDR_BYTES, NEEDS_ACK },
191 { WFC_UPLOAD_SAMPLE_HEADER, "upload sample header", 13, 2, 0 },
193 /* This command requires a variable number of bytes to be written.
194 There is a hack in snd_wavefront_cmd() to support this. The actual
195 count is passed in as the read buffer ptr, cast appropriately.
199 { WFC_DOWNLOAD_MULTISAMPLE, "download multisample", 0, 0, NEEDS_ACK },
201 /* This one is a hack as well. We just read the first byte of the
202 response, don't fetch an ACK, and leave the rest to the
203 calling function. Ugly, ugly, ugly.
206 { WFC_UPLOAD_MULTISAMPLE, "upload multisample", 2, 1, 0 },
207 { WFC_DOWNLOAD_SAMPLE_ALIAS, "download sample alias",
208 0, WF_ALIAS_BYTES, NEEDS_ACK },
209 { WFC_UPLOAD_SAMPLE_ALIAS, "upload sample alias", WF_ALIAS_BYTES, 2, 0},
210 { WFC_DELETE_SAMPLE, "delete sample", 0, 2, NEEDS_ACK },
211 { WFC_IDENTIFY_SAMPLE_TYPE, "identify sample type", 5, 2, 0 },
212 { WFC_UPLOAD_SAMPLE_PARAMS, "upload sample parameters" },
213 { WFC_REPORT_FREE_MEMORY, "report free memory", 4, 0, 0 },
214 { WFC_DOWNLOAD_PATCH, "download patch", 0, 134, NEEDS_ACK },
215 { WFC_UPLOAD_PATCH, "upload patch", 132, 2, 0 },
216 { WFC_DOWNLOAD_PROGRAM, "download program", 0, 33, NEEDS_ACK },
217 { WFC_UPLOAD_PROGRAM, "upload program", 32, 1, 0 },
218 { WFC_DOWNLOAD_EDRUM_PROGRAM, "download enhanced drum program", 0, 9,
220 { WFC_UPLOAD_EDRUM_PROGRAM, "upload enhanced drum program", 8, 1, 0},
221 { WFC_SET_EDRUM_CHANNEL, "set enhanced drum program channel",
223 { WFC_DISABLE_DRUM_PROGRAM, "disable drum program", 0, 1, NEEDS_ACK },
224 { WFC_REPORT_CHANNEL_PROGRAMS, "report channel program numbers",
226 { WFC_NOOP, "the no-op command", 0, 0, NEEDS_ACK },
231 wavefront_errorstr (int errnum)
236 for (i = 0; wavefront_errors[i].errstr; i++) {
237 if (wavefront_errors[i].errno == errnum) {
238 return wavefront_errors[i].errstr;
242 return "Unknown WaveFront error";
245 static struct wavefront_command *
246 wavefront_get_command (int cmd)
251 for (i = 0; wavefront_commands[i].cmd != 0; i++) {
252 if (cmd == wavefront_commands[i].cmd) {
253 return &wavefront_commands[i];
261 wavefront_status (snd_wavefront_t *dev)
264 return inb (dev->status_port);
268 wavefront_sleep (int limit)
271 schedule_timeout_interruptible(limit);
273 return signal_pending(current);
277 wavefront_wait (snd_wavefront_t *dev, int mask)
282 /* Spin for a short period of time, because >99% of all
283 requests to the WaveFront can be serviced inline like this.
286 for (i = 0; i < wait_usecs; i += 5) {
287 if (wavefront_status (dev) & mask) {
293 for (i = 0; i < sleep_tries; i++) {
295 if (wavefront_status (dev) & mask) {
299 if (wavefront_sleep (HZ/sleep_interval)) {
308 wavefront_read (snd_wavefront_t *dev)
311 if (wavefront_wait (dev, STAT_CAN_READ))
312 return inb (dev->data_port);
314 DPRINT (WF_DEBUG_DATA, "read timeout.\n");
320 wavefront_write (snd_wavefront_t *dev, unsigned char data)
323 if (wavefront_wait (dev, STAT_CAN_WRITE)) {
324 outb (data, dev->data_port);
328 DPRINT (WF_DEBUG_DATA, "write timeout.\n");
334 snd_wavefront_cmd (snd_wavefront_t *dev,
335 int cmd, unsigned char *rbuf, unsigned char *wbuf)
341 struct wavefront_command *wfcmd;
343 if ((wfcmd = wavefront_get_command (cmd)) == NULL) {
344 snd_printk ("command 0x%x not supported.\n",
349 /* Hack to handle the one variable-size write command. See
350 wavefront_send_multisample() for the other half of this
351 gross and ugly strategy.
354 if (cmd == WFC_DOWNLOAD_MULTISAMPLE) {
355 wfcmd->write_cnt = (unsigned long) rbuf;
359 DPRINT (WF_DEBUG_CMD, "0x%x [%s] (%d,%d,%d)\n",
360 cmd, wfcmd->action, wfcmd->read_cnt,
361 wfcmd->write_cnt, wfcmd->need_ack);
363 if (wavefront_write (dev, cmd)) {
364 DPRINT ((WF_DEBUG_IO|WF_DEBUG_CMD), "cannot request "
370 if (wfcmd->write_cnt > 0) {
371 DPRINT (WF_DEBUG_DATA, "writing %d bytes "
373 wfcmd->write_cnt, cmd);
375 for (i = 0; i < wfcmd->write_cnt; i++) {
376 if (wavefront_write (dev, wbuf[i])) {
377 DPRINT (WF_DEBUG_IO, "bad write for byte "
378 "%d of 0x%x [%s].\n",
379 i, cmd, wfcmd->action);
383 DPRINT (WF_DEBUG_DATA, "write[%d] = 0x%x\n",
388 if (wfcmd->read_cnt > 0) {
389 DPRINT (WF_DEBUG_DATA, "reading %d ints "
391 wfcmd->read_cnt, cmd);
393 for (i = 0; i < wfcmd->read_cnt; i++) {
395 if ((c = wavefront_read (dev)) == -1) {
396 DPRINT (WF_DEBUG_IO, "bad read for byte "
397 "%d of 0x%x [%s].\n",
398 i, cmd, wfcmd->action);
402 /* Now handle errors. Lots of special cases here */
405 if ((c = wavefront_read (dev)) == -1) {
406 DPRINT (WF_DEBUG_IO, "bad read for "
415 /* Can you believe this madness ? */
418 wfcmd->cmd == WFC_IDENTIFY_SAMPLE_TYPE) {
419 rbuf[0] = WF_ST_EMPTY;
423 wfcmd->cmd == WFC_UPLOAD_PATCH) {
428 wfcmd->cmd == WFC_UPLOAD_PROGRAM) {
434 DPRINT (WF_DEBUG_IO, "error %d (%s) "
440 wavefront_errorstr (c),
451 DPRINT (WF_DEBUG_DATA, "read[%d] = 0x%x\n",i, rbuf[i]);
455 if ((wfcmd->read_cnt == 0 && wfcmd->write_cnt == 0) || wfcmd->need_ack) {
457 DPRINT (WF_DEBUG_CMD, "reading ACK for 0x%x\n", cmd);
459 /* Some commands need an ACK, but return zero instead
460 of the standard value.
463 if ((ack = wavefront_read (dev)) == 0) {
469 DPRINT (WF_DEBUG_IO, "cannot read ack for "
475 int err = -1; /* something unknown */
477 if (ack == 0xff) { /* explicit error */
479 if ((err = wavefront_read (dev)) == -1) {
480 DPRINT (WF_DEBUG_DATA,
487 DPRINT (WF_DEBUG_IO, "0x%x [%s] "
488 "failed (0x%x, 0x%x, %s)\n",
489 cmd, wfcmd->action, ack, err,
490 wavefront_errorstr (err));
496 DPRINT (WF_DEBUG_DATA, "ack received "
501 DPRINT (WF_DEBUG_CMD, "0x%x [%s] does not need "
503 cmd, wfcmd->action, wfcmd->read_cnt,
504 wfcmd->write_cnt, wfcmd->need_ack);
511 /***********************************************************************
512 WaveFront data munging
514 Things here are weird. All data written to the board cannot
515 have its most significant bit set. Any data item with values
516 potentially > 0x7F (127) must be split across multiple bytes.
518 Sometimes, we need to munge numeric values that are represented on
519 the x86 side as 8-32 bit values. Sometimes, we need to munge data
520 that is represented on the x86 side as an array of bytes. The most
521 efficient approach to handling both cases seems to be to use 2
522 different functions for munging and 2 for de-munging. This avoids
523 weird casting and worrying about bit-level offsets.
525 **********************************************************************/
527 static unsigned char *
528 munge_int32 (unsigned int src,
530 unsigned int dst_size)
534 for (i = 0; i < dst_size; i++) {
535 *dst = src & 0x7F; /* Mask high bit of LSB */
536 src = src >> 7; /* Rotate Right 7 bits */
537 /* Note: we leave the upper bits in place */
545 demunge_int32 (unsigned char* src, int src_size)
551 for (i = src_size - 1; i >= 0; i--) {
552 outval=(outval<<7)+src[i];
560 munge_buf (unsigned char *src, unsigned char *dst, unsigned int dst_size)
564 unsigned int last = dst_size / 2;
566 for (i = 0; i < last; i++) {
567 *dst++ = src[i] & 0x7f;
568 *dst++ = src[i] >> 7;
575 demunge_buf (unsigned char *src, unsigned char *dst, unsigned int src_bytes)
579 unsigned char *end = src + src_bytes;
581 end = src + src_bytes;
583 /* NOTE: src and dst *CAN* point to the same address */
585 for (i = 0; src != end; i++) {
587 dst[i] |= (*src++)<<7;
593 /***********************************************************************
594 WaveFront: sample, patch and program management.
595 ***********************************************************************/
598 wavefront_delete_sample (snd_wavefront_t *dev, int sample_num)
601 unsigned char wbuf[2];
604 wbuf[0] = sample_num & 0x7f;
605 wbuf[1] = sample_num >> 7;
607 if ((x = snd_wavefront_cmd (dev, WFC_DELETE_SAMPLE, NULL, wbuf)) == 0) {
608 dev->sample_status[sample_num] = WF_ST_EMPTY;
615 wavefront_get_sample_status (snd_wavefront_t *dev, int assume_rom)
619 unsigned char rbuf[32], wbuf[32];
620 unsigned int sc_real, sc_alias, sc_multi;
622 /* check sample status */
624 if (snd_wavefront_cmd (dev, WFC_GET_NSAMPLES, rbuf, wbuf)) {
625 snd_printk ("cannot request sample count.\n");
629 sc_real = sc_alias = sc_multi = dev->samples_used = 0;
631 for (i = 0; i < WF_MAX_SAMPLE; i++) {
636 if (snd_wavefront_cmd (dev, WFC_IDENTIFY_SAMPLE_TYPE, rbuf, wbuf)) {
637 snd_printk("cannot identify sample "
638 "type of slot %d\n", i);
639 dev->sample_status[i] = WF_ST_EMPTY;
643 dev->sample_status[i] = (WF_SLOT_FILLED|rbuf[0]);
646 dev->sample_status[i] |= WF_SLOT_ROM;
649 switch (rbuf[0] & WF_ST_MASK) {
653 case WF_ST_MULTISAMPLE:
663 snd_printk ("unknown sample type for "
668 if (rbuf[0] != WF_ST_EMPTY) {
673 snd_printk ("%d samples used (%d real, %d aliases, %d multi), "
674 "%d empty\n", dev->samples_used, sc_real, sc_alias, sc_multi,
675 WF_MAX_SAMPLE - dev->samples_used);
683 wavefront_get_patch_status (snd_wavefront_t *dev)
686 unsigned char patchbuf[WF_PATCH_BYTES];
687 unsigned char patchnum[2];
691 for (i = 0; i < WF_MAX_PATCH; i++) {
692 patchnum[0] = i & 0x7f;
693 patchnum[1] = i >> 7;
695 if ((x = snd_wavefront_cmd (dev, WFC_UPLOAD_PATCH, patchbuf,
698 dev->patch_status[i] |= WF_SLOT_FILLED;
699 p = (wavefront_patch *) patchbuf;
701 [p->sample_number|(p->sample_msb<<7)] |=
704 } else if (x == 3) { /* Bad patch number */
705 dev->patch_status[i] = 0;
707 snd_printk ("upload patch "
709 dev->patch_status[i] = 0;
714 /* program status has already filled in slot_used bits */
716 for (i = 0, cnt = 0, cnt2 = 0; i < WF_MAX_PATCH; i++) {
717 if (dev->patch_status[i] & WF_SLOT_FILLED) {
720 if (dev->patch_status[i] & WF_SLOT_USED) {
725 snd_printk ("%d patch slots filled, %d in use\n", cnt, cnt2);
731 wavefront_get_program_status (snd_wavefront_t *dev)
734 unsigned char progbuf[WF_PROGRAM_BYTES];
735 wavefront_program prog;
736 unsigned char prognum;
739 for (i = 0; i < WF_MAX_PROGRAM; i++) {
742 if ((x = snd_wavefront_cmd (dev, WFC_UPLOAD_PROGRAM, progbuf,
745 dev->prog_status[i] |= WF_SLOT_USED;
747 demunge_buf (progbuf, (unsigned char *) &prog,
750 for (l = 0; l < WF_NUM_LAYERS; l++) {
751 if (prog.layer[l].mute) {
753 [prog.layer[l].patch_number] |=
757 } else if (x == 1) { /* Bad program number */
758 dev->prog_status[i] = 0;
760 snd_printk ("upload program "
762 dev->prog_status[i] = 0;
766 for (i = 0, cnt = 0; i < WF_MAX_PROGRAM; i++) {
767 if (dev->prog_status[i]) {
772 snd_printk ("%d programs slots in use\n", cnt);
778 wavefront_send_patch (snd_wavefront_t *dev, wavefront_patch_info *header)
781 unsigned char buf[WF_PATCH_BYTES+2];
784 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading patch %d\n",
787 dev->patch_status[header->number] |= WF_SLOT_FILLED;
790 bptr = munge_int32 (header->number, buf, 2);
791 munge_buf ((unsigned char *)&header->hdr.p, bptr, WF_PATCH_BYTES);
793 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_PATCH, NULL, buf)) {
794 snd_printk ("download patch failed\n");
802 wavefront_send_program (snd_wavefront_t *dev, wavefront_patch_info *header)
805 unsigned char buf[WF_PROGRAM_BYTES+1];
808 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading program %d\n",
811 dev->prog_status[header->number] = WF_SLOT_USED;
813 /* XXX need to zero existing SLOT_USED bit for program_status[i]
814 where `i' is the program that's being (potentially) overwritten.
817 for (i = 0; i < WF_NUM_LAYERS; i++) {
818 if (header->hdr.pr.layer[i].mute) {
819 dev->patch_status[header->hdr.pr.layer[i].patch_number] |=
822 /* XXX need to mark SLOT_USED for sample used by
823 patch_number, but this means we have to load it. Ick.
828 buf[0] = header->number;
829 munge_buf ((unsigned char *)&header->hdr.pr, &buf[1], WF_PROGRAM_BYTES);
831 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_PROGRAM, NULL, buf)) {
832 snd_printk ("download patch failed\n");
840 wavefront_freemem (snd_wavefront_t *dev)
845 if (snd_wavefront_cmd (dev, WFC_REPORT_FREE_MEMORY, rbuf, NULL)) {
846 snd_printk ("can't get memory stats.\n");
849 return demunge_int32 (rbuf, 4);
854 wavefront_send_sample (snd_wavefront_t *dev,
855 wavefront_patch_info *header,
857 int data_is_unsigned)
860 /* samples are downloaded via a 16-bit wide i/o port
861 (you could think of it as 2 adjacent 8-bit wide ports
862 but its less efficient that way). therefore, all
863 the blocksizes and so forth listed in the documentation,
864 and used conventionally to refer to sample sizes,
865 which are given in 8-bit units (bytes), need to be
869 u16 sample_short = 0;
871 u16 __user *data_end = NULL;
873 const unsigned int max_blksize = 4096/2;
874 unsigned int written;
875 unsigned int blocksize;
878 unsigned char sample_hdr[WF_SAMPLE_HDR_BYTES];
879 unsigned char *shptr;
881 int initial_skip = 0;
883 DPRINT (WF_DEBUG_LOAD_PATCH, "sample %sdownload for slot %d, "
884 "type %d, %d bytes from 0x%lx\n",
885 header->size ? "" : "header ",
886 header->number, header->subkey,
888 (unsigned long) header->dataptr);
890 if (header->number == WAVEFRONT_FIND_FREE_SAMPLE_SLOT) {
893 if ((x = wavefront_find_free_sample (dev)) < 0) {
896 snd_printk ("unspecified sample => %d\n", x);
902 /* XXX it's a debatable point whether or not RDONLY semantics
903 on the ROM samples should cover just the sample data or
904 the sample header. For now, it only covers the sample data,
905 so anyone is free at all times to rewrite sample headers.
907 My reason for this is that we have the sample headers
908 available in the WFB file for General MIDI, and so these
909 can always be reset if needed. The sample data, however,
910 cannot be recovered without a complete reset and firmware
911 reload of the ICS2115, which is a very expensive operation.
913 So, doing things this way allows us to honor the notion of
914 "RESETSAMPLES" reasonably cheaply. Note however, that this
915 is done purely at user level: there is no WFB parser in
916 this driver, and so a complete reset (back to General MIDI,
917 or theoretically some other configuration) is the
918 responsibility of the user level library.
920 To try to do this in the kernel would be a little
921 crazy: we'd need 158K of kernel space just to hold
922 a copy of the patch/program/sample header data.
925 if (dev->rom_samples_rdonly) {
926 if (dev->sample_status[header->number] & WF_SLOT_ROM) {
927 snd_printk ("sample slot %d "
934 wavefront_delete_sample (dev, header->number);
938 dev->freemem = wavefront_freemem (dev);
940 if (dev->freemem < (int)header->size) {
941 snd_printk ("insufficient memory to "
942 "load %d byte sample.\n",
949 skip = WF_GET_CHANNEL(&header->hdr.s);
951 if (skip > 0 && header->hdr.s.SampleResolution != LINEAR_16BIT) {
952 snd_printk ("channel selection only "
953 "possible on 16-bit samples");
988 DPRINT (WF_DEBUG_LOAD_PATCH, "channel selection: %d => "
989 "initial skip = %d, skip = %d\n",
990 WF_GET_CHANNEL (&header->hdr.s),
993 /* Be safe, and zero the "Unused" bits ... */
995 WF_SET_CHANNEL(&header->hdr.s, 0);
997 /* adjust size for 16 bit samples by dividing by two. We always
998 send 16 bits per write, even for 8 bit samples, so the length
999 is always half the size of the sample data in bytes.
1002 length = header->size / 2;
1004 /* the data we're sent has not been munged, and in fact, the
1005 header we have to send isn't just a munged copy either.
1006 so, build the sample header right here.
1009 shptr = &sample_hdr[0];
1011 shptr = munge_int32 (header->number, shptr, 2);
1014 shptr = munge_int32 (length, shptr, 4);
1017 /* Yes, a 4 byte result doesn't contain all of the offset bits,
1018 but the offset only uses 24 bits.
1021 shptr = munge_int32 (*((u32 *) &header->hdr.s.sampleStartOffset),
1023 shptr = munge_int32 (*((u32 *) &header->hdr.s.loopStartOffset),
1025 shptr = munge_int32 (*((u32 *) &header->hdr.s.loopEndOffset),
1027 shptr = munge_int32 (*((u32 *) &header->hdr.s.sampleEndOffset),
1030 /* This one is truly weird. What kind of weirdo decided that in
1031 a system dominated by 16 and 32 bit integers, they would use
1035 shptr = munge_int32 (header->hdr.s.FrequencyBias, shptr, 3);
1037 /* Why is this nybblified, when the MSB is *always* zero ?
1038 Anyway, we can't take address of bitfield, so make a
1039 good-faith guess at where it starts.
1042 shptr = munge_int32 (*(&header->hdr.s.FrequencyBias+1),
1045 if (snd_wavefront_cmd (dev,
1047 WFC_DOWNLOAD_SAMPLE : WFC_DOWNLOAD_SAMPLE_HEADER,
1048 NULL, sample_hdr)) {
1049 snd_printk ("sample %sdownload refused.\n",
1050 header->size ? "" : "header ");
1054 if (header->size == 0) {
1055 goto sent; /* Sorry. Just had to have one somewhere */
1058 data_end = dataptr + length;
1060 /* Do any initial skip over an unused channel's data */
1062 dataptr += initial_skip;
1064 for (written = 0, blocknum = 0;
1065 written < length; written += max_blksize, blocknum++) {
1067 if ((length - written) > max_blksize) {
1068 blocksize = max_blksize;
1070 /* round to nearest 16-byte value */
1071 blocksize = ((length-written+7)&~0x7);
1074 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_BLOCK, NULL, NULL)) {
1075 snd_printk ("download block "
1076 "request refused.\n");
1080 for (i = 0; i < blocksize; i++) {
1082 if (dataptr < data_end) {
1084 __get_user (sample_short, dataptr);
1087 if (data_is_unsigned) { /* GUS ? */
1089 if (WF_SAMPLE_IS_8BIT(&header->hdr.s)) {
1097 &sample_short)[0] += 0x7f;
1099 &sample_short)[1] += 0x7f;
1108 sample_short += 0x7fff;
1114 /* In padding section of final block:
1116 Don't fetch unsupplied data from
1117 user space, just continue with
1118 whatever the final value was.
1122 if (i < blocksize - 1) {
1123 outw (sample_short, dev->block_port);
1125 outw (sample_short, dev->last_block_port);
1129 /* Get "DMA page acknowledge", even though its really
1130 nothing to do with DMA at all.
1133 if ((dma_ack = wavefront_read (dev)) != WF_DMA_ACK) {
1134 if (dma_ack == -1) {
1135 snd_printk ("upload sample "
1136 "DMA ack timeout\n");
1139 snd_printk ("upload sample "
1140 "DMA ack error 0x%x\n",
1147 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_SAMPLE);
1149 /* Note, label is here because sending the sample header shouldn't
1150 alter the sample_status info at all.
1158 wavefront_send_alias (snd_wavefront_t *dev, wavefront_patch_info *header)
1161 unsigned char alias_hdr[WF_ALIAS_BYTES];
1163 DPRINT (WF_DEBUG_LOAD_PATCH, "download alias, %d is "
1166 header->hdr.a.OriginalSample);
1168 munge_int32 (header->number, &alias_hdr[0], 2);
1169 munge_int32 (header->hdr.a.OriginalSample, &alias_hdr[2], 2);
1170 munge_int32 (*((unsigned int *)&header->hdr.a.sampleStartOffset),
1172 munge_int32 (*((unsigned int *)&header->hdr.a.loopStartOffset),
1174 munge_int32 (*((unsigned int *)&header->hdr.a.loopEndOffset),
1176 munge_int32 (*((unsigned int *)&header->hdr.a.sampleEndOffset),
1178 munge_int32 (header->hdr.a.FrequencyBias, &alias_hdr[20], 3);
1179 munge_int32 (*(&header->hdr.a.FrequencyBias+1), &alias_hdr[23], 2);
1181 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_SAMPLE_ALIAS, NULL, alias_hdr)) {
1182 snd_printk ("download alias failed.\n");
1186 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_ALIAS);
1192 wavefront_send_multisample (snd_wavefront_t *dev, wavefront_patch_info *header)
1196 unsigned char *msample_hdr;
1198 msample_hdr = kmalloc(sizeof(WF_MSAMPLE_BYTES), GFP_KERNEL);
1202 munge_int32 (header->number, &msample_hdr[0], 2);
1204 /* You'll recall at this point that the "number of samples" value
1205 in a wavefront_multisample struct is actually the log2 of the
1206 real number of samples.
1209 num_samples = (1<<(header->hdr.ms.NumberOfSamples&7));
1210 msample_hdr[2] = (unsigned char) header->hdr.ms.NumberOfSamples;
1212 DPRINT (WF_DEBUG_LOAD_PATCH, "multi %d with %d=%d samples\n",
1214 header->hdr.ms.NumberOfSamples,
1217 for (i = 0; i < num_samples; i++) {
1218 DPRINT(WF_DEBUG_LOAD_PATCH|WF_DEBUG_DATA, "sample[%d] = %d\n",
1219 i, header->hdr.ms.SampleNumber[i]);
1220 munge_int32 (header->hdr.ms.SampleNumber[i],
1221 &msample_hdr[3+(i*2)], 2);
1224 /* Need a hack here to pass in the number of bytes
1225 to be written to the synth. This is ugly, and perhaps
1226 one day, I'll fix it.
1229 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_MULTISAMPLE,
1230 (unsigned char *) (long) ((num_samples*2)+3),
1232 snd_printk ("download of multisample failed.\n");
1237 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_MULTISAMPLE);
1244 wavefront_fetch_multisample (snd_wavefront_t *dev,
1245 wavefront_patch_info *header)
1248 unsigned char log_ns[1];
1249 unsigned char number[2];
1252 munge_int32 (header->number, number, 2);
1254 if (snd_wavefront_cmd (dev, WFC_UPLOAD_MULTISAMPLE, log_ns, number)) {
1255 snd_printk ("upload multisample failed.\n");
1259 DPRINT (WF_DEBUG_DATA, "msample %d has %d samples\n",
1260 header->number, log_ns[0]);
1262 header->hdr.ms.NumberOfSamples = log_ns[0];
1264 /* get the number of samples ... */
1266 num_samples = (1 << log_ns[0]);
1268 for (i = 0; i < num_samples; i++) {
1272 if ((val = wavefront_read (dev)) == -1) {
1273 snd_printk ("upload multisample failed "
1274 "during sample loop.\n");
1279 if ((val = wavefront_read (dev)) == -1) {
1280 snd_printk ("upload multisample failed "
1281 "during sample loop.\n");
1286 header->hdr.ms.SampleNumber[i] =
1287 demunge_int32 ((unsigned char *) d, 2);
1289 DPRINT (WF_DEBUG_DATA, "msample sample[%d] = %d\n",
1290 i, header->hdr.ms.SampleNumber[i]);
1298 wavefront_send_drum (snd_wavefront_t *dev, wavefront_patch_info *header)
1301 unsigned char drumbuf[WF_DRUM_BYTES];
1302 wavefront_drum *drum = &header->hdr.d;
1305 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading edrum for MIDI "
1306 "note %d, patch = %d\n",
1307 header->number, drum->PatchNumber);
1309 drumbuf[0] = header->number & 0x7f;
1311 for (i = 0; i < 4; i++) {
1312 munge_int32 (((unsigned char *)drum)[i], &drumbuf[1+(i*2)], 2);
1315 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_EDRUM_PROGRAM, NULL, drumbuf)) {
1316 snd_printk ("download drum failed.\n");
1324 wavefront_find_free_sample (snd_wavefront_t *dev)
1329 for (i = 0; i < WF_MAX_SAMPLE; i++) {
1330 if (!(dev->sample_status[i] & WF_SLOT_FILLED)) {
1334 snd_printk ("no free sample slots!\n");
1340 wavefront_find_free_patch (snd_wavefront_t *dev)
1345 for (i = 0; i < WF_MAX_PATCH; i++) {
1346 if (!(dev->patch_status[i] & WF_SLOT_FILLED)) {
1350 snd_printk ("no free patch slots!\n");
1356 wavefront_load_patch (snd_wavefront_t *dev, const char __user *addr)
1358 wavefront_patch_info *header;
1361 header = kmalloc(sizeof(*header), GFP_KERNEL);
1365 if (copy_from_user (header, addr, sizeof(wavefront_patch_info) -
1366 sizeof(wavefront_any))) {
1367 snd_printk ("bad address for load patch.\n");
1372 DPRINT (WF_DEBUG_LOAD_PATCH, "download "
1374 "Sample number: %d "
1375 "Sample size: %d\n",
1380 switch (header->subkey) {
1381 case WF_ST_SAMPLE: /* sample or sample_header, based on patch->size */
1383 if (copy_from_user (&header->hdr.s, header->hdrptr,
1384 sizeof (wavefront_sample))) {
1389 err = wavefront_send_sample (dev, header, header->dataptr, 0);
1392 case WF_ST_MULTISAMPLE:
1394 if (copy_from_user (&header->hdr.s, header->hdrptr,
1395 sizeof (wavefront_multisample))) {
1400 err = wavefront_send_multisample (dev, header);
1405 if (copy_from_user (&header->hdr.a, header->hdrptr,
1406 sizeof (wavefront_alias))) {
1411 err = wavefront_send_alias (dev, header);
1415 if (copy_from_user (&header->hdr.d, header->hdrptr,
1416 sizeof (wavefront_drum))) {
1421 err = wavefront_send_drum (dev, header);
1425 if (copy_from_user (&header->hdr.p, header->hdrptr,
1426 sizeof (wavefront_patch))) {
1431 err = wavefront_send_patch (dev, header);
1435 if (copy_from_user (&header->hdr.pr, header->hdrptr,
1436 sizeof (wavefront_program))) {
1441 err = wavefront_send_program (dev, header);
1445 snd_printk ("unknown patch type %d.\n",
1456 /***********************************************************************
1457 WaveFront: hardware-dependent interface
1458 ***********************************************************************/
1461 process_sample_hdr (u8 *buf)
1469 /* The board doesn't send us an exact copy of a "wavefront_sample"
1470 in response to an Upload Sample Header command. Instead, we
1471 have to convert the data format back into our data structure,
1472 just as in the Download Sample command, where we have to do
1473 something very similar in the reverse direction.
1476 *((u32 *) &s.sampleStartOffset) = demunge_int32 (ptr, 4); ptr += 4;
1477 *((u32 *) &s.loopStartOffset) = demunge_int32 (ptr, 4); ptr += 4;
1478 *((u32 *) &s.loopEndOffset) = demunge_int32 (ptr, 4); ptr += 4;
1479 *((u32 *) &s.sampleEndOffset) = demunge_int32 (ptr, 4); ptr += 4;
1480 *((u32 *) &s.FrequencyBias) = demunge_int32 (ptr, 3); ptr += 3;
1482 s.SampleResolution = *ptr & 0x3;
1483 s.Loop = *ptr & 0x8;
1484 s.Bidirectional = *ptr & 0x10;
1485 s.Reverse = *ptr & 0x40;
1487 /* Now copy it back to where it came from */
1489 memcpy (buf, (unsigned char *) &s, sizeof (wavefront_sample));
1493 wavefront_synth_control (snd_wavefront_card_t *acard,
1494 wavefront_control *wc)
1497 snd_wavefront_t *dev = &acard->wavefront;
1498 unsigned char patchnumbuf[2];
1501 DPRINT (WF_DEBUG_CMD, "synth control with "
1502 "cmd 0x%x\n", wc->cmd);
1504 /* Pre-handling of or for various commands */
1508 case WFC_DISABLE_INTERRUPTS:
1509 snd_printk ("interrupts disabled.\n");
1510 outb (0x80|0x20, dev->control_port);
1511 dev->interrupts_are_midi = 1;
1514 case WFC_ENABLE_INTERRUPTS:
1515 snd_printk ("interrupts enabled.\n");
1516 outb (0x80|0x40|0x20, dev->control_port);
1517 dev->interrupts_are_midi = 1;
1520 case WFC_INTERRUPT_STATUS:
1521 wc->rbuf[0] = dev->interrupts_are_midi;
1524 case WFC_ROMSAMPLES_RDONLY:
1525 dev->rom_samples_rdonly = wc->wbuf[0];
1529 case WFC_IDENTIFY_SLOT_TYPE:
1530 i = wc->wbuf[0] | (wc->wbuf[1] << 7);
1531 if (i <0 || i >= WF_MAX_SAMPLE) {
1532 snd_printk ("invalid slot ID %d\n",
1534 wc->status = EINVAL;
1537 wc->rbuf[0] = dev->sample_status[i];
1541 case WFC_DEBUG_DRIVER:
1542 dev->debug = wc->wbuf[0];
1543 snd_printk ("debug = 0x%x\n", dev->debug);
1546 case WFC_UPLOAD_PATCH:
1547 munge_int32 (*((u32 *) wc->wbuf), patchnumbuf, 2);
1548 memcpy (wc->wbuf, patchnumbuf, 2);
1551 case WFC_UPLOAD_MULTISAMPLE:
1552 /* multisamples have to be handled differently, and
1553 cannot be dealt with properly by snd_wavefront_cmd() alone.
1555 wc->status = wavefront_fetch_multisample
1556 (dev, (wavefront_patch_info *) wc->rbuf);
1559 case WFC_UPLOAD_SAMPLE_ALIAS:
1560 snd_printk ("support for sample alias upload "
1561 "being considered.\n");
1562 wc->status = EINVAL;
1566 wc->status = snd_wavefront_cmd (dev, wc->cmd, wc->rbuf, wc->wbuf);
1568 /* Post-handling of certain commands.
1570 In particular, if the command was an upload, demunge the data
1571 so that the user-level doesn't have to think about it.
1574 if (wc->status == 0) {
1576 /* intercept any freemem requests so that we know
1577 we are always current with the user-level view
1581 case WFC_REPORT_FREE_MEMORY:
1582 dev->freemem = demunge_int32 (wc->rbuf, 4);
1585 case WFC_UPLOAD_PATCH:
1586 demunge_buf (wc->rbuf, wc->rbuf, WF_PATCH_BYTES);
1589 case WFC_UPLOAD_PROGRAM:
1590 demunge_buf (wc->rbuf, wc->rbuf, WF_PROGRAM_BYTES);
1593 case WFC_UPLOAD_EDRUM_PROGRAM:
1594 demunge_buf (wc->rbuf, wc->rbuf, WF_DRUM_BYTES - 1);
1597 case WFC_UPLOAD_SAMPLE_HEADER:
1598 process_sample_hdr (wc->rbuf);
1601 case WFC_UPLOAD_SAMPLE_ALIAS:
1602 snd_printk ("support for "
1603 "sample aliases still "
1604 "being considered.\n");
1608 snd_wavefront_midi_disable_virtual (acard);
1612 snd_wavefront_midi_enable_virtual (acard);
1621 snd_wavefront_synth_open (struct snd_hwdep *hw, struct file *file)
1624 if (!try_module_get(hw->card->module))
1626 file->private_data = hw;
1631 snd_wavefront_synth_release (struct snd_hwdep *hw, struct file *file)
1634 module_put(hw->card->module);
1639 snd_wavefront_synth_ioctl (struct snd_hwdep *hw, struct file *file,
1640 unsigned int cmd, unsigned long arg)
1643 struct snd_card *card;
1644 snd_wavefront_t *dev;
1645 snd_wavefront_card_t *acard;
1646 wavefront_control *wc;
1647 void __user *argp = (void __user *)arg;
1650 card = (struct snd_card *) hw->card;
1652 snd_assert(card != NULL, return -ENODEV);
1654 snd_assert(card->private_data != NULL, return -ENODEV);
1656 acard = card->private_data;
1657 dev = &acard->wavefront;
1660 case WFCTL_LOAD_SPP:
1661 if (wavefront_load_patch (dev, argp) != 0) {
1667 wc = kmalloc(sizeof(*wc), GFP_KERNEL);
1670 if (copy_from_user (wc, argp, sizeof (*wc)))
1672 else if (wavefront_synth_control (acard, wc) < 0)
1674 else if (copy_to_user (argp, wc, sizeof (*wc)))
1689 /***********************************************************************/
1690 /* WaveFront: interface for card-level wavefront module */
1691 /***********************************************************************/
1694 snd_wavefront_internal_interrupt (snd_wavefront_card_t *card)
1696 snd_wavefront_t *dev = &card->wavefront;
1699 Some comments on interrupts. I attempted a version of this
1700 driver that used interrupts throughout the code instead of
1701 doing busy and/or sleep-waiting. Alas, it appears that once
1702 the Motorola firmware is downloaded, the card *never*
1703 generates an RX interrupt. These are successfully generated
1704 during firmware loading, and after that wavefront_status()
1705 reports that an interrupt is pending on the card from time
1706 to time, but it never seems to be delivered to this
1707 driver. Note also that wavefront_status() continues to
1708 report that RX interrupts are enabled, suggesting that I
1709 didn't goof up and disable them by mistake.
1711 Thus, I stepped back to a prior version of
1712 wavefront_wait(), the only place where this really
1713 matters. Its sad, but I've looked through the code to check
1714 on things, and I really feel certain that the Motorola
1715 firmware prevents RX-ready interrupts.
1718 if ((wavefront_status(dev) & (STAT_INTR_READ|STAT_INTR_WRITE)) == 0) {
1722 spin_lock(&dev->irq_lock);
1725 spin_unlock(&dev->irq_lock);
1726 wake_up(&dev->interrupt_sleeper);
1731 0 Host Rx Interrupt Enable (1=Enabled)
1732 1 Host Rx Register Full (1=Full)
1733 2 Host Rx Interrupt Pending (1=Interrupt)
1735 4 Host Tx Interrupt (1=Enabled)
1736 5 Host Tx Register empty (1=Empty)
1737 6 Host Tx Interrupt Pending (1=Interrupt)
1741 static int __devinit
1742 snd_wavefront_interrupt_bits (int irq)
1762 snd_printk ("invalid IRQ %d\n", irq);
1769 static void __devinit
1770 wavefront_should_cause_interrupt (snd_wavefront_t *dev,
1771 int val, int port, int timeout)
1776 init_waitqueue_entry(&wait, current);
1777 spin_lock_irq(&dev->irq_lock);
1778 add_wait_queue(&dev->interrupt_sleeper, &wait);
1781 spin_unlock_irq(&dev->irq_lock);
1783 if ((timeout = schedule_timeout_interruptible(timeout)) == 0)
1790 static int __devinit
1791 wavefront_reset_to_cleanliness (snd_wavefront_t *dev)
1797 /* IRQ already checked */
1799 bits = snd_wavefront_interrupt_bits (dev->irq);
1801 /* try reset of port */
1803 outb (0x0, dev->control_port);
1805 /* At this point, the board is in reset, and the H/W initialization
1806 register is accessed at the same address as the data port.
1808 Bit 7 - Enable IRQ Driver
1809 0 - Tri-state the Wave-Board drivers for the PC Bus IRQs
1810 1 - Enable IRQ selected by bits 5:3 to be driven onto the PC Bus.
1812 Bit 6 - MIDI Interface Select
1814 0 - Use the MIDI Input from the 26-pin WaveBlaster
1815 compatible header as the serial MIDI source
1816 1 - Use the MIDI Input from the 9-pin D connector as the
1819 Bits 5:3 - IRQ Selection
1830 Bit 0 - Disable Boot ROM
1831 0 - memory accesses to 03FC30-03FFFFH utilize the internal Boot ROM
1832 1 - memory accesses to 03FC30-03FFFFH are directed to external
1837 /* configure hardware: IRQ, enable interrupts,
1838 plus external 9-pin MIDI interface selected
1841 outb (0x80 | 0x40 | bits, dev->data_port);
1845 0 Host Rx Interrupt Enable (1=Enabled) 0x1
1849 4 Host Tx Interrupt Enable 0x10
1850 5 Mute (0=Mute; 1=Play) 0x20
1851 6 Master Interrupt Enable (1=Enabled) 0x40
1852 7 Master Reset (0=Reset; 1=Run) 0x80
1854 Take us out of reset, mute output, master + TX + RX interrupts on.
1856 We'll get an interrupt presumably to tell us that the TX
1860 wavefront_should_cause_interrupt(dev, 0x80|0x40|0x10|0x1,
1862 (reset_time*HZ)/100);
1864 /* Note: data port is now the data port, not the h/w initialization
1869 snd_printk ("intr not received after h/w un-reset.\n");
1873 /* Note: data port is now the data port, not the h/w initialization
1876 At this point, only "HW VERSION" or "DOWNLOAD OS" commands
1877 will work. So, issue one of them, and wait for TX
1878 interrupt. This can take a *long* time after a cold boot,
1879 while the ISC ROM does its RAM test. The SDK says up to 4
1880 seconds - with 12MB of RAM on a Tropez+, it takes a lot
1881 longer than that (~16secs). Note that the card understands
1882 the difference between a warm and a cold boot, so
1883 subsequent ISC2115 reboots (say, caused by module
1884 reloading) will get through this much faster.
1886 XXX Interesting question: why is no RX interrupt received first ?
1889 wavefront_should_cause_interrupt(dev, WFC_HARDWARE_VERSION,
1890 dev->data_port, ramcheck_time*HZ);
1893 snd_printk ("post-RAM-check interrupt not received.\n");
1897 if (!wavefront_wait (dev, STAT_CAN_READ)) {
1898 snd_printk ("no response to HW version cmd.\n");
1902 if ((hwv[0] = wavefront_read (dev)) == -1) {
1903 snd_printk ("board not responding correctly.\n");
1907 if (hwv[0] == 0xFF) { /* NAK */
1909 /* Board's RAM test failed. Try to read error code,
1910 and tell us about it either way.
1913 if ((hwv[0] = wavefront_read (dev)) == -1) {
1914 snd_printk ("on-board RAM test failed "
1915 "(bad error code).\n");
1917 snd_printk ("on-board RAM test failed "
1918 "(error code: 0x%x).\n",
1924 /* We're OK, just get the next byte of the HW version response */
1926 if ((hwv[1] = wavefront_read (dev)) == -1) {
1927 snd_printk ("incorrect h/w response.\n");
1931 snd_printk ("hardware version %d.%d\n",
1941 #include <linux/fs.h>
1942 #include <linux/mm.h>
1943 #include <linux/slab.h>
1944 #include <linux/unistd.h>
1945 #include <linux/syscalls.h>
1946 #include <asm/uaccess.h>
1949 static int __devinit
1950 wavefront_download_firmware (snd_wavefront_t *dev, char *path)
1953 unsigned char section[WF_SECTION_MAX];
1954 signed char section_length; /* yes, just a char; max value is WF_SECTION_MAX */
1955 int section_cnt_downloaded = 0;
1961 /* This tries to be a bit cleverer than the stuff Alan Cox did for
1962 the generic sound firmware, in that it actually knows
1963 something about the structure of the Motorola firmware. In
1964 particular, it uses a version that has been stripped of the
1965 20K of useless header information, and had section lengths
1966 added, making it possible to load the entire OS without any
1967 [kv]malloc() activity, since the longest entity we ever read is
1968 42 bytes (well, WF_SECTION_MAX) long.
1974 if ((fd = sys_open ((char __user *) path, 0, 0)) < 0) {
1975 snd_printk ("Unable to load \"%s\".\n",
1983 if ((x = sys_read (fd, (char __user *) §ion_length, sizeof (section_length))) !=
1984 sizeof (section_length)) {
1985 snd_printk ("firmware read error.\n");
1989 if (section_length == 0) {
1993 if (section_length < 0 || section_length > WF_SECTION_MAX) {
1994 snd_printk ("invalid firmware section length %d\n",
1999 if (sys_read (fd, (char __user *) section, section_length) != section_length) {
2000 snd_printk ("firmware section "
2007 if (wavefront_write (dev, WFC_DOWNLOAD_OS)) {
2011 for (i = 0; i < section_length; i++) {
2012 if (wavefront_write (dev, section[i])) {
2019 if (wavefront_wait (dev, STAT_CAN_READ)) {
2021 if ((c = inb (dev->data_port)) != WF_ACK) {
2023 snd_printk ("download "
2024 "of section #%d not "
2025 "acknowledged, ack = 0x%x\n",
2026 section_cnt_downloaded + 1, c);
2032 snd_printk ("time out for firmware ACK.\n");
2045 snd_printk ("firmware download failed!!!\n");
2050 static int __devinit
2051 wavefront_do_reset (snd_wavefront_t *dev)
2056 if (wavefront_reset_to_cleanliness (dev)) {
2057 snd_printk ("hw reset failed.\n");
2062 if (wavefront_download_firmware (dev, ospath)) {
2068 /* Wait for the OS to get running. The protocol for
2069 this is non-obvious, and was determined by
2070 using port-IO tracing in DOSemu and some
2071 experimentation here.
2073 Rather than using timed waits, use interrupts creatively.
2076 wavefront_should_cause_interrupt (dev, WFC_NOOP,
2081 snd_printk ("no post-OS interrupt.\n");
2085 /* Now, do it again ! */
2087 wavefront_should_cause_interrupt (dev, WFC_NOOP,
2088 dev->data_port, (10*HZ));
2091 snd_printk ("no post-OS interrupt(2).\n");
2095 /* OK, no (RX/TX) interrupts any more, but leave mute
2099 outb (0x80|0x40, dev->control_port);
2102 /* SETUPSND.EXE asks for sample memory config here, but since i
2103 have no idea how to interpret the result, we'll forget
2107 if ((dev->freemem = wavefront_freemem (dev)) < 0) {
2111 snd_printk ("available DRAM %dk\n", dev->freemem / 1024);
2113 if (wavefront_write (dev, 0xf0) ||
2114 wavefront_write (dev, 1) ||
2115 (wavefront_read (dev) < 0)) {
2117 snd_printk ("MPU emulation mode not set.\n");
2123 if (snd_wavefront_cmd (dev, WFC_SET_NVOICES, NULL, voices)) {
2124 snd_printk ("cannot set number of voices to 32.\n");
2132 /* reset that sucker so that it doesn't bother us. */
2134 outb (0x0, dev->control_port);
2135 dev->interrupts_are_midi = 0;
2140 snd_wavefront_start (snd_wavefront_t *dev)
2143 int samples_are_from_rom;
2145 /* IMPORTANT: assumes that snd_wavefront_detect() and/or
2146 wavefront_reset_to_cleanliness() has already been called
2150 samples_are_from_rom = 1;
2152 /* XXX is this always true ? */
2153 samples_are_from_rom = 0;
2156 if (dev->israw || fx_raw) {
2157 if (wavefront_do_reset (dev)) {
2161 /* Check for FX device, present only on Tropez+ */
2163 dev->has_fx = (snd_wavefront_fx_detect (dev) == 0);
2165 if (dev->has_fx && fx_raw) {
2166 snd_wavefront_fx_start (dev);
2169 wavefront_get_sample_status (dev, samples_are_from_rom);
2170 wavefront_get_program_status (dev);
2171 wavefront_get_patch_status (dev);
2173 /* Start normal operation: unreset, master interrupt enabled, no mute
2176 outb (0x80|0x40|0x20, dev->control_port);
2182 snd_wavefront_detect (snd_wavefront_card_t *card)
2185 unsigned char rbuf[4], wbuf[4];
2186 snd_wavefront_t *dev = &card->wavefront;
2188 /* returns zero if a WaveFront card is successfully detected.
2194 dev->debug = debug_default;
2195 dev->interrupts_are_midi = 0;
2197 dev->rom_samples_rdonly = 1;
2199 if (snd_wavefront_cmd (dev, WFC_FIRMWARE_VERSION, rbuf, wbuf) == 0) {
2201 dev->fw_version[0] = rbuf[0];
2202 dev->fw_version[1] = rbuf[1];
2204 snd_printk ("firmware %d.%d already loaded.\n",
2207 /* check that a command actually works */
2209 if (snd_wavefront_cmd (dev, WFC_HARDWARE_VERSION,
2211 dev->hw_version[0] = rbuf[0];
2212 dev->hw_version[1] = rbuf[1];
2214 snd_printk ("not raw, but no "
2215 "hardware version!\n");
2222 snd_printk ("reloading firmware as you requested.\n");
2229 snd_printk ("no response to firmware probe, assume raw.\n");