The Poseidon2 and Damocles2 works as a TCP Server at port 502 (Modbus standard). The Modbus/TCP communication takes place using the given addresses. For details, see http://www.modbus.org .

Caution: Modbus/TCP implementation support requires setting the " Slave ID " variable to number 2. Check the setting of this variable in case you are enable to establish a connection. (The actual name may differ in your software – it used to be an address to distinguish multiple devices on a RS-485 line in case of Modbus/RTU).

What you can find in this application note:

• We describe how to properly setup Modbus Poll program version 3.20
• You find out what is possible to read via Modbus/TCP protocol

Notice: Modbus Poll application version 3.20 in its unregistered version works only for 4 minutes after launch. It is necessary to restart the program after to run it again.

Mapping of variables for the Modbus/TCP protocol

Analog quantities
Address	I/O		Type		Functions		Units
100	int		4				Current number of installed (configured in Setup) sensors
101-10x	int		4		0,1°C		Current value of the sensor No. 1 through x, where x is the value at address 100. Units are configured in WEB Setup.
200	int		4		-		Current banknote counters
201 - 2xx	int		4		-		The current counter value, the first counter is at the address 201(H)-202(L), second on 203(H)-204(L) ….
201 - 2xx	int		16		-		Set the current counter value, the first counter is at the address 201(H)-202(L), second on 203(H)-204(L) ….
Digital values
Address	I/O		Type		Functions		Description
100 - 1xx	bit		2		0 - open, 1 - close		Current values of binary inputs
200 - 2xx	bit		1		0 - open, 1 - close		Reads the current value of the output
200 - 2xx	bit		5		0 - open, 1 - close		Sets the value of the output

Inputs registers

Outputs registers

Remote INPUTS

Poll Definition
Slave ID:		2
Function:		02 INPUT STATUS
Adress:		100
Length:		24
Scan Rate:		1000
Auto Read Enable:		Checked

Remote OUTPUTS

Poll Definition
Slave ID:	2
Function:	01 Coil Status
Adress:	200
Length:	4
Scan Rate:	1000
Auto Read Enable:	Checked

Sensors

Poll Definition
Slave ID:	2
Function:	04 INPUT REGISTER
Adress:	100
Length:	2
Scan Rate:	1000
Auto Read Enable:	Checked

The Poseidon2 and Damocles2 works as a TCP Server at port 502 (Modbus standard). The Modbus/TCP communication takes place using the given addresses. For details, see http://www.modbus.org .

Caution: Modbus/TCP implementation support requires setting the " Slave ID " variable to number 2. Check the setting of this variable in case you are enable to establish a connection. (The actual name may differ in your software – it used to be an address to distinguish multiple devices on a RS-485 line in case of Modbus/RTU).

Program Modbus Poll & Damocles MINI

Dry contact inputs - model MINI

Connect the Damocles MINI unit to ethernet and power supply. Launch Modbus Poll application (mbpoll.exe file). In setup menu select option Poll Definition (keyboard short cut F2).

Picture a - Input setting

Setting of inputs in Modbus Poll program (Picture a)

• Slave ID: 2
• Function: definition of running function 02 INPUT STATUS for monitoring of input states
• Address: definition of used variables that will be loaded (for addresses see figure bellow). Beginning at the address 100 - ending at the address 103
• Length: length of loaded variables
• Scan Rate: delay between two following loadings
• Auto Read Enable: to enable automatic reading of values
• Click OK button to confirm

 

Picture b - Network parameters setting

Addresses of inputs in terms of protocol are configured, now set up connection to device itself.

• In Connection menu select Connect (keyboard short cut F3)
• Select TCP/IP
• Set up device IP address and Port (standard is 502)
• Push OK button to confirm

Application is now connected to selected device and in periodic interval loads input values (see the picture c).

 

Picture c - Values loading

Picture d - Damocles MINI - WWW page

>> Damocles MINI
Download and application of Modbus Poll + examples

 

Binary outputs (Damocles MINI)

Open Poll Definition menu to control binary outputs.

Picture e - Output setting

• Slave ID: 2
• Function: definition of running function 01 COIL STATUS for monitoring of output states
• Address: defines the address of used variables that will be logged (for addresses see figure bellow). It begins at the address 200 - ending at the address 201
• Length: number of loaded variables
• Scan Rate: delay between two loadings
• Auto Read Enable: to enable automatic reloading
• Click OK button to confirm

To control binary inputs select option 05 in function menu: Write Single Coil (short cut F7).

Picture f - Output control

You can safe setting of Poll Definition to mbp file to simplify your work. Any time you need it simply load the saved setting.

 

Modbus Poll & Poseidon2 4002

Temperature sensor - model4002

Open Poll Definition in menu.

