Skip to content

Commit 1547491

Browse files
committed
.
1 parent 0c281b1 commit 1547491

File tree

480 files changed

+3521
-2772
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

480 files changed

+3521
-2772
lines changed

CHANGELOG.md

Lines changed: 24 additions & 24 deletions
Large diffs are not rendered by default.

Node-Red-KNXUltimate.code-workspace

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,6 @@
33
{
44
"name": "node-red-contrib-knx-ultimate",
55
"path": "."
6-
},
7-
{
8-
"name": "node-red-contrib-knx-ultimate.wiki",
9-
"path": "../node-red-contrib-knx-ultimate.wiki"
106
}
117
],
128
"settings": {

README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -62,28 +62,28 @@ Please subscribe to the [YouTube channel](https://www.youtube.com/playlist?list=
6262

6363
**Core KNX nodes**
6464

65-
- **KNX Ultimate** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/2.-Node-Configuration). The primary node for interacting with your KNX installation. Send and receive telegrams, create virtual group addresses, and bridge non‑KNX devices into your bus with an intuitive, highly configurable interface.
65+
- **KNX Ultimate** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Device). The primary node for interacting with your KNX installation. Send and receive telegrams, create virtual group addresses, and bridge non‑KNX devices into your bus with an intuitive, highly configurable interface.
6666
- **KNX Config** - Shared configuration for gateways, security settings, and bus parameters used by every runtime node.
67-
- **Scene Controller** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/SceneController-Configuration). Recall, store, and manage scenes exactly as a hardware KNX scene keypad would, including optional learn buttons from the flow.
67+
- **Scene Controller** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/SceneController-Configuration). Recall, store, and manage scenes exactly as a hardware KNX scene keypad would, including optional learn buttons from the flow.
6868
- **Auto Responder** - Automatically answers KNX read requests (ideal for virtual devices or when you need deterministic status values).
69-
- **Global Context** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/GlobalVariable). Mirrors selected group addresses into Node-RED’s global context for easy use inside function nodes and custom logic.
70-
- **Viewer** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/knxUltimateViewer). Dashboard widget that shows live KNX group address activity and values.
69+
- **Global Context** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/GlobalVariable). Mirrors selected group addresses into Node-RED’s global context for easy use inside function nodes and custom logic.
70+
- **Viewer** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/knxUltimateViewer). Dashboard widget that shows live KNX group address activity and values.
7171

7272
**Automation, safety, and diagnostics**
7373

74-
- **Watchdog** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/7.-WatchDog-Configuration). Monitors bus availability, triggers notifications (e-mail, Telegram, Alexa, Siri, Sonos, …), and can automatically fail over to a backup KNX/IP router or reconnect on demand.
75-
- **Logger** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/Logger-Configuration). Captures telegrams into an ETS‑compatible XML log for in-depth diagnostics (note: KNX/IP interfaces do not report KNX-Ultimate telegrams).
76-
- **Alerter** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/Alerter-Configuration). Raises visual or audio alerts (for instance with node-red-contrib-tts-ultimate) when monitored addresses signal an alarm condition.
77-
- **Load Control** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/LoadControl-Configuration). Supervises energy usage (oven, washing machine, EV charger…) and sheds loads before the main breaker trips.
74+
- **Watchdog** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/WatchDog-Configuration). Monitors bus availability, triggers notifications (e-mail, Telegram, Alexa, Siri, Sonos, …), and can automatically fail over to a backup KNX/IP router or reconnect on demand.
75+
- **Logger** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Logger-Configuration). Captures telegrams into an ETS‑compatible XML log for in-depth diagnostics (note: KNX/IP interfaces do not report KNX-Ultimate telegrams).
76+
- **Alerter** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Alerter-Configuration). Raises visual or audio alerts (for instance with node-red-contrib-tts-ultimate) when monitored addresses signal an alarm condition.
77+
- **Load Control** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/LoadControl-Configuration). Supervises energy usage (oven, washing machine, EV charger…) and sheds loads before the main breaker trips.
7878
- **Staircase** - Automates staircase lighting timers with configurable fade and reminder options.
7979
- **Garage** - Manages garage door or gate logic, including impulse control, status feedback, and safety interlocks.
8080

