Warsaw 07.12.2012



BACnet_ESSER VER. 1.5

MANUAL












Mrowcza 243, IV pietro

04-697 Warszawa

tel.: (+48 22) 213-92-69

tel./fax: (+48 22) 615-89-84

e-mail: tiger-soft@tiger-soft.com.pl

www: www.tiger-soft.com.pl






Table of contents

1) Introduction
2) Installing the I/O driver
3) Software registration
4) Configuring the BACnet_ESSER
5) Configuring a BMS
6) Starting and stopping the BACnet_ESSER






1) Introduction

    The BACnet_ESSER ver. 1.5 is a communication driver which allows to connect BMS system with a fire protection system from ESSER. The driver may be connected to a ESSER central unit with the help of the computer serial essernet interface (SEI) and the Esser Data Protocol (EDP). The interface for a BMS system is built on BACnet/IP standard (ISO 16484-5:2003).

Bacnet_ESSER includes the following features:

  1. Very effective method of communication which uses EDP protocol.
  2. Works as a service. It works even after logging out from the system.
  3. Supports all main events which exist in ESSER.
  4. Multithreading which allows to do tasks in a very efficient way, without a heavy load of the processor.
  5. Very effective connection to a BMS system using BAcnet/IP.
  6. Easy to use configuration.
  7. Monitoring of the communication process.
  8. Automatically re-running the communication after failure.


2) Installing the I/O driver

Run BACnet_ESSER_INSTALL.EXE.Installation software will put BACnet_ESSER files into the C:\Program Files\TIGER_SOFT\BACnet_ESSER_1_5 directory or another directory chosen by the user. Shortcuts to the manual and registration software exist in the group BACnet_ESSER ver. 1.5 (access from the Start menu). The driver is installed as a service.



3)Software registration

BACnet_ESSER should be registered after installation using TIGER-SOFT internet service. SOFTWARE REGISTRATION from BACnet_ESSER group should be started first. This program generates file gen_lic.lic and saves it in the main driver directory. Then you have to connect to
http://www.tiger-soft.com.pl/Registration/registration.html, fill the form and receive the registration code. This code should be put to the editable field in the SOFTWARE REGISTRATION. Press OK to finish registration process.



4)Configuring the BACnet_ESSER

The file - Configuration.cbe is used for the driver configuration. It exists in the same directory like the BACnet_ESSER.exe. An example of the file is presented below.

# BACnet_ESSER - configuration file

# COM parameters
# NR_COM from the range 1-99
# BAUD_RATE [bits/s]. Possible values: 9600,14400,19200,38400,57600

NR_COM=1
BAUD_RATE=19200

# *****BACnet*****
# DEVICE_ID is a BACnet device number.
# EVC is an Event Class number.
# LOCAL_IP is a local ip address.
# LOCAL_PORT is used by the driver for communication with a BMS system.
# DESTINATION_PORT - it is a port of computers in a network, dedicated for the BACnet. Default is 47808.
# BACnet_TIMEOUT[s] - Timeout for the BACnet communication process. Possible values from the range 1-9999 [s].
# NOTIFICATION_PROCESS_ID - identification of the process in the receiving device for which the notification is intended.
# NOTIFICATION_PRIORITY_ALARM or FAULT - notifications priorities for sending an alarm or an fault notifications.
# NOTIFICATION_PRIORITY_NORMAL is used for an acknowledge notification after user confirmation of an alarm or a fault.
# NOTIFICATION_RECIPIENT_UDP - Notification recipient ip number for UDP client.
# ROUTER - router (UDP->ETHERNET) ip
# DNET - Local Network Number set in the router
# NOTIFICATION_RECIPIENT_ETHERNET - Notification recipient MAC number for ETHERNET client.

DEVICE_ID=1212
EVC=12
LOCAL_IP=10.10.1.100
LOCAL_PORT=47808
DESTINATION_PORT=47808
BACnet_TIMEOUT=60
NOTIFICATION_PROCESS_ID=0
NOTIFICATION_PRIORITY_ALARM=100
NOTIFICATION_PRIORITY_FAULT=120
NOTIFICATION_PRIORITY_NORMAL=150
#NOTIFICATION_RECIPIENT_UDP=10.10.1.100
ROUTER=10.10.1.134
DNET=10001
NOTIFICATION_RECIPIENT_ETHERNET=00:16:b6:90:f1:91
NOTIFICATION_RECIPIENT_ETHERNET=00:07:E9:B0:7C:70

