为微控制器开发固件、实现RTOS应用或优化功耗时…

适用于STM32/ESP32/FreeRTOS/裸机等嵌入式固件开发，涵盖外设配置、中断处理、RTOS任务、功耗与内存优化及验证

适用场景

解决思路

1. 分析约束条件：明确MCU规格、内存限制、时序要求和功耗预算
2. 设计架构：规划任务结构、中断、外设和内存布局
3. 实现驱动：编写HAL、外设驱动以及RTOS集成代码
4. 验证实现：用 `-Wall -Werror` 编译并确保无警告；运行静态分析（如 `cppcheck`）；对照数据手册确认寄存器位域使用正确
5. 优化资源：最小化代码体积、RAM占用和功耗
6. 测试与验证：用逻辑分析仪或示波器校验时序；用 `uxTaskGetStackHighWaterMark()` 检查栈使用；测量ISR延迟；确认最坏负载下无错失截止时间；若发现问题则返回第4步重新验证
7. 按上下文加载参考文档：RTOS任务/队列/同步时查阅 `references/rtos-patterns.md`；裸机、寄存器、外设、中断时查阅 `references/microcontroller-programming.md`；睡眠模式、低功耗设计、电池寿命时查阅 `references/power-optimization.md`；I2C、SPI、UART、CAN实现时查阅 `references/communication-protocols.md`；代码体积、RAM使用、flash管理时查阅 `references/memory-optimization.md`
8. 必须做：优化代码体积与RAM使用；对硬件寄存器和ISR共享变量使用 `volatile`；实现正确的中断处理（ISR要短，把工作推迟到任务里）；添加看门狗定时器提升可靠性；使用正确的同步原语；记录资源使用情况（flash、RAM、功耗）；处理所有错误情况；考虑时序约束与抖动
9. 禁止做：在ISR中使用阻塞操作；不做边界检查就动态分配内存；跳过临界区保护；忽略硬件勘误和限制；在无硬件浮点支持意识的情况下使用浮点运算；不同步就访问共享资源；硬编码硬件相关值；忽略功耗要求
10. 采用最小ISR模式（ARM Cortex-M / STM32 HAL）：用 `volatile` 标志在ISR与任务间共享数据；ISR中只读取硬件、置标志并退出（如收到USART2 RXNE时读取DR清标志并置 `g_uart_rx_flag`）；在主循环或RTOS任务中处理标志，读取时用 `__disable_irq()` / `__enable_irq()` 包裹临界区
11. 按FreeRTOS任务创建骨架实现：用 `xTaskCreate` 创建任务并定义栈大小（如 `SENSOR_TASK_STACK 256` words）与优先级；用 `xQueueCreate` 创建队列并检查非空；在任务中用 `vTaskDelayUntil` 配合 `pdMS_TO_TICKS` 实现周期性、截止时间驱动的读取；非阻塞发送 `xQueueSend`；在调试构建中用 `configASSERT(uxTaskGetStackHighWaterMark(NULL) > 32)` 检查栈余量
12. 采用裸机GPIO+定时器中断闪烁模板（STM32）：在 `TIM2_IRQHandler` 中检查 `TIM_SR_UIF`，清标志并翻转 `GPIOA->ODR` 的 `GPIO_ODR_OD5`；初始化时使能GPIOA与TIM2时钟（`RCC->AHB1ENR`、`RCC->APB1ENR`），配置 `MODER` 为输出，设置 `PSC`/`ARR` 得到目标频率（如 8399/9999 得约1 Hz），开启 `DIER` 的 `UIE`、`CR1` 的 `CEN`，并用 `NVIC_SetPriority` 与 `NVIC_EnableIRQ` 使能中断
13. 输出时按模板提供：1) 硬件初始化代码（时钟、外设、GPIO）；2) 驱动实现（HAL层、中断处理程序）；3) 应用代码（RTOS任务或主循环）；4) 资源使用总结（flash、RAM、功耗估算）；5) 对时序与优化决策的简要说明

适用边界 · 注意事项

• 不适用于非嵌入式/非资源受限的通用应用开发
• 不适用于没有具体MCU/RTOS平台或无法获得数据手册与硬件调试工具的场景