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

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.23
File Size Uploaded
nxdk_pgraph_test_runner-0.1.23.tar.gz 18.5 kB Details

Built distribution (wheel)

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

Total release size: 39.2 kB

Release files / nxdk_pgraph_test_runner-0.1.23.tar.gz

Download URL nxdk_pgraph_test_runner-0.1.23.tar.gz
Size 18.5 kB
Tags Source
SHA-256 checksum
How to use checksums
52bd896e7ae4344687af38ecd6d374da77fb8ed4523c52950fb25563f4de811d
BLAKE2b-256 checksum
How to use checksums
fc21926b617fac81a465f931a12ee3a029c2a1811047eaa9a4a5ab99b5affd9b
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.23-py3-none-any.whl

Download URL nxdk_pgraph_test_runner-0.1.23-py3-none-any.whl
Size 20.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c045f129a3c7fb2fcb963e237affe58c4ab175b3e6f8a836cdc4da46972a4356
BLAKE2b-256 checksum
How to use checksums
9ee4a918eb315beab2740278ce50d2072bb872cf21de4228236f9da59afc95dd
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