badline 0.17.0 → 0.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0da2c8736f994b6f50c665b7bd8fdd6a1e311df953b16b0d7a09eb833771f96a
-  data.tar.gz: a9922d7605a40eb98862e08c724ff7552a8e56d26662b95eb49b0fa954a9a9f5
+  metadata.gz: 1a3848536bdfa64fefb71cdb9347928e1ce8494c7b13594c07df72abc60f5ca0
+  data.tar.gz: 56c2eb4db9e9cc1953a4255c4d05d46ac01049c143d72a79f972bafefab2a919
 SHA512:
-  metadata.gz: 7cb8eb2574f2816cd5eba6ac3077819583869dd5c60badec24cd3ef2e0d145ae0729c51268cbe47fd3b7781be1a0700415b26309c9eb3eb175e51bd8c799b858
-  data.tar.gz: fd843b8b309c535c679c074801be2240e6e13c3ff65b671635c3a4d138808d048e73ce7802eabec3746d4e7154391757537e17e6ae30d91113c5df585a9c603a
+  metadata.gz: bc38c1d29d366004792db0dd24928c238f6396ce99a24491cb74fa1eb6d95e4f02e843d09da7f179f0a1b33f5e7ceae2e1ed73dfad2abd852802c714ccdb91b3
+  data.tar.gz: f81c7525afd46d0325feecce49bd2f9abda8c3410fc5854b0dea1166703f3c8bdb775bfd84d6c83e161dd3fd586cd0b23c286e564d5559c5d2d006427fedea6f

data/CHANGELOG.md

@@ -1,7 +1,63 @@
 # Changelog
 
