VirtualBox

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

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

PCI: cleanup, todos, raw PCI regions work
  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 45.4 KB
Line 
1/** @file
2 * PCI - The PCI Controller And Devices. (DEV)
3 */
4
5/*
6 * Copyright (C) 2006-2007 Oracle Corporation
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
26#ifndef ___VBox_pci_h
27#define ___VBox_pci_h
28
29#include <VBox/cdefs.h>
30#include <VBox/types.h>
31#include <iprt/assert.h>
32
33/** @defgroup grp_pci PCI - The PCI Controller.
34 * @{
35 */
36
37/** Pointer to a PCI device. */
38typedef struct PCIDevice *PPCIDEVICE;
39
40
41/**
42 * PCI configuration word 4 (command) and word 6 (status).
43 */
44typedef enum PCICONFIGCOMMAND
45{
46 /** Supports/uses memory accesses. */
47 PCI_COMMAND_IOACCESS = 0x0001,
48 PCI_COMMAND_MEMACCESS = 0x0002,
49 PCI_COMMAND_BUSMASTER = 0x0004
50} PCICONFIGCOMMAND;
51
52
53/**
54 * PCI Address space specification.
55 * This is used when registering a I/O region.
56 */
57/** Note: There are all sorts of dirty dependencies on the values in the
58 * pci device. Be careful when changing this.
59 */
60typedef enum PCIADDRESSSPACE
61{
62 /** Memory. */
63 PCI_ADDRESS_SPACE_MEM = 0x00,
64 /** I/O space. */
65 PCI_ADDRESS_SPACE_IO = 0x01,
66 /** 32-bit BAR. */
67 PCI_ADDRESS_SPACE_BAR32 = 0x00,
68 /** 64-bit BAR. */
69 PCI_ADDRESS_SPACE_BAR64 = 0x04,
70 /** Prefetch memory. */
71 PCI_ADDRESS_SPACE_MEM_PREFETCH = 0x08
72} PCIADDRESSSPACE;
73
74
75/**
76 * Callback function for mapping an PCI I/O region.
77 *
78 * @return VBox status code.
79 * @param pPciDev Pointer to PCI device. Use pPciDev->pDevIns to get the device instance.
80 * @param iRegion The region number.
81 * @param GCPhysAddress Physical address of the region. If enmType is PCI_ADDRESS_SPACE_IO, this
82 * is an I/O port, otherwise it's a physical address.
83 *
84 * NIL_RTGCPHYS indicates that a MMIO2 mapping is about to be unmapped and
85 * that the device deregister access handlers for it and update its internal
86 * state to reflect this.
87 *
88 * @param enmType One of the PCI_ADDRESS_SPACE_* values.
89 *
90 * @remarks The address is *NOT* relative to pci_mem_base.
91 */
92typedef DECLCALLBACK(int) FNPCIIOREGIONMAP(PPCIDEVICE pPciDev, /*unsigned*/ int iRegion, RTGCPHYS GCPhysAddress, uint32_t cb, PCIADDRESSSPACE enmType);
93/** Pointer to a FNPCIIOREGIONMAP() function. */
94typedef FNPCIIOREGIONMAP *PFNPCIIOREGIONMAP;
95
96
97/** @name PCI Configuration Space Registers
98 * @{ */
99/* Commented out values common for different header types */
100/* Common part of the header */
101#define VBOX_PCI_VENDOR_ID 0x00 /**< 16-bit RO */
102#define VBOX_PCI_DEVICE_ID 0x02 /**< 16-bit RO */
103#define VBOX_PCI_COMMAND 0x04 /**< 16-bit RW, some bits RO */
104#define VBOX_PCI_STATUS 0x06 /**< 16-bit RW, some bits RO */
105#define VBOX_PCI_REVISION_ID 0x08 /**< 8-bit RO - - device revision */
106#define VBOX_PCI_CLASS_PROG 0x09 /**< 8-bit RO - - register-level programming class code (device specific). */
107#define VBOX_PCI_CLASS_SUB 0x0a /**< 8-bit RO - - sub-class code. */
108#define VBOX_PCI_CLASS_DEVICE VBOX_PCI_CLASS_SUB
109#define VBOX_PCI_CLASS_BASE 0x0b /**< 8-bit RO - - base class code. */
110#define VBOX_PCI_CACHE_LINE_SIZE 0x0c /**< 8-bit RW - - system cache line size */
111#define VBOX_PCI_LATENCY_TIMER 0x0d /**< 8-bit RW - - master latency timer, hardwired to 0 for PCIe */
112#define VBOX_PCI_HEADER_TYPE 0x0e /**< 8-bit RO - - header type (0 - device, 1 - bridge, 2 - CardBus bridge) */
113#define VBOX_PCI_BIST 0x0f /**< 8-bit RW - - built-in self test control */
114#define VBOX_PCI_CAPABILITY_LIST 0x34 /**< 8-bit RO? - - linked list of new capabilities implemented by the device, 2 bottom bits reserved */
115#define VBOX_PCI_INTERRUPT_LINE 0x3c /**< 8-bit RW - - interrupt line. */
116#define VBOX_PCI_INTERRUPT_PIN 0x3d /**< 8-bit RO - - interrupt pin. */
117
118/* Type 0 header, device */
119#define VBOX_PCI_BASE_ADDRESS_0 0x10 /**< 32-bit RW */
120#define VBOX_PCI_BASE_ADDRESS_1 0x14 /**< 32-bit RW */
121#define VBOX_PCI_BASE_ADDRESS_2 0x18 /**< 32-bit RW */
122#define VBOX_PCI_BASE_ADDRESS_3 0x1c /**< 32-bit RW */
123#define VBOX_PCI_BASE_ADDRESS_4 0x20 /**< 32-bit RW */
124#define VBOX_PCI_BASE_ADDRESS_5 0x24 /**< 32-bit RW */
125#define VBOX_PCI_CARDBUS_CIS 0x28 /**< 32-bit ?? */
126#define VBOX_PCI_SUBSYSTEM_VENDOR_ID 0x2c /**< 16-bit RO */
127#define VBOX_PCI_SUBSYSTEM_ID 0x2e /**< 16-bit RO */
128#define VBOX_PCI_ROM_ADDRESS 0x30 /**< 32-bit ?? */
129/* #define VBOX_PCI_CAPABILITY_LIST 0x34 */ /**< 8-bit? ?? */
130#define VBOX_PCI_RESERVED_35 0x35 /**< 8-bit ?? - - reserved */
131#define VBOX_PCI_RESERVED_36 0x36 /**< 8-bit ?? - - reserved */
132#define VBOX_PCI_RESERVED_37 0x37 /**< 8-bit ?? - - reserved */
133#define VBOX_PCI_RESERVED_38 0x38 /**< 32-bit ?? - - reserved */
134/* #define VBOX_PCI_INTERRUPT_LINE 0x3c */ /**< 8-bit RW - - interrupt line. */
135/* #define VBOX_PCI_INTERRUPT_PIN 0x3d */ /**< 8-bit RO - - interrupt pin. */
136#define VBOX_PCI_MIN_GNT 0x3e /**< 8-bit RO - - burst period length (in 1/4 microsecond units) */
137#define VBOX_PCI_MAX_LAT 0x3f /**< 8-bit RO - - how often the device needs access to the PCI bus (in 1/4 microsecond units) */
138
139/* Type 1 header, PCI-to-PCI bridge */
140/* #define VBOX_PCI_BASE_ADDRESS_0 0x10 */ /**< 32-bit RW */
141/* #define VBOX_PCI_BASE_ADDRESS_1 0x14 */ /**< 32-bit RW */
142#define VBOX_PCI_PRIMARY_BUS 0x18 /**< 8-bit ?? - - primary bus number. */
143#define VBOX_PCI_SECONDARY_BUS 0x19 /**< 8-bit ?? - - secondary bus number. */
144#define VBOX_PCI_SUBORDINATE_BUS 0x1a /**< 8-bit ?? - - highest subordinate bus number. (behind the bridge) */
145#define VBOX_PCI_SEC_LATENCY_TIMER 0x1b /**< 8-bit ?? - - secondary latency timer. */
146#define VBOX_PCI_IO_BASE 0x1c /**< 8-bit ?? - - I/O range base. */
147#define VBOX_PCI_IO_LIMIT 0x1d /**< 8-bit ?? - - I/O range limit. */
148#define VBOX_PCI_SEC_STATUS 0x1e /**< 16-bit ?? - - secondary status register. */
149#define VBOX_PCI_MEMORY_BASE 0x20 /**< 16-bit ?? - - memory range base. */
150#define VBOX_PCI_MEMORY_LIMIT 0x22 /**< 16-bit ?? - - memory range limit. */
151#define VBOX_PCI_PREF_MEMORY_BASE 0x24 /**< 16-bit ?? - - prefetchable memory range base. */
152#define VBOX_PCI_PREF_MEMORY_LIMIT 0x26 /**< 16-bit ?? - - prefetchable memory range limit. */
153#define VBOX_PCI_PREF_BASE_UPPER32 0x28 /**< 32-bit ?? - - prefetchable memory range high base.*/
154#define VBOX_PCI_PREF_LIMIT_UPPER32 0x2c /**< 32-bit ?? - - prefetchable memory range high limit. */
155#define VBOX_PCI_IO_BASE_UPPER16 0x30 /**< 16-bit ?? - - memory range high base. */
156#define VBOX_PCI_IO_LIMIT_UPPER16 0x32 /**< 16-bit ?? - - memory range high limit. */
157/* #define VBOX_PCI_CAPABILITY_LIST 0x34 */ /**< 8-bit? ?? */
158/* #define VBOX_PCI_RESERVED_35 0x35 */ /**< 8-bit ?? - - reserved */
159/* #define VBOX_PCI_RESERVED_36 0x36 */ /**< 8-bit ?? - - reserved */
160/* #define VBOX_PCI_RESERVED_37 0x37 */ /**< 8-bit ?? - - reserved */
161#define VBOX_PCI_ROM_ADDRESS_BR 0x38 /**< 32-bit ?? - - expansion ROM base address */
162#define VBOX_PCI_BRIDGE_CONTROL 0x3e /**< 16-bit? ?? - - bridge control */
163
164/* Type 2 header, PCI-to-CardBus bridge */
165#define VBOX_PCI_CARDBUS_BASE_ADDRESS 0x10 /**< 32-bit RW - - CardBus Socket/ExCa base address */
166#define VBOX_PCI_CARDBUS_CAPLIST 0x14 /**< 8-bit RO? - - offset of capabilities list */
167#define VBOX_PCI_CARDBUS_RESERVED_15 0x15 /**< 8-bit ?? - - reserved */
168#define VBOX_PCI_CARDBUS_SEC_STATUS 0x16 /**< 16-bit ?? - - secondary status */
169#define VBOX_PCI_CARDBUS_PCIBUS_NUMBER 0x18 /**< 8-bit ?? - - PCI bus number */
170#define VBOX_PCI_CARDBUS_CARDBUS_NUMBER 0x19 /**< 8-bit ?? - - CardBus bus number */
171/* #define VBOX_PCI_SUBORDINATE_BUS 0x1a */ /**< 8-bit ?? - - highest subordinate bus number. (behind the bridge) */
172/* #define VBOX_PCI_SEC_LATENCY_TIMER 0x1b */ /**< 8-bit ?? - - secondary latency timer. */
173#define VBOX_PCI_CARDBUS_MEMORY_BASE0 0x1c /**< 32-bit RW - - memory base address 0 */
174#define VBOX_PCI_CARDBUS_MEMORY_LIMIT0 0x20 /**< 32-bit RW - - memory limit 0 */
175#define VBOX_PCI_CARDBUS_MEMORY_BASE1 0x24 /**< 32-bit RW - - memory base address 1 */
176#define VBOX_PCI_CARDBUS_MEMORY_LIMIT1 0x28 /**< 32-bit RW - - memory limit 1 */
177#define VBOX_PCI_CARDBUS_IO_BASE0 0x2c /**< 32-bit RW - - IO base address 0 */
178#define VBOX_PCI_CARDBUS_IO_LIMIT0 0x30 /**< 32-bit RW - - IO limit 0 */
179#define VBOX_PCI_CARDBUS_IO_BASE1 0x34 /**< 32-bit RW - - IO base address 1 */
180#define VBOX_PCI_CARDBUS_IO_LIMIT1 0x38 /**< 32-bit RW - - IO limit 1 */
181/* #define VBOX_PCI_INTERRUPT_LINE 0x3c */ /**< 8-bit RW - - interrupt line. */
182/* #define VBOX_PCI_INTERRUPT_PIN 0x3d */ /**< 8-bit RO - - interrupt pin. */
183/* #define VBOX_PCI_BRIDGE_CONTROL 0x3e */ /**< 16-bit? ?? - - bridge control */
184/** @} */
185
186
187/* Possible values in status bitmask */
188#define VBOX_PCI_STATUS_CAP_LIST 0x10 /* Support Capability List */
189#define VBOX_PCI_STATUS_66MHZ 0x20 /* Support 66 Mhz PCI 2.1 bus */
190#define VBOX_PCI_STATUS_UDF 0x40 /* Support User Definable Features [obsolete] */
191#define VBOX_PCI_STATUS_FAST_BACK 0x80 /* Accept fast-back to back */
192#define VBOX_PCI_STATUS_PARITY 0x100 /* Detected parity error */
193#define VBOX_PCI_STATUS_DEVSEL_MASK 0x600 /* DEVSEL timing */
194#define VBOX_PCI_STATUS_DEVSEL_FAST 0x000
195#define VBOX_PCI_STATUS_DEVSEL_MEDIUM 0x200
196#define VBOX_PCI_STATUS_DEVSEL_SLOW 0x400
197#define VBOX_PCI_STATUS_SIG_TARGET_ABORT 0x800 /* Set on target abort */
198#define VBOX_PCI_STATUS_REC_TARGET_ABORT 0x1000 /* Master ack of " */
199#define VBOX_PCI_STATUS_REC_MASTER_ABORT 0x2000 /* Set on master abort */
200#define VBOX_PCI_STATUS_SIG_SYSTEM_ERROR 0x4000 /* Set when we drive SERR */
201#define VBOX_PCI_STATUS_DETECTED_PARITY 0x8000 /* Set on parity error */
202
203
204/* Command bitmask */
205#define VBOX_PCI_COMMAND_IO 0x1 /* Enable response in I/O space */
206#define VBOX_PCI_COMMAND_MEMORY 0x2 /* Enable response in Memory space */
207#define VBOX_PCI_COMMAND_MASTER 0x4 /* Enable bus mastering */
208#define VBOX_PCI_COMMAND_SPECIAL 0x8 /* Enable response to special cycles */
209#define VBOX_PCI_COMMAND_INVALIDATE 0x10 /* Use memory write and invalidate */
210#define VBOX_PCI_COMMAND_VGA_PALETTE 0x20 /* Enable palette snooping */
211#define VBOX_PCI_COMMAND_PARITY 0x40 /* Enable parity checking */
212#define VBOX_PCI_COMMAND_WAIT 0x80 /* Enable address/data stepping */
213#define VBOX_PCI_COMMAND_SERR 0x100 /* Enable SERR */
214#define VBOX_PCI_COMMAND_FAST_BACK 0x200 /* Enable back-to-back writes */
215#define VBOX_PCI_COMMAND_INTX_DISABLE 0x400 /* INTx Emulation Disable */
216
217
218/* Capability list values (capability offset 0) */
219/* Next value pointer in offset 1, or 0 if none */
220#define VBOX_PCI_CAP_ID_PM 0x01 /* Power Management */
221#define VBOX_PCI_CAP_ID_AGP 0x02 /* Accelerated Graphics Port */
222#define VBOX_PCI_CAP_ID_VPD 0x03 /* Vital Product Data */
223#define VBOX_PCI_CAP_ID_SLOTID 0x04 /* Slot Identification */
224#define VBOX_PCI_CAP_ID_MSI 0x05 /* Message Signalled Interrupts */
225#define VBOX_PCI_CAP_ID_CHSWP 0x06 /* CompactPCI HotSwap */
226#define VBOX_PCI_CAP_ID_PCIX 0x07 /* PCI-X */
227#define VBOX_PCI_CAP_ID_HT 0x08 /* HyperTransport */
228#define VBOX_PCI_CAP_ID_VNDR 0x09 /* Vendor specific */
229#define VBOX_PCI_CAP_ID_DBG 0x0A /* Debug port */
230#define VBOX_PCI_CAP_ID_CCRC 0x0B /* CompactPCI Central Resource Control */
231#define VBOX_PCI_CAP_ID_SHPC 0x0C /* PCI Standard Hot-Plug Controller */
232#define VBOX_PCI_CAP_ID_SSVID 0x0D /* Bridge subsystem vendor/device ID */
233#define VBOX_PCI_CAP_ID_AGP3 0x0E /* AGP Target PCI-PCI bridge */
234#define VBOX_PCI_CAP_ID_SECURE 0x0F /* Secure device (?) */
235#define VBOX_PCI_CAP_ID_EXP 0x10 /* PCI Express */
236#define VBOX_PCI_CAP_ID_MSIX 0x11 /* MSI-X */
237#define VBOX_PCI_CAP_ID_SATA 0x12 /* Serial-ATA HBA */
238#define VBOX_PCI_CAP_ID_AF 0x13 /* PCI Advanced Features */
239
240/* Extended Capabilities (PCI-X 2.0 and Express), start at 0x100, next - bits [20..32] */
241#define VBOX_PCI_EXT_CAP_ID_ERR 0x01 /* Advanced Error Reporting */
242#define VBOX_PCI_EXT_CAP_ID_VC 0x02 /* Virtual Channel */
243#define VBOX_PCI_EXT_CAP_ID_DSN 0x03 /* Device Serial Number */
244#define VBOX_PCI_EXT_CAP_ID_PWR 0x04 /* Power Budgeting */
245#define VBOX_PCI_EXT_CAP_ID_RCLINK 0x05 /* Root Complex Link Declaration */
246#define VBOX_PCI_EXT_CAP_ID_RCILINK 0x06 /* Root Complex Internal Link Declaration */
247#define VBOX_PCI_EXT_CAP_ID_RCECOLL 0x07 /* Root Complex Event Collector */
248#define VBOX_PCI_EXT_CAP_ID_MFVC 0x08 /* Multi-Function Virtual Channel */
249#define VBOX_PCI_EXT_CAP_ID_RBCB 0x0a /* Root Bridge Control Block */
250#define VBOX_PCI_EXT_CAP_ID_VNDR 0x0b /* Vendor specific */
251#define VBOX_PCI_EXT_CAP_ID_ACS 0x0d /* Access Controls */
252#define VBOX_PCI_EXT_CAP_ID_ARI 0x0e
253#define VBOX_PCI_EXT_CAP_ID_ATS 0x0f
254#define VBOX_PCI_EXT_CAP_ID_SRIOV 0x10
255
256
257/* MSI flags, aka Message Control (2 bytes, capability offset 2) */
258#define VBOX_PCI_MSI_FLAGS_ENABLE 0x0001 /* MSI feature enabled */
259#define VBOX_PCI_MSI_FLAGS_64BIT 0x0080 /* 64-bit addresses allowed */
260#define VBOX_PCI_MSI_FLAGS_MASKBIT 0x0100 /* Per-vector masking support */
261/* Encoding for 3-bit patterns for message queue (per chapter 6.8.1 of PCI spec),
262 someone very similar to log_2().
263 000 1
264 001 2
265 010 4
266 011 8
267 100 16
268 101 32
269 110 Reserved
270 111 Reserved */
271#define VBOX_PCI_MSI_FLAGS_QSIZE 0x0070 /* Message queue size configured (i.e. vectors per device allocated) */
272#define VBOX_PCI_MSI_FLAGS_QMASK 0x000e /* Maximum queue size available (i.e. vectors per device possible) */
273
274/* MSI-X flags (2 bytes, capability offset 2) */
275#define VBOX_PCI_MSIX_FLAGS_ENABLE 0x8000 /* MSI-X enable */
276#define VBOX_PCI_MSIX_FLAGS_FUNCMASK 0x4000 /* Function mask */
277
278/* Power management flags (2 bytes, capability offset 2) */
279#define VBOX_PCI_PM_CAP_VER_MASK 0x0007 /* Version mask */
280#define VBOX_PCI_PM_CAP_PME_CLOCK 0x0008 /* PME clock required */
281#define VBOX_PCI_PM_CAP_RESERVED 0x0010 /* Reserved field */
282#define VBOX_PCI_PM_CAP_DSI 0x0020 /* Device specific initialization */
283#define VBOX_PCI_PM_CAP_AUX_POWER 0x01C0 /* Auxilliary power support mask */
284#define VBOX_PCI_PM_CAP_D1 0x0200 /* D1 power state support */
285#define VBOX_PCI_PM_CAP_D2 0x0400 /* D2 power state support */
286#define VBOX_PCI_PM_CAP_PME 0x0800 /* PME pin supported */
287#define VBOX_PCI_PM_CAP_PME_MASK 0xF800 /* PME Mask of all supported states */
288#define VBOX_PCI_PM_CAP_PME_D0 0x0800 /* PME# from D0 */
289#define VBOX_PCI_PM_CAP_PME_D1 0x1000 /* PME# from D1 */
290#define VBOX_PCI_PM_CAP_PME_D2 0x2000 /* PME# from D2 */
291#define VBOX_PCI_PM_CAP_PME_D3 0x4000 /* PME# from D3 (hot) */
292#define VBOX_PCI_PM_CAP_PME_D3cold 0x8000 /* PME# from D3 (cold) */
293
294/* Power management control flags (2 bytes, capability offset 4) */
295#define VBOX_PCI_PM_CTRL_STATE_MASK 0x0003 /* Current power state (D0 to D3) */
296#define VBOX_PCI_PM_CTRL_NO_SOFT_RESET 0x0008 /* No reset for D3hot->D0 */
297#define VBOX_PCI_PM_CTRL_PME_ENABLE 0x0100 /* PME pin enable */
298#define VBOX_PCI_PM_CTRL_DATA_SEL_MASK 0x1e00 /* Data select (??) */
299#define VBOX_PCI_PM_CTRL_DATA_SCALE_MASK 0x6000 /* Data scale (??) */
300#define VBOX_PCI_PM_CTRL_PME_STATUS 0x8000 /* PME pin status */
301
302/* PCI-X config flags (2 bytes, capability offset 2) */
303#define VBOX_PCI_X_CMD_DPERR_E 0x0001 /* Data Parity Error Recovery Enable */
304#define VBOX_PCI_X_CMD_ERO 0x0002 /* Enable Relaxed Ordering */
305#define VBOX_PCI_X_CMD_MAX_OUTSTANDING_SPLIT_TRANS 0x0070
306#define VBOX_PCI_X_CMD_READ_512 0x0000 /* 512 byte maximum read byte count */
307#define VBOX_PCI_X_CMD_READ_1K 0x0004 /* 1Kbyte maximum read byte count */
308#define VBOX_PCI_X_CMD_READ_2K 0x0008 /* 2Kbyte maximum read byte count */
309#define VBOX_PCI_X_CMD_READ_4K 0x000c /* 4Kbyte maximum read byte count */
310#define VBOX_PCI_X_CMD_MAX_READ 0x000c /* Max Memory Read Byte Count */
311
312/* PCI-X config flags (4 bytes, capability offset 4) */
313#define VBOX_PCI_X_STATUS_DEVFN 0x000000ff /* A copy of devfn */
314#define VBOX_PCI_X_STATUS_BUS 0x0000ff00 /* A copy of bus nr */
315#define VBOX_PCI_X_STATUS_64BIT 0x00010000 /* 64-bit device */
316#define VBOX_PCI_X_STATUS_133MHZ 0x00020000 /* 133 MHz capable */
317#define VBOX_PCI_X_STATUS_SPL_DISC 0x00040000 /* Split Completion Discarded */
318#define VBOX_PCI_X_STATUS_UNX_SPL 0x00080000 /* Unexpected Split Completion */
319#define VBOX_PCI_X_STATUS_COMPLEX 0x00100000 /* Device Complexity, 0 = simple device, 1 = bridge device */
320#define VBOX_PCI_X_STATUS_MAX_READ 0x00600000 /* Designed Max Memory Read Count, 0 = 512 bytes, 1 = 1024, 2 = 2048, 3 = 4096 */
321#define VBOX_PCI_X_STATUS_MAX_SPLIT 0x03800000 /* Designed Max Outstanding Split Transactions */
322#define VBOX_PCI_X_STATUS_MAX_CUM 0x1c000000 /* Designed Max Cumulative Read Size */
323#define VBOX_PCI_X_STATUS_SPL_ERR 0x20000000 /* Rcvd Split Completion Error Msg */
324#define VBOX_PCI_X_STATUS_266MHZ 0x40000000 /* 266 MHz capable */
325#define VBOX_PCI_X_STATUS_533MHZ 0x80000000 /* 533 MHz capable */
326
327/* PCI Express config flags (2 bytes, capability offset 2) */
328#define VBOX_PCI_EXP_FLAGS_VERS 0x000f /* Capability version */
329#define VBOX_PCI_EXP_FLAGS_TYPE 0x00f0 /* Device/Port type */
330#define VBOX_PCI_EXP_TYPE_ENDPOINT 0x0 /* Express Endpoint */
331#define VBOX_PCI_EXP_TYPE_LEG_END 0x1 /* Legacy Endpoint */
332#define VBOX_PCI_EXP_TYPE_ROOT_PORT 0x4 /* Root Port */
333#define VBOX_PCI_EXP_TYPE_UPSTREAM 0x5 /* Upstream Port */
334#define VBOX_PCI_EXP_TYPE_DOWNSTREAM 0x6 /* Downstream Port */
335#define VBOX_PCI_EXP_TYPE_PCI_BRIDGE 0x7 /* PCI/PCI-X Bridge */
336#define VBOX_PCI_EXP_TYPE_PCIE_BRIDGE 0x8 /* PCI/PCI-X to PCIE Bridge */
337#define VBOX_PCI_EXP_TYPE_ROOT_INT_EP 0x9 /* Root Complex Integrated Endpoint */
338#define VBOX_PCI_EXP_TYPE_ROOT_EC 0xa /* Root Complex Event Collector */
339#define VBOX_PCI_EXP_FLAGS_SLOT 0x0100 /* Slot implemented */
340#define VBOX_PCI_EXP_FLAGS_IRQ 0x3e00 /* Interrupt message number */
341
342/* PCI Express device capabilities (4 bytes, capability offset 4) */
343#define VBOX_PCI_EXP_DEVCAP_PAYLOAD 0x07 /* Max_Payload_Size */
344#define VBOX_PCI_EXP_DEVCAP_PHANTOM 0x18 /* Phantom functions */
345#define VBOX_PCI_EXP_DEVCAP_EXT_TAG 0x20 /* Extended tags */
346#define VBOX_PCI_EXP_DEVCAP_L0S 0x1c0 /* L0s Acceptable Latency */
347#define VBOX_PCI_EXP_DEVCAP_L1 0xe00 /* L1 Acceptable Latency */
348#define VBOX_PCI_EXP_DEVCAP_ATN_BUT 0x1000 /* Attention Button Present */
349#define VBOX_PCI_EXP_DEVCAP_ATN_IND 0x2000 /* Attention Indicator Present */
350#define VBOX_PCI_EXP_DEVCAP_PWR_IND 0x4000 /* Power Indicator Present */
351#define VBOX_PCI_EXP_DEVCAP_RBE 0x8000 /* Role-Based Error Reporting */
352#define VBOX_PCI_EXP_DEVCAP_PWR_VAL 0x3fc0000 /* Slot Power Limit Value */
353#define VBOX_PCI_EXP_DEVCAP_PWR_SCL 0xc000000 /* Slot Power Limit Scale */
354#define VBOX_PCI_EXP_DEVCAP_FLRESET 0x10000000 /* Function-Level Reset */
355
356/* PCI Express device control (2 bytes, capability offset 8) */
357#define VBOX_PCI_EXP_DEVCTL_CERE 0x0001 /* Correctable Error Reporting En. */
358#define VBOX_PCI_EXP_DEVCTL_NFERE 0x0002 /* Non-Fatal Error Reporting Enable */
359#define VBOX_PCI_EXP_DEVCTL_FERE 0x0004 /* Fatal Error Reporting Enable */
360#define VBOX_PCI_EXP_DEVCTL_URRE 0x0008 /* Unsupported Request Reporting En. */
361#define VBOX_PCI_EXP_DEVCTL_RELAXED 0x0010 /* Enable Relaxed Ordering */
362#define VBOX_PCI_EXP_DEVCTL_PAYLOAD 0x00e0 /* Max_Payload_Size */
363#define VBOX_PCI_EXP_DEVCTL_EXT_TAG 0x0100 /* Extended Tag Field Enable */
364#define VBOX_PCI_EXP_DEVCTL_PHANTOM 0x0200 /* Phantom Functions Enable */
365#define VBOX_PCI_EXP_DEVCTL_AUX_PME 0x0400 /* Auxiliary Power PM Enable */
366#define VBOX_PCI_EXP_DEVCTL_NOSNOOP 0x0800 /* Enable No Snoop */
367#define VBOX_PCI_EXP_DEVCTL_READRQ 0x7000 /* Max_Read_Request_Size */
368#define VBOX_PCI_EXP_DEVCTL_BCRE 0x8000 /* Bridge Configuration Retry Enable */
369#define VBOX_PCI_EXP_DEVCTL_FLRESET 0x8000 /* Function-Level Reset [bit shared with BCRE] */
370
371/* PCI Express device status (2 bytes, capability offset 10) */
372#define VBOX_PCI_EXP_DEVSTA_CED 0x01 /* Correctable Error Detected */
373#define VBOX_PCI_EXP_DEVSTA_NFED 0x02 /* Non-Fatal Error Detected */
374#define VBOX_PCI_EXP_DEVSTA_FED 0x04 /* Fatal Error Detected */
375#define VBOX_PCI_EXP_DEVSTA_URD 0x08 /* Unsupported Request Detected */
376#define VBOX_PCI_EXP_DEVSTA_AUXPD 0x10 /* AUX Power Detected */
377#define VBOX_PCI_EXP_DEVSTA_TRPND 0x20 /* Transactions Pending */
378
379/* PCI Express link capabilities (4 bytes, capability offset 12) */
380#define VBOX_PCI_EXP_LNKCAP_SPEED 0x0000f /* Maximum Link Speed */
381#define VBOX_PCI_EXP_LNKCAP_WIDTH 0x003f0 /* Maximum Link Width */
382#define VBOX_PCI_EXP_LNKCAP_ASPM 0x00c00 /* Active State Power Management */
383#define VBOX_PCI_EXP_LNKCAP_L0S 0x07000 /* L0s Acceptable Latency */
384#define VBOX_PCI_EXP_LNKCAP_L1 0x38000 /* L1 Acceptable Latency */
385#define VBOX_PCI_EXP_LNKCAP_CLOCKPM 0x40000 /* Clock Power Management */
386#define VBOX_PCI_EXP_LNKCAP_SURPRISE 0x80000 /* Surprise Down Error Reporting */
387#define VBOX_PCI_EXP_LNKCAP_DLLA 0x100000 /* Data Link Layer Active Reporting */
388#define VBOX_PCI_EXP_LNKCAP_LBNC 0x200000 /* Link Bandwidth Notification Capability */
389#define VBOX_PCI_EXP_LNKCAP_PORT 0xff000000 /* Port Number */
390
391/* PCI Express link control (2 bytes, capability offset 16) */
392#define VBOX_PCI_EXP_LNKCTL_ASPM 0x0003 /* ASPM Control */
393#define VBOX_PCI_EXP_LNKCTL_RCB 0x0008 /* Read Completion Boundary */
394#define VBOX_PCI_EXP_LNKCTL_DISABLE 0x0010 /* Link Disable */
395#define VBOX_PCI_EXP_LNKCTL_RETRAIN 0x0020 /* Retrain Link */
396#define VBOX_PCI_EXP_LNKCTL_CLOCK 0x0040 /* Common Clock Configuration */
397#define VBOX_PCI_EXP_LNKCTL_XSYNCH 0x0080 /* Extended Synch */
398#define VBOX_PCI_EXP_LNKCTL_CLOCKPM 0x0100 /* Clock Power Management */
399#define VBOX_PCI_EXP_LNKCTL_HWAUTWD 0x0200 /* Hardware Autonomous Width Disable */
400#define VBOX_PCI_EXP_LNKCTL_BWMIE 0x0400 /* Bandwidth Mgmt Interrupt Enable */
401#define VBOX_PCI_EXP_LNKCTL_AUTBWIE 0x0800 /* Autonomous Bandwidth Mgmt Interrupt Enable */
402
403/* PCI Express link status (2 bytes, capability offset 18) */
404#define VBOX_PCI_EXP_LNKSTA_SPEED 0x000f /* Negotiated Link Speed */
405#define VBOX_PCI_EXP_LNKSTA_WIDTH 0x03f0 /* Negotiated Link Width */
406#define VBOX_PCI_EXP_LNKSTA_TR_ERR 0x0400 /* Training Error (obsolete) */
407#define VBOX_PCI_EXP_LNKSTA_TRAIN 0x0800 /* Link Training */
408#define VBOX_PCI_EXP_LNKSTA_SL_CLK 0x1000 /* Slot Clock Configuration */
409#define VBOX_PCI_EXP_LNKSTA_DL_ACT 0x2000 /* Data Link Layer in DL_Active State */
410#define VBOX_PCI_EXP_LNKSTA_BWMGMT 0x4000 /* Bandwidth Mgmt Status */
411#define VBOX_PCI_EXP_LNKSTA_AUTBW 0x8000 /* Autonomous Bandwidth Mgmt Status */
412
413/* PCI Express slot capabilities (4 bytes, capability offset 20) */
414#define VBOX_PCI_EXP_SLTCAP_ATNB 0x0001 /* Attention Button Present */
415#define VBOX_PCI_EXP_SLTCAP_PWRC 0x0002 /* Power Controller Present */
416#define VBOX_PCI_EXP_SLTCAP_MRL 0x0004 /* MRL Sensor Present */
417#define VBOX_PCI_EXP_SLTCAP_ATNI 0x0008 /* Attention Indicator Present */
418#define VBOX_PCI_EXP_SLTCAP_PWRI 0x0010 /* Power Indicator Present */
419#define VBOX_PCI_EXP_SLTCAP_HPS 0x0020 /* Hot-Plug Surprise */
420#define VBOX_PCI_EXP_SLTCAP_HPC 0x0040 /* Hot-Plug Capable */
421#define VBOX_PCI_EXP_SLTCAP_PWR_VAL 0x00007f80 /* Slot Power Limit Value */
422#define VBOX_PCI_EXP_SLTCAP_PWR_SCL 0x00018000 /* Slot Power Limit Scale */
423#define VBOX_PCI_EXP_SLTCAP_INTERLOCK 0x020000 /* Electromechanical Interlock Present */
424#define VBOX_PCI_EXP_SLTCAP_NOCMDCOMP 0x040000 /* No Command Completed Support */
425#define VBOX_PCI_EXP_SLTCAP_PSN 0xfff80000 /* Physical Slot Number */
426
427/* PCI Express slot control (2 bytes, capability offset 24) */
428#define VBOX_PCI_EXP_SLTCTL_ATNB 0x0001 /* Attention Button Pressed Enable */
429#define VBOX_PCI_EXP_SLTCTL_PWRF 0x0002 /* Power Fault Detected Enable */
430#define VBOX_PCI_EXP_SLTCTL_MRLS 0x0004 /* MRL Sensor Changed Enable */
431#define VBOX_PCI_EXP_SLTCTL_PRSD 0x0008 /* Presence Detect Changed Enable */
432#define VBOX_PCI_EXP_SLTCTL_CMDC 0x0010 /* Command Completed Interrupt Enable */
433#define VBOX_PCI_EXP_SLTCTL_HPIE 0x0020 /* Hot-Plug Interrupt Enable */
434#define VBOX_PCI_EXP_SLTCTL_ATNI 0x00c0 /* Attention Indicator Control */
435#define VBOX_PCI_EXP_SLTCTL_PWRI 0x0300 /* Power Indicator Control */
436#define VBOX_PCI_EXP_SLTCTL_PWRC 0x0400 /* Power Controller Control */
437#define VBOX_PCI_EXP_SLTCTL_INTERLOCK 0x0800 /* Electromechanical Interlock Control */
438#define VBOX_PCI_EXP_SLTCTL_LLCHG 0x1000 /* Data Link Layer State Changed Enable */
439
440/* PCI Express slot status (2 bytes, capability offset 26) */
441#define VBOX_PCI_EXP_SLTSTA_ATNB 0x0001 /* Attention Button Pressed */
442#define VBOX_PCI_EXP_SLTSTA_PWRF 0x0002 /* Power Fault Detected */
443#define VBOX_PCI_EXP_SLTSTA_MRLS 0x0004 /* MRL Sensor Changed */
444#define VBOX_PCI_EXP_SLTSTA_PRSD 0x0008 /* Presence Detect Changed */
445#define VBOX_PCI_EXP_SLTSTA_CMDC 0x0010 /* Command Completed */
446#define VBOX_PCI_EXP_SLTSTA_MRL_ST 0x0020 /* MRL Sensor State */
447#define VBOX_PCI_EXP_SLTSTA_PRES 0x0040 /* Presence Detect State */
448#define VBOX_PCI_EXP_SLTSTA_INTERLOCK 0x0080 /* Electromechanical Interlock Status */
449#define VBOX_PCI_EXP_SLTSTA_LLCHG 0x0100 /* Data Link Layer State Changed */
450
451/* PCI Express root control (2 bytes, capability offset 28) */
452#define VBOX_PCI_EXP_RTCTL_SECEE 0x0001 /* System Error on Correctable Error */
453#define VBOX_PCI_EXP_RTCTL_SENFEE 0x0002 /* System Error on Non-Fatal Error */
454#define VBOX_PCI_EXP_RTCTL_SEFEE 0x0004 /* System Error on Fatal Error */
455#define VBOX_PCI_EXP_RTCTL_PMEIE 0x0008 /* PME Interrupt Enable */
456#define VBOX_PCI_EXP_RTCTL_CRSVIS 0x0010 /* Configuration Request Retry Status Visible to SW */
457
458/* PCI Express root capabilities (2 bytes, capability offset 30) */
459#define VBOX_PCI_EXP_RTCAP_CRSVIS 0x0010 /* Configuration Request Retry Status Visible to SW */
460
461/* PCI Express root status (4 bytes, capability offset 32) */
462#define VBOX_PCI_EXP_RTSTA_PME_REQID 0x0000ffff /* PME Requester ID */
463#define VBOX_PCI_EXP_RTSTA_PME_STATUS 0x00010000 /* PME Status */
464#define VBOX_PCI_EXP_RTSTA_PME_PENDING 0x00020000 /* PME is Pending */
465
466
467/**
468 * Callback function for reading from the PCI configuration space.
469 *
470 * @returns The register value.
471 * @param pPciDev Pointer to PCI device. Use pPciDev->pDevIns to get the device instance.
472 * @param Address The configuration space register address. [0..4096]
473 * @param cb The register size. [1,2,4]
474 */
475typedef DECLCALLBACK(uint32_t) FNPCICONFIGREAD(PPCIDEVICE pPciDev, uint32_t Address, unsigned cb);
476/** Pointer to a FNPCICONFIGREAD() function. */
477typedef FNPCICONFIGREAD *PFNPCICONFIGREAD;
478/** Pointer to a PFNPCICONFIGREAD. */
479typedef PFNPCICONFIGREAD *PPFNPCICONFIGREAD;
480
481/**
482 * Callback function for writing to the PCI configuration space.
483 *
484 * @param pPciDev Pointer to PCI device. Use pPciDev->pDevIns to get the device instance.
485 * @param Address The configuration space register address. [0..4096]
486 * @param u32Value The value that's being written. The number of bits actually used from
487 * this value is determined by the cb parameter.
488 * @param cb The register size. [1,2,4]
489 */
490typedef DECLCALLBACK(void) FNPCICONFIGWRITE(PPCIDEVICE pPciDev, uint32_t Address, uint32_t u32Value, unsigned cb);
491/** Pointer to a FNPCICONFIGWRITE() function. */
492typedef FNPCICONFIGWRITE *PFNPCICONFIGWRITE;
493/** Pointer to a PFNPCICONFIGWRITE. */
494typedef PFNPCICONFIGWRITE *PPFNPCICONFIGWRITE;
495
496/** Fixed I/O region number for ROM. */
497#define PCI_ROM_SLOT 6
498#define VBOX_PCI_ROM_SLOT 6
499/** Max number of I/O regions. */
500#define PCI_NUM_REGIONS 7
501#define VBOX_PCI_NUM_REGIONS 7
502
503/*
504 * Hack to include the PCIDEVICEINT structure at the right place
505 * to avoid duplications of FNPCIIOREGIONMAP and PCI_NUM_REGIONS.
506 */
507#ifdef PCI_INCLUDE_PRIVATE
508# include "PCIInternal.h"
509#endif
510
511/**
512 * PCI Device structure.
513 */
514typedef struct PCIDevice
515{
516 /** PCI config space. */
517 uint8_t config[256];
518
519 /** Internal data. */
520 union
521 {
522#ifdef PCIDEVICEINT_DECLARED
523 PCIDEVICEINT s;
524#endif
525 char padding[288];
526 } Int;
527
528 /** Read only data.
529 * @{
530 */
531 /** PCI device number on the pci bus. */
532 int32_t devfn;
533 uint32_t Alignment0; /**< Alignment. */
534 /** Device name. */
535 R3PTRTYPE(const char *) name;
536 /** Pointer to the device instance which registered the device. */
537 PPDMDEVINSR3 pDevIns;
538 /** @} */
539} PCIDEVICE;
540
541/* @todo: handle extended space access */
542DECLINLINE(void) PCIDevSetByte(PPCIDEVICE pPciDev, uint32_t uOffset, uint8_t u8Value)
543{
544 pPciDev->config[uOffset] = u8Value;
545}
546
547DECLINLINE(uint8_t) PCIDevGetByte(PPCIDEVICE pPciDev, uint32_t uOffset)
548{
549#ifdef PCIDEVICEINT_DECLARED
550 Assert((pPciDev->Int.s.fFlags & PCIDEV_FLAG_PASSTHROUGH) == 0);
551#endif
552 return pPciDev->config[uOffset];
553}
554
555DECLINLINE(void) PCIDevSetWord(PPCIDEVICE pPciDev, uint32_t uOffset, uint16_t u16Value)
556{
557 *(uint16_t*)&pPciDev->config[uOffset] = RT_H2LE_U16(u16Value);
558}
559
560DECLINLINE(uint16_t) PCIDevGetWord(PPCIDEVICE pPciDev, uint32_t uOffset)
561{
562#ifdef PCIDEVICEINT_DECLARED
563 Assert((pPciDev->Int.s.fFlags & PCIDEV_FLAG_PASSTHROUGH) == 0);
564#endif
565 uint16_t u16Value = *(uint16_t*)&pPciDev->config[uOffset];
566 return RT_H2LE_U16(u16Value);
567}
568
569DECLINLINE(void) PCIDevSetDWord(PPCIDEVICE pPciDev, uint32_t uOffset, uint32_t u32Value)
570{
571 *(uint32_t*)&pPciDev->config[uOffset] = RT_H2LE_U32(u32Value);
572}
573
574DECLINLINE(uint32_t) PCIDevGetDWord(PPCIDEVICE pPciDev, uint32_t uOffset)
575{
576#ifdef PCIDEVICEINT_DECLARED
577 Assert((pPciDev->Int.s.fFlags & PCIDEV_FLAG_PASSTHROUGH) == 0);
578#endif
579 uint32_t u32Value = *(uint32_t*)&pPciDev->config[uOffset];
580 return RT_H2LE_U32(u32Value);
581}
582
583DECLINLINE(void) PCIDevSetQWord(PPCIDEVICE pPciDev, uint32_t uOffset, uint64_t u64Value)
584{
585 *(uint64_t*)&pPciDev->config[uOffset] = RT_H2LE_U64(u64Value);
586}
587
588DECLINLINE(uint64_t) PCIDevGetQWord(PPCIDEVICE pPciDev, uint32_t uOffset)
589{
590#ifdef PCIDEVICEINT_DECLARED
591 Assert((pPciDev->Int.s.fFlags & PCIDEV_FLAG_PASSTHROUGH) == 0);
592#endif
593 uint64_t u64Value = *(uint64_t*)&pPciDev->config[uOffset];
594 return RT_H2LE_U64(u64Value);
595}
596
597/**
598 * Sets the vendor id config register.
599 * @param pPciDev The PCI device.
600 * @param u16VendorId The vendor id.
601 */
602DECLINLINE(void) PCIDevSetVendorId(PPCIDEVICE pPciDev, uint16_t u16VendorId)
603{
604 PCIDevSetWord(pPciDev, VBOX_PCI_VENDOR_ID, u16VendorId);
605}
606
607/**
608 * Gets the vendor id config register.
609 * @returns the vendor id.
610 * @param pPciDev The PCI device.
611 */
612DECLINLINE(uint16_t) PCIDevGetVendorId(PPCIDEVICE pPciDev)
613{
614 return PCIDevGetWord(pPciDev, VBOX_PCI_VENDOR_ID);
615}
616
617
618/**
619 * Sets the device id config register.
620 * @param pPciDev The PCI device.
621 * @param u16DeviceId The device id.
622 */
623DECLINLINE(void) PCIDevSetDeviceId(PPCIDEVICE pPciDev, uint16_t u16DeviceId)
624{
625 PCIDevSetWord(pPciDev, VBOX_PCI_DEVICE_ID, u16DeviceId);
626}
627
628/**
629 * Gets the device id config register.
630 * @returns the device id.
631 * @param pPciDev The PCI device.
632 */
633DECLINLINE(uint16_t) PCIDevGetDeviceId(PPCIDEVICE pPciDev)
634{
635 return PCIDevGetWord(pPciDev, VBOX_PCI_DEVICE_ID);
636}
637
638/**
639 * Sets the command config register.
640 *
641 * @param pPciDev The PCI device.
642 * @param u16Command The command register value.
643 */
644DECLINLINE(void) PCIDevSetCommand(PPCIDEVICE pPciDev, uint16_t u16Command)
645{
646 PCIDevSetWord(pPciDev, VBOX_PCI_COMMAND, u16Command);
647}
648
649
650/**
651 * Gets the command config register.
652 * @returns The command register value.
653 * @param pPciDev The PCI device.
654 */
655DECLINLINE(uint16_t) PCIDevGetCommand(PPCIDEVICE pPciDev)
656{
657 return PCIDevGetWord(pPciDev, VBOX_PCI_COMMAND);
658}
659
660/**
661 * Checks if INTx interrupts disabled in the command config register.
662 * @returns true if disabled.
663 * @param pPciDev The PCI device.
664 */
665DECLINLINE(bool) PCIDevIsIntxDisabled(PPCIDEVICE pPciDev)
666{
667 return (PCIDevGetCommand(pPciDev) & VBOX_PCI_COMMAND_INTX_DISABLE) != 0;
668}
669
670/**
671 * Gets the status config register.
672 *
673 * @returns status config register.
674 * @param pPciDev The PCI device.
675 */
676DECLINLINE(uint16_t) PCIDevGetStatus(PPCIDEVICE pPciDev)
677{
678 return PCIDevGetWord(pPciDev, VBOX_PCI_STATUS);
679}
680
681/**
682 * Sets the status config register.
683 *
684 * @param pPciDev The PCI device.
685 * @param u16Status The status register value.
686 */
687DECLINLINE(void) PCIDevSetStatus(PPCIDEVICE pPciDev, uint16_t u16Status)
688{
689 PCIDevSetWord(pPciDev, VBOX_PCI_STATUS, u16Status);
690}
691
692
693/**
694 * Sets the revision id config register.
695 *
696 * @param pPciDev The PCI device.
697 * @param u8RevisionId The revision id.
698 */
699DECLINLINE(void) PCIDevSetRevisionId(PPCIDEVICE pPciDev, uint8_t u8RevisionId)
700{
701 PCIDevSetByte(pPciDev, VBOX_PCI_REVISION_ID, u8RevisionId);
702}
703
704
705/**
706 * Sets the register level programming class config register.
707 *
708 * @param pPciDev The PCI device.
709 * @param u8ClassProg The new value.
710 */
711DECLINLINE(void) PCIDevSetClassProg(PPCIDEVICE pPciDev, uint8_t u8ClassProg)
712{
713 PCIDevSetByte(pPciDev, VBOX_PCI_CLASS_PROG, u8ClassProg);
714}
715
716
717/**
718 * Sets the sub-class (aka device class) config register.
719 *
720 * @param pPciDev The PCI device.
721 * @param u8SubClass The sub-class.
722 */
723DECLINLINE(void) PCIDevSetClassSub(PPCIDEVICE pPciDev, uint8_t u8SubClass)
724{
725 PCIDevSetByte(pPciDev, VBOX_PCI_CLASS_SUB, u8SubClass);
726}
727
728
729/**
730 * Sets the base class config register.
731 *
732 * @param pPciDev The PCI device.
733 * @param u8BaseClass The base class.
734 */
735DECLINLINE(void) PCIDevSetClassBase(PPCIDEVICE pPciDev, uint8_t u8BaseClass)
736{
737 PCIDevSetByte(pPciDev, VBOX_PCI_CLASS_BASE, u8BaseClass);
738}
739
740/**
741 * Sets the header type config register.
742 *
743 * @param pPciDev The PCI device.
744 * @param u8HdrType The header type.
745 */
746DECLINLINE(void) PCIDevSetHeaderType(PPCIDEVICE pPciDev, uint8_t u8HdrType)
747{
748 PCIDevSetByte(pPciDev, VBOX_PCI_HEADER_TYPE, u8HdrType);
749}
750
751/**
752 * Gets the header type config register.
753 *
754 * @param pPciDev The PCI device.
755 * @returns u8HdrType The header type.
756 */
757DECLINLINE(uint8_t) PCIDevGetHeaderType(PPCIDEVICE pPciDev)
758{
759 return PCIDevGetByte(pPciDev, VBOX_PCI_HEADER_TYPE);
760}
761
762/**
763 * Sets the BIST (built-in self-test) config register.
764 *
765 * @param pPciDev The PCI device.
766 * @param u8Bist The BIST value.
767 */
768DECLINLINE(void) PCIDevSetBIST(PPCIDEVICE pPciDev, uint8_t u8Bist)
769{
770 PCIDevSetByte(pPciDev, VBOX_PCI_BIST, u8Bist);
771}
772
773/**
774 * Gets the BIST (built-in self-test) config register.
775 *
776 * @param pPciDev The PCI device.
777 * @returns u8Bist The BIST.
778 */
779DECLINLINE(uint8_t) PCIDevGetBIST(PPCIDEVICE pPciDev)
780{
781 return PCIDevGetByte(pPciDev, VBOX_PCI_BIST);
782}
783
784
785/**
786 * Sets a base address config register.
787 *
788 * @param pPciDev The PCI device.
789 * @param fIOSpace Whether it's I/O (true) or memory (false) space.
790 * @param fPrefetchable Whether the memory is prefetachable. Must be false if fIOSpace == true.
791 * @param f64Bit Whether the memory can be mapped anywhere in the 64-bit address space. Otherwise restrict to 32-bit.
792 * @param u32Addr The address value.
793 */
794DECLINLINE(void) PCIDevSetBaseAddress(PPCIDEVICE pPciDev, uint8_t iReg, bool fIOSpace, bool fPrefetchable, bool f64Bit, uint32_t u32Addr)
795{
796 if (fIOSpace)
797 {
798 Assert(!(u32Addr & 0x3)); Assert(!fPrefetchable); Assert(!f64Bit);
799 u32Addr |= RT_BIT_32(0);
800 }
801 else
802 {
803 Assert(!(u32Addr & 0xf));
804 if (fPrefetchable)
805 u32Addr |= RT_BIT_32(3);
806 if (f64Bit)
807 u32Addr |= 0x2 << 1;
808 }
809 switch (iReg)
810 {
811 case 0: iReg = VBOX_PCI_BASE_ADDRESS_0; break;
812 case 1: iReg = VBOX_PCI_BASE_ADDRESS_1; break;
813 case 2: iReg = VBOX_PCI_BASE_ADDRESS_2; break;
814 case 3: iReg = VBOX_PCI_BASE_ADDRESS_3; break;
815 case 4: iReg = VBOX_PCI_BASE_ADDRESS_4; break;
816 case 5: iReg = VBOX_PCI_BASE_ADDRESS_5; break;
817 default: AssertFailedReturnVoid();
818 }
819
820 PCIDevSetDWord(pPciDev, iReg, u32Addr);
821}
822
823
824/**
825 * Sets the sub-system vendor id config register.
826 *
827 * @param pPciDev The PCI device.
828 * @param u16SubSysVendorId The sub-system vendor id.
829 */
830DECLINLINE(void) PCIDevSetSubSystemVendorId(PPCIDEVICE pPciDev, uint16_t u16SubSysVendorId)
831{
832 PCIDevSetWord(pPciDev, VBOX_PCI_SUBSYSTEM_VENDOR_ID, u16SubSysVendorId);
833}
834
835/**
836 * Gets the sub-system vendor id config register.
837 * @returns the sub-system vendor id.
838 * @param pPciDev The PCI device.
839 */
840DECLINLINE(uint16_t) PCIDevGetSubSystemVendorId(PPCIDEVICE pPciDev)
841{
842 return PCIDevGetWord(pPciDev, VBOX_PCI_SUBSYSTEM_VENDOR_ID);
843}
844
845
846/**
847 * Sets the sub-system id config register.
848 *
849 * @param pPciDev The PCI device.
850 * @param u16SubSystemId The sub-system id.
851 */
852DECLINLINE(void) PCIDevSetSubSystemId(PPCIDEVICE pPciDev, uint16_t u16SubSystemId)
853{
854 PCIDevSetWord(pPciDev, VBOX_PCI_SUBSYSTEM_ID, u16SubSystemId);
855}
856
857/**
858 * Gets the sub-system id config register.
859 * @returns the sub-system id.
860 * @param pPciDev The PCI device.
861 */
862DECLINLINE(uint16_t) PCIDevGetSubSystemId(PPCIDEVICE pPciDev)
863{
864 return PCIDevGetWord(pPciDev, VBOX_PCI_SUBSYSTEM_ID);
865}
866
867/**
868 * Sets offset to capability list.
869 *
870 * @param pPciDev The PCI device.
871 * @param u8Offset The offset to capability list.
872 */
873DECLINLINE(void) PCIDevSetCapabilityList(PPCIDEVICE pPciDev, uint8_t u8Offset)
874{
875 PCIDevSetByte(pPciDev, VBOX_PCI_CAPABILITY_LIST, u8Offset);
876}
877
878/**
879 * Returns offset to capability list.
880 *
881 * @returns offset to capability list.
882 * @param pPciDev The PCI device.
883 */
884DECLINLINE(uint8_t) PCIDevGetCapabilityList(PPCIDEVICE pPciDev)
885{
886 return PCIDevGetByte(pPciDev, VBOX_PCI_CAPABILITY_LIST);
887}
888
889/**
890 * Sets the interrupt line config register.
891 *
892 * @param pPciDev The PCI device.
893 * @param u8Line The interrupt line.
894 */
895DECLINLINE(void) PCIDevSetInterruptLine(PPCIDEVICE pPciDev, uint8_t u8Line)
896{
897 PCIDevSetByte(pPciDev, VBOX_PCI_INTERRUPT_LINE, u8Line);
898}
899
900/**
901 * Gets the interrupt line config register.
902 *
903 * @returns The interrupt line.
904 * @param pPciDev The PCI device.
905 */
906DECLINLINE(uint8_t) PCIDevGetInterruptLine(PPCIDEVICE pPciDev)
907{
908 return PCIDevGetByte(pPciDev, VBOX_PCI_INTERRUPT_LINE);
909}
910
911/**
912 * Sets the interrupt pin config register.
913 *
914 * @param pPciDev The PCI device.
915 * @param u8Pin The interrupt pin.
916 */
917DECLINLINE(void) PCIDevSetInterruptPin(PPCIDEVICE pPciDev, uint8_t u8Pin)
918{
919 PCIDevSetByte(pPciDev, VBOX_PCI_INTERRUPT_PIN, u8Pin);
920}
921
922/**
923 * Gets the interrupt pin config register.
924 *
925 * @returns The interrupt pin.
926 * @param pPciDev The PCI device.
927 */
928DECLINLINE(uint8_t) PCIDevGetInterruptPin(PPCIDEVICE pPciDev)
929{
930 return PCIDevGetByte(pPciDev, VBOX_PCI_INTERRUPT_PIN);
931}
932
933#ifdef PCIDEVICEINT_DECLARED
934DECLINLINE(void) pciDevSetRequestedDevfunc(PPCIDEVICE pDev)
935{
936 pDev->Int.s.fFlags |= PCIDEV_FLAG_REQUESTED_DEVFUNC;
937}
938
939DECLINLINE(void) pciDevClearRequestedDevfunc(PPCIDEVICE pDev)
940{
941 pDev->Int.s.fFlags &= ~PCIDEV_FLAG_REQUESTED_DEVFUNC;
942}
943
944DECLINLINE(bool) pciDevIsRequestedDevfunc(PPCIDEVICE pDev)
945{
946 return (pDev->Int.s.fFlags & PCIDEV_FLAG_REQUESTED_DEVFUNC) != 0;
947}
948
949DECLINLINE(void) pciDevSetPci2PciBridge(PPCIDEVICE pDev)
950{
951 pDev->Int.s.fFlags |= PCIDEV_FLAG_PCI_TO_PCI_BRIDGE;
952}
953
954DECLINLINE(bool) pciDevIsPci2PciBridge(PPCIDEVICE pDev)
955{
956 return (pDev->Int.s.fFlags & PCIDEV_FLAG_PCI_TO_PCI_BRIDGE) != 0;
957}
958
959DECLINLINE(void) pciDevSetPciExpress(PPCIDEVICE pDev)
960{
961 pDev->Int.s.fFlags |= PCIDEV_FLAG_PCI_EXPRESS_DEVICE;
962}
963
964DECLINLINE(bool) pciDevIsPciExpress(PPCIDEVICE pDev)
965{
966 return (pDev->Int.s.fFlags & PCIDEV_FLAG_PCI_EXPRESS_DEVICE) != 0;
967}
968
969DECLINLINE(void) pciDevSetMsiCapable(PPCIDEVICE pDev)
970{
971 pDev->Int.s.fFlags |= PCIDEV_FLAG_MSI_CAPABLE;
972}
973
974DECLINLINE(void) pciDevClearMsiCapable(PPCIDEVICE pDev)
975{
976 pDev->Int.s.fFlags &= ~PCIDEV_FLAG_MSI_CAPABLE;
977}
978
979DECLINLINE(bool) pciDevIsMsiCapable(PPCIDEVICE pDev)
980{
981 return (pDev->Int.s.fFlags & PCIDEV_FLAG_MSI_CAPABLE) != 0;
982}
983
984DECLINLINE(void) pciDevSetMsixCapable(PPCIDEVICE pDev)
985{
986 pDev->Int.s.fFlags |= PCIDEV_FLAG_MSIX_CAPABLE;
987}
988
989DECLINLINE(void) pciDevClearMsixCapable(PPCIDEVICE pDev)
990{
991 pDev->Int.s.fFlags &= ~PCIDEV_FLAG_MSIX_CAPABLE;
992}
993
994DECLINLINE(bool) pciDevIsMsixCapable(PPCIDEVICE pDev)
995{
996 return (pDev->Int.s.fFlags & PCIDEV_FLAG_MSIX_CAPABLE) != 0;
997}
998
999DECLINLINE(void) pciDevSetPassthrough(PPCIDEVICE pDev)
1000{
1001 pDev->Int.s.fFlags |= PCIDEV_FLAG_PASSTHROUGH;
1002}
1003
1004DECLINLINE(void) pciDevClearPassthrough(PPCIDEVICE pDev)
1005{
1006 pDev->Int.s.fFlags &= ~PCIDEV_FLAG_PASSTHROUGH;
1007}
1008
1009DECLINLINE(bool) pciDevIsPassthrough(PPCIDEVICE pDev)
1010{
1011 return (pDev->Int.s.fFlags & PCIDEV_FLAG_PASSTHROUGH) != 0;
1012}
1013
1014#endif /* PCIDEVICEINT_DECLARED */
1015
1016#if defined(__cplusplus) && defined(IN_RING3)
1017/**
1018 * Document me.
1019 *
1020 * @remarks C++ classes (structs included) are not generally accepted in
1021 * VMM devices or drivers. An exception may be granted for this class
1022 * if it's contained to ring-3 and that this is a one time exception
1023 * which sets no precedent.
1024 */
1025struct PciBusAddress
1026{
1027 /** @todo r=bird: Add 'm', or 'm_' to data members. This is general
1028 * practice in most of the source tree. */
1029 int iBus;
1030 int iDevice;
1031 int iFn;
1032
1033 PciBusAddress()
1034 {
1035 clear();
1036 }
1037
1038 PciBusAddress(int bus, int device, int fn)
1039 {
1040 init(bus, device, fn);
1041 }
1042
1043 PciBusAddress& clear()
1044 {
1045 iBus = iDevice = iFn = -1;
1046 return *this;
1047 }
1048
1049 void init(int bus, int device, int fn)
1050 {
1051 iBus = bus;
1052 iDevice = device;
1053 iFn = fn;
1054 }
1055
1056 void init(const PciBusAddress &a)
1057 {
1058 iBus = a.iBus;
1059 iDevice = a.iDevice;
1060 iFn = a.iFn;
1061 }
1062
1063 bool operator<(const PciBusAddress &a) const
1064 {
1065 if (iBus < a.iBus)
1066 return true;
1067
1068 if (iBus > a.iBus)
1069 return false;
1070
1071 if (iDevice < a.iDevice)
1072 return true;
1073
1074 if (iDevice > a.iDevice)
1075 return false;
1076
1077 if (iFn < a.iFn)
1078 return true;
1079
1080 if (iFn > a.iFn)
1081 return false;
1082
1083 return false;
1084 }
1085
1086 bool operator==(const PciBusAddress &a) const
1087 {
1088 return (iBus == a.iBus)
1089 && (iDevice == a.iDevice)
1090 && (iFn == a.iFn);
1091 }
1092
1093 bool operator!=(const PciBusAddress &a) const
1094 {
1095 return (iBus != a.iBus)
1096 || (iDevice != a.iDevice)
1097 || (iFn != a.iFn);
1098 }
1099
1100 bool valid() const
1101 {
1102 return (iBus != -1) && (iDevice != -1) && (iFn != -1);
1103 }
1104
1105 int32_t asLong() const
1106 {
1107 Assert(valid());
1108 return (iBus << 8) | (iDevice << 3) | iFn;
1109 }
1110
1111 PciBusAddress& fromLong(int32_t value)
1112 {
1113 iBus = (value >> 8) & 0xff;
1114 iDevice = (value & 0xff) >> 3;
1115 iFn = (value & 7);
1116 return *this;
1117 }
1118};
1119#endif /* __cplusplus */
1120
1121/** @} */
1122
1123#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