Création en masse d'équipements Modbus – Portail d'assistance Wattsense

parcourir

Cet article explique comment ajouter votre propre équipement Modbus dans la console Wattsense.

Si vous souhaitez ajouter un équipement Modbus à la console, vous pouvez d'abord vérifier si votre équipement est déjà disponible dans la bibliothèque officielle : Librairie d'équipements décodés.

Si ce n'est pas le cas, n'hésitez pas à nous contacter : nous l'ajouterons pour vous.
Cependant, si vous possédez un équipement avec des registres Modbus spécifiques (exemple : automate programmable), vous devrez ajouter toutes les propriétés manuellement dans la console. Si votre équipement possède trop de propriétés, vous pouvez utiliser l'importation en masse via un fichier CSV.

Comment procéder ?

Équipement (Description et protocole de communication)

Dans la console Wattsense, accédez à l'onglet Configuration / Équipement / Ajouter un équipement

Article.BulkCreationForModbusEquipement.AddEquipment.FR.jpg

Sur la page suivante, choisir l'option Mode avancé :

Article.BulkCreationForModbusEquipement.AddEquipmentAutre.FR.png

Donnez un nom et une description de l'équipement. Précisez le protocole Modbus (RTU ou IP).

Article.BulkCreationForModbusEquipement.AddEquipmentRTU.FR.jpg

Article.BulkCreationForModbusEquipement.AddEquipmentIP.FR.jpg

Modbus RTU : Sélectionnez Modbus RTU si l'équipement est connecté à la Box via un câble série (RS 485).	Modbus IP : Sélectionnez Modbus IP si l'équipement est connecté via un câble Ethernet.

Afin d'établir une communication entre la box et votre équipement, vous devrez renseigner les paramètres suivants :

• Adresse esclave = Les équipements sont identifiés par des numéros uniques (1-247).
• Vitesse = 9600, 19200, 38400 … bauds
• Parité = Aucune, Paire, Impaire
• Data bits = 8 …
• Stop bits = 1 …

• Adresse IP
• Port 502
• Adresse esclave

Où trouver ces paramètres ?
Vous pouvez consulter la documentation du fabricant et/ou la configuration de l'équipement, si disponible.

Équipement (propriétés)

Une fois les paramètres du protocole configurés, vous devrez renseigner les descriptions des propriétés.

Article.BulkCreationForModbusEquipement.AddProperty.FR.jpg

À ce stade, vous pouvez ajouter les propriétés une par une à l'aide du bouton « Ajouter une propriété », ou les importer via un fichier CSV, ce qui est plus rapide, surtout si vous possédez de nombreuses propriétés.

Vous devrez obtenir la liste des registres (table d'échange). (Source : documentation du fabricant ou de l'administrateur de l'équipement dans le cas d'un appareil programmable.)

En général, la table des registres Modbus se présente comme suit :

Article.BulkCreationForModbusEquipement.Example.png

Dans cet exemple, les adresses des registres figurent dans la première colonne.
La colonne R/W indique si la propriété est accessible en lecture/écriture (Read/Write)
Une autre information très importante est présente dans l'en-tête du document : tous les registres sont des entiers signés sur 16 bits (Signed integer, Holding registers).

Voici un autre exemple :

Article.BulkCreationForModbusEquipement.Example2.png

Dans cet exemple, les adresses des registres se trouvent dans les première et deuxième colonnes (50512 en décimal = C550 en hexadécimal).
Nombre de mots : indique le nombre de registres 16 bits = 2 x 16 = 32 bits (ici affecté à U32 = entier non signé 32).
V/100 : une mise à l'échelle de 1/100 doit être appliquée à la valeur brute. (mise à l'échelle A = 0,01)

Format de fichier pour l'importation groupée dans la console Wattsense

Une fois toutes les descriptions de registre collectées, vous pouvez préparer le fichier CSV.
Téléchargez le modèle depuis l'interface :

Article.BulkCreationForModbusEquipement.BulkMode.FR.jpg

Article.BulkCreationForModbusEquipement.DownloadTemplate.FR.jpg

Le contenu de ce fichier est le suivant :

name,description,accessType,registerAddress,function (1/2/3/4),secondaryFunction (5/6/16),dataFormat,numberOfRawRegisters,scaling_a,scaling_b

Comment le remplir ?

Colonne	Description	Format	Exemple
name	nom de la propriété	Texte	Damper 2 Led close
description	Description de la propriété	Texte	1 = On ; 0 = Off
accesstype	Type d'accès	LOCAL READ WRITE READ_WRITE	READ
registerAddress	Adresse de registre	Parfois l'adresse est en hexadecimal dans la documentation (ex 0xA8 or A8h, Vous devez la convertir en décimal. A8h -> 168)	4
function	Fonction modbus	(1/2/3/4) 01 - Read Output Coils 02 - Read Discrete Inputs 03 - Read Holding Register 04 - Read Input Registers	3
Secondary function	Fonction modbus secondaire	(5/6/16) 05 - Write Single Output 06 - Write Holding Register 16 - Write Multiple Holding Register
dataformat	Format de la donnée (*)	int16 uint16 int64_be uint64_be int32_abcd int32_badc int32_cdab int32_dcba uint32_abcd uint32_badc uint32_cdab uint32_dcba f32_abcd f32_badc f32_cdab f32_dcba raw_bytes	Int16
numberOfRawRegisters	Nombre de Raw registers	Number of raw bytes in case Data format = _bytes	0
scaling_a	Scaling A = coefficient A dans la formule Ax+B	Il peut arriver qu'une mise à l'échelle doive être appliquée à la propriété pour transformer correctement un entier en valeur flottante. Le format de correction est Ax + B. Par exemple, pour une propriété de température, si A = 0,1 et que la donnée lue est 38, la valeur finale de température est 3,8 °C.	1
scaling_b	Scaling B = coefficient B dans la formule Ax+B	Offset (B) de la correction d'échelle.	0

(*) convention de nommage

u = unsigned f = float

Big endian (be) = ABCD little endian = DCBA Mid Little endian = CDAB

Veuillez noter que les objets Modbus (types de registres) disposent des fonctionnalités d'accès suivantes :
• Coil (lecture-écriture)
• Discrete Input (lecture seule)
• Input register (lecture seule)
• Holding register (lecture-écriture)

Par conséquent, la combinaison (type d'accès / fonction / fonction secondaire) doit être l'une des suivantes :

Type d'objet	Type d'accès	Fonction	Fonction secondaire
Coils	READ	01 - Read Output Coils
Coils	WRITE	05 - Write Single Output
Coils	READ_WRITE	01 - Read Output Coils05	05 - Write Single Output
Holding register	READ	03 - Read Holding Register
Holding register	WRITE	06 - Write Holding Register (or 16)
Holding register	READ_WRITE	03 - Read Holding Register	06 - Write Holding Register (or 16)
Discrete Inputs	READ	02 - Read Discrete Inputs
Input Registers	READ	04 - Read Input Registers

Le fichier CSV a le format suivant :

Séparateur de champs = , ou ;
Utilisez le point (0.01) comme séparateur pour les nombres décimaux (car , est utilisé comme séparateur de champs).
Format UTF8 (pour les caractères accentués)
Ne modifiez pas les colonnes de noms d'en-tête. Elles doivent être identiques au modèle, sinon le fichier CSV ne sera pas importé et un message d'erreur s'affichera.

Voici le contenu csv du premier exemple ci-dessus :

Article.BulkCreationForModbusEquipement.ExampleTable.png