docker版jxTMS使用指南：device的调整

本文讲解4.2版jxTMS对device的调整，整个系列的文章请查看：docker版jxTMS使用指南：4.2版升级内容

docker版本的使用，请参考docker版jxTMS使用指南

4.0版jxTMS的说明，请查看：4.0版升级内容

为了适应拉取模式、数据源和越来越复杂的各种情况，4.2版jxTMS对device和site做了很多细小的调整，其中有些调整属于内部的调整，没必要赘述；但有些调整的影响比较大，需要进行解说。

site的调整

1、addDevice

之前的addDevice是：

def addDevice(self, devName, d):
	self._allDev[devName] = d

4.2版调整为：

def addDevice(self, d):
	self._allDev[d.name()] = d

这是由于笔者用rt-thread基于GD32开发前端串口数据采集器时，MCU上的各种名字，都是写到程序中烧到片子上的，如果要使用设备名来区分的话，那每个站点都需要改程序、重新编译。站点一多，光代码管理就是个问题。

所以呢，最终这些设备是使用各自的类型来打包其采集到的数据的。但这就和之前的addDevice函数有了冲突，所以4.2版jxTMS就调整了addDevice函数。使用MCU来收集数据的站点，就可以通过重载addDevice函数来兼容了：

def addDevice(self, d):
	self._allDev[d.type()] = d

2、receive

之前版本的jxTMS通过mqtt接收的是ascii字符串，但笔者自己在开发数据采集器时自定义了数据包格式：通过TLV（Type-Length-Value）的方式逐一打到包身中。所以接口机收到的就不再是字符串，而是字节数组。

所以站点的默认receive函数调整为：

def receive(self, bsMsg):
    s = str(bsMsg,"utf8")
    ...

同时，增加了一个继承自site的解包型site：site_packet，其重载的receive函数是：

def receive(self, bsMsg):
    #将数据包解码
    p = packet.unPacket(bsMsg)
    #数据包中的所有数据，dict格式
    pau = p.allUnit()
    #该数据包是哪个数据收集器打包的
    pn = p.name()
    if pn == 'stateRep':
        #MCU发送的系统报告
        l = pau.get("level",'warn')
        e = pau.get("event",'stateRep')
        self.setState(pau.get("source"),l,pau.get("state"),e,pau.get("msg"))
    else:
        #pn是设备类型
        d = self.getDev(pn)
        d.receive(pau)

同时其addDevice重载为：

def addDevice(self, d):
	self._allDev[d.type()] = d

3、noSubscribe

站点接收数据的方式现在有了好几种，通过MQTT订阅同名主题只是其中之一，所以给站点属性增加了noSubscribe，如果为True则启动站点时不订阅同名的MQTT主题。

device的调整

device的调整比较多，一些是内部调整，如配合数据源工作的调整，这部分就没必要多说了；还有一些则涉及到外部应用代码，这部分主要包括：

1、构造函数调整为：

def __init__(self, type, name, mySite, conf):

这主要是拉取模式时，各设备需要使用mySite提供的数据源操作接口。同时涉及到很多参数的配置，为了统一，都集中到了conf中。

2、增加了数据保存的控制，这主要是多了两个对象函数：

#设置是否为新数据，True则刚接收到的数据不会保存
def setNewData(self, b)

#设置是否保存数据，True则后继的数据都不保存
def notSaveData(self, b)

这部分调整主要是由于存在一条数据被打包为多条消息的情况，如船用AIS，可以同时有10条数据被拆分，这种情况下，就需要通知当前的数据未更新不要保存与处理。

3、主从站之间的数据同步，这主要是多了三个对象函数：

#从站设置需要同步的时间节点
def setListTime(self, dtfrom, dtto, needSave=False):

#从站清理同步的时间节点
def clearListTime(self):

#根据所设置的同步时间节点获取需同步数据的query
def getQueryByTime(self, limit=15):

这主要是用于两个站点之间的数据同步：采集数据后通过mqtt向主站推送数据。当从站的网络断掉又恢复后，将把中断期间的数据从数据库中读出后再发送给主站。

4、一条数据可以打包到多个消息中；同样，一个消息中也可以捎带多条数据。所以device的receive函数会对接收到的数据进行识别，以支持单条数据【dict】与多条数据【list】的一次性输入

5、可以不配置policy

此前device的配置中需给出policyType，然后设备在初始化时会查找相应的策略类型然后安装相应的策略。

但在某些情况下，如数据源拉取到的数据，已经是dict格式了，此时就没有必要再安装策略进行消息解析、提取与转换了。

所以device就调整为配置了policyType就安装并使用该策略进行消息解析，如果没有则直接将接收到的消息作为数据【dict或list】使用。

policy的调整

上文提到device增加了数据保存的相关函数，同理，policy也要先做出相应的调整以告知device数据解析的情况。

所以policy的receive函数的返回值调整为元组：

(result,newData)
 result：解析结果
 newData：是否为有效结果

参考资料：

jxTMS设计思想

jxTMS编程手册

下面的系列文章讲述了如何用jxTMS开发一个实用的业务功能：

如何用jxTMS开发一个功能

下面的系列文章讲述了jxTMS的一些基本开发能力：

jxTMS的HelloWorld