NEC 78K8R User Guide
用户手册
CC78K0R Ver. 1.00
C 编译器
操作篇
目标设备
78K0R 微控制器
文档编号 U17838CA1V0UM00 (第 1 版)
出版日期 2007 年 12 月 CP(K)
© 日本电气电子株式会社 2007
日本印刷
用户手册 U17838CA1V0UM00
[备忘录]
2
用户手册 U17838CA1V0UM00
MS-DOS，Windows 和 Windows NT 是微软公司在美国及/或在其它国家的注册商标或商标。
PC/AT 是 IBM（国际商用机器）公司的注册商标。
i386 是 Intel 公司的注册商标。
z 本文档所刊登的内容有效期截至 2007 年 12 月。将来可能未经预先通知而更改。在实际进行生产
设计时，请参阅各产品最新的数据表或数据手册等相关资料以获取本公司产品的最新规格。
z 并非所有的产品和/或型号都向每个国家供应。请向本公司销售代表查询产品供应及其他信息。
z 未经本公司事先书面许可，禁止复制或转载本文件中的内容。否则因本文档所登载内容引发的错误，
本公司概不负责。
z 本公司对于因使用本文件中列明的本公司产品而引起的，对第三者的专利、版权以及其它知识产权
的侵权行为概不负责。本文件登载的内容不应视为本公司对本公司或其他人所有的专利、版权以及
其它知识产权作出任何明示或默示的许可及授权。
z 本文件中的电路、软件以及相关信息仅用以说明半导体产品的运作和应用实例。用户如在设备设计
中应用本文件中的电路、软件以及相关信息，应自行负责。对于用户或其他人因使用了上述电路、
软件以及相关信息而引起的任何损失，本公司概不负责。
z 虽然本公司致力于提高半导体产品的质量及可靠性，但用户应同意并知晓，我们仍然无法完全消除
出现产品缺陷的可能。为了最大限度地减少因本公司半导体产品故障而引起的对人身、财产造成损
害（包括死亡）的危险，用户务必在其设计中采用必要的安全措施，如冗余度、防火和防故障等安
全设计。
z 本公司产品质量分为：
“标准等级”、“专业等级”以及“特殊等级”三种质量等级。
“特殊等级”仅适用于为特定用途而根据用户指定的质量保证程序所开发的日电电子产品。另外，各种日
电电子产品的推荐用途取决于其质量等级，详见如下。用户在选用本公司的产品时，请事先确认产品
的质量等级。
“标准等级”： 计算机，办公自动化设备，通信设备，测试和测量设备，音频·视频设备，家电，
加工机械以及产业用机器人。
“专业等级”： 运输设备（汽车、火车、船舶等），交通用信号控制设备，防灾装置，防止犯罪
装置，各种安全装置以及医疗设备（不包括专门为维持生命而设计的设备）。
“特殊等级： 航空器械，宇航设备，海底中继设备，原子能控制系统，为了维持生命的医疗设
备、用于维持生命的装置或系统等。
除在本公司半导体产品的数据表或数据手册等资料中另有特别规定以外，本公司半导体产品的质量等
级均为“标准等级”。如果用户希望在本公司设计意图以外使用本公司半导体产品，务必事先与本公司销
售代表联系以确认本公司是否同意为该项应用提供支持。
（注）
（1） 本声明中的“本公司”是指日本电气电子株式会社（NEC Electron
（2） 本声明中的“本公司产品”是指所有由日本电气电子株式会社所开发或制造，或为日本电气电子株式会
社（定义如上）开发或制造的产品。
ics Corporation）及其控股公司。
用户手册 U17838CA1V0UM00
3
[备忘录]
4
用户手册 U17838CA1V0UM00
前言
该手册的目的是帮助您深入理解 CC78K0R 的功能和操作（78K0R 系列 C 编译器）。
该手册没有解释如何编写 CC78K0R 源程序。因此，在阅读手册之前，请先阅读“CC78K0R C
编译器用户手册语言篇（U17837E）”(下文称作”语言手册”)。
[目标设备]
借助 CC78K0R 可以开发面向 78K0R 系列微控制器的软件。为了配合使用这个软件，还需要
RA78K0R(78K0R 系列汇编程序包)(另外销售)和目标模块设备文件。
[目标读者]
写作这本手册是为了让读者通过阅读手册获得设备相关使用知识，读者最好具有软件开发经验。
但是，关于 C 编译器和 C 语言的知识并不是一定需要的，所以第一次使用 C 编译器的用户可以使用
该手册。
[组织结构]
这本手册的结构组织如下描述。
第 1 章 概述
介绍在微控制器开发中 CC78K0R 的作用和位置。
第 2 章 产品概述和安装
介绍如何安装 CC78K0R，所提供程序的文件名，以及程序的操作环境。
第 3 章 从编译到连接的过程
使用样例程序来描述如何运行 CC78K0R，并举例说明从编译到连接的详细处理过程。
第 4 章 CC78K0R 函数
介绍在 CC78K0R 中的优化方法和 ROMizati
第 5 章 编译选项
介绍编译选项，具体的规格说明方法和各个选项的优先级别。
第 6 章 C编译器输出文件
介绍 CC78K0R 输出的各种列表文件。
第 7 章 C编译器的使用方法
介绍一些技巧，帮助读者更熟练的使用 CC78K0R。
on 函数。
用户手册 U17838CA1V0UM00
5
第 8 章 启动例程
CC78K0R 提供了启动例程作为样例。介绍了启动例程的使用，并提供了关于如何改善的建
议。
第 9 章 错误信息
介绍 CC78K0R 输出的错误信息。
附录
附录提供了一个样例程序，一份使用时的注意事项列表，一个命令参数列表和一组索引。
[如何阅读这本手册]
首先，对于希望知道如何开始使用 CC78K0R 的用户，请先阅读第 3 章从编译到连接的过程。
理解 C 编译器一般知识的用户或者已经阅读语言手册的用户可以跳过第 1 章 概述。
[相关资料]
下面的表格显示了这本手册的相关文档（如用户手册）。在出版物中出现的相关资料可能会包括初稿版
本。但是，并未对初稿版本作特殊标注。
开发工具的相关文档（用户手册）
资料名 资料编号
操作篇 本文档 CC78K0R V 1.00 C 编译器
语言篇
RA78K0R V1.00 汇编程序包
操作篇
语言篇
SM+ 系统模拟器 操作篇
PM + V 6.20 版本
ID78K0R-QB 集成调试器 V3.20 版本
U17839E
U17837E
U17836E
U17835E
U18010E
U17990E
注意 上述列出的相关资料如有变动恕不另行通知，请务必使用最新版本的设计文件。
6
用户手册 U17838CA1V0UM00
[约定]
下面解释本手册中所使用符号的意思。
RTOS 78K0R 系列的实时操作系统 RX78K0R
…: 重复相同的格式。
[ ]: 在括号中的字符可以被忽略。
⎡ ⎦: 如括号中的字符所示(字符串)。
“ ”: 如括号中的字符所示(字符串)。
‘ ’: 如括号中的字符所示(字符串)。
Boldface: 如粗体字符所示(字符串)。
_ : 在重要的位置或实例中的下划线都属于输入字符序列。
Δ : 至少一个空间间隔。
: 在程序描述中表示省略。
…
( ) : 如圆括号中之间的字符所示(字符串)。
/ : 分界符
\: 反斜杠
[文件名称约定]
在命令行中指定输入文件名的约定如下所示。
(1) 指定磁盘文件名
[驱动名] [\] [[路径名]...] 主文件名 [.[文件类型]]
<1> <2> <3> <4> <5>
<1> 指定存储文件的驱动名(A: 到 Z:)。
<2> 指定根目录名。
<3> 指定子目录名。
指定的字符串长度应该在操作系统允许范围内。
可以使用的字符:
操作系统允许圆括号(())，分号(:)，逗号(,)之外的所有字符。
注意，连字符(-)不能被当作路径名的首字符。
<4> 主文件名
指定的字符串长度应该在操作系统允许范围内。
可以使用的字符：
操作系统允许除了圆括号(())，分号(:)，逗号(,)以外的所有字符。
注意，连字符(-)不能被当作路径名的首字符。
<5> 文件类型
指定的字符串长度应该在操作系统允许范围内。
可以使用的字符：
操作系统允许除了圆括号(())，分号(:)，逗号(,)以外的所有字符。
例： C:\Program Files\NEC Electronics Tools\CC78K0R\V1.00\smp78k0r\cc78k0r
注意 1. 在‘:’, ‘.’和 ‘\’之前或之后不能有空格。
2. 不区分大写和小写 (大小写不敏感)。
用户手册 U17838CA1V0UM00
7
(2) 指定设备文件名
可以使用下列逻辑设备。
CON
PRN
AUX
NUL
逻辑设备 描述
输出到控制台。
输出到打印机。
输出到辅助输出设备。
伪输出(没有输出)
8
用户手册 U17838CA1V0UM00
目录
前言 ...........................................................................................................................................................................5
目录 ...........................................................................................................................................................................9
插图列表 ................................................................................................................................................................. 11
表格列表 .................................................................................................................................................................12
第 1 章 概述 ...........................................................................................................................................................13
1.1 CC78
1.2 使用CC78K0R的开发过程................................................................................................................15
第 2 章 产品概
2.1 主机和供应媒介..................................................................................................................................25
2.2 安装..........................................................................................................................................................26
2.3 设备文件的安装..................................................................................................................................27
2.4 目录结构............................................................................................................................... ...............28
2.5 文档结构..............................................................................................................................................29
2.6 卸载步骤............................................................................................................................... ...............33
2.7 环境设置............................................................................................................................... ...............34
第 3 章 编译到
3.1 PM + ....................................................................................................................................................35
3.2 从编译到连接的过程（未使用自写入模式时） ..............................................................................63
3.3 从编译到连接（当使用自写入模式时） ..........................................................................................69
3.4 C编译器的输入/输出文件 ..................................................................................................................79
3.5 执行开始和结束信息 ..........................................................................................................................81
第 4 章 CC7
4.1 优化方法............................................................................................................................... ...............82
4.2 ROM化功能 ........................................................................................................................................84
第 5 章 编译选
5.1 编译选项的指定..................................................................................................................................85
5.2 编译选项的优先级 ..............................................................................................................................86
5.3 类型 .....................................................................................................................................................88
5.4 编译选项的描述..................................................................................................................................90
第 6 章 C编译
6.1 目标模块文件....................................................................................................................................135
6.2 汇编源模块文件................................................................................................................................136
6.3 错误列表文件....................................................................................................................................140
K0R的作用............................................................................................................................... .13
1.2.1 使用编辑器创建源程序模块.................................................................................................16
1.2.2 C 编译器................................................................................................................................17
1.2.3 汇编器 ....................................................................................................................................18
1.2.4 连接器 ....................................................................................................................................19
1.2.5 目标转换器 ............................................................................................................................20
1.2.6 库管理程序 ............................................................................................................................21
1.2.7 调试器 ....................................................................................................................................22
1.2.8 系统模拟器 ............................................................................................................................23
1.2.9 PM +.......................................................................................................................................24
述和安装 ....................................................................................................................................... 25
2.5.1 库文件 ....................................................................................................................................30
2.7.1 主机 ........................................................................................................................................34
2.7.2 环境变量 ................................................................................................................................34
连接的过程 ................................................................................................................................... 35
3.1.1 CC78
3.1.2 执行的环境 ............................................................................................................................35
3.1.3 CC78
3.1.4 [Compiler Options]对话框的具体描述................................................................................41
3.2.1 从PM +中MAK
3.2.2 使用命令行来编译连接（命令提示符） .............................................................................66
3.3.1 在PM +中的编
3.3.2 命令行中的编译到连接（命令提示符）.................................................................................76
3.5.1 执行开始信息.........................................................................................................................81
3.5.2 执行结束信息.........................................................................................................................81
8K0R函数 ......................................................................................................................................... 82
4.2.1 连接 ........................................................................................................................................84
项 ...................................................................................................................................................85
器输出文件...................................................................................................................................135
6.3.1 关于C语
K0RP.DLL的位置（工具动态连接文件）.................................................................35
K0R选项设置菜单.......................................................................................................36
E....................................................................................................................63
译到连接 .......................................................................................................69
言的错误列表文件....................................................................................................140
用户手册 U17838CA1V0UM00
9
6.3.2 只有错误信息的错误列表文件...............................................................................................142
6.4 预处理列表文件................................................................................................................................143
6.5 交叉引用列表文件 ............................................................................................................................145
第 7 章 C编译
7.1 高效操作（EX
器的使用方法...............................................................................................................................147
IT状态函数） ...........................................................................................................147
7.2 建立开发环境（环境变量） ............................................................................................................148
7.3 中断编译............................................................................................................................... .............149
第 8 章 启动例
程 .................................................................................................................................................150
8.1 文件结构...............................................................................................................................................150
8.1.1 BA
T目录内容 .......................................................................................................................151
8.1.2 SRC目录内容 ......................................................................................................................152
8.1.3 “Lib”目录内容.......................................................................................................................153
8.2 批处理文件说明................................................................................................................................154
8.2.1 生成启动
例程的批处理文件...................................................................................................154
8.3 启动例程............................................................................................................................................155
8.3.1 启动例程概述.......................................................................................................................155
8.3.2 样例程序的说明（cst
8.3.3 修改启动
例程 ..........................................................................................................................164
art.asm）.........................................................................................157
8.4 flash区域中启动模块的ROM化处理 ..............................................................................................167
第 9 章 错误信
息 .................................................................................................................................................169
9.1 错误信息格式....................................................................................................................................169
9.2 错误信息类型....................................................................................................................................170
9.3 错误信息列表....................................................................................................................................171
9.3.1 命令行错
误信息 ......................................................................................................................172
9.3.2 内部错误和内存错误信息 ......................................................................................................175
9.3.3 字符错误
信息 ..........................................................................................................................177
9.3.4 配置元素错误信息 ..................................................................................................................178
9.3.5 转换错误
信息 ..........................................................................................................................181
9.3.6 表达式错误信息 ...................................................................................................................... 183
9.3.7 语句错误
信息 ..........................................................................................................................187
9.3.8 声明和函数定义的错误信息...................................................................................................189
9.3.9 预处理命
令的错误信息 ...........................................................................................................195
9.3.10 致命的文件I/O和运行非法操作系统的错误信息 ...............................................................200
9.4 PM+错误信息列表 ...........................................................................................................................202
附录A 样例程序 ...................................................................................................................................................206
A.1 C 源程序模块文件...........................................................................................................................206
A.2 执行例程............................................................................................................................................207
A.3 输出列表............................................................................................................................................208
A.3.1 汇编源程序模块文件...........................................................................................................208
A.3.2 预处理列表文件...................................................................................................................212
A.3.3 交叉引用列表文件...............................................................................................................213
A.3.4 错误列表文件.......................................................................................................................214
附录B 注意事项列表........................................................................................................................................... 215
附录C 编译参数...................................................................................................................................................226
索引 .......................................................................................................................................................................230
10
用户手册 U17838CA1V0UM00
插图列表
插图编号 插图标题........................................................................................................................................页码
图 1-1.开发过程............................................................................................................................... 13
图 1-2. 软件开发过程...................................................................................................................... 14
图 1-3. 使用C
图 1-4. 创建源程序模块文件 ........................................................................................................... 16
图 1-5. C编译
图 1-6. 汇编器功能 ......................................................................................................................... 18
图 1-7. 连接器功能 ......................................................................................................................... 19
图 1-8. 目标转
图 1-9. 库管理程序功能 ..................................................................................................................21
图 1-1
0. 调试器的功能....................................................................................................................22
图 1-11. 模拟器功能........................................................................................................................23
图 1-12. PM +功能 .......................................................................................................................... 24
图 2-1 目录结
图 3-1 <
图 3-2 < Browse for Folder >对话框................................................................................................37
图 3-3 <
图 3-4 <
图 3-5 <
图 3-6 < Compiler Options >对话框 ................................................................................................ 41
图 3-7 <
图 3-8 < Compiler Options >对话框（当选择“Memory Model”界面时）.......................................... 45
图 3-9 < Compiler Options >对话框（当选择“Data Assign”界面时） .............................................. 46
图 3-10 < Compiler Options >对话框（当选择“集成推荐优化选项”界面时） ...................................47
图 3-1
1 < Compiler Options >对话框（当选择“Char Expression Behavior, Automatic Allocation”界面
时）................................................................................................................................................48
图 3-12 < Compiler Options >对话框（当选择“Optimize Object Size b
图 3-13 < Compiler Options >对话框（当选择“Others”界面时） ..................................................... 50
图 3-14 < Compiler Options >对话框（当选择“Deb
图 3-16 <Assembler Options>对话框 ..............................................................................................53
图 3-1
7< Compiler Options >对话框（当选择“ Error List File, Cross-reference List File”界面时） .54
图 3-18 < Compiler Options >对话框（当选择“Preproc
图 3-19 < Compiler Options >对话框（当选择“Extend”界面时） .................................................... 58
图 3-20 < Compiler Options >对话框（当选择“Others”界面时） ..................................................... 59
图 3-21 < Compiler Options >对话框（当选择“S
图 3-2
2. 优化选项的选择................................................................................................................ 64
图 3-2
3. 连接器选项对话框.............................................................................................................65
图 3-3
4 C编译器的输入/输出文件.................................................................................................... 80
图 5-1. 编译选项对话框 ..................................................................................................................90
C78K0R的程序开发过程 ........................................................................................... 15
器功能 .......................................................................................................................17
换器功能 ..................................................................................................................20
构..............................................................................................................................28
Compiler Options >对话框 ................................................................................................ 36
ParameterFile >对话框...................................................................................................... 38
Edit Option >对话框 .......................................................................................................... 39
Add Option>对话框 ............................................................................................................39
Compiler Options>对话框（当选择“Preprocessor”标签页时）...........................................43
y Calling Library”界面时）.. 49
ug”界面时） ..................................................... 51
ess List File, List Format”界面时） ............ 56
tartup Routine”界面时） ....................................... 61
用户手册 U17838CA1V0UM00
11
表格列表
表格编号 表格标题..........................................................................................................................................页码
表 2-1. C编译
表 2-2. 文档组
表 2-3 程序库文件 .......................................................................................................................... 30
表 2-4 环境变
表 3-1 C编译器I/O文件.................................................................................................................... 79
表 4-1 优化方法.............................................................................................................................. 82
表 5-1 编译选
表 5-2 编译选项列表....................................................................................................................... 88
表 7-1 E
表 7-2 环境变量............................................................................................................................ 148
表 8-1 BA
表 8-2 SR
表 8-3 “L
表 8-4 初始化数据的ROM区域块.................................................................................................. 167
表 8-5 拷贝目
表 9-1 命令行错误信息 .................................................................................................................172
表 9-2 内部错
表 9-3 字符错误信息..................................................................................................................... 177
表 9-4 配置元
表 9-5 转换错误信息..................................................................................................................... 181
表 9-6 表达式错误信息 .................................................................................................................183
表 9-7 语句错
表 9-8 声明和函数定义的错误信息 ............................................................................................... 189
表 9-9 预处理
表 9-10 致命的文件I/O和运行非法操作系统的错误信息 ............................................................... 200
表 9-1
1 PM+错误信息 ...................................................................................................................202
表B-1 相关注意事项列表.............................................................................................................. 215
表C-1 编译参
器的供应媒介和记录格式........................................................................................... 25
织结构(* = 字母数字符号)........................................................................................29
量..............................................................................................................................34
项的优先级................................................................................................................86
XIT状态............................................................................................................................147
T目录内容 ...................................................................................................................... 151
C目录内容 .....................................................................................................................152
ib”目录内容 .....................................................................................................................153
的地的RAM区域块 .................................................................................................. 167
误和内存错误信息...................................................................................................175
素错误信息..............................................................................................................178
误信息..................................................................................................................... 187
命令的错误信息 ...................................................................................................... 195
数 ............................................................................................................................226
12
用户手册 U17838CA1V0UM00
第 1 章 概述
CC78K0R C 编译器能够把符合 ANSI-C
微控制器能够识别的机器语言。
CC78K0R 支持 Windows™系统，必须在 PM +（项目管理器）中才能使用 CC78K0R，PM +工具包含
在 CC78K0R 系列的汇编程序安装包中。如果没有使用 PM +，编译程序可以在命令提示符下运行。
注 ANSI-C 是美国国家标准局所制定的 C 语言标准。
1.1 CC78K0R的作用
CC78K0R 在产品开发中的位置如下图所示。
注
规格或符合 78K0R 系列规格的 C 语言源程序转变成 78K0R
图 1-1.开发过程
产品计划
系统设计
硬件设计 软件设计
产品 编码
失误
漏洞
错误
汇编/编译
CC78K0R
C 编译程序
调试 检查
系统评估
产品生成
用户手册 U17838CA1V0UM00
13
软件开发过程如下图所示。
软件开发
写程序规范
第 1 章 概述
图 1-2. 软件开发过程
是
创建流程图
编译
错误?
连接
否
编写代码
编写源程序模块
文件转换
… 使用 78K0R 系列 C 语言或 ANSI-C。
… 使用编辑器创件建 C 源程序模块文件。
… 连接到引用库和函数库。
… 将文件转换成十六进制格式。
14
调试
… 使用硬件调试器（在线仿真器等）来检验系统的运
行。
否
确定
是
系统评价
用户手册 U17838CA1V0UM00
1.2 使用CC78K0R的开发过程
使用 CC78K0R 的开发过程如下图所示。
图 1-3. 使用 CC78K0R 的程序开发过程
第 1 章 概述
C 源程序
头文件
C 编译器
汇编源程序
汇编列表
绝对汇编列表
列表转换器
十六进制
目标模块文件
汇编器
连接器
目标转换器
汇编源程序
目标模块文件
库文件管理程序
库文件
装载模块文件
系统模拟器
集成调试器
USB
在线仿真器
PROM 编程器
Flash 编程器
用户手册 U17838CA1V0UM00
15
第 1 章 概述
1.2.1 使用编辑器创建源程序模块
一个程序被划分为若干个功能模块。
其中一个模块是代码单元，也是编译器的输入单元。输入到 C 编译器的模块被称作 C 源程序模块。
当所有的 C 源程序模块编写完成后，使用编辑器将源程序模块存入某个文件中。以这种方式创建的文件
被称作 C 源程序模块文件。
这个 C 源程序模块文件就是 CC78K0R 的输入文件。
图 1-4. 创建源程序模块文件
源程序模块
源程序模块
源程序模块
程序
源程序模块
写入文件 (编辑器)
16
源程序模块文件
用户手册 U17838CA1V0UM00
第 1 章 概述
1.2.2 C 编译器
C 编译器读入 C 源程序模块后，将 C 语言转换成机器语言。如果在 C 源程序模块中发现描述错误，就
会输出编译错误信息。如果没有编译错误，就会生成目标模块文件。
为了在汇编语言中对程序进行校正和检查，需要生成汇编源程序模块文件。如果要输出汇编源程序模块
文件，当编译时在编译选项中选中了-A 或-SA 选项，就可以创建汇编源程序模块源文件。（要查看选项的
相关信息，可参阅“第 5 章 编译选项”）
图 1-5. C 编译器功能
目标模块文件
注 设备文件要从在线发送服务（ODS）下载获取，ODS 可以从如下网址登录进入。
设备文件注
C 编译器
汇编器源模块文件
http://www.necel.com/micro/ods/eng/index.html
C 源程序
模块文件
用户手册 U17838CA1V0UM00
17
第 1 章 概述
1.2.3 汇编器
汇编工作是通过使用 RA78K0R 汇编程序安装包（单独销售）中的汇编器来执行的。
汇编器可以对汇编源程序模块文件进行处理，是将汇编语言转化成机器语言的一种程序。如果在源程序
模块中发现描述错误，就会输出汇编错误。如果没有汇编错误，则会生成目标模块文件，这个目标文件模
块中包括机器语言信息和位置分配信息，例如各条机器语言代码被放在哪个内存单元地址。除此以外，在
汇编过程中的信息会以汇编列表文件的形式输出。
图 1-6. 汇编器功能
设备文件
目标模块文件
注
汇编器
汇编源程序
模块文件
汇编列表文件
注 设备文件要从在线发送服务（ODS）下载获取，ODS 可以从如下网址登录进入。
http://www.necel.com/micro/ods/eng/index.html
18
用户手册 U17838CA1V0UM00
第 1 章 概述
1.2.4 连接器
连接操作是通过使用 RA78K0R 汇编程序包（单独销售）中的连接器来执行的。
连接器的输入文件有编译器输出的目标模块文件，也有汇编器输出的目标模块文件，同时将它们和库
文件连接起来(即使只有一个目标模块，也必须执行连接操作)。
会输出一个装载模块文件。
在这种情况下，连接器决定输入模块中的重定位段的地址。同时也决定了重定位符号的值和外部引用
符号的值，并将正确的值嵌入到装载模块文件中。连接器将连接信息输出到连接映射文件（link map）。
图 1-7. 连接器功能
设备文件注
多个目标模块文件
库文件
···
连接器
连接映射文件 装载模块文件
注 设备文件要从在线发送服务（ODS）下载获取，ODS 可以从如下网址登录进入。
http://www.necel.com/micro/ods/eng/index.html
用户手册 U17838CA1V0UM00
19
第 1 章 概述
1.2.5 目标转换器
目标转换操作是通过 RA78K0R 汇编程序包(单独销售)中的转换器来执行的。
目标转换器读入连接器产生的装载模块文件，转换文件的格式，产生 Intel 标准格式的十六进制模块文
件。符号信息输出到符号表文件中。
图 1-8. 目标转换器功能
十六进制目标模块文件
设备文件注
目标转换器
装载模块文件
符号表文件
注 设备文件要从在线发送服务（ODS）下载获取，ODS 可以从如下网址登录进入。
http://www.necel.com/micro/ods/eng/index.html
20
用户手册 U17838CA1V0UM00
第 1 章 概述
1.2.6 库管理程序
为了方便起见，拥有通用接口并被清晰定义的模块被做成库。通过创建库，许多目标模块组成一个文
件，更容易处理。
连接器可以从库文件中提取出需要的模块并将它们连接起来。因此，如果一个库文件中包含多个模块，
当每个模块的连接无需单独指定参数时，就需要使用模块文件的名称。
库管理程序用来创建和更新库文件。库管理功能通过 RA78K0R 汇编程序包（单独销售）中的库管理
程序来执行。
图 1-9. 库管理程序功能
设备文件
注
编译器输出的目标模块文件 汇编器输出的目标模块文件
···
库管理程序
库文件
注 设备文件要从在线发送服务（ODS）下载获取，ODS 可以从如下网址登录进入。
http://www.necel.com/micro/ods/eng/index.html
用户手册 U17838CA1V0UM00
21
第 1 章 概述
1.2.7 调试器
将连接器输出的装载模块文件通过 ID78K0R-NS/ID78K0R-QB（78K0R 系列集成调试器）下载到 IE
（在线仿真器）中，就可以使用图形用户接口对源程序进行调试。
调试时，当目标源程序被编译时(-G 是缺省选项)，指定了-G 选项就可以输出调试信息。指定这个参数，
调试中所需的符号和行号就会被加入到目标模块中。对于编译选项的信息，请查阅“第 5 章 编译选项”。
调试器和仿真器是独立包装并各自销售的不同设备。
图 1-10. 调试器的功能
•
集成调试器
在线仿真器
目标信息
• 调试信息
22
用户手册 U17838CA1V0UM00
第 1 章 概述
1.2.8 系统模拟器
将连接器输出的装载模块文件通过 SM78K0R（78K0R 系列集成模拟器）下载，就可以使用图形用户
接口对源程序进行调试
SM78K0R 是在主机上进行模拟的软件，和 ID78K0R-QB 有着同样的操作界面。
除了在 SM78K0R 中模拟机器指令，同时也可以模拟 MCU 的片上外围设备和中断。因为外围部件和
过程用来构建虚拟的目标系统，所以在开发早期阶段就可以对包含目标系统操作的程序进行调试，并且可
以脱离硬件系统独立进行。
图 1-11. 模拟器功能
装载模块文件
• 目标信息
• 调试信息
模拟器
用户手册 U17838CA1V0UM00
23
第 1 章 概述
1.2.9 PM +
PM +（项目管理器）提供集成化开发环境，可以帮用户高效开发程序。因此，可以使用 PM +的图形
用户界面来进行编辑至调试的一系列开发工作过程。
图 1-12. PM +功能
24
用户手册 U17838CA1V0UM00
第 2 章 产品概述和安装
本章介绍了将 CC78K0R 的文件安装到用户开发环境（主机）的过程，以及从用户开发环境中卸载的过程。
2.1 主机和供应媒介
C 编译器支持表 2-1 中列出的开发环境。
表 2-1. C 编译器的供应媒介和记录格式
主机 操作系统 供应媒介
IBM PC/ATTM及兼容机
注 如果要在 Windows 环境中使用 C 编译器，必须使用 PM +。如果不使用 PM +，也可以在命令提示
符下启动 CC78K0R 编译器。
Windows(2000/XP)注
CD-ROM
用户手册 U17838CA1V0UM00
25
第 2 章 产品概述和安装
2.2 安装
将供应媒体中的 CC78K0R 文件安装到主机的过程说明如下。
(1) 启动 Windows
为主机和外部设备供电并启动 Windows。
(2) 设置供应媒体
将 CC78K0R 的供应媒体放入主机的驱动器(CD-ROM 驱动器)中。安装程序将自动启动。根据显示的提示
信息逐步安装。
警告 如果安装程序没有自动启动，请执行 CC78K0R 文件夹中的 SETUP.EXE 文件。
(3) 文件确认
使用 Windows 资源管理器等，检查 CC78K0R 供应媒体中的文件是否已经安装到主机上。
每个文件夹的详细信息，参考 2.4 Windows 版本目录结构。
26
用户手册 U17838CA1V0UM00
第 2 章 产品概述和安装
2.3 设备文件的安装
请从在线传送服务（ODS）自行下载对应型号的最新版本设备文件，ODS 的入口网址为：
http://www.necel.com/micro/ods/eng/index.html
使用安装文件来进行设备文件的安装。设备安装文件应该和 CC78K0R 同时安装。
用户手册 U17838CA1V0UM00
27
第 2 章 产品概述和安装
2.4 目录结构
Windows 系统安装过程中的标准目录是“Program Files\NEC Electronics Tools”。安装目录中的文档结
构如下，注意在安装过程中可以改变驱动器和安装目录。当使用 PM +执行 MAKE 操作时，相关的工具
（CC78K0R，RA78K0R）也被安装到这个驱动器和目录。
本手册中假定的标准目录就是“Program Files\NEC Electronics Tools”，这是默认的程序名称，也是安
装的默认路径。
图 2-1 目录结构
28
用户手册 U17838CA1V0UM00
第 2 章 产品概述和安装
2.5 文档结构
下面的表格列出了每个目录的内容。
目录结构和文档组织是在安装时就已经决定了。
表 2-2. 文档组织结构(* = 字母数字符号)
目录名 文件名 说明
CC78K0R\Vx.xx\bin\
CC78K0R\Vx.xx\hlp\ cc78k0rp.chm
CC78K0R\Vx.xx\inc78k0r\
CC78K0R\Vx.xx\lib78k0r\
(For link)
CC78K0R\Vx.xx\smp78k0r\
CC78K0R\
CC78K0R\Vx.xx\src\cc78k0
r\bat
CC78K0R\Vx.xx\src\cc78k0
r\lib\(修改用)
CC78K0R\Vx.xx\src\cc78k0
r\src\
注 2,3
注 4
\
注 2
CC78K0r.exe
CC78K0r.msg
*.hlp
*.dll
注 1
标准库的头文件
*.h
cl0r*.lib
s0r*.rel
prime.c
sample.bat
readme.doc
lk78k0r.dr
mkstup.bat
reprom.bat
注 5
*.bat
cl0r*.lib
s0r*.rel
cstart*.asm
更新标准函数的批处理文件（部分的）
注 4
rom.asm
注 5
*.asm
标准函数的源文件（部分的）
编译器
信息文件
帮助文件
DLL 文件
在线帮助文件
库（运行库和标准库）
服务于启动例程的目标文件
用来验证安装的源程序
验证安装所需的批处理文件
验证安装所需文件的说明文件
用于引用的连接命令文件
启动例程的汇编批处理文件
用于更新 rom.asm
库（运行库和标准库）
服务于启动例程的目标文件
启动例程的源文件
ROMization 例程的源文件
备注 *：字母数字符号。
用户手册 U17838CA1V0UM00
29
第 2 章 产品概述和安装
注 1. 参见 CC78K0R C 编译器 语言篇用户手册。
注 2. 为了修改启动例程，修改 CC78K0R\Vx.xx\src\cc78k0r\lib 目录中的源文件。该文件和存储在
CC78K0R\Vx.xx\src\cc78k0r\lib 目录下的某个批处理文件共同编译，所以将该文件拷贝到
CC78K0R\Vx.xx\lib78k0r 目录下，并和用户程序连接。
注 3. 参考“2.5.1 库文件”。
注 4. 本目录中的批处理文件不能在 PM +中使用，他们只能通过命令提示符来执行。只有在源文件必
须被修改时才使用这些文件。
注 5. 参考表 8-1 的内容。
注 6. * = B | E | N（B：指定根区域，E：指定闪存区域，N：未使用标准程序库）。
注 7. 参考表 8-2 的内容。
2.5.1 库文件
·这些文件由标准库、运行时刻库和启动例程组成。
下表列出了目录内容。
目录名
LIB78K0R\
表 2-3 程序
文件名
普通 Boot区域 Flash 区域
cl0rm.lib
cl0rl.lib
cl0rmf.lib
cl0rlf.lib
cl0rxm.lib
cl0rxl.lib
s0rm.rel
s0rml.rel
s0rl.rel
s0rll.rel
注 3
注 3
cl0rm.lib
cl0rl.lib
cl0rmf.lib
cl0rlf.lib
cl0rxm.lib
cl0rxl.lib
s0rmb.rel
s0rmlb.rel
s0rlb.rel
s0rllb.rel
注 3
注 3
cl0rme.lib
cl0rle.lib
cl0rmfe.lib
cl0rlfe.lib
cl0rxme.lib
cl0rxle.lib
s0rme.rel
s0rmle.rel
s0rle.rel
s0rlle.rel
库文件
注 3
库（运行时刻库和标准库）
注 3
启动例程的目标文件
文件作用
注
1
2
注
30
用户手册 U17838CA1V0UM00
Loading...