Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


...

Info
titleFile location

<WorkspaceDirectory>\DataFiles\xio.BACnet.ObjectDefinitions.dat

The BACnet interface provides the opportunity to read and write BACnet Objects and their BACnet Properties.

The structure of the BACnet object definition file is as follows:

Code Block
' BACnet object configuration file
' DeviceId;ObjectId;ObjectType;ObjectName;WritePriority;PollingInterval;Persistent;Historical;Synchronize;COVType
257653;0;Binary Input;BINARY_INPUT_0;15;5000;F;F;F
257653;0;Binary Output;BINARY_OUTPUT_0;15;5000;F;T;F
2098178;1;Analog Input;B'AI1;15;5000;F;T;F
2098178;1;Analog Output;B'AO1;15;5000;F;F;F
2098178;1;Analog Value;B'AVAL1;15;5000;F;F;F
2098178;1;Binary Value;B'BVAL1;15;5000;F;F;F
2098178;2;Accumulator;B'ACC1;15;5000;F;F;F
2098178;2;Pulse Converter;B'PC1;15;5000;F;F;F
2098178;1;Multi-State Input;B'MSI1;15;5000;F;F;F
2098178;1;Multi-State Output;B'16;15;5000;F;F;F
2098178;1;Multi-State Value;B'17;15;5000;F;F;F

...

.

Info

The BACnet object definitions within this file can automatically be set by using the BACnetExplorer. Therefore, editing it manually is not necessary in general.

The structure of the BACnet object definition file is as follows:

Col#ParameterDescriptionScopeUnitDefault
1DeviceIdThe BACnet Device ID of the device which holds the BACnet Object. This name must match the device ID used in the BACnet device configuration.


2ObjectIdThis parameter refers to the BACnet Object ID of the defined object.


3ObjectTypeThis attribute defines the BACnet Object type.BACnet Object type

4ObjectNameThis identifier specifies the BACnet Object Name of the BACnet Object.


5WritePriorityHere, the default write priority de- fined in the BACnet configuration file can be overwritten for each individual object. If not specified, the default write priority is used. As an alternative, a list of write priorities (separated by ",") can be specified, too. For each defined write priority, the server creates two additional server item – one for writing the datapoint value with the specified priority and one for resetting the priority again. Using this mechanism, multiple BACnet priorities can be used at the same time.

16
6PollingIntervalIf the object does not support Change of Value (COV) subscription, this parameter defines the interval
(in ms)
which is used to poll the object's present value.
"'0"'
A value of 0 deactivates polling for this object.
ms5000
7PersistentThis parameter specifies whether the value of the datapoint is persistent (restored from the database after server start up ) or not.
8HistoricalThis parameter specifies whether historical values of the datapoint are stored within the database or not.


F
9SynchronizeIf this parameter is set to "T", the value is synchronized between the main and backup server (if present). This will work only if synchronize is enabled in the NMESH configuration of the NETx BMS Core Server.

T
10COV Type
This parameter specified

Specifies the type of COV subscription that shall be used for the given object.

"'

  • Unconfirmed
"'
  • : uses unconfirmed COV subscription
, "'Confirmed"'
  • Confirmed: uses confirmed COV subscription
, and "'Disabled"'
  • Disabled: deactivates COV subscription at all
. The default value (emtpy value) is "'Unconfirmed"'.

Unconfirmed
11Proprietary propertiesThis column is used to specify the properties of proprietary object types that shall be shown as Server Items. Properties must be identified by their name (e.g. "present-value"
. A
; a full list of supported types can be found here)
– a
. A proprietary property ist specified by "Proprietary_<Prop ID>"  (e.g. "Proprietary_6704"). To specify multiple properties, a comma separated list has to be used (e.g. "Proprietary_6704,present-value,Proprietary_6710").

A comma-separated list of the following



12Proprietary data typesWithin this column, the data types of proprietary properties have to be specified.
Again, a
A comma separated list has to be used if multiple properties are used. The length of the list must be equal to the list used in column "Proprietary properties
". Valid values are "Boolean", "Unsigned Int", "Signed Int", "Real", "Double", "Octet String", "Character String", "Bit String", "Enumerated", "Date",
"
Time"
. For standard properties, the list entry can be left empty (e.g. "Boolean,,Unsigned Int")

A comma-separated list of the following:

  • Boolean
  • Unsigned Int
  • Signed Int
  • Real
  • Double
  • Octet String
  • Character String
  • Bit String
  • Enumerated
  • Date
  • Time


13Proprietary accessWithin this column, the access rights of proprietary properties have to be specified.
Again, a
A comma separated list has to be used if multiple properties are used. The length of the list must be equal to the list used in column "Proprietary properties
". Valid values are "R", "RW
"
and "W"
. For standard properties, the list entry can be left empty (e.g. "R,,RW")

A comma-separated list of the following

  • R
  • RW