水价综合改革管理平台与智能电表接口

 

  1. 概述

    为了保证XX市农业水利综合改革管理平台的顺利实施,明确XX水利改革平台与智能电表设备的接口实现方式及接口内容,经与智能电表厂商协商,双方达成一致,共同制定此接口规范。

    本接口规范是XX水利改革平台与智能电表设备之间数据传递的依据。

    本接口规范作为XX水利改革平台与智能电表设备之间接口的依据,规定了目前XX水利改革平台对智能电表设备要求的数据内容。随着用户业务部门对XX水利改革平台要求的扩展和提高,在以后的工作中,会根据智能设备的实际应用情况,以及XX水利改革平台的需求变化情况,对本接口规范进行有效的扩充。本接口规范规定了接口数据内容,明确了接口双方的责任与义务,确定了接口数据的验证规则,对接口双方起约束和指导作用。

  2. 接口方式

  3. 接口逻辑

    接口在逻辑关系上处于XX水利改革平台智能电表设备之间,接口规范规定了数据源设备需提供的数据帧,以及数据帧的内容、接收方式以及接收周期等。

  4. 接口实现

    根据实际情况,XX水利改革平台和智能电表设备的接口主要通过socket通信实现。


  5. 接口协议

    接口通讯协议为TCP,通讯手段为socket(套接字)通信。智能电表通过绑定水利平台提供的服务端IP和端口号与本接口服务进程建立TCP链接,链路通讯协议即TCP协议。接口提供的socket服务始终监听在确定的端口,电表要支持socket客户端技术通过绑定到服务端口的方式按约定的频率访问接口服务。电表发送的链路帧在传输过程中的校验、坏包丢弃等遵循TCP/IP协议。接口按约定的规则解析链路帧,解析的结果以结构化的形式存储主应用数据仓库。

    对接口协议的具体要求:

  • 接口服务平台具备约定的确定的IP和端口号。
  • 电表支持socket通讯,可以绑定IP和端口号访问接口。
  • 电表传输数据格式要与本接口规范约定的格式一致。
  • 必要的验证机制。
  1. 数据传输

    数据传输应支持:

    实时、高效和安全可靠的传送数据;

    断电保存现场来电续传功能;

    传输过程中的差错控制。

  2. 双方责任

  3. 数据发送方

  • 保证按约定的频率访问接口;
  • 保证数据符合约定格式,不发送未知链路帧;
  • 保证数据信息的质量,符合事务要求的完整性;
  • 根据数据接收方提供的报告文件,及时处理情况;
  • 对于本规范中未尽事宜,数据发送方应协助数据接收方协商解决相关

 

  1. 数据接收方

  • 保证接收接口规范规定的相关数据内容。
  • 支持按约定频率接收数据。
  • 对接收的数据提供进行必要的验证,保证接收数据的质量。
  • 遵循本接口规范中规定的验证规则和变更说明。
  1. 数据格式说明

  2. 字节格式

    每字节含8位二进制码,传输时加上一个起始位(0)、一个偶校验位和一个停止位(1)
    11位。其传输序列如图7D0 是字节的最低有效位,D7 是字节的最高有效位。先传低位,后传高位

     

  3. 链路帧格式

    帧是传送信息的基本单元。帧格式如图所示

    说 明

    代 码

    帧起始符

    68H 

    地址域

    A0 

    A1 

    A2 

    A3 

    A4 

    A5 

    数据域

    DATA 

    校验码

    CS 

    结束符

    16H 

    帧起始符 68H

    标识一帧信息的开始,其值为 68H=01101000B

    地址域 A0A5

    地址域由 6 个字节构成,每字节 2 BCD 码,地址长度可达12位十进制数。每块表具有唯一的通信地址。当使用的地址码长度不足 6 字节时,高位用”0“补足 6 字节。地址域传输时低字节在前,高字节在后。

    数据域 DATA

    数据域包括累计量、功率值、状态、用户号、剩余值。

    校验码 CS

    从第一个帧起始符开始到校验码之前的所有各字节的模 256 的和,即各字节二进制算术和,不计超过 256 的溢出值。

    结束符 16H

     

  4. 解析示例

    心跳数据:680100000000000000000000000001000000000000FB16

    解析:

    68                                    //起始符

    010000000000                        //表地址,该表地址为000000000001

    0000000000000001000000000000    //心跳数据域

    6A                                    //校验码

    16                                    //结束符

    灌溉数据:680000000000004601000006190000FFFF20120000FA16

    解析:

    68                                //起始符

    010000000000                    //表地址,此表地址为000000000001

    46010000                        //累计值单位kWh,2位小数,此值为1.46

    061900                            //功率值单位W,正整数,此值为1906

    00                                //数据域标志,00表示灌溉数据,01心跳数据

    FFFF                            //用户号,16进制,此值为65535

    20120000                        //剩余值,单位hWh,2位小数,此值为12.2

    FB                                //校验码

    16                                //结束符

     

  5. 接口内容

  6. 心跳数据

    根据电表脉冲频率(三分钟或定制)自适应接收链路帧并解析入库,同时更新电表实时状态到电表档案库,解析用户刷卡行为将同步数据存入结算信息库。心跳数据记录的是接口接收到的来自智能电表的每一笔数据。

     

    表名:PD_ELE_DETAIL_LIST

    序号

    字段名

    字段类型

    必填

    备注

    1 

    ID

    BIGINT(20)

    N 

    自增序列

    2 

    IOT_CARD

    VARCHAR2(40)

    Y 

    电表编码

    3 

    USER_ID

    VARCHAR2(20)

    Y 

    用户编号

    4 

    CURRENT_STATE

    INT(11)

    Y 

    灌溉状态

    5 

    WATER_COUNT

    DECIMAL(9)

    Y 

    当前电表累计用水量

    6 

    ELE_COUNT

    DECIMAL(9)

    Y 

    当前电表累计用电量

    7 

    ELE_GL

    INT(11)

    Y 

    当前功率

    8 

    USE_TIME

    DATETIME

    Y 

    数据接收

    9 

    CARD_SY

    DECIMAL(9)

    Y 

    用户卡余额

    10

    ELE_ADDR

    VARCHAR2(40)

    Y 

    电表通讯地址

    11

    FLAG

    VARCHAR(4)

    N

    数据类型:00标识灌溉、01标识心跳或结束灌溉

    12

    RECEIVE_DATA

    VARCHAR2(200)

    N 

    收到的链路帧(十六进制)

    13

    LONGITUDE

    VARCHAR2(24)

    Y 

    经度

    14

    LATITUDE 

    VARCHAR2(24)

    Y 

    维度

     

  7. 结算数据

    接口解析到包含用户刷卡行为的链路帧时,将解析的灌溉开始或灌溉结束点对应的电表相关数据存入结算表并进行实时结算。

     

    表名:PD_JSLIST

    序号

    字段名

    字段类型

    必填

    备注

    1 

    ID

    BIGINT(20)

    N 

    自增序列

    2 

    IOT_CARD

    VARCHAR2(40)

    Y 

    电表编码

    3 

    USER_ID

    VARCHAR2(20)

    Y 

    用户编号

    4 

    CURRENT_STATE

    INT(11)

    Y 

    灌溉状态

    5 

    WATER_COUNT

    DECIMAL(9)

    Y 

    本次灌溉用水量

    6 

    START_USER_SY

    DECIMAL(9)

    Y 

    开始灌溉时用户卡余额

    7 

    USER_SY

    DECIMAL(9)

    Y 

    结束灌溉时用户卡余额

    8 

    START_TIME

    DATETIME

    Y 

    灌溉开始

    9 

    WHEN_LONG

    DECIMAL(18)

    Y 

    灌溉时长(分钟)

    10

    DTIME

    DATETIME

    Y 

    灌溉结束

    11

    SETTLEMENT_STATUS

    VARCHAR(4)

    Y

    结算状态 1未结算 2已结算

    12

    ENGRY_COUNT

    DECIMAL(18)

    Y

    用电量

    13

    START_ELE_COUNT

    DECIMAL(9)

    Y 

    开始灌溉时电表累计电量

    14

    END_ELE_COUNT

    DECIMAL(9)

    Y

    结束灌溉时电表累计电量

    15

    TOTAL_WATER_COUNT

    DECIMAL(9)

    Y

    结束灌溉时累计水量

    16

    START_ELE_GL

    INT

    Y

    开始灌溉时用电功率

    17

    END_ELE_GL

    INT

    Y

    结束灌溉时用电功率

    18

    LONGITUDE

    VARCHAR2(24)

    Y 

    经度(预留)

    19

    LATITUDE 

    VARCHAR2(24)

    Y 

    维度(预留)

声明: 除非转自他站(如有侵权,请联系处理)外,本文采用 BY-NC-SA 协议进行授权 | 智乐兔
转载请注明:转自《水价综合改革管理平台与智能电表接口
本文地址:https://www.zhiletu.com/archives-9637.html
关注公众号:智乐兔

赞赏

wechat pay微信赞赏alipay pay支付宝赞赏

上一篇
下一篇

相关文章

在线留言

你必须 登录后 才能留言!

在线客服
在线客服 X

售前: 点击这里给我发消息
售后: 点击这里给我发消息

智乐兔官微