VirtualBox

source: vbox/trunk/src/VBox/VMM/IOM.cpp@ 26638

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

VMM: pdm.h and @copydoc cleanups.
  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
File size: 82.0 KB
Line 
1/* $Id: IOM.cpp 26152 2010-02-02 16:00:35Z vboxsync $ */
2/** @file
3 * IOM - Input / Output Monitor.
4 */
5
6/*
7 * Copyright (C) 2006-2007 Sun Microsystems, Inc.
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 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
18 * Clara, CA 95054 USA or visit http://www.sun.com if you need
19 * additional information or have any questions.
20 */
21
22
23/** @page pg_iom IOM - The Input / Output Monitor
24 *
25 * The input/output monitor will handle I/O exceptions routing them to the
26 * appropriate device. It implements an API to register and deregister virtual
27 * I/0 port handlers and memory mapped I/O handlers. A handler is PDM devices
28 * and a set of callback functions.
29 *
30 * @see grp_iom
31 *
32 *
33 * @section sec_iom_rawmode Raw-Mode
34 *
35 * In raw-mode I/O port access is trapped (\#GP(0)) by ensuring that the actual
36 * IOPL is 0 regardless of what the guest IOPL is. The \#GP handler use the
37 * dissassembler (DIS) to figure which instruction caused it (there are a number
38 * of instructions in addition to the I/O ones) and if it's an I/O port access
39 * it will hand it to IOMGCIOPortHandler (via EMInterpretPortIO).
40 * IOMGCIOPortHandler will lookup the port in the AVL tree of registered
41 * handlers. If found, the handler will be called otherwise default action is
42 * taken. (Default action is to write into the void and read all set bits.)
43 *
44 * Memory Mapped I/O (MMIO) is implemented as a sligtly special case of PGM
45 * access handlers. An MMIO range is registered with IOM which then registers it
46 * with the PGM access handler sub-system. The access handler catches all
47 * access and will be called in the context of a \#PF handler. In RC and R0 this
48 * handler is IOMMMIOHandler while in ring-3 it's IOMR3MMIOHandler (althought in
49 * ring-3 there can be alternative ways). IOMMMIOHandler will attempt to emulate
50 * the instruction that is doing the access and pass the corresponding reads /
51 * writes to the device.
52 *
53 * Emulating I/O port access is less complex and should be sligtly faster than
54 * emulating MMIO, so in most cases we should encourage the OS to use port I/O.
55 * Devices which are freqently accessed should register GC handlers to speed up
56 * execution.
57 *
58 *
59 * @section sec_iom_hwaccm Hardware Assisted Virtualization Mode
60 *
61 * When running in hardware assisted virtualization mode we'll be doing much the
62 * same things as in raw-mode. The main difference is that we're running in the
63 * host ring-0 context and that we don't get faults (\#GP(0) and \#PG) but
64 * exits.
65 *
66 *
67 * @section sec_iom_rem Recompiled Execution Mode
68 *
69 * When running in the recompiler things are different. I/O port access is
70 * handled by calling IOMIOPortRead and IOMIOPortWrite directly. While MMIO can
71 * be handled in one of two ways. The normal way is that we have a registered a
72 * special RAM range with the recompiler and in the three callbacks (for byte,
73 * word and dword access) we call IOMMMIORead and IOMMMIOWrite directly. The
74 * alternative ways that the physical memory access which goes via PGM will take
75 * care of it by calling IOMR3MMIOHandler via the PGM access handler machinery
76 * - this shouldn't happen but it is an alternative...
77 *
78 *
79 * @section sec_iom_other Other Accesses
80 *
81 * I/O ports aren't really exposed in any other way, unless you count the
82 * instruction interpreter in EM, but that's just what we're doing in the
83 * raw-mode \#GP(0) case really. Now it's possible to call IOMIOPortRead and
84 * IOMIOPortWrite directly to talk to a device, but this is really bad behavior
85 * and should only be done as temporary hacks (the PC BIOS device used to
86 * setup the CMOS this way back in the dark ages).
87 *
88 * MMIO has similar direct routes as the I/O ports and these shouldn't be used
89 * for the same reasons and with the same restrictions. OTOH since MMIO is
90 * mapped into the physical memory address space, it can be accessed in a number
91 * of ways thru PGM.
92 *
93 */
94
95
96/*******************************************************************************
97* Header Files *
98*******************************************************************************/
99#define LOG_GROUP LOG_GROUP_IOM
100#include <VBox/iom.h>
101#include <VBox/cpum.h>
102#include <VBox/pgm.h>
103#include <VBox/sup.h>
104#include <VBox/mm.h>
105#include <VBox/stam.h>
106#include <VBox/dbgf.h>
107#include <VBox/pdmapi.h>
108#include <VBox/pdmdev.h>
109#include "IOMInternal.h"
110#include <VBox/vm.h>
111
112#include <VBox/param.h>
113#include <iprt/assert.h>
114#include <iprt/alloc.h>
115#include <iprt/string.h>
116#include <VBox/log.h>
117#include <VBox/err.h>
118
119
120/*******************************************************************************
121* Internal Functions *
122*******************************************************************************/
123static void iomR3FlushCache(PVM pVM);
124static DECLCALLBACK(int) iomR3RelocateIOPortCallback(PAVLROIOPORTNODECORE pNode, void *pvUser);
125static DECLCALLBACK(int) iomR3RelocateMMIOCallback(PAVLROGCPHYSNODECORE pNode, void *pvUser);
126static DECLCALLBACK(void) iomR3IOPortInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs);
127static DECLCALLBACK(void) iomR3MMIOInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs);
128static DECLCALLBACK(int) iomR3IOPortDummyIn(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint32_t *pu32, unsigned cb);
129static DECLCALLBACK(int) iomR3IOPortDummyOut(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint32_t u32, unsigned cb);
130static DECLCALLBACK(int) iomR3IOPortDummyInStr(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, RTGCPTR *pGCPtrDst, PRTGCUINTREG pcTransfer, unsigned cb);
131static DECLCALLBACK(int) iomR3IOPortDummyOutStr(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, RTGCPTR *pGCPtrSrc, PRTGCUINTREG pcTransfer, unsigned cb);
132
133#ifdef VBOX_WITH_STATISTICS
134static const char *iomR3IOPortGetStandardName(RTIOPORT Port);
135#endif
136
137
138/**
139 * Initializes the IOM.
140 *
141 * @returns VBox status code.
142 * @param pVM The VM to operate on.
143 */
144VMMR3DECL(int) IOMR3Init(PVM pVM)
145{
146 LogFlow(("IOMR3Init:\n"));
147
148 /*
149 * Assert alignment and sizes.
150 */
151 AssertCompileMemberAlignment(VM, iom.s, 32);
152 AssertCompile(sizeof(pVM->iom.s) <= sizeof(pVM->iom.padding));
153 AssertCompileMemberAlignment(IOM, EmtLock, sizeof(uintptr_t));
154
155 /*
156 * Setup any fixed pointers and offsets.
157 */
158 pVM->iom.s.offVM = RT_OFFSETOF(VM, iom);
159
160 /*
161 * Initialize the REM critical section.
162 */
163 int rc = PDMR3CritSectInit(pVM, &pVM->iom.s.EmtLock, RT_SRC_POS, "IOM EMT Lock");
164 AssertRCReturn(rc, rc);
165
166 /*
167 * Allocate the trees structure.
168 */
169 rc = MMHyperAlloc(pVM, sizeof(*pVM->iom.s.pTreesR3), 0, MM_TAG_IOM, (void **)&pVM->iom.s.pTreesR3);
170 if (RT_SUCCESS(rc))
171 {
172 pVM->iom.s.pTreesRC = MMHyperR3ToRC(pVM, pVM->iom.s.pTreesR3);
173 pVM->iom.s.pTreesR0 = MMHyperR3ToR0(pVM, pVM->iom.s.pTreesR3);
174 pVM->iom.s.pfnMMIOHandlerRC = NIL_RTGCPTR;
175 pVM->iom.s.pfnMMIOHandlerR0 = NIL_RTR0PTR;
176
177 /*
178 * Info.
179 */
180 DBGFR3InfoRegisterInternal(pVM, "ioport", "Dumps all IOPort ranges. No arguments.", &iomR3IOPortInfo);
181 DBGFR3InfoRegisterInternal(pVM, "mmio", "Dumps all MMIO ranges. No arguments.", &iomR3MMIOInfo);
182
183 /*
184 * Statistics.
185 */
186 STAM_REG(pVM, &pVM->iom.s.StatRZMMIOHandler, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler", STAMUNIT_TICKS_PER_CALL, "Profiling of the IOMMMIOHandler() body, only success calls.");
187 STAM_REG(pVM, &pVM->iom.s.StatRZMMIO1Byte, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access1", STAMUNIT_OCCURENCES, "MMIO access by 1 byte counter.");
188 STAM_REG(pVM, &pVM->iom.s.StatRZMMIO2Bytes, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access2", STAMUNIT_OCCURENCES, "MMIO access by 2 bytes counter.");
189 STAM_REG(pVM, &pVM->iom.s.StatRZMMIO4Bytes, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access4", STAMUNIT_OCCURENCES, "MMIO access by 4 bytes counter.");
190 STAM_REG(pVM, &pVM->iom.s.StatRZMMIO8Bytes, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Access8", STAMUNIT_OCCURENCES, "MMIO access by 8 bytes counter.");
191 STAM_REG(pVM, &pVM->iom.s.StatRZMMIOFailures, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/MMIOFailures", STAMUNIT_OCCURENCES, "Number of times IOMMMIOHandler() didn't service the request.");
192 STAM_REG(pVM, &pVM->iom.s.StatRZInstMov, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOV", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOV instruction emulation.");
193 STAM_REG(pVM, &pVM->iom.s.StatRZInstCmp, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/CMP", STAMUNIT_TICKS_PER_CALL, "Profiling of the CMP instruction emulation.");
194 STAM_REG(pVM, &pVM->iom.s.StatRZInstAnd, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/AND", STAMUNIT_TICKS_PER_CALL, "Profiling of the AND instruction emulation.");
195 STAM_REG(pVM, &pVM->iom.s.StatRZInstOr, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/OR", STAMUNIT_TICKS_PER_CALL, "Profiling of the OR instruction emulation.");
196 STAM_REG(pVM, &pVM->iom.s.StatRZInstXor, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/XOR", STAMUNIT_TICKS_PER_CALL, "Profiling of the XOR instruction emulation.");
197 STAM_REG(pVM, &pVM->iom.s.StatRZInstBt, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/BT", STAMUNIT_TICKS_PER_CALL, "Profiling of the BT instruction emulation.");
198 STAM_REG(pVM, &pVM->iom.s.StatRZInstTest, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/TEST", STAMUNIT_TICKS_PER_CALL, "Profiling of the TEST instruction emulation.");
199 STAM_REG(pVM, &pVM->iom.s.StatRZInstXchg, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/XCHG", STAMUNIT_TICKS_PER_CALL, "Profiling of the XCHG instruction emulation.");
200 STAM_REG(pVM, &pVM->iom.s.StatRZInstStos, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/STOS", STAMUNIT_TICKS_PER_CALL, "Profiling of the STOS instruction emulation.");
201 STAM_REG(pVM, &pVM->iom.s.StatRZInstLods, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/LODS", STAMUNIT_TICKS_PER_CALL, "Profiling of the LODS instruction emulation.");
202#ifdef IOM_WITH_MOVS_SUPPORT
203 STAM_REG(pVM, &pVM->iom.s.StatRZInstMovs, STAMTYPE_PROFILE_ADV, "/IOM/RZ-MMIOHandler/Inst/MOVS", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation.");
204 STAM_REG(pVM, &pVM->iom.s.StatRZInstMovsToMMIO, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOVS/ToMMIO", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation - Mem2MMIO.");
205 STAM_REG(pVM, &pVM->iom.s.StatRZInstMovsFromMMIO, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOVS/FromMMIO", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation - MMIO2Mem.");
206 STAM_REG(pVM, &pVM->iom.s.StatRZInstMovsMMIO, STAMTYPE_PROFILE, "/IOM/RZ-MMIOHandler/Inst/MOVS/MMIO2MMIO", STAMUNIT_TICKS_PER_CALL, "Profiling of the MOVS instruction emulation - MMIO2MMIO.");
207#endif
208 STAM_REG(pVM, &pVM->iom.s.StatRZInstOther, STAMTYPE_COUNTER, "/IOM/RZ-MMIOHandler/Inst/Other", STAMUNIT_OCCURENCES, "Other instructions counter.");
209 STAM_REG(pVM, &pVM->iom.s.StatR3MMIOHandler, STAMTYPE_COUNTER, "/IOM/R3-MMIOHandler", STAMUNIT_OCCURENCES, "Number of calls to IOMR3MMIOHandler.");
210 STAM_REG(pVM, &pVM->iom.s.StatInstIn, STAMTYPE_COUNTER, "/IOM/IOWork/In", STAMUNIT_OCCURENCES, "Counter of any IN instructions.");
211 STAM_REG(pVM, &pVM->iom.s.StatInstOut, STAMTYPE_COUNTER, "/IOM/IOWork/Out", STAMUNIT_OCCURENCES, "Counter of any OUT instructions.");
212 STAM_REG(pVM, &pVM->iom.s.StatInstIns, STAMTYPE_COUNTER, "/IOM/IOWork/Ins", STAMUNIT_OCCURENCES, "Counter of any INS instructions.");
213 STAM_REG(pVM, &pVM->iom.s.StatInstOuts, STAMTYPE_COUNTER, "/IOM/IOWork/Outs", STAMUNIT_OCCURENCES, "Counter of any OUTS instructions.");
214 }
215
216 /* Redundant, but just in case we change something in the future */
217 iomR3FlushCache(pVM);
218
219 LogFlow(("IOMR3Init: returns %Rrc\n", rc));
220 return rc;
221}
222
223
224/**
225 * Flushes the IOM port & statistics lookup cache
226 *
227 * @param pVM The VM.
228 */
229static void iomR3FlushCache(PVM pVM)
230{
231 iomLock(pVM);
232 /*
233 * Caching of port and statistics (saves some time in rep outs/ins instruction emulation)
234 */
235 pVM->iom.s.pRangeLastReadR0 = NIL_RTR0PTR;
236 pVM->iom.s.pRangeLastWriteR0 = NIL_RTR0PTR;
237 pVM->iom.s.pStatsLastReadR0 = NIL_RTR0PTR;
238 pVM->iom.s.pStatsLastWriteR0 = NIL_RTR0PTR;
239 pVM->iom.s.pMMIORangeLastR0 = NIL_RTR0PTR;
240 pVM->iom.s.pMMIOStatsLastR0 = NIL_RTR0PTR;
241
242 pVM->iom.s.pRangeLastReadR3 = NULL;
243 pVM->iom.s.pRangeLastWriteR3 = NULL;
244 pVM->iom.s.pStatsLastReadR3 = NULL;
245 pVM->iom.s.pStatsLastWriteR3 = NULL;
246 pVM->iom.s.pMMIORangeLastR3 = NULL;
247 pVM->iom.s.pMMIOStatsLastR3 = NULL;
248
249 pVM->iom.s.pRangeLastReadRC = NIL_RTRCPTR;
250 pVM->iom.s.pRangeLastWriteRC = NIL_RTRCPTR;
251 pVM->iom.s.pStatsLastReadRC = NIL_RTRCPTR;
252 pVM->iom.s.pStatsLastWriteRC = NIL_RTRCPTR;
253 pVM->iom.s.pMMIORangeLastRC = NIL_RTRCPTR;
254 pVM->iom.s.pMMIOStatsLastRC = NIL_RTRCPTR;
255
256 iomUnlock(pVM);
257}
258
259
260/**
261 * The VM is being reset.
262 *
263 * @param pVM VM handle.
264 */
265VMMR3DECL(void) IOMR3Reset(PVM pVM)
266{
267 iomR3FlushCache(pVM);
268}
269
270
271/**
272 * Applies relocations to data and code managed by this
273 * component. This function will be called at init and
274 * whenever the VMM need to relocate it self inside the GC.
275 *
276 * The IOM will update the addresses used by the switcher.
277 *
278 * @param pVM The VM.
279 * @param offDelta Relocation delta relative to old location.
280 */
281VMMR3DECL(void) IOMR3Relocate(PVM pVM, RTGCINTPTR offDelta)
282{
283 LogFlow(("IOMR3Relocate: offDelta=%d\n", offDelta));
284
285 /*
286 * Apply relocations to the GC callbacks.
287 */
288 pVM->iom.s.pTreesRC = MMHyperR3ToRC(pVM, pVM->iom.s.pTreesR3);
289 RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeRC, true, iomR3RelocateIOPortCallback, &offDelta);
290 RTAvlroGCPhysDoWithAll(&pVM->iom.s.pTreesR3->MMIOTree, true, iomR3RelocateMMIOCallback, &offDelta);
291
292 if (pVM->iom.s.pfnMMIOHandlerRC)
293 pVM->iom.s.pfnMMIOHandlerRC += offDelta;
294
295 /*
296 * Apply relocations to the cached GC handlers
297 */
298 if (pVM->iom.s.pRangeLastReadRC)
299 pVM->iom.s.pRangeLastReadRC += offDelta;
300 if (pVM->iom.s.pRangeLastWriteRC)
301 pVM->iom.s.pRangeLastWriteRC += offDelta;
302 if (pVM->iom.s.pStatsLastReadRC)
303 pVM->iom.s.pStatsLastReadRC += offDelta;
304 if (pVM->iom.s.pStatsLastWriteRC)
305 pVM->iom.s.pStatsLastWriteRC += offDelta;
306 if (pVM->iom.s.pMMIORangeLastRC)
307 pVM->iom.s.pMMIORangeLastRC += offDelta;
308 if (pVM->iom.s.pMMIOStatsLastRC)
309 pVM->iom.s.pMMIOStatsLastRC += offDelta;
310}
311
312
313/**
314 * Callback function for relocating a I/O port range.
315 *
316 * @returns 0 (continue enum)
317 * @param pNode Pointer to a IOMIOPORTRANGERC node.
318 * @param pvUser Pointer to the offDelta. This is a pointer to the delta since we're
319 * not certain the delta will fit in a void pointer for all possible configs.
320 */
321static DECLCALLBACK(int) iomR3RelocateIOPortCallback(PAVLROIOPORTNODECORE pNode, void *pvUser)
322{
323 PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)pNode;
324 RTGCINTPTR offDelta = *(PRTGCINTPTR)pvUser;
325
326 Assert(pRange->pDevIns);
327 pRange->pDevIns += offDelta;
328 if (pRange->pfnOutCallback)
329 pRange->pfnOutCallback += offDelta;
330 if (pRange->pfnInCallback)
331 pRange->pfnInCallback += offDelta;
332 if (pRange->pfnOutStrCallback)
333 pRange->pfnOutStrCallback += offDelta;
334 if (pRange->pfnInStrCallback)
335 pRange->pfnInStrCallback += offDelta;
336 if (pRange->pvUser > _64K)
337 pRange->pvUser += offDelta;
338 return 0;
339}
340
341
342/**
343 * Callback function for relocating a MMIO range.
344 *
345 * @returns 0 (continue enum)
346 * @param pNode Pointer to a IOMMMIORANGE node.
347 * @param pvUser Pointer to the offDelta. This is a pointer to the delta since we're
348 * not certain the delta will fit in a void pointer for all possible configs.
349 */
350static DECLCALLBACK(int) iomR3RelocateMMIOCallback(PAVLROGCPHYSNODECORE pNode, void *pvUser)
351{
352 PIOMMMIORANGE pRange = (PIOMMMIORANGE)pNode;
353 RTGCINTPTR offDelta = *(PRTGCINTPTR)pvUser;
354
355 if (pRange->pDevInsRC)
356 pRange->pDevInsRC += offDelta;
357 if (pRange->pfnWriteCallbackRC)
358 pRange->pfnWriteCallbackRC += offDelta;
359 if (pRange->pfnReadCallbackRC)
360 pRange->pfnReadCallbackRC += offDelta;
361 if (pRange->pfnFillCallbackRC)
362 pRange->pfnFillCallbackRC += offDelta;
363 if (pRange->pvUserRC > _64K)
364 pRange->pvUserRC += offDelta;
365
366 return 0;
367}
368
369
370/**
371 * Terminates the IOM.
372 *
373 * Termination means cleaning up and freeing all resources,
374 * the VM it self is at this point powered off or suspended.
375 *
376 * @returns VBox status code.
377 * @param pVM The VM to operate on.
378 */
379VMMR3DECL(int) IOMR3Term(PVM pVM)
380{
381 /*
382 * IOM is not owning anything but automatically freed resources,
383 * so there's nothing to do here.
384 */
385 return VINF_SUCCESS;
386}
387
388#ifdef VBOX_WITH_STATISTICS
389
390/**
391 * Create the statistics node for an I/O port.
392 *
393 * @returns Pointer to new stats node.
394 *
395 * @param pVM VM handle.
396 * @param Port Port.
397 * @param pszDesc Description.
398 */
399PIOMIOPORTSTATS iomR3IOPortStatsCreate(PVM pVM, RTIOPORT Port, const char *pszDesc)
400{
401 Assert(IOMIsLockOwner(pVM));
402 /* check if it already exists. */
403 PIOMIOPORTSTATS pPort = (PIOMIOPORTSTATS)RTAvloIOPortGet(&pVM->iom.s.pTreesR3->IOPortStatTree, Port);
404 if (pPort)
405 return pPort;
406
407 /* allocate stats node. */
408 int rc = MMHyperAlloc(pVM, sizeof(*pPort), 0, MM_TAG_IOM_STATS, (void **)&pPort);
409 AssertRC(rc);
410 if (RT_SUCCESS(rc))
411 {
412 /* insert into the tree. */
413 pPort->Core.Key = Port;
414 if (RTAvloIOPortInsert(&pVM->iom.s.pTreesR3->IOPortStatTree, &pPort->Core))
415 {
416 /* put a name on common ports. */
417 if (!pszDesc)
418 pszDesc = iomR3IOPortGetStandardName(Port);
419
420 /* register the statistics counters. */
421 rc = STAMR3RegisterF(pVM, &pPort->InR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-In-R3", Port); AssertRC(rc);
422 rc = STAMR3RegisterF(pVM, &pPort->OutR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-Out-R3", Port); AssertRC(rc);
423 rc = STAMR3RegisterF(pVM, &pPort->InRZ, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-In-RZ", Port); AssertRC(rc);
424 rc = STAMR3RegisterF(pVM, &pPort->OutRZ, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-Out-RZ", Port); AssertRC(rc);
425 rc = STAMR3RegisterF(pVM, &pPort->InRZToR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-In-RZtoR3", Port); AssertRC(rc);
426 rc = STAMR3RegisterF(pVM, &pPort->OutRZToR3,STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/Ports/%04x-Out-RZtoR3", Port); AssertRC(rc);
427
428 /* Profiling */
429 rc = STAMR3RegisterF(pVM, &pPort->ProfInR3, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-In-R3/Prof", Port); AssertRC(rc);
430 rc = STAMR3RegisterF(pVM, &pPort->ProfOutR3,STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-Out-R3/Prof", Port); AssertRC(rc);
431 rc = STAMR3RegisterF(pVM, &pPort->ProfInRZ, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-In-RZ/Prof", Port); AssertRC(rc);
432 rc = STAMR3RegisterF(pVM, &pPort->ProfOutRZ,STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc,"/IOM/Ports/%04x-Out-RZ/Prof", Port); AssertRC(rc);
433
434 return pPort;
435 }
436 AssertMsgFailed(("what! Port=%d\n", Port));
437 MMHyperFree(pVM, pPort);
438 }
439 return NULL;
440}
441
442
443/**
444 * Create the statistics node for an MMIO address.
445 *
446 * @returns Pointer to new stats node.
447 *
448 * @param pVM VM handle.
449 * @param GCPhys The address.
450 * @param pszDesc Description.
451 */
452PIOMMMIOSTATS iomR3MMIOStatsCreate(PVM pVM, RTGCPHYS GCPhys, const char *pszDesc)
453{
454 Assert(IOMIsLockOwner(pVM));
455#ifdef DEBUG_sandervl
456 AssertGCPhys32(GCPhys);
457#endif
458 /* check if it already exists. */
459 PIOMMMIOSTATS pStats = (PIOMMMIOSTATS)RTAvloGCPhysGet(&pVM->iom.s.pTreesR3->MMIOStatTree, GCPhys);
460 if (pStats)
461 return pStats;
462
463 /* allocate stats node. */
464 int rc = MMHyperAlloc(pVM, sizeof(*pStats), 0, MM_TAG_IOM_STATS, (void **)&pStats);
465 AssertRC(rc);
466 if (RT_SUCCESS(rc))
467 {
468 /* insert into the tree. */
469 pStats->Core.Key = GCPhys;
470 if (RTAvloGCPhysInsert(&pVM->iom.s.pTreesR3->MMIOStatTree, &pStats->Core))
471 {
472 /* register the statistics counters. */
473 rc = STAMR3RegisterF(pVM, &pStats->ReadR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp-Read-R3", GCPhys); AssertRC(rc);
474 rc = STAMR3RegisterF(pVM, &pStats->WriteR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp-Write-R3", GCPhys); AssertRC(rc);
475 rc = STAMR3RegisterF(pVM, &pStats->ReadRZ, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp-Read-RZ", GCPhys); AssertRC(rc);
476 rc = STAMR3RegisterF(pVM, &pStats->WriteRZ, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp-Write-RZ", GCPhys); AssertRC(rc);
477 rc = STAMR3RegisterF(pVM, &pStats->ReadRZToR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp-Read-RZtoR3", GCPhys); AssertRC(rc);
478 rc = STAMR3RegisterF(pVM, &pStats->WriteRZToR3, STAMTYPE_COUNTER, STAMVISIBILITY_USED, STAMUNIT_OCCURENCES, pszDesc, "/IOM/MMIO/%RGp-Write-RZtoR3", GCPhys); AssertRC(rc);
479
480 /* Profiling */
481 rc = STAMR3RegisterF(pVM, &pStats->ProfReadR3, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp-Read-R3/Prof", GCPhys); AssertRC(rc);
482 rc = STAMR3RegisterF(pVM, &pStats->ProfWriteR3, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp-Write-R3/Prof", GCPhys); AssertRC(rc);
483 rc = STAMR3RegisterF(pVM, &pStats->ProfReadRZ, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp-Read-RZ/Prof", GCPhys); AssertRC(rc);
484 rc = STAMR3RegisterF(pVM, &pStats->ProfWriteRZ, STAMTYPE_PROFILE, STAMVISIBILITY_USED, STAMUNIT_TICKS_PER_CALL, pszDesc, "/IOM/MMIO/%RGp-Write-RZ/Prof", GCPhys); AssertRC(rc);
485
486 return pStats;
487 }
488 AssertMsgFailed(("what! GCPhys=%RGp\n", GCPhys));
489 MMHyperFree(pVM, pStats);
490 }
491 return NULL;
492}
493
494#endif /* VBOX_WITH_STATISTICS */
495
496/**
497 * Registers a I/O port ring-3 handler.
498 *
499 * This API is called by PDM on behalf of a device. Devices must first register
500 * ring-3 ranges before any GC and R0 ranges can be registerd using IOMR3IOPortRegisterRC()
501 * and IOMR3IOPortRegisterR0().
502 *
503 *
504 * @returns VBox status code.
505 *
506 * @param pVM VM handle.
507 * @param pDevIns PDM device instance owning the port range.
508 * @param PortStart First port number in the range.
509 * @param cPorts Number of ports to register.
510 * @param pvUser User argument for the callbacks.
511 * @param pfnOutCallback Pointer to function which is gonna handle OUT operations in R3.
512 * @param pfnInCallback Pointer to function which is gonna handle IN operations in R3.
513 * @param pfnOutStrCallback Pointer to function which is gonna handle string OUT operations in R3.
514 * @param pfnInStrCallback Pointer to function which is gonna handle string IN operations in R3.
515 * @param pszDesc Pointer to description string. This must not be freed.
516 */
517VMMR3DECL(int) IOMR3IOPortRegisterR3(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts, RTHCPTR pvUser,
518 R3PTRTYPE(PFNIOMIOPORTOUT) pfnOutCallback, R3PTRTYPE(PFNIOMIOPORTIN) pfnInCallback,
519 R3PTRTYPE(PFNIOMIOPORTOUTSTRING) pfnOutStrCallback, R3PTRTYPE(PFNIOMIOPORTINSTRING) pfnInStrCallback, const char *pszDesc)
520{
521 LogFlow(("IOMR3IOPortRegisterR3: pDevIns=%p PortStart=%#x cPorts=%#x pvUser=%RHv pfnOutCallback=%#x pfnInCallback=%#x pfnOutStrCallback=%#x pfnInStrCallback=%#x pszDesc=%s\n",
522 pDevIns, PortStart, cPorts, pvUser, pfnOutCallback, pfnInCallback, pfnOutStrCallback, pfnInStrCallback, pszDesc));
523
524 /*
525 * Validate input.
526 */
527 if ( (RTUINT)PortStart + cPorts <= (RTUINT)PortStart
528 || (RTUINT)PortStart + cPorts > 0x10000)
529 {
530 AssertMsgFailed(("Invalid port range %#x-%#x (inclusive)! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc));
531 return VERR_IOM_INVALID_IOPORT_RANGE;
532 }
533 if (!pfnOutCallback && !pfnInCallback)
534 {
535 AssertMsgFailed(("no handlers specfied for %#x-%#x (inclusive)! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc));
536 return VERR_INVALID_PARAMETER;
537 }
538 if (!pfnOutCallback)
539 pfnOutCallback = iomR3IOPortDummyOut;
540 if (!pfnInCallback)
541 pfnInCallback = iomR3IOPortDummyIn;
542 if (!pfnOutStrCallback)
543 pfnOutStrCallback = iomR3IOPortDummyOutStr;
544 if (!pfnInStrCallback)
545 pfnInStrCallback = iomR3IOPortDummyInStr;
546
547 /* Flush the IO port lookup cache */
548 iomR3FlushCache(pVM);
549
550 /*
551 * Allocate new range record and initialize it.
552 */
553 PIOMIOPORTRANGER3 pRange;
554 int rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange);
555 if (RT_SUCCESS(rc))
556 {
557 pRange->Core.Key = PortStart;
558 pRange->Core.KeyLast = PortStart + (cPorts - 1);
559 pRange->Port = PortStart;
560 pRange->cPorts = cPorts;
561 pRange->pvUser = pvUser;
562 pRange->pDevIns = pDevIns;
563 pRange->pfnOutCallback = pfnOutCallback;
564 pRange->pfnInCallback = pfnInCallback;
565 pRange->pfnOutStrCallback = pfnOutStrCallback;
566 pRange->pfnInStrCallback = pfnInStrCallback;
567 pRange->pszDesc = pszDesc;
568
569 /*
570 * Try Insert it.
571 */
572 iomLock(pVM);
573 if (RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeR3, &pRange->Core))
574 {
575 #ifdef VBOX_WITH_STATISTICS
576 for (unsigned iPort = 0; iPort < cPorts; iPort++)
577 iomR3IOPortStatsCreate(pVM, PortStart + iPort, pszDesc);
578 #endif
579 iomUnlock(pVM);
580 return VINF_SUCCESS;
581 }
582 iomUnlock(pVM);
583
584 /* conflict. */
585 DBGFR3Info(pVM, "ioport", NULL, NULL);
586 AssertMsgFailed(("Port range %#x-%#x (%s) conflicts with existing range(s)!\n", PortStart, (unsigned)PortStart + cPorts - 1, pszDesc));
587 MMHyperFree(pVM, pRange);
588 rc = VERR_IOM_IOPORT_RANGE_CONFLICT;
589 }
590
591 return rc;
592}
593
594
595/**
596 * Registers a I/O port RC handler.
597 *
598 * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges
599 * using IOMIOPortRegisterR3() before calling this function.
600 *
601 *
602 * @returns VBox status code.
603 *
604 * @param pVM VM handle.
605 * @param pDevIns PDM device instance owning the port range.
606 * @param PortStart First port number in the range.
607 * @param cPorts Number of ports to register.
608 * @param pvUser User argument for the callbacks.
609 * @param pfnOutCallback Pointer to function which is gonna handle OUT operations in GC.
610 * @param pfnInCallback Pointer to function which is gonna handle IN operations in GC.
611 * @param pfnOutStrCallback Pointer to function which is gonna handle string OUT operations in GC.
612 * @param pfnInStrCallback Pointer to function which is gonna handle string IN operations in GC.
613 * @param pszDesc Pointer to description string. This must not be freed.
614 */
615VMMR3DECL(int) IOMR3IOPortRegisterRC(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts, RTRCPTR pvUser,
616 RCPTRTYPE(PFNIOMIOPORTOUT) pfnOutCallback, RCPTRTYPE(PFNIOMIOPORTIN) pfnInCallback,
617 RCPTRTYPE(PFNIOMIOPORTOUTSTRING) pfnOutStrCallback, RCPTRTYPE(PFNIOMIOPORTINSTRING) pfnInStrCallback, const char *pszDesc)
618{
619 LogFlow(("IOMR3IOPortRegisterRC: pDevIns=%p PortStart=%#x cPorts=%#x pvUser=%RRv pfnOutCallback=%RRv pfnInCallback=%RRv pfnOutStrCallback=%RRv pfnInStrCallback=%RRv pszDesc=%s\n",
620 pDevIns, PortStart, cPorts, pvUser, pfnOutCallback, pfnInCallback, pfnOutStrCallback, pfnInStrCallback, pszDesc));
621
622 /*
623 * Validate input.
624 */
625 if ( (RTUINT)PortStart + cPorts <= (RTUINT)PortStart
626 || (RTUINT)PortStart + cPorts > 0x10000)
627 {
628 AssertMsgFailed(("Invalid port range %#x-%#x! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc));
629 return VERR_IOM_INVALID_IOPORT_RANGE;
630 }
631 RTIOPORT PortLast = PortStart + (cPorts - 1);
632 if (!pfnOutCallback && !pfnInCallback)
633 {
634 AssertMsgFailed(("Invalid port range %#x-%#x! No callbacks! (%s)\n", PortStart, PortLast, pszDesc));
635 return VERR_INVALID_PARAMETER;
636 }
637
638 iomLock(pVM);
639
640 /*
641 * Validate that there are ring-3 ranges for the ports.
642 */
643 RTIOPORT Port = PortStart;
644 while (Port <= PortLast && Port >= PortStart)
645 {
646 PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeR3, Port);
647 if (!pRange)
648 {
649 AssertMsgFailed(("No R3! Port=#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc));
650 iomUnlock(pVM);
651 return VERR_IOM_NO_HC_IOPORT_RANGE;
652 }
653#ifndef IOM_NO_PDMINS_CHECKS
654# ifndef IN_RC
655 if (pRange->pDevIns != pDevIns)
656# else
657 if (pRange->pDevIns != MMHyperRCToCC(pVM, pDevIns))
658# endif
659 {
660 AssertMsgFailed(("Not owner! Port=%#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc));
661 iomUnlock(pVM);
662 return VERR_IOM_NOT_IOPORT_RANGE_OWNER;
663 }
664#endif
665 Port = pRange->Core.KeyLast + 1;
666 }
667
668 /* Flush the IO port lookup cache */
669 iomR3FlushCache(pVM);
670
671 /*
672 * Allocate new range record and initialize it.
673 */
674 PIOMIOPORTRANGERC pRange;
675 int rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange);
676 if (RT_SUCCESS(rc))
677 {
678 pRange->Core.Key = PortStart;
679 pRange->Core.KeyLast = PortLast;
680 pRange->Port = PortStart;
681 pRange->cPorts = cPorts;
682 pRange->pvUser = pvUser;
683 pRange->pfnOutCallback = pfnOutCallback;
684 pRange->pfnInCallback = pfnInCallback;
685 pRange->pfnOutStrCallback = pfnOutStrCallback;
686 pRange->pfnInStrCallback = pfnInStrCallback;
687 pRange->pDevIns = MMHyperCCToRC(pVM, pDevIns);
688 pRange->pszDesc = pszDesc;
689
690 /*
691 * Insert it.
692 */
693 if (RTAvlroIOPortInsert(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeRC, &pRange->Core))
694 {
695 iomUnlock(pVM);
696 return VINF_SUCCESS;
697 }
698
699 /* conflict. */
700 AssertMsgFailed(("Port range %#x-%#x (%s) conflicts with existing range(s)!\n", PortStart, (unsigned)PortStart + cPorts - 1, pszDesc));
701 MMHyperFree(pVM, pRange);
702 rc = VERR_IOM_IOPORT_RANGE_CONFLICT;
703 }
704 iomUnlock(pVM);
705 return rc;
706}
707
708
709/**
710 * Registers a Port IO R0 handler.
711 *
712 * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges
713 * using IOMR3IOPortRegisterR3() before calling this function.
714 *
715 *
716 * @returns VBox status code.
717 *
718 * @param pVM VM handle.
719 * @param pDevIns PDM device instance owning the port range.
720 * @param PortStart First port number in the range.
721 * @param cPorts Number of ports to register.
722 * @param pvUser User argument for the callbacks.
723 * @param pfnOutCallback Pointer to function which is gonna handle OUT operations in GC.
724 * @param pfnInCallback Pointer to function which is gonna handle IN operations in GC.
725 * @param pfnOutStrCallback Pointer to function which is gonna handle OUT operations in GC.
726 * @param pfnInStrCallback Pointer to function which is gonna handle IN operations in GC.
727 * @param pszDesc Pointer to description string. This must not be freed.
728 */
729VMMR3DECL(int) IOMR3IOPortRegisterR0(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts, RTR0PTR pvUser,
730 R0PTRTYPE(PFNIOMIOPORTOUT) pfnOutCallback, R0PTRTYPE(PFNIOMIOPORTIN) pfnInCallback,
731 R0PTRTYPE(PFNIOMIOPORTOUTSTRING) pfnOutStrCallback, R0PTRTYPE(PFNIOMIOPORTINSTRING) pfnInStrCallback,
732 const char *pszDesc)
733{
734 LogFlow(("IOMR3IOPortRegisterR0: pDevIns=%p PortStart=%#x cPorts=%#x pvUser=%RHv pfnOutCallback=%RHv pfnInCallback=%RHv pfnOutStrCallback=%RHv pfnInStrCallback=%RHv pszDesc=%s\n",
735 pDevIns, PortStart, cPorts, pvUser, pfnOutCallback, pfnInCallback, pfnOutStrCallback, pfnInStrCallback, pszDesc));
736
737 /*
738 * Validate input.
739 */
740 if ( (RTUINT)PortStart + cPorts <= (RTUINT)PortStart
741 || (RTUINT)PortStart + cPorts > 0x10000)
742 {
743 AssertMsgFailed(("Invalid port range %#x-%#x! (%s)\n", PortStart, (RTUINT)PortStart + (cPorts - 1), pszDesc));
744 return VERR_IOM_INVALID_IOPORT_RANGE;
745 }
746 RTIOPORT PortLast = PortStart + (cPorts - 1);
747 if (!pfnOutCallback && !pfnInCallback)
748 {
749 AssertMsgFailed(("Invalid port range %#x-%#x! No callbacks! (%s)\n", PortStart, PortLast, pszDesc));
750 return VERR_INVALID_PARAMETER;
751 }
752
753 iomLock(pVM);
754 /*
755 * Validate that there are ring-3 ranges for the ports.
756 */
757 RTIOPORT Port = PortStart;
758 while (Port <= PortLast && Port >= PortStart)
759 {
760 PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeR3, Port);
761 if (!pRange)
762 {
763 AssertMsgFailed(("No R3! Port=#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc));
764 iomUnlock(pVM);
765 return VERR_IOM_NO_HC_IOPORT_RANGE;
766 }
767#ifndef IOM_NO_PDMINS_CHECKS
768# ifndef IN_RC
769 if (pRange->pDevIns != pDevIns)
770# else
771 if (pRange->pDevIns != MMHyperRCToCC(pVM, pDevIns))
772# endif
773 {
774 AssertMsgFailed(("Not owner! Port=%#x %#x-%#x! (%s)\n", Port, PortStart, (unsigned)PortStart + cPorts - 1, pszDesc));
775 iomUnlock(pVM);
776 return VERR_IOM_NOT_IOPORT_RANGE_OWNER;
777 }
778#endif
779 Port = pRange->Core.KeyLast + 1;
780 }
781
782 /* Flush the IO port lookup cache */
783 iomR3FlushCache(pVM);
784
785 /*
786 * Allocate new range record and initialize it.
787 */
788 PIOMIOPORTRANGER0 pRange;
789 int rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange);
790 if (RT_SUCCESS(rc))
791 {
792 pRange->Core.Key = PortStart;
793 pRange->Core.KeyLast = PortLast;
794 pRange->Port = PortStart;
795 pRange->cPorts = cPorts;
796 pRange->pvUser = pvUser;
797 pRange->pfnOutCallback = pfnOutCallback;
798 pRange->pfnInCallback = pfnInCallback;
799 pRange->pfnOutStrCallback = pfnOutStrCallback;
800 pRange->pfnInStrCallback = pfnInStrCallback;
801 pRange->pDevIns = MMHyperR3ToR0(pVM, pDevIns);
802 pRange->pszDesc = pszDesc;
803
804 /*
805 * Insert it.
806 */
807 if (RTAvlroIOPortInsert(&pVM->iom.s.CTX_SUFF(pTrees)->IOPortTreeR0, &pRange->Core))
808 {
809 iomUnlock(pVM);
810 return VINF_SUCCESS;
811 }
812
813 /* conflict. */
814 AssertMsgFailed(("Port range %#x-%#x (%s) conflicts with existing range(s)!\n", PortStart, (unsigned)PortStart + cPorts - 1, pszDesc));
815 MMHyperFree(pVM, pRange);
816 rc = VERR_IOM_IOPORT_RANGE_CONFLICT;
817 }
818 iomUnlock(pVM);
819 return rc;
820}
821
822
823/**
824 * Deregisters a I/O Port range.
825 *
826 * The specified range must be registered using IOMR3IOPortRegister previous to
827 * this call. The range does can be a smaller part of the range specified to
828 * IOMR3IOPortRegister, but it can never be larger.
829 *
830 * This function will remove GC, R0 and R3 context port handlers for this range.
831 *
832 * @returns VBox status code.
833 *
834 * @param pVM The virtual machine.
835 * @param pDevIns The device instance associated with the range.
836 * @param PortStart First port number in the range.
837 * @param cPorts Number of ports to remove starting at PortStart.
838 *
839 * @remark This function mainly for PCI PnP Config and will not do
840 * all the checks you might expect it to do.
841 */
842VMMR3DECL(int) IOMR3IOPortDeregister(PVM pVM, PPDMDEVINS pDevIns, RTIOPORT PortStart, RTUINT cPorts)
843{
844 LogFlow(("IOMR3IOPortDeregister: pDevIns=%p PortStart=%#x cPorts=%#x\n", pDevIns, PortStart, cPorts));
845
846 /*
847 * Validate input.
848 */
849 if ( (RTUINT)PortStart + cPorts < (RTUINT)PortStart
850 || (RTUINT)PortStart + cPorts > 0x10000)
851 {
852 AssertMsgFailed(("Invalid port range %#x-%#x!\n", PortStart, (unsigned)PortStart + cPorts - 1));
853 return VERR_IOM_INVALID_IOPORT_RANGE;
854 }
855
856 iomLock(pVM);
857
858 /* Flush the IO port lookup cache */
859 iomR3FlushCache(pVM);
860
861 /*
862 * Check ownership.
863 */
864 RTIOPORT PortLast = PortStart + (cPorts - 1);
865 RTIOPORT Port = PortStart;
866 while (Port <= PortLast && Port >= PortStart)
867 {
868 PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeR3, Port);
869 if (pRange)
870 {
871 Assert(Port <= pRange->Core.KeyLast);
872#ifndef IOM_NO_PDMINS_CHECKS
873 if (pRange->pDevIns != pDevIns)
874 {
875 AssertMsgFailed(("Removal of ports in range %#x-%#x rejected because not owner of %#x-%#x (%s)\n",
876 PortStart, PortLast, pRange->Core.Key, pRange->Core.KeyLast, pRange->pszDesc));
877 iomUnlock(pVM);
878 return VERR_IOM_NOT_IOPORT_RANGE_OWNER;
879 }
880#endif /* !IOM_NO_PDMINS_CHECKS */
881 Port = pRange->Core.KeyLast;
882 }
883 Port++;
884 }
885
886 /*
887 * Remove any RC ranges first.
888 */
889 int rc = VINF_SUCCESS;
890 Port = PortStart;
891 while (Port <= PortLast && Port >= PortStart)
892 {
893 /*
894 * Try find range.
895 */
896 PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeRC, Port);
897 if (pRange)
898 {
899 if ( pRange->Core.Key == Port
900 && pRange->Core.KeyLast <= PortLast)
901 {
902 /*
903 * Kick out the entire range.
904 */
905 void *pv = RTAvlroIOPortRemove(&pVM->iom.s.pTreesR3->IOPortTreeRC, Port);
906 Assert(pv == (void *)pRange); NOREF(pv);
907 Port += pRange->cPorts;
908 MMHyperFree(pVM, pRange);
909 }
910 else if (pRange->Core.Key == Port)
911 {
912 /*
913 * Cut of the head of the range, done.
914 */
915 pRange->cPorts -= Port - pRange->Port;
916 pRange->Core.Key = Port;
917 pRange->Port = Port;
918 break;
919 }
920 else if (pRange->Core.KeyLast <= PortLast)
921 {
922 /*
923 * Just cut of the tail.
924 */
925 unsigned c = pRange->Core.KeyLast - Port + 1;
926 pRange->Core.KeyLast -= c;
927 pRange->cPorts -= c;
928 Port += c;
929 }
930 else
931 {
932 /*
933 * Split the range, done.
934 */
935 Assert(pRange->Core.KeyLast > PortLast && pRange->Core.Key < Port);
936 /* create tail. */
937 PIOMIOPORTRANGERC pRangeNew;
938 int rc2 = MMHyperAlloc(pVM, sizeof(*pRangeNew), 0, MM_TAG_IOM, (void **)&pRangeNew);
939 if (RT_FAILURE(rc2))
940 {
941 iomUnlock(pVM);
942 return rc2;
943 }
944 *pRangeNew = *pRange;
945 pRangeNew->Core.Key = PortLast;
946 pRangeNew->Port = PortLast;
947 pRangeNew->cPorts = pRangeNew->Core.KeyLast - PortLast + 1;
948
949 LogFlow(("IOMR3IOPortDeregister (rc): split the range; new %x\n", pRangeNew->Core.Key));
950
951 /* adjust head */
952 pRange->Core.KeyLast = Port - 1;
953 pRange->cPorts = Port - pRange->Port;
954
955 /* insert */
956 if (!RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeRC, &pRangeNew->Core))
957 {
958 AssertMsgFailed(("This cannot happen!\n"));
959 MMHyperFree(pVM, pRangeNew);
960 rc = VERR_INTERNAL_ERROR;
961 }
962 break;
963 }
964 }
965 else /* next port */
966 Port++;
967 } /* for all ports - RC. */
968
969
970 /*
971 * Remove any R0 ranges.
972 */
973 Port = PortStart;
974 while (Port <= PortLast && Port >= PortStart)
975 {
976 /*
977 * Try find range.
978 */
979 PIOMIOPORTRANGER0 pRange = (PIOMIOPORTRANGER0)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeR0, Port);
980 if (pRange)
981 {
982 if ( pRange->Core.Key == Port
983 && pRange->Core.KeyLast <= PortLast)
984 {
985 /*
986 * Kick out the entire range.
987 */
988 void *pv = RTAvlroIOPortRemove(&pVM->iom.s.pTreesR3->IOPortTreeR0, Port);
989 Assert(pv == (void *)pRange); NOREF(pv);
990 Port += pRange->cPorts;
991 MMHyperFree(pVM, pRange);
992 }
993 else if (pRange->Core.Key == Port)
994 {
995 /*
996 * Cut of the head of the range, done.
997 */
998 pRange->cPorts -= Port - pRange->Port;
999 pRange->Core.Key = Port;
1000 pRange->Port = Port;
1001 break;
1002 }
1003 else if (pRange->Core.KeyLast <= PortLast)
1004 {
1005 /*
1006 * Just cut of the tail.
1007 */
1008 unsigned c = pRange->Core.KeyLast - Port + 1;
1009 pRange->Core.KeyLast -= c;
1010 pRange->cPorts -= c;
1011 Port += c;
1012 }
1013 else
1014 {
1015 /*
1016 * Split the range, done.
1017 */
1018 Assert(pRange->Core.KeyLast > PortLast && pRange->Core.Key < Port);
1019 /* create tail. */
1020 PIOMIOPORTRANGER0 pRangeNew;
1021 int rc2 = MMHyperAlloc(pVM, sizeof(*pRangeNew), 0, MM_TAG_IOM, (void **)&pRangeNew);
1022 if (RT_FAILURE(rc2))
1023 {
1024 iomUnlock(pVM);
1025 return rc2;
1026 }
1027 *pRangeNew = *pRange;
1028 pRangeNew->Core.Key = PortLast;
1029 pRangeNew->Port = PortLast;
1030 pRangeNew->cPorts = pRangeNew->Core.KeyLast - PortLast + 1;
1031
1032 LogFlow(("IOMR3IOPortDeregister (r0): split the range; new %x\n", pRangeNew->Core.Key));
1033
1034 /* adjust head */
1035 pRange->Core.KeyLast = Port - 1;
1036 pRange->cPorts = Port - pRange->Port;
1037
1038 /* insert */
1039 if (!RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeR0, &pRangeNew->Core))
1040 {
1041 AssertMsgFailed(("This cannot happen!\n"));
1042 MMHyperFree(pVM, pRangeNew);
1043 rc = VERR_INTERNAL_ERROR;
1044 }
1045 break;
1046 }
1047 }
1048 else /* next port */
1049 Port++;
1050 } /* for all ports - R0. */
1051
1052 /*
1053 * And the same procedure for ring-3 ranges.
1054 */
1055 Port = PortStart;
1056 while (Port <= PortLast && Port >= PortStart)
1057 {
1058 /*
1059 * Try find range.
1060 */
1061 PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)RTAvlroIOPortRangeGet(&pVM->iom.s.pTreesR3->IOPortTreeR3, Port);
1062 if (pRange)
1063 {
1064 if ( pRange->Core.Key == Port
1065 && pRange->Core.KeyLast <= PortLast)
1066 {
1067 /*
1068 * Kick out the entire range.
1069 */
1070 void *pv = RTAvlroIOPortRemove(&pVM->iom.s.pTreesR3->IOPortTreeR3, Port);
1071 Assert(pv == (void *)pRange); NOREF(pv);
1072 Port += pRange->cPorts;
1073 MMHyperFree(pVM, pRange);
1074 }
1075 else if (pRange->Core.Key == Port)
1076 {
1077 /*
1078 * Cut of the head of the range, done.
1079 */
1080 pRange->cPorts -= Port - pRange->Port;
1081 pRange->Core.Key = Port;
1082 pRange->Port = Port;
1083 break;
1084 }
1085 else if (pRange->Core.KeyLast <= PortLast)
1086 {
1087 /*
1088 * Just cut of the tail.
1089 */
1090 unsigned c = pRange->Core.KeyLast - Port + 1;
1091 pRange->Core.KeyLast -= c;
1092 pRange->cPorts -= c;
1093 Port += c;
1094 }
1095 else
1096 {
1097 /*
1098 * Split the range, done.
1099 */
1100 Assert(pRange->Core.KeyLast > PortLast && pRange->Core.Key < Port);
1101 /* create tail. */
1102 PIOMIOPORTRANGER3 pRangeNew;
1103 int rc2 = MMHyperAlloc(pVM, sizeof(*pRangeNew), 0, MM_TAG_IOM, (void **)&pRangeNew);
1104 if (RT_FAILURE(rc2))
1105 {
1106 iomUnlock(pVM);
1107 return rc2;
1108 }
1109 *pRangeNew = *pRange;
1110 pRangeNew->Core.Key = PortLast;
1111 pRangeNew->Port = PortLast;
1112 pRangeNew->cPorts = pRangeNew->Core.KeyLast - PortLast + 1;
1113
1114 LogFlow(("IOMR3IOPortDeregister (r3): split the range; new %x\n", pRangeNew->Core.Key));
1115
1116 /* adjust head */
1117 pRange->Core.KeyLast = Port - 1;
1118 pRange->cPorts = Port - pRange->Port;
1119
1120 /* insert */
1121 if (!RTAvlroIOPortInsert(&pVM->iom.s.pTreesR3->IOPortTreeR3, &pRangeNew->Core))
1122 {
1123 AssertMsgFailed(("This cannot happen!\n"));
1124 MMHyperFree(pVM, pRangeNew);
1125 rc = VERR_INTERNAL_ERROR;
1126 }
1127 break;
1128 }
1129 }
1130 else /* next port */
1131 Port++;
1132 } /* for all ports - ring-3. */
1133
1134 /* done */
1135 iomUnlock(pVM);
1136 return rc;
1137}
1138
1139
1140/**
1141 * Dummy Port I/O Handler for IN operations.
1142 *
1143 * @returns VBox status code.
1144 *
1145 * @param pDevIns The device instance.
1146 * @param pvUser User argument.
1147 * @param Port Port number used for the IN operation.
1148 * @param pu32 Where to store the result.
1149 * @param cb Number of bytes read.
1150 */
1151static DECLCALLBACK(int) iomR3IOPortDummyIn(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint32_t *pu32, unsigned cb)
1152{
1153 switch (cb)
1154 {
1155 case 1: *pu32 = 0xff; break;
1156 case 2: *pu32 = 0xffff; break;
1157 case 4: *pu32 = UINT32_C(0xffffffff); break;
1158 default:
1159 AssertReleaseMsgFailed(("cb=%d\n", cb));
1160 return VERR_INTERNAL_ERROR;
1161 }
1162 return VINF_SUCCESS;
1163}
1164
1165
1166/**
1167 * Dummy Port I/O Handler for string IN operations.
1168 *
1169 * @returns VBox status code.
1170 *
1171 * @param pDevIns The device instance.
1172 * @param pvUser User argument.
1173 * @param Port Port number used for the string IN operation.
1174 * @param pGCPtrDst Pointer to the destination buffer (GC, incremented appropriately).
1175 * @param pcTransfer Pointer to the number of transfer units to read, on return remaining transfer units.
1176 * @param cb Size of the transfer unit (1, 2 or 4 bytes).
1177 */
1178static DECLCALLBACK(int) iomR3IOPortDummyInStr(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, RTGCPTR *pGCPtrDst, PRTGCUINTREG pcTransfer, unsigned cb)
1179{
1180 return VINF_SUCCESS;
1181}
1182
1183
1184/**
1185 * Dummy Port I/O Handler for OUT operations.
1186 *
1187 * @returns VBox status code.
1188 *
1189 * @param pDevIns The device instance.
1190 * @param pvUser User argument.
1191 * @param Port Port number used for the OUT operation.
1192 * @param u32 The value to output.
1193 * @param cb The value size in bytes.
1194 */
1195static DECLCALLBACK(int) iomR3IOPortDummyOut(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, uint32_t u32, unsigned cb)
1196{
1197 return VINF_SUCCESS;
1198}
1199
1200
1201/**
1202 * Dummy Port I/O Handler for string OUT operations.
1203 *
1204 * @returns VBox status code.
1205 *
1206 * @param pDevIns The device instance.
1207 * @param pvUser User argument.
1208 * @param Port Port number used for the string OUT operation.
1209 * @param pGCPtrSrc Pointer to the source buffer (GC, incremented appropriately).
1210 * @param pcTransfer Pointer to the number of transfer units to write, on return remaining transfer units.
1211 * @param cb Size of the transfer unit (1, 2 or 4 bytes).
1212 */
1213static DECLCALLBACK(int) iomR3IOPortDummyOutStr(PPDMDEVINS pDevIns, void *pvUser, RTIOPORT Port, RTGCPTR *pGCPtrSrc, PRTGCUINTREG pcTransfer, unsigned cb)
1214{
1215 return VINF_SUCCESS;
1216}
1217
1218
1219/**
1220 * Display a single I/O port ring-3 range.
1221 *
1222 * @returns 0
1223 * @param pNode Pointer to I/O port HC range.
1224 * @param pvUser Pointer to info output callback structure.
1225 */
1226static DECLCALLBACK(int) iomR3IOPortInfoOneR3(PAVLROIOPORTNODECORE pNode, void *pvUser)
1227{
1228 PIOMIOPORTRANGER3 pRange = (PIOMIOPORTRANGER3)pNode;
1229 PCDBGFINFOHLP pHlp = (PCDBGFINFOHLP)pvUser;
1230 pHlp->pfnPrintf(pHlp,
1231 "%04x-%04x %p %p %p %p %s\n",
1232 pRange->Core.Key,
1233 pRange->Core.KeyLast,
1234 pRange->pDevIns,
1235 pRange->pfnInCallback,
1236 pRange->pfnOutCallback,
1237 pRange->pvUser,
1238 pRange->pszDesc);
1239 return 0;
1240}
1241
1242
1243/**
1244 * Display a single I/O port GC range.
1245 *
1246 * @returns 0
1247 * @param pNode Pointer to IOPORT GC range.
1248 * @param pvUser Pointer to info output callback structure.
1249 */
1250static DECLCALLBACK(int) iomR3IOPortInfoOneRC(PAVLROIOPORTNODECORE pNode, void *pvUser)
1251{
1252 PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)pNode;
1253 PCDBGFINFOHLP pHlp = (PCDBGFINFOHLP)pvUser;
1254 pHlp->pfnPrintf(pHlp,
1255 "%04x-%04x %RRv %RRv %RRv %RRv %s\n",
1256 pRange->Core.Key,
1257 pRange->Core.KeyLast,
1258 pRange->pDevIns,
1259 pRange->pfnInCallback,
1260 pRange->pfnOutCallback,
1261 pRange->pvUser,
1262 pRange->pszDesc);
1263 return 0;
1264}
1265
1266
1267/**
1268 * Display all registered I/O port ranges.
1269 *
1270 * @param pVM VM Handle.
1271 * @param pHlp The info helpers.
1272 * @param pszArgs Arguments, ignored.
1273 */
1274static DECLCALLBACK(void) iomR3IOPortInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs)
1275{
1276 NOREF(pszArgs);
1277 pHlp->pfnPrintf(pHlp,
1278 "I/O Port R3 ranges (pVM=%p)\n"
1279 "Range %.*s %.*s %.*s %.*s Description\n",
1280 pVM,
1281 sizeof(RTHCPTR) * 2, "pDevIns ",
1282 sizeof(RTHCPTR) * 2, "In ",
1283 sizeof(RTHCPTR) * 2, "Out ",
1284 sizeof(RTHCPTR) * 2, "pvUser ");
1285 RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeR3, true, iomR3IOPortInfoOneR3, (void *)pHlp);
1286
1287 pHlp->pfnPrintf(pHlp,
1288 "I/O Port R0 ranges (pVM=%p)\n"
1289 "Range %.*s %.*s %.*s %.*s Description\n",
1290 pVM,
1291 sizeof(RTHCPTR) * 2, "pDevIns ",
1292 sizeof(RTHCPTR) * 2, "In ",
1293 sizeof(RTHCPTR) * 2, "Out ",
1294 sizeof(RTHCPTR) * 2, "pvUser ");
1295 RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeR0, true, iomR3IOPortInfoOneR3, (void *)pHlp);
1296
1297 pHlp->pfnPrintf(pHlp,
1298 "I/O Port GC ranges (pVM=%p)\n"
1299 "Range %.*s %.*s %.*s %.*s Description\n",
1300 pVM,
1301 sizeof(RTRCPTR) * 2, "pDevIns ",
1302 sizeof(RTRCPTR) * 2, "In ",
1303 sizeof(RTRCPTR) * 2, "Out ",
1304 sizeof(RTRCPTR) * 2, "pvUser ");
1305 RTAvlroIOPortDoWithAll(&pVM->iom.s.pTreesR3->IOPortTreeRC, true, iomR3IOPortInfoOneRC, (void *)pHlp);
1306
1307 if (pVM->iom.s.pRangeLastReadRC)
1308 {
1309 PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)MMHyperRCToCC(pVM, pVM->iom.s.pRangeLastReadRC);
1310 pHlp->pfnPrintf(pHlp, "RC Read Ports: %#04x-%#04x %RRv %s\n",
1311 pRange->Port, pRange->Port + pRange->cPorts, pVM->iom.s.pRangeLastReadRC, pRange->pszDesc);
1312 }
1313 if (pVM->iom.s.pStatsLastReadRC)
1314 {
1315 PIOMIOPORTSTATS pRange = (PIOMIOPORTSTATS)MMHyperRCToCC(pVM, pVM->iom.s.pStatsLastReadRC);
1316 pHlp->pfnPrintf(pHlp, "RC Read Stats: %#04x %RRv\n",
1317 pRange->Core.Key, pVM->iom.s.pStatsLastReadRC);
1318 }
1319
1320 if (pVM->iom.s.pRangeLastWriteRC)
1321 {
1322 PIOMIOPORTRANGERC pRange = (PIOMIOPORTRANGERC)MMHyperRCToCC(pVM, pVM->iom.s.pRangeLastWriteRC);
1323 pHlp->pfnPrintf(pHlp, "RC Write Ports: %#04x-%#04x %RRv %s\n",
1324 pRange->Port, pRange->Port + pRange->cPorts, pVM->iom.s.pRangeLastWriteRC, pRange->pszDesc);
1325 }
1326 if (pVM->iom.s.pStatsLastWriteRC)
1327 {
1328 PIOMIOPORTSTATS pRange = (PIOMIOPORTSTATS)MMHyperRCToCC(pVM, pVM->iom.s.pStatsLastWriteRC);
1329 pHlp->pfnPrintf(pHlp, "RC Write Stats: %#04x %RRv\n",
1330 pRange->Core.Key, pVM->iom.s.pStatsLastWriteRC);
1331 }
1332
1333 if (pVM->iom.s.pRangeLastReadR3)
1334 {
1335 PIOMIOPORTRANGER3 pRange = pVM->iom.s.pRangeLastReadR3;
1336 pHlp->pfnPrintf(pHlp, "R3 Read Ports: %#04x-%#04x %p %s\n",
1337 pRange->Port, pRange->Port + pRange->cPorts, pRange, pRange->pszDesc);
1338 }
1339 if (pVM->iom.s.pStatsLastReadR3)
1340 {
1341 PIOMIOPORTSTATS pRange = pVM->iom.s.pStatsLastReadR3;
1342 pHlp->pfnPrintf(pHlp, "R3 Read Stats: %#04x %p\n",
1343 pRange->Core.Key, pRange);
1344 }
1345
1346 if (pVM->iom.s.pRangeLastWriteR3)
1347 {
1348 PIOMIOPORTRANGER3 pRange = pVM->iom.s.pRangeLastWriteR3;
1349 pHlp->pfnPrintf(pHlp, "R3 Write Ports: %#04x-%#04x %p %s\n",
1350 pRange->Port, pRange->Port + pRange->cPorts, pRange, pRange->pszDesc);
1351 }
1352 if (pVM->iom.s.pStatsLastWriteR3)
1353 {
1354 PIOMIOPORTSTATS pRange = pVM->iom.s.pStatsLastWriteR3;
1355 pHlp->pfnPrintf(pHlp, "R3 Write Stats: %#04x %p\n",
1356 pRange->Core.Key, pRange);
1357 }
1358
1359 if (pVM->iom.s.pRangeLastReadR0)
1360 {
1361 PIOMIOPORTRANGER0 pRange = (PIOMIOPORTRANGER0)MMHyperR0ToCC(pVM, pVM->iom.s.pRangeLastReadR0);
1362 pHlp->pfnPrintf(pHlp, "R0 Read Ports: %#04x-%#04x %p %s\n",
1363 pRange->Port, pRange->Port + pRange->cPorts, pRange, pRange->pszDesc);
1364 }
1365 if (pVM->iom.s.pStatsLastReadR0)
1366 {
1367 PIOMIOPORTSTATS pRange = (PIOMIOPORTSTATS)MMHyperR0ToCC(pVM, pVM->iom.s.pStatsLastReadR0);
1368 pHlp->pfnPrintf(pHlp, "R0 Read Stats: %#04x %p\n",
1369 pRange->Core.Key, pRange);
1370 }
1371
1372 if (pVM->iom.s.pRangeLastWriteR0)
1373 {
1374 PIOMIOPORTRANGER0 pRange = (PIOMIOPORTRANGER0)MMHyperR0ToCC(pVM, pVM->iom.s.pRangeLastWriteR0);
1375 pHlp->pfnPrintf(pHlp, "R0 Write Ports: %#04x-%#04x %p %s\n",
1376 pRange->Port, pRange->Port + pRange->cPorts, pRange, pRange->pszDesc);
1377 }
1378 if (pVM->iom.s.pStatsLastWriteR0)
1379 {
1380 PIOMIOPORTSTATS pRange = (PIOMIOPORTSTATS)MMHyperR0ToCC(pVM, pVM->iom.s.pStatsLastWriteR0);
1381 pHlp->pfnPrintf(pHlp, "R0 Write Stats: %#04x %p\n",
1382 pRange->Core.Key, pRange);
1383 }
1384}
1385
1386
1387/**
1388 * Registers a Memory Mapped I/O R3 handler.
1389 *
1390 * This API is called by PDM on behalf of a device. Devices must register ring-3 ranges
1391 * before any GC and R0 ranges can be registered using IOMR3MMIORegisterRC() and IOMR3MMIORegisterR0().
1392 *
1393 * @returns VBox status code.
1394 *
1395 * @param pVM VM handle.
1396 * @param pDevIns PDM device instance owning the MMIO range.
1397 * @param GCPhysStart First physical address in the range.
1398 * @param cbRange The size of the range (in bytes).
1399 * @param pvUser User argument for the callbacks.
1400 * @param pfnWriteCallback Pointer to function which is gonna handle Write operations.
1401 * @param pfnReadCallback Pointer to function which is gonna handle Read operations.
1402 * @param pfnFillCallback Pointer to function which is gonna handle Fill/memset operations.
1403 * @param pszDesc Pointer to description string. This must not be freed.
1404 */
1405VMMR3DECL(int) IOMR3MMIORegisterR3(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTHCPTR pvUser,
1406 R3PTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallback, R3PTRTYPE(PFNIOMMMIOREAD) pfnReadCallback,
1407 R3PTRTYPE(PFNIOMMMIOFILL) pfnFillCallback, const char *pszDesc)
1408{
1409 LogFlow(("IOMR3MMIORegisterR3: pDevIns=%p GCPhysStart=%RGp cbRange=%#x pvUser=%RHv pfnWriteCallback=%#x pfnReadCallback=%#x pfnFillCallback=%#x pszDesc=%s\n",
1410 pDevIns, GCPhysStart, cbRange, pvUser, pfnWriteCallback, pfnReadCallback, pfnFillCallback, pszDesc));
1411 int rc;
1412
1413 /*
1414 * Validate input.
1415 */
1416 if (GCPhysStart + (cbRange - 1) < GCPhysStart)
1417 {
1418 AssertMsgFailed(("Wrapped! %RGp %#x bytes\n", GCPhysStart, cbRange));
1419 return VERR_IOM_INVALID_MMIO_RANGE;
1420 }
1421
1422 /*
1423 * Resolve the GC/R0 handler addresses lazily because of init order.
1424 */
1425 if (pVM->iom.s.pfnMMIOHandlerR0 == NIL_RTR0PTR)
1426 {
1427 rc = PDMR3LdrGetSymbolRCLazy(pVM, NULL, "IOMMMIOHandler", &pVM->iom.s.pfnMMIOHandlerRC);
1428 AssertLogRelRCReturn(rc, rc);
1429 rc = PDMR3LdrGetSymbolR0Lazy(pVM, NULL, "IOMMMIOHandler", &pVM->iom.s.pfnMMIOHandlerR0);
1430 AssertLogRelRCReturn(rc, rc);
1431 }
1432
1433 /*
1434 * For the 2nd+ instance, mangle the description string so it's unique.
1435 * (PGM requires this.)
1436 */
1437 if (pDevIns->iInstance > 0) /** @todo Move to PDMDevHlp.cpp and use a string cache. */
1438 {
1439 pszDesc = MMR3HeapAPrintf(pVM, MM_TAG_IOM, "%s [%u]", pszDesc, pDevIns->iInstance);
1440 if (!pszDesc)
1441 return VERR_NO_MEMORY;
1442 }
1443
1444
1445 /*
1446 * Allocate new range record and initialize it.
1447 */
1448 PIOMMMIORANGE pRange;
1449 rc = MMHyperAlloc(pVM, sizeof(*pRange), 0, MM_TAG_IOM, (void **)&pRange);
1450 if (RT_SUCCESS(rc))
1451 {
1452 pRange->Core.Key = GCPhysStart;
1453 pRange->Core.KeyLast = GCPhysStart + (cbRange - 1);
1454 pRange->GCPhys = GCPhysStart;
1455 pRange->cb = cbRange;
1456 pRange->pszDesc = pszDesc;
1457
1458 pRange->pvUserR3 = pvUser;
1459 pRange->pDevInsR3 = pDevIns;
1460 pRange->pfnReadCallbackR3 = pfnReadCallback;
1461 pRange->pfnWriteCallbackR3 = pfnWriteCallback;
1462 pRange->pfnFillCallbackR3 = pfnFillCallback;
1463
1464 //pRange->pvUserR0 = NIL_RTR0PTR;
1465 //pRange->pDevInsR0 = NIL_RTR0PTR;
1466 //pRange->pfnReadCallbackR0 = NIL_RTR0PTR;
1467 //pRange->pfnWriteCallbackR0 = NIL_RTR0PTR;
1468 //pRange->pfnFillCallbackR0 = NIL_RTR0PTR;
1469
1470 //pRange->pvUserRC = NIL_RTRCPTR;
1471 //pRange->pDevInsRC = NIL_RTRCPTR;
1472 //pRange->pfnReadCallbackRC = NIL_RTRCPTR;
1473 //pRange->pfnWriteCallbackRC = NIL_RTRCPTR;
1474 //pRange->pfnFillCallbackRC = NIL_RTRCPTR;
1475
1476 /*
1477 * Try register it with PGM and then insert it into the tree.
1478 */
1479 iomLock(pVM);
1480 iomR3FlushCache(pVM);
1481 rc = PGMR3PhysMMIORegister(pVM, GCPhysStart, cbRange,
1482 IOMR3MMIOHandler, pRange,
1483 pVM->iom.s.pfnMMIOHandlerR0, MMHyperR3ToR0(pVM, pRange),
1484 pVM->iom.s.pfnMMIOHandlerRC, MMHyperR3ToRC(pVM, pRange), pszDesc);
1485 if (RT_SUCCESS(rc))
1486 {
1487 if (RTAvlroGCPhysInsert(&pVM->iom.s.pTreesR3->MMIOTree, &pRange->Core))
1488 {
1489 iomUnlock(pVM);
1490 return VINF_SUCCESS;
1491 }
1492
1493 /* bail out */
1494 iomUnlock(pVM);
1495 DBGFR3Info(pVM, "mmio", NULL, NULL);
1496 AssertMsgFailed(("This cannot happen!\n"));
1497 rc = VERR_INTERNAL_ERROR;
1498 }
1499 else
1500 iomUnlock(pVM);
1501
1502 MMHyperFree(pVM, pRange);
1503 }
1504 if (pDevIns->iInstance > 0)
1505 MMR3HeapFree((void *)pszDesc);
1506 return rc;
1507}
1508
1509
1510/**
1511 * Registers a Memory Mapped I/O RC handler range.
1512 *
1513 * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges
1514 * using IOMMMIORegisterR3() before calling this function.
1515 *
1516 *
1517 * @returns VBox status code.
1518 *
1519 * @param pVM VM handle.
1520 * @param pDevIns PDM device instance owning the MMIO range.
1521 * @param GCPhysStart First physical address in the range.
1522 * @param cbRange The size of the range (in bytes).
1523 * @param pvUser User argument for the callbacks.
1524 * @param pfnWriteCallback Pointer to function which is gonna handle Write operations.
1525 * @param pfnReadCallback Pointer to function which is gonna handle Read operations.
1526 * @param pfnFillCallback Pointer to function which is gonna handle Fill/memset operations.
1527 */
1528VMMR3DECL(int) IOMR3MMIORegisterRC(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTGCPTR pvUser,
1529 RCPTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallback, RCPTRTYPE(PFNIOMMMIOREAD) pfnReadCallback,
1530 RCPTRTYPE(PFNIOMMMIOFILL) pfnFillCallback)
1531{
1532 LogFlow(("IOMR3MMIORegisterRC: pDevIns=%p GCPhysStart=%RGp cbRange=%#x pvUser=%RGv pfnWriteCallback=%#x pfnReadCallback=%#x pfnFillCallback=%#x\n",
1533 pDevIns, GCPhysStart, cbRange, pvUser, pfnWriteCallback, pfnReadCallback, pfnFillCallback));
1534
1535 /*
1536 * Validate input.
1537 */
1538 if (!pfnWriteCallback && !pfnReadCallback)
1539 {
1540 AssertMsgFailed(("No callbacks! %RGp LB%#x %s\n", GCPhysStart, cbRange));
1541 return VERR_INVALID_PARAMETER;
1542 }
1543
1544 /*
1545 * Find the MMIO range and check that the input matches.
1546 */
1547 iomLock(pVM);
1548 PIOMMMIORANGE pRange = iomMMIOGetRange(&pVM->iom.s, GCPhysStart);
1549 AssertReturnStmt(pRange, iomUnlock(pVM), VERR_IOM_MMIO_RANGE_NOT_FOUND);
1550 AssertReturnStmt(pRange->pDevInsR3 == pDevIns, iomUnlock(pVM), VERR_IOM_NOT_MMIO_RANGE_OWNER);
1551 AssertReturnStmt(pRange->GCPhys == GCPhysStart, iomUnlock(pVM), VERR_IOM_INVALID_MMIO_RANGE);
1552 AssertReturnStmt(pRange->cb == cbRange, iomUnlock(pVM), VERR_IOM_INVALID_MMIO_RANGE);
1553
1554 pRange->pvUserRC = pvUser;
1555 pRange->pfnReadCallbackRC = pfnReadCallback;
1556 pRange->pfnWriteCallbackRC= pfnWriteCallback;
1557 pRange->pfnFillCallbackRC = pfnFillCallback;
1558 pRange->pDevInsRC = MMHyperCCToRC(pVM, pDevIns);
1559 iomUnlock(pVM);
1560
1561 return VINF_SUCCESS;
1562}
1563
1564
1565/**
1566 * Registers a Memory Mapped I/O R0 handler range.
1567 *
1568 * This API is called by PDM on behalf of a device. Devices must first register ring-3 ranges
1569 * using IOMMR3MIORegisterHC() before calling this function.
1570 *
1571 *
1572 * @returns VBox status code.
1573 *
1574 * @param pVM VM handle.
1575 * @param pDevIns PDM device instance owning the MMIO range.
1576 * @param GCPhysStart First physical address in the range.
1577 * @param cbRange The size of the range (in bytes).
1578 * @param pvUser User argument for the callbacks.
1579 * @param pfnWriteCallback Pointer to function which is gonna handle Write operations.
1580 * @param pfnReadCallback Pointer to function which is gonna handle Read operations.
1581 * @param pfnFillCallback Pointer to function which is gonna handle Fill/memset operations.
1582 */
1583VMMR3DECL(int) IOMR3MMIORegisterR0(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTR0PTR pvUser,
1584 R0PTRTYPE(PFNIOMMMIOWRITE) pfnWriteCallback,
1585 R0PTRTYPE(PFNIOMMMIOREAD) pfnReadCallback,
1586 R0PTRTYPE(PFNIOMMMIOFILL) pfnFillCallback)
1587{
1588 LogFlow(("IOMR3MMIORegisterR0: pDevIns=%p GCPhysStart=%RGp cbRange=%#x pvUser=%RHv pfnWriteCallback=%#x pfnReadCallback=%#x pfnFillCallback=%#x\n",
1589 pDevIns, GCPhysStart, cbRange, pvUser, pfnWriteCallback, pfnReadCallback, pfnFillCallback));
1590
1591 /*
1592 * Validate input.
1593 */
1594 if (!pfnWriteCallback && !pfnReadCallback)
1595 {
1596 AssertMsgFailed(("No callbacks! %RGp LB%#x %s\n", GCPhysStart, cbRange));
1597 return VERR_INVALID_PARAMETER;
1598 }
1599
1600 /*
1601 * Find the MMIO range and check that the input matches.
1602 */
1603 iomLock(pVM);
1604 PIOMMMIORANGE pRange = iomMMIOGetRange(&pVM->iom.s, GCPhysStart);
1605 AssertReturnStmt(pRange, iomUnlock(pVM), VERR_IOM_MMIO_RANGE_NOT_FOUND);
1606 AssertReturnStmt(pRange->pDevInsR3 == pDevIns, iomUnlock(pVM), VERR_IOM_NOT_MMIO_RANGE_OWNER);
1607 AssertReturnStmt(pRange->GCPhys == GCPhysStart, iomUnlock(pVM), VERR_IOM_INVALID_MMIO_RANGE);
1608 AssertReturnStmt(pRange->cb == cbRange, iomUnlock(pVM), VERR_IOM_INVALID_MMIO_RANGE);
1609
1610 pRange->pvUserR0 = pvUser;
1611 pRange->pfnReadCallbackR0 = pfnReadCallback;
1612 pRange->pfnWriteCallbackR0= pfnWriteCallback;
1613 pRange->pfnFillCallbackR0 = pfnFillCallback;
1614 pRange->pDevInsR0 = MMHyperCCToR0(pVM, pDevIns);
1615 iomUnlock(pVM);
1616
1617 return VINF_SUCCESS;
1618}
1619
1620
1621/**
1622 * Deregisters a Memory Mapped I/O handler range.
1623 *
1624 * Registered GC, R0, and R3 ranges are affected.
1625 *
1626 * @returns VBox status code.
1627 *
1628 * @param pVM The virtual machine.
1629 * @param pDevIns Device instance which the MMIO region is registered.
1630 * @param GCPhysStart First physical address (GC) in the range.
1631 * @param cbRange Number of bytes to deregister.
1632 *
1633 * @remark This function mainly for PCI PnP Config and will not do
1634 * all the checks you might expect it to do.
1635 */
1636VMMR3DECL(int) IOMR3MMIODeregister(PVM pVM, PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange)
1637{
1638 LogFlow(("IOMR3MMIODeregister: pDevIns=%p GCPhysStart=%RGp cbRange=%#x\n", pDevIns, GCPhysStart, cbRange));
1639
1640 /*
1641 * Validate input.
1642 */
1643 RTGCPHYS GCPhysLast = GCPhysStart + (cbRange - 1);
1644 if (GCPhysLast < GCPhysStart)
1645 {
1646 AssertMsgFailed(("Wrapped! %#x LB%#x\n", GCPhysStart, cbRange));
1647 return VERR_IOM_INVALID_MMIO_RANGE;
1648 }
1649
1650 iomLock(pVM);
1651
1652 /*
1653 * Check ownership and such for the entire area.
1654 */
1655 RTGCPHYS GCPhys = GCPhysStart;
1656 while (GCPhys <= GCPhysLast && GCPhys >= GCPhysStart)
1657 {
1658 PIOMMMIORANGE pRange = iomMMIOGetRange(&pVM->iom.s, GCPhys);
1659 if (!pRange)
1660 {
1661 iomUnlock(pVM);
1662 return VERR_IOM_MMIO_RANGE_NOT_FOUND;
1663 }
1664 AssertMsgReturnStmt(pRange->pDevInsR3 == pDevIns,
1665 ("Not owner! GCPhys=%RGp %RGp LB%#x %s\n", GCPhys, GCPhysStart, cbRange, pRange->pszDesc),
1666 iomUnlock(pVM),
1667 VERR_IOM_NOT_MMIO_RANGE_OWNER);
1668 AssertMsgReturnStmt(pRange->Core.KeyLast <= GCPhysLast,
1669 ("Incomplete R3 range! GCPhys=%RGp %RGp LB%#x %s\n", GCPhys, GCPhysStart, cbRange, pRange->pszDesc),
1670 iomUnlock(pVM),
1671 VERR_IOM_INCOMPLETE_MMIO_RANGE);
1672
1673 /* next */
1674 Assert(GCPhys <= pRange->Core.KeyLast);
1675 GCPhys = pRange->Core.KeyLast + 1;
1676 }
1677
1678 /*
1679 * Do the actual removing of the MMIO ranges.
1680 */
1681 GCPhys = GCPhysStart;
1682 while (GCPhys <= GCPhysLast && GCPhys >= GCPhysStart)
1683 {
1684 iomR3FlushCache(pVM);
1685
1686 PIOMMMIORANGE pRange = (PIOMMMIORANGE)RTAvlroGCPhysRemove(&pVM->iom.s.pTreesR3->MMIOTree, GCPhys);
1687 Assert(pRange);
1688 Assert(pRange->Core.Key == GCPhys && pRange->Core.KeyLast <= GCPhysLast);
1689 iomUnlock(pVM);
1690
1691 /* remove it from PGM */
1692 int rc = PGMR3PhysMMIODeregister(pVM, GCPhys, pRange->cb);
1693 AssertRC(rc);
1694
1695 iomLock(pVM);
1696
1697 /* advance and free. */
1698 GCPhys = pRange->Core.KeyLast + 1;
1699 if (pDevIns->iInstance > 0)
1700 MMR3HeapFree((void *)pRange->pszDesc);
1701 MMHyperFree(pVM, pRange);
1702 }
1703
1704 iomUnlock(pVM);
1705 return VINF_SUCCESS;
1706}
1707
1708
1709/**
1710 * Release the IOM lock if owned by the current VCPU
1711 *
1712 * @param pVM The VM to operate on.
1713 */
1714VMMR3DECL(void) IOMR3ReleaseOwnedLocks(PVM pVM)
1715{
1716 while (PDMCritSectIsOwner(&pVM->iom.s.EmtLock))
1717 PDMCritSectLeave(&pVM->iom.s.EmtLock);
1718}
1719
1720
1721/**
1722 * For TM only!
1723 *
1724 * @returns Pointer to the critical section.
1725 * @param pVM The VM handle.
1726 */
1727VMMR3DECL(PPDMCRITSECT) IOMR3GetCritSect(PVM pVM)
1728{
1729 return &pVM->iom.s.EmtLock;
1730}
1731
1732
1733/**
1734 * Display a single MMIO range.
1735 *
1736 * @returns 0
1737 * @param pNode Pointer to MMIO R3 range.
1738 * @param pvUser Pointer to info output callback structure.
1739 */
1740static DECLCALLBACK(int) iomR3MMIOInfoOne(PAVLROGCPHYSNODECORE pNode, void *pvUser)
1741{
1742 PIOMMMIORANGE pRange = (PIOMMMIORANGE)pNode;
1743 PCDBGFINFOHLP pHlp = (PCDBGFINFOHLP)pvUser;
1744 pHlp->pfnPrintf(pHlp,
1745 "%RGp-%RGp %RHv %RHv %RHv %RHv %RHv %s\n",
1746 pRange->Core.Key,
1747 pRange->Core.KeyLast,
1748 pRange->pDevInsR3,
1749 pRange->pfnReadCallbackR3,
1750 pRange->pfnWriteCallbackR3,
1751 pRange->pfnFillCallbackR3,
1752 pRange->pvUserR3,
1753 pRange->pszDesc);
1754 pHlp->pfnPrintf(pHlp,
1755 "%*s %RHv %RHv %RHv %RHv %RHv\n",
1756 sizeof(RTGCPHYS) * 2 * 2 + 1, "R0",
1757 pRange->pDevInsR0,
1758 pRange->pfnReadCallbackR0,
1759 pRange->pfnWriteCallbackR0,
1760 pRange->pfnFillCallbackR0,
1761 pRange->pvUserR0);
1762 pHlp->pfnPrintf(pHlp,
1763 "%*s %RRv %RRv %RRv %RRv %RRv\n",
1764 sizeof(RTGCPHYS) * 2 * 2 + 1, "RC",
1765 pRange->pDevInsRC,
1766 pRange->pfnReadCallbackRC,
1767 pRange->pfnWriteCallbackRC,
1768 pRange->pfnFillCallbackRC,
1769 pRange->pvUserRC);
1770 return 0;
1771}
1772
1773
1774/**
1775 * Display registered MMIO ranges to the log.
1776 *
1777 * @param pVM VM Handle.
1778 * @param pHlp The info helpers.
1779 * @param pszArgs Arguments, ignored.
1780 */
1781static DECLCALLBACK(void) iomR3MMIOInfo(PVM pVM, PCDBGFINFOHLP pHlp, const char *pszArgs)
1782{
1783 NOREF(pszArgs);
1784 pHlp->pfnPrintf(pHlp,
1785 "MMIO ranges (pVM=%p)\n"
1786 "%.*s %.*s %.*s %.*s %.*s %.*s %s\n",
1787 pVM,
1788 sizeof(RTGCPHYS) * 4 + 1, "GC Phys Range ",
1789 sizeof(RTHCPTR) * 2, "pDevIns ",
1790 sizeof(RTHCPTR) * 2, "Read ",
1791 sizeof(RTHCPTR) * 2, "Write ",
1792 sizeof(RTHCPTR) * 2, "Fill ",
1793 sizeof(RTHCPTR) * 2, "pvUser ",
1794 "Description");
1795 RTAvlroGCPhysDoWithAll(&pVM->iom.s.pTreesR3->MMIOTree, true, iomR3MMIOInfoOne, (void *)pHlp);
1796}
1797
1798
1799#ifdef VBOX_WITH_STATISTICS
1800/**
1801 * Tries to come up with the standard name for a port.
1802 *
1803 * @returns Pointer to readonly string if known.
1804 * @returns NULL if unknown port number.
1805 *
1806 * @param Port The port to name.
1807 */
1808static const char *iomR3IOPortGetStandardName(RTIOPORT Port)
1809{
1810 switch (Port)
1811 {
1812 case 0x00: case 0x10: case 0x20: case 0x30: case 0x40: case 0x50: case 0x70:
1813 case 0x01: case 0x11: case 0x21: case 0x31: case 0x41: case 0x51: case 0x61: case 0x71:
1814 case 0x02: case 0x12: case 0x22: case 0x32: case 0x42: case 0x52: case 0x62: case 0x72:
1815 case 0x03: case 0x13: case 0x23: case 0x33: case 0x43: case 0x53: case 0x63: case 0x73:
1816 case 0x04: case 0x14: case 0x24: case 0x34: case 0x44: case 0x54: case 0x74:
1817 case 0x05: case 0x15: case 0x25: case 0x35: case 0x45: case 0x55: case 0x65: case 0x75:
1818 case 0x06: case 0x16: case 0x26: case 0x36: case 0x46: case 0x56: case 0x66: case 0x76:
1819 case 0x07: case 0x17: case 0x27: case 0x37: case 0x47: case 0x57: case 0x67: case 0x77:
1820 case 0x08: case 0x18: case 0x28: case 0x38: case 0x48: case 0x58: case 0x68: case 0x78:
1821 case 0x09: case 0x19: case 0x29: case 0x39: case 0x49: case 0x59: case 0x69: case 0x79:
1822 case 0x0a: case 0x1a: case 0x2a: case 0x3a: case 0x4a: case 0x5a: case 0x6a: case 0x7a:
1823 case 0x0b: case 0x1b: case 0x2b: case 0x3b: case 0x4b: case 0x5b: case 0x6b: case 0x7b:
1824 case 0x0c: case 0x1c: case 0x2c: case 0x3c: case 0x4c: case 0x5c: case 0x6c: case 0x7c:
1825 case 0x0d: case 0x1d: case 0x2d: case 0x3d: case 0x4d: case 0x5d: case 0x6d: case 0x7d:
1826 case 0x0e: case 0x1e: case 0x2e: case 0x3e: case 0x4e: case 0x5e: case 0x6e: case 0x7e:
1827 case 0x0f: case 0x1f: case 0x2f: case 0x3f: case 0x4f: case 0x5f: case 0x6f: case 0x7f:
1828
1829 case 0x80: case 0x90: case 0xa0: case 0xb0: case 0xc0: case 0xd0: case 0xe0: case 0xf0:
1830 case 0x81: case 0x91: case 0xa1: case 0xb1: case 0xc1: case 0xd1: case 0xe1: case 0xf1:
1831 case 0x82: case 0x92: case 0xa2: case 0xb2: case 0xc2: case 0xd2: case 0xe2: case 0xf2:
1832 case 0x83: case 0x93: case 0xa3: case 0xb3: case 0xc3: case 0xd3: case 0xe3: case 0xf3:
1833 case 0x84: case 0x94: case 0xa4: case 0xb4: case 0xc4: case 0xd4: case 0xe4: case 0xf4:
1834 case 0x85: case 0x95: case 0xa5: case 0xb5: case 0xc5: case 0xd5: case 0xe5: case 0xf5:
1835 case 0x86: case 0x96: case 0xa6: case 0xb6: case 0xc6: case 0xd6: case 0xe6: case 0xf6:
1836 case 0x87: case 0x97: case 0xa7: case 0xb7: case 0xc7: case 0xd7: case 0xe7: case 0xf7:
1837 case 0x88: case 0x98: case 0xa8: case 0xb8: case 0xc8: case 0xd8: case 0xe8: case 0xf8:
1838 case 0x89: case 0x99: case 0xa9: case 0xb9: case 0xc9: case 0xd9: case 0xe9: case 0xf9:
1839 case 0x8a: case 0x9a: case 0xaa: case 0xba: case 0xca: case 0xda: case 0xea: case 0xfa:
1840 case 0x8b: case 0x9b: case 0xab: case 0xbb: case 0xcb: case 0xdb: case 0xeb: case 0xfb:
1841 case 0x8c: case 0x9c: case 0xac: case 0xbc: case 0xcc: case 0xdc: case 0xec: case 0xfc:
1842 case 0x8d: case 0x9d: case 0xad: case 0xbd: case 0xcd: case 0xdd: case 0xed: case 0xfd:
1843 case 0x8e: case 0x9e: case 0xae: case 0xbe: case 0xce: case 0xde: case 0xee: case 0xfe:
1844 case 0x8f: case 0x9f: case 0xaf: case 0xbf: case 0xcf: case 0xdf: case 0xef: case 0xff:
1845 return "System Reserved";
1846
1847 case 0x60:
1848 case 0x64:
1849 return "Keyboard & Mouse";
1850
1851 case 0x378:
1852 case 0x379:
1853 case 0x37a:
1854 case 0x37b:
1855 case 0x37c:
1856 case 0x37d:
1857 case 0x37e:
1858 case 0x37f:
1859 case 0x3bc:
1860 case 0x3bd:
1861 case 0x3be:
1862 case 0x3bf:
1863 case 0x278:
1864 case 0x279:
1865 case 0x27a:
1866 case 0x27b:
1867 case 0x27c:
1868 case 0x27d:
1869 case 0x27e:
1870 case 0x27f:
1871 return "LPT1/2/3";
1872
1873 case 0x3f8:
1874 case 0x3f9:
1875 case 0x3fa:
1876 case 0x3fb:
1877 case 0x3fc:
1878 case 0x3fd:
1879 case 0x3fe:
1880 case 0x3ff:
1881 return "COM1";
1882
1883 case 0x2f8:
1884 case 0x2f9:
1885 case 0x2fa:
1886 case 0x2fb:
1887 case 0x2fc:
1888 case 0x2fd:
1889 case 0x2fe:
1890 case 0x2ff:
1891 return "COM2";
1892
1893 case 0x3e8:
1894 case 0x3e9:
1895 case 0x3ea:
1896 case 0x3eb:
1897 case 0x3ec:
1898 case 0x3ed:
1899 case 0x3ee:
1900 case 0x3ef:
1901 return "COM3";
1902
1903 case 0x2e8:
1904 case 0x2e9:
1905 case 0x2ea:
1906 case 0x2eb:
1907 case 0x2ec:
1908 case 0x2ed:
1909 case 0x2ee:
1910 case 0x2ef:
1911 return "COM4";
1912
1913 case 0x200:
1914 case 0x201:
1915 case 0x202:
1916 case 0x203:
1917 case 0x204:
1918 case 0x205:
1919 case 0x206:
1920 case 0x207:
1921 return "Joystick";
1922
1923 case 0x3f0:
1924 case 0x3f1:
1925 case 0x3f2:
1926 case 0x3f3:
1927 case 0x3f4:
1928 case 0x3f5:
1929 case 0x3f6:
1930 case 0x3f7:
1931 return "Floppy";
1932
1933 case 0x1f0:
1934 case 0x1f1:
1935 case 0x1f2:
1936 case 0x1f3:
1937 case 0x1f4:
1938 case 0x1f5:
1939 case 0x1f6:
1940 case 0x1f7:
1941 //case 0x3f6:
1942 //case 0x3f7:
1943 return "IDE 1st";
1944
1945 case 0x170:
1946 case 0x171:
1947 case 0x172:
1948 case 0x173:
1949 case 0x174:
1950 case 0x175:
1951 case 0x176:
1952 case 0x177:
1953 case 0x376:
1954 case 0x377:
1955 return "IDE 2nd";
1956
1957 case 0x1e0:
1958 case 0x1e1:
1959 case 0x1e2:
1960 case 0x1e3:
1961 case 0x1e4:
1962 case 0x1e5:
1963 case 0x1e6:
1964 case 0x1e7:
1965 case 0x3e6:
1966 case 0x3e7:
1967 return "IDE 3rd";
1968
1969 case 0x160:
1970 case 0x161:
1971 case 0x162:
1972 case 0x163:
1973 case 0x164:
1974 case 0x165:
1975 case 0x166:
1976 case 0x167:
1977 case 0x366:
1978 case 0x367:
1979 return "IDE 4th";
1980
1981 case 0x130: case 0x140: case 0x150:
1982 case 0x131: case 0x141: case 0x151:
1983 case 0x132: case 0x142: case 0x152:
1984 case 0x133: case 0x143: case 0x153:
1985 case 0x134: case 0x144: case 0x154:
1986 case 0x135: case 0x145: case 0x155:
1987 case 0x136: case 0x146: case 0x156:
1988 case 0x137: case 0x147: case 0x157:
1989 case 0x138: case 0x148: case 0x158:
1990 case 0x139: case 0x149: case 0x159:
1991 case 0x13a: case 0x14a: case 0x15a:
1992 case 0x13b: case 0x14b: case 0x15b:
1993 case 0x13c: case 0x14c: case 0x15c:
1994 case 0x13d: case 0x14d: case 0x15d:
1995 case 0x13e: case 0x14e: case 0x15e:
1996 case 0x13f: case 0x14f: case 0x15f:
1997 case 0x220: case 0x230:
1998 case 0x221: case 0x231:
1999 case 0x222: case 0x232:
2000 case 0x223: case 0x233:
2001 case 0x224: case 0x234:
2002 case 0x225: case 0x235:
2003 case 0x226: case 0x236:
2004 case 0x227: case 0x237:
2005 case 0x228: case 0x238:
2006 case 0x229: case 0x239:
2007 case 0x22a: case 0x23a:
2008 case 0x22b: case 0x23b:
2009 case 0x22c: case 0x23c:
2010 case 0x22d: case 0x23d:
2011 case 0x22e: case 0x23e:
2012 case 0x22f: case 0x23f:
2013 case 0x330: case 0x340: case 0x350:
2014 case 0x331: case 0x341: case 0x351:
2015 case 0x332: case 0x342: case 0x352:
2016 case 0x333: case 0x343: case 0x353:
2017 case 0x334: case 0x344: case 0x354:
2018 case 0x335: case 0x345: case 0x355:
2019 case 0x336: case 0x346: case 0x356:
2020 case 0x337: case 0x347: case 0x357:
2021 case 0x338: case 0x348: case 0x358:
2022 case 0x339: case 0x349: case 0x359:
2023 case 0x33a: case 0x34a: case 0x35a:
2024 case 0x33b: case 0x34b: case 0x35b:
2025 case 0x33c: case 0x34c: case 0x35c:
2026 case 0x33d: case 0x34d: case 0x35d:
2027 case 0x33e: case 0x34e: case 0x35e:
2028 case 0x33f: case 0x34f: case 0x35f:
2029 return "SCSI (typically)";
2030
2031 case 0x320:
2032 case 0x321:
2033 case 0x322:
2034 case 0x323:
2035 case 0x324:
2036 case 0x325:
2037 case 0x326:
2038 case 0x327:
2039 return "XT HD";
2040
2041 case 0x3b0:
2042 case 0x3b1:
2043 case 0x3b2:
2044 case 0x3b3:
2045 case 0x3b4:
2046 case 0x3b5:
2047 case 0x3b6:
2048 case 0x3b7:
2049 case 0x3b8:
2050 case 0x3b9:
2051 case 0x3ba:
2052 case 0x3bb:
2053 return "VGA";
2054
2055 case 0x3c0: case 0x3d0:
2056 case 0x3c1: case 0x3d1:
2057 case 0x3c2: case 0x3d2:
2058 case 0x3c3: case 0x3d3:
2059 case 0x3c4: case 0x3d4:
2060 case 0x3c5: case 0x3d5:
2061 case 0x3c6: case 0x3d6:
2062 case 0x3c7: case 0x3d7:
2063 case 0x3c8: case 0x3d8:
2064 case 0x3c9: case 0x3d9:
2065 case 0x3ca: case 0x3da:
2066 case 0x3cb: case 0x3db:
2067 case 0x3cc: case 0x3dc:
2068 case 0x3cd: case 0x3dd:
2069 case 0x3ce: case 0x3de:
2070 case 0x3cf: case 0x3df:
2071 return "VGA/EGA";
2072
2073 case 0x240: case 0x260: case 0x280:
2074 case 0x241: case 0x261: case 0x281:
2075 case 0x242: case 0x262: case 0x282:
2076 case 0x243: case 0x263: case 0x283:
2077 case 0x244: case 0x264: case 0x284:
2078 case 0x245: case 0x265: case 0x285:
2079 case 0x246: case 0x266: case 0x286:
2080 case 0x247: case 0x267: case 0x287:
2081 case 0x248: case 0x268: case 0x288:
2082 case 0x249: case 0x269: case 0x289:
2083 case 0x24a: case 0x26a: case 0x28a:
2084 case 0x24b: case 0x26b: case 0x28b:
2085 case 0x24c: case 0x26c: case 0x28c:
2086 case 0x24d: case 0x26d: case 0x28d:
2087 case 0x24e: case 0x26e: case 0x28e:
2088 case 0x24f: case 0x26f: case 0x28f:
2089 case 0x300:
2090 case 0x301:
2091 case 0x388:
2092 case 0x389:
2093 case 0x38a:
2094 case 0x38b:
2095 return "Sound Card (typically)";
2096
2097 default:
2098 return NULL;
2099 }
2100}
2101#endif /* VBOX_WITH_STATISTICS */
2102
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