KNX-ULTIMATE GERÄTE-NODE EINSTELLUNGEN

Dieser Node steuert eine KNX-Gruppenadresse und ist der am häufigsten verwendete.

Beispiele findest du hier

Konfiguration

Manueller Befehlsbutton

Im Editor kann pro Node ein kleiner Button angezeigt werden, über den du KNX-Telegramme ohne zusätzlichen Inject-Knoten auslösen kannst.

Der Button wird nur eingeblendet, wenn die Option aktiv ist. Im Universalmodus ist die Leseaktion deaktiviert, da keine feste Gruppenadresse vorhanden ist.

TAB Erweiterte Optionen

TAB KNX Function

Mit JavaScript kannst du das Verhalten eingehender Nachrichten (vom Flow) und ausgehender Telegramme (zum BUS) anpassen. Der Editor stellt Hilfsobjekte und -funktionen bereit, um GA-Werte zu lesen - mit ETS (ohne DPT) oder ohne ETS (mit DPT). Der Code läuft bei jeder Eingangs-Nachricht und bei jedem BUS-Telegramm. Bei Aktivierung erscheint “f(x)” im Nodename.

Verfügbare Objekte/Funktionen

Beispiele (Flow → BUS)

const statusGA = await getGAValue('0/0/09','1.001');
if (msg.payload !== statusGA){ return msg; } else { return; }

if (msg.payload){
  setGAValue('0/1/8', true)
  setTimeout(function(){ self(off); }, 2000);
}
return msg;

Beispiele (BUS → Ausgang)

msg.externalTemperature = await getGAValue('0/0/10'); // ohne ETS: await getGAValue('0/0/10','9.001')
return msg;

const otherGA = await getGAValue('0/0/11','1.001');
if (msg.payload === false && otherGA === false){ return; } else { return msg; }

Inputs

• destination (string): 3-stufige GA, z. B. 1/1/0
• payload (any): zu sendender Wert
• event (string): GroupValue_Write, GroupValue_Response, Update_NoWrite (nur interner Wert, kein BUS-Senden)
• readstatus (boolean): Leseauftrag an den BUS
• dpt (string): z. B. 1.001
• writeraw (buffer) + bitlength (int): RAW-Senden; bitlength in Bit (bitlenght wird aus Kompatibilitaetsgruenden weiterhin akzeptiert)
• resetRBE (boolean): RBE-Filter zurücksetzen
• setConfig (json): GA/DPT des Nodes per Nachricht ändern

setConfig Details

var config= { setGroupAddress: "0/1/2", setDPT: "1.001" };
msg.setConfig = config; return msg;

var config= { setGroupAddress: "0/1/2", setDPT: "auto" };
msg.setConfig = config; return msg;

Outputs

1. Standardausgang: payload am PIN 1.
2. Fehler: error am PIN 2.

Ausgehende Nachricht (Beispiel)

msg = {
  topic: "0/1/2",
  payload: false,
  previouspayload: true,
  payloadmeasureunit: "%",
  payloadsubtypevalue: "Start",
  devicename: "Esstischlampe",
  gainfo: {
    maingroupname: "Light actuators",
    middlegroupname: "First flow lights",
    ganame: "Table Light",
    maingroupnumber: "1",
    middlegroupnumber: "1",
    ganumber: "0"
  },
  echoed: true,
  knx: {
    event: "GroupValue_Write",
    dpt: "1.001",
    dptdesc: "Humidity",
    source: "15.15.22",
    destination: "0/1/2",
    rawValue: "<buffer>"
  }
}

Hinweis zu echoed: Wenn echoed auf true steht, ist die Nachricht nur eine interne Passthrough-Kopie (Eingangspin -> Ausgangspin desselben Nodes). Das ist kein echter KNX-Busverkehr und sollte bei der Busanalyse ignoriert werden.

EINGANGS-NACHRICHT AUS DEM FLOW

KNX-Geräte steuern

Der Node nimmt Nachrichten entgegen und sendet sie auf den KNX-BUS; eingehende BUS-Telegramme werden als Nachrichten an den Flow ausgegeben. Alle Eigenschaften optional, außer payload.

• msg.destination: z. B. 0/0/1
• msg.payload: z. B. true/false/21/"Hello"
• msg.event: GroupValue_Write/GroupValue_Response/Update_NoWrite (bei Update_NoWrite geben alle Nodes mit derselben GA eine Meldung mit event: 'Update_NoWrite' aus)

Für Read statt event bitte msg.readstatus = true verwenden.

• msg.readstatus = true: Read an den BUS
• msg.dpt: z. B. 1.001 (auch 9, "9", "DPT9.001")
• msg.dpt = raw: eingehende Telegramme bleiben undekodiert; msg.payload ist null und die Bytes stehen in msg.knx.rawValue. Zum Senden von RAW-Telegrammen msg.writeraw verwenden
• msg.writeraw + msg.bitlength: RAW-Senden; ignoriert den am Node gesetzten DPT
• msg.resetRBE = true: RBE-Filter zurücksetzen

Konfiguration per Nachricht ändern

Siehe Beispielseite.

QUICK HOW TO

Weitere Beispiele hier

LAMPE EINSCHALTEN

msg.payload = true; return msg;

ABSOLUTES DIMMEN

msg.payload = 30; return msg;

TEXT AN DISPLAY

msg.payload = "Output Tem. 35°C"; return msg;

STATUS LESEN

msg.readstatus = true; return msg;

RAW AN BUS SENDEN

msg.writeraw = Buffer.from('01','hex');
msg.bitlength = 1; return msg;
// Temperatur (DPT9): 18.4 °C = <0730>
// msg.writeraw = Buffer.from('0730','hex'); return msg;