Profil Editor

Mit dem Profil Editor erstellen Sie eigene Geräteprofile für Add-ons oder passen bestehende an. Ein Profil legt fest, wie der nomos system Controller mit einem Gerät spricht und was davon in App, Automationen und Quick Konfig erscheint. Wie ein Profil aufgebaut ist, beschreibt Profilformat; die Verbindung über TCP, UDP und HTTP steht unter CommandServer, fertige Beispiele unter Beispielprofile.

INFO

Der Profil Editor steht zur Verfügung, wenn Ihre Lizenz ihn freischaltet. Ohne Freischaltung fehlen in der Profilliste der Stift und die Schaltfläche Neues Profil. Auf dem Smartphone ist der Editor ausgeblendet.

Ein Profil öffnen oder anlegen

Alle Wege beginnen unter Skills → Add-ons im Reiter Profile:

• Neues Profil (Plus-Symbol, Tastenkürzel N): Sie geben einen Namen ein und wählen Protokoll, Kategorie und Typ. Das Protokoll (CommandServer, KNX, Modbus, MQTT, Z-Wave, ZigBee) bestimmt den Grundaufbau, der Typ eine Vorlage mit passenden Aktionen, Rückmeldungen und Vorlagen, etwa für ein Licht, einen Dimmer oder einen Wechselrichter. Mit Erstellen öffnet sich der Editor.
• Online-Bibliothek: Lädt ein fertiges Profil in die Liste. Zum Bearbeiten öffnen Sie es danach mit dem Stift.
• Manueller Upload: Lädt eine Profildatei (.json, höchstens 1 MB) in die Liste. Ältere Definitionsdateien im Format .csv werden dabei in ein JSON-Profil umgewandelt.
• Stift in einer Zeile der Profilliste: Öffnet das Profil im Editor.

Gibt es ein Profil mit demselben Namen schon, ersetzt der Import es, und die Geräte, die es verwenden, übernehmen die neue Version (siehe Updates aus der Online-Bibliothek). Ein Punkt im Dateinamen wird dabei zu _.

Am schnellsten kommen Sie voran, wenn Sie mit einem Profil beginnen, das Ihrem Gerät ähnlich ist, etwa vom selben Hersteller oder mit demselben Protokoll, und es mit Speichern unter als neues Profil sichern.

Aufbau des Editors

Oben steht die Leiste mit den Schaltflächen Speichern unter, Abbrechen und Speichern. Links darin wählen Sie, welchen Teil des Profils Sie bearbeiten: das Hauptprofil oder eines der Unterprofile (siehe unten). Darunter zeigt der Editor die Ergebnisse der Prüfung, dann die Bereiche Infos und Einstellungen und darunter die Reiter.

Prüfung

Der Editor prüft das Profil bei jeder Änderung. Die Kopfzeile zählt Fehler (rot), Warnungen (gelb) und Hinweise (blau), ohne Befund steht dort Keine Probleme. Jede Zeile nennt die Regel, die Stelle im Profil und eine Meldung (auf Englisch), etwa consistency.polling bei polling.Status.

Die Prüfung hält das Speichern nicht auf. Beheben Sie Fehler trotzdem vor dem Einsatz: Sie zeigen fast immer eine Stelle, an der das Gerät später nicht reagiert oder Werte fehlen.

Infos

Feld	Bedeutung
Beschreibung	Name des Profils in der Profilliste und Vorschlag für den Gerätenamen
Hersteller, Modell	Angaben zum Gerät
Plattform	Herkunft des Geräts, z. B. der Herstellername. Bei KNX und Z-Wave ausgeblendet und fest vorgegeben
Version	Wird bei jedem Speichern automatisch erhöht (1.0 → 1.1), solange Sie sie nicht selbst ändern. Die Version entscheidet, ob bestehende Geräte eine Änderung übernehmen (siehe Profil ändern)
Autor	Wer das Profil erstellt hat
Hilfe URL	Adresse einer Hilfeseite zum Gerät. Sie erscheint als Info-Schaltfläche in der Profilliste und auf der Geräteseite

Einstellungen

