nxdk-pgraph-test-runner
Table of Contents
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 thenxdk_pgraph_tests.isoxiso 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.
1 maintainer
Metadata
1 maintainer
Release files for nxdk-pgraph-test-runner 0.1.27
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nxdk_pgraph_test_runner-0.1.27.tar.gz | 19.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nxdk_pgraph_test_runner-0.1.27-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 40.8 kB
Release files / nxdk_pgraph_test_runner-0.1.27.tar.gz
| Download URL | nxdk_pgraph_test_runner-0.1.27.tar.gz |
|---|---|
| Size | 19.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9d70241c1c4d99932990726f1ed918dfae6b67aef0822e8f6232bdfb08b0436a
|
|
BLAKE2b-256 checksum How to use checksums |
604d95016c479c3e71d3ae92e21a5f98f91d7dc606cce22791507f02b89a6a10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / nxdk_pgraph_test_runner-0.1.27-py3-none-any.whl
| Download URL | nxdk_pgraph_test_runner-0.1.27-py3-none-any.whl |
|---|---|
| Size | 21.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
87f90371d8bce19e93ff717b81025e22baae610eccbd2a8d4308f9995d02230b
|
|
BLAKE2b-256 checksum How to use checksums |
d8663e92dd00f74e15c2a14f37bcde1dfcc8e80d90a3275f492b500ee961b6da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
