cregit-Linux how code gets into the kernel

Release 4.12 include/sound/emu10k1.h

Directory: include/sound
/*
 *  Copyright (c) by Jaroslav Kysela <perex@perex.cz>,
 *                   Creative Labs, Inc.
 *  Definitions for EMU10K1 (SB Live!) chips
 *
 *
 *   This program is free software; you can redistribute it and/or modify
 *   it under the terms of the GNU General Public License as published by
 *   the Free Software Foundation; either version 2 of the License, or
 *   (at your option) any later version.
 *
 *   This program is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU General Public License for more details.
 *
 *   You should have received a copy of the GNU General Public License
 *   along with this program; if not, write to the Free Software
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
 *
 */
#ifndef __SOUND_EMU10K1_H

#define __SOUND_EMU10K1_H


#include <sound/pcm.h>
#include <sound/rawmidi.h>
#include <sound/hwdep.h>
#include <sound/ac97_codec.h>
#include <sound/util_mem.h>
#include <sound/pcm-indirect.h>
#include <sound/timer.h>
#include <linux/interrupt.h>
#include <linux/mutex.h>
#include <linux/firmware.h>
#include <linux/io.h>

#include <uapi/sound/emu10k1.h>

/* ------------------- DEFINES -------------------- */


#define EMUPAGESIZE     4096

#define MAXREQVOICES    8

#define MAXPAGES0       4096	
/* 32 bit mode */

#define MAXPAGES1       8192	
/* 31 bit mode */

#define RESERVED        0

#define NUM_MIDI        16

#define NUM_G           64              
/* use all channels */

#define NUM_FXSENDS     4

#define NUM_EFX_PLAYBACK    16

/* FIXME? - according to the OSS driver the EMU10K1 needs a 29 bit DMA mask */

#define EMU10K1_DMA_MASK	0x7fffffffUL	
/* 31bit */

#define AUDIGY_DMA_MASK		0xffffffffUL	
/* 32bit mode */


#define TMEMSIZE        256*1024

#define TMEMSIZEREG     4


#define IP_TO_CP(ip) ((ip == 0) ? 0 : (((0x00001000uL | (ip & 0x00000FFFL)) << (((ip >> 12) & 0x000FL) + 4)) & 0xFFFF0000uL))

// Audigy specify registers are prefixed with 'A_'

/************************************************************************************************/
/* PCI function 0 registers, address = <val> + PCIBASE0                                         */
/************************************************************************************************/


#define PTR			0x00		
/* Indexed register set pointer register        */
						/* NOTE: The CHANNELNUM and ADDRESS words can   */
						/* be modified independently of each other.     */

#define PTR_CHANNELNUM_MASK	0x0000003f	
/* For each per-channel register, indicates the */
						/* channel number of the register to be         */
						/* accessed.  For non per-channel registers the */
						/* value should be set to zero.                 */

#define PTR_ADDRESS_MASK	0x07ff0000	
/* Register index                               */

#define A_PTR_ADDRESS_MASK	0x0fff0000


#define DATA			0x04		
/* Indexed register set data register           */


#define IPR			0x08		
/* Global interrupt pending register            */
						/* Clear pending interrupts by writing a 1 to   */
						/* the relevant bits and zero to the other bits */

#define IPR_P16V		0x80000000	
/* Bit set when the CA0151 P16V chip wishes
                                                   to interrupt */

#define IPR_GPIOMSG		0x20000000	
/* GPIO message interrupt (RE'd, still not sure 
                                                   which INTE bits enable it)                   */

/* The next two interrupts are for the midi port on the Audigy Drive (A_MPU1)                   */

#define IPR_A_MIDITRANSBUFEMPTY2 0x10000000	
/* MIDI UART transmit buffer empty              */

#define IPR_A_MIDIRECVBUFEMPTY2	0x08000000	
/* MIDI UART receive buffer empty               */


#define IPR_SPDIFBUFFULL	0x04000000	
/* SPDIF capture related, 10k2 only? (RE)       */

#define IPR_SPDIFBUFHALFFULL	0x02000000	
/* SPDIF capture related? (RE)                  */


#define IPR_SAMPLERATETRACKER	0x01000000	
/* Sample rate tracker lock status change       */

#define IPR_FXDSP		0x00800000	
/* Enable FX DSP interrupts                     */

#define IPR_FORCEINT		0x00400000	
/* Force Sound Blaster interrupt                */

#define IPR_PCIERROR		0x00200000	
/* PCI bus error                                */

#define IPR_VOLINCR		0x00100000	
/* Volume increment button pressed              */

#define IPR_VOLDECR		0x00080000	
/* Volume decrement button pressed              */

#define IPR_MUTE		0x00040000	
/* Mute button pressed                          */

#define IPR_MICBUFFULL		0x00020000	
/* Microphone buffer full                       */

#define IPR_MICBUFHALFFULL	0x00010000	
/* Microphone buffer half full                  */

#define IPR_ADCBUFFULL		0x00008000	
/* ADC buffer full                              */

#define IPR_ADCBUFHALFFULL	0x00004000	
/* ADC buffer half full                         */

#define IPR_EFXBUFFULL		0x00002000	
/* Effects buffer full                          */

#define IPR_EFXBUFHALFFULL	0x00001000	
/* Effects buffer half full                     */

#define IPR_GPSPDIFSTATUSCHANGE	0x00000800	
/* GPSPDIF channel status change                */

#define IPR_CDROMSTATUSCHANGE	0x00000400	
/* CD-ROM channel status change                 */

#define IPR_INTERVALTIMER	0x00000200	
/* Interval timer terminal count                */

#define IPR_MIDITRANSBUFEMPTY	0x00000100	
/* MIDI UART transmit buffer empty              */

#define IPR_MIDIRECVBUFEMPTY	0x00000080	
/* MIDI UART receive buffer empty               */

#define IPR_CHANNELLOOP		0x00000040	
/* Channel (half) loop interrupt(s) pending     */

