node-red-contrib-knx-ultimate

v3.3.2

Control your KNX intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable. For more information about how to use this package see README

Latest version published 4 days ago

License: MIT

NPM

GitHub

Package Health Score

76 / 100

security
Security review needed
popularity
Small
maintenance
Healthy
community
Active

Explore Similar Packages

Security

Security review needed

All security vulnerabilities belong to production dependencies of direct and indirect packages.

Security and license risk for significant versions

All Versions

Version				Vulnerabilities	License Risk
3.3.2	\|	11/2024		0 C 0 H 0 M 0 L	0 H 0 M 0 L
3.2.17	\|	11/2024	Popular	0 C 0 H 0 M 0 L	0 H 0 M 0 L
2.5.1	\|	05/2024		0 C 0 H 0 M 0 L	0 H 0 M 0 L
1.4.18	\|	05/2023		0 C 0 H 0 M 0 L	0 H 0 M 0 L
1.3.49	\|	08/2022		0 C 0 H 0 M 0 L	0 H 0 M 0 L

License

MIT

Security Policy

Is your project affected by vulnerabilities?

Scan your projects for vulnerabilities. Fix quickly with automated fixes. Get started with Snyk for free.

Get started free

Popularity

Small

Weekly Downloads (2,068)

GitHub Stars: 153
Forks: 34
Contributors: 20

Direct Usage Popularity

The npm package node-red-contrib-knx-ultimate receives a total of 2,068 downloads a week. As such, we scored node-red-contrib-knx-ultimate popularity level to be Small.

Based on project statistics from the GitHub repository for the npm package node-red-contrib-knx-ultimate, we found that it has been starred 153 times.

Downloads are calculated as moving averages for a period of the last 12 months, excluding weekends and known missing data points.

Community

Active

Readme.md: Yes
Contributing.md: Yes
Code of Conduct: Yes
Contributors: 20
Funding: No

With more than 10 contributors for the node-red-contrib-knx-ultimate repository, this is possibly a sign for a growing and inviting community.

Embed Package Health Score Badge

Maintenance

Healthy

Commit Frequency

Open Issues: 1
Open PR: 0
Last Release: 4 days ago
Last Commit: 12 days ago

Further analysis of the maintenance status of node-red-contrib-knx-ultimate based on released npm versions cadence, the repository activity, and other data points determined that its maintenance is Healthy.

We found that node-red-contrib-knx-ultimate demonstrates a positive version release cadence with at least one new version released in the past 3 months.

As a healthy sign for on-going project maintenance, we found that the GitHub repository had at least 1 pull request or issue interacted with by the community.

Keep your project healthy

Check your package.json

Ensure all the packages you're using are healthy and well-maintained

Snyk Vulnerability Scanner

Get health score & security insights directly in your IDE

Package

Node.js Compatibility: >=16.0.0

Age: 5 years
Dependencies: 14 Direct
Versions: 456
Install Size: 6.27 MB
Dist-tags: 2
# of Files: 270
Maintainers: 1
TS Typings: No

node-red-contrib-knx-ultimate has more than a single and default latest tag published for the npm package. This means, there may be other tags available for this package, such as next to indicate future releases, or stable to indicate stable releases.

Readme

Logo

Sample Node

Authorized KNX logo by KNX Association*

You can use it immediately!


msg.payload = true // Turn light on
msg.payload = {red:255, green:200, blue:30} // Put some colors in our life

> [!TIP] > I'm putting many effort, money and free time to this node, so please consider MAKING A LITTLE DONATION if you're using KNX-Ultimate. Thanks!

YOUTUBE CHANNEL

Please subscribe to the Youtube channel and watch the node in action.

NODE'S LIST

