Files
TeslaRel410/context/README.md
T
CydandClaude Fable 5 c26d7baf8d docs: published team credits + archive context index
README gains "The team" -- the published VWE BattleTech credits roster
(scan supplied July 2026) cross-referenced against the 1994-96 source in
this tree; HISTORY.md links the podbay developer-script names to the
credited team members.  context/ adds the archive index README and its
generator script.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-24 12:02:49 -05:00

126 lines
11 KiB
Markdown

# Context index — all project documentation
A single map of every hand-written `.md` in this repo, grouped by area with a
one-line description and a link. Use it to find the right note without grepping.
> **Scope:** project-authored docs only. ~70 vendored/third-party READMEs (the
> DOSBox-X fork under [`emulator/src/`](../emulator/src/), SDL2, libpng,
> libpdcurses, freetype) are intentionally omitted — they document upstream
> libraries, not this project.
> **Keeping this current:** the linked list below is generated. Run
> `context/gen-index.sh` to check for drift (new/removed docs) and
> `context/gen-index.sh --write` to regenerate it. Hand-written descriptions are
> preserved across regenerations; only the block between the AUTOGEN markers is
> touched, so edit descriptions freely — just keep them inside that block.
---
<!-- BEGIN AUTOGEN (context/gen-index.sh) -->
## Orientation
- [HISTORY.md](../HISTORY.md) — provenance of the recovered developer drive ("Glaze"/`sda4`) that sits alongside the release tree.
- [README.md](../README.md) — repo overview: source + content for Tesla:BattleTech and Tesla:Red Planet (Release 4.10).
## Emulator — plan, phases & operations
- [emulator/ENV-VARS.md](../emulator/ENV-VARS.md) — environment variables for both the pod (game) and host (emulator).
- [emulator/LAUNCH.md](../emulator/LAUNCH.md) — pod launch cheat-sheet (all commands, non-elevated PowerShell).
- [emulator/PHASE0-RESULTS.md](../emulator/PHASE0-RESULTS.md) — Phase 0: baseline DOS boot test (complete).
- [emulator/PHASE1-RESULTS.md](../emulator/PHASE1-RESULTS.md) — Phase 1: interface discovery via a VPX link-adapter logging build (complete).
- [emulator/PHASE2-PROGRESS.md](../emulator/PHASE2-PROGRESS.md) — Phase 2: boot-protocol emulation — handshake, i860 download, FIFO transport.
- [emulator/PHASE3-PROGRESS.md](../emulator/PHASE3-PROGRESS.md) — Phase 3: render backend (3a/3b/3c command decode + bridge).
- [emulator/PLAN.md](../emulator/PLAN.md) — master implementation plan for running unported DOS BattleTech/Red Planet under VPX emulation.
## Emulator — subsystems
- [emulator/CAMERA-REVIEW-NOTES.md](../emulator/CAMERA-REVIEW-NOTES.md) — how the games did Live Cam & Mission Review (spool replay, host roles).
- [emulator/GAUGE-NOTES.md](../emulator/GAUGE-NOTES.md) — the cockpit gauge / secondary-display path (5 mono MFDs + color radar).
- [emulator/NET-NOTES.md](../emulator/NET-NOTES.md) — networking subsystem recon & bring-up plan for pod boot/mesh.
- [emulator/RENDER-HARNESS.md](../emulator/RENDER-HARNESS.md) — FLYK + the VWETEST diagnostic suite as a render harness.
- [emulator/RENDERER-COLLAB.md](../emulator/RENDERER-COLLAB.md) — shared working log for the two renderer efforts (VPX/Division backend).
- [emulator/RIO-NOTES.md](../emulator/RIO-NOTES.md) — RIO cockpit-controls passthrough tuning (COM1 input board).
- [emulator/SOUND-NOTES.md](../emulator/SOUND-NOTES.md) — audio subsystem recon & plan (AWE32/SOS clock, faithful bring-up).
- [emulator/VDB-NOTES.md](../emulator/VDB-NOTES.md) — the VWE Video Distribution Board: one framebuffer → six cockpit displays.
## Emulator — deployment & ports
- [emulator/DEPLOYMENT-PLAN.md](../emulator/DEPLOYMENT-PLAN.md) — network-agnostic pod-bay deployment (pcap bridge, two-IP design, mesh).
- [emulator/EGRESS-HOLD-FIX-PLAN.md](../emulator/EGRESS-HOLD-FIX-PLAN.md) — egress-hold / floor-lighting investigation (CLOSED, won't-fix; findings kept).
- [emulator/XP-PORT-PLAN.md](../emulator/XP-PORT-PLAN.md) — one archive from Windows XP → Windows 11 (back-burnered fleet plan).
## Emulator — devices & support files
- [emulator/deploy/README.md](../emulator/deploy/README.md) — install-side artifacts for the self-contained, air-gapped pod install.
- [emulator/net-boot/README.md](../emulator/net-boot/README.md) — files the pod mounts as `D:` when booting the networked path.
- [emulator/pod-launch/README.md](../emulator/pod-launch/README.md) — the supervising launch entry-point for both DOSBox titles.
- [emulator/rio-firmware/README.md](../emulator/rio-firmware/README.md) — RIO cockpit I/O board firmware dump (v4.2).
- [emulator/rio-firmware/RIOv4_2-ANALYSIS.md](../emulator/rio-firmware/RIOv4_2-ANALYSIS.md) — RIO v4.2 firmware RE: the protocol-wedge analysis.
- [emulator/roms/README.md](../emulator/roms/README.md) — card ROM dumps (AWE32 1MGM sample ROM, etc.).
- [emulator/vpx-device/README.md](../emulator/vpx-device/README.md) — VPX + AWE32 emulated-hardware sources for the DOSBox-X integration.
- [emulator/vpx-device/serialport/README.md](../emulator/vpx-device/serialport/README.md) — modified DOSBox-X serial passthrough (RIO latency options).
## Emulator — VelociRender firmware decompilation
- [emulator/firmware-decomp/FPGA-RECONSTRUCTION.md](../emulator/firmware-decomp/FPGA-RECONSTRUCTION.md) — reconstructing the VelociRender in hardware (FPGA design note).
- [emulator/firmware-decomp/GPU-RETARGET.md](../emulator/firmware-decomp/GPU-RETARGET.md) — GPU-compute retarget: the DOSBox-renderer shipping path.
- [emulator/firmware-decomp/HARDWARE-ARCHITECTURE.md](../emulator/firmware-decomp/HARDWARE-ARCHITECTURE.md) — the card's hardware architecture, reconstructed for emulation (+ photo inventory).
- [emulator/firmware-decomp/IG-SHADING-MODEL.md](../emulator/firmware-decomp/IG-SHADING-MODEL.md) — the IG-board shading model, ground truth distilled from shipped libDPL.
- [emulator/firmware-decomp/IGC-ENCODING-DERIVATION.md](../emulator/firmware-decomp/IGC-ENCODING-DERIVATION.md) — IGC instruction-word encoding derived from EOF.C ↔ EOF.S (Tier-1 decoder).
- [emulator/firmware-decomp/M4-LIVE-SEAM.md](../emulator/firmware-decomp/M4-LIVE-SEAM.md) — M4: the live DOSBox seam design note.
- [emulator/firmware-decomp/M4B-RESULTS.md](../emulator/firmware-decomp/M4B-RESULTS.md) — M4b: offline end-to-end renderer-chain results.
- [emulator/firmware-decomp/M5-TEXTURING.md](../emulator/firmware-decomp/M5-TEXTURING.md) — M5: faithful texturing, the last mile to recognizable frames.
- [emulator/firmware-decomp/MICROCODE-DECODE-NOTES.md](../emulator/firmware-decomp/MICROCODE-DECODE-NOTES.md) — PXPL5 IGC micro-code decode working notes (ground/sky path).
- [emulator/firmware-decomp/PVISION-IMPLEMENTATION-GUIDE.md](../emulator/firmware-decomp/PVISION-IMPLEMENTATION-GUIDE.md) — implementing IR / "Predator" vision in a VelociRender renderer.
- [emulator/firmware-decomp/README.md](../emulator/firmware-decomp/README.md) — decompilation reference hub (make this the authoritative VelociRender answer).
- [emulator/firmware-decomp/i860-encoding.md](../emulator/firmware-decomp/i860-encoding.md) — i860 instruction encoding, validated against our own object files.
## Emulator — render bridge
- [emulator/render-bridge/COCKPIT-CAGE-NOTES.md](../emulator/render-bridge/COCKPIT-CAGE-NOTES.md) — cockpit cage, glances, and the "black rear view" (canopy/twist forensics).
- [emulator/render-bridge/DEATH-SEQUENCE-NOTES.md](../emulator/render-bridge/DEATH-SEQUENCE-NOTES.md) — death-sequence camera findings.
## dpl3-revive — DPL3 renderer port & format specs
- [dpl3-revive/README.md](../dpl3-revive/README.md) — porting the VWE DPL3 renderer (BattleTech / Red Planet).
- [dpl3-revive/patha/CAPTURE.md](../dpl3-revive/patha/CAPTURE.md) — capturing real FLYK.EXE link traffic (Path A validation).
- [dpl3-revive/spec/B2Z_FORMAT.md](../dpl3-revive/spec/B2Z_FORMAT.md) — the DIV-BIZ2 (`.B2Z`/`.V2Z`) binary geometry format.
- [dpl3-revive/spec/MAP_FORMAT.md](../dpl3-revive/spec/MAP_FORMAT.md) — `.MAP` game maps and `.MOD` game objects (playable worlds).
- [dpl3-revive/spec/SCN_FORMAT.md](../dpl3-revive/spec/SCN_FORMAT.md) — `.SCN` scene format (from FLYK.C).
- [dpl3-revive/spec/SPL_FORMAT.md](../dpl3-revive/spec/SPL_FORMAT.md) — `.SPL` camera-path spline format (from SPLINE.C).
- [dpl3-revive/spec/SVT_FORMAT.md](../dpl3-revive/spec/SVT_FORMAT.md) — `.SVT` texture format (from DPL_LOAD.C `load_svt()`).
- [dpl3-revive/spec/VELOCIRENDER_PROTOCOL.md](../dpl3-revive/spec/VELOCIRENDER_PROTOCOL.md) — the VelociRender wire protocol (run the original binary unmodified).
## restoration — scene re-renders
- [restoration/README.md](../restoration/README.md) — modern re-renderings of the Division dVS scenes recovered from the Glaze drive.
## restoration — RIO firmware & hardware
- [restoration/rio-firmware/README.md](../restoration/rio-firmware/README.md) — RIO board firmware (owner-facing entry point).
- [restoration/rio-firmware/RIOv4_2-ANALYSIS.md](../restoration/rio-firmware/RIOv4_2-ANALYSIS.md) — RIO v4.2 firmware RE: protocol-wedge analysis.
- [restoration/rio-firmware/wedge-explained.md](../restoration/rio-firmware/wedge-explained.md) — plain-language "why the stick died mid-battle" for pod owners.
- [restoration/rio-hardware/README.md](../restoration/rio-hardware/README.md) — RIO cockpit hardware: boards, schematics, GAL dump.
- [restoration/rio-hardware/display-board-1408.md](../restoration/rio-hardware/display-board-1408.md) — Display Board 1408 outputs and what the RIO shows on it.
- [restoration/rio-hardware/gal/README.md](../restoration/rio-hardware/gal/README.md) — U7 GAL20V8A decode: the recovered RIO memory map.
## restoration — source410 reconstruction
- [restoration/source410/BT/BTCNSL.NOTES.md](../restoration/source410/BT/BTCNSL.NOTES.md) — BTCNSL reconstruction notes.
- [restoration/source410/BT/BTPLAYER.NOTES.md](../restoration/source410/BT/BTPLAYER.NOTES.md) — BTPLAYER reconstruction notes (ctor/Make/experience level).
- [restoration/source410/BT/BTSCNRL.NOTES.md](../restoration/source410/BT/BTSCNRL.NOTES.md) — BTSCNRL reconstruction notes.
- [restoration/source410/BT/MECH-LAYOUT.md](../restoration/source410/BT/MECH-LAYOUT.md) — MECH.HPP staging worksheet (the mech-family working ledger).
- [restoration/source410/BT/MECH.NOTES.md](../restoration/source410/BT/MECH.NOTES.md) — MECH.CPP/.HPP reconstruction notes.
- [restoration/source410/BT/MECHSUB.NOTES.md](../restoration/source410/BT/MECHSUB.NOTES.md) — MECHSUB reconstruction notes.
- [restoration/source410/BT/NAMEFILT.NOTES.md](../restoration/source410/BT/NAMEFILT.NOTES.md) — NAMEFILT reconstruction notes.
- [restoration/source410/BT/SENSOR.NOTES.md](../restoration/source410/BT/SENSOR.NOTES.md) — SENSOR reconstruction notes.
- [restoration/source410/BT/SEQCTL.NOTES.md](../restoration/source410/BT/SEQCTL.NOTES.md) — SEQCTL reconstruction notes.
- [restoration/source410/BT/STAGED-HEADERS.NOTES.md](../restoration/source410/BT/STAGED-HEADERS.NOTES.md) — the 13 headers that closed the tree's compile (shared notes).
- [restoration/source410/BT_L4/BTL4.NOTES.md](../restoration/source410/BT_L4/BTL4.NOTES.md) — BTL4.CPP reconstruction notes (launch path).
- [restoration/source410/BT_L4/BTL4APP.NOTES.md](../restoration/source410/BT_L4/BTL4APP.NOTES.md) — BTL4APP.CPP reconstruction notes (12/12 functions).
- [restoration/source410/MUNGA/ALARM.NOTES.md](../restoration/source410/MUNGA/ALARM.NOTES.md) — ALARM.HPP reconstruction notes.
- [restoration/source410/MUNGA/BACKFILLS.NOTES.md](../restoration/source410/MUNGA/BACKFILLS.NOTES.md) — engine header backfills, shared per-file evidence.
- [restoration/source410/MUNGA/VDATA.NOTES.md](../restoration/source410/MUNGA/VDATA.NOTES.md) — VDATA.HPP: the first engine-side header backfill.
- [restoration/source410/README.md](../restoration/source410/README.md) — overview of the missing-source reconstruction effort.
<!-- END AUTOGEN -->