Annotation of sys/dev/pci/esoreg.h, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: esoreg.h,v 1.1 1999/08/04 23:38:03 niklas Exp $ */
! 2: /* $NetBSD: esoreg.h,v 1.1 1999/07/12 15:13:31 kleink Exp $ */
! 3:
! 4: /*
! 5: * Copyright (c) 1999 Klaus J. Klein
! 6: * All rights reserved.
! 7: *
! 8: * Redistribution and use in source and binary forms, with or without
! 9: * modification, are permitted provided that the following conditions
! 10: * are met:
! 11: * 1. Redistributions of source code must retain the above copyright
! 12: * notice, this list of conditions and the following disclaimer.
! 13: * 2. Redistributions in binary form must reproduce the above copyright
! 14: * notice, this list of conditions and the following disclaimer in the
! 15: * documentation and/or other materials provided with the distribution.
! 16: * 3. The name of the author may not be used to endorse or promote products
! 17: * derived from this software without specific prior written permission.
! 18: *
! 19: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
! 20: * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
! 21: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
! 22: * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
! 23: * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
! 24: * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
! 25: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
! 26: * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
! 27: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 28: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 29: * SUCH DAMAGE.
! 30: */
! 31:
! 32: #ifndef _DEV_PCI_ESOREG_H_
! 33: #define _DEV_PCI_ESOREG_H_
! 34:
! 35: /*
! 36: * PCI Configuration Registers
! 37: */
! 38: #define ESO_PCI_BAR_IO 0x10 /* I/O space base address */
! 39: #define ESO_PCI_BAR_SB 0x14 /* SB I/O space base address */
! 40: #define ESO_PCI_BAR_VC 0x18 /* VC I/O space base address */
! 41: #define ESO_PCI_BAR_MPU 0x1c /* MPU-401 I/O space base address */
! 42: #define ESO_PCI_BAR_GAME 0x20 /* Game port I/O space base address */
! 43: #define ESO_PCI_S1C 0x50 /* Solo-1 Configuration */
! 44: #define ESO_PCI_S1C_IRQP_MASK 0x0006000 /* ISA IRQ emulation policy */
! 45: #define ESO_PCI_S1C_DMAP_MASK 0x0000700 /* DMA policy */
! 46: #define ESO_PCI_DDMAC 0x60 /* DDMA Control base address */
! 47: #define ESO_PCI_DDMAC_DE 0x01 /* Distributed DMA enable */
! 48:
! 49: /* PCI Revision IDs of the Solo-1 PCI AudioDrive family */
! 50: #define ESO_PCI_REVISION_ES1938 0x00 /* ES1938 */
! 51: #define ESO_PCI_REVISION_ES1946 0x01 /* ES1946 */
! 52:
! 53: /*
! 54: * Check the validity of a PCI I/O space base address for use in
! 55: * ESO_PCI_DDMAC; see the relevant comment in the attach function.
! 56: */
! 57: #define ESO_VALID_DDMAC_BASE(addr) \
! 58: (((addr) & 0x03ff) != 0)
! 59:
! 60: /*
! 61: * I/O Port offsets
! 62: */
! 63: /* I/O Device ports */
! 64: #define ESO_IO_A2DMAA 0x00 /* [RW] Audio 2 b/c DMA address */
! 65: #define ESO_IO_A2DMAC 0x04 /* [RW] Audio 2 b/c DMA count */
! 66: #define ESO_IO_A2DMAM 0x06 /* [RW] Solo-1 mode register */
! 67: #define ESO_IO_A2DMAM_DMAENB 0x02 /* DMA enable */
! 68: #define ESO_IO_A2DMAM_AUTO 0x08 /* Auto-Initialize DMA enable */
! 69: #define ESO_IO_IRQCTL 0x07 /* [RW] IRQ control register */
! 70: #define ESO_IO_IRQCTL_A1IRQ 0x10 /* Audio 1 IRQ */
! 71: #define ESO_IO_IRQCTL_A2IRQ 0x20 /* Audio 2 IRQ */
! 72: #define ESO_IO_IRQCTL_HVIRQ 0x40 /* Hardware volume IRQ */
! 73: #define ESO_IO_IRQCTL_MPUIRQ 0x80 /* MPU-401 IRQ */
! 74: #define ESO_IO_IRQCTL_MASK 0xf0 /* all of the above */
! 75:
! 76: /* Audio/FM Device ports */
! 77: #define ESO_SB_STATUS 0x00 /* [R] FM Status */
! 78: #define ESO_SB_LBA 0x00 /* [W] FM Low Bank Address */
! 79: #define ESO_SB_LBDW 0x01 /* [W] FM Low Bank Data Write */
! 80: #define ESO_SB_HBA 0x02 /* [W] FM High Bank Address */
! 81: #define ESO_SB_HBDW 0x03 /* [W] FM High Bank Data Write */
! 82: #define ESO_SB_MIXERADDR 0x04 /* [RW] Mixer Address Register */
! 83: #define ESO_SB_MIXERDATA 0x05 /* [RW] Mixer Data Register */
! 84: #define ESO_SB_RESET 0x06 /* [W] Reset */
! 85: #define ESO_SB_RESET_SW 0x01 /* SW Reset */
! 86: #define ESO_SB_RESET_FIFO 0x02 /* FIFO Reset */
! 87: #define ESO_SB_STATUSFLAGS 0x06 /* [R] Status Flags */
! 88: #define ESO_SB_PMR 0x07 /* [RW] Power Management Register */
! 89: #define ESO_SB_RDR 0x0a /* [R] Read Data Register */
! 90: #define ESO_SB_RDR_RESETMAGIC 0xaa /* Indicates SW reset completion */
! 91: #define ESO_SB_WDR 0x0c /* [W] Write Data Register */
! 92: #define ESO_SB_RSR 0x0c /* [R] Read Status Register */
! 93: #define ESO_SB_RSR_BUSY 0x80 /* WDR not available or Solo-1 busy */
! 94: #define ESO_SB_RBSR 0x0e /* [R] Read Buffer Status Register */
! 95: #define ESO_SB_RBSR_RDAV 0x80 /* Data available in RDR */
! 96: #define ESO_SB_PIOAFR 0x0f /* [RW] PIO Access to FIFO Register */
! 97:
! 98: /* (Audio 1) DMAC Device ports */
! 99: #define ESO_DMAC_DMAA 0x00 /* [RW] DMA Current/Base Address */
! 100: #define ESO_DMAC_DMAC 0x04 /* [RW] DMA Current/Base Count */
! 101: #define ESO_DMAC_COMMAND 0x08 /* [W] DMA Command */
! 102: #define ESO_DMAC_COMMAND_ENB 0x04 /* Controller enable */
! 103: #define ESO_DMAC_COMMAND_DREQPOL 0x40 /* DREQ signal polarity */
! 104: #define ESO_DMAC_COMMAND_DACKPOL 0x80 /* DACK signal polarity */
! 105: #define ESO_DMAC_STATUS 0x08 /* [R] DMA Status */
! 106: #define ESO_DMAC_MODE 0x0b /* [W] DMA Mode */
! 107: #define ESO_DMAC_CLEAR 0x0d /* [W] DMA Master Clear */
! 108: #define ESO_DMAC_MASK 0x0f /* [RW] DMA Mask */
! 109: #define ESO_DMAC_MASK_MASK 0x01 /* Mask DREQ */
! 110:
! 111: /* Controller commands */
! 112: #define ESO_CMD_RCR 0xc0 /* Read ext. controller registers */
! 113: #define ESO_CMD_EXTENB 0xc6 /* Enable Solo-1 Extension commands */
! 114: #define ESO_CMD_EXTDIS 0xc7 /* Disable Solo-1 Extension commands */
! 115:
! 116: /* Mixer registers */
! 117: #define ESO_MIXREG_RESET 0x00 /* Reset mixer registers */
! 118: #define ESO_MIXREG_RESET_RESET 0x00 /* Any value will do */
! 119: #define ESO_MIXREG_PVR_MIC 0x1a /* Playback mixer: Microphone */
! 120: #define ESO_MIXREG_ERS 0x1c /* Extended record source */
! 121: #define ESO_MIXREG_ERS_MIC 0x00 /* Microphone */
! 122: #define ESO_MIXREG_ERS_CD 0x02 /* CD */
! 123: #define ESO_MIXREG_ERS_MIC2 0x04 /* Microphone (again?) */
! 124: #define ESO_MIXREG_ERS_MIXER 0x05 /* Record mixer */
! 125: #define ESO_MIXREG_ERS_LINE 0x06 /* Line */
! 126: #define ESO_MIXREG_ERS_MUTE 0x10 /* Mutes input to filters for rec */
! 127: #define ESO_MIXREG_PCSVR 0x3c /* PC Speaker Volume Register */
! 128: #define ESO_MIXREG_PCSVR_RESV 0xf8 /* Reserved */
! 129: #define ESO_MIXREG_PVR_SYNTH 0x36 /* Playback mixer: FM/Synth */
! 130: #define ESO_MIXREG_PVR_CD 0x38 /* Playback mixer: AuxA/CD */
! 131: #define ESO_MIXREG_PVR_AUXB 0x3a /* Playback mixer: AuxB */
! 132: #define ESO_MIXREG_PCSPKR_VOL 0x3c /* PC speaker volume */
! 133: #define ESO_MIXREG_PVR_LINE 0x3e /* Playback mixer: Line */
! 134: #define ESO_MIXREG_SPAT 0x50 /* Spatializer Enable and Mode */
! 135: #define ESO_MIXREG_SPAT_MONO 0x02 /* 0 = Stereo in, 1 = Mono in */
! 136: #define ESO_MIXREG_SPAT_RSTREL 0x04 /* 0 = reset, 1 = release from reset */
! 137: #define ESO_MIXREG_SPAT_ENB 0x08 /* Spatializer Enable */
! 138: #define ESO_MIXREG_SPATLVL 0x52 /* Spatializer Level */
! 139: #define ESO_MIXREG_LMVM 0x60 /* Left Master Volume and Mute */
! 140: #define ESO_MIXREG_LMVM_MUTE 0x40 /* Mute enable */
! 141: #define ESO_MIXREG_RMVM 0x62 /* Right Master Volume and Mute */
! 142: #define ESO_MIXREG_RMVM_MUTE 0x40 /* Mute enable */
! 143: #define ESO_MIXREG_MVCTL 0x64 /* Master Volume Control */
! 144: #define ESO_MIXREG_RVR_MIC 0x68 /* Record mixer: Microphone */
! 145: #define ESO_MIXREG_RVR_A2 0x69 /* Record mixer: Audio 2 */
! 146: #define ESO_MIXREG_RVR_CD 0x6a /* Record mixer: AuxA/CD */
! 147: #define ESO_MIXREG_RVR_SYNTH 0x6b /* Record mixer: FM/Synth */
! 148: #define ESO_MIXREG_RVR_AUXB 0x6c /* Record mixer: AuxB */
! 149: #define ESO_MIXREG_PVR_MONO 0x6d /* Playback mixer: Mono In */
! 150: #define ESO_MIXREG_RVR_LINE 0x6e /* Record mixer: Line */
! 151: #define ESO_MIXREG_RVR_MONO 0x6f /* Record mixer: Mono In */
! 152: #define ESO_MIXREG_A2SRG 0x70 /* Audio 2 Sample Rate Generator */
! 153: #define ESO_MIXREG_A2MODE 0x71 /* Audio 2 Mode */
! 154: #define ESO_MIXREG_A2MODE_ASYNC 0x02 /* A2 SRG and FLTDIV async wrt A1 */
! 155: #define ESO_MIXREG_A2MODE_NEWA1 0x20 /* New-style SRG for Audio 1 */
! 156: #define ESO_MIXREG_A2FLTDIV 0x72 /* Audio 2 Filter Rate Divider */
! 157: #define ESO_MIXREG_A2TCRLO 0x74 /* Audio 2 Transfer Count Reload LO */
! 158: #define ESO_MIXREG_A2TCRHI 0x76 /* Audio 2 Transfer Count Reload HI */
! 159: #define ESO_MIXREG_A2C1 0x78 /* Audio 2 Control 1 */
! 160: #define ESO_MIXREG_A2C1_FIFOENB 0x01 /* FIFO enable */
! 161: #define ESO_MIXREG_A2C1_DMAENB 0x02 /* DMA enable */
! 162: #define ESO_MIXREG_A2C1_RESV0 0xcc /* Reserved, always write 0 XXXb5? */
! 163: #define ESO_MIXREG_A2C1_AUTO 0x10 /* Auto-initialize mode */
! 164: #define ESO_MIXREG_A2C2 0x7a /* Audio 2 Control 2 */
! 165: #define ESO_MIXREG_A2C2_16BIT 0x01 /* 1 = 16-bit, 0 = 8-bit */
! 166: #define ESO_MIXREG_A2C2_STEREO 0x02 /* 1 = Stereo, 0 = Mono */
! 167: #define ESO_MIXREG_A2C2_SIGNED 0x04 /* 1 = Signed data, 0 = unsigned */
! 168: #define ESO_MIXREG_A2C2_RESV0 0x38 /* Reserved, always write 0 */
! 169: #define ESO_MIXREG_A2C2_IRQM 0x40 /* IRQ mask */
! 170: #define ESO_MIXREG_A2C2_IRQ 0x80 /* IRQ latch */
! 171: #define ESO_MIXREG_PVR_A2 0x7c /* Playback mixer: Audio 2 */
! 172: #define ESO_MIXREG_MPM 0x7d /* Microphone Preamp, Mono In/Out */
! 173: #define ESO_MIXREG_MPM_MOMASK 0x03 /* MONO_OUT value mask */
! 174: #define ESO_MIXREG_MPM_MOMUTE 0x00 /* MONO_OUT mute */
! 175: #define ESO_MIXREG_MPM_MOCINR 0x01 /* MONO_OUT source CIN_R */
! 176: #define ESO_MIXREG_MPM_MOA2R 0x02 /* MONO_OUT source Audio 2 Right */
! 177: #define ESO_MIXREG_MPM_MOREC 0x03 /* MONO_OUT source record stage */
! 178: #define ESO_MIXREG_MPM_PREAMP 0x08 /* Preamp enable */
! 179: #define ESO_MIXREG_MPM_RESV0 0xf0 /* Reserved, always write 0 */
! 180:
! 181: /* Controller registers */
! 182: #define ESO_CTLREG_SRG 0xa1 /* Sample Rate Generator */
! 183: #define ESO_CTLREG_FLTDIV 0xa2 /* Filter Rate Divider */
! 184: #define ESO_CTLREG_A1TCRLO 0xa4 /* Audio 1 Transfer Count Reload LO */
! 185: #define ESO_CTLREG_A1TCRHI 0xa5 /* Audio 1 Transfer Count Reload HI */
! 186: #define ESO_CTLREG_ACTL 0xa8 /* Analog Control */
! 187: #define ESO_CTLREG_ACTL_STEREO 0x01 /* DMA converters stereo */
! 188: #define ESO_CTLREG_ACTL_MONO 0x02 /* DMA converters mono */
! 189: #define ESO_CTLREG_ACTL_RESV1 0x10 /* Reserved, always write 1 */
! 190: #define ESO_CTLREG_ACTL_RESV0 0xe4 /* Reserved, always write 0 */
! 191: #define ESO_CTLREG_ACTL_RECMON 0x08 /* Record Monitor enable */
! 192: #define ESO_CTLREG_LAIC 0xb1 /* Legacy Audio Interrupt Control */
! 193: #define ESO_CTLREG_LAIC_PINENB 0x10 /* Interrupt pin enable */
! 194: #define ESO_CTLREG_LAIC_EXTENB 0x40 /* Extended mode IRQ enable */
! 195: #define ESO_CTLREG_DRQCTL 0xb2 /* DRQ Control */
! 196: #define ESO_CTLREG_DRQCTL_ENB1 0x10 /* Supposedly no function, but ... */
! 197: #define ESO_CTLREG_DRQCTL_EXTENB 0x40 /* Extended mode DRQ enable */
! 198: #define ESO_CTLREG_RECLVL 0xb4 /* Record Level */
! 199: #define ESO_CTLREG_A1C1 0xb7 /* Audio 1 Control 1 */
! 200: #define ESO_CTLREG_A1C1_LOAD 0x01 /* Generate load signal */
! 201: #define ESO_CTLREG_A1C1_RESV0 0x02 /* Reserved, always write 0 */
! 202: #define ESO_CTLREG_A1C1_16BIT 0x04 /* 1 = 16-bit, 0 = 8-bit */
! 203: #define ESO_CTLREG_A1C1_STEREO 0x08 /* DMA FIFO Stereo */
! 204: #define ESO_CTLREG_A1C1_RESV1 0x10 /* Reserved, always write 1 */
! 205: #define ESO_CTLREG_A1C1_SIGNED 0x20 /* 1 = Signed data, 0 = unsigned */
! 206: #define ESO_CTLREG_A1C1_MONO 0x40 /* DMA FIFO Mono */
! 207: #define ESO_CTLREG_A1C1_FIFOENB 0x80 /* DMA FIFO enable */
! 208: #define ESO_CTLREG_A1C2 0xb8 /* Audio 1 Control 2 */
! 209: #define ESO_CTLREG_A1C2_DMAENB 0x01 /* DMA enable */
! 210: #define ESO_CTLREG_A1C2_READ 0x02 /* 1 = DMA read/ADC, 0 = write/DAC */
! 211: #define ESO_CTLREG_A1C2_AUTO 0x04 /* Auto-initialize DMA enable */
! 212: #define ESO_CTLREG_A1C2_ADC 0x08 /* 1 = ADC mode, 0 = DAC mode */
! 213: #define ESO_CTLREG_A1TT 0xb9 /* Audio 1 Transfer Type */
! 214: #define ESO_CTLREG_A1TT_SINGLE 0x00 /* Single-Transfer */
! 215: #define ESO_CTLREG_A1TT_DEMAND2 0x01 /* Demand-Transfer, 2 bytes/DREQ */
! 216: #define ESO_CTLREG_A1TT_DEMAND4 0x02 /* Demand-Transfer, 4 bytes/DREQ */
! 217:
! 218: /*
! 219: * Sample rate related constants.
! 220: * Note: the use of these clock sources must be explicitly enabled for Audio 1.
! 221: */
! 222: #define ESO_MINRATE 6000
! 223: #define ESO_MAXRATE 48000
! 224: #define ESO_CLK0 793800L /* Clock source 0 frequency */
! 225: #define ESO_CLK1 768000L /* Clock source 1 frequency */
! 226: #define ESO_CLK1_SELECT 0x80 /* MSb of divider selects clock src */
! 227:
! 228: /*
! 229: * Upper bounds on several polling loop iterations.
! 230: */
! 231: #define ESO_RESET_TIMEOUT 5000
! 232: #define ESO_RDR_TIMEOUT 5000
! 233: #define ESO_WDR_TIMEOUT 5000
! 234:
! 235: /*
! 236: * Mixer state data conversions.
! 237: */
! 238: /* Truncate MI 8-bit precision gain values to the width of chip registers. */
! 239: #define ESO_GAIN_TO_3BIT(x) ((x) & 0xe0)
! 240: #define ESO_GAIN_TO_4BIT(x) ((x) & 0xf0)
! 241: #define ESO_GAIN_TO_6BIT(x) ((x) & 0xfc)
! 242: /* Convert two 4-bit gain values to standard mixer stereo register layout. */
! 243: #define ESO_4BIT_GAIN_TO_STEREO(l,r) ((l) | ((r) >> 4))
! 244:
! 245: #endif /* !_DEV_PCI_ESOREG_H_ */
CVSweb