酒店智能门锁接口pro[V10] 对接酒店收银-SAAS本地化-未来之窗行业应用跨平台架构
一、文档
调用函数库：
提供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位数字字符串组成，分别为年月日时分，各占两位
//-----------------------------------------------------------------------------------//
二、界面
三、阿雪技术观
拥抱开源与共享，见证科技进步奇迹，畅享人类幸福时光！
让我们积极投身于技术共享的浪潮中，不仅仅是作为受益者，更要成为贡献者。无论是分享自己的代码、撰写技术博客，还是参与开源项目的维护和改进，每一个小小的举动都可能成为推动技术进步的巨大力量
