一、IAR 的基本使用教程

1. IAR 颜色字体大小设置

1. 打开设置路径：点击顶部菜单栏 Tools → 选择 Options，打开 IDE 配置窗口。
2. 进入字体颜色设置界面：在弹出的 “IDE Options” 窗口中，双击展开 Editor 选项，然后点击 Colors and Fonts。
3. 字体基础设置：
   • 字体选择：推荐使用 Consolas 或 幼圆（代码显示清晰，支持等宽格式）。
   • 字体大小：建议设置为 12 号（兼顾显示范围与可读性，可根据屏幕分辨率调整）。
   • 默认字体初始状态：默认字体为 Courier New，大小为 9 号，需手动修改。
4. 语法颜色配置（单片机开发推荐方案）：

   语法元素（Syntax Element）	颜色（Color）	字体样式（Style）
   C Keyword（C 语言关键字）	蓝色（blue）	加粗（Bold）
   Strings（字符串）	深红色（Dark Red）	正常（Normal）
   Char（字符）	蓝色（blue）	正常（Normal）
   Preprocessor（预处理指令）	蓝色（blue）	正常（Normal）
   Number（数字）	红色（Red）	正常（Normal）
   C++ comment/Comment（注释）	绿色（Green）	斜体（Italic）
   其他元素	默认	默认

5. 保存设置：配置完成后，点击 确定 保存修改，返回编辑界面即可生效。

2. 其他设置（行号、文件编码）

1. 打开设置路径：同样通过 Tools → Options 进入 IDE 配置窗口。
2. 行号与编辑辅助设置：
   • 在 “IDE Options” 窗口中，直接选择 Editor 选项卡，找到以下配置项并勾选 / 设置：
     • Show line numbers：勾选，显示代码行号（便于定位代码位置，排查报错）。
     • Tab size：设置为 2 或 8（推荐 2，减少缩进占用空间，代码结构更紧凑）。
     • Auto indent：勾选，开启自动缩进（输入代码时自动对齐，符合编码规范）。
     • Show right margin：勾选，显示右边界线（默认列数为 80，避免代码行过长，符合代码规范）。
     • Remove trailing blanks：可选勾选，自动删除行尾多余空格（保持代码整洁）。
3. 文件编码设置：
   • 在 Editor 选项卡下，找到 File Encoding 区域。
   • 编码格式：选择 UTF-8（支持中文注释，避免乱码）。
   • 换行符（EOL characters）：选择 PC（适配 Windows 系统，兼容大多数开发环境）。
   • 自动检测编码：勾选 Auto-detect character encoding，适配不同来源的文件。
4. 保存设置：点击 确定 保存，所有配置即时生效。

3. 新建用户源文件和头文件模块并添加到工程

（1）新建文件

1. 新建文档：
   • 方式 1：点击顶部菜单栏 File → New File（或使用快捷键 Ctrl+N）。
   • 方式 2：直接点击工具栏中 “New File” 图标（文档 + 加号样式）。
2. 保存文件（需区分源文件与头文件）：
   • 源文件（.c）：使用快捷键 Ctrl+S 保存，命名格式为 “模块名.c”（示例：modename1.c），保存类型选择 “IDE Files (.c;.cpp;*.cc...)”。
   • 头文件（.h）：重复新建文件步骤，保存时命名格式为 “模块名.h”（示例：modename1.h），保存类型同上。
   • 保存路径：建议统一放在工程目录下（如 C:\work_now），便于工程管理。

（2）添加文件到工程

1. 选中工程目录：在左侧 “Workspace” 窗口中，找到目标工程（示例：TEST）下的 “Source Files” 或空白区域。
2. 添加.c 文件：右键点击空白处 → 选择 Add → Add Files，在弹出的文件选择窗口中，选中已保存的.c 文件（如 modename1.c），点击 打开 即可添加（头文件无需手动添加，通过.c 文件中的#include指令引用即可）。

（3）示例代码

• modename1.c（源文件，实现加减乘除功能）：

c

运行

#include "modename1.h"// 加法函数
float add(float a, float b)
{return (a + b);
}// 减法函数
float sub(float a, float b)
{return (a - b);
}// 乘法函数
float mul(float a, float b)
{return (a * b);
}// 除法函数
float div(float a, float b)
{return (a / b);
}

• modename1.h（头文件，声明函数接口）：

c

运行

