Création de cartes Modbus personnalisées
Comment créer une carte Modbus personnalisée
Aperçu
Le micrologiciel actuel permet au compteur eGauge d'enregistrer des données provenant de périphériques distants via Modbus RTU (à l'aide du convertisseur USB-série USB485) et Modbus TCP (Ethernet). L'éditeur de mappage Modbus permet de définir les adresses Modbus sur l'eGauge pour la lecture des données provenant de matériel tiers.
Prérequis
- L'éditeur de cartes Modbus a été introduit dans le firmware v.4.1. Veuillez consulter cet article pour plus d'informations sur la vérification et la mise à jour des versions de firmware, le cas échéant.
- Des identifiants de connexion valides sont nécessaires pour modifier les paramètres.
- Une table de correspondance Modbus valide pour le matériel tiers que vous souhaitez lire est nécessaire pour définir les registres sur l'eGauge.
- Si le périphérique distant prend en charge SunSpec sur Modbus, il n'est pas nécessaire de créer une table de correspondance Modbus. Configurez-le plutôt comme un périphérique SunSpec, comme décrit dans cet article.
Instructions
Étape 1 : Accédez à l’éditeur de cartes Modbus depuis la page Paramètres d’installation. Dans le menu principal, accédez à Configuration → Autres paramètres , puis sélectionnez Installation dans le volet de gauche. Cliquez ensuite sur le bouton Cartes Modbus dans la section Appareils distants.
Une liste des cartes Modbus existantes sera chargée.
- Si vous utilisez l'interface eGauge classique, cliquez sur Paramètres, puis sur Installation depuis l'écran d'accueil pour accéder à la page des paramètres d'installation. Suivez ensuite les étapes ci-dessous.
Étape 2 : Pour créer une nouvelle carte, cliquez sur l’icône en haut à droite de la page :

Ceci ouvre une nouvelle page.

Saisissez un nom de carte approprié. Ce nom doit généralement identifier le matériel. Il est recommandé d'utiliser le numéro de modèle du matériel. Cliquez sur le bouton « Enregistrer » en bas à droite de la page pour créer une carte vide portant ce nom. L'appareil affichera à nouveau la liste des cartes disponibles, la nouvelle carte (vide) apparaissant en haut. Cliquez dessus pour revenir à la carte vide.
Étape 3 : Pour ajouter des registres, cliquez sur le bouton « Ajouter un registre » . Saisissez les informations requises pour votre registre. Les champs « Échelle » et « Décalage » sont facultatifs ; tous les autres champs sont obligatoires.
Ces informations seront disponibles dans la documentation du matériel tiers. Si elles n'y figurent pas, il sera nécessaire de contacter directement le fabricant du matériel. eGauge Systems ne fournit pas de tables de correspondance Modbus pour le matériel tiers.
Cliquez sur OK pour enregistrer le registre dans votre carte Modbus personnalisée.
À titre d'exemple, le tableau des registres Modbus du fabricant utilisé pour créer le registre ci-dessous est disponible ici : manuel XY-MD02 . Veuillez noter que les tableaux de registres Modbus ne sont pas standardisés et qu'il peut être nécessaire de rechercher les valeurs requises pour la configuration de l'eGauge dans un tableau donné.
Voici un exemple de registre :

