Geräteprofil · Gateways

Loxone Miniserver (UDP)

Dieses Add-on verbindet einen Loxone Miniserver über die virtuellen Ein- und Ausgänge von Loxone per UDP mit nomos. nomos lauscht auf Port 7700, der Miniserver auf Port 7701.

Dieses Profil ist ein durchgerechnetes Beispiel für folgende Anlage: 10 Lichter, 10 Dimmer, 10 Beschattungen, 1 Temperaturfühler, 1 Feuchtefühler, 1 Helligkeitsfühler, 1 CO2-Fühler, 1 Windmesser, 1 Regenmelder, 1 Bewegungsmelder, 1 Fenster- oder Türkontakt, 1 Rauchmelder, 1 Schalter, 1 Szene, 1 Raumregler. Adressen, die beiden Vorlagen und diese Seite entstehen gemeinsam aus einer Gerätetabelle und passen deshalb garantiert zueinander. Für eine Anlage mit anderem Gerätemix siehe „Ein anderer Gerätemix” am Ende.

Vorbereitung

• Loxone Config läuft nur unter Windows. Sie brauchen die Projektdatei der Anlage.

• Den Aufwand einplanen. Die beiden Vorlagen legen alle Datenpunkte an, das Programm aber nicht. Für dieses Projekt (10 Lichter, 10 Dimmer, 10 Beschattungen, 1 Temperaturfühler, 1 Feuchtefühler, 1 Helligkeitsfühler, 1 CO2-Fühler, 1 Windmesser, 1 Regenmelder, 1 Bewegungsmelder, 1 Fenster- oder Türkontakt, 1 Rauchmelder, 1 Schalter, 1 Szene, 1 Raumregler) fallen an:

  Arbeit	Umfang
  Verbindungen zwischen Bausteinen und importierten Datenpunkten	158
  ODER-Bausteine für die Fahrmeldung (1 je Beschattung, Schritt 3)	10 Bausteine, +20 Verbindungen
  Schwellwert-Bausteine für Dimmer Ein/Aus (1 je Dimmer, Schritt 3)	10 Bausteine, +10 Verbindungen
  Haken „zyklisch senden” (1 je virtuellem Ausgangsbefehl, Schritt 5)	74 Stück

• Die Gerätenamen in der Tabelle unten sind Platzhalter. Licht 01 … Raum 01 sind generisch. Werden sie nicht ersetzt, trägt jedes Gerät in der nomos App einen Platzhalternamen — siehe „Ein anderer Gerätemix”.
• Diese Verbindung ist unverschlüsselt und nicht authentifiziert. nomos nimmt UDP-Pakete auf Port 7700 von jedem Absender an, es gibt keinen Filter. Nur im lokalen Netz oder über einen Tunnel verwenden. Port 7700 niemals aus dem Internet erreichbar machen.

1. Vorlagen importieren

Beide Vorlagen herunterladen — sie gehören zu dieser Seite und passen zum Profil oben:

• VO_nomos.xml — der virtuelle Ausgang, also alle Zustände, die der Miniserver an nomos meldet
• VIU_nomos.xml — der virtuelle UDP-Eingang, also alle Befehle, die nomos an den Miniserver schickt

Beide sind erzeugt. Bitte nie von Hand ändern: eine Änderung hier passt stillschweigend nicht mehr zum Profil, und nichts weist darauf hin.

Die beiden Dateien in die Vorlagenordner von Loxone Config kopieren:

• VO_nomos.xml → Dokumente\Loxone\Loxone Config\Templates\VirtualOut
• VIU_nomos.xml → Dokumente\Loxone\Loxone Config\Templates\VirtualIn

Dann in Loxone Config: Peripherie → Virtuelle Ausgänge → Gerätevorlagen → Vorlage importieren, und dasselbe unter Virtuelle Eingänge.

2. Adresse von nomos eintragen

Den importierten virtuellen Ausgang nomos öffnen und in seiner Adresse <nomos-ip> durch die IP-Adresse des nomos Servers ersetzen, sodass dort /dev/udp/192.168.x.y/7700 steht.

3. Datenpunkte verdrahten

Die importierten Befehle auf die Bausteine ziehen:

• Lichter — Baustein-Ausgang → Ausgangsbefehl li{nn}.sw; Eingang li{nn}.sw → Baustein-Eingang.
• Dimmer, Helligkeit — Helligkeits-Ausgang des Bausteins → Ausgangsbefehl di{nn}.val; Eingang di{nn}.val → Baustein-Eingang.

