PullSDK接口使用指南中文

1、目目 錄錄1 1 pullsdkpullsdk 接口概述接口概述 .12 2 pullsdkpullsdk 接口技術(shù)說明接口技術(shù)說明 .13 3 pullsdkpullsdk 接口安裝接口安裝 .14 4 pullsdkpullsdk 接口函數(shù)詳述接口函數(shù)詳述 .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 deletedeviced

2、ata.104.10 getrtlog.114.11 searchdevice.114.12 modifyipaddress.124.13 pulllasterror.134.14 setdevicefiledata.134.15 getdevicefiledata.145 5 附錄附錄 .155.1 附表一：接口文件的詳細說明.155.2 附表二：控制器參數(shù)的說明.165.3 附表三：controldevice參數(shù)說明.185.4 附表四：功能函數(shù)的表結(jié)構(gòu)說明.185.5 附表五：返回值錯誤碼說明.20- 1 -pullsdk 接口使用指南1 1 pullsdkpullsdk 接口概述接口概

3、述pullsdk 接口是一組功能函數(shù)，對 c3、c4 系列門禁控制器進行數(shù)據(jù)訪問的通訊接口。pullsdk 使最終應(yīng)用程序開發(fā)用戶在訪問門禁控制器時，更直觀、更方便、更簡潔，其接口完成的功能有：讀取、設(shè)置控制器參數(shù)；讀取、設(shè)置、刪除控制器的時間段、用戶信息、假日信息等數(shù)據(jù)；搜索、修改設(shè)備信息。2 2 pullsdkpullsdk 接口技術(shù)接口技術(shù)說明說明pullsdk 接口使最終應(yīng)用程序開發(fā)用戶看起來是一組對門禁控制器內(nèi)數(shù)據(jù) set/get的抽象接口，在具體訪問設(shè)備用戶數(shù)據(jù)時，類似于在使用最通用的 sql 語句。pullsdk接口在應(yīng)用程序開發(fā)用戶眼中看起來更像一個數(shù)據(jù)庫服務(wù)器。pullsdk

4、 接口支持 tcp/ip 和 rs485 通信協(xié)議。pullsdk 接口使用 c 語言開發(fā)，對數(shù)據(jù)通訊做了高度優(yōu)化，使其成為一個簡潔高效的訪問接口。pullsdk 接口在設(shè)計開始參考了 sql，但更考慮到業(yè)務(wù)中最常用的模型，是精心提煉出來的一組接口，做到了設(shè)計、實現(xiàn)、使用三方的平衡。3 3 pullsdkpullsdk 接口安裝接口安裝pullsdk 接口函數(shù)存在于文件 plcommpro.dll 中，該庫依賴于其他幾個文件，需要將下列五個 dll 文件一同拷貝到 windows 下的系統(tǒng)目錄（windows xp 下為windows/system32）- 2 -（注：每個文件功能描述見附表一

5、） 。4 4 pullsdkpullsdk 接口函數(shù)詳述接口函數(shù)詳述4.1 connect函數(shù)int connect(const char *parameters)功能連接設(shè)備，連接成功后返回連接句柄。參數(shù)說明parameters:in 通過 parameter 參數(shù)指定連接選項，如下列例子：protocol=rs485,port=com2,baudrate=38400bps,deviceid=1,timeout=50000, passwd=”;“protocol=tcp,ipaddress=192.168.12.154,port=4370,timeout=4000,passwd=”;需要向該

6、函數(shù)傳遞與設(shè)備相關(guān)的連接參數(shù)方可實現(xiàn)連接功能。protocol 是通訊使用的協(xié)議，目前有 rs485 和 tcp 兩種方式；port：設(shè)備通訊端口。例如，以 rs485 方式連接，可設(shè)置 port 為 com1；以 tcp 通訊的端口，如果不特別強調(diào)，port 默認為 4370；deviceid：串口使用的設(shè)備 id 號；baudrate：串口通訊使用的波特率；ipaddress：tcp/ip 通訊相關(guān)設(shè)備的 ip 地址；timeout：連接超時時間，單位為毫秒。遇到網(wǎng)絡(luò)連接質(zhì)量不好時，應(yīng)加大 timeout 的值。一般的， “timeout=5000” （5 秒）可以滿足基本網(wǎng)絡(luò)使用；當查詢

