1. 从“拿来主义”到“自力更生”为什么需要创建自己的STM32 IAR工程很多朋友在刚开始玩STM32的时候都是从官方或者开发板厂商提供的例程开始的。就像我最初接触万利Manley的STM32板子时也是直接打开一个现成的流水灯或者串口例程然后修修改改把GPIO口从PA0改成PC4就算完成了自己的第一个程序。这种做法上手快能快速建立信心看到LED闪烁的那一刻成就感满满。但是久而久之问题就来了。当你需要做一个稍微复杂点的项目比如同时用到定时器、ADC、DMA和串口时你会发现从不同例程里东拼西凑代码就像用不同规格的乐高积木搭房子接口对不上编译报错满天飞底层初始化冲突程序跑起来各种灵异现象。更头疼的是你根本不知道那些例程里的工程选项Options为什么那么设置链接脚本Linker Script里那些神秘的数字代表什么一旦换一块不同Flash或RAM大小的芯片或者想优化代码尺寸和速度就完全无从下手。所以从“改例程”到“建工程”是嵌入式开发从入门到进阶的必经之路。自己创建一个干净的、完全受控的工程意味着你真正理解了从源代码到二进制文件再到芯片上运行的全过程。今天我就以在IAR Embedded Workbench for ARM环境下为万利STM32F103开发板创建一个基础工程为例手把手带你走一遍这个流程。我们会从打开一个空白工程开始一步步配置编译器、链接器、调试器最后写一个最“裸”的、不依赖任何库的流水灯程序并生成HEX文件。这个过程会涉及很多底层细节我会尽量把每个设置背后的“为什么”讲清楚。当你跟着走完这一趟以后再面对任何ARM Cortex-M芯片的工程创建你都会心中有底。2. 工程骨架搭建创建空白工程与核心选项初探2.1 启动IAR与创建新工程首先确保你已经安装了IAR Embedded Workbench for ARM以下简称IAR EWARM。不同版本界面略有差异但核心逻辑相通。我使用的是比较经典的一个版本新版本可能菜单位置有变化但功能关键词是一样的。启动IAR后你可能会看到一个“Embedded Workbench Startup”的对话框。这是一个快速入口直接点击“Create new project in current workspace”按钮是最快的。如果你觉得这个对话框碍事在“Tools - Options...”里可以设置启动时不显示它。如果没看到这个对话框也别慌我们走标准菜单路径点击顶部菜单栏的“Project”在下拉菜单中选择“Create New Project...”。这时会弹出一个“Create New Project”的窗口。这里有两个关键选择Tool chain 必须选择“ARM”。这告诉IAR我们接下来要编译的是针对ARM架构处理器的代码。Project templates 模板选择。这里提供了像“Empty project”空工程、“asm”汇编工程、“C”等选项。强烈建议选择“Empty project”。从零开始虽然第一步是空的但避免了模板自带的一些你可能暂时不理解的配置或文件让我们对工程的每一部分都拥有完全的控制权。点击“OK”。接下来会弹出一个保存对话框。给你的工程起个名字比如“STM32F103_Blinky”。选择一个合适的目录来存放它比如“D:\MyProjects\”。这里有一个非常重要的习惯为每一个工程建立一个独立的文件夹。这样所有工程相关的源文件、头文件、链接脚本、输出文件都会规整地放在一起便于管理和备份。点击“保存”后一个最基础的、空空如也的工程框架就在Workspace工作空间窗口里创建好了。2.2 工程选项Options配置详解现在我们的工程只是个空壳需要告诉IAR我们的目标芯片是谁、如何编译、如何链接、如何调试。这一切都在“Options for node STM32F103_Blinky”对话框中完成。在Workspace窗口中右键点击你的工程名STM32F103_Blinky选择“Options...”配置之旅正式开始。2.2.1 General Options - Target指明目标芯片这是最基础也是最重要的一步它决定了编译器生成指令的基础。Device 点击“Device”旁边的按钮会弹出芯片选择器。在厂商列表中找到“ST”展开后选择“STM32F10x”系列。这里选择系列即可IAR会自动根据后续的链接脚本配置来适配具体型号如STM32F103C8T6。如果你的芯片是STM32F1系列的其他子类这里也通常选STM32F10x。Endian mode 选择“Little”。ARM Cortex-M内核默认采用小端模式Little Endian即数据的低字节存放在低地址。这是绝大多数ARM嵌入式环境的标配除非有特殊需求否则不要动。Stack align 设置为“4”。这指的是栈指针SP的对齐方式。Cortex-M系列内核要求栈指针必须4字节对齐否则在访问栈内数据或进行异常处理时会导致硬件错误HardFault。设置为4确保了编译器生成的代码和运行时库不会破坏这一对齐规则。注意 这里的“Stack align”设置与后面链接脚本里定义的堆栈大小-D_CSTACK_SIZE是两回事。前者是编译器的行为约束后者是给链接器分配的具体内存空间大小。2.2.2 General Options - Output控制输出文件格式这个标签页保持默认即可。“Output file”默认是“Debug\Exe$(ProjectName).out”这是IAR自己的调试格式文件包含了丰富的调试信息如符号表用于在C-SPY调试器中加载和调试。我们最终要的HEX或BIN文件是通过链接器额外生成的。2.2.3 General Options - Library Configuration运行时库的选择Library 选择“Full”。这表示使用标准的完整C/C运行时库DLIB。它提供了完整的标准库函数如printf,malloc,memcpy等和底层系统调用如__write,__read用于半主机Semihosting或重定向到串口。对于资源极其紧张的项目可以选择“Normal”或“Custom”来裁剪但作为起步工程“Full”是最省心、功能最全的选择能避免很多因库函数缺失导致的链接错误。2.2.4 C/C Compiler - LanguageC语言规范设置Language 选择“C”。我们的主程序是C语言文件。Require prototypes务必勾选。这个选项要求函数在使用前必须有声明或定义。这是一个非常好的编程习惯强制检查能避免很多因函数调用参数不匹配导致的隐蔽错误。勾选后如果你调用了一个还未声明或定义的函数编译器会报错。Language conformance 选择“Relaxed ISO/ANSI”。这个模式比严格的“ISO”模式更宽松允许一些编译器的扩展语法和不太符合标准但常见的写法对初学者更友好。例如它允许在代码中间声明变量C99特性而严格的ISO C89要求变量声明必须在函数开头。3. 链接与调试配置打通从代码到芯片的最后一公里3.1 Linker配置内存布局与输出控制链接器Linker负责将编译器生成的多个目标文件.o和库文件合并成一个可执行文件并按照指定规则分配到芯片的Flash和RAM地址上。Output标签页 勾选“Allow C-SPY-specific extra output file”。这个选项允许生成额外的输出文件通常用于调试。保持勾选。Extra Output标签页 勾选“Generate extra output file”。这里可以指定生成其他格式的文件比如我们后面要用的Intel HEX文件。但先不急我们稍后在链接脚本里统一配置。Config标签页 这是链接器配置的核心。勾选“Override default”覆盖默认的链接器配置文件。点击浏览按钮定位到IAR安装目录下的默认链接脚本。通常路径类似于C:\Program Files (x86)\IAR Systems\Embedded Workbench x.x\arm\config\lnkarm.xcl。这个xcl文件就是IAR的链接器命令文件它用一套特定的指令定义了内存区域、段分配等。关键操作不要直接使用这个系统路径下的文件。而是将它复制一份粘贴到你当前工程的根目录下即和STM32F103_Blinky.ewp工程文件在同一目录。然后在“Override default”下方的输入框里将路径改为$PROJ_DIR$\lnkarm.xcl。$PROJ_DIR$是IAR预定义的一个宏代表当前工程文件所在的目录。这样做的好处是链接脚本成了工程的一部分你可以随意修改它而不用担心影响其他工程也便于工程迁移和版本管理。3.2 修改链接脚本以适配具体芯片现在用记事本或任何文本编辑器推荐Notepad、VS Code等打开你刚复制到工程目录下的lnkarm.xcl文件。我们需要根据万利板子上STM32F103芯片的具体型号来修改内存地址和大小。假设板载芯片是STM32F103C8T6它有64KB Flash0x10000字节和20KB RAM0x5000字节。找到文件中定义内存区域的部分通常通过-D选项定义符号-Z选项分配段。我们需要修改以下几处// 原内容可能是注释掉的是默认值或示例 //-DROMSTART08000 //-DROMENDFFFFF //-DRAMSTART100000 //-DRAMEND7FFFFF // 修改为STM32F103C8T6的配置 -DROMSTART0x8000000 // Flash起始地址对于STM32F1固定为0x08000000 -DROMEND0x800FFFF // Flash结束地址 起始地址 大小 - 1 0x08000000 0x10000 - 1 0x0800FFFF -DRAMSTART0x20000000 // RAM起始地址Cortex-M3内核固定为0x20000000 -DRAMEND0x20004FFF // RAM结束地址 0x20000000 0x5000 - 1 0x20004FFF // 修改中断向量表的存放位置必须放在Flash起始处 //-Z(CODE)INTVEC00-3F -Z(CODE)INTVECROMSTART-ROMEND // 将INTVEC段分配到整个ROM区域链接器会将其放在起始位置 // 调整栈和堆的大小。对于简单应用默认的栈2KB可能够用堆8KB可能太大。 //-D_CSTACK_SIZE2000 //-D_HEAP_SIZE8000 -D_CSTACK_SIZE800 // 栈大小设置为2KB (0x800)。对于没有复杂函数调用和局部变量的简单程序可以更小。 -D_HEAP_SIZE400 // 堆大小设置为1KB (0x400)。如果不使用malloc等动态内存分配甚至可以设为0。实操心得-Z(CODE)INTVECROMSTART-ROMEND这一行看起来是把整个中断向量表分配到了整个Flash区域这合理吗实际上INTVEC是一个特殊的段名链接器识别到它后会优先将其放置在所分配区域的最起始地址。所以这样写是没问题的是一种常见的技巧。更精确的写法可以是-Z(CODE)INTVECROMSTART-ROMSTART0x3F但前者更简洁通用。最后为了生成HEX文件我们需要在lnkarm.xcl文件的末尾在所有其他命令之后添加一行-Ointel-extended,(CODE).hex这行命令告诉链接器在链接完成后额外生成一个Intel HEX格式的文件输出内容为CODE段即程序代码和常量数据文件后缀为.hex。3.3 Debugger配置连接硬件调试器要让程序能下载到板子上并调试需要配置调试器。Setup标签页Driver 选择“Third-Party Driver”。因为万利板子通常配套的是ST-Link调试器也可能是J-Link等其他调试器我们需要指定其专用的驱动DLL文件。Download标签页 勾选“Use flash loader”。这样在下载程序时调试器会使用Flash编程算法来擦写芯片内部的Flash而不是直接写RAM。这是必须的。Third-Party Driver标签页IAR debugger driver 在这里输入你的ST-Link调试器驱动DLL文件的完整路径。这个驱动文件通常由ST官方提供的STM32 ST-LINK Utility软件或独立驱动包安装。常见路径如C:\Program Files (x86)\STMicroelectronics\STM32 ST-LINK Utility\ST-Link Driver\ST-LinkIII-KEIL_SWO.dll或者如果你用的是万利提供的驱动可能在C:\Manley\drivers\STLink\目录下文件名为STM32Driver.dll。请根据你电脑上的实际安装路径填写。如果找不到可以去ST官网下载最新的ST-LINK驱动。注意事项 如果你使用的是J-LinkDriver则应该选择“J-Link/J-Trace”并在对应的J-Link配置页中指定芯片型号。调试器的选择和驱动配置是下载和调试成功的关键配置错误会导致IAR无法识别到硬件。4. 编写“裸奔”的流水灯程序直接操作寄存器工程配置完毕现在我们来写代码。我们将不依赖ST的标准外设库StdPeriph Lib或HAL库直接通过内存地址访问寄存器来控制LED。这种方式虽然原始但对于理解STM32的底层硬件工作原理至关重要。4.1 硬件连接与寄存器分析查看万利STM32板的原理图假设4个LEDLED2, LED3, LED4, LED5分别连接在GPIOC的Pin4、Pin5、Pin6、Pin7上并且是共阳极接法即IO输出高电平时LED点亮。我们需要控制三个关键部分开启GPIOC的时钟 STM32的任何外设包括GPIO在使用前必须先使能其时钟。相关寄存器是RCC_APB2ENRAPB2外设时钟使能寄存器它的Bit 4IOPCEN控制GPIOC的时钟。地址0x40021018。配置GPIOC的Pin4-7为输出模式 每个GPIO端口有配置寄存器GPIOx_CRL用于Pin0-7和GPIOx_CRH用于Pin8-15。我们要配置Pin4-7所以用GPIOC_CRL。地址0x40011000。每个引脚占用4个bitCNF[1:0]和MODE[1:0]。我们要设置为推挽输出、最大速度50MHz对应的配置是CNF00, MODE11。控制GPIOC的Pin4-7输出高低电平 有两种方法使用GPIOx_BSRR端口位设置/清除寄存器写1到位0-15置位对应引脚输出高写1到位16-31清除对应引脚输出低。地址0x40011010。使用GPIOx_BSRR的低16位置位配合GPIOx_BRR端口位清除寄存器来清零。地址0x40011014。我们采用后者逻辑更清晰。4.2 代码实现与解析在IAR的Workspace中右键工程选择“Add - Add Files...”创建一个新的C文件命名为main.c。将以下代码复制进去// 定义寄存器地址。使用volatile防止编译器优化对这些地址的访问。 #define RCC_APB2ENR (*((volatile unsigned int *)(0x40021018))) // APB2外设时钟使能寄存器 #define GPIOC_CRL (*((volatile unsigned int *)(0x40011000))) // 端口C配置寄存器低8位 #define GPIOC_BSRR (*((volatile unsigned int *)(0x40011010))) // 端口C位设置/清除寄存器 #define GPIOC_BRR (*((volatile unsigned int *)(0x40011014))) // 端口C位清除寄存器 // 简单的软件延时函数用于演示。实际项目中应使用定时器。 void Delay(void) { volatile unsigned int i; // volatile防止循环被优化掉 for(i 0; i 0x3FFFF; i); // 循环次数可根据主频调整 } int main(void) { // 1. 使能GPIOC的时钟 // RCC_APB2ENR的Bit4是IOPCEN将其置1 RCC_APB2ENR | (1 4); // 2. 配置PC4, PC5, PC6, PC7为推挽输出最大速度50MHz // 先清除PC4-PC7对应的配置位CRL寄存器的高16位每4位控制一个Pin // 即清除Pin4(bit19:16), Pin5(bit23:20), Pin6(bit27:24), Pin7(bit31:28) GPIOC_CRL 0x0000FFFF; // 高16位清0低16位PC0-PC3保持不变 // 然后设置这些位为CNF00 (推挽输出), MODE11 (50MHz) // 0x3 0b0011左移到对应位置即可。 // Pin4: 0x3 16 0x00030000 // Pin5: 0x3 20 0x00300000 // Pin6: 0x3 24 0x03000000 // Pin7: 0x3 28 0x30000000 // 将它们或运算在一起就是0x33330000 GPIOC_CRL | 0x33330000; // 3. 主循环实现流水灯效果 while(1) { // LED5 (PC4) 灭 LED2 (PC7) 亮 GPIOC_BRR (1 4); // 清除PC4输出低电平LED5灭 GPIOC_BSRR (1 7); // 置位PC7输出高电平LED2亮 Delay(); // LED2 (PC7) 灭 LED3 (PC6) 亮 GPIOC_BRR (1 7); GPIOC_BSRR (1 6); Delay(); // LED3 (PC6) 灭 LED4 (PC5) 亮 GPIOC_BRR (1 6); GPIOC_BSRR (1 5); Delay(); // LED4 (PC5) 灭 LED5 (PC4) 亮 GPIOC_BRR (1 5); GPIOC_BSRR (1 4); Delay(); } // 理论上main函数不应返回这里用死循环保证。 }4.3 编译、下载与调试编译 点击工具栏上的“Make”按钮或按F7。如果一切配置正确你会在下方的“Build”窗口中看到编译和链接成功的提示显示“Total number of errors: 0”。下载与调试确保你的万利STM32板通过ST-Link与电脑连接好并供电。点击工具栏上的“Download and Debug”按钮或按CtrlD。IAR会先编译工程如果自上次编译后有改动然后通过C-SPY调试器将程序下载到芯片Flash中。下载成功后程序会暂停在main函数的入口处。你可以按F5Go全速运行或者按F10/F11单步执行。观察板子上的LED应该能看到流水灯效果。查找HEX文件 打开你的工程目录进入Debug\Exe子文件夹如果你在编译时选择了“Release”配置则进入Release\Exe你应该能看到一个STM32F103_Blinky.hex文件。这个文件就可以通过STM32的ISP工具如FlyMCU通过串口下载到芯片中脱离调试器独立运行。5. 进阶思考与常见问题排查5.1 从“裸寄存器”到“标准库”直接操作寄存器虽然直观但代码可读性差且容易出错比如算错位偏移。在实际项目中我们强烈建议使用ST提供的标准外设库StdPeriph Library或更现代的HAL/LL库。这些库用结构体和函数封装了寄存器操作例如#include stm32f10x.h #include stm32f10x_gpio.h #include stm32f10x_rcc.h void LED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_4 | GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOC, GPIO_InitStructure); }使用库函数上面的初始化代码变得清晰易懂。要将我们的工程改为使用库需要在工程中添加库的源文件stm32f10x_xxx.c和头文件路径。在工程选项中C/C Compiler - Preprocessor的“Additional include directories”中添加库的头文件目录。在stm32f10x.h中通过#define选择正确的芯片型号。可能还需要修改链接脚本因为库代码会占用一定的Flash和RAM空间。5.2 常见编译、链接与调试问题排查编译错误undefined symbol __write或类似问题 这通常是因为程序中使用了printf等需要底层IO支持的函数但链接器找不到对应的实现。我们选择的是“Full”库它默认可能依赖半主机Semihosting机制而我们的裸机程序没有。解决 有几种方法a) 避免在裸机程序中使用printfb) 重定向printf到串口需要自己实现_write等函数c) 在工程选项General Options - Library Configuration中将printfformatter设置为“Tiny”或“None”以减小体积并避免依赖。链接错误placement fails或section overlaps问题 链接器报告某个段section无法放入指定的内存区域或者段之间发生重叠。解决 这几乎总是因为链接脚本中定义的内存区域ROMSTART/ROMEND,RAMSTART/RAMEND大小小于程序实际需要的大小。请仔细核对芯片数据手册的Flash和RAM容量并正确计算ROMEND和RAMEND的值。例如对于128KB Flash的芯片ROMEND应为0x08000000 0x20000 - 1 0x0801FFFF。下载错误Failed to load flash loader或No debug unit found问题 调试器无法连接芯片或找不到Flash编程算法。解决检查硬件连接USB线、调试器排线是否接好板子是否供电检查调试器驱动路径是否正确在Third-Party Driver配置中。尝试给板子断电再上电然后重新点击下载。检查芯片型号是否选择正确。有时需要手动指定Flash编程算法。在Options - Debugger - Download标签页点击“Edit...”按钮可以手动添加或选择Flash loader文件.flash文件通常在IAR安装目录的arm\config\flashloader\ST下。程序下载后不运行问题 程序能成功下载但复位后LED不亮或者调试时发现PC指针乱飞。解决首先检查main函数是否被正确调用。确保启动文件startup_stm32f10x_xx.s已正确添加到工程中。启动文件负责初始化堆栈指针、向量表然后跳转到main函数。在我们的“裸奔”例子里我们没有显式添加启动文件是因为IAR在链接时如果找不到用户提供的__iar_program_start等入口可能会使用库中默认的启动代码。最稳妥的方式是从标准外设库例程中复制对应的启动文件如startup_stm32f10x_md.s用于中等容量STM32F103到工程并添加。检查中断向量表是否正确放置。在链接脚本中必须确保INTVEC段被放置在Flash起始地址0x08000000。我们的修改-Z(CODE)INTVECROMSTART-ROMEND通常能保证这一点。使用调试器单步执行查看程序是否真的运行到了你的main函数中的代码以及寄存器操作是否生效通过查看“Register”窗口或“Memory”窗口。5.3 工程管理的建议目录结构 建立清晰的目录结构例如MyProject/ ├── EWARM/ # IAR工程文件、调试配置等 ├── User/ # 用户应用代码main.c, app.c等 ├── Libraries/ # 第三方库如ST标准库 │ ├── CMSIS/ │ └── STM32F10x_StdPeriph_Driver/ ├── Drivers/ # 自己的底层驱动led.c, key.c, uart.c等 └── Output/ # 编译输出文件可由IAR选项设置在IAR的工程选项C/C Compiler - Preprocessor和Assembler - Preprocessor中将User、Libraries等目录添加到“Additional include directories”中。版本控制 使用Git等版本控制系统管理你的工程代码但注意忽略Debug、Release等输出目录以及IAR生成的.dep、.pbd等临时文件。可以创建一个.gitignore文件。不同的构建配置 IAR允许你创建多个构建配置Build Configuration如“Debug”和“Release”。在“Debug”配置中可以开启优化等级为None并包含完整的调试信息在“Release”配置中可以开启高级别优化如High for size并关闭调试信息以减小最终二进制文件的大小。通过工具栏上的下拉列表可以快速切换。自己创建一个干净的IAR工程就像为自己搭建了一个专属的工作台。一开始可能会觉得繁琐但一旦搭建好并理解了每个配置项的意义后续的开发效率会大大提升并且能从根本上避免许多因环境混乱导致的问题。从直接操作寄存器开始虽然原始但能让你最深刻地理解芯片是如何工作的这份理解是日后熟练运用各种高级库和框架的坚实基础。当你下次再看到那些库函数时你就能清晰地知道它背后在操作哪个寄存器、哪一位这种感觉才是真正掌握了嵌入式开发的门道。
从零搭建STM32 IAR工程：详解配置、链接脚本与寄存器编程
发布时间：2026/6/6 16:42:32
1. 从“拿来主义”到“自力更生”为什么需要创建自己的STM32 IAR工程很多朋友在刚开始玩STM32的时候都是从官方或者开发板厂商提供的例程开始的。就像我最初接触万利Manley的STM32板子时也是直接打开一个现成的流水灯或者串口例程然后修修改改把GPIO口从PA0改成PC4就算完成了自己的第一个程序。这种做法上手快能快速建立信心看到LED闪烁的那一刻成就感满满。但是久而久之问题就来了。当你需要做一个稍微复杂点的项目比如同时用到定时器、ADC、DMA和串口时你会发现从不同例程里东拼西凑代码就像用不同规格的乐高积木搭房子接口对不上编译报错满天飞底层初始化冲突程序跑起来各种灵异现象。更头疼的是你根本不知道那些例程里的工程选项Options为什么那么设置链接脚本Linker Script里那些神秘的数字代表什么一旦换一块不同Flash或RAM大小的芯片或者想优化代码尺寸和速度就完全无从下手。所以从“改例程”到“建工程”是嵌入式开发从入门到进阶的必经之路。自己创建一个干净的、完全受控的工程意味着你真正理解了从源代码到二进制文件再到芯片上运行的全过程。今天我就以在IAR Embedded Workbench for ARM环境下为万利STM32F103开发板创建一个基础工程为例手把手带你走一遍这个流程。我们会从打开一个空白工程开始一步步配置编译器、链接器、调试器最后写一个最“裸”的、不依赖任何库的流水灯程序并生成HEX文件。这个过程会涉及很多底层细节我会尽量把每个设置背后的“为什么”讲清楚。当你跟着走完这一趟以后再面对任何ARM Cortex-M芯片的工程创建你都会心中有底。2. 工程骨架搭建创建空白工程与核心选项初探2.1 启动IAR与创建新工程首先确保你已经安装了IAR Embedded Workbench for ARM以下简称IAR EWARM。不同版本界面略有差异但核心逻辑相通。我使用的是比较经典的一个版本新版本可能菜单位置有变化但功能关键词是一样的。启动IAR后你可能会看到一个“Embedded Workbench Startup”的对话框。这是一个快速入口直接点击“Create new project in current workspace”按钮是最快的。如果你觉得这个对话框碍事在“Tools - Options...”里可以设置启动时不显示它。如果没看到这个对话框也别慌我们走标准菜单路径点击顶部菜单栏的“Project”在下拉菜单中选择“Create New Project...”。这时会弹出一个“Create New Project”的窗口。这里有两个关键选择Tool chain 必须选择“ARM”。这告诉IAR我们接下来要编译的是针对ARM架构处理器的代码。Project templates 模板选择。这里提供了像“Empty project”空工程、“asm”汇编工程、“C”等选项。强烈建议选择“Empty project”。从零开始虽然第一步是空的但避免了模板自带的一些你可能暂时不理解的配置或文件让我们对工程的每一部分都拥有完全的控制权。点击“OK”。接下来会弹出一个保存对话框。给你的工程起个名字比如“STM32F103_Blinky”。选择一个合适的目录来存放它比如“D:\MyProjects\”。这里有一个非常重要的习惯为每一个工程建立一个独立的文件夹。这样所有工程相关的源文件、头文件、链接脚本、输出文件都会规整地放在一起便于管理和备份。点击“保存”后一个最基础的、空空如也的工程框架就在Workspace工作空间窗口里创建好了。2.2 工程选项Options配置详解现在我们的工程只是个空壳需要告诉IAR我们的目标芯片是谁、如何编译、如何链接、如何调试。这一切都在“Options for node STM32F103_Blinky”对话框中完成。在Workspace窗口中右键点击你的工程名STM32F103_Blinky选择“Options...”配置之旅正式开始。2.2.1 General Options - Target指明目标芯片这是最基础也是最重要的一步它决定了编译器生成指令的基础。Device 点击“Device”旁边的按钮会弹出芯片选择器。在厂商列表中找到“ST”展开后选择“STM32F10x”系列。这里选择系列即可IAR会自动根据后续的链接脚本配置来适配具体型号如STM32F103C8T6。如果你的芯片是STM32F1系列的其他子类这里也通常选STM32F10x。Endian mode 选择“Little”。ARM Cortex-M内核默认采用小端模式Little Endian即数据的低字节存放在低地址。这是绝大多数ARM嵌入式环境的标配除非有特殊需求否则不要动。Stack align 设置为“4”。这指的是栈指针SP的对齐方式。Cortex-M系列内核要求栈指针必须4字节对齐否则在访问栈内数据或进行异常处理时会导致硬件错误HardFault。设置为4确保了编译器生成的代码和运行时库不会破坏这一对齐规则。注意 这里的“Stack align”设置与后面链接脚本里定义的堆栈大小-D_CSTACK_SIZE是两回事。前者是编译器的行为约束后者是给链接器分配的具体内存空间大小。2.2.2 General Options - Output控制输出文件格式这个标签页保持默认即可。“Output file”默认是“Debug\Exe$(ProjectName).out”这是IAR自己的调试格式文件包含了丰富的调试信息如符号表用于在C-SPY调试器中加载和调试。我们最终要的HEX或BIN文件是通过链接器额外生成的。2.2.3 General Options - Library Configuration运行时库的选择Library 选择“Full”。这表示使用标准的完整C/C运行时库DLIB。它提供了完整的标准库函数如printf,malloc,memcpy等和底层系统调用如__write,__read用于半主机Semihosting或重定向到串口。对于资源极其紧张的项目可以选择“Normal”或“Custom”来裁剪但作为起步工程“Full”是最省心、功能最全的选择能避免很多因库函数缺失导致的链接错误。2.2.4 C/C Compiler - LanguageC语言规范设置Language 选择“C”。我们的主程序是C语言文件。Require prototypes务必勾选。这个选项要求函数在使用前必须有声明或定义。这是一个非常好的编程习惯强制检查能避免很多因函数调用参数不匹配导致的隐蔽错误。勾选后如果你调用了一个还未声明或定义的函数编译器会报错。Language conformance 选择“Relaxed ISO/ANSI”。这个模式比严格的“ISO”模式更宽松允许一些编译器的扩展语法和不太符合标准但常见的写法对初学者更友好。例如它允许在代码中间声明变量C99特性而严格的ISO C89要求变量声明必须在函数开头。3. 链接与调试配置打通从代码到芯片的最后一公里3.1 Linker配置内存布局与输出控制链接器Linker负责将编译器生成的多个目标文件.o和库文件合并成一个可执行文件并按照指定规则分配到芯片的Flash和RAM地址上。Output标签页 勾选“Allow C-SPY-specific extra output file”。这个选项允许生成额外的输出文件通常用于调试。保持勾选。Extra Output标签页 勾选“Generate extra output file”。这里可以指定生成其他格式的文件比如我们后面要用的Intel HEX文件。但先不急我们稍后在链接脚本里统一配置。Config标签页 这是链接器配置的核心。勾选“Override default”覆盖默认的链接器配置文件。点击浏览按钮定位到IAR安装目录下的默认链接脚本。通常路径类似于C:\Program Files (x86)\IAR Systems\Embedded Workbench x.x\arm\config\lnkarm.xcl。这个xcl文件就是IAR的链接器命令文件它用一套特定的指令定义了内存区域、段分配等。关键操作不要直接使用这个系统路径下的文件。而是将它复制一份粘贴到你当前工程的根目录下即和STM32F103_Blinky.ewp工程文件在同一目录。然后在“Override default”下方的输入框里将路径改为$PROJ_DIR$\lnkarm.xcl。$PROJ_DIR$是IAR预定义的一个宏代表当前工程文件所在的目录。这样做的好处是链接脚本成了工程的一部分你可以随意修改它而不用担心影响其他工程也便于工程迁移和版本管理。3.2 修改链接脚本以适配具体芯片现在用记事本或任何文本编辑器推荐Notepad、VS Code等打开你刚复制到工程目录下的lnkarm.xcl文件。我们需要根据万利板子上STM32F103芯片的具体型号来修改内存地址和大小。假设板载芯片是STM32F103C8T6它有64KB Flash0x10000字节和20KB RAM0x5000字节。找到文件中定义内存区域的部分通常通过-D选项定义符号-Z选项分配段。我们需要修改以下几处// 原内容可能是注释掉的是默认值或示例 //-DROMSTART08000 //-DROMENDFFFFF //-DRAMSTART100000 //-DRAMEND7FFFFF // 修改为STM32F103C8T6的配置 -DROMSTART0x8000000 // Flash起始地址对于STM32F1固定为0x08000000 -DROMEND0x800FFFF // Flash结束地址 起始地址 大小 - 1 0x08000000 0x10000 - 1 0x0800FFFF -DRAMSTART0x20000000 // RAM起始地址Cortex-M3内核固定为0x20000000 -DRAMEND0x20004FFF // RAM结束地址 0x20000000 0x5000 - 1 0x20004FFF // 修改中断向量表的存放位置必须放在Flash起始处 //-Z(CODE)INTVEC00-3F -Z(CODE)INTVECROMSTART-ROMEND // 将INTVEC段分配到整个ROM区域链接器会将其放在起始位置 // 调整栈和堆的大小。对于简单应用默认的栈2KB可能够用堆8KB可能太大。 //-D_CSTACK_SIZE2000 //-D_HEAP_SIZE8000 -D_CSTACK_SIZE800 // 栈大小设置为2KB (0x800)。对于没有复杂函数调用和局部变量的简单程序可以更小。 -D_HEAP_SIZE400 // 堆大小设置为1KB (0x400)。如果不使用malloc等动态内存分配甚至可以设为0。实操心得-Z(CODE)INTVECROMSTART-ROMEND这一行看起来是把整个中断向量表分配到了整个Flash区域这合理吗实际上INTVEC是一个特殊的段名链接器识别到它后会优先将其放置在所分配区域的最起始地址。所以这样写是没问题的是一种常见的技巧。更精确的写法可以是-Z(CODE)INTVECROMSTART-ROMSTART0x3F但前者更简洁通用。最后为了生成HEX文件我们需要在lnkarm.xcl文件的末尾在所有其他命令之后添加一行-Ointel-extended,(CODE).hex这行命令告诉链接器在链接完成后额外生成一个Intel HEX格式的文件输出内容为CODE段即程序代码和常量数据文件后缀为.hex。3.3 Debugger配置连接硬件调试器要让程序能下载到板子上并调试需要配置调试器。Setup标签页Driver 选择“Third-Party Driver”。因为万利板子通常配套的是ST-Link调试器也可能是J-Link等其他调试器我们需要指定其专用的驱动DLL文件。Download标签页 勾选“Use flash loader”。这样在下载程序时调试器会使用Flash编程算法来擦写芯片内部的Flash而不是直接写RAM。这是必须的。Third-Party Driver标签页IAR debugger driver 在这里输入你的ST-Link调试器驱动DLL文件的完整路径。这个驱动文件通常由ST官方提供的STM32 ST-LINK Utility软件或独立驱动包安装。常见路径如C:\Program Files (x86)\STMicroelectronics\STM32 ST-LINK Utility\ST-Link Driver\ST-LinkIII-KEIL_SWO.dll或者如果你用的是万利提供的驱动可能在C:\Manley\drivers\STLink\目录下文件名为STM32Driver.dll。请根据你电脑上的实际安装路径填写。如果找不到可以去ST官网下载最新的ST-LINK驱动。注意事项 如果你使用的是J-LinkDriver则应该选择“J-Link/J-Trace”并在对应的J-Link配置页中指定芯片型号。调试器的选择和驱动配置是下载和调试成功的关键配置错误会导致IAR无法识别到硬件。4. 编写“裸奔”的流水灯程序直接操作寄存器工程配置完毕现在我们来写代码。我们将不依赖ST的标准外设库StdPeriph Lib或HAL库直接通过内存地址访问寄存器来控制LED。这种方式虽然原始但对于理解STM32的底层硬件工作原理至关重要。4.1 硬件连接与寄存器分析查看万利STM32板的原理图假设4个LEDLED2, LED3, LED4, LED5分别连接在GPIOC的Pin4、Pin5、Pin6、Pin7上并且是共阳极接法即IO输出高电平时LED点亮。我们需要控制三个关键部分开启GPIOC的时钟 STM32的任何外设包括GPIO在使用前必须先使能其时钟。相关寄存器是RCC_APB2ENRAPB2外设时钟使能寄存器它的Bit 4IOPCEN控制GPIOC的时钟。地址0x40021018。配置GPIOC的Pin4-7为输出模式 每个GPIO端口有配置寄存器GPIOx_CRL用于Pin0-7和GPIOx_CRH用于Pin8-15。我们要配置Pin4-7所以用GPIOC_CRL。地址0x40011000。每个引脚占用4个bitCNF[1:0]和MODE[1:0]。我们要设置为推挽输出、最大速度50MHz对应的配置是CNF00, MODE11。控制GPIOC的Pin4-7输出高低电平 有两种方法使用GPIOx_BSRR端口位设置/清除寄存器写1到位0-15置位对应引脚输出高写1到位16-31清除对应引脚输出低。地址0x40011010。使用GPIOx_BSRR的低16位置位配合GPIOx_BRR端口位清除寄存器来清零。地址0x40011014。我们采用后者逻辑更清晰。4.2 代码实现与解析在IAR的Workspace中右键工程选择“Add - Add Files...”创建一个新的C文件命名为main.c。将以下代码复制进去// 定义寄存器地址。使用volatile防止编译器优化对这些地址的访问。 #define RCC_APB2ENR (*((volatile unsigned int *)(0x40021018))) // APB2外设时钟使能寄存器 #define GPIOC_CRL (*((volatile unsigned int *)(0x40011000))) // 端口C配置寄存器低8位 #define GPIOC_BSRR (*((volatile unsigned int *)(0x40011010))) // 端口C位设置/清除寄存器 #define GPIOC_BRR (*((volatile unsigned int *)(0x40011014))) // 端口C位清除寄存器 // 简单的软件延时函数用于演示。实际项目中应使用定时器。 void Delay(void) { volatile unsigned int i; // volatile防止循环被优化掉 for(i 0; i 0x3FFFF; i); // 循环次数可根据主频调整 } int main(void) { // 1. 使能GPIOC的时钟 // RCC_APB2ENR的Bit4是IOPCEN将其置1 RCC_APB2ENR | (1 4); // 2. 配置PC4, PC5, PC6, PC7为推挽输出最大速度50MHz // 先清除PC4-PC7对应的配置位CRL寄存器的高16位每4位控制一个Pin // 即清除Pin4(bit19:16), Pin5(bit23:20), Pin6(bit27:24), Pin7(bit31:28) GPIOC_CRL 0x0000FFFF; // 高16位清0低16位PC0-PC3保持不变 // 然后设置这些位为CNF00 (推挽输出), MODE11 (50MHz) // 0x3 0b0011左移到对应位置即可。 // Pin4: 0x3 16 0x00030000 // Pin5: 0x3 20 0x00300000 // Pin6: 0x3 24 0x03000000 // Pin7: 0x3 28 0x30000000 // 将它们或运算在一起就是0x33330000 GPIOC_CRL | 0x33330000; // 3. 主循环实现流水灯效果 while(1) { // LED5 (PC4) 灭 LED2 (PC7) 亮 GPIOC_BRR (1 4); // 清除PC4输出低电平LED5灭 GPIOC_BSRR (1 7); // 置位PC7输出高电平LED2亮 Delay(); // LED2 (PC7) 灭 LED3 (PC6) 亮 GPIOC_BRR (1 7); GPIOC_BSRR (1 6); Delay(); // LED3 (PC6) 灭 LED4 (PC5) 亮 GPIOC_BRR (1 6); GPIOC_BSRR (1 5); Delay(); // LED4 (PC5) 灭 LED5 (PC4) 亮 GPIOC_BRR (1 5); GPIOC_BSRR (1 4); Delay(); } // 理论上main函数不应返回这里用死循环保证。 }4.3 编译、下载与调试编译 点击工具栏上的“Make”按钮或按F7。如果一切配置正确你会在下方的“Build”窗口中看到编译和链接成功的提示显示“Total number of errors: 0”。下载与调试确保你的万利STM32板通过ST-Link与电脑连接好并供电。点击工具栏上的“Download and Debug”按钮或按CtrlD。IAR会先编译工程如果自上次编译后有改动然后通过C-SPY调试器将程序下载到芯片Flash中。下载成功后程序会暂停在main函数的入口处。你可以按F5Go全速运行或者按F10/F11单步执行。观察板子上的LED应该能看到流水灯效果。查找HEX文件 打开你的工程目录进入Debug\Exe子文件夹如果你在编译时选择了“Release”配置则进入Release\Exe你应该能看到一个STM32F103_Blinky.hex文件。这个文件就可以通过STM32的ISP工具如FlyMCU通过串口下载到芯片中脱离调试器独立运行。5. 进阶思考与常见问题排查5.1 从“裸寄存器”到“标准库”直接操作寄存器虽然直观但代码可读性差且容易出错比如算错位偏移。在实际项目中我们强烈建议使用ST提供的标准外设库StdPeriph Library或更现代的HAL/LL库。这些库用结构体和函数封装了寄存器操作例如#include stm32f10x.h #include stm32f10x_gpio.h #include stm32f10x_rcc.h void LED_Init(void) { GPIO_InitTypeDef GPIO_InitStructure; RCC_APB2PeriphClockCmd(RCC_APB2Periph_GPIOC, ENABLE); GPIO_InitStructure.GPIO_Pin GPIO_Pin_4 | GPIO_Pin_5 | GPIO_Pin_6 | GPIO_Pin_7; GPIO_InitStructure.GPIO_Mode GPIO_Mode_Out_PP; GPIO_InitStructure.GPIO_Speed GPIO_Speed_50MHz; GPIO_Init(GPIOC, GPIO_InitStructure); }使用库函数上面的初始化代码变得清晰易懂。要将我们的工程改为使用库需要在工程中添加库的源文件stm32f10x_xxx.c和头文件路径。在工程选项中C/C Compiler - Preprocessor的“Additional include directories”中添加库的头文件目录。在stm32f10x.h中通过#define选择正确的芯片型号。可能还需要修改链接脚本因为库代码会占用一定的Flash和RAM空间。5.2 常见编译、链接与调试问题排查编译错误undefined symbol __write或类似问题 这通常是因为程序中使用了printf等需要底层IO支持的函数但链接器找不到对应的实现。我们选择的是“Full”库它默认可能依赖半主机Semihosting机制而我们的裸机程序没有。解决 有几种方法a) 避免在裸机程序中使用printfb) 重定向printf到串口需要自己实现_write等函数c) 在工程选项General Options - Library Configuration中将printfformatter设置为“Tiny”或“None”以减小体积并避免依赖。链接错误placement fails或section overlaps问题 链接器报告某个段section无法放入指定的内存区域或者段之间发生重叠。解决 这几乎总是因为链接脚本中定义的内存区域ROMSTART/ROMEND,RAMSTART/RAMEND大小小于程序实际需要的大小。请仔细核对芯片数据手册的Flash和RAM容量并正确计算ROMEND和RAMEND的值。例如对于128KB Flash的芯片ROMEND应为0x08000000 0x20000 - 1 0x0801FFFF。下载错误Failed to load flash loader或No debug unit found问题 调试器无法连接芯片或找不到Flash编程算法。解决检查硬件连接USB线、调试器排线是否接好板子是否供电检查调试器驱动路径是否正确在Third-Party Driver配置中。尝试给板子断电再上电然后重新点击下载。检查芯片型号是否选择正确。有时需要手动指定Flash编程算法。在Options - Debugger - Download标签页点击“Edit...”按钮可以手动添加或选择Flash loader文件.flash文件通常在IAR安装目录的arm\config\flashloader\ST下。程序下载后不运行问题 程序能成功下载但复位后LED不亮或者调试时发现PC指针乱飞。解决首先检查main函数是否被正确调用。确保启动文件startup_stm32f10x_xx.s已正确添加到工程中。启动文件负责初始化堆栈指针、向量表然后跳转到main函数。在我们的“裸奔”例子里我们没有显式添加启动文件是因为IAR在链接时如果找不到用户提供的__iar_program_start等入口可能会使用库中默认的启动代码。最稳妥的方式是从标准外设库例程中复制对应的启动文件如startup_stm32f10x_md.s用于中等容量STM32F103到工程并添加。检查中断向量表是否正确放置。在链接脚本中必须确保INTVEC段被放置在Flash起始地址0x08000000。我们的修改-Z(CODE)INTVECROMSTART-ROMEND通常能保证这一点。使用调试器单步执行查看程序是否真的运行到了你的main函数中的代码以及寄存器操作是否生效通过查看“Register”窗口或“Memory”窗口。5.3 工程管理的建议目录结构 建立清晰的目录结构例如MyProject/ ├── EWARM/ # IAR工程文件、调试配置等 ├── User/ # 用户应用代码main.c, app.c等 ├── Libraries/ # 第三方库如ST标准库 │ ├── CMSIS/ │ └── STM32F10x_StdPeriph_Driver/ ├── Drivers/ # 自己的底层驱动led.c, key.c, uart.c等 └── Output/ # 编译输出文件可由IAR选项设置在IAR的工程选项C/C Compiler - Preprocessor和Assembler - Preprocessor中将User、Libraries等目录添加到“Additional include directories”中。版本控制 使用Git等版本控制系统管理你的工程代码但注意忽略Debug、Release等输出目录以及IAR生成的.dep、.pbd等临时文件。可以创建一个.gitignore文件。不同的构建配置 IAR允许你创建多个构建配置Build Configuration如“Debug”和“Release”。在“Debug”配置中可以开启优化等级为None并包含完整的调试信息在“Release”配置中可以开启高级别优化如High for size并关闭调试信息以减小最终二进制文件的大小。通过工具栏上的下拉列表可以快速切换。自己创建一个干净的IAR工程就像为自己搭建了一个专属的工作台。一开始可能会觉得繁琐但一旦搭建好并理解了每个配置项的意义后续的开发效率会大大提升并且能从根本上避免许多因环境混乱导致的问题。从直接操作寄存器开始虽然原始但能让你最深刻地理解芯片是如何工作的这份理解是日后熟练运用各种高级库和框架的坚实基础。当你下次再看到那些库函数时你就能清晰地知道它背后在操作哪个寄存器、哪一位这种感觉才是真正掌握了嵌入式开发的门道。