KNX-ULTIMATE node here, allow you to control your KNX installation via Node-Red. You can control all your KNX devices as well as create a Virtual Device in Node-Red, to link external non KNX devices, and make it compatible with your KNX installation. I'ts very SIMPLE TO USE thus very customizable.
SCENE CONTROLLER node here, The scene controller node can act as a real scene controller, with recall and save of the current scene.
WATCHDOG node here, allows notification (Email, Twitter, Telegram, Alexa, Siri, Sonos -with sonospollytts node- and so on) of KNX Bus connection errors, automatic or manual switchover to a backup KNX/IP router if the primary fails and allows you to programmatically change the config-node directly from a msg flow. It also can force the disconnection and connection of the selected Gateway from the KNX BUS.
LOGGER node here, creates an XML diagnostic file, compatible with ETS. You can open it with ETS for diagnostic pourposes. Node: the Logger currently doesn't record the telegrams coming from KNX-Ultimate if you use a KNX/IP Interface.
GLOBAL CONTEXT node here, exposes the group addresses to a Global Context variable, to be used in function nodes.
ALERTER node here. With the Alerter node you can signal to a display or to the node-red-contrib-tts-ultimate node (audio feedback), whenever the selected devices are alerted, i.e. they have payload true.
LOAD CONTROL node here. Control your loads (Oven, Washing machine, etc..) and avoit shutting down the main voltage due to too high power consumption.
VIEWER node here. View all Group Addresses and values of your KNX BUS, in the Node-Red Dashboard.
AUTO RESPONDER node responds to read requests coming from the bus. Used mainly for virtual group addresses.
PHILIPS HUE nodeset here. Link HUE devices to KNX in a simple way.
HOME ASSISTANT translator node here translates the HA input msg, to a KNX value. Comes with a built-in translation table, that's user editable.

CHANGELOG

See here the changelog

SUPPORTED TECHNOLOGIES

Technology	Supported
KNX Tunnelling
KNX Routing
Philips Hue v2
KNX Secure Tunnelling
KNX Secure Routing
KNX 3rd PARTY IOT API client
Matter

DOCUMENTATION

Highlights

If you're here, you probably already have tried other knx nodes from npm. I hope you enjoy this one, because i've put big effort to do what i really needed, a copy/paste friendly node, with many functions and the possibility to use the ETS csv exported Group Addresses.

Stand alone or with ETS exported file

You can set you own group address, datapoint and device name, or you can import the ETS Group Address list and have datapoint and device name auto populated while typing in the group address.

Filling helpers

If you import your ETS CSV or ESF file, just begin typing the group address or the device name in the Group Address textbox and a list of possible matches will appear. Just select an item in the list it and have datapoint and device name auto populated. You can then accept the auto populated fields or change it.

Automatic encoding/deconding of KNX datagrams

Just pass a normal payload to the node (true, false, a string or any nymber) and just receive a normal payload (true, false, a string or any nymber) to use in your flow.

As single device, as Universal node.

The node can act as a single device (for example having Group Address 0/0/1), or can be used as universal node, catching all messages coming from KNX Bus (in this case the node will output a comprehensive msg to the flow, containing group address, device name, automatic decoded payload and other useful infos). The node can act as universal KNX sender as well (you can pass a message to the node, containing the destination group address, the datapont type and the payload).

Contextual help for formatting input messages

There is samples. There is huge documentation about settings and properties. If this is not enough for you, whenever you change the datapoint type, a textblock with a sample msg input (expecially, for tricky datapoints, like RGBW, 10Bytes, Relative Dimming, 3 Bytes setpoint etc...) appears. Just copy/paste it in a function and you're done.

Huge amount of Datapoints are supported

It supports a huge amount of datapoints. If you need more, just open a GitHub issue.

Self protection

The Node protects you, from mistakes you can do. Node Protections

Built in RBE input/output filter

You can select to activate or deactivate it. If active, the node reacts only if payload from KNX Bus or from input msg is changed.

RAW message directly to the BUS

You can send RAW buffers directly to the bus.

WORKING WITH THE ETS CSV FILE OR WITH ESF FILE

