ENGINEERING & HARDWARE ARCHITECTURE
Call of the Wintermon is built from the ground up to demonstrate modern software engineering practices applied to historical 8-bit embedded constraints: 100% MOS 6502 assembly language, deterministic frame scheduling, hardware register pipelining, and automated Python asset compilers.
> THE ATARI CUSTOM CO-PROCESSORS
Dedicated silicon co-processors designed by Jay Miner that defined the Atari 8-bit architecture.
A true graphics microprocessor running its own instruction set concurrently with the 6502. ANTIC fetches Display Lists via direct memory access (DMA), controlling screen geometry on a line-by-line basis.
- Display Lists: Dynamic instruction pipelines driving ANTIC Mode E (160×96 2bpp).
- DLI Support: Bit 7 interrupts halting the 6502 to reload GTIA color palettes on the fly.
- Fine Scrolling: Hardware horizontal and vertical pixel fine-scroll registers (
HSCROL,VSCROL).
Converts ANTIC digital video signals into analog composite video (lum/chroma). Manages the 128/256-color palette, Player-Missile Graphics, and hardware collision detection registers.
- Player-Missile Graphics: 4 hardware players and 4 missiles with independent horizontal positions (
HPOSP0-HPOSP3). - Hardware Collisions: Instant silicon collision latches (
M0PF,P0PF,M0PL). - Console Keys: Direct read of START, SELECT, and OPTION buttons (
CONSOL).
The multi-function audio/input chip. Provides 4 independent polyphonic audio channels, random noise generators, high-speed serial I/O, timers, and matrix keyboard scanning.
- 4 Audio Channels: Frequency dividers (
AUDF1-4) and distortion control (AUDC1-4). - Timers & Polynomials: 4-bit, 5-bit, 9-bit, and 17-bit polynomial noise generation.
- Sound Engine: Custom 50 Hz VBLANK driver executing music scores and priority SFX.
The central 8-bit processing unit running at 1.773447 MHz on PAL systems. Communicates with joystick ports and system memory banking via the 6520 PIA.
- PORTB ($D301): Memory banking register controlling BASIC ROM and OS ROM visibility.
- Deterministic Timing: Strict instruction cycle budgets per scanline (114 system cycles per scanline).
- Zero Page ($80-$FF): Fast 1-cycle-saving addressable scratchpad registers for game physics and rendering pointers.
> DETERMINISTIC 50 HZ FRAME PIPELINE
Fixed phase execution scheduled once per PAL frame (every 20 ms).
Sample PIA PORTA joystick directions and TRIG0 fire button with debouncing.
Update player velocity, moving platforms, patrol enemies, and animation frame counters.
Evaluate bounding box intersections against platform tiles, enemy hitboxes, and collectible secrets.
Transition game states (Playing, Game Over, Stage Victory) and update life and score counters.
Write PMG player/missile slices into active RAM buffers and build DLI scanline tables.
VBLANK NMI commits display list pointers, ticks POKEY music driver, and resets color shadows.
> MODERN TOOLING FOR VINTAGE SILICON
Integrating modern Python build pipelines with native 6502 cross-assembly.
MADS (Mad Assembler 2.1.6)
Fast 6502/65C02 macro cross-assembler. Compiles modular assembly files into single-pass XEX binaries
with automatic label export (main.lab) and listing maps (main.lst).
PYTHON SSOT DATA COMPILERS
YAML and JSON source-of-truth files (manifest.yaml, scenes.json)
are parsed via Pydantic and compiled directly into Structure-of-Arrays (SoA) assembly tables,
guaranteeing zero runtime overhead for the 6502.
AUTOMATED PY65 & MEMORY VERIFICATION
Continuous verification via py65 CPU emulation harnesses.
Automated scripts (check_memory.py, generate_memory_map.py)
enforce segment bounds and verify headroom below $C000 before any binary is released.
DUAL-LANGUAGE LOCALIZATION (EN & PL)
Call of the Wintermon releases feature native English (call_of_the_wintermon_en.xex)
and Polish (call_of_the_wintermon_pl.xex) binaries compiled via conditional
MADS assembly (-d:LANG_EN=1). Both versions share a unified 1 KB Atari character set
mapped to full Latin and Polish diacritics with zero runtime RAM overhead.