Echelon i.LON 1000 User Manual Download Page 125

Page: 125 / 126

.LON 1000 Internet Server User’s Guide

D-1

Appendix D

.LON 1000 Web Server

Errors

This appendix describes the hypertext transfer protocol (HTTP)

errors which can occur when developing a web page with the

.LON 1000 web server.

Summary of Contents for i.LON 1000

Page 1: ...i LON 1000 Internet Server User s Guide Version 1 01 078 0184 01B...

Page 2: ...are trademarks of Echelon Corporation No part of this publication may be reproduced stored in a retrieval system or transmitted in any form or by any means electronic mechanical photocopying recordin...

Page 3: ...nce server that provides connectivity between LONWORKS control networks and Internet Protocol IP data networks while enabling access to network variable information by standard web browsers This user...

Page 4: ...tc Chapter 5 LONWORKS IP Channels Background and Definition provides the theoretical basis for using LONWORKS IP channels This chapter introduces the concept of tunneling LONWORKS packets through an I...

Page 5: ...e Application provides an overview of the Console Application and describes the console commands the i LON 1000 boot process and the line editor Appendix B Web Page Examples explains how to install an...

Page 6: ...g Power and Installation Troubleshooting 2 9 3 i LON 1000 Software i LON 1000 Software and PC Utilities 3 2 i LON 1000 Applications 3 2 Console Application 3 2 Router Application 3 2 Data Server Appli...

Page 7: ...rver 8 5 9 Creating an i LON 1000 Web Page Overview of Creating i LON 1000 Web Pages 9 2 Required Hardware 9 2 Required Software 9 2 Setting Up The Hardware 9 2 Creating The LonMaker Network 9 3 Creat...

Page 8: ...2 Special Control Commands A 4 Command History and Line Editing A 5 Line Editor Commands A 5 Movement and search commands A 5 Insert commands A 6 Editing commands A 6 Special commands A 7 Appendix B W...

Page 9: ...i LON 1000 Internet Server User s Guide 1 1 1 Introduction This chapter provides an introduction to the i LON 1000 Internet Server including its applications hardware software and utilities...

Page 10: ...rnet the i LON 1000 opens a new world of applications markets and business opportunities Figure 1 1 i LON 1000 Front Panel The i LON 1000 offers unparalleled performance and reliability Certified unde...

Page 11: ...l branches across the world can be seamlessly and transparently linked together and connected to far flung corporate data and ERP networks The impressive performance of the i LON 1000 is due to the co...

Page 12: ...1 4 Introduction...

Page 13: ...i LON 1000 Internet Server User s Guide 2 1 2 Shipping Content Hardware This chapter describes the i LON 1000 Internet Server hardware and explains the various mounting and cabling options...

Page 14: ...wo position black connector for power input Weidm ller PN 125911 Optional Accessories i LON 1000 accessories include a universal 100 240 VAC input regulated 24VDC external power supply and 19 inch rac...

Page 15: ...LON 1000 Back Panel Input Power The i LON 1000 operates from low voltage 24VAC or DC at 1A The i LON 1000 may be powered by an optional Echelon 24VDC plug in power supply model 72901 p where p identif...

Page 16: ...nel Suitable cables for LONWORKS channels are listed in Echelon s engineering bulletin Junction Box and Wiring Guidelines part number 005 0023 01 available from Echelon s web site at www echelon com U...

Page 17: ...euron ID for the nodes Service pin messages are sent for active applications only Diagnostic LEDs Four back panel LEDs Power 10BaseT Service and Status and one front panel LED Power indicate server an...

Page 18: ...applied Booted properly In process of booting Hardware self test error Check power LED OR Booted but application software failed to start N A This happens if the i LON does not have a valid IP address...

Page 19: ...apart Screw height above the wall or panel surface should be approximately 0 25 inches 64 mm 4 Place the keyholes on the bottom of the i LON 1000 over the wall mounting screws Push the i LON 1000 towa...

Page 20: ...om 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 3 Align the holes on the short side of one bracket with the holes on the side of the...

Page 21: ...ly connected to i LON 1000 Ensure that the screw terminal connector is firmly seated and the wiring properly stripped of insulation and clamped by the connector screws Network cabling shorted open or...

Page 22: ...iver 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 If too many...

