Skip to content

v2.0.0 β€” Flash Once. Run Anywhere. 2Γ— Faster Than wasm3 on ESP32 πŸš€

Latest

Choose a tag to compare

@Igwe-Starking Igwe-Starking released this 18 Nov 12:32
· 3 commits to main since this release

Flash your firmware once. Change what it does by dropping in a file.
A zero-dependency, C99 WebAssembly runtime built for microcontrollers that never ran an OS.


⚑ Headline Benchmarks: 2.0Γ— Faster Than wasm3

Tested head-to-head on real ESP32 hardware (160 MHz) across 43 compute, memory, and control-flow kernels with bit-identical checksums:

Runtime Slowdown vs. Native Head-to-Head
Eccles WASM v2.0.0 10.4Γ— πŸ† 2.0Γ— faster overall (wins 43/43 kernels)
wasm3 20.5Γ— Baseline

Powered by computed-goto dispatch, fused superinstructions, and an IRAM-resident interpreter loop.


πŸ”₯ What’s New in v2.0.0

  • πŸ”’ Deny-by-Default Hardware Sandboxing: Modules start with zero hardware access. Grant GPIO, I2C, SPI, UART, ADC, PWM, or threads bit-by-bitβ€”and lock modules down to specific pins or bus addresses.
  • 🧩 Multi-Instance Isolation & Spawner: Run multiple independent WASM instances side by side, or spawn parallel worker threads (wasi-threads + atomics) across dual-core MCUs like the ESP32.
  • 🌊 256-Byte Streaming Loader: Stream .wasm modules directly from flash, SD cards, LittleFS, FatFs, or custom storage (eccles_wasm_set_fs) without ever loading the full binary into RAM.
  • ⏱️ Deterministic Fuel & Watchdog Safety: Enforce per-call instruction budgets (eccles_wasm_set_fuel) and automatic yield intervals so buggy or untrusted modules never hang your firmware.
  • 🌍 Six Ready-to-Use Backends: Out-of-the-box support for ESP-IDF, Arduino, Raspberry Pi Pico (RP2040), STM32 HAL, Zephyr / nRF, and a Desktop Simulator, plus guest SDKs for C, C++, and no_std Rust (embedded-hal 1.0).

βœ… Battle-Tested on Real Silicon

  • 4,186 / 4,186 hardware conformance checks passing in 80 seconds on an ESP32 (0 failures across traps, fuzzing, atomics, privilege enforcement, and multi-core threads).
  • Zero mismatches across 17,465 differential fuzz calls against Node.js V8, plus clean runs under ASan, UBSan, and ThreadSanitizer.

πŸš€ Get Started in 30 Seconds

#include "eccles_wasm.h"
#include "blink_wasm.h"

void app_main(void) {
    eccles_wasm_init();
    eccles_wasm_set_hal_privilege(ECCLES_WASM_ALLOW_PIN_ALL | ECCLES_WASM_ALLOW_SAFE);
    if (eccles_wasm_load_buffer(blink_wasm, blink_wasm_len) != ECCLES_WASM_SUCCESSFUL) return;

    eccles_wasm_run("setup");
    for (;;) eccles_wasm_run("loop");
}

πŸ“– Full Documentation: Dive into the new 37-page Wiki (wiki/ or ECCLES_WASM_WIKI.txt) covering memory sizing, custom host functions, and platform bring-up guides.


πŸ’– Support Independent Embedded Tooling

Eccles WASM is built independently with zero corporate backing, MIT-licensed, and free forever. If it saves you a firmware reflash:

Full Changelog: v1.1.0...v2.0.0