Icf配置文件分析

介绍介绍IAR的icf配置文件，其实这算是一篇知识深入扩展，初手在用IAR简单开发一款片子的时候很少有人去关心该配置文件的，因为该配置文件一般在用IAR新建工程选型目标芯片的时候系统自动添加了（当然kinetis的官方例程里给出的配套的配置文件需要另行自己添加了），会觉得这是IDE系统的事。但是如果你是要做深入研究或者说真正掌握了解一款片子，而不是雾里看花知其然而不知其所以然，那么配置文件则是你的必修内容，怎么样，好奇了吧，呵呵，下面深入了解一番吧，进入正题：

1.首先说说什么是icf文件（即ILINK链接器的配置文件）的作用，其实在IAR5.x之前，IAR是采用的叫XLINK的链接器（它相应的配置文件为xcl文件），5.x之后才采用了新版ILINK链接器，所以咱们开发Kinetis的IAR6.x自然也采用的是ILINK链接器，配置文件为icf文件，咳咳，如果有人问什么是链接器，先谷歌一下补补，我这里就引用IAR官方手册里的一句话简要说明一下什么是链接器及其相应配置文件的作用吧：

”EWARM 5.xx 中的链接器称为ILINK。ILINK 可以从 ELF/DWARF 格式的目标文件中提取代码和数据， 并生成可执行的输出镜像。对于 ELF/DWARF 格式而言，基本的链接单元是section，section 的类型有code和data，属性可以是readonly （ro），readwrite （rw）和zeroinit （zi）。ILINK 根据 ILINK Configuration File（*.icf）来分配和定位这些sections。“

2.简单的概括icf的文件，其主要包括以下几个内容，即：

（1）可编址的存储空间（memory）；

（2）不同的存储地址区域（region）；

（3）不同的地址块（block）；

（4）section的初始化与否；

（5）section在存储空间的放置。

上面几点内容，如果你对照实际icf文件都会找得到，建议大家尝试下，会让你受益匪浅的。

3.对于icf文件使用的常用命令，在网上早已有人贴出来了，随意即可搜到，这里省去麻烦，我也贴出来自己学的时候记下来的命令用法，建议通读一遍：

（1）define [ exported ] symbol name = expr;
作用：指定某个符号的值。
参数：

exported 导出该symbol，使其对可执行镜像可用
name 符号名
expr 符号值
举例：

define symbol RAM_START_ADDRESS = 0x40000000;  /*  定义 RAM 起始地址  */ 

define symbol RAM_END_ADDRESS  = 0x4000FFFF;  /*  定义 RAM 结束地址  */

-------------------------------------------------------------------
（2）define memory name with size = expr [, unit-size];
作用：
定义一个可编址的存储地址空间（memory）。
参数：
name memory的名称
expr 地址空间的大小
unit-size expr的单位，可以是位（unitbitsize），缺省是字节（unitbytesize）
举例：
define memory MEM with size = 4G;
-----------------------------------------------------------------
（3）define region name = region-expr;
作用：
定义一个存储地址区域（region）。一个区域可由一个或多个范围组成，每个范围内地址必须连续，但几个范围之间不必是连续的。
参数：
name region的名称
region-expr memory:[from expr { to expr | size expr}]，可以定义起止范围，也可以定义起始地址和region的大小
举例：

define region ROM = MEM:[from 0x0 size 0x10000]; 

    /* 定义 ROM region，位于地址空间MEM 中，起始地址为0x0，大小为0x10000 字节  */ 

define region ROM = MEM:[from 0x0 to 0xFFFF]; 

    /* 定义 ROM region，位于地址空间MEM 中，起始地址为0x0，结束地址为0xFFFF */

---------------------------------------------------------------------------------------------

（4）

define block name [ with param, param... ] 

{ 

extended-selectors 

}; 

作用：     定义一个地址块（block）；它可以是个只保留指定大小的地址空间的空块，比如栈、堆；也可以包含一系列的sections，由extended-selectors 选择。 

参数： 

name     block 的名称 

