SuperAPI AI 工具集

arduino-project-builder

编程与开发

查看项目

更新于 10-15 18:10

技能介绍

Arduino Project Builder 是一个面向 Arduino 与嵌入式开发的工程组装技能,目标是从需求出发交付完整、可工作的工程,而非零散代码片段。

用途 它用于把多个常见模式(传感器、执行器、状态机、日志、通信)组合成内聚的系统。当用户请求一个完整的应用型工程时,可使用该技能进行搭建。它覆盖 Arduino IDE、Arduino CLI、PlatformIO 以及厂商专用工具链。

主要能力

  • 工程脚手架:脚本 scripts/scaffold_project.py 提供命令行方式,可列出支持的工程类型、按类型和开发板生成工程,也支持交互模式。 示例命令: uv run --no-project scripts/scaffold_project.py --list uv run --no-project scripts/scaffold_project.py --type environmental --board esp32 --name "WeatherStation" uv run --no-project scripts/scaffold_project.py --type robot --board uno --output ./my-robot uv run --no-project scripts/scaffold_project.py --interactive
  • 支持的工程类型:环境监测(多传感器数据记录,如温度、湿度、光照、空气质量)、机器人控制(电机控制、传感器融合、避障、状态机)、IoT 设备(WiFi/MQTT 数据传输、云集成、远程监控)、家庭自动化(继电器控制、定时任务、传感器触发动作)、数据采集系统(高频采样、SD 卡记录、实时可视化)。
  • 配套资源:examples/ 提供完整工程示例(环境监测、机器人控制、IoT 设备);assets/workflow.mmd 提供工程组装工作流的 Mermaid 图;workflow/ 为分步组装流程;rules/ 为质量标准与开发板特定优化;templates/ 为工程输出模板与文档标准。

使用方式 组装工程前,需阅读共享契约并填写开发板档案,记录确切的开发板、框架、工具链、版本、引脚、内存、电源、协议以及恢复路径。工程组装流程通常包括:需求收集(分析用户请求并汇总工程规格)、架构设计(设计组件连接、数据流与状态机)、代码组装(组合模式并针对用户硬件定制)、测试与验证(校验编译、内存占用与功能)、文档(编写接线图、使用说明与故障排查指南)。输出遵循统一的工程输出模板。

适用场景 适合需要快速搭建完整嵌入式原型或工程的场景,包括环境监测记录、机器人控制、IoT 联网设备、家庭自动化以及数据采集系统。脚手架脚本会输出其支持的开发板目标与 PlatformIO 结构;对于其他开发板或厂商框架,应复用需求与架构流程,再提供对应工具链的实现。

限制与注意

  • 需区分构建、上传、硬件、系统与部署的证明;生成的脚手架不等于硬件验证。
  • 共享输出契约要求说明假设、所需工具与版本、实现步骤、按证明阶段划分的测试/证据、已知限制以及恢复/安全说明。
  • 脚本仅声明其支持范围,不应改动脚本来声称支持其他开发板或框架。
  • 关于收费、价格、具体性能指标与效果,资料中暂未提供。
  • 关于支持的开发板完整清单,资料中仅提及 UNO、ESP32、RP2040 的特定优化与约束,未给出完整列表。