Embedding and Configuring the Object Library

For the use of any functions of the WinCC OA BACnet Application, the prior configuration and the embedding of the Standard Object Library (Stdlib_<version_number>), as well of the BACnet Object Library (BACnet_<version_number>) into an existing WinCC OA project is required. This can be performed in four steps, which are described in the following.

Embedding the Object Library

Embed the BACnet Object Library and the Standard Object Library into an existing WinCC OA project ( WinCC OA Project Administration -> Change project properties -> Integrate subproject).

Note: The order in which the subprojects are added is important and the Stdlib must be above the BACnet library in the config file. The order in the subproject integration panel is the opposite!

Configuration

Configuring prefix for alarm acknowledgement

Copy the section with the config entry

[driver]
driverAckClassPrefix = "BACnet"

from the config.level file of the WinCC OA installation directory \BACnet_<version>\config to the config file (\config) of your WinCC OA project.

Important: The config entry [driver] driverAckClassPrefix is read by the UI, as it changes the acknowledging behavior of the user interface, therefore the con fig entry must be set for all UI clients.

BACnet alarms might require external acknowledgement, which means that the acknowledgement is not done directly in WinCC OA. Instead an alarm acknowledgement is sent to the device, which returns if the alarm is successful acknowledged. For that purpose it must be defined which alerts are to be acknowledged via this external mechanism. This is done by defining an alert class prefix for all alarms, which require acknowledgement via driver.

Thereby all alerts, whose alert classes contain this prefix are not acknowledged by the event manager, but by the driver (the acknowledgement is received from the PLC). Of course, the prefix can be changed at will.

Configuring connection

Before starting the WinCC OA project, the connection of the BACnet driver to the BACnet network must be configured. This is done by setting the mandatory "net" config entry.

The "net" config entry has the following syntax and has to be entered in the [bacnet] section:

net = <Network> ”IP” <IPAddress> <Subnetmask> <UDPPort> <BBMDAddress> <BBMDMaxForeignDevices> <ForeignDeviceHoldingTime>

For a detailed meaning of the particular parameters, see WinCC OA Online Help (Drivers/BACnet/BACnet driver config file).

Example

[bacnet]
net = 1 "IP" "" "" 47808 "" 0 120

Start Project

The BACnet driver manager must be added to the manager list.

Important: Ensure that the WCCOAsim Manger is not running!
WCCOAbacnet -num 1

Now the project can be started.

Importing Data point Lists

The datapoint lists of the Standard Object Library and of the BACnet Object Library have to be imported using the ASCII Manager.

  1. Open the ASCII Manager panel via the WinCC OA System Management (Database -> ASCII Manager).
  2. Import the required datapoint lists. The order must comply with:
    • stdlib.dpl from the < wincc_oa_path>\Stdlib_<version>\dplist\ subproject
    • BACnet_All.dpl from the < wincc_oa_path>\BACnet_<version>\dplist\ subproject