Universal network-enabled automation interface for home automation, commercial control, and monitoring applications

Transcription

1 BARIONET Universal network-enabled automation interface for home automation, commercial control, and monitoring applications This Manual Describes: Barionet 100 (Original Barionet) Firmware Version: 3.02 Barionet 50 Firmware Version 2.01 Released January 17, 2013

2 Table of Contents 1 Introduction What is the Barionet? Barionet Applications About This Manual Notes, Warnings, and Cautions Chapter Overview Additional documents Getting Support Accessing and Configuring the Barionet Accessing the Barionet for the first time Connecting to an Ethernet/IP network Supplying Power Using the Barionet Discovery Tool Alternatives to the Discovery Tool Opening the Configuration and Status Web Pages Using the Home I/O Status and Control Page Using the Configuration Web Pages The Network Settings Web Page The Serial Settings Web Page The I/O Settings Web Page The Control Web Page The SNMP Web Page The Time Web Page The Temperature Web Page The Security Web Page Hardware Interfaces Barionet 100 Hardware Interfaces Barionet Connectors Overview Ethernet Interface: (ETH) Power Supply Inputs (J6) RS-232 Serial Interface (J2) RS-422/485 Serial Interface (J7) Rescue Jumper (J4) Wire Expansion Port (J5) Relay Outputs (J3) Digital/Analog I/O and Power (J6) Barionet 50 Hardware Interfaces Barionet 50 Connectors Overview Red and Green Status Indicators Ethernet Interface: (J1) Power (J2) RS-232 Serial Interface (J3) RS-485 Serial Interface (J4) RS-485 Termination (S1) Relay Outputs (J5) Wire Port (J6) Inputs (J7) Input Ground (J8) RS-485 Expansion Port (J10) BARIX AG Page 2 / 124

3 4 Software Interfaces Built-in Web Server (HTTP) Web Server CGI ASCII Command Protocol Command Format ASCII Commands Unsolicited State Change Messages Getting Started with the ASCII Command Protocol SNMP Syslog Modbus/TCP Modbus via RS Serial Gateway Function Creating Custom Applications & Web Pages Development Process Overview Creating Custom HTML Pages Barix Dynamic Tags Password Protecting Custom HTML Pages Creating Custom BCL Applications Creating and Editing a BCL File The Tokenizer Loading Custom Web Pages and BCL Applications Creating a COB Package File Uploading the COB File The Barionet Memory Map Development Tools and Scripts Summary Windows Tools and Batch Files Macintosh OS-X Tools and Scripts Linux Tools and Scripts The Sample Digital I/O and Serial Tunnel Application The Application Setup Screen Setting up the Serial Tunnel Setting up the I/O Tunnel The Sample Application Source Code Troubleshooting Common Problems and Solutions Using Syslog Messages Barionet Internal Syslog Messages BCL Error Syslog Messages User-generated Syslog Messages Rebooting the Barionet Rebooting from the Configuration Web Page Rebooting using the Hardware Jumper (J9) Resetting to Factory Defaults Resetting Using the Configuration Web Page Resetting Using the Reset Jumper (Barionet 50 Only) Resetting Using a Serial Cable and Terminal Program (Barionet 100 Only) The Serial Rescue Procedure Null Modem Cable Wiring Identifying the Serial Port BARIX AG Page 3 / 124

4 7.5.3 Barionet 50 Serial Rescue Procedure Barionet 100 Serial Rescue Procedure Updating Barionet Firmware Checking the Firmware Version Updating the Barionet 100 Firmware Updating the Barionet 100 via the Network Updating the Barionet via the Serial Rescue Procedure Updating the Barionet 50 Firmware Updating the Barionet 50 via the Network Using the Advanced Update Process Updating the Barionet 50 with the Serial Rescue Process Appendix A I/O Addressing A.1 Universal Analog/Digital Inputs A.2 Virtual I/O A.3 Input Pulse Counters A.4 Using the I/O Addresses A.5 Barionet 100 I/O Address Table A.6 Barionet 50 I/O Address Table Appendix B Configuration and Setup Memory Layout B.1 The Setup Memory Map Tables B.2 Barionet 100 Setup Memory Layout B.3 Barionet 50 Setup Memory Layout Appendix C Accessories C.1 Barix TS Temperature Sensors C.2 Barix X8 Expansion Module C.3 Barix IO12 Expansion Module C.4 Barix R6 Relay Expansion Module Appendix D Mounting the Barionet Appendix E Glossary Appendix F Specifications & Warranty Appendix G IP Addresses, Netmasks and Gateways BARIX AG Page 4 / 124

