### K9-Lock门锁接口说明
#### 一、概述
K9-Lock门锁接口是一种专门用于酒店客房管理系统中的接口技术，通过该接口能够实现对门锁的控制与管理，包括但不限于读取门锁软件版本、发卡、读取卡片信息等功能。本文将详细介绍K9-Lock门锁接口的主要功能及其使用方法。
#### 二、调用函数库
K9-Lock门锁接口提供了一个Windows平台下的32位动态链接库（Dynamic Link Library，DLL），名为`K9RF.DLL`。该DLL包含了实现门锁接口功能所需的所有函数，并提供了详细的函数使用说明。开发者可以通过查看示例代码来学习如何正确地调用这些函数。
#### 三、主要功能及使用说明
##### 1. 读取DLL版本
**功能简介**：此函数用于读取动态链接库的版本信息。
**C++原型**：
```cpp
int __stdcall GetDLLVersion(uchar *bufVer);
```
**参数**：
- `bufVer`：指向一个缓冲区的指针，用于存储返回的版本号。
**返回值**：返回版本号。
**示例**：
```cpp
uchar version[10];
if (GetDLLVersion(version) > 0) {
printf("DLL Version: %s\n", version);
}
```
##### 2. 发卡器鸣叫
**功能简介**：使发卡器发出指定时长的声音。
**C++原型**：
```cpp
int __stdcall Buzzer(unsigned char t);
```
**参数**：
- `t`：鸣叫时长，单位为10毫秒。建议取值范围为20至50。
**返回值**：
- `0`：表示成功。
- 非零值：表示失败。
**示例**：
```cpp
if (Buzzer(20) == 0) {
printf("Buzzer sound success.\n");
} else {
printf("Buzzer sound failed.\n");
}
```
##### 3. 发行“客人卡”
**功能简介**：发行一张新的客人卡。
**C++原型**：
```cpp
int __stdcall WriteGuestCard(int dlsCoID, uchar CardNo, uchar Dai, uchar LLock, uchar EDate[10], uchar LockNo[9], uchar *cardHexStr);
```
**参数**：
- `dlsCoID`：酒店标识，需从发卡器读取。
- `CardNo`：卡号，每发一张卡加1。
- `Dai`：屏蔽标志，0-255滚动循环，用于屏蔽之前的卡片。
- `LLock`：反锁标志，1表示能开反锁，0表示不能开反锁。
- `EDate`：退房时间，格式为"YYMMDDHHMM"。
- `LockNo`：锁号，格式为"楼栋号楼层号房间号"。
- `cardHexStr`：返回的卡数据字符串。
**返回值**：
- `0`：表示成功。
- `1`：表示发卡器未连接。
- `-2`：表示未读到有效卡片。
**示例**：
```cpp
uchar cardHexStr[20];
if (WriteGuestCard(123, 1, 0, 1, "1403201345", "0101001", cardHexStr) == 0) {
printf("Write Guest Card Success: %s\n", cardHexStr);
} else {
printf("Write Guest Card Failed.\n");
}
```
##### 4. 读取卡片数据
**功能简介**：读取卡片上的数据。
**C++原型**：
```cpp
int __stdcall ReadCard(uchar d12, uchar *buffData);
```
**参数**：
- `d12`：保留参数。
- `buffData`：返回的卡数据字符串。
**返回值**：
- `0`：表示成功。
- 非零值：表示失败。
**示例**：
```cpp
uchar buffData[100];
if (ReadCard(0, buffData) == 0) {
printf("Read Card Data Success: %s\n", buffData);
} else {
printf("Read Card Data Failed.\n");
}
```
##### 5. 注销卡片
**功能简介**：注销一张卡片。
**C++原型**：
```cpp
int __stdcall CardErase(int dlsCoID, unsigned char *cardHexStr);
```
**参数**：
- `dlsCoID`：酒店标识。
- `cardHexStr`：返回的卡数据字符串。
**返回值**：
- `0`：表示成功。
- `1`：表示发卡器未连接。
- `-2`：表示未读到有效卡片。
**示例**：
```cpp
uchar cardHexStr[20];
if (CardErase(123, cardHexStr) == 0) {
printf("Card Erase Success: %s\n", cardHexStr);
} else {
printf("Card Erase Failed.\n");
}
```
##### 6. 读取客人卡信息
**功能简介**：读取客人卡上的信息。
**C++原型**：
```cpp
int __stdcall GetGuestCardinfo(int dlsCoID, unsigned char *cardHexStr, unsigned char *lockinfo);
```
**参数**：
- `dlsCoID`：酒店标识。
- `cardHexStr`：返回的卡数据字符串。
- `lockinfo`：返回的卡锁号信息字符串。
**返回值**：
- `0`：表示成功。
- `1`：表示发卡器未连接。
- `-2`：表示未读到有效卡片。
- `-3`：表示此卡非本酒店卡。
- `-4`：表示空白卡或已注销的卡片。
**示例**：
```cpp
uchar cardHexStr[20], lockinfo[50];
if (GetGuestCardinfo(123, cardHexStr, lockinfo) == 0) {
printf("Get Guest Card Info Success: %s, %s\n", cardHexStr, lockinfo);
} else {
printf("Get Guest Card Info Failed.\n");
}
```
### 四、总结
通过以上介绍可以看出，K9-Lock门锁接口提供了丰富的功能支持，不仅能够帮助酒店实现对客房门锁的有效管理，还能提高服务效率。开发人员在使用这些接口之前，需要仔细阅读文档并按照规定的方法正确调用，以确保系统的稳定性和安全性。
