初学CMD文件

一、有关段（sections）的知识
汇编器和链接器产生的可被DSP装置执行的目标程序，这些目标文件格式被称为通用目标文件格式（COFF）。

COFF使得模块化编程更容易，它鼓励用户在写汇编语言程序时根据代码块和数据块的方式来思考如何编写程序，这些“模块（block）”就是“段（sections）”。

目标文件的最小单位称为段，段是占据一个连续空间的代码块或数据块，与其他段一起在存储器映射图内。

目标文件的各个段是分开的，有特色的。

一个COFF目标文件总是包含3个默认段：
（1）.text段，通常包含可执行代码；
（2）.data段，通常含有初始化数据；
（3）.bss段，通常为未初始化变量预留的空间。

自定义的段：
（1）由汇编伪指令.sect创建的段
（2）由汇编伪指令.usect创建的段
其中，.text、.data、由.sect创建的段属于初始化段（含有数据和代码）；.bss、由.usect创建的段属于未初始化段（为未初始化的数据在存储器映像图内预留空间）。

注：不能用不同的伪指令定义相同的段。

二、由汇编器产生的COFF格式的OBJ文件中的段作为构造块，当有多个文件进行链接时，链接器会将输入段结合在一起产生可执行的COFF输出模块，然后链接器为各输出段选择存储器地址，这就是CMD文件。

CMD文件是用来分配ROM和RAM的，告诉链接程序怎么计算地址和分配空间。

它包括三个部分：
（1）输入、输出定义：.obj文件——链接器要链接的目标文件；.lib文件——链接器要链接的库文件；.map文件——链接器生成的交叉索引文件；.out文件——链接器生成的可执行代码。

这部分可通过CCS中的Build Option菜单进行设置。

（2）MEMORY命令：描述系统实际的硬件资源，即指定芯片的ROM和RAM的大小和并划分出的几个区间。

默认的，PAGE0对应ROM（程序存储区），PAGE1对应RAM（数据存储区），例定义一个VECS存储区域，具有R和W属性，填充常数ffffh：
MEMORY
{
PAGE 0：VECS（RW）：origin=0000h,length=00ffh，f=ffffh;
}
注：
1）PAGE就是对一个存储空间进行标记，最多可以有255个PAGE，每个PAGE代表一个完全独立的地址空间，不同的PAGE上的存储器区间可以取相同的名字；
2）Attr:可选项，规定存储器属性：
①R，可以对存储器执行读操作；
②W，可以对存储器执行写操作；
③X，命名的存储器能包含可执行的代码；
④I，可以对存储器进行初始化；
3）origin：起始地址，可写成org或o；length：长度，可写成len或l。

4）fill:为存储区域指定的填充字符，可选项。

填充值用来填充那些未分配给段的存储器区域。

（3）SECTIONS命令：描述“段”如何定位。

例如，在程序里定义段名.vectors，将引用字段名“.vectors”的程序或数据放到VECS（如上所示，VECS是ROM空间00h至ffh的地方）：SECTIONS
{
.vectors: {}>VECS PAGE0;
}
注：
1）“.”加不加都可以；{}表示段的全部，也可以将{}省略。

2）初始化段用SECTIONS可定位两次：装入和运行。

如：一些关键的执行代码必须装在系统的ROM中，但希望在较快的RAM中运行。

例：
SECTIONS
{
.text: load = EXT_MEM, run = 0x0080
}
3）未初始化段只可被定位一次。

4）Section type，用户可以对输出段指定3种特别的类型：
①Type= DSECT：建立一个虚拟段，它不包括在输出段存储器分配里，不占据存储器，不包括在存储器映射图列表里；能覆盖其他输出段、其他DSECT段和未配置的存储器；段的内容、重定位信息和行号信息不放置在输出模块里；
②Type=COPY：与DSECT段相似，差别在于它的内容和相关信息写入输出模块；
③Type=NOLOAD：与正常的输出段的不同在于段的内容、重定位信息和行号信息不放置到输出模块里，链接器为它分配空间，它出现在存储器映射表里。

三、段定义：
（1）系统定义：
.cinit存放C程序中的变量初值和常量；
.const存放C程序中的字符常量、浮点常量和用const声明的常量；
.switch存放C程序中switch语句的跳针表；
.text存放C程序的代码；
.bss为C程序中的全局和静态变量保留存储空间；
.far为C程序中用到的far声明的全局和静态变量保留空间；
.stack为C程序系统堆栈保留存储空间，用于保存返回地址、函数间的参数传递、存储局部变量和保存中间结果；
.sysmem用于C程序中malloc、malloc和realloc函数动态分配存储空间。

