Skip to main content

nxdk-pgraph-test-runner

PyPI - Version PyPI - Python Version


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 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.

Metadata

Release files for nxdk-pgraph-test-runner 0.1.26

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nxdk-pgraph-test-runner 0.1.26
File Size Uploaded
nxdk_pgraph_test_runner-0.1.26.tar.gz 19.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for nxdk-pgraph-test-runner 0.1.26
File Interpreter ABI Platform
nxdk_pgraph_test_runner-0.1.26-py3-none-any.whl Python 3 none any Details

Total release size: 40.7 kB

Release files / nxdk_pgraph_test_runner-0.1.26.tar.gz

Download URL nxdk_pgraph_test_runner-0.1.26.tar.gz
Size 19.3 kB
Tags Source
SHA-256 checksum
How to use checksums
dc1f2741d62b288c5307f21c49df2a4d3f5bdb631bd32fed6a09bb2374cfdf2a
BLAKE2b-256 checksum
How to use checksums
b3af33239f50b8eaf431f30a96791db2c28744ff5d3ab310c2905b878751da53
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.26-py3-none-any.whl

Download URL nxdk_pgraph_test_runner-0.1.26-py3-none-any.whl
Size 21.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1949765f6db0c2d3881ce2bb141d1861c8eee852d015f9d5a257f6d74166c8f4
BLAKE2b-256 checksum
How to use checksums
d9608ad34f16ff1b8a8210cd91fdca6bf95af4bf61d7d89bc5dad3e9ce0a9cce
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page