您所在位置:法邦网 > 法律法规 > 法规浏览

管理我的法规库

哇,我可以拥有自己的法规库!

法规提交

如果您发现我们没有收录到的法规,您可以在此提交。提交后我们会即时把它收录上,感谢您参与维护我们共同的法规库。
【法规名称】 
【颁布部门】 农业部
【发文字号】 农办渔[2010]95号
【颁布时间】 2010-08-30
【实施时间】 2010-08-30
【效力属性】 有效
【法规编号】 510129  什么是编号?
【正  文】

第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

字符串

命令字


  服务器返回:o\r\n
  表 0-7 服务器返回
  
  

名称

类型

描述

o

字符串

命令字


  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

无权发送此命令

 

此法规有错误,我来纠正。请点击在此 提交错误内容或者您纠正的内容!
回到顶部

相关法规

查看更多
法规搜索:
法律法规  Copyright ©2007-2019 Fabao365.com 版权所有
|
京ICP备10210683号
|
京公网安备11010802013176号
|
客服电话:15811286610