ST-50 Controller owner s manual
1. ST-50 Controller (Ethernet 1-Wire). To be able to operate, the ST-50 controller based monitoring system requires only a 12V power supply, connected directly to the controller and sensors or 1-Wire devices, as specified for individual solutions. Apart from standard sensors (for humidity, voltage and temperature measurements), integration modules are also available (for voltage measurements, with two counters and an optional switch) that make it possible to connect the bus with other devices equipped with an analog input, pulse input or two-state output. The ST-50 controller enables also control with any two-state switch, connected to the 1-Wire bus being monitored. NOTE: The recommended (optimal) connection topology for sensors is via a bus (serial topology). With such topology, you can extend the network of sensors across a distance of up to 100 m. 2. Technical requirements a) application To be able to launch the application, it is necessary to install the J2RE environment version 5.0 or higher, so that Java applications can run in the Graphics Mode. b) communication The ST-50 controller can be set up via Ethernet. For this, the following conditions need to be fulfilled: twisted-pair cable (crossover cable for direct connection with the computer s graphics card; straight cable for connections via a network switch/hub) one free IP address in your LAN, assigned permanently to the controller Optional: 1-Wire patch cord needed for connecting more 1-Wire devices When using a firewall, enable the following ports: Port 80 a Web panel for controller configuration Port 502 the controller s default communication port (can be changed during basic configuration of the controller) The maximum length of the 1-Wire bus must not exceed 150 m. 3. Basic configuration working parameters The Ethernet Operation Mode is set up with a website-based configuration tool, accessed via the controller. To display the website, enter the IP address assigned to the controller in your browser window, and then log in to your user account, defined in the controller. The default settings defined by the manufacturer are as follows: IP address: 10.0.0.88 Login: zpas
Password: net Fig. 1. The controller login page. NOTE: To ensure better protection for the controller, change the default user name and password during the initial configuration.
The controller allows you to modify of the following connection parameters: ETHERNET: IP Address controller s IP address in LAN. This address is used for communication with the controller. It also provides access to the controller s configuration website. In the case of several controllers existing within the same subnet, each one has to have a unique IP address assigned to it. Mask the default subnet mask. In the case of LAN configuration, the mask parameters need not be modified. Gate the IP address of the gate. If you wish to access the controller from an external network (Internet), this address needs to correspond to the gate address, set for the subnet in which the controller is operated. MAC Address the hardware address of the controller s network module. Each controller has the same MAC address assigned to it. In the case of several controllers existing within the same LAN, each one should have a unique MAC address assigned to it. Otherwise, there is no need to modify it. MODBUS: Port Nb Modbus communication port. Via this port, the controller communicates with the configuration application. Device Address the internal Modbus address of the controller (Modbus slave address). It does not need to be modified, even when several controllers are installed within the same LAN. The address has been provided to ensure compatibility with the protocol. Modbus Password the password used for communication via Modbus. Confirm Password when attempting to modify the password, input the same string of characters both in Modbus Password and Confirm Password. PROTECTIONS: Login the name of a user authorized to configure the controller. Password the user password. The password must not be longer than 10 characters. Confirm Password when attempting to modify the password, input the same string of characters both in Modbus Password and Confirm Password. To save the settings, click Send. Having done that, you can still verify whether the data input is correct (the changes will be highlighted in red).
Fig. 2. The controller s operating parameter configuration page. When you click Send, the settings you have made will be stored in the memory, and the configuration page will be refreshed.
4. Controller configuration The controller can be configured using a Java-based application, capable of running in graphics environments of any operating system with Java Runtime Environment 5.0 or higher installed. This software is available free of charge, and the installer can be downloaded from the manufacturer s website (http://oversee.zpas.net). 4.1. Installation of the configuration application Once the application has been downloaded or having inserted the installation CD into the CD drive, launch the installer (st50-setup.exe) and follow the instructions it displays. The installation wizard will let you install the application together with the dedicated Java environment (Java Runtime Environment). If you do not have the JRE installed on your computer, select Zainstaluj środowisko Java (JRE 5.0) and follow the instructions displayed by the installation wizard. The default installation folder is C:\Program Files\ST-50 but it can be modified during installation. If the application has been installed successfully, a shortcut group should be created in the Start menu, similar to the one shown below: Fig. 3. A shortcut group in the Start menu. To launch the application, select the ST-50 configurator shortcut. NOTE: Should you have any problems with running the application, please refer to the Troubleshooting section or contact ZPAS-Net s Technical Support.
4.2. Program description Once the application has been launched, the main window will be displayed to give you access to all controller configuration options. Connect ith Disconne Add Alarm Delete Alarm Status Download Main application Alarm table header Edit Alarm Delete All Alarms Alarms tab Measurements tab Alarms table Fig. 4. The application window. To establish connection with the controller, click the Connect with... button or select the corresponding option form the Plik menu. In the window displayed (see point 4.2.3, Fig. 5), enter the connection details.
4.2.1. Menu options Plik Połącz z opens the connection window (see Fig. 5) Rozłącz closes the connection with the controller Zamknij closes the application Opcje Aliasy czujników opens the alias names window (see 4.2.3., Fig. 14.) Narzędzia Serwer opens the message server panel; it allows you to preview messages sent if the user selects the Send to server option when defining alarms (further details will be described later). Pomoc O programie displays information on the program
4.2.2. Buttons Connect with opens the connection window (see also Plik Połącz z ). Disconnect closes the connection (see also Plik Rozłącz ). Add Alarm opens the alarm definition window (Fig. 12). Once an alarm configuration has been saved, a new definition is added to the first empty slot in the controller s memory. Edit Alarm opens the alarm definition window (Fig. 12). It is possible to edit an alarm that has been highlighted in the alarms table. Saving the settings will overwrite the definition saved in the slot assigned to the alarm. Delete Alarm deletes the alarm highlighted in the alarms table. Before deletion, you will be asked to confirm your decision. Delete All Alarms deletes all alarms defined in the controller. Before deletion, you will be asked to confirm your decision. Alarm Status opens the alarm status window (Fig. 11). Download Data if connection with the controller has been established correctly, selecting this button will refresh all data downloaded from the controller. Depending on the number of alarms and/or sensors, this operation may take from several seconds to several minutes.
4.2.3. Dialog box Połącz z Fig. 6. The Connect with controller window. Adres urządzenia : IP address or domain name assigned to the controller. Adres urządzenia : since the controller uses the Modbus protocol, it is necessary to provide the slave address. The value input into the field must correspond to the value provided during the basic configuration made via the website. The default value is 1. Port: the network port used by the controller. This value must also correspond to the value provided during the basic configuration or, if the communication is established via a router or firewall, it is necessary to specify the port to which communication from/to the controller has been redirected. When you click the Połącz button, the application will attempt to establish connection with the controller. The default response time is 10 seconds. The connection status is displayed on the window title bar. During the next stage, all alarms and current measurement messages available in the controller are automatically downloaded. When the download process has been finished, a message will appear with the number of sensors and alarms that were downloaded from the controller. Fig. 8. The Data download finished window.
Alarmy (tab) The Alarmy tab contains a list of alarms defined in the controller. To refresh the values, click the Download Data button (see 4.2.2). Fig. 9. The Alarmy tab. The individual fields within the Alarmy tab: * alarm fault this field indicates the occurrence of a fault when checking the alarm status. The most common reason for this is disconnection of the 1-Wire sensor that was assigned with the alarm. If this is the case, the current value is always 0 with the alarm activity remaining the same as it was before the fault. The basic alarm codes are as follows: 0 status O.K. 1-116 1-Wire error (internal bus error) 200 unknown error 201 no device 202 internal error 203 wrong family code (incorrect MAC address of a sensor) ID (alarm ID) controller s memory slot number, under which the alarm has been stored. It is assigned automatically when creating a new alarm definition. MAC (sensor s MAC address) unique sensor number, specified by the manufacturer and preceded by a prefix common to the entire family. Nazwa (sensor s name) user-defined name of the measurement (see 4.2.3. Aliasy czujników ). Bieżąca wartość (alarm current value) the current value downloaded from the sensor. The readout is updated according to an interval set for the given alarm. Hence, the value can differ from those for other alarms assigned to the same measurement.
Warunek available: (condition for the occurrence of an alarm) there are five conditions > the current value being higher than the condition value < the current value being lower than the condition value!= the current value being different than the condition value <= the current value being equal to or lower than the condition value >= the current value being equal to or higher than the condition value Wartość warunku the value being compared with the current value Akcja controller s response when the set condition is met. The field contains action symbols as follows: H (HTTP) a message is sent to a specified server. The option is enabled when fields in Serwer HTTP section are filled in correctly when defining the alarm (see 4.2.3. Konfiguracja alarmu ). T (TEXT) the message being sent is accompanied by the user s own text, entered when defining the alarm. This feature is also enabled when the user has opted for e-mail notifications. M (MAC) the message being sent is accompanied by the sensor s MAC address. This option allows you to identify the location of the alarm. V (VALUE) the message being sent is accompanied by the status of the measurement that has caused the occurrence of the alarm. SA (SWITCH ACTIVE) occurrence of the alarm causes activation of the selected switch. SI (SWITCH INACTIVE) cancellation of the alarm causes activation of the selected switch. G[2] the alarm message is sent via e-mail. Value 2 next to the letter means that the message is sent both at occurrence and cancellation of the alarm.
Pomiary (tab) The Pomiary tab shows information on all sensors that are currently connected to the ST-50 controller. In this window, you will find such values as: ID, type, MAC address, current measurement value, user-defined name. All these details help to identify measurements. Fig. 10. The Pomiary tab. Here you can also change the state of any switch within the 1-Wire bus being monitored. Status alarmu The alarm status window can be called up by highlighting any alarm from the available list, and then by clicking the Alarm Status button (see 4.2.2.). Fig. 11. The Status alarmu window. Clicking the Refresh button will re-download the current alarm parameters.
Konfiguracja alarmu The alarm configuration window is displayed by clicking the Add Alarm or Edit Alarm button (having highlighted the alarm to be edited on the list). Fig. 12. The alarm definition window.
Via the alarm configuration window, you can set the following: Czujnik using a drop-down list of all sensors, you can select one that will be assigned with the alarm being defined. Warunek alarm trigger condition options o Bieżąca wartość a read-only field that indicates the current measurement for the sensor highlighted on the list. o Warunek one of five available conditions (conditions listed in the description of the Alarmy tab). o Wartość warunku a value that if exceeded will cause the alarm to be triggered. o Histereza inertia of the measurement in relation to the defined condition value. It helps to prevent alarms from being triggered as the result fluctuates around the condition value. o Interwał [s] indicates how often is the alarm status to be refreshed. Ustaw stan przełącznika this option is available only when the bus contains switches (sensors with the SW_ prefix). When you check this property, you can select any switch together with its response to the alarm: o Ustaw, gdy alarm włączony alarm occurrence will activate the switch o Ustaw, gdy alarm wyłączony alarm cancellation will activate the switch Wyślij wiadomość this option allows you to send e- mails. o Wyślij wiadomość e-mail to be able to send an e-mail, you need to provide the correct e-mail address of the recipient. It is also possible to specify whether the e-mail is to be sent exclusively in response to the occurrence of an alarm or also in the case of its cancellation. Opcje wiadomości configuration of the content of messages being sent. o Dołącz tekst the message is accompanied by text that has been entered by the user into the text field below the option. A message can be up to 200 characters long. This length is further reduced when the Wyślij wiadomość e-mail option is checked. o Dołącz pomiar the message is accompanied by the measurement from the sensor assigned to the alarm. o Dołącz MAC czujnika the message contains the sensor s MAC address.
Once the selected alarm parameters have been defined, click the Zapisz button to store the alarm in the controller s memory in the first empty slot. The controller lets you store up to 40 freely configurable alarms. NOTE: Alarms can be assigned to most of available 1-Wire devices. The only exception here is the switch (sensor with the SW_ prefix) that can be controlled only by an alarm assigned to another sensor (the Ustaw stan przełącznika option).
Aliasy czujników To make it easier to identify 1-Wire sensors connected to the controller, it is possible to assign user-defined names (alias names). When you select Opcje Aliasy czujników, a window will be displayed containing a list of available (currently connected to the controller s 1-Wire bus) sensors together with their current values. Fig. 14. The alias name definition window. If you click the Zapisz button, values input in the Nazwa field will be automatically assigned to measurements. Leaving the Nazwa field blank will cause the MAC address of the measurement to be displayed. The list of all alias names is stored in an XML file named aliases.xml that is created in the installation folder.
5. Visualizing controller measurements In the case of individual installations for applications in households or small server rooms, you can use the FlashWizual software. The philosophy behind it is very simple. When you enter the controller address together with your login and password, you will be able to download sensor measurements and designations. All you need to do then is to arrange the images, animations and other visualization components to form visualization screens. With the Właściwości window, you can define component parameters and, if necessary, rescale the measurement data. A key advantage of the technology behind this software (Macromedia Flash) is the possibility of adding SWF animations to visualization screens. This includes also Action Script elements and advanced vector graphics. This all makes the tool a visually interesting working environment for supervising the monitored facilities. Once created, visualization screens can be saved and shared via a Web server using the ZPAS Control Oversee system. In such case, you gain access to additional remote tools for viewing measurement archives, using aggregation functions and handling alarms. Below, you will see a working environment for creating visualization screens. The window shows components and their properties. For convenience, whenever possible, visualizations can be created by dragging and dropping components with a mouse.
Fig. 16. A sample visualization of controller measurements.
5.1. First steps with FlashWizual FlashWizual will display all measurements that have been assigned with alarms in the controller s configuration software. The remaining measurements will not be visible. After successful configuration, the next step is to read the available variables from the controller. To do so, go to Połączenia Sterownik. Once connection with the controller has been established, information on measurements should be available: For subsequent operations, you can use names of measurement available in the controller. For example, if you want to display the measurement of temperature, position the Opis component from the library over the visualization screen and set the corresponding measurement of temperature in the menu. To facilitate identification, the ID of the sensor is preceded by the T_ prefix. For convenience, the measurement value is accompanied by text input in the Opis field, for instance to indicate the unit of measurement, e.g. C, % and more. For unconverted measurements, e.g. humidity, it may be necessary to convert them before they are displayed. This can be done by using conversion factors A, B and Offset. The result is then displayed according to the following formula: X = (Measurement * A)/B + Offset For humidity, A=32.6, B=1, Offset= -25.8
Displaying temperature measurements: Displaying humidity measurements:
Measurements can also be used to control component parameters. The examples include displaying an image in response to the occurrence of the flooding alarm. The flooding sensor at the integration module is triggered by the ground signal. In the absence of flooding, the controller s measurement is at 5V, whereas during flooding, it drops to below 4.5V. Therefore, A needs to be set to -1, and Offset to 5. Here is an example: Another possible application for measurements are macros. Start defining macros by providing a name and then selecting a macro in the Zarządzanie makrami window: For instance, the following conditional statement:
IF [V_FB00000067DFFA26]>1 then CHPAR(Progress_bar3,_visible,false); will have the following effect: when the measurement value is greater than 1, the _visible parameter of the Progress_bar3 component will change to false. If you want the conditional statement to be executed for each measurement, make sure it is included in the onpomiar macro. A macro can also be activated by clicking a button or an image. However, such macro needs to be assigned to the component. To do so, select it from the properties window.
Macros support the following commands: Command name CHPAR Action, example Changing parameters for components in use. CHPAR(Component_name,attribute,value) CHPAR(Image1,x,100) ATTRIBUTES: text alpha visible x y height width xscale yscale colour IF Conditional statement IF T1=0 then CHPAR(Image1,_visible,true) PRINT_FORM Printing the displayed visualization. RUN Running another visualization screen. RUN( run5.ovr )
6. Sample connection diagrams
7. Troubleshooting and FAQs JAVA environment 1. How to check the current version of the JRE? MS Windows: Go to Start Run and launch the cmd command. Enter the following string in the displayed window: java version Unix/Linux: Enter the following string in the system console: java -version 2. Error: javaw is not recognized as a command This error occurs when no JAVA environment is installed or its paths are incorrect. To solve the problem, add the destination folder of the javaw.exe file to the PATH variable (by default: C:\Program Files\Java\jre1.5.0_11\bin). 3. Error: Exception in thread "main" java.lang.noclassdeffounderror: org/jdom/content The package needed to be able to launch the application has not been found. The application needs to be reinstalled. 4. The program cannot be launched. Please reinstall the application. Defining alarms 1. How many alarms can be defined in the controller? The ST-50 controller can store up to 24 alarm conditions. 2. How can I simultaneously send an alarm notification to a phone number and e-mail address? You need to define two similar alarms that differ only in the notification method. 3. The controller cannot send e-mail messages. The reasons can be numerous: an incorrect e-mail address has been entered an incorrect SMTP server has been entered
8. Contact information Technical Support and IT Development Department Phone 0 (10xx) 74 / 872 01 49 www: http://oversee.zpas.net Zakład Produkcji Automatyki Sieciowej S.A. ul. Przygórze 209 57-431 Wolibórz