#define IPR_CHANNELNUMBERMASK	0x0000003f	
/* When IPR_CHANNELLOOP is set, indicates the   */
						/* highest set channel in CLIPL, CLIPH, HLIPL,  */
						/* or HLIPH.  When IP is written with CL set,   */
						/* the bit in H/CLIPL or H/CLIPH corresponding  */
						/* to the CIN value written will be cleared.    */


#define INTE			0x0c		
/* Interrupt enable register                    */

#define INTE_VIRTUALSB_MASK	0xc0000000	
/* Virtual Soundblaster I/O port capture        */

#define INTE_VIRTUALSB_220	0x00000000	
/* Capture at I/O base address 0x220-0x22f      */

#define INTE_VIRTUALSB_240	0x40000000	
/* Capture at I/O base address 0x240            */

#define INTE_VIRTUALSB_260	0x80000000	
/* Capture at I/O base address 0x260            */

#define INTE_VIRTUALSB_280	0xc0000000	
/* Capture at I/O base address 0x280            */

#define INTE_VIRTUALMPU_MASK	0x30000000	
/* Virtual MPU I/O port capture                 */

#define INTE_VIRTUALMPU_300	0x00000000	
/* Capture at I/O base address 0x300-0x301      */

#define INTE_VIRTUALMPU_310	0x10000000	
/* Capture at I/O base address 0x310            */

#define INTE_VIRTUALMPU_320	0x20000000	
/* Capture at I/O base address 0x320            */

#define INTE_VIRTUALMPU_330	0x30000000	
/* Capture at I/O base address 0x330            */

#define INTE_MASTERDMAENABLE	0x08000000	
/* Master DMA emulation at 0x000-0x00f          */

#define INTE_SLAVEDMAENABLE	0x04000000	
/* Slave DMA emulation at 0x0c0-0x0df           */

#define INTE_MASTERPICENABLE	0x02000000	
/* Master PIC emulation at 0x020-0x021          */

#define INTE_SLAVEPICENABLE	0x01000000	
/* Slave PIC emulation at 0x0a0-0x0a1           */

#define INTE_VSBENABLE		0x00800000	
/* Enable virtual Soundblaster                  */

#define INTE_ADLIBENABLE	0x00400000	
/* Enable AdLib emulation at 0x388-0x38b        */

#define INTE_MPUENABLE		0x00200000	
/* Enable virtual MPU                           */

#define INTE_FORCEINT		0x00100000	
/* Continuously assert INTAN                    */


#define INTE_MRHANDENABLE	0x00080000	
/* Enable the "Mr. Hand" logic                  */
						/* NOTE: There is no reason to use this under   */
						/* Linux, and it will cause odd hardware        */
						/* behavior and possibly random segfaults and   */
						/* lockups if enabled.                          */

/* The next two interrupts are for the midi port on the Audigy Drive (A_MPU1)                   */

#define INTE_A_MIDITXENABLE2	0x00020000	
/* Enable MIDI transmit-buffer-empty interrupts */

#define INTE_A_MIDIRXENABLE2	0x00010000	
/* Enable MIDI receive-buffer-empty interrupts  */



#define INTE_SAMPLERATETRACKER	0x00002000	
/* Enable sample rate tracker interrupts        */
						/* NOTE: This bit must always be enabled        */

#define INTE_FXDSPENABLE	0x00001000	
/* Enable FX DSP interrupts                     */

#define INTE_PCIERRORENABLE	0x00000800	
/* Enable PCI bus error interrupts              */

#define INTE_VOLINCRENABLE	0x00000400	
/* Enable volume increment button interrupts    */

#define INTE_VOLDECRENABLE	0x00000200	
/* Enable volume decrement button interrupts    */

#define INTE_MUTEENABLE		0x00000100	
/* Enable mute button interrupts                */

#define INTE_MICBUFENABLE	0x00000080	
/* Enable microphone buffer interrupts          */

#define INTE_ADCBUFENABLE	0x00000040	
/* Enable ADC buffer interrupts                 */

#define INTE_EFXBUFENABLE	0x00000020	
/* Enable Effects buffer interrupts             */

#define INTE_GPSPDIFENABLE	0x00000010	
/* Enable GPSPDIF status interrupts             */

#define INTE_CDSPDIFENABLE	0x00000008	
/* Enable CDSPDIF status interrupts             */

#define INTE_INTERVALTIMERENB	0x00000004	
/* Enable interval timer interrupts             */

#define INTE_MIDITXENABLE	0x00000002	
/* Enable MIDI transmit-buffer-empty interrupts */

#define INTE_MIDIRXENABLE	0x00000001	
/* Enable MIDI receive-buffer-empty interrupts  */


#define WC			0x10		
/* Wall Clock register                          */

#define WC_SAMPLECOUNTER_MASK	0x03FFFFC0	
/* Sample periods elapsed since reset           */

#define WC_SAMPLECOUNTER	0x14060010

#define WC_CURRENTCHANNEL	0x0000003F	
/* Channel [0..63] currently being serviced     */
						/* NOTE: Each channel takes 1/64th of a sample  */
						/* period to be serviced.                       */


#define HCFG			0x14		
/* Hardware config register                     */
						/* NOTE: There is no reason to use the legacy   */
						/* SoundBlaster emulation stuff described below */
						/* under Linux, and all kinds of weird hardware */
						/* behavior can result if you try.  Don't.      */

#define HCFG_LEGACYFUNC_MASK	0xe0000000	
/* Legacy function number                       */

#define HCFG_LEGACYFUNC_MPU	0x00000000	
/* Legacy MPU                                   */

#define HCFG_LEGACYFUNC_SB	0x40000000	
/* Legacy SB                                    */

#define HCFG_LEGACYFUNC_AD	0x60000000	
/* Legacy AD                                    */

#define HCFG_LEGACYFUNC_MPIC	0x80000000	
/* Legacy MPIC                                  */

