【转】ADS下的分散加载文件应用实例

 

ADS 下的分散加载文件应用实例

load_region_name  start_address | "+"offset  [attributes] [max_size]
{
    execution_region_name  start_address | "+"offset  [attributes][max_size]
    {
        module_select_pattern  ["("
                                    ("+" input_section_attr | input_section_pattern)
                                    ([","] "+" input_section_attr | "," input_section_pattern)) *
                               ")"]
    }
}

load_region ：        加载区，用来保存永久性数据（程序和只读变量）的区域；
execution_region ：  执行区，程序执行时，从加载区域将数据复制到相应执行区后才能被正确执行；
load_region_name ：  加载区域名，用于 “Linker” 区别不同的加载区域，最多 31 个字符；
start_address ：      起始地址，指示区域的首地址；
+offset ：            前一个加载区域尾地址＋ offset 做为当前的起始地址，且 “offset” 应为 “0” 或 “4” 的倍数；
attributes ：         区域属性，可设置如下属性：
                    PI       与地址无关方式存放；
                    RELOC    重新部署，保留定位信息，以便重新定位该段到新的执行区；
                    OVERLAY  覆盖，允许多个可执行区域在同一个地址， ADS 不支持；
                    ABSOLUTE 绝对地址（默认）；
max_size ：           该区域的大小；

execution_region_name ：执行区域名；
start_address ：      该执行区的首地址，必须字对齐；
+offset ：            同上；
attributes ：         同上；
                    PI          与地址无关，该区域的代码可任意移动后执行；
                    OVERLAY     覆盖；
                    ABSOLUTE    绝对地址（默认）；
                    FIXED       固定地址；
                    UNINIT      不用初始化该区域的 ZI 段；
module_select_pattern ： 目标文件滤波器，支持通配符 “*” 和 “?” ；
                        *.o 匹配所有目标， * （或 “.ANY” ）匹配所有目标文件和库。
input_section_attr ：     每个 input_section_attr 必须跟随在 “ ＋ ” 后；且大小写不敏感；
                        RO-CODE 或 CODE
                        RO-DATA 或 CONST
                        RO 或 TEXT, selects both RO-CODE and RO-DATA
                        RW-DATA
                        RW-CODE
                        RW 或 DATA, selects both RW-CODE and RW-DATA
                        ZI 或 BSS
                        ENTRY, that is a section containing an ENTRY point.
                        FIRST ，用于指定存放在一个执行区域的第一个或最后一个区域；
                        LAST ，同上；
input_section_pattern ： 段名；

汇编中指定段：
     AREA    vectors, CODE, READONLY
C 中指定段：
#pragma arm section [sort_type[[=]"name"]] [,sort_type="name"]*
sort_type:      code 、 rwdata 、 rodata 、 zidata
                如果 “sort_type” 指定了但没有指定 “name” ，那么之前的修改的段名将被恢复成默认值。
#pragma arm section     // 恢复所有段名为默认设置。
应用：
    #pragma arm section rwdata = "SRAM",zidata = "SRAM"
        static OS_STK  SecondTaskStk[256];              // “rwdata”“zidata” 将定位在 “sram” 段中。
    #pragma arm section                                 // 恢复默认设置
分散加载文件中定义如下：
    Exec_Sram  0x80000000  0x40000
    {
        * (sram)
    }

“PI” 属性使用示例：
LR_1 0x010000 PI                ; The first load region is at 0x010000.
{
    ER_RO +0                    ; The PI attribute is inherited from parent.
                                ; The default execution address is 0x010000, but the code can be moved.
    {
        *(+RO)                  ; All the RO sections go here.
    }
    ER_RW +0 ABSOLUTE           ; PI attribute is overridden by ABSOLUTE.
    {
        *(+RW)                  ; The RW sections are placed next. They cannot be moved.
    }
    ER_ZI +0                    ; ER_ZI region placed after ER_RW region.
    {
        *(+ZI)                  ; All the ZI sections are placed consecutively here.
    }
}

LR_1 0x010000                   ; The first load region is at 0x010000.
{
    ER_RO +0                    ; Default ABSOLUTE attribute is inherited from parent. The execution address
                                ; is 0x010000. The code and ro data cannot be moved.
    {
        *(+RO)                  ; All the RO sections go here.
    }
    ER_RW 0x018000 PI           ; PI attribute overrides ABSOLUTE
    {
        *(+RW)                  ; The RW sections are placed at 0x018000 and they can be moved.
    }
    ER_ZI +0                    ; ER_ZI region placed after ER_RW region.
    {
        *(+ZI)                  ; All the ZI sections are placed consecutively here.
    }
}

程序中对某区域地址等的引用方法：
Load$$region_name$$Base             Load address of the region.
Image$$region_name$$Base            Execution address of the region.
Image$$region_name$$Length          Execution region length in bytes (multiple of 4).
Image$$region_name$$Limit           Address of the byte beyond the end of the execution region.

Image$$region_name$$ZI$$Base        Execution address of the ZI output section in this region.
Image$$region_name$$ZI$$Length      Length of the ZI output section in bytes (multiple of 4).
Image$$region_name$$ZI$$Limit       Address of the byte beyond the end of the ZI output sectionin the execution region.

