badline 0.16.1 → 0.17.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.
 
 | Key | Type | Default |
 | --- | --- | --- |
-| `family` | text: c64 vic20 c128 plus4 pet | "c64" |
+| `family` | text: c64 vic20 c128 plus4 pet cbm2 | "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 |
@@ -49,7 +50,7 @@ Written by the C64, VIC-20, C128, Plus/4, PET.
 | `ram` | text: unexpanded 3k 8k 16k 24k 32k all | VIC-20: "unexpanded" |
 | `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" |
+| `model` | text: c128 c128ntsc c128dcr c128dcrntsc | C128: "c128"; Plus/4: "plus4"; PET: "8032"; CBM-II: "610" |
 | `mode` | text: c64 c128 | C128: "c64" |
 | `bus.address` | word | C128: 65533 |
 | `clock_bits` | int | C128: 0 |
@@ -73,10 +74,15 @@ Written by the C64, VIC-20, C128, Plus/4, PET.
 | `rom.characters` | text | PET: "pet/characters2.rom" or "pet/characters1.rom" |
 | `jumpers` | text | PET: "" |
 | `vertical_drive` | bool | PET: true |
+| `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 |
 
 ## BL-RAM
 
-Written by the C64, VIC-20, C128, Plus/4, PET.
+Written by the C64, VIC-20, C128, Plus/4, PET, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -85,30 +91,37 @@ Written by the C64, VIC-20, C128, Plus/4, PET.
 | `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 |
+| `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.
 
 | 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 |
 | `sp` | byte | 255 |
 | `a` | byte | 0 |
 | `x` | byte | 0 |
@@ -130,7 +143,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 +205,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 +236,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 +257,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 +403,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,7 +568,7 @@ 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 |
 | --- | --- | --- |
@@ -582,20 +595,20 @@ 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: [] |
 
 ## 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: "2031" or "8050" or "8250" |
 | `phase` | int | 0 |
 | `cycles` | int | 0 |
 | `so_pending` | bool | false |
@@ -603,19 +616,22 @@ 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 |
+| `fdc_data` | byte | PET: 252 |
 
 ## 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 +665,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 +679,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 +727,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 +753,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 +765,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" |
+| `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 +785,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 +797,16 @@ 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 |
 
 ## BL-D8-CIA
 
@@ -1198,7 +1226,7 @@ Written by the Plus/4.
 
 ## BL-ACIA
 
-Written by the Plus/4.
+Written by the Plus/4, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -1363,7 +1391,7 @@ Written by the PET.
 
 ## BL-CRTC
 
-Written by the PET.
+Written by the PET, CBM-II.
 
 | Key | Type | Default |
 | --- | --- | --- |
@@ -1382,28 +1410,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 +1470,280 @@ 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 |
+| `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 |
+| `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-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 |