Polling Data from a BACNET/IP device · Configuring the IO Server Main Settings Parameters Description eWON BACNET Device ID This number must be unique in your BACNET network. Type

support.ewon.biz

Polling Data from a BACNET/IP device

How to use the BACNET IO Server to poll data from a BACNET/IP device

Application User Guide

AUG 071 / Rev. 1.2

Table of Contents

1. Objective .......................................................................................................................... 3

2. Hardware requirements ................................................................................................... 4

3. Software requirements ..................................................................................................... 5Software configuration: ......................................................................................................................... 5Firmware Version ..................................................................................................................................... 5

4. Protocol compatibility ...................................................................................................... 6

5. Configuring the IO Server ............................................................................................... 7Main Settings ........................................................................................................................................... 8Topic Settings ........................................................................................................................................... 8

6. Tag Creation ..................................................................................................................... 9Object Type ........................................................................................................................................... 11Instance Number .................................................................................................................................. 11Property of the object ......................................................................................................................... 12

7. Example of configuration .............................................................................................. 13

Revision .............................................................................................................................. 15Revision History ...................................................................................................................................... 15

Page 2 / 15 Polling Data from a BACNET/IP device | AUG 071

Chapter 1Objective

1. ObjectiveThe objective of this document is to explain how the eWON Flexy can poll data variables out of one or more BACNET/IP devices.

Polling BACNET/IP data variables can be resumed in four steps :

• Linking the eWON Flexy with the BACNET/IP Device

• Configuring the eWON Flexy BACNET IO Server

• Creating tags in the eWON Flexy

• Monitoring tags

- Note -

Advanced explanations are indicated by this icon


Chapter 2Hardware requirements

2. Hardware requirementsIn order to follow this guide you'll need:

• An eWON Flexy

• A PC to connect the eWON Flexy through its web interface

• A device acting as a BACNET/IP Server


Chapter

3. Software requirements

Software configuration:The eWON Flexy is configured through its web interface. Which is accessible with anymodern web browser as shown here below:

• Firefox 15+

• Chrome 16+

• Safari 6+

• Edge 13+

• IE 11

Additionally, we suggest you to download the eBuddy companion tool available onour website : http://support.ewon.biz/

This tool allows you to list all the eWON Flexy on your network and execute changes such as IP address change, firmware upgrade or device recovery (if required).

Firmware VersionThis guide targets devices running a firmware version 12.2 or higher.


http://support.ewon.biz/

Chapter 3Software requirements

4. Protocol compatibilityThe eWON Flexy supports the BACNET/IP protocol (based on UDP/IP) to poll data from devices acting as BACNET/IP Servers.


Chapter 5Configuring the IO Server

5. Configuring the IO Server • Connect your PC to one of the LAN ports of the eWON Flexy

• Open the web browser and enter the IP address of the eWON Flexy

• Log into the eWON Flexy web interface

• Go to Tags menu on the left hand side

• Click on the IO Servers option and a supplementary menu will be displayed

• Select the IO Server “Bacnet” inside the IO Server list

• Additionally, there is an address helper feature that turns green when the address is correct and red the address is wrong


Chapter 5Configuring the IO Server

Main Settings

Parameters Description

eWON BACNET Device ID

This number must be unique in your BACNET network.

Type the BACNET device ID of the eWON Flexy or leaveit blank to let the eWON Flexy choose a device ID.

eWON BACNET PortSelect the UDP port used for the BACNET IP communication.

To poll data registers out of your BACNET device, you need to define at least one Topic. Topics are meant to allocate common properties to a group of tags

The topic settings (except the Poll Rate) are optional and can be defined in the Tag address as well. This allows you to poll more than 3 BACNET devices. Leave them blank if you define them in the Tag address.

Topic Settings

Parameters DescriptionDevice ID Type the device ID of the device to poll. There is no IP

address to define for the device as the BACNET IP protocol can detect the BACNET devices on the network using an UDP Broadcast packet. Note that the IP address of the BACNET device must still be in the same range as the eWON Flexy IP address

Poll rate Type the poll rate for this topic (in milliseconds). Default : 2000 ms

Write Priority Type a write priority value. (0 or blank : no priority defined, 1 : highest priority, 16 : lowest priority)


Chapter 6Tag Creation

6. Tag Creation• On the left hand menu, please select the option Value under the Tags menu

• Switch to Setup MODE

• Click on Add (+)

• Once the create a new Tag window opens proceed to enter the parameters of the Tag you want to create.

• Enter a Tag Name – free text, no spaces, no symbols, -, =, %, $, @, # etc

• Select Topic Name the topic you just created in previous step

Define the address of the Tag, the address of the Tag is composed of four parameters :

• Object Type (mandatory)

• Instance Number (mandatory)

• Property of the object (optional. If not defined, the property “Present Value” isused)

• Device ID (optional if defined in the topic settings)





Object TypeHere is the list of the supported object types :

Object Type Tag type ???ANALOG_INPUT (0) Analog Input

ANALOG_OUTPUT (1) Analog Output

ANALOG_VALUE (2) Analog Value

BINARY_INPUT (3) Binary Input

BINARY_OUTPUT (4) Binary Output

BINARY_VALUE (5) Binary Value

INTEGER_VALUE (45) Integer Value

POSITIVE_INTEGER_VALUE (48) Positive Integer Value

ACCUMULATOR Accumulator Value

Instance NumberThe instance number defines the ID of the object you want to access to.



Property of the objectAn object is composed of different properties. These properties can be accessed through different Tags. You have therefore to define which property you want to access for your Tag. If no property is defined, the property “PRESENT_VALUE” is used.

Here is the list of the property you have access to :

Value DescriptionPRESENT_VALUE (85) Present Value

OUT_OF_SERVICE (81) Out of Service

COV_INCREMENT (22) Cov Increment

DEADBAND (25) Deadband

HIGH_LIMIT (45) High Limit

LOW_LIMIT (5) Low Limit

Any numerical ID Numerical ID



7. Example of configurationFor this example, I used the BACNET IP Device simulator from “SCADA Engine” http://www.scadaengine.com/downloads.html

Device configuration :


http://www.scadaengine.com/downloads.html

Chapter 7Example of configuration


Revision Information

Revision

Revision History

Revision Level Date Description

1.0 26/01/17 Initial Version

1.2 06/07/18 New GUI

Document build number: 38

Note concerning the warranty and the rights of ownership:

The information contained in this document is subject to modification without notice. Check https://ewon.biz/support for the latest documents releases.

The vendor and the authors of this manual are not liable for the errors it may contain, nor for their eventual consequences.

No liability or warranty, explicit or implicit, is made concerning the quality, the accuracy and the correctness of the information contained in this document. In no case can the manufacturer's responsibility be implied for direct, indirect, accidental or other damage occurring from any defect of the product or mistakes coming from this document.

The product names are mentioned in this manual for information purposes only. The trade marks and the product names or marks contained in this document are the property of their respective owners.

This document contains materials protected by the International Copyright Laws. All reproduction rights are reserved. No part of this handbook can be reproduced, transmitted or copied in any way without written consent from the manufacturer and/or the authors of this handbook.

HMS Industrial Networks


Documents

Polling Data from a BACNET/IP device · Configuring the IO Server Main Settings Parameters Description eWON BACNET Device ID This number must be unique in your BACNET network. Type