Echelon i.LON SmartServer 2.0 - Manual (Page 227)

i.LON SmartServer 2.0 Programming Tools User’s Guide 213
This method returns the UCPTname configuration property of the data point in the following
format: <network>/<channel>/<device>/<functional block>/<data point>. The UCPTname
configuration property is an array unsigned ASCII characters.
EXAMPLE
const char* nviSetPoint_name;
nviSetPoint_name =
nviSetPoint.GetDpPropertyAsString(FPM::Dp::cfgUCPTname);
printf ("nviSetPoint name = '%s' \n", nviSetPoint_name);
Note: Using this data point property method extensively may significantly impact the performance
of the SmartServer; therefore, it is recommended that you use it sparingly.
GetDpPropertyAsString(UCPTAliasName)
You can use the GetDpPropertyAsString(UCPTAliasName) method in the Work()and
OnTimer()
routines of an FPM application to read the alias name of the data point. This is
useful for getting the alias names of the external data points on the SmartServer.
SYNTAX
const char* GetDpPropertyAsString(FPM::Dp::AliasName)
This method returns the UCPTAliasName configuration property of the data point. This
configuration property is defined in the Alias Name property in the data point’s Configuration –
Data Point Web page on the SmartServer.
The alias name was the naming convention used for data points in the e3 release of the i.LON
software. The data points in the tree were organized by their alias names, which correspond to the
locations of the data points.
• The data points on the i.LON App (Internal) device under the LON channel have default alias
names that begin with the "NVL" prefix.
• The virtual data points on the i.LON System (Internal) device under the VirtCh channel have
default alias names that begin with the "iLON System" prefix. In the e3 release of the i.LON
software, these data points were referred to as "NVVs".
• The data points of the external devices connected to the SmartServer do not have default alias
names, and this property is initially disabled for these data points. In the e3 release of the
i.LON software, these data points were referred to as "NVEs".
EXAMPLE
FpmItemInfoColl_t::iterator itEnd = oRTCiLon.end();
for(FpmItemInfoColl_t::iterator it = oRTCiLon.begin();
it != itEnd; ++it)
{
CFpmItemInfo &v = (*it);
printf("UCPTaliasName: %s,
GetDpPropertyAsString(Dp::cfgUCPTaliasName));
}
Note: Using this data point property method extensively may significantly impact the performance
of the SmartServer; therefore, it is recommended that you use it sparingly.
GetDpPropertyAsTimeSpec(UCPTlastUpdate)
You can use the GetDpPropertyAsTimeSpec(UCPTlastUpdate) method in the
Work()
and OnTimer()routines of an FPM application to read the time at which the data point
was last updated.