Modbus Remote is not a safety controller. Emergency stops, machine protection, limit shutdowns, fire alarms, and mandatory alarm systems must be implemented locally, independently, and according to applicable standards. Never expose Modbus TCP port 502 directly to the internet.
1. Quick start with the demo
- On first launch, choose Try Demo.
- Explore the sample dashboards and changing simulated values.
- Open Trends, Alarms, Devices, and More to learn the navigation.
- Delete demo devices at any time. They do not count toward the five-device limit.
2. Add a real device
Your iPhone or iPad and the Modbus device must be reachable on the same network. Guest Wi-Fi or client isolation can prevent access. Have the host/IP address, TCP port, Unit ID, and register map ready.
- Open Devices and tap +.
- Enter a display name, host or local IP, port (usually 502), and Unit ID (often 1).
- Adjust timeout, retries, polling interval, and maximum request rate if needed.
- Run the connection test and save. A successful datapoint live test confirms function code, address, and data type.
Version 1.0 supports up to five real devices. Existing data remains available when the limit is reached.
3. Create or edit a datapoint
Open a device and choose Add Datapoint, or use the dashboard assistant. Tap an existing datapoint tile to reopen the same editor. The delete button is at the bottom.
| Area | Read | Write |
|---|---|---|
| Coil | FC01 | FC05 / FC15 |
| Discrete Input | FC02 | Read only |
| Holding Register | FC03 | FC06 / FC16 |
| Input Register | FC04 | Read only |
Addressing
Reference address 00001, 10001, 30001, or 40001 corresponds to PDU address 0. If the device manual already lists protocol addresses starting at 0, choose Raw PDU. The editor shows the actual PDU address.
Data type, order, and scaling
Supported types include UInt/Int 16, 32, and 64 bit, Float32, Float64, Bool, register bit, bitmask, and ASCII. Implausible multi-register values often mean the ABCD/BADC/CDAB/DCBA byte and word order is wrong. Scaling uses display value = raw value × scale + offset. For writing, scale must not be zero.
Live test
Before saving, check the raw response, decoded and scaled values, PDU address, and response time. Save only plausible results.
4. Dashboards, rooms, and groups
Selecting a dashboard switches to it; editing is available from the three-dot menu. With one dashboard it becomes the default automatically. With several dashboards, choose Set as Default. Rooms and groups are managed separately. Select an existing room from the dropdown, then group tiles as Boiler, Hydraulics, or Production.
Tile types include value, switch, setpoint, slider, enum, button, and custom value. After communication loss, the last value remains visible with stale status and timestamp; an unknown value is never invented as zero.
5. Write safely
Enable writing explicitly for each datapoint and use Confirmation Required for consequential actions. The app reads back after writing and displays only the device response. Limits and steps do not replace PLC safeguards.
6. Trends and history
Enable Record History and choose sample interval, retention, and aggregation. View 1 hour, 6 hours, 24 hours, 7 days, 30 days, or a custom range; compare up to six curves. Missing samples remain gaps. History is stored locally by default.
7. Alarm rules and notifications
Rules can monitor numeric limits, Bool/enum states, value changes, and communication loss. Configure delay, hysteresis, cooldown, repetition, acknowledgement, and recovery. Rules can be opened, edited, tested, and deleted.
Local and remote notifications may be delayed or missed because of network, server, APNs, or device conditions. They do not replace a required local alarm system.
8. Optional 24/7 remote monitoring
iOS may suspend apps in the background. The optional local Agent can run on a Raspberry Pi, Linux PC, NAS, Docker host, or VM. It evaluates rules locally and sends only triggered/recovered events outbound over HTTPS. No public Modbus port is required. This feature may not be active at launch; see the privacy policy.
9. Import, export, copy, and delete
Use Settings → Data Transfer to export or import a versioned .modbusremote file. Devices, datapoints, rooms, and rules can be copied. Devices — including demo devices — can be deleted from their editor. Verify host, Unit ID, addresses, and live values after copying or importing.
10. Troubleshooting
Connection test fails
Check the same reachable network, enabled Modbus TCP, host, port, guest-Wi-Fi isolation, and firewall.
Value is wrong or implausible
Check reference vs. raw PDU addressing, function code, data type, register length, byte/word order, scale, and offset.
Writes have no effect
Confirm the area is writable, writing is enabled, limits are correct, and the PLC permits the write. The device response and PLC logic are authoritative.
No notification appears
Use the rule test, check iOS notification permissions and Focus modes, then verify that delay and cooldown conditions are satisfied.
11. Contact support
Email modbusremote@kaeltewunder.de. Include app version, iPhone/iPad model, iOS version, target device, function code, display and PDU address, data type, and exact error. Never send passwords, APNs keys, installation tokens, or full exports.
Deutsch · Version 1.0
Hilfe & Bedienungsanleitung
Modbus Remote ist keine Sicherheitssteuerung. Not-Aus, Maschinenschutz, Grenzwertabschaltungen, Brandmeldung und vorgeschriebene Alarmierung müssen lokal, unabhängig und normgerecht umgesetzt sein. Port 502 niemals direkt aus dem Internet erreichbar machen.
1. Schnellstart und Demo
- Demo ausprobieren wählen.
- Simulierte Dashboards und Werte ansehen.
- Dashboard, Trends, Alarme, Geräte und Mehr öffnen.
- Demo-Geräte sind löschbar und zählen nicht zum Limit.
2. Echtes Gerät hinzufügen
iPhone/iPad und Gerät müssen im selben erreichbaren Netz sein. Unter Geräte → + Name, Host/IP, Port (meist 502) und Unit ID (oft 1) eintragen. Bei Bedarf Timeout, Versuche, Polling und Request-Limit anpassen. Verbindung testen und speichern. Erst der Datenpunkt-Live-Test bestätigt Adresse, Function Code und Datentyp. Bis zu fünf echte Geräte sind möglich.
3. Datenpunkt anlegen und bearbeiten
Im Gerät Datenpunkt hinzufügen wählen oder den Dashboard-Assistenten öffnen. Ein vorhandener Datenpunkt öffnet beim Antippen den vollständigen Editor; unten steht Datenpunkt löschen. Coils: FC01/FC05/FC15. Discrete Inputs: FC02. Holding Register: FC03/FC06/FC16. Input Register: FC04.
Referenzadresse 00001/10001/30001/40001 entspricht PDU 0; bei nullbasierten Geräteadressen Raw PDU wählen. Datentyp, Registerlänge, ABCD/BADC/CDAB/DCBA, Scale und Offset prüfen. Skalierung: Anzeigewert = Rohwert × Scale + Offset. Vor dem Speichern den Live-Test nutzen.
4. Dashboards, Räume und Gruppen
Das Antippen eines Dashboards wechselt die Ansicht; bearbeitet wird über das Drei-Punkte-Menü. Ein Dashboard wird automatisch Standard, bei mehreren kann eines als Standard markiert werden. Räume und Gruppen werden getrennt verwaltet. Räume werden aus einer Liste gewählt; Gruppen bündeln Werte etwa als Kessel, Hydraulik oder Produktion.
5. Sicher schreiben
Schreiben pro Datenpunkt freigeben und bei kritischen Aktionen eine Bestätigung verlangen. Die App liest nach dem Schreiben zurück und zeigt die Geräteantwort. Grenzen ersetzen keine Schutzlogik der SPS.
6. Trends
Historie aufzeichnen aktivieren und Intervall, Aufbewahrung und Verdichtung wählen. Zeiträume reichen von einer Stunde bis 30 Tage oder frei; bis zu sechs Kurven sind vergleichbar. Historie liegt standardmäßig lokal.
7. Regeln und Mitteilungen
Regeln überwachen Grenzwerte, Bool-/Enum-Zustände, Änderungen und Kommunikationsverlust. Verzögerung, Hysterese, Cooldown, Wiederholung, Quittierung und Recovery sind einstellbar. Regeln lassen sich öffnen, bearbeiten, testen und löschen. Mitteilungen sind Best Effort und ersetzen keine lokale Alarmierung.
8. Optionales 24/7-Monitoring
Der optionale Agent läuft auf Raspberry Pi, Linux-PC, NAS, Docker oder VM im lokalen Netz, wertet Regeln lokal aus und sendet nur Ereignisse ausgehend per HTTPS. Kein öffentlicher Modbus-Port ist nötig. Einzelheiten: Datenschutzerklärung.
9. Import, Export, Kopieren und Löschen
Unter Einstellungen → Datenübertragung können .modbusremote-Dateien importiert/exportiert werden. Geräte, Datenpunkte, Räume und Regeln sind kopierbar. Echte und Demo-Geräte lassen sich im Editor löschen. Danach Host, Unit ID, Adresse und Live-Wert prüfen.
10. Fehler beheben
Bei Verbindungsfehlern Netz, Gast-WLAN-Isolation, Host, Port, Firewall und Modbus TCP prüfen. Bei falschen Werten Adresse, PDU-Modus, Function Code, Datentyp, Registerlänge, Reihenfolge, Scale und Offset prüfen. Bei fehlenden Mitteilungen Testfunktion, iOS-Berechtigung, Fokusmodus sowie Delay/Cooldown kontrollieren.
11. Support
E-Mail: modbusremote@kaeltewunder.de. App-Version, Gerätemodell, iOS-Version, Zielgerät, Function Code, Anzeige-/PDU-Adresse, Datentyp und genaue Fehlermeldung nennen. Keine Passwörter, Schlüssel, Tokens oder vollständigen Exportdateien senden.