首页 > 代码库 > Lichee (五) sysconfig1.fex 配置系统
Lichee (五) sysconfig1.fex 配置系统
sysconfig配置系统,作为一个通用的软件平台,还希望通过它,可以适应用户不同的方案。通过给出一个对应的配置,用户的方案就可以自动运行,而不需要修改系统里面的代码,或者重新给出参数。
一、 sysconfig1.fex简述
二、 解析过程思路
PC端配置数据的生成
配置脚本本质上是PC端的一个文本文件,通过一个固定的格式形成可以被我们使用的文件,里面保存了大量的配置信息。在图一中,可以看到,PC端的一个数据文件如何变成了小机端可以用到的文件。
图一 小机端配置文件生成
图一中可以看出,当用户生成一个配置文件之后,不需要做额外的操作,只要按照正常的打包,烧写过程,配置文件的数据就自动被嵌入到boot相关的数据中了。
3.2 系统启动的数据传递
在小机端,系统启动之后存在数据传递的过程,这个过程主要是数据从boot中读出,然后存放到操作系统指定的位置。然后操作系统可以自己搬移这块数据,或者直接使用这块和配置有关的数据。相关的处理过程可以参见图二。
图二 配置系统在系统中的流程
从图二中可以看出,boot阶段把数据从boot1.bin中读出,然后传递给了操作系统。操作系统拿到数据之后,做一次初始化动作,然后就一直等待用户进行操作。当系统关机的时候,操作系统需要调用一次配置管理的退出函数,然后,整个配置系统的运行就结束。
3.3 用户调用配置系统的数据传递
当用户调用配置系统的时候,里面存在数据传递。图三表示了用户的数据如何传递到系统,以及系统如何做出相应的。
图三 配置系统使用中数据传递流程
通过图三,用户可以看出,当调用配置相关的函数的时候,系统中以及配置管理模块如何管理用户传入的数据。
三、 关键函数分析
在系统中,提供了如下的几个函数,提供给用户在系统中读取配置信息的数据。
|
这个函数的功能很强大,可以获取配置脚本中任意一项的值。
比如,用户需要获取配置脚本中,主键target下的子键boot_clock的值,可以写成
{ int value; int ret;
ret = Script_parser_fetch(“target”, “boot_clock”, &value, 1); if(ret < 0) printf(“fetch script data fail\n”); else printf(“fetch script data ok, value = http://www.mamicode.com/%d/n”, value);
return ret; } |
在这个函数中,获取到的值存放在整型变量value中,正常情况下,函数调用的结果是 value = http://www.mamicode.com/406
如果要获取一个配置的GPIO信息,比如twi_para的twi_scl可以使用如下的形式
{ user_gpio_set_t gpio_info[1]; int ret;
ret = Script_parser_fetch(“twi_para”, “twi_scl”, gpio_info, sizeof(user_gpio_set_t)/sizeof(int)); if(ret < 0) printf(“fetch script gpio infomation fail\n”); else printf(“fetch script gpio infomation ok \n”);
return ret; } |
这个函数将把获取到的GPIO信息存放到结构体gpio_info中。用户可以使用这个结果,来调用GPIO管理模块提供的函数。
用户也可以使用脚本函数来获取一个字符串。
比如,存在如下的一个主键和子键项目
[string_test]
string_demo = string:abcdefghijklmn
现在,可以用这个函数来获取出主键string_test的子键string_demo的值。正常情况下,调用如下的函数之后,string_info中保存的值将是“abcdefghijklmn”(没有引号)。
{ char string_info[128]; int ret;
memset(string_info, 0, 128); ret = Script_parser_fetch(“string_test”, “string_demo”, string_info, 128/sizeof(int)); if(ret < 0) printf(“fetch script string infomation fail\n”); else printf(“fetch script string infomation ok \n”);
return ret; } |
获取子键个数
函数原型:int Script_parser_subkey_count(char *main_name); 参数: main_name 主键名称,即配置脚本中的主键名称,字符串形式
返回值: 成功返回 主键下的子键个数 失败返回 -1 |
这个函数返回的是一个主键下所有的子键的个数,通常用户不会关心它。这个函数更大的用途还在于做检查。
{ int sub_key_count;
sub_key_count = Script_parser_subkey_count (“target”); if(sub_key_count < 0) printf(“fetch script sub key count fail\n”); else printf(“fetch script sub key count ok , sub_key_count = %d\n”, sub_key_count);
return sub_key_count; } |
调用如上的函数,将获取到主键target下的所有子键的个数,即得到数值4。
获取主键个数
函数原型:int Script_parser_mainkey_count(void);
参数:无 返回值: 成功返回 配置脚本中主键的总的个数 失败返回 -1 |
这个函数将获取所有主键的个数,和Script_parser_subkey_count一样,主要用途还是做检查使用。
{ int main_key_count;
main_key_count = Script_parser_mainkey_count(); if(main_key_count < 0) printf(“fetch script sub key count fail\n”); else printf(“fetch script main key count ok , main_key_count = %d\n”, main_key_count);
return main_key_count; } |
调用如上的函数,将获取到配置脚本中主键的个数。
函数原型:int Script_parser_mainkey_get_gpio_count(char *main_name);
参数:main_name 配置脚本中主键的名称,字符串形式 返回值: 成功返回 配置脚本中主键下的,数据GPIO类型的子键个数 失败返回 -1 |
获取主键下GPIO个数
这个函数的调用将得到主键下的子键中,值属于GPIO类型的子键个数。
比如,当获取twi_para下的子键中的GPIO类型时,将获取到数值2。
{ int gpio_key_count;
gpio_key_count = Script_parser_mainkey_get_gpio_count (“twi_para”); if(gpio_key_count < 0) printf(“fetch script sub key count fail\n”); else printf(“fetch script gpio key count ok , gpio_key_count = %d\n”, gpio_key_count);
return gpio_key_count; } |
如果把上面函数的参数twi_para替换成target,则得到的将是0。如果把上面函数的参数twi_para替换成nand_para,则得到的将是23。
获取主键下GPIO配置
这个函数将获取一个主键下,所有属于GPIO的子键的GPIO描述值。
|
调用这个函数,将把配置脚本中匹配主键名称的,属于GPIO类型的子键的个数。
{ user_gpio_set_t gpio_info[2]; int ret;
ret = Script_parser_mainkey_get_gpio_cfg(“twi_para”,gpio_info, 2); if(ret < 0) printf(“fetch script gpio infomation fail\n”); else printf(“fetch script gpio infomation ok \n”);
return ret; } |