C语言参数管理代码框架-讯息

来源良许Linux   2023-07-03 09:25:37

前言

这一篇主要介绍这次的重大更新变化。


(资料图片仅供参考)

初版的代码在序列化时没有考虑到MCU小容量内存设备,需要一次性完成序列化,内存开销较大等等其他问题。

介绍

红色部分为更新后的重点新特性:

采用表驱动方式统一管理所有参数,包括缺省值、最小值和最大值等

支持定义普通参数,无缺省值、最小值和最大值限制

支持定义普通参数,有缺省值,但无最小值和最大值限制

支持定义普通参数,有缺省值,最小值和最大值限制

采用宏定义快速对参数进行定义、注册和管理

支持已定义变量做为参数进行管理,如全局变量或者结构体成员变量

支持基本类型参数和字符串参数

支持序列化和反序列化操作,可在本地储存设备保存/读取二进制数据

支持键值对的方式储存,即使后期版本迭代对参数表删除/插入数据时也能向下兼容

支持非键值对的方式储存,适合小容量的储存设备,序列化后的数据内容少,但是后期版本迭代对参数表删除或插入数据时不能向下兼容,只有通过在参数表后添加参数才能向下兼容

通过多次读写储存设备分别加载参数和保存参数,更兼容小内存的平台使用(多次调用回调函数处理)

支持在数据加载或保存时当参数当前值不合法(超出范围)触发错误处理回调函数,有上层应用程序决定如何处理(可以恢复默认值)

支持功能配置裁剪

根据不同的平台,可以对部分功能裁剪,或者修改配置适用于不同容量的芯片开发

键值对的方式储存:向下兼容较好

可以选择只支持基本类型的参数储存功能,如字符串类型参数和64位长度的参数可裁剪

支持多种操作:宏命令和函数接口

大部分参数可以通过宏命令完成相关操作,如范围校验等

函数部分可以用于自己实现其他功能使用,如参数显示、参数与上位机交互等

根据不同场景使用不同的方式进行处理

代码示例

定义参数表:

PARAM_DEFINE_DAT(g_test,PARAM_INT16,10);PARAM_DEFINE_DAT_DEF(g_test_2,PARAM_UINT16,20);PARAM_DEFINE_DAT_RANGE(g_test_3,PARAM_DOUBLE,3.15,-10,10);PARAM_DEFINE_STR_RANGE(g_test_str,10,"abcdef",5);PARAM_DEFINE_DAT_RANGE(g_test_4,PARAM_INT8,8,-10,10);PARAM_DEFINE_DAT_RANGE(g_test_5,PARAM_UINT32,620,500,10000);PARAM_DEFINE_DAT_RANGE(g_test_6,PARAM_UINT8,45,5,100);PARAM_DEFINE_DAT_RANGE(g_test_7,PARAM_INT64,5,-542,5450);PARAM_DEFINE_BIND_DAT_RANGE(sg_tTest_test1,PARAM_UINT16,20,10,2000);//为即将绑定的变量定义相关参数信息PARAM_DEFINE_BIND_DAT(sg_tTest_test2,PARAM_FLOAT);//为即将绑定的变量定义相关参数信息,初值为sg_tTest变量定义时的初值PARAM_DEFINE_BIND_STR_RANGE(sg_tTest_str,sizeof(sg_tTest.str),"const-zpc",6);//为即将绑定的变量定义相关参数信息,初值为sg_tTest变量定义时的初值ParamInfo_tsg_ParamTable[]={PARAM_ITEM_DAT(1,g_test,PARAM_ATTR_WR),PARAM_ITEM_DAT_DEF(2,g_test_2,PARAM_ATTR_WR),PARAM_ITEM_DAT_RANGE(3,g_test_3,PARAM_ATTR_WR),PARAM_ITEM_STR_RANGE(4,g_test_str,PARAM_ATTR_WR),PARAM_ITEM_DAT_RANGE(5,g_test_4,PARAM_ATTR_WR),PARAM_ITEM_DAT_RANGE(6,g_test_5,PARAM_ATTR_WR),PARAM_ITEM_DAT_RANGE(7,g_test_6,PARAM_ATTR_WR),PARAM_ITEM_DAT_RANGE(8,g_test_7,PARAM_ATTR_READ),//只读PARAM_ITEM_DAT_RANGE_BIND(9,sg_tTest_test1,sg_tTest.test1,PARAM_ATTR_WR),PARAM_ITEM_DAT_BIND(10,sg_tTest_test2,sg_tTest.test2,PARAM_ATTR_WR),PARAM_ITEM_STR_RANGE_BIND(11,sg_tTest_str,sg_tTest.str,PARAM_ATTR_WR),};

通过宏去操作参数示例片段代码:

