--- title: Eine Modbus-Registerabfrage für den Verlauf in Boss’nX konfigurieren description: "Erfassen Sie einen Modbus-TCP-Zähler alle 60 s in Boss’nX: Register, Funktionscode 3 oder 4, Datentyp, Unit-ID, Skalierung, Vertauschungen, Live-Test." canonical: https://wiki.can-nx.com/de/guides/boss-modbus-config/ language: de product: Boss’nX audience: - administrateur - installateur context: "Boss’nX, Supervision am Computer: Menu → Data logging, Registerkarte Modbus registers" --- # Eine Modbus-Registerabfrage für den Verlauf in Boss’nX konfigurieren Kontext: Boss’nX, Supervision am Computer: Menu → Data logging, Registerkarte Modbus registers In Boss’nX legt die Registerkarte **Modbus registers** (Modbus-Register) der Seite **Data logging** (Datenaufzeichnung) fest, welche Modbus-TCP-Register für den Verlauf erfasst werden, zum Beispiel ein Zähler oder eine Temperatur, mit einem vorgesehenen Intervall von sechzig Sekunden. Jede Konfiguration beschreibt einen Wert: Gateway, Register, Funktionscode, Typ, Unit-ID, Skalierung und Bytereihenfolge. Für Administratoren und Installateure. Diese Konfigurationen sind von den Modbus-Datenpunkten einer Komponente getrennt, die [eigene Abfrage- und Verlaufseinstellungen](https://wiki.can-nx.com/de/guides/boss-point-modbus/) haben. ## Bevor Sie beginnen - Ihre Rolle verfügt über **Manage components** (Komponenten verwalten). Sie arbeiten in der betreffenden Supervision, am Computer. - Die Leseparameter des Geräts sind bestätigt: Modbus-Zugang, Registeradresse, Typ, Länge, Unit-ID, Skalierung und Byte- oder Wortreihenfolge. Die Werte in dieser Anleitung sind fiktiv. ## Liste der Modbus-Konfigurationen öffnen 1. Öffnen Sie in der Supervision **Menu → Data logging** (Menü → Datenaufzeichnung) in der Familie **Integration**. 2. Wählen Sie die Registerkarte **Modbus registers** neben **KNX addresses** (KNX-Adressen). Die Registerkarte **KNX addresses** dient dazu, [die aufzuzeichnenden KNX-Adressen auszuwählen](https://wiki.can-nx.com/de/guides/boss-knx-monitoring/). 3. Prüfen Sie den Titel **Modbus Configurations** (Modbus-Konfigurationen). Die Zeilen sind nach Gateway gruppiert und zeigen **Name**, **Register**, **Type** (Typ) und **Unit ID**. So finden Sie eine Konfiguration: - Die Leiste **Search by address, component or label…** (Nach Adresse, Komponente oder Label suchen…) durchsucht hier Name, Registeradresse und Datentyp, ohne Groß- und Kleinschreibung oder Akzente zu beachten. - Ein Chip mit dem Namen eines Gateways beschränkt die Liste auf dieses Gateway. Klicken Sie erneut auf denselben Chip, um diesen Filter zu entfernen. - Die Spaltenüberschriften ändern die Sortierreihenfolge. ## Eine Messwertkonfiguration erstellen 1. Ist bereits ein Formular geöffnet, speichern Sie es oder verwerfen Sie es mit **Cancel** (Abbrechen). Prüfen Sie, ob es geschlossen ist, bevor Sie eine neue Konfiguration oder eine Duplizierung beginnen. 2. Klicken Sie über der Liste auf **New configuration** (Neue Konfiguration). Das Formular öffnet sich rechts. 3. Prüfen Sie **Gateway**: Eine erste Auswahl kann automatisch vorgeschlagen werden. Wählen Sie den tatsächlich vorgesehenen Modbus-Zugang. 4. Geben Sie einen nicht leeren, gut erkennbaren **Name** ein. 5. Füllen Sie die Parameter der folgenden Tabelle aus, verlassen Sie das letzte Feld und prüfen Sie dann das Formular. | Feld | Zu bestätigender Parameter | | --- | --- | | **Register address** (Registeradresse) | Ganzzahlige Adresse, positiv oder null, die für den Messwert vorgesehen ist. Lassen Sie die Adressierungskonvention bestätigen: Ziehen Sie von der Nummer in einem Handbuch nicht pauschal einen Versatz ab. | | **Word length** (Wortlänge) | Leselänge, ganzzahlig und mindestens eins: ein Wort für einen 16-Bit-Wert, zwei Wörter für einen 32-Bit-Wert. Die Auswahl des Typs füllt dieses Feld nicht aus: Prüfen Sie es nach jedem Typwechsel. | | **Function code** (Funktionscode) | Zum Lesen eines Registers der bestätigte Code: **3 — Read Multiple Holding Registers** oder **4 — Read Input Registers**. Prüfen Sie die Tabelle des Geräts, bevor Sie von einem zum anderen wechseln. | | **Data type** (Datentyp) | **INT16**, **UINT16**, **INT32**, **UINT32** oder **FLOAT32**, je nach Kodierung des Werts. Vorzeichen und Darstellung müssen zum Gerät passen. | | **Unit ID** | Ganzzahlige Kennung des Modbus-Geräts, von 1 bis 247. Sie ist nicht die Registernummer. | | **Scale factor** (Skalierungsfaktor) | Multiplikator, der auf den gelesenen Wert angewendet wird. Fiktives Beispiel: Ein Faktor **0.1** macht aus einem Rohwert **215** den Wert **21.5**. | | **Swap Bytes** (Bytes tauschen) | Vertauscht die Bytes innerhalb der Wörter, nur wenn die Kodierung des Geräts es erfordert. | | **Swap Words** (Wörter tauschen) | Vertauscht die Reihenfolge der Wörter, nur wenn dies für diesen Wert vorgesehen ist. | Fiktives Beispiel: **Name Vorlauftemperatur**, korrektes **Gateway** bestätigt, **Register address 100**, **Word length 2**, **Function code 3**, **Data type FLOAT32**, **Unit ID 3**, Faktor **1** und Vertauschungen gemäß Handbuch. Lassen Sie diese Parameter bestätigen, bevor Sie sie für eine Installation übernehmen. Das Erhöhen von **Word length** erzeugt nicht mehrere Konfigurationen: Legen Sie eine Konfiguration pro Wert an. Die Liste **Function code** bietet auch Codes für binäre Eingänge und Schreibvorgänge an; für diese Verwendungen lesen Sie [die in der Fehlerbehebung beschriebenen Grenzen](https://wiki.can-nx.com/de/guides/boss-modbus-config-help/). Wird kein passendes Gateway angeboten, klicken Sie oben auf der Seite auf den Link **Integration › Modbus gateways** (Integration › Modbus-Gateways) und [legen Sie den Modbus-Zugang an](https://wiki.can-nx.com/de/guides/boss-modbus-gateway-create/). Diese Seite enthält keine Schaltfläche zum Erstellen eines Gateways, und die Gateway-Verwaltung erfordert eigene Berechtigungen: Lassen Sie diese vom Administrator prüfen. ## Testen und dann speichern **Live test** probiert die aktuell im Formular eingetragenen Parameter aus, ohne sie zu speichern. Seine Ergebnisse und Fehler werden in [der Anleitung zu Test und Fehlerbehebung](https://wiki.can-nx.com/de/guides/boss-modbus-config-help/) erklärt. 1. Klicken Sie auf **Save** (Speichern). **Saving…** (Wird gespeichert…) zeigt den laufenden Vorgang an. 2. Warten Sie auf **Saved successfully.** (Erfolgreich gespeichert.) und darauf, dass sich das Formular schließt. Vor dem Speichern schließt **Cancel** das Formular und verwirft Ihre Eingaben. Ein bereits erfolgtes Speichern macht es nicht rückgängig: Öffnen Sie zum Korrigieren die Zeile erneut, ändern Sie die Werte und speichern Sie erneut. ## Eine Konfiguration bearbeiten oder duplizieren Zum Bearbeiten klicken Sie auf die Zeile, prüfen ihren Namen und ihr Gateway, korrigieren die nötigen Felder und speichern dann. So erstellen Sie einen ähnlichen Messwert aus einer vorhandenen Konfiguration: 1. Schließen Sie zuerst jedes geöffnete Formular: nach dem Speichern, falls Sie das beabsichtigen, oder mit **Cancel**. 2. Klicken Sie in der Quellzeile rechts auf das Symbol mit zwei Blättern **Duplicate** (Duplizieren). 3. Prüfen Sie den Titel **Duplicate configuration** (Konfiguration duplizieren), den übernommenen Namen und die Parameter der richtigen Quelle. 4. Vergeben Sie einen eigenen Namen und passen Sie die Parameter des neuen Messwerts an, insbesondere Register und Unit-ID, die nicht standardmäßig beibehalten werden dürfen. 5. Klicken Sie auf **Save**. Die Duplizierung erzeugt eine zusätzliche Konfiguration und behält die Quelle bei. Prüfen Sie, ob zwei Konfigurationen desselben Messwerts wirklich gewünscht sind. ## Eine Konfiguration löschen Das Löschen betrifft die Messwertkonfiguration, nicht das Gateway. Auf dieser Seite wird keine Wiederherstellung angeboten. Müssen Sie Verwendungen oder den Verlauf des Messwerts erhalten, wenden Sie sich vor dem Bearbeiten oder Löschen der Konfiguration an den Support: Das Löschen entfernt den gesamten Verlauf weder automatisch noch behält es ihn automatisch. 1. Suchen Sie die genaue Zeile und prüfen Sie ihre Verwendungen. 2. Klicken Sie rechts auf ihr Papierkorbsymbol **Delete** (Löschen). 3. Prüfen Sie in der Browserbestätigung **Delete configuration "…"?** (Konfiguration „…“ löschen?) den Namen und brechen Sie dann ab, um sie zu behalten, oder bestätigen Sie die Löschung. 4. Warten Sie auf **Deleted successfully.** (Erfolgreich gelöscht.). ## Ergebnis prüfen 1. Suchen Sie die Konfiguration in der Liste, nachdem Sie Suche und Gateway-Filter geprüft haben. Prüfen Sie nach einer Duplizierung beide Zeilen; prüfen Sie nach einer Löschung bei entfernten Filtern, dass die Zeile nicht mehr erscheint. 2. Klicken Sie auf die Zeile. Das Formular **Edit Modbus configuration** (Modbus-Konfiguration bearbeiten) öffnet sich rechts: Prüfen Sie das Gateway und alle gespeicherten Parameter. 3. Eine gespeicherte Konfiguration beschreibt die auszuführende Abfrage. Um den Empfang zu prüfen, starten Sie **Live test** und prüfen Sie dann die Messwerte im betreffenden Zeitraum. Um anschließend Datenpunkte von Komponenten aus diesen Konfigurationen zu erstellen, folgen Sie [dem Import der Modbus-Konfigurationen der Verbrauchserfassung](https://wiki.can-nx.com/de/guides/boss-import-modbus/). Dieser Import ist eine einmalige Kopie und erfordert ein separates Speichern der Komponente. ## Fehlerbehebung - **No Modbus configurations.** (Keine Modbus-Konfigurationen.) erscheint auch, wenn Suche oder Filter kein Ergebnis liefern. Leeren Sie die Suche und entfernen Sie den Filter, bevor Sie schließen, dass die Liste leer ist. - Bei einer Fehlermeldung beim Laden, beim Speichern oder während des Tests oder bei einem unstimmigen Wert folgen Sie [der Fehlerbehebung für Modbus-Konfigurationen](https://wiki.can-nx.com/de/guides/boss-modbus-config-help/). Besteht das Problem weiter, wenden Sie sich an support@can-nx.com. Französische Bezeichnungen: **Menu → Historisation → Registres Modbus**; **Configurations Modbus**, **Nouvelle configuration**, **Passerelle**, **Nom**, **Adresse du registre**, **Nombre de mots**, **Code fonction**, **Type de données**, **Unit ID**, **Facteur d'échelle**, **Swap Bytes**, **Swap Words**, **Test en direct**, **Enregistrer**, **Annuler**, **Dupliquer**, **Supprimer**, **Enregistré avec succès.**, **Supprimé avec succès.**, **Aucune configuration Modbus.**