badline 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcc4aea1603a5dac88787b701529e7019573fa5bd3b66cdd31a6d4f071fb3ecf
-  data.tar.gz: bc8de62e989822edd15ff2d59002a034c361c176e50a0e064a3482ff820b150a
+  metadata.gz: e262717ff30b8634c869b951cbb627fead4c6d4270cb0f9251cfadb567c0edef
+  data.tar.gz: 6c35c8a8313fe7de6de0d7df4a8436bebc160e1267e11132bd84c0be0abc50b0
 SHA512:
-  metadata.gz: 88c53ecfb3d2322c4f2ed6cc99c58e3e5cdb9b135b9afaae85a183f95d23d1546c0c7d245547dfe968574849689508e0669dda8648c3a0cb123251672895d442
-  data.tar.gz: 2d2d289ef46a002ff548fb7a219805a8c6fcbd555f469f4f8bb8eb87bc6895df48e83d8694ec262251d87997a2f2d325120f608f491df76ef9c47f83be1cc0e2
+  metadata.gz: b9de5e45e9ab8b0d8a18c98815599c6055f0fc1a44a2324f34f60753a3096d5c254edad42852e7bf0bf1507b1fb845512cca41117fb6f5f51988fa3a41be0204
+  data.tar.gz: 5102663a8eee7f811f9e88b81ff79948ad4f1011d790551a8d8bbba53de29c676f4055db0fe15a2e1085b0bbe3efee805e2db421ba5161b77c9abbaefb181623

data/CHANGELOG.md

@@ -1,5 +1,107 @@
 # Changelog
 
