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:
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.