Liste der Blocks

Nachrichten seit 0.1.48

Neue Kategorie Nachrichten, drei DE/EN/FR-Bausteine. Einrichtung, Schlüsselverwaltung und Versand.

Seit 0.1.50 zusätzlich Signal · CallMeBot mit eigener Profilauswahl. Signal-App einrichten.

Block	Bild	Funktion
WhatsApp · CallMeBot ugso_callmebot_action		Empfängerprofil, Text/Jinja und Protokollstufe. MQTT-Versand über die UGSo CallMeBot Whatsapp-App. Schlüssel bleiben im Backend.
Signal · CallMeBot ugso_callmebot_signal_action		Empfängerprofil, Text/Jinja und Protokollstufe. MQTT-Versand über die UGSo CallMeBot Signal-App. Schlüssel bleiben im Backend.
WhatsApp-Integration ugso_whatsapp_action		whatsapp.send_message mit number oder target sowie notify.whatsapp. Empfänger ohne +, Nachricht, optionales Konto. Token einmal in der HA-Integration einrichten.

Funktionen seit 0.1.47

Der aktuelle Katalog enthält 169 Blocktypen. Parameter, Export und Grenzen.

Block	Bild	Funktion
Aktionsfunktion definieren procedures_defnoreturn		Wiederverwendbarer HA-Ablauf; bis zu acht Parameter über das Zahnrad. Definition neben der Automation.
Aktionsfunktion aufrufen procedures_callnoreturn		Dynamischer Aufruf mit Argumenteingängen. Export als HA-Ablaufgruppe mit eigenen Parameterbindungen.
Bedingter Rückgabewert ugso_function_result		Falls / Wert / Sonst; nur der ausgewählte Wert wird in HA ausgewertet. Keine Aktionsfolge.

Seit 0.1.45 enthält die Toolbox keine doppelten Einträge mehr: Zahl unter Mathematik, Text unter Text, Farbe unter Farbe und erweiterbares UND/ODER/NICHT unter Logik. Werte enthält nur Prozent. Die 163 Blocktypen und bestehende Projekte bleiben erhalten.

Entitätsfelder öffnen seit 0.1.17 einen Suchdialog. Entitäten laden, auswählen und manuell eingeben.

Stand 0.1.44: 163 Blocktypen. Alle Blocktypen wurden auf passende HA-Auswahlfelder geprüft. Die Bilder zeigen die tatsächlichen UGSo-Blocks im Editor. Dropdown-Varianten zählen nicht als zusätzliche Blocktypen. Anleitungen: HA-Auswahl, Datum und Zeit, Konvertierung.

Auslöser sind orange, Bedingungen violett, Werte grün und Aktionen blau. Seitliche Anschlüsse sind typisiert; Auslöser und Aktionen bilden getrennte vertikale Ketten. Entitäts-IDs werden gesucht oder manuell eingegeben.

Farben und Wertfunktionen seit 0.1.15

Bedienung, HA-Ausgabe und vollständiger Quellenvergleich.

Block	Bild	Funktion
Zufällige Farbe ugso_colour_random		Drei zufällige RGB-Kanäle 0–255. Bei jeder Auswertung neu; nicht kryptografisch.
Farbe aus RGB ugso_colour_rgb		Prozentanteile auf 0–100 begrenzen und in RGB-Kanäle umrechnen. 100/50/0 ergibt [255,128,0].
Farben mischen ugso_colour_blend		Lineare RGB-Mischung. Anteil Farbe 2 von 0–1. Rot/Blau bei 0,5 ergibt [128,0,128], ohne Gamma-Korrektur.
Wertfunktion definieren procedures_defreturn		Originaler Blockly-Editor, Zahnrad für bis zu acht Parameter, Rückgabewert erforderlich. Keine Aktionen. Jinja-Expansion beim Export.
Wertfunktion aufrufen procedures_callreturn		Erscheint dynamisch in Funktionen. Argumenteingänge folgen den Parametern. Ergebnis als Wert oder Boolean-Bedingung; keine Rekursion.
Originaler Parameter-Getter variables_get		Original-Blockly-Getter, etwa aus dem Kontextmenü der Definition. Liest im Funktionskörper den Parameter, sonst eine HA-Variable. Eigener Getter bleibt nutzbar.

Mathematik, Text, Listen und Zählschleifen seit 0.1.14

Original-Blockly / ioBroker / HA: Zuordnung, Beispiele und Grenzen.

