Echelon LonBridg Server - Manual (Page 10)

4 Introduction
The LonBridge API supports up to 20 local or remote clients. Each client opens a
TCP socket to the LonBridge Server. Clients call functions in the API by sending
a request to the LonBridge Server. The request must be formatted as an XML
string. The API returns a response as an XML string through the same TCP
socket interface. Each client specifies an incoming port to receive event
notifications for device discovery and network variable value changes. All clients
receive all events.
Getting Started
The LonBridge Server software includes a Windows version and a Linux version.
Both versions are available from Echelon Support.
To use the LonBridge Server, perform the following steps:
1. Install the LonBridge Server. See Installing the LonBridge Server for
more information.
2. Configure the LonBridge Server. See Chapter 2, Configuring the
LonBridge Server , on page 9, for more information.
3. Create a device class file for your device. This file describes the interface
for each device that the LonBridge Server supports. See Chapter 5,
LonBridge Device Class File , on page 33, for more information.
4. Create a LonBridge application using the LonBridge API. See Chapter 4,
LonBridge API , on page 23, for more information.
If you have an Echelon Lamp Module or Appliance Module, you can run the
LonBridge Server after step 2. For the Windows version, you can use the
LonHome™ Display Example application to view and manage the Lamp Module
or Appliance Module; for the Linux version running on the Altera
® Nios ® II
Embedded Evaluation Kit, you can load the example application into the SD
Card and view and manage the Lamp Module or Appliance Module.
Installing the LonBridge Server
Echelon delivers source code for the LonBridge Server to LonBridge Server
licensees. You can port this source code to any platform. The LonBridge Server
has been ported to, and tested with, the following operating system
environments:
• Microsoft Windows XP
• Microsoft Windows Vista
• μClinux™ for the Altera Nios II Embedded Evaluation Kit (NEEK)
Installation for Windows
To install the LonBridge Server on a Windows platform, perform the following
steps:
1. Contact Echelon Support to request a license for the LonBridge Server.
2. Download the LonBridge Server from the address supplied by Echelon
Support.