（2）用户定义
①
#pragma CODE_SECTION(symbol, "section name");
#pragma DATA_SECTION(symbol, "section name");
②单个地址的时候，可以使用#define，例：
#define my_data *(volatile unsigned int *)0x000B
③在数组变量时，使用#pragma宏：
XXX.h\XXX.c：
#pragma DATA_SECTION(my_data,".data_section")
unsigned char my_data[1024];
在XXX.cmd中建立.data_section并赋予地址就可以了。

CMD文件例：
-o sample.out
-m sample.map
-stack 100
sample.obj
meminit.obj
-l rts.lib
MEMORY {
PAGE 0: VECT : origin = 0xff80 , length 0x80
PAGE 0: PROG : origin = 0x2000 , length 0x400
PAGE 1: DATA : origin = 0x800 , length 0x400
}
SECTIONS {
.vectors : {} >PROG PAGE 0
.text : {} >PROG PAGE 0
.data : {} >PROG PAGE 0
.cinit : {} >PROG PAGE 0
.bss : {} >DATA PAGE 1
}
/tststs660/archive/2009/01/11/3754269.aspx
//////////////////////////////////////////////////////////////////////////////////////////////
DSP的存储器的地址范围，CMD是主要是根据那个来编的。

CMD 它是用来分配rom和ram空间用的,告诉链接程序怎样计算地址和分配空间.
所以不同的芯片就有不同大小的rom和ram.放用户程序的地方也不尽相同.所以要根据芯片进行修改.分两部分.MEMORY和SECTIONS.
MEMORY
{ PAGE 0 ..........
PAGE 1.........
}
SECTIONS
{SECTIONS
{
.vectors .................
.reset .................
................
}
MEMORY是用来指定芯片的rom和ram的大小和划分出几个区间.
PAGE 0 对应rom
PAGE 1 对应ram
PAGE 里包含的区间名字与其后面的参数反映了该区间的起始地址和长度. SECTIONS：(在程序里添加下面的段名如.vectors.
用来指定该段名以下，另一个段名以上的程序(属于PAGE0)或数据(属于PAGE1)
放到“>”符号后的空间名字所在的地方。

SECTIONS
{
.vectors : { } > VECS PAGE 0
.reset : { } > VECS PAGE 0
............
............
..........
}
eg:
MEMORY
{
PAGE 0:
VECS: origin = 00000h, length = 00040h
LOW: origin = 00040h, length = 03FC0h
SARAM: origin = 04000h, length = 00800h
B0: origin = 0FF00h, length = 00100h
PAGE 1:
B0: origin = 00200h, length = 00100h
B1: origin = 00300h, length = 00100h
B2: origin = 00060h, length = 00020h
SARAM: origin = 08000h, length = 00800h
}
SECTIONS
{
.text : { } > LOW PAGE 0
.cinit : { } > LOW PAGE 0
.switch : { } > LOW PAGE 0
.const : { } > SARAM PAGE 1
.data : { } > SARAM PAGE 1
.bss : { } > SARAM PAGE 1
.stack : { } > SARAM PAGE 1
.sysmem : { } > SARAM PAGE 1
/user1/1472/archives/2006/32712.html
//////////////////////////////////////////////////////////////////////////////////////////////
1. COFF格式
1> 通用目标文件格式（Common Object File Format）是一种流行的二进制可执行文件格式，二进制可执行文件包括库文件（lib），目标文件（obj）最终可执行文件（out）。

，现今PC机上的Windows95和NT4.0以后的操作系统的二进制文件格式（PE）就是在COFF格式基础上的进一步扩充。

2> COFF格式：详细的COFF文件格式包括段头，可执行代码和初始化数据，可重定位信息，行号入口，符号表，字符串表等，这些属于编写操作系统和编译器人员关心范畴。

而对于C只需要了解定义段和给段分配空间就可以了。

3> 采用COFF更有利于模块化编程，程序员可以自由决定愿意把哪些代码归属到哪些段，然后加以不同的处理。

2. Section目标文件中最小单位称为块。

一个块就是最终在存储器映象中占据连续空间的一段代码或数据。

1> COFF目标文件包含三个默认的块：
.text可执行代码
.data已初始化数据
.bss为未初始化数据保留的空间
2> 汇编器对块的处理
未初始化块
.bss 变量存放空间
.usect 用户自定义的未初始化段
初始化块
.text 汇编指令代码
.data 常数数据（比如对变量的初始化数据）
.sect 用户自定义的已初始化段
.asect 通.sect，多了绝对地址定位功能，一般不用
3>C语言的段
未初始化块（data）
.bss 存放全局和静态变量
.ebss 长调用的.bss(超过了64K地址限制)
.stack 存放C语言的栈
.sysmem 存放C语言的堆
.esysmem 长调用的.sysmem(超过了64K地址限制)
初始化块
.text 可执行代码和常数(program)
.switch switch语句产生的常数表格（program/低64K数据空间）
.pinit Tables for global constructors (C++)(program) .cinit 用来存放对全局和静态变量的初始化常数值(program)
.const 全局和静态的const变量初始化值和字符串常数，（data）
.econst 长.const（可定位到任何地方）（data）
3> 自定义段（C语言）
#pragma DATA_SECTION(函数名或全局变量名,"用户自定义在数据空间的段名"); #pragma CODE_SECTION(函数名或全局变量名,"用户自定义在程序空间的段名"); 不能在函数体内声明。

必须在定义和使用前声明
#pragma可以阻止对未调用的函数的优化
3. 连接命令文件（CMD）
1> MEMORY指定存储空间
MEMORY
{
PAGE 0:
name 0 [attr] : origin = constant, length = constant
PAGE n:
name n [attr] : origin = constant, length = constant
}
PAGE n:标示存储空间，n<255；PAGE 0为程序存储空间；PAGE 1为程序存储空间name:存储空间名称
attr:存储空间属性：只读R，只写W，可包含可执行代码X,可以被初始化I。

orgin:用来定义存储空间的起始地址
Lenth:用来定义存储空间的长度
2> SECTIONS分配段
SECTIONS
{
name : [property,property,……]
}
name:输出段的名称
property：输出段的属性：
load＝allocation（强制地址或存储空间名称）同>allocation：定义输出段将会被装载到哪里。

run= allocation（强制地址或存储空间名称）同>allocation：定义输出段将会在哪里运行。

注：CMD文件中只出现一个关键字load或run时，表示两者的地址时表示两者的地址时重合的。

PAGE = n，段位于那个存储页面空间。

例：ramfuncs : LOAD = FLASHD,
RUN = RAML0,
LOAD_START(_RamfuncsLoadStart),
LOAD_END(_RamfuncsLoadEnd),
RUN_START(_RamfuncsRunStart),
PAGE = 0
3> 直接写编译命令
-l rts2800_ml.lib 连接系统文件rts2800_ml.lib
-o filename.out 最终生成的二进制文件命名为filename.out
-m filename.map 生成映射文件filename.map
-stack 0x200 堆栈为512字
4. .const段：
由关键字const限定的全局变量（const限定的局部变量不产生）初始化值，和出现在表达式（做指针使用，而用来初始化字符串数组变量不产生）中的字符串常数，另外数组和结构体是局部变量时，其初始值会产生.const段，而全局时不产生。

/user1/3338/archives/2007/36177.html
//////////////////////////////////////////////////////////////////////////////////////////////
dsp———.cmd文件
由三部分组成：
输入/输出定义：这一部分，可以通过ccs的“Build Option........”菜单设置。

obj 链接的目标文件。

lib 链接的库文件。

map 生成的交叉索引文件。

out 生成的可执行代码
MEMORY命令：描述系统实际的硬件资源
SECTION命令：描述“段”如何定位
例子
.cmd文件
-c
-o hello.out
-m hello.map
-stack 100
-l rts2xx.lib
MEMORY
{
PAGE 0: VECT:origin=0x8000,length 0x040
PAGE 0: PROG:origin=0x8040,length 0x6000
PAGE 1: DATA:origin=0x8000,length 0x400
}
SECTIONS
{
.vextors >VECT PAGE 0
.text >PROG PAGE 0
.bss >DATA PAGE 1
.const >DATA PAGE 1
}
存储模型：c程序的代码和数据如何定位
系统定义
.cinit 存放程序中的变量初值和常量
.const 存放程序中的字符常量、浮点常量和用const声明的常量
.switch 存放程序中switch语句的跳转地址表
.text 存放程序代码
.bss 为程序中的全局和静态变量保留存储空间
.far 为程序中用far声明的全局和静态变量保留空间
.stack 为程序系统堆栈保留存储空间，用于保存返回地址、函数间的参数传递、存储局部变量和保存中间结果
.sysmem 用于程序中的malloc 、calloc 、和realoc 函数动态分配存储空间
用户定义：
#pragma CODE_SECTION(symbol."section name")
#pragma DATA_SECTION(symbol,"section name")
/blog/cns!AC2CE6AA9A6A02A3!294.entry
//////////////////////////////////////////////////////////////////////////////////////////////
在《TMS320C6000DSPs原理与应用》看到这样一句话，也许大家心里轻松一点：
“连接命令文件很容易写错，建议使用者以cx000cgtoolsliblnk.cmd文件为模板，并在此文件基础上加以修改。

”
关于连接命令文件的更详细信息参考文献请大家参考相关的assembly language tools user''s guide.使用6000系列的朋友需要参考的文献号是spru186I.pdf。