VirtualBox

source: vbox/trunk/src/VBox/Devices/Bus/PCIInternal.h@ 35487

Last change on this file since 35487 was 35358, checked in by vboxsync, 14 years ago

backed out 69217

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 6.1 KB
Line 
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 */
24typedef 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. */
36typedef 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 */
48typedef DECLCALLBACK(uint32_t) FNPCIBRIDGECONFIGREAD(PPDMDEVINSR3 pDevIns, uint8_t iBus, uint8_t iDevice, uint32_t u32Address, unsigned cb);
49/** Pointer to a FNPCICONFIGREAD() function. */
50typedef FNPCIBRIDGECONFIGREAD *PFNPCIBRIDGECONFIGREAD;
51/** Pointer to a PFNPCICONFIGREAD. */
52typedef 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 */
65typedef 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. */
67typedef FNPCIBRIDGECONFIGWRITE *PFNPCIBRIDGECONFIGWRITE;
68/** Pointer to a PFNPCICONFIGWRITE. */
69typedef PFNPCIBRIDGECONFIGWRITE *PPFNPCIBRIDGECONFIGWRITE;
70
71/* Forward declaration */
72struct PCIBus;
73
74enum {
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 */
95typedef 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
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette