金天鵝門禁接口說明V12

1、金天鵝門禁接口說明V12接口說明一、文件說明JKXYLOCK.dll H鎖接口文件，此文件需要拷貝至應(yīng)用程序工作目錄下XYID.dll H鎖接口環(huán)境支持文件，此文件需要拷貝至應(yīng)用程序工作目錄下JKDemo.exe接口演示程序文件VBDemo.rar接口演示源程序Visual Basic 6.0JKTool.exe獲取門鎖軟件中 的門 鎖編碼及接口授權(quán)二、接步驟1. 電腦環(huán)境應(yīng)正常安裝門鎖軟年，并且門鎖軟件已正常工作；2. 運行JKTool.exe文件，按取門鎖編碼獲取房號與門鎖編碼，房號及其對應(yīng) 矢系保存在文件XYLockCode.txt中，此文件可給開發(fā)人員參考使用。文件中房號等于 后面的就

2、是門鎖編碼，寫卡時需要正確傳入此編碼；3. 在JKTool工具程序窗口中按讀授權(quán)卡，此時放置授權(quán)卡，再按讀授權(quán)卡 按鈕，然后將顯示的信息碼報給軟件供應(yīng)商，獲取注冊碼，注冊碼成功后就可進行接口 開發(fā)工作。4. 可以開始看接函數(shù)及寫代碼了。三、接函數(shù)說明1. int JK_XYOpenCom(int p_nPort);功能:打開卡機的通訊端口參數(shù):p-nPort表通訊端口號，值為0-255;建議用函數(shù)JK_XYScanReaderPort返回的卡機端號，直接傳入就可以了。返回:參考錯誤代碼說明。注意:打開端口后，在不需要讀寫卡時請矢閉端口。2. int JK_XYCIoseCom(void);功能

3、:尖閉卡機的通訊端口參數(shù):無返回:參考錯誤代碼說明。注意:完成讀寫卡后，請調(diào)用此函數(shù)矢閉端口。3. int JK_XYScanReaderPort(int &p_nComPort,int &p_nReaderlD);功能：自動掃描當前插入的讀卡機，并返回通訊端及卡機類型參數(shù):p_nComPort返回的讀卡機所在的端口號，此端口號可供JK_XYOpenCom 函數(shù)使用，p_nReader!D返回的卡機類型，1 表示T57卡卡機，2表示M1卡卡 機返回:參考錯誤代碼說明。4. int JK_XYReadGuestCard(LPSTR p_csRoomNo,LPSTR p_csStartTime,i

4、nt&p_nTimellnit,int &p_nTimeLength,int &p_nStopFlag丄PSTR p_csCardNo);功能:讀客人卡，此函數(shù)只能讀客人卡參數(shù)：p_csRoomNo返回客人卡的門鎖編碼，此門鎖編碼獨立于接口使用，用戶軟件不要去管理它;p_csStartTime客人卡開門的起始時間，格式為YYMMDD，HH如12112718表示 2012 年 11 月 27 0 18 時；p_nTimeUnit有效開門的時間單位，0-以小時為單位，1-以天為單位，2-以-以年為單位；月為單位，3p_nTimeLength開門的有效時間，以小時為單位時此值范圍為1-63,以天為單

5、 位時此值范圍為1-63,以月為單位時此值范圍為1-15,以年為單位時此值范圍為1- 3；p_n Stop Flag掛失舊的客人卡標志，0-表示不掛失舊客人卡，1-表示能掛失舊 的客人卡。p_csCardNo此客人卡的卡號，卡號由接自動生成，卡號值是與起始時間有 矢系的。返回:參考錯誤代碼說明。5. int JK_XYWriteGuestCard(LPSTR p_csRoomNo,LPSTR p_csStartTime,int p_nTimeUnit,int p_nTimeLength,int p_nStopFlag丄PSTR p_csCardNo);功能:寫客人卡，此函數(shù)只能發(fā)行客人卡參數(shù)：

6、p_csRoomNo客人卡的門鎖編碼，此門鎖編碼獨立于接使用，用戶軟件不要 去管理它，此門鎖編碼可以從讀客人卡函數(shù)中返回，也可以用JKTool.exe工具程 序一次性獲取房號對應(yīng)的門鎖編碼；p_csStartTime客人卡開門的起始時間，格式為丫YMMDD，HH如12112718表 示2012年11月27 S 18時；p_nTimeUnit有效開門的時間單位，0-以小時為單位，1-以天為單位，2-以月為單位，3-以年為單位；p_nTimeLength開門的有效時間，以小時為單位時此值范圍為1-63,以天為單 位時此值范圍為1-63,以月為單位時此值范圍為1-15,以年為單位時此值范圍為 1-3

7、；p_nStopFlag掛失舊的客人卡標志，0-表示不掛失舊客人卡，1-表示能掛失舊 的客人卡。p_csCardNo此客人卡的卡號，卡號由接自動生成，卡號值是與起始時間有 矢系的。寫卡完成后即返回此卡的最新卡號。返回:參考錯誤代碼說明。6. int JK_XYCIearGuestCard(void); 功能：清空客人卡，也就可客人卡退房。參數(shù):無返回:參考錯誤代碼說明。四、錯誤代碼說明錯誤代碼錯誤說明備注沒有找到卡機檢查卡機有否正確插入電腦的USB 口20讀卡機型號不對21沒有找到可用的卡片需要正確放置在卡機的感應(yīng)區(qū)22 比對卡片密碼錯誤23讀卡失敗放好卡后不要觸碰卡，直至寫卡完成24 寫卡失敗放好卡后不要觸碰卡，直至寫卡完成25卡機錯誤不能正確讀寫卡機26門鎖接口授權(quán)錯誤必須使用正確授權(quán)的卡機，包括廠家授權(quán)及27讀授權(quán)卡授 權(quán)。門鎖接口授權(quán)失敗必須使用正確授權(quán)的卡機，包括廠家授權(quán)及28讀授權(quán)卡授 權(quán)?？ㄆ瑪?shù)據(jù)錯誤非法的卡片29這張卡不是客人開門卡 接口只能讀寫客人卡30這張卡是新的用戶卡 新的用戶 卡，這張卡是已退房的卡已退房的 卡，這張卡是已注銷的卡 已注銷的卡，不顯示信息，但可直接發(fā)卡31不顯示信息，但可直接發(fā)卡32不顯示信息，但可直接發(fā)卡33房號編碼格式有錯誤門鎖編碼格式必須是通過讀卡或JKTool.