🌐 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

<

Este nodo le permite controlar una dirección de grupo KNX, este es el nodo más utilizado.

Aquí encontrarás algunas muestras

Configuración

El editor puede mostrar, para cada nodo, un pequeño botón que envía un comando KNX sin necesidad de un nodo Inject adicional.

El botón solo aparece cuando la opción está habilitada. En modo universal la acción de lectura está deshabilitada porque el nodo no dispone de una dirección de grupo fija.

Puede usar JavaScript para modificar el comportamiento del MSG de entrada que proviene del flujo y el telegrama de salida enviado al bus KNX. El editor de código integrado proporciona objetos y funciones útiles para recuperar el valor de todas las direcciones de grupo, tanto con el archivo ETS importado como sin (especificar el punto de datos).
El script se llama cada vez que el nodo recibe un mensaje del flujo o un telegrama del bus KNX. Si está habilitado, la indicación "F (x)" se agregará al nombre del nodo.

En esta muestra, enviaremos el mensaje de entrada al bus KNX solo si otro GA tiene un valor opuesto.
Encenderemos la luz solo si su estado GA está apagado y viceversa.

const statusGA = getGAValue('0/0/09','1.001');
if (msg.payload !== statusGA){ // "!==" means "not equal"
    return msg;
}else{
    // Both values are identical, so i don't send the msg.
    return;
}

Aquí, si alguien enciende la luz, encendemos otra luz 0/1/8 y después de 2 segundos apagamos la lámpara conectada al nodo.

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

En esta muestra, emitiremos el objeto MSG al flujo, agregando el valor de otro GA a la salida Msg.
El mensaje de salida al flujo también tendrá la temperatura externa en la propiedad `msg.externaltemperatura '

// The current msg contains the internal temperature in the "msg.payload" property, but we want to emit the external temperature as well.
msg.externalTemperature = getGAValue('0/0/10'); // In case the ETS file is missing, you must specify the dpt as well: getGAValue('0/0/10','9.001')
return msg;

En esta otra muestra, no emitiremos un MSG al flujo, en el caso de MSG.PayLoad y otro valor de GA son falsos.

if (msg.payload === false && getGAValue('0/0/11','1.001') === false){
    // Both false, don't emit the msg to the flow.
    return;
}else{
    // Ok, emit it.
    return msg;
}

** Destino (cadena) ** : La dirección del grupo de destino, por ejemplo 1/1/0. Solo se permiten 3 niveles.
**carga útil (cualquiera) ** : la carga útil que se enviará. Puede ser, por ejemplo, verdadero o falso, o un objeto.
**Event (String) ** : puede ser _groupValue \ Write para escribir el telegrama al bus KNX, _GroupValue \ Response para enviar un telegrama de respuesta al bus KNX, _update \ nowrite. _Update \ NowRite envía nada al bus KNX, solo actualiza el valor interno del nodo Ulimado KNX. Esto es útil si solo desea almacenar el valor en el nodo y leerlo más tarde con una solicitud de lectura.
**Readstatus (boolean) ** : emita una solicitud de lectura al autobús KNX. Pasar true cada vez (msg.readstatus = true).
**dpt (cadena) ** : por ejemplo "1.001". Establece el punto de datos.
**escritorw (buffer) ** : se usa para enviar un valor al bus KNX, como búfer. Use junto con BitLenght.
**bitlenght (int) ** : Especifica la longitud del buffer writeraw. Use junto con Writeraw.
**ResetrBe (boolean) ** : restablece los filtros RBE internos (use msg.resetrbe = true).
setConfig (JSON) : Cambie programáticamente la dirección de grupo de nodo del dispositivo KNX-Uultimate y punto de datos. Ver detalles.

msg.setConfig: es posible cambiar programáticamente la configuración del nodo ultimate KNX, enviando el objeto Msg.SetConfig al nodo. La nueva configuración se retendrá hasta el próximo msg.setConfig o hasta que reinicie/redploy. Todas las propiedades (setGroupAddress y setdpt) ** son obligatorias** ..
Úselo así, en un nodo Funccton: ** Establezca tanto GA como DPT** javascript // Change the node properties as follows: // setGroupAddress: set the new group address. // setDPT: set the new Datapoint, as you can see in the dropdown list (the numeric part, for example "1.001", "237.600", etc...). If set to **auto** , the datapoint will be read from the ETS file (if present). var config= { setGroupAddress: "0/1/2", setDPT: "1.001" }; msg.setConfig = config; return msg; ** Establezca GA y lea el punto de datos del archivo ETS** ```javascript // Change the node properties as follows: // setGroupAddress: set the new group address. // setDPT: set the new Datapoint, as you can see in the dropdown list (the numeric part, for example "1.001", "237.600", etc...). If set to "auto", the datapoint will be read from the ETS file (if present). var config= { setGroupAddress: "0/1/2", setDPT: "auto" }; msg.setConfig = config; return msg;