#ifndef _MODENAME1_H_
#define _MODENAME1_H_// 加法函数声明（计算两个数的和）
float add(float a, float b);
// 减法函数声明（计算两个数的差）
float sub(float a, float b);
// 乘法函数声明（计算两个数的乘积）
float mul(float a, float b);
// 除法函数声明（计算两个数相除的商）
float div(float a, float b);#endif

• main.c（主函数文件，调用功能模块）：

c

运行

#include <stdio.h>
#include "modename1.h"int main()
{float c = 0;// 调用加法函数并打印结果c = add(2, 5);printf("add:%f", c);// 调用减法函数并打印结果c = sub(2, 5);printf("sub:%f", c);// 调用乘法函数并打印结果c = mul(2, 5);printf("mul:%f", c);// 调用除法函数并打印结果c = div(2, 5);printf("div:%f", c);return 0;
}

4. 编译输出可执行文件

1. 编译操作：在工程界面中，点击顶部工具栏的 Build 按钮（或使用快捷键，不同版本可能不同，默认通常为 F7），开始编译工程。
2. 编译结果检查：
   • 成功标志：编译完成后，在底部 “Messages” 窗口中显示 Done. 0 error(s), 0 warning(s)，表示无错误、无警告，编译通过。
   • 失败处理：若出现错误（error）或警告（warning），需根据提示定位代码问题（如语法错误、头文件未引用等），修改后重新编译。
3. 生成可执行文件：编译通过后，工程会在 “Output” 目录下生成可执行文件（示例：TEST.out），用于后续调试或下载到硬件。

5. 软件仿真单步调试

（1）选择调试方式

1. 打开调试配置：右键点击左侧工程目录空白处 → 选择 Options，进入工程选项窗口。
2. 配置调试驱动：
   • 在 “Options for node 'TEST'” 窗口中，选择 Debugger 选项卡。
   • 驱动选择（Driver）：
     • 软件仿真（C 语言学习 / 无硬件时）：选择 Simulator（无需硬件，直接在 IDE 中模拟运行）。
     • 硬件调试（STM32 开发时）：选择 ST-Link（需连接 ST-Link 调试器与单片机硬件）。
3. 保存配置：点击 OK 保存调试方式设置。

（2）启动调试与调试操作

1. 启动调试：点击顶部工具栏的 Download and Debug 按钮（绿色类似播放键图标，或使用快捷键 Ctrl+D），加载可执行文件并进入调试模式。
2. 调试工具栏图标功能（核心操作）：

   图标功能	作用描述
   单步运行（Step Over）	执行下一步代码，若语句包含函数，不进入函数内部（整体执行函数，适合快速跳转）。
   单步进入（Step Into）	执行下一步代码，若语句包含函数，进入函数内部逐行执行（适合排查函数内问题）。
   单步跳出（Step Out）	从当前函数内部跳出，回到函数调用处（函数调试完成后快速返回上层代码）。
   全速运行（Go）	从当前位置全速执行代码，若遇到断点则暂停（适合快速定位到目标代码段）。
   运行到光标处（Run to Cursor）	从当前位置执行到光标所在行，无需手动设置断点（临时定位高效）。
   重新调试（Restart Debug）	重新加载可执行文件，恢复到调试初始状态（修改代码后需重新调试时使用）。
   退出调试（Stop Debug）	结束调试模式，返回正常编辑界面。

3. 断点使用：在代码行号左侧空白处左键单击，会出现红色圆点（断点标记），代码执行到断点处会自动暂停，便于观察变量值与程序流程。

6. 自带终端打印

1. 调出终端窗口：进入调试模式后，点击顶部菜单栏 View → 选择 Terminal I/O，打开终端打印窗口（用于查看printf函数输出内容）。
2. 终端打印配置：
   • 缓冲区大小（Buffer size）：默认设置为 0（实时打印，无延迟）。
   • 控制码（Ctrl codes）：默认无需修改，保持默认配置即可。
3. 查看打印结果：
   1. 在代码中合适位置设置断点（如return 0;前一行），避免程序提前结束。
   2. 点击 全速运行 按钮，程序执行到断点处暂停，printf输出的内容（如add:7.000000、sub:-3.000000等）会显示在 “Terminal I/O” 窗口的 “Output” 区域。
4. 辅助调试窗口：调试时可同时打开以下窗口，辅助排查问题：
   • Watch：添加指定变量，实时查看变量值变化（如查看c的计算结果）。
   • Memory：查看内存地址对应的数值（底层硬件调试时常用）。
   • Call Stack：查看函数调用层级关系（排查函数调用顺序与嵌套问题）。

