1 // SPDX-License-Identifier: GPL-2.0-only
2 /* Copyright (C) by Paul Barton-Davis 1998-1999
4 * Some portions of this file are taken from work that is
5 * copyright (C) by Hannu Savolainen 1993-1996
9 * An ALSA lowlevel driver for Turtle Beach ICS2115 wavetable synth
10 * (Maui, Tropez, Tropez Plus)
12 * This driver supports the onboard wavetable synthesizer (an ICS2115),
13 * including patch, sample and program loading and unloading, conversion
14 * of GUS patches during loading, and full user-level access to all
15 * WaveFront commands. It tries to provide semi-intelligent patch and
16 * sample management as well.
21 #include <linux/interrupt.h>
22 #include <linux/init.h>
23 #include <linux/delay.h>
24 #include <linux/time.h>
25 #include <linux/wait.h>
26 #include <linux/sched/signal.h>
27 #include <linux/firmware.h>
28 #include <linux/moduleparam.h>
29 #include <linux/slab.h>
30 #include <linux/module.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 #define DEFAULT_OSPATH "/*(DEBLOBBED)*/"
57 static char *ospath = DEFAULT_OSPATH; /* the firmware file name */
59 static int wait_usecs = 150; /* This magic number seems to give pretty optimal
60 throughput based on my limited experimentation.
61 If you want to play around with it and find a better
62 value, be my guest. Remember, the idea is to
63 get a number that causes us to just busy wait
64 for as many WaveFront commands as possible, without
65 coming up with a number so large that we hog the
68 Specifically, with this number, out of about 134,000
69 status waits, only about 250 result in a sleep.
72 static int sleep_interval = 100; /* HZ/sleep_interval seconds per sleep */
73 static int sleep_tries = 50; /* number of times we'll try to sleep */
75 static int reset_time = 2; /* hundreths of a second we wait after a HW
76 reset for the expected interrupt.
79 static int ramcheck_time = 20; /* time in seconds to wait while ROM code
83 static int osrun_time = 10; /* time in seconds we wait for the OS to
86 module_param(wf_raw, int, 0444);
87 MODULE_PARM_DESC(wf_raw, "if non-zero, assume that we need to boot the OS");
88 module_param(fx_raw, int, 0444);
89 MODULE_PARM_DESC(fx_raw, "if non-zero, assume that the FX process needs help");
90 module_param(debug_default, int, 0444);
91 MODULE_PARM_DESC(debug_default, "debug parameters for card initialization");
92 module_param(wait_usecs, int, 0444);
93 MODULE_PARM_DESC(wait_usecs, "how long to wait without sleeping, usecs");
94 module_param(sleep_interval, int, 0444);
95 MODULE_PARM_DESC(sleep_interval, "how long to sleep when waiting for reply");
96 module_param(sleep_tries, int, 0444);
97 MODULE_PARM_DESC(sleep_tries, "how many times to try sleeping during a wait");
98 module_param(ospath, charp, 0444);
99 MODULE_PARM_DESC(ospath, "pathname to processed ICS2115 OS firmware");
100 module_param(reset_time, int, 0444);
101 MODULE_PARM_DESC(reset_time, "how long to wait for a reset to take effect");
102 module_param(ramcheck_time, int, 0444);
103 MODULE_PARM_DESC(ramcheck_time, "how many seconds to wait for the RAM test");
104 module_param(osrun_time, int, 0444);
105 MODULE_PARM_DESC(osrun_time, "how many seconds to wait for the ICS2115 OS");
107 /* if WF_DEBUG not defined, no run-time debugging messages will
108 be available via the debug flag setting. Given the current
109 beta state of the driver, this will remain set until a future
117 #define DPRINT(cond, ...) \
118 if ((dev->debug & (cond)) == (cond)) { \
119 snd_printk (__VA_ARGS__); \
122 #define DPRINT(cond, args...)
123 #endif /* WF_DEBUG */
125 #define LOGNAME "WaveFront: "
127 /* bitmasks for WaveFront status port value */
129 #define STAT_RINTR_ENABLED 0x01
130 #define STAT_CAN_READ 0x02
131 #define STAT_INTR_READ 0x04
132 #define STAT_WINTR_ENABLED 0x10
133 #define STAT_CAN_WRITE 0x20
134 #define STAT_INTR_WRITE 0x40
136 static int wavefront_delete_sample (snd_wavefront_t *, int sampnum);
137 static int wavefront_find_free_sample (snd_wavefront_t *);
139 struct wavefront_command {
142 unsigned int read_cnt;
143 unsigned int write_cnt;
150 } wavefront_errors[] = {
151 { 0x01, "Bad sample number" },
152 { 0x02, "Out of sample memory" },
153 { 0x03, "Bad patch number" },
154 { 0x04, "Error in number of voices" },
155 { 0x06, "Sample load already in progress" },
156 { 0x0B, "No sample load request pending" },
157 { 0x0E, "Bad MIDI channel number" },
158 { 0x10, "Download Record Error" },
165 static struct wavefront_command wavefront_commands[] = {
166 { WFC_SET_SYNTHVOL, "set synthesizer volume", 0, 1, NEEDS_ACK },
167 { WFC_GET_SYNTHVOL, "get synthesizer volume", 1, 0, 0},
168 { WFC_SET_NVOICES, "set number of voices", 0, 1, NEEDS_ACK },
169 { WFC_GET_NVOICES, "get number of voices", 1, 0, 0 },
170 { WFC_SET_TUNING, "set synthesizer tuning", 0, 2, NEEDS_ACK },
171 { WFC_GET_TUNING, "get synthesizer tuning", 2, 0, 0 },
172 { WFC_DISABLE_CHANNEL, "disable synth channel", 0, 1, NEEDS_ACK },
173 { WFC_ENABLE_CHANNEL, "enable synth channel", 0, 1, NEEDS_ACK },
174 { WFC_GET_CHANNEL_STATUS, "get synth channel status", 3, 0, 0 },
175 { WFC_MISYNTH_OFF, "disable midi-in to synth", 0, 0, NEEDS_ACK },
176 { WFC_MISYNTH_ON, "enable midi-in to synth", 0, 0, NEEDS_ACK },
177 { WFC_VMIDI_ON, "enable virtual midi mode", 0, 0, NEEDS_ACK },
178 { WFC_VMIDI_OFF, "disable virtual midi mode", 0, 0, NEEDS_ACK },
179 { WFC_MIDI_STATUS, "report midi status", 1, 0, 0 },
180 { WFC_FIRMWARE_VERSION, "report firmware version", 2, 0, 0 },
181 { WFC_HARDWARE_VERSION, "report hardware version", 2, 0, 0 },
182 { WFC_GET_NSAMPLES, "report number of samples", 2, 0, 0 },
183 { WFC_INSTOUT_LEVELS, "report instantaneous output levels", 7, 0, 0 },
184 { WFC_PEAKOUT_LEVELS, "report peak output levels", 7, 0, 0 },
185 { WFC_DOWNLOAD_SAMPLE, "download sample",
186 0, WF_SAMPLE_BYTES, NEEDS_ACK },
187 { WFC_DOWNLOAD_BLOCK, "download block", 0, 0, NEEDS_ACK},
188 { WFC_DOWNLOAD_SAMPLE_HEADER, "download sample header",
189 0, WF_SAMPLE_HDR_BYTES, NEEDS_ACK },
190 { WFC_UPLOAD_SAMPLE_HEADER, "upload sample header", 13, 2, 0 },
192 /* This command requires a variable number of bytes to be written.
193 There is a hack in snd_wavefront_cmd() to support this. The actual
194 count is passed in as the read buffer ptr, cast appropriately.
198 { WFC_DOWNLOAD_MULTISAMPLE, "download multisample", 0, 0, NEEDS_ACK },
200 /* This one is a hack as well. We just read the first byte of the
201 response, don't fetch an ACK, and leave the rest to the
202 calling function. Ugly, ugly, ugly.
205 { WFC_UPLOAD_MULTISAMPLE, "upload multisample", 2, 1, 0 },
206 { WFC_DOWNLOAD_SAMPLE_ALIAS, "download sample alias",
207 0, WF_ALIAS_BYTES, NEEDS_ACK },
208 { WFC_UPLOAD_SAMPLE_ALIAS, "upload sample alias", WF_ALIAS_BYTES, 2, 0},
209 { WFC_DELETE_SAMPLE, "delete sample", 0, 2, NEEDS_ACK },
210 { WFC_IDENTIFY_SAMPLE_TYPE, "identify sample type", 5, 2, 0 },
211 { WFC_UPLOAD_SAMPLE_PARAMS, "upload sample parameters" },
212 { WFC_REPORT_FREE_MEMORY, "report free memory", 4, 0, 0 },
213 { WFC_DOWNLOAD_PATCH, "download patch", 0, 134, NEEDS_ACK },
214 { WFC_UPLOAD_PATCH, "upload patch", 132, 2, 0 },
215 { WFC_DOWNLOAD_PROGRAM, "download program", 0, 33, NEEDS_ACK },
216 { WFC_UPLOAD_PROGRAM, "upload program", 32, 1, 0 },
217 { WFC_DOWNLOAD_EDRUM_PROGRAM, "download enhanced drum program", 0, 9,
219 { WFC_UPLOAD_EDRUM_PROGRAM, "upload enhanced drum program", 8, 1, 0},
220 { WFC_SET_EDRUM_CHANNEL, "set enhanced drum program channel",
222 { WFC_DISABLE_DRUM_PROGRAM, "disable drum program", 0, 1, NEEDS_ACK },
223 { WFC_REPORT_CHANNEL_PROGRAMS, "report channel program numbers",
225 { WFC_NOOP, "the no-op command", 0, 0, NEEDS_ACK },
230 wavefront_errorstr (int errnum)
235 for (i = 0; wavefront_errors[i].errstr; i++) {
236 if (wavefront_errors[i].errno == errnum) {
237 return wavefront_errors[i].errstr;
241 return "Unknown WaveFront error";
244 static struct wavefront_command *
245 wavefront_get_command (int cmd)
250 for (i = 0; wavefront_commands[i].cmd != 0; i++) {
251 if (cmd == wavefront_commands[i].cmd) {
252 return &wavefront_commands[i];
260 wavefront_status (snd_wavefront_t *dev)
263 return inb (dev->status_port);
267 wavefront_sleep (int limit)
270 schedule_timeout_interruptible(limit);
272 return signal_pending(current);
276 wavefront_wait (snd_wavefront_t *dev, int mask)
281 /* Spin for a short period of time, because >99% of all
282 requests to the WaveFront can be serviced inline like this.
285 for (i = 0; i < wait_usecs; i += 5) {
286 if (wavefront_status (dev) & mask) {
292 for (i = 0; i < sleep_tries; i++) {
294 if (wavefront_status (dev) & mask) {
298 if (wavefront_sleep (HZ/sleep_interval)) {
307 wavefront_read (snd_wavefront_t *dev)
310 if (wavefront_wait (dev, STAT_CAN_READ))
311 return inb (dev->data_port);
313 DPRINT (WF_DEBUG_DATA, "read timeout.\n");
319 wavefront_write (snd_wavefront_t *dev, unsigned char data)
322 if (wavefront_wait (dev, STAT_CAN_WRITE)) {
323 outb (data, dev->data_port);
327 DPRINT (WF_DEBUG_DATA, "write timeout.\n");
333 snd_wavefront_cmd (snd_wavefront_t *dev,
334 int cmd, unsigned char *rbuf, unsigned char *wbuf)
340 struct wavefront_command *wfcmd;
342 if ((wfcmd = wavefront_get_command (cmd)) == NULL) {
343 snd_printk ("command 0x%x not supported.\n",
348 /* Hack to handle the one variable-size write command. See
349 wavefront_send_multisample() for the other half of this
350 gross and ugly strategy.
353 if (cmd == WFC_DOWNLOAD_MULTISAMPLE) {
354 wfcmd->write_cnt = (unsigned long) rbuf;
358 DPRINT (WF_DEBUG_CMD, "0x%x [%s] (%d,%d,%d)\n",
359 cmd, wfcmd->action, wfcmd->read_cnt,
360 wfcmd->write_cnt, wfcmd->need_ack);
362 if (wavefront_write (dev, cmd)) {
363 DPRINT ((WF_DEBUG_IO|WF_DEBUG_CMD), "cannot request "
369 if (wfcmd->write_cnt > 0) {
370 DPRINT (WF_DEBUG_DATA, "writing %d bytes "
372 wfcmd->write_cnt, cmd);
374 for (i = 0; i < wfcmd->write_cnt; i++) {
375 if (wavefront_write (dev, wbuf[i])) {
376 DPRINT (WF_DEBUG_IO, "bad write for byte "
377 "%d of 0x%x [%s].\n",
378 i, cmd, wfcmd->action);
382 DPRINT (WF_DEBUG_DATA, "write[%d] = 0x%x\n",
387 if (wfcmd->read_cnt > 0) {
388 DPRINT (WF_DEBUG_DATA, "reading %d ints "
390 wfcmd->read_cnt, cmd);
392 for (i = 0; i < wfcmd->read_cnt; i++) {
394 if ((c = wavefront_read (dev)) == -1) {
395 DPRINT (WF_DEBUG_IO, "bad read for byte "
396 "%d of 0x%x [%s].\n",
397 i, cmd, wfcmd->action);
401 /* Now handle errors. Lots of special cases here */
404 if ((c = wavefront_read (dev)) == -1) {
405 DPRINT (WF_DEBUG_IO, "bad read for "
414 /* Can you believe this madness ? */
417 wfcmd->cmd == WFC_IDENTIFY_SAMPLE_TYPE) {
418 rbuf[0] = WF_ST_EMPTY;
422 wfcmd->cmd == WFC_UPLOAD_PATCH) {
427 wfcmd->cmd == WFC_UPLOAD_PROGRAM) {
433 DPRINT (WF_DEBUG_IO, "error %d (%s) "
439 wavefront_errorstr (c),
450 DPRINT (WF_DEBUG_DATA, "read[%d] = 0x%x\n",i, rbuf[i]);
454 if ((wfcmd->read_cnt == 0 && wfcmd->write_cnt == 0) || wfcmd->need_ack) {
456 DPRINT (WF_DEBUG_CMD, "reading ACK for 0x%x\n", cmd);
458 /* Some commands need an ACK, but return zero instead
459 of the standard value.
462 if ((ack = wavefront_read (dev)) == 0) {
468 DPRINT (WF_DEBUG_IO, "cannot read ack for "
474 int err = -1; /* something unknown */
476 if (ack == 0xff) { /* explicit error */
478 if ((err = wavefront_read (dev)) == -1) {
479 DPRINT (WF_DEBUG_DATA,
486 DPRINT (WF_DEBUG_IO, "0x%x [%s] "
487 "failed (0x%x, 0x%x, %s)\n",
488 cmd, wfcmd->action, ack, err,
489 wavefront_errorstr (err));
495 DPRINT (WF_DEBUG_DATA, "ack received "
500 DPRINT (WF_DEBUG_CMD, "0x%x [%s] does not need "
502 cmd, wfcmd->action, wfcmd->read_cnt,
503 wfcmd->write_cnt, wfcmd->need_ack);
510 /***********************************************************************
511 WaveFront data munging
513 Things here are weird. All data written to the board cannot
514 have its most significant bit set. Any data item with values
515 potentially > 0x7F (127) must be split across multiple bytes.
517 Sometimes, we need to munge numeric values that are represented on
518 the x86 side as 8-32 bit values. Sometimes, we need to munge data
519 that is represented on the x86 side as an array of bytes. The most
520 efficient approach to handling both cases seems to be to use 2
521 different functions for munging and 2 for de-munging. This avoids
522 weird casting and worrying about bit-level offsets.
524 **********************************************************************/
526 static unsigned char *
527 munge_int32 (unsigned int src,
529 unsigned int dst_size)
533 for (i = 0; i < dst_size; i++) {
534 *dst = src & 0x7F; /* Mask high bit of LSB */
535 src = src >> 7; /* Rotate Right 7 bits */
536 /* Note: we leave the upper bits in place */
544 demunge_int32 (unsigned char* src, int src_size)
550 for (i = src_size - 1; i >= 0; i--) {
551 outval=(outval<<7)+src[i];
559 munge_buf (unsigned char *src, unsigned char *dst, unsigned int dst_size)
563 unsigned int last = dst_size / 2;
565 for (i = 0; i < last; i++) {
566 *dst++ = src[i] & 0x7f;
567 *dst++ = src[i] >> 7;
574 demunge_buf (unsigned char *src, unsigned char *dst, unsigned int src_bytes)
578 unsigned char *end = src + src_bytes;
580 end = src + src_bytes;
582 /* NOTE: src and dst *CAN* point to the same address */
584 for (i = 0; src != end; i++) {
586 dst[i] |= (*src++)<<7;
592 /***********************************************************************
593 WaveFront: sample, patch and program management.
594 ***********************************************************************/
597 wavefront_delete_sample (snd_wavefront_t *dev, int sample_num)
600 unsigned char wbuf[2];
603 wbuf[0] = sample_num & 0x7f;
604 wbuf[1] = sample_num >> 7;
606 if ((x = snd_wavefront_cmd (dev, WFC_DELETE_SAMPLE, NULL, wbuf)) == 0) {
607 dev->sample_status[sample_num] = WF_ST_EMPTY;
614 wavefront_get_sample_status (snd_wavefront_t *dev, int assume_rom)
618 unsigned char rbuf[32], wbuf[32];
619 unsigned int sc_real, sc_alias, sc_multi;
621 /* check sample status */
623 if (snd_wavefront_cmd (dev, WFC_GET_NSAMPLES, rbuf, wbuf)) {
624 snd_printk ("cannot request sample count.\n");
628 sc_real = sc_alias = sc_multi = dev->samples_used = 0;
630 for (i = 0; i < WF_MAX_SAMPLE; i++) {
635 if (snd_wavefront_cmd (dev, WFC_IDENTIFY_SAMPLE_TYPE, rbuf, wbuf)) {
636 snd_printk(KERN_WARNING "cannot identify sample "
637 "type of slot %d\n", i);
638 dev->sample_status[i] = WF_ST_EMPTY;
642 dev->sample_status[i] = (WF_SLOT_FILLED|rbuf[0]);
645 dev->sample_status[i] |= WF_SLOT_ROM;
648 switch (rbuf[0] & WF_ST_MASK) {
652 case WF_ST_MULTISAMPLE:
662 snd_printk ("unknown sample type for "
667 if (rbuf[0] != WF_ST_EMPTY) {
672 snd_printk ("%d samples used (%d real, %d aliases, %d multi), "
673 "%d empty\n", dev->samples_used, sc_real, sc_alias, sc_multi,
674 WF_MAX_SAMPLE - dev->samples_used);
682 wavefront_get_patch_status (snd_wavefront_t *dev)
685 unsigned char patchbuf[WF_PATCH_BYTES];
686 unsigned char patchnum[2];
690 for (i = 0; i < WF_MAX_PATCH; i++) {
691 patchnum[0] = i & 0x7f;
692 patchnum[1] = i >> 7;
694 if ((x = snd_wavefront_cmd (dev, WFC_UPLOAD_PATCH, patchbuf,
697 dev->patch_status[i] |= WF_SLOT_FILLED;
698 p = (wavefront_patch *) patchbuf;
700 [p->sample_number|(p->sample_msb<<7)] |=
703 } else if (x == 3) { /* Bad patch number */
704 dev->patch_status[i] = 0;
706 snd_printk ("upload patch "
708 dev->patch_status[i] = 0;
713 /* program status has already filled in slot_used bits */
715 for (i = 0, cnt = 0, cnt2 = 0; i < WF_MAX_PATCH; i++) {
716 if (dev->patch_status[i] & WF_SLOT_FILLED) {
719 if (dev->patch_status[i] & WF_SLOT_USED) {
724 snd_printk ("%d patch slots filled, %d in use\n", cnt, cnt2);
730 wavefront_get_program_status (snd_wavefront_t *dev)
733 unsigned char progbuf[WF_PROGRAM_BYTES];
734 wavefront_program prog;
735 unsigned char prognum;
738 for (i = 0; i < WF_MAX_PROGRAM; i++) {
741 if ((x = snd_wavefront_cmd (dev, WFC_UPLOAD_PROGRAM, progbuf,
744 dev->prog_status[i] |= WF_SLOT_USED;
746 demunge_buf (progbuf, (unsigned char *) &prog,
749 for (l = 0; l < WF_NUM_LAYERS; l++) {
750 if (prog.layer[l].mute) {
752 [prog.layer[l].patch_number] |=
756 } else if (x == 1) { /* Bad program number */
757 dev->prog_status[i] = 0;
759 snd_printk ("upload program "
761 dev->prog_status[i] = 0;
765 for (i = 0, cnt = 0; i < WF_MAX_PROGRAM; i++) {
766 if (dev->prog_status[i]) {
771 snd_printk ("%d programs slots in use\n", cnt);
777 wavefront_send_patch (snd_wavefront_t *dev, wavefront_patch_info *header)
780 unsigned char buf[WF_PATCH_BYTES+2];
783 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading patch %d\n",
786 if (header->number >= ARRAY_SIZE(dev->patch_status))
789 dev->patch_status[header->number] |= WF_SLOT_FILLED;
791 bptr = munge_int32 (header->number, buf, 2);
792 munge_buf ((unsigned char *)&header->hdr.p, bptr, WF_PATCH_BYTES);
794 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_PATCH, NULL, buf)) {
795 snd_printk ("download patch failed\n");
803 wavefront_send_program (snd_wavefront_t *dev, wavefront_patch_info *header)
806 unsigned char buf[WF_PROGRAM_BYTES+1];
809 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading program %d\n",
812 if (header->number >= ARRAY_SIZE(dev->prog_status))
815 dev->prog_status[header->number] = WF_SLOT_USED;
817 /* XXX need to zero existing SLOT_USED bit for program_status[i]
818 where `i' is the program that's being (potentially) overwritten.
821 for (i = 0; i < WF_NUM_LAYERS; i++) {
822 if (header->hdr.pr.layer[i].mute) {
823 dev->patch_status[header->hdr.pr.layer[i].patch_number] |=
826 /* XXX need to mark SLOT_USED for sample used by
827 patch_number, but this means we have to load it. Ick.
832 buf[0] = header->number;
833 munge_buf ((unsigned char *)&header->hdr.pr, &buf[1], WF_PROGRAM_BYTES);
835 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_PROGRAM, NULL, buf)) {
836 snd_printk ("download patch failed\n");
844 wavefront_freemem (snd_wavefront_t *dev)
849 if (snd_wavefront_cmd (dev, WFC_REPORT_FREE_MEMORY, rbuf, NULL)) {
850 snd_printk ("can't get memory stats.\n");
853 return demunge_int32 (rbuf, 4);
858 wavefront_send_sample (snd_wavefront_t *dev,
859 wavefront_patch_info *header,
861 int data_is_unsigned)
864 /* samples are downloaded via a 16-bit wide i/o port
865 (you could think of it as 2 adjacent 8-bit wide ports
866 but its less efficient that way). therefore, all
867 the blocksizes and so forth listed in the documentation,
868 and used conventionally to refer to sample sizes,
869 which are given in 8-bit units (bytes), need to be
873 u16 sample_short = 0;
875 u16 __user *data_end = NULL;
877 const unsigned int max_blksize = 4096/2;
878 unsigned int written;
879 unsigned int blocksize;
882 unsigned char sample_hdr[WF_SAMPLE_HDR_BYTES];
883 unsigned char *shptr;
885 int initial_skip = 0;
887 DPRINT (WF_DEBUG_LOAD_PATCH, "sample %sdownload for slot %d, "
888 "type %d, %d bytes from 0x%lx\n",
889 header->size ? "" : "header ",
890 header->number, header->subkey,
892 (unsigned long) header->dataptr);
894 if (header->number == WAVEFRONT_FIND_FREE_SAMPLE_SLOT) {
897 if ((x = wavefront_find_free_sample (dev)) < 0) {
900 snd_printk ("unspecified sample => %d\n", x);
904 if (header->number >= WF_MAX_SAMPLE)
909 /* XXX it's a debatable point whether or not RDONLY semantics
910 on the ROM samples should cover just the sample data or
911 the sample header. For now, it only covers the sample data,
912 so anyone is free at all times to rewrite sample headers.
914 My reason for this is that we have the sample headers
915 available in the WFB file for General MIDI, and so these
916 can always be reset if needed. The sample data, however,
917 cannot be recovered without a complete reset and firmware
918 reload of the ICS2115, which is a very expensive operation.
920 So, doing things this way allows us to honor the notion of
921 "RESETSAMPLES" reasonably cheaply. Note however, that this
922 is done purely at user level: there is no WFB parser in
923 this driver, and so a complete reset (back to General MIDI,
924 or theoretically some other configuration) is the
925 responsibility of the user level library.
927 To try to do this in the kernel would be a little
928 crazy: we'd need 158K of kernel space just to hold
929 a copy of the patch/program/sample header data.
932 if (dev->rom_samples_rdonly) {
933 if (dev->sample_status[header->number] & WF_SLOT_ROM) {
934 snd_printk ("sample slot %d "
941 wavefront_delete_sample (dev, header->number);
945 dev->freemem = wavefront_freemem (dev);
947 if (dev->freemem < (int)header->size) {
948 snd_printk ("insufficient memory to "
949 "load %d byte sample.\n",
956 skip = WF_GET_CHANNEL(&header->hdr.s);
958 if (skip > 0 && header->hdr.s.SampleResolution != LINEAR_16BIT) {
959 snd_printk ("channel selection only "
960 "possible on 16-bit samples");
995 DPRINT (WF_DEBUG_LOAD_PATCH, "channel selection: %d => "
996 "initial skip = %d, skip = %d\n",
997 WF_GET_CHANNEL (&header->hdr.s),
1000 /* Be safe, and zero the "Unused" bits ... */
1002 WF_SET_CHANNEL(&header->hdr.s, 0);
1004 /* adjust size for 16 bit samples by dividing by two. We always
1005 send 16 bits per write, even for 8 bit samples, so the length
1006 is always half the size of the sample data in bytes.
1009 length = header->size / 2;
1011 /* the data we're sent has not been munged, and in fact, the
1012 header we have to send isn't just a munged copy either.
1013 so, build the sample header right here.
1016 shptr = &sample_hdr[0];
1018 shptr = munge_int32 (header->number, shptr, 2);
1021 shptr = munge_int32 (length, shptr, 4);
1024 /* Yes, a 4 byte result doesn't contain all of the offset bits,
1025 but the offset only uses 24 bits.
1028 shptr = munge_int32 (*((u32 *) &header->hdr.s.sampleStartOffset),
1030 shptr = munge_int32 (*((u32 *) &header->hdr.s.loopStartOffset),
1032 shptr = munge_int32 (*((u32 *) &header->hdr.s.loopEndOffset),
1034 shptr = munge_int32 (*((u32 *) &header->hdr.s.sampleEndOffset),
1037 /* This one is truly weird. What kind of weirdo decided that in
1038 a system dominated by 16 and 32 bit integers, they would use
1042 shptr = munge_int32 (header->hdr.s.FrequencyBias, shptr, 3);
1044 /* Why is this nybblified, when the MSB is *always* zero ?
1045 Anyway, we can't take address of bitfield, so make a
1046 good-faith guess at where it starts.
1049 shptr = munge_int32 (*(&header->hdr.s.FrequencyBias+1),
1052 if (snd_wavefront_cmd (dev,
1054 WFC_DOWNLOAD_SAMPLE : WFC_DOWNLOAD_SAMPLE_HEADER,
1055 NULL, sample_hdr)) {
1056 snd_printk ("sample %sdownload refused.\n",
1057 header->size ? "" : "header ");
1061 if (header->size == 0) {
1062 goto sent; /* Sorry. Just had to have one somewhere */
1065 data_end = dataptr + length;
1067 /* Do any initial skip over an unused channel's data */
1069 dataptr += initial_skip;
1071 for (written = 0, blocknum = 0;
1072 written < length; written += max_blksize, blocknum++) {
1074 if ((length - written) > max_blksize) {
1075 blocksize = max_blksize;
1077 /* round to nearest 16-byte value */
1078 blocksize = ALIGN(length - written, 8);
1081 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_BLOCK, NULL, NULL)) {
1082 snd_printk ("download block "
1083 "request refused.\n");
1087 for (i = 0; i < blocksize; i++) {
1089 if (dataptr < data_end) {
1091 if (get_user(sample_short, dataptr))
1095 if (data_is_unsigned) { /* GUS ? */
1097 if (WF_SAMPLE_IS_8BIT(&header->hdr.s)) {
1105 &sample_short)[0] += 0x7f;
1107 &sample_short)[1] += 0x7f;
1116 sample_short += 0x7fff;
1122 /* In padding section of final block:
1124 Don't fetch unsupplied data from
1125 user space, just continue with
1126 whatever the final value was.
1130 if (i < blocksize - 1) {
1131 outw (sample_short, dev->block_port);
1133 outw (sample_short, dev->last_block_port);
1137 /* Get "DMA page acknowledge", even though its really
1138 nothing to do with DMA at all.
1141 if ((dma_ack = wavefront_read (dev)) != WF_DMA_ACK) {
1142 if (dma_ack == -1) {
1143 snd_printk ("upload sample "
1144 "DMA ack timeout\n");
1147 snd_printk ("upload sample "
1148 "DMA ack error 0x%x\n",
1155 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_SAMPLE);
1157 /* Note, label is here because sending the sample header shouldn't
1158 alter the sample_status info at all.
1166 wavefront_send_alias (snd_wavefront_t *dev, wavefront_patch_info *header)
1169 unsigned char alias_hdr[WF_ALIAS_BYTES];
1171 DPRINT (WF_DEBUG_LOAD_PATCH, "download alias, %d is "
1174 header->hdr.a.OriginalSample);
1176 if (header->number >= WF_MAX_SAMPLE)
1179 munge_int32 (header->number, &alias_hdr[0], 2);
1180 munge_int32 (header->hdr.a.OriginalSample, &alias_hdr[2], 2);
1181 munge_int32 (*((unsigned int *)&header->hdr.a.sampleStartOffset),
1183 munge_int32 (*((unsigned int *)&header->hdr.a.loopStartOffset),
1185 munge_int32 (*((unsigned int *)&header->hdr.a.loopEndOffset),
1187 munge_int32 (*((unsigned int *)&header->hdr.a.sampleEndOffset),
1189 munge_int32 (header->hdr.a.FrequencyBias, &alias_hdr[20], 3);
1190 munge_int32 (*(&header->hdr.a.FrequencyBias+1), &alias_hdr[23], 2);
1192 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_SAMPLE_ALIAS, NULL, alias_hdr)) {
1193 snd_printk ("download alias failed.\n");
1197 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_ALIAS);
1203 wavefront_send_multisample (snd_wavefront_t *dev, wavefront_patch_info *header)
1207 unsigned char *msample_hdr;
1209 if (header->number >= WF_MAX_SAMPLE)
1212 msample_hdr = kmalloc(WF_MSAMPLE_BYTES, GFP_KERNEL);
1216 munge_int32 (header->number, &msample_hdr[0], 2);
1218 /* You'll recall at this point that the "number of samples" value
1219 in a wavefront_multisample struct is actually the log2 of the
1220 real number of samples.
1223 num_samples = (1<<(header->hdr.ms.NumberOfSamples&7));
1224 msample_hdr[2] = (unsigned char) header->hdr.ms.NumberOfSamples;
1226 DPRINT (WF_DEBUG_LOAD_PATCH, "multi %d with %d=%d samples\n",
1228 header->hdr.ms.NumberOfSamples,
1231 for (i = 0; i < num_samples; i++) {
1232 DPRINT(WF_DEBUG_LOAD_PATCH|WF_DEBUG_DATA, "sample[%d] = %d\n",
1233 i, header->hdr.ms.SampleNumber[i]);
1234 munge_int32 (header->hdr.ms.SampleNumber[i],
1235 &msample_hdr[3+(i*2)], 2);
1238 /* Need a hack here to pass in the number of bytes
1239 to be written to the synth. This is ugly, and perhaps
1240 one day, I'll fix it.
1243 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_MULTISAMPLE,
1244 (unsigned char *) (long) ((num_samples*2)+3),
1246 snd_printk ("download of multisample failed.\n");
1251 dev->sample_status[header->number] = (WF_SLOT_FILLED|WF_ST_MULTISAMPLE);
1258 wavefront_fetch_multisample (snd_wavefront_t *dev,
1259 wavefront_patch_info *header)
1262 unsigned char log_ns[1];
1263 unsigned char number[2];
1266 munge_int32 (header->number, number, 2);
1268 if (snd_wavefront_cmd (dev, WFC_UPLOAD_MULTISAMPLE, log_ns, number)) {
1269 snd_printk ("upload multisample failed.\n");
1273 DPRINT (WF_DEBUG_DATA, "msample %d has %d samples\n",
1274 header->number, log_ns[0]);
1276 header->hdr.ms.NumberOfSamples = log_ns[0];
1278 /* get the number of samples ... */
1280 num_samples = (1 << log_ns[0]);
1282 for (i = 0; i < num_samples; i++) {
1286 if ((val = wavefront_read (dev)) == -1) {
1287 snd_printk ("upload multisample failed "
1288 "during sample loop.\n");
1293 if ((val = wavefront_read (dev)) == -1) {
1294 snd_printk ("upload multisample failed "
1295 "during sample loop.\n");
1300 header->hdr.ms.SampleNumber[i] =
1301 demunge_int32 ((unsigned char *) d, 2);
1303 DPRINT (WF_DEBUG_DATA, "msample sample[%d] = %d\n",
1304 i, header->hdr.ms.SampleNumber[i]);
1312 wavefront_send_drum (snd_wavefront_t *dev, wavefront_patch_info *header)
1315 unsigned char drumbuf[WF_DRUM_BYTES];
1316 wavefront_drum *drum = &header->hdr.d;
1319 DPRINT (WF_DEBUG_LOAD_PATCH, "downloading edrum for MIDI "
1320 "note %d, patch = %d\n",
1321 header->number, drum->PatchNumber);
1323 drumbuf[0] = header->number & 0x7f;
1325 for (i = 0; i < 4; i++) {
1326 munge_int32 (((unsigned char *)drum)[i], &drumbuf[1+(i*2)], 2);
1329 if (snd_wavefront_cmd (dev, WFC_DOWNLOAD_EDRUM_PROGRAM, NULL, drumbuf)) {
1330 snd_printk ("download drum failed.\n");
1338 wavefront_find_free_sample (snd_wavefront_t *dev)
1343 for (i = 0; i < WF_MAX_SAMPLE; i++) {
1344 if (!(dev->sample_status[i] & WF_SLOT_FILLED)) {
1348 snd_printk ("no free sample slots!\n");
1354 wavefront_find_free_patch (snd_wavefront_t *dev)
1359 for (i = 0; i < WF_MAX_PATCH; i++) {
1360 if (!(dev->patch_status[i] & WF_SLOT_FILLED)) {
1364 snd_printk ("no free patch slots!\n");
1370 wavefront_load_patch (snd_wavefront_t *dev, const char __user *addr)
1372 wavefront_patch_info *header;
1375 header = kmalloc(sizeof(*header), GFP_KERNEL);
1379 if (copy_from_user (header, addr, sizeof(wavefront_patch_info) -
1380 sizeof(wavefront_any))) {
1381 snd_printk ("bad address for load patch.\n");
1386 DPRINT (WF_DEBUG_LOAD_PATCH, "download "
1388 "Sample number: %d "
1389 "Sample size: %d\n",
1394 switch (header->subkey) {
1395 case WF_ST_SAMPLE: /* sample or sample_header, based on patch->size */
1397 if (copy_from_user (&header->hdr.s, header->hdrptr,
1398 sizeof (wavefront_sample))) {
1403 err = wavefront_send_sample (dev, header, header->dataptr, 0);
1406 case WF_ST_MULTISAMPLE:
1408 if (copy_from_user (&header->hdr.s, header->hdrptr,
1409 sizeof (wavefront_multisample))) {
1414 err = wavefront_send_multisample (dev, header);
1419 if (copy_from_user (&header->hdr.a, header->hdrptr,
1420 sizeof (wavefront_alias))) {
1425 err = wavefront_send_alias (dev, header);
1429 if (copy_from_user (&header->hdr.d, header->hdrptr,
1430 sizeof (wavefront_drum))) {
1435 err = wavefront_send_drum (dev, header);
1439 if (copy_from_user (&header->hdr.p, header->hdrptr,
1440 sizeof (wavefront_patch))) {
1445 err = wavefront_send_patch (dev, header);
1449 if (copy_from_user (&header->hdr.pr, header->hdrptr,
1450 sizeof (wavefront_program))) {
1455 err = wavefront_send_program (dev, header);
1459 snd_printk ("unknown patch type %d.\n",
1470 /***********************************************************************
1471 WaveFront: hardware-dependent interface
1472 ***********************************************************************/
1475 process_sample_hdr (u8 *buf)
1483 /* The board doesn't send us an exact copy of a "wavefront_sample"
1484 in response to an Upload Sample Header command. Instead, we
1485 have to convert the data format back into our data structure,
1486 just as in the Download Sample command, where we have to do
1487 something very similar in the reverse direction.
1490 *((u32 *) &s.sampleStartOffset) = demunge_int32 (ptr, 4); ptr += 4;
1491 *((u32 *) &s.loopStartOffset) = demunge_int32 (ptr, 4); ptr += 4;
1492 *((u32 *) &s.loopEndOffset) = demunge_int32 (ptr, 4); ptr += 4;
1493 *((u32 *) &s.sampleEndOffset) = demunge_int32 (ptr, 4); ptr += 4;
1494 *((u32 *) &s.FrequencyBias) = demunge_int32 (ptr, 3); ptr += 3;
1496 s.SampleResolution = *ptr & 0x3;
1497 s.Loop = *ptr & 0x8;
1498 s.Bidirectional = *ptr & 0x10;
1499 s.Reverse = *ptr & 0x40;
1501 /* Now copy it back to where it came from */
1503 memcpy (buf, (unsigned char *) &s, sizeof (wavefront_sample));
1507 wavefront_synth_control (snd_wavefront_card_t *acard,
1508 wavefront_control *wc)
1511 snd_wavefront_t *dev = &acard->wavefront;
1512 unsigned char patchnumbuf[2];
1515 DPRINT (WF_DEBUG_CMD, "synth control with "
1516 "cmd 0x%x\n", wc->cmd);
1518 /* Pre-handling of or for various commands */
1522 case WFC_DISABLE_INTERRUPTS:
1523 snd_printk ("interrupts disabled.\n");
1524 outb (0x80|0x20, dev->control_port);
1525 dev->interrupts_are_midi = 1;
1528 case WFC_ENABLE_INTERRUPTS:
1529 snd_printk ("interrupts enabled.\n");
1530 outb (0x80|0x40|0x20, dev->control_port);
1531 dev->interrupts_are_midi = 1;
1534 case WFC_INTERRUPT_STATUS:
1535 wc->rbuf[0] = dev->interrupts_are_midi;
1538 case WFC_ROMSAMPLES_RDONLY:
1539 dev->rom_samples_rdonly = wc->wbuf[0];
1543 case WFC_IDENTIFY_SLOT_TYPE:
1544 i = wc->wbuf[0] | (wc->wbuf[1] << 7);
1545 if (i <0 || i >= WF_MAX_SAMPLE) {
1546 snd_printk ("invalid slot ID %d\n",
1548 wc->status = EINVAL;
1551 wc->rbuf[0] = dev->sample_status[i];
1555 case WFC_DEBUG_DRIVER:
1556 dev->debug = wc->wbuf[0];
1557 snd_printk ("debug = 0x%x\n", dev->debug);
1560 case WFC_UPLOAD_PATCH:
1561 munge_int32 (*((u32 *) wc->wbuf), patchnumbuf, 2);
1562 memcpy (wc->wbuf, patchnumbuf, 2);
1565 case WFC_UPLOAD_MULTISAMPLE:
1566 /* multisamples have to be handled differently, and
1567 cannot be dealt with properly by snd_wavefront_cmd() alone.
1569 wc->status = wavefront_fetch_multisample
1570 (dev, (wavefront_patch_info *) wc->rbuf);
1573 case WFC_UPLOAD_SAMPLE_ALIAS:
1574 snd_printk ("support for sample alias upload "
1575 "being considered.\n");
1576 wc->status = EINVAL;
1580 wc->status = snd_wavefront_cmd (dev, wc->cmd, wc->rbuf, wc->wbuf);
1582 /* Post-handling of certain commands.
1584 In particular, if the command was an upload, demunge the data
1585 so that the user-level doesn't have to think about it.
1588 if (wc->status == 0) {
1590 /* intercept any freemem requests so that we know
1591 we are always current with the user-level view
1595 case WFC_REPORT_FREE_MEMORY:
1596 dev->freemem = demunge_int32 (wc->rbuf, 4);
1599 case WFC_UPLOAD_PATCH:
1600 demunge_buf (wc->rbuf, wc->rbuf, WF_PATCH_BYTES);
1603 case WFC_UPLOAD_PROGRAM:
1604 demunge_buf (wc->rbuf, wc->rbuf, WF_PROGRAM_BYTES);
1607 case WFC_UPLOAD_EDRUM_PROGRAM:
1608 demunge_buf (wc->rbuf, wc->rbuf, WF_DRUM_BYTES - 1);
1611 case WFC_UPLOAD_SAMPLE_HEADER:
1612 process_sample_hdr (wc->rbuf);
1615 case WFC_UPLOAD_SAMPLE_ALIAS:
1616 snd_printk ("support for "
1617 "sample aliases still "
1618 "being considered.\n");
1622 snd_wavefront_midi_disable_virtual (acard);
1626 snd_wavefront_midi_enable_virtual (acard);
1635 snd_wavefront_synth_open (struct snd_hwdep *hw, struct file *file)
1638 if (!try_module_get(hw->card->module))
1640 file->private_data = hw;
1645 snd_wavefront_synth_release (struct snd_hwdep *hw, struct file *file)
1648 module_put(hw->card->module);
1653 snd_wavefront_synth_ioctl (struct snd_hwdep *hw, struct file *file,
1654 unsigned int cmd, unsigned long arg)
1657 struct snd_card *card;
1658 snd_wavefront_t *dev;
1659 snd_wavefront_card_t *acard;
1660 wavefront_control *wc;
1661 void __user *argp = (void __user *)arg;
1664 card = (struct snd_card *) hw->card;
1666 if (snd_BUG_ON(!card))
1668 if (snd_BUG_ON(!card->private_data))
1671 acard = card->private_data;
1672 dev = &acard->wavefront;
1675 case WFCTL_LOAD_SPP:
1676 if (wavefront_load_patch (dev, argp) != 0) {
1682 wc = memdup_user(argp, sizeof(*wc));
1686 if (wavefront_synth_control (acard, wc) < 0)
1688 else if (copy_to_user (argp, wc, sizeof (*wc)))
1703 /***********************************************************************/
1704 /* WaveFront: interface for card-level wavefront module */
1705 /***********************************************************************/
1708 snd_wavefront_internal_interrupt (snd_wavefront_card_t *card)
1710 snd_wavefront_t *dev = &card->wavefront;
1713 Some comments on interrupts. I attempted a version of this
1714 driver that used interrupts throughout the code instead of
1715 doing busy and/or sleep-waiting. Alas, it appears that once
1716 the Motorola firmware is downloaded, the card *never*
1717 generates an RX interrupt. These are successfully generated
1718 during firmware loading, and after that wavefront_status()
1719 reports that an interrupt is pending on the card from time
1720 to time, but it never seems to be delivered to this
1721 driver. Note also that wavefront_status() continues to
1722 report that RX interrupts are enabled, suggesting that I
1723 didn't goof up and disable them by mistake.
1725 Thus, I stepped back to a prior version of
1726 wavefront_wait(), the only place where this really
1727 matters. Its sad, but I've looked through the code to check
1728 on things, and I really feel certain that the Motorola
1729 firmware prevents RX-ready interrupts.
1732 if ((wavefront_status(dev) & (STAT_INTR_READ|STAT_INTR_WRITE)) == 0) {
1736 spin_lock(&dev->irq_lock);
1739 spin_unlock(&dev->irq_lock);
1740 wake_up(&dev->interrupt_sleeper);
1745 0 Host Rx Interrupt Enable (1=Enabled)
1746 1 Host Rx Register Full (1=Full)
1747 2 Host Rx Interrupt Pending (1=Interrupt)
1749 4 Host Tx Interrupt (1=Enabled)
1750 5 Host Tx Register empty (1=Empty)
1751 6 Host Tx Interrupt Pending (1=Interrupt)
1756 snd_wavefront_interrupt_bits (int irq)
1776 snd_printk ("invalid IRQ %d\n", irq);
1784 wavefront_should_cause_interrupt (snd_wavefront_t *dev,
1785 int val, int port, unsigned long timeout)
1788 wait_queue_entry_t wait;
1790 init_waitqueue_entry(&wait, current);
1791 spin_lock_irq(&dev->irq_lock);
1792 add_wait_queue(&dev->interrupt_sleeper, &wait);
1795 spin_unlock_irq(&dev->irq_lock);
1796 while (!dev->irq_ok && time_before(jiffies, timeout)) {
1797 schedule_timeout_uninterruptible(1);
1803 wavefront_reset_to_cleanliness (snd_wavefront_t *dev)
1809 /* IRQ already checked */
1811 bits = snd_wavefront_interrupt_bits (dev->irq);
1813 /* try reset of port */
1815 outb (0x0, dev->control_port);
1817 /* At this point, the board is in reset, and the H/W initialization
1818 register is accessed at the same address as the data port.
1820 Bit 7 - Enable IRQ Driver
1821 0 - Tri-state the Wave-Board drivers for the PC Bus IRQs
1822 1 - Enable IRQ selected by bits 5:3 to be driven onto the PC Bus.
1824 Bit 6 - MIDI Interface Select
1826 0 - Use the MIDI Input from the 26-pin WaveBlaster
1827 compatible header as the serial MIDI source
1828 1 - Use the MIDI Input from the 9-pin D connector as the
1831 Bits 5:3 - IRQ Selection
1842 Bit 0 - Disable Boot ROM
1843 0 - memory accesses to 03FC30-03FFFFH utilize the internal Boot ROM
1844 1 - memory accesses to 03FC30-03FFFFH are directed to external
1849 /* configure hardware: IRQ, enable interrupts,
1850 plus external 9-pin MIDI interface selected
1853 outb (0x80 | 0x40 | bits, dev->data_port);
1857 0 Host Rx Interrupt Enable (1=Enabled) 0x1
1861 4 Host Tx Interrupt Enable 0x10
1862 5 Mute (0=Mute; 1=Play) 0x20
1863 6 Master Interrupt Enable (1=Enabled) 0x40
1864 7 Master Reset (0=Reset; 1=Run) 0x80
1866 Take us out of reset, mute output, master + TX + RX interrupts on.
1868 We'll get an interrupt presumably to tell us that the TX
1872 wavefront_should_cause_interrupt(dev, 0x80|0x40|0x10|0x1,
1874 (reset_time*HZ)/100);
1876 /* Note: data port is now the data port, not the h/w initialization
1881 snd_printk ("intr not received after h/w un-reset.\n");
1885 /* Note: data port is now the data port, not the h/w initialization
1888 At this point, only "HW VERSION" or "DOWNLOAD OS" commands
1889 will work. So, issue one of them, and wait for TX
1890 interrupt. This can take a *long* time after a cold boot,
1891 while the ISC ROM does its RAM test. The SDK says up to 4
1892 seconds - with 12MB of RAM on a Tropez+, it takes a lot
1893 longer than that (~16secs). Note that the card understands
1894 the difference between a warm and a cold boot, so
1895 subsequent ISC2115 reboots (say, caused by module
1896 reloading) will get through this much faster.
1898 XXX Interesting question: why is no RX interrupt received first ?
1901 wavefront_should_cause_interrupt(dev, WFC_HARDWARE_VERSION,
1902 dev->data_port, ramcheck_time*HZ);
1905 snd_printk ("post-RAM-check interrupt not received.\n");
1909 if (!wavefront_wait (dev, STAT_CAN_READ)) {
1910 snd_printk ("no response to HW version cmd.\n");
1914 if ((hwv[0] = wavefront_read (dev)) == -1) {
1915 snd_printk ("board not responding correctly.\n");
1919 if (hwv[0] == 0xFF) { /* NAK */
1921 /* Board's RAM test failed. Try to read error code,
1922 and tell us about it either way.
1925 if ((hwv[0] = wavefront_read (dev)) == -1) {
1926 snd_printk ("on-board RAM test failed "
1927 "(bad error code).\n");
1929 snd_printk ("on-board RAM test failed "
1930 "(error code: 0x%x).\n",
1936 /* We're OK, just get the next byte of the HW version response */
1938 if ((hwv[1] = wavefront_read (dev)) == -1) {
1939 snd_printk ("incorrect h/w response.\n");
1943 snd_printk ("hardware version %d.%d\n",
1954 wavefront_download_firmware (snd_wavefront_t *dev, char *path)
1957 const unsigned char *buf;
1959 int section_cnt_downloaded = 0;
1960 const struct firmware *firmware;
1962 err = reject_firmware(&firmware, path, dev->card->dev);
1964 snd_printk(KERN_ERR "firmware (%s) download failed!!!\n", path);
1969 buf = firmware->data;
1971 int section_length = *(signed char *)buf;
1972 if (section_length == 0)
1974 if (section_length < 0 || section_length > WF_SECTION_MAX) {
1976 "invalid firmware section length %d\n",
1983 if (firmware->size < len + section_length) {
1984 snd_printk(KERN_ERR "firmware section read error.\n");
1989 if (wavefront_write(dev, WFC_DOWNLOAD_OS))
1992 for (; section_length; section_length--) {
1993 if (wavefront_write(dev, *buf))
2000 if (!wavefront_wait(dev, STAT_CAN_READ)) {
2001 snd_printk(KERN_ERR "time out for firmware ACK.\n");
2004 err = inb(dev->data_port);
2005 if (err != WF_ACK) {
2007 "download of section #%d not "
2008 "acknowledged, ack = 0x%x\n",
2009 section_cnt_downloaded + 1, err);
2013 section_cnt_downloaded++;
2016 release_firmware(firmware);
2020 release_firmware(firmware);
2021 snd_printk(KERN_ERR "firmware download failed!!!\n");
2027 wavefront_do_reset (snd_wavefront_t *dev)
2032 if (wavefront_reset_to_cleanliness (dev)) {
2033 snd_printk ("hw reset failed.\n");
2038 if (wavefront_download_firmware (dev, ospath)) {
2044 /* Wait for the OS to get running. The protocol for
2045 this is non-obvious, and was determined by
2046 using port-IO tracing in DOSemu and some
2047 experimentation here.
2049 Rather than using timed waits, use interrupts creatively.
2052 wavefront_should_cause_interrupt (dev, WFC_NOOP,
2057 snd_printk ("no post-OS interrupt.\n");
2061 /* Now, do it again ! */
2063 wavefront_should_cause_interrupt (dev, WFC_NOOP,
2064 dev->data_port, (10*HZ));
2067 snd_printk ("no post-OS interrupt(2).\n");
2071 /* OK, no (RX/TX) interrupts any more, but leave mute
2075 outb (0x80|0x40, dev->control_port);
2078 /* SETUPSND.EXE asks for sample memory config here, but since i
2079 have no idea how to interpret the result, we'll forget
2083 if ((dev->freemem = wavefront_freemem (dev)) < 0) {
2087 snd_printk ("available DRAM %dk\n", dev->freemem / 1024);
2089 if (wavefront_write (dev, 0xf0) ||
2090 wavefront_write (dev, 1) ||
2091 (wavefront_read (dev) < 0)) {
2093 snd_printk ("MPU emulation mode not set.\n");
2099 if (snd_wavefront_cmd (dev, WFC_SET_NVOICES, NULL, voices)) {
2100 snd_printk ("cannot set number of voices to 32.\n");
2108 /* reset that sucker so that it doesn't bother us. */
2110 outb (0x0, dev->control_port);
2111 dev->interrupts_are_midi = 0;
2116 snd_wavefront_start (snd_wavefront_t *dev)
2119 int samples_are_from_rom;
2121 /* IMPORTANT: assumes that snd_wavefront_detect() and/or
2122 wavefront_reset_to_cleanliness() has already been called
2126 samples_are_from_rom = 1;
2128 /* XXX is this always true ? */
2129 samples_are_from_rom = 0;
2132 if (dev->israw || fx_raw) {
2133 if (wavefront_do_reset (dev)) {
2137 /* Check for FX device, present only on Tropez+ */
2139 dev->has_fx = (snd_wavefront_fx_detect (dev) == 0);
2141 if (dev->has_fx && fx_raw) {
2142 snd_wavefront_fx_start (dev);
2145 wavefront_get_sample_status (dev, samples_are_from_rom);
2146 wavefront_get_program_status (dev);
2147 wavefront_get_patch_status (dev);
2149 /* Start normal operation: unreset, master interrupt enabled, no mute
2152 outb (0x80|0x40|0x20, dev->control_port);
2158 snd_wavefront_detect (snd_wavefront_card_t *card)
2161 unsigned char rbuf[4], wbuf[4];
2162 snd_wavefront_t *dev = &card->wavefront;
2164 /* returns zero if a WaveFront card is successfully detected.
2170 dev->debug = debug_default;
2171 dev->interrupts_are_midi = 0;
2173 dev->rom_samples_rdonly = 1;
2175 if (snd_wavefront_cmd (dev, WFC_FIRMWARE_VERSION, rbuf, wbuf) == 0) {
2177 dev->fw_version[0] = rbuf[0];
2178 dev->fw_version[1] = rbuf[1];
2180 snd_printk ("firmware %d.%d already loaded.\n",
2183 /* check that a command actually works */
2185 if (snd_wavefront_cmd (dev, WFC_HARDWARE_VERSION,
2187 dev->hw_version[0] = rbuf[0];
2188 dev->hw_version[1] = rbuf[1];
2190 snd_printk ("not raw, but no "
2191 "hardware version!\n");
2198 snd_printk ("reloading firmware as you requested.\n");
2205 snd_printk ("no response to firmware probe, assume raw.\n");