Feld	Bedeutung
Kategorie, Typ	Bestimmen Symbol und Darstellung in der App und ob das Gerät über die Matter-Brücke erscheint. Wählen Sie den Typ passend zum wichtigsten Wert: Ein Gerät, das vor allem Bewegung meldet, ist ein Bewegungsmelder, auch wenn es zusätzlich die Temperatur liefert
Engine-Typ	Wie der Controller das Gerät anspricht: CommandServer (eigene Verbindung über TCP, UDP, HTTP oder seriell), MQTT, KNX, ZWAVE oder BUS. Der Engine-Typ bestimmt, welche Reiter es gibt
Klassenname	Nur bei CommandServer: interner Name der Verbindung, nur Großbuchstaben, Ziffern, _ und -. Bleibt das Feld leer, bildet der Editor ihn aus Hersteller und Modell
Kompatibilität	Wie vollständig das Profil das Gerät abdeckt, in Prozent
Zertifiziert von nomos system	Gesperrt; nur von nomos system geprüfte Profile tragen hier Ja
Tags	Zusätzliche Kennzeichen, getrennt durch Komma oder Semikolon
Gerät in Apps anzeigen	Ohne Haken erscheint das Gerät nicht in der App
Gerät in Sprachassistenten verwenden	Ohne Haken wird das Gerät nicht an Sprachassistenten und die Matter-Brücke weitergegeben

Die Reiter

Reiter	Inhalt	Engine-Typ
Kommunikation	Verbindungseinstellungen: Adresse, Port, Protokoll, Zeitlimits, Erreichbarkeit	nur CommandServer
Aktionen	Was an das Gerät gesendet werden kann	alle
Rückmeldung	Welche Werte das Gerät meldet	alle
Abfragen	Befehle, die regelmäßig gesendet werden, um Werte abzuholen	nur CommandServer
Kameras	Kamerabilder, die das Gerät liefert	alle
Webhooks	Werte, die das Gerät selbst per HTTP an den Controller schicken darf	alle

In jeder Tabelle fügen Sie mit Hinzufügen eine Zeile an, löschen sie mit dem roten ✕ und ändern die Reihenfolge durch Ziehen. Doppelte Namen werden rot markiert.

Kommunikation

Die Tabelle hat die Spalten Name, Wert, Editierbar und Kommentar. Den Namen wählen Sie aus den bekannten Einstellungen oder geben unter Benutzerdefiniert... einen eigenen ein. Was die Einstellungen bewirken, steht unter CommandServer: Verbindung.

• Editierbar: Der Wert wird beim Gerät erstellen abgefragt und mit dem eingetragenen Wert vorbelegt. Typisch für die IP-Adresse des Geräts, einen Port oder Zugangsdaten.
• Kommentar: Die Einstellung bleibt im Profil, ist aber ohne Wirkung. Das ist praktisch, um Werte vorzuhalten, die Sie nur als Platzhalter in Befehlen verwenden (siehe Platzhalter).

Aktionen und Rückmeldung

Beide Reiter sind gleich aufgebaut. Über die Leiste mit den Sprungmarken Kommunikation, Definition und Vorlagen wechseln Sie zwischen den Abschnitten.

Kommunikation (nur CommandServer)

• Bei Aktionen stehen hier die Befehle mit Name, Sequenz, Parameter, Timeout, Abstand und Tag; bei HTTP zusätzlich Methode und für POST, PUT, PATCH und DELETE Content-Type und Body. \# in der Sequenz ist der Platz für den Wert, den die Aktion mitschickt.
• Bei Rückmeldung stehen hier die Muster für Antworten des Geräts mit Name, Match, Aktion, Bedingung, bei Änderung und Tag.

Die Bedeutung jeder Spalte erklärt CommandServer.

Definition

Hier legen Sie fest, was App und Automationen sehen. Jede Zeile hat Name, Kommando (bei Aktionen) bzw. Rückmeldung, Datentyp und Einheit.

• Name: Wählen Sie möglichst einen der vorgeschlagenen Standardnamen wie state, level, position, setpoint oder temperature. Nur diese Namen kennt die App für ihre Bedienelemente; siehe Standardnamen.
• Kommando bzw. Rückmeldung: Bei CommandServer wählen Sie einen Befehl bzw. ein Muster aus dem Abschnitt Kommunikation. Ein Kommando, das mit SET oder GET beginnt, wird als Eigenschaft gelesen: SETCURR schreibt die Eigenschaft CURR. Bei KNX ist das Feld fest vorgegeben, die Gruppenadressen vergeben Sie erst beim Anlegen des Geräts.
• Datentyp: null (Schaltfläche ohne Wert), string, bool, trigger, int oder float.
• Einheit: Für Zahlen. Unter Kategorien stehen Einheiten, die die App für den Benutzer umrechnet (z. B. temperature), unter Maßeinheiten feste Einheiten wie W oder kWh.

Der Stift am Zeilenende öffnet den Dialog Details:

