background image

i

.LON

 1000 Internet

Server

User’s Guide

Version 1.01

078-0184-01B

Содержание i.LON 1000

Страница 1: ...i LON 1000 Internet Server User s Guide Version 1 01 078 0184 01B...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 12: ...1 4 Introduction...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 30: ...4 4 Using the i LON 1000 Console Application...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 40: ...6 6 IP Resources Required to Create LONWORKS IP Channels...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 100: ...11 8 i LON 1000 Web Page Security...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 116: ...A 8 i LON Console Application Reference...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы: