Node-Red – Digispark RGB Node

Following on from last weekends post about adding a pause node to Node-Red this weekend I’ve been trying to create a node to support my Digispark RGB USB LED.

The RGB shield for the Digispark came with a sketch and a some python code to send colours to the device using the HID protocol. I had a bit of a poke round and I found node-hid and thought things where going to be easy.

Unfortunately just trying to duplicate the python code in nodejs didn’t seam to work no matter what I tried.

After a bit more digging I found this blog post by Dougal Campbell who looked to have been pursuing a similar idea a little earlier in the year. I couldn’t see any follow up post on his blog but a quick comment later and I had pointers to what he’d managed to get working. I was hoping to leave the default sketch on the digiSpark but it needed a little change to the USB library to make things work properly, you can find the changes here.


// Require main module
var RED = require("../../red/red");
var HID = require('node-hid');
var device;
var node;

// The main node definition - most things happen in here
function DigiRGBNode(n) {
    // Create a RED node
    //look up the matching devices
    var devices = HID.devices(0x16c0,0x05df);
    for (var i=0; i< devices.length; i++) {
      if (devices[i].product == 'DigiUSB') {
        path = devices[i].path;
        node.log("found: " + path);
        try {
          device = new HID.HID(devices[i].path);
          //only work with the first one found
        } catch (e) {
   if (device) {   
      this.on("input", function(msg) {
        if (msg != null) {
          var args = msg.payload.split(',');
          if (args.length == 3) {
   } else {
      node.warn("no digispark RGB found");

// Register the node by name. This must be called before overriding any of the
// Node functions.

DigiRGBNode.prototype.close = function() {
    // Called when the node is shutdown - eg on redeploy.
    // Allows ports to be closed, connections dropped etc.
    // eg: this.client.disconnect();

If you want to have a play unzip in the node-red directory to unpack the whole node into the nodes/hardware directory. I have now saved this a Github GIST which you can check out directly into /node-red/nodes/hardware directory as follows:

[user@node node-red]$ git clone

You will also need to run npm import node-hid in the node-red directory to add the dependency.

(Remember you will need to modify the DigiUSB.cpp and the usbconfig.h in the DigisparkUSB example as mentioned in the link above).

This is unlikely to make it into core Node-RED as the hardware is a little specialist, but if Nick and Dave decide to host a collection of hardware nodes it may end up in there.

2 thoughts on “Node-Red – Digispark RGB Node”

  1. Sorry to bother you so long after you read this blog post but I just started with node-red and tried to use a Digispark RGB so I found your post. First, thanks a lot for documenting this, before finding this post I had no idea what is wrong.

    Now, to my question. Looking at the forum post you linked to, I made the following changes:
    – /libraries/DigisparkUSB/usbconfig.h – changed 2 variables to 1
    – /libraries/DigisparkUSB/DigiUSB.cpp – modified usbFunctionSetup, added usbFunctionWrite and usbFunctionRead
    – started Arduino IDE and without changing anything in the sketch, I uploaded DigibBlink to the digispark board

    After all this, the board is still not seen by node-hid (I tried node show-devices.js in the node-hid module).

    What I am missing?

    Thanks a lot!


  2. Sorry, me again. After hours of trying to figure out what I’m doing wrong I found a comment somewhere saying that to get all details for the USB board one needs to run as root. Started show-devices.js as root and all is fine. Same, if I start node-red as root, all is well.

    Sorry for have bothered you with these messages and tons of thanks for your post which helped me a lot!

    Thank you!

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.