5 Chapter 1: Introduction 1 Introduction 1.1 What is the Barionet? The Barionet from Barix is family of programmable network-enabled automation controllers for interfacing a wide variety of devices and systems to IP-based networks in home and industrial automation applications. With the Barionet, most devices can be networkenabled for monitoring and control via a web browser as well as other standards-based automation systems, such as SNMP and Modbus. The Barionet provides a variety of standard hardware and software interfaces as well as general-purpose inputs and outputs for control and monitoring applications. Two Barionet models are currently available the Barionet 100 (the original Barionet) and the new Barionet 50. The two models differ primarily in the number of inputs and outputs provided. Barionet 100 Only Barionet 50 Only The Barionet 100 provides: 4 digital outputs 4 analog or digital inputs 4 digital inputs 2 relay outputs RS-422/485 serial interface Wiegand reader Interface The Barionet 50 provides: 4 relay outputs 4 dry contact inputs RS-485 serial interface Both the Barionet 100 and Barionet 50 provide: 10/100 Mb auto-sensing Ethernet port Integrated web server RS-232 serial interface Dallas Semiconductor 1-wire interface with built-in support for temperature sensors. Support for Modbus/TCP, SNMP, CGI, HTTP and other standard protocols. Barix proprietary dynamic tags for creating custom web pages to display status information. Programmability via BASIC-like Barix Control Language (BCL). Support for control of external Modbus devices via BCL code. Barix also offers a variety of I/O expansion modules that can be connected to the Barionet using the RS-485 port for additional I/O capability. Other manufacturers I/O modules and smart sensors can be controlled using the Modbus protocol via the RS-485 port. 1.2 Barionet Applications Applications for the Barionet are as varied as your imagination. These are just a few simple application ideas: Industrial control and monitoring, such as temperature and voltage monitoring, with alarms via and/or SNMP if voltages or temperatures fall outside an acceptable range. Home automation for control of thermostats and lighting as well as web-based remote status monitoring. Web-enabling devices with RS-232 or Modbus interfaces for remote control and access. BARIX AG Page 5 / 124

6 Chapter 1: Introduction The Barionet has a built-in serial gateway function that allows you to control an RS-232 device over a TCP/IP network. A sample BCL application ships with the Barionet that mimics digital inputs on one Barionet on the digital outputs of a second Barionet connected by a TCP/IP network. Access control and security systems driving horns or lights via relay outputs and providing alarm messages via or SNMP. Remote data collection and logging for digital and analog inputs. 1.3 About This Manual This manual is intended for Barionet users and developers. The hardware interfaces chapter assumes basic electronics knowledge, and the software interface chapter assumes some familiarity with internet protocols and HTML. You can use the Barionet without advanced electronics or software experience, but interfacing the Barionet to external devices and creating custom applications may require additional skills. Barionet 100 Only Barionet 50 Only Barix is committed to helping you be successful with the Barionet, so we provide a variety of technical resources in addition to this manual. These resources are listed later in this chapter. This manual describes both the Barionet 50 and the Barionet 100. Where the manual describes a function or feature that is specific to the original Barionet (now called the Barionet 100), this symbol appears in the left margin. Where the manual describes a function or feature that is specific to the Barionet 50, this symbol appears in the left margin. Note The original Barionet (now called the Barionet 100) is often referred to without the model number. When the new Barionet 50 was introduced, the original Barionet was renamed the Barionet 100. However, some of the older materials still refer to the original model as the Barionet. For the sake of clarity within this manual, when we refer to the specific Barionet models we will use "Barionet 50" and "Barionet 100". Where we use the term "Barionet" without a model designation, we are referring to the product family and describing characteristics of both models. This manual assumes the following firmware versions are installed in the Barionet 50 and Barionet 100: Barionet 100 Firmware: V3.02 Barionet 50 Firmware: V2.0 For instructions on updating the firmware in your Barionet, please refer to Chapter 8. For the installation of the Barionet please refer to the corresponding Quick Install Guide. A printed version is included in the box and can also be downloaded from our web site at Notes, Warnings, and Cautions Throughout this manual, you will find paragraphs that have a special boxed heading of either "Note", "Warning" or "Caution". These paragraphs contain important information defined by the heading. BARIX AG Page 6 / 124

7 Chapter 1: Introduction Note Note paragraphs describe information that is important for the reader to understand to avoid functional or procedural problems, but the information does not pose a significant risk of damage to the product or personal injury. Caution Caution paragraphs describe information that is important for the reader to understand to avoid potential damage to equipment. Warning Warning paragraphs describe information that is critical for the reader to understand and abide by to avoid the risk of personal injury. 1.4 Chapter Overview Chapter 1: Introduction You are currently reading the introduction chapter Chapter 2: Accessing and Configuring the Barionet This chapter helps you get started with accessing the Barionet via a web browser and describes the use of the built-in configuration and status web pages. It also describes each of the configuration screens and settings in detail Chapter 3: Hardware Interfaces The Hardware Interfaces chapter focuses on information required to connect the Barionet to external devices, such as switches, relays, lamps, etc. This chapter describes the Barionet hardware interfaces as well as considerations for connecting external devices to the inputs and outputs of the Barionet and provides simple schematics for suggested configurations. Separate sections are devoted to the Hardware interfaces for each Barionet model Chapter 4: Software Interfaces Chapter 4 looks at each of the software interfaces that the Barionet provides and helps you choose the software interfaces that best suit your application. The chapter begins with a summary table of all the software interfaces and then goes on to describe each one in more detail Chapter 5: Creating Custom Applications & Web Pages This chapter provides an overview of the Barionet's features for developing custom web pages and applications. The process for uploading customized web pages and BCL applications is also discussed. Detailed information on the BCL language is provided in a separate manual, the Barix Control Language (BCL) Programmers Manual. The BCL Programmers manual is available for downloading from the Barix web site Chapter 6: The Sample Digital I/O and Serial Tunnel Application The Barionet comes pre-loaded with a sample BCL application and a custom application configuration page for the sample application. The source BCL code for the application and the HTML source for the configuration page are both provided in the development kit, which is available for download from the Barix web site. This chapter describes the functionality of the sample application and its configuration page. You can use the sample application as is, or you can use the BCL code and custom HTML pages as an example for BARIX AG Page 7 / 124

