4PullSDK接口函数详述.DOC

PullSDK接口使用指南 版本：2.0 日期：2011年12月 内容介绍 本文档主要介绍了PullSDK接口的概述和技术说明。目录 1. PullSDK接口概述 1 2. PullSDK接口技术说明 1 3. PullSDK接口安装 1 4. PullSDK接口函数详述 2 4.1 Connect 2 4.2 Disconnect 3 4.3 SetDeviceParam 3 4.4 GetDeviceParam 4 4.5 ControlDevice 5 4.6 SetDeviceData 6 4.7 GetDeviceData 7 4.8 GetDeviceDataCount 8 4.9 DeleteDeviceData 9 4.10 GetRTLog 10 4.11 SearchDevice 11 4.12 ModifyIPAddress 12 4.13 PullLastError 13 4.14 SetDeviceFileData 14 4.15 GetDeviceFileData 15 4.16 ProcessBackupData 16 5. 附录 17 5.1 附表一：接口文件的详细说明 17 5.2 附表二：控制器参数的说明 18 5.3 附表三：ControlDevice参数说明 21 5.4 附表四：功能函数的表结构说明 22 5.5 附表五：返回值错误码说明 25 5.6 附表六：事件类型及代码表 27 5.7 附表七：GetRTLog函数中参数Buffer返回数据格式说明 30 1. PullSDK接口概述 PullSDK接口是一组功能函数，对C3、inBIO系列门禁控制器进行数据访问的通讯接口。PullSDK使最终应用程序开发用户在访问门禁控制器时，更直观、更方便、更简洁，其接口完成的功能有： 读取、设置控制器参数； 读取、设置、删除控制器的时间段、用户信息、假日信息、指纹等数据； 有哪些信誉好的足球投注网站在线设备、修改设备IPAddress； 解析固件备份在SD卡里的文件。 2. PullSDK接口技术说明 PullSDK接口使最终应用程序开发用户看起来是一组对门禁控制器内数据Set/Get的抽象接口，在具体访问设备用户数据时，类似于在使用最通用的SQL语句。PullSDK接口在应用程序开发用户眼中看起来更像一个数据库服务器。 PullSDK接口支持TCP/IP和RS485通信协议，并支持UDP广播方式有哪些信誉好的足球投注网站门禁控制器及修改门禁控制器的IP地址、子网掩码、网关。 PullSDK接口使用C语言开发，对数据通讯做了高度优化，使其成为一个简洁高效的访问接口。 PullSDK接口在设计开始参考了SQL，但更考虑到业务中最常用的模型，是精心提炼出来的一组接口，做到了设计、实现、使用三方的平衡。 3. PullSDK接口安装 PullSDK接口函数存在于文件plcommpro.dll中，该库依赖于其他几个文件，需要将下列五个DLL文件一同拷贝到windows下的系统目录（32位操作系统下为windows/system32，64位操作系统下为windows/ syswow64）。文件拷贝完毕后，无需进行注册，直接按照下述接口函数使用即可。 （注：每个文件功能描述见附表一） 4. PullSDK接口函数详述 4.1 Connect [函数] int Connect(const char *Parameters) [功能] 连接设备，连接成功后返回连接句柄。 [参数说明] Parameters: [in] 通过Parameter参数指定连接选项，如下列例子： protocol=RS485,port=COM2,baudrate=38400bps,deviceid=1,timeout=50000, passwd=”; “protocol=TCP,ipaddress=54,port=4370,timeout=4000,passwd=”; 需要向该函数传递与设备相关的连接参数方可实现连接功能。 protocol是通讯使用的协议，目前有RS485和TCP两种方式； port：设备通讯端口。例如，以RS485方式连接，可设置port为COM1；以TCP通讯的端口，如果不特别强调，port默认为4370； deviceid：串口使用的设备RS485通讯地址； baudrate：串口通讯使用的波特率； ipaddress：TCP/IP通讯相关设备的IP地址； timeout：连接超时时间，单位为毫秒。遇到网络连接质量不好时，应加大timeout的值。一般的，“timeout=5000”（5秒）可以满足基本网络使用；当查询数据经常出现-2错误码时，应加大timeout的值，可以设置：“timeout=20000”（20秒）