badline 0.16.1 → 0.18.0

data/doc/snapshot-format.md

@@ -13,7 +13,8 @@ machine built afresh has: the default below. `word`, `byte` and
 `int & 0x..` are ints cut to the latch's width. A text that lists
 its values takes one of them. An optional int is absent when the
 latch holds nothing. A true drive's modules are named from its
-device number, `BL-D8` to `BL-D11`, and the SIDs past the first
+device number, `BL-D8` to `BL-D11`, or to `BL-D15` for an 8050 or
+an 8250. The SIDs past the first
 are `BL-SID2` onwards, in the order they were fitted. Keys with
 `<N>` stand for each numbered unit. A default of "written only" is
 a key the load doesn't read, or reads only when the snapshot has
@@ -22,18 +23,18 @@ key only some of them have names them.
 
 ## BL-MACHINE
 
-Written by the C64, VIC-20, C128, Plus/4, PET.
+Written by the C64, VIC-20, C128, Plus/4, PET, CBM-II, KIM-1.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `family` | text: c64 vic20 c128 plus4 pet | "c64" |
+| `family` | text: c64 vic20 c128 plus4 pet cbm2 kim1 | "c64" |
 | `region` | text: pal ntsc ntscold drean | C64: "pal" |
 | `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"; Plus/4: "none" |
 | `reu_kb` | int | C64: 0 |
-| `kernal` | text: c64 sx64 pet64 gs | C64: "c64" |
+| `kernal` | text: c64 sx64 pet64 gs | C64: "c64"; CBM-II: "04a" |
 | `datasette` | bool | C64: true |
 | `board` | text: c64 pet64 gs max | C64: "c64" |
 | `cycles` | int | 0 |
@@ -44,19 +45,20 @@ Written by the C64, VIC-20, C128, Plus/4, PET.
 | `freeze_writes` | int | C64: 0 |
 | `dma` | bool | C64: false |
 | `host.pending_keys` | ints | [] |
+| `host.init_keys` | ints | C64: []; VIC-20: []; C128: []; Plus/4: []; PET: []; CBM-II: [] |
 | `host.init_pending` | int | 0 |
 | `written_by` | text | "" |
-| `ram` | text: unexpanded 3k 8k 16k 24k 32k all | VIC-20: "unexpanded" |
+| `ram` | text: unexpanded 3k 8k 16k 24k 32k all | VIC-20: "unexpanded"; KIM-1: "1k" |
+| `model` | text: pal ntsc | VIC-20: "pal"; C128: "c128"; Plus/4: "plus4"; PET: "8032"; CBM-II: "610" |
 | `bus.data` | byte | VIC-20: 253; C128: 255 |
 | `bus.video_data` | byte | VIC-20: 0 |
-| `model` | text: c128 c128ntsc c128dcr c128dcrntsc | C128: "c128"; Plus/4: "plus4"; PET: "8032" |
 | `mode` | text: c64 c128 | C128: "c64" |
 | `bus.address` | word | C128: 65533 |
 | `clock_bits` | int | C128: 0 |
 | `z80_ahead` | int | C128: 0 |
 | `chips_ahead` | int | C128: 0 |
 | `cpu_reset_pending` | bool | C128: true |
-| `host.typing` | bool | C128: false |
+| `host.typing` | bool | C128: false; KIM-1: false |
 | `host.holding_commodore` | bool | C128: false |
 | `host.typist.code` | int, optional | C128: absent |
 | `host.typist.wait` | int | C128: 0 |
@@ -70,45 +72,64 @@ Written by the C64, VIC-20, C128, Plus/4, PET.
 | `rom.basic` | text | PET: "pet/basic4.rom" or "pet/basic1.rom" |
 | `rom.editor` | text | PET: "pet/editor4-80-b-50hz.rom" or "pet/editor1.rom" or "pet/editor4-80-b-50hz-8296.rom" |
 | `rom.kernal` | text | PET: "pet/kernal4.rom" or "pet/kernal1.rom" |
-| `rom.characters` | text | PET: "pet/characters2.rom" or "pet/characters1.rom" |
+| `rom.characters` | text | PET: "pet/characters2.rom" or "pet/characters1.rom" or "pet/characters-superpet.rom" |
 | `jumpers` | text | PET: "" |
 | `vertical_drive` | bool | PET: true |
+| `host.ieee_drive_model` | text: 2031 8050 8250 1001 4040 3040 2040 9060 9090 | PET: "2031"; CBM-II: "2031" |
+| `cpu_switch` | text: 6502 6809 prog | PET: "6502" |
+| `ram_switch` | text: rw read prog | PET: "rw" |
+| `mains_hz` | int | CBM-II: 50 |
+| `dram_refresh` | bool | CBM-II: true |
+| `mains_countdown` | int | CBM-II: varies |
+| `mains_high` | bool | CBM-II: true |
+| `refresh` | int | CBM-II: 0 |
+| `sst` | bool | KIM-1: false |
+| `irq_wired` | bool | KIM-1: false |
+| `host.key_down` | bool | KIM-1: false |
+| `host.next_key_at` | int | KIM-1: 0 |
 
 ## BL-RAM
 
-Written by the C64, VIC-20, C128, Plus/4, PET.
+Written by the C64, VIC-20, C128, Plus/4, PET, KIM-1, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `ram` | bytes | C64: 65536 values; VIC-20: 49152 values; C128: 131072 values; Plus/4: 65536 × 0 or 16384 × 0; PET: 32768 × 0 or 8192 × 0 |
+| `ram` | bytes | C64: 65536 values; VIC-20: 49152 values; C128: 131072 values; Plus/4: 65536 × 0 or 16384 × 0; PET: 32768 × 0 or 8192 × 0; KIM-1: 1024 × 0 or 57344 × 0 |
 | `bus.low_bank` | int & 0x3 | Plus/4: 0 |
 | `bus.high_bank` | int & 0x3 | Plus/4: 0 |
 | `bus.rom_selected` | bool | Plus/4: true |
 | `bus.data` | byte | Plus/4: 255; PET: 253 |
-| `screen` | bytes | PET: 2048 × 0 or 1024 × 0 or 32768 × 0 |
+| `screen` | bytes | PET: 2048 × 0 or 1024 × 0 or 32768 × 0; CBM-II: 2048 × 0 or 1024 × 0 |
 | `expansion.control` | byte | PET: 0 |
 | `expansion.ram` | bytes | PET: 65536 × 0 |
 | `expansion.user_port` | int | PET: 7 |
+| `system` | bytes | CBM-II: 2048 × 0 |
+| `segment<N>` | bytes | CBM-II: 65536 × 0 |
+| `execution_segment` | int & 0xf | CBM-II: 15 |
+| `indirect_segment` | int & 0xf | CBM-II: 15 |
+| `data` | byte | CBM-II: 249; KIM-1: 28 |
+| `cartridge.addresses` | ints | CBM-II: [] |
+| `cartridge.8192` | bytes | CBM-II: [] |
 
 ## BL-COLORRAM
 
-Written by the C64, VIC-20, C128.
+Written by the C64, VIC-20, CBM-II, C128.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `ram` | bytes | C64: 1024 × 0; VIC-20: 1024 × 0 |
+| `ram` | bytes | C64: 1024 × 0; VIC-20: 1024 × 0; CBM-II: 1024 × 0 |
 | `bank<N>` | bytes | C128: 1024 × 0 |
 
 ## BL-CPU
 
-Written by the C64, C128, Plus/4, VIC-20, PET.
+Written by the C64, C128, Plus/4, VIC-20, PET, CBM-II, KIM-1.
 
 | Key | Type | Default |
 | --- | --- | --- |
 | `port.ddr` | byte | C64: 0; C128: 0; Plus/4: 0 |
 | `port.data` | byte | C64: 0; C128: 0; Plus/4: 0 |
 | `port.floating` | byte | C64: 0; C128: 0 |
-| `pc` | word | C64: 64738; VIC-20: 64802; C128: 65341; Plus/4: 65526; PET: 64790 or 64824 |
+| `pc` | word | C64: 64738; VIC-20: 64802; C128: 65341; Plus/4: 65526; PET: 64790 or 64824; CBM-II: 63895 or 63902; KIM-1: 7202 |
 | `sp` | byte | 255 |
 | `a` | byte | 0 |
 | `x` | byte | 0 |
@@ -130,7 +151,7 @@ Written by the C64, C128, Plus/4, VIC-20, PET.
 
 ## BL-VIC
 
-Written by the C64, C128.
+Written by the C64, C128, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -192,11 +213,11 @@ Written by the C64, C128.
 | `shifter.late_mcm` | bool | false |
 | `shifter.late_read` | bool | false |
 | `line.number` | int | 0 |
-| `line.colors` | bytes | 504 × 0 |
-| `line.fg` | ints | 504 × 0 |
-| `line.border.groups` | ints | 63 × 0 |
-| `line.border.mask` | ints | 504 × 1 |
-| `line.border.snapshot` | bytes | 504 × 0 |
+| `line.colors` | bytes | C64: 504 × 0; C128: 504 × 0; CBM-II: 504 × 0 or 520 × 0 |
+| `line.fg` | ints | C64: 504 × 0; C128: 504 × 0; CBM-II: 504 × 0 or 520 × 0 |
+| `line.border.groups` | ints | C64: 63 × 0; C128: 63 × 0; CBM-II: 63 × 0 or 65 × 0 |
+| `line.border.mask` | ints | C64: 504 × 1; C128: 504 × 1; CBM-II: 504 × 1 or 520 × 1 |
+| `line.border.snapshot` | bytes | C64: 504 × 0; C128: 504 × 0; CBM-II: 504 × 0 or 520 × 0 |
 | `line.patches` | ints | [] |
 | `sprite<N>.dma` | bool | false |
 | `sprite<N>.display_on` | bool | false |
@@ -223,18 +244,18 @@ Written by the C64, C128.
 | `line.sprite<N>.reload_span` | int | 0 |
 | `sbus.lines` | int | 0 |
 | `sbus.ghost` | byte | 255 |
-| `sbus.value` | ints | 63 × 255 |
-| `sbus.line` | ints | 63 × -1 |
+| `sbus.value` | ints | C64: 63 × 255; C128: 63 × 255; CBM-II: 63 × 255 or 65 × 255 |
+| `sbus.line` | ints | C64: 63 × -1; C128: 63 × -1; CBM-II: 63 × -1 or 65 × -1 |
 | `collisions.cleared_sprite` | int | 0 |
 | `collisions.cleared_data` | int | 0 |
-| `line.collisions.hits` | bytes | 504 × 0 |
+| `line.collisions.hits` | bytes | C64: 504 × 0; C128: 504 × 0; CBM-II: 504 × 0 or 520 × 0 |
 | `line.collisions.folded` | int | 0 |
 | `line.carried` | bool | false |
-| `line.lo` | int | 504 |
+| `line.lo` | int | C64: 504; C128: 504; CBM-II: 504 or 520 |
 | `line.hi` | int | 0 |
 | `line.sequenced` | int | -1 |
-| `line.win_color` | bytes | 504 × 0 |
-| `line.win_priority` | ints | 504 × 0 |
+| `line.win_color` | bytes | C64: 504 × 0; C128: 504 × 0; CBM-II: 504 × 0 or 520 × 0 |
+| `line.win_priority` | ints | C64: 504 × 0; C128: 504 × 0; CBM-II: 504 × 0 or 520 × 0 |
 | `line.palette` | ints | [0, 0, 0, 0] |
 | `line.stopped_dma` | bool | false |
 | `line.carry<N>` | ints | [] |
@@ -244,7 +265,7 @@ Written by the C64, C128.
 | `line.log.values` | ints | 64 × 0 |
 | `line.log.cursor` | int | 0 |
 | `line.log.next_x` | int | 0 |
-| `display` | bytes | 157248 × 0 |
+| `display` | bytes | C64: 157248 × 0; C128: 157248 × 0; CBM-II: 157248 × 0 or 136760 × 0 |
 | `output_line` | int | C128: 0 |
 | `test_wrap` | bool | C128: false |
 
@@ -390,7 +411,7 @@ Written by the C64, C128.
 
 ## BL-SID
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -555,11 +576,11 @@ Written by the C64, VIC-20, Plus/4.
 
 ## BL-TRAPDOS
 
-Written by the C64, PET.
+Written by the C64, PET, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `storage.kind` | text: directory d64 d71 d81 t64 d80 d82 | "directory" |
+| `storage.kind` | text: directory d64 d71 d81 t64 d80 d82 d67 | "directory" |
 | `storage.path` | text | "" |
 | `storage.bytes` | bytes | [] |
 | `storage.read_only` | bool | false |
@@ -582,20 +603,25 @@ Written by the C64, PET.
 | `serial.frame` | int | C64: 240 |
 | `serial.buffer` | bytes | C64: [] |
 | `save.saving` | bool | C64: false |
-| `ieee.listening` | bool | PET: false |
-| `ieee.talking` | bool | PET: false |
-| `ieee.listen_channel` | int, optional | PET: absent |
-| `ieee.talk_channel` | int, optional | PET: absent |
-| `ieee.frame` | int | PET: 240 |
-| `ieee.buffer` | bytes | PET: [] |
+| `ieee.listening` | bool | PET: false; CBM-II: false |
+| `ieee.talking` | bool | PET: false; CBM-II: false |
+| `ieee.listen_channel` | int, optional | PET: absent; CBM-II: absent |
+| `ieee.talk_channel` | int, optional | PET: absent; CBM-II: absent |
+| `ieee.frame` | int | PET: 240; CBM-II: 240 |
+| `ieee.buffer` | bytes | PET: []; CBM-II: [] |
+| `waterloo.listening` | bool | PET: false |
+| `waterloo.talking` | bool | PET: false |
+| `waterloo.channel` | int | PET: 0 |
+| `waterloo.frame` | byte | PET: 0 |
+| `waterloo.buffer` | ints | PET: [] |
 
 ## BL-D8
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, PET.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `model` | text: 1541 1551 1571 1581 | C64: "1541" or "1581"; C128: "1541" or "1571"; Plus/4: "1541" or "1551" |
+| `model` | text: 1541 1551 1571 1581 | C64: "1541" or "1581"; C128: "1541" or "1571"; Plus/4: "1541" or "1551"; PET: varies |
 | `phase` | int | 0 |
 | `cycles` | int | 0 |
 | `so_pending` | bool | false |
@@ -603,19 +629,25 @@ Written by the C64, C128, Plus/4.
 | `atn` | bool | C64: true |
 | `irq_timer` | int | Plus/4: 16660 |
 | `latched_byte` | byte | Plus/4: 0 |
+| `ieee.host` | int | PET: 0 |
+| `ip_data` | byte | PET: 242 or 211 |
+| `fdc_data` | byte | PET: 252 |
+| `sasi_data` | byte | PET: 248 |
+| `sasi.ack_high` | bool | PET: true |
+| `sasi.reset_high` | bool | PET: false |
 
 ## BL-D8-RAM
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, PET.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `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 |
+| `data` | byte | C64: 234 or 175; C128: 234; Plus/4: 234 or 233; PET: 234 |
+| `ram` | bytes | C64: 2048 × 0 or 8192 × 0; C128: 2048 × 0; Plus/4: 2048 × 0; PET: 2048 × 0 |
 
 ## BL-D8-VIA1
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, PET.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -649,7 +681,7 @@ Written by the C64, C128, Plus/4.
 | `ifr.flags` | int & 0x7f | 0 |
 | `ifr.enable` | int & 0x7f | 0 |
 | `ca.control` | int & 0xf | 0 |
