nxdk-pgraph-test-runner 0.1.20

Executes and captures the results of https://github.com/abaire/nxdk_pgraph_tests in an emulator

nxdk-pgraph-test-runner

---

Table of Contents

• Installation
• Configuration
• License

Purpose

This test harness utilizes the nxdk_pgraph_tests project to exercise the NV2A 3D accelerator on the original Microsoft Xbox. The runner is intended to be used with an emulator (e.g., xemu) and is able to detect and recover from crashes.

Installation

Prerequisites

• An xbox emulator (e.g., xemu) - required

pip installation

# Optionally create a virtual env
#   pip -m venv .venv
#   source .venv/bin/activate

pip install nxdk-pgraph-test-runner

nxdk-pgraph-test-runner --help

Configuration

A default config may be generated by running the nxdk-pgraph-test-runner command.

Emulator command line

"emulator_command = /path/to/emulator {ISO}"

The command may utilize the following macros:

• {ISO} - Replaced with the path to the nxdk_pgraph_tests.iso xiso file.

Example invocation

This is a sample invocation that will run xemu against a previously downloaded nxdk_pgraph_tests iso. It will create a results directory with the results of the tests.

nxdk-pgraph-test-runner \
    --override-ftp-ip 10.0.2.2 \
    --iso-path ~/nxdk_pgraph_tests_xiso.iso \
    --emulator-command "/path/to/xemu -dvd_path \"{ISO}\"" \
    -I lo0

This assumes that xemu is configured to use NAT networking, so the IP reported to the pgraph tester is set to the qemu 10.0.2.2 host address and the loopback interface (-I lo0) is used.

License

nxdk-pgraph-test-runner is distributed under the terms of the MIT license.