Neptronic SKH Series User manual

SKH-BACnet Guide-200114
High Pressure Atomiser
SKH Series
BACnet User Guide

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | i
Contents
Introduction........................................................................................................................................................................1
Pre-requisites................................................................................................................................................................1
Advantages of BACnet..................................................................................................................................................1
BACnet Properties Configuration..................................................................................................................................2
Configuration Options .......................................................................................................................................................3
Quick Setup...................................................................................................................................................................3
Manual Setup................................................................................................................................................................3
MAC Address and Max_Master................................................................................................................................3
Network Reset...............................................................................................................................................................4
Device Object Properties ..................................................................................................................................................5
Object Types Supported ...............................................................................................................................................6
Out of Service Property.................................................................................................................................................7
Object Table Information...................................................................................................................................................8
Analog Input (AI) ...........................................................................................................................................................8
SKH EZC...................................................................................................................................................................8
Analog Output (AO).......................................................................................................................................................9
Analog Value (AV).........................................................................................................................................................9
SKH EZC.................................................................................................................................................................10
Binary Input (BI) ..........................................................................................................................................................12
Binary Output (BO)......................................................................................................................................................13
Binary Value (BV)........................................................................................................................................................13
SKH EZC.................................................................................................................................................................15
Multi State Value (MSV)..............................................................................................................................................17
SKH EZC.................................................................................................................................................................17
Other ...........................................................................................................................................................................19
Notes...............................................................................................................................................................................20

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 1
Introduction
The SKH High Pressure Atomiser Humidifier BACnet®Communication Module User Guide provides information about
using the humidifier with BACnet communications feature. The BACnet communication protocol for building automation
and control networks enables communication between client devices within a network. The humidifier provides a BACnet
network interface between BACnet client devices and Neptronic Humidifier series devices. It uses the BACnet Master
Slave/Token Passing (MS/TP) protocol at the BACnet MAC layer.
Pre-requisites
The BACnet communication user guide assumes that you are familiar with the concepts of BACnet and its terminology.
Advantages of BACnet
BACnet enabled humidifiers have the following advantages:
•Quick Message Transmission. The humidifier uses a synchronous implementation for BACnet messages making
it quick and efficient. Each BACnet confirmed service request is answered as quickly as possible without using
the Reply Postponed frame. The MS/TP implementation is performed within Tusage_delay of 15 minutes to
ensure a Tusage_timeout value within 20 minutes.
•MS/TP Support. The humidifier supports a Full Master Node state machine for MS/TP. Max_Master and the
instances are configured to the device object through BACnet WriteProperty service. The MAC address is set
via the DIP switches. Programming mode determines the MS/TP baud rate setting of 9600, 19200, 38400, and
76800. In the configuration mode, the device is configured through the device’s keypad. For more information
about the WriteProperty, refer to Table 3 - Object Types Supported.
•BIBB Support. The humidifier functions the same way as the B-ASC type profile server and supports the specific
BIBB as per their relevant definitions.
oDS-RP-B
oDS-RPM-B
oDS-WP-B
oDS-WPM-B
oDM-DCC-B
oDM-DDB-B
oDM-DOB-B
oDM-RD-B
oDM-TS-B
oDM-UTC-B
oDS-COV-B
oDS-COVP-B
oSCHED-WS-I-B
•Object Support. The humidifier supports a fixed list of BACnet visible values, which appear as Present_Values
of various BACnet standard object types in addition to a device object. For more information, refer to Table 3 -
Object Types Supported.
•Alarms. The humidifier supports indication of various alarm conditions through value changes in properties of
several objects. However, it does not generate BACnet event notifications.

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 2
BACnet Properties Configuration
To establish communication on the network, and guarantee a unique ID of devices in a BACnet system, the following
properties may have to be configured.
Table 1 - BACnet Properties Configuration
Property
Default Value
Configuration
MAC Address
000
Set to a value between 000 and 127 via DIP switches. Can also be
set to a value between 000 and 254 via menu.
The values from 128-254 represent MS/TP non-token passing slave
devices.
Device Instance
Auto
•The humidifier automatically configures its device instance to
153,000 + MAC address.
•The value can be set manually via the menu.
•The value can be set manually through the WriteProperty
service to Device Object.Object_Identifier.
•The device’s Object_Identifier is a combination of the Device
Object_Type (8) and the Device_Instance (0-4194302),
therefore its decimal or hexadecimal representation tends to be
incomprehensible.
•For example, the Device_Instance=1000 has an equivalent
Object_Identifier of 0x020003E8 hexadecimal or 33555432
decimal.
Baud Rate
0 = Auto
•The humidifier configures its baud rate automatically by detecting
the network upon connection.
•The value can be set manually from the available values of Auto,
9600, 19200, 38400, 76800.
Max_Master
127
•Configure Max_Master value to increase network efficiency when
there are less than 127 devices on the network.
•The Max_Master value can be changed through the TRL to
configure WriteProperty service to the Device
Object.Max_Master.
For more information, refer to the MAC Address and Max_Master
section.
Device Object.Object_Name
Name of the device
•Configure the name of the device through WriteProperty service
to the Device Object.Object_Name. For example, SKH.

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 3
Configuration Options
The following options enable you to configure and run the BACnet features of the humidifiers quickly.
Quick Setup
Configure the humidifier's baud rate and device instance without programming.
1. Connect the humidifier to the network and power it up.
2. The humidifier automatically configures the baud rate and device instance.
3. Repeat the steps for each humidifier.
Manual Setup
1. To use a Device_Instance other than 153,000, and/or if your site has more than one humidifier network,
go to the menu.
2. Disconnect the power to the humidifier, connect the humidifier to the network, and connect the power
again.
3. Configure the Max_Master value through WriteProperty service to the Device Object.Max_Master to
increase network efficiency or if there are less than 127 devices on the network.
MAC Address and Max_Master
The MAC address must be unique on the entire MS/TP network. However, having a unique MAC address and a high
baud rate does not guarantee efficient operation of the humidifier and other MS/TP units on the MS/TP network. Some
MAC address and Max_Master combinations are more efficient than others. BACnet requires token-passing units to
occasionally “poll” for other masters based on the MAC address and Max_Master.
A poor combination of MAC addresses and Max_Master can lead to a slower network due to lost time polling for masters
that are not present. Unless there are 126 other units on the MS/TP network, the default Max_Master value of 127 is
not the most efficient choice for the humidifier. The Max_Master default value of 127 was selected to ensure that any
master, specifically a BACnet client can be found when the humidifier is initially started.
Examples of Mac Address and Max_Master Configurations
The following are some of the examples to indicate the optimum combination of Mac address and Max_Master
configurations to ensure a quick and efficient output.
Example 1
•MAC=0. Max_Master=127
•MAC=1, Max_Master=127
This configuration is slow and inefficient because every time either unit is required to find another master unit, it has to
poll 126 units until it finds the right one to pass the token.
Example 2
•MAC=0. Max_Master=5
•MAC=1 to MAC=4 are not used
•MAC=5, Max_Master=5
This configuration is better than Example 1 but it is still slower. The Max_Master is set to the most efficient value but
the gap between the two MAC addresses is high. Therefore, each unit must poll four units until it finds the right one to
pass the token.
Example 3
•MAC=0. Max_Master=1
•MAC=2, Max_Master=2
This is an incorrect configuration. The MAC=0 will never find MAC=2 because it will never poll for the master MAC
address=2.

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 4
Example 4
•MAC=0. Max_Master=3
•MAC=1, Max_Master=3
•MAC=2, Max_Master=3
•MAC=3, Max_Master=3
This is an efficient configuration as the units are numbered consecutively and the MAX_Master is set to the most efficient
value. As a general guideline, the most efficient setup for an MS/TP network is one in which the units are consecutively
numbered starting at MAC address 0 and having Max_Master=the maximum MAC address in the system. If consecutive
numbering is not possible, then the next most efficient setup is one in which all units have Max_Master=the maximum
MAC address in the system.
Network Reset
Reset the humidifier via BACnet using the Reinitialize Device service. The Reinitialize Device service can be accessed
using the following password: nep.
The Reinitialize Device service has two types of reset:
•Warm Reset. The Warm Reset restarts the humidifier with actual configuration.
•Cold Reset. The Cold Reset restarts the humidifier with Factory configuration.
Warning: The Cold Reset erases the actual configuration when setting the MSTP address. Therefore, exercise
caution while performing a Cold Reset.

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 5
Device Object Properties
The following table lists all the BACnet properties supported for the device object. The W indicates that the property is
writable using the BACnet WriteProperty service.
Table 2 - Device Object Properties
Property
Value
Writable
Object_Identifier
•Programmable where the instance part of the Object_Identifier is in the range of 0-
4194302
•The device instance must be unique system-wide
•The default value for the device instance=153000 (Vendor_Identifier*1000)
W
Object_Name
SKH
W
Description
Programmable up to 32 characters (default: SKH).
W
Object_Type
Device
System_Status
Operational
Vendor_Identifier
Always 153
Vendor_Name
Always Neptronic
Model_Name
Example, SKH
Read Only
Firmware_Revision
currently, 2.05
Read Only
Application_Software_Version
currently, 2.03
Read Only
Protocol_Version
Always 1
Read Only
Protocol_Revision
14
Read Only
DataBase_Revision
2
Read Only
Max_APDU_Length_Accepted
Always 480
Read Only
Segmentation_Supported
(3) = No Segmentation
Read Only
APDU_Timeout
6000
W
Number_of_APDU_Retries
Always 3
Read Only
Local_Time
00:00:00
W
Local_Date
01-Jan-2015 (Thu)
W
Uts_Offset
-3:00
W
Daylight_Savings_Status
False
W
Backup_Failure_Timeout
300
W
Configuration_Files
File-1
Last_Restore_Time
2015-01-01 (Thu), 00:01:50:00
Backup_And_Restore_State
IDLE
Backup_Preparation_Time
0
Restore_Completion_Time
0
Restore_Preparation_Time
0
Protocol_Services_Supported
•07470BC83AE200
•confirmedCOVNotification
•subscribeCOV
•atomicReadFile
•atomicWriteFile
•readProperty
•readPropertyMultiple
•WriteProperty
•writePropertyMultiple
•deviceCommunicationControl
•reinitializeDevice
•i-Am
•i-Have
•unconfirmedCOVNotification
•unconfirmedPrivateTransfer
•timeSynchronization
•who-Has
•who-Is
•subscribeCOVProperty
Protocol_Object_Types_Supported
•analog-input
•analog-output
•analog-value
•binary-input
•binary-output
•binary-value
•device
•file
•program
•schedule
•multi-state-value
Object_List
196
Read Only
Device_Address_Binding
Always empty
Max_Master
Programmable in the range of 0-127 (default: 127)
W
Max_Info_Frames
Always 1

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 6
Property
Value
Writable
Proprietary property #1000
•Represents the MS/TP MAC address in the range of 0 to 254 (default: 0)
•Writable if all MAC address DIP switches are OFF
•Values 128 to 254 represent MS/TP non-token passing slave devices
W
Proprietary property #1001
•Programmable (default: Auto)
•Represents the MS/TP Baud rate (unsigned type)
•Values are 0 (auto), 9600, 19200, 38400, 76800
•Reading this property always returns the actual Baud rate
W
Proprietary property #1002
•Programmable (default: 15 minutes)
•Represents the period of time that an object in/out of service will automatically
return to normal. Range = 0-120 minutes (unsigned type)
•Writing 0 means no automatic return to normal
W
Object Types Supported
The following table lists all the BACnet properties supported for each object type. Most of the properties are locked. The
exception is Present_Value, which represents the dynamic operating values of the device, and the Status_Flag,
Event_State,and Reliability properties, which reflect the availability of the Present_Value. Unless otherwise specified,
properties are not changeable.
Table 3 - Object Types Supported
Object
Type
Enabled
Optional Properties
Supported
Writable Properties
Notes
Analog
Input

