通讯协议.doc

GPS系统服务器、客户端、
协议头：HEAD (0x11 0x12)
协议尾：FOOT(0x13 0x14)
分割苻1：S1(0x00)
分隔符2：S2(0x0e)
分割苻3：S3(0x0f)
主命令字：O1(char)
副命令字：O2(char)
车队ID：tID
车辆ID：cID
帐号ID：aID
返回结果：ret(char), 0x30(0)表示失败, 0x31(1)表示成功, 0x32(2)表示其他结果
数据内容：data
起始时间：sTime
结束时间：eTime
空字段：null
客户端请求及服务器回复：
除测试指令外，其他指令格式如下
HEAD
O1
O2
data
FOOT
连接相关
主命令字A
连接测试
请求：
HEAD
@
FOOT
测试只有一个命令字@,回复：同请求
登陆
请求：
HEAD
A
A
类型(char)
用户名
S1
密码
FOOT
类型为车队用户时，用户名可以为tID或者车队名
类型为车辆用户时，用户名可以为cID或者车牌
回复
HEAD
A
A
ret
data
FOOT
登陆失败，data为空，登陆成功data如下：
用户信息
S1
车队1信息
S1
车队2信息
S1
指令通道信息
其中，车队信息、指令通道信息详细如下
车队信息
S3
车辆1信息
S3
车队2信息
S3
车辆3信息
指令通道1
S2
指令通道2
S2
指令通道3
退出
请求：
HEAD
A
B
FOOT
回复：
无
位置信息相关
主命令字B
监控
请求：
HEAD
B
A
tID或者cID
FOOT
回复：
HEAD
B
A
data
FOOT
data：cID + S1 + 位置信息 + cID + S1+位置信息…
停止监控
请求：
HEAD
B
B
tID或者cID或者留空
FOOT
留空表示停止所有监控
回复：无
定位
请求：
HEAD
B
C
cID
FOOT
回复：
HEAD
B
C
ret
数据
FOOT
ret表示失败时，data为cID
否则data为cID + S1 + 位置信息
历史轨迹
请求：
HEAD
B
D
cID
S1
sTime
S1
eTime
FOOT
回复：
HEAD
B
D
cID
S1
信息点1
S2
信息点2
S2
信息点3
…
FOOT
历史报警
请求：
HEAD
B
E
cIDs
S1
sTime
S1
eTime
FOOT
cIDs格式为cID1 + S2 + cID2 + S2 + cID3…
回复：
HEAD
B
E
报警点1
S1
报警点2
S1
报警点3
…
FOOT
区域查车
请求：
HEAD
B
F
区域
S1
sTime
S1
eTime
FOOT
区域格式为 点1经度+S1+点1纬度+点2经度+S1+点2纬度…
至少需要三个点
回复：
HEAD
B
F
cID1
S1
cID2
S1
…
FOOT
里程查询
请求：
HEAD
B
G
cID
S1
sTime
S1
eTime
FOOT
回复：
HEAD
B
G
cID
里程数
FOOT
自定义标注查询
请求：
HEAD
B
H
关键字
FOOT
回复：
HEAD
B
H
data
FOOT
data格式为：点1名称+S2+点1经度+S2+点1纬度+S1+点2名称+S1+点2经度+S1+点2纬度…
自定义标注
请求：
HEAD
B
I
名称
S1
经度
S1
纬度
FOOT
回复：
HEAD
B
I
ret
FOOT
其他信息相关
主命令字C
获取帐号列表
请求：
HEAD
C
A
null
FOOT
回复：
HEAD
C
A
ret
data
FOOT
Ret为成功时，data为帐号列表数据，格式为：帐号1信息+S1+帐号2信息+S1+帐号3信息…
Ret为失败时，data包含获取失败的原因
添加帐号
请求：
HEAD
C
B
新帐号信息
FOOT
回复：
HEAD
C
B
ret
data
FOOT
Ret为成功时，data为null
Ret为失败