項目中需要能夠查詢門禁信號和控制門禁設備,因此需要基於大華門禁SDK進行二次開發,開發語言C#。門禁開發中遇到了一些問題,經過與大華技術的郵件溝通也一一解決。做這個開發的時候,發現網上的資料比較少,想著把自己遇到的問題整理下來,讓有需要的人儘量少走一些彎路。 ...
項目中需要能夠查詢門禁信號和控制門禁設備,因此需要基於大華門禁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進行門禁開發、封裝引用。
有問題反饋
設備上下文環境:設備型號、固件版本
問題描述:截圖、操作步驟
我們再分析下。
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監聽事件、指紋抓取
看是否覆蓋業務,是否夠用?
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#調用失敗
你好,十分感謝,在您的指導下,已經調試完畢。
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,可以獲取設置門禁常開常閉狀態。
3. 調試問題
2.1 CLR20R3異常
門禁服務程式調試完畢後,本地加入CLR連接、配置、類庫,並提升.NET版本後,在伺服器上運行直接崩潰。且無法進入調試斷點,直接運行則報CLR20R3錯誤,無從入手。
經查,CLR20R3最好的解決辦法是查看window日誌。
最終解決辦法,修改程式編譯版本為x86解決問題
(參考地址)。
2.2. BEX64異常
調整編譯版本為x86,解決問題。
2.3. 找不到dll
拷貝大華SDk文件夾下的庫文件到Release或者debug目錄下即可。
3.4. 門開關機制
門禁控制邏輯是這樣的:收到開門命令後,觸發門鎖開門(發出開發消息)並等待2-3秒,然後門會自動鎖上(發出關門消息)。我理解常開有兩種情況:
- 強制常開:門打開後,一直阻擋門自動鎖上;
- 設置常開:設置常開模式,門鎖打開後,不在自動鎖上。