STYLEREF標(biāo)準(zhǔn)文件_文件編號(hào)DB11/T1164.7—XXXXSTYLEREF標(biāo)準(zhǔn)文件_文件編號(hào)錯(cuò)誤!文檔中沒(méi)有指定樣式的文字。

（規(guī)范性）

接口設(shè)計(jì)要求紙幣接收模塊接口結(jié)構(gòu)體說(shuō)明錯(cuò)誤與狀態(tài)描述結(jié)構(gòu)體typedefstruct{//基本信息UINTuiProviderId;//模塊廠家標(biāo)識(shí)intiType;//錯(cuò)誤類型：0-正常；1-警告；2-故障intiStdErrorCode;//統(tǒng)一維護(hù)的錯(cuò)誤代碼//2.模塊的原始信息，供上位程序顯示維護(hù)用intiErrorCode;//錯(cuò)誤代碼（由不同模塊廠家提供）characDevReturn[128];//硬件返回信息characReserve[128];//保留信息}tSTDDevReturn;鈔票系列禁用信息結(jié)構(gòu)體typedefstruct_SetInhibitItem{intiValue;//面額，單位為分boolbAccepted;//是否接收}tSetInhibitItem;typedefstruct_SetInhibitList{intiNumOfItems;//現(xiàn)金體個(gè)數(shù)tSetInhibitItem*psBnaCashInfo;//現(xiàn)金數(shù)組基址指針}tSetInhibitList;現(xiàn)金信息結(jié)構(gòu)體typedefstruct_BnaCashItem;{unsignedIntiValue;//接收鈔票面額，單位為分unsignedIntiCount;//鈔票張數(shù)}tBnaCashItem;typedefstruct_BnaCashInfo{intiNumOfItems;//現(xiàn)金體個(gè)數(shù)tBnaCashItem*psBnaCashInfo;}tBnaCashInfo;紙幣接收錢箱狀態(tài)結(jié)構(gòu)體typedefstruct{ intiModuleStatus;/*0正常，1需復(fù)位2異常*/intiBoxStatus;/*0安裝（正常），1將滿2滿3未安裝*/intiInStacker;/*0無(wú)，1有鈔票在暫存*/}tBnaStatus接口函數(shù)說(shuō)明：a) 所有函數(shù)返回值只判斷傳入?yún)?shù)是否為空；b) 邏輯或物理錯(cuò)誤還必須判斷tSTDDevReturn的iType和其他成員變量來(lái)確定；c) 每個(gè)函數(shù)內(nèi)部都有線程鎖，以保證標(biāo)準(zhǔn)接口函數(shù)都是串行運(yùn)行：d) (BNA_Start與BNA_Stop除外，這兩個(gè)標(biāo)準(zhǔn)接口，一個(gè)可以運(yùn)行在主線程中，一個(gè)運(yùn)行在新創(chuàng)建的子線程中，分別用以開(kāi)始紙幣接收與結(jié)束紙幣接收)。初始化IntBNA_Init(tSTDDevReturn*p_psStatus)功能說(shuō)明：初始化模塊，檢測(cè)模塊各硬件、將模塊恢復(fù)到初始狀態(tài)等。參數(shù)說(shuō)明見(jiàn)REF_Ref191896680\h表A.1。BNA_Init()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref191896687\h表A.2。BNA_Init()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空設(shè)置識(shí)別可用鈔票intBNA_SetPrevalue(tSetInhibitList*p_psBuyTicketSetInhibitList,tSetInhibitList*p_psRechargeSetInhibitList,tSTDDevReturn*p_psStatus)功能說(shuō)明：此命令用于設(shè)置可接收的鈔票，對(duì)于禁止接收的真鈔會(huì)退出。參數(shù)說(shuō)明見(jiàn)REF_Ref191896693\h表A.3。BNA_SetPrevalue()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tSetInhibitList*p_psBuyTicketSetInhibitListIn設(shè)置售票時(shí)鈔票可用信息結(jié)構(gòu)體數(shù)組2tSetInhibitList*p_psRechargeSetInhibitListIn設(shè)置充值時(shí)鈔票可用信息結(jié)構(gòu)體數(shù)組3tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref191896697\h表A.4。BNA_SetPrevalue()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空復(fù)位intBNA_Reset(intiMode,intiRetryTimes,BYTE*p_byNotesRefunded,BYTE*p_byNotesEncashed，tSTDDevReturn*p_psStatus）功能說(shuō)明：此命令用于清理通道中的鈔票，機(jī)芯恢復(fù)正常工作。+參數(shù)說(shuō)明見(jiàn)REF_Ref195016427\r\h表A.5。BNA_Reset()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1IntiModeIn如果通道中有鈔票，可以選擇的操作由p_iResetMode設(shè)定可以設(shè)置為：0：將傳輸系統(tǒng)和暫存區(qū)的鈔票壓入錢箱,如果失敗則報(bào)暫停服務(wù)錯(cuò)誤；1：將傳輸系統(tǒng)和暫存區(qū)的鈔票退出,如果失敗則報(bào)暫停服務(wù)錯(cuò)誤；默認(rèn)為0方式2IntiRetryTimesIn復(fù)位重試次數(shù)3BYTE*p_byNotesRefundedOut復(fù)位中紙幣退鈔張數(shù),默認(rèn)為NULL4BYTE*p_byNotesEncashedOut復(fù)位中紙幣壓鈔張數(shù),默認(rèn)為NULL5tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016436\r\h表A.6。BNA_Reset()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空開(kāi)始接收鈔票intBNA_Start(tSTDDevReturn*p_psStatus)功能說(shuō)明：機(jī)芯進(jìn)入預(yù)備存款狀態(tài)，指示燈開(kāi)始閃爍提示用戶投入紙幣。實(shí)現(xiàn)驗(yàn)鈔，退鈔，鈔票壓入暫存區(qū)等功能。參數(shù)說(shuō)明見(jiàn)REF_Ref195016442\r\h表A.7。BNA_Start()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016453\r\h表A.8。BNA_Start()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空可在子線程或主線程中啟動(dòng)，使紙幣模塊進(jìn)入等待接收紙幣的工作狀態(tài)，程序?qū)⑦M(jìn)入阻塞，除非成功接收紙幣或在另外線程中調(diào)用BNA_Stop可以使該函數(shù)退出運(yùn)行。停止接收鈔票intBNA_Stop(tSTDDevReturn*p_psStatus);功能說(shuō)明：機(jī)芯停止接收鈔票，指示燈熄滅。參數(shù)說(shuō)明見(jiàn)REF_Ref195016462\r\h表A.9。BNA_Stop()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016474\r\h表A.10。BNA_Stop()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空獲取識(shí)別鈔票信息intBNA_GetCashInfo(tBnaCashInfo*p_psCashInfo,BYTE&p_byOperation,tSTDDevReturn*p_psStatus)功能說(shuō)明：獲取機(jī)芯接收的鈔票信息。參數(shù)說(shuō)明見(jiàn)REF_Ref195016485\r\h表A.11。BNA_GetCashInfo()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBnaCashInfo*p_psCashInfoOut返回鈔票信息結(jié)構(gòu)體，臨時(shí)錢箱的信息2BYTE&p_byOperationOut最后一張?zhí)幚砑垘诺臓顟B(tài)0:沒(méi)有鈔票插入;1:無(wú)法識(shí)別的鈔票退出到退鈔口;2:用戶由退鈔口把鈔票（不能識(shí)別或者取消操作退出的）取走;3:鈔票放入又被強(qiáng)行拽出;4:鈔票被拉緊;5:真鈔處理完畢;6:鈔票拉緊并且超時(shí)被迫停止接收;7:退鈔口有鈔票未取走超時(shí);8:入鈔口至?xí)捍鎱^(qū)有鈔票正在處理;9:錢箱已經(jīng)取走;10:錢箱已滿;11:機(jī)芯進(jìn)出口長(zhǎng)時(shí)間阻塞(技術(shù)故障);12:未知錯(cuò)誤導(dǎo)致暫停服務(wù)。3tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016507\r\h表A.12。BNA_GetCashInfo()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空可在BNA_Start，執(zhí)行成功后，調(diào)用該函數(shù)，獲取臨時(shí)錢箱與最后一張紙幣的處理信息。對(duì)于G&D的紙幣模塊，p_byOperation可以獲取0，1，3，5；對(duì)于MEI的紙幣模塊，p_byOperation可以獲取0，1，3，5；對(duì)于G&D的紙幣模塊，p_byOperation可以獲取0，1，5，6，7，9，10；對(duì)于錢箱已滿，錢箱已取走，機(jī)芯故障，未知錯(cuò)誤等其他錯(cuò)誤，可以通過(guò)BNA_GetStatu的硬件返回信息來(lái)判斷獲取。壓箱IntBNA_Encash(tSTDDevReturn*p_psStatus);功能說(shuō)明：將暫存器的紙幣全部壓入錢箱。參數(shù)說(shuō)明見(jiàn)REF_Ref195016516\r\h表A.13。BNA_Encash()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016538\r\h表A.14。BNA_Encash()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空退鈔IntBNA_Refund(tSTDDevReturn*p_psStatus);功能說(shuō)明：將暫存器的紙幣全部退出。參數(shù)說(shuō)明見(jiàn)REF_Ref195016529\r\h表A.15。BNA_Refund()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016544\r\h表A.16。BNA_Refund()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空獲取模塊狀態(tài)IntBNA_GetStatus(tBnaStatus*p_psBnaStatus,tSTDDevReturn*p_psStatus)功能說(shuō)明：調(diào)用此接口可獲取模塊當(dāng)前狀態(tài)，詳細(xì)信息查看返回結(jié)構(gòu)體。參數(shù)說(shuō)明見(jiàn)REF_Ref195016550\r\h表A.17。BNA_GetStatus()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBnaStatus*p_psBnaStatusOut保存BNA模塊狀態(tài)2tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016556\r\h表A.18。BNA_GetStatus()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空typedefstruct_TAcceptorState{BYTECurrentOCCode;charCurrentCode[3];charSequenceNr;BYTENrOfDocumentInintermediateStorage;CharResolutionMode;BYTEValidationMode;BYTEWorkMode;}TAcceptorState;結(jié)構(gòu)體返回的狀態(tài)信息;因此在硬件返回信息字符串中內(nèi)容格式如下:[CurrentCode],[CurrentOCCode],[NrOfDocumentInintermediateStorage],[ResolutionMode],[SequenceNr],[ValidationMode],[WorkMode]。獲取錢箱IDIntBNA_GetBoxID(char*p_BoxID,tSTDDevReturn*p_psStatus)功能說(shuō)明：調(diào)用此接口可獲取錢箱ID，詳細(xì)信息查看返回結(jié)構(gòu)體。參數(shù)說(shuō)明見(jiàn)REF_Ref195016568\r\h表A.19。BNA_GetBoxID()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1char*p_BoxIDOut獲取錢箱ID2tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016575\r\h表A.20。BNA_GetBoxID()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空設(shè)置模塊充值或售票狀態(tài)enumBNA_BIZ_TYPE{BNA_RECHARGE=0,//充值BNA_SELL_TICKET=1//售票};IntBNA_SetModuleBizStatus(enumBNA_BIZ_TYPEiMode,tSTDDevReturn*p_psStatus)功能說(shuō)明：設(shè)置業(yè)務(wù)流程處于充值或售票狀態(tài)。參數(shù)說(shuō)明見(jiàn)REF_Ref195016590\r\h表A.21。BNA_BIZ_TYPE()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1iModeenumBNA_BIZ_TYPEIn0：充值；1：售票2tSTDDevReturn*p_psStatusOut保存BNA返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016597\r\h表A.22。BNA_BIZ_TYPE()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空通信串口打開(kāi)intBNA_open(unsignedintuiCommPort,unsignedintuiBaudRate)功能說(shuō)明：調(diào)用此接口可打開(kāi)低層串口通信。參數(shù)說(shuō)明見(jiàn)REF_Ref195016603\r\h表A.23。BNA_open()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1unsignedintuiCommPortIn串口通信號(hào)2unsignedintuiBaudRateIn波特率返回值說(shuō)明見(jiàn)REF_Ref195016725\r\h表A.24。BNA_open()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1串口打開(kāi)出錯(cuò)通信串口關(guān)閉intBNA_close() 功能說(shuō)明：調(diào)用此接口可關(guān)閉低層串口通信。返回值說(shuō)明見(jiàn)REF_Ref195016756\r\h表A.25。BNA_close()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1關(guān)閉錯(cuò)誤獲取模塊固件版本intBNA_GetVersion(char*pVersion,tSTDDevReturn*p_psStatus);功能說(shuō)明：用于獲取控制模塊內(nèi)的firmware版本號(hào)（如果模塊有），目前只針對(duì)GRG的紙幣模塊有效。參數(shù)說(shuō)明見(jiàn)REF_Ref195016767\r\h表A.26。BNA_GetVersion()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1char*pVersionOut固件版本（如果有）2tSTDDevReturn&p_psStatusOut返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195016784\r\h表A.27。BNA_GetVersion()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1關(guān)閉錯(cuò)誤設(shè)置模塊接口工作目錄函數(shù)名稱：voidBNA_SetWorkPath(char*pchWorkPath)功能說(shuō)明：用于設(shè)置模塊接口的工作目錄（模塊驅(qū)動(dòng)庫(kù)所在的絕對(duì)路徑）,調(diào)用方在使用接口庫(kù)其它接口之前設(shè)置。參數(shù)說(shuō)明見(jiàn)REF_Ref195016823\r\h表A.28。BNA_SetWorkPath()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1char*pchWorkPathin模塊驅(qū)動(dòng)庫(kù)所在的絕對(duì)路徑紙幣找零模塊接口結(jié)構(gòu)體說(shuō)明返回狀態(tài)結(jié)構(gòu)體typedefstruct{UINTuiType; /*錯(cuò)誤類型：0-正常；1-警告；2-故障*/ UINTuiErrorType;/*故障類型：0-正常；1-命令類錯(cuò)誤；2-硬件故障；3-通道異常；4-錢箱故障*/intiHandle; /*處理方法：0-不處理1-初始化2-重發(fā)命令3-停機(jī)休息4-軟件和硬件重新配置*/intiStdErrorCode;/*統(tǒng)一維護(hù)的錯(cuò)誤代碼*/ UINTuiErrorCode;/*錯(cuò)誤代碼（由不同模塊廠家提供）*/charcReverse[128];/*預(yù)留信息*/}tBNDDevReturn; 初始化張數(shù)信息typedefstruct{UINTuiOutNumber;UINTuiRetractNumber;}tBndInitNumInfo;錢箱狀態(tài)結(jié)構(gòu)體typedefstruct{unsignedcharuzBoxStatus[MAX_BOXNUM];unsignedcharucNgBoxStatus;}tBndBoxStatus;設(shè)置錢箱結(jié)構(gòu)體typedefstruct{UINTuiBoxType;//容器類型：0-廢幣箱1-1元紙幣箱,2-5元紙幣箱,3-10元紙幣箱,4-20元紙幣箱,5-50元紙幣箱,6-100元紙幣箱*UINTuiBoxNo;/**容器序號(hào)：0~6其中：0號(hào)廢幣箱1號(hào)為5元找零箱，2號(hào)為1元找零箱*/UINTuiBillValue;/**單位分：容器中所能存放紙幣的面額，期中0表示不能確定該容器的面額*/UINTuiBillNum;/**容器中紙幣的數(shù)量*/UINTuiBillMaxNum;/**容器中能存入紙幣最大的數(shù)量*/UINTuiBoxStatus;/**容器的狀態(tài)：0-正常；1-未安裝；2-已滿；3-將滿；4-以空；5-將空,該狀態(tài)為模塊硬件檢測(cè)的狀態(tài)，通過(guò)計(jì)數(shù)判斷的狀態(tài)由上位機(jī)進(jìn)行判斷 }tCashBoxValueInfo;模塊容器配置信息結(jié)構(gòu)體typedefstruct{tCashBoxValueInfopCashBoxValueInfo[MAX_BOXNUM];tCashBoxValueInfostCashNGBoxValueInfo;}tBNDBillBoxInfo;傳感器狀態(tài)結(jié)構(gòu)體typedefstruct{UINTuiSensorID;/**傳感器ID*/UINTuiStauts;/**傳感器狀態(tài)：0-未遮擋；1-遮擋*/}SensorStatus;typedefstruct{UINTuiSensorNum;/**傳感器數(shù)量*/SensorStatus*pSensorStatus;}tBNDSensorStatus;配鈔結(jié)構(gòu)體typedefstruct{ UINTuiAmount; //總數(shù) UINTuiDispenseNumber[MAX_BOXNUM];//每個(gè)錢箱需要出錢的張數(shù) UINTuiOutNumber[MAX_BOXNUM];//實(shí)際每個(gè)錢箱出錢的張數(shù)（返回） UINTuiRejectNumber[MAX_BOXNUM];//出鈔過(guò)程中每個(gè)錢箱廢鈔回收的張數(shù)（返回）}tBNDChangeNum;審計(jì)結(jié)構(gòu)體typedefstruct{ UINTuiNGBoxAccInNum;//累計(jì)進(jìn)入廢鈔箱張數(shù) UINTuiBoxAccOutNum;//累計(jì)出鈔張數(shù)}tBndAuditCashNum;Rfid信息結(jié)構(gòu)體typedefstruct{unsignedcharuzCashBoxID[4]//錢箱編號(hào)unsignedcharuzOperateID[3]//操作員IDunsignedcharuzDeviceID[4]//設(shè)備IDunsignedcharucCashBoxStatus//錢箱位置狀態(tài)unsignedcharucCashBoxOperateStatus//操作后錢箱狀態(tài)unsignedcharucBillType//幣種代碼unsignedcharusBillCnt//數(shù)量unsignedintuiBillAmount//紙幣總金額unsignedcharucStationCode[2]//車站編碼unsignedcharucInstallPosit;//安裝位置unsignedintuiBlockOperateTime;//塊操作時(shí)間unsignedcharucOperateTime[7];//最后操作時(shí)間unsignedshortusCheckField;//校驗(yàn)字段}tBndRfidInfo;接口函數(shù)說(shuō)明：所有函數(shù)返回值只判斷傳入?yún)?shù)是否為空；邏輯或物理錯(cuò)誤還必須判斷tBNDDevReturn的iType和其他成員變量來(lái)確定；每個(gè)函數(shù)內(nèi)部都有線程鎖，以保證標(biāo)準(zhǔn)接口函數(shù)都是串行運(yùn)行。通信串口打開(kāi)intBND_CommOpen(UINTuiCommPort,UINTuiBaudRate,tBNDDevReturn*pDevStatus)功能說(shuō)明：調(diào)用此接口可打開(kāi)低層串口通信。參數(shù)說(shuō)明見(jiàn)REF_Ref195016871\r\h表A.29。BND_CommOpen()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1unsignedintuiCommPortIn串口通信號(hào)2unsignedintuiBaudRateIn波特率3tBNDDevReturnpDevStatusOut設(shè)備返回狀態(tài)返回值說(shuō)明見(jiàn)REF_Ref195016880\r\h表A.30。BND_CommOpen()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1串口打開(kāi)出錯(cuò)通信串口關(guān)閉intBND_CloseComm(tBNDDevReturn*pDevStatus)功能說(shuō)明：調(diào)用此接口可關(guān)閉低層串口通信。參數(shù)說(shuō)明參見(jiàn)REF_Ref195016896\r\h表A.31。BND_CommOpen()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBNDDevReturnpDevStatusOut設(shè)備返回狀態(tài)返回值說(shuō)明見(jiàn)REF_Ref195016907\r\h表A.32。BND_close()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1關(guān)閉錯(cuò)誤初始化IntBND_Init(tBndInitNumInfo*pNumInfo,tBNDDevReturn*pDevStatus)功能說(shuō)明：初始化模塊，檢測(cè)模塊各硬件、將模塊恢復(fù)到初始狀態(tài)等。參數(shù)說(shuō)明見(jiàn)REF_Ref195016918\r\h表A.33。BND_Init()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBndInitNumInfo*pNumInfoOut退出和回收錢幣信息2tBNDDevReturnpDevStatusOut設(shè)備返回狀態(tài)返回值說(shuō)明見(jiàn)REF_Ref195016932\r\h表A.34。BND_Init()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空復(fù)位intBND_Reset(tBndInitNumInfo*pNumInfo,tBNDDevReturn*pDevStatus）功能說(shuō)明：復(fù)位。參數(shù)說(shuō)明見(jiàn)REF_Ref195016939\r\h表A.35。BND_Reset()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBndInitNumInfo*pNumInfoOut退出和回收錢幣張數(shù)2tBNDDevReturnpDevStatusOut設(shè)備返回狀態(tài)返回值說(shuō)明見(jiàn)REF_Ref195016952\r\h表A.36。BND_Reset()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空獲取模塊狀態(tài)函數(shù)名稱：IntBND_GetDevStatus(tBndBoxStatus*pBndBoxStatus,tBNDDevReturn*tBNDDevReturn)功能說(shuō)明：調(diào)用此接口可獲取模塊當(dāng)前狀態(tài)，詳細(xì)信息查看返回結(jié)構(gòu)體。參數(shù)說(shuō)明見(jiàn)REF_Ref195016965\r\h表A.37。BND_GetDevStatus()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBndBoxStatuspBndBoxStatusOut返回錢箱狀態(tài)2tBNDDevReturn*tBNDDevReturnOut保存BND返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195016988\r\h表A.38。BND_GetDevStatus()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空讀取審計(jì)信息函數(shù)定義：intBND_GetAuditData(tBndAuditCashNum*pBndAuditCashNum,tBNDDevReturn*pDevStatus)功能說(shuō)明：讀取設(shè)備的審計(jì)信息。參數(shù)說(shuō)明見(jiàn)REF_Ref195017002\r\h表A.39。BND_GetAuditData()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1tBndAuditCashNum*pBndAuditCashNumOut容器配置信息2tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017162\r\h表A.40。BND_GetAuditData()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。獲取傳感器狀態(tài)函數(shù)名稱：intBND_GetSensorStatus(tBNDSensorStatus*pSensorStatus,tBNDDevReturn*pDevStatus);功能說(shuō)明：獲取傳感器狀態(tài)。參數(shù)說(shuō)明見(jiàn)REF_Ref195017174\r\h表A.41。BND_GetSensorStatus()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBNDSensorStatus*pSensorStatusOut傳感器狀態(tài)2tBNDDevReturn&pDevStatusOut返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017182\r\h表A.42。BND_GetSensorStatus()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1關(guān)閉錯(cuò)誤讀取容器配置信息函數(shù)定義：intBND_GetBillBoxInfo(tBNDBillBoxInfo*pBillBoxInfo,tBNDDevReturn*pDevStatus);功能說(shuō)明：讀取錢箱結(jié)構(gòu)體信息。參數(shù)說(shuō)明見(jiàn)REF_Ref195017196\r\h表A.43。BND_GetBillBoxInfo()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1tBNDBillBoxInfo*pBillBoxInfoOut返回錢箱結(jié)構(gòu)體信息2tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值見(jiàn)REF_Ref195017213\r\h表A.44。BND_GetBillBoxInfo()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。設(shè)置容器配置信息函數(shù)定義：intBND_SetBillBoxInfo(UINTuiSlotID,tBNDBillBoxInfo*pBillBoxInfo,tBNDDevReturn*pDevStatus);功能說(shuō)明：設(shè)置容器配置信息（設(shè)置紙幣數(shù)量）參數(shù)說(shuō)明見(jiàn)REF_Ref195017228\r\h表A.45。BND_SetBillBoxInfo()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1UNITuiSlotIDIn槽位ID2tBNDBillBoxInfo*pBillBoxInfoIn容器配置信息3tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值見(jiàn)REF_Ref195017236\r\h表A.46。BND_SetBillBoxInfo()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。找零配鈔函數(shù)定義：intBND_ChangeBill(tBNDChangeNum*pChangeNum,tBNDDevReturn*pDevStatus)功能說(shuō)明：找零配鈔參數(shù)說(shuō)明見(jiàn)REF_Ref195017247\r\h表A.47。BND_ChangeBill()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1tBNDChangeNum*pChangeNumIn找零的紙幣面額及數(shù)量信息2tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017260\r\h表A.48。BND_ChangeBill()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。開(kāi)始更換紙幣找零箱函數(shù)定義：intBND_StartReplaceBox(UINTuiBoxType,UINTuiBoxNo,tBNDDevReturn*pDevStatus);功能說(shuō)明：此接口用于更換紙幣找零箱。參數(shù)說(shuō)明見(jiàn)REF_Ref195017268\r\h表A.49。BND_StartReplaceBox()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1UNITuiBoxTypeIn指定紙幣容器的類型2UINTuiBoxNoIn制定紙幣容器的序號(hào)3tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值見(jiàn)REF_Ref195017279\r\h表A.50。BND_StartReplaceBox()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1：執(zhí)行失敗。停止更換紙幣找零箱IntBND_StopReplaceBox(UINTuiBoxType,UINTuiBoxNo,tBNDDevReturn*pDevStatus)功能說(shuō)明：停止更換紙幣找零箱。參數(shù)說(shuō)明見(jiàn)REF_Ref195017307\r\h表A.51。BND_StopReplaceBox()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1UNITuiBoxTypeIn指定紙幣容器類型2UNITuiBoxNoIn指定紙幣容器序號(hào)2tBNDDevReturn*p_psStatusOut保存BND返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195017320\r\h表A.52。BND_StopReplaceBox()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空讀取序列號(hào)函數(shù)定義：intBND_GetSerialNumber(unsignedchar*pSn,tBNDDevReturn*pDevStatus);功能說(shuō)明：此命令用于模塊的序列號(hào)。參數(shù)說(shuō)明見(jiàn)REF_Ref195017327\r\h表A.53。BND_GetSerialNumber()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1Unsignedchar*pSnOut模塊的序列號(hào)，長(zhǎng)度322tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017341\r\h表A.54。BND_GetSerialNumber()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。讀取固件編號(hào)函數(shù)定義：intBND_GetFWVerdion(unsignedchar*pVersion,tBNDDevReturn*pDevStatus);功能說(shuō)明：此命令用于模塊的固件編號(hào)。參數(shù)說(shuō)明見(jiàn)REF_Ref195017349\r\h表A.55。BND_GetFWVerdion()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1Unsignedchar*pVersionOut模塊的固件編號(hào)2tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017361\r\h表A.56。BND_GetFWVerdion()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。設(shè)置模塊工作模式IntBND_SetWorkMode(charcMode,tBNDDevReturn*pDevStatus)功能說(shuō)明：設(shè)置模塊功能模式。參數(shù)說(shuō)明見(jiàn)REF_Ref195017373\r\h表A.57。BND_SetWorkMode()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1charcModeIn正常工作模式：0x00；維護(hù)模式：0x012tBNDDevReturn*pDevStatusOut設(shè)備返回狀態(tài)返回值說(shuō)明見(jiàn)REF_Ref195017386\r\h表A.58。BND_SetWorkMode()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空取消找零IntBND_Cancel(tBNDDevReturn*p_psStatus);功能說(shuō)明：取消找零操作。參數(shù)說(shuō)明見(jiàn)REF_Ref195017393\r\h表A.59。BND_Cancel()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tBNDDevReturn*p_psStatusOut保存BND返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195017405\r\h表A.60。BND_Cancel()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空設(shè)置模塊測(cè)試模式IntBND_TestSetting(charcTestType,tBNDBillBoxInfo*pBillBoxInfo,tBNDSensorStatus*pSensorStatus,tBNDDevReturn*pDevStatus);功能說(shuō)明：設(shè)置模塊測(cè)試模式。參數(shù)說(shuō)明見(jiàn)REF_Ref195017413\r\h表A.61。BND_TestSetting()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1CharcTestTypeIn測(cè)試類型2tBNDBillBoxInfopBillBoxInfoOut返回容器配置信息3tBNDSensorStatuspSensorStatusOut返回傳感器狀態(tài)4tBNDDevReturn*pDevStatusOut保存BND返回的邏輯錯(cuò)誤碼返回值說(shuō)明見(jiàn)REF_Ref195017424\r\h表A.62。BND_TestSetting()返回值說(shuō)明序號(hào)返回值類型返回值說(shuō)明1Int0成功2Int1傳入?yún)?shù)為空設(shè)置錢箱RFID信息函數(shù)定義：intBND_WriteRFIDInfo(UINTuiSLotID,tBndRfidInfo*pRFIDInfo,tBNDDevReturn*pDevStatus);功能說(shuō)明：寫入錢箱RFID信息。參數(shù)說(shuō)明見(jiàn)REF_Ref195017432\r\h表A.63。BND_WriteRFIDInfo()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1UNITuiSLotIDIn槽位ID2tBndRfidInfo*pRFIDInfoIn設(shè)置RFID信息3tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值見(jiàn)REF_Ref195017469\r\h表A.64。BND_WriteRFIDInfo()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。讀取錢箱RFID信息函數(shù)定義：intBND_ReadRFIDInfo(UINTuiSLotID,tBndRfidInfo*pRFIDInfo,tBNDDevReturn*pDevStatus);功能說(shuō)明：讀取錢箱RFID信息。參數(shù)說(shuō)明見(jiàn)REF_Ref195017487\r\h表A.65。BND_ReadRFIDInfo()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱輸入/輸出說(shuō)明1UNITuiSLotIDIn槽位ID2tBndRfidInfo*pRFIDInfoOut設(shè)置RFID信息3tBNDDevReturn*pDevStatusOut返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017494\r\h表A.66。BND_ReadRFIDInfo()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。設(shè)置模塊接口工作目錄函數(shù)名稱：voidBND_SetWorkPath(char*pchWorkPath)功能說(shuō)明：用于設(shè)置模塊接口的工作目錄（模塊驅(qū)動(dòng)庫(kù)所在的絕對(duì)路徑）,調(diào)用方在使用接口庫(kù)其它接口之前設(shè)置。參數(shù)說(shuō)明見(jiàn)REF_Ref195017509\r\h表A.67。BND_SetWorkPath()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1char*pchWorkPathin模塊驅(qū)動(dòng)庫(kù)所在的絕對(duì)路徑閘門及通行控制裝置模塊接口接口匯總表接口匯總表見(jiàn)REF_Ref195017520\r\h表A.68。閘門及通行控制裝置模塊接口匯總接口名稱接口說(shuō)明PCM_CommOpen通訊建立PCM_CommClose通訊關(guān)閉PCM_Init初始化模塊PCM_Reset模塊復(fù)位PCM_SetWorkMode設(shè)置閘機(jī)工作模式PCM_SetCtrlParam設(shè)置參數(shù)PCM_TicketValid有效車票信號(hào)PCM_GetDevStatus讀取模塊狀態(tài)PCM_GetSensorState讀取傳感器狀態(tài)PCM_ControlDoor控制扇門PCM_TestSetting模塊測(cè)試設(shè)置PCM_GetVersion獲取模塊固件版本錯(cuò)誤碼匯總表錯(cuò)誤碼匯總見(jiàn)REF_Ref195017535\r\h表A.69。閘門及控制裝置模塊錯(cuò)誤碼匯總錯(cuò)誤類型（iType）錯(cuò)誤代碼（iErrorCode）說(shuō)明210000發(fā)送串口命令失敗210001扇門模式：【緊急模式】輸入錯(cuò)誤[輸入值]！210002扇門模式：【維修模式】輸入錯(cuò)誤[輸入值]！210003扇門模式：【狀態(tài)模式】輸入錯(cuò)誤[輸入值]！210004扇門模式：【工作模式】輸入錯(cuò)誤[輸入值]！210005控制扇門輸入錯(cuò)誤[輸入值]！210006測(cè)試類型輸入錯(cuò)誤[輸入值]！211000串口不能使用！211001自動(dòng)輪詢失?。?11002發(fā)送輪詢命令失?。?20001探知到機(jī)械故障220002探知到傳感器故障結(jié)構(gòu)體說(shuō)明返回狀態(tài)結(jié)構(gòu)體typedefstruct{UINTuiProviderId;//模塊廠家標(biāo)識(shí)intiType;//錯(cuò)誤類型：0-正常；1-警告；2-故障intiErrorCode;//錯(cuò)誤代碼characReverse[4];//預(yù)留信息}tPcmDevReturn;扇門模式結(jié)構(gòu)體typedefstruct{UCHARucRunMode;//工作模式：//0，關(guān)閉模式；//1，雙向模式；//2，單進(jìn)模式；//3，單出模式；//4，進(jìn)閘免檢模式；//5，出閘免檢模式；//6，進(jìn)閘檢票、出閘免檢模式；//7，出閘檢票、進(jìn)閘免檢模式；//8，進(jìn)出閘都免檢（自由通行）；UCHARucStandByMode;//閘門狀態(tài)模式（低4位）：0x00，常閉模式；0x01，常開(kāi)模式//兒童檢測(cè)開(kāi)關(guān)（高4位）：0x10，兒童檢測(cè)開(kāi);0x00，兒童檢測(cè)關(guān)UCHARucEmergency;//緊急模式：0x00，正常；0x01，緊急UCHARucMaintenance;//維修模式：0x00，正常；0x01，維修}tPcmOperationMode;通行邏輯狀態(tài)結(jié)構(gòu)體typedefstruct{UINTuiSide;//觸發(fā)端：0，與方向無(wú)關(guān)；1，進(jìn)閘端；2，出閘端；UINTuiPassLogicStatus;//通行邏輯狀態(tài)：//0x0000，正常通行邏輯//0x0001，乘客進(jìn)來(lái)；0x0002，乘客離開(kāi)//0x0004，乘客滯留；0x0008，乘客丟失//0x0010，乘客尾隨；0x0020，無(wú)票進(jìn)入//0x0040，反向進(jìn)閘；0x0080，正常過(guò)閘//0x0100，無(wú)乘客通過(guò)超時(shí)；0x0200，開(kāi)門受阻//0x0400，強(qiáng)行打開(kāi)扇門；0x0800，沖撞扇門}tPcmPassLogicStatus;部件狀態(tài)結(jié)構(gòu)體typedefstruct{UCHARucSensorStatus;//傳感器狀態(tài)：0，正常；1，故障；UCHARucFlapDoorStatus;//閘門狀態(tài)：0，正常；1，左閘門故障；2，右閘門故障；4，兩個(gè)閘門都故障；UCHARucMotorStatus;//馬達(dá)狀態(tài)：0，正常；1，故障；UCHARucMainStatus;//維修門開(kāi)關(guān)狀態(tài)：00維修門關(guān)閉;01:維修門開(kāi)（適用于維修門開(kāi)關(guān)信號(hào)接入門機(jī)構(gòu)的模塊）UCHARucChildStatus;//兒童檢測(cè)開(kāi)關(guān)狀態(tài)：00兒童檢測(cè)關(guān)閉;01:兒童檢測(cè)打開(kāi)UCHARucReverseStatus[7];//預(yù)留狀態(tài)}tPcmComponentStatus;模塊狀態(tài)結(jié)構(gòu)體typedefstruct{UCHARucOpModeState;//當(dāng)前扇門模式UINTunTotalEnNum; //進(jìn)站端已授權(quán)總數(shù)量（斷電清零）UINTunTotalExNum; //出站端已授權(quán)總數(shù)量（斷電清零）UCHARucStoredEnNum;//剩余未進(jìn)閘有效乘客數(shù)量UCHARucStoredExNum;//剩余未出閘有效乘客數(shù)量tPcmPassLogicStatustPassLogicState;//通行狀態(tài)tPcmComponentStatustComponentState;//組成部件狀態(tài)}tPcmModuStatus;其中“ucOpModeState”（當(dāng)前扇門模式）定義見(jiàn)REF_Ref195017549\r\h表A.70。ucOpModeState定義bit76543210定義閘門模式維修模式緊急模式工作模式工作模式：定義參見(jiàn)“tOperationMode”。緊急模式：0，無(wú)；1，通過(guò)命令進(jìn)入；2，通過(guò)信號(hào)進(jìn)入；3，通過(guò)命令和信號(hào)進(jìn)入。維修模式：0，無(wú)；1，進(jìn)入。閘門模式（Stand-byMode）：0，常關(guān)模式；1，常開(kāi)模式。有效車票結(jié)構(gòu)體typedefstruct{UCHARucSide;//刷卡端：1，進(jìn)閘端；2，出閘端UCHARucQuatity;//票數(shù)（大于0時(shí)，表示有效授權(quán)，扇門開(kāi)門放行；等于0時(shí)表示無(wú)效授權(quán)，扇門阻擋乘客，提示非法票卡，還需點(diǎn)亮故障燈；當(dāng)大于0時(shí)，ucLampBar1/ucLampBar2記錄優(yōu)惠燈的顏色）UCHARucLampBar1;//優(yōu)惠指示條1：0，不顯示；1，顯示（當(dāng)ucQuatity>0時(shí)，記錄票種燈的顏色，顏色定義參見(jiàn)“8.3.2提示燈信號(hào)設(shè)置結(jié)構(gòu)體”字段ucLampColor的定義）UCHARucLampBar2;//優(yōu)惠指示條2：0，不顯示；1，顯示}tPcmValidTk;控制參數(shù)結(jié)構(gòu)體typedefstruct{USHORTusHoldTimeout;//單位：秒；授權(quán)超時(shí)時(shí)間，發(fā)出開(kāi)門信號(hào)后無(wú)乘客進(jìn)入，扇門保持開(kāi)啟的時(shí)間(為0時(shí)不變)USHORTusLeaveTimeout;//單位：毫秒；發(fā)出開(kāi)門信號(hào)后，允許乘客在通道內(nèi)滯留時(shí)間(為0時(shí)不變)USHORTusClosingTimeout;//單位：毫秒；旅客通過(guò)后門扇保持開(kāi)啟時(shí)段，即“兩次連續(xù)進(jìn)入閘機(jī)保持門開(kāi)的延遲時(shí)間”(為0時(shí)不變)}tPcmCtrlParam;版本信息結(jié)構(gòu)體typedefstruct{UCHARpFirmwareVerInfo[32];//固件版本信息,32字節(jié)，不夠后補(bǔ)0x00UCHARpDriverVerInfo[32];//驅(qū)動(dòng)版本信息,32字節(jié)，不夠后補(bǔ)0x00UCHARpHardwareVerInfo[32];//硬件版本信息,32字節(jié)，不夠后補(bǔ)0x00}tPcmVerInfo;通訊建立函數(shù)名稱：intPCM_CommOpen(UINTuiCommPort,UINTuiBaudRate)功能說(shuō)明：建立串口通訊并進(jìn)行設(shè)備的輪詢以保證串口通訊的正常。參數(shù)說(shuō)明見(jiàn)REF_Ref195017583\r\h表A.71。PCM_CommOpen()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1UINTuiCommPortIn串口號(hào)2UINTuiCommPortIn波特率返回值說(shuō)明見(jiàn)REF_Ref195017591\r\h表A.72。PCM_CommOpen()返回值說(shuō)明序號(hào)類型說(shuō)明1Int0：執(zhí)行成功；1，執(zhí)行失敗。通訊關(guān)閉函數(shù)名稱：intPCM_CommClose()功能說(shuō)明：關(guān)閉串口通訊。參數(shù)說(shuō)明：無(wú)。返回值說(shuō)明見(jiàn)REF_Ref195017607\r\h表A.73。PCM_CommClose()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。模塊復(fù)位函數(shù)名稱：intPCM_Reset(tPcmDevReturn&tReturn)功能說(shuō)明：重新啟動(dòng)扇門模塊的控制程序。參數(shù)說(shuō)明見(jiàn)REF_Ref195017616\r\h表A.74。PCM_Reset()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tPcmDevReturn&tReturnin返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017629\r\h表A.75。PCM_Reset()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。初始化函數(shù)名稱：intPCM_Init(tPcmDevReturn&tReturn)功能說(shuō)明：初始化模塊，檢查模塊是否可用，包括對(duì)扇門狀態(tài)檢測(cè)、傳感器狀態(tài)檢測(cè)等。參數(shù)說(shuō)明見(jiàn)REF_Ref195017635\r\h表A.76。PCM_Init()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tPcmDevReturn&tReturnin返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017652\r\h表A.77。PCM_init()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。設(shè)置閘機(jī)工作模式函數(shù)名稱：intPCM_SetWorkMode(tPcmOperationMode*pMode,tPcmDevReturn&tReturn)功能說(shuō)明：設(shè)置閘機(jī)的各種工作模式。參數(shù)說(shuō)明見(jiàn)REF_Ref195017663\r\h表A.78。PCM_SetWorkMode()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tPcmOperationMode*pModein工作模式2tPcmDevReturn&tReturnout返回狀態(tài)信息對(duì)于方向指示器、頂棚向?qū)?biāo)識(shí)控制的約定：如果硬件中DIO模塊不包含方向指示器和頂棚向?qū)У目刂平涌?，則應(yīng)根據(jù)本接口設(shè)置的工作模式，自行控制方向指示器和頂棚向?qū)Вɡ纾簡(jiǎn)芜M(jìn)模式時(shí)，進(jìn)站方向通行指示器和頂棚顯示綠色箭頭，出站方向顯示紅色叉）。設(shè)置控制參數(shù)函數(shù)名稱：intPCM_SetCtrlParam(tPcmCtrlParam*pParam,tPcmDevReturn&tReturn)功能說(shuō)明：設(shè)置閘機(jī)的各種工作參數(shù)。參數(shù)說(shuō)明見(jiàn)REF_Ref195017678\r\h表A.79。PCM_SetCtrlParam()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tPcmCtrlParam*pParamin控制參數(shù)2tPcmDevReturn&tReturnout返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017685\r\h表A.80。PCM_SetCtrlParam()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。有效車票投入信號(hào)函數(shù)名稱：intPCM_TicketValid(tPcmValidTk*pValidTk,tPcmDevReturn&tReturn)功能說(shuō)明：設(shè)置閘機(jī)的有效車票信息。參數(shù)說(shuō)明見(jiàn)REF_Ref195017699\r\h表A.81。PCM_TicketValid()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tPcmValidTk*pValidTkin有效車票信息2tPcmDevReturn&tReturnout返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017708\r\h表A.82。PCM_TicketValid()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。取模塊狀態(tài)函數(shù)名稱：intPCM_GetDevStatus(tPcmModuStatus&tModuStatus,tPcmDevReturn&tReturn)功能說(shuō)明：獲取通行邏輯控制模塊的實(shí)時(shí)狀態(tài)。參數(shù)說(shuō)明見(jiàn)REF_Ref195017726\r\h表A.83。PCM_GetDevStatus()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tPcmModuStatus&tModuStatusin模塊狀態(tài)2tPcmModuStatus&tReturnout返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017732\r\h表A.84。PCM_GetDevStatus()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。取傳感器狀態(tài)函數(shù)名稱：intPCM_GetSensorStatus(UINT*pSensorNum,BYTE*pSensorStatus,UINT*pHeightSensorNum,BYTE*pHeightSensorStatus,BYTE*pSensorFaultState,BYTE*pHeightSensorFaultState,tPcmDevReturn&tReturn)功能說(shuō)明：獲取所有通行傳感器(通行傳感器和身高傳感器)的遮擋狀態(tài)狀態(tài)、故障狀態(tài)。參數(shù)說(shuō)明見(jiàn)REF_Ref195017752\r\h表A.85。PCM_GetSensorStatus()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1UINT*pSensorNumout通行傳感器數(shù)量2BYTE*pSensorStatusout通行傳感器遮擋狀態(tài)，長(zhǎng)度為pSensorNum個(gè)字節(jié)，每一個(gè)傳感器狀態(tài)占用1字節(jié)（0：未遮檔；1：遮擋）3UINT*pHeightSensorNumout身高傳感器數(shù)量4BYTE*pHeightSensorStatusout身高傳感器遮擋狀態(tài)，長(zhǎng)度為pSensorNum個(gè)字節(jié)，每一個(gè)傳感器狀態(tài)占用1字節(jié)（0：未遮檔；1：遮擋）5BYTE*pSensorFaultStateout通行傳感器故障狀態(tài)，長(zhǎng)度為pSensorNum個(gè)字節(jié)，每一個(gè)傳感器狀態(tài)占用1字節(jié)（0：正常；1：故障）6BYTE*pHeightSensorFaultStateout身高傳感器故障狀態(tài)，長(zhǎng)度為pHeightSensorNum個(gè)字節(jié)，每一個(gè)傳感器狀態(tài)占用1字節(jié)（0：正常；1：故障）7tPcmDevReturn&tReturnout返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017763\r\h表A.86。PCM_GetSensorStatus()返回值說(shuō)明序號(hào)參數(shù)名稱類型說(shuō)明1tReturnint0：執(zhí)行成功；1，執(zhí)行失敗。控制扇門函數(shù)名稱：intPCM_ControlDoor(BYTEucCtrlType,tPcmDevReturn&tReturn)功能說(shuō)明：用于強(qiáng)制控制閘門的打開(kāi)與關(guān)閉，而不考慮當(dāng)前的運(yùn)行模式的邏輯控制。參數(shù)說(shuō)明見(jiàn)REF_Ref195017770\r\h表A.87。PCM_ControlDoor()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1BYTEucCtrlTypein控制類型：0，恢復(fù)到按工作模式的邏輯控制1，開(kāi)扇門2，關(guān)扇門2tPcmDevReturn&tReturnout返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017783\r\h表A.88。PCM_ControlDoor()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。說(shuō)明：MCU設(shè)置了強(qiáng)制打開(kāi)、強(qiáng)制關(guān)閉后，須發(fā)送恢復(fù)命令。模塊測(cè)試設(shè)置函數(shù)名稱：intPCM_TestSetting(BYTEucTestType,tPcmDevReturn&tReturn)功能說(shuō)明：用于測(cè)試扇門模塊的部件，包括傳感器測(cè)試、閘門測(cè)試、方向指示器測(cè)試。參數(shù)說(shuō)明見(jiàn)REF_Ref195017790\r\h表A.89。PCM_TestSetting()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1BYTEucTestTypein測(cè)試類型：0，停止當(dāng)前測(cè)試；1，閘門動(dòng)作測(cè)試；2，方向指示器測(cè)試；3，傳感器測(cè)試；4，蜂鳴器測(cè)試2tPcmDevReturn&tReturnout返回狀態(tài)信息返回值說(shuō)明見(jiàn)REF_Ref195017805\r\h表A.90。PCM_TestSetting()返回值說(shuō)明序號(hào)類型說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。說(shuō)明：此命令只能在“維修模式下”使用，否則“無(wú)效命令”；部件測(cè)試之間可以不發(fā)送“停止當(dāng)前測(cè)試”而直接切換；退出“維修模式”，自動(dòng)停止測(cè)試。獲取模塊固件版本函數(shù)名稱：intPCM_GetVersion(tPcmVerInfo&tVersion,tPcmDevReturn&tReturn)功能說(shuō)明：用于獲取控制模塊內(nèi)的firmware版本號(hào)。參數(shù)說(shuō)明見(jiàn)REF_Ref195017822\r\h表A.91。PCM_GetVersion()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1tPcmVerInfo&tVersionout模塊固件版本信息返回值說(shuō)明見(jiàn)REF_Ref195017835\r\h表A.92。PCM_GetVersion()返回值說(shuō)明序號(hào)參數(shù)名稱類型說(shuō)明1tReturnint0：執(zhí)行成功；1，執(zhí)行失敗。設(shè)置模塊接口工作目錄函數(shù)名稱：voidPCM_SetWorkPath(char*pchWorkPath)功能說(shuō)明：用于設(shè)置模塊接口的工作目錄（模塊驅(qū)動(dòng)庫(kù)所在的絕對(duì)路徑）,調(diào)用方在使用接口庫(kù)其它接口之前設(shè)置。參數(shù)說(shuō)明見(jiàn)REF_Ref195017848\r\h表A.93。PCM_SetWorkPath()參數(shù)說(shuō)明序號(hào)參數(shù)類型參數(shù)名稱屬性說(shuō)明1char*pchWorkPathin模塊驅(qū)動(dòng)庫(kù)所在的絕對(duì)路徑操作流程圖見(jiàn)REF_Ref195017858\r\h圖A.1。操作流程車票發(fā)售硬件驅(qū)動(dòng)接口車票發(fā)售控制模塊接口接口匯總表接口匯總表見(jiàn)REF_Ref195017875\r\h表A.94。接口匯總表接口名稱接口說(shuō)明TIM_CommOpen()通訊建立TIM_Init()模塊初始化TIM_Reset()模塊復(fù)位TIM_GetVersion()讀取設(shè)備驅(qū)動(dòng)版本信息TIM_GetDevStatus()讀取設(shè)備狀態(tài)TIM_CardOut()獲取票卡TIM_SendCard()送出票卡TIM_RetractCard()回收票卡TIM_GetAuditData()讀取審計(jì)累計(jì)值TIM_GetTicketBoxRFIDInfo讀取票箱RFID信息TIM_GetTicketBoxCountInfo讀取票箱數(shù)量信息TIM_SetTicketBoxRFIDInfo設(shè)置票箱RFID信息TIM_SetTicketBoxCountInfo設(shè)置票箱數(shù)量信息TIM_ReplaceTBox()更換票箱TIM_GetSN()讀取序列號(hào)TIM_CommClose()關(guān)閉通訊TIM_SetWorkMode()設(shè)置模塊工作模式TIM_TestSetting()模塊測(cè)試設(shè)置設(shè)備返回碼的定義及其說(shuō)明設(shè)備返回碼的定義及說(shuō)明見(jiàn)REF_Ref195017900\r\h表A.95。設(shè)備返回碼定義及說(shuō)明故障類型錯(cuò)誤類型錯(cuò)誤代碼說(shuō)明命令類錯(cuò)誤1241441無(wú)效命令(沒(méi)有調(diào)用串口打開(kāi)時(shí)也返回該錯(cuò)誤代碼)241442無(wú)效參數(shù)241484設(shè)備忙241490未知錯(cuò)241493串口配置錯(cuò)241494收到NAK,發(fā)送數(shù)據(jù)有錯(cuò)241495接收到的數(shù)據(jù)有誤241496發(fā)送ENQ出錯(cuò)241497發(fā)送命令錯(cuò)241498等待ACK超時(shí)241499等待響應(yīng)超時(shí)241420警告碼基址241440錯(cuò)誤碼基址131000命令錯(cuò)誤231001系統(tǒng)忙231002繼續(xù)處理可能異常231003參數(shù)錯(cuò)誤硬件故障2

241443電子ID1故障241444電子ID2故障241445電子ID3故障241446讀卡箱ID失敗241447寫卡箱ID失敗241448讀設(shè)備型號(hào)失敗241449寫設(shè)備型號(hào)失敗241450讀Log失敗241451寫Log失敗241452EEPROM故障241474讀flash241475擦除flash芯片錯(cuò)241476無(wú)該日期Log241478通道傳感器故障241479主馬達(dá)堵轉(zhuǎn)241480換向器故障241485無(wú)法檢測(cè)到票箱的RFID卡241486票箱RFID卡認(rèn)證失敗241487讀寫票箱RFID卡參數(shù)錯(cuò)241488讀寫票箱SN號(hào)錯(cuò)231004硬件故障231006RFID故障231007刮票器1沒(méi)有壓下231008刮票器2沒(méi)有壓下231009刮票1失敗231010刮票2失敗231011票箱1傳輸失敗231012票箱2傳輸失敗231015廢票箱舌檔未打開(kāi)231016出票電機(jī)卡票231017回收電機(jī)故障通道異常故障3241453有卡在出口位置堵塞錯(cuò)241454有卡在讀卡位置堵塞錯(cuò)241457卡堵在通道中241458摩卡A入口通道堵塞241459摩卡B入口通道堵塞241472回收箱滿/有卡在回收位置堵塞錯(cuò)241477感應(yīng)區(qū)無(wú)卡241421讀卡位置無(wú)卡存在231034通道上有殘留車票票箱故障4241455A卡箱摩卡失敗241460A卡箱把手未升起241456B卡箱摩卡失敗241461B卡箱把手未升起241462兩卡箱把手均未打開(kāi)241463發(fā)卡箱A蓋未打開(kāi)241464發(fā)卡箱B蓋未打開(kāi)241465兩卡箱蓋均未打開(kāi)141466A卡箱空141467B卡箱空141468兩卡箱均空241469A卡箱不存在241470B卡箱不存在241471兩卡箱均不存在241473回收箱不存在141481A卡箱將空141482B卡箱將空141483兩卡箱都將空231013票箱1舌檔未打開(kāi)231014票箱2舌檔未打開(kāi)131022票箱均未安裝131023廢票箱安裝檢測(cè)131024票箱均空131025廢票箱滿檢測(cè)-131026票箱1安裝檢測(cè)131027票箱2安裝檢測(cè)131028票箱1車票有無(wú)檢測(cè)131029票箱2車票有無(wú)檢測(cè)131030票箱均將空131031票箱一將空131032票箱二將空131033廢票箱將滿檢測(cè)傳感器定義傳感器的定義及說(shuō)明見(jiàn)REF_Ref195017916\r\h表A.96。傳感器定義ID傳感器說(shuō)明1int0：執(zhí)行成功；1，執(zhí)行失敗。41001電子ID20:檢測(cè)不到電子ID21:檢測(cè)到電子ID2在對(duì)電子ID2操作后此狀態(tài)才更新。41002電子ID30:檢測(cè)不到電子ID31:檢測(cè)到電子ID3在對(duì)電子ID3操作后此狀態(tài)才更新。41003EEPROM狀態(tài)傳感器0:EEPROM正常1:EEPROM故障在對(duì)EEPROM操作后此狀態(tài)才更新41004BCSA卡箱A進(jìn)入通道傳感器0:正常1:故障41005BCSB卡箱B進(jìn)入通道傳感器0:正常1:故障41006RWPS卡讀寫位置傳感器0:正常1:故障41007ECS出口計(jì)數(shù)傳感器0:正常1:故障41008BAAES票箱A將空檢測(cè)傳感器0：正常1：將空41009BAPS票箱A存在傳感器0：正常1：不存在41010BAES票箱A空檢測(cè)傳感器0：正常1：票箱空41011票箱A編碼器傳感器0：正常1：故障41012票箱A進(jìn)入通道傳感器0：正常1：故障41013票箱A黑塊傳感器0：正常1：故障41014BBAES票箱B將空檢測(cè)傳感器0：正常1：將空41015BBPS票箱B存在傳感器0：正常1：不存在41016BBES票箱B空檢測(cè)傳感器0：正常1：票箱空41017票箱B編碼器傳感器0：正常1：故障41018票箱B進(jìn)入通道傳感器0：正常1：故障41019票箱B黑塊傳感器0：正常1：故障41020TRPS票卡在讀寫區(qū)定位傳感器0：正常1：故障41021出口計(jì)數(shù)傳感器0：正常1：故障41022TSCS檢測(cè)票箱C換向器動(dòng)作傳感器0：正常1：故障41023通道編碼器傳感器0：正常1：故障41024BCPS回收箱箱存在傳感器0：正常1：不存在41025BCTPS回收箱C內(nèi)票卡滿傳感器0：正常1：票箱滿41026對(duì)進(jìn)入回收箱C的票卡進(jìn)行計(jì)數(shù)傳感器0：正常1：故障41027BACPS檢測(cè)票箱A上蓋開(kāi)閉狀態(tài)0：正常1：未上蓋41028BBCPS檢測(cè)票箱B上蓋開(kāi)閉狀態(tài)0：正常1：未上蓋41029BCCPS檢測(cè)票箱C上蓋開(kāi)閉狀態(tài)0：正常1：未上蓋41030TIS檢測(cè)票卡是否成功發(fā)售41031TAPS檢測(cè)票卡從票箱A挖出位置0：正常1：故障41032TABPS檢測(cè)票卡在票箱A、B之間的位置0：正常1：故障41033TBPS檢測(cè)票卡從票箱B挖出位置0：正常1：故障41034BAHPS檢測(cè)票箱A手柄位置0：正常1：故障41035BBHPS檢測(cè)票箱B手柄位置0：正常1：故障41036WAP1S檢測(cè)挖卡輪A位置狀態(tài)0：正常1：故障41037WAP2S檢測(cè)挖卡輪A位置狀態(tài)0：正常1：故障41038WBP1S檢測(cè)挖卡輪B位置狀態(tài)0：正常1：故障41039WBP2S檢測(cè)挖卡輪B位置狀態(tài)0：正常1：故障備用1傳感器0：正常1：故障備用2傳感器0：正常1：故障傳感器ID定義見(jiàn)REF_Ref195017925\r\h表A.97。傳感器ID定義傳感器ID說(shuō)明31000票箱2舌檔關(guān)閉檢測(cè)31001廢票箱將滿檢測(cè)-31002廢票箱舌檔關(guān)閉31003票箱一將空31004票箱二將空31005票箱1車票排出定位31006票箱1安裝檢測(cè)31007票箱2安裝檢測(cè)31008票箱2車票排出定位31009廢票箱安裝檢測(cè)31010票箱1提供位置檢測(cè)31011票箱1下限傳感器31012票箱2下限傳感器31013票箱2提供位置檢測(cè)31014票箱1鎖定爪傳感器31015票箱2鎖定爪傳感器31016票箱2接近下限31017廢票箱鎖定爪傳感器31018取出口抽取檢測(cè)傳感31019排出結(jié)束檢測(cè)傳感器31020廢票回收結(jié)束檢測(cè)31021IC卡R/W停止位置31022票箱1提取完成31023票箱2提取完成31024票箱1提供部位置31025預(yù)留31026票箱2提供部位置31027預(yù)留31028清分舌檔位置檢測(cè)31029預(yù)留31030票箱1上端檢測(cè)31031票箱2上端檢測(cè)-31032票箱1車票有無(wú)檢測(cè)31033票箱2車票有無(wú)檢測(cè)31034廢票箱滿檢測(cè)-31035票箱1舌檔打開(kāi)檢測(cè)31036票箱2舌檔打開(kāi)31037票箱1接近下限31038廢票箱舌檔打開(kāi)31039票箱1舌檔關(guān)閉31040BOM到位開(kāi)關(guān)31041TVM到位開(kāi)關(guān)31042預(yù)留31043預(yù)留31044預(yù)留31045預(yù)留31046預(yù)留31047預(yù)留結(jié)構(gòu)體說(shuō)明返回狀態(tài)結(jié)構(gòu)體typedefstruct{UINTuiProviderId;//模塊廠家標(biāo)識(shí)三星0x02、廣電0x04、中軟0x06、歐姆龍0x05；UINTuiModuleType;//模塊類型標(biāo)識(shí)0x06車票發(fā)售模塊UINTuiType