VirtualBox

source: vbox/trunk/include/VBox/pci.h@ 21217

Last change on this file since 21217 was 21217, checked in by vboxsync, 15 years ago

include/VBox/*.h: Mark which components the header files relate to.
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 16.7 KB
Line 
1/** @file
2 * PCI - The PCI Controller And Devices. (DEV)
3 */
4
5/*
6 * Copyright (C) 2006-2007 Sun Microsystems, Inc.
7 *
8 * This file is part of VirtualBox Open Source Edition (OSE), as
9 * available from http://www.virtualbox.org. This file is free software;
10 * you can redistribute it and/or modify it under the terms of the GNU
11 * General Public License (GPL) as published by the Free Software
12 * Foundation, in version 2 as it comes in the "COPYING" file of the
13 * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14 * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15 *
16 * The contents of this file may alternatively be used under the terms
17 * of the Common Development and Distribution License Version 1.0
18 * (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19 * VirtualBox OSE distribution, in which case the provisions of the
20 * CDDL are applicable instead of those of the GPL.
21 *
22 * You may elect to license modified versions of this file under the
23 * terms and conditions of either the GPL or the CDDL or both.
24 *
25 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
26 * Clara, CA 95054 USA or visit http://www.sun.com if you need
27 * additional information or have any questions.
28 */
29
30#ifndef ___VBox_pci_h
31#define ___VBox_pci_h
32
33#include <VBox/cdefs.h>
34#include <VBox/types.h>
35#include <iprt/assert.h>
36
37/** @defgroup grp_pci PCI - The PCI Controller.
38 * @{
39 */
40
41/** Pointer to a PCI device. */
42typedef struct PCIDevice *PPCIDEVICE;
43
44
45/**
46 * PCI configuration word 4 (command) and word 6 (status).
47 */
48typedef enum PCICONFIGCOMMAND
49{
50 /** Supports/uses memory accesses. */
51 PCI_COMMAND_IOACCESS = 0x0001,
52 PCI_COMMAND_MEMACCESS = 0x0002,
53 PCI_COMMAND_BUSMASTER = 0x0004
54} PCICONFIGCOMMAND;
55
56
57/**
58 * PCI Address space specification.
59 * This is used when registering a I/O region.
60 */
61/** Note: There are all sorts of dirty dependencies on the values in the
62 * pci device. Be careful when changing this.
63 * @todo we should introduce 32 & 64 bits physical address types
64 */
65typedef enum PCIADDRESSSPACE
66{
67 /** Memory. */
68 PCI_ADDRESS_SPACE_MEM = 0x00,
69 /** I/O space. */
70 PCI_ADDRESS_SPACE_IO = 0x01,
71 /** Prefetch memory. */
72 PCI_ADDRESS_SPACE_MEM_PREFETCH = 0x08
73} PCIADDRESSSPACE;
74
75
76/**
77 * Callback function for mapping an PCI I/O region.
78 *
79 * @return VBox status code.
80 * @param pPciDev Pointer to PCI device. Use pPciDev->pDevIns to get the device instance.
81 * @param iRegion The region number.
82 * @param GCPhysAddress Physical address of the region. If enmType is PCI_ADDRESS_SPACE_IO, this
83 * is an I/O port, otherwise it's a physical address.
84 *
85 * NIL_RTGCPHYS indicates that a MMIO2 mapping is about to be unmapped and
86 * that the device deregister access handlers for it and update its internal
87 * state to reflect this.
88 *
89 * @param enmType One of the PCI_ADDRESS_SPACE_* values.
90 *
91 * @remarks The address is *NOT* relative to pci_mem_base.
92 */
93typedef DECLCALLBACK(int) FNPCIIOREGIONMAP(PPCIDEVICE pPciDev, /*unsigned*/ int iRegion, RTGCPHYS GCPhysAddress, uint32_t cb, PCIADDRESSSPACE enmType);
94/** Pointer to a FNPCIIOREGIONMAP() function. */
95typedef FNPCIIOREGIONMAP *PFNPCIIOREGIONMAP;
96
97
98/** @name PCI Configuration Space Registers
99 * @{ */
100#define VBOX_PCI_VENDOR_ID 0x00 /**< 16-bit RO */
101#define VBOX_PCI_DEVICE_ID 0x02 /**< 16-bit RO */
102#define VBOX_PCI_COMMAND 0x04 /**< 16-bit RW */
103#define VBOX_PCI_STATUS 0x06 /**< 16-bit RW */
104#define VBOX_PCI_REVISION_ID 0x08 /**< 8-bit RO */
105#define VBOX_PCI_CLASS_PROG 0x09 /**< 8-bit RO - - register-level programming class code (device specific). */
106#define VBOX_PCI_CLASS_SUB 0x0a /**< 8-bit RO - - sub-class code. */
107#define VBOX_PCI_CLASS_DEVICE VBOX_PCI_CLASS_SUB
108#define VBOX_PCI_CLASS_BASE 0x0b /**< 8-bit RO - - base class code. */
109#define VBOX_PCI_CACHE_LINE_SIZE 0x0c /**< 8-bit ?? */
110#define VBOX_PCI_LATENCY_TIMER 0x0d /**< 8-bit ?? */
111#define VBOX_PCI_HEADER_TYPE 0x0e /**< 8-bit ?? */
112#define VBOX_PCI_BIST 0x0f /**< 8-bit ?? */
113#define VBOX_PCI_BASE_ADDRESS_0 0x10 /**< 32-bit RW */
114#define VBOX_PCI_BASE_ADDRESS_1 0x14 /**< 32-bit RW */
115#define VBOX_PCI_BASE_ADDRESS_2 0x18 /**< 32-bit RW */
116#define VBOX_PCI_PRIMARY_BUS 0x18 /**< 8-bit ?? - bridge - primary bus number. */
117#define VBOX_PCI_SECONDARY_BUS 0x19 /**< 8-bit ?? - bridge - secondary bus number. */
118#define VBOX_PCI_SUBORDINATE_BUS 0x1a /**< 8-bit ?? - bridge - highest subordinate bus number. (behind the bridge) */
119#define VBOX_PCI_SEC_LATENCY_TIMER 0x1b /**< 8-bit ?? - bridge - secondary latency timer. */
120#define VBOX_PCI_BASE_ADDRESS_3 0x1c /**< 32-bit RW */
121#define VBOX_PCI_IO_BASE 0x1c /**< 8-bit ?? - bridge - I/O range base. */
122#define VBOX_PCI_IO_LIMIT 0x1d /**< 8-bit ?? - bridge - I/O range limit. */
123#define VBOX_PCI_SEC_STATUS 0x1e /**< 16-bit ?? - bridge - secondary status register. */
124#define VBOX_PCI_BASE_ADDRESS_4 0x20 /**< 32-bit RW */
125#define VBOX_PCI_MEMORY_BASE 0x20 /**< 16-bit ?? - bridge - memory range base. */
126#define VBOX_PCI_MEMORY_LIMIT 0x22 /**< 16-bit ?? - bridge - memory range limit. */
127#define VBOX_PCI_BASE_ADDRESS_5 0x24 /**< 32-bit RW */
128#define VBOX_PCI_PREF_MEMORY_BASE 0x24 /**< 16-bit ?? - bridge - Prefetchable memory range base. */
129#define VBOX_PCI_PREF_MEMORY_LIMIT 0x26 /**< 16-bit ?? - bridge - Prefetchable memory range limit. */
130#define VBOX_PCI_CARDBUS_CIS 0x28 /**< 32-bit ?? */
131#define VBOX_PCI_PREF_BASE_UPPER32 0x28 /**< 32-bit ?? - bridge - Prefetchable memory range high base.*/
132#define VBOX_PCI_PREF_LIMIT_UPPER32 0x2c /**< 32-bit ?? - bridge - Prefetchable memory range high limit. */
133#define VBOX_PCI_SUBSYSTEM_VENDOR_ID 0x2c /**< 16-bit ?? */
134#define VBOX_PCI_SUBSYSTEM_ID 0x2e /**< 16-bit ?? */
135#define VBOX_PCI_ROM_ADDRESS 0x30 /**< 32-bit ?? */
136#define VBOX_PCI_IO_BASE_UPPER16 0x30 /**< 16-bit ?? - bridge - memory range high base. */
137#define VBOX_PCI_IO_LIMIT_UPPER16 0x32 /**< 16-bit ?? - bridge - memory range high limit. */
138#define VBOX_PCI_CAPABILITY_LIST 0x34 /**< 8-bit? ?? */
139#define VBOX_PCI_ROM_ADDRESS_BR 0x38 /**< 32-bit ?? - bridge */
140#define VBOX_PCI_INTERRUPT_LINE 0x3c /**< 8-bit RW - Interrupt line. */
141#define VBOX_PCI_INTERRUPT_PIN 0x3d /**< 8-bit RO - Interrupt pin. */
142#define VBOX_PCI_MIN_GNT 0x3e /**< 8-bit ?? */
143#define VBOX_PCI_BRIDGE_CONTROL 0x3e /**< 8-bit? ?? - bridge */
144#define VBOX_PCI_MAX_LAT 0x3f /**< 8-bit ?? */
145/** @} */
146
147
148/**
149 * Callback function for reading from the PCI configuration space.
150 *
151 * @returns The register value.
152 * @param pPciDev Pointer to PCI device. Use pPciDev->pDevIns to get the device instance.
153 * @param Address The configuration space register address. [0..255]
154 * @param cb The register size. [1,2,4]
155 */
156typedef DECLCALLBACK(uint32_t) FNPCICONFIGREAD(PPCIDEVICE pPciDev, uint32_t Address, unsigned cb);
157/** Pointer to a FNPCICONFIGREAD() function. */
158typedef FNPCICONFIGREAD *PFNPCICONFIGREAD;
159/** Pointer to a PFNPCICONFIGREAD. */
160typedef PFNPCICONFIGREAD *PPFNPCICONFIGREAD;
161
162/**
163 * Callback function for writing to the PCI configuration space.
164 *
165 * @param pPciDev Pointer to PCI device. Use pPciDev->pDevIns to get the device instance.
166 * @param Address The configuration space register address. [0..255]
167 * @param u32Value The value that's being written. The number of bits actually used from
168 * this value is determined by the cb parameter.
169 * @param cb The register size. [1,2,4]
170 */
171typedef DECLCALLBACK(void) FNPCICONFIGWRITE(PPCIDEVICE pPciDev, uint32_t Address, uint32_t u32Value, unsigned cb);
172/** Pointer to a FNPCICONFIGWRITE() function. */
173typedef FNPCICONFIGWRITE *PFNPCICONFIGWRITE;
174/** Pointer to a PFNPCICONFIGWRITE. */
175typedef PFNPCICONFIGWRITE *PPFNPCICONFIGWRITE;
176
177/** Fixed I/O region number for ROM. */
178#define PCI_ROM_SLOT 6
179/** Max number of I/O regions. */
180#define PCI_NUM_REGIONS 7
181
182/*
183 * Hack to include the PCIDEVICEINT structure at the right place
184 * to avoid duplications of FNPCIIOREGIONMAP and PCI_NUM_REGIONS.
185 */
186#ifdef PCI_INCLUDE_PRIVATE
187# include "PCIInternal.h"
188#endif
189
190/**
191 * PCI Device structure.
192 */
193typedef struct PCIDevice
194{
195 /** PCI config space. */
196 uint8_t config[256];
197
198 /** Internal data. */
199 union
200 {
201#ifdef __PCIDEVICEINT_DECLARED__
202 PCIDEVICEINT s;
203#endif
204 char padding[256];
205 } Int;
206
207 /** Read only data.
208 * @{
209 */
210 /** PCI device number on the pci bus. */
211 int32_t devfn;
212 uint32_t Alignment0; /**< Alignment. */
213 /** Device name. */
214 R3PTRTYPE(const char *) name;
215 /** Pointer to the device instance which registered the device. */
216 PPDMDEVINSR3 pDevIns;
217 /** @} */
218} PCIDEVICE;
219
220
221/**
222 * Sets the vendor id config register.
223 * @param pPciDev The PCI device.
224 * @param u16VendorId The vendor id.
225 */
226DECLINLINE(void) PCIDevSetVendorId(PPCIDEVICE pPciDev, uint16_t u16VendorId)
227{
228 u16VendorId = RT_H2LE_U16(u16VendorId);
229 pPciDev->config[VBOX_PCI_VENDOR_ID] = u16VendorId & 0xff;
230 pPciDev->config[VBOX_PCI_VENDOR_ID + 1] = u16VendorId >> 8;
231}
232
233/**
234 * Gets the vendor id config register.
235 * @returns the vendor id.
236 * @param pPciDev The PCI device.
237 */
238DECLINLINE(uint16_t) PCIDevGetVendorId(PPCIDEVICE pPciDev)
239{
240 return RT_LE2H_U16(RT_MAKE_U16(pPciDev->config[VBOX_PCI_VENDOR_ID], pPciDev->config[VBOX_PCI_VENDOR_ID + 1]));
241}
242
243
244/**
245 * Sets the device id config register.
246 * @param pPciDev The PCI device.
247 * @param u16DeviceId The device id.
248 */
249DECLINLINE(void) PCIDevSetDeviceId(PPCIDEVICE pPciDev, uint16_t u16DeviceId)
250{
251 u16DeviceId = RT_H2LE_U16(u16DeviceId);
252 pPciDev->config[VBOX_PCI_DEVICE_ID] = u16DeviceId & 0xff;
253 pPciDev->config[VBOX_PCI_DEVICE_ID + 1] = u16DeviceId >> 8;
254}
255
256/**
257 * Gets the device id config register.
258 * @returns the device id.
259 * @param pPciDev The PCI device.
260 */
261DECLINLINE(uint16_t) PCIDevGetDeviceId(PPCIDEVICE pPciDev)
262{
263 return RT_LE2H_U16(RT_MAKE_U16(pPciDev->config[VBOX_PCI_DEVICE_ID], pPciDev->config[VBOX_PCI_DEVICE_ID + 1]));
264}
265
266
267/**
268 * Sets the command config register.
269 *
270 * @param pPciDev The PCI device.
271 * @param u16Command The command register value.
272 */
273DECLINLINE(void) PCIDevSetCommand(PPCIDEVICE pPciDev, uint16_t u16Command)
274{
275 u16Command = RT_H2LE_U16(u16Command);
276 pPciDev->config[VBOX_PCI_COMMAND] = u16Command & 0xff;
277 pPciDev->config[VBOX_PCI_COMMAND + 1] = u16Command >> 8;
278}
279
280
281/**
282 * Gets the command config register.
283 * @returns The command register value.
284 * @param pPciDev The PCI device.
285 */
286DECLINLINE(uint16_t) PCIDevGetCommand(PPCIDEVICE pPciDev)
287{
288 return RT_LE2H_U16(RT_MAKE_U16(pPciDev->config[VBOX_PCI_COMMAND], pPciDev->config[VBOX_PCI_COMMAND + 1]));
289}
290
291
292/**
293 * Sets the status config register.
294 *
295 * @param pPciDev The PCI device.
296 * @param u16Status The status register value.
297 */
298DECLINLINE(void) PCIDevSetStatus(PPCIDEVICE pPciDev, uint16_t u16Status)
299{
300 u16Status = RT_H2LE_U16(u16Status);
301 pPciDev->config[VBOX_PCI_STATUS] = u16Status & 0xff;
302 pPciDev->config[VBOX_PCI_STATUS + 1] = u16Status >> 8;
303}
304
305
306/**
307 * Sets the revision id config register.
308 *
309 * @param pPciDev The PCI device.
310 * @param u8RevisionId The revision id.
311 */
312DECLINLINE(void) PCIDevSetRevisionId(PPCIDEVICE pPciDev, uint8_t u8RevisionId)
313{
314 pPciDev->config[VBOX_PCI_REVISION_ID] = u8RevisionId;
315}
316
317
318/**
319 * Sets the register level programming class config register.
320 *
321 * @param pPciDev The PCI device.
322 * @param u8ClassProg The new value.
323 */
324DECLINLINE(void) PCIDevSetClassProg(PPCIDEVICE pPciDev, uint8_t u8ClassProg)
325{
326 pPciDev->config[VBOX_PCI_CLASS_PROG] = u8ClassProg;
327}
328
329
330/**
331 * Sets the sub-class (aka device class) config register.
332 *
333 * @param pPciDev The PCI device.
334 * @param u8SubClass The sub-class.
335 */
336DECLINLINE(void) PCIDevSetClassSub(PPCIDEVICE pPciDev, uint8_t u8SubClass)
337{
338 pPciDev->config[VBOX_PCI_CLASS_SUB] = u8SubClass;
339}
340
341
342/**
343 * Sets the base class config register.
344 *
345 * @param pPciDev The PCI device.
346 * @param u8BaseClass The base class.
347 */
348DECLINLINE(void) PCIDevSetClassBase(PPCIDEVICE pPciDev, uint8_t u8BaseClass)
349{
350 pPciDev->config[VBOX_PCI_CLASS_BASE] = u8BaseClass;
351}
352
353
354/**
355 * Sets the header type config register.
356 *
357 * @param pPciDev The PCI device.
358 * @param u8HdrType The header type.
359 */
360DECLINLINE(void) PCIDevSetHeaderType(PPCIDEVICE pPciDev, uint8_t u8HdrType)
361{
362 pPciDev->config[VBOX_PCI_HEADER_TYPE] = u8HdrType;
363}
364
365
366/**
367 * Sets a base address config register.
368 *
369 * @param pPciDev The PCI device.
370 * @param fIOSpace Whether it's I/O (true) or memory (false) space.
371 * @param fPrefetchable Whether the memory is prefetachable. Must be false if fIOSpace == true.
372 * @param f64Bit Whether the memory can be mapped anywhere in the 64-bit address space. Otherwise restrict to 32-bit.
373 * @param u32Addr The address value.
374 */
375DECLINLINE(void) PCIDevSetBaseAddress(PPCIDEVICE pPciDev, uint8_t iReg, bool fIOSpace, bool fPrefetchable, bool f64Bit, uint32_t u32Addr)
376{
377 if (fIOSpace)
378 {
379 Assert(!(u32Addr & 0x3)); Assert(!fPrefetchable); Assert(!f64Bit);
380 u32Addr |= RT_BIT_32(0);
381 }
382 else
383 {
384 Assert(!(u32Addr & 0xf));
385 if (fPrefetchable)
386 u32Addr |= RT_BIT_32(3);
387 if (f64Bit)
388 u32Addr |= 0x2 << 1;
389 }
390 switch (iReg)
391 {
392 case 0: iReg = VBOX_PCI_BASE_ADDRESS_0; break;
393 case 1: iReg = VBOX_PCI_BASE_ADDRESS_1; break;
394 case 2: iReg = VBOX_PCI_BASE_ADDRESS_2; break;
395 case 3: iReg = VBOX_PCI_BASE_ADDRESS_3; break;
396 case 4: iReg = VBOX_PCI_BASE_ADDRESS_4; break;
397 case 5: iReg = VBOX_PCI_BASE_ADDRESS_5; break;
398 default: AssertFailedReturnVoid();
399 }
400
401 u32Addr = RT_H2LE_U32(u32Addr);
402 pPciDev->config[iReg] = u32Addr & 0xff;
403 pPciDev->config[iReg + 1] = (u32Addr >> 8) & 0xff;
404 pPciDev->config[iReg + 2] = (u32Addr >> 16) & 0xff;
405 pPciDev->config[iReg + 3] = (u32Addr >> 24) & 0xff;
406}
407
408
409/**
410 * Sets the sub-system vendor id config register.
411 *
412 * @param pPciDev The PCI device.
413 * @param u16SubSysVendorId The sub-system vendor id.
414 */
415DECLINLINE(void) PCIDevSetSubSystemVendorId(PPCIDEVICE pPciDev, uint16_t u16SubSysVendorId)
416{
417 u16SubSysVendorId = RT_H2LE_U16(u16SubSysVendorId);
418 pPciDev->config[VBOX_PCI_SUBSYSTEM_VENDOR_ID] = u16SubSysVendorId & 0xff;
419 pPciDev->config[VBOX_PCI_SUBSYSTEM_VENDOR_ID + 1] = u16SubSysVendorId >> 8;
420}
421
422/**
423 * Gets the sub-system vendor id config register.
424 * @returns the sub-system vendor id.
425 * @param pPciDev The PCI device.
426 */
427DECLINLINE(uint16_t) PCIDevGetSubSystemVendorId(PPCIDEVICE pPciDev)
428{
429 return RT_LE2H_U16(RT_MAKE_U16(pPciDev->config[VBOX_PCI_SUBSYSTEM_VENDOR_ID], pPciDev->config[VBOX_PCI_SUBSYSTEM_VENDOR_ID + 1]));
430}
431
432
433/**
434 * Sets the sub-system id config register.
435 *
436 * @param pPciDev The PCI device.
437 * @param u16SubSystemId The sub-system id.
438 */
439DECLINLINE(void) PCIDevSetSubSystemId(PPCIDEVICE pPciDev, uint16_t u16SubSystemId)
440{
441 u16SubSystemId = RT_H2LE_U16(u16SubSystemId);
442 pPciDev->config[VBOX_PCI_SUBSYSTEM_ID] = u16SubSystemId & 0xff;
443 pPciDev->config[VBOX_PCI_SUBSYSTEM_ID + 1] = u16SubSystemId >> 8;
444}
445
446/**
447 * Gets the sub-system id config register.
448 * @returns the sub-system id.
449 * @param pPciDev The PCI device.
450 */
451DECLINLINE(uint16_t) PCIDevGetSubSystemId(PPCIDEVICE pPciDev)
452{
453 return RT_LE2H_U16(RT_MAKE_U16(pPciDev->config[VBOX_PCI_SUBSYSTEM_ID], pPciDev->config[VBOX_PCI_SUBSYSTEM_ID + 1]));
454}
455
456
457/**
458 * Sets the interrupt line config register.
459 *
460 * @param pPciDev The PCI device.
461 * @param u8Line The interrupt line.
462 */
463DECLINLINE(void) PCIDevSetInterruptLine(PPCIDEVICE pPciDev, uint8_t u8Line)
464{
465 pPciDev->config[VBOX_PCI_INTERRUPT_LINE] = u8Line;
466}
467
468
469/**
470 * Sets the interrupt pin config register.
471 *
472 * @param pPciDev The PCI device.
473 * @param u8Pin The interrupt pin.
474 */
475DECLINLINE(void) PCIDevSetInterruptPin(PPCIDEVICE pPciDev, uint8_t u8Pin)
476{
477 pPciDev->config[VBOX_PCI_INTERRUPT_PIN] = u8Pin;
478}
479
480
481/** @} */
482
483#endif
Note: See TracBrowser for help on using the repository browser.

© 2023 Oracle
Contact – Privacy policy – Terms of Use