+## [0.16.0](https://github.com/elektronaut/badline/compare/v0.15.1...v0.16.0) (2026-10-17)
+
+
+### Features
+
+* add the 6520 PIA ([329bf8c](https://github.com/elektronaut/badline/commit/329bf8c04a6f8cc666ea1dfded4ec1a8431e07cc))
+* add the PET's IEEE trap layouts and keyboard buffer layouts ([f628ba2](https://github.com/elektronaut/badline/commit/f628ba26c661d1c539c28506e48a95504afd7fd3))
+* answer the debug register at $8BFF on every PET ([76f47ab](https://github.com/elektronaut/badline/commit/76f47ab67f834eb89451fb95134fae2abcadde36))
+* attach programs, disks and archives to the PET, .d80 and .d82 among them ([2094ee5](https://github.com/elektronaut/badline/commit/2094ee53ec3e94a1a7571d38b598212476cf738b))
+* boot the PET to READY headless ([b86044a](https://github.com/elektronaut/badline/commit/b86044a149cde620b41eac3c5a77db252e68c10c))
+* bundle the PET ROMs and refuse badline pet until it runs ([76591ff](https://github.com/elektronaut/badline/commit/76591ffc72c615f0c78649e4b29f0dc8e4a3775f))
+* count the PET's CRTC to the cycle and paint its picture ([59a010f](https://github.com/elektronaut/badline/commit/59a010fc1e5250f543c796ab0de464241b28dcae))
+* fit the 8032's other 50 Hz editor, 901474-04 dated 0283, with --editor 4-80-b-50hz-0283 ([b7b230f](https://github.com/elektronaut/badline/commit/b7b230f4032ba7145358cb60f1be1e370997c0e0))
+* let any machine's timing share a window pixel between its dots ([55f04e8](https://github.com/elektronaut/badline/commit/55f04e86871423f1b0121a4570763f501cb08db1))
+* paint the PET's discrete 40-column video ([2d4f5e6](https://github.com/elektronaut/badline/commit/2d4f5e6caac7c2a3d4e3abe5e8ef37185962dbc9))
+* play and record tapes on the PET's two cassette ports ([aea1a9d](https://github.com/elektronaut/badline/commit/aea1a9de8008ceb576e006520234fa7dc6b4a5e3))
+* play the PET's VIA CB2 as its sound ([cd24520](https://github.com/elektronaut/badline/commit/cd24520a8e87bce7938cae12d153e332f9be1f99))
+* read and write 8050 and 8250 disk images ([2196736](https://github.com/elektronaut/badline/commit/2196736d0e9c84146ce259e322c991a14e1fe69d))
+* run the PET and the CBM in the window with badline pet ([0ee8585](https://github.com/elektronaut/badline/commit/0ee8585ef6a2d789dbbbbf06af3a54a9f33fbbff))
+* save and restore the PET in keyed snapshots ([1dcbb75](https://github.com/elektronaut/badline/commit/1dcbb75785ce70ca6de7b6596970ce06a2275a30))
+* serve device 8 to the PET through traps on its IEEE-488 primitives ([7f72c7d](https://github.com/elektronaut/badline/commit/7f72c7d3d58e5520f32c62120a4ce0270f02893a))
+* show the PET in the window, with its keys, memory and model in the pause menu ([7e90498](https://github.com/elektronaut/badline/commit/7e9049864015e511c3db8455b2d5d6749ffc6ea3))
+* type on the PET's graphics and business keyboards by character from the window ([0797790](https://github.com/elektronaut/badline/commit/079779011880ffca5ecc7c67e6bcef9620147ca5))
+* type the PET's shifted keys with Alt, and name its pause-menu page KEYBOARD ([22b3059](https://github.com/elektronaut/badline/commit/22b305966dd44bdd813af71c3bb5e0a4e2202761))
+* wire the PET's key matrices and type into its keyboard buffer ([1f22475](https://github.com/elektronaut/badline/commit/1f22475b581ac95776a86c1dd27f2671afcfb90c))
+* write PET tapes and read a tape's platform from its header ([29ccd99](https://github.com/elektronaut/badline/commit/29ccd99629bb98c311842628be39c298aab12eb9))
+
+
+### Bug Fixes
+
+* keep the VIC-20's cartridge name in the machine and its snapshots ([4837ab1](https://github.com/elektronaut/badline/commit/4837ab10049309f39d1b5d3b2170e55ab9d21c76))
+* move a 1551's TCBM interface with its DEV line ([f934bcf](https://github.com/elektronaut/badline/commit/f934bcf6cd2058a4528521fb1e14f75b7d15021c))
+* record the Plus/4's true drive model in its snapshots ([9c8ddb1](https://github.com/elektronaut/badline/commit/9c8ddb1b355145382df4a2813a3e55769839f0c9))
+
+
+### Performance Improvements
+
+* sweep only the lines the last PET CRTC frame showed ([026b26a](https://github.com/elektronaut/badline/commit/026b26afc97ed72f32b2e6517a8df18de5d863d1))
+
+## [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

@@ -14,8 +14,8 @@ directory: `chips/vic.rb` is `Badline::Chips::VIC`.
   the VIC holds BA low). `c64/` holds the rest of the C64's board:
   `c64/bus.rb` handles banking and page-table dispatch, and
   `c64/banked_ram.rb` and `c64/banked_ram/` the +60K and +256K boards
-  that bank in extra RAM through `$D100`. `vic20.rb` and `vic20/`, and
-  `c128.rb` and `c128/`, are the other two families, and `machine.rb`
+  that bank in extra RAM through `$D100`. `vic20.rb` and `vic20/`, `c128.rb` and `c128/`,
+  `plus4.rb` and `plus4/`, and `pet.rb` and `pet/` are the other families, and `machine.rb`
   builds each by name. Every family reads and writes memory as its CPU
   sees it with `peek` and `poke`
 - **CPU**: `chips/cpu.rb` and `chips/cpu/`: the 6502 core
@@ -25,10 +25,11 @@ directory: `chips/vic.rb` is `Badline::Chips::VIC`.
   C128's Z80
 - **VIC-II**: `chips/vic.rb` and `chips/vic/`, covering the sequencer,
   sprites, graphics modes, border and register timing. `chips/vic_i.rb`
-  is the VIC-20's VIC-I and its sound, and `chips/vdc.rb` the C128's VDC
+  is the VIC-20's VIC-I and its sound, `chips/vdc.rb` the C128's VDC,
+  and `chips/crtc.rb` the PET's 6545 CRTC
 - **CIA**: `chips/cia.rb` and `chips/cia/` (timers, serial and the TOD
-  clock, `time_of_day.rb`). `chips/via.rb` is the 6522 of the VIC-20 and
-  the drives
+  clock, `time_of_day.rb`). `chips/via.rb` is the 6522 of the VIC-20, the
+  drives and the PET, and `chips/pia.rb` the PET's 6520 PIA
 - **REU**: `c64/reu.rb` and `c64/reu/`, the RAM Expansion Unit's
   registers and its DMA, which `C64#cycle!` clocks in place of the CPU
   while it holds the bus
@@ -70,7 +71,7 @@ file: `core.rb` requires their members one by one.
 | 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 |
 | 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` and the C16 with `--c16` |
+| 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 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 |
 | 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 |
@@ -239,6 +240,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
@@ -267,7 +275,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 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`); 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
 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/README.md

@@ -13,7 +13,7 @@ are modelled at the cycle level.
 It runs programs, disk and tape images, cartridges and SID tunes, and
 the SDL2 front end supports the keyboard, joysticks, game controllers,
 paddles and a 1351 mouse. It also runs a PAL VIC-20, as
-`badline vic20`, the C128, in C128 mode on 40 or 80 columns and in C64 mode, as `badline c128`, and the Plus/4, the C16 and the C116, as `badline plus4`. See [What's emulated](#whats-emulated) for the details.
+`badline vic20`, the C128, in C128 mode on 40 or 80 columns and in C64 mode, as `badline c128`, the Plus/4, the C16 and the C116, as `badline plus4`, and the PET and CBM, as `badline pet`. See [What's emulated](#whats-emulated) for the details.
 
 It comes in two builds of the same emulator:
 
@@ -70,7 +70,8 @@ from it.
 The first argument can name the machine, as in `badline c64 game.prg`.
 The C64 is the default, and `--model` picks which C64. See
 [The VIC-20](#the-vic-20) for `badline vic20`, [The C128](#the-c128)
-for `badline c128` and [The Plus/4](#the-plus4) for `badline plus4`.
+for `badline c128`, [The Plus/4](#the-plus4) for `badline plus4` and
+[The PET](#the-pet) for `badline pet`.
 
 `badline-ruby` takes the same media and the same options, with the
 differences noted in the table. `--help` lists the options for either.
@@ -81,13 +82,19 @@ 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 |
+| `--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, and on the PET `4k`, `8k`, `16k` or `32k` |
+| `--60hz` | Run a CRTC PET's 60 Hz editor in place of its 50 Hz one. See [The PET](#the-pet) |
+| `--basic VERSION`, `--editor NAME` | Fit a PET with an upgrade ROM its board takes: BASIC `1`, `2` or `4`, or an editor. See [The PET](#the-pet) |
 | `--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 |
+| `--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, the Plus/4 and the PET have models of their own: see their sections |
 | `--ntsc` | Run an NTSC C64, as `--model ntsc` does |
 | `--c64` | Start a C128 in C64 mode, holding `C=` at power-on. See [The C128](#the-c128) |
 | `--no-sound` | Don't play the SID (`badline` only, where sound is on by default) |
@@ -102,7 +109,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,13 +260,95 @@ 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.
 
+## The PET
+
+`badline pet` runs a CBM 8032, with BASIC 4 and 80 columns on a green
+screen, and takes programs, disks and tapes:
+
+```sh
+badline pet                         # READY., in BASIC 4
+badline pet game.prg                # Load and run a program
+badline pet game.d64                # Mount a disk image as device 8 and load it
+badline pet game.d82                # The same with an 8250's disk
+badline pet game.tap                # Insert a tape and load it
+badline pet --model 2001            # The first PET, with BASIC 1
+```
+
+`--model` picks the machine: `8032` (the default, 32K, 80 columns and
+the business keyboard), `8096` (an 8032 with the 64K board at `$FFF0`),
+`4032` (40 columns on a CRTC and the graphics keyboard), `3032` (the
+discrete 40-column board with BASIC 2), `3032b` (the same with the
+business keyboard) and `2001` (8K, BASIC 1 and the chiclet keyboard).
+`--ram 4k`, `8k` or `16k` fits less RAM in place of the model's own, as
+the 3008, 3016 and 4016 had.
+
+The 4032, 8032 and 8096 run their 50 Hz editor, and `--60hz` their
+60 Hz one. The others always run at 60 Hz. `--basic` fits the upgrade
+ROMs Commodore sold, with the editor that goes with them: BASIC 2 for the
+2001, and BASIC 4 for the 3032 and the 3032b. `--editor` names the editor
+instead, among those the board and its BASIC take. Each name is the
+BASIC, the keyboard, `n` for graphics or `b` for business, and on a CRTC
+board the columns and the frame rate: `1`, `2-n`, `2-b`, `4-n`, `4-b`,
+`4-40-n-50hz`, `4-40-n-60hz`, `4-80-b-50hz`, `4-80-b-50hz-0283` and
+`4-80-b-60hz`.
+
+The 8032 and the 8096 take two 50 Hz editors, both 901474-04 and read
+from different chips. `4-80-b-50hz`, the default, runs lines of 50
+cycles, 400 to a frame. `4-80-b-50hz-0283`, the chip dated 0283, runs
+lines of 64 cycles, 313 to a frame, with the screen's rows a scanline
+closer together and lower down. Both boot to the same READY.
+
+```sh
+badline pet --model 2001 --basic 2   # A 2001 with BASIC 2
+badline pet --model 3032 --basic 4   # A 3032 with BASIC 4, without a CRTC
+badline pet --editor 4-80-b-60hz     # An 8032 at 60 Hz, as --60hz runs it
+badline pet --editor 4-80-b-50hz-0283  # An 8032 with the other 50 Hz editor
+```
+
+BASIC 1, on the 2001, can't LOAD from a disk drive: its own ROM breaks
+the transfer, so `LOAD"NAME",8` finds the file and loads nothing. A
+disk given to `badline` still starts its first program on a 2001, which
+goes into memory as a program file does. `--basic 2`, the upgrade
+Commodore sold, loads from disk.
+
+A program loads at the start of BASIC, `$0401`, and runs. A `.d80`, a
+`.d82` or a tape made for the PET starts a PET without `pet`, but a
+program that loads at `$0401` starts a C64, since a VIC-20 with 3K loads
+there too. Disks go through the KERNAL traps on the IEEE-488 bus as
+device 8, and tapes play on cassette port 1. The keys type what the host's
+keys type, on either keyboard, and `Alt` adds the PET's `SHIFT`:
+[Input](#input) lists the rest. The pause
+menu's Power page names the model, its RAM and its frame rate, and its
+Expansion port page its RAM and the 8096's 64K board. The PET has no
+joysticks. `F11` and the Snapshots page save it as they do the others,
+but not for VICE.
+
 ## Snapshots
 
 `F11` quicksaves the whole machine to the next of five slots in
@@ -326,6 +415,30 @@ and put their own here:
 They have no `RESTORE`, `←` or `↑` key, so `Page Up`, `` ` `` and `]`
 press nothing.
 
+The PET types the characters on the host's keys, so Shift and `'` type
+`"` on the graphics keyboard, where `"` has a key of its own, and on the
+business keyboard, where it's `SHIFT` and `2`. Shift with a letter types
+the graphics character on its key. Either `Alt` with a key presses the
+PET's `SHIFT` and the key its unshifted character is on, so `Alt` and
+`'` type the graphics character on the graphics keyboard's `'` key, and
+on the business keyboard the character `SHIFT` gives that key. The keys
+without a character are here, with the pause menu's Keyboard page
+listing them too:
+
+| PET | Host |
+|-----|------|
+| `RUN/STOP` | `Page Down`, or `Escape` on the graphics keyboard |
+| `ESC` | `Escape`, on the business keyboard |
+| `CLR/HOME` | `Home` |
+| `INST/DEL` | `Backspace` |
+| `RVS` | `Ctrl` |
+| `CRSR ⇔` / `CRSR ⇕` | `Left`, `Right` / `Up`, `Down`, with `SHIFT` where they go left or up |
+| `↑` / `←` | `^` / `_` or `` ` `` |
+| `TAB`, `REPEAT` | `Tab`, `Page Up`, on the business keyboard |
+| Keypad | The keypad |
+
+On the PET `Tab` is a key, since there are no joysticks to switch to.
+
 `Tab` switches the keys between the C64 keyboard and the joysticks. The
 window title shows where they go, and any device plugged into a control
 port:
@@ -368,10 +481,10 @@ 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 |
-| Ports | The device in each control port, and where the keys go |
+| 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. On the PET, Keyboard: where its keys are |
 | 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 |
+| Power | Reset, power cycle and quit, on a C128 its model and mode, and on a Plus/4 or a PET its model and RAM |
 
 INSERT opens a file browser. A disk's set is the `.m3u` or `.vfl` list it
 was opened from, or one in its folder that lists it. Without one, it comes
@@ -384,7 +497,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 +530,16 @@ 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`).
+- **PET and CBM**: the 2001, 3032, 3032b, 4032, 8032 and 8096, with
+  BASIC 1, 2 or 4, the discrete video and the 6545 CRTC on 40 and 80
+  columns, both 6520 PIAs and the 6522 VIA, the graphics and business
+  keyboards, the sound on the VIA's CB2, the 8096's 64K board, both
+  cassette ports and device 8 on the IEEE-488 bus through the KERNAL
+  traps, `.d80` and `.d82` among its disks (`badline pet`).
 - **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 +547,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/pinned-behaviour.md

@@ -48,6 +48,8 @@ only catches the rows that happen to move.
 - [SID data bus](#sid-data-bus)
 - [SID envelope](#sid-envelope)
 - [`.sid` tune banking](#sid-tune-banking)
+- [PET discrete video](#pet-discrete-video)
+- [PET CRTC](#pet-crtc)
 
 ## CPU interrupt recognition
 
@@ -2162,3 +2164,68 @@ testprogs named.
   in `$19` and goes silent when BASIC writes `$0a` there.
   - Spec guard:
     [`sid_tune/file/driver_spec.rb`](../spec/badline/sid_tune/file/driver_spec.rb).
+
+## PET discrete video
+
+- The 2001's and 3000 series' frame is 260 lines of 64 cycles, 16,640
+  cycles, and the vertical drive line is low for 3,840 of them, 60 lines.
+  - Pinned by xpet's 2001 and 3032 as a black box: the falling edges of
+    VIA PB5, timed with VIA T1 over 64 frames, come 16,640 cycles apart,
+    each low for 3,840. Nothing checks the 64-cycle line itself.
+  - Spec guard: *the vertical drive line* in
+    [`pet/discrete_video_spec.rb`](../spec/badline/pet/discrete_video_spec.rb).
+- A line's 40 characters come in its last 40 cycles, 24 cycles after the
+  line starts, and the vertical drive line falls right after line 199's
+  last character. Each character reads the screen RAM as it stands before
+  the CPU's access in the same cycle.
+  - Pinned by `PET/hi-res`, which rewrites the screen RAM as the beam
+    reads it: its picture matches `hi-res.bitmap` (all but the bitmap's
+    tenth column, which `hi-res.py` makes from an immediate that isn't a
+    screen write) with the characters anywhere from 6 to 32 cycles after
+    the line starts. 24 puts them at the end of the line, so the vertical
+    drive line falls as the display ends.
+  - Spec guard: *shows a line's characters in its last 40 cycles* in
+    [`pet/discrete_video_spec.rb`](../spec/badline/pet/discrete_video_spec.rb).
+
+## PET CRTC
+
+- The 6545's counters step once a cycle, ahead of the CPU, and compare
+  with the registers as they stand that cycle, so a write lands from the
+  next character. Vertical sync starts at the first character of row R7
+  and lasts 16 lines, and its start is PIA 1 CB1's falling edge, the
+  editor's IRQ. Every editor leaves R3's upper four bits 0, and nothing
+  has checked another value.
+  - Pinned by `CRTC/crtc0`, `crtc4`-`crtc9`, `crtc11` and `crtc12`
+    (`testbench-pet`), which time their register writes from that IRQ
+    with VIA T1 and loops: all eight match their references dot for dot.
+    The 16 lines match xpet's frame probe on every editor (vertical drive
+    low for 800 cycles of 50-cycle lines, 1,024 of 64).
+  - Spec guard:
+    [`chips/crtc_spec.rb`](../spec/badline/chips/crtc_spec.rb).
+- A compare the counter has already passed doesn't happen: R1 written
+  below the character counter leaves the display on to the line's end,
+  MA counting on, and on a row's last line leaves the next row's start
+  where it was, so the row repeats. R9 written below the line counter
+  runs the row on to 32 lines, and R6 written below the row counter
+  leaves the display on to the frame's end.
+  - Pinned by `CRTC/crtc6` and `crtc7` (R1), `crtc10` (R9, which matches
+    today's xpet dot for dot; its reference is an older xpet's) and
+    `crtc13` (R6).
+  - Spec guard: *past an R1 it missed*, *repeats a row*, *past an R9 it
+    missed* and *past an R6 it missed* in
+    [`chips/crtc_spec.rb`](../spec/badline/chips/crtc_spec.rb).
+- The picture is framed as xpet frames its screenshots: R1's characters
+  in the middle of 704 dots (80 columns) or 384 (40); each character as
+  far right as it comes after its line's horizontal sync, so lines whose
+  sync moves mid-frame move against the rest; the frame's first line
+  where the last frame's lines up to the R6 stop would sit in the middle
+  of 273, unchanged after a frame where the display never stopped; each
+  horizontal sync starting the next line of the picture; nothing within
+  8 dots of either side.
+  - Pinned by `CRTC/crtc4` and `crtc5` (sync moved for some lines),
+    `crtc6` and `crtc7` (display through horizontal sync), `crtc10`
+    (a frame of 232 displayed lines framed from line 20) and the boot
+    screens of the 4032 and the 8032, which match xpet's at the same
+    cycle dot for dot.
+  - Spec guard:
+    [`pet/crtc_video_spec.rb`](../spec/badline/pet/crtc_video_spec.rb).