这几年我带过不少刚转嵌入式软件的新同事发现一个挺有意思的现象大家用AI编程工具写Python、写Web服务都很溜但一碰到STM32这种单片机就卡住了——AI生成的代码放在哪个文件、怎么编译、怎么烧进板子脑子里完全没有概念。这个系列聊到第08篇正好把这件事说透在AI编程已经非常普及的今天第一个STM32工程到底应该怎么建AI在里面又能帮你干什么、不能帮你干什么。先说结论AI可以让你的STM32学习曲线陡降30%但它替代不了你对硬件最基本的认知。今天这篇我按自己带项目的习惯把从选板子、搭环境、用CubeMX生成工程、到让AI帮你写点灯代码、再到踩坑排查的完整过程走一遍。准备照着做的人建议手边放一块STM32F103C8T6的板子跟着操作效果比自己干看强十倍。1. 用AI重学STM32新的学习路径与工具栈1.1 为什么第一块板子选STM32F103C8T6网上关于第一块STM32选什么的争论从来没停过。有人推荐新出的G0系列有人推荐H7系列追求极致性能我个人的答案是老老实实选F103C8T6也就是大家常说的蓝丸板。原因不复杂就三条。第一这芯片的外设足够全。Cortex-M3内核主频72MHz片上Flash 64KBC8T6SRAM 20KBGPIO、USART、SPI、I2C、TIM、ADC、CAN、USB全都有。也就是说你入门的点灯、串口、定时器、中断、ADC采样、甚至USB小项目它都能覆盖不需要中途换平台。第二资料密度高到溢出。F103从2010年前后开始流行十几年积累下来的教程、例程、论坛帖子是所有ARM MCU里最多的。这是一个很实际的优势当你遇到一个奇怪问题大概率别人也遇到过你搜得到答案。对AI编程来说这一点更关键AI的训练语料中F103的代码量极大生成的代码准确率会明显高于G0、H7这些较新的芯片。第三便宜。一块蓝丸板十几二十块钱折腾坏了不心疼。开发板这种东西一旦你怕弄坏就不敢动手实验这对学嵌入式的打击是致命的。我自己现在还留着一块F103的板子用来验证一些基础驱动思路便宜、皮实、启动快当测试车非常合适。对于真正做产品的人F103可能不是最优选新设计我更倾向用G0或者L4系列。但作为学习平台、作为AI编程的题库F103C8T6目前依然是综合最优解。1.2 AI编程工具在嵌入式开发中的真实定位这几年AI编程工具比如Claude、Codex这类发展很快很多人问我嵌入式软件开发是不是要变天了我的看法是变了但没有完全变。AI现在能非常出色地完成三类事情。第一类是生成样板代码。比如你要初始化一个I2C读传感器、要写一个串口解析状态机给它一个明确的需求描述它几秒钟给你一份逻辑完整的代码这活以前至少半小时。第二类是代码翻译和改写。把标准库的代码改成HAL库、把寄存器操作封装成函数AI做这种机械性工作非常稳定几乎没有语法错误。第三类是排查报错。Keil或者GCC的编译报错信息又臭又长你要是看不懂英文直接复制粘贴给AI它通常能直接指出问题在哪一行、改哪里。但AI在嵌入式开发里也有明显的盲区。它不知道你的板子上LED实际接在哪个引脚、是高电平点亮还是低电平点亮它不知道你的硬件设计里I2C有没有加上拉电阻它也不会替你分析中断优先级设置会不会导致实时性出问题。更实际的一个例子我让AI帮我写过一段F103的bootloader代码它默认Flash大小是128KB但C8T6只有64KB这种记忆偏差导致分区表直接超出范围如果不检查就是一块砖。所以我对AI编程的定位从来都是贴身助理而不是全自动程序员。它能帮你把从0到80分的代码写出来剩下那20分——硬件兼容、极端条件处理、性能验证——必须由你来把关。这也引出了这篇文章的一个核心思路让AI帮你建第一个STM32工程但工程里每一步自己最好都清楚是什么意思。2. 环境搭建CubeMX Keil ST-Link三板斧2.1 硬件清单与选型细节建工程之前先把家什准备齐别等代码写完了发现烧录器没到货。我的建议清单如下开发板STM32F103C8T6蓝丸板注意买的时候确认板载LED是不是接在PC13以及LED是低电平点亮还是高电平点亮。调试烧录器ST-Link V2买那种十几块钱的兼容版就够用。不推荐用串口ISP下载速度慢且没法在线调试。杜邦线至少4根用来连接ST-Link和板子。USB转串口模块可选如果你后面想学串口通信CH340模块是标配还能用来救砖。电源蓝丸板可以直接从USB口用5V供电板载AMS1117稳压到3.3V。接线这块有个细节必须注意ST-Link V2的SWD接口只有四根线有用——SWDIO接PA13、SWCLK接PA14、GND接GND、3.3V接3.3V。很多人栽在没共地上ST-Link和板子不共地SWD通信就各种莫名其妙失败。我第一次用ST-Link下载失败排查了半天最后发现是杜邦线松了地线没接牢。所以接线后先轻轻拽一下确认每根线都吃住了。2.2 开发软件安装与芯片包部署软件环境我推荐组合是Keil MDK STM32CubeMX ST-Link驱动。CubeMX负责图形化配置和生成工程骨架Keil负责编译调试ST-Link驱动负责让Keil能跟板子通信。这个组合是目前最主流的也是AI训练语料里最常见的一种搭配。Keil MDK安装没什么难点注意两点版本别太老建议5.35以上新版本对ARM Compiler 6的支持更好编译速度也快安装路径尽量别带中文否则一些老插件会出问题。装完Keil之后新手遇到最多的问题就是为什么我新建工程时找不到STM32F103C8——原因很简单芯片支持包没装。Keil本体只是个编辑器加编译器外壳具体芯片的启动文件、Flash算法要靠Device Family PackDFP提供。打开Keil的Pack Installer找到STM32F1xx系列装最新的DFP即可。如果在线下载慢去ST官网下离线安装包手动装速度更快。装完之后新建工程时就能在STMicroelectronics目录下找到STM32F103C8了。ST-Link驱动同样需要单独安装。装好后在设备管理器里能看到ST-Link Debug相关的设备如果显示黄色感叹号说明驱动没装好右键更新驱动重新指向安装目录就行。这个驱动问题不解决后面点击下载按钮只会弹一个Target DLL has been cancelled的错误。CubeMX现在基本是ST主导的配置工具免费官网注册个账号就能下。安装没什么需要特别设置的记住生成代码的时候选MDK-ARM工具链就行。2.3 用CubeMX生成第一个工程骨架第一次用CubeMX的人容易晕因为界面信息量很大。其实只要按我的顺序一步步走十分钟内就能生成一个能点灯的工程。第一步打开CubeMX新建工程New Project在芯片搜索框输入STM32F103C8找到对应的封装LQFP48并双击。这时候CubeMX会默认给你勾选一些外设无所谓后面会重新配。第二步配置RCCReset and Clock Control在System Core下面找到RCC把HSEHigh Speed External Clock从Disable改成Crystal/Ceramic Resonator。这一步是告诉芯片我有一个外部晶振要把它用起来。如果这里不配置系统时钟只能走内部RC振荡器HSI也能跑但精度差后面串口通信波特率容易偏。第三步配置SYS在System Core - SYS里把Debug改成Serial Wire。这一步极其重要。STM32的PA13和PA14引脚默认是SWD调试口如果你把Debug配置保留为No DebugCubeMX生成的代码不会初始化SWD引脚实际上下载器还是能连上因为这是芯片复位后的默认状态但一旦你代码跑起来把这两个引脚复用成GPIO烧录器就再也连不上了程序直接锁死。所以一开始就选Serial Wire能从根源上避开这个坑。第四步配置GPIO。在芯片视图上找到PC13点击选择GPIO_Output。为什么是PC13因为蓝丸板板载LED接的就是PC13而且它低电平点亮LED另一端接3.3V。如果你想让它默认灭着在GPIO配置里把Level设为High。第五步配置时钟。切到Clock Configuration标签页那棵时钟树很多新手一看就懵。别怕CubeMX是自动计算的。你只需要做一件事在输入HSE的地方填8因为蓝丸板晶振是8MHz在HCLK那里填72然后回车CubeMX会自动帮你算好PLL的分频倍频值。如果哪里飘红说明配置冲突把HCLK值调低一点再试。F103的最高工作频率就是72MHz别超了。第六步Project Manager标签页填上工程名称比如First_LED选择工程存放路径在Toolchain/IDE下拉框里选MDK-ARM其他默认即可。然后点击右上角GENERATE CODE等CubeMX生成完选择Open ProjectKeil会自动打开这个工程。到这里你已经拥有一个可以编译、烧录的STM32工程骨架了。虽然它还不会干任何事但CubeMX已经把时钟初始化、GPIO初始化、HAL库底层这些脏活累活全部做好了。这就是我推荐用CubeMX的原因它把工程怎么搭这个没有技术含量但要命的环节自动化了让你和AI都能把精力放在真正的业务逻辑上。3. 让AI帮你写代码从GPIO点灯到精准延时3.1 第一份AI生成的LED代码长什么样工程骨架有了现在的核心问题是怎么让AI在这个工程里帮你写代码很多人直接把帮我写一个LED闪烁程序丢给AI结果拿回来的代码根本放不进工程。问题出在没给AI足够的上下文。我这里给你一个可以直接抄的提示词模板你是嵌入式C语言专家。我使用STM32F103C8T6Keil MDK 5.40STM32CubeMX生成的HAL库工程芯片支持包是STM32Cube FW_F1 V1.8.5。板载LED接PC13低电平点亮。请在CubeMX生成的main.c基础上在USER CODE BEGIN 4和USER CODE END 4之间添加一个LED翻转函数并在while(1)循环里实现LED以1Hz频率闪烁。要求使用HAL_GPIO_TogglePin接口延时使用HAL_Delay。关键代码加中文注释。把这个提示词发给AI它返回的while循环部分大概率长这样while (1) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); HAL_Delay(500); }这段代码的意思很直白翻转PC13的电平等500ms再翻转一次再等500ms合起来就是一个完整的1秒周期LED看起来就是1Hz闪烁。这个代码短小精悍但你别小看它。把AI给的代码放回main.c时注意位置不要在USER CODE BEGIN/END区域之外乱改否则下次用CubeMX重新生成代码时你加的东西会被覆盖掉。这是CubeMX工程一个非常核心的规矩——CubeMX只保留标记区域内的用户代码标记区外的东西它认为都是它生成的全部清掉重来。很多新手辛辛苦苦写了几十行代码重新生成工程后灰飞烟灭就是没搞懂这个规则。放好代码之后编译。如果一切顺利Keil下方应该没有任何error。然后点击Download按钮或者按F8把程序烧进板子。看到LED按1Hz的频率亮灭第一个STM32工程基本就算成了。3.2 代码审查AI写的不一定是对的点灯成功之后我要泼一盆冷水AI这一次给的代码没问题不代表它每次都靠谱。我实测过同一个问题在多个AI工具上的表现发现几个高频翻车点你迟早会遇到。第一个翻车点库版本搞混。你让AI写STM32代码它默认给你返回标准库Standard Peripheral Library的代码比如GPIO_SetBits(GPIOC, GPIO_Pin_13);。这套API在新版HAL库工程里根本不存在编译必然报错。遇到这种情况别急直接回一句请把这段代码改成STM32F1 HAL库的写法AI一般能正确改写。第二个翻车点引脚极性想当然。如果你在提示词里只写LED接PC13没说低电平点亮AI多半会默认高电平点亮代码变成HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET)来点亮、RESET来熄灭。结果就是你烧进去之后LED常亮不闪或者干脆常灭。这不是AI不聪明是它没读你的原理图。所以提示词里写明低电平点亮这几个字能省一半的调试时间。第三个翻车点逻辑对但API细节写错。我见过AI生成的代码把HAL_GPIO_TogglePin写成HAL_GPIO_Toggle这种错误编译阶段就会暴露Keil的报错信息虽然看着吓人但如果你把这行报错内容原样粘贴给AI它自己就知道改。这里有个实用的协作模式编译报错 - 复制报错 - 发给AI - 让它给出修正后的完整代码块。这个循环的效率非常高我日常开发有一半的调试时间就是这么耗掉的。还有一点提醒AI生成的代码就算能编译能运行也不代表风格和你的工程一致。比如命名习惯、注释风格、函数封装粒度这些在团队协作里很重要。你可以让AI把初始化代码封装成一个函数加详细的注释它都能干。相当于你有了一个任劳任怨又听话的结对编程伙伴。3.3 用AI把延时从粗略变成精确点灯成功之后下一个绕不开的需求是精确延时。HAL_Delay靠SysTick系统节拍定时器实现默认1ms中断一次做秒级延时没问题。但如果你要做微秒级延时、要生成PWM波、要并行处理多个任务HAL_Delay就不够用了——因为它是阻塞式的在延时期间CPU啥也干不了。处理这类需求的正规思路是用硬件定时器比如TIM2。这也是AI帮得上忙的场景。你在CubeMX里只需要两步TIM2勾选Activated内部时钟在参数配置里把Prescaler设为7199、Counter Period设为9999使能TIM2全局中断其他配置全部保持默认。为什么是这两个数因为APB1总线时钟是36MHz定时器时钟经过倍频后是72MHz。72MHz除以7200等于10kHz10kHz再除以10000就是1Hz——也就是每1秒产生一次更新中断。Prescaler7199表示72MHz先除以7200Counter Period9999表示从0数到9999正好数10000次。这两个参数连起来一算就是一个精确的1秒时基。生成工程之后在main.c里有两处要改。初始化部分调用HAL_TIM_Base_Start_IT(htim2);这行代码让TIM2启动并打开中断。然后在USER CODE BEGIN 4区域写一个定时器回调函数void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim) { if (htim-Instance TIM2) { HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13); } }这个回调函数是HAL库的中断处理机制里预留的钩子TIM2每次计数溢出也就是每1秒都会进入这里。注意我加了if (htim-Instance TIM2)这个判断这是个好习惯。因为工程里有多个定时器时它们的中断都会走这个回调函数你不判断是谁触发的就会几个定时器互相干扰出现我明明改了TIM3的配置LED却在乱闪这种灵异现象。你可以把上面整个配置过程复制给AI让它用大白话给你解释一遍PSC和ARR的计算让它指出如果改成100ms、10ms该填什么数。实测下来AI对这种给公式、代数值的活儿非常擅长用来加深理解比自己啃手册快得多。到这一步你的第一个STM32工程已经完成了从点点亮到定时驱动的进化这在后面做呼吸灯、数码管扫描、按键消抖时全都能用上。4. 常见问题与AI排查技巧实录4.1 芯片包没装好Keil就是找不到芯片新手问得最多的一个问题明明照着教程装了Keil为什么新建工程的时候芯片列表里什么都没有或者搜STM32F103C8搜不到九成情况是STM32F1系列的Device Family Pack没装或者没装成功。打开Pack Installer左侧展开STMicroelectronics - STM32F1 Series你看到的应该是F1的各个子系列芯片包列表找到DFPDevice Family Pack并安装。如果安装了还搜不到检查是不是Keil版本太老老版本对新的芯片包格式支持不好建议直接升到5.35以上。还有一个隐蔽的坑同一个芯片可能对应多个补丁版本如果装了某个Beta版DFP可能出现器件列表异常。这种情况的解决方案很粗暴——把Pack Installer里所有STM32F1系列的包全部卸载再重装最新的正式版。遇到这类环境问题千万别自己闷头折腾。你可以把现象告诉AIKeil MDK 5.40装了STM32F1的DFP但新建工程时芯片列表里没有STM32F103C8如何排查AI通常会提供比搜索引擎更结构化的排查步骤因为这种问题在它的训练语料里出现频率极高回答准确率非常高。4.2 烧录失败、灯不亮、delay卡死的排查顺序工程建好了、代码写好了但下载或者运行的时候死活不对怎么弄我建议你按下面这个顺序排查每一条都是我自己踩过的坑。烧录失败主要看三件事。第一ST-Link和板子是不是共地了第二设备管理器里ST-Link驱动有没有黄色感叹号第三Keil的Debug设置里Utilities - Settings能否识别到芯片内核。如果能在设置里看到CPU的ID说明连接没问题烧录失败多半是Flash算法没选对重新选一下STM32F10x High-density Flash算法即可。注意F103C8是Medium-densityFlash算法别选成High-density容量不匹配也会出问题。编译通过但灯不亮先别急着怀疑代码。第一检查板子供电摸一下板上3.3V芯片烫不烫用万用表量一下3.3V对地电压第二确认LED引脚到底是不是PC13部分蓝丸板丝印存在差异最好的方法是看原理图第三确认极性用杜邦线把PC13直接接一下3.3V灯灭接一下GND灯亮那你的板上LED就是低电平点亮第四回CubeMX里看PC13的GPIO配置有没有输出类型、初始电平配错。HAL_Delay卡死是一个经典问题。现象是程序跑起来了但一到HAL_Delay就卡住不动。原因通常是SysTick的时钟源或者中断优先级配置出了问题。SysTick是Cortex-M内核里的一个简单定时器HAL库依赖它产生1ms的时基HAL_Delay就是靠查这个时基的计数值来实现阻塞延时的。如果你在CubeMX里改过SysTick相关的配置或者手动屏蔽了SysTick中断HAL_Delay就永远不会返回。解决方法是回到CubeMX的默认配置让SysTick使用HCLK72MHz作为时钟源并保持中断使能。另外一个相关的坑是如果你在中断回调里调用HAL_Delay因为中断里SysTick中断优先级不够高可能直接死锁。低优先级中断里调用HAL_Delay是需要格外小心的。我这里整理了一个速查表建议收藏现象可能原因排查动作Keil找不到芯片DFP未安装安装STM32F1系列Device Family Pack下载时报RDDI-DAP ErrorST-Link驱动异常/SWD引脚被复用重装驱动检查SWD模式配置程序烧进去但灯不亮引脚、极性、供电问题看原理图用万用表测电平HAL_Delay卡死不返回SysTick时基异常恢复CubeMX默认时钟配置烧过一轮后再也连不上下载器PA13/PA14被配置成GPIOBOOT0拉高串口ISP擦除Flash多个定时器乱触发回调未判断Instance在回调中增加实例判断4.3 给AI的提示词模板与调试话术最后分享一套我每天在用的AI提示词模板这比任何代码都值钱。第一个模板是开需求每次提问前把固定的背景信息先贴一遍相当于给AI立了一个上下文档案。我的版本是这样工程背景STM32F103C8T6Keil MDK 5.40STM32CubeMX生成的HAL库工程芯片包STM32Cube FW_F1 V1.8.5。板载LED在PC13低电平点亮晶振8MHz时钟已配置为72MHz。 需求请帮我实现... 要求使用HAL库代码放在USER CODE区域关键处加中文注释给出完整可编译的代码块。为什么要固定这些信息因为AI不知道你用的是标准库还是HAL库不知道你的晶振是8MHz还是12MHz不知道你的LED是高电平点亮还是低电平点亮。你不说清楚它就只能靠猜猜错的概率并不低。你把这些背景信息做成了模板每次提问都贴一遍AI的回答准确率会有质的飞跃。第二个模板是聊报错报错信息不能只贴半行最好从第一条error开始复制到末尾然后给AI一句话定位以上编译报错来自main.c第XX行附近请分析原因并给出修改后的完整代码。实际用下来AI对GCC和ARMCC的报错信息识别能力很强多数情况能直接命中问题。第三个模板是当审查员写了一段还算重要的驱动程序之后我会让AI扮演代码审查员要求它不改变功能指出潜在问题。它通常会给出一些有价值的提醒比如缺少超时保护、中断没有做抖动处理、GPIO速度配置不合理。这些虽然是通用经验但对初级工程师来说相当于免费请了一个资深工程师给你做Review。不过要记住AI只是看代码它看不到你的实际硬件最终的判断权还是在你手里。写在后面从选型、搭环境、生成工程、到让AI辅助写完第一个LED闪烁整套流程走下来你会发现STM32入门最难的那道坎其实不是代码而是环境和工程概念。AI编程确实把从零开始点灯这件事的门槛拉低了很多但前提是你自己得把CubeMX、Keil、ST-Link这一套工具链理清楚否则AI生成的代码再漂亮也只是停留在聊天窗口里的漂亮。我个人的习惯是任何AI生成的代码必须经过至少一次完整的编译和运行验证才允许进仓库。这个习惯在第一个STM32工程阶段就要养成后面写复杂外设驱动、做RTOS移植的时候能帮你省下大量无效排查时间。另外把上面那个工程背景模板存成一段固定文本每次开局先贴一遍实测下来AI回答质量至少提升一个档次。第一个工程跑通之后后面要玩的花样就多了定时器中断、串口收发、ADC采电压、PWM驱动小电机每一个都能让AI帮你完成大半代码但每一个也都要求你清楚硬件上的真实行为。下一篇我打算聊聊用AI辅助做串口协议解析和状态机设计到时候会直接把AI生成的代码和踩坑过程都放出来咱们继续一起折腾。