beautypg.com

Echelon i.LON SmartServer 2.0 User Manual

Page 257

background image

i.LON SmartServer 2.0 Programmer’s Reference

15-8



The Get function returns an element for each device referenced in the input parameters you
supplied to the function. The properties included within each element are initially defined
when the device is added to the SmartServer. You can write to these device properties with the Set
function. The following table describes these properties.

Property Description

The name of the Modbus device in the following format:
<network/channel/device>. You can rename a Modbus device
by providing its and specifying the new
property to which the Modbus device is to be
renamed.

The type of Modbus device (App by default) and its xsi type,
which is MOD_Device_Cfg. This determines the icon used to
represent the Modbus device in the SmartServer Web interface.

A flag indicating whether the Modbus device is hidden or shown
in the navigation pane on the left side of the SmartServer Web
interface. This property may have the following values:

0

– shown

1

– hidden

• This property only appears if the device has the following

exception: IS_OFFLINE. The device application is offline.

A timestamp indicating the last time the configuration of the
Modbus device was updated. This timestamp uses the ISO 8601
format, which is as follows:

YYYY-MM-DDTHH:MM:SS.sssZPhh:mm

The first segment of the time stamp (YYYY-MM-DD)
represents the date the configuration of the Data Point was last
updated. The second segment (after the T): HH:MM:SS.sss
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

A user-defined description of the Modbus device. This can be a
maximum of 201 characters long.