ioBroker ALIAS Definitionen
Seite befindet sich noch im Aufbau
Sollte aktuell ein Alias nicht vollständig beschrieben werden, dann gerne eine Frage am Ende des nachfolgenden Thread stellen: https://forum.iobroker.net/topic/58170/sonoff-nspanel-mit-lovelace-ui
Welche Hilfsmittel werden zur Erstellung eines Alias benötigt?:
Der "Geräte verwalten"-Adapter für die meisten Alias-Typen:
Achtung zur Zeit ist die Version 1.1.2 fehlerhaft, bitte bei 1.1.1 bleiben
Der "Alias-Manager"-Adapter für spezielle Alias-Typen, wie dem Alias "Media":
Ich habe die zwei Adapter installiert. Wie bekomme ich die in das ioBroker-Menü:
Über das Stift-Symbol im ioBroker-Hauptmenü lassen sich die Adapter individuell für jeden Benutzer ein- oder ausschalten.
Es sollte ein Haken bei Geräte und Alias-Manager gesetzt sein.
Was sind Aliase:
Aliase (Pseudonyme) sind die virtuellen Zustandsobjekte, die mit realen Zuständen (Datenpunkten) verknüpft sind.
Warum benötige ich im TS-Skript überhaupt Aliase und keine Datenpunkte?
Das TS-Script für das Sonoff NSPanel ist so aufgebaut, dass eigentlich jeder Adapter zur Steuerung benutzt werden kann. Hierbei haben die Entwickler von Adaptern für gleiche Funktionen unterschiedliche Namen verwendet:
Beispiel:
- Sonoff-Adapter: .power (aus Tasmota übertragen)
- MQTT-Adapter: .power (aus Tasmota übertragen)
- Shelly-Adapter: .switch
- KNX-Adapter: .switch
- Deconz-Adapter: .on
- etc.
Also immer der Wunsch, einen Zustand eines Aktors mit true/false zu verändern.
Innerhalb der Licht-Adapter wird das später noch deutlicher
Der Alias benötigt also anstatt .Power oder .Switch oder .On immer nur ein .SET, damit der Zustand des Schalt-Aktor's unabhängig vom installierten Adapter geschaltet werden kann. In diesem Fall meldet der im Skript eingebundene Alias ein true oder false in den Alias-Datenpunkt .SET und reicht den Zustandswert an den zugewiesenen spezifischen Adapter-Datenpunkt (ganz egal welcher Typ erwartet wird) weiter.
Zunächst sollt man sich überlegen, welche Aliase nur für ein bestimmtes NSPanel gelten sollen oder für mehrere NSPanels oder sogar innerhalb anderer Visualisierungsarten z.B. ioBroker VIS mitverwendet werden sollen. Dann kann man die Alias Struktur entsprechend mit Ordnern und Unterordnern verfeinern. Das Bürolicht soll z.B. nur über NSPanel_1 geschaltet werden, aber nicht über NS_Panel_2. Das Wetter hingegen ist für alle NSPanel gleich.
Der erste Schritt in der Alias Erstellung mit dem "Geräte verwalten"-Adapter ist fast immer der gleiche.
Es wird über die "+" Schaltfläche folgender Dialog aufgeschaltet:
Jetzt gibst vergibst du einen "sprechenden Namen" für den Alias in der Zeile "Gerätename" und wählst einen der nachfolgenden "Alias-Typen" unter Gerätetyp aus (Auswahlliste wird aufgeschaltet und beinhaltet auch noch weitere Typen als im Bild gezeigt (Momentaufnahme)):
Achtung:
Nicht jeder Gerätetyp (Alias-Typ) funktioniert mit dem NSPanel, sondern nur die, die entweder im weiteren Verlauf benannt sin, oder die im Header des TypeScript definiert sind.
Die Zeilen Funktion und Raum können ebenfalls ausgewählt werden, haben jedoch keinen Einfluss auf die Funktionalität des NSPAnel's
siehe auch das Beispiel zur vollständigen Integration der cardAlarm in den ioBroker:
https://github.com/joBr99/nspanel-lovelace-ui/wiki/ioBroker---FAQ-&-Anleitungen#2-alarm-page
Der Alias "Dimmer" hat 2 relevante Eigenschaften.
- Schalter (an/aus) über Adapter-Datenpunkte on, switch, power, etc.
- Helligkeit (dunkel/hell) über Adapter-Datenpunkte level, brightness, bri, etc.
Im Beispiel ist eine dimmbare Deckenbeleuchtung über den DeConz-Adapter (Zigbee)
Der Schalter im DeConz wird über den Datenpunkt "on" (true/false), d.h Datentyp "boolean" gesteuert. Die Helligkeit wird im Deconz-Adapter über "level" 0-100 oder "bri" 0-255 gesteuert. Für uns bietet sich also der Datenpunkt level an, da dieser bereits die Helligkeit in % von 0% bis 100% beinhaltet. Jedoch könnten wir auch mit dem Datentyp bri arbeiten und im TypeScript die Umrechnung von 255 (absolut) auf 100 (%) parametrieren.
Der Dimmer kann in einer cardEntities oder in einer cardGrid platziert werden. (Nachfolgende Abb. cardEntities):
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Dimmer an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des DeConz-Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung.
Der Schaltzustand (Lampe an/aus) kann direkt aus der cardEntities oder carGrid erfolgen. Für die Regelung der Helligkeit hat der Alias-Gerätetyp "Dimmer" bereits eine Unterseite (siehe nachfolgende Abb.). Diese kann über einen Klick auf den Dimmer-Bezeichner (in diesem Fall "Deckenbeleuchtung") aufgeschaltet werden:
Das zugehörige PageItem im TypeScript:
Mit dem Parameter "name" legen wir den Anzeigenamen fest.
Mit dem Parameter "interpolateColor" (optional), soll die abgebildete Lampe (Icon) den An/Aus und die Helligkeit emulieren.
Es können noch weitere Parameter übergeben werden:
- icon
- onColor
- offColor
- minValueBrightness (Default = 0)
- maxValueBrightness (Default = 100; im Beispiel mit dem Datenpunkt "bri" also 255)
Der Alias "Farbtemperatur" hat 3 relevante Eigenschaften.
- Schalter (an/aus) über Adapter-Datenpunkte on, switch, power, etc.
- Helligkeit (dunkel/hell) über Adapter-Datenpunkte level, brightness, bri, etc.
- Farbtemperatur (K = Kelvin) über Adapter-Datenpunkte ct, colortemp, etc.
Der Alias "Farbtemperatur" kann in einer cardEntities oder in einer cardGrid platziert werden. (Nachfolgende Abb. cardEntities):
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Farbtemperatur an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung.
Der Schaltzustand (Lampe an/aus) kann direkt aus der cardEntities oder carGrid erfolgen. Für die Regelung der Helligkeit und CT hat der Alias-Gerätetyp "Farbtemperatur" bereits eine Unterseite (siehe nachfolgende Abb.). Diese kann über einen Klick auf den Bezeichner (in diesem Fall "Farbtemperatur") aufgeschaltet werden:
Das zugehörige PageItem im TypeScript:
Mit dem Parameter "name" legen wir den Anzeigenamen fest.
Mit dem Parameter "interpolateColor" (optional), soll die abgebildete Lampe (Icon) den An/Aus und die Helligkeit emulieren.
Es können noch weitere Parameter übergeben werden:
- icon
- onColor
- offColor
- minValueBrightness (Default = 0)
- maxValueBrightness (Default = 100; im Beispiel mit dem Datenpunkt "bri" also 255)
- minValueColorTemp (z.B. 500 - in Abhängigkeit des jeweiligen Adapters)
- maxValueColorTemp: (z.B. 6500 - in Abhängigkeit des jeweiligen Adapters)
Hinweis: Es kann auch der HUE-CT verwendet werden
Der Alias "Fenster" hat 1 relevante Eigenschaft.
- Zustand (offen/geschlossen) über Adapter-Datenpunkte open, etc.
Darstellung in einer "cardGrid"
Darstellung in einer "cardEntities"
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Fenster an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt den Datenpunkt des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Das zugehörige PageItem im TypeScript:
Der Alias "Feuchtigkeit" hat 1 relevante Eigenschaft.
- Zustand (Sensorwert)
Im Beispiel ist ein Homatic IP Sensor über den hmip-Adapter (Funk). Es kann aber auch jeder andere Sensor (z.B. Zigbee oder WLAN) oder ein Datenpunkt aus einem Wetter-Adapter verwendet werden.
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Feuchtigkeit an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Das zugehörige PageItem im TypeScript:
Folgende Parameter können verwendet werden:
- name: legt den Anzeigenamen fest
- icon: Symbol
- unit: Einheit der Luftfeuchte
- onColor: Farbe des Icons
<PageItem>{ id: "alias.0.NSPanel_1.TestFeuchtigkeit", name: "Luftfeuchte außen", icon: "water-percent", unit: "%H", onColor: White}
Hinweis
Alternativ kann auch der Alias-Typ "Info" verwendet werden.
Der Alias Geräte-Typ HUE-Licht funktioniert mit und ohne dem Wert "HUE". Wenn der Datenpunkt .HUE nicht vorhanden ist, wird durch das TypeScript automatisch eine CT (ColorTemperature-Steuerung emuliert)
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ HUE-Licht an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Der Schaltzustand (Lampe an/aus) kann direkt aus der cardEntities oder carGrid erfolgen. Für die Regelung der Helligkeit, Farbtemperatur und (wenn vorhanden) Farbe hat der Alias-Gerätetyp "HUE-Licht" bereits eine Unterseite (siehe nachfolgende Abb.). Diese kann über einen Klick auf den Bezeichner aufgeschaltet werden:
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Info an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Beispiel für das PageItem
<PageItem>{ id: "alias.0.NSPanel_1.TestInfo", name: "Windstärke", icon: "wind-power-outline", offColor: MSRed, onColor: MSGreen, unit: "bft", minValue: 0, maxValue: 12, interpolateColor: true, useColor: true }
Parameter name: icon: offcolor: oncolor: unit: minValue: maxValue: interpolateColor: useColor:
Und die zugehörige Detailseite
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Jalousie an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Beispiel für das PageItem:
<PageItem>{ id: "alias.0.NSPanel_1.TestBlind", onColor: White, name: "IKEA Fyrtur", secondRow: "Hier Text für 2. Zeile"},
Bereits in der FAQ & Anleitung beschrieben: https://github.com/joBr99/nspanel-lovelace-ui/wiki/ioBroker---FAQ-&-Anleitungen#8-rolladen--jalousie--shutter
Analog zum Alias "Lautstärkegruppe", jedoch mit dem Alias-Gerätetypen "Lautstärke"
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ HUE-Licht an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Das zugehörige PageItem im TypeScript:
Parameter:
name: Vom Alias abweichender Name
offColor: wenn Muted
onColor: wenn nicht Muted
minValue: Minimale Lautstärkewert (Default 0)
maxValue: Minimale Lautstärkewert (Default 100)
Zur Steuerung von Leuchtmitteln ohne Farbtemperatur oder Farbeffekten (Alternativ kann auch Socket verwendet werden).
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Licht an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Der Alias-Medien für die cardMedia lässt sich mit dem Geräte-Manager nicht erstellen. Auch mit dem Alias-Manager unter "Automatisch erstellen" aus einem Player-Pfad ist das je nach Adapter eher eine Zufallsproduktion.
Es gibt von britzelpuf bereits einen noch offenen github-Issue: https://github.com/ioBroker/ioBroker.devices/issues/152 seit dem 17.03.2022
Der Alias gibt aktuell nur einen .ACTUAL her. Das ist jedoch für einen Media-Player definitiv zu wenig.
Es wird bis auf die Aliase für die Squeezebox kein manuell erstellter Alias mehr benötigt. In der Javascript Instanz muss "Kommando SetObject erlauben" aktiviert werden!
Obwohl das alles Aliase vom Typ Medien sind, sehen bis auf zwei alle anderen nicht korrekt aus, sind aber in der Objektstruktur korrekt und funktionieren auch mit dem NSPanel
Anleitung:
- Wenn das erste mal die Seite aufgerufen wird, wird der Alias automatisch erzeugt. Die Seite ist zu diesem Zeitpunkt schwarz.
- Sobald der Screensaver aufgeschaltet und wieder entfernt wird, ist der Player einsatzbereit.
Anleitung:
- Wenn das erste mal die Seite aufgerufen wird, wird der Alias automatisch erzeugt. Die Seite ist zu diesem Zeitpunkt schwarz.
- Sobald der Screensaver aufgeschaltet und wieder entfernt wird, ist der Player einsatzbereit.
Anleitung:
- Wenn das erste mal die Seite aufgerufen wird, wird der Alias automatisch erzeugt. Die Seite ist zu diesem Zeitpunkt schwarz.
- Sobald der Screensaver aufgeschaltet und wieder entfernt wird, ist der Player einsatzbereit.
Anleitung:
- Wenn das erste mal die Seite aufgerufen wird, wird der Alias automatisch erzeugt. Die Seite ist zu diesem Zeitpunkt schwarz.
- Sobald der Screensaver aufgeschaltet und wieder entfernt wird, ist der Player einsatzbereit.
Anleitung:
- Wenn das erste mal die Seite aufgerufen wird, wird der Alias automatisch erzeugt. Die Seite ist zu diesem Zeitpunkt schwarz.
- Sobald der Screensaver aufgeschaltet und wieder entfernt wird, ist der Player einsatzbereit.
Skript zum Anlegen eines SqueezeBoxRPC - media-Alias (ab Version 3.4.0.6)
Spoiler: JavaScript Code für Erstellung eines SqueezeBoxRPC -Alias
const aliasPath = 'alias.0.Media.LMS'; // ggfs. Anpassen
const aliasDevice = 'SqueezePlay'; // ggfs. Anpassen
//Ergibt alias.0.NSPanel_1.Media.SqueezeBoxRPC
const squeezeBoxInstanz = 'squeezeboxrpc.0.Players.'; // Anpasssen, wenn nicht Instanz 0
const squeezeBoxDevice = 'SqueezePlay'; // Anpassen an dein eigenes Device
var typeAlias, read, write, nameAlias, role, desc, min, max, unit, states, custom;
function createAlias(idDst, idName,idSrc, idRd, idType, idRole, idAliasType) {
if(existsState(idDst)) log(idDst + ' schon vorhanden !', 'warn');
else {
var obj = {};
obj.type = idType;
obj.common = getObject(idSrc).common
obj.common.alias = {};
if(idRd) {
obj.common.alias.id = {};
obj.common.alias.id.read = idRd;
obj.common.alias.id.write = idSrc;
obj.common.read = true;
} else {
obj.common.alias.id = idSrc;
}
obj.common.type = idAliasType;
if(obj.common.read !== false && read) obj.common.alias.read = read;
if(obj.common.write !== false && write) obj.common.alias.write = write;
obj.common.name = idName;
obj.common.role = idRole;
obj.common.desc = idDst;
if(min !== undefined) obj.common.min = min;
if(max !== undefined) obj.common.max = max;
if(unit) obj.common.unit = unit;
obj.common.states = states;
if(custom && obj.common.custom) obj.common.custom = custom;
obj.native = {};
setObject(idDst, obj);
}
}
createAlias(aliasPath + '.' + aliasDevice + '.ALBUM', 'ALBUM', squeezeBoxInstanz + squeezeBoxDevice + '.Album', '', 'state', 'media.album', 'string');
createAlias(aliasPath + '.' + aliasDevice + '.ARTIST', 'ARTIST', squeezeBoxInstanz + squeezeBoxDevice + '.Artist', '', 'state', 'media.artist', 'string');
createAlias(aliasPath + '.' + aliasDevice + '.TITLE', 'TITLE', squeezeBoxInstanz + squeezeBoxDevice + '.Title', '', 'state', 'media.title', 'string');
createAlias(aliasPath + '.' + aliasDevice + '.NEXT', 'NEXT', squeezeBoxInstanz + squeezeBoxDevice + '.btnForward', '', 'state', 'button.forward', 'boolean');
createAlias(aliasPath + '.' + aliasDevice + '.PREV', 'PREV', squeezeBoxInstanz + squeezeBoxDevice + '.btnRewind', '', 'state', 'button.reverse', 'boolean');
createAlias(aliasPath + '.' + aliasDevice + '.PLAY', 'PLAY', squeezeBoxInstanz + squeezeBoxDevice + '.state', '', 'state', 'media.state', 'boolean');
createAlias(aliasPath + '.' + aliasDevice + '.PAUSE', 'PAUSE', squeezeBoxInstanz + squeezeBoxDevice + '.state', '', 'state', 'media.state', 'boolean');
createAlias(aliasPath + '.' + aliasDevice + '.STOP', 'STOP', squeezeBoxInstanz + squeezeBoxDevice + '.state', '', 'state', 'media.state', 'boolean');
createAlias(aliasPath + '.' + aliasDevice + '.STATE', 'STATE', squeezeBoxInstanz + squeezeBoxDevice + '.Power', '', 'state', 'switch', 'number');
createAlias(aliasPath + '.' + aliasDevice + '.VOLUME', 'VOLUME', squeezeBoxInstanz + squeezeBoxDevice + '.Volume', '', 'state', 'level.volume', 'number');
createAlias(aliasPath + '.' + aliasDevice + '.VOLUME_ACTUAL', 'VOLUME_ACTUAL', squeezeBoxInstanz + squeezeBoxDevice + '.Volume', '', 'state', 'value.volume', 'number');
Anleitung:
- Neues Skript (JavaScript JS) anlegen
- Code kopieren und einfügen
- Skript aktivieren und ausführen
- Danach wieder Deaktivieren
Jetzt kommt der spezielle Teil für diesen Adapter. Hierfür sind noch weitere Einstellungen erforderlich:
- Alias Manager öffnen, den neu erstellten Alias auswählen und unter "common.role" media eingeben
- unter Objekte zu den Aliasen (alias.0.) gehen:
Bei **PAUSE **und **PLAY **mit dem Stiftsymbol am Ende der Zeile den Dialog aufschalten und 3. Tab Alias die Konvertierungsfunktionen einschalten und analog der nachfolgenden Bilder anpassen (Konverter beim Lesen):
Jetzt sollte der spueezeboxrpc korrekt arbeiten
Der Alias RGB-Licht wird verwendet, wenn als Color Datenpunkte RED, GREEN, BLUE und WHITE vorliegen
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ RGB-Licht an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Für das Beispiel standen leider keine echten Adapter-Datenpunkte zur Verfügung, daher die Darstellung in 0_userdata.0...
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Das zugehörige PageItem im TypeScript:
Parameter:
name: Vom Alias abweichender Name
offColor: abweichende Farbe für aus
onColor: abweichende Farbe für an
minValueBrightness: Minimale Helligkeit (Default 0)
maxValueBrightness: Minimale Maxiamale Helligkeit (Default 100)
minValueColorTemp: Minimale Farbtemperatur je nach Leuchtmittel/Adapter (z.B. 500K)
maxValueColorTemp: Maximale Farbtemperatur je nach Leuchtmittel/Adapter (z.B. 6500K)
interpolateColor: Errechnet den Farbton und weist diesen dem Icon zu (Beispiel Pink)
Mit klick auf den Bezeichner wird das popUpLight aufgeschaltet:
Der Alias RGB-Licht wird verwendet, wenn als Color Datenpunkt (RGB) im Hexadezimal-Format (z.B. #7dff7e) vorliegt.
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ RGB-Licht an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Für das Beispiel standen leider keine echten Adapter-Datenpunkte zur Verfügung, daher die Darstellung in 0_userdata.0...
Alternativ kann dieser Alias auch via CIE, d.h über den XY Parameter (z.B. beim deConz-Adapter) gesteuert werden:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Das zugehörige PageItem im TypeScript:
Parameter:
name: Vom Alias abweichender Name
offColor: abweichende Farbe für aus
onColor: abweichende Farbe für an
minValueBrightness: Minimale Helligkeit (Default 0)
maxValueBrightness: Minimale Maxiamale Helligkeit (Default 100)
minValueColorTemp: Minimale Farbtemperatur je nach Leuchtmittel/Adapter (z.B. 500K)
maxValueColorTemp: Maximale Farbtemperatur je nach Leuchtmittel/Adapter (z.B. 6500K)
interpolateColor: Errechnet den Farbton und weist diesen dem Icon zu (Beispiel Grün)
colormode: "xy" oder "rgb" (default) zur Steuerung der CIE XY Color-Datenpunkte
Mit klick auf den Bezeichner wird das popUpLight aufgeschaltet:
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Schieberegler an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Das zugehörige PageItem im TypeScript:
<PageItem>{ id: "alias.0.NSPanel_1.Dimmode_BrightnessDay", name: "Brightness Tag", icon: "brightness-5", offColor: MSYellow, onColor: MSYellow, useColor: true, minValue: 5, maxValue: 10}
Parameter:
name: Vom Alias abweichender Name
offColor: abweichende Farbe für aus
onColor: abweichende Farbe für an
icon: zu visualisierendes Icon
minValue: Minimaler Sliderwert
maxValue: Maximaler Sliderwert
usecolor:
Alternativ kann der Alias Licht verwendet werden!
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Steckdose an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Das zugehörige PageItem im TypeScript:
<PageItem>{ id: "alias.0.NSPanel_1.Luftreiniger", icon: "power", icon2: "power",offColor: MSRed, onColor: MSGreen}
Parameter:
name: Vom Alias abweichender Name
offColor: abweichende Farbe für aus
onColor: abweichende Farbe für an
icon: zu visualisierendes Icon für On
icon2: zu visualisierendes Icon für Off
Beschreibung für den Alias Taste folgt...
ab Release 3.7.0
Das popupInSel dient der Auswahl von Werten in einer Aufzählung (Liste/Array) und wird in einer cardGrid platziert
ALIAS:
über das '+' Icon im Gerätemanager wird ein DP ".VALUE" angelegt. Dieser verweist auf eine numerische-Aufzählung oder einen numerischen Datenpunkt zur Weiterverarbeitung. Zurückgegeben wird der Wert aus dem Parameter "modeList" beginnend mit 0 (analog Array).
PageItem:
<PageItem>{ id: "alias.0.NSPanel_EMU.TestButtonSensor",
icon: "select-color",
name: "WLED Effekte",
onColor: White,
modeList: [ 'Solid', 'Android', 'Aurora', 'Blends', 'Blink', 'Bpm', 'Breathe',
'Candle', 'Candle Multi', 'Candy Cane', 'Chase', 'Chase 1', 'Chase 2', 'usw.']},
Beschreibung für den Alias Temperatur folgt...
Zunächst legen wir analog "Schritt 1" (Tab Allgemein) einen Alias vom Typ Thermostat an. Im "Schritt 2" (Tab Zustände) weisen wir jetzt die Datenpunkte des Adapters zu:
Im unteren Teil können ebenfalls Indikatoren eingeblendet werden:
z.B.
oder
etc.
Wenn der Thermostat über Mode verfügt und dieser auch genutzt werden soll:
Mode wird über externe Datenpunkte gesteuert. Hierzu legst du dir unter 0_userdate.0. einen Ordner deiner Wahl an. In diesem Ordner können jetzt bis zu 5 Datenpunkte (Alle vom Typ boolean (true/false)) angelegt werden:
- AUTOMATIC
- MANUAL
- PARTY
- VACATION
- BOOST
Im Alias können "BOOST" und "PARTY" (sofern gewünscht) bereits den neu erstellten Datenpunkten zugewiesen werden:
Die Datenpunkte AUTOMATIC, MANUAL und VACATION können nicht sofort zugewiesen werden, da die ALIAS-Definition diese Objekte nicht vorsieht. In diesem Fall kannst du diese selbst hinzufügen und im Anschluss deine erstellten Datenpunkten zuordnen:
Jetzt speicherst du den neu erstellten Alias. Unter ioBroker Objekte (Verzeichnisbaum alias.0.NSPanel.X...) siehst du jetzt folgende Darstellung:
Es müssen nicht alle 5 Modi vorhanden sein. Das Skript liest die vorhandenen Modi ein und verarbeitet auch nur diese
Insgesamt stehen Icons im unteren Bereich zur Verfügung. Somit ist es nicht möglich 5 Modi-Icons und 7 Indikatoren-Icons gleichzeitig zu visualisieren. Die Modi (falls im Alias definiert) werden zuerst visualisiert (vorne) und dann, falls verfügbar mit Indikatoren (sofern im Alias definiert) auf insgesamt 8 Icons aufgefüllt.
Das zugehörige PageItem im TypeScript:
Parameter:
name: Vom Alias abweichender Name
minValue: Minimaltemperatur Beispiel 5°C = 50
maxValue: Minimaltemperatur Beispiel 30°C = 300
Ab Release 3.7.0
Für den Timer (Stopp-Uhr) gibt es weder im Geräte-Manager, noch im Alias-Manager einen vorgefertigten ALIAS Gerätetypen. Daher muss dieser eigenhändig erstellt werden.
Objekte
Der Timer greift auf selbsterstellte Datenpunkte zurück, welche (analog Beispiel) wie folgt angelegt werden müssen.
- 0_userdata.0...Timer_1.ACTUAL --> number --> Nimmt die eingestellte Zeit aus dem NSPanel in Sekunden auf und wird bei Ausführung durch das externe Script dekrementiert.
- 0_userdata.0...Timer_1.STATE --> string --> Erhält den Status vom Blockly und vom NSPanel
Korrekte Erstellung des ALIAS level.timer
Direkt unter Objekte --> alias.0. mit dem "+" die gewünschte Verzeichnisstruktur erzeugen
Dann mit dem "+" in der Menüleiste den Channel erzeugen:
Dann die States für ACTUAL dazu anlegen:
und die States für STATE anlegen:
PageItem zum Beispiel:
{ id: "alias.0.NSPanel_1.Countdown", icon: "timer-outline", name: "Timer", onColor: White}
Blockly
Der Timer wird über dieses Script-Beispiel (separates und Blockly) gesteuert
Zum Blockly
Analog Alias Fenster. Im "Schritt 1" wird jedoch der Alias-Gerätetyp Tür gewählt
ab Release 3.7.0
**Alias erstellen: **
Direkt im Objektverzeichnis unter alias.0. (ggfs. noch Verzeichnisse anlegen) einen Kanal anlegen ("+" in der Menüleiste):
und die Rolle level.mode.fan zuweisen:
Danach folgende States unter dem Kanal (channel) anlegen:
- .SET --> Verweist auf An/Aus Datenpunkt des Ventilators (true/false)
- .ACTUAL --> Verweist ebenfalls auf An/Aus Datenpunkt des Ventilators (true/false)
- .SPEED --> Verweist auf Geschwindigkeit des Vetilators (Default 100%. und kann über maxValue im pageItem begrenzt werden)
- .MODE --> Falls der Ventilator über unterschiedliche Modes zur Einstellung verfügt. Ansonsten kann der auch über einen Datenpunkt unter 0_userdata erstellt werden und mittels Blockly Modes erzeugen bzw. steuern.
Das PageItem:
{ id: "alias.0.NSPanel_1.Ventilator.Fan_1",name: "Ventilator", icon: "fan", onColor: On, offColor: HMIOff, modeList: ['Low', 'Medium', 'High', 'Move', 'Sleep', 'Auto', 'Manual']}
modeList enthält die Werte des Datenpunktes (im Beispiel nur exemplarisch) zum Schalten der Modes.
Beschreibung für den Alias Verschluss folgt...
Dieser Alias dient nur der Einbindung des dynamischen Abfallkalenders. Dieser ist hier ausführlich beschrieben:
https://github.com/joBr99/nspanel-lovelace-ui/wiki/ioBroker---FAQ-&-Anleitungen#4-abfallkalender
und die Temperatur (etwas tiefer). Weitere Datenpunkte, wie z.B. Min- und Max-Temperatur können ebenfalls verknüpft werden, finden jedoch im TypeScript keine Berücksichtigung.
In diesem Fall wird die Temperatur aus einem Datenpunkt einer Wetterstation visualisiert. Es kann natürlich auch ein Datenpunkt mit der aktuellen Außentemperatur aus einem anderen Adapter daswetter.0.xxxxx, accuweather.0.xxxxx, openweathermap.0.xxxxx, etc. ausgewählt werden.
Achtung:
Dieser Alias muss erstellt werden, damit die 4 kleineren Icons (Weather-Forecast und/oder 4 Sensordatenpunkte) im unteren Screensaver visualisiert werden können.