Block	Bild	Funktion
Arithmetik ugso_math_arithmetic		Rechnet mit Zahlen: Addition, Subtraktion, Multiplikation, Division oder Potenz. Keine automatische Text-/Boolean-Konvertierung.
Einzelne Zahl berechnen ugso_math_single		Wurzel, Betrag, Negation, Logarithmen und Exponentialfunktionen. Ungültige Werte erzeugen einen Templatefehler.
Trigonometrie ugso_math_trig		Winkelfunktionen in Grad; inverse Funktionen liefern Grad. HA verwendet intern Radiant.
Konstanten ugso_math_constant		Endliche mathematische Konstanten. Unendlich wird nicht als exportierbarer Zahlenwert angeboten.
Zahleneigenschaften ugso_math_property		Zahleneigenschaften prüfen. Teiler erscheint nur bei teilbar durch; Nullteiler ist ungültig.
Runden ugso_math_round		Rundet auf 0–10 Nachkommastellen. HA/Jinja rundet halbe Werte zur geraden Zahl; Auf-/Abrunden folgen ceil/floor.
Mathematik über Liste ugso_math_list		Statistik über eine Zahlenliste; Zufallseintrag akzeptiert beliebige Listenelemente. Leere Summe ist 0, andere leere Ergebnisse sind null.
Modulo ugso_math_modulo		Jinja-Modulo. Bei negativem Dividend folgt das Vorzeichen dem Teiler und kann von JavaScript abweichen.
Begrenzen ugso_math_clamp		Begrenzt einen Zahlenwert. Vertauschte Grenzen werden zuerst sortiert.
Ganzzahlige Zufallszahl ugso_math_random_int		Inklusive beider ganzzahliger Grenzen. Höchstens 10000 mögliche Werte, vertauschte Grenzen sind erlaubt.
Zufallsbruch ugso_math_random_fraction		Zufallswert in Schritten von 0,00001. Kein kryptografischer Zufall; bei jeder Auswertung neu.
Winkel atan2 ugso_math_atan2		Vierquadranten-Winkelfunktion aus dem Blockly-Standard, zusätzlich zu den gezeigten Bildern.
Zeilenumbruch ugso_text_newline		Liefert einen echten Zeilenumbruch für Textverknüpfung.
Text verknüpfen ugso_text_join		Verknüpft 0–100 Werte als Text. Zahnrad und +/− ändern die Anzahl der Eingänge.
Text anhängen ugso_text_append		Weist der vorher initialisierten Textvariable einen neuen Text zu. Kein Schreiben einer HA-Entität.
Textlänge ugso_text_length		Anzahl Unicode-Codepunkte, nicht JavaScript-UTF-16-Codeeinheiten.
Text ist leer ugso_text_empty		Prüft einen Text auf Länge 0.
Text enthält ugso_text_contains		Prüft Teiltext, mit Groß-/Kleinschreibung.
Text suchen ugso_text_index		Position ab 1, nicht gefunden ergibt 0. Unicode-Codepunkte.
Zeichen lesen ugso_text_char		Zeichen ab 1 vom Anfang/Ende, erstes/letztes oder zufälliges Zeichen. Außerhalb ergibt leeren Text.
Teiltext ugso_text_slice		Inklusive Grenzen ab 1 vom Anfang. Ungültige/umgekehrte Grenzen ergeben leeren Text.
Groß-/Klein-/Titelbuchstaben ugso_text_case		Unicode-Text in Groß-, Klein- oder Titelbuchstaben umwandeln.
Leerraum entfernen ugso_text_trim		Entfernt äußeren Leerraum einschließlich Tabs und Zeilenumbrüchen.
Text zählen ugso_text_count		Zählt nicht überlappende Treffer; leerer Suchtext ergibt 0.
Text ersetzen ugso_text_replace		Ersetzt alle wörtlichen Treffer, ohne Regex. Leerer Suchtext lässt den Text unverändert.
Text umkehren ugso_text_reverse		Zusätzlicher Blockly-Standardblock. Kehrt Unicode-Codepunkte um, nicht zusammengesetzte Grapheme.
Listenelement wiederholen ugso_list_repeat		Neue Liste mit 0–10000 Wiederholungen eines Wertes.
Listenelement suchen ugso_list_index		Position ab 1, nicht gefunden ergibt 0. HA/Python-Gleichheit statt JavaScript-Referenzgleichheit.
Listenelement lesen ugso_list_get		Liest ab 1 vom Anfang/Ende, erstes/letztes oder zufälliges Element. Außerhalb/leere Liste ergibt null.
Listenelement setzen/einfügen ugso_list_set		Weist eine neue Liste mit ersetzt/eingefügtem Wert zu. Index ab 1; Einfügen erlaubt Länge+1. Ungültiger Index lässt die Liste unverändert.
Listenelement entfernen ugso_list_remove		Weist eine neue Liste ohne dieses Element zu. Index ab 1, ungültiger Index lässt die Liste unverändert.
Teilliste ugso_list_slice		Kopie eines Bereichs, inklusive Grenzen ab 1 vom Anfang. Umgekehrte/ungültige Grenzen ergeben eine leere Liste.
Liste/Text teilen/verbinden ugso_list_split		Text anhand eines wörtlichen Trennzeichens teilen oder Liste verbinden. Leeres Trennzeichen teilt in Unicode-Zeichen.
Liste sortieren ugso_list_sort		Neue sortierte Liste; Original bleibt erhalten. Numerischer Modus verlangt Zahlen, Textmodus wandelt Elemente in Text um.
Liste umkehren ugso_list_reverse		Neue Liste in umgekehrter Reihenfolge; Original bleibt erhalten.
Zählschleife ugso_for_range		Feste ganze Grenzen, inklusive Ende wenn auf dem Schrittraster. Auf-/absteigend automatisch, Schrittbetrag >0, höchstens 10000 Durchläufe. HA repeat.for_each mit Variable pro Durchlauf.
Für jeden Wert mit Variable ugso_foreach_variable		HA repeat.for_each mit benannter Variable, vor dem Körper aus repeat.item gesetzt. Wiederverwendung derselben Variable in verschachtelten Schleifen vermeiden.

Abläufe, Objekte und Listen seit 0.1.13

ioBroker / Original-Blockly / native HA: Gegenüberstellung und Grenzen.

