stm32f4-emu 1.0.0 → 1.2.1

package/README.md

@@ -6,15 +6,29 @@
 [![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)
 
+> **Status: emulation complete.** All 41 peripheral modules are Detailed
+> (0 Partial), all five board maps verify green (37/37/72/73/59 presets),
+> and the Ethernet descriptor layer (EDFE, TCH/TER + RCH/RER walks, RDES4,
+> backoff probe) plus the Wireshark-validated pcap capture (`a1b2c3d4`,
+> tcpdump-verified DHCP→TCP→HTTP) are in. What remains is product work,
+> not emulation: npm publish, https gateway endpoint, VS Code packaging
+> (see [docs/progress-and-future.md](docs/progress-and-future.md)).
+
 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.
 
 It ships three real networking firmwares (`eth_http`, `eth_dhcp`, `eth_test`)
 that do DHCP + TCP + HTTP against a simulated (or a real gVisor-backed)
-network, a browser demo, and a publishable npm package.
+network, a 66-marker Ethernet feature matrix (`eth_feat_test`: PHY/MDIO,
+checksum offload, hash/perfect/SA/DA filtering, VLAN, PTP, WOL, wire
+pacing, deferral/collisions, pause frames, MMC, RBUS — see
+[NETWORKING.md](NETWORKING.md)) plus real LwIP 2.2.1 (`lwip_demo`) and
+MII/RMII pin mirrors (`eth_pins_test`), a browser demo, and a publishable
+npm package.
 
 ## Live demo
 
@@ -23,7 +37,7 @@ The browser demo deploys to GitHub Pages:
 **https://danish9661.github.io/stm32F4-emulator/**
 
 A single console page that starts **idle** — nothing runs until you pick a
-firmware: a preset dropdown with 31 bundled binaries (network demos, a
+firmware: a preset dropdown with 223 bundled binaries (network demos, a
 bare-metal LED blinker, peripheral/crypto/UART/SPI test binaries), custom
 firmware upload (`.bin`, Intel `.hex`, `.elf` — with loadable RAM segments
 and symbols — plus `.map` for a symbol table), Run/Stop/Reset, a **gateway
@@ -32,18 +46,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
-preset can auto-boot via the URL: `?fw=eth_http`, `?fw=blinky`, `?fw=crypto_test`, …
+(`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: `console.html?fw=eth_http`, `console.html?fw=blinky`, `console.html?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
@@ -59,7 +73,7 @@ reloads.
 - Controls: move W/S/A/D + arrows · strafe Shift · fire Ctrl · use
   Space · menu Enter/Esc · save F2/F6 · load F3/F9 · F1/F10/F11/F12.
 - Boot → menu → gameplay verified end-to-end by
-  `node site/test_doom.mjs` (boot markers, menu navigation to E1M1,
+  `node site/test_doom_wasm.mjs` (boot markers, menu navigation to E1M1,
   palette + framebuffer, W-move + turn, audio, **save → `SAVE ok slot=0`
   → load handshake**).
 - `site/doom1.wad` is the 4.2 MB shareware WAD; the firmware never reads
@@ -77,7 +91,7 @@ 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
+# then open http://127.0.0.1:8123/console.html?bridge=ws://127.0.0.1:8234
 
 # gateway-backed run: firmware talks to a REAL network stack (gVisor)
 cd stm32-periph-wasm/pkg
@@ -144,14 +158,14 @@ is a thin UI. Zero impact on the existing local WASM path:
 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"
+open "http://127.0.0.1:8123/console.html?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://…`,
+whatever firmware the bridge was started with; with `console.html?fw=blinky&bridge=ws://…`,
 the browser sends the firmware image over the bridge.
 
 See AGENTS.md §20 for the full binary protocol reference.
@@ -163,8 +177,11 @@ See AGENTS.md §20 for the full binary protocol reference.
 | `eth_http/` | DHCP + TCP client + HTTP GET + prints the response | `TCP connected`, `=== HTTP <len>b ===` |
 | `eth_dhcp/` | Loops DHCP Discover/Offer/Request/Ack | `DHCP SUCCESS` |
 | `eth_test/` | Raw ETH TX/RX self-test | `ETH Test: done` |
+| `eth_feat_test/` | 66-marker Ethernet feature matrix (netsim, F407 + F429) | `FEAT Test: done` (all 66 markers, `FAIL`/`TIMEOUT` anti-markers) |
+| `lwip_demo/` | Real LwIP 2.2.1 (DHCP→DNS→TCP echo→TCP server→UDP echo) | `LWIP DEMO DONE` |
+| `eth_pins_test/` | MII/RMII pin-level mirrors (TX_EN/CRS_DV/RXD/COL/MDIO/MDC) | `PINS ALL PASS` |
 | `blinky/` | **No ethernet** — LED blinker on GPIOA PA5 + UART tick counter | `tick N LED=ON/OFF` |
-| `doom/` | **DOOM 1 shareware** (doomgeneric F407 port, browser page `site/doom.html`) | `node site/test_doom.mjs` (boot + menu + gameplay + save/load) |
+| `doom/` | **DOOM 1 shareware** (doomgeneric F407 port, browser page `site/doom.html`) | `node site/test_doom_wasm.mjs` (boot + menu + gameplay + save/load) |
 
 Plus 17 more test binaries (`crypto_test`, `hal_test`, `timer_test`,
 `periph_test`, `echo_test`, `blink_serial`, `rx_interrupt_test`,
@@ -182,9 +199,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)
@@ -192,14 +209,18 @@ 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
-  injected into the RX ring and the firmware's `eth_irq_flag` (SRAM) drives
-  polling — no interrupts required. Optionally, a Go gateway
+- **Ethernet**: TX is captured from the DMA descriptors (OWN/FS/LS poll
+  demand); RX frames are delivered head-only with FS+LS status, IPHCE/PCE
+  checksum status, and PTP snapshots for event messages. The full MAC
+  register map is cross-checked against CMSIS `stm32f407xx.h` (DMASR/
+  DMAIER/MACFFR/MACPMTCTL positions — see [NETWORKING.md](NETWORKING.md)
+  §6 for the audit). Optionally, a Go gateway
   (`openhw-local-gateway/`) with a gVisor network stack makes the firmware
   talk to a real network: `node cli.mjs <fw.bin> <inst> --gateway`.
 - **Browser build** (`site/`): same modules as ESM; `site/emulator.js` is an
@@ -223,8 +244,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
@@ -257,7 +278,10 @@ rebuild — delete it so the vendor assets stay tracked/committed.
 
 ## Testing
 
-- `npm test` — flow test (`site/test_flow.mjs`) + blinky test
+- `npm test` — flow test (`site/test_flow.mjs`) + Ethernet mock harnesses
+  (`site/test_eth_mock_model.mjs`: 18 checks, fake bindings + real driver;
+  `site/test_eth_mock_consumer.mjs`: 44 checks, fake firmware + real model)
+  + blinky test
   (`site/test_blinky.mjs`) + interrupt-UART test (`site/test_rx_interrupt.mjs`)
   + component-API tests (`site/test_component_{led,button,pwm,i2cregfile}.mjs`,
   each against real firmware — LED/blinky, Button/exti_test, Pwm/buzzer_test,
@@ -267,7 +291,7 @@ rebuild — delete it so the vendor assets stay tracked/committed.
   process (see docs/components.md). The same suite runs in CI on
   `ubuntu-latest`/`windows-latest`/`macos-latest`
   ([.github/workflows/ci.yml](.github/workflows/ci.yml)) on every push.
-- `node site/test_doom.mjs` — DOOM boot → menu → E1M1 gameplay + save/load
+- `node site/test_doom_wasm.mjs` — DOOM boot → menu → E1M1 gameplay + save/load
   (see the DOOM section above).
 - `scripts/verify_ethernet.sh [max_inst]` — runs all three firmwares through
   the gateway, asserts the success markers and 0 `TCP fail`.
@@ -279,7 +303,7 @@ rebuild — delete it so the vendor assets stay tracked/committed.
 - [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
+- [docs/peripherals.md](docs/peripherals.md) — all 41 peripherals and the
   level each is implemented to, plus external devices and known gaps.
 - [docs/usage.md](docs/usage.md) — CLI, browser, and npm-library usage,
   config files, env vars, building.
@@ -296,6 +320,5 @@ rebuild — delete it so the vendor assets stay tracked/committed.
 ## License & Credits
 
 - **License**: GPL-3.0-only. See [LICENSE](LICENSE).
-- **Unicorn CPU Core**: Powered by [Unicorn.js](https://github.com/AlexAltea/unicorn.js) by [Alex Altea](https://github.com/AlexAltea) (WASM/JS port of the [Unicorn Engine](https://www.unicorn-engine.org/) CPU emulator, derived from QEMU, licensed under GPLv2).
 - **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

@@ -10,15 +10,12 @@
 // 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 { createRequire } from 'node:module';
 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 require = createRequire(import.meta.url);
-const unicornFactory = require('./site/vendor/unicorn_arm.cjs');
 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')));
@@ -35,7 +32,7 @@ Arguments:
 Options:
   -n, --inst <N>        instruction budget to run (default 20000000)
   -f, --format <fmt>    firmware format: auto|bin|hex|elf (default auto)
-  -v, --verbose         trace peripheral register reads/writes to stderr
+  -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
@@ -119,8 +116,8 @@ async function main() {
     let emu;
     try {
         emu = await createEmulator({
-            firmware, bindings, unicorn: unicornFactory, svdXml, wasmInit: wasmBytes,
-            extra_mem, verbose, lowpower,
+            firmware, bindings, svdXml, wasmInit: wasmBytes,
+            extra_mem, lowpower,
         });
     } catch (e) {
         fail(`emulator failed to load firmware: ${e.message}`);
@@ -132,7 +129,15 @@ async function main() {
     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();

package/index.d.ts

@@ -0,0 +1,55 @@
+/// <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);
+}
+
+// Board LED map + host reset/boot control (see site/boards.js,
+// site/emulator.js, site/stm32f4.js).
+export interface BoardLed { bank: number; pin: number; label: string; }
+export declare const BOARD_LED: Record<string, BoardLed>;
+export declare const BOARD_LED_ALIASES: Record<string, BoardLed>;
+export declare function boardLed(fwName: string, boardKey: string): BoardLed;

package/index.mjs

@@ -1,8 +1,7 @@
 // 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';
@@ -14,23 +13,19 @@ import { STM32F4, GPIOPin, USART, DMAStream } from './site/stm32f4.js';
 // `firmware` option is optional (defer to loadBin/loadHex/loadELF after
 // create), matching the rp2040js / avr8js ergonomics.
 STM32F4.create = (opts = {}) => STM32F4._create({
-    bindings, unicorn: unicornFactory, svdXml, wasmInit: wasmBytes, ...opts,
+    bindings, svdXml, wasmInit: wasmBytes, ...opts,
 });
 
-const require = createRequire(import.meta.url);
-const unicornFactory = require('./site/vendor/unicorn_arm.cjs');
-
 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.
@@ -41,7 +36,8 @@ 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, STM32F4, GPIOPin, USART, DMAStream };
+export { createEmulator, createNetSim, FIRMWARES, bindings, svdXml, LED, Button, Pwm, I2cRegisterDevice, Potentiometer, STM32F4, GPIOPin, USART, DMAStream };
+export { boardLed, BOARD_LED, BOARD_LED_ALIASES } from './site/boards.js';

package/mcp/server.mjs

@@ -252,4 +252,27 @@ server.registerTool('reset', {
     return text(`closed session (${was})`);
 });
 
+server.registerTool('reset_cpu', {
+    description: 'Host reset button: CPU back to the vector-table SP/PC, peripherals keep state (like a real NRST pulse without the hold). Prefer over load_firmware when re-running the same image.',
+    inputSchema: {},
+}, async () => {
+    const { emu } = requireSession();
+    if (typeof emu.resetCpu === 'function') emu.resetCpu();
+    else emu.reset();
+    return text('cpu reset to vector table');
+});
+
+server.registerTool('set_nrst', {
+    description: 'Hold (assert=true) or release the NRST line. While held, step() only advances the model clock — the CPU executes nothing, like real hardware in reset. Query with level omitted.',
+    inputSchema: { level: z.boolean().optional().describe('true = assert (hold in reset), false = release; omit to query') },
+}, async ({ level }) => {
+    const { emu } = requireSession();
+    if (level === undefined) {
+        const s = typeof emu.isNrstAsserted === 'function' ? emu.isNrstAsserted() : false;
+        return text({ asserted: !!s });
+    }
+    const s = typeof emu.setNrst === 'function' ? emu.setNrst(level) : false;
+    return text({ asserted: !!s });
+});
+
 await server.connect(new StdioServerTransport());

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stm32f4-emu",
-  "version": "1.0.0",
-  "description": "STM32F407 emulator: Unicorn (WASM) CPU + Rust peripheral model. Runs real Cortex-M4 firmware in Node or the browser.",
+  "version": "1.2.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": {
@@ -9,6 +9,7 @@
     "stm32f4-mcp": "./mcp/server.mjs",
     "stm32f4-bridge": "./site/ws-bridge.mjs"
   },
+  "types": "index.d.ts",
   "exports": {
     ".": "./index.mjs",
     "./components": "./site/components.js",
@@ -18,26 +19,31 @@
     "./loaders": "./site/loaders.js",
     "./stm32f4": "./site/stm32f4.js",
     "./vendor": "./site/vendor/stm32_periph_wasm.js",
-    "./vendor/unicorn": "./site/vendor/unicorn_arm.cjs",
     "./remote": "./site/remote-emu.js",
-    "./ws-bridge": "./site/ws-bridge.mjs",
-    "./site": "./site/index.html"
+    "./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/boards.js",
     "site/components.js",
-    "mcp/server.mjs",
     "site/netsim.js",
     "site/firmware.js",
     "site/loaders.js",
-    "site/index.html",
-    "site/app.js",
     "site/remote-emu.js",
     "site/ws-bridge.mjs",
-    "site/vendor/"
+    "site/app.js",
+    "site/index.html",
+    "site/console.html",
+    "site/vendor/",
+    "mcp/server.mjs",
+    "tools/make_firmware.mjs"
   ],
   "keywords": [
     "stm32",
@@ -45,7 +51,6 @@
     "emulator",
     "arm",
     "cortex-m4",
-    "unicorn",
     "wasm",
     "embedded",
     "firmware"
@@ -63,8 +68,8 @@
     "node": ">=20"
   },
   "scripts": {
-    "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_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": "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_eth_mock_model.mjs && node site/test_eth_mock_consumer.mjs && node site/test_periph_mock_consumer.mjs && node site/test_blinky.mjs && node site/test_blinky_f401.mjs && node site/test_blinky_f411.mjs && node site/test_blinky_f407g.mjs && node site/test_blinky_nucleo_f401.mjs && node site/test_blinky_nucleo_f411.mjs && node site/test_blinky_f429.mjs && node site/test_blinky_f407ve.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_arduino_boards.mjs && node site/test_exti.mjs && node site/test_flash.mjs && node site/test_spi_flash.mjs && node site/test_board_matrix.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_blinky_f401.mjs && node site/test_blinky_f411.mjs && node site/test_blinky_f407g.mjs && node site/test_blinky_nucleo_f401.mjs && node site/test_blinky_nucleo_f411.mjs && node site/test_blinky_f429.mjs && node site/test_blinky_f407ve.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",
@@ -78,7 +83,12 @@
     "test:wwdgwin": "node site/test_wwdg_window.mjs",
     "test:timcap": "node site/test_tim_capture.mjs",
     "test:lowpower": "node site/test_lowpower.mjs",
+    "test:standby": "node site/test_standby.mjs",
     "test:qspi": "node site/test_qspi.mjs",
+    "test:eth:mock": "node site/test_eth_mock_model.mjs && node site/test_eth_mock_consumer.mjs && node site/test_periph_mock_consumer.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",
@@ -89,7 +99,15 @@
     "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"
@@ -109,6 +127,9 @@
   "devDependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
     "playwright": "^1.62.1",
-    "zod": "^3.25 || ^4.0"
+    "zod": "^3.25 || ^4.0",
+    "typescript": "^5.6.0",
+    "eslint": "^9.0.0",
+    "prettier": "^3.0.0"
   }
 }