niteris/fastled-wasm-compiler

FastLED to WebAssembly 编译器镜像

镜像概述

本镜像为针对FastLED库的专用编译器工具，主要功能是将基于FastLED库开发的LED控制代码（C/C++）编译为WebAssembly（wasm）格式。生成的wasm文件可直接在Web浏览器或其他支持wasm的环境中运行，实现LED控制逻辑的跨平台Web化部署。

核心功能与特性

• FastLED库支持：内置对FastLED标准API的编译支持，兼容常见LED控制逻辑代码
• WebAssembly输出：生成标准wasm二进制文件，可直接被Web浏览器解析执行
• 轻量级工具链：集成最小化编译工具链，减少镜像体积，提升编译效率
• 零依赖配置：无需在宿主环境安装完整编译工具链，通过容器化方式一键完成编译

使用场景与适用范围

• Web平台LED控制程序开发：将本地FastLED项目移植到Web环境
• 在线LED效果编辑器：作为后端编译服务，实时将用户编写的FastLED代码转换为可预览的wasm
• 跨平台LED控制原型验证：在Web端快速验证FastLED代码逻辑，减少硬件依赖
• 教育与演示工具：用于教学场景中，通过网页展示LED控制代码的运行效果

使用方法与配置说明

基本使用流程

1. 拉取镜像（假设镜像名为fastled-wasm-compiler）

   bash
   docker pull fastled-wasm-compiler
   

2. 编译FastLED代码

   bash
   docker run --rm -v /本地代码目录:/src fastled-wasm-compiler \
     -i /src/led_control.cpp \  # 指定输入的FastLED源代码文件
     -o /src/output.wasm       # 指定输出的wasm文件路径
   

参数说明

目录挂载说明

推荐将本地源代码目录挂载至容器内/src路径，便于输入文件读取和输出文件保存：

bash
# 将当前目录作为源代码目录挂载
docker run --rm -v $(pwd):/src fastled-wasm-compiler -i /src/effect.cpp -o /src/effect.wasm

输出文件使用

生成的wasm文件可通过WebAssembly JavaScript API在浏览器中加载执行：

javascript
// 浏览器中加载并运行wasm示例
async function runWasm() {
  const response = await fetch('output.wasm');
  const bytes = await response.arrayBuffer();
  const { instance } = await WebAssembly.instantiate(bytes);
  // 调用wasm中导出的LED控制函数
  instance.exports.controlLED();
}
runWasm();

注意事项

• 输入代码需遵循C/C++标准，且仅使用FastLED库支持的API
• 生成的wasm文件大小取决于代码复杂度，建议对大型项目启用编译优化（-O2或-O3）
• Web环境中使用时，需确保宿主环境支持WebAssembly（现代浏览器均支持）