8 Chapter 1: Introduction creating your own applications and custom pages. The complete source for the sample application is supplied in the Update, Rescue and Development Kit, which is available for download on the Barix web site Chapter 7: Troubleshooting This chapter discusses procedures for troubleshooting and debugging Barionet applications. Procedures for rebooting the Barionet, resetting to factory defaults, using SYSLOG messages for debugging, and the serial rescue procedure are discussed Chapter 8: Updating Barionet Firmware This chapter provides detailed instructions for updating the Barionet 50 and Barionet 100 firmware Appendix A: I/O Addressing Appendix A provides a concise reference to the I/O addressing scheme in the Barionet. These I/O addresses are used in custom HTML tags, BCL applications, and Modbus/TCP commands Appendix B: Configuration and Setup Memory Layout This appendix provides a quick reference for the layout of the configuration and setup memory, including space available for user configuration parameters Appendix C: Accessories Appendix C lists and briefly describes accessories available from Barix for the Barionet Appendix D: Mounting the Barionet Appendix D describes physical mounting considerations for the Barionet Appendix E: Glossary Appendix E is a glossary of terms used throughout this manual. Many of the terms in the text are linked directly to a definition in the glossary in the PDF version of the manual. Where a term is linked to a definition in the glossary, it is displayed in underlined dark blue text Appendix F: Specifications & Warranty Appendix F lists the specifications and warranty for the Barionet Appendix G: IP Addresses, Netmasks and Gateways Appendix G briefly describes IP addressing and the relationship of net masks to addresses and the function of the gateway IP address. This appendix discusses IPv4 addresses (and briefly mentions the differences with IPv6). 1.5 Additional documents The following additional documents are available from Barix for the Barionet Barionet Quick Start This document provides a brief introduction to the Barionet with a quick reference for interface pins. A printed copy of this guide ships with each Barionet and the document is also available for download at: Each Barionet model has a unique quick start guide. BARIX AG Page 8 / 124

9 Chapter 1: Introduction Barix Control Language Programmer's Manual For Detailed information on developing custom applications with the Barix Control Language (BCL), refer to the Barix Control Language (BCL) Programmer's Manual. This manual is available for download at: I/O Expansion Module Manuals The manuals for the Barix expansion modules (models IO12, X8, R6) provide information on connecting and using the expansion modules, including details of Modbus interfacing and use with the Barionet. 1.6 Getting Support Barix is committed to helping you succeed with the Barionet. The first line of help should always be to read the manuals carefully. If after reading the manuals, you are still having trouble, here are some support resources that should help answer your question: Barionet Distributors Check with your Barix distributor for technical support resources they offer. A list of distributors is available on the Barix website. Some of the dealers and distributors specialize in the Barionet Barionet Users Forum The Barionet user's forum brings together new and experienced Barionet users from all over the world, along with technical support representatives from Barix. Users exchange information, questions and ideas and Barix support staff answer questions as well. This is a great resource for learning from others and sharing experience. The forum also provides a search function that allows you to search for forum posts on a particular topic. A link to the Barionet User's forum is provided on the Barix support web page at: FAQs/71/ Barix BCL Demo Applications Site Barix operates a website that allows BCL developers to share the applications they have developed for Barix hardware. A number of Barix-created demo applications are also available for download as examples and a starting point for developing your own applications. You can find this site at: Barix Wiki Barix staff also maintains a wiki for all Barix products, including the Barionet 50 and the Barionet 100. The Wiki contains information on the features and applications for the products as well as hints and tricks that may not be included in the manuals Support You can a Barix support technician at support@barix.com. BARIX AG Page 9 / 124

