conf_helper.md

---

云配置帮助接口

本接口为采集类应用封装了从云配置服务中加载设备模板的逻辑。帮助用户快速使用云配置服务。

initialize

构造函数

函数原型

function helper:initialize(sys_api, conf, templates_ext, templates_dir, templates_node, devices_node)
end

参数说明

• sys_api 应用系统接口 app.sys
• conf 应用配置数据 (table数据或者{CNF_NAME}.{VERSION}字符串)
• templates_ext 设备模板文件本地存储的扩展名。默认为csv
• templates_dir 设备模板文件本地存储的子目录名。 默认为tpl
• templates_node 应用配置数据中模板列表节点名称。默认为tpls。如果该节点为空，则不进行模板下载。
• devices_node 应用配置数据中设备列表节点名称。默认为devs

备注

1. 当conf为字符串时，helper会从云配置接口获取对应的配置文件，然后使用json格式解析后当作应用配置数据使用。
2. 当conf字符串中不包含version时，如"CNF000000001"，helper会从云配置服务中获取最新版本进行下载

fetch

获取所有设备模板数据文件。

函数原型

function api:fetch(async)
end

参数说明

• async 为true时将开启异步获取模式。

templates

获取已经完成获取的模板列表

函数原型

function api:templates()
end

devices

获取已经完成设备模板的设备列表

函数原型

function api:devices()
end

完整的代码示例

local config = self._conf or {}
--[[
config.devs = config.devs or {
	{ unit = 1, name = 'bms01', sn = 'xxx-xx-1', tpl = 'bms' },
	{ unit = 2, name = 'bms02', sn = 'xxx-xx-2', tpl = 'bms2' }
}
]]--

--- 获取云配置
if not config.devs or config.cnf then
	if not config.cnf then
		config = 'CNF000000002.1' -- loading cloud configuration CNF000000002 version 1
	else
		config = config.cnf .. '.' .. config.ver
	end
end

local helper = conf_helper:new(self._sys, config)
helper:fetch()

self._devs = {}
for _, v in ipairs(helper:devices()) do
	-- initialize your devices
end

--- 获取配置
local conf = helper:config()
conf.channel_type = conf.channel_type or 'socket'
if conf.channel_type == 'socket' then
	conf.opt = conf.opt or {
		host = "127.0.0.1",
		port = 1503,
		nodelay = true
	}
else
	conf.opt = conf.opt or {
		port = "/dev/ttymxc1",
		baudrate = 115200
	}
end
if conf.channel_type == 'socket' then
	client = sm_client(socketchannel, conf.opt, modbus.apdu_tcp, 1)

文件存储

获取完成后文件目录

tpl/
├── CNF000000001_1.cnf
├── TPL000000001_1.csv
├── tpl1.csv
└── tpl2.csv

配置数据

应用配置数据示例(CNF000000001):

{
	"opt": {
		"port": "/dev/ttymxc1",
		"baudrate": 19200
	},
	"tpls": [{
			"id": "TPL000000001",
			"name": "tpl1",
			"ver": 1
		},
		{
			"id": "TPL000000001",
			"name": "tpl2",
			"ver": 1
		}
	],
	"devs": [{
			"addr": 991122334455,
			"name": "s01",
			"sn": "xxx-xx-xx-1",
			"tpl": "tpl1"
		},
		{
			"addr": 112233445566,
			"name": "s02",
			"sn": "xxx-xx-xx-2",
			"tpl": "tpl2"
		}
	],
	"loop_gap": 3000
}