Merge remote-tracking branch 'remotes/bonzini-gitlab/tags/for-upstream' into staging
[qemu/ar7.git] / hw / audio / gusemu_hal.c
blob5b9a14ee21b668a3627aa2bfd2c6eca14ba0ea11
1 /*
2 * GUSEMU32 - bus interface part
4 * Copyright (C) 2000-2007 Tibor "TS" Schütz
6 * Permission is hereby granted, free of charge, to any person obtaining a copy
7 * of this software and associated documentation files (the "Software"), to deal
8 * in the Software without restriction, including without limitation the rights
9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10 * copies of the Software, and to permit persons to whom the Software is
11 * furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included in
14 * all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22 * THE SOFTWARE.
26 * TODO: check mixer: see 7.20 of sdk for panning pos (applies to all gus models?)?
29 #include "qemu/osdep.h"
30 #include "gustate.h"
31 #include "gusemu.h"
33 #define GUSregb(position) (* (gusptr+(position)))
34 #define GUSregw(position) (*(uint16_t *) (gusptr+(position)))
35 #define GUSregd(position) (*(uint32_t *)(gusptr + (position)))
37 /* size given in bytes */
38 unsigned int gus_read(GUSEmuState * state, int port, int size)
40 int value_read = 0;
42 uint8_t *gusptr;
43 gusptr = state->gusdatapos;
44 GUSregd(portaccesses)++;
46 switch (port & 0xff0f)
48 /* MixerCtrlReg (read not supported on GUS classic) */
49 /* case 0x200: return GUSregb(MixerCtrlReg2x0); */
50 case 0x206: /* IRQstatReg / SB2x6IRQ */
51 /* adlib/sb bits set in port handlers */
52 /* timer/voice bits set in gus_irqgen() */
53 /* dma bit set in gus_dma_transferdata */
54 /* midi not implemented yet */
55 return GUSregb(IRQStatReg2x6);
56 /* case 0x308: */ /* AdLib388 */
57 case 0x208:
58 if (GUSregb(GUS45TimerCtrl) & 1)
59 return GUSregb(TimerStatus2x8);
60 return GUSregb(AdLibStatus2x8); /* AdLibStatus */
61 case 0x309: /* AdLib389 */
62 case 0x209:
63 return GUSregb(AdLibData2x9); /* AdLibData */
64 case 0x20A:
65 return GUSregb(AdLibCommand2xA); /* AdLib2x8_2xA */
67 #if 0
68 case 0x20B: /* GUS hidden registers (read not supported on GUS classic) */
69 switch (GUSregb(RegCtrl_2xF) & 0x07)
71 case 0: /* IRQ/DMA select */
72 if (GUSregb(MixerCtrlReg2x0) & 0x40)
73 return GUSregb(IRQ_2xB); /* control register select bit */
74 else
75 return GUSregb(DMA_2xB);
76 /* case 1-5: */ /* general purpose emulation regs */
77 /* return ... */ /* + status reset reg (write only) */
78 case 6:
79 return GUSregb(Jumper_2xB); /* Joystick/MIDI enable (JumperReg) */
80 default:;
82 break;
83 #endif
85 case 0x20C: /* SB2xCd */
86 value_read = GUSregb(SB2xCd);
87 if (GUSregb(StatRead_2xF) & 0x20)
88 GUSregb(SB2xCd) ^= 0x80; /* toggle MSB on read */
89 return value_read;
90 /* case 0x20D: */ /* SB2xD is write only -> 2xE writes to it*/
91 case 0x20E:
92 if (GUSregb(RegCtrl_2xF) & 0x80) /* 2xE read IRQ enabled? */
94 GUSregb(StatRead_2xF) |= 0x80;
95 GUS_irqrequest(state, state->gusirq, 1);
97 return GUSregb(SB2xE); /* SB2xE */
98 case 0x20F: /* StatRead_2xF */
99 /*set/clear fixed bits */
100 /*value_read = (GUSregb(StatRead_2xF) & 0xf9)|1; */ /*(LSB not set on GUS classic!)*/
101 value_read = (GUSregb(StatRead_2xF) & 0xf9);
102 if (GUSregb(MixerCtrlReg2x0) & 0x08)
103 value_read |= 2; /* DMA/IRQ enabled flag */
104 return value_read;
105 /* case 0x300: */ /* MIDI (not implemented) */
106 /* case 0x301: */ /* MIDI (not implemented) */
107 case 0x302:
108 return GUSregb(VoiceSelReg3x2); /* VoiceSelReg */
109 case 0x303:
110 return GUSregb(FunkSelReg3x3); /* FunkSelReg */
111 case 0x304: /* DataRegLoByte3x4 + DataRegWord3x4 */
112 case 0x305: /* DataRegHiByte3x5 */
113 switch (GUSregb(FunkSelReg3x3))
115 /* common functions */
116 case 0x41: /* DramDMAContrReg */
117 value_read = GUSregb(GUS41DMACtrl); /* &0xfb */
118 GUSregb(GUS41DMACtrl) &= 0xbb;
119 if (state->gusdma >= 4)
120 value_read |= 0x04;
121 if (GUSregb(IRQStatReg2x6) & 0x80)
123 value_read |= 0x40;
124 GUSregb(IRQStatReg2x6) &= 0x7f;
125 if (!GUSregb(IRQStatReg2x6))
126 GUS_irqclear(state, state->gusirq);
128 return (uint8_t) value_read;
129 /* DramDMAmemPosReg */
130 /* case 0x42: value_read=GUSregw(GUS42DMAStart); break;*/
131 /* 43h+44h write only */
132 case 0x45:
133 return GUSregb(GUS45TimerCtrl); /* TimerCtrlReg */
134 /* 46h+47h write only */
135 /* 48h: samp freq - write only */
136 case 0x49:
137 return GUSregb(GUS49SampCtrl) & 0xbf; /* SampCtrlReg */
138 /* case 4bh: */ /* joystick trim not supported */
139 /* case 0x4c: return GUSregb(GUS4cReset); */ /* GUSreset: write only*/
140 /* voice specific functions */
141 case 0x80:
142 case 0x81:
143 case 0x82:
144 case 0x83:
145 case 0x84:
146 case 0x85:
147 case 0x86:
148 case 0x87:
149 case 0x88:
150 case 0x89:
151 case 0x8a:
152 case 0x8b:
153 case 0x8c:
154 case 0x8d:
156 int offset = 2 * (GUSregb(FunkSelReg3x3) & 0x0f);
157 offset += ((int) GUSregb(VoiceSelReg3x2) & 0x1f) << 5; /* = Voice*32 + Funktion*2 */
158 value_read = GUSregw(offset);
160 break;
161 /* voice unspecific functions */
162 case 0x8e: /* NumVoice */
163 return GUSregb(NumVoices);
164 case 0x8f: /* irqstatreg */
165 /* (pseudo IRQ-FIFO is processed during a gus_write(0x3X3,0x8f)) */
166 return GUSregb(SynVoiceIRQ8f);
167 default:
168 return 0xffff;
170 if (size == 1)
172 if ((port & 0xff0f) == 0x305)
173 value_read = value_read >> 8;
174 value_read &= 0xff;
176 return (uint16_t) value_read;
177 /* case 0x306: */ /* Mixer/Version info */
178 /* return 0xff; */ /* Pre 3.6 boards, ICS mixer NOT present */
179 case 0x307: /* DRAMaccess */
181 uint8_t *adr;
182 adr = state->himemaddr + (GUSregd(GUSDRAMPOS24bit) & 0xfffff);
183 return *adr;
185 default:;
187 return 0xffff;
190 void gus_write(GUSEmuState * state, int port, int size, unsigned int data)
192 uint8_t *gusptr;
193 gusptr = state->gusdatapos;
194 GUSregd(portaccesses)++;
196 switch (port & 0xff0f)
198 case 0x200: /* MixerCtrlReg */
199 GUSregb(MixerCtrlReg2x0) = (uint8_t) data;
200 break;
201 case 0x206: /* IRQstatReg / SB2x6IRQ */
202 if (GUSregb(GUS45TimerCtrl) & 0x20) /* SB IRQ enabled? -> set 2x6IRQ bit */
204 GUSregb(TimerStatus2x8) |= 0x08;
205 GUSregb(IRQStatReg2x6) = 0x10;
206 GUS_irqrequest(state, state->gusirq, 1);
208 break;
209 case 0x308: /* AdLib 388h */
210 case 0x208: /* AdLibCommandReg */
211 GUSregb(AdLibCommand2xA) = (uint8_t) data;
212 break;
213 case 0x309: /* AdLib 389h */
214 case 0x209: /* AdLibDataReg */
215 if ((GUSregb(AdLibCommand2xA) == 0x04) && (!(GUSregb(GUS45TimerCtrl) & 1))) /* GUS auto timer mode enabled? */
217 if (data & 0x80)
218 GUSregb(TimerStatus2x8) &= 0x1f; /* AdLib IRQ reset? -> clear maskable adl. timer int regs */
219 else
220 GUSregb(TimerDataReg2x9) = (uint8_t) data;
222 else
224 GUSregb(AdLibData2x9) = (uint8_t) data;
225 if (GUSregb(GUS45TimerCtrl) & 0x02)
227 GUSregb(TimerStatus2x8) |= 0x01;
228 GUSregb(IRQStatReg2x6) = 0x10;
229 GUS_irqrequest(state, state->gusirq, 1);
232 break;
233 case 0x20A:
234 GUSregb(AdLibStatus2x8) = (uint8_t) data;
235 break; /* AdLibStatus2x8 */
236 case 0x20B: /* GUS hidden registers */
237 switch (GUSregb(RegCtrl_2xF) & 0x7)
239 case 0:
240 if (GUSregb(MixerCtrlReg2x0) & 0x40)
241 GUSregb(IRQ_2xB) = (uint8_t) data; /* control register select bit */
242 else
243 GUSregb(DMA_2xB) = (uint8_t) data;
244 break;
245 /* case 1-4: general purpose emulation regs */
246 case 5: /* clear stat reg 2xF */
247 GUSregb(StatRead_2xF) = 0; /* ToDo: is this identical with GUS classic? */
248 if (!GUSregb(IRQStatReg2x6))
249 GUS_irqclear(state, state->gusirq);
250 break;
251 case 6: /* Jumper reg (Joystick/MIDI enable) */
252 GUSregb(Jumper_2xB) = (uint8_t) data;
253 break;
254 default:;
256 break;
257 case 0x20C: /* SB2xCd */
258 if (GUSregb(GUS45TimerCtrl) & 0x20)
260 GUSregb(TimerStatus2x8) |= 0x10; /* SB IRQ enabled? -> set 2xCIRQ bit */
261 GUSregb(IRQStatReg2x6) = 0x10;
262 GUS_irqrequest(state, state->gusirq, 1);
264 /* fall through */
265 case 0x20D: /* SB2xCd no IRQ */
266 GUSregb(SB2xCd) = (uint8_t) data;
267 break;
268 case 0x20E: /* SB2xE */
269 GUSregb(SB2xE) = (uint8_t) data;
270 break;
271 case 0x20F:
272 GUSregb(RegCtrl_2xF) = (uint8_t) data;
273 break; /* CtrlReg2xF */
274 case 0x302: /* VoiceSelReg */
275 GUSregb(VoiceSelReg3x2) = (uint8_t) data;
276 break;
277 case 0x303: /* FunkSelReg */
278 GUSregb(FunkSelReg3x3) = (uint8_t) data;
279 if ((uint8_t) data == 0x8f) /* set irqstatreg, get voicereg and clear IRQ */
281 int voice;
282 if (GUSregd(voicewavetableirq)) /* WavetableIRQ */
284 for (voice = 0; voice < 31; voice++)
286 if (GUSregd(voicewavetableirq) & (1 << voice))
288 GUSregd(voicewavetableirq) ^= (1 << voice); /* clear IRQ bit */
289 GUSregb(voice << 5) &= 0x7f; /* clear voice reg irq bit */
290 if (!GUSregd(voicewavetableirq))
291 GUSregb(IRQStatReg2x6) &= 0xdf;
292 if (!GUSregb(IRQStatReg2x6))
293 GUS_irqclear(state, state->gusirq);
294 GUSregb(SynVoiceIRQ8f) = voice | 0x60; /* (bit==0 => IRQ wartend) */
295 return;
299 else if (GUSregd(voicevolrampirq)) /* VolRamp IRQ */
301 for (voice = 0; voice < 31; voice++)
303 if (GUSregd(voicevolrampirq) & (1 << voice))
305 GUSregd(voicevolrampirq) ^= (1 << voice); /* clear IRQ bit */
306 GUSregb((voice << 5) + VSRVolRampControl) &= 0x7f; /* clear voice volume reg irq bit */
307 if (!GUSregd(voicevolrampirq))
308 GUSregb(IRQStatReg2x6) &= 0xbf;
309 if (!GUSregb(IRQStatReg2x6))
310 GUS_irqclear(state, state->gusirq);
311 GUSregb(SynVoiceIRQ8f) = voice | 0x80; /* (bit==0 => IRQ wartend) */
312 return;
316 GUSregb(SynVoiceIRQ8f) = 0xe8; /* kein IRQ wartet */
318 break;
319 case 0x304:
320 case 0x305:
322 uint16_t writedata = (uint16_t) data;
323 uint16_t readmask = 0x0000;
324 if (size == 1)
326 readmask = 0xff00;
327 writedata &= 0xff;
328 if ((port & 0xff0f) == 0x305)
330 writedata = (uint16_t) (writedata << 8);
331 readmask = 0x00ff;
334 switch (GUSregb(FunkSelReg3x3))
336 /* voice specific functions */
337 case 0x00:
338 case 0x01:
339 case 0x02:
340 case 0x03:
341 case 0x04:
342 case 0x05:
343 case 0x06:
344 case 0x07:
345 case 0x08:
346 case 0x09:
347 case 0x0a:
348 case 0x0b:
349 case 0x0c:
350 case 0x0d:
352 int offset;
353 if (!(GUSregb(GUS4cReset) & 0x01))
354 break; /* reset flag active? */
355 offset = 2 * (GUSregb(FunkSelReg3x3) & 0x0f);
356 offset += (GUSregb(VoiceSelReg3x2) & 0x1f) << 5; /* = Voice*32 + Funktion*2 */
357 GUSregw(offset) = (uint16_t) ((GUSregw(offset) & readmask) | writedata);
359 break;
360 /* voice unspecific functions */
361 case 0x0e: /* NumVoices */
362 GUSregb(NumVoices) = (uint8_t) data;
363 break;
364 /* case 0x0f: */ /* read only */
365 /* common functions */
366 case 0x41: /* DramDMAContrReg */
367 GUSregb(GUS41DMACtrl) = (uint8_t) data;
368 if (data & 0x01)
369 GUS_dmarequest(state);
370 break;
371 case 0x42: /* DramDMAmemPosReg */
372 GUSregw(GUS42DMAStart) = (GUSregw(GUS42DMAStart) & readmask) | writedata;
373 GUSregb(GUS50DMAHigh) &= 0xf; /* compatibility stuff... */
374 break;
375 case 0x43: /* DRAMaddrLo */
376 GUSregd(GUSDRAMPOS24bit) =
377 (GUSregd(GUSDRAMPOS24bit) & (readmask | 0xff0000)) | writedata;
378 break;
379 case 0x44: /* DRAMaddrHi */
380 GUSregd(GUSDRAMPOS24bit) =
381 (GUSregd(GUSDRAMPOS24bit) & 0xffff) | ((data & 0x0f) << 16);
382 break;
383 case 0x45: /* TCtrlReg */
384 GUSregb(GUS45TimerCtrl) = (uint8_t) data;
385 if (!(data & 0x20))
386 GUSregb(TimerStatus2x8) &= 0xe7; /* sb IRQ dis? -> clear 2x8/2xC sb IRQ flags */
387 if (!(data & 0x02))
388 GUSregb(TimerStatus2x8) &= 0xfe; /* adlib data IRQ dis? -> clear 2x8 adlib IRQ flag */
389 if (!(GUSregb(TimerStatus2x8) & 0x19))
390 GUSregb(IRQStatReg2x6) &= 0xef; /* 0xe6; $$clear IRQ if both IRQ bits are inactive or cleared */
391 /* catch up delayed timer IRQs: */
392 if ((GUSregw(TimerIRQs) > 1) && (GUSregb(TimerDataReg2x9) & 3))
394 if (GUSregb(TimerDataReg2x9) & 1) /* start timer 1 (80us decrement rate) */
396 if (!(GUSregb(TimerDataReg2x9) & 0x40))
397 GUSregb(TimerStatus2x8) |= 0xc0; /* maskable bits */
398 if (data & 4) /* timer1 irq enable */
400 GUSregb(TimerStatus2x8) |= 4; /* nonmaskable bit */
401 GUSregb(IRQStatReg2x6) |= 4; /* timer 1 irq pending */
404 if (GUSregb(TimerDataReg2x9) & 2) /* start timer 2 (320us decrement rate) */
406 if (!(GUSregb(TimerDataReg2x9) & 0x20))
407 GUSregb(TimerStatus2x8) |= 0xa0; /* maskable bits */
408 if (data & 8) /* timer2 irq enable */
410 GUSregb(TimerStatus2x8) |= 2; /* nonmaskable bit */
411 GUSregb(IRQStatReg2x6) |= 8; /* timer 2 irq pending */
414 GUSregw(TimerIRQs)--;
415 if (GUSregw(BusyTimerIRQs) > 1)
416 GUSregw(BusyTimerIRQs)--;
417 else
418 GUSregw(BusyTimerIRQs) =
419 GUS_irqrequest(state, state->gusirq, GUSregw(TimerIRQs));
421 else
422 GUSregw(TimerIRQs) = 0;
424 if (!(data & 0x04))
426 GUSregb(TimerStatus2x8) &= 0xfb; /* clear non-maskable timer1 bit */
427 GUSregb(IRQStatReg2x6) &= 0xfb;
429 if (!(data & 0x08))
431 GUSregb(TimerStatus2x8) &= 0xfd; /* clear non-maskable timer2 bit */
432 GUSregb(IRQStatReg2x6) &= 0xf7;
434 if (!GUSregb(IRQStatReg2x6))
435 GUS_irqclear(state, state->gusirq);
436 break;
437 case 0x46: /* Counter1 */
438 GUSregb(GUS46Counter1) = (uint8_t) data;
439 break;
440 case 0x47: /* Counter2 */
441 GUSregb(GUS47Counter2) = (uint8_t) data;
442 break;
443 /* case 0x48: */ /* sampling freq reg not emulated (same as interwave) */
444 case 0x49: /* SampCtrlReg */
445 GUSregb(GUS49SampCtrl) = (uint8_t) data;
446 break;
447 /* case 0x4b: */ /* joystick trim not emulated */
448 case 0x4c: /* GUSreset */
449 GUSregb(GUS4cReset) = (uint8_t) data;
450 if (!(GUSregb(GUS4cReset) & 1)) /* reset... */
452 GUSregd(voicewavetableirq) = 0;
453 GUSregd(voicevolrampirq) = 0;
454 GUSregw(TimerIRQs) = 0;
455 GUSregw(BusyTimerIRQs) = 0;
456 GUSregb(NumVoices) = 0xcd;
457 GUSregb(IRQStatReg2x6) = 0;
458 GUSregb(TimerStatus2x8) = 0;
459 GUSregb(AdLibData2x9) = 0;
460 GUSregb(TimerDataReg2x9) = 0;
461 GUSregb(GUS41DMACtrl) = 0;
462 GUSregb(GUS45TimerCtrl) = 0;
463 GUSregb(GUS49SampCtrl) = 0;
464 GUSregb(GUS4cReset) &= 0xf9; /* clear IRQ and DAC enable bits */
465 GUS_irqclear(state, state->gusirq);
467 /* IRQ enable bit checked elsewhere */
468 /* EnableDAC bit may be used by external callers */
469 break;
472 break;
473 case 0x307: /* DRAMaccess */
475 uint8_t *adr;
476 adr = state->himemaddr + (GUSregd(GUSDRAMPOS24bit) & 0xfffff);
477 *adr = (uint8_t) data;
479 break;
483 /* Attention when breaking up a single DMA transfer to multiple ones:
484 * it may lead to multiple terminal count interrupts and broken transfers:
486 * 1. Whenever you transfer a piece of data, the gusemu callback is invoked
487 * 2. The callback may generate a TC irq (if the register was set up to do so)
488 * 3. The irq may result in the program using the GUS to reprogram the GUS
490 * Some programs also decide to upload by just checking if TC occurs
491 * (via interrupt or a cleared GUS dma flag)
492 * and then start the next transfer, without checking DMA state
494 * Thus: Always make sure to set the TC flag correctly!
496 * Note that the genuine GUS had a granularity of 16 bytes/words for low/high DMA
497 * while later cards had atomic granularity provided by an additional GUS50DMAHigh register
498 * GUSemu also uses this register to support byte-granular transfers for better compatibility
499 * with emulators other than GUSemu32
502 void gus_dma_transferdata(GUSEmuState * state, char *dma_addr, unsigned int count, int TC)
504 /* this function gets called by the callback function as soon as a DMA transfer is about to start
505 * dma_addr is a translated address within accessible memory, not the physical one,
506 * count is (real dma count register)+1
507 * note that the amount of bytes transferred is fully determined by values in the DMA registers
508 * do not forget to update DMA states after transferring the entire block:
509 * DREQ cleared & TC asserted after the _whole_ transfer */
511 char *srcaddr;
512 char *destaddr;
513 char msbmask = 0;
514 uint8_t *gusptr;
515 gusptr = state->gusdatapos;
517 srcaddr = dma_addr; /* system memory address */
519 int offset = (GUSregw(GUS42DMAStart) << 4) + (GUSregb(GUS50DMAHigh) & 0xf);
520 if (state->gusdma >= 4)
521 offset = (offset & 0xc0000) + (2 * (offset & 0x1fff0)); /* 16 bit address translation */
522 destaddr = (char *) state->himemaddr + offset; /* wavetable RAM address */
525 GUSregw(GUS42DMAStart) += (uint16_t) (count >> 4); /* ToDo: add 16bit GUS page limit? */
526 GUSregb(GUS50DMAHigh) = (uint8_t) ((count + GUSregb(GUS50DMAHigh)) & 0xf); /* ToDo: add 16bit GUS page limit? */
528 if (GUSregb(GUS41DMACtrl) & 0x02) /* direction, 0 := sysram->gusram */
530 char *tmpaddr = destaddr;
531 destaddr = srcaddr;
532 srcaddr = tmpaddr;
535 if ((GUSregb(GUS41DMACtrl) & 0x80) && (!(GUSregb(GUS41DMACtrl) & 0x02)))
536 msbmask = (const char) 0x80; /* invert MSB */
537 for (; count > 0; count--)
539 if (GUSregb(GUS41DMACtrl) & 0x40)
540 *(destaddr++) = *(srcaddr++); /* 16 bit lobyte */
541 else
542 *(destaddr++) = (msbmask ^ (*(srcaddr++))); /* 8 bit */
543 if (state->gusdma >= 4)
544 *(destaddr++) = (msbmask ^ (*(srcaddr++))); /* 16 bit hibyte */
547 if (TC)
549 (GUSregb(GUS41DMACtrl)) &= 0xfe; /* clear DMA request bit */
550 if (GUSregb(GUS41DMACtrl) & 0x20) /* DMA terminal count IRQ */
552 GUSregb(IRQStatReg2x6) |= 0x80;
553 GUS_irqrequest(state, state->gusirq, 1);