### 中控B&W系列脱机通讯开发包开发手册解析
#### 一、SDK介绍与概述
**中控B&W系列脱机通讯开发包**是专为中控B&W系列考勤设备提供的软件开发工具包(SDK)。此开发包旨在帮助开发者通过一系列API接口与这些考勤设备进行通信，实现数据的读取、写入以及控制等功能。
**1. SDK介绍**
- **版本**: 6.13 (发布日期: 2009年11月)
- **版权信息**: ZKSoftware Inc. 拥有所有权利。
- **注意事项**:
- 文档中的信息如有更改，将不会特别通知。
- 开发过程中遇到的问题需要自行解决。
- 使用SDK过程中产生的任何数据损失，公司不承担责任。
- **兼容性**: 基于6.0.3.5版SDK开发。
**2. 快速开始**
- **SDK安装**: 安装过程简单明了，确保开发环境能够顺利使用。
- **常用术语介绍**:
- **AccGroup**: 用户组信息。
- **AccTimeZones**: 考勤时间段。
- **BASE64**: 数据编码方式。
- **CardNumber**: 卡号。
- **CommPort**: 通信端口。
- **ConvertBIG5**: 大五码转换。
- **PINWidth**: PIN码长度。
- **GetStrCardNumber**: 获取卡号字符串。
- **SetStrCardNumber**: 设置卡号字符串。
- **常用工作流程介绍**:
- **考勤记录下载流程**: 包括下载考勤记录的步骤。
- **操作记录下载流程**: 下载操作记录的过程。
- **门禁设置流程**: 设置门禁的相关操作。
- **下载用户信息、指纹模板、面部模板等流程**: 下载用户相关信息的过程。
- **实时事件接收流程**: 接收实时事件的通知机制。
- **联机登记流程**: 上传用户信息、指纹模板等。
- **短消息上传流程**: 上传短消息至设备。
#### 二、属性相关介绍
- **AccGroup**: 用户分组属性，用于管理和分配用户到不同的用户组。
- **AccTimeZones**: 考勤时间段配置，定义不同时间段的考勤规则。
- **BASE64**: 数据编码方式，常用于传输敏感数据时对数据进行编码。
- **CardNumber**: 卡号属性，用于唯一标识每张卡片。
- **CommPort**: 通信端口配置，指定与设备通信使用的端口号。
- **ConvertBIG5**: 字符集转换功能，支持BIG5编码的文本处理。
- **PINWidth**: PIN码长度配置，定义PIN码的位数。
- **GetStrCardNumber/SetStrCardNumber**: 卡号的获取与设置接口。
#### 三、实时事件相关
- **获取实时事件方法**:
- **RegEvent**: 注册实时事件监听器。
- **ReadRTLog/GetRTLog**: 读取或获取实时日志。
- **实时事件介绍**:
- **OnConnected**: 设备连接成功事件。
- **OnDisConnected**: 设备断开连接事件。
- **OnAlarm**: 报警事件。
- **OnDoor**: 门状态变化事件。
- **OnAttTransaction**: 考勤记录事件。
- **OnAttTransactionEx**: 扩展考勤记录事件。
- **OnDeleteTemplate**: 删除指纹模板事件。
- **OnEnrollFinger**: 登记指纹事件。
- **OnFinger**: 指纹验证事件。
- **OnFingerFeature**: 指纹特征提取事件。
- **OnHIDNum**: HID编号事件。
- **OnKeyPress**: 键盘输入事件。
- **OnNewUser**: 新用户注册事件。
- **OnVerify**: 验证事件。
- **OnWriteCard**: 写入卡片事件。
- **OnEmptyCard**: 清空卡片事件。
- **OnEMData**: EM数据事件。
#### 四、常用函数介绍
- **连接机器相关函数**:
- **Connect_Net/Connect_Com/Connect_USB**: 分别用于建立网络、串口或USB连接。
- **Disconnect**: 断开当前连接。
- **数据管理相关函数**:
- **考勤记录数据**:
- **ReadGeneralLogData/ReadAllGLogData/GetGeneralLogData/GetAllGLogData**: 用于读取或获取考勤记录。
- **GetGeneralLogDataStr/GetGeneralExtLogData**: 获取格式化后的考勤记录。
- **ClearGLog**: 清除考勤记录。
- **操作记录数据**:
- **ReadSuperLogData/ReadAllSLogData/GetSuperLogData/GetAllSLogData**: 读取或获取操作记录。
- **ClearSLog**: 清除操作记录。
- **用户信息相关**:
- **ReadAllUserID/GetAllUserID**: 读取或获取所有用户的ID。
- **GetAllUserInfo**: 获取所有用户信息。
- **EnableUser/ModifyPrivilege/SetUserInfo/GetUserInfo/SetUserInfoEx/GetUserInfoEx/DeleteUserInfoEx/GetUserInfoByPIN2/GetUserInfoByCard/GetUserIDByPIN2/GetPIN2**: 用户信息管理函数。
- **登记数据**:
- **GetFinger**: 获取指纹数据。
以上内容详细介绍了中控B&W系列脱机通讯开发包的功能、属性、实时事件以及常用函数。对于想要利用此SDK进行开发的人员来说，这些信息将是不可或缺的参考资料。