+## [0.18.0](https://github.com/elektronaut/badline/compare/v0.17.0...v0.18.0) (2026-10-20)
+
+### Highlights
+
+- **SuperPET**: `badline pet --model superpet` runs the SuperPET with both its CPUs. The 6502 side is an 8032 with 64K of bank RAM, the 6551 ACIA and the 6702 dongle. `--cpu 6809` boots the Waterloo menu on its 6809, and microBASIC, microAPL, Pascal, FORTRAN, COBOL and the editor load from disk and run unpatched. The pause menu sets the CPU and RAM switches, and APL types by key position.
+- **KIM-1**: `badline kim1` runs the MOS KIM-1 with its six-digit display, keypad and single step, or with `--tty` on a teletype in the window or the terminal. Papertapes (`.ptp`, `.pap`) and binaries load straight into RAM or through the monitor's `L`, and cassettes play and record as `.wav`, including real recordings.
+- **VIC-20 NTSC**: `badline vic20 --ntsc` runs the NTSC VIC-20 on its 6560, with its interlace.
+- **Older PET drives**: `--drive-type` puts a 2040, 3040, 4040, SFD-1001, D9060 or D9090 on the PET's or the CBM-II's IEEE-488 bus, and the pause menu's drive page picks one. They read `.d64`, `.d67`, `.d82` and `.d90` images, a hard disk's `N` formats at once, and they save in xpet's `.vsf` snapshots.
+
+### Features
+
+* add a cycle-by-cycle Motorola 6809E core ([5443d24](https://github.com/elektronaut/badline/commit/5443d24b5ce494c6ae15911b823944e3df620430))
+* add the 2040 with DOS 1.2, and .d67 disks through it and the traps ([4e8a324](https://github.com/elektronaut/badline/commit/4e8a324d4db251785d4495db9d6c648897a4ad69))
+* add the 4040 and 3040 as true drives on the PET's and CBM-II's IEEE-488 bus ([d9ce670](https://github.com/elektronaut/badline/commit/d9ce6709131e6a5b37b7650c9c3f85028df55a31))
+* add the SFD-1001 as a true drive on the PET's and CBM-II's IEEE-488 bus ([eda00bf](https://github.com/elektronaut/badline/commit/eda00bf89c2b5fa14459b62c1b97262444ed2139))
+* boot the SuperPET's 6809 to the Waterloo menu, with --cpu ([8e145d6](https://github.com/elektronaut/badline/commit/8e145d65237bcce25775cc1dfcc38723a1d45e8a))
+* bundle the SuperPET's Waterloo 6809 ROMs and character generator ([0dce200](https://github.com/elektronaut/badline/commit/0dce200feb2b7a9356d781d906d57b951ba274a0))
+* follow Banks' silicon notes for the 6809's undocumented opcodes ([cc7e842](https://github.com/elektronaut/badline/commit/cc7e842148c5c285161e7b6ac66abcb739469d86))
+* interlace the 6560 with $9000 bit 7 ([7286f96](https://github.com/elektronaut/badline/commit/7286f96e50752416a6b1b06e64a4455e11cba50e))
+* load KIM-1 papertapes and binaries, with 5K or expanded RAM ([0e48f42](https://github.com/elektronaut/badline/commit/0e48f42acf71a27a0b4092e952ad14cb5c0630a3))
+* load the Waterloo languages in the SuperPET's 6809 mode, through traps on its IEEE-488 routines ([59abf2e](https://github.com/elektronaut/badline/commit/59abf2e95a144d31b7f30396111cff35323bfc5f))
+* pick the PET's and the CBM-II's drive type on the pause menu's drive page ([bc3bb16](https://github.com/elektronaut/badline/commit/bc3bb16be4fe260bbf2828e513fa139e2b3b19e4))
+* play, record and stop the KIM-1's cassette on the pause menu's tape page ([048d1c4](https://github.com/elektronaut/badline/commit/048d1c487042b4df7c9fdcd50154c4faa4bb8ca9))
+* plug the PET's and CBM-II's IEEE-488 drives in by model, with --drive-type ([a3992be](https://github.com/elektronaut/badline/commit/a3992be4839eaef5f03dbef30b60cdd12c49d8cb))
+* put a SuperPET's true-drive disk in drive 1, where the Waterloo menu loads from ([9ff4ea5](https://github.com/elektronaut/badline/commit/9ff4ea55a80cc59db23b9e075a85ac11326dc349))
+* read and format D9060 and D9090 hard disk images ([59479ac](https://github.com/elektronaut/badline/commit/59479ac5a4302cb11c2189b553aa4a323227f711))
+* read and write KIM-1 cassettes as .wav, and play and record them on U2's PB7 ([8041b2c](https://github.com/elektronaut/badline/commit/8041b2cf8a971bec4a7a365134cc92a7f05fc840))
+* run an NTSC VIC-20 with the 6560 as badline vic20 --ntsc ([181b047](https://github.com/elektronaut/badline/commit/181b0477a75e7da359741340bdc71d08576e2176))
+* run the D9060 and D9090 hard disks as true drives on the IEEE-488 bus ([291775a](https://github.com/elektronaut/badline/commit/291775aaf3ce09e8dc0031a13d3503af603818a4))
+* run the KIM-1 headless, with its keypad, display and single step ([0a01647](https://github.com/elektronaut/badline/commit/0a0164719e672e7f42cac842557baf2aafc2ffd3))
+* run the KIM-1 in the window, with its LEDs, keypad, panel page and sound ([df84ba3](https://github.com/elektronaut/badline/commit/df84ba3a6befdfd6e71cb326da74c55aa85b7303))
+* run the KIM-1's monitor on a teletype, in the window or the terminal ([2dd101d](https://github.com/elektronaut/badline/commit/2dd101d329d034c80167154ccc55a27894536ac9))
+* run the SuperPET's board in 6502 mode, with its bank RAM, latches, ACIA and 6702 ([ac0c02f](https://github.com/elektronaut/badline/commit/ac0c02f9853a9cf8807357180f0e45da3454c5e9))
+* save and load the 4040, 3040, 2040, D9060 and D9090 in xpet's snapshot modules ([a5655e4](https://github.com/elektronaut/badline/commit/a5655e4c63e4e3b1952f6fcddf45b1969783aff1))
+* save and load the SuperPET in snapshots, and in xpet's modules ([0dd847e](https://github.com/elektronaut/badline/commit/0dd847e781b94e8ad17b1279d1b763fcdd4152a3))
+* save and restore KIM-1 snapshots ([b30d8bc](https://github.com/elektronaut/badline/commit/b30d8bc864e8529f384e43b06b2d9a5d64b1a106))
+* save the KIM-1's tape deck in its snapshots ([013670c](https://github.com/elektronaut/badline/commit/013670cdfd6ff7910aa1d46fcafc3839bd2ae1b7))
+* set the SuperPET's switches in the window and with --bank-ram, and type APL by key position ([19013b8](https://github.com/elektronaut/badline/commit/19013b827076fabaf72ff8df6fadd2252ce926bd))
+
+
+### Bug Fixes
+
+* keep text typed before the boot in a snapshot ([b648c62](https://github.com/elektronaut/badline/commit/b648c62236c107f57475b6a0feb0688c3bb85daf))
+
+
+### Performance Improvements
+
+* write a disk image's sectors byte by byte ([b2aa0be](https://github.com/elektronaut/badline/commit/b2aa0beae003b42c36ff4853fccb85facad44311))
+
 ## [0.17.0](https://github.com/elektronaut/badline/compare/v0.16.1...v0.17.0) (2026-10-19)
 
+### Highlights
+
+- **CBM-II**: `badline cbm2` runs the B series' 610, 620, 710 and 720, with the 6509 and its segment bus, BASIC 128 or 256, the 6845 CRTC on 80 columns, the SID, both 6525 TPIs and cartridges. `--kernal 04a` or `03b` picks the KERNAL, and `--60hz` runs it on 60 Hz mains.
+- **P500**: `badline cbm2 --model 510`, or `510ntsc`, runs the CBM 510, with a VIC-II for 40 columns in colour, two joysticks, and a 1351 mouse or paddles on either port.
+- **8050 and 8250**: the dual drives run DOS 2.7 on both their processors and read and write `.d80` and `.d82` images. `--true-drive` puts one on the PET's or the CBM-II's IEEE-488 bus for a `.d80` or `.d82`, and the CBM-II takes a true 2031 too.
+- **VICE snapshots**: badline reads and writes xcbm2's and xcbm5x0's `.vsf` files, and a PET's 8050 or 8250 in xpet's. `--vice` adds VICE's modules to a CBM-II snapshot, so xcbm2 or xcbm5x0 opens it.
+
 
 ### Features
 
@@ -78,6 +134,13 @@
 
 ## [0.16.0](https://github.com/elektronaut/badline/compare/v0.15.1...v0.16.0) (2026-10-17)
 
+### Highlights
+
+- **PET and CBM**: `badline pet` runs the 2001, 3032, 3032b, 4032, 8032 and 8096, with the discrete 40-column video or the 6545 CRTC on 40 and 80 columns, the CRTC counted to the cycle, the graphics and business keyboards, and the sound on the VIA's CB2. The 8032 is the default.
+- **Upgrade ROMs**: `--basic` fits BASIC 1, 2 or 4 and `--editor` an editor the board takes, `--60hz` runs a CRTC PET's 60 Hz editor, and `--ram` fits 4K to 32K.
+- **Media**: programs and disks go on device 8 through traps on the IEEE-488 bus, with the 8050's and 8250's `.d80` and `.d82` images read and written, and tapes play and record on both cassette ports.
+- **Snapshots**: `F11` and the Snapshots page save and restore the PET in keyed snapshots.
+
 
 ### Features
 
@@ -180,6 +243,12 @@
 
 ## [0.15.0](https://github.com/elektronaut/badline/compare/v0.14.0...v0.15.0) (2026-10-12)
 
+### Highlights
+
+- **Plus/4, C16 and C116**: `badline plus4` runs them in the window, with the TED's picture and sound, BASIC 3.5, the Plus/4's 3-plus-1 function ROMs and both joysticks. `--model` picks `plus4`, `c16`, `c116`, `plus4ntsc` or `c16ntsc`, and `--ram` fits 16K, 32K or 64K.
+- **Media**: programs load and run, tapes play and record on the datasette, disks go through the KERNAL traps or a true 1541 or 1581 on the serial bus, and cartridges go in both slots, from a `.crt` or a raw `.bin` (`--c1lo`, `--c1hi`, `--c2lo` and `--c2hi`).
+- **Snapshots**: `F11` and the Snapshots page save the Plus/4 and the C16, and snapshots now hold the cartridge mappers' registers and the extra SIDs.
+
 
 ### Features
 
@@ -203,6 +272,12 @@
 
 ## [0.14.0](https://github.com/elektronaut/badline/compare/v0.13.0...v0.14.0) (2026-10-11)
 
+### Highlights
+
+- **Snapshots that keep loading**: snapshots hold the machine as keyed `BL-*` modules, so one saved by 0.14.0 loads in every later version. Snapshots from earlier versions are refused with a message.
+- **VICE export**: VICE's own modules go in only on export, with `--save-snapshot FILE --vice`, so x64sc opens the file too.
+- **Plus/4 and C16, headless**: the 264 series boots to READY headless with its ROMs bundled, reads Plus/4 `.crt` images and version 2 C16 tapes, and runs VICE's 264 testbench rows (`testbench-plus4`, `testbench-c16`) and the Lorenz suite's plus4 build (`lorenz-plus4`).
+
 
 ### Features
 
@@ -252,6 +327,11 @@
 
 ## [0.13.0](https://github.com/elektronaut/badline/compare/v0.12.1...v0.13.0) (2026-10-11)
 
+### Highlights
+
+- **Library layout**: `lib/badline/` is regrouped by namespace, and each constant follows its directory. `Badline::Computer` is now `Badline::C64`, and the chips, drives and input devices sit under `Badline::Chips`, `Badline::Drives` and `Badline::Input`. The move leaves emulation as it was.
+- **`peek` and `poke`**: each machine reads and writes memory as its CPU sees it.
+
 
 ### Features
 
@@ -277,6 +357,12 @@
 
 ## [0.12.0](https://github.com/elektronaut/badline/compare/v0.11.1...v0.12.0) (2026-10-10)
 
+### Highlights
+
+- **CP/M**: the C128's Z80 sits on its bus and starts the machine, as on a real C128. `badline c128 cpm3.d81` boots CP/M Plus to `A>`, and ZEXDOC and ZEXALL pass every test under it.
+- **Boot disks**: a C128 boot disk, such as CP/M's system disks or a boot game, boots in C128 mode at power-on.
+- **1581**: the 3.5" drive runs its own DOS on its WD1772 and reads and writes `.d81` images, on the C64, the VIC-20 and the C128 (`--true-drive` with a `.d81`).
+
 
 ### Features
 
@@ -303,6 +389,12 @@
 
 ## [0.11.0](https://github.com/elektronaut/badline/compare/v0.10.1...v0.11.0) (2026-10-09)
 
+### Highlights
+
+- **C128**: `badline c128` runs a C128 in C128 mode with BASIC 7.0, through its own 8722 MMU and KERNAL, on the 8502 with its 2 MHz FAST mode and 128K of RAM, in both builds. `--model` picks `c128`, `c128dcr`, `c128ntsc` or `c128dcrntsc`. Device 8 goes through the KERNAL traps, and `F11` and `F12` save and load it in badline's own snapshots.
+- **80 columns**: the VDC draws its 80-column display, and the window follows the C128 between its 40 and 80 column screens. `F6` is the 40/80 DISPLAY key, and `F8` switches the window to the other screen.
+- **C64 mode**: `--c64` holds `C=` through the reset to start C64 mode, as a program that loads at `$0801`, a `.sid` tune or a C64 cartridge does, and `GO64` gets there from BASIC 7.0.
+
 
 ### Features
 
@@ -336,6 +428,13 @@
 
 ## [0.10.0](https://github.com/elektronaut/badline/compare/v0.9.0...v0.10.0) (2026-10-08)
 
+### Highlights
+
+- **VIC-20**: `badline vic20` runs a PAL VIC-20 in the window, in both builds, with the 6561 VIC-I's picture and sound, both VIAs, the keyboard, the joystick and RESTORE. All 72 rows of `testbench-vic20` pass.
+- **Media**: programs, disks, tapes and cartridges load as on the C64, with device 8 through the KERNAL traps or a true 1541 (`--true-drive`). Without `--ram`, the VIC-20 gets the RAM expansion its media needs, up to 35K.
+- **Snapshots**: `F11`, `F12` and the pause menu save and load the VIC-20 in badline's own snapshots.
+- **Machine families**: the first argument can name the machine, as in `badline c64 game.prg` or `badline vic20 game.prg`.
+
 
 ### Features
 
@@ -365,6 +464,13 @@
 
 ## [0.9.0](https://github.com/elektronaut/badline/compare/v0.8.0...v0.9.0) (2026-10-05)
 
+### Highlights
+
+- **Quicksaves and autosave**: `F11` quicksaves to the next of five slots in badline's data folder, and `F12` restores the newest, even after badline has quit and started again. badline autosaves every two minutes of play, and the pause menu's Snapshots page saves under a name and loads any save.
+- **Self-contained snapshots**: a snapshot restores without its tape, `.t64` or true drive disk files, and NTSC, Drean and REU machines save as `.vsf` too.
+- **`--model`**: picks the C64 to run, named as in VICE: `c64`, `c64c`, `ntsc`, `newntsc` and `oldntsc`, and the new `drean`, the Drean C64, PAL-N with the 6572, and `sx64`, the SX-64.
+- **Disk lists**: `.m3u` playlists and VICE `.vfl` flip lists give a disk set for the pause menu.
+
 
 ### Features
 
@@ -394,6 +500,13 @@
 
 ## [0.8.0](https://github.com/elektronaut/badline/compare/v0.7.0...v0.8.0) (2026-10-03)
 
+### Highlights
+
+- **Pause menu**: `F9` pauses the machine and opens a menu with a page for each part of the hardware: Drive 8, Datasette, Expansion port, with the cartridge's freeze button, Ports, Sound and Power. INSERT opens a file browser, and Quick open starts a file in a new machine as the command line does.
+- **Disk sets**: the Drive 8 page steps to the previous or next disk of a set, found by the names in the disk's folder, such as `Disk 1`, `Side B` or TOSEC's `(Disk 1 of 2)`.
+- **Drag and drop**: a disk or tape dropped on the window goes into its drive, and a dropped cartridge, program or `.sid` asks first.
+- **Write-protected by default**: disks go in write-protected, and `--writable`, or WRITABLE on the Drive 8 page, lets the machine write to the image.
+
 
 ### ⚠ BREAKING CHANGES
 
@@ -413,6 +526,13 @@
 
 ## [0.7.0](https://github.com/elektronaut/badline/compare/v0.6.1...v0.7.0) (2026-10-02)
 
+### Highlights
+
+- **SID player**: `badline sid FILE|DIR...` plays a queue of tunes in a window worked with the mouse, and `badline tune.sid` opens it too. Its visualizer shows each voice's note and output, its SID view the registers, envelopes and filter, and its INFO view the tune's entry in HVSC's STIL.
+- **Queue and subtunes**: shuffle, looping and playing all subtunes, seeking within a subtune from the bar or with `,` and `.`, and `.sid` files and folders dropped on the window join the queue. A subtune with no known length ends when it falls silent.
+- **2SID and 3SID**: a tune written for two or three SIDs plays on as many, in stereo.
+- **Chip swap**: the 6581 and the 8580 swap while a tune plays.
+
 
 ### ⚠ BREAKING CHANGES
 
@@ -490,6 +610,11 @@
 
 ## [0.6.0](https://github.com/elektronaut/badline/compare/v0.5.1...v0.6.0) (2026-09-29)
 
+### Highlights
+
+- **Snapshots**: `F11` saves the whole machine to a `.vsf` snapshot in the working directory, and `F12` goes back to the one last saved or opened, in both executables. A snapshot holds the machine as it was on the cycle it was saved, with its RAM, expansions, cartridge, a true 1541 and the tape.
+- **VICE's format**: badline opens snapshots VICE's x64sc saved, as in `badline game.vsf`, and x64sc 3.10 opens badline's.
+
 
 ### Features
 
@@ -514,6 +639,13 @@
 
 ## [0.5.0](https://github.com/elektronaut/badline/compare/v0.4.2...v0.5.0) (2026-09-29)
 
+### Highlights
+
+- **True 1541**: `--true-drive` puts an emulated 1541 on device 8, running its own DOS ROM on its own 6502 and talking to the C64 over the serial bus. It reads `.d64` disks through its GCR mechanism, writes and formats them, and skips its cycles while it idles.
+- **`.g64` images**: a `.g64` holds a disk's raw GCR, so copy protection and fast loaders that read it work. It goes in a true 1541.
+- **REU**: `--reu SIZE` plugs in a 1700, 1764 or 1750, or a bigger unit up to 16M, with DMA timed against the VIC's bad lines and sprites.
+- **NTSC**: `--ntsc` runs an NTSC C64, with the 6567R8 VIC-II.
+
 
 ### Features
 
@@ -556,6 +688,13 @@
 
 ## [0.4.0](https://github.com/elektronaut/badline/compare/v0.3.0...v0.4.0) (2026-09-28)
 
+### Highlights
+
+- **Native `badline`**: compiled ahead of time with Spinel, it installs with `brew install elektronaut/tap/badline` on macOS, takes `badline-ruby`'s options and plays sound by default. Its window reads game controllers, the mouse and paddles, and paces itself by vsync.
+- **`badline-ruby`**: the gem's executable is renamed, and takes over from `badline-sid`: `--headless tune.sid` plays a tune and `--audio-out out.wav` renders one.
+- **Writable disks**: the virtual drive writes `SAVE`s, files and blocks back to the disk image, `--read-only` mounts one write-protected, and `Badline::Media.insert_disk` swaps the disk while the machine runs.
+- **More hardware**: GEO-RAM, the +60K and +256K RAM expansions, and the C64C's 8565 VIC-II and 6526A CIA, chosen from Ruby.
+
 ### Upgrading
 
 * The gem's executable is now `badline-ruby`. The name `badline` now belongs to the native build, which installs with `brew install elektronaut/tap/badline` on macOS.
@@ -614,6 +753,12 @@
 
 ## [0.3.0](https://github.com/elektronaut/badline/compare/v0.2.1...v0.3.0) (2026-09-24)
 
+### Highlights
+
+- **Sound in the window**: `badline --sound` plays the SID in the emulator window and paces emulation to the audio device. It is off by default.
+- **A virtual drive closer to the 1541**: buffer channels live in the drive's RAM, DOS command parameters are read as the 1541 reads them, the BAM goes in buffer 4 when a disk initializes, `LOAD"*"` reopens the last file loaded, and host SAVE and read failures show on the error channel.
+- **Other ROMs**: `BADLINE_ROM_PATH`, or `Badline.rom_path` from Ruby, loads the KERNAL, BASIC and character ROMs from a directory.
+
 Sound is the headline: `badline --sound` plays the SID in the emulator window and paces emulation to the audio device. It is off by default, because the emulator still runs below real time on CRuby and the sound stutters there. This release also brings the virtual drive closer to a real 1541 (buffer channels in drive RAM, DOS command parsing, the BAM in buffer 4, `LOAD"*"`), cartridge banking fixes, and `Badline::Checkpoint` with `bin/machine_diff` for checking that a change leaves emulation alone.
 
 
@@ -681,6 +826,14 @@ Sound is the headline: `badline --sound` plays the SID in the emulator window an
 
 ## [0.2.0](https://github.com/elektronaut/badline/compare/v0.1.0...v0.2.0) (2026-09-23)
 
+### Highlights
+
+- **VIC-II**: the border, the bad-line DMA delay, idle graphics, the light pen and sprites run cycle by cycle, with the sprite registers replayed through a per-pixel sequencer.
+- **CPU and CIAs**: the 6510 polls interrupts every cycle and makes the dummy reads of its internal cycles, and the CIAs model the CNT pin, the serial port and the TOD clock. Wolfgang Lorenz's test suite passes from start to finish.
+- **SID**: the 6581 and the 8580, with the board's RC filter and combined waveforms fitted against real-chip dumps. `badline-sid` plays `.sid` tunes live and renders them to WAV or AIFF, taking the length from HVSC's song lengths.
+- **Cartridges**: EasyFlash, Epyx FastLoad, Pagefox, Simons' BASIC, the Action Replay, Retro Replay and Final Cartridge III freezers, the KCS Power Cartridge and more bank-switching mappers.
+- **Media and input**: `.tap` tapes play through the datasette, `.t64` archives load by name, and device 8 is served by trapping the KERNAL's serial bus primitives. Paddles and a 1351 mouse plug into either control port, and host gamepads drive the joysticks.
+
 
 ### Features
 

data/CLAUDE.md

@@ -70,10 +70,13 @@ file: `core.rb` requires their members one by one.
 | rspec (`spec/`) | `bundle exec rspec` | Unit behaviour, all of `lib/` |
 | SingleStepTests 65x02 | `rake test` (100 sampled cases per opcode) | CPU, per-cycle bus traces |
 | SingleStepTests z80 | `rake test` (the first 100 cases per opcode, `Z80_SAMPLE=all` for all 1,604,000) | `Z80`: registers, flags, ports and the bus pins on every T-state |
+| neetandev/m6809 vectors | `rake test` (the first 100 cases per opcode, `M6809_SAMPLE=all` for all 315,000) | `M6809`: registers, RAM and the bus on every cycle, with the dead cycles and undocumented opcodes `test/support/m6809_divergences.rb` moves to the MC6809E datasheet and Banks' notes |
+| 6809 code tester | `rake test` | `M6809`: reyco2000's functional, interrupt (IRQ, FIRQ, NMI, SYNC, CWAI) and cycle-count programs on a bare 6809 |
 | Wolfgang Lorenz suite | `bin/lorenz` | CPU, CIA, interrupts; its plus4 build with `--plus4`: the CPU on the 264's bus, the TED's clock, DMA, timers and interrupt |
-| VICE testbench | `bin/testbench <subtree>` | `VICII/`, `CIA/`, `interrupts/`, `CPU/`, cartridges with `--carts`, the true 1541 drive with `--drive`, the VIC-20 with `--vic20`, the C128 in C64 mode with `--c128c64`, in C128 mode with `--c128`, and its Z80 with `--c128-z80`, the Plus/4 with `--plus4`, the C16 with `--c16`, and the PET with `--pet` (8096) and `--pet-discrete` (2001, 3032) |
+| VICE testbench | `bin/testbench <subtree>` | `VICII/`, `CIA/`, `interrupts/`, `CPU/`, cartridges with `--carts`, the true 1541 drive with `--drive`, the VIC-20 with `--vic20` (NTSC with `--ntsc`), the C128 in C64 mode with `--c128c64`, in C128 mode with `--c128`, and its Z80 with `--c128-z80`, the Plus/4 with `--plus4`, the C16 with `--c16`, and the PET with `--pet` (8096) and `--pet-discrete` (2001, 3032) |
 | VICE SID testprogs | `bin/sidtests` | SID |
 | Drive scenarios | `bin/drive_scenarios` | The true 1541 running the DOS ROM: save, format, the error channel, idle, write protect and autostart; the `plus4-*` rows on the Plus/4 and C16, with the 1541 and 1581 on their serial bus and a tape saved and loaded back on the datasette |
+| KIM-1 scenarios | `bin/drive_scenarios kim1` | The KIM-1's monitor: keys and the display, SST, ST, the teletype at 9600 and 110 baud, a papertape through `L`, a program loaded and started, and U3's timer interrupting through IRQ |
 | CIA offline grids | `bundle exec rspec --tag slow spec/badline/chips/cia` | CIA timers and shift register, against a bare CIA in about 2 min |
 
 The CIA offline grids replay Lorenz's `cia1ta` and `cia1tb` sweeps (about
@@ -133,7 +136,7 @@ worktree and owns a different set of files.
 - The external suites under `vendor/` are gitignored, so a new worktree has
   only `vendor/.gitkeep`. From the worktree root, symlink the main
   checkout's suites into it:
-  `for d in 65x02 z80-sample VICE-testprogs; do ln -sfn ../../../../vendor/$d vendor/$d; done`.
+  `for d in 65x02 z80-sample m6809 m6809-code-tester VICE-testprogs; do ln -sfn ../../../../vendor/$d vendor/$d; done`.
   The main checkout also has `vendor/OneLoad64-Games-Collection-v5`, which
   `rake vendor:checkout` doesn't fetch. Link it the same way only for
   `.sid` or media work. Don't re-run `rake vendor:checkout` there, and
@@ -159,8 +162,8 @@ worktree and owns a different set of files.
 
 ## Testing and baselines
 
-- `rake vendor:checkout` fetches SingleStepTests 65x02, the Z80 sample
-  and VICE-testprogs into `vendor/`
+- `rake vendor:checkout` fetches SingleStepTests 65x02, the Z80 sample,
+  the 6809 vectors and test programs, and VICE-testprogs into `vendor/`
 - `bundle exec rspec`: line coverage is about 95%. `spec/spec_helper.rb`
   fails a whole-suite run (every spec file, no filters) below 90%, while
   single-file and filtered runs skip the floor. `:slow` specs are excluded
@@ -191,7 +194,7 @@ overrides that, capped by the core count, but keep the default, because
 other worktrees share the machine. Whole runs at 4 shards on an M-series
 laptop take 15 min for `testbench` (`VICII/`), 11 for `testbench-cia`, 1 for
 `testbench-interrupts`, 37 for `testbench-irqdma`, 11 for
-`testbench-cpu`, 2 for `testbench-carts`, about 25 for `testbench-expansions`, under 1 for `testbench-vic20`, `testbench-plus4`, `testbench-c16` and `testbench-plus4-ntsc`, and about 30 for `testbench-c128c64`. `lorenz-plus4` takes about 21 min whole on the Spinel build. `rake regression:lorenz-plus4-1` to `lorenz-plus4-4` run it as four stretches, cut where `lorenz` is, and the last, through the trap tests the chain resumes past, is about half of it. `sid` takes about 12 min. `lorenz` chains itself and takes
+`testbench-cpu`, 2 for `testbench-carts`, about 25 for `testbench-expansions`, under 1 for `testbench-vic20`, `testbench-vic20-ntsc`, `testbench-plus4`, `testbench-c16` and `testbench-plus4-ntsc`, and about 30 for `testbench-c128c64`. `lorenz-plus4` takes about 21 min whole on the Spinel build. `rake regression:lorenz-plus4-1` to `lorenz-plus4-4` run it as four stretches, cut where `lorenz` is, and the last, through the trap tests the chain resumes past, is about half of it. `sid` takes about 12 min. `lorenz` chains itself and takes
 about 2.5 h on CI whole. `rake regression:lorenz-1` to `lorenz-4` run it as
 four stretches of about 40 min each, and they can run side by side.
 `test/baselines/README.md` has the full table. A killed `bin/testbench` run
@@ -263,7 +266,8 @@ the 6526A) for anything the interrupt register or the CIA model reaches; cartrid
 `testbench-carts`, plus `testbench-expansions` for banking; GEO-RAM, +60K,
 +256K, the REU or the VIC's BA line the REU follows → `testbench-expansions`; the 1541 drive, VIA or IEC bus →
 `testbench-drive` (`bin/testbench --drive`) and `drive-scenarios` (`bin/drive_scenarios <filter>`), plus `testbench-vic20` for the VIA; the VIC-20 (`vic20/`) →
-`testbench-vic20` (`bin/testbench --vic20`); the 264 series (`plus4.rb`,
+`testbench-vic20` (`bin/testbench --vic20`) and `testbench-vic20-ntsc`
+(`bin/testbench --vic20 --ntsc`); the 264 series (`plus4.rb`,
 `plus4/`), the TED (`chips/ted.rb`, `chips/ted/`) or the TIA (`chips/tia.rb`)
 → `testbench-plus4` (`bin/testbench --plus4`) and `testbench-c16`
 (`bin/testbench --c16`), plus `testbench-plus4-ntsc`
@@ -275,7 +279,7 @@ serial bus, its media, the CPU port or the datasette.
 Its tests run one at a time as the C64's do, with
 `ruby --yjit bin/lorenz --plus4 --resume <test> --stop-after <test>`; the C128 (`c128.rb`, `c128/`), or
 the VIC-IIe, CPU or PLA code it shares with the C64 → `testbench-c128c64`
-(`bin/testbench --c128c64`); the PET (`pet.rb`, `pet/`), its 6520 PIA (`chips/pia.rb`) or its CRTC (`chips/crtc.rb`) → `testbench-pet` (`bin/testbench --pet`) and `testbench-pet-discrete` (`bin/testbench --pet-discrete`), plus `testbench-cbm2` for the CRTC; the CBM-II (`cbm2.rb`, `cbm2/`), its 6525 TPI (`chips/tpi.rb`) or the CIA, SID and ACIA it shares → `testbench-cbm2` (`bin/testbench --cbm2`), plus `testbench-cbm5x0` (`bin/testbench --cbm5x0`); the P500 (`cbm2/p500.rb`, `cbm2/p500/`) → `testbench-cbm5x0`, which the VIC (`chips/vic*`) reaches too; the C128's Z80, MMU or hand-over → `testbench-c128-z80` (`bin/testbench --c128-z80`) and `testbench-c128`; SID → `sid`, plus `sid-8580` for anything the 8580
+(`bin/testbench --c128c64`); the PET (`pet.rb`, `pet/`), its 6520 PIA (`chips/pia.rb`) or its CRTC (`chips/crtc.rb`) → `testbench-pet` (`bin/testbench --pet`) and `testbench-pet-discrete` (`bin/testbench --pet-discrete`), plus `testbench-cbm2` for the CRTC; the CBM-II (`cbm2.rb`, `cbm2/`), its 6525 TPI (`chips/tpi.rb`) or the CIA, SID and ACIA it shares → `testbench-cbm2` (`bin/testbench --cbm2`), plus `testbench-cbm5x0` (`bin/testbench --cbm5x0`); the P500 (`cbm2/p500.rb`, `cbm2/p500/`) → `testbench-cbm5x0`, which the VIC (`chips/vic*`) reaches too; the C128's Z80, MMU or hand-over → `testbench-c128-z80` (`bin/testbench --c128-z80`) and `testbench-c128`; the KIM-1 (`kim1.rb`, `kim1/`), its media or the 6530 (`chips/rriot.rb`) → `kim1-scenarios` (`bin/drive_scenarios kim1`); SID → `sid`, plus `sid-8580` for anything the 8580
 model reaches (`bin/sidtests --sid 8580`). Leave the Lorenz chain to CI,
 unless your code has a rule in `doc/pinned-behaviour.md` that names Lorenz
 tests: the interrupt polling, CPU port and CIA timer rules. Run just the

data/CONTRIBUTING.md

@@ -75,11 +75,17 @@ the Z80 against the [Z80 ones](https://github.com/SingleStepTests/z80).
 which takes a moment the first time. For the Z80 it fetches only the
 first 100 cases of each opcode's file into `vendor/z80-sample`.
 `Z80_SAMPLE=all` checks the whole Z80 suite out into `vendor/z80`
-(about 1.5 GB) and runs every case:
+(about 1.5 GB) and runs every case. The 6809 is verified against
+[neetandev/m6809](https://github.com/neetandev/m6809)'s vectors, which
+`rake test` fetches into `vendor/m6809` (24 MB). It runs the first 100
+cases of each opcode's file, or every case with `M6809_SAMPLE=all`, and
+also runs [reyco2000's 6809 test programs](https://github.com/reyco2000/6809_6309_code_tester),
+fetched into `vendor/m6809-code-tester`:
 
 ```sh
 bundle exec rake test
 Z80_SAMPLE=all bundle exec rake test
+M6809_SAMPLE=all bundle exec rake test
 ```
 
 Check style before pushing: