Skip to content

RustyN64 v0.4.1

Choose a tag to compare

@github-actions github-actions released this 24 Jul 01:54
31b7185

v0.4.1 — Phase-3-close documentation reconciliation

A documentation-only patch over v0.4.0 "Rasteriser". No code changed; the emulator
behaves byte-identically to v0.4.0. This release exists to reconcile the planning and
status documents with the reality that Phase 3 (the LLE RDP + VI) shipped in v0.4.0 —
the phase-close documentation pass had been skipped, so several docs still described a
pre-v0.4.0 world.

What changed

  • docs/STATUS.md: the RDP is no longer described as a stub (the chip-crate skeleton
    line, the DPC-registers row, and the "RDP LLE" roadmap row now record the working
    rasteriser); the release-infrastructure lines record v0.1.0-v0.4.1 as tagged and
    released instead of "no tag has been cut".
  • README.md: the Compatibility & Accuracy table adds the two passing Phase 3 gates
    (RDP conformance vs Angrylion across 164 vectors, and the real-ROM golden frame) and
    reclassifies real-game visual goldens to Phase 7; the Performance rationale, the
    "Current Release" next-rung (now v0.5.0), and the Roadmap phase list (Phases 0-3
    complete, Phase 4 next) are corrected; version badge and bibtex bumped.
  • to-dos/ROADMAP.md: the phase matrix marks Phase 2 (v0.3.0) and Phase 3 (v0.4.0)
    COMPLETE, the Status block advances to Phase 4, and the v1.0.0 milestone records the
    tags cut so far. v0.4.1 is noted as a documentation-only patch (no new scope).
  • to-dos/VERSION-PLAN.md, docs/rdp.md, docs/architecture.md: the RDP / rasteriser /
    RDP tick methods are marked implemented rather than stubbed.
  • Phase 0-3 plan files: completion banners added; Phase 2's nine met exit criteria and
    the Sprint 1/Sprint 4 checklists checked off (the SU/VU dual-issue timing box stays an
    honest, ledgered deferral); Phase 0's golden-trace and release-tag boxes marked
    resolved and the superseded ADR 0001 3:2-clock criterion annotated; Phase 3's exit
    criteria and Sprint 3 review checklist reconciled with their R-9/R-10/R-11 residuals.

Known limitations (unchanged from v0.4.0)

  • AI audio (Phase 4) and cartridge boot / saves (Phase 5) are not implemented; the
    rustyn64 binary opens a shell and presents a test pattern. A green cargo test does
    not mean a subsystem works — see docs/STATUS.md.
  • RDP residuals carried to Phase 7: attribute interpolation (R-9), exotic combiner
    inputs (R-10), and the coverage / AA / alpha-compare / dither paths (R-11).

Verification

No behavioural gates changed. All accuracy oracles remain as of v0.4.0: n64-systemtest
Failed: 0 on CPU/COP0/TLB/COP1 and RSP; the CPU golden-log 0-diff against ares; the RDP
conformance suite bit-matching Angrylion across 164 committed vectors; and the real-ROM
golden frame (T-33-006). CI green across the full release matrix (ubuntu/macOS/windows +
test-roms), rustdoc (-D warnings), the no_std cross-build, the commercial-ROM guard, and
markdownlint.

Install: download the per-target archive, verify against SHA256SUMS, and extract. Each
archive carries both licences (MIT OR Apache-2.0), NOTICE, README, and CHANGELOG.