AI 大模型辅助单片机开发指南

例如，输入以下 Prompt：

我正在使用 STM32F103C8T6（基于 HAL 库，Keil MDK 环境），请帮我写一个通过 I2C 驱动 SSD1306 OLED 显示屏的初始化和字符串显示函数，要求有详细的中文注释。

Step 3：AI 输出代码后，逐段 Copy 到 Keil/CubeIDE 中编译验证

Step 4：若有问题，继续追问

编译报错：undefined reference to 'HAL_I2C_Master_Transmit'，请帮我检查是否少了哪些头文件或配置？

Step 5：请 AI 生成注释和文档

请为上面这段代码生成详细的接口文档，并添加 Doxygen 风格的注释。

核心优势

• 综合能力强，几乎所有 MCU 平台、协议、库均能理解
• 支持多轮对话调整代码细节
• 对复杂逻辑（如 DMA、RTOS 调度、Bootloader 实现）理解深刻

4.2 GitHub Copilot 使用教程

安装方式

1. 打开 VSCode，进入扩展商店（Ctrl+Shift+X）
2. 搜索 GitHub Copilot 并安装
3. 登录你的 GitHub 账号（需订阅 Copilot 服务，学生免费）
4. 同样推荐安装 GitHub Copilot Chat 插件（支持对话式问答）

日常使用方式

① 代码自动补全

在 .c 文件中，只需写下注释描述你的需求，Copilot 会自动补全函数体：

// 初始化 USART1，波特率 115200，8 位数据位，无校验，1 位停止位
void USART1_Init(void) {
    // Copilot 会在这里自动补全 HAL/LL 库初始化代码
}

② Chat 对话模式

按 Ctrl+I 打开 Copilot Chat，直接输入：

帮我写一个基于 STM32 LL 库的 SPI 从机模式初始化函数，并实现一个非阻塞的 DMA 收发接口

③ 代码解释

选中一段代码，右键 → "Copilot" → "Explain This"，AI 自动给出代码解释。

④ 单元测试生成

选中驱动函数，右键 → "Copilot" → "Generate Tests"，自动生成对应测试框架代码。

核心优势

• 深度集成 IDE，编码流畅自然
• 支持多种嵌入式开发框架（Arduino、HAL、LL、CMSIS 等）
• 实时补全，大幅减少手动输入量

4.3 豆包（ByteDance）使用教程

访问方式

• 官网：可自行搜索
• 也可下载豆包 APP（手机端同样可用）

特色功能

• 完全免费，中文理解能力强
• 支持代码模式，Markdown 输出
• 支持联网搜索（可搜芯片资料）

使用步骤

Step 1：打开豆包网页或 APP，进入对话

Step 2：直接输入中文需求

帮我写一个 Arduino ESP32 的 WiFi 连接并发送 HTTP GET 请求的完整代码，要求连接失败时自动重连，并有串口调试输出。

Step 3：豆包输出代码后，直接复制到 Arduino IDE 验证

Step 4：让豆包解释某段代码

请帮我解释上面代码里 WiFiClient 和 HTTPClient 的区别和使用场景

Step 5：生成中文注释

请给刚才那段代码加上详细的中文注释，适合初学者阅读

核心优势

• 国内访问流畅，无需翻墙，完全免费
• 中文表达更自然，特别适合国内开发者
• 对 ESP32、STM32、51 单片机等国内常用平台理解较好

4.4 通义灵码（阿里云）使用教程

安装方式

1. VSCode 扩展商店搜索 TONGYI Lingma
2. 登录阿里云账号即可使用（免费）
3. 支持 VSCode、JetBrains IDE

使用步骤

Step 1：安装插件并登录

Step 2：在编辑器中使用行间注释触发代码补全

// 配置 TIM2 定时器，1ms 周期，开启中断
void TIM2_Init(void) {
    // 灵码会自动补全 STM32 HAL 库配置代码
}

Step 3：选中代码，使用右键菜单

• 解释代码：生成详细解释
• 生成注释：一键添加注释
• 生成单元测试：自动生成测试函数
• 代码优化：优化代码质量和风格

Step 4：使用 Chat 面板提问