Feld	Bedeutung
Beschreibung	Beschriftung in App und Automationen
Gruppe	Abschnitt, unter dem die App den Wert zeigt, etwa „Laden“ bei einer Wallbox. Nur für Geräte mit vielen Werten sinnvoll
Versteckt	Der Wert erscheint nicht als eigene Zeile in der App, bleibt aber für Automationen verfügbar
Feedback-Simulation	Nur Aktionen: Der Controller meldet den gesendeten Wert sofort als Rückmeldung, für Geräte ohne eigene Rückmeldung
Max. Länge	Nur Text
Gerät min/max, Gemappt min/max	Skalierung zwischen dem Wertebereich des Geräts und dem in nomos, siehe Skalierung
Geräteeinheit, Kelvin warm/kalt	Nur für color-temperature: ob das Gerät Mired, Kelvin oder Prozent spricht
Schritt Wert	Schrittweite von Schiebereglern
MQTT, MQTT-Wert, MQTT-Einheit, MQTT Payload	Nur MQTT, siehe MQTT
Größe in Bit	Bei KNX die Größe des Datenpunkts (1, 8, 16, 32 Bit)
KNX DPT Filter	Bei KNX: welche Datenpunkttypen beim Zuordnen der Gruppenadresse angeboten werden
Werteliste	Auswahlwerte mit Text, z. B. 0 = Aus, 1 = Stufe 1
Standardwert	Bei Aktionen der fest gesendete Wert (etwa 1 für switchon), bei Rückmeldungen der Anfangswert
Präfix, Suffix, Klassenübersteuerung	Nur Aktionen: Text vor bzw. nach dem Wert, Befehl an eine andere Verbindung senden
Verarbeitungsfunktion	Nur Rückmeldungen: Nachverarbeitung des Werts, etwa die Umrechnung in einen Preis, siehe Verarbeitung
Matching Optionen, Volatil, mRemote Join	Für Sonderfälle; in eigenen Profilen leer lassen

Vorlagen

Vorlagen sind die Einträge, die Automationen und die Quick Konfig anbieten, etwa „Einschalten“ oder „Helligkeit“. Spalten: ID, Name (die Aktion bzw. Rückmeldung, auf die sich die Vorlage bezieht), Icon, Beschreibung, Wert und bei Aktionen Platzhalter, dazu Quick Konfig.

• Wert: Ein fester Wert. Die Automation zeigt dann kein Eingabefeld, z. B. „Ist eingeschaltet“ mit dem Wert 1.
• Platzhalter: Bei Aktionen mit einem Textwert ein Beispiel, etwa Willkommen oder http://…. Es erscheint grau im noch leeren Eingabefeld der Aktion in Automationen. Hat die Vorlage einen festen Wert, ist die Spalte gesperrt.
• Quick Konfig: Ein Haken blendet die Vorlage in der Quick Konfig des Geräts aus; in Automationen bleibt sie wählbar.

WARNING

Sobald es eine einzige Vorlage gibt, bieten Automationen nur noch die Vorlagen an, nicht mehr alle Aktionen bzw. Rückmeldungen. Legen Sie deshalb für jeden Wert, der in Automationen gebraucht wird, eine Vorlage an, oder keine Vorlagen.

Abfragen

Je Zeile ein Name, ein Kommando und das Abfrageintervall (in Sekunden). Mit Editierbar wird das Intervall beim Anlegen des Geräts abgefragt. Ein HTTP-Profil ohne eigene Abfrage bekommt beim Speichern die Abfrage „Reachable Check“, die alle 30 Sekunden / abruft, damit die Erreichbarkeit stimmt.

Kameras

Je Zeile eine URL und ein URL Typ: RTSP, Snapshot, MJPEG oder Andere HTTP. In der URL dürfen Platzhalter aus der Kommunikation stehen, z. B. http://%SERVERIP%/snapshot.jpg. Beim Anlegen des Geräts entsteht je Zeile eine Kamera.

Webhooks

Hier wählen Sie Rückmeldungen aus, deren Werte das Gerät selbst an den Controller senden darf, statt dass der Controller sie abfragt. Die Adresse und wie das Gerät sie aufruft, steht unter Webhooks.

Unterprofile

Ein Gerät, das mehrere unabhängige Teile hat, etwa einen Aktor mit vier Kanälen, bekommt je Teil ein Unterprofil. Beim Anlegen des Geräts entsteht dann je Unterprofil ein eigenes Gerät namens „Gerätename Unterprofilname“, alle über dieselbe Verbindung.