• Slave ID: 2
• Function: definition of running function 04 INPUT REGISTER for monitoring of output states
• Address: defines address of used variables that will be loaded (for address see figure above).
  • Andrea 100 - number of sensors
  • Addressed 101 - current value
• Length: number of logged values
• Scan Rate: delay between two readings
• Auto Read Enable: to enable automatic reloading
• Click OK button to confirm

Picture ch - Setting of temperature sensor

Two lines are displayed. The first line shows number of connected sensors and the second current temperature with an accuracy of 0.1° C. Save your setting to mbp file to simplify work with Poll Definition. In case you need it, simply load saved setting.

Industrial Bus (RS-485)

• Maximum cable length: 1000 m total
• Number of devices on the bus: Poseidon + up to 31 devices
• Power: 12V/120 mA supplied by the bus, can be boosted with an external adapter (through a S-Hub or a Spider unit).
• Cable type: UTP (2 or 3 pairs)

Topology 1: Basic

• The bus leads via a 4-wire connection from the Poseidon 1250 unit to two daisy-chained sensors, Temp-485 and HTemp-485. Two twisted pairs are used by the connection.
• A S-Hub unit is daisy-chain-connected via the RJ45 jack after the second sensor, using a 4-wire connection from the HTemp-485 sensor. The brown pair is used for power, the blue pair for data.
• Temp-485 and HTemp-485 sensors are connected to the S-Hub connectors 1 through 3 with 6-wire connections (brown pair for power, blue pair leads the bus to the device, green pair back from the device).
• Connector 4 of the first S-Hub unit is used to connect a Spider converter with a patch cable. The Spider unit is used to connect three Temp-1Wire 10m temperature sensors and one door contact (the contact is connected to the blue pair of the RJ45).
• A second S-Hub connects to the Spider unit output via a patch cable.
• Its connectors 1 through 3 are used to connect the Temp-485 and HTemp-485 sensors with 6-wire connections (brown pair for power, blue pair to the device, green pair back from the device).
• Connector 4 is used to connect a Temp-485 sensor with a 4-wire connection (brown pair for power, blue pair for the A/B signals of the bus).
• Termination is enabled at the Temp-485 sensor using the “TERM” jumper.

 

Topology 2: Connecting 10 sensors to IT Bus

Eight temperature sensors and two humidity sensors are connected via the IT Bus (RJ12) to a Poseidon 1250 unit. The 10 sensors are connected using two T-Box hubs and one T-Box2 unit.

• Bus used to connect the sensors: IT Bus

• Total bus length: 10m
• Maximum number of sensors: 10
• Sensors used:
  • 2x Humid-1Wire 1m
  • 8x Temp-1Wire 1m 
• Accessories used:
  • 2x T-Box
  • 1x T-Box2

Conclusion:

This solution is limited by the maximum IT Bus length. It is suitable for applications that use 1 to 10 sensors at one place (one location, 19” rack cabinet, etc.)..

Topology 3: Poseidon Spider – bus converter

The solution combines the properties of both buses. Two Spider units are far apart, connected via a Patch cable with RJ45 modular jacks. Both Spider units connect to four temperature or humidity sensors, each with a 10m cable. One Temp-485 sensor is located at the end of the chain and terminates the bus.

• One Temp-1Wire temperature sensor with a 10m cable is connected directly to the Poseidon unit to the RJ12 jack.
• Six temperature sensors and two humidity sensors are connected via the IT Bus (RJ12) to the Spider units. Each sensor is connected with a 10m cable.
• Two Spider units are connected to Poseidon 1250 with a standard RJ45 Patch cable using the Industrial Bus. Bus length is limited to 1000m.
• The Spider unit comprises 4 inputs for external sensors and supports one sensor per connector – for a maximum of 4 sensors.
• The Industrial Bus is terminated by connecting a Temp-485 sensor with termination enabled over a 4-wire connection. The Spiders have mutually different addresses and are set to the “middle” mode.

• Bus used to connect the sensors: IT bus, Industrial Bus
• Total bus length: 1000m + 9x 10m
• Maximum number of sensors: 40
• Sensors used:
  • 6x Temp-1Wire 10m
  • 2x Humid-1Wire 3m
  • 1x Temp-485
• Accessories used:
  • 2x Poseidon Spider
  • 2x RJ45 Patch cable 300m (RJ45-RJ45)
  • 1x RJ45 TP cable 300m (RJ45-4 pins, “LAST” wiring)

Conclusion:

This solution is not limited by the IT Bus length. The Spider units can be up to 1000m apart. The solution is suitable for large-scale applications with many sensors (e.g. server rooms).

 

Topology 4: Using the Industrial Bus – star topology