# Points
# The list of points, which should be read from a ESSER, configured in the following format:
# Ttt$gg$ee$A[al{ALARM TEXT}%al{ALARM TEXT}...]$F[f{FAULT TEXT}%f{FAULT TEXT}...]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV
# ,where tt-type(1-8), gg-group, ee-address of an element
# al - value of a point that should be notified by the system like an alarm,
# f - value of a point that should be notified by the system like a fault,
# ALARM TEXT,FAULT TEXT,NORMAL TEXT - texts which are used by a notification message.
# DESCRIPTION TEXT - description of a point
# MV Number of Multi-state value object(2-999999)


COMMUNICATION$A[{ESSER COMMUNICATION ALARM}]$N[{ESSER COMMUNICATION NORMAL}]$D[ESSER COMMUNICATION STATUS]$1
T1$1$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 1]$2
T1$2$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 2]$3
T1$3$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 3]$4
T1$4$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 4]$5
T1$5$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 5]$6
T1$6$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 6]$7
T1$7$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 7]$8
T1$8$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 8]$9
T1$9$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 9]$10
T1$10$0$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 10]$11
T1$1$1$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 1 ELEMENT 1]$12
T1$1$2$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 1 ELEMENT 2]$13
T1$1$3$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 1 ELEMENT 3]$14
T1$2$1$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 2 ELEMENT 1]$15
T1$2$2$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 2 ELEMENT 2]$16
T1$2$3$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 2 ELEMENT 3]$17
T1$3$1$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 3 ELEMENT 1]$18
T1$1110$1$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 1110 ELEMENT 1]$19
T2$1$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 1]$21
T2$11$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 11]$22
T2$12$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 12]$23
T2$13$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 13]$24
T2$14$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 14]$25
T2$15$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 15]$26
T2$16$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 16]$27
T2$58$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 58]$28
T2$59$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 59]$29
T2$63$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 63]$30
T3$256$0$A[2{ALARM 2}]$F[5{FAULT 5}]$N[{NORMAL}]$D[LINE 256]$41
T4$0$0$A[]$F[2{FAULT 2}%5{FAULT 5}]$N[{NORMAL}]$D[PANEL]$42
T5$1$0$A[]$F[3{FAULT 3}]$N[{NORMAL}]$D[ACOUSTIC]$43
T6$1$0$A[]$F[3{FAULT 3}]$N[{NORMAL}]$D[UE]$44
T7$1$0$D[CONNECT/DISCONNECT GROUP 1]$101
T7$2$0$D[CONNECT/DISCONNECT GROUP 2]$102
T7$3$0$D[CONNECT/DISCONNECT GROUP 3]$103
T7$4$0$D[CONNECT/DISCONNECT GROUP 4]$104
T7$5$0$D[CONNECT/DISCONNECT GROUP 5]$105
T7$6$0$D[CONNECT/DISCONNECT GROUP 6]$106
T7$7$0$D[CONNECT/DISCONNECT GROUP 7]$107
T7$8$0$D[CONNECT/DISCONNECT GROUP 8]$108
T7$9$0$D[CONNECT/DISCONNECT GROUP 9]$109
T7$10$0$D[CONNECT/DISCONNECT GROUP 10]$110
T7$1$1$D[CONNECT/DISCONNECT GROUP 1 ELEMENT 1]$111
T7$1$2$D[CONNECT/DISCONNECT GROUP 1 ELEMENT 2]$112
T7$1$3$D[CONNECT/DISCONNECT GROUP 1 ELEMENT 3]$113
T7$2$1$D[CONNECT/DISCONNECT GROUP 2 ELEMENT 1]$114
T7$2$2$D[CONNECT/DISCONNECT GROUP 2 ELEMENT 2]$115
T7$2$3$D[CONNECT/DISCONNECT GROUP 2 ELEMENT 3]$116
T7$3$1$D[CONNECT/DISCONNECT GROUP 3 ELEMENT 1]$117
T8$1$0$D[COMMAND TO A PANEL]$201

 