10 Chapter 3: Hardware Interfaces 2 Accessing and Configuring the Barionet The Barionet includes a built-in web server and comes pre-loaded with web pages that allow you to configure various settings of the Barionet as well as monitor the status of inputs and control outputs. This chapter provides detailed instructions for connecting the Barionet to a network and accessing the standard status and configuration pages for the first time. 2.1 Accessing the Barionet for the first time Connecting to an Ethernet/IP network The first step in preparing to access the Barionet's configuration and status pages is to connect it to an Ethernet network and assign it an IP address. The Barionet is equipped with a standard Ethernet 10/100 Mbit, full / half duplex, auto negotiation interface. Connect the Barionet to an Ethernet network using an RJ-45 Ethernet cable to a hub or switch. You'll also need a computer connected to the same network. If you are going to connect the Barionet directly to a computer without a hub or switch, you must use a "crossover" cable, which is a specially-wired cable available at many electronics supply stores Supplying Power Before you can access the Barionet's built-in status and configuration web pages, you must connect the Barionet to an appropriate power source. The Barionet does not come with a power supply. The Barionet 50 and Barionet 100 can be operated on any DC power supply with an output voltage between 9 and 30 volts DC. The overall power consumption is 4 watts maximum (all relays active). Please refer to Power Supply Inputs (J6) in Chapter 3 for more details on connecting the Barionet 100 to a power supply and Power (J2) in Chapter 3 for more details on connecting the Barionet 50 to a power supply Using the Barionet Discovery Tool The Barionet must have a valid IP address before you can use most of the functions available via the Ethernet interface. The easiest way to find the Barionet's IP address and/or change the Barionet's address assignment, is using the Barix Discovery Tool. Other methods are outlined later in this chapter. The Discovery tool is supplied with the development and update kits after version 2.30 (for the Barionet 100) and 1.04 (for the Barionet 50). You can also download it from the Barix web site at: The Discovery tool is written in the Java programming language, so it requires a Java Runtime Environment (JRE) installed on your computer. If you do not have a JRE installed, you can download and install it from: Java run time environments are available for all major operating systems. If you are running the discovery tool on a Linux or UNIX platform, the Discovery tool also requires the X-window graphical user interface. The Discovery tool is distributed in a Java Archive (.jar) file. On most operating systems you can run the discovery tool by simply double-clicking on the discover.jar file. The tool should start up and the initial screen shown in Figure 1 should appear. BARIX AG Page 10 / 124

11 Chapter 3: Hardware Interfaces Figure 1. The Barix Discovery Tool helps to find Barionets on the same local network as the computer running the tool. Click the "Get" button to initiate a search. If the Discovery tool finds one or more Barionets on the network, each device will be listed in the table, including its current IP address, MAC address (labeled "Ethernet Address" in the Discovery tool), firmware version, and other information. The Discovery tool should find any Barionet devices that are on the same network as the computer running the tool, regardless of their current IP address setting. The tool will not search through a router to another subnet. Note With some versions of Barionet 100 firmware prior to V2.30 or Barionet 50 version 1.04, the Discovery tool will only find Barionets if they are on the same subnet as the computer running the discovery tool. For example, with the older firmware, if the computer is set for IP address and the Barionet has an IP address of , the Discovery tool will not find the Barionet. The IP address displayed in the discovery tool may be a dynamic IP address, assigned by a DHCP server or other automatic address assignment protocol. The Barionet comes from the factory with the IP address set to , which means that it will automatically attempt to acquire an IP address using one of several methods. See Setting the Barionet IP address automatically later in this chapter for more information on automatic address assignment. If the Barionet is configured for automatic IP address assignment (IP address = ), the Discovery tool will show the address it's been assigned, not the You can use the address that appears in the Discovery tool to access the Barionet via a web browser. However, keep in mind that the IP address may change if the Barionet is rebooted. You can also set the address in the Discovery Tool by double clicking on the IP address field of the Barionet you wish to change. When you double click the address field, the IP address field will become editable. Enter the IP address you want to assign to the Barionet. Then click "Set". The "Set reply" field should say "No error" if the address assignment was successful. If you decide to assign the Barionet a static IP address, you must be sure to use an address that is outside the range of addresses that are automatically assigned by any DHCP server on the network. See Setting the Barionet IP address manually later in this chapter for more information. If you've been successful at finding and/or setting the IP address of the Barionet with the discovery tool, you can skip the next few sections and go right to Opening the Configuration and Status Web Pages later in this chapter Alternatives to the Discovery Tool If you are unable to use the Barix Discovery Tool to set the IP address or the Discovery Tool doesn't find the Barionet on your network, there are three alternative methods for finding and/or setting the Barionet's IP address. Each of the procedures below assumes that the Barionet is physically connected to the Ethernet network and that a computer is connected to the same network with an IP address that is in the same subnet (i.e. address range) as the Barionet. If the network uses dynamic address assignment, such as DHCP, this will happen automatically. The three alternatives to using the Barix Discovery Tool are: BARIX AG Page 11 / 124

