Echelon i.LON SmartServer Technical Information Page 289

  • Download
  • Add to my manuals
  • Print
  • Page
    / 443
  • Table of contents
  • BOOKMARKS
  • Rated. / 5. Based on customer reviews
Page view 288
i.LON SmartServer 2.0 Programmer’s Reference
17-6
Property Description
represents the time of day the configuration of the Data Point
was last updated, in UTC (Coordinated Universal Time).
UTC is the current term for what was commonly referred to as
Greenwich Meridian Time (GMT). Zero (0) hours UTC is
midnight in Greenwich England, which lies on the zero
longitudinal meridian. Universal time is based on a 24 hour
clock; therefore, an afternoon hour such as 4 pm UTC would be
expressed as 16:00 UTC. The Z appended to the timestamp
indicates that it is in UTC. It can be left out.
For example, 2002-08-15T10:13:13Z indicates a UTC time of
10:13:13 AM on August 15, 2002.
If it is not UTC, time shift has to be defined:
2008-02-28T09:59:53.660+01:00
<UCPTdescription>
A user-defined description of the Virtual device. This can be a
maximum of 201 characters long.
<UCPTuri>
The name of the file on the SmartServer flash disk containing
the configuration of the Virtual device. This property is always
Virtual_Device_Cfg.htm.
<UCPThandle>
The handle assigned to the Virtual device assigned by the
SmartServer. When you use the Set function to modify the
configuration of an existing Virtual device, you must specify the
device’s handle. If you do not specify the handle, a new Virtual
device is created. You cannot use the Set function to modify
the handle assigned to the Virtual device.
<UCPTprogramId>
The program ID of the Virtual device as a set of hex digits.
17.2.3
Using the Set Function on Virtual Devices
You can use the Set function to overwrite the configuration of a Virtual device, or to create a new
Virtual device. The input parameters you supply to the function will include one or more <Item>
elements. Each <Item> element includes a <UCPTname> property that specifies a unique Virtual
device to be created or modified.
Each <Item> element may also include a series of properties that define the configuration of the new
(or modified) Virtual device. This set of properties is the same whether you are creating a new Virtual
device or modifying an existing Virtual device.
If you are modifying an existing Virtual device, you must specify the <UCPThandle> property. In
addition, all other properties should be filled; otherwise the values stored in them are erased. The
previous section,
Using the Get Function on Virtual Devices, details the properties you can
include in the Set function.
You can set multiple Virtual devices with a single Set message. However, you should not attempt to
create or write to more than 100 Virtual devices with a single call to the Set function. The following
example demonstrates how to create a new Virtual device.
Request (create a new Virtual device on the SmartServer)
<Set xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<Item xsi:type="Virtual_Device_Cfg">
Page view 288
1 2 ... 284 285 286 287 288 289 290 291 292 293 294 ... 442 443

Comments to this Manuals

No comments