7、數(shù)據(jù)經(jīng)常出現(xiàn)-2 錯誤碼時，應(yīng)加大 timeout 的值，可以設(shè)置：“timeout=20000” （20 秒） 。passwd：設(shè)置通訊的連接密碼，可以為空表示不使用密碼。- 3 -（注：parameters 連接字符串大小寫敏感）返回值與設(shè)備連接成功后返回該連接句柄，否則連接失敗返回 0。示例python：params = “protocol=tcp,ipaddress=192.168.12.154,port=4370,timeout=4000,passwd=”mpro = windll.loadlibrary(plcommpro.dll)con_str = create_string_b

8、uffer(params)self.hcommpro = mpro.connect(con_str)c#：params = “protocol=tcp,ipaddress=192.168.12.154,port=4370,timeout=2000,passwd=” ;intptr h = connect(params);4.2 disconnect函數(shù)void disconnect(handle handle)功能斷開與設(shè)備的連接參數(shù)說明handlein 由 connect()成功返回的句柄。返回值無示例python：mpro.disconnect(self.hcommpro)self.hco

9、mmpro = 0c#：disconnect(h);- 4 -h = intptr.zero;4.3 setdeviceparam函數(shù)int setdeviceparam(handle handle, const char *itemvalues)功能設(shè)置控制器參數(shù)，例如設(shè)備號、門磁類型、鎖驅(qū)動時間、讀卡間隔等。參數(shù)說明handlein 由 connect()成功返回的句柄。itemvaluesin 將要設(shè)置的設(shè)備參數(shù)值，多個參數(shù)值之間可以用逗號分開，一次至多可同時設(shè)置 20 個參數(shù)（可設(shè)置的參數(shù)值屬性請參見表二） 。返回值返回為 0 或者正數(shù)時，表示成功；返回負數(shù)時為錯誤，錯誤代碼的信息請參

10、見附表五。 示例python：items = (deviceid=1,door1sensortype=2,door1drivertime=6,door1intertime=3)p_items = create_string_buffer(items)ret = mpro.setdeviceparam(self.hcommpro, p_items)c#：int ret = 0;items = (deviceid=1,door1sensortype=2,door1drivertime=6,door1intertime=3)ret = setdeviceparam(h, items);4.4 get

11、deviceparam函數(shù)- 5 -int getdeviceparam(handle handle, char *buffer, int buffersize, const char *items)功能讀取控制器參數(shù)，例如設(shè)備號、門磁類型、鎖驅(qū)動時間、讀卡間隔等。參數(shù)說明handlehandlein 由 connect()成功返回的句柄。bufferbufferin 用于接收返回數(shù)據(jù)的緩沖區(qū)，返回的數(shù)據(jù)是文本格式的，可能是多個參數(shù)值，各參數(shù)之間用逗號分隔。buffersizebuffersizein用于接收返回數(shù)據(jù)的緩沖區(qū)大小。itemsitemsin 將要讀取的設(shè)備參數(shù)名稱表，多個名稱之間

12、可以用逗號分開，一次至多可同時讀取 20 個參數(shù)（可設(shè)置的參數(shù)值屬性請參見表一） 。返回值返回為 0 或者正數(shù)時，表示操作成功；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。 示例python：buffer = create_string_buffer(2048)items = (deviceid,door1sensortype,door1drivertime,door1intertime)p_items = create_string_buffer(items)ret = mpro.getdeviceparam(self.hcommpro, buffer, 256, p_items)c#：i

13、nt ret = 0;int buffersize = 10 * 1024 * 1024;byte buffer = new bytebuffersize;items = (deviceid,door1sensortype,door1drivertime,door1intertime);ret = getdeviceparam(h, ref buffer 0, buffersize, items);- 6 -4.5 controldevice函數(shù)int controldevice(handle handle, long operationid, long param1, long param2

14、, long param3, long param4, const char *options)功能控制控制器動作。參數(shù)說明handlehandlein 由 connect()成功返回的句柄；operationidoperationidin 操作內(nèi)容，1 表示輸出操作，2 表示取消報警，3 表示重啟設(shè)備；param1param1in 當 operationid 為輸出操作時，此參數(shù)表示設(shè)備中門的 id 號，詳細請參見附表三；當 operationid 為取消報警時，默認值為 0；當 operationid 為重啟設(shè)備時，默認值為 0；param2param2in 當 operationid 為

