How aboutuip/zeros-system-pro works
ZerOS-System-Pro is a browser-based teaching virtual machine, with a separate Obr-to-ZAP host compiler. The documented user journey is power-on and boot, motherboard hardware setup, then firmware loading a kernel from NAS onto CPU core 2; the display presents the machine state and keyboard supplies input. The graph also preserves the compiler’s source-to-binary capability. README-level behavior is included where source excerpts were unavailable; edges are limited to documented wiring and sampled dispatch behavior.
Main entry points: Boot.ts Firmware boot · QueuedWorker.ts Queued workers · BoardDispatch.ts Board dispatch · MemoryController.ts Memory controller
Components 21
Boot and display
- Firmware boot
ZerOS-PRO/Boot/Boot.ts - Display host
ZerOS-PRO/Hardware/Display/Host/PageHost.ts - Keyboard input
ZerOS-PRO/Hardware/Display/Host/PublishKeyboard.ts
Board coordination
- Motherboard
ZerOS-PRO/Hardware/Motherboard/Bootstrap/Motherboard.ts - Board dispatch
ZerOS-PRO/Hardware/Motherboard/Host/BoardDispatch.ts - Hardware query
ZerOS-PRO/Hardware/Motherboard/Host/HardwareQuery.ts - Queued workers
ZerOS-PRO/Hardware/Motherboard/Host/QueuedWorker.ts
Virtual hardware
- CPU runtime
ZerOS-PRO/Hardware/Cpu/Bootstrap/CpuRuntime.ts - Core execution
ZerOS-PRO/Hardware/Cpu/Host/CoreDispatch.ts - Memory controller
ZerOS-PRO/Hardware/Memory/Controller/MemoryController.ts - Memory unit
ZerOS-PRO/Hardware/Memory/Unit/MemoryUnit.ts - Memory blocks
ZerOS-PRO/Hardware/Memory/Block/MemoryBlock.ts - GPU runtime
ZerOS-PRO/Hardware/Gpu/Bootstrap/GpuRuntime.ts - WebGPU acceleration
ZerOS-PRO/Hardware/Gpu/Bootstrap/WebGpuAccel.ts - NAS service
ZerOS-PRO/Hardware/Nas/Server/serve.mjs
Obr compiler
- Obr compiler CLI
Compiler/Obr/src/obrc.cpp - Lexer
Compiler/Obr/src/Lexer.cpp - Parser
Compiler/Obr/src/Parser.cpp - Semantic analysis
Compiler/Obr/src/Sema.cpp - Code generation
Compiler/Obr/src/codegen/Generate.cpp
Other components
- User
Connections 23
- User → Firmware boot: powers on
- Firmware boot → Motherboard: starts board
- Firmware boot → Display host: presents boot
- Display host → User: shows output
- User → Keyboard input: presses keys
- Keyboard input → Display host: publishes input
- Motherboard → Board dispatch: dispatches work
- Board dispatch → Hardware query: queries hardware
- Board dispatch → Queued workers: opens workers
- Queued workers → CPU runtime: loads module
- Queued workers → Memory controller: loads module
- Queued workers → GPU runtime: loads module
- CPU runtime → Core execution: schedules cores
- Memory controller → Memory unit: creates units
- Memory controller → Memory blocks: creates blocks
- GPU runtime → WebGPU acceleration: runs acceleration
- Firmware boot → NAS service: loads kernel
- NAS service → CPU runtime: supplies binary
- User → Obr compiler CLI: compiles source
- Obr compiler CLI → Lexer: lexes source
- Lexer → Parser: provides tokens
- Parser → Semantic analysis: provides syntax
- Semantic analysis → Code generation: provides checked program