• Anlegen: In der Auswahl links in der Leiste Hinzufügen... wählen, eine ID (Kleinbuchstaben, ohne Punkt und Leerzeichen) und optional einen Namen eingeben.
• Löschen: Unterprofil löschen in den Infos des Unterprofils. Gelöscht wird erst beim Speichern.
• Ein Unterprofil hat nur die Reiter Aktionen und Rückmeldung. Verbindung, Abfragen und Kameras gehören zum Hauptprofil.

Speichern

• Speichern schreibt das Profil zurück, unter demselben Namen. Das geht auch, wenn Geräte das Profil verwenden; sie übernehmen die Änderung sofort (siehe Profil ändern). Das Profil gilt danach als im Profil Editor geändert.
• Speichern unter legt ein neues Profil an; das bisherige bleibt unverändert. Ist der Name schon vergeben, wird _2, _3 usw. angehängt.
• Abbrechen verwirft alle Änderungen ohne Rückfrage. Die Esc-Taste fragt vorher nach. Strg+S bzw. ⌘S speichert.

Beim Speichern ergänzt der Editor einiges selbst:

• Die Version steigt um eins, wenn Sie sie nicht selbst geändert haben.
• Ein leerer Klassenname wird aus Hersteller und Modell gebildet.
• Ein Muster in der Rückmeldung, das keinen Wert fängt, bekommt =1 an den Namen (siehe Name und Wert).
• Bei KNX und Z-Wave werden Plattform und Klassenname fest gesetzt und die Rückmeldung reachable entfernt.
• Ein HTTP-Profil ohne Abfrage bekommt die Abfrage „Reachable Check“.
• Wechseln Sie den Engine-Typ weg von CommandServer, entfallen beim Speichern alle Einstellungen, Befehle und Muster der Kommunikation.

Profil ändern

Ein geändertes Profil wirkt auf neue Geräte sofort. Für Geräte, die das Profil schon verwenden, gilt:

• Beschriftungen, Gruppen, Vorlagen und die Formatierung der Werte zeigen App und Konfiguration sofort neu an.
• Befehle, Muster, Skalierung, Abfragen und Webhooks übernehmen bestehende Geräte gleich nach dem Speichern, wenn die Version des Profils höher ist als die, mit der das Gerät angelegt wurde. Der Editor erhöht die Version beim Speichern selbst; wer sie von Hand gesetzt hat, muss sie selbst erhöhen. Der Controller baut die Geräte dafür neu auf: Räume, gespeicherte Werte, Datenaufzeichnung und Automationen bleiben erhalten, die Geräte sind dabei kurz nicht bedienbar.
• Kameras und neu hinzugefügte oder entfernte Unterprofile übernehmen bestehende Geräte nicht. Legen Sie das Gerät dafür neu an.

WARNING

Benennen Sie die ID eines Unterprofils nie um und löschen Sie kein Unterprofil, das Geräte verwenden: Diese Geräte zeigen danach die Werte des Hauptprofils.

Updates aus der Online-Bibliothek

Erscheint ein Profil, das Sie aus der Online-Bibliothek geladen haben, dort in einer neueren Version, zeigt die Profilliste unter der Version Update auf … und in der Zeile eine Schaltfläche Auf Version … aktualisieren. Ein Klick ersetzt das Profil durch die neue Version, die Geräte, die es verwenden, werden gleich danach aktualisiert. In der Online-Bibliothek selbst sind installierte Profile mit Installiert bzw. Update auf … gekennzeichnet; ein erneuter Import dort ersetzt das Profil ebenso.

Haben Sie das Profil im Profil Editor geändert, fragt der Controller vorher nach, denn die neue Version enthält Ihre Änderungen nicht:

• Ersetzen übernimmt die neue Version, auch für die Geräte. Ihre Änderungen gehen verloren.
• Als Kopie lässt Ihr Profil mit seinen Geräten unverändert und speichert die neue Version zusätzlich als eigenes Profil.
• Abbrechen ändert nichts.

Dieselbe Frage stellt der Manuelle Upload, wenn er ein im Profil Editor geändertes Profil ersetzen würde.

Lässt die neue Version Aktionen, Rückmeldungen oder Vorlagen weg, die das Profil bisher hatte, nennt der Controller sie vorher. Automationen, Szenen und Kacheln, die sie verwenden, funktionieren nach dem Update nicht mehr. Trotzdem aktualisieren ersetzt das Profil, Abbrechen lässt alles, wie es ist. Passen Sie betroffene Automationen nach dem Update an.

Bei Fragen zu Profilen hilft support@nomos-system.com.