Block	Bild	Funktion
Pause ugso_pause		Dauer mit ms/Sekunden/Minuten/Stunden; konstante oder berechnete Zahl. Native HA-Wartezeit.
Warte bis ugso_wait		Boolean-Bedingung mit Timeout und Haken zum Fortsetzen; ohne Haken endet der Lauf bei Timeout.
Diesen Lauf stoppen ugso_stop		Grund und optionaler Fehler-Haken. Beendet den gesamten Lauf, auch in Schleifen.
Wiederhole Anzahl ugso_repeat		C-Körper für HA-repeat.count; repeat.index ist der 1-basierte Index.
Wiederhole solange/bis ugso_repeat_while		Boolean-Eingang und Aktionskörper. Solange prüft vorher, bis danach. Pause im Körper verwenden.
Für jeden Eintrag ugso_foreach		Liste durchlaufen; aktueller Wert über Template repeat.item, Index über repeat.index.
Neues Objekt ugso_object_new		0–100 benannte Attribute mit Zahnrad/+−. Dictionary-Wert, keine HA-Entität.
Attribut von Objekt ugso_object_get		Schlüssel lesen; fehlender Schlüssel ergibt null. Dictionary erforderlich.
Objekt hat Attribut ugso_object_has		Boolean-Test auf einen Dictionary-Schlüssel.
Attribute des Objekts ugso_object_keys		Schlüsselliste für Listen- und Für-jeden-Eintrag-Blocks.
Setze Attribut in Variable ugso_object_set		Variablenauswahl und Wertanschluss; weist eine Dictionary-Kopie mit geändertem Schlüssel zu. Vorher als Objekt setzen.
Entferne Attribut aus Variable ugso_object_remove		Neue Zuweisung ohne Schlüssel. Keine Mutation anderer Variablen oder Entity-Attribute.
Bereichsvergleich ugso_logic_range		Unabhängig < oder ≤ für Unter- und Obergrenze; Zahl und Laufzeitzahl.
Ersatzwert ugso_logic_default		Auswahl null/nicht gesetzt oder leer/falsch/0; null-Modus erhält gültige 0 und falsch.
Der Fall ist ugso_case		1–100 Fallwerte mit Zahnrad/+− und Aktionskörpern. Erste Übereinstimmung, sonst optionaler Standardkörper.
Liste erstellen ugso_list_new		0–100 beliebige Einträge mit Zahnrad/+−, auch verschachtelte Werte.
Listenlänge ugso_list_length		Länge einer Liste als Laufzeitzahl. Texte und Dictionaries sind keine Listen.
Liste ist leer ugso_list_empty		Boolean-Prüfung auf eine Liste ohne Einträge.

Konvertierung seit 0.1.12

Anleitung, ioBroker-Gegenüberstellung und vorgemerktes JSONata.

Block	Bild	Funktion
Nach Zahl ugso_convert_number		HA float ohne Ersatzwert; vollständige Zahl mit Dezimalpunkt. Laufzeitzahl für Variablen, Vergleiche und Zeitrechnung.
Nach Logikwert ugso_convert_boolean		HA bool; erkannte Boolean-/Textwerte. Boolean-Ausgang für Bedingungen und Logik.
Nach String ugso_convert_string		Jinja-Textdarstellung eines Werts; keine JSON-Serialisierung.
Typ von ugso_convert_type		HA typeof liefert Python-Typnamen, z. B. str, float, bool, dict. Ab HA 2023.4.
Nach Datum/Zeit ugso_convert_datetime		ISO-Text oder Unix-Sekunden/-Millisekunden nach HA-Ortszeit. Typisierter Time-Ausgang.
Datum/Zeit nach … ugso_convert_date_format		Datumswert, Format, Unix-Zahl oder Datumsbestandteil. Auswahl wechselt den Ausgangstyp; eigenes Format zeigt ein Textfeld.
Zeitdifferenz formatieren ugso_convert_duration		Dauer in Millisekunden oder Sekunden nach hh:mm:ss, hh:mm, mm:ss. Vorzeichen und große Stunden/Minuten bleiben erhalten.
JSON nach Wert ugso_convert_from_json		JSON-Text nach Objekt, Liste oder Einzelwert. Ungültiges JSON erzeugt einen HA-Fehler.
Wert nach JSON ugso_convert_to_json		JSON-Serialisierung mit Checkbox für Einrückung. Datumswerte vorher formatieren.

Datum und Zeit seit 0.1.11

Die violetten Zeit-Blocks verwenden einen eigenen typisierten Datumswert-Anschluss. Bedienung, Grenzfälle und Gegenüberstellung.

Block	Bild	Funktion
Uhrzeitvergleich ugso_time_compare		Feste Uhrzeit HH:mm/HH:mm:ss; kleiner, größer, gleich oder Zeitraum. Ende erscheint nur bei zwischen/nicht zwischen.
Uhrzeitvergleich mit Eingängen ugso_time_compare_input		Uhrzeitgrenzen als Text-Blocks. Haken aus: eigener Datumswert-Eingang erscheint. Zeiträume auch über Mitternacht.
Aktuelle Zeit als Datumswert ugso_time_now		HA-Ortszeit mit Datum und Zeitzone, Time-Ausgang für Berechnung oder Formatierung.
Berechnete Zeit ugso_time_boundary		Beginn von Tag, nächstem Tag, Woche (Montag), Monat oder Jahr in HA-Ortszeit.
Nächste Sonnenzeit ugso_time_sun		Aufgang, Untergang, Dämmerung, Höchststand oder Sonnenmitternacht aus sun.sun. Minutenoffset; kann morgen sein.
Zeit berechnen ugso_time_shift		Datumswert plus/minus Zahl in Millisekunden, Sekunden, Minuten, Stunden oder Tagen.
Zeit formatieren ugso_time_format		Datumswert als Uhrzeit, Datum, Datum/Uhrzeit, ISO mit Zeitzone oder Unix-Sekunden.

Weitere Blocks

