WORKBENCH DOCUMENTATION & TECHNICAL REFERENCE MANUAL

D64 Visualizer, 6502 Disassembler, Retro Graphics Converter & ROM Utilities

100% client-side retro file and graphics workbench combining a Rust/WebAssembly Commodore 1541 .D64 disk image parser, 35/40-track radial & matrix sector visualizer, Track 18 Sector 0 BAM decoder, .PRG file extractor, MOS 6502/6510 disassembler with automatic IC register detection, .BIN/.ROM CRC32 patcher, and a bidirectional Retro Graphics Viewer & Converter (.KOA, .ART, .SCR, .BIN <-> PNG/JPG with Floyd-Steinberg dithering).

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/Wasm · 35-Track BAM · 6502 Disassembler · .KOA/.ART/.SCR Converter Interactive Flowchart

D64 Visualizer, 6502 Disassembler, Retro Graphics Converter & ROM Utilities

100% client-side retro file and graphics workbench combining a Rust/WebAssembly Commodore 1541 .D64 disk image parser, 35/40-track radial & matrix sector visualizer, Track 18 Sector 0 BAM decoder, .PRG file extractor, MOS 6502/6510 disassembler with automatic IC register detection, .BIN/.ROM CRC32 patcher, and a bidirectional Retro Graphics Viewer & Converter (.KOA, .ART, .SCR, .BIN <-> PNG/JPG with Floyd-Steinberg dithering).

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.
Printable Diagnostic Flowchart & Voltage CheckpointsFormat this step-by-step fault isolation tree into a high-contrast bench reference sheet.

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.
  • Bidirectional Retro Graphics Viewer & Converter (/bench-tools/retro-graphics-viewer): decode C64 Koala (.KOA), Art Studio (.ART), ZX Spectrum (.SCR), and 8×8 Font ROMs (.BIN) to PNG, or encode modern PNG/JPG/WebP images into hardware-valid .KOA, .ART, and .SCR binaries with Floyd-Steinberg dithering.

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, Verify ROMs & Convert Retro Graphics (.KOA / .ART / .SCR)

    In Tab 2 (6502 Disassembler), inspect decoded instructions alongside clickable hardware register badges. In Tab 3 (.BIN Patcher), verify ROM CRC32 hashes before burning an EPROM. For screen dumps or character ROMs, open the Retro Graphics Viewer & Converter (/bench-tools/retro-graphics-viewer) to decode .KOA/.ART/.SCR/.BIN files to PNG or convert modern PNG/JPG images into native 8-bit binaries with Floyd-Steinberg dithering.

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 & 37 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.

19 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 → Retro Graphics Viewer Bidirectional 8-bit graphics workbench: decode C64 Koala (.KOA), Art Studio (.ART), ZX Spectrum (.SCR) & Font ROMs to PNG, or convert modern PNG/JPG images into native .KOA, .ART, and .SCR binaries with Floyd-Steinberg dithering. Open /bench-tools/retro-graphics-viewer → Sprite & Tile Converter Interactive 24×21 C64 sprite (monochrome and multicolor 2-bit bitpairs) and 8×8 character tile editor with system palettes (C64, ZX Spectrum, BBC Micro, NES) and real-time 6502 .byte, Z80 defb, BASIC DATA, and C uint8_t code generators. Open /bench-tools/sprite-tile-converter → Visual Memory Mapper Interactive 64KB ($0000–$FFFF) visual memory mapper across C64, VIC-20, ZX Spectrum 48K/128K, BBC Micro, and Atari 800/XL with real-time ROM/RAM banking toggles, 16-bit Low/High byte address decoding, hardware register tables, and a visual Video RAM matrix calculator. Open /bench-tools/memory-mapper → BASIC-to-ASM & .PRG Transform legacy Commodore BASIC V2, Sinclair BASIC, and Locomotive/BBC BASIC into line-stripped label code, commented 6502/6510 or Z80 assembly templates, hardware POKE/PEEK opcode breakdowns, and downloadable tokenized .PRG binaries. Open /bench-tools/basic-to-assembly → Opcode & Cycle Counter Searchable instruction set reference, visual status flag matrix, and raster-timing cycle calculator for MOS 6502/6510 (including undocumented opcodes), Zilog Z80, and Motorola 68000 with branch and page-crossing penalty analysis. Open /bench-tools/opcode-lookup → 6502/Z80 Assembler Split-screen in-browser MOS 6502/6510 and Zilog Z80 cross-assembler and two-way disassembler with live syntax highlighting, synchronized hex/ASCII dump, symbol table inspector, and one-click .PRG / .TAP binary export. Open /bench-tools/retro-assembler → 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 Interactive schematic & drag-and-drop sandbox with a dual-trace oscilloscope (ΔV/ΔT/f cursors), DMM/Logic Probe overlay, unpowered Ω-to-GND tester, multi-fault cascading failure simulator, live ESR/thermal/cold-solder sliders, IC pinout/flowchart links, and PDF/Markdown worksheet export. 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 59 dedicated port pages covering retro video/SCART, power supplies, joysticks, cassette/audio, floppy/disk buses, expansion slots, Centronics printer, RS-232, MIDI, USB-C, RJ45 and HDMI. Open /bench-tools/connector-pinout-reference → IC Pinout Quick-Finder Searchable pinout library for 85 retro CPUs, custom video/sound chips, DRAM/SRAM/ROM 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 →

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

Frequently Asked Questions — Bench Tools & Machine Hubs

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

No. Every utility in Retro File Utilities and the Retro Graphics Viewer & Converter runs 100% client-side in your browser using WebAssembly and HTML5 Canvas ArrayBuffer views. Your .D64 disk images, .KOA/.ART/.SCR screens, .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.