15、輸出操作時，此參數(shù)表示設(shè)備輸出點地址，詳細請參見附表三；當 operationid 為取消報警時，默認值為 0；當 operationid 為重啟設(shè)備時，默認值為 0；param3param3in當 operationid 為輸出操作時，此參數(shù)表示開門時間（0 表示關(guān)，255 表示常開，取值范圍為 160（秒） ） ，默認值為 0；當 operationid 為重啟設(shè)備時，默認值為 0；param4param4in 預(yù)留之用，默認為 0；optionoptionin 默認為空，擴展之用；返回值返回為 0 或者正數(shù)時，表示成功；返回負數(shù)時表示失敗，錯誤代碼的信息請參見附表五。- 7 - 示例py

16、thon：operation_id = 1door_id = 1index = 2state = 6ret = mpro.controldevice(self.hcommpro, operation_id, door_id, index, state, 0, )c#：int ret = 0;int operid = 1;int doorid = 0;int outputadr = 0;int doorstate = 8;ret = controldevice(h, operid, doorid, outputadr, doorstate, 0, );4.6 setdevicedata函數(shù)int

17、 setdevicedata(handle handle,const char *tablename,const char *data，const char *options) 功能設(shè)置數(shù)據(jù)到設(shè)備,用于設(shè)置時間段、用戶信息、假日設(shè)置、等數(shù)據(jù)，數(shù)據(jù)可以是一條記錄，也可以是多條記錄。參數(shù)說明handlehandlein 由 connect()成功返回的句柄；tablenametablenamein 數(shù)據(jù)表名，目前可使用表請參見附表四datadatain 數(shù)據(jù)記錄表示，數(shù)據(jù)是文本格式的，多條記錄之間用rn 分隔，各個“字段=值”對之間用t 分隔；optionsoptions- 8 -in 默認為空，

18、擴展之用； 返回值返回為 0 或者正數(shù)時，表示操作成功；返回負數(shù)時表示失敗，錯誤代碼的信息請參見附表五。 示例python：table = user# 用戶信息表data = pin=19999tcardno=13375401tpassword=1rnpin=2tcardno=14128058tpassword=1p_table = create_string_buffer(table)str_buf = create_string_buffer(data)ret = mpro.setdevicedata(self.hcommpro, p_table, str_buf, )# 向用戶信息表上傳

19、str_buff 數(shù)據(jù)c#：int ret = 0;string devtablename = user;string data = pin=19999tcardno=13375401tpassword=1rnpin=2tcardno=14128058tpassword=1;string options = ;ret = setdevicedata(h, devtablename, data, options);4.7 getdevicedata函數(shù)int getdevicedata(handle handle, char *buffer, int buffersize, const char

20、 *tablename, const char *fieldnames,const char *filter, const char *options)功能從設(shè)備讀取數(shù)據(jù),用于讀取刷卡記錄、時間段、用戶信息、假日設(shè)置、等數(shù)據(jù)，數(shù)據(jù)可以是一條記錄，也可以是多條記錄。參數(shù)說明handlehandlein 由 connect()成功返回的句柄；bufferbufferin 用于接收返回數(shù)據(jù)的緩沖區(qū)，返回的數(shù)據(jù)是文本格式的，可能是多條記錄，- 9 -各條記錄之間用rn 分隔。buffersizebuffersizein用于接收返回數(shù)據(jù)的緩沖區(qū)大小。tablenametablenamein 數(shù)據(jù)表名，目

21、前可用的表名參見附表四；fieldnamesfieldnamesin 字段名列表，多個字段之間用分號分開， “*”表示全部字段，此時返回數(shù)據(jù)字段的第一行是字段名filterfilterin 讀取數(shù)據(jù)的條件，當單獨一個“字段名 操作符 值”構(gòu)成的字符串時，可以支持多個條件，使用逗號分隔，按如下方式：=（“=”符號兩邊不可以有空格）optionsoptionsin 僅用于下載門禁事件記錄，值為“newrecord”時下載新記錄，當為空時下載全部記錄返回值返回為 0 或者正數(shù)時，表示操作成功，其值為記錄條數(shù)；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。 示例python:table = ”user

