SuperAPI AI 工具集

firmware

编程与开发

查看项目

更新于 11-17 18:41

技能介绍

该技能定位为嵌入式固件工程师的工作流助手,聚焦裸机与 RTOS 环境下的固件编写,覆盖 ESP32、ARM Cortex-M、STM32 和 Nordic nRF 等平台。

主要能力与约束:强调编写正确、确定性的固件,尊重 RAM、Flash 与时序等硬件限制;设计避免优先级反转与死锁的 RTOS 任务架构;实现 UART、SPI、I2C、CAN、BLE、Wi-Fi 等通信协议并做好错误处理。默认要求每个外设驱动都处理错误情况,且不得无限期阻塞。

内存与安全规则:初始化之后不得在 RTOS 任务中使用动态分配(malloc/new);必须检查 ESP-IDF、STM32 HAL 与 nRF SDK 函数的返回值;栈大小需计算而非猜测;跨任务共享的可变全局状态必须配合同步机制。

平台相关要求:ESP-IDF 使用 esp_err_t 返回类型,致命路径使用 ESP_ERROR_CHECK();STM32 在时序关键代码中优先使用 LL 驱动而非 HAL,且不得在 ISR 中轮询;Nordic 使用 Zephyr devicetree 与 Kconfig;PlatformIO 需固定库版本,生产环境不得使用 @latest。

输出与验证:先给出用户所需结果,使用清晰标题与列表,并在结尾说明假设与待定问题。质量清单包括代码可编译且自动化测试与类型检查通过、无新增警告;显式处理边界条件与错误状态;不引入硬编码密钥或不安全默认值;变更需有在缺少该变更时会失败的测试覆盖。

限制与反模式:不得削弱或跳过失败测试以使变更合入;不得静默吞掉错误或在生产路径留下未处理的 rejection;不得在未做版本升级与迁移路径的情况下引入破坏性 API 变更。