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

$ git clone https://github.com/enavarro222/bblamp.git
$ cd bblamp

install depencies:

$ sudo apt-get install python-pip python-dev
$ virtualenv venv
$ source venv/bin/activate
$ pip insall gevent  # need gevent >= 1.0
$ pip insall flask
$ pip insall requests

Note: python-dev are needed to install gevent.

$ 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)

All important python code is mainly at root level :

.
├── api.py          # flask API to manage lapps
├── lampapp.py      # main class to create a BBlamp application (depend on config.py an then on hardware)
├── *config.py*     # configuration of available hardware
├── errors.py       # common lapps management errors
├── simulate.py     # lamp hardware simulator API
├── utils.py        # some helpers
└── webserver.py    # webserer main program

The main directories are:

.
├── blockly         # modified version of Blockly
│   ├── ...
│   ├── blocks      # contains blocks description
│   ├── ...
│   ├── generators  # contains blockscode generator
│   ├── ...
│   ├── msg         # contains blockly i18n files
│   └── ...
├── hardware        # python files for 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

Lamp app or a "lapp"

some requirements:

autonomous python program (only depends on "lampapp" module)
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 lampapp import LampApp
from lampapp.ledpixels import LedPixels

app = LampApp()
app.need("lamp")

@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()

Hardware managment

some requirements:

declare/get "what" is used by an application
declare/get "what" is availble (depending on each install)
(lapp) activate an hardware module
(ui) load blocks for an hardware module
(webserer) check if a app may be run or not (hardware available)
configure hardware (ex: number of led)
switch between different hardware (simulation or not)
user (app) declare what a need (class name)
root declare available class

Specify needed hardware for an application:

An application require some hardware with : app.need("hardware_name"), ex:

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

app = LampApp()
# load a hardware driver which is declared in hardware.conf
app.need("lamp")

app.lamp.on()

Note: it is possible to list all needed hardware of a application:

$ python ./my_application.py --list-hardware"

Specify (and configure) available hardware on a specific installation:

All is in config.py, ex:

config.py

from hardware.lamp import LedPixels
from hardware.ar_i2c import ArI2C, ArBpRouge, ArSwBand, ArSwFct, ArVolume
from hardware.ar_i2c import ArGauge

# declaration of available hardware
hardware = {
    "lamp": LedPixels(32),
    "gauge": ArGauge(),
    "bp_rouge": ArBpRouge(),
    "sw_band": ArSwBand(),
    "volume": ArVolume(),
    "sw_fct": ArSwFct(),
}

Create a spécific hardware driver:

TODO

inheritage of abstract class : BBLampHarware, with some default attribute name ('lamp', 'wiimote', ...)

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

Name		Name	Last commit message	Last commit date
Latest commit History 53 Commits
blockly		blockly
hardware		hardware
static		static
templates		templates
tests		tests
user_apps		user_apps
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
api.py		api.py
bblamp.init		bblamp.init
config.py		config.py
errors.py		errors.py
lampapp.py		lampapp.py
lapp.initd		lapp.initd
makefile		makefile
simulate.py		simulate.py
utils.py		utils.py
webserver.py		webserver.py

License

testUser20000/bblamp

Folders and files

Latest commit

History

Repository files navigation

bblamp

Installation

TODO :

Require (Software)

python:

javascript:

Components (hardware)

Design, Files and directories

Lamp app or a "lapp"

some requirements:

Exemple:

Hardware managment

some requirements:

Specify needed hardware for an application:

Specify (and configure) available hardware on a specific installation:

Create a spécific hardware driver:

BBLamp custom blocks

lapp web editor/manager

Features:

Also some requirements:

Similar projects:

TODO

Long or middle term:

Done:

About

Resources

License

Stars

Watchers

Forks

Languages