位置服務(wù)器對(duì)接云平臺(tái)二進(jìn)制協(xié)議

1、位置服務(wù)器對(duì)接云二進(jìn)制協(xié)議2020/6/19一、概述位置服務(wù)器配置云公網(wǎng) IP 地址（或）和 TCP 端，位置服務(wù)器主動(dòng)登錄到云。登錄成功后，通過(guò)云可以查看、修改位置服務(wù)器的配置和運(yùn)行數(shù)據(jù)。位置服務(wù)器在登錄成功后，可以獲取云分配的客戶編碼、設(shè)備編碼、數(shù)據(jù)上報(bào)服務(wù)器 IP 地址和 UDP 端等信息，位置服務(wù)器根據(jù)獲取的信息上報(bào)數(shù)據(jù)。二、管理通道協(xié)議描述位置服務(wù)器（TCP 客戶端）連接云通道連接，協(xié)議如下：（TCP 服務(wù)端）后，形成一個(gè)傳輸管理數(shù)據(jù)的 TCP前導(dǎo)字節(jié)：2 個(gè)字節(jié)，內(nèi)容固定為 0 x55AA。消息命令：1 個(gè)字節(jié)。協(xié)議版本：1 個(gè)字節(jié)。用于消息的前向兼容，消息內(nèi)容格式必要的調(diào)整，則需

2、升級(jí)版本。目前默認(rèn)為 0消息長(zhǎng)度：2 個(gè)字節(jié)，是后面“消息內(nèi)容”單元的字節(jié)數(shù)。消息內(nèi)容：N 個(gè)字節(jié)，具體內(nèi)容和格式在每個(gè)“消息命令”中確定。CRC 校驗(yàn)：2 個(gè)字節(jié)，是“消息命令”+“協(xié)議版本”+“內(nèi)容長(zhǎng)度”+“消息內(nèi)容”的CRC16的校驗(yàn)值。注意：協(xié)議中的多字節(jié)數(shù)據(jù)（非字符串）采用高字節(jié)，低字節(jié)在后的次序。消息命令：消息命令方向值說(shuō)明登錄請(qǐng)求設(shè)備1請(qǐng)求確認(rèn)設(shè)備名稱登錄應(yīng)答設(shè)備2確認(rèn)設(shè)備名稱，發(fā)送隨機(jī)數(shù)口令驗(yàn)證請(qǐng)求設(shè)備3設(shè)備根據(jù)隨機(jī)數(shù)和口令計(jì)算MD5口令驗(yàn)證應(yīng)答設(shè)備4口令驗(yàn)證成功/失敗設(shè)備狀態(tài)請(qǐng)求設(shè)備5周期性的查詢位置服務(wù)器狀態(tài)設(shè)備狀態(tài)應(yīng)答設(shè)備6增加地圖請(qǐng)求設(shè)備7增加地圖應(yīng)答設(shè)備8刪除地圖請(qǐng)求

3、設(shè)備9刪除地圖應(yīng)答設(shè)備10修改地圖請(qǐng)求設(shè)備11修改地圖應(yīng)答設(shè)備12遍歷地圖請(qǐng)求設(shè)備13遍歷地圖應(yīng)答設(shè)備14查詢地圖請(qǐng)求設(shè)備15查詢地圖應(yīng)答設(shè)備16增加請(qǐng)求設(shè)備17增加應(yīng)答設(shè)備18刪除請(qǐng)求設(shè)備19刪除應(yīng)答設(shè)備20修改請(qǐng)求設(shè)備21修改應(yīng)答設(shè)備22遍歷請(qǐng)求設(shè)備23遍歷應(yīng)答設(shè)備24查詢請(qǐng)求設(shè)備25查詢應(yīng)答設(shè)備26部署請(qǐng)求設(shè)備27將部署（關(guān)聯(lián)）到地圖上部署應(yīng)答設(shè)備28查詢地圖實(shí)時(shí)狀態(tài)請(qǐng)求設(shè)備29查詢地圖當(dāng)前的活動(dòng)數(shù)量，活動(dòng)數(shù)量。查詢地圖實(shí)時(shí)狀態(tài)應(yīng)答設(shè)備30查詢實(shí)時(shí)狀態(tài)請(qǐng)求設(shè)備31查詢 當(dāng)前的活動(dòng)數(shù)量，基站的時(shí)間。查詢實(shí)時(shí)狀態(tài)應(yīng)答設(shè)備32呼叫請(qǐng)求設(shè)備33呼叫應(yīng)答設(shè)備34事件上報(bào)設(shè)備35消息錯(cuò)誤設(shè)備0 xF

