Eine fertige Lösung erwartet bestimmte Telemetrieschlüssel, Attribute und Beziehungen. Ihre Geräte benennen Dinge wahrscheinlich anders: temp statt air_temp, door als Text statt door_open als true/false, Druck in Pascal statt in bar. Diese Seite zeigt, wie Sie alles zusammenfügen, ohne die Lösung umzuschreiben, und was eine Lösung sonst noch von Ihnen benötigt.
Einen Ansatz wählen
| Ansatz | Am besten geeignet, wenn | Aufwand |
|---|---|---|
| 1. Bereinigung im Root-Flow | Viele Geräte einer Art senden dieselben Namen | Ein Flow, danach funktionieren alle Boards und Regeln unverändert |
| 2. Die Karten ändern | Nur wenige Karten sind betroffen, oder Sie verwenden ohnehin ein Vorlagen-Board | Die Schlüssel jeder Karte bearbeiten |
| 3. Den Codec ändern (LoRaWAN) | Der Sensor ist LoRaWAN, und sein Codec benennt Schlüssel auf seine Weise | Eine Kopie des Codecs mit anderen Ausgabenamen speichern |
| 4. Ihre Geräte in den Profilen der Lösung einsetzen | Ihre Geräte können die Schlüssel der Lösung direkt senden (Sie kontrollieren die Firmware) | Keine auf der Hermetry-Seite |
Ansatz 1 ist die übliche Wahl: Die gespeicherten Daten passen dann zu den Profilen der Lösung, sodass Alarmregeln, Boards und Diagramme alle funktionieren, und Sie können Gerätehersteller mischen.
1. Bereinigung im Root-Flow
Jede Gerätenachricht durchläuft einen Root-Flow, bevor sie gespeichert wird: den eigenen Root des Profils, falls vorhanden, andernfalls den Root-Flow der Organisation. Setzen Sie die Bereinigungsschritte vor Telemetrie speichern.
- Geben Sie den Geräten einer Art ein eigenes Geräteprofil oder verwenden Sie das Profil der Lösung.
- Erstellen Sie unter Automatisierung einen Flow auf dem Host IoT aus der Vorlage Standard-Root-Flow und binden Sie ihn als Root dieses Profils. Siehe Hosts, der Root-Flow und Profil-Root-Flows.
- Fügen Sie zwischen Gerätenachrichten und Alarmregeln die folgenden Schritte hinzu.
- Mit einer aufgezeichneten Nachricht testen, dann bereitstellen.
Setzen Sie die Schritte vor Alarmregeln, damit die Regeln auch die bereinigten Schlüssel sehen.
Einen Schlüssel umbenennen
Ein Ändern-Block mit zwei Schritten, zum Beispiel um temp in air_temp umzuwandeln:
| Schritt | Pfad | Wert |
|---|---|---|
set | msg.payload.air_temp | msg.payload.temp |
delete | msg.payload.temp |
Einen Wert umrechnen
Ein Berechnen-Block, ein Ziel pro Wert:
| Bedarf | Ausdruck | Ziel |
|---|---|---|
°F zu °C (air_temp) | round((msg.payload.temp_f - 32) * 5 / 9, 1) | msg.payload.air_temp |
| Textuellen Türzustand in true/false umwandeln | msg.payload.door == "open" | msg.payload.door_open |
| Ereigniscode eines Trackers in das Wort der Lösung umwandeln | msg.payload.ev == 3 ? "fall" : (msg.payload.ev == 7 ? "sos" : "normal") | msg.payload.event |
| Numerischen Text in eine Zahl umwandeln | number(msg.payload.level) | msg.payload.level_cm |
Rechnen mit Text schlägt fehl, auch bei numerischem Text wie "21.5": Konvertieren Sie zuerst mit number(...). Siehe Datentransformationsblöcke und Dekodierte Werte bereinigen.
Nicht benötigte Schlüssel entfernen
Ein Ändern-Block mit delete-Schritten oder Telemetrie speichern auf die von Ihnen aufgelisteten Schlüssel beschränken. Weniger Schlüssel halten Sie weiter von der Schlüsselobergrenze Ihres Tarifs entfernt; siehe Telemetrieschlüssel.
Hinweis
Die Bereinigung ändert, was gespeichert wird, nicht, was gezählt wird: Die Nachricht zählt bei Eingang auf Ihr monatliches Kontingent. Siehe Nachrichtenkontingent und Nutzung.
2. Die Karten ändern
Um Ihre Schlüssel direkt zu lesen, öffnen Sie das Board im Modus Anpassen, öffnen Sie die Einstellungen einer Karte und wählen Sie Ihren Schlüssel im Datenfeld. Diagramme, Tabellen und Karten haben jeweils eigene Schlüssellisten. Ein Board-Parameter wie Tanks oder Standortsteuerungen wählt Geräte nach Profil aus: Öffnen Sie Parameter verwalten… und fügen Sie Ihr Profil hinzu, damit Ihre Geräte im Board erscheinen.
Change a copy rather than the installed board: Duplicate it first. When Hermetry updates a solution, the installed board’s cards are written again (see Install a solution).
3. Die Grenzwerte der Lösung verwenden
Die Alarmregeln vergleichen Messwerte mit Server-Attributen jedes Geräts. Ihre Geräte benötigen diese ebenfalls:
| Lösung | Attribute auf jedem Gerät |
|---|---|
| Wasserstandort | Tank: lowLevelThreshold, highLevelThreshold. Pumpstation: minPressure |
| Remote-Standorte | Standortsteuerung: highTempThreshold, lowTempThreshold, highHumThreshold, lowHumThreshold |
| Sensorregionen | maxTempThreshold, minTempThreshold, warnTempThreshold, maxHumThreshold, minHumThreshold, warnHumThreshold |
| Personenverfolgung | forbiddenZone |
| Wetterstationen | Keine |
Ein Gerät ohne Attribut wird von der Regel, die es liest, nicht geprüft. Setzen Sie die Attribute:
- von Hand, auf dem Reiter Attribute des Geräts (Bereich Server),
- gesammelt, mit
attr:<key>-Spalten in einem Geräteimport (siehe Geräte gesammelt importieren), - aus einem anderen System, mit
POST /api/iot/devices/{deviceId}/attributes/server(siehe Telemetrie- und Attribute-API).
4. Standorte und Beziehungen
Einige Seiten finden Geräte über das Standortmodell. Bauen Sie es für Ihre eigenen Geräte neu auf:
| Lösung | Was das Board benötigt | Vorgehen |
|---|---|---|
| Wasserstandort | Tanks und Stationen in einer Zone unter dem Standort platziert; jeder Tank CONTROLS seine Pumpstation | Geräte platzieren; die Beziehung vom Tank zur Station hinzufügen |
| Remote-Standorte | Steuerung und UPS-Gateway im Standort platziert; das UPS-Gateway FEEDS die Steuerung; Kameras im Standort platziert | Geräte platzieren; die Beziehung vom UPS zur Steuerung hinzufügen |
| Sensorregionen | Sensoren in einer Region platziert; das Attribut floorPlan der Region; die Station mit dem Label Weather station | Geräte platzieren; Attribut und Label setzen |
| Personenverfolgung | Zonen-Assets, die genau so benannt sind, wie die Tracker sie melden | Assets der Art Zone mit diesen Namen anlegen |
Siehe Geräte platzieren und Beziehungen.
5. Geräte gut benennen
Die Boards zeigen Gerätenamen in Titeln, Tabellen, Karten und Alarmtexten („Alarm geöffnet bei Name: …“). Benennen Sie jedes Gerät nach seiner Art und seinem Ort (Hilltop shelter, Tank 3 North), nicht nach seiner Seriennummer. Das Board der Sensorregionen verwendet außerdem das Label des Geräts auf der Karte.
Checkliste
- Ihre Geräte senden die Schlüssel der Lösung, direkt oder nach der Bereinigung im Root-Flow. Prüfen Sie den Reiter Telemetrie eines Geräts.
- Jedes Gerät hat seine Grenzwert-Attribute.
- Die Geräte sind platziert, und die Beziehungen existieren.
- Die Profilparameter des Boards enthalten Ihre Profile.
- Die Profile-Liste des Benachrichtigungsflows nennt Ihre Profile, seine Empfänger stimmen, und er ist eingeschaltet.
- Nicht mehr benötigte Beispielgeräte sind gelöscht.
Fehlerbehebung
| Symptom | Prüfen |
|---|---|
| Eine Karte bleibt leer | Den Schlüsselnamen auf dem Reiter Telemetrie des Geräts, genau, einschließlich Groß- und Kleinschreibung. Siehe Ein Dashboard zeigt keine Daten. |
| Ein Diagramm ist leer, aber die Wertkarte zeigt einen Wert | Der Schlüssel ist Text oder true/false: Speichern Sie eine numerische Kopie. |
| Kein Alarm öffnet sich | Das Grenzwert-Attribut fehlt, oder die Bereinigung läuft nach Alarmregeln |
| Die Daten bleiben aus, nachdem Sie einen Profil-Root gebunden haben | Dem neuen Root fehlt Telemetrie speichern. Siehe Daten kommen nicht an. |