JTEXT-車載終端擴展協(xié)議版本號修訂日期修訂內(nèi)容修訂人備注V1.02015.02.19創(chuàng)建LyV1.12015.03.02目前支持9種報文LyV1.22015.04.28按照2013版JTT808修改透傳內(nèi)容LyJTEXT-車載終端擴展協(xié)議 11 說明 22 接入流程 23 消息類型 24 消息流 34.1 設(shè)備注冊 34.2 設(shè)備注銷 44.3 登錄鑒權(quán) 44.4 保持心跳 54.5 上報數(shù)據(jù)點 54.6 查詢數(shù)據(jù)流最新值 64.7 設(shè)備間數(shù)據(jù)透傳上行 74.8 設(shè)備間數(shù)據(jù)透傳下行 8

說明基于《道路運輸車輛衛(wèi)星定位系統(tǒng)北斗兼容車載終端通信協(xié)議規(guī)范.pdf》實現(xiàn)擴展功能。消息頭中的終端手機號，最長12位，若使用專網(wǎng)卡，則填入卡號后12位。協(xié)議中未使用字段，請使用0x00填充。接入流程Onenet門戶/注冊用戶，設(shè)置頁面查看用戶ID；通過設(shè)備管理頁面或調(diào)用API接口添加設(shè)備，只需填寫title和activate_code兩個域，其中title為任意自定義字符串，activate_code包括兩個域："activate_code":{ "mt":"A",//終端型號，自定義，長度不超過19個字節(jié) "mid":"2CX31B",//終端ID，自定義，長度不超過6字節(jié) }設(shè)備出廠第一次登錄，發(fā)送激活碼進行注冊，注冊成功后平臺下發(fā)授權(quán)碼，設(shè)備需要持久化存儲授權(quán)碼；后續(xù)登錄，設(shè)備利用授權(quán)信息進行登錄認證。平臺服務(wù)器地址2，TCP端口4362，UDP端口4363消息類型支持如下JTT808消息類型:消息ID消息體名稱格式定義（見T808）0x0001終端通用應(yīng)答8.10x8001平臺通用應(yīng)答8.20x0002終端心跳8.30x0100終端注冊8.40x8100終端注冊應(yīng)答8.50x0101終端注銷8.60x0102終端鑒權(quán)8.70x8900數(shù)據(jù)下行透傳8.490x0900數(shù)據(jù)上行透傳8.50擴展消息:JTT808消息ID透傳消息類型說明0x09000xF0設(shè)備上報數(shù)據(jù)點到平臺進行存儲0xF2設(shè)備查詢本設(shè)備上指定數(shù)據(jù)流最新值0xF4設(shè)備透傳自定義數(shù)據(jù)到另外的設(shè)備或業(yè)務(wù)平臺0x89000xF3平臺返回查詢的數(shù)據(jù)流最新值0xF5設(shè)備接收來自某個設(shè)備或平臺透傳的自定義數(shù)據(jù)消息流設(shè)備注冊該流程只在終端出廠后第一次上電時執(zhí)行，且只執(zhí)行一次，根據(jù)激活碼，注冊獲取授權(quán)信息。消息流程圖3.1 終端注冊消息，攜帶信息（即，激活信息）包括：制造商ID：填寫設(shè)備云注冊用戶后得到的用戶ID的整型值（非ASCII碼），占5個字節(jié)，例如用戶ID10021，則該字段需要編碼為：0x0000002725（而非0x3130303231）；終端型號：填寫在設(shè)備云注冊設(shè)備時，填寫激活碼的mt部分，ASCII碼，最多20字節(jié)，不足在后面補0x00；終端ID：填寫在設(shè)備云注冊設(shè)備時，填寫激活碼的mid部分，ASCII碼，最多7字節(jié)，不足在后面補0x00；終端注冊消息中的其他未使用字段填0x00。 若注冊成功，平臺在應(yīng)答消息中將下發(fā)授權(quán)碼，設(shè)備持久化保存授權(quán)碼，之后的登錄，需要使用該授權(quán)碼進行登錄鑒權(quán)。設(shè)備注銷該流程重置設(shè)備于非激活狀態(tài)，不能用于普通的登出。登錄鑒權(quán)設(shè)備注冊后每次在與平臺建立連接后，應(yīng)立即進行鑒權(quán)。鑒權(quán)成功前終端不得發(fā)送其它消息。平臺響應(yīng)平臺通用應(yīng)答消息。（注：同一次連接中，注冊后不用在發(fā)送登錄鑒權(quán)）。保持心跳在沒有數(shù)據(jù)發(fā)送時，若需保持連接，設(shè)備應(yīng)每隔30秒主動向平臺發(fā)送心跳，平臺立即回復(fù)通用應(yīng)答消息。上報數(shù)據(jù)點利用數(shù)據(jù)上行透傳消息（ID：0x0900）上報數(shù)據(jù)點，每次只能上報一種數(shù)據(jù)點，該消息消息體格式：起始字節(jié)字段數(shù)據(jù)類型描述及要求0透傳消息類型BYTE固定值0xF01數(shù)據(jù)點類型BYTE1：json數(shù)據(jù);2：二進制數(shù)據(jù)2數(shù)據(jù)點內(nèi)容BYTE[]有兩種數(shù)據(jù)點，見后面表格描述 有兩種數(shù)據(jù)點，封裝方法：A普通json數(shù)據(jù)點，內(nèi)容格式：Json包長度DWORD描述json長度(小于1M)Json數(shù)據(jù)點數(shù)組BYTE[][{”ds_id”:”image”,//數(shù)據(jù)流ID，（必填）“at”:”2014-10-2512:23:23”,//時間，（可選）”value”://數(shù)字，字符串，object}]B二進制數(shù)據(jù)點，每次傳遞一個二進制數(shù)據(jù)點，內(nèi)容格式：Json包長度WORD描述json長度(小于4K)二進制數(shù)據(jù)json描述BYTE[]{”ds_id”:”image”,//數(shù)據(jù)流ID，（必填）“at”:”2014-10-2512:23:23”,//時間，（可選）”desc”:字符串或json對象//對后二進制數(shù)據(jù)的描述（可選）}二進制數(shù)據(jù)長度DWORD用戶二進制數(shù)據(jù)總大小（小于1M）二進制數(shù)據(jù)BYTE[]用戶需要保存的二進制數(shù)據(jù)內(nèi)容消息流程：查詢數(shù)據(jù)流最新值利用JTT808數(shù)據(jù)上行透傳消息（ID：0x0900）查詢該設(shè)備上報的某個數(shù)據(jù)流最新值，消息體格式：起始字節(jié)字段數(shù)據(jù)類型描述及要求0透傳消息類型BYTE固定值0xF21數(shù)據(jù)流ID長度WORD本條消息的長度（數(shù)據(jù)流ID1長度）3數(shù)據(jù)流ID字符串BYTE[]需要查詢的數(shù)據(jù)流ID字符串查詢數(shù)據(jù)流最新響應(yīng)平臺收到請求后，利用JTT808數(shù)據(jù)下行透傳消息（ID：0x8900）按照順序返回每個數(shù)據(jù)流的當(dāng)前值，消息體格式：起始字節(jié)字段數(shù)據(jù)類型描述及要求0透傳消息類型BYTE固定值0xF35Json長度DWORD后面json數(shù)據(jù)結(jié)構(gòu)長度7查詢結(jié)果json內(nèi)容BYTE[]{”ds_id”:”temperature”,//數(shù)據(jù)流ID“at”:”2014-10-2512:23:23”,//時間”value”:22.4//數(shù)字，字符串，object}消息流程：設(shè)備間數(shù)據(jù)透傳上行利用JTT808數(shù)據(jù)上行透傳消息（ID：0x0900），將用戶自定義的數(shù)據(jù)，傳遞給某個設(shè)備。消息體格式：起始字節(jié)字段數(shù)據(jù)類型描述及要求0透傳消息類型BYTE固定值0xF41目的地址長度WORD本條消息的長度3目的設(shè)備IDBYTE[]添加設(shè)備時平臺分配的設(shè)備ID3+m透傳數(shù)據(jù)長度DWORD上行透傳數(shù)據(jù)長度(小于64K)3+4+m透傳數(shù)據(jù)BYTE[]用戶透傳數(shù)據(jù)平臺收到數(shù)據(jù)后，回復(fù)通用應(yīng)答消息。設(shè)備間數(shù)據(jù)透傳下行利用JTT808數(shù)據(jù)下行透傳消息（ID：0x8900）