Echelon LNS DDE Server User Manual

Page 75

Advertising
background image

Format command. Once the extended form is assigned to the network variable, the

DDE client application does not need to specify the format type in the item name.

To override the default format, use the –t parameter described in the previous

section. You may either specify a standard format, or specify a user format from the

format file described in Appendix A, Resource Files, using the following syntax:

#<program id>[<selector>].<format name>

The fields are defined as follows:


program id

The program ID specified in the format file, in hex, without
spaces or colons. This does not have to match the program ID

for the device containing the network variable.

selector

The scope selector specified in the format file. The second line
of the format file specifies a scope selector name that specifies
which device types are covered by the format file. Translate

this selector to a selector index using the following table:

Scope Selector

Selector Name

1

DEVICE_CLASS

2

DEVICE_CLASS and SUB_CLASS

3

MANUFACTURER

4

MANUFACTURER and

DEVICE_CLASS

5

MANUFACTURER and

DEVICE_CLASS and SUB_CLASS

6

MANUFACTURER and

DEVICE_CLASS and SUB_CLASS

and MODEL

The selector does not have to match the selector used by the

functional profile template defining the

L

ON

M

ARK

object(s) on

the device.


format type

The format type name specified in the format file. The format
type name must match a type name in the type file associated

with the format file, or in a type file with a lower scope
selector value.


format modifier

A modifier for the format type name that allows multiple
formats to be specified for the same type.

For example, here is a sample user format file.

Set program_id 80:11:22:33:44:55:66:77;

Set selector DEVICE_CLASS;

//
UNVT_s_short: text("%d”);
UNVT_s_long: text("%d”);
UNVT_u_short: text("%d”);
UNVT_u_long: text("%d”);
//

LNS DDE Server User's Guide

5-5

Advertising