Instruction Manual

i.LON 100 Internet Server Programmer’s Reference i
Table Of Contents
1 Introduction to the i.LON 100 SOAP/XML Interface.............................................. 1-1
1.1 About This Document .................................................................................................... 1-1
1.2 Programming Samples .................................................................................................. 1-2
1.3 Getting Started .............................................................................................................. 1-2
1.4 i.LON 100 Version 1.1 SOAP/XML Interface Upgrades.............................................. 1-2
1.4.1 Modified SOAP Applications and Functions............................................................ 1-3
1.4.2 Changes to SOAP Message Formats ........................................................................ 1-6
2 SOAP Messages and the i.LON 100 WSDL File........................................................ 2-1
2.1 i.LON 100 WSDL File.................................................................................................... 2-1
2.2 Security........................................................................................................................... 2-1
2.3 Formats of SOAP Messages .......................................................................................... 2-2
2.3.1 Input Messages .......................................................................................................... 2-2
2.3.1.1 SOAP Envelope ................................................................................................. 2-2
2.3.1.2 SOAP Body ........................................................................................................ 2-3
2.3.2 Response Message ..................................................................................................... 2-4
2.3.2.1 SOAP Header .................................................................................................... 2-4
2.3.2.2 <Result> Parameter.......................................................................................... 2-5
2.3.3 SOAP Error Responses.............................................................................................. 2-5
2.4 Writing SOAP Applications........................................................................................... 2-6
3 Monitoring and Controlling Data Points with the SOAP/XML Interface......... 3-1
3.1 Overview of Data Points ................................................................................................ 3-1
3.2 About This Chapter........................................................................................................ 3-2
3.3 DataPointWrite .............................................................................................................. 3-3
3.3.1 Data Point Values and Priority Levels..................................................................... 3-5
3.4 DataPointRead ............................................................................................................... 3-7
3.5 DataPointResetPriority ............................................................................................... 3-10
3.6 Using the DataPoint Functions With Visual Basic .NET ......................................... 3-11
3.6.1 DataPointWrite........................................................................................................ 3-11
3.6.2 DataPointRead......................................................................................................... 3-11
3.6.3 DataPointResetPriority........................................................................................... 3-11
3.6.4 Programming Samples ............................................................................................ 3-12
4 i.LON 100 Applications and the SOAP/XML Interface........................................... 4-1
4.1 Overview of i.LON 100 Applications............................................................................. 4-1
4.2 i.LON 100 XML Configuration Files............................................................................. 4-2
4.3 i.LON 100 SOAP Functions........................................................................................... 4-3
4.3.1 <Data> Parameter ..................................................................................................... 4-5
4.3.1.1 Encoded XML and Standard XML................................................................... 4-6
4.4 i.LON 100 Resource Files .............................................................................................. 4-8
4.4.1 LonMark Standard Network Variable Type (SNVT) Device Resource Files......... 4-8
4.4.2 Standard Configuration Property Type (SCPT) Device Resource Files................. 4-8
4.4.3 User Network Variable Type (UNVT) Device Resource Files ................................ 4-9
4.4.4 User Configuration Property Type (UCPT) Device Resource Files....................... 4-9
4.5 Data Formatting .......................................................................................................... 4-10
4.6 List, Get, Set and Delete Functions............................................................................ 4-11
4.6.1 List Functions .......................................................................................................... 4-11
4.6.2 Get Functions........................................................................................................... 4-11
4.6.3 Set Functions ........................................................................................................... 4-11
4.6.4 Delete Functions ...................................................................................................... 4-12
4.7 Performance Issues ...................................................................................................... 4-13