Block	Bild im Editor	Funktionsbeschreibung
Automation ugso_automation		Rahmen mit Auslösern, optionaler Bedingung und Aktionskette. Name, ID, Beschreibung und Modus stehen außerhalb des Blocks.
Zustand erreicht ugso_state_trigger		Startet, wenn die Entität den eingetragenen Zustand erreicht. Erzeugt trigger: state mit to.
Zahl über/unter Grenze ugso_numeric_trigger		Startet beim Grenzübertritt, nicht fortlaufend. Grenze als Number-Wert; trigger: numeric_state.
Uhrzeit ugso_time_trigger		Täglicher Uhrzeit-Auslöser, HH:MM oder HH:MM:SS; trigger: time.
Sonnenaufgang/-untergang ugso_sun_trigger		Dropdown für Sonnenaufgang oder Sonnenuntergang; trigger: sun.
HA startet ugso_start_trigger		Startet beim Home-Assistant-Start; trigger: homeassistant.
Zustand ist ugso_state_condition		Boolean-Bedingung: Entität hat den angegebenen Zustand; condition: state.
Zahlenvergleich ugso_numeric_condition		Boolean-Bedingung über/unter einer Grenze; condition: numeric_state.
UND / ODER / NICHT ugso_logic_condition		Verknüpft 1–100 Bedingungen. Plus/Minus ergänzt oder entfernt den letzten Eingang; Zahnrad ordnet um. and, or, not.
Datum heute ugso_date_condition		Datumsauswahl mit ist/ab/bis einschließlich Jahr. HA-Template vergleicht das heutige Datum in der HA-Zeitzone. Kein eigener Auslöser.
Zahl ugso_number		Unbegrenzter Zahlen-Wertblock. Passt in Grenzen und Wartezeiten; deren eigene Validierung gilt weiterhin.
Prozent ugso_percent		Slider und genaue Eingabe für ganze Werte 0–100. Number-Output, beispielsweise für Ladezustand oder Helligkeit.
Mehrzeiliger Text ugso_text		String-Wert für Logmeldungen. Enter: neue Zeile; Shift+Enter: übernehmen. Drei sichtbare Zeilen, vollständiger Text bleibt gespeichert.
Farbe ugso_colour		Hex-Farbauswahl; als RGB-Liste für Licht, Variablen oder Farbberechnungen. Colour/Value-Ausgang, nicht an feste Zahlenanschlüsse.
Ein / Aus / Umschalten ugso_switch_action		Aktion der Entitätsdomain: turn_on, turn_off oder toggle. Die Entität muss die Aktion unterstützen.
Generische HA-Aktion ugso_service_action		Aktionsname, optional eine Zielentität, Daten als JSON-Objekt. Für Parameter, die Komfortblocks noch nicht anbieten.
Warte Sekunden ugso_delay_action		Pause von 0–86400 ganzen Sekunden. Number-Eingang mit Shadow-Standardwert.
Falls / sonst falls / sonst ugso_if_action		Plus/Minus ergänzt oder entfernt den letzten sonst-falls-Zweig; S schaltet Sonst um. Zahnrad zum Umordnen. if oder choose, erster passender Zweig.
Log-Ausgabe ugso_log_action		Textmeldung und Schweregrad-Dropdown; system_log.write. Info/Debug können in HA gefiltert sein.
HA-Script steuern ugso_script_action		Starten ohne Warten, stoppen oder direkt aufrufen und warten. script.turn_on, script.turn_off oder script.name.
Entität aktualisieren ugso_update_action		homeassistant.update_entity fordert ein Update an. Setzt keinen Zustand; Unterstützung hängt von der Integration ab.
Helfer steuern ugso_helper_action		Typ-Dropdown Schalter/Zähler/Timer steuert das Aktions-Dropdown. Entitäts-ID muss zum Typ passen. Timer nutzt vorhandene Dauer; Parameter über generische Aktion.
Licht mit Farbe ugso_colour_action		Lichtentität, Colour-Eingang und Helligkeit 0–100. Erzeugt light.turn_on mit rgb_color und brightness_pct. Farbunterstützung des Geräts erforderlich.

Bei Minus oder ausgeschaltetem Sonst werden angeschlossene Blocks abgelöst, nicht gelöscht. Wieder verbinden oder entfernen, bevor YAML exportiert wird. Rückgängig stellt Anschlüsse und Verbindungen wieder her. Shadow-Werte kehren zurück, wenn ein ersetzender Wertblock entfernt wird.

Variablen- und Template-Blocks seit 0.1.8

Block	Bild im Editor	Funktionsbeschreibung
Variable setzen ugso_variable_set		Aktionsblock: ausgewählte Variable auf Zahl, Text/Template, Boolean oder null setzen. Erzeugt eine native HA-variables-Aktion. Vor späteren Lesezugriffen platzieren.
Variable lesen ugso_variable_get		Seitlicher String-Anschluss; erzeugt {{ name }} für Log-Meldungen und weitere Variablenzuweisungen. Dropdown bietet Umbenennen/Löschen.
Template-Wert ugso_template		Mehrzeiliges Jinja-Template mit String-Anschluss für Log-Meldungen oder Variablenzuweisungen. HA wertet die Vorlage bei Ausführung aus; Blocks führt sie nicht aus.
Template-Bedingung ugso_template_condition		Boolean-Anschluss für Nur wenn, Falls und logische Gruppen. Erzeugt condition: template mit value_template. Ergebnis muss in HA wahr sein; kein eigener Auslöser.

Variablen und Templates verwenden

Erhöhen und Verringern seit 0.1.10

Block	Bild im Editor	Funktionsbeschreibung
Erhöhe Variable um … ugso_variable_change		Dropdown für die Variable, Number-Eingang mit Standard-Schritt 1. Addiert den Schritt zur zuvor gesetzten Zahlenvariable. Negative Schritte verringern; 0 und Dezimalschritte sind möglich. Native HA-Variablenzuweisung mit Jinja.

Im Menü Variablen erscheinen für jede erstellte Variable Setze, Erhöhe und Variable lesen. Beispiel in der Aktionskette: Setze test auf 10 → Erhöhe test um 1 → Log Info Meldung Variable test. Die Meldung verwendet anschließend den Wert 11. Mit Schritt -2 würde aus 10 der Wert 8.

