接口说明.doc

调用函数库：提供Windows下的32位动态连接库proRFL.DLL函数使用详细说明/-/功能：读DLL版本，不涉及USB口操作C+原型：int _stdcall GetDLLVersion(uchar *bufVer)返回：DLL版本，本版本为20110526/-/功能：打开USBC+原型：int _stdcall initializeUSB(uchar d12)参数说明：d12 USB类型，对于proUSB固定为1返回：0表示成功，否则失败注意：以下的函数均要用到此参数，均固定为1/-/功能：关闭proUSBC+原型：void _stdcall CloseUSB(uchar d12)参数说明：d12 USB类型，对于proUSB固定为1，只能关闭proUSB返回：没有返回值注意：关闭以后就不能操作USB了，如果要操作USB，请先用initializeUSB打开USB/-/功能：发卡器鸣叫一声C+原型：int _stdcall Buzzer(uchar d12,unsigned char t)参数说明：d12 USB类型，对于proUSB固定为1t 鸣叫时间，乘以10毫秒返回：0表示成功，否则失败/-/功能：发行“客人卡”，又称“宾客卡”或“房卡”C+原型：int _stdcall GuestCard(uchar d12,int dlsCoID,uchar CardNo,uchar dai,uchar LLock,uchar pdoors,uchar BDate10,uchar EDate10,uchar LockNo8,uchar *cardHexStr)参数说明：d12 USB类型，对于proUSB固定为1 dlsCoID 酒店标识，可以从现有卡片读取 CardNo 同一分钟内发卡最多16张，每发一张卡加1 Dai 客人代，0-255，用于后卡覆盖前卡，一般情况下固定为0 LLock 反锁标志，1能开反锁，0不能开反锁 pdoors 公共门标志，1能开公共门，0不能开 BDate 发卡时间10位数字字符串，包含年月日时分，各占两位例：0905201345表示2009/05/20 13:45 EDate 退房时间10位数字字符串，包含年月日时分，各占两位 LockNo 锁号8位数字字符串，从门锁软件的房间定义里获取cardHexStr 返回的卡数据字符串返回：0表示成功，否则失败/-/常开客人卡C+原型：int _stdcall GuestCard1(uchar d12,int dlsCoID,uchar CardNo,uchar dai,uchar LLock,uchar pdoors,uchar BDate10,uchar EDate10,uchar RoomNo8,uchar *cardHexStr)所有参数跟GuestCard完全一样，只是发出来的客人卡具备常开功能，也就是刷一下客人卡，门锁处于常开状态。压住手柄再刷客人卡，即解除常开。/-/功能：读取卡片数据C+原型：int _stdcall ReadCard(uchar d12,uchar *buffData)d12 USB类型，对于proUSB固定为1buffData 返回的卡数据字符串，有数据头551501表示成功，从第25个字符开始的8个字符是卡的唯一号，也称为卡的ID号返回：0表示成功，否则失败/-/功能：注销卡片C+原型：int _stdcall CardErase(uchar d12,int dlsCoID,unsigned char *cardHexStr)d12 USB类型，对于proUSB固定为1 dlsCoID 酒店标识，可以从现有卡片读取cardHexStr 返回的卡数据字符串返回：0表示成功，否则失败/-/功能：挂失卡片C+原型：int _stdcall LimitCard(uchar d12,int dlsCoID,uchar CardNo,uchar dai,uchar BDate10,uchar LCardNo4,uchar *cardHexStr)参数说明：d12 USB类型，对于proUSB固定为1 dlsCoID 酒店标识，可以从现有卡片读取 CardNo 同一分钟内发卡最多16张，每发一张卡加1 Dai 代，0-255，用于后卡覆盖前卡，一般情况下固定为0 BDate 发卡时间10位数字字符串，包含年月日时分，各占两位例：0905201345表示2009/05/20 13:45 uchar LCardNo 遗失卡的卡流水号，4个字节，由发卡时间、卡类型、卡号等组成 cardHexStr 返回的卡数据字符串返回：0表示成功，否则失败/-/功能：读取卡类型C+原型：int _stdcall GetCardTypeByCardDataStr(unsigned char *cardHexStr, unsigned char *CardType)cardHexStr ReadCard函数返回的卡数据字符串返回：0表示成功，否则失败CardType=0 授权卡CardType=1 记录卡CardType=2 房号设置卡CardType=3 时间设置卡CardType=4 限制卡,也称为挂失卡CardType=5 组号设置卡CardType=6 客人卡CardType=7 退房卡CardType=8 组控卡CardType=9 未知卡,没有此卡类型CardType=A 应急卡CardType=B 总卡CardType=C 楼栋卡CardType=D 楼层卡CardType=E 未知卡,没有此卡类型CardType=F 空白卡/-/功能：读取客人卡的锁号C+原型：int _stdcall GetGuestLockNoByCardDataStr(int dlsCoID,unsigned char *cardHexStr, unsigned char *LockNo)dlsCoID 当前酒店的酒店标识cardHexStr ReadCard函数返回的卡数据字符串返回：0表示成功，否则失败, 1卡数据串无效2非本酒店卡3不是客人卡LockNo：锁号，有8位数字字符串组成，同GuestCard函数/-/功能：读取客人卡的离店时间C+原型：int _stdcall GetGuestETimeByCardDataStr(int dlsCoID,unsigned char *cardHexStr, unsigned char *ETime)dlsCoID 当前酒店的酒店标识cardHexStr ReadCard函数返回的卡数据字符串返回：0表示成功，否则失败1卡数据串无效2非本酒店卡3不是客人卡ETime：离店时间，有10位数字字符串组成，分别为年月日时分，各占两位/-/功能：读取采集器数据C+原型：int _stdcall ReadRecord(uchar d12, uchar bufRec20000)返回：0表示成功，否则失败一般来讲，数据仪返回64帧数据，每帧数据包含74个字符，其中前6个固定为552101，最后两个是帧号，倒数第3第4个是校验，中间64个是数据。从第9帧数据开始，每帧数据有4条记录，每16个字符为一条记录/-/功能：根据采集器数据解析开门记录C+原型：int _stdcall GetOpenRecordByDataStr(unsigned char *DataStr, unsigned char *sOpen)返回：0表示成功，否则失败DataStr：从“记录仪”返回的8字节数据（16个字符）。sOpen0：卡类型，同“读取卡类型”函数sOpen1.12：开门时间，有12位数字字符串组成，分别为年月日时分秒，各占两位（其中秒只能精确到2秒）/-/功能：读取T5557卡固有的ID号C+原型：int _stdcall ReadCardID_T5557(uchar d12,uchar *buffData)d12 USB类型，对于proUSB固定为1buffData 返回的字符串，有数据头550901表示成功，从第7个字符开始的16个字符是T5557卡固有的ID号，一般以E015开头。返回：0表示成功，否则失败/-/功能：设置发卡器的工作模式注意：本函数需配合USB监视软件proMonitor.exe使用C+原型：int _stdcall SetReaderMode(uchar d12,uchar mode,uchar data)d12 USB类型，对于proUSB固定为1mode 发卡器的工作模式。0-普通模式，1-读卡模式，2-写卡模式data 当mode=1时，data=0表示不校验，data=1表示带校验当mode=2时，将 data写入卡片。data=0x60表示开台，data=0xf0表示结账。data=0x61表示开台带校验，data=0xf1表示结账带校验。返回：0表示成功，否则失败自动读卡后，通过USB监视软件proMonitor.exe将数据发送到当前输入框，以552101开头，其后20字节是卡数据（一般以C9开头），再往后的8字节是T5557卡固有的物理ID号（以E015开头），再往后是4字节的BLOCK6数据，其他的数据没用。例如：/-/功能：直接读取USB缓存注意：在自动模式下，发卡器会往USB缓存上传数据，需要清除，才能正常调用有读数据功能的DLL函数C+原型：int _stdcall DirectReadUSB(uchar d12, uchar *data)d12 USB类型，对于proUSB固定为1data USB缓存里的数据，为一串CCCCCCCC表示已经清空/-/功能：读取指定BLOCK（块）的数据C+原型：int _stdcall ReadBlock(uchar d12,uchar block,uchar *data)d12 USB类型，对于proUSB固定为1data 返回的数据，以550501开头表示读卡成功，后面的4字节就是该BLOCK的数据。一般而言，BLOCK 6可以开放给用户使用。对于激活型的卡，BLOCK 3的第三位（第二字节的前半字节）为6表示处于激活状态，否则表示冻结状态（结账了）。返回：0表示成功，否则失败/-/功能：写数据到指定的BLOCK（块）C+原型：int _stdcall WriteBlock(