• Dimmer, Ein/Aus — braucht einen Hilfsbaustein. Der Loxone-Dimmerbaustein hat einen analogen Helligkeitsausgang und keinen digitalen Ein/Aus-Ausgang; es gibt also nichts, womit sich di{nn}.sw direkt verbinden ließe. Einen Schwellwert (oder Vergleicher) an den Helligkeitsausgang hängen — „Helligkeit > 0” — und dessen digitalen Ausgang auf den Ausgangsbefehl di{nn}.sw legen. Einen je Dimmer (10 in diesem Projekt).

  di{nn}.sw ist neben di{nn}.val nicht überflüssig: nomos verlangt überall dort ein state-Mapping, wo level vorkommt, und die getrennte Ein/Aus-Leitung ist das, was die letzte Helligkeit über ein Aus/Ein hinweg erhält — beim Einschalten kehrt der Dimmer auf den vorherigen Wert zurück statt auf 100 %.

• Beschattung, Position und Lamellen — Positions- und Lamellenausgang des Bausteins → ja{nn}.pos bzw. ja{nn}.lam; die Eingänge ja{nn}.pos und ja{nn}.lam → auf die Positions- und Lamelleneingänge des Bausteins.
• Beschattung, Fahrbefehle — die Eingänge ja{nn}.cmd=up / =down / =stop → auf die Eingänge Auf, Ab und Stopp des Jalousiebausteins. Sie werden am vollständigen Titel samt Wert unterschieden; die Tabelle am Ende dieser Seite führt sie je Beschattung auf.
• Beschattung, Fahrmeldung — braucht einen Hilfsbaustein. Der Loxone-Jalousiebaustein hat keinen einzelnen Ausgang „fährt”. Er hat getrennte digitale Ausgänge für Auf-aktiv und Ab-aktiv. Je Beschattung einen ODER-Baustein einfügen, beide Ausgänge hineinführen und dessen Ausgang auf den Ausgangsbefehl ja{nn}.mov legen. Einen je Beschattung (10 in diesem Projekt). Ohne ihn wird traveling in nomos nie wahr.
• Temperaturfühler — der Temperaturausgang des Fühlers oder Bausteins → Ausgangsbefehl tm{nn}.val. Grad Celsius, eine Nachkommastelle.
• Feuchtefühler — der Ausgang für die relative Feuchte → Ausgangsbefehl hu{nn}.val. Prozent, 0–100.
• Helligkeitsfühler — der Helligkeitsausgang (Lux) → Ausgangsbefehl lx{nn}.val. Lux.
• CO2-Fühler — der CO2-Ausgang → Ausgangsbefehl co{nn}.val. ppm.
• Windmesser — der Ausgang für die Windgeschwindigkeit → Ausgangsbefehl wd{nn}.val. Meter pro Sekunde, eine Nachkommastelle — liefert die Quelle km/h, vorher umrechnen.
• Regenmelder — der digitale Regenausgang → Ausgangsbefehl rn{nn}.val. 1 = es regnet.
• Bewegungs- und Präsenzmelder — der digitale Bewegungs- oder Präsenzausgang → Ausgangsbefehl mo{nn}.val. 1 = Bewegung erkannt.
• Fenster- und Türkontakte — der digitale Kontakteingang → Ausgangsbefehl ct{nn}.val. 1 = offen, 0 = geschlossen. Ein Kontakt, der im geschlossenen Zustand 1 meldet, muss in Loxone Config invertiert werden, sonst zeigt nomos jedes geschlossene Fenster als offen.
• Rauchmelder — der digitale Alarmausgang → Ausgangsbefehl sm{nn}.val. 1 = Alarm. nomos zeigt ihn nur an und ersetzt keine Brandmeldeanlage.
• Schalter — der Ausgangsbaustein (Relais, Steckdose, Stromstoßschalter) → Ausgangsbefehl sw{nn}.sw; Eingang sw{nn}.sw → Eingang des Bausteins. Wie bei einem Licht.
• Szenen — der Eingang sc{nn}.cmd=go → auf das, was nomos auslösen soll: eine Stimmung des Lichtbausteins, ein „Alles aus”, jeden Impulseingang. Es ist ein Impuls; er löst bei jedem Tippen in der App aus. Er löst außerdem bei jedem Ein/Aus-Befehl aus, der an den ganzen Raum oder das ganze Geschoss geht — Szenen deshalb nur auf Aktionen legen, die sich gefahrlos wiederholen lassen.
• Raumregler, Isttemperatur — der Istwert-Ausgang des Raumreglers → Ausgangsbefehl rt{nn}.tmp.
• Raumregler, Solltemperatur — der Sollwert-Ausgang des Reglers → Ausgangsbefehl rt{nn}.set; der Eingang rt{nn}.set → auf den Komforttemperatur-Eingang des Reglers.
• Raumregler, Heizen — der Ausgang „Heizen aktiv” des Reglers → Ausgangsbefehl rt{nn}.hz.

