--- title: Configurer un point Modbus dans un composant Boss’nX description: "Configurer un point Modbus dans un composant Boss’nX. Boss’nX : ouvrir un composant et ajouter un point Modbus avec le droit Gérer les composants, choisir la passerelle Modbus du…" canonical: https://wiki.can-nx.com/guides/boss-point-modbus/ language: fr product: Boss’nX audience: - administrateur - installateur context: Supervision autonome ou ouverte depuis hypervision ; éditeur de composants Modbus sur ordinateur ; FR/EN --- # Configurer un point Modbus dans un composant Boss’nX Contexte : Supervision autonome ou ouverte depuis hypervision ; éditeur de composants Modbus sur ordinateur ; FR/EN Pour un administrateur ou un installateur disposant de **Gérer les composants**, dans la supervision concernée, sur ordinateur. Préparez la passerelle, l’identifiant de l’appareil et sa table de registres confirmés par l’installateur. Les exemples ci-dessous sont fictifs ; ils ne donnent pas les paramètres de votre matériel. La passerelle doit être [déclarée dans Modbus](https://wiki.can-nx.com/guides/boss-modbus-gateway-create/). Le choix **Passerelle Modbus** du point est distinct de la **Passerelle** générale du composant. Vérifiez le nom, l’adresse et le port affichés dans sa liste. ## Ouvrir et renseigner le point 1. Ouvrez **Composants**, éventuellement dans **Plus**, puis le crayon **Modifier le composant** sur la carte. Pour une création, utilisez **Ajouter un composant**. Voir [le formulaire commun](https://wiki.can-nx.com/guides/boss-component-edit/) pour le nom et la localisation. 2. Cliquez sur **Ajouter un point**, ou retrouvez le point existant. Choisissez **Modbus** dans son bandeau et renseignez son **Label**. 3. Vérifiez les fonctions : **Re.Etat** pour une lecture, **Cmd** pour une commande. Décochez **Cmd** si le point doit seulement lire. La case **Alarme** sert au parcours d’absence de signal décrit plus bas. 4. Sélectionnez **Passerelle Modbus** et renseignez **Unit ID**, un entier de **1 à 247**, confirmé pour l’appareil. 5. Utilisez **Afficher les options** si les paramètres sont repliés. Pour une lecture, renseignez **Registre retour d'état** et **Code fonction (lecture)** ; pour une commande, renseignez **Registre commande** et **Code fonction (écriture)**. 6. Choisissez **Type de données**, puis revérifiez les deux codes fonction. Renseignez **Facteur d'échelle**, les options de lecture et, si nécessaire, **Avancé (swap bytes / words)** conformément à la table de l’appareil. | Paramètre | Choix et vérification | | --- | --- | | **Code fonction (lecture)** | **1 — Read Coils**, **2 — Read Discrete Inputs**, **3 — Read Holding Registers**, **4 — Read Input Registers**. Utilisez le code prévu pour le registre. | | **Code fonction (écriture)** | **5 — Write Single Coil**, **6 — Write Single Register**, **16 — Write Multiple Registers**. La présence d’un choix ne prouve pas que l’appareil accepte cette écriture. | | **Type de données** | **INT16 / UINT16** occupent un mot ; **INT32 / UINT32 / FLOAT32**, deux mots. Le type doit correspondre à l’encodage de l’appareil. | | **Facteur d'échelle** | Pour une lecture numérique, la valeur décodée est multipliée par ce facteur. Exemple fictif : **215 × 0,1 = 21,5**. Une commande numérique utilise la conversion inverse ; faites confirmer un facteur non nul et la plage appropriée avant de commander. | | **Intervalle de scrutation (s)** | Proposé à **10 secondes**, avec un minimum de **5 secondes**. Conservez une cadence adaptée à l’installation. | | **Swap bytes / Swap words** | Options sous **Avancé (swap bytes / words)**, à régler selon l’ordre des octets et des mots confirmé pour l’appareil. Ne les changez pas successivement au hasard pour obtenir une valeur plausible. | | **Enregistrer dans l'historique (1 pt/min)** | Option de lecture pour conserver au plus un point par minute. Elle ne garantit ni une mesure chaque minute ni la récupération d’anciennes valeurs. | Le bouton **= registre retour d'état**, dont l’infobulle est **Reprendre l'adresse du registre retour d'état**, copie uniquement l’adresse vers la commande. Utilisez-le seulement si l’appareil emploie bien la même adresse. Il ne confirme pas les capacités d’écriture. Un code d’écriture peut être proposé selon la lecture et le type : lecture **1/2 → écriture 5** ; sinon type sur un mot **→ 6**, sur deux mots **→ 16**. **Changer Type de données peut remplacer le code d’écriture déjà choisi.** Relisez toujours les deux codes après un changement ; leur proposition ne remplace pas la table de l’appareil. ## Choisir la présentation et la commande Pour un point numérique hors alarme, choisissez explicitement **Format d'affichage → Numérique**. Avec **Cmd**, renseignez **Min**, **Max**, **Pas**, puis **Style d'affichage → Boutons + / − (actuel)** ou **Slider**. Les bornes doivent correspondre aux commandes autorisées. En lecture seule, ces réglages de commande ne sont pas proposés. **Unité** décrit l’unité affichée ; la conversion Modbus se règle dans **Facteur d'échelle**. Pour une **Liste de valeurs**, utilisez **+ Ajouter une valeur** et renseignez, sur chaque ligne, le nombre attendu et son **Label**. Retirez une ligne inutile avec sa corbeille. Avec **Cmd**, le style peut être **Menu déroulant (actuel)** ou **Boutons**. En lecture seule, la liste traduit les valeurs reçues en libellés. Pour un point booléen, les réglages **Valeur si VRAI / FAUX**, **Label si VRAI / FAUX** et **Couleur** remplacent les options numériques. Vérifiez le sens des valeurs **1/0**. Avec **Cmd**, **Impulsion (télérupteur)** envoie la même valeur à chaque appui : **1**, ou **0** si **Envoyer 0 (au lieu de 1)** est coché. **Label du bouton (optionnel)** personnalise son texte. Ce réglage ne définit pas une durée ni une séquence automatique **1 puis 0**. Voir [utiliser les boutons et impulsions](https://wiki.can-nx.com/guides/boss-command-buttons/). Si souhaité, cochez **Confirmation envoi commande**. Vérifiez également **Tag** et **En attente d'installation** ; ce dernier marquage ne constitue pas un verrou de commande. Voir [les tags](https://wiki.can-nx.com/guides/boss-tags-assign/) et [l’affichage du composant](https://wiki.can-nx.com/guides/boss-component/). ## Configurer une absence de signal 1. Ajoutez un point dédié ou retrouvez le point d’alarme prévu, puis choisissez **Modbus** et cochez **Alarme**. 2. Vérifiez **Passerelle Modbus**, **Unit ID**, **Registre retour d'état**, **Code fonction (lecture)**, **Type de données** et les paramètres de lecture. 3. Renseignez **Intervalle de scrutation (s)**, puis **Absence de signal — délai (s)**. Le délai doit être au moins égal à **trois fois la scrutation** : pour **10 secondes**, le minimum est **30 secondes**. 4. Enregistrez puis rouvrez le point pour vérifier les deux durées. Pour retirer ce suivi, videz **Absence de signal — délai (s)** et enregistrez de nouveau. Ce formulaire Modbus propose le délai d’absence de signal ; il ne propose pas ici de réglages de seuil, de comparaison ou de sévérité. Pour une alarme de température ou un autre besoin dont les paramètres ne sont pas établis, contactez **support@can-nx.com**. Une absence de signal ne permet pas à elle seule d’identifier sa cause matérielle. ## Tester, sauvegarder et relire Avec **Re.Etat**, **Tester la lecture** utilise les paramètres actuellement saisis, même avant sauvegarde. Suivez [le test et le dépannage Modbus](https://wiki.can-nx.com/guides/boss-point-modbus-help/) pour interpréter le résultat. Ce bouton ne teste pas une commande. Quittez le dernier champ, relisez les paramètres puis cliquez sur **Créer** ou **Enregistrer**. Après le retour à la page d’origine, rouvrez le composant et vérifiez les paramètres conservés. Consultez ensuite sa fiche. L’enregistrement ne certifie pas la communication avec l’appareil. Avant sauvegarde, **Retour** abandonne les modifications en attente. Après sauvegarde, rouvrez le point et enregistrez les corrections. Cela n’annule pas une commande déjà exécutée sur l’installation. En anglais : **Components**, éventuellement **More**, **Add component / Edit component**, **Add point**, **Cmd / Feedback / Alarm**, **Modbus gateway**, **Unit ID**, **Show options / Hide options**, **Feedback register**, **Function code (read)**, **Command register**, **Function code (write)**, **= feedback register**, **Data type**, **Scale factor**, **Poll interval (s)**, **Advanced (swap bytes / words)**, **Save to history (1 pt/min)**, **No signal — delay (s)**, **Test the reading**, **Confirm command**, **Create / Save / Back**. Les libellés **Format d'affichage**, **Pas**, **Valeur si VRAI/FAUX**, **Label si VRAI/FAUX** et **Couleur** restent en français ; les choix sont **Numeric / Value list**, **Display style**, **Slider**, **Dropdown (current)** ou **Buttons**. Pour reprendre des configurations de monitoring existantes en lecture seule, consultez [l’import Modbus](https://wiki.can-nx.com/guides/boss-import-modbus/). Pour les configurations de relevés historiques distinctes des points de composants, consultez [Configuration Monitoring → Modbus](https://wiki.can-nx.com/guides/boss-modbus-config/).