Page 23: ...i LON 1000 Internet Server User s Guide 3 1 3 i LON 1000 Software This chapter describes the various software components within the i LON 1000 and how to install the PC based software utilities...

Page 24: ...te description of this application is included in Appendix A Router Application The i LON 1000 s router application allows IP to be used as a standard LONWORKS channel Here the term router is used to...

Page 25: ...gh the definition of each parameter necessary to build an HTML tag referring to network variables anywhere in your LONWORKS network See Chapter 10 for more information about the iLonWeb HTML tag Web S...

Page 26: ...CD drive The i LON 1000 Setup window appears and prompts you through installing the PC software and utilities Updating the i LON 1000 Firmware New versions of the i LON firmware may become available...

Page 27: ...LONWORKS IP channel described Chapters 5 7 basic parameters on the i LON 1000 must be set At a minimum the IP address and subnet mask for each i LON 1000 must be specified The Console Application a b...

Page 28: ...t came with your i LON 1000 Connect to the Console Application using a VT 100 terminal emulation program such as HyperTerminal If using HyperTerminal set the function arrow and control keys to work as...

Page 29: ...the property changes you made to the i LON 1000 are correct For example iLON show Software Version 1 01 00 IP Address 10 1 0 170 Subnet Mask 255 255 255 0 Host Name iLON Gateway 10 1 0 1 DHCP off MAC...

Page 30: ...4 4 Using the i LON 1000 Console Application...

Page 31: ...onally LONWORKS networks operate over dedicated 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 b...

Page 32: ...keeps peer information in its routing tables so that it can subsequently determine to which IP address a tunneled LONWORKS packet should be forwarded Consider Figure 5 1 i LON i LON FTT 10 FTT 10 TCP...

Page 33: ...ORKS devices on the other side of any i LON 1000 This allows topologies such as that shown in Figure 5 3 i LON TCP IP LNS 3 0 Workstation LonWorks IP Channel FTT 10 Figure 5 3 i LON 1000 and LNS 3 Wor...

Page 34: ...RKS IP Channels Background and Definition Note A LONWORKS IP channel may contain at most 40 devices If your installation requires more than 40 LONWORKS IP devices you must create multiple LONWORKS IP...

Page 35: ...et Servers on an existing IP network you will need to work closely with the IP network administrator This section provides a list of the resources you will need to get from the network administrator a...

Page 36: ...channel when underlying IP addresses change If DHCP will be used to retrieve the IP information for the i LON 1000 the network administrator must ensure that a DHCP server is available to provide the...

Page 37: ...bal Internet access to internal members of a LONWORKS IP channel In the table a member of a LONWORKS IP channel may be an i LON 1000 a Configuration Server an LNS Server version 3 01 or better or Full...

Page 38: ...ss 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 source port of 1628 The source po...

Page 39: ...al members of the LONWORKS I P channel PING ICMP echo request echo reply N A N A Ping Out All external members of the LONWORK S IP channel All internal members of the LONWORKS IP channel PING ICMP ech...

Page 40: ...6 6 IP Resources Required to Create LONWORKS IP Channels...

Page 41: ...ing instructions for setting up networks channels and devices using the Configuration Server and defining and testing the i LON 1000 as a standard LONWORKS router using the LonMaker Integration Tool T...

Page 42: ...1000s using the i LON console application as described in Chapter 4 2 Ensure that the Configuration Server PC can communicate with each i LON 1000 or PC running LNS 3 01 by pinging each i LON 1000 an...

Page 43: ...o the IP device of the PC if the PC has multiple Ethernet cards with different IP addresses you may choose between them IP Port The port that the LONWORKS IP device will use on the LNS 3 01 PC By defa...

Page 44: ...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 S...

Page 45: ...p 7 the New Channel s Server Address is set to 10 1 3 78 port 1629 This confirms that the Configuration Server is running on a PC with an IP address of 10 1 3 78 and the utility is using port 1629 to...

Page 46: ...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 LONWORKS IP device was added see steps 4 6 earlier in this sectio...

Page 47: ...g LNS 3 01 or later only respond to Configuration Server setup messages when the LONWORKS IP device is open To force a LONWORKS IP device to open open the LONWORKS IP Channels control panel and click...

Page 48: ...Membership date time included in the Device Configuration message Based on this date and time devices determine whether more recent Channel Membership information is available If so the devices reques...

