Paramètres de nœud de périphérique KNX-ultimate

Ce nœud vous permet de contrôler une adresse de groupe KNX, c’est le nœud le plus utilisé.

Ici, vous trouverez quelques échantillons

Configuration

Bouton de commande manuelle

L’éditeur peut afficher, pour chaque nœud, un petit bouton permettant d’envoyer un télégramme KNX sans ajouter de nœud Inject supplémentaire.

Le bouton n’est visible que si l’option est activée. En mode universel, l’action de lecture est désactivée car l’adresse de groupe ne serait pas connue.

OPP OPTIONS AVANCES

Fonction ## Tab KNX

Vous pouvez utiliser JavaScript pour modifier le comportement du msg d’entrée provenant du flux et du télégramme de sortie envoyé au bus KNX.
L’éditeur de code intégré fournit des objets et des fonctions utiles pour récupérer la valeur de toutes les adresses de groupe, à la fois avec le fichier ETS importé et sans (spécifiant le point de données).
Le script s’appelle à chaque fois que le nœud reçoit un msg du flux ou un télégramme du bus KNX.
S’il est activé, l’indication “f (x)” sera ajoutée au nom du nœud.

Liste d’objets et de fonctions communes que vous pouvez utiliser dans le code

du bus KNX à la broche de sortie du nœud

Dans cet échantillon, nous enverrons le msg d’entrée au bus KNX uniquement si un autre GA a une valeur opposée.
Nous allons allumer la lumière uniquement si son statut GA est éteint, et vice versa.

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;
}

Ici, si quelqu’un allume la lumière, nous allumons une autre lumière 0/1/8 et après 2 secondes, nous éteignons la lampe connectée au nœud.

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

De KNX Bus à la broche ouput de Node

Dans cet échantillon, nous émettons l’objet MSG à l’écoulement, en ajoutant la valeur d’un autre GA à la sortie msg.
Le msg ouput au flux aura également la température externe dans la propriété «msg.externaltemperature»

// 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;

Dans cet autre échantillon, nous n’émettons pas de msg au flux, au cas où msg.payload et une autre valeur GA sont tous deux faux.

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;
}

onglet Échantillon de charge utile

entrées

** destination (chaîne) ** : l’adresse du groupe de destination, par exemple 1/1/0. Seul le niveau 3 est autorisé. charge utile (any) ** : La charge utile à envoyer. Peut être par exemple vrai ou faux, ou un objet. **Événement (chaîne) ** : Peut être GroupValue \ _Write pour écrire le télégramme dans le bus KNX, GroupValue \ _Response pour envoyer un télégramme de réponse au bus KNX, update \ _nowrite. Update \ _nowrite envoie des rien au bus KNX, met à jour la valeur interne du nœud KNX-ultime. Ceci est utile si vous voulez seulement stocker la valeur dans le nœud et le lire plus tard avec une demande de lecture. **readStatus (boolean) ** : émettez une demande de lecture au bus KNX. Passer true à chaque fois (msg.readstatus = true). **DPT (String) ** : Par exemple “1.001”. Définit le point de données. **Writeraw (tampon) ** : est utilisé pour envoyer une valeur au bus KNX, en tant que tampon. Utilisez en conjonction avec Bitlenght. **bitlenght (int) ** : Spécifie le long du tampon writeraw. Utilisez en conjonction avec WriteRaw. **restrbe (boolean) ** : réinitialise les filtres RBE internes (USE msg.resetrbe = true). **SetConfig (JSON) : Modifiez par programme l’adresse de groupe de nœuds de périphérique KNX-ultimate et DataPoint. Voir les détails.

Détails

msg.setConfig: Il est possible de modifier par programme la configuration du nœud KNX-ultime, en envoyant l’objet msg.setConfig au nœud. La nouvelle configuration sera conservée jusqu’au prochain msg.setconfig ou jusqu’à redémarrage / redéployer. Toutes les propriétés (setGroupAddress et setDpt) ** sont obligatoires** ..
Utilisez-le comme ça, dans un nœud Functon: ** Définissez GA et DPT**

// 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;

** Définissez GA et lisez le point de données à partir du fichier ETS**

// 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;

sorties

1. Sortie standard

   charge utile (chaîne

   numéro

   objet) \ **: la broche 1 est la sortie standard de la commande.

2. Erreurs

   erreur (objet) \ **: PIN 2 contient le message d’erreur détaillé.

Détails