22、”# 從 user 表下載用戶數(shù)據(jù)fielname = *# 下載表中的所用字段信息pfilter = ”# 沒有過濾條件，全部下載options = ”query_buf = create_string_buffer(4*1024*1024)query_table = create_string_buffer(table)query_fieldname = create_string_buffer(fieldname)query_filter = create_string_buffer(filter)query_options = create_string_buffer(options)

23、ret = mpro.getdevicedata(self.hcommpro, query_buf, 4*1024*1024, query_table, query_fieldname, query_filter, query_options)c#：int ret = 0;int buffersize = 10 * 1024 * 1024;- 10 -byte buffer = new bytebuffersize;string devtablename = user;string str = *;string devdatfilter = ;string options = ;ret = g

24、etdevicedata(h, ref buffer0, buffersize, devtablename, str, devdatfilter, options);4.8 getdevicedatacount函數(shù)int getdevicedatacount(void *handle, const char *tablename, const char *filter,const char *options)功能讀取設(shè)備中的記錄總數(shù)信息，返回指定數(shù)據(jù)的記錄條數(shù)。參數(shù)說明handlehandlein 由 connect()成功返回的句柄；tablenametablenamein 數(shù)據(jù)表名，目前可

25、用的表名參見附表四filterfilterin 默認為空，擴展之用；optionsoptionsin 默認為空，擴展之用；返回值返回為 0 或者正數(shù)時，表示操作成功，其值為記錄條數(shù)；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。示例python：table = userfilter = p_table = create_string_buffer(table)p_filter = create_string_buffer(filter)- 11 -ret = mpro.getdevicedatacount(self.hcommpro, p_table, p_filter,)c#：int ret

26、 = 0;string devtablename = user;string devdatfilter = ;string options = ;ret = getdevicedatacount(h, devtablename, devdatfilter, options);4.9 deletedevicedata函數(shù)int deletedevicedata(handle handle, const char *tablename,const char *data,const char *options)功能刪除設(shè)備中的數(shù)據(jù)，例如用戶信息、時間段等數(shù)據(jù)。參數(shù)說明handlehandlein 由

27、 connect()成功返回的句柄；tablenametablenamein 數(shù)據(jù)表名，目前可用的表名參見附表四。datadatain 數(shù)據(jù)記錄表示，數(shù)據(jù)是文本格式的，可以多條記錄之間用rn 分隔，各個“字段=值”對之間用t 分隔；optionsoptionsin 默認為空，擴展之用；返回值返回為 0 或者正數(shù)時，表示成功；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。示例python：table = “user”- 12 -data = pin=2# 刪除數(shù)據(jù)的條件p_table = create_string_buffer(table)p_data = create_string_buff

28、er(data)ret = mpro.deletedevicedata(self.hcommpro, p_table, p_data, )c#：int ret = 0;string devtablename = user;string data = pin=2;string options = ;ret = deletedevicedata(h, devtablename, data, options);4.10 getrtlog函數(shù)int getrtlog(handle handle,char *buffer, int buffersize)功能實時獲取設(shè)備事件記錄。參數(shù)說明handleha

29、ndlein 由 connect()成功返回的句柄。bufferbufferin 用于接收返回數(shù)據(jù)的緩沖區(qū)，返回的數(shù)據(jù)是文本格式的。buffersizebuffersizein 用于接收返回數(shù)據(jù)的緩沖區(qū)大小。返回值返回為 0 或者正數(shù)時，為接收數(shù)據(jù)的記錄數(shù)；返回負數(shù)時為失敗，錯誤代表的信息請參見附表五。示例python：rt_log = create_string_buffer(256)ret = mpro.getrtlog(self.hcommpro, rt_log, 256)- 13 -c#：int ret = 0;int buffersize = 256;byte buffer = ne

