接口文件rf門鎖說明

1、Temic/EM 卡（感應(yīng)式）門鎖接口開發(fā)包使用說明V4_C此接口函數(shù)僅適應(yīng)于V5.8_C 版門鎖管理一、Tem門鎖工作原理卡中主要有作業(yè)流水號、時(shí)間長度兩種類型參數(shù)來決定開啟房門的條件：1 更換作業(yè)流水號標(biāo)志，其中作業(yè)流水號是由日期時(shí)間中的年月日時(shí)+1 小時(shí)內(nèi)所發(fā)卡的序號組成。1 小時(shí)內(nèi)的發(fā)卡序號需由開發(fā)認(rèn)可用的序號。在程序設(shè)計(jì)時(shí)做好分析判斷，并確卡中作業(yè)流水號必須大于等于門鎖電路板中作業(yè)流水號，否則將導(dǎo)致開門失敗。2 取消在用的客人卡（可解釋為掛失客人卡）標(biāo)志使用方法：單個(gè)客人必須置對應(yīng)標(biāo)志位為 1；多個(gè)客人住同一間房時(shí)的情況可舉例說明如下：若一個(gè)房間同時(shí)發(fā)三張卡，第一張卡對應(yīng)掛失標(biāo)志為需

2、置為 1，后兩張卡該掛失標(biāo)志位需置為 0。3 最重要的是需在接口中寫客人卡之前，應(yīng)先將工具GetLockID.exe 拷貝至門鎖工作目錄下，然后再運(yùn)行 GetLockID.exe 文件,運(yùn)行后選擇對應(yīng)的門鎖軟件的版本號，然后獲取門鎖中的房號與門鎖對應(yīng)表文件，再將此文件中的房號門鎖關(guān)系，改成自已的對應(yīng)表； 或在門鎖中每一房號寫一遍客人卡，然后一一讀出客人卡的門鎖就簡單了。來建立你自己的房號門鎖對應(yīng)庫，剩下的過程4 特別注意，每張卡的作業(yè)流水號務(wù)必保持唯一并且存擋，它是開門查詢的依據(jù)。二、函數(shù)原型接口動態(tài)庫文件：LCRFRW_SDK.dll1 打開串口(com,baud);2 讀卡tem_read

3、doorcard_sdk(LPSTR BH, LPSTR buff,p_nLockAP)返回 10 個(gè)字符的門鎖；tem_readdatetime_sdk (LPSTR p_SDT, LPSTR p_Unit, LPSTR p_Times,p_nLockAP)返回起始時(shí)間，時(shí)間，時(shí)間長度tem_readidcard_sdk (LPSTR buff)返回 ID 卡的 10 個(gè)字符的 ID 號；注函數(shù)僅僅針對 ID 卡3 寫卡tem_writedoorcard_sdk(LPSTRBH,LPSTR fksj,xh,sjdw,sjlength,bool gs,p_nLockAP)寫 10 個(gè)字符的門鎖

4、：4 關(guān)閉串口(void);三、用戶接口開發(fā)使用步驟1.門鎖接口運(yùn)行接口資料中的工具程序雙擊即可,向酒店方索要門鎖卡，準(zhǔn)備好后放置在上，然后按讀卡按鈕開始讀卡，讀卡成功后將顯示信息碼，然后將此信息碼返回給門鎖供應(yīng)商索取接口的碼，輸入獲取的正確的行接口開發(fā)工作。注：碼后按確定按鈕開始，成功后即可開始進(jìn)如門鎖接口未在這里輸入門鎖，在進(jìn)行讀寫卡時(shí)將返回錯(cuò)誤代碼 128.的碼是無效的.2. 將獲取房號門鎖工具文件 GetLockID.exe 拷貝至門鎖工作目錄下。3. 運(yùn)行 GetLockID.exe 文件，選擇對應(yīng)門鎖版本，然后按獲取按鈕，得出房號門鎖對應(yīng)關(guān)系表， 獲取的此表文件存放于門鎖的工作目錄

