--- title: "Modbus-Datenpunkt in Boss’nX konfigurieren: Register lesen und schreiben" description: "Modbus-Register aus einer Boss’nX-Komponente lesen oder schreiben: Gateway, Unit ID, Funktionscodes, Datentyp, Skalierungsfaktor und Signalausfallalarm." canonical: https://wiki.can-nx.com/de/guides/boss-point-modbus/ language: de product: Boss’nX audience: - administrateur - installateur context: "Boss’nX am Computer: Komponenteneditor, Datenpunkt mit dem Protokoll Modbus" --- # Modbus-Datenpunkt in Boss’nX konfigurieren: Register lesen und schreiben Kontext: Boss’nX am Computer: Komponenteneditor, Datenpunkt mit dem Protokoll Modbus Im Komponenteneditor von Boss’nX liest ein Modbus-Datenpunkt ein Register eines Geräts, das über ein Modbus-TCP-Gateway erreicht wird, schreibt einen Befehl hinein oder überwacht einen Signalausfall. Sie stellen Gateway, Unit ID, Register und Funktionscodes, die Decodierung des Werts und dann seine Darstellung auf der Komponentenkarte ein. Für Administratoren und Installateure mit **Manage components** (Komponenten verwalten), in der betreffenden Supervision, am Computer. Um in einem Schritt nur lesende Datenpunkte aus vorhandenen Konfigurationen anzulegen, verwenden Sie stattdessen [den Modbus-Import aus dem Monitoring](https://wiki.can-nx.com/de/guides/boss-import-modbus/). Von Komponenten unabhängige Verlaufserfassungen werden unter [Data logging → Modbus registers](https://wiki.can-nx.com/de/guides/boss-modbus-config/) (Datenaufzeichnung → Modbus-Register) konfiguriert. ## Bevor Sie beginnen - Das Modbus-Gateway ist [in Boss’nX angelegt](https://wiki.can-nx.com/de/guides/boss-modbus-gateway-create/). - Unit ID und Registertabelle des Geräts sind vom Installateur bestätigt. Die Beispiele dieser Anleitung sind fiktiv. ## Den Modbus-Datenpunkt hinzufügen 1. Öffnen Sie **Components** (Komponenten) in Ihrer Leiste oder über **Menu → Components** (Menü → Komponenten), und klicken Sie dann auf das Stiftsymbol **Edit component** (Komponente bearbeiten) auf der Karte. Für eine neue Komponente verwenden Sie **Add component** (Komponente hinzufügen); Name und Standort sind in [dem gemeinsamen Formular](https://wiki.can-nx.com/de/guides/boss-component-edit/) beschrieben. 2. Klicken Sie auf **Add point** (Datenpunkt hinzufügen) oder suchen Sie den vorhandenen Datenpunkt. 3. Wählen Sie in der Kopfzeile des Datenpunkts **Modbus** und geben Sie dann sein **Label** (Bezeichnung) ein. 4. Aktivieren Sie seine Funktionen in derselben Kopfzeile: **Feedback** (Statusrückmeldung) für das Lesen, **Cmd** (Befehl) für einen Befehl. Deaktivieren Sie **Cmd**, wenn der Datenpunkt nur lesen soll. Das Kontrollkästchen **Alarm** dient der weiter unten beschriebenen Überwachung des Signalausfalls. 5. Wählen Sie das **Modbus gateway** (Modbus-Gateway). Diese Auswahl ist vom allgemeinen **Gateway** der Komponente getrennt: Prüfen Sie Name, Adresse und Port, die in der Liste angezeigt werden. 6. Geben Sie **Unit ID** ein, eine für das Gerät bestätigte ganze Zahl von **1 bis 247**. ## Register und Decodierung ausfüllen 1. Wenn die Einstellungen eingeklappt sind, klicken Sie auf **Show options** (Optionen anzeigen). 2. Für das Lesen geben Sie **Feedback register** (Rückmelderegister) und **Function code (read)** (Funktionscode, Lesen) ein. 3. Für einen Befehl geben Sie **Command register** (Befehlsregister) und **Function code (write)** (Funktionscode, Schreiben) ein. 4. Wählen Sie **Data type** (Datentyp) und prüfen Sie dann beide Funktionscodes erneut. 5. Geben Sie **Scale factor** (Skalierungsfaktor), die Leseoptionen und bei Bedarf **Advanced (swap bytes / words)** (Erweitert, Bytes/Wörter tauschen) gemäß der Tabelle des Geräts ein. | Einstellung | Auswahl und Prüfung | | --- | --- | | **Function code (read)** | **1 — Read Coils**, **2 — Read Discrete Inputs**, **3 — Read Holding Registers**, **4 — Read Input Registers**. Das Formular schlägt Code **3** vor: Verwenden Sie den für das Register vorgesehenen Code. | | **Function code (write)** | **5 — Write Single Coil**, **6 — Write Single Register**, **16 — Write Multiple Registers**. Die Liste bietet alle diese Codes an: Lassen Sie bestätigen, dass das Gerät den gewählten Schreibvorgang akzeptiert. | | **Data type** | Vorgeschlagen wird **UINT16**. **INT16 / UINT16** belegen ein Wort; **INT32 / UINT32 / FLOAT32** zwei Wörter. Wählen Sie den Typ, der der Codierung des Geräts entspricht. | | **Scale factor** | Bei einem numerischen Lesewert wird der decodierte Wert mit diesem Faktor multipliziert; bleibt das Feld leer, gilt 1. Fiktives Beispiel: **215 × 0.1 = 21.5**. Ein numerischer Befehl verwendet die umgekehrte Umrechnung: Lassen Sie einen Faktor ungleich null und den Befehlsbereich bestätigen, bevor Sie einen Befehl senden. | | **Poll interval (s)** (Abfrageintervall in Sekunden) | Vorgeschlagen mit **10 Sekunden**, mindestens **5 Sekunden**. Wählen Sie einen zur Installation passenden Takt. | | **Swap bytes / Swap words** (Bytes tauschen / Wörter tauschen) | Kontrollkästchen, die über **Advanced (swap bytes / words)** angezeigt werden. Stellen Sie sie gemäß der für das Gerät bestätigten Byte- und Wortreihenfolge ein, nicht durch wiederholtes Ausprobieren, bis ein plausibler Wert erscheint. | | **Save to history (1 pt/min)** (Im Verlauf speichern, 1 Punkt/min) | Leseoption, die höchstens einen Punkt pro Minute speichert. Sie garantiert weder einen Messwert pro Minute noch die Wiederherstellung alter Werte. | Die Schaltfläche **= feedback register** (= Rückmelderegister), deren Tooltip **Reuse the feedback register address** (Adresse des Rückmelderegisters übernehmen) lautet, kopiert nur die Leseadresse in den Befehl. Verwenden Sie sie nur, wenn die Tabelle des Geräts dieselbe Adresse für das Schreiben vorsieht; sie prüft keine Schreibfähigkeiten. Der Schreibcode wird je nach Lesecode und Typ vorgeschlagen: Lesen **1/2 → Schreiben 5**; andernfalls ein Typ mit einem Wort **→ 6**, mit zwei Wörtern **→ 16**. Der Hinweis **auto:** rechts neben dieser Schaltfläche zeigt Typ, vorgeschlagenen Code und Anzahl der Wörter. **Eine Änderung von Data type kann den bereits gewählten Schreibcode ersetzen.** Prüfen Sie nach jeder Änderung beide Codes und vergleichen Sie sie mit der Tabelle des Geräts. ## Darstellung und Befehl wählen ### Numerischer Wert Wählen Sie für einen Datenpunkt ohne **Alarm** ausdrücklich **Format d'affichage → Numeric** (Anzeigeformat → Numerisch). Mit **Cmd** geben Sie **Min**, **Max** und **Pas** (Schrittweite) passend zu den zulässigen Befehlen ein und wählen dann **Display style → + / − buttons (current)** (Anzeigestil → Schaltflächen + / −, aktuell) oder **Slider** (Schieberegler). Im Nur-Lese-Modus werden diese Befehlseinstellungen nicht angeboten. **Unit** (Einheit) gibt die angezeigte Einheit an; die Modbus-Umrechnung wird unter **Scale factor** eingestellt. Zur Bedienung dieser Befehle auf der Karte siehe [das Einstellen eines numerischen Werts](https://wiki.can-nx.com/de/guides/boss-command-numeric/). ### Werteliste Wählen Sie **Value list** (Werteliste), klicken Sie dann auf **+ Add value** (Wert hinzufügen) und geben Sie in jeder Zeile die erwartete Zahl und ihr **Label** ein. Entfernen Sie eine unnötige Zeile mit ihrem Papierkorb. Mit **Cmd** kann der Stil **Dropdown (current)** (Dropdown, aktuell) oder **Buttons** (Schaltflächen) sein. Im Nur-Lese-Modus übersetzt die Liste die empfangenen Werte in Bezeichnungen. ### Boolescher Wert und Impuls Ein Datenpunkt, der mit Code **1** oder **2** gelesen oder ohne Leseregister mit Code **5** angesteuert wird, gilt als boolesch. Die Einstellungen **Valeur si VRAI** (Wert bei wahr), **Label si VRAI** (Bezeichnung bei wahr), **Valeur si FAUX** (Wert bei falsch), **Label si FAUX** (Bezeichnung bei falsch) und **Couleur** (Farbe) ersetzen dann die numerischen Optionen. Prüfen Sie die Bedeutung der Werte **1/0**. Mit **Cmd** sendet **Pulse (impulse relay)** (Impuls, Stromstoßschalter) bei jedem Tastendruck denselben Wert: **1**, oder **0**, wenn **Send 0 (instead of 1)** (0 senden statt 1) aktiviert ist. **Button label (optional)** (Beschriftung der Schaltfläche, optional) passt ihren Text an. Diese Einstellung legt weder eine Dauer noch eine automatische Folge **1 dann 0** fest. Siehe [Schaltflächen und Impulse](https://wiki.can-nx.com/de/guides/boss-command-buttons/). ### Bestätigung, Tag und ausstehende Installation Aktivieren Sie mit **Cmd** bei Bedarf **Confirm command** (Befehl bestätigen) in der Kopfzeile: Vor dem Senden aus dem Dashboard wird dann eine Bestätigung verlangt. Prüfen Sie auch **Tag**, beschrieben in [der Verwaltung der Tags](https://wiki.can-nx.com/de/guides/boss-tags-assign/), und **Pending installation** (Installation ausstehend). Diese Markierung ist keine Befehlssperre; ihre Anzeige ist in [der Komponentenkarte](https://wiki.can-nx.com/de/guides/boss-component/) beschrieben. ## Signalausfall überwachen 1. Fügen Sie einen eigenen Datenpunkt hinzu oder suchen Sie den vorgesehenen Alarm-Datenpunkt, wählen Sie **Modbus** und aktivieren Sie **Alarm**. 2. Prüfen Sie **Modbus gateway**, **Unit ID**, **Feedback register**, **Function code (read)**, **Data type** und die Leseeinstellungen. 3. Geben Sie **Poll interval (s)** und dann **No signal — delay (s)** (Signalausfall, Verzögerung in Sekunden) ein. Die Verzögerung muss mindestens **das Dreifache des Abfrageintervalls** betragen: Bei **10 Sekunden** beträgt das Minimum **30 Sekunden**. 4. Speichern Sie und öffnen Sie dann den Datenpunkt erneut, um beide Dauern zu prüfen. Um diese Überwachung zu entfernen, leeren Sie **No signal — delay (s)** und speichern Sie erneut. Solange der Datenpunkt als **Pending installation** markiert ist, wird kein Alarm erzeugt. Der Alarm meldet, dass während der Verzögerung kein Wert empfangen wurde; die Hardware-Ursache muss an der Installation gesucht werden. Dieses Modbus-Formular bietet nur diese Verzögerung an, ohne Einstellungen für Schwellenwert, Vergleich oder Schweregrad. Für einen Temperaturalarm oder einen anderen Bedarf, dessen Einstellungen nicht geklärt sind, wenden Sie sich an den Support. ## Lesetest ausführen und speichern Bei aktiviertem **Feedback** liest **Test the reading** (Lesetest) das Register mit den eingegebenen Einstellungen, auch vor dem Speichern. Diese Schaltfläche testet keinen Befehl. Um das Ergebnis zu interpretieren, folgen Sie [dem Test und der Fehlerbehebung eines Modbus-Datenpunkts](https://wiki.can-nx.com/de/guides/boss-point-modbus-help/). 1. Verlassen Sie das letzte Feld und prüfen Sie dann die Einstellungen. 2. Klicken Sie auf **Create** (Erstellen) oder **Save** (Speichern). Die Oberfläche kehrt zur Ausgangsseite zurück. Vor dem Speichern verwirft **Back** (Zurück) die ausstehenden Änderungen. Öffnen Sie nach dem Speichern den Datenpunkt erneut, korrigieren Sie ihn und speichern Sie erneut; ein bereits auf der Installation ausgeführter Befehl wird nicht rückgängig gemacht. ## Ergebnis prüfen 1. Öffnen Sie die Komponente erneut und prüfen Sie die gespeicherten Einstellungen, insbesondere beide Funktionscodes und die Dauern. 2. Sehen Sie die Komponentenkarte ein und vergleichen Sie den angezeigten Wert mit dem erwarteten Messwert. 3. Bei einem Befehl senden Sie ihn von der Karte aus und beobachten das Gerät oder seine Rückmeldung. Das Speichern sichert die Konfiguration; die Kommunikation mit dem Gerät wird an der Installation geprüft. ## Fehlerbehebung - **Create** oder **Save** abgelehnt, eine Meldung von **Test the reading**, ein unplausibler Wert oder ein Befehl ohne Wirkung: Folgen Sie [dem Test und der Fehlerbehebung eines Modbus-Datenpunkts](https://wiki.can-nx.com/de/guides/boss-point-modbus-help/). - **Min**, **Max** und **Pas** fehlen: Prüfen Sie, ob **Cmd** aktiviert, **Alarm** deaktiviert und **Format d'affichage → Numeric** gewählt ist. Besteht das Problem weiter, wenden Sie sich an support@can-nx.com. Französische Bezeichnungen: **Composants**, **Menu**, **Ajouter un composant / Modifier le composant**, **Ajouter un point**, **Cmd / Re.Etat / Alarme**, **Passerelle Modbus**, **Unit ID**, **Afficher les options / Masquer les options**, **Registre retour d'état**, **Code fonction (lecture)**, **Registre commande**, **Code fonction (écriture)**, **= registre retour d'état**, **Type de données**, **Facteur d'échelle**, **Intervalle de scrutation (s)**, **Avancé (swap bytes / words)**, **Enregistrer dans l'historique (1 pt/min)**, **Absence de signal — délai (s)**, **Tester la lecture**, **Confirmation envoi commande**, **Créer / Enregistrer / Retour**. Die Bezeichnungen **Format d'affichage**, **Pas**, **Valeur si VRAI**, **Valeur si FAUX**, **Label si VRAI**, **Label si FAUX** und **Couleur** bleiben auf Französisch; die Auswahlmöglichkeiten sind **Numérique / Liste de valeurs**, **Style d'affichage**, **Slider**, **Menu déroulant (actuel)** oder **Boutons**.