STM8S003F3P6这颗芯片在低成本工控板、小家电控制板、LED驱动板里出现的频率非常高。它便宜、够用、封装小但第一次上手的人几乎都会在同一个地方卡住IAR里工程建好了编译也过了ST-LINK插上去却连不上芯片或者连上了烧录报错。这不是芯片的问题也不是你手气差而是STM8这套工具链的配置逻辑和STM32完全不是一回事。下面我按自己实际跑通的顺序把从IAR环境准备到ST-LINK烧录成功的整条链路拆开讲重点放在那些文档里不写、但实际一定会遇到的坑上。1. 先把工具链的版本关系理清楚1.1 为什么STM8不能用你装STM32的那套IAR很多人电脑里已经装了IAR for ARM用来开发STM32于是想当然地认为同一个IAR就能搞定STM8。这个想法会直接导致后面所有步骤都走不通。IAR的产品线是按内核拆分的ARM内核用的是IAR Embedded Workbench for ARM而STM8用的是IAR Embedded Workbench for STM8这是两个独立的安装包安装目录、编译器、器件支持文件全部独立。你在ARM版本里新建工程器件列表里根本找不到STM8S003F3P6这个型号。所以第一步不是急着建工程而是确认你装的是正确的那个版本。安装包的名字通常带有EWSTM8字样版本号方面STM8S系列支持得比较成熟的是3.x版本。安装过程中会提示你选择器件系列STM8S、STM8L、STM8A要勾上不然后面新建工程时器件库是空的。注意IAR for STM8和IAR for ARM可以装在同一台电脑上互不冲突但不要试图把STM8的器件文件拷到ARM版本里用编译器后端不一样拷过去也编译不了。1.2 ST-LINK的驱动和固件是两个概念ST-LINK这个东西硬件本身是ST官方出的调试器但它在电脑上要正常工作需要两层东西一层是USB驱动让电脑认出这个设备另一层是ST-LINK内部的固件决定它支持哪些协议和目标芯片。很多人驱动装好了设备管理器里也能看到ST-LINK但烧录STM8就是失败问题往往出在固件版本上。STM8用的是SWIM单线接口STM32用的是SWD接口两者协议不同。老版本的ST-LINK固件对SWIM的支持可能不完整尤其是那些山寨的ST-LINK V2出厂固件五花八门。判断方法很简单用ST官方的ST-LINK Utility或者STM32CubeProgrammer连一下看能不能识别到ST-LINK本身再看它报告的固件版本。如果固件太老需要用ST-LINK Firmware Upgrade工具升级一下。升级工具是ST官方提供的独立小程序插上ST-LINK后点升级就行过程很快。这里有个细节升级固件的时候不要同时接目标板只插ST-LINK到电脑USB口即可升级完再接目标板。我有一次边接板子边升级升级到一半报错ST-LINK直接变砖后来用另一台电脑重新升级才救回来。1.3 硬件接线SWIM接口只有四根线但顺序不能错STM8S003F3P6的烧录接口是SWIM加上电源和地一共四根线VDD、GND、SWIM、NRST。TSSOP20封装的引脚定义里SWIM在第16脚NRST在第7脚VDD和GND按正常供电接。ST-LINK那一头对应的引脚是ST-LINK引脚目标板引脚说明Pin 1VDD目标板供电检测不是给板子供电Pin 7SWIM单线调试数据Pin 9GND共地Pin 15NRST复位这里最容易踩的坑是Pin 1。ST-LINK的Pin 1是电压检测脚它用来感知目标板的供电电压从而决定SWIM信号的电平。如果你目标板是独立供电的Pin 1必须接到目标板的VDD上否则ST-LINK不知道目标板电压是多少连接就会失败。很多人只接了SWIM、GND、NRST三根线然后纳闷为什么连不上就是漏了这根电压检测线。还有一种情况目标板由ST-LINK供电。STM8S003F3P6的工作电压范围是2.95V到5.5VST-LINK的Pin 1输出的是3.3V理论上可以给小板子供电但电流能力有限如果板子上有LED或者别的负载电压会被拉低导致SWIM通信不稳定。我的建议是目标板独立供电Pin 1只做电压检测这样最稳。2. IAR工程配置里那几个决定成败的选项2.1 新建工程的正确路径和器件选择打开IAR for STM8点Project菜单下的Create New Project会弹出一个模板选择框。这里不要选Empty project选C下面的main模板它会自动帮你生成一个带main函数的框架省得你从零写启动代码。工程建好后右键工程名选Options进入配置界面。第一个要改的是General Options里的Target标签页。Device选STM8S003F3P6这个型号在列表里是有的选完之后下面的内存映射会自动填好。这里要注意STM8S003F3P6的Flash是8KBRAM是1KBEEPROM是128字节。如果你选的型号不对比如选成了STM8S103Flash大小不一样链接的时候会报地址越界。第二个要改的是Linker标签页。Output标签下勾上Override default把输出文件名改成你想要的比如main.out。下面Format选Other输出格式选intel-extended这样生成的是.hex文件方便后面烧录。如果你想要.bin文件Format选binary。我一般两个都生成hex用于ST-LINK Utility烧录bin用于批量生产时用脱机烧录器。2.2 编译器优化等级和调试信息C/C Compiler标签页里Optimizations的Level默认是Low对于STM8S003这种资源紧张的芯片建议改成Medium或者High。但要注意优化等级开高之后有些变量会被优化掉如果你在调试时想看某个变量的值可能会发现它一直是0或者显示不了。解决办法是在变量定义前加volatile关键字告诉编译器这个变量可能被外部改变不要优化它。Debugger标签页里Driver选ST-LINK。下面有个Run to main选项勾上之后每次下载完程序会自动停在main函数入口方便你单步调试。如果你只是烧录不调试可以不勾下载完直接运行。还有一个容易被忽略的地方Debugger下面的Download标签页里面有个Verify download选项建议勾上。它会在烧录完成后校验Flash内容确保烧进去的数据和文件一致。虽然多花一两秒但能避免因为通信干扰导致的烧录不完整。2.3 中断向量表和启动文件STM8的中断向量表是固定在Flash起始地址的不需要像ARM那样重映射。但IAR的启动文件里有一个地方要注意如果你用了中断需要在启动文件里把对应的中断服务函数名填进去。STM8S003F3P6的中断向量表在stm8s_it.c文件里IAR的模板工程一般会带这个文件里面有一堆中断函数的空实现。你用到哪个中断就把对应的函数体填上没用的保持空就行。这里有个坑如果你在代码里定义了中断服务函数但名字和启动文件里的不一致编译不会报错但中断触发时不会跳转到你的函数而是跳到默认的死循环里。表现就是程序跑着跑着就卡死了。排查方法是看反汇编确认中断向量表里的地址指向的是你的函数。3. ST-LINK烧录STM8的完整操作链路3.1 用IAR直接下载的配置要点工程配置好之后点Download and Debug按钮IAR会调用ST-LINK驱动通过SWIM接口把程序烧进去。这个过程如果失败IAR会在下方Build窗口输出错误信息。常见的错误和原因我整理了一下错误提示可能原因解决办法Failed to connect to targetSWIM线没接好、目标板没供电、Pin1没接检查四根线确认目标板电压No device detectedST-LINK驱动异常、固件太老重装驱动、升级固件Flash download failed芯片写保护、Flash被锁用ST-LINK Utility解除保护Verification failed通信干扰、供电不稳降低SWIM速率、检查供电其中Flash download failed这个最麻烦往往是芯片被写了读保护。STM8S003F3P6有一个选项字节区域里面可以设置读保护。如果之前烧过程序并且开了读保护再次烧录时就会失败。解决办法是用ST-LINK Utility连接芯片在Target菜单里选Option Bytes把读保护关掉然后重新烧录。3.2 ST-LINK Utility的独立烧录流程IAR直接下载适合调试阶段但如果是批量烧录或者只烧hex文件用ST-LINK Utility更顺手。打开ST-LINK Utility点Target菜单下的Connect如果连接成功下方状态栏会显示芯片型号和Flash大小。然后点File菜单下的Open File选你的hex文件再点Target下的Program勾上Verify after programming点Start就开始烧录。ST-LINK Utility里有一个很实用的功能Target菜单下的Option Bytes。点进去可以看到Read Out Protection的设置如果显示为Enabled说明芯片被保护了改成Disabled点Apply芯片会自动擦除并解除保护。这个过程会清空Flash所以解除保护后要重新烧录程序。还有一个细节ST-LINK Utility连接STM8时SWIM速率是可以调的。在Target菜单下的Settings里SWIM Frequency默认可能是高速如果连接不稳定可以降到低速试试。我有一次用一根比较长的杜邦线连接高速死活连不上降到低速就稳了。线越长信号质量越差降速是最简单的解决办法。3.3 脱机烧录和批量生产的考虑如果你要做小批量生产每次都用电脑加ST-LINK Utility太慢。这时候可以考虑脱机烧录器把hex文件存到烧录器里按一下按钮就烧一片。脱机烧录器的原理和ST-LINK一样也是通过SWIM接口但它不需要电脑内置了存储和按键。选择脱机烧录器时要注意它支持的芯片列表里有没有STM8S003F3P6以及它用的烧录算法是不是和ST官方一致。有些便宜的烧录器只支持STM32买之前要确认清楚。另外脱机烧录器也需要定期更新固件来支持新芯片这个和ST-LINK固件升级是一个道理。4. 那些让人抓狂的典型故障和排查思路4.1 连接时好时坏先查供电和地线SWIM通信对电源质量很敏感。如果你发现ST-LINK有时候能连上有时候连不上首先用万用表量一下目标板的VDD电压看是不是稳定在3.3V或5V。如果电压跳动说明供电有问题可能是LDO带载能力不够或者板子上有短路。其次检查GND是不是真的共地了有些板子的GND和ST-LINK的GND之间如果有电阻或者二极管会导致电平不一致。还有一个隐蔽的问题STM8S003F3P6的NRST引脚内部有上拉但如果你外部接了一个电容到地电容太大会导致复位信号上升沿变缓ST-LINK在连接时拉低NRST再释放如果上升太慢芯片可能还没复位完成ST-LINK就开始通信了结果就是连接失败。解决办法是把NRST上的电容减小到100nF以内或者干脆不接电容靠内部上拉。4.2 烧录成功但程序不跑检查复位向量和时钟有时候ST-LINK Utility显示烧录成功校验也通过了但板子上的程序就是不运行。这种情况先检查复位向量。STM8的复位向量在Flash的0x8000地址里面存的是复位后第一条指令的地址。如果你用的启动文件不对或者链接脚本里把复位向量放错了位置芯片复位后会跳到一个空区域程序自然不跑。另一个常见原因是时钟配置。STM8S003F3P6内部有一个16MHz的RC振荡器复位后默认用这个时钟的8分频也就是2MHz运行。如果你在代码里把时钟切到外部晶振但板子上没焊晶振或者晶振不起振程序就会卡在时钟切换的等待循环里。排查方法是先用内部RC跑一个最简单的点灯程序确认能跑之后再改时钟配置。4.3 IAR编译报错section placement failed这个错误通常出现在你定义了比较大的数组或者使用了堆内存的时候。STM8S003F3P6的RAM只有1KB如果你定义了一个512字节的数组再加上栈空间和其他变量很容易超出。IAR的链接器会告诉你哪个段放不下。解决办法是减小数组大小或者把不常改的大数组放到EEPROM里如果有128字节够用的话或者优化数据结构。还有一个情况是堆和栈的分配。IAR默认的链接脚本里栈大小可能是128字节堆大小可能是0。如果你用了malloc堆大小为0就会报错。在Linker的Config标签页里可以修改栈和堆的大小但要注意RAM总量只有1KB栈和堆加起来不能超过可用RAM。5. 让开发效率翻倍的几个实操习惯5.1 把常用配置做成工程模板每次新建工程都从头配置一遍Options很浪费时间。我的做法是配置好一个标准工程包括器件型号、输出格式、调试器设置、优化等级然后把这个工程文件夹复制一份改个名字就是新工程。注意复制之后要把输出文件清理掉不然会带着旧的目标文件。IAR的Project菜单下有Clean选项可以清理编译产物。更进一步可以把启动文件、中断文件、常用的外设驱动GPIO、UART、TIM都放到模板工程里新建工程时直接改main函数就行。STM8S003F3P6的资源有限常用的外设配置就那么几套做成模板能省很多时间。5.2 用宏定义管理不同板子的引脚如果你同时开发几块不同的板子用的都是STM8S003F3P6但引脚定义不一样可以用宏定义来管理。在工程Options的C/C Compiler里Preprocessor标签下可以定义全局宏比如BOARD_A、BOARD_B。然后在代码里用#ifdef来判断#ifdef BOARD_A #define LED_PIN GPIO_PIN_5 #define LED_PORT GPIOD #elif defined(BOARD_B) #define LED_PIN GPIO_PIN_3 #define LED_PORT GPIOC #endif这样同一套代码可以编译出不同板子的固件不用改代码。切换板子时只需要改一下全局宏定义重新编译就行。5.3 保留一份最小系统测试程序我电脑里一直存着一个STM8S003F3P6的最小系统测试程序功能很简单上电后LED闪烁串口每隔一秒发一个字符。每次拿到新板子或者怀疑芯片有问题时先烧这个程序。如果LED闪了、串口有输出说明芯片和最小系统没问题问题在应用代码里。如果这个程序都不跑那就是硬件或者烧录环节的问题。这个习惯帮我省了很多排查时间强烈建议你也备一份。5.4 注意IAR的版本兼容性IAR的工程文件在不同版本之间不是完全兼容的。如果你用高版本IAR建的工程拿到低版本IAR上打开可能会提示工程格式不支持。反过来低版本建的工程在高版本上打开一般会提示升级升级后通常能用但偶尔会有配置丢失。团队协作时最好统一IAR版本避免互相打不开工程。另外IAR的许可证管理也要注意。如果是公司购买的许可证换电脑或者重装系统后需要重新激活。离线激活的步骤在IAR的许可证管理工具里有说明按步骤操作就行。不要用网上来路不明的注册工具轻则激活失败重则系统出问题得不偿失。6. 关于SWIM协议和STM8调试的补充认知6.1 SWIM为什么只用一根线就能调试SWIM的全称是Single Wire Interface Module顾名思义就是单线接口。它把时钟和数据合在一根线上通过不同的电平持续时间来区分0和1。STM8的SWIM引脚在正常运行时可以作为普通IO使用只有在调试时才切换到SWIM模式。切换的触发条件是NRST引脚上的特定时序ST-LINK会先拉低NRST然后在SWIM线上发特定的唤醒序列芯片检测到这个序列后就进入调试模式。理解这一点很重要因为它解释了为什么NRST线不能省。有些人觉得SWIM只有一根数据线NRST不接也能调试实际上NRST是进入调试模式的必要条件。NRST不接ST-LINK无法让芯片进入调试状态自然连不上。6.2 调试时变量观察的局限性STM8S003F3P6的调试资源很有限它不支持像ARM Cortex-M那样复杂的断点和观察点。IAR里能设置的硬件断点数量有限通常只有两个。如果你在多个地方设了断点可能有些断点不生效。解决办法是尽量用单步执行或者用串口打印来代替断点观察变量。另外STM8的调试接口在芯片运行时占用SWIM引脚如果你在代码里把SWIM引脚配置成了普通IO并且驱动了它调试器可能会失去连接。所以调试阶段不要动SWIM引脚的配置等调试完成后再改。6.3 低功耗模式下的调试注意事项STM8S003F3P6支持Wait和Halt两种低功耗模式。在Halt模式下芯片的主时钟停止调试接口也会停止工作ST-LINK会断开连接。如果你在调试低功耗程序进入Halt后想再连接需要先复位芯片。IAR的调试器里有一个Connect during reset选项勾上之后可以在芯片复位期间连接这样即使程序进入了Halt也能通过复位重新连上。Wait模式下时钟还在跑调试接口通常还能工作但功耗比Halt高。实际产品里用哪种模式要根据功耗要求来定。调试阶段建议先用Wait模式确认功能正常后再切到Halt模式测功耗。7. 从开发到生产的过渡细节7.1 生成最终烧录文件的注意事项开发阶段生成的hex文件通常包含调试信息文件比较大。量产时不需要这些调试信息可以在IAR的Linker设置里把Generate debug information的选项去掉重新编译生成的hex文件会小很多。另外量产时建议把优化等级开到High减小代码体积但要注意重新测试功能因为高优化可能会暴露一些代码里的隐藏问题。还有一个细节hex文件里包含了Flash的地址信息烧录时会按地址写入。如果你用脱机烧录器要确认烧录器支持Intel HEX格式有些便宜的烧录器只支持bin格式。bin格式没有地址信息烧录时需要指定起始地址STM8S003F3P6的Flash起始地址是0x8000。7.2 芯片焊接和封装选择的实际考虑STM8S003F3P6常见的是TSSOP20封装引脚间距0.65mm手工焊接有点难度但用拖焊法也能搞定。焊接时注意温度不要太高350度左右时间不要超过3秒否则容易损坏芯片。如果板子空间允许也可以选LQFP32封装的STM8S003K3引脚间距更大好焊一些但价格稍贵。焊接完成后先别急着上电用万用表量一下VDD和GND之间有没有短路。如果有短路先排查焊接问题不要盲目上电否则可能烧芯片。确认没有短路后再上电量一下VDD电压是否正常然后再接ST-LINK烧录。7.3 批量烧录时的效率优化小批量生产时如果每片都手动点ST-LINK Utility的Program按钮效率很低。ST-LINK Utility支持命令行模式可以写一个批处理脚本自动连接、烧录、校验、断开。命令行的参数在ST-LINK Utility的帮助文档里有说明基本格式是ST-LINK_CLI.exe -c SWIM -p yourfile.hex -v -run其中-c SWIM指定用SWIM协议-p指定烧录文件-v表示校验-run表示烧录后运行。把这个命令做成批处理文件插上ST-LINK后双击运行就行比手动操作快很多。如果有多台ST-LINK可以并行烧录但要注意USB带宽和电脑性能一般同时烧两三台没问题。8. 一些容易被忽略的细节和我的个人经验STM8S003F3P6的复位引脚NRST是双向的既可以输入复位信号也可以输出复位状态。如果你在代码里把NRST配置成了输出调试器就控制不了复位了。所以除非有特殊需求NRST保持默认的复位功能就行不要改成普通IO。IAR的编辑器里有一个很实用的功能右键点击函数名选Go to definition可以跳到函数定义选Go to declaration可以跳到声明。在阅读别人的代码或者自己写的代码比较多的时候这个功能能省很多翻找的时间。另外CtrlShiftF可以全局搜索找变量或者函数在哪里用过很方便。还有一点关于ST-LINK的市面上的ST-LINK V2有很多版本有些是ST原厂的有些是第三方仿制的。原厂的ST-LINK V2在固件升级和兼容性上更可靠第三方的便宜但偶尔会有奇怪的问题。如果预算允许建议用原厂的省心。如果已经买了第三方的遇到连接问题先升级固件试试大部分问题能解决。最后说一个我踩过的坑有一次用STM8S003F3P6做一个小项目程序烧进去后功能都正常但偶尔会死机。排查了很久最后发现是电源的问题。板子上用的LDO输出3.3V但输入电容只有1uF负载突变时电压跌落导致芯片复位。把输入电容加大到10uF问题就消失了。STM8S003虽然便宜但对电源质量还是有要求的尤其是板子上有电机或者继电器的时候电源滤波一定要做好。这个教训让我养成了一个习惯每次画新板子电源部分的电容都留足余量宁可多焊几个也不要省这几个电容。
