SOA for Building Automation
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

SOABA - A Service Oriented Approach for Building Automation

Building Automation

Build Status

Codeship Status for jpinho/SOABA

Project Goals

Development of a Gateway Driver for interaction with KNX devices. The Gateway Driver is configurable from a XML file containing all the KNX device addresses and their underlying types. The Gateway Driver will be accessible via HTTP by exposing a REST interface, receiving and sending serialized JSON data. The Web Prototype App will make use of this REST interface to control and expose the Gateway Driver functionalities.

Components and Objectives

  • Gateway Driver, for interaction with KNX devices. A gateway driver main purpose is to abstract the complexities of dealing with a particular type of gateway, thus abstracting their subjacent particularities of communication and so forth. With this in mind the proposed objectives for a gateway driver, specific for the KNX technology are: – To establish a communication with KNX devices through an ethernet KNX gateway – Support data point reading functionality from de- vices by address/group address – Support data point writing functionality from de- vices by address/group address – Support for manipulating basic data point data types, such as percentage, float and boolean

  • RESTful Service, for remote interaction with the system. Gateway drivers by them selfs are not enough, over that some orchestration of the available drivers are need to make the complete architecture abstract from it’s implementation. The RESTful Service developed provides and demonstrates that abstraction, by dealing with data points and gateways that are completely independent of their representative technology. This service exposes basic operations to read and control data points, such as: – Read operation from data point address/group address – Write operation to data point address/group ad- dress – Gateway awareness of the devices bound to it, based on a XML file containing the data point addresses, specifying their respective data types and source gateways

  • HTML5 Demo Application, for demonstration of the system. This application exposes some of the basic applications that this system as to offer, and demonstrates how easy their are to develop, by depending only on the data point concept. This demo contains the following functionalities: – List all the data points configured in the application – Interface for reading and manipulating data point values – Sample application to preview meteo station data points, such as outside temperature, exterior entalpia and absolute/relative humidity – Sample application to preview energy measure- ments from meters installed on nucleus 14 – Sample application to control switchs, HVACs, blinders and dimmers

SOABA Screen Shots

Management Interface - Data Points Listing

Management Interface 1

Management Interface - Data Points read/write Interface

Management Interface 2


Meteo Station

Meteo Station

Energy Viewer

Energy Viewer

Control Panel

Control Panel

Available Documentation

Checkout SOABA's Website:

Initial project report and brochure are available bellow:

Rights and License

This repository is a contribution to the Open Source Community, feel free to use this code how you like. If you have any difficulties putting this together, please drop me an email at jpe[dot]pinho[at]gmail[dot]com.