param   可以是：        size = expr       （块的大小） 

                   maximum size = expr （块大小的上限） 

                   alignment = expr   （最小对齐字节数） 

                   fixed order        （按照固定顺序放置sections） 

extended-selector  [ first | last ] { section-selector | block name | overlay name } 

first           最先存放 

last            最后存放 

section-selector [ section-attribute ][ section sectionname ][object filename ] 

section-attribute [ readonly [ code | data ] | readwrite [ code | data ] | zeroinit ] 

sectionname      section的名称 

filename         目标文件的名称 

name            block或overlay的名称 

注：这里可以按照section的属性，名称及其所在目标文件这三个过滤条件中，任意选取一个条件或多个条件进行组合，来圈定所要求的sections。 

举例： 

define block HEAP with size = 0x1000, alignment = 4 { }; 

    /* 定义 HEAP block，大小为0x1000，4 字节对齐，没有内容  */ 

define block MYBLOCK1 = { section mysection1, section mysection2, readwrite }; 

     /* 定义 MYBLOCK1 block，含有mysection1，mysection2，以及所有readwrite 属性的sections */ 

define block MYBLOCK2 = { readwrite object myfile2.o }; 

    /* 定义 MYBLOCK2 block，含有目标文件myfile2.o 中所有readwrite 属性的sections */ 

define block MYBLOCK3 = { readonly code object myfile3.o }; 

    /* 定义 MYBLOCK3 block，含有目标文件myfile3.o 中所有readonly 属性的code sections */ 

（5）

initialize { by copy | manually } [ with param, param... ] 

{ 

section-selectors 

}; 

作用：              初始化sections 

参数： 

by copy          在程序启动时自动执行初始化 

manually         在程序启动时不自动执行初始化 

param            可以是：         packing = { none | compress1 | compress2 | auto } copy routine = functionname 

                 packing表示是否压缩数据，缺省是auto 

                 functionname表示是否使用自己的拷贝函数来取代缺省的拷贝函数 

section-selector 同上 

举例： 

initialize by copy { readwrite };  /*  在启动时初始化所有属性为 readwrite 的sections */ 

--------------------------------------------------------------

（6）

do not initialize 

{ 

section-selectors 

}; 

作用：               规定在程序启动时不需要初始化的sections；一般用于__no_init 声明的变量段（.noinit） 

参数： 

section-selector  同上 

举例： 

do not initialize { .noinit };  /*  在启动时不要初始化.noinit section */ 

（7）

place at { address memory [:expr] | start of region_expr | end of region_expr } 

{ 

extended-selectors 

}; 

作用：                   把section 或 block 放置在某个具体的起始地址处，或者一个 region 的开始或结束处 

参数： 

memory                memory 的名称 

expr                  地址值，该地址必须在 memory 所定义的范围内 

region_expr           region 的名称 

extended-selector      同上 

举例： 

place at end of ROM { section .checksum };                /*  把.checksum 放在 ROM region 的最后  */ 

place at address MEM:0x0 { section .intvec };             /*  把.intvec 放在地址 0x0 */ 

place at address MEM:0x1000 { section .text object myfile.o };  /* the .text section of myfile.o */ 

place at address MEM:0x1000 { readonly object myfile.o };      /* all read-only sections of myfile.o */ 

place at address MEM:0x1000 { readonly data object myfile.o }; /* all read-only data sections of myfile.o */ 

（8）

place in region-expr 

{ 

extended-selectors 

}; 

作用：                   把section 或 block  （按任意顺序）放置在某个region 中 

参数： 

region-expr           region 的名称 

extended-selector      同上 

举例： 

place in ROM { readonly };               /* all readonly sections */ 

place in RAM { readwrite };              /* all readwrite sections */ 

place in RAM { block HEAP, block CSTACK, block IRQ_STACK };  /* heap and stacks */ 

place in ROM { section .text object myfile.o }; /* the .text section of myfile.o */ 

place in ROM { readonly object myfile.o }; /* all read-only sections of myfile.o */ 

place in ROM { readonly data object myfile.o }; /* all read-only data sections myfile.o */