Developer Readme

Konvertierung der Skriptkonfiguration in Adapterkonfig

Cards

• cardChart
• cardLChart
• cardEntities
• cardGrid
• cardGrid2
• cardGrid3
• cardThermo
• cardMedia
• cardUnlock
• cardQR
• cardAlarm
• cardPower

PageItems

• light
• socket
• dimmer
• hue
• rgb
• rgbSingle
• ct
• blind
• door
• window
• volumeGroup
• volume
• info
• humidity
• temperature
• value.temperature
• value.humidity
• thermostat
• warning
• cie
• gate
• motion
• buttonSensor
• button
• value.time
• level.timer
• value.alarmtime
• level.mode.fan
• lock
• slider
• switch.mode.wlan
• media
• timeTable
• airCondition

PageItems Navigation

• light
• socket
• dimmer
• hue
• rgb
• rgbSingle
• ct
• blind
• door
• window
• volumeGroup
• volume
• info
• humidity
• temperature
• value.temperature
• value.humidity
• thermostat
• warning
• cie
• gate
• motion
• buttonSensor
• button
• value.time
• level.timer
• value.alarmtime
• level.mode.fan
• lock
• slider
• switch.mode.wlan
• media
• timeTable
• airCondition

Eingebaut:

• cardChart
• cardLChart
• cardMedia
• cardGrid/2
• cardEntities
• cardPower
• cardThermo
• screensaver
• cardMedia
• alle Popups und PageItems

Erklärungen

Icons:

Dateneingang:

Zu Icon.x.color: (nix was mit Licht zu tun hat.) Eingabe geht über folgende common Eigenschaftenmöglichkeiten

• type: number
  • decimal
• type: string
  • stringify Json: {r:0,g:0,b:0} oder {red:0,green:0,blue:0}
  • hexcolor - 7 Stellen beginned mit #
  • css color names (role: level.color.name) https://www.tutorialrepublic.com/css-reference/css-color-names.php
  • hsl: "hsl(0, 50%, 50%)" (role: level.color.name)

Funktion

IconEntryType

Sollte alle Icons betreffen abgesehen vom Screensaver zum aktuellen Zeitpunkt.

• true: ist der default wert sollte immer angegeben werden
• false: optional der Wert für boolean false
• text: optional wird auf einer cardGrid/2 angezeigt anstelle des Icons
• scale: siehe unten

IconScaleElement

scale bekommt eine eigenen Punkt: das object besteht aus folgenden typen: {val_min: number, val_max: number, val_best?: number, log10?: 'max' | 'min';} um es zu verwenden muß icon.true.color und icon.false.color definiert sein. Value bezeichnet einen Wert der häufig von entity1 kommt.

• wenn nur val_min definiert ist bedeutet val_min >= Value das die Farbe bei true gewählt wird.
• wenn nur val_max definiert ist bedeutet val_max <= Value das die Farbe bei true gewählt wird.
• wenn val_max und val_min definiert sind, wird die Farbe von false (val_min) zu true (val_max) interpoliert
• val_max und val_min werden getauscht, ebenso die Farben für true und false, wenn max < min ist. Falls min und max gleich sind wird die Farbe von true zurückgegeben.
• wenn zusätzlich val_best definiert ist, ist val_best die Farbe von true und wird jeweils in die Richtungen von val_min/max zu false interpoliert
• wenn zusätzlich log10 definiert ist, wird bei max ein log10() 1 false, 10 true ausgeführt, bei min (10-value) -> 10 false, 1 true.

ValueEntryType

besteht aus diesen Typen: {value: string | number |boolean; decimal?: number;factor?: number; unit?: string; minScale?: number; maxScale?: number; set?: string | number |boolean; } | undefined;

Wenn *** verlangert wird

• boolean läd Value und doppelt verneint es.
• number wird als nummer geladen oder konvertiert dann * factor und mit minScale und maxScale auf 0-100 skaliert.
• string wird
  • mit type==number als nummer geladen und decimal angewendet
  • oder als String
  • unit wird in beiden Fällen hinzugefügt.

Beim Schreiben:

• erst wird setversucht, wenn negativ dann value

Sind natürlich alles Dataitems

PageItems

vormalig CreateEntity()

light

• entity1 ist der Schalter
• icon (entity1)
• iconColor: Leuchtmittelfarbe kommt von dem definierten RGB Wert oder von CT (kelvin/mired) oder von IconEntryType entweder scaliert mit dimmer oder entity1
• dimmer ist ein Zahlenwert
• colorMode kann die Eigenschaft undefined | 'hue' | 'ct' haben und bestimmt welcher Modus für das Icon verwendet werden soll.
• headline ist die Item Beschreibung

shutter

• entity1 ist das level muß eine Zahl sein 0-100
• icon & iconColor (IconEntryType)(entity1)
• headline ist die Item Beschreibung
• valueList ist ein array mit 3 oder 6 Einträgen die die Iconbezeichnung enthält - '' für disable. Felder werden ebenfalls disabled wenn keine Befehlsstate gefunden wird.

number

• entity1 ist das level muß eine Zahl sein 0-100
• text.true ist die Bezeichnung
• icon & iconColor wie shutter

text

• entity1 kann zahl,boolean sein. Falls es nicht klappt wird von true ausgegangen.
• entity2 oder text1 ist der text rechts in cardEntites
• text.true ist die Bezeichnung
• icon & iconColor wie shutter

button

• entity1 bestimmt den button Status oder true
• icon & iconColor wie shutter
• setValue1 schaltet den angegebenen State um (optional)
• setValue2 schaltet den angegebenen State auf false (optional)
• setNavi springt zur angegebenen NavigationsID

input_sel

• entityInSel als nummer oder boolean oder undefined
• Icon/Color wie gehabt
• headline ist die Beschreibung
• text ist der text rechts in entities

fan

• entity1 ist der Schalter
• icon...
• headline die Beschreibung

timer

• im moment nur die interne Version komplett eingebaut
• entity1 noch zu verstreichende Sekunden oder interner Zähler
• icon...
• text alternativer text für die anzeige rechts in entitiys standard ist Zeit.