Page 49: ...ing LONWORKS devices together you ll notice that the procedure below is exactly the same as if we were using standard LONWORKS routers Designing a LonMaker Network Containing LONWORKS IP Channels The...

Page 50: ...if using a local IP network or IP 10W if using a wide area IP network such as the Internet for the Transceiver Type in the Channel s properties For FT 10 Channel 2 assign TP FT 10 as the Transceiver...

Page 51: ...ee network variable updates reported by LonMaker there is a problem Refer to Table 7 2 for troubleshooting information Table 7 2 Troubleshooting the i LON 1000 Router Symptom Probable Cause Corrective...

Page 52: ...s in the main dialog status window of the Configuration Server A device i LON 1000 added to a LONWORKS IP channel using the Configuration Server remains red in the device tree The Configuration Server...

Page 53: ...00s in layer 3 routing mode over IP networks with unusually large latencies such as the Internet This information does not apply to the i LON 1000 s web server In networks where the layer 3 routing fu...

Page 54: ...gation delay is a high percentage of the channel timeout or channel delay add twice the aggregation delay to the Channel Delay and one times the aggregation delay to the Channel Timeout Use the ping c...

Page 55: ...d out of order packets are never sent onto the LONWORKS network Channel Delay Channel Delay is an LNS property that specifies the value of the expected round trip time of a message i e message and res...

Page 56: ...d 3 Click OK to save and return to the main dialog Specifying SNTP Servers for a Channel or Device By default all Channels default to the SNTP server specified for the System as described above and al...

Page 57: ...the channel level so that each channel can synchronize to a SNTP server Follow these steps to configure the Configuration Server to use a third party SNTP client to update the PC s clock 1 Select Set...

Page 58: ...0 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 Configuration Server is in...

Page 59: ...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 cont...

Page 60: ...defined on the i LON 1000 can be referenced in a web page just by incorporating the correct HTML tags Web pages may be constructed with any off the shelf HTML editor Required Hardware You will need t...

Page 61: ...me Channel State Domain hex Subnet Node 1 Router LonTalk Unconfigured IP Unconfigured 3 DataServer LonTalk Unconfigured 4 WebServer Activated Three applications should be running in the i LON 1000 the...

Page 62: ...rom the LonPoint stencil drop 4 Digital Input functional blocks Associate one with each input on the DI 10 device 9 From the LonPoint stencil drop 4 Digital Output functional blocks Associate one with...

Page 63: ...at 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...

Page 64: ...to the Web Server functional block to open the dialog shown in figure 9 6 Figure 9 6 Dropping a Network Variable Shape 13 Click Create NV to open a dialog which allows you to dynamically create comple...

Page 65: ...Add all the created input network variables as shapes to the Web Server functional block by clicking Select All and OK from the Choose a Network Variable dialog shown in Figure 8 6 16 Repeat the proce...

Page 66: ...00 system and network variable data through a web browser such as Netscape Navigator version 4 0 or higher or Microsoft Internet Explorer version 4 01 or higher HTML files reside in a special director...

Page 67: ...ient that ships with Microsoft Windows The i LON 1000 directory structure is as follows All web pages must be in the directory named Web or in a subfolder of Web Any page that references network varia...

Page 68: ...proper case file and directory names are case sensitive You do not need to include the Web directory in the URL Web is the implied root for all http requests 5 Assume that switches 1 and 2 are OFF and...

Page 69: ...programs usually do something simple like create a GIF image of a stock chart based on stock symbol provided by the user Usually the stock symbol is typed into a text box When the user clicks the crea...

Page 70: ...func TextField type text symbol NVL_nvo1 size 20 iLonWeb p input type submit value Update nvo1 form Creates an element in a form that is associated with a network variable In this case the element is...

Page 71: ...ent the necessary security to prevent access to network variables on web pages that are outside of a user s access range See Chapter 11 for more information on setting up i LON 1000 web page security...

Page 72: ...eb p input type submit value Update nvo1 form All forms have an action attribute This attribute indicates which page will be served next after submittal The method attribute indicates that the form pr...

Page 73: ...s information on creating more advanced web pages using the iLonWeb HTML tag The iLonWeb tag is an extended HTML tag that provides access to i LON 1000 system data and dynamic network variable data fo...

