痞子衡嵌入式：深扒IAR启动函数流程之段初始化函数__iar_data

　　大家好，我是痞子衡，是正经搞技术的痞子。今天痞子衡给大家分享的是IAR启动函数流程里的段初始化函数__iar_data_init3实现。

　　本篇是《IAR启动函数流程及其__low_level_init设计对函数重定向的影响》一文的后续，在上篇文章里我们在 IAR 软件安装目录下找到了标准启动函数 __iar_program_start() 相关源文件，并且分析了 __iar_program_start() 函数里的全部动作。我们知道了其中负责 .data/.bss/.textrw 段初始化工作的是 __iar_data_init3() 函数，但是这个函数的具体实现并没有详细介绍，今天我们就仔细说说这个 __iar_data_init3() 函数：

Note 1：阅读本文前需要对《IAR链接文件(.icf)》有所了解。

Note 2：本文使用的 IAR EWARM 软件版本是 v9.10.2。

一、为什么有些段需要初始化？

　　《IAR链接文件(.icf)》一文第一小节列出了 IAR 工程里定义的全部系统段（Section）名，其中 .data/.bss/.textrw 段是需要初始化的，因为这些段是链接在 RAM 里，而 RAM 上电其内容都是随机值，所以需要一段启动代码将 .data/.bss/.textrw 段所在的 RAM 区填上对应的初值（初值来自于下载了程序镜像文件的 Flash 区），然后应用程序才能正常运行。

Note: 除了 .data/.bss/.textrw 之外，还有一些段（.noinit/CSTACK/HEAP等）也链接在 RAM 区，但这些段对初值没有依赖，所以不需要初始化。

.bss                 // 初值为 0 的静态/全局变量（RAM）

.data                // 初值为非 0 的全局变量（RAM）

.data_init           // .data 段的初值（Flash）

.textrw              // __ramfunc 修饰的重定向函数实际执行区（RAM）

.textrw_init         // .textrw 段的机器码存储区（Flash）

二、RW/ZI段初始化的一般实现

　　应用程序工程在编译链接结束后，.data/.bss/.textrw 段实际链接地址就确定了（这里指默认由 IAR 链接器自由分配具体链接地址，而不是用户在链接文件中指明具体链接地址的情况），我们知道了这些段的链接地址，就可以完成对应初始化工作（说白了，就是初值数据从 Flash 到 RAM 的拷贝工作），实际链接地址可以通过如下 IAR 链接器提供的接口来获取，具体拷贝过程可参看《IAR下将关键函数重定向到RAM中执行的方法》一文最后一节里的代码。

Note: IAR 链接器为了后续初始化的方便，都是将程序中全部的全局变量紧挨着放到一块连续的 RAM 区域（.data），然后其全部初值也一一对应紧挨着放一起（.data_init，下载到一块连续的 Flash 区）；对于 .textrw 的处理也类似。

#pragma section = ".data"

#pragma section = ".data_init"

#pragma section = ".bss"

#pragma section = ".textrw"

#pragma section = ".textrw_init"

uint8_t *data_ram              = __section_begin(".data");

uint8_t *data_rom              = __section_begin(".data_init");

uint8_t *data_rom_end          = __section_end(".data_init");

uint8_t *bss_start             = __section_begin(".bss");

uint8_t *bss_end               = __section_end(".bss");

uint8_t *code_relocate_ram     = __section_begin(".textrw");

uint8_t *code_relocate_rom     = __section_begin(".textrw_init");

uint8_t *code_relocate_rom_end = __section_end(".textrw_init");

　　段初始化的一般实现虽然简单，但有个缺点，就是对于用户自定义 RW/ZI 段或者多个分散的 RW/ZI 段无法自动适应，需要根据实际情况不断调整代码实现。

三、__iar_data_init3() 函数实现细节

　　前面铺垫了这么多，终于到了围观 IAR 标准段初始化函数 __iar_data_init3() 实现的时候了，跟这个函数相关的源文件在如下路径下，核心代码在 data_init.c 文件中：

\IAR Systems\Embedded Workbench 9.10.2\arm\src\lib\init\data_init.c

\IAR Systems\Embedded Workbench 9.10.2\arm\src\lib\init\zero_init3.c  - 存放 __iar_zero_init3 函数

\IAR Systems\Embedded Workbench 9.10.2\arm\src\lib\init\copy_init3.c  - 存放 __iar_copy_init3 函数