#define HCFG_LEGACYFUNC_MDMA	0xa0000000	
/* Legacy MDMA                                  */

#define HCFG_LEGACYFUNC_SPCI	0xc0000000	
/* Legacy SPCI                                  */

#define HCFG_LEGACYFUNC_SDMA	0xe0000000	
/* Legacy SDMA                                  */

#define HCFG_IOCAPTUREADDR	0x1f000000	
/* The 4 LSBs of the captured I/O address.      */

#define HCFG_LEGACYWRITE	0x00800000	
/* 1 = write, 0 = read                          */

#define HCFG_LEGACYWORD		0x00400000	
/* 1 = word, 0 = byte                           */

#define HCFG_LEGACYINT		0x00200000	
/* 1 = legacy event captured. Write 1 to clear. */
						/* NOTE: The rest of the bits in this register  */
						/* _are_ relevant under Linux.                  */

#define HCFG_PUSH_BUTTON_ENABLE 0x00100000	
/* Enables Volume Inc/Dec and Mute functions    */

#define HCFG_BAUD_RATE		0x00080000	
/* 0 = 48kHz, 1 = 44.1kHz                       */

#define HCFG_EXPANDED_MEM	0x00040000	
/* 1 = any 16M of 4G addr, 0 = 32M of 2G addr   */

#define HCFG_CODECFORMAT_MASK	0x00030000	
/* CODEC format                                 */

/* Specific to Alice2, CA0102 */

#define HCFG_CODECFORMAT_AC97_1	0x00000000	
/* AC97 CODEC format -- Ver 1.03                */

#define HCFG_CODECFORMAT_AC97_2	0x00010000	
/* AC97 CODEC format -- Ver 2.1                 */

#define HCFG_AUTOMUTE_ASYNC	0x00008000	
/* When set, the async sample rate convertors   */
						/* will automatically mute their output when    */
						/* they are not rate-locked to the external     */
						/* async audio source                           */

#define HCFG_AUTOMUTE_SPDIF	0x00004000	
/* When set, the async sample rate convertors   */
						/* will automatically mute their output when    */
						/* the SPDIF V-bit indicates invalid audio      */

#define HCFG_EMU32_SLAVE	0x00002000	
/* 0 = Master, 1 = Slave. Slave for EMU1010     */

#define HCFG_SLOW_RAMP		0x00001000	
/* Increases Send Smoothing time constant       */
/* 0x00000800 not used on Alice2 */

#define HCFG_PHASE_TRACK_MASK	0x00000700	
/* When set, forces corresponding input to      */
						/* phase track the previous input.              */
						/* I2S0 can phase track the last S/PDIF input   */

#define HCFG_I2S_ASRC_ENABLE	0x00000070	
/* When set, enables asynchronous sample rate   */
						/* conversion for the corresponding             */
 						/* I2S format input                             */
/* Rest of HCFG 0x0000000f same as below. LOCKSOUNDCACHE etc.  */



/* Older chips */

#define HCFG_CODECFORMAT_AC97	0x00000000	
/* AC97 CODEC format -- Primary Output          */

#define HCFG_CODECFORMAT_I2S	0x00010000	
/* I2S CODEC format -- Secondary (Rear) Output  */

#define HCFG_GPINPUT0		0x00004000	
/* External pin112                              */

#define HCFG_GPINPUT1		0x00002000	
/* External pin110                              */

#define HCFG_GPOUTPUT_MASK	0x00001c00	
/* External pins which may be controlled        */

#define HCFG_GPOUT0		0x00001000	
/* External pin? (spdif enable on 5.1)          */

#define HCFG_GPOUT1		0x00000800	
/* External pin? (IR)                           */

#define HCFG_GPOUT2		0x00000400	
/* External pin? (IR)                           */

#define HCFG_JOYENABLE      	0x00000200	
/* Internal joystick enable                     */

#define HCFG_PHASETRACKENABLE	0x00000100	
/* Phase tracking enable                        */
						/* 1 = Force all 3 async digital inputs to use  */
						/* the same async sample rate tracker (ZVIDEO)  */

#define HCFG_AC3ENABLE_MASK	0x000000e0	
/* AC3 async input control - Not implemented    */

#define HCFG_AC3ENABLE_ZVIDEO	0x00000080	
/* Channels 0 and 1 replace ZVIDEO              */

#define HCFG_AC3ENABLE_CDSPDIF	0x00000040	
/* Channels 0 and 1 replace CDSPDIF             */

#define HCFG_AC3ENABLE_GPSPDIF  0x00000020      
/* Channels 0 and 1 replace GPSPDIF             */

#define HCFG_AUTOMUTE		0x00000010	
/* When set, the async sample rate convertors   */
						/* will automatically mute their output when    */
						/* they are not rate-locked to the external     */
						/* async audio source                           */

#define HCFG_LOCKSOUNDCACHE	0x00000008	
/* 1 = Cancel bustmaster accesses to soundcache */
						/* NOTE: This should generally never be used.   */

#define HCFG_LOCKTANKCACHE_MASK	0x00000004	
/* 1 = Cancel bustmaster accesses to tankcache  */
						/* NOTE: This should generally never be used.   */

#define HCFG_LOCKTANKCACHE	0x01020014

#define HCFG_MUTEBUTTONENABLE	0x00000002	
/* 1 = Master mute button sets AUDIOENABLE = 0. */
						/* NOTE: This is a 'cheap' way to implement a   */
						/* master mute function on the mute button, and */
						/* in general should not be used unless a more  */
						/* sophisticated master mute function has not   */
						/* been written.                                */

#define HCFG_AUDIOENABLE	0x00000001	
/* 0 = CODECs transmit zero-valued samples      */
						/* Should be set to 1 when the EMU10K1 is       */
						/* completely initialized.                      */

//For Audigy, MPU port move to 0x70-0x74 ptr register


#define MUDATA			0x18		
/* MPU401 data register (8 bits)                */


