NetBiter WEBSCADA User Manual GSM/GPRS

Transcription

1 User Manual IntelliCom Innovation AB Linjegatan 3D SE Halmstad SWEDEN Phone Fax www

2 Revision List Revision Date Author Chapter Description JOAK/CHDA All First released version Preface The data and illustrations found in this document are not binding. We reserve the right to modify our products in line with our policy of continuous product development. The information in this document is subject to change without notice and should not be considered a commitment by IntelliCom Innovation AB. IntelliCom Innovation AB assumes no responsibility for any errors that may appear in this document. Trademarks NetBiter is a Trademark of IntelliCom Innovation AB. All other trademarks or registered marks in this manual belong to their respective manufacturers. IntelliCom Innovation AB Page 2 (53)

3 Table of contents Revision List... 2 Preface... 2 Warranty and support... 4 Product return... 4 Terminology About the NetBiter WEBSCADA General Mounting Connectors ModbusRTU/ASCII interface, RS Ethernet interface Power supply connection Digital inputs RS232/RS485/RS422 interface LED Indicators LED description Getting started Configure the NetBiter IP-address About the NetBiter Config utility Installation Scanning for connected devices Changing IP settings Log in Web-page overview Browser requirements Menu overview Configuration menu Setup menu Status Modem Status Alarm Alarm history Log Module Configuration Work-flow Create a template Device configuration Pages Adding parameters to web-page Picture Page name Alarm configuration Defining alarms Log configuration Bindings Module Setup Users Modbus settings IntelliCom Innovation AB Page 3 (53)

4 5.2.1 Internal Registers Modem settings Insert SIM card Generic modem settings Dial-up/GPRS settings Dial-in settings Regional Time and date Log file Module information Setup SMTP Authentication SNMP Setup Web-server Setup Ethernet (TCP/IP) settings Backup Firmware FTP NetBiter.net APPENDIX A: Specifications APPENDIX B: Internal registers APPENDIX C: SNMP APPENDIX D: NetBiter.net Warranty and support To obtain fast and simple support for your NetBiter products, please use our Internet support service at Here you will find the latest documentation, configuration utilities, drivers etc. You can also contact our support at Product return If you experience any problems with a NetBiter device and wish to have it repaired or exchanged, you ll need to follow these steps: Obtain a Product Return Number, PRN, from To get this number you ll need to provide some information about the problem you have, contact information etc. Print the PRN Acknowledge side and send it to IntelliCom together with the product. Make sure the PRN is visible on the outside of the package, and that the delivery is pre-paid, otherwise the delivery won t be accepted by IntelliCom. Also provide evidence of original purchase. If the faulty product is covered by the 12-month warranty, IntelliCom will repair or exchange the unit and return it within three weeks. If the product is not covered by Warranty, IntelliCom will respond with a cost-estimation for repairing the unit. IntelliCom Innovation AB Page 4 (53)

5 Terminology Term Extract Description TCP/IP Transmission Control Protocol/ Internet Protocol TCP (Transmission Control Protocol) is a set of rules used along with the Internet Protocol (IP) to send data in the form of message units between computers over the Internet. HTTP Hyper Text Transfer Protocol HTTP is a set of rules for exchanging files (text, graphic images, sound, video, and other multimedia files) on the Web. DHCP Gateway Template Device Dynamic Host Configuration Protocol DHCP is a standard protocol that automates the process of configuring network hosts by allowing hosts to obtain IP addresses and configuration parameters A device that makes it possible to transfer data between networks of different kind, e.g. Modbus/RTU and Modbus/TCP. Describes a Modbus slave device, as a collection of groups and parameters. A Modbus slave unit that is connected to the webscada. This symbol indicates useful instructions on how to use the product. This symbol indicates important information about the product. IntelliCom Innovation AB Page 5 (53)

