Welcome, XQEMU Developers!

Community

Potential XQEMU developers are encouraged to join the XboxDev community, which focuses on research & development for the original Xbox. General discussion happens on the XboxDev Discord Server.

XQEMU Development Chat: The project has a dedicated development-centric IRC channel at #xqemu on irc.libera.chat

Repository Info

This project is hosted on GitHub at github.com/xqemu/xqemu.

Build Status

Platform Build Status
Windows Build status
macOS Build status
Ubuntu Build status

Building From Source Code

For directions on how to build XQEMU from source, please refer to this page.

Debugging Guest Code

  • QEMU can host a gdb stub! Launch with -s -S, and with gdb run target remote localhost:1234
    • Protip: You can also attach to it with IDA if you're so inclined. You can then load in a database if you export it as a IDC script!
  • XQEMU can emulate a XDK serial port (which with a debug bios hosts KD, as in this and this)! Launch with something like -device lpc47m157 -serial unix:/tmp/xserial,server. With some effort you can wrestle the unix socket into a vm for with WinDbg. There's also a very barebones perl KD client in scripts/windpl
  • apitrace is useful for tracking down rendering bugs.

Debugging XQEMU Itself

Depending on the task at hand, it may be necessary to debug XQEMU itself.

Windows

The Visual Studio Code IDE can be used to launch and debug XQEMU. A sample launch.vs.json file which can be used to launch XQEMU from code can be found here.

macOS

Using Xcode

Create a project, edit the "Scheme" to run the xqemu binary, then click the run button. Xcode has a nice GUI for analyzing the stack frame and looking at local variables to quickly track down bugs. You can also attach to running processes.

Linux

GDB works of course. Eclipse can also be used for those wanting a graphical source-level debugging solution.

Debug BIOS

People have reported success with the 'COMPLEX 4627' modified debug bios. It's convenient to note that this bios does not necessarily require a populated hard disk image to load an application from DVD (though an empty drive still needs to be attached), so you can skip the next step in some cases.

v1.0.2 1M dump: MD5 (Complex_4627Debug.bin) = 19b5c6d3d42a707bba620634fe6d4baf

or sometimes

1MB dump: MD5 (complex_4627debug.bin) = e8dd61cc6abdbd06aac185e371312dc1