5、下的LockID.ini，用戶可直接將此文件拷貝至接口工作目錄下，接口可直接對此表進(jìn)行操作，或另建自已的數(shù)據(jù)庫表進(jìn)行讀操作。LockID.ini 文件說明：此文件中左邊是房號,右邊是對應(yīng)此房號的門鎖。注：此文件中最后的 LockAP=X 項(xiàng)中X 為門鎖系統(tǒng)中的標(biāo)識號，此標(biāo)識號即為讀寫卡函數(shù)中 p_nLockAP 參數(shù)。4. 將門鎖接口文件 LCRFRW_SDK.dll 拷貝至接口程序工作目錄下。5. 接上的接口，安裝 USB驅(qū)動(運(yùn)行 USBDriver_RW.exe 驅(qū)動程序即可自動完成)。6. 使用的接口，否則接口函數(shù)在讀寫卡時(shí)將返回錯(cuò)誤代碼值 129。7. 建立自己的房號門鎖對應(yīng)關(guān)系表,

6、這里有兩種方法：A 利用 GetLockID.exe 工具系表填入自已的房號門鎖B獲取的房號與門鎖對應(yīng)關(guān)系表，將此對應(yīng)關(guān)數(shù)據(jù)表中，或直接使用此表；C 利用 SDK 接口讀卡函數(shù)或演示程序讀出卡片數(shù)據(jù)中的門鎖部分。房號門鎖對應(yīng)關(guān)系表至少應(yīng)包括門鎖及所對應(yīng)的房號字段，門鎖為 10個(gè)字符長度的字段，如下表(此表是假設(shè)用戶建立起的自已的房號數(shù)據(jù)表)門鎖房號Abcd0001101Efgh0002102Acda0003201表 1注：存入的門鎖字用戶不要關(guān)心它是否具務(wù)一定的規(guī)律性的，其值是門鎖自動分配的一個(gè)沒有規(guī)律的門鎖，用戶只需將此作為寫卡參數(shù)即可。門鎖系統(tǒng)就是用此條件之一。對房門進(jìn)行且為唯一一標(biāo)識號，

7、它是決定是否能開門的8. 開始讀卡，將讀出卡中的門鎖及日期時(shí)間序號，讀出的門鎖為 10 個(gè)字符。在寫卡之前用戶可以不進(jìn)行讀卡，根據(jù)實(shí)際應(yīng)用情況用戶可選擇讀卡或不讀卡。9. 輸入房號，接口需從房號數(shù)據(jù)表找到此房號所在所對應(yīng)的門鎖字，如輸入房號 201 則接口將找到門鎖為 Acda0001，用此門鎖作為寫卡函數(shù)中的門鎖的參數(shù)值。10. 將當(dāng)前時(shí)間、發(fā)卡序號（1 小時(shí)內(nèi)）、時(shí)間、對應(yīng)時(shí)間的時(shí)間長度、是否掛失在用的客人卡標(biāo)志等內(nèi)容按規(guī)定的格式作為寫客人卡時(shí)的對應(yīng)參數(shù)。11. 開始將已準(zhǔn)備好的參數(shù)數(shù)據(jù)寫入卡中。接口程序的函數(shù)調(diào)用的步驟一般為：A 打開串口(com,baud);B 讀卡tem_readdo

8、orcard_sdk(LPSTR BH, LPSTR buff,p_nLockAP)返回 10 個(gè)字符的門鎖；C 寫卡tem_writedoorcard_sdk(LPSTRBH,LPSTRfksj,xh,sjdw,sjlength,bool gs,寫 10 個(gè)字符的門鎖p_nLockAP)；D 關(guān)閉串口(void);四、函數(shù)使用說明1 打開串口(com,baud);參 數(shù) COM=0：串行口一 COM=1：串行口二 Baud=9600(固定);返回值0：正確；其它：參看函數(shù)返回代碼注意：1. USB在安裝驅(qū)動后，其串值的查看如下所示：Bded0004202.在桌面上找到備管器，如下圖：電腦，在

