dsp的CMD文件详解

DSP的CMD文件详解
CMD是用来分配ROM和RAM空间用的,告诉链接程序怎样计
算地址和分配空间。所以不同的芯片就有不同大小的ROM和RAM，
存放用户程序的地方也不尽相同。所以要根据芯片进行修改，分为
MEMORY和SECTIONS两个部分。
MEMORY
{
PAGE0..........
PAGE1.........
}
SECTIONS
{
.vectors.................
.reset.................
................
}
MEMORY是用来指定芯片的ROM和RAM的大小和划分出几
个区间。PAGE0对应ROM，PAGE1对应RAM。PAGE里包含的
区间名字与其后面的参数反映了该区间的起始地址和长度。
SECTIONS：(在程序里添加下面的段名，如.vectors。用来指定
该段名以下，另一个段名以上的程序(属于PAGE0)或数据(属于
PAGE1)放到“>”符号后的空间名字所在的地方。)
SECTIONS
{
.vectors:{}>VECSPAGE0
.reset:{}>VECSPAGE0
............
............
..........
}
eg:
MEMORY
{
PAGE0:
VECS :origin=00000h, length=00040h
LOW :origin=00040h, length=03FC0h
SARAM :origin=04000h, length=00800h
B0 :origin=0FF00h, length=00100h
PAGE1:
B0 :origin=00200h, length=00100h
B1 :origin=00300h, length=00100h
B2 :origin=00060h, length=00020h
SARAM :origin=08000h, length=00800h
}
SECTIONS
{
.text :{}>LOWPAGE0
.cinit :{}>LOWPAGE0
.switch :{}>LOWPAGE0
.const :{}>SARAMPAGE1
.data :{}>SARAMPAGE1
.bss :{}>SARAMPAGE1
.stack :{}>SARAMPAGE1
.sysmem :{}>SARAMPAGE1
}
由三部分组成：
1 输入/输出定义：这一部分，可以通过ccs的“BuildOption........”菜
单设置：.obj(链接的目标文件)、.lib(链接的库文件)、.map(生成的交
叉索引文件)、.out(生成的可执行代码)。
2 MEMORY命令：描述系统实际的硬件资源
3 SECTION命令：描述“段”如何定位
例子：
.cmd文件
-c
-ohello.out
-mhello.map
-stack100
-lrts2xx.lib
MEMORY
{
PAGE0:VECT:origin=0x8000,length0x040
PAGE0:PROG:origin=0x8040,length0x6000
PAGE1:DATA:origin=0x8000,length0x400
}
SECTIONS
{
.vextors>VECTPAGE0
.text>PROGPAGE0
.bss>DATAPAGE1
.const>DATAPAGE1
}
存储模型：c程序的代码和数据如何定位
系统定义：
.cinit 存放程序中的变量初值和常量
.const 存放程序中的字符常量、浮点常量和用const声明的常量
.switch存放程序中switch语句的跳转地址表
.text 存放程序代码
.bss 为程序中的全局和静态变量保留存储空间
.far 为程序中用far声明的全局和静态变量保留空间
.stack为程序系统堆栈保留存储空间，用于保存返回地址、函数间的
参数传递、存储局部变量和保存中间结果
.sysmem用于程序中的malloc 、calloc 、和realoc 函数动态分配存
储空间
CMD的专业名称叫链接器配置文件，是存放链接器的配置信息
的，我们简称为命令文件，其中比较关键的就是MEMORY和
SECTIONS两个伪指令的使用，常常令人困惑，系统出现的问题也经
常与它们的不当使用有关。CCS是DSP软件对DOS系统继承的开发
环境，CCS的命令文件经过DOS命令文件长时间的引申发展，已经
变得非常简洁（不知道TI文档有没有详细CMD配置说明）。我学CMD
是从DOS里的东西开始的，所以也从DOS环境下的CMD说起：
1、命令文件的组成
命令文件的开头部分是要链接的各个子目标文件的名字，这样链
接器就可以根据子目标文件名，将相应的目标文件链接成一个文件；
接下来就是链接器的操作指令，这些指令用来配置链接器，接下来就
是MEMORY和SECTIONS两个伪指令的相关语句，必须大写。
MEMORY，用来配置目标存储器，SECTIONS用来指定段的存放位
置。结合下面的典型DOS环境的命令文件link.cmd来做一下说明：
file.obj//子目标文件名1
file2.obj//子目标文件名2
file3.obj//子目标文件名3
-oprog.out//连接器操作指令,用来指定输出文件
-mprog.m//用来指定MAP文件
MEMORY
{ 略}
SECTIONS
{ 略}
otherlink.cmd
本命令文件link.cmd要调用的otherlink.cmd等其他命令文件，则文件
的名字要放到本命令文件最后一行，因为放开头的话,链接器是不会
从被调用的其他命令文件中返回到本命令文件。
2、MEMORY伪指令
MEMORY用来建立目标存储器的模型，SECTIONS指令就可以根据
这个模型来安排各个段的位置，MEMORY指令可以定义目标系统的
各种类型的存储器及容量。MEMORY的语法如下：
MEMORY
{
PAGE0:name1[(attr)]:origin=constant,length=constant
name1n[(attr)]:origin=constant,length=constant
PAGE1:name2[(attr)]:origin=constant,length=constant
name2n[(attr)]:origin=constant,length=constant
PAGEn:namen[(attr)]:origin=constant,length=constant
namenn[(attr)]:origin=constant,length=constant
}
PAGE关键词对独立的存储空间进行标记，页号n的最大值为
255，实际应用中一般分为两页,PAGE0程序存储器和PAGE1数据存
储器。
name存储区间的名字，不超过8个字符，不同的PAGE上可以出现
相同的名字（最好不用，免的搞混），一个PAGE内不许有相同的name。
attr的属性标识，为R表示可读；W可写X表示区间可以装入可执行
代码；I表示存储器可以进行初始话，什么属性代码也不写，表示存
储区间具有上述的四种属性，基本上我们都选择这种写法。
origin:略。
length:略。
下面是经常用的2407的简单写法大家参考,程序从0x060开始，要避
开加密位，不从0x0044开始更可靠一点，此例中的同名的页可以只
写第一个，其后省略，但写上至少安全一点：
MEMORY
{
PAGE0:VECS:origin=0x0000, length0x40
PAGE0:PROG:origin=0x0060, length0x6000
PAGE1:B0:origin=0x200, length0x100
PAGE1:B1:origin=0x300, length0x100
PAGE1:DATA:origin=0x0860, length0x0780
}
3、SECTIONS伪指令
SECTIONS指令的语法如下：
SECTIONS
{
.text:{所有.text输入段名}load＝加载地址run=运行地址
.data:{所有.data输入段名}load＝加载地址run=运行地址
.bss:{所有.bss输入段名}load＝加载地址run=运行地址
.other:{所有.other输入段名}load＝加载地址run=运行地址
}
SECTIONS必须用大写字母，其后的大括号里是输出段的说明性
语句，每一个输出段的说明都是从段名开始，段名之后是如何对输入
段进行组织和给段分配存储器的参数说明：
以.text段的属性语句为例，“{所有.text输入段名}”这段内容用来说明
连接器输出段的.text段由哪些子目标文件的段组成，举例如下
SECTIONS
{
.text:{file1.obj(.text)file2(.text)file3(.text,cinit)}略
}
指明输出段.text 要链接file1.obj 的.text 和file2的.text 还有file3
的.text和.cinit。在CCS的SECTIONS里通常只写一个中间没有内容
的“{}”就表示所有的目标文件的相应段。接下来说明“load＝加载地
址run=运行地址”链接器为每个输出段都在目标存储器里分配两个
地址：一个是加载地址，一个是运行地址。通常情况下两个地址是相
同的，可以认为输出段只有一个地址，这时就可以不加“run=运行地
址”这条语句了；但有时需要将两个地址分开，比如将程序加载到
FLASH，然后放到RAM中高速运行，这就用到了运行地址和加载地
址的分别配置了，如下例所示：
.const :{略}load=PROGrun=0x0800，常量加载在程序存储区，配
置为在RAM里调用。“load＝加载地址”的几种写法需要说明一下，
首先“load”关键字可以省略，“＝”可以写成“>”, “加载地址”可以是：
地址值、存储区间的名字、PAGE关键词等，所以大家见到“.text:{}>
0x0080”这样的语句可千万不要奇怪。“run=运行地址”中的“=”可以
用“>”，其它的简化写法就没有了。大家不要乱用。
4、CCS中的案例
在CCS中的命令文件好像简化了不少，少了很多东西，语句也
精简了好多，首先不用指定输入链接器的目标文件，CCS会自动默认
处理，其次链接器的配置命令也和DOS的环境不同，需要了解的请
找TI文档吧！下面是刘和平书中的例子，大家来看看是不是可以很
精确的理解了呢！
-stack40
MEMORY
{
PAGE0:VECS:origin=0h, length=40h
PVECS:origin=40h, length=70h
PROG:origin=0b0h, length=7F50h
PAGE1:MMRS:origin=0h, length=05Fh
B2:origin=0060h, length=020h
B0:origin=0200h, length=100h
B1:origin=0300h, length=100h
SARAM:origin=0800h, length=0800h
EXT:origin=8000h, length=8000h
}
SECTIONS
{
.reset:{}>VECSPAGE0
.vectors:{}>VECSPAGE0
.pvecs:{}>PVECSPAGE0
.text:{}>PROGPAGE0
.cinit:{}>PROGPAGE0
.bss:{}>SARAMPAGE1
.const:{}>SARAMPAGE1
.stack:{}>B1PAGE1
}
第二章CMD文件的编写
1、COFF格式
1>通用目标文件格式（CommonObjectFileFormat）是一种流行的二
进制可执行文件格式，二进制可执行文件包括库文件（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)
.switchswitch语句产生的常数表格（program/低64K数据空间）
.pinitTablesforglobalconstructors(C++)(program)
.cinit 用来存放对全局和静态变量的初始化常数值(program)
.const 全局和静态的const变量初始化值和字符串常数，（data）
.econst 长.const（可定位到任何地方）（data）
3>自定义段（C语言）
#pragmaDATA_SECTION(函数名或全局变量名,"用户自定义在数据
空间的段名")；#pragmaCODE_SECTION(函数名或全局变量名,"用户
自定义在程序空间的段名")，不能在函数体内声明，必须在定义和使
用前声明，#pragma可以阻止对未调用的函数的优化
3、连接命令文件（CMD）
1>MEMORY指定存储空间
MEMORY
{
PAGE0:
name0[attr]:origin=constant, length=constant
PAGEn:
namen[attr]:origin=constant, length=constant
}
PAGEn:标示存储空间，nSECTIONS分配段
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>直接写编译命令
-lrts2800_ml.lib连接系统文件rts2800_ml.lib
-ofilename.out 最终生成的二进制文件命名为filename.out
-mfilename.map生成映射文件filename.map
-stack0x200堆栈为512字
4、.const段：
由关键字const限定的全局变量（const限定的局部变量不产生）
初始化值，和出现在表达式（做指针使用，而用来初始化字符串数组
变量不产生）中的字符串常数，另外数组和结构体是局部变量时，其
初始值会产生.const段，而全局时不产生。
DSP的CMD文件讲解2：
CMD文件由三部分组成：(1)输入输出定义；(2)MEMORY命令；(3)SECTIO
N命令。
输入/输出定义：这一部分，可以通过ccs的“BuildOption........”菜
单设置
。obj链接的目标文件
。lib链接的库文件
。map生成的交叉索引文件
。out生成的可执行代码
MEMORY命令：描述系统实际的硬件资源
SECTION命令：描述“段”如何定位
下面给出一个例子：
-c
-o hello.out
-m hello.map
-stack 100
-l rts2xx.lib
MEMORY
{
PAGE0:VECT:origin=0x8000,length 0x040
PAGE0:PROG:origin=0x8040,length 0x6000
PAGE1:DATA:origin=0x8000,length 0x400
}
SECTIONS
{
.vextors >VECTPAGE0
.text >PROGPAGE0
.bss >DATAPAGE1
.const >DATAPAGE1
}
存储模型说明：
.cinit存放程序中的变量初值和常量
.const存放程序中的字符常量、浮点常量和用const声明的常量
.switch存放程序中switch语句的跳转地址表
.text存放程序代码
.bss为程序中的全局和静态变量保留存储空间
.far为程序中用far声明的全局和静态变量保留空间
.stack为程序系统堆栈保留存储空间，用于保存返回地址、函数间的参数
传递、存储局部变量和保存中间结果
.sysmem用于程序中的malloc、calloc、和realoc函数动态分配存储空
间.text可执行代码
一、CMD命令文件常用的伪指令
1、.cint：存放已明确初始化的全局变量和静态变量
2、.const：存放已明确初始化的字符串常量、全局变量和静态常量
3、.switch：存放对于大型switch语句的跳转表
4、.text：存放可执行代码和浮点数常量
5、.bss：存放没有初始化的全局变量和静态变量
6、.stack：定义软件堆栈
二、CMD命令文件内容
CMD是用来分配程序存储器空间rom和数据存储器空间ram的,告诉链接程序怎样计算
地址和分配空间。不同的芯片有不同大小的rom和ram，放用户程序的地方也不尽相同，所
以要根据DSP的存储器的地址范围来编写。分两部分：MEMORY和SECTIONS.
1、MEMORY是用来指定芯片的rom和ram的大小和划分出几个区间。
MEMORY
{PAGE0：name1[(attr)]:origin=constant,length=constant;
PAGE1：namen[(attr)]:origin=constant,length=constant;
}
PAGE0对应rom，PAGE1对应ram。PAGE里包含的区间名字与其后面的参数反映了
该区间的起始地址和长度。name存储器名称，同一页上的存储器名称不能相同，不同页上
的可以相同。attr存储区的属性，未规定的可以有R（只读）、W（只写）、X（存储器可
以包含可执行代码）、I（存储器可以被初始化）。
2、Section块用来控制段的构成与地址分配。对于不同的系统配置，Section的分配方式也
不相同，链接器通过Section来控制地址的分配，所以Section的分配成了配置.cmd文件
的重要环节。
SECTIONS
{
.vectors:{}>VECSPAGE0
.reset:{}>VECSPAGE0
..........
}
它分成两个基本的部分：
（1）被初始化的Section（包含数据表和可执行代码）
.text：它包含所有的可执行代码和常数，必须放在程序页
.cinit：它包含初始化的变量和常量表，要求放在程序页
.pinit：它包括全局构造器（C++）初始化的变量表，要求放在程序页
.const：它包括字符串、声明、以及被明确初始化过的全局和静态变量，要求放在低
地址数据页。
.econst：是在使用大存储器模式时使用的，包括字符串、声明、以及被明确初始化过
的全局变量和静态变量，可以在数据页的任何地方。
.switch：它包括为转换声明设置的表格，可以放在程序页，也可以放在低地址的数据
页。
（2）未被初始化的Section(为程序运行中创建和存放的变量在存储器中保留空间)
.bss：它为全局变量和静态变量保留空间.在程序开始运行时,C导入路径把数据
从.cinit节复制出去然后存在.bss节中.要求放在低地址的数据页.
.ebbs：它是在远访问(C)和大存储器模式下使用,它为全局变量和静态变量保留空间.
在程序开始运行时,C导入路径把数据从.cinit段复制出去然后存在.ebss节中。可以存放
在数据页的任何地方。
.stack：为C系统堆栈保留空间，这部分存储器为用来将声明传给函数及为局部变量
留出空间。要求放在低地址的数据页。
.system：动态存储器分配保留空间，这个空间用于malloc函数，如果不使用malloc
函数，这个段的大小就是0。要求放在低地址的数据页。
.esystem：动态存储器分配保留空间，这个空间用于外部malloc函数，如果不使用外
部malloc函数，这个段的大小就是0。可也放在数据页的任何地方
eg:命令文件示例
MEMORY
{
PAGE0:VECS:origin=00000h,length=00040h //程序复位
PVECS:origin=00040h,length=00070h //外围模块
中断向量
PROG:origin=000b0h,length=07F50h //片上Flash
PAGE1:B0:origin=00200h,length=00100h //DRAMB0块
B1:origin=00300h,length=00100h //DRAMB1
块
B2:origin=00060h,length=00020h //DRAMB2
块
SARAM:origin=00800h,length=00800h //SRAM块
EXT：origin=08000h,length=08000h //外
部存储器
}
SECTIONS
{
.reset :{}>VECSPAGE0 //复位中断向量
.vectors:{}>VECSPAGE0 //中断向量表
.pvecs :{}>PVECSPAGE0 //外围模块中断向量表
.text :{}>PROGPAGE0 //代码
.cinit:{}>PROGPAGE0
.bss :{}>SARAMPAGE1 //块B2
.const:{}>SARAMPAGE1 //块B2
.stack:{}>B1 PAGE1 //堆栈，40个单元
}
DSP的CMD文件写法综述
DSP的存储器的地址范围，CMD是主要是根据那个来编的。
CMD它是用来分配rom和ram空间用的,告诉链接程序怎样计算地址和分配空间.
所以不同的芯片就有不同大小的rom和ram.放用户程序的地方也不尽相同.所以要根据芯片
进行修改.分两部分.MEMORY和SECTIONS.
MEMORY
{PAGE0..........
PAGE1.........
}
SECTIONS
{SECTIONS
{
.vectors.................
.reset.................
................
}
MEMORY是用来指定芯片的rom和ram的大小和划分出几个区间.
PAGE0对应rom;PAGE1对应ram
PAGE里包含的区间名字与其后面的参数反映了该区间的起始地址和长度.
SECTIONS：(在程序里添加下面的段名如.vectors.用来指定该段名以下，另一个段名以上的程
序(属于PAGE0)或数据(属于PAGE1)放到“>”符号后的空间名字所在的地方。
SECTIONS
{
.vectors:{}>VECSPAGE0/*Interruptvectortable*/
.reset:{}>VECSPAGE0/*Resetcode*/
............
............
..........
}
eg:
MEMORY
{
PAGE0:VECS:origin=00000h,length=00040h
LOW:origin=00040h,length=03FC0h
SARAM:origin=04000h,length=00800h
B0:origin=0FF00h,length=00100h
PAGE1:B0:origin=00200h,length=00100h
B1:origin=00300h,length=00100h
B2:origin=00060h,length=00020h
SARAM:origin=08000h,length=00800h
}
SECTIONS
{
.text:{}>LOWPAGE0
.cinit:{}>LOWPAGE0
.SWITCH:{}>LOWPAGE0
.const:{}>SARAMPAGE1
.data:{}>SARAMPAGE1
.bss:{}>SARAMPAGE1
.stack:{}>SARAMPAGE1
.sysmem:{}>SARAMPAGE1
}