### salidas

1. Salida estándar
   : carga de pago (cadena | número | objeto) \*\*: el pin 1 es la salida estándar del comando.

2. Errores
   : error (objeto) \*\*: el pin 2 contiene el mensaje de error detallado.

### Detalles

`msg.payload` se utiliza como la carga útil de la dirección del grupo (el valor de la dirección del grupo).
Este es, en cambio, un ejemplo del objeto MSG completo.

```json
msg = {
    topic: "0/1/2" // (Contains the node's topic, for example "MyTopic". If the node's topic is not set, contains the Group Address, for example "0/1/2")
    payload: false 
    previouspayload: true // Previous node payload value.
    payloadmeasureunit: "%" // Payload's measure unit.
    payloadsubtypevalue: "Start" // Subtype's decoded value, for exampe, On/Off, Ramp/NoRamp, Start/Stop, Alarm/NoAlarm
    devicename: "Dinning table lamp" // If the node is in **universal mode** , it contains the full path (main, middle,name) of the group address name, otherwise, the node name.
    gainfo: { // Contains the details about the group address name and number. This object is only present if the node is set in **universal mode ** and with the**ETS file ** been imported. If something wrong, it contains the string**unknown** .
        maingroupname:"Light actuators"
        middlegroupname:"First flow lights"
        ganame:"Table Light"
        maingroupnumber:"1"
        middlegroupnumber:"1"
        ganumber:"0"
    },
    echoed:true, // True if the msg is coming from the input PIN, otherwise false if the msg is coming form the KNX BUS.
    knx: { // This is a representation of the KNX BUS telegram, coming from BUS
        event: "GroupValue_Write" // (or "GroupValue_Response", or "GroupValue_Read")
        dpt: "1.001"
        dptdesc: "Humidity" // Payload's measure unit description
        source: "15.15.22"
        destination: "0/1/2" // Contains the Group Address
        rawValue: buffer[1]raw // (or null, if "GroupValue_Read")
            0: 0x0 // (This is the RAW undecoded value)
    }
}

: destino (cadena) **: la dirección del grupo de destino, por ejemplo 1/1/0. Solo se permiten 3 niveles.
: carga útil (cualquiera) **: la carga útil que se enviará. Puede ser, por ejemplo, verdadero o falso, o un objeto. : Event (String) **: puede ser _GroupValue \ Write para escribir el telegrama en el bus KNX, _GroupValue \ Response para enviar un telegrama de respuesta al bus KNX, _Update \ nowrite. _Update \ NowRite envía nada al bus KNX, solo actualiza el valor interno del nodo Ulimado KNX. Esto es útil si solo desea almacenar el valor en el nodo y leerlo más tarde con una solicitud de lectura. : ReadStatus (boolean) **: emita una solicitud de lectura al bus KNX. Pasar true cada vez (msg.readstatus = true). : dpt (string) **: por ejemplo "1.001". Establece el punto de datos. : Writeraw (buffer): se usa para enviar un valor al bus KNX, como búfer. Use junto con BitLenght. : bitlenght (int): especifica la longitud del buffer writeraw. Use junto con Writeraw. : ResetrBe (boolean) **: restablece los filtros RBE internos (use msg.resetrbe = true). : SetConfig (JSON) **: Cambie programáticamente la dirección de grupo de nodo de dispositivo KNX-Ulimento y punto de datos. Ver detalles.

msg.setConfig: es posible cambiar programáticamente la configuración del nodo ultimate KNX, enviando el objeto Msg.SetConfig al nodo. La nueva configuración se retendrá hasta el próximo msg.setConfig o hasta que reinicie/redploy. Todas las propiedades (setGroupAddress y setdpt) ** son obligatorias** ..
Úselo así, en un nodo Funccton: ** Establezca tanto GA como DPT** javascript // Change the node properties as follows: // setGroupAddress: set the new group address. // setDPT: set the new Datapoint, as you can see in the dropdown list (the numeric part, for example "1.001", "237.600", etc...). If set to **auto** , the datapoint will be read from the ETS file (if present). var config= { setGroupAddress: "0/1/2", setDPT: "1.001" }; msg.setConfig = config; return msg; ** Establezca GA y lea el punto de datos del archivo ETS** ```javascript // Change the node properties as follows: // setGroupAddress: set the new group address. // setDPT: set the new Datapoint, as you can see in the dropdown list (the numeric part, for example "1.001", "237.600", etc...). If set to "auto", the datapoint will be read from the ETS file (if present). var config= { setGroupAddress: "0/1/2", setDPT: "auto" }; msg.setConfig = config; return msg;

