How protossgp32/omega works
Project type and purpose
• This is a fully open-source hardware implementation of an MSX2-compatible home computer (“Omega”).
• It comprises: a keyboard PCB, a main motherboard PCB, a BIOS flash image, an enclosure design, and supporting KiCad libraries plus build scripts.
File structure
• Top-level directories:
• BIOS – firmware binaries and ROM-building script
• Keyboard – KiCad PCB, schematic, gerbers, docs
• Mainboard – KiCad PCB, schematic, SPLD source, gerbers, docs
• Enclosure – mechanical CAD (.scad, .dxf, .stl), drawings
• kicad_libraries – custom footprint & 3D models
• README*.md – project overview & per-module guides
• Build scripts: BIOS/make_roms.sh
• CAD files (.scad, .dxf) for the enclosure.
Key insights from README
• Implements core MSX2 subsystems: Z80 CPU, VDP (V9958), PSG (YM2149F), PPI (8255), SRAM, Flash, SPLDs for glue logic, 7400-series TTL.
• Keyboard stacks on top of main board inside a 3D-printed or laser-cut enclosure.
Main components and their interactions
a. Digital CPU & glue logic domain
• Z80 CPU
• Flash ROM (BIOS) & SRAM mapped on Z80 bus
• ATF16V8B SPLDs (chip_select, slot_dir, slot_select) implement address decoding / bus arbitration
• 74xx TTL gates (glue for reset, interrupts)
b. Video & audio subsystems
• V9958 VDP — connects to Z80 data/address bus and to video output connector
• AY-3-8910 PSG — connects to Z80 via PPI or direct bus lines, drives audio out
c. I/O and peripherals
• 8255 PPI interfaces keyboard matrix, joystick ports, cassette I/O
• Edge connectors / slots for cartridge expansion
• Mini-DIN, RCA, edge-connector I/O on rear panel
d. Keyboard PCB
• Key matrix scanned by PPI on mainboard bus
• Ribbon cable / pin header between keyboard and mainboard
e. Enclosure
• Mechanical housing holds stacked PCBs, external connectors, and cables
• CAD models for 3D printing or laser cutting
Relationships & data-flows
• Z80 CPU at center:
→ reads BIOS from Flash, executes code
→ reads/writes SRAM
→ issues address lines to SPLDs → selects ROM/RAM/VDP/PSG/PPI
→ communicates with VDP for video memory and registers → video out
→ communicates with PSG → audio out
→ reads keyboard scan data via PPI → user input
• SPLD blocks: decode CPU address lines → generate chip‐select signals for each peripheral
• PPI: multiplexes data bus to keyboard matrix lines / joystick lines
• Clock & reset distribution: 74xx logic ensures correct timing and boot reset
Architectural patterns & design principles
• Classic bus architecture: single shared data/address bus, multiplexed by glue logic
• Modular PCB stacking: keyboard stack with standoffs onto mainboard for mechanical simplicity
• Separation of concerns: distinct PCBs for input (keyboard) and core logic (mainboard)
• Open CAD toolchain: KiCad for PCBs, OpenSCAD and DXF for mechanical