金天鹅门禁接口说明V12

1、金天鹅门禁接口说明V12接口说明一、文件说明JKXYLOCK.dll H锁接口文件，此文件需要拷贝至应用程序工作目录下XYID.dll H锁接口环境支持文件，此文件需要拷贝至应用程序工作目录下JKDemo.exe接口演示程序文件VBDemo.rar接口演示源程序Visual Basic 6.0JKTool.exe获取门锁软件中 的门 锁编码及接口授权二、接步骤1. 电脑环境应正常安装门锁软年，并且门锁软件已正常工作；2. 运行JKTool.exe文件，按取门锁编码获取房号与门锁编码，房号及其对应 矢系保存在文件XYLockCode.txt中，此文件可给开发人员参考使用。文件中房号等于 后面的就

2、是门锁编码，写卡时需要正确传入此编码；3. 在JKTool工具程序窗口中按读授权卡，此时放置授权卡，再按读授权卡 按钮，然后将显示的信息码报给软件供应商，获取注册码，注册码成功后就可进行接口 开发工作。4. 可以开始看接函数及写代码了。三、接函数说明1. int JK_XYOpenCom(int p_nPort);功能:打开卡机的通讯端口参数:p-nPort表通讯端口号，值为0-255;建议用函数JK_XYScanReaderPort返回的卡机端号，直接传入就可以了。返回:参考错误代码说明。注意:打开端口后，在不需要读写卡时请矢闭端口。2. int JK_XYCIoseCom(void);功能

3、:尖闭卡机的通讯端口参数:无返回:参考错误代码说明。注意:完成读写卡后，请调用此函数矢闭端口。3. int JK_XYScanReaderPort(int &p_nComPort,int &p_nReaderlD);功能：自动扫描当前插入的读卡机，并返回通讯端及卡机类型参数:p_nComPort返回的读卡机所在的端口号，此端口号可供JK_XYOpenCom 函数使用，p_nReader!D返回的卡机类型，1 表示T57卡卡机，2表示M1卡卡 机返回:参考错误代码说明。4. int JK_XYReadGuestCard(LPSTR p_csRoomNo,LPSTR p_csSta

4、rtTime,int&p_nTimellnit,int &p_nTimeLength,int &p_nStopFlag丄PSTR p_csCardNo);功能:读客人卡，此函数只能读客人卡参数：p_csRoomNo返回客人卡的门锁编码，此门锁编码独立于接口使用，用户软件不要去管理它;p_csStartTime客人卡开门的起始时间，格式为YYMMDD，HH如12112718表示 2012 年 11 月 27 0 18 时；p_nTimeUnit有效开门的时间单位，0-以小时为单位，1-以天为单位，2-以-以年为单位；月为单位，3p_nTimeLength开门的有效时间，以

5、小时为单位时此值范围为1-63,以天为单 位时此值范围为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);功

6、能:写客人卡，此函数只能发行客人卡参数：p_csRoomNo客人卡的门锁编码，此门锁编码独立于接使用，用户软件不要 去管理它，此门锁编码可以从读客人卡函数中返回，也可以用JKTool.exe工具程 序一次性获取房号对应的门锁编码；p_csStartTime客人卡开门的起始时间，格式为丫YMMDD，HH如12112718表 示2012年11月27 S 18时；p_nTimeUnit有效开门的时间单位，0-以小时为单位，1-以天为单位，2-以月为单位，3-以年为单位；p_nTimeLength开门的有效时间，以小时为单位时此值范围为1-63,以天为单 位时此值范围为1-63,以月为单位时此值范围为

7、1-15,以年为单位时此值范围为 1-3；p_nStopFlag挂失旧的客人卡标志，0-表示不挂失旧客人卡，1-表示能挂失旧 的客人卡。p_csCardNo此客人卡的卡号，卡号由接自动生成，卡号值是与起始时间有 矢系的。写卡完成后即返回此卡的最新卡号。返回:参考错误代码说明。6. int JK_XYCIearGuestCard(void); 功能：清空客人卡，也就可客人卡退房。参数:无返回:参考错误代码说明。四、错误代码说明错误代码错误说明备注没有找到卡机检查卡机有否正确插入电脑的USB 口20读卡机型号不对21没有找到可用的卡片需要正确放置在卡机的感应区22 比对卡片密码错误23读卡失败放好卡后不要触碰卡，直至写卡完成24 写卡失败放好卡后不要触碰卡，直至写卡完成25卡机错误不能正确读写卡机26门锁接口授权错误必须使用正确授权的卡机，包括厂家授权及27读授权卡授 权。门锁接口授权失败必须使用正确授权的卡机，包括厂家授权及28读授权卡授 权。卡片数据错误非法的卡片29这张卡不是客人开门卡 接口只能读写客人卡30这张卡是新的用户卡 新的用户 卡，这张卡是已退房的卡已退房的 卡，这张卡是已注销的卡 已注销的卡，不显示信息，但可直接发卡31不显示信息，但可直接发卡32不显示信息，但可直接发卡33房号编码格式有错误门锁编码格式必须是通过读卡或JKTool