Project

ardtweeno

0.0
No commit activity in last 3 years
No release in over 3 years
Ardtweeno - Application Gateway bridges device connected through a serial link to devices connected over Internet Protocol. It is designed as a PaaS capable of being run on the ARM powered Raspberry Pi Model B. It exposes a RESTAPI powered by Sinatra.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 1.6.2
>= 1.2.3
>= 1.6.2
>= 0
>= 1.3.3
>= 1.5.0
>= 0.6.3
 Project Readme

Ardtweeno - Application Gateway

Ardtweeno is an application gateway which bridges a Serial Device and an Internet Protocol network. The system is designed as a PaaS (platform as a service) for the Raspberry Pi ARM platform. All data received on the serial interface is stored to a MongoDB database if one is available otherwise stores the data in system RAM. The gateway exposes a HTTP REST API for configuration and data manipulation purposes which can be queried in order to build statistics, graphs and other forms of data reporting.

The core system is wrapped in a Ruby Sinatra web application which exposes a HTTP REST API and allows interaction with the gateway over RESTful HTTP calls on the IP network. This has been designed with a Raspberry Pi in mind and has been tested to work correctly on the Raspbian Wheezy distribution.

The system has been designed to be as modular in nature as possible. It is for this reason the interface to the gateway from the serial link is through a HTTP REST API. This allows many different devices at multiple sites to communicate with the central gateway over a LAN/WAN or the internet, while also retrieving data from a serial device connected locally.

To enable the Ardtweeno gateway to speak to a specific serial device, a SerialParser implementation must be developed. The only requirement from the gateway's point of view is that it must interact with it through the HTTP REST API.

In future releases, I hope to make the service interactable so that it may respond to commands received on twitter, or through web hooks and possibly an IRC bot.

This is a work in progress! The Wiki associated now contains the instructions for accessing the REST API and installation instructions. Any bugs encountered can be raised on the issue tracker.

If you would like to collaborate with me on this project please fork the repository and send any changes through a pull request! I gladly welcome constructive input!

COPYING / Licence

This software is released under the GNU General Public License 3.0 (GPL 3.0) for more information see the full details of this licence here: http://www.gnu.org/licenses/

For information regarding commercial use of the Ardtweeno Gateway, please contact the author at: davidkirwanirl (at) gmail dot com or through Twitter at @kirwan_david

DISCLAIMER

All code is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Usage Instructions

See the WIKI for information regarding configuration and installation, and here for usage instructions: usage