Position und Lamellenwinkel werden in den Vorlagen umgerechnet: der Jalousiebaustein arbeitet mit 0–1, auf der Leitung laufen 0–100. Keinen zusätzlichen Skalierungsbaustein einfügen.

Polarität der Position: 0 = ganz offen, 100 = ganz geschlossen, in beide Richtungen und auf beiden Seiten der Verbindung. Zeigt eine Beschattung in nomos 100, während der Behang oben steht, ist die Polarität irgendwo im Loxone-Programm vertauscht — das bitte nicht dadurch „reparieren”, dass man nur eine Richtung invertiert.

4. Lebenszeichen verdrahten — nicht überspringen

Den virtuellen Eingang sys.ping mit dem virtuellen Ausgangsbefehl sys.alive verbinden.

nomos schickt alle 30 Sekunden sys.ping und erwartet binnen 2 Sekunden eine Antwort. Ohne diese Verbindung kommt die Antwort nie, nomos hält den Miniserver für nicht erreichbar, und das Gerät bleibt in der App offline. Keine Vorlage kann diese Verbindung anlegen.

Der Eingang sys.ping ist ein Impuls: er löst bei jedem eingehenden Ping aus, nicht nur beim ersten.

5. Zyklisches Senden einschalten

UDP garantiert keine Zustellung; ein verlorenes Paket bedeutet einen veralteten Wert, bis sich etwas ändert. Deshalb an den virtuellen Ausgangsbefehlen die zyklische Wiederholung einschalten (etwa alle 30 Sekunden). Das ist die einzige Selbstheilung dieser Verbindung.

Die Vorlagen werden mit ausgeschalteter Wiederholung ausgeliefert, damit in einer laufenden Anlage kein unpassender Wert gesetzt wird. Es ist deshalb Handarbeit, und zwar ein Haken je virtuellem Ausgangsbefehl: 74 für dieses Projekt. Jeden Befehl öffnen und das zyklische Senden ankreuzen.

6. nomos einrichten

Das Add-on Loxone Miniserver (UDP) hinzufügen und die IP-Adresse des Miniservers eintragen. Die Ports sind vorbelegt: 7701 ausgehend, 7700 lauschend. Sie bleiben, solange sie sich nicht mit etwas anderem auf der Maschine überschneiden.

Gerätetabelle

Die Namen sind Platzhalter — siehe „Vorbereitung”.

Ein anderer Gerätemix

Dieses Beispiel deckt ab: 10 Lichter, 10 Dimmer, 10 Beschattungen, 1 Temperaturfühler, 1 Feuchtefühler, 1 Helligkeitsfühler, 1 CO2-Fühler, 1 Windmesser, 1 Regenmelder, 1 Bewegungsmelder, 1 Fenster- oder Türkontakt, 1 Rauchmelder, 1 Schalter, 1 Szene, 1 Raumregler. Am Verfahren ist nichts darauf festgelegt: Profil, beide Vorlagen und diese Seite stammen aus einer Gerätetabelle, aus der ein Generator alle vier erzeugt. Eine Anlage mit anderen Stückzahlen, anderen Namen oder anderem Raumzuschnitt bekommt ihren eigenen Satz, genauso erzeugt und genauso stimmig.

Eines sollte man nicht tun: eine der vier Dateien von Hand ändern. Sie funktionieren nur, weil sie gemeinsam erzeugt wurden — eine per Hand geänderte Adresse in einer Datei läuft in den anderen stillschweigend ins Leere.

Einen Satz für Ihre Anlage anfordern

devices.csv herunterladen — die Gerätetabelle, aus der dieses Beispiel erzeugt wurde — und anpassen:

• Eine Zeile je Gerät, drei Spalten: type, index, name.
• type ist einer der Typen aus der Tabelle unten.
• index läuft von 1 bis 99 und muss je Typ eindeutig sein. Zusammen mit dem Adresspräfix des Typs ergibt er die Adresse des Geräts — li01 ist Licht 1 — und damit die Namen seiner Datenpunkte in Loxone Config.
• name ist der Name in der nomos App. Die Platzhalter durch die Raumnamen ersetzen; Namen dürfen keine Kommas und Semikolons enthalten.
• Zeilen ergänzen oder löschen, wie die Anlage es braucht. Zeilen mit # sind Notizen und können stehen bleiben.

Die Datei in Excel zu bearbeiten ist in Ordnung: als CSV gespeichert wird sie mit Komma wie mit Semikolon und in jeder Kodierung, die Excel anbietet, richtig gelesen.

Die fertige Datei an support@nomos-system.com schicken — Sie bekommen das passende Profil, beide Vorlagen und eine Seite wie diese für Ihre Anlage zurück.