#define MUCMD			0x19		
/* MPU401 command register (8 bits)             */

#define MUCMD_RESET		0xff		
/* RESET command                                */

#define MUCMD_ENTERUARTMODE	0x3f		
/* Enter_UART_mode command                      */
						/* NOTE: All other commands are ignored         */


#define MUSTAT			MUCMD		
/* MPU401 status register (8 bits)              */

#define MUSTAT_IRDYN		0x80		
/* 0 = MIDI data or command ACK                 */

#define MUSTAT_ORDYN		0x40		
/* 0 = MUDATA can accept a command or data      */


#define A_IOCFG			0x18		
/* GPIO on Audigy card (16bits)                 */

#define A_GPINPUT_MASK		0xff00

#define A_GPOUTPUT_MASK		0x00ff

// Audigy output/GPIO stuff taken from the kX drivers

#define A_IOCFG_GPOUT0		0x0044		
/* analog/digital                               */

#define A_IOCFG_DISABLE_ANALOG	0x0040		
/* = 'enable' for Audigy2 (chiprev=4)           */

#define A_IOCFG_ENABLE_DIGITAL	0x0004

#define A_IOCFG_ENABLE_DIGITAL_AUDIGY4	0x0080

#define A_IOCFG_UNKNOWN_20      0x0020

#define A_IOCFG_DISABLE_AC97_FRONT      0x0080  
/* turn off ac97 front -> front (10k2.1)        */

#define A_IOCFG_GPOUT1		0x0002		
/* IR? drive's internal bypass (?)              */

#define A_IOCFG_GPOUT2		0x0001		
/* IR */

#define A_IOCFG_MULTIPURPOSE_JACK	0x2000  
/* center+lfe+rear_center (a2/a2ex)             */
                                                /* + digital for generic 10k2                   */

#define A_IOCFG_DIGITAL_JACK    0x1000          
/* digital for a2 platinum                      */

#define A_IOCFG_FRONT_JACK      0x4000

#define A_IOCFG_REAR_JACK       0x8000

#define A_IOCFG_PHONES_JACK     0x0100          
/* LiveDrive                                    */

/* outputs:
 *      for audigy2 platinum:   0xa00
 *      for a2 platinum ex:     0x1c00
 *      for a1 platinum:        0x0
 */


#define TIMER			0x1a		
/* Timer terminal count register                */
						/* NOTE: After the rate is changed, a maximum   */
						/* of 1024 sample periods should be allowed     */
						/* before the new rate is guaranteed accurate.  */

#define TIMER_RATE_MASK		0x000003ff	
/* Timer interrupt rate in sample periods       */
						/* 0 == 1024 periods, [1..4] are not useful     */

#define TIMER_RATE		0x0a00001a


#define AC97DATA		0x1c		
/* AC97 register set data register (16 bit)     */


#define AC97ADDRESS		0x1e		
/* AC97 register set address register (8 bit)   */

#define AC97ADDRESS_READY	0x80		
/* Read-only bit, reflects CODEC READY signal   */

#define AC97ADDRESS_ADDRESS	0x7f		
/* Address of indexed AC97 register             */

/* Available on the Audigy 2 and Audigy 4 only. This is the P16V chip. */

#define PTR2			0x20		
/* Indexed register set pointer register        */

#define DATA2			0x24		
/* Indexed register set data register           */

#define IPR2			0x28		
/* P16V interrupt pending register              */

#define IPR2_PLAYBACK_CH_0_LOOP      0x00001000 
/* Playback Channel 0 loop                               */

#define IPR2_PLAYBACK_CH_0_HALF_LOOP 0x00000100 
/* Playback Channel 0 half loop                          */

#define IPR2_CAPTURE_CH_0_LOOP       0x00100000 
/* Capture Channel 0 loop                               */

#define IPR2_CAPTURE_CH_0_HALF_LOOP  0x00010000 
/* Capture Channel 0 half loop                          */
						/* 0x00000100 Playback. Only in once per period.
                                                 * 0x00110000 Capture. Int on half buffer.
                                                 */

#define INTE2			0x2c		
/* P16V Interrupt enable register.      */

#define INTE2_PLAYBACK_CH_0_LOOP      0x00001000 
/* Playback Channel 0 loop                               */

#define INTE2_PLAYBACK_CH_0_HALF_LOOP 0x00000100 
/* Playback Channel 0 half loop                          */

#define INTE2_PLAYBACK_CH_1_LOOP      0x00002000 
/* Playback Channel 1 loop                               */

#define INTE2_PLAYBACK_CH_1_HALF_LOOP 0x00000200 
/* Playback Channel 1 half loop                          */

#define INTE2_PLAYBACK_CH_2_LOOP      0x00004000 
/* Playback Channel 2 loop                               */

#define INTE2_PLAYBACK_CH_2_HALF_LOOP 0x00000400 
/* Playback Channel 2 half loop                          */

#define INTE2_PLAYBACK_CH_3_LOOP      0x00008000 
/* Playback Channel 3 loop                               */

#define INTE2_PLAYBACK_CH_3_HALF_LOOP 0x00000800 
/* Playback Channel 3 half loop                          */

#define INTE2_CAPTURE_CH_0_LOOP       0x00100000 
/* Capture Channel 0 loop                               */

#define INTE2_CAPTURE_CH_0_HALF_LOOP  0x00010000 
/* Caputre Channel 0 half loop                          */

#define HCFG2			0x34		
/* Defaults: 0, win2000 sets it to 00004201 */
						/* 0x00000000 2-channel output. */
						/* 0x00000200 8-channel output. */
						/* 0x00000004 pauses stream/irq fail. */
						/* Rest of bits no nothing to sound output */
						/* bit 0: Enable P16V audio.
                                                 * bit 1: Lock P16V record memory cache.
                                                 * bit 2: Lock P16V playback memory cache.
                                                 * bit 3: Dummy record insert zero samples.
                                                 * bit 8: Record 8-channel in phase.
                                                 * bit 9: Playback 8-channel in phase.
                                                 * bit 11-12: Playback mixer attenuation: 0=0dB, 1=-6dB, 2=-12dB, 3=Mute.
                                                 * bit 13: Playback mixer enable.
                                                 * bit 14: Route SRC48 mixer output to fx engine.
                                                 * bit 15: Enable IEEE 1394 chip.
                                                 */