Vor dem Erhöhen die Variable als Zahl setzen. Fehlende Variablen, Text (auch "10"), Boolean oder null werden nicht automatisch konvertiert oder mit 0 initialisiert; die Jinja-Auswertung in HA schlägt dann fehl. Erstellen allein weist keinen Wert zu. JSON erhält den Erhöhen-Block; unser genaues YAML-Ausgabeformat wird beim Import wieder als Erhöhen-Block erkannt. Andere Rechenvorlagen bleiben Template-Blocks. Der geplante Dialog für typisierte Variablen bleibt offen.

Im Menü Variablen → Variable erstellen … beispielsweise leistung anlegen. Namen verwenden Buchstaben, Ziffern und _, keine führende Ziffer. Den Setzen-Block in Dann platzieren und eine Zahl oder ein Template anschließen. Danach den Lesen-Block in eine Log-Meldung stecken. Erstellen allein weist noch keinen Wert zu. Variablen gelten für den HA-Automationslauf; sie ersetzen keine dauerhaft gespeicherten Helfer.

Beispiel: Setze leistung auf Template mit {{ states('sensor.leistung') | float(0) }}, danach Log Info Meldung Variable leistung. HA liest den Sensor beim Setzen und verwendet den Wert im folgenden Schritt. Eine Template-Bedingung kann beispielsweise {{ states('sensor.leistung') | float(0) > 100 }} prüfen.

Umbenennen aktualisiert die verbundenen Variablen-Blocks. Namen in frei eingegebenen Jinja-Texten müssen manuell geändert werden. Aktionsvariablen stehen erst nach ihrer Zuweisung bereit, nicht in vorgelagerten Automationsbedingungen. Blocks prüft Struktur und YAML, keine Jinja-Syntax oder vorhandenen HA-Entitäten. Der Import unterstützt pro Variablenwert Text/Template, Zahl, Boolean oder null. Mehrere Einträge werden seit 0.1.34 im gemeinsamen JSON-Block unterstützt. Listen/Objekte als Werte und Variablen auf Automationsebene werden weiterhin abgelehnt. Native HA-Variablen und Gültigkeit.

Logik-Blocks seit 0.1.9

Block	Bild im Editor	Funktionsbeschreibung
Vergleich ugso_compare		Vergleicht zwei Werte mit =, ≠, <, ≤, > oder ≥. Zahlen, Texte, Variablen und einzelne Template-Ausdrücke anschließen. Liefert Boolean; Ausgabe als HA-Template-Bedingung oder Variablenwert.
UND / ODER kompakt ugso_binary_logic		Zwei Boolean-Eingänge. Als Bedingung native HA-and/or-Gruppe; als Variablenwert geklammerter Jinja-Ausdruck. Die erweiterbare Gruppe bleibt für mehr Eingänge verfügbar.
NICHT ugso_not		Negiert eine Boolean-Bedingung. Als Bedingung native HA-not-Gruppe, als Variablenwert Jinja-not.
wahr / falsch ugso_boolean		Boolean-Konstante mit Dropdown. Für Bedingungen und Variablen; die Zuweisung erzeugt echte YAML-Boolean-Werte.
null ugso_null		Kein Wert. Variablen erhalten YAML null, Ausdrücke Jinja none. Weder 0 noch falsch; kein Boolean-Bedingungsblock.
Wenn → dann Wert → sonst Wert ugso_ternary		Wählt anhand einer Boolean-Bedingung einen von zwei Werten. Für Variablen, Log-Meldungen und Vergleiche; erzeugt einen Jinja-Ausdruck und enthält keine Aktionskette.

Beispiel: In der Aktionskette zuerst leistung setzen. Dann Setze meldung auf Wenn, mit Vergleich Variable leistung > Zahl 100 als Test, Text Hohe Leistung als Dann-Wert und Text Geringe Leistung als Sonst-Wert. Danach Log Info Meldung Variable meldung verwenden. HA entscheidet bei Ausführung.

Vergleiche konvertieren Typen nicht automatisch: Zahl 20 unterscheidet sich von Text "20". Sensorzustände gegebenenfalls im Template mit float oder int umwandeln. In einem Ausdruckseingang ist nur eine einzelne Jinja-Ausgabe zulässig, beispielsweise {{ states('sensor.leistung') | float(0) }}. Mehrzeilige Anweisungen und gemischter Text bleiben im eigenständigen Template-Wertblock nutzbar. Dynamische Wertauswahlen sind nicht als feste Zahlen-Grenzen oder Wartezeiten vorgesehen.

JSON-Projekte bewahren die Blockformen und Anschlüsse. YAML speichert die native Bedeutung: Beim Wiederöffnen erscheinen Vergleiche und Wertauswahlen als Template-Blocks, UND/ODER/NICHT als Bedingungsgruppen. HA-Logikbedingungen.

Originalplugins und Einbindung

Die sechs bisherigen Originalplugins sind auf 13.2.0, die vier Theme-/Zoom-Plugins und die Arbeitsbereichssuche auf 13.3.0 festgelegt und werden lokal mit Blockly 13.3.0 ausgeliefert. Lizenz: Apache-2.0. Die folgenden Links führen direkt zu den Original-Repositories. Unsere HA-Blocks, YAML-Adapter und Plus/Minus-Steuerung sind eigener UGSo-Code.

