海灣GSTCOM四川火災(zāi)報(bào)警控制器集成應(yīng)用軟件接口（以下簡稱接口）是用于第三方進(jìn)行系統(tǒng)集成的專用編程接口，它可與GST-DH9000電氣火災(zāi)監(jiān)控設(shè)備（以下簡稱電氣火災(zāi)監(jiān)控設(shè)備）進(jìn)行通訊。本接口為方便用戶進(jìn)行二次開發(fā)，附帶了VB、VC、C#、Delphi編程樣例程序，供用戶參考。

1.2 所適用的操作系統(tǒng)

Windows XP、Windows 7、Windows 10

1.3運(yùn)行環(huán)境要求

軟件：本控件使用前需要對GstCom.Dll進(jìn)行注冊，安裝程序已經(jīng)自動(dòng)將此控件注冊。

硬件：需要一塊與電氣火災(zāi)監(jiān)控設(shè)備相適應(yīng)的標(biāo)準(zhǔn)RS232通訊接口板，標(biāo)準(zhǔn)RS232通訊接口板與計(jì)算機(jī)用串口線連接。

二、安裝過程

2.1系統(tǒng)的安裝步驟

將安裝文件拷貝到任意目錄下，運(yùn)行GstLDCom_Setup.exe 即可。

2.2安裝正確性

2.2.1安裝后文件清單

安裝完成后查看用戶選擇的安裝目錄下是否有如圖1文件。

圖1

目錄下的GstCom.Dll是GstCom消防通訊接口控件， GstComVbSample.exe是VB應(yīng)用程序，GstLDCom.doc文件為用戶手冊，Include目錄下為GstCom消防通訊接口控件在VC編程應(yīng)用環(huán)境下所需的頭文件，Samples目錄下為示例程序的源碼。

2.2.2 安裝后程序菜單

安裝完成后，開始菜單欄“程序”子菜單出現(xiàn)GstCom-> GstCom Test Sample。啟動(dòng)系統(tǒng)能正常運(yùn)行。

三、使用說明

3.1 注冊控件

用戶次使用接口時(shí)，若該控件未注冊，將彈出未注冊對話框。若用戶希望注冊該控件，請將注冊對話框中的用戶信息通過電話、Email、傳真等方式傳遞給我公司，我們將生成注冊碼傳給用戶，填入正確的注冊碼后，控件注冊成功。

3.2 接口方法

3.2.1打開GstCom

OpenGstCom m_nCom, m_nControllerID, m_nProtocol, Resevered,lResult;

m_nCom 串口標(biāo)識變量的index；

m_nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

m_nProtocol 協(xié)議變量(即：電氣火災(zāi)監(jiān)控設(shè)備類型，數(shù)值如下)；

200 表示GstDH9000中文通訊板

Resevered 保留參數(shù)(0)；

LResult 返回狀態(tài)（參見返回狀態(tài)參數(shù)說明）；

3.2.2電氣火災(zāi)監(jiān)控設(shè)備復(fù)位

ResetController m_nControllerID, lResult;

m_nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

lResult 返回狀態(tài)（參見返回狀態(tài)參數(shù)說明）；

3.2.3電氣火災(zāi)監(jiān)控設(shè)備消音

MuteController m_nControllerID, lResult;

m_nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

lResult 返回狀態(tài)（參見返回狀態(tài)參數(shù)說明）；

3.2.4啟動(dòng)電氣火災(zāi)監(jiān)控設(shè)備巡檢命令

StartQuery m_nControllerID, nType,Reserved,lResult;

m_nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

nType 啟動(dòng)類型；（0 停止查詢，2 啟動(dòng)查詢）

Reserved 保留參數(shù)（0）；

LResult 返回狀態(tài)（參見返回狀態(tài)參數(shù)說明）；

3.2.5關(guān)閉GstCom

CloseGstCom m_nControllerID,lResult;

m_nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

LResult 返回狀態(tài)（參見返回狀態(tài)參數(shù)說明）；

3.2.6返回狀態(tài)參數(shù)說明

返回狀態(tài)參數(shù)說明如表1.

表1

返回參數(shù)	說明
LResult=0 (RET_Successfu)l	命令執(zhí)行成功
LResult=1 (RET_Busy)	電氣火災(zāi)監(jiān)控設(shè)備忙
LResult =2 (RET_ParamInvalide)	參數(shù)非法
LResult =3 (RET_ShakeHandFail)	通訊握手失敗
LResult =4 (RET_GstComError)	命令執(zhí)行內(nèi)部錯(cuò)誤
LResult =5 (RET_ReplyError)	命令執(zhí)行應(yīng)答錯(cuò)誤
LResult =6 (RET_ReplyTimeout)	命令發(fā)送應(yīng)答超時(shí)
LResult =10 (RET_Rs232Error)	串口打開失敗
LResult =255(RET_NotCommand)	不支持此命令

