FHEMWiki - Letzte Änderungen [de]

FHEMWEB/iconAnimated

Schwatter — Sat, 14 Nov 2026 06:48:56 GMT

Animationen

← Nächstältere Version		Version vom 14. November 2026, 07:48 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 12:		Zeile 12:
	* Forenthread zum {{Link2Forum\|Topic=143313\|LinkText=iconAnimated Widget}}		* Forenthread zum {{Link2Forum\|Topic=143313\|LinkText=iconAnimated Widget}}

	== ~~1️⃣ Widget-Datei aus contrib laden ==~~		== Widget im Device einrichten ==
	~~Die JavaScript-Datei muss ins FHEM-Webverzeichnis kopiert werden.~~

	~~<syntaxhighlight lang="Perl">~~
	~~{ Svn_GetFile('contrib/fhemweb_iconAnimated.js', 'www/pgm2/fhemweb_iconAnimated.js') }~~
	~~</syntaxhighlight>~~

	~~== 2️⃣~~ Widget im Device einrichten ==
	=== Syntax ===		=== Syntax ===
	:<code><webCmd>:iconAnimated,<Reading>,<StateOn@ColorOn>,<StateOff@ColorOff>,<AnimationType>,[size@Px]</code>		:<code><webCmd>:iconAnimated,<Reading>,<StateOn@ColorOn>,<StateOff@ColorOff>,<AnimationType>,[size@Px]</code>
Zeile 57:		Zeile 50:
	== Animationen ==		== Animationen ==
	* '''alarm''' – Alarmartige Skalierung + Rotation		* '''alarm''' – Alarmartige Skalierung + Rotation
			* '''alarmGlow''' – pulsierender Leuchteffekt mit Glow und Blur
			* '''alarmBlink''' – Blinkende Anzeige mit wechselnder Deckkraft
	* '''blink''' – Blinkende Anzeige		* '''blink''' – Blinkende Anzeige
	* '''flow''' – sanfte vertikale Bewegung		* '''flow''' – sanfte vertikale Bewegung
	* '''heat''' – Hitze-/Flammenanimation		* '''heat''' – Hitze-/Flammenanimation
	* '''heatDevice''' – Geräte die Hitze ausstrahlen		* '''heatDevice''' – Geräte, die Hitze ausstrahlen
	* '''pulse''' – pulsierende Skalierung		* '''pulse''' – pulsierende Skalierung
	* '''ring''' – klingelnde Bewegung		* '''ring''' – klingelnde Bewegung
			* '''ringSpread''' – sich ausbreitender Ring mit ausblendender Transparenz
	* '''robot''' – Roboterartige Rotation		* '''robot''' – Roboterartige Rotation
	* '''rotateLeft''' – Rotation nach links		* '''rotateLeft''' – Rotation nach links
	* '''rotateRight''' – Rotation nach rechts		* '''rotateRight''' – Rotation nach rechts
	* '''rotate2d''' – 3D-Drehung um Y-Achse		* '''rotate2d''' – 3D-Drehung um die Y-Achse
	* '''bounce''' – leichtes Hüpfen		* '''bounce''' – leichtes Hüpfen
	* '''shake''' – seitliches Wackeln		* '''shake''' – seitliches Wackeln

FHEMWEB/Shutter

Schwatter — Sat, 14 Nov 2026 06:09:56 GMT

← Nächstältere Version		Version vom 14. November 2026, 07:09 Uhr
Zeile 1:		Zeile 1:
	[[Datei:~~shutterwidgets~~.png\|Mini\|rechts]]		[[Datei:Shutter.png\|Mini\|rechts]]
	== Shutter – Rollladen-Widgets ==		== Shutter – Rollladen-Widgets ==

Datei:Shutter.png

Schwatter — Sat, 14 Nov 2026 06:05:04 GMT

Schwatter lud Datei:Shutter.png hoch

Neue Seite

FHEMWEB/Widgets

Schwatter — Sat, 14 Nov 2026 05:59:54 GMT

Beigesteuerte Widgets

← Nächstältere Version		Version vom 14. November 2026, 06:59 Uhr
Zeile 157:		Zeile 157:
	<br clear=all>[[Datei:Gaugewidgets.png\|mini\|rechts]]		<br clear=all>[[Datei:Gaugewidgets.png\|mini\|rechts]]
	* Wiki Seite zu [[FHEMWEB/Gauge\| Gauge-Widgets]]		* Wiki Seite zu [[FHEMWEB/Gauge\| Gauge-Widgets]]

	<br clear=all>[[Datei:Popup.png\|mini\|rechts]]		<br clear=all>[[Datei:Popup.png\|mini\|rechts]]
	* Wiki Seite zu [[FHEMWEB/Popup\| Popup-Widget]]		* Wiki Seite zu [[FHEMWEB/Popup\| Popup-Widget]]
			<br clear=all>[[Datei:Shutter.png\|mini\|rechts]]
			* Wiki Seite zu [[FHEMWEB/Shutter\| Shutter-Widgets]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]

FHEMWEB/Shutter

Schwatter — Sat, 14 Nov 2026 05:57:39 GMT

← Nächstältere Version		Version vom 14. November 2026, 06:57 Uhr
Zeile 44:		Zeile 44:
	* Der neue Positionswert wird erst beim Loslassen (Ziehen bzw. Slider) gesendet. Danach werden Live-Updates für ca. 1,5 s ignoriert, damit die Anzeige nicht zurückspringt.		* Der neue Positionswert wird erst beim Loslassen (Ziehen bzw. Slider) gesendet. Danach werden Live-Updates für ca. 1,5 s ignoriert, damit die Anzeige nicht zurückspringt.
	* Die normale Statusspalte des Devices wird durch das Widget ersetzt.		* Die normale Statusspalte des Devices wird durch das Widget ersetzt.
	* Die Befehle werden als Perl-Ausdruck <code>{fhem("set ...")}</code> gesendet. Die FHEMWEB-Instanz muss daher Perl-Befehle zulassen (z. B. bei Nutzung eines <code>allowed</code>-Devices).


	== Beispiele ==		== Beispiele ==

FHEMWEB/Shutter

Schwatter — Sat, 14 Nov 2026 05:50:14 GMT

Die Seite wurde neu angelegt: „Mini|rechts == Shutter – Rollladen-Widgets == Die '''Shutter-Widgets''' stellen einen Rollladen im FHEMWEB (PGM2) Frontend als kompakte Bedienkarte dar. Beide Varianten haben die Tasten '''Öffnen''', '''Stop''' und '''Schließen'''. Ein Mini-Fenster mit Lamellen zeigt die aktuelle Position, der Fensterhintergrund wird dabei je nach Öffnung heller oder dunkler. Die beiden Widgets unterscheiden sich nur in der Opti…“

Neue Seite

[[Datei:shutterwidgets.png|Mini|rechts]]
== Shutter – Rollladen-Widgets ==

Die '''Shutter-Widgets''' stellen einen Rollladen im [[FHEMWEB]] ([[PGM2]]) Frontend als kompakte Bedienkarte dar. Beide Varianten haben die Tasten '''Öffnen''', '''Stop''' und '''Schließen'''. Ein Mini-Fenster mit Lamellen zeigt die aktuelle Position, der Fensterhintergrund wird dabei je nach Öffnung heller oder dunkler.

Die beiden Widgets unterscheiden sich nur in der Optik und in der Bedienung:
* '''shutter_v''' (vertikal): großes Fenster. Die Position wird direkt im Fenster per Maus oder Finger gezogen. Bei Touch-Bedienung erscheint eine Prozent-Sprechblase.
* '''shutter_h''' (horizontal): Tastenleiste oben, darunter ein kleines Vorschaufenster mit Schieberegler.

Konfiguration und Verhalten sind bei beiden Widgets gleich.

=== Hilfe ===
* Forenthread zum {{Link2Forum|Topic=144859|LinkText= Shutter-Widgets}}

== Widget im Device einrichten ==
Die Einrichtung erfolgt über die Attribute <code>webCmd</code> und <code>widgetOverride</code>.
<syntaxhighlight lang="Perl">
attr <devicename> webCmd cmd<X>
attr <devicename> widgetOverride cmd<X>:shutter_v,<SetPosition>,<ReadingPosition>,<CmdAuf>,<CmdAb>,<CmdStop>
</syntaxhighlight>
bzw. für die horizontale Variante:
<syntaxhighlight lang="Perl">
attr <devicename> widgetOverride cmd<X>:shutter_h,<SetPosition>,<ReadingPosition>,<CmdAuf>,<CmdAb>,<CmdStop>
</syntaxhighlight>

=== Parameter ===
{| class="wikitable"
! Parameter !! Beschreibung !! Standard
|-
| <code>SetPosition</code> || Set-Befehl zum Anfahren einer Position (wird als <code>set <device> <SetPosition> <Wert></code> gesendet). || <code>target_position</code>
|-
| <code>ReadingPosition</code> || Reading mit der aktuellen Position (0–100). Wird live aktualisiert. || <code>current_position</code>
|-
| <code>CmdAuf</code> || Set-Befehl für die Taste ''Öffnen''. || <code>up</code>
|-
| <code>CmdAb</code> || Set-Befehl für die Taste ''Schließen''. || <code>down</code>
|-
| <code>CmdStop</code> || Set-Befehl für die Taste ''Stop''. || <code>stop</code>
|}

'''Hinweise:'''
* Positionslogik: '''0 % = geschlossen''', '''100 % = offen'''.
* Ohne Parameter (<code>cmd:shutter_v</code>) gelten die Standardwerte. Werden Parameter angegeben, dann bitte '''immer alle fünf'''.
* Der neue Positionswert wird erst beim Loslassen (Ziehen bzw. Slider) gesendet. Danach werden Live-Updates für ca. 1,5 s ignoriert, damit die Anzeige nicht zurückspringt.
* Die normale Statusspalte des Devices wird durch das Widget ersetzt.
* Die Befehle werden als Perl-Ausdruck <code>{fhem("set ...")}</code> gesendet. Die FHEMWEB-Instanz muss daher Perl-Befehle zulassen (z. B. bei Nutzung eines <code>allowed</code>-Devices).

== Beispiele ==

Vertikales Widget mit Standardnamen
<syntaxhighlight lang="Perl">
attr Rollo_Wohnzimmer webCmd cmd
attr Rollo_Wohnzimmer widgetOverride cmd:shutter_v,target_position,current_position,up,down,stop
</syntaxhighlight>

Horizontales Widget, z. B. für ein Gerät mit <code>pct</code> / <code>open</code> / <code>closed</code>
<syntaxhighlight lang="Perl">
attr Rollo_Kueche webCmd cmd
attr Rollo_Kueche widgetOverride cmd:shutter_h,pct,pct,open,closed,stop
</syntaxhighlight>

== Links ==
* [[FHEMWEB/Widgets|FHEMWEB Widgets]]

[[Kategorie:Code Snippets]]
[[Kategorie:FHEM Frontends]]

FHEMWEB/Popup

Schwatter — Fri, 13 Nov 2026 21:17:49 GMT

← Nächstältere Version		Version vom 13. November 2026, 22:17 Uhr
Zeile 1:		Zeile 1:
	[[Datei:~~popupwidget~~.png\|Mini\|rechts]]		[[Datei:Popup.png\|Mini\|rechts]]
	== Popup – Werte und Bedienelemente in einem Dialog ==		== Popup – Werte und Bedienelemente in einem Dialog ==

Datei:Popup.png

Schwatter — Fri, 13 Nov 2026 21:16:22 GMT

Schwatter lud Datei:Popup.png hoch

Neue Seite

FHEMWEB/Widgets

Schwatter — Fri, 13 Nov 2026 21:12:12 GMT

← Nächstältere Version		Version vom 13. November 2026, 22:12 Uhr
Zeile 157:		Zeile 157:
	<br clear=all>[[Datei:Gaugewidgets.png\|mini\|rechts]]		<br clear=all>[[Datei:Gaugewidgets.png\|mini\|rechts]]
	* Wiki Seite zu [[FHEMWEB/Gauge\| Gauge-Widgets]]		* Wiki Seite zu [[FHEMWEB/Gauge\| Gauge-Widgets]]

			<br clear=all>[[Datei:Popup.png\|mini\|rechts]]
			* Wiki Seite zu [[FHEMWEB/Popup\| Popup-Widget]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]

FHEMWEB/Popup

Schwatter — Fri, 13 Nov 2026 21:09:02 GMT

Popup – Werte und Bedienelemente in einem Dialog

← Nächstältere Version		Version vom 13. November 2026, 22:09 Uhr
Zeile 8:		Zeile 8:

	=== Hilfe ===		=== Hilfe ===
	* Forenthread zum {{Link2Forum\|Topic=~~XXXXXX~~\|LinkText= Popup-Widget}}		* Forenthread zum {{Link2Forum\|Topic=145840\|LinkText= Popup-Widget}}


	== popup – Dialog für Werte und Bedienelemente ==		== popup – Dialog für Werte und Bedienelemente ==

FHEMWEB/Popup

Schwatter — Fri, 13 Nov 2026 21:07:20 GMT

Die Seite wurde neu angelegt: „Mini|rechts == Popup – Werte und Bedienelemente in einem Dialog == Das '''Popup-Widget''' zeigt im FHEMWEB (PGM2) Frontend einen kleinen Menü-Button (drei Striche) in der Gerätezeile. Ein Klick darauf öffnet einen Dialog mit frei wählbaren Readings samt Einheit und Icon sowie allen Bedienelementen aus dem <code>webCmd</code> des Geräts, z. B. Slider, Auswahllisten, Colorpicker oder Icons aus <code>cmdIcon</code>.…“

Neue Seite

[[Datei:popupwidget.png|Mini|rechts]]
== Popup – Werte und Bedienelemente in einem Dialog ==

Das '''Popup-Widget''' zeigt im [[FHEMWEB]] ([[PGM2]]) Frontend einen kleinen Menü-Button (drei Striche) in der Gerätezeile. Ein Klick darauf öffnet einen Dialog mit frei wählbaren Readings samt Einheit und Icon sowie allen Bedienelementen aus dem <code>webCmd</code> des Geräts, z. B. Slider, Auswahllisten, Colorpicker oder Icons aus <code>cmdIcon</code>.

Gedacht ist es vor allem für das Smartphone. Das Popup holt diese Bedienelemente zurück, ohne dass die Detailseite geöffnet werden muss. Das Popup übernimmt den Style des Skins und bringt keine eigenen Farben mit.

=== Hilfe ===
* Forenthread zum {{Link2Forum|Topic=XXXXXX|LinkText= Popup-Widget}}

== popup – Dialog für Werte und Bedienelemente ==

=== 1️⃣ Widget im Device einrichten ===
Die Einrichtung erfolgt über das Attribut <code>webCmd</code> und <code>widgetOverride</code>.
<syntaxhighlight lang="Perl">
attr <devicename> webCmd cmd<X>
attr <devicename> widgetOverride cmd<X>:popup,<Reading>@<Einheit>,<Reading>@<Einheit>,...
</syntaxhighlight>

=== 2️⃣ Parameter ===
{| class="wikitable"
! Parameter !! Beschreibung
|-
| <code>Reading@Einheit</code> || Beliebig viele Readings, die im Dialog angezeigt werden. Die Einheit ist optional. Die Werte werden live aktualisiert.
|-
| <code>alwaysVisible</code> || Optional: Button bei jeder Bildschirmbreite zeigen. Ohne diesen Schalter erscheint der Button nur im Hochformat bis 480 px Breite, also dort, wo f18 die Spalten ausblendet. Die Position in der Liste ist egal.
|}

=== 3️⃣ Beispiel ===

Nur auf dem Smartphone
<syntaxhighlight lang="Perl">
attr <device> webCmd pct:state:cmd1
attr <device> widgetOverride cmd1:popup,measured-temp@°C,humidity@%
</syntaxhighlight>

Bei jeder Bildschirmbreite
<syntaxhighlight lang="Perl">
attr <device> widgetOverride cmd1:popup,alwaysVisible,measured-temp@°C,humidity@%
</syntaxhighlight>

Auf Touch-Geräten öffnet sich der Dialog mittig, auf dem Desktop direkt am Button.

== Bedienelemente aus webCmd ==

Alle Einträge aus <code>webCmd</code> erscheinen automatisch im Dialog, unterhalb der Readings. Der Popup-Eintrag selbst wird übersprungen. Die fertigen Elemente der Gerätezeile werden beim Öffnen in den Dialog verschoben und beim Schließen zurückgelegt. Slider, Auswahllisten, Colorpicker und <code>cmdIcon</code> funktionieren deshalb genauso wie in der Gerätezeile.

Als Beschriftung dient der Name des zugehörigen Readings, bei <code>cmdIcon</code> der Befehlsname.

Hängt ein Widget an einem Reading, das es noch nicht gibt, verwendet FHEM <code>state</code>, und im Dialog steht dann auch <code>state</code>. Abhilfe schafft, das Reading einmal anzulegen:
<syntaxhighlight lang="Perl">
setreading <device> <reading> -
</syntaxhighlight>

== Icons für Readings ==

Links neben jedem Reading kann statt des Namens ein Icon stehen. Ist kein Icon gesetzt oder der Name unbekannt, steht dort der Reading-Name.

=== 1️⃣ Icons im Device einrichten ===
Die Icons werden über die Attribute <code>icon_1</code>, <code>icon_2</code> usw. gesetzt. Die Nummer zählt nach der Reihenfolge der Readings in der Popup-Definition, <code>alwaysVisible</code> zählt dabei nicht mit.
<syntaxhighlight lang="Perl">
attr <devicename> userattr icon_1 icon_2
attr <devicename> icon_1 <Icon>
attr <devicename> icon_2 <Icon>
</syntaxhighlight>

