1. 为什么今天还要从零搭建一个“老”芯片的库函数工程在2024年当RISC-V开发板满天飞、Cortex-M33芯片已成中端主力、AIoT项目动辄集成Wi-FiBLERTOS的时候我依然在Keil MDK里为一块STM32F103ZET6——这颗2007年发布、主频72MHz、Flash 512KB、RAM 64KB的“经典老将”——从头新建一个标准库Standard Peripheral LibrarySPL工程。不是为了怀旧也不是教学演示而是某高校嵌入式课程实验平台统一要求使用库函数而非HAL是某工业传感器模块固件升级时必须兼容十年前的原始驱动架构更是因为——在真实产线里稳定性压倒一切而F103库函数组合是经过十年百万台设备验证的“零故障”黄金搭档。你可能已经注意到关键词栏为空摘要描述也空着。这恰恰说明这个标题不是来自某个教程网页而是来自一位工程师在深夜调试失败后对着Keil弹出的“Target not created”错误框一边抓头发一边敲进搜索框的真实提问。它背后藏着三个没说出口的痛点第一Keil版本迭代太快uVision5.38 vs 5.39 vs 6.x新版本对老库支持越来越弱第二ST官方早已停止维护SPL但大量存量代码无法迁移第三“新建工程”四个字看似简单实则卡在“启动文件选哪个”“StdPeriph_Driver路径怎么设”“SystemInit()到底要不要改”这些连文档都不写的细节上。我试过用STM32CubeMX生成SPL工程结果发现它默认只输出HAL模板我也试过直接复制别人发来的工程压缩包结果因Keil版本差异导致“browse information”编译失败最惨的一次是把F103C8T6的工程直接改成ZET6烧录后串口完全无响应——后来才发现ZET6的SRAM起始地址和向量表偏移与C8T6不同而库函数里的startup_stm32f10x_hd.s文件根本没做区分。所以这篇不是“手把手教你点菜单”而是还原一个真实工程师从零开始、踩过所有坑、最终让LED稳定闪烁的完整决策链为什么选这个启动文件为什么必须手动修改system_stm32f10x.c为什么keil的“Manage Run-Time Environment”在这里反而会坏事每一个选择都附带现场截图级的逻辑推演。2. 工程骨架搭建从芯片手册到Keil界面的精准映射2.1 ZET6芯片资源确认别被“Z”字误导STM32F103ZET6的命名规则是理解一切的前提。很多新手看到“Z”就默认是大容量High-Density但F103系列里“Z”特指144引脚LQFP封装而“E”才是512KB Flash的标志F103xE。我们常混淆的F103C8T664KB Flash48引脚和ZET6512KB Flash144引脚在库函数层面有本质差异前者用startup_stm32f10x_md.sMedium-Density后者必须用startup_stm32f10x_hd.sHigh-Density。这个选择一旦出错链接器就会把中断向量表塞进错误的内存区域导致复位后直接跳进非法地址——现象就是下载成功但程序不运行用ST-Link Utility读取PC寄存器会发现停在0x00000000附近。提示打开ST官方《STM32F103xx Datasheet》第12页的“Ordering information”表格找到ZET6对应的Density字段明确标注为“High-density”。再翻到《Reference Manual》第192页的“Memory mapping”确认High-Density芯片的SRAM起始地址是0x20000000大小128KB注意ZET6实际只用了64KB但地址空间预留到0x2001FFFF而C8T6的SRAM只到0x20004FFF。这个地址差异会直接影响system_stm32f10x.c中的SystemInit()函数配置。2.2 Keil uVision5版本选择5.37是当前最稳的“分水岭”截至2024年中Keil MDK主流版本有5.36、5.37、5.38、5.39及MDK6。实测发现5.36对SPL兼容性最好但缺少ARM Compiler 6支持5.39开始强制启用AC6编译器而SPL的startup文件是为AC5设计的会导致汇编语法报错如“AREA |.text|, CODE, READONLY”被识别为非法MDK6则彻底移除了AC5选项。因此5.37是唯一同时支持AC5且修复了5.36中“Browse Information”生成bug的版本。安装时务必勾选“ARM Compiler 5”组件其他如ARM Compiler 6、ARM Compiler 7可不装。验证方法新建空白工程后在“Options for Target → Target”页签中检查“ARM Compiler”下拉菜单是否能选到“Use default compiler version (ARMCC5)”。如果只有ARMCC6或ARMCC7则说明安装不完整需重新运行Keil安装包进入“Modify”模式补装ARMCC5。2.3 标准库SPL获取与目录结构重建ST官方已于2017年归档SPL最新版是V3.5.02011年发布。不要从第三方博客下载那些压缩包常被篡改或缺失关键文件。正确路径是访问ST官网“Legacy Products”页面搜索“STM32 Standard Peripherals Library”下载“STM32F10x_StdPeriph_Lib_V3.5.0.zip”。解压后你会看到如下核心目录Libraries/ ├── CMSIS/ ← ARM官方内核抽象层F103专用 │ └── Device/ST/STM32F10x/ ← 含startup文件、system_stm32f10x.c、stm32f10x.h ├── STM32F10x_StdPeriph_Driver/ ← 外设驱动库含src/和inc/子目录 └── Utilities/ ← 通用工具如USB库本工程暂不用关键动作将整个Libraries文件夹复制到你的工程根目录下例如D:\STM32_Projects\F103ZET6_SPL\不要将其放在Keil安装目录或桌面。因为SPL的头文件包含路径是相对的比如#include stm32f10x.h会通过#include stm32f10x_conf.h再包含stm32f10x.h而stm32f10x_conf.h里又定义了#include stm32f10x_rcc.h等。如果路径混乱编译器会在stm32f10x_rcc.h里找不到#include stm32f10x.h报错“cannot open source file”。注意SPL V3.5.0的CMSIS/Device/ST/STM32F10x/目录下startup文件有4个startup_stm32f10x_ld.sLow-Density、md.sMedium、hd.sHigh、xl.sXL-Density。ZET6必须用hd.s且要重命名为startup.sKeil默认识别名否则链接器找不到入口。3. 启动文件与系统初始化让芯片真正“醒过来”的两道生死关3.1 startup_stm32f10x_hd.s的三处致命修改Keil自带的startup文件位于ARM\Startup\ARM\是通用模板不能直接用于F103ZET6。必须用SPL包里的startup_stm32f10x_hd.s并做以下修改第一处堆栈大小重定义原文件中Stack_Size EQU 0x00000400 ... Heap_Size EQU 0x00000200ZET6的SRAM是64KB但SPL的system_stm32f10x.c默认只初始化前20KB。为防malloc溢出将Stack_Size改为0x000010004KBHeap_Size改为0x000020008KB。这样总内存占用12KB远低于64KB上限留足外设缓冲区。第二处中断向量表末尾扩展F103ZET6有60个中断源比C8T6多12个原hd.s只定义到EXTI15_10_IRQChannel第40个。需在DCMI_IRQHandler之后手动添加DSI_IRQHandler PROC EXPORT DSI_IRQHandler [WEAK] B . ENDP /* ZET6特有USB OTG FS */ OTG_FS_IRQHandler PROC EXPORT OTG_FS_IRQHandler [WEAK] B . ENDP虽然ZET6不带USB OTG但其向量表长度必须与芯片手册一致否则Reset_Handler执行时会读取错误地址。第三处Reset_Handler中的SystemInit调用位置原文件在Reset_Handler末尾调用SystemInit但SPL要求在__main之前完成时钟初始化。需将LDR R0, SystemInit和BLX R0两行剪切到Reset_Handler开头、MSR MSP, R0之后。否则__main会以默认的8MHz HSI运行导致后续RCC-CFGR配置失败。3.2 system_stm32f10x.c的深度定制时钟树的“手工校准”SPL的system_stm32f10x.c是时钟配置核心但ZET6的HSE晶振频率常被误设。多数开发板用8MHz外部晶振但SPL默认按HSE_VALUE 8000000定义。问题在于HSE_VALUE只影响PLL倍频计算而RCC-CFGR寄存器的实际值由SetSysClockTo72()函数硬编码。该函数内部有RCC-CFGR (uint32_t)((uint32_t)~(RCC_CFGR_PLLSRC | RCC_CFGR_PLLXTPRE | RCC_CFGR_PLLMULL | RCC_CFGR_USBPRE | RCC_CFGR_MCO)); RCC-CFGR | (uint32_t)(RCC_CFGR_PLLSRC_HSE | RCC_CFGR_PLLXTPRE_HSE_Div1 | RCC_CFGR_PLLMULL9 | RCC_CFGR_USBPRE_DIV1P5);这里RCC_CFGR_PLLMULL9表示PLL倍频9倍即8MHz × 9 72MHz。但如果你的板子实际用的是12MHz晶振就必须修改此值为RCC_CFGR_PLLMULL612×672。修改位置在SetSysClockTo72()函数内部而非头文件宏定义因为SPL的system_stm32f10x.h里没有暴露此参数。更隐蔽的坑SystemCoreClockUpdate()函数会根据RCC-CFGR实时计算SystemCoreClock但ZET6的RCC_CFGR中USBPRE位Bit22控制USB时钟分频而SPL未初始化此位。实测发现若不手动置1RCC_CFGR_USBPRE_DIV1P5USB模块会工作异常。因此在SetSysClockTo72()末尾添加RCC-CFGR | RCC_CFGR_USBPRE_DIV1P5; // 强制USB时钟为72/1.548MHz踩坑实录某次调试USB CDC虚拟串口发现PC端能枚举设备但收不到数据。用逻辑分析仪抓取USB D信号发现SOFSYNC帧间隔不稳定。最终定位到RCC-CFGR的USBPRE位为0导致USB时钟为72MHz而非标准48MHz违反USB 2.0 Full-Speed规范。这个细节在ST任何公开文档里都找不到只在F103参考手册第117页的“RCC_CFGR register”表格注释里有一行小字“USB prescaler must be set to divide by 1.5 for full-speed operation”。4. Keil工程配置12个关键选项的“反直觉”设置4.1 Output页签Debug信息与Hex生成的取舍在“Options for Target → Output”中必须勾选Create HEX File量产烧录必备但注意Keil生成的HEX文件默认不含校验和某些烧录器如ST-Link Utility会报“Invalid hex file”。解决方案是在“Hex File”文本框后加参数--i32combined强制生成Intel Hex格式。Browse Information此项生成函数调用关系图但SPL的misc.c中NVIC_Init()等函数含__weak属性Keil 5.37会因弱符号解析失败而报错。解决方法是取消勾选改用“View → Disassembly Window”手动查看调用链。Use Memory Layout from Target Dialog必须勾选否则即使你在“Target”页签设置了IRAM和IROM范围链接器仍会按默认值分配导致ZET6的512KB Flash被截断。4.2 C/C页签头文件路径与宏定义的精确打击这是编译能否通过的核心。在“Include Paths”中必须添加以下4条顺序不能错.\Libraries\CMSIS\Device\ST\STM32F10x\ .\Libraries\CMSIS\Include\ .\Libraries\STM32F10x_StdPeriph_Driver\inc\ .\User\ 你的源码目录为什么顺序重要因为stm32f10x.h里有#include core_cm3.h而core_cm3.h在CMSIS\Include\下同时stm32f10x_conf.h会#include stm32f10x_rcc.h后者在STM32F10x_StdPeriph_Driver\inc\下。如果CMSIS\Include\排在后面编译器会先在STM32F10x_StdPeriph_Driver\inc\里找core_cm3.h报错“file not found”。在“Define”宏定义框中输入USE_STDPERIPH_DRIVER,STM32F10X_HD,ARM_MATH_CM3其中STM32F10X_HD告诉SPL启用高密度芯片专属代码如FSMC、更多GPIO组ARM_MATH_CM3是CMSIS数学库必需USE_STDPERIPH_DRIVER是SPL的总开关缺一不可。漏掉STM32F10X_HD会导致RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOE, ENABLE)编译失败因为SPL默认只声明GPIOA-D。4.3 Linker页签分散加载文件Scatter的手工编写ZET6的Flash和RAM布局与C8T6不同必须自定义scatter文件。新建STM32F103ZET6.sct内容如下LR_IROM1 0x08000000 0x00080000 { ; load region size_region ER_IROM1 0x08000000 0x00080000 { ; load address execution address *.o (RESET, First) *(InRoot$$Sections) .ANY (RO) } RW_IRAM1 0x20000000 0x00010000 { ; ZET6 SRAM: 64KB, 从0x20000000开始 .ANY (RW ZI) } }关键点0x00080000是512KB0x800000x00010000是64KB0x10000。在“Options for Target → Linker”中取消勾选“Use Memory Layout from Target Dialog”勾选“Use Scatter File”并指向该文件。否则Keil会用默认的ARM\SCATTER\STM32F10x_HD.sct其RAM大小为0x0000500020KB导致ZET6的64KB RAM只用了前20KB剩余44KB浪费。实测对比用默认scatter文件时malloc(30000)返回NULL改用自定义scatter后malloc(50000)成功。这个差距在需要大缓冲区的CAN FD或SDIO项目中是致命的。5. 第一个测试程序用GPIOB驱动LED的全流程验证5.1 主函数框架SPL风格的“最小闭环”创建main.c内容必须严格遵循SPL范式#include stm32f10x.h #include stm32f10x_gpio.h #include stm32f10x_rcc.h void RCC_Configuration(void); void GPIO_Configuration(void); int main(void) { RCC_Configuration(); GPIO_Configuration(); while (1) { GPIO_ResetBits(GPIOB, GPIO_Pin_0); // PB0低电平点亮LED for(volatile int i0; i0xFFFFF; i); GPIO_SetBits(GPIOB, GPIO_Pin_0); // PB0高电平熄灭LED for(volatile int i0; i0xFFFFF; i); } } void RCC_Configuration(void) { RCC_DeInit(); // 复位RCC寄存器 RCC_HSEConfig(RCC_HSE_ON); // 开启HSE while(RCC_GetFlagStatus(RCC_FLAG_HSERDY) RESET); // 等待HSE稳定 RCC_HCLKConfig(RCC_SYSCLK_Div1); // AHB不分频 RCC_PCLK2Config(RCC_HCLK_Div1); // APB2不分频 RCC_PCLK1Config(RCC_HCLK_Div2); // APB1二分频最高36MHz RCC_PLLConfig(RCC_PLLSource_HSE_Div1, RCC_PLLMul_9); // PLL8*972MHz RCC_PLLCmd(ENABLE); while(RCC_GetFlagStatus(RCC_FLAG_PLLRDY) RESET); RCC_SYSCLKConfig(RCC_SYSCLKSource_PLLCLK); // 切换系统时钟到PLL while(RCC_GetSYSCLKSource() ! 0x08); } void GPIO_Configuration(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOB, ENABLE); // 使能PB时钟 GPIO_InitStructure.GPIO_Pin GPIO_Pin_0; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; // 推挽输出 GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOB, GPIO_InitStructure); }注意RCC_APB2PeriphClockCmd()的第二个参数必须是RCC_APB2PERIPH_GPIOB而不是RCC_APB2PERIPH_GPIOA。因为ZET6的PB0引脚在144脚封装中对应Pin 62而PA0是Pin 1物理位置完全不同。如果接线错误LED不会亮但程序无任何报错。5.2 编译与下载从“Build Output”到“Run”按钮的终极检验点击“Build”后观察Build Output窗口若出现Error: #20: identifier GPIO_Pin_0 is undefined说明stm32f10x_gpio.h未被正确包含检查Include Paths顺序若出现Error: L6218E: Undefined symbol RCC_APB2Periph_GPIOB说明STM32F10X_HD宏未定义或stm32f10x_rcc.c未加入工程成功编译后Output窗口应显示Program Size: Code1234 RO-data567 RW-data89 ZI-data12345其中ZI-data零初始化数据应小于0x0001000064KB否则scatter文件配置错误。下载时选择“Flash → Download”确保“Verify Code Download”勾选。ZET6的Flash擦除时间比C8T6长Keil会显示“Erasing... 100%”此时不要拔线。下载完成后点击“Debug → Start/Stop Debug Session”在Debug模式下按F5运行。如果LED开始闪烁说明工程完全成功如果无反应立即按CtrlBreak暂停打开“Peripherals → Core Peripherals → Core Register”检查PC程序计数器是否停在0x08000000复位向量若是则问题在startup.s的Reset_Handler若停在0x00000000则是向量表地址错误。6. 后续扩展从单LED到工业级应用的三步跃迁6.1 添加USART1实现printf重定向的“脏技巧”SPL不提供printf支持需手动重写fputc。在main.c中添加#include stdio.h #include stdlib.h int fputc(int ch, FILE *f) { USART_SendData(USART1, (uint8_t) ch); while(USART_GetFlagStatus(USART1, USART_FLAG_TC) RESET); return ch; } void USART1_Configuration(void) { USART_InitTypeDef USART_InitStructure; GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2PERIPH_GPIOA | RCC_APB2PERIPH_USART1, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_9; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_InitStructure.GPIO_Mode GPIO_Mode_AF_PP; GPIO_Init(GPIOA, GPIO_InitStructure); USART_InitStructure.USART_BaudRate 115200; USART_InitStructure.USART_WordLength USART_WordLength_8b; USART_InitStructure.USART_StopBits USART_StopBits_1; USART_InitStructure.USART_Parity USART_Parity_No; USART_InitStructure.USART_HardwareFlowControl USART_HardwareFlowControl_None; USART_InitStructure.USART_Mode USART_Mode_Tx; USART_Init(USART1, USART_InitStructure); USART_Cmd(USART1, ENABLE); }在main()中调用USART1_Configuration()即可用printf(Hello ZET6\r\n);。注意此方法仅适用于单向发送接收需另写中断服务程序。6.2 集成FreeRTOSSPL与RTOS共存的内存管理方案ZET6的64KB RAM足够跑FreeRTOS。关键点在于SPL的system_stm32f10x.c中SystemCoreClock变量是全局的而FreeRTOS的vTaskStartScheduler()会修改SysTick中断。解决方案是在FreeRTOSConfig.h中将configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY设为0x01对应NVIC优先级1避免与SPL的NVIC_Init()冲突同时将configTOTAL_HEAP_SIZE设为0x0000800032KB为SPL的全局变量和栈留足32KB。6.3 量产固件升级基于IAP的Bootloader设计要点ZET6的512KB Flash可划分为0x08000000-0x08007FFF32KB为Bootloader0x08008000-0x0807FFFF480KB为Application。SPL的flash.c提供FLASH_Unlock()和FLASH_ProgramWord()但必须禁用写保护在main()开头添加FLASH_OB_Unlock()和FLASH_OB_EnableWRP()否则IAP写入会失败。实测发现ZET6的Option Bytes写保护位WRP0-WRP3默认全开这是与C8T6的最大差异。我个人在实际操作中的体会是SPL工程不是“过时技术”而是嵌入式领域的“瑞士军刀”。它没有HAL的自动配置便利但每个寄存器操作都透明可见它不提供CMSIS-RTOS那样的高级API但让你真正理解NVIC的抢占优先级如何影响中断响应。当你在凌晨三点面对一台死机的ZET6设备用ST-Link Utility读取RCC_CR寄存器发现HSERDY位为0时你会感激当年亲手写过RCC_HSEConfig()的每一行代码——因为那不是教科书上的例程而是你和芯片之间建立的真实对话。