oFMS - open Facility Management Server

About adapters

Further information..(pdf)

Package includes three adapters. Smartadapter is a simple example adapter, which brings the master state option and one relay switch from Ensto Smart available to oFMS. Pingvinadapter is a simple example adapter, which brings some values and controls of the Enervent Pingvin available to oFMS. There is also a virtual lamp adapter, which is made for testing purposes and is not really connected to any real device. Note that Smartadapter and Pingvinadapter will not work if you do not have the actual devices and special converters with serial port interfaces. You can use the virtual lamp adapter to test how adapters work. Before starting an adapter make sure you have right port number. Setup program lists the port number that server is using.

Starting SmartAdapter

java adapters.HTTPSmartAdapter http://localhost:8080

Starting Pingvinadapter

java adapters.HTTPPingvinAdapter http://localhost:8080

Starting Virtual lamp

java adapters.VirtualLamp http://localhost:8080 -g

Implementing an adapter

Implementing another adapter is comparatively easy but naturally requires knowlegde about the device. It should be approximately two weeks job for a normal programmer.

Adapter should work like this: Adapter starts up and begins to communicate with the device. It reads the Lobby object from the oFMS and adds device data and controls to the server using SignUp operation. Then it creates a Watch, adds references to device controls in it and starts to poll Watch.pollChanges operation. This way it can monitor if any changes should be commanded to the device. At the same time it always writes updates from the device to the oFMS.

Best way to start developing another adapter is first to get familiar with the example adapters in the package. Using OfmsHTTPClient class will most propably also help your task. It offers a good interface for communication to server.

More detailed information about adapters:

oFMS Features (pdf) »