4、F針對(duì)通用數(shù)據(jù)包格式問(wèn)題，如 CRC錯(cuò)誤，命令不識(shí)別，數(shù)據(jù)長(zhǎng)度不對(duì)消息內(nèi)容：1.登錄請(qǐng)求2.登錄成功：應(yīng)答失敗3.口令驗(yàn)證請(qǐng)求4.口令驗(yàn)證應(yīng)答成功：失敗消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0客戶編碼4分配的客戶設(shè)備編碼4分配的該客戶的設(shè)備狀態(tài)查詢周期1秒，范圍（130）。設(shè)備如果 3*N 秒沒(méi)有收到查詢，則認(rèn)為已離線，需重新開(kāi)始登錄。數(shù)據(jù)接收IP 地址4不能為 0數(shù)據(jù)接收端2接收數(shù)據(jù)的 UDP 端，不能為 0上報(bào)的周期2（秒），為非 0 值消息單元長(zhǎng)度（字節(jié)）說(shuō)明口令MD516256 個(gè)字節(jié)的隨機(jī)數(shù)和 1

5、6 個(gè)字符（長(zhǎng)度 16字節(jié)）的口令的 MD5 值，口令長(zhǎng)度16字節(jié)長(zhǎng)度，尾部填空格字符。消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128最多 128 字節(jié)原因詳細(xì)說(shuō)明，方便設(shè)備及時(shí)排除故障。消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0隨機(jī)數(shù)256消息單元長(zhǎng)度（字節(jié)）說(shuō)明設(shè)備名稱32字符串，結(jié)束符0。設(shè)備版本2高字節(jié)為主版本號(hào)，低字節(jié)為子版本號(hào)。版本描述16字符串，結(jié)束符0。5.設(shè)備狀態(tài)請(qǐng)求6.設(shè)備狀態(tài)應(yīng)答失敗消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0設(shè)備連續(xù)運(yùn)行時(shí)間4（秒）

6、消息單元長(zhǎng)度（字節(jié)）說(shuō)明年2當(dāng)前時(shí)間，不能小于 2000月11 12日11 31，依據(jù)年月份自動(dòng)匹配時(shí)10 23分10 59秒10 597.增加地圖請(qǐng)求8.增加地圖應(yīng)答成功：失?。?.刪除地圖請(qǐng)求10. 刪除地圖應(yīng)答成功：失敗：消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）地圖ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0地圖ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明地圖ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0地圖ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明地圖名稱32字符串，結(jié)束符0

7、實(shí)際地域長(zhǎng)度4（厘米）實(shí)際地域?qū)挾?（厘米）備注32字符串，結(jié)束符011. 修改地圖請(qǐng)求12. 修改地圖應(yīng)答成功：失?。合卧L(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）地圖ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0地圖ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明地圖ID4地圖名稱32字符串，結(jié)束符0實(shí)際地域長(zhǎng)度4（厘米）實(shí)際地域?qū)挾?（厘米）備注32字符串，結(jié)束符013. 遍歷地圖請(qǐng)求14. 遍歷地圖應(yīng)答成功：失敗：15. 查詢地圖請(qǐng)求16. 查詢地圖應(yīng)答成功：失?。合卧L(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）地圖ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)