IAR 使用调试详解

文章标签：# 嵌入式 #IAR

一、IAR 功能介绍

1.1 File 文件菜单

文件菜单包含文件 / 工作空间的基础操作，编辑与调试模式下功能完全一致，核心操作及快捷键如下：

1.2 Edit 编辑菜单

编辑菜单主要用于代码编辑辅助操作，编辑与调试模式下功能一致，高频操作及快捷键如下：

1.3 View 视图菜单

视图菜单用于打开 / 关闭各类功能窗口，编辑模式与调试模式下窗口列表存在差异（调试模式新增调试相关窗口），核心窗口功能如下：

1.3.1 通用窗口（编辑 / 调试模式均有）

1.3.2 调试模式专属窗口

1.4 Project 工程菜单

工程菜单针对工程管理与编译调试，编辑与调试模式下功能略有差异，核心操作及快捷键如下：

1.5 Debug 调试菜单

调试菜单仅在调试模式下显示，包含核心调试控制操作，高频功能及快捷键如下：

1.6 Disassembly 反汇编菜单

反汇编菜单用于配置反汇编代码的显示模式，共 4 种模式，默认选择自动模式即可满足大部分需求：

1.7 Simulator 下载调试工具菜单

该菜单名称随工程配置的调试工具变化（如选择 ST-Link 时显示 “ST-Link”，选择 J-Link 时显示 “J-Link”），核心功能为调试工具的专属配置，使用频率较低：

1.8 Tools 工具菜单

工具菜单用于配置 IAR 的编辑环境和辅助工具，核心功能如下：

关键配置：Options（IDE 全局配置）

在Tools > Options中可配置以下高频选项：

• Common Fonts：设置全局字体（如菜单、工具栏字体）。
• Editor：配置代码编辑相关：
  • 缩进（Tab size/Indent size）：推荐设置为 2 或 4，统一代码格式。
  • 编码（File Encoding）：选择 UTF-8，支持中文注释无乱码。
  • 行号（Show line numbers）：勾选，便于定位代码。
  • 自动缩进（Auto indent）：勾选，输入代码时自动对齐。
• Key Bindings：自定义快捷键（修改默认快捷键以适配个人习惯）。
• Debugger：配置默认调试器（如默认选择 Simulator 或 ST-Link）。

1.9 Window 窗口菜单

窗口菜单用于管理编辑窗口（与 View 菜单的 “功能窗口” 区分，仅针对代码编辑窗口），核心功能如下：

1.10 Help 帮助菜单

帮助菜单提供 IAR 的官方文档和辅助工具，是学习和排查问题的重要入口：

二、IAR 设置

2.1 插入 / 编辑模板

当需要频繁使用相同代码片段（如函数框架、循环结构）时，可通过模板功能提升效率，操作步骤如下：

1. 插入模板：在代码编辑界面，点击 Edit > Code Templates > Insert Template（快捷键 Ctrl + Alt + V），选择预设模板（如 if、for），IAR 会自动插入模板代码。
2. 编辑 / 新增模板：
   • 点击 Edit > Code Templates > Edit Templates，打开模板编辑窗口。
   • 参考默认模板语法（如#if ${condition}\n{\n ${cursor}\n}\n#endif），新增自定义模板（如 while 循环、函数框架）。
   • 保存后，新增模板会出现在 “Insert Template” 列表中，可直接调用。

示例：新增 while 循环模板
模板代码：

c

运行

while(${condition})
{${cursor} // 光标默认定位此处，便于直接输入代码
}

2.2 完型语句

完型语句功能可自动补全代码（输入部分字符后触发），提升输入效率，使用方式如下：

1. 单词补全（Complete Word）：输入变量 / 函数名的前几个字符（如输入 “USA”），按下快捷键 Ctrl + Alt + Space，IAR 会自动补全匹配的单词（如 “USART_Initializes”）。
2. 代码补全（Complete Code）：输入代码关键字（如 “wh”），按下快捷键 Ctrl + Space，IAR 会显示匹配的代码模板（如 while 循环），选择后自动生成完整代码框架。
3. 参数提示（Parameter Hint）：输入函数名后（如 “printf”），按下快捷键 Ctrl + Shift + Space，IAR 会显示函数的参数列表（如int printf(const char *format, ...)），避免参数遗漏。

2.3 自动缩进