msg.payload est utilisé comme charge utile de l’adresse du groupe (la valeur d’adresse du groupe). Il s’agit plutôt d’un exemple de l’objet MSG complet.

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)
    }
}

entrées

: destination (chaîne) \ **: l’adresse du groupe de destination, par exemple le 1/1/0. Seul le niveau 3 est autorisé. \

charge utile (any) \ **: la charge utile à envoyer. Peut être par exemple vrai ou faux, ou un objet.

événement (String) \ **: peut être GroupValue \ _Write pour écrire le télégramme dans le bus KNX, GroupValue \ _Response pour envoyer un télégramme de réponse au bus KNX, update \ _NowRite. Update \ _nowrite envoie des rien au bus KNX, met à jour la valeur interne du nœud KNX-ultime. Ceci est utile si vous voulez seulement stocker la valeur dans le nœud et le lire plus tard avec une demande de lecture.

ReadStatus (booléen) \ **: émettez une demande de lecture au bus KNX. Passer true à chaque fois (msg.readstatus = true).

dpt (String) \ **: Par exemple “1.001”. Définit le point de données.

Writeraw (tampon): est utilisé pour envoyer une valeur au bus KNX, en tant que tampon. Utilisez en conjonction avec Bitlenght.

bitlenght (int): spécifie le long du tampon writeraw. Utilisez en conjonction avec WriteRaw.

ressetrbe (boolean) \ **: réinitialise les filtres RBE internes (USE msg.resetrbe = true).

setConfig (JSON) \ **: modifier par programme l’adresse de groupe de nœuds de périphérique KNX-ultimate et le point de données. Voir les détails.

Détails

msg.setConfig: Il est possible de modifier par programme la configuration du nœud KNX-ultime, en envoyant l’objet msg.setConfig au nœud. La nouvelle configuration sera conservée jusqu’au prochain msg.setconfig ou jusqu’à redémarrage / redéployer. Toutes les propriétés (setGroupAddress et setDpt) ** sont obligatoires** ..
Utilisez-le comme ça, dans un nœud Functon: ** Définissez GA et DPT**

// 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;

** Définissez GA et lisez le point de données à partir du fichier ETS**

// 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;

sorties

1. Sortie standard

   charge utile (chaîne

   numéro

   objet) \ **: la broche 1 est la sortie standard de la commande.

2. Erreurs

   erreur (objet) \ **: PIN 2 contient le message d’erreur détaillé.

Détails

msg.payload est utilisé comme charge utile de l’adresse du groupe (la valeur d’adresse du groupe). Il s’agit plutôt d’un exemple de l’objet MSG complet.

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)
    }
}

Sortie du message de l’ensemble de nœuds comme “Mode universel (écoutez toutes les adresses de groupe)”

Ici, vous avez 2 options: Importer le fichier CVS ETS ou non.

L’importation de votre fichier ETS est la méthode Aboslute suggérée . Si vous importez votre fichier ETS, le nœud fera automatiquement le décodage de points de données et vous donnera également le nom de l’appareil.

Si vous n’importez pas l’ETS, le nœud sortira le télégramme brut et il essaie également de le décoder.

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)
    }}
 

Message de sortie dans l’appareil virtuel

Ici, vous trouverez un échantillon de Virtual Device

{
   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
 }
 

Message de flux d’entrée

Contrôle des appareils KNX

Le nœud accepte le MSG de l’écoulement à envoyer au bus KNX et envoie MSG au flux dès que le message KNX arrive du bus.

En supposant que vous avez fourni une adresse de groupe et un point de données au nœud, soit manuellement ou avec des champs de population automatique en sélectionnant votre appareil dans la liste de l’appareil après avoir importé le fichier ETS.

Vous pouvez également remplacer un ou plusieurs paramètres définis dans la fenêtre de configuration KNX-ultimate.

Toutes les propriétés ci-dessous sont facultatives, à l’exception de la charge utile. ** msg.Destination**

Par exemple, “0/0/1”. Définissez l’adresse de groupe à 3 niveaux que vous voulez mettre à jour. ** msg.payload**

Par exemple, true / false / 21 / “Bonjour”. Définissez la charge utile que vous souhaitez envoyer au bus KNX. ** msg.event**

“GroupValue \ _Write”: écrit le télégramme au bus KNX.

“GroupValue \ _Response”: envoie un télégramme de réponse au bus KNX.

“Update \ _Nowrite”: envoie des rien au bus KNX, met à jour la valeur interne du nœud KNX-ultime. Ceci est utile si vous ne voulez stocker la valeur que dans le nœud et le lire plus tard avec une demande de lecture.

