大華門禁SDK二次開發(一)-技術溝通


項目中需要能夠查詢門禁信號和控制門禁設備,因此需要基於大華門禁SDK進行二次開發,開發語言C#。門禁開發中遇到了一些問題,經過與大華技術的郵件溝通也一一解決。做這個開發的時候,發現網上的資料比較少,想着把自己遇到的問題整理下來,讓有需要的人盡量少走一些彎路。

1. 門禁狀態查詢/控制API

  • 門禁控制API
BOOL CLIENT_ControlDevice(
  LLONG                                   lLoginID ,
  CtrlType                                type ,
  void                                    *param ,
  int                                     waittime = 1000
);
  • 門禁查詢API
BOOL CLIENT_QueryDevState(
  LLONG  lLoginID,
  int    nType,
  char   *pBuf,
  int    nBufLen,
  int    *pRetLen,
  int    waittime=1000 
);


nType `NET_DOOR_STATUS_INFO`


//門禁狀態信息
struct NET_DOOR_STATUS_INFO{
DWORD                         dwSize;
int                           nChannel;
EM_NET_DOOR_STATUS_TYPE       emStateType;
};


//門禁狀態類型
typedef enum __EM_NET_DOOR_STATUS_TYPE{ 
  EM_NET_DOOR_STATUS_UNKNOWN,                  
  EM_NET_DOOR_STATUS_OPEN,                     // 打開
  EM_NET_DOOR_STATUS_CLOSE,                    // 關閉
  EM_NET_DOOR_STATUS_BREAK,                    // 門異常打開};

2. 郵件列表

2.1 基於官網SDK開發

從大華官網下載SDK開發包,找到上面的兩個接口后,就開始操刀基於官方C# demo開發。設備登陸代碼是官方demo提供的,但是門禁設備狀態查詢總是返回false。跟大華技術支持聯系后,提供了新的門禁開發demo。

發件人: DK
發送時間: 2017年9月27日 9:51
收件人: 大華SDK支持
主題: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

 

大華大神你好,

我是項目名稱平台開發人員,在進行門禁調試時遇到下面的問題,煩請幫忙診斷一下:

1、C#引入接口

[DllImport("dhnetsdk.dll")]
public static extern bool CLIENT_QueryDevState(IntPtr lLoginID,int nType,IntPtr pBuf,int nBufLen,ref int pRetLen,int waittime);

2、C#調用

public static bool QueryDevState(IntPtr lLoginID,ref NET_DOOR_STATUS_INFO statusInfo)
        {
            var pRetLen = 0;
            var nBufLen = Marshal.SizeOf(typeof(NET_DOOR_STATUS_INFO));

            IntPtr pBuf = IntPtr.Zero;
            pBuf = Marshal.AllocHGlobal(nBufLen);
            Marshal.StructureToPtr(statusInfo, pBuf, true);

            var result = OriginalSDK.CLIENT_QueryDevState(lLoginID, 0x0159, pBuf, nBufLen, ref pRetLen,1000);
            NetGetLastError(result);
            return result;
        }

3、調用結果:

result = false

error是一個不存在的錯誤編碼,一個很大的負數

 

**科技集團股份有限公司

            我打農村來

      187********

       2017-09-27

============================================================================================       
       
發件人: 大華SDK支持

發送時間: 2017年9月27日(星期三) 上午10:12

收件人: DK

主題: 答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

 

請參照附件Demo進行門禁開發、封裝引用。

有問題反饋

設備上下文環境:設備型號、固件版本

問題描述:截圖、操作步驟

 

我們再分析下。

附件Demo

2.2 基於新的門禁demo

這次跟上次出現的問題差不多,也是登陸正常,但是狀態查詢異常,這次又提供了新的門禁開發demo。

發件人: DK
發送時間: 2017年9月27日 15:11
收件人: 大華SDK支持
主題: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

 

     

      你好,下午調試了一下,有問題,詳細錯誤見附件,你幫忙看一下。

十分感謝。

 

------------------

**科技集團股份有限公司

            我打農村來

      187********

       2017-09-27
       
============================================================================================ 

發件人:大華SDK支持

發送時間:2017年9月27日(星期三) 3:14

收件人:DK

主題:答復: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

設備型號、版本信息再補充提供下。

============================================================================================ 

發件人:DK

發送時間:2017年9月27日(星期三) 3:20

收件人:大華SDK支持

主題:回復:答復: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗 

設備型號:DH-ASC1204B
 
軟件版本參考附件 

============================================================================================ 

發件人: 大華SDK支持

發送時間: 2017年9月27日(星期三) 下午4:13

收件人: DK

主題: 轉發: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

 

附件是門禁C# Demo,供參閱。

1卡操作

2查詢記錄

3監聽事件、指紋抓取

 

看是否覆蓋業務,是否夠用?       

調試問題文檔

調試問題代碼

門禁C# Demo

設備型號.png

2.3 針對版本的門禁demo

這次有進步,之前門禁狀態查詢一直返回的是無效的錯誤碼,這次找到了有效的錯誤碼-1。起初以為是Rec NO的問題,后來經電話溝通,確認是沒有復制大華的門禁相關dll到調試輸出目錄下(debug)。把測試demo輸出目錄的所有dll拷貝到自己的調試輸出目錄后,功能就正常了。

發件人:DK

發送時間:2017年9月28日(星期四) 2:40

收件人:大華SDK支持

主題:回復:轉發: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

你好,我今天試了下昨天發給我的demo:
1、登陸正常;
2、點擊get按鈕,執行設備查詢操作時,返回錯誤代碼-1(未知錯誤)
 
    操作順序:點擊get按鈕-》彈出彈出1(參見附件get按鈕彈出1)-》未填寫任何信息,點擊ok-》彈出錯誤信息(參見報錯信息2)
       
============================================================================================ 

發件人:大華SDK支持

時   間:2017年9月28日(星期四) 3:06

收件人:DK

主題:項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

這是查詢門禁卡的,要輸入Rec NO才行。

============================================================================================ 

發件人: DK
發送時間: 2017年9月28日 15:42
收件人: 大華SDK支持
主題: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

你好,請問門禁卡的Rec NO如何獲取?

============================================================================================ 

發件人:大華SDK支持

時   間:2017年9月28日(星期四) 3:49

收件人:DK

主題:答復: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

請注意接聽電話,我們打了兩遍您這邊都沒接

我打農村來187********

============================================================================================ 

發件人:DK

時   間:2017年9月28日(星期四) 4:52

收件人:大華SDK支持

主題:回復:答復: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗
 
你好,十分感謝,在您的指導下,已經調試完畢。

get按鈕彈窗1.png

報錯信息2.png

2.4 門禁控制結構體

這是個小問題,就是在開發門禁控制功能時,一個結構體找不到,原因是兩種語言下的命名方式不一致造成的。

發件人: DK
發送時間: 2017年9月29日 11:13
收件人: 大華SDK支持
主題: 回復:答復: 回復:答復: 項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗

你好,

我在做門禁事件監聽時,查不到NET_ALARM_ACCESS_LOCK_STATUS_INFO這個結構體的構造,麻煩提供一下。

============================================================================================ 

發件人:大華SDK支持

時   間:2017年9月29日(星期五) 11:26

收件人:DK

主題:項目名稱-netsdk門禁-CLIENT_QueryDevState接口C#調用失敗 

C#命名規則都以NET開頭,和C++的可能不一致

去掉頭就能搜到了ALARM_ACCESS_LOCK_STATUS_INFO

2.5 門禁常開、常關

這個功能是后來發現的,現場的一些門是常開的,但是我在大華自己的門禁web系統里看不到這種常開的狀態、包括我開發的門禁服務程序里也區分不出來常開的情況。但是DH-ACS 100桌面軟件里可以看到門是否常開,因此就想着肯定是有獲取門是否常開的接口。查詢文檔和跟技術支持溝通,只得到了這個設置常開的接口。目前門是否處於常開狀態的信號獲取未實現。

發件人:DK
發送時間: 2018年4月25日 10:28
收件人: 大華SDK支持
主題: 項目名稱-netsdk門禁

 

你好,

 

      在現場發現了門有常開的狀態,想請問下如何查詢、控制門禁的常開、常閉狀態。
      
============================================================================================ 

  
發件人:大華SDK支持  
時   間:2018年4月25日(星期三) 5:16
收件人:DK
主題:答復: 項目名稱-netsdk門禁

你好!

 

編譯運行附件demo,可以獲取設置門禁常開常閉狀態。

附件demo

門禁常開常關.jpg

3. 調試問題

2.1 CLR20R3異常

門禁服務程序調試完畢后,本地加入CLR連接、配置、類庫,並提升.NET版本后,在服務器上運行直接崩潰。且無法進入調試斷點,直接運行則報CLR20R3錯誤,無從入手。

經查,CLR20R3最好的解決辦法是查看window日志。

最終解決辦法,修改程序編譯版本為x86解決問題
參考地址)。

2.2. BEX64異常

調整編譯版本為x86,解決問題。

參考地址

2.3. 找不到dll

拷貝大華SDk文件夾下的庫文件到Release或者debug目錄下即可。

3.4. 門開關機制

門禁控制邏輯是這樣的:收到開門命令后,觸發門鎖開門(發出開發消息)並等待2-3秒,然后門會自動鎖上(發出關門消息)。我理解常開有兩種情況:

  • 強制常開:門打開后,一直阻擋門自動鎖上;
  • 設置常開:設置常開模式,門鎖打開后,不在自動鎖上。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM