做嵌入式开发这些年IAR 这个名字基本绕不开。尤其做 STM32、STM8 或者 8051 系列单片机的朋友很多人第一套开发环境就是 IAR Embedded Workbench。早些年用 IAR 8.x 的挺多后来 IAR 9.x 出来以后界面、编译器、调试器都换了一轮。最近不少人在问 IAR 9.40还有一类搜索词特别有意思——“注册工具”。我猜要么是装完以后弹出fatal error[lms001]: license check failed. use the iar license manager to re这条错误要么是许可证那块搞不太明白想找个“注册工具”把激活流程理顺。这篇就把新版 IAR 9.40 和它的许可证注册机制掰开揉碎讲一遍从安装到配置从许可证管理到调试烧录最后把常见的报错和排查经验也整理成速查表。想在新版本上做 STM32、STM8、8051、RISC-V 开发的人或者之前被许可证问题卡住的人这篇应该能帮你省不少时间。1. 新版本概览与核心定位1.1 IAR 9.40到底是什么IAR Embedded Workbench for ARM 是 IAR Systems 出品的集成开发环境rtthread、FreeRTOS 这些实时操作系统在 ARM 平台做移植时经常遇到它。9.40 是 2022 年到 2023 年间发布的较新大版本比起早期 9.x 系列它的内核编译器、运行时库和调试器都有不少更新。很多人一听到“最新版IAR”可能下意识觉得要重新学一套工具链其实核心操作逻辑没变新建工程、写代码、编译、下载、调试这套流程和 8.x 仍然一致只是新版本在芯片支持、编译优化、IDE 交互和许可证机制上做了调整。IAR 和 Keil 是嵌入式开发里最常见的两条路线。Keil 上手直观IAR 在代码体积优化和编译速度上常常更有优势。我个人的使用感受是IAR 9.40 对 C99 和 C11 的支持更干净编译告警给得比老版本更准调试时看变量、看调用栈也顺手。实际做项目时尤其是在做 FreeRTOS 移植、处理启动文件、优化 flash 占用这些场景下IAR 的友好度确实不低。1.2 这个版本解决了什么问题对大多数用户来说升级到 IAR 9.40 最直接的收益是这几块芯片支持范围更广新的 STM32G0、STM32L4、STM32H7 系列、GD32 系列都能在新版本里找到完整器件支持。编译器对 C11 原子操作、内联汇编、字节对齐处理更细腻代码优化等级提升后编译出的固件体积经常比旧版本小 2% 到 5%。IDE 的许可证管理器IAR License Manager做得更加清晰遇到许可证问题不再像以前那样黑箱。调试探针支持更全ST-Link、J-Link、I-jet 这些常见调试器在新版本下识别速度和稳定性都有提升。不过新版本也带来了“新问题”许可证检查和激活流程变得更严格很多人装完以后启动编译直接弹fatal error[lms001]license check failed。这个错误是 9.x 版本里出现频率最高的许可证报错根本不是代码问题纯粹是许可证没有正确注册。理解这一点很多新手就不慌了。1.3 哪些人适合用这个版本现在用 IAR 的人群大概分三类。第一类是学校教学和企业项目里的 STM32/STM8 开发者这些人是 IAR 的老用户从 8.x 升到 9.40 最顺畅。第二类是以前用 Keil但因为工程共编、代码移植、调试效率等原因想尝试切到 IAR 的开发者。第三类是做 8051 系列或者 RISC-V 的嵌入式工程师IAR 对这类小众芯片的支持比很多免费 IDE 都完整。这三类人看这篇文章都有实际好处第一类能解决升级后的许可证和报错问题第二类能搞明白 IAR 工程结构、启动文件、烧录配置这些关键差异第三类可以快速掌握多架构开发环境下 IAR 的使用套路。这篇博文不是官方文档的翻译更像是我实际使用新版本时记录下来的踩坑笔记和操作流程。2. 安装部署与工程初建实操2.1 安装前的准备清单安装 IAR 9.40 之前有几点如果没处理好很容易装到一半就失败或者装完以后启动出现奇怪缺库问题。系统要求IAR 官方说的是 Windows 10/11 64 位。实测在 Windows 7 下也能勉强跑但非常不建议新版自带调试服务对新系统依赖明显老系统上经常出现找不到 DLL 的情况。磁盘空间与路径整个安装包解压后大约 3-5GB编译大型工程时临时文件也不少。最关键的一点安装路径和工程路径尽量不要出现中文和空格。比如D:\project\stm32_测试这种路径在 IAR 的 GCC 后端编译时偶尔会出现查找路径异常换成全英文的工程目录会省掉很多麻烦。运行库依赖IDE 本身依赖 VC 2015-2022 运行库。很多机器装完 IAR 后一打开就报缺少vcruntime140.dll就是因为系统里没有这个运行库。建议先装一遍最新版 Visual C Redistributable再装 IAR。安全软件安装过程中 IAR 会往系统盘的注册表和公共目录写入许可证相关文件部分杀毒软件会拦截。遇到安装卡住或者提示License Manager start failed先把实时防护临时关掉装完再开启这一步能解决一半的安装失败问题。2.2 常规安装步骤IAR 9.40 的安装界面和 8.x 差别不大流程本身不复杂但有几个选项容易选错。第一步运行下载好的安装程序或者通过官方离线安装包安装。如果你用的是评估版安装时会要求填写邮箱和试用订阅评估期一般是 30 天。要注意的是评估版和正式版装的都是同一个 IDE区别只在许可证类型。第二步选择安装的架构支持。IAR 9.40 的安装器会列出一堆可选组件比如 ARM、RISC-V、8051、STM8实际上 9.40 分不同的产品线安装包每个产品线对应一种内核架构。下载的时候要确定自己用的 ARM 版还是 RISC-V 版别下错。安装器里的组件选择主要影响的是 CMSIS 包、芯片支持包和调试探针驱动。第三步安装许可证管理组件。这一步很多人会跳过但实际上 IAR License Manager 是整个许可证激活和管理的核心工具后续处理lms001报错全靠它。安装时把IAR License Manager和IAR License Server Tools都选上不会吃亏。第四步安装完成后进行许可证激活。这一步我们放到第三个大章节详细说。2.3 新建工程的正确姿势打开 IAR 9.40点击Project - Create New Project选择Empty project。没有工程模板的时候很多人会直接去网上拷贝一个模板工程这当然也可以但新手很容易因为工程配置和芯片不匹配导致编译失败。新建工程要注意几个关键配置Device 选择。IAR 的开发流程是“先选芯片再写代码”在Project - Options - General Options - Target里选择具体芯片型号比如 STM32F103C8T6选好之后IAR 会自带对应芯片的链接配置文件.icf不需要自己写链接脚本这是比 Keil 省心的地方。芯片选错或者不选的话编译时经常出现无法找到器件头文件、链接报内存越界。比如 64KB flash 的 STM32F103C8 如果错选成 128KB 的 STM32F103CB程序经常正常编译但烧录后跑飞此类问题排查起来会非常痛苦。编译优化等级。9.40 默认的优化等级是Balanced平衡型如果不熟悉编译器优化带来的问题调试阶段建议先把优化等级调到None或者Low否则代码单步调试时经常出现变量被优化掉、断点不触发的情况。输出 hex 文件。默认编译结果可能是 elf 和调试文件但做生产烧录一般要 hex 文件。在Project - Options - Output Converter里勾选Generate additional output格式选Intel extended hex这样编译后会多一个 hex 文件直接用 ST-LINK Utility 或者 STM32CubeProgrammer 都能烧写。2.4 启动文件与基础工程结构IAR 的工程模板里默认不会自动为你去写 startup 文件。STM32 系列在 IAR 9.40 里可以通过添加设备支持包的方式把启动文件、系统初始化文件自动带进来但很多人用旧习惯还是会自己复制启动文件。实际操作里启动文件的作用非常大。startup_stm32f103xb.s这个文件负责建立中断向量表、初始化栈指针、调用SystemInit然后跳到__iar_program_start如果漏了这个文件或者启动文件版本不匹配程序烧进去完全没有反应调试的时候 PC 指针直接跑飞。在 IAR 工程里检查启动文件有没有被有效加入看编译日志就行。9.40 编译时如果提示Error[Lp011]: section placement failed多半就是启动文件、链接配置文件或者芯片型号三者之间不匹配。以 STM32F103C8T6 为例一个能跑的最小工程至少要有这几个部分主程序文件 main.c启动文件 startup_stm32f103xb.s系统初始化文件 system_stm32f103xb.c 或类似文件链接配置文件比如 stm32f103xb_flash.icf芯片寄存器定义头文件来自 CMSIS 或芯片支持包我在实际建工程的时候会把.icf文件单独放在工程目录下不要修改它除非确实有特殊内存分配需求。比如某些芯片需要把一部分程序放在 RAM 里运行那就需要修改 icf 里的执行域配置但这已经是进阶玩法新手不建议动。3. 许可证注册机制与 IAR License Manager 解析3.1 许可证类型与注册工具的关系说到“注册工具”要先厘清一个概念IAR 许可证注册和管理是基于 IAR License Manager 这个官方工具的。9.40 版本安装后桌面上有个独立的IAR License Manager快捷方式这就是处理许可证的核心入口。在 IAR 的体系里许可证主要分为三类评估版许可Evaluation License安装后自动获得有效期通常是 30 天功能完备但到期后必须激活或者卸载。很多人说“IAR 能免费试用”用的就是这个。节点锁定许可Node-Locked License绑定当前电脑以一个 license 文件方式存在用户把官网下载的许可文件通过 License Manager 导入即可。浮动许可Floating License装在局域网内一台服务器上客户端通过网络来获取许可资源。适合公司团队多人共用许可的场景IAR License Server Tools 就是干这个的。网上经常有人搜索“注册工具”实际想解决的就是两件事一是导入正版 license 文件二是重置/刷新许可证状态。这两件事在官方工具里都能合法完成。可能也有人想找那种生成许可证的工具但这属于违反软件许可协议的行为我不建议尝试一是风险太大开发环境弹窗报错、公司合规审查二是正版许可证在官网申请价格并不算离谱尤其公司批量采购更便宜。用盗版工具导致的系统不稳定和后续移植问题反而更浪费项目时间。3.2 LMS001 报错的来龙去脉很多人在搜索引擎里输入 “fatal error[lms001]: license check failed. use the iar license manager to re...”这个错误在 9.40 中非常典型。它的大白话含义就是编译前检查许可证发现当前机器上没有任何有效的许可或者许可服务停了所以编译器拒绝继续工作。可能的原因如下评估版到期了许可证文件还在但已经过期编译时自然报错。许可证文件被误删了。很多人装完 IAR 之后喜欢清系统临时文件结果把许可证缓存文件给清了。系统时间被改动。IAR 的许可证对系统时钟非常敏感时间回拨或者跳变都会导致校验失败。使用浮动许可证时许可证服务器地址写错、服务没启动或者网络断开了。杀毒软件把许可证文件或缓冲文件隔离了。排查流程建议按照“由简到难”来先打开 IAR License Manager看许可证列表里有没有当前许可证状态是 valid 还是 expired。如果是 expired直接把旧的许可证移除重新导入一遍很多时候问题就解决了。如果没有许可证就检查自己用的到底是评估版还是正式版评估版过期后就只能重新激活或者换正式许可证。3.3 用 IAR License Manager 完成注册具体操作流程如下打开IAR License Manager主界面会显示当前安装的 IAR 版本和许可证状态。不显示许可证时点击左侧License菜单选择Add License会弹出三个选项License file、Activation code、Online license。最常用的方式就是License file——选择你从官方渠道获得的.lic许可文件确认导入许可证状态变成Valid即可。如果公司用的浮动许可证那么要选择Add License Server在里面填上许可证服务器的 IP 地址和端口IAR 默认使用 46.46 端口实际是 58000 系列端口具体看服务器端配置。填完后点 Check如果能看到许可证数量和使用情况说明网络和配置都没问题。注册完成后建议把 IAR License Manager 也做一次刷新。命令行进入 IAR 安装目录执行LMTool.exe refresh会有帮助不过大多数时候界面操作已经够了。回到 IAR 主界面重新编译那个工程LMS001报错通常会消失。3.4 关于许可证踩坑的几点心得第一IAR 9.40 的许可证文件和用户机器是绑定的换电脑、换网卡、甚至系统重装许可证都不一定还能用需要去官网申请重新激活或者转移。这块流程各不一样最好的做法是装好 IAR 后立刻把许可证文件备份到一个不会被杀软清掉的目录。第二不要在装好 IAR 的第一时间修改系统时间。很多工程为了测试日历功能会把系统时间调到很久以前或者很久以后。如果是在许可证检查之后才调的那没事但如果是先调了时间再打开 IAR许可证校验极有可能直接失败。遇到这种情况把时间改回来然后进 License Manager 点一次Repair或重新 refresh 许可证状态即可。第三许可证状态的检查是发生在编译阶段不是启动阶段。所以很多人装完 IAR 都正常打开了界面一直到按 F7 编译才报 LMS001。这给了很多人错觉以为是代码有问题其实是许可证问题。3.5 许可证管理工具的进阶玩法IAR 9.40 的 License Manager 还提供命令行工具正常情况下不用它但如果公司要做批量部署命令行工具反而很实用。比如把许可证文件提前放在某个共享目录通过命令行参数LMTool.exe import自动导入可以做到员工点一下脚本就能完成环境配置。此外IAR 9.40 因为许可证机制更新比较频繁某些老教程里写的lanman或早期工具已经不可用网上搜到的各种所谓“注册工具”也大多是过时信息。记住一点IAR 官方的工具链本身已经包含了许可证注册功能外部工具既不稳定也不安全遇到报错优先用官方 License Manager 解决。3.6 许可证过期后的正解评估版到期是最常见的情况。很多人试用 30 天后突然编译不了第一反应是找“注册工具”续命其实有两个正规途径一是找官方申请延长评估期部分评估授权申请后能再获得 30 天使用期二是直接购买正式授权。正式授权也分年费和永久授权做个人项目用年费版足够。这里还想多说一句IAR 的许可证机制比 Keil 严格但它的本意是服务商业项目对个人学习和开源项目支持也很多。很多芯片原厂会提供定制的 IAR 许可证或者特别的评估授权比如某些开发板厂商会随板子附送一张激活卡大家在买开发板时留意一下赠品有时候能省下一笔费用。4. 调试、烧录与多架构开发经验补全4.1 从编译到烧录的完整链路编译通过之后就是烧录。IAR 9.40 通过Project - Download and Debug或直接按 CtrlD 进入调试模式同时完成程序的下载并启动调试器。也可以选择Project - Download - Download Active Application只下载不调试速度更快。调试器配置在Project - Options - Debugger里默认驱动类型分几类ST-LINK、J-LINK/J-Trace、I-jet、CMSIS-DAP等。使用 STM32 开发板时最常见的就是板载 ST-LINK。选择 ST-LINK 后还要在Debugger - ST-LINK里确认接口方式STM32 新板子基本都是 SWD 口四根线搞定连接稳定不会像 JTAG 那样占太多引脚。SWD 模式下常见的失败原因是接线松动、目标板供电不足排查时优先看 IAR 的Error[31]: Failed to initialize communication这类报错大意就是调试器和目标芯片没建立通讯。烧录配置方面IAR 有 Flash 下载算法不需要像老版本那样手动配置外部烧录器软件。正常情况下勾选了 Download 动作调试器就会自动执行擦除、写入、校验这些流程。如果遇到芯片擦除失败可以回退到Debugger - Download页面把Use flash loader(s)勾上并选择一个合适的 flash loader。STM32F1 系列的 loader 是出厂自带的任何异常基本都是接线问题或者芯片锁死。4.2 SWO 调试的正确使用方法热词里有一条iar的swo怎么使用这个问的人特别多。SWOSingle Wire Output是 ARM Cortex-M 内核提供的一个单引脚调试输出接口在实时性要求高、没法断点看变量的场合格外好用。IAR 里启用 SWO 的步骤如下在Project - Options - Debugger里选择 ST-LINK 或 J-Link进入对应调试器设置页面把SWO或Serial Wire Viewer功能启用确保调试器引脚配置里 SWO 引脚没被禁用。在代码里调用ITM_SendChar()往 ITM 寄存器写字符相当于用 SWO 输出一条调试日志到 IDE 的 Terminal 窗口。运行时IAR 的View - Terminal I/O里能实时看到打印内容。很多人试 SWO 失败是因为目标芯片的 SWO 引脚被复用了。比如 STM32F103 的 PB3 默认是 JTDO/SWO 功能但如果初始化代码里把它配置成普通 GPIOSWO 就不会工作。遇到这种问题先把初始化代码里和 PB3 相关的复用配置注释掉再试。SWO 相比串口 println 的好处是并不占用 UART 外设调试信息走的是 SWD 里面那根独立线对性能影响很小。缺点是需要调试器支持ST-LINK V2 和 J-Link 都能用但 CMSIS-DAP 的兼容性一般。实际项目里我习惯把错误信息用 SWO 输出正常日志用串口输出两边互不干扰排查问题十分方便。4.3 在 IAR 9.40 下移植 FreeRTOS移植 FreeRTOS 时IAR 9.40 和 Keil 的逻辑差别很大。FreeRTOS 官方仓库里其实有 IAR 工程模板而且专门适配过直接用会省很多事。以 STM32F103C8T6 为例在 IAR 里移植的要点如下把 FreeRTOS 源码里的FreeRTOS/Source目录和FreeRTOS/Source/portable/IAR/ARM_CM3目录加入工程。对于 STM32F103 这类 Cortex-M3 内核用的是 IAR 里ARM_CM3这个移植层。把 FreeRTOSConfig.h 配置文件拷贝到工程目录这个文件里面最重要几个宏是configCPU_CLOCK_HZ时钟频率通常配置为 72MHz和configTICK_RATE_HZ时钟节拍一般 1000。配置错误通常会导致系统 tick 慢很多或快很多。中断优先级分组必须设置为NVIC_PriorityGroup_4即全部抢占优先级没有子优先级。FreeRTOS 的临界区代码依赖这一点设置不对时会导致调度异常比如任务不切换卡死或者系统进 HardFault。烧录和调试时IAR 和 FreeRTOS 调试插件可以配合使用但直接在 FreeRTOS 列表窗口看任务状态需要装插件IAR 9.40 的插件管理页里可以搜索FreeRTOS插件安装。不装插件也能调试只是看任务运行状态很麻烦。移植时最常见的错误是Error[Pe020]: identifier configUSE_PREEMPTION is undefined这个纯属 FreeRTOSConfig.h 没加进编译路径。检查Project - Options - C/C Compiler - Preprocessor的 include 路径把 FreeRTOS 根目录和配置目录加进去就行。另外一个常见坑直接拿 Keil 的工程目录结构往 IAR 里拖由于启动文件格式不同Keil 用的是 ARMCC 汇编IAR 用的是IAR格式汇编编译不过。一定要使用 IAR 自己的启动文件和 FreeRTOS portable 文件不要混用。4.4 IAR 的插件机制与 GD 系列支持IAR 9.40 的插件系统经常被忽略但实际非常有用。Project - Options - Building - Build Actions可以在编译前后执行自定义命令。这个功能我经常用来做编译后自动生成 bin 文件或者调用脚本做固件签名。IAR 还支持插件式调试器在Tools - Configure Tools里能添加外部工具。很多人搜iar plugins 是干什么的其实就是这些扩展工具链入口。例如用脚本批量修改固件版本号、调用静态检查工具、甚至把编译结果自动上传到服务器都能用这个机制集成。对于 GD32 系列单片机IAR 9.40 需要单独安装 GD32 的 Support Pack 或者iar gd addon。GD32F103 和 STM32F103 的寄存器基本兼容但 flash 配置、USB 控制器配置有差异IAR 专门做了一个 Addon 来补齐这些差异如果不装编译虽然可能通过但运行会有极其隐蔽的问题比如 USB 枚举失败、flash 操作异常。直接在 IAR 官网的下载页面搜索GD32就能找到对应 Addon安装之后在工程配置里把 device 设置成 GD32F103xx编译器会自动使用正确的外设定义和链接文件。4.5 IAR 下的 8051 与 STM8 开发IAR 并不只有 ARM 版也有IAR Embedded Workbench for 8051和IAR for STM8。早期很多人用 Keil C51 做 8051 开发但如果想用 IAR 生态统一开发要注意 8051 版本和 ARM 版本是独立安装、独立许可证的。装了 ARM 版不代表能编译 8051同理这不通用。8051 版本的使用习惯和 ARM 版很不一样。8051 产品的程序空间小、内存模型复杂IAR 的 8051 编译器对data、idata、xdata这些内存空间的关键字支持很细变量放哪个区直接关系到编译是否报错和运行是否稳定。IAR 9.40 版本对 8051 的存储区配置比旧版友好但新手如果遇到Error[Pe178]: this declaration has no storage class or type这类错误通常是xdata这类关键字没有在编译器设置里打开相应扩展。在Project - Options - C/C Compiler - Language里把Allow IAR extensions勾上能解决大部分和存储区相关的问题。如果你同时在用 STM8 和 8051建议把两个版本都装上。STM8 版在 IAR 里的工程配置和 ARM 版的流程很像基本能一键切过来只是芯片选择不同。4.6 命令行编译与自动化构建压轴部分说一下 IAR 9.40 的命令行工具。很多人以为 IAR 只能通过 IDE 编译其实项目如果比较大的话用命令行可以集成到 CI/CD 流水线里。IAR 安装目录下有个IarBuild.exe执行方式大致是IarBuild.exe project.ewp -build Release这条命令会在后台调用编译器、链接器、输出 hex 文件整个流程和 IDE 内手动构建完全一致只是没有界面。配合IarTools还可以实现固件打包自动上传。我自己做项目时常常保留一个.bat或者 CI 脚本每天上班第一件事双击一下就能拿到最新固件省去打开 IDE、等待加载、手动点击构建的流程。特别是团队里做持续集成时IAR 的命令行模式很有价值。新手如果只用 IDE也可以先在 IAR 的Tools - Configure Tools里把命令行工具添加成菜单项后面做固件签名、批量编译多个变体工程时效率提升很明显。5. 常见问题速查与避坑记录下面整理一个速查表绝大部分我在开发中至少遇到过一次这些问题在 9.40 版本里依然高发错误/现象常见原因解决思路fatal error[lms001]: license check failed评估版过期、许可证文件丢失、系统时间异常、浮动服务器不可达打开 IAR License Manager重新导入或刷新许可证检查许可证状态Error[Lp011]: section placement failed工程内存分配超过芯片实际容量或者启动文件/链接文件和芯片型号不匹配核对芯片型号、启动文件和 .icf 文件是否匹配调整堆栈大小Error[Pe020]: identifier ... is undefinedinclude 路径没配好头文件缺失在Project - Options - C/C Compiler - Preprocessor添加正确的 include 路径下载时提示无法连接调试器ST-LINK/J-Link 驱动问题、接线松动、目标板供电不足、芯片锁死重装调试器驱动检查 SWD 四线连接按住复位键重试芯片锁死就用全擦除恢复程序运行乱跑单步直接跑飞启动文件不对、优化等级过高、栈溢出、中断优先级配置错误先确认启动文件正常优化等级调到 Low/None检查 FreeRTOS 配置和中断分组无法生成 hex 文件Output Converter 未开启在Project - Options - Output Converter勾选 Generate additional output选择 hex 格式编译时找不到 CMSIS 头文件设备支持包没装或者路径没配置在官网下载对应的 Device Support Pack装好后重新打开工程SWO 无输出SWO 引脚被复用、调试器 SWO 使能被关闭检查初始化代码里 PB3 等引脚配置确认调试器配置里已开启 SWO5.1 排查 LMS001 的完整步骤很多人一遇到lms001就胡乱重装软件结果重装以后问题还在因为许可证文件没变。我建议按这个顺序排查打开 IAR License Manager看当前许可证状态。只有Valid才是正常显示Expired或No license就把旧的许可证删掉重导。确认许可证文件路径没有被中文或空格干扰。个别情况下许可证文件在中文路径下会识别失败建议放在C:\IAR_License\这种纯英文路径。使用浮动许可证的检查许可证服务器服务是否启动防火墙是否放行对应端口。可以在命令行用ping和telnet检查服务器连通性。查看本地系统时间。如果时间差超过 12 小时IAR 许可证基本必挂。调整时间后重新打开 IAR必要时重开 License Manager。如果以上都正常尝试在 IAR License Manager 里执行Refresh或重新导入许可文件。有时候许可证只是缓存失效刷新一下就好。整个排查流程一般 5 分钟以内能完成比卸载重装高效得多。5.2 移植和编译的常见避坑这些事情没写进官方文档里但实战中很容易遇到。不要在工程目录里用中文路径不要在源文件名里放中文。IAR 命令行工具对非 ASCII 路径兼容不太好IDE 里能编译一到自动化构建就报错非常坑。优化等级从高调到低时一定要全量重新编译一次不要用增量编译。有些旧版本生成的中间文件在新优化等级下无法正确对应会出现变量值不对、程序卡死的灵异现象。按 F7 前先Project - Clean一下更稳妥。如果从 Keil 工程迁移到 IAR不要直接复制.uvprojx工程文件也没有直接转换工具。正确做法是新建 IAR 工程然后把源文件、头文件、启动文件重新添加进去。FreeRTOS 这类 RTOS 在 IAR 下的中断服务函数必须带有__ramfunc不需要。但要注意 IAR 对中断向量写法要求比较严格直接写void SysTick_Handler(void)就行不要在函数名前加特殊前缀IAR 会通过中断向量表自动完成链接。能正常编译但不运行八成是启动文件问题或者链接文件内存分配问题先在调试状态下看 PC 指针跑到哪跑到 0xFFFFFFFE 是典型的启动文件异常。5.3 备份与恢复的良好习惯最后提一个很多人都忽视的习惯IAR 工程配置文件.eww和.ewp一定要纳入版本管理。.ewp里记录了所有源文件、编译器选项和调试器配置。如果没纳入 Git某天 IDE 配置乱了或者换了新电脑恢复工程配置会非常痛苦。许可证文件则不建议放进代码仓库它绑定的是当前电脑且属于敏感凭据。不过当你重装系统或者换 PC 时要在本地目录保留一份备份。我一般是把.lic文件存一份在D:\IAR_License再存一份在个人网盘防止许可证文件被误删之后还要走官方流程重新拉取。还有一个关于升级版本的建议从旧版本升级到 9.40 时很多网友发现工程里 if 条件编译、预处理宏在老版本能用、新版本报错这多半是编译器更新后对某些旧语法不再支持。解决办法是先不要直接冲新版本先把工程在旧版本下做一次全量源码备份然后在新版本下逐个解决告警。新版 IAR 也支持Project - Options - C/C Compiler - Language里选择旧的 C 标准比如 C99 或者 C89这能缓解一批老代码移植过来的报错。5.4 我自己踩过的一个隐蔽坑有一次我在 IAR 9.40 里编译一个比较老的 STM32F103 工程始终提示某个外设寄存器未定义。这个芯片的寄存器定义头文件里明明有两个不同的版本一个和 CMSIS 配套另外一个来自某第三方库两者定义了名字相同的宏但值不一样。IAR 在两者都存在的 include 路径里默认取了其中一个导致外设初始化始终有问题。排查了很久最后发现是 include 路径顺序问题。IAR 处理 include 路径按写在 Preprocessor 里的先后顺序来靠前的路径优先。所以我现在的习惯是把官方 CMSIS 路径放在所有第三方库之前确保编译时优先引用官方头文件。这个问题在 Keil 里一般比较隐蔽因为 Keil 对头文件的搜索顺序和 IAR 不尽相同。如果你也遇到“同一个文件不同 IDE 下编译结果不一样”的情况优先查头文件搜索顺序。6. 写在最后的个人体会IAR 9.40 用下来我的整体感觉是新版本确实比 8.x 更干净、更快尤其是工程启动速度和调试时的寄存器查看体验。许可证比以前严格但熟悉了 IAR License Manager 之后这不算什么大问题。作为从业者我建议别在“注册工具”上花太多时间和精力正版许可是值得投入的。用官方的注册流程、官方许可证管理器配合这篇文章里的排查思路大部分人的问题能在十分钟内解决。另外要提醒一点IAR 是商业软件如果你在开源项目、非商业学习场景中使用建议去官网申请社区版或评估版这样既合法又能用全部核心功能。在公司环境中团体购买浮动许可证非常划算而且有技术支持遇到疑难杂症能直接求助原厂比自己折腾快得多。做嵌入式开发讲究的永远是“稳定压倒一切”。把开发环境打磨好、许可证配好、常用工程建好剩下时间集中精力解决业务逻辑和硬件设计上的问题这才是一个高效嵌入式工程师该有的工作方式。遇到问题的时候别急着卸载重装静下心来看一眼错误码查一查许可证状态很多坑就只是窗户纸而已。
IAR 9.40 许可证注册与调试烧录全攻略
做嵌入式开发这些年IAR 这个名字基本绕不开。尤其做 STM32、STM8 或者 8051 系列单片机的朋友很多人第一套开发环境就是 IAR Embedded Workbench。早些年用 IAR 8.x 的挺多后来 IAR 9.x 出来以后界面、编译器、调试器都换了一轮。最近不少人在问 IAR 9.40还有一类搜索词特别有意思——“注册工具”。我猜要么是装完以后弹出fatal error[lms001]: license check failed. use the iar license manager to re这条错误要么是许可证那块搞不太明白想找个“注册工具”把激活流程理顺。这篇就把新版 IAR 9.40 和它的许可证注册机制掰开揉碎讲一遍从安装到配置从许可证管理到调试烧录最后把常见的报错和排查经验也整理成速查表。想在新版本上做 STM32、STM8、8051、RISC-V 开发的人或者之前被许可证问题卡住的人这篇应该能帮你省不少时间。1. 新版本概览与核心定位1.1 IAR 9.40到底是什么IAR Embedded Workbench for ARM 是 IAR Systems 出品的集成开发环境rtthread、FreeRTOS 这些实时操作系统在 ARM 平台做移植时经常遇到它。9.40 是 2022 年到 2023 年间发布的较新大版本比起早期 9.x 系列它的内核编译器、运行时库和调试器都有不少更新。很多人一听到“最新版IAR”可能下意识觉得要重新学一套工具链其实核心操作逻辑没变新建工程、写代码、编译、下载、调试这套流程和 8.x 仍然一致只是新版本在芯片支持、编译优化、IDE 交互和许可证机制上做了调整。IAR 和 Keil 是嵌入式开发里最常见的两条路线。Keil 上手直观IAR 在代码体积优化和编译速度上常常更有优势。我个人的使用感受是IAR 9.40 对 C99 和 C11 的支持更干净编译告警给得比老版本更准调试时看变量、看调用栈也顺手。实际做项目时尤其是在做 FreeRTOS 移植、处理启动文件、优化 flash 占用这些场景下IAR 的友好度确实不低。1.2 这个版本解决了什么问题对大多数用户来说升级到 IAR 9.40 最直接的收益是这几块芯片支持范围更广新的 STM32G0、STM32L4、STM32H7 系列、GD32 系列都能在新版本里找到完整器件支持。编译器对 C11 原子操作、内联汇编、字节对齐处理更细腻代码优化等级提升后编译出的固件体积经常比旧版本小 2% 到 5%。IDE 的许可证管理器IAR License Manager做得更加清晰遇到许可证问题不再像以前那样黑箱。调试探针支持更全ST-Link、J-Link、I-jet 这些常见调试器在新版本下识别速度和稳定性都有提升。不过新版本也带来了“新问题”许可证检查和激活流程变得更严格很多人装完以后启动编译直接弹fatal error[lms001]license check failed。这个错误是 9.x 版本里出现频率最高的许可证报错根本不是代码问题纯粹是许可证没有正确注册。理解这一点很多新手就不慌了。1.3 哪些人适合用这个版本现在用 IAR 的人群大概分三类。第一类是学校教学和企业项目里的 STM32/STM8 开发者这些人是 IAR 的老用户从 8.x 升到 9.40 最顺畅。第二类是以前用 Keil但因为工程共编、代码移植、调试效率等原因想尝试切到 IAR 的开发者。第三类是做 8051 系列或者 RISC-V 的嵌入式工程师IAR 对这类小众芯片的支持比很多免费 IDE 都完整。这三类人看这篇文章都有实际好处第一类能解决升级后的许可证和报错问题第二类能搞明白 IAR 工程结构、启动文件、烧录配置这些关键差异第三类可以快速掌握多架构开发环境下 IAR 的使用套路。这篇博文不是官方文档的翻译更像是我实际使用新版本时记录下来的踩坑笔记和操作流程。2. 安装部署与工程初建实操2.1 安装前的准备清单安装 IAR 9.40 之前有几点如果没处理好很容易装到一半就失败或者装完以后启动出现奇怪缺库问题。系统要求IAR 官方说的是 Windows 10/11 64 位。实测在 Windows 7 下也能勉强跑但非常不建议新版自带调试服务对新系统依赖明显老系统上经常出现找不到 DLL 的情况。磁盘空间与路径整个安装包解压后大约 3-5GB编译大型工程时临时文件也不少。最关键的一点安装路径和工程路径尽量不要出现中文和空格。比如D:\project\stm32_测试这种路径在 IAR 的 GCC 后端编译时偶尔会出现查找路径异常换成全英文的工程目录会省掉很多麻烦。运行库依赖IDE 本身依赖 VC 2015-2022 运行库。很多机器装完 IAR 后一打开就报缺少vcruntime140.dll就是因为系统里没有这个运行库。建议先装一遍最新版 Visual C Redistributable再装 IAR。安全软件安装过程中 IAR 会往系统盘的注册表和公共目录写入许可证相关文件部分杀毒软件会拦截。遇到安装卡住或者提示License Manager start failed先把实时防护临时关掉装完再开启这一步能解决一半的安装失败问题。2.2 常规安装步骤IAR 9.40 的安装界面和 8.x 差别不大流程本身不复杂但有几个选项容易选错。第一步运行下载好的安装程序或者通过官方离线安装包安装。如果你用的是评估版安装时会要求填写邮箱和试用订阅评估期一般是 30 天。要注意的是评估版和正式版装的都是同一个 IDE区别只在许可证类型。第二步选择安装的架构支持。IAR 9.40 的安装器会列出一堆可选组件比如 ARM、RISC-V、8051、STM8实际上 9.40 分不同的产品线安装包每个产品线对应一种内核架构。下载的时候要确定自己用的 ARM 版还是 RISC-V 版别下错。安装器里的组件选择主要影响的是 CMSIS 包、芯片支持包和调试探针驱动。第三步安装许可证管理组件。这一步很多人会跳过但实际上 IAR License Manager 是整个许可证激活和管理的核心工具后续处理lms001报错全靠它。安装时把IAR License Manager和IAR License Server Tools都选上不会吃亏。第四步安装完成后进行许可证激活。这一步我们放到第三个大章节详细说。2.3 新建工程的正确姿势打开 IAR 9.40点击Project - Create New Project选择Empty project。没有工程模板的时候很多人会直接去网上拷贝一个模板工程这当然也可以但新手很容易因为工程配置和芯片不匹配导致编译失败。新建工程要注意几个关键配置Device 选择。IAR 的开发流程是“先选芯片再写代码”在Project - Options - General Options - Target里选择具体芯片型号比如 STM32F103C8T6选好之后IAR 会自带对应芯片的链接配置文件.icf不需要自己写链接脚本这是比 Keil 省心的地方。芯片选错或者不选的话编译时经常出现无法找到器件头文件、链接报内存越界。比如 64KB flash 的 STM32F103C8 如果错选成 128KB 的 STM32F103CB程序经常正常编译但烧录后跑飞此类问题排查起来会非常痛苦。编译优化等级。9.40 默认的优化等级是Balanced平衡型如果不熟悉编译器优化带来的问题调试阶段建议先把优化等级调到None或者Low否则代码单步调试时经常出现变量被优化掉、断点不触发的情况。输出 hex 文件。默认编译结果可能是 elf 和调试文件但做生产烧录一般要 hex 文件。在Project - Options - Output Converter里勾选Generate additional output格式选Intel extended hex这样编译后会多一个 hex 文件直接用 ST-LINK Utility 或者 STM32CubeProgrammer 都能烧写。2.4 启动文件与基础工程结构IAR 的工程模板里默认不会自动为你去写 startup 文件。STM32 系列在 IAR 9.40 里可以通过添加设备支持包的方式把启动文件、系统初始化文件自动带进来但很多人用旧习惯还是会自己复制启动文件。实际操作里启动文件的作用非常大。startup_stm32f103xb.s这个文件负责建立中断向量表、初始化栈指针、调用SystemInit然后跳到__iar_program_start如果漏了这个文件或者启动文件版本不匹配程序烧进去完全没有反应调试的时候 PC 指针直接跑飞。在 IAR 工程里检查启动文件有没有被有效加入看编译日志就行。9.40 编译时如果提示Error[Lp011]: section placement failed多半就是启动文件、链接配置文件或者芯片型号三者之间不匹配。以 STM32F103C8T6 为例一个能跑的最小工程至少要有这几个部分主程序文件 main.c启动文件 startup_stm32f103xb.s系统初始化文件 system_stm32f103xb.c 或类似文件链接配置文件比如 stm32f103xb_flash.icf芯片寄存器定义头文件来自 CMSIS 或芯片支持包我在实际建工程的时候会把.icf文件单独放在工程目录下不要修改它除非确实有特殊内存分配需求。比如某些芯片需要把一部分程序放在 RAM 里运行那就需要修改 icf 里的执行域配置但这已经是进阶玩法新手不建议动。3. 许可证注册机制与 IAR License Manager 解析3.1 许可证类型与注册工具的关系说到“注册工具”要先厘清一个概念IAR 许可证注册和管理是基于 IAR License Manager 这个官方工具的。9.40 版本安装后桌面上有个独立的IAR License Manager快捷方式这就是处理许可证的核心入口。在 IAR 的体系里许可证主要分为三类评估版许可Evaluation License安装后自动获得有效期通常是 30 天功能完备但到期后必须激活或者卸载。很多人说“IAR 能免费试用”用的就是这个。节点锁定许可Node-Locked License绑定当前电脑以一个 license 文件方式存在用户把官网下载的许可文件通过 License Manager 导入即可。浮动许可Floating License装在局域网内一台服务器上客户端通过网络来获取许可资源。适合公司团队多人共用许可的场景IAR License Server Tools 就是干这个的。网上经常有人搜索“注册工具”实际想解决的就是两件事一是导入正版 license 文件二是重置/刷新许可证状态。这两件事在官方工具里都能合法完成。可能也有人想找那种生成许可证的工具但这属于违反软件许可协议的行为我不建议尝试一是风险太大开发环境弹窗报错、公司合规审查二是正版许可证在官网申请价格并不算离谱尤其公司批量采购更便宜。用盗版工具导致的系统不稳定和后续移植问题反而更浪费项目时间。3.2 LMS001 报错的来龙去脉很多人在搜索引擎里输入 “fatal error[lms001]: license check failed. use the iar license manager to re...”这个错误在 9.40 中非常典型。它的大白话含义就是编译前检查许可证发现当前机器上没有任何有效的许可或者许可服务停了所以编译器拒绝继续工作。可能的原因如下评估版到期了许可证文件还在但已经过期编译时自然报错。许可证文件被误删了。很多人装完 IAR 之后喜欢清系统临时文件结果把许可证缓存文件给清了。系统时间被改动。IAR 的许可证对系统时钟非常敏感时间回拨或者跳变都会导致校验失败。使用浮动许可证时许可证服务器地址写错、服务没启动或者网络断开了。杀毒软件把许可证文件或缓冲文件隔离了。排查流程建议按照“由简到难”来先打开 IAR License Manager看许可证列表里有没有当前许可证状态是 valid 还是 expired。如果是 expired直接把旧的许可证移除重新导入一遍很多时候问题就解决了。如果没有许可证就检查自己用的到底是评估版还是正式版评估版过期后就只能重新激活或者换正式许可证。3.3 用 IAR License Manager 完成注册具体操作流程如下打开IAR License Manager主界面会显示当前安装的 IAR 版本和许可证状态。不显示许可证时点击左侧License菜单选择Add License会弹出三个选项License file、Activation code、Online license。最常用的方式就是License file——选择你从官方渠道获得的.lic许可文件确认导入许可证状态变成Valid即可。如果公司用的浮动许可证那么要选择Add License Server在里面填上许可证服务器的 IP 地址和端口IAR 默认使用 46.46 端口实际是 58000 系列端口具体看服务器端配置。填完后点 Check如果能看到许可证数量和使用情况说明网络和配置都没问题。注册完成后建议把 IAR License Manager 也做一次刷新。命令行进入 IAR 安装目录执行LMTool.exe refresh会有帮助不过大多数时候界面操作已经够了。回到 IAR 主界面重新编译那个工程LMS001报错通常会消失。3.4 关于许可证踩坑的几点心得第一IAR 9.40 的许可证文件和用户机器是绑定的换电脑、换网卡、甚至系统重装许可证都不一定还能用需要去官网申请重新激活或者转移。这块流程各不一样最好的做法是装好 IAR 后立刻把许可证文件备份到一个不会被杀软清掉的目录。第二不要在装好 IAR 的第一时间修改系统时间。很多工程为了测试日历功能会把系统时间调到很久以前或者很久以后。如果是在许可证检查之后才调的那没事但如果是先调了时间再打开 IAR许可证校验极有可能直接失败。遇到这种情况把时间改回来然后进 License Manager 点一次Repair或重新 refresh 许可证状态即可。第三许可证状态的检查是发生在编译阶段不是启动阶段。所以很多人装完 IAR 都正常打开了界面一直到按 F7 编译才报 LMS001。这给了很多人错觉以为是代码有问题其实是许可证问题。3.5 许可证管理工具的进阶玩法IAR 9.40 的 License Manager 还提供命令行工具正常情况下不用它但如果公司要做批量部署命令行工具反而很实用。比如把许可证文件提前放在某个共享目录通过命令行参数LMTool.exe import自动导入可以做到员工点一下脚本就能完成环境配置。此外IAR 9.40 因为许可证机制更新比较频繁某些老教程里写的lanman或早期工具已经不可用网上搜到的各种所谓“注册工具”也大多是过时信息。记住一点IAR 官方的工具链本身已经包含了许可证注册功能外部工具既不稳定也不安全遇到报错优先用官方 License Manager 解决。3.6 许可证过期后的正解评估版到期是最常见的情况。很多人试用 30 天后突然编译不了第一反应是找“注册工具”续命其实有两个正规途径一是找官方申请延长评估期部分评估授权申请后能再获得 30 天使用期二是直接购买正式授权。正式授权也分年费和永久授权做个人项目用年费版足够。这里还想多说一句IAR 的许可证机制比 Keil 严格但它的本意是服务商业项目对个人学习和开源项目支持也很多。很多芯片原厂会提供定制的 IAR 许可证或者特别的评估授权比如某些开发板厂商会随板子附送一张激活卡大家在买开发板时留意一下赠品有时候能省下一笔费用。4. 调试、烧录与多架构开发经验补全4.1 从编译到烧录的完整链路编译通过之后就是烧录。IAR 9.40 通过Project - Download and Debug或直接按 CtrlD 进入调试模式同时完成程序的下载并启动调试器。也可以选择Project - Download - Download Active Application只下载不调试速度更快。调试器配置在Project - Options - Debugger里默认驱动类型分几类ST-LINK、J-LINK/J-Trace、I-jet、CMSIS-DAP等。使用 STM32 开发板时最常见的就是板载 ST-LINK。选择 ST-LINK 后还要在Debugger - ST-LINK里确认接口方式STM32 新板子基本都是 SWD 口四根线搞定连接稳定不会像 JTAG 那样占太多引脚。SWD 模式下常见的失败原因是接线松动、目标板供电不足排查时优先看 IAR 的Error[31]: Failed to initialize communication这类报错大意就是调试器和目标芯片没建立通讯。烧录配置方面IAR 有 Flash 下载算法不需要像老版本那样手动配置外部烧录器软件。正常情况下勾选了 Download 动作调试器就会自动执行擦除、写入、校验这些流程。如果遇到芯片擦除失败可以回退到Debugger - Download页面把Use flash loader(s)勾上并选择一个合适的 flash loader。STM32F1 系列的 loader 是出厂自带的任何异常基本都是接线问题或者芯片锁死。4.2 SWO 调试的正确使用方法热词里有一条iar的swo怎么使用这个问的人特别多。SWOSingle Wire Output是 ARM Cortex-M 内核提供的一个单引脚调试输出接口在实时性要求高、没法断点看变量的场合格外好用。IAR 里启用 SWO 的步骤如下在Project - Options - Debugger里选择 ST-LINK 或 J-Link进入对应调试器设置页面把SWO或Serial Wire Viewer功能启用确保调试器引脚配置里 SWO 引脚没被禁用。在代码里调用ITM_SendChar()往 ITM 寄存器写字符相当于用 SWO 输出一条调试日志到 IDE 的 Terminal 窗口。运行时IAR 的View - Terminal I/O里能实时看到打印内容。很多人试 SWO 失败是因为目标芯片的 SWO 引脚被复用了。比如 STM32F103 的 PB3 默认是 JTDO/SWO 功能但如果初始化代码里把它配置成普通 GPIOSWO 就不会工作。遇到这种问题先把初始化代码里和 PB3 相关的复用配置注释掉再试。SWO 相比串口 println 的好处是并不占用 UART 外设调试信息走的是 SWD 里面那根独立线对性能影响很小。缺点是需要调试器支持ST-LINK V2 和 J-Link 都能用但 CMSIS-DAP 的兼容性一般。实际项目里我习惯把错误信息用 SWO 输出正常日志用串口输出两边互不干扰排查问题十分方便。4.3 在 IAR 9.40 下移植 FreeRTOS移植 FreeRTOS 时IAR 9.40 和 Keil 的逻辑差别很大。FreeRTOS 官方仓库里其实有 IAR 工程模板而且专门适配过直接用会省很多事。以 STM32F103C8T6 为例在 IAR 里移植的要点如下把 FreeRTOS 源码里的FreeRTOS/Source目录和FreeRTOS/Source/portable/IAR/ARM_CM3目录加入工程。对于 STM32F103 这类 Cortex-M3 内核用的是 IAR 里ARM_CM3这个移植层。把 FreeRTOSConfig.h 配置文件拷贝到工程目录这个文件里面最重要几个宏是configCPU_CLOCK_HZ时钟频率通常配置为 72MHz和configTICK_RATE_HZ时钟节拍一般 1000。配置错误通常会导致系统 tick 慢很多或快很多。中断优先级分组必须设置为NVIC_PriorityGroup_4即全部抢占优先级没有子优先级。FreeRTOS 的临界区代码依赖这一点设置不对时会导致调度异常比如任务不切换卡死或者系统进 HardFault。烧录和调试时IAR 和 FreeRTOS 调试插件可以配合使用但直接在 FreeRTOS 列表窗口看任务状态需要装插件IAR 9.40 的插件管理页里可以搜索FreeRTOS插件安装。不装插件也能调试只是看任务运行状态很麻烦。移植时最常见的错误是Error[Pe020]: identifier configUSE_PREEMPTION is undefined这个纯属 FreeRTOSConfig.h 没加进编译路径。检查Project - Options - C/C Compiler - Preprocessor的 include 路径把 FreeRTOS 根目录和配置目录加进去就行。另外一个常见坑直接拿 Keil 的工程目录结构往 IAR 里拖由于启动文件格式不同Keil 用的是 ARMCC 汇编IAR 用的是IAR格式汇编编译不过。一定要使用 IAR 自己的启动文件和 FreeRTOS portable 文件不要混用。4.4 IAR 的插件机制与 GD 系列支持IAR 9.40 的插件系统经常被忽略但实际非常有用。Project - Options - Building - Build Actions可以在编译前后执行自定义命令。这个功能我经常用来做编译后自动生成 bin 文件或者调用脚本做固件签名。IAR 还支持插件式调试器在Tools - Configure Tools里能添加外部工具。很多人搜iar plugins 是干什么的其实就是这些扩展工具链入口。例如用脚本批量修改固件版本号、调用静态检查工具、甚至把编译结果自动上传到服务器都能用这个机制集成。对于 GD32 系列单片机IAR 9.40 需要单独安装 GD32 的 Support Pack 或者iar gd addon。GD32F103 和 STM32F103 的寄存器基本兼容但 flash 配置、USB 控制器配置有差异IAR 专门做了一个 Addon 来补齐这些差异如果不装编译虽然可能通过但运行会有极其隐蔽的问题比如 USB 枚举失败、flash 操作异常。直接在 IAR 官网的下载页面搜索GD32就能找到对应 Addon安装之后在工程配置里把 device 设置成 GD32F103xx编译器会自动使用正确的外设定义和链接文件。4.5 IAR 下的 8051 与 STM8 开发IAR 并不只有 ARM 版也有IAR Embedded Workbench for 8051和IAR for STM8。早期很多人用 Keil C51 做 8051 开发但如果想用 IAR 生态统一开发要注意 8051 版本和 ARM 版本是独立安装、独立许可证的。装了 ARM 版不代表能编译 8051同理这不通用。8051 版本的使用习惯和 ARM 版很不一样。8051 产品的程序空间小、内存模型复杂IAR 的 8051 编译器对data、idata、xdata这些内存空间的关键字支持很细变量放哪个区直接关系到编译是否报错和运行是否稳定。IAR 9.40 版本对 8051 的存储区配置比旧版友好但新手如果遇到Error[Pe178]: this declaration has no storage class or type这类错误通常是xdata这类关键字没有在编译器设置里打开相应扩展。在Project - Options - C/C Compiler - Language里把Allow IAR extensions勾上能解决大部分和存储区相关的问题。如果你同时在用 STM8 和 8051建议把两个版本都装上。STM8 版在 IAR 里的工程配置和 ARM 版的流程很像基本能一键切过来只是芯片选择不同。4.6 命令行编译与自动化构建压轴部分说一下 IAR 9.40 的命令行工具。很多人以为 IAR 只能通过 IDE 编译其实项目如果比较大的话用命令行可以集成到 CI/CD 流水线里。IAR 安装目录下有个IarBuild.exe执行方式大致是IarBuild.exe project.ewp -build Release这条命令会在后台调用编译器、链接器、输出 hex 文件整个流程和 IDE 内手动构建完全一致只是没有界面。配合IarTools还可以实现固件打包自动上传。我自己做项目时常常保留一个.bat或者 CI 脚本每天上班第一件事双击一下就能拿到最新固件省去打开 IDE、等待加载、手动点击构建的流程。特别是团队里做持续集成时IAR 的命令行模式很有价值。新手如果只用 IDE也可以先在 IAR 的Tools - Configure Tools里把命令行工具添加成菜单项后面做固件签名、批量编译多个变体工程时效率提升很明显。5. 常见问题速查与避坑记录下面整理一个速查表绝大部分我在开发中至少遇到过一次这些问题在 9.40 版本里依然高发错误/现象常见原因解决思路fatal error[lms001]: license check failed评估版过期、许可证文件丢失、系统时间异常、浮动服务器不可达打开 IAR License Manager重新导入或刷新许可证检查许可证状态Error[Lp011]: section placement failed工程内存分配超过芯片实际容量或者启动文件/链接文件和芯片型号不匹配核对芯片型号、启动文件和 .icf 文件是否匹配调整堆栈大小Error[Pe020]: identifier ... is undefinedinclude 路径没配好头文件缺失在Project - Options - C/C Compiler - Preprocessor添加正确的 include 路径下载时提示无法连接调试器ST-LINK/J-Link 驱动问题、接线松动、目标板供电不足、芯片锁死重装调试器驱动检查 SWD 四线连接按住复位键重试芯片锁死就用全擦除恢复程序运行乱跑单步直接跑飞启动文件不对、优化等级过高、栈溢出、中断优先级配置错误先确认启动文件正常优化等级调到 Low/None检查 FreeRTOS 配置和中断分组无法生成 hex 文件Output Converter 未开启在Project - Options - Output Converter勾选 Generate additional output选择 hex 格式编译时找不到 CMSIS 头文件设备支持包没装或者路径没配置在官网下载对应的 Device Support Pack装好后重新打开工程SWO 无输出SWO 引脚被复用、调试器 SWO 使能被关闭检查初始化代码里 PB3 等引脚配置确认调试器配置里已开启 SWO5.1 排查 LMS001 的完整步骤很多人一遇到lms001就胡乱重装软件结果重装以后问题还在因为许可证文件没变。我建议按这个顺序排查打开 IAR License Manager看当前许可证状态。只有Valid才是正常显示Expired或No license就把旧的许可证删掉重导。确认许可证文件路径没有被中文或空格干扰。个别情况下许可证文件在中文路径下会识别失败建议放在C:\IAR_License\这种纯英文路径。使用浮动许可证的检查许可证服务器服务是否启动防火墙是否放行对应端口。可以在命令行用ping和telnet检查服务器连通性。查看本地系统时间。如果时间差超过 12 小时IAR 许可证基本必挂。调整时间后重新打开 IAR必要时重开 License Manager。如果以上都正常尝试在 IAR License Manager 里执行Refresh或重新导入许可文件。有时候许可证只是缓存失效刷新一下就好。整个排查流程一般 5 分钟以内能完成比卸载重装高效得多。5.2 移植和编译的常见避坑这些事情没写进官方文档里但实战中很容易遇到。不要在工程目录里用中文路径不要在源文件名里放中文。IAR 命令行工具对非 ASCII 路径兼容不太好IDE 里能编译一到自动化构建就报错非常坑。优化等级从高调到低时一定要全量重新编译一次不要用增量编译。有些旧版本生成的中间文件在新优化等级下无法正确对应会出现变量值不对、程序卡死的灵异现象。按 F7 前先Project - Clean一下更稳妥。如果从 Keil 工程迁移到 IAR不要直接复制.uvprojx工程文件也没有直接转换工具。正确做法是新建 IAR 工程然后把源文件、头文件、启动文件重新添加进去。FreeRTOS 这类 RTOS 在 IAR 下的中断服务函数必须带有__ramfunc不需要。但要注意 IAR 对中断向量写法要求比较严格直接写void SysTick_Handler(void)就行不要在函数名前加特殊前缀IAR 会通过中断向量表自动完成链接。能正常编译但不运行八成是启动文件问题或者链接文件内存分配问题先在调试状态下看 PC 指针跑到哪跑到 0xFFFFFFFE 是典型的启动文件异常。5.3 备份与恢复的良好习惯最后提一个很多人都忽视的习惯IAR 工程配置文件.eww和.ewp一定要纳入版本管理。.ewp里记录了所有源文件、编译器选项和调试器配置。如果没纳入 Git某天 IDE 配置乱了或者换了新电脑恢复工程配置会非常痛苦。许可证文件则不建议放进代码仓库它绑定的是当前电脑且属于敏感凭据。不过当你重装系统或者换 PC 时要在本地目录保留一份备份。我一般是把.lic文件存一份在D:\IAR_License再存一份在个人网盘防止许可证文件被误删之后还要走官方流程重新拉取。还有一个关于升级版本的建议从旧版本升级到 9.40 时很多网友发现工程里 if 条件编译、预处理宏在老版本能用、新版本报错这多半是编译器更新后对某些旧语法不再支持。解决办法是先不要直接冲新版本先把工程在旧版本下做一次全量源码备份然后在新版本下逐个解决告警。新版 IAR 也支持Project - Options - C/C Compiler - Language里选择旧的 C 标准比如 C99 或者 C89这能缓解一批老代码移植过来的报错。5.4 我自己踩过的一个隐蔽坑有一次我在 IAR 9.40 里编译一个比较老的 STM32F103 工程始终提示某个外设寄存器未定义。这个芯片的寄存器定义头文件里明明有两个不同的版本一个和 CMSIS 配套另外一个来自某第三方库两者定义了名字相同的宏但值不一样。IAR 在两者都存在的 include 路径里默认取了其中一个导致外设初始化始终有问题。排查了很久最后发现是 include 路径顺序问题。IAR 处理 include 路径按写在 Preprocessor 里的先后顺序来靠前的路径优先。所以我现在的习惯是把官方 CMSIS 路径放在所有第三方库之前确保编译时优先引用官方头文件。这个问题在 Keil 里一般比较隐蔽因为 Keil 对头文件的搜索顺序和 IAR 不尽相同。如果你也遇到“同一个文件不同 IDE 下编译结果不一样”的情况优先查头文件搜索顺序。6. 写在最后的个人体会IAR 9.40 用下来我的整体感觉是新版本确实比 8.x 更干净、更快尤其是工程启动速度和调试时的寄存器查看体验。许可证比以前严格但熟悉了 IAR License Manager 之后这不算什么大问题。作为从业者我建议别在“注册工具”上花太多时间和精力正版许可是值得投入的。用官方的注册流程、官方许可证管理器配合这篇文章里的排查思路大部分人的问题能在十分钟内解决。另外要提醒一点IAR 是商业软件如果你在开源项目、非商业学习场景中使用建议去官网申请社区版或评估版这样既合法又能用全部核心功能。在公司环境中团体购买浮动许可证非常划算而且有技术支持遇到疑难杂症能直接求助原厂比自己折腾快得多。做嵌入式开发讲究的永远是“稳定压倒一切”。把开发环境打磨好、许可证配好、常用工程建好剩下时间集中精力解决业务逻辑和硬件设计上的问题这才是一个高效嵌入式工程师该有的工作方式。遇到问题的时候别急着卸载重装静下心来看一眼错误码查一查许可证状态很多坑就只是窗户纸而已。
