
Eccles-WASM:面向微控制器的零堆 C99 WebAssembly 运行时
来源标题:Show HN: Eccles-WASM – Zero-heap C99 WebAssembly runtime for microcontrollers
Eccles-WASM 是一个用纯 C99 编写的微控制器 WebAssembly 运行时,仅两个文件,无需操作系统和堆。在 ESP32(160 MHz)上对 43 个内核的基准测试中,其速度在全部 43 项上均快于 wasm3,整体约快 2 倍,校验和完全一致。作者提醒该结果仅适用于 ESP32,在 x86 PC 上 wasm3 反而快 1.4 倍。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Eccles WASM 是一个面向微控制器的 WebAssembly 运行时,用纯 C99 编写。两个文件,无需操作系统,不需要堆。在你授权之前,模块无法触碰任何硬件。它是 EcclesRTLib 嵌入式运行时库家族的一员,可与固定池分配器 eccles-rtmem 搭配使用。
基准测试 · 证明 · 快速上手 · 你的 MCU · Spawner · set_fs · Wiki · 支持 ♥ · 疑难解答
一台真实的 ESP32(rev 3.1,160 MHz),43 个内核,同一份 C 源码分别以原生代码、Eccles WASM 和 wasm3 运行。每个结果都必须与原生完全一致,才会被计入计时。
在全部 43 个内核上都比 wasm3 快,总体约快 2 倍。各处校验和完全一致。
数字是同一芯片上相对原生机器码的减速倍数(越低越好)。构建参数:-O2,ECCLES_WASM_FUEL 0,ECCLES_WASM_YIELD_INTERVAL 0,解释器循环放在 IRAM 中。
这一点也要看。在 PC(x86)上 wasm3 反而快 1.4 倍,所以不要把这里的数字套到别的芯片上:请在你的芯片上实测。f64 看起来开销很低,是因为 ESP32 没有双精度 FPU,原生代码同样慢。测试方法、全部 43 个内核和原始日志都在基准测试页面上,你也可以从 validation/02-benchmark-vs-wasm3 重新跑一遍。
一次 ESP32 一致性测试跑了 4186 项检查:4186 通过,0 失败,耗时 80 秒,完整的串口日志保存在仓库中。
在 PC 上,发布版源码还通过了与 Node 的 WebAssembly 引擎的差分模糊测试(912 个模块,17,465 次调用,0 处不一致;163 个 atomics 模块,6,077 次调用,0 处不一致),以及 ThreadSanitizer 和带 UBSan 的 AddressSanitizer 对类型混淆模块的检查。
细节、唯一一个已知的 guest 检查怪癖、跳线接法以及如何自行运行:见 validation/ 和 Validation 页面。validation/ 下的固件携带的是当初烧录的运行时快照,其 API 与本发布版相同(参见 validation/README.md 中的说明)。
🔒 默认拒绝
新模块只能做计算,别的什么也做不了。你可以按位授予 GPIO、总线、时间、随机数、日志、线程权限,并把它限制在指定的引脚、总线和 I2C 地址上
🧱 沙箱隔离
每一次内存访问都做边界检查。恶意模块会触发 trap,碰不到你的固件
⏱️ Fuel
每次调用的指令预算可以阻止失控的循环
📦 两个文件
eccles_wasm.h 和 eccles_wasm.c。纯 C99,零依赖
🧠 基于 Arena
一块由你自己设定大小的固定内存块。除非你主动要求,否则不会 malloc
🌊 流式加载器
以 256 字节为单位从文件加载。模块永远不需要整个装进 RAM
🧵 可选线程
支持 wasi-threads 和 atomics,配一个几行就能写完的 spawner
🗂️ 任意文件来源
内置 stdio、FatFs、LittleFS、Zephyr fs、Arduino Stream,或者通过 eccles_wasm_set_fs 接入你自己的实现
🧩 多实例
每个实例都有自己的内存、权限和 host 函数
🔌 Host 函数
一行代码就能把自己的 C 函数交给模块使用
🧰 Guest SDK
C 和 C++ 头文件(ew_*、ew::Pin、ew::I2c、ew::Spi,Arduino 风格命名),以及一个基于 embedded-hal 1.0 的 no_std Rust crate
🌍 六种后端
Arduino、ESP-IDF、Pico、STM32 HAL、Zephyr/nRF、桌面模拟器,以及接入任何其他芯片的方法
🏎️ 快
computed-goto 分发、指令融合、可选把循环放进内部 RAM
📚 文档细到每个函数
37 页的 wiki 和单文件文本版,示例都会实际构建并运行
支持的 WebAssembly:core 1.0、sign-extension、饱和转换、bulk memory、multi-value、引用类型、尾调用、扩展常量、可变全局变量、导入的内存/表/全局变量、最小 WASI,以及(可选的)atomics 和 wasi-threads。不支持:SIMD、异常处理、GC、多内存、64 位内存。
第 1 步。在 PC 上运行。需要 git、make 和 C 编译器。
git clone https://github.com/igwe-starking/eccles-wasm
cd eccles-wasm
make examples
build/example_host examples/blink.wasm
第 2 步。写一个模块。模块就是用 clang 编译成 wasm32 的 C 程序(sudo apt install clang lld)。
// blink.c
#include "eccles_wasm_runtime.h"
EW_EXPORT("setup") void setup(void) { ew_enable(2); }
EW_EXPORT("loop") void loop(void) { ew_toggle(2); ew_sleep(500); }
clang --target=wasm32 -O2 -nostdlib -ffreestanding
-Wl,--no-entry -Wl,--export-all -Wl,-z,stack-size=4096 -Wl,--initial-memory=65536
-Isdk/c -o blink.wasm blink.c
第 3 步。从 C 中运行它。
#include "eccles_wasm.h"
int main(void) {
eccles_wasm_init();
eccles_wasm_set_hal_privilege(ECCLES_WASM_ALLOW_PIN_ALL | ECCLES_WASM_ALLOW_SAFE); // 模块可以触碰什么
if (eccles_wasm_load("blink.wasm") != ECCLES_WASM_SUCCESSFUL) return 1; // 以流式方式载入
eccles_wasm_run("setup");
for (;;) eccles_wasm_run("loop");
gcc -std=c99 -O2 -Isrc app.c src/eccles_wasm.c -o app -lm
第 4 步。放到板子上。把模块嵌入为 C 数组,再从内存中加载:
python3 tools/wasm2c.py blink.wasm blink_wasm.h blink_wasm
eccles_wasm_load_buffer(blink_wasm, blink_wasm_len);
带真实输出的完整讲解:Quick Start。
setup 和 loop(上面这种)是默认方式:host 反复调用 loop,并在两次调用之间保持控制权,因此可以喂看门狗、处理网络或切换模块。如果是专用设备,你也可以改为导出一个在模块内部循环的 main,只调用一次 eccles_wasm_run("main")。这样就去掉了每次迭代的 host 调用,状态也留在局部变量里,但 run 会阻塞,所以要把 fuel 设为 0、在循环内部 sleep,并在 host 需要结束它时使用停止标志。细节见:Concepts 和 Stop or swap a running main。
如果不调用 eccles_wasm_set_hal_privilege(...),模块的每次硬件调用都会返回 DENIED (3),引脚毫无反应。这是「能加载但什么都不发生」最常见的原因。预设:ALLOW_NONE、ALLOW_SAFE(时间、随机数、日志)、ALLOW_READ_ONLY、ALLOW_PIN_ALL、ALLOW_BUSES、ALLOW_ALL。单独的位:ECCLES_WASM_PERM_GPIO_READ、_GPIO_WRITE、_I2C、_SPI、_UART、_ADC、_THREADS 等等。见 Permissions。
选好你的芯片,照着它的页面做,复制示例。每个页面都有安装步骤、一个完整项目、引脚编号、板级说明和一张问题排查表。
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。