8、度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0地圖ID4地圖名稱32字符串，結(jié)束符0實(shí)際地域長(zhǎng)度4（厘米）實(shí)際地域?qū)挾?（厘米）備注32字符串，結(jié)束符0消息單元長(zhǎng)度（字節(jié)）說(shuō)明地圖ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）起始序號(hào)2獲取數(shù)量2N 小于最大數(shù)量，說(shuō)明遍歷已結(jié)束。地圖 1 ID4地圖 2 ID4.地圖N ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明起始序號(hào)2從 0 開(kāi)始最大數(shù)量2范圍（1 100）17. 增加請(qǐng)求18. 增加成功：應(yīng)答失敗：19. 刪除請(qǐng)求20. 刪除成功：應(yīng)答失?。合卧L(zhǎng)度（字節(jié)

9、）說(shuō)明成功或失敗2失敗原因值（非 0 值）ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明名稱32字符串，結(jié)束符0IP 地址4分站接入的主站 IP，非 0 值分站號(hào)1范圍 0 33備注32字符串，結(jié)束符021. 修改請(qǐng)求22. 修改應(yīng)答成功：失敗：消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為

10、0ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明ID4名稱32字符串，結(jié)束符0IP 地址4非 0 值分站號(hào)1范圍 0 33備注32字符串，結(jié)束符023. 遍歷請(qǐng)求24. 遍歷成功：應(yīng)答失敗：25. 查詢請(qǐng)求26. 查詢成功：應(yīng)答失?。合卧L(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0ID4名稱32字符串，結(jié)束符0IP 地址4分站號(hào)1范圍 0 33關(guān)聯(lián)的地圖ID4“FF”表示沒(méi)有關(guān)聯(lián)地圖備注32字符串，結(jié)束符0消息單元長(zhǎng)度（字節(jié)）說(shuō)明ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度

11、（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）起始序號(hào)2從 0 開(kāi)始獲取數(shù)量2N 小于最大數(shù)量，說(shuō)明遍歷已結(jié)束。1 ID42 ID4.N ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明起始序號(hào)2從 0 開(kāi)始最大數(shù)量2范圍（1 100）27. 部署請(qǐng)求28. 部署應(yīng)答成功：失敗：消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明ID4地圖ID4X 坐標(biāo)4（厘米）Y 坐標(biāo)4（厘米）29. 查詢地圖實(shí)時(shí)狀態(tài)請(qǐng)求30. 查詢地圖實(shí)時(shí)狀態(tài)應(yīng)答成功：失?。?1. 查詢實(shí)時(shí)狀態(tài)請(qǐng)求32. 查詢成功：實(shí)時(shí)狀態(tài)應(yīng)

12、答失?。合卧L(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0ID4時(shí)間4（秒）活動(dòng)數(shù)量4離線原因10：正常1：讀卡天線未連接2：通訊中斷3：擁塞（數(shù)據(jù)來(lái)不及上報(bào)，導(dǎo)致數(shù)據(jù)丟失。）消息單元長(zhǎng)度（字節(jié)）說(shuō)明ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）地圖ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0地圖ID4部署數(shù)量2數(shù)量2活動(dòng)數(shù)量4消息單元長(zhǎng)度（字節(jié)）說(shuō)明地圖ID433. 呼叫請(qǐng)求34. 呼叫成功：應(yīng)答失敗：事件上報(bào)35.36. 消息錯(cuò)誤消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明ID4事件10：下線1：上線消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2失敗原因值（非 0 值）ID4失敗詳細(xì)說(shuō)明128消息單元長(zhǎng)度（字節(jié)）說(shuō)明成功或失敗2成功固定為 0ID4消息單元長(zhǎng)度（字節(jié)）說(shuō)明ID4呼叫模式1呼叫保持時(shí)間1（秒）三、數(shù)據(jù)上報(bào)協(xié)議描述位置服務(wù)器登錄云置服務(wù)器根據(jù)以上信息上報(bào)后，會(huì)取得客戶 ID、設(shè)備 ID、上報(bào)的 IP 地址、UDP 端數(shù)據(jù)。位為保證網(wǎng)絡(luò)適應(yīng)性，UDP 負(fù)載（整個(gè)消息包長(zhǎng)度）不要