瑞芯微(EASY EAI)RV1126B INI文件操作

1. INI文件简介

INI文件时Initialization File的缩写，即初始化文件。INI文件是Windows系统常见的配置文件存储格式，当前也可作为Linux的配置文件。INI文件由节、键、值组成。“节”的表达方式为[Section1 Name]，以中括号“[]”包围起来，它用来表示一个段落的开始，因INI文件可能是整个项目共用的，所以需要使用“节”来区分不同用途的参数区。“键”与“值”的组合表达方式为KeyName=value，以等号“=”分隔。INI文件注释以分号“;”表示，在分号后面的文字直到该行结尾全部作为注解。例程如下所示，注意value值只有int型和string型。

; comment textINI文件的数据格式的例子（配置文件的内容） [Section1 Name] KeyName1=value1 KeyName2=value2 ... [Section2 Name] KeyName21=value21 KeyName22=value22

2. 快速上手

2.1 开发环境准备

如果您初次阅读此文档，请阅读《入门指南/开发环境准备/Easy-Eai编译环境准备与更新》，并按照其相关的操作，进行编译环境的部署。

在PC端Ubuntu系统中执行run脚本，进入EASY-EAI编译环境，具体如下所示。

cd ~/develop_environment ./run.sh 2204

2.2 源码下载以及例程编译

在EASY-EAI编译环境下创建存放源码仓库的管理目录：

cd /opt mkdir EASY-EAI-Toolkit cd EASY-EAI-Toolkit

通过git工具，在管理目录内克隆远程仓库

git clone https://github.com/EASY-EAI/EASY-EAI-Toolkit-1126B.git

注：

* 此处可能会因网络原因造成卡顿，请耐心等待。

* 如果实在要在gitHub网页上下载，也要把整个仓库下载下来，不能单独下载本实例对应的目录。

进入到对应的例程目录执行编译操作，具体命令如下所示：

cd EASY-EAI-Toolkit-1126B/Demos/common-ini/ ./build.sh

注：

* 由于依赖库部署在板卡上，因此交叉编译过程中必须保持/mnt挂载。

2.3 例程运行

通过串口调试或ssh调试，进入板卡后台，定位到例程部署的位置，如下所示：

cd /userdata/Demo/common-ini

运行例程命令如下所示：

./test-iniWrapper

2.4 运行效果

执行效果如下所示。

API的详细说明，以及API的调用（本例程源码），详细信息见下方说明。

3. INI文件API说明

3.1 引用方式

EASY EAI api库位于本仓库的easyeai-api目录中。为方便客户在本地工程中直接调用我们的EASY EAI api库，此处列出工程中需要链接的库以及头文件等，方便用户直接添加。

API源代码路径为EASY-EAI-Toolkit-1126B/easyeai-api/common/ini/。用户可通过源代码了解接口实现，甚至可对源码进行修改。

3.2 INI读取整型数据

函数原型如下所示。

int32_t ini_read_int(const char *file, const char *pcSection, const char *pcKey, int *pVal);

具体介绍如下所示。

3.3 INI写入整型数据

函数原型如下所示。

int32_t ini_write_int(const char *file, const char *pcSection, const char *pcKey, int Val);

具体介绍如下所示。

3.4 INI读取字符串数据

函数原型如下所示。

int32_t ini_read_string(const char *file, const char *pcSection, const char *pcKey, char *pcStr, int len);

具体介绍如下所示。

3.5 INI写入字符串数据

函数原型如下所示。

int32_t ini_write_string(const char *file, const char *pcSection, const char *pcKey, const char *pcStr);

具体介绍如下所示。

4. INI文件操作函数使用案例

使用代码为EASY-EAI-Toolkit-1126B/Demos/common-ini/test-iniWrapper.c，程序逻辑如下所示。