-| `ca.c1_high` | bool | C64: true; C128: true; Plus/4: false |
+| `ca.c1_high` | bool | C64: true; C128: true; Plus/4: false; PET: false |
 | `ca.c2_high` | bool | true |
 | `ca.handshake_low` | bool | false |
 | `ca.pulse` | int | 0 |
@@ -663,7 +695,7 @@ Written by the C64, C128, Plus/4.
 
 ## BL-D8-VIA2
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, PET.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -711,11 +743,11 @@ Written by the C64, C128, Plus/4.
 
 ## BL-D8-CPU
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, PET.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `pc` | word | C64: 60064 or 44836; C128: 60064; Plus/4: 60064 or 59829 |
+| `pc` | word | C64: 60064 or 44836; C128: 60064; Plus/4: 60064 or 59829; PET: 60101 |
 | `sp` | byte | 255 |
 | `a` | byte | 0 |
 | `x` | byte | 0 |
@@ -737,7 +769,7 @@ Written by the C64, C128, Plus/4.
 
 ## BL-D8-DISK
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, PET.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -749,17 +781,19 @@ Written by the C64, C128, Plus/4.
 | `track<N>.zone` | int, optional | absent |
 | `written` | ints | [] |
 | `changed` | ints | C64: [] |
+| `image.format` | text: d80 d82 | PET: "d80" or "d64" |
+| `track<N>` | ints | PET: [] |
 
 ## BL-D8-MECH
 
