WORKBENCH DOCUMENTATION & TECHNICAL REFERENCE MANUAL

D64 Visualizer, 6502 Disassembler & Disk/ROM File Utilities

100% client-side Rust/WebAssembly workbench combining an interactive Commodore 1541 .D64 disk image parser, 35/40-track radial & matrix sector visualizer, Track 18 Sector 0 BAM decoder, PETSCII directory reader, .PRG file extractor, MOS 6502/6510 disassembler with automatic hardware IC register detection, and .BIN/.ROM binary patcher with IEEE 802.3 CRC32 verification.

STEP 1 Identify Board & Revision

Open the Machine Hub to confirm your ASSY/PCB revision, IC socket map, and PSU specs.

STEP 2 Check Pinouts & Cables

Verify chip rails in the IC Pinout Analyzer and port wiring in Connector Reference.

STEP 3 Scope Signals & Media

Follow Diagnostic Flowcharts & Scope Traces or inspect disks/ROMs in the D64 Wasm Lab.

STEP 4 Calculate, Recap & Rescue

Size parts with Bench Calculators, order recap BOMs, or use the Rehoming & Donation Portal.

MODULE 03 Rust/WebAssembly · 35-Track BAM · 6502 Disassembler · CRC32 Interactive Flowchart

D64 Visualizer, 6502 Disassembler & Disk/ROM File Utilities

100% client-side Rust/WebAssembly workbench combining an interactive Commodore 1541 .D64 disk image parser, 35/40-track radial & matrix sector visualizer, Track 18 Sector 0 BAM decoder, PETSCII directory reader, .PRG file extractor, MOS 6502/6510 disassembler with automatic hardware IC register detection, and .BIN/.ROM binary patcher with IEEE 802.3 CRC32 verification.

INTERACTIVE UI PREVIEW — RUST/WASM .D64 35-TRACK VISUALIZER & 6502 DISASSEMBLER WASM CORE READY
T18 BAM/DIR (GOLD) · ALLOCATED (ACCENT)
Track 18, Sector 0 · DOS 2.6 BAM
Disk: SMIGGY DIAG 26 · 584 Blocks Free · CRC32: 0x8F4A2C19
TRACK 18 PETSCII DIRECTORY & 6502 DISASSEMBLER PIPELINE
$C000 78 SEI ; Disable IRQ interrupts
$C001 A9 00 LDA #$00 ; Black colour byte
$C003 8D 20 D0 STA $D020 [VIC-II Border →]
$C006 8D 18 D4 STA $D418 [SID Volume →]
$C009 AD 00 DC LDA $DC00 [CIA1 Joy Port 2 →]
Interactive Preview: The Retro File Utilities (Rust/Wasm) suite maps 35-track 1541 sector chains on the left and cross-links 6502 hardware registers ($D020, $D418, $DC00) directly to IC pinout diagrams on the right.

Core Capabilities & Coverage

  • Supports 35-track (174,848 B), 35-track with GCR error bytes (175,531 B), and 40-track (196,608 B) Commodore 1541 .D64 images entirely in browser WebAssembly memory.
  • Dual-mode 1541 Disc Surface Visualizer: switch between a physical 5.25" Radial Ring View (showing variable bit-density speed zones across Tracks 1–35) and a 35×21 Matrix Grid View, plus an 850px high-resolution modal and PNG exporter.
  • MOS 6502/6510 Disassembler with synchronized hex/ASCII dump and automatic hardware register detection ($D000 VIC-II, $D400 SID, $DC00/$DD00 CIA, $D800 Colour RAM) linking straight to IC pinout diagrams.
  • .BIN / .ROM Binary Patcher computing live IEEE 802.3 CRC32, 16-bit modular checksums, and XOR checksums for verifying KERNAL, BASIC, Character, and Dead-Test diagnostic ROM dumps.

Step-by-Step Workbench Workflow

  1. 1
    Drag-and-Drop a .D64 Image (or Load a Bench Demo Disk)

    Drop any .D64 file onto the upload zone—or click "Load Clean Demo .D64 Disk" / "Simulate 1541 Read Errors (Status 3)" to immediately explore a populated 35-track Commodore 1541 disk structure.

  2. 2
    Analyze Track Layout, BAM Allocations & Sector Chains

    Hover or click any sector on the 35-Track Canvas (or open the 850px Modal). The zero-occlusion Docked HUD displays the Track/Sector coordinate, BAM status (Free, Allocated, Track 18 Directory/BAM, or GCR Read Error), owning filename, and raw 256-byte sector hex dump.

  3. 3
    Inspect PETSCII Directory & Extract or Disassemble .PRG Files

    Browse the decoded Track 18 directory table showing file types (PRG, SEQ, USR, REL), block sizes, load addresses, and T/S chains. Click "Extract .PRG" to download a file, or click "Disassemble ->" to pipe the binary directly into the 6502 Disassembler tab.

  4. 4
    Disassemble 6502 Code & Patch/Verify .BIN ROM Checksums

    In Tab 2 (6502 Disassembler), inspect decoded instructions alongside clickable hardware register badges (e.g., STA $D020 links to the VIC-II pinout). In Tab 3 (.BIN Patcher), verify ROM CRC32 hashes before burning a 27C64/27C128 EPROM or apply hex byte patches (such as NOP $EA slides).

Workbench Pro-Tip

Click any filename row in the .D64 Directory Table to highlight its exact interleaved sector chain in bright cyan across the 35-track radial disc map—ideal for spotting fragmented files, copy-protection tracks, or corrupt sector links.

