Skip to main content

🔗 Alias-Datenpunkte in ioBroker

Alias-Datenpunkte sind eine Abstraktionsschicht zwischen Skripten bzw. Visualisierungen und den echten GerÀte-Datenpunkten.

Skripte und Visualisierungen greifen nur auf den Alias zu. Der dahinterliegende echte Datenpunkt kann geĂ€ndert werden, ohne dass Skripte oder Visualisierungen angepasst werden mĂŒssen.

Das ist beim ersten Mal zwar mehr Arbeit, erleichtert aber zukĂŒnftige Änderungen, wie z.B. einen GerĂ€tetausch oder die Nutzung eines neuen Adapters, erheblich.

Pro GerÀt werden nur die Standard-States angelegt. Das bedeutet, es werden nicht alle Datenpunkte aliasiert, sondern nur die tatsÀchlich verwendeten. Das ist eine saubere und langfristig wartbare Methode.

Beispiele:

  • Relais: currentValue, targetValue
  • Steckdose: currentValue, targetValue, power
  • Dimmer: currentValue, targetValue, duration
  • Sensoren: temperature, humidity, value

Beispiel: Vorbereitung fĂŒr die Umstellung von ioBroker.zwave2 auf ioBroker.zwavews

Der Adapter ioBroker.zwave2 wird nicht mehr weiterentwickelt. Als Nachfolger ist ioBroker.zwavews vorgesehen (Stand: Februar 2026). Dieser basiert auf zwave-js-ui und verbindet diese mit ioBroker. Dabei erstellt er entsprechende Datenpunkte fĂŒr die vorhandenen GerĂ€te in ioBroker.

Diese Anleitung dient als Beispiel und wurde als Vorbereitung fĂŒr die Umstellung von Z-Wave2 auf Z-Wave JS UI erstellt.

Das Verzeichnis und das GerĂ€t werden zuerst angelegt. Dadurch bleibt die Struktur einheitlich und eine bessere Übersicht der Alias-Datenpunkte wird gewĂ€hrleistet.

Namenskonvention

Tipp:
Verwende niemals Leerstellen in Datenpunkten, um mögliche Probleme in Skripten zu vermeiden.

Beispiele:

❌ Wohnzimmer Licht
✔ Wohnzimmer_Licht
✔ WohnzimmerLicht

Alias ĂŒber die Admin-OberflĂ€che einrichten

Öffne ioBroker Admin

  • Gehe zu Objekte
  • Navigiere zu: alias.0

1) Verzeichnis erstellen

Klicke auf: ➕ → Neues Objekt hinzufĂŒgen (alias.0.Neues GerĂ€t)

  • Erstelle ein Verzeichnis unter alias.0
  • Typ: Verzeichnis (folder)
  • Name: Z-Wave

2) GerÀt erstellen

Klicke im neu erstellten Ordner Z-Wave auf: ➕ → Neues Objekt hinzufĂŒgen (alias.0.Z-Wave.Neues GerĂ€t)

  • Erstelle ein GerĂ€t unter alias.0.Z-Wave
  • Typ: GerĂ€t (device)
  • Name: Relais-Klingel

3) Alias-Pfad merken und Alias erstellen

Kopiere oder merke dir:

Z-Wave.Relais-Klingel

(ohne alias.0 am Anfang)

Gehe zu deinen Z-Wave Objekten, z.B. zwave2.0, suche die entsprechende Node und erstelle ein Alias dafĂŒr.

4) Alias erstellen und ID anpassen

Im KontextmenĂŒ von currentValue → Alias erstellen

Alles belassen, nur die Alias-ID ersetzen durch:

Z-Wave.Relais-Klingel.currentValue

Danach öffnet sich ein neues Fenster, in dem du das neue Objekt bearbeiten kannst.

In der Regel kann man hier abbrechen, da spÀtere Anpassungen jederzeit möglich sind.

Der Zustandstyp (z.B. boolean, lesbar/beschreibbar) wurde bei mir immer korrekt ĂŒbernommen.

5) Alias fĂŒr targetValue erstellen

Das Gleiche mache ich mit targetValue, also Alias-ID Z-Wave.Relais-Klingel.targetValue erstellen.

Wiederholung fĂŒr weitere GerĂ€te

Die Schritte 2 bis 5 gehe ich anschließend mit allen meinen GerĂ€ten der Reihe nach durch und erstelle die entsprechenden Alias-Datenpunkte.

Hinweis

Unter den jeweiligen Objekten, sowohl unter den Z-Wave Nodes als auch unter den Aliasen, steht ein Link, um schnell zwischen dem Alias und dem Node hin und her wechseln zu können.

Abschluss

So gehe ich alle meine GerÀte der Reihe nach durch und passe dann meine Skripte an, damit ich bei einer Umstellung die Skripte nicht wieder anpassen muss.

Z-Wave_Alias.png

Bonus

🔄 Konvertierungsfunktionen bei Alias-Datenpunkten

Mit den Konvertierungsfunktionen im Alias in ioBroker kannst du Werte automatisch umrechnen:

  • beim Lesen: Original → Alias
  • beim Schreiben: Alias → Original

Grundprinzip

Du hast immer die Variable val. Diese enthÀlt den aktuellen Wert, der gelesen oder geschrieben wird.

Beispiel 1: Prozent ↔ Dimmerwert

GerĂ€t nutzt: 0–255
Alias soll: 0–100 %

Konverter beim Lesen:

val / 255 * 100

Konverter beim Schreiben:

val / 100 * 255

Beispiel 2: Boolean umkehren (invertiertes Relais)

Manche Relais arbeiten invertiert.

Konverter beim Lesen und Schreiben:

!val

Beispiel 3: TĂŒr- oder Fenstersensor

Beispielwerte vom GerÀt:

  • TĂŒr auf = 22 → soll true werden
  • TĂŒr zu = 23 → soll false werden

Wichtig: Alias-Datentyp setzen

Typ: boolean

Rolle: sensor.door oder sensor.window

(alternativ: state)

Konverter beim Lesen:

val == 22

Bedeutung:

  • Wert 22 → true
  • alle anderen Werte → false
Back to top