- Small step forward Linux boots and almost works...
[coreboot.git] / src / include / device / pci.h
1 /*
2  *      $Id$
3  *
4  *      PCI defines and function prototypes
5  *      Copyright 1994, Drew Eckhardt
6  *      Copyright 1997--1999 Martin Mares <mj@atrey.karlin.mff.cuni.cz>
7  *
8  *      For more information, please consult the following manuals (look at
9  *      http://www.pcisig.com/ for how to get them):
10  *
11  *      PCI BIOS Specification
12  *      PCI Local Bus Specification
13  *      PCI to PCI Bridge Specification
14  *      PCI System Design Guide
15  */
16
17 #ifndef PCI_H
18 #define PCI_H
19
20 /*
21  * Under PCI, each device has 256 bytes of configuration address space,
22  * of which the first 64 bytes are standardized as follows:
23  */
24 #define PCI_VENDOR_ID           0x00    /* 16 bits */
25 #define PCI_DEVICE_ID           0x02    /* 16 bits */
26 #define PCI_COMMAND             0x04    /* 16 bits */
27 #define  PCI_COMMAND_IO         0x1     /* Enable response in I/O space */
28 #define  PCI_COMMAND_MEMORY     0x2     /* Enable response in Memory space */
29 #define  PCI_COMMAND_MASTER     0x4     /* Enable bus mastering */
30 #define  PCI_COMMAND_SPECIAL    0x8     /* Enable response to special cycles */
31 #define  PCI_COMMAND_INVALIDATE 0x10    /* Use memory write and invalidate */
32 #define  PCI_COMMAND_VGA_PALETTE 0x20   /* Enable palette snooping */
33 #define  PCI_COMMAND_PARITY     0x40    /* Enable parity checking */
34 #define  PCI_COMMAND_WAIT       0x80    /* Enable address/data stepping */
35 #define  PCI_COMMAND_SERR       0x100   /* Enable SERR */
36 #define  PCI_COMMAND_FAST_BACK  0x200   /* Enable back-to-back writes */
37
38 #define PCI_STATUS              0x06    /* 16 bits */
39 #define  PCI_STATUS_CAP_LIST    0x10    /* Support Capability List */
40 #define  PCI_STATUS_66MHZ       0x20    /* Support 66 Mhz PCI 2.1 bus */
41 #define  PCI_STATUS_UDF         0x40    /* Support User Definable Features [obsolete] */
42 #define  PCI_STATUS_FAST_BACK   0x80    /* Accept fast-back to back */
43 #define  PCI_STATUS_PARITY      0x100   /* Detected parity error */
44 #define  PCI_STATUS_DEVSEL_MASK 0x600   /* DEVSEL timing */
45 #define  PCI_STATUS_DEVSEL_FAST 0x000   
46 #define  PCI_STATUS_DEVSEL_MEDIUM 0x200
47 #define  PCI_STATUS_DEVSEL_SLOW 0x400
48 #define  PCI_STATUS_SIG_TARGET_ABORT 0x800 /* Set on target abort */
49 #define  PCI_STATUS_REC_TARGET_ABORT 0x1000 /* Master ack of " */
50 #define  PCI_STATUS_REC_MASTER_ABORT 0x2000 /* Set on master abort */
51 #define  PCI_STATUS_SIG_SYSTEM_ERROR 0x4000 /* Set when we drive SERR */
52 #define  PCI_STATUS_DETECTED_PARITY 0x8000 /* Set on parity error */
53
54 #define PCI_CLASS_REVISION      0x08    /* High 24 bits are class, low 8
55                                            revision */
56 #define PCI_REVISION_ID         0x08    /* Revision ID */
57 #define PCI_CLASS_PROG          0x09    /* Reg. Level Programming Interface */
58 #define PCI_CLASS_DEVICE        0x0a    /* Device class */
59
60 #define PCI_CACHE_LINE_SIZE     0x0c    /* 8 bits */
61 #define PCI_LATENCY_TIMER       0x0d    /* 8 bits */
62 #define PCI_HEADER_TYPE         0x0e    /* 8 bits */
63 #define  PCI_HEADER_TYPE_NORMAL 0
64 #define  PCI_HEADER_TYPE_BRIDGE 1
65 #define  PCI_HEADER_TYPE_CARDBUS 2
66
67 #define PCI_BIST                0x0f    /* 8 bits */
68 #define PCI_BIST_CODE_MASK      0x0f    /* Return result */
69 #define PCI_BIST_START          0x40    /* 1 to start BIST, 2 secs or less */
70 #define PCI_BIST_CAPABLE        0x80    /* 1 if BIST capable */
71
72 /*
73  * Base addresses specify locations in memory or I/O space.
74  * Decoded size can be determined by writing a value of 
75  * 0xffffffff to the register, and reading it back.  Only 
76  * 1 bits are decoded.
77  */
78 #define PCI_BASE_ADDRESS_0      0x10    /* 32 bits */
79 #define PCI_BASE_ADDRESS_1      0x14    /* 32 bits [htype 0,1 only] */
80 #define PCI_BASE_ADDRESS_2      0x18    /* 32 bits [htype 0 only] */
81 #define PCI_BASE_ADDRESS_3      0x1c    /* 32 bits */
82 #define PCI_BASE_ADDRESS_4      0x20    /* 32 bits */
83 #define PCI_BASE_ADDRESS_5      0x24    /* 32 bits */
84 #define  PCI_BASE_ADDRESS_SPACE 0x01    /* 0 = memory, 1 = I/O */
85 #define  PCI_BASE_ADDRESS_SPACE_IO 0x01
86 #define  PCI_BASE_ADDRESS_SPACE_MEMORY 0x00
87 #define  PCI_BASE_ADDRESS_MEM_TYPE_MASK 0x06
88 #define  PCI_BASE_ADDRESS_MEM_TYPE_32   0x00    /* 32 bit address */
89 #define  PCI_BASE_ADDRESS_MEM_TYPE_1M   0x02    /* Below 1M [obsolete] */
90 #define  PCI_BASE_ADDRESS_MEM_TYPE_64   0x04    /* 64 bit address */
91 #define  PCI_BASE_ADDRESS_MEM_PREFETCH  0x08    /* prefetchable? */
92 #define  PCI_BASE_ADDRESS_MEM_MASK      (~0x0fUL)
93 #define  PCI_BASE_ADDRESS_IO_MASK       (~0x03UL)
94 /* bit 1 is reserved if address_space = 1 */
95
96 /* Header type 0 (normal devices) */
97 #define PCI_CARDBUS_CIS         0x28
98 #define PCI_SUBSYSTEM_VENDOR_ID 0x2c
99 #define PCI_SUBSYSTEM_ID        0x2e  
100 #define PCI_ROM_ADDRESS         0x30    /* Bits 31..11 are address, 10..1 reserved */
101 #define  PCI_ROM_ADDRESS_ENABLE 0x01
102 #define PCI_ROM_ADDRESS_MASK    (~0x7ffUL)
103
104 #define PCI_CAPABILITY_LIST     0x34    /* Offset of first capability list entry */
105
106 /* 0x35-0x3b are reserved */
107 #define PCI_INTERRUPT_LINE      0x3c    /* 8 bits */
108 #define PCI_INTERRUPT_PIN       0x3d    /* 8 bits */
109 #define PCI_MIN_GNT             0x3e    /* 8 bits */
110 #define PCI_MAX_LAT             0x3f    /* 8 bits */
111
112 /* Header type 1 (PCI-to-PCI bridges) */
113 #define PCI_PRIMARY_BUS         0x18    /* Primary bus number */
114 #define PCI_SECONDARY_BUS       0x19    /* Secondary bus number */
115 #define PCI_SUBORDINATE_BUS     0x1a    /* Highest bus number behind the bridge */
116 #define PCI_SEC_LATENCY_TIMER   0x1b    /* Latency timer for secondary interface */
117 #define PCI_IO_BASE             0x1c    /* I/O range behind the bridge */
118 #define PCI_IO_LIMIT            0x1d
119 #define  PCI_IO_RANGE_TYPE_MASK 0x0f    /* I/O bridging type */
120 #define  PCI_IO_RANGE_TYPE_16   0x00
121 #define  PCI_IO_RANGE_TYPE_32   0x01
122 #define  PCI_IO_RANGE_MASK      ~0x0f
123 #define PCI_SEC_STATUS          0x1e    /* Secondary status register, only bit 14 used */
124 #define PCI_MEMORY_BASE         0x20    /* Memory range behind */
125 #define PCI_MEMORY_LIMIT        0x22
126 #define  PCI_MEMORY_RANGE_TYPE_MASK 0x0f
127 #define  PCI_MEMORY_RANGE_MASK  ~0x0f
128 #define PCI_PREF_MEMORY_BASE    0x24    /* Prefetchable memory range behind */
129 #define PCI_PREF_MEMORY_LIMIT   0x26
130 #define  PCI_PREF_RANGE_TYPE_MASK 0x0f
131 #define  PCI_PREF_RANGE_TYPE_32 0x00
132 #define  PCI_PREF_RANGE_TYPE_64 0x01
133 #define  PCI_PREF_RANGE_MASK    ~0x0f
134 #define PCI_PREF_BASE_UPPER32   0x28    /* Upper half of prefetchable memory range */
135 #define PCI_PREF_LIMIT_UPPER32  0x2c
136 #define PCI_IO_BASE_UPPER16     0x30    /* Upper half of I/O addresses */
137 #define PCI_IO_LIMIT_UPPER16    0x32
138 /* 0x34 same as for htype 0 */
139 /* 0x35-0x3b is reserved */
140 #define PCI_ROM_ADDRESS1        0x38    /* Same as PCI_ROM_ADDRESS, but for htype 1 */
141 /* 0x3c-0x3d are same as for htype 0 */
142 #define PCI_BRIDGE_CONTROL      0x3e
143 #define  PCI_BRIDGE_CTL_PARITY  0x01    /* Enable parity detection on secondary interface */
144 #define  PCI_BRIDGE_CTL_SERR    0x02    /* The same for SERR forwarding */
145 #define  PCI_BRIDGE_CTL_NO_ISA  0x04    /* Disable bridging of ISA ports */
146 #define  PCI_BRIDGE_CTL_VGA     0x08    /* Forward VGA addresses */
147 #define  PCI_BRIDGE_CTL_MASTER_ABORT 0x20  /* Report master aborts */
148 #define  PCI_BRIDGE_CTL_BUS_RESET 0x40  /* Secondary bus reset */
149 #define  PCI_BRIDGE_CTL_FAST_BACK 0x80  /* Fast Back2Back enabled on secondary interface */
150
151 /* Header type 2 (CardBus bridges) */
152 #define PCI_CB_CAPABILITY_LIST  0x14
153 /* 0x15 reserved */
154 #define PCI_CB_SEC_STATUS       0x16    /* Secondary status */
155 #define PCI_CB_PRIMARY_BUS      0x18    /* PCI bus number */
156 #define PCI_CB_CARD_BUS         0x19    /* CardBus bus number */
157 #define PCI_CB_SUBORDINATE_BUS  0x1a    /* Subordinate bus number */
158 #define PCI_CB_LATENCY_TIMER    0x1b    /* CardBus latency timer */
159 #define PCI_CB_MEMORY_BASE_0    0x1c
160 #define PCI_CB_MEMORY_LIMIT_0   0x20
161 #define PCI_CB_MEMORY_BASE_1    0x24
162 #define PCI_CB_MEMORY_LIMIT_1   0x28
163 #define PCI_CB_IO_BASE_0        0x2c
164 #define PCI_CB_IO_BASE_0_HI     0x2e
165 #define PCI_CB_IO_LIMIT_0       0x30
166 #define PCI_CB_IO_LIMIT_0_HI    0x32
167 #define PCI_CB_IO_BASE_1        0x34
168 #define PCI_CB_IO_BASE_1_HI     0x36
169 #define PCI_CB_IO_LIMIT_1       0x38
170 #define PCI_CB_IO_LIMIT_1_HI    0x3a
171 #define  PCI_CB_IO_RANGE_MASK   ~0x03
172 /* 0x3c-0x3d are same as for htype 0 */
173 #define PCI_CB_BRIDGE_CONTROL   0x3e
174 #define  PCI_CB_BRIDGE_CTL_PARITY       0x01    /* Similar to standard bridge control register */
175 #define  PCI_CB_BRIDGE_CTL_SERR         0x02
176 #define  PCI_CB_BRIDGE_CTL_ISA          0x04
177 #define  PCI_CB_BRIDGE_CTL_VGA          0x08
178 #define  PCI_CB_BRIDGE_CTL_MASTER_ABORT 0x20
179 #define  PCI_CB_BRIDGE_CTL_CB_RESET     0x40    /* CardBus reset */
180 #define  PCI_CB_BRIDGE_CTL_16BIT_INT    0x80    /* Enable interrupt for 16-bit cards */
181 #define  PCI_CB_BRIDGE_CTL_PREFETCH_MEM0 0x100  /* Prefetch enable for both memory regions */
182 #define  PCI_CB_BRIDGE_CTL_PREFETCH_MEM1 0x200
183 #define  PCI_CB_BRIDGE_CTL_POST_WRITES  0x400
184 #define PCI_CB_SUBSYSTEM_VENDOR_ID 0x40
185 #define PCI_CB_SUBSYSTEM_ID     0x42
186 #define PCI_CB_LEGACY_MODE_BASE 0x44    /* 16-bit PC Card legacy mode base address (ExCa) */
187 /* 0x48-0x7f reserved */
188
189 /* Capability lists */
190
191 #define PCI_CAP_LIST_ID         0       /* Capability ID */
192 #define  PCI_CAP_ID_PM          0x01    /* Power Management */
193 #define  PCI_CAP_ID_AGP         0x02    /* Accelerated Graphics Port */
194 #define  PCI_CAP_ID_VPD         0x03    /* Vital Product Data */
195 #define  PCI_CAP_ID_SLOTID      0x04    /* Slot Identification */
196 #define  PCI_CAP_ID_MSI         0x05    /* Message Signalled Interrupts */
197 #define  PCI_CAP_ID_CHSWP       0x06    /* CompactPCI HotSwap */
198 #define  PCI_CAP_ID_HT          0x08
199 #define PCI_CAP_LIST_NEXT       1       /* Next capability in the list */
200 #define PCI_CAP_FLAGS           2       /* Capability defined flags (16 bits) */
201 #define PCI_CAP_SIZEOF          4
202
203 /* Power Management Registers */
204
205 #define  PCI_PM_CAP_VER_MASK    0x0007  /* Version */
206 #define  PCI_PM_CAP_PME_CLOCK   0x0008  /* PME clock required */
207 #define  PCI_PM_CAP_AUX_POWER   0x0010  /* Auxilliary power support */
208 #define  PCI_PM_CAP_DSI         0x0020  /* Device specific initialization */
209 #define  PCI_PM_CAP_D1          0x0200  /* D1 power state support */
210 #define  PCI_PM_CAP_D2          0x0400  /* D2 power state support */
211 #define  PCI_PM_CAP_PME         0x0800  /* PME pin supported */
212 #define PCI_PM_CTRL             4       /* PM control and status register */
213 #define  PCI_PM_CTRL_STATE_MASK 0x0003  /* Current power state (D0 to D3) */
214 #define  PCI_PM_CTRL_PME_ENABLE 0x0100  /* PME pin enable */
215 #define  PCI_PM_CTRL_DATA_SEL_MASK      0x1e00  /* Data select (??) */
216 #define  PCI_PM_CTRL_DATA_SCALE_MASK    0x6000  /* Data scale (??) */
217 #define  PCI_PM_CTRL_PME_STATUS 0x8000  /* PME pin status */
218 #define PCI_PM_PPB_EXTENSIONS   6       /* PPB support extensions (??) */
219 #define  PCI_PM_PPB_B2_B3       0x40    /* Stop clock when in D3hot (??) */
220 #define  PCI_PM_BPCC_ENABLE     0x80    /* Bus power/clock control enable (??) */
221 #define PCI_PM_DATA_REGISTER    7       /* (??) */
222 #define PCI_PM_SIZEOF           8
223
224 /* AGP registers */
225
226 #define PCI_AGP_VERSION         2       /* BCD version number */
227 #define PCI_AGP_RFU             3       /* Rest of capability flags */
228 #define PCI_AGP_STATUS          4       /* Status register */
229 #define  PCI_AGP_STATUS_RQ_MASK 0xff000000      /* Maximum number of requests - 1 */
230 #define  PCI_AGP_STATUS_SBA     0x0200  /* Sideband addressing supported */
231 #define  PCI_AGP_STATUS_64BIT   0x0020  /* 64-bit addressing supported */
232 #define  PCI_AGP_STATUS_FW      0x0010  /* FW transfers supported */
233 #define  PCI_AGP_STATUS_RATE4   0x0004  /* 4x transfer rate supported */
234 #define  PCI_AGP_STATUS_RATE2   0x0002  /* 2x transfer rate supported */
235 #define  PCI_AGP_STATUS_RATE1   0x0001  /* 1x transfer rate supported */
236 #define PCI_AGP_COMMAND         8       /* Control register */
237 #define  PCI_AGP_COMMAND_RQ_MASK 0xff000000  /* Master: Maximum number of requests */
238 #define  PCI_AGP_COMMAND_SBA    0x0200  /* Sideband addressing enabled */
239 #define  PCI_AGP_COMMAND_AGP    0x0100  /* Allow processing of AGP transactions */
240 #define  PCI_AGP_COMMAND_64BIT  0x0020  /* Allow processing of 64-bit addresses */
241 #define  PCI_AGP_COMMAND_FW     0x0010  /* Force FW transfers */
242 #define  PCI_AGP_COMMAND_RATE4  0x0004  /* Use 4x rate */
243 #define  PCI_AGP_COMMAND_RATE2  0x0002  /* Use 4x rate */
244 #define  PCI_AGP_COMMAND_RATE1  0x0001  /* Use 4x rate */
245 #define PCI_AGP_SIZEOF          12
246
247 /* Slot Identification */
248
249 #define PCI_SID_ESR             2       /* Expansion Slot Register */
250 #define  PCI_SID_ESR_NSLOTS     0x1f    /* Number of expansion slots available */
251 #define  PCI_SID_ESR_FIC        0x20    /* First In Chassis Flag */
252 #define PCI_SID_CHASSIS_NR      3       /* Chassis Number */
253
254 /* Message Signalled Interrupts registers */
255
256 #define PCI_MSI_FLAGS           2       /* Various flags */
257 #define  PCI_MSI_FLAGS_64BIT    0x80    /* 64-bit addresses allowed */
258 #define  PCI_MSI_FLAGS_QSIZE    0x70    /* Message queue size configured */
259 #define  PCI_MSI_FLAGS_QMASK    0x0e    /* Maximum queue size available */
260 #define  PCI_MSI_FLAGS_ENABLE   0x01    /* MSI feature enabled */
261 #define PCI_MSI_RFU             3       /* Rest of capability flags */
262 #define PCI_MSI_ADDRESS_LO      4       /* Lower 32 bits */
263 #define PCI_MSI_ADDRESS_HI      8       /* Upper 32 bits (if PCI_MSI_FLAGS_64BIT set) */
264 #define PCI_MSI_DATA_32         8       /* 16 bits of data for 32-bit devices */
265 #define PCI_MSI_DATA_64         12      /* 16 bits of data for 64-bit devices */
266
267 /*
268  * The PCI interface treats multi-function devices as independent
269  * devices.  The slot/function address of each device is encoded
270  * in a single byte as follows:
271  *
272  *      7:3 = slot
273  *      2:0 = function
274  */
275 #define PCI_DEVFN(slot,func)    ((((slot) & 0x1f) << 3) | ((func) & 0x07))
276 #define PCI_SLOT(devfn)         (((devfn) >> 3) & 0x1f)
277 #define PCI_FUNC(devfn)         ((devfn) & 0x07)
278 #define PCI_BDF(bus,dev,func)   ((bus) << 16 | (dev) << 11 | (func) << 8)
279
280
281 #include <device/resource.h>
282 #include <device/device.h>
283 #include <device/pci_ops.h>
284
285
286 struct pci_driver {
287         struct device_operations *ops;
288         unsigned short vendor;
289         unsigned short device;
290 };
291
292 #define __pci_driver __attribute__ ((unused,__section__(".rodata.pci_driver")))
293 extern struct pci_driver pci_drivers[];
294 extern struct pci_driver epci_drivers[];
295
296
297 struct device_operations default_pci_ops_dev;
298 struct device_operations default_pci_ops_bus;
299 struct device_operations default_pci_ops_root;
300
301
302 void pci_dev_read_resources(struct device *dev);
303 void pci_bus_read_resources(struct device *dev);
304 void pci_dev_set_resources(struct device *dev);
305 unsigned int pci_scan_bridge(struct device *bus, unsigned int max);
306
307 #define PCI_IO_BRIDGE_ALIGN 4096
308 #define PCI_MEM_BRIDGE_ALIGN (1024*1024)
309
310 #endif /* PCI_H */