Staircase Configuration - Supergiovane/node-red-contrib-knx-ultimate GitHub Wiki
🌐 Language: EN | IT | DE | FR | ES | 简体中文
Navigation: Home Overview: Changelog • FAQ • Security • Docs: Language bar KNX Device: Gateway • Device • Protections Other KNX Nodes: Scene Controller • WatchDog • Logger • Global Context • Alerter • Load Control • Viewer • Auto Responder • HA Translator • IoT Bridge HUE: Bridge • Light • Battery • Button • Contact • Device SW update • Light sensor • Motion • Scene • Tap Dial • Temperature • Zigbee connectivity Samples: Logger • Switch Light • Dimming • RGB color • RGBW color + White • Command a scene actuator • Datapoint 213.x 4x Setpoint • Datapoint 222.x 3x Setpoint • Datapoint 237.x DALI diags • Datapoint 2.x 1 bit proprity • Datapoint 22.x RCHH Status • Datetime to BUS • Read Status • Virtual Device • Subtype decoded • Alexa • Apple Homekit • Google Home • Switch on/off POE port of Unifi switch • Set configuration by msg • Scene Controller node • WatchDog node • Global Context node • Alerter node • Load control node • Viewer node • MySQL, InfluxDB, MQTT Sample Contribute to Wiki: Link
The KNX Staircase node emulates the typical stairwell timer using KNX group addresses. When the trigger GA receives an impulse the lamp is forced on, a configurable timer starts and optional warnings are issued before switching off. Additional features cover manual override, blocking (for maintenance), and event reporting to the Node-RED flow.
| Purpose | Property | Notes |
|---|---|---|
| Trigger impulse |
Trigger GA (gaTrigger) |
Rising edge (=1) starts or extends the timer. Optional 0 can cancel the cycle. |
| Output command |
Output GA (gaOutput) |
Drives the actuator (default DPT 1.001). |
| Status report |
Status GA (gaStatus) |
Mirrors the active state and pre-warning flag. Optional. |
| Override |
Override GA (gaOverride) |
Keeps the light permanently on while true and suspends the timer. |
| Block |
Block GA (gaBlock) |
Prevents new activations. Can optionally force the output off. |
All group addresses accept custom DPTs, allowing integration with multi-byte actuators or logic addresses.
- Timer duration sets the base countdown in seconds.
-
On new trigger controls how subsequent impulses behave:
- Restart timer – restarts the countdown.
- Extend remaining time – adds the base duration to the current remaining time.
- Ignore impulse – ignores extra pulses while the timer is active.
- 0 command cancels decides whether a value 0 on the trigger GA immediately switches the light off.
- When blocked determines if the output is forced off or left untouched when the block GA becomes true.
Enable Send pre-warning before timeout to alert occupants before the light turns off. Configure the offset in seconds and choose between:
- Toggle status GA – the status address toggles to signal the alert.
- Flash output – the actuator briefly turns off/on for the specified flash duration.
Tick Emit events on node output to receive structured messages whenever the staircase cycle changes state. Messages contain:
{
topic: <configured outputtopic or GA>,
event: 'trigger' | 'extend' | 'prewarn' | 'timeout' | 'manual-off' | 'override' | 'block',
remaining: <seconds>,
active: <boolean>,
override: <boolean>,
blocked: <boolean>
}
This is useful for dashboards, logging, or custom automation around the staircase timer.
The node honours the KNX Config node status throttle, so frequent timer updates do not overload the editor.
// Start the staircase timer
msg.payload = true;
return msg;// Cancel the cycle (requires "0 command cancels the cycle")
msg.payload = false;
return msg;- Use the override GA for cleaning/maintenance situations.
- Pair the status GA with a visual indicator on the wall or a dashboard widget.
- Enable pre-warning flash only with actuators that support rapid switching.