当代码格式凌乱（缩进不一致）时，可通过自动缩进功能统一格式，操作方式：

1. 选中需要整理的代码片段（或全选文件）。
2. 按下快捷键 Ctrl + T（或点击 Edit > Auto Indent），IAR 会根据代码语法（如{}、if、for）自动调整缩进，使代码结构整齐。

示例：凌乱代码整理前：

c

运行

int main(void)
{
while(1)
{
LED_TOGGLE;
printf("Demo..");
}
}

整理后（自动缩进后）：

c

运行

int main(void)
{while(1){LED_TOGGLE;printf("Demo..");}
}

三、编译和调试

3.1 编译

编译是将源代码转换为可执行文件的过程，IAR 提供两种核心编译方式：

编译结果查看：编译完成后，通过底部 “Messages> Build” 窗口查看结果：

• 成功：显示 Done. 0 error(s), 0 warning(s)（无错误无警告）。
• 失败：显示错误（Error）或警告（Warning）的文件、行号和原因，需根据提示修改代码后重新编译。

3.2 不同仿真调试器差异

IAR 支持多种调试器（Simulator、ST-Link、J-Link 等），不同调试器对应的菜单和功能存在差异，核心区别如下：

3.3 调试

调试的核心是监控程序运行状态、定位问题，步骤如下：

1. 配置调试器：
   • 右键工程空白处 → Options（Alt + F7） → Debugger → 选择调试器（如 Simulator 或 ST-Link） → 点击 “OK” 保存。
2. 启动调试：
   • 点击 Project > Download and Debug（快捷键 Ctrl + D），IAR 会下载程序到目标设备（或加载仿真环境）并进入调试模式。
3. 调试控制：
   • 单步调试：使用 F10（Step Over，不进函数）或 F11（Step Into，进函数）逐行执行代码。
   • 全速运行：按下 F5（Go），程序遇到断点时暂停，无断点则持续运行。
   • 暂停 / 复位：点击 “Break” 暂停程序，点击 “Reset” 复位程序到初始状态。
4. 退出调试：按下 Ctrl + Shift + D（Stop Debugging），返回编辑模式。

调试窗口配合使用：

• 查看变量：通过 Watch、Locals、Statics 窗口监控变量值变化。
• 查看内存：通过 Memory 窗口查看变量在内存中的存储情况。
• 查看调用链：通过 Call Stack 窗口查看函数调用层级。
• 查看打印：通过 Terminal I/O 窗口查看printf输出的日志。

3.4 仿真进行调试

以软件仿真（Simulator）为例，完整调试流程如下：

1. 配置仿真器：工程选项中选择 “Simulator” 调试器（参考 3.3 步骤 1）。
2. 添加断点：在需要暂停的代码行号左侧单击，添加红色断点（快捷键 F9），如在main函数的while(1)行添加断点。
3. 启动调试：按下 Ctrl + D，进入调试模式，程序会暂停在第一个断点处。
4. 逐行调试：
   • 按下 F10（Step Over），执行当前行代码，观察 Locals 窗口中局部变量的变化（如LED_TOGGLE执行后，相关变量值是否改变）。
   • 若遇到函数调用（如printf），按下 F11（Step Into）可进入函数内部，查看函数执行细节；按下 Shift + F11（Step Out）可跳出函数。
5. 全速运行：按下 F5（Go），程序会运行到下一个断点处暂停，或持续运行（无其他断点时）。
6. 查看结果：通过 Terminal I/O 窗口查看printf输出的日志，验证程序逻辑是否正确。

3.5 调试窗口介绍

调试模式下的核心窗口（如 Watch、Locals、Memory 等）功能已在 1.3.2 节介绍，此处重点说明变量查看窗口的差异和数据格式设置：

3.5.1 变量查看窗口对比

3.5.2 数据格式设置

变量窗口中默认显示 16 进制数值，可根据需求修改为其他格式：

1. 在变量窗口中，右键需要修改格式的变量 → 选择 “Format”。
2. 选择目标格式：
   • Decimal Format：十进制（默认用于整数、浮点数）。
   • Hexadecimal Format：十六进制（默认用于地址、寄存器值）。
   • Binary Format：二进制（查看位操作相关变量）。
   • Octal Format：八进制（较少使用）。
   • Char Format：字符格式（查看 char 类型变量）。

示例：将变量addr（u32_t 类型）从十六进制（0x681310C3）改为十进制，右键addr → “Format> Decimal Format”，变量值会显示为 1746511043。