Before parameters can be defined, the parameter types must be created.
·Select the application program, the Static or the ParameterTypes node
·Execute the Add New ParameterTypeXxx command from the context menu, where Xxx is one of:
·For ParameterTypeRestriction, then define the individual enumeration values by executing Add New enumeration value.
Some notes on the individual parameter types:
This parameter type is necessary for "Page parameters" in ETS3 application programs only.
The signed-ness and the width in bit can be set when adding the type or later edited in the properties window.
By the MinInclusive and MaxInclusive properties the allowed range of values can be further restricted.
Byte order: When preparing the device download image, the parameter values can be written in big-endian or little-endian byte order. For ETS4/ETS5, this can be set in Application Program/Static/Options, for ETS3 this is fixed to big-endian.
The allowed values of parameters of this type are from an explicit list, where each item is a pair of an unsigned integer value and a (translatable) text representation.
If the property Base is set to BinaryValue, in addition a binary value can be specified, which is used instead of the value when preparing the device download image.
The the maximum length in bit(!) can be set when adding the type or later edited in the properties window. This refers to the size of the string in the download image.
For ETS3, the text data is written in the ANSI code page of the system where ETS runs and padded with zero bytes up to the specified length if the text doe snot occupy the whole size.
For ETS4/ETS5, additional image creation options can be set in application program/Static/Options:
·the code page to use for the download image (TextParameterEncoding),
·a flag forcing a terminating 0 (TextParameterZeroTerminate); the maximum text length is one byte less than specified by SizeInBit in this case.
Also for ETS4/ETS5 only, a (.NET style) regular expression can be entered against which any user input is validated.
ParameterTypeFloat (ETS4/ETS5 only)
ETS4/ETS5 supports 3 encodings of floating point numbers in the device download image: the 2-byte DPT-9 format, and the 4 and 8 byte IEEE formats.
ParameterTypeTime (ETS4/ETS5 only)
ETS4/ETS5 supports entering times (both absolute and time spans) in different units and with different formats.
ParameterTypeDate (ETS4/ETS5 only)
ETS4/ETS5 only supports the 3-byte DPT-11 format.
ParameterTypeIPAddress (ETS4/ETS5 only)
ETS4/ETS5 supports IPv4 addresses and IPv4 net masks.
ParameterTypePicture (ETS4/ETS5 only)
Can be used to display pictures (JPG, PNG, BMP) in the parameter dialog.