stm32f4-emu 0.1.0 → 1.1.1

package/README.md

@@ -1,10 +1,14 @@
-# STM32F4 Emulator
+# STM32F4 Emulator (`stm32f4-emu`)
 
+[![npm version](https://img.shields.io/npm/v/stm32f4-emu.svg)](https://www.npmjs.com/package/stm32f4-emu)
+[![npm downloads](https://img.shields.io/npm/dm/stm32f4-emu.svg)](https://www.npmjs.com/package/stm32f4-emu)
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE)
 [![CI](https://github.com/danish9661/stm32F4-emulator/actions/workflows/ci.yml/badge.svg)](https://github.com/danish9661/stm32F4-emulator/actions/workflows/ci.yml)
 [![Pages](https://github.com/danish9661/stm32F4-emulator/actions/workflows/pages.yml/badge.svg)](https://github.com/danish9661/stm32F4-emulator/actions/workflows/pages.yml)
 
 An STM32F407 microcontroller emulator that runs real Cortex-M4 firmware. It
-combines a **Unicorn CPU core** (QEMU-derived, compiled to WASM) with a
+combines a **Rust CPU core** (a WASM-native Thumb-2 interpreter with exact
+Cortex-M exception entry/return, including the VFPv4-SP FPU) with a
 **Rust peripheral model** (RCC, USART, GPIO, DMA, ETH, TIM, NVIC, ...) also
 compiled to WASM — so the whole machine runs headless in **Node.js or a
 browser tab**, with no SDL, no native deps, no hardware.
@@ -29,18 +33,18 @@ scripted network (netsim) as fallback, a live UART terminal (with **UART
 RX input** — type into the console and the firmware reads it; newline
 characters excluded per HTML spec, see AGENTS.md §11), GPIO pin readout
 for banks A–E, and key peripheral registers. Interrupt-driven firmware
-(`rx_interrupt_test`, `rx_crypto_test`) is serviced by an opt-in guest-IRQ
-pump; polling firmware (the ETH demos) never uses it. For automation, a
+(`rx_interrupt_test`, `rx_crypto_test`) gets inline guest-IRQ delivery;
+polling firmware (the ETH demos) never uses it. For automation, a
 preset can auto-boot via the URL: `?fw=eth_http`, `?fw=blinky`, `?fw=crypto_test`, …
 
 ## DOOM (in the browser)
 
 **[`site/doom.html`](site/doom.html)** runs DOOM 1 shareware
-(doomgeneric, ported to the emulated F407) at ~25 FPS in a
-headless-Chrome-verified browser page — playable, but below DOOM's native
-35 fps: at ~918k guest instructions per rendered frame, 35 fps would need
-~32 MIPS and the Unicorn WASM core tops out near 20-24 (details and the
-measurements in AGENTS.md §16). Because the guest mixes one frame of audio
+(doomgeneric, ported to the emulated F407) at the full 35 fps in a
+headless-Chrome-verified browser page — playable: at ~1M guest instructions
+per rendered frame, 35 fps needs ~32 MIPS and the Rust core delivers ~65
+(details and the measurements in AGENTS.md §16/§22). Because the guest mixes
+one frame of audio
 per rendered frame, sound below 35 fps plays slightly slow and pitched-down
 rather than breaking up — the worklet rate-matches instead of inserting
 gaps, and the stats line reports it (`audio 0.72x`). The page: 320×200
@@ -72,6 +76,10 @@ npm run serve                  # then open http://127.0.0.1:8123
 # node end-to-end flow test (boot -> DHCP -> TCP -> HTTP, 2 rounds)
 npm test                       # == node site/test_flow.mjs
 
+# websocket bridge: headless Node serves the emulator, browser is a thin UI
+npm run bridge -- blinky/blinky.bin --port 8234
+# then open http://127.0.0.1:8123?bridge=ws://127.0.0.1:8234
+
 # gateway-backed run: firmware talks to a REAL network stack (gVisor)
 cd stm32-periph-wasm/pkg
 node cli.mjs ../../eth_http/eth_http.bin 10000000 \
@@ -126,6 +134,29 @@ as a library stays dependency-free; only MCP users need
 `npm i @modelcontextprotocol/sdk zod`. See [docs/mcp.md](docs/mcp.md) for
 the tool reference and client config.
 
+## WebSocket bridge (headless Node ↔ browser UI)
+
+A binary WebSocket protocol so the browser console can drive the emulator
+running headlessly in Node — all WASM execution stays in Node, the browser
+is a thin UI. Zero impact on the existing local WASM path:
+
+```bash
+# 1. Start the bridge in Node (serves the emulator over WS on port 8234)
+node site/ws-bridge.mjs eth_http/eth_http.bin --port 8234
+
+# 2. Open the browser console with the bridge URL param
+open "http://127.0.0.1:8123/?bridge=ws://127.0.0.1:8234"
+```
+
+The `RemoteEmu` adapter (`site/remote-emu.js`) is a drop-in replacement
+for the local `emu` object — same `step()`/`drainUart()`/`read32()` API,
+all proxied over binary WebSocket. Device stubs (OLED/TFT/etc.) run in
+Node and are not visible to browser JS. Without `?fw=`, the page boots
+whatever firmware the bridge was started with; with `?fw=blinky&bridge=ws://…`,
+the browser sends the firmware image over the bridge.
+
+See AGENTS.md §20 for the full binary protocol reference.
+
 ## Firmwares
 
 | Firmware | What it does | Success marker |
@@ -152,9 +183,9 @@ watchdog timeouts close to spec) will diverge — see docs/progress-and-future.m
 ## Architecture
 
 ```
-firmware .bin ──► Unicorn WASM CPU ──► memory hooks
+firmware .bin ──► Rust WASM CPU (Thumb-2 + NVIC/exceptions)
                           │
-                    periph_read/write ──► Rust peripheral model (WASM)
+              peripheral MMIO ──► Rust peripheral model (WASM)
                                           RCC USART GPIO DMA ETH TIM NVIC
                           │
                     UART out / ETH TX frames ──► driver (cli.mjs / site/emulator.js)
@@ -162,9 +193,10 @@ firmware .bin ──► Unicorn WASM CPU ──► memory hooks
                     RX frames injected (netsim, or real gVisor gateway)
 ```
 
-- **CPU**: Unicorn 2.1.4 compiled to WASM executes Thumb-2 code; every
-  read/write to a hooked MMIO range is routed into the Rust model, which
-  answers by writing the modeled register value back into guest memory.
+- **CPU**: a pure-Rust Cortex-M4 Thumb-2 interpreter compiled to WASM;
+  peripheral accesses call straight into the Rust model, and guest IRQs
+  (SysTick, ETH, USART, SVC/PendSV) are delivered inline with exact
+  exception stacking — no native deps, no JIT, no hooks.
 - **Peripherals**: a `wasm-bindgen` crate (`stm32-periph-wasm/`); registers
   and bit fields come from the vendor SVD (`monox/stm32f407.svd`).
 - **Ethernet**: TX is captured from the DMA descriptors; RX frames are
@@ -193,8 +225,8 @@ firmware .bin ──► Unicorn WASM CPU ──► memory hooks
 │   ├── test_blinky.mjs      Node blinky GPIO test (npm test)
 │   ├── test_rx_interrupt.mjs Node UART-interrupt test (npm test)
 │   ├── test_component_*.mjs Component-API tests, one firmware each (npm test)
-│   ├── test_doom.mjs        Node DOOM boot/menu/gameplay/save test
-│   └── vendor/              Browser WASM build, SVD, Unicorn
+│   ├── test_doom_wasm.mjs  Node DOOM boot/menu/gameplay/save test
+│   └── vendor/              Browser WASM build (CPU + peripherals), SVD
 ├── index.mjs, package.json  npm package entry (stm32f4-emu)
 ├── mcp/                     MCP server (drive the emulator from an AI agent)
 ├── .github/workflows/       CI (Linux/Windows/macOS test matrix) + Pages deploy
@@ -246,6 +278,7 @@ rebuild — delete it so the vendor assets stay tracked/committed.
 
 ## Documentation
 
+- [site/about.html](site/about.html) — in-repo About page: what it is, architecture, featured firmwares, and how to use it (CLI / browser / Node API / MCP).
 - [docs/architecture.md](docs/architecture.md) — how the emulator is put
   together (CPU, peripheral model, drivers, ETH flow, interrupts).
 - [docs/peripherals.md](docs/peripherals.md) — all 33 peripherals and the
@@ -262,12 +295,8 @@ rebuild — delete it so the vendor assets stay tracked/committed.
 - [docs/progress-and-future.md](docs/progress-and-future.md) — status,
   known limitations, roadmap.
 
-## License
-
-GPL-3.0-only. See [LICENSE](LICENSE).
+## License & Credits
 
-*This repository is a fork/continuation of
-[nviennot/stm32-emulator](https://github.com/nviennot/stm32-emulator), which
-emulated 3D-printer firmwares (Elegoo Saturn, Anycubic Mono X) in a native
-SDL app. The WASM headless emulator, network firmwares, browser demo, and npm
-package are new work built on that base.*
+- **License**: GPL-3.0-only. See [LICENSE](LICENSE).
+- **Heritage**: Fork and continuation of [nviennot/stm32-emulator](https://github.com/nviennot/stm32-emulator) (native SDL 3D printer emulator by Nicolas Viennot). The headless WASM peripheral model, networking stack, browser demo, virtual components API, MCP server, and npm package are new work built on that base.
+- **DOOM**: Ported using [doomgeneric](https://github.com/ozkl/doomgeneric) by Ozkan Sezgin.

package/cli.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+// stm32f4-emu — headless CLI to load and run an STM32F4 firmware image.
+//
+//   stm32f4-emu <firmware> [--inst N] [--format auto|bin|hex|elf] [--verbose]
+//                   [--lowpower]
+//
+// Loads a .bin/.elf/.hex firmware, boots it in the emulator, and streams the
+// guest UART to stdout. Peripheral register accesses are traced to stderr when
+// --verbose is given. With --lowpower, the core halts on WFI/WFE and the
+// emulator advances the virtual RTC until a wakeup source (e.g. an RTC alarm)
+// fires — so firmware that enters STOP (e.g. deep_sleep_demo.bin) runs.
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import * as bindings from './site/vendor/stm32_periph_wasm.js';
+import { createEmulator } from './site/emulator.js';
+import { parseIntelHex, parseElf } from './site/loaders.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const svdXml = readFileSync(resolve(__dirname, 'site/vendor/stm32f407.svd'), 'utf8');
+const wasmBytes = new Uint8Array(readFileSync(resolve(__dirname, 'site/vendor/stm32_periph_wasm_bg.wasm')));
+const pkg = JSON.parse(readFileSync(resolve(__dirname, 'package.json'), 'utf8'));
+
+const USAGE = `stm32f4-emu — run an STM32F4 firmware image in the emulator
+
+Usage:
+  stm32f4-emu <firmware> [options]
+
+Arguments:
+  <firmware>            path to a firmware image (.bin, .elf, or .hex)
+
+Options:
+  -n, --inst <N>        instruction budget to run (default 20000000)
+  -f, --format <fmt>    firmware format: auto|bin|hex|elf (default auto)
+  -v, --verbose         trace guest PCs to stderr (capped per step)
+  -l, --lowpower        halt on WFI/WFE and advance the virtual RTC until wakeup
+  -h, --help            show this help
+  -V, --version         show version
+
+Examples:
+  stm32f4-emu build/firmware.bin
+  stm32f4-emu app.elf --inst 5000000 --verbose
+  stm32f4-emu deep_sleep_demo.bin --lowpower
+`;
+
+function fail(msg) {
+    process.stderr.write(msg + '\n\n' + USAGE);
+    process.exit(2);
+}
+
+function detectFormat(buf, format) {
+    if (format !== 'auto') return format;
+    if (buf[0] === 0x7F && buf[1] === 0x45 && buf[2] === 0x4C && buf[3] === 0x46) return 'elf';
+    let i = 0;
+    while (i < buf.length && (buf[i] === 0x20 || buf[i] === 0x09 || buf[i] === 0x0D || buf[i] === 0x0A)) i++;
+    if (buf[i] === 0x3A) return 'hex'; // ':'
+    return 'bin';
+}
+
+async function main() {
+    const args = process.argv.slice(2);
+    let firmwarePath = null;
+    let inst = 20000000;
+    let format = 'auto';
+    let verbose = false;
+    let lowpower = false;
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '-h' || a === '--help') { process.stdout.write(USAGE); process.exit(0); }
+        if (a === '-V' || a === '--version') { process.stdout.write(`stm32f4-emu ${pkg.version}\n`); process.exit(0); }
+        if (a === '-v' || a === '--verbose') { verbose = true; continue; }
+        if (a === '-l' || a === '--lowpower') { lowpower = true; continue; }
+        if (a === '-n' || a === '--inst') {
+            const v = args[++i];
+            inst = Number(v);
+            if (!Number.isFinite(inst) || inst <= 0) fail(`invalid --inst value: ${v}`);
+            continue;
+        }
+        if (a === '-f' || a === '--format') {
+            format = args[++i];
+            if (!['auto', 'bin', 'hex', 'elf'].includes(format)) fail(`invalid --format: ${format}`);
+            continue;
+        }
+        if (a.startsWith('-')) fail(`unknown option: ${a}`);
+        if (firmwarePath) fail('multiple firmware paths given');
+        firmwarePath = a;
+    }
+    if (!firmwarePath) fail('no firmware path given');
+
+    let raw;
+    try {
+        raw = new Uint8Array(readFileSync(firmwarePath));
+    } catch (e) {
+        fail(`cannot read firmware '${firmwarePath}': ${e.message}`);
+    }
+
+    const fmt = detectFormat(raw, format);
+    let firmware, extra_mem = [];
+    try {
+        if (fmt === 'elf') {
+            const elf = parseElf(raw);
+            if (!elf.flash) fail('ELF contains no FLASH segment (expected a segment at 0x08000000)');
+            firmware = elf.flash;
+            extra_mem = elf.extraMem || [];
+        } else if (fmt === 'hex') {
+            const hex = parseIntelHex(Buffer.from(raw).toString('latin1'));
+            if (!hex.flash) fail('Intel HEX contains no FLASH records (expected data in the 0x08000000 range)');
+            firmware = hex.flash;
+        } else {
+            firmware = raw;
+        }
+    } catch (e) {
+        fail(`failed to parse ${fmt} firmware: ${e.message}`);
+    }
+
+    let emu;
+    try {
+        emu = await createEmulator({
+            firmware, bindings, svdXml, wasmInit: wasmBytes,
+            extra_mem, lowpower,
+        });
+    } catch (e) {
+        fail(`emulator failed to load firmware: ${e.message}`);
+    }
+
+    const STEP = 100000;
+    let remaining = inst;
+    let lastInst = 0;
+    try {
+        while (remaining > 0) {
+            const take = Math.min(STEP, remaining);
+            if (verbose) { try { emu.traceStart(); } catch {} }
+            const r = emu.step(take);
+            if (verbose) {
+                try {
+                    const pcs = emu.takeTrace() || [];
+                    const tail = pcs.slice(-8).map((p) => `0x${(p >>> 0).toString(16)}`).join(' ');
+                    if (tail) process.stderr.write(`[trace]${tail}\n`);
+                } catch {} finally { try { emu.traceStop(); } catch {} }
+            }
+            remaining -= (r.instCount - lastInst);
+            lastInst = r.instCount;
+            const u = emu.drainUart();
+            if (u && u.length) process.stdout.write(u.toString());
+            if (r.stopped) break;
+        }
+        const tail = emu.drainUart();
+        if (tail && tail.length) process.stdout.write(tail.toString());
+    } finally {
+        try { emu.close(); } catch {}
+    }
+}
+
+main().catch((e) => {
+    process.stderr.write(`stm32f4-emu: ${e.message}\n`);
+    process.exit(1);
+});

package/index.d.ts

@@ -0,0 +1,48 @@
+/// <reference types="node" />
+
+import { createEmulator, CreateEmulatorOpts, EmulatorHandle } from './site/emulator.js';
+
+export * from './site/emulator.js';
+
+export interface CreateSTM32F407Opts extends CreateEmulatorOpts {
+  /** A Uint8Array, or a key into the bundled FIRMWARES table. */
+  firmware: Uint8Array | string;
+}
+
+export function createSTM32F407(opts?: CreateSTM32F407Opts): Promise<EmulatorHandle>;
+export function decodeFirmware(key: string): Uint8Array;
+export function createNetSim(opts?: any): any;
+
+export const FIRMWARES: Record<string, { bytes: string; [key: string]: unknown }>;
+export const bindings: any;
+export const unicornFactory: any;
+export const svdXml: string;
+
+// Component-attachment API (attach devices to an emulator handle).
+export class LED {
+  constructor(emu: any, port: string, num: number, opts?: { activeLow?: boolean });
+  on(): void;
+  off(): void;
+  toggle(): void;
+  read(): boolean;
+  onChange(cb: (on: boolean) => void): void;
+}
+export class Button {
+  constructor(emu: any, port: string, num: number, opts?: { activeLow?: boolean });
+  press(): void;
+  release(): void;
+  read(): boolean;
+  on(evt: 'down' | 'up', cb: () => void): void;
+}
+export class Pwm {
+  constructor(emu: any, timer: string, channel?: number, opts?: { clockHz?: number });
+  setDuty(percent: number): void;
+  read(): number;
+}
+export class Potentiometer {
+  constructor(emu: any, peripheral: string, channel?: number, opts?: { min?: number; max?: number });
+  set(value: number): void;
+}
+export class I2cRegisterDevice {
+  constructor(emu: any, peripheral: string, opts?: any);
+}

package/index.mjs

@@ -1,28 +1,31 @@
 // stm32f4-emu — Node API entry.
 // Wraps the browser/Node-universal emulator.js with the bundled assets
-// (SVD, wasm bindings, Unicorn) so Node consumers get a one-call setup.
+// (SVD, wasm bindings) so Node consumers get a one-call setup.
 import { readFileSync } from 'node:fs';
-import { createRequire } from 'node:module';
 import * as bindings from './site/vendor/stm32_periph_wasm.js';
 import { createEmulator } from './site/emulator.js';
 import { createNetSim } from './site/netsim.js';
 import { FIRMWARES } from './site/firmware.js';
 import { LED, Button, Pwm, I2cRegisterDevice, Potentiometer } from './site/components.js';
+import { STM32F4, GPIOPin, USART, DMAStream } from './site/stm32f4.js';
 
-const require = createRequire(import.meta.url);
-const unicornFactory = require('./site/vendor/unicorn_arm.cjs');
+// Node consumers get a one-call setup that injects the bundled assets. The
+// `firmware` option is optional (defer to loadBin/loadHex/loadELF after
+// create), matching the rp2040js / avr8js ergonomics.
+STM32F4.create = (opts = {}) => STM32F4._create({
+    bindings, svdXml, wasmInit: wasmBytes, ...opts,
+});
 
 const svdXml = readFileSync(new URL('./site/vendor/stm32f407.svd', import.meta.url), 'utf8');
 const wasmBytes = new Uint8Array(readFileSync(new URL('./site/vendor/stm32_periph_wasm_bg.wasm', import.meta.url)));
 
 // Decode a base64-encoded firmware from FIRMWARES.
+// Uses single-pass Uint8Array.from for fewer allocations than manual loop.
 export function decodeFirmware(key) {
     const fw = FIRMWARES[key];
     if (!fw) throw new Error(`unknown firmware '${key}' (have: ${Object.keys(FIRMWARES).join(', ')})`);
     const bin = atob(fw.bytes);
-    const out = new Uint8Array(bin.length);
-    for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
-    return out;
+    return Uint8Array.from(bin, c => c.charCodeAt(0));
 }
 
 // Convenience: create an emulator with the bundled STM32F407 assets.
@@ -33,7 +36,7 @@ export async function createSTM32F407(opts = {}) {
     const { firmware } = opts;
     const bin = typeof firmware === 'string' ? decodeFirmware(firmware) : firmware;
     if (!bin) throw new Error('createSTM32F407 requires `firmware` (Uint8Array or a FIRMWARES key)');
-    return createEmulator({ ...opts, firmware: bin, bindings, unicorn: unicornFactory, svdXml, wasmInit: wasmBytes });
+    return createEmulator({ ...opts, firmware: bin, bindings, svdXml, wasmInit: wasmBytes });
 }
 
-export { createEmulator, createNetSim, FIRMWARES, bindings, unicornFactory, svdXml, LED, Button, Pwm, I2cRegisterDevice, Potentiometer };
+export { createEmulator, createNetSim, FIRMWARES, bindings, svdXml, LED, Button, Pwm, I2cRegisterDevice, Potentiometer, STM32F4, GPIOPin, USART, DMAStream };

package/mcp/server.mjs

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 // MCP server exposing the STM32F407 emulator as tools an MCP client
 // (Claude Code / Claude Desktop / any MCP host) can drive: load firmware,
 // step execution, read/write UART, poke and watch GPIO pins, inject ADC
@@ -31,6 +32,25 @@ try {
 }
 
 let session = null;      // { emu, firmware, components: Map }
+
+// ── CLI surface for the bin: stm32f4-mcp --help / --version ──
+// Printed before the stdio MCP transport starts (stdout is the JSON-RPC
+// channel once running, so we must exit before connecting).
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    process.stdout.write(
+        'stm32f4-mcp — MCP server exposing the STM32F407 emulator.\n\n' +
+        'Usage: stm32f4-mcp [--help] [--version]\n\n' +
+        'Speaks MCP over stdio (JSON-RPC). Connect it from an MCP client such\n' +
+        'as Claude Code or Claude Desktop. Optional peer deps:\n' +
+        '  npm install @modelcontextprotocol/sdk zod\n'
+    );
+    process.exit(0);
+}
+if (process.argv.includes('--version') || process.argv.includes('-V')) {
+    const ver = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+    process.stdout.write(`stm32f4-mcp ${ver}\n`);
+    process.exit(0);
+}
 let componentSeq = 0;
 
 const text = (s) => ({ content: [{ type: 'text', text: typeof s === 'string' ? s : JSON.stringify(s, null, 2) }] });

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "stm32f4-emu",
-  "version": "0.1.0",
-  "description": "STM32F407 emulator: Unicorn (WASM) CPU + Rust peripheral model. Runs real Cortex-M4 firmware in Node or the browser.",
+  "version": "1.1.1",
+  "description": "STM32F407 emulator: Rust CPU + peripheral model (WASM). Runs real Cortex-M4 firmware in Node or the browser.",
   "type": "module",
   "main": "index.mjs",
   "bin": {
-    "stm32f4-mcp": "./mcp/server.mjs"
+    "stm32f4-emu": "./cli.mjs",
+    "stm32f4-mcp": "./mcp/server.mjs",
+    "stm32f4-bridge": "./site/ws-bridge.mjs"
   },
+  "types": "index.d.ts",
   "exports": {
     ".": "./index.mjs",
     "./components": "./site/components.js",
@@ -14,22 +17,31 @@
     "./netsim": "./site/netsim.js",
     "./firmwares": "./site/firmware.js",
     "./loaders": "./site/loaders.js",
+    "./stm32f4": "./site/stm32f4.js",
     "./vendor": "./site/vendor/stm32_periph_wasm.js",
-    "./vendor/unicorn": "./site/vendor/unicorn_arm.cjs",
-    "./site": "./site/index.html"
+    "./remote": "./site/remote-emu.js",
+    "./ws-bridge": "./site/ws-bridge.mjs"
   },
   "files": [
     "index.mjs",
+    "index.d.ts",
+    "cli.mjs",
     "README.md",
+    "LICENSE",
     "site/emulator.js",
+    "site/emulator.d.ts",
+    "site/stm32f4.js",
     "site/components.js",
-    "mcp/server.mjs",
     "site/netsim.js",
     "site/firmware.js",
     "site/loaders.js",
-    "site/index.html",
+    "site/remote-emu.js",
+    "site/ws-bridge.mjs",
     "site/app.js",
-    "site/vendor/"
+    "site/index.html",
+    "site/vendor/",
+    "mcp/server.mjs",
+    "tools/make_firmware.mjs"
   ],
   "keywords": [
     "stm32",
@@ -37,7 +49,6 @@
     "emulator",
     "arm",
     "cortex-m4",
-    "unicorn",
     "wasm",
     "embedded",
     "firmware"
@@ -55,29 +66,66 @@
     "node": ">=20"
   },
   "scripts": {
-    "test": "node site/test_flow.mjs && node site/test_blinky.mjs && node site/test_rx_interrupt.mjs && node site/test_component_led.mjs && node site/test_component_button.mjs && node site/test_component_pwm.mjs && node site/test_component_i2cregfile.mjs && node site/test_component_adc.mjs && node site/test_multi_instance.mjs && node site/test_fsmc_dcmi.mjs && node site/test_fsmc.mjs && node site/test_dcmi.mjs",
+    "test": "node site/test_stm32f4_api.mjs && node site/test_stm32f4_periph.mjs && node site/test_ws_bridge.mjs && node site/test_flow.mjs && node site/test_blinky.mjs && node site/test_rx_interrupt.mjs && node site/test_component_led.mjs && node site/test_component_button.mjs && node site/test_component_pwm.mjs && node site/test_component_i2cregfile.mjs && node site/test_component_adc.mjs && node site/test_multi_instance.mjs && node site/test_fsmc_dcmi.mjs && node site/test_fsmc.mjs && node site/test_dcmi.mjs && node site/probe_freertos.mjs   && node site/test_candemo.mjs && node site/test_lowpower.mjs   && node site/test_edge_cases.mjs && node site/test_can_inject.mjs   && node site/test_watchdog.mjs   && node site/test_wwdg.mjs   && node site/test_wwdg_window.mjs && node site/test_tim_capture.mjs && node site/test_qspi.mjs && node site/test_fpu.mjs && node site/test_fpu_irq.mjs && node site/test_mpu.mjs && node site/test_usb.mjs && node site/test_qspi_cdp.mjs && node site/test_browser.mjs",
+    "test:unit": "node site/test_stm32f4_api.mjs && node site/test_stm32f4_periph.mjs && node site/test_ws_bridge.mjs && node site/test_flow.mjs && node site/test_blinky.mjs && node site/test_rx_interrupt.mjs && node site/test_component_led.mjs && node site/test_component_button.mjs && node site/test_component_pwm.mjs && node site/test_component_i2cregfile.mjs && node site/test_component_adc.mjs && node site/test_multi_instance.mjs && node site/test_fsmc_dcmi.mjs && node site/test_fsmc.mjs && node site/test_dcmi.mjs && node site/probe_freertos.mjs   && node site/test_candemo.mjs && node site/test_lowpower.mjs   && node site/test_edge_cases.mjs && node site/test_can_inject.mjs   && node site/test_watchdog.mjs   && node site/test_wwdg.mjs   && node site/test_wwdg_window.mjs && node site/test_tim_capture.mjs && node site/test_qspi.mjs",
+    "test:bridge": "node site/test_ws_bridge.mjs",
+    "test:bridge:browser": "node site/test_bridge_cdp.mjs",
     "test:flow": "node site/test_flow.mjs",
     "test:blinky": "node site/test_blinky.mjs",
     "test:rx": "node site/test_rx_interrupt.mjs",
     "test:multi": "node site/test_multi_instance.mjs",
+    "test:can": "node site/test_candemo.mjs",
+    "test:caninject": "node site/test_can_inject.mjs",
+    "test:watchdog": "node site/test_watchdog.mjs",
+    "test:wwdg": "node site/test_wwdg.mjs",
+    "test:wwdgwin": "node site/test_wwdg_window.mjs",
+    "test:timcap": "node site/test_tim_capture.mjs",
+    "test:lowpower": "node site/test_lowpower.mjs",
+    "test:qspi": "node site/test_qspi.mjs",
+    "test:fpu": "node site/test_fpu.mjs",
+    "test:fpuirq": "node site/test_fpu_irq.mjs",
+    "test:mpu": "node site/test_mpu.mjs",
+    "test:qspi:browser": "node site/test_qspi_cdp.mjs",
+    "test:browser": "node site/test_browser.mjs",
+    "test:edge": "node site/test_edge_cases.mjs",
     "test:fsmc": "node site/test_fsmc.mjs && node site/test_dcmi.mjs && node site/test_fsmc_dcmi.mjs",
     "test:components": "node site/test_component_led.mjs && node site/test_component_button.mjs && node site/test_component_pwm.mjs && node site/test_component_i2cregfile.mjs && node site/test_component_adc.mjs",
     "test:mcp": "node mcp/test_mcp.mjs",
     "mcp": "node mcp/server.mjs",
+    "bridge": "node site/ws-bridge.mjs",
     "firmwares": "node tools/make_firmware.mjs",
     "serve": "python3 -m http.server 8123 --directory site",
-    "prepack": "node tools/make_firmware.mjs"
+    "prepack": "node tools/make_firmware.mjs",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint site mcp tools index.mjs cli.mjs",
+    "format": "prettier --check .",
+    "format:write": "prettier --write .",
+    "build:wasm": "wasm-pack build stm32-periph-wasm --target web --out-dir ../site/vendor && rm -f site/vendor/.gitignore && cp monox/stm32f407.svd site/vendor/ 2>/dev/null || true; command -v wasm-opt >/dev/null 2>&1 && wasm-opt -O3 site/vendor/stm32_periph_wasm_bg.wasm -o site/vendor/stm32_periph_wasm_bg.wasm || echo 'wasm-opt not found, skipping'",
+    "build:wasm:node": "wasm-pack build stm32-periph-wasm --target nodejs --out-dir pkg",
+    "build:wasm:opt": "wasm-opt -O3 site/vendor/stm32_periph_wasm_bg.wasm -o site/vendor/stm32_periph_wasm_bg.wasm",
+    "test:wasm": "node site/test_wasm_cpu.mjs && node site/test_flow_wasm.mjs && node site/test_audio_wasm.mjs && node site/test_wasm_multi.mjs && node site/test_lowpower_wasm.mjs && node site/probe_freertos.mjs && node site/test_doom_wasm.mjs"
+  },
+  "dependencies": {
+    "ws": "^8.21.3"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "zod": "^3.25 || ^4.0"
   },
   "peerDependenciesMeta": {
-    "@modelcontextprotocol/sdk": { "optional": true },
-    "zod": { "optional": true }
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "zod": "^3.25 || ^4.0"
+    "playwright": "^1.62.1",
+    "zod": "^3.25 || ^4.0",
+    "typescript": "^5.6.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0"
   }
 }