9、電腦上按右鍵-點(diǎn)擊屬性-點(diǎn)擊硬件-點(diǎn)擊設(shè)串為 3，在打開串口的串口參數(shù)應(yīng)為 2一般 USB的串值為 3-8;2. 非 USB號為 1-2;的串一般在門鎖中的對應(yīng)參數(shù)功能中查看，一般其串口3. 接口中的串是從 0 開始的，門鎖中的串是從 1 開始，所以如果在門鎖中的看到的串口參數(shù)為串口一,則此處的的參數(shù)應(yīng)填寫為 0。2 讀卡tem_readdoorcard_sdk(LPSTR BH, LPSTR buff,p_nLockAP)BH: 門鎖buff:卡，10 字符長度，期時(shí)間,長度為 10 個(gè)字符，前 8 個(gè)為年月日時(shí)，后兩位為一小時(shí)內(nèi)發(fā)卡序號（它是一個(gè)十六進(jìn)制數(shù)），讀出結(jié)果為作業(yè)流水號。每張卡的

10、作業(yè)流水號是唯一的。P_nLockAP:即為系統(tǒng)標(biāo)識號，此號僅為二級商管理模式下有效，其它模式為 0即可，此系統(tǒng)標(biāo)識號對應(yīng)獲取門鎖時(shí)在文本文件中的最后項(xiàng)，LockAP=項(xiàng)中.在讀卡之前，卡片必須經(jīng)門鎖系統(tǒng)寫過一次客人卡（主要是寫入客人卡標(biāo)識），否則讀卡將失敗返回。返回值0：正確；其它：參看函數(shù)返回代碼3 讀卡的時(shí)間信息tem_readdatetime_sdk (LPSTR p_SDT, LPSTR p_Unit, LPSTR p_Times, p_nLockAP)p_SDT:起始時(shí)間,8 字符長度p_Unit:時(shí)間,0-小時(shí)，1-日，2-月，3-年；p_Times：時(shí)間長度P_nLockAP:

11、即為系統(tǒng)標(biāo)識號，此號僅為二級商管理模式下有效，其它模式為 0即可，此系統(tǒng)標(biāo)識號對應(yīng)獲取門鎖時(shí)在文本文件中的最后項(xiàng)，LockAP=項(xiàng)中.在讀卡之前，卡片必須經(jīng)門鎖系統(tǒng)寫過一次客人卡（主要是寫入客人卡標(biāo)識），否則讀卡將失敗返回。返回值0：正確；其它：參看函數(shù)返回代碼4 寫卡tem_writedoorcard_sdk(LPSTR BH, LPSTR fksj,xh,sjdw,sjlength,bool gs,參 數(shù)p_nLockAP)BH: 門鎖為 10 字符長度。fksj: 發(fā)卡時(shí)間，為年月日時(shí)，每個(gè)兩位，比如發(fā)卡時(shí)間為 2004 年 8 月 9 日 10 點(diǎn)，fksj=“04080910”；注意

12、：如果一小時(shí)內(nèi)的發(fā)卡序號超過 63 此發(fā)卡時(shí)間可以小時(shí)+1 方式進(jìn)行。比如，當(dāng)前時(shí)間是 2004 年 08 月 09 日 10 點(diǎn)，如在此 10 點(diǎn)內(nèi)的發(fā)卡序號在 0-63 內(nèi)則此參數(shù)值為 04080910,如在此 10 點(diǎn)內(nèi)的發(fā)卡序號已超過 63，則此參數(shù)值為04080910+1 小時(shí)=04080911,同時(shí)發(fā)卡序號再從 0 開始?？腿送朔繒r(shí)仍可調(diào)用此函數(shù)進(jìn)行退房寫卡，達(dá)到回收卡片功能，此時(shí)的寫卡參數(shù)中的 BH=實(shí)際門鎖，fksj=00000000,xh=0,sjdw=0,sjlength=1,gs=0 即實(shí)現(xiàn)退房回收卡片功能。xh： 一小時(shí)內(nèi)發(fā)卡序號，從 0 到 63；此發(fā)卡序號意為當(dāng)前寫

