酷米客终端通信协议

酷米客终端通信协议酷米客终端通信协议 作者 王丰 时间 2011 10 14 修订记录 作者时间版本修订内容 王丰 2011 10 14 初始版本 王丰 2011 10 25 增加 服务端协议增加了 服务端协议版本 UUID UID 三个字段 王丰 2011 10 26 增加 协议字段类型 增加字段长度 王丰 2011 10 27 修改 imei 字段全部用数字类型 王丰 2011 11 2 增加 明确 获取最新微博 uid 字段含义 王丰 2011 11 4 增加 状态信息协议 王丰 2011 11 8 修改 短信请求中文地址 协议改为 短信请求地址 协议增加语言字段 王丰 2011 11 9 协议允许分帧 增加 帧响应 协议 修改 终端 网关之间的协议增加 分帧标标志 和 帧序 号 字段 王丰 2011 11 9 增加 GPS SOS 报警数据包协议 GPS 短信请求地址协议 王丰 2011 11 10 增加 DNS 域名相关内容 服务器下发指令 协议亲情号码部分 修改 登陆协议增加可选 mss 字段 终端指定帧大小 王丰 2011 11 16 增加 微群列表 增加 start num 字段 修改 微群列表 响应字段 qcreator 改为 string 类型 王丰 2011 11 17 增加 GPS LBS 定位 和 GPS 短信请求地址 协议 增加了日期时间字段 卫星 UTC 时间秒数 获取最新微博 和 发表微博 协议 增加了 gps status 字段 表示 gps 的定位状态 修改 GPS LBS 定位 和 GPS 短信请求地址 协议 状态和航向合并到一起 这之前的协议保持兼容 状态信息 协议 调整为二进制格式 附录 A 部分协议抓包示例 删除 服务器下发消息 指令 协议中亲情号码相关指令 本协议只体现通道功能 具体内容开发时约定 王丰 2011 11 18 修改 建议重试 3 次缓存的 IP 胡文 闻 2011 11 22 增加获取群微博 修改 0 x17 协议 将 GPS 数据包统一 将 状态信息 电压等级 GSM 信号强度字段加入到 0 x02 及 0 x03 协议中 王丰 2011 11 23 删除 获取群微博 协议 修改 获取最新微博 和 上一页 下一页 协议 增加 qid 群 id 字段 多基站定位 和 GPS LBS 定位 协议 增加状 态信息相关的字段 GPS SOS 报警信息协议 调整 GPS 数据字段 使其 和其它协议 GPS 数据部分一致 获取附近微博 和 发表微博 协议 主基站字 段改为必选 获取附近微博 已经有 num 字段 故删除 limit 字段 王丰 2011 11 24 修改 LBS 短信请求地址 和 GPS 短信请求地址 协议 启用版本号 王丰 2011 12 1 修改 分配小蜜蜂 gk305 系列 域名 王丰 2011 12 8 修改 LBS 短信请求地址 版本 1 返回纬度 经度 校准 后纬度 校准后经度 王丰 2011 12 20 增加 测试端口 22350 王丰 2011 12 30 增加 设备上传消息 指令协议 0 x19 王丰 2012 3 26 增加 0 x04 和 0 x17 中增加低电报警 0 x20 查询服务器时间 服务器下发消息指令列表 设置 SOS 号码 查询 SOS 号码 设置 HELP 号码 查询 HELP 号码 远程开机 远程关机 伪 隐身 查询隐身状态 目录目录 1 1 1 1 兼容性兼容性 7 1 2 1 2 术语 定义术语 定义 7 2 2 总体定义总体定义 7 2 1 2 1 字节序字节序 7 2 2 2 2 协议分帧 特别注意 协议分帧 特别注意 7 2 3 2 3 DNSDNS 域名域名 8 2 3 1 2 3 1 顶级域名列表顶级域名列表 8 2 3 2 2 3 2 生产域名列表生产域名列表 8 2 3 3 2 3 3 开发测试域名列表开发测试域名列表 8 2 3 4 2 3 4 域名使用规则域名使用规则 8 3 3 数据包格式数据包格式 9 3 1 3 1 服务端协议版本服务端协议版本 9 3 2 3 2 UUIDUUID 9 3 3 3 3 UIDUID 9 3 4 3 4 终端协议版本终端协议版本 10 3 5 3 5 格式格式 10 3 6 3 6 协议号协议号 10 3 7 3 7 分帧标志分帧标志 10 3 8 3 8 帧序号帧序号 11 3 9 3 9 包长度包长度 11 3 10 3 10 信息内容信息内容 11 3 10 1 3 10 1 登录登录 登出登出 11 3 10 1 1 3 10 1 1 登陆信息包登陆信息包 0 x01 0 x01 11 3 10 1 2 3 10 1 2 登出信息包登出信息包 0 x14 0 x14 13 3 10 2 3 10 2 地址定位地址定位 LBS GPS LBS GPS 13 3 10 2 1 3 10 2 1 LBSLBS 多基站定位多基站定位 0 x02 0 x02 13 3 10 2 2 3 10 2 2 GPS LBSGPS LBS 定位定位 0 x03 0 x03 15 3 10 2 3 3 10 2 3 LBSLBS 报警数据包 报警数据包 0 x040 x04 16 3 10 2 4 3 10 2 4 GPSGPS 报警数据包 报警数据包 0 x170 x17 17 3 10 2 5 3 10 2 5 LBSLBS 短信请求地址 短信请求地址 0 x050 x05 18 3 10 2 6 3 10 2 6 GPSGPS 短信请求地址 短信请求地址 0 x180 x18 19 3 10 2 7 3 10 2 7 帧响应 帧响应 0 x160 x16 20 3 10 3 3 10 3 状态信息状态信息 0 x15 0 x15 21 3 10 4 3 10 4 服务器下发消息服务器下发消息 指令指令 0 x0F 0 x0F 22 3 10 5 3 10 5 设备上传消息设备上传消息 指令指令 0 x19 0 x19 24 3 10 6 3 10 6 查询服务器时间查询服务器时间 0 x20 0 x20 25 3 10 7 3 10 7 微博微博 互助社区协议互助社区协议 26 3 10 7 1 3 10 7 1 获取最新微博获取最新微博 0 x06 0 x06 26 3 10 7 2 3 10 7 2 上一页上一页 下一页下一页 0 x07 0 x07 29 3 10 7 3 3 10 7 3 获取附近微博获取附近微博 0 x08 0 x08 29 3 10 7 4 3 10 7 4 发表微博发表微博 0 x09 0 x09 31 3 10 7 5 3 10 7 5 微群列表微群列表 加入的微群加入的微群 0 x0A 0 x0A 32 3 10 7 6 3 10 7 6 微群列表微群列表 创建的微群创建的微群 0 x0B 0 x0B 34 3 10 7 7 3 10 7 7 查看查看单条微博单条微博 0 x0C 0 x0C 34 3 10 7 8 3 10 7 8 设置微群提醒 未读消息数 设置微群提醒 未读消息数 0 x0D 0 x0D 34 3 10 7 9 3 10 7 9 查看查看微博评论微博评论 0 x0E 0 x0E 35 3 10 8 3 10 8 查看位置协议查看位置协议 35 3 10 8 1 3 10 8 1 获取登录用户的好友列表 获取登录用户的好友列表 0 x100 x10 35 3 10 8 2 3 10 8 2 跟踪选择的设备跟踪选择的设备 0 x11 0 x11 36 3 10 8 3 3 10 8 3 查看所有好友位置查看所有好友位置 0 x12 0 x12 36 3 10 8 4 3 10 8 4 轨迹回放轨迹回放 0 x13 0 x13 37 4 4 附附 A A 通信协议数据包片段示例通信协议数据包片段示例 39 引言引言 本文档定义了小蜜蜂定位服务平台对应用层接口协议的说明 相关接口协议仅适用于 平台与定位终端之间的交互 1 1 1 1 兼容性兼容性 适用的平台版本为 xxx 版本 1 2 1 2 术语 定义术语 定义 术语 缩术语 缩 写写 英文含义英文含义中文含义中文含义 CMPPChina Mobile Peer to Peer 中国移动点对点协议 GPSGlobal Positioning System 全球卫星定位系统 GSM Global System for Mobile Communication 全球移动通信系统 GPRSGeneral Packet Radio Service 通用无线分组业务 TCPTransport Control Protocol 传输控制协议 LBSLocation Based Services 辅助定位服务 IMEI International Mobile Equipment Identity 国际移动设备识别码 MCCMobile Country Code 移动用户所属国家代 号 MNCMobile Network Code 移动网号码 LACLocation Area Code 位置区码 CICell ID 移动基站 RSSI Received Signal Strength Indicator 接收信号强度 UDPUser Datagram Protocol 用户数据报协议 SOSSave Our Ship Save Our Souls 遇难求救信号 CRCCyclic Redundancy Check 循环冗余校验 NITZNetwork Identity and Time Zone 时区 GISGeographic Information System 地理信息系统 JSONJavaScript Object Notation Java 脚本对象标记 2 2 总体定义总体定义 2 1 2 1 字节序字节序 协议中涉及到多字节数据的字段 字节序为网络字节序 2 2 2 2 协议分帧 特别注意 协议分帧 特别注意 终端不能一次完整的接收大数据量协议包 目前发现终端不能一次完整的接收大数据量协议包 目前发现 MTKMTK 不能稳定接收超过不能稳定接收超过 1k1k 的包 的包 考虑对协议的数据部分分帧 目前微博 和以后的图片 相关协议会出现大数据 考虑对协议的数据部分分帧 目前微博 和以后的图片 相关协议会出现大数据 量的情况 它们需要分帧处理 其它协议没有分帧的情况 可以不检查后面数据包量的情况 它们需要分帧处理 其它协议没有分帧的情况 可以不检查后面数据包 格式中定义的格式中定义的 分帧标志分帧标志 和和 帧序号帧序号 字段中的值 字段中的值 2 3 2 3 DNSDNS 域名域名 2 3 1 2 3 1 顶级域名列表顶级域名列表 设备系列设备系列主域名主域名 万网万网 备域名备域名 新网新网 车载系列 个人手持系列 2 3 2 2 3 2 生产域名列表生产域名列表 个人手持设备系列 200K 一段 二级域名后缀依次为 a b c d 设备型号设备型号主域名主域名 万网万网 备域名备域名 新网新网 设备段设备段 200K 一段一段 1 200K 200K 400K D302 系列 1 200K 200K 400K GS503 系列 1 200K 200K 400K GW101 系列 1 200K 200K 400K GT03A B 系列 1 200K 200K 400KLB01 系列 1 200K 200K 400KGK305 系列 2 3 3 2 3 3 开发测试域名列表开发测试域名列表 主域名主域名 万网万网 备域名备域名 新网新网 端口端口 22350 2 3 4 2 3 4 域名使用规则域名使用规则 域名解析 ip 本地缓存 如果这个 ip 3 次 暂定暂定 见备注见备注 都无法连接 才重新请求域名解 析 目的是 本地缓存 ip 可以快速确定服务器 避免 DNS 解析延时 用户体验更好 减少域名请求次数 避免设备对移动 DNS 服务器压力过大 引起误判 域名解析服务出问题 也还能使用缓存 ip 连上 服务器 ip 一般不会变 就算服务 器 ip 变 也是一个逐步过渡的过程 不会导致终端突然不能访问 备注 关于连接次数备注 关于连接次数 总体原则是尽快的和服务器建立连接 现在有的终端建立连接总体原则是尽快的和服务器建立连接 现在有的终端建立连接 需要需要 20s 到到 60s 左右的时间 重连前还有延时 建议连接次数定为左右的时间 重连前还有延时 建议连接次数定为 3 次 各终端自己选择次 各终端自己选择 合适的算法 灵活掌握 合适的算法 灵活掌握 3 3 数据包格式数据包格式 外部数据包格式 终端 网关 数据包长度合计 12 N 格式终 端 协 议 版 本 格 式 协 议 号 分 帧 标 志 帧序号包 长 度 信 息 内 容 位 bits 3130 0 长度 byte 11244N 内部数据包格式 网关 服务 数据包长度合计 1 16 8 12 N 格式服 务 端 协 议 版 本 UUIDUID 终 端 协 议 版 本 格 式 协 议 号 分 帧 帧 序 号 包 长 度 信 息 内 容 长度 byte 116811244N 3 1 3 1 服务端协议版本服务端协议版本 协议版本号 本版本为 0 3 2 3 2 UUIDUUID 消息全球唯一标识 主要用于网关和服务层交互 由网关生成 服务端回复消息时直接填回 3 3 3 3 UIDUID 用户 ID 前面 3 个字段只用于网关与服务端之间的交互 上行 由网关加上后传给服务层 下行 由网关去掉后传给终端 3 4 3 4 终端协议版本终端协议版本 协议版本号 本版本为 0 3 5 3 5 格式格式 信息内容格式 0 为二进制信息 二进制格式包中 长度单位为字节 1 为 json 信息 Json 格式参见 http www json org json en html 3 6 3 6 协议号协议号 根据不同的 信息内容 对应相应的协议号 协议号格式协议名 0 x01Json 登陆信息包 0 x02Binary 多基站定位 0 x03Binary GPS LBS 定位 0 x04Binary LBS 报警数据包 0 x05Binary LBS 短信请求地址 0 x06Json 获取最新微博 0 x07Json 上一页 下一页 0 x08Json 获取附近微博 0 x09Json 发表微博 0 x0AJson 微群列表 加入的微群 0 x0BJson 微群列表 创建的微群 0 x0CJson 查看单条微博 0 x0DJson 设置微群提醒 未读消息数 0 x0EJson 查看微博评论 0 x0FJson 服务器下发消息 指令 0 x10Json 获取登录用户的好友列表 0 x11Json 跟踪选择的设备 0 x12Json 查看所有好友位置 0 x13Json 轨迹回放 0 x14Binary 登出信息包 0 x15Binary 状态信息 0 x16Binary 帧响应 0 x17Binary GPS 报警数据包 0 x18Binary GPS 短信请求地址 0 x19Json 设备上传消息 指令 0 x20Json 查询服务器时间 3 7 3 7 分帧标志分帧标志 0 分帧结束 Last fragment 1 后面还有更多的帧 More fragments 3 8 3 8 帧序号帧序号 服务端分帧后生成的序号 终端收到一帧数据后 在帧响应协议中回复该序号给服 务端 3 9 3 9 包长度包长度 表示后面消息内容的长度 特别 不包含包长度字节本身占用的空间 3 10 3 10 信息内容信息内容 包长度指定的字节数 信息内容若为 json 格式 必须采用 UTF 8 编码 参见 http en wikipedia org wiki UTF 8 信息内容中含有时间字段的 字段值为 UTC 秒数 参见 http en wikipedia org wiki UTC 信息内容中含有经纬度字段的 东经 北纬用正数表示 西经 南纬用负数表示 参见 http en wikipedia org wiki Longitude Ecliptic latitude and longitude 只涉及 json 格式的相关协议 3 10 1 3 10 1 登录登录 登出登出 3 10 1 1 3 10 1 1 登陆信息包登陆信息包 0 x01 0 x01 3 10 1 1 1 协议号 0 x00 0 x01 3 10 1 1 2 作用 登陆信息包用来和服务器建立连接 提交终端 ID 给服务器以供登录认证 3 10 1 1 3 输入 参数类型 长度 必选默认值 范 围 说明 versionnumber 3 true0 版本 methodstring 30 truelogin 方法 mssnumber 10 false 0 不分帧 大于 0 帧大小 设备能接收的数据帧大小 终端提供 帧大小包协议头 和信息内容两部分大小 字 节单位 accountstring 20 true 用户 ID 米号 IMEI 用户 帐号 ltypenumber 1 true 0 米号 1 IMEI 2 帐号 登陆类型 login type modelstring 10 true 设备厂家制定的型号 例如 GS503 LB01 ecodestring 10 true 企业代码 Enterprise code tznumber 5 true8 60 时区 为处理方便 将时期 转换为分钟数 正数代表东 时区 负数代表西时区 lcidstring 8 truezh cn 区域 语言代码 参见 en us library 0h88fahh v vs 85 aspx atypenumber 1 true 0 无认证 1 密码 2 kerberos 3 LDAP 认证方式 Authentication type credentialstring 12 true 认证凭据 例 IMEI 号为 123456789012345 类型为 GS503 时区为 GMT 8 8 60 480 区 域 语言为中国大陆 企业代码为 goome 采用密码认证 且密码为 passwd 的用 户登陆请求 version 0 method login mss 1024 account 123456789012345 ltype 1 model GS503 ecode goome tz 480 lcid zh cn atype 1 credential passwd 3 10 1 1 4 响应 参数类型 长度 返回值 范围说明 versionnumber 3 0 版本 同 输入 列表中的版本 statusnumber 2 0 成功 失败 1 原因未知 2 输入参数错误 3 用户不存在 4 认证错误 5 限制登陆 6 欠费 成功和失败状态 modelstring 10 V 网页注册 F windowsmobile 设备类型 namestring 20 用户名 ltypenumber 1 0 米号 1 IMEI 2 帐号 登陆类型 login type imeinumber 15 imei 号 uidnumber 12 用户 id 例 登陆成功 version 0 status 0 model V name 测试用户 uid 12345 imei 3534 3 10 1 1 5 备注 服务端解析出输入的 mss 后 返回给网关时填入 帧序号 字段 网关使用该 值决定帧大小 3 10 1 2 3 10 1 2 登出信息包登出信息包 0 x14 0 x14 3 10 1 2 1 协议号 0 x00 0 x14 3 10 1 2 2 作用 网关通知后台服务层 用户连接已经断开 用于 网关 服务 服务 网关之间 终端不发送 3 10 1 2 3 输入 3 10 1 2 4 响应 信息内容格式 版本状态 长度 byte 11 3 10 1 2 4 1 状态 0 成功 1 包格式不正确 3 10 2 3 10 2 地址定位地址定位 LBS GPS LBS GPS 3 10 2 1 3 10 2 1 LBSLBS 多基站定位多基站定位 0 x02 0 x02 3 10 2 1 1 协议号 0 x00 0 x02 3 10 2 1 2 作用 传送终端附近的基站信息到服务器 供定位使用 3 10 2 1 3 输入 信息内容 格式 版 本 状 态 信 息 电 压 等 级 GSM 信 号 强 度 等 级 TAMCCMNCLACCIRSSICOUNTNLACNCINRSSI 长度 11111212311231 信息内容 格式 版本 长度 byte 1 byte 3 10 2 1 3 1 版本 当前值为 0 以后改变协议结构 增加版本号 3 10 2 1 3 2 TA Timing advance 该值只能在通话或发送短信时间段获取 范围是 0 63 其它情况下为 255 属于无效值 乘 以 550 米 可以估算终端到主小区距离 3 10 2 1 3 3 MCC 移动用户所属国家代号Mobile Country Code MCC 中国的移动国家号为460 十进制 这里取值范围是 0 x0000 0 x03E7 中国的移动国家号为 0 x01 0 xCC 十进制 460 转成十六进制 3 10 2 1 3 4 MNC 移动网号码 Mobile Network Code MNC 例如中国移动的为 0 x00 3 10 2 1 3 5 LAC 位置区码 Location Area Code LAC 包含于LAI 中 由两个字节组成 采用16 进制编 码 可用范围为0 x0001 0 xFFFE 码组0 x0000 和0 xFFFF 不可以使用 参见GSM 规范 03 03 04 08 和 11 11 一个位置区可以包含一个或多个小区 3 10 2 1 3 6 CI 主小区 CI 小区识别码 值范围是 0 x000000 0 xFFFFFF 参见术语表 CI 3 10 2 1 3 7 RSSI 主小区信号强度 值范围是 0 x00 0 xFF 实际信号强度为负值 上传其绝对值 参见术语表 RSSI 3 10 2 1 3 8 COUNT 相邻小区数量 每个小区含有 LAC CI RSSI 三个参数 如果为 0 则没有相邻小区 3 10 2 1 3 9 NLAC 相邻小区 LAC 3 10 2 1 3 10 NCI 相邻小区 CI 3 10 2 1 3 11 NRSSI 相邻小区信号强度 值范围是 0 x00 0 xFF 实际信号强度为负值 上传其绝对值 状态信息 电压等级 GSM 信号强度字段 请参考 状态信息 协议 3 10 2 1 4 响应 信息内容格式 版本状态 长度 byte 11 3 10 2 1 4 1 状态 0 成功 1 包格式不正确 3 10 2 2 3 10 2 2 GPS LBSGPS LBS 定位定位 0 x03 0 x03 3 10 2 2 1 协议号 0 x00 0 x03 3 10 2 2 2 作用 GPS LBS 同时定位 3 10 2 2 3 输入 信息内容 GPSLBS 格式 版 本 状 态 信 息 电 压 等 级 G S M 信 号 强 度 等 级 日 期 时 间 卫 星 数 纬 度 经 度 速 度 状 态 航 向 T A M C C M N C L A C C I R S S I C O U N T N L A C N C I N R S S I 长度 byte 11114144121212311231 3 10 2 2 3 1 日期时间 卫星时间 UTC 秒数 3 10 2 2 3 2 卫星数 参与定位的卫星颗数 3 10 2 2 3 3 纬度 表示定位数据的纬度值 数值范围 0 至 162000000 表示 0 度到 90 度的范围 单位 1 500 秒 转换方法如下 把 GPS 模块输出的经纬度值转化成以分为单位的小数 然后再把转化后的小 数乘以 30000 把相乘的结果转换成 16 进制数即可 如 22 32 7658 22 60 32 7658 30000 40582974 3 10 2 2 3 4 经度 表示定位数据的经度值 数值范围 0 至 324000000 表示 0 度到 180 度的范围 单位 1 500 秒 转换方法和纬度的转换方法一致 3 10 2 2 3 5 速度 表示 GPS 的运行速度 值范围为 0 x00 0 xFF 表示范围 0 255 公里 小时 3 10 2 2 3 6 状态 航向 表示 GPS 的运行方向 表示范围 0 360 单位 度 以正北为 0 度 顺时针 第一个字节 8 位二进制中前六位表示状态 后面的两位及第二字节的 8 位 共 10 位二进制 表示航向度数 第一字节第二字节 8765432187654321 暂 无 定 义 暂 无 定 义 实 时 差 分 G P S G P S 定 位 已 否 东 经 西 经 南 纬 北 纬 航向 0 南纬1 北纬 0 东经1 西经 0 GPS 不定位1 GPS 已定位 0 实时 GPS1 差分 GPS 注 数据包中的状态信息均为数据包中时间位记录的那一刻状态 例如 值为 0 x05 0 x4C 变成二进制是 00001010 1001100 即表示 GPS 已定位 实时 GPS 北纬 东经 航向 332 状态信息 电压等级 GSM 信号强度字段 请参考 状态信息 协议 其它字段同 LBS 地 址定位协议 3 10 2 2 4 响应 信息内容格式 版本状态 长度 byte 11 3 10 2 2 4 1 状态 0 成功 1 包格式不正确 3 10 2 3 3 10 2 3 LBSLBS 报警数据包 报警数据包 0 x040 x04 3 10 2 3 1 协议号 0 x00 0 x04 3 10 2 3 2 作用 向服务器发送告警 服务器定位后返回内容给终端 终端向预存的号码发送告 警 3 10 2 3 3 输入 信息内容 格式版 本 状 态 TAMCCMNCLACCIRSSICOUNTNLACNCINRSSI 长度 byte 121212311231 3 10 2 3 4 状态 代码功能内容 0 x0001 SOS 报警地址 0 x0002 低电报警报警提示 其它字段解释同 多基站定位 协议 3 10 2 3 5 服务器响应 信息内容格式 版本状态电话内容 长度 byte 1121N 3 10 2 3 5 1 状态 0 成功 其它失败 3 10 2 3 5 2 电话 电话号码字符串 UTF 8 格式 3 10 2 3 5 3 地址 地址信息 UTF 8 格式 3 10 2 4 3 10 2 4 GPSGPS 报警数据包 报警数据包 0 x170 x17 3 10 2 4 1 协议号 0 x00 0 x17 3 10 2 4 2 作用 向服务器发送告警 服务器定位后返回内容给终端 终端向预存的号码发送告 警 3 10 2 4 3 输入 信息内容 格式 版 本 状 态 日 期 时 间 卫 星 数 纬 度 经 度 速 度 状 态 航 向 长度 byte 12414412 3 10 2 4 4 状态 代码功能内容 0 x0001 SOS 报警地址 0 x0002 低电报警报警提示 其它字段解释同 GPS LBS 定位 协议 GPS 部分 3 10 2 4 5 服务器响应 信息内容格式 版本状态电话内容 长度 byte 1121N 3 10 2 4 5 1 状态 0 成功 其它失败 3 10 2 4 5 2 电话 电话号码字符串 UTF 8 格式 3 10 2 4 5 3 地址 地址信息 UTF 8 格式 3 10 2 5 3 10 2 5 LBSLBS 短信请求地址 短信请求地址 0 x050 x05 3 10 2 5 1 协议号 0 x00 0 x05 3 10 2 5 2 作用 获取地址 3 10 2 5 3 输入 信息内容 格式 版 本 语 言 电 话 号 码 T A M C C M N C L A C C I R S S I C O U N N L A C N C I N R S S 3 10 2 5 4 版本 0 返回地址 1 返回经纬度 3 10 2 5 5 语言 0 中文 1 英文 其它 根据需要再定义 3 10 2 5 6 电话号码 地址短信要发送的号码 其它字段解释同 多基站定位 协议 3 10 2 5 7 服务器响应 信息内容格式 版本状态语言电话地址 长度 byte 11121N 3 10 2 5 7 1 地址 格式 版本 0 地址 经度 纬度 版本 1 纬度 经度 校准后纬度 校准后经度 例 22 54545 113 91919 22 44545 113 81919 其它字段解释同 LBSLBS SOSSOS 报警数据包 协议 3 10 2 6 3 10 2 6 GPSGPS 短信请求地址 短信请求地址 0 x180 x18 3 10 2 6 1 协议号 0 x00 0 x18 3 10 2 6 2 作用 获取地址 3 10 2 6 3 输入 信息内容 格式 版 本 语 言 电 话 号 码 日 期 时 间 卫 星 数 纬 度 经 度 速 度 状 态 航 向 长度 byte 1121414412 TI 长度 byte 11211212311231 3 10 2 6 4 版本 0 返回地址 1 返回经纬度 3 10 2 6 5 语言 0 中文 1 英文 其它 根据需要再定义 3 10 2 6 6 电话号码 地址短信要发送的号码 其它字段解释同 GPS LBS 定位 协议 GPS 部分 3 10 2 6 7 服务器响应 信息内容格式 版本状态语言电话地址 长度 byte 11121N 3 10 2 6 7 1 地址 格式 版本 0 地址 经度 纬度 版本 1 经度 纬度 例 22 54545 113 91919 其它字段解释同 LBSLBS SOSSOS 报警数据包 协议 3 10 2 7 3 10 2 7 帧响应 帧响应 0 x160 x16 3 10 2 7 1 协议号 0 x00 0 x016 3 10 2 7 2 作用 通知服务端已经收到一帧数据 服务端收到后再发下一帧 3 10 2 7 3 输入 信息内容 格式 版本帧协议号帧序号 长度 byte 124 3 10 2 7 4 帧协议号 数据帧对应的协议号 3 10 2 7 5 帧序号 终端收到的数据帧中的 帧序号 服务端生成 终端回复时使用该值 3 10 2 7 6 服务器响应 无响应 3 10 3 3 10 3 状态信息状态信息 0 x15 0 x15 3 10 3 1 3 10 3 1 协议号 0 x00 0 x15 3 10 3 2 3 10 3 2 作用 上报终端状态 3 10 3 3 3 10 3 3 输入 信息内容 格式 版本状态信息电压等级GSM 信号强度等级 长度 Byte 1111 3 10 3 3 1 状态信息 占用 1 个字节 用来表示手机的各种状态信息 把 1 个字节看作 8 位 最低位为 0 位 最高位为 7 位 传送时先传送高位 再传送低位 各位代表的具体含义如 下 高位低位 76543210 第 0 位保留 第 1 位保留 第 2 位保留 第 5 3 位 000 正常 001 震动报警 010 断电报警 011 强行关机报警 100 SOS 报警 101 震动 报警 第 6 位 0 GPS 不定位 1 GPS 已定位 第 7 位保留 注 数据包中的状态信息均为数据包中时间位记录的那一刻状态 3 10 3 3 2 电压等级 十进制 范围为 0 6 标示电压大小由低到高 0 低电关机 1 电量不足以打电话发短信等 2 低电报警 3 低电 可正常使用 3 6 均可正常使用 只是依据电量多少不同而排列 3 10 3 3 3 GSM 信号强度等级 0 x00 无信号 0 x01 信号极弱 0 x02 信号较弱 0 x03 信号良好 0 x04 信号强 3 10 3 4 3 10 3 4 响应 信息内容格式 版本状态 长度 byte 11 3 10 3 4 1 1 状态 0 成功 1 包格式不正确 3 10 4 3 10 4 服务器下发消息服务器下发消息 指令指令 0 x0F 0 x0F 3 10 4 1 3 10 4 1 协议号 0 x00 0 x0F 3 10 4 2 3 10 4 2 作用 用作服务器下发消息 指令通道 3 10 4 3 3 10 4 3 输入 参数类型 长度 必选默认值 范围说明 versionnumber 3 true0 typenumbertrue 0 指令 1 消息 下发内容类型 若为消若为消 息 则不需要响应息 则不需要响应 seqnumbertrue 指令流水号 contentstringtrue 下发内容 可以是短 信指令 开发时具体 约定 3 10 4 4 3 10 4 4 响应 参数类型 长度 返回值 范围说明 versionnumber 3 0 版本 statusnumber 2 0 成功 其它失败 状态 typenumber 0 指令 1 消息 内容类型 seqnumber 指令流水号 contentstring 响应内容 3 10 4 5 3 10 4 5 指令列表指令列表 3 10 4 5 1 设置设置 SOSSOS 号码号码 3 10 4 5 1 1 指令 SOS A 号码 1 号码 2 号码 3 号码 4 号码 5 空号码之间的 分隔符号保留 例 SOS A13834528796SOS A138345287963 10 4 5 1 2 响应 3 10 4 5 1 2 1 成功 SOS Success 3 10 4 5 1 2 2 失败 SOS Fail 注意 如果在终端修改 SOS 号码 则使用下面的查询 SOS 号码的响应包格式 上传到服务器 其中的指令流水号请置为 0 3 10 4 5 2 查询查询 SOSSOS 号码号码 3 10 4 5 2 1 指令 SOS Q 3 10 4 5 2 2 响应 SOS Q 号码 1 号码 2 号码 3 号码 4 号码 5 例 SOS Q13834528796参考设置 SOS 号码 3 10 4 5 3 设置设置 HELPHELP 号码号码 3 10 4 5 3 1 指令 HLP A 号码 1 号码 2 号码 3 号码 4 号码 5 格式参考设置 SOS 号码 3 10 4 5 3 2 响应 3 10 4 5 3 2 1 成功 HLP Success 3 10 4 5 3 2 2 失败 HLP Fail 注意 如果在终端修改 HELP 号码 则使用下面的查询 HELP 号码的响应包格 式上传到服务器 其中的指令流水号请置为 0 3 10 4 5 4 查询查询 HELPHELP 号码号码 3 10 4 5 4 1 指令 HLP Q 3 10 4 5 4 2 响应 HLP Q 号码 1 号码 2 号码 3 号码 4 号码 5 例 HLP Q138345287963 10 4 5 5 远程开机远程开机 3 10 4 5 5 1 指令 POWERON 3 10 4 5 5 2 响应 3 10 4 5 5 2 1 成功 POWERON Success 3 10 4 5 5 2 2 失败 POWERON Fail 3 10 4 5 6 远程关机 伪 远程关机 伪 3 10 4 5 6 1 指令 POWEROFF 3 10 4 5 6 1 1 成功 POWERON Success 3 10 4 5 6 1 2 失败 POWERON Fail 3 10 4 5 7 隐身隐身 3 10 4 5 7 1 指令 HIDE 状态 周一到周五状态设置 课编号 时间 状态 课编号 时间 状 态 周六状态设置 课编号 时间 状态 课编号 时间 状态 周 日状态设置 课编号 时间 状态 课编号 时间 状态 状态 0 隐身 1 取消隐身 如果只设某一部分 其它部分需要的 分隔符合保留 例如 周一到周五 周六 周日第一节课隐身第二节课取消隐身 HIDE 0 1 8 30 10 30 0 2 14 30 16 30 1 1 8 30 10 30 0 2 14 30 16 30 1 1 8 30 10 30 0 2 14 30 16 30 1 只设周一到周五 HIDE 0 1 8 30 10 30 0 2 14 30 16 30 1 只设周日 HIDE 0 1 8 30 10 30 0 2 14 30 16 30 1 注意 如果在终端修改隐身状态或隐身时间段 则使用下面的查询隐身状态的 响应包格式上传到服务器 其中的指令流水号请置为 0 3 10 4 5 7 2 响应 3 10 4 5 7 2 1 成功 HIDE Success 3 10 4 5 7 2 2 失败 HIDE Fail 3 10 4 5 8 查询隐身状态查询隐身状态 3 10 4 5 8 1 指令 HIDE Q 3 10 4 5 8 2 响应 HIDE Q 0 1 8 30 10 30 0 2 1 8 0 1 8 30 10 30 0 2 1 8 0 1 8 30 10 30 0 2 1 8 0 3 10 5 3 10 5 设备上传消息设备上传消息 指令指令 0 x19 0 x19 3 10 5 1 3 10 5 1 协议号 0 x00 0 x19 3 10 5 2 3 10 5 2 作用 用作设备上传消息 指令通道 3 10 5 3 3 10 5 3 输入 参数类型 长度 必选默认值 范围说明 versionnumber 3 true0 typenumbertrue 0 指令 1 消息 上传内容类型 若为消若为消 息 则不需要响应息 则不需要响应 seqnumbertrue 流水号 contentstringtrue上传内容 参数 开 发时具体约定 具 体内容参见附录 3 10 5 4 3 10 5 4 响应 参数类型 长度 返回值 范围说明 versionnumber 3 0 版本 statusnumber 2 0 成功 其它失败 状态 typenumber 0 指令 1 消息 内容类型 seqnumber 流水号 contentstring 响应内容 3 10 5 5 3 10 5 5 指令列表指令列表 3 10 5 5 1 调整时间调整时间 3 10 5 5 1 1 3 10 5 5 1 1 输入输入 参数类型 长度 必选默认值 范围说明 versionnumber 3 true0 methodStringTrueadjustTime 3 10 5 5 1 2 3 10 5 5 1 2 响应响应 参数类型 长度 必选默认值 范围说明 versionnumber 3 true0 methodStringtrueadjustTime timenumbertrue UTC 秒数 3 10 6 3 10 6 查询服务器时间查询服务器时间 0 x20 0 x20 3 10 6 1 3 10 6 1 协议号 0 x00 0 x20 3 10 6 2 3 10 6 2 作用 获取服务器当前时间 用于校准时间 3 10 6 3 3 10 6 3 输入 参数类型 长度 必选默认值 范围说明 versionnumber 3 true0 typenumbertrue 0 UTC 1 Local 时间类型 目前只支持 UTC 3 10 6 4 3 10 6 4 响应 参数类型 长度 返回值 范围说明 versionnumber 3 0 版本 statusnumber 2 0 成功 其它失败 状态 typenumber 0 UTC 1 Local 时间类型 timenumber 时间 单位秒 3 10 7 3 10 7 微博微博 互助社区协议互助社区协议 3 10 7 1 3 10 7 1 获取最新微博获取最新微博 0 x06 0 x06 3 10 7 1 1 协议号 0 x00 0 x06 3 10 7 1 2 作用 获取用户最新的几条微博 3 10 7 1 3 输入 参数类型 长度 必选默认值 范围说明 versionnumber 3 true0 版本 0 methodstring 30 truegetMyT 方法 uidnumber 12 true 有 qid 有 uid 表示查 询指定群指定用户 有 qid 无 uid 表示查 询指定群当前用户 无 qid 有 uid 表示查 询指定用户 无 qid 无 uid 表示查 询当前用户 用户 ID qidnumber 12 false 群 ID num number 5 false15 请求微博条数 btypenumber 1 true 0 微博 1 互助 业务类型 business type 例 获取用户 123456789012345 最近的 20 条微博 version 0 method getMyT uid 123456789012345 qid 13452 num 20 btype 0 3 10 7 1 4 响应 参数参数类型 长度 返回值 范围说明 versionnumber 3 0 版本 totalnumber 5 记录数 btypenumber 1 0 微博 1 互助 业务类型 uidnumber 12 用户 id likecountnumber 5 喜欢数 sys timenumber 10 插入记录系统时间 cmtcountnumber 5 评论数 cunamestring 40 微博名称 alatnumber 12 校准后的纬度 fromnumber 5 0 手机客户端 1 电脑网页版 101 手机网页 版 8 户外手机 11 安卓手机 12 小土豆 微博来源 citystring 50 城市 idnumber 20 记录 id alngnumber 12 校准后的经度 cuidnumber 12 被评论者 ID from namestring 20 来自哪里 群或网页 或手机 nickNamestring 20 昵称 loctypestring 6 定位类型 IP gps lbs pathstring 100 图片路径 placestring 255 详细地址 favcountnumber 5 收藏数 statusnumber 1 0 未传完 1 传完 2 不公开 文件上传状态 微 博状态 unamestring 20 用户名 extendstring 100 扩展字段 目前未 使用 recountnumber 5 转播数 pvo 父微博内容 一 条完整的微博 包 含 key 对应的所有 value mark namestring 40 备注名