1
0
mirror of https://github.com/node-red/node-red-nodes.git synced 2023-10-10 13:36:58 +02:00
node-red-nodes/hardware/unicorn/README.md
2016-01-11 21:23:23 +00:00

49 lines
1.8 KiB
Markdown

node-red-node-pi-unicorn-hat
============================
A <a href="http://nodered.org" target="_new">Node-RED</a> 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
<a "href=http://learn.pimoroni.com/tutorial/unicorn-hat/getting-started-with-unicorn-hat">
Pimorini Getting Started with Unicorn HAT</a> 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.
Setting **msg.payload** to `0` will delete the sprite from the list.
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.</p>