Page 74: ...ion it ignores all text between the iLonWeb and iLonWeb tags In contrast a standard browser reading the same HTML file will ignore the web tags and process the text between the tags This feature can b...

Page 75: ...eSymbol SYMBOL User Symbol VALUE user defined iLonWeb User Symbol may be any name not starting with symbol prefixes used in the Web Tag Symbol Names section The following HTML example creates and test...

Page 76: ...f local network variables is accomplished through the use of the NVL_ symbol described below Explicit network variable references are not located on the i LON 1000 Web server but exist elsewhere in th...

Page 77: ...n create dynamic network variables but you need so many that you run out of address table entries In these cases you need to poll the network variables on the network without binding them to the i LON...

Page 78: ...t from the far side AK The update message is sent out and waits for an acknowledgement from the far side for TX Timer milliseconds If no acknowledgement is received for the TX Timer period the update...

Page 79: ...controller thus the network variable index of nvoMasterPower is 3 since network variable indexes are zero based The car controller device has a subnet node address of 1 5 and is installed on the 1 byt...

Page 80: ...ining the following Neuron C application pragma enable_io_pullups IO_0 output bit ioLED 1 IO0 LED on LTM 10 Eval Board IO_4 input bit ioSwitch IO4 Switch on LTM 10 Eval Board network input SNVT_count...

Page 81: ...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...

Page 82: ...e because there is no guarantee that the network variable updates will return from the devices before the resulting page is served back to the browser In a production system you may wish to use the br...

Page 83: ...iver iLon_Sys_LocalPort The IP port used by the LONWORKS IP communications software Normally 1628 iLon_Sys_ConfigServer The IP address and port of the Configuration Server if any The port follows the...

Page 84: ...used in any combination within a single iLonWeb tag with the exception of WAIT WAIT must be used in conjunction with PROPAGATE The colon is required as part of the syntax If web tag attributes are use...

Page 85: ...a set of files created by device manufacturers to describe non standard network variables Using the same mechanisms as the standard resource files they describe how to format data from a particular m...

Page 86: ...ill cause the network variable value to be propagated over the network Note that if you set propagate to TRUE for each field some fields may contain indeterminate values in the network variable update...

Page 87: ...b tag uses the check box function and assigns a value of 1 to the state field of the DigitalOut network variable when the user selects this checkbox in a web page iLonWeb FUNC CheckBox SYMBOL NVL_Digi...

Page 88: ...bmit name Submit value Submit p form If the Action of the form is not set the File not found error will be shown on a return page from the Web server Submit or Reset a Form Once information has been e...

Page 89: ...your web page This function will get the latest value of the network variable and display it when the web page is reloaded For example INPUT type button value Refresh onClick window location assign w...

Page 90: ...ck box and submits the form for processing The form processor will set a value of 0 for a deselected check box The web tag example below creates a CheckBox object in a web page form The table that fol...

Page 91: ...ton SYMBOL NVL_nvoRb1 VALUE 2 iLonWeb iLonWeb FUNC RadioButton SYMBOL NVL_nvoRb1 VALUE 3 iLonWeb Web Tag Element Description iLonWeb The i LON 1000 tag FUNC RadioButton Specifies the radio button func...

Page 92: ...modify a network variable value The text box example and description below creates a text box that is 20 characters wide and allows the user to update a local output network variable named nvoDigital...

Page 93: ...i LON 1000 Internet Server User s Guide 11 1 11 i LON 1000 Web Page Security This chapter contains information on restricting viewing and modification of i LON 1000 web pages...

Page 94: ...Also be sure to secure the PC on which you generated the WebParams dat file The i LON 1000 s factory default WebParams dat file allows access to all files found under root Web from any location by an...

Page 95: ...word 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 If each user must have different...

Page 96: ...1 2 Bob floor 2 Ann Jill floor 3 John and all floors superuser To set up the users and groups described above follow these steps 1 Setup usernames and passwords from the users tab of the i LON Web Ser...

Page 97: ...user property manager to update web pages 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 Not...

Page 98: ...s may have any IP address in the network 10 1 0 0 24 i e 10 1 0 1 10 1 0 254 There is one superuser that designs web pages and has unlimited access to the website for security reasons he will access t...

Page 99: ...1 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 ten...

Page 100: ...11 8 i LON 1000 Web Page Security...

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