Critical Voltage & Hardware Trap

Track 18 Sector 0 BAM Corruption & ROM Size Mismatches: Track 18 is reserved for the 1541 Directory and Block Availability Map; overwriting T18/S0 renders the directory unreadable. When burning replacement ROMs, always check the file byte size (4096 B vs 8192 B) and CRC32 in Tab 3 before programming your EPROM.

Complete Smiggy Bench Tools & 36 Machine Hubs Quick-Reference Index

Every interactive utility, diagnostic reference, computer hub, and console hub documented in this manual — click any entry to launch it directly.

13 Interactive Browser Bench Tools (/bench-tools/*)

Signal & Trace Visualizer Interactive virtual oscilloscope and 8-channel logic analyzer comparing expected healthy waveforms against common hardware faults across C64, Amiga, Z80, TTL/CMOS, and RF/IR remotes with live ΔV/ΔT/f cursors. Open /bench-tools/signal-visualizer → Retro File Utilities (Wasm) Rust/WebAssembly-powered Commodore 1541 .D64 BAM and directory parser with .PRG extraction, a 6502/6510 disassembler with automatic IC pinout cross-linking, and a .BIN/.ROM patcher with CRC32 verification. Open /bench-tools/retro-file-utilities → Resistor & Capacitor Calculator Colour-band decoder for 4- and 5-band resistors with live tolerance range, plus SMD resistor and capacitor marking decoders. Open /bench-tools/resistor-capacitor-calculator → RF & Wireless Reference Filterable cards covering sub-GHz, ISM, Wi-Fi, Bluetooth, infrared, NFC/RFID and mesh standards, each with a full protocol deep dive. Open /bench-tools/rf-wireless-reference → IR vs. RF Remote ID A short decision tree that identifies a remote from non-invasive checks, then hands you the bench tests that confirm the verdict. Open /bench-tools/ir-vs-rf-remote-id → Circuit Block Visualizer Click through power input, regulator, MCU, oscillator and output stages, scope any test point, then inject a fault and watch it propagate. Open /bench-tools/circuit-block-visualizer → 555 Timer & LED Calc 555 astable calculator with a real-time waveform preview, alongside an LED resistor calculator that gives the nearest E24 value and wattage. Open /bench-tools/555-timer-led-calculator → Pinout Reference Interactive SVG diagrams and 43 dedicated port pages covering retro video/SCART, power supplies, joysticks, floppy/disk buses, expansion slots, RS-232, MIDI, USB-C, RJ45 and HDMI. Open /bench-tools/connector-pinout-reference → IC Pinout Quick-Finder Searchable pinout library for 74 retro CPUs, custom video/sound chips, DRAM/SRAM and 74/4000-series logic ICs, filterable by Machine Hub with colour-coded DIP/PLCC diagrams. Open /bench-tools/ic-pinout-finder → Ohm's Law Wheel Solve for voltage, current, resistance or power from any two known values, with the formula used shown for each result. Open /bench-tools/ohms-law-calculator → Hardware Diagnostics Choose a machine and a symptom, then follow a measurement-driven flowchart to the components most likely at fault. Open /bench-tools/hardware-diagnostics → Recap & Repair Reference Cross-checked capacitor lists by machine and board revision, filterable by family, each opening into a full recap guide. Open /bench-tools/recap-repair-reference → Substitution Guide Look up safe chip substitutions for retro DRAM, CPUs and 74-series logic, with red-flagged dangerous swaps and a logic family compatibility matrix. Open /bench-tools/substitution-guide →

36 Retro Computer & Video Game Console Machine Hubs (/hubs & /consoles)

Frequently Asked Questions — Bench Tools & Machine Hubs

Do the .D64 Visualizer, 6502 Disassembler, and ROM Patcher upload my files to a server?

No. Every utility in Retro File Utilities runs 100% client-side in your browser using a Rust core compiled to WebAssembly. Your .D64 disk images, .PRG binaries, and .BIN/.ROM dumps never leave your machine.

How do I switch between Dark, Amber Terminal, Matrix CRT, and Workbench Light themes?

Use the theme toggle button in the top navigation bar or open the System Customization Panel in the footer. All bench tools, SVG pinouts, and UI previews inherit dynamic CSS custom properties so diagrams remain high-contrast in every palette.

How do I cross-reference a dead IC on a motherboard with a safe modern replacement?

First identify your board revision in its Machine Hub, click the suspect chip to inspect its IC Pinout and scope waveforms, and then check the Retro Logic & RAM Substitution Guide for drop-in equivalents and adapter pinouts (such as 4116→4164 or 2364→27C64).

Where can I find documentation on rare controllers (like the SV-129 foot pedal or Voice Master) or donate hardware?

Rare controllers and bench hardware are showcased across Repair & Bench Notes and the Rehoming Bench. To donate faulty or spare retro kit (with free UK shipping covered and a strict never-resold promise), visit Retro Donations.

Theme Palette

Default Dark
High-contrast dark
Amber Terminal
Monochrome amber
Matrix CRT
Phosphor green
Workbench Light
Clean light mode

Audio & Display

Relay Click Sounds Web Audio API — soft mechanical clicks
CRT Scanline & Flicker Pure CSS overlay effect

System Info

Customization Panel Theme preference, audio FX, and CRT overlay settings are saved to your browser's localStorage and persist between visits. No cookies or server-side storage is used.
Keyboard Shortcuts Press Esc to close this panel. Use the header moon/sun icon to cycle themes.