Originalplugin	Nutzung / Stand
workspace-search	Findet platzierte Blocks im Arbeitsbereich; getrennt von der Toolboxsuche. Seit 0.1.21 verfügbar.
toolbox-search	Blocksuche am Menüende, deutsche Suchhinweise; Treffer behalten Dropdowns und Shadows.
field-multilineinput	Im Textblock; Zeilenumbrüche bleiben im Projekt und YAML erhalten.
field-slider	Im Prozentblock; 0–100 mit genauer Zahleneingabe.
field-colour	Im Farbblock; Hex wird für die Lichtaktion nach RGB umgewandelt. Zufall/RGB/Mischung seit 0.1.15 mit eigenen HA-Generatoren.
theme-dark	Dunkle Arbeitsfläche und Blockauswahl; Teil der gespeicherten Theme-Auswahl.
theme-modern	Originalpalette mit kräftigeren Rändern; eigene Blocks über Theme-Stile.
theme-tritanopia	Originalpalette für Standardgruppen, passende UGSo-Erweiterungsfarben und adaptive Schriftkontraste.
zoom-to-fit	Zusätzlicher Einpassen-Knopf neben den Zoom-Reglern; auch per Tastatur.
field-date	Im Datumsvergleich; UGSo-Unterklasse sichert den verzögerten Kalenderaufruf ab.
field-dependent-dropdown	Im Helferblock; Helfertyp bestimmt Aktionen. Keine Live-HA-Auswahl.
block-plus-minus	Bedienprinzip in eigenen HA-Blocks umgesetzt; Originalplugin nicht installiert. Zahnrad bleibt verfügbar.
block-dynamic-connection	Noch nicht eingebunden. Automatisch wachsende Anschlüsse, Textverknüpfung und Listen sind geplant.

Die Farbauswahl verwendet zusätzlich die indirekte Abhängigkeit field-grid-dropdown. HA-Ausgabe wird von uns erzeugt; die mitgelieferten JavaScript-Generatoren werden nicht verwendet.

Zur Übersicht

Benutzerdefinierte Blocks seit 0.1.18 ergänzen die 163 nativen Typen. Editor und Paketkatalog.

Trigger-IDs und mehrere Ziele

Seit 0.1.28: Zustandslisten über Zustände als JSON-Liste, z. B. ["1_single","1_double"]; optionale Trigger-IDs in allen Standardauslösern; Ausgelöst durch ID als native Trigger-Bedingung (einzelne ID oder JSON-Liste). Allgemeine HA-Aktionen unterstützen Ziele als JSON-Liste, optionale Metadaten und erhalten ausdrücklich leere Datenobjekte. Vierfach-Taster mit vier choose-Zweigen sind vollständig importierbar.

Einzelne Automation · HA-Editor gibt keine oberste id aus. Trigger-IDs bleiben erhalten. Projekt und automations.yaml-Liste behalten eine vorhandene Automations-ID.

Block	Bild	Funktion
Ausgelöst durch ID ugso_trigger_condition		condition: trigger · id

Home Assistant: Trigger IDs · Trigger condition

Poolpumpen, Ereignisse und mehrere Uhrzeiten

Seit 0.1.30: Ein Zeit-Auslöser akzeptiert über Uhrzeiten als JSON-Liste mehrere feste Uhrzeiten, z. B. ["10:00:00","13:00:00","19:00:00"]. Jede Änderung im Zustandsauslöser lässt to weg; Entitäten als JSON-Liste überwacht mehrere Entitäten. Ohne to reagiert HA auch auf Attributänderungen. Der Ereignis-Auslöser unterstützt z. B. timer.finished und einen optionalen JSON-Datenfilter. Die native Zeitbedingung erhält before/after unverändert; feste Uhrzeiten, nach inklusive und vor exklusiv, auch über Mitternacht. Gleiche Grenzen entsprechen ganztägig. Zeithelfer, Zeit-Templates und Wochentagsfilter bleiben hier noch außerhalb des unterstützten Imports. Die vollständige Poolpumpen-Automation bleibt einschließlich mehrzeiligem Timer-Template und verschachteltem choose erhalten.

Block	Bild	Funktion
Ereignis-Auslöser ugso_event_trigger		trigger: event · event_type · event_data
Native HA-Zeitbedingung ugso_native_time_condition		condition: time · before · after

Home Assistant: triggers · Time condition

Temperatur geändert

Seit 0.1.31 unterstützt der neue Block den nativen Auslöser temperature.changed. Ziel (JSON): entity_id als Text oder Liste. Schwelle (JSON): type any, above, below, between oder outside. any benötigt nur type; above/below benötigen value, between/outside value_min und value_max. Zahlen: number plus unit_of_measurement (°C/°F). Referenzen: entity (sensor, number oder input_number). Optional ist eine Trigger-ID. Seit 0.1.39 sind auch Bereich, Gerät, Etage und Label importierbar. MQTT-Topics, qos/retain/evaluate_payload und mehrzeilige JSON-/Jinja-Payloads bleiben erhalten.

Block	Bild	Funktion
Temperatur geändert ugso_temperature_trigger		temperature.changed

Home Assistant: temperature.changed

Kalender und Antwortvariablen

0.1.32: calendar.event_started / calendar.event_ended. Ziel: JSON-Objekt mit entity_id als Text oder Liste. Optionen sind optional: offset mit Tagen, Stunden, Minuten und Sekunden (kombinierbar) oder HH:MM:SS; offset_type ist before oder after. Null-Offset, ausgelassene Optionen und optionale Auslöser-ID bleiben erhalten.

Das Feld Antwortvariable (optional) im Block HA-Aktion erzeugt response_variable, zum Beispiel termine für calendar.get_events. Leer lässt das Feld im YAML weg. Die vollständige Feiertage-/Ferien-Automation erhält beide Kalender, den HA-Start, Variablen zeitpunkt/termin_aktiv, mehrzeilige Jinja-Templates, choose/default und queued. Home Assistant verarbeitet die Kalender und Templates.