3.2.7 查詢實(shí)時(shí)電流值

UpLDDeviceCurrent nControllerID, nLoop, nAddress, lCurrent, pResult

m_nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

nLoop 回路號；

nAddress 一次碼；

lCurrent 返回電流值；

lResult 返回狀態(tài)（參見返回狀態(tài)參數(shù)說明）；

3.2.7 查詢實(shí)時(shí)溫度值

UpLDDeviceTemperature ControllerID, nLoop, nAddress, lCurrent, pResult

m_nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

nLoop 回路號；

nAddress 一次碼；

lCurrent 返回溫度值；

lResult 返回狀態(tài)（參見返回狀態(tài)參數(shù)說明）；

3.3接口事件

GstCom_AlarmEvent(ByVal nControllerID As Long, ByVal nEventType As Long, ByVal

bstrDeviceID As String, ByVal Value As Long)

nControllerID 電氣火災(zāi)監(jiān)控設(shè)備地址；

nEventType 事件的類型；

bstrDeviceID 相關(guān)設(shè)備編碼（設(shè)備二次碼）；

Value 對應(yīng)事件類型的相關(guān)數(shù)據(jù)；

參數(shù)詳細(xì)描述如表2。

表2

事件的類型（nEventType）	相關(guān)設(shè)備編碼(bstrDeviceID)	對應(yīng)事件類型的相關(guān)數(shù)據(jù)（Value ）	說明
AE_CommNormal (0)	---------	----------	消防系統(tǒng)正常，無報(bào)警、故障等信息
AE_CommRetryFault (2)	----------	---------	應(yīng)答錯(cuò)誤
AE_CommTimeout (1)	------------	-----------	超時(shí)錯(cuò)誤
AE_ControllerReset（3）	------------	------------	電氣火災(zāi)監(jiān)控設(shè)備消音復(fù)位
AE_ControllerStatus（4）		Value=狀態(tài)代碼:(H->L) bit7-自動(dòng) (1允許, 0不允許) bit6-手動(dòng) (1允許, 0不允許) bit5-噴灑 (1允許, 0不允許) 狀態(tài)代碼低四位值為: 1H 主電故障 2H 主電恢復(fù) 3H 備電故障 4H 備電恢復(fù) 5H 開機(jī) 例如： 67 表示手動(dòng)允許，備電故障	電氣火災(zāi)監(jiān)控設(shè)備消音狀態(tài)置位
AE_ControllerMute （5）	------------	------------	電氣火災(zāi)監(jiān)控設(shè)備消音
AE_DeviceRestore （8）	設(shè)備編碼	------------	設(shè)備恢復(fù)
AE_DeviceAlarm (16)	設(shè)備編碼	------------	設(shè)備報(bào)警
AE_DeviceStart (32)	設(shè)備編碼	------------	設(shè)備啟動(dòng)
AE_DeviceStop (64)	設(shè)備編碼	------------	設(shè)備停止
AE_DeviceAction (128)	設(shè)備編碼	------------	設(shè)備動(dòng)作
AE_DeviceFault （256）	設(shè)備編碼	Value=1:一般故障 Value=2:設(shè)備損壞故障 Value=4: 停電故障Value=8: 傳感器故障	設(shè)備故障
AE_DeviceIsolate （512）	設(shè)備編碼	----------	設(shè)備隔離
AE_DeviceRelease （1024）	設(shè)備編碼	----------	設(shè)備釋放

四、在編程環(huán)境中應(yīng)用

4.1 VB編程環(huán)境中GstCom 的創(chuàng)建

l 在VB編程環(huán)境中引用GstCom控件；

l 在應(yīng)用程序頭部定義GstCom，如：Public WithEvents MyGstCom As GstComCtl；

l 在程序初始化階段，創(chuàng)建GstCom對象，如：Set MyGstCom = New GstComCtl。

4.2 VC編程環(huán)境中GstCom 的創(chuàng)建

l 在應(yīng)用程序的頭文件中加入如下文件

#include "GstCom.h"

#include "GstComDefines.h"

#include "GstComEventSink.h"

l 在應(yīng)用程序的代碼文件中加入如下文件

#include "GstCom_i.c"

l 在應(yīng)用程序中定義GstCom的引用及相關(guān)變量，

IGstComCtl *m_IGstComCtl;

CGstComEventSink* m_pGstComEventSink;

IUnknown* m_pControlUnk;

l 在應(yīng)用程序中創(chuàng)建接口實(shí)例

HRESULT hr;

hr = CoInitialize(0);

hr = CoCreateInstance( CLSID_GstComCtl , NULL, CLSCTX_INPROC_SERVER,

IID_IGstComCtl, (void**) &m_IGstComCtl);

if (!SUCCEEDED(hr))

{

AfxMessageBox("CoCreateInstance Failed.");

return FALSE;

}

m_IGstComCtl->QueryInterface(IID_IGstComCtl, (void**)&m_pControlUnk);

