Instruction Manual

You can create or modify the files using any XML editor or ASCII text editor. This document

provides examples you can use when creating the XML configuration files for your i.LON

100, and instructions to follow when downloading these files to the i.LON 100. The XML files

used by the i.LON 100 applications conform to the XML 1.0 Technical Recommendation:

http://www.w3.org/TR/2000/REC-xml-20001006

Echelon strongly recommends that you use the SOAP interface to configure the

applications of your i.LON 100. The i.LON 100 performs error-checking on all data

written in a SOAP message, so that invalid data will not be written to any of the XML files.

The i.LON 100 will not perform error-checking on any XML files downloaded to it via FTP,

and so manually editing the XML files may cause errors during the boot process.

Additionally, you can send SOAP messages to the i.LON 100 while it is operating, and the

i.LON 100 will update the XML files affected by the SOAP messages without requiring a

reboot.

You may find the information in this document that pertains to manually creating and

managing XML files useful if you are using several i.LON 100s, and would like to use the

same configuration on each one. In that case, you could configure one of the i.LON 100s, copy

its XML files, and download them to the appropriate directories of the other i.LON 100s to

obtain the same configuration in all of them. For more information on how to download XML

configuration files, see Copying XML Files Between i.LON 100s on page 15-2.

1.2 Programming Samples

This document includes programming samples written in Microsoft Visual Basic .NET

illustrate concepts described in this manual. To make these samples more easily understood,

they have been simplified. Error checking has been removed, and in some cases, the

examples are only fragments that may not compile without errors or warnings.

1.3 Getting Started

You should review Chapter 2, SOAP Messages and the i.LON 100 WSDL File , before

proceeding to the rest of this document and learning about the functions and applications of

the SOAP/XML interface. Chapter 2 describes the WSDL file which defines the i.LON 100

SOAP/XML interface, and contains vital information you will need to know before

referencing the WSDL file and using the various functions of the SOAP/XML interface. The

final section of Chapter 2, Writing SOAP Applications, sets a roadmap you can follow when

reading through the rest of the document.

If you are upgrading to version 1.1 of the SOAP/XML interface, it is also recommended that

you review the next section, i.LON 100 Version 1.1 SOAP/XML Interface Upgrades, before

proceeding. This section outlines the changes that have been made to the SOAP/XML

interface for version 1.1.

1.4 i.LON 100 Version 1.1 SOAP/XML Interface Upgrades

This section provides an overview of the changes made to the SOAP/XML interface for

version 1.1, and includes the following sections:

• Modified SOAP Applications and Functions

• Changes to SOAP Message Formats

You may find these changes advantageous when using version 1.1 of the SOAP/XML

interface. You should also note that version 1.1 provides complete compatibility with version

i.LON 100 Internet Server Program1-2 mer’s Reference