Block	Bild	Funktion
Kalendertermin beginnt/endet ugso_calendar_trigger		calendar.event_started / calendar.event_ended

Home Assistant: calendar.event_started · calendar.event_ended · calendar.get_events

Numerische Auslöser mit Haltezeit

Seit 0.1.33 unterstützt Zahl über/unter Grenze mehrere Entitäten: Entitäten als JSON-Liste einschalten und etwa ["sensor.temp_1","sensor.temp_2"] eintragen. Ohne Haken bleibt die einzelne Entität aktiv. Haltezeit (JSON) mit verwenden erzeugt das optionale for: etwa {"hours":0,"minutes":1,"seconds":0}, 60 oder "00:01:00". Kombinierte days/hours/minutes/seconds/milliseconds, Nulleinträge und HA-Ausgabetemplates bleiben erhalten. Ein deaktivierter Haken lässt for weg. Weiterhin genau eine feste Zahlen-Grenze (above oder below); Trigger-ID und choose-Zweige bleiben erhalten.

Home Assistant löst nach dem Grenzübertritt aus, sobald der Wert die gesamte Haltezeit auf dieser Seite der Grenze bleibt. Ein HA-Neustart oder Neuladen der Automationen setzt die laufende Haltezeit zurück. Home Assistant: numeric_state.

Mehrere Variablen in einer Aktion

Seit 0.1.34 steht im Menü Variablen ein gemeinsamer Block Variablen setzen (JSON) bereit. Das JSON-Objekt enthält 1–100 Variablennamen mit Text, HA-Template, Zahl, Boolean oder null. Mehrere Einträge bleiben eine einzige native variables-Aktion, einschließlich ihrer Reihenfolge. Einzelne Zuweisungen verwenden weiterhin den bisherigen Setzen-Block. Seit 0.1.39 sind auch Listen/Objekte und Variablen auf Automationsebene unterstützt; siehe HA erweitert und Jinja. Namen und Templates im JSON müssen dort direkt bearbeitet werden; Umbenennen über den Blockly-Dialog ändert diesen freien JSON-Text nicht. Beim Import werden die Namen auch in Blockly registriert.

Das Timer-Beispiel erhält h/m, beide überwachten Entitäten, die Bedingung und den restart-Modus. Fehlende conditions werden als leere Liste ergänzt.

Block	Bild	Funktion
Variablen setzen (JSON) ugso_variables_action		Variablen mit einzelnen Wertfeldern; Listen und Objekte als JSON, neue Namen über zusätzliche Optionen.

Home Assistant: variables

Wartezeit als Zeittext oder Template

Seit 0.1.35 importiert Blocks native delay-Zeittexte in den neuen Block unter Timeouts. Beispiele: 00:00:02, 01:30 (eine Stunde und 30 Minuten), 00:00:00.250 oder ein HA-Ausgabetemplate. Der Zeittext bleibt ein Text im YAML und im gespeicherten Projekt. Eine Wartezeit verlängert den aktuellen HA-Lauf; nachfolgende Aktionen folgen danach. Bestehende Sekunden- und Einheiten-Blocks bleiben verfügbar. Diese Erweiterung betrifft delay, nicht den Timeout des Warte-bis-Blocks.

Das Timer-Reset-Beispiel schaltet zunächst timer_reset aus, wartet zwei Sekunden und schaltet anschließend beide Zielentitäten aus. Die Entitäts-ID input_boolean.timer_runing bleibt genau wie im Original erhalten.

Block	Bild	Funktion
Warte Zeittext / Template ugso_delay_text		Nativer delay-Zeittext / HA-Template.

Home Assistant: delay

Dynamische HA-Aktionsnamen

Seit 0.1.36 akzeptiert das erste Feld im Block HA-Aktion einen statischen Aktionsnamen oder eine Jinja-Vorlage. Das Feld lässt sich mehrzeilig bearbeiten. Beispiele: input_boolean.turn_on, input_boolean.turn_ mit angehängtem Jinja-Ausdruck oder ein vollständiges if/else-Template. Ziel, Daten, Metadaten und Antwortvariable bleiben in ihren bisherigen Feldern. Die Vorlage und ihre Zeilenumbrüche bleiben bei Import, Projekt-Speicherung und YAML-Export erhalten.

Beim Shelly-Beispiel bleibt die zusammengesetzte Aktion input_boolean.turn_ plus Zustandsabfrage erhalten, ebenso die verschachtelten choose-Zweige. Home Assistant wertet den Aktionsnamen erst beim Ausführen aus; er muss dann einen vorhandenen Dienstnamen ergeben. Blocks prüft statische Aktionsnamen und vorhandene Template-Klammern, keine Jinja-Syntax oder Laufzeitergebnisse. Zielentitäten müssen weiterhin feste IDs sein; Templates für ganze Datenobjekte sind nicht Teil dieser Erweiterung.

Home Assistant: choosing the action with a template

Zeitmuster-Auslöser

Unter Auslöser steht seit 0.1.37 ein nativer time_pattern-Block. Das JSON-Feld enthält beispielsweise {"seconds":"/30"} für die Sekunden 0 und 30 jeder Minute. Optional sind hours, minutes und seconds; mindestens ein Feld ist erforderlich. Feste Werte: Stunden 0–23, Minuten/Sekunden 0–59, als Zahl oder Text ohne führende Nullen. * passt auf jeden Wert, /n auf durch n teilbare Werte (n > 0 innerhalb des Wertebereichs). Fehlende Einheiten und Zahl/Text-Typen bleiben unverändert; Home Assistant ergänzt seine Standardwerte zur Laufzeit. Optional ist eine Auslöser-ID.

