Open Smart Environment - Raspberry Pi example

This application allows to control features of the Raspberry Pi. It can be used on its own or together with other example OSE applications, see Media player example.

Features

• GPIO digital input/output (light, switch, heater)
• taking pictures using raspistill

Important links

This package is a part of the OSE suite. For more information, see the following links:

• Raspberry Pi example documentation
• OSE suite documentation
• All packages

About OSE

Open Smart Environment software is a suite for creating multi-instance applications that work as a single whole. Imagine, for example, a personal mesh running on various devices including HTPCs, phones, tablets, workstations, servers, Raspberry Pis, home automation gadgets, wearables, drones, etc.

OSE software consists of several npm packages: a framework running on Node.js, an HTML5 frontend, extending packages and a set of example applications.

Set-up of current example applications. Here, OSE provides a Media player running on an HTPC that can be controlled by an IR remote through LIRC and is capable of playing streams from a DVB streamer and control devices through GPIO pins on a Raspberry Pi

For more information about OSE see the documentation.

Status

• Pre-alpha stage (insecure and buggy)
• Unstable API
• Patchy documentation
• Low test coverage (1 %)

This is not yet a piece of download-and-use software. It is important to understand the basic principles covered by the documentation.

However, this software is successfully and continuously used since end of 2013 in one installation running 7 OSE instances spread over several Raspberries, HTPC and notebook.

Platforms

OSE has the following prerequisites:

• Node.js (>0.12) running on Debian Jessie and Raspbian
• Recent version of Firefox or Chrome browser

Usage

For the Raspberry Pi example application to work, you need the following prerequisites:

• Node.js > 0.12, npm, git

To install the example application, do the following:

git clone https://github.com/OpenSmartEnvironment/ose-example-rpi
cd ose-example-rpi
npm install

Installing dependencies can take some time.

If you want to use this example on a BeagleBone, see these instructions.

To configure this example, edit ose-example-rpi/bin/run.js. If you wish to use this example together with the Media player example, configure its IP address and port number.

player: 'ws://IP_ADDRESS:PORT'

Start the Raspberry Pi example as follows:

./ose-example-rpi/bin/run.js

To access the HTML5 frontend, open the following URL in supported browser

http://localhost:4432

Licence

This software is released under the terms of the GNU General Public Licence v3.0 or later.