FAQ

Updated July 19, 2022 by luwol03, Shaquu and GogoVega

Frequently Asked Questions

How to check software versions

How to check versions for most common install methods:

Our node

  • Settings/Manage palette Nodes Version via Manage Palette

  • package.json file in your Node-RED installation folder usually ~/.node-red Nodes Version via package.json

Node-RED

Check in the drop-down menu in the top right of the editor.

Node-JS

Run node -v in the command line

Which format for msg.payload (JSON)

Payload messages sent and received from the HomeKit node have a JSON structure. To popularize, this structure resembles a library: you search for your book (value) thanks to its title (key).

Below is an example of msg.payload:

msg = {
  payload: {
    On: true,
    Brightness: 38,
  },
};

In this example we can retrieve the value of On with this JavaScript path: msg.payload.On.

What’s Home Hub

Home Hub is the name given to the device that acts as the gateway between your accessories and Apple’s servers. Concretely, Home Hub allows you to access your accessories from outside your home.

Differentiate between passthrough or “from HomeKit” messages

In some cases, it may be useful, even essential, to differentiate a command from the previous node or Home.app to avoid a loop problem.

Miscellaneous oddities…

  • We highly recommend setting your Node-RED editor to “Deploy modified nodes” only. This will keep the backend for HomeKit nodes from restarting so often while making edits, keeping the Home app much happier.

Modified Nodes

  • Sometimes Node-RED will send multiple copies of each message when you’ve been working on a lot of flows, simply restart Node-RED to clear the caches and you’ll usually be back to normal
  • If something new is struggling, the first thing to try is to remove the problem service node, deploy, then add it back. If things still struggle it might be helpful to remove the problem nodes and bridge from Node-RED and the Home app - then add it all back in.

Edit this page on GitHub