Control your KNX intallation via Node.js!

This is the official engine of Node-Red's node node-red-contrib-knx-ultimate

Many of you asked for a node.js release of that engine, so i decided to create this package.

If you enjoy my work developing this package, do today a kind thing for someone too. This will be the reward for my work.

CHANGELOG

• Changelog

Technology	Supported
KNX Tunnelling
KNX Routing
KNX Secure Tunnelling
KNX Secure Routing

CONNECTION SETUP

These are the properties to be passed to the connection as a JSON object {} (see the knxUltimateClientProperties variable in the exsamples)

SUPPORTED DATAPOINTS

For each Datapoint, there is a sample on how to format the payload (telegram) to be passed.

For example, pass a true for datapoint "1.001", or { red: 125, green: 0, blue: 0 } for datapoint "232.600".

It support a massive number of Datapoints. Please run the examples/showDatapoints.ts file to view all datapoints in the output console.

Be aware, that the descriptions you'll see, are taken from Node-Red KNX-Ultimate node, so there is more code than you need here. Please take only the msg.payload part in consideration.

You should see something like this in the console window (the msg.payload is what you need to pass as payload):

METHODS/PROPERTIES OF KNXULTIMATE

EVENTS

List of events raised by KNXultimate, in proper order. For the signatures, please see the examples folder.

DECONDING THE TELEGRAMS FROM BUS

Decoding is very simple.

Just require the dptlib and use it to decode the RAW telegram

import { dptlib } from "knxultimate";
let dpt = dptlib.resolve("1.001");
let jsValue = dptlib.fromBuffer(RAW VALUE (SEE SAMPLES), dpt); // THIS IS THE DECODED VALUE

EXAMPLES

You can find all examples in the examples folder:

• sample - A full featured example that shows how to connect to the KNX bus and send/receive telegrams. WARNING this sends data to your KNX BUS!
• showDatapoints - List all supported Datapoints in the output console, as well as the help code on how the payload's value is constructed, for each datapoint type. This writes nothing to the KNX BUS, you can run it safely.
• simpleSample - A simple example that shows how to connect to the KNX bus and send a telegram. WARNING this sends data to your KNX BUS!
• discovery - A simple example that shows how to discover KNX devices on the network.
• test-toggle - An interactive example that shows how to toggle a switch on/off. WARNING this sends data to your KNX BUS!

HOW TO COLLABORATE

If you want to help us in this project, you're wellcome!

Please refer to the development page.

• Development's page

SUGGESTION

Why not to try Node-Red https://nodered.org and the awesome KNX-Ultimate node https://flows.nodered.org/node/node-red-contrib-knx-ultimate ?