12 Chapter 3: Hardware Interfaces 1. The Barionet can obtain an IP address from an external server running the DHCP protocols. Using the DHCP server's administrative interface, you can find the IP address the DHCP server has assigned to the Barionet. 2. You can find the Barionet's IP address using syslog output when the Barionet boots. 3. The Barionet's IP address can be manually assigned using arp and telnet commands Alternative 1: Getting the Barionet's address from the DHCP or BOOTP server The default method the Barionet uses for obtaining an IP address is to attempt to contact a DHCP or BOOTP server on the network. The DHCP or BOOTP server assigns the Barionet an unused IP address within the range of the subnet of the current network. In many small networks, the router or server computer serves as a DHCP or BOOTP server. If you have access to the administration functions of your router or DHCP/BOOTP server, you should be able to look up the address that the server assigned to the Barionet. Most servers provide access to a table that lists the addresses assigned (sometimes referred to as "leased") to each device on the network that uses the DHCP or BOOTP protocol. Figure 2 shows a typical address table from a DHCP server built into a router. If you do not have access to the administrative functions of your router, or the network does not have an active DHCP or BOOTP server, try using one of the other methods described in this chapter. Figure 2. A typical DHCP address table To find the IP address of the Barionet, locate its hardware MAC Address, which is printed on the label on the bottom of the Barionet. Find the corresponding MAC address in the DHCP address table and write down the IP address that corresponds with the Barionet's MAC address in the table. If the DHCP Host Name setting in the Barionet's configuration is set, the host name will appear in the "Device Name" column of the table as well. If the Barionet is set to the factory default configuration, the Device Name will be a default value that is derived from the Barionet's MAC address. Note that the table shown above is only an illustration of a typical DHCP server address table. Your DHCP server table may appear somewhat different. You will use the IP address from this table corresponding to your Barionet to access the Barionet's built-in status and configuration pages. Remember, this IP address may change any time the Barionet is rebooted, so you'll have to either set a static IP address in the configuration web pages, or check the DHCP server table after each Barionet reboot to find the Barionet's IP address. BARIX AG Page 12 / 124

13 Chapter 3: Hardware Interfaces Alternative 2: Getting the IP Address from SYSLOG messages This method requires you to install a program on your computer that can receive and display the system log (syslog) messages that the Barionet issues by default. For Microsoft Windows computers, we recommend the Kiwi Syslog Daemon available for free download from There is a free syslog viewer dashboard widget available for the Macintosh as well. 1. Install and run the syslog program on your computer connected to the same network as the Barionet. 2. Power up the Barionet. If it was already powered up, remove power for a couple of seconds and then re-connect the power to restart the Barionet. 3. When the Barionet restarts, it should issue at least a couple of syslog messages, which should appear in the Kiwi syslog program. The source IP address of the Barionet is displayed with the messages. This IP address is what you'll use to access the Barionet via the web browser. If these messages do not appear, either the Barionet was not able to acquire a valid IP address or the syslog setting in the Barionet has been changed from the default broadcast setting for syslog output. You'll need to try one of the other procedures for finding or setting the Barionet IP address Alternative 3: Setting the IP address manually using ARP With this method, you will temporarily set an IP address for the Barionet. Using the temporary address, you can access the Barionet's configuration pages, where you can set a permanent address. Note The IP address you set with this method is only temporary. In order to access the device after a power-cycle, you must set the IP address permanently in the Barionet's configuration web pages. See the description of the Network Settings Page to set the IP address permanently. 1. Open a command line window. In Microsoft Windows, click "Start" and the "Run". In the dialog box type "cmd" and press enter. On the Macintosh run the Terminal program, normally located in the Utilities folder. On Linux open a terminal window if you are using a graphical user interface or enter the following commands directly in a terminal console session. 2. You must assign a temporary address that is not used by any other devices on the network and is in the same subnet as the computer that will access the Barionet. Contact your network administrator if you are not sure what address is available to assign to the Barionet. You can use the ping command to check to the address is free. In the command window, type: ping <IP address> Where <IP address> is the address you want to check to be sure it's not already assigned. For example, if you want to check if the address is not assigned to any other device, type: ping Figure 3 shows a typical response to the ping command on Windows when the IP address is not assigned to any other device on the subnet. BARIX AG Page 13 / 124

14 Chapter 3: Hardware Interfaces Figure 3. The results of a ping command for an unused IP address A "Request timed out" or "Destination host unreachable" response indicates that there was no other device on the network at the address If there is any other response, the IP address is in use, so you'll need to use a different address. 3. Write down the Barionet's MAC address, which is printed on the label on the underside of the Barionet. The MAC address is 12 hexadecimal digits (0 9 and A F). When you enter the MAC address in the next step, you'll need to insert either hyphens (Windows) or colons (Mac OS-X or Linux) between each pair of digits, so it might be helpful to write it down in the correct format with hyphens or colons between each pair of digits. For example: A-93-7F-D4 (Windows) 00:20:4A:93:7F:D4 (Mac OS-X or Linux) 4. Enter the following command in the command window, followed by the Enter key. Substitute the IP address you want to assign to the Barionet for <IP address> below and substitute the Barionet's MAC address for <MAC address> in the command. arp -s <IP address> <MAC address> (Windows) sudo arp s <IP address> <MAC address> (Mac OS-X or Linux) For example, to set the Barionet's IP address to with a Barionet whose MAC address is A-93-7F-D4, the command would look like this: arp -s A-93-7F-D4 (Windows) sudo arp s :20:4A:93:7F:D4 (Mac OS-X or Linux) For OS-X and Linux, you must supply the administrator's password when prompted. You can use the a switch in the arp command (arp a) to check that you entered the correct MAC and IP addresses. Look for an entry that matches the MAC address of the Barionet and confirm that you entered the correct IP address. 5. The arp (address resolution protocol) command tells your computer to associate the Barionet's MAC address with the IP address you specify. Next, we must tell the Barionet to use this IP address by attempting to connect to that IP address on port 1 using the Telnet command. Enter the following command: telnet <IP address> 1 Again, substitute the IP address you used in the arp command here for <IP address>. Using the same IP address as our previous example, the command would be: telnet This command should generate an error message because the Barionet will refuse a connection on port 1. Don't worry that's normal. The purpose of this command is simply to set the Barionet to listen to the specified IP address. The error message is not meaningful here. BARIX AG Page 14 / 124