30、w byte256;ret = getrtlog(h, ref buffer0, buffersize);4.11 searchdevice函數(shù)int searchdevice(char *commtype,char *address, char *buffer)功能搜索局域網(wǎng)內(nèi)的門禁控制器。參數(shù)說明commtypecommtypein 通訊類型為 “ethernet” ，將會搜索指定通訊類型的設(shè)備；addressaddressin 廣播地址，將會搜索指定 ip 地址范圍內(nèi)局域網(wǎng)的設(shè)備，默認為255.255.255.255；bufferbufferin 用于存儲搜索到的設(shè)備的緩沖區(qū)，用戶應(yīng)根據(jù)

31、網(wǎng)內(nèi)設(shè)備數(shù)量來確定申請內(nèi)存值。例如 50 臺設(shè)備以內(nèi)建議申請 32k 的內(nèi)存，100 臺設(shè)備以內(nèi)建議申請 64k 的內(nèi)存大小。返回值返回為 0 或者正數(shù)時，為搜索到的門禁控制器數(shù)量；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。示例python：dev_buf = create_string_buffer(, 64*1024)ret=mpro.searchdevice(udp, 255.255.255.255, dev_buf)c#：- 14 -int ret = 0;string udp = udp;string adr = 255.255.255.255;byte buffer = new

32、 byte64 * 1024;ret = searchdevice(udp,adr, ref buffer0);4.12 modifyipaddress函數(shù)int modifyipaddress(char *commtype,char *address, char *buffer)功能udp 廣播方式修改控制器 ip 地址。參數(shù)說明commtypecommtypein 搜索設(shè)備的通訊類型為“ethernet”通訊的設(shè)備；addressaddressin 廣播地址，默認為 255.255.255.255；bufferbufferin 用于存儲目標設(shè)備的 mac 地址和新 ip 地址；返回值返回為

33、 0 或者正數(shù)時，為接收數(shù)據(jù)的記錄數(shù)；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。示例python：mac = 00:17:61:01:88:27# 目標設(shè)備的mac地址new_ip = 192.168.12.156# 設(shè)備新的ip地址comm_pwd = str = mac=%s,ipaddress=%s % (mac,new_ip)p_buf = create_string_buffer(str)modify_ip = mpro.modifyipaddress(“udp”, “255.255.255.255”, p_buf)c#：int ret = 0;string udp = udp;

34、- 15 -string address = 255.255.255.255;string buffer = mac=00:17:61:01:88:27 + , + ipaddress=192.168.12.156;ret = modifyipaddress(udp,address,buffer);4.13 pulllasterror函數(shù)int pulllasterror()功能獲取錯誤 id， 返回失敗時可通過個函數(shù)獲取失敗 id。參數(shù)說明無返回值返回錯誤 id 號。示例python：ret = mpro.pulllasterror()c#：int ret = 0;ret = pulllas

35、terror();4.14 setdevicefiledata函數(shù)int setdevicefiledata(void *handle, const char *filename, char *buffer,int buffersize,const char *options)功能將文件從 pc 傳送到設(shè)備。參數(shù)說明handlehandle- 16 -in 由 connect()成功返回的句柄；filenamefilenamein 傳送到設(shè)備的文件名,例如 main 文件；bufferbufferin 待傳送文件的數(shù)據(jù)緩沖區(qū)；buffersizebuffersizein傳送數(shù)據(jù)的長度；opti

36、onsoptionsin 默認為空，擴展之用返回值返回為 0 或者正數(shù)時，表示成功；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。示例python：file_name = ”main”buff_len = len(file_main)pfile_name = create_string_buffer(file_name)pbuffer = create_string_buffer(buff_len)ret = mpro.setdevicefiledata(self.hcommpro, pfile_name, pbuffer, buff_len, )c#：int ret = 0;string f

37、ilename = user.dat;filestream fsfile = file.openread(this.openfiledialog1.filename);string buffersize = (int)fsfile.length;byte buffer = new bytebuffersize;string options = ;ret = setdevicefiledata(h, filename, ref buffer0, buffersize, options);4.15 getdevicefiledata函數(shù)int getdevicefiledata(void *han

38、dle,char *buffer,int *buffersize,const char *filename,const char *options)- 17 -功能從設(shè)備獲取文件到 pc。參數(shù)說明handlehandlein 由 connect()成功返回的句柄；filenamefilenamein 從設(shè)備獲取的文件名,例如 main 文件；bufferbufferin 接收數(shù)據(jù)的緩沖區(qū)；buffersizebuffersizein 接收數(shù)據(jù)的長度；optionsoptionsin 默認為空，擴展之用返回值返回為 0 或者正數(shù)時，表示成功；返回負數(shù)時為失敗，錯誤代碼的信息請參見附表五。示例py