### salidas

1. Salida estándar
   : carga de pago (cadena | número | objeto) \*\*: el pin 1 es la salida estándar del comando.

2. Errores
   : error (objeto) \*\*: el pin 2 contiene el mensaje de error detallado.

### Detalles

`msg.payload` se utiliza como la carga útil de la dirección del grupo (el valor de la dirección del grupo).
Este es, en cambio, un ejemplo del objeto MSG completo.

```json
msg = {
    topic: "0/1/2" // (Contains the node's topic, for example "MyTopic". If the node's topic is not set, contains the Group Address, for example "0/1/2")
    payload: false 
    previouspayload: true // Previous node payload value.
    payloadmeasureunit: "%" // Payload's measure unit.
    payloadsubtypevalue: "Start" // Subtype's decoded value, for exampe, On/Off, Ramp/NoRamp, Start/Stop, Alarm/NoAlarm
    devicename: "Dinning table lamp" // If the node is in **universal mode** , it contains the full path (main, middle,name) of the group address name, otherwise, the node name.
    gainfo: { // Contains the details about the group address name and number. This object is only present if the node is set in **universal mode ** and with the**ETS file ** been imported. If something wrong, it contains the string**unknown** .
        maingroupname:"Light actuators"
        middlegroupname:"First flow lights"
        ganame:"Table Light"
        maingroupnumber:"1"
        middlegroupnumber:"1"
        ganumber:"0"
    }
    knx: { // This is a representation of the KNX BUS telegram, coming from BUS
        event: "GroupValue_Write" // (or "GroupValue_Response", or "GroupValue_Read")
        dpt: "1.001"
        dptdesc: "Humidity" // Payload's measure unit description
        source: "15.15.22"
        destination: "0/1/2" // Contains the Group Address
        rawValue: buffer[1]raw // (or null, if "GroupValue_Read")
            0: 0x0 // (This is the RAW undecoded value)
    }
}

Aquí tiene 2 opciones: Importar archivo CVS ETS o no.
Importar su archivo ETS es el método sugerido Aboslute . Si importa su archivo ETS, el nodo hará la decodificación de DataPoint automáticamente y también le dará el nombre del dispositivo.
Si no importa el ETS, el nodo emitirá el telegrama sin procesar e intenta decodificarlo también.

msg = {
    topic: "0/1/2" // (Contains the Group Address of the incoming telegram)
    payload: false // (Automatically decoded telegram. If you've <b>not imported the ETS file</b>, the node will try to decode the telegram <b>but you can obtain an erroneus value</b>)
    payloadmeasureunit: "%" // (payload's measure unit)
    payloadsubtypevalue: "Start" // (Subtype's decoded value, for exampe, On/Off, Ramp/NoRamp, Start/Stop, Alarm/NoAlarm.)
    devicename: "(First Floor->Dinning Room) Dinning table lamp" // (the node will output the complete path of your house, including the device name, or the node's name in case you've <b>not imported the ETS file</b> )) 
    knx: 
        event: "GroupValue_Write" // (or "GroupValue_Response", or "GroupValue_Read")
        dpt: "1.001" // (If you've <b>not imported the ETS file</b>, this represents the datapoint used to try to decode the telegram)
        dptdesc: "Humidity" // (payload's measure unit description)
        source: "15.15.22"
        destination: "0/1/2" // (Contains the Group Address of the incoming telegram, same as topic)
        rawValue: buffer[1]raw // (or null, if "GroupValue_Read")
            0: 0x0 // (This is the RAW undecoded value)
    }}
 

Aquí encontrará una muestra de dispositivo virtual

 {
   topic: '5/0/1',
   payload: true,
   devicename: 'Light Status',
   event: 'Update_NoWrite',
   eventdesc: "The value has been updated from another node and hasn't been received from KNX BUS",
   previouspayload: true
 }
 

El nodo acepta MSG del flujo que se enviará al bus KNX y envía MSG al flujo tan pronto como el mensaje KNX llega desde el bus.
Suponiendo que proporcionó una dirección de grupo y un punto de datos al nodo, ya sea manualmente o con campos de población automática seleccionando su dispositivo desde la lista del dispositivo después de importar el archivo ETS.
También puede anular uno o más parámetros establecidos en la ventana de configuración KNX-Uultimate.
Todas las propiedades a continuación son opcionales, excepto por la carga útil.
** Msg.Destination**
Por ejemplo, "0/0/1". Establezca la dirección de grupo de 3 niveles que desea actualizar. ** msg.payload**
Por ejemplo, verdadero/falso/21/"Hola". Establezca la carga útil que desea enviar al autobús KNX. ** msg.event**
"GroupValue \ _Write": escribe el telegrama al autobús KNX.
"GroupValue \ _Response": envía un telegrama de respuesta al bus KNX.
"Actualizar \ _nowrite": envía nada al bus KNX, solo actualiza el valor interno del nodo Ulimado KNX. Esto es útil si solo desea almacenar el valor en el nodo y leerlo más tarde con una solicitud de lectura.
PRECAUCIÓN: en el caso de _msg.event = "update \ _nowrite" _ Todos los nodos con la misma dirección de grupo emitirán al flujo un mensaje como este:

{
  topic: '5/0/1',
  payload: true,
  devicename: 'Light Status',
  event: 'Update_NoWrite',
  eventdesc: "The value has been updated from another node and hasn't been received from KNX BUS",
  previouspayload: true
}

Si desea emitir un comando "Leer", use "ReadStatus" en su lugar (ver más abajo).
** msg.readstatus = true**
Emita un comando de "leer" al bus. ** msg.dpt**
Por ejemplo "1.001". Establece el punto de datos . (Puede escribirlo en estos formatos: 9, "9", "9.001" o "DPT9.001") ** msg.writeraw **
msg.bitlenght
Escribe datos sin procesar en el bus KNX. Consulte a continuación un ejemplo.
** msg.resetrbe**
pase msg.resetrbe = true a un nodo de dispositivo, para restablecer tanto el filtro de entrada como de salida RBE en ese nodo particular.

Es posible cambiar programáticamente la configuración del nodo Ulimado KNX, enviando msg.setConfig Object al nodo.
Consulte aquí la página de muestra.

Puede más muestras aquí ** Encienda una lámpara**

// Example of a function that sends a message to the KNX-Ultimate
msg.payload = true; // issues a write or response (based on the options <b>Telegram type</b> above) to the KNX bus
return msg;

``` ** ABSOLUTO Dim una lámpara** <br/>

