嵌入式开发 Skill

使用本 Skill 的方式

根据用户问题的类型，优先阅读以下对应的参考文件：

如果问题横跨多个领域，可以同时阅读多个文件。

核心原则（每次回答都要牢记）

1. 资源约束优先：嵌入式系统内存、Flash、CPU 算力都极为有限，任何建议都要考虑资源开销。
2. 确定性与实时性：嵌入式系统需要可预期的时序行为，避免不确定延迟。
3. 硬件软件协同：问题常出在软硬件交界处，调试时不能只看代码。
4. 防御性编程：所有外部输入、硬件状态都可能出错，必须有保护机制。
5. 可测试性：从一开始就设计测试点、调试接口，而非事后补救。

快速响应模板

用户问"XXX 怎么调试"时

1. 先确认硬件层面（电源、时钟、接口电平）是否正常
2. 再看通信协议层面（时序、帧格式、ACK）
3. 最后才看软件逻辑

用户问"XXX 怎么优化"时

先问：优化目标是什么？（功耗 / 速度 / Flash 大小 / RAM 占用），不同目标策略完全不同。

用户问"选什么芯片/方案"时

阅读 references/architecture.md，按需求维度逐一匹配。

常用代码片段（可直接使用）

安全的超时等待模板（裸机）

#define TIMEOUT_MS  1000
uint32_t tick_start = HAL_GetTick();
while (!condition_met()) {
    if ((HAL_GetTick() - tick_start) > TIMEOUT_MS) {
        return ERR_TIMEOUT;
    }
}

ISR 与主循环通信（标志位模式）

// 在 ISR 中：
volatile uint8_t g_uart_rx_flag = 0;
void USART1_IRQHandler(void) {
    g_uart_rx_flag = 1;  // 只设标志，不做处理
}

// 在主循环中：
if (g_uart_rx_flag) {
    g_uart_rx_flag = 0;
    process_rx_data();
}

FreeRTOS 队列通信模板

// 创建
QueueHandle_t xQueue = xQueueCreate(10, sizeof(MyMsg_t));

// 发送（从 ISR）
BaseType_t xHigherPriorityTaskWoken = pdFALSE;
xQueueSendFromISR(xQueue, &msg, &xHigherPriorityTaskWoken);
portYIELD_FROM_ISR(xHigherPriorityTaskWoken);

// 接收（任务中）
MyMsg_t msg;
if (xQueueReceive(xQueue, &msg, pdMS_TO_TICKS(100)) == pdTRUE) {
    // 处理消息
}

阅读完本文件后，根据用户的具体问题，跳转到对应的 references/ 子文件获取更详细的内容。