13、卡時(shí)間的小時(shí)內(nèi)的第幾次寫卡，如果在當(dāng)前小時(shí)內(nèi)的寫卡次數(shù)超過64 次(即發(fā)卡序號大于63),則需要將fksj 參數(shù)以小時(shí)數(shù)+1 為新的fksj參數(shù)進(jìn)行寫卡，同時(shí)此發(fā)卡序號復(fù)位為 0 開始(即新的 fksj 中的序號)。sjdw: 時(shí)間(小時(shí)/天/月/年)；0 為小時(shí)，1 為天，2 為月，3 為年。其它為天sjlength:時(shí)間長度；卡片有效時(shí)間。為幾天或?yàn)閹仔r(shí)。取值范圍（1-63 小時(shí)/ 1-63天/ 1-15 月 /1-3 年）gs:1 為取消在用的客人卡（掛失），0 為不取消（不掛失）。P_nLockAP:即為系統(tǒng)標(biāo)識號.退房時(shí)間的鐘點(diǎn)在非小時(shí)時(shí)間時(shí)是由門鎖系統(tǒng)自行設(shè)定，接口不用關(guān)心。返回

14、值0：正確；其它：參看函數(shù)返回代碼5 關(guān)閉串口(void);參 數(shù)無返回值0：正確；其它：參看函數(shù)返回代碼注：讀寫卡完成后必須調(diào)用此函數(shù)關(guān)閉串口，以便串口資源。五、總卡，棟卡，層卡的制作說明：此類卡的制作與客人卡的制作基本相擬，只需將讀客人卡的更換成讀相應(yīng)總卡或棟卡或?qū)涌ǖ?，具體說明如下:在門鎖系統(tǒng)中制作一總卡或棟卡或?qū)涌?，然后用演示程序或接口程序讀出此卡的門鎖編號，讀出后保存至自已的數(shù)據(jù)庫中，并標(biāo)明此為總卡或棟卡或?qū)涌ǖ?，接口程序制作總卡或棟卡或?qū)涌〞r(shí)首先在自已的數(shù)據(jù)庫中找到此總卡或棟卡或?qū)涌▽?yīng)的此值作為參數(shù)調(diào)用寫卡函數(shù)(tem_writedoorcard_sdk()即可。如下表所示：然后

15、用即寫卡函數(shù) tem_writedoorcard_sdk()能制作所有開門卡，調(diào)用時(shí)僅僅門鎖化，其它參數(shù)意義均一致相同.參數(shù)有所變同樣，接口程序在制作總卡或棟卡或?qū)涌ň栌迷陂T鎖系統(tǒng)中制過的客人卡進(jìn)行制作。六、時(shí)鐘卡的制作 必須在門鎖管理1 讀時(shí)鐘卡中寫過一次的時(shí)鐘卡.tem_readtimercard_sdk(LPSTR fksj,LPSTR lpTime,參數(shù)說明:p_nLockAP)fksj:卡期時(shí)間,長度為 10 個(gè)字符，前 8 個(gè)為年月日時(shí)，后兩位為一小時(shí)內(nèi)發(fā)卡序號(十六進(jìn)制)，讀出結(jié)果為作業(yè)流水號。lpTime:上次寫卡的時(shí)鐘,時(shí)鐘格式為年+月+日+時(shí)+分, 長度為 10 個(gè)字符，