Page 102: ...the timer resets However if another LONWORKS packet arrives within the aggregation time period the router waits the designated time for subsequent packets to arrive anticipating a burst so it can aggr...

Page 103: ...ONWORKS IP channel through the Configuration Server To reset a lost authentication key you must obtain physical access to the device and reset the key through the device s serial port To enable authen...

Page 104: ...ailure If the DHCP server fails the i LON 1000 will not be able to retrieve its addresses and as a result will not function after a reboot Manual configuration of the i LON 1000 addresses eliminates t...

Page 105: ...ing Control X Interrupt the boot process by pressing the when instructed as described in Interrupting the Boot Process in Appendix A The command prompt reappears 2 Issue the command dhcp off to disabl...

Page 106: ...nged remotely using the Configuration Server NVRAM reset to factory defaults The NVRAM contents have been reset to the factory default settings Web server is unable to open WebParams dat The Web serve...

Page 107: ...ith the i LON 1000 Configuration Server Startup Server start failed An unforeseen error has prevented a proper startup Consider setting factory defaults through the Console Application LONWORKS channe...

Page 108: ...ocation and sysContact variables 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 o...

Page 109: ...t Server User s Guide A 1 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 an...

Page 110: ...ess press the exclamation point key when the Press the key to stop auto boot message appears on the console This message displays for approximately 4 seconds at the beginning of the boot process follo...

Page 111: ...e for more information on using DHCP dir directory Lists file directory contents factorydefault Restores the i LON 1000 settings to the factory default settings Any files such as web pages added by th...

Page 112: ...ems subnetmask address Modifies sets the subnet mask e g subnetmask 255 255 255 0 time hh mm ss Sets the time Not allowed if the device is synched to a time server timezone zone Use this command for d...

Page 113: ...on the Settings tab and select the Windows keys radio button Line Editor Commands To edit a command press the ESC key to enter edit mode and use the commands listed below Certain commands e g i will e...

Page 114: ...character in line Go to end of line 0 Go to beginning of line Insert commands Input is expected until ESC is pressed a Append A Append at end of line c SPACE Change character cl Change character cw Ch...

Page 115: ...t Server User s Guide A 7 Toggle case lower to upper or vice versa The default value for n is 1 Special commands U Delete line and leave edit mode L Redraw line RETURN Leave edit mode and give line to...

Page 116: ...A 8 i LON Console Application Reference...

Page 117: ...ernet Server User s Guide B 1 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 t...

Page 118: ...e lonworks iLON Examples WebPages PC directory o exampg1 htm o exampg2 htm o exampg3 htm contains exampg31 htm exampg32 htm and exampg33 htm o exampg4 htm contains exampg41 htm exampg42 htm and exampg...

Page 119: ...he new value of the local network variable through the web page by clicking on the Refresh button to display the most recent network variable values In exampg1 htm the network variable is displayed on...

Page 120: ...remote input network variable This web page uses frames to format the page and display both the SNVT_switch and UNVT_switch type network variable values for the value and state fields Evaluate and Cal...

Page 121: ...MicroSoft Corp and JavaScript developed by Netscape Communications in cooperation with Sun Microsystems Both of these scripting languages let you create highly interactive web pages and both are comp...

Page 122: ...ans that you can assign a network variable value to a JavaScript variable in the same way that you assign a string to a JavaScript variable HEAD TITLE EXAMPLE TITLE SCRIPT function printLightState Pic...

Page 123: ...tc In the following example JavaScript is used to access the window object through the browser s DOM to cause the web page to reload automatically The web page generated by this code is shown in figur...

Page 124: ...the reload process p FORM INPUT TYPE button VALUE Stop Reloading NAME stop_reloading_button onClick clearTimeout timerID FORM BODY HTML Scripting languages can be used to load multiple animated GIF f...

Page 125: ...ternet Server User s Guide D 1 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 100...

Page 126: ...ver processes a maximum size query string of 1024 bytes The maximum size of the query string may be modified by changing the value of Maxurlsize in the i LON 1000 s params dat file Note The maximum si...

Search results

Summary of Contents for i.LON 1000

Reviews:

Related manuals for i.LON 1000

Brands by name

Popular brands

Echelon i.LON 1000, User Manual

Search results

Summary of Contents for i.LON 1000

Reviews:

Related manuals for i.LON 1000

Brands by name

Popular brands