#define IPR3			0x38		
/* Cdif interrupt pending register              */

#define INTE3			0x3c		
/* Cdif interrupt enable register.      */
/************************************************************************************************/
/* PCI function 1 registers, address = <val> + PCIBASE1                                         */
/************************************************************************************************/


#define JOYSTICK1		0x00		
/* Analog joystick port register                */

#define JOYSTICK2		0x01		
/* Analog joystick port register                */

#define JOYSTICK3		0x02		
/* Analog joystick port register                */

#define JOYSTICK4		0x03		
/* Analog joystick port register                */

#define JOYSTICK5		0x04		
/* Analog joystick port register                */

#define JOYSTICK6		0x05		
/* Analog joystick port register                */

#define JOYSTICK7		0x06		
/* Analog joystick port register                */

#define JOYSTICK8		0x07		
/* Analog joystick port register                */

/* When writing, any write causes JOYSTICK_COMPARATOR output enable to be pulsed on write.      */
/* When reading, use these bitfields: */

#define JOYSTICK_BUTTONS	0x0f		
/* Joystick button data                         */

#define JOYSTICK_COMPARATOR	0xf0		
/* Joystick comparator data                     */


/********************************************************************************************************/
/* Emu10k1 pointer-offset register set, accessed through the PTR and DATA registers                     */
/********************************************************************************************************/


#define CPF			0x00		
/* Current pitch and fraction register                  */

#define CPF_CURRENTPITCH_MASK	0xffff0000	
/* Current pitch (linear, 0x4000 == unity pitch shift)  */

#define CPF_CURRENTPITCH	0x10100000

#define CPF_STEREO_MASK		0x00008000	
/* 1 = Even channel interleave, odd channel locked      */

#define CPF_STOP_MASK		0x00004000	
/* 1 = Current pitch forced to 0                        */

#define CPF_FRACADDRESS_MASK	0x00003fff	
/* Linear fractional address of the current channel     */


#define PTRX			0x01		
/* Pitch target and send A/B amounts register           */

#define PTRX_PITCHTARGET_MASK	0xffff0000	
/* Pitch target of specified channel                    */

#define PTRX_PITCHTARGET	0x10100001

#define PTRX_FXSENDAMOUNT_A_MASK 0x0000ff00	
/* Linear level of channel output sent to FX send bus A */

#define PTRX_FXSENDAMOUNT_A	0x08080001

#define PTRX_FXSENDAMOUNT_B_MASK 0x000000ff	
/* Linear level of channel output sent to FX send bus B */

#define PTRX_FXSENDAMOUNT_B	0x08000001


#define CVCF			0x02		
/* Current volume and filter cutoff register            */

#define CVCF_CURRENTVOL_MASK	0xffff0000	
/* Current linear volume of specified channel           */

#define CVCF_CURRENTVOL		0x10100002

#define CVCF_CURRENTFILTER_MASK	0x0000ffff	
/* Current filter cutoff frequency of specified channel */

#define CVCF_CURRENTFILTER	0x10000002


#define VTFT			0x03		
/* Volume target and filter cutoff target register      */

#define VTFT_VOLUMETARGET_MASK	0xffff0000	
/* Volume target of specified channel                   */

#define VTFT_VOLUMETARGET	0x10100003

#define VTFT_FILTERTARGET_MASK	0x0000ffff	
/* Filter cutoff target of specified channel            */

#define VTFT_FILTERTARGET	0x10000003


#define Z1			0x05		
/* Filter delay memory 1 register                       */


#define Z2			0x04		
/* Filter delay memory 2 register                       */


#define PSST			0x06		
/* Send C amount and loop start address register        */

#define PSST_FXSENDAMOUNT_C_MASK 0xff000000	
/* Linear level of channel output sent to FX send bus C */


#define PSST_FXSENDAMOUNT_C	0x08180006


#define PSST_LOOPSTARTADDR_MASK	0x00ffffff	
/* Loop start address of the specified channel          */

#define PSST_LOOPSTARTADDR	0x18000006


#define DSL			0x07		
/* Send D amount and loop start address register        */

#define DSL_FXSENDAMOUNT_D_MASK	0xff000000	
/* Linear level of channel output sent to FX send bus D */


#define DSL_FXSENDAMOUNT_D	0x08180007


#define DSL_LOOPENDADDR_MASK	0x00ffffff	
/* Loop end address of the specified channel            */

#define DSL_LOOPENDADDR		0x18000007


#define CCCA			0x08		
/* Filter Q, interp. ROM, byte size, cur. addr register */

#define CCCA_RESONANCE		0xf0000000	
/* Lowpass filter resonance (Q) height                  */

#define CCCA_INTERPROMMASK	0x0e000000	
/* Selects passband of interpolation ROM                */
						/* 1 == full band, 7 == lowpass                         */
						/* ROM 0 is used when pitch shifting downward or less   */
						/* then 3 semitones upward.  Increasingly higher ROM    */
						/* numbers are used, typically in steps of 3 semitones, */
						/* as upward pitch shifting is performed.               */

#define CCCA_INTERPROM_0	0x00000000	
/* Select interpolation ROM 0                           */

#define CCCA_INTERPROM_1	0x02000000	
/* Select interpolation ROM 1                           */

#define CCCA_INTERPROM_2	0x04000000	
/* Select interpolation ROM 2                           */

#define CCCA_INTERPROM_3	0x06000000	
/* Select interpolation ROM 3                           */

#define CCCA_INTERPROM_4	0x08000000	
/* Select interpolation ROM 4                           */

