终端服务器交互协议docx.docx

终端服务器交互协议docx.docx

《终端服务器交互协议docx.docx》由会员分享，可在线阅读，更多相关《终端服务器交互协议docx.docx（32页珍藏版）》请在冰豆网上搜索。

终端服务器交互协议docx

@DATE:

2014-08-25

@VERSION:

1.0.5

所有TCP字节流按照网络序传输

TCP流分包原理

流（TCPStream）分割成块（TCPBlock），块分为块头（BlockHead）和块体（BlockData），块大小在块头中定义，接收方根据此大小还原一个块，块体又可称为包（Packet），根据包头（PacketHead）中信令类型（type）可以区分不同的包。

结构模型如下：

块头（BlockHead）结构体

字段

长度（字节）

含义

flag

4

分隔符，固定为0X51515151

size

4

块体大小（不包含块头部分）

checksum

4

块体检验和，检验算法参见后面部分

包头（PacketHead）结构体

字段

长度（字节）

含义

sequence_number

4

包序号，用于收到回包时区分不同的发送包

type

4

信令号，用于区分不同类型的包

size

4

包大小（包含包头和包体两部分）

终端信令和数据结构

以下「终端」指的是室内机、室外机等所有终端共用

1.信令名称：

心跳

信令号：

0x00020000

发起方：

终端

接收方：

服务器

前提：

终端登录服务器

备注：

无回包

包体结构体：

无

2.信令名称：

物管呼叫室内机

信令号：

0x00020001

发起方：

服务器

接收方：

室内机

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID，用于区分呼叫session

3.信令名称：

确认物管呼叫室内机

信令号：

0x80020001

发起方：

室内机

接收方：

服务器

前提：

物管呼叫室内机

备注：

包体结构体：

无

4.信令名称：

物管接通室内机

信令号：

0x00020002

发起方：

服务器

接收方：

室内机

前提：

确认室内机呼叫物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

admin_ip

16

物管视频对讲IP，IP为字符串形式

admin_port

4

物管视频对讲端口

5.信令名称：

确认物管接通室内机

信令号：

0x80020002

发起方：

室内机

接收方：

服务器

前提：

物管接通室内机

备注：

包体结构体：

字段

长度（字节）

含义

device_ip

16

室内机视频对讲IP，IP为字符串形式

device_port

4

室内机视频对讲端口

6.信令名称：

物管拒绝室内机

信令号：

0x00020003

发起方：

服务器

接收方：

室内机

前提：

确认室内机呼叫物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

7.信令名称：

确认物管拒绝室内机

信令号：

0x80020003

发起方：

室内机

接收方：

服务器

前提：

物管拒绝室内机

备注：

包体结构体：

无

8.信令名称：

物管无应答室内机

信令号：

0x00020004

发起方：

服务器

接收方：

室内机

前提：

确认室内机呼叫物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

9.信令名称：

确认物管无应答室内机

信令号：

0x80020004

发起方：

室内机

接收方：

服务器

前提：

物管无应答室内机

备注：

包体结构体：

无

10.信令名称：

物管挂断室内机

信令号：

0x00020005

发起方：

服务器

接收方：

室内机

前提：

确认物管呼叫室内机||确认室内机呼叫物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

11.信令名称：

确认物管挂断室内机

信令号：

0x80020005

发起方：

室内机

接收方：

服务器

前提：

物管挂断室内机

备注：

包体结构体：

无

12.信令名称：

室内机呼叫物管

信令号：

0x00020006

发起方：

室内机

接收方：

服务器

前提：

确认室内机登录服务器

备注：

包体结构体：

无

13.信令名称：

确认室内机呼叫物管

信令号：

0x80020006

发起方：

服务器

接收方：

室内机

前提：

室内机呼叫物管

备注：

包体结构体：

无

14.信令名称：

室内机接通物管

信令号：

0x00020007

发起方：

室内机

接收方：

服务器

前提：

确认物管呼叫室内机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

device_ip

16

室内机视频对讲IP，IP为字符串形式

device_port

4

室内机视频对讲端口

15.信令名称：

确认室内机接通物管

信令号：

0x80020007

发起方：

服务器

接收方：

室内机

