简介《IAR中文用户手册官方版》是IAR Systems官方发布的IDE说明文档面向使用AVR微控制器并基于IAR Embedded Workbench进行嵌入式开发的工程师与学生。手册从产品构成切入逐一介绍C-SPY调试器、C/C编译器、汇编器、XLINK连接器以及XAR Library Builder库创建器、XLIB Librarian库管理器等工具的作用能帮助读者快速建立对IDE整体模块的认知教程部分则按流程覆盖新建工程、应用程序编译连接、C-SPY调试、C与汇编混合编程、C应用创建及中断模拟配有目录式结构便于按需查阅具体操作步骤。资源为单个PDF文件压缩包体积约859KB支持搜索与书签浏览内容紧凑适合离线学习。目前已有3369人学习使用对刚上手IAR工具链、想快速掌握工程创建与调试方法或需要系统查阅官方中文说明的开发者来说是一份有实用价值的参考手册。1. IAR 中文手册真的值得读先搞清楚这本官方 PDF 能帮你什么拿着 AVR 芯片做产品却被 IAR Embedded Workbench 的英文界面和报错信息搞到怀疑人生这恐怕是很多从 Keil 转过来的开发者共同经历过的坎。我最初拿到这份 IAR 中文用户手册时以为只是把英文 PDF 机翻了一遍实际上它把 IDE 的工程管理、C-SPY 调试器、编译器选项、XLINK 连接器这几条主线梳理得很清楚尤其适合刚接触 AVR 平台又不想对着英文帮助文档硬啃的人。这份手册不是代码大全它是帮你把工具链用明白的地图教程部分从建工程一路走到中断仿真基本覆盖了日常开发 90% 的操作面。如果你正在用 AVR 系列单片机做项目或者准备从其他 IDE 迁到 IAR这本手册值得花一个晚上通读一遍。2. 工程创建与编译链路从新建工作区到生成 hex 的完整走一遍2.1 为什么 IAR 的工程结构和其他 IDE 不一样IAR Embedded Workbench 的工程管理逻辑是“工作区Workspace包含工程Project工程包含组Group组包含文件”。这个层级关系和 Keil 的 Target 分组逻辑有些相似但有一个明显区别IAR 的工程文件是基于文本的.ewp文件工作区是.eww文件。这意味着你可以用文本比对工具去查看工程配置的差异这在做代码评审或者迁移工程时非常有用。另一个容易忽略的点是IAR 允许在工程、组、文件三个级别分别设置选项。文件级选项会覆盖组级组级会覆盖工程级。这个特性在混合 C 和汇编、或者某个文件需要特殊优化等级时特别实用比如某个时序关键的函数需要高优化而其他文件保持体积优化。手册里对这一点是散落在教程各处的没有单独拿一章出来强调但实际用起来这是最高频的配置操作之一。2.2 新建工程的完整操作步骤按照手册 2.1.1 小节的步骤走一遍重点不是点哪里而是每一步为什么要这么选。以 AVR ATmega128 为例完整流程如下打开 IAR Embedded Workbench菜单栏选择Project Create New Project弹出对话框里选AVR类别下的Empty project然后点OK。此时会要求保存.ewp文件建议在工程目录下新建prj子目录存放。Project Create New Project Tool chain: AVR Project template: Empty project 保存位置: ./prj/demo.ewp这里有一个隐藏细节模板列表里还有C和C的带 main 文件的模板但选Empty project更干净避免生成多余的启动文件和注释模板。接下来创建工作区File New Workspace 保存为: ./demo.eww然后把工程添加到工作区右键工作区窗口空白处选Add Existing Project选中刚才保存的demo.ewp。接下来要为工程选择目标芯片右键工程名选Options在General Options Target标签页里Device: ATmega128 在 Device 下拉框选择具体型号 勾选 Use extended pointer support如果需要访问外部存储器Device选型决定了编译器预定义的寄存器头文件和连接器命令文件。这里常见的错误是只选了AVR系列没选具体型号导致编译时io.h找不到正确的寄存器定义。选完芯片后开始添加源文件。在工程上右键选Add Add New File新建main.c#include ioAVR.h int main(void) { DDRB | (1 DDB0); /* PB0 设为输出 */ PORTB | (1 PB0); /* 输出高电平 */ while(1); }这段代码的逻辑很简单DDRB寄存器把 PB0 配置为输出PORTB置高让 LED 点亮。注意头文件用的是ioAVR.hIAR 针对 AVR 系列提供了统一的寄存器定义头文件它内部会根据Device选项自动包含对应型号的定义不用手动根据芯片型号去换头文件这一点比老式开发流程里手动写寄存器地址要省心很多。然后右键工程名选Options设置输出格式。在Linker Output标签页里Output file: demo.hex Format: Other Output format: intel-extended这里要说明intel-extended格式是下载器最常用的 hex 格式支持 32 位地址扩展如果用intel-standard在某些烧录器上会出现地址截断的问题。设置完成后按 F7 编译工程。2.3 编译选项里最该调的三个参数编译选项集中在Options C/C Compiler里。三个参数直接影响代码质量和调试体验。第一个是Optimization等级。IAR 提供None、Low、Medium、High、Size这几个档位。调试阶段选None因为变量不会被优化掉单步调试时能看到所有局部变量发布阶段选High或Size。要注意High优化下某些无符号整型循环变量可能被优化成寄存器变量调试器里看着变量值会跳变这是因为优化后变量不一定每次都写入内存。这不是编译器的 bug是优化副作用。第二个是Language里的C standard选C99还是C11。如果你的代码用了stdint.h里的uint32_t那任意标准都行。但如果你用了for(int i 0; ...)这种在 for 里声明变量的写法C99 以下标准会报错或者警告。IAR 默认可能是 C89所以老代码编译出declaration in for loop相关的警告时优先检查这里是不是没切到 C99。第三个是Preprocessor Defined symbols。很多 AVR 工程依赖编译期宏来控制代码分支比如Defined symbols: F_CPU16000000UL这个宏在延时函数里会被用到UART 波特率计算也依赖它。如果忘了定义代码里读到的是 0除零错误可能在运行时才暴露编译期完全不报错。2.4 连接器配置地址段与启动代码的关系XLINK 连接器的配置文件是.xcl文件位置在安装目录的avr/config下。工程默认会自动引用对应芯片的.xcl但有个重要概念要理解启动代码cstartup是连接器生成的不是编译器生成的。你写的main()只是入口真正的执行起点是__program_start它负责初始化栈指针、清零.bss段、拷贝.data段然后才调用main()。理解这一点对排查“程序不跑”的问题很有帮助。如果你在连接器选项里改了 ROM 起始地址但没同步修改中断向量表的位置芯片上电后跳到错误的向量表程序会跑飞。手册的教程部分没有深入讲这一段但Options Linker Config里可以勾选Override default program entry如果需要自定义入口函数这里就是那个开关。连接器输出的.map文件很重要在Options Linker List里勾选Generate linker map file编译后在输出目录里能看到.map文件里面记录了每个段的起始地址、长度、占用率。当遇到 FLASH 空间不足或者 RAM 溢出时先打开.map文件看是哪个段爆了再有针对性地优化这比瞎猜效率高得多。3. 调试器实战C-SPY 的断点体系和仿真器驱动怎么配合3.1 代码断点、数据断点和条件断点的使用边界IAR C-SPY 调试器把断点分成三类每类解决不同的问题。代码断点就是常规的在某一行暂停适合查逻辑分支是否走到预期位置。数据断点Data Breakpoint在变量被写入时触发这在追踪全局变量被谁修改时非常有用。条件断点是在代码断点上附加条件表达式比如x 100满足条件才停下。在 C-SPY 里设置数据断点的方式和 Keil 不太一样。Keil 是在 Watch 窗口里右键变量选断点IAR 是在Debug Breakpoints窗口里点右键选Set Data Breakpoint然后填写变量名或地址。手册里提到这个功能但没有强调它和硬件断点数量的关系。需要留意的是数据断点通常由硬件实现量少如 1-2 个条件断点如果复杂会降级为软件模拟速度变慢。打开 View Breakpoints 右键 Set Data Breakpoint Data: counter Access: Write建议查“变量被谁改掉”的问题不用数据断点直接在变量上右键选Set Advanced Breakpoint更直观。数据断点留着给那种突然跳变的指针值或者被篡改的堆栈地址。3.2 仿真器驱动 vs 硬件调试驱动选错的后果手册第一部分列出了四类 C-SPY 驱动仿真器Simulator、ICE200、JTAGICE、JTAGICE MKII。这个选择在Project Options Debugger Setup Driver里常见错误是手里插着 JTAGICE MKIIDriver 却选的 Simulator结果点调试按钮毫无反应。Simulator 驱动是完全软件模拟目标处理器不需要硬件连接适合做纯逻辑验证。它的中断模拟和外围设备仿真非常有用比如在写 UART 驱动时你可以直接用仿真器喂数据给接收寄存器看程序解析是否正确。但要注意Simulator 模拟的是处理器核心行为不模拟时序所以延时函数的实际耗时它测不了。JTAGICE MKII 驱动对应真实硬件调试除了断点、单步还能实时看 IO 寄存器状态。在Options Debugger JTAGICE MKII标签页里可以设置通信接口Communication: USB / COM port如果选 COM 口要确认波特率和实际设备匹配否则连接报target not responding。3.3 调试时编辑代码的生效机制C-SPY 支持调试时直接改代码改完后点Debug Reset或直接重启调试会话修改会生效。这里容易踩的坑是改了代码但没重新编译点 Restart 后跑的仍然是旧代码。IAR 的逻辑是调试会话启动时会检查源文件时间戳和可执行文件是否一致如果不一致会提示是否重新编译。但如果你改的是头文件而工程里Options C/C Compiler Preprocessor没有勾选自动包含依赖检查头文件改动可能不会触发重编。我的习惯是在 IDE 右下角的状态栏确认显示的是Build complete才继续调试。如果是Build skipped说明工程认为没有改动这时候强制按 F7 重新编译一次避免带着旧二进制调试新代码。这属于血泪教训曾经因为头文件里改了一个宏定义以为重新编译过实际跑的还是旧固件排查了整整一下午。3.4 调试信息格式与反汇编窗口Options C/C Compiler Output里有Generate debug information选项默认是勾选的。如果你为了缩小 hex 体积把这个选项关掉C-SPY 就只能反汇编调试看不到源文件变量窗口也全失效。编译后的调试信息格式是 UBROF这是 IAR 私有的调试格式XLINK 和 C-SPY 之间的配合依赖它。反汇编窗口在View Disassembly打开后能看到 C 源码和汇编指令的混合视图。这个窗口在排查编译优化是否过度时特别有用比如你可以对比源码里的一行加法操作对应了几条汇编指令。如果优化等级为 High有些变量操作会被合并或者删除这时候就能直观看到。volatile unsigned char flag; flag 0x01;加了volatile关键字反汇编里一定能看到对flag地址的写操作不加的话如果后面没读到这个变量编译器可能直接优化掉这条语句。所以排查“变量好像没被赋值”的问题时先看反汇编确认它到底有没有对应的写指令。4. C 与汇编混合编程和中断仿真从调用规则到模拟触发4.1 调用规则为什么要先查清楚手册 2.3.1 节专门讲了“检查调用规则”这是 C 调汇编的前提。IAR AVR 编译器的调用规则规定参数通过寄存器传递前 8 个字节参数使用 R8-R15/R16-R23 这组寄存器返回值的低字节在 R24高字节在 R25。如果你在汇编模块里自己写了一个函数R0-R7 和 R26-R27 是自由使用的但 R28-R29 是帧指针不能随便动。常见的翻车现场是C 文件里声明了一个外部汇编函数uint16_t calc(uint8_t a, uint8_t b)汇编里写函数入口时直接用了R28/R29存储中间变量结果这个函数跑完调用者的局部变量全乱了。因为 IAR 的 C 代码编译器可能把某些局部变量分配在寄存器里你的汇编函数破坏了R28/R29回到 C 代码后栈帧对不上了。解决方法是汇编函数入口先PUSH R28和PUSH R29用完后POP恢复或者干脆不用这两个寄存器。手册里提醒检查调用规则实际意思就是让你明白哪些寄存器是可自由破坏的哪些必须保存恢复。4.2 在工程中混入汇编模块的具体步骤在工程里添加汇编模块文件后缀是.s90。右键工程选Add Add New File文件名写delay.s90IAR 会根据后缀识别为汇编源文件。写一个最简的延时函数NAME Delay PUBLIC delay_ms RSEG CODE delay_ms: PUSH R16 PUSH R17 MOV R16, R24 ; 参数从 R24 传入 loop_outer: LDI R17, 200 loop_inner: DEC R17 BRNE loop_inner DEC R16 BRNE loop_outer POP R17 POP R16 RET END逻辑说明NAME定义模块名PUBLIC导出让 C 文件可见的符号。RSEG CODE指定代码段。C 文件调用时第一个参数在 R24所以用MOV R16, R24取出来。两层循环实现粗略的毫秒延时。对应的 C 声明写法是extern void delay_ms(unsigned char ms);调用时直接delay_ms(50)即可。注意 C 文件里不要省略extern否则编译器默认这个函数是 C 函数链接时符号对不上。汇编里的delay_ms符号名要和 C 声明完全一致IAR 默认大小写敏感。4.3 中断仿真Simulator 下怎么验证中断逻辑手册 2.5 节的“模拟一个中断”是很有价值的一章。在没有硬件的情况下Simulator 驱动可以手动触发中断验证中断服务程序是否正确。步骤分三步第一步添加中断句柄。AVR 的中断服务程序用#pragma vector指定向量#pragma vectorTIMER0_OVF_vect __interrupt void TIMER0_OVF_ISR(void) { /* 中断处理逻辑 */ TCNT0 0x00; }__interrupt关键字告诉编译器这个函数是中断服务程序编译器会自动生成中断进入和退出时的寄存器保存恢复代码。#pragma vector指定了中断向量名TIMER0_OVF_vect是 IAR 头文件里预定义的定时器 0 溢出中断向量。第二步在工程选项里选择 Simulator 驱动。Options Debugger Setup Driver选Simulator。第三步在调试会话里View Interrupts打开中断控制窗口里面列出了目标芯片支持的所有中断向量。手动选中TIMER0_OVF点Trigger按钮程序就会跳到中断服务程序执行。这个方法在生产环境验证“中断没触发”的问题非常高效。先确认代码逻辑没问题再查硬件连接直接排除了固件嫌疑。需要注意Simulator 的中断触发是异步的如果当前正在执行某些汇编指令中断响应会等到当前指令完成。4.4 中断与断点中宏的使用场景C-SPY 宏系统是个经常被忽略的高级功能它可以在断点触发时自动执行一组操作。手册 2.5.4 节提到中断和断点中宏的使用实际场景是这样的你要调试一个温度采样程序希望在温度变量超过阈值时自动把一组寄存器值存到日志数组里而不是手工一步步去查看。在断点窗口里给断点绑定宏Breakpoint Properties Action Macro __message Temp overflow at PC 0x%x, $PC宏里用了$PC表示程序计数器。C-SPY 的宏系统支持__message、__writeMemory、__readMemory等操作。还可以在宏里写数据到主机文件。比如__var file; file __open(log.txt, w); __write file, value: %d\n, temperature; __close(file);这个宏在嵌入式调试里远比你想的实用。当仿真器跑一个 10 分钟的压测流程时你不可能守着屏幕看变量变化宏可以自动记录关键数据。不过要注意宏操作会影响调试时序在高实时性要求的场景里宏写文件可能丢数据。5. 常见问题排查与避坑现场五个我实际踩过的坑5.1 XLINK 列表文件覆盖了编译器输出现象编译后生成的.lst文件内容变成了链接器映射信息编译器的汇编列表文件不见了。原因IAR XLINK 连接器的默认列表文件后缀就是.lst而编译器的汇编输出列表文件后缀也是.lst。如果工程输出目录设置相同XLINK 运行时会覆盖掉编译器生成的文件。手册 1.2.2 节里专门写过这个注意事项但很容易漏看。解决在Options Linker List里把连接器的列表文件改名例如Linker List Output list file: project.map这样连接器映射信息写到.map文件编译器的.lst文件就不会被覆盖。从那以后我新建工程的第一步就是先改这个设置。5.2 编译通过但代码不执行卡在中断向量表附近现象烧录后程序完全没反应用 JTAGICE MKII 连接调试PC 停留在复位向量处打转没有进入main()。原因在连接器配置里改了 ROM 起始地址或者手动定义了中断向量段.intvec的位置导致复位向量表中的入口地址与实际代码位置对不上。芯片复位后读到的跳转地址是无效的程序直接跑飞。解决在Options Linker Config里点Edit检查段定义-Z(CODE)INTVEC0-0x7F -Z(CODE)CODE0x80-...确认INTVEC段确实定位在 Flash 起始地址0x0000如果在0x80之后中断向量表就废了。一般除非要做 Bootloader 分区否则不要动这个段地址。5.3 调试时 Watch 窗口的变量显示unavailable现象单步调试到某一行Watch 窗口里局部变量显示unavailable无法查看值。原因编译优化等级为High或Size时局部变量可能被优化到寄存器中且寄存器的生命周期比源代码里的变量作用域短。在某些代码行变量的值在寄存器里已经不存在了调试器就显示 unavailable。解决临时把优化等级调到None重新编译调试。如果要复查某个 bug 时不想牺牲性能可以把那个变量声明为volatile或者在Options C/C Compiler Optimization里对单个文件设置。选中文件右键Options把该文件的优化等级调低其他文件保持高优化。5.4 连接器提示Error[e27]: Entry symbol not defined现象链接时报Entry symbol __program_start not defined或者Error[e27]工程无法生成可执行文件。原因工程里没有包含启动代码文件或者连编时把启动代码排除在外了。IAR AVR 的启动代码默认由连接器自动处理但如果你在工程里手动添加了某些库文件或者把cstartup相关的源文件从工程里删了入口符号就找不到了。解决在Options Linker Config里勾选Override default program entry把入口符号改为__program_start或者更省事的做法是重新创建一个工程把已有文件加进去而不是在原工程上删来删去。提示不要手写启动代码IAR 的启动代码和库的配合很紧密手写容易踩到.data段初始化的问题。5.5 hex 文件烧进去但运行结果和仿真器仿真不一致现象Simulator 里调试逻辑完全正确仿真通过烧到真实芯片后行为不一致比如某个标志位没置上或者延时时间明显不对。原因Simulator 不模拟外部电路也不模拟硬件外设的时序细节。芯片实际运行时引脚电平翻转速度、中断响应的时钟周期、以及外部晶振的实际频率都与仿真不同。还有一个很隐蔽的点Simulator 默认使用内部 RC 振荡器的频率参数而实际板子用的是外部晶振如果代码里没有正确配置熔丝位芯片实际跑在 8MHz 内部 RC 下而代码按 16MHz 外部晶振计算延时时间就对不上了。解决烧录前检查熔丝位配置。在 IAR 里可以通过Project Options Debugger JTAGICE MKII Fuses查看当前熔丝位。代码里用F_CPU宏时要确保它和实际时钟匹配。另外延时函数最好用定时器实现不要用_delay_loop那种循环延时循环延时会随优化选项波动。6. 把库模块和自定义库用到项目里从库创建到链接时的模块裁剪6.1 库模块的两种形态和选择依据手册 2.6 节“使用库模块”和 1.1.7 节的 XAR/XLIB 内容看着不起眼但这是 IAR 工程规模变大后绕不开的话题。IAR 的库分为两类一类是编译器自带的运行库DLIB 和 CLIB另一类是你自己打包的第三方代码库。DLIB 是 ISO/ANSI 兼容的完整库支持 C、浮点运算和 STL但代码体积大CLIB 是轻量级库不支持完整 C 特性体积小但有些功能缺失。选库的依据很简单如果项目只做逻辑控制不涉及浮点运算和复杂字符串操作直接选 CLIB 能省不少 Flash如果用了printf的浮点格式输出DLIB 是唯一选择。切换在Options General Options Library Configuration里下拉框选CLIB或DLIB。注意切换后要重新编译整个工程因为库的头文件和实现都变了只重编单个文件会出现奇怪的类型不匹配错误。另外DLIB 库还分完整版和精简版在Library Configuration里有Normal、Compact、Full三档。Compact档的printf不支持浮点Full档支持。如果你的printf用了%f但输出总是 0先检查这里是不是选的Compact。6.2 用 XAR 打包自己的代码模块XAR 工具把多个可重定位目标文件打包成单个库文件。命令行调用格式如下xar avr -o mylib.a90 delay.r90 uart.r90参数说明avr指定目标平台-o指定输出库文件名后面的.r90是汇编器或编译器的可重定位输出文件。我一般在工程里建一个lib子目录把常用的底层驱动UART、I2C、定时器编译成库多工程共用减少重复编译。在工程里使用这个库右键工程Add Add Existing File选中mylib.a90然后在Options Linker Library里勾选Include all library modules或者保持默认的Only pull in used modules也可以。默认选项会从库里只链接被引用的模块这个行为是由 XLINK 的库模块机制决定的和 GNU 的--gc-sections不是一个概念但效果类似。6.3 链接器只拉取用到的模块理解库裁剪机制XLINK 在处理库文件时会检查每个目标模块的PUBLIC符号看是否有外部引用指向它。没有引用的模块直接跳过不进入最终可执行文件。这个机制是库设计的基石但是有一个坑如果库里的一个模块依赖另一个模块而第一个模块被拉进来了第二个也会被拉进来即使你的代码没有直接引用第二个模块的符号。比如说你的 UART 模块里有uart_init()和uart_send()两个函数放在同一个.c文件编译成同一个模块那么只要你的代码调用了uart_send()uart_init()也会被链接进程序因为它们在同一个模块里XLINK 以模块为粒度裁剪不是以函数为粒度。这带来的经验是写库代码时一个函数一个文件是最理想的粒度控制方式但维护成本高。折中方案是把初始化类函数和操作类函数分别放在不同文件比如uart_init.c和uart_ops.c前者只在需要时被拉入后者单独裁剪。实测下来一个包含 5 个函数的驱动模块拆开成 3 个文件后最终 hex 体积能小 200-400 字节在 Flash 紧张的 8 位 MCU 上还是有意义的。6.4 库的覆盖Override机制按需替换库模块XLINK 的库模块覆盖机制是它和 GNU ld 差异很大的一个点。在 GNU 下如果可执行文件里的符号优先级高于库里的同名符号链接不报错但 IAR XLINK 的行为有些不同它允许在工程里明确指定某个模块替代库里的同名模块操作入口在Options Linker Override里。这个功能在需要替换 DLIB 的某个函数实现时很有用比如自定义memcpy以适配特殊存储器访问或者替换exit函数以配合 RTOS。具体操作Linker Override 勾选 Enabled 在列表里添加要覆盖的模块名和替代的 .r90 文件实测中我一般只在 bootloader 升级模式下用过这个功能替换掉标准库里的delay_cycles实现改用定时器版本。日常应用级开发很少需要动这个选项但理解它的存在可以避免在看到链接警告时不知所措。从个人习惯来说我拿到一个新 SDK 或新芯片的评估板时会先照着这个手册把工程配置走一遍然后把Options里每个标签页截图存到工程目录的doc文件夹里。等后面项目出问题时翻截图最先排查的就是那些改过默认值的选项。希望这本手册能帮你省下和我当初一样的摸索时间。本文还有配套的精品资源点击获取