终端-服务器交互协议

@DATE:2014-08-25

@VERSION:1.0.5

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

TCP流分包原理

流(TCPStream)分割成块(TCPBlock),块分为块头(BlockHead)和块体(BlockData),块

大小在块头中定义，接收方根据此大小还原一个块，块体又可称为包(Packet),根据包头

(PacketHead)中信令类型(type)可以区分不同的包。

结构模型如下：

|TCPStream__

|<------------TCPBlock------------>|<----TCPBlock--->|<---------

|<-----Packet------>||<-->|

字节流顺序如下：(,「号表示一个字节「+'号分割每四个字节)

|flag|size|csum|data(packet)|flag|size|csum|data|flag|size|

|snum|type|size|data||pkt2|

块头(BlockHead)结构体

字段长度(字节)含义

flag4分隔符，固定为0X51515151

size4块体大小(不包含块头部分)

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

包头(PacketHead)结构体

字段长度(字节)含义

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

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

size4包大小(包含包头和包体两部分)

终端信令和数据结构

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

1.信今名频.•心跳

信令号:0x00020000

发起方:终端

度收•方.•服务器

前提:终端登录服务器

备注:无回包

包体结构体:无

2.信令名称:物管呼叫室内机

信令号:0x00020001

发■起方.•服务器

接收方:室内机

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID,用于区分呼叫session

3.信令名称:确认物管呼叫室内机

信令号■:0x80020001

发起方:室内机

疫收方.•服务器

前提:物管呼叫室内机

备注:

包体结构体:无

4.信令名称:物管接通室内机

信令号:0x00020002

发品方:服务器

接收方:室内机

前提:确认室内机呼叫物管

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

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

admin_port4物管视频对讲端口

5.信令名称:确认物管接通室内机

信令号:0x80020002

发起方:室内机

■收方.•服务器

前提:物管接通室内机

备注:

包体结构体:

字段长度（字节）含义

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

device_port4室内机视频对讲端口

6.信令名称:物管拒绝室内机

信令号:0x00020003

发起方.•服务器

接收方:室内机

前提:确认室内机呼叫物管

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

7.信令名称:确认物管拒绝室内机

信令号:0x80020003

发起方:室内机

接收方.•服务器

前提:物管拒绝室内机

备注:

包体结构体:无

8.信令名称:物管无应答室内机

信令号:0x00020004

发宓方.•服务器

接收方:室内机

前提:确认室内机呼叫物管

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

9.信令名称:确认物管无应答室内机

信令号:0x80020004

发起方:室内机

■收方.•服务器

前提:物管无应答室内机

备注:

包体结构体:无

10.信令名称:物管挂断室内机

信令号:0x00020005

发起方.•服务器

接收方:室内机

前提:确认物管呼叫室内机||确认室内机呼叫物管

备注:

包体结构体:

字段长度（字节）含义

adminid4物管ID

11.信令名称:确认物管挂断室内机

信令号:0x80020005

发起方:室内机

接收服务器

前提:物管挂断室内机

备注:

包体结构体:无

12.信令名称:室内机呼叫物管

信令号•:0x00020006

发起方:室内机

度收方.•服务器

前提:确认室内机登录服务器

备注:

包体结构体:无

13.信令名称:确认室内机呼叫物管

信令号:0x80020006

发起方.•服务器

接收方:室内机

前提:室内机呼叫物管

备注:

包体结构体:无

14.信令名称:室内机接通物管

信令号:0x00020007

发起方:室内机

夜代方.•服务器

前提:确认物管呼叫室内机

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

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

device_port4室内机视频对讲端口

15.信令名称:确认室内机接通物管

信令号:0x80020007

发起方.•服务器

接收方:室内机

前提:室内机接通物管

备注:

包体结构体:

字段长度（字节）含义

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

admin_port4物管视频对讲端口

16.信令名称:室内机对物管正忙

信令号:0x00020008

发起方:室内机

度代方.•服务器

前提:确认物管呼叫室内机

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

17.信令名称:确认室内机对物管正忙

信令号:0x80020008

发起方.•服务器

接收方:室内机

前提:室内机对物管正忙

备注:

包体结构体:无

18.信令名称:室内机拒绝物管

信令号:0x00020009

发起方:室内机

接收方.：服务器

前提:确认物管呼叫室内机

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

19.信令名称:确认室内机拒绝物管

信令号:0x80020009

发起方.•服务器

接收方:室内机

前提:室内机拒绝物管

备注:

包体结构体:无

20.信令名称:室内机无应答物管

信令号:0X0002000A

发起方:室内机

度收方.•服务器

前提:确认物管呼叫室内机

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

21.信令名称:确认室内机无应答物管

信令号:0X8002000A

发起方.•服务器

接收方:室内机

前提:室内机无应答物管

备注:

包体结构体:无

22.信令名称:室内机挂断物管

信令号:0X0002000B

发起方:室内机

接收方.•服务器

前提:确认物管接通室内机||确认室内机接通物管

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

23.信令名称:确认室内机挂断物管

信令号:0X8002000B

发起方.•服务器

接收方:室内机

前提:室内机挂断物管

备注:

包体结构体:无

24.信令名称:物管接通室外机

信令号:0x00020011

发起方.•服务器

接收方:室外机

前提:确认室外机呼叫物管

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

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

admin_port4物管视频对讲端口

25.信令名称:确认物管接通室外机

信令号:0x80020011

发起方:室外机

及收方.•服务器

前提:物管接通室外机

备注:

包体结构体:

字段长度（字节）含义

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

device_port4室外机视频对讲端口

26.信令名称:物管拒绝室外机

信令号:0x00020012

发起方.•服务器

接收方:室外机

前提:确认室外机呼叫物管

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

27.信令名称:确认物管拒绝室外机

信令号:0x80020012

发起方:室外机

接收方：服务需

前提:物管拒绝室外机

备注:

包体结构体:无

28.信令名称:物管无应答室外机

信令号:0x00020013

发起方.•服务器

接收方I室外机

前提:确认室外机呼叫物管

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

29.信令名称:确认物管无应答室外机

信令号:0x80020013

发起方:室外机

及次方.•服务器

前提:物管无应答室外机

备注:

包体结构体:无

30.信令名称:物管挂断室外机

信令号:0x00020014

发起方.•服务器

接收方:室外机

前提:确认物管接通室外机

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

31.信令名称:确认物管挂断室外机

信令号:0x80020014

发起方:室外机

接收方：隈务器

前提:物管挂断室外机

备注:

包体结构体:无

32.信令名称:物管监视室外机

信令号:0x00020015

发起方.•服务器

接收方:室外机

前提:确认室外机登录服务器

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

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

admin_port4物管视频对讲端口

33.信令名称:确认物管监视室外机

信令号:0x80020015

发起方:室外机

■收方.•服务器

前提:物管监视室外机

备注:

包体结构体:

字段长度（字节）含义

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

device_port4室外机视频对讲端口

34.信令名称:物管关闭监视室外机

信令号:0x00020016

发起方.•服务器

接收方:室外机

前提:确认物管监视室外机

备注:

包体结构体:

字段长度（字节）含义

admin_id4物管ID

35.信令名称:确认物管关闭监视室外机

信令号:0x80020016

发起方:室外机

度收方.•服务器

前提:物管关闭监视室外机

备注:

包体结构体:无

36.信令名称:物管打开室外机

信令号:0x00020017

发起方.•服务器

接收方:室外机

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

备注:

包体结构体:

字段长度（字节）含义

adminjd4物管ID

37.信令名称:确认物管打开室外机

信令号:0x80020017

发起方:室外机

接收0：服务器

前提:物管打开室外机

备注:

包体结构体:无

38.信令名称:室外机呼叫物管

信令号:0x00020018

发起方:室外机

接收方：服务器

前提:确认室外机登录服务器

备注:

包体结构体:无

39.信令名称:确认室外机呼叫物管

信令号:0x80020018

发起方.•服务器

接收方:室外机

前提:室外机呼叫物管

备注:

包体结构体:无

40.信令名称:室外机挂断物管

信令号:0x00020019

发起方:室外机

度欣方.•服务器

前提:确认物管接通室外机

备注:

包体结构体:

字段长度（字节）含义

admin_id4物管ID

41.信令名称:确认室外机挂断物管

信令号:0x80020019

发起方.•服务器

接收方:室外机

前提:室外机挂断物管

备注:

包体结构体:无

42.信令名称:所有物管正忙

信令号:0x00020061

发起方.•服务器

接收方:终端

前提:终端呼叫物管

备注:

包体结构体:无

43.信令名称:确认所有物管正忙

信令号:0x80020061

发起方:终端

接收方：阳务器

前提:所有物管正忙

备注:

包体结构体:无

44.信令名称:添加单张门禁卡

信令号:0x00020062

发起方.•服务器

接收方:终端

前提:终端登录服务器

备注:

包体结构体:

字段长度（字节）含义

cardjd4卡号

contractjd4合同号

45.信令名称:确认添加单张门禁卡

信令号:0x80020062

发起方:终端

接收方：腌务器

前提:添加单张门禁卡

备注:

包体结构体:

字段长度（字节）含义

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

46.信令名称:删除单张门禁卡

信令号:0x00020063

发起方.•服务器

接收方:终端

前提:终端登录服务器

备注:

包体结构体:

字段长度（字节）含义

card_id4卡号

47.信令名称:确认删除单张门禁卡

信令号:0x80020063

发起方:终端

及收方.•服务器

前提:删除单张门禁卡

备注:

包体结构体:

字段长度（字节）含义

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

48.信令名称:删除合同所有门禁卡

信令号:0x00020064

发起方.•服务器

接收方:终端

前提:终端登录服务器

备注:

包体结构体:

字段长度（字节）含义

contractjd4合同号

49.信令名称:确认删除合同所有门禁卡

信令号:0x80020064

发起方:终端

接收方：服条需

前提:删除合同所有门禁卡

备注:

包体结构体:

字段长度（字节）含义

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

50.信令名称:添加所有门禁卡名单

信令号:0x00020065

发起方.•服务器

接收方:终端

前提:终端登录服务器

备注:

包体结构体:

字段长度（字节）含义

all_access_cards以下结构体可一个房间所有合同的可用门禁卡

变长度数组

contractjd4合同号

access_cards4字节可变长该合同下面所有可用门禁卡

度数组

51.信令名称:确认添加所有门禁卡名单

信令号:0x80020065

发起方:终端

接收方：服务需

前提:添加所有门禁卡名单

备注:

包体结构体:

字段长度（字节）含义

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

52.信令名称:合同租金到期提醒

信令号:0x00020081

发起方.•服务器

接收方:室内机

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

contractjd4合同号

action_content32提醒动作

53.信令名称:确认合同租金到期提醒

信令号：Ox

发起方:室内机

度收方••服务器

前提:合同租金到期提醒

备注:

包体结构体:

字段长度（字节）含义

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

54.信令名称:室内机消息

信令号:0x00020082

发起方.•服务器

接收方:室内机

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

time4时间

title32标题

content1024内容

55.信令名称:确认室内机消息

信令号：Ox

发起方:室内机

接收方.•服务器

前提:室内机消息

备注:

包体结构体:

字段长度（字节）含义

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

56.信令名称:室内机紧急警报

信令号:0x00020083

发起方.•服务器

接收方:室内机

前提:确认室内机登录服务器

备注:

包体结构体:无

57.信令名称:确认室内机紧急警报

信令号:Ox

发起方:室内机

■收方.•服务器

前提:室内机紧急警报

备注:

包体结构体:

字段长度（字节）含义

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

58.信令名称:解除室内机紧急警报

信令号:0x00020084

发起方.•服务器

接收方:室内机

前提:确认室内机紧急警报

备注:

包体结构体:无

59.信令名称:确认解除室内机紧急警报

信令号：0X

发起方:室内机

及收方.•服务器

前提:解除室内机紧急警报

备注:

包体结构体:

字段长度（字节）含义

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

60.信令名称:升级室内机软件

信令号:0x00020085

发起方.•服务器

接收方:室内机

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

update_xml1字节可变长升级xml文件内容

度数组

61.信令名称:确认升级室内机软件

信令号：Ox

发起方:室内机

接伐方.•服务器

前提:升级室内机软件

备注:

包体结构体:

字段长度（字节）含义

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

62.信令名称:通过室内机升级无线门锁软件

信令号:0x00020086

发起方.•服务器

接收方:室内机

序提：确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

update_xml1字节可变长升级xml文件内容

度数组

63.信令名称:确认通过室内机升级无线门锁软件

信令号：Ox

发起方:室内机

段收方.•服务器

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

各注:

包体结构体:

字段长度（字节）含义

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

64.信令名称:室内机登录服务器

信令号:0x00020091

发起方:室内机

接收方：服务鞋

前提:室内机在线

备注:

包体结构体:

字段长度（字节）含义

software_version16室内机软件版本

zone_name32苑名称

building_num4楼栋号

unit_num4单元号

room_num4房间号

65.信令名称:确认室内机登录服务器

信令号：Ox

发起方.•服务器

接收方:室内机

前提:室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

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

66.信令名称:室内机获取其他室内机IP

信令号:0x00020092

发起方:室内机

虔收方.•服务器

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

zone_name32苑名称

building_num4楼栋号

unit_num4单元号

room_num4房间号

67.信令名称:确认室内机获取其他室内机IP

信令号：Ox

发起方.•服务器

接收方:室内机

前提:室内机获取其他室内机IP

备注:

包体结构体:

字段长度（字节）含义

iP16对应房间室内机的IP

68.信令名称:室内机向外呼叫记录

信令号:0x00020093

发起方:室内机

接收方.•服务器

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

zone_name32苑名称

building_num4楼栋号

unit_num4单元号

room_num4房间号

start_time4呼叫开始时间

end_time4呼叫结束时间

69.信令名称:确认室内机向外呼叫记录

信令号：Ox

发起服务器

接收方:室内机

前提:室内机向外呼叫记录

备注:

包体结构体:

字段长度（字节）含义

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

70.信令名称:室内机刷卡记录

信令号:0x00020094

发起方:室内机

接收方.•服务器

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

cardjd4卡号

swiping_time4刷卡时间

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

71.信令名称:确认室内机刷卡记录

信令号：Ox

发起方.•服务器

接收方:室内机

前提:室内机刷卡记录

备注:

包体结构体:

字段长度（字节）含义

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

72.信令名称:室内机警告

信令号:0x00020095

发起方:室内机

接收方：服务

前提:确认室内机登录服务器

备注:

包体结构体:

字段长度（字节）含义

warning_type4警告类型

warning_time4警告发生时间

73.信令名称:确认室内机警告

信令号:Ox

发起方.•服务器

接收方:室内机

前提:室内机警告

备注:

包体结构体:

字段长度（字节）含义

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

74.信令名称;所有室内机IP信息文件MD5

信令号:0X000200A1

发起方.•服务器

接收方:室外机

前提:确认室外机登录服务器

备注:

包体结构体:无

75.信令名称:确认所有室内机IP信息文件MD5

信令号:0X800200A1

发起方:室外机

接收方：脓务器

前提:所有室内机IP信息文件MD5

备注:

包体结构体:

字段长度（字节）含义

md532室外机缓存的roomjnfo文件MD5

76.信令名称:更新所有室内机IP信息文件

信令号:0x000200A2

发起方.•服务器

接收方:室外机

前提:确认室外机登录服务器

备注:

包体结构体:

字段长度（字节）含义

xml_data1字节可变长roomjnfo文件内容

度数组

77.信今名欷.•确认更新所有室内机IP信息文件

信令号:0X800200A2

发起方:室外机

度收方.•服务器

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

备注:

包体结构体:

字段长度（字节）含义

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

78.信令名称:升级室外机软件

信令号:0X000200A3

发起方.•服务器

接收方:室外机

前提:确认室外机登录服务器

备注:

包体结构体:

字段长度（字节）含义

update_xml1字节可变长升汲xml文件内容