bblamp

BBLamp is a lamp that is easily programmable with the visual and drag and drop language Blockly. This project aims at teach programming to childs and people who are a priori not interested in that. Blockly makes programming easy and intuitive, and the lamp (with leds and sensors) make it attractive !

The BBLamp it self is a Raspberry Pi with a strip of RGB leds, a bunch of sensors and buttons. It is connected to your local network and is programmable throw a modern and intuitive web interface.

Warning : This project is not yet fully usable !
This project is very young but in (active) development. Feel free to contact me for any question, comments, typo correction or whatever...

Installation

install depencies:

$ sudo apt-get install python-pip python-dev
$ sudo pip insall gevent  # need gevent >= 1.0
$ sudo pip insall flask
$ sudo pip insall requests

Note: python-dev are needed to install gevent.

$ git clone https://github.com/enavarro222/bblamp.git
$ cd bblamp
$ make get-ace
$ make install-ace
$ make get-bootstrap
$ make install-bootstrap
$ run webserver.py

activate SPI on rPy:

$ sudo vim /etc/modprobe.d/raspi-blacklist.conf
# add a '#' before line "blacklist spi-bcm2708"

TODO :

install it on a std linux computer without any special hardware
install it on a rPi with led strip and sensors...

Require (Software)

for the wimote:

bluez
python-cwiid

python:

flask
gevent >= 1.0 (https://pypi.python.org/pypi/gevent)
requests
sseclient (https://pypi.python.org/pypi/sseclient)

javascript:

jquery
underscore.js
i18next.js (internationalization)
backbone.js
backbone-layoutmanager
twitter bootstrap
bootboxjs (for confirmation/alert box)
toastr (for notifications)
moment.js (for date/time management)
mousetrap (for shortcuts)
ace.js (source code editor)
blockly

Components (hardware)

More comming soon on the prototype hardawre. For now it is:

Raspberry Pi
string of 25 12mm RGB led pixels controlled by WS2801 (SPI)

Warning. you need led drive by WS2801 and not WS2811. WS2801 strips have 4 wires and can easily be driven by a rPi, whereas WS2811 strips have 3 wires and can not be driven by a rPi. You can find it on ebay.

We aim to add :

light sensor (i3c)
humidity and temp sensor (DHT22/AM2302)
push button
PIR sensor
small mic
small speakers
wimote

Design, Files and directories

The BBLamp software is organise in three parts :

the lamp aplications (or "lapp"):

created by the users,
coded in python,
stored in "user_apps/",
based on python modules (hardware drivers ...) which are un "lampapp/".

edition app:

coded in javascript,
use Blockly for lamp app creation
use ACE for python editing
mainly in "static/" and in "templates"

the webserver:

serve the "edition app"
manage lapps (Create, Read, Update, Delete, and also: Run, Stop, Status)
manage a lamp hardware simulator
written in python (with Flask)

The main directories are:

.
├── blockly         # modified version of Blockly
│   ├── ...
│   ├── blocks      # contains blocks description
│   ├── ...
│   ├── generators  # contains blockscode generator
│   ├── ...
│   ├── msg         # contains blockly i18n files
│   └── ...
├── lampapp         # python files for lamp app creation, hardware drivers
├── lapp_output     # contains lamp app outputs file (used to communicate with the webserver)
├── static          # webapp static files
│   ├── blockly -> ../blockly # link to blockly
│   ├── jslib       # bunch of std JS libs
│   └── locales     # webapp i18n files (use i18next)
├── templates       # web app templates (flask templates)
├── tests           # ...
└── user_apps       # contains application created by users

The web server python code is mainly at root level :

.
├── api.py          # flask API to manage lapps
├── errors.py       # common lapps management errors
├── simulate.py     # lamp hardware simulator API
├── static          # static files (ie JS edition app)
├── templates       # templates, ie JS edition app main page
├── utils.py        # some helpers
└── webserver.py    # webserer main program

The lapp are based on python modules that are in "lampapp"~: TODO: description of these files

Lamp app or a "lapp"

some requirements:

autonomous python program
could be written using blockly
only one running at a time
is run as a service
metadata :

modification date
creation date
author
comment / description

Exemple:

#-*- coding:utf-8 -*-
from lapp import LampApp

app = LampApp()

@app.setup()
def setup():
    global on
    on = False

@app.every(1)
def loop():
    global on
    # blink
    if on:
        app.lamp.turn_off()
    else:
        app.lamp.turn_on()
    on = not on

if __name__ == "__main__":
    app.run()

BBLamp custom blocks

Here is the description of BBLamp specific blocks.

setup: run the action when application is run, before everything else.
every: periodically perform an action.
wait: make a pause of a given time
on

For the WiMote:

start rumble
stop rumble
on button {1, 2, A, B, HAUT, BAS, GAUCHE, DROITE} push

lapp web editor/manager

Features:

create a new lapp
edit a lapp directly in python
edit a lapp with blockly
delete a lapp (with confirmation)
run a lapp
stop the running lapp
view which lapp is running (if any)
view running lapp log (std+err), in live
view last run(s) log (std+err)
set a lapp to be run on startup

xdze2/bblamp