rerved

终端通信协议

一、消息格式

1.消息头格式

typedefstruct_MSG_HEADER{

unsignedshortusCmd;//消息命令

unsignedshortusVersion;//协议版本

unsignedlongulSessionID;//注册成功后由Server返回，以后的会话都需要携带

unsignedlongulSerial;//由发起消息方生成，递增，返回相同的值

unsignedlongulLength;//消息体长度

unsignedshortusStatus;//成功返回0，其他值请查错误码

unsignedshortusRerved;//保留字

}MSG_HEADER;

2.消息体

通信协议消息是：消息头+消息体；

每个消息请求都必须有一个应答消息，如果没有应答消息或者应答消息表示命令操作失

败；

二、消息命令

#defineMSG_LOGIN_REQ0x0001//终端登录请求

#defineMSG_LOGIN_RESP0x8001//登录应答

#defineMSG_LOGOFF_REQ0x0002//终端登出请求

#defineMSG_LOGOFF_RESP0x8002//登出应答

#defineMSG_KEEPALIVE_REQ0x0003//终端心跳请求

#defineMSG_KEEPALIVE_RESP0x8003//心跳应答

#defineMSG_GET_BASE_REQ0x0004//获取基本参数请求

#defineMSG_GET_BASE_RESP0x8004//获取基本参数应答

#defineMSG_SET_BASE_REQ0x0005//设置基本参数请求

#defineMSG_SET_BASE_RESP0x8005//设置基本参数应答

#defineMSG_SET_SYS_REQ0x0006//设置系统参数请求

#defineMSG_SET_SYS_RESP0x8006//设置系统参数应答

#defineMSG_GET_ANALYSIS_REQ0x0007//获取分析参数请求

#defineMSG_GET_ANALYSIS_RESP0x8007//获取分析参数应答

#defineMSG_SET_ANALYSIS_REQ0x0008//设置分析参数请求

#defineMSG_SET_ANALYSIS_RESP0x8008//设置分析参数应答

#defineMSG_GET_CHN_REQ0x0009//获取通道参数请求

#defineMSG_GET_CHN_RESP0x8009//获取通道参数应答

#defineMSG_SET_CHN_REQ0x0010//设置通道参数请求

#defineMSG_SET_CHN_RESP0x8010//设置通道参数应答

#defineMSG_GET_NET_REQ0x0011//获取网络参数请求

#defineMSG_GET_NET_RESP0x8011//获取网络参数应答

#defineMSG_SET_NET_REQ0x0012//设置网络参数请求

#defineMSG_SET_NET_RESP0x8012//设置网络参数应答

#defineMSG_GET_PT_REQ0x0013//获取平台参数请求

#defineMSG_GET_PT_RESP0x8013//获取平台参数应答

#defineMSG_SET_PT_REQ0x0014//设置平台参数请求

#defineMSG_SET_PT_RESP0x8014//设置平台参数应答

三、消息体说明

1.登录请求

客户端向设备发送登录请求的消息，消息内容如下：

typedefstruct_stLoginRequest{

unsignedintdwDeviceID;//该设备ID

unsignedcharucChanNum;//该设备的视频通道数

unsignedcharucDevType;//设备类型（客户端）

unsignedshortusRerved;//保留

charszUrName[8];//登录用户名

charszPassword[8];//登录密码

}stLoginRequest;

2.登录响应

当设备收到客户端的登录请求后，响应该设备的登录结果；消息内容如下：

typedefstruct_stGeneralResp{

unsignedshortusResult;//结果（0/其他:成功/失败原因）

unsignedshortusRerved;//保留

}stGeneralResp;

3.登出请求

客户端登出时，应向设备发送一个登出请求，消息体为空；

4.登出响应

设备收到客户端登出，对客户端进行登出响应；

5.心跳请求消息

客户端登录设备成功后，在30s之内须向设备发送心跳请求；（设备收到心跳请求后，

立即发送心跳响应，如果设备在规定的时间暂定为30s没有收到心跳响应，则认为该链路出

现故障，断开此链路。）消息内容为空；

6.心跳响应消息

设备收到客户端心跳请求后，立即发送心跳响应；消息内容为空；

7.获取基本参数

服务器向设备发送获取基本参数请求；消息内容为空；

8.获取基本参数响应

typedefstruct_stBaParamResp{

unsignedshortnResult;//结果（0：成功，1：失败）

unsignedshortnRerved;//保留

BASEPARAMstBaParam;//基本参数

}stBaParamResp;

