附录D.5 【园区版】M-Bus 协议设备接入-Rev1.0-20200918

修改记录及版本信息

序号

版本号

修改内容

修改时间

1

Rev1.0

与地产版Rev1.0对齐

2020-09-18

2

Rev1.0

根据设备信息表和点位表更新

2021-01-27

1 xxx 品牌 M-Bus设备支持对接的型号

对接型号支持

TBD

对接类型

TBD

2 M-Bus 设备接入操作

登录AIoT开放平台,选择数字园区引擎下的对应项目的实例,如下图所示:

image.png

点击基础能力-边缘管理-网关管理,点击对应的网关实例右侧的设备集成,如下图所示

image.png

2.1 添加M-Bus协议

在设备集成页面首次集成时需要点击“新增协议”添加协议及设备:

image

在设备集成页面非首次集成时,需点击网关右侧的设置按钮中的“添加协议”:

image

然后,在下拉选择的协议列表中选择“MeterBus(官方)”:

image

点击配置信息,进行连接通道配置

边缘网关接入M-Bus总线的方式有串口和IP两种。

参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页,如下图所示,查看传输方式。如果传输方式IP,则请参照下面的2.1.1节(添加协议:传输方式为IP )添加协议;如果传输方式是UART,则请 参照下面的2.1.2节(添加协议:传输方式为串口)添加协议。如果两个都有的话,则两个协议都需要添加

A9F7F387-BF6E-441A-8AAA-D7EF60FC4578.png

2.1.1 添加协议:传输方式为IP

image.png

通道名称:自定义一个名称,不能与同一协议下的通道重名。输入示例为MBus_IP

配置:如上图所示,需要以JSON格式配置以下参数:

datalink:指定通道模式,此处为IP;

ip_addr: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页设备IP(传输方式为IP时填写)填写。如下面截图所示

port: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页设备端口(传输方式为IP时填写)填写。

输入示例:{"datalink":"IP", "ip_addr":"192.168.0.100", "port":"502" }

33C64A8E-7E72-4F0A-9362-93DF16E5B2CB.png

2.1.2 添加协议:传输方式为串口

image.png

通道名称:自定义一个名称,不能与同一协议下的通道重名。输入示例为MBus_COM

配置:如上图所示,需要以JSON格式配置以下参数:

datalink:指定通道模式,此处为COM;

serial_com: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页串口名(传输方式为UART时填写)填写。如下面截图所示

baud: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页串口波特率(传输方式为UART时填写)填写。

输入示例:{"datalink":"COM", "serial_com":"/dev/ttyUSB0", "baud":"9600" }

16223130-39AD-4377-BBED-4921231FF40E.png

2.2 添加M-Bus设备

2.2.1 添加设备:传输方式为IP

如下图所示,通过点击2.1.1s所建协议MBus_IP右侧的“设置”图标,选择新建设备”

image.png

设备的参数请按下图所示进行配置:

image.png

设备名称:参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页设备IoT编码填写。

设备别名:参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页设备名称填写。

功能定义:用来定义设备的功能,对于M-Bus, 目前选择后续添加

设备配置:勾选“添加配置”,请以JSON格式为设备配置如下参数,输入示例如下:

{

"meter_type":"10",

"address":"19236585321568",

"password_flag":"0",

"report_space":"3000"

}

其中:

meter_type: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页模型名称列后面的数字填写。

例如冷水水表(10H), 则填写10

address: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页设备地址填写

password_flag: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页是否加密传输填写。

例如,否则填0;是则填1

report_space: 参照甲方提供的<楼宇设备信息表>的“M-BUS设备信息表” TAB页点位上报周期填写

"password":"1122334455667788"

l report_space:接入仪表的属性采样周期,大于200的整数,单位是毫秒。

2.2.1.1: 设备点位信息配置:属性

创建好的设备如下图所列,选择右侧的“上云配置”,根据仪表的点位信息为其添加各个功能点。

image

添加属性:

image

名称:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页功能名称填写

标识符:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页功能标识符填写

数据类型:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页数据类型填写

取值范围:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页取值范围填写

步长:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页步长填写