　　在 data_init.c 文件中有一个叫 IAR_DATA_INIT 的函数，其实它就是 __iar_data_init3，光看这个函数里的代码会让人有点摸不着头脑，因为用了 IAR 链接器里的接口及一些特殊定义，我们结合一个具体应用程序工程来讲解会更清晰。

// 在 IAR 目录 \arm\inc\c\DLib_Product.h 中宏定义

#define _DLIB_ELF_INIT_INTERFACE_VERSION 3

// 在 IAR 目录 \arm\src\lib\init\data_init.h 中的宏定义

#define IAR_DATA_INIT _GLUE(__iar_data_init, _DLIB_ELF_INIT_INTERFACE_VERSION)

#pragma section = "Region$$Table" const TABLE_MEM

void IAR_DATA_INIT(void)

{

    FAddr TABLE_MEM const * pi = __section_begin("Region$$Table");

    table_ptr_t             pe = __section_end  ("Region$$Table");

    while (pi != pe)

    {

        init_fun_t * fun = FAddr_GetPtr(pi);

        ++pi;

        pi = fun(pi);

    }

}

　　我们现在随便编译一个 SDK 例程（痞子衡选择的是 \SDK_2.11.0_MIMXRT1170-EVK\boards\evkmimxrt1170\demo_apps\hello_world\cm7\iar，切到 flexspi_nor_debug build，即代码 RO 段链接在 0x30000000 开始的 Flash 区，代码 RW 段链接在 0x20000000 开始的 DTCM 区），查看其对应映射文件(.map)，摘出其中跟段初始化相关的一些内容如下，初始化工作包含：利用 __iar_zero_init3 函数清零起始地址为 0x20000040 长度为 0x4c 字节的 ZI 段空间，利用 __iar_copy_init3 函数拷贝 0x40 字节 RW 段数据（从 0x300060fc 到 0x20000000）：

*******************************************************************************

*** INIT TABLE

***

          Address      Size

          -------      ----

Zero (__iar_zero_init3)

    1 destination range, total size 0x4c:

          0x2000'0040  0x4c

Copy (__iar_copy_init3)

    1 source range, total size 0x40:

          0x3000'60fc  0x40

    1 destination range, total size 0x40:

          0x2000'0000  0x40

*******************************************************************************

*** ENTRY LIST

***

Entry                       Address   Size  Type      Object

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

.iar.init_table$$Base   0x3000'63d4          --   Gb  - Linker created -

.iar.init_table$$Limit  0x3000'63f8          --   Gb  - Linker created -

Region$$Table$$Base     0x3000'63d4          --   Gb  - Linker created -

Region$$Table$$Limit    0x3000'63f8          --   Gb  - Linker created -

__iar_copy_init3        0x3000'630d   0x2c  Code  Gb  copy_init3.o [6]

__iar_zero_init3        0x3000'613d   0x3c  Code  Gb  zero_init3.o [6]

　　在映射文件里，我们知道了 Region$$Table 区域的起止地址 [0x300063d4 - 0x300063f8)，打开镜像文件或者在线调试找到这段区域里的内容，你会发现段初始化工作所需的全部信息（操作函数地址、操作数据长度、操作源地址、操作目标地址）都记录在里面，其中特别注意的是涉及 Flash 区的地址都是以相对地址来存放的：

Note：FAddr_GetPtr 函数负责地址转换，0x300063d4 地址处的值是 0xfffffd69，那么 0x300063d4 + 0xfffffd69 = 0x13000613d，保留低 32bit 即是 __iar_zero_init3 函数地址。

　　现在我们就很好理解 __iar_data_init3 函数里的代码了，它就是从 Region$$Table 区域里按序取出初始化工作所需的信息，并去一一执行完成段初始化的工作，这种实现方法的优点在于拓展性强，IAR 链接器可根据实际应用程序工程的链接情况自由拓展 Region$$Table 区域里的内容，而 __iar_data_init3 函数本身则不需要做任何修改。

　　至此，IAR启动函数流程里的段初始化函数__iar_data_init3实现痞子衡便介绍完毕了，掌声在哪里~~~

欢迎订阅

文章会同时发布到我的博客园主页、CSDN主页、知乎主页、微信公众号平台上。

微信搜索"痞子衡嵌入式"或者扫描下面二维码，就可以在手机上第一时间看了哦。