【分享开发笔记，参考 RT-thread 的方式管理初始化函数调用

编码文章call10242025-04-21 22:37:475A⁺A^-

简介

在RT-thread 代码中对初始化代码部分是可以自动的进行初始化操作，而不需要进行手动的调用初始化接口。我们可以参照其代码实现将我们的代码初始化部分使用自动初始化的方式来实现。自动初始化的原理是将初始话函数指针放到一个特定的section（容器）中，让后根据section 的起始和结束地址之间的函数指针进行调用，从而完成初始化函数的自动调用完成初始化。

功能需求

本地初始化按照是否依赖操作系统进行分类可以分为系统相关及非系统相关，类如某些初始化会创建互斥锁来保护互斥访问保护临界区，这种初始话处理需要系统启动后才能进行，不依赖系统相关的初始化系统启动前就可以进行初始化。

自动初始化还需要可以配置初始化的顺序来避免初始化之间有顺序的依赖关系的场景。

代码对应

该功能实现的第一步需要在一个容器内将初始化函数进行统一管理保存，方便统一管理，将这些符号放入到容器统一管理，本地的IAR环境需使section，告诉编译器要将这些符号放在一起统一管理，同时如果这些符号没有被直接调用，需要告诉编译器这些符号需要帮我保留不要擅自优化掉。

在IAR 环境下要将符号保存到section 和保留对应符号要加如下的修饰符。

#define section(x) @ x
#define used __root

IAR 中可以使用@ section_name 来修饰函数及变量，对应说明如下

IAR 中告诉编译器保留对应的符号使用__root 来修饰变量及符号，对应说明如下

使用RT-thread 的声明初始化函数section 定义宏INIT_EXPORT 将函数符号放入特定的section 中

/********************************************************************************************************
* Global Macro definition *
*******************************************************************************************************/
typedef int (*init_fn_t)(void);
#ifdef DEBUGING_AUTO_INIT
struct init_desc
{
const char* fn_name;
const init_fn_t fn;
};
#define INIT_EXPORT(fn, level) \
const char __rti_##fn##_name[] = #fn; \
used const struct init_desc __init_desc_##fn ection(".ini_fn." level) = \
{ __rti_##fn##_name, fn};
#else
#define INIT_EXPORT(fn, level) \
used const init_fn_t __init_##fn section(".ini_fn." level) = fn
#endif

上述宏INIT_EXPORT 宏会定义.init_fn.xx的section,我们之前提到除了需要一个容器对函数进行管理，上面的宏已经可以对函数符号进行容器化的管理，同时我们还需要根据自己的是需求来配置容器内函数的顺序，可以让设置xx 的数值让编译器来帮我们实现指定顺序，编译器会按照符号的命名来进行符号的排序，类如INIT_EXPORT （fn,"1.0"）就会在INIT_EXPORT （fn,"1.1"）的前面我们可以利用该特性来实现容器内的函数排序。

有了上述的认识，我们可以通过定义level “1.xx” 至 "1.end " 区间的函数为非系统依赖的初始化容器，level 2.0 至 levle 6.0 之间的函数为依赖系统的初始化函数，使用rt-thread内的初始化调用函数完成这两个类型的函数初始化处理，对应的自动初始化代码调用如下：

static int rti_start(void)
{
return 0;
}
INIT_EXPORT(rti_start, "0");
static int rti_board_start(void)
{
return 0;
}
INIT_EXPORT(rti_board_start, "0.end");
static int rti_board_end(void)
{
return 0;
}
INIT_EXPORT(rti_board_end, "1.end");
static int rti_end(void)
{
return 0;
}
INIT_EXPORT(rti_end, "6.end");
/**
* @brief Onboard components initialization. In this function, the board-level
* initialization function will be called to complete the initialization
* of the on-board peripherals.
*/
void components_board_init(void)
{
#ifdef DEBUGING_AUTO_INIT
int result;
const struct rt_init_desc *desc;
for (desc = &__rt_init_desc_rti_board_start; desc < &__rt_init_desc_rti_board_end; desc ++)
{
printf("initialize %s", desc->fn_name);
result = desc->fn();
printf(":%d done\n", result);
}
#else
volatile const init_fn_t *fn_ptr;
for (fn_ptr = &__init_rti_board_start; fn_ptr < &__init_rti_board_end; fn_ptr++)
{
(*fn_ptr)();
}
#endif /* DEBUGING_AUTO_INIT */
}
/**
* @brief RT-Thread Components Initialization.
*/
void components_app_init(void)
{
#ifdef DEBUGING_AUTO_INIT
int result;
const struct rt_init_desc *desc;
printf("do components initialization.\n");
for (desc = &__init_desc_rti_board_end; desc < &__init_desc_rti_end; desc ++)
{
printf("initialize %s", desc->fn_name);
result = desc->fn();
printf(":%d done\n", result);
}
#else
volatile const init_fn_t *fn_ptr;
for (fn_ptr = &__init_rti_board_end; fn_ptr < &__init_rti_end; fn_ptr ++)
{
(*fn_ptr)();
}
#endif /* DEBUGING_AUTO_INIT */
}

按照上面level “1.xx” 至 "1.end " 区间的函数为非系统依赖的初始化容器，level 2.0 至 levle 6.0 之间的函数为依赖系统的初始化函数的管理方式，定义如下的初始化函数声明宏来管理初始化调用，暂时只定义三个level 足够我们使用，可以扩展的空间也很大根据实际情况来调整。