Dokumentation
Wie Sie das Gateway anschließen, Modbus-Geräte hinzufügen und das Portal nutzen. Schritt für Schritt, mit den Bildschirmen dazu.
Erste Schritte
Vom Auspacken bis zu den ersten Werten im Portal, in sechs Schritten, die Sie der Reihe nach durchgehen.
6 Seiten
- So funktioniert ModbusCloudDas Gateway liest Ihre Modbus-Geräte aus und sendet die Werte per Kabel oder 4G an das Portal, wo Sie sie ansehen und überwachen.
- Anmelden und Organisation erstellenMelden Sie sich zum ersten Mal im Portal an und erstellen Sie Ihre Organisation, oder schließen Sie sich der Organisation eines Kollegen an.
- Gateway anschließenMontieren Sie das Gateway, schließen Sie Antenne, RS485-Kabel und Netzwerkkabel an und legen Sie zuletzt eine Spannung von 9 bis 57 V DC an.
- Gateway hinzufügenVerknüpfen Sie ein neues Gateway über seine Seriennummer mit Ihrer Organisation und einem Kunden und sehen Sie, wann es online geht.
- Modbus-Geräte hinzufügenFügen Sie dem Gateway Modbus-Geräte hinzu, per automatischer Suche, mit einem Template aus der Bibliothek oder mit einem eigenen Template.
- Anlage prüfen und übergebenPrüfen Sie vor dem Verlassen der Anlage Werte, Überwachung, Verbindung und Alarm-E-Mail und halten Sie Ihre Einstellungen fest.
Gateway
Anschließen, Montieren und Einstellen des Gateways, mit den technischen Daten dazu.
7 Seiten
- Anschlüsse und technische DatenDas Gateway hat RS485 für Modbus RTU, einen LAN- und einen WAN-Port sowie 4G mit einer Backup-SIM und läuft mit 9 bis 57 V DC.
- Gateway montieren und Stromversorgung anschließenMontieren Sie das Gateway mit dem DIN-Schienen-Kit auf einer 35-mm-DIN-Schiene und schließen Sie eine Versorgung von 9 bis 57 V DC an die Klemme an.
- RS485-Bus anschließenSchließen Sie Modbus-RTU-Geräte mit drei Adern an das Gateway an, als durchgeschleifte Linie mit je einem 120-Ω-Abschlusswiderstand an beiden Enden.
- Netzwerk über WAN und LAN anschließenSchließen Sie den WAN-Port ans Netzwerk vor Ort für Internet an und den LAN-Port an ein Modbus-TCP-Gerät, das direkt am Gateway hängt.
- 4G und die Backup-SIMHat das Netzwerk vor Ort kein Internet, sendet das Gateway über die Backup-SIM und liest nie schneller aus als das SIM-Intervall.
- Gateway-EinstellungenÄndern Sie den Namen eines Gateways, die Adresse seines Kunden, die Einstellungen des RS485-Bus und das SIM-Intervall für 4G.
- Gateway abkoppeln oder ersetzenNehmen Sie ein Gateway aus Ihrer Organisation oder ersetzen Sie ein defektes, und sichern Sie vorher Konfiguration und Messwerte.
Modbus-Geräte
Modbus-Geräte hinzufügen und Register so einstellen, dass die Werte stimmen.
9 Seiten
- Modbus-Geräte automatisch suchenLassen Sie das Gateway die Modbus-Geräte an seinem RS485-Bus und in seinem Netzwerk selbst finden und erkennen, und fügen Sie sie danach hinzu.
- Template aus der Bibliothek wählenSuchen Sie den Typ in der Template-Bibliothek und fügen Sie das Modbus-Gerät mit den Registern hinzu, die bereits im Template stehen.
- Modbus-Gerät steht nicht in der BibliothekLassen Sie ModbusCloud das Template kostenlos erstellen, fügen Sie die Register selbst hinzu oder lesen Sie das Handbuch mit ModbusCloud Diagnostics ein.
- Eigenes Template erstellenLegen Sie die Register eines Modbus-Gerätetyps einmal in einem Template fest, wählen Sie es bei jedem weiteren Modbus-Gerät und übertragen Sie es als JSON.
- Adresse und Verbindung eines Modbus-Geräts einrichtenTragen Sie die Slave-Adresse für Modbus RTU oder IP-Adresse, Port und Unit-ID für Modbus TCP ein, ändern Sie sie später oder löschen Sie das Modbus-Gerät.
- Abfrageintervall wählenLegen Sie je Modbus-Gerät fest, wie oft das Gateway es abfragt, ab 1 Sekunde per Kabel und über 4G nie schneller als das SIM-Intervall.
- Register einrichtenFügen Sie einem Modbus-Gerät Register mit Funktion, Adresse, Datentyp, Einheit, Skalierung und Zugriff hinzu und ändern oder löschen Sie sie später.
- Registeradresse aus dem Handbuch eingebenRechnen Sie eine Registernummer wie 40001, 30010 oder 0x0010 aus dem Handbuch in die Adresse und Funktion um, die das Portal erwartet.
- Byte-Reihenfolge und Skalierung einstellenStellen Sie je Register die Byte-Reihenfolge eines 32-Bit-Werts und die Skalierung ein und prüfen Sie das Ergebnis mit einem vor Ort abgelesenen Wert.
Portal
Die tägliche Arbeit im Portal, von Live-Werten und Alarmen bis zu Berichten und Ihrem Team.
19 Seiten
- Aufbau des PortalsDas Portal öffnet auf Übersicht, mit dem Menü links und oben einer Leiste für Suche, Anleitung, Sprache, Alarme und Ihr Profil.
- Die Gateway-SeiteWas Kopfbereich, Menü, Alarmleiste und Reiter eines Gateways zeigen, wer bei Alarmen E-Mails bekommt und welche Rolle welche Schaltfläche sieht.
- Werte und Diagramme anzeigenSehen Sie die Live-Werte je Modbus-Gerät und zeigen Sie den Verlauf von Registern im Diagramm, von der letzten Stunde bis zu 30 Tagen.
- Messwerte herunterladenLaden Sie die Messwerte aller Register eines Gateways als CSV-Datei für Excel herunter, für 7 Tage, 30 Tage, 12 Monate oder alles.
- Werte mit Variablen berechnenLegen Sie auf dem Tab Variablen eine Formel über Register eines Gateways an, etwa für einen COP oder die Gesamtleistung dreier Phasen.
- Hoch- und Niedertarif je kWh-Zähler einrichtenTeilen Sie den Verbrauch eines kWh-Zählers auf dem Tab Tarif in Hoch- und Niedertarif auf, mit indikativem Betrag, Monatsbericht und CSV.
- So funktionieren AlarmeEin Alarm stammt aus einer Alarmregel oder der automatischen Überwachung, hat einen Schweregrad und bleibt bestehen, bis er gelöst ist.
- Automatische ÜberwachungFünf feste Prüfungen überwachen die Modbus-Geräte und Register eines Gateways, ohne dass Sie selbst Alarmregeln erstellen.
- Alarmregel erstellenErstellen Sie eine Alarmregel für ein Register oder ein Gateway, mit Bedingung, Schweregrad, Optionen gegen Fehlalarme und den E-Mail-Empfängern.
- Auf einen Alarm reagierenBestätigen Sie einen Alarm, halten Sie in einer Notiz fest, was Sie getan haben, lösen Sie ihn und lassen Sie sich erinnern.
- Empfänger von Alarm-E-Mails festlegenLegen Sie fest, wer Alarm-E-Mails über Organisation, Alarmregel und Gateway erhält, und wählen Sie je Alarmart, ob Sie selbst E-Mails bekommen.
- Dashboard erstellenErstellen Sie ein Dashboard und füllen Sie es mit Widgets, die Werte Ihrer Gateways zeigen oder einen Wert in ein Register schreiben.
- Dashboard per Link teilenErstellen Sie einen öffentlichen Link zu einem Dashboard, damit jemand ohne Konto mitschaut, mit oder ohne Passwort.
- Berichte erstellen und planenStellen Sie einen Bericht aus Diagrammen, Tabellen und Alarmen zusammen, speichern Sie ihn als PDF und versenden Sie ihn täglich, wöchentlich oder monatlich.
- Automatisierungen erstellenErstellen Sie eine Regel, die ein Register schreibt, einen Webhook sendet oder eine E-Mail verschickt, sobald ein Registerwert Ihre Bedingung erfüllt.
- Register über das Portal steuernBeantragen Sie die Steuerung für ein Gateway und schreiben Sie danach über das Portal einen Wert in ein Register eines Modbus-Geräts.
- Kunden verwaltenLegen Sie Kunden an, verknüpfen Sie jedes Gateway mit dem richtigen Kunden und pflegen Sie Kontakt, Adresse und Notizen je Kunde.
- Teammitglieder und RollenSehen Sie, was jede Rolle darf, laden Sie Kollegen ein oder lassen Sie sie per Beitrittscode oder Zugriffsanfrage zu, und ändern Sie ihren Zugang.
- Organisation und Profil einrichtenTragen Sie unter Organisation Firmendaten und Zeitzone ein und legen Sie unter Mein Profil Ihren Namen und die Sprache der Konto-E-Mails fest.
Integrationen
Ihre eigene Software mit der REST-API und Webhooks verbinden, mit der API-Referenz zum Nachschlagen.
3 Seiten
- REST-API und WebhooksRufen Sie Gateways, Register, Verlauf und Alarme in Ihrer eigenen Software ab und empfangen Sie Ereignisse als Webhook auf Ihrem Server.
- API-Schlüssel erstellenErstellen Sie einen API-Schlüssel mit genau den Berechtigungen, die Ihre Anbindung braucht, testen Sie ihn im Portal und widerrufen Sie ihn bei Bedarf.
- Webhook einrichtenFügen Sie einen Webhook hinzu, der bei Alarmen, Gateway-Statuswechseln und Automatisierungen eine signierte Nachricht an Ihr System sendet.
Diagnostics
Mit der kostenlosen Desktop-App ModbusCloud Diagnostics lesen Sie ein Modbus-Gerät aus und suchen Störungen vor Ort.
7 Seiten
- ModbusCloud Diagnostics installierenLaden Sie das kostenlose Programm für Windows oder macOS herunter, installieren Sie es und starten Sie es erstmals, auch bei einer Systemwarnung.
- Modbus-Gerät mit Diagnostics anschließen und findenVerbinden Sie Ihren Laptop per USB-RS485-Adapter oder Netzwerk mit einem Modbus-Gerät und lassen Sie Diagnostics Einstellungen und Adresse suchen.
- Modbus-Gerät erkennen, Werte lesen und schreibenLassen Sie ModbusCloud Diagnostics den Typ eines Modbus-Geräts erkennen, lesen Sie die Werte live mit Name und Einheit und schreiben Sie ein Register.
- Handbuch eines unbekannten Modbus-Geräts einlesenLesen Sie die Registertabelle aus dem Handbuch mit ModbusCloud Diagnostics ein, prüfen Sie sie am Modbus-Gerät und speichern Sie sie als eigenen Gerätetyp.
- Störungen mit Diagnose und Konsole findenLesen Sie in ModbusCloud Diagnostics ab, wie viele Anfragen eine Antwort bekommen, was jeder Fehler bedeutet und welche Bytes über das Kabel gehen.
- Mit Diagnostics aufzeichnen und exportierenZeichnen Sie Werte eines Modbus-Geräts auf, exportieren Sie sie als CSV oder JSON oder wandeln Sie Gerätetypen für Home Assistant, ESPHome oder das Portal um.
- Mit dem Simulator übenLassen Sie ModbusCloud Diagnostics ein Modbus-Gerät aus der Bibliothek nachbilden und üben Sie ohne Hardware oder testen Sie Ihre eigene Software damit.
Fehlerbehebung
Für jedes Symptom die häufigsten Ursachen und was Sie prüfen.
12 Seiten
- Anmelden funktioniert nichtLösen Sie das Problem, wenn das Portal Ihre Anmeldedaten ablehnt, Ihre Einladung nicht mehr funktioniert oder Sie nicht in Ihre Organisation gelangen.
- Gateway geht nicht onlineBleibt ein Gateway auf Warte auf Verbindung, prüfen Sie Startzeit, Seriennummer, Strom, Kabel, 4G und Firewall.
- Gateway ist offlineEin Gateway steht auf Offline, wenn das Portal einige Minuten nichts von ihm hört. Die Ursache liegt bei Strom, Netzwerk oder 4G-Empfang.
- Modbus-Gerät liefert keine WertePrüfen Sie bei einem Modbus-Gerät ohne Werte Register, Adresse, Busparameter, Verkabelung und bei Modbus TCP das Netzwerk.
- Werte stimmen nichtFinden Sie anhand des Angezeigten die Ursache eines falschen Werts, etwa Byte-Reihenfolge, Skalierung, Adresse, Datentyp oder CT-Verhältnis.
- Antworten auf RS485 fallen aus oder sind verstümmeltMeist fehlt die Signalmasse, die Abschlusswiderstände stimmen nicht, ein zweiter Master sitzt am Bus oder die Bus-Einstellung weicht ab.
- Meldung beim Hinzufügen oder Speichern eines Modbus-GerätsWas die Meldungen zu Adresse, Bus-Einstellungen und Konfiguration beim Hinzufügen, Speichern oder Löschen eines Modbus-Geräts bedeuten und was Sie tun.
- Automatische Suche findet nicht allesPrüfen Sie Rolle, Bus, Adresse, Netzwerk und Meldung, wenn die automatische Suche ein Modbus-Gerät übersieht, nicht erkennt oder nicht hinzufügt.
- Werte kommen seltener als eingestelltÜber die SIM liest das Gateway nicht schneller aus als das SIM-Intervall. Auch der RS485-Bus, ältere Software und der Verlauf pro Minute spielen mit.
- Alarm löst nicht aus, zu oft aus oder bleibt offenPrüfen Sie Regel, Messwerte und Alarmstatus, wenn ein Alarm nicht auslöst, zu oft auslöst oder offen bleibt.
- Alarm-E-Mail oder Bericht kommt nicht anPrüfen Sie Spamfilter, Empfänger, eigene Einstellungen und Planung, wenn eine Alarm-E-Mail oder ein geplanter Bericht nicht ankommt.
- Hilfe anfragenKontaktieren Sie den Support per E-Mail, Telefon oder WhatsApp oder über die Feedback-Schaltfläche im Portal und senden Sie die nötigen Angaben mit.
Sicherheit und Daten
Netzwerkanforderungen, Speicherung, Zugriff und Aufbewahrung, für IT-Abteilungen und Datenschutzfragen.
5 Seiten
- Netzwerkanforderungen für das GatewayDas Gateway braucht nur ausgehenden Verkehr, MQTT über TLS auf Port 8883 und dazu DNS, NTP und Ping.
- Wo Ihre Daten liegen und wer darauf zugreifen kannIhre Messwerte laufen über einen Broker in Frankfurt in eine Datenbank in Irland, in der jede Organisation nur ihre eigenen Daten sieht.
- Aufbewahrungsfristen und Export Ihrer DatenMesswerte bleiben 365 Tage gespeichert, und nach Ende Ihrer Lizenz haben Sie noch 90 Tage, um Ihre Daten zu exportieren.
- Anmeldung und Konto absichernÄndern Sie Ihr Passwort, melden Sie sich überall ab, wenn Ihnen etwas auffällt, und geben Sie Kollegen nur den Zugriff, den ihre Arbeit braucht.
- AuftragsverarbeitungsvertragDer Auftragsverarbeitungsvertrag regelt, wie ModbusCloud Daten für Sie verarbeitet, welche Unterauftragsverarbeiter es gibt und wie Sie ihn unterzeichnen.
Konto und Lizenz
Lizenz, 4G-Daten, Bestellung und Rechnungen, Garantie und Kündigung.
5 Seiten
- Die PortallizenzPro Gateway wählen Sie eine Jahreslizenz für €149 oder eine einmalige Lizenz für €495, beide mit allen Funktionen des Portals.
- 4G-Daten und KostenBei einer Jahreslizenz sind bis zu 30 MB 4G-Daten pro Monat enthalten, bei einer einmaligen Lizenz zahlen Sie €1 pro Monat oder €95 für zehn Jahre.
- Bestellung, Konto und RechnungenBestellen Sie Gateways im Webshop auf modbuscloud.com und finden Sie Ihre Bestellungen und Rechnungen danach im Portal.
- Garantie und Rückerstattung24 Monate Garantie auf das Gateway, und Rückerstattung, wenn es binnen 100 Tagen kein Modbus-Gerät aus der Template-Bibliothek erreicht.
- Lizenz kündigen und Konto löschen lassenKündigen Sie eine Jahreslizenz per E-Mail zum Ende des laufenden Jahres und beantragen Sie unter Mein Profil die Löschung Ihres Kontos.
API-Referenz
Alle Endpunkte und Webhooks der REST-API, mit einem Sandbox-Schlüssel zum sofortigen Ausprobieren.
Zur API-ReferenzKommen Sie nicht weiter?
Schreiben Sie uns oder rufen Sie an. Nennen Sie die Seriennummer des Gateways, dann können wir direkt nachsehen.
Zum Support