beautypg.com

Declaring configuration properties – Echelon i.LON SmartServer 2.0 User Manual

Page 71

background image

i.LON SmartServer 2.0 Programming Tools User’s Guide

57

You must declare all the mandatory network variables in the UFPT you created for your FPM. You
may declare none to all of the optional network variables in the UFPT.

SYNTAX

You can declare a network variable in your model file using the following syntax:

network input || output type identifier;

The network keyword declares a network variable of a specific type with a specific identifier.

The input and output keywords define the direction of the network variable. The specified
direction must match the one defined for the referenced network variable in the UFPT.

The type property corresponds to the standard or user-defined network variable type (SNVT
or UNVT) used by the network variable. The specified data type must match the one defined
for the referenced network variable in the UFPT.

The identifier property is a reference to the network variable in the UFPT. The name
specified in this property is the one that will be used by network tools such as the SmartServer
and the LonMaker tool for the referenced network variable. The maximum length of the
identifier is 16 characters.

EXAMPLES

The follow example demonstrates how to create input and output network variables in your model
file:

network input SNVT_temp_f nviTemp;
network input SNVT_temp_f nviSetPoint;
network input SNVT_hvac_mode nviHVACMode;

network output SNVT_switch nvoAC_OnOff;
network output SNVT_switch nvoFurnace_OnOff;
network output SNVT_str_asc nvoStatus;

By convention, input network variable names have an nvi prefix, and output network variables
have an nvo prefix.

For more information on declaring network variables, see Chapter 3 of the Neuron C Programmer’s
Guide
.

Declaring Configuration Properties

A configuration property is a data item that specifies the behavior of the FPM application or driver (its
network variables and functional blocks). Configuration properties are used for configuration data
such as set points, alarm thresholds, or calibration factors. The configuration properties in an FPM can
be set by a network management tool such as the SmartServer or the LonMaker tool.

You must declare all the mandatory configuration properties in the UFPT you created for your FPM.
You may declare none to all of the optional configuration properties in the UFPT.

SYNTAX

The syntax used for configuration property declarations is similar to that used for network variable
declarations except that the direction modifier is always input, and it includes a config_prop or
cp keyword (you can use either keyword ) that follows the type declaration.

network input type cp name;
network input type config_prop name;

The network keyword declares a configuration property of a specific type with a specific
identifier.

The input keyword specifies that the configuration property is an input data point.