39、thon：file_name = ”main”pfile_name = create_string_buffer(file_name)pbuffer = create_string_buffer(4*1024*1024)ret = mpro.getdevicefiledata(self.hcommpro, pbuffer, buff_len, pfile_name, )c#：int ret = 0;int buffersize = 4 * 1024 * 1024;byte buffer = new bytebuffersize;string filename = user.dat;string

40、 options = ;ret = getdevicefiledata(h, ref buffer0, ref buffersize, filename, options);- 18 -5 5 附錄附錄5.1 附表一：接口文件的詳細說明附表一：接口文件的詳細說明文件名說明plcommpro.dllpullsdk 函數(shù)的動態(tài)連接庫接口plcomms.dllpullsdk接口的依賴庫plrscomm.dllpullsdk接口的依賴庫pltcpcomm.dllpullsdk接口的依賴庫rscagent.dllpullsdk接口的依賴庫5.2 附表二：控制器參數(shù)的說明附表二：控制器參數(shù)的說明屬性名稱參

41、數(shù)讀寫類型備注門數(shù)量lockcount只讀讀頭數(shù)量readercount只讀自定義輸入數(shù)量auxincount只讀自定義輸出數(shù)量auxoutcount只讀通信密碼compwd讀寫默認沒有ip 地址ipaddress讀寫默認：192.168.1.201網(wǎng)關(guān)gateipaddress讀寫沒有設(shè)置時為 ip 地址的值子網(wǎng)掩碼netmask讀寫默認 255.255.255.0反潛回規(guī)則（設(shè)為反潛的門 1 和門 2，需要有門 1 開門記錄才能在門 2 上開門，反之沒有在門2 上開門，不能在門1 上連續(xù)開兩次門）antipassback讀寫單門雙向控制器1 代表1 號門讀頭間反潛雙門單向控制器1 代表1,

42、2 號門間反潛雙門雙向控制器1 代表1 號門讀頭間反潛2 代表2 號門讀頭間反潛3 代表1,2 號門各自讀頭間反潛4 代表1,2 號門間反潛四門單向控制器1 代表1-2 門反潛- 19 -2 代表3-4 門反潛3 代表1-2 門反潛和3-4 門反潛4 代表1/2-3/4 門反潛5 代表1-2/3 門反潛6 代表1-2/3/4 門反潛互鎖（設(shè)為互鎖的門 1 和門 2，門 1 在開啟時，門 2 只能處于關(guān)閉狀態(tài)；反之門 2 被打開時，門 1 不能被打開）interlock讀寫兩門控制器1 代表1-2 兩門互鎖四門控制器1 代表1-2 兩門互鎖2 代表3-4 兩門互鎖3 代表1-2-3 三門互鎖4

43、代表1-2 兩門互鎖和3-4 兩門互鎖5 代表1-2-3-4 四門互鎖脅迫密碼door1forcepassworddoor2forcepassworddoor3forcepassworddoor4forcepassword讀寫最大 8 位緊急密碼door1supperpassworddoor2supperpassworddoor3supperpassworddoor4supperpassword讀寫最大 8 位閉門回鎖door1closeandlockdoor2closeandlockdoor3closeandlockdoor4closeandlock讀寫1 啟用0 不啟用門磁類型door1s

44、ensortypedoor2sensortypedoor3sensortypedoor4sensortype讀寫0 代表無1 代表常開2 代表常閉鎖驅(qū)動時長door1drivertimedoor2drivertimedoor3drivertimedoor4drivertime讀寫設(shè)置范圍（0255）0 代表常閉255 代表常開1254 代表開門時長門磁超時報警時長door1detectortimedoor2detectortimedoor3detectortimedoor4detectortime讀寫設(shè)置范圍（0255）單位為秒（s）開門方式door1verifytypedoor2verify

