0cd2dc2062
The architectural heart of the retro computer, proven on real chips. A Z80, a 32K ROM, a 64K RAM and an inverter (address-decode glue) are wired chip-to-chip over a shared address + data bus, no board: ROM at 0x0000-0x7FFF rom.CE = A15 RAM at 0x8000-0xFFFF ram.CE = NOT A15 (the inverter chip) RD -> both OE ; WR -> RAM WE The ROM program writes 0x5A to RAM at 0x8000, clears A, reads it back, and HALTs only if the byte survived. HALT going low proves the full core works: the Z80 runs from ROM, the inverter decodes A15 to select RAM (the settle kernel drives the combinational glue across hops), and the RAM latches a write and returns it on a read over the shared tri-state bus, all within synchronous bus cycles. Adds z80-ram-rom.c (boot image) + ram-64k/inverter fixtures. 37 chipbus tests across 7 files pass. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| fixtures | ||
| scripts | ||
| sdk | ||
| sketches | ||
| src | ||
| test | ||
| .gitignore | ||
| README.md | ||
| package-lock.json | ||
| package.json | ||
| vitest.config.js | ||
README.md
test_custom_chips
Sandbox aislado para validar el sistema de custom chips de Velxio antes de integrarlo al frontend. Cero dependencia de Wokwi.
Objetivos
- Probar que se puede cargar un
.wasm(chip compilado a partir de C) y enrutarlo al simulador. - Probar que un sketch de Arduino real (
.hexcompilado conarduino-cli) puede comunicarse con el chip vía GPIO e I2C. - Mantener fidelidad 1:1 con la infraestructura de Velxio (
PinManager,I2CBusManager,AVRSimulator) para que el código que se valide acá sea trivial de portar.
Estructura
test_custom_chips/
├── package.json
├── README.md
├── vitest.config.js
├── sdk/
│ ├── include/
│ │ └── velxio-chip.h ← API que ven los chips
│ └── examples/
│ ├── inverter.c
│ ├── inverter.chip.json
│ ├── eeprom-24c01.c
│ └── eeprom-24c01.chip.json
├── scripts/
│ ├── compile-chip.sh ← clang invocation Linux/macOS
│ ├── compile-chip.ps1 ← clang invocation Windows
│ ├── compile-all.sh ← compila todos los ejemplos
│ └── setup-wasi-sdk.md ← cómo instalar wasi-sdk
├── src/ ← runtime y mirrors de Velxio
│ ├── ChipRuntime.js ← loader WASM + host imports
│ ├── WasiShim.js ← WASI mínimo (fd_write, proc_exit)
│ ├── PinManager.js ← espejo de Velxio
│ ├── I2CBus.js ← espejo del I2CBusManager
│ ├── AVRHarness.js ← avr8js wrapper Velxio-fiel
│ ├── intelHex.js ← parser
│ └── index.js
├── fixtures/ ← .wasm compilados + .hex sketches
└── test/
├── js/ ← tests que NO requieren clang
│ ├── 01_pin_manager.test.js
│ ├── 02_i2c_bus.test.js
│ ├── 03_avr_harness.test.js
│ └── 04_runtime_imports.test.js
└── e2e/ ← tests que requieren .wasm compilado
├── 05_chip_inverter.test.js
└── 06_chip_eeprom_24c01.test.js
Quickstart
# 1. Instalar deps
cd test/test_custom_chips
npm install
# 2. (Solo para tests E2E) instalar wasi-sdk siguiendo scripts/setup-wasi-sdk.md
# 3. (Solo para tests E2E) compilar los ejemplos
npm run compile:examples
# 4. Correr tests
npm test # todo
npm run test:js # solo tests JS-only (no requieren wasi-sdk)
npm run test:e2e # solo E2E con WASM
Los tests e2e/ se hacen it.skip automáticamente si el .wasm correspondiente no
está en fixtures/. Eso permite correr la suite parcialmente sin tener wasi-sdk instalado.
Por qué un sandbox separado
Igual que test_circuit/ validó el solver SPICE antes de integrarlo, este sandbox valida
el runtime de chips antes de tocar el frontend de Velxio. Cuando los tests pasen end-to-end,
los archivos de src/ se portan al frontend (con tipado TS) e integran con el editor.
Estado actual
Ver ../autosearch/04_findings.md para el log corrido de qué funciona y qué falta.