m_pGstComEventSink = new CGstComEventSink();

if (m_pGstComEventSink)

hr = m_pGstComEventSink->DispEventAdvise(m_pControlUnk);

else

AfxMessageBox("Event Creater Failed.");

執(zhí)行成功后應(yīng)用程序就會(huì)得到GstCom的引用m_IGstComCtl。同時(shí)用戶將報(bào)警事件處理代碼添加到GstComEventSink.h文件的“用戶代碼”處

l 應(yīng)用程序退出，斷開連接釋放資源：

m_pIRayRtdb->Release(); //一定要釋放，否則退出時(shí)，會(huì)有內(nèi)存泄露

m_pIUnknown->Release(); //一定要釋放，否則退出時(shí)，會(huì)有內(nèi)存泄露

if(m_pRtdbEventSink)

delete m_pRtdbEventSink;

CoUninitialize();

if (m_pGstComEventSink)

{

m_pGstComEventSink->DispEventUnadvise(m_pControlUnk);//斷開事件

m_pControlUnk->Release(); //釋放查詢指針

delete m_pGstComEventSink;//刪除事件接收對象

}

if (m_IGstComCtl)

m_IGstComCtl->Release();

4.3 C#編程環(huán)境中GstCom 的創(chuàng)建

l 在C#的“解決方案資源管理器中”引用GstCom.dll控件，在“引用”中可得到GSTCOMLIB庫。

l 在應(yīng)用程序頭部定義GstCom，即：using GSTCOMLIB；

l 在程序初始化階段，創(chuàng)建GstComCtl對象，即：

GstComCtl myGstComCtl=new GstComCtl（）;

myGstComCtl.OpenGstCom(m_nCom, m_nControllerID, m_nProtocol, 100, out hResult);

用于打開COM接口，在調(diào)用方法的時(shí)候傳進(jìn)參數(shù)的類型必須和要求的一致。

l 在應(yīng)用程序中創(chuàng)建事件響應(yīng)

處理COM 接口的事件時(shí)需要引入下列代碼：

gstComCtl.AlarmEvent +=new

_IGstComCtlEvents_AlarmEventEventHandler(gstComCtl_AlarmEvent);

創(chuàng)建時(shí)間處理方法gstComCtl_AlarmEvent，如：

private void gstComCtl_AlarmEvent(byte nCom, int nControllerID, int nEventType, string bstrDeviceID, int Value)

{

//用戶代碼

}

4.4 Delphi編程環(huán)境中GstCom 的創(chuàng)建

l 在Delphi的引用GstCom.dll控件，得到GStCOMLib_TLB庫。即：注冊GstCom.dll—>打開Delphi7—>component—>Impot ActiveX Contrl—>選擇GstCom1.0 Type Library—>createUnit。得到GStCOMLib_TLB；

l 在應(yīng)用程序頭部使用GStCOMLib_TLB、，即：uses GStCOMLib_TLB，ComObj；

l 在程序初始化階段，創(chuàng)建GstComCtl對象，即：

var

GstComCtl : IGstComCtl;

GstComCtl:=CreateComObject(CLASS_GstComCtl) as IGstComCtl;

上一篇：四川海灣高能總線系列控制器 MODBUS通信規(guī)約GST-DGNK5000H

下一篇：四川工業(yè)基建｜海灣高防護(hù)消防產(chǎn)品

[ 返回列表 ]

四川海灣DH-GST-COM電氣火災(zāi)監(jiān)控設(shè)備集成應(yīng)用編程接口

一、 簡介

1.1概述

1.2 所適用的操作系統(tǒng)

1.3運(yùn)行環(huán)境要求

二、 安裝過程

2.1系統(tǒng)的安裝步驟

2.2安裝正確性

2.2.1安裝后文件清單

2.2.2 安裝后程序菜單

三、 使用說明

3.1 注冊控件

3.2 接口方法

3.2.1打開GstCom

3.2.2電氣火災(zāi)監(jiān)控設(shè)備復(fù)位

3.2.3電氣火災(zāi)監(jiān)控設(shè)備消音

3.2.4啟動(dòng)電氣火災(zāi)監(jiān)控設(shè)備巡檢命令

3.2.5關(guān)閉GstCom

3.2.6返回狀態(tài)參數(shù)說明

3.2.7 查詢實(shí)時(shí)電流值

3.2.7 查詢實(shí)時(shí)溫度值

3.3接口事件

四、 在編程環(huán)境中應(yīng)用

4.1 VB編程環(huán)境中GstCom 的創(chuàng)建

4.2 VC編程環(huán)境中GstCom 的創(chuàng)建

4.3 C#編程環(huán)境中GstCom 的創(chuàng)建

4.4 Delphi編程環(huán)境中GstCom 的創(chuàng)建

一、簡介

二、安裝過程

三、使用說明

四、在編程環(huán)境中應(yīng)用