IMPOSTAZIONI DEL NODO KNX‑ULTIMATE (DEVICE)

Questo nodo controlla un Indirizzo di Gruppo KNX; è il nodo più utilizzato.

Qui trovi alcuni esempi

Configurazione

Pulsante di comando manuale

L’editor può mostrare, per ogni nodo, un pulsante che invia manualmente un comando KNX senza dover aggiungere nodi Inject.

Il pulsante è visibile soltanto se l’opzione è attiva. In modalità universale l’azione di lettura è disabilitata perché l’indirizzo di gruppo sarebbe sconosciuto.

TAB Opzioni avanzate

TAB KNX Function

Puoi usare JavaScript per modificare il comportamento del msg in ingresso (dal flow) e del telegramma in uscita (verso il BUS KNX). L’editor integrato espone oggetti e funzioni utili per leggere il valore di qualsiasi GA, con o senza file ETS (in questo caso specificando il Datapoint). Lo script viene eseguito a ogni msg in ingresso o a ogni telegramma ricevuto dal BUS. Se attivo, al nome del nodo viene aggiunta l’indicazione “f(x)”.

Oggetti e funzioni disponibili nel codice

Dall’INPUT del flow al BUS KNX (esempi)

Invia al BUS solo se un altro GA ha valore opposto:

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

Se qualcuno accende una luce, accendi 0/1/8 e dopo 2 s spegni il nodo:

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

Dal BUS KNX al PIN di USCITA del nodo (esempi)

Allega all’output anche la temperatura esterna letta da un altro GA:

// msg.payload contiene la temperatura interna; aggiungi la esterna
msg.externalTemperature = getGAValue('0/0/10'); // senza ETS: getGAValue('0/0/10','9.001')
return msg;

Non emettere nulla se msg.payload e un altro GA sono entrambi false:

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

Inputs

destination (string) ** : indirizzo di gruppo di destinazione (solo 3‑livelli), es. 1/1/0.payload (any) ** : valore da inviare (true/false/numero/stringa/oggetto).event (string) ** : GroupValue_Write (scrive sul BUS), GroupValue_Response (risponde sul BUS), Update_NoWrite (non invia al BUS, aggiorna solo il valore interno del nodo).readstatus (boolean) ** : invia un “Read” al BUS (usa sempre true).dpt (string) ** : per es. 1.001. Imposta il Datapoint.writeraw (buffer) ** ebitlenght (int) ** : invio RAW verso il BUS (vedi esempio). bitlenght è la lunghezza in bit del dato RAW.resetRBE (boolean) ** : resetta i filtri RBE interni (msg.resetRBE = true).setConfig (json) : cambia via msg il GA e il DPT del nodo (vedi sotto).

Dettagli setConfig

Puoi cambiare la configurazione del nodo inviando msg.setConfig. Rimane attiva fino al prossimo setConfig o fino a riavvio/redeploy. Le proprietà setGroupAddress e setDPT sono entrambe obbligatorie.

Impostare GA e DPT

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

Impostare GA e leggere il DPT dal file ETS

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

Outputs

1. Uscita standard: payload (string|number|object) sul PIN 1.
2. Errori: error (object) sul PIN 2 con il dettaglio dell’errore.

Dettagli messaggio in uscita

msg.payload contiene il valore del GA (valore dell’indirizzo di gruppo). Esempio di msg completo:

msg = {
  topic: "0/1/2",
  payload: false,
  previouspayload: true,
  payloadmeasureunit: "%",
  payloadsubtypevalue: "Start",
  devicename: "Lampada tavolo pranzo",
  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>"
  }
}

MESSAGGIO DAL FLOW IN INGRESSO

Controllare dispositivi KNX

Il nodo accetta msg dal flow da inviare al BUS KNX e invia msg al flow quando riceve telegrammi dal BUS.

Se hai impostato GA e DPT (manualmente o tramite autocompilazione da ETS), puoi anche sovrascrivere via msg alcuni parametri della finestra di configurazione. Tutte le proprietà sotto sono opzionali, tranne payload.

msg.destination ** : ad es. 0/0/1. GA a 3 livelli da aggiornare.msg.payload ** : ad es. true/false/21/"Hello". Valore da inviare al BUS.msg.event :

GroupValue_Write: scrive sul BUS.

GroupValue_Response: invia una risposta sul BUS.

Update_NoWrite: non invia sul BUS, aggiorna solo il valore interno del nodo.

ATTENZIONE: con msg.event = "Update_NoWrite" tutti i nodi con lo stesso GA emetteranno un msg con event: 'Update_NoWrite' e eventdesc descrittivo.

Se vuoi emettere un “read”, usa msg.readstatus = true.

msg.readstatus = true ** : emette un comando di lettura verso il BUS.msg.dpt ** : per es. 1.001 (accetta anche 9, "9", "DPT9.001").msg.writeraw ** emsg.bitlenght ** : invio RAW al BUS (vedi esempio sotto). Se usi writeraw, il DPT impostato nel nodo viene ignorato.msg.resetRBE = true : resetta i filtri RBE di input e output del nodo.

Cambiare la configurazione via msg

Puoi cambiare la configurazione del nodo inviando msg.setConfig. Vedi la pagina di esempio.

QUICK HOW TO

Altri esempi qui

ACCENDERE UNA LAMPADA

msg.payload = true;
return msg;

DIMMER ASSOLUTO DI UNA LAMPADA

msg.payload = 30;
return msg;

INVIARE TESTO A UN DISPLAY

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

LEGGERE LO STATO DI UNA LAVATRICE

// Invia una richiesta di lettura al BUS; seleziona l'opzione
// "React to response telegrams" per ricevere la risposta.
msg.readstatus = true;
return msg;

INVIARE UN VALORE RAW AL BUS Inserisci un function node prima del nodo KNX‑Ultimate e usa questo codice:

// Esempio DPT 1: luce ON = Buffer<01> con bitlength = 1
msg.writeraw = Buffer.from('01', 'hex');
msg.bitlenght = 1;
return msg;

// Esempio temperatura (DPT 9): 18.4 °C = Buffer<0730>
// msg.writeraw = Buffer.from('0730', 'hex');
// return msg;