badline 0.15.0 → 0.15.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcc4aea1603a5dac88787b701529e7019573fa5bd3b66cdd31a6d4f071fb3ecf
-  data.tar.gz: bc8de62e989822edd15ff2d59002a034c361c176e50a0e064a3482ff820b150a
+  metadata.gz: 4083bb2ab34b03da1e8139771b512927b0dedf525fa101bc3960641fab81c45e
+  data.tar.gz: 8970b724e8e85d62220a8755ed24fb4403a75d2a612c51dd8d580c311fb0738b
 SHA512:
-  metadata.gz: 88c53ecfb3d2322c4f2ed6cc99c58e3e5cdb9b135b9afaae85a183f95d23d1546c0c7d245547dfe968574849689508e0669dda8648c3a0cb123251672895d442
-  data.tar.gz: 2d2d289ef46a002ff548fb7a219805a8c6fcbd555f469f4f8bb8eb87bc6895df48e83d8694ec262251d87997a2f2d325120f608f491df76ef9c47f83be1cc0e2
+  metadata.gz: 0ea5ef78c667d3bc1208d3be9e70ca4b67fc449e840f6875f392eb315de472d2807840cab6a523f34baf18a9568e29b8ef1542de3c7c21fd68b9dd7e0b227331
+  data.tar.gz: 392a38d2997cfb3ee1726d7c76bd3fe0d05f073bd77179e588f7d2db0eb016eaee7732ba3340f88f13c3bf740f80764cde001124fee63d416cf07c8cc7febb41

data/CHANGELOG.md

@@ -1,5 +1,68 @@
 # Changelog
 
