1 | /* $Id: PCIInternal.h 35358 2010-12-28 07:58:40Z vboxsync $ */
|
---|
2 | /** @file
|
---|
3 | * DevPCI - PCI Internal header - Only for hiding bits of PCIDEVICE.
|
---|
4 | */
|
---|
5 |
|
---|
6 | /*
|
---|
7 | * Copyright (C) 2006-2007 Oracle Corporation
|
---|
8 | *
|
---|
9 | * This file is part of VirtualBox Open Source Edition (OSE), as
|
---|
10 | * available from http://www.virtualbox.org. This file is free software;
|
---|
11 | * you can redistribute it and/or modify it under the terms of the GNU
|
---|
12 | * General Public License (GPL) as published by the Free Software
|
---|
13 | * Foundation, in version 2 as it comes in the "COPYING" file of the
|
---|
14 | * VirtualBox OSE distribution. VirtualBox OSE is distributed in the
|
---|
15 | * hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
|
---|
16 | */
|
---|
17 |
|
---|
18 | #ifndef __PCIInternal_h__
|
---|
19 | #define __PCIInternal_h__
|
---|
20 |
|
---|
21 | /**
|
---|
22 | * PCI I/O region.
|
---|
23 | */
|
---|
24 | typedef struct PCIIOREGION
|
---|
25 | {
|
---|
26 | /** Current PCI mapping address, 0xffffffff means not mapped.
|
---|
27 | @todo: make address and size 64-bit. */
|
---|
28 | uint32_t addr;
|
---|
29 | uint32_t size;
|
---|
30 | uint8_t type; /* PCIADDRESSSPACE */
|
---|
31 | uint8_t padding[HC_ARCH_BITS == 32 ? 3 : 7];
|
---|
32 | /** Callback called when the region is mapped. */
|
---|
33 | R3PTRTYPE(PFNPCIIOREGIONMAP) map_func;
|
---|
34 | } PCIIOREGION, PCIIORegion;
|
---|
35 | /** Pointer to PCI I/O region. */
|
---|
36 | typedef PCIIOREGION *PPCIIOREGION;
|
---|
37 |
|
---|
38 | /**
|
---|
39 | * Callback function for reading from the PCI configuration space.
|
---|
40 | *
|
---|
41 | * @returns The register value.
|
---|
42 | * @param pDevIns Pointer to the device instance of the PCI bus.
|
---|
43 | * @param iBus The bus number this device is on.
|
---|
44 | * @param iDevice The number of the device on the bus.
|
---|
45 | * @param Address The configuration space register address. [0..255]
|
---|
46 | * @param cb The register size. [1,2,4]
|
---|
47 | */
|
---|
48 | typedef DECLCALLBACK(uint32_t) FNPCIBRIDGECONFIGREAD(PPDMDEVINSR3 pDevIns, uint8_t iBus, uint8_t iDevice, uint32_t u32Address, unsigned cb);
|
---|
49 | /** Pointer to a FNPCICONFIGREAD() function. */
|
---|
50 | typedef FNPCIBRIDGECONFIGREAD *PFNPCIBRIDGECONFIGREAD;
|
---|
51 | /** Pointer to a PFNPCICONFIGREAD. */
|
---|
52 | typedef PFNPCIBRIDGECONFIGREAD *PPFNPCIBRIDGECONFIGREAD;
|
---|
53 |
|
---|
54 | /**
|
---|
55 | * Callback function for writing to the PCI configuration space.
|
---|
56 | *
|
---|
57 | * @param pDevIns Pointer to the device instance of the PCI bus.
|
---|
58 | * @param iBus The bus number this device is on.
|
---|
59 | * @param iDevice The number of the device on the bus.
|
---|
60 | * @param Address The configuration space register address. [0..255]
|
---|
61 | * @param u32Value The value that's being written. The number of bits actually used from
|
---|
62 | * this value is determined by the cb parameter.
|
---|
63 | * @param cb The register size. [1,2,4]
|
---|
64 | */
|
---|
65 | typedef DECLCALLBACK(void) FNPCIBRIDGECONFIGWRITE(PPDMDEVINSR3 pDevIns, uint8_t iBus, uint8_t iDevice, uint32_t u32Address, uint32_t u32Value, unsigned cb);
|
---|
66 | /** Pointer to a FNPCICONFIGWRITE() function. */
|
---|
67 | typedef FNPCIBRIDGECONFIGWRITE *PFNPCIBRIDGECONFIGWRITE;
|
---|
68 | /** Pointer to a PFNPCICONFIGWRITE. */
|
---|
69 | typedef PFNPCIBRIDGECONFIGWRITE *PPFNPCIBRIDGECONFIGWRITE;
|
---|
70 |
|
---|
71 | /* Forward declaration */
|
---|
72 | struct PCIBus;
|
---|
73 |
|
---|
74 | enum {
|
---|
75 | /** Set if the specific device function was requested by PDM.
|
---|
76 | * If clear the device and it's functions can be relocated to satisfy the slot request of another device. */
|
---|
77 | PCIDEV_FLAG_REQUESTED_DEVFUNC = 1<<0,
|
---|
78 | /** Flag whether the device is a pci-to-pci bridge.
|
---|
79 | * This is set prior to device registration. */
|
---|
80 | PCIDEV_FLAG_PCI_TO_PCI_BRIDGE = 1<<1,
|
---|
81 | /** Flag whether the device is a PCI Express device.
|
---|
82 | * This is set prior to device registration. */
|
---|
83 | PCIDEV_FLAG_PCI_EXPRESS_DEVICE = 1<<2,
|
---|
84 | /** Flag whether the device is capable of MSI.
|
---|
85 | * This one is set by MsiInit(). */
|
---|
86 | PCIDEV_FLAG_MSI_CAPABLE = 1<<3,
|
---|
87 | /** Flag whether the device is capable of MSI-X.
|
---|
88 | * This one is set by MsixInit(). */
|
---|
89 | PCIDEV_FLAG_MSIX_CAPABLE = 1<<4
|
---|
90 | };
|
---|
91 |
|
---|
92 | /**
|
---|
93 | * PCI Device - Internal data.
|
---|
94 | */
|
---|
95 | typedef struct PCIDEVICEINT
|
---|
96 | {
|
---|
97 | /** I/O regions. */
|
---|
98 | PCIIOREGION aIORegions[PCI_NUM_REGIONS];
|
---|
99 | /** Pointer to the PCI bus of the device. - R3 ptr */
|
---|
100 | R3PTRTYPE(struct PCIBus *) pBusR3;
|
---|
101 | /** Pointer to the PCI bus of the device. - R0 ptr */
|
---|
102 | R0PTRTYPE(struct PCIBus *) pBusR0;
|
---|
103 | /** Pointer to the PCI bus of the device. - RC ptr */
|
---|
104 | RCPTRTYPE(struct PCIBus *) pBusRC;
|
---|
105 | #if HC_ARCH_BITS == 64
|
---|
106 | RTRCPTR Alignment0;
|
---|
107 | #endif
|
---|
108 |
|
---|
109 | /* Page used for MSI-X state. - R3 ptr */
|
---|
110 | R3PTRTYPE(void*) pMsixPageR3;
|
---|
111 | /* Page used for MSI-X state. - R0 ptr */
|
---|
112 | R0PTRTYPE(void*) pMsixPageR0;
|
---|
113 | /* Page used for MSI-X state. - RC ptr */
|
---|
114 | RCPTRTYPE(void*) pMsixPageRC;
|
---|
115 | #if HC_ARCH_BITS == 64
|
---|
116 | RTRCPTR Alignment1;
|
---|
117 | #endif
|
---|
118 |
|
---|
119 |
|
---|
120 | /** Read config callback. */
|
---|
121 | R3PTRTYPE(PFNPCICONFIGREAD) pfnConfigRead;
|
---|
122 | /** Write config callback. */
|
---|
123 | R3PTRTYPE(PFNPCICONFIGWRITE) pfnConfigWrite;
|
---|
124 |
|
---|
125 | /* Flags of this PCI device, see PCIDEV_FLAG_ constants */
|
---|
126 | uint32_t uFlags;
|
---|
127 | /** Current state of the IRQ pin of the device. */
|
---|
128 | int32_t uIrqPinState;
|
---|
129 |
|
---|
130 | /* Offset of MSI PCI capability in config space, or 0 */
|
---|
131 | uint8_t u8MsiCapOffset;
|
---|
132 | /* Size of MSI PCI capability in config space, or 0 */
|
---|
133 | uint8_t u8MsiCapSize;
|
---|
134 | /* Offset of MSI-X PCI capability in config space, or 0 */
|
---|
135 | uint8_t u8MsixCapOffset;
|
---|
136 | /* Size of MSI-X PCI capability in config space, or 0 */
|
---|
137 | uint8_t u8MsixCapSize;
|
---|
138 |
|
---|
139 | uint32_t Alignment2;
|
---|
140 |
|
---|
141 | /* Pointer to bus specific data. - R3 ptr */
|
---|
142 | R3PTRTYPE(const void*) pPciBusPtrR3;
|
---|
143 |
|
---|
144 | /** Read config callback for PCI bridges to pass requests
|
---|
145 | * to devices on another bus.
|
---|
146 | */
|
---|
147 | R3PTRTYPE(PFNPCIBRIDGECONFIGREAD) pfnBridgeConfigRead;
|
---|
148 | /** Write config callback for PCI bridges to pass requests
|
---|
149 | * to devices on another bus.
|
---|
150 | */
|
---|
151 | R3PTRTYPE(PFNPCIBRIDGECONFIGWRITE) pfnBridgeConfigWrite;
|
---|
152 |
|
---|
153 | } PCIDEVICEINT;
|
---|
154 |
|
---|
155 | /* Indicate that PCIDEVICE::Int.s can be declared. */
|
---|
156 | #define PCIDEVICEINT_DECLARED
|
---|
157 |
|
---|
158 | #endif
|
---|