//首先需要在头文件声明PARAM_EXTERN_DAT(g_test,PARAM_INT16);PARAM_EXTERN_DAT(g_test_2,PARAM_UINT16);PARAM_EXTERN_DAT(g_test_3,PARAM_DOUBLE);PARAM_EXTERN_STR(g_test_str,10);PARAM_EXTERN_DAT(g_test_4,PARAM_INT8);PARAM_EXTERN_DAT(g_test_5,PARAM_UINT32);PARAM_EXTERN_DAT(g_test_6,PARAM_UINT8);PARAM_EXTERN_DAT(g_test_7,PARAM_INT64);//函数中使用intmain(){//方法一://对参数g_test_6设置新的值50,如果超出限定范围则不处理PARAM_DAT_SET_NEW_VALUE(g_test_6,50,PARAM_NONE);//对参数g_test_6设置新的值50,如果超出限定范围则重置为默认值PARAM_DAT_SET_NEW_VALUE(g_test_6,50,PARAM_DEF);//对参数g_test_6设置新的值150,如果超出限定范围则参数小于最小值则为最小值,参数大于最大值则为最大值PARAM_DAT_SET_NEW_VALUE(g_test_6,150,PARAM_MIN_MAX);//方法二://对参数g_test_6设置新的值50,如果超出限定范围则不处理g_test_6=50;PARAM_DAT_CHECK_RANGE(g_test_6,PARAM_NONE);//对参数g_test_6设置新的值50,如果超出限定范围则重置为默认值g_test_6=50;PARAM_DAT_CHECK_RANGE(g_test_6,PARAM_DEF);//对参数g_test_6设置新的值150,如果超出限定范围则参数小于最小值则为最小值,参数大于最大值则为最大值g_test_6=150;PARAM_DAT_CHECK_RANGE(g_test_6,PARAM_MIN_MAX);}

通过函数去操作参数示例片段代码:

//函数中使用intmain(){PARAM_UINT16_Ttmp;//方法一://对参数g_test_6设置新的值50,如果超出限定范围则不处理tmp=50;Param_SetNewValue(Param_FindParamByParamPtr(&sg_tParamManager,&g_test_u16),&tmp,PARAM_NONE);//对参数g_test_6设置新的值50,如果超出限定范围则重置为默认值tmp=50;Param_SetNewValue(Param_FindParamByParamPtr(&sg_tParamManager,&g_test_u16),&tmp,PARAM_DEF);//对参数g_test_6设置新的值150,如果超出限定范围则参数小于最小值则为最小值,参数大于最大值则为最大值tmp=150;Param_SetNewValue(Param_FindParamByParamPtr(&sg_tParamManager,&g_test_u16),&tmp,PARAM_MIN_MAX);//方法二://对参数g_test_6设置新的值50,如果超出限定范围则不处理g_test_6=50;Param_CheckRange(Param_FindParamByParamPtr(&sg_tParamManager,&g_test_u16),PARAM_NONE);//对参数g_test_6设置新的值50,如果超出限定范围则重置为默认值g_test_6=50;Param_CheckRange(Param_FindParamByParamPtr(&sg_tParamManager,&g_test_u16),PARAM_DEF);//对参数g_test_6设置新的值150,如果超出限定范围则参数小于最小值则为最小值,参数大于最大值则为最大值g_test_6=150;Param_CheckRange(Param_FindParamByParamPtr(&sg_tParamManager,&g_test_u16),PARAM_MIN_MAX);}

序列化 Demo 的结果展示:

#配置最多支持15个参数时加载参数时分多次读取/保存操作打印日志load param:read:[21]->120a002214003833333333333309404a6162636465read:[21]->66000000005108646c020000712d88050000000000save param:save:[3]->120a00save:[3]->221400save:[9]->383333333333330940save:[11]->4a61626364656600000000save:[2]->5108save:[5]->646c020000save:[2]->712dsave:[9]->880500000000000000#配置最多支持15个参数时的序列化内容及长度"键值对序列化":[44]->120a002214003833333333333309404a616263646566000000005108646c020000712d880500000000000000"序列化":[36]->500014003333333333330940675f746573745f360000006c0200002d0500000000000000#配置最多支持256个参数时的序列化内容及长度"键值对序列化":[52]->02010a0002021400080333333333333309400a046162636465660000000001050804066c02000001072d08080500000000000000"序列化":[36]->500014003333333333330940675f746573745f360000006c0200002d0500000000000000#配置最多支持4096个参数时的序列化内容及长度"键值对序列化":[60]->0210000a00022000140008300033333333333309400a400061626364656600000000015000080460006c0200000170002d0880000500000000000000"序列化":[36]->500014003333333333330940675f746573745f360000006c0200002d0500000000000000

审核编辑:汤梓红

热门推荐

猜你喜欢