Echelon LonBridg Server - Manual (Page 5)

LonBridge Server User’s Guide v
Table of Contents
Welcome.........................................................................................................iii
Audience ........................................................................................................iii
Related Documentation ................................................................................iii
Introduction........................................................................................................ 1
Introduction.................................................................................................... 2
Getting Started .............................................................................................. 4
Installing the LonBridge Server ................................................................... 4
Installation for Windows......................................................................... 4
Installation for Linux .............................................................................. 5
Starting the LonBridge Server...................................................................... 6
Command Line Usage for Windows ....................................................... 6
Command Line Usage for Linux............................................................. 6
Command Line Switches......................................................................... 6
Configuring the LonBridge Server .................................................................... 9
Configuring the LonBridge Server.............................................................. 10
The LonBridge Control Utility ............................................................. 10
The config.xml File ................................................................................ 11
Classes Directory................................................................................... 13
Instances Directory ............................................................................... 16
Using the LonBridge API................................................................................. 19
Tasks Performed by a LonBridge Application ........................................... 20
Defining Device Classes ........................................................................ 20
Discovering and Communicating with Devices ................................... 20
Tasks Performed by the LonBridge Server ................................................ 20
Discovering Devices............................................................................... 21
Monitoring and Polling a Network Variable........................................ 21
Updating a Network Variable............................................................... 22
LonBridge API.................................................................................................. 23
LonBridge API.............................................................................................. 24
General Message Format ...................................................................... 24
Expressions ............................................................................................ 25
Tracers.................................................................................................... 25
Errors ..................................................................................................... 25
Parsing a LonBridge XML Message..................................................... 26
LonBridge Commands for Input Messages.......................................... 27
LonBridge Commands for Output Messages ....................................... 28
XML Schema for the LonBridge API.................................................... 29
Examples................................................................................................ 30
LonBridge Device Class File............................................................................ 33
LonBridge Device Class File Format.......................................................... 34
XML Elements for a Device Class File................................................. 34
XML Schema for Device Class Files..................................................... 40
Example Device Class File.................................................................... 41
Creating a LonBridge Device Class File..................................................... 43
Example for Creating a Device Class File.................................................. 44
Examine Source Files............................................................................ 44
Define <attribute> Elements ................................................................ 45
Determine Needed Network Variables ................................................ 45