爱迪尔门锁系统接口SDK详解

需积分: 10 23 下载量 166 浏览量 更新于2024-09-17 1 收藏 82KB DOC 举报
"爱迪尔接口文档,适用于6.51及以上版本的门锁系统,包含初始化、结束工作期、更改操作员和发行新客人卡等关键接口函数的说明。" 爱迪尔接口文档详述了与爱迪尔门锁系统交互的函数,这些函数主要在MAINDLL.DLL动态链接库中定义,适用于版本6.51及以上的门锁系统。接口设计考虑了不同类型的门锁系统、服务器配置以及发行机设备,提供了安全且高效的操作员管理及卡片发行功能。 1. **初始化(Init)**: 初始化函数`Init`是使用其他接口之前的关键步骤,它确保系统已安装并配置妥当。该函数接收以下参数: - `software`: 指定使用的门锁系统类型。 - `server`: 服务器名称,即SQL Server的安装位置。 - `username`: 操作员的用户名,用于记录操作日志。 - `port`: 通信端口,可以是USB或COMx端口。 - `Encoder`: 发行机类型,选择手动、自动或特定型号的磁卡发行机。 - `TMEncoder`: TM卡发行机类型,如DS9097E或DS9097U。 返回值是一个整数,表示操作结果,通常用于判断是否成功初始化。 2. **结束工作期(EndSession)**: `EndSession`函数用于结束与门锁系统的会话。调用此函数可清理资源,关闭连接。不接受任何参数,返回值同样是操作结果。 3. **更改操作员(ChangeUser)**: `ChangeUser`函数允许在运行时更改操作员,更新日志记录中的用户名。参数为新的用户名,无返回值,意味着操作完成后不会提供反馈。 4. **发行新客人卡(NewKey)**: `NewKey`函数用于发行新客人卡,并同时注销旧的客人卡。这确保了旧卡在新卡激活后失效,以提高安全性。参数包括: - `room`: 客人入住的房间号。 - `gate`: 授权的公共通道,可以是默认授权、全部授权或特定通道。 - `stime`: 卡片的有效起止时间,以日期和时间格式给出。 - `guestname`: 客人姓名。 - `guestid`: 客人ID。 - `overflag`: 未知标志,可能用于处理特殊情况。 - `cardno`: 新卡号,通过指针返回。 - `track1`和`track2`: 卡片的磁道数据,通常用于存储额外的信息,如持卡人的账户信息。 这些接口函数的使用是实现与爱迪尔门锁系统集成的基础,通过它们,开发人员可以创建应用程序来管理房间状态、授权访问和跟踪用户活动。每个函数的参数都经过精心设计,以适应不同场景的需求,确保了灵活性和兼容性。在实际应用中,开发者应根据具体的门锁系统配置和业务需求来调用这些接口,以实现与门锁系统的无缝集成。