基于 STM32CubeMX 生成的工程框架，如何正确添加 FreeRTOS 任务并实现任务间的消息队列通信？

核心优势

• 国内访问，延迟低，完全免费
• IDE 插件集成，开发流程无缝融合
• 对阿里云 IoT、国内芯片生态支持较好

4.5 Kimi 使用教程

访问方式

• 官网：可自行搜索
• 特色：支持上传文件，可直接解析 PDF 数据手册！

使用步骤（重点：上传数据手册）

Step 1：打开 Kimi，点击'上传文件'

Step 2：上传芯片的 PDF 数据手册（如 STM32F4xx Reference Manual）

Step 3：向 Kimi 提问关于该芯片的具体寄存器或外设配置问题

根据上传的参考手册，请帮我用寄存器方式（不使用 HAL 库）配置 USART1，波特率 9600，并实现一个字节的发送和接收函数。

Step 4：Kimi 结合数据手册精确输出对应寄存器操作代码

Step 5：帮助理解复杂协议或外设原理

根据手册第 15 章，帮我解释 STM32 的 DMA 请求映射机制，并给出一个 USART1 DMA 发送的配置示例

核心优势

• 最大亮点：可直接上传芯片数据手册进行精准问答
• 长文本理解能力强，适合分析大型工程代码
• 对遗留代码、复杂项目的整体分析能力突出

五、Prompt 工程技巧——如何问才能得到最好的代码

好的 Prompt = 好的代码。以下是嵌入式开发中的 Prompt 写作技巧：

5.1 明确硬件环境

❌ 差的 Prompt：

帮我写一个串口发送代码

✅ 好的 Prompt：

我使用的是 STM32F103C8T6，开发环境是 Keil MDK 5，基于 HAL 库，请帮我写一个 USART1 的初始化函数和字符串发送函数，波特率 115200，8N1，需要有中文注释。

5.2 给出约束条件

请用 C 语言编写，不使用动态内存分配，代码需兼容 MISRA-C 编码规范，注意不要使用全局变量，采用静态变量替代。

5.3 分步拆解复杂需求

复杂功能不要一次性要求 AI 全部实现，分步进行：

第一步：帮我写 SPI Flash（W25Q64）的初始化和读取 ID 函数（验证 OK 后再继续） 第二步：在上面基础上增加扇区擦除和页写入功能（验证 OK 后再继续） 第三步：封装成统一的文件系统接口，兼容 FatFS

5.4 让 AI 角色扮演

你是一名有 10 年经验的 STM32 嵌入式工程师，请以代码 Review 的视角审查以下代码，指出潜在的 Bug、内存问题和可以优化的地方： [粘贴你的代码]

5.5 要求格式化输出

请按以下格式输出代码：

1. 先给出完整的.h 头文件内容
2. 再给出完整的.c 源文件内容
3. 最后给出调用示例 每个部分用标题分隔

六、完整实战案例

案例一：STM32 + DHT11 温湿度采集并通过 USART 上传

需求描述： STM32F103 读取 DHT11 温湿度数据，每 2 秒通过 USART1 以 JSON 格式发送到上位机。

Prompt：

我使用 STM32F103C8T6，HAL 库，Keil MDK 5 环境。需求：

1. 通过 PA0 引脚驱动 DHT11 温湿度传感器，读取温湿度数据
2. 每 2 秒通过 USART1（PA9/PA10，波特率 115200）发送一次 JSON 格式数据 格式：{"temp":25.5,"humi":60.0}
3. 代码需包含 DHT11 驱动文件（dht11.h 和 dht11.c）和主调用逻辑
4. 加详细中文注释

AI 输出代码结构：

/* dht11.h */
#ifndef __DHT11_H
#define __DHT11_H
#include "stm32f1xx_hal.h"
typedef struct {
    float temperature;  // 温度值（摄氏度）
    float humidity;     // 湿度值（%RH）
} DHT11_Data_t;

HAL_StatusTypeDef DHT11_Read(DHT11_Data_t *data);
#endif

