瑞芯微(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，程序逻辑如下所示。
