一、文档

调用函数库：

提供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位数字字符串组成，分别为年月日时分，各占两位

//-----------------------------------------------------------------------------------//

二、界面

 

三、阿雪技术观

拥抱开源与共享，见证科技进步奇迹，畅享人类幸福时光！

让我们积极投身于技术共享的浪潮中，不仅仅是作为受益者，更要成为贡献者。无论是分享自己的代码、撰写技术博客，还是参与开源项目的维护和改进，每一个小小的举动都可能成为推动技术进步的巨大力量