嵌入式固件开发：使用外部文件数据和信号波形初始化 C 数组的最佳实践

学习如何使用外部文本文件初始化 C 语言数组

本指南讲解如何在 C 程序中使用存储在独立文本文件中的数据填充数组。这些值不嵌入源代码，而是在编译时加载。内容涵盖一维和多维数组，展示如何控制数组驻留在 RAM 还是非易失性存储器，并演示如何在多个数据文件中选择初始化源。

示例针对 32 位 ARM 微控制器，使用 GCC 编译。所有代码片段采用标准 C，兼容该编译器。

数组初始化基础

在 C 语言中声明数组时，可在花括号内提供初始值列表（称为初始化项）。例如：

若省略方括号内的大小，编译器会根据初始化项数量推断。如果声明的数组大于初始化列表，剩余元素默认为零。提供的初始化项超过声明大小会触发编译错误。

空白字符处理

初始化项间用逗号分隔，可自由添加空格、制表符、换行符、回车符、垂直制表符或换页符。C 语言允许语句跨多行，这对可能占据数页源代码的大型数组特别有用。

从文件初始化数组

C 预处理器可使用 #include 指令包含任意文本文件。此功能不限于头文件或源文件；任何纯文本文件均可。包含数字、逗号和空白字符的简单文件可用于初始化数组：

被包含文件必须是纯文本——无富文本格式、标题或其他附加内容。用 Windows 记事本创建的示例如下：

编译后，数组在内存中如调试器截图所示。此例中数组驻留在 RAM，“Location”列的高地址表明这一点。

将数组存储在非易失性存储器并选择数据文件

上例中数组为无显式放置的全局变量。编译器假设其运行时可修改，故置于 RAM。初始值驻留在非易失性存储器（通常为 Flash），启动例程将其复制到 RAM。若数组真为常量，声明 const 告知编译器仅保留在 Flash，节省宝贵 RAM。下图显示效果：数组“Location”指向低 Flash 地址。

可用 #define 和 #if 指令在编译时切换 RAM/Flash 存储，或选择不同数据文件初始化。以下代码演示编译时选择存储位置：

#if 构造是条件包含的经典示例，根据编译时标志决定是否应用 const 限定符。

同样可条件选择提供初始数据的文件：

大型数组测试验证

为验证技术，使用存储在 CSV 文件中的 10,000 采样噪声波形。下图展示波形，声明演示数据如何融入程序：

原始 CSV 文件每个值后无逗号。使用正则表达式查找/替换（搜索 \R 替换为 ,\R）单次操作给所有 10,000 项添加逗号。

生成的数组在调试器中清晰可见，按每行 100 元素分组。

多维数组

处理二维或三维数据时，记住 C 语言按行优先顺序存储数组。例如 uint16_t test[2][3] 在内存布局为：

[0,0] [0,1] [0,2] [1,0] [1,1] [1,2]

沿最右下标访问连续元素更快，因数据连续。若需两个 1,000 采样向量，声明 test[2][1000] 最大化缓存友好性。

二维数组初始化通常用嵌套花括号分组：

但可省略外层花括号；编译器按左到右填充。会发出警告：initializer 缺少花括号。只要值总数匹配数组大小，即可编译通过。

跨多文件分布数据时，只需按序包含各文件，用一对花括号包裹整个列表：

联合体中初始化数组

union 允许不同类型共享同一内存。例如包含一维向量和二维矩阵的联合体占用同一地址空间：

初始化时，编译器优先填充第一个成员。若顺序反转，可能因初始化列表未完全加括号而警告。在 #include 外层加双层花括号确保正确分组：

数据文件内容如下：

内存中 vector 和 matrix 起始位置相同，调试器截图验证：

你知道其他从单一数值文件初始化多维数组的方法吗？欢迎评论区分享。

额外技巧：字符串初始化

从外部文件初始化字符串要求引号在文件内部。直接在字符串字面量中 #include 会导致编译器报错。应将引号放入文件，按如下方式包含：

生成的字符串驻留 RAM，截图所示：

这些示例为理论性质，适用于任何标准 C 编译器。若遇编译器特定怪癖，请评论区告知。

来源提供。