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

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.25
File Size Uploaded
nxdk_pgraph_test_runner-0.1.25.tar.gz 19.1 kB Details

Built distribution (wheel)

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

Total release size: 40.4 kB

Release files / nxdk_pgraph_test_runner-0.1.25.tar.gz

Download URL nxdk_pgraph_test_runner-0.1.25.tar.gz
Size 19.1 kB
Tags Source
SHA-256 checksum
How to use checksums
2ce0600843615ef34854574df7fc2097c7a1a5a818c9a906e2908b146cf62123
BLAKE2b-256 checksum
How to use checksums
37a8be0079826c1e1a3c4026ccc134b18e524b26517a011e7821ae789c768502
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.25-py3-none-any.whl

Download URL nxdk_pgraph_test_runner-0.1.25-py3-none-any.whl
Size 21.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6cb3e6c527a665bff2efb546c6186e3211caf81cd096f793281c396c6854edad
BLAKE2b-256 checksum
How to use checksums
6c0b696c66c9e4c93ae432b95afc9d99f8ae1e9211139eec6592c4099d09a67e
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