6 1 About the NetBiter WEBSCADA 1.1 General The NetBiter WEBSCADA module acts as a bridge from Modbus TCP to Modbus RTU, making it possible for a Modbus TCP based controller to connect with Modbus RTU based devices. The NetBiter WEBSCADA will also handle alarm management, data-logging as well as providing a web-based user interface for accessing data. It also contains a modem to allow a wireless connection when a wired interface is not available. Some WEBSCADA features Graphical user interface that is easy to work with. Support for device templates to allow easy and flexible management of configurations. Advanced modem handling, with integrated modem. Improved alarm handling, now with alarm history and SNMP support. Language support. Support for sending log-files with or FTP. Support for the NetBiter.net portal. NetBiter WEBSCADA supports an RS-232 connection through a 9-pole DSUB or RS-485/422 (screw connection). It also supports 10/100Mbps Ethernet through a standard Ethernet connector (RJ-45). It can be configured via a user-friendly web-interface or by using the NetBiter Config utility (available at IntelliCom Innovation AB Page 6 (53)

7 1.2 Mounting A Snap on B Snap off 1. Snap the NetBiter on to the DIN-rail (as described on picture A above). 2. Connect the Ethernet cable to the RJ45 connector. 3. Connect the ModbusRTU network to the DSUB connector (RS-232) or the screw connector (RS- 485/RS-422). 4. Insert SIM-card (if applicable). 5. Connect the Power Supply and apply power. 6. Now you can start using the Gateway. Use the NetBiter Config Utility to configure the IP address and other network settings. See section 2.1 Configure the NetBiter IP-address on page 12 for further information. The default IP address of the NetBiter is Please change this IP-address to a valid address in your network. Also, make sure not to power up more than one network attached NetBiter before IP-address is changed or DHCP enabled. IntelliCom Innovation AB Page 7 (53)

8 1.3 Connectors ModbusRTU/ASCII interface, RS-232 The 9-pole DSUB, male connector on the NetBiter module contains an RS-232 interface. This port can be used to connect to any equipment with an RS-232 interface. Pin number Function 1 CD (Carrier Detect) 2 Rx (Receive) 3 Tx (Transmit) 4 DTR (Data Terminal Ready) 5 GND 6 DSR (Data Set Ready) 7 RTS (Request To Send) 8 CTS (Clear To Send) 9 RI (Ring Indicator) Serial interface (DSUB-9, RS-232) Ethernet interface (RJ-45, 10/100Mbps) IntelliCom Innovation AB Page 8 (53)

9 1.3.2 Ethernet interface The Ethernet interface supports 10/100Mbps, using a standard RJ-45 connector. PowerSupply Serial interface RS-232/ RS-485/RS Power supply connection The NetBiter can be powered by a 12-24VDC supply (Power requirement 3W) Digital inputs The digital inputs are opto-isolated, and can accept a 10-24VDC signal for logic HIGH input. For logic LOW the voltage should be in the range 0-2VDC. The status of the inputs can be read in the Gateway Internal Registers (if enabled). See section Internal Registers on page 36 for more information. IntelliCom Innovation AB Page 9 (53)

10 1.3.5 RS232/RS485/RS422 interface Pin number Function 24 Vin+ 23 GND (Ground connection) 22 Digital input Common 21 Digital input Digital input RS-232 Receive (Input) 18 RS-232 Transmit (Output) 17 Common 16 RS-422 Receive A 15 RS-422 Receive B 14 RS-485 Line A, RS-422 Transmit A 13 RS-485 Line B, RS-422 Transmit B IntelliCom Innovation AB Page 10 (53)

11 1.4 LED Indicators LED description Name Colour Function Module Status OFF No power Green Module is running in normal mode Red During start-up Serial Status Flashing Green Serial Packet receive Flashing Red Serial Packet transmit Red During start-up Ethernet Activity Flashing Green Activity on Ethernet interface Ethernet Link OFF No Ethernet Link detected Green Ethernet network detected, 10Mbps Orange Ethernet network detected, 100Mbps IntelliCom Innovation AB Page 11 (53)

12 2 Getting started 2.1 Configure the NetBiter IP-address About the NetBiter Config utility The NetBiter Config utility is a PC-based configuration utility to set TCP/IP network settings in the NetBiter. This utility has the ability to scan the Ethernet network for connected NetBiter devices and let the user set IP-address, net mask, gateway, DNS and hostname for each unit Installation System Requirements Pentium 133 MHz or higher 5 Mb of free space on the hard drive Win 98/ME/NT/2000/XP/Vista Network Interface Card (Ethernet) Installation Procedure Download the self-extracting installation package NetBiter Config Utility from and run it Scanning for connected devices First ensure that you have connected the NetBiter units you want to install on the same Ethernet network as the PC is connected to. Use standard Ethernet cables, straight-through or crossover cable depending on how you connect to the device. See pictures below for details. Connecting the NetBiter to a hub or Switch IntelliCom Innovation AB Page 12 (53)

13 Connecting the NetBiter directly to a PC When the NetBiter Config utility is started, it will scan the Ethernet network for NetBiter devices. All detected devices will be presented in a list in the main window. If you want to force a new scan for devices, you can press the Scan button. IP - The IP address of the NetBiter SN - The subnet mask GW - The default gateway DHCP - Dynamically assigned IP address On/Off Version - Firmware version Type - Product type (webscada) MAC - The Ethernet MAC address Use the Advanced Options button to enable the NetBiter Config DHCP Server. This is useful when you have set DHCP to On in the NetBiter, but don t have a DHCP-server available on the network. IntelliCom Innovation AB Page 13 (53)

14 2.1.4 Changing IP settings To change the IP settings on a detected device, double-click on the device you want to configure in the list of devices. This will open up a dialog where you can enter the desired IP configuration. To obtain the necessary information about IP address, subnet mask etc. please contact your network administrator. DO NOT SET DHCP TO ON IF YOU DON T HAVE A DHCP-SERVER AVAILABLE ON THE NETWORK. Host Name - Here you can enter a hostname of your device (optional). IP Address - The IP address of the NetBiter. Netmask - The subnet mask Gateway - The default gateway Primary DNS - The primary Domain Name Server (optional) Secondary DNS - The secondary Domain Name Server (optional) The default password for authentication of the new settings is admin. Pressing Set will cause the NetBiter device to reboot and after that the new settings will be enabled. You can test the new settings by opening a web-browser and enter the IP you assigned to the device. If you selected DHCP and want to know what IP your device have been assigned, you can do a new scan with the NetBiter Config utility to view the new network configuration. IntelliCom Innovation AB Page 14 (53)

15 2.2 Log in Open a web browser (Internet Explorer for example) and enter the IP address you have set on the NetBiter unit with the NetBiter Config utility. For example, if you entered the address then you should enter the text below in the address field of the browser and press enter. Now you should see the login screen: To be able to configure the Gateway you should enter admin in the user-name box. The default password is admin. You can later change the default password to something else (recommended). This will be described in section Users on page 33. If you have problems to log in and you are sure that your password is correct, make sure that Caps Lock is not enabled on your keyboard. IntelliCom Innovation AB Page 15 (53)

16 3 Web-page overview 3.1 Browser requirements The web-pages are optimized for Internet Explorer and Mozilla Firefox. Other browsers can work as well, but the web-pages might appear differently. The browser must be JAVA enabled, to use pages with JAVA content (like the graph page). If it s not, please visit to download a JAVA-plugin for your browser. The picture below shows the welcome screen which is shown when you first log into the module. 3.2 Menu overview To navigate on the web-pages, use the menu items available: Select Page(Go), Status, Alarm, Log, Configuration and Setup. Logout Button IntelliCom Innovation AB Page 16 (53)

17 3.2.1 Configuration menu When you choose the Configuration menu, a sub menu will appear: The Templates configuration sub-menu will be used to create, edit and backup templates for your devices. On the Devices screen you define the devices which you connect to the NetBiter WEBSCADA. On the Pages screen you create and edit the structure of the presentation web-pages and also select parameters to be presented. The Alarm screen can be used to enable/disable SMS/ /SNMP alarms, and also to create and modify alarm parameters. On the Log configuration screen it s possible to configure the behaviour of the log-file, and also create/modify log-parameters. The Bindings configuration screen makes it possible to enable automatic parameter copying from one Modbus slave to another at a configurable interval Setup menu When you choose the Setup menu, a sub menu will appear: The Users screen is where all things related to user management are handled. The Modbus screen handles all ModbusRTU/ASCII and ModbusTCP configuration. The Modem screen handles all modem configurations (GSM, GPRS, dial-up, dial-in). The Regional settings screen configures things like date/time and generic module information. The screen configures all that is needed to send s from the module. The SNMP screen makes it possible to configure SNMP trap properties. The Webserver screen can be used to define which port web-server should use. The Ethernet screen handles all TCP/IP configurations, like IP-address, DHCP, DNS etc. On the Backup screen it s possible to backup/restore all settings, and also do a factory reset of the webscada module. The Firmware screen can be used to download new firmware to the module. The NetBiter.net screen is used to setup the device to use the NetBiter.net services, see APPENDIX D: NetBiter.net at page 51 for more information. IntelliCom Innovation AB Page 17 (53)

18 3.3 Status This page shows some status information about the Modbus interface. The Status screen is split into two columns, Modbus/TCP messages and Other Modbus messages. The Modbus/TCP messages field shows information about requests that originate from a master attached to the gateway, and Other Modbus messages field shows information about requests that originate from either internal applications (Log/Alarm) or WebPages. Number of connections - Indicates the number of open connections to a Modbus TCP master. Internal queries indicate number of pending queries from WebPages + the internal connection from (Alarm/Log) application. Valid Responses - Counts valid responses from the Modbus/RTU slaves. Serial Timeouts - The number of time-outs from attached slaves. CRC Errors - The number of CRC errors on incoming Modbus/RTU responses. Buffer Overruns - If an incoming Modbus/RTU response is larger than 300 bytes, this will cause the input buffer to overflow. Frame Errors - If an incoming Modbus/RTU response has incorrect length or some other fault in the frame, this will cause a Frame Error. Exception Responses - Counts all exception responses from the connected Modbus/RTU slaves. IntelliCom Innovation AB Page 18 (53)

19 3.3.1 Modem Status The modem status field gives information about what state an attached modem is in. Connecting to Internet: Calling Internet Service Provider and negotiate for a connection. Waiting for incoming connection: The unit is waiting for an incoming call. Waiting for Event/Alarm: The unit is in standby mode, and when an alarm or event appear it will connect to Internet. Connection established: A connection to Internet is established and data will be sent. Incoming connection is in progress: There is an incoming call and correct baud rate, user name and password is being verified. Modem disabled: Not possible to connect using the modem IntelliCom Innovation AB Page 19 (53)

20 3.4 Alarm The Alarm page shows all active and unacknowledged alarms. It is also possible to select to view the status of all configured alarms. Use the button in the lower left area of the screen to toggle between the two modes Alarm history The Alarm History screen shows all alarms that have occurred. To clear this list, click the clear history button. IntelliCom Innovation AB Page 20 (53)

21 3.5 Log From this page it s possible to download the log file from the NetBiter WEBSCADA (if logging has been enabled). Simply click the download button to download/view the file, or click the clear button to remove all data from the log-file. To view the log-file as a graph, make sure that JAVA is installed on your computer. The graph will show all parameters in the log-file, but in the graph it s possible to select which parameters to show (by clicking on the square next to the parameter name).the three first log points will be displayed in the graph. To show a log-point just click the square in front of the parameter name. To make it disappear from the view click the square again. At the top right corner there navigation buttons: Scroll graph up Back to starting view Scroll graph left Scroll graph right Zoom in Zoom out Scroll graph down By using a left click on the mouse, keep the button down and release it at the diagonal corner of a box the graph will zoom to that size. By right clicking and keeping the button down the graph can be scrolled by moving the mouse. IntelliCom Innovation AB Page 21 (53)

22 4 Module Configuration An important concept for the NetBiter WEBSCADA is the usage of templates. This allows the user to define templates for different products and configurations, and then easily re-use and distribute them. A template contains properties for available parameters in a device of a certain type. These properties includes: Parameter Names, Modbus register types and addresses, data scaling and presentation. See also Application Note AN-1003 for more details about how to create a configuration. (Can be downloaded from Work-flow Follow these steps to get your NetBiter WEBSCADA operational: 1 Do all generic Setup, like assigning an IP-address (Setup/Ethernet), add/modify users (Setup/Users), configure the Modbus interface (Setup/Modbus) and set date/time (Setup/Regional). 2 Create a template (Configuration/Templates). A Template consists of one or several groups, and each group is a collection of Modbus Parameters. 3 Define your Devices (Configuration/Devices). Device is simply a Modbus slave, with a unique Modbus address. For each Device, you apply a Template. 4 Create your Application! Now you can define your web-pages, alarms, log entries and bindings. 4.2 Create a template Clicking on the Configuration and then Templates link will bring up the following screen: To create a template, click the new template button. Enter the name of the template in the window that pops up. Click edit to make it possible to add new groups (a collection of parameters) and new parameters, or edit an existing template. From this page it is possible to backup, restore (update templates) and delete templates. To upload a template click the upload template button to upload a template. There will be a window appearing waiting for the user to browse to the template file, and click upload template when the file is found. Also check out the IntelliCom Template page, where templates from different manufacturers will be published. You must always add a Group, before you can add a Parameter. IntelliCom Innovation AB Page 22 (53)

23 When you have created a Group, and at least one parameter, it s possible to edit the Parameter by clicking the edit button. This will bring up the following screen (Edit Parameter): Click on the? to view the online help at the upper right corner of the Edit Parameter window IntelliCom Innovation AB Page 23 (53)

24 The Edit Parameter screen contains the following fields: Name Description of the parameter. Type Modbus type (Holding, Input, Coil, Discrete) Address Modbus address Datatype - Defines the datatype of the Modbus register. Can be one of the following: Unsigned bit positive value Signed bit value, with sign Unsigned bit positive value. Most significant word (register) on low address. Signed bit value, with sign. Most significant word (register) on low address. Unsigned 32 (swapped) - 32-bit positive value. Most significant word (register) on high address. Signed 32 (swapped) - 32-bit value, with sign. Most significant word (register) on high address. Float 32-bit floating point. (IEEE-754) Most significant word (register) on low address. Float (swapped) - 32-bit floating point. (IEEE-754) Most significant word (register) on high address. Double - 64-bit floating point. (IEEE-754) Most significant word (register) on low address. Double (swapped) - 64-bit floating point. (IEEE-754) Most significant word (register) on high address. Scaling - The Modbus register value will be divided by the scale value before presented on the web-page, logged or compared with for alarm. It will be multiplied with the scale value before value is written to a slave device. Examples: Modbus register value = 510, Scale value = 10 51,0 will be viewed on web-page. Modbus register value = 5118, Scale value = ,18 will be viewed on web-page. Web-page input = 127,5 Scale value = will be written to Modbus register. IntelliCom Innovation AB Page 24 (53)

25 Offset The Modbus register value will be subtracted with the offset value before it is presented on the webpage, logged or compared with for alarm. If scaling is also in use it is done before the offset is subtracted. The Offset value will be added to the value before value is written to a slave device. If scaling is also in use it is done after the offset is added. Mask - Is used to mask out specific bits from the Modbus register, on the webpage the value is presented in binary. The Modbus register will be masked (logic and) and shifted to the right before the value is presented on the web-page, logged or compared with for alarm. Examples: Modbus register value = 214 (D6 hex), Mask = 240 (F0 hex) 1101 (13) will be viewed on web-page. Presentation - Defines how a value will be represented on a page. Available options are: Show as value This option will read from the address and present the result at the view-page. Writeable value This option reads the value from the address and presents it. There will be a set button next to the value at the view-page which makes it possible to write to the address. Show with enumeration This option will read the value from the address and present it with the corresponding enum string (See Enum below). Writeable value with enumeration This option will read the value from the address and present it with the corresponding enum string. There will be a drop down next to the value at the view-page where available enum strings will be selectable. A selected value will be written to the address. Enum - here the enum variables is defined in following format [number]=[string]. Each enum is separated by a semi colon ; with no blank spaces. Examples: 0=Off;1=On 0=Sunday;1=Monday;2=Tuesday;3=Wednesday;4=Thursday;5=Friday;6=Saturday Number of decimals Defines how many decimals to use for this point. Valid range defines min and max value for a write parameter. If a user tries to enter a value outside the range, a warning message will appear. When you are finished with the Template, continue to the Device Configuration. IntelliCom Innovation AB Page 25 (53)

26 4.3 Device configuration On the Device Configuration page, you define which Modbus slaves are attached to the webscada. To add a device, click the add device button. This will bring up the following screen: Name A description of the device. Template Defines which template that should be associated with this device. Modbus/TCP server IP address If using Modbus/TCP the IP address should be entered here. When using Modbus/RTU it should be left blank. Modbus/TCP server port The port that is used for the Modbus/TCP communication. Modbus slave address Defines the Modbus address for this device. The next step is to create your NetBiter WEBSCADA application, by defining the look of the web-pages and which alarms and log-parameters that should be available. IntelliCom Innovation AB Page 26 (53)

27 4.4 Pages To create a new page, click the add page button. This will bring up the General Page Configuration: On this page all page properties can be configured. A maximum of 20 Modbus points can be on each page. Next step is to define where to display the parameters. Simply click the edit button on the position you want to work with Adding parameters to web-page Now select the Device, Group and Parameter and enter a description for this parameter, and finish by clicking the save settings button. To check that everything is OK, go to the Select page in the menu, select the page you have been working with and hit the Go button. You can also define a presentation format and presentation scaling on this page. Presentation format You can select a different presentation for a value on the presentation pages. Default Value is presented as it is configured in the Device template. Hexadecimal Value is presented in hexadecimal form. Binary Value is presented in binary form. IntelliCom Innovation AB Page 27 (53)

28 Presentation scaling You can add an additional scaling on the value before it is presented on the web-page. The value will be divided by the scale value before presented on the web-page. It will be multiplied with the scale value before value is written to a slave device. It is normally better to use the scaling in the Device template because that will also include logging and alarm Picture This option lets you choose a picture to be presented on the page. The picture must not be more than 870 pixels wide and must be in gif, jpg or png-format. The picture will be sent to the device when you press the Upload button. To remove a picture from the device, press the Clear button. There are maximum 800kB available for pictures. On the General Page configuration section you can see how much space remains Page name This field can be used to give the page a more descriptive name. Click the set as start page button if this page should be the first page to be presented when logging into the module. It s also possible to change name on the Page menu (default Overview and Advanced Overview ). IntelliCom Innovation AB Page 28 (53)

29 4.5 Alarm configuration The NetBiter WEBSCADA can send alarm messages with , SMS or SNMP (traps). The alarm functionality can be enabled/disabled on the Alarm configuration page. A maximum of 64 alarm parameters can be configured. To upload alarm status to NetBiter.net it has to be enabled on this page. Make sure that the NetBiter.net account is activated on the page Setup/NetBiter.net, see section 5.11 on page 47. IntelliCom Innovation AB Page 29 (53)

30 4.5.1 Defining alarms To add an alarm point, click on the edit button in the Alarm Configuration list. This will bring you to the following screen. Here you need to select which parameter to use, and define the trigger operation that will activate the alarm. You also need to define some properties like alarm class (1-10), and what strings should be in the subject and message field of SMS/ alarms. Trig On - this configures the trig condition for the alarm parameter. It s possible to trigger on a Value ( Higher than, Lower than, Equal to, Not Equal to, Change of Value ) or on a bit-field ( Any bit, Neither bit, All bits ). The option No response is used to send an alarm if there is no response from the module. Alarm class - Can be used to set different priorities on the alarm (class 1-10). The Alarm Class has to be set for each user that alarm message will be sent to. This is done at the configuration page for the user. Severity The severity of the alarm. - Warning - Minor - Major - Critical - Indeterminate The alarm could also have the severity Cleared, that cannot be set but will be sent via SNMP when the alarm is in normal state. Every alarm will be sent as a SNMP trap message. Description The text that is displayed in the alarm views and sent via SNMP. Subject Defines the text to be shown as Subject in the /sms Message The body of the alarm message IntelliCom Innovation AB Page 30 (53)

31 4.6 Log configuration NetBiter WEBSCADA can be used to log Modbus registers. All data is stored in a CSV-file that can be uploaded to a computer for further analysis in e.g. Excel. A maximum of 64 parameters can be configured. To start logging, click the start button. Estimated Log Time gives an estimate about how long it takes to fill the log-file. Log interval defines the sample interval. Log type choose whether to stop logging when the log has reached its maximum, or to overwrite old values (circular log). Send log interval enable this if you want to send the log-files periodically with or ftp. You can choose to send the log every hour, every day (will be sent around midnight) or every week (Sunday at midnight). You will also need to activate this function on each user that should receive the log-files. Send log files with enable this if you want to send the log-files periodically with with the Send log interval set above. Make sure that each user that should get the logs by has this function activated for the user. This is configured at Setup/User and edit settings for that user, see section 5.1 on page 33. Upload log files to ftp server enable this to upload log-file to ftp server periodically with with the Send log interval set above. Make sure that the NetBiter.net account is activated, or that there is a ftp-server stated at Setup/FTP, see section 5.11 on page 47. When the log is stopped there will be no more log sent. When the logging is started again the log will be cleared. To send the latest logged data there is a send now button before restarting the logging. The log-file that is stored in the NetBiter will contain historical data for a maximum of two periods as defined in the Send log files with property. I.e. if you set this to every day, the log-file in the NetBiter will keep a maximum of two days historical. IntelliCom Innovation AB Page 31 (53)

32 See also Setup/Regional settings to make sure you have the correct settings for list separator and decimal symbol, see section on page 39. To add a log-point, click the add log parameter button, and then the edit button. This will bring you to the Edit Log Entry page. Now you can select the Device/Group/Parameter you want to log, and also enter a description for this Log Entry. To finish, click the save settings button. 4.7 Bindings Bindings are a feature that allows you to copy parameters from one Modbus device to another. To add a binding, click the add binding button. On the Add Data Binding screen you choose the Source and Destination parameter, and the interval for the copying of data. IntelliCom Innovation AB Page 32 (53)

33 5 Module Setup If you click on the Setup menu option, a sub menu will appear. Here you can do all necessary setup for things like user administration, modem settings and TCP/IP settings. 5.1 Users If you press the Users link you will be transferred to the Users administration page. Here you can add, edit and remove users. To add a user, press the add user button, and to modify/remove a user click on the user you want to modify/remove. IntelliCom Innovation AB Page 33 (53)

34 Here you can enter the User ID (used on the login screen), name, contact info and a password. If an address is entered, then alarms will be sent to this address (if user is configured as an alarm recipient and alarm is enabled). If a mobile number is entered, then SMS-alarms will be sent to this number (if user is configured as an alarm recipient and SMS-alarm is enabled). To configure a user as an alarm-recipient, enable one or more of Alarm classes (Class 1-10). It has to be set to get alarm mail or SMS for an alarm point with the corresponding alarm class set. Make sure that the alarm has the correct alarm class set when edit the alarm point, see on page 30. The user will only receive alarms that match this selection. The Receive log files via option configures whether this user will receive logs via or not. See Configuration/Log (section 4.6 on page 31) for more details about this function. The language selection defines which language will be used for this user. The user level defines what the user can do on the web-pages: Read - View pages but can t do any configuration or modify Modbus Registers Write - Can view pages and modify Modbus registers, acknowledge alarms. Admin - Read, Write and also configure the module (templates, devices, pages, alarms, log, and bindings) Super Admin - Read, Write, Admin and setup module like users, modem and Modbus settings. To add/edit users, you must be logged in as a user with Super admin access. IntelliCom Innovation AB Page 34 (53)

35 5.2 Modbus settings If you press the Configuration/Modbus menu you will be presented with the following view: Serial Settings (Modbus RTU/ASCII) Transmission mode - Selects Modbus RTU or Modbus ASCII Slave Response Timeout - The time that the module will wait for a response from a slave, before a serial timeout will occur. (Default 1000 ms) Physical Interface - EIA-485 or EIA-232 Baudrate - 300, 600, 1200, 2400, 4800, 9600, 19200, 38400, or bps. Character Format - Select number of stop bits and if parity should be enabled (Odd, Even). Delay between polls - time to delay between Modbus messages. Character delimiter - Number of milliseconds between characters in the Modbus frame. Set to zero to use standard Modbus (3.5 characters) Force function code 15 when writing single coil - If this option is Enabled, all writes to coils will be done with function code 15. (Useful if slaves don t support function code 05). Force function code 16 when writing single register - If this option is Enabled, all writes to registers will be done with function code 16. (Useful if slaves don t support function code 06). IntelliCom Innovation AB Page 35 (53)

36 Ethernet Settings (Modbus TCP) Port number - Which port to use for Modbus TCP communication (502 default). Gateway Registers - The address to the gateway internal registers (if enabled). See section Internal Registers on page 36 for more details. Server Idle Timeout - This parameter gives the idle timeout in seconds for the Modbus/TCP connection. If the Gateway doesn t receive any Modbus/TCP query within this time the connection will be closed. (Default value is 60 seconds). IP Authentication - This can be used to configure the IP-number that is allowed to connect to the Gateway. It is of great importance to ensure at the time of the procedure of assigning Modbus device addresses, that there are not two devices with the same address. In such a case, an abnormal behavior of the whole serial bus can occur, the Master being then in the impossibility to communicate with all present slaves on the bus Internal Registers If Gateway registers are enabled, queries sent to that address will not be forwarded to the Serial Modbus/RTU network; the Gateway will respond to these queries by itself. See Appendix B for a list of the internal registers. Valid Modbus commands for internal registers: Command Name 3 Read Holding Registers 6 Preset Single Register 16 Preset Multiple Registers The internal registers are also available as an internal template, i.e. the registers can be used on presentation pages and as alarms/log entries. IntelliCom Innovation AB Page 36 (53)

37 5.3 Modem settings Insert SIM card Open the SIM card holder using a pen, or something small, to push SIM card holder release button. Insert the SIM card in the SIM card holder and the holder into the NetBiter as shown in picture. On this page you can setup the internal modem Generic modem settings In this section the PIN-code for the GSM-modem can be entered. Clicking on the modem info button will bring up a screen with some details about the modem (Signal strength etc). IntelliCom Innovation AB Page 37 (53)

38 5.3.3 Dial-up/GPRS settings In this section you find configuration to allow the NetBiter WEBSCADA to connect to Internet using a modem. Dail-up Select the type of service that will be used. Connection trigger Specifies whether the NetBiter WEBSCADA should always be connected to Internet using the modem, or only connect when there is an alarm or event. Host to ping address to the Host that the NetBiter WEBSCADA will ping when sending keep-alive messages for the GPRS connection. Ping timer Specifies the interval for the keep-alive messages. (Set value as high as possible to avoid unnecessary GPRS traffic). Access Point Name (APN) This is the gateway for all GPRS traffic. Contact your operator for information about this. Phone number Phone number to dial (e.g. to an Internet Service Provider, ISP). User name This is the user name your ISP has assigned to you. Password Password to log into the ISP network Dial-in settings The dial-in functionality can be used when someone wants to view the web-pages in the NetBiter WEBSCADA over a modem-link. Dail-in Select if this service should be enabled or disabled. Local IP-number This is the IP-number of the NetBiter WEBSCADA, which the remote client will see when creating the PPP-connection. Remote IP-number This is the IP-number that will be assigned to the remote client, when creating the PPP-connection. User name This is the login that the remote client will use when creating the PPP-connection. Password - This is the password that the remote client will use when creating the PPP-connection. IntelliCom Innovation AB Page 38 (53)

39 5.4 Regional The Regional page contains configuration for time and date, generic module information and also configuration for how the log file list separator and decimal symbol should be represented Time and date This configures the real-time clock on the module. The clock will continue to work during power-loss (max. 1 week). To use NTP (Network Time Protocol), enable it and enter an NTP-server (or use the default configuration). Also set the update interval (how often NTP will synchronise the time) Log file List separator - Can be either colon (,) or semi-colon (;). Decimal Symbol Can be either dot (.) or colon (,). The list separator and decimal symbol should be selected so it matches the configuration on the computer where the file will be analysed. IntelliCom Innovation AB Page 39 (53)

40 5.4.3 Module information The Location string can be used to add information about where the module is located (address, building id etc.) This information will be viewed on all pageheaders. The More information field can be used to do notes about the installation Setup The following configuration properties are available: SMTP server IP-number or domain name to the SMTP server that the module should use when sending s. If domain name is used make sure that you have entered a DNS under the Network configuration. You can choose to use the NetBiter.net server to forward s. Simply click NetBiter.net and activate your NetBiter.net account, see section 5.11 on page Port number: The port that is used by the SMTP-server for incoming mail given by your Internet service provider. For custom servers this is set to port 25 as default. When using the NetBiter.net services it is set to port SMTP Authentication - Authentication method: Auto, plain, login or cram-md5 - User name - Password Sender From field in the alarm mail. Example NetBiter Reply path The address to send a mail to when someone reply on an alarm mail. IntelliCom Innovation AB Page 40 (53)

41 5.5.1 SMTP Authentication If the SMTP server require authentication you should enable SMTP Authentication. There are several types of authentication methods supported by the module: auto The module automatically select the best method supported by the SMTP server. plain a simple non-encrypted method supported by most SMTP servers. login a simple non-encrypted method supported by most SMTP servers. cram-md5 a more secure login method where the user name and password is encrypted. (This method is not supported by all SMTP servers). Note: auto will not work if only plain and login is supported by the SMTP server, because the module find these methods too insecure, in that case login or plain must be must be set explicit. To verify the setup, use the Test functionality. Clicking on the send button will generate a test . IntelliCom Innovation AB Page 41 (53)

42 5.6 SNMP Setup The SNMP Setup page contains configuration to be able to send SNMP traps. SNMP Manager The SNMP manager to which SNMP traps should be sent Port The port number on the SNMP manager to which traps should be sent If SNMP is activated for alarms, see section 4.5 on page 29, all alarms will be sent by using SNMP. There is a MIB-file for NetBiter WEBSCADA that can be downloaded from IntelliCom Innovation AB Page 42 (53)

43 5.7 Web-server Setup The Web server Setup page contains a configuration to change the port number of the internal web-server in the webscada and also enable/disable the low bandwidth pages. Extra webserver port - To connect to the Extra webserver port the URL should have a colon : followed by the new port number, i.e. where is the IP number or DNS address to the NetBiter and :8080 the new port. Compression on web pages (Only used for the Extra webserver port) is used to improve the data transfer for low bandwidth connection, such as modem connection. The NetBiter webscada will check if the connecting web browser support compressed data transfers, and then compress the web-pages before sending them. When compression is used the workload of the NetBiter will increase, and that is why this feature is not enabled by default. There is an option to disable compression and the pages will be sent as normal web pages, which always is the case for the standard web server port 80. If it is set to force web pages will always sent compressed regardless the support of the web browser. In some cases the information if the web browser supports compressed data will be altered in the network route, as with Microsoft ISA server default setting for controlling port 80. To ensure that compressed web pages are sent anyway the option force is set. Most web-browsers support compressed data. Auto update values and status (Only used for the Extra web-server port) to minimize the amount of data transferred over a connection with http compression. The data will be read only one time. To refresh values and status the refresh button at the upper left corner has to be clicked. If the web-browser reload button is used instead, unnecessary data-traffic will be generated. Automatic logout time - defines the time-interval before a user is logged out from the web-server. Note: The webserver will always listen on default port 80. Note: When using modem connection, compression on web pages will always be enabled and Auto update will always be disabled to improve response time, and the refresh button has to be clicked to update values and status. IntelliCom Innovation AB Page 43 (53)

44 Ethernet (TCP/IP) settings If you press the Configuration/Ethernet link you will be presented with the following view: On this page you can view and change the TCP/IP network settings in the module. These settings are the same as the ones set by the NetBiter Config utility. Dynamic IP: Select this if you have a DHCP server on your network and you want the IP address be assigned automatically by the server. DO NOT SELECT THE DYNAMIC IP OPTION IF YOU DON T HAVE A DHCP SERVER AVAILABLE ON THE NETWORK. Host Name: Here you can enter a hostname of your device (if alarms should be used this field must contain something) IP Address: The IP address of the NetBiter. Netmask: The subnet mask Gateway: The default gateway Primary DNS: The primary Domain Name Server (optional) Secondary DNS: The secondary Domain Name Server (optional) IntelliCom Innovation AB Page 44 (53)

45 5.8 Backup The backup functionality makes it possible to backup and restore configurations. By pressing the backup button you will get a backup file that can be stored locally. All configurations in the Module except Ethernet settings will be in the backup. To upload a backup to a module, press the Browse button and select an.nbb file, then press restore. After restoring the configuration, you will be asked to restart the module. To bring a module back to Factory default configuration, click the reset button. IntelliCom Innovation AB Page 45 (53)

46 5.9 Firmware Firmware - On the firmware page it s possible to download a new firmware image (.nbu file) or a patch file (.nbp). Software version The MAC address for the module, the version of the kernel and the filesystem version is displayed in this section. Installed updates If there are any updates installed on the system, the name, version and description of the update will show here FTP Files can be sent to a FTP server automatically. To use the NetBiter.net FTP server go to Setup/NetBiter.net. If NetBiter.net is enabled it will override the settings on this web page. More information about the NetBiter.net service can be found in section FTP-server - The server s IP address or DNS name User name - The user name for the server. Password - Password for the server. IntelliCom Innovation AB Page 46 (53)

47 5.11 NetBiter.net NetBiter.net is a solution for remote management of NetBiter devices. This device is ready to connect to the NetBiter.net services using the Device ID and password that was shipped with the device. More information about this service can be found in APPENDIX D: NetBiter.net on page 52 Enable NetBiter.net Service Select if you would like to enable or disable this service. Device ID The Device ID received with the NetBiter. Device Password The password received with the NetBiter. Upload alarm status and history Indicates if the service is activated at the Configuration/Alarm page, see 4.5 on page 29. Upload csv Log files Indicates if the upload log files has been set at the Configuration/Log page, see 4.6 on page 31. Mail server and FTP server will automatically be set to use NetBiter.net services, with correct Device ID and Device password. Some Internet Service Providers, ISP, has blocked the connection to the mail server other than their own mail server. In these cases use the mail server provided from your ISP by setting a custom server and enter login and password that is sent to you by your ISP. IntelliCom Innovation AB Page 47 (53)

48 APPENDIX A: Specifications Ethernet connection 10Base-T or 100Base-TX (IEEE 802.3). RJ45 connector. Internal modem - GPRS Multislot Class 12 - Quad band - SMA Antenna connection - SIM-card, 3V and 1.8V Serial interfaces EIA-232 with full modem control (RTS,CTS,DCD,DTR,DSR,RI) bps. 9-pole DSUB connector EIA-485/422, bps. screw connector. Power Supply 12-24VDC (3W) Temperature range Operating : C Storage : C Humidity range 5-93% RH, non-condensing Cover material Grey plastic, LEXAN 940, self-extinguishing acc. to UL94-V0 Mounting option DIN rail (EN 50022) CE certification According to EN :1993 and EN :1999 RoHS Compliant IntelliCom Innovation AB Page 48 (53)

49 APPENDIX B: Internal registers Holding register Name Values Options Comment 1 Digital input 1 status 0 or 1 Read only 2 Digital input 2 status 0 or 1 Read only 3 Number Active Connections MB/TCP 0-10 Read only 4 Number Active Internal Connections 0-10 Read only Serial Status (Modbus/TCP) See section (3.3) 5 Valid responses Can be cleared 6 Serial timeouts Can be cleared 7 CRC errors Can be cleared 8 Input Buffer overruns Can be cleared 9 Frame errors Can be cleared 10 Exception responses Can be cleared Serial Status (Buffered messages) 11 Valid responses Can be cleared 12 Serial timeouts Can be cleared 13 CRC errors Can be cleared 14 Input Buffer overruns Can be cleared 15 Frame errors Can be cleared 16 Exception responses Can be cleared Serial Status (Internal requests and Webpages) 17 Valid responses Can be cleared 18 Serial timeouts Can be cleared 19 CRC errors Can be cleared 20 Input Buffer overruns Can be cleared 21 Frame errors Can be cleared 22 Exception responses Can be cleared Configuration Registers 23 Modbus/TCP Port Default port number is Gateway Modbus address (-1) Disabled Default Enabled 25 Modbus/TCP idle timeout (seconds) Default 60 seconds 26 Baudrate 0 Disabled Enabled bps bps bps. Default value bps. IntelliCom Innovation AB Page 49 (53)

50 Holding register Name Values Options Comment bps bps bps. 27 Parity No parity Default 1 Even parity 2 Odd parity 28 Number of Stop bits 1-2 Default 1 stop bit 29 Slave timeout time (milliseconds) Default 1000 ms. 30 Physical interface RS-485 (Screw) Default 1 RS-232 (DSUB) 2 RS-232 (Screw) Authentication 31 Valid IP address First byte of IP address 0 Disabled IP address auth disabled Enabled 32 Valid IP address Enabled Second byte of IP address 33 Valid IP address Enabled Third byte of IP address 34 Valid IP address Enabled Fourth byte of IP address 35 Mask for Valid IP address Enabled First byte of mask 36 Mask for Valid IP address Enabled Second byte of mask 37 Mask for Valid IP address Enabled Third byte of mask 38 Mask for Valid IP address Enabled Fourth byte of mask IntelliCom Innovation AB Page 50 (53)

51 APPENDIX C: SNMP If SNMP Alarms is enabled, see page 29, all alarms will be sent as SNMP traps to the host specified on the SNMP page, see section 5.6 on page 42. The OID is sent in the following format in numbers: [IP address][event] [trap_id][trap_data] where is Intellicom enterprise ID 1.1 is products NetBiter webscada and where event: 1 = Alarm set 2 = Alarm cleared A trap id is divided into five messages with following trap data: #1 Alarm ID #2 Alarm description #3 Class ID (1-10) #4 Class description #5 Alarm severity, where 0 = indeterminate 1 = critical 2 = major 3 = minor 4 = warning 5 = cleared See the pictures for example of SNMP trap sent an alarm to warning of high temperature from a NetBiter. To try out the SNMP functionality the software Trap Receiver could be used. This program can be found at Please, check the license for the software. It could be used to examine a trap sent to a PC to better understand the SNMP functionality of the NetBiter WEBSCADA. IntelliCom Innovation AB Page 51 (53)

52 APPENDIX D: NetBiter.net The web site collects and stores data from remote equipment. Through the central server an authorized user can access the information at any time and from any location. This is a free service from IntelliCom that gives customers to the NetBiter WEBSCADA unique possibilities. The NetBiter WEBSCADA devices connect to the central server to submit critical equipment data, such as logged parameter data and alarms. At the server an authorized user can view and manage this information. The only tool the user needs is a standard web browser. The use of one central location for all remote equipment simplifies the work for anyone dealing with remote installations. The NetBiter.net service provides the following functions: Administrate and maintain users, projects, remote field units and data. Storage of log files produced and sent by the NetBiter WEBSCADA field units. View logged data as trend graphs. Management of active alarms and alarm history (alarm notifications updates automatically on the server). View the physical location of remote equipment on a map. Etc This service from IntelliCom is free! NetBiter.net features Trending Store data log files at NetBiter.net and view trend graphs of selected parameter data. Analyze trends to detect early warning of malfunctioning equipment. To be proactive to problems saves time and money immediately as travels to sites can be dramatically reduced. IntelliCom Innovation AB Page 52 (53)

53 Positioning View the location of remote equipment on a map. Easy and improved planning of service routes saves time for any service organization. When an alarm occurs in equipment, that unit in the map will automatically be marked in red colour. Management of users, projects One central place for management of users, remote equipment and critical information. Store important blue prints, pictures, templates and more. Getting Started To get started with NetBiter.net you need to have a NetBiter with NetBiter.net Device ID, which is found in the package. Setup the NetBiter device as it is described in section 5.11 on page 47. Continue with creating an account on the NetBiter.net server by following these steps: 1. Go to 2. If you do not have an account for NetBiter.net you have to create one, otherwise go to step At the lower left corner at the login screen click create account. 4. Enter registration data and read the terms and condition. Click register when ready 5. The address entered in the registration process will get an with an activation key. Just click the URL to activate you NetBiter.net account. 6. Go to and login using the user name and login. 7. Click Projects and create new project. Enter required information. Click next when ready 8. Enter the Device ID and password that was sipped with the device, and select a name for the device. Enter additional information, when ready click save. Now the system is up and running. IntelliCom Innovation AB Page 53 (53)