BACnet
Relier des équipements de gestion technique du bâtiment en BACnet/IP : instance d'équipement, adressage par type et instance d'objet, découverte Who-Is et presentValue.
Le pilote BACnet parle à des équipements de gestion technique du bâtiment en BACnet/IP. Chaque tag lit la valeur présente d'un objet BACnet : la lecture en direct d'une entrée analogique, l'état d'une sortie binaire, la position d'une valeur multi-états. Ajoutez un équipement sous le pilote BACnet dans le Connector; le volet ne montre que les champs que ce protocole emploie.
Connexion
| Champ | Sens | Par défaut |
|---|---|---|
| Hôte | L'adresse IP ou le nom d'hôte de l'équipement BACnet (ou du routeur qui répond pour lui). Un nom est résolu en son adresse IPv4 quand l'équipement se connecte; un nom que cet ordinateur ne sait pas résoudre laisse l'équipement sans connexion, et le motif le dit. | vide |
| Port | Le port UDP de l'équipement, de 1 à 65535. Un champ vide affiche 47808, le standard BACnet/IP, en gris et l'équipement est joint sur ce port; un équipement enregistré avec 0 se lit de la même façon. | 47808 |
| Identifiant d'équipement | Le numéro d'instance de l'équipement, le numéro de son objet Device, unique sur le réseau BACnet. | 0 |
L'en-tête de l'équipement montre l'endpoint assemblé, par exemple
bacnet://192.168.0.30:47808/1234. La connexion envoie une requête sur la taille
de la liste d'objets de l'équipement pour confirmer qu'il répond; la liste d'objets
elle-même n'est pas parcourue. Cette réponse est la connexion : un équipement qui ne répond pas
reste hors ligne au lieu de paraître connecté, et la raison (le port UDP
déjà pris, une adresse qui n'en est pas une) est écrite sur la page Événements
et dans le fichier journal du jour. Ce pilote n'a aucun champ d'intervalle de scrutation :
ses tags sont lus une fois par seconde.
Adressage
Un tag BACnet est adressé par deux champs typés de la carte Source de la valeur du tag, sans adresse en texte libre :
| Champ | Sens | Valeurs acceptées | Par défaut |
|---|---|---|---|
| Type d'objet | Quelle sorte d'objet BACnet lire. | les neuf types ci-dessous | AnalogInput |
| Numéro d'instance | Le numéro d'instance de l'objet dans son type. | 0 et au-delà | 0 |
Les types d'objet offerts et leurs codes de type BACnet standard :
| Type d'objet | Code | La valeur présente porte |
|---|---|---|
AnalogInput |
0 | un nombre mesuré |
AnalogOutput |
1 | un nombre commandé |
AnalogValue |
2 | un nombre enregistré |
BinaryInput |
3 | inactif ou actif |
BinaryOutput |
4 | inactif ou actif |
BinaryValue |
5 | inactif ou actif |
MultiStateInput |
13 | un numéro d'état à partir de 1 |
MultiStateOutput |
14 | un numéro d'état à partir de 1 |
MultiStateValue |
19 | un numéro d'état à partir de 1 |
AnalogInput 5 sur l'équipement 1234 veut dire « la valeur présente de l'entrée analogique 5 de
cet équipement ». Chaque lecture demande la propriété presentValue de l'objet; les autres
propriétés ne sont pas adressables. La ligne en lecture seule Adresse source (bus) de la
carte Source de la valeur montre la paire type,instance assemblée au fil de vos modifications.
Types de donnée
Le sélecteur de Type de donnée offre quatre types. Choisissez celui qui correspond à l'objet :
| Type de donnée | Convient à | Remarques |
|---|---|---|
| Float | les objets analogiques | une valeur présente Real; les doubles sont ramenés à Float |
| Boolean | les objets binaires | une valeur présente booléenne, ou les 0 et 1 énumérés que répond un objet binaire |
| Int32 | les valeurs multi-états et les autres valeurs entières | les réponses signées, non signées et énumérées arrivent toutes ici |
| String | les valeurs de chaîne de caractères | le texte tel que l'équipement l'envoie |
Le type choisi doit correspondre à ce que porte l'objet. Un équipement qui répond avec autre chose fait échouer la lecture de ce tag : le tag passe en mauvaise qualité et la raison nomme ce qui est arrivé (« L'équipement a répondu une valeur Single pour un point déclaré Entier. »), au lieu qu'un nombre converti n'entre dans la courbe, dans l'historique et dans les alarmes. Lire un objet analogique en booléen, ou un Real en Int32, est exactement ce cas. Le reste de l'équipement continue de lire; rien n'est reconnecté à cause d'un tag dont le type est faux.
Un tag dont l'équipement n'a pas l'objet voit sa lecture échouer avec la réponse
de l'équipement lui-même : la raison dit que l'équipement n'a aucun objet à cette
adresse et nomme l'erreur qu'il a envoyée (ERROR_CODE_UNKNOWN_OBJECT), si bien
qu'une adresse erronée se distingue d'un équipement qui a cessé de répondre.
L'équipement reste connecté.
Écritures
Les tags dont l'Accès est Lecture et écriture ou Écriture seule peuvent être écrits. Une écriture
pose le presentValue de l'objet dans le type que la norme BACnet prévoit pour cette sorte
d'objet, peu importe le type de donnée du tag :
| Objet | Écrit en | Accepte |
|---|---|---|
| Entrée, sortie ou valeur binaire | Enumerated | inactif (0) ou actif (1), à partir d'un tag Boolean ou d'un Int32 égal à 0 ou 1 |
| Entrée, sortie ou valeur multi-états | Unsigned | un numéro d'état à partir de 1 |
| Entrée, sortie ou valeur analogique | Real | un nombre à partir d'un tag Float ou Int32 |
| Tout autre type d'objet | le type de donnée du tag | un Float un Real, un booléen un Boolean, un Int32 un entier signé, un texte une chaîne de caractères |
Aucune priorité de commande n'accompagne l'écriture. Une valeur que l'objet ne peut pas porter, comme 0 pour un objet multi-états ou 2 pour un objet binaire, est refusée avant tout envoi, et le refus en donne la raison. Quand l'équipement répond à l'écriture par une erreur, le tag rapporte la classe et le code d'erreur que l'équipement a envoyés au lieu de feindre un succès, et l'équipement reste connecté. Un nouveau tag démarre en Lecture seule.
Découverte
Le bouton Découvrir du Connector diffuse un Who-Is BACnet et écoute les réponses I-Am pendant 10 secondes. Chaque équipement qui répond devient un candidat portant son adresse, son port et son instance d'équipement, prêt à ajouter avec les champs de connexion remplis, et il paraît dans la liste dès qu'il répond plutôt qu'à la fin des dix secondes : un balayage que vous annulez à mi-chemin garde tout ce qui avait déjà répondu. Le balayage ne parcourt pas les objets : les candidats arrivent donc avec zéro tag; ajoutez vous-même les paires de type et d'instance d'objet.
Le Who-Is part sur le réseau que désigne la carte Portée du balayage. Sa case
prend une adresse IPv4 de ce réseau, celle d'un équipement ou celle de cet ordinateur
sur ce réseau (par exemple 192.168.1.20), et le balayage ne diffuse alors que sur ce
réseau. Laissée vide, le Who-Is part sur tous les réseaux de cet ordinateur : un
ordinateur avec deux cartes réseau, un VPN ou Docker trouve ainsi les équipements de
chacun. Ce qui n'est pas une adresse IPv4 écrite au complet est refusé sous la case,
et Découvrir reste grisé tant que ce n'est pas corrigé.
Un équipement qui répond par un routeur BACnet s'ajoute de la même façon. Son candidat porte l'adresse du routeur et, à côté, le réseau et l'adresse propres à l'équipement sur ce réseau; les deux sont conservés quand vous l'ajoutez, et chaque lecture est envoyée au routeur en nommant l'équipement à l'intérieur. Un équipement trouvé ainsi se lit donc comme tout autre, et son endpoint indique « équipement par un routeur ». Un équipement ajouté à la main n'a pas de route et est atteint directement à son hôte.
Bon à savoir
- BACnet/IP seulement : un équipement MS/TP ou BACnet/SC n'est joignable que par un routeur qui le présente en BACnet/IP, et c'est le balayage qui le trouve : la route sur laquelle un équipement répond est conservée depuis le balayage, alors ajoutez-le depuis la liste découverte plutôt que de taper ses champs à la main.
- Sur un ordinateur doté de plusieurs interfaces réseau (deux cartes réseau, un VPN, Docker), chaque équipement est joint par l'interface vers laquelle cet ordinateur achemine son adresse, celle que tout autre programme ici utiliserait; il n'y a rien à choisir.
- Seul le socket qui écoute les messages des équipements occupe le port UDP BACnet standard 47808 de cette station, si bien qu'une autre application BACnet qui tient ce port de façon exclusive sur le même ordinateur peut entrer en conflit avec lui. Les requêtes vers un équipement partent d'un port que le système choisit pour chaque client.
- La scrutation est fixée à une seconde pour chaque tag de ce pilote; les champs habituels d'intervalle de scrutation ne sont pas montrés.