beautypg.com

Lonbridge api, General message format – Echelon LonBridg Server User Manual

Page 30

background image

24

LonBridge API

LonBridge API

The communications between the LonBridge Server and various LonBridge

applications uses the LonBridge API. This API consists of XML strings
(commands) passed as messages between the LonBridge Server and a LonBridge

application.
Each message is a well-formed XML string with a element as the top-most
element.
Table 3 lists the commands that form the LonBridge API.

Table 3. LonBridge API Commands

Command

Message Type Description

Output

Instructs the LonBridge Server to perform device
discovery

Input

Allows the LonBridge application to specify error
conditions

Output

Retrieves an object and its attributes with
optional matching criteria

Input

Announces the current value of the attributes for
a device

Input

Announces new devices

Input

Announces the value of an object before any

change has occurred

Input or

Output

Defines the LonBridge XML message

Output

Modifies one or more objects

General Message Format

Each XML element that defines a message (that is, all elements other than the

element) can use either of the following formats for the element name:

• Element name (for example, )
• Object name concatenated with the element name (for example,

)

The

object.element

message format allows you to send the message to a specific

device. Object names must start with the letter

o

plus a number. This number is

the ID (id attribute) specified for the device by LonBridge. A message