单位:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页单位填写

读写:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页读写标志(属性专用)填写

扩展参数的配置如下图:

image

prop_type、功能定义、数据类型和读写权限的对应关系如下:

prop_type

功能定义

物模型的数据类型

读写权限

0

当前累积流量

float

只读

1

结算日累积流量

float

只读

2

结算日热量

float

只读

3

当前热量

float

只读

4

热功率

float

只读

5

流量

float

只读

6

累积流量

float

只读

7

供水温度

float

只读

8

回水温度

float

只读

9

累计工作时间

int32

只读

10

实时时间

text

只读

11

状态ST0

int32

只读

12

状态ST1

int32

只读

13

阀门状态

enum

读写

14

电池电压状态

bool

只读

2.2.1.2: 设备点位信息配置:服务

image

如上图所示,M-Bus设备的功能定义中增加了对服务的支持,配置参数有:

名称:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页功能名称填写

标识符:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页功能标识符填写

调用方式:参照甲方提供的<楼宇设备点位信息表>的“M-bus设备点位表” TAB页调用方式(服务专用)填写

输入参数:对于特定服务,需要设置输入参数,并且参数的个数和每个参数的标识符和数据类型固定,请参考下面的表格。

输出参数:对于特定服务,需要设置输出参数,并且参数的个数和每个参数的标识符和数据类型固定,请参考下面的表格。

扩展参数配置如下:

image

service_type的取值请根据所需功能定义,按照下表的对应关系进行设置。

服务类型

功能定义

参数

标识符

数据类型

取值范围

参数说明

0

读历史计量数据

输入

month

Int32

1~12

月份

输出

history_data

Float

0~100000000

结算日累计流量

1

写价格表

输入

price_one

float

0~100000

价格一

amount_one

0~100000

用量一

price_two

0~100000

价格二

amount_two

0~100000

用量二

price_three

0~100000

价格三

start_date

1~31

启用日期

输出

2

读价格表

输入

输出

price_one

float

0~100000

价格一

amount_one

0~100000

用量一

price_two

0~100000

价格二

amount_two

0~100000

用量二

price_three

0~100000

价格三

start_date

1~31

启用日期

3

写购入金额

输入

buy_serial

Int32

0~255

购入序列号

buy_money

Float

0~100000

购入金额

输出

4

读购入金额

输入

输出

buy_serial

Int32

0~255

购入序列号

buy_money

Float

0~100000

购入金额

accu_buy_money

0~100000

累计购入金额

balance

0~100000

余额

5

设置密码

输入

password_ver

Int32

0~255

密码版本号

password

Text

16字节

密码

输出

6

设置标准时间

输入

standard_time

Text

"2019/10/21-12:31:15"

标准时间

输出

7

读结算日

输入

输出

settlement_date

Int32

1~31

结算日

8

设置结算日

输入

settlement_date

Int32

1~31

结算日

输出

9

读抄表日

输入

输出

meter_read_date

Int32

1~31

抄表日

10

设置抄表日

输入

meter_read_date

Int32

1~31

抄表日

输出

如上表所示,读抄表日服务设置如下输出参数:

image

参照上面的属性和服务的添加步骤,根据点位需求可以为仪表设备添加多个属性和服务定义。

2.2.2 添加设备:传输方式为串口

如下图所示,通过点击2.1.1s所建协议MBus_COM右侧的“设置”图标,选择新建设备”

image.png

后续设备添加操作,与传输方式为IP类似,请参考2.2.1 进行设备添加。

2.3 部署设备配置

在完成驱动和设备的配置后,点击部署,进行设备配置的协议下发到边缘服务器。如下图所示。

特别提醒:驱动部署时,网关侧对应驱动将重启,该驱动下的所有设备将出现离线后在线。这期间设备不可用,请部署人员提前与甲方沟通部署时间

image

点击部署后可以查看设备配置下发的状态和部署进度。

image

说明:如果某个设备有新更新的配置信息,重新点击部署后,只会下发有改动的设备配置协议,其余未修改的配置信息不会再次下发到边缘服务器,部署的时间根据修改的设备数量有关。