《VTD3000二次开发接口协议V3》由会员分享,可在线阅读,更多相关《VTD3000二次开发接口协议V3(12页珍藏版)》请在金锄头文库上搜索。
1、 VTD3000 二次开发接口协议二次开发接口协议 版本号 Version 3 0 深圳市哈工大交通电子技术有限公司 Shenzhen HIT Traffic Electronic Technology Co Ltd 2011 年年 3 月月 版本更新记录版本更新记录 文件名 VTD3000 二次开发接口协议 适 用 向 VTD3000 客户提供二次开发协议 作 者 李豪 时间 2011 3 7 版本号 3 0 创 建 说 明 与 VTD3000V3 版本匹配 作 者 时间 版本号 修 改 说 明 作 者 时间 版本号 修 改 说 明 II III 目录目录 1 系统概述 4 2 协议分层 4
2、 3 分析仪数据通讯接口 5 3 1 交通流数据 6 3 2 事件实时报警数据 6 3 3 设备故障实时报警数据 7 3 4 校时命令 7 3 5 系统配置下载 7 3 6 数据库参数及FTP 备份配置下载 8 3 7 配置更新应答 8 3 8 设备状态查询 9 3 9 设备状态上传 9 4 数据库通讯接口 9 4 1 统计交通流数据表 9 4 2 事件报警数据表 10 4 3 事件录像数据表 11 4 4 设备故障报警数据表 11 5 联系方式 12 VTD3000二次开发接口协议 1 系统概述系统概述 一套 VTD3000 系统由多台分析仪 一台数据库服务器和一台管理计算机组成 同时 分析
3、仪也可同时用作数据库 VTD3000 系统组成结构如图 1 所示 图 1 系统组成 2 协议分层协议分层 本协议描述 VTD3000 系统中分析仪和管理机之间的通讯方式和通讯接口 方便用户进 行二次开发 管理机与分析仪和数据库之间的通讯和功能接口如图 2 所示 图 2 通讯和功能接口示意图 其中 管理机与分析仪之间的 事件通知 故障报警 和 交通流 属于实时数据 事 件 交通流 录像存储 由分析仪在后台自动完成 历史数据查询 属于统计数据部分 网络通讯的协议分层如下图所示 4 VTD3000二次开发接口协议 TCP IP UDP 应用层 TCP IP UDP 应用层 业 务 设 备 管 理 图
4、 3 协议分层图 3 分析仪数据通讯接口分析仪数据通讯接口 实时数据由分析仪通过网络实时上传 分析仪和管理机之间采用 UDP 协议进行网络通 讯 默认接收端口为 9000 通用的消息格式如下 协议版本协议版本 设备编号设备编号 协议类型协议类型 消息类型消息类型 数据长度数据长度 数据体数据体 1 字节 1 字节 1 字节 1 字节 4 字节 不定长 协议版本 接收方检查此字段 确定发送方采用的协议版本 当前协议版本为 3 设备编号 0 管理机发送到分析仪的消息 1 255 分析仪编号 管理机通过此编号区分所 接收到的消息来源 协议类型 1 检测数据上传 2 配置数据下载 3 设备状态查询 4
5、 设备故障 报警 消息类型 每种类型的协议 可以有多种消息类型 如下表所示 数据长度 消息数据体的长度 不包括消息头和长度 网络序 数据体 根据消息类型不同 数据体内容也不相同 注意 凡是多字节字段 均采用网络序传送 协议类型协议类型 消息类型消息类型 说明说明 1 实时交通流数据 具体的实时交通流信息包含在数据体内 2 交通事件 具体的交通事件信息包含在数据体内 1 3 统计交通流数据 具体的统计交通流信息包含在数据体内 1 系统配置下载 具体的配置信息在数据体内 3 配置更新应答 返回配置更新的结果 8 数据备份配置下载 具体的配置信息在数据体内 9 校时命令下载 管理机校时信息 2 10
6、 时间数据返回 分析仪原来的时间信息 1 设备状态查询 请求当前的设备状态 3 2 设备状态上传 设备状态变化时 可自动上传状态 4 1 设备故障报警 5 VTD3000二次开发接口协议 3 1 3 1 交通流数据 交通流数据 交通流数据包括实时交通流数据和统计交通流数据 实时交通流数据格式如下表所示 默认接收端口为 9101 地 点 编号 地 点 编号 方向方向 车道号车道号 时间时间 速度速度 车长车长 车宽车宽 车型车型 存在 时间 存在 时间 保留保留 1 字节 1 字节 1 字节 16 字节2 字节 2 字节 1 字节 1 字节 4 字节 128字节 地点编号 0 7 分析仪通道号
7、方向 1 8 东 南 西 北 东南 东北 西南 西北 车道号 1 10 时间格式 20100101120000 车辆速度 实际值 10 车长 实际长度 单位为米 10 车宽 实际宽度 单位为米 10 车型 1 为微型 2 为小车 3 为中车 4 为大车 5 为超大车 存在时间 毫秒为单位 统计交通流数据格式如下表所示 默认接收端口为 9101 地点编号地点编号 方向方向 车道号车道号 时间总车流量总平均车速总占有率时间总车流量总平均车速总占有率 平均车长平均车长 1 字节 1 字节1 字节 16 字 节 4 字节 2 字节 1 字节 2 字节 每公里车辆数每公里车辆数 平均车间距平均车间距 排
8、队长度排队长度 车型车型 1数量车型数量车型 2 数量车型数量车型 3 数量数量 4 字节 2 字节 2 字节 4 字节 4 字节 4 字节 车型车型 4 数量数量 车型车型 5 数量数量 保留保留 4 字节 4 字节 128 字节 排队长度 实际排队长度 单位为米 10 总占有率 实际总占有率 100 其他字段定义参考实时交通流 3 2 3 2 事件实时报警数据 事件实时报警数据 事件实时报警数据格式如下表所示 默认接收端口为 9101 地点编号地点编号 方向方向 车道号车道号 起始时间起始时间 结束时间结束时间 事件类型事件类型 1 字节 1字 节 1 字节 16 字节 16 字节 2 字
9、节 事件位置事件位置 x0 事件位置事件位置 y0 事件位置事件位置 x1 事件位置事件位置 y1 事件描述事件描述 2 字节 2 字节 2 字节 2 字节 128 字节 事件类型 按位区分事件 第 1 位 停车 第 2 位 行人 第 3 位 逆行 第 4 位 拥堵 第 5 位 遗落物 第 6 位 烟雾 第 7 位 火焰 第 8 位 超速 第 9 位 低速 第 10 位 变线 6 VTD3000二次开发接口协议 事件位置 产生事件的物体的左上和右下坐标 事件描述 与事件类型相关的一些描述 英文 3 3 3 3 设备故障实时报警数据 设备故障实时报警数据 设备故障实时报警数据格式如下表所示 默认
10、接收端口为 9101 设备类型设备类型 设备编号设备编号 故障类型故障类型 保留保留 1 字节 1 字节 1 字节 128 字节 设备类型 1 视频 故障类型 1 丢失 101 恢复 3 硬盘 故障类型 1 警告 70 2 警告 90 101 正常 5 数据库 故障类型 4 数据库保存失败 3 4 3 4 校时命令 校时命令 该命令是将管理机当前时间下发给分析仪 来校时 管理机做为时间服务器 命令格 式如下表所示 年年 月月 日日 时时 分分 秒秒 保留保留 1 字节 1 字节 1 字节 1 字节 1 字节 1 字节 128 字节 年 2000 此值为当前年份 月 1 12 日 1 31 时
11、0 23 分 0 59 秒 0 59 在校时前 分析仪会将系统的当前时间发送给管理机 数据格式如下表所示 默认接收 端口为 9102 年年 月月 日日 时时 分分 秒秒 保留保留 1 字节 1 字节 1 字节 1 字节 1 字节 1 字节 128 字节 字段含义同 2 9 如果配置失败 年 255 3 5 3 5 系统配置下载 系统配置下载 系统配置下载用于对分析仪进行配置 具体数据格式如下表所示 设备编号设备编号 通道数视频质量通道数视频质量 事件视频长度事件视频长度 预录视频长度预录视频长度 分析仪发送数据端口分析仪发送数据端口 1 字节 1 字节 1 字节 4 字节 4 字节 2 字节
12、分析仪视频服务器端口分析仪视频服务器端口 分析仪视频客户端端口分析仪视频客户端端口 2 字节 2 字节 数据库数据库 IP 数据库用户名数据库用户名 数据库密码数据库密码 24 字节 24 字节 24 字节 管理机管理机 IP 管理机数据接收 端口 管理机数据接收 端口 管理机参数配置 报警接收端口 管理机参数配置 报警接收端口 管理机演示视频接 收端口 管理机演示视频接 收端口 24 字节 2 字节 2 字节 2 字节 7 VTD3000二次开发接口协议 数据接收客户端数数据接收客户端数 数据接收客户端数据接收客户端 1IP 数据接收客户端数据接收客户端 nIP 1 字节 24 字节 24
13、字节 说明 凡是多字节字段 均采用网络序传送 设备编号 同上 从 1 255 添加分析仪时候自动生成 通道数 1 8 由添加的摄像机个数决定 视频质量 1 100 默认 80 事件视频长度 1 600 单位为秒 默认 15 预录视频长度 1 600 单位为秒 默认 15 事件视频长度 预录视频长度 600 分析仪发送数据端口 默认 9100 分析仪视频服务器端口 默认 5050 分析仪视频客户端端口 默认 6050 管理机数据接收端口 默认 9101 管理机配置报警接收端口 默认 9102 管理机演示视频接收端口 默认 9201 数据接收客户端 0 8 默认 0 3 6 3 6 数据库参数及F
14、TP 备份配置下载 数据库参数及FTP 备份配置下载 数据备份配置下载用于对数据库中数据进行备份的相关设置的下载 命令格式如下 FTP服务器地址服务器地址 FTP 目录目录 FTP 用户名用户名 FTP 密码密码 24 字节 24 字节 24 字节 24 字节 管理机管理机 IP 管理机报警端口数据库通讯端口管理机报警端口数据库通讯端口 事件录像保存期限事件录像保存期限 24 字节 2 字节 2 字节 2 字节 数据库表保存期限数据库表保存期限 保留保留 2 字节 128 字节 说明 管理机报警端口和数据库通讯端口为网络序 事件录像保存期限 1 30 单位 天 数据库表保存期限 1 24 单位
15、 月 3 7 3 7 配置更新应答 配置更新应答 当对分析仪进行配置结束后 分析仪会对配置的结果做出回应 数据格式如下表所示 默认接收端口为 9102 结果结果 原因值原因值 原因文本原因文本 1 字节 1 字节 保留 128 字节 保留 结果 0 成功 其它 失败 8 VTD3000二次开发接口协议 3 8 3 8 设备状态查询 设备状态查询 保留保留 128 字节 设备类型 1 摄像机 2 检测器 3 硬盘 4 内存 5 数据库 暂时不用 3 9 3 9 设备状态上传 设备状态上传 分析仪会在设备状态发生改变时上传设备状态 数据格式如下表所示 默认接收端口为 9102 设备类型设备类型 设
16、备状态设备状态 1 字节 共 128 字节 设备类型 1 3111 2 3112 3 3121 4 3122 5 3211 6 3221 7 3311 8 3312 9 3321 10 3322 设备状态 共 128 字节 1 8 摄像机 1 8 状态 9 16 检测器 1 8 状态 17 24 硬盘 1 8 状态 25 32 内存状态 33 40 数据库状态 其他待扩展 说明 字节值为 0 代表未定义或无可查询状态 字节值为 101 代表正常 其他值代表故障 具体定义同设备故障报警中的定义 如果对应设备目前无数目定义 则对应 8 位状态中 只 有第一位可用 4 数据库通讯接口数据库通讯接口 VTD3000 系统数据库中保存有统计交通流数据 事件报警数据和设备故障报警数据 数据库系统采用 MySQL 5 0 22 默认用户名为 user 密码为 szhite 可以通过访问数据库 获得如上信息 数据库录像保存期限可设置 在每月的 22 号建立下月的录像数据表 可以 通过 数据备份配置下载 设置数据库自动备份数据相关参数 数据库中的表分为 4 类 分别是 统计交通流数据表 事件报警数据表