Instead of create a knx-ultimate node for each Group Address to control, you can import your ETS csv or esf group addresses file.
Thanks to that, the knx-ultimate node where you selected Universal mode (listen to all Group Addresses), becomes an universal input/output node, aware of all Datapoints, Group Addresses and Device's name (ex: Living Room Lamp). Just send the payload to the knx-ultimate node, and it'll encode it with the right datapoint and send it to the bus. Likewise, when the knx-ultimate node receives a telegram from the bus, it outputs a right decoded payload using the datapoint specified in the ETS file.

Click here for a sample ETS csv file to paste into the ETS field of your config node.

> Copy/Paste this into your configuration node.


"Group name"	"Address"	"Central"	"Unfiltered"	"Description"	"DatapointType"	"Security"
"Attuatori luci"	"0/-/-"	""	""	"Attuatori luci"	""	"Auto"
"Luci primo piano"	"0/0/-"	""	""	"Luci primo piano"	""	"Auto"
"Camera da letto luce"	"0/0/1"	""	""	"Camera da letto luce"	"DPST-1-8"	"Auto"
"Loggia camera da letto"	"0/0/2"	""	""	"Loggia camera da letto"	"DPST-1-1"	"Auto"
"Camera armadi luce"	"0/0/3"	""	""	"Camera armadi luce"	"DPST-1-1"	"Auto"
"Bagno grande luce"	"0/0/4"	""	""	"Bagno grande luce"	"DPST-1-1"	"Auto"
"Loggia bagno grande"	"0/0/5"	""	""	"Loggia bagno grande"	"DPST-1-1"	"Auto"
"Bagno grande specchio (switch)"	"0/0/6"	""	""	"Bagno grande specchio switch"	"DPST-1-1"	"Auto"
"Lavanderia luce"	"0/0/7"	""	""	"Lavanderia luce"	"DPST-1-1"	"Auto"
"Lavanderia specchio (switch)"	"0/0/8"	""	""	"Lavanderia specchio switch"	"DPST-1-1"	"Auto"
"Studio luce"	"0/0/9"	""	""	"Studio luce"	"DPST-1-1"	"Auto"
"Soggiorno luce (switch)"	"0/0/10"	""	""	"Soggiorno luce switch"	"DPST-1-1"	"Auto"
"Soggiorno aplique (switch)"	"0/0/11"	""	""	"Soggiorno aplique switch"	"DPST-1-1"	"Auto"
"Loggia soggiorno cucina"	"0/0/12"	""	""	"Loggia soggiorno-cucina"	"DPST-1-1"	"Auto"
"Cucina luce"	"0/0/13"	""	""	"Cucina luce"	"DPT-1"	"Auto"
"Cucina luce pensili"	"0/0/14"	""	""	"Cucina luce pensili"	"DPT-1"	"Auto"
"Corridoio luce"	"0/0/15"	""	""	"Corridoio luce"	"DPST-1-1"	"Auto"
"Scala LED"	"0/0/16"	""	""	"Scala LED"	"DPST-1-1"	"Auto"
"Soggiorno aplique brighness value"	"0/0/17"	""	""	""	"DPST-5-1"	"Auto"
"Bagno grande specchio (dim)"	"0/0/18"	""	""	"Bagno grande specchio dim"	"DPST-3-7"	"Auto"
"Soggiorno luce brighness value"	"0/0/19"	""	""	""	"DPST-5-1"	"Auto"
"Lavanderia specchio (dim)"	"0/0/20"	""	""	"Lavanderia specchio dim"	"DPST-3-7"	"Auto"
"Scala LED cambiacolori RGB"	"0/0/21"	""	""	""	"DPST-1-1"	"Auto"
"Bagno grande specchio brightness value"	"0/0/22"	""	""	""	"DPST-5-1"	"Auto"
"Soggiorno luce (dim)"	"0/0/23"	""	""	"Soggiorno luce dim"	"DPST-3-7"	"Auto"

Click here for a sample ETS esf file to paste into the ETS field of your config node.

> Copy/Paste this into your configuration node.


