History

dceejay f497b57b7d Apply consistent style to node-red-nodes (not updating npm for this yet - just whitespace)		2015-05-11 19:25:39 +01:00
..
39-rpi-piliter.html	Update Piliter node to use python library.	2015-01-06 14:54:45 +00:00
39-rpi-piliter.js	Apply consistent style to node-red-nodes	2015-05-11 19:25:39 +01:00
LICENSE	Add Pi-LITEr specific node for Pi users	2014-07-25 10:07:23 +01:00
README.md	Update Piliter node to use python library.	2015-01-06 14:54:45 +00:00
nrgpio	Update Piliter node to use python library.	2015-01-06 14:54:45 +00:00
nrgpio.py	Update Piliter node to use python library.	2015-01-06 14:54:45 +00:00
package.json	Update node-red-nodes - clean up lint issues (mainly unused funcs and vars)	2015-04-16 10:58:34 +01:00

README.md

node-red-node-piliter

A Node-RED node to control a Pimorini Pi-LITEr 8 LED add-on board for a Raspberry-Pi.

Install

Run the following command in the root directory of your Node-RED install

npm install node-red-node-piliter

Pre-reqs

Requires the python RPi.GPIO library v0.58 (or better) to be installed in order to work. See the RPi.GPIO site for details on how to do this.

This is built into most recent Raspbian versions so no install should be necessary - but if necessary

$ sudo apt-get update
$ sudo apt-get install python-rpi.gpio python3-rpi.gpio

Usage

Raspberry Pi-LITEr output node. The Pi-LITEr must be fitted.

Operates in one of 5 different modes :

Byte Mode - expects a value between 0 and 255, and each of the LEDs represent 1 bit.
Meter Mode - expects a value between 0 and 8, the led lit corresponds to the input value - like a meter needle.
Bar Mode - expects a value between 0 and 8, similar to meter - but all the leds up to the value are turned on - like a mini bar chart.
All LEDs Mode - expects a 1 or 0 - turns on and off ALL the LEDs
Object Mode - expects a object specifying the LED and state eg. {led:3,state:0} to set LED3 off.

Requires the RPi.GPIO library installed in order to work.

In order to access the GPIO the nrgpio.py command (installed as part of this package) must be run as root (sudo). The default Pi user can do this so it "should just work" - however if you are running Node-RED as not the Pi user then you may need to give your user sudo rights - or specifically sudo rights to python.