#define CCCA_INTERPROM_5	0x0a000000	
/* Select interpolation ROM 5                           */

#define CCCA_INTERPROM_6	0x0c000000	
/* Select interpolation ROM 6                           */

#define CCCA_INTERPROM_7	0x0e000000	
/* Select interpolation ROM 7                           */

#define CCCA_8BITSELECT		0x01000000	
/* 1 = Sound memory for this channel uses 8-bit samples */

#define CCCA_CURRADDR_MASK	0x00ffffff	
/* Current address of the selected channel              */

#define CCCA_CURRADDR		0x18000008


#define CCR			0x09		
/* Cache control register                               */

#define CCR_CACHEINVALIDSIZE	0x07190009

#define CCR_CACHEINVALIDSIZE_MASK	0xfe000000	
/* Number of invalid samples cache for this channel     */

#define CCR_CACHELOOPFLAG	0x01000000	
/* 1 = Cache has a loop service pending                 */

#define CCR_INTERLEAVEDSAMPLES	0x00800000	
/* 1 = A cache service will fetch interleaved samples   */

#define CCR_WORDSIZEDSAMPLES	0x00400000	
/* 1 = A cache service will fetch word sized samples    */

#define CCR_READADDRESS		0x06100009

#define CCR_READADDRESS_MASK	0x003f0000	
/* Location of cache just beyond current cache service  */

#define CCR_LOOPINVALSIZE	0x0000fe00	
/* Number of invalid samples in cache prior to loop     */
						/* NOTE: This is valid only if CACHELOOPFLAG is set     */

#define CCR_LOOPFLAG		0x00000100	
/* Set for a single sample period when a loop occurs    */

#define CCR_CACHELOOPADDRHI	0x000000ff	
/* DSL_LOOPSTARTADDR's hi byte if CACHELOOPFLAG is set  */


#define CLP			0x0a		
/* Cache loop register (valid if CCR_CACHELOOPFLAG = 1) */
						/* NOTE: This register is normally not used             */

#define CLP_CACHELOOPADDR	0x0000ffff	
/* Cache loop address (DSL_LOOPSTARTADDR [0..15])       */


#define FXRT			0x0b		
/* Effects send routing register                        */
						/* NOTE: It is illegal to assign the same routing to    */
						/* two effects sends.                                   */

#define FXRT_CHANNELA		0x000f0000	
/* Effects send bus number for channel's effects send A */

#define FXRT_CHANNELB		0x00f00000	
/* Effects send bus number for channel's effects send B */

#define FXRT_CHANNELC		0x0f000000	
/* Effects send bus number for channel's effects send C */

#define FXRT_CHANNELD		0xf0000000	
/* Effects send bus number for channel's effects send D */


#define A_HR			0x0b	
/* High Resolution. 24bit playback from host to DSP. */

#define MAPA			0x0c		
/* Cache map A                                          */


#define MAPB			0x0d		
/* Cache map B                                          */


#define MAP_PTE_MASK0		0xfffff000	
/* The 20 MSBs of the PTE indexed by the PTI            */

#define MAP_PTI_MASK0		0x00000fff	
/* The 12 bit index to one of the 4096 PTE dwords       */


#define MAP_PTE_MASK1		0xffffe000	
/* The 19 MSBs of the PTE indexed by the PTI            */

#define MAP_PTI_MASK1		0x00001fff	
/* The 13 bit index to one of the 8192 PTE dwords       */

/* 0x0e, 0x0f: Not used */


#define ENVVOL			0x10		
/* Volume envelope register                             */

#define ENVVOL_MASK		0x0000ffff	
/* Current value of volume envelope state variable      */  
						/* 0x8000-n == 666*n usec delay                         */


#define ATKHLDV 		0x11		
/* Volume envelope hold and attack register             */

#define ATKHLDV_PHASE0		0x00008000	
/* 0 = Begin attack phase                               */

#define ATKHLDV_HOLDTIME_MASK	0x00007f00	
/* Envelope hold time (127-n == n*88.2msec)             */

#define ATKHLDV_ATTACKTIME_MASK	0x0000007f	
/* Envelope attack time, log encoded                    */
						/* 0 = infinite, 1 = 10.9msec, ... 0x7f = 5.5msec       */


#define DCYSUSV 		0x12		
/* Volume envelope sustain and decay register           */

#define DCYSUSV_PHASE1_MASK	0x00008000	
/* 0 = Begin attack phase, 1 = begin release phase      */

#define DCYSUSV_SUSTAINLEVEL_MASK 0x00007f00	
/* 127 = full, 0 = off, 0.75dB increments               */

#define DCYSUSV_CHANNELENABLE_MASK 0x00000080	
/* 1 = Inhibit envelope engine from writing values in   */
						/* this channel and from writing to pitch, filter and   */
						/* volume targets.                                      */

#define DCYSUSV_DECAYTIME_MASK	0x0000007f	
/* Volume envelope decay time, log encoded              */
						/* 0 = 43.7msec, 1 = 21.8msec, 0x7f = 22msec            */


#define LFOVAL1 		0x13		
/* Modulation LFO value                                 */

#define LFOVAL_MASK		0x0000ffff	
/* Current value of modulation LFO state variable       */
						/* 0x8000-n == 666*n usec delay                         */


#define ENVVAL			0x14		
/* Modulation envelope register                         */

#define ENVVAL_MASK		0x0000ffff	
/* Current value of modulation envelope state variable  */
						/* 0x8000-n == 666*n usec delay                         */


#define ATKHLDM			0x15		
/* Modulation envelope hold and attack register         */

#define ATKHLDM_PHASE0		0x00008000	
/* 0 = Begin attack phase                               */

#define ATKHLDM_HOLDTIME	0x00007f00	
/* Envelope hold time (127-n == n*42msec)               */

#define ATKHLDM_ATTACKTIME	0x0000007f	
/* Envelope attack time, log encoded                    */
						/* 0 = infinite, 1 = 11msec, ... 0x7f = 5.5msec         */