15 Chapter 3: Hardware Interfaces Note The error message that results from the telnet command should occur almost immediately. If there is a significant delay (i.e. greater than about 5 seconds), the Barionet may not be reachable. Try cycling power on the Barionet and repeating the procedure. If it still fails, the serial rescue procedure can be used to restore the Barionet. At this point, the Barionet should be assigned the IP address you specified in the arp and telnet commands. You can check that the address assignment succeeded by using the ping command again with the IP address you assigned the Barionet. Figure 4 shows the response to the ping command when the address assignment succeeded. Figure 4. If the address assignment was successful, the response should look like this. If the response says "Request timed out", the address assignment failed. Try repeating the steps again, starting with step 4 above. Be sure you included the "1" at the end of the telnet command. If the assignment worked, the Barionet will now respond to web page requests at the assigned IP address. Remember, however, that this IP address assignment will be lost if the Barionet's power is interrupted, so be sure to set the IP address of the Barionet in the configuration pages before removing power or rebooting the Barionet. 2.2 Opening the Configuration and Status Web Pages You can now access the standard configuration and I/O status web pages using any standard web browser. Open your browser and in the address bar type: address>/ Substitute the IP address of your Barionet for <IP address>. For example, if your Barionet is assigned to IP address , enter the following in your browser's address bar: Your browser should display the Barionet 100's standard I/O status home page as shown in Figure 5. The Barionet 50's I/O status page is shown in Figure 6. BARIX AG Page 15 / 124

16 Chapter 3: Hardware Interfaces Barionet 50 Only Figure 5. The Barionet 100 I/O status home page. Barionet 100 Only Figure 6. The Barionet 50 I/O status home page This status page automatically refreshes itself at 4 second intervals. However, you can change the refresh rate to 2 second intervals or disable the refresh entirely by clicking on one of the refresh rate links just below the Barionet banner at the top of the page. You'll also find a "Help" section on the right edge that defines each of the elements on the page. Use the scroll bar next to this section to scroll down for more help information. 2.3 Using the Home I/O Status and Control Page The Barionet I/O status home page shows the status of its inputs and outputs and also allows you to control the outputs. The page shows indicators for each of the inputs and outputs. White or gray indicates that the input or output is OFF (inactive), and green indicates that the input or output is ON (active). You can also control the state of each of the outputs by clicking on the indicator to change its state or on the pulse links below the digital outputs to turn the output on for the specified interval and then automatically turn it BARIX AG Page 16 / 124

17 Chapter 3: Hardware Interfaces back off. The Barionet 100 has eight inputs, four of which may be used as either digital or analog inputs. It also has four digital outputs as well as two relay outputs. It can also monitor up to 50 1-Wire temperature sensors. Figure 7 shows the Barionet's home I/O status and control page with the various elements on the page labeled. Barionet 100 Only To turn one of the relay outputs on, click on the white status indicator. If you listen carefully, you can hear the relay output switch and the relay status indicator should turn green at the next refresh. Note that if you have disabled the automatic refresh, the indicator status will not change after you click the indicator, even though the relay will switch on or off. The eight input status indicators show the status of each of the eight inputs. The first four inputs may be configured as analog inputs, so their corresponding input voltage level is shown below the indicators. The last four inputs are dedicated digital inputs. Clicking on these status indicators has no effect as they are inputs only. The status of the four general purpose digital outputs is shown to the right of the analog input levels. These outputs can be turned on and off just like the relay outputs. However, because they are not relays, you won't hear any switching sound when they change states. The status indicators will change on the next refresh of the status page. You can also turn these outputs on for a short period of 0.2 seconds, 1 second, or 5 seconds by clicking on the corresponding links below the output indicators. Remember that the status indicators are only updated when the page refreshes, so you may not even see the status indicator change if you click one of the pulse links, since the output may change faster than the refresh rate of the status screen. Barionet 100 Only Figure 7. The Barionet 100 I/O Status and Control Page. Finally, the status of up to eight 1-wire temperature sensors is displayed near the bottom of the screen. Temperatures are displayed in degrees Celsius. Where a temperature sensor is not present, it displays 256 degrees C on this page. BARIX AG Page 17 / 124

