---
title: Ajouter ou modifier une passerelle Modbus dans Boss’nX
description: "Ajouter ou modifier une passerelle Modbus dans Boss’nX. Boss’nX : ouvrir Passerelles Modbus avec Gérer le Modbus et choisir Nouvelle passerelle ou une ligne, préparer nom IPv4 port et…"
canonical: https://wiki.can-nx.com/guides/boss-modbus-gateway-create/
language: fr
product: Boss’nX
audience:
  - administrateur
  - installateur
context: Supervision autonome ou ouverte depuis hypervision ; FR/EN ; KNX consultation ordinateur/mobile, Modbus configuration ordinateur
---

# Ajouter ou modifier une passerelle Modbus dans Boss’nX

Contexte : Supervision autonome ou ouverte depuis hypervision ; FR/EN ; KNX consultation ordinateur/mobile, Modbus configuration ordinateur

Pour un administrateur ou un installateur ayant le droit **Gérer le Modbus**. Préparez les paramètres confirmés de l’installation : adresse IPv4, port Modbus TCP et passerelle CannX qui doit joindre cet accès. Une passerelle peut être partagée par des points Boss’nX et des configurations de comptage ; vérifiez les usages concernés avant de modifier une entrée existante.

## Ouvrir le formulaire

1. Ouvrez la supervision voulue, directement ou depuis l’hypervision.
2. Sur ordinateur, choisissez **Réglages → Passerelles Modbus**, éventuellement dans **Plus**.
3. Pour ajouter une entrée, cliquez sur **Nouvelle passerelle** au-dessus de la liste. Le formulaire apparaît à droite.
4. Pour modifier une entrée, cliquez sur sa ligne à gauche : le panneau **Modifier la passerelle** affiche ses paramètres. Vérifiez le nom avant toute modification.

Si un formulaire est déjà ouvert et que vous souhaitez commencer une autre création ou duplication, choisissez d’abord **Annuler**, puis ouvrez l’action voulue. **Annuler** ferme les modifications en attente ; après **Enregistrer**, revenir aux anciens paramètres demande une nouvelle modification et une sauvegarde.

## Renseigner les champs

| Champ | Valeur à fournir |
| --- | --- |
| **Nom** | Un libellé non vide permettant de reconnaître l’accès, par exemple **Chaufferie test**, exemple fictif. |
| **Adresse IP** | L’adresse IPv4 confirmée de l’accès Modbus TCP, sans espace. Le formulaire ne prend pas un nom d’hôte à la place de cette adresse. |
| **Port** | Un entier de **1 à 65535**. La création propose **502** ; conservez ou changez cette valeur selon la configuration réelle. |
| **Passerelle CannX** | Sélectionnez la passerelle prévue par l’installateur. Les options présentent son nom et sa MAC. Vérifiez cette sélection même si une première option est déjà proposée. |
| **Activée** | Cochez selon l’utilisation prévue. Lisez les conséquences d’une désactivation dans [gérer les passerelles Modbus](https://wiki.can-nx.com/guides/boss-modbus-gateway-manage/). |

Une passerelle présente dans la liste de choix n’est pas nécessairement en ligne. Si aucune **Passerelle CannX** n’est proposée, faites vérifier le bon projet et son rattachement ; ne choisissez pas un autre équipement au hasard.

## Enregistrer et vérifier

1. Cliquez sur **Enregistrer**.
2. Attendez **Enregistré avec succès.** et la fermeture du formulaire.
3. Retrouvez l’entrée dans la liste, puis cliquez sur sa ligne pour relire le nom, l’adresse, le port, la passerelle CannX et **Activée**.
4. Vérifiez ensuite le fonctionnement des points ou configurations associés selon la procédure de l’installation. L’enregistrement des paramètres ne constitue pas un test de communication avec le matériel.

Pour abandonner avant sauvegarde, cliquez sur **Annuler**. Si vous devez corriger une valeur déjà enregistrée, rouvrez l’entrée, modifiez le champ voulu et enregistrez à nouveau.

## Si la création ou la modification bloque

**Ce champ est requis.** : renseignez le nom ou la passerelle CannX manquants. **Adresse IP invalide.** : vérifiez les quatre nombres de l’IPv4 et retirez les espaces. **Port invalide (1–65535).** ou refus de validation du navigateur : saisissez le port entier confirmé dans cette plage.

**Vous n'avez pas la permission de voir cette page** : faites vérifier le droit **Gérer le Modbus** sur votre rôle. Un compte de consultation ne suffit pas. Pour un menu absent, vérifiez aussi le contexte de supervision et **Plus**.

**Erreur lors de l'enregistrement.** : relevez le message et les champs concernés. Si la sauvegarde semble avoir réussi mais que la ligne manque, effacez d’abord la recherche de la liste, puis quittez et rouvrez **Passerelles Modbus** pour vérifier. Ne recréez pas immédiatement une entrée identique. Si la situation reste incertaine, contactez **support@can-nx.com** avec la supervision, le nom de l’entrée, le message et vos essais ; aucun mot de passe ou lien privé n’est nécessaire.

En anglais : **Settings → Modbus gateways**, **New gateway**, **Edit gateway**, **Name**, **IP Address**, **Port**, **CannX Gateway**, **Enabled**, **Save**, **Cancel**, **Saved successfully.**

Pour utiliser la passerelle dans un composant, ajoutez ensuite [un point Modbus](https://wiki.can-nx.com/guides/boss-point-modbus/). La déclaration de la passerelle ne crée pas ce point automatiquement.

Pour définir les mesures à relever sur un accès déjà déclaré, suivez [les configurations Modbus du monitoring](https://wiki.can-nx.com/guides/boss-modbus-config/).