1. Manuals
  2. Brands
  3. Echelon Manuals
  4. Server
  5. i.LON 1000
  6. User manual

Echelon i.LON 1000 User Manual

Internet server
Hide thumbs Also See for i.LON 1000:
Table of Contents

Advertisement

Quick Links

1000 Internet
i.LON
™
Server
User's Guide
Version 1.01
078-0184-01B

Advertisement

Table of Contents
loading

Related Manuals for Echelon i.LON 1000

Summary of Contents for Echelon i.LON 1000

  • Page 1 1000 Internet i.LON ™ Server User’s Guide Version 1.01 078-0184-01B...
  • Page 2 ORKS Neuron, 3120, 3150, L , NodeBuilder, and the Echelon logo are trademarks of Echelon Corporation registered in the United States and other countries. LonMaker, LNS, and i.LON are trademarks of Echelon Corporation. No part of this publication may be reproduced, stored in a...
  • Page 3 Internet Protocol (IP) data networks, while enabling access to network variable information by standard web browsers. This user’s guide describes how to install, configure, use, and manage the i. LON 1000 as a router and web server. i.LON 1000 Internet Server User’s Guide...

  • Page 4: Purpose

    Purpose This user’s guide describes how to install the i.LON 1000 hardware, and configure, use, and manage the i.LON 1000 as a router and web server. Audience This user’s guide is intended for Echelon customers, OEMs, and system designers and integrators with knowledge of control systems and IP networking.
  • Page 5 • Chapter 11, i.LON 1000 Web Page Security, describes how to add basic web authentication to password protect some or all of the web pages on your i.LON 1000 Internet Server. Chapter 12, Advanced Topics, Contains information on advanced topics, including •...

  • Page 6: Table Of Contents

    Configuration Server Web Tag Wizard Web Server Parameters Application i.LON 1000 Firmware Installing the i.LON 1000 Software on Your PC Updating the i.LON 1000 Firmware 4 i.LON 1000 Console Application Setting Up the i.LON 1000’s IP Information 5 LonWorks/IP Channels, Background and Definition...
  • Page 7 Firewall/Router Configuration Information to be Supplied to the Network Administrator 6-3 7 Creating a LonWorks/IP Channel Creating a L /IP Channel ORKS Designing a LonMaker Network Containing L /IP Channels ORKS Defining an i.LON 1000 as a L Router 7-10 ORKS Verifying Router Functionality 7-11 /IP Channel Timing Considerations ORKS...
  • Page 8 11-6 12 Advanced Topics Aggregation 12-2 MD5 Authentication 12-2 Device Resource Files 12-4 Using DHCP with the i.LON 1000 Internet Server 12-4 DHCP Server Failure 12-5 i.LON 1000 System Event Log 12-5 Event Types 12-5 Using i.LON 1000 Devices with SNMP...

  • Page 9: Introduction

    Introduction This chapter provides an introduction to the i. LON 1000 Internet Server, including its applications, hardware, software, and utilities. i.LON 1000 Internet Server User’s Guide...
  • Page 10 ORKS building automation, utility, transportation, and telecommunications applications. Cisco certification is your assurance that the i.LON 1000 has been both rigorously tested and will meet the needs and standards of Information Technology (IT) managers worldwide. Adherence to the EIA proposed standard for tunneling ANSI/EIA 709.1 packets over IP ensures that communications through the i.LON 1000 are both open and interoperable.
  • Page 11 From the perspective of the IT network, the i.LON 1000 is viewed as a typical IP host. Like other IP hosts, the i.LON 1000 supports standard Internetworking protocols: TCP/IP, UDP, DHCP, SNMP (MIB II), ICMP, SNTP, TOS, MD5, HTTP, and FTP.
  • Page 12 Introduction...
  • Page 13 Shipping Content & Hardware This chapter describes the i. LON 1000 Internet Server hardware and explains the various mounting and cabling options. i.LON 1000 Internet Server User’s Guide...

  • Page 14: Shipping Contents

    1000 and an IP network port. Null-Modem Cable This cable connects the null-modem cable provided between the Console port on the i.LON 1000 and a terminal (or an available COM port on a PC running a terminal emulation program). BLAT Mating Connector...

  • Page 15: Ports, Leds, Switches & Wiring Options

    (model 72951) may be attached to each side of the i.LON 1000 enclosure for EIA 19-inch rack mounting in a single rack height space. Figure 1.3 shows the rear panel of the i.LON 1000, including the connectors, LEDs, and control switches. The i.LON 1000 interfaces with the IP channel through a RJ-45 Ethernet 10BaseT port.

  • Page 16: On Works

    10BaseT hub. Console and Serial EIA-232 Ports The console port is used to configure the i.LON 1000, and provides a serial connection to a VT-100 terminal or terminal emulation software such as HyperTerminal; the serial port is reserved for future use. The format of the console port data is 9600 baud, 8 data bits, 1 stop bit, no parity, and no flow control.

  • Page 17: Control Switches

    (Power) indicate server and network status. Front Panel LED A single front panel LED illuminates when the i.LON 1000 is receiving power. The front panel power LED indicates that the power supply is active; it is not under software control.

  • Page 18: Rear Panel Led

    *This happens if the i.LON does not have a valid IP address. 0.0.0.0 (the factory default) is not a valid address. If all LEDs are off, either the i.LON 1000 does not have power or it did not complete the boot process.

  • Page 19: Wall Mount

    To wall mount the unit, follow these steps: 1. Remove the 4 rubber feet on the bottom of the i.LON 1000 by pushing up on the side of each foot. 2. Select a wall or panel location supported by a wood or metal stud. The wall or panel undersurface must support the screws and the weight of the i.LON 1000.
  • Page 20 To install the i.LON 1000 in the EIA 19-inch rack, follow these steps: 1. Remove all power and signal cables from the i.LON 1000. 2. Remove the 4 rubber feet on the bottom of the i.LON 1000 by pushing up on the side of each foot.

  • Page 21: Applying Power And Installation Troubleshooting

    Figure 2-5 Installing the i.LON 1000 in the EIA 19-inch Rack Applying Power and Installation Troubleshooting Once the i.LON 1000 has been mounted and all wiring connected, apply power to the device. The Power LEDs on the front and rear panels should illuminate continuously. If the power LEDs do not illuminate, check that the power barrel connector or screw terminal, as appropriate, are properly seated, and that the power supply is receiving mains power.
  • Page 22 In other cases the cabling must be replaced with an approved cable. Excessive number of nodes on a channel. See Echelon's FTT-10A Free Topology Transceiver User's Guide (part number 078-0156-01) or TPT Twisted Pair Transceiver User's Guide (part number 078-0025-01) for a discussion of the number of devices that can be installed on a channel.

  • Page 23: I.lon 1000 Software

    1000 Software This chapter describes the various software components within the i. LON 1000, and how to install the PC based software utilities. i.LON 1000 Internet Server User’s Guide...

  • Page 24: I.lon 1000 Software And Pc Utilities

    ORKS types: learning, configured, repeater, or bridge. The i.LON 1000 does not route IP packets. From the IP perspective, the i.LON 1000 is an IP host and must be configured like any other host on an IP network. Data Server Application The software component that provides anchor points on the i.LON 1000 to which network...

  • Page 25: Web Server

    The directory structure is a duplicate of the directories contained by the i.LON 1000 device. If you receive an update of the i.LON 1000 firmware, you can update the firmware as described in Updating the i.LON 1000 Firmware, later in this chapter.

  • Page 26: Updating The I.lon 1000 Firmware

    (the setup program will place the firmware update in this location by default). 2. If the i.LON 1000 is currently serving a web site (see Chapter 9), be sure that you have a current back up of all the pages it serves.
  • Page 27 LON 1000 must be specified. The Console Application , a built-in application that accepts commands in a manner similar to DOS or UNIX, is used to set the parameters in the i. LON 1000. i.LON 1000 Internet Server User’s Guide...

  • Page 28: Setting Up The I.lon 1000'S Ip Information

    /IP channels), basic parameters on the i.LON 1000 must be set. ORKS At a minimum, the IP address and subnet mask for each i.LON 1000 must be specified. The Console Application, a built-in application that accepts commands in a manner similar to DOS or UNIX, is used to set the parameters in the i.LON 1000.
  • Page 29 Sets/Modifies the FTP password ftpuser gh5bug 4. Type show at the command line to display the i.LON 1000 properties. Verify that the property changes you made to the i.LON 1000 are correct. For example: iLON> show Software Version: 1.01.00...
  • Page 30 Using the i.LON 1000 Console Application...
  • Page 31 ORKS twisted pair wiring. A given segment of wire is referred to as a channel. With the introduction of LNS 3.01 and the i.LON 1000, a new kind of channel has been created, the L ORKS channel.

  • Page 32: Lonworks/Ip Channels, Background And Definition

    The concept is similar to a Virtual Private Network (VPN). Each i.LON 1000 in the system is aware of its peers and each i.LON 1000 keeps peer information in its routing tables so that it can subsequently determine to which IP address a “tunneled” L...
  • Page 33 PC running LNS 2.0 could be attached to either of the FTT-10 channels. PCs running LNS 3.01 incorporate the same routing intelligence as the i.LON 1000; therefore, PCs running LNS version 3.01 or better can be directly connected to the IP network and communicate with L devices on the other side of any i.LON 1000.
  • Page 34 Note: A L /IP channel may contain at most 40 devices. If your installation requires ORKS more than 40 L /IP devices, you must create multiple L /IP channels. ORKS ORKS /IP Channels Background and Definition ORKS...

  • Page 35: Ip Resources Required To Create Lon Works /Ip Channels

    This section provides a list of the resources you will need to get from the network administrator, and information they will need to adjust any intervening firewalls to allow bi-directional communication with the outside world. i.LON 1000 Internet Server User’s Guide...

  • Page 36: Information/Resources To Be Acquired From Network Administrator

    Information/Resources to be Acquired From Network Administrator To install one or more i.LON 1000 Internet Servers on an existing IP network, you must obtain the following information and resources from the network administrator: • A static, unique IP address and subnet mask for each of the i.LON 1000s and the Configuration Server to be connected to the internal IP infrastructure.

  • Page 37: Firewall/Router Configuration Information To Be Supplied To The Network Administrator

    Firewall/Router Configuration Information to be Supplied to the Network Administrator If any i.LON 1000 or PC running LNS 3.01 is to be connected to the Internet (temporarily or permanently), adjustments to the local firewall/router may be required. These adjustments must be made for L /IP channels, HTTP access to i.LON 1000s, and supporting...
  • Page 38 /IP channel is sent between the members defined in the ORKS Configuration Server’s database. If for example an i.LON 1000 using IP address 10.1.0.10 (i.LON 1000s always use port 1628) initiates communication with a Ethernet Iinterface on a PC at IP address 10.1.0.11 that has been configured to use port 1629, the target IP address would be 10.1.0.11 with a target port of 1629 with a source IP address of 10.1.0.10 and a...
  • Page 39 (ICMP echo members request & echo of the ORKS reply) /IP channel channel Traceroute All internal TRACEROUTE external members of (ICMP echo members request & echo of the ORKS reply) /IP channel channel i.LON 1000 Internet Server User’s Guide...
  • Page 40 IP Resources Required to Create L /IP Channels ORKS...
  • Page 41 LON 1000 as a standard L router using the ORKS LonMaker Integration Tool. The Configuration Server is installed with the i .LON 1000 software, so before proceeding, install the i .LON 1000 software as described in Chapter 3. i.LON 1000 Internet Server User’s Guide...
  • Page 42 Configuration Server of all L /IP devices on the ORKS channel. A L /IP device can be an i.LON 1000 or a PC running LNS 3.01 or better. ORKS To create a L /IP channel, follow these steps: ORKS 1.
  • Page 43 If the IP channel will be set up to use MD5 authentication, enter the 16 character hexadecimal authentication key in this field. 6. Click OK. The control panel will now look as shown in Figure 7-3: i.LON 1000 Internet Server User’s Guide...
  • Page 44 /IP Channels Control Panel ORKS 7. Start the Configuration Server application. From the Windows desktop click on Start, choose Programs, select Echelon i.LON 1000, and click on i.LON 1000 Configuration Server. The Configuration Server main dialog appears: Figure 7-4 i.LON 1000 Configuration Server To rename New Channel to a more descriptive name, right-click on New Channel, select Rename Channel, and enter the descriptive name.
  • Page 45 New Channel), and select New Device. A new element representing a L ORKS device is added to the channel. This device could be either an i.LON 1000 or a /IP device on a PC running LNS 3.01 or higher. Each channel may contain up ORKS to 40 devices.
  • Page 46 /IP device. If the device is an i.LON 1000, this IP ORKS address is the same address that you assigned to the i.LON 1000 using the Console Application (see Chapter 4). If the device is on a PC running LNS, this is the IP address specified when the L /IP device was added (see steps 4-6, earlier in this section).
  • Page 47 Configuration Server's IP address and click the button again (it will now be labeled ReTest). 17. From the main dialog, select Commission Members from the Channel menu. This will attempt to configure all L /IP devices that are listed under the selected channel ORKS entry. i.LON 1000 Internet Server User’s Guide...
  • Page 48 Figure 7-9 Configuration Server: Commission Members When you select Commission Members, a communication process starts between the Configuration Server and members of the targeted channel. The process begins with a “Request for Device Registration” message to all members of the selected channel from the Configuration Server.
  • Page 49 /IP channel is established (as described in the previous section), you should define ORKS the i.LON 1000 devices using a network installation tool such as the LonMaker Integration Tool (version 2.0 or higher). This will allow information to pass from the L...

  • Page 50: Creating A Lonworks/Ip Channel

    IP Channel; Channel A of iLON #2 is attached to IP Channel, and Channel B is attached to FT-10 Channel 2. 4. Commission the i.LON 1000 Routers and leave them in the Online state. 5. If your IP network contains large latencies, change the network timing properties as described in Chapter 9.

  • Page 51: Verifying Router Functionality

    Network ORKS Verifying Router Functionality To verify that the i.LON 1000 Routers in the network shown in Figure 7-11 are working correctly, follow these steps: 1. Right-click on the network variable connection between DI-10 FB and LNS NI FB and select Monitor Input Value.
  • Page 52 IP addresses. successfully, but will the two devices. Make sure that the IP address of the target i.LON 1000 not commission. The router device, determined using the Console Application show application does not command, matches the IP address defined for it in the exist.

  • Page 53: Lon Works /Ip Channel Timing Considerations Lon Works /Ip Channel Timing Considerations

    .LON 1000's web server. In networks where the layer 3 routing function is contained within a local LAN, you may safely ignore this chapter and use the Configuration Server default for the L /IP channel ORKS configuration. i.LON 1000 Internet Server User’s Guide...

  • Page 54: Channel Timeout

    If you are sending packets across a virtual private network or any configuration that uses the Internet, set the Channel Timeout parameter to ½ the average ping delay. Synchronize the i.LON 1000 routers with a SNTP time server.

  • Page 55: Packet Reorder Timer

    For example, a device can default to its channel SNTP servers, and a channel can default to its system SNTP servers. Specifying System SNTP Servers To specify the system SNTP servers, follow these steps: i.LON 1000 Internet Server User’s Guide...

  • Page 56: Specifying Sntp Servers For A Channel Or Device

    Figure 8-1 – Setting the System SNTP Server The Options specified in this dialog, Maximum time correction and Update every, apply to the Configuration Server only. The i.LON 1000 device SNTP options are self-adjusting and cannot be configured. 2. Enter the IP addresses of the SNTP servers. Note that the SNTP server addresses should be static IP addresses.

  • Page 57: Using A Third-Party Sntp Client On The Configuration Server Pc

    You can obtain an IP address for an SNTP server for your L /IP Channel in any of ORKS the following ways: • Ask your network administrator for the IP address of an SNTP server in your corporate network. i.LON 1000 Internet Server User’s Guide...
  • Page 58 Connect to a time server on the Internet. Available public access servers include: • Site Name Site Address Ntp.css.gov 148.162.8.3 bonehed.lcs.mit.edu 18.26.4.105 canon.inria.fr 192.93.2.20 For more information on time and frequency services, log on to www.eecis.udel.edu/~mills/ntp/ Install a SNTP server on any PC in your LAN. You may use the same PC on which the •...

  • Page 59: Creating An I.lon 1000 Web Page

    This chapter contains a step-by-step tutorial that describes how create a simple i. LON 1000 web pages in conjunction with the LonMaker tool. These web pages allow you to monitor and control network variables over the Internet (or any other IP network). i.LON 1000 Internet Server User’s Guide...

  • Page 60: Overview Of Creating I.lon 1000 Web Pages

    HTML tag indicating a network variable reference. The web server substitutes the current value of a network variable for this tag when returning information to the browser. Thus, any network variable defined on the i.LON 1000 can be referenced in a web page just by incorporating the correct HTML tags.

  • Page 61: Creating The Lonmaker Network

    1. Set the i.LON 1000’s IP address, subnet mask, gateway, FTP user name, and FTP password using the i.LON 1000 Console Application as described in Chapter 4. 2. Be sure that you can ping the i.LON 1000 device and log in as a FTP user before continuing 3.
  • Page 62 7. Ensure that you are attached to the network, specify the service pin installation method, and press the Service Control Switch on the i.LON 1000 when prompted. 8. From the LonPoint stencil, drop 4 “Digital Input” functional blocks. Associate one with each input on the DI-10 device.
  • Page 63 Heartbeats are not required. 11. Drop a Functional Block shape from the LonMaker Basic Shapes stencil. Associate the functional block with the Web Server device’s Virtual Functional Block. The drawing should look similar to Figure 9-5. i.LON 1000 Internet Server User’s Guide...
  • Page 64 Figure 9-5 LonMaker Drawing Defining the i.LON 1000 Web Server 12. Drop an Input Network Variable shape from the LonMaker Basic Shapes Stencil onto the Web Server functional block to open the dialog shown in figure 9-6. Figure 9-6 – Dropping a Network Variable Shape 13.
  • Page 65 14. Assign a name to the new network variable in the New NV Name field and click OK to create the network variable on the i.LON 1000 and repeat this procedure 3 more times (once for each Digital output network variable on the DI-10 functional blocks) to create 4 input network variables on the host.

  • Page 66: Creating Web Pages

    Java applets may also be stored on the flash disk. Approximately 1 MB of space is available for user files on the i.LON 1000’s flash disk. Files are read and written to the i.LON 1000’s flash disk using standard FTP over the IP connection.
  • Page 67 HTML objects such as pictures, MP3 files, and movies. 2. Save the HTML text above as inputs.htm. 3. Upload inputs.htm to the i.LON 1000’s flash disk using a standard FTP program such as CuteFTP (http://www.cuteftp.com), AbsoluteFTP (http://www.vandyke.com), or the command line FTP client that ships with Microsoft Windows.
  • Page 68 4. To retrieve the web page enter http://24.1.7.251/forms/inputs.htm (where 24.1.7.151 is the i.LON 1000’s IP address) in the browser’s URL window. Be sure to use the proper case; file and directory names are case sensitive. You do not need to include the Web directory in the URL.

  • Page 69: How The Html Code Works

    “Update nvo1” button, you are submitting the content of the text box (really the entire form) to the i.LON 1000’s Web server. The server passes the form on to the form-processing engine through an internal i.LON 1000 interface that is similar to CGI. The engine looks for a network variable name associated with the text box, and then passes the value in the text box along with the network variable name to the i.LON 1000’s data server.
  • Page 70 (as opposed to a nvo1 is a local network variable. dropdown combo box, a list, a Important! You must include the large text field, etc.) NVL_ prefix. It is part of the required HTML syntax. 9-12 Creating an i.LON 1000 Web Page...
  • Page 71 The most common method for doing this is to use a submit button. The Web browser recognizes that when a submit button click event occurs, it is time to send the form to the web server (the i.LON 1000 in our case) to process the form.
  • Page 72 (after submittal). The method attribute indicates that the form-processing engine should get all the values in the current form as a QueryString when the submit button is pressed. The “post” method is not supported. 9-14 Creating an i.LON 1000 Web Page...

  • Page 73: Advanced Usage Of The Html Tag

    HTML tag that provides access to i. LON 1000 system data and dynamic network variable data for monitoring and control through a web browser. This chapter assumes you have a basic understanding of HTML. i.LON 1000 Internet Server User’s Guide 10-1...

  • Page 74: Ilonweb> Web Tag Format

    These are described in further detail in this chapter. While the i.LON 1000 Web server parses and replaces the web tags in its HTML files according to their function, it ignores all text between the <iLonWeb...> and </iLonWeb>...

  • Page 75: Func=Createsymbol

    The i.LON 1000 Web server uses web tag symbol names to identify and retrieve different types of i.LON 1000 system data and network variable data that can be displayed in web pages. Web tag symbol names have prefixes that determine their type as described in Table 10-1.

  • Page 76: Network Variable Symbols (Nvl_ And Nve_ Prefixes)

    1000 Web server. Two types of network variable references may be used in i.LON 1000 Web server web pages: local network variable references and explicit network variable references. Local network variable references cause the i.LON to return the value cached in a dynamically created local...
  • Page 77 In these cases, you need to poll the network variables on the network without binding them to the i.LON 1000's virtual functional block. Because the network variable is not local to the i.LON 1000, the network variable must be explicitly identified by a combination of its network address, NV type information, and transport attributes.
  • Page 78 A selector value of FFFF in this field signifies that the i.LON 1000 is polling some device's output network variable.
  • Page 79 1000 may simultaneously belong to two domains. ORKS The DM element of the NVE_ tag tells the i.LON 1000 web server which of it’s domain table entries to use for the network variable poll. (In this case we are specifying the first entry –...
  • Page 80 Complex Example of Using the NVE_ Symbol This example shows how the NVE_ symbol can be used to control a number of network variable inputs and outputs which are not bound to the i.LON 1000 device. Given a device containing the following Neuron C application: #pragma enable_io_pullups IO_0 output bit ioLED = 1;...
  • Page 81 <iLonWeb func=TextField type=text symbol=NVE_AS:SN.DM:0.SU:1.NO:3.ST:AK.PR:0.AU:0.SY:0.NI:1.NS:3FFE.RY:3. TX:192.TY:8.SZ:2 size=20></iLonWeb><p> nvi2: <iLonWeb func=TextField type=text symbol=NVE_AS:SN.DM:0.SU:1.NO:3.ST:AK.PR:0.AU:0.SY:0.NI:2.NS:3FFD.RY:3. TX:192.TY:8.SZ:2 size=20></iLonWeb><p> nvi3: <iLonWeb func=TextField type=text symbol=NVE_AS:SN.DM:0.SU:1.NO:3.ST:AK.PR:0.AU:0.SY:0.NI:3.NS:3FFC.RY:3. TX:192.TY:8.SZ:2 size=20></iLonWeb><p> <input type="submit" value="Submit"> <br> <br> nvo0: <iLonWeb func=ShowValue symbol=NVE_AS:SN.DM:0.SU:1.NO:3.ST:AK.PR:0.AU:0.SY:0.NI:4.NS:FFFF.RY:3. TX:192.TY:8.SZ:2></iLonWeb><p> nvo1: <iLonWeb func=ShowValue symbol=NVE_AS:SN.DM:0.SU:1.NO:3.ST:AK.PR:0.AU:0.SY:0.NI:5.NS:FFFF.RY:3. TX:192.TY:8.SZ:2></iLonWeb><p> i.LON 1000 Internet Server User’s Guide 10-9...
  • Page 82 To make the job of creating <iLonWeb> network variable tags easier and more accurate, the i.LON 1000 software ships with an i.LON 1000 web tag wizard (installed under PROGRAMS | Echelon i.LON). This wizard automatically generates an <iLonWeb> HTML tag based on the information you enter.

  • Page 83: System Symbols (Ilon_ Prefix)

    “ILON_”. The system symbols in Table 10-3 are used with the ShowValue tag to display information from the i.LON 1000 device. The symbols are also demonstrated in the default web page example, which is installed on the PC in iLON\Images\Web\forms\localConfig.htm.

  • Page 84: Web Tag Attributes

    Table 10-4 – System Symbol Names (ILON_ Prefix) Used to Obtain Memory Information Web Tag Symbol Description iLon_Mem_RequestPartTotal Total memory allocated to process requests. iLon_Mem_RequestPartFree Free memory in a request partition. iLon_Mem_RequestPartLargest Largest free block in a request partition. iLon_Mem_RequestPartUsed Used memory in a request partition.

  • Page 85: Format

    This is a set of files that describes the data structures within SNVTs and also describes the formats to be used for display of SNVT data. On the i.LON 1000, these files may be found in the directory /root/lonworks/types, and are named STANDARD.ENU, STANDARD.TYP, STANDARD.FMT and STANDARD.FPT.

  • Page 86: Propagate

    displays the data as hexadecimal byte values, with each byte separated by a space. The “RAW_HEX_PACKED” format displays each byte as a two-digit hex value, with no spaces in between the byte values. The “RAW_HEX_PACKED” format is the default format for non-SNVT network variables that do not specify a format.

  • Page 87: Working With Forms

    Only one form is recommended for each page. See Form Element Functions later in this manual for further information. A function within the i.LON 1000 web tag, called a form element function, invokes a routine that performs a specific task. The form element function acts upon the network variable that you specify in the SYMBOL= attribute.

  • Page 88: Netscape Browser Constraint

    <INPUT type=”reset” value=”Reset modifications”> Important! Clicking the submit button causes all forms on a page to submit their data to the server, even if no change has been made to a form. While the i.LON 1000 Web server 10-16 Advanced Usage of the <iLonWeb> HTML Tag...

  • Page 89: Refresh A Form

    <a href=”iLonTest1.htm”><b>Refresh</b></a> Form Element Functions This section describes the form element functions supported by the i.LON 1000 Web server. The following table lists the i.LON 1000 Web server form element functions and their actions. Unlike most HTML elements, the i.LON 1000 web tag functions are case sensitive.

  • Page 90: Checkbox

    </iLonWeb> The ending i.LON 1000 tag. Hidden The Hidden function allows you to include text in your web page without displaying it on the screen.

  • Page 91: Radiobutton

    This is an example of the TextArea function that creates an input area with 4 rows and 6 columns. The table below describes each web tag element. <iLonWeb FUNC=TextArea TYPE=text SYMBOL=NVL_nvoBuffer ROWS=4 COLUMNS=6></iLonWeb> i.LON 1000 Internet Server User’s Guide 10-19...

  • Page 92: Textfield

    Web Tag Element Description The i.LON 1000 web tag. <iLonWeb> FUNC=TextArea Specifies the text area function. Causes a text area in the web page form to be created. TYPE={text|password} “Text” specifies the input will appear as text. “Password” specifies that input will appear as asterisks in the text box.
  • Page 93 1000 Web Page Security This chapter contains information on restricting viewing and modification of i .LON 1000 web pages. i.LON 1000 Internet Server User’s Guide 11-1...

  • Page 94: Setting Access Restrictions

    /root/Web from any location by any user. To modify existing i.LON 1000 web security you have to create a new (or edit the existing) WebParams.dat file. The updated file must be transferred (uploaded) to the i.LON 1000, and the i.LON 1000 must be rebooted for the new security settings to take effect.

  • Page 95: Users And Groups

    Figure 11-2 – URL Examples Users and Groups Each person who will be given access (i.e. a user name and password) to the i.LON 1000 is called a user. Users are organized into groups. Each user can be in exactly one group, and all users in a given group will have identical access.
  • Page 96 Table 11-1 – Example i.LON 1000 Web Page Security Chart floor 1 floor2 floor3 Jill John superuser The i.LON security mechanism allows each user to be a member of one group only. Thus, the 4 groups will need to be created. One each for access to floors 1 & 2 (Bob), floor 2 (Ann,...

  • Page 97: Locations

    Use the i.LON Web Server Parameters application’s Locations tab to define these locations as shown in Figure 11-5. Figure 11-5 – Setting i.LON 1000 Locations Note that if you declare a location “A” that happens to be a subset of another location “B”, it is assumed that “A”...

  • Page 98: Sample Webparams.dat File

    For example, design a security setup for an i.LON 1000 website that allows users to monitor occupancy information, temperature, and lux level on the floor on which they live. This is a three-story building so we have floors 1, 2 and 3, with corresponding web pages stored in subfolders under /forms: /forms/floor1, /forms/floor2, and /forms/floor3.
  • Page 99 (Realms) /*:admin:topgun /forms/floor1/*:floor12_tenants:topgun /forms/floor2/*:floor12_tenants:topgun /forms/floor2/*:floor2_tenants:topgun /forms/floor3/*:floor3_tenants:topgun /forms/floor1/*:floor12_tenants:tenants /forms/floor2/*:floor12_tenants:tenants /forms/floor2/*:floor2_tenants:tenants /forms/floor3/*:floor3_tenants:tenants i.LON 1000 Internet Server User’s Guide 11-7...
  • Page 100 11-8 i.LON 1000 Web Page Security...

  • Page 101: Advanced Topics

    Advanced Topics This chapter provides detailed information on i. LON 1000 advanced topics. i.LON 1000 Internet Server User’s Guide 12-1...

  • Page 102: Aggregation

    IP, decreases IP network traffic, and greatly increases the performance of the i.LON 1000 router. The i.LON 1000 router is set through the Configuration Server to use aggregation by default. The aggregation time parameter controls how long the router will wait for packets. The timer operates in multiples of 16.6 milliseconds;...
  • Page 103 (For more information on the MD5 algorithm refer to RFC 1321.) The authentication key, consisting of 16 HEX pairs, is set for each i.LON 1000 through the Console Application. Authentication is enabled and the authentication key set for the /IP channel through the Configuration Server.

  • Page 104: Device Resource Files

    DHCP server reservations. If you decide to use DHCP, you must decide whether or not your i.LON 1000 should have a static IP address. A static address is one that does not change each time the i.LON 1000 boots.

  • Page 105: Dhcp Server Failure

    You do not need to use a static address if you are running the i.LON 1000 Web server only and do not want to manage it with the Configuration Server. If your i.LON 1000 needs a static address, your network administrator will need to create an individual address reservation for it in the DHCP server, most likely using the Ethernet MAC ID of the i.LON...
  • Page 106 Fatal exception reboot; intvec#<vector>;pc:<address> A fatal exception has occurred. The event will be followed by a stack trace of the task that took the exception. The device will reboot after a fatal exception. Remotely initiated reboot request received The Configuration Server sent a remote boot request. **********System started************ The system started after a reboot.

  • Page 107: Using I.lon 1000 Devices With Snmp

    Using i .LON 1000 Devices with SNMP The i.LON 1000 supports SNMP v1/v2 protocols and comes standard with MIB II support for managing networked devices. The SNMP agent runs a task on the i.LON 1000 and responds to requests for device information from an IP network manager such as Netview or HP OpenView.
  • Page 108 A backup copy of the configuration file exists in \lonworks\iLON\Images\iLON 1.00\snmp on the PC for restoring the file if needed. The i.LON 1000 copy of the file gets overwritten upon reboot and, as a result, any comments, such as which values can be changed, are lost.
  • Page 109 Appendix A i.LON Console Application Reference This appendix provides an overview of the Console Application and describes the console commands, the i. LON 1000 boot process, and the line editor. i.LON 1000 Internet Server User’s Guide...

  • Page 110: Appendix A - Console Application

    1000 displays its normal command-line prompt. If the i.LON 1000 repeatedly fails to boot up, you are unable to FTP files to it, or you suspect the image is corrupted, you may interrupt the boot process to troubleshoot the i.LON 1000.

  • Page 111: Command Description

    Deletes a file or directory. dhcp [on|off] Indicates whether DHCP will be used to retrieve the i.LON 1000’s IP address, subnet mask, and gateway address. Set DHCP to off to manually configure the IP address, subnet mask, and gateway address. See Using DHCP with i.LON 1000 Devices in Reference for more information on using DHCP.

  • Page 112: Special Control Commands

    Special Control Commands Ctrl X When the Console Application is active, the keystroke, Ctrl X, reboots the i.LON 1000. Use the Ctrl X keystroke as a last resort to reboot in cases when the system is hung and will not respond to console commands.

  • Page 113: Command History And Line Editing

    20 typed commands and the line editor provides keystrokes to edit previously typed commands. If you are using HyperTerminal as the terminal emulator to connect to the i.LON 1000 console application, set your function, arrow, and control keys to function like in Windows.

  • Page 114: Insert Commands

    - Get nth previous command in history. - Same as k. - Get nth next command in history. - Same as j. - Move left n characters. BACKSPACE - Same as h. - (letter el) Move right n characters. SPACE - Same as l.

  • Page 115: Special Commands

    - Toggle case, lower to upper or vice versa. *The default value for n is 1. Special commands - Delete line and leave edit mode. - Redraw line. RETURN - Leave edit mode and give line to command processor. i.LON 1000 Internet Server User’s Guide...
  • Page 116 i.LON Console Application Reference...

  • Page 117: Appendix B - Web

    Appendix B Web Page Examples This appendix explains how to install and use the Web server application example, including a LonMaker network and web pages, that ships with the i. LON 1000. i.LON 1000 Internet Server User’s Guide...

  • Page 118: I.lon 1000 Web Server Application Examples

    The i.LON 1000 PC software includes examples of Web server applications that illustrate and explain how the i.LON 1000 can be used as a Web server. After setting up these Web server examples, you will be able to monitor and control your LonPoint devices through a web browser.

  • Page 119: Monitor Local Network Variable (Exampg1.Htm And Exampg6.Htm

    Server. To restart the Web Server, click Start Web Server. 6. Use a web browser to view the example web pages. Enter the IP address of the i.LON 1000 Web server into the address field in your web browser along with the directory of the web page that you wish to view.

  • Page 120: Change A Remote Input Network Variable (Exampg4.Htm

    Write NV button. The value is changed on the remote device, but is not reflected on the i.LON 1000 device since this is an update to a remote input network variable. This web page uses frames to format the page and display the SNVT_switch network variable values for the value and state fields.

  • Page 121: Appendix C - Client Side Programming Examples

    A discussion of scripting languages is beyond the scope of this document. This chapter provides two examples of passing network variable information to a scripting language. i.LON 1000 Internet Server User’s Guide...

  • Page 122: Loading A Network Variable Value Into A Javascript Variable

    Loading a Network Variable Value into a JavaScript Variable Loading a network variable value into a JavaScript variable is useful when you want to interpret the meaning on a network variable for your user. For example, you may want to print “ON”...

  • Page 123: Automatically Refreshing Web Pages Using Javascript

    The following code generates the web page shown above: <HEAD> <TITLE>Reload Example</TITLE> <SCRIPT> //------------------------------------------- // Returns a random number between 0 and 1 //------------------------------------------- function getRandom() return Math.random() //------------------------------------------- // Forces a reload of the current URL //------------------------------------------- function reloadMe() window.location.reload() </SCRIPT></HEAD> i.LON 1000 Internet Server User’s Guide...
  • Page 124 <HTML> <BODY> This page will reload itself every 2 seconds. A random number is generated each time the page loads.<p> <SCRIPT> //------------------------------------------------------ // Writes a random number to the page //------------------------------------------------------ var x = getRandom(); document.write(x) </SCRIPT> <SCRIPT> //------------------------------------------------------ // The setTimeout() function evaluates an expression or // calls a function once after a specified number of // milliseconds elapses // Here it is used to call the reloadPage() function...
  • Page 125 Appendix D i.LON 1000 Web Server Errors This appendix describes the hypertext transfer protocol (HTTP) errors which can occur when developing a web page with the i .LON 1000 web server. i.LON 1000 Internet Server User’s Guide...

  • Page 126: Appendix D - I.lon 1000 Web Server Errors

    HTTP Errors The following errors may occur when viewing a web site which is served by the i.LON 1000 web server: Error Cause HTTP_BAD_REQUEST (400) The web page contains invalid HTTP protocol. This error may occur if an HTTP request improperly "escapes"...

Table of Contents