Upload
others
View
33
Download
0
Embed Size (px)
Citation preview
温州市“智慧工地”平台数据共享交换标准(V1.1)
目 录一、建筑工地视频监控11.1功能简介11.2视频设备接口标准11.2.1定义11.2.2通用请求说明21.2.3通用响应说明21.2.4请求/响应案例31.2.5功能41.3流程51.3.1 Web视频查看61.3.2详细功能SDK接口61.3.3初始化61.3.4登陆61.3.5设备资源获取-了解视频是否在线61.3.6视频实时播放71.3.7视频录像81.3.8视频回放81.3.9视频下载91.3.10视频抓图101.3.11云台控制101.4设备添加和数据流转图121.4.1数据流转图121.4.2视频添加注销12二、考勤管理设备132.1功能简介132.2编码132.3 push协议简介132.3.1定义132.3.2通用请求说明142.3.3通用响应说明142.3.4请求/响应案例152.4功能162.4.1流程172.4.2初始化信息交互182.4.3批量下发人员192.4.4批量删除人员192.4.5命令批量回复202.4.6批量下发人脸212.4.7上传考勤记录23三、建筑工地塔吊监测设备243.1功能简介243.2编码253.2.1定义253.2.2设备与服务器通信帧结构设计263.3功能273.3.1流程283.3.2心跳28四、扬尘噪音监测设备294.1功能简介294.1.3编码304.1.4定义304.1.5通讯包结构组成表314.1.6通讯包数据段结构组成314.2通讯编码324.2.1请求案例364.2.2功能364.2.3流程374.2.4心跳交互384.2.5实时数据上传38五、实名制认证设备395.1编码395.1.1定义395.1.2功能395.1.3身份证读取405.2摄像头设备接口415.2.1编码415.2.2定义415.2.3功能415.2.4人脸照片拍摄415.3银行卡读取设备接口425.3.1摘要425.3.2编码425.3.3定义425.3.4功能425.3.5银行卡获取43
设备联网标准细则
一、建筑工地视频监控1.1功能简介
实现视频监控相关信息,展示实时视频数据。集成所有工程项目现场的前端视频监控设备,采集设备数据。通过系统打开前端视频、进行操作、统一管理和代理转发。配套手机 APP 系统,按项目实现查看、云台操作和管理的功能。
1.2视频设备接口标准
视频监控播放接口由“智慧住建”平台向视频播放提供方的接口发起请求,接口采用HTTPGET方式,通过平台用户名、密码、摄像头序列号作为请求参数。视频播放提供方应返回对应的摄像头的视频播放地址,返回的视频流必须为 HTML5兼容的格式(HLS)(提供视频流地址),可以不借助其他插件直接在支持HTML5 标准的浏览器(PC端/移动端)中播放。并且需要提供视频基本控制如:截图、方向控制、录像回放、停止播放、视频下载等多种功能。
1.2.1定义
1.接口的所有参数区分大小写
2.接口名称不区分大小写
3.所有接口需要签名,签名秘钥由平台提供。参数格式为Key=Value&Key=Value,参数Key通过ASCII字符码进行排序后进行MD5加密。加密的时候不含Sign参数(其他不含签名的参数会在描述中说明)。加密字符长度为32位,加密后的字符需转换成小写。
4.MD5加密时需要将SecretKey=${key}放入加密字符串中(需要和参数Key一起排序),${key}值为秘钥,由平台提供。
5.*号参数为必填参数/必返回参数。
6.每个接口都有通用接口中定义的参数,接口额外的参数见每个详细接口参数定义。
1.2.2通用请求说明
参数
类型
长度
描述
SN*
varchar
32
设备序列号
1.2.3通用响应说明
参数
类型
长度
描述
Result
object
响应结果,见每个接口的响应参数
Success
bool
true:响应成功;false:响应失败
Error
Error
当success为false时,会显示错误信息
注:Result为null,并且Success为true场合,表示通讯正常,业务处理数据不存在。
Error:
参数
类型
长度
描述
Code
int
错误代码
Message
varchar
255
错误信息
Details
varchar
255
错误明细
1.2.4请求/响应案例
Get请求案例:
${ServerIP}:${ServerPort}/Attendance/Init? SN=123
Post请求案例:
{
"SN":"123"
}
响应案例:
{
"Result": {
"ErrorDelay": 30,
"Delay": 2,
"OpStamp": 2
},
"Success": true,
"Error": null
}
响应案例(没有业务数据,但是通讯正常):
{
"Result": null,
"Success": true,
"Error": null
}
1.2.5功能
1.设备初始化
2.视频播放
3.视频停止播放、批量停止播放
4.视频截图
5.视频云台控制
6.视频录像、停止录像
7.视频回放、停止回放、恢复回放
8.视频下载、停止下载
9.视频下载进度
10.视频心跳交互
11.视频注销
12.网页视频直接播放
1.3流程
监控平台发起视频操作命令,根据视频设备的不同,跳转不同的厂商,然后由厂商联系设备,设备收到命令后,反馈处理结果到视频厂商,最后反馈到监控平台,直接查看视频。
视频设备同服务器之间的交互流程如下:
1.3.1 Web视频查看
1.提供HLS流直播地址的m3u8文件地址,直接通过该直播地址播放(无插件方式)。
1.3.2详细功能SDK接口1.3.3初始化
初始化:int Device_Init();
释放占用:int Device_Dispose();
1.3.4登陆
登陆:int Device_Login(varchar ip,varchar port,varchar userName,varchar password);
参数
类型
长度
描述
ip
varchar
16
设备ip
port
varchar
5
设备端口
userName
varchar
32
登陆账号
passwor
varchar
32
登陆密码
注销登陆:int Device_Logout();
1.3.5设备资源获取-了解视频是否在线
分页获取设备信息:int Device_GetVideoInfo(int pageCount,int pageNum);
参数
类型
长度
描述
pageCount
int
11
每一页行数
pageNum
int
11
第几页
返回对象(设备列表对象)
OnLineStatus
int
11
标记设备在线状态,对象中包含是否在线状态的标记
在线:1
不在线:0
1.3.6视频实时播放
开始播放:int Device_StartRealPlay(varchar deviceSN,InPtr hWnd);
参数
类型
长度
描述
deviceSN
varchar
32
设备编号
hWnd
InPtr
播放控件指针
停止播放:int Device_StopRealPlay(InPtr hWnd);
参数
类型
长度
描述
hWnd
InPtr
播放控件指针
1.3.7视频录像
开始录像:int Device_StartRecord(varchar deviceSN,varchar fileName);
参数
类型
长度
描述
deviceSN
varchar
32
设备编号
fileName
varchar
500
本地存储路径
结束录像:int Device_StopRcord(varchar deviceSN);
参数
类型
长度
描述
deviceSN
varchar
32
设备编号
1.3.8视频回放
开始回放:int Device_StartPlayback(varchar deviceSN,InPtr hWnd,DateTime beginTime,DateTime endTime);
参数
类型
长度
描述
deviceSN
varchar
32
设备编号
hWnd
InPtr
播放控件指针
beginTime
DateTime
开始时间
endTime
DateTime
结束时间
设置回放速度:int Device_SetPlaybackSpeed(InPtr hWnd,doule speed);
参数
类型
长度
描述
speed
double
11
播放速度
hWnd
InPtr
播放控件指针
停止回放:int Device_StopPlayback(InPtr hWnd);
参数
类型
长度
描述
hWnd
InPtr
播放控件指针
暂停回放:int Device_PausePlayback(InPtr hWnd);
参数
类型
长度
描述
hWnd
InPtr
播放控件指针
继续回放:int Device_ResumePlayback(InPtr hWnd);
参数
类型
长度
描述
hWnd
InPtr
播放控件指针
1.3.9视频下载
视频下载:int Device_StartDownload(varchar deviceSN,DateTime beginTime,DateTime endTime,ProgressCallback callback);
参数
类型
长度
描述
deviceSN
varchar
32
设备编号
Callback
ProgressCallback
播放进度回调
beginTime
DateTime
开始时间
endTime
DateTime
结束时间
停止下载:int Device_StopDownload(varchar deviceSN);
参数
类型
长度
描述
deviceSN
varchar
32
设备编号
1.3.10视频抓图
视频抓图:int Device_CapturePic(InPtr hWnd,varchar fileName);
参数
类型
长度
描述
hWnd
InPtr
播放控件指针
fileName
varchar
500
本地存储路径
1.3.11云台控制
云台控制:int Device_PtzControl(varchar deviceSN,InPtr hWnd,int command,int speed);
参数
类型
长度
描述
deviceSN
varchar
32
设备编号
hWnd
InPtr
播放控件指针
command
Int
5
操作命令:
1:上
2:下
3:左
4:右
5:自动
6:开灯
7:关灯
8:焦距变大
9:焦距变小
10:雨刷
speed
double
11
速度
1.4设备添加和数据流转图1.4.1数据流转图
1.4.2视频添加注销
二、考勤管理设备2.1功能简介
从建筑行业管理的角度对建筑工地从业人员按岗位和工种进行信息化管理,为政府部门加强管理和建筑业企业提升人力资源管理提供支持。
2.2编码
1.使用 UTF-8 编码
2.采用json格式传输数据
2.3 push协议简介
push 协议是基于 HTTP 协议的基础上定义的数据协议,由客户端主动请求服务端。
2.3.1定义
1.接口的所有参数区分大小写
2.接口名称不区分大小写
3.所有接口需要签名,签名秘钥由平台提供。参数格式为Key=Value&Key=Value,参数Key通过ASCII字符码进行排序后进行MD5加密。加密的时候不含Sign参数(其他不含签名的参数会在描述中说明)。加密字符长度为32位,加密后的字符需转换成小写。MD5加密时需要将SecretKey=${key}放入加密字符串中(需要和参数Key一起排序),${key}值为秘钥,由平台提供
4.*号参数为必填参数/必返回参数
5.每个接口都有通用接口中定义的参数,接口额外的参数见每个详细接口参数定义
6.上传数据接口限定10次/秒
2.3.2通用请求说明
参数
类型
长度
描述
SN*
varchar
32
设备序列号
DevKey*
varchar
32
设备Key,由平台提供
Sign*
varchar
32
签名
TimeStamp*
long
时间戳,传接口请求的时间
2.3.3通用响应说明
参数
类型
长度
描述
Result
object
响应结果,见每个接口的响应参数
Success
bool
true:响应成功;false:响应失败
Error
Error
当success为false时,会显示错误信息
注:Result为null,并且Success为true场合,表示通讯正常,业务处理数据不存在。
Error:
参数
类型
长度
描述
Code
int
错误代码
Message
varchar
255
错误信息
Details
varchar
255
错误明细
2.3.4请求/响应案例
Get请求案例:
${ServerIP}:${ServerPort}/Attendance/Init?DevKey=HK&SN=123&TimeStamp=1543285023&Sign=5ddf66186be9921253d8519a60839237
Post请求案例:
{
"SN":"123" ,
"DevKey":"HK",
"TimeStamp":"1543285023",
"Sign": "5ddf66186be9921253d8519a60839237"
}
响应案例:
{
"Result": {
"ErrorDelay": 30,
"Delay": 2,
"OpStamp": 2
},
"Success": true,
"Error": null
}
响应案例(没有业务数据,但是通讯正常):
{
"Result": null,
"Success": true,
"Error": null
}
2.4功能
提供工具软件,实现在考勤机上可配置服务器地址的功能。(可以使用ip的方式或者使用域名的方式)。
从客户端的角度来描述 Push 协议支持的功能:
1.初始化信息交互
2.批量下发人员
3.批量下发人脸
4.批量删除人员
5.命令批量回复
6.上传考勤记录
2.4.1流程
考勤机同服务器之前的交互流程如下:
注:
A:初始化信息交互
B:批量下发人员
C:下发人员命令回复
D:下发人脸命令
E:考勤记录上传
2.4.2初始化信息交互
每次设备启动链接服务端成功发起一次请求,只有此接口响应成功,才继续请求之后的接口,否则每间隔2秒不断请求此接口,直到响应成功。客户端发起请求,将相应的配置信息发送给服务器,服务器接收到该请求,将相应的配置信息回复给客户端,只有当客户端获取到相应的配置信息,才能算交互成功;配置信息交互是按照规定好的格式进行的,具体如下
接口:GET ${ServerIP}:${ServerPort}/Attendance/Init
请求参数:见2.5.2
响应参数:
参数
类型
长度
描述
ErrorDelay*
int
联网失败后客户端重新联接服务器的间隔时间(秒),建议设置 30~300 秒(当前默认:30,后期由服务器指定)
Delay*
int
正常联网时客户端联接服务器的间隔时间(秒) ,即客户端请求“(批量)下发人员/下发人脸/(批量)删除人员”功能,建议设置 2~60 秒,需要快速响应时可设置小点,但是对服务器的压力会变大(当前默认:15,后期由服务器指定)
2.4.3批量下发人员
通过此接口可以添加人员信息或者添加/修改人员的权限接口: GET ${ServerIP}:${ServerPort}/Attendance/DownPersons
请求参数:见2.5.2响应参数:
参数
类型
长度
描述
AttendanceDownPersons*
AttendanceDownPersons[]
下发人员数组对象
AttendanceDownPersons:
参数
类型
长度
描述
Tid*
int
人员唯一id
FullName*
varchar
32
人员名称
Permission
int
权限:0普通权限,1:最高权限
Password
varchar
32
密码
ID*
varchar
32
服务器命令编号,在回复命令接口中传入
2.4.4批量删除人员
在考勤机上删除人员
接口:
GET ${ServerIP}:${ServerPort}/Attendance/DeletePersons
请求参数:见3.5.2响应接口:
参数
类型
长度
描述
AttendanceDelPersons*
AttendanceDelPersons[]
删除人员数组对象
AttendanceDelPersons:
参数
类型
长度
描述
Tid*
int
人员唯一id
ID*
varchar
32
服务器命令编号,在回复命令接口中传入
2.4.5命令批量回复
客户端在获取到服务器下发的命令后,需要对相应的命令进行回复。如果存在批量下发命令,每个命令单独调用此接口
接口:
POST ${ServerIP}:${ServerPort}/Attendance/DeviceCmds
请求参数:
参数
类型
长度
描述
AttendanceCmds*
AttendanceCmds[]
签名不包含该对象
注:签名中不包含SN(考勤机序列号字段),批量接口回复
AttendanceCmds:
参数
类型
长度
描述
ID*
varchar
32
服务器下发命令的编号
Success*
bool
true:响应成功;false:响应失败。签名不需要包含此字段
Error
Error
当Success为false时,会显示错误信息。签名不需要包含此字段
响应参数:见通用响应参数,Result参数为null
2.4.6批量下发人脸
通过此接口可以添加人员人脸或者修改人员人脸信息
接口: GET ${ServerIP}:${ServerPort}/Attendance/DownFaces4Url
请求参数: 见上
响应参数:ArrayList集合
参数
类型
长度
描述
Tid*
int
人员唯一id
FullName*
varchar
32
人员名称
Permission
int
权限:0普通权限,1:最高权限
Password
varchar
32
密码
FaceData*
varchar
200
人脸url
ID*
varchar
32
服务器命令编号,在回复命令接口中传入
Result:[
{
"Tid": 1023,
"FullName": "XXX",
"FaceData": "https://xinleda.oss-cn-hangzhou.aliyuncs.com/local/files/20190515/201905151059594659.jpg",
"Permission": 0,
"Password": null,
"ID": "828"
},
{
"Tid": 1221,
"FullName": "GGG",
"FaceData": " https://xinleda.oss-cn-hangzhou.aliyuncs.com/local/files/20190515/201905151059594659.jpg ",
"Permission": 0,
"Password": null,
"ID": "830"
}
]
2.4.7上传考勤记录
每当人员进行考勤,则实时通知服务端。如果服务端断开链接,当重连服务器之后将考勤重新上传。如果接口响应失败,则需要将失败的考勤记录再次上传。
接口:
POST ${ServerIP}:${ServerPort}/Attendance/UpAttendanceRecord
请求参数:
参数
类型
长度
描述
AttendanceRecords*
varchar
考勤数据集合,需要将AttendanceRecords集合转换为json字符串(签名不需要包含此字段)
AttendanceRecords:
参数
类型
长度
描述
Tid*
int
人员编号
RecordTime*
datetime
打卡时间,格式:(yyyy-MM-dd HH:mm:ss fff)
DutyPhotoData*
varchar
text
base64格式实时考勤照片数据
三、建筑工地塔吊监测设备3.1功能简介
针对政府部门、承建企业、租赁企业所涉及到的工程建设过程中塔吊的使用情况进行监控,主要包括塔吊的实时监测数据,及时反馈并报警;塔吊备案查询等。
3.2编码
特定数据格式传输数据
3.2.1定义
所有上传数据都需要差错检验,差错校验使用和校验方式进行数据校验。
3.2.2设备与服务器通信帧结构设计
设备与服务器通信帧结构如下表所示:
字段
帧头
帧长度
厂家编号
协议版本
帧类型
设备编号
信息段
校验和
帧尾
长度
2bytes
1byte
1byte
1byte
1byte
4bytes
Nbytes
1byte
4bytes
说明
0xA55A
——
——
——
——
——
C33Cc33c
如上表所示,设备与服务器之间通信帧结构包括帧头、帧长度、厂家编号、协议版本、帧类型、设备编号、信息段、校验和以及帧尾。其中,帧头为固定的2个字节(0xA55A);帧长度1个字节,其值为整个包的总长度;厂家编号1个字节;协议版本1个字节,表示本协议的版本,当前值为0x00;帧类型1个字节,其值定义如下表所示;设备编号为该设备出厂时由厂家分配的唯一编号;信息段的字节数n是根据不同的数据帧结构变化的,详见具体帧结构;校验和:从帧第一个字节开始到该字节之前所有字节和的低字节;帧尾为固定的4个字节(0xcc33C33C)。
帧类型:
执行步骤
帧类型
备注
1
设备注册信息上传
00
2
服务注册信息回复
01
3
设备标定信息上传
02
4
服务器信息回复
03
5
设备心跳包上传
04
6
服务器心跳信息回复
05
7
设备实时数据上传
06
8
服务器实时数据回复
07
9
设备工作循环数据上传
08
10
服务器工作循环回复
09
注:所有信息传输时,高字节在前,低字节在后;设备通过注册帧,与后台取得通信连接,后台通过注册帧的回复帧,告知设备当前系统时间以及上传数据的时间周期。现场设备在工作时,则按此周期上传实时工作数据;现场设备在待机时,则按此周期上传心跳包。心跳包用以维持设备与后台之间通信的物理连接,对于心跳包,后台服务仅接收不存储。
3.3功能
在黑匣子设备上需要提供一个可配置服务器地址的功能(可以使用ip的方式或者使用域名的方式)。
从客户端的角度来描述TCP协议支持的功能:
3.3.1流程
3.3.2心跳
设备向服务器端发送心跳帧,使服务器端能够确认设备的在线状态。当服务器端收到心跳帧之后,将返回一个心跳回复帧,心跳回复帧用来维持设备与服务器端的连接。
设备心跳包上传:
字段
帧头
帧长度
厂家编号
协议版本
帧类型
设备编号
信息段
校验和
帧尾
长度
2bytes
1byte
1byte
1byte
1byte
4bytes
0bytes
1byte
4bytes
说明
0xA55A
——
——
——
0x04
——
——
Cc33c33c
服务器心跳信息回复:
字段
帧头
帧长度
厂家编号
协议版本
帧类型
设备编号
信息段
校验和
帧尾
长度
2bytes
1byte
1byte
1byte
1byte
4bytes
0bytes
1byte
4bytes
说明
0xA55A
——
——
——
0x05
——
——
Cc33c33c
设备发送心跳包,节拍是1min/次。
四、扬尘噪音监测设备4.1功能简介
实时采集现场PM2.5、PM10、噪声等相关环境数据并进行现场处置,将现场PM2.5、PM10、噪音数据实时传送至信息管理平台的智能化管控措施。
4.1.3编码
1.使用 UTF-8 编码
2.特定数据格式传输数据
4.1.4定义
1.所有上传数据都需要差错检验,差错校验使用HJ212-2017《中华人民共和国国家环境保护标准》标准来生成差错校验码。
2.通讯协议采用HJ212-2017《污染物在线监控(监测)系统数据传输标准》协议框架,根据系统应用需要对标准进行补充扩展,但扩展内容时与HJ212本标准中所使用或保留的控制命令不冲突。
4.1.5通讯包结构组成表
名称
类型
长度
描述
包头
varchar
2
固定为##
数据段长度
Int
4
数据段的ASCII 字符数,例如:长255,则写为“0255”
数据段
varchar
0≤n≤1024
变长的数据(参照5.3表)
CRC 校验
int
4
数据段的校验结果, 接收到一条命令,如果CRC 错误,执行结束
包尾
varchar
2
固定为(回车、换行)
4.1.6通讯包数据段结构组成
名称
类型
长度
描述
请求编码QN
varchar
20
精确到毫秒的时间戳:QN=YYYYMMDDhhmmsszzz,用来唯一标识一次
命令交互
系统编码ST
varchar
5
ST=系统编码(参照表:系统编码)
命令编码CN
varchar
7
CN=命令编码(参照表:命令编码)
访问密码
varchar
9
PW=访问密码(设备访问密码)
设备唯一标识MN
varchar
27
MN=设备唯一标识,这个标识固化在设备中,用于唯一标识一个设备。
MN 由EPC-96 编码转化的字符串组成,即MN 由24 个0~9,A~F 的字
符组成
Flag
Int
8
Flag=标志位,这个标志位包含标准版本号、是否拆分包、数据是否应答。(目前暂定不需要回复,使用5)
指令参数CP
varchar
0≤n≤950
CP=&&数据区&&
4.2通讯编码
表:系统编码
系统名称
系统编码
目前约定使用的
地表水质量监测
21
空气质量监测
22
22(其他后续特定环境下使用)
声环境质量监测
23
地下水质量监测
24
工地扬尘污染源
39
表:命令编码
命令名称
命令编码
命令类型
描述
上位向现场
现场向上位
初始化命令
设置超时时间及重发次数
1000
请求命令
用于上位机设置现场机的超时时间及重发次数
登记设备信息
1001
上传命令
用于现场机向管理系统登记设备信息
参数命令
提取现场机时间
1011
请求命令
用于提取现场机的系统时间
上传现场机时间
1011
上传命令
用于上传现场机时间
设置现场机时间
1012
请求命令
用于设置现场机的系统时间
现场机时间校准请求
1013
通知命令
用于向上位机发送现场机时间校准请求
设置设备报警值
1020
请求命令
用于设置现场机的报警值数据
提取设备报警值
1021
请求命令
提取报警值数据
上传设备报警值
1021
上传命令
上传报警值数据
设置实时数据间隔
1062
请求命令
指定实时数据间隔
设置实时数据间隔
1062
请求命令
指定实时数据间隔
设置实时数据间隔
1062
请求命令
指定实时数据间隔
提取分钟数据间隔
1063
请求命令
提取分钟数据间隔
上传分钟数据间隔
1063
上传命令
上传分钟数据间隔
设置分钟数据间隔
1064
请求命令
设置分钟数据间隔
设置现场机密码
1072
请求命令
用于设置现场机的密码
数据命令
提取污染物实时数据
2011
请求命令
用于启动现场机上传实时数据
上传污染物实时数据
2011
上传命令
用于现场机上传污染物实时数据
提取污染物分钟数据
2051
请求命令
用于启动现场机上传物分钟历史数据
上传污染物分钟数据
2051
上传命令
用于现场机上传污染物分钟历史数据
提取污染物小时数据
2061
请求命令
用于启动现场机上传物小时历史数据
上传污染物小时数据
2061
上传命令
用于现场机上传污染物小时历史数据
设备心跳命令
1010
请求命令
用于现场机上传心跳数据
控制命令
发送控制命令
1910
发送各个继电器的动作状态控制(动作类型、动作时间、动作周期)
提取控制命令执行结果
1911
提取各个继电器的动作状态控制
上传控制命令执行结果
1911
上传各继电器动作状态信息和参数(增加当前状态)
表:实时数据中字段对照
字段名
描述
字符集
描述
xxxxxx-Rtd
污染物实时采样数据
0-9
“xxxxxx”是污染因子编码,污染监测因
子编码取值详见附表5
xxxxxx-Flag
监测仪器数据标记
A-Z/0-9
参见表《数据标记表》
表:实时数据中字段对照
编码
中文名称
单位
数据类型
a34004
细微颗粒物PM2.5
纳克/立方米
N3.3
a34002
可吸入颗粒物PM10
纳克/立方米
N3.3
a01001
温度
摄氏度
N3.1
a01002
湿度
%
N3.1
a01007
风速
米/秒
N4.1
a01008
风向
[角]度
N4
a01009
风力
级
N2
LA
噪声
分贝
N3.1
表:数据标记表
4.2.1请求案例
设备主动上传实时数据案例:
##0267QN=20181012174357375;ST=39;CN=2011;PW=123456;MN=HC20181012221;Flag=5;CP=&&DataTime=20181012174357;a34004-Rtd=0,a34004-Flag=N;a34002-Rtd=0,a34002-Flag=N;a01001-Rtd=0.0,a01001-Flag=N;a01002-Rtd=0.0,a01002-Flag=N;a01007-Rtd=0.0,a01007-Flag=N;a01008-Rtd=0,a01008-Flag=N&&F6C1
4.2.2功能
在扬尘噪音设备上需要提供一个可配置服务器地址的功能(可以使用ip的方式或者使用域名的方式)。
从客户端的角度来描述TCP协议支持的功能:
1.实时上传扬尘噪音数据
2.心跳信号的发送
4.2.3流程
扬尘噪音设备同服务器之间的交互流程如下:
注:
A:心跳交互
B:批量下发人员
4.2.4心跳交互
通过《命令编码》1010时,表示设备通服务器心跳交互
具体交互数据例如:
##0267QN=20181012174357375;ST=22;CN=1010;PW=123456;MN=HC20181012221;Flag=5;CP=&&DataTime=20181012174357&&F6C1
注:交互数据结构参照《4.3定义》部分。
4.2.5实时数据上传
设备需要上传实时数据时,先在服务器端注册该设备序列号。
以下为具体上传的实例参考,每段解析请参照《5.3定义部分》
##0267QN=20181012174357375;ST=22;CN=2011;PW=123456;MN=HC20181012221;Flag=5;CP=&&DataTime=20181012174357;a34004-Rtd=0,a34004-Flag=N;a34002-Rtd=0,a34002-Flag=N;a01001-Rtd=0.0,a01001-Flag=N;a01002-Rtd=0.0,a01002-Flag=N;a01007-Rtd=0.0,a01007-Flag=N;a01008-Rtd=0,a01008-Flag=N&&F6C1
注:
1.交互数据结构参照《4.3定义》部分。
2.F6C1为CRC16数据校验码。
五、实名制认证设备
实名认证设备主要功能是读取身份证上面的信息,并且把身份证上面的信息展示在系统客户端,然后通过客户端把信息传送到实名制平台。
5.1编码
特定数据格式传输数据
5.1.1定义
所有上传数据都需要差错检验,差错校验使用和校验方式进行数据校验。
5.1.2功能
身份证信息读取
5.1.3身份证读取
初始化 int InitCom()
关闭int CloseCom()
获取设备编号int GetCardNum()
返回内容
类型
长度
描述
pRD
IntPtr
设备码
获取身份证int ReadCardInfo()
参数
类型
长度
描述
sMsg
varchar
返回的消息
返回内容
字段
类型
长度
描述
CardNo
varchar
18
身份证号码
Name
varchar
50
姓名
Sex
varchar
10
性别
Birthday
varchar
50
出生日期
Address
varchar
500
地址
AddressEx
varchar
500
追加地址
Department
varchar
50
发卡机关
StartDate
varchar
50
证件开始日期
EndDate
varchar
50
证件结束日期
Nation
varchar
50
民族
PhotoPath
varchar
500
相片路径
5.2摄像头设备接口5.2.1编码
特定数据格式传输数据
5.2.2定义
所有上传数据都需要差错检验,差错校验使用和校验方式进行数据校验。
5.2.3功能
拍摄人脸照片
5.2.4人脸照片拍摄
初始化 int InitCom()
关闭int CloseCom()
预览照片int USBCamera_StartPreview()
参数
类型
长度
描述
handle
int
句柄
lpPreviewParam
struct
视频播放结构体
拍照bool USBCamera_Capture()
参数
类型
长度
描述
handle
int
句柄
lpPreviewParam
struct
视频播放结构体
5.3银行卡读取设备接口5.3.1摘要
通过定位光标,直接可以将银行卡的卡号读取到光标位置,支持芯片读卡、磁条读卡,支持将信息同步输入文本、excel、word等工具上面。
5.3.2编码
特定数据格式传输数据
5.3.3定义
所有上传数据都需要差错检验,差错校验使用和校验方式进行数据校验。
5.3.4功能
银行卡获取
5.3.5银行卡获取
初始化 int OpenDevice()
获取银行卡卡号int IccGetCardInfo()
参数
类型
长度
描述
info
varchar
50
返回银行卡号
2