18 Chapter 3: Hardware Interfaces The Barionet 50 has four digital inputs and four relay outputs and can also monitor up to 50 1-Wire temperature sensors. Figure 8 shows the Barionet 50 home I/O status page. Figure 8. The Barionet 50 I/O Status and Control Page. To turn one of the relay outputs on, click on the gray status indicator. If you listen carefully, you can hear the relay output switch and the relay status indicator should turn green at the next refresh. Note that if you have disabled the automatic refresh, the indicator status will not change after you click the indicator, even though the relay will switch on or off. You can create custom pages that display different information, or in different formats. We'll discuss the process of creating custom pages in Chapter Using the Configuration Web Pages The Barionet's built-in web pages also include pages for setting a wide variety of configuration options. This section shows each of the configuration pages and describes the parameters and options on each page. To access the configuration pages, click on the Configuration button near the top of the page, just under the Barix logo. Barionet 50 Only The configuration settings are divided into eight web pages accessed by the tabs at the top of the configuration pages as shown in Figure 9. The following sections describe each of these settings pages The Network Settings Web Page The Network Settings page allows you to set the IP address, Netmask, Gateway, and DNS server for the Barionet. See Figure 9. BARIX AG Page 18 / 124

19 Chapter 3: Hardware Interfaces Figure 9. The Network Settings Page. Note If you set the IP address of the Barionet temporarily using Alternative 3 described earlier in this chapter, that IP address will not appear in the IP address boxes on this page. If you want to assign a static IP address or control the automatic IP assignment protocols, you must set the IP address in the configuration pages before restarting the Barionet. Otherwise, the temporary IP address you set using the arp s and telnet commands will be lost when the Barionet is rebooted. The following sections discuss how to set the IP address manually or for automatic operation Setting the Barionet IP address manually In some cases, it's desirable to set the IP address of the Barionet manually, instead of allowing a DHCP server or other protocols to automatically set the Barionet's IP address. Setting the IP address manually has the advantage that once the address is set, it does not change unless you reset it, so you always know the IP address to use to access the Barionet. This is sometimes referred to as a "static IP" because the IP address does not change. However, when you set the IP address manually, you are responsible for insuring that the IP address assigned to the Barionet is not assigned to any other device. If your network uses DHCP or other automatic assignment protocols, you must insure that the IP address assigned to the Barionet is not within the range of addresses that could be automatically assigned by the DHCP server. The Barionet always checks the IP address that it is assigned (whether manually or automatically) to see if the address is already associated with another device. If a manually assigned address is already assigned to another device, the Barionet reboots and tests the address again. This may result in the Barionet being unreachable. To correct the address conflict you can: Temporarily assign an available IP address using Alternative 3 described earlier in this chapter and then change the address assignment in the configuration pages. Disconnect or disable the other device that has been assigned the same IP address in order to access the Barionet to change its IP address. If you are connecting the Barionet to a larger network where you are not the administrator, it is important to check with the administrator before assigning an IP address to the Barionet. To set the IP address, simply enter the values in the four boxes labeled "IP Address". The BARIX AG Page 19 / 124

20 Chapter 3: Hardware Interfaces Barionet must be rebooted for the new IP address to take effect. Click the "Reboot" button near the top of the screen and click "OK" to reboot the Barionet. You may want to make all the changes required in the Network Settings screen before rebooting the Barionet. Refer to Appendix G IP Addresses, Netmasks and Gateways for more information on choosing an appropriate static IP address Setting the Barionet IP address automatically The Barionet supports four different methods for automatic IP address assignment. You can configure the Barionet to try each of the four methods to obtain an IP address, or you can control which of the four methods it uses. The methods are executed in a specific order and the first method that succeeds will stop the process. These are the four methods the Barionet attempts to use, in the order of their execution, with a brief explanation of the method's requirements. See the glossary entries for each method for more specific information. 1. BOOTP: The Barionet attempts to retrieve an unused IP address from a "configuration" server. If there is no configuration server that responds to the BOOTP protocol, this protocol will fail, and the Barionet will attempt to use the DHCP protocol. 2. DHCP: The Barionet attempts to retrieve an unused IP address from a DHCP server. If there is no active DHCP server on the network, the Barionet will attempt to use the IPZator method. The Barionet waits for roughly 12 seconds for a response from BOOTP or DHCP before attempting to use the IPZator or AutoIP methods. 3. IPZator: This is a Barix-proprietary protocol that does not require an external server to assign IP addresses. It attempts to locate an unused address within the current subnet by listening to the network traffic. A class-c network is assumed (netmask ). The Barionet tests sequential addresses starting with 168 in the last octet (e.g. xx.xx.xx.168). It uses the first address it finds in this range that is unused. The IPZator method can be quite fast if there is substantial network traffic. However, it may fail entirely after 3 minutes if it does not find any existing network traffic (excluding traffic in the AutoIP range of x.x). 4. AutoIP: The AutoIP protocol also does not require any external server. However, it always assigns the Barionet an address in the range of x.x. It randomly tries addresses in this range and finds the first free address. This method should only be used in small networks that are not connected to a larger network or the internet. The AutoIP method assumes a class-b network (netmask ). The default IP address setting for the Barionet in the configuration screen is This setting tells the Barionet to try all four of the methods described above in the order shown. If you want to disable any of these methods, you can use a special IP address that is not otherwise valid to control which methods are executed. Set all but the third value to zero according to the following table: : Enables all four methods : Disables the AutoIP method : Disables the DHCP method : Disables the BOOTP method : Disables the IPZator method Any combination of these settings can be added together to disable multiple methods. For example: : Disables the BOOTP and AutoIP methods : Disables all methods except DHCP BARIX AG Page 20 / 124