•Reliability
•Description
•Min_Present_Value
•Max_Present_Value
•Resolution
•COV-Increment
•Out_of_Service
•COV-Increment
•If "Out of Service" is true, Present_Value and
Status_Flag become writable properties.
•Out_of_Service property is writable for objects to
which Present_Value is not writable. Refer to Out of
Service Property section on page 7 for more
information.
•Object will automatically return to Normal after a
programmable period of time. Refer to Proprietary
property #1002 of Device Object in Table 2 - Device
Object Properties.
Analog
Value

•Reliability
•Description
•COV-Increment
•Priority_Array
•Relinquish_Default
•Present_Value
•Out_of_Service
•COV-Increment
•Present_Value property is writable for every AV
object except AV.20, AV.23, AV.40, AV.45, AV.55
•Out_of_Service property is writable for objects
indicated in Table 6 - Object Table Information:
Analog Value (AV) on page 9.
•Refer to Out of Service Property section on page 7
for more information.
•Object will automatically return to Normal after a
programmable period of time. Refer to Proprietary
property #1002 of Device Object in Table 2 - Device
Object Properties. Some objects are commandable.
In such case, the priority-array and relinquish-default
properties are available.
•Writable properties are different for some objects.
Refer to the respective Object Table information to
know the writable property for each AV object.
Analog
Output

