beautypg.com

Declaring a configuration network variable, Defining a device property list, Declaring a – Echelon FTXL User Manual

Page 155: Configuration network variable, Ge 143 to

background image

FTXL User’s Guide

143

The compiler uses the first rule in this list that applies to the configuration

property.

These initialization rules are used to set the initial value that are loaded in the

value file from the linked image, as well as the value file stored in the device

interface file. A network management tool can use the initial value as a default
value, and might at times reset the configuration properties (or a subset of them)

back to the default values. Consult the documentation of the particular network
management tool, for example, the

LonMaker User's Guide

, for more information

on the use of configuration property default values.

Declaring a Configuration Network Variable

The configuration network variable declaration syntax is similar to the
declaration syntax of a non-configuration network variable.
The declaration of a configuration network variable is distinct from other

network variable declarations by the inclusion of the config_prop keyword
following the type of the network variable declaration. The config_prop keyword

can be abbreviated as cp.
The syntax for declaring a configuration network variable is:

network input [

netvar-modifier

] [

storage-class

]

type

config_prop [

cp-modifiers

]

[

connection-info

]

identifier

[ [

array-bound

] ]

[

=

initial-value

] ;

The

netvar-modifier

,

storage-class

,

connection-info

,

array-bound

, and

initial-

value

portions of this syntax are described in

Network Variable Syntax

on page

132, and they apply equally to a configuration network variable as they do to any

other network variable.

Similar to the configuration CP family members, configuration network variables

must be declared with a

type

that is defined by a standard configuration property

type (SCPT) or a user configuration property type (UCPT) defined within a
resource file.
The

cp-modifiers

clause that can optionally follow the config_prop keyword is

described in

The Configuration Property Modifiers

on page 140.

Example:

network input SCPTupdateRate config_prop nciUpdateRate;

network input SCPTbypassTime cp nciBypassTime = ...

Defining a Device Property List

A device property list declares instances of configuration properties defined by

CP family declarations and configuration network variables declarations that

apply to a device.