「终端---服务器」交互协议

DATE: 2014-08-25VERSION: 1.0.5所有TCP字节流按照网络序传输TCP流分包原理流（TCP Stream）分割成块（TCP Block），块分为块头（Block Head）和块体（Block Data）， 块大小在块头中定义，接收方根据此大小还原一个块，块体又可称为包（Packet），根据包头（Packet Head）中信令类型（type）可以区分不同的包。结构模型如下：块头（Block Head）结构体字段长度（字节）含义flag4分隔符，固定为0Xsize4块体大小（不包含块头部分）checksum4块体检验和，检验算法参见后面部分包头（Packet Head）结构体字段长度（字节）含义sequence_number4包序号，用于收到回包时区分不同的发送包type4信令号，用于区分不同类型的包size4包大小（包含包头和包体两部分）终端信令和数据结构以下终端指的是室内机、室外机等所有终端共用1. 信令名称：心跳信令号：0x发起方：终端接收方：服务器前提：终端登录服务器备注：无回包包体结构体：无2. 信令名称：物管呼叫室内机信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID，用于区分呼叫session3. 信令名称：确认物管呼叫室内机信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无4. 信令名称：物管接通室内机信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管IDadmin_ip16物管视频对讲IP，IP为字符串形式admin_port4物管视频对讲端口5. 信令名称：确认物管接通室内机信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义device_ip16室内机视频对讲IP，IP为字符串形式device _port4室内机视频对讲端口6. 信令名称：物管拒绝室内机信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID7. 信令名称：确认物管拒绝室内机信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无8. 信令名称：物管无应答室内机信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID9. 信令名称：确认物管无应答室内机信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无10. 信令名称：物管挂断室内机信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found. | Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID11. 信令名称：确认物管挂断室内机信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无12. 信令名称：室内机呼叫物管信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无13. 信令名称：确认室内机呼叫物管信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：无14. 信令名称：室内机接通物管信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管IDdevice _ip16室内机视频对讲IP，IP为字符串形式device _port4室内机视频对讲端口15. 信令名称：确认室内机接通物管信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_ip16物管视频对讲IP，IP为字符串形式admin_port4物管视频对讲端口16. 信令名称：室内机对物管正忙信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID17. 信令名称：确认室内机对物管正忙信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：无18. 信令名称：室内机拒绝物管信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID19. 信令名称：确认室内机拒绝物管信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：无20. 信令名称：室内机无应答物管信令号：0xA发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID21. 信令名称：确认室内机无应答物管信令号：0xA发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：无22. 信令名称：室内机挂断物管信令号：0xB发起方：室内机接收方：服务器前提：Error! Reference source not found. | Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID23. 信令名称：确认室内机挂断物管信令号：0xB发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：无24. 信令名称：物管接通室外机信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管IDadmin_ip16物管视频对讲IP，IP为字符串形式admin_port4物管视频对讲端口25. 信令名称：确认物管接通室外机信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义device_ip16室外机视频对讲IP，IP为字符串形式device _port4室外机视频对讲端口26. 信令名称：物管拒绝室外机信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID27. 信令名称：确认物管拒绝室外机信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无28. 信令名称：物管无应答室外机信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID29. 信令名称：确认物管无应答室外机信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无30. 信令名称：物管挂断室外机信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID31. 信令名称：确认物管挂断室外机信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无32. 信令名称：物管监视室外机信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管IDadmin_ip16物管视频对讲IP，IP为字符串形式admin_port4物管视频对讲端口33. 信令名称：确认物管监视室外机信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义device_ip16室外机视频对讲IP，IP为字符串形式device _port4室外机视频对讲端口34. 信令名称：物管关闭监视室外机信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID35. 信令名称：确认物管关闭监视室外机信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无36. 信令名称：物管打开室外机信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found. | Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID37. 信令名称：确认物管打开室外机信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无38. 信令名称：室外机呼叫物管信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无39. 信令名称：确认室外机呼叫物管信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：无40. 信令名称：室外机挂断物管信令号：0x发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义admin_id4物管ID41. 信令名称：确认室外机挂断物管信令号：0x发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：无42. 信令名称：所有物管正忙信令号：0x发起方：服务器接收方：终端前提：终端呼叫物管备注：包体结构体：无43. 信令名称：确认所有物管正忙信令号：0x发起方：终端接收方：服务器前提：Error! Reference source not found.备注：包体结构体：无44. 信令名称：添加单张门禁卡信令号：0x发起方：服务器接收方：终端前提：终端登录服务器备注：包体结构体：字段长度（字节）含义card_id4卡号contract_id4合同号45. 信令名称：确认添加单张门禁卡信令号：0x发起方：终端接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）46. 信令名称：删除单张门禁卡信令号：0x发起方：服务器接收方：终端前提：终端登录服务器备注：包体结构体：字段长度（字节）含义card_id4卡号47. 信令名称：确认删除单张门禁卡信令号：0x发起方：终端接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）48. 信令名称：删除合同所有门禁卡信令号：0x发起方：服务器接收方：终端前提：终端登录服务器备注：包体结构体：字段长度（字节）含义contract_id4合同号49. 信令名称：确认删除合同所有门禁卡信令号：0x发起方：终端接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）50. 信令名称：添加所有门禁卡名单信令号：0x发起方：服务器接收方：终端前提：终端登录服务器备注：包体结构体：字段长度（字节）含义all_access_cards以下结构体可变长度数组一个房间所有合同的可用门禁卡contract_id4合同号access_cards4字节可变长度数组该合同下面所有可用门禁卡51. 信令名称：确认添加所有门禁卡名单信令号：0x发起方：终端接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）52. 信令名称：合同租金到期提醒信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义contract_id4合同号action_content32提醒动作53. 信令名称：确认合同租金到期提醒信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）54. 信令名称：室内机消息信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义time4时间title32标题content1024内容55. 信令名称：确认室内机消息信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）56. 信令名称：室内机紧急警报信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：无57. 信令名称：确认室内机紧急警报信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）58. 信令名称：解除室内机紧急警报信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：无59. 信令名称：确认解除室内机紧急警报信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）60. 信令名称：升级室内机软件信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义update_xml1字节可变长度数组升级xml文件内容61. 信令名称：确认升级室内机软件信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）62. 信令名称：通过室内机升级无线门锁软件信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义update_xml1字节可变长度数组升级xml文件内容63. 信令名称：确认通过室内机升级无线门锁软件信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）64. 信令名称：室内机登录服务器信令号：0x发起方：室内机接收方：服务器前提：室内机在线备注：包体结构体：字段长度（字节）含义software_version16室内机软件版本zone_name32苑名称building_num4楼栋号unit_num4单元号room_num4房间号65. 信令名称：确认室内机登录服务器信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）66. 信令名称：室内机获取其他室内机IP信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义zone_name32苑名称building_num4楼栋号unit_num4单元号room_num4房间号67. 信令名称：确认室内机获取其他室内机IP信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义ip16对应房间室内机的IP68. 信令名称：室内机向外呼叫记录信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义zone_name32苑名称building_num4楼栋号unit_num4单元号room_num4房间号start_time4呼叫开始时间end_time4呼叫结束时间69. 信令名称：确认室内机向外呼叫记录信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）70. 信令名称：室内机刷卡记录信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义card_id4卡号swiping_time4刷卡时间access_result4刷卡结果（0成功，其他失败，失败码另定）71. 信令名称：确认室内机刷卡记录信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）72. 信令名称：室内机警告信令号：0x发起方：室内机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义warning_type4警告类型warning_time4警告发生时间73. 信令名称：确认室内机警告信令号：0x发起方：服务器接收方：室内机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）74. 信令名称：所有室内机IP信息文件MD5信令号：0xA1发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：无75. 信令名称：确认所有室内机IP信息文件MD5信令号：0xA1发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义md532室外机缓存的room_info文件MD576. 信令名称：更新所有室内机IP信息文件信令号：0xA2发起方：服务器接收方：室外机前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义xml_data1字节可变长度数组room_info文件内容77. 信令名称：确认更新所有室内机IP信息文件信令号：0xA2发起方：室外机接收方：服务器前提：Error! Reference source not found.备注：包体结构体：字段长度（字节）含义result4结果（0成功，其他失败，失败码另定）78. 信令名称：升级室外机软件信令号：0xA3发起方：服务器接收方：室外机前提：Error! Reference source not f