8181
**IoT integrations**
8282

8383
- **IoT Bridge** - Bridges MQTT/REST devices with KNX, handling payload translations so non‑KNX equipment becomes bus-aware.
84-
- **Home Assistant Translator** - [docs](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/HATranslator). Converts Home Assistant service payloads to KNX telegrams using a built-in, user-editable mapping table.
84+
- **Home Assistant Translator** - [docs](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/HATranslator). Converts Home Assistant service payloads to KNX telegrams using a built-in, user-editable mapping table.
8585

86-
**Philips Hue nodeset** - [guide](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/HUE+Bridge+configuration)
86+
**Philips Hue nodeset** - [guide](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/HUE+Bridge+configuration)
8787
Use the dedicated Hue config node plus the following device nodes to mirror Hue state into KNX and vice versa:
8888

8989
- **Hue Light** - Bi-directional light control with day/night scenes, dimming curves, and tunable white.
@@ -126,9 +126,9 @@ Each node links to detailed wiki documentation with configuration hints, sample
126126

127127
## DOCUMENTATION
128128

129-
* [Wiki and Help](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki)
130-
* [FAQ + Troubleshoot](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/FAQ-Troubleshoot)
131-
* [Security best practices](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/SECURITY)
129+
* [Wiki and Help](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki)
130+
* [FAQ + Troubleshoot](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/FAQ-Troubleshoot)
131+
* [Security best practices](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/SECURITY)
132132

133133

134134

@@ -168,7 +168,7 @@ A huge range of datapoints is supported. If you need one that is missing, open a
168168
</details>
169169
<details><summary>Self protection</summary>
170170

