【法规名称】
【发文字号】 农办渔[2010]95号
【颁布时间】 2010-08-30
【实施时间】 2010-08-30
【效力属性】 有效
【正 文】
第15页 农业部办公厅关于发布《渔船动态监管信息系统平台技术规范(试行)》的通知
[接上页] 通信服务商提供服务所在ip以及端口,用户名密码等必须数据。 动态信息交换接口包含以下功能: 表 0-1 动态信息交换接口
|
序号 |
功能 |
说明 |
|
1 |
登录 |
登录asp服务,不登录无法进行后续操作 |
|
2 |
退出登录 |
退出asp服务 |
|
3 |
连接保持 |
保持当前连接,如无数据通信,需定期发送连接保持信息 |
|
4 |
发送请求 |
发送指令,包括但不限于单船单次调位,单船设定船舶报位频率,多船单次调位,多船设定报位间隔,单船发送信息,多船发送信息 |
|
5 |
位置数据 |
定位终端的位置信息 |
|
6 |
短信数据 |
定位终端发送的信息 | 3.3.1 通信格式 动态信息交换接口采用类telnet终端的命令应答方式通信,以\r\n为结束符的字符串为通信指令基本单元。其中逗号作为通信指令中的字段分隔符。字符编码英文采用ascii,中文编码采用gbk。 具体指令类型见下表。 表 0-2 指令类型表
|
序号 |
指令符 |
定义 |
方式 |
发送方 |
接收方 |
说明 |
|
1 |
w |
欢迎标识,连接服务 |
|
s |
c |
登陆服务后,服务端首先发送此信息 |
|
2 |
i |
登录 |
同步 |
c |
s |
登录服务端 |
|
i |
登录返回 |
同步 |
s |
c |
登陆返回 |
|
3 |
o |
退出登录 |
同步 |
c |
s |
退出 |
|
o |
退出登录返回 |
同步 |
s |
c |
退出返回 |
|
4 |
k |
连接保持 |
同步 |
c |
s |
|
|
k |
连接保持返回 |
同步 |
s |
c |
|
|
5 |
s |
发送请求 |
同步 |
c |
s |
客户端发出命令请求 |
|
s |
发送请求返回 |
同步 |
s |
c |
服务端返回请求处理结果 |
|
6 |
p |
位置数据 |
异步 |
s |
c |
服务端推送位置数据 |
|
7 |
m |
短信数据 |
异步 |
s |
c |
服务端推送信息数据 |
|
8 |
r |
回执信息 |
异步 |
s |
c |
服务端推送发送命令异步回执 |
|
9 |
x |
错误信息返回 |
同步 |
s |
c |
| c:客户端 s:服务器 所有客户端发送的指令,格式错误以及登录失败在服务器端出错都返回“x”指令,以下对应的返回都指成功执行后的返回。 3.3.2 通信指令说明 3.3.2.1欢迎标识 客户端主动和服务器建立tcp连接后,会收到服务器返回的本指令。 格式:w version,date\r\n 表 0-3 欢迎标识
|
名称 |
类型 |
描述 |
|
w |
字符串 |
命令字 |
|
version |
字符串 |
服务软件版本 |
|
date |
时间字符串 |
软件发布日期 | 3.3.2.2登录 通信接口需要登录后才能发送各种请求消息。 格式:i user,password\r\n 表 0-4 登陆
|
名称 |
类型 |
描述 |
|
i |
字符串 |
命令字 |
|
user |
字符串 |
用户名 |
|
password |
字符串 |
密码 | 服务器返回:i user_id\r\n 表 0?- 服务器返回
|
名称 |
类型 |
描述 |
|
i |
字符串 |
命令字 |
|
user_id |
十进制表示整数 |
用户名对应的id | 3.3.2.3退出登录 客户端退出程序前,应发送退出登录指令,以便结束事务,关闭连接,服务器发送返回指令后,服务器断开tcp连接。 格式:o\r\n 表 0-6 退出登陆 服务器返回:o\r\n 表 0-7 服务器返回 3.3.2.4连接保持 客户端需要以一定周期发送此指令,才能保证通信接口的tcp连接不被服务器断开。 格式:k data\r\n 表 0-8 连接保持
|
名称 |
类型 |
描述 |
|
k |
字符串 |
命令字 |
|
data |
字符串 |
任何字符,可用当前的utc时间对应的字符串 | 服务器返回:k data\r\n 表 0-9 服务器返回
|
名称 |
类型 |
描述 |
|
k |
字符串 |
命令字 |
|
data |
字符串 |
任何字符,可用当前的utc时间对应的字符串 | 3.3.2.5发送命令(数据中心->asp) 客户端发送与asp相关的通信请求时,用此命令。 格式:s sequence, terminal_code,terminal_type,request_type,args\r\n 表 0-10 发送命令
|
名称 |
类型 |
描述 |
|
s |
字符串 |
命令字 |
|
sequence |
字符串 |
序列号,在整个系统中是唯一的,规则:由通信服务商代码(4位10进制数,系统分配)、用户 id码(4位10进制数,登录后获得)、utc日期戳(14位10进制数,格式yyyymmddhh24miss)和5位唯一的十进制序列号串联而成,如:110101992009013011552311111。 |
|
terminal_code |
字符串 |
通信目标代码。可以为移动终端通信码或组id |
|
terminal_type |
十进制数 |
通信终端类型,见表 2.2-2 |
|
request_type |
十进制数 |
请求命令代码 见表 0?11 |
|
args |
字符串 |
请求命令附带参数,可选的。如无,前面逗号要保留。
参数组合见表 0?一 | 表 0-11请求代码表
|
request_type |
定义 |
备注 |
|
0 |
请求单个位置 |
|
|
2 |
按组请求位置 |
需通信系统支持 |
|
1 |
请求设置打开周期位置报告 |
按照周期报告,可以设置报位频度,不受时间段限制 |
|
6 |
请求关闭周期位置报告 |
需通信系统支持 |
|
9 |
请求发送单条短信 |
|
|
12 |
按组请求发送短信 |
需通信系统支持 |
|
21 |
确认报警 |
| 表 0-12 请求类型与目标组合表
|
request_type |
terminal_code |
|
0,1,6,9,21 |
指定的通信终端代码 |
|
2,12 |
组id | 表 0-13 请求参数表
|
request_type |
args |
定义 |
|
0 |
无 |
无 |
|
2 |
无 |
无 |
|
1 |
utc,span |
utc:自动报位起始时间
span:自动报位间隔 |
|
6 |
无 |
无 |
|
9 |
msg |
msg:短信内容,‘,’用‘\.’转义
中文采用gbk编码 |
|
12 |
msg |
msg:短信内容,‘,’用‘\.’转义
中文采用gbk编码 |
|
21 |
msg |
msg:确认报警信息,‘,’用‘\.’转义
中文采用gbk编码 | 服务器返回:s sequence,receipt_code,description\r\n 表 0-14 服务器返回
|
名称 |
类型 |
描述 |
|
s |
字符串 |
命令字 |
|
sequence |
字符串 |
客户端发送命令的序列号 |
|
receipt_code |
十进制数 |
命令执行状态码,成功执行返回0 ,失败错误码见表 0?二。 |
|
description |
字符串 |
命令执行状态描述 | 3.3.2.6动态数据推送(asp->数据中心) 格式: p terminal_code,comm_type,pos_type,utc,longitude,latitude,course,trueheading,speed,status,vdesc\r\n 表 0-15 动态数据推送
|
名称 |
类型 |
描述 |
|
p |
字符串 |
命令字 |
|
msg_id |
字符串 |
数据序列号,在整个系统中是唯一的,规则:由通信服务商代码(4位10进制数,系统分配)、表示数据中心的用户id”0000”、utc日期戳(14位10进制数,格式yyyymmddhh24miss)和5位唯一的十进制序列号串联而成,如:110100002009013011552311111 |
|
terminal_code |
字符串 |
终端号码 |
|
comm_type |
十进制数 |
通信服务商代码,见表 2.2-2 |
|
pos_type |
十进制数 |
位置类型,见表 2.3-1 |
|
utc |
十进制数 |
gps定位时间,见表 2.1-1 |
|
longitude |
十进制数 |
经度,见表 2.1-1 |
|
latitude |
十进制数 |
纬度,见表 2.1-1 |
|
course |
十进制数 |
航向,见表 2.1-1 |
|
trueheading |
十进制数 |
船艏向,见表 2.1-1 |
|
speed |
十进制数 |
速度,见表 2.1-1 |
|
status |
十进制数 |
状态,见表 2.3-3 |
|
vdesc |
字符串 |
备注,位置描述 | 3.3.2.7不含位置类数据推送 格式:m terminal_code,comm_type,msg_type,utc,msg\r\n 表 0-16 不含位置类数据推送
|
名称 |
类型 |
描述 |
|
m |
字符串 |
命令字 |
|
msg_id |
字符串 |
数据序列号,在整个系统中是唯一的,规则:由通信服务商代码(4位10进制数,系统分配)、表示数据中心的用户id”0000”、utc日期戳(14位10进制数,格式yyyymmddhh24miss)和5位唯一的十进制序列号串联而成,如:110100002009013011552311111 |
|
terminal_code |
字符串 |
终端号码 |
|
comm_type |
十进制数 |
通信服务商代码,见表 2.2-2 |
|
msg _type |
十进制数 |
短信类型,见表 2.3-2 |
|
utc |
十进制数 |
短信发送时间,见表 2.1-1 |
|
msg |
字符串 |
短信内容 | 3.3.2.8组发指令 组发短信:针对组内的所有目标发送短信,仅发送目标组id给通信服务商,具体通信行为由通信服务商解释。 组调位:针对组内的所有目标发送调位指令,仅发送目标组id给通信服务商,具体通信行为由通信服务商解释。 1)中心按照本协议中3.1.2节获取组织机构基本信息,3.1.3节获取船舶与组织机构对应关系 提供中心的船舶组织结构给通信服务商。 2)中心按照本协议中3.3.2.5发送命令(数据中心->asp)节中的指令类型2按组请求位置、指令类型12按组请求发送短信 指令发送给通信服务商通信指令。 3)通信服务商收到指令后,根据指令中的组代码id在中心的组织结构数据中查询到组名称,根据组名称对应服务商本身的组织,按照服务商自定义的组发送命令方法下发指令。如指令发送成功返回相应的成功信息,如失败或没有对应组织名称返回相应的错误提示。 3.3.2.9发送请求异步信息回执 格式:r terminal_code,,term_type,sequence,utc,receipt_code,msg\r\n 表 0-17 发送请求异步信息回执
|
名称 |
类型 |
描述 |
|
r |
字符串 |
命令字 |
|
terminal_code |
字符串 |
终端号码 |
|
comm_type |
十进制数 |
通信服务商代码,见表 2.2-2 |
|
sequence |
字符串 |
回执对应命令的序列号 |
|
utc |
十进制数 |
状态更新时间,见表 2.1-1 |
|
receipt_code |
十进制数 |
状态码 |
|
msg |
字符串 |
备注 | 表 0-18 发送状态代码表
|
状态代马 |
说明 |
|
0 |
已成功发送到数据中心 |
|
10000 |
开始处理 |
|
10100 |
处理成功 |
|
10200 |
处理失败 |
|
10300 |
通信链路不可用 |
|
10400 |
船舶未响应 |
|
10500 |
船舶不可用 |
|
10700 |
请求参数错误 |
|
10800 |
终端不存在 |
|
10900 |
终端未分配 | 3.3.2.10错误信息返回 格式:x error_code\r\n 0-19 错误信息返回
|
名称 |
类型 |
描述 |
|
x |
字符串 |
命令字 |
|
error_code |
十进制数 |
错误代码 见表 0?20 | 表 0-20 错误代码表
|
error_code |
定义 |
备注 |
|
f0000000 |
用户名或密码错 |
|
|
f0000002 |
用户已登录 |
|
|
f0000003 |
无效指令 |
|
|
f0000004 |
用户未登录 |
|
|
f0000007 |
指令格式错误 |
|
|
f0000011 |
该用户已由其他位置登录 |
|
|
f0000016 |
指令解释失败 |
|
|
f0000017 |
无权发送此命令 |
|
|