This solution demonstrates a star-like connection of sensors to the Industrial Bus using an S-Hub unit. The S-Hub is the central point that connects individual sensors. The maximum bus length decreases to 500m because the cable length of all sensors connected to the S-Hub must be counted twice. A Temp-485 sensor with termination is at the end of the bus.

• One Temp-1Wire temperature sensor with a 10m cable is connected directly to the Poseidon unit, to the RJ12 jack.
• The Industrial Bus connects to the S-Hub input via a RJ45 patch cable. At the same time, the cable powers the sensors as well as the S-Hub; extra power can be supplied by an external power adapter.
  • Sensors must be connected to the S-Hub in a sequence, starting from output No. 1. Outputs cannot be skipped. (For instance, connecting outputs 1,2,5,6 while leaving outputs 3 and 4 unconnected will not work.)
• First three temperature (Temp-485) and temperature/humidity (HTemp-485) sensors are connected in sequence to the first three outputs. An RJ45 / 6-wire cable, wired according to the “MIDDLE” version, is used to connect them.
• The Spider unit is connected with a Patch cord. The Spider connects four Temp-1Wire sensors at 4x 10m distances. The Spider unit is in the “MIDDLE” mode.
• The Industrial Bus is terminated at the Temp-485 sensor connected to the S-Hub at position No. 5. The connecting cable is wired according to the “LAST” version, termination is enabled at the sensor (Term=On).

Topology 5: Using the Industrial Bus – daisy chain

The solution demonstrates daisy-chain linked sensors on the Industrial Bus. Note the distances between sensors. The Spider unit connects four local temperature sensors. At the end of the bus, there is a Sens-UI voltage and current sensor with termination enabled.

• One Temp-1Wire temperature sensor with a 10m cable is connected directly to the Poseidon unit to the RJ12 jack.
• Two HTemp-485 temperature/humidity sensors are connected at the beginning of the bus, using a 4-wire cable connected to the terminals.
• The bus continues to the Temp-485 temperature sensor, still with 4 conductors.
• The Temp-485-Pt100-Cable uses a 4-wire connection as well. The temperature is measured by a Pt100 sensor mounted on a 2m silicon cable.
• The next Temp-485-Pt100-2xDIN converter, mounted on a DIN rail, uses a 4-wire connection. Two external Pt100 thermometers measure two temperature values.
• The following Temp-485-Pt100-Box sensor, designed for external environment, includes a probe for precise temperature measurement. 4-wire connection.
• The Spider unit is, on the contrary, connected via a RJ45 jack. The Spider connects four Temp-1Wire sensors located 4x 10m away.
• Please note the crossing of cables. It is necessary to respect the input and output designation of the RJ45 jacks. The Spider is in the “middle” mode.
• The Industrial Bus finally leads, via a 4-wire connection, to a Sens-UI sensor that measures external voltage and current.
• At this point, the bus is terminated by an external 120 Ohm resistor between the A and B pins.

   

Sources of false alarms

• Contact bounces
• Oscillation of the reading around the threshold
• Changing the connections

The problem is particularly bothering if you use Poseidon with a GSM modem that sends a text message (SMS) to your mobile phone upon each and every alarm.

 

Poseidon supports two functions to avoid false alarms:

• Alarm Notification Delay
• Hysteresis Idle Range

 

Alarm Notification Delay

The Alarm Notification Delay function prevents an alarm alert from being sent if the alarm lasts only for a very short time. The same delay is applied to alarm activation and alarm deactivation alerts.

• Blue color indicates the behavior when Delay [s] = 0.
• Orange color indicates the behavior when Delay [s] = 20.

Hysteresis / Idle range

The Hysteresis setting defines a tolerance band for suppressing alarm alerts. The function prevents multiple alarm alerts if the reading oscillates around the specified threshold. The range is configured independently for each sensor.

 

The figure demonstrates two cases. Without the hysteresis idle range of 5°C, the alarm raised in point 8 would end in point 9; however, the hysteresis function keeps the alarm active until the temperature reaches the upper limit of the tolerance band (point 10): 5℃ + (–15℃) = –10℃.

• Hysteresis = 5°C:   
  The unit sends 3 e-mail (SMS) messages
  Alarm active in points 0..4,  8..10, 12 and beyond
   
• No hysteresis (0°C):   
  The unit sends 8 e-mail (SMS) messages
  Alarm active in points 0..1, 2..3, 8..9, 12..13, 14 and beyond

• How does it work:
  When a button connected to input XX is pressed, Poseidon sends a SNMP trap to output XX. Since the same "#01" string is specified in the text name of the input and of the output, Damocles sets the output Y according to the input Y.

 

Configuring the output: Damocles

What to configure	Where	Default / sample value
SNMP Port Listener	Setup	162
Private community – write access	Email & SNMP > SNMP Access	true
Output name	Outputs > O1 > Name	Link#01
Output control	Outputs > O1	Manual

