History

Dave Conway-Jones 4ed955cecf Slight Unicorn hat READme changes		2016-01-12 22:53:24 +00:00
..
scripts	Add Pi Unicorn Hat node	2016-01-11 21:23:23 +00:00
LICENSE	Add Pi Unicorn Hat node	2016-01-11 21:23:23 +00:00
README.md	Slight Unicorn hat READme changes	2016-01-12 22:53:24 +00:00
package.json	Slight Unicorn hat READme changes	2016-01-12 22:53:24 +00:00
unicorn.html	Slight Unicorn hat READme changes	2016-01-12 22:53:24 +00:00
unicorn.js	Add Pi Unicorn Hat node	2016-01-11 21:23:23 +00:00
unihat	Add Pi Unicorn Hat node	2016-01-11 21:23:23 +00:00
unihat.py	Add Pi Unicorn Hat node	2016-01-11 21:23:23 +00:00

README.md

node-red-node-pi-unicorn-hat

A Node-RED node to output to a Raspberry Pi Unicorn HAT from Pimorini.

Pre-requisites

The Unicorn HAT python drivers need to be pre-installed... see the Pimoroni Getting Started with Unicorn HAT page.

curl -sS get.pimoroni.com/unicornhat | bash

Install

Run the following command in the root directory of your Node-RED install. Usually this is ~/.node-red

npm install node-red-node-pi-unicorn-hat

Usage

The background of the array can be configured using an 8x8 pixel sized png image, or by specifying a single colour using an r,g,b triple.

The brightness can also be set in the configuration. Defaults to 20% so as not to blind you.

A pixel is set by msg.payload with a CSV string x,y,r,g,b , where x and y are 0 to 7, and r, g and b are 0 - 255. If x or y are set to * then the complete row or column can be set. Setting both x and y to * fills the background.

The background can also be set to a colour by setting msg.payload to an r,g,b triple.

Any msg with a msg.topic identifies a 'sprite' pixel, which can then be moved independently of the background. A 'sprite' can be a single pixel or a complete line.

Setting msg.payload to 0 will delete the sprite from the list identified by msg.topic.

Setting msg.payload to DEL delete any sprites - leaving the background.

Setting msg.payload to CLS will clear the display to off and delete any sprites.

The overall brightness may be set by setting msg.payload to brightness,nn, where nn is 0 to 100.

The rotation may be set by setting ••msg.payload•• to 'rotate,rr', where 'rr' is 0, 90, 180 or 270.