My beautiful home
Attuatori luci.Luci primo piano.0/0/1	Luce camera da letto	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/2	Luce loggia camera da letto	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/3	Luce camera armadi	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/4	Luce bagno grande	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/5	Luce loggia bagno grande	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/6	Luce specchio bagno grande (switch)	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/7	Luce lavanderia	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/8	Luce specchio lavanderia (switch)	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/9	Luce studio	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/10	Plafoniera soggiorno (switch)	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/11	Applique soggiorno (switch)	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/12	Luce loggia soggiorno cucina	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/13	Luce cucina	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/14	Pensili cucina	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/15	Luce corridoio	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/16	LED scala	EIS 1 'Switching' (1 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/18	Luce specchio bagno grande(dim)	EIS 2 'Dimming - control' (4 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/20	Luce specchio lavanderia (dim)	EIS 2 'Dimming - control' (4 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/23	Plafoniera soggiorno (dim)	EIS 2 'Dimming - control' (4 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/24	Applique soggiorno (dim)	EIS 2 'Dimming - control' (4 Bit)	Low	
Attuatori luci.Luci primo piano.0/0/17	Applique soggiorno brighness value	Uncertain (1 Byte)	Low	
Attuatori luci.Luci primo piano.0/0/19	Plafoniera soggiorno brighness value	Uncertain (1 Byte)	Low	
Attuatori luci.Luci primo piano.0/0/21	LED cambiacolori RGB scala	EIS 1 'Switching' (1 Bit)	Low

COMMERCIAL COMPANIES USING KNX-ULTIMATE

List of commercial companies, which have given us permission to be mentioned on this page. Want to be listed here? Email to maxsupergiovane@icloud.com

FRIENDLY COMMUNITIES AROUND THE WORLD

Italy

VivereSmart TV

Germany

China

QQ group: 837579219 （加群需要备注 "来自github"

ARE YOU A NODEJS DEV? DO YOU KNOW THERE IS AN API FOR NODEJS?

Many users requested me to "extract" the baseline KNX API and make it accessible via npmjs. Here is it.
The API is named KNXUltimate. In the README page is well documented and there are also samples for unsecure and secure KNX connections.

KNXUltimate API

A big THANK YOU to @svenflender for the logo and icon graphics!
We support GitBook

Logo

Authorized KNX logo by KNX Association
*The author Massimo Saccani has been authorized to use the KNX logo.
Forks of the knx-ultimate node are not implicitly allowed to use the KNX logo.

node-red-contrib-knx-ultimate dependencies

binary-parser crypto-js dns-sync eventsource js-yaml knxultimate lodash node-color-log mkdirp node-hue-api path ping simple-get xml2js

FAQs

What is node-red-contrib-knx-ultimate?

Control your KNX intallation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group addr... Visit Snyk Advisor to see a full health score report for node-red-contrib-knx-ultimate, including popularity, security, maintenance & community analysis.

Is node-red-contrib-knx-ultimate popular?

The npm package node-red-contrib-knx-ultimate receives a total of 2,068 weekly downloads. As such, node-red-contrib-knx-ultimate popularity was classified as small. Visit the popularity section on Snyk Advisor to see the full health analysis.

Is node-red-contrib-knx-ultimate well maintained?

We found that node-red-contrib-knx-ultimate demonstrated a healthy version release cadence and project activity. It has a community of 20 open source contributors collaborating on the project. See the full package health analysis to learn more about the package maintenance status.

Is node-red-contrib-knx-ultimate safe to use?

While scanning the latest version of node-red-contrib-knx-ultimate, we found that a security review is needed. A total of 0 vulnerabilities or license issues were detected. See the full security scan results.

Last updated on 20 November-2024, at 18:20 (UTC).

Build a secure application checklist

Select a recommended open source package

Minimize your risk by selecting secure & well maintained open source packages

DONE

Scan your app for vulnerabilities

Scan your application to find vulnerabilities in your: source code, open source dependencies, containers and configuration files

SCAN NOW

Fix identified vulnerabilities

Easily fix your code by leveraging automatically generated PRs

AUTO FIX

Monitor for new issues

New vulnerabilities are discovered every day. Get notified if your application is affected

MONITOR APP