velxio/frontend/src/services/romCompileService.ts

76 lines
2.2 KiB
TypeScript
Raw Normal View History

feat(chips): programmable retro CPU chips with external ROM Adds a new way to use the retro CPU chips: write your program in a project file (.s / .asm / .hex / .bin), click Compile, click Run, and the same chip emulates whatever you wrote. Same chip + different ROMs = mini PC, calculator, LED demo, Kill-the-Bit game, etc. SDK: - velxio-chip.h gets two new host imports: uint32_t vx_rom_size(void); void vx_rom_read(uint32_t off, uint8_t* dst, uint32_t len); CPU-emulator chips call these in chip_setup to pull their program out of the host's romBytes property. Frontend runtime: - ChipRuntime accepts opts.romBytes (Uint8Array) and exposes the new imports, copying bytes into chip memory on vx_rom_read. - CustomChipPart pulls component.properties.romBytes (base64) and passes it through. - Component registry declares three new custom-chip properties: romBytes (base64), programFile (matching project filename), and programTarget (cpu name). New programmable bundled chip: - frontend/src/components/customChips/examples/intel/i8080-cpu.{c,chip.json} Same clean-room 8080 emulator as i8080-repl/i8080-counter, but ROM is loaded externally via vx_rom_*. Has 8 LEDs, 8 buttons, UART, 16 KB RAM, 32 KB of external ROM. Backend: - New /api/compile-rom endpoint and rom_compile service that turns chip-program source into ROM bytes. 8080 ASM is assembled by the in-tree two-pass assembler (moved to backend/app/services/asm8080.py). Intel HEX records are parsed; raw .bin is passed through. Future targets (z80, 8086, 4004) are scaffolded but not wired yet. EditorToolbar: - Compile button detects when the active file is .s/.asm/.hex/.bin and routes to compile-rom instead of arduino-cli. The compiled bytes are injected into every custom-chip on the canvas whose programFile property matches the active filename (or is empty). Example: - /examples/i8080-killbits loads Dean McDaniel's 1975 Kill-the-Bit on the programmable i8080-cpu chip. killbits.s is shipped as a project file alongside sketch.ino; the user clicks Compile then Run and the LED walks across 8 outputs, buttons kill it. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-19 09:38:18 +07:00
/**
* Frontend wrapper for POST /api/compile-rom compiles a chip-program file
* (8080 ASM, Intel HEX, raw .bin) into base64 ROM bytes that get stored on
* a custom-chip component's `romBytes` property. The chip's emulator then
* reads those bytes at chip_setup via vx_rom_size / vx_rom_read.
*/
export type RomTarget = '8080' | 'z80' | '8086' | '4004';
export type RomFormat = 'asm' | 'hex' | 'bin';
export interface RomCompileResult {
success: boolean;
rom_base64: string | null;
byte_size: number;
stderr: string;
error: string | null;
}
const BASE = '/api/compile-rom';
export async function compileRom(
source: string,
target: RomTarget,
format: RomFormat,
): Promise<RomCompileResult> {
const res = await fetch(`${BASE}/`, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
credentials: 'include',
body: JSON.stringify({ source, target, format }),
});
if (!res.ok) {
const text = await res.text();
return {
success: false,
rom_base64: null,
byte_size: 0,
stderr: '',
error: `HTTP ${res.status}: ${text}`,
};
}
return (await res.json()) as RomCompileResult;
}
/** Classify a filename as a chip-program file (vs an Arduino sketch). */
export function isChipProgramFile(name: string): boolean {
const lower = name.toLowerCase();
return (
lower.endsWith('.s') ||
lower.endsWith('.asm') ||
lower.endsWith('.hex') ||
lower.endsWith('.bin')
);
}
/** Pick a sensible compile format from the filename extension. */
export function formatForFile(name: string): RomFormat {
const lower = name.toLowerCase();
if (lower.endsWith('.hex')) return 'hex';
if (lower.endsWith('.bin')) return 'bin';
return 'asm';
}
/** Pick the right target CPU from the chip's chip.json programTargets,
* falling back to 8080 (the only one wired up today). */
export function targetForChip(chipJsonStr: string): RomTarget {
try {
const obj = JSON.parse(chipJsonStr);
if (Array.isArray(obj.programTargets) && obj.programTargets.length > 0) {
const t = String(obj.programTargets[0]).toLowerCase();
if (t === '8080' || t === 'z80' || t === '8086' || t === '4004') return t;
}
} catch { /* ignore */ }
return '8080';
}