Die LCD-Automation mit vier input_text.set_value-Aktionen und mode: restart wurde vollständig geprüft: Jinja, Formatierung, Textkürzung, Auffüllen und Zeilenumbrüche bleiben erhalten. Home Assistant führt die Templates und den Zeitplan aus.

Block	Type
	ugso_time_pattern_trigger

Home Assistant: time_pattern.

Dynamische Zielentitäten

Seit 0.1.39 akzeptiert das Feld Ziel in der allgemeinen HA-Aktion eine feste Entitäts-ID oder ein HA-Template, zum Beispiel {{ ziel_tv }}. Der Entitätsdialog bietet dafür ein mehrzeiliges Eingabefeld. Auch die JSON-Zielliste darf feste IDs und Templates enthalten. Jinja bleibt unverändert erhalten und wird erst von Home Assistant ausgewertet. Dynamische Ziele werden beim Import in der allgemeinen HA-Aktion dargestellt; spezialisierte Schaltblöcke würden die Domain nicht zuverlässig bestimmen können.

Die Schlafzimmer-TV-Automation mit einer mehrzeiligen Sommerbetrieb-Variable, 21:30 und 00:30 Uhr und zwei choose-Zweigen ist geprüft. Zielvorlagen, Variableninhalt und Uhrzeitbedingungen bleiben beim Import, Projekt-Neuladen und Export erhalten. Auslöser- und Bedingungsfelder für Entitäts-IDs verlangen weiterhin feste IDs.

Home Assistant: templates in action targets.

HA erweitert und Jinja seit 0.1.39

Anleitung / Guide.

Block	Bild	Funktion
HA state ugso_ha_state_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA numeric_state ugso_ha_numeric_state_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA time ugso_ha_time_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA sun ugso_ha_sun_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA homeassistant ugso_ha_homeassistant_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA mqtt ugso_ha_mqtt_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA template ugso_ha_template_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA webhook ugso_ha_webhook_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA zone ugso_ha_zone_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA device ugso_ha_device_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA tag ugso_ha_tag_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA conversation ugso_ha_conversation_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA geo_location ugso_ha_geo_location_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA calendar ugso_ha_calendar_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA event ugso_ha_event_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA-Auslöser (erweitert) ugso_ha_trigger		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA-Bedingung (erweitert) ugso_ha_condition		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA-Schritt (erweitert) ugso_ha_action		Beschriftete HA-Eingaben und zusätzliche JSON-Optionen. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA-Aktion Zielart Ziel Daten Schrittoptionen ugso_target_action		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
HA-Integration Ziel Optionen verwenden ugso_integration_trigger		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Aktionsgruppe ugso_sequence		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Parallel Zweig 1 Zweig 2 ugso_parallel		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Warte auf Auslöser Optionen ugso_wait_trigger		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Nur weiter wenn ugso_condition_step		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Ereignis auslösen Daten ugso_fire_event		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Assist antwortet ugso_assist_response		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Szene aktivieren ugso_scene		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Jinja (experimentell) ugso_jinja_value		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.
Jinja-Bedingung (experimentell) ugso_jinja_condition		Erweiterte HA-Felder oder Original-Jinja. Unterstützte Struktur wird geprüft; Integration und Ausführung in HA prüfen.

Jinja-Strukturen (experimentell)

15 neue Typen seit 0.1.41. Die äußeren Wert-/Bedingungsblocks verbinden die verschachtelten Teile mit HA. Jinja-Ausdrücke und Template-Teile haben eigene typisierte Anschlüsse. Einlesen, Bearbeiten und Grenzen.

Block	Bild	Funktion
Jinja zusammengesetzt ugso_jinja_composed_value		Äußerer Wertblock: zusammenhängendes Template; Original bleibt bis zur Bearbeitung erhalten.
Jinja-Bedingung zusammengesetzt ugso_jinja_composed_condition		Äußerer Boolean-Block für eine HA-Template-Bedingung.
Entität Funktion ugso_jinja_entity		Entität suchen und states/state_attr/is_state/is_state_attr wählen; zusätzliche Argumente anschließen.
Filter Argumente Wert ugso_jinja_filter		Filter auswählen; 0–3 Positionsargumente und einen Jinja-Ausdruck anschließen.
Literal (Jinja) ugso_jinja_literal		Zahl, String in Anführungszeichen, true/false oder none in Jinja-Schreibweise.
Jinja-Variable ugso_jinja_variable		Einfacher Jinja-Variablenname als Text; keine automatische Blockly-Umbenennung.
Jetzt (Jinja) ugso_jinja_now		now() erzeugen; Home Assistant liefert den Zeitpunkt bei der Auswertung.
Ausdruck ugso_jinja_binary		Zwei Jinja-Ausdrücke berechnen, vergleichen oder mit and/or verbinden.
Ausdruck ugso_jinja_unary		not, negatives oder positives Vorzeichen für einen Jinja-Ausdruck.
Wert wenn sonst ugso_jinja_select		Wert wählen: yes if test else no. Alle drei Ausdruckseingänge sind erforderlich.
Ausgeben ugso_jinja_output		Einen Ausdruck als {{ ... }} innerhalb eines Templates ausgeben.
Jinja-Text ugso_jinja_text		Wörtlicher Text einschließlich Leerraum; Jinja-Steuerzeichen hier nicht einfügen.
Template-Teile danach ugso_jinja_join		Zwei Template-Teile in der dargestellten Reihenfolge verbinden.
Wenn Text sonst ugso_jinja_if		if/else mit Bedingung und verschachtelten Text-/Ausgabeteilen.
Für in Text wenn leer ugso_jinja_for		Einfache for-Schleife: Variable, Ausdruck, Template-Inhalt und optionaler Leerfall.