xbox kernel test suite

Xbox kernel APIs tester written using the open-source nxdk.

This is a tool for testing the xbox kernel APIs on the hardware to verify their workings. In addition, we have a dedicated wiki page for homebrew kernels that have used this tool to test their kernel implementation.

HOW TO BUILD:

All you need is nxdk. You can get it here: https://github.com/XboxDev/nxdk

Here is a setup guide: https://github.com/XboxDev/nxdk/wiki/Getting-Started

CONFIGURATION FILE:

[!NOTE] The configuration file should be called "config.txt" and should be placed in the same directory of the xbe.

The following list of options can be used inside the config.txt file:

seed = <decimal (support up to 4294967295)>
tests = <decimal (support up to 378) or case insensitive API name>[,...]
tests-exclude = <decimal (support up to 378) or case insensitive API name>[,...]
disable-video = <boolean>[^1]

[^1]: boolean value can be 1 or 0

[!TIP] This is an example of config.txt:
seed=5

tests=1,25,3,NtReadFile

NAME FILE:

[!NOTE] The name file should be called "name.txt" and should be placed in the same directory of the xbe.

Having a name file can help generate individual log files for different hardware and emulators to collect results in the same folder without the need to rename log files every time.

[!TIP] This is an example of name.txt:
retail 1.6

BINARIES:

You can download pre-built bins from here: https://github.com/Cxbx-Reloaded/xbox_kernel_test_suite/releases

USEFUL LINKS:

TODO:

Complete the test suite with all xbox kernel APIs (fill in the FIXME stubs).
Check the opened issues for any issues or tasks.

ANY HELP IS REALLY WELCOME!

Cxbx-Reloaded / xbox_kernel_test_suite

readme