typedefstruct_stBaParam{

chardwDeviceID[7];

charbyFormat;

charszDevName[24];

}BASEPARAM;

9.设置基本参数

服务器向设备发送设置基本参数请求；消息内容为BASEPARAM结构；

8.设置基本参数响应

设备对服务器发送的设置基本参数请求发送响应；消息内容stGeneralResp结构；

9.设置系统参数（系统控制命令）

typedefstruct_stSysParam{

unsignedshortusReboot;//是否重启

unsignedshortnRerved;//保留

}stSysParam;

10.获取分析参数

服务器向设备发送获取分析参数请求；消息内容为空；

11.获取分析参数响应

typedefstruct_stAnalysisParamResp{

unsignedshortnResult;//结果（0：成功，1：失败）

unsignedshortnRerved;//保留

stAnalysisParamparam;//分析参数

}stAnalysisParamResp;

typedefstruct_stAnalysisParam{

unsignedshortusDupcRemoveTimeout;//去重超时时间

unsignedshortusDupcRemoveScore;//去重阀值

unsignedshortusCmpPassScore;//比对通过阀值

unsignedcharucTopPercentCut;//0-100图片顶部切图百分比（为整

数，且不能超过100）

unsignedcharucBottomPercentCut;//图片底部切图百分比（为整数，且

不能超过100）

unsignedcharucDetectThreadCount;//检测线程数

}stAnalysisParam;

12.设置分析参数

服务器向设备发送设置分析参数请求；消息内容为stAnalysisParam结构；

13.设置分析参数响应

设备对服务器发送的设置分析参数请求发送响应；消息内容stGeneralResp结构；

14.获取通道参数

服务器向设备发送获取分析参数请求；消息内容为空；

15.获取通道参数响应

typedefstruct_stChannelParamResp{

unsignedshortnResult;//结果（0：成功，1：失败）

unsignedshortnRerved;//保留

stChannelParamparam[4];//分析参数

}stChannelParamResp;

typedefstruct_stChannelParam{

unsignedintulIP;//通道IP

unsignedshortusPort;//通道端口

unsignedshortusChn;

charszName[32];//通道名称

charszUrName[8];//登录用户名

charszPassword[8];//登录密码

}stChannelParam;

16.设置通道参数

服务器向设备发送设置通道参数请求；消息内容为stAnalysisParam结构；

typedefstruct_stChannelParamReq{

stChannelParamparam[4];//分析参数

}stChannelParamReq;

17.设置通道参数响应

设备对服务器发送的设置通道参数请求发送响应；消息内容stGeneralResp结构；

18.获取网络参数

服务器向设备发送获取网络参数请求；消息内容为空；

19.获取网络参数响应

typedefstruct_stNetworkParamResp{

unsignedshortnResult;//结果（0：成功，1：失败）

unsignedshortnRerved;//保留

stNetworkParamparam;//分析参数

}stNetworkParamResp;

typedefstruct_stNetworkParam{

unsignedintulIP;//终端IP

unsignedshortusPort;//终端监听端口

unsignedintulNetMask;//终端子网掩码

unsignedintulGateway;//网关IP

unsignedintulDNS;

charsz3GUr[32];//登录用户名

charsz3GPwd[32];//登录密码

}stNetworkParam;

20.设置网络参数

服务器向设备发送设置网络参数请求；消息内容为stNetworkParam结构；

21.设置网络参数响应

设备对服务器发送的设置网络参数请求发送响应；消息内容stGeneralResp结构；

22.获取平台参数

服务器向设备发送获取平台参数请求；消息内容为空；

23.获取平台参数响应

typedefstruct_stPlatformParamResp{

unsignedshortnResult;//结果（0：成功，1：失败）

unsignedshortnRerved;//保留

stPlatformParamparam;//分析参数

}stPlatformParamResp;

typedefstruct_stPlatformParam{

unsignedintulIP;//终端IP

unsignedshortusPort;//终端监听端口

charszDevID[7];//终端子网掩码

charszUr[32];//登录用户名

charszPwd[32];//登录密码

}stPlatformParam;

24.设置平台参数

服务器向设备发送设置平台参数请求；消息内容为stPlatformParam结构；

25.设置平台参数响应

设备对服务器发送的设置平台参数请求发送响应；消息内容stGeneralResp结构；