+## [0.15.1](https://github.com/elektronaut/badline/compare/v0.15.0...v0.15.1) (2026-10-12)
+
+
+### Features
+
+* add the 1551 disk drive, booting its DOS headless ([db03667](https://github.com/elektronaut/badline/commit/db036672799acae2ea13a1b16780875547d74eb6))
+* add the 1551 disk drive, booting its DOS headless ([1f4db55](https://github.com/elektronaut/badline/commit/1f4db555eeb86da755241870a40c75e5441f5894))
+* emulate the Plus/4's 6551 ACIA ([8b1cc23](https://github.com/elektronaut/badline/commit/8b1cc236d7dc5c7e48c772c9256416c1011d2526))
+* emulate the Plus/4's 6551 ACIA ([06bf40f](https://github.com/elektronaut/badline/commit/06bf40f1f618db8decb25fe4d95577a035e9e903))
+* fit a Plus/4 or C16 with a Hannes or Csory RAM expansion ([14bc152](https://github.com/elektronaut/badline/commit/14bc15249914f4ecdb42212ab39d28dc4f2ee557))
+* fit a Plus/4 or C16 with a Hannes or Csory RAM expansion ([85baeba](https://github.com/elektronaut/badline/commit/85baeba267ef6f8e0243444ecd849260a22588de))
+* fit a Plus/4 or C16 with a SID card ([0ed886d](https://github.com/elektronaut/badline/commit/0ed886d5fe10e40223d9de330e38df8501bbbbfc))
+* fit a Plus/4 or C16 with a SID card ([2ae2e19](https://github.com/elektronaut/badline/commit/2ae2e197f783465a8b85c74ca6c78afdc071a66c))
+* machine_diff --family plus4 ([c479566](https://github.com/elektronaut/badline/commit/c479566180254a841d1b6e998089b8ca64ac6a48))
+* machine_diff --family plus4 ([55702f1](https://github.com/elektronaut/badline/commit/55702f10deb8e4f3775d7387a531ef7dbf4a6834))
+* make the 1551 the Plus/4's default true drive ([e3d3120](https://github.com/elektronaut/badline/commit/e3d312099478c71b59088ca4070cd839aabaac46))
+* make the 1551 the Plus/4's default true drive ([e275808](https://github.com/elektronaut/badline/commit/e27580834142351c3bfb4a088b2128bc52885036))
+* name the cartridge on the Expansion port page of every machine ([beab6e5](https://github.com/elektronaut/badline/commit/beab6e58a0aa9a374789645bb18e5c82d50fc0c8))
+* name the cartridge on the Expansion port page of every machine ([6e08889](https://github.com/elektronaut/badline/commit/6e08889edc1de913289ddfd03b75d79b6c42d994))
+* put a true 1551 on the Plus/4's TCBM with --drive-type 1551 ([1d0f9f4](https://github.com/elektronaut/badline/commit/1d0f9f42f622e5e00db1c63dd8413fb7484dd65a))
+* put a true 1551 on the Plus/4's TCBM with --drive-type 1551 ([ba8b9a3](https://github.com/elektronaut/badline/commit/ba8b9a3816300840f6b6fe8138427b81814f3957))
+* put the Plus/4's SID card at $FE80 with --sid-card-address ([da597a2](https://github.com/elektronaut/badline/commit/da597a240f77a870e610f3c186d1afd4f234695a))
+* put the Plus/4's SID card at $FE80 with --sid-card-address ([893c5eb](https://github.com/elektronaut/badline/commit/893c5eb08ca1617c5bced97501e9b8bcae443bb5))
+* save a 1551 in the Plus/4's snapshots ([8c2edad](https://github.com/elektronaut/badline/commit/8c2edadd246985d294b68ae5f46f572691d7045c))
+* save a 1551 in the Plus/4's snapshots ([06313fe](https://github.com/elektronaut/badline/commit/06313fe5de493ff8d92047ea4b2adc815d84d7b7))
+
+
+### Bug Fixes
+
+* clock the extra SIDs in C64#cycle! ([7fc8b71](https://github.com/elektronaut/badline/commit/7fc8b719702b90b43df822162c7fde48d1205409))
+* clock the extra SIDs in C64#cycle! ([016a9c4](https://github.com/elektronaut/badline/commit/016a9c4517be052db809bfc42345eedf296f3fbc))
+* read the register log's seed by index for Spinel ([d9b3c43](https://github.com/elektronaut/badline/commit/d9b3c43ef51c81faf471018a85721753450949e0))
+* refuse a .crt with a chip in an unmapped bank on the command line ([15b4060](https://github.com/elektronaut/badline/commit/15b4060afe320df465da5f767c21d69ccf93d3bc))
+* refuse a .crt with a chip in an unmapped bank on the command line ([c8c51fc](https://github.com/elektronaut/badline/commit/c8c51fc2f98deae8eaad1c671987c5b726cb4ba5))
+* refuse a cartridge with a chip in a bank the machine doesn't map ([c2bee2a](https://github.com/elektronaut/badline/commit/c2bee2a4ee01b5959a465b7d72034a9be7ec3bf3))
+* refuse a cartridge with a chip in a bank the machine doesn't map ([d08f37e](https://github.com/elektronaut/badline/commit/d08f37e2b2ff0207b1173aee2f467e4f9e71f685))
+* save the datasette's recording state in snapshots ([ba8e5e8](https://github.com/elektronaut/badline/commit/ba8e5e8dbcf088449324d66f30f8bbfe15e80210))
+* save the datasette's recording state in snapshots ([b155546](https://github.com/elektronaut/badline/commit/b1555467f70a1d2db4117ab43e623f8a060a4a3f))
+* take --frames in the SID player ([b9a54f3](https://github.com/elektronaut/badline/commit/b9a54f3c7bb84edd67c69ee38efb4f5f79347760))
+* take --frames in the SID player ([3483684](https://github.com/elektronaut/badline/commit/3483684fe8efdf2b828d85db98c9e4c1667293a4))
+* take a Plus/4 .bin cartridge from Quick open and drag and drop ([214dcd6](https://github.com/elektronaut/badline/commit/214dcd63bc48956d0f2139d89bab63613dde78d7))
+* take a Plus/4 .bin cartridge from Quick open and drag and drop ([32ec8d0](https://github.com/elektronaut/badline/commit/32ec8d0deb54000a1c2b956a02ad26b53ef2cf6d))
+* type ACIA#feed's bytes for Spinel ([32b9f72](https://github.com/elektronaut/badline/commit/32b9f72a7ad24cd862531d19e545e117c7e8e340))
+
+
+### Performance Improvements
+
+* check the init threshold and the ACIA with one compare ([b0050a7](https://github.com/elektronaut/badline/commit/b0050a7a4716e21551882f10c0811a6f0284686a))
+* count the SID card's cycles when it is touched ([d0cec9c](https://github.com/elektronaut/badline/commit/d0cec9c9d9144bb2303d0cba0b182dcf705d1b32))
+* look in on the ACIA's IRQ only when it is due ([d099091](https://github.com/elektronaut/badline/commit/d09909138087a305ce59384dafbece7ef08f340a))
+* sleep the 1551 through its idle loop ([3fabf2a](https://github.com/elektronaut/badline/commit/3fabf2ab6f866bf088682b14e5f04e4dd9054d29))
+* sleep the 1551 through its idle loop ([8d99fa3](https://github.com/elektronaut/badline/commit/8d99fa3ac22f862a51e967dc5a69471dece782da))
+
+
+### Reverts
+
+* find the longest G64 track with a splat again ([31a3df2](https://github.com/elektronaut/badline/commit/31a3df2d35ab79a072a46213d5996068eaa2d793))
+
+
+### Miscellaneous Chores
+
+* release 0.15.1 ([23586fb](https://github.com/elektronaut/badline/commit/23586fbc26b2132c4a8afe04d44cbeaed6b0eb12))
+
 ## [0.15.0](https://github.com/elektronaut/badline/compare/v0.14.0...v0.15.0) (2026-10-12)
 
 

data/CLAUDE.md

@@ -239,6 +239,13 @@ the rows your change can't reach tell you nothing about it.
 - For a change whose reach you can't bound to a set of filters, such as
   reordering `C64#cycle!` or changing the LOAD trap every suite loads
   through, push and let CI run the suites
+- Each Spinel harness compiles only the code its own entry point reaches.
+  A method nothing in a harness calls, such as a host-side API only the
+  window uses, is compiled only by `native/badline.rb`, with untyped
+  arguments, and can fail there alone. A change that adds such a method
+  builds the native binary locally (`rake native:build`; on macOS with
+  `SPINEL_CC="cc -Wno-nullability-completeness"`) before it's pushed, or
+  types its arguments in `spinel/sig`
 - The Regression workflow runs the suites on CRuby, started by hand from
   the Actions tab, for a person checking that CRuby and Spinel agree.
   Agents don't start it

data/README.md

@@ -81,11 +81,15 @@ differences noted in the table. `--help` lists the options for either.
 | --- | --- |
 | `--no-autostart` | Attach the media and stop at `READY.`, so you can type the `LOAD` yourself |
 | `--writable` | Let the machine write to disk images. Without it, a disk goes in write-protected: the drive reports `26,WRITE PROTECT ON` for any write and the image file stays as it was |
-| `--true-drive` | Put an emulated 1541 on device 8 instead of the KERNAL traps. See [Media](#media) |
+| `--true-drive` | Put an emulated 1541 on device 8 instead of the KERNAL traps, or a 1551 on the Plus/4. See [Media](#media) |
+| `--drive-type 1541` | On the Plus/4, make the true drive on device 8 an emulated 1541 on the serial bus in place of the 1551. It implies `--true-drive`. See [The Plus/4](#the-plus4) |
 | `-s`, `--subtune N` | Pick a subtune of a `.sid` file, counting from 1 |
 | `--sid 6581`, `--sid 8580` | Fit the older or newer SID. `--sid auto`, the default, takes a `.sid` tune's own |
 | `--ram SIZE` | Give a VIC-20 the RAM expansion `SIZE`: `unexpanded`, `3k`, `8k`, `16k`, `24k`, `32k` or `all`. Without it, the VIC-20 gets the expansion its media needs. See [The VIC-20](#the-vic-20). On the Plus/4, `16k`, `32k` or `64k` of RAM in place of the model's own |
 | `--c1lo FILE`, `--c1hi FILE`, `--c2lo FILE`, `--c2hi FILE` | Put a raw `.bin` ROM image in one of the Plus/4's cartridge slots: cartridge 1 or 2, low (`$8000`) or high (`$C000`). See [The Plus/4](#the-plus4) |
+| `--sid-card 6581`, `--sid-card 8580` | Fit a Plus/4 or C16 with a SID card at `$FD40`. See [The Plus/4](#the-plus4) |
+| `--sid-card-address fd40`, `--sid-card-address fe80` | Put the SID card at `$FD40` (the default) or at `$FE80` |
+| `--ram-expansion NAME` | Fit a Plus/4 or C16 with a RAM expansion: `hannes256`, `hannes1m` or `csory256`. See [The Plus/4](#the-plus4) |
 | `--reu SIZE` | Plug in a RAM Expansion Unit of `SIZE` K: 128, 256, 512 (a 1750) or up to 16384 |
 | `--model NAME` | Run another model of the machine, named as in VICE. For the C64: `c64` (the default, a PAL C64 with the 6569 VIC-II, 6526 CIAs and the 6581 SID), `c64c` (the PAL C64C, with the 8565, 6526As and the 8580), `ntsc` (the 6567R8), `newntsc` (the NTSC C64C, with the 8562, 6526As and the 8580), `oldntsc` (the first NTSC C64s' 6567R56A), `drean` (the Drean C64 of Argentina, PAL-N with the 6572), `sx64` (the portable SX-64, with its own KERNAL and no datasette), `pet64` (the PET 64 or Educator 64, a PAL C64 in a PET's case with its own KERNAL and a green monochrome monitor) `c64gs` (the C64GS games console, a PAL C64C with its own BASIC and KERNAL, and no keyboard or datasette) or `ultimax` (the MAX Machine of Japan, NTSC with 2K of RAM, one CIA and no ROMs, which runs only a cartridge). `--sid` or a `.sid` tune's own SID takes the model's place. The VIC-20, the C128 and the Plus/4 have models of their own: see their sections |
 | `--ntsc` | Run an NTSC C64, as `--model ntsc` does |
@@ -102,7 +106,7 @@ differences noted in the table. `--help` lists the options for either.
 
 | Option | Effect |
 | --- | --- |
-| `--frames N` | Quit after N frames |
+| `--frames N` | Quit after N frames, in the SID player as in the machine's window |
 | `--unpaced` | Run as fast as it can, without vsync or pacing |
 | `--at FRAME:EVENT` | Press keys, type, swap media, open the pause menu or take a screenshot once `FRAME` frames have run |
 | `--script FILE` | Run the events in `FILE`, one `FRAME:EVENT` a line |
@@ -253,10 +257,29 @@ as xplus4's options do:
 badline plus4 --c1lo game-low.bin --c1hi game-high.bin
 ```
 
-Disks go through the KERNAL traps or, with `--true-drive`, a 1541 or a
-1581 on the serial bus. There is no 1551 yet. The pause menu's Power
-page names the model and its RAM, and its Expansion port page shows the
-slots that hold a cartridge and takes them all out. `F11` and the
+`--sid-card 6581` or `--sid-card 8580` fits a SID card, as third
+parties built for the 264s, with its SID at `$FD40`-`$FD5F`. The card
+clocks the SID at the TED's single clock, 886,724 Hz on PAL, so a C64
+tune plays about a semitone flat, as it did on those cards. Its sound
+plays with the TED's, and the Sound page swaps its SID's model.
+`--sid-card-address fe80` puts the SID at `$FE80`-`$FE9F` instead, as
+Csory's card does, beside a 1551's TCBM interface at `$FEC0`.
+
+`--ram-expansion hannes256` or `hannes1m` fits Hannes's 256K or 1M RAM
+expansion, which banks 64K at a time through its register at `$FD16`,
+above `$1000` or `$4000`, with the TED fetching from the CPU's bank or
+the standard one. `csory256` fits the 256K board with Csory's mapping
+as well, which puts one of 16 blocks of 16K in a window that `$FD15`
+picks. Each needs 64K of the machine's own, and a C16 gets that much.
+
+Disks go through the KERNAL traps or, with `--true-drive`, a 1551 on
+device 8, on TCBM, the parallel cable to its interface in the expansion
+port, on the C16 as on the Plus/4. `--drive-type 1541` puts a 1541 on
+the serial bus there instead, and a `.d81` goes in a 1581 on the serial
+bus. The pause menu's Power
+page names the model, its RAM and a RAM expansion, and its Expansion port page names the
+cartridges in, or the slot of one a snapshot put in, and takes them all
+out. `F11` and the
 Snapshots page save it as they do the others, but not for VICE.
 [Input](#input) lists its keys.
 
@@ -368,7 +391,7 @@ too.
 | Snapshots | Quicksave, save under a name, load a named save, and the latest quicksaves and autosaves |
 | Drive 8 | The disk: insert, eject, the previous or next disk of its set, and whether it's writable |
 | Datasette | The tape: insert, eject, PLAY and REWIND |
-| Expansion port | The cartridge: insert, remove, and its freeze button if it has one. On the Plus/4, the slots that hold one |
+| Expansion port | The cartridge's name: a `.crt`'s own, or a raw image's file name. Insert, remove, and its freeze button if it has one. On the VIC-20, the cartridge and the RAM expansion |
 | Ports | The device in each control port, and where the keys go |
 | Sound | Mute, and the SID's model |
 | Power | Reset, power cycle and quit, on a C128 its model and mode, and on a Plus/4 its model and RAM |
@@ -384,7 +407,9 @@ inserting or removing a cartridge does, since each power cycles the
 machine.
 
 A disk, list of disks or tape dropped on the window goes into its drive. A cartridge,
-program or `.sid` dropped on it opens the menu to ask first.
+program or `.sid` dropped on it opens the menu to ask first. On the Plus/4, a
+`.bin` ROM image dropped or opened with Quick open is a cartridge, and goes
+in cartridge 1 as it does from the command line.
 
 ## What's emulated
 
@@ -415,8 +440,10 @@ program or `.sid` dropped on it opens the menu to ask first.
   timers and the CPU's single and double clock, 16K to 64K of RAM, ROM
   banking with the 3-plus-1 function ROMs, the keyboard and both
   joysticks, cartridges in both slots, the datasette and the serial bus
-  to device 8, PAL and NTSC (`badline plus4`). The ACIA's registers are
-  there but send and receive nothing.
+  to device 8, PAL and NTSC (`badline plus4`). The 6551 ACIA sends and
+  receives at its baud rates, with nothing on the user port; Ruby code
+  driving the machine can plug in a terminal, whose bytes it feeds and
+  drains, or a loopback plug (`Plus4::ACIA#plug`).
 - **1541**: an emulated drive running its own DOS (`--true-drive`).
 - **1571**: the C128D's drive running DOS 3.0, in 1541 mode and in 1571
   mode at 2 MHz with both sides of a `.d71` or `.g71`, and fast serial
@@ -424,6 +451,9 @@ program or `.sid` dropped on it opens the menu to ask first.
 - **1581**: the 3.5" drive running its own DOS on its WD1772 and 8520,
   reading and writing `.d81` images, on the C64, the VIC-20, the C128 and the Plus/4
   (`--true-drive` with a `.d81`).
+- **1551**: the 264 series' parallel drive, its 6510T running its own DOS
+  at 2 MHz with the 1541's mechanism, on TCBM to a Plus/4 or a C16
+  (`badline plus4 --true-drive`).
 - **Cartridges**: standard 8K, 16K and Ultimax, Simons' BASIC, Ocean,
   Fun Play / Power Play, Super Games, Epyx FastLoad, Westermann
   Learning, Rex Utility, C64 Game System / System 3, Dinamic, Zaxxon /

data/doc/media.md

@@ -34,6 +34,10 @@ or directories. Loading runs at the speed of a real 1541, and the
 drive's red activity LED and green power LED light in the bottom right
 corner of the border. A 1581 flashes its power LED after an error.
 
+On the Plus/4 and the C16, `--true-drive` puts an emulated 1551 there
+instead, on TCBM, the parallel cable to its interface in the expansion
+port, and `--drive-type 1541` a 1541 on the serial bus.
+
 A `.g64` holds the disk's raw GCR, half tracks and all, so copy
 protection and fast loaders that read it work.
 
@@ -99,6 +103,21 @@ the entries after a `UNIT 8` line, or before any `UNIT` line, count.
 `Media.attach` and the command line take a list as media and attach its
 first disk.
 
+## Recording to tape
+
+From Ruby, a blank tape made with
+`Badline::Storage::TAP.create(path, platform:)` (0 for the C64, 1 for
+the VIC-20, 2 for the Plus/4 and the C16) goes in the datasette with
+`computer.datasette.insert`, `record!` presses RECORD and PLAY, and
+`stop!` lets them up and writes the tape to its file. The C64 and the
+VIC-20 record version 1 TAPs, and the Plus/4 and the C16 version 2 TAPs
+of half waves.
+
+A program SAVEd that way on the C64 loads and runs in VICE's x64sc, on
+the VIC-20 in xvic, and on the Plus/4 or the C16 in xplus4 as a Plus/4.
+Neither the Plus/4's tape nor the C16's ran on xplus4's C16 model.
+Checked with VICE 3.10.
+
 ## The light pen
 
 Control port 1's fire line is also the VIC-II's light pen input, so

data/doc/snapshot-format.md

@@ -31,7 +31,7 @@ Written by the C64, VIC-20, C128, Plus/4.
 | `vic_model` | text: mos6569 mos8565 mos8566 mos8564 | C64: "mos6569" |
 | `cia_model` | text: mos6526 mos6526a | C64: "mos6526" |
 | `sid_model` | text: mos6581 mos8580 | C64: "mos6581"; C128: "mos6581" |
-| `ram_expansion` | text: none plus60k plus256k | C64: "none" |
+| `ram_expansion` | text: none plus60k plus256k | C64: "none"; Plus/4: "none" |
 | `reu_kb` | int | C64: 0 |
 | `kernal` | text: c64 sx64 pet64 gs | C64: "c64" |
 | `datasette` | bool | C64: true |
@@ -62,7 +62,9 @@ Written by the C64, VIC-20, C128, Plus/4.
 | `host.typist.wait` | int | C128: 0 |
 | `host.typist.typing` | bool | C128: false |
 | `ram_kb` | int | Plus/4: 64 or 16 |
+| `sid_card` | text: none mos6581 mos8580 | Plus/4: "none" |
 | `tcbm` | bool | Plus/4: false |
+| `sid_card_address` | int | Plus/4: 64832 |
 
 ## BL-RAM
 
@@ -376,7 +378,7 @@ Written by the C64, C128.
 
 ## BL-SID
 
-Written by the C64, C128.
+Written by the C64, C128, Plus/4.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -424,6 +426,9 @@ Written by the C64, VIC-20, C128, Plus/4.
 | `playing` | bool | false |
 | `motor` | bool | false |
 | `countdown` | int | 0 |
+| `recording` | bool | false |
+| `since` | int | 0 |
+| `write_high` | bool | C64: false; VIC-20: true; C128: false; Plus/4: true |
 | `rise_at` | int | 0 |
 | `low_recorded` | bool | false |
 | `tape.bytes` | bytes | [] |
@@ -432,13 +437,16 @@ Written by the C64, VIC-20, C128, Plus/4.
 
 ## BL-RAMEXP
 
-Written by the C64.
+Written by the C64, Plus/4.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `d100` | byte | 0 |
-| `locked` | bool | false |
-| `bank<N>` | bytes | 65536 × 0 |
+| `d100` | byte | C64: 0 |
+| `locked` | bool | C64: false |
+| `bank<N>` | bytes | C64: 65536 × 0 |
+| `control` | byte | Plus/4: 255 |
+| `csory_latch` | byte | Plus/4: 0 |
+| `ram` | bytes | Plus/4: 196608 × 0 |
 
 ## BL-REU
 
@@ -568,12 +576,14 @@ Written by the C64, C128, Plus/4.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `model` | text: 1541 1571 1581 | C64: "1541" or "1581"; C128: "1541" or "1571"; Plus/4: "1541" |
+| `model` | text: 1541 1551 1571 1581 | C64: "1541" or "1581"; C128: "1541" or "1571"; Plus/4: "1541" or "1551" |
 | `phase` | int | 0 |
 | `cycles` | int | 0 |
 | `so_pending` | bool | false |
 | `serial.host` | int | C64: 255; C128: 255; Plus/4: 0 |
 | `atn` | bool | C64: true |
+| `irq_timer` | int | Plus/4: 16660 |
+| `latched_byte` | byte | Plus/4: 0 |
 
 ## BL-D8-RAM
 
@@ -581,7 +591,7 @@ Written by the C64, C128, Plus/4.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `data` | byte | C64: 234 or 175; C128: 234; Plus/4: 234 |
+| `data` | byte | C64: 234 or 175; C128: 234; Plus/4: 234 or 233 |
 | `ram` | bytes | C64: 2048 × 0 or 8192 × 0; C128: 2048 × 0; Plus/4: 2048 × 0 |
 
 ## BL-D8-VIA1
@@ -686,7 +696,7 @@ Written by the C64, C128, Plus/4.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `pc` | word | C64: 60064 or 44836; C128: 60064; Plus/4: 60064 |
+| `pc` | word | C64: 60064 or 44836; C128: 60064; Plus/4: 60064 or 59829 |
 | `sp` | byte | 255 |
 | `a` | byte | 0 |
 | `x` | byte | 0 |
@@ -727,10 +737,10 @@ Written by the C64, C128, Plus/4.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `half_track` | int | C64: 35; C128: 37; Plus/4: 35 |
+| `half_track` | int | C64: 35; C128: 37; Plus/4: 35 or 36 |
 | `slip` | int & 0x3 | C64: 0; C128: 2; Plus/4: 0 |
 | `side` | int | C64: 0 or 1; C128: 85; Plus/4: 0 |
-| `zone` | int & 0x3 | 3 |
+| `zone` | int & 0x3 | C64: 3; C128: 3; Plus/4: 3 or 0 |
 | `time` | int | 0 |
 | `read_clock_in` | int | 2097152 |
 | `clocks` | int | 0 |
@@ -738,8 +748,8 @@ Written by the C64, C128, Plus/4.
 | `ones` | int | 0 |
 | `bits` | int | 0 |
 | `write_shift` | int | 0 |
-| `motor` | bool | C64: true or false; C128: true; Plus/4: true |
-| `led` | bool | true |
+| `motor` | bool | C64: true or false; C128: true; Plus/4: true or false |
+| `led` | bool | C64: true; C128: true; Plus/4: true or false |
 | `sync` | bool | false |
 | `byte_ready` | bool | false |
 | `byte_latched` | bool | false |
@@ -1175,6 +1185,15 @@ Written by the Plus/4.
 | --- | --- | --- |
 | `command` | byte | 0 |
 | `control` | byte | 0 |
+| `errors` | int & 0x7 | 0 |
+| `receiver_full` | bool | false |
+| `transmitter_empty` | bool | true |
+| `irq` | bool | false |
+| `receive_data` | byte | 0 |
+| `transmit_data` | byte | 0 |
+| `shifting` | int | -1 |
+| `transmit_remainder` | int | 0 |
+| `transmit_at` | int, optional | absent |
 
 ## BL-TIA1
 
@@ -1195,3 +1214,32 @@ Written by the Plus/4.
 | `ports` | ints | [0, 0, 0] |
 | `directions` | ints | [0, 0, 0] |
 | `inputs` | ints | [0, 0, 0] |
+
+## BL-D8-PORT
+
+Written by the Plus/4.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ddr` | byte | 0 |
+| `data` | byte | 0 |
+
+## BL-D8-TIA
+
+Written by the Plus/4.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ports` | ints | [0, 0, 0] |
+| `directions` | ints | [0, 0, 0] |
+| `inputs` | ints | [255, 255, 255] |
+
+## BL-D8-HOSTTIA
+
+Written by the Plus/4.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ports` | ints | [0, 0, 0] |
+| `directions` | ints | [0, 0, 0] |
+| `inputs` | ints | [255, 3, 192] |

data/exe/badline-ruby

@@ -39,7 +39,7 @@ if options.headless?
   console = if options.player_window?
               lambda do |input:, output:|
                 load_sdl
-                Badline::Frontend::PlayerController.new(input:, output:)
+                Badline::Frontend::PlayerController.new(input:, output:, frames: options.frames)
               end
             else
               Badline::Audio::Console.method(:new)

data/lib/badline/audio/machine_player.rb

@@ -19,8 +19,6 @@ module Badline
         @subtune = subtune || tune.start_subtune
         @computer = C64.new(sid_model: sid_models[0])
         @stereo = Stereo.new(@computer.address_bus, tune, sid_models)
-        @extras = @stereo.extras
-        @multi = !@extras.empty?
         region = @computer.region
         @frame_cycles = region.cycles_per_line * region.lines_per_frame
         @injected = false
@@ -30,7 +28,7 @@ module Badline
       def start
         @computer.on_init { inject }
         @computer.cpu.install_trap(@tune.entry_address) { begin_playing }
-        step until @started || @computer.cycles > START_LIMIT
+        @computer.cycle! until @started || @computer.cycles > START_LIMIT
       end
 
       attr_reader :stereo
@@ -56,23 +54,13 @@ module Badline
       # Returns the cycles advanced.
       def frame(budget, &)
         cycles = [budget, @frame_cycles].min
-        if @multi
-          cycles.times { step }
-        else
-          cycles.times { @computer.cycle! }
-        end
+        cycles.times { @computer.cycle! }
         @stereo.mix(&)
         cycles
       end
 
       private
 
-      # The extra SIDs clock ahead of the CPU, as the machine's own does.
-      def step
-        @extras.each(&:cycle!) if @multi
-        @computer.cycle!
-      end
-
       def inject
         @computer.ram.write(@tune.load_address, @tune.data)
         @tune.boot_memory(subtune: @subtune).each { |address, bytes| @computer.ram.write(address, bytes) }

data/lib/badline/c64/true_drives.rb

@@ -9,7 +9,7 @@ module Badline
       include Drives::Model1581::Slot
 
       # The true drive models a snapshot names.
-      DRIVE_MODELS = %w[1541 1571 1581].freeze
+      DRIVE_MODELS = %w[1541 1551 1571 1581].freeze
 
       # Plugs in a Drives::Model1541, which then runs alongside the machine on its
       # own clock and talks to it over the serial bus. The serial traps stop
@@ -44,6 +44,7 @@ module Badline
         drive1581 = @drive1581
         drive1581&.save_modules(sections, "BL-D#{drive1581.device}")
         save_drive1571_modules(sections)
+        save_drive1551_modules(sections)
         sections
       end
 
@@ -63,6 +64,7 @@ module Badline
         detach_drive1541 unless models.include?("1541")
         detach_drive1581 unless models.include?("1581")
         detach_drive1571 unless models.include?("1571")
+        detach_drive1551 unless models.include?("1551")
       end
 
       # Unplugs the Drives::Model1541, leaving the serial bus with nothing on it.
@@ -91,6 +93,7 @@ module Badline
         case model
         when "1581" then load_drive1581_modules(modules, input, device)
         when "1571" then load_drive1571_modules(modules, input, device)
+        when "1551" then load_drive1551_modules(modules, input, device)
         else load_drive1541_modules(modules, input, device)
         end
       end
@@ -115,6 +118,15 @@ module Badline
       end
 
       def detach_drive1571 = nil
+
+      # The 264 series' 1551, which only the Plus/4 has (Plus4::TCBMDrive).
+      def save_drive1551_modules(sections) = sections
+
+      def load_drive1551_modules(_modules, input, _device)
+        input.adjust("a 1551 doesn't plug into this machine, left out")
+      end
+
+      def detach_drive1551 = nil
     end
   end
 end

data/lib/badline/c64.rb

@@ -68,6 +68,7 @@ module Badline
       @cia1 = @address_bus.cia1
       @cia2 = @address_bus.cia2
       @sid = @address_bus.sid
+      @extra_sids = @address_bus.extra_sids
       @datasette = @address_bus.datasette
       @cycles = 0
       @nmi_asserted = false
@@ -100,6 +101,7 @@ module Badline
       @cia1.cycle!
       @cia2.cycle!
       @sid.cycle!
+      clock_extra_sids unless @extra_sids.empty?
       @datasette.cycle!
 
       @cpu.irq = @cia1.interrupted? || @vic.interrupted? || @reu_irq
@@ -202,6 +204,10 @@ module Badline
       reu
     end
 
+    # The SIDs fitted past the first, which clock ahead of the CPU as the
+    # first does.
+    def clock_extra_sids = @extra_sids.each(&:cycle!)
+
     # BA halts the CPU on a read cycle, and so does an REU holding the bus
     # for a transfer.
     def clock_cpu

data/lib/badline/chips/tia.rb

@@ -9,20 +9,28 @@ module Badline
     #
     # A pin read as an output returns what the port drives, and one read as
     # an input returns what the other side drives, #inputs, per port.
+    #
+    # A cable plugged in (Drives::Model1551::Cable) hears every write and
+    # reset, which can move the pins it carries.
     class TIA
       attr_reader :ports, :directions
 
       # What the other side drives onto each port's pins.
       attr_reader :inputs
 
+      # The cable to the other side, or nil.
+      attr_accessor :cable
+
       def initialize
         @inputs = [0, 0, 0]
+        @cable = nil
         reset!
       end
 
       def reset!
         @ports = [0, 0, 0]
         @directions = [0, 0, 0]
+        @cable&.moved
       end
 
       def peek(addr)
@@ -43,6 +51,14 @@ module Badline
         else
           @ports[register] = value
         end
+        @cable&.moved
+      end
+
+      # The levels on +port+'s pins as the chip leaves them: an output's
+      # level, and 1 for an input, which the chip doesn't drive.
+      def output(port)
+        direction = @directions[port]
+        (@ports[port] & direction) | (~direction & 0xff)
       end
 
       # The ports, their directions and what the other side drives, in a

data/lib/badline/chips/vic/register_log.rb

@@ -43,7 +43,10 @@ module Badline
         # register back at the value it held when the line started.
         def rewind
           @values.length.times { |reg| @values[reg] = @registers[reg] }
-          @seed.each_with_index { |value, reg| @values[reg] = value unless value.nil? }
+          @seed.each_index do |reg|
+            value = @seed[reg]
+            @values[reg] = value unless value.nil?
+          end
           @cursor = 0
           @next_x = @entries.empty? ? Float::INFINITY : @entries[0][0]
         end

data/lib/badline/drives/datasette/keyed_state.rb

@@ -4,15 +4,17 @@ module Badline
   module Drives
     class Datasette
       # The datasette's fields in a keyed snapshot module (Snapshot::Keyed,
-      # BL-TAPE): the keys, the motor, the countdown to the next pulse, and
-      # a tape in it under tape.*: its path, its bytes and how far it has
-      # played. A tape that isn't in leaves tape.* out. A datasette that
+      # BL-TAPE): the keys, the motor, the countdown to the next pulse,
+      # whether it records, the cycles since the write line's last edge and
+      # that line's level, and a tape in it under tape.*: its path, its
+      # bytes and how far it has played. A tape that isn't in leaves tape.* out. A datasette that
       # times the read line's level adds when in the countdown the line
       # rises, and whether a recording's low half wave is on the tape. The
       # sense and flag handlers don't fire on load.
       module KeyedState
         def save_fields(out)
           out.bool("playing", @playing).bool("motor", @motor).int("countdown", @countdown)
+          out.bool("recording", @recording).int("since", @since).bool("write_high", @write_high)
           out.int("rise_at", @rise_at).bool("low_recorded", @low_recorded) if @level
           tape = @tape
           return out unless tape
@@ -26,6 +28,9 @@ module Badline
           @playing = input.bool("playing", @playing)
           @motor = input.bool("motor", @motor)
           @countdown = input.int("countdown", @countdown)
+          @recording = input.bool("recording", @recording)
+          @since = input.int("since", @since)
+          @write_high = input.bool("write_high", @write_high)
           @rise_at = input.int("rise_at", @rise_at)
           @low_recorded = input.bool("low_recorded", @low_recorded)
           bytes = input.bytes("tape.bytes", "".b).bytes

data/lib/badline/drives/engine/core.rb

@@ -24,8 +24,11 @@ module Badline
       # sleeps through them too (see Orbit).
       #
       # A model includes Core and builds its parts, sets @clock_hz and
-      # @idle_loop, and runs one drive cycle in step. It hears ATN on
-      # connecting (hear_atn), drives the serial bus (serial_output), and
+      # @idle_loop, and runs one drive cycle in step. Its @serial_port faces
+      # the host: it says whether the host moved the lines the drive
+      # listens to (atn_moved?) and takes them for the next host cycle
+      # (latch_host), as the serial port does for ATN on the serial bus
+      # (SerialConnection) and the TCBM cable does on the 1551. The model
       # answers Idle's and Orbit's questions about its chips, as VIAs does
       # for the 1541 and the 1571.
       module Core
@@ -33,7 +36,7 @@ module Badline
         include Idle
         include Orbit
 
-        attr_reader :device, :serial_bus
+        attr_reader :device
 
         def cpu
           settle!
@@ -62,17 +65,6 @@ module Badline
           @host_clock_hz = clock_hz
         end
 
-        # Plugs the drive into a serial bus, leaving the one it was on. A drive
-        # starts out on a bus of its own, with nothing else on it.
-        def connect(serial_bus)
-          settle!
-          @serial_bus&.detach(self)
-          @serial_bus = serial_bus
-          @serial_port.bus = serial_bus
-          serial_bus.attach(self)
-          hear_atn
-        end
-
         # Puts a Disk in the drive (Disk.from_d64 makes one from an image).
         # Nil takes the disk out.
         def insert(disk)