前提：

室内机接通物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_ip

16

物管视频对讲IP，IP为字符串形式

admin_port

4

物管视频对讲端口

16.信令名称：

室内机对物管正忙

信令号：

0x00020008

发起方：

室内机

接收方：

服务器

前提：

确认物管呼叫室内机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

17.信令名称：

确认室内机对物管正忙

信令号：

0x80020008

发起方：

服务器

接收方：

室内机

前提：

室内机对物管正忙

备注：

包体结构体：

无

18.信令名称：

室内机拒绝物管

信令号：

0x00020009

发起方：

室内机

接收方：

服务器

前提：

确认物管呼叫室内机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

19.信令名称：

确认室内机拒绝物管

信令号：

0x80020009

发起方：

服务器

接收方：

室内机

前提：

室内机拒绝物管

备注：

包体结构体：

无

20.信令名称：

室内机无应答物管

信令号：

0x0002000A

发起方：

室内机

接收方：

服务器

前提：

确认物管呼叫室内机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

21.信令名称：

确认室内机无应答物管

信令号：

0x8002000A

发起方：

服务器

接收方：

室内机

前提：

室内机无应答物管

备注：

包体结构体：

无

22.信令名称：

室内机挂断物管

信令号：

0x0002000B

发起方：

室内机

接收方：

服务器

前提：

确认物管接通室内机||确认室内机接通物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

23.信令名称：

确认室内机挂断物管

信令号：

0x8002000B

发起方：

服务器

接收方：

室内机

前提：

室内机挂断物管

备注：

包体结构体：

无

24.信令名称：

物管接通室外机

信令号：

0x00020011

发起方：

服务器

接收方：

室外机

前提：

确认室外机呼叫物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

admin_ip

16

物管视频对讲IP，IP为字符串形式

admin_port

4

物管视频对讲端口

25.信令名称：

确认物管接通室外机

信令号：

0x80020011

发起方：

室外机

接收方：

服务器

前提：

物管接通室外机

备注：

包体结构体：

字段

长度（字节）

含义

device_ip

16

室外机视频对讲IP，IP为字符串形式

device_port

4

室外机视频对讲端口

26.信令名称：

物管拒绝室外机

信令号：

0x00020012

发起方：

服务器

接收方：

室外机

前提：

确认室外机呼叫物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

27.信令名称：

确认物管拒绝室外机

信令号：

0x80020012

发起方：

室外机

接收方：

服务器

前提：

物管拒绝室外机

备注：

包体结构体：

无

28.信令名称：

物管无应答室外机

信令号：

0x00020013

发起方：

服务器

接收方：

室外机

前提：

确认室外机呼叫物管

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

29.信令名称：

确认物管无应答室外机

信令号：

0x80020013

发起方：

室外机

接收方：

服务器

前提：

物管无应答室外机

备注：

包体结构体：

无

30.信令名称：

物管挂断室外机

信令号：

0x00020014

发起方：

服务器

接收方：

室外机

前提：

确认物管接通室外机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

31.信令名称：

确认物管挂断室外机

信令号：

0x80020014

发起方：

室外机

接收方：

服务器

前提：

物管挂断室外机

备注：

包体结构体：

无

32.信令名称：

物管监视室外机

信令号：

0x00020015

发起方：

服务器

接收方：

室外机

前提：

确认室外机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

admin_ip

16

物管视频对讲IP，IP为字符串形式

admin_port

4

物管视频对讲端口

33.信令名称：

确认物管监视室外机

信令号：

0x80020015

发起方：

室外机

接收方：

服务器

前提：

物管监视室外机

备注：

包体结构体：

字段

长度（字节）

含义

device_ip

16

室外机视频对讲IP，IP为字符串形式

device_port

4

室外机视频对讲端口

34.信令名称：

物管关闭监视室外机

信令号：

0x00020016

发起方：

服务器

接收方：

室外机

前提：

确认物管监视室外机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

35.信令名称：

确认物管关闭监视室外机

信令号：

0x80020016

发起方：

室外机

接收方：

服务器

前提：

物管关闭监视室外机

备注：

包体结构体：

无

36.信令名称：

物管打开室外机

信令号：

0x00020017

