³ ** UltraDox ** v2.0 ³ ÚÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄ¿ ³ Created by: ³ ³ CyberStrike of Renaissance ³ ³ Tran of Renaissance ³ ³(: ...and a few others... :)³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ OK, everyone, here is the second document describing the Gravis Ultrasound. Through the ingeniousness of Forte Technologies and Advanced Gravis, this 32-channel CD-quality digital playback card has been created. It can, under the right mail-order sources, be bought for less than a Soundblaster! Advanced Gravis: Please, please, make an official document describing the functions. We've done our best, and through Internet, we have become YOUR support group for both programming the card and the technical aspects of the card. There are 4 or 5 of us on Internet that spend our time on comp.sys. ibm.pc.soundcard responding to questions, requests, etc, about the Ultrasound. We thought that you did have net access... We BELIEVE in the Ultrasound! We don't believe it is a dead card! At first, Usenet was ragging on the Ultrasound badly. We defended it, and now, it appears that comp.sys.ibm.pc.soundcard has become comp.sys.ibm.pc.soundcard. gus. Enough of that. European demo groups and anyone else who can't understand this document. I only wrote it in a few hours, and while it is better than the last doc, it still lacks. If you can't understand how something is implemented, take a look at GUSMOD 1.1 and GUSMOD 1.2 when it finally comes out. This document is intended as a more advanced supplement to the previous UltraSound Programming Docs. As a supplement, it is advisable to pick up the previous UltraSound Programming Docs, GUSMOD, or any other utilities that are released with source code in order to determine how this system works. If all else fails, contact me at Internet address: cstrike@gompers.gompers.edu Have fun, all! (And Gravis, let's see some real stuff coming out.) * CyberStrike from America's BEST group, Renaissance! þ All trademarks belong to their respective companies and trademark holders. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Card architecture: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ The Gravis Ultrasound has onboard capabilities of playing up to 32 digital voices through 2 DACs, one left and one right. Each voice may be played at sampling rates up to 44.1khz and may be 8 or 16-bit. The voices are individually pannable through 15 different pan positions. The Gravis Ultrasound is allowed up to a megabyte of on-board RAM to be installed on the card. It is highly recommended that Gravis Ultrasound users upgrade this to a meg of RAM as new products will require this. By use of the Ultrasound Poke and Peek functions or by DMA transfers, data can be transferred to and from the card. The data that is loaded to the card MUST be in two's compliment form. DMA transfers can adjust this as the data is loaded to or from the card. If the Poke and Peek methods are used, the data must be manually converted. Lastly, on the subject of DRAM, the sampled data may be 8- or 16- bit. If the data is 16-bit, it will take twice the DRAM to store it. 16-bit data is stored as a low-byte and then a high-byte immediately following it. Each voice may also have a specific volume setting. This is NOT a linear volume but rather a logarithmic volume. It is advisable to make a table to control this. When panning voices, it appears the volume is adjusted according to the pan position. Volume ramping is a technique used to control the popping of the card. If the volume is changed by a large degree, a pop will occur. By ramping the volume into an inaudible range (usually below 2000), anything can be set on the voice without hearing it. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Methods: @DELAY = (in byte 300h)*7 ; CX:AX - Number ; Same as 32-bit shr eax,7 or whatever. RShift proc mov bx,cx shr ax,7 shr cx,7 shl bx,9 or ax,bx ret RShift endp ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Ports: ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE - Mixer Control Port (u_Base) ÚÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄ¿ ³ 7 ³ 6 ³ 5 ³ 4 ³ 3 ³ 2 ³ 1 ³ 0 ³ ÀÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÙ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ÀÄÄÄÄ 0 = Line-In On, 1 = Line-In Off ³ ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄ 0 = Output On, 1 = Output Off ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄ 0 = MicIn Off, 1 = MicIn On ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ? ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ? ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ? ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 0 = u_IRQDMAControl is DMA, 1 is IRQ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ? ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 6h - Status Register Port (u_Status) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 8h - Timer Control Port (u_TimerControl) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 9h - Timer Data Port (u_TimerData) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + Bh - IRQ-DMA Control Port (u_IRQDMAControl) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 100h - Midi Control Port (u_MIDI_Control) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 101h - Midi Data Port (u_MIDI_Data) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 102h - Active Voice Port (u_Voice) Output to u_DataHi the voice number to make the active voice. All commands that pertain to the active voice through the u_Command port will be routed to this voice until it is changed again. Example: mov dx,u_Voice mov al,1 ; Use voice #1. out dx,al ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 103h - Function Select Port (u_Command) ÄÄÄ 00h - Write Voice Mode (Byte to u_DataHi) NOTE: This bit layout may be incorrect. If so, I will post a fixed version of this document later. ÚÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄ¿ ³ 7 ³ 6 ³ 5 ³ 4 ³ 3 ³ 2 ³ 1 ³ 0 ³ ÀÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÙ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ÀÄÄÄÄ 1 = Voice is stopped ³ ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄ 1 = Stop Voice ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄ 0 = 8-bit data, 1 = 16-bit data ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 0 = No loop, 1 = Loop ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 0 = Unidirectional, 1 = Bidirectional ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 1 = IRQ on end of loop ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 0 = Go forward, 1 = Go backwards ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ? Example: mov dx,u_Voice mov al,1 ; Use voice #1. out dx,al mov dx,u_Command mov al,0 ; Write Voice Mode. out dx,al mov dx,u_DataHi mov al,00000011b ; Stop voice #1 immediately. out dx,al ÄÄÄ 01h - Set Voice Frequency (Word to u_DataLo) Based on the number of voices set through register 0Eh (Number of active voices), the divisor changes. The frequency outputted to the Ultrasound is not a frequency such as 22000hz, but rather the hertz divided by a modifier (only Gravis and Forte know why). We've traced the divisors down to 8 active voices. Apparently, there are a minimum of 14. # Voices Divisor # Voices Divisor # Voices Divisor ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ 24 25 8 74 16 37 25 24 9 66 17 35 26 23 10 60 18 33 27 22 11 54 19 31 28 21 12 50 20 30 29 20 13 46 21 28 30 20 14 43 22 27 31 19 15 40 23 26 32 18 It is recommended that you don't use values below 14 voices (even though it appears to work). Example: mov dx,u_Command mov al,0Eh ; Set active voices. out dx,al mov dx,u_DataHi mov al,13 or 0C0h ; Set number of active voices to 14. out dx,al mov dx,u_Voice mov al,2 ; Use voice #2. out dx,al mov dx,u_Command mov al,1 ; Set Voice Frequency. out dx,al mov dx,u_DataHi mov ax,511 ; 22000/43 out dx,al Do yourself a favor and make a table for your notes. ÄÄÄ 02h - Set Loop Start Location (Word to u_DataLo) ÄÄÄ 03h - Set Loop Start Location (Word to u_DataLo) Through the use of these two registers, the starting location for the active voice can be set. For an unknown reason, any memory addresses for the BEGIN, START, and END sample locations in DRAM must be divided by 128 and written to u_DataLo, then multiplied by 512 and written to u_DataLo. Set Sample Begin Location (0ah,0bh) and Set Sample End Location (4,5) will refer to this example. They are both done the same way with the exception of the u_Command outs. @@Lo should be replaced with 2, 4, or 0ah (based on what you are doing), and @@Hi should be replaced with 3, 5, 0bh. @@AddrLo is the lower word of the 32-bit DRAM location. @@AddrHi is the upper word of the 32-bit DRAM location. Example: mov dx,u_Voice mov al,3 ; Use voice #3. out dx,al mov dx,u_Command mov al,@@Lo ; Request new position. out dx,al mov dx,u_DataLo mov ax,@@AddrLo mov cx,@@AddrHi call RShift out dx,ax mov dx,u_Command mov al,@@Hi out dx,al mov dx,u_DataLo mov ax,@@AddrLo shl ax,9 out dx,ax ÄÄÄ 04h - Set Loop End Location (Word to u_DataLo) ÄÄÄ 05h - Set Loop End Location (Word to u_DataLo) Through the use of these two registers, the ending location for the active voice can be set. For an unknown reason, any memory addresses for the BEGIN, START, and END sample locations in DRAM must be divided by 128 and written to u_DataLo, then multiplied by 512 and written to u_DataLo. ÄÄÄ 06h - Set Volume Ramp Rate (Byte to u_DataHi) ÚÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄ¿ ³ 7 ³ 6 ³ 5 ³ 4 ³ 3 ³ 2 ³ 1 ³ 0 ³ ÀÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÙ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ÀÄÄÄÄ¿ ³ ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÁ¿ ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÁ¿ Increment ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÙ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÙ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ Scale ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Scale defines the rate at which the volume will be ramped based on the increment. The increment will be added or subtracted from the volume based on the increment. The scale bits are: 00 - Update every access (fastest) 01 - Update every 8th access 10 - Update every 64th access 11 - Update every 512th access (slowest) An increment of 63 will be the fastest possible ramp. It may, depending on the scale, cause a zipper effect. Usually, increments of 8 or less are suggested. Also, don't ramp below 63 or above 4032. It creates an interesting but mostly undesirable effect. ÄÄÄ 07h - Set Volume Ramp Start (Byte to u_DataHi) ÄÄÄ 08h - Set Volume Ramp End (Byte to u_DataHi) These two registers set the start and end volumes for the volume ramps. Note that only 8 bits per volume are sent, not 12 bits. The low 4 bits of the volumes should be stripped off. The Volume Ramp Start volume MUST be less than the Volume Ramp End volume even if ramping down. The bytes that will be output have this format: EEEEMMMM ÄÄÄ 09h - Set Current Volume (Word to u_DataLo) This is used to set the current volume for the active voice. Note that the volumes are not linear, but logarithmic. Volumes can range from 0-4095 but must be shifted up 4 bits. Bits 3-0 are not used, but bits 15-4 consist of the volume. The volume consists of a 4-bit exponent (E) and an 8-bit mantissa (M). EEEEMMMMMMMM---- As an example: Current volume value Output level ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ 1111111111110000 Max Volume 1110111111110000 Half Volume 1101111111110000 Quarter Volume 1100111111110000 Eighth Volume The mantissa is used to get a finer breakdown between the exponents. Example: mov dx,u_Voice mov al,4 ; Use voice #4. out dx,al mov dx,u_Command mov al,9 ; Set current volume. out dx,al mov dx,u_DataLo mov ax,0fff0h ; Set max volume. out dx,ax Again, it would be wise to create a volume table covering the range of your volumes. ÄÄÄ 0ah - Set Loop Begin Location (Word to u_DataLo) ÄÄÄ 0bh - Set Loop Begin Location (Word to u_DataLo) Through the use of these two registers, the beginning location for the active voice can be set. For an unknown reason, any memory addresses for the BEGIN, START, and END sample locations in DRAM must be divided by 128 and written to u_DataLo, then multiplied by 512 and written to u_DataLo. Note that this command is used to set the position of the pointer for the current voice also, even while playing. Just make sure that the voice is within the bounds you set. ÄÄÄ 0ch - Set Voice Balance (Byte to u_DataHi) This register will set the voice balance. Apparently there are 15 pan positions. However, this doesn't make sense since all the way left is 0, all the way right is 15, and the middle is 7. Regardless, this is how it works. Example: mov dx,u_Voice mov al,5 ; Use voice #5. out dx,al mov dx,u_Command mov al,0Ch ; Set Pan Position for voice 5. out dx,al mov dx,u_DataHi mov al,7 ; Put it in the middle. out dx,al ÄÄÄ 0dh - Set Volume Control Register (Byte to u_DataHi) ÚÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄÂÄÄÄ¿ ³ 7 ³ 6 ³ 5 ³ 4 ³ 3 ³ 2 ³ 1 ³ 0 ³ ÀÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÁÄÂÄÙ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ³ ÀÄÄÄÄ 1 = Ramp is stopped ³ ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄ 1 = Stop Ramp ³ ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄ ? ³ ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 0 = No loop, 1 = Loop ³ ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ 0 = Unidirectional, 1 = Bidirectional ³ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Enable volume ramp IRQ ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Direction (1 = decreasing) ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ? Example: mov dx,u_Voice mov al,1 ; Use voice #1. out dx,al mov dx,u_Command mov al,0dh ; Volume Control Register. out dx,al mov dx,u_DataHi mov al,00000011b ; Stop voice #1 ramp immediately. out dx,al ÄÄÄ 0eh - Set Highest Active Voices (Byte to u_DataHi) This will set the maximum number of voices the card will process. Apparently, the minimum number of voices is 14. Anything lower is automatically set to 14. Bear in mind that the more voices your application uses, not as much oversampling occurs. This byte MUST be OR'ed with 0C0h before output, and NumVoices must be one less than those desired! (i.e. 14 Voices is 13 NumVoices) Example: mov dx,u_Command mov al,0eh ; Set Highest Active Voice to: out dx,al mov dx,u_DataHi mov al,NumVoices or al,0C0h out dx,al ÄÄÄ 41h - DMA Control Register (Byte to u_DataHi) Input : Clear any pending DMA IRQs. Output: Unknown. ÄÄÄ 43h - Low Word of DRAM address (Word to u_DataLo) ÄÄÄ 44h - High Byte of DRAM address (Byte to u_DataHi) DRAM addresses can range from 00000h to fffffh. By outputting the DRAM address and then accessing u_DRAMIO, direct peeks and pokes from the DRAM memory can be accomplished. Example: mov dx,u_Command mov al,43h out dx,al mov dx,u_DataLo mov ax,@@LoDRAMAddress out dx,ax mov dx,u_Command mov al,44h out dx,al mov dx,u_DataHi mov al,@@HiDRAMAddress out dx,al mov dx,u_DRAMIO ; At this point, you can either: in al,u_DRAMIO ; Peek a byte from the address just output ; or: out dx,al ; Poke a byte to the address just output. ÄÄÄ 45h - Timer Control Register ??? (Byte to u_DataHi) Input : Clear any pending timer IRQs. Output: Something to do with Adlib Control. Hard coded into GUSMOD 1.2. ÄÄÄ 46h - Timer Speed Register ??? (Byte to u_DataHi) Used to set the internal 80 microsecond timer. Equation for output: (256-Desired value)*80 microseconds. ÄÄÄ 49h - Sample Control Register (Byte to u_DataHi) Input : Clear any pending Sample Control IRQs. Output: Unknown. ÄÄÄ 4Ch - Initialization Register (Byte to u_DataHi) If bit 1 is off, the Ultrasound is in an init state and cannot be accessed. ÄÄÄ 80h - Read Voice Mode (Byte from u_DataHi) Reads what was output to register 0, Write Voice Mode. ÄÄÄ 81h - Read Voice Frequency (Word from u_DataLo) An input from here will read the current voice's frequency. Information for conversion is contained in 01h - Set Voice Frequency. ÄÄÄ 82h - Read Loop Start Location (Word from u_DataLo) ÄÄÄ 83h - Read Loop Start Location (Word from u_DataLo) Reading these registers will return the loopstart for the active voice. Information on conversion is contained in register 8ah-8bh - Read Voice Position. ÄÄÄ 84h - Read Loop End Location (Word from u_DataLo) ÄÄÄ 85h - Read Loop End Location (Word from u_DataLo) Reading these registers will return the end location for the active voice. Information on conversion is contained in register 8ah-8bh - Read Voice Position. ÄÄÄ 86h - Read Volume Ramp Rate (Byte from u_DataHi) Reading this register will return the Volume Ramp Rate (described in register 06h - Set Volume Ramp Rate). ÄÄÄ 87h - Read Volume Ramp Start (Byte from u_DataHi) ÄÄÄ 88h - Read Volume Ramp End (Byte from u_DataHi) Reading these registers will return the Volume Ramp Start and End information set with registers 07h - Set Volume Ramp Start and 08h - Set Volume Ramp End. ÄÄÄ 89h - Read Volume (Word from u_DataLo) Reads what was output to register 9, Set Current Volume. ÄÄÄ 8ah - Read Voice Position (Word from u_DataLo) ÄÄÄ 8bh - Read Voice Position (Word from u_DataLo) Returns location of the current voice in DRAM that is the modified address (i.e. divided by 128, multiplied by 512). The following equation will convert it. LOC = ((TEMP0 << 7) | (TEMP1 >> 9)) Example: ; In: AX - Voice ; Out: DX:AX - Linear Position, not shifted position. U_ReadPos proc mov dx,u_Voice out dx,al mov dx,u_Command mov al,8ah out dx,al mov dx,u_DataLo in ax,dx ; TEMP0 mov cx,ax mov dx,u_Command mov al,8bh out dx,al mov dx,u_DataLo in ax,dx ; TEMP1 xor dx,dx mov bx,cx shl cx,7 shl dx,7 shr bx,9 or dx,bx shr ax,9 and ax,7Fh or cx,ax mov ax,cx ret U_ReadPos endp ÄÄÄ 8ch - Read Voice Balance (Byte from u_DataHi) This register will read the voice balance. More information is available about the returned result in register 0ch - Set Voice Balance. ÄÄÄ 8dh - Read Volume Control Register (Byte from u_DataHi) Reading this register will return a byte corresponding to the active voice's Volume Control information as described in register 0dh - Read Volume Control Register. ÄÄÄ 8eh - Read Highest Active Voice (Byte from u_DataHi) Will return a byte corresponding to the number of voices the card is mixing. Equation for English: Actual_Voices=(in 8eh)&0c0h+1. ÄÄÄ 8fh - IRQ Status Register (Byte from u_DataHi) Input : Unknown. Output: Unknown. ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 104h - Data Low Port (u_DataLo) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 105h - Data High Port (u_DataHi) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ BASE + 107h - DRAM IO Port (u_DRAMIO) ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ Techniques: ÄÄÄ Ultrasound Reset: mov bx,u_Command mov cx,u_DataHi mov dx,bx mov al,4Ch out dx,al mov dx,cx mov al,0 out dx,al @DELAY @DELAY mov dx,bx mov al,4Ch out dx,al mov dx,cx mov al,1 out dx,al @DELAY @DELAY mov dx,bx mov al,41h out dx,al mov dx,cx mov al,0 out dx,al mov dx,bx mov al,45h out dx,al mov dx,cx mov al,0 out dx,al mov dx,bx mov al,49h out dx,al mov dx,cx mov al,0 out dx,al mov dx,bx mov al,0Eh out dx,al add dx,2 mov al,MaxVoices or al,0C0h out dx,al mov dx,u_Status in al,dx mov dx,bx mov al,41h out dx,al mov dx,cx in al,dx mov dx,bx mov al,49h out dx,al mov dx,cx in al,dx mov dx,bx mov al,8Fh out dx,al mov dx,cx in al,dx push bx cx mov cx,0 @@VoiceClearLoop: mov dx,u_Voice mov al,cl out dx,al inc dx mov al,0 out dx,al add dx,2 mov al,3 ; Turn voice off out dx,al sub dx,2 mov al,0Dh ; Turn ramp off. out dx,al add dx,2 mov al,3 out dx,al inc cx cmp cx,32 jnz @@VoiceClearLoop pop cx bx mov dx,bx mov al,41h out dx,al mov dx,cx in al,dx mov dx,bx mov al,49h out dx,al mov dx,cx in al,dx mov dx,bx mov al,8Fh out dx,al mov dx,cx in al,dx mov dx,bx mov al,4Ch out dx,al mov dx,cx mov al,7 out dx,al ret ÄÄÄ Starting a Volume Ramp: 1) Determine the volume ramp points. 2) Set the current volume register. 3) Set start volume. 4) Set end volume. 5) Set rate. 6) Set control register bits. (bits 0 and 1 off) 7) Wait for bit 0 to turn on.