45、typedoor3verifytypedoor4verifytype讀寫0 為“卡”11 為“卡+密碼”- 20 -多卡開門啟用（可使用多個人同時驗證通過才能開門，在附表四 多卡開多卡開門組合表門組合表中設(shè)置多卡開門的組號，在該組里面的人員就是多人驗證的人員，最多只能設(shè)置五人同時驗證開門。）door1multicardopendoordoor2multicardopendoordoor3multicardopendoordoor4multicardopendoor讀寫0 不啟用 1 啟用首卡開門啟用door1firstcardopendoordoor2firstcardopendoordoor

46、3firstcardopendoordoor4firstcardopendoor讀寫0:不啟用 1.首卡常開 門激活時間段(接收有效刷卡時間段)door1validtzdoor2validtzdoor3validtzdoor4validtz讀寫默認 0 表示鎖未激活門常開時間段door1keepopentimezonedoor2keepopentimezonedoor3keepopentimezonedoor4keepopentimezone讀寫默認 0，沒有設(shè)置刷卡間隔door1intertimedoor2intertimedoor3intertimedoor4intertime讀寫0 為無

47、間隔 以 s（秒）為單位mcu 看門狗watchdog讀寫0 不啟用 1 啟用四門轉(zhuǎn)兩門door4todoor2讀寫0 不啟用 1 啟用取消門常開日期door1cancelkeepopendaydoor2cancelkeepopendaydoor3cancelkeepopendaydoor4cancelkeepopenday只讀取消常開時保存的日期sd 卡備份時間backuptime讀寫124，設(shè)置為整點 重啟設(shè)備reboot僅寫reboot=1同步時間datetime僅寫datetime= (年-2000)*12*31 + (月-1)*31 + (日-1)* 24*60*60) + 小時*

48、60*60 + 分鐘* 60 + 秒；例如：系統(tǒng)當前時間為- 21 -2010-10-26 20:54:55，那么datetime= 347748895；四門轉(zhuǎn)兩門door4todoor2讀寫0 不啟用 1 啟用單/雙向讀頭inbiotowway 讀寫0 為單向1 為雙向5.3 附表三：附表三：controldevice 參數(shù)說明參數(shù)說明 operationid說明param1param2param3param4options1輸出操作門編號輸出地址開或關(guān)動作保留擴展參數(shù)為空2取消報警3重啟設(shè)備5.4 附表四：功能函數(shù)的表結(jié)構(gòu)說明附表四：功能函數(shù)的表結(jié)構(gòu)說明表名稱tablename字段備注卡號

49、信息表usercardno、pin、password、group、starttime、endtimestarttime 和 endtime 格式填寫規(guī)范: yyyymmdd， 例如: 20100823；group 是多卡開門人員組；pin 授權(quán)表userauthorizepin、authorizetimezoneid、authorizedooridauthorizedoorid 是授權(quán)的門：1 代表 lock1；2 代表 lock2；3 代表 lock1 和 lock2；4 代表 lock3；5 代表 lock1 和 lock3；6 代表 lock2 和 lock3；7 代表 lock1、lo

50、ck2 和 lock3；8 代表 lock4；- 22 -9 代表 lock1 和 lock4；10 代表 lock2 和 lock4；11 代表 lock1、lock2 和 lock4；12 代表 lock3 和 lock4；13 代表 lock1、lock3 和 lock4；14 代表 lock2、lock3 和 lock4；15 代表 lock1、lock2、lock3 和lock4假日表holidayholiday、holidaytype、loop假日類型“holidaytype”的值：1、2、3loop 的值：1-按年循環(huán)；2-不按年循環(huán)時區(qū)表timezonetimezoneid、s

51、untime1、suntime2、suntime3、montime1、montime2、montime3、tuetime1、tuetime2、tuetime3、wedtime1、wedtime2、wedtime3、thutime1、thutime2、thutime3、fritime1、fritime2、fritime3、sattime1、sattime2、sattime3、hol1time1、hol1time2、hol1time3、hol2time1、hol2time2、hol2time3、hol3time1、hol3time2、hol3time3time 格式(hour*100 + minute ) 16+(hour*100 + minute)例如：設(shè)置周一時間段 1 為8:30 12:30 ，那么montime1=54396110；8:30 8*100+30 33e (十六進制)12:30 12*100+30 4ce (十六進制)033e04ce 54396110 (十進制)門禁記錄表transactioncardno、pin、verified、doorid、eventtype、inoutstate、time_second