21 Chapter 3: Hardware Interfaces Note If you set the IP address to , you disable all four automatic addressing methods and you also don't have a valid static IP address that can be used to communicate with the Barionet. The only way to communicate with the Barionet with this IP address setting is to manually reset the IP address using the technique described in Alternative 3 earlier in this chapter and then change the IP address in the web configuration settings. You can also reset the Barionet to factory defaults using the procedure described in Resetting to Factory Defaults in Chapter 7. However, resetting to factory defaults restores all the Barionet's configuration settings back to factory defaults Setting the Netmask The Netmask parameter defines the range of addresses in the current subnet. Addresses outside this range must be "routed" through a device called a "router". Like the IP address, you can choose to either manually set the netmask, or you can set it to , which tells the Barionet to automatically acquire a netmask setting from the DHCP server, or assume a netmask based on the range of the IP address it is assigned. If the Barionet gets its IP address from a DHCP server, it will also get a netmask from the server. However, if the Barionet gets an IP address using the IPZator or AutoIP method, it assumes a netmask from the network address. For example, if your Barionet is assigned an IP address of , the IP address is called a "class C" address. If you leave the net mask set to , the Barionet will automatically assume a net mask of In general, it's best to assign a specific netmask, based on the configuration of your network. If you are unsure what netmask is appropriate for your subnet, contact your network administrator. See Appendix G: IP Addresses, Netmasks and Gateways for more information. Assuming that the Barionet is connected to the same subnet as your computer, you can probably use the net mask as your computer Setting the Gateway IP Address The gateway settings tells the Barionet the IP address of a router or host that is responsible for forwarding any network traffic that is not within the Barionet's subnet. In a small network connected to the internet, the gateway IP address is typically the address of the router that connects the network to the internet (which is probably also the DHCP server). The gateway address is not necessary unless the Barionet will need to communicate with devices outside its own network. For example, if the Barionet needs to send SNMP traps to a computer that is outside the Barionet's subnet, the gateway address is required in order for the Barionet to connect to the gateway to forward the traffic to its final destination. The gateway IP address is always in the same subnet as the Barionet. For example, in a small network where the Barionet is assigned an IP address of , the gateway address might be If the Barionet uses DHCP to automatically acquire its IP address, the DHCP server will typically also supply a gateway IP address. In those cases, you can leave the gateway IP address set to , and the Barionet will automatically retrieve the gateway address (if it's configured) from the DHCP server. If you are unsure what to set the gateway address to, contact your network administrator. Assuming that the Barionet is connected to the same subnet as your computer, you can most likely use the gateway address setting of your computer. See Appendix G: IP Addresses, Netmasks and Gateways for more information. BARIX AG Page 21 / 124

22 Chapter 3: Hardware Interfaces Setting the DNS Server Address The DNS (Domain Name System) server is essentially an Internet phone book. A DNS server translates a domain name (e.g. barix.com) to an IP address (e.g ). All communication in an IP network is eventually done using IP addresses, so if a server name is used in a request, the first step is to translate that name into an IP address. That's the job of the DNS server. The Barionet needs the address of a DNS server only if it uses domain names in any of its requests. For example, if you write BCL code that connects to a mail server by name, you can use BCL's resolve() function to translate a domain name into an IP address. Unless you create a custom BCL application that uses domain names to refer to external computers or devices, you don't need to fill in a DNS server. If you use DHCP to obtain an IP address, the DHCP server can also supply a DNS server address if it is configured in the DHCP server. Leave the DNS server address set to all zeros if there is no DNS server or if it will be automatically configured by DHCP Setting the DHCP Host Name The DHCP host name gives the Barionet a name that will be included in the DHCP server's list of assigned addresses. This name simply makes it easier to find the Barionet's IP address in a list of DHCP-assigned IP addresses. If the DHCP host name field is not filled in, the DHCP server's table will include a host name that is derived from the Barionet's hardware MAC address The Serial Settings Web Page The Serial Settings page allows you to set the configuration parameters for the RS-232 and RS-422/RS-485 interfaces. Changes are saved (but not applied) when you click the "OK" button. The Barionet must be rebooted for the changes to take effect. Figure 10 shows the Serial Settings page. This page is very similar for the Barionet 100 and the Barionet 50 except that the Barionet 50 does not have the "Interface Type" setting. Its two serial interfaces are always RS-232 and RS-485. The specific settings for each of these interfaces depend on the requirements of the device that is connected to the interface. For example, to use the RS-485/422 interface to connect to Barix Modbus expansion modules, the RS-485/422 interface must be set according to the requirements of the Modbus expansion device. Refer to the serial interfacing requirements of your specific device for appropriate settings. Figure 10. The Barionet 100 Serial Settings Page. BARIX AG Page 22 / 124