-Written by the C64, C128, Plus/4.
+Written by the C64, C128, Plus/4, PET.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `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 | C64: 3; C128: 3; Plus/4: 3 or 0 |
+| `half_track` | int | C64: 35; C128: 37; Plus/4: 35 or 36; PET: 35 |
+| `slip` | int & 0x3 | C64: 0; C128: 2; Plus/4: 0; PET: 0 |
+| `side` | int | C64: 0 or 1; C128: 85; Plus/4: 0; PET: 0 |
+| `zone` | int & 0x3 | C64: 3; C128: 3; Plus/4: 3 or 0; PET: 3 |
 | `time` | int | 0 |
 | `read_clock_in` | int | 2097152 |
 | `clocks` | int | 0 |
@@ -767,8 +801,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 or false |
-| `led` | bool | C64: true; C128: true; Plus/4: true or false |
+| `motor` | bool | C64: true or false; C128: true; Plus/4: true or false; PET: true |
+| `led` | bool | C64: true; C128: true; Plus/4: true or false; PET: true |
 | `sync` | bool | false |
 | `byte_ready` | bool | false |
 | `byte_latched` | bool | false |
@@ -779,6 +813,17 @@ Written by the C64, C128, Plus/4.
 | `cylinder` | int | C64: 0 |
 | `angle` | int | C64: 0 |
 | `changed` | bool | C64: true |
+| `cylinders` | ints | PET: [0, 0] |
+| `phases` | ints | PET: [0, 0] |
+| `positions` | ints | PET: [0, 0] |
+| `bit_clocks` | ints | PET: [0, 0] |
+| `changing` | ints | PET: [0, 0] |
+| `motors` | ints | PET: [0, 0] |
+| `syncs` | ints | PET: [0, 0] |
+| `so_pending` | bool | PET: false |
+| `ca1_low` | bool | PET: false |
+| `data_in` | byte | PET: 255 |
+| `half_tracks` | ints | PET: [0, 0] |
 
 ## BL-D8-CIA
 
@@ -941,6 +986,8 @@ Written by the VIC-20.
 | `registers` | bytes | 16 × 0 |
 | `raster` | int | 0 |
 | `column` | int | 0 |
+| `frame_lines` | int | 312 |
+| `long_field` | bool | true |
 | `window_open` | bool | false |
 | `window_done` | bool | false |
 | `row_start` | int | 0 |
@@ -1198,7 +1245,7 @@ Written by the Plus/4.
 
 ## BL-ACIA
 
-Written by the Plus/4.
+Written by the Plus/4, PET, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -1363,7 +1410,7 @@ Written by the PET.
 
 ## BL-CRTC
 
-Written by the PET.
+Written by the PET, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -1382,28 +1429,30 @@ Written by the PET.
 
 ## BL-VIDEO
 
-Written by the PET.
+Written by the PET, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `displayed` | int | 0 |
-| `frame_displayed` | int | 0 |
+| `displayed` | int | PET: 0 |
+| `frame_displayed` | int | PET: 0 |
 | `line_shown` | bool | false |
-| `y` | int | 136 |
-| `from_y` | int | 136 |
-| `to_y` | int | 136 |
-| `shown_from` | int | 36 |
-| `shown_to` | int | 37 |
-| `on_canvas` | bool | true |
-| `origin` | int | 336 |
-| `from` | int | 704 |
-| `to` | int | -704 |
-| `canvas.dots` | bytes | 192192 × 0 or 83328 × 0 |
-| `canvas.painted` | ints | 48048 × 0 or 20832 × 0 |
-| `canvas.span_from` | ints | 273 × 0 or 217 × 0 |
-| `canvas.span_to` | ints | 273 × 0 or 217 × 0 |
-| `column` | int | 0 |
+| `y` | int | PET: 136 |
+| `from_y` | int | PET: 136 |
+| `to_y` | int | PET: 136 |
+| `shown_from` | int | PET: 36 |
+| `shown_to` | int | PET: 37 |
+| `on_canvas` | bool | PET: true |
+| `origin` | int | PET: 336; CBM-II: 24 |
+| `from` | int | PET: 704 |
+| `to` | int | PET: -704 |
+| `canvas.dots` | bytes | PET: 192192 × 0 or 83328 × 0; CBM-II: 187264 × 0 or 258368 × 0 |
+| `canvas.painted` | ints | PET: 48048 × 0 or 20832 × 0; CBM-II: 46816 × 0 or 64592 × 0 |
+| `canvas.span_from` | ints | PET: 273 × 0 or 217 × 0; CBM-II: 266 × 0 or 367 × 0 |
+| `canvas.span_to` | ints | PET: 273 × 0 or 217 × 0; CBM-II: 266 × 0 or 367 × 0 |
+| `column` | int | PET: 0 |
 | `line` | int | 0 |
+| `frames` | int | CBM-II: 2 |
+| `layout` | ints | CBM-II: 9 × 0 |
 
 ## BL-TAPE1
 
@@ -1440,3 +1489,496 @@ Written by the PET.
 | `tape.bytes` | bytes | [] |
 | `tape.path` | text | "" |
 | `tape.position` | int | 0 |
+
+## BL-D8-COMMON
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | 4096 × 0 |
+
+## BL-D8-RIOT1
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | 128 × 0 |
+| `ora` | byte | 0 |
+| `orb` | byte | 0 |
+| `ddra` | byte | 0 |
+| `ddrb` | byte | 0 |
+| `pa7_high` | bool | true |
+| `pa7_active` | bool | false |
+| `pa7_flag` | bool | false |
+| `edge_irq_enabled` | bool | false |
+| `rising_edge` | bool | false |
+| `timer.counter` | byte | 0 |
+| `timer.interval` | int & 0x3 | 0 |
+| `timer.prescale` | int | 1 |
+| `timer.expired` | bool | true |
+| `timer.flag` | bool | false |
+| `timer.irq_enabled` | bool | false |
+| `timer.fired` | bool | false |
+
+## BL-D8-RIOT2
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | 128 × 0 |
+| `ora` | byte | 0 |
+| `orb` | byte | 0 |
+| `ddra` | byte | 0 |
+| `ddrb` | byte | 0 |
+| `pa7_high` | bool | true |
+| `pa7_active` | bool | false |
+| `pa7_flag` | bool | false |
+| `edge_irq_enabled` | bool | false |
+| `rising_edge` | bool | false |
+| `timer.counter` | byte | 0 |
+| `timer.interval` | int & 0x3 | 0 |
+| `timer.prescale` | int | 1 |
+| `timer.expired` | bool | true |
+| `timer.flag` | bool | false |
+| `timer.irq_enabled` | bool | false |
+| `timer.fired` | bool | false |
+
+## BL-D8-IPCPU
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `pc` | word | 62135 or 54059 or 61972 |
+| `sp` | byte | 255 |
+| `a` | byte | 0 |
+| `x` | byte | 0 |
+| `y` | byte | 0 |
+| `p` | byte | 32 |
+| `nmi` | bool | false |
+| `so_high` | bool | true |
+| `irq.sample` | bool | false |
+| `irq.pending` | bool | false |
+| `irq.boundary` | bool | false |
+| `nmi.sample` | bool | false |
+| `nmi.pending` | bool | false |
+| `nmi.boundary` | bool | false |
+| `skip_poll` | bool | false |
+| `cycles` | int | 0 |
+| `instructions` | int | 0 |
+| `stalled` | int, optional | absent |
+| `pos.seq` | text: boundary op interrupt jam | "boundary" |
+
+## BL-D8-FDCCPU
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `pc` | word | 64516 or 64521 |
+| `sp` | byte | 255 |
+| `a` | byte | 0 |
+| `x` | byte | 0 |
+| `y` | byte | 0 |
+| `p` | byte | 32 |
+| `nmi` | bool | false |
+| `so_high` | bool | true |
+| `irq.sample` | bool | false |
+| `irq.pending` | bool | false |
+| `irq.boundary` | bool | false |
+| `nmi.sample` | bool | false |
+| `nmi.pending` | bool | false |
+| `nmi.boundary` | bool | false |
+| `skip_poll` | bool | false |
+| `cycles` | int | 0 |
+| `instructions` | int | 0 |
+| `stalled` | int, optional | absent |
+| `pos.seq` | text: boundary op interrupt jam | "boundary" |
+
+## BL-D8-VIA
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ora` | byte | 0 |
+| `orb` | byte | 0 |
+| `ddra` | byte | 0 |
+| `ddrb` | byte | 0 |
+| `latch_a` | byte | 255 |
+| `latch_b` | byte | 255 |
+| `acr` | byte | 0 |
+| `pcr` | byte | 0 |
+| `pb6_high` | bool | true |
+| `t<N>.counter` | word | 65535 |
+| `t1.latch` | word | 65535 |
+| `t<N>.hold` | bool | false |
+| `t1.reload` | bool | false |
+| `t<N>.armed` | bool | false |
+| `t1.pb7` | bool | true |
+| `t2.latch_low` | byte | 255 |
+| `t2.low_reload` | bool | false |
+| `t2.low_underflowed` | bool | false |
+| `t2.count_pulses` | bool | false |
+| `t2.counting_pulses` | bool | false |
+| `sr.mode` | int & 0x7 | 0 |
+| `sr.data` | byte | 0 |
+| `sr.bits` | int | 0 |
+| `sr.delay` | int | 0 |
+| `sr.clock` | bool | true |
+| `sr.cb2` | bool | true |
+| `sr.cb2_input` | bool | true |
+| `ifr.flags` | int & 0x7f | 0 |
+| `ifr.enable` | int & 0x7f | 0 |
+| `ca.control` | int & 0xf | 0 |
+| `ca.c1_high` | bool | true |
+| `ca.c2_high` | bool | true |
+| `ca.handshake_low` | bool | false |
+| `ca.pulse` | int | 0 |
+| `ca.c2_output` | bool | true |
+| `cb.control` | int & 0xf | 0 |
+| `cb.c1_high` | bool | true |
+| `cb.c2_high` | bool | true |
+| `cb.handshake_low` | bool | false |
+| `cb.pulse` | int | 0 |
+| `cb.c2_output` | bool | true |
+
+## BL-D8-RRIOT
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | 64 × 0 |
+| `ora` | byte | 0 |
+| `orb` | byte | 0 |
+| `ddra` | byte | 0 |
+| `ddrb` | byte | 0 |
+| `timer.counter` | byte | 0 |
+| `timer.interval` | int & 0x3 | 0 |
+| `timer.prescale` | int | 1 |
+| `timer.expired` | bool | true |
+| `timer.flag` | bool | false |
+| `timer.irq_enabled` | bool | false |
+| `timer.fired` | bool | false |
+
+## BL-D8-SASICPU
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `pc` | word | 63489 |
+| `sp` | byte | 255 |
+| `a` | byte | 0 |
+| `x` | byte | 0 |
+| `y` | byte | 0 |
+| `p` | byte | 32 |
+| `nmi` | bool | false |
+| `so_high` | bool | true |
+| `irq.sample` | bool | false |
+| `irq.pending` | bool | false |
+| `irq.boundary` | bool | false |
+| `nmi.sample` | bool | false |
+| `nmi.pending` | bool | false |
+| `nmi.boundary` | bool | false |
+| `skip_poll` | bool | false |
+| `cycles` | int | 0 |
+| `instructions` | int | 0 |
+| `stalled` | int, optional | absent |
+| `pos.seq` | text: boundary op interrupt jam | "boundary" |
+
+## BL-D8-SASIRAM
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | 128 × 0 |
+
+## BL-D8-SASI
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `phase` | int | 0 |
+| `request` | bool | false |
+| `delay` | int | 0 |
+| `command` | ints | [] |
+| `buffer` | ints | [] |
+| `index` | int | 0 |
+| `writing` | bool | false |
+| `sense` | ints | [0, 0, 0, 0] |
+| `last_sense` | ints | [0, 0, 0, 0] |
+| `fast` | bool | false |
+| `cycle` | int | 0 |
+| `cylinder` | int | 0 |
+| `heads` | int | 4 |
+| `sectors` | int | 32 |
+| `block_buffer` | ints | 256 × 0 |
+| `path` | text | "" |
+| `read_only` | bool | false |
+| `disk_heads` | int | 4 |
+
+## BL-SUPERPET
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `bank_latch` | byte | 0 |
+| `system_latch` | byte | 0 |
+| `socket` | int | 0 |
+| `ram` | bytes | 65536 × 0 |
+| `dongle.registers` | ints | [0, 0, 0, 0, 0, 0, 0, 0] |
+| `dongle.latch` | byte | 255 |
+| `dongle.shift_in` | int, optional | absent |
+
+## BL-M6809
+
+Written by the PET.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `a` | byte | 0 |
+| `b` | byte | 0 |
+| `x` | word | 0 |
+| `y` | word | 0 |
+| `u` | word | 0 |
+| `s` | word | 0 |
+| `pc` | word | 0 |
+| `dp` | byte | 0 |
+| `cc` | byte | 80 |
+| `cycles` | int | 0 |
+| `irq` | bool | false |
+| `firq` | bool | false |
+| `nmi` | bool | false |
+| `halt` | bool | false |
+| `irq.latched` | bool | false |
+| `irq.seen` | bool | false |
+| `firq.latched` | bool | false |
+| `firq.seen` | bool | false |
+| `nmi.edge` | bool | false |
+| `nmi.latched` | bool | false |
+| `nmi.seen` | bool | false |
+| `nmi.armed` | bool | false |
+| `halt.latched` | bool | false |
+| `halt.seen` | bool | false |
+| `ea` | word | 0 |
+| `value` | word | 0 |
+| `post` | byte | 0 |
+| `opcode` | byte | 0 |
+| `operation` | text: none enter_nmi enter_firq enter_irq neg xnc com lsr ror asr asl rol dec xdec inc tst jmp clr nop sync jsr x18 daa orcc andcc sex exg tfr leax leay leas leau abx mul xres swi nega xnca coma lsra rora asra asla rola deca xdeca inca tsta xclra clra negb xncb comb lsrb rorb asrb aslb rolb decb xdecb incb tstb xclrb clrb suba cmpa sbca subd anda bita lda xsta eora adca ora adda cmpx ldx xstx sta stx subb cmpb sbcb addd andb bitb ldb xstb eorb adcb orb addb ldd ldu xstu stb std stu xswi2 swi2 cmpd xsta2 cmpy ldy xsty sty xaddd xstb2 lds xsts sts xfirq swi3 cmpu cmps xstx2 xaddu xstu2 | "none" |
+| `page` | int | 1 |
+| `group` | int | 0 |
+| `previous_group` | int | 0 |
+| `alu_word` | int | 0 |
+| `vector` | word | 65534 |
+| `interrupt_mask` | byte | 0 |
+| `stack_u` | bool | false |
+| `pos.plan` | text | "fetch" |
+| `pos.tail` | text | "none" |
+| `pos.index` | int | 0 |
+
+## BL-CIA
+
+Written by the CBM-II.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `pra` | byte | 0 |
+| `prb` | byte | 0 |
+| `ddra` | byte | 0 |
+| `ddrb` | byte | 0 |
+| `cra` | byte | 0 |
+| `crb` | byte | 0 |
+| `pb4_high` | bool | true |
+| `pb4_driven_high` | bool | true |
+| `cnt_high` | bool | true |
+| `cnt_rise` | bool | false |
+| `ta.counter` | word | 65535 |
+| `ta.latch` | word | 65535 |
+| `ta.pipe` | int & 0x3 | 0 |
+| `ta.load_delay` | int | 0 |
+| `ta.reload` | bool | false |
+| `ta.underflowed` | bool | false |
+| `ta.oneshot_linger` | int | 0 |
+| `ta.toggle` | bool | true |
+| `tb.counter` | word | 65535 |
+| `tb.latch` | word | 65535 |
+| `tb.pipe` | int & 0x3 | 0 |
+| `tb.load_delay` | int | 0 |
+| `tb.reload` | bool | false |
+| `tb.underflowed` | bool | false |
+| `tb.oneshot_linger` | int | 0 |
+| `tb.toggle` | bool | true |
+| `icr.mask` | byte | 0 |
+| `icr.status` | byte | 0 |
+| `icr.pending` | int | 0 |
+| `icr.read` | int, optional | absent |
+| `icr.read_last_cycle` | int, optional | absent |
+| `icr.read_two_cycles_ago` | int, optional | absent |
+| `icr.timer_b_bug` | bool | false |
+| `sdr.data` | byte | 0 |
+| `sdr.shift` | byte | 0 |
+| `sdr.steps` | int | 0 |
+| `sdr.empty_in` | int, optional | absent |
+| `sdr.busy_in` | int, optional | absent |
+| `sdr.busy` | bool | false |
+| `sdr.abandoned` | bool | false |
+| `sdr.pending` | int, optional | absent |
+| `sdr.underflow_high` | bool | false |
+| `sdr.in_flight` | bool | false |
+| `sdr.flight_up` | int | 0 |
+| `sdr.flight_down` | int | 0 |
+| `sdr.cnt` | bool | true |
+| `sdr.cnt_in` | bool | true |
+| `sdr.sp_in` | bool | true |
+| `sdr.sp_out` | bool | true |
+| `sdr.idle` | bool | true |
+| `tod.mains_phase` | int | 0 |
+| `tod.pulses` | int | 0 |
+| `tod.stopped` | bool | true |
+| `tod.alarm_pending` | bool | false |
+| `tod.clock.tenths` | byte | 0 |
+| `tod.alarm.tenths` | byte | 0 |
+| `tod.clock.seconds` | byte | 0 |
+| `tod.alarm.seconds` | byte | 0 |
+| `tod.clock.minutes` | byte | 0 |
+| `tod.alarm.minutes` | byte | 0 |
+| `tod.clock.hours` | byte | 1 |
+| `tod.alarm.hours` | byte | 0 |
+| `tod.latch.hours` | int, optional | absent |
+
+## BL-TPI1
+
+Written by the CBM-II.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ports` | ints | [0, 0, 0] |
+| `directions` | ints | [0, 0, 0] |
+| `control` | byte | 0 |
+| `latches` | int & 0x1f | 0 |
+| `air` | int & 0x1f | 0 |
+| `stack` | ints | [] |
+| `ca` | bool | false |
+| `cb` | bool | false |
+| `lines` | int & 0x1f | 31 |
+
+## BL-TPI2
+
+Written by the CBM-II.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ports` | ints | [0, 0, 0] |
+| `directions` | ints | [0, 0, 0] |
+| `control` | byte | 0 |
+| `latches` | int & 0x1f | 0 |
+| `air` | int & 0x1f | 0 |
+| `stack` | ints | [] |
+| `ca` | bool | false |
+| `cb` | bool | false |
+| `lines` | int & 0x1f | 31 |
+
+## BL-U2
+
+Written by the KIM-1.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | 64 × 0 |
+| `ora` | byte | 0 |
+| `orb` | byte | 0 |
+| `ddra` | byte | 0 |
+| `ddrb` | byte | 0 |
+| `timer.counter` | byte | 0 |
+| `timer.interval` | int & 0x3 | 0 |
+| `timer.prescale` | int | 1 |
+| `timer.expired` | bool | true |
+| `timer.flag` | bool | false |
+| `timer.irq_enabled` | bool | false |
+| `timer.fired` | bool | false |
+
+## BL-U3
+
+Written by the KIM-1.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | 64 × 0 |
+| `ora` | byte | 0 |
+| `orb` | byte | 0 |
+| `ddra` | byte | 0 |
+| `ddrb` | byte | 0 |
+| `timer.counter` | byte | 0 |
+| `timer.interval` | int & 0x3 | 0 |
+| `timer.prescale` | int | 1 |
+| `timer.expired` | bool | true |
+| `timer.flag` | bool | false |
+| `timer.irq_enabled` | bool | false |
+| `timer.fired` | bool | false |
+
+## BL-PANEL
+
+Written by the KIM-1.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `tty` | bool | false |
+| `held` | int | -1 |
+| `digit` | int | -1 |
+| `segments` | int & 0x7f | 0 |
+| `since` | int | 0 |
+| `lit` | ints | 42 × 0 |
+| `shown` | ints | [0, 0, 0, 0, 0, 0] |
+| `shown_at` | ints | [-20001, -20001, -20001, -20001, -20001, -20001] |
+
+## BL-DECK
+
+Written by the KIM-1.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `tape.gaps` | ints | [] |
+| `tape.path` | text | "" |
+| `playing` | bool | false |
+| `recording` | bool | false |
+| `position` | int | 0 |
+| `next_edge` | int | 0 |
+| `high` | bool | true |
+| `output_high` | bool | true |
+
+## BL-TTY
+
+Written by the KIM-1.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `baud` | int | 9600 |
+| `queue` | ints | [] |
+| `output` | bytes | [] |
+| `line_high` | bool | true |
+| `send.byte` | int | 0 |
+| `send.bits` | int | 11 |
+| `send.start` | int | 0 |
+| `quiet_until` | int | 0 |
+| `receive.busy` | bool | false |
+| `receive.byte` | int | 0 |
+| `receive.bits` | int | 0 |
+| `receive.edge` | int | 0 |
+| `receive.sample_at` | int | 0 |
+| `printer_high` | bool | true |
+
+## BL-SOUND
+
+Written by the KIM-1.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `speaker` | bool | false |