RSSP-I安全通信協(xié)議軟件使用說(shuō)明書-B.1

南車時(shí)代下屬部門或業(yè)務(wù)主體的名稱PAGEIIPAGE2設(shè)計(jì)文件版權(quán)專有違者必究中車株洲電力機(jī)車研究所有限公司標(biāo)準(zhǔn)模板：Q/ZS41.17-2011/PD-TP-01-02/V7.1名稱RSSP-I安全通信協(xié)議軟件使用說(shuō)明書編號(hào)版本TE×××-××××××XXRSSP-I安全通信協(xié)議使用說(shuō)明書PAGEII中車株洲電力機(jī)車研究所有限公司（文檔編號(hào)）TG×××-000000XdXPAGEI編制工藝校核標(biāo)準(zhǔn)化審核批準(zhǔn)版本號(hào)更改人更改日期更改說(shuō)明變更編號(hào)A.1陳昕系統(tǒng)創(chuàng)建（自動(dòng)生成）A.2陳昕2016-6-12創(chuàng)建全文A.3陳昕2016-8-8增加Rsp1_Open函數(shù)，修改Rsp1_PackageData函數(shù)描述A.4陳昕2016-9-26按評(píng)審意見修改A.5陳昕2016-10-14修改使用條件中對(duì)于通信周期限制的描述B.1陳昕2017-12-21增加LEU通信相關(guān)接口描述；增加GetRunningCode函數(shù)接口描述；目次TOC\h\z\t"ZS_C標(biāo)題2級(jí),2,ZS_C標(biāo)題1級(jí),1,ZS_C標(biāo)題3級(jí),3,ZS_F附錄標(biāo)識(shí),1,ZS_G附錄標(biāo)題1級(jí),2"1目的和范圍 31.1目的 31.2范圍 32規(guī)范性引用文件 33參考資料 34術(shù)語(yǔ)和縮略語(yǔ) 35概述 36時(shí)序接口 37使用條件 68數(shù)據(jù)類型定義 69應(yīng)用接口函數(shù) 79.1Rsp1_Init 79.2Rsp1_UpdateClock 79.3Rsp1_PackageData 89.4Rsp1_CheckPackage 99.5Rsp1_Close 99.6Rsp1_Open 109.7Rsp1_GetChanelStatus 109.8Rsp1_GetSynData 119.9Rsp1_SetSynData 11附錄A 12A.1附錄及說(shuō)明文件符合性檢查表 12A.2附件及說(shuō)明 12南車時(shí)代下屬部門或業(yè)務(wù)主體的名稱共=NUMPAGES3-4-1頁(yè)第2頁(yè)文件名稱共12頁(yè)第7頁(yè)中車株洲電力機(jī)車研究所有限公司目的和范圍目的本文描述了RSSP-I安全通信協(xié)議軟件的接口方式與具體方法。預(yù)期讀者為上層應(yīng)用開發(fā)用戶及驗(yàn)證、確認(rèn)人員等。范圍本文適用于RSSP-I安全通信協(xié)議軟件使用說(shuō)明。規(guī)范性引用文件本文檔所引用的軌道交通信號(hào)系統(tǒng)通用安全計(jì)算機(jī)平臺(tái)文檔，凡是標(biāo)注版本的，只有標(biāo)注版本適應(yīng)本文檔；沒有標(biāo)注版本的，則引用文檔的最新版本適用于本文檔。序號(hào)標(biāo)準(zhǔn)/文件編號(hào)標(biāo)準(zhǔn)/文件名稱備注1運(yùn)基信號(hào)【2010】267號(hào)RSSP-I鐵路信號(hào)安全通信協(xié)議參考資料序號(hào)文件編號(hào)文件名稱備注————————術(shù)語(yǔ)和縮略語(yǔ)術(shù)語(yǔ)和縮略語(yǔ)見表3。序號(hào)術(shù)語(yǔ)/縮略語(yǔ)描述1LEULinesideElectronicUnit，軌旁電子設(shè)備2RSSPRailwaySignalSafetyProtocol鐵路信號(hào)安全協(xié)議。概述時(shí)序接口軌道交通信號(hào)系統(tǒng)應(yīng)用需在系統(tǒng)運(yùn)行的不同階段調(diào)用RSSP-I安全通信協(xié)議軟件提供的不同函數(shù)接口用于實(shí)現(xiàn)相應(yīng)的功能：1）初始化階段系統(tǒng)應(yīng)執(zhí)行Rsp1_Init函數(shù)，完成對(duì)協(xié)議棧的初始化及參數(shù)配置；2）每個(gè)運(yùn)行周期需要執(zhí)行Rsp1_UpdateClock，以更新協(xié)議棧時(shí)鐘；3）當(dāng)接收到數(shù)據(jù)后，應(yīng)用需要調(diào)用Rsp1_CheckPackage用以驗(yàn)證數(shù)據(jù)包有效性并更新協(xié)議棧；4）當(dāng)需要發(fā)送數(shù)據(jù)時(shí)，應(yīng)用需要調(diào)用Rsp1_PackageData用以打包需要發(fā)送的實(shí)時(shí)安全數(shù)據(jù)；5）當(dāng)設(shè)備需要斷開與某個(gè)外部設(shè)備的鏈接時(shí)，調(diào)用Rsp1_Close后，協(xié)議棧將拒絕對(duì)該外部設(shè)備發(fā)送過(guò)來(lái)的數(shù)據(jù)；當(dāng)需要重新打開時(shí)，調(diào)用Rsp1_Open功能。6）設(shè)備通過(guò)調(diào)用Rsp1_GetChanelStatus獲得某條鏈路狀態(tài)及該鏈路上一包有效數(shù)據(jù)接收周期距當(dāng)前周期數(shù)。7）當(dāng)系統(tǒng)處于兩系運(yùn)行時(shí)，設(shè)備主系可在每周期所有Rsp1_PackageData函數(shù)執(zhí)行后調(diào)用Rsp1_GetSynData，用以獲取當(dāng)前協(xié)議棧所有鏈路運(yùn)行狀態(tài)；8）當(dāng)系統(tǒng)處于兩系運(yùn)行時(shí)，設(shè)備備系可在每周期Rsp1_UpdateClock函數(shù)執(zhí)行前調(diào)用Rsp1_SetSynData，用以將主系協(xié)議棧數(shù)據(jù)同步到備系。系統(tǒng)初始化階段示例如下圖：RSSP-I安全通信協(xié)議軟件初始化LEU接口使用LEU_Init函數(shù)。系統(tǒng)每周期與RSSP-I安全通信協(xié)議軟件接口接口示例如下：RSSP-I安全通信協(xié)議軟件接口調(diào)用順序注：虛線框內(nèi)接口應(yīng)根據(jù)軌道交通信號(hào)系統(tǒng)應(yīng)用實(shí)際情況調(diào)用，不強(qiáng)制調(diào)用。對(duì)于LEU操作如下流程圖：LEU通信接口接口調(diào)用順序使用條件RSSP-I安全通信協(xié)議軟件可用于：封閉式傳輸系統(tǒng)中的軌道交通信號(hào)系統(tǒng)信號(hào)設(shè)備；加入加密等措施，滿足開放式傳輸系統(tǒng)防護(hù)條件的開放式傳輸系統(tǒng)中的軌道交通信號(hào)系統(tǒng)信號(hào)設(shè)備；適用于嵌入式、PC、工作站及服務(wù)器等硬件環(huán)境。RSSP-I安全通信協(xié)議軟件可通過(guò)源碼、鏈接庫(kù)（可通過(guò)C或C++編譯器編譯生成）等方式被軌道交通信號(hào)設(shè)備使用。RSSP-I安全通信協(xié)議軟件應(yīng)用于2乘2取2安全計(jì)算機(jī)平臺(tái)時(shí)，可使用RSSP-I安全通信協(xié)議軟件提供的獲取同步數(shù)據(jù)接口及同步數(shù)據(jù)設(shè)置接口對(duì)主備系間協(xié)議狀態(tài)進(jìn)行同步，以保證主備系切換時(shí)，通信可以維持。RSSP-I安全通信協(xié)議軟件應(yīng)用于熱備或其他計(jì)算機(jī)平臺(tái)時(shí)，建議周期性使用RSSP-I安全通信協(xié)議軟件提供的獲取同步數(shù)據(jù)接口及同步數(shù)據(jù)設(shè)置接口對(duì)主備系間協(xié)議狀態(tài)進(jìn)行同步，以保證系別切換時(shí)，通信可以維持。如果不進(jìn)行同步，可能會(huì)造成若干周期的通信中斷。RSSP-I安全通信協(xié)議軟件應(yīng)集成在固定周期的軌道交通信號(hào)系統(tǒng)中的子系統(tǒng)應(yīng)用中或軌道交通信號(hào)系統(tǒng)中的子系統(tǒng)應(yīng)用按照固定周期觸發(fā)RSSP-I安全通信協(xié)議軟件。須滿足基本運(yùn)行硬件要求500K字節(jié)以上運(yùn)行內(nèi)存、10K字節(jié)以上的配置文件存儲(chǔ)空間，并保證分配內(nèi)存與配置文件存儲(chǔ)空間獨(dú)立。RSSP-I安全通信協(xié)議軟件對(duì)傳輸系統(tǒng)的物理層和鏈路層無(wú)特定依賴，但需要用戶考慮傳輸系統(tǒng)中的網(wǎng)絡(luò)傳輸負(fù)載、帶寬及網(wǎng)絡(luò)拓?fù)涞纫蛩厥欠窈侠?，并保證實(shí)時(shí)數(shù)據(jù)幀、對(duì)時(shí)請(qǐng)求幀、對(duì)時(shí)應(yīng)答幀可以傳輸?shù)綄?duì)方。用戶應(yīng)正確使用RSSP-I安全通信協(xié)議軟件提供的接口。目前RSSP-I安全通信協(xié)議軟件僅進(jìn)行了時(shí)代電氣安全計(jì)算機(jī)平臺(tái)提供的WindRiverCert平臺(tái)編譯器的確認(rèn)測(cè)試，如用于其他平臺(tái)或更換編譯器、更換處理器，需要對(duì)使用的編譯器、處理器進(jìn)行確認(rèn)測(cè)試，并對(duì)RSSP-I安全通信協(xié)議軟件功能進(jìn)行重新確認(rèn)測(cè)試。數(shù)據(jù)類型定義數(shù)據(jù)類型表數(shù)據(jù)類型原型說(shuō)明UTinytypedefunsignedchar無(wú)符號(hào)8位UShorttypedefunsignedshort無(wú)符號(hào)16位ULongtypedefunsignedlong無(wú)符號(hào)32位S_MsgtypedefstructTAG_Msg{UShortlength;UTinybuff[c_BUFF_SIZE];}S_Msg;應(yīng)用數(shù)據(jù)幀結(jié)構(gòu)體S_SsMsgtypedefstructTAG_SsMsg{UShortlength;Tinybuff[c_SSR_SIZE];}S_SsMsg;對(duì)時(shí)數(shù)據(jù)結(jié)構(gòu)體E_BooltypedefenumTAG_Bool{r_FALSE=0x05555555U,r_TRUE=0x0AAAAAAAU}E_Bool;自定義布爾枚舉應(yīng)用接口函數(shù)Rsp1_Init接口函數(shù)Rsp1_Init描述接口函數(shù)Rsp1_Init原型聲明E_BoolRsp1_Init(constUShortselfDevId_U16,constUShortinCfgLen_U16,UTiny*constinCfgBuf);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UShortselfDevId_U16:本設(shè)備ID;UShortinCfgLen_U16：配置數(shù)據(jù)長(zhǎng)度；UTiny*inCfgBuf：配置數(shù)據(jù)緩存區(qū)首地址。返回值描述配置成功，返回r_TRUE；配置失敗，返回r_FALSE。功能描述檢查傳入配置是否完整，如配置完整，初始化協(xié)議棧配置。為協(xié)議棧分配空間。該函數(shù)在系統(tǒng)初始化階段調(diào)用。函數(shù)檢查了傳入的配置數(shù)據(jù)區(qū)域CRC的正確性，如果CRC檢查正確，則執(zhí)行初始化過(guò)程，否則將協(xié)議棧內(nèi)容數(shù)據(jù)置為0。Rsp1_UpdateClock接口函數(shù)Rsp1_UpdateClock描述接口函數(shù)Rsp1_UpdateClock原型聲明voidRsp1_UpdateClock(void);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述無(wú)返回值描述無(wú)功能描述更新周期時(shí)鐘。該函數(shù)在系統(tǒng)執(zhí)行每個(gè)通信周期都需要進(jìn)行調(diào)用，如未每個(gè)通信周期進(jìn)行調(diào)用，將導(dǎo)致所有通信鏈路通信狀態(tài)判斷錯(cuò)誤。Rsp1_PackageData接口函數(shù)Rsp1_PackageData描述接口函數(shù)Rsp1_PackageData原型聲明UTinyRsp1_PackageData(constUShortinDstDevId_U16,constS_Msg*inMsg,S_Msg*outMsg,S_SsMsg*outSseMsg,S_SsMsg*outSsrMsg);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UShortinDstDevId_U16：設(shè)備識(shí)別號(hào)；S_Msg*inMsg：需要封裝的數(shù)據(jù)；S_Msg*outMsg：封裝后的數(shù)據(jù)；S_SsMsg*outSseMsg：封裝后的對(duì)時(shí)請(qǐng)求數(shù)據(jù);S_SsMsg*outSsrMsg：封裝后的對(duì)時(shí)應(yīng)答數(shù)據(jù)。返回值描述錯(cuò)誤的數(shù)據(jù)接收方類型或識(shí)別號(hào)，返回0；打包數(shù)據(jù)長(zhǎng)度大于最大允許長(zhǎng)度，返回1；打包TSD和對(duì)時(shí)幀（SSR或SSE），返回2；已打包TSD，返回3。功能描述如發(fā)送對(duì)象的設(shè)備不在配置數(shù)據(jù)中，需要向上層應(yīng)用匯報(bào)，并拒絕組幀。如發(fā)送數(shù)據(jù)大于最大應(yīng)用數(shù)據(jù)允許長(zhǎng)度(1200字節(jié))，需要向上層應(yīng)用匯報(bào)，并拒絕組幀。當(dāng)查找到對(duì)應(yīng)設(shè)備且發(fā)送數(shù)據(jù)在允許應(yīng)用數(shù)據(jù)允許長(zhǎng)度內(nèi)時(shí)，則填入指定緩沖進(jìn)行組幀。數(shù)據(jù)幀與對(duì)時(shí)幀（SSE與SSR）緩沖需要分開。并分別告知上層應(yīng)用打包后的數(shù)據(jù)幀和對(duì)時(shí)幀數(shù)據(jù)包長(zhǎng)度。Rsp1_CheckPackage接口函數(shù)Rsp1_CheckPackage描述接口函數(shù)Rsp1_CheckPackage原型聲明UTinyRsp1_CheckPackage(constUShortinDstDevId_U16,constUShortinLen_U16,UTiny*inBuf,UShort*outLen,UTiny*outBuf);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UShortinDstDevId_U16：設(shè)備識(shí)別號(hào)；UShortinLen_U16：需要校驗(yàn)數(shù)據(jù)長(zhǎng)度；UTiny*inBuf：需要校驗(yàn)的數(shù)據(jù)起始地址；UShort*outLen：校驗(yàn)后的數(shù)據(jù)長(zhǎng)度存放地址；UTiny*outBuf：校驗(yàn)后的數(shù)據(jù)起始地址。返回值描述錯(cuò)誤的數(shù)據(jù)來(lái)源設(shè)備類型或識(shí)別號(hào)，返回0；接收數(shù)據(jù)長(zhǎng)度大于最大允許長(zhǎng)度，返回1；接收到SSE或SSR，返回2；接收到RSD，返回3。功能描述如填入數(shù)據(jù)長(zhǎng)度大于協(xié)議允許數(shù)據(jù)長(zhǎng)度，協(xié)議拒絕進(jìn)行解析。當(dāng)填入數(shù)據(jù)長(zhǎng)度小于等于協(xié)議允許數(shù)據(jù)長(zhǎng)度，協(xié)議棧檢查傳入的數(shù)據(jù)幀緩沖區(qū)，對(duì)不同的幀類型做判斷：如為SSE幀，則反饋SSR幀；如為SSR幀，則更新本地連接序列號(hào)及時(shí)間戳；如果是數(shù)據(jù)幀，則對(duì)時(shí)間戳、序列號(hào)等做檢查，如果在容忍范圍內(nèi)則認(rèn)為該數(shù)據(jù)幀有效，更新通信鏈路狀態(tài)，并將應(yīng)用數(shù)據(jù)緩沖返回給上層應(yīng)用。如時(shí)間戳、序列號(hào)超出允許范圍或CRC校驗(yàn)失敗，則需要丟棄該數(shù)據(jù)幀。建議安全設(shè)備中該函數(shù)輸出的校驗(yàn)后數(shù)據(jù)應(yīng)當(dāng)Rsp1_GetChanelStatus結(jié)果為鏈路狀態(tài)正常時(shí)才予以選用。Rsp1_Close接口函數(shù)Rsp1_Close描述接口函數(shù)Rsp1_Close原型聲明E_BoolRsp1_Close(constUShortinDstDevId_U16);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述E_BoolinDstDevId_U16：數(shù)據(jù)接收方設(shè)備識(shí)別號(hào)。返回值描述關(guān)閉已關(guān)閉鏈路，返回r_TRUE；成功關(guān)閉鏈路，返回r_FALSE。功能描述將輸入設(shè)備類型、設(shè)備識(shí)別號(hào)對(duì)應(yīng)的鏈路置為關(guān)閉狀態(tài)，協(xié)議棧將拒絕對(duì)應(yīng)設(shè)備傳入數(shù)據(jù)。如果傳入設(shè)備無(wú)法找到時(shí)，將向上層匯報(bào)，并返回鏈路關(guān)閉失敗。只有當(dāng)查找到傳入設(shè)備時(shí)，且鏈路處于打開狀態(tài)，則關(guān)閉鏈路并返回“真”。Rsp1_Open接口函數(shù)Rsp1_Open描述接口函數(shù)Rsp1_Open原型聲明E_BoolRsp1_Open(constUShortinDstDevId_U16);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述E_BoolinDstDevId_U16：數(shù)據(jù)接收方設(shè)備識(shí)別號(hào)。返回值描述打開已關(guān)閉鏈路，返回r_TRUE；成功打開鏈路，返回r_FALSE。功能描述將輸入設(shè)備類型、設(shè)備識(shí)別號(hào)對(duì)應(yīng)的鏈路置為打開狀態(tài)，協(xié)議棧將允許對(duì)應(yīng)設(shè)備傳入數(shù)據(jù)。如果傳入設(shè)備無(wú)法找到時(shí)，將向上層匯報(bào)，并返回鏈路打開失敗。只有當(dāng)查找到傳入設(shè)備時(shí)，且鏈路處于關(guān)閉狀態(tài)，則打開鏈路并返回“真”。Rsp1_GetChanelStatus接口函數(shù)Rsp1_GetChanelStatus描述接口函數(shù)Rsp1_GetChanelStatus原型聲明E_BoolRsp1_GetChanelStatus(constUShortinDstDevId_U16,UShort*constoutCycDiff);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UShortinDstDevId_U16：設(shè)備識(shí)別號(hào)。UShort*outCycDiff：返回的當(dāng)前周期與上一次接收有效數(shù)據(jù)包的周期差值。返回值描述鏈路狀態(tài)故障，返回r_FALSE；鏈路狀態(tài)正常，返回r_TRUE。功能描述如果傳入設(shè)備無(wú)法找到時(shí)，將向上層匯報(bào)，并返回?cái)嚅_狀態(tài)及累計(jì)時(shí)鐘值。只有當(dāng)查找到傳入設(shè)備時(shí)，則鏈路連接狀態(tài)是否正常，并返回本周期協(xié)議棧時(shí)鐘與上一有效數(shù)據(jù)幀接收周期時(shí)鐘差值。Rsp1_GetSynData接口函數(shù)Rsp1_GetSynData描述接口函數(shù)Rsp1_GetSynData原型聲明UShortRsp1_GetSynData(UTiny*buf);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UTiny*buf：同步數(shù)據(jù)緩沖首地址。返回值描述返回同步數(shù)據(jù)字節(jié)數(shù)。功能描述協(xié)議棧同步數(shù)據(jù)獲取接口，獲取協(xié)議棧時(shí)鐘、所有鏈路序列號(hào)與時(shí)間戳。注：兩系運(yùn)行時(shí)，主系應(yīng)用應(yīng)每個(gè)系統(tǒng)周期結(jié)束時(shí)調(diào)用本函數(shù)，備系不能調(diào)用本函數(shù)。本函數(shù)可用中間數(shù)據(jù)的CRC校驗(yàn)，以避免硬件環(huán)境的干擾或失效導(dǎo)致內(nèi)存數(shù)據(jù)讀寫錯(cuò)誤對(duì)運(yùn)行數(shù)據(jù)造成的破壞。Rsp1_SetSynData接口函數(shù)Rsp1_SetSynData描述接口函數(shù)Rsp1_SetSynData原型聲明voidRsp1_SetSynData(constUTiny*inBuf,UShortinDataLength_U16);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UTiny*buf：同步數(shù)據(jù)緩沖；UShortinDataLength_U16：同步數(shù)據(jù)長(zhǎng)度。返回值描述無(wú)。功能描述接收同步數(shù)據(jù)時(shí)將檢查同步數(shù)據(jù)的CRC及可用鏈路數(shù)，如果校驗(yàn)失敗，則向上層匯報(bào)，并拒絕同步。如CRC及可用鏈路數(shù)校驗(yàn)通過(guò)，則同步數(shù)據(jù)設(shè)置接口，設(shè)置協(xié)議棧時(shí)鐘、所有鏈路序列號(hào)與時(shí)間戳。注：備系應(yīng)用應(yīng)每個(gè)系統(tǒng)周期開始時(shí)調(diào)用本函數(shù)，主系不能調(diào)用本函數(shù)。Rsp1_GetRunningCode接口函數(shù)Rsp1_GetRunningCode描述接口函數(shù)Rsp1_GetRunningCode原型聲明UShortRsp1_GetRunningCode(UTiny*outBuf);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述返回故障碼緩沖區(qū)。返回值描述本周期故障碼長(zhǎng)度。功能描述獲取本周期故障碼。LEU_Init接口函數(shù)LEU_Init描述接口函數(shù)LEU_Init原型聲明voidLEU_Init();包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述無(wú)。返回值描述無(wú)。功能描述初始化LEU接口所需要的內(nèi)部變量。LEU_BtmCycle接口函數(shù)LEU_BtmCycle描述接口函數(shù)LEU_BtmCycle原型聲明voidLEU_BtmCycle(constUTinyLEUIndex);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UTinyLEUIndex：LEU序號(hào)。返回值描述無(wú)。功能描述更新指定序號(hào)的LEU的時(shí)鐘。LEU_CheckBtmPackage接口函數(shù)LEU_CheckBtmPackage描述接口函數(shù)LEU_CheckBtmPackage原型聲明UTinyLEU_CheckBtmPackage(constUTinyLEUIndex,constUShortinLen_U16,UTiny*inBuf,UShort*outLen,UTiny*outBuf);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UTinyLEUIndex：LEU序號(hào)；constUShortinLen_U16：接收到的LEU數(shù)據(jù)長(zhǎng)度；UTiny*inBuf：接收到LEU數(shù)據(jù)緩沖；UShort*outLen：校驗(yàn)后的數(shù)據(jù)長(zhǎng)度；UTiny*outBuf：校驗(yàn)后的數(shù)據(jù)緩沖。返回值描述1：無(wú)效數(shù)據(jù)；2：數(shù)據(jù)幀；3：校時(shí)幀功能描述如填入數(shù)據(jù)長(zhǎng)度大于協(xié)議允許數(shù)據(jù)長(zhǎng)度，協(xié)議拒絕進(jìn)行解析。當(dāng)填入數(shù)據(jù)長(zhǎng)度小于等于協(xié)議允許數(shù)據(jù)長(zhǎng)度，協(xié)議棧檢查傳入的數(shù)據(jù)幀緩沖區(qū)，對(duì)不同的幀類型做判斷：如為SSE幀，則反饋SSR幀；如為SSR幀，則更新本地連接序列號(hào)及時(shí)間戳；如果是數(shù)據(jù)幀，則對(duì)時(shí)間戳、序列號(hào)等做檢查，如果在容忍范圍內(nèi)則認(rèn)為該數(shù)據(jù)幀有效，更新通信鏈路狀態(tài)，并將應(yīng)用數(shù)據(jù)緩沖返回給上層應(yīng)用。如時(shí)間戳、序列號(hào)超出允許范圍或CRC校驗(yàn)失敗，則需要丟棄該數(shù)據(jù)幀。建議安全設(shè)備中該函數(shù)輸出的校驗(yàn)后數(shù)據(jù)應(yīng)當(dāng)Rsp1_GetChanelStatus結(jié)果為鏈路狀態(tài)正常時(shí)才予以選用。LEU_PackageBtmData接口函數(shù)LEU_PackageBtmData描述接口函數(shù)LEU_PackageBtmData原型聲明UTinyLEU_PackageBtmData(constUShortLEUIndex,S_Msg*outMsg,S_SsMsg*outSseMsg,S_SsMsg*outSsrMsg);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述constUShortLEUIndex：LEU序號(hào)；S_Msg*outMsg：輸出的BTM幀；S_SsMsg*outSseMsg：輸出的BTM對(duì)時(shí)請(qǐng)求；S_SsMsg*outSsrMsg：輸出的BTM對(duì)時(shí)應(yīng)答。返回值描述錯(cuò)誤的數(shù)據(jù)接收方類型或識(shí)別號(hào)，返回0；打包數(shù)據(jù)長(zhǎng)度大于最大允許長(zhǎng)度，返回1；打包TSD和對(duì)時(shí)幀（SSR或SSE），返回2；已打包TSD，返回3。功能描述如發(fā)送對(duì)象的設(shè)備不在配置數(shù)據(jù)中，需要向上層應(yīng)用匯報(bào)，并拒絕組幀。如發(fā)送數(shù)據(jù)大于最大應(yīng)用數(shù)據(jù)允許長(zhǎng)度(1200字節(jié))，需要向上層應(yīng)用匯報(bào)，并拒絕組幀。當(dāng)查找到對(duì)應(yīng)設(shè)備且發(fā)送數(shù)據(jù)在允許應(yīng)用數(shù)據(jù)允許長(zhǎng)度內(nèi)時(shí)，則填入指定緩沖進(jìn)行組幀。數(shù)據(jù)幀與對(duì)時(shí)幀（SSE與SSR）緩沖需要分開。并分別告知上層應(yīng)用打包后的數(shù)據(jù)幀和對(duì)時(shí)幀數(shù)據(jù)包長(zhǎng)度。LEU_CheckRsdPackage接口函數(shù)LEU_CheckRsdPackage描述接口函數(shù)LEU_CheckRsdPackage原型聲明UTinyLEU_CheckRsdPackage(constUShortLEUIndex,constUShortinLen_U16,UTiny*inBuf,UShort*outLen,UTiny*outBuf);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述UTinyLEUIndex：LEU序號(hào)；constUShortinLen_U16：接收到的LEU數(shù)據(jù)長(zhǎng)度；UTiny*inBuf：接收到LEU數(shù)據(jù)緩沖；UShort*outLen：校驗(yàn)后的數(shù)據(jù)長(zhǎng)度；UTiny*outBuf：校驗(yàn)后的數(shù)據(jù)緩沖。返回值描述1：無(wú)效數(shù)據(jù)；2：數(shù)據(jù)幀；3：校時(shí)幀功能描述如填入數(shù)據(jù)長(zhǎng)度大于協(xié)議允許數(shù)據(jù)長(zhǎng)度，協(xié)議拒絕進(jìn)行解析。當(dāng)填入數(shù)據(jù)長(zhǎng)度小于等于協(xié)議允許數(shù)據(jù)長(zhǎng)度，協(xié)議棧檢查傳入的數(shù)據(jù)幀緩沖區(qū)，對(duì)不同的幀類型做判斷：如為SSE幀，則反饋SSR幀；如為SSR幀，則更新本地連接序列號(hào)及時(shí)間戳；如果是數(shù)據(jù)幀，則對(duì)時(shí)間戳、序列號(hào)等做檢查，如果在容忍范圍內(nèi)則認(rèn)為該數(shù)據(jù)幀有效，更新通信鏈路狀態(tài)，并將應(yīng)用數(shù)據(jù)緩沖返回給上層應(yīng)用。如時(shí)間戳、序列號(hào)超出允許范圍或CRC校驗(yàn)失敗，則需要丟棄該數(shù)據(jù)幀。建議安全設(shè)備中該函數(shù)輸出的校驗(yàn)后數(shù)據(jù)應(yīng)當(dāng)Rsp1_GetChanelStatus結(jié)果為鏈路狀態(tài)正常時(shí)才予以選用。LEU_PackageRsdData接口函數(shù)LEU_PackageRsdData描述接口函數(shù)LEU_PackageRsdData原型聲明UTinyLEU_PackageRsdData(constUShortLEUIndex,S_Msg*inMsg,S_Msg*outMsg,S_SsMsg*outSseMsg,S_SsMsg*outSsrMsg);包含文件<Rsp1.h>提供方Rsp1組件調(diào)用方上層應(yīng)用形參描述constUShortL