5)Configuring a BMS system.

Communication with a BMS system uses BACnet/IP. Every software that can use data sent via BACnet/IP should work fine with the BACnet_ESSER. The BACnet_ESSER appears in the network as a device configured in Configuration.cbs (DEVICE_ID). It uses a local ip address(LOCAL_IP) and a port defined in LOCAL_PORT. All alarms and faults notifications will be sent to defined UDP recipients (DESTINATION_PORT,NOTIFICATION_RECIPIENT_UDP,NOTIFICATION_PROCESS_ID) and to ETHERNET recipients via BACnet router (ROUTER, DNET, NOTIFICATION_RECIPIENT_ETHERNET) by the EVC object. Every point should be visible in a BMS like Multi-state Value or Output object.
It is possible to use the driver and a BMS system on one computer with one network card. Two ip addresses should be assigned to this ethernet card, for example 10.10.1.121 and 10.10.1.122. One is used by a driver and should be put into Configuratio.cbs (LOCAL_IP). The second one should be used by a BMS system. The driver and a BMS system should use the same port, for example 47808.
Additionally, one notification class exists (EVC), called TS-ES-NC, which deals with notifications. COMMUNICATION point gives information about communication status between the driver and a ESSER central unit. There are following, possible points:

ItemID

Description

Addresses

Returned values

COMMUNICATION$A[{ALARM TEXT}]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV

Presents the status of the communication between the BACnet_ESSER and ESSER central unit.

Value 2 means that communication is OK, 1 there is no communication.
T1$gg$ee$A[al{ALARM TEXT}%al{ALARM TEXT}...]$F[f{FAULT TEXT}%f{FAULT TEXT}...]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV

Shows the status of a point or a zone (if ee=0), where gg-address of a zone(1-9999), ee-address of a point(0-31), al - value of a point that should be notified by the system like alarm, f - value of a point that should be notified by the system like fault

Example: T1$1$1$A[2{ALARM 2}%3{ALARM 3}]$F[5{FAULT 5}]$N[{NORMAL}]$D[GROUP 1 ELEMENT 1]$12, reads information about the status of the point 1 from group 1. States 2,3 will be notified by the system like alarms and state 5 will be notified by the system like fault

gg
1-9999 - address of a zone
ee
0-31 - address of a point

status

1 - Normal

2 - Fire

3 - Alarm (PRE-ALARM,ZMA,ZGA,TEST-ALARM)

4 - Fault (FAULT,TEST-FAULT)

5 - Disconnection

6 - Active

7 - Tal

T2$gg$0$A[al{ALARM TEXT}%al{ALARM TEXT}...]$F[f{FAULT TEXT}%f{FAULT TEXT}...]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV

Shows the status of an output, where gg-address of an output(1-9999), al - value of an output that should be notified by the system like alarm, f - value of an output that should be notified by the system like fault

Example: T2$11$0$A[]$F[5{FAULT 5}]$N[{NORMAL}]$D[OUTPUT 11]$22, reads information about the status of the output 11. state 5 will be notified by the system like fault

gg
1-9999 - address of an output

status

1 - Normal

2 - Activation

3 - Block

4 - Fault

5 - Disconnection

T3$gg$0$A[al{ALARM TEXT}%al{ALARM TEXT}...]$F[f{FAULT TEXT}%f{FAULT TEXT}...]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV

Shows the status of a line, where gg-address of a line(1-65535), al - value of a line that should be notified by the system like alarm, f - value of a line that should be notified by the system like fault

Example: T3$256$0$A[2{ALARM 2}]$F[5{FAULT 5}]$N[{NORMAL}]$D[LINE 256]$41, reads information about the status of the line 256 (0x0100 HEX). state 5 will be notified by the system like fault

gg
1-65535 - address of a line

status

1 - Normal

2 - Fire

4 - Fault

5 - Disconnection

6 - Switch on phase

7 - Detector exchange