•Description
•Reliability
•Min-Pres-Value
•Max-Pres-Value
•Resolution
•COV-Increment
•Present_Value
•COV-Increment
•Present_Value property is writable as per Analog
Output (AO) table on page 8.
Binary
Input

•Reliability
•Active_Text
•Inactive_Text
•Description
Out_of_Service
•If "Out of Service" is true, Present_Value and
Status_Flag become writable properties.
•Out_of_Service property is writable for objects to
which Present_Value is not writable. Refer to Out of
Service Property section on page 7 for more
information.
•Object will automatically return to Normal after a
programmable period of time. Refer to Proprietary
property #1002 of Device Object in Table 2 - Device
Object Properties.
Binary
Value

•Reliability
•Active_Text
•Inactive_Text
•Description
Present_Value
•Present_Value property is writable for every Binary
Value object.
•Writable properties are different for some objects.
Refer to the respective Object Table information to

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 7
Object
Type
Enabled
Optional Properties
Supported
Writable Properties
Notes
•Priority_Array
•Relinquish_Default
know the writable property for each BV object.
•Out_of_Service property is writable for every Binary
Value object.
•Some objects are commandable. In such case, the
priority-array and relinquish-default properties are
available.
•Object automatically returns to Normal after a
programmable time. Refer to Proprietary property
#1002 of Device Object in Table 2 - Device Object
Properties.
Binary
Output