171-
The node protects you from common mistakes. See the [Node Protections](https://github.com/Supergiovane/node-red-contrib-knx-ultimate/wiki/-Protections) page for details.
171+
The node protects you from common mistakes. See the [Node Protections](https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Protections) page for details.
172172

173173
</details>
174174
<details><summary>Built in RBE input/output filter</summary>
File renamed without changes.
File renamed without changes.

docs/wiki/-Sample---Apple-Homekit.md

Lines changed: 63 additions & 0 deletions
Large diffs are not rendered by default.
File renamed without changes.
Lines changed: 154 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,154 @@
1+
# Scene actuator controller
2+
3+
## CONTROLLING A SCENE ACTUATOR
4+
5+
The node is able to control a scene actuator already present and configured in your KNX installation, having group addres with Datapoint 18.001.<br/>
6+
This has not to be mistaken with the **SCENE CONTROLLER ** node.<br/> If you're searching for**SCENE CONTROLLER** node, [click here.](/node-red-contrib-knx-ultimate/wiki/Sample-Scene-Node)<br/>
7+
8+
<img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/wiki/scenecontrollerdpt18.png" width="90%"><br/>
9+
10+
**Copy this code and paste it into your flow**
11+
12+
<details><summary>View code</summary>
13+
14+
> Adjust the nodes according to your setup
15+
16+
```javascript
17+
18+
[
19+
{
20+
"id": "35d7d4f5.61a1e4",
21+
"type": "knxUltimate",
22+
"z": "764badf.d348654",
23+
"server": "dee0436c.30e19",
24+
"topic": "0/1/23",
25+
"outputtopic": "",
26+
"dpt": "18.001",
27+
"initialread": false,
28+
"notifyreadrequest": false,
29+
"notifyresponse": false,
30+
"notifywrite": true,
31+
"notifyreadrequestalsorespondtobus": false,
32+
"notifyreadrequestalsorespondtobusdefaultvalueifnotinitialized": "0",
33+
"listenallga": false,
34+
"name": "MDT Dinning Room Scene Controller ",
35+
"outputtype": "write",
36+
"outputRBE": false,
37+
"inputRBE": false,
38+
"formatmultiplyvalue": 1,
39+
"formatnegativevalue": "leave",
40+
"formatdecimalsvalue": 999,
41+
"passthrough": "no",
42+
"x": 390,
43+
"y": 140,
44+
"wires": [
45+
[
46+
"703116e5.31d"
47+
]
48+
]
49+
},
50+
{
51+
"id": "4dbfd5b4.de9a8c",
52+
"type": "inject",
53+
"z": "764badf.d348654",
54+
"name": "Recall scene n.2",
55+
"topic": "",
56+
"payload": "{\"save_recall\":0, \"scenenumber\":2}",
57+
"payloadType": "json",
58+
"repeat": "",
59+
"crontab": "",
60+
"once": false,
61+
"onceDelay": 0.1,
62+
"x": 120,
63+
"y": 120,
64+
"wires": [
65+
[
66+
"35d7d4f5.61a1e4"
67+
]
68+
]
69+
},
70+
{
71+
"id": "703116e5.31d",
72+
"type": "debug",
73+
"z": "764badf.d348654",
74+
"name": "",
75+
"active": true,
76+
"tosidebar": true,
77+
"console": false,
78+
"tostatus": false,
79+
"complete": "true",
80+
"targetType": "full",
81+
"x": 630,
82+
"y": 140,
83+
"wires": []
84+
},
85+
{
86+
"id": "b7ac41b3.634ad",
87+
"type": "inject",
88+
"z": "764badf.d348654",
89+
"name": "Save scene n.2",
90+
"topic": "",
91+
"payload": "{\"save_recall\":1, \"scenenumber\":2}",
92+
"payloadType": "json",
93+
"repeat": "",
94+
"crontab": "",
95+
"once": false,
96+
"onceDelay": 0.1,
97+
"x": 120,
98+
"y": 160,
99+
"wires": [
100+
[
101+
"35d7d4f5.61a1e4"
102+
]
103+
]
104+
},
105+
{
106+
"id": "d58f9e9.7c0e56",
107+
"type": "comment",
108+
"z": "764badf.d348654",
109+
"name": "Recall and save scene",
110+
"info": "To save and recall scene, use payload:{\"save_recall\":0, \"scenenumber\":2}\n\nsave_recall = 0 recalls the scene\nsave_recall = 1 saves the scene\n\nscenenumber is the number of the scene to be recalled or saved",
111+
"x": 120,
112+
"y": 80,
113+
"wires": []
114+
},
115+
{
116+
"id": "dee0436c.30e19",
117+
"type": "knxUltimate-config",
118+
"z": "",
119+
"host": "224.0.23.12",
120+
"port": "3671",
121+
"physAddr": "15.15.22",
122+
"suppressACKRequest": false,
123+
"csv": "",
124+
"KNXEthInterface": "Auto",
125+
"KNXEthInterfaceManuallyInput": "",
126+
"statusDisplayLastUpdate": true,
127+
"statusDisplayDeviceNameWhenALL": true,
128+
"statusDisplayDataPoint": false,
129+
"stopETSImportIfNoDatapoint": "stop",
130+
"loglevel": "error",
131+
"name": "Gateway",
132+
"localEchoInTunneling": true
133+
}
134+
]
135+
136+
```
137+
138+
</details>
139+
140+
<br/>
141+
<br/>
142+
<br/>
143+
144+
**Function node to recall or save a scene from/to a scene actuator**
145+
146+
```javascript
147+
148+
// To save and recall scene, use payload:{save_recall:0, scenenumber:2}
149+
// save_recall = 0 recalls the scene
150+
// save_recall = 1 saves the scene
151+
// scenenumber is the number of the scene to be recalled or saved
152+
return {payload:{save_recall:0, scenenumber:2}};
153+
154+
```
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)