/* dht11.c 核心读取逻辑（AI 生成）*/
HAL_StatusTypeDef DHT11_Read(DHT11_Data_t *data) {
    uint8_t buf[5] = {0};
    // 发送起始信号：拉低至少 18ms
    SET_PIN_OUTPUT();
    HAL_GPIO_WritePin(DHT11_GPIO_PORT, DHT11_PIN, GPIO_PIN_RESET);
    HAL_Delay(20);
    HAL_GPIO_WritePin(DHT11_GPIO_PORT, DHT11_PIN, GPIO_PIN_SET);
    // ...（AI 完整生成时序逻辑）
    
    // 校验和验证
    if (buf[4] != (buf[0]+buf[1]+buf[2]+buf[3]))
        return HAL_ERROR;
    
    data->humidity = buf[0] + buf[1] * 0.1f;
    data->temperature = buf[2] + buf[3] * 0.1f;
    return HAL_OK;
}

/* main.c 主调用（AI 生成）*/
while (1) {
    DHT11_Data_t sensor_data;
    char json_buf[64];
    
    if (DHT11_Read(&sensor_data) == HAL_OK) {
        // 格式化为 JSON 字符串
        snprintf(json_buf, sizeof(json_buf),
                 "{\"temp\":%.1f,\"humi\":%.1f}\r\n",
                 sensor_data.temperature,
                 sensor_data.humidity);
        // USART 发送
        HAL_UART_Transmit(&huart1,
                          (uint8_t*)json_buf,
                          strlen(json_buf),
                          100);
    }
    HAL_Delay(2000);
}

案例二：ESP32 + MQTT 上报数据到云端

Prompt：

ESP32，Arduino 框架，PlatformIO 环境。实现：连接 WiFi 后，通过 MQTT 协议向阿里云 IoT 平台上报一条 JSON 数据，主题为"/sys/xxx/yyy/thing/event/property/post"，数据格式遵循阿里云物模型标准，失败时自动重连。

案例三：让 Kimi 解析数据手册并生成寄存器级代码

操作步骤：

1. 上传 STM32F4 参考手册 PDF
2. 输入 Prompt：

根据手册第 8 章 PWR 电源控制部分，帮我写一个进入 STOP 模式并通过 EXTI Line0（PA0 按键）唤醒的完整代码，使用寄存器操作方式，不使用 HAL 库，加详细注释说明每个寄存器的配置原因。

七、避坑指南与注意事项

⚠️ 注意 1：AI 代码必须验证

AI 生成的代码不能直接用于生产环境，必须在开发板上编译、运行、验证。特别是涉及：

• 中断时序
• DMA 配置
• 低功耗管理
• 多任务调度（RTOS）

⚠️ 注意 2：芯片和库版本要明确

一定在 Prompt 中注明：

• 芯片型号（如 STM32F103C8T6）
• 开发框架版本（如 HAL 1.8.x）
• IDE 版本（如 CubeIDE / Keil MDK 5）

否则 AI 可能使用不匹配的接口导致编译失败。

⚠️ 注意 3：分步验证，避免一次性要大量代码

功能越多，AI 出错概率越高。建议：

1. 先让 AI 写最小化功能，编译通过后再逐步扩展
2. 每次只增加一个新功能，便于定位问题

⚠️ 注意 4：AI 有知识截止日期

最新的芯片、SDK 版本可能超出 AI 训练数据范围。遇到新器件时，建议手动补充关键参数给 AI。

⚠️ 注意 5：代码安全与知识产权

• 不要把公司核心机密代码上传给 AI
• 注意 AI 生成代码的授权情况

八、未来展望

随着 AI 大模型能力的不断迭代，嵌入式开发的 AI 化将越来越深入：

• AI 自动化生成整套固件框架：从需求描述直接输出完整工程结构
• AI+ 硬件仿真联动：自动调试、波形分析、异常定位
• AI+ 芯片数据手册联动：实时查询器件手册，自动适配外设配置
• AI 代码安全审查：自动发现嵌入式常见安全漏洞（如栈溢出、数组越界）
• 端到端 AI 嵌入式开发平台：从原理图到代码到测试，AI 全流程协作

嵌入式工程师的核心竞争力将逐渐从"背 API"转向系统设计能力、AI 工具驾驭能力和跨学科整合能力。

九、总结

善用 AI 工具，是新时代嵌入式工程师的核心竞争力之一。