1 /* $NetBSD: pciidevar.h,v 1.25 2004/08/20 06:39:39 thorpej Exp $ */ 2 3 /* 4 * Copyright (c) 1998 Christopher G. Demetriou. All rights reserved. 5 * 6 * Redistribution and use in source and binary forms, with or without 7 * modification, are permitted provided that the following conditions 8 * are met: 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 2. Redistributions in binary form must reproduce the above copyright 12 * notice, this list of conditions and the following disclaimer in the 13 * documentation and/or other materials provided with the distribution. 14 * 3. All advertising materials mentioning features or use of this software 15 * must display the following acknowledgement: 16 * This product includes software developed by Christopher G. Demetriou 17 * for the NetBSD Project. 18 * 4. The name of the author may not be used to endorse or promote products 19 * derived from this software without specific prior written permission 20 * 21 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 22 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 23 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 24 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 25 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 26 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 27 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 28 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF 30 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 31 */ 32 33 #ifndef _DEV_PCI_PCIIDEVAR_H_ 34 #define _DEV_PCI_PCIIDEVAR_H_ 35 36 /* 37 * PCI IDE driver exported software structures. 38 * 39 * Author: Christopher G. Demetriou, March 2, 1998. 40 */ 41 42 #include <dev/ata/atavar.h> 43 #include <dev/ic/wdcreg.h> 44 #include <dev/ic/wdcvar.h> 45 #include "opt_pciide.h" 46 47 /* options passed via the 'flags' config keyword */ 48 #define PCIIDE_OPTIONS_DMA 0x01 49 #define PCIIDE_OPTIONS_NODMA 0x02 50 51 #ifndef ATADEBUG 52 #define ATADEBUG 53 #endif 54 55 #define DEBUG_DMA 0x01 56 #define DEBUG_XFERS 0x02 57 #define DEBUG_FUNCS 0x08 58 #define DEBUG_PROBE 0x10 59 #ifdef ATADEBUG 60 extern int atadebug_pciide_mask; 61 #define ATADEBUG_PRINT(args, level) \ 62 if (atadebug_pciide_mask & (level)) printf args 63 #else 64 #define ATADEBUG_PRINT(args, level) 65 #endif 66 67 struct device; 68 69 /* 70 * While standard PCI IDE controllers only have 2 channels, it is 71 * common for PCI SATA controllers to have more. Here we define 72 * the maximum number of channels that any one PCI IDE device can 73 * have. 74 */ 75 #define PCIIDE_MAX_CHANNELS 4 76 77 struct pciide_softc { 78 struct wdc_softc sc_wdcdev; /* common wdc definitions */ 79 pci_chipset_tag_t sc_pc; /* PCI registers info */ 80 pcitag_t sc_tag; 81 void *sc_pci_ih; /* PCI interrupt handle */ 82 int sc_dma_ok; /* bus-master DMA info */ 83 /* 84 * sc_dma_ioh may only be used to allocate the dma_iohs 85 * array in the channels (see below), or by chip-dependent 86 * code that knows what it's doing, as the registers may 87 * be laid out differently. All code in pciide_common.c 88 * must use the channel->dma_iohs array. 89 */ 90 bus_space_tag_t sc_dma_iot; 91 bus_space_handle_t sc_dma_ioh; 92 bus_dma_tag_t sc_dmat; 93 94 /* 95 * Some controllers might have DMA restrictions other than 96 * the norm. 97 */ 98 bus_size_t sc_dma_maxsegsz; 99 bus_size_t sc_dma_boundary; 100 101 /* For VIA/AMD/nVidia */ 102 bus_addr_t sc_apo_regbase; 103 104 /* For Cypress */ 105 const struct cy82c693_handle *sc_cy_handle; 106 int sc_cy_compatchan; 107 108 /* for SiS */ 109 u_int8_t sis_type; 110 111 /* For Silicon Image SATALink */ 112 bus_space_tag_t sc_ba5_st; 113 bus_space_handle_t sc_ba5_sh; 114 int sc_ba5_en; 115 116 /* Vendor info (for interpreting Chip description) */ 117 pcireg_t sc_pci_id; 118 /* Chip description */ 119 const struct pciide_product_desc *sc_pp; 120 /* common definitions */ 121 struct ata_channel *wdc_chanarray[PCIIDE_MAX_CHANNELS]; 122 /* internal bookkeeping */ 123 struct pciide_channel { /* per-channel data */ 124 struct ata_channel ata_channel; /* generic part */ 125 const char *name; 126 int compat; /* is it compat? */ 127 void *ih; /* compat or pci handle */ 128 bus_space_handle_t ctl_baseioh; /* ctrl regs blk, native mode */ 129 /* DMA tables and DMA map for xfer, for each drive */ 130 struct pciide_dma_maps { 131 bus_dmamap_t dmamap_table; 132 struct idedma_table *dma_table; 133 bus_dmamap_t dmamap_xfer; 134 int dma_flags; 135 } dma_maps[2]; 136 bus_space_handle_t dma_iohs[IDEDMA_NREGS]; 137 /* 138 * Some controllers require certain bits to 139 * always be set for proper operation of the 140 * controller. Set those bits here, if they're 141 * required. 142 */ 143 uint8_t idedma_cmd; 144 } pciide_channels[PCIIDE_MAX_CHANNELS]; 145 }; 146 147 /* Given an ata_channel, get the pciide_softc. */ 148 #define CHAN_TO_PCIIDE(chp) ((struct pciide_softc *) (chp)->ch_atac) 149 150 /* Given an ata_channel, get the pciide_channel. */ 151 #define CHAN_TO_PCHAN(chp) ((struct pciide_channel *) (chp)) 152 153 struct pciide_product_desc { 154 u_int32_t ide_product; 155 int ide_flags; 156 const char *ide_name; 157 /* map and setup chip, probe drives */ 158 void (*chip_map) __P((struct pciide_softc*, struct pci_attach_args*)); 159 }; 160 161 /* Flags for ide_flags */ 162 #define IDE_16BIT_IOSPACE 0x0002 /* I/O space BARS ignore upper word */ 163 164 165 /* inlines for reading/writing 8-bit PCI registers */ 166 static __inline u_int8_t pciide_pci_read __P((pci_chipset_tag_t, pcitag_t, 167 int)); 168 static __inline void pciide_pci_write __P((pci_chipset_tag_t, pcitag_t, 169 int, u_int8_t)); 170 171 static __inline u_int8_t 172 pciide_pci_read(pc, pa, reg) 173 pci_chipset_tag_t pc; 174 pcitag_t pa; 175 int reg; 176 { 177 178 return (pci_conf_read(pc, pa, (reg & ~0x03)) >> 179 ((reg & 0x03) * 8) & 0xff); 180 } 181 182 static __inline void 183 pciide_pci_write(pc, pa, reg, val) 184 pci_chipset_tag_t pc; 185 pcitag_t pa; 186 int reg; 187 u_int8_t val; 188 { 189 pcireg_t pcival; 190 191 pcival = pci_conf_read(pc, pa, (reg & ~0x03)); 192 pcival &= ~(0xff << ((reg & 0x03) * 8)); 193 pcival |= (val << ((reg & 0x03) * 8)); 194 pci_conf_write(pc, pa, (reg & ~0x03), pcival); 195 } 196 197 void default_chip_map __P((struct pciide_softc*, struct pci_attach_args*)); 198 void sata_setup_channel __P((struct ata_channel*)); 199 200 void pciide_channel_dma_setup __P((struct pciide_channel *)); 201 int pciide_dma_table_setup __P((struct pciide_softc*, int, int)); 202 int pciide_dma_init __P((void*, int, int, void *, size_t, int)); 203 void pciide_dma_start __P((void*, int, int)); 204 int pciide_dma_finish __P((void*, int, int, int)); 205 void pciide_irqack __P((struct ata_channel *)); 206 207 /* 208 * Functions defined by machine-dependent code. 209 */ 210 211 /* Attach compat interrupt handler, returning handle or NULL if failed. */ 212 #ifdef __HAVE_PCIIDE_MACHDEP_COMPAT_INTR_ESTABLISH 213 void *pciide_machdep_compat_intr_establish __P((struct device *, 214 struct pci_attach_args *, int, int (*)(void *), void *)); 215 #endif 216 217 const struct pciide_product_desc* pciide_lookup_product 218 __P((u_int32_t, const struct pciide_product_desc *)); 219 void pciide_common_attach 220 __P((struct pciide_softc *, struct pci_attach_args *, 221 const struct pciide_product_desc *)); 222 223 int pciide_chipen __P((struct pciide_softc *, struct pci_attach_args *)); 224 void pciide_mapregs_compat __P(( struct pci_attach_args *, 225 struct pciide_channel *, int, bus_size_t *, bus_size_t*)); 226 void pciide_mapregs_native __P((struct pci_attach_args *, 227 struct pciide_channel *, bus_size_t *, bus_size_t *, 228 int (*pci_intr) __P((void *)))); 229 void pciide_mapreg_dma __P((struct pciide_softc *, 230 struct pci_attach_args *)); 231 int pciide_chansetup __P((struct pciide_softc *, int, pcireg_t)); 232 void pciide_mapchan __P((struct pci_attach_args *, 233 struct pciide_channel *, pcireg_t, bus_size_t *, bus_size_t *, 234 int (*pci_intr) __P((void *)))); 235 void pciide_map_compat_intr __P(( struct pci_attach_args *, 236 struct pciide_channel *, int)); 237 int pciide_compat_intr __P((void *)); 238 int pciide_pci_intr __P((void *)); 239 240 #endif /* _DEV_PCI_PCIIDEVAR_H_ */ 241