简介:这份《IAR 使用手册》面向使用 IAR EWARM 开发 NXP ARM MCU 的初学者、竞赛参赛者与嵌入式课程实验人员,解决工程从建立到调试的入门问题。内容按创建工程、添加源代码、配置工程选项、编译链接、下载调试五个环节组织,讲清工具链与空模板选择、头文件路径、优化级别、Flash 烧写格式、链接命令文件、调试器驱动、下载模式及 RDI 调试代理等配置,并结合 LPC2148 例程与 H-JTAG 调试环境说明。压缩包仅含 1 个 PPT,约 806KB,便于快速翻阅和课堂展示。已有 510 人学习,可作为 2007 年 NXP 中国 ARM MCU 大学设计竞赛参考材料,帮助读者梳理 EWARM 工程搭建流程与关键选项含义。
1. 一份 2007 年的 IAR 使用手册,为什么现在还有人翻
手上有一块 LPC2148 的老开发板,翻出一份 2007 年写的 IAR 使用手册,多数人第一反应是这玩意儿还能用吗。答案是能用,而且比新版文档更对口。v4.41A 那一代的工程模型是 .ewp + .eww + .xcl 三件套,跟现在的单文件工程和 icf 链接配置完全是两套东西,拿新文档去对照老工程,菜单路径一页都对不上。这份手册把「建工程、加文件、配选项、编译链接、下载调试」压成一条最短路径,每一步都对应一个具体的勾选项,适合手里有 ARM7 板子、需要把调试链路从零打通的人,也适合想搞清楚 IAR 工程文件谁管谁、链接脚本管什么的人。它不是教程,是一张地图。
2. 建工程与工具链选型:ARM、Empty project 与 .ewp/.eww 的分工
2.1 工具链下拉框选 ARM,模板必须选 Empty project
启动 IAR 之后第一件事是 Project → Create New Project,弹窗里两个下拉框决定后面所有事情。Tool chain 选 ARM,Project templates 选 Empty project。工具链选错是最隐蔽的一类错误:装了 ARM、AVR、MSP430 三套工具链的机器上,选成 AVR 之后打开工程,器件头文件全找不到,编译第一行就抛Fatal Error[Pe1696]: cannot open source file "LPC214x.h",看上去像路径配错,实际是编译器根本不是那一套。
模板这一栏更值得说。IAR 自带的 C main、asm main 之类模板会顺手塞进一个示例 main 和一份通用启动文件,新手容易觉得省事,但 LPC2148 这类芯片的启动文件不是通用的——向量表要按芯片的中断源数量排布,PLL 初始化要按外部晶振频率算 MAM 和 CCLK 分频,通用模板里的 cstartup 跑起来时钟是错的,现象是全速运行几秒后串口输出全是乱码。Empty project 把所有依赖摊开在明面上,缺什么补什么,虽然多花十分钟,但后面出问题能定位。
提示:模板选 Empty project 之后,工程里是空的,连启动文件都没有。这不是漏配,是设计如此,启动文件要自己从芯片对应的例程目录里拷。
2.2 目录怎么摆:源码、头文件、链接脚本各归各位
工程文件用.ewp后缀,保存时 IAR 会问文件名,手册里用的是LPC2148_Demo.ewp。这里有个容易混淆的点:.ewp是单个工程的配置,文件列表、编译选项、链接选项全在里面,XML 明文;.eww是 workspace,作用是把一个或多个.ewp聚合起来,同时记住当前激活的是哪个工程、Build 顺序是什么。一个 workspace 挂两个工程(比如一个 boot 一个 app)是常见做法,构建时按顺序执行。
老版本 IAR 的.ewp里存的是相对路径,基准目录就是.ewp文件所在目录。所以目录结构一旦定下来就别乱挪,挪了之后所有源文件的路径全断。我一般会这么摆:
lpc2148_demo/ ├── LPC2148_Demo.ewp # 工程文件,路径基准点 ├── LPC2148_Demo.eww # workspace,最后保存 ├── src/ # .c / .cpp ├── inc/ # .h ├── asm/ # .s79 汇编与启动文件 └── config/ ├── LPC2148_flash.xcl # Flash 版链接命令文件 └── LPC2148_RAM.xcl # RAM 版链接命令文件这样摆的好处是.xcl和源码分离,切换 RAM 调试和 Flash 调试时只改一个路径,不碰源文件。手册里把源文件直接复制到工程目录下,能跑通,但工程一大就乱。
2.3 用 IarBuild 把点击流程复现成一条命令
IDE 里点 Rebuild All 是最直观的,但要在一台没有图形界面的构建机上复现,就得走命令行。IAR 从很早就带了一个叫 IarBuild 的命令行构建器,参数不多,记住三个就够:-build全量重编,-make增量编译,-clean清理产物。下面这段脚本把工程路径、配置名、日志输出都参数化了:
#!/usr/bin/env bash # 用法: ./build.sh Debug 或 ./build.sh Release set -euo pipefail CONFIG="${1:-Debug}" # 安装根目录用环境变量传,避免把绝对路径写死在脚本里 IAR_ROOT="${IAR_ROOT:?请先设置 IAR_ROOT 指向 Embedded Workbench 4.0 安装目录}" IARBUILD="$IAR_ROOT/common/bin/IarBuild.exe" PROJ="$(pwd)/LPC2148_Demo.ewp" LOG="build_${CONFIG}.log" # -build: 全量重建;-make: 只编有改动的文件 "$IARBUILD" "$PROJ" -build "$CONFIG" 2>&1 | tee "$LOG" # 从日志里捞错误和警告条数,非零直接让脚本失败 grep -E "Error\[|Warning\[" "$LOG" | sort | uniq -c || true脚本里三个参数值得展开说。$1是配置名,对应 Options 里 General Options → Target 那一页的 Debug / Release,两个配置的优化级别、输出格式、链接脚本通常完全不同,所以必须显式传。IAR_ROOT用环境变量而不是硬编码,是因为不同机器的安装路径不一样,写死之后脚本一换机器就废。tee加grep的组合是为了在 CI 里能拿到退出码——IarBuild 自己会返回非零,但被管道吃掉,set -o pipefail就是防这个。
注意:
-build和-make的区别不只是快慢。-make依赖时间戳判断,如果从别处拷进来一个时间戳比目标文件还旧的源文件,它会跳过编译,现象是改了代码没生效。血泪经验是切分支之后先跑一次-clean再-build。
3. 源码与链接脚本:.xcl 内存布局、.s79 汇编与输出格式
3.1 LPC2148_flash.xcl 和 LPC2148_RAM.xcl 里到底写了什么
手册里在第 2 章和第 3 章两次提到.xcl文件,一次是让你从例程目录里拷到工程目录,一次是在 Options → Linker → Config 里指定。这两个动作是配套的,缺一不可。.xcl是 IAR 老版本的链接命令文件(Linker Command File),本质是一串给链接器的指令,告诉它代码段放哪、数据段放哪、栈顶在哪、中断向量表占多大。
以 LPC2148 为例,Flash 512KB 映射在0x00000000,片内 SRAM 32KB 映射在0x40000000。这两个地址是硬约束,写错了链接能过但程序跑不起来。文件里常见的行长这样:
// LPC2148_flash.xcl 关键行(结构示意,非厂商原文) -DROM_START=0x00000000 -DROM_END=0x0007FFFF -DRAM_START=0x40000000 -DRAM_END=0x40007FFF // 中断向量表固定在 Flash 起始处,占 64 字节 -Z(CODE)INTVEC=ROM_START-ROM_START+0x3F // 其余代码和常量依次排布 -Z(CODE)CODE=ROM_START+0x40-ROM_END -Z(CONST)CONST=ROM_START+0x40-ROM_END // 已初始化、未初始化、清零数据统一放 RAM -Z(DATA)DATA_I,DATA_Z,DATA_N=RAM_START-RAM_END-D开头的是宏定义,给后面引用;-Z开头的是段放置规则,括号里是段名,等号右边是地址区间。INTVEC单独拎出来占 0x40 字节,是因为 Cortex-M 之前的中断控制器要求向量表从 0 地址开始且连续,跳转指令和向量地址混排会跑飞。
RAM 版把ROM_START改到0x40000000,代码整体搬进 SRAM。这样做的好处是调试时下载快、断点几乎无限制,坏处是一断电全没,且可用空间只有 32KB,稍微大一点的程序链接就会报Error[Lp011]: section placement failed。
| 配置项 | Flash 版 | RAM 版 |
|---|---|---|
| 代码起始地址 | 0x00000000 | 0x40000000 |
| 可用代码空间 | 512KB | 约 32KB(与数据段共享) |
| 掉电保持 | 是 | 否 |
| 断点数量 | 受硬件断点限制 | 基本不受限 |
| 下载速度 | 慢(逐页擦写) | 快 |
3.2 添加源文件的顺序与 .s79 汇编文件
Project → Add Files 支持多选,一次把.c、.cpp、.s79全加进去。老版本 IAR 的 ARM 汇编后缀是.s79,.s79表示 ARM7/ARM9 指令集,早期还有.s26对应更老的核。文件加进去之后在 Workspace 树里按目录分组显示,顺序不影响链接结果,但影响可读性,我一般把启动文件放最上面。
启动文件 cstartup.s79 干三件事:定义中断向量表、初始化栈指针、跳到 main。它跟.xcl是强耦合的——向量表占了 0x40 字节,.xcl里的INTVEC段就必须正好覆盖这 0x40 字节,多一个字节少一个字节都会导致CODE段起始地址错位,最终现象是复位后第一条指令跳到野地址。
添加文件时有个细节容易漏:IAR 不会自动把文件所在目录加入头文件搜索路径。源文件加进去了能编译,但只要它#include了同目录下的.h,就会报找不到。
3.3 头文件包含路径与优化级别
Options → C/C++ Compiler → Preprocessor 里填 Additional include directories,一行一个,支持相对路径(相对.ewp)。工程小的时候用相对路径,工程大了跨机器协作用绝对路径反而更稳,因为相对路径一旦有人把目录结构改了,所有人都跟着挂。
优化级别在 Options → C/C++ Compiler → Optimizations。老版本的分档是 None / Low / Medium / High,High 下面再分偏向速度还是偏向体积。这一栏的选择直接决定调试体验:
| 级别 | 适用阶段 | 典型副作用 |
|---|---|---|
| None | 单步定位、查时序 | 代码体积最大,执行慢,变量全部可见 |
| Low | 日常开发 | 变量基本可见,个别局部变量被寄存器化 |
| Medium | 功能联调 | 函数可能被内联,断点位置漂移 |
| High (speed) | 发布 | 循环被展开,断点打不上 |
| High (size) | Flash 紧张 | 同上,且单步几乎不可用 |
调试阶段用 High 是最常见的翻车来源:明明代码里flag是 1,Watch 窗口里显示 0,因为编译器把它整个优化进寄存器了,内存里那个位置根本没写过。判断方法很简单,把优化关掉重编一次,现象消失就是优化问题,不是逻辑问题。
3.4 输出文件:simple-code、intel-extended 与那个必须勾上的复选框
Options → Linker → Output 这一页有两个开关决定最终产物形态。
第一个是 Format。选simple-code生成 IAR 私有格式,配合 C-SPY 的 flash loader 直接烧;选intel-extended生成标准 Intel HEX,给第三方烧写工具用。手册里写得很直白:下载到 RAM 调试可以跳过这一步;下载到 Flash 调试选 simple-code;要生成 hex 给别人烧,选 intel-extended 并手工把后缀改成.hex。
第二个是Allow C-SPY-specific extra output file。这个复选框不勾,除了主输出文件之外的.hex、.map一概不生成,现象是 Options 里明明勾了 Generate linker map file,目录里就是没有.map。很多人卡在这一步以为是路径写错。
注意:
.map文件是排查内存布局问题的唯一入口,不管发不发布都建议常开。它会列出每个段的起始地址、长度、以及 ROM/RAM 的总占用。
4. 调试链路:RDI Driver、H-JTAG 代理与 flash loader 的握手
4.1 为什么选 RDI 而不是 IAR 自带驱动
Options → Debugger → Setup → Driver 里那一长串下拉,选的是 C-SPY 跟硬件之间说话的协议。这一代 IAR 自带的驱动只覆盖少数几款仿真器,手上是 SuperJTAG 这类并口 Wiggler 兼容硬件的话,必须走 RDI。
RDI 全称 Remote Debug Interface,是一层中间规范:C-SPY 只认 RDI 接口,具体怎么产生 JTAG 时序由第三方代理负责。H-JTAG 就是那个代理,它对外暴露H-JTAG.dll,同时提供一个常驻的 Server 程序负责占住并口。链条是这样的:C-SPY → RDI 接口 → H-JTAG.dll → H-JTAG Server → 并口 → SuperJTAG 转接头 → 目标板 JTAG 排针。任何一环断了都连不上,报错信息还都长得差不多。
配置顺序不能反。先在 Debugger → Setup 里把 Driver 选成 RDI,然后在同一页的 RDI 子项里填H-JTAG.dll的完整路径。这个路径指向 H-JTAG 的安装目录,不是拷到 IAR 目录下——拷过去看似省事,升级 H-JTAG 之后两份 dll 版本不一致,会出现「能连上但下载到一半断开」这种玄学问题。
并口地址在 H-JTAG Server 里设,LPT1 通常是0x378,LPT2 是0x278。设错的现象是 Server 显示已启动,C-SPY 也能连上,但读芯片 ID 一直返回全 0。
4.2 RAM 调试与 Flash 调试的四个开关对照
这是整份手册里最容易配错的部分,因为四个开关分散在三个页面,少配一个都能编译通过,只是行为不对。把两组配置并排列出来对照着改,比来回翻页靠谱:
| 配置位置 | 选项名 | RAM 调试 | Flash 调试 |
|---|---|---|---|
| Linker → Config | Linker command file | LPC2148_RAM.xcl | LPC2148_flash.xcl |
| Debugger → Download | Use flash loader(s) | 不勾 | 勾选 |
| Linker → Output | Format | simple-code | simple-code 或 intel-extended |
| Debugger → Download | Verify download | 可不勾 | 建议勾选 |
Use flash loader(s)这个复选框的语义是「下载时通过一段运行在 RAM 里的小程序去擦写 Flash」。RAM 调试时程序本来就下载到 RAM,勾上它反而会让 C-SPY 试图去操作 Flash 控制器,轻则报超时,重则把本来要下载的段地址算错。
4.3 从 Download and Debug 到退出:一条完整的操作序列
配置齐了之后,实际操作只有几个快捷键,但顺序有讲究。
第一步,启动 H-JTAG Server,确认它识别到目标芯片 ID,而不是显示Not Connected。这一步在 IAR 之外,很多人忘了,直接在 IAR 里点下载,然后对着Failed to connect to target排查半小时。
第二步,Project → Rebuild All,看 Build 窗口最后一行是不是Total number of errors: 0。有 warning 可以先放过,有 error 必须清干净,因为链接失败的工程下载下去的是上一次的旧产物。
第三步,Ctrl+D 触发 Download and Debug。C-SPY 先复位目标,然后按.xcl里的段地址把 simple-code 格式的镜像逐段写入,Flash 模式下这一步会调用 flash loader 擦除整个扇区。
第四步,程序停在 main 的入口。此时可以下断点、开寄存器窗口、开 Memory 窗口按地址查看外设寄存器。LPC2148 的 GPIO 寄存器在0xE0028000附近,直接跳过去比读手册快。
第五步,调试结束用 Ctrl+Shift+D 退出。退出时 C-SPY 会问是否复位目标,选是,否则芯片停在断点处,下次上电行为跟预期不一致。
5. 避坑排查:编译过了、下载成功了、程序就是不跑的五种情形
5.1 编译链接阶段
现象一:改了代码,Rebuild 之后行为没变。
原因通常是增量编译的时间戳判断失效。从别处拷进来的源文件修改时间可能比目标文件还旧,-make直接跳过。另一种可能是工程里同时存在两份同名.c,一份在src/一份在根目录,IAR 按 Add Files 的顺序取先加进去的那个。
解决方法是先-clean再-build,然后在 Workspace 树里逐个核对文件路径。养成习惯:切分支、拉代码、换机器之后,第一次构建一律走全量。
现象二:Error[Lp011]: section placement failed,说明某段放不下。
原因分两种。选了 RAM 版.xcl但代码超过 32KB,是最常见的一种;另一种是.xcl里的ROM_END和芯片实际容量对不上,比如拿的是 256KB 版本的配置去链接 512KB 的芯片,反过来更糟,链接器认为放得下,实际写到不存在的地址。
解决方法是先看.map文件里各段的累计长度,再核对芯片型号后缀。LPC2148 的 Flash 是 512KB,如果 map 里CODE段已经到 0x0007A000,那就别再往里塞了。
5.2 下载握手阶段
现象三:C-SPY 报Failed to connect to target或一直读不到芯片 ID。
原因按概率排:H-JTAG Server 没启动;并口地址设成了0x278而机器上是 LPT1;目标板处于 ISP 模式——LPC2148 的 P0.14 在上电复位时被拉低会进入片内 bootloader,JTAG 直接不响应;并口被别的程序占用(老式打印机驱动、某些采集卡软件都会抢)。
解决方法是按这个顺序查:Server 界面有没有识别到 ID,没有就查线;有线但 IAR 连不上就查 dll 路径;都对就查 P0.14 电平,把跳线拔了再上电。
现象四:下载到 99% 卡住,然后超时。
Flash 调试时出现,多半是 flash loader 的时钟配置跟目标板实际晶振不匹配。loader 是跑在目标芯片上的,它靠内部 RC 或者外部晶振起振,晶振没起振它就跑不动。另一种可能是芯片被读保护了,擦除命令返回失败但界面只显示超时。
解决方法是先用第三方串口 ISP 工具全片擦除一次,确认芯片没锁;再检查目标板晶振是否真的在振(示波器看,别靠猜)。
5.3 运行阶段
现象五:下载成功,全速运行立刻进 HardFault 或者直接跑飞。
原因几乎总是链接脚本和实际下载方式不匹配:.xcl选了 RAM 版(代码起始 0x40000000),但Use flash loader(s)勾着,程序被烧进 Flash 的 0x00000000,复位后 CPU 从 0 地址取指,取到的却是空白 Flash 的 0xFFFFFFFF,译码成未定义指令。
解决方法是把 4.2 那张对照表逐行核一遍,尤其是链接脚本和 flash loader 这两个必须同进同退。核完还是跑飞,就看.map里INTVEC段的起始地址是不是0x00000000。
6. 进阶:把点击流程固化成脚本,加一份上电前的检查清单
手工点二十几次 Options 配一个工程,配第二块板子的时候还得重来一遍,这是最没必要的重复劳动。老版本 IAR 的.ewp是 XML 明文,可以直接复制改写;配合前面那个build.sh,把 Debug / Release 两套配置的差异做成两份.ewp模板,新工程从模板起,只改文件列表和.xcl路径。
更进一步,可以把「构建 + 产物校验」串成一步。下面的脚本在编译完成后检查 map 文件的段占用,超阈值直接失败:
#!/usr/bin/env bash # 在 build.sh 之后执行,校验内存占用是否超出芯片实际容量 set -euo pipefail MAP="$(find . -name '*.map' -newer LPC2148_Demo.ewp | head -n1)" [ -z "$MAP" ] && { echo "未找到 map,检查 Allow C-SPY-specific extra output file"; exit 1; } # 抓 ROM 与 RAM 的总占用,字段位置随 IAR 版本略有差异,用 grep 兜底 ROM_USED=$(grep -iE '^\s*[0-9]+\s+[0-9]+\s+.*readonly' "$MAP" | awk '{s+=$1} END{print s+0}') RAM_USED=$(grep -iE '^\s*[0-9]+\s+[0-9]+\s+.*readwrite' "$MAP" | awk '{s+=$1} END{print s+0}') ROM_LIMIT=$((512*1024)) RAM_LIMIT=$((32*1024)) echo "ROM: ${ROM_USED} / ${ROM_LIMIT} RAM: ${RAM_USED} / ${RAM_LIMIT}" [ "$ROM_USED" -gt "$ROM_LIMIT" ] && { echo "ROM 超限"; exit 1; } [ "$RAM_USED" -gt "$RAM_LIMIT" ] && { echo "RAM 超限"; exit 1; } exit 0find -newer用来定位本次构建产生的 map,避免拿到上一次的旧文件,这个坑我在多配置工程里踩过不止一次。两个grep的正则按 map 里段的读写属性筛,不同 IAR 版本的列顺序有差异,awk累加第一列是基于「长度列在最前」这个常见排布,如果对不上就打开 map 人工看一眼列头再改。
最后是一份上电前的检查清单,五条,照着过一遍能挡掉八成问题:
| 检查项 | 判据 |
|---|---|
| 链接脚本与下载方式一致 | RAM 版配不勾 flash loader,Flash 版配勾选 |
| 向量表落在 0 地址 | map 里 INTVEC 段起始为 0x00000000 |
| ROM/RAM 未越界 | 脚本输出的两个比值都小于 1 |
| H-JTAG Server 已识别芯片 ID | 不是 Not Connected |
| P0.14 未被拉低 | 上电时该引脚为高,否则进 ISP |
写这份东西的时候我把手上三块板子的配置全推翻重配了一遍,起因是有一次赶进度,RAM 版.xcl忘了换回 Flash 版,程序烧进去怎么都不跑,示波器、万用表、换芯片折腾了一下午,最后发现是链接脚本里一个地址。从那以后我每次切调试模式,都会先把 4.2 那张对照表从头到尾核一遍,核完再点下载。希望帮到你。
本文还有配套的精品资源,点击获取