VIBEDRONE BEEWOLF 400  -  SYSTEM MANIFEST
BUILD     
SOURCE    single HTML file, GPLv3, (c) 2026 Graham Upshall
ROMS      not included - supply your own legally obtained images
Portions (c) and (tm) Microbee Technology Pty Ltd. Hobbyist use only.

MODELS  (chosen at the launch screen)
PC85 ROM      Premium PC85: BASIC 5.29e ROM A + B, CHARROM,
              PAK slots C E F G H I, NET socket (D)
PREMIUM CF    Premium CF / PCF, 512K: CF boot ROM, CF card image,
              optional floppy

PROCESSOR
CPU           Z80, ZEXDOC passed
Interrupts    IM2 vectored via PIO A then PIO B (A has priority)
              IM0 / IM1 go to 0038h
PIO poll      every 256 T-states

SPEED   (GT button cycles, slider scales 1-100%)
2 MHz         40,000 T per 20 ms tick
3.375 MHz     67,500 T per tick      default, button reads "GT"
5 MHz (GT)    100,000 T per tick     button reads "GT ok"
6.75 MHz      135,000 T per tick     marked unstable
Timing        50 ticks per second, up to 40 ms catch-up per call,
              backlog capped at 1 s. All timing is in T-states.

MEMORY MAP  (Premium CF)
0000-7FFF     RAM, 32K window onto 512K = 16 banks (port 50h)
8000-9FFF     CF boot ROM, 8K  (RAM when ROM disabled)
8000-8FFF     VDU instead, when port 50h bit 4 is set
A000-EFFF     RAM (the upper 32K is always bank 0)
F000-F7FF     screen RAM | attribute RAM | CHARROM (port 0Bh bit 0)
F800-FFFF     PCG | colour RAM (port 08h bit 6)
Power-on      RAM filled 00 FF alternating

Port 50h      bits 0,1,6,7 = bank 0-3 (bit 1 XOR bit 2)
              bit 2 ROM off   bit 3 video RAM off
              bit 4 VDU at 8000h   bit 5 ROM select (latched)
Port 51h      latched, adds no banks beyond 16

VIDEO
Controller    6545-style register file, 32 bytes, write masks,
              R16/R17 light-pen latch
Text modes    64 x 16 default, 80 columns when R1 is 80 or more
              rows from R6 (1-32), 8 x 16 cells
PCG           8 banks x 2K backed (banks 8-15 read as zero)
Other RAM     2K attribute, 2K colour, 2K screen
Colour        16-colour palette, COLOUR picker
80-col font   second half of a 4K CHARROM, else derived from 64-col
Frame         108 x 313 characters x 2 T = 67,608 T
              about 49.9 Hz at 3.375 MHz
Sync          status bit 5 = vblank, PIO B bit 4 = VSYNC pulse

I/O PORTS  (Premium CF)
00 01         PIO A data / control
02 03         PIO B data / control
              out bit 6 = speaker, in bit 4 = vsync, bits 2-3 = mouse
04 06 07      RTC address / write / read
08            colour / PCG select
0B            CHARROM select, light-pen gate
0C 0D         CRTC address / data
18  1C        PCG bank (1C bits 0-3), attribute select (1C bit 4)
1F            bit 0 latched
44-47         WD2793: command/status, track, sector, data
48            floppy latch / side status
50  51        RAM bank / latch
60-67  70     ATA task file / device control

STORAGE
CF card       ATA PIO: IDENTIFY, SET FEATURES, READ, WRITE, SEEK
              geometry 304 / 4 / 32
              busy, DRQ and sector-gap timing in T-states
Partitions    MBR 55AA, type DB (CP/M), up to 4 = drives A to D
              4096-byte blocks, 512 directory entries, 32K reserved
              block counts 1203 / 1270 / 1270 / 1628
Floppy        WD2793, MFM 250 kbit/s = 108 T per byte, lost data modelled
              Type I, II, IV and Read Address supported
              Read / Write Track not supported
              DS40 (40x2), SS80 (80x1), DS80 DS82 DS84 DS8B (80x2)
              all 10 x 512 byte sectors, raw and CPCEMU containers
F-BOOT        holds F at cold boot, released at the first floppy read
FOLDER        8.3 files, 300K max, read-only DS80 data disk on E:
              (not bootable - no system tracks)
SWITCH B:     hot-swap B: original / partition 5 / partition 6
EXPORT        download the CF image, filename increments
Files needed  CHARROM 4K, CF ROM 8K (BN56CF / PCF), CF image,
              optional .dsk - all cached once loaded

INPUT
Keyboard      Premium matrix via CRTC light-pen raster match
Mouse         1: packets into the MOUSE.SYS queue (E6EC-E6F4),
                 5 bytes, 25 ms sampling
              2: bit-banged PIO B frames, 3 bytes x 9 bits,
                 2812.5 T per bit = 1200 baud
Other         KBD (on-screen keyboard), PASTE

SOUND
Speaker       1-bit, PIO B bit 6, edge-timestamped into WebAudio
              gain 0.6, about 20 Hz high-pass
Key click     auto-silenced once the Shell has initialised

CLOCK
RTC           64-byte, follows the host clock, BCD or binary, 12/24 h

SNAPSHOTS AND DUMPS
SNAP          CF: .cf400, VDCFSNAP v1, 547,025 bytes
              CPU registers, ports 50 51 08 1C, PIO A and B,
              CRTC registers, PCG + attribute + colour + screen RAM,
              full 512K RAM
              PC85 uses .400
Title bee     click = RAMALL.BIN full dump, shift-click = RAM64K.BIN

BUTTONS
All           COLOUR  MOUSE  GT / SPEED  KBD  PASTE  PAUSE  RESET
              SNAP  LOAD.400  SCREEN
CF only       FLOPPY  F-BOOT  FOLDER  EXPORT  SWITCH B:
PC85 only     ROMS  ROM SLOTS  LOAD  SAVE

HONEST GAPS
- Floppy Read / Write Track (WD2793 Type III) not supported
- FOLDER mount is a synthesised CP/M disk, read-only
- VBLANK and VSYNC come from one CRTC-derived signal
- 6.75 MHz exceeds what the interpreter reliably sustains