Note

In a similar way, two Damocles units can be configured to work together. Damocles can serve as the input or as the output; Poseidon can only serve as the input.
CAUTION: If you use older models, upgrade their firmware first!

Configuring the input: Poseidon

What to configure	Where	Default / sample value
Where to send SNMP Traps	SNMP > SNMP Trap Destination	162
	Community	private
IP address of the target device	IP Address	192.168.68.70
Target device port for receiving SNMP Traps	Port	162
	Enable	check
Input name	Inputs
	Name	Link#1
	Alarm State	Active if ON
	Out of Safe Range SNMP Trap	check

 

Note

In a similar way, two Damocles units can be configured to work together. Damocles can serve as the input or as the output; Poseidon can only serve as the input.
CAUTION: If you use older models, upgrade their firmware first!

Testing the function

1. Turn both devices off, and then back on.
   No LEDs will be lit on the Damocles.
2. On the Poseidon, close input 1 (a paper clip will work fine).
   Damocles reacts by closing output 2.

Note: In the Box-2-Box mode, SNMP traps only notify about changes. If you close the input before the Damocles is turned on, the state is not reflected.

Tips

1. The link identifier, "#xx", must contain exactly two digits.
   #xx can be located anywhere in the name of the input or the output but it must not follow a space.
2. An Input can control several units at once. The limit is the number of SNMP trap destinations (2 or 4).
3. One input can control multiple outputs within a single output device.
   Assign the same link identifier to the outputs.
4. The value of the input can be negated.
   If you use an exclamation mark operator (!) instead of the hash operator (#), the output will be inverted.
5. Physical order of inputs and outputs is not important.
   Input1 can control Output8 and so on. It is only important to use the same link identifier.

Note: We recommend to use only US-ASCII characters in input and output names.

Utility characteristics

• UNIX and Windows version
• Utility source codes are part of HWg SDK
• Whole communication with devices over XML interface
  • The utility modifies XML files before they are sent according to state the device accepts them (see detailed product manual)

List of parameters

 

C:\>PosDamIO
Use: posdamio [OPTIONS] IP_ADDRESS [PORT (default: 80)]
Options:
-g, --get Get actual values and print list
-o, --output X=Y Set output X (1..64) to value Y (0, 1, OFF, ON)
-f, --filename SETUP.XML File with configuration for uploading to the
remote device (max. 20000 bytes)
-v, --values VALUES.XML File to store actual values in XML format
-s, --setup SETUP.XML File to store remote device configuration
-t, --text DATA.TXT File to store actual values in text format
-u, --user USER HTTP authorization user
-p, --password PASSWORD HTTP authorization password

-h, --help Print this help and exit
--version Display version information and exit
--error-level Print error levels and exit

 

Application examples

• PosDamIO -g 192.168.0.41
  To displays current values of sensors, inputs and outputs on the screen
• PosDamIO -o 1=ON 192.168.0.41 8080
  To setup 1 to log. 1 on device with IP address 192.168.0.41 and HTTP port 8080
• PosDamIO -g -v c:\data\values.xml 192.168.0.41
  To display settings of sensors, inputs and outputs and to download and save value.xml from device to disk
• PosDamIO -g -t c:\data\values.txt -u USR -p PSW 192.168.0.41
  To display settings of sensors, inputs and outputs of device which protects access to XML files with HTTP name and password. At the same time it downloads and saves values.txt (as a text) which contains the same data as those displayed on the screen.
• PosDamIO -o 2=0 -v c:\data\values.xml 192.168.0.41
  To setup output 2 to log. 0 on device with IP 192.168.0.41 address. Afterwards it downloads and saves values.xml file to disk. This file can be used for output setting verification.
• PosDamIO -s Pos_outdoor_setup.xml 192.168.0.41
  To download and save setup.xml from device to disk and name it as Pos_outdoor_setup.xml. The file contains whole device configuration.
• PosDamIO -f Pos_outdoor_setup.xml 192.168.0.41
  Saved Pos_outdoor_setup.xml file which is saved on disk is sent to device as a setup.xml file. The file contains whole device configuration thus it is easy to clone devices.
• Errorlevel return value application in .bat command file
  Under output setting command resulr control command file

-----------
@echo off
PosDamIO.exe -o 1=0 192.168.1.6
if errorlevel 1 goto error1
if errorlevel 0 goto noerror
:error1
echo PosDamIO error (errorLevel = %errorlevel%)
goto end
:noerror
echo PosDamIO OK
goto end
:end
pause
-----------

 

Tip: To make change in configuration such as rename input, sensor or device simply make changes in downloaded setup.xml or values.xml file and after send it back to device.