ATTENTION: Dans le cas de _msg.event = “Update \ _Nowrite” _ Tous les nœuds avec la même adresse de groupe émettra à l’écoulement un msg comme ceci:

{
  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 vous souhaitez émettre une commande “lire”, veuillez utiliser “ReadStatus” à la place (voir ci-dessous). ** msg.readstatus = true**

Émettez une commande “lire” au bus. ** msg.dpt**

Par exemple “1.001”. Définit le datapoint . (Vous pouvez l’écrire dans ces formats: 9, “9”, “9.001” ou “DPT9.001”) ** msg.writeraw ** msg.bitlenght

Écrit des données brutes au bus KNX. Veuillez voir ci-dessous un exemple. ** MSG.RESETRBE** PASS MSG.RESETRBE = VRAI À un nœud de périphérique, pour réinitialiser à la fois l’entrée et la sortie du filtre RBE sur ce nœud particulier.

modifier par programme la configuration du nœud via MSG

Il est possible de modifier par programme la configuration du nœud KNX-ultimate, en envoyant un objet msg.setConfig au nœud.

Veuillez consulter ici l’exemple de page.

Quick comment faire

Vous pouvez plus d’échantillons ici ** Allumez une lampe**

// 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;

** Absolute dim a lampe**

// 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;

** Envoyer du texte à un affichage**

// 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;

** Lisez l’état de la machine à laver**

// 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;

Envoyez la valeur brute au bus

Pour envoyer une valeur de tampon brute au bus KNX, utilisez les propriétés _ ** writerraw ** _ et _bitlenght _ de l’entrée msg.

Dans ce cas, le datapoint que vous définissez dans la fenêtre de propriété sera ignoré.

Grapez un nœud de fonction devant KNX-ultime et collez son code:

// 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;

Mettez à jour la valeur du nœud sans l’envoyer au bus

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

Contrôle des périphériques KNX avec le nœud réglé sur “Mode universel (écoutez toutes les adresses de groupe)”

Ici, vous avez 2 options: Importer le fichier CVS ETS ou non.

L’importation de votre fichier ETS est la méthode Aboslute suggérée . Si vous importez votre fichier ETS, il vous suffit de définir la charge utile pour être transmise. Le nœud fera automatiquement le codage de DataPoint.

Si vous n’importez pas l’ETS CSV, vous devez également passer le type de point de données au nœud. Éteignez une lampe avec le fichier ETS importé

// 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;

Éteignez une lampe sans ETS importé

// 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;

** Lisez l’état de tous les périphériques KNX avec ets Fichier importé**

Vous ne pouvez pas émettre une demande de lecture à tous les groupes si vous n’importez pas votre fichier ETS, car le nœud ne peut pas savoir sur les appareils pour envoyer la demande de lecture.

// 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;

Voir aussi

• Configuration de la passerelle
• Protection des références circulaires et protection contre les inondations
• Sample

  • Échantillons

    </tr>

    Couleurs d'état du nœud Explication
    </ img> </ td>	réagir aux télégrammes d'écriture
    </ img> </ td>	Protection de référence circulaire. Voir cette page. </ td> </tr>

    <TD> réagir aux télégrammes de réponse. </td>
    </tr>
    <tr>
        <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/bluering.png"> </img> </td>
        <TD> Auto Envoi de la valeur du nœud comme réponse au bus. <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/-sample---virtual-device" cible = "_ Blank"> Voir le périphérique virtuel. </a> </ td>
    </tr>
    <tr>
        <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/greudot.png"> </ img> </ td>
        <TD> réagir aux télégrammes de lecture. </td>
    </tr>
    <tr>
        <td> <img src = "https://raw.githubusercontent.com/supergiovane/node-red-contrib-knx-ultimate/master/img/greyring.png"> </ img> </ td>
        <TD> Filtre RBE: aucun télégramme n'a été envoyé. </td>
    </tr>
    <tr>
        <td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/reddot.png" alt="Red status dot" /></td>
        <td> Erreur ou déconnecté. </td>
    </tr>
    <tr>
        <td><img src="https://raw.githubusercontent.com/Supergiovane/node-red-contrib-knx-ultimate/master/img/redring.png" alt="Red status ring" /></td>
        <TD> Node désactivé en raison d'une référence circulare. <a href = "https://supergiovane.github.io/node-red-contrib-knx-ultimate/wiki/Protections" Target = "_ Blank"> Voir cette page. </a> </ td>
    </tr>
</ table>