> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/french/function-blocks/blocks-reference/input-output/communication/modbus-connect.md).

# Modbus Connect

Ce bloc de fonction établit une connexion Modbus TCP vers un appareil distant et fournit en sortie une référence réutilisable `Modbus Client` que d'autres blocs peuvent utiliser pour effectuer des lectures/écritures.

## 📥 Entrées <a href="#inputs" id="inputs"></a>

Ce bloc de fonction n'a pas d'entrées.

## 📤 Sorties <a href="#outputs" id="outputs"></a>

* `Modbus Client` — Une référence de client Modbus connectée, à brancher sur des blocs de communication pour lire ou écrire des registres.

## 🕹️ Contrôles <a href="#controls" id="controls"></a>

* `IP Address` — Saisissez l'adresse IP du serveur Modbus TCP (par exemple 192.168.0.10).
* `TCP Port` — Saisissez le port Modbus TCP (par défaut : 502).

## ⚙️ Mécanisme d'exécution <a href="#running-mechanism" id="running-mechanism"></a>

* Lorsqu'il est évalué, le bloc tente de se connecter au serveur Modbus à l'adresse et au port indiqués dans les contrôles.
* Si l'adresse ou le port change, ou si la connexion est perdue, le bloc essaiera de se reconnecter automatiquement et continuera à fournir une sortie `Modbus Client` à jour pour les autres blocs.
* Les autres blocs reçoivent le `Modbus Client` via la sortie et l'utilisent pour effectuer les opérations de communication (lectures/écritures).

## 🎯 Fonctionnalités <a href="#features" id="features"></a>

* Connexion persistante partagée : plusieurs blocs peuvent utiliser le même client.
* Reconnexion automatique en cas de changement d'adresse ou de perte de connexion.
* Contrôles simples dans l'interface pour configurer l'IP et le port.

## 📝 Comment l'utiliser <a href="#usage" id="usage"></a>

1. Renseignez `IP Address` et `TCP Port` dans les contrôles.
2. Lancez le scénario — le bloc établira la connexion et fournira le `Modbus Client` en sortie.
3. Branchez la sortie `Modbus Client` aux blocs de communication qui en ont besoin (par exemple pour lire/écrire) afin d'effectuer des opérations Modbus.

## 💡 Astuces <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Pour lire des données régulièrement, connectez la sortie `Modbus Client` au bloc `Modbus Read` et utilisez un `Logic Input` ou un autre déclencheur pour contrôler les lectures.
* Pour écrire des commandes ou des valeurs, alimentez `Modbus Client` dans `Modbus Write` et déclenchez l'écriture avec une entrée logique uniquement quand nécessaire.
* Transmettez la télémétrie vers des systèmes distants en combinant avec `MQTT Publish` (connectez la sortie d'un bloc de lecture vers `MQTT Publish`).
* Sauvegardez ou consignez les valeurs en envoyant les sorties de lecture vers `SQL-DB Operations` ou `CSV Export` pour un stockage persistant et une analyse ultérieure.
* Utilisez `Debug Input` ou `Scope` pour inspecter les valeurs issues des blocs de lecture lors de la configuration et du dépannage.

(hint: recommended companion blocks — `Modbus Read`, `Modbus Write`, `Logic Input`, `MQTT Publish`, `SQL-DB Operations`, `CSV Export`, `Debug Input`, `Scope`)

## 🛠️ Résolution des problèmes <a href="#troubleshooting" id="troubleshooting"></a>

* Connexion refusée ou timeout — vérifiez que `IP Address` et `TCP Port` sont corrects et que le serveur Modbus est accessible sur le réseau.
* Règles de pare-feu ou réseau — assurez-vous que le port Modbus TCP est autorisé sur les pare-feu des deux côtés.
* Connexions multiples — si le serveur limite le nombre de connexions, évitez d'en créer plusieurs simultanées ; partagez la sortie `Modbus Client` fournie avec les autres blocs.
* Si la connexion semble instable, vérifiez la qualité du réseau et essayez un câble ou un port de switch différent.