一、文档
调用函数库:
提供Windows下的32位动态连接库proRFL.DLL,函数使用详细说明
//-----------------------------------------------------------------------------------//
功能:读DLL版本,不涉及USB口操作
C++原型:int __stdcall GetDLLVersion(uchar *bufVer)
返回:DLL版本
//-----------------------------------------------------------------------------------//
功能:打开USB
C++原型:int __stdcall initializeUSB(uchar d12)
参数说明:
d12 à USB类型,对于proUSB固定为1
返回:0表示成功,否则失败
注意:以下的函数均要用到此参数,均固定为1
//-----------------------------------------------------------------------------------//
功能:关闭proUSB
C++原型: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固定为1
t à鸣叫时间,乘以10毫秒
返回:0表示成功,否则失败
//-----------------------------------------------------------------------------------//
功能:发行"宾客卡",又称"宾客卡"或"房卡"
C++原型:int __stdcall GuestCard(uchar d12,int dlsCoID,uchar CardNo,uchar dai,uchar LLock,uchar pdoors,uchar BDate[10],uchar EDate[10],uchar LockNo[8],uchar *cardHexStr)
参数说明:
d12 à USB类型,对于proUSB固定为1
dlsCoID à 酒店标识,可以从现有卡片读取
CardNo à 同一分钟内发卡最多16张,每发一张卡加1
Dai à 客人代,0--255,用于后卡覆盖前卡,一般情况下固定为0
LLock à 反锁标志,1能开反锁,0不能开反锁
pdoors à 固定为0
BDate à 发卡时间10位数字字符串,包含年月日时分,各占两位
例:'2405201345'表示2024/05/20 13:45
EDate à 退房时间10位数字字符串,包含年月日时分,各占两位
LockNo à 房间号8位数字字符串,从门锁软件的房间定义里获取
cardHexStr à 返回的卡数据字符串
返回:0表示成功,否则失败
//-----------------------------------------------------------------------------------//
功能:读取卡片数据
C++原型:int __stdcall ReadCard(uchar d12,uchar *buffData)
d12 à USB类型,对于proUSB固定为1
buffData à 返回的卡数据字符串,有数据头551501表示成功,
从第25个字符开始的8个字符是卡的唯一号,也称为卡的ID号
返回:0表示成功,否则失败
对于M1卡,从第57个字符开始的8个字符是卡序列号,也称为卡的固有ID号
//-----------------------------------------------------------------------------------//
功能:注销卡片
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 BDate[10],uchar LCardNo[4],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---卡数据串无效
3---不是宾客卡
LockNo:房间号,有8位数字字符串组成,同GuestCard函数
//-----------------------------------------------------------------------------------//
功能:读取宾客卡的离店时间
C++原型:int __stdcall GetGuestETimeByCardDataStr(int dlsCoID,unsigned char *cardHexStr, unsigned char *ETime)
dlsCoID à 当前酒店的酒店标识
cardHexStr à ReadCard函数返回的卡数据字符串
返回:0表示成功,否则失败
1---卡数据串无效
ETime:离店时间,有10位数字字符串组成,分别为年月日时分,各占两位
//-----------------------------------------------------------------------------------//
二、界面
三、阿雪技术观
拥抱开源与共享,见证科技进步奇迹,畅享人类幸福时光!
让我们积极投身于技术共享的浪潮中,不仅仅是作为受益者,更要成为贡献者。无论是分享自己的代码、撰写技术博客,还是参与开源项目的维护和改进,每一个小小的举动都可能成为推动技术进步的巨大力量