badline 0.12.1 → 0.14.0

data/doc/snapshot-format.md

@@ -0,0 +1,1047 @@
+# Snapshot format
+
+This file is generated by `rake snapshot:fields` from the code that
+loads a snapshot. Don't edit it by hand. doc/snapshots.md covers
+what a snapshot holds and which versions load.
+
+A snapshot is a VICE `.vsf` container. The machine is in modules
+named `BL-` plus a unit, each a deflated list of records: a key, a
+type and a value. The types are `int` (a zigzag BER integer), `bool`,
+`bytes`, `ints` (a list of integers) and `text`. A load skips a key
+it doesn't know, and a key that isn't there leaves the value a
+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`. 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 it. Where the
+machines differ, the default is given for each, and a key only
+some of them have names them.
+
+## BL-MACHINE
+
+Written by the C64, VIC-20, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `family` | text: c64 vic20 c128 | "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" |
+| `reu_kb` | int | C64: 0 |
+| `kernal` | text: c64 sx64 pet64 gs | C64: "c64" |
+| `datasette` | bool | C64: true |
+| `board` | text: c64 pet64 gs max | C64: "c64" |
+| `cycles` | int | 0 |
+| `nmi_asserted` | bool | false |
+| `cartridge_nmi` | bool | C64: false; C128: false |
+| `restore_pulse` | bool | C64: false; C128: false |
+| `freezing` | bool | C64: false |
+| `freeze_writes` | int | C64: 0 |
+| `dma` | bool | C64: false |
+| `host.pending_keys` | ints | [] |
+| `host.init_pending` | int | 0 |
+| `written_by` | text | "" |
+| `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" |
+| `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.holding_commodore` | bool | C128: false |
+| `host.typist.code` | int, optional | C128: absent |
+| `host.typist.wait` | int | C128: 0 |
+| `host.typist.typing` | bool | C128: false |
+
+## BL-RAM
+
+Written by the C64, VIC-20, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | C64: 65536 values; VIC-20: 49152 values; C128: 131072 values |
+
+## BL-COLORRAM
+
+Written by the C64, VIC-20, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `ram` | bytes | C64: 1024 × 0; VIC-20: 1024 × 0 |
+| `bank<N>` | bytes | C128: 1024 × 0 |
+
+## BL-CPU
+
+Written by the C64, C128, VIC-20.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `port.ddr` | byte | C64: 0; C128: 0 |
+| `port.data` | byte | C64: 0; C128: 0 |
+| `port.floating` | byte | C64: 0; C128: 0 |
+| `pc` | word | C64: 64738; VIC-20: 64802; C128: 65341 |
+| `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-VIC
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `column` | int | 0 |
+| `raster` | int | 0 |
+| `fetch_d011` | byte | 0 |
+| `g.kind` | ints | [0, 0, 0, 0] |
+| `g.data` | ints | [0, 0, 0, 0] |
+| `g.char` | ints | [0, 0, 0, 0] |
+| `g.color` | ints | [1, 1, 1, 1] |
+| `g.kept_char` | byte | 0 |
+| `g.kept_color` | int & 0xf | 0 |
+| `g.display` | bool | false |
+| `lp_triggered` | bool | false |
+| `lp_low` | bool | false |
+| `raster_match` | bool | false |
+| `bank_lines` | int | 3 |
+| `character_buffer` | bytes | 40 × 0 |
+| `color_buffer` | bytes | 40 × 0 |
+| `registers` | bytes | 64 × 0 |
+| `vc_base` | int & 0x3ff | 0 |
+| `vc` | int & 0x3ff | 0 |
+| `vmli` | int | 0 |
+| `rc` | int & 0x7 | 0 |
+| `display_state` | bool | false |
+| `bad_lines_enabled` | bool | false |
+| `matched` | bool | false |
+| `ba` | int, optional | absent |
+| `line_bits` | int | 0 |
+| `den_line` | bool | false |
+| `in_window` | bool | false |
+| `line.layout` | int | 0 |
+| `first_csel` | bool | false |
+| `left_vertical_border` | int, optional | absent |
+| `cur_colors` | ints | [0, 0, 0, 0, 0, 0, 0, 0] |
+| `cur_fg` | text | "hires:0" |
+| `prev_colors` | ints | [0, 0, 0, 0, 0, 0, 0, 0] |
+| `prev_fg` | text | "hires:0" |
+| `vertical_border` | bool | true |
+| `vertical_armed` | bool | true |
+| `main_border` | bool | true |
+| `xscroll` | int & 0x7 | 0 |
+| `last_shift` | int | 0 |
+| `last_mode` | int | 0 |
+| `settling` | bool | false |
+| `prev_fresh` | bool | false |
+| `check` | bool | true |
+| `shifter.next_ecm_bmm` | int | 0 |
+| `shifter.black_below` | int | 0 |
+| `shifter.colors` | ints | [0, 0, 0, 0, 0, 0, 0, 0] |
+| `shifter.fg` | ints | [0, 0, 0, 0, 0, 0, 0, 0] |
+| `shifter.gbuf` | int | 0 |
+| `shifter.vbuf` | int | 0 |
+| `shifter.cbuf` | int | 0 |
+| `shifter.flop` | int | 0 |
+| `shifter.pixel` | int | 0 |
+| `shifter.mode_lookup` | int | 0 |
+| `shifter.mode_read` | int | 0 |
+| `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.patches` | ints | [] |
+| `sprite<N>.dma` | bool | false |
+| `sprite<N>.display_on` | bool | false |
+| `sprite<N>.mcbase` | int & 0x3f | 0 |
+| `sprite<N>.mc` | int & 0x3f | 0 |
+| `sprite<N>.exp_ff` | bool | true |
+| `sprite<N>.crunched_mc` | int, optional | absent |
+| `sprite<N>.bits` | int | 0 |
+| `sprite<N>.row_ready` | bool | false |
+| `sprite<N>.prev_bits` | int, optional | absent |
+| `sprite<N>.first_byte_lost` | bool | false |
+| `sprite<N>.blind` | bool | false |
+| `sprite<N>.sr` | int | 0 |
+| `sprite<N>.latch` | int | 0 |
+| `sprite<N>.mc_flop` | bool | false |
+| `sprite<N>.xe_flop` | bool | false |
+| `line.sprite<N>.show_from` | int | 0 |
+| `line.sprite<N>.stop_x` | int, optional | absent |
+| `line.sprite<N>.codes` | ints | 71 × 0 |
+| `line.sprite<N>.leftmost` | int | 0 |
+| `line.sprite<N>.span` | int | 0 |
+| `line.sprite<N>.reload_codes` | ints | 71 × 0 |
+| `line.sprite<N>.reload_leftmost` | int | 0 |
+| `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 |
+| `collisions.cleared_sprite` | int | 0 |
+| `collisions.cleared_data` | int | 0 |
+| `line.collisions.hits` | bytes | 504 × 0 |
+| `line.collisions.folded` | int | 0 |
+| `line.carried` | bool | false |
+| `line.lo` | int | 504 |
+| `line.hi` | int | 0 |
+| `line.sequenced` | int | -1 |
+| `line.win_color` | bytes | 504 × 0 |
+| `line.win_priority` | ints | 504 × 0 |
+| `line.palette` | ints | [0, 0, 0, 0] |
+| `line.stopped_dma` | bool | false |
+| `line.carry<N>` | ints | [] |
+| `line.carry_next<N>` | ints | [] |
+| `line.log.entries` | ints | [] |
+| `line.log.seed` | ints | [] |
+| `line.log.values` | ints | 64 × 0 |
+| `line.log.cursor` | int | 0 |
+| `line.log.next_x` | int | 0 |
+| `display` | bytes | 157248 × 0 |
+| `output_line` | int | C128: 0 |
+| `test_wrap` | bool | C128: false |
+
+## BL-CIA1
+
+Written by the C64, C128.
+
+| 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-CIA2
+
+Written by the C64, C128.
+
+| 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-SID
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `registers` | bytes | 32 × 0 |
+| `bus_value` | byte | 0 |
+| `bus_ttl` | int | 0 |
+| `voice<N>.wave.accumulator` | int & 0xffffff | 5592405 |
+| `voice<N>.wave.shift_register` | int & 0x7fffff | 8388606 |
+| `voice<N>.wave.shift_register_reset` | int | 0 |
+| `voice<N>.wave.shift_pipeline` | int | 0 |
+| `voice<N>.wave.delayed_triangle` | int & 0xfff | 0 |
+| `voice<N>.wave.delayed_sawtooth` | int & 0xfff | 0 |
+| `voice<N>.wave.msb_rising` | bool | false |
+| `voice<N>.wave.floating` | int & 0xfff | 0 |
+| `voice<N>.wave.floating_ttl` | int | 0 |
+| `voice<N>.wave.pulse` | int & 0xfff | 4095 |
+| `voice<N>.env.state` | text: attack decay_sustain release | "release" |
+| `voice<N>.env.next_state` | text: attack decay_sustain release | "release" |
+| `voice<N>.env.counter` | byte | 0 |
+| `voice<N>.env.env<N>` | byte | 0 |
+| `voice<N>.env.rate_counter` | int & 0x7fff | 0 |
+| `voice<N>.env.rate_period` | int | 8 |
+| `voice<N>.env.reset_rate_counter` | bool | false |
+| `voice<N>.env.exponential_counter` | int | 0 |
+| `voice<N>.env.exponential_period` | int | 1 |
+| `voice<N>.env.state_pipeline` | int | 0 |
+| `voice<N>.env.envelope_pipeline` | int | 0 |
+| `voice<N>.env.exponential_pipeline` | int | 0 |
+| `voice<N>.env.hold_zero` | bool | true |
+| `filter.highpass` | int | 0 |
+| `filter.bandpass` | int | 0 |
+| `filter.lowpass` | int | 0 |
+| `filter.unfiltered` | int | 0 |
+| `filter.input` | int | 0 |
+| `ext.lowpass` | int | 0 |
+| `ext.highpass` | int | 0 |
+| `ext.output` | int | 0 |
+
+## BL-TAPE
+
+Written by the C64, VIC-20, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `playing` | bool | false |
+| `motor` | bool | false |
+| `countdown` | int | 0 |
+| `tape.bytes` | bytes | [] |
+| `tape.path` | text | C64: "" |
+| `tape.position` | int | C64: 0 |
+
+## BL-RAMEXP
+
+Written by the C64.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `d100` | byte | 0 |
+| `locked` | bool | false |
+| `bank<N>` | bytes | 65536 × 0 |
+
+## BL-REU
+
+Written by the C64.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `status` | byte | 16 |
+| `command` | byte | 16 |
+| `c64` | word | 0 |
+| `c64_start` | word | 0 |
+| `expansion` | word | 0 |
+| `expansion_start` | word | 0 |
+| `bank` | byte | 0 |
+| `bank_start` | byte | 0 |
+| `length` | word | 65535 |
+| `length_start` | word | 65535 |
+| `interrupt_mask` | byte | 31 |
+| `address_control` | byte | 63 |
+| `armed` | bool | false |
+| `requested` | bool | false |
+| `running` | bool | false |
+| `ba_was_low` | bool | false |
+| `dma.c64` | word | 0 |
+| `dma.expansion` | int | 0 |
+| `dma.length` | int | 0 |
+| `dma.events` | int | 0 |
+| `dma.type` | text: stash fetch swap verify none | "none" |
+| `dma.c64_step` | int, optional | absent |
+| `dma.expansion_step` | int, optional | absent |
+| `dma.last` | int, optional | absent |
+| `dma.ba_low_after_writes` | int, optional | absent |
+| `dma.swap_byte` | int, optional | absent |
+| `dma.held_read` | int, optional | absent |
+| `dma.holding` | bool | false |
+| `dma.waiting` | bool | absent |
+| `dma.stopped_after_write` | bool | absent |
+| `dma.swap_write_due` | bool | absent |
+| `dma.swap_read_again` | bool | absent |
+| `dma.moved_all` | bool | absent |
+| `dma.extra_cycle` | bool | absent |
+| `latch` | byte | 255 |
+| `bank<N>` | bytes | [] |
+
+## BL-CART
+
+Written by the C64, VIC-20.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `geo_ram_kb` | int | C64: 0 |
+| `crt` | bytes | C64: [] |
+| `exrom` | int & 0x1 | C64: 1 |
+| `game` | int & 0x1 | C64: 0 |
+| `nmi` | bool | C64: false |
+| `button` | bool | C64: false |
+| `bank` | int | C64: 0 |
+| `control` | byte | C64: 0 |
+| `io_ram` | bytes | C64: 256 × 255 |
+| `flash_low.data` | bytes | C64: 524288 values |
+| `flash_low.state` | text: read program_setup autoselect programming erase_window erasing suspended chip_erase program_error | C64: "read" |
+| `flash_low.base_state` | text: read program_setup autoselect programming erase_window erasing suspended chip_erase program_error | C64: "read" |
+| `flash_low.cycle` | int | C64: 0 |
+| `flash_low.toggle` | int | C64: 0 |
+| `flash_low.done_in` | int, optional | C64: absent |
+| `flash_low.programmed` | int, optional | C64: absent |
+| `flash_low.remaining` | int, optional | C64: absent |
+| `flash_low.erasing_sectors` | ints | C64: [] |
+| `flash_low.windows` | ints | C64: [] |
+| `flash_low.status_windows` | ints | C64: [] |
+| `flash_high.data` | bytes | C64: 524288 values |
+| `flash_high.state` | text: read program_setup autoselect programming erase_window erasing suspended chip_erase program_error | C64: "read" |
+| `flash_high.base_state` | text: read program_setup autoselect programming erase_window erasing suspended chip_erase program_error | C64: "read" |
+| `flash_high.cycle` | int | C64: 0 |
+| `flash_high.toggle` | int | C64: 0 |
+| `flash_high.done_in` | int, optional | C64: absent |
+| `flash_high.programmed` | int, optional | C64: absent |
+| `flash_high.remaining` | int, optional | C64: absent |
+| `flash_high.erasing_sectors` | ints | C64: [] |
+| `flash_high.windows` | ints | C64: [] |
+| `flash_high.status_windows` | ints | C64: [] |
+| `roms` | int | VIC-20: 0 |
+| `rom0.bytes` | bytes | VIC-20: [] |
+| `rom0.start` | word | VIC-20: 0 |
+
+## BL-TRAPDOS
+
+Written by the C64.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `storage.kind` | text: directory d64 d71 d81 t64 | "directory" |
+| `storage.path` | text | "" |
+| `storage.bytes` | bytes | [] |
+| `storage.read_only` | bool | false |
+| `ram` | bytes | 2048 × 0 |
+| `bam` | bool | true |
+| `status.kind` | text: channel | "channel" |
+| `status.writable` | bool | false |
+| `status.base` | int | 0 |
+| `status.length` | int | 0 |
+| `status.pointer` | int | 0 |
+| `status.lead` | int, optional | absent |
+| `status.buffer` | int, optional | absent |
+| `status.error` | ints | [] |
+| `status.bytes` | bytes | [] |
+| `channels` | ints | [] |
+| `serial.listening` | bool | false |
+| `serial.talking` | bool | false |
+| `serial.listen_channel` | int, optional | absent |
+| `serial.talk_channel` | int, optional | absent |
+| `serial.frame` | int | 240 |
+| `serial.buffer` | bytes | [] |
+| `save.saving` | bool | false |
+
+## BL-D8
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `model` | text: 1541 1571 1581 | C64: "1541" or "1581"; C128: "1541" or "1571" |
+| `phase` | int | 0 |
+| `cycles` | int | 0 |
+| `so_pending` | bool | false |
+| `serial.host` | int | 255 |
+| `atn` | bool | C64: true |
+
+## BL-D8-RAM
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `data` | byte | C64: 234 or 175; C128: 234 |
+| `ram` | bytes | C64: 2048 × 0 or 8192 × 0; C128: 2048 × 0 |
+
+## BL-D8-VIA1
+
+Written by the C64, C128.
+
+| 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-VIA2
+
+Written by the C64, C128.
+
+| 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-CPU
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `pc` | word | C64: 60064 or 44836; C128: 60064 |
+| `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-DISK
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `path` | text | "" |
+| `read_only` | bool | false |
+| `image.kind` | text: none d64 d71 g64 | "none" |
+| `image.path` | text | "" |
+| `image` | bytes | [] |
+| `track<N>.zone` | int, optional | absent |
+| `written` | ints | [] |
+| `changed` | ints | C64: [] |
+
+## BL-D8-MECH
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `half_track` | int | C64: 35; C128: 37 |
+| `slip` | int & 0x3 | C64: 0; C128: 2 |
+| `side` | int | C64: 0 or 1; C128: 85 |
+| `zone` | int & 0x3 | 3 |
+| `time` | int | 0 |
+| `read_clock_in` | int | 2097152 |
+| `clocks` | int | 0 |
+| `shift` | int | 0 |
+| `ones` | int | 0 |
+| `bits` | int | 0 |
+| `write_shift` | int | 0 |
+| `motor` | bool | C64: true or false; C128: true |
+| `led` | bool | true |
+| `sync` | bool | false |
+| `byte_ready` | bool | false |
+| `byte_latched` | bool | false |
+| `writing` | bool | false |
+| `write_gate` | bool | false |
+| `track_written` | bool | false |
+| `write_index` | int, optional | absent |
+| `cylinder` | int | C64: 0 |
+| `angle` | int | C64: 0 |
+| `changed` | bool | C64: true |
+
+## BL-D8-CIA
+
+Written by the C64, C128.
+
+| 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-D8-FDC
+
+Written by the C64, C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `now` | int | C64: 0 |
+| `phase` | text: idle spin_up stepped settled search read_data write_gate write_data read_track track_index write_track motor_idle index_interrupt settle_search read_address write_track_start starting | C64: "idle" |
+| `mode` | text: read write address verify_track | C64: "read" |
+| `due_in` | int, optional | C64: absent; C128: 0 |
+| `deadline_in` | int, optional | C64: absent |
+| `id_in` | int, optional | C64: absent |
+| `command` | byte | C64: 3 |
+| `track` | byte | C64: 0 |
+| `sector` | byte | C64: 1 |
+| `data` | byte | C64: 0 |
+| `status` | byte | 0 |
+| `steps` | int | C64: 0 |
+| `count` | int | C64: 0 |
+| `after_spin_up` | int | C64: 0 |
+| `found` | int | C64: -1 |
+| `index` | int | C64: 0 |
+| `crc` | int | C64: 65535 |
+| `write_id` | int | C64: 0 |
+| `size` | int | C64: 0 |
+| `type1` | bool | C64: true |
+| `drq` | bool | C64: false |
+| `intrq` | bool | C64: false |
+| `motor_on` | bool | C64: false |
+| `inward` | bool | C64: true |
+| `crc_good` | bool | C64: true |
+| `gate_open` | bool | C64: false |
+| `late` | bool | C64: false |
+| `settling` | bool | C64: false |
+| `bytes` | bytes | C64: [] |
+| `syncs` | ints | C64: [] |
+| `registers` | ints | C128: [0, 0, 0, 0] |
+| `result` | int | C128: 0 |
+
+## BL-VICI
+
+Written by the VIC-20.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `registers` | bytes | 16 × 0 |
+| `raster` | int | 0 |
+| `column` | int | 0 |
+| `window_open` | bool | false |
+| `window_done` | bool | false |
+| `row_start` | int | 0 |
+| `matrix` | int | 0 |
+| `char_line` | int | 0 |
+| `text_rows` | int | 0 |
+| `fetch_from` | int | 0 |
+| `fetched` | int | 0 |
+| `code` | byte | 0 |
+| `line.layout` | int | 0 |
+| `display` | bytes | 88608 × 0 |
+| `line.row` | int | 311 |
+| `line.painted` | int | 0 |
+| `line.written` | bool | false |
+| `line.patterns` | bytes | 12480 × 0 |
+| `line.colors` | bytes | 12480 × 0 |
+| `line.counts` | ints | 312 × 0 |
+| `line.starts` | ints | 312 × 0 |
+| `sound.shift_registers` | ints | [0, 0, 0, 255] |
+| `sound.lfsr` | int & 0xffff | 65535 |
+| `sound.level` | int | 0 |
+| `sound.ran_ago` | int | 0 |
+| `sound.next_shifts` | ints | [2048, 1024, 512, 256] |
+
+## BL-VIA1
+
+Written by the VIC-20.
+
+| 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-VIA2
+
+Written by the VIC-20.
+
+| 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-MMU
+
+Written by the C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `registers` | bytes | 12 values |
+| `p0h_latch` | int & 0xf | 0 |
+| `p1h_latch` | int & 0xf | 0 |
+
+## BL-VDC
+
+Written by the C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `registers` | bytes | 37 × 0 |
+| `ram` | bytes | 16384 × 0 |
+| `selected` | int & 0x3f | 0 |
+| `read_latch` | byte | 0 |
+| `write_data` | byte | 0 |
+| `phase` | int | 0 |
+| `line_units` | int | 126111744 |
+| `busy_for` | int | 0 |
+| `raster.frame` | int | 0 |
+| `raster.row` | int | 0 |
+| `raster.row_line` | int | 0 |
+| `raster.adjusting` | bool | false |
+| `raster.frame_line` | int | 0 |
+| `raster.frame_lines` | int | 1 |
+| `raster.sync_start` | int | 0 |
+| `raster.sync_lines` | int | 16 |
+| `display.width` | int | 128 |
+| `display.height` | int | 1 |
+| `window.display_start` | word | 0 |
+| `window.attribute_start` | word | 0 |
+
+## BL-Z80
+
+Written by the C128.
+
+| Key | Type | Default |
+| --- | --- | --- |
+| `a` | byte | 255 |
+| `f` | byte | 255 |
+| `b` | byte | 255 |
+| `c` | byte | 255 |
+| `d` | byte | 255 |
+| `e` | byte | 255 |
+| `h` | byte | 255 |
+| `l` | byte | 255 |
+| `af_alt` | word | 65535 |
+| `bc_alt` | word | 65535 |
+| `de_alt` | word | 65535 |
+| `hl_alt` | word | 65535 |
+| `i` | byte | 0 |
+| `r` | byte | 0 |
+| `pc` | word | 0 |
+| `sp` | word | 65535 |
+| `ix` | word | 65535 |
+| `iy` | word | 65535 |
+| `wz` | word | 0 |
+| `q` | byte | 0 |
+| `last_q` | byte | 0 |
+| `im` | int | 0 |
+| `cycles` | int | 0 |
+| `iff<N>` | bool | false |
+| `halted` | bool | false |
+| `after_ei` | bool | false |
+| `after_ld_a_ir` | bool | false |
+| `int` | bool | false |
+| `nmi` | bool | false |
+| `nmi_pending` | bool | false |