Étape 4 : Répétez l’étape 3 pour ajouter des registres supplémentaires si nécessaire.
Étape 5 : Une fois que vous avez terminé d’ajouter des registres à votre carte, cliquez sur Enregistrer dans le coin inférieur droit de la page pour enregistrer les modifications apportées à la carte.
Les sections ci-dessous fournissent des précisions supplémentaires sur chaque paramètre d'enregistrement. Veuillez noter que certains paramètres peuvent ne pas s'appliquer à tous les types de données.
Adresse
Adresse du registre Modbus, au format décimal . Veuillez noter que la documentation Modbus n'est pas uniforme et qu'il peut être nécessaire de modifier l'adresse.
Par exemple, de nombreuses adresses commencent par un 3 ou un 4, mais ce chiffre est généralement omis, ainsi que les zéros qui le précèdent. Ainsi, 30001 devient 1, 40258 devient 258, et ainsi de suite. Certaines adresses peuvent avoir un décalage de +/- 1 ; il faudra donc peut-être saisir 300 au lieu de 301. Enfin, convertissez les valeurs hexadécimales (qui commencent généralement par 0x) en valeurs décimales à l’aide d’un convertisseur hexadécimal-décimal.
Nom du registre
Le nom du registre est arbitraire , mais doit refléter l'élément mesuré par souci de clarté. Par exemple, « Température » désigne une mesure de température. « Température ambiante » serait plus approprié pour un appareil enregistrant plusieurs mesures de température.
Taper
Le type de données du registre . Si ce paramètre est incorrect, les données du registre ne seront pas lues correctement, même si une valeur sera généralement lue. Les types de données 32 et 64 bits permettent de lire plusieurs registres Modbus (un registre Modbus unique est codé sur 16 bits). En l'absence de type de données défini, un registre décrit par une plage d'adresses (par exemple, 10-11 ou 1000-1003) est probablement un registre 32 ou 64 bits.
Ordre des octets
Nécessite la version 4.7 du firmware
Cette option est disponible uniquement pour certains types de données. Si elle n'est pas affichée, elle ne s'applique pas au type de données sélectionné. Le type de données par défaut est big-endian. Les types de données se terminant par un « l » minuscule utilisent par défaut le little-endian et ne peuvent pas être modifiés.
Lorsque vous utilisez des ordres d'octets personnalisés ou non standard, vous devrez peut-être confirmer l'ordre d'octets correct auprès du fabricant du matériel.
Options de valeurs 16 bits : (AB) (BA)
Options de valeur 32 bits : (AB CD) (CD AB) (BA DC) (DC BA) ou une option personnalisée où l'ordre peut être spécifié.
Options de valeur 64 bits : (AB CD EF GH) (GH EF CD AB) (BA DC FE HG) (HG FE DC BA) ou une option personnalisée où l'ordre est spécifié.
Gentil
Le type de caisse enregistreuse . Il existe trois options :
- Analogique – Une simple valeur numérique. La plupart des applications utilisent des valeurs analogiques.
- Bitset - Valeur numérique représentant une chaîne binaire. En général, chaque 1 ou 0 de cette chaîne représente un état du périphérique distant. Cette sélection n'est jamais moyennée ni ne peut s'accumuler, car cela modifierait sa valeur fondamentale.
- Énumération – Valeur numérique représentant un état sur le périphérique distant. Cette valeur n’est jamais moyennée ni ne peut s’accumuler, car cela modifierait sa valeur initiale.
Échelle
Applique un facteur d'échelle à la valeur brute lue depuis le périphérique Modbus . Ce facteur permet d'adapter les valeurs entrantes à un type de données spécifique. Dans l'exemple ci-dessus, le registre de température à l'adresse 1 enregistre la température par incréments de 0,1 °C, tandis que l'eGauge utilise le degré Celsius (°C) comme unité. Une valeur brute de 334 sera donc affichée et enregistrée comme 33,4 degrés Celsius avec un facteur d'échelle de 0,1. Si ce champ est laissé vide, sa valeur par défaut est « 1 ».
Compenser
Applique un décalage numérique à une valeur brute . Ceci peut servir à l'étalonnage (par exemple, si un capteur est connu pour sous-estimer la valeur de 2 unités, un décalage de 2 affichera la valeur de ce capteur comme « valeur_brute + 2 »). Si ce champ est laissé vide, la valeur par défaut est « 0 ».
Unité enregistrée
Associe une unité prise en charge à la valeur enregistrée dans ce registre . Cela attribue une unité au registre dans l'interface utilisateur eGauge. Pour les unités non prises en charge, « Enregistrer comme entier » enregistrera les nombres entiers et « Enregistrer avec 3 chiffres » enregistrera les nombres fractionnaires à trois chiffres (notez que les données entrantes peuvent ne pas être précises à trois chiffres).
Registre d'entrée en lecture seule
L'eGauge permet de lire les valeurs des périphériques distants à l'aide du code de fonction 3 (lecture des registres de maintien) ou du code de fonction 4 (lecture des registres d'entrée). Par défaut, le code de fonction 3 est utilisé. Cependant, certains périphériques ne prennent en charge que le code de fonction 4 ; dans ce cas, la sélection de « lecture seule du registre d'entrée » forcera l'eGauge à utiliser le code de fonction 4 pour ce registre. Notez qu'il est possible d'utiliser simultanément plusieurs codes de fonction sur un même périphérique.
Ajout d'options par défaut
Cette section permet à l'utilisateur de spécifier différentes options de communication pour chaque périphérique. Quatre options peuvent être configurées. Veuillez noter que certaines de ces options sont incompatibles ou non requises selon le type de périphérique. Par exemple, un périphérique série (Modbus RTU) ne possède pas de port TCP par défaut.
Numéro d'unité par défaut

Le numéro d'unité par défaut est également appelé « ID Modbus », « adresse esclave Modbus », « adresse esclave », etc. Chaque périphérique d'une même chaîne série doit posséder un numéro d'unité unique. En général, le matériel est livré avec un numéro d'unité par défaut ; par conséquent, si plusieurs périphériques du même fabricant sont préconfigurés, le numéro d'unité doit être défini sur une valeur unique pour chacun d'eux.
La procédure pour modifier le numéro d'unité d'un appareil dépend du matériel ; veuillez contacter le fabricant du matériel pour obtenir des informations ou des instructions supplémentaires.
Paramètres par défaut du port série

Concerne uniquement les appareils Modbus RTU. La procédure de modification des paramètres série dépend du matériel ; veuillez contacter le fabricant pour obtenir des informations ou des instructions supplémentaires.
La plupart des appareils Modbus RTU sont livrés avec un ensemble prédéfini de paramètres série. Ces paramètres incluent le débit en bauds, le nombre de bits de données, la parité et les bits d'arrêt. Ces paramètres doivent être identiques pour tous les appareils d'une même chaîne série. Si plusieurs appareils identiques sont utilisés, ils doivent tous être configurés avec les mêmes valeurs. En revanche, des appareils de fabricants différents peuvent nécessiter une configuration spécifique afin d'utiliser les mêmes paramètres série.
Port TCP par défaut

S'applique uniquement aux appareils Modbus TCP
La plupart des périphériques Modbus TCP sont livrés avec le port TCP 502 par défaut. Toutefois, dans certains cas, cela peut ne pas être le cas, ou il peut être préférable d'utiliser un autre port TCP. Les ports TCP n'ont pas besoin d'être identiques sur plusieurs périphériques Modbus TCP, même sur le même réseau (chaque périphérique Modbus TCP doit avoir une adresse IP unique ; le port utilisé est donc sans importance).
Adresse de base

Le champ d'adresse de base permet de définir une adresse de départ pour les registres. Ceci peut s'avérer utile si la table Modbus du fabricant présente un décalage de +/-1, ou si toutes les adresses requièrent un préfixe spécifique (par exemple, 30000, 40000, 1000). L'adresse interrogée par l'eGauge sera la somme de l'adresse de base et de l'adresse configurée.
En cas de doute, ce paramètre peut généralement être ignoré.
Partage de cartes Modbus personnalisées
Comment partager des cartes Modbus personnalisées
Aperçu
Si une carte Modbus personnalisée a été créée à l'aide de l'éditeur de cartes Modbus, elle peut être téléchargée et chargée sur un autre compteur eGauge.
Prérequis
- Il s'agit d'un sujet de configuration avancée.
Instructions
Étape 1 : Accédez à l’éditeur de cartes Modbus depuis la page Paramètres d’installation. Dans le menu principal, accédez à Configuration → Autres paramètres , puis sélectionnez Installation dans le volet de gauche. Cliquez ensuite sur le bouton Cartes Modbus dans la section Appareils distants.
Une liste des cartes Modbus existantes sera chargée.
Étape 2 : Repérez la carte personnalisée à télécharger dans la liste et cliquez dessus pour l’ouvrir. Cliquez ensuite sur l’icône « Télécharger la carte », puis sur « OK » pour enregistrer la carte sur votre ordinateur. Notez l’emplacement et le nom du fichier pour pouvoir le retrouver facilement.


Étape 3 : Transférez la carte vers un autre compteur en accédant à l’éditeur de carte Modbus, comme décrit à l’étape 1, depuis l’interface du nouveau compteur. Cliquez sur l’icône « Téléverser une carte depuis un fichier CSV », puis sur le champ « Nom de fichier » pour sélectionner le fichier que vous avez téléchargé sur votre ordinateur à l’étape 2.
Cliquez sur OK pour télécharger la carte sur le nouveau compteur eGauge.