酒店智能门锁接口pro[0922]D801 对接收银-SAAS本地化-未来之窗行业应用跨平台架构

proUSB接口函数[0922中性版]-D801

调用函数库：

提供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 à 公共门标志，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 BDate[10],uchar EDate[10],uchar RoomNo[8],uchar *cardHexStr)

所有参数跟GuestCard完全一样，只是发出来的宾客卡具备常开功能，也就是刷一下宾客卡，门锁处于常开状态。压住手柄再刷宾客卡，即解除常开。

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

功能：读取卡片数据

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—卡数据串无效

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 bufRec[20000])

返回：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个字符）。

sOpen[0]：卡类型，同“读取卡类型”函数

sOpen[1...12]：开门时间，有12位数字字符串组成，分别为年月日时分秒，各占两位（其中秒只能精确到2秒）

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

功能：读取T5557卡固有的ID号

C++原型：int __stdcall ReadCardID_T5557(uchar d12,uchar *buffData)

d12 à USB类型，对于proUSB固定为1

buffData à 返回的字符串，有数据头550901表示成功，从第7个字符开始的16个字符是T5557卡固有的ID号，一般以E015开头。

返回：0表示成功，否则失败

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