•description
•reliability
•inactive-text
•active-text
Present_Value
•Present_Value property is writable.
Device

•Max_Master
•Max_Info_Frame
•Description
•active-cov-subscriptions
•#1000 (MSTP addr)
•#1001 (Baud rate)
•#1002 (Time out)
•Local_Time
•Local_Date
•Uts_Offset
•Daylight_Savings_Status
•Apdu_Timeout
•Backup_Failure_Timeout
•Object_Identifier
•Object_Name
•Max_Master
•Description
•Local_Time
•Local_Date
•Uts_Offset
•Daylight_Savings_Status
•Apdu_Timeout
•Backup_Failure_Timeout
•#1000
•#1001
•#1002
•Configuration_Files
•Last_Restore_Time
•Backup_And_Restore_State
•Backup_Preparation_Time
•Restore_Completion_time
•Restore_Preparation_Time
•Refer to Table 2 - Device Object Properties on page
5.
Multi-
State
Value

•Description
•Reliability
•States_Text
Present_Value
•Present_Value property is writable for every Multi
State Value object except MSV.12, MSV.13, MSV.15
•Writable properties are different for some objects.
Refer to the respective Object Table information to
know the writable property for each MSV object.
•Out_of_Service property is not writable for MSV.
Out of Service Property
Neptronic humidifiers offer the use of the Out of Service writable property. When the value of this property is set to True,
it disconnects the object from the physical input, enabling you to input other values. This is useful for special applications
or while troubleshooting. For example, you can ignore the temperature read from a sensor and input the desired
temperature value in order to perform specific tests.
For security reasons, a timeout will set the Out of Service property back to False after 15 minutes. This value can be
modified to between 0 and 120 minutes (For more information, see proprietary property #1002 in Table 2 - Device Object
Properties).

High Pressure Atomiser Series
BACnet Communication Module User Guide
www.neptronic.com
Page | 8
Object Table Information
The SKH series uses the following BACnet object tables, categorized on the basis of their ID. The type is the BACnet Object type, the instance is the BACnet Object. Together,
the type and instance form the BACnet Object_Identifier for an object according to the following C-language algorithm:
•object_identifier=(unsigned long)((unsigned long)type<<22)+instance
Analog Input (AI)
Table 4 - Object Table Information: Analog Input (AI)
ID
Name
Description
W?
Notes
Integrator
AI.1
SKHBoardTemp
Displays the temperature reading measured on the SKH PC board.
Out of Service
0°C to 100°C, Resolution: 0.1°C
SKH EZC
ID
Name
Description
W?
Notes
Integrator
AI.3
RoomRHSetpoint or
RoomTempSetpoint
Displays the setpoint for the room relative humidity sensor. OR
Displays the setpoint for the room temperature sensor.
Out of Service
0.0 to 100.0%RH or 10°C to 40°C, Resolution 0.1%RH or 0.01°C
AI.4
RoomRH
Displays the reading of the relative humidity in the room.
Out of Service
0.0 to 100.0%RH, Resolution 0.1%RH
AI.5
RoomTemp
Displays the temperature reading of the room.
Out of Service
-100°C to 100°C, Resolution 0.01°C
AI.6
DuctRH
Displays the relative humidity reading of the duct.
Out of Service
0.0 to 100.0%RH, Resolution 0.1%RH
AI.7
TrlhRH
Displays the value of the relative humidity measured on the TRL.
Out of Service
0.0 to 100.0%RH, Resolution 0.1%RH
AI.8
TrlhTemp
Displays the value of the temperature measured on the TRL.
Out of Service
0°C to 50°C, Resolution 0.01°C
AI.9
BoardTemp
Displays the temperature reading measured on the PC board.
Read Only
0°C to 100°C, Resolution 0.01°C
Advanced
AI.200
DI4_TpmDuty
Out of Service
0 milliseconds to 1000 milliseconds, Resolution 1millisecond