Repository navigation
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
.wasmmodules 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_stdRust (embedded-hal1.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:
- β Star the repository to help other embedded engineers find it
- π Sponsor on GitHub or Support via Paystack
Full Changelog: v1.1.0...v2.0.0