SectionName$$Base                   Input Address of the start of the consolidated section called SectionName.
SectionName$$Limit                  Input Address of the byte beyond the end of the consolidated section called SectionName.

Load ：           加载区，即存放地址；
Image ：          执行区，即运行地址；
Base ：           区首地址；
Limit ：          区尾地址；
Length ：         区长度；
region_name ：    RO 、 RW 、 ZI 、 load_region_name 、 execution_region_name ；

例如：
    “RAM1” 区域的首地址：       Image$$RAM1$$Base
    上例中 “sram” 段首地址：     sram$$Base

汇编引用示例：
  IMPORT |Load$$Exec_RAM1$$Base|              // Exec_RAM1 为 “RW” 段
  IMPORT |Image$$Exec_RAM1$$Base|
  IMPORT |Image$$Exec_RAM1$$Length|
  IMPORT |Image$$Exec_RAM1$$Limit|

  LDR  R0, =|Load$$Exec_RAM1$$Base|
  LDR  R1, =|Image$$Exec_RAM1$$Base|
  LDR  R2, =|Image$$Exec_RAM1$$Limit|
0
  CMP  R1,   R2
  LDRCC R3,   [R0], #4
  STRCC R3,   [R1], #4
  BCC  %b0
C 引用：
extern unsigned char Load$$Exec_RAM1$$Base;
extern unsigned char Image$$Exec_RAM1$$Base;
extern unsigned char Image$$Exec_RAM1$$Length;

void MoveRO(void)
{
 unsigned char * psrc, *pdst;
 unsigned int  count;

 count = (unsigned int)   &Image$$Exec_RAM1$$Length;
 psrc  = (unsigned char *)&Load$$Exec_RAM1$$Base;
 pdst  = (unsigned char *)&Image$$Exec_RAM1$$Base;

 while (count--) {
  *pdst++ = *psrc++;
 }
}

加载文件示例一：
        起始地址       大小
ROM:    0x00000000    256K      ； 0x1fc 保留为加密字，程序在 ROM 中运行；
RAM     0x40000000     16K      ；用于全局变量及任务堆栈；
SRAM    0x80000000    512K      ； SRAM 速度慢，主要用于存放大的数据表；

LOAD_ROM1 0x00000000  0x1f8                 ; 指定该加载区域首地址、大小
{
    EXEC_ROM1  +0  0x1f8                    ; 没有前一加载区域，所以该执行区域首地址为加载去首地址
                                            ; 并指定该区域长度
    {
        Startup.o (vectors, +FIRST)         ; 目标文件的 “vectors” 段放在该执行区域的第一段
        irq.o (+RO)                         ; 目标文件的所有 “RO” 段放在该执行区域
    }
}

LOAD_ROM2 0x00000200                        ; 第二个加载区域
{
    EXEC_ROM2  +0  0x3e600
    {
        * (+RO)                             ; 所有目标文件和库文件中的 “RO” 段存放在该区域
    }

    RAM1   0x40000000   0x4000
    {
        * (+RW, +ZI)                        ; 所有目标文件和库文件的 “RW” 和 “ZI” 段存放在该区域
    }

    SRAM2  0x80000000  0x80000
    {
        * (sram)                            ; 所有目标文件中的 “sram” 段存放在该区域
    }
}

示例二：
    “iap.o” 定义在 “Exec_RAM1” 中运行，所以设置 “PI” 属性；
    在调用 “iap.c” 中函数之前应该将其从 “Load$$Exec_IAP$$Base” 复制到指定的 “Exec_RAM1” 区域；

Load_region1  0x00000000  0x1fc
{
    EXEC_ROM1  +0
    {
        Startup.o (vectors, +FIRST)
        irq.o (+RO)
    }
}

Load_region2  0x00000200  0x3e600
{
    EXEC_ROM2  +0
    {
        * (+RO)
    }

    Exec_IAP   +0  PI               // 可能引起链接器未使用该属性警告，忽略
    {
        iap.o (+RO)
    }

    Exec_RAM1  0x40000000  0x4000
    {
        * (+RW, +ZI)
    }

    Exec_Sram  0x80000000  0x40000
    {
        * (SRAM)
    }
}

// 移动 “IAP.o” 中的所有函数到 “ImageExecIAPBase” 加载区，并调用其中的函数
extern unsigned char Load$$Exec_IAP$$Base;
extern unsigned char Image$$Exec_IAP$$Length;

#define  ImageExecIAPBase  (0x40000000+0x1000)   // 加载区首址

void MoveIAPRO(void)
{
 unsigned char * psrc, *pdst;
 unsigned int  count;

 count = (unsigned int)   &Image$$Exec_IAP$$Length;
 psrc  = (unsigned char *)&Load$$Exec_IAP$$Base;
 pdst  = (unsigned char *)ImageExecIAPBase;

 while (count--) {
  *pdst++ = *psrc++;
 }
}

// 调用 “IAP.O” 中的某函数
 {
  void (* pfnIAPWrite)(unsigned long, int);

  pfnIAPWrite = (void (*)(unsigned long, int))
   (ImageExecIAPBase +
   (unsigned int)IAPWrite -                        // 被调用函数名
   (unsigned int)&Load$$Exec_IAP$$Base);

  pfnIAPWrite((int)((CUPDATA *)CODESTARTADDR)->data,
     ((CUPDATA *)CODESTARTADDR)->length);
    }