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.
24 #include <linux/interrupt.h>
25 #include <linux/init.h>
26 #include <linux/delay.h>
27 #include <linux/time.h>
28 #include <linux/wait.h>
29 #include <linux/sched/signal.h>
30 #include <linux/firmware.h>
31 #include <linux/moduleparam.h>
32 #include <linux/slab.h>
33 #include <linux/module.h>
34 #include <sound/core.h>
35 #include <sound/snd_wavefront.h>
36 #include <sound/initval.h>
38 static int wf_raw = 0; /* we normally check for "raw state" to firmware
39 loading. if non-zero, then during driver loading, the
40 state of the board is ignored, and we reset the
41 board and load the firmware anyway.
44 static int fx_raw = 1; /* if this is zero, we'll leave the FX processor in
45 whatever state it is when the driver is loaded.
46 The default is to download the microprogram and
47 associated coefficients to set it up for "default"
48 operation, whatever that means.
51 static int debug_default = 0; /* you can set this to control debugging
52 during driver loading. it takes any combination
53 of the WF_DEBUG_* flags defined in
57 /* XXX this needs to be made firmware and hardware version dependent */
59 #define DEFAULT_OSPATH "/*(DEBLOBBED)*/"
60 static char *ospath = DEFAULT_OSPATH; /* the firmware file name */
62 static int wait_usecs = 150; /* This magic number seems to give pretty optimal
63 throughput based on my limited experimentation.
64 If you want to play around with it and find a better
65 value, be my guest. Remember, the idea is to
66 get a number that causes us to just busy wait
67 for as many WaveFront commands as possible, without
68 coming up with a number so large that we hog the
71 Specifically, with this number, out of about 134,000
72 status waits, only about 250 result in a sleep.
75 static int sleep_interval = 100; /* HZ/sleep_interval seconds per sleep */
76 static int sleep_tries = 50; /* number of times we'll try to sleep */
78 static int reset_time = 2; /* hundreths of a second we wait after a HW
79 reset for the expected interrupt.
82 static int ramcheck_time = 20; /* time in seconds to wait while ROM code
86 static int osrun_time = 10; /* time in seconds we wait for the OS to
89 module_param(wf_raw, int, 0444);
90 MODULE_PARM_DESC(wf_raw, "if non-zero, assume that we need to boot the OS");
91 module_param(fx_raw, int, 0444);
92 MODULE_PARM_DESC(fx_raw, "if non-zero, assume that the FX process needs help");
93 module_param(debug_default, int, 0444);
94 MODULE_PARM_DESC(debug_default, "debug parameters for card initialization");
95 module_param(wait_usecs, int, 0444);
96 MODULE_PARM_DESC(wait_usecs, "how long to wait without sleeping, usecs");
97 module_param(sleep_interval, int, 0444);
98 MODULE_PARM_DESC(sleep_interval, "how long to sleep when waiting for reply");
99 module_param(sleep_tries, int, 0444);
100 MODULE_PARM_DESC(sleep_tries, "how many times to try sleeping during a wait");
101 module_param(ospath, charp, 0444);
102 MODULE_PARM_DESC(ospath, "pathname to processed ICS2115 OS firmware");
103 module_param(reset_time, int, 0444);
104 MODULE_PARM_DESC(reset_time, "how long to wait for a reset to take effect");
105 module_param(ramcheck_time, int, 0444);
106 MODULE_PARM_DESC(ramcheck_time, "how many seconds to wait for the RAM test");
107 module_param(osrun_time, int, 0444);
108 MODULE_PARM_DESC(osrun_time, "how many seconds to wait for the ICS2115 OS");
110 /* if WF_DEBUG not defined, no run-time debugging messages will
111 be available via the debug flag setting. Given the current
112 beta state of the driver, this will remain set until a future
120 #define DPRINT(cond, ...) \
121 if ((dev->debug & (cond)) == (cond)) { \
122 snd_printk (__VA_ARGS__); \
125 #define DPRINT(cond, args...)
126 #endif /* WF_DEBUG */
128 #define LOGNAME "WaveFront: "
130 /* bitmasks for WaveFront status port value */
132 #define STAT_RINTR_ENABLED 0x01
133 #define STAT_CAN_READ 0x02
134 #define STAT_INTR_READ 0x04
135 #define STAT_WINTR_ENABLED 0x10
136 #define STAT_CAN_WRITE 0x20
137 #define STAT_INTR_WRITE 0x40
139 static int wavefront_delete_sample (snd_wavefront_t *, int sampnum);
140 static int wavefront_find_free_sample (snd_wavefront_t *);
142 struct wavefront_command {
145 unsigned int read_cnt;
146 unsigned int write_cnt;
153 } wavefront_errors[] = {
154 { 0x01, "Bad sample number" },
155 { 0x02, "Out of sample memory" },
156 { 0x03, "Bad patch number" },
157 { 0x04, "Error in number of voices" },
158 { 0x06, "Sample load already in progress" },
159 { 0x0B, "No sample load request pending" },
160 { 0x0E, "Bad MIDI channel number" },
161 { 0x10, "Download Record Error" },
168 static struct wavefront_command wavefront_commands[] = {
169 { WFC_SET_SYNTHVOL, "set synthesizer volume", 0, 1, NEEDS_ACK },
170 { WFC_GET_SYNTHVOL, "get synthesizer volume", 1, 0, 0},
171 { WFC_SET_NVOICES, "set number of voices", 0, 1, NEEDS_ACK },
172 { WFC_GET_NVOICES, "get number of voices", 1, 0, 0 },
173 { WFC_SET_TUNING, "set synthesizer tuning", 0, 2, NEEDS_ACK },
174 { WFC_GET_TUNING, "get synthesizer tuning", 2, 0, 0 },
175 { WFC_DISABLE_CHANNEL, "disable synth channel", 0, 1, NEEDS_ACK },
176 { WFC_ENABLE_CHANNEL, "enable synth channel", 0, 1, NEEDS_ACK },
177 { WFC_GET_CHANNEL_STATUS, "get synth channel status", 3, 0, 0 },
178 { WFC_MISYNTH_OFF, "disable midi-in to synth", 0, 0, NEEDS_ACK },
179 { WFC_MISYNTH_ON, "enable midi-in to synth", 0, 0, NEEDS_ACK },
180 { WFC_VMIDI_ON, "enable virtual midi mode", 0, 0, NEEDS_ACK },
181 { WFC_VMIDI_OFF, "disable virtual midi mode", 0, 0, NEEDS_ACK },
182 { WFC_MIDI_STATUS, "report midi status", 1, 0, 0 },
183 { WFC_FIRMWARE_VERSION, "report firmware version", 2, 0, 0 },
184 { WFC_HARDWARE_VERSION, "report hardware version", 2, 0, 0 },
185 { WFC_GET_NSAMPLES, "report number of samples", 2, 0, 0 },
186 { WFC_INSTOUT_LEVELS, "report instantaneous output levels", 7, 0, 0 },
187 { WFC_PEAKOUT_LEVELS, "report peak output levels", 7, 0, 0 },
188 { WFC_DOWNLOAD_SAMPLE, "download sample",
189 0, WF_SAMPLE_BYTES, NEEDS_ACK },
190 { WFC_DOWNLOAD_BLOCK, "download block", 0, 0, NEEDS_ACK},
191 { WFC_DOWNLOAD_SAMPLE_HEADER, "download sample header",
192 0, WF_SAMPLE_HDR_BYTES, NEEDS_ACK },
193 { WFC_UPLOAD_SAMPLE_HEADER, "upload sample header", 13, 2, 0 },
195 /* This command requires a variable number of bytes to be written.
196 There is a hack in snd_wavefront_cmd() to support this. The actual
197 count is passed in as the read buffer ptr, cast appropriately.
201 { WFC_DOWNLOAD_MULTISAMPLE, "download multisample", 0, 0, NEEDS_ACK },
203 /* This one is a hack as well. We just read the first byte of the
204 response, don't fetch an ACK, and leave the rest to the
205 calling function. Ugly, ugly, ugly.
208 { WFC_UPLOAD_MULTISAMPLE, "upload multisample", 2, 1, 0 },
209 { WFC_DOWNLOAD_SAMPLE_ALIAS, "download sample alias",
210 0, WF_ALIAS_BYTES, NEEDS_ACK },
211 { WFC_UPLOAD_SAMPLE_ALIAS, "upload sample alias", WF_ALIAS_BYTES, 2, 0},
212 { WFC_DELETE_SAMPLE, "delete sample", 0, 2, NEEDS_ACK },
213 { WFC_IDENTIFY_SAMPLE_TYPE, "identify sample type", 5, 2, 0 },
214 { WFC_UPLOAD_SAMPLE_PARAMS, "upload sample parameters" },
215 { WFC_REPORT_FREE_MEMORY, "report free memory", 4, 0, 0 },
216 { WFC_DOWNLOAD_PATCH, "download patch", 0, 134, NEEDS_ACK },
217 { WFC_UPLOAD_PATCH, "upload patch", 132, 2, 0 },
218 { WFC_DOWNLOAD_PROGRAM, "download program", 0, 33, NEEDS_ACK },
219 { WFC_UPLOAD_PROGRAM, "upload program", 32, 1, 0 },
220 { WFC_DOWNLOAD_EDRUM_PROGRAM, "download enhanced drum program", 0, 9,
222 { WFC_UPLOAD_EDRUM_PROGRAM, "upload enhanced drum program", 8, 1, 0},
223 { WFC_SET_EDRUM_CHANNEL, "set enhanced drum program channel",
225 { WFC_DISABLE_DRUM_PROGRAM, "disable drum program", 0, 1, NEEDS_ACK },
226 { WFC_REPORT_CHANNEL_PROGRAMS, "report channel program numbers",
228 { WFC_NOOP, "the no-op command", 0, 0, NEEDS_ACK },
233 wavefront_errorstr (int errnum)
238 for (i = 0; wavefront_errors[i].errstr; i++) {
239 if (wavefront_errors[i].errno == errnum) {
240 return wavefront_errors[i].errstr;
244 return "Unknown WaveFront error";
247 static struct wavefront_command *
248 wavefront_get_command (int cmd)
253 for (i = 0; wavefront_commands[i].cmd != 0; i++) {
254 if (cmd == wavefront_commands[i].cmd) {
255 return &wavefront_commands[i];
263 wavefront_status (snd_wavefront_t *dev)
266 return inb (dev->status_port);
270 wavefront_sleep (int limit)
273 schedule_timeout_interruptible(limit);
275 return signal_pending(current);
279 wavefront_wait (snd_wavefront_t *dev, int mask)
284 /* Spin for a short period of time, because >99% of all
285 requests to the WaveFront can be serviced inline like this.
288 for (i = 0; i < wait_usecs; i += 5) {
289 if (wavefront_status (dev) & mask) {
295 for (i = 0; i < sleep_tries; i++) {
297 if (wavefront_status (dev) & mask) {
301 if (wavefront_sleep (HZ/sleep_interval)) {
310 wavefront_read (snd_wavefront_t *dev)
313 if (wavefront_wait (dev, STAT_CAN_READ))
314 return inb (dev->data_port);
316 DPRINT (WF_DEBUG_DATA, "read timeout.\n");
322 wavefront_write (snd_wavefront_t *dev, unsigned char data)
325 if (wavefront_wait (dev, STAT_CAN_WRITE)) {
326 outb (data, dev->data_port);
330 DPRINT (WF_DEBUG_DATA, "write timeout.\n");
336 snd_wavefront_cmd (snd_wavefront_t *dev,
337 int cmd, unsigned char *rbuf, unsigned char *wbuf)
343 struct wavefront_command *wfcmd;
345 if ((wfcmd = wavefront_get_command (cmd)) == NULL) {
346 snd_printk ("command 0x%x not supported.\n",
351 /* Hack to handle the one variable-size write command. See
352 wavefront_send_multisample() for the other half of this
353 gross and ugly strategy.
356 if (cmd == WFC_DOWNLOAD_MULTISAMPLE) {
357 wfcmd->write_cnt = (unsigned long) rbuf;
361 DPRINT (WF_DEBUG_CMD, "0x%x [%s] (%d,%d,%d)\n",
362 cmd, wfcmd->action, wfcmd->read_cnt,
363 wfcmd->write_cnt, wfcmd->need_ack);
365 if (wavefront_write (dev, cmd)) {
366 DPRINT ((WF_DEBUG_IO|WF_DEBUG_CMD), "cannot request "
372 if (wfcmd->write_cnt > 0) {
373 DPRINT (WF_DEBUG_DATA, "writing %d bytes "
375 wfcmd->write_cnt, cmd);
377 for (i = 0; i < wfcmd->write_cnt; i++) {
378 if (wavefront_write (dev, wbuf[i])) {
379 DPRINT (WF_DEBUG_IO, "bad write for byte "
380 "%d of 0x%x [%s].\n",
381 i, cmd, wfcmd->action);
385 DPRINT (WF_DEBUG_DATA, "write[%d] = 0x%x\n",
390 if (wfcmd->read_cnt > 0) {
391 DPRINT (WF_DEBUG_DATA, "reading %d ints "
393 wfcmd->read_cnt, cmd);
395 for (i = 0; i < wfcmd->read_cnt; i++) {
397 if ((c = wavefront_read (dev)) == -1) {
398 DPRINT (WF_DEBUG_IO, "bad read for byte "
399 "%d of 0x%x [%s].\n",
400 i, cmd, wfcmd->action);
404 /* Now handle errors. Lots of special cases here */
407 if ((c = wavefront_read (dev)) == -1) {
408 DPRINT (WF_DEBUG_IO, "bad read for "
417 /* Can you believe this madness ? */
420 wfcmd->cmd == WFC_IDENTIFY_SAMPLE_TYPE) {
421 rbuf[0] = WF_ST_EMPTY;
425 wfcmd->cmd == WFC_UPLOAD_PATCH) {
430 wfcmd->cmd == WFC_UPLOAD_PROGRAM) {
436 DPRINT (WF_DEBUG_IO, "error %d (%s) "
442 wavefront_errorstr (c),
453 DPRINT (WF_DEBUG_DATA, "read[%d] = 0x%x\n",i, rbuf[i]);
457 if ((wfcmd->read_cnt == 0 && wfcmd->write_cnt == 0) || wfcmd->need_ack) {
459 DPRINT (WF_DEBUG_CMD, "reading ACK for 0x%x\n", cmd);
461 /* Some commands need an ACK, but return zero instead
462 of the standard value.
465 if ((ack = wavefront_read (dev)) == 0) {
471 DPRINT (WF_DEBUG_IO, "cannot read ack for "
477 int err = -1; /* something unknown */
479 if (ack == 0xff) { /* explicit error */
481 if ((err = wavefront_read (dev)) == -1) {
482 DPRINT (WF_DEBUG_DATA,
489 DPRINT (WF_DEBUG_IO, "0x%x [%s] "
490 "failed (0x%x, 0x%x, %s)\n",
491 cmd, wfcmd->action, ack, err,
492 wavefront_errorstr (err));
498 DPRINT (WF_DEBUG_DATA, "ack received "
503 DPRINT (WF_DEBUG_CMD, "0x%x [%s] does not need "
505 cmd, wfcmd->action, wfcmd->read_cnt,
506 wfcmd->write_cnt, wfcmd->need_ack);
513 /***********************************************************************
514 WaveFront data munging
516 Things here are weird. All data written to the board cannot
517 have its most significant bit set. Any data item with values
518 potentially > 0x7F (127) must be split across multiple bytes.
520 Sometimes, we need to munge numeric values that are represented on
521 the x86 side as 8-32 bit values. Sometimes, we need to munge data
522 that is represented on the x86 side as an array of bytes. The most
523 efficient approach to handling both cases seems to be to use 2
524 different functions for munging and 2 for de-munging. This avoids
525 weird casting and worrying about bit-level offsets.
527 **********************************************************************/
529 static unsigned char *
530 munge_int32 (unsigned int src,
532 unsigned int dst_size)
536 for (i = 0; i < dst_size; i++) {
537 *dst = src & 0x7F; /* Mask high bit of LSB */
538 src = src >> 7; /* Rotate Right 7 bits */
539 /* Note: we leave the upper bits in place */
547 demunge_int32 (unsigned char* src, int src_size)
553 for (i = src_size - 1; i >= 0; i--) {
554 outval=(outval<<7)+src[i];
562 munge_buf (unsigned char *src, unsigned char *dst, unsigned int dst_size)
566 unsigned int last = dst_size / 2;
568 for (i = 0; i < last; i++) {
569 *dst++ = src[i] & 0x7f;
570 *dst++ = src[i] >> 7;
577 demunge_buf (unsigned char *src, unsigned char *dst, unsigned int src_bytes)
581 unsigned char *end = src + src_bytes;
583 end = src + src_bytes;
585 /* NOTE: src and dst *CAN* point to the same address */
587 for (i = 0; src != end; i++) {
589 dst[i] |= (*src++)<<7;
595 /***********************************************************************
596 WaveFront: sample, patch and program management.
597 ***********************************************************************/
600 wavefront_delete_sample (snd_wavefront_t *dev, int sample_num)
603 unsigned char wbuf[2];
606 wbuf[0] = sample_num & 0x7f;
607 wbuf[1] = sample_num >> 7;
609 if ((x = snd_wavefront_cmd (dev, WFC_DELETE_SAMPLE, NULL, wbuf)) == 0) {
610 dev->sample_status[sample_num] = WF_ST_EMPTY;
617 wavefront_get_sample_status (snd_wavefront_t *dev, int assume_rom)
621 unsigned char rbuf[32], wbuf[32];
622 unsigned int sc_real, sc_alias, sc_multi;
624 /* check sample status */
626 if (snd_wavefront_cmd (dev, WFC_GET_NSAMPLES, rbuf, wbuf)) {
627 snd_printk ("cannot request sample count.\n");
631 sc_real = sc_alias = sc_multi = dev->samples_used = 0;
633 for (i = 0; i < WF_MAX_SAMPLE; i++) {
638 if (snd_wavefront_cmd (dev, WFC_IDENTIFY_SAMPLE_TYPE, rbuf, wbuf)) {
639 snd_printk(KERN_WARNING "cannot identify sample "
640 "type of slot %d\n", i);
641 dev->sample_status[i] = WF_ST_EMPTY;
645 dev->sample_status[i] = (WF_SLOT_FILLED|rbuf[0]);
648 dev->sample_status[i] |= WF_SLOT_ROM;
651 switch (rbuf[0] & WF_ST_MASK) {
655 case WF_ST_MULTISAMPLE:
665 snd_printk ("unknown sample type for "
670 if (rbuf[0] != WF_ST_EMPTY) {
675 snd_printk ("%d samples used (%d real, %d aliases, %d multi), "
676 "%d empty\n", dev->samples_used, sc_real, sc_alias, sc_multi,
677 WF_MAX_SAMPLE - dev->samples_used);
685 wavefront_get_patch_status (snd_wavefront_t *dev)
688 unsigned char patchbuf[WF_PATCH_BYTES];
689 unsigned char patchnum[2];
693 for (i = 0; i < WF_MAX_PATCH; i++) {
694 patchnum[0] = i & 0x7f;
695 patchnum[1] = i >> 7;
697 if ((x = snd_wavefront_cmd (dev, WFC_UPLOAD_PATCH, patchbuf,
700 dev->patch_status[i] |= WF_SLOT_FILLED;
701 p = (wavefront_patch *) patchbuf;
703 [p->sample_number|(p->sample_msb<<7)] |=
706 } else if (x == 3) { /* Bad patch number */
707 dev->patch_status[i] = 0;
709 snd_printk ("upload patch "
711 dev->patch_status[i] = 0;
716 /* program status has already filled in slot_used bits */
718 for (i = 0, cnt = 0, cnt2 = 0; i < WF_MAX_PATCH; i++) {
719 if (dev->patch_status[i] & WF_SLOT_FILLED) {
722 if (dev->patch_status[i] & WF_SLOT_USED) {
727 snd_printk ("%d patch slots filled, %d in use\n", cnt, cnt2);
733 wavefront_get_program_status (snd_wavefront_t *dev)
736 unsigned char progbuf[WF_PROGRAM_BYTES];
737 wavefront_program prog;
738 unsigned char prognum;
741 for (i = 0; i < WF_MAX_PROGRAM; i++) {
744 if ((x = snd_wavefront_cmd (dev, WFC_UPLOAD_PROGRAM, progbuf,
747 dev->prog_status[i] |= WF_SLOT_USED;
749 demunge_buf (progbuf, (unsigned char *) &prog,
752 for (l = 0; l < WF_NUM_LAYERS; l++) {
753 if (prog.layer[l].mute) {
755 [prog.layer[l].patch_number] |=
759 } else if (x == 1) { /* Bad program number */
760 dev->prog_status[i] = 0;
762 snd_printk ("upload program "
764 dev->prog_status[i] = 0;
768 for (i = 0, cnt = 0; i < WF_MAX_PROGRAM; i++) {
769 if (dev->prog_status[i]) {
774 snd_printk ("%d programs slots in use\n", cnt);
780 wavefront_send_patch (snd_wavefront_t *dev, wavefront_patch_info *header)
783 unsigned char buf[WF_PATCH_BYTES+2];
786 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading patch %d\n",
789 if (header->number >= ARRAY_SIZE(dev->patch_status))
792 dev->patch_status[header->number] |= WF_SLOT_FILLED;
795 bptr = munge_int32 (header->number, buf, 2);
796 munge_buf ((unsigned char *)&header->hdr.p, bptr, WF_PATCH_BYTES);
798 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_PATCH, NULL, buf)) {
799 snd_printk ("download patch failed\n");
807 wavefront_send_program (snd_wavefront_t *dev, wavefront_patch_info *header)
810 unsigned char buf[WF_PROGRAM_BYTES+1];
813 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading program %d\n",
816 if (header->number >= ARRAY_SIZE(dev->prog_status))
819 dev->prog_status[header->number] = WF_SLOT_USED;
821 /* XXX need to zero existing SLOT_USED bit for program_status[i]
822 where `i' is the program that's being (potentially) overwritten.
825 for (i = 0; i < WF_NUM_LAYERS; i++) {
826 if (header->hdr.pr.layer[i].mute) {
827 dev->patch_status[header->hdr.pr.layer[i].patch_number] |=
830 /* XXX need to mark SLOT_USED for sample used by
831 patch_number, but this means we have to load it. Ick.
836 buf[0] = header->number;
837 munge_buf ((unsigned char *)&header->hdr.pr, &buf[1], WF_PROGRAM_BYTES);
839 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_PROGRAM, NULL, buf)) {
840 snd_printk ("download patch failed\n");
848 wavefront_freemem (snd_wavefront_t *dev)
853 if (snd_wavefront_cmd (dev, WFC_REPORT_FREE_MEMORY, rbuf, NULL)) {
854 snd_printk ("can't get memory stats.\n");
857 return demunge_int32 (rbuf, 4);
862 wavefront_send_sample (snd_wavefront_t *dev,
863 wavefront_patch_info *header,
865 int data_is_unsigned)
868 /* samples are downloaded via a 16-bit wide i/o port
869 (you could think of it as 2 adjacent 8-bit wide ports
870 but its less efficient that way). therefore, all
871 the blocksizes and so forth listed in the documentation,
872 and used conventionally to refer to sample sizes,
873 which are given in 8-bit units (bytes), need to be
877 u16 sample_short = 0;
879 u16 __user *data_end = NULL;
881 const unsigned int max_blksize = 4096/2;
882 unsigned int written;
883 unsigned int blocksize;
886 unsigned char sample_hdr[WF_SAMPLE_HDR_BYTES];
887 unsigned char *shptr;
889 int initial_skip = 0;
891 DPRINT (WF_DEBUG_LOAD_PATCH, "sample %sdownload for slot %d, "
892 "type %d, %d bytes from 0x%lx\n",
893 header->size ? "" : "header ",
894 header->number, header->subkey,
896 (unsigned long) header->dataptr);
898 if (header->number == WAVEFRONT_FIND_FREE_SAMPLE_SLOT) {
901 if ((x = wavefront_find_free_sample (dev)) < 0) {
904 snd_printk ("unspecified sample => %d\n", x);
908 if (header->number >= WF_MAX_SAMPLE)
913 /* XXX it's a debatable point whether or not RDONLY semantics
914 on the ROM samples should cover just the sample data or
915 the sample header. For now, it only covers the sample data,
916 so anyone is free at all times to rewrite sample headers.
918 My reason for this is that we have the sample headers
919 available in the WFB file for General MIDI, and so these
920 can always be reset if needed. The sample data, however,
921 cannot be recovered without a complete reset and firmware
922 reload of the ICS2115, which is a very expensive operation.
924 So, doing things this way allows us to honor the notion of
925 "RESETSAMPLES" reasonably cheaply. Note however, that this
926 is done purely at user level: there is no WFB parser in
927 this driver, and so a complete reset (back to General MIDI,
928 or theoretically some other configuration) is the
929 responsibility of the user level library.
931 To try to do this in the kernel would be a little
932 crazy: we'd need 158K of kernel space just to hold
933 a copy of the patch/program/sample header data.
936 if (dev->rom_samples_rdonly) {
937 if (dev->sample_status[header->number] & WF_SLOT_ROM) {
938 snd_printk ("sample slot %d "
945 wavefront_delete_sample (dev, header->number);
949 dev->freemem = wavefront_freemem (dev);
951 if (dev->freemem < (int)header->size) {
952 snd_printk ("insufficient memory to "
953 "load %d byte sample.\n",
960 skip = WF_GET_CHANNEL(&header->hdr.s);
962 if (skip > 0 && header->hdr.s.SampleResolution != LINEAR_16BIT) {
963 snd_printk ("channel selection only "
964 "possible on 16-bit samples");
999 DPRINT (WF_DEBUG_LOAD_PATCH, "channel selection: %d => "
1000 "initial skip = %d, skip = %d\n",
1001 WF_GET_CHANNEL (&header->hdr.s),
1002 initial_skip, skip);
1004 /* Be safe, and zero the "Unused" bits ... */
1006 WF_SET_CHANNEL(&header->hdr.s, 0);
1008 /* adjust size for 16 bit samples by dividing by two. We always
1009 send 16 bits per write, even for 8 bit samples, so the length
1010 is always half the size of the sample data in bytes.
1013 length = header->size / 2;
1015 /* the data we're sent has not been munged, and in fact, the
1016 header we have to send isn't just a munged copy either.
1017 so, build the sample header right here.
1020 shptr = &sample_hdr[0];
1022 shptr = munge_int32 (header->number, shptr, 2);
1025 shptr = munge_int32 (length, shptr, 4);
1028 /* Yes, a 4 byte result doesn't contain all of the offset bits,
1029 but the offset only uses 24 bits.
1032 shptr = munge_int32 (*((u32 *) &header->hdr.s.sampleStartOffset),
1034 shptr = munge_int32 (*((u32 *) &header->hdr.s.loopStartOffset),
1036 shptr = munge_int32 (*((u32 *) &header->hdr.s.loopEndOffset),
1038 shptr = munge_int32 (*((u32 *) &header->hdr.s.sampleEndOffset),
1041 /* This one is truly weird. What kind of weirdo decided that in
1042 a system dominated by 16 and 32 bit integers, they would use
1046 shptr = munge_int32 (header->hdr.s.FrequencyBias, shptr, 3);
1048 /* Why is this nybblified, when the MSB is *always* zero ?
1049 Anyway, we can't take address of bitfield, so make a
1050 good-faith guess at where it starts.
1053 shptr = munge_int32 (*(&header->hdr.s.FrequencyBias+1),
1056 if (snd_wavefront_cmd (dev,
1058 WFC_DOWNLOAD_SAMPLE : WFC_DOWNLOAD_SAMPLE_HEADER,
1059 NULL, sample_hdr)) {
1060 snd_printk ("sample %sdownload refused.\n",
1061 header->size ? "" : "header ");
1065 if (header->size == 0) {
1066 goto sent; /* Sorry. Just had to have one somewhere */
1069 data_end = dataptr + length;
1071 /* Do any initial skip over an unused channel's data */
1073 dataptr += initial_skip;
1075 for (written = 0, blocknum = 0;
1076 written < length; written += max_blksize, blocknum++) {
1078 if ((length - written) > max_blksize) {
1079 blocksize = max_blksize;
1081 /* round to nearest 16-byte value */
1082 blocksize = ALIGN(length - written, 8);
1085 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_BLOCK, NULL, NULL)) {
1086 snd_printk ("download block "
1087 "request refused.\n");
1091 for (i = 0; i < blocksize; i++) {
1093 if (dataptr < data_end) {
1095 if (get_user(sample_short, dataptr))
1099 if (data_is_unsigned) { /* GUS ? */
1101 if (WF_SAMPLE_IS_8BIT(&header->hdr.s)) {
1109 &sample_short)[0] += 0x7f;
1111 &sample_short)[1] += 0x7f;
1120 sample_short += 0x7fff;
1126 /* In padding section of final block:
1128 Don't fetch unsupplied data from
1129 user space, just continue with
1130 whatever the final value was.
1134 if (i < blocksize - 1) {
1135 outw (sample_short, dev->block_port);
1137 outw (sample_short, dev->last_block_port);
1141 /* Get "DMA page acknowledge", even though its really
1142 nothing to do with DMA at all.
1145 if ((dma_ack = wavefront_read (dev)) != WF_DMA_ACK) {
1146 if (dma_ack == -1) {
1147 snd_printk ("upload sample "
1148 "DMA ack timeout\n");
1151 snd_printk ("upload sample "
1152 "DMA ack error 0x%x\n",
1159 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_SAMPLE);
1161 /* Note, label is here because sending the sample header shouldn't
1162 alter the sample_status info at all.
1170 wavefront_send_alias (snd_wavefront_t *dev, wavefront_patch_info *header)
1173 unsigned char alias_hdr[WF_ALIAS_BYTES];
1175 DPRINT (WF_DEBUG_LOAD_PATCH, "download alias, %d is "
1178 header->hdr.a.OriginalSample);
1180 if (header->number >= WF_MAX_SAMPLE)
1183 munge_int32 (header->number, &alias_hdr[0], 2);
1184 munge_int32 (header->hdr.a.OriginalSample, &alias_hdr[2], 2);
1185 munge_int32 (*((unsigned int *)&header->hdr.a.sampleStartOffset),
1187 munge_int32 (*((unsigned int *)&header->hdr.a.loopStartOffset),
1189 munge_int32 (*((unsigned int *)&header->hdr.a.loopEndOffset),
1191 munge_int32 (*((unsigned int *)&header->hdr.a.sampleEndOffset),
1193 munge_int32 (header->hdr.a.FrequencyBias, &alias_hdr[20], 3);
1194 munge_int32 (*(&header->hdr.a.FrequencyBias+1), &alias_hdr[23], 2);
1196 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_SAMPLE_ALIAS, NULL, alias_hdr)) {
1197 snd_printk ("download alias failed.\n");
1201 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_ALIAS);
1207 wavefront_send_multisample (snd_wavefront_t *dev, wavefront_patch_info *header)
1211 unsigned char *msample_hdr;
1213 if (header->number >= WF_MAX_SAMPLE)
1216 msample_hdr = kmalloc(WF_MSAMPLE_BYTES, GFP_KERNEL);
1220 munge_int32 (header->number, &msample_hdr[0], 2);
1222 /* You'll recall at this point that the "number of samples" value
1223 in a wavefront_multisample struct is actually the log2 of the
1224 real number of samples.
1227 num_samples = (1<<(header->hdr.ms.NumberOfSamples&7));
1228 msample_hdr[2] = (unsigned char) header->hdr.ms.NumberOfSamples;
1230 DPRINT (WF_DEBUG_LOAD_PATCH, "multi %d with %d=%d samples\n",
1232 header->hdr.ms.NumberOfSamples,
1235 for (i = 0; i < num_samples; i++) {
1236 DPRINT(WF_DEBUG_LOAD_PATCH|WF_DEBUG_DATA, "sample[%d] = %d\n",
1237 i, header->hdr.ms.SampleNumber[i]);
1238 munge_int32 (header->hdr.ms.SampleNumber[i],
1239 &msample_hdr[3+(i*2)], 2);
1242 /* Need a hack here to pass in the number of bytes
1243 to be written to the synth. This is ugly, and perhaps
1244 one day, I'll fix it.
1247 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_MULTISAMPLE,
1248 (unsigned char *) (long) ((num_samples*2)+3),
1250 snd_printk ("download of multisample failed.\n");
1255 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_MULTISAMPLE);
1262 wavefront_fetch_multisample (snd_wavefront_t *dev,
1263 wavefront_patch_info *header)
1266 unsigned char log_ns[1];
1267 unsigned char number[2];
1270 munge_int32 (header->number, number, 2);
1272 if (snd_wavefront_cmd (dev, WFC_UPLOAD_MULTISAMPLE, log_ns, number)) {
1273 snd_printk ("upload multisample failed.\n");
1277 DPRINT (WF_DEBUG_DATA, "msample %d has %d samples\n",
1278 header->number, log_ns[0]);
1280 header->hdr.ms.NumberOfSamples = log_ns[0];
1282 /* get the number of samples ... */
1284 num_samples = (1 << log_ns[0]);
1286 for (i = 0; i < num_samples; i++) {
1290 if ((val = wavefront_read (dev)) == -1) {
1291 snd_printk ("upload multisample failed "
1292 "during sample loop.\n");
1297 if ((val = wavefront_read (dev)) == -1) {
1298 snd_printk ("upload multisample failed "
1299 "during sample loop.\n");
1304 header->hdr.ms.SampleNumber[i] =
1305 demunge_int32 ((unsigned char *) d, 2);
1307 DPRINT (WF_DEBUG_DATA, "msample sample[%d] = %d\n",
1308 i, header->hdr.ms.SampleNumber[i]);
1316 wavefront_send_drum (snd_wavefront_t *dev, wavefront_patch_info *header)
1319 unsigned char drumbuf[WF_DRUM_BYTES];
1320 wavefront_drum *drum = &header->hdr.d;
1323 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading edrum for MIDI "
1324 "note %d, patch = %d\n",
1325 header->number, drum->PatchNumber);
1327 drumbuf[0] = header->number & 0x7f;
1329 for (i = 0; i < 4; i++) {
1330 munge_int32 (((unsigned char *)drum)[i], &drumbuf[1+(i*2)], 2);
1333 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_EDRUM_PROGRAM, NULL, drumbuf)) {
1334 snd_printk ("download drum failed.\n");
1342 wavefront_find_free_sample (snd_wavefront_t *dev)
1347 for (i = 0; i < WF_MAX_SAMPLE; i++) {
1348 if (!(dev->sample_status[i] & WF_SLOT_FILLED)) {
1352 snd_printk ("no free sample slots!\n");
1358 wavefront_find_free_patch (snd_wavefront_t *dev)
1363 for (i = 0; i < WF_MAX_PATCH; i++) {
1364 if (!(dev->patch_status[i] & WF_SLOT_FILLED)) {
1368 snd_printk ("no free patch slots!\n");
1374 wavefront_load_patch (snd_wavefront_t *dev, const char __user *addr)
1376 wavefront_patch_info *header;
1379 header = kmalloc(sizeof(*header), GFP_KERNEL);
1383 if (copy_from_user (header, addr, sizeof(wavefront_patch_info) -
1384 sizeof(wavefront_any))) {
1385 snd_printk ("bad address for load patch.\n");
1390 DPRINT (WF_DEBUG_LOAD_PATCH, "download "
1392 "Sample number: %d "
1393 "Sample size: %d\n",
1398 switch (header->subkey) {
1399 case WF_ST_SAMPLE: /* sample or sample_header, based on patch->size */
1401 if (copy_from_user (&header->hdr.s, header->hdrptr,
1402 sizeof (wavefront_sample))) {
1407 err = wavefront_send_sample (dev, header, header->dataptr, 0);
1410 case WF_ST_MULTISAMPLE:
1412 if (copy_from_user (&header->hdr.s, header->hdrptr,
1413 sizeof (wavefront_multisample))) {
1418 err = wavefront_send_multisample (dev, header);
1423 if (copy_from_user (&header->hdr.a, header->hdrptr,
1424 sizeof (wavefront_alias))) {
1429 err = wavefront_send_alias (dev, header);
1433 if (copy_from_user (&header->hdr.d, header->hdrptr,
1434 sizeof (wavefront_drum))) {
1439 err = wavefront_send_drum (dev, header);
1443 if (copy_from_user (&header->hdr.p, header->hdrptr,
1444 sizeof (wavefront_patch))) {
1449 err = wavefront_send_patch (dev, header);
1453 if (copy_from_user (&header->hdr.pr, header->hdrptr,
1454 sizeof (wavefront_program))) {
1459 err = wavefront_send_program (dev, header);
1463 snd_printk ("unknown patch type %d.\n",
1474 /***********************************************************************
1475 WaveFront: hardware-dependent interface
1476 ***********************************************************************/
1479 process_sample_hdr (u8 *buf)
1487 /* The board doesn't send us an exact copy of a "wavefront_sample"
1488 in response to an Upload Sample Header command. Instead, we
1489 have to convert the data format back into our data structure,
1490 just as in the Download Sample command, where we have to do
1491 something very similar in the reverse direction.
1494 *((u32 *) &s.sampleStartOffset) = demunge_int32 (ptr, 4); ptr += 4;
1495 *((u32 *) &s.loopStartOffset) = demunge_int32 (ptr, 4); ptr += 4;
1496 *((u32 *) &s.loopEndOffset) = demunge_int32 (ptr, 4); ptr += 4;
1497 *((u32 *) &s.sampleEndOffset) = demunge_int32 (ptr, 4); ptr += 4;
1498 *((u32 *) &s.FrequencyBias) = demunge_int32 (ptr, 3); ptr += 3;
1500 s.SampleResolution = *ptr & 0x3;
1501 s.Loop = *ptr & 0x8;
1502 s.Bidirectional = *ptr & 0x10;
1503 s.Reverse = *ptr & 0x40;
1505 /* Now copy it back to where it came from */
1507 memcpy (buf, (unsigned char *) &s, sizeof (wavefront_sample));
1511 wavefront_synth_control (snd_wavefront_card_t *acard,
1512 wavefront_control *wc)
1515 snd_wavefront_t *dev = &acard->wavefront;
1516 unsigned char patchnumbuf[2];
1519 DPRINT (WF_DEBUG_CMD, "synth control with "
1520 "cmd 0x%x\n", wc->cmd);
1522 /* Pre-handling of or for various commands */
1526 case WFC_DISABLE_INTERRUPTS:
1527 snd_printk ("interrupts disabled.\n");
1528 outb (0x80|0x20, dev->control_port);
1529 dev->interrupts_are_midi = 1;
1532 case WFC_ENABLE_INTERRUPTS:
1533 snd_printk ("interrupts enabled.\n");
1534 outb (0x80|0x40|0x20, dev->control_port);
1535 dev->interrupts_are_midi = 1;
1538 case WFC_INTERRUPT_STATUS:
1539 wc->rbuf[0] = dev->interrupts_are_midi;
1542 case WFC_ROMSAMPLES_RDONLY:
1543 dev->rom_samples_rdonly = wc->wbuf[0];
1547 case WFC_IDENTIFY_SLOT_TYPE:
1548 i = wc->wbuf[0] | (wc->wbuf[1] << 7);
1549 if (i <0 || i >= WF_MAX_SAMPLE) {
1550 snd_printk ("invalid slot ID %d\n",
1552 wc->status = EINVAL;
1555 wc->rbuf[0] = dev->sample_status[i];
1559 case WFC_DEBUG_DRIVER:
1560 dev->debug = wc->wbuf[0];
1561 snd_printk ("debug = 0x%x\n", dev->debug);
1564 case WFC_UPLOAD_PATCH:
1565 munge_int32 (*((u32 *) wc->wbuf), patchnumbuf, 2);
1566 memcpy (wc->wbuf, patchnumbuf, 2);
1569 case WFC_UPLOAD_MULTISAMPLE:
1570 /* multisamples have to be handled differently, and
1571 cannot be dealt with properly by snd_wavefront_cmd() alone.
1573 wc->status = wavefront_fetch_multisample
1574 (dev, (wavefront_patch_info *) wc->rbuf);
1577 case WFC_UPLOAD_SAMPLE_ALIAS:
1578 snd_printk ("support for sample alias upload "
1579 "being considered.\n");
1580 wc->status = EINVAL;
1584 wc->status = snd_wavefront_cmd (dev, wc->cmd, wc->rbuf, wc->wbuf);
1586 /* Post-handling of certain commands.
1588 In particular, if the command was an upload, demunge the data
1589 so that the user-level doesn't have to think about it.
1592 if (wc->status == 0) {
1594 /* intercept any freemem requests so that we know
1595 we are always current with the user-level view
1599 case WFC_REPORT_FREE_MEMORY:
1600 dev->freemem = demunge_int32 (wc->rbuf, 4);
1603 case WFC_UPLOAD_PATCH:
1604 demunge_buf (wc->rbuf, wc->rbuf, WF_PATCH_BYTES);
1607 case WFC_UPLOAD_PROGRAM:
1608 demunge_buf (wc->rbuf, wc->rbuf, WF_PROGRAM_BYTES);
1611 case WFC_UPLOAD_EDRUM_PROGRAM:
1612 demunge_buf (wc->rbuf, wc->rbuf, WF_DRUM_BYTES - 1);
1615 case WFC_UPLOAD_SAMPLE_HEADER:
1616 process_sample_hdr (wc->rbuf);
1619 case WFC_UPLOAD_SAMPLE_ALIAS:
1620 snd_printk ("support for "
1621 "sample aliases still "
1622 "being considered.\n");
1626 snd_wavefront_midi_disable_virtual (acard);
1630 snd_wavefront_midi_enable_virtual (acard);
1639 snd_wavefront_synth_open (struct snd_hwdep *hw, struct file *file)
1642 if (!try_module_get(hw->card->module))
1644 file->private_data = hw;
1649 snd_wavefront_synth_release (struct snd_hwdep *hw, struct file *file)
1652 module_put(hw->card->module);
1657 snd_wavefront_synth_ioctl (struct snd_hwdep *hw, struct file *file,
1658 unsigned int cmd, unsigned long arg)
1661 struct snd_card *card;
1662 snd_wavefront_t *dev;
1663 snd_wavefront_card_t *acard;
1664 wavefront_control *wc;
1665 void __user *argp = (void __user *)arg;
1668 card = (struct snd_card *) hw->card;
1670 if (snd_BUG_ON(!card))
1672 if (snd_BUG_ON(!card->private_data))
1675 acard = card->private_data;
1676 dev = &acard->wavefront;
1679 case WFCTL_LOAD_SPP:
1680 if (wavefront_load_patch (dev, argp) != 0) {
1686 wc = memdup_user(argp, sizeof(*wc));
1690 if (wavefront_synth_control (acard, wc) < 0)
1692 else if (copy_to_user (argp, wc, sizeof (*wc)))
1707 /***********************************************************************/
1708 /* WaveFront: interface for card-level wavefront module */
1709 /***********************************************************************/
1712 snd_wavefront_internal_interrupt (snd_wavefront_card_t *card)
1714 snd_wavefront_t *dev = &card->wavefront;
1717 Some comments on interrupts. I attempted a version of this
1718 driver that used interrupts throughout the code instead of
1719 doing busy and/or sleep-waiting. Alas, it appears that once
1720 the Motorola firmware is downloaded, the card *never*
1721 generates an RX interrupt. These are successfully generated
1722 during firmware loading, and after that wavefront_status()
1723 reports that an interrupt is pending on the card from time
1724 to time, but it never seems to be delivered to this
1725 driver. Note also that wavefront_status() continues to
1726 report that RX interrupts are enabled, suggesting that I
1727 didn't goof up and disable them by mistake.
1729 Thus, I stepped back to a prior version of
1730 wavefront_wait(), the only place where this really
1731 matters. Its sad, but I've looked through the code to check
1732 on things, and I really feel certain that the Motorola
1733 firmware prevents RX-ready interrupts.
1736 if ((wavefront_status(dev) & (STAT_INTR_READ|STAT_INTR_WRITE)) == 0) {
1740 spin_lock(&dev->irq_lock);
1743 spin_unlock(&dev->irq_lock);
1744 wake_up(&dev->interrupt_sleeper);
1749 0 Host Rx Interrupt Enable (1=Enabled)
1750 1 Host Rx Register Full (1=Full)
1751 2 Host Rx Interrupt Pending (1=Interrupt)
1753 4 Host Tx Interrupt (1=Enabled)
1754 5 Host Tx Register empty (1=Empty)
1755 6 Host Tx Interrupt Pending (1=Interrupt)
1760 snd_wavefront_interrupt_bits (int irq)
1780 snd_printk ("invalid IRQ %d\n", irq);
1788 wavefront_should_cause_interrupt (snd_wavefront_t *dev,
1789 int val, int port, unsigned long timeout)
1792 wait_queue_entry_t wait;
1794 init_waitqueue_entry(&wait, current);
1795 spin_lock_irq(&dev->irq_lock);
1796 add_wait_queue(&dev->interrupt_sleeper, &wait);
1799 spin_unlock_irq(&dev->irq_lock);
1800 while (!dev->irq_ok && time_before(jiffies, timeout)) {
1801 schedule_timeout_uninterruptible(1);
1807 wavefront_reset_to_cleanliness (snd_wavefront_t *dev)
1813 /* IRQ already checked */
1815 bits = snd_wavefront_interrupt_bits (dev->irq);
1817 /* try reset of port */
1819 outb (0x0, dev->control_port);
1821 /* At this point, the board is in reset, and the H/W initialization
1822 register is accessed at the same address as the data port.
1824 Bit 7 - Enable IRQ Driver
1825 0 - Tri-state the Wave-Board drivers for the PC Bus IRQs
1826 1 - Enable IRQ selected by bits 5:3 to be driven onto the PC Bus.
1828 Bit 6 - MIDI Interface Select
1830 0 - Use the MIDI Input from the 26-pin WaveBlaster
1831 compatible header as the serial MIDI source
1832 1 - Use the MIDI Input from the 9-pin D connector as the
1835 Bits 5:3 - IRQ Selection
1846 Bit 0 - Disable Boot ROM
1847 0 - memory accesses to 03FC30-03FFFFH utilize the internal Boot ROM
1848 1 - memory accesses to 03FC30-03FFFFH are directed to external
1853 /* configure hardware: IRQ, enable interrupts,
1854 plus external 9-pin MIDI interface selected
1857 outb (0x80 | 0x40 | bits, dev->data_port);
1861 0 Host Rx Interrupt Enable (1=Enabled) 0x1
1865 4 Host Tx Interrupt Enable 0x10
1866 5 Mute (0=Mute; 1=Play) 0x20
1867 6 Master Interrupt Enable (1=Enabled) 0x40
1868 7 Master Reset (0=Reset; 1=Run) 0x80
1870 Take us out of reset, mute output, master + TX + RX interrupts on.
1872 We'll get an interrupt presumably to tell us that the TX
1876 wavefront_should_cause_interrupt(dev, 0x80|0x40|0x10|0x1,
1878 (reset_time*HZ)/100);
1880 /* Note: data port is now the data port, not the h/w initialization
1885 snd_printk ("intr not received after h/w un-reset.\n");
1889 /* Note: data port is now the data port, not the h/w initialization
1892 At this point, only "HW VERSION" or "DOWNLOAD OS" commands
1893 will work. So, issue one of them, and wait for TX
1894 interrupt. This can take a *long* time after a cold boot,
1895 while the ISC ROM does its RAM test. The SDK says up to 4
1896 seconds - with 12MB of RAM on a Tropez+, it takes a lot
1897 longer than that (~16secs). Note that the card understands
1898 the difference between a warm and a cold boot, so
1899 subsequent ISC2115 reboots (say, caused by module
1900 reloading) will get through this much faster.
1902 XXX Interesting question: why is no RX interrupt received first ?
1905 wavefront_should_cause_interrupt(dev, WFC_HARDWARE_VERSION,
1906 dev->data_port, ramcheck_time*HZ);
1909 snd_printk ("post-RAM-check interrupt not received.\n");
1913 if (!wavefront_wait (dev, STAT_CAN_READ)) {
1914 snd_printk ("no response to HW version cmd.\n");
1918 if ((hwv[0] = wavefront_read (dev)) == -1) {
1919 snd_printk ("board not responding correctly.\n");
1923 if (hwv[0] == 0xFF) { /* NAK */
1925 /* Board's RAM test failed. Try to read error code,
1926 and tell us about it either way.
1929 if ((hwv[0] = wavefront_read (dev)) == -1) {
1930 snd_printk ("on-board RAM test failed "
1931 "(bad error code).\n");
1933 snd_printk ("on-board RAM test failed "
1934 "(error code: 0x%x).\n",
1940 /* We're OK, just get the next byte of the HW version response */
1942 if ((hwv[1] = wavefront_read (dev)) == -1) {
1943 snd_printk ("incorrect h/w response.\n");
1947 snd_printk ("hardware version %d.%d\n",
1958 wavefront_download_firmware (snd_wavefront_t *dev, char *path)
1961 const unsigned char *buf;
1963 int section_cnt_downloaded = 0;
1964 const struct firmware *firmware;
1966 err = reject_firmware(&firmware, path, dev->card->dev);
1968 snd_printk(KERN_ERR "firmware (%s) download failed!!!\n", path);
1973 buf = firmware->data;
1975 int section_length = *(signed char *)buf;
1976 if (section_length == 0)
1978 if (section_length < 0 || section_length > WF_SECTION_MAX) {
1980 "invalid firmware section length %d\n",
1987 if (firmware->size < len + section_length) {
1988 snd_printk(KERN_ERR "firmware section read error.\n");
1993 if (wavefront_write(dev, WFC_DOWNLOAD_OS))
1996 for (; section_length; section_length--) {
1997 if (wavefront_write(dev, *buf))
2004 if (!wavefront_wait(dev, STAT_CAN_READ)) {
2005 snd_printk(KERN_ERR "time out for firmware ACK.\n");
2008 err = inb(dev->data_port);
2009 if (err != WF_ACK) {
2011 "download of section #%d not "
2012 "acknowledged, ack = 0x%x\n",
2013 section_cnt_downloaded + 1, err);
2017 section_cnt_downloaded++;
2020 release_firmware(firmware);
2024 release_firmware(firmware);
2025 snd_printk(KERN_ERR "firmware download failed!!!\n");
2031 wavefront_do_reset (snd_wavefront_t *dev)
2036 if (wavefront_reset_to_cleanliness (dev)) {
2037 snd_printk ("hw reset failed.\n");
2042 if (wavefront_download_firmware (dev, ospath)) {
2048 /* Wait for the OS to get running. The protocol for
2049 this is non-obvious, and was determined by
2050 using port-IO tracing in DOSemu and some
2051 experimentation here.
2053 Rather than using timed waits, use interrupts creatively.
2056 wavefront_should_cause_interrupt (dev, WFC_NOOP,
2061 snd_printk ("no post-OS interrupt.\n");
2065 /* Now, do it again ! */
2067 wavefront_should_cause_interrupt (dev, WFC_NOOP,
2068 dev->data_port, (10*HZ));
2071 snd_printk ("no post-OS interrupt(2).\n");
2075 /* OK, no (RX/TX) interrupts any more, but leave mute
2079 outb (0x80|0x40, dev->control_port);
2082 /* SETUPSND.EXE asks for sample memory config here, but since i
2083 have no idea how to interpret the result, we'll forget
2087 if ((dev->freemem = wavefront_freemem (dev)) < 0) {
2091 snd_printk ("available DRAM %dk\n", dev->freemem / 1024);
2093 if (wavefront_write (dev, 0xf0) ||
2094 wavefront_write (dev, 1) ||
2095 (wavefront_read (dev) < 0)) {
2097 snd_printk ("MPU emulation mode not set.\n");
2103 if (snd_wavefront_cmd (dev, WFC_SET_NVOICES, NULL, voices)) {
2104 snd_printk ("cannot set number of voices to 32.\n");
2112 /* reset that sucker so that it doesn't bother us. */
2114 outb (0x0, dev->control_port);
2115 dev->interrupts_are_midi = 0;
2120 snd_wavefront_start (snd_wavefront_t *dev)
2123 int samples_are_from_rom;
2125 /* IMPORTANT: assumes that snd_wavefront_detect() and/or
2126 wavefront_reset_to_cleanliness() has already been called
2130 samples_are_from_rom = 1;
2132 /* XXX is this always true ? */
2133 samples_are_from_rom = 0;
2136 if (dev->israw || fx_raw) {
2137 if (wavefront_do_reset (dev)) {
2141 /* Check for FX device, present only on Tropez+ */
2143 dev->has_fx = (snd_wavefront_fx_detect (dev) == 0);
2145 if (dev->has_fx && fx_raw) {
2146 snd_wavefront_fx_start (dev);
2149 wavefront_get_sample_status (dev, samples_are_from_rom);
2150 wavefront_get_program_status (dev);
2151 wavefront_get_patch_status (dev);
2153 /* Start normal operation: unreset, master interrupt enabled, no mute
2156 outb (0x80|0x40|0x20, dev->control_port);
2162 snd_wavefront_detect (snd_wavefront_card_t *card)
2165 unsigned char rbuf[4], wbuf[4];
2166 snd_wavefront_t *dev = &card->wavefront;
2168 /* returns zero if a WaveFront card is successfully detected.
2174 dev->debug = debug_default;
2175 dev->interrupts_are_midi = 0;
2177 dev->rom_samples_rdonly = 1;
2179 if (snd_wavefront_cmd (dev, WFC_FIRMWARE_VERSION, rbuf, wbuf) == 0) {
2181 dev->fw_version[0] = rbuf[0];
2182 dev->fw_version[1] = rbuf[1];
2184 snd_printk ("firmware %d.%d already loaded.\n",
2187 /* check that a command actually works */
2189 if (snd_wavefront_cmd (dev, WFC_HARDWARE_VERSION,
2191 dev->hw_version[0] = rbuf[0];
2192 dev->hw_version[1] = rbuf[1];
2194 snd_printk ("not raw, but no "
2195 "hardware version!\n");
2202 snd_printk ("reloading firmware as you requested.\n");
2209 snd_printk ("no response to firmware probe, assume raw.\n");