=== 2️⃣ Parameter ===
{| class="wikitable"
! Format !! Beschreibung
|-
| <code>temp_temperature@red</code> || FHEM-Icon aus dem <code>iconPath</code> von FHEMWEB, SVG oder PNG.
|-
| <code>data:image/svg+xml;;charset=utf-8,%3Csvg...%3E@red</code> || SVG direkt im Attribut. Mit Farbe gilt sie für das ganze SVG.
|-
| <code>mdi-thermometer</code> || Material Design Icon, die MDI-Schrift muss im Frontend geladen sein.
|-
| <code>fa-tint</code> || Wird zuerst als FHEM-Icon gesucht, sonst als Font-Awesome-Klasse gesetzt.
|-
| <code>@Farbe</code> || Optional bei FHEM-Icons und SVG: Farbname (<code>@red</code>) oder Hex-Wert mit oder ohne Raute (<code>@FF8800</code>, <code>@#00AAFF</code>). Ohne Farbe übernimmt ein SVG-Icon die Textfarbe des Styles.
|}

=== 3️⃣ Beispiel ===
<syntaxhighlight lang="Perl">
attr <device> widgetOverride cmd1:popup,measured-temp@°C,humidity@%
attr <device> userattr icon_1 icon_2
attr <device> icon_1 temp_temperature@red
attr <device> icon_2 humidity
</syntaxhighlight>

== Aussehen anpassen ==

Das Popup verwendet dieselben Klassen wie die Detailseite (<code>block</code>, <code>odd</code>/<code>even</code>, <code>col1</code>, <code>dval</code>, <code>mkTitle</code>) und übernimmt auch die f18-Einstellung „Wrap columns on small screens“. Für eigene Anpassungen im Style stehen diese Klassen zur Verfügung:

{| class="wikitable"
! Klasse !! Element
|-
| <code>.fhem-popup-btn</code> || Button in der Gerätezeile
|-
| <code>.fhem-popup-container</code> || Inhalt des Dialogs
|-
| <code>.fhem-popup-table</code> || Tabelle mit Readings und Bedienelementen
|-
| <code>.fhem-popup-icon</code> || Icon eines Readings
|}

Beispiel für mehr Abstand zwischen den Zeilen:
<syntaxhighlight lang="css">
.fhem-popup-table td {
padding-top: 12px !important;
padding-bottom: 12px !important;
}
</syntaxhighlight>

Tipp für eigene dunkle Styles: jQuery UI legt auf <code>.ui-dialog</code> ein helles Hintergrundbild. Wer dort nur <code>background-color</code> setzt, sollte zusätzlich <code>background-image: none !important;</code> ergänzen.

== Links ==
* [[FHEMWEB/Widgets|FHEMWEB Widgets]]

[[Kategorie:Code Snippets]]
[[Kategorie:FHEM Frontends]]

Fhem-cms

Stefan.apetz — Fri, 13 Nov 2026 09:51:30 GMT

Neue Version 1.10

Änderungen zeigen

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

DS Starter — Thu, 12 Nov 2026 10:51:06 GMT

Fhem-cms

Stefan.apetz — Wed, 11 Nov 2026 16:50:44 GMT

Update: neue Version 1.8.0

@@ Zeile 25: / Zeile 25: @@
 | [https://github.com/stapetz/fhem-cms GitHub-Repository]
 |- style="background-color:#7FFFD4"
-| colspan="2" | '''Wichtig:''' Beachte die zum installierten Modul gehörende englische Beschreibung in der lokalen ''commandref''.
+| colspan="2" | '''Wichtig:''' Zugriffsschutz wird in FHEM/FHEMWEB eingerichtet.
 |}
 [[Kategorie:Modul (Inoffiziell)]]
@@ Zeile 31: / Zeile 31: @@
 '''fhem-cms''' ergänzt FHEM um eine frei gestaltbare Bedienoberfläche im Browser. Du kombinierst Gerätewerte, Bedienelemente, Texte, Bilder und Links auf eigenen Seiten. Das Layout erstellst du grafisch, ohne dafür eine komplette HTML-Oberfläche programmieren zu müssen.
-Dieser Artikel beschreibt den stabilen Funktionsstand '''1.7.0''' und das aktuelle Seitenformat '''Schema 5'''. Das ausführliche, bebilderte [https://github.com/stapetz/fhem-cms/wiki GitHub-Handbuch] enthält zusätzliche Beispiele und Screenshots aller Widgettypen und ihrer Einstellungsdialoge.
+Dieser Artikel beschreibt den stabilen Funktionsstand '''1.8.0''' und das aktuelle Seitenformat '''Schema 5'''. Das ausführliche, bebilderte [https://github.com/stapetz/fhem-cms/wiki GitHub-Handbuch] enthält zusätzliche Beispiele und Widgetaufnahmen.
 __TOC__
@@ Zeile 113: / Zeile 113: @@
 Bei einer neuen, leeren Konfiguration erscheint der '''Einrichtungsassistent'''. Du kannst leer beginnen, Räume und Geräte mit Vorschau auswählen oder mit '''Magic - auf gut Glück''' einen Entwurf erzeugen. Magic berücksichtigt höchstens acht Räume mit je acht Widgets und nur unterstützte Geräte. Nicht erkannte Geräte lassen sich später im Editor ergänzen. Der Assistent veröffentlicht nichts; Bedienelemente können reale Geräte steuern. Automatische Temperaturverläufe werden nicht angelegt.
-Die folgenden Schritte beschreiben den manuellen Ausbau nach '''Leer beginnen''' oder bei einer bestehenden Einrichtung:
+Die folgenden Schritte beschreiben den manuellen Ausbau mit leerer Startseite oder bei einer bestehenden Einrichtung:
 # Öffne am CMS-Device '''CMS starten'''.
@@ Zeile 180: / Zeile 180: @@
 '''Bearbeiten → Widgets automatisch anordnen''' rückt die Widgets der aktuellen Seite nach oben und links. Größen und Inhalte bleiben erhalten; die Änderung landet im Entwurf.
 === Fenstergröße, Zoom und mobile Ansicht ===
@@ Zeile 213: / Zeile 235: @@
 |-
 | SolarFlow || Leistungen zwischen PV, Haus, Netz und Batterie sowie optional den Batterieladestand visualisieren.
 |-
 | Text || Formatierten Text, Bilder, Links, Tabellen und Live-Platzhalter kombinieren.
@@ Zeile 238: / Zeile 262: @@
 '''Einheiten sind meist Beschriftungen, keine Umrechnung.''' Die Auswahl „kWh“ wandelt einen Readingwert in Wh nicht automatisch um.
 === SolarFlow ===
@@ Zeile 328: / Zeile 371: @@
 * Ganze Ordner werden nicht per Drop importiert.
 * Identische Dateien können wiederverwendet werden und bleiben dann gegebenenfalls in ihrem bisherigen Ordner.
-* Eine Assetsuche ist in Version 1.7.0 noch nicht enthalten.
+* Eine Assetsuche ist in Version 1.8.0 noch nicht enthalten.
 === Dateidetails und Aktionen ===

Fronthem

Wvhn — Wed, 11 Nov 2026 13:23:01 GMT

Korrekturen und Ergänzungen bei den Konvertern

← Nächstältere Version		Version vom 11. November 2026, 14:23 Uhr
Zeile 64:		Zeile 64:
	* [[#AnAus\|AnAus]] für Schalter, Übersetzung in "An" und "Aus"		* [[#AnAus\|AnAus]] für Schalter, Übersetzung in "An" und "Aus"
	* [[#Log\|Log]] für die Darstellung von Log-Meldungen		* [[#Log\|Log]] für die Darstellung von Log-Meldungen
	* [[#NumInvert\|NumInvert]] ~~for substracting the current value from a max value~~		* [[#NumInvert\|NumInvert]] zum Invertieren eines Wertes durch Substraktion von einem Maximalwert

	Weitere Readings ~~Converter~~ können darüber hinaus [[#eigene Converter\|individuell selbst]] definiert werden.		Weitere Readings-Konverter können darüber hinaus [[#eigene Converter\|individuell selbst]] definiert werden.

	Die hier beschriebenen ~~Converter~~ sind kompatibel mit dem oben erwähnten Frontend smartVISU und werden auf dessen Basis erklärt. Für die Verwendung in Kombination mit anderen Frontends müssen die ~~Converter~~ möglicherweise entsprechend angepasst werden.		Die hier beschriebenen Konverter sind kompatibel mit dem oben erwähnten Frontend smartVISU und werden auf dessen Basis erklärt. Für die Verwendung in Kombination mit anderen Frontends müssen die Konverter möglicherweise entsprechend angepasst werden.

	====Direct====		====Direct====
Zeile 127:		Zeile 127:

	====Plot====		====Plot====
	Überträgt Daten aus der FHEM-Datenbank, die über DbLog abgefragt und als JSON ausgelifert werden an smartVISU. Als Parameter ist hier das item anzugeben, für welches die Plotdaten übertragen werden soll. ([https://forum.fhem.de/index.php/topic,86584.0.html Forum])		Überträgt Daten aus der FHEM-Datenbank, die über DbLog abgefragt und als JSON ausgelifert werden an smartVISU. Als Parameter ist hier nach dem Konverter-Namen das item anzugeben, für welches die Plotdaten übertragen werden soll. ([https://forum.fhem.de/index.php/topic,86584.0.html Forum])

	====Plotfile====		====Plotfile====
	Überträgt Plotdaten aus FileLog-Abfragen an smartVISU. Als Parameter ist hier der ~~name~~ des FileLogs anzugeben. ([https://forum.fhem.de/index.php/topic,86584.0.html Forum])		Überträgt Plotdaten aus FileLog-Abfragen an smartVISU. Als Parameter ist hier nach dem Konverternamen der Name des FileLogs anzugeben. ([https://forum.fhem.de/index.php/topic,86584.0.html Forum])

	====UZSU====		====UZSU====
Zeile 136:		Zeile 136:

	====JSONdata====		====JSONdata====
	Dieser Konverter bringt beliebige JSON-Daten in das für die Übertragung zu smartVISU erforderliche Format. ~~([https://forum.fhem.de/index.php/topic,86584.0.html Forum])~~		Dieser Konverter bringt beliebige JSON-Daten in das für die Übertragung zu smartVISU erforderliche Format.

	====AnAus====		====AnAus====
Zeile 142:		Zeile 142:

	====Log====		====Log====
	Bereitet Log-Meldungen für die Übertragung an smartVISU auf.		Bereitet Log-Meldungen für die Übertragung an smartVISU auf. Konfiguration siehe [https://forum.fhem.de/index.php/topic,86584.0.html Forum].

	====NumInvert====		====NumInvert====
	Invertiert einen numerischen Wert, indem dieser von einem festgelegten ~~MAximalwert~~ abgezogen wird.		Invertiert einen numerischen Wert, indem dieser von einem festgelegten Maximalwert abgezogen wird. Nützlich zum Beispiel zur Richtungsumkehr bei Jalousien (0 wird zu 100, 100 wird zu 0).

	==== eigene Converter ====		==== eigene Converter ====
Zeile 156:		Zeile 156:

	===== NumDelayed =====		===== NumDelayed =====
	NumDelayed ist noch in Arbeit.		NumDelayed ist noch in Arbeit (Stand 2026: nicht realisiert).

	Ein bidirektionaler numerischer Converter mit einstellbarer Verzögerung.		Ein bidirektionaler numerischer Converter mit einstellbarer Verzögerung.
Zeile 165:		Zeile 165:

	===== WordDisplay =====		===== WordDisplay =====
	WordDisplay ist derzeit in Planung, es wird noch über die Umsetzung diskutiert.		WordDisplay ist derzeit in Planung, es wird noch über die Umsetzung diskutiert (Stand 2026: nicht realisiert).

	Der Converter soll nur in eine Richtung arbeiten, FHEM zu Frontend. Es ist dazu gedacht Wörter oder Textpassagen zu übertragen. Jedoch soll es möglich sein, eine Umwandlung selbst festzulegen. So kann man einfach mehrere Textausgaben abhängig vom Zustand an das Frontend schicken:		Der Converter soll nur in eine Richtung arbeiten, FHEM zu Frontend. Es ist dazu gedacht Wörter oder Textpassagen zu übertragen. Jedoch soll es möglich sein, eine Umwandlung selbst festzulegen. So kann man einfach mehrere Textausgaben abhängig vom Zustand an das Frontend schicken:

Fhem-cms

Stefan.apetz — Wed, 11 Nov 2026 11:34:05 GMT

aktualisiert um neue Funktionen / Features (Einrichtungsassistent)

← Nächstältere Version		Version vom 11. November 2026, 12:34 Uhr
Zeile 31:		Zeile 31:
	'''fhem-cms''' ergänzt FHEM um eine frei gestaltbare Bedienoberfläche im Browser. Du kombinierst Gerätewerte, Bedienelemente, Texte, Bilder und Links auf eigenen Seiten. Das Layout erstellst du grafisch, ohne dafür eine komplette HTML-Oberfläche programmieren zu müssen.		'''fhem-cms''' ergänzt FHEM um eine frei gestaltbare Bedienoberfläche im Browser. Du kombinierst Gerätewerte, Bedienelemente, Texte, Bilder und Links auf eigenen Seiten. Das Layout erstellst du grafisch, ohne dafür eine komplette HTML-Oberfläche programmieren zu müssen.

	Dieser Artikel beschreibt den stabilen Funktionsstand '''1.6.1''' und das aktuelle Seitenformat '''Schema 5'''. Das ausführliche, bebilderte [https://github.com/stapetz/fhem-cms/wiki GitHub-Handbuch] enthält zusätzliche Beispiele und Screenshots aller Widgettypen und ihrer Einstellungsdialoge.		Dieser Artikel beschreibt den stabilen Funktionsstand '''1.7.0''' und das aktuelle Seitenformat '''Schema 5'''. Das ausführliche, bebilderte [https://github.com/stapetz/fhem-cms/wiki GitHub-Handbuch] enthält zusätzliche Beispiele und Screenshots aller Widgettypen und ihrer Einstellungsdialoge.

	__TOC__		__TOC__
Zeile 110:		Zeile 110:

	== Erste Seite erstellen ==		== Erste Seite erstellen ==

			Bei einer neuen, leeren Konfiguration erscheint der '''Einrichtungsassistent'''. Du kannst leer beginnen, Räume und Geräte mit Vorschau auswählen oder mit '''Magic - auf gut Glück''' einen Entwurf erzeugen. Magic berücksichtigt höchstens acht Räume mit je acht Widgets und nur unterstützte Geräte. Nicht erkannte Geräte lassen sich später im Editor ergänzen. Der Assistent veröffentlicht nichts; Bedienelemente können reale Geräte steuern. Automatische Temperaturverläufe werden nicht angelegt.

			Die folgenden Schritte beschreiben den manuellen Ausbau nach '''Leer beginnen''' oder bei einer bestehenden Einrichtung:

	# Öffne am CMS-Device '''CMS starten'''.		# Öffne am CMS-Device '''CMS starten'''.
Zeile 238:		Zeile 242:

	Die PV-Leistung ist Pflicht; andere Quellen sind optional. Du kannst Werte aus einem Device oder aus mehreren Devices zuordnen. Ohne Hausverbrauchsreading kann der Hausverbrauch berechnet werden.		Die PV-Leistung ist Pflicht; andere Quellen sind optional. Du kannst Werte aus einem Device oder aus mehreren Devices zuordnen. Ohne Hausverbrauchsreading kann der Hausverbrauch berechnet werden.

			Bei einem von Magic vorgeschlagenen SolaxModbus-Gerät ist die Berechnung zunächst ausgeschaltet, wenn sich der Hausverbrauch nicht eindeutig zuordnen lässt. Sie kann in der Widget-Konfiguration bewusst aktiviert werden.

	* Netzleistung: negativ bedeutet Bezug, positiv Einspeisung.		* Netzleistung: negativ bedeutet Bezug, positiv Einspeisung.
Zeile 322:		Zeile 328:
	* Ganze Ordner werden nicht per Drop importiert.		* Ganze Ordner werden nicht per Drop importiert.
	* Identische Dateien können wiederverwendet werden und bleiben dann gegebenenfalls in ihrem bisherigen Ordner.		* Identische Dateien können wiederverwendet werden und bleiben dann gegebenenfalls in ihrem bisherigen Ordner.
	* Eine Assetsuche ist in Version 1.6.1 noch nicht enthalten.		* Eine Assetsuche ist in Version 1.7.0 noch nicht enthalten.

	=== Dateidetails und Aktionen ===		=== Dateidetails und Aktionen ===

Fronthem

Wvhn — Wed, 11 Nov 2026 00:02:23 GMT

Konverter Stand 11.2026 ergänzt

@@ Zeile 46: / Zeile 46: @@
 Über das Konzept der converter können FHEM Devices unterschiedlichster Typen und Funktionen über das Frontend bedient werden. So versorgt der gleiche converter, der die Solltemperatur des virtuellen Heizungsthermostats (bidriektional) einstellt, auch die Füllstandanzeige der Zisterne sowie den Dimmer. In den genannten Fällen handelt es sich um die Übertragung von numerischen Werten. Converter können dabei auch Spezialaufgaben wie die Begrenzung des Wertebereichs übernehmen. So lässt sich über NumDirect zum Beispiel die Solltemperatur für virtuelle Heizungsregler auf Min und Max Werte begrenzen.
-Standardmäßig gibt es folgende Converter:
+Standardmäßig gibt es folgende Konverter (in "fhconverter.pm"):
 * [[#Direct|Direct]] für Übertragung ohne Konvertierung
 * [[#NumDirect|NumDirect]] für Übertragung von Zahlenwerten in einem begrenzten Werteraum zwischen Min und Max
@@ Zeile 55: / Zeile 55: @@
 * [[#Attribute|Attribute]] (vorhanden, Beschreibung TODO)
 * [[#Trigger|Trigger]] (vorhanden, Beschreibung TODO)
 Weitere Readings Converter können darüber hinaus [[#eigene Converter|individuell selbst]] definiert werden.
@@ Zeile 115: / Zeile 125: @@
 ==== Trigger ====
 Dieser Converter ist im Modul bereits enthalten, dessen Beschreibung ist allerdings TODO.
 ==== eigene Converter ====

HTTPMOD

StefanStrobel — Tue, 10 Nov 2026 20:19:33 GMT

Fehlende Features ergänzt

@@ Zeile 1.355: / Zeile 1.355: @@
 ;minSendDelay
 :Defines the minimum time between two HTTP Requests.
 == Links ==

Fhem-cms

Stefan.apetz — Tue, 10 Nov 2026 17:44:57 GMT

← Nächstältere Version		Version vom 10. November 2026, 18:44 Uhr
Zeile 1:		Zeile 1:
	{\| class="~~wikitable~~" style="float:right; ~~clear~~:~~right~~; width:~~22em; margin:0 0 1em 1em~~;"		{\| class="float-right infobox toccolours" style="margin:0 0 1em 1em; float:right; border-style:solid; border-width:1px;" width="300"
	! colspan="2" \| FHEMCMS – fhem-cms		! colspan="2" style="background-color:#EFEFFF" \| FHEMCMS – fhem-cms
	\|-		\|- style="background-color:#EFEFFF"
	! Zweck / Funktion		! colspan="2" \| Zweck / Funktion
	\| Browserbasierte Bedienoberfläche mit grafischem Seiteneditor, Widgets, Live-Werten und Assetmanager.		\|- style="background-color:#FFFFFF"
	\|-		\| colspan="2" \| Browserbasierte Bedienoberfläche mit grafischem Seiteneditor, Widgets, Live-Werten und Assetmanager.
	! Typ		\|- style="background-color:#EFEFFF"
			! colspan="2" \| Allgemein
			\|- style="background-color:#FFFFFF"
			\| Typ
	\| Inoffizielles Modul; Installation aus externer Updatequelle.		\| Inoffizielles Modul; Installation aus externer Updatequelle.
	\|-		\|- style="background-color:#EFEFFF"
	! Dokumentation		! colspan="2" \| Details
			\|- style="background-color:#FFFFFF"
			\| Dokumentation
	\| [https://github.com/stapetz/fhem-cms/wiki GitHub-Wiki / Anwenderhandbuch]		\| [https://github.com/stapetz/fhem-cms/wiki GitHub-Wiki / Anwenderhandbuch]
	\|-		\|- style="background-color:#FFFFFF"
	! Modulname		\| Modulname
	\| <code>01_FHEMCMS.pm</code>		\| <code>01_FHEMCMS.pm</code>
	\|-		\|- style="background-color:#FFFFFF"
	! Ersteller / Betreuung		\| Ersteller / Betreuung
	\| [https://github.com/stapetz stapetz]		\| [https://github.com/stapetz stapetz]
	\|-		\|- style="background-color:#FFFFFF"
	! Projekt		\| Projekt
	\| [https://github.com/stapetz/fhem-cms GitHub-Repository]		\| [https://github.com/stapetz/fhem-cms GitHub-Repository]
			\|- style="background-color:#7FFFD4"
			\| colspan="2" \| '''Wichtig:''' Beachte die zum installierten Modul gehörende englische Beschreibung in der lokalen ''commandref''.
	\|}		\|}
	[[Kategorie:Modul (Inoffiziell)]]		[[Kategorie:Modul (Inoffiziell)]]

VolvoConnect

Stefan.apetz — Tue, 10 Nov 2026 17:42:43 GMT

Ersterstellung Doku VolvoConnect

Änderungen zeigen

Fhem-cms-frontend

Stefan.apetz — Tue, 10 Nov 2026 17:35:24 GMT

Weiterleitung auf VolvoConnect entfernt

← Nächstältere Version		Version vom 10. November 2026, 18:35 Uhr
Zeile 1:		Zeile 1:
	~~#WEITERLEITUNG [[VolvoConnect]]~~		{{Löschkandidat\|Anfängerfehler, falsche Seite angelegt ;-) }}

Fhem-cms-frontend

Stefan.apetz — Tue, 10 Nov 2026 17:33:35 GMT

Stefan.apetz verschob die Seite Fhem-cms-frontend nach VolvoConnect

Neue Seite

#WEITERLEITUNG [[Fhem-cms]]

Fhem-cms

Stefan.apetz — Tue, 10 Nov 2026 17:11:13 GMT

← Nächstältere Version		Version vom 10. November 2026, 18:11 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 1:		Zeile 1:
	{~~{Infobox Modul~~		{\| class="wikitable" style="float:right; clear:right; width:22em; margin:0 0 1em 1em;"
	\|~~ModPurpose=~~Browserbasierte Bedienoberfläche ~~für FHEM~~ mit grafischem Seiteneditor, Widgets, Live-Werten und ~~gemeinsamem~~ Assetmanager.		! colspan="2" \| FHEMCMS – fhem-cms
	\|~~ModType=x~~		\|-
	\|~~ModCmdRef=FHEMCMS~~		! Zweck / Funktion
	\|~~ModTechName=~~01_FHEMCMS.pm		\| Browserbasierte Bedienoberfläche mit grafischem Seiteneditor, Widgets, Live-Werten und Assetmanager.
	\|~~ModOwner=~~[https://github.com/stapetz stapetz]		\|-
	}}		! Typ
			\| Inoffizielles Modul; Installation aus externer Updatequelle.
			\|-
			! Dokumentation
			\| [https://github.com/stapetz/fhem-cms/wiki GitHub-Wiki / Anwenderhandbuch]
			\|-
			! Modulname
			\| <code>01_FHEMCMS.pm</code>
			\|-
			! Ersteller / Betreuung
			\| [https://github.com/stapetz stapetz]
			\|-
			! Projekt
			\| [https://github.com/stapetz/fhem-cms GitHub-Repository]
			\|}
			[[Kategorie:Modul (Inoffiziell)]]

	'''fhem-cms''' ergänzt FHEM um eine frei gestaltbare Bedienoberfläche im Browser. Du kombinierst Gerätewerte, Bedienelemente, Texte, Bilder und Links auf eigenen Seiten. Das Layout erstellst du grafisch, ohne dafür eine komplette HTML-Oberfläche programmieren zu müssen.		'''fhem-cms''' ergänzt FHEM um eine frei gestaltbare Bedienoberfläche im Browser. Du kombinierst Gerätewerte, Bedienelemente, Texte, Bilder und Links auf eigenen Seiten. Das Layout erstellst du grafisch, ohne dafür eine komplette HTML-Oberfläche programmieren zu müssen.
Zeile 485:		Zeile 500:

	Nenne bei Fehlerberichten Version, Browser, Ansichtsmodus, erwartetes und tatsächliches Verhalten sowie reproduzierbare Schritte. Bei Layoutproblemen helfen Fensterbreite und Zoomfaktor. Entferne Zugangsdaten und private Informationen aus Logs und Screenshots.		Nenne bei Fehlerberichten Version, Browser, Ansichtsmodus, erwartetes und tatsächliches Verhalten sowie reproduzierbare Schritte. Bei Layoutproblemen helfen Fensterbreite und Zoomfaktor. Entferne Zugangsdaten und private Informationen aus Logs und Screenshots.

			[[Kategorie:FHEM Frontends]]

Fhem-cms

Stefan.apetz — Tue, 10 Nov 2026 17:01:38 GMT

Stefan.apetz löschte die Weiterleitung Fhem-cms durch Überschreiben Gelöscht, um Platz für die Verschiebung von „Fhem-cms-frontend“ zu schaffen

Fhem-cms-frontend

Stefan.apetz — Tue, 10 Nov 2026 17:01:38 GMT

Stefan.apetz verschob die Seite Fhem-cms-frontend nach Fhem-cms und überschrieb dabei eine Weiterleitung

Neue Seite

{{Infobox Modul
|ModPurpose=Browserbasierte Bedienoberfläche für FHEM mit grafischem Seiteneditor, Widgets, Live-Werten und gemeinsamem Assetmanager.
|ModType=x
|ModCmdRef=FHEMCMS
|ModTechName=01_FHEMCMS.pm
|ModOwner=[https://github.com/stapetz stapetz]
}}

'''fhem-cms''' ergänzt FHEM um eine frei gestaltbare Bedienoberfläche im Browser. Du kombinierst Gerätewerte, Bedienelemente, Texte, Bilder und Links auf eigenen Seiten. Das Layout erstellst du grafisch, ohne dafür eine komplette HTML-Oberfläche programmieren zu müssen.

Dieser Artikel beschreibt den stabilen Funktionsstand '''1.6.1''' und das aktuelle Seitenformat '''Schema 5'''. Das ausführliche, bebilderte [https://github.com/stapetz/fhem-cms/wiki GitHub-Handbuch] enthält zusätzliche Beispiele und Screenshots aller Widgettypen und ihrer Einstellungsdialoge.

__TOC__

== Idee und Funktionsumfang ==

Statt technische Geräteseiten einzeln aufzurufen, ordnest du Informationen nach Räumen oder Themen:

* Eine Startseite zeigt wichtige Zustände und Schnellzugriffe.
* Raumseiten bündeln Temperatur, Heizung, Beleuchtung und Fensterkontakte.
* Energieübersichten verbinden Tabellen, historische Diagramme und SolarFlow.
* Informationsseiten enthalten Anleitungen, Bilder und aktuelle FHEM-Werte im Fließtext.
* Linkkacheln führen zu anderen CMS-Seiten, Webseiten oder Dokumenten.

Das FHEM-Modul übernimmt Datenzugriff und Speicherung; der Browser stellt die Oberfläche dar. Das CMS verwendet FHEMWEB und dessen Sitzung. Ein zusätzlicher Cloud-Dienst ist nicht erforderlich.

FHEM bleibt für Geräte, Automatisierungen, Berechtigungen und die Aufzeichnung historischer Daten zuständig. Das CMS ersetzt diese Funktionen nicht.

== Voraussetzungen und Sicherheit ==

* FHEM 6.5 oder neuer und ein laufendes FHEMWEB.
* Ein aktueller Browser mit ES-Modulen, Web Components und HTML-Dialogen.
* Schreibrechte des FHEM-Betriebssystemkontos in den CMS-Daten- und Medienverzeichnissen.
* Für historische Diagramme: bereits vorhandene Aufzeichnungen in DbLog oder FileLog.

Die Projektanleitung nennt Perl 5.40 als getestete Umgebung, nicht als einzig mögliche Laufzeit. Für die normale Installation brauchst du weder Node.js noch einen eigenen Frontend-Build.

'''Wichtig: FHEMWEB ist die Sicherheitsgrenze.''' Es gibt keine separate CMS-Anmeldung. Richte Anmeldung, geschützten Transport und passende FHEM-Rechte ein, bevor du die Oberfläche außerhalb eines vertrauenswürdigen Netzes verwendest.

* Eine ausgeblendete Navigation oder eine Seite ohne Editor ist '''keine Zugriffssperre'''.
* <code>?mode=edit</code> schaltet die Ansicht um, ist aber keine Berechtigungsprüfung.
* Eine eigenständige CMS-Rollenverwaltung für Leser und Bearbeiter ist nicht vorauszusetzen.
* Bedienelemente können reale Geräte schalten. Auch die Vorschau ist nicht automatisch ein Simulationsmodus.
* Zugangsdaten, Tokens und sensible Metadaten gehören nicht in öffentliche Widgets, Screenshots oder Fehlerberichte.

== Installation ==

Erstelle zunächst eine vollständige Sicherung deiner FHEM-Installation.

Die folgenden Befehle gibst du in die '''FHEM-Befehlszeile''' ein, nicht in ein Betriebssystemterminal:

<pre>
update add https://raw.githubusercontent.com/stapetz/fhem-cms/main/controls_fhem-cms.txt
update all https://raw.githubusercontent.com/stapetz/fhem-cms/main/controls_fhem-cms.txt
shutdown restart
</pre>

Die Adresse zeigt auf eine '''Controls-Datei''', nicht direkt auf die Moduldatei. Dadurch werden Modul, Perl-Helfer und Frontend zusammen installiert. Der Neustart unterbricht FHEM kurz.

Nach dem Neustart legst du ein CMS-Device an:

<pre>
define CMS fhemcms
</pre>

<code>CMS</code> ist ein Beispielname. Ersetze ihn bei Bedarf in allen Befehlen durch deinen eigenen Device-Namen. Speichere anschließend die FHEM-Konfiguration.

Das Device erscheint standardmäßig im Raum '''FHEM CMS''':

{| class="wikitable"
! Einstieg am Device !! Funktion
|-
| '''CMS starten''' || Öffnet den Bearbeitungsmodus.
|-
| '''Zeige Homepage''' || Öffnet den veröffentlichten Stand.
|-
| <code>get CMS url</code> || Zeigt den relativen Homepagepfad.
|}

Bei FHEMWEB-Webname <code>fhem</code> und Device <code>CMS</code> lauten typische Pfade:

<pre>
/fhem/fhem-cms/CMS/index.html
/fhem/fhem-cms/CMS/index.html?mode=edit
</pre>

Verwende bevorzugt die erzeugten Device-Links, da Host, Port und Webname von deiner Installation abhängen. Die Modulversion findest du im Internal '''VERSION'''.

== Erste Seite erstellen ==

# Öffne am CMS-Device '''CMS starten'''.
# Wähle '''Bearbeiten → Widget hinzufügen → Wert'''.
# Suche ein vorhandenes FHEM-Device und wähle dessen gewünschtes Reading.
# Trage einen Titel und gegebenenfalls eine Einheit ein, beispielsweise „Außentemperatur“ und „°C“.
# Bestätige mit '''Speichern'''.
# Verschiebe das Widget am Punktgriff und ändere seine Größe am Griff unten rechts.
# Ergänze bei Bedarf ein '''Textwidget''' als Überschrift oder Einleitung.
# Kontrolliere den Entwurf unter '''Ansicht → Vorschau''' und in der Geräte-Vorschau.
# Wähle '''Datei → Entwurf veröffentlichen'''.
# Öffne die Homepage neu.

Device- und Reading-Namen werden nicht automatisch angelegt. Wähle die tatsächlich vorhandenen Quellen deiner FHEM-Installation.

== Editor, Entwurf und Veröffentlichung ==

{| class="wikitable"
! Ansicht !! Angezeigter Stand !! Zweck
|-
| Homepage ohne Modusparameter || Live || Veröffentlichte Oberfläche bedienen.
|-
| <code>?mode=edit</code> || Entwurf bzw. Ausgangsstand || Seiten und Widgets bearbeiten.
|-
| <code>?mode=preview</code> || Entwurf || Entwurf ohne Editorwerkzeuge prüfen.
|}

'''Speichern ist nicht Veröffentlichen:'''

* '''Speichern''' im Widgetdialog übernimmt Änderungen in den Entwurf.
* Verschieben und Skalieren werden automatisch als Entwurf gespeichert.
* '''Abbrechen''' verwirft noch nicht gespeicherte Dialogeingaben.
* '''Entwurf veröffentlichen''' ersetzt den Live-Stand; der bisherige Live-Stand wird gesichert.
* '''Entwurf verwerfen''' entfernt den Entwurf, nicht die Live-Konfiguration.

Ein CMS-Device hat '''einen gemeinsamen Entwurf''', nicht einen eigenen je Browser. Bei Konflikten oder einer unklaren Speicherbestätigung lädst du den aktuellen Zustand neu, statt mehrfach zu speichern.

{| class="wikitable"
! Menü !! Typische Aufgaben
|-
| Datei || Veröffentlichen, Verwerfen, Assetmanager, Sicherungen und Wiederherstellung.
|-
| Bearbeiten || Seiteneinstellungen, Widget hinzufügen, Widgets automatisch anordnen.
|-
| Ansicht || Vorschau und Rasteranzeige.
|}

Die Widgetwerkzeuge erscheinen auf Mausgeräten beim Überfahren oder Tastaturfokus; auf Touchgeräten ohne Hover bleiben sie sichtbar. Über den Stift öffnest du die Einstellungen, über den Seitenwechselknopf verschiebst du ein Widget auf eine andere Seite.

'''Ausnahme Assetmanager:''' Uploads, Umbenennen, Verschieben und Löschen gelten sofort, unabhängig vom Seitenentwurf.

== Seiten, Navigation und Layout ==

Die Navigation ist ein gemeinsames Widget für alle Seiten des CMS-Devices. Öffne dessen Stiftsymbol, um Seiten zu erstellen, umzubenennen, umzusortieren oder in der Navigation auszublenden.

* Ausgeblendete Seiten bleiben über ihren Link erreichbar und sind nicht geschützt.
* Zum Löschen einer Seite entfernst oder verschiebst du zunächst ihre Widgets und änderst referenzierende LinkWidget-Kacheln.
* Die letzte verbleibende Seite kann nicht einfach entfernt werden.
* Die Navigation lässt sich horizontal oder vertikal ausrichten, verschieben und skalieren.
* Bei Platzmangel erscheint ein aufklappbares Burger-Menü.
* Eine vergrößerte gemeinsame Navigation kann kollidierende Widgets auf allen Seiten nach unten verschieben.

Unter '''Bearbeiten → Seiteneinstellungen''' legst du Theme, Widgetrahmen, globale Titelausrichtung und Rasterdichte fest. Möglich sind '''12, 24, 48, 96 oder 192 Spalten'''. Die gemeinsamen Einstellungen gelten für alle Seiten des CMS-Devices.

Widgettitel lassen sich global links, zentriert oder rechts ausrichten. Ob ein Titel sichtbar ist, bestimmst du weiterhin am einzelnen Widget. Frei formatierte Überschriften im Textinhalt sind davon unabhängig.

'''Bearbeiten → Widgets automatisch anordnen''' rückt die Widgets der aktuellen Seite nach oben und links. Größen und Inhalte bleiben erhalten; die Änderung landet im Entwurf.

=== Fenstergröße, Zoom und mobile Ansicht ===

Navigation und Widgets skalieren gemeinsam mit der verfügbaren Breite. Browserzoom vergrößert oder verkleinert die Darstellung; bei Platzmangel kann der Rasterbereich seitlich scrollen.

Bis einschließlich '''600 Pixel Inhaltsbreite''' ordnen Homepage und Vorschau die Widgets in Leserichtung mit Zeilenumbruch an. Der Editor bleibt zum präzisen Positionieren beim exakten Raster. Das Drehen des Geräts verändert keine gespeicherten Rasterpositionen.

Prüfe vor der Veröffentlichung Desktop, Smartphone, Hoch-/Querformat und Browserzoom. Die Geräte-Vorschau hilft dabei, ersetzt aber nicht jeden Test auf dem Zielgerät.

== Widgetübersicht ==

{| class="wikitable"
! Widget !! Aufgabe und wichtige Hinweise
|-
| Wert || Ein einzelnes Reading mit optionalem Icon und Einheit groß anzeigen; keine Gerätebedienung.
|-
| Uhr / Datum || Browserzeit digital oder analog darstellen; Datum, Sekunden und Wochentag optional.
|-
| Status-Symbol || Exakte Readingwerte passenden Icons und Farben zuordnen; reine Anzeige.
|-
| Thermostat || Ist-/Solltemperatur, Sollwertregler, Betriebsart, Ventil und Batterie je nach verfügbaren Geräteinformationen.
|-
| Schalter || Mit den angebotenen An-/Aus-Befehlen schalten; Standarddarstellung „Nur Symbol“, Beschriftung optional.
|-
| Taster || Einen angebotenen Befehl ohne Parameter auslösen, etwa <code>toggle</code>; Standardsymbol passend zum Befehl.
|-
| Schieberegler || Einen Set-Befehl mit Sliderdeklaration bedienen; Bereich und Schrittweite vom Device.
|-
| Tabelle || Mehrere Readings mit eigenen Bezeichnern, Einheiten, Überschriften und optionaler Summe.
|-
| Diagramm || Geloggte numerische Messwerte aus DbLog oder FileLog darstellen.
|-
| SolarFlow || Leistungen zwischen PV, Haus, Netz und Batterie sowie optional den Batterieladestand visualisieren.
|-
| Text || Formatierten Text, Bilder, Links, Tabellen und Live-Platzhalter kombinieren.
|-
| Freies HTML || Bereinigtes HTML mit Live-Werten und zustandsabhängigen Farben; keine freie Skriptausführung.
|-
| LinkWidget || Interne Seiten, externe Webseiten oder Dokumente als Text-/Bildkacheln anbieten.
|}

Alle Widgetaufnahmen und Einstellungsdialoge findest du in der [https://github.com/stapetz/fhem-cms/wiki/Widgets bebilderten Widgetübersicht].

=== Geräte und Befehle richtig zuordnen ===

Nach einem Gerätewechsel prüfst du die neu angebotenen Readings und Set-Befehle. Beim Thermostat richten sich Solltemperaturbereich und Betriebsarten nach dem ausgewählten Gerät; gegebenenfalls werden dessen Kanäle berücksichtigt.

Schalter und Taster sind im Editor nicht zum Schalten vorgesehen. In der normalen Ansicht können sie reale Geräte bedienen.

Ein Slider benötigt eine passende Deklaration in der Set-Liste, beispielsweise:

<pre>
pct:slider,0,1,100
</pre>

Das bedeutet Minimum 0, Schrittweite 1 und Maximum 100. Eine reine Werteliste genügt dafür derzeit nicht. Slideränderungen werden 1,5 Sekunden nach der letzten Bewegung gesendet.

'''Einheiten sind meist Beschriftungen, keine Umrechnung.''' Die Auswahl „kWh“ wandelt einen Readingwert in Wh nicht automatisch um.

=== SolarFlow ===

Die PV-Leistung ist Pflicht; andere Quellen sind optional. Du kannst Werte aus einem Device oder aus mehreren Devices zuordnen. Ohne Hausverbrauchsreading kann der Hausverbrauch berechnet werden.

* Netzleistung: negativ bedeutet Bezug, positiv Einspeisung.
* Batterieleistung: positiv bedeutet Laden, negativ Entladen.
* Die W-/kW-Einstellung muss zu den Quellreadings passen.
* Fehlende Netz-/Batteriequellen blenden die betreffende Station aus.

Prüfe die Richtung an einem bekannten Betriebszustand; Hersteller verwenden nicht immer dieselbe Vorzeichenkonvention.

=== LinkWidget ===

Ein LinkWidget enthält 1 bis 200 Kacheln. Jede Kachel braucht einen Linktext, auch wenn dieser ausgeblendet ist. Ziele sind interne CMS-Seiten, externe HTTP-/HTTPS-Adressen und Dokumente aus dem Assetmanager.

Im Einstellungsdialog ordnest du die Kacheln in einem eigenen '''12-Spalten-Raster''' an. Verschieben erfolgt am Griff, Skalieren an der Ecke. Überlappungen sind nicht speicherbar.

Das innere Linkraster ist unabhängig vom äußeren Seitenraster. Ein „neues Fenster“ kann aufgrund von Browserregeln auch als Tab erscheinen.

== Text, Bilder und Live-Platzhalter ==

Das Textwidget bietet einen WYSIWYG-Editor mit Textformatierung, Überschriften, Listen, Farben, Links, Bildern und Tabellen.

* Über '''Bild''' öffnest du den gemeinsamen Assetmanager.
* Ein eingefügtes Bild kannst du anklicken, links/mittig/rechts ausrichten und proportional skalieren.
* Über '''<nowiki>{{ }}</nowiki>''' fügst du einen Live-Platzhalter ein.
* Im Editor erscheint dieser als grüner Baustein; ein Klick darauf öffnet seine Einstellungen.
* In der normalen Ansicht wird der Baustein durch den aktuellen Wert ersetzt.

=== Platzhalterbeispiele ===

<pre>
<nowiki>{{Garten:temperature|round(1)|suffix( °C)}}</nowiki>
<nowiki>{{Fenster:state|map(open=Offen,closed=Geschlossen)|default(unbekannt)}}</nowiki>
</pre>

Für eine Energieinformationsseite beispielsweise:

<pre>
<nowiki>{{virtualSolar:pv_total_power|suffix( W)}}</nowiki>
<nowiki>{{virtualSolar:EnergyTotal|round(2)|suffix( kWh)}}</nowiki>
</pre>

Die Device- und Readingnamen sind Beispiele. Wähle deine tatsächlichen Quellen. Filter werden von links nach rechts angewendet:

{| class="wikitable"
! Filter !! Wirkung
|-
| <code>round(n)</code> || Auf 0 bis 6 Nachkommastellen runden.
|-
| <code>int</code> || Nachkommastellen abschneiden.
|-
| <code>upper</code>, <code>lower</code> || Groß-/Kleinschreibung.
|-
| <code>default(Text)</code> || Ersatztext bei leerem Wert.
|-
| <code>prefix(Text)</code>, <code>suffix(Text)</code> || Text oder Einheit ergänzen.
|-
| <code>map(on=An,off=Aus)</code> || Readingwerte auf eigene Texte abbilden.
|}

Die Sonderwerte <code>@alias</code>, <code>@name</code> und <code>@type</code> liefern Geräteinformationen. Je Inhaltswidget sind höchstens 20 verschiedene Devices vorgesehen.

=== Freies HTML ===

Freies HTML unterstützt Platzhalter und alternativ Elemente mit <code>device</code>- und <code>reading</code>-Attributen:

<pre>
<nowiki><h3>Garten</h3>
Temperatur: {{Garten:temperature|round(1)|suffix( °C)}}
</nowiki>
</pre>

Erlaubtes HTML wird geprüft und bereinigt. Skripte, Iframes, Ereignisattribute und beliebige externe Inhalte sind nicht vorgesehen. Für Bilder und Links verwendest du das Textwidget oder LinkWidget.

== Assetmanager: gemeinsame Bilder und Dokumente ==

Über '''Datei → Assetmanager''' verwaltest du Dateien unabhängig vom gerade bearbeiteten Widget. Textwidget und LinkWidget verwenden denselben Katalog des CMS-Devices.

=== Ordner und Upload ===

* Die große Übersicht zeigt direkte Unterordner und Dateien des geöffneten Ordners.
* Ein Klick auf eine Ordnerkachel öffnet den Ordner; über den Pfad navigierst du zurück.
* '''Ordner erstellen''' legt einen Unterordner am aktuellen Ort an.
* Mehrfachauswahl und Drag-and-drop laden Dateien direkt in den geöffneten Ordner.
* Ganze Ordner werden nicht per Drop importiert.
* Identische Dateien können wiederverwendet werden und bleiben dann gegebenenfalls in ihrem bisherigen Ordner.
* Eine Assetsuche ist in Version 1.6.1 noch nicht enthalten.

=== Dateidetails und Aktionen ===

Wähle eine Datei, um ihre Eigenschaften rechts zu öffnen:

* '''Umbenennen''' ändert den Anzeigenamen; die Dateiendung bleibt geschützt.
* Die physischen Dateien behalten ihre Hash-Dateinamen; bestehende Verweise bleiben erhalten.
* '''Verschieben''' öffnet die grafische Zielordnerauswahl. '''Diesen Ordner verwenden''' führt die Aktion sofort aus.
* Ein Klick auf die Bildvorschau öffnet das Original in voller Größe.
* Bei vorhandenen EXIF-Daten öffnet das '''i''' ein Informationsfenster.
* '''Verwendungen anzeigen''' nennt Fundstellen in gespeicherten Live- und Entwurfsseiten.
* '''Löschen''' erfordert eine Bestätigung und ist bei vorhandenen Verwendungen gesperrt.
* Ordner lassen sich nur löschen, wenn sie leer sind.

'''Assetaktionen gelten sofort.''' Abbrechen eines Widgetdialogs oder Verwerfen des Seitenentwurfs macht Uploads, Umbenennungen oder Löschungen nicht rückgängig. „Bild entfernen“ im Widget entfernt dagegen nur den Verweis, nicht die Datei.

Die Verwendungsprüfung umfasst nicht beliebige externe Links, ungespeicherte Dialoge oder ältere Konfigurationsbackups.

=== Formate, Grenzen und Datenschutz ===

{| class="wikitable"
! Bereich !! Standard
|-
| Bilder || PNG, JPEG, GIF; bis 3 MiB je Datei.
|-
| Dokumente || Unter anderem PDF, Office-Dateien, ODT/ODS/ODP, TXT und CSV; bis 20 MiB je Datei.
|-
| Gesamtspeicher || 500 MiB je CMS-Device.
|}

Die Administration erlaubt Anpassungen. Technische Obergrenzen sind 50 MiB je Datei, 2048 MiB Gesamtspeicher, 2000 Assets, 200 Ordner und 10 Ordnerebenen. Aktive Web-/Skriptformate bleiben gesperrt.

Dokumente werden als Download angeboten; es gibt keine Office-Vorschau und keinen Virenscanner. EXIF-Daten werden lokal im Browser gelesen, aber nicht aus dem Original entfernt. Entferne sensible Kamera-/GPS-Daten vor dem Upload selbst.

Siehe [https://github.com/stapetz/fhem-cms/wiki/Assetmanager Assetmanager-Anleitung mit Screenshots].

== Historische Diagramme ==

Das Diagrammwidget zeichnet nicht selbst auf. Das Reading muss numerisch sein und bereits in DbLog oder FileLog aufgezeichnet werden.

Bei automatischer Quellenauswahl hat eine passende DbLog-Quelle Vorrang vor FileLog. Bei mehreren Quellen kannst du am CMS-Device gezielt zuordnen:

<pre>
attr CMS historySource dblog
attr CMS dbLog MeinDbLog
</pre>

Alternativ:

<pre>
attr CMS historySource filelog
attr CMS fileLog MeinFileLog
</pre>

Die genannten Logdevices müssen existieren und korrekt eingerichtet sein. Die Befehle legen keine Datenbank oder Logdatei an.

* Zeiträume: 24 Stunden, 7 Tage, 30 Tage oder 365 Tage.
* Granularität: automatisch, Rohdaten, 15 Minuten, 1 Stunde oder 1 Tag.
* Höchstens 400 dargestellte Punkte; größere Mengen werden mit Mittelwert und Min-/Max-Band zusammengefasst.
* Aktualisierung alle fünf Minuten; Abfragecache 30 Sekunden.

'''DbLog-Abfragen sind synchron und können FHEM blockieren.''' Beginne mit kurzen Zeiträumen und öffne nicht unnötig viele große Jahresdiagramme gleichzeitig.

== Updates ==

Für den produktiven Einsatz verwendest du die stabile Quelle '''main''':

<pre>
update all https://raw.githubusercontent.com/stapetz/fhem-cms/main/controls_fhem-cms.txt
shutdown restart
</pre>

Prüfe anschließend Updateprotokoll und Internal '''VERSION''' und lade den Browser vollständig neu.

Bei ausschließlich geänderten Frontenddateien genügt nach entsprechender Releaseanweisung:

<pre>
set CMS rebuild
</pre>

Das erneuert die generierte Startseite und die Frontend-Versionsparameter. Es löscht keine Seiten oder Entwürfe. Nach Änderungen des Perl-Moduls oder seiner Helfer ist ein FHEM-Neustart erforderlich.

'''dev''' ist für bewusst durchgeführte Tests vorgesehen. Ein Wechsel zwischen Entwicklungs- und stabilem Stand ist kein garantierter Daten-Rollback. Installiere nicht versehentlich beide Updatequellen parallel für dieselben Dateien.

== Sicherungen und ältere Installationen ==

Eine vollständige Sicherung umfasst FHEM-Konfiguration, CMS-Live-Stand, Entwurf, Konfigurationsbackups, Bilder, Dokumente sowie zusammenpassende Modul- und Frontenddateien.

Automatische CMS-Konfigurationsbackups enthalten '''keine Assetdateien'''. Die Wiederherstellung eines älteren Seitenstands holt gelöschte Bilder nicht zurück.

Unter '''Datei → Sicherungen / Wiederherstellung''' prüfst du ein Backup und kannst es nach Bestätigung der externen Sicherung wiederherstellen. Ein vorhandener Entwurf muss vorher bewusst veröffentlicht oder verworfen werden. Die Wiederherstellung ersetzt den '''Live-Stand'''.

=== Alte Layouts auf Schema 5 umstellen ===

Neue Devices beginnen bereits mit Schema 5 und 12 Spalten. Bei älteren Installationen kann '''Jetzt umstellen''' erscheinen.

'''Vorher vollständig sichern: Die Umstellung schreibt Daten und vergibt Positionen und Größen neu.''' Widgets und Einstellungen bleiben erhalten; Live und ein vorhandener Entwurf werden getrennt umgestellt. Der Entwurf wird nicht automatisch veröffentlicht.

Alternativ zum Editorbutton:

<pre>
set CMS layoutupgrade
</pre>

Es gibt dabei keine zusätzliche Bestätigung. Nach der Umstellung arbeitest du Positionen und Größen im Editor nach. Bei einem Fehler prüfst du Log, Sicherungen und Umstellungsjournal; überschreibe die Daten nicht durch manuelle JSON-Schreibversuche.

== Wichtige Dateien und Diagnose ==

Die Pfade beziehen sich auf das FHEM-Modulverzeichnis; <code><Device></code> steht für deinen CMS-Device-Namen.

{| class="wikitable"
! Pfad !! Inhalt
|-
| <code>FHEM/01_FHEMCMS.pm</code> || Modul.
|-
| <code>FHEM/lib/FHEMCMS/Assets.pm</code> || Serverseitige Assetverwaltung.
|-
| <code>www/fhem-cms/</code> || Gemeinsames Frontend.
|-
| <code>www/fhem-cms/<Device>/index.html</code> || Generierte Startseite; nicht manuell bearbeiten.
|-
| <code>www/fhem-cms/<Device>/media/</code> || Bilder.
|-
| <code>fhem-cms-data/<Device>/config.json</code> || Live-Konfiguration.
|-
| <code>fhem-cms-data/<Device>/draft.json</code> || Vorhandener Entwurf.
|-
| <code>fhem-cms-data/<Device>/assets.json</code> || Assetkatalog.
|-
| <code>fhem-cms-data/<Device>/assets/</code> || Private Dokumentdateien.
|}

Nützliche lesende FHEM-Befehle:

<pre>
get CMS url
get CMS status
get CMS backups
get CMS layoutformat
</pre>

Konfiguration, Katalog, generierte Startseite und Hash-Dateien nicht unabhängig voneinander bearbeiten. Fehlende Daten in einer bestehenden Installation nicht durch Löschen und erneutes Definieren „reparieren“; zuerst Sicherung und Rechte prüfen.

== Häufige Fragen ==

{| class="wikitable"
! Problem !! Prüfung / Abhilfe
|-
| Homepage zeigt alte Inhalte || Entwurf veröffentlichen und Homepage neu laden.
|-
| Nach Update erscheint altes Verhalten || Vollständige Controls-Quelle, Neustart bzw. rebuild und Browsercache prüfen.
|-
| Gedankenstrich statt Readingwert || Exakte Device-/Readingnamen, Kanalzuordnung und vorhandenen Wert prüfen.
|-
| „Veraltet seit …“ || Verbindung, FHEMWEB-Anmeldung und Rechte prüfen; ein alter Wert ist keine aktuelle Bestätigung.
|-
| Schalter reagiert im Editor nicht || Gewollt; zur Bedienung die normale Ansicht verwenden.
|-
| Gerät fehlt beim Schieberegler || Set-Liste muss einen Slider anbieten.
|-
| Diagrammreading fehlt || Aufzeichnung in DbLog/FileLog und bei FileLog die Regexp prüfen.
|-
| Einheit stimmt, Zahlenwert nicht || Reading-Skalierung prüfen; Einheitenbeschriftung rechnet nicht um.
|-
| Datei bleibt nach Abbrechen bestehen || Upload ist sofort wirksam und nicht Teil des Seitenentwurfs.
|-
| Datei lässt sich nicht löschen || Verwendungen in Live und Entwurf prüfen und zunächst entfernen.
|-
| Speicherzustand unklar oder Konflikt || Aktuellen Stand neu laden, nicht mehrfach blind speichern.
|}

== Weiterführende Dokumentation und Support ==

* [https://github.com/stapetz/fhem-cms Projekt und Quellcode]
* [https://github.com/stapetz/fhem-cms/wiki Vollständiges Anwenderhandbuch]
* [https://github.com/stapetz/fhem-cms/wiki/Widgets Widgetübersicht mit Screenshots und Einstellungsdialogen]
* [https://github.com/stapetz/fhem-cms/wiki/Text-und-Bilder Textwidget am Solax-Beispiel]
* [https://github.com/stapetz/fhem-cms/wiki/Assetmanager Assetmanager]
* [https://github.com/stapetz/fhem-cms/wiki/Platzhalter-und-HTML Platzhalter und freies HTML]
* [https://github.com/stapetz/fhem-cms/wiki/Sicherungen-und-Umstellung Sicherungen und Umstellung]
* [https://github.com/stapetz/fhem-cms/releases Veröffentlichungen]
* [https://github.com/stapetz/fhem-cms/issues Fehlerberichte und Weiterentwicklungen]

Nenne bei Fehlerberichten Version, Browser, Ansichtsmodus, erwartetes und tatsächliches Verhalten sowie reproduzierbare Schritte. Bei Layoutproblemen helfen Fensterbreite und Zoomfaktor. Entferne Zugangsdaten und private Informationen aus Logs und Screenshots.

Fhem-cms

Stefan.apetz — Tue, 10 Nov 2026 17:01:16 GMT

Stefan.apetz verschob die Seite Fhem-cms nach Fhem-cms-frontend

Neue Seite

Fhem-cms

Stefan.apetz — Tue, 10 Nov 2026 17:00:26 GMT

Frontend Modul fhem-cms

Neue Seite

Benutzer Diskussion:Stefan.apetz

Ph1959de — Tue, 10 Nov 2026 16:07:11 GMT

Willkommen

Neue Seite

== Willkommen! ==
{| width="100%" cellspacing="0" cellpadding="6" style="line-height: 20px; background: #E0E0E0; border: 2px solid #1874CD;"
|-
| colspan="4" style="background:#1874CD;" |<big>'''Hallo Stefan.apetz,''' willkommen im FHEM Wiki!</big>
|-
| colspan="4" | Danke für dein Interesse an unserem Projekt, ich freue mich schon auf deine weiteren Beiträge. Die folgenden Seiten sollten dir die ersten Schritte erleichtern, bitte nimm dir daher etwas Zeit, sie zu lesen.

----
'''FHEM-spezifische Informationen'''

|-
| width="8%" |  
| width="38%" | '''[[Systemübersicht]]''' ''FHEM Systemübersicht''
| width="8%" |  
| width="38%" | '''[[FHEMWiki:Über FHEMWiki]]''' ''Informationen über dieses Wiki''

|-
| colspan="4" |
----
'''Generelle Informationen über (Media)Wikis'''
|-
| width="8%" | [[Datei:Crystal Clear app kedit.svg|rechts|30px|link=Hilfe:Bearbeiten]]
| width="38%" | '''[[Hilfe:Bearbeiten]]''' ''Zugang zu allen wichtigen Informationen.''
| width="8%" | [[Datei:X-office-presentation.svg|rechts|30px|link=Wikipedia:Tutorial]]
| width="38%" | '''[http://de.wikipedia.org/wiki/Wikipedia:Tutorial Wikipedia:Tutorial]''' ''Schritt-für-Schritt-Anleitung für Einsteiger.''
|-
| [[Datei:Applications-system.svg|rechts|30px|link=Wikipedia:Grundprinzipien]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Grundprinzipien Wikipedia:Grundprinzipien]''' ''Die grundlegende Philosophie unseres Projekts.''
| [[Datei:MentorenProgrammLogo-7.svg|rechts|60px|link=Wikipedia:Mentorenprogramm]]
| '''[http://de.wikipedia.org/wiki/Wikipedia:Mentorenprogramm Wikipedia:Mentorenprogramm]''' ''Persönliche Einführung in die Beteiligung bei Wikipedia.''
|-
| colspan="4" |
----
Bitte beachte, [http://de.wikipedia.org/wiki/Wikipedia:Was_Wikipedia_nicht_ist was Wikipedia nicht ist], und "unterschreibe" deine Diskussionsbeiträge durch Eingabe von <code>--<nowiki>~~~~</nowiki></code> oder durch Drücken der Schaltfläche [[Datei:button_sig.png|Signaturknopf|20px|link=Hilfe:Signatur]] über dem Bearbeitungsfeld. Artikel werden jedoch nicht unterschrieben, und wofür die Zusammenfassungszeile da ist, erfährst du unter [http://de.wikipedia.org/wiki/Hilfe:Zusammenfassung_und_Quellen Zusammenfassung und Quellen]. 
[[Datei:Nuvola apps ksirc.png|25px|link=Benutzer Diskussion:Ph1959de]]    '''Hast du Fragen an mich?''' Schreib mir auf [[Benutzer Diskussion:Ph1959de|meiner Diskussionsseite]]! Viele Grüße, [[Benutzer:Ph1959de|Peter]] ([[Benutzer Diskussion:Ph1959de|Diskussion]]) 17:06, 10. Nov. 2026 (CET)
|}

Benutzer:Stefan.apetz

Ph1959de — Tue, 10 Nov 2026 16:06:15 GMT

Benutzerkonto Stefan.apetz wurde von Ph1959de erstellt und das Passwort wurde per E-Mail zugesandt Antrag per Mail

Fronthem Installation

Wvhn — Sat, 07 Nov 2026 08:57:54 GMT

Installation aus dem alternativen Repository und Systemvoraussetzung ergänzt

← Nächstältere Version		Version vom 7. November 2026, 09:57 Uhr
Zeile 14:		Zeile 14:
	== Vorraussetzungen schaffen ==		== Vorraussetzungen schaffen ==

	In Abhängigkeit der verwendeten Distribution gibt es mehrere Möglichkeiten, die einzelnen Pakete zu installieren {{Link2Forum\|Topic=38639\|Message=309479\|LinkText=(Forum)}}. Für einige Installationsschritte ist das Paket build-essential, dass über diesen ~~Befehlt~~ installiert werden kann. Sonst können die make's während der folgenden Schritte nicht ausgeführt werden {{Link2Forum\|Topic=30909\|Message=235986\|LinkText=(Forum)}}.		In Abhängigkeit der verwendeten Distribution gibt es mehrere Möglichkeiten, die einzelnen Pakete zu installieren {{Link2Forum\|Topic=38639\|Message=309479\|LinkText=(Forum)}}. Für einige Installationsschritte ist das Paket build-essential, dass über diesen Befehl installiert werden kann. Sonst können die make's während der folgenden Schritte nicht ausgeführt werden {{Link2Forum\|Topic=30909\|Message=235986\|LinkText=(Forum)}}.
	sudo apt-get install build-essential		sudo apt-get install build-essential

Zeile 48:		Zeile 48:

	Derzeit wird fronthem nicht aktiv weiterentwickelt. Es haben sich jedoch über die Jahre einige Verbesserungen im Forum angesammelt, die entweder den Austausch einzelner Dateien erforderten, oder die Änderung von Codezeilen. Um hier ein funktionierendes Gesamtpaket anzubieten, wurden alle Änderungen behelfsmäßig in ein alternatives Repository eingearbeitet: https://github.com/wvhn/fronthem. Im master branch ist dort eine gut getestete Version, die ohne weitere Modifikation lauffähig ist. Der develop branch enthält weitere Neuerungen vor allerm bei der universellen Zeitschaltuhr und den Plots. Allerdings sind diese Änderungen nicht breit getestet und die Dokumentation ist noch lückenhaft ([https://forum.fhem.de/index.php?topic=127432.msg1234367#msg1234367 Forum], [https://forum.fhem.de/index.php?topic=129106.0 Forum], [https://forum.fhem.de/index.php?topic=118668.msg1259044#msg1259044 Forum]).		Derzeit wird fronthem nicht aktiv weiterentwickelt. Es haben sich jedoch über die Jahre einige Verbesserungen im Forum angesammelt, die entweder den Austausch einzelner Dateien erforderten, oder die Änderung von Codezeilen. Um hier ein funktionierendes Gesamtpaket anzubieten, wurden alle Änderungen behelfsmäßig in ein alternatives Repository eingearbeitet: https://github.com/wvhn/fronthem. Im master branch ist dort eine gut getestete Version, die ohne weitere Modifikation lauffähig ist. Der develop branch enthält weitere Neuerungen vor allerm bei der universellen Zeitschaltuhr und den Plots. Allerdings sind diese Änderungen nicht breit getestet und die Dokumentation ist noch lückenhaft ([https://forum.fhem.de/index.php?topic=127432.msg1234367#msg1234367 Forum], [https://forum.fhem.de/index.php?topic=129106.0 Forum], [https://forum.fhem.de/index.php?topic=118668.msg1259044#msg1259044 Forum]).

			Die Installation aus diesem Repository erfolgt mit

			update force [https://raw.githubusercontent.com/wvhnj/fronthem/master/controls_fronthem.txt https://raw.githubusercontent.com/wvhn/fronthem/master/controls_fronthem.txt]

			Diese Version benötigt das Perl-Modul Time::Hires.

	== Ersteinrichtung innerhalb von FHEM ==		== Ersteinrichtung innerhalb von FHEM ==

MQTT2-Module - Praxisbeispiele

Soulman — Thu, 05 Nov 2026 21:19:27 GMT

es wird physisch geschaltet

← Nächstältere Version		Version vom 5. November 2026, 22:19 Uhr
Zeile 132:		Zeile 132:

	=== Shellybulb ===		=== Shellybulb ===
	Zunächst muss man einen Statusupdate des Shellybulb erzwingen (Aus- und Einschalten, ~~physikalisch~~ oder per Web-UI), damit das Gerät bei eingeschaltetem autocreate angelegt wird. Dies sieht zunächst so aus:		Zunächst muss man einen Statusupdate des Shellybulb erzwingen (Aus- und Einschalten, physisch oder per Web-UI), damit das Gerät bei eingeschaltetem autocreate angelegt wird. Dies sieht zunächst so aus:
	Internals:		Internals:
	CFGFN		CFGFN
Zeile 175:		Zeile 175:
	Nun auf Networks\| Internet (leider in APP und WebUI unterschiedlich), hier auf MQTT und die Einstellungen für den verwendeten MQTT Server treffen. Diese Einstellungen werden auch wieder durch Neustart übernommen.		Nun auf Networks\| Internet (leider in APP und WebUI unterschiedlich), hier auf MQTT und die Einstellungen für den verwendeten MQTT Server treffen. Diese Einstellungen werden auch wieder durch Neustart übernommen.
	=== Shelly Plus 1 ===		=== Shelly Plus 1 ===
	Zunächst muss man einen Statusupdate des Shelly erzwingen (Aus- und Einschalten, ~~physikalisch~~ oder per Web-UI), damit das Gerät bei eingeschaltetem autocreate angelegt wird. Dies sieht zunächst so aus:		Zunächst muss man einen Statusupdate des Shelly erzwingen (Aus- und Einschalten, physisch oder per Web-UI), damit das Gerät bei eingeschaltetem autocreate angelegt wird. Dies sieht zunächst so aus:
	<syntaxhighlight lang="text">		<syntaxhighlight lang="text">
	defmod MQTT2_shellyplus1_441793a34044 MQTT2_DEVICE shellyplus1_441793a34044		defmod MQTT2_shellyplus1_441793a34044 MQTT2_DEVICE shellyplus1_441793a34044

CDCOpenData

Alkazaa — Fri, 23 Oct 2026 15:32:40 GMT

← Nächstältere Version		Version vom 23. Oktober 2026, 16:32 Uhr
Zeile 19:		Zeile 19:
	* die prognostizierten Regenintensitäten der nächsten 120 Minuten; update alle 5 Minuten		* die prognostizierten Regenintensitäten der nächsten 120 Minuten; update alle 5 Minuten

	Die Werte werden für den akuellen 'Home'-Ort (soweit in global per latitude/longitude) ~~definiert~~ und für weitere konfigurierbare Orte in Deutschland und einige angrenzende Bereiche von Nachbarländern geliefert.		Die Werte werden für den akuellen 'Home'-Ort (soweit in global per latitude/longitude definiert) und für weitere konfigurierbare Orte in Deutschland und einige angrenzende Bereiche von Nachbarländern geliefert.

	==Anwendung==		==Anwendung==

TibberLive

Ph1959de — Wed, 21 Oct 2026 14:31:28 GMT

Erste Version der Seite

Neue Seite

{{Infobox Modul
|ModPurpose=Optionales Modul für Live-Messwerte eines Tibber Pulse
|ModType=x
|ModFTopic=145704
|ModForumArea=Automatisierung
|ModTechName=70_TibberLive.pm
|ModOwner=Frank Parussel
}}
[[TibberLive]] ist ein optionales Zusatzmodul (zu [[TibberConnect]]) für Live-Messwerte eines Tibber Pulse. Dafür werden zusätzliche Perl-Module benötigt; die Voraussetzungen stehen in der Anleitung.
(Informationen aus GitHub/README.md:) TibberLive ist ein separates, optionales Modul für Live-Messwerte eines Tibber Pulse. Die Module unterscheiden sich bei Datenart und Aktualisierung.
 
{{Randnotiz|RNTyp=y|RNText='''Disclaimer''' im GitHub Projekt: 
'''''Status und Hinweis''''': Eigenständiges Community-Projekt, kein offizieller Bestandteil von FHEM. Die Module wurden automatisiert und im praktischen FHEM-Betrieb geprüft. Vor der Installation eine Sicherung erstellen und die Einstellungen sorgfältig kontrollieren. Die Nutzung erfolgt in eigener Verantwortung.}}
Zugehöriges Modul: [[ZendureUtils]].

== Quelle / Installation ==
Siehe Kurzbeschreibung auf der Seite [[TibberConnect]] oder Beschreibung in der README.md

== Voraussetzungen ==

== Anwendung ==
=== Define ===

=== Attribute ===

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:Strompreis]]

TibberConnect

Ph1959de — Wed, 21 Oct 2026 14:31:23 GMT

Erste Version der Seite

Neue Seite

{{Infobox Modul
|ModPurpose=... verbindet FHEM mit der Tibber-REST-API
|ModType=x
|ModFTopic=145704
|ModForumArea=Automatisierung
|ModTechName=70_TibberConnect.pm
|ModOwner=Frank Parussel
}}
[[TibberConnect]] fragt über die Tibber-API Strompreise sowie Verbrauchs- und Kostendaten ab. Außerdem kann es ein günstiges, zusammenhängendes Zeitfenster von 1 bis 6 Stunden ermitteln.

(Informationen aus GitHub/README.md:) TibberConnect verbindet FHEM mit der Tibber-REST-API. Das Modul liest Preise, verzögerten Verbrauch und Kosten ein und stellt beratende Preisfenster bereit. [[TibberLive]] ist ein separates, optionales Modul für Live-Messwerte eines Tibber Pulse. Die Module unterscheiden sich bei Datenart und Aktualisierung.
 
{{Randnotiz|RNTyp=y|RNText='''Disclaimer''' im GitHub Projekt: 
'''''Status und Hinweis''''': Eigenständiges Community-Projekt, kein offizieller Bestandteil von FHEM. Die Module wurden automatisiert und im praktischen FHEM-Betrieb geprüft. Vor der Installation eine Sicherung erstellen und die Einstellungen sorgfältig kontrollieren. Die Nutzung erfolgt in eigener Verantwortung.}}
Zugehöriges Modul: [[ZendureUtils]].

== Quelle / Installation ==
Die Module zur Tibber Integration finden sich im Github und können mit
* <code>update add https://raw.githubusercontent.com/parussel/TibberConnect/main/controls_TibberConnect.txt</code>
und (zur Kontrolle) anschließendem
* <code>update check https://raw.githubusercontent.com/parussel/TibberConnect/main/controls_TibberConnect.txt</code>
zur Benutzung vorbereitet werden. Für weitere Schritte bitte README.md

== Voraussetzungen ==

== Anwendung ==
=== Define ===

=== Attribute ===

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:Strompreis]]

Strombörse

Ph1959de — Wed, 21 Oct 2026 14:31:14 GMT

GItHub Projekte TibberConnect/TibberLive verlinkt

← Nächstältere Version		Version vom 21. Oktober 2026, 15:31 Uhr
Zeile 9:		Zeile 9:

	== 1. Tibber mit Tibber Pulse ==		== 1. Tibber mit Tibber Pulse ==
			{{Randnotiz\|RNText=Seit Oktober 2026 gibt es (auf GitHub) zwei Module zur Anbindung von Tibber:
			* [[TibberConnect]] und
			* [[TibberLive]] }}
	Eine momentan verbreitete Methode zur Anbindung an Tibber ist ein Lesekopf auf dem EVU Zähler, der als "Tibber Pulse" vertrieben wird. Damit wird ein bestehender digitaler EVU Zähler ausgelesen und die Werte per LAN zu Tibber gesendet. Über eine API bei Tibber können dann die Verbrauchswerte und Kosten sowie ein Live Stream (WebSocket) abgefragt werden.		Eine momentan verbreitete Methode zur Anbindung an Tibber ist ein Lesekopf auf dem EVU Zähler, der als "Tibber Pulse" vertrieben wird. Damit wird ein bestehender digitaler EVU Zähler ausgelesen und die Werte per LAN zu Tibber gesendet. Über eine API bei Tibber können dann die Verbrauchswerte und Kosten sowie ein Live Stream (WebSocket) abgefragt werden.

ZendureUtils

Ph1959de — Tue, 20 Oct 2026 17:19:59 GMT

Erste Version der Seite

Neue Seite

{{Infobox Modul
|ModPurpose=Einbindung von Zendure-Geräten - Connect-Routinen
|ModType=x
|ModFTopic=137119
|ModCmdRef=ContribModul
|ModForumArea=Solaranlagen
|ModTechName=ZendureUtils.pm
|ModOwner=Github RP-Develop (Ralf)
}}
Das Modul [[ZendureUtils]] ergänzt einen [[MQTT2_CLIENT]] um ein Zendure Login und erzeugt für jedes Zendure Gerät ein [[MQTT2_DEVICE]] auf Wunsch automatisch.

Weitere Details auf der Seite [[Zendure (Modul)]]

== Anwendung ==
=== Define ===

=== Attribute ===

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:Solaranlagen]]

Zendure (Modul)

Ph1959de — Tue, 20 Oct 2026 17:19:46 GMT

Erste Version der Seite

Neue Seite

{{Infobox Modul
|ModPurpose=Einbindung von Zendure-Geräten
|ModType=x
|ModFTopic=137119
|ModCmdRef=ContribModul
|ModForumArea=Solaranlagen
|ModTechName=76_Zendure.pm
|ModOwner=Github RP-Develop (Ralf)
}}
Mit dem FHEM Modul [[Zendure (Modul)|Zendure]] können die Daten für ein Zendure-Login erzeugt werden. Mit diesen Zugangsdaten kann anschließend ein beliebiger MQTT Client konfiguriert werden.

Zugehöriges Modul: [[ZendureUtils]].

== Quelle / Installation ==
Die Module zur Zendure Integration finden sich im Github und können mit
* <code>update add https://raw.githubusercontent.com/RP-Develop/Zendure/main/controls_Zendure.txt</code>
und anschließendem
* <code>update check</code>
heruntergeladen und installiert werden.

== Voraussetzungen ==

== Anwendung ==
=== Define ===

=== Attribute ===

== Anwendungsbeispiele ==

== Links ==

[[Kategorie:Solaranlagen]]

Kategorie:Solaranlagen

Ph1959de — Tue, 20 Oct 2026 17:12:29 GMT

Kategorie angelegt und in Kategoriebaum "eingehängt"

Neue Seite

{{Randnotiz|RNTyp=Warn|RNText=Diese Kategorie ist derzeit nur "angelegt" und in den Kategoriebaum eingebunden.{{Todo|Die Kategoriebeschreibung muss noch ergänzt werden und die Kategorie (oder noch zu definierende Unterkategorien) vielen Seiten zugeordnet werden.

"Denkbare Unterkategorien" die teilweise schon existieren, aber noch nicht "zugewiesen" sind:
* Wechselrichter
* (Batterie-)Speicher
* Solar(thermie)module}} }}
Themen rund um Solaranlagen zur Wärme- oder Stromgewinnung.

[[Kategorie:Hardware Typen]]

Kategorie:Wechselrichter

Ph1959de — Tue, 20 Oct 2026 17:12:14 GMT

Im Kategoriebaum "umgehängt"

← Nächstältere Version		Version vom 20. Oktober 2026, 18:12 Uhr
Zeile 1:		Zeile 1:
	Diese Seite listet [https://de.wikipedia.org/wiki/Wechselrichter Wechselrichter], dabei im Wesentlichen Geräte, die in der Photovoltaik eingesetzt werden.		Diese Seite listet [https://de.wikipedia.org/wiki/Wechselrichter Wechselrichter], dabei im Wesentlichen Geräte, die in der Photovoltaik eingesetzt werden.

	[[Kategorie:~~Hardware Typen~~]]		[[Kategorie:Solaranlagen]]

MQTT2 CLIENT

Alkazaa — Tue, 20 Oct 2026 16:37:19 GMT

Der Modulname müsste 00_MQTT2_CLIENT.pm sein (10_MQTT2_CLIENT.pm gibt es nicht)

← Nächstältere Version		Version vom 20. Oktober 2026, 17:37 Uhr
Zeile 4:		Zeile 4:
	\|ModCmdRef=MQTT2_CLIENT		\|ModCmdRef=MQTT2_CLIENT
	\|ModForumArea=MQTT		\|ModForumArea=MQTT
	\|ModTechName=~~10_MQTT2_CLIENT~~.pm		\|ModTechName=00_MQTT2_CLIENT.pm
	\|ModOwner=rudolfkoenig ({{Link2FU\|8\|Forum}} / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])}}		\|ModOwner=rudolfkoenig ({{Link2FU\|8\|Forum}} / [[Benutzer Diskussion:Rudolfkoenig\|Wiki]])}}
	Das Modul [[MQTT2_CLIENT]] ermöglicht es, Geräte einzubinden, die über eine MQTT-Schnittstelle verfügen. Es fungiert als [[Interface\|Verbindung]] zwischen FHEM und einem externen MQTT Server (z.B. ''mosquitto'') und repräsentiert ein '''''MQTT Gateway'''''. Die durch die Module [[MQTT2_DEVICE]] oder {{Link2CmdRef\|Anker=MQTT_GENERIC_BRIDGE\|Lang=en\|Label=MQTT_GENERIC_BRIDGE}} repräsentierten Client-Geräte sind gesondert anzulegen.		Das Modul [[MQTT2_CLIENT]] ermöglicht es, Geräte einzubinden, die über eine MQTT-Schnittstelle verfügen. Es fungiert als [[Interface\|Verbindung]] zwischen FHEM und einem externen MQTT Server (z.B. ''mosquitto'') und repräsentiert ein '''''MQTT Gateway'''''. Die durch die Module [[MQTT2_DEVICE]] oder {{Link2CmdRef\|Anker=MQTT_GENERIC_BRIDGE\|Lang=en\|Label=MQTT_GENERIC_BRIDGE}} repräsentierten Client-Geräte sind gesondert anzulegen.

Installer

Ph1959de — Mon, 19 Oct 2026 16:06:30 GMT

Erste Version der Seite anlässlich Überarbeitung/Ownerwechsel

Neue Seite

{{Infobox Modul
|ModPurpose=Unterstützung bei der Verwaltung von Systemvoraussetzungen (packages)
|ModType=h
|ModForumArea=Unterstützende Dienste
|ModFTopic=145672
|ModTechName=98_Installer.pm
|ModOwner=DS_Starter ({{Link2FU|16933|Forum}}/[[Benutzer Diskussion:DS_Starter|Wiki]])
}}
(Auszug aus der commandref): [[Installer]] unterstützt bei der Verwaltung der Systemvoraussetzungen von FHEM: Das Modul ermittelt, welche Perl-Pakete die verwendeten FHEM-Module benötigen und ob diese installiert oder veraltet sind, und installiert, aktualisiert oder entfernt Perl-Pakete mit cpanm. Zusätzlich zeigt es Metadaten zu FHEM-Modulen und -Packages (Autoren, Support, Repository, Abhängigkeiten) und bietet eine Suche über Devices, Module, Packages, Keywords, Autoren und Perl-Pakete.

Das Modul ist eng mit dem Modul FHEM::Meta.pm verknüpft. Weiterführende Informationen enthalten die begleitenden Wiki Artikel zu [[Meta]] und [[CPAN]].
 
{{Randnotiz|RNTyp=y|RNText='''Oktober 2026''': Das Modul wird/wurde nach Ownerwechsel komplett überarbeitet, Details dazu in {{Link2Forum|Topic=145672|LinkText=Forenthema 145672}}. {{Todo|Die Änderungen aus der "Refaktorierung" müssen hier noch eingearbeitet und das Modul selbst insgesamt beschrieben werden!}} }}
== Voraussetzungen ==
Siehe Commandref.

== Anwendung ==
=== Define ===

=== Attribute ===

== Anwendungsbeispiele ==

== Links ==
* Forenthema zu Installer.pm: {{Link2Forum|Topic=98381|LinkText=[98_Installer.pm] FHEM Installer Helfer-Modul}}
* Forenthema zur kompletten Überarbeitung: {{Link2Forum|Topic=145672|LinkText=98_Installer - Modul komplett refaktoriert inkl. nutzbarer Online-Hilfe}}

[[Kategorie:Development]]

DOIF/uiTable Anwendung

Damian-s — Sun, 18 Oct 2026 18:27:30 GMT

Visualisierung: Energiefluss als Energie-Karte

← Nächstältere Version		Version vom 18. Oktober 2026, 19:27 Uhr
Zeile 640:		Zeile 640:
	''Ergebnis des unteren Anwendungsbeispiels in der Webansicht:''		''Ergebnis des unteren Anwendungsbeispiels in der Webansicht:''
	[[Datei:uiTable_energy_card.gif\|ohne]]		[[Datei:uiTable_energy_card.gif\|ohne]]

	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	defmod di_energy_card DOIF subs {\		defmod di_energy_card DOIF subs {\
			package energy_card;;\
	## Leistungangaben in kW, \		## Leistungangaben in kW, \
	$_grid_power_max=3.6;; # maximale Bezug/Einspeise-Leistung\		$_grid_power_max=3.6;; # maximale Bezug/Einspeise-Leistung\
Zeile 653:		Zeile 653:
	$_solar_energy_max=30;; # maximale PV Energie pro Tag\		$_solar_energy_max=30;; # maximale PV Energie pro Tag\
	$_home_energy_max=20;; # maximale Verbrauch pro Tag\		$_home_energy_max=20;; # maximale Verbrauch pro Tag\
	\
	~~package ui_Table;;\~~
	\		\
	sub move {\		sub move {\
Zeile 754:		Zeile 752:
	my ($power,$feed,$consum)=@_;;\		my ($power,$feed,$consum)=@_;;\
	\		\
	move(2,2,hcard {header=>"Netz",icon=>"scene_power_grid\@silver",rInnerRing=>"innerring",rMode=>"negzeropos",steps=>"steps",\		move(2,2,ui_Table::hcard {header=>"Netz",icon=>"scene_power_grid\@silver",rInnerRing=>"innerring",rMode=>"negzeropos",steps=>"steps",\
	left=>{collect=>$power,min=>-$_grid_power_max,max=>$_grid_power_max,decimal=>3,\		left=>{collect=>$power,min=>-$_grid_power_max,max=>$_grid_power_max,decimal=>3,\
	colorRef=>[(-0.33$_grid_power_max,20,-0.01,40,0.33$_grid_power_max,65,$_grid_power_max,85)],styleDesc=>"",desc=>" kW"},\		colorRef=>[(-0.33$_grid_power_max,20,-0.001,40,0.33$_grid_power_max,65,$_grid_power_max,85)],styleDesc=>"",desc=>" kW"},\
	top=>[{value=>$feed,min=>0,max=>$_grid_energy_feed_max,minColor=>60,maxColor=>90,desc=>"Einsp.", unit=>" kwh"},\		top=>[{value=>$feed,min=>0,max=>$_grid_energy_feed_max,minColor=>60,maxColor=>90,desc=>"Einsp.", unit=>" kwh"},\
	{value=>$consum,min=>0,max=>$_grid_energy_consum_max,minColor=>40,maxColor=>10,desc=>"Bezug.", unit=>" kwh"}]\		{value=>$consum,min=>0,max=>$_grid_energy_consum_max,minColor=>40,maxColor=>10,desc=>"Bezug.", unit=>" kwh"}]\
Zeile 765:		Zeile 763:
	sub self {\		sub self {\
	my ($autark,$EVG)=@_;;\		my ($autark,$EVG)=@_;;\
	move(200,151,ring2($autark,0,100,undef,undef,"Autarkie",120,[(33.3,40,66.6,65,100,85)],"0,,fill:silver, %",$EVG,0,100,190,170,"EVQ",undef,"0,,fill:silver, %",undef,undef,"nogradient,,innerring,nopointer"))\		move(200,151,ui_Table::ring2($autark,0,100,undef,undef,"Autarkie",120,[(33.3,40,66.6,65,100,85)],"0,,fill:silver, %",$EVG,0,100,190,170,"EVQ",undef,"0,,fill:silver, %",undef,undef,"nogradient,,innerring,nopointer"))\
	}\		}\
	sub solar { \		sub solar { \
	my ($power,$energy,$self_energy)=@_;; \		my ($power,$energy,$self_energy)=@_;; \
	\		\
	move(237,2,hcard {header=>"PV",icon=>"solar_icon\@silver",rInnerRing=>"innerring",steps=>"steps",\		move(237,2,ui_Table::hcard {header=>"PV",icon=>"solar_icon\@silver",rInnerRing=>"innerring",steps=>"steps",\
	left=>{collect=>$power,min=>0,max=>$_solar_power_max,decimal=>3,minColor=>60,maxColor=>90,styleDesc=>"",desc=>" kW"},\		left=>{collect=>$power,min=>0,max=>$_solar_power_max,decimal=>3,minColor=>60,maxColor=>90,styleDesc=>"",desc=>" kW"},\
	top=>[{value=>$self_energy,min=>0,max=>$_solar_energy_max,minColor=>60,maxColor=>90,desc=>"Eigen.", unit=>" kwh"},\		top=>[{value=>$self_energy,min=>0,max=>$_solar_energy_max,minColor=>60,maxColor=>90,desc=>"Eigen.", unit=>" kwh"},\
Zeile 781:		Zeile 779:
	my ($power,$consum)=@_;; \		my ($power,$consum)=@_;; \
	\		\
	move(2,222,hcard {header=>"Haus",icon=>"fa_home\@silver",rInnerRing=>"innerring",steps=>"steps",\		move(2,222,ui_Table::hcard {header=>"Haus",icon=>"fa_home\@silver",rInnerRing=>"innerring",steps=>"steps",\
	left=>{collect=>$power,min=>0,max=>,$_home_power_max,decimal=>3,minColor=>40,maxColor=>10,styleDesc=>"",desc=>" kW"},\		left=>{collect=>$power,min=>0,max=>,$_home_power_max,decimal=>3,minColor=>40,maxColor=>10,styleDesc=>"",desc=>" kW"},\
	top=>[{value=>$consum,min=>0,max=>,$_home_energy_max,minColor=>40,maxColor=>10,desc=>"Verbr.",unit=>" kwh"}]\		top=>[{value=>$consum,min=>0,max=>,$_home_energy_max,minColor=>40,maxColor=>10,desc=>"Verbr.",unit=>" kwh"}]\
Zeile 790:		Zeile 788:
	my ($power,$cap)=@_;;\		my ($power,$cap)=@_;;\
	\		\
	move(237,222,hcard {header=>"Speicher",icon=>"battery_100\@silver",rInnerRing=>"innerring",steps=>"steps",rMode=>"negzeropos",\		move(237,222,ui_Table::hcard {header=>"Speicher",icon=>"battery_100\@silver",rInnerRing=>"innerring",steps=>"steps",rMode=>"negzeropos",\
	left=>{collect=>$power,min=>-$_battery_power_max,max=>$_battery_power_max,decimal=>3,colorRef=>[(-0.0001,200,$_battery_power_max,160)],\		left=>{collect=>$power,min=>-$_battery_power_max,max=>$_battery_power_max,decimal=>3,colorRef=>[(-0.0001,200,$_battery_power_max,160)],\
	styleDesc=>"",desc=>" kW"},\		styleDesc=>"",desc=>" kW"},\
Zeile 798:		Zeile 796:
	}\		}\
	} # subs		} # subs
	attr di_energy_card DOIF_Readings grid_power: [MQTT2_DVES_C58DCB:~~power_fc~~] ## Leistung Netz Einspeisung kW negativ Bezug kW,\		attr di_energy_card DOIF_Readings grid_power: -[MQTT2_DVES_C58DCB:SENSOR_MT681_Power_cur]/1000 ## Leistung Netz Einspeisung kW negativ Bezug kW,\
	grid_energy_feed: [di_counter_new:MQTT2_DVES_C58DCB.total_f.day] ## Energie Einspeisung kWh,\		grid_energy_feed: [di_counter_new:MQTT2_DVES_C58DCB.total_f.day] ## Energie Einspeisung kWh,\
	grid_energy_consum: [di_counter_new:MQTT2_DVES_C58DCB.total_c_positiv.day],\		grid_energy_consum: [di_counter_new:MQTT2_DVES_C58DCB.total_c_positiv.day],\
	solar_power: [~~MQTT2_DVES_C58DCB~~:power_pv] ## Leistung PV kW,\		solar_power: [MQTT2_sbfspot:power_pv] ## Leistung PV kW,\
	solar_energy: [di_counter_new:MQTT2_DVES_C58DCB.total_pv.day] ## Energie PV kWh,\		solar_energy: [di_counter_new:MQTT2_DVES_C58DCB.total_pv.day] ## Energie PV kWh,\
	solar_self_energy: [di_counter_new:MQTT2_DVES_C58DCB.total_pv.day]-[di_counter_new:MQTT2_DVES_C58DCB.total_f.day] ## Eigenverbrauch PV kWh,\		solar_self_energy: [di_counter_new:MQTT2_DVES_C58DCB.total_pv.day]-[di_counter_new:MQTT2_DVES_C58DCB.total_f.day] ## Eigenverbrauch PV kWh,\
	~~home_power: ([MQTT2_DVES_C58DCB:power_home_c] < 0 ? undef:int([MQTT2_DVES_C58DCB:power_home_c]*1000)/1000) ## Leistung Haus kW,\~~
	home_energy: [di_counter_new:MQTT2_DVES_C58DCB.total_home_c.day] ## Energie Haus kWh,\		home_energy: [di_counter_new:MQTT2_DVES_C58DCB.total_home_c.day] ## Energie Haus kWh,\
	~~battery_power~~: ~~int(~~([~~MQTT2_DVES_C58DCB~~:~~battery_charge~~]-[~~MQTT2_DVES_C58DCB~~:~~battery_discharge~~])*1000)/1000## Leistung ~~Speicher~~ kW,\		battery-energy: ([ecoflowStreamACpro:quota_accuChgEnergy]-[ecoflowStreamACpro:quota_accuDsgEnergy]) ## Energie in kWh,\
			battery_power: int([ecoflowStreamACpro:quota_powGetBpCms])/1000 ## Leistung in kW,\
			home_power: [$SELF:solar_power]-[$SELF:grid_power]-[$SELF:battery_power] ## Leistung Haus kW,\
	battery_capa: [ecoflowStreamACpro:quota_soc] ## Kapazität Speicher % (gesammelt für Card),\		battery_capa: [ecoflowStreamACpro:quota_soc] ## Kapazität Speicher % (gesammelt für Card),\
	autarchy:([di_counter_new:MQTT2_DVES_C58DCB.total_pv.month]-[di_counter_new:MQTT2_DVES_C58DCB.total_f.month])/[di_counter_new:MQTT2_DVES_C58DCB.total_consum.month]*100 ## Autarkie %,\		autarchy:([di_counter_new:MQTT2_DVES_C58DCB.total_pv.month]-[di_counter_new:MQTT2_DVES_C58DCB.total_f.month])/[di_counter_new:MQTT2_DVES_C58DCB.total_consum.month]*100 ## Autarkie %,\
Zeile 816:		Zeile 815:
	\		\
	## Energy_card kann über das Attribut zoom skalliert werden\		## Energy_card kann über das Attribut zoom skalliert werden\
			\
	\		\
	$TABLE = 'zoom: 1;; width: 473px;; height: 384px;; text-align: left;; vertical-align: top;; border-radius:0%;; position:relative;; background: linear-gradient(to bottom, rgb(40,40,40), rgb(60, 60, 60));; ';;\		$TABLE = 'zoom: 1;; width: 473px;; height: 384px;; text-align: left;; vertical-align: top;; border-radius:0%;; position:relative;; background: linear-gradient(to bottom, rgb(40,40,40), rgb(60, 60, 60));; ';;\
	\		\
	package ~~ui_Table~~;;\		package energy_card;;\
	\		\
	} ## end of perl area\		} ## end of perl area\

SolarForecast - Solare Prognose (PV Erzeugung) und Verbrauchersteuerung

DS Starter — Fri, 16 Oct 2026 07:55:08 GMT

Backup und Wiederherstellung der Moduldaten

← Nächstältere Version		Version vom 16. Oktober 2026, 08:55 Uhr
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt)
Zeile 3.296:		Zeile 3.296:

	<pre>		<pre>
	Init_SolarForecast_<name> - ~~initiatiale~~ Daten die vor dem Einlesen weiterer Daten oder Attribute geladen werden		Init_SolarForecast_<name> - initiale Daten die vor dem Einlesen weiterer Daten oder Attribute geladen werden
	PVH_SolarForecast_<name> - PV History		PVH_SolarForecast_<name> - PV History
	PVC_SolarForecast_<name> - PV Circular		PVC_SolarForecast_<name> - PV Circular
Zeile 3.336:		Zeile 3.336:


			'''Fall 1:''' <br>
	* 1. definieren des neuen SolarForecast Devices, d.h. ein einfaches "define <Name> SolarForecast", und sichern der FHEM Konfiguration (der Konfigurationsdialog muß nicht durchgeführt werden)		* 1. definieren des neuen SolarForecast Devices, d.h. ein einfaches "define <Name> SolarForecast", und sichern der FHEM Konfiguration (der Konfigurationsdialog muß nicht durchgeführt werden)
	* 2. FHEM stoppen		* 2. FHEM stoppen
Zeile 3.353:		Zeile 3.354:


			'''Fall 2:''' <br>
	* 1. definieren des neuen SolarForecast Devices, d.h. ein einfaches "define <Name> SolarForecast", und sichern der FHEM Konfiguration (der Konfigurationsdialog muß nicht durchgeführt werden)		* 1. definieren des neuen SolarForecast Devices, d.h. ein einfaches "define <Name> SolarForecast", und sichern der FHEM Konfiguration (der Konfigurationsdialog muß nicht durchgeführt werden)
	* 2. FHEM stoppen		* 2. FHEM stoppen

← Nächstältere Version		Version vom 14. November 2026, 06:59 Uhr
Zeile 157:		Zeile 157:
	<br clear=all>[[Datei:Gaugewidgets.png\|mini\|rechts]]		<br clear=all>[[Datei:Gaugewidgets.png\|mini\|rechts]]
	* Wiki Seite zu [[FHEMWEB/Gauge\| Gauge-Widgets]]		* Wiki Seite zu [[FHEMWEB/Gauge\| Gauge-Widgets]]

	<br clear=all>[[Datei:Popup.png\|mini\|rechts]]		<br clear=all>[[Datei:Popup.png\|mini\|rechts]]
	* Wiki Seite zu [[FHEMWEB/Popup\| Popup-Widget]]		* Wiki Seite zu [[FHEMWEB/Popup\| Popup-Widget]]
			<br clear=all>[[Datei:Shutter.png\|mini\|rechts]]
			* Wiki Seite zu [[FHEMWEB/Shutter\| Shutter-Widgets]]

	[[Kategorie:Code Snippets]]		[[Kategorie:Code Snippets]]

← Nächstältere Version		Version vom 19. Oktober 2026, 17:07 Uhr
Zeile 1:		Zeile 1:
	= ~~Development Module and Package Meta Data~~ =		{{Infobox Modul
			\|ModPurpose=Dokumentation von Modulabhängigkeiten
			\|ModType=h
	== ~~Einleitung ==~~		\|ModForumArea=FHEM Development
			\|ModFTopic=
			\|ModTechName=Meta.pm
			\|ModOwner=DS_Starter ({{Link2FU\|16933\|Forum}}/[[Benutzer Diskussion:DS_Starter\|Wiki]])
			}}
	Neben den für ein FHEM Modul notwendigen [[DevelopmentModuleIntro\|obligatorischen]] Metadaten (CommandRef, Kurzbeschreibung, Typ), gibt es in FHEM das Perl Package FHEM::Meta (oder kurz Meta.pm). Die Einbindung in ein FHEM Modul (= stellt Devices zur Verfügung) oder ein FHEM Package (= stellt Subroutinen für ein oder mehrere FHEM Module bereit) ermöglicht es, Informationen über das Modul in Form eines JSON [https://perldoc.perl.org/perlpod.html Pod] (auch META.json genannt) direkt in die Datei mit einzubetten. Darüber wird es möglich, diese Zusatzinformationen auch bereits auszuwerten und anzuzeigen, ohne dass ein Modul geladen oder verwendet wird. Beispielsweise kann ermittelt werden, welche Perl Module für die Nutzung des Moduls notwendig sind und ob eine bestimmte Version vorausgesetzt wird. Außerdem können Informationen über die Version des Moduls, die Historie, den Autor, für Supportanfragen und vieles weiteres hinterlegt werden.		Neben den für ein FHEM Modul notwendigen [[DevelopmentModuleIntro\|obligatorischen]] Metadaten (CommandRef, Kurzbeschreibung, Typ), gibt es in FHEM das Perl Package FHEM::Meta (oder kurz Meta.pm). Die Einbindung in ein FHEM Modul (= stellt Devices zur Verfügung) oder ein FHEM Package (= stellt Subroutinen für ein oder mehrere FHEM Module bereit) ermöglicht es, Informationen über das Modul in Form eines JSON [https://perldoc.perl.org/perlpod.html Pod] (auch META.json genannt) direkt in die Datei mit einzubetten. Darüber wird es möglich, diese Zusatzinformationen auch bereits auszuwerten und anzuzeigen, ohne dass ein Modul geladen oder verwendet wird. Beispielsweise kann ermittelt werden, welche Perl Module für die Nutzung des Moduls notwendig sind und ob eine bestimmte Version vorausgesetzt wird. Außerdem können Informationen über die Version des Moduls, die Historie, den Autor, für Supportanfragen und vieles weiteres hinterlegt werden.

Zeile 9:		Zeile 12:

	== Der FHEM Installer ==		== Der FHEM Installer ==
			Der FHEM [[Installer]] ist ein FHEM Modul, welches ein graphisches Interface für die Metadaten bereitstellt. Mit Hilfe des FHEM Installers werden die Metadaten auch für Module in den Speicher geladen, welche keine explizite Unterstützung eingebaut haben. Sobald man die Informationen für ein bestimmtes Modul oder Package abfragt, wird der Meta-Hash über die Funktion FHEM::Meta::Load() geladen. Für FHEM Module, die beim Start von FHEM bereits in Verwendung sind, werden die Metadaten automatisch im Voraus geladen, so dass sie zur Laufzeit zur Verfügung stehen. Es ist geplant, dass dies auch zur Laufzeit für Module, für die der Benutzer ein neues Device anlegt, geschieht.
	Der FHEM Installer ist ein FHEM Modul, welches ein graphisches Interface für die Metadaten bereitstellt. Mit Hilfe des FHEM Installers werden die Metadaten auch für Module in den Speicher geladen, welche keine explizite Unterstützung eingebaut haben. Sobald man die Informationen für ein bestimmtes Modul oder Package abfragt, wird der Meta-Hash über die Funktion FHEM::Meta::Load() geladen. Für FHEM Module, die beim Start von FHEM bereits in Verwendung sind, werden die Metadaten automatisch im Voraus geladen, so dass sie zur Laufzeit zur Verfügung stehen. Es ist geplant, dass dies auch zur Laufzeit für Module, für die der Benutzer ein neues Device anlegt, geschieht.

	Die Grundfunktion des FHEM Installer ist jedoch nicht die Bereitstellung der Metadaten, sondern die Auswertung derselben. In seiner weiteren Entwicklung soll er dabei unterstützen fehlende Systemkomponenten, die für die Nutzung eines FHEM Moduls notwendig sind, zu installieren und aktuell zu halten. Die Installation und Aktualisierung von Perl Modulen ist bereits jetzt in einer ersten Ausbaustufe möglich.		Die Grundfunktion des FHEM Installer ist jedoch nicht die Bereitstellung der Metadaten, sondern die Auswertung derselben. In seiner weiteren Entwicklung soll er dabei unterstützen fehlende Systemkomponenten, die für die Nutzung eines FHEM Moduls notwendig sind, zu installieren und aktuell zu halten. Die Installation und Aktualisierung von Perl Modulen ist bereits jetzt in einer ersten Ausbaustufe möglich.
Zeile 17:		Zeile 19:

	Hinweis: Die Weiterentwicklung von FHEM::Meta ist stark an die weitere Entwicklung des FHEM Installer geknüpft. Dort geht es dann insbesondere darum, dass FHEM Module aus anderen Installationsquellen neben dem SVN die gleiche Metadaten einliefern können, insbesondere was Versionierung und Historie angehen. Dieses und mehr ist jedoch ein ganz eigenes Kapitel und soll deshalb für das Thema FHEM::Meta nur kurz erwähnt sein.		Hinweis: Die Weiterentwicklung von FHEM::Meta ist stark an die weitere Entwicklung des FHEM Installer geknüpft. Dort geht es dann insbesondere darum, dass FHEM Module aus anderen Installationsquellen neben dem SVN die gleiche Metadaten einliefern können, insbesondere was Versionierung und Historie angehen. Dieses und mehr ist jedoch ein ganz eigenes Kapitel und soll deshalb für das Thema FHEM::Meta nur kurz erwähnt sein.


	== Der search-Befehl ==		== Der search-Befehl ==

	Der FHEM Befehl <code>search</code> ist ein Wrapper, um den Get-Befehl <code>search</code> beim FHEM Installer Device im Schnellzugriff über die FHEM Befehlszeile aufzurufen. Hierüber lassen sich die Metadaten aller FHEM Module durchsuchen und ermöglicht so das Auffinden von FHEM Modulen für eine bestimmte Funktion oder ein Gebiet. FHEM Module, die einen META.json Pod bereitstellen, können dort Schlagworte hinterlegen, über die das Modul in der Suche gefunden werden können soll. FHEM::Meta generiert für Module, die über das SVN bereitgestellt werden, bereits einige Schlagworte basierend auf dem hinterlegten Support Forum in MAINTAINER.txt. Auch Der Modul Typ (helper\|device\|command) findet sich als eigenes Schlagwort wieder. Man erhält also Out-of-the-Box bereits eine ziemlich gute Kategorisierung über den Anwendungsbereich eines bestimmten Moduls und welche anderen Module noch in diesen Bereich fallen. Ein Modulname alleine hingegen lässt oftmals nicht auf die Funktionalität dahinter schließen, insbesondere wenn Hersteller- oder Produktnamen eine Rolle spielen, die man selbst bisher nicht kennt.		Der FHEM Befehl <code>search</code> ist ein Wrapper, um den Get-Befehl <code>search</code> beim FHEM Installer Device im Schnellzugriff über die FHEM Befehlszeile aufzurufen. Hierüber lassen sich die Metadaten aller FHEM Module durchsuchen und ermöglicht so das Auffinden von FHEM Modulen für eine bestimmte Funktion oder ein Gebiet. FHEM Module, die einen META.json Pod bereitstellen, können dort Schlagworte hinterlegen, über die das Modul in der Suche gefunden werden können soll. FHEM::Meta generiert für Module, die über das SVN bereitgestellt werden, bereits einige Schlagworte basierend auf dem hinterlegten Support Forum in MAINTAINER.txt. Auch Der Modul Typ (helper\|device\|command) findet sich als eigenes Schlagwort wieder. Man erhält also Out-of-the-Box bereits eine ziemlich gute Kategorisierung über den Anwendungsbereich eines bestimmten Moduls und welche anderen Module noch in diesen Bereich fallen. Ein Modulname alleine hingegen lässt oftmals nicht auf die Funktionalität dahinter schließen, insbesondere wenn Hersteller- oder Produktnamen eine Rolle spielen, die man selbst bisher nicht kennt.


	== Erweiterung eines FHEM Moduls mit META.json Pod ==		== Erweiterung eines FHEM Moduls mit META.json Pod ==

	Möchte ein Modulautor aktiven Support für FHEM::Meta einbauen, dann ist der erste Schritt die Bereitstellung eines META.json Abschnitts am Ende der Modul- oder Paketdatei. Dieser Abschnitt beinhaltet ein reguläres JSON Objekt. Deshalb empfiehlt es sich den Abschnitt vor dem hinzufügen über einen JSON Validator auf seine Syntax zu überprüfen. Ansonsten wird von FHEM::Meta beim laden eine entsprechende Meldung im FHEM Log ausgegeben und es werden keinerlei Metadaten mehr über das Modul bereitgestellt. Sobald ein META.json Abschnitt vorhanden ist, geht FHEM::Meta davon aus, dass dieses maßgeblich ist und wird deshalb nur noch Daten ergänzen, die dort nicht enthalten sind. Fehlt also ein valides META.json Objekt als Basis, so werden auch diese Ergänzungen nicht erfolgen und der Modulautor muss zunächst zwingend das JSON Gerüst korrigieren.		Möchte ein Modulautor aktiven Support für FHEM::Meta einbauen, dann ist der erste Schritt die Bereitstellung eines META.json Abschnitts am Ende der Modul- oder Paketdatei. Dieser Abschnitt beinhaltet ein reguläres JSON Objekt. Deshalb empfiehlt es sich den Abschnitt vor dem hinzufügen über einen JSON Validator auf seine Syntax zu überprüfen. Ansonsten wird von FHEM::Meta beim laden eine entsprechende Meldung im FHEM Log ausgegeben und es werden keinerlei Metadaten mehr über das Modul bereitgestellt. Sobald ein META.json Abschnitt vorhanden ist, geht FHEM::Meta davon aus, dass dieses maßgeblich ist und wird deshalb nur noch Daten ergänzen, die dort nicht enthalten sind. Fehlt also ein valides META.json Objekt als Basis, so werden auch diese Ergänzungen nicht erfolgen und der Modulautor muss zunächst zwingend das JSON Gerüst korrigieren.

Zeile 49:		Zeile 47:

	=encoding utf8		=encoding utf8


	...		...


	=cut		=cut
Zeile 63:		Zeile 59:

	== Eigenständiges Laden der Metadaten aus einem FHEM Modul heraus ==		== Eigenständiges Laden der Metadaten aus einem FHEM Modul heraus ==

	Ein FHEM Modul kann selbstständig die Unterstützung für das Laden der Metadaten in den %modules Hash einbauen, um diese unabhängig vom FHEM Installer zur Verfügung zu haben.		Ein FHEM Modul kann selbstständig die Unterstützung für das Laden der Metadaten in den %modules Hash einbauen, um diese unabhängig vom FHEM Installer zur Verfügung zu haben.
	Hierfür muss am Beginn der Moduldatei zunächst <code>use FHEM::Meta;</code> hinzugefügt werden und die <code>X_Initialize();</code> Funktion am Ende um einen Initialisierungsaufruf erweitert werden:		Hierfür muss am Beginn der Moduldatei zunächst <code>use FHEM::Meta;</code> hinzugefügt werden und die <code>X_Initialize();</code> Funktion am Ende um einen Initialisierungsaufruf erweitert werden:

	==== X_Initialize ====		=== X_Initialize ===
	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	use FHEM::Meta;		use FHEM::Meta;
Zeile 83:		Zeile 78:

	== Anzeigen der Modulversion über FHEM::Meta ==		== Anzeigen der Modulversion über FHEM::Meta ==

	Im META.json Objekt kann eine Version des Moduls explizit in [https://semver.org/ semantischer Form] (beispielsweise v1.2.3) angegeben werden. Ist dies nicht der Fall, dann generiert FHEM::Meta eine eigene Versionsnummer auf Basis der Revisionsnummer aus dem Subversion Repository im <code>$Id$</code> Abschnitt der Moduldatei. Dies gilt jedoch nur für Module, die auch tatsächlich über das SVN verteilt werden, ansonsten wird dieser Abschnitt ignoriert. Durch die Angabe der Versionsnummer im META.json Objekt wird es somit erstmals möglich, dass auch Module außerhalb des SVN mit einer einheitlichen Art der Versionierung auftreten können.		Im META.json Objekt kann eine Version des Moduls explizit in [https://semver.org/ semantischer Form] (beispielsweise v1.2.3) angegeben werden. Ist dies nicht der Fall, dann generiert FHEM::Meta eine eigene Versionsnummer auf Basis der Revisionsnummer aus dem Subversion Repository im <code>$Id$</code> Abschnitt der Moduldatei. Dies gilt jedoch nur für Module, die auch tatsächlich über das SVN verteilt werden, ansonsten wird dieser Abschnitt ignoriert. Durch die Angabe der Versionsnummer im META.json Objekt wird es somit erstmals möglich, dass auch Module außerhalb des SVN mit einer einheitlichen Art der Versionierung auftreten können.
	Eine semantische Versionsnummer wird von FHEM::Meta automatisch über die Perl Builtin Module version in einen Float Wert umgewandelt, um nummerische Vergleiche zu ermöglichen.		Eine semantische Versionsnummer wird von FHEM::Meta automatisch über die Perl Builtin Module version in einen Float Wert umgewandelt, um nummerische Vergleiche zu ermöglichen.
Zeile 89:		Zeile 83:
	FHEM::Meta bietet eine Funktion, um die essentiellen Metadaten zum Versionsstand eines Moduls als Internal mit dem Namen FVERSION anzuzeigen. Dafür kann man an den Beginn der <code>X_Define()</code> Funktion folgenden Aufruf setzen:		FHEM::Meta bietet eine Funktion, um die essentiellen Metadaten zum Versionsstand eines Moduls als Internal mit dem Namen FVERSION anzuzeigen. Dafür kann man an den Beginn der <code>X_Define()</code> Funktion folgenden Aufruf setzen:

	==== X_Define ====		=== X_Define ===
	<syntaxhighlight lang="perl">		<syntaxhighlight lang="perl">
	sub X_Define($$)		sub X_Define($$)
Zeile 115:		Zeile 109:
	Für Module außerhalb des SVN werden diese Informationen entsprechend anders zusammengetragen oder müssen/können über das META.json Objekt bereitgestellt werden.		Für Module außerhalb des SVN werden diese Informationen entsprechend anders zusammengetragen oder müssen/können über das META.json Objekt bereitgestellt werden.
	Hierbei ist zu erwähnen, dass ein FHEM Modul erst dann als dem SVN zugehörig angesehen wird, wenn es einen Eintrag in MAINTAINER.txt hat. Fehlt dieser Eintrag, dann wird das Modul nicht als FHEM Core Modul behandelt, sondern als externes 3rd-party Modul.		Hierbei ist zu erwähnen, dass ein FHEM Modul erst dann als dem SVN zugehörig angesehen wird, wenn es einen Eintrag in MAINTAINER.txt hat. Fehlt dieser Eintrag, dann wird das Modul nicht als FHEM Core Modul behandelt, sondern als externes 3rd-party Modul.

			== Links ==
			* Forenthema zu Meta.pm: {{Link2Forum\|Topic=97589\|LinkText=Meta.pm: Metadaten über FHEM Module}}

			[[Kategorie:Development]]

← Nächstältere Version		Version vom 12. November 2026, 11:51 Uhr
Zeile 3.440:		Zeile 3.440:
	;maxSoC:maximaler Mindest-SoC, d.h. der SoC Wert der mindestens im Abstand von 'careCycle' Tagen erreicht werden muß um den Ladungsausgleich im Speicherverbund auszuführen. Die Angabe ist optional (muß <= 100 sein, default: 95)		;maxSoC:maximaler Mindest-SoC, d.h. der SoC Wert der mindestens im Abstand von 'careCycle' Tagen erreicht werden muß um den Ladungsausgleich im Speicherverbund auszuführen. Die Angabe ist optional (muß <= 100 sein, default: 95)

	;stepSoC: Optionale Schrittweite zur optimalen SoC-Berechnung (~~Battery_OptimumTargetSoC_XX~~) in %. Mit der Angabe 'stepSoC=0' wird das SoC-Management deaktiviert und ~~Battery_OptimumTargetSoC_XX~~ auf den Wert 'lowSoC' gesetzt. '''Hinweis:''' Die Beziehung 'careCycle * stepSoC = 100' sollte eingehalten werden! Wert: 0..5, default: 5		;stepSoC: Optionale Schrittweite zur optimalen SoC-Berechnung (Battery_OptimumBaseSoC_XX) in %. Mit der Angabe 'stepSoC=0' wird das SoC-Management deaktiviert und Battery_OptimumBaseSoC_XX auf den Wert 'lowSoC' gesetzt. '''Hinweis:''' Die Beziehung 'careCycle * stepSoC = 100' sollte eingehalten werden! Wert: 0..5, default: 5

	;careCycle:maximaler Abstand in Tagen, der zwischen zwei Ladungszuständen von mindestens 'maxSoC' auftreten sollte. Anders formuliert legt careCycle fest, alle wieviel Tage mindestens einmal maxSoC erreicht werden sollte. Die Angabe ist optional. (default: 20)		;careCycle:maximaler Abstand in Tagen, der zwischen zwei Ladungszuständen von mindestens 'maxSoC' auftreten sollte. Anders formuliert legt careCycle fest, alle wieviel Tage mindestens einmal maxSoC erreicht werden sollte. Die Angabe ist optional. (default: 20)
Zeile 3.450:		Zeile 3.450:
	;loadStrategy: Abhängig von der gewählten Ladestrategie wird die Prognose der Batterieladung und ggf. die Generierung der Steuerreadings beeinflusst. Die Angabe ist optional. Wert: loadRelease \| optPower \| smartPower, default=loadRelease		;loadStrategy: Abhängig von der gewählten Ladestrategie wird die Prognose der Batterieladung und ggf. die Generierung der Steuerreadings beeinflusst. Die Angabe ist optional. Wert: loadRelease \| optPower \| smartPower, default=loadRelease

	;loadTarget: Optionaler Ziel-SoC in % für die Berechnung der Ladefreigabe bzw. der optimalen Ladeleistung. Der Zielwert ist eine kalkulatorische Rechengröße. Der reale SoC kann situativ in Grenzen über- oder unterschritten werden. Der höhere Wert aus Reading ~~Battery_OptimumTargetSoC_XX~~ und 'loadTarget' hat für die Berechnung Vorrang. Wert: 0..100, default=100. <br> In loadTarget kann eine Zielzeit angegeben werden, wann der Ziel-SoC erreicht werden soll. Die optimale Ladeleistung wird entsprechend angepasst. Die Zeitangabe als positive Ganzzahl ist ein Absolutwert (Stunde), in der der Ziel-SoC erreicht sein soll. Ein negativer Integer (z.B. -3) besagt, dass drei Stunden vor dem [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Bestimmung_von_Sonnenaufgang_und_Sonnenuntergang\|Sonnenuntergang]] des aktuellen Tages der Ziel-SoC erreicht sein soll. D.h. negative Zahlen sind Relativangaben. Generell wird der Ziel-SoC zur Wunschzeit nur dann erreicht sein, wenn genügend PV-Leistung verfügbar ist.		;loadTarget: Optionaler Ziel-SoC in % für die Berechnung der Ladefreigabe bzw. der optimalen Ladeleistung. Der Zielwert ist eine kalkulatorische Rechengröße. Der reale SoC kann situativ in Grenzen über- oder unterschritten werden. Der höhere Wert aus Reading Battery_OptimumBaseSoC_XX und 'loadTarget' hat für die Berechnung Vorrang. Wert: 0..100, default=100. <br> In loadTarget kann eine Zielzeit angegeben werden, wann der Ziel-SoC erreicht werden soll. Die optimale Ladeleistung wird entsprechend angepasst. Die Zeitangabe als positive Ganzzahl ist ein Absolutwert (Stunde), in der der Ziel-SoC erreicht sein soll. Ein negativer Integer (z.B. -3) besagt, dass drei Stunden vor dem [[SolarForecast_-_Solare_Prognose_(PV_Erzeugung)_und_Verbrauchersteuerung#Bestimmung_von_Sonnenaufgang_und_Sonnenuntergang\|Sonnenuntergang]] des aktuellen Tages der Ziel-SoC erreicht sein soll. D.h. negative Zahlen sind Relativangaben. Generell wird der Ziel-SoC zur Wunschzeit nur dann erreicht sein, wenn genügend PV-Leistung verfügbar ist.

	;safetyMargin: Bei der Berechnung der Ladefreigabe und optimierten Ladeleistung werden Sicherheitszuschläge auf den prognostizierten Ladungsbedarf berücksichtigt. Abweichend vom Default können mit diesem Parameter individuelle Sicherheitszuschläge getrennt für die Berechnung der Ladefreigabe und optimierten Ladeleistung angegeben werden. Der erste Wert ist der Zuschlag bei der Berechnung der Ladefreigabe, der zweite Wert der Zuschlag bei der Berechnung der optimierten Ladeleistung. Beide Angaben sind Prozentwerte von 0..100.		;safetyMargin: Bei der Berechnung der Ladefreigabe und optimierten Ladeleistung werden Sicherheitszuschläge auf den prognostizierten Ladungsbedarf berücksichtigt. Abweichend vom Default können mit diesem Parameter individuelle Sicherheitszuschläge getrennt für die Berechnung der Ladefreigabe und optimierten Ladeleistung angegeben werden. Der erste Wert ist der Zuschlag bei der Berechnung der Ladefreigabe, der zweite Wert der Zuschlag bei der Berechnung der optimierten Ladeleistung. Beide Angaben sind Prozentwerte von 0..100.
Zeile 3.474:		Zeile 3.474:


	;~~Battery_OptimumTargetSoC_XX~~: Mit den im Attribut ''ctrlBatSocManagementXX'' hinterlegten Parametern unter Berücksichtigung von PV- und Verbrauchsprognosen wird ein optimaler SOC-Wert errechnet. Dieser Wert dient zur Einstellung des unteren SOC des Batteriesystems.		;Battery_OptimumBaseSoC_XX: Mit den im Attribut ''ctrlBatSocManagementXX'' hinterlegten Parametern unter Berücksichtigung von PV- und Verbrauchsprognosen wird ein optimaler SOC-Wert errechnet. Dieser Wert dient zur Einstellung des unteren SOC des Batteriesystems.

	;Battery_ChargeRequest_XX: Dieses Reading signalisiert mit 1 eine Anforderung zur Zwangsladung der Batterie um die Batterie vor Schäden zu schützen (wenn der SOC unter ctrlBatSocManagementXX->lowSoc gefallen ist) oder wenn der aktuelle SOC unter den berechneten Mindest-SOC gefallen ist.		;Battery_ChargeRequest_XX: Dieses Reading signalisiert mit 1 eine Anforderung zur Zwangsladung der Batterie um die Batterie vor Schäden zu schützen (wenn der SOC unter ctrlBatSocManagementXX->lowSoc gefallen ist) oder wenn der aktuelle SOC unter den berechneten Mindest-SOC gefallen ist.
Zeile 3.500:		Zeile 3.500:


	::* das Reading '''~~Battery_OptimumTargetSoC_XX~~''' enthält den vom Modul berechneten optimalen SoC.		::* das Reading '''Battery_OptimumBaseSoC_XX''' enthält den vom Modul berechneten optimalen SoC.

	::* das Reading '''Battery_ChargeRequest_XX''' wird auf '1' gesetzt, wenn der aktuelle SoC unter den optimalen SoC gefallen ist. In diesem Fall sollte die Batterie, unter Umständen mit Netzstrom, zwangsgeladen werden.		::* das Reading '''Battery_ChargeRequest_XX''' wird auf '1' gesetzt, wenn der aktuelle SoC unter den optimalen SoC gefallen ist. In diesem Fall sollte die Batterie, unter Umständen mit Netzstrom, zwangsgeladen werden.
Zeile 3.519:		Zeile 3.519:


	Bei sehr wenig Erzeugungungsprognose, d.h. wenn sich der berechnete Min-SoC oberhalb von 'upSoC' bewegt, wird 'upSoC' eingestellt. Liegt der berechnete Min-SoC unterhalb von 'upSoC', ist jedoch größer als 'lowSoC', wird der berechnete SOC im Reading '''~~Battery_OptimumTargetSoC_XX~~''' eingestellt. Somit eignet sich die Angabe im Schlüssel 'upSoC' um in Zeiten geringer Solarenergieerzeugung die Batterie für eine Notstromerzeugung auf mindestens diesem Wert zu halten. Sollte die PV-Prognose kurzfristig einen größeren Ertrag vorhersagen als die Batterie durch die Einhaltung von 'upSoC' aufnehmen kann, wird der Min-SoC unter 'upSoC' abgesenkt um möglichst allen PV-Überschuß in der Batterie zu speichern und somit dem Eigenverbrauch zuzuführen.		Bei sehr wenig Erzeugungungsprognose, d.h. wenn sich der berechnete Min-SoC oberhalb von 'upSoC' bewegt, wird 'upSoC' eingestellt. Liegt der berechnete Min-SoC unterhalb von 'upSoC', ist jedoch größer als 'lowSoC', wird der berechnete SOC im Reading '''Battery_OptimumBaseSoC_XX''' eingestellt. Somit eignet sich die Angabe im Schlüssel 'upSoC' um in Zeiten geringer Solarenergieerzeugung die Batterie für eine Notstromerzeugung auf mindestens diesem Wert zu halten. Sollte die PV-Prognose kurzfristig einen größeren Ertrag vorhersagen als die Batterie durch die Einhaltung von 'upSoC' aufnehmen kann, wird der Min-SoC unter 'upSoC' abgesenkt um möglichst allen PV-Überschuß in der Batterie zu speichern und somit dem Eigenverbrauch zuzuführen.


	Der berechnete Mindest-SoC ist immer nur ein unterer Grenzwert. Die Batterie kann durch Ladevorgänge natürlich jederzeit einen höheren als den im Reading '''~~Battery_OptimumTargetSoC_XX~~''' dargestellten optimalen SoC haben. Der optimale SoC sollte nicht unterschritten werden um die oben genannten Zusammenhänge abbilden zu können.		Der berechnete Mindest-SoC ist immer nur ein unterer Grenzwert. Die Batterie kann durch Ladevorgänge natürlich jederzeit einen höheren als den im Reading '''Battery_OptimumBaseSoC_XX''' dargestellten optimalen SoC haben. Der optimale SoC sollte nicht unterschritten werden um die oben genannten Zusammenhänge abbilden zu können.


	🎯 '''Kurzfazit: Was beschreibt ~~Battery_OptimumTargetSoC_XX~~?''' <br>		🎯 '''Kurzfazit: Was beschreibt Battery_OptimumBaseSoC_XX?''' <br>

	~~Battery_OptimumTargetSoC_XX~~ definiert den optimalen Ziel‑SoC, den die Batterie erreichen bzw. nicht unterschreiten sollte, um prognostizierte PV‑Überschüsse aufzunehmen, ausreichende Energiereserven bereitzuhalten und die erforderlichen Pflegezyklen sicherzustellen. Der Wert bezieht sich dabei nicht auf die physikalischen Eigenschaften der Batteriezellen, sondern ergibt sich ausschließlich aus den Steuerungszielen des Moduls – basierend auf den eingestellten Parametern und den prognostizierten Umweltfaktoren.		Battery_OptimumBaseSoC_XX definiert den optimalen Ziel‑SoC, den die Batterie erreichen bzw. nicht unterschreiten sollte, um prognostizierte PV‑Überschüsse aufzunehmen, ausreichende Energiereserven bereitzuhalten und die erforderlichen Pflegezyklen sicherzustellen. Der Wert bezieht sich dabei nicht auf die physikalischen Eigenschaften der Batteriezellen, sondern ergibt sich ausschließlich aus den Steuerungszielen des Moduls – basierend auf den eingestellten Parametern und den prognostizierten Umweltfaktoren.


Zeile 3.549:		Zeile 3.549:
	Dabei steht 'XX' für die Nummer der Batterie, welche mit dem Attribut setupBatteryDevXX korrespondiert.		Dabei steht 'XX' für die Nummer der Batterie, welche mit dem Attribut setupBatteryDevXX korrespondiert.
	Ist dieses Attribut gesetzt, werden Steuerungs-Readings erstellt, die der Nutzer auswerten und seine Batterieanlage z.B. via notify oder DOIF steuern kann. <bR>		Ist dieses Attribut gesetzt, werden Steuerungs-Readings erstellt, die der Nutzer auswerten und seine Batterieanlage z.B. via notify oder DOIF steuern kann. <bR>
	Das Reading '''~~Battery_OptimumTargetSoC_XX~~''' enthält den vom Modul berechneten optimalen Mindest-SoC.		Das Reading '''Battery_OptimumBaseSoC_XX''' enthält den vom Modul berechneten optimalen Mindest-SoC.
	Das Reading '''Battery_ChargeRequest_XX''' wird auf '1' gesetzt, wenn der aktuelle SOC unter den optimalen SOC bzw. minimalen SOC gefallen ist.		Das Reading '''Battery_ChargeRequest_XX''' wird auf '1' gesetzt, wenn der aktuelle SOC unter den optimalen SOC bzw. minimalen SOC gefallen ist.

Zeile 3.565:		Zeile 3.565:
	===== Umsetzungsbeispiel =====		===== Umsetzungsbeispiel =====

	Wie das Reading '''~~Battery_OptimumTargetSoC_XX~~''' genutzt werden kann, wird am Beispiel einer Victron Batterieanlage gezeigt. Die Anlage wird durch Cerbo GX Gerät gesteuert. Der Cerbo GX ist per MQTT2 in FHEM eingebunden. Umgesetzt ist die Steuerung der Batterie '01', d.h. die Angabe 'XX' ist durch '01' ersetzt.		Wie das Reading '''Battery_OptimumBaseSoC_XX''' genutzt werden kann, wird am Beispiel einer Victron Batterieanlage gezeigt. Die Anlage wird durch Cerbo GX Gerät gesteuert. Der Cerbo GX ist per MQTT2 in FHEM eingebunden. Umgesetzt ist die Steuerung der Batterie '01', d.h. die Angabe 'XX' ist durch '01' ersetzt.

	Die folgende kleine Logik ist in einem '''99_mySolarForecastUtils.pm''' File eingebaut und wird regelmäßig mit		Die folgende kleine Logik ist in einem '''99_mySolarForecastUtils.pm''' File eingebaut und wird regelmäßig mit