PullSDK接口使用指南_中文.doc

目 录1 PULLSDK 接口概述 ................................................................................................................................12 PULLSDK 接口技术说明 ........................................................................................................................13 PULLSDK 接口安装 ................................................................................................................................14 PULLSDK 接口函数详述 ........................................................................................................................24.1 CONNECT .......................................................................................................................................24.2 DISCONNECT ..................................................................................................................................34.3 SETDEVICEPARAM.........................................................................................................................44.4 GETDEVICEPARAM ........................................................................................................................44.5 CONTROLDEVICE ...........................................................................................................................54.6 SETDEVICEDATA ...........................................................................................................................64.7 GETDEVICEDATA ..........................................................................................................................74.8 GETDEVICEDATACOUNT...............................................................................................................94.9 DELETEDEVICEDATA...................................................................................................................104.10 GETRTLOG ................................................................................................................................114.11 SEARCHDEVICE..........................................................................................................................114.12 MODIFYIPADDRESS ...................................................................................................................124.13 PULLLASTERROR .......................................................................................................................134.14 SETDEVICEFILEDATA................................................................................................................134.15 GETDEVICEFILEDATA ...............................................................................................................145 附录 .....................................................................................................................................................155.1 附表一：接口文件的详细说明 .................................................................................................155.2 附表二：控制器参数的说明 .....................................................................................................165.3 附表三：CONTROLDEVICE 参数说明 ........................................................................................185.4 附表四：功能函数的表结构说明 .............................................................................................185.5 附表五：返回值错误码说明 .....................................................................................................20- 1 -PullSDK 接口使用指南1 PullSDK 接口概述PullSDK 接口是一组功能函数，对 C3、C4 系列门禁控制器进行数据访问的通讯接口。

PullSDK 使最终应用程序开发用户在访问门禁控制器时，更直观、更方便、更简洁，其接口完成的功能有：读取、设置控制器参数；读取、设置、删除控制器的时间段、用户信息、假日信息等数据；搜索、修改设备信息2 PullSDK 接口技术说明PullSDK 接口使最终应用程序开发用户看起来是一组对门禁控制器内数据 Set/Get的抽象接口，在具体访问设备用户数据时，类似于在使用最通用的 SQL 语句PullSDK接口在应用程序开发用户眼中看起来更像一个数据库服务器PullSDK 接口支持 TCP/IP 和 RS485 通信协议PullSDK 接口使用 C 语言开发，对数据通讯做了高度优化，使其成为一个简洁高效的访问接口PullSDK 接口在设计开始参考了 SQL，但更考虑到业务中最常用的模型，是精心提炼出来的一组接口，做到了设计、实现、使用三方的平衡3 PullSDK 接口安装PullSDK 接口函数存在于文件 plcommpro.dll 中，该库依赖于其他几个文件，需要将下列五个 DLL 文件一同拷贝到 windows 下的系统目录（windows XP 下为windows/system32）- 2 -（注：每个文件功能描述见附表一） 。

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=192.168.12.154,port=4370,timeout=4000,passwd=”;需要向该函数传递与设备相关的连接参数方可实现连接功能protocol 是通讯使用的协议，目前有 RS485 和 TCP 两种方式；port：设备通讯端口例如，以 RS485 方式连接，可设置 port 为 COM1；以 TCP 通讯的端口，如果不特别强调，port 默认为 4370；deviceid：串口使用的设备 ID 号；baudrate：串口通讯使用的波特率；ipaddress：TCP/IP 通讯相关设备的 IP 地址；timeout：连接超时时间，单位为毫秒。

遇到网络连接质量不好时，应加大 timeout 的值一般的， “timeout=5000”（5 秒）可以满足基本网络使用；当查询数据经常出现-2 错误码时，应加大 timeout 的值，可以设置：“timeout=20000” （20 秒） passwd：设置通讯的连接密码，可以为空表示不使用密码 3 -（注：Parameters 连接字符串大小写敏感）[返回值]与设备连接成功后返回该连接句柄，否则连接失败返回 0[示例]Python：params = “protocol=TCP,ipaddress=192.168.12.154,port=4370,timeout=4000,passwd=”mpro = windll.LoadLibrary("plcommpro.dll")con_str = create_string_buffer(params)self.hcommpro = 。