#define DCYSUSM			0x16		
/* Modulation envelope decay and sustain register       */

#define DCYSUSM_PHASE1_MASK	0x00008000	
/* 0 = Begin attack phase, 1 = begin release phase      */

#define DCYSUSM_SUSTAINLEVEL_MASK 0x00007f00	
/* 127 = full, 0 = off, 0.75dB increments               */

#define DCYSUSM_DECAYTIME_MASK	0x0000007f	
/* Envelope decay time, log encoded                     */
						/* 0 = 43.7msec, 1 = 21.8msec, 0x7f = 22msec            */


#define LFOVAL2 		0x17		
/* Vibrato LFO register                                 */

#define LFOVAL2_MASK		0x0000ffff	
/* Current value of vibrato LFO state variable          */
						/* 0x8000-n == 666*n usec delay                         */


#define IP			0x18		
/* Initial pitch register                               */

#define IP_MASK			0x0000ffff	
/* Exponential initial pitch shift                      */
						/* 4 bits of octave, 12 bits of fractional octave       */

#define IP_UNITY		0x0000e000	
/* Unity pitch shift                                    */


#define IFATN			0x19		
/* Initial filter cutoff and attenuation register       */

#define IFATN_FILTERCUTOFF_MASK	0x0000ff00	
/* Initial filter cutoff frequency in exponential units */
						/* 6 most significant bits are semitones                */
						/* 2 least significant bits are fractions               */

#define IFATN_FILTERCUTOFF	0x08080019

#define IFATN_ATTENUATION_MASK	0x000000ff	
/* Initial attenuation in 0.375dB steps                 */

#define IFATN_ATTENUATION	0x08000019



#define PEFE			0x1a		
/* Pitch envelope and filter envelope amount register   */

#define PEFE_PITCHAMOUNT_MASK	0x0000ff00	
/* Pitch envlope amount                                 */
						/* Signed 2's complement, +/- one octave peak extremes  */

#define PEFE_PITCHAMOUNT	0x0808001a

#define PEFE_FILTERAMOUNT_MASK	0x000000ff	
/* Filter envlope amount                                */
						/* Signed 2's complement, +/- six octaves peak extremes */

#define PEFE_FILTERAMOUNT	0x0800001a

#define FMMOD			0x1b		
/* Vibrato/filter modulation from LFO register          */

#define FMMOD_MODVIBRATO	0x0000ff00	
/* Vibrato LFO modulation depth                         */
						/* Signed 2's complement, +/- one octave extremes       */

#define FMMOD_MOFILTER		0x000000ff	
/* Filter LFO modulation depth                          */
						/* Signed 2's complement, +/- three octave extremes     */



#define TREMFRQ 		0x1c		
/* Tremolo amount and modulation LFO frequency register */

#define TREMFRQ_DEPTH		0x0000ff00	
/* Tremolo depth                                        */
						/* Signed 2's complement, with +/- 12dB extremes        */


#define TREMFRQ_FREQUENCY	0x000000ff	
/* Tremolo LFO frequency                                */
						/* ??Hz steps, maximum of ?? Hz.                        */

#define FM2FRQ2 		0x1d		
/* Vibrato amount and vibrato LFO frequency register    */

#define FM2FRQ2_DEPTH		0x0000ff00	
/* Vibrato LFO vibrato depth                            */
						/* Signed 2's complement, +/- one octave extremes       */

#define FM2FRQ2_FREQUENCY	0x000000ff	
/* Vibrato LFO frequency                                */
						/* 0.039Hz steps, maximum of 9.85 Hz.                   */


#define TEMPENV 		0x1e		
/* Tempory envelope register                            */

#define TEMPENV_MASK		0x0000ffff	
/* 16-bit value                                         */
						/* NOTE: All channels contain internal variables; do    */
						/* not write to these locations.                        */

/* 0x1f: not used */


#define CD0			0x20		
/* Cache data 0 register                                */

#define CD1			0x21		
/* Cache data 1 register                                */

#define CD2			0x22		
/* Cache data 2 register                                */

#define CD3			0x23		
/* Cache data 3 register                                */

#define CD4			0x24		
/* Cache data 4 register                                */

#define CD5			0x25		
/* Cache data 5 register                                */

#define CD6			0x26		
/* Cache data 6 register                                */

#define CD7			0x27		
/* Cache data 7 register                                */

#define CD8			0x28		
/* Cache data 8 register                                */

#define CD9			0x29		
/* Cache data 9 register                                */

#define CDA			0x2a		
/* Cache data A register                                */

#define CDB			0x2b		
/* Cache data B register                                */

#define CDC			0x2c		
/* Cache data C register                                */

#define CDD			0x2d		
/* Cache data D register                                */

#define CDE			0x2e		
/* Cache data E register                                */

#define CDF			0x2f		
/* Cache data F register                                */

/* 0x30-3f seem to be the same as 0x20-2f */


#define PTB			0x40		
/* Page table base register                             */

#define PTB_MASK		0xfffff000	
/* Physical address of the page table in host memory    */


#define TCB			0x41		
/* Tank cache base register                             */

#define TCB_MASK		0xfffff000	
/* Physical address of the bottom of host based TRAM    */


#define ADCCR			0x42		
/* ADC sample rate/stereo control register              */

#define ADCCR_RCHANENABLE	0x00000010	
/* Enables right channel for writing to the host        */

#define ADCCR_LCHANENABLE	0x00000008	
/* Enables left channel for writing to the host         */
						/* NOTE: To guarantee phase coherency, both channels    */
						/* must be disabled prior to enabling both channels.    */

#define A_ADCCR_RCHANENABLE	0x00000020

#define A_ADCCR_LCHANENABLE	0x00000010


#define A_ADCCR_SAMPLERATE_MASK 0x0000000F      
/* Audigy sample rate convertor output rate             */

#define ADCCR_SAMPLERATE_MASK	0x00000007	
/* Sample rate convertor output rate                    */

