Echelon i.LON 100 e2 Internet Server Manuel d'utilisateur

i.LON™ 100 e2 Internet Server Programmer’s Reference Version 1.1 @echelon® C o r p o r a t i o n 078-0250-01B

i.LON 100 Internet Server Programmer’s Reference 1-5 Function Description of Change For More Information, See… DataServerRead In version 1.0 of

i.LON 100 Internet Server Programmer’s Reference 7-11 Property Description <SCPThystHigh1> <SCPThystHigh2> <SCPThystLow1> <S

i.LON 100 Internet Server Programmer’s Reference Identifier Notes PR_10 HVAC Critical Equipment RTN, Fire RTN (Display) PR_16 HVAC RTN (lowest pri

i.LON 100 Internet Server Programmer’s Reference 7-13 You can make inequality comparisons between SNVT_switch (BT_STRUCT) data points, or betwee

Table 28 Alarm Generator Hysteresis Levels Offset Limit Causing Alarm Alarm Cleared When... <UCPThighLimit1Offset> Input Value<=Comp Value+

The following diagram depicts the four different alarm conditions, as well as the corresponding hysteresis levels that must be reached to clear the al

7.2.1.3 AlarmGeneratorSet You can use the AlarmGeneratorSet function to create a new Alarm Generator, or to overwrite the configuration of an existing

i.LON 100 Internet Server Programmer’s Reference 7-17 <SCPThystHigh1>50.00</SCPThystHigh1> <SCPThystHigh2>75.00</SCPThystHig

i.LON 100 Internet Server Programmer’s Reference 8-1 8 Alarm Notifier Use the Alarm Notifier application to log user-defined alarm conditons, and

Auto-Generated Log Files Each Alarm Notifier will generate its own log file. It will add an entry to this log file each time it generates an alarm not

i.LON 100 Internet Server Programmer’s Reference 8-3 <Point> <UCPTindex>0</UCPTindex> <UCPTpointName>NVL_nvoLev

1.4.2 Changes to SOAP Message Formats The SOAP body that must be included in every message sent to the i.LON 100, and in every output message returne

8.2 Creating and Modifying the AlarmNotifier.XML File You can create and manage the AlarmNotifier.XML file with the AlarmNotifierSet SOAP function. T

i.LON 100 Internet Server Programmer’s Reference 8-5 8.2.1.1 AlarmNotifierList Use the AlarmNotifierList function to retrieve a list of the Alarm

8.2.1.2 AlarmNotifierGet You can use the AlarmNotifierGet function to return the configuration of any Alarm Notifier that you have added to the i.LON

i.LON 100 Internet Server Programmer’s Reference 8-7 <UCPTpasAlarmType>AL_NO_CONDITION</UCPTpasAlarmType> <UCP

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTindex> The index number assigned to the Alarm Notifier must be in th

i.LON 100 Internet Server Programmer’s Reference 8-9 Property Description <UCPThistLogSize> The size of the historical alarm log file, in k

i.LON 100 Internet Server Programmer’s Reference Property Description <ActiveAlarm> If the input data point is updated and matches the conditio

i.LON 100 Internet Server Programmer’s Reference 8-11 Table 32 Input Data Point Properties Property Description <UCPTindex> The index numb

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTalarmFlags> This field is a series of seven Boolean values (0,1) sep

i.LON 100 Internet Server Programmer’s Reference 8-13 Property Description <UCPTalarmGroup> The group number for alarm notifications caused

i.LON 100 Internet Server Programmer’s Reference 2-1 2 SOAP Messages and the i.LON 100 WSDL File This chapter contains general information about

i.LON 100 Internet Server Programmer’s Reference Property Description The path can be a maximum of 1024 characters long. Table 34 lists the macro ar

i.LON 100 Internet Server Programmer’s Reference 8-15 Macro Argument Description %tm The minute that the alarm occurred. %ts The second that t

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTlevel> Enter an alarm level for the condition set, in the range 0-25

i.LON 100 Internet Server Programmer’s Reference 8-17 Every <AlarmDest> should contain one or more <ActiveDest> and <PassiveDest&g

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTnackDelay> The delay, in minutes, to wait for an alarm to be acknowl

i.LON 100 Internet Server Programmer’s Reference 8-19 8.2.1.3 AlarmNotifierSet Use the AlarmNotifierSet function to create new Alarm Notifiers, o

<UCPTlevel>1</UCPTlevel> <UCPTalarmText>Log 30 percent full</UCPTalarmText> <UCPTactAlarmType>AL

i.LON 100 Internet Server Programmer’s Reference 8-21 Table 37 AlarmNotifierRead Input Properties Parameter Description <UCPTpointName> En

Parameter Description <UCPTstart> Use these fields to specify a range for the log time of the entries that will be returned by the function. You

i.LON 100 Internet Server Programmer’s Reference 8-23 <Data> <iLONAlarmNotifier> <Data> Parameter <AlarmLog&g

authenticate access to Web pages that send or receive multiple SOAP messages. If a SOAP message is sent to the i.LON 100 that does not contain the cor

Properties Description <UCPTfileName> The name of the log file the Alarm Notifier is using. <UCPTstop> When reading the Alarm History Log,

i.LON 100 Internet Server Programmer’s Reference 8-25 Property Description <UCPTlogSourceAddress> The network address of the device the dat

Property Description <UCPTalarmStatus> The status of the alarm. This can be AUTO_ACK or MANUAL_ACK for an acknowlegded alarm that has not been r

i.LON 100 Internet Server Programmer’s Reference 8-27 Property Description <UCPTalarmStatus> You can select one of four parameters to chang

Table 41 AlarmNotifierWrite Output Properties Property Description <UCPTindex> <UCPTalarmLog> The type of log file affected by the functi

i.LON 100 Internet Server Programmer’s Reference 8-29 8.2.1.6 AlarmNotifierClear Use the AlarmNotifierClear function to clear a group of log entr

<Data> Parameter <Data> <iLONAlarmNotifier> <AlarmLog> <UCPTindex>0</UCPTindex> <UCPTpointN NVL_nviB

i.LON 100 Internet Server Programmer’s Reference 8-31 8.2.1.7 AlarmNotifierDelete You can use the AlarmNotifierDelete function to delete an Alarm

i.LON 100 Internet Server Programmer’s Reference 9-1 9 Analog Function Block You can use Analog Function Blocks to perform a variety of statisti

<SCPTobjMinVer>1</SCPTobjMinVer> nalogFB> <A <UCPTindex>0</UCPTindex> <UCPTlastUpdate>2002-06-02T09:16

i.LON 100 Internet Server Programmer’s Reference 2-3 http://www.w3.org/TR/2000/NOTE-SOAP-20000508/ The SOAP envelope portion of the sample input

i.LON 100 Internet Server Programmer’s Reference 9-3 9.2 Creating and Modifying the AnalogFB.XML File You can create and modify the AnalogFB.XML

9.2.1.1 AnalogFBList Use the AnalogFBList function to retrieve a list of the Analog Function Blocks that you have added to the i.LON 100. The AnalogFB

i.LON 100 Internet Server Programmer’s Reference 9-5 9.2.1.2 AnalogFBGet You can use the AnalogFBGet function to retrieve the configuration of an

The function returns an <AnalogFB> element for each Analog Function Block referenced in the <Data> parameter you supplied to the function

i.LON 100 Internet Server Programmer’s Reference 9-7 Property Description <UCPTcompFunction> This property defines the comparison function

Property Description <UCPTcalculationInterval> The delay, in seconds (0.0 to 6553.0), that must elapse between updates to the Analog Function Bl

i.LON 100 Internet Server Programmer’s Reference 9-9 Property Description <Point> You can specify as many input data points as you want per

Property Description <OutputDataPoint> This element defines the output data point for this function block. You must specify the <UCPTpointNa

i.LON 100 Internet Server Programmer’s Reference 9-11 Identifier Value Assigned To The Output Data Point FN_NUL Value not available. 9.2.1.2.2 Co

Table 48 FN_AND Examples Input 1 Input 2 Input 3 Input 4 Value of Compare Data Point UCPTtrueThreshold Output 9 11 12 13 10 0.0 0 Does not matter s

document includes a sample XML string you could supply as the <Data> parameter, and a description of how to build the XML string. However, there

i.LON 100 Internet Server Programmer’s Reference 9-13 property if it is defined, for this to happen. If the <UCPTtrueThreshold> is defined

9.2.1.3 AnalogFBSet Use the AnalogFBSet function to create new Analog Function Blocks, or to overwrite the configuration of existing Analog Function B

i.LON 100 Internet Server Programmer’s Reference 9-15 </CompareDataPoint> <OutputDataPoint> <UCPTfieldName>value</

i.LON 100 Internet Server Programmer’s Reference 10-1 10 Event Scheduler You can use the Event Scheduler application to schedule periodic updates

After a restart, the Event Scheduler recalculates the last Event Scheduler operation. It also sets the data point NVL_nvoDateResync to “100.0 1”, and

i.LON 100 Internet Server Programmer’s Reference 10-3 <UCPTweekdays>1,0,0,0,0,0,1</UCPTweekdays> <DayTimeVal> <UC

10.2 Creating and Modifying the EventScheduler.XML File You can create and modify the EventScheduler.XML file with the EventSchedulerSet SOAP function

i.LON 100 Internet Server Programmer’s Reference 10-5 10.2.1.1 EventSchedulerList Use the EventSchedulerList function to retrieve a list of the E

10.2.1.2 EventSchedulerGet You can use the EventSchedulerGet function to return the configuration of any Event Scheduler that you have added to the i.

i.LON 100 Internet Server Programmer’s Reference 10-7 </DateTimeVal> </DayBased> <DateBased> <UC

i.LON 100 Internet Server Programmer’s Reference 2-5 standards mentioned in the previous section. Every element in a SOAP Header, and all immedi

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTlastUpdate> A timestamp indicating the last time the configuration o

i.LON 100 Internet Server Programmer’s Reference 10-9 Property Description <Point> The data points that will be updated by the Event Schedu

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTpriority> The priority assigned to the schedule, from 0 (highest pri

i.LON 100 Internet Server Programmer’s Reference 10-11 <UCPTscheduleValue>ON</UCPTscheduleValue> <UCPTscheduleTime>03:40<

i.LON 100 Internet Server Programmer’s Reference Property Description <DateTimeVal> The update events for each date-based schedule are signifie

i.LON 100 Internet Server Programmer’s Reference 10-13 10.2.1.3 EventSchedulerSet You can use the EventSchedulerSet function to create new Event

<UCPTpriority>240</UCPTpriority> <UCPTweekdays>1,0,0,0,0,0,1</UCPTweekdays> <DayTimeVal> <UCP

i.LON 100 Internet Server Programmer’s Reference 10-15 10.2.1.4 EventSchedulerDelete You can use the EventSchedulerDelete function to delete an E

i.LON 100 Internet Server Programmer’s Reference 11-1 11 Event Calendar Use the Event Calendar application to define the exception points that yo

<Calendar> <UCPTindex>0</UCPTindex> <UCPTlastUpdate>2002-06-26T10:44:27Z</UCPTlastUpdate> <UCPTdescription

i.LON 100 Internet Server Programmer’s Reference Error Code Error Message 0 No Error 1 Unknown function call. 2 Parameter error. For example, the

i.LON 100 Internet Server Programmer’s Reference 11-3 XML Configuration File11.2 Creating and Modifying the EventCalendar.XML File You can create

11.2.1.1 EventCalendarList Use the EventCalendarList function to retrieve a list of the Event Calendars that you have added to the i.LON 100. The Even

i.LON 100 Internet Server Programmer’s Reference 11-5 11.2.1.2 EventCalendarGet You can use the EventCalendarGet function to return the configura

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTlastUpdate> A timestamp indicating the last time the configuration o

i.LON 100 Internet Server Programmer’s Reference 11-7 11.2.1.2.1 Creating an Exception Point The exception points for an Event Calendar are defi

Table 58 DAY_T Identifiers Identifier Description DY_LAST_DAY_OF_MONTH Last day of month DY_LAST_SECOND_DAY Second-to-last day of the month. DY_LAS

i.LON 100 Internet Server Programmer’s Reference 11-9 Identifier Description DY_FOURTH_FRI Fourth Friday of each month DY_FOURTH_SAT Fourth Sat

Table 59 MONTH_T Identifiers Identifier Description MN_JAN January MN_FEB February MN_MAR March MN_APR April MN_MAY May MN_JUN June MN_JUL July MN_AU

i.LON 100 Internet Server Programmer’s Reference 11-11 The following string would set up an exception that occurs every day from 2000/2/28 until

11.2.1.3 EventCalendarSet i.LON 100 Internet Server Programmer’s Reference EventCalendarGet <UCPTtemporary>0</UCPTtemporary>

i.LON 100 Internet Server Programmer’s Reference 3-1 3 Monitoring and Controlling Data Points with the SOAP/XML Interface Any i.LON 100 user can

i.LON 100 Internet Server Programmer’s Reference 11-13 11.2.1.4 EventCalendarDelete You can use the EventCalendarDelete function to delete an Ev

i.LON 100 Internet Server Programmer’s Reference 12-1 13-112 Type Translator You can use Type Translators to convert data points from one network

<?xml version="1.0" ?> <iLONTypeTranslator> <SCPTobjMajVer>1</SCPTobjMajVer> <SCPTobjMinVer>1</SCPT

i.LON 100 Internet Server Programmer’s Reference 12-3 XML Configuration FileThe SOAP interface for the Type Translator application includes four

i.LON 100 Internet Server Programmer’s Reference 12.2.1.1 TypeTranslatorList Use the TypeTranslatorList function to retrieve a list of the Type Trans

i.LON 100 Internet Server Programmer’s Reference 12-5 12.2.1.2 TypeTranslatorGet You can use the TypeTranslatorGet function to retrieve the confi

Table 61 TypeTranslatorGet Output Properties Property Description <UCPTindex> The index number assigned to the Type Translator must be in the r

i.LON 100 Internet Server Programmer’s Reference 12-7 Property Description <SCPTdelayTime> This property specifies the time period to wait

The 16 SNVT_switch data points to be translated are defined by a list of <InDataPoint> elements. Each element must contain two properties: <U

i.LON 100 Internet Server Programmer’s Reference 12-9 Table 63 SNVT_lev_disc_TO_SNVT_switch If the Input SNVT_lev_disc Data Point Is... Then

point. This property is updated by the Data Server in real time, and can be read or written to with the functions described in this chapter. 3.2 Abou

i.LON 100 Internet Server Programmer’s Reference If the SNVT_scene Input Field Values Are…. Then the SNVT_setting Output Field Values Are…. function

i.LON 100 Internet Server Programmer’s Reference 12-11 SET_STATE >100.0 0xFF 0 SET_STATE <=100.0 (setting value) 0 SET_NUL N/A 0xFF 0 12.

12.2.1.3 TypeTranslatorSet You can use the TypeTranslatorSet function to create new Type Translators, or to overwrite the configuration of existing Ty

i.LON 100 Internet Server Programmer’s Reference 12-13 <Result> Parameter <Result> <iLONTypeTranslator> <TypeTranslato

i.LON 100 Internet Server Programmer’s Reference 13-1 pe Translator13 Type Translator Rules You can use the Type Translator Rule SOAP functions t

<UCPTdescription>Test</UCPTdescription> <UCPTtranslatorRule>2xSwitch_to_Switch</UCPTtranslatorRule> <InDataPoint>

i.LON 100 Internet Server Programmer’s Reference 13-3 pe Translator Rule SOAP Interface13.2 Creating and Modifying the Type Translator Rule XML F

13.2.1.1 TypeTranslatorRuleList Use the TypeTranslatorRuleList function to retrieve a list of the Type Translator Rules that you have added to the i.L

i.LON 100 Internet Server Programmer’s Reference 13-5 </iLONTypeTranslatorRule> 13.2.1.2 TypeTranslatorRuleGet You can use the TypeTrans

Table 70 TypeTranslatorRuleGet Properties Property Description The index number assigned to the Type Translator Rule must be in the range 0-32,767. A

Echelon, LON, LONWORKS, NodeBuilder, LonTalk, Neuron, LONMARK, LNS, LonBuilder, LonUsers, BeAtHome, LonManager, 3120, 3150, LonPoint, Digital Home, LO

i.LON 100 Internet Server Programmer’s Reference 3-3 3.3 DataPointWrite You can use the DataPointWrite function to write to the value of any data

i.LON 100 Internet Server Programmer’s Reference 13-7 Property Description <InDataPoint> You can define the network variable types a Type T

If the result of the operation is True, each of the case rules defined for the case structure will be used. If the result is False, the case rules wi

i.LON 100 Internet Server Programmer’s Reference 13-9 Identifier Description FN_LT Less than. Returns True if the value of the input data point i

Property Description <UCPTindexIn> The index number of the input data point you want the case rule to use, as defined within the <InDataPoint

i.LON 100 Internet Server Programmer’s Reference 13-11 Property Description <UCPTmultiplier> If the output data point, or data point field,

13.2.1.3 TypeTranslatorRuleSet i.LON 100 Internet Server Programmer’s Reference The following example uses the TypeTranslatorRuleSet function to cre

i.LON 100 Internet Server Programmer’s Reference 13-13 <UCPTmultiplier>0</UCPTmultiplier> <UCPTconstant&

i.LON 100 Internet Server Programmer’s Reference 13.2.1.4 TypeTranslatorRuleDelete You can use the TypeTranslatorRuleDelete function to delete a Typ

14 Using the SOAP Interface as a Web Service i.LON 100 Internet Server Programi.LON 100 SOAP interface. mer’s Reference 14-1 This chapter assumes

[ilon 100 ipaddress] represents the IP address assigned to the i.LON 100 you want the application to reference. 5. Press Enter to download the web r

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTpointName> Enter the <UCPTpointName> of the data point to be w

i.LON 100 Internet Server Programmer’s Reference 14-3 14.2 Programming Samples This section contains programming samples written in Visual Basic

myXMLReturnString = myWebReference.DataServerRead(myXMLInputString) 14.2.2 Using an XMLDocument Object Visual Basic .NET provides several fea

i.LON 100 Internet Server Programmer’s Reference 14-5 'the string to be retrieved and manipulated. Load the <Result> 'parameter

myXmlNodeList = myXML.SelectNodes("/iLONDataServer/NVL") myXmlNode = myXmlNodeList.Item(NV_INDEX) Const UCPTindex As Integer = 0 If myXmlNo

i.LON 100 Internet Server Programmer’s Reference 14-7 s = s & units.Current.Value() & "', '" Dim statuses As Sy

The DataSet is a relational structure that can be easily traversed and manipulated when you parse the XML string retrieved by the function. You can us

i.LON 100 Internet Server Programmer’s Reference 14-9 <xs:sequence> </xs:element> </xs:sequence> <

A, the parent element, represents the DataSet Name. B represents the Table Name. This must match the name of the child element below the <Data>

i.LON 100 Internet Server Programmer’s Reference 14-11 rapping Elements .UCPTstartIndex = 5001 .UCPTcount = 3 End

i.LON 100 Internet Server Programmer’s Reference myDataRow_DpNVL = myDataTable_DpNVL.Rows(0) 'Get the first and only DpNVL returned. Al

i.LON 100 Internet Server Programmer’s Reference 3-5 Property Description <UCPTpropagate> 0 or 1. If you assign the default value 1 to the

i.LON 100 Internet Server Programi.LON 100: mer’s Reference 15-1 The following procedure describes how to create an XML file, and add it to the c

3. Open the XML file you want to modify using Microsoft XML Notepad or any other text editor. Modify the XML file as you like, but be sure that the fo

i.LON 100 Internet Server Programmer’s Reference Index A Index acknowledging alarms, 8-26 Alarm Generators creating Alarm Generators, 7-16 deleti

i.LON 100 Internet Server Programmer’s Reference R E encoded XML, 4-6 Event Calendars creating exception points, 11-12 deleting exception points, 11-

i.LON 100 Internet Server Programmer’s Reference Event Priority Level Assigned Result of Operation Custom Application Invokes DataPointResetPriority

i.LON 100 Internet Server Programmer’s Reference 3-7 3.4 DataPointRead You can use the DataPointRead function to retrieve the current value assig

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTpointName> Enter the <UCPTpointName> of the data point to be w

i.LON 100 Internet Server Programmer’s Reference 3-9 Property Description <UCPTvalueDef> The value definition being used by the data point.

3.5 DataPointResetPriority You can use the DataPointResetPriority function to reset the priority level of a data point to 255, the lowest priority lev

i.LON 100 Internet Server Programmer’s Reference 3-11 3.6 Using the DataPoint Functions With Visual Basic .NET You can call the DataPoint functi

Input Parameters For descriptions of the input parameters that you must supply to the function, see DataPointResetPriority on page 3-10. Returns: The

i.LON 100 Internet Server Programmer’s Reference i Table Of Contents 1 Introduction to the i.LON 100 SOAP/XML Interface...

i.LON 100 Internet Server Programmer’s Reference 3-13 'Call DataPointWrite, and then call DataPointResetPriority. Note 'that the priori

i.LON 100 Internet Server Programmer’s Reference 4-1 4 i.LON 100 Applications and the SOAP/XML Interface This chapter provides an overview of th

triggered them. Alarms can be configured to shut off automatically when certain conditions are met, or they can be configured to require manual clear

i.LON 100 Internet Server Programmer’s Reference 4-3 As an alternative to using SOAP, you can modify the files manually using an ASCII-text or XM

i.LON 100 Internet Server Programmer’s Reference Function Names Description DataloggerList DataloggerGet DataloggerSet DataLoggerRead DataLoggerClea

i.LON 100 Internet Server Programmer’s Reference 4-5 Function Names Description EventSchedulerList EventSchedulerGet EventSchedulerSet EventSche

This input is a string of encoded XML containing a list of objects, or the desired settings of any number of the configuration properties associated w

i.LON 100 Internet Server Programmer’s Reference 4-7 • & character is replaced by &amp; For both the <Data> and <Result> par

4.4 i.LON 100 Resource Files There are many configuration properties you can configure using the SOAP functions described in this document. This docu

i.LON 100 Internet Server Programmer’s Reference 4-9 directory /root/lonworks/types, and are named STANDARD.ENU, STANDARD.TYP, STANDARD.FMT and S

4.8 Getting Started ... 4-14 5 Data Server.

4.5 Data Formatting In order to keep the i.LON SOAP/XML interface neutral across regions, most of the rules for formatting data, which would normally

i.LON 100 Internet Server Programmer’s Reference 4-11 4.6 List, Get, Set and Delete Functions The SOAP interface for each i.LON 100 application

After its initial invocation, you can use the AlarmGeneratorSet function to overwrite the values of the global properties defined for the Alarm Genera

i.LON 100 Internet Server Programmer’s Reference 4-13 4.7 Performance Issues The i.LON 100 contains 32 MB of RAM, which allows for complicated ap

4.8 Getting Started Chapters 5-13 of this document provide more detailed information on the various applications of the i.LON 100, and describe the SO

i.LON 100 Internet Server Programmer’s Reference 5-1 5 Data Server The i.LON 100 uses the concept of a data point to map logical names to i.LON 1

i.LON 100Data Serveri.LON 100 Applications:Alarm NotifierAlarm GeneratorData LoggerAnalog Function BlockEvent SchedulerEvent CalendarType TranslatorW

i.LON 100 Internet Server Programmer’s Reference 5-3 notified each time the data point is updated. In this fashion, each application has current

5.1 Data Server XML Files The /root/config/software/dataserver directory of your i.LON 100 contains several XML files that will store the configurati

i.LON 100 Internet Server Programmer’s Reference 5-5 5.1.1 DP_NVL.XML The DP_NVL.XML file is created automatically the first time the i.LON 100 b

i.LON 100 Internet Server Programmer’s Reference iii 9.2.1.4 AnalogFBDelete ...

<NVL> <UCPTindex>2</UCPTindex> <UCPTpointName>NVL_nvoDlClear</UCPTpointName> <UCPTlocation>iLON</UCPTlocat

i.LON 100 Internet Server Programmer’s Reference 5-7 5.1.2 DP_NVC.XML The DP_NVC.XML file contains a list of <NVC> elements, one for each N

5.2 Creating and Modifying the Data Server XML Files The i.LON 100 generates all of the Data Server configuration files the first time it boots. The

i.LON 100 Internet Server Programmer’s Reference 5-9 Function Description DataServerResetPriority Use this function to reset the priority level

5.2.1.1 DataServerList Use the DataServerList function to retrieve a list of data points that you have added to the i.LON 100 Data Server. The Data Se

i.LON 100 Internet Server Programmer’s Reference 5-11 The interval resets each time the value of a data point is retrieved. By default this value

5.2.1.2 DataServerGet You can use the DataServerGet function to retrieve the configuration of any data point that you have added to the i.LON 100 Data

i.LON 100 Internet Server Programmer’s Reference 5-13 <UCPTdirection>DIR_OUT</UCPTdirection> <UCPTvalueDef> <O

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTformatDescription> The format description of the data point. This de

i.LON 100 Internet Server Programmer’s Reference 5-15 Property Description <SCPTminSendTime> This property applies to output data points, a

i.LON 100 Internet Server Programmer’s Reference 1-1 1 Introduction to the i.LON 100 SOAP/XML Interface The i.LON 100 contains a powerful microp

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTmaxValue> Optional. This value is initially taken from the i.LON 100

i.LON 100 Internet Server Programmer’s Reference 5-17 5.2.1.3 DataServerSet Use the DataServerSet function to overwrite the configuration of an N

<Data> Parameter <Data> <iLONDataServer> <NVL> <UCPTindex>200</UCPTindex> <UCPTpointName

i.LON 100 Internet Server Programmer’s Reference 5-19 5.2.1.4 DataServerRead You can use the DataServerRead function to read the value and status

<Data> Parameter <Data> <iLONDataServer> <UCPTlifeTime> </UCPTlifeTime> <NVC> <UCPTindex>0</UCPTinde

i.LON 100 Internet Server Programmer’s Reference 5-21 5.2.1.4.2 Requesting Data Points by Type and Last Update Time You can also reference the d

<Data> Parameter <Data> <iLONDataServer> <UCPTlifeTime> </UCPTlifeTime> <UCPTdataPointType>NVL<

i.LON 100 Internet Server Programmer’s Reference 5-23 Property Description <UCPTfieldName> If the value of a field was requested in the <

5.2.1.5 DataServerWrite A data point's value and priority level are initially set when the data point is added to the Data Server. The value is s

i.LON 100 Internet Server Programmer’s Reference 5-25 <Result> Parameter <Result> <iLONDataServer> <NVL> <U

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 config

<SOAP-ENV:detail> of Fault Response Message <SOAP-ENV:detail> <iLONDataServer/> <AoDP/> <DP/> &l

i.LON 100 Internet Server Programmer’s Reference 5-27 5.2.1.6 DataServerResetPriority You can use the DataServerResetPriority function to reset t

5.2.1.7 DataServerDelete You can use the DataServerDelete function to remove a data point from the Data Server. Each NVL data point to be deleted must

i.LON 100 Internet Server Programmer’s Reference 6-1 6 Data Loggers You can use Data Loggers to monitor activity on your network. Each Data Logge

<?xml version="1.0" ?> LONDataLogger> <i <SCPTobjMajVer>1</SCPTobjMajVer> <SCPTobjMinVer>1</SCPTobj

i.LON 100 Internet Server Programmer’s Reference 6-3 </Point> <Point> <UCPTindex>1</UCPTindex> <UCPTp

6.2 Creating and Modifying the DataLogger.XML File You can create and modify the DataLogger.XML file with the DataLoggerSet SOAP function. The follow

i.LON 100 Internet Server Programmer’s Reference 6-5 6.2.1.1 DataLoggerList Use the DataLoggerList function to retrieve a list of the Data Logger

6.2.1.2 DataLoggerGet You can use the DataLoggerGet function to retrieve the configuration of any Data Logger that you have added to the i.LON 100. Yo

i.LON 100 Internet Server Programmer’s Reference 6-7 Property Description <UCPTindex> The index number assigned to the Data Logger must be

i.LON 100 Internet Server Programmer’s Reference 1-3 1.0 of the SOAP/XML interface. An i.LON 100 using version 1.1 software will accept and respo

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTlogLevelAlarm> Enter a value between 0.0 and 100.0. The default valu

i.LON 100 Internet Server Programmer’s Reference 6-9 Property Description <UCPTlogMinDeltaValue> This property applies to scalar data point

6.2.1.3 DataLoggerSet Use the DataLoggerSet function to create new Data Loggers, or to overwrite the configuration of existing Data Loggers. The Data

i.LON 100 Internet Server Programmer’s Reference 6-11 6.2.1.4 DataLoggerRead Use the DataLoggerRead function to retrieve the entries in the log f

6.2.1.4.1 Local Times and Coordinated Universal Time The timestamps for the <UCPTstart> and <UCPTstop> properties conform to the ISO 8601

i.LON 100 Internet Server Programmer’s Reference 6-13 <Result> Parameter <Result> <iLONDataLogger> <Log> <UCPTin

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTlastEvent> This property contains a timestamp indicating the last ti

i.LON 100 Internet Server Programmer’s Reference 6-15 6.2.1.5 DataLoggerClear You can use the DataLoggerClear function to remove log entries from

<Data> Parameter <Data> <iLONDataLogger> <Log> <UCPTindex>2</UCPTindex> <UCPTpointNam

i.LON 100 Internet Server Programmer’s Reference 6-17 6.2.1.6 DataLoggerDelete You can use the DataLoggerDelete function to delete a Data Logger.

i.LON 100 Internet Server Programmer’s Reference Function Description of Change For More Information, See… AlarmGeneratorGet The i.LON 100 has been

i.LON 100 Internet Server Programmer’s Reference 7-1 7 Alarm Generator Use the Alarm Generator application to generate alarms based on the values

7.1 AlarmGenerator.XML i.LON 100 Internet Server ProgramThe AlarmGenerator.XML file stores the configuration of the Alarm Generators that you have add

i.LON 100 Internet Server Programmer’s Reference 7-3 7.2 Creating and Modifying the AlarmGenerator.XML File You can create and modify the AlarmG

7.2.1.1 AlarmGeneratorList Use the AlarmGeneratorList function to retrieve a list of the Alarm Generators that you have added to the i.LON 100. The Al

i.LON 100 Internet Server Programmer’s Reference 7-5 7.2.1.2 AlarmGeneratorGet You can use the AlarmGeneratorGet function to retrieve the configu

<Alarm> element are initially defined when you create the Alarm Generator. You can write to them with the AlarmGeneratorSet function. Table 22 d

i.LON 100 Internet Server Programmer’s Reference 7-7 Property Description <UCPTalarmPriority> Specifies the alarm priority that will be rep

i.LON 100 Internet Server Programmer’s Reference Property Description <InputDataPoint> The input data point for this Alarm Generator. The data

i.LON 100 Internet Server Programmer’s Reference 7-9 Property Description <AlarmDataPoint> <Alarm2DataPoint> Optional. These properti

i.LON 100 Internet Server Programmer’s Reference Property Description <UCPTalarmClrTime> Specifies the time period to wait after the condition