发起方：

服务器

接收方：

室外机

前提：

确认物管接通室外机||确认物管监视室外机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

37.信令名称：

确认物管打开室外机

信令号：

0x80020017

发起方：

室外机

接收方：

服务器

前提：

物管打开室外机

备注：

包体结构体：

无

38.信令名称：

室外机呼叫物管

信令号：

0x00020018

发起方：

室外机

接收方：

服务器

前提：

确认室外机登录服务器

备注：

包体结构体：

无

39.信令名称：

确认室外机呼叫物管

信令号：

0x80020018

发起方：

服务器

接收方：

室外机

前提：

室外机呼叫物管

备注：

包体结构体：

无

40.信令名称：

室外机挂断物管

信令号：

0x00020019

发起方：

室外机

接收方：

服务器

前提：

确认物管接通室外机

备注：

包体结构体：

字段

长度（字节）

含义

admin_id

4

物管ID

41.信令名称：

确认室外机挂断物管

信令号：

0x80020019

发起方：

服务器

接收方：

室外机

前提：

室外机挂断物管

备注：

包体结构体：

无

42.信令名称：

所有物管正忙

信令号：

0x00020061

发起方：

服务器

接收方：

终端

前提：

终端呼叫物管

备注：

包体结构体：

无

43.信令名称：

确认所有物管正忙

信令号：

0x80020061

发起方：

终端

接收方：

服务器

前提：

所有物管正忙

备注：

包体结构体：

无

44.信令名称：

添加单张门禁卡

信令号：

0x00020062

发起方：

服务器

接收方：

终端

前提：

终端登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

card_id

4

卡号

contract_id

4

合同号

45.信令名称：

确认添加单张门禁卡

信令号：

0x80020062

发起方：

终端

接收方：

服务器

前提：

添加单张门禁卡

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

46.信令名称：

删除单张门禁卡

信令号：

0x00020063

发起方：

服务器

接收方：

终端

前提：

终端登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

card_id

4

卡号

47.信令名称：

确认删除单张门禁卡

信令号：

0x80020063

发起方：

终端

接收方：

服务器

前提：

删除单张门禁卡

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

48.信令名称：

删除合同所有门禁卡

信令号：

0x00020064

发起方：

服务器

接收方：

终端

前提：

终端登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

contract_id

4

合同号

49.信令名称：

确认删除合同所有门禁卡

信令号：

0x80020064

发起方：

终端

接收方：

服务器

前提：

删除合同所有门禁卡

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

50.信令名称：

添加所有门禁卡名单

信令号：

0x00020065

发起方：

服务器

接收方：

终端

前提：

终端登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

all_access_cards

以下结构体可变长度数组

一个房间所有合同的可用门禁卡

contract_id

4

合同号

access_cards

4字节可变长度数组

该合同下面所有可用门禁卡

51.信令名称：

确认添加所有门禁卡名单

信令号：

0x80020065

发起方：

终端

接收方：

服务器

前提：

添加所有门禁卡名单

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

52.信令名称：

合同租金到期提醒

信令号：

0x00020081

发起方：

服务器

接收方：

室内机

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

contract_id

4

合同号

action_content

32

提醒动作

53.信令名称：

确认合同租金到期提醒

信令号：

0x80020081

发起方：

室内机

接收方：

服务器

前提：

合同租金到期提醒

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

54.信令名称：

室内机消息

信令号：

0x00020082

发起方：

服务器

接收方：

室内机

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

time

4

时间

title

32

标题

content

1024

内容

55.信令名称：

确认室内机消息

信令号：

0x80020082

发起方：

室内机

接收方：

服务器

前提：

室内机消息

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

56.信令名称：

室内机紧急警报

信令号：

0x00020083

发起方：

服务器

接收方：

室内机

前提：

确认室内机登录服务器

备注：

包体结构体：

无

57.信令名称：

确认室内机紧急警报

信令号：

0x80020083

发起方：

室内机

接收方：

服务器

前提：

室内机紧急警报

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

58.信令名称：

解除室内机紧急警报

信令号：

0x00020084

发起方：

服务器

接收方：

室内机

前提：

确认室内机紧急警报

备注：

包体结构体：

无