#define ADCCR_SAMPLERATE_48	0x00000000	
/* 48kHz sample rate                                    */

#define ADCCR_SAMPLERATE_44	0x00000001	
/* 44.1kHz sample rate                                  */

#define ADCCR_SAMPLERATE_32	0x00000002	
/* 32kHz sample rate                                    */

#define ADCCR_SAMPLERATE_24	0x00000003	
/* 24kHz sample rate                                    */

#define ADCCR_SAMPLERATE_22	0x00000004	
/* 22.05kHz sample rate                                 */

#define ADCCR_SAMPLERATE_16	0x00000005	
/* 16kHz sample rate                                    */

#define ADCCR_SAMPLERATE_11	0x00000006	
/* 11.025kHz sample rate                                */

#define ADCCR_SAMPLERATE_8	0x00000007	
/* 8kHz sample rate                                     */

#define A_ADCCR_SAMPLERATE_12	0x00000006	
/* 12kHz sample rate                                    */

#define A_ADCCR_SAMPLERATE_11	0x00000007	
/* 11.025kHz sample rate                                */

#define A_ADCCR_SAMPLERATE_8	0x00000008	
/* 8kHz sample rate                                     */


#define FXWC			0x43		
/* FX output write channels register                    */
						/* When set, each bit enables the writing of the        */
						/* corresponding FX output channel (internal registers  */
						/* 0x20-0x3f) to host memory.  This mode of recording   */
						/* is 16bit, 48KHz only. All 32 channels can be enabled */
						/* simultaneously.                                      */


#define FXWC_DEFAULTROUTE_C     (1<<0)		
/* left emu out? */

#define FXWC_DEFAULTROUTE_B     (1<<1)		
/* right emu out? */

#define FXWC_DEFAULTROUTE_A     (1<<12)

#define FXWC_DEFAULTROUTE_D     (1<<13)

#define FXWC_ADCLEFT            (1<<18)

#define FXWC_CDROMSPDIFLEFT     (1<<18)

#define FXWC_ADCRIGHT           (1<<19)

#define FXWC_CDROMSPDIFRIGHT    (1<<19)

#define FXWC_MIC                (1<<20)

#define FXWC_ZOOMLEFT           (1<<20)

#define FXWC_ZOOMRIGHT          (1<<21)

#define FXWC_SPDIFLEFT          (1<<22)		
/* 0x00400000 */

#define FXWC_SPDIFRIGHT         (1<<23)		
/* 0x00800000 */


#define A_TBLSZ			0x43	
/* Effects Tank Internal Table Size. Only low byte or register used */


#define TCBS			0x44		
/* Tank cache buffer size register                      */

#define TCBS_MASK		0x00000007	
/* Tank cache buffer size field                         */

#define TCBS_BUFFSIZE_16K	0x00000000

#define TCBS_BUFFSIZE_32K	0x00000001

#define TCBS_BUFFSIZE_64K	0x00000002

#define TCBS_BUFFSIZE_128K	0x00000003

#define TCBS_BUFFSIZE_256K	0x00000004

#define TCBS_BUFFSIZE_512K	0x00000005

#define TCBS_BUFFSIZE_1024K	0x00000006

#define TCBS_BUFFSIZE_2048K	0x00000007


#define MICBA			0x45		
/* AC97 microphone buffer address register              */

#define MICBA_MASK		0xfffff000	
/* 20 bit base address                                  */


#define ADCBA			0x46		
/* ADC buffer address register                          */

#define ADCBA_MASK		0xfffff000	
/* 20 bit base address                                  */


#define FXBA			0x47		
/* FX Buffer Address */

#define FXBA_MASK		0xfffff000	
/* 20 bit base address                                  */


#define A_HWM			0x48	
/* High PCI Water Mark - word access, defaults to 3f */


#define MICBS			0x49		
/* Microphone buffer size register                      */


#define ADCBS			0x4a		
/* ADC buffer size register                             */


#define FXBS			0x4b		
/* FX buffer size register                              */

/* register: 0x4c..4f: ffff-ffff current amounts, per-channel */

/* The following mask values define the size of the ADC, MIX and FX buffers in bytes */

#define ADCBS_BUFSIZE_NONE	0x00000000

#define ADCBS_BUFSIZE_384	0x00000001

#define ADCBS_BUFSIZE_448	0x00000002

#define ADCBS_BUFSIZE_512	0x00000003

#define ADCBS_BUFSIZE_640	0x00000004

#define ADCBS_BUFSIZE_768	0x00000005

#define ADCBS_BUFSIZE_896	0x00000006

#define ADCBS_BUFSIZE_1024	0x00000007

#define ADCBS_BUFSIZE_1280	0x00000008

#define ADCBS_BUFSIZE_1536	0x00000009

#define ADCBS_BUFSIZE_1792	0x0000000a

#define ADCBS_BUFSIZE_2048	0x0000000b

#define ADCBS_BUFSIZE_2560	0x0000000c

#define ADCBS_BUFSIZE_3072	0x0000000d

#define ADCBS_BUFSIZE_3584	0x0000000e

#define ADCBS_BUFSIZE_4096	0x0000000f

#define ADCBS_BUFSIZE_5120	0x00000010

#define ADCBS_BUFSIZE_6144	0x00000011

#define ADCBS_BUFSIZE_7168	0x00000012

#define ADCBS_BUFSIZE_8192	0x00000013

#define ADCBS_BUFSIZE_10240	0x00000014

#define ADCBS_BUFSIZE_12288	0x00000015

#define ADCBS_BUFSIZE_14366	0x00000016

#define ADCBS_BUFSIZE_16384	0x00000017

#define ADCBS_BUFSIZE_20480	0x00000018

#define ADCBS_BUFSIZE_24576	0x00000019

#define ADCBS_BUFSIZE_28672	0x0000001a

#define ADCBS_BUFSIZE_32768	0x0000001b