```javascript

// Example of a function that sends a message to the KNX-Ultimate
msg.payload = 30; // issues a write or response (based on the options <b>Telegram type</b> above) to the KNX bus
return msg;

``` ** Enviar texto a una pantalla** <br/>

```javascript

// Example of a function that sends a message to the KNX-Ultimate
msg.payload = "Output Tem. 35°C"; // issues a write or response (based on the options <b>Telegram type</b> above) to the KNX bus
return msg;

``` ** Lea el estado de la lavadora** <br/>

```javascript

// Example of a function that sends a read status message to the KNX-Ultimate
// Issues a read request to the KNX bus. You'll expect a 'response' from the bus. You need to select the **React to response telegrams** option.
// The node will react to the KNX Response telegram coming from the BUS.
msg.readstatus = true; // issues a write or response (based on the options <b>Telegram type</b> above) to the KNX bus
return msg;

``` ** Enviar valor bruto al bus** <br/>

Para enviar un valor de búfer en bruto al bus KNX, use el _ ** escritorw ** _ y _**bitLenght** _ Propiedades de la entrada de MSG. <br/>
En este caso, se ignorará el _datapoint_ que establece en la ventana de la propiedad. <br/>
Softe un nodo de función frente a KNX-Ulimate y pegue su código:

```javascript

// If you encode the values by yourself, you can write raw buffers with writeraw.
// The bitlenght is necessary for datapoint types where the bitlenght does not equal the buffers bytelenght * 8. This is the case for dpt 1 (bitlength 1), 2 (bitlenght 2) and 3 (bitlenght 4).
// Write raw buffer to a groupaddress with dpt 1 (e.g light on = value true = Buffer<01>) with a bitlength of 1
msg.writeraw = Buffer.from('01', 'hex'); // Put '00' instead of '01' to switch off the light.
msg.bitlenght = 1;
return msg;

// Temperature sample (uncomment below and comment above)
// Write raw buffer to a groupaddress with dpt 9 (e.g temperature 18.4 °C = Buffer<0730>) without bitlength
// msg.writeraw = Buffer.from('0730', 'hex');
// msg.bitlenght = 1;
// return msg;

``` ** Actualice el valor del nodo sin enviarlo al bus** <br/>

