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
| 字符串
| 备注，位置描述
|
