Installations
npm install node-red-contrib-knx-ultimateReleases
Unable to fetch releases
Developer
Developer Guide
Module System
Unable to determine the module system for this package.
Min. Node Version
>=16.0.0
Typescript Support
No
Node Version
20.12.2
NPM Version
10.9.0
Statistics
153 Stars
1,268 Commits
34 Forks
19 Watching
1 Branches
11 Contributors
Updated on 21 Nov 2024
Languages
HTML (53.5%)
JavaScript (46.5%)
Total Downloads
Cumulative downloads
Total Downloads
239,654
Last day
-57.8%
113
Compared to previous day
Last week
-44.3%
1,151
Compared to previous week
Last month
-6%
5,714
Compared to previous month
Last year
89.6%
104,199
Compared to previous year
Daily Downloads
Weekly Downloads
Monthly Downloads
Yearly Downloads
Authorized KNX logo by KNX Association*
You can use it immediately!
1 2msg.payload = true // Turn light on 3msg.payload = {red:255, green:200, blue:30} // Put some colors in our life 4
[!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
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.
1 2"Group name" "Address" "Central" "Unfiltered" "Description" "DatapointType" "Security" 3"Attuatori luci" "0/-/-" "" "" "Attuatori luci" "" "Auto" 4"Luci primo piano" "0/0/-" "" "" "Luci primo piano" "" "Auto" 5"Camera da letto luce" "0/0/1" "" "" "Camera da letto luce" "DPST-1-8" "Auto" 6"Loggia camera da letto" "0/0/2" "" "" "Loggia camera da letto" "DPST-1-1" "Auto" 7"Camera armadi luce" "0/0/3" "" "" "Camera armadi luce" "DPST-1-1" "Auto" 8"Bagno grande luce" "0/0/4" "" "" "Bagno grande luce" "DPST-1-1" "Auto" 9"Loggia bagno grande" "0/0/5" "" "" "Loggia bagno grande" "DPST-1-1" "Auto" 10"Bagno grande specchio (switch)" "0/0/6" "" "" "Bagno grande specchio switch" "DPST-1-1" "Auto" 11"Lavanderia luce" "0/0/7" "" "" "Lavanderia luce" "DPST-1-1" "Auto" 12"Lavanderia specchio (switch)" "0/0/8" "" "" "Lavanderia specchio switch" "DPST-1-1" "Auto" 13"Studio luce" "0/0/9" "" "" "Studio luce" "DPST-1-1" "Auto" 14"Soggiorno luce (switch)" "0/0/10" "" "" "Soggiorno luce switch" "DPST-1-1" "Auto" 15"Soggiorno aplique (switch)" "0/0/11" "" "" "Soggiorno aplique switch" "DPST-1-1" "Auto" 16"Loggia soggiorno cucina" "0/0/12" "" "" "Loggia soggiorno-cucina" "DPST-1-1" "Auto" 17"Cucina luce" "0/0/13" "" "" "Cucina luce" "DPT-1" "Auto" 18"Cucina luce pensili" "0/0/14" "" "" "Cucina luce pensili" "DPT-1" "Auto" 19"Corridoio luce" "0/0/15" "" "" "Corridoio luce" "DPST-1-1" "Auto" 20"Scala LED" "0/0/16" "" "" "Scala LED" "DPST-1-1" "Auto" 21"Soggiorno aplique brighness value" "0/0/17" "" "" "" "DPST-5-1" "Auto" 22"Bagno grande specchio (dim)" "0/0/18" "" "" "Bagno grande specchio dim" "DPST-3-7" "Auto" 23"Soggiorno luce brighness value" "0/0/19" "" "" "" "DPST-5-1" "Auto" 24"Lavanderia specchio (dim)" "0/0/20" "" "" "Lavanderia specchio dim" "DPST-3-7" "Auto" 25"Scala LED cambiacolori RGB" "0/0/21" "" "" "" "DPST-1-1" "Auto" 26"Bagno grande specchio brightness value" "0/0/22" "" "" "" "DPST-5-1" "Auto" 27"Soggiorno luce (dim)" "0/0/23" "" "" "Soggiorno luce dim" "DPST-3-7" "Auto" 28
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.
1 2My beautiful home 3Attuatori luci.Luci primo piano.0/0/1 Luce camera da letto EIS 1 'Switching' (1 Bit) Low 4Attuatori luci.Luci primo piano.0/0/2 Luce loggia camera da letto EIS 1 'Switching' (1 Bit) Low 5Attuatori luci.Luci primo piano.0/0/3 Luce camera armadi EIS 1 'Switching' (1 Bit) Low 6Attuatori luci.Luci primo piano.0/0/4 Luce bagno grande EIS 1 'Switching' (1 Bit) Low 7Attuatori luci.Luci primo piano.0/0/5 Luce loggia bagno grande EIS 1 'Switching' (1 Bit) Low 8Attuatori luci.Luci primo piano.0/0/6 Luce specchio bagno grande (switch) EIS 1 'Switching' (1 Bit) Low 9Attuatori luci.Luci primo piano.0/0/7 Luce lavanderia EIS 1 'Switching' (1 Bit) Low 10Attuatori luci.Luci primo piano.0/0/8 Luce specchio lavanderia (switch) EIS 1 'Switching' (1 Bit) Low 11Attuatori luci.Luci primo piano.0/0/9 Luce studio EIS 1 'Switching' (1 Bit) Low 12Attuatori luci.Luci primo piano.0/0/10 Plafoniera soggiorno (switch) EIS 1 'Switching' (1 Bit) Low 13Attuatori luci.Luci primo piano.0/0/11 Applique soggiorno (switch) EIS 1 'Switching' (1 Bit) Low 14Attuatori luci.Luci primo piano.0/0/12 Luce loggia soggiorno cucina EIS 1 'Switching' (1 Bit) Low 15Attuatori luci.Luci primo piano.0/0/13 Luce cucina EIS 1 'Switching' (1 Bit) Low 16Attuatori luci.Luci primo piano.0/0/14 Pensili cucina EIS 1 'Switching' (1 Bit) Low 17Attuatori luci.Luci primo piano.0/0/15 Luce corridoio EIS 1 'Switching' (1 Bit) Low 18Attuatori luci.Luci primo piano.0/0/16 LED scala EIS 1 'Switching' (1 Bit) Low 19Attuatori luci.Luci primo piano.0/0/18 Luce specchio bagno grande(dim) EIS 2 'Dimming - control' (4 Bit) Low 20Attuatori luci.Luci primo piano.0/0/20 Luce specchio lavanderia (dim) EIS 2 'Dimming - control' (4 Bit) Low 21Attuatori luci.Luci primo piano.0/0/23 Plafoniera soggiorno (dim) EIS 2 'Dimming - control' (4 Bit) Low 22Attuatori luci.Luci primo piano.0/0/24 Applique soggiorno (dim) EIS 2 'Dimming - control' (4 Bit) Low 23Attuatori luci.Luci primo piano.0/0/17 Applique soggiorno brighness value Uncertain (1 Byte) Low 24Attuatori luci.Luci primo piano.0/0/19 Plafoniera soggiorno brighness value Uncertain (1 Byte) Low 25Attuatori luci.Luci primo piano.0/0/21 LED cambiacolori RGB scala EIS 1 'Switching' (1 Bit) Low 26
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
|
|
|
|
|
|
|
- Tervis - Alarm System Manufacturer
- KNX Sardegna - Gianmarco Sitzia, Certified KNX Partner
- Agata Store - Professional store and Certified KNX Partner
- ProKNX - KNX Device Manufacturer
- Altis - Energy and utilities provider
- Can'nX France - KNX Device Manufacturer and integrator
FRIENDLY COMMUNITIES AROUND THE WORLD
Italy
Germany
China
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.
A big THANK YOU to @svenflender for the logo and icon graphics!
We support GitBook
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.
No vulnerabilities found.
Reason
30 commit(s) and 23 issue activity found in the last 90 days -- score normalized to 10
Reason
no binaries found in the repo
Reason
0 existing vulnerabilities detected
Reason
license file detected
Details
- Info: project has a license file: LICENSE:0
- Info: FSF or OSI recognized license: MIT License: LICENSE:0
Reason
Found 0/30 approved changesets -- score normalized to 0
Reason
no SAST tool detected
Details
- Warn: no pull requests merged into dev branch
Reason
no effort to earn an OpenSSF best practices badge detected
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
branch protection not enabled on development/release branches
Details
- Warn: branch protection not enabled for branch 'master'
Score
4.3
/10
Last Scanned on 2024-11-25
The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.
Learn MoreOther packages similar to node-red-contrib-knx-ultimate
node-red-contrib-knx-ultimate-plus-hue-contact-sensor
This is a fork of node-red-contrib-knx-ultimate. Thanks to the original author! Control your KNX installation via Node-Red! A bunch of KNX nodes, with integrated Philips HUE control and ETS group address importer. Easy to use and highly configurable.
knxultimate
KNX IP protocol implementation for Node. This is the ENGINE of Node-Red KNX-Ultimate node.
node-red-contrib-boolean-logic-ultimate
A set of Node-RED enhanced boolean logic and utility nodes, flow interruption, blinker, invert, filter, toggle etc.., with persistent values after reboot. Compatible also with Homeassistant values.
node-red-contrib-tts-ultimate
Transforms the text in speech and hear it using Sonos player or generate an audio file to be used with third parties nodes. Works with voices from Amazon, Google (without credentials as well), Microsoft TTS Azure, ElevenLabs.io TTS or your own voice. You