beautypg.com

Lonbridge commands for output messages – Echelon LonBridg Server User Manual

Page 34

background image

28

LonBridge API

can act on the change (for example, update a GUI window) without waiting

for the response from the remote L

ON

W

ORKS

device.

The message is usually followed by the message.
The attributes for the message vary depending on the device

and the original output message for which this message is the response. The
reported attributes include a fixed set of attributes that identify the device,

followed by the attributes defined within the element in the
devices.xml file. The fixed and variable attributes are defined in

Instances

Directory

on page 16.

The element defines the LonBridge XML message, and is the top-most

element for the message.
The element is required, and only one element is allowed per
message.

LonBridge Commands for Output Messages

A LonBridge application sends LonBridge output messages to the LonBridge

Server to manage and communicate with devices within the L

ON

W

ORKS

network.

The LonBridge XML for output messages includes the following XML elements:

The message instructs the LonBridge Server to perform device
discovery.

The message retrieves an object and its attributes with optional
matching criteria. If no object or criteria is specified, the LonBridge Server

returns all objects and their attributes. If an object or criteria is specified
but, no objects match the criteria, the LonBridge Server returns an empty

message (that is, ).
Table 5 lists the attributes for the message.

Table 5. Attributes for the Message

Attribute

Description

Required?

select

Specifies a comma-separated list of
returnable attribute names. If omitted, all

attributes are returned.

Optional

where

Specifies an expression that must evaluate

to TRUE for the attribute to be returned.

Required if

select is

specified

The element defines the LonBridge XML message, and is the top-most

element for the message.