16、每段均占用 2 位，如 0712081530 表示 2007 年 12 月 8 日 15 點(diǎn) 30 分P_nLockAP:即為系統(tǒng)標(biāo)識號.卡類Abcd0001總卡Efgh0002棟卡Ijkl0003層卡2 寫時(shí)鐘卡tem_writetimercard_sdk(LPSTR fksj,參數(shù)說明:nXh, LPSTR lpTime,p_nLockAP)fksj: 發(fā)卡時(shí)間，長度為 8 個(gè)字符，分別年月日時(shí)，每個(gè)兩位，比如發(fā)卡時(shí)間為 2004年 8 月 9 日 10 點(diǎn)，fksj=“04080910”；xh： 一小時(shí)內(nèi)發(fā)卡序號，從 0 到 63；lpTime:寫入的時(shí)鐘, 長度為 10 個(gè)字符(傳遞至

17、門鎖的時(shí)鐘)，分別年月日時(shí)分，每個(gè)兩位,精確至分鐘，如 0408092052 表示需要將門鎖時(shí)鐘調(diào)至 2004 年 8 月 9 日 20 點(diǎn) 52 分.P_nLockAP:即為系統(tǒng)標(biāo)識號.注意:時(shí)鐘中的年月日與流水號的年月日需相同七、函數(shù)返回代碼代碼描述原因解決方法0正確1通訊錯(cuò)誤通訊底層中斷檢查通訊硬件是否存在2超時(shí)錯(cuò)誤錯(cuò)誤檢查硬件及接口函數(shù)版本號3數(shù)據(jù)區(qū)域錯(cuò)誤錯(cuò)誤檢查硬件及接口函數(shù)版本號4數(shù)據(jù)錯(cuò)卡片數(shù)據(jù)發(fā)生錯(cuò)誤或卡片沒有重新將卡片插好或再在門鎖系統(tǒng)中重新寫一次客人卡,或輸入正確的系統(tǒng)標(biāo)識號插好或卡片不是客人卡,或系統(tǒng)標(biāo)識號錯(cuò)誤5通訊錯(cuò)誤通訊口不正確檢查通訊串或通訊線16無卡上沒有正確放置卡

18、片重新放置感應(yīng)卡至上卡片沒有上電卡片沒有放好重新放置卡片至上錯(cuò)誤錯(cuò)誤檢查硬件及接口函數(shù)版本號壞卡卡片可能已損壞換一張新的感應(yīng)卡重試。功能錯(cuò)誤錯(cuò)誤檢查硬件及接口函數(shù)版本號接口未未正確使用碼向門鎖供應(yīng)商索取碼129型號錯(cuò)誤非接口使用的或串錯(cuò)誤向門鎖供應(yīng)商索取接口或選擇正確的串130門鎖錯(cuò)誤輸入的對應(yīng)房號的門鎖有錯(cuò)誤重新獲取或檢查輸入的門鎖值131系統(tǒng)錯(cuò)誤輸入系統(tǒng)格式有錯(cuò)誤檢查輸入的系統(tǒng)值132卡錯(cuò)誤接口程序不能處理卡換開門卡133系統(tǒng)錯(cuò)誤輸入的系統(tǒng)與卡中系統(tǒng)不一致?lián)Q卡或改寫系統(tǒng)134錯(cuò)寫器與卡中系統(tǒng)不一換正確的或改正確的系統(tǒng)致256系統(tǒng)錯(cuò)誤錯(cuò)誤檢查硬件及接口函數(shù)版本號八、注意1. 所有客人卡片都必須在門鎖系統(tǒng)中寫一遍客人卡。2. 發(fā)卡原則，開門卡在酒店管理系統(tǒng)，而其他管理類卡片均需在門鎖系統(tǒng)。3.多個(gè)門鎖在不同卡片之間串發(fā)。4. 正式開通使用，建議將所有卡片全部收回之后，再發(fā)一張復(fù)位卡把所有門鎖的