T4$gg$0$A[al{ALARM TEXT}%al{ALARM TEXT}...]$F[f{FAULT TEXT}%f{FAULT TEXT}...]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV

Shows the status of a panel, where gg-address of a panel(0-32), al - value of a panel that should be notified by the system like alarm, f - value of a panel that should be notified by the system like fault

Example: T4$0$0$A[]$F[2{FAULT 2}%5{FAULT 5}]$N[{NORMAL}]$D[PANEL]$42, reads information about the status of the panel 0. States 2,5 will be notified by the system like faults.

gg
0-32 - address of a panel

status

1 - Normal

2 - CPU (CPU Failure)

3 - Cover (Cover open)

4 - Fault (Battery,Network,Ground,Power supply,Printer)

5 - Delayed (Delayed is running)

6 - Detection (Detection is running)

7 - Revision (Revision active)

T5$gg$0$A[al{ALARM TEXT}%al{ALARM TEXT}...]$F[f{FAULT TEXT}%f{FAULT TEXT}...]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV

Shows the status of an acoustic signalling device, where gg-address of a device(0-32), al - value of point that should be notified by the system like alarm, f - value of point that should be notified by the system like fault

Example: T5$1$0$A[]$F[3{FAULT 3}]$N[{NORMAL}]$D[ACOUSTIC]$43, reads information about the status of the device 1. State 3 will be notified by the system like fault.

pp
0-32 - address of a device

status

1 - Normal

2 - Off

3 - Trouble

T6$gg$0$A[al{ALARM TEXT}%al{ALARM TEXT}...]$F[f{FAULT TEXT}%f{FAULT TEXT}...]$N[{NORMAL TEXT}]$D[DESCRIPTION TEXT]$MV

Shows the status of a UE, where gg-address of a UE(0-32), al - value of a UE that should be notified by the system like alarm, f - value of a UE that should be notified by the system like fault

Example: T6$1$0$A[]$F[3{FAULT 3}]$N[{NORMAL}]$D[UE]$44, reads information about the status of the UE 1. State 3 will be notified by the system like fault.

pp
0-32 - address of a UE

status

1 - Normal

2 - Off

3 - Trouble

T7$gg$ee$D[DESCRIPTION TEXT]$MV

Allows to connect/disconnect a point or a zone (if ee=0), where gg-address of a zone(1-9999), ee-address of a point(0-31).

Example: Writing 2 to the point T7$1$1$D[CONNECT/DISCONNECT GROUP 1 ELEMENT 1]$111, you can disconnect point 1 from group 1.

gg
1-9999 - address of a zone
ee
0-31 - address of a point

Command (output)

1 - IDLE

2 - DISCONNECT

3 - CONNECT

T8$gg$0$D[DESCRIPTION TEXT]$MV

Allows to send a command to a panel, where gg-address of a panel(1-32).

Example: Writing 2 to the point T8$1$0$D[COMMAND TO A PANEL]$201, you can reset all fires from the panel 1

gg
1-32 - address of a panel

Command (output)

1 - IDLE

2 - RESET FIRES

3 - SOUNDERS OFF

4 - SOUNDERS ON

3 - BUZZER OFF

 

The image below presents a sample screen from Delta Orca BMS system in the case of an alarm (Img. 1).


Img. 1


There is one device object called BACnet-ESSER, one Multi-state value COMMUNICATION point, which shows the status of communication with ESSER central unit and many additional multi-state values, which show statuses of points.

Each alarm or fault is notified by the notification class TS-ES-NC. Such notification appears in the Orca as a window shown in Img. 2. This is an example of alarm for element number 3 from group 1.


Img. 2


Alarms are logged by alarm object on the main station or by historian software.

Img. 3 presents the example of Multi-State Output object, sending Connect command to GROUP 4.


Img. 3



 

6) Starting and stopping the BACnet_ESSER

The driver can be run from the service manager on Windows NT/2000/2008//XP/Vista/7. Second way is to use command line with commands: BACnet_ESSER -s for starting and BACnet_ESSER -z, for stopping it. The service BACnet_ESSER can be also configured to start automatically after operating system is started.