```javascript

msg.event = "Update_NoWrite";
msg.payload = true;
return msg;

Aquí tiene 2 opciones: Importar archivo CVS ETS o no.
Importar su archivo ETS es el método sugerido Aboslute . Si importa su archivo ETS, solo necesita establecer la carga útil para transmitir. El nodo hará la codificación de punto de datos automáticamente.
Si no importa el CSV ETS, también debe pasar el tipo de punto de datos al nodo.
** Apague una lámpara con el archivo ETS importado**

// Example of a function that sends a message to the KNX-Ultimate
msg.event = "GroupValue_Write";
msg.destination = "0/0/1"; // Set the destination 
msg.payload = false; // issues a write or response (based on the options <b>Telegram type</b> above) to the KNX bus
return msg;

``` ** Apague una lámpara <u> sin </u> archivo ETS importado** <br/>

```javascript

// Example of a function that sends a message to the KNX-Ultimate
msg.event = "GroupValue_Write";
msg.destination = "0/0/1"; // Set the destination 
msg.dpt = "1.001"; 
msg.payload = false; // issues a write or response (based on the options <b>Telegram type</b> above) to the KNX bus
return msg;

``` ** Lea el estado de todos los dispositivos KNX <u> con el archivo </u> ETS importado** <br/>
No puede emitir una solicitud de lectura a todos los grupos si no importa su archivo ETS, porque el nodo no puede saber en los dispositivos para enviar la solicitud de lectura.

```javascript

// Example of a function that sends a read status message to the KNX-Ultimate
// Issues a read request to the KNX bus. You'll expect a 'response' from the bus. You need to select the **React to response telegrams** option.
// The node will react to the KNX Response telegram coming from the BUS.
msg.readstatus = true; // issues a write or response (based on the options <b>Telegram type</b> above) to the KNX bus
return msg;

• Configuración de la puerta de enlace
• Protección de referencia circular y protección contra inundaciones
• samples
  • muestras

Coloros de estado del nodo Explicación
img>	reaccionar para escribir telegramas
	Protección de referencia circular. ver esta página.
	Reaccionar a los telegramas de respuesta.
img>	Auto envía el valor del nodo como respuesta al bus. ver dispositivo virtual.
	Reaccionar a leer telegramas.
	RBE Filtro: no se han enviado telegramas.
	Error o desconectado.
	Nodo discapacitado debido a una referencia circulare. ver esta página.