59.信令名称：

确认解除室内机紧急警报

信令号：

0x80020084

发起方：

室内机

接收方：

服务器

前提：

解除室内机紧急警报

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

60.信令名称：

升级室内机软件

信令号：

0x00020085

发起方：

服务器

接收方：

室内机

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

update_xml

1字节可变长度数组

升级xml文件内容

61.信令名称：

确认升级室内机软件

信令号：

0x80020085

发起方：

室内机

接收方：

服务器

前提：

升级室内机软件

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

62.信令名称：

通过室内机升级无线门锁软件

信令号：

0x00020086

发起方：

服务器

接收方：

室内机

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

update_xml

1字节可变长度数组

升级xml文件内容

63.信令名称：

确认通过室内机升级无线门锁软件

信令号：

0x80020086

发起方：

室内机

接收方：

服务器

前提：

通过室内机升级无线门锁软件

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

64.信令名称：

室内机登录服务器

信令号：

0x00020091

发起方：

室内机

接收方：

服务器

前提：

室内机在线

备注：

包体结构体：

字段

长度（字节）

含义

software_version

16

室内机软件版本

zone_name

32

苑名称

building_num

4

楼栋号

unit_num

4

单元号

room_num

4

房间号

65.信令名称：

确认室内机登录服务器

信令号：

0x80020091

发起方：

服务器

接收方：

室内机

前提：

室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

66.信令名称：

室内机获取其他室内机IP

信令号：

0x00020092

发起方：

室内机

接收方：

服务器

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

zone_name

32

苑名称

building_num

4

楼栋号

unit_num

4

单元号

room_num

4

房间号

67.信令名称：

确认室内机获取其他室内机IP

信令号：

0x80020092

发起方：

服务器

接收方：

室内机

前提：

室内机获取其他室内机IP

备注：

包体结构体：

字段

长度（字节）

含义

ip

16

对应房间室内机的IP

68.信令名称：

室内机向外呼叫记录

信令号：

0x00020093

发起方：

室内机

接收方：

服务器

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

zone_name

32

苑名称

building_num

4

楼栋号

unit_num

4

单元号

room_num

4

房间号

start_time

4

呼叫开始时间

end_time

4

呼叫结束时间

69.信令名称：

确认室内机向外呼叫记录

信令号：

0x80020093

发起方：

服务器

接收方：

室内机

前提：

室内机向外呼叫记录

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

70.信令名称：

室内机刷卡记录

信令号：

0x00020094

发起方：

室内机

接收方：

服务器

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

card_id

4

卡号

swiping_time

4

刷卡时间

access_result

4

刷卡结果（0成功，其他失败，失败码另定）

71.信令名称：

确认室内机刷卡记录

信令号：

0x80020094

发起方：

服务器

接收方：

室内机

前提：

室内机刷卡记录

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

72.信令名称：

室内机警告

信令号：

0x00020095

发起方：

室内机

接收方：

服务器

前提：

确认室内机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

warning_type

4

警告类型

warning_time

4

警告发生时间

73.信令名称：

确认室内机警告

信令号：

0x80020095

发起方：

服务器

接收方：

室内机

前提：

室内机警告

备注：

包体结构体：

字段

长度（字节）

含义

result

4

结果（0成功，其他失败，失败码另定）

74.信令名称：

所有室内机IP信息文件MD5

信令号：

0x000200A1

发起方：

服务器

接收方：

室外机

前提：

确认室外机登录服务器

备注：

包体结构体：

无

75.信令名称：

确认所有室内机IP信息文件MD5

信令号：

0x800200A1

发起方：

室外机

接收方：

服务器

前提：

所有室内机IP信息文件MD5

备注：

包体结构体：

字段

长度（字节）

含义

md5

32

室外机缓存的room_info文件MD5

76.信令名称：

更新所有室内机IP信息文件

信令号：

0x000200A2

发起方：

服务器

接收方：

室外机

前提：

确认室外机登录服务器

备注：

包体结构体：

字段

长度（字节）

含义

xml_data

1字节可变长度数组

room_info文件内容

77.信令名称：

确认更新所有室内机IP信息文件

信令号：

0x800200A2

发起方：

室外机

接收方