WIN-PAK SEPE Communication Server API
WIN-PAK SEPE Communication Server API
WIN-PAK SEPE Communication Server API
Release 6.2
While this information is presented in good faith and believed to be accurate, Honeywell disclaims the implied warranties of merchantability and fitness for a particular purpose and makes no express warranties except as may be stated in its written agreement with and for its customers. In no event is Honeywell liable to anyone for any indirect, special or consequential damages. The information and specifications in this document are subject to change without notice. WIN-PAK SE/PE is a registered trademark of Honeywell International Inc. Other brand or product names are trademarks of their respective owners.
2012 Honeywell Access Systems. All rights reserved.
Honeywell Access Systems 135 West Forest Hill Avenue Oak Creek, WI 53154 U.S.A
Release 6.2
iii
Modification History
Version
1.0
Date
March 15 , 2012 May 9th 2012
th th
Author
Sathish Guru
Description
Initial Draft for WIN- PAK SE/PE Communication Server API Added the new functions and the document navigation Added the review comments Added the review comments and NetAXS IO Board statuses corrected Updated the Bookmarks and Page references
1.1
Sathish Guru
Release 6.2
iv
Table of Contents
ABOUT THIS DOCUMENT ........................................................................................................................... VIII INTRODUCTION............................................................................................................................................. 10 OVERVIEW ................................................................................................................................................... 10 COMPONENT MODEL DIAGRAM ........................................................................................................................ 11 SUPPORTED OPERATING SYSTEMS ...................................................................................................................... 11 INSTALLING THE COMMUNICATION SERVER APIS ................................................................................................... 12 Prerequisites for Installing the CommunicationAPIServer ....................................................................... 12 Prerequisites for Installing the CommunicationAPIClient ........................................................................ 16
CONNECTING THE API CLIENT AND THE API SERVER ............................................................................................... 21 Before you start .................................................................................................................................... 21 COMMUNICATION SERVER APIS ................................................................................................................... 23 OVERVIEW ................................................................................................................................................... 23 DATA STRUCTURES ......................................................................................................................................... 24 Device Structure .................................................................................................................................... 24 Enumeration Types................................................................................................................................ 24
DisableDoorTimezone(get)................................................................................................................................. 28 DisableDoorTimezone(put) ................................................................................................................................ 28 LockdownReaderTimezone(get) ......................................................................................................................... 29 LockdownReaderTimezone(put)......................................................................................................................... 29 CardOnlyTimezone(get) ..................................................................................................................................... 30 CardOnlyTimezone(put) ..................................................................................................................................... 30 PINOnlyTimezone(get) ....................................................................................................................................... 31 PINOnlyTimezone(put)....................................................................................................................................... 31 CardOrPINTimezone(get) ................................................................................................................................... 32 CardOrPINTimezone(put) ................................................................................................................................... 32 CardAndPINTimezone(get) ................................................................................................................................. 33 CardAndPINTimezone(put) ................................................................................................................................ 33 CardOnlyPriority(get) ......................................................................................................................................... 33 CardOnlyPriority(put) ........................................................................................................................................ 34 PINOnlyPriority(get)........................................................................................................................................... 34 PINOnlyPriority(put) .......................................................................................................................................... 35 CardAndPINPriority(get) .................................................................................................................................... 35 CardAndPINPriority(put) .................................................................................................................................... 36 CardOrPINPriority(get) ....................................................................................................................................... 36 CardOrPINPriority(put) ...................................................................................................................................... 37
Release 6.2
ABSTRACT DEVICES STATUS DEFINITIONS ............................................................................................................. 59 EVENT CODE LIST ........................................................................................................................................... 61 COMMUNICATION SERVER CALLBACK PROTOCOL ........................................................................................ 68
InitServer .......................................................................................................................................................... 38 DoneServer ....................................................................................................................................................... 39 AckAlarm........................................................................................................................................................... 40 ClrAlarm ............................................................................................................................................................ 40 AddNote............................................................................................................................................................ 41 GetDetailsByID .................................................................................................................................................. 42 EntryPointLockByID ........................................................................................................................................... 42 EntryPointUnLockByID ....................................................................................................................................... 43 AlarmShuntByHID .............................................................................................................................................. 43 AlarmUnShuntByHID.......................................................................................................................................... 44 PulseByHID ........................................................................................................................................................ 44 TimedPulseByHID .............................................................................................................................................. 44 RestoreTZByHID................................................................................................................................................. 45 BufferByHID ...................................................................................................................................................... 46 UnBufferByHID .................................................................................................................................................. 47 DoorModeByHID ............................................................................................................................................... 48 ListConnectedDevices ........................................................................................................................................ 48 Energize ............................................................................................................................................................ 49 DeEnergize ........................................................................................................................................................ 49 AddFilterHID...................................................................................................................................................... 50 RemoveFilterHID ............................................................................................................................................... 50 GetFilterHIDs ..................................................................................................................................................... 51 AddFilterCommServerID .................................................................................................................................... 51 RemoveCommServerID ...................................................................................................................................... 52 GetFilterCommServerIDs ................................................................................................................................... 52 PanelInitialize .................................................................................................................................................... 53 PanelCancelInitialize .......................................................................................................................................... 53 GetDefaultACRMode ......................................................................................................................................... 54 IsConnected ...................................................................................................................................................... 54 ExecuteDoorSchedule ........................................................................................................................................ 55 GetNetAXSDoorModeByHID .............................................................................................................................. 56 SetNetAXSDoorModeByHID ............................................................................................................................... 56 GetStatus .......................................................................................................................................................... 58
GetDoorStatus2 ................................................................................................................................................. 66
OVERVIEW ................................................................................................................................................... 68 PROTOCOL PROCESS ....................................................................................................................................... 69 Process Flow Diagram ........................................................................................................................... 69 NOTIFICATION MESSAGE TAGS .......................................................................................................................... 70 Tag Descriptions.................................................................................................................................... 70 Examples of Panel Notification Messages .............................................................................................. 75
Sample Code to Extract Information from the Notification Messages .................................................................. 73 Reader and Output Events ................................................................................................................................. 75 Reader and Output Alarms................................................................................................................................. 77 Input Event........................................................................................................................................................ 78 Input Alarm ....................................................................................................................................................... 79 Panel Event ....................................................................................................................................................... 81 Device Status ..................................................................................................................................................... 82 Communication Server Lost Connection ............................................................................................................. 83 Communication Server Regained Connection ..................................................................................................... 84 Database Server Lost Connection ....................................................................................................................... 84 Database Server Regained Connection ............................................................................................................... 84
Table of Contents
INDEX............................................................................................................................................................ 86
Release 6.2
vii
Intended Audience
This document is intended for the developers of the Communication Server API Client application.
Document Structure
The following table lists the contents in each chapter. Chapter
Introduction
Contents
Gives an overview of the Communication Server APIs, explains the component model diagram, and lists the procedure to install the Communication Server APIs. Provides information about data structures and functions of the Communication Server API. Explains the callback protocol process. In addition, this chapter explains the notification message tags and provides examples of the notification messages.
Acronyms
The following table lists the acronyms used in this guide. Acronyms
APB API COM DCOM MTS
Descriptions
AntiPassBack Application Programming Interface Component Object Model Distributed Component Object Model Microsoft Transaction Server
Release 6.2
viii
Acronyms
PIN UI WIN-PAK SE/PE
Descriptions
Personal Identification Number User Interface WIN-PAK Standard Edition/Professional Edition
Document Conventions
The following table lists the conventions used in this document. Convention
Bold Text Navy Blue Text
Green Text
Use
Indicates UI elements. Indicates programming codes. Indicates comments for the programming codes. Indicates a Note.
Blue Text
Indicates an Example.
Grey Text
Contact Information
Honeywell Access Systems 135 West Forest Hill Avenue Oak Creek, WI 53154 U.S.A OFFICE HOURS: 8 AM to 5 PM (CST) PHONE: 414-766-1700 FAX: 414-766-1798 URL: http://www.honeywellaccess.com
Release 6.2
ix
Chapter 1
INTRODUCTION
Overview
The Communication Server is a component of the WIN-PAK SE/PE application. The WIN-PAK SE/PE is an access control system that authenticates employee access at security areas. The Communication Server serves as a concentrator for communications with the access control hardware located at the customer locations. The WIN-PAK SE/PE provides a UI for the operator to monitor and track the access control activities of the end-users at the customer locations. Using the Communication Server APIs, a customized Windows client application can be created to monitor and act on the events/alarms as a WIN-PAK SE/PE UI. Multiple Communication Server modules can be active in a client application. The customized Communication Server can be used to perform the following tasks. Forward the event/alarm transactions to the client application. Track the status of the alarms from the client application. The Communication Server API is intended for N-tier Windows applications and is based on the Microsoft Windows DNA technologies using COM, DCOM, MTS and COM+ components of ActiveX. The following sections explain the component model diagram of the Communication Server and the procedure to install the Communication Server. In this Chapter
Component Model Diagram Supported Operating Systems Installing the Communication Server APIs Connecting the API Client and the API Server
Page Number
11 11 12 21
Release 6.2
10
Introduction
1 2
The Communication Server serves as a concentrator for communication with the access control hardware located at the customer locations. The Accw.dll acts as a remote DCOM server that communicates with the client and the WIN-PAK SE/PE communication server. The Accw.dll contains the business component, IMTSCBServer and the IWPAVCallback interface. The IMTSCBServer is an interface that contains the various API calls for WINPAK SE/PE Communication server functionalities. The client is informed about the events and alarms using the COM/DCOM callback mechanism and a tag based protocol. The Communication Server API client is a Windows client application that monitors the events/alarms of the hardware devices at the customer locations.
Microsoft Windows Server 2008 R2(32/64 Bit) Microsoft Windows 7(32/64 Bit)
Release 6.2
12
Introduction
3. Read the license agreement and select Accept and then click Next. The Custom Setup screen appears.
Release 6.2
13
4. Select WIN-PAK Communication Server API. To change the destination folder, click Change and select the destination folder. Click Next. The Ready to install the program screen appears.
5. Click Install to start the installation. The Setup Status screen appears showing the installation progress. The InstallShield Wizard completed screen appears.
Release 6.2
14
Introduction
6. Click Finish to close the InstallShield wizard. You must restart your computer to complete the installation.
Release 6.2
15
Release 6.2
16
Introduction
Release 6.2
17
3. Read the license agreement and select Accept and then click on Next. The Custom Setup screen appears.
4. Select WIN-PAK Communication Client API. To change the destination folder, click Change and select the destination folder.. 5. Click Next. The Communication Server Details screen appears. 6. Type the computer name or IP address or the Machine name of the computer on which the Communication Server APIs are installed and then, click Next.
Release 6.2
18
Introduction
7. The Ready to install the program screen appears. Click Install to start the installation.
Release 6.2
19
8. The Setup Status screen appears showing the installation progress. The InstallShield Wizard completed screen appears.
9. Click Finish to close the InstallShield wizard. You must restart your computer to complete the installation.
Release 6.2
20
Introduction
Release 6.2
21
Release 6.2
22
Chapter 2
Page Number
24 26 59 61
Release 6.2
23
Data Structures
The following special data structures are used to implement the functionality of the communication client component in the WIN-PAK SE/PE Communication Server.
Device Structure
Description This structure contains information about the device name, device ID, and device type. Definition
struct Device{ [helpstring(Contains the Device Name)] BSTR sDeviceName; [helpstring(Contains the HID)] long lDeviceID; [helpstring(Contains the Device Type)] long lDeviceType; } Device;
Enumeration Types
The Communication client component provides the following enumeration types to declare the types of views and the hardware dependent constants. wpviewTYPE HIDType HIDSubType1 wpviewTYPE Description Defines the following types of views. Alarm Event Alarm and Event Definition
enum wpviewTYPE { [helpstring("AlarmView")]wpviewAlarm= 0x0001, [helpstring("EventView")]wpviewEvent= 0x0002,
Release 6.2
24
HIDSubType1 Description Defines the sub types of the hardware devices. Definition
enum HIDSubType1 { HID_SERVER_COMM = 2 HID_SERVER_SCHEDULER = 3 HID_SERVER_GUARD_TOUR = 4 HID_SEQUENCED_CHK_PT = 5 HID_UNSEQUENCED_CHK_PT = 6 HID_SERVER_CAMERA_TOUR = 7 HID_SERVER_CMD_FILE = 8 HID_SERVER_MUSTER = 9 HID_LOOP_N1000 = 13 HID_LOOP_N1000_C100 = 14 HID_LOOP_N1000_485 = 15
Release 6.2
25
WIN-PAK SE/PE Communication Server API HID_LOOP_N1000_485_ACKNAK = 16 END_HID_LOOP_N1000 = 17 HID_LOOP_N750 = 18 HID_LOOP_SYMPHONY = 19 HID_LOOP_SYMPHONY_LEGACY = 20 HID_LOOP_PW5000 = 21 HID_PANEL_N1000 = 23 HID_PANEL_N1000_II OR HID_PANEL_PW2000 (X) 24 HID_PANEL_N1000_III OR HID_PANEL_PW2000-3 (X) 25 HID_PANEL_N1000_IV OR HID_PANEL_PW2000-4 (X) 26 HID_PANEL_N750 = 27 HID_PANEL_SYMPHONY = 28 HID_PANEL_PW5000 = 29 HID_PANEL_PW5000_DIALUP = 130 HID_INPUT_STD = 31 HID_INPUT_SUPERVISED = 32 HID_INPUT_PW5000_STD = 33 HID_INPUT_PW5000_SUPER = 34 HID_OUTPUT_STD = 41 HID_GROUP_STD = 42 HID_OUTPUT_PW5000 = 43 HID_ENTRANCE_DOOR = 51 HID_ENTRANCE_READER = 52 HID_ENTRANCE_PW5000_DOOR = 53 HID_CCTV_SWITCHER = 61 END_HID_CCTV_SWITCHER = 71 HID_CCTV_CAMERA = 72 HID_CCTV_MONITOR = 75 HID_MODEM_POOL_C100 = 81 HID_MODEM_POOL_PCI = 82 HID_MODEM_POOL_PW5000 = 84 HID_JCI_MNI = 91 HID_LANDIS_STAEFA_S600 = 92 HID_RS_232_LINK = 93 } HIDSubType1;
panelInitTask Description Defines the constituent steps needed for the Panel initialization task. Definition
enum panelInitTask { taskINIT = 0, taskTIMEDATE = 1, taskCARD = 2,
Release 6.2
26
Object Specifications taskCMDFILE = 3, taskHOLIDAY = 4, taskTIMEZONE = 5 , taskINPUT = 6, taskOUTPUT = 7, taskGROUP = 8, taskMCBCONFIG = 9, taskINPUTSCAN = 10, taskCARDFORMAT = 11, taskSIOBOARD = 12, taskACCESSLEVELS = 13, taskTRIGGERS = 14, taskPROCEDURES = 15, taskMPGROUPS = 16, taskACCESSAREAS = 17, taskREADERLED = 18, taskTZREFRESH = 19 }panelInitTask;
OBJECT SPECIFICATIONS
Overview
The developers of the WIN-PAK SE/PE application have developed the COM object for encapsulating the various fields that constitute the Door Mode of the NetAXS Panel. This object enables the client applications to access the current Door Modes of the NetAXS Readers and also to set new Door Modes to the NetAXS Readers configured in the WIN-PAK SE/PE. This Interface and the associated class is compiled inside the Accw.dll The list of COM objects in NCIHelper.dll are as follows: Accw.NetAXSDoorInfo
NetAXSDoorInfo
The NetAXSDoorInfo object is used to access the WIN-PAK SE/PE Door Mode information of the NetAXS readers. In addition, this object is used to assign the Door Mode to a NetAXS reader.
Release 6.2
27
Properties
The following methods help you to get and set the NetAXSDoorMode properties in the WIN-PAK SE/PE. DisableDoorTimezone LockdownReaderTimezone CardOnlyTimezone PINOnlyTimezone CardOrPINTimezone CardAndPINTimezone CardOnlyPriority PINOnlyPriority CardAndPINPriority CardOrPINPriority
The following section explains the Card properties. DisableDoorTimezone(get) Description Gets the timezone ID of the Disable Door Timezone. Visual C++ Signature
HRESULT DisableDoorTimezone([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved Timezone ID set for the Disable Door Time zone
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
DisableDoorTimezone(put) Description Sets the timezone ID of the Disable Door Timezone. Visual C++ Signature
Release 6.2
28
Parameters Parameters
newVal
Description
The new Timezone ID to be set as the Disable Door Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
LockdownReaderTimezone(get) Description Gets the timezone ID of the Lockdown Reader Timezone. Visual C++ Signature
HRESULT LockdownReaderTimezone ([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved Timezone ID set for the Lockdown Reader Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
LockdownReaderTimezone(put) Description Sets the timezone ID of the Lockdown Reader Timezone. Visual C++ Signature
HRESULT LockdownReaderTimezone ([in] long newVal);
Parameters Parameters
Release 6.2
Description
29 2012 Honeywell International
Parameters
newVal
Description
The new Timezone ID to be set as the Lockdown Reader Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes: Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardOnlyTimezone(get) Description Gets the timezone ID of the Card Only Timezone. Visual C++ Signature
HRESULT CardOnlyTimezone([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved Timezone ID set for the Card Only Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardOnlyTimezone(put) Description Sets the timezone ID of the Card Only Timezone. Visual C++ Signature
HRESULT CardOnlyTimezone([in] long newVal);
Parameters Parameters
newVal
Description
The new Timezone ID to be set as the Card Only Timezone.
Release 6.2
30
Object Specifications
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
PINOnlyTimezone(get) Description Gets the timezone ID of the PIN Only Timezone. Visual C++ Signature
HRESULT PINOnlyTimezone([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved Timezone ID set for the PIN Only Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
PINOnlyTimezone(put) Description Sets the timezone ID of the PIN Only Timezone. Visual C++ Signature
HRESULT PINOnlyTimezone([in] long newVal);
Parameters Parameters
newVal
Description
The new Timezone ID to be set as the Disable PIN Only Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code Description
Release 6.2
31
S_OK
CardOrPINTimezone(get) Description Gets the timezone ID of the Card or PIN Timezone. Visual C++ Signature
HRESULT CardOrPINTimezone([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved Timezone ID set for the Card Or PIN Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardOrPINTimezone(put) Description Sets the timezone ID of the Card or PIN Timezone. Visual C++ Signature
HRESULT CardOrPINTimezone([in] long newVal);
Parameters Parameters
newVal
Description
The new Timezone ID to be set as the Card Or PIN Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Release 6.2
32
Object Specifications
CardAndPINTimezone(get) Description Gets the timezone ID of the Disable Door Timezone. Visual C++ Signature
HRESULT CardAndPINTimezone([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved Timezone ID set for the Card And PIN Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardAndPINTimezone(put) Description Sets the timezone ID of the Card and PIN Timezone. Visual C++ Signature
HRESULT CardAndPINTimezone([in] long newVal);
Parameters Parameters
newVal
Description
The new Timezone ID to be set as the Card and PIN Timezone.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Parameters Parameters
pVal
Description
The retrieved value set for the Card Only Priority.
Return Type The HRESULT value is returned. The following table displays the return codes: Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardOnlyPriority(put) Description Sets the value of the Card Only Priority. Visual C++ Signature
HRESULT CardOnlyPriority([in] long newVal);
Parameters Parameters
newVal
Description
The new value to be set as the Card Only Priority
Return Type The HRESULT value is returned. The following table displays the return codes: Return Code
S_OK
Description
For a successful operation, the value zero is returned.
PINOnlyPriority(get) Description Gets the value of the PIN Only Priority. Visual C++ Signature
HRESULT PINOnlyPriority([out, retval] long *pVal);
Parameters
Release 6.2 34 2012 Honeywell International
Object Specifications
Parameters
pVal
Description
The retrieved value set for the PIN Only Priority.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
PINOnlyPriority(put) Description Sets the value of the PIN Only Priority. Visual C++ Signature
HRESULT PINOnlyPriority([in] long newVal);
Parameters Parameters
newVal
Description
The new value to be set as the PIN Only Priority.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardAndPINPriority(get) Description Gets the value of the Card And PIN Priority. Visual C++ Signature
HRESULT CardAndPINPriority([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved value set for the Disable Door Timezone.
Release 6.2
35
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardAndPINPriority(put) Description Sets the value of the Card And PIN Priority. Visual C++ Signature
HRESULT CardAndPINPriority ([in] long newVal);
Parameters Parameters
newVal
Description
The new value to be set as the Card And PIN Priority.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
CardOrPINPriority(get) Description Gets the value of the Card Or PIN Priority. Visual C++ Signature
HRESULT CardOrPINPriority([out, retval] long *pVal);
Parameters Parameters
pVal
Description
The retrieved value set for the Card Or PIN Priority.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code Description
Release 6.2
36
Object Specifications
S_OK
CardOrPINPriority(put) Description Sets the value of the Card Or PIN Priority. Visual C++ Signature
HRESULT CardOrPINPriority([in] long newVal);
Parameters Parameters
newVal
Description
The new value to be set as the Card Or PIN Priority.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Release 6.2
37
Release 6.2
38
Parameters Parameters
Caller enumViewType
Description
A reference to the client callback interface. Defines the type of view. For more information on the different types of view, see wpviewTYPE.
A valid WIN-PAK user name. The password of a WIN-PAK user. A valid WIN-PAK ID of the user. A Boolean value that indicates if the operation is successful.
Note
The Boolean values are as follows: TRUE Operation is successful. FALSE Operation is not successful.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Remarks This method must be called before you access the Communication Server functionalities. DoneServer Description Disconnects the client computer from the Communication Server API computer. Visual C++ Signature
HRESULT DoneServer( [in] IDispatch* Caller, [out, retval] VARIANT_BOOL* );
Parameters
Release 6.2
39
Parameters
Caller
Description
A reference to the client callback interface.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Remarks This method must be called after you complete all transactions with the Communication Server. AckAlarm Description Acknowledges the alarm identified by the hardware device ID and the point ID. Visual C++ Signature
HRESULT AckAlarm( [in] long lHID, [in] long lPoint);
Parameters Parameters
lHID lPoint
Description
The hardware device ID. The Point ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
ClrAlarm Description Clears the alarm identified by the hardware device ID and the point ID. Visual C++ Signature
Release 6.2 40 2012 Honeywell International
Communication Server API Functionalities HRESULT ClrAlarm( [in] long lHID, [in] long lPoint);
Parameters Parameters
lHID lPoint
Description
The hardware device ID. The Point ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
AddNote Description Adds an operator note to the alarm identified by the hardware device ID and the point ID. Visual C++ Signature
HRESULT AddNote( [in] long lHID, [in] long lPoint, [in] BSTR Note);
Parameters Parameters
lHID lPoint Note
Description
The hardware device ID. The Point ID. The text attached to the transaction in history.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Release 6.2
41
GetDetailsByID Description Obtains the transaction details for the specified hardware device ID and the point ID. Visual C++ Signature
HRESULT GetDetailsByID ( [in] long lHID, [in] long lPoint, [out] BSTR* pbstrTransactionDetails);
Parameters Parameters
lHID lPoint pbstrTransactionDetails
Description
The hardware device ID. The Point ID. The complete description of the transaction to be retrieved.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
EntryPointLockByID Description Locks the entrance or entry point. Visual C++ Signature
HRESULT EntryPointLockByID([in] long lHID);
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes.
Release 6.2
42
Return Code
S_OK
Description
For a successful operation, the value zero is returned.
EntryPointUnLockByID Description Unlocks the entrance or entry point. Visual C++ Signature
HRESULT EntryPointUnLockByID([in] long lHID);
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
AlarmShuntByHID Description Shunts the alarm of the specified hardware device. Visual C++ Signature
HRESULT AlarmShuntByHID([in] long lHID);
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Release 6.2
43
AlarmUnShuntByHID Description Unshunt the alarm of the specified hardware device. Visual C++ Signature
HRESULT AlarmUnShuntByHID([in] long lHID);
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Note
Various types of Panels have different maximum for the Pulse Time that can be given to the Timed Pulse command. N1000/NS2/NS2+ : 63 seconds or 63 minutes or 63 hours P-Series(PRO2200/PW5000) : 9 hours NetAXS(NetAXS 4/NetAXS 123) : 1 hour and 45 minutes
Parameters Parameters
lHID lUnits
Description
The hardware device ID. The value for the unit of time.
Note
The values for the unit of time are as follows: 0 Seconds 1 Minutes 2 - Hours lVal The pulse time value.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Release 6.2
45
Note
The P-Series Input and Readers will work with have the RestoreTZByHID(). Use GetDefaultACRMode() and use the returned value in the SetDoorModeByHID() to refresh the Timezone for the P-Series Readers
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
BufferByHID Description Buffers the transactions of the device specified by the hardware device ID. These device transactions are stored and not transmitted, so the unbuffer operation is pending. Visual C++ Signature
HRESULT BufferByHID( [in] long lHID, [in] long lVal);
Parameters Parameters
lHID lVal
Description
The hardware device ID. The buffer mode values.
Release 6.2
46
Parameters
Description Note
The modes of the buffer are indicated by the following values. 0 Hard mode 1 Soft mode
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
UnBufferByHID Description Unbuffer the transactions of the device specified by the hardware device ID. The stored device transactions are transmitted. Visual C++ Signature
HRESULT BufferByHID( long* lHID, long* lVal);
Parameters Parameters
lHID lVal
Description
The hardware device ID. The buffer mode values.
Note
The modes of the buffer are indicated by the following values. 0 Hard mode 1 Soft mode
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Release 6.2
47
DoorModeByHID Description Sets up the door mode for the specified hardware device. Visual C++ Signature
HRESULT DoorModeByHID ( [in] long lHID, [in] long lVal);
Parameters Parameters
lHID lVal
Description
The hardware device ID. The door mode values.
Note
The door mode values are as follows: 1 Disable the door 2 Unlock (limited access) 3 Locked (no access) 4 Site code only 5 Card only 6 PIN only 7 Card and PIN 8 Card or PIN
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
ListConnectedDevices Description Returns the list of abstract devices (ADVs) connected to the communication server. In addition, the device name, hardware device identification number, and the device type of the abstract devices are returned in the form of a structure. Visual C++ Signature
Release 6.2
48
Parameters Parameters
pvDevices
Description
A pointer to the variant containing the list of abstract devices.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Energize Description Energizes or charges the output device/relay for the specified device ID. Visual C++ Signature
HRESULT Energize([in] long lHID);
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
DeEnergize Description De-energizes or stops charging the output device/relay for the specified device ID. Visual C++ Signature
HRESULT DeEnergize([in] long lHID);
Parameters
Release 6.2
49
Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
AddFilterHID Description Sets the Alarm Filter such that the Alarms are meant to be reported only from the particular HID Visual C++ Signature
HRESULT AddFilterHID([in] long lHID );
Parameters Parameters
lHID
Description
The HID of a Device
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
RemoveFilterHID Description Remove the Alarm filter for the particular HID Visual C++ Signature
HRESULT RemoveFilterHID([in] long lHID );
Parameters Parameters
lStatus
Description
The output parameter that have the status of the API connection with
Release 6.2
50
Parameters
Description
the server
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
GetFilterHIDs Description Get all the Alarm HID filters. Visual C++ Signature
HRESULT GetFilterHIDs([out] BSTR* bstrHIDs );
Parameters Parameters
lStatus
Description
The output parameter that have the status of the API connection with the server
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
AddFilterCommServerID Description Sets the Alarm Filter such that the Alarms are meant to be reported only from the particular Communication Server Visual C++ Signature
HRESULT AddFilterCommServerID([in] long lCommServerID );
Parameters Parameters
lCommServerID
Description
The HID of a Communication Server
Release 6.2
51
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
RemoveCommServerID Description Remove the Alarm filter for the particular Communication Sever Visual C++ Signature
HRESULT RemoveFilterCommServerID([in] long lCommServerID );
Parameters Parameters
lCommServerID
Description
The HID of a Communication Server
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
GetFilterCommServerIDs Description Get all the Alarm Communication Server filters Visual C++ Signature
HRESULT GetFilterCommServerIDs([out] BSTR* bstrCommServerIDs );
Parameters Parameters
bstrCommServer IDs
Description
The retrieved list of Communication Server ID that currently configured in the Alarm Filter
Return Type The HRESULT value is returned. The following table displays the return codes.
Release 6.2
52
Return Code
S_OK
Description
For a successful operation, the value zero is returned.
PanelInitialize Description Starts the Initialization of the Panels with the steps mentioned. Visual C++ Signature
RESULT PanelInitialize( [in]long lHID, [in]long lHIDtype, [in]VARIANT vTasks);
Parameters Parameters
lHID lHIDType vTasks
Description
The hardware device ID of the Panel. The HIDType of the Panel. The input parameter, which is an array of integers indicates whether the initialization step is executed or not.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Remarks If the client needs to initialize a N1000 Panel of HID 12, with the initialization steps of Cards and Timezones only, the initialization code will be as follows:
int arrTasks[20]; arrTasks[(int)panelInitTask.taskCARD] = TRUE; arrTasks[(int)panelInitTask.taskTIMEZONE] = TRUE; . . .
PanelCancelInitialize Description
Release 6.2
53
Parameters Parameters
lHID
Description
The hardware device ID.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
GetDefaultACRMode Description Returns the default/configured door mode of a Reader of the P-Series panel Visual C++ Signature
HRESULT GetDefaultACRMode( [in] long lHID, [out]int *nMode);
Parameters Parameters
lHID pDoorInfo
Description
The hardware device ID of the P-Series Reader. The retrieved default Door Mode of the P-Series Reader
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
IsConnected Description
Release 6.2
54
Checks the connected status of the API Component with the Communication Server. Visual C++ Signature
HRESULT IsConnected([out] BOOL* bStatus);
Parameters Parameters
lStatus
Description
The output parameter that have the status of the API connection with the server
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
ExecuteDoorSchedule Description Executes a Door Schedule at the Direct Point of a Door. Visual C++ Signature
HRESULT ExecuteDoorSchedule( [in]long lPanelHID, [in]long lPanelType, [in]long lEntranceID, [in]long lEntrancePointID, [in]long lTZID);
Parameters Parameters
lPanelHID lPanelType lEntranceID lEntrancePointID lTZID
Description
The hardware device ID of the Panel. The HIDType of the Panel. The HID of the Reader/Entrance configured in the Panel. The point ID of the Reader that actually the ordinal of the Reader. The ID of the Timezone of the Door Schedule.
Return Type
Release 6.2 55 2012 Honeywell International
The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
GetNetAXSDoorModeByHID Description Returns the current Door mode configuration of the NetAXS Reader. Note
For NetAXS 123 Panels, the GetNetAXSDoorModeByHID() on Reader B will get only the timezones, not the Priorities. As the Reader B has no priorities, the Priorities of the Reader A will be returned.
Parameters Parameters
lHID pDoorInfo
Description
The hardware device ID of the NetAXS Reader. The output parameter that contains the current Door Mode configuration of the Reader encapsulated in the interface INetAXSDoorInfo. For more information on the card details, see the NetAXSDoorInfo Properties.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
SetNetAXSDoorModeByHID Description Sets the Door mode of the NetAXS Reader to the supplied value.
Release 6.2
56
Note
For NetAXS 123 Panels, the SetNetAXSDoorModeByHID() on Reader B will set only the timezones, not the Priorities. All the priorities passed are truncated and the corresponding Reader As priorities are taken.
Parameters Parameters
lHID pDoorInfo
Description
The hardware device ID of the NetAXS Reader. The input parameter that contains the Door Mode configuration need to be set up for the Reader encapsulated in the interface INetAXSDoorInfo. For more information on the card details, see the NetAXSDoorInfoProperties.
plStatus
Note
The SetNetAXSDoorModeByHID status values are as follows: 0 setting the Door mode for the NetAXS Reader Succeeded 1 setting the Door mode failed 2 Invalid HID for the Reader 3 The DoorInfo Object passed in the pDoorInfo was empty 4 Invalid Disable Door Timezone 5 Invalid Lockdown Reader Timezone 6 Invalid Card Only Timezone 7 Invalid PIN Only Timezone 8 Invalid Card and PIN Timezone 9 Invalid Card or PIN Timezone 10 Invalid Card Only Priority 11 Invalid PIN Only Priority
Release 6.2
57
Parameters
Description
12 Invalid Card and PIN Priority 13 Invalid Card or PIN Priority
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
GetStatus Description Returns the status for the specified device ID and the device type. For more information on the device status, see Abstract Devices Status Definitions. Visual C++ Signature
HRESULT GetStatus ( [in] long lHID, [in] long lDeviceType, [out, retval]long* lStatusID);
Parameters Parameters
lHID lDeviceType lStatusID
Description
The hardware device ID. The type of hardware device. The output parameter that contains the status ID of the device.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Release 6.2
58
Remarks If the client calls the GetStatus function by passing the parameters HID and DeviceType, the StatusID and other additional information is sent to the client. The following code is a sample of the information sent to the client.
<NLZ> <ADV_Status>StatusID</ADV_Status> <ADV_HID>HID2</ADV_HID> <ADV_DeviceType>DeviceType</ADV_DeviceType> <ADV_DeviceName>DeviceName</ADV_DeviceName> </NLZ>
Description
Null String Entrance Unknown Entrance Alarm Entrance OK Entrance Trouble Shunted Input Unknown Input Alarm Door Ajar Input Normal Input Trouble Entry in Progress Exit in Progress Input Trouble Cut Input Trouble Short Shunted
Release 6.2
59
Status ID
501 502 503 504 801 802 803 901 902 91* 92* 93* 94* 95* 96* 97* 98* 99* 903 601 602 603 1001 1002 1003
Description
Output Unknown Output Deenergized Output Energized Output Trouble Server Unknown Server Trouble Server OK Panel Unknown Panel Alarms Panel Communication AUX Port Primary Power Panel Tamper Ground Fault Low Voltage Ext 5V Poll Response Remote Panel OK Loop Unknown Loop Alarm Loop OK NetAXS IO or P-Series SIO Board Unknown NetAXS IO or P-Series SIO Board OK NetAXS IO or P-Series SIO Board Trouble
Release 6.2
60
Status ID
701 702 703
Description
Device Unknown Device Alarm Device OK
Note
The * in the status ID field indicates that it can hold any number.
EXAMPLE The status sent from the API is 452. However, the status ID 452 does not exist. This status ID can be interpreted as follows: 45*= Shunted and 402 = Input Alarm Hence the status description for the StatusID 452 is Shunted Input Alarm.
Description
Server OK Server Trouble Check Point: Out of Sequence Check Point: Missed Check Point: Early Arrival Check Point: Late Arrival Check Point: Checked Loop OK Loop Alarm Loop Remote Dial-Up Successful
Release 6.2
61
Event ID
204 301 302 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422
Description
Loop Remote Dial-Up Failed Modem Pool OK Modem Pool Trouble Panel Communication Alarm Panel Communication Normal Auxiliary Port Alarm Auxiliary Port Normal Primary Power Failure Primary Power Normal Poll Response Alarm Poll Response Normal Tamper Switch Alarm Tamper Switch Normal Ground Fault Alarm Ground Fault Normal Low Voltage Alarm Low Voltage Normal External 5 Volt Alarm External 5 Volt Normal Panel Reset Panel configuration error Incorrect Password Panel Remote Dial-Up Failed Panel Remote Dial-Up Successful Unsupported Panel version
Release 6.2
62
Event ID
423 424 425 426 427 428 429 430 431 501 502 503 504 505 506 507 508 601 602 603 701 702 703 704 705
Description
Unsupported SIO Board Version Panel Restarted Panel DB Updated Panel DB Deleted Panel Common DB Updated Panel Common DB Deleted Panel Time Changed Panel switched to Hybrid Mode Panel Process Watcher restated Input Alarm Input Normal Input Trouble Input Trouble Cut Input Trouble Short Ajar State Input Exit Delay Input Entry Delay Output De-energized Output Energized Output Trouble Valid Card Trace Card Door Unlocked Site code verified, door not used Site code verified, door used
Release 6.2
63
Event ID
706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730
Description
APB violation, door not used APB violation, door used Duress, door not used Duress, door used Valid Card, door not used Valid Card, door used Host Grant, Door unlocked Host Grant, Card downloaded Invalid Time Zone Card Not Found Invalid PIN Invalid Site Code Anti-Passback Violation Door Normal Door Forced Open Door Ajar Door Trouble Invalid Format Invalid Format, reverse read Door locked Issue code Duress request denied Never allowed at this door No second card presented Floor Called
Release 6.2
64
Event ID
731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 1001 1002 1003 1004
Description
Floor Selected Floor Select Timeout Free Egress, door not verified Free Egress, door not used Free Egress, door used Hard Anti-passback Violation Soft Anti-passback Violation Site Code Violation Duress PIN Entered Card Expired VIP Card Found Supervisor Card Found Supervisor Mode not Enabled Supervisor card required Supervisor Authenticated Soft Piggy-bagging Hard Piggy-bagging Supervisor mode Enabled Supervisor mode disabled Temporary card expired by usage limit Temporary card expired by Date Basic Panel Initialization ended Time Date sending ended Sending cards ended Sending Command Files Ended
Release 6.2
65
Event ID
1005 1006 1007 1008 1009 1101 1102 1103 1104 1105 1106
Description
Sending Holidays ended Sending Timezones ended Sending Inputs ended Sending Outputs ended Sending Groups ended NetAXS I/O Board Power Alarm NetAXS I/O Board Power Normal NetAXS I/O Board Tamper Alarm NetAXS I/O Board Tamper Normal NetAXS I/O Board Poll Response Alarm NetAXS I/O Board Poll Response Normal
GetDoorStatus2 Description Returns the physical status for the specified Door whether is it open or not. Visual C++ Signature
HRESULT GetStatus ( [in] long lReaderHID, [out] BOOL* bDoorStatus);
Note
The status of the Door in the interlock with a Group of Output as the Direct Point will be shown Door Opened always
Parameters Parameters
lHID
Description
The device ID of the door
Release 6.2
66
Parameters
bDoorStatus
Description
The output Boolean parameter that contains the status of the Door.
Return Type The HRESULT value is returned. The following table displays the return codes. Return Code
S_OK
Description
For a successful operation, the value zero is returned.
Remarks If the client calls the GetDoorStatus2 function by passing the parameters HID, the bDoorStatus is sent to the client and also the client is subscribed to the door status change notifications through the callback protocol. The following code is a sample of the information sent to the client.
<NLZ> <Door_IsOpen>DoorOpenStatus</Door_IsOpen> <Door_IsShunted>DoorShuntStatus</Door_IsShunted> <Door_ForcedOpen>DoorForcedOpenStatus</Door_ForcedOpen> <Door_Ajar>DoorAjarStatus</Door_Ajar> <ADV_Hid>ADVHID</ADV_Hid> <ADV_DeviceName>DeviceName</ADV_DeviceName> </NLZ>
Release 6.2
67
Chapter 3
Page Number
69 70
Release 6.2
68
Protocol Process
The client application initiates the connection to the WIN-PAK SE/PE by passing a reference using the InitServer(IDispatch* Caller, ) method. The server responds to the call using the GotMessage(sMessage) method to notify the client of any events. In addition, the server notifies the client about errors in the server using the method ServerErrors(sErrorMessage).
The procedural steps for comuunication between the ActiveX enabled client application and the server are as follows:
1
The client derives the IWPAVCallBack interface and implements its methods; the GotMessage() and ServerError() methods. The client calls the ACCW.MTSCBServer::InitServer method and passes the reference of the class that implements the IWPAVCallBack interface. The communication server wrapper ACCW.dll contains the compiled WIN-PAK SE/PE communication server APIs. These APIs act as the interface between the client and the communication server. The communication server collects the information about the events generated in the hardware panels. The ACCW.dll sends information about any events as a parameter in the GotMessage() method.
69 2012 Honeywell International
Release 6.2
Tag Descriptions
The notification message tags, and the information each tag contains is listed in the following table. Tags
<NLZ> </NLZ>
Description
Indicates the beginning of the message. Indicates the end of the message.
Release 6.2
70
Tags
<AckStatus>,</AckStatus>
Description
The status of the alarm. 0 indicates alarm is cleared. 1 indicates a new alarm. 2 indicates an acknowledged alarm.
<Idx>,</Idx>
Indicates if the message is an alarm or event. A value greater than 0 indicates an alarm. -1 indicates an event.
<TranID>,</TranID> <CommSrvID>,</CommSrvID>
For internal use. The identification number of the communication server that routes the alarm. If the user interface is configured to multiple communication servers, this tag identifies the communication server that has sent the alarm.
<DeviceID>,</DeviceID> <HID>,</HID>
The device ID can be a PanelID or a LoopID. The hardware device ID. HID is the unique identifier for the devices configured in the WIN-PAK SE/PE suite of products. The HID tag in the notification message helps to identify the origin of the event.
<Point>,</Point>
The point ID. Point is the ID of device locations for multipoint devices such as a panel.
Note
For a panel, the point ID is based on the panel type. <Prio>,</Prio> The event priority. Priorities are assigned to events and alarms. The WIN-PAK SE/PE acknowledges alarms, clears alarms, and performs many other functions based on the priority of the events. <Date>,</Date> <Time>,</Time> The date of the alarm/event. The time of the alarm/event.
Release 6.2
71
Tags
<Cnt>,</Cnt> <Oper>,</Oper>
Description
The number of occurrences of the same type of alarm or event. The WIN-PAK SE/PE operator. The operator is the person who acknowledges or clears the alarm/event.
<TranType>,</TranType>
The transaction type. The transaction type can be any of the following: Operator Note Alarm Ack Alarm Clr
Note
A new alarm does not have this tag in the notification message. <Note>,</Note> <Status>,</Status> Additional information added by an operator. The status of the alarm. The alarm status displays the reason for triggering of the alarm. EXAMPLE <Status>PrimaryPowerFailure </Status> <EventID>,</EventID> The ID of the event/alarm generated from the panel. The following is an example of an event that indicates Primary Power Failure. EXAMPLE < EventID >405</ EventID >
For more information on EventIDs, see Event Code List. <Site>,</Site> The site to which the device belongs. The WIN-PAK SE/PE operator logically groups the devices for easy monitoring/operating. These logical groups are called sites.
Release 6.2
72
Tags
<Account>,</Account>
Description
The name of the account. WIN-PAK SE/PE supports multiple accounts where the card and card holder information is partitioned.
The card number. The full name of the card holder. The reader/point is the source of the alarm. The sub device type ID. The field value is used for displaying alarms in the alarm window. TRUE (any value other than 0) indicates the alarm must be replaced with an existing alarm FALSE (a zero) indicates the alarm must not be replaced and must be appended to the UI
The status ID of the device. The device HID. The type of device. The name of the device.
Sample Code to Extract Information from the Notification Messages An example of the message that the server sends to a simple parser is as follows:
While (sInput <> "") sStr = GetStringFromTran(sInput) //Add sStr to Alarm/Event View using GetFieldFromTran(see GetStringFromTran) //... sInput = Mid(sInput, Len(sStr) + 1) lCntr = lCntr + 1 If lCntr > cMaxLoopCnt Then 'TODO... 'Error? '//Call MessageBox(0, "Internal Error: lCntr > cMaxLoopCnt. ", "", 0) End If Wend
Release 6.2
73
WIN-PAK SE/PE Communication Server API Public Function GetStringFromTran(sInTran As String) As String Dim lTmpB As Long Dim lTmpE As Long Dim sTmp As String On Error Resume Next
GetStringFromTran = "" lTmpB = InStr(sInTran, "<NLZ>") If lTmpB > 0 Then sTmp = Mid(sInTran, lTmpB) lTmpB = InStr(sTmp, "<NLZ>") lTmpE = InStr(sTmp, "</NLZ>") If lTmpE > 0 And (lTmpB < lTmpE) Then GetStringFromTran = "<NLZ>" + Mid(sTmp, lTmpB + Len("<NLZ>"), lTmpE - (lTmpB + Len("<NLZ>"))) + "</NLZ>" End If End If End Function
To get multiple parameters from the message string, you can use the following function.
Public Function GetFieldFromTran(sInTran As String, sFieldName As String) As String Dim lTmpB As Long Dim lTmpE As Long Dim sTmp As String On Error Resume Next GetFieldFromTran = "" lTmpB = InStr(sInTran, "<" + sFieldName + ">") If lTmpB > 0 Then sTmp = Mid(sInTran, lTmpB) lTmpB = InStr(sTmp, "<" + sFieldName + ">") lTmpE = InStr(sTmp, "</" + sFieldName + ">") If lTmpE > 0 And (lTmpB < lTmpE) Then GetFieldFromTran = Mid(sTmp, lTmpB + Len("<" + sFieldName + ">"), lTmpE (lTmpB + Len("<" + sFieldName + ">"))) End If End If End Function
Release 6.2
74
Inference
The source of the event is Pro2200 Reader 2.
Release 6.2
75
Example 2:
<NLZ> <AckStatus>2</AckStatus> <Idx>-1</Idx> <CommSrvID>1</CommSrvID> <Account>Test</Account> <DeviceID>3</DeviceID> <HID>31</HID> <Prio>20</Prio> <Date>2/16/2007</Date> <Time>14:47:02</Time> <Cnt>2</Cnt> <Oper>Admin</Oper> <TranType>Ack</TranType> <Note></Note> <Status>Door Ajar</Status> <EventID>721</EventID> <Point>1</Point> <Site>PW-5000 2200</Site> <RP>Loop 2 Panel 1 R2-Output</RP> </NLZ>
Release 6.2
76
Inference
The source of the alarm is Pro2200 Reader 2 and the device sub type is HID_ENTRANCE_PW5000_DOOR.
Example 4:
<NLZ> <AckStatus>2</AckStatus> <Idx>1</Idx> <TranID>1</TranID> <CommSrvID>1</CommSrvID> <Account>Test</Account> <DeviceID>3</DeviceID> <HID>31</HID> <Prio>20</Prio> <Date>2/16/2007</Date> <Time>14:47:02</Time> <Cnt>2</Cnt> <Oper>Admin</Oper> <TranType>Ack</TranType> <Note></Note> <Status>Door Ajar</Status> <EventID>721</EventID> <HIDSubType1>43</HIDSubType1> <Point>1</Point>
The source of the alarm is Loop 2 Panel 1 R2-Output and the device sub type is HID_OUTPUT_PW5000.
Release 6.2
77
Message String
<Site>PW-5000 2200</Site> <RP>Loop 2 Panel 1 R2-Output</RP> </NLZ>
Inference
Note
Using the Idx tag you can differentiate an alarm or an event notification message. A positive value in the Idx tag indicates an alarm. However, a -1 in the Idx tag indicates an event.
Inference
The source of the event is from Input 4 of the N1000 panel.
Release 6.2
78
Message String
Example 6:
<NLZ> <AckStatus>2</AckStatus> <Idx>-1</Idx> <CommSrvID>1</CommSrvID> <Account>Test</Account> <DeviceID>4</DeviceID> <HID>52</HID> <Prio>20</Prio> <Date>2/16/2007</Date> <Time>14:48:01</Time> <Cnt>1</Cnt> <Oper>Admin</Oper> <TranType>Ack</TranType> <Note></Note> <Status>Input Alarm</Status> <EventID>501</EventID> <Point>4</Point> <Site>PW-5000</Site> <RP>N1000 In4</RP> </NLZ>
Inference
The source of the event is from Input 4 of the N1000 panel.
Inference
The source of the alarm is from Input 4 of the N1000 panel and the device sub type is HID_INPUT_PW5000_SUPER.
Release 6.2
79
Message String
<Site>PW-5000</Site> <RP>N1000 In4</RP> </NLZ>
Inference
Example 8:
<NLZ> <AckStatus>2</AckStatus> <Idx>1</Idx> <TransID>1</TransID> <CommSrvID>1</CommSrvID> <Account>Test</Account> <DeviceID>4</DeviceID> <HID>52</HID> <Prio>20</Prio> <Date>2/16/2007</Date> <Time>22:48:01</Time> <Cnt>1</Cnt> <Oper>Admin</Oper> <TranType>Ack</TranType> <Note></Note> <Status>Input Alarm</Status> <EventID>501</EventID> <HIDSubType1>34</HIDSubType1> <Point>4</Point> <Site>PW-5000</Site> <RP>N1000 In4</RP> </NLZ>
The source of the alarm is from Input 4 of the N1000 panel and the device sub type is HID_INPUT_PW5000_SUPER.
Release 6.2
80
Inference
The source of the event is from the PW-5000 panel.
Release 6.2
81
Panel Alarm
Message String
Example 10:
<NLZ> <AckStatus>2</AckStatus> <Idx>1</Idx> <TransID>1</TransID> <CommSrvID>1</CommSrvID> <Account>Test</Account> <DeviceID>3</DeviceID> <HID>38</HID> <Prio>10</Prio> <Date>2/16/2007</Date> <Time>22:47:07</Time> <Cnt>1</Cnt> <Oper>Admin</Oper> <TranType>Ack</TranType> <Note></Note> <Status>PollResponseNormal</Status> <EventID>408</EventID> <HIDSubType1>29</HIDSubType1> <Point>0</Point> <Site>PW-5000</Site> <RP>PW-5000</RP> </NLZ>
Inference
The source of the alarm is from the PW-5000 panel.
Note
The zero value in the Point tag indicates that the panel is the source of the alarm/event.
Inference
The status of the abstract device is Loop OK.
Release 6.2
82
Message String
Example 12:
<NLZ> <ADV_Status>803</ADV_Status> <ADV_Hid>43</ADV_Hid> <ADV_DeviceType>3</ADV_DeviceType> <ADV_DeviceName>SchServer</ADV_DeviceName> </NLZ>
Inference
The status of the abstract device is Loop OK.
Inference
The Communication Server 1 lost connection.
Release 6.2
83
Inference
The Communication Server 1 regained the lost connection.
Inference
The Database Server 1 lost connection.
Inference
The Database Server 1 regained the lost connection.
Release 6.2
84
Glossary
Abstract Device A logical representation of a physical device. The ADVs can be associated with any hardware device, including communication interfaces, panels, alarm points and entrances. A functional unit that permits a common path to handle more data sources than the channels currently available within the path. A concentrator usually provides communication capability between many low-speed, usually asynchronous channels and one or more highspeed, usually synchronous channels. Usually different speeds, codes, and protocols can be accommodated on the low-speed side. The low-speed channels usually operate in contention and require buffering. The location of the peripheral device connected to the control panel. The pulse time is the amount of time the output point is energized when triggered. A peripheral device connected to the control panel that reads and sends the card information to the control panel. Input points or Alarm points have software states of UNSHUNTED (active) and SHUNTED (not active). When an input is unshunted, all physical changes of state (openings and closures) are recognized. When an input is shunted, physical changes of state are not recognized.
Concentrator
Release 6.2
85
Index
A
Abstract Devices Status Definitions ................. 59 ACCW.dll .................................................. 38, 69 AckAlarm ........................................................40 AddNote.........................................................41 AlarmShuntByHID ........................................... 43 AlarmUnShuntByHID ...................................... 44
Panel Alarm ...................................................... 82 Panel Event ....................................................... 81 Reader and Output Alarms ................................ 77 Reader and Output Events ................................. 75 Schedule Server Status ...................................... 83
B
BufferByHID ................................................... 46
Communication Server Lost Connection ............. 83 Communication Server Regained Connection ..... 84 Database Server Lost Connection....................... 84 Database Server Regained Connection ............... 84
G
GetDetailsByID............................................... 42 GetStatus...................................... 54, 56, 58, 66 GotMessage.............................................. 69, 70
C
CallBack Protocol ............................................ 68 Card Properties .............................................. 28
CardNumber(get).. 28, 29, 30, 31, 32, 33, 34, 35, 36 CardNumber(put) 28, 29, 30, 31, 32, 33, 34, 35, 36, 37
I
InitServer .................................................. 38, 69 Installing ........................................................ 12 IWPAVCallBack .............................................. 69
CommunicationAPIClient ................................... 16 CommunicationAPIServer .................................. 12
ClrAlarm .........................................................40 Communication Server API Functionalities ..... 38 Component Model Diagram............................ 11 Connecting API Client and Server .................... 21
D
Data Structures............................................... 24
Device ............................................................... 24 Enumeration Types ............................................ 24
L
ListConnectedDevices .................................... 48
DeEnergize ...................49, 50, 51, 52, 53, 54, 55 DoneServer .................................................... 39 DoorModeByHID ............................................ 48
N
Notification Message
Tag Descriptions ................................................ 70 Tags .................................................................. 70
E
Energize .........................................................49 EntryPointLockByID ........................................ 42 EntryPointUnLockByID .................................... 43 Enumeration Types
HIDSubType1 ............................................... 25, 26 HIDType............................................................. 25 wpviewTYPE ...................................................... 24
O
Object Specifications...................................... 27
P
PulseByHID .................................................... 44
R
RestoreTZByHID ............................................. 45
Description ........................................................ 61 Device Status ..................................................... 82 Input Alarm ....................................................... 79 Input Event ........................................................ 78
S
ServerErrors................................................... 69
Release 6.2
86
T
Tag Descriptions ............................................. 70
<Account> ......................................................... 73 <AckStatus>....................................................... 71 <ADV_DeviceName> .......................................... 73 <ADV_DeviceType>............................................ 73 <ADV_HID>........................................................ 73 <ADV_Status>.................................................... 73 <CardNumber> .................................................. 73 <Cnt> ................................................................ 72 <CommSrvID> .................................................... 71 <Date> .............................................................. 71 <DeviceID> ........................................................ 71 <EventID> .......................................................... 72 <FullName> ....................................................... 73 <HID> ................................................................ 71
TimedPulseByHID........................................... 44
U
UnBufferByHID .............................................. 47
Release 6.2
87
Honeywell Access Systems 135 West Forest Hill Avenue Oak Creek, WI 53154 U.S.A Tel: 800-323-4576 Fax: 414-766-1798
Office Hours: 7 AM to 7 PM (CST) E-mail: [email protected] URL: http://www.honeywellaccess.com
Honeywell Access Systems Charles Avenue, Burgess Hill West Sussex, RH15 9UF U.K Tel: +44 (0)1444 251180 Fax: +44 (0)1444 871074
Specifications subject to change without notice. 2012 Honeywell International. All rights reserved.