(FHEM) FTUI 3

2026-04-15T16:37:24Z

Chris T. Ludwig: /* Formatierung/Layout */

(FHEM) FTUI 3

2026-04-15T15:47:04Z

Chris T. Ludwig: /* Beispiele */

(FHEM) FTUI 3

2026-04-15T09:29:31Z

Chris T. Ludwig: /* Beispiele */

(FHEM) 00 MQTT2 CLIENT.pm

2026-04-14T16:59:11Z

Chris T. Ludwig: /* Fehler 2 */

[[(FHEM) MQTT#Module im Detail| [Zurueck Uebersicht]]]

Uebersetzung aus dem FHEM WIKI

MQTT2_CLIENT ist eine Reinraumimplementierung eines MQTT-Clients (der eine Verbindung zu einem externen Server wie mosquitto herstellt) ohne Perl-Bibliotheken. Es dient als IODev für MQTT2_DEVICES.

Was auch immer eine Reinraumimplementierung sein soll. Ich vermute es ist damit gemeint, dass die Programmierung "auszerhalb" des FHEM-Frameworks arbeitet.

=Steckbrief=
{| class="wikitable"
|-
|'''Define'''||define <name> MQTT2_CLIENT <host>:<port>||
|-
|rowspan="4"|'''Set'''||publish [-r] topic value|| Verschickt eine Nachricht an den Topic; -r setzt das retain Flag
|-
|password <password> value|| Setzt das Passwort, welches in FHEM/FhemUtils/uniqueID gespeicher ist. Wenn kein <passwort> uebergeben wird, wird das Passwort geloescht.
|-
|connect||Dient zum manuellen Verbinden an den Broker.
|-
|disconnect||Dient zum manuellen Unterbrechen der Verbindung zum Broker.
|-
|'''Get'''|| 
|-
|'''Readings'''|| 
|-
|rowspan="21"|'''Attributes'''||"autocreate [no|simple|complex]"||siehe Erlaeuterung
|-
|binaryTopicRegexp <regular-expression>||
|-
|ignoreRegexp||
|-
|clientId <name>||setzt die ClientId
|-
|clientOrder [MQTT2_DEVICE] [MQTT_GENERIC_BRIDGE]||
|-
|connectTimeout <seconds>||
|-
|disable||
|-
|disabledForIntervals||
|-
|disconnectAfter <seconds>||
|-
|keepaliveTimeout <seconds;>||
|-
|lwt||
|-
|lwtRetain||
|-
|mqttVersion 3.1,3.1.1||
|-
|msgAfterConnect [-r] topic message||
|-
|msgBeforeDisconnect [-r] topic message||
|-
|qosMaxQueueLength <number>||
|-
|rawEvents <topic-regexp>||
|-
|subscriptions <subscriptions>||
|-
|SSL||
|-
|sslargs||
|-
|username <username>||
|}

=Erlaeuterungen=
Es wird nur QoS 0 und 1 unterstuetzt.

Saetze evtl. zum Einbauen.
Ich nutze ebenfalls MQTT_GENERIC_BRIDGE zum "Weiterbefördern" relevanter Informationen von den Nebensystemen zum Hauptsystem.

Das Trennen der vom Nebensystem angelieferten Informationen übernimmt dabei das Attribut bridgeRegexp eines allgemeinen MQTT2_DEVICEs auf dem Hauptsystem.

=Usererror 1=
Was bei mir gefehlt hat war die "base" Definition sowie eine Bridge mit dem entsprechenden Filter

bridgeRegexp \
SmartHome/MqttGenericBridge2/([A-Za-z0-9]*)/.*:.* "mgb2_$1"\

Das Autocreate hat nach den Anpassungen dann auch funktioniert. Die letzte Herausforderung ist nun, dass ich auf dem Slavesystem Namen mit einem Underscore habe und diese abgeschnitten werden. Experimente mit der RegEx Definition hatten bisher noch keinen Erfolg.

Da dieser Matchingparameter [([A-Za-z0-9]*)] bei den Underscores aufhört bei der Deviceerstellung, habe ich eine Wildcard [.*] genutz... ist aber nicht effektiv, da alle Radings in einem Device landen

([A-Za-z0-9]...*) [https://forum.fhem.de/index.php?topic=107145.0 weitere Varianten]

hat das Problem mit den _ in den Devicenamen gelöst.

([^/]+)

https://forum.fhem.de/index.php?topic=98206.0

=Usererror 2=
Ich falsch davon ausgegangen, dass die Port-Angabe entfallen kann wenn sie Standard (1883) ist.

defmod MQTT_CLX_FHEMClient MQTT2_CLIENT 192.168.178.10:1883

Defmod mit Port-Angabe hat dann auch direkt ein Publish zugelassen.

(FHEM) 00 MQTT2 CLIENT.pm

2026-04-14T16:58:59Z

Chris T. Ludwig: /* Fehler 1 */

[[(FHEM) MQTT#Module im Detail| [Zurueck Uebersicht]]]

Uebersetzung aus dem FHEM WIKI

MQTT2_CLIENT ist eine Reinraumimplementierung eines MQTT-Clients (der eine Verbindung zu einem externen Server wie mosquitto herstellt) ohne Perl-Bibliotheken. Es dient als IODev für MQTT2_DEVICES.

Was auch immer eine Reinraumimplementierung sein soll. Ich vermute es ist damit gemeint, dass die Programmierung "auszerhalb" des FHEM-Frameworks arbeitet.

=Steckbrief=
{| class="wikitable"
|-
|'''Define'''||define <name> MQTT2_CLIENT <host>:<port>||
|-
|rowspan="4"|'''Set'''||publish [-r] topic value|| Verschickt eine Nachricht an den Topic; -r setzt das retain Flag
|-
|password <password> value|| Setzt das Passwort, welches in FHEM/FhemUtils/uniqueID gespeicher ist. Wenn kein <passwort> uebergeben wird, wird das Passwort geloescht.
|-
|connect||Dient zum manuellen Verbinden an den Broker.
|-
|disconnect||Dient zum manuellen Unterbrechen der Verbindung zum Broker.
|-
|'''Get'''|| 
|-
|'''Readings'''|| 
|-
|rowspan="21"|'''Attributes'''||"autocreate [no|simple|complex]"||siehe Erlaeuterung
|-
|binaryTopicRegexp <regular-expression>||
|-
|ignoreRegexp||
|-
|clientId <name>||setzt die ClientId
|-
|clientOrder [MQTT2_DEVICE] [MQTT_GENERIC_BRIDGE]||
|-
|connectTimeout <seconds>||
|-
|disable||
|-
|disabledForIntervals||
|-
|disconnectAfter <seconds>||
|-
|keepaliveTimeout <seconds;>||
|-
|lwt||
|-
|lwtRetain||
|-
|mqttVersion 3.1,3.1.1||
|-
|msgAfterConnect [-r] topic message||
|-
|msgBeforeDisconnect [-r] topic message||
|-
|qosMaxQueueLength <number>||
|-
|rawEvents <topic-regexp>||
|-
|subscriptions <subscriptions>||
|-
|SSL||
|-
|sslargs||
|-
|username <username>||
|}

=Erlaeuterungen=
Es wird nur QoS 0 und 1 unterstuetzt.

Saetze evtl. zum Einbauen.
Ich nutze ebenfalls MQTT_GENERIC_BRIDGE zum "Weiterbefördern" relevanter Informationen von den Nebensystemen zum Hauptsystem.

Das Trennen der vom Nebensystem angelieferten Informationen übernimmt dabei das Attribut bridgeRegexp eines allgemeinen MQTT2_DEVICEs auf dem Hauptsystem.

=Usererror 1=
Was bei mir gefehlt hat war die "base" Definition sowie eine Bridge mit dem entsprechenden Filter

bridgeRegexp \
SmartHome/MqttGenericBridge2/([A-Za-z0-9]*)/.*:.* "mgb2_$1"\

Das Autocreate hat nach den Anpassungen dann auch funktioniert. Die letzte Herausforderung ist nun, dass ich auf dem Slavesystem Namen mit einem Underscore habe und diese abgeschnitten werden. Experimente mit der RegEx Definition hatten bisher noch keinen Erfolg.

Da dieser Matchingparameter [([A-Za-z0-9]*)] bei den Underscores aufhört bei der Deviceerstellung, habe ich eine Wildcard [.*] genutz... ist aber nicht effektiv, da alle Radings in einem Device landen

([A-Za-z0-9]...*) [https://forum.fhem.de/index.php?topic=107145.0 weitere Varianten]

hat das Problem mit den _ in den Devicenamen gelöst.

([^/]+)

https://forum.fhem.de/index.php?topic=98206.0

=Fehler 2=
Ich falsch davon ausgegangen, dass die Port-Angabe entfallen kann wenn sie Standard (1883) ist.

defmod MQTT_CLX_FHEMClient MQTT2_CLIENT 192.168.178.10:1883

Defmod mit Port-Angabe hat dann auch direkt ein Publish zugelassen.

(FHEM) 00 MQTT2 CLIENT.pm

2026-04-14T16:58:19Z

Chris T. Ludwig:

[[(FHEM) MQTT#Module im Detail| [Zurueck Uebersicht]]]

Uebersetzung aus dem FHEM WIKI

MQTT2_CLIENT ist eine Reinraumimplementierung eines MQTT-Clients (der eine Verbindung zu einem externen Server wie mosquitto herstellt) ohne Perl-Bibliotheken. Es dient als IODev für MQTT2_DEVICES.

Was auch immer eine Reinraumimplementierung sein soll. Ich vermute es ist damit gemeint, dass die Programmierung "auszerhalb" des FHEM-Frameworks arbeitet.

=Steckbrief=
{| class="wikitable"
|-
|'''Define'''||define <name> MQTT2_CLIENT <host>:<port>||
|-
|rowspan="4"|'''Set'''||publish [-r] topic value|| Verschickt eine Nachricht an den Topic; -r setzt das retain Flag
|-
|password <password> value|| Setzt das Passwort, welches in FHEM/FhemUtils/uniqueID gespeicher ist. Wenn kein <passwort> uebergeben wird, wird das Passwort geloescht.
|-
|connect||Dient zum manuellen Verbinden an den Broker.
|-
|disconnect||Dient zum manuellen Unterbrechen der Verbindung zum Broker.
|-
|'''Get'''|| 
|-
|'''Readings'''|| 
|-
|rowspan="21"|'''Attributes'''||"autocreate [no|simple|complex]"||siehe Erlaeuterung
|-
|binaryTopicRegexp <regular-expression>||
|-
|ignoreRegexp||
|-
|clientId <name>||setzt die ClientId
|-
|clientOrder [MQTT2_DEVICE] [MQTT_GENERIC_BRIDGE]||
|-
|connectTimeout <seconds>||
|-
|disable||
|-
|disabledForIntervals||
|-
|disconnectAfter <seconds>||
|-
|keepaliveTimeout <seconds;>||
|-
|lwt||
|-
|lwtRetain||
|-
|mqttVersion 3.1,3.1.1||
|-
|msgAfterConnect [-r] topic message||
|-
|msgBeforeDisconnect [-r] topic message||
|-
|qosMaxQueueLength <number>||
|-
|rawEvents <topic-regexp>||
|-
|subscriptions <subscriptions>||
|-
|SSL||
|-
|sslargs||
|-
|username <username>||
|}

=Erlaeuterungen=
Es wird nur QoS 0 und 1 unterstuetzt.

Saetze evtl. zum Einbauen.
Ich nutze ebenfalls MQTT_GENERIC_BRIDGE zum "Weiterbefördern" relevanter Informationen von den Nebensystemen zum Hauptsystem.

Das Trennen der vom Nebensystem angelieferten Informationen übernimmt dabei das Attribut bridgeRegexp eines allgemeinen MQTT2_DEVICEs auf dem Hauptsystem.

=Fehler 1=
Was bei mir gefehlt hat war die "base" Definition sowie eine Bridge mit dem entsprechenden Filter

bridgeRegexp \
SmartHome/MqttGenericBridge2/([A-Za-z0-9]*)/.*:.* "mgb2_$1"\

Das Autocreate hat nach den Anpassungen dann auch funktioniert. Die letzte Herausforderung ist nun, dass ich auf dem Slavesystem Namen mit einem Underscore habe und diese abgeschnitten werden. Experimente mit der RegEx Definition hatten bisher noch keinen Erfolg.

Da dieser Matchingparameter [([A-Za-z0-9]*)] bei den Underscores aufhört bei der Deviceerstellung, habe ich eine Wildcard [.*] genutz... ist aber nicht effektiv, da alle Radings in einem Device landen

([A-Za-z0-9]...*) [https://forum.fhem.de/index.php?topic=107145.0 weitere Varianten]

hat das Problem mit den _ in den Devicenamen gelöst.

([^/]+)

https://forum.fhem.de/index.php?topic=98206.0

=Fehler 2=
Ich falsch davon ausgegangen, dass die Port-Angabe entfallen kann wenn sie Standard (1883) ist.

defmod MQTT_CLX_FHEMClient MQTT2_CLIENT 192.168.178.10:1883

Defmod mit Port-Angabe hat dann auch direkt ein Publish zugelassen.

(FHEM) FTUI 3

2026-04-14T13:32:51Z

Chris T. Ludwig: /* Allgemeines */

Windows-Surface als Smarthome-Display

2026-04-14T08:11:44Z

Chris T. Ludwig: /* Allgemeines */

=Allgemeines=
Die beiden [https://en.wikipedia.org/wiki/Surface_(2012_tablet) WindowsRT Surface Displays] waren einfach zu schade, um Sie nur rumliegen zu haben.

Die Hauptseite ist [https://tippvomtibb.de/wiki/index.php?title=Windows_Surface_RT hier]

Ziele die ich verfolge.

* Autostart Browser Fullscreen auf FHEM Startseite
* periodisches An-/und Abschalten der Spannungsversorgung (Akku zwischen 60-80% halten)
* Virtuelle Tastatur bei Windows-Button Betaetigung
* Watchdog/Keepalive WLAN
* Timeout: automatische Rueckkehr zum Startbildschirm
...

=WLAN Problem=
[ 9.704201] mwifiex_sdio mmc2:0001:1: info: FW download over, size 533976 bytes
[ 9.945765] mwifiex_sdio mmc2:0001:1: WLAN FW is active
[ 10.210971] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x242 error, result=0x2
[ 10.211047] mwifiex_sdio mmc2:0001:1: mwifiex_process_cmdresp: cmd 0x242 failed during initialization
[ 10.535490] mwifiex_sdio mmc2:0001:1: info: MWIFIEX VERSION: mwifiex 1.0 (14.68.29.p59)
[ 10.535524] mwifiex_sdio mmc2:0001:1: driver_version = mwifiex 1.0 (14.68.29.p59)
[ 17.295906] mwifiex_sdio mmc2:0001:1: info: trying to associate to bssid 24:5a:4c:22:8a:8f
[ 17.324014] mwifiex_sdio mmc2:0001:1: info: associated to bssid 24:5a:4c:22:8a:8f successfully
[ 17.354089] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x23f error, result=0x2

Das Problem ist [https://github.com/jakeday/linux-surface/issues/420 hier] und [https://wiki.postmarketos.org/wiki/Microsoft_Surface_RT_(microsoft-surface-rt) hier]geloest.

Das Modul mwifiex_sdio muss noch mit modprobe geladen werden.

sudo modprobe mwifiex_sdio

Nicht wundern, es ist scheinbar standardmaeszig kein Modul geladen.
<pre>
Module Size Used by
mwifiex_sdio 28672 0
mwifiex 237568 1 mwifiex_sdio
</pre>
Sobald das Modul geladen ist kann man das WLAN benutzen.

=Feste IP=
Ab Bookworm wird nicht mehr etc/dhcp.conf zu hinterlegen genommen, sondern jetzt dient dazu der NetworkManager fuer die Aufgaben rund ums Netzwerk.

sudo systemctl restart NetworkManager

=WLAN/LAN Management=

nmcli device wifi list

nmcli device show

nmcli connection show

=Surfstick=
Ich benutzederzeit keinen Surfstick in den Displays.

sudo systemctl disable --now ModemManager

=Reboot=
Ein Reboot funktioniert nicht wirklich, da kein ACPI, kein BIOS sondern ueber die Firmware des SoC Tegra3.

Das Surface faehrt zwar runter bleibt aber beim Poweroff haengen.

Wenn keine Bildschirmanzeige da ist, die auf das Warten auf den Powerknopf hinweist, dann gibt das Beruehren des Windowsknopfes ein Vibrationssignal von sich.

Derzeit kenne ich nur die Loesung 5 Sekunden Powerknopf festhalten und wieder kurz druecken.

=Autostart=
Mist. Nach dem Wechsel auf Labwc (Wayland) geht mein Autostart nicht mehr.

echo $XDG_SESSION_TYPE

Mit

sudo raspi-config

erhaelt man unter Punkt 6 eine Umschaltmoeglichkeit.

X11 Openbox window manager with X11 backend
Wayfire Wayfire window manager with Wayland backend
Labwc Labwc window manager with Wayland backend

<pre>
mkdir -p ~/.config/labwc
nano ~/.config/labwc/autostart
</pre>

=Windows-Taste=
Um die Windowstaste (Super_L) anzupassen, aendert man einfach nur den Eintrag <command> in /etc/xdg/openbox/lxde-pi-rc.xml.
[https://forums.raspberrypi.com/viewtopic.php?t=209261]

Standrardmaeszig steht dort 'lxpanelctl menu', was aber nur das Startmenu oeffnet. Ich moechte aber, dass bei jeder Button-Aktivitaet das Panel sichtbar und wieder unsichtbar wird.

Das Startmenu bekomme ich dann ja durch Klicken auf die Himbeere.

In Raspbian 12 Bookworm laeuft das lxpanel mit dem Profil LXDE-pi.

Die passende panel-Config-Datei befindet sich in .config/lxpanel/LXDE-pi/panels/.

In der Panel-Datei muss man also den Eintrag autohide zwischen 0 und 1 wechseln und lxpanelctl restart ausfuehren.

Also die Idee ist wie folgt.

An den Super_L wird ein Bash-Script gebunden, welches den autohide Eintrag toggelt und das Panel neu startet.

Das Toggeln uebernimmt sed.
sed -i 's/^autohide=1$/autohide=0/' .config/lxpanel/LXDE-pi/panels/panel

Ich habe mal meine Testzeilen dringelassen.

<syntaxhighlight lang="bash" line>
#!/bin/bash
configfile="/home/chris/.config/lxpanel/LXDE-pi/panels/panel"
sed="/usr/bin/sed"

$sed -i 's/^autohide=1$/autohide=0/;ta;q1;:a' $configfile
retval="$?"
#echo "1->0 $retval"
#if [ $retval -ne 1 ]; then
# echo "exit"
# exit 0
#fi
[ $retval -ne 1 ] && exit
$sed -i 's/^autohide=0$/autohide=1/;ta;q2;:a' $configfile
#retval="$?"
#echo "0->1 $retval"
</syntaxhighlight>

==DTB Datei==

DTB = Device Tree Binary

In dieser Datei ist die Hardwarestruktur des PI o.ä. codiert. Diese Datei ist binaer und somit nicht einfach lesbar. Hierzu schreibt Jeff Geerling:

How to customize the dtb (device tree binary) on the Raspberry Pi
November 17, 2023

Every so often, when you're debugging weird hardware issues on SBCs like the Raspberry Pi, it's useful to get way down into the guts of how the Pi represents its hardware to Linux.

And the Linux kernel uses a method called Device Tree overlays to do it. On the Pi 5 (and other Pis), these overlays are stored as .dtb files inside the /boot/firmware directory, and there's an overlay for every major Raspberry Pi hardware model.

I've had to modify the dtb files in the past to increase the PCIe BAR space for early GPU testing on the Compute Module 4. And recently I've had to mess with how the PCIe address space is set up for testing certain devices on the Raspberry Pi 5.

The problem is, you can't just hand-edit a .dtb file—they're in a format readable only by the Linux kernel. You have to decompile the .dtb file to a .dts (source) file, edit it, then recompile it to a .dtb.

As an example, I needed to change the msi-parent for the Pi 5's external PCIe connector to allow for full MSI-X support for a Google Coral TPU (work on getting it to work is ongoing):

# Back up the current dtb
sudo cp /boot/firmware/bcm2712-rpi-5-b.dtb /boot/firmware/bcm2712-rpi-5-b.dtb.bak

# Decompile the current dtb (ignore warnings)
dtc -I dtb -O dts /boot/firmware/bcm2712-rpi-5-b.dtb -o ~/test.dts

# Edit the file
nano ~/test.dts

# Change the line: msi-parent = <0x2f>; (under `pcie@110000`)
# To: msi-parent = <0x66>;
# Then save the file.

# Recompile the dtb and move it back to the firmware directory
dtc -I dts -O dtb ~/test.dts -o ~/test.dtb
sudo mv ~/test.dtb /boot/firmware/bcm2712-rpi-5-b.dtb

Check out elinux's Device Tree Reference for more useful background info.

I consider myself an absolute noob at Device Trees in Linux... but I've now done this enough times that I'd like a simple reference and most of the ones out there assume you are an expert-level wizard in all things Linux/hardware!

=Virtuelle Tastatur=
Manchmal muss man halt doch was am Display eingeben. Das 'matchbox-keyboard' hat mir nicht gefallen.

Das sqeekboard kommt meinen Vorstellungen schon recht nahe.

Fehlermeldungen beim Start aus der Konsole:
<pre>
Info: Loaded layout Path: "/usr/share/misc/squeekboard/keyboards/de_wide.yaml"
Info: Loaded layout Path: "/usr/share/misc/squeekboard/keyboards/de_wide.yaml"
Debug: Tried file "/usr/share/misc/squeekboard/keyboards/terminal/de_wide.yaml", but it's missing: Datei oder Verzeichnis nicht gefunden (os error 2)
Warning: Failed to load layout from Resource: terminal/de_wide: Missing resource, skipping
Debug: Tried file "/usr/share/misc/squeekboard/keyboards/terminal/de.yaml", but it's missing: Datei oder Verzeichnis nicht gefunden (os error 2)
Warning: Failed to load layout from Resource: terminal/de: Missing resource, skipping
Info: Loaded layout Path: "/usr/share/misc/squeekboard/keyboards/terminal/us_wide.yaml"
</pre>

Windows-Surface als Smarthome-Display

2026-04-14T08:08:15Z

Chris T. Ludwig: /* DTB Datei */

=Allgemeines=
Die beiden [https://en.wikipedia.org/wiki/Surface_(2012_tablet) WindowsRT Surface Displays] waren einfach zu schade, um Sie nur rumliegen zu haben.

Die Hauptseite ist [https://tippvomtibb.de/wiki/index.php?title=Windows_Surface_RT hier]

Ziele die ich verfolge.

- Autostart Browser Fullscreen auf FHEM Startseite
- periodisches An-/und Abschalten der Spannungsversorgung (Akku zwischen 60-80% halten)
- Virtuelle Tastatur bei Windows-Button Betaetigung
- Watchdog/Keepalive WLAN
...

=WLAN Problem=
[ 9.704201] mwifiex_sdio mmc2:0001:1: info: FW download over, size 533976 bytes
[ 9.945765] mwifiex_sdio mmc2:0001:1: WLAN FW is active
[ 10.210971] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x242 error, result=0x2
[ 10.211047] mwifiex_sdio mmc2:0001:1: mwifiex_process_cmdresp: cmd 0x242 failed during initialization
[ 10.535490] mwifiex_sdio mmc2:0001:1: info: MWIFIEX VERSION: mwifiex 1.0 (14.68.29.p59)
[ 10.535524] mwifiex_sdio mmc2:0001:1: driver_version = mwifiex 1.0 (14.68.29.p59)
[ 17.295906] mwifiex_sdio mmc2:0001:1: info: trying to associate to bssid 24:5a:4c:22:8a:8f
[ 17.324014] mwifiex_sdio mmc2:0001:1: info: associated to bssid 24:5a:4c:22:8a:8f successfully
[ 17.354089] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x23f error, result=0x2

Das Problem ist [https://github.com/jakeday/linux-surface/issues/420 hier] und [https://wiki.postmarketos.org/wiki/Microsoft_Surface_RT_(microsoft-surface-rt) hier]geloest.

Das Modul mwifiex_sdio muss noch mit modprobe geladen werden.

sudo modprobe mwifiex_sdio

Nicht wundern, es ist scheinbar standardmaeszig kein Modul geladen.
<pre>
Module Size Used by
mwifiex_sdio 28672 0
mwifiex 237568 1 mwifiex_sdio
</pre>
Sobald das Modul geladen ist kann man das WLAN benutzen.

=Feste IP=
Ab Bookworm wird nicht mehr etc/dhcp.conf zu hinterlegen genommen, sondern jetzt dient dazu der NetworkManager fuer die Aufgaben rund ums Netzwerk.

sudo systemctl restart NetworkManager

=WLAN/LAN Management=

nmcli device wifi list

nmcli device show

nmcli connection show

=Surfstick=
Ich benutzederzeit keinen Surfstick in den Displays.

sudo systemctl disable --now ModemManager

=Reboot=
Ein Reboot funktioniert nicht wirklich, da kein ACPI, kein BIOS sondern ueber die Firmware des SoC Tegra3.

Das Surface faehrt zwar runter bleibt aber beim Poweroff haengen.

Wenn keine Bildschirmanzeige da ist, die auf das Warten auf den Powerknopf hinweist, dann gibt das Beruehren des Windowsknopfes ein Vibrationssignal von sich.

Derzeit kenne ich nur die Loesung 5 Sekunden Powerknopf festhalten und wieder kurz druecken.

=Autostart=
Mist. Nach dem Wechsel auf Labwc (Wayland) geht mein Autostart nicht mehr.

echo $XDG_SESSION_TYPE

Mit

sudo raspi-config

erhaelt man unter Punkt 6 eine Umschaltmoeglichkeit.

X11 Openbox window manager with X11 backend
Wayfire Wayfire window manager with Wayland backend
Labwc Labwc window manager with Wayland backend

<pre>
mkdir -p ~/.config/labwc
nano ~/.config/labwc/autostart
</pre>

=Windows-Taste=
Um die Windowstaste (Super_L) anzupassen, aendert man einfach nur den Eintrag <command> in /etc/xdg/openbox/lxde-pi-rc.xml.
[https://forums.raspberrypi.com/viewtopic.php?t=209261]

Standrardmaeszig steht dort 'lxpanelctl menu', was aber nur das Startmenu oeffnet. Ich moechte aber, dass bei jeder Button-Aktivitaet das Panel sichtbar und wieder unsichtbar wird.

Das Startmenu bekomme ich dann ja durch Klicken auf die Himbeere.

In Raspbian 12 Bookworm laeuft das lxpanel mit dem Profil LXDE-pi.

Die passende panel-Config-Datei befindet sich in .config/lxpanel/LXDE-pi/panels/.

In der Panel-Datei muss man also den Eintrag autohide zwischen 0 und 1 wechseln und lxpanelctl restart ausfuehren.

Also die Idee ist wie folgt.

An den Super_L wird ein Bash-Script gebunden, welches den autohide Eintrag toggelt und das Panel neu startet.

Das Toggeln uebernimmt sed.
sed -i 's/^autohide=1$/autohide=0/' .config/lxpanel/LXDE-pi/panels/panel

Ich habe mal meine Testzeilen dringelassen.

<syntaxhighlight lang="bash" line>
#!/bin/bash
configfile="/home/chris/.config/lxpanel/LXDE-pi/panels/panel"
sed="/usr/bin/sed"

$sed -i 's/^autohide=1$/autohide=0/;ta;q1;:a' $configfile
retval="$?"
#echo "1->0 $retval"
#if [ $retval -ne 1 ]; then
# echo "exit"
# exit 0
#fi
[ $retval -ne 1 ] && exit
$sed -i 's/^autohide=0$/autohide=1/;ta;q2;:a' $configfile
#retval="$?"
#echo "0->1 $retval"
</syntaxhighlight>

==DTB Datei==

DTB = Device Tree Binary

In dieser Datei ist die Hardwarestruktur des PI o.ä. codiert. Diese Datei ist binaer und somit nicht einfach lesbar. Hierzu schreibt Jeff Geerling:

How to customize the dtb (device tree binary) on the Raspberry Pi
November 17, 2023

Every so often, when you're debugging weird hardware issues on SBCs like the Raspberry Pi, it's useful to get way down into the guts of how the Pi represents its hardware to Linux.

And the Linux kernel uses a method called Device Tree overlays to do it. On the Pi 5 (and other Pis), these overlays are stored as .dtb files inside the /boot/firmware directory, and there's an overlay for every major Raspberry Pi hardware model.

I've had to modify the dtb files in the past to increase the PCIe BAR space for early GPU testing on the Compute Module 4. And recently I've had to mess with how the PCIe address space is set up for testing certain devices on the Raspberry Pi 5.

The problem is, you can't just hand-edit a .dtb file—they're in a format readable only by the Linux kernel. You have to decompile the .dtb file to a .dts (source) file, edit it, then recompile it to a .dtb.

As an example, I needed to change the msi-parent for the Pi 5's external PCIe connector to allow for full MSI-X support for a Google Coral TPU (work on getting it to work is ongoing):

# Back up the current dtb
sudo cp /boot/firmware/bcm2712-rpi-5-b.dtb /boot/firmware/bcm2712-rpi-5-b.dtb.bak

# Decompile the current dtb (ignore warnings)
dtc -I dtb -O dts /boot/firmware/bcm2712-rpi-5-b.dtb -o ~/test.dts

# Edit the file
nano ~/test.dts

# Change the line: msi-parent = <0x2f>; (under `pcie@110000`)
# To: msi-parent = <0x66>;
# Then save the file.

# Recompile the dtb and move it back to the firmware directory
dtc -I dts -O dtb ~/test.dts -o ~/test.dtb
sudo mv ~/test.dtb /boot/firmware/bcm2712-rpi-5-b.dtb

Check out elinux's Device Tree Reference for more useful background info.

I consider myself an absolute noob at Device Trees in Linux... but I've now done this enough times that I'd like a simple reference and most of the ones out there assume you are an expert-level wizard in all things Linux/hardware!

=Virtuelle Tastatur=
Manchmal muss man halt doch was am Display eingeben. Das 'matchbox-keyboard' hat mir nicht gefallen.

Das sqeekboard kommt meinen Vorstellungen schon recht nahe.

Fehlermeldungen beim Start aus der Konsole:
<pre>
Info: Loaded layout Path: "/usr/share/misc/squeekboard/keyboards/de_wide.yaml"
Info: Loaded layout Path: "/usr/share/misc/squeekboard/keyboards/de_wide.yaml"
Debug: Tried file "/usr/share/misc/squeekboard/keyboards/terminal/de_wide.yaml", but it's missing: Datei oder Verzeichnis nicht gefunden (os error 2)
Warning: Failed to load layout from Resource: terminal/de_wide: Missing resource, skipping
Debug: Tried file "/usr/share/misc/squeekboard/keyboards/terminal/de.yaml", but it's missing: Datei oder Verzeichnis nicht gefunden (os error 2)
Warning: Failed to load layout from Resource: terminal/de: Missing resource, skipping
Info: Loaded layout Path: "/usr/share/misc/squeekboard/keyboards/terminal/us_wide.yaml"
</pre>

Windows-Surface als Smarthome-Display

2026-04-14T07:55:29Z

Chris T. Ludwig: /* Allgemeines */

=Allgemeines=
Die beiden [https://en.wikipedia.org/wiki/Surface_(2012_tablet) WindowsRT Surface Displays] waren einfach zu schade, um Sie nur rumliegen zu haben.

Die Hauptseite ist [https://tippvomtibb.de/wiki/index.php?title=Windows_Surface_RT hier]

Ziele die ich verfolge.

- Autostart Browser Fullscreen auf FHEM Startseite
- periodisches An-/und Abschalten der Spannungsversorgung (Akku zwischen 60-80% halten)
- Virtuelle Tastatur bei Windows-Button Betaetigung
- Watchdog/Keepalive WLAN
...

=WLAN Problem=
[ 9.704201] mwifiex_sdio mmc2:0001:1: info: FW download over, size 533976 bytes
[ 9.945765] mwifiex_sdio mmc2:0001:1: WLAN FW is active
[ 10.210971] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x242 error, result=0x2
[ 10.211047] mwifiex_sdio mmc2:0001:1: mwifiex_process_cmdresp: cmd 0x242 failed during initialization
[ 10.535490] mwifiex_sdio mmc2:0001:1: info: MWIFIEX VERSION: mwifiex 1.0 (14.68.29.p59)
[ 10.535524] mwifiex_sdio mmc2:0001:1: driver_version = mwifiex 1.0 (14.68.29.p59)
[ 17.295906] mwifiex_sdio mmc2:0001:1: info: trying to associate to bssid 24:5a:4c:22:8a:8f
[ 17.324014] mwifiex_sdio mmc2:0001:1: info: associated to bssid 24:5a:4c:22:8a:8f successfully
[ 17.354089] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x23f error, result=0x2

Das Problem ist [https://github.com/jakeday/linux-surface/issues/420 hier] und [https://wiki.postmarketos.org/wiki/Microsoft_Surface_RT_(microsoft-surface-rt) hier]geloest.

Das Modul mwifiex_sdio muss noch mit modprobe geladen werden.

sudo modprobe mwifiex_sdio

Nicht wundern, es ist scheinbar standardmaeszig kein Modul geladen.
<pre>
Module Size Used by
mwifiex_sdio 28672 0
mwifiex 237568 1 mwifiex_sdio
</pre>
Sobald das Modul geladen ist kann man das WLAN benutzen.

=Feste IP=
Ab Bookworm wird nicht mehr etc/dhcp.conf zu hinterlegen genommen, sondern jetzt dient dazu der NetworkManager fuer die Aufgaben rund ums Netzwerk.

sudo systemctl restart NetworkManager

=WLAN/LAN Management=

nmcli device wifi list

nmcli device show

nmcli connection show

=Surfstick=
Ich benutzederzeit keinen Surfstick in den Displays.

sudo systemctl disable --now ModemManager

=Reboot=
Ein Reboot funktioniert nicht wirklich, da kein ACPI, kein BIOS sondern ueber die Firmware des SoC Tegra3.

Das Surface faehrt zwar runter bleibt aber beim Poweroff haengen.

Wenn keine Bildschirmanzeige da ist, die auf das Warten auf den Powerknopf hinweist, dann gibt das Beruehren des Windowsknopfes ein Vibrationssignal von sich.

Derzeit kenne ich nur die Loesung 5 Sekunden Powerknopf festhalten und wieder kurz druecken.

=Autostart=
Mist. Nach dem Wechsel auf Labwc (Wayland) geht mein Autostart nicht mehr.

echo $XDG_SESSION_TYPE

Mit

sudo raspi-config

erhaelt man unter Punkt 6 eine Umschaltmoeglichkeit.

X11 Openbox window manager with X11 backend
Wayfire Wayfire window manager with Wayland backend
Labwc Labwc window manager with Wayland backend

<pre>
mkdir -p ~/.config/labwc
nano ~/.config/labwc/autostart
</pre>

=Windows-Taste=
Um die Windowstaste (Super_L) anzupassen, aendert man einfach nur den Eintrag <command> in /etc/xdg/openbox/lxde-pi-rc.xml.
[https://forums.raspberrypi.com/viewtopic.php?t=209261]

Standrardmaeszig steht dort 'lxpanelctl menu', was aber nur das Startmenu oeffnet. Ich moechte aber, dass bei jeder Button-Aktivitaet das Panel sichtbar und wieder unsichtbar wird.

Das Startmenu bekomme ich dann ja durch Klicken auf die Himbeere.

In Raspbian 12 Bookworm laeuft das lxpanel mit dem Profil LXDE-pi.

Die passende panel-Config-Datei befindet sich in .config/lxpanel/LXDE-pi/panels/.

In der Panel-Datei muss man also den Eintrag autohide zwischen 0 und 1 wechseln und lxpanelctl restart ausfuehren.

Also die Idee ist wie folgt.

An den Super_L wird ein Bash-Script gebunden, welches den autohide Eintrag toggelt und das Panel neu startet.

Das Toggeln uebernimmt sed.
sed -i 's/^autohide=1$/autohide=0/' .config/lxpanel/LXDE-pi/panels/panel

Ich habe mal meine Testzeilen dringelassen.

<syntaxhighlight lang="bash" line>
#!/bin/bash
configfile="/home/chris/.config/lxpanel/LXDE-pi/panels/panel"
sed="/usr/bin/sed"

$sed -i 's/^autohide=1$/autohide=0/;ta;q1;:a' $configfile
retval="$?"
#echo "1->0 $retval"
#if [ $retval -ne 1 ]; then
# echo "exit"
# exit 0
#fi
[ $retval -ne 1 ] && exit
$sed -i 's/^autohide=0$/autohide=1/;ta;q2;:a' $configfile
#retval="$?"
#echo "0->1 $retval"
</syntaxhighlight>

==DTB Datei==

DTB = Device Tree Binary

In dieser Datei ist die Hardwarestruktur des PI o.ä. codiert. Diese Datei ist binaer und somit nicht einfach lesbar. Hierzu schreibt Jeff Geerling:

How to customize the dtb (device tree binary) on the Raspberry Pi
November 17, 2023

Every so often, when you're debugging weird hardware issues on SBCs like the Raspberry Pi, it's useful to get way down into the guts of how the Pi represents its hardware to Linux.

And the Linux kernel uses a method called Device Tree overlays to do it. On the Pi 5 (and other Pis), these overlays are stored as .dtb files inside the /boot/firmware directory, and there's an overlay for every major Raspberry Pi hardware model.

I've had to modify the dtb files in the past to increase the PCIe BAR space for early GPU testing on the Compute Module 4. And recently I've had to mess with how the PCIe address space is set up for testing certain devices on the Raspberry Pi 5.

The problem is, you can't just hand-edit a .dtb file—they're in a format readable only by the Linux kernel. You have to decompile the .dtb file to a .dts (source) file, edit it, then recompile it to a .dtb.

As an example, I needed to change the msi-parent for the Pi 5's external PCIe connector to allow for full MSI-X support for a Google Coral TPU (work on getting it to work is ongoing):

# Back up the current dtb
sudo cp /boot/firmware/bcm2712-rpi-5-b.dtb /boot/firmware/bcm2712-rpi-5-b.dtb.bak

# Decompile the current dtb (ignore warnings)
dtc -I dtb -O dts /boot/firmware/bcm2712-rpi-5-b.dtb -o ~/test.dts

# Edit the file
nano ~/test.dts

# Change the line: msi-parent = <0x2f>; (under `pcie@110000`)
# To: msi-parent = <0x66>;
# Then save the file.

# Recompile the dtb and move it back to the firmware directory
dtc -I dts -O dtb ~/test.dts -o ~/test.dtb
sudo mv ~/test.dtb /boot/firmware/bcm2712-rpi-5-b.dtb

Check out elinux's Device Tree Reference for more useful background info.

I consider myself an absolute noob at Device Trees in Linux... but I've now done this enough times that I'd like a simple reference and most of the ones out there assume you are an expert-level wizard in all things Linux/hardware!

Windows-Surface als Smarthome-Display

2026-04-14T07:49:24Z

Chris T. Ludwig: /* Surfstick */

=Allgemeines=
Die beiden [https://en.wikipedia.org/wiki/Surface_(2012_tablet) WindowsRT Surface Displays] waren einfach zu schade, um Sie nur rumliegen zu haben.

Ich bin nicht mehr sicher was ich auf dieser Seite ergaenzen wollte. Die Hauptseite ist [https://tippvomtibb.de/wiki/index.php?title=Windows_Surface_RT hier]

=WLAN Problem=
[ 9.704201] mwifiex_sdio mmc2:0001:1: info: FW download over, size 533976 bytes
[ 9.945765] mwifiex_sdio mmc2:0001:1: WLAN FW is active
[ 10.210971] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x242 error, result=0x2
[ 10.211047] mwifiex_sdio mmc2:0001:1: mwifiex_process_cmdresp: cmd 0x242 failed during initialization
[ 10.535490] mwifiex_sdio mmc2:0001:1: info: MWIFIEX VERSION: mwifiex 1.0 (14.68.29.p59)
[ 10.535524] mwifiex_sdio mmc2:0001:1: driver_version = mwifiex 1.0 (14.68.29.p59)
[ 17.295906] mwifiex_sdio mmc2:0001:1: info: trying to associate to bssid 24:5a:4c:22:8a:8f
[ 17.324014] mwifiex_sdio mmc2:0001:1: info: associated to bssid 24:5a:4c:22:8a:8f successfully
[ 17.354089] mwifiex_sdio mmc2:0001:1: CMD_RESP: cmd 0x23f error, result=0x2

Das Problem ist [https://github.com/jakeday/linux-surface/issues/420 hier] und [https://wiki.postmarketos.org/wiki/Microsoft_Surface_RT_(microsoft-surface-rt) hier]geloest.

Das Modul mwifiex_sdio muss noch mit modprobe geladen werden.

sudo modprobe mwifiex_sdio

Nicht wundern, es ist scheinbar standardmaeszig kein Modul geladen.
<pre>
Module Size Used by
mwifiex_sdio 28672 0
mwifiex 237568 1 mwifiex_sdio
</pre>
Sobald das Modul geladen ist kann man das WLAN benutzen.

=Feste IP=
Ab Bookworm wird nicht mehr etc/dhcp.conf zu hinterlegen genommen, sondern jetzt dient dazu der NetworkManager fuer die Aufgaben rund ums Netzwerk.

sudo systemctl restart NetworkManager

=WLAN/LAN Management=

nmcli device wifi list

nmcli device show

nmcli connection show

=Surfstick=
Ich benutzederzeit keinen Surfstick in den Displays.

sudo systemctl disable --now ModemManager

=Reboot=
Ein Reboot funktioniert nicht wirklich, da kein ACPI, kein BIOS sondern ueber die Firmware des SoC Tegra3.

Das Surface faehrt zwar runter bleibt aber beim Poweroff haengen.

Wenn keine Bildschirmanzeige da ist, die auf das Warten auf den Powerknopf hinweist, dann gibt das Beruehren des Windowsknopfes ein Vibrationssignal von sich.

Derzeit kenne ich nur die Loesung 5 Sekunden Powerknopf festhalten und wieder kurz druecken.

=Autostart=
Mist. Nach dem Wechsel auf Labwc (Wayland) geht mein Autostart nicht mehr.

echo $XDG_SESSION_TYPE

Mit

sudo raspi-config

erhaelt man unter Punkt 6 eine Umschaltmoeglichkeit.

X11 Openbox window manager with X11 backend
Wayfire Wayfire window manager with Wayland backend
Labwc Labwc window manager with Wayland backend

<pre>
mkdir -p ~/.config/labwc
nano ~/.config/labwc/autostart
</pre>

=Windows-Taste=
Um die Windowstaste (Super_L) anzupassen, aendert man einfach nur den Eintrag <command> in /etc/xdg/openbox/lxde-pi-rc.xml.
[https://forums.raspberrypi.com/viewtopic.php?t=209261]

Standrardmaeszig steht dort 'lxpanelctl menu', was aber nur das Startmenu oeffnet. Ich moechte aber, dass bei jeder Button-Aktivitaet das Panel sichtbar und wieder unsichtbar wird.

Das Startmenu bekomme ich dann ja durch Klicken auf die Himbeere.

In Raspbian 12 Bookworm laeuft das lxpanel mit dem Profil LXDE-pi.

Die passende panel-Config-Datei befindet sich in .config/lxpanel/LXDE-pi/panels/.

In der Panel-Datei muss man also den Eintrag autohide zwischen 0 und 1 wechseln und lxpanelctl restart ausfuehren.

Also die Idee ist wie folgt.

An den Super_L wird ein Bash-Script gebunden, welches den autohide Eintrag toggelt und das Panel neu startet.

Das Toggeln uebernimmt sed.
sed -i 's/^autohide=1$/autohide=0/' .config/lxpanel/LXDE-pi/panels/panel

Ich habe mal meine Testzeilen dringelassen.

<syntaxhighlight lang="bash" line>
#!/bin/bash
configfile="/home/chris/.config/lxpanel/LXDE-pi/panels/panel"
sed="/usr/bin/sed"

$sed -i 's/^autohide=1$/autohide=0/;ta;q1;:a' $configfile
retval="$?"
#echo "1->0 $retval"
#if [ $retval -ne 1 ]; then
# echo "exit"
# exit 0
#fi
[ $retval -ne 1 ] && exit
$sed -i 's/^autohide=0$/autohide=1/;ta;q2;:a' $configfile
#retval="$?"
#echo "0->1 $retval"
</syntaxhighlight>

==DTB Datei==

DTB = Device Tree Binary

In dieser Datei ist die Hardwarestruktur des PI o.ä. codiert. Diese Datei ist binaer und somit nicht einfach lesbar. Hierzu schreibt Jeff Geerling:

How to customize the dtb (device tree binary) on the Raspberry Pi
November 17, 2023

Every so often, when you're debugging weird hardware issues on SBCs like the Raspberry Pi, it's useful to get way down into the guts of how the Pi represents its hardware to Linux.

And the Linux kernel uses a method called Device Tree overlays to do it. On the Pi 5 (and other Pis), these overlays are stored as .dtb files inside the /boot/firmware directory, and there's an overlay for every major Raspberry Pi hardware model.

I've had to modify the dtb files in the past to increase the PCIe BAR space for early GPU testing on the Compute Module 4. And recently I've had to mess with how the PCIe address space is set up for testing certain devices on the Raspberry Pi 5.

The problem is, you can't just hand-edit a .dtb file—they're in a format readable only by the Linux kernel. You have to decompile the .dtb file to a .dts (source) file, edit it, then recompile it to a .dtb.

As an example, I needed to change the msi-parent for the Pi 5's external PCIe connector to allow for full MSI-X support for a Google Coral TPU (work on getting it to work is ongoing):

# Back up the current dtb
sudo cp /boot/firmware/bcm2712-rpi-5-b.dtb /boot/firmware/bcm2712-rpi-5-b.dtb.bak

# Decompile the current dtb (ignore warnings)
dtc -I dtb -O dts /boot/firmware/bcm2712-rpi-5-b.dtb -o ~/test.dts

# Edit the file
nano ~/test.dts

# Change the line: msi-parent = <0x2f>; (under `pcie@110000`)
# To: msi-parent = <0x66>;
# Then save the file.

# Recompile the dtb and move it back to the firmware directory
dtc -I dts -O dtb ~/test.dts -o ~/test.dtb
sudo mv ~/test.dtb /boot/firmware/bcm2712-rpi-5-b.dtb

Check out elinux's Device Tree Reference for more useful background info.

I consider myself an absolute noob at Device Trees in Linux... but I've now done this enough times that I'd like a simple reference and most of the ones out there assume you are an expert-level wizard in all things Linux/hardware!

Smarthome Mobil Notify Services

2026-04-14T07:47:36Z

Chris T. Ludwig: /* Allgemeines */

=Allgemeines=
Hier sammele ich das fuer mich notwendige Wissen, um mit meiner Gebaeudeautomation (FHEM, iobroker, EDOMI, ...) Nachrichten an mein Mobiles zu senden. In einer ersten Recherche sind mir ein paar wenige Dienste begegnet, die ich hier aufliste und deren Verwendung ich kurz beschreibe.

=Notify-Apps=
==Signal==
Zum Ausprobieren habe ich erst mal die Desktopversion auf meinem Arbeitsrechner (OpenSuSE LEAP 15.3) installiert.

Linux (Debian-based) Install Instructions

# NOTE: These instructions only work for 64 bit Debian-based
# Linux distributions such as Ubuntu, Mint etc.

# 1. Install our official public software signing key
wget -O- https://updates.signal.org/desktop/apt/keys.asc | gpg --dearmor > signal-desktop-keyring.gpg
cat signal-desktop-keyring.gpg | sudo tee -a /usr/share/keyrings/signal-desktop-keyring.gpg > /dev/null

# 2. Add our repository to your list of repositories
echo 'deb [arch=amd64 signed-by=/usr/share/keyrings/signal-desktop-keyring.gpg] https://updates.signal.org/desktop/apt xenial main' |\
sudo tee -a /etc/apt/sources.list.d/signal-xenial.list

# 3. Update your package database and install signal
sudo apt update && sudo apt install signal-desktop

https://snapcraft.io/install/signal-desktop/opensuse

==WhatsApp==
Mit Whatsapp scheint es ueber diesen [https://www.twilio.com/try-twilio Dienst] zu gehen.

https://dev.to/jajoosam/build-a-whatsapp-bot-fast--2hdc

==Pushover==
TODO
==Telegram==
Ueber die Telegram Bot API.
[https://webdesign.weisshart.de/php2mobile.php Link]

Zum Probieren habe ich mal die Telegram-App auf meinem Android-Smartphone installiert.

Die Anfragen bzgl. Zugriff auf Anrufe, Kontakte, ... kann man auch getrost ablehnen.
Die ANmeldung uber die Telefonnummer und Authentifizierung ueber SMS und/oder eMail ging problemlos.
Die Suche nach dem Nutzer Botfather war erfogreich.
Nach dem Starten gab es gleich mal eine Kommandouebersicht, die man mit der Nachricht "/start" jederzeit neu anfordern kann.

Der Aufruf von https://t.me/Accipiter_bot zeigte zwar meinen Bot, aber das Senden einer Nachricht scheiterte aber an dem fehlenden Plugin im Browser, um mit dem Protokoll tg:// umgehen zu koennen. -> TODO

Um aber eine Cat-Nachricht ueber php bzw. curl absetzen zu koennen benoetigt man, neben dem API-Token, eine Chat-ID, die man ueber den Umweg durch den Aufruf https://api.telegram.org/bot<token>/getUpdates herausbekommt. Die JSON-Nachricht beinhaltet einen Eintrag id:<chat-id>. Die kopiert man sich heraus und ergaenzt sie in der "SendeNachricht-URL".

https://api.telegram.org/bot<token>/sendMessage?chat_id=chat-id&text=Here%20is%20your%20Smarthome

Erfolg:-)

Der Telegram-Client fuer Linux funktioniert auch auf Anhieb:-))

==Jabber==
TODO

==Signal4==
[https://www.signl4.com/]
Das Starter-Package ist kostenlos:-)

(Zigbee2MQTT) Stolperfallen

2026-04-12T08:33:25Z

Chris T. Ludwig: Die Seite wurde neu angelegt: „=Fehlermeldung= Beim Deaktivieren der legacy_action_sensor option kommt folgende fehlermeldung frontend:api:bridge: Sending {"topic":"bridge/request/options","payload":{"options":{"homeassistant":{"legacy_action_sensor":false}},"transaction":"yaom6-1"}} [4/12/2026, 7:57:04 AM] z2m: Request 'zigbee2mqtt/bridge/request/options' failed with error: 'Extension with name HomeAssistant already present' Das ist sehr wahrscheinlich '''ein Bug beim Umschalten de…“

=Fehlermeldung=

Beim Deaktivieren der legacy_action_sensor option kommt folgende fehlermeldung frontend:api:bridge: Sending {"topic":"bridge/request/options","payload":{"options":{"homeassistant":{"legacy_action_sensor":false}},"transaction":"yaom6-1"}} [4/12/2026, 7:57:04 AM] z2m: Request 'zigbee2mqtt/bridge/request/options' failed with error: 'Extension with name HomeAssistant already present'

Das ist sehr wahrscheinlich '''ein Bug beim Umschalten der Home-Assistant-Optionen zur Laufzeit im Zigbee2MQTT-Frontend''', nicht ein Fehler in deiner Konfiguration. Ein aktueller Issue zeigt denselben Fehler beim Ein-/Ausschalten von HA-Optionen per <code>bridge/request/options</code>:

<blockquote><code>Extension with name HomeAssistant already present</code> ([https://github.com/Koenkk/zigbee2mqtt/issues/31089?utm_source=chatgpt.com GitHub])
</blockquote>
Außerdem ist <code>legacy_action_sensor</code> in der Zigbee2MQTT-Doku als Home-Assistant-Option beschrieben; wenn aktiviert, sendet Zigbee2MQTT '''nach jeder Action absichtlich ein leeres <code>action</code>'''. ([https://www.zigbee2mqtt.io/guide/configuration/homeassistant.html?utm_source=chatgpt.com Zigbee2MQTT])

<span id="was-das-für-dich-bedeutet"></span>
== Was das für dich bedeutet ==

Dein eigentliches Problem bleibt:

* <code>.../action</code> Topic ist korrekt
* <code>payload.action</code> wird danach leer
* das passt exakt zu <code>legacy_action_sensor: true</code> ([https://www.zigbee2mqtt.io/guide/configuration/homeassistant.html?utm_source=chatgpt.com Zigbee2MQTT])

Der neue Fehler bedeutet nur:

* das '''Frontend kann die HomeAssistant-Extension gerade nicht sauber live neu aufbauen'''
* daher musst du die Option '''in der Datei ändern und Zigbee2MQTT neu starten''', statt sie im Frontend umzuschalten. ([https://github.com/Koenkk/zigbee2mqtt/issues/31089?utm_source=chatgpt.com GitHub])

<span id="so-gehst-du-sauber-vor"></span>
== So gehst du sauber vor ==

Öffne deine Zigbee2MQTT-<code>configuration.yaml</code> und setze:

<syntaxhighlight lang="yaml">homeassistant:
enabled: true
legacy_action_sensor: false</syntaxhighlight>
Optional, wenn du die neuere Richtung nutzen willst:

<syntaxhighlight lang="yaml">homeassistant:
enabled: true
legacy_action_sensor: false
experimental_event_entities: true</syntaxhighlight>
Danach '''Zigbee2MQTT komplett neu starten'''. Die Doku führt beide Optionen im <code>homeassistant</code>-Block. ([https://www.zigbee2mqtt.io/guide/configuration/homeassistant.html?utm_source=chatgpt.com Zigbee2MQTT])

<span id="wichtig-nicht-im-frontend-umschalten"></span>
== Wichtig: nicht im Frontend umschalten ==

Der Fehler kommt genau von diesem Weg:

<syntaxhighlight lang="text">zigbee2mqtt/bridge/request/options</syntaxhighlight>
also vom dynamischen Options-Update aus dem Frontend. Dafür gibt es aktuell einen bekannten Fehler bei HA-bezogenen Optionen. ([https://github.com/Koenkk/zigbee2mqtt/issues/31089?utm_source=chatgpt.com GitHub])

<span id="wenn-du-den-code-trotzdem-patchen-willst"></span>
== Wenn du den Code trotzdem patchen willst ==

Die richtige Stelle ist '''nicht''' der TS0044-Converter, sondern die HA-Extension von Zigbee2MQTT:

<syntaxhighlight lang="text">lib/extension/homeassistant.ts</syntaxhighlight>
Dort sitzt die Logik, die bei aktivem <code>legacy_action_sensor</code> direkt nach einer Action noch einmal <code>{action: ""}</code> publiziert. Das ist im aktuellen Quellcode so zu sehen. ([https://github.com/Koenkk/zigbee2mqtt/blob/master/lib/extension/homeassistant.ts?utm_source=chatgpt.com GitHub])

Wenn du lokal patchen willst, ist der Minimal-Patch, diese Zeile zu deaktivieren:

<syntaxhighlight lang="ts">await this.publishEntityState(data.entity, {action: ""});</syntaxhighlight>
Aber der bessere Weg ist wirklich, <code>legacy_action_sensor: false</code> in der Konfig zu setzen und Zigbee2MQTT neu zu starten. ([https://www.zigbee2mqtt.io/guide/configuration/homeassistant.html?utm_source=chatgpt.com Zigbee2MQTT])

<span id="erwartetes-verhalten-danach"></span>
== Erwartetes Verhalten danach ==

Nach dem Neustart solltest du typischerweise sehen:

* kein absichtliches Leeren von <code>payload.action</code>
* Actions weiter korrekt auf <code>zigbee2mqtt/DEIN_GERAET/action</code>
* in Home Assistant besser mit MQTT Device Triggern oder Event-Entities arbeiten statt mit dem alten Action-Sensor. Das wird in den Zigbee2MQTT-Hinweisen ebenfalls so empfohlen. ([https://github.com/Koenkk/zigbee2mqtt/issues/25461?utm_source=chatgpt.com GitHub])

<span id="wenn-du-den-patch-direkt-suchst"></span>
== Wenn du den Patch direkt suchst ==

Je nach Installation findest du die laufende JS-Datei oft eher hier als die TS-Datei:

<syntaxhighlight lang="text">/app/lib/extension/homeassistant.js</syntaxhighlight>
Die Quellreferenz bleibt aber:

<syntaxhighlight lang="text">lib/extension/homeassistant.ts</syntaxhighlight>
([https://github.com/Koenkk/zigbee2mqtt/blob/master/lib/extension/homeassistant.ts?utm_source=chatgpt.com GitHub])

=TS0044 action <nowiki>=</nowiki> Leerstring im payload=

Das liegt sehr wahrscheinlich '''nicht am TS0044_1-Converter''', sondern an der '''Home-Assistant-Integration von Zigbee2MQTT'''.

Der entscheidende Hinweis ist dein Symptom:

* '''<code>.../action</code> Topic''' enthält den richtigen Tastendruck
* '''Payload-Feld <code>action</code>''' im normalen Geräte-Topic ist danach leer
* im Frontend ist <code>action</code> ebenfalls leer

Genau dieses Verhalten ist dokumentiert, wenn '''<code>homeassistant.legacy_action_sensor</code>''' aktiviert ist: Dann wird '''nach jeder Action absichtlich ein leeres <code>action</code>''' gesendet. ([https://www.zigbee2mqtt.io/guide/configuration/all-settings.html?utm_source=chatgpt.com Zigbee2MQTT])

Außerdem zeigt der Zigbee2MQTT-Quellcode genau diese Logik in der Home-Assistant-Extension: Wenn <code>legacyActionSensor</code> aktiv ist und <code>data.message.action</code> existiert, wird direkt danach <code>publishEntityState(..., {action: ""})</code> aufgerufen; erst darunter wird der korrekte Wert zusätzlich auf <code>.../action</code> publiziert. ([https://raw.githubusercontent.com/Koenkk/zigbee2mqtt/master/lib/extension/homeassistant.ts GitHub])

<span id="was-bei-dir-also-wahrscheinlich-aktiv-ist"></span>
== Was bei dir also wahrscheinlich aktiv ist ==

In deiner <code>configuration.yaml</code> von Zigbee2MQTT vermutlich so etwas:

<syntaxhighlight lang="yaml">homeassistant:
enabled: true
legacy_action_sensor: true</syntaxhighlight>
Die Doku beschreibt genau dazu:

* <code>legacy_action_sensor</code>: aktiviert alte Action-Sensoren
* dabei wird '''nach jeder Action ein leerer <code>action</code>-Wert gesendet''' ([https://www.zigbee2mqtt.io/guide/configuration/all-settings.html?utm_source=chatgpt.com Zigbee2MQTT])

<span id="warum-recent-activity-trotzdem-richtig-ist"></span>
== Warum „Recent activity“ trotzdem richtig ist ==

Weil Zigbee2MQTT für Actions zusätzlich das separate MQTT-Topic

<syntaxhighlight lang="text">zigbee2mqtt/DEIN_GERAET/action</syntaxhighlight>
publiziert. Das ist genau der Pfad, den Zigbee2MQTT für MQTT Device Triggers verwendet. ([https://raw.githubusercontent.com/Koenkk/zigbee2mqtt/master/lib/extension/homeassistant.ts GitHub])

<span id="was-du-tun-solltest"></span>
== Was du tun solltest ==

<span id="sauberste-lösung"></span>
=== Sauberste Lösung ===

<code>legacy_action_sensor</code> deaktivieren oder entfernen:

<syntaxhighlight lang="yaml">homeassistant:
enabled: true
legacy_action_sensor: false</syntaxhighlight>
Danach Zigbee2MQTT neu starten.

Dann solltest du für Automationen das '''separate <code>/action</code> Topic''' oder die von Zigbee2MQTT empfohlenen '''MQTT device triggers''' verwenden. Zigbee2MQTT empfiehlt für Button-Actions in Home Assistant genau diesen Weg. ([https://www.zigbee2mqtt.io/guide/usage/integrations/home_assistant.html?utm_source=chatgpt.com Zigbee2MQTT])

<span id="falls-du-in-home-assistant-event-entities-willst"></span>
=== Falls du in Home Assistant Event-Entities willst ===

Optional:

<syntaxhighlight lang="yaml">homeassistant:
enabled: true
experimental_event_entities: true</syntaxhighlight>
Das ist die neuere Richtung für Action-/Event-Geräte. ([https://www.zigbee2mqtt.io/guide/configuration/all-settings.html?utm_source=chatgpt.com Zigbee2MQTT])

-----

<span id="wo-du-patchen-müsstest"></span>
== Wo du patchen müsstest ==

'''Nicht''' im TS0044_1-Geräte-Converter, denn der liefert die Action offenbar korrekt — sonst wäre das Topic <code>.../action</code> nicht richtig.

Die richtige Stelle ist in Zigbee2MQTT selbst:

<syntaxhighlight lang="text">lib/extension/homeassistant.ts</syntaxhighlight>
Dort in der Methode <code>onPublishEntityState(...)</code>.

Die relevante Stelle ist sinngemäß:

<syntaxhighlight lang="ts">if (this.legacyActionSensor && data.message.action) {
await this.publishEntityState(data.entity, {action: ""});
}

if (settings.get().advanced.output === "json" && entity.isDevice() && entity.definition && data.message.action) {
const value = data.message.action.toString();
await this.publishDeviceTriggerDiscover(entity, "action", value);
await this.mqtt.publish(`${data.entity.name}/action`, value, {});
}</syntaxhighlight>
Genau dieser Code ist im Repository sichtbar. ([https://raw.githubusercontent.com/Koenkk/zigbee2mqtt/master/lib/extension/homeassistant.ts GitHub])

<span id="wenn-du-wirklich-patchen-willst"></span>
== Wenn du wirklich patchen willst ==

Dann ist der Minimal-Patch:

<syntaxhighlight lang="ts">if (this.legacyActionSensor && data.message.action) {
// await this.publishEntityState(data.entity, {action: ""});
}</syntaxhighlight>
oder härter:

<syntaxhighlight lang="ts">if (false && this.legacyActionSensor && data.message.action) {
await this.publishEntityState(data.entity, {action: ""});
}</syntaxhighlight>
<span id="wichtig-dabei"></span>
== Wichtig dabei ==

Bei einer laufenden Installation patchst du meistens '''nicht''' die TypeScript-Quelldatei direkt, sondern die ausgelieferte JS-Datei im Container/Add-on. Je nach Installation liegt sie oft unter etwas wie:

<syntaxhighlight lang="text">/app/lib/extension/homeassistant.js</syntaxhighlight>
Die saubere Lösung ist aber trotzdem: '''<code>legacy_action_sensor</code> ausschalten''', statt den Code zu patchen.

<span id="kurzfazit"></span>
== Kurzfazit ==

Dein Problem ist sehr wahrscheinlich:

* '''kein TS0044_1-Bug'''
* '''kein Converter-Bug'''
* sondern das absichtliche Verhalten von '''<code>legacy_action_sensor: true</code>'''

Die beste Abhilfe ist daher, diese Option auszuschalten und mit <code>.../action</code> bzw. MQTT Device Triggers weiterzuarbeiten. ([https://www.zigbee2mqtt.io/guide/configuration/all-settings.html?utm_source=chatgpt.com Zigbee2MQTT])

(FHEM) FTUI 3

2026-04-11T06:51:00Z

Chris T. Ludwig: /* Beispiele */

(FHEM) Stolperfallen

2026-04-11T06:48:23Z

Chris T. Ludwig: /* KNX Toggle */

=(PGM2) RoomIcons bei Untermenues=
Hab mal wieder einen Volltreffer gelandet. Weil die Raeume im FHEMWEB zu viele wurden, aber auch nicht mit "hiddenroom" unterdrueckt werden sollten. Wollte ich mal 'Room in Room' aussprobieren.
Leider scheint das nicht zu funktionieren (Stand fhem 6.0). Aus der Commandref geht eine Alternative hervor. Und zwar, wenn man im Raumnamen ein '->' verwendet, fuehrt das dazu, dass im FHEM-Roommenue
aufklappbare Unterraeume (die nach dem ->) angezeigt werden. Man kann also keinen kompletten bestehenden Raum einem anderen Raum zuordnen, sondern man ist gezwungen alle Devices den neuen Raumnamen zuzuordnen.
Ein unschoener Effekt ist zudem, dass der uebergeordnete Raumname kein Icon mehr hat.

Dies bestatigt diese [https://forum.fhem.de/index.php?topic=91800.0 Forums-Nachfrage].

Ein Blick in den Quellcode von 01_FHEMWEB.pm zeigt:
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">01-FHEMWEB.pm (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="perl" line>
##########################
# Rooms and other links
foreach my $r (@FW_roomsArr) { # Das Array mit den Raumnamen wird nacheinander durchlaufen; In der Variablen r steht der aktuell zu pruefende Raumname
next if($r eq "hidden" || $FW_hiddenroom{$r}); # Ist der Raum hidden geh zu naechsten = tue nichts mit diesem Raum
$FW_room = AttrVal($FW_wname, "defaultRoom", $r)
if(!$FW_room && $FW_ss);
if(my $devspec = $FW_extraRooms{$r}) {
my $r = $r;
$r =~ s/ / /g; # Ersetze alle NoBreakSpaces durch Leerzeichen
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($devspec); # Da habe ich noch keine Idee zu
} else {
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($r);
}

}
my $sfx = AttrVal("global", "language", "EN");
$sfx = ($sfx eq "EN" ? "" : "_$sfx"); # wenn die eingestellte Sprache EN ist , dann ist sfx leer; es wird also z.B: an den Dateinamen commandref nichts angehaengt (sfx steht fuer suffix)
my @list = ( # das ist wohl die Standard Ausgangsliste; interassant: Everything gehoert zum Raummenue und der Rest zum (Name?)-Menue darunter
"Everything", "$FW_ME?room=all",
"", "",
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", "");
my $lastname = ","; # Avoid double "".

my $lfn = "Logfile";
if($defs{$lfn}) { # Add the current Logfile to the list if defined
my @l = FW_fileList($defs{$lfn}{logfile},1);
my $fn = pop @l;
splice @list, 4,0, ("Logfile",
"$FW_ME/FileLog_logWrapper?dev=$lfn&type=text&file=$fn"); # fuege den Logfile-Eintrag vor dem Eintrag Commandref ein (wenn definiert)
}
# die menuEntries sind der dritte Block (Rooms, (Name?)-Menue, menuEntries)
my @me = split(",", AttrVal($FW_wname, "menuEntries", "")); # die menuEntries sind eine komma-separierte Liste von Eintraegen der Art Menuname,Kommando
push @list, @me, "", "" if(@me); # Die Eintragungen werden angehaengt "","" ist jeweils der Block-Abschluss, bzw. Separator

for(my $idx = 0; $idx < @list; $idx+= 2) { # haenge die Kommandoliste an die Raumliste an
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx]; # in list1 stehen die Menunamen und in list2 die Aktionen
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}

FW_pO "<div id=\"menu\">"; # hier geht's dann los mit dem Zusammenbau der HTML-Seite (siehe unten)
FW_pO "<table>";
if($FW_ss) { # Make a selection sensitive dropdown list # $FW_ss also '''F'''HEM'''W'''EB '''s'''ensitive '''s'''election auf einem '''S'''mall '''S'''creen
FW_pO "<tr><td><select OnChange=\"location.href=" .
"this.options[this.selectedIndex].value\">";
foreach(my $idx = 0; $idx < @list1; $idx++) {
next if(!$list1[$idx]);
my $sel = ($list1[$idx] eq $FW_room ? " selected=\"selected\"" : "");
FW_pO "<option value='$list2[$idx]'$sel>$list1[$idx]</option>";
}
FW_pO "</select></td>";
FW_pO "</tr>";

} else {

my $tblnr = 1;
my $roomEscaped = FW_htmlEscape($FW_room); # ersetzte alle (& < > ' (\n)) aus dem aktuellen (?) Raumnamen, wird allerdings nie mehr verwendet
my $current;
$current = "$FW_ME?room=".urlEncode($FW_room) if($FW_room);
$current = "$FW_ME?cmd=".urlEncode($cmd) if($cmd);
foreach(my $idx = 0; $idx < @list1; $idx++) { # jetzt durchlaufe die gesamte Liste mit allen Menueintraegen und baue die HTML-Seite (roomBlock1-3)
my ($l1, $l2) = ($list1[$idx], $list2[$idx]);
if(!$l1) {
FW_pO "</table></td></tr>" if($idx); # die Raumbloecke sind eine Tabelle in der Tabelle menu, diese Table-Ende wird nach jedem Block (Eintrag "","") ausgegeben. Am Anfang ist $idx noch 0, dann also nicht.
if($idx<int(@list1)-1) {
FW_pO "<tr><td><table class=\"room roomBlock$tblnr\">"; # hier waere es auch moeglich durch einfuegen eines leeren/speziellen Eintrags einen neunen Block zu generieren
$tblnr++;
}

} else { # hier kommt jetzt der aktuell interessante Teil
FW_pF "<tr%s>", ($current && $current eq $l2) ? " class=\"sel\"" : ""; # FW_pF ist eine formatierte Ausgabe

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi;

# image tag if we have an icon, else empty
my $icoName = "ico$l1";
map { my ($n,$v) = split(":",$_); $icoName=$v if($l1 =~ m/^$n$/); } # die roomOcons sind eine Leerzeichen-getrennte Liste von Raumname:IconName $n:$v
split(" ", AttrVal($FW_wname, "roomIcons", ""));
my $icon = FW_iconName($icoName) ?
FW_makeImage($icoName,$icoName,"icon")." " : "";

if($l1 eq "Save config") { # Spezialbehandlung des Menueintrags
$l1 .= '</span></a> '.
'<a id="saveCheck" class="changed" style="visibility:'.
(int(@structChangeHist) ? 'visible' : 'hidden').'"><span>?';
}

# Force external browser if FHEMWEB is installed as an offline app.
my $target = ''; # Forum 33066, 39854
$target = 'target="_blank"' if($l2 =~ s/^$FW_ME\/\+/$FW_ME\//);
$target = 'target="_blank"' if($l2 =~ m/commandref|fhem.de.fhem.html/);
if($l2 =~ m/.html$/ || $l2 =~ m/^(http|javascript)/ || length($target)){ # wenn das Kommando auf .html endet oder mit http oder javascript beginnt target definiert (siehe die beiden Zeilen vorher) ist, dann mach aus dem Komando einen Link
FW_pO "<td><div><a href='$l2' $target>$icon<span>$l1</span></a>".
"</div></td>";
} else {
FW_pH $l2, "$icon<span>$l1</span>", 1, $class; # ein bisschen merkwuerdig, aber ab im "normalfall" wird alles ab <td> zwischen </td> durch FW_pH ausgegeben, siehe unten Erlaeuterung
}

FW_pO "</tr>";
}
}

}
FW_pO "</table>";
FW_pO "</div>";
FW_pO "</div>" if($hasMenuScroll);
</syntaxhighlight>
</div></div>

Bei mir sieht das Ergebnis dann so aus.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Quellcode fhem.html (Auszug roomBlock1-3)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="html" line>
<div id="menuScrollArea">
<div><a onClick="location.href='/fhem?'"><div id="logo"></div></a></div>
<div id="menu">
<table>
<tr><td><table class="room roomBlock1">
<tr><td><div class="menu_LEUCHTEN"><a onClick="location.href='/fhem?room=LEUCHTEN'"><img class='icon icoBELEUCHTUNG' src="/fhem/images/default/icoBELEUCHTUNG.png" alt="icoBELEUCHTUNG" title="icoBELEUCHTUNG"> <span>LEUCHTEN</span></a></div></td>
</tr>
<tr><td><div class="menu_ROLLLADEN"><a onClick="location.href='/fhem?room=ROLLLADEN'"><img class='icon icoROLLLADEN' src="/fhem/images/user_icons/icoROLLLADEN.png" alt="icoROLLLADEN" title="icoROLLLADEN"> <span>ROLLLADEN</span></a></div></td>
</tr>
<tr><td><div class="menu_AUSSEN"><a onClick="location.href='/fhem?room=AUSSEN'"><img class='icon icoAUSSEN' src="/fhem/images/default/icoAUSSEN.png" alt="icoAUSSEN" title="icoAUSSEN"> <span>AUSSEN</span></a></div></td>
</tr>
<tr><td><div class="menu_KLIMA"><a onClick="location.href='/fhem?room=KLIMA'"><img class='icon icoTemp' src="/fhem/images/default/icoTemp.png" alt="icoTemp" title="icoTemp"> <span>KLIMA</span></a></div></td>
</tr>
<tr><td><div class="menu_HAUST__R"><a onClick="location.href='/fhem?room=HAUST%c3%9cR'"><img class='icon icoHouse' src="/fhem/images/default/icoHouse.png" alt="icoHouse" title="icoHouse"> <span>HAUSTÜR</span></a></div></td>
</tr>
<tr><td><div class="menu_HEIZUNG"><a onClick="location.href='/fhem?room=HEIZUNG'"><img class='icon icoHEIZUNG' src="/fhem/images/default/icoHEIZUNG.png" alt="icoHEIZUNG" title="icoHEIZUNG"> <span>HEIZUNG</span></a></div></td>
</tr>
<tr><td><div class="menu_MULTIMEDIA"><a onClick="location.href='/fhem?room=MULTIMEDIA'"><img class='icon icoAUDIOVIDEO' src="/fhem/images/user_icons/icoAUDIOVIDEO.png" alt="icoAUDIOVIDEO" title="icoAUDIOVIDEO"> <span>MULTIMEDIA</span></a></div></td>
</tr>
<tr class="sel"><td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr><td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
<tr><td><div class="menu_Schaltuhren"><a onClick="location.href='/fhem?room=Schaltuhren'"><img class='icon icoUhr' src="/fhem/images/default/icoUhr.png" alt="icoUhr" title="icoUhr"> <span>Schaltuhren</span></a></div></td>
</tr>
<tr><td><div class="menu_Z__hler"><a onClick="location.href='/fhem?room=Z%c3%a4hler'"><img class='icon icoZAEHLER' src="/fhem/images/user_icons/icoZAEHLER.png" alt="icoZAEHLER" title="icoZAEHLER"> <span>Zähler</span></a></div></td>
</tr>
<tr><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock2">
<tr><td><div class="menu_Logfile"><a onClick="location.href='/fhem/FileLog_logWrapper?dev=Logfile&type=text&file=fhem-2022-09.log'"><span>Logfile</span></a></div></td>
</tr>
<tr><td><div><a href='/fhem/docs/commandref.html' target="_blank"><span>Commandref</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.de/fhem.html#Documentation' target="_blank"><span>Remote doc</span></a></div></td>
</tr>
<tr><td><div class="menu_Edit_files"><a onClick="location.href='/fhem?cmd=style%20list'"><span>Edit files</span></a></div></td>
</tr>
<tr><td><div class="menu_Select_style"><a onClick="location.href='/fhem?cmd=style%20select'"><span>Select style</span></a></div></td>
</tr>
<tr><td><div class="menu_Event_monitor"><a onClick="location.href='/fhem?cmd=style%20eventMonitor'"><span>Event monitor</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock3">
<tr><td><div><a href='http://fhem.de' ><span>fhem.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://culfw.de' ><span>
culfw.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem?cmd=style%20iconFor' ><span>
Icons</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________restart"><a onClick="location.href='/fhem?cmd=shutdown+restart&fwcsrf=csrf_932432427076413'"><span>
restart</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadcfg"><a onClick="location.href='/fhem?cmd=rereadcfg&fwcsrf=csrf_932432427076413'"><span>
rereadcfg</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadicons"><a onClick="location.href='/fhem?cmd=set WEB rereadicons&fwcsrf=csrf_932432427076413'"><span>
rereadicons</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem/ftui/index.html' ><span>
FTUI</span></a></div></td>
</tr>
</table></td></tr>
</table>
</div>
</div>

</syntaxhighlight>
</div></div>

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi; # alle nicht Buchstaben und Ziffern werden durch Unterstrich ersetzt, also auch Umlaute
my $icon = FW_iconName($icoName) ? FW_makeImage($icoName,$icoName,"icon")." " : "";
FW_pH $l2, "$icon<span>$l1</span>", 1, $class;

<syntaxhighlight lang="html" line><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</syntaxhighlight>
</div></div>

<syntaxhighlight lang="html" line>
<tr class="sel">
<td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr>
<td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
</syntaxhighlight>

[[Datei:Screenshot FHEM ROOMinROOMIcon.png|mini]]

Man hat also 2 Baustellen. Moechte man ein Icon am uebergoeordneten Menu, muesste man es in die Klasse packen. Bei den Untermenues muss man die Funktion FW_iconName in 01_FHEMWEB.pm patchen.

<syntaxhighlight lang="perl" line>
# check if the icon exists, and if yes, returns its "logical" name;
sub
FW_iconName($) # der Parameter ist falls $l1 nicht irgendwo vorher im Code manipuliert wurde in meinem Beispiel icoSystem->Interfaces. Ein Icon mit diesem Namen gibt es nicht!
{
my ($oname)= @_;
return undef if(!defined($oname));
my $name = $oname;
$name =~ s/@.*//;
foreach my $pe (@FW_iconDirs) {
return $oname if($pe && $FW_icons{$pe} && $FW_icons{$pe}{$name});
}
return undef;
}
</syntaxhighlight>

Auf die Variable
$l1 SYSTEM->Interfaces, bzw. SYSTEM__gt_Interfaces
wird per Regex getestet.

Wenn man also das Attribut so anlegt, klappt es:

attr WEB roomIcons ... SYSTEM-.*Interfaces:icoSYSTEM ...

[[Datei:Screenshot FHEM ROOMinROOMIcon 2.png|mini]]

Das Icon vor den "Stammraum" zu platzieren gestaltet sich etwas schwieriger.

Die passende Stelle in fhemweb.js ist zwar schnell ausgemacht, aber einfach ein Image nach dem <td> einfuegen bringt nicht das genwueschte Ergebnis.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">fhemweb.js (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="javascript" line>
function
FW_treeMenu()
{
var a = $("a").get(0);
var col = 'rgb(39, 135, 38)';
if(window.getComputedStyle && a)
col = getComputedStyle(a,null).getPropertyValue('color');
FW_arrowRight = 'data:image/svg+xml;utf8,<svg viewBox="0 0 1792 1792" xmlns="http://www.w3.org/2000/svg"><path fill="gray" d="M1171 960q0 13-10 23l-466 466q-10 10-23 10t-23-10l-50-50q-10-10-10-23t10-23l393-393-393-393q-10-10-10-23t10-23l50-50q10-10 23-10t23 10l466 466q10 10 10 23z"/></svg>'
.replace('gray', col);
FW_arrowDown =FW_arrowRight.replace('/>',' transform="rotate(90,896,896)"/>');

var fnd;

$("div#menu table.room").each(function(){ // one loop per Block
var t = this, ma = {};
$(t).find("td > div > a > span").each(function(e){
var span = this, spanTxt = $(span).text().replace(/,/g,'');
var ta = spanTxt.split("->");
if(ta.length <= 1)
return;
fnd = true;
var nxt="", lst="", tr=$(span).closest("tr");
for(var i1=0; i1<ta.length-1; i1++) {
nxt += "->"+ta[i1];
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div>#####HIER PLATZ FUER ICON####<a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
ma[nxt] = true;
lst = nxt;
}
$(span).html(ta[ta.length-1]);
$(tr).attr("data-mTree", nxt)
.addClass("menuTree level"+(ta.length-1));
});
});
</syntaxhighlight>
</div></div>

==Patch==
fhemweb.js (FHEM 6.2 ) Zeile 1157

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>"); <<<<<<<<<< zwischen <td><div> und <a href...
}
</syntaxhighlight>

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><img src='/fhem/images/default/ico"+ta[i1]+".png'><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
</syntaxhighlight>

Nicht elegant, aber funktioniert solange ein Icon mit dem gleichen Namen wie der uebergeordnete Raum existiert. Hier SYSTEM also icoSYSTEM.png

=(PGM2) MenuBloecke erweitern=

Ich will meine FTUI-Seiten in PGM2 anbinden und nicht nur den Link einfach unten anhaengen (siehe Screenshot).
FTUI soll in einem eigenen Block stehen.

[[Datei:Screenshot FTUI Link.png|mini]]

Um einen neuen Block zu beginnen ist in der Menuliste ein leerer Eintrag notwendig. Siehe Quellcode in FHEMWEB.pm.

<syntaxhighlight lang="perl">
my @list = (
"Everything", "$FW_ME?room=all",
"", "", <--------------------neuer Block
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", ""); <--------------------neuer Block
</syntaxhighlight>

Leider ist es mir nicht gelungen in der fhem.conf direkt einen leeren Eintrag zu erzwingen, daher mein Umweg ueber einen Platzhalter (NEWBLOCK)

<syntaxhighlight lang="perl">
attr WEB menuEntries fhem.de,http://fhem.de,\
culfw.de,http://culfw.de,\
Icons,http://fhem.clx.local:8083/fhem?cmd=style%20iconFor,\
restart,cmd=shutdown+restart,\
rereadcfg,cmd=rereadcfg,\
rereadicons,cmd=set WEB rereadicons,\
NEWBLOCK,NEWBLOCK,\
FTUI,http://fhem.clx.local:8083/fhem/ftui/index.html
</syntaxhighlight>

==Patch==
FHEM/01_FHEMWEB.pm Version 6.2 Zeile 1803 (Nachtrag: In Version 6.3 ist es Zeile 1815)

[[Datei:Screenshot Blockbuilding.png|mini]]
<syntaxhighlight lang="perl">
my @me = split(",", AttrVal($FW_wname, "menuEntries", ""));
push @list, @me, "", "" if(@me);

===============================snip==================================================
for(my $idx = 0; $idx < @list; $idx++) {
if ( $list[$idx] =~ m/NEWBLOCK/ ) {
splice @list, $idx, 1,("");
}
}

splice @list, 6, 0, ("",""); # fuegt ein Blockende nach Logfile ein
===============================snip==================================================

my $lastname = ","; <<<<<< neu in Version 6.2
for(my $idx = 0; $idx < @list; $idx+= 2) {
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx];
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}
</syntaxhighlight>

Nach dem Patch einen Restart mit
systemctl restart fhem
durchfuehren.

=Eventlog=

Ich habe das Problem, dass das KM271 Logomatic 2107 Modul einfach zu geschschwaetzig ist und zudem auch noch ERR-Eintraege produziert, die ich nicht mitloggen moechte.

2023-12-24 09:24:40 KM271 KM271 ERR_Fehlerspeicher1: Code 01 (+): 09:04Uhr vor 68 Tagen | (-): 195:124Uhr vor 0 Tagen

Derzeit nutze ich das Filelog.

define Logfile FileLog /var/log/fhem/fhem-%Y-%m.log fakelog

Dabei bin ueber den Eintrag fakelog gestolpert, mit dem ich irgendwie nix mehr anfangen konnte. Habe ich vermutlich mit CopyPaste aus einer Beispiel-Conf uebernommen.

Folgende [https://forum.fhem.de/index.php?topic=95689.0 Seite] brachte Licht in's Dunkel.

Das ist die Syntax des Logfile Devices.

define <name> FileLog <filename> <regexp> [readonly]

Daraus kann man ableiten das der Begriff fakelog einen regulaeren Ausdruck darstellt. Irgendjemand hat sich den Begriff mal ausgedacht, um den notwendigen Parameter mit einem Suchfilter zu belegen, der niemals eintritt.

Ein anderer Zeitgenosse hat jetzt genau diesen Begriff als Suchfilter in seiner Wirkung begrenzt.[https://forum.fhem.de/index.php/topic,95351]
Dies wurde mit dem Update vom 05. Januar 2019 wirksam (Rudi hat im Januar update das controlset disabled; Boeser Rudi)

Mit dem folgenden kleinen patch werden set, Regexp parts und Create SVG plot für fakelog nicht mehr angezeigt. meiner meinung nach ist nichts davon sinnvoll und verhindert so fehlbedienung. Ich würde gerne ein solches fakelog device dann auch für die anzeige der alexa-fhem logs nutzen statt den anzeige teil doppelt zu implementieren. aber mit den vielen knöpfen ist das eine mögliche fehlerquelle :)

Will man wieder den alten Zustand herstellen, muss man sich nur einen neuen Suchfilter, der nie zutrifft, ausdenken.

Aber nun zum eigentlichen Problem.
Ein guter Hinweis ist [https://forum.fhem.de/index.php?topic=51611.0 hier]

Wenn bestimmte Zeilen nicht in die Logdatei geschrieben werden sollen, ist das Attribut ignoreRegexp hilfreich. Wenn beispielsweise alle Zeilen, die die Zeichenfolge "AbCd" oder "CdEf" enthalten nicht geloggt werden sollen, dann wäre

Code Auswählen
attr <log-name> ignoreRegexp .*AbCd.*|.*CdEf.*
eine Attributdefinition, die das ermöglicht.

Dies bezieht sich aber nur auf normale FileLog-Instanzen. Falls Events aus dem globalen FHEM-Logfile ausgeschlossen werden sollen, muss man das Attribut in global angeben. (Zusammenhang siehe #Globale Logdatei)

Code Auswählen
attr global ignoreRegexp .*AbCd.*|.*CdEf.*

=KNX Toggle=
Um einen toogle z.B. auf einem Licht hinzubekommen.

set L_Bar_Auszen g1 toggle

ist es notwendig das Attribut KNX_TOGGLE zu setzen.

attr KNX_TOGGLE L_Bar_Auszen:state

=<span id="RFC"></span>Request for Comments=

<comments />

(FHEM) Stolperfallen

2026-04-11T06:47:50Z

Chris T. Ludwig: /* Eventlog */

=(PGM2) RoomIcons bei Untermenues=
Hab mal wieder einen Volltreffer gelandet. Weil die Raeume im FHEMWEB zu viele wurden, aber auch nicht mit "hiddenroom" unterdrueckt werden sollten. Wollte ich mal 'Room in Room' aussprobieren.
Leider scheint das nicht zu funktionieren (Stand fhem 6.0). Aus der Commandref geht eine Alternative hervor. Und zwar, wenn man im Raumnamen ein '->' verwendet, fuehrt das dazu, dass im FHEM-Roommenue
aufklappbare Unterraeume (die nach dem ->) angezeigt werden. Man kann also keinen kompletten bestehenden Raum einem anderen Raum zuordnen, sondern man ist gezwungen alle Devices den neuen Raumnamen zuzuordnen.
Ein unschoener Effekt ist zudem, dass der uebergeordnete Raumname kein Icon mehr hat.

Dies bestatigt diese [https://forum.fhem.de/index.php?topic=91800.0 Forums-Nachfrage].

Ein Blick in den Quellcode von 01_FHEMWEB.pm zeigt:
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">01-FHEMWEB.pm (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="perl" line>
##########################
# Rooms and other links
foreach my $r (@FW_roomsArr) { # Das Array mit den Raumnamen wird nacheinander durchlaufen; In der Variablen r steht der aktuell zu pruefende Raumname
next if($r eq "hidden" || $FW_hiddenroom{$r}); # Ist der Raum hidden geh zu naechsten = tue nichts mit diesem Raum
$FW_room = AttrVal($FW_wname, "defaultRoom", $r)
if(!$FW_room && $FW_ss);
if(my $devspec = $FW_extraRooms{$r}) {
my $r = $r;
$r =~ s/ / /g; # Ersetze alle NoBreakSpaces durch Leerzeichen
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($devspec); # Da habe ich noch keine Idee zu
} else {
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($r);
}

}
my $sfx = AttrVal("global", "language", "EN");
$sfx = ($sfx eq "EN" ? "" : "_$sfx"); # wenn die eingestellte Sprache EN ist , dann ist sfx leer; es wird also z.B: an den Dateinamen commandref nichts angehaengt (sfx steht fuer suffix)
my @list = ( # das ist wohl die Standard Ausgangsliste; interassant: Everything gehoert zum Raummenue und der Rest zum (Name?)-Menue darunter
"Everything", "$FW_ME?room=all",
"", "",
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", "");
my $lastname = ","; # Avoid double "".

my $lfn = "Logfile";
if($defs{$lfn}) { # Add the current Logfile to the list if defined
my @l = FW_fileList($defs{$lfn}{logfile},1);
my $fn = pop @l;
splice @list, 4,0, ("Logfile",
"$FW_ME/FileLog_logWrapper?dev=$lfn&type=text&file=$fn"); # fuege den Logfile-Eintrag vor dem Eintrag Commandref ein (wenn definiert)
}
# die menuEntries sind der dritte Block (Rooms, (Name?)-Menue, menuEntries)
my @me = split(",", AttrVal($FW_wname, "menuEntries", "")); # die menuEntries sind eine komma-separierte Liste von Eintraegen der Art Menuname,Kommando
push @list, @me, "", "" if(@me); # Die Eintragungen werden angehaengt "","" ist jeweils der Block-Abschluss, bzw. Separator

for(my $idx = 0; $idx < @list; $idx+= 2) { # haenge die Kommandoliste an die Raumliste an
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx]; # in list1 stehen die Menunamen und in list2 die Aktionen
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}

FW_pO "<div id=\"menu\">"; # hier geht's dann los mit dem Zusammenbau der HTML-Seite (siehe unten)
FW_pO "<table>";
if($FW_ss) { # Make a selection sensitive dropdown list # $FW_ss also '''F'''HEM'''W'''EB '''s'''ensitive '''s'''election auf einem '''S'''mall '''S'''creen
FW_pO "<tr><td><select OnChange=\"location.href=" .
"this.options[this.selectedIndex].value\">";
foreach(my $idx = 0; $idx < @list1; $idx++) {
next if(!$list1[$idx]);
my $sel = ($list1[$idx] eq $FW_room ? " selected=\"selected\"" : "");
FW_pO "<option value='$list2[$idx]'$sel>$list1[$idx]</option>";
}
FW_pO "</select></td>";
FW_pO "</tr>";

} else {

my $tblnr = 1;
my $roomEscaped = FW_htmlEscape($FW_room); # ersetzte alle (& < > ' (\n)) aus dem aktuellen (?) Raumnamen, wird allerdings nie mehr verwendet
my $current;
$current = "$FW_ME?room=".urlEncode($FW_room) if($FW_room);
$current = "$FW_ME?cmd=".urlEncode($cmd) if($cmd);
foreach(my $idx = 0; $idx < @list1; $idx++) { # jetzt durchlaufe die gesamte Liste mit allen Menueintraegen und baue die HTML-Seite (roomBlock1-3)
my ($l1, $l2) = ($list1[$idx], $list2[$idx]);
if(!$l1) {
FW_pO "</table></td></tr>" if($idx); # die Raumbloecke sind eine Tabelle in der Tabelle menu, diese Table-Ende wird nach jedem Block (Eintrag "","") ausgegeben. Am Anfang ist $idx noch 0, dann also nicht.
if($idx<int(@list1)-1) {
FW_pO "<tr><td><table class=\"room roomBlock$tblnr\">"; # hier waere es auch moeglich durch einfuegen eines leeren/speziellen Eintrags einen neunen Block zu generieren
$tblnr++;
}

} else { # hier kommt jetzt der aktuell interessante Teil
FW_pF "<tr%s>", ($current && $current eq $l2) ? " class=\"sel\"" : ""; # FW_pF ist eine formatierte Ausgabe

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi;

# image tag if we have an icon, else empty
my $icoName = "ico$l1";
map { my ($n,$v) = split(":",$_); $icoName=$v if($l1 =~ m/^$n$/); } # die roomOcons sind eine Leerzeichen-getrennte Liste von Raumname:IconName $n:$v
split(" ", AttrVal($FW_wname, "roomIcons", ""));
my $icon = FW_iconName($icoName) ?
FW_makeImage($icoName,$icoName,"icon")." " : "";

if($l1 eq "Save config") { # Spezialbehandlung des Menueintrags
$l1 .= '</span></a> '.
'<a id="saveCheck" class="changed" style="visibility:'.
(int(@structChangeHist) ? 'visible' : 'hidden').'"><span>?';
}

# Force external browser if FHEMWEB is installed as an offline app.
my $target = ''; # Forum 33066, 39854
$target = 'target="_blank"' if($l2 =~ s/^$FW_ME\/\+/$FW_ME\//);
$target = 'target="_blank"' if($l2 =~ m/commandref|fhem.de.fhem.html/);
if($l2 =~ m/.html$/ || $l2 =~ m/^(http|javascript)/ || length($target)){ # wenn das Kommando auf .html endet oder mit http oder javascript beginnt target definiert (siehe die beiden Zeilen vorher) ist, dann mach aus dem Komando einen Link
FW_pO "<td><div><a href='$l2' $target>$icon<span>$l1</span></a>".
"</div></td>";
} else {
FW_pH $l2, "$icon<span>$l1</span>", 1, $class; # ein bisschen merkwuerdig, aber ab im "normalfall" wird alles ab <td> zwischen </td> durch FW_pH ausgegeben, siehe unten Erlaeuterung
}

FW_pO "</tr>";
}
}

}
FW_pO "</table>";
FW_pO "</div>";
FW_pO "</div>" if($hasMenuScroll);
</syntaxhighlight>
</div></div>

Bei mir sieht das Ergebnis dann so aus.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Quellcode fhem.html (Auszug roomBlock1-3)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="html" line>
<div id="menuScrollArea">
<div><a onClick="location.href='/fhem?'"><div id="logo"></div></a></div>
<div id="menu">
<table>
<tr><td><table class="room roomBlock1">
<tr><td><div class="menu_LEUCHTEN"><a onClick="location.href='/fhem?room=LEUCHTEN'"><img class='icon icoBELEUCHTUNG' src="/fhem/images/default/icoBELEUCHTUNG.png" alt="icoBELEUCHTUNG" title="icoBELEUCHTUNG"> <span>LEUCHTEN</span></a></div></td>
</tr>
<tr><td><div class="menu_ROLLLADEN"><a onClick="location.href='/fhem?room=ROLLLADEN'"><img class='icon icoROLLLADEN' src="/fhem/images/user_icons/icoROLLLADEN.png" alt="icoROLLLADEN" title="icoROLLLADEN"> <span>ROLLLADEN</span></a></div></td>
</tr>
<tr><td><div class="menu_AUSSEN"><a onClick="location.href='/fhem?room=AUSSEN'"><img class='icon icoAUSSEN' src="/fhem/images/default/icoAUSSEN.png" alt="icoAUSSEN" title="icoAUSSEN"> <span>AUSSEN</span></a></div></td>
</tr>
<tr><td><div class="menu_KLIMA"><a onClick="location.href='/fhem?room=KLIMA'"><img class='icon icoTemp' src="/fhem/images/default/icoTemp.png" alt="icoTemp" title="icoTemp"> <span>KLIMA</span></a></div></td>
</tr>
<tr><td><div class="menu_HAUST__R"><a onClick="location.href='/fhem?room=HAUST%c3%9cR'"><img class='icon icoHouse' src="/fhem/images/default/icoHouse.png" alt="icoHouse" title="icoHouse"> <span>HAUSTÜR</span></a></div></td>
</tr>
<tr><td><div class="menu_HEIZUNG"><a onClick="location.href='/fhem?room=HEIZUNG'"><img class='icon icoHEIZUNG' src="/fhem/images/default/icoHEIZUNG.png" alt="icoHEIZUNG" title="icoHEIZUNG"> <span>HEIZUNG</span></a></div></td>
</tr>
<tr><td><div class="menu_MULTIMEDIA"><a onClick="location.href='/fhem?room=MULTIMEDIA'"><img class='icon icoAUDIOVIDEO' src="/fhem/images/user_icons/icoAUDIOVIDEO.png" alt="icoAUDIOVIDEO" title="icoAUDIOVIDEO"> <span>MULTIMEDIA</span></a></div></td>
</tr>
<tr class="sel"><td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr><td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
<tr><td><div class="menu_Schaltuhren"><a onClick="location.href='/fhem?room=Schaltuhren'"><img class='icon icoUhr' src="/fhem/images/default/icoUhr.png" alt="icoUhr" title="icoUhr"> <span>Schaltuhren</span></a></div></td>
</tr>
<tr><td><div class="menu_Z__hler"><a onClick="location.href='/fhem?room=Z%c3%a4hler'"><img class='icon icoZAEHLER' src="/fhem/images/user_icons/icoZAEHLER.png" alt="icoZAEHLER" title="icoZAEHLER"> <span>Zähler</span></a></div></td>
</tr>
<tr><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock2">
<tr><td><div class="menu_Logfile"><a onClick="location.href='/fhem/FileLog_logWrapper?dev=Logfile&type=text&file=fhem-2022-09.log'"><span>Logfile</span></a></div></td>
</tr>
<tr><td><div><a href='/fhem/docs/commandref.html' target="_blank"><span>Commandref</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.de/fhem.html#Documentation' target="_blank"><span>Remote doc</span></a></div></td>
</tr>
<tr><td><div class="menu_Edit_files"><a onClick="location.href='/fhem?cmd=style%20list'"><span>Edit files</span></a></div></td>
</tr>
<tr><td><div class="menu_Select_style"><a onClick="location.href='/fhem?cmd=style%20select'"><span>Select style</span></a></div></td>
</tr>
<tr><td><div class="menu_Event_monitor"><a onClick="location.href='/fhem?cmd=style%20eventMonitor'"><span>Event monitor</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock3">
<tr><td><div><a href='http://fhem.de' ><span>fhem.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://culfw.de' ><span>
culfw.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem?cmd=style%20iconFor' ><span>
Icons</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________restart"><a onClick="location.href='/fhem?cmd=shutdown+restart&fwcsrf=csrf_932432427076413'"><span>
restart</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadcfg"><a onClick="location.href='/fhem?cmd=rereadcfg&fwcsrf=csrf_932432427076413'"><span>
rereadcfg</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadicons"><a onClick="location.href='/fhem?cmd=set WEB rereadicons&fwcsrf=csrf_932432427076413'"><span>
rereadicons</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem/ftui/index.html' ><span>
FTUI</span></a></div></td>
</tr>
</table></td></tr>
</table>
</div>
</div>

</syntaxhighlight>
</div></div>

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi; # alle nicht Buchstaben und Ziffern werden durch Unterstrich ersetzt, also auch Umlaute
my $icon = FW_iconName($icoName) ? FW_makeImage($icoName,$icoName,"icon")." " : "";
FW_pH $l2, "$icon<span>$l1</span>", 1, $class;

<syntaxhighlight lang="html" line><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</syntaxhighlight>
</div></div>

<syntaxhighlight lang="html" line>
<tr class="sel">
<td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr>
<td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
</syntaxhighlight>

[[Datei:Screenshot FHEM ROOMinROOMIcon.png|mini]]

Man hat also 2 Baustellen. Moechte man ein Icon am uebergoeordneten Menu, muesste man es in die Klasse packen. Bei den Untermenues muss man die Funktion FW_iconName in 01_FHEMWEB.pm patchen.

<syntaxhighlight lang="perl" line>
# check if the icon exists, and if yes, returns its "logical" name;
sub
FW_iconName($) # der Parameter ist falls $l1 nicht irgendwo vorher im Code manipuliert wurde in meinem Beispiel icoSystem->Interfaces. Ein Icon mit diesem Namen gibt es nicht!
{
my ($oname)= @_;
return undef if(!defined($oname));
my $name = $oname;
$name =~ s/@.*//;
foreach my $pe (@FW_iconDirs) {
return $oname if($pe && $FW_icons{$pe} && $FW_icons{$pe}{$name});
}
return undef;
}
</syntaxhighlight>

Auf die Variable
$l1 SYSTEM->Interfaces, bzw. SYSTEM__gt_Interfaces
wird per Regex getestet.

Wenn man also das Attribut so anlegt, klappt es:

attr WEB roomIcons ... SYSTEM-.*Interfaces:icoSYSTEM ...

[[Datei:Screenshot FHEM ROOMinROOMIcon 2.png|mini]]

Das Icon vor den "Stammraum" zu platzieren gestaltet sich etwas schwieriger.

Die passende Stelle in fhemweb.js ist zwar schnell ausgemacht, aber einfach ein Image nach dem <td> einfuegen bringt nicht das genwueschte Ergebnis.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">fhemweb.js (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="javascript" line>
function
FW_treeMenu()
{
var a = $("a").get(0);
var col = 'rgb(39, 135, 38)';
if(window.getComputedStyle && a)
col = getComputedStyle(a,null).getPropertyValue('color');
FW_arrowRight = 'data:image/svg+xml;utf8,<svg viewBox="0 0 1792 1792" xmlns="http://www.w3.org/2000/svg"><path fill="gray" d="M1171 960q0 13-10 23l-466 466q-10 10-23 10t-23-10l-50-50q-10-10-10-23t10-23l393-393-393-393q-10-10-10-23t10-23l50-50q10-10 23-10t23 10l466 466q10 10 10 23z"/></svg>'
.replace('gray', col);
FW_arrowDown =FW_arrowRight.replace('/>',' transform="rotate(90,896,896)"/>');

var fnd;

$("div#menu table.room").each(function(){ // one loop per Block
var t = this, ma = {};
$(t).find("td > div > a > span").each(function(e){
var span = this, spanTxt = $(span).text().replace(/,/g,'');
var ta = spanTxt.split("->");
if(ta.length <= 1)
return;
fnd = true;
var nxt="", lst="", tr=$(span).closest("tr");
for(var i1=0; i1<ta.length-1; i1++) {
nxt += "->"+ta[i1];
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div>#####HIER PLATZ FUER ICON####<a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
ma[nxt] = true;
lst = nxt;
}
$(span).html(ta[ta.length-1]);
$(tr).attr("data-mTree", nxt)
.addClass("menuTree level"+(ta.length-1));
});
});
</syntaxhighlight>
</div></div>

==Patch==
fhemweb.js (FHEM 6.2 ) Zeile 1157

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>"); <<<<<<<<<< zwischen <td><div> und <a href...
}
</syntaxhighlight>

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><img src='/fhem/images/default/ico"+ta[i1]+".png'><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
</syntaxhighlight>

Nicht elegant, aber funktioniert solange ein Icon mit dem gleichen Namen wie der uebergeordnete Raum existiert. Hier SYSTEM also icoSYSTEM.png

=(PGM2) MenuBloecke erweitern=

Ich will meine FTUI-Seiten in PGM2 anbinden und nicht nur den Link einfach unten anhaengen (siehe Screenshot).
FTUI soll in einem eigenen Block stehen.

[[Datei:Screenshot FTUI Link.png|mini]]

Um einen neuen Block zu beginnen ist in der Menuliste ein leerer Eintrag notwendig. Siehe Quellcode in FHEMWEB.pm.

<syntaxhighlight lang="perl">
my @list = (
"Everything", "$FW_ME?room=all",
"", "", <--------------------neuer Block
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", ""); <--------------------neuer Block
</syntaxhighlight>

Leider ist es mir nicht gelungen in der fhem.conf direkt einen leeren Eintrag zu erzwingen, daher mein Umweg ueber einen Platzhalter (NEWBLOCK)

<syntaxhighlight lang="perl">
attr WEB menuEntries fhem.de,http://fhem.de,\
culfw.de,http://culfw.de,\
Icons,http://fhem.clx.local:8083/fhem?cmd=style%20iconFor,\
restart,cmd=shutdown+restart,\
rereadcfg,cmd=rereadcfg,\
rereadicons,cmd=set WEB rereadicons,\
NEWBLOCK,NEWBLOCK,\
FTUI,http://fhem.clx.local:8083/fhem/ftui/index.html
</syntaxhighlight>

==Patch==
FHEM/01_FHEMWEB.pm Version 6.2 Zeile 1803 (Nachtrag: In Version 6.3 ist es Zeile 1815)

[[Datei:Screenshot Blockbuilding.png|mini]]
<syntaxhighlight lang="perl">
my @me = split(",", AttrVal($FW_wname, "menuEntries", ""));
push @list, @me, "", "" if(@me);

===============================snip==================================================
for(my $idx = 0; $idx < @list; $idx++) {
if ( $list[$idx] =~ m/NEWBLOCK/ ) {
splice @list, $idx, 1,("");
}
}

splice @list, 6, 0, ("",""); # fuegt ein Blockende nach Logfile ein
===============================snip==================================================

my $lastname = ","; <<<<<< neu in Version 6.2
for(my $idx = 0; $idx < @list; $idx+= 2) {
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx];
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}
</syntaxhighlight>

Nach dem Patch einen Restart mit
systemctl restart fhem
durchfuehren.

=Eventlog=

Ich habe das Problem, dass das KM271 Logomatic 2107 Modul einfach zu geschschwaetzig ist und zudem auch noch ERR-Eintraege produziert, die ich nicht mitloggen moechte.

2023-12-24 09:24:40 KM271 KM271 ERR_Fehlerspeicher1: Code 01 (+): 09:04Uhr vor 68 Tagen | (-): 195:124Uhr vor 0 Tagen

Derzeit nutze ich das Filelog.

define Logfile FileLog /var/log/fhem/fhem-%Y-%m.log fakelog

Dabei bin ueber den Eintrag fakelog gestolpert, mit dem ich irgendwie nix mehr anfangen konnte. Habe ich vermutlich mit CopyPaste aus einer Beispiel-Conf uebernommen.

Folgende [https://forum.fhem.de/index.php?topic=95689.0 Seite] brachte Licht in's Dunkel.

Das ist die Syntax des Logfile Devices.

define <name> FileLog <filename> <regexp> [readonly]

Daraus kann man ableiten das der Begriff fakelog einen regulaeren Ausdruck darstellt. Irgendjemand hat sich den Begriff mal ausgedacht, um den notwendigen Parameter mit einem Suchfilter zu belegen, der niemals eintritt.

Ein anderer Zeitgenosse hat jetzt genau diesen Begriff als Suchfilter in seiner Wirkung begrenzt.[https://forum.fhem.de/index.php/topic,95351]
Dies wurde mit dem Update vom 05. Januar 2019 wirksam (Rudi hat im Januar update das controlset disabled; Boeser Rudi)

Mit dem folgenden kleinen patch werden set, Regexp parts und Create SVG plot für fakelog nicht mehr angezeigt. meiner meinung nach ist nichts davon sinnvoll und verhindert so fehlbedienung. Ich würde gerne ein solches fakelog device dann auch für die anzeige der alexa-fhem logs nutzen statt den anzeige teil doppelt zu implementieren. aber mit den vielen knöpfen ist das eine mögliche fehlerquelle :)

Will man wieder den alten Zustand herstellen, muss man sich nur einen neuen Suchfilter, der nie zutrifft, ausdenken.

Aber nun zum eigentlichen Problem.
Ein guter Hinweis ist [https://forum.fhem.de/index.php?topic=51611.0 hier]

Wenn bestimmte Zeilen nicht in die Logdatei geschrieben werden sollen, ist das Attribut ignoreRegexp hilfreich. Wenn beispielsweise alle Zeilen, die die Zeichenfolge "AbCd" oder "CdEf" enthalten nicht geloggt werden sollen, dann wäre

Code Auswählen
attr <log-name> ignoreRegexp .*AbCd.*|.*CdEf.*
eine Attributdefinition, die das ermöglicht.

Dies bezieht sich aber nur auf normale FileLog-Instanzen. Falls Events aus dem globalen FHEM-Logfile ausgeschlossen werden sollen, muss man das Attribut in global angeben. (Zusammenhang siehe #Globale Logdatei)

Code Auswählen
attr global ignoreRegexp .*AbCd.*|.*CdEf.*

=KNX Toggle=
Um einen toogle z.B. auf einem Licht hinzubekommen.

set L_Bar_Auszen g1 toggle

ist es notzwendig das Attribut KNX_TOGGLE zu setzen.

attr KNX_TOGGLE L_Bar_Auszen:state

=<span id="RFC"></span>Request for Comments=

<comments />

(FHEM) Stolperfallen

2026-04-11T06:46:12Z

Chris T. Ludwig: /* Eventlog */

=(PGM2) RoomIcons bei Untermenues=
Hab mal wieder einen Volltreffer gelandet. Weil die Raeume im FHEMWEB zu viele wurden, aber auch nicht mit "hiddenroom" unterdrueckt werden sollten. Wollte ich mal 'Room in Room' aussprobieren.
Leider scheint das nicht zu funktionieren (Stand fhem 6.0). Aus der Commandref geht eine Alternative hervor. Und zwar, wenn man im Raumnamen ein '->' verwendet, fuehrt das dazu, dass im FHEM-Roommenue
aufklappbare Unterraeume (die nach dem ->) angezeigt werden. Man kann also keinen kompletten bestehenden Raum einem anderen Raum zuordnen, sondern man ist gezwungen alle Devices den neuen Raumnamen zuzuordnen.
Ein unschoener Effekt ist zudem, dass der uebergeordnete Raumname kein Icon mehr hat.

Dies bestatigt diese [https://forum.fhem.de/index.php?topic=91800.0 Forums-Nachfrage].

Ein Blick in den Quellcode von 01_FHEMWEB.pm zeigt:
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">01-FHEMWEB.pm (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="perl" line>
##########################
# Rooms and other links
foreach my $r (@FW_roomsArr) { # Das Array mit den Raumnamen wird nacheinander durchlaufen; In der Variablen r steht der aktuell zu pruefende Raumname
next if($r eq "hidden" || $FW_hiddenroom{$r}); # Ist der Raum hidden geh zu naechsten = tue nichts mit diesem Raum
$FW_room = AttrVal($FW_wname, "defaultRoom", $r)
if(!$FW_room && $FW_ss);
if(my $devspec = $FW_extraRooms{$r}) {
my $r = $r;
$r =~ s/ / /g; # Ersetze alle NoBreakSpaces durch Leerzeichen
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($devspec); # Da habe ich noch keine Idee zu
} else {
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($r);
}

}
my $sfx = AttrVal("global", "language", "EN");
$sfx = ($sfx eq "EN" ? "" : "_$sfx"); # wenn die eingestellte Sprache EN ist , dann ist sfx leer; es wird also z.B: an den Dateinamen commandref nichts angehaengt (sfx steht fuer suffix)
my @list = ( # das ist wohl die Standard Ausgangsliste; interassant: Everything gehoert zum Raummenue und der Rest zum (Name?)-Menue darunter
"Everything", "$FW_ME?room=all",
"", "",
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", "");
my $lastname = ","; # Avoid double "".

my $lfn = "Logfile";
if($defs{$lfn}) { # Add the current Logfile to the list if defined
my @l = FW_fileList($defs{$lfn}{logfile},1);
my $fn = pop @l;
splice @list, 4,0, ("Logfile",
"$FW_ME/FileLog_logWrapper?dev=$lfn&type=text&file=$fn"); # fuege den Logfile-Eintrag vor dem Eintrag Commandref ein (wenn definiert)
}
# die menuEntries sind der dritte Block (Rooms, (Name?)-Menue, menuEntries)
my @me = split(",", AttrVal($FW_wname, "menuEntries", "")); # die menuEntries sind eine komma-separierte Liste von Eintraegen der Art Menuname,Kommando
push @list, @me, "", "" if(@me); # Die Eintragungen werden angehaengt "","" ist jeweils der Block-Abschluss, bzw. Separator

for(my $idx = 0; $idx < @list; $idx+= 2) { # haenge die Kommandoliste an die Raumliste an
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx]; # in list1 stehen die Menunamen und in list2 die Aktionen
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}

FW_pO "<div id=\"menu\">"; # hier geht's dann los mit dem Zusammenbau der HTML-Seite (siehe unten)
FW_pO "<table>";
if($FW_ss) { # Make a selection sensitive dropdown list # $FW_ss also '''F'''HEM'''W'''EB '''s'''ensitive '''s'''election auf einem '''S'''mall '''S'''creen
FW_pO "<tr><td><select OnChange=\"location.href=" .
"this.options[this.selectedIndex].value\">";
foreach(my $idx = 0; $idx < @list1; $idx++) {
next if(!$list1[$idx]);
my $sel = ($list1[$idx] eq $FW_room ? " selected=\"selected\"" : "");
FW_pO "<option value='$list2[$idx]'$sel>$list1[$idx]</option>";
}
FW_pO "</select></td>";
FW_pO "</tr>";

} else {

my $tblnr = 1;
my $roomEscaped = FW_htmlEscape($FW_room); # ersetzte alle (& < > ' (\n)) aus dem aktuellen (?) Raumnamen, wird allerdings nie mehr verwendet
my $current;
$current = "$FW_ME?room=".urlEncode($FW_room) if($FW_room);
$current = "$FW_ME?cmd=".urlEncode($cmd) if($cmd);
foreach(my $idx = 0; $idx < @list1; $idx++) { # jetzt durchlaufe die gesamte Liste mit allen Menueintraegen und baue die HTML-Seite (roomBlock1-3)
my ($l1, $l2) = ($list1[$idx], $list2[$idx]);
if(!$l1) {
FW_pO "</table></td></tr>" if($idx); # die Raumbloecke sind eine Tabelle in der Tabelle menu, diese Table-Ende wird nach jedem Block (Eintrag "","") ausgegeben. Am Anfang ist $idx noch 0, dann also nicht.
if($idx<int(@list1)-1) {
FW_pO "<tr><td><table class=\"room roomBlock$tblnr\">"; # hier waere es auch moeglich durch einfuegen eines leeren/speziellen Eintrags einen neunen Block zu generieren
$tblnr++;
}

} else { # hier kommt jetzt der aktuell interessante Teil
FW_pF "<tr%s>", ($current && $current eq $l2) ? " class=\"sel\"" : ""; # FW_pF ist eine formatierte Ausgabe

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi;

# image tag if we have an icon, else empty
my $icoName = "ico$l1";
map { my ($n,$v) = split(":",$_); $icoName=$v if($l1 =~ m/^$n$/); } # die roomOcons sind eine Leerzeichen-getrennte Liste von Raumname:IconName $n:$v
split(" ", AttrVal($FW_wname, "roomIcons", ""));
my $icon = FW_iconName($icoName) ?
FW_makeImage($icoName,$icoName,"icon")." " : "";

if($l1 eq "Save config") { # Spezialbehandlung des Menueintrags
$l1 .= '</span></a> '.
'<a id="saveCheck" class="changed" style="visibility:'.
(int(@structChangeHist) ? 'visible' : 'hidden').'"><span>?';
}

# Force external browser if FHEMWEB is installed as an offline app.
my $target = ''; # Forum 33066, 39854
$target = 'target="_blank"' if($l2 =~ s/^$FW_ME\/\+/$FW_ME\//);
$target = 'target="_blank"' if($l2 =~ m/commandref|fhem.de.fhem.html/);
if($l2 =~ m/.html$/ || $l2 =~ m/^(http|javascript)/ || length($target)){ # wenn das Kommando auf .html endet oder mit http oder javascript beginnt target definiert (siehe die beiden Zeilen vorher) ist, dann mach aus dem Komando einen Link
FW_pO "<td><div><a href='$l2' $target>$icon<span>$l1</span></a>".
"</div></td>";
} else {
FW_pH $l2, "$icon<span>$l1</span>", 1, $class; # ein bisschen merkwuerdig, aber ab im "normalfall" wird alles ab <td> zwischen </td> durch FW_pH ausgegeben, siehe unten Erlaeuterung
}

FW_pO "</tr>";
}
}

}
FW_pO "</table>";
FW_pO "</div>";
FW_pO "</div>" if($hasMenuScroll);
</syntaxhighlight>
</div></div>

Bei mir sieht das Ergebnis dann so aus.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Quellcode fhem.html (Auszug roomBlock1-3)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="html" line>
<div id="menuScrollArea">
<div><a onClick="location.href='/fhem?'"><div id="logo"></div></a></div>
<div id="menu">
<table>
<tr><td><table class="room roomBlock1">
<tr><td><div class="menu_LEUCHTEN"><a onClick="location.href='/fhem?room=LEUCHTEN'"><img class='icon icoBELEUCHTUNG' src="/fhem/images/default/icoBELEUCHTUNG.png" alt="icoBELEUCHTUNG" title="icoBELEUCHTUNG"> <span>LEUCHTEN</span></a></div></td>
</tr>
<tr><td><div class="menu_ROLLLADEN"><a onClick="location.href='/fhem?room=ROLLLADEN'"><img class='icon icoROLLLADEN' src="/fhem/images/user_icons/icoROLLLADEN.png" alt="icoROLLLADEN" title="icoROLLLADEN"> <span>ROLLLADEN</span></a></div></td>
</tr>
<tr><td><div class="menu_AUSSEN"><a onClick="location.href='/fhem?room=AUSSEN'"><img class='icon icoAUSSEN' src="/fhem/images/default/icoAUSSEN.png" alt="icoAUSSEN" title="icoAUSSEN"> <span>AUSSEN</span></a></div></td>
</tr>
<tr><td><div class="menu_KLIMA"><a onClick="location.href='/fhem?room=KLIMA'"><img class='icon icoTemp' src="/fhem/images/default/icoTemp.png" alt="icoTemp" title="icoTemp"> <span>KLIMA</span></a></div></td>
</tr>
<tr><td><div class="menu_HAUST__R"><a onClick="location.href='/fhem?room=HAUST%c3%9cR'"><img class='icon icoHouse' src="/fhem/images/default/icoHouse.png" alt="icoHouse" title="icoHouse"> <span>HAUSTÜR</span></a></div></td>
</tr>
<tr><td><div class="menu_HEIZUNG"><a onClick="location.href='/fhem?room=HEIZUNG'"><img class='icon icoHEIZUNG' src="/fhem/images/default/icoHEIZUNG.png" alt="icoHEIZUNG" title="icoHEIZUNG"> <span>HEIZUNG</span></a></div></td>
</tr>
<tr><td><div class="menu_MULTIMEDIA"><a onClick="location.href='/fhem?room=MULTIMEDIA'"><img class='icon icoAUDIOVIDEO' src="/fhem/images/user_icons/icoAUDIOVIDEO.png" alt="icoAUDIOVIDEO" title="icoAUDIOVIDEO"> <span>MULTIMEDIA</span></a></div></td>
</tr>
<tr class="sel"><td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr><td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
<tr><td><div class="menu_Schaltuhren"><a onClick="location.href='/fhem?room=Schaltuhren'"><img class='icon icoUhr' src="/fhem/images/default/icoUhr.png" alt="icoUhr" title="icoUhr"> <span>Schaltuhren</span></a></div></td>
</tr>
<tr><td><div class="menu_Z__hler"><a onClick="location.href='/fhem?room=Z%c3%a4hler'"><img class='icon icoZAEHLER' src="/fhem/images/user_icons/icoZAEHLER.png" alt="icoZAEHLER" title="icoZAEHLER"> <span>Zähler</span></a></div></td>
</tr>
<tr><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock2">
<tr><td><div class="menu_Logfile"><a onClick="location.href='/fhem/FileLog_logWrapper?dev=Logfile&type=text&file=fhem-2022-09.log'"><span>Logfile</span></a></div></td>
</tr>
<tr><td><div><a href='/fhem/docs/commandref.html' target="_blank"><span>Commandref</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.de/fhem.html#Documentation' target="_blank"><span>Remote doc</span></a></div></td>
</tr>
<tr><td><div class="menu_Edit_files"><a onClick="location.href='/fhem?cmd=style%20list'"><span>Edit files</span></a></div></td>
</tr>
<tr><td><div class="menu_Select_style"><a onClick="location.href='/fhem?cmd=style%20select'"><span>Select style</span></a></div></td>
</tr>
<tr><td><div class="menu_Event_monitor"><a onClick="location.href='/fhem?cmd=style%20eventMonitor'"><span>Event monitor</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock3">
<tr><td><div><a href='http://fhem.de' ><span>fhem.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://culfw.de' ><span>
culfw.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem?cmd=style%20iconFor' ><span>
Icons</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________restart"><a onClick="location.href='/fhem?cmd=shutdown+restart&fwcsrf=csrf_932432427076413'"><span>
restart</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadcfg"><a onClick="location.href='/fhem?cmd=rereadcfg&fwcsrf=csrf_932432427076413'"><span>
rereadcfg</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadicons"><a onClick="location.href='/fhem?cmd=set WEB rereadicons&fwcsrf=csrf_932432427076413'"><span>
rereadicons</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem/ftui/index.html' ><span>
FTUI</span></a></div></td>
</tr>
</table></td></tr>
</table>
</div>
</div>

</syntaxhighlight>
</div></div>

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi; # alle nicht Buchstaben und Ziffern werden durch Unterstrich ersetzt, also auch Umlaute
my $icon = FW_iconName($icoName) ? FW_makeImage($icoName,$icoName,"icon")." " : "";
FW_pH $l2, "$icon<span>$l1</span>", 1, $class;

<syntaxhighlight lang="html" line><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</syntaxhighlight>
</div></div>

<syntaxhighlight lang="html" line>
<tr class="sel">
<td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr>
<td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
</syntaxhighlight>

[[Datei:Screenshot FHEM ROOMinROOMIcon.png|mini]]

Man hat also 2 Baustellen. Moechte man ein Icon am uebergoeordneten Menu, muesste man es in die Klasse packen. Bei den Untermenues muss man die Funktion FW_iconName in 01_FHEMWEB.pm patchen.

<syntaxhighlight lang="perl" line>
# check if the icon exists, and if yes, returns its "logical" name;
sub
FW_iconName($) # der Parameter ist falls $l1 nicht irgendwo vorher im Code manipuliert wurde in meinem Beispiel icoSystem->Interfaces. Ein Icon mit diesem Namen gibt es nicht!
{
my ($oname)= @_;
return undef if(!defined($oname));
my $name = $oname;
$name =~ s/@.*//;
foreach my $pe (@FW_iconDirs) {
return $oname if($pe && $FW_icons{$pe} && $FW_icons{$pe}{$name});
}
return undef;
}
</syntaxhighlight>

Auf die Variable
$l1 SYSTEM->Interfaces, bzw. SYSTEM__gt_Interfaces
wird per Regex getestet.

Wenn man also das Attribut so anlegt, klappt es:

attr WEB roomIcons ... SYSTEM-.*Interfaces:icoSYSTEM ...

[[Datei:Screenshot FHEM ROOMinROOMIcon 2.png|mini]]

Das Icon vor den "Stammraum" zu platzieren gestaltet sich etwas schwieriger.

Die passende Stelle in fhemweb.js ist zwar schnell ausgemacht, aber einfach ein Image nach dem <td> einfuegen bringt nicht das genwueschte Ergebnis.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">fhemweb.js (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="javascript" line>
function
FW_treeMenu()
{
var a = $("a").get(0);
var col = 'rgb(39, 135, 38)';
if(window.getComputedStyle && a)
col = getComputedStyle(a,null).getPropertyValue('color');
FW_arrowRight = 'data:image/svg+xml;utf8,<svg viewBox="0 0 1792 1792" xmlns="http://www.w3.org/2000/svg"><path fill="gray" d="M1171 960q0 13-10 23l-466 466q-10 10-23 10t-23-10l-50-50q-10-10-10-23t10-23l393-393-393-393q-10-10-10-23t10-23l50-50q10-10 23-10t23 10l466 466q10 10 10 23z"/></svg>'
.replace('gray', col);
FW_arrowDown =FW_arrowRight.replace('/>',' transform="rotate(90,896,896)"/>');

var fnd;

$("div#menu table.room").each(function(){ // one loop per Block
var t = this, ma = {};
$(t).find("td > div > a > span").each(function(e){
var span = this, spanTxt = $(span).text().replace(/,/g,'');
var ta = spanTxt.split("->");
if(ta.length <= 1)
return;
fnd = true;
var nxt="", lst="", tr=$(span).closest("tr");
for(var i1=0; i1<ta.length-1; i1++) {
nxt += "->"+ta[i1];
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div>#####HIER PLATZ FUER ICON####<a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
ma[nxt] = true;
lst = nxt;
}
$(span).html(ta[ta.length-1]);
$(tr).attr("data-mTree", nxt)
.addClass("menuTree level"+(ta.length-1));
});
});
</syntaxhighlight>
</div></div>

==Patch==
fhemweb.js (FHEM 6.2 ) Zeile 1157

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>"); <<<<<<<<<< zwischen <td><div> und <a href...
}
</syntaxhighlight>

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><img src='/fhem/images/default/ico"+ta[i1]+".png'><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
</syntaxhighlight>

Nicht elegant, aber funktioniert solange ein Icon mit dem gleichen Namen wie der uebergeordnete Raum existiert. Hier SYSTEM also icoSYSTEM.png

=(PGM2) MenuBloecke erweitern=

Ich will meine FTUI-Seiten in PGM2 anbinden und nicht nur den Link einfach unten anhaengen (siehe Screenshot).
FTUI soll in einem eigenen Block stehen.

[[Datei:Screenshot FTUI Link.png|mini]]

Um einen neuen Block zu beginnen ist in der Menuliste ein leerer Eintrag notwendig. Siehe Quellcode in FHEMWEB.pm.

<syntaxhighlight lang="perl">
my @list = (
"Everything", "$FW_ME?room=all",
"", "", <--------------------neuer Block
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", ""); <--------------------neuer Block
</syntaxhighlight>

Leider ist es mir nicht gelungen in der fhem.conf direkt einen leeren Eintrag zu erzwingen, daher mein Umweg ueber einen Platzhalter (NEWBLOCK)

<syntaxhighlight lang="perl">
attr WEB menuEntries fhem.de,http://fhem.de,\
culfw.de,http://culfw.de,\
Icons,http://fhem.clx.local:8083/fhem?cmd=style%20iconFor,\
restart,cmd=shutdown+restart,\
rereadcfg,cmd=rereadcfg,\
rereadicons,cmd=set WEB rereadicons,\
NEWBLOCK,NEWBLOCK,\
FTUI,http://fhem.clx.local:8083/fhem/ftui/index.html
</syntaxhighlight>

==Patch==
FHEM/01_FHEMWEB.pm Version 6.2 Zeile 1803 (Nachtrag: In Version 6.3 ist es Zeile 1815)

[[Datei:Screenshot Blockbuilding.png|mini]]
<syntaxhighlight lang="perl">
my @me = split(",", AttrVal($FW_wname, "menuEntries", ""));
push @list, @me, "", "" if(@me);

===============================snip==================================================
for(my $idx = 0; $idx < @list; $idx++) {
if ( $list[$idx] =~ m/NEWBLOCK/ ) {
splice @list, $idx, 1,("");
}
}

splice @list, 6, 0, ("",""); # fuegt ein Blockende nach Logfile ein
===============================snip==================================================

my $lastname = ","; <<<<<< neu in Version 6.2
for(my $idx = 0; $idx < @list; $idx+= 2) {
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx];
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}
</syntaxhighlight>

Nach dem Patch einen Restart mit
systemctl restart fhem
durchfuehren.

=Eventlog=

Ich habe das Problem, dass das KM271 Logomatic 2107 Modul einfach zu geschschwaetzig ist und zudem auch noch ERR-Eintraege produziert, die ich nicht mitloggen moechte.

2023-12-24 09:24:40 KM271 KM271 ERR_Fehlerspeicher1: Code 01 (+): 09:04Uhr vor 68 Tagen | (-): 195:124Uhr vor 0 Tagen

Derzeit nutze ich das Filelog.

define Logfile FileLog /var/log/fhem/fhem-%Y-%m.log fakelog

Dabei bin ueber den Eintrag fakelog gestolpert, mit dem ich irgendwie nix mehr anfangen konnte. Habe ich vermutlich mit CopyPaste aus einer Beispiel-Conf uebernommen.

Folgende [https://forum.fhem.de/index.php?topic=95689.0 Seite] brachte Licht in's Dunkel.

Das ist die Syntax des Logfile Devices.

define <name> FileLog <filename> <regexp> [readonly]

Daraus kann man ableiten das der Begriff fakelog einen regulaeren Ausdruck darstellt. Irgendjemand hat sich den Begriff mal ausgedacht, um den notwendigen Parameter mit einem Suchfilter zu belegen, der niemals eintritt.

Ein anderer Zeitgenosse hat jetzt genau diesen Begriff als Suchfilter in seiner Wirkung begrenzt.[https://forum.fhem.de/index.php/topic,95351]
Dies wurde mit dem Update vom 05. Januar 2019 wirksam (Rudi hat im Januar update das controlset disabled; Boeser Rudi)

Mit dem folgenden kleinen patch werden set, Regexp parts und Create SVG plot für fakelog nicht mehr angezeigt. meiner meinung nach ist nichts davon sinnvoll und verhindert so fehlbedienung. Ich würde gerne ein solches fakelog device dann auch für die anzeige der alexa-fhem logs nutzen statt den anzeige teil doppelt zu implementieren. aber mit den vielen knöpfen ist das eine mögliche fehlerquelle :)

Will man wieder den alten Zustand herstellen, muss man sich nur einen neuen Suchfilter der nie zutrifft ausdenken.

Aber nun zum eigentlichen Problem.
Ein guter Hinweis ist [https://forum.fhem.de/index.php?topic=51611.0 hier]

Wenn bestimmte Zeilen nicht in die Logdatei geschrieben werden sollen, ist das Attribut ignoreRegexp hilfreich. Wenn beispielsweise alle Zeilen, die die Zeichenfolge "AbCd" oder "CdEf" enthalten nicht geloggt werden sollen, dann wäre

Code Auswählen
attr <log-name> ignoreRegexp .*AbCd.*|.*CdEf.*
eine Attributdefinition, die das ermöglicht.

Dies bezieht sich aber nur auf normale FileLog-Instanzen. Falls Events aus dem globalen FHEM-Logfile ausgeschlossen werden sollen, muss man das Attribut in global angeben. (Zusammenhang siehe #Globale Logdatei)

Code Auswählen
attr global ignoreRegexp .*AbCd.*|.*CdEf.*

=KNX Toggle=
Um einen toogle z.B. auf einem Licht hinzubekommen.

set L_Bar_Auszen g1 toggle

ist es notzwendig das Attribut KNX_TOGGLE zu setzen.

attr KNX_TOGGLE L_Bar_Auszen:state

=<span id="RFC"></span>Request for Comments=

<comments />

(FHEM) Stolperfallen

2026-04-11T06:40:07Z

Chris T. Ludwig: /* Patch */

=(PGM2) RoomIcons bei Untermenues=
Hab mal wieder einen Volltreffer gelandet. Weil die Raeume im FHEMWEB zu viele wurden, aber auch nicht mit "hiddenroom" unterdrueckt werden sollten. Wollte ich mal 'Room in Room' aussprobieren.
Leider scheint das nicht zu funktionieren (Stand fhem 6.0). Aus der Commandref geht eine Alternative hervor. Und zwar, wenn man im Raumnamen ein '->' verwendet, fuehrt das dazu, dass im FHEM-Roommenue
aufklappbare Unterraeume (die nach dem ->) angezeigt werden. Man kann also keinen kompletten bestehenden Raum einem anderen Raum zuordnen, sondern man ist gezwungen alle Devices den neuen Raumnamen zuzuordnen.
Ein unschoener Effekt ist zudem, dass der uebergeordnete Raumname kein Icon mehr hat.

Dies bestatigt diese [https://forum.fhem.de/index.php?topic=91800.0 Forums-Nachfrage].

Ein Blick in den Quellcode von 01_FHEMWEB.pm zeigt:
<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">01-FHEMWEB.pm (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="perl" line>
##########################
# Rooms and other links
foreach my $r (@FW_roomsArr) { # Das Array mit den Raumnamen wird nacheinander durchlaufen; In der Variablen r steht der aktuell zu pruefende Raumname
next if($r eq "hidden" || $FW_hiddenroom{$r}); # Ist der Raum hidden geh zu naechsten = tue nichts mit diesem Raum
$FW_room = AttrVal($FW_wname, "defaultRoom", $r)
if(!$FW_room && $FW_ss);
if(my $devspec = $FW_extraRooms{$r}) {
my $r = $r;
$r =~ s/ / /g; # Ersetze alle NoBreakSpaces durch Leerzeichen
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($devspec); # Da habe ich noch keine Idee zu
} else {
push @list1, FW_htmlEscape($r);
push @list2, "$FW_ME?room=".urlEncode($r);
}

}
my $sfx = AttrVal("global", "language", "EN");
$sfx = ($sfx eq "EN" ? "" : "_$sfx"); # wenn die eingestellte Sprache EN ist , dann ist sfx leer; es wird also z.B: an den Dateinamen commandref nichts angehaengt (sfx steht fuer suffix)
my @list = ( # das ist wohl die Standard Ausgangsliste; interassant: Everything gehoert zum Raummenue und der Rest zum (Name?)-Menue darunter
"Everything", "$FW_ME?room=all",
"", "",
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", "");
my $lastname = ","; # Avoid double "".

my $lfn = "Logfile";
if($defs{$lfn}) { # Add the current Logfile to the list if defined
my @l = FW_fileList($defs{$lfn}{logfile},1);
my $fn = pop @l;
splice @list, 4,0, ("Logfile",
"$FW_ME/FileLog_logWrapper?dev=$lfn&type=text&file=$fn"); # fuege den Logfile-Eintrag vor dem Eintrag Commandref ein (wenn definiert)
}
# die menuEntries sind der dritte Block (Rooms, (Name?)-Menue, menuEntries)
my @me = split(",", AttrVal($FW_wname, "menuEntries", "")); # die menuEntries sind eine komma-separierte Liste von Eintraegen der Art Menuname,Kommando
push @list, @me, "", "" if(@me); # Die Eintragungen werden angehaengt "","" ist jeweils der Block-Abschluss, bzw. Separator

for(my $idx = 0; $idx < @list; $idx+= 2) { # haenge die Kommandoliste an die Raumliste an
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx]; # in list1 stehen die Menunamen und in list2 die Aktionen
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}

FW_pO "<div id=\"menu\">"; # hier geht's dann los mit dem Zusammenbau der HTML-Seite (siehe unten)
FW_pO "<table>";
if($FW_ss) { # Make a selection sensitive dropdown list # $FW_ss also '''F'''HEM'''W'''EB '''s'''ensitive '''s'''election auf einem '''S'''mall '''S'''creen
FW_pO "<tr><td><select OnChange=\"location.href=" .
"this.options[this.selectedIndex].value\">";
foreach(my $idx = 0; $idx < @list1; $idx++) {
next if(!$list1[$idx]);
my $sel = ($list1[$idx] eq $FW_room ? " selected=\"selected\"" : "");
FW_pO "<option value='$list2[$idx]'$sel>$list1[$idx]</option>";
}
FW_pO "</select></td>";
FW_pO "</tr>";

} else {

my $tblnr = 1;
my $roomEscaped = FW_htmlEscape($FW_room); # ersetzte alle (& < > ' (\n)) aus dem aktuellen (?) Raumnamen, wird allerdings nie mehr verwendet
my $current;
$current = "$FW_ME?room=".urlEncode($FW_room) if($FW_room);
$current = "$FW_ME?cmd=".urlEncode($cmd) if($cmd);
foreach(my $idx = 0; $idx < @list1; $idx++) { # jetzt durchlaufe die gesamte Liste mit allen Menueintraegen und baue die HTML-Seite (roomBlock1-3)
my ($l1, $l2) = ($list1[$idx], $list2[$idx]);
if(!$l1) {
FW_pO "</table></td></tr>" if($idx); # die Raumbloecke sind eine Tabelle in der Tabelle menu, diese Table-Ende wird nach jedem Block (Eintrag "","") ausgegeben. Am Anfang ist $idx noch 0, dann also nicht.
if($idx<int(@list1)-1) {
FW_pO "<tr><td><table class=\"room roomBlock$tblnr\">"; # hier waere es auch moeglich durch einfuegen eines leeren/speziellen Eintrags einen neunen Block zu generieren
$tblnr++;
}

} else { # hier kommt jetzt der aktuell interessante Teil
FW_pF "<tr%s>", ($current && $current eq $l2) ? " class=\"sel\"" : ""; # FW_pF ist eine formatierte Ausgabe

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi;

# image tag if we have an icon, else empty
my $icoName = "ico$l1";
map { my ($n,$v) = split(":",$_); $icoName=$v if($l1 =~ m/^$n$/); } # die roomOcons sind eine Leerzeichen-getrennte Liste von Raumname:IconName $n:$v
split(" ", AttrVal($FW_wname, "roomIcons", ""));
my $icon = FW_iconName($icoName) ?
FW_makeImage($icoName,$icoName,"icon")." " : "";

if($l1 eq "Save config") { # Spezialbehandlung des Menueintrags
$l1 .= '</span></a> '.
'<a id="saveCheck" class="changed" style="visibility:'.
(int(@structChangeHist) ? 'visible' : 'hidden').'"><span>?';
}

# Force external browser if FHEMWEB is installed as an offline app.
my $target = ''; # Forum 33066, 39854
$target = 'target="_blank"' if($l2 =~ s/^$FW_ME\/\+/$FW_ME\//);
$target = 'target="_blank"' if($l2 =~ m/commandref|fhem.de.fhem.html/);
if($l2 =~ m/.html$/ || $l2 =~ m/^(http|javascript)/ || length($target)){ # wenn das Kommando auf .html endet oder mit http oder javascript beginnt target definiert (siehe die beiden Zeilen vorher) ist, dann mach aus dem Komando einen Link
FW_pO "<td><div><a href='$l2' $target>$icon<span>$l1</span></a>".
"</div></td>";
} else {
FW_pH $l2, "$icon<span>$l1</span>", 1, $class; # ein bisschen merkwuerdig, aber ab im "normalfall" wird alles ab <td> zwischen </td> durch FW_pH ausgegeben, siehe unten Erlaeuterung
}

FW_pO "</tr>";
}
}

}
FW_pO "</table>";
FW_pO "</div>";
FW_pO "</div>" if($hasMenuScroll);
</syntaxhighlight>
</div></div>

Bei mir sieht das Ergebnis dann so aus.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">Quellcode fhem.html (Auszug roomBlock1-3)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="html" line>
<div id="menuScrollArea">
<div><a onClick="location.href='/fhem?'"><div id="logo"></div></a></div>
<div id="menu">
<table>
<tr><td><table class="room roomBlock1">
<tr><td><div class="menu_LEUCHTEN"><a onClick="location.href='/fhem?room=LEUCHTEN'"><img class='icon icoBELEUCHTUNG' src="/fhem/images/default/icoBELEUCHTUNG.png" alt="icoBELEUCHTUNG" title="icoBELEUCHTUNG"> <span>LEUCHTEN</span></a></div></td>
</tr>
<tr><td><div class="menu_ROLLLADEN"><a onClick="location.href='/fhem?room=ROLLLADEN'"><img class='icon icoROLLLADEN' src="/fhem/images/user_icons/icoROLLLADEN.png" alt="icoROLLLADEN" title="icoROLLLADEN"> <span>ROLLLADEN</span></a></div></td>
</tr>
<tr><td><div class="menu_AUSSEN"><a onClick="location.href='/fhem?room=AUSSEN'"><img class='icon icoAUSSEN' src="/fhem/images/default/icoAUSSEN.png" alt="icoAUSSEN" title="icoAUSSEN"> <span>AUSSEN</span></a></div></td>
</tr>
<tr><td><div class="menu_KLIMA"><a onClick="location.href='/fhem?room=KLIMA'"><img class='icon icoTemp' src="/fhem/images/default/icoTemp.png" alt="icoTemp" title="icoTemp"> <span>KLIMA</span></a></div></td>
</tr>
<tr><td><div class="menu_HAUST__R"><a onClick="location.href='/fhem?room=HAUST%c3%9cR'"><img class='icon icoHouse' src="/fhem/images/default/icoHouse.png" alt="icoHouse" title="icoHouse"> <span>HAUSTÜR</span></a></div></td>
</tr>
<tr><td><div class="menu_HEIZUNG"><a onClick="location.href='/fhem?room=HEIZUNG'"><img class='icon icoHEIZUNG' src="/fhem/images/default/icoHEIZUNG.png" alt="icoHEIZUNG" title="icoHEIZUNG"> <span>HEIZUNG</span></a></div></td>
</tr>
<tr><td><div class="menu_MULTIMEDIA"><a onClick="location.href='/fhem?room=MULTIMEDIA'"><img class='icon icoAUDIOVIDEO' src="/fhem/images/user_icons/icoAUDIOVIDEO.png" alt="icoAUDIOVIDEO" title="icoAUDIOVIDEO"> <span>MULTIMEDIA</span></a></div></td>
</tr>
<tr class="sel"><td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr><td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
<tr><td><div class="menu_Schaltuhren"><a onClick="location.href='/fhem?room=Schaltuhren'"><img class='icon icoUhr' src="/fhem/images/default/icoUhr.png" alt="icoUhr" title="icoUhr"> <span>Schaltuhren</span></a></div></td>
</tr>
<tr><td><div class="menu_Z__hler"><a onClick="location.href='/fhem?room=Z%c3%a4hler'"><img class='icon icoZAEHLER' src="/fhem/images/user_icons/icoZAEHLER.png" alt="icoZAEHLER" title="icoZAEHLER"> <span>Zähler</span></a></div></td>
</tr>
<tr><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock2">
<tr><td><div class="menu_Logfile"><a onClick="location.href='/fhem/FileLog_logWrapper?dev=Logfile&type=text&file=fhem-2022-09.log'"><span>Logfile</span></a></div></td>
</tr>
<tr><td><div><a href='/fhem/docs/commandref.html' target="_blank"><span>Commandref</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.de/fhem.html#Documentation' target="_blank"><span>Remote doc</span></a></div></td>
</tr>
<tr><td><div class="menu_Edit_files"><a onClick="location.href='/fhem?cmd=style%20list'"><span>Edit files</span></a></div></td>
</tr>
<tr><td><div class="menu_Select_style"><a onClick="location.href='/fhem?cmd=style%20select'"><span>Select style</span></a></div></td>
</tr>
<tr><td><div class="menu_Event_monitor"><a onClick="location.href='/fhem?cmd=style%20eventMonitor'"><span>Event monitor</span></a></div></td>
</tr>
</table></td></tr>
<tr><td><table class="room roomBlock3">
<tr><td><div><a href='http://fhem.de' ><span>fhem.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://culfw.de' ><span>
culfw.de</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem?cmd=style%20iconFor' ><span>
Icons</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________restart"><a onClick="location.href='/fhem?cmd=shutdown+restart&fwcsrf=csrf_932432427076413'"><span>
restart</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadcfg"><a onClick="location.href='/fhem?cmd=rereadcfg&fwcsrf=csrf_932432427076413'"><span>
rereadcfg</span></a></div></td>
</tr>
<tr><td><div class="menu__________________________rereadicons"><a onClick="location.href='/fhem?cmd=set WEB rereadicons&fwcsrf=csrf_932432427076413'"><span>
rereadicons</span></a></div></td>
</tr>
<tr><td><div><a href='http://fhem.clx.local:8083/fhem/ftui/index.html' ><span>
FTUI</span></a></div></td>
</tr>
</table></td></tr>
</table>
</div>
</div>

</syntaxhighlight>
</div></div>

my $class = "menu_$l1";
$class =~ s/[^A-Z0-9]/_/gi; # alle nicht Buchstaben und Ziffern werden durch Unterstrich ersetzt, also auch Umlaute
my $icon = FW_iconName($icoName) ? FW_makeImage($icoName,$icoName,"icon")." " : "";
FW_pH $l2, "$icon<span>$l1</span>", 1, $class;

<syntaxhighlight lang="html" line><td><div class="menu_Everything"><a onClick="location.href='/fhem?room=all'"><img class='icon icoEverything' src="/fhem/images/default/icoEverything.png" alt="icoEverything" title="icoEverything"> <span>Everything</span></a></div></td>
</syntaxhighlight>
</div></div>

<syntaxhighlight lang="html" line>
<tr class="sel">
<td><div class="menu_SYSTEM__gt_Interfaces"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eInterfaces'"><span>SYSTEM->Interfaces</span></a></div></td>
</tr>
<tr>
<td><div class="menu_SYSTEM__gt_LOGO_"><a onClick="location.href='/fhem?room=SYSTEM%2d%3eLOGO%21'"><span>SYSTEM->LOGO!</span></a></div></td>
</tr>
</syntaxhighlight>

[[Datei:Screenshot FHEM ROOMinROOMIcon.png|mini]]

Man hat also 2 Baustellen. Moechte man ein Icon am uebergoeordneten Menu, muesste man es in die Klasse packen. Bei den Untermenues muss man die Funktion FW_iconName in 01_FHEMWEB.pm patchen.

<syntaxhighlight lang="perl" line>
# check if the icon exists, and if yes, returns its "logical" name;
sub
FW_iconName($) # der Parameter ist falls $l1 nicht irgendwo vorher im Code manipuliert wurde in meinem Beispiel icoSystem->Interfaces. Ein Icon mit diesem Namen gibt es nicht!
{
my ($oname)= @_;
return undef if(!defined($oname));
my $name = $oname;
$name =~ s/@.*//;
foreach my $pe (@FW_iconDirs) {
return $oname if($pe && $FW_icons{$pe} && $FW_icons{$pe}{$name});
}
return undef;
}
</syntaxhighlight>

Auf die Variable
$l1 SYSTEM->Interfaces, bzw. SYSTEM__gt_Interfaces
wird per Regex getestet.

Wenn man also das Attribut so anlegt, klappt es:

attr WEB roomIcons ... SYSTEM-.*Interfaces:icoSYSTEM ...

[[Datei:Screenshot FHEM ROOMinROOMIcon 2.png|mini]]

Das Icon vor den "Stammraum" zu platzieren gestaltet sich etwas schwieriger.

Die passende Stelle in fhemweb.js ist zwar schnell ausgemacht, aber einfach ein Image nach dem <td> einfuegen bringt nicht das genwueschte Ergebnis.

<div class="toccolours mw-collapsible mw-collapsed" style="width:1200px; overflow:auto;">
<div style="font-weight:bold;line-height:1.6;">fhemweb.js (Auszug)</div>
<div class="mw-collapsible-content">
<syntaxhighlight lang="javascript" line>
function
FW_treeMenu()
{
var a = $("a").get(0);
var col = 'rgb(39, 135, 38)';
if(window.getComputedStyle && a)
col = getComputedStyle(a,null).getPropertyValue('color');
FW_arrowRight = 'data:image/svg+xml;utf8,<svg viewBox="0 0 1792 1792" xmlns="http://www.w3.org/2000/svg"><path fill="gray" d="M1171 960q0 13-10 23l-466 466q-10 10-23 10t-23-10l-50-50q-10-10-10-23t10-23l393-393-393-393q-10-10-10-23t10-23l50-50q10-10 23-10t23 10l466 466q10 10 10 23z"/></svg>'
.replace('gray', col);
FW_arrowDown =FW_arrowRight.replace('/>',' transform="rotate(90,896,896)"/>');

var fnd;

$("div#menu table.room").each(function(){ // one loop per Block
var t = this, ma = {};
$(t).find("td > div > a > span").each(function(e){
var span = this, spanTxt = $(span).text().replace(/,/g,'');
var ta = spanTxt.split("->");
if(ta.length <= 1)
return;
fnd = true;
var nxt="", lst="", tr=$(span).closest("tr");
for(var i1=0; i1<ta.length-1; i1++) {
nxt += "->"+ta[i1];
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div>#####HIER PLATZ FUER ICON####<a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
ma[nxt] = true;
lst = nxt;
}
$(span).html(ta[ta.length-1]);
$(tr).attr("data-mTree", nxt)
.addClass("menuTree level"+(ta.length-1));
});
});
</syntaxhighlight>
</div></div>

==Patch==
fhemweb.js (FHEM 6.2 ) Zeile 1157

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>"); <<<<<<<<<< zwischen <td><div> und <a href...
}
</syntaxhighlight>

<syntaxhighlight lang="javascript">
if(!ma[nxt]) {
$(tr).before("<tr class='menuTree closed level"+i1+"' "+
"data-mTree='"+lst+"' data-nxt='"+nxt+"'>"+
"<td><div><img src='/fhem/images/default/ico"+ta[i1]+".png'><a href='#'>"+ta[i1]+"</a><div></div></div></td></tr>");
}
</syntaxhighlight>

Nicht elegant, aber funktioniert solange ein Icon mit dem gleichen Namen wie der uebergeordnete Raum existiert. Hier SYSTEM also icoSYSTEM.png

=(PGM2) MenuBloecke erweitern=

Ich will meine FTUI-Seiten in PGM2 anbinden und nicht nur den Link einfach unten anhaengen (siehe Screenshot).
FTUI soll in einem eigenen Block stehen.

[[Datei:Screenshot FTUI Link.png|mini]]

Um einen neuen Block zu beginnen ist in der Menuliste ein leerer Eintrag notwendig. Siehe Quellcode in FHEMWEB.pm.

<syntaxhighlight lang="perl">
my @list = (
"Everything", "$FW_ME?room=all",
"", "", <--------------------neuer Block
"Commandref", "$FW_ME/docs/commandref${sfx}.html",
"Remote doc", "http://fhem.de/fhem.html#Documentation",
"Edit files", "$FW_ME?cmd=style%20list",
"Select style", "$FW_ME?cmd=style%20select",
"Event monitor", "$FW_ME?cmd=style%20eventMonitor",
"", ""); <--------------------neuer Block
</syntaxhighlight>

Leider ist es mir nicht gelungen in der fhem.conf direkt einen leeren Eintrag zu erzwingen, daher mein Umweg ueber einen Platzhalter (NEWBLOCK)

<syntaxhighlight lang="perl">
attr WEB menuEntries fhem.de,http://fhem.de,\
culfw.de,http://culfw.de,\
Icons,http://fhem.clx.local:8083/fhem?cmd=style%20iconFor,\
restart,cmd=shutdown+restart,\
rereadcfg,cmd=rereadcfg,\
rereadicons,cmd=set WEB rereadicons,\
NEWBLOCK,NEWBLOCK,\
FTUI,http://fhem.clx.local:8083/fhem/ftui/index.html
</syntaxhighlight>

==Patch==
FHEM/01_FHEMWEB.pm Version 6.2 Zeile 1803 (Nachtrag: In Version 6.3 ist es Zeile 1815)

[[Datei:Screenshot Blockbuilding.png|mini]]
<syntaxhighlight lang="perl">
my @me = split(",", AttrVal($FW_wname, "menuEntries", ""));
push @list, @me, "", "" if(@me);

===============================snip==================================================
for(my $idx = 0; $idx < @list; $idx++) {
if ( $list[$idx] =~ m/NEWBLOCK/ ) {
splice @list, $idx, 1,("");
}
}

splice @list, 6, 0, ("",""); # fuegt ein Blockende nach Logfile ein
===============================snip==================================================

my $lastname = ","; <<<<<< neu in Version 6.2
for(my $idx = 0; $idx < @list; $idx+= 2) {
next if($FW_hiddenroom{$list[$idx]} || $list[$idx] eq $lastname);
push @list1, $list[$idx];
push @list2, $list[$idx+1];
$lastname = $list[$idx];
}
</syntaxhighlight>

Nach dem Patch einen Restart mit
systemctl restart fhem
durchfuehren.

=Eventlog=

Ich habe das Problem, dass das KM271 Logomatic 2107 Modul einfach zu geschschwaetzig ist und zudem auch noch ERR-Eintraege produziert, die ich nicht mitloggen moechte.

2023-12-24 09:24:40 KM271 KM271 ERR_Fehlerspeicher1: Code 01 (+): 09:04Uhr vor 68 Tagen | (-): 195:124Uhr vor 0 Tagen

Derzeit nutze ich das Filelog.

define Logfile FileLog /var/log/fhem/fhem-%Y-%m.log fakelog

Dabei bin ueber den Eintrag fakelog gestolpert, mit dem ich irgendwie nix mehr anfangen konnte. Habe ich vermutlich mit CopyPaste aus einer Beispiel-Conf uebernommen.

Folgende [https://forum.fhem.de/index.php?topic=95689.0 Seite] brachte Licht in's Dunkel.

Das ist die Syntax des Logfile Devices.

define <name> FileLog <filename> <regexp> [readonly]

Daraus kann man ableiten das der Begriff fakelog einen regulaeren Ausdruck darstellt. Irgendjemand hat sich den Begriff mal ausgedacht, um den notwendigen Parameter mit einem Suchfilter zu belegen, der niemals eintritt.

An anderer Zeitgenosse hat jetzt genau diesen Begriff als Suchfilter in seiner Wirkung begrenzt.[https://forum.fhem.de/index.php/topic,95351]
Dies wurde mit dem Update vom 05. Januar 2019 wirksam (Rudi hat im Januar update das controlset disabled; Boeser Rudi)

Mit dem folgenden kleinen patch werden set, Regexp parts und Create SVG plot für fakelog nicht mehr angezeigt. meiner meinung nach ist nichts davon sinnvoll und verhindert so fehlbedienung. Ich würde gerne ein solches fakelog device dann auch für die anzeige der alexa-fhem logs nutzen statt den anzeige teil doppelt zu implementieren. aber mit den vielen knöpfen ist das eine mögliche fehlerquelle :)

Will man wieder den alten Zustand herstellen, muss man sich nur einen neuen Suchfilter der nie zutrifft ausdenken.

Aber nun zum eigentlichen Problem.
Ein guter Hinweis ist [https://forum.fhem.de/index.php?topic=51611.0 hier]

Wenn bestimmte Zeilen nicht in die Logdatei geschrieben werden sollen, ist das Attribut ignoreRegexp hilfreich. Wenn beispielsweise alle Zeilen, die die Zeichenfolge "AbCd" oder "CdEf" enthalten nicht geloggt werden sollen, dann wäre

Code Auswählen
attr <log-name> ignoreRegexp .*AbCd.*|.*CdEf.*
eine Attributdefinition, die das ermöglicht.

Dies bezieht sich aber nur auf normale FileLog-Instanzen. Falls Events aus dem globalen FHEM-Logfile ausgeschlossen werden sollen, muss man das Attribut in global angeben. (Zusammenhang siehe #Globale Logdatei)

Code Auswählen
attr global ignoreRegexp .*AbCd.*|.*CdEf.*

=KNX Toggle=
Um einen toogle z.B. auf einem Licht hinzubekommen.

set L_Bar_Auszen g1 toggle

ist es notzwendig das Attribut KNX_TOGGLE zu setzen.

attr KNX_TOGGLE L_Bar_Auszen:state

=<span id="RFC"></span>Request for Comments=

<comments />

2026-04-10T06:09:08Z

Chris T. Ludwig: /* API */

=Allgemeines=
Da ich aktuell vom Energieversorger einen zweiten Hausanschluss (40kW :-() gelegt bekommen habe und ich für die Wallboxen zur Foerderung einen 100% Oekostrom haben musste, habe ich kurzerhand einen Vertrag mit Tibber (mal zum Testen) abgeschlossen.

=Installation=
Pulse IR und Bridge
[[Datei:Tibber Pulse IR und Bridge.png|mini|Tibber Pulse IR und Bridge]]
Eigentlich verlief die Installation problemlos. Fuer mich war allerdings der Assistent in der Tibber-App zu kindisch. Das ist eher was für Apple-User. Ich haette mir an der ein oder anderen Stelle mehr Hardcore-Infos gewuenscht. Da der mehrstufige Prozess (WLAN-Bridge-Pulse-Zaehler) doch einige Solperfallen enthaelt, ist es fuer mich eher frustrierend jedesmal bei einem Fehler zurueck auf Los geschickt zu werden. Das geht definitiv besser. Ist aber wieder ein Beispiel, dass die Informatiker-Jobs heute nur noch durch 5-jaehrige Schimpansen (ungelernte ;-)) besetzt werden.

Bei mir gab es letztendlich nur einen gravierenden Fehler. Von den mitgelieferten Akkus des Pulse war einer defekt. Bei mir sind das zwei AA-Zellen auf LiBasis! Ein Nachladen mit einem Lithium-1.5V-Lader hat keinen Erfolg gebracht. Erst der Austausch gegen 2 neue Zellen war erfolgreich.

=App=
[[Datei:TibberAppIcon.png|mini|TibberAppIcon]]
Die App find ich ziemlich verquer. Sobald Rechnungsanschrift und Installationsorte unterschiedlich sind, geht das Chaos los. Auch der Support tut sich dann schwer. Ich traue mich gar nicht so richtig weitere Vertraege abzuschlieszen.
Alles ueber die App machen zu wollen/muessen ist ... Das gehoert fuer mich ins WebUserPortal.

Was echt nervt ist, dass sich gefühlt jeden Monat das LookandFeel aendert. Schon die dritte oder vierte Designaenderung des Homescreens (Zuhause).

=API=
Da die App eher suboptimal ist, habe ich recht zuegig damit angefangen mir die notwendigen Infos ueber die API auf eine Infoseite im Intranet zu holen. Ein Integration in FHEM und/oder HA steht noch aus.

=Erste Schritte=

Uebersicht [https://developer.tibber.com/docs/overview]

Zusammenfassung: Die Plattform wird über GraphQL verfügbar gemacht, eine Technologie, die von Facebook konzipiert und entwickelt wurde.

==Was ist GraphQL?==

[https://de.wikipedia.org/wiki/GraphQL Wikipedia]

[https://github.com/graphql GraphQL]

===ChatGPT zu GraphQL===

GraphQL ist eine von Facebook entwickelte Abfragesprache und Laufzeitumgebung für APIs (Application Programming Interfaces). Im Gegensatz zu traditionellen RESTful APIs, bei denen die Client-Anwendung verschiedene Endpunkte aufruft, um Daten abzurufen oder zu manipulieren, ermöglicht GraphQL dem Client, genau die Daten abzurufen, die er benötigt, indem er eine einzige Abfrage an den Server sendet.

Hier sind einige Hauptmerkmale von GraphQL:

'''Declarative Datenabfrage''': Der Client spezifiziert genau, welche Daten er vom Server erhalten möchte, indem er eine GraphQL-Abfrage definiert, die die benötigten Felder und deren Struktur beschreibt. Dadurch kann der Client genau die Daten erhalten, die er benötigt, ohne Overfetching oder Underfetching.
'''Typsystem''': GraphQL definiert ein Typsystem, das die Struktur und den Typ der Daten beschreibt, die von der API zurückgegeben werden können. Dies ermöglicht eine strikte Typisierung und verbesserte Dokumentation.
'''Single-Endpoint-Architektur''': Im Gegensatz zu RESTful APIs, die oft mehrere Endpunkte für verschiedene Ressourcentypen haben, hat eine GraphQL-API normalerweise nur einen Endpunkt, über den alle Abfragen und Mutationen gesendet werden.
'''Echtzeitfähigkeit''': GraphQL unterstützt auch Abonnements, die es ermöglichen, Daten in Echtzeit zu empfangen, wenn sich etwas ändert. Dies ist besonders nützlich für Anwendungsfälle wie Live-Chats, Benachrichtigungen und Echtzeit-Dashboard-Aktualisierungen.
'''Entwicklungserfahrung''': GraphQL bietet eine verbesserte Entwicklererfahrung, da Clients genau die Daten erhalten können, die sie benötigen, und Entwickler APIs schneller entwickeln können, ohne sich um Versionierung oder unerwartete Seiteneffekte durch Änderungen an der Backend-API kümmern zu müssen.

Insgesamt bietet GraphQL eine flexible, effiziente und moderne Möglichkeit, APIs zu entwerfen und zu verwenden, die den Anforderungen moderner Anwendungen besser gerecht wird als traditionelle RESTful APIs.

Auf der Tibber-Seite heiszt es:

The GraphQL query language is basically about selecting fields on objects.

Was dies bedeutet kommt weiter unten. Weiter heiszt es auf der Tibber Seite.

GraphQL ist eine Abfragesprache für Ihre(? unsere) API und eine serverseitige Laufzeitumgebung zum Ausführen von Abfragen mithilfe eines Typsystems, das Sie für Ihre Daten definieren. GraphQL ist nicht an eine bestimmte Datenbank oder Speicher-Engine gebunden und wird stattdessen durch Ihren vorhandenen Code und Ihre Daten unterstützt.

Mit der Uebersetzung von Google hadere ich noch. Der Satz kommt vermutlich ursrpruenglich von Facebook und wurde von Tibber 1:1 uebernommen.

Der naechste Satz gibt schon mehr Aufschluss:
Tibber hat sich für GraphQL als API entschieden, weil es unseren Integratoren und uns selbst Flexibilitaet bietet. Die Moeglichkeit, die gewuenschten Daten genau zu definieren, macht die Nutzung wesentlich einfacher als herkoemmliche [https://www.ibm.com/de-de/topics/rest-apis REST-basierte APIs]. Es ist auch sehr schoen, dass die serverseitige Implementierung von GraphQL sehr gut mit unserer Microservice-Architektur zusammenspielt :-)

Zum Einstieg nutze ich den [https://developer.tibber.com/explorer Api Explorer im TibberDev]. Nachdem man sich dort einen Personal Token angelegt hat, kann's direkt losgehen. Der [https://developer.tibber.com/explorer GraphiQL] hat auch eine Autovervollstaendigung. Sehr praktisch.
[[Datei:TibberDevAccount.png|mini|TibberDevAccount]]
Die Root-Types sind
*query: Query
*mutation: RootMutation
*subscription: RootSubscription
*fragment feht irgendwie in der Doc

Der Aufbau ist recht simpel und das Doc in knapp einer Stunde durchprobiert. So dass ich dann schnell an dem Punkt angelangt bin, dass ich ein Programm (PHP, Python oder JavaScript) brauche welches die fuer mich interessanten Daten in meine MySQL-DB uebertraegt. Ob ich zuerst anzeige und dann speichere, also sozusagen ueber die Datenbank puffere, oder umgekehrt muss ich noch festlegen.

===ChatGPT zum Subprotokoll===

Das Subprotokoll "graphql-transport-ws" ist ein WebSocket-Subprotokoll, das speziell für die Kommunikation zwischen Client und Server in GraphQL-Anwendungen entwickelt wurde. Es basiert auf dem WebSocket-Protokoll, das eine bidirektionale, persistente Verbindung zwischen einem Client und einem Server ermöglicht.

Im Kontext von GraphQL wird "graphql-transport-ws" verwendet, um GraphQL-Abfragen, Mutationen und Abonnements über WebSocket-Verbindungen zu übertragen. Im Gegensatz zum traditionellen HTTP-Protokoll, das eine separate Anfrage-Antwort-Struktur hat, ermöglicht WebSocket eine kontinuierliche Kommunikation zwischen Client und Server, was besonders nützlich ist, wenn Echtzeit-Aktualisierungen benötigt werden, wie bei Abonnements in GraphQL.

Das Subprotokoll "graphql-transport-ws" definiert spezifische Nachrichtenformate und Handshake-Verfahren, die für die GraphQL-Kommunikation über WebSockets erforderlich sind. Durch die Verwendung dieses Subprotokolls können Entwickler GraphQL-Anwendungen erstellen, die von den Echtzeitfähigkeiten von WebSocket profitieren, ohne auf die Vorteile und Flexibilität von GraphQL verzichten zu müssen.

==Mehrfacher Hinweis Subprotokolwechsel Dezember 2022==

Die TibberAPI unterstuetzte zunaechst GraphQL-Websocket-Subscriptions mithilfe des Unterprotokolls graphql-ws. Diese Bibliothek wird/wurde jedoch archiviert und nicht mehr gepflegt. Daher wurde am 31. Maerz 2022 die Unterstützung für das Unterprotokoll graphql-transport-ws hinzugefuegt.

Die Unterstuetzung für das alte Protokoll wird im Dezember 2022 entfernt. Gleichzeitig aendert sich auch die URL für die Verbindung zum Websocket-Server. Zuvor konnte die Verbindung unter '''wss://api.tibber.com/v1-beta/gql/subscriptions''' hergestellt werden. Nach der Aenderung muss die URL ueber GraphQL abgefragt werden (siehe Beispiel unten) und der Client muss das Unterprotokoll graphql-transport-ws unterstuetzen.

<syntaxhighlight code=xml>
Frage:
{
viewer {
websocketSubscriptionUrl
}
}

Antwort:
{
"data": {
"viewer": {
"websocketSubscriptionUrl": "wss://websocket-api.tibber.com/v1-beta/gql/subscriptions"
}
}
}
</syntaxhighlight>

==Anfragenbegrenzung==
Zum Schutz der API gilt eine Ratenbegrenzung von 100 Anfragen in 5 Minuten pro IP-Adresse. Beachten Sie, dass die Preise einmal täglich am Nachmittag berechnet werden (für Norwegen und Schweden sind sie zunächst vorläufig und werden später möglicherweise mit geringfügigen Änderungen nach Bestätigung der Wechselkurse endgültig festgelegt). Sie können „priceInfo.today“ und „priceInfo.tomorrow“ verwenden, um sie im Voraus abzurufen, anstatt nur „priceInfo.current“ für die aktuelle Stunde zu verwenden.

=In medias res=
Zum Starten empfiehlt die Tibber-API-Doc, die fundamentalen Konzepte von GraphQL, die Kommunikation mit der API und den Explorer.

Um die nachfolgenden Beispiele schnell zu verstehen, hier der Link zur [https://developer.tibber.com/docs/reference API-Referenz]

Bei der GraphQL-Abfragesprache geht es im Wesentlichen um die Auswahl von Feldern in Objekten.

Auf der Docs-Reference-Seite gibt es einen interessanten Hinweis:
This reference is auto-generated from https://api.tibber.com

Es koennte als eine URL geben, die einem die aktuelle '''Tibber GraphQL Schema Reference''' direkt zur Auswertung ausgibt. Der Umweg ueber das Parsen der HTML-Ausgabe ginge zur Not natuerlich auch.

==Objekt Typen==

Die Begriffsdifferenzierung Objekt und Object Types ist mir derzeit noch nicht klar. Ich werde wohl um die allgemeine [https://github.com/graphql/graphql-spec Spec von GraphQL] nicht herumkommen:-(

Bei 'Home' wird von einem Objekttyp gesprochen. Klar ist man hat Objekte, die mit dem Schluesselwort type eingeleitet und dann beschrieben werden.

Einige Felder sind Skalare (Boolesche Werte, Zeichenfolgen, Ganzzahlen, Gleitkommazahlen), waehrend andere Objekttypen sind (Adresse, LegalEntity). Eine GraphQL-Abfrage muss vollstaendig auf Skalarebene sein. D.h. in einer Abfrage duerfen die abgefragten Felder keine Objekte (keine weiteren Objekttypen) sein, sondern hierarchisch heruntergebrochen auf weitere Inhalte bis es Skalare sind.

<syntaxhighlight lang=xml>
This query is valid:

{
homes{
id
}
}

This is not:

{
homes{
id
owner <- hier ist der Fehler. Dies ist kein Skalar!
}
}

The owner field is an object type and you would need to specify which scalar fields you would like returned:

{
homes{
id
owner{
name
}
}
}
</syntaxhighlight>

==query Datenabfrage (read)==

query->viewer

Zuerst mit homes die Zaehlerplatz-iD holen und dan mit home (id: "<ID>") nur die data dazu holen.

Hello World;-)
{
viewer {
login
name
userId
accountType
home (id: "1cdd8b6d-956c-447f-9b95-9a57801eaf4c") {
id
features {
realTimeConsumptionEnabled
}
subscriptions {
id
}
currentSubscription {
id
}
meteringPointData {
consumptionEan
gridCompany
gridAreaCode
priceAreaCode
productionEan
energyTaxType
vatType
estimatedAnnualConsumption
}
owner {
id
}
mainFuseSize
}
websocketSubscriptionUrl
}
}

Interessant fand ich z.B.

"priceAreaCode": "Amprion",

"estimatedAnnualConsumption": 500

"mainFuseSize": null

und was da noch alles an Daten einzutragen ist.
size: Int
The size of the home in square meters

==mutation Datenveraenderung (write)==

Mutationen gibt es nur 3, wobei die erste bei mir entfaellt.

sendMeterReading(input: MeterReadingInput!): MeterReadingResponse!
Send meter reading for home (only available for Norwegian users)

updateHome(input: UpdateHomeInput!): Home!
Update home information

sendPushNotification(input: PushNotificationInput!): PushNotificationResponse!
Send notification to Tibber app on registered devices

==subscription==

Subscription hat nur 2 Felder, wobei dauerhaft nur das erste interessant ist.

liveMeasurement(homeId: ID!): LiveMeasurement
Subscribe to real-time measurement stream from Pulse or Watty device

testMeasurement(homeId: ID!): LiveMeasurement
Subscribe to test stream

<syntaxhighlight lang=xml>
subscription{
liveMeasurement(homeId: "<homeID>"){
timestamp
power
lastMeterConsumption
accumulatedConsumption
accumulatedProduction
accumulatedConsumptionLastHour
accumulatedProductionLastHour
accumulatedCost
accumulatedReward
currency
minPower
averagePower
maxPower
powerProduction
powerReactive
powerProductionReactive
minPowerProduction
maxPowerProduction
lastMeterProduction
powerFactor
voltagePhase1
voltagePhase2
voltagePhase3
currentL1
currentL2
currentL3
signalStrength
}
}
</syntaxhighlight>

==fragment==

?

Dazu habe ich bisher keine weiteren Infos gefunden.

=Programmierung=

Bei der Programmierung steht bei mir hier die Client-Programmierung im Vordergrund.

==Query/Mutation==

Die Abfragen und Aenderungen zu programmieren sind schnell erledigt.

Der Einstieg auf der Konsole gelingt mit curl recht gut.

<syntaxhighlight lang=bash>
curl \
-H "Authorization: Bearer 5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE \
-H "Content-Type: application/json" \
-X POST \
-d 'mutation{ sendMeterReading(input:{homeId:"some home id", reading: 123}){time reading }}' https://api.tibber.com/v1-beta/gql
</syntaxhighlight>

==Subscription==

Die Subscriptions sind schon ein wenig anspruchsvoller zu programmieren als Query und Mutation (QuM).
Ist QuM eine simple http-Anfrage mit einer Antwort im JSON-Format, ist es bei den Subscriptions ein Websocket, der einmal geoeffnet in unregelmaeszigen Abstaenden JSON-Pakete liefert.

===Anforderungen für Websocket-Abonnement-Clients===

* Clients muessen den User-Agent-Header festlegen, wenn sie die GraphQL-API aufrufen und eine Websocket-Verbindung oeffnen. Sowohl die Plattform als auch die Treiberversion muessen angegeben werden. Z.B. Homey/10.0.0 com.tibber/1.8.3
* Clients müssen das Unterprotokoll graphql-transport-ws implementieren
* Clients müssen Jitter und exponentielles Backoff implementieren, wenn sie Anfragen an die API wiederholen
* Clients müssen die WebSocket-Server-URL dynamisch abfragen

===Best Practices für die Implementierung von WebSocket-Abonnement-Clients===

Bei der Implementierung eines Clients zum Abonnieren von Live-Daten sind einige Szenarien zu beruecksichtigen:
* Keine Daten aufgrund von Netzwerkproblemen: Es kann sinnvoll sein, einen Wiederverbindungsmechanismus zu implementieren, falls mehrere Minuten lang keine Daten empfangen wurden. Bei einem erneuten Versuch muss zunaechst die alte Websocket-Verbindung zerstoert und ordnungsgemaeszer Jitter und exponentielle Verzoegerung implementiert werden.
* Ein Echtzeitgeraet wird moeglicherweise entfernt. Es wird empfohlen, vor dem erneuten Verbinden immer zu ueberpruefen, ob home.features.realTimeConsumptionEnabled einen echten Wert hat.
* Eine WebSocket-Verbindung kann aufgrund eines ungueltigen Authentifizierungstokens verboten sein (z. B. weil ein Benutzer möglicherweise sein Tibber-Konto entfernt hat). In diesem Fall darf der Client es nicht mit demselben Token erneut versuchen. Stattdessen muss der Autorisierungsprozess erneut ausgeführt werden, wobei der Benutzer neue Anmeldeinformationen eingibt.
* Es kann zu einem Neustart der Tibber-Websocket-API kommen, was bedeutet, dass die Verbindung mit dem "Code 1001" und dem Grund "Going away" geschlossen wird. In diesem Fall kann der Client nach einer zufälligen Verzoegerung von 1 bis 60 Sekunden (Jitter angewendet) die Verbindung wiederherstellen, um zu vermeiden, dass alle Clients gleichzeitig die Verbindung wiederherstellen.

In PHP habe ich wenig bis gar nichts gefunden. Ich wollte mir auch einfach die Nutzung einer GraphQL-Library ersparen. Python habe ich erst einmal an den Schluss verschoben und einem Integration in FHEM den Vorzug gegeben.

===Perl (FHEM)===
Hier der Code der tatsaechlich funktioniert, obwohl er an ein paar Stellen nicht so vorgeht wie ich aus den Tibber-Docs erwartet hatte.

HINWEIS: Dies ist der "nackte" Perl-Code. In der "Originaldatei" sind noch die "FHEM-Escapes" doppelter Strichpunkt und Zeilenfolgezeichen \ enthalten. Eine Eingabe ueber die FHEM-Kommandozeile hat bei mir nicht funktioniert. Erst das direkte Einkopieren in die fhem.conf zeigte das nachfolgende, funktionierende Ergebnis.

<syntaxhighlight lang="perl" line>
connect:cmd:.connect {
my $hash = $defs{$name};
my $devState = DevIo_IsOpen($hash);
return "Device already open" if (defined($devState));

# establish connection to websocket
# format must also include portnumber if a path is to be specified
$hash->{DeviceName} = AttrVal($name, "websocketURL", "wss:echo.websocket.org:443");

# special headers needed for Tibber, see also Developer Tools in Browser
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';
$hash->{header}{'Host'} = 'websocket-api.tibber.com';
$hash->{header}{'Origin'} = 'https://developer.tibber.com';

# callback function when "select()" signals data for us
# websocket Ping/Pongs are treated in DevIo but still call this function
$hash->{directReadFn} = sub () {
my $hash = $defs{$name};

# we can read without closing the DevIo, because select() signalled data
my $buf = DevIo_SimpleRead($hash);

# if read fails, close device
if(!defined($buf)) {
DevIo_CloseDev($hash);
$buf = "not_connected";
}

#Log(3, "$name:$reading: websocket data: >>>$buf<<<");

# only update our reading if buffer is not empty and if last update is older than minInterval
if ($buf ne "") {
my $websocketDataAge = ReadingsAge($name, "websocketData", 3600);
my $minInterval = AttrVal($name, "minInterval", 0);
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);

readingsBeginUpdate($hash);
readingsBulkUpdate($hash, "websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);
readingsBulkUpdate($hash, "websocketData", "$buf") if (!$isNext);
readingsEndUpdate($hash, 1);
}
};

# open DevIo websocket
DevIo_OpenDev($hash, 0, undef, sub(){
my ($hash, $error) = @_;
return "$error" if ($error);

my $token = AttrVal($name, "token", "???");

DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);
});
readingsBulkUpdate($hash, "websocketData", "");

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
disconnect:cmd:.disconnect {
my $hash = $defs{$name};
RemoveInternalTimer($hash);
DevIo_SimpleRead($hash);
DevIo_CloseDev($hash);

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onDisconnect {
my $myState = ReadingsVal($name, "state", "???");
my $myData = ReadingsVal($name, "websocketData", "???");
return if ($myState ne "disconnected" and $myData ne "not_connected");

## timer callback function, called after a few seconds to initiate a reconnect
my $timerFunction = sub() {
my ($hash) = @_;
my $devState = DevIo_IsOpen($hash);

# only re-connect if device is not connected
readingsSingleUpdate($hash, "cmd", "connect", 1) if (!defined($devState));
};
my $hash = $defs{$name};
RemoveInternalTimer($hash, $timerFunction);

# wait a random time before reconnect (exponential backoff TBD):
my $rwait = int(rand(200)) + 30;
InternalTimer(gettimeofday() + $rwait, $timerFunction, $hash);
readingsBulkUpdate($hash, "cmd", "reconnect attempt in $rwait seconds");

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onConnectionAck:websocketData:.*connection_ack.* {
#websocketData contains the string "connection_ack"
Log(3, "$name:$reading: got connection ack");

# do not proceed if connection is lost
my $hash = $defs{$name};
my $devState = DevIo_IsOpen($hash);
return "Device not open" if (!defined($devState));

readingsBulkUpdate($hash, "cmd", "got connection ack");

my $homeId = AttrVal($name, "homeId", "???");
my $myId = AttrVal($name, "myId", "???");

# build the query, do it in pieces, the comma at the end caused perl errors
# so we put it together in this not very elegant way
my $json = '{ "id":"'. $myId .'", "type":"subscribe"'.", ";
$json .= '"payload":{';
$json .= '"variables":{}'.", ";
$json .= '"extensions":{}'.", ";
$json .= '"query":"subscription { liveMeasurement( homeId: \"'.$homeId.'\" ) ';
$json .= '{ timestamp power lastMeterConsumption accumulatedConsumption accumulatedProduction ';
$json .= 'accumulatedProductionLastHour accumulatedCost accumulatedReward currency minPower averagePower maxPower ';
$json .= 'powerProduction powerReactive powerProductionReactive minPowerProduction maxPowerProduction lastMeterProduction ';
$json .= 'powerFactor voltagePhase1 voltagePhase2 voltagePhase3 signalStrength }}"';
$json .= '}}';

#send the string via websocket as ASCII
Log(3, "$name:$reading: sending JSON: >>>$json<<<");
DevIo_SimpleWrite($hash, $json, 2);

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onNextLiveMeasurement:websocketData:.*next.*payload.*data.*liveMeasurement.* {
#websocketData contains next-live-measurement-data
my $val = ReadingsVal($name, "websocketData", "{}");
my %res = %{json2nameValue($val, undef, undef, "payload_data_liveMeasurement.*")};

my $ret = "got values for:\n";
foreach my $k (sort keys %res) {
$ret .= "$k\n";
readingsBulkUpdate($hash, makeReadingName($k), $res{$k});
}
return $ret;
}
</syntaxhighlight>

====Code Analyse====

Es gibt 5 Eintrittspunkte:
* connect
* disconnect
* onDisconnect
* onConnectionAck
* onNextLiveMeasurement

Die ersten beiden legen die Befehlsfolgen für ein Start-Kommando (set cmd connect, bzw. set cmd disconnect) oder Stop-Kommando fest.
Die letzten 3 reagieren auf die entsprechenden Events.
=====connect=====

Lexikalische Variablen mittels my, bzw. my()

Jede Variable, die mit our deklariert oder auch "einfach so" ohne eine Deklaration verwendet wird, wird in die Symboltabelle des jeweils aktuellen Packages aufgenommen.
Deklariert man dagegen eine Variable mit dem Operator my, so wird die entsprechende Variable in einer anderen Tabelle abgelegt, auf die kein expliziter Zugriff möglich ist.
Neben der Tatsache, daß my-Variablen in einer eigenen Tabelle verwaltet werden, ist von besonderer Bedeutung, daß sie nur einen recht beschränkten Gültigkeitsbereich besitzen. Eine durch my erzeugte Variable steht nur in dem aktuellen Block (definiert durch geschweifte Klammern "{...}"), der aktuellen Datei oder innerhalb eines Arguments von eval() zur Verfügung. Außerhalb davon existieren diese Variablen nicht, es ist also (im Gegensatz zu our-Variablen) auch mit Hilfe des Package-Namens dort kein Zugriff möglich
Es kann in einem Package durchaus zwei Variablen gleichen Namens geben: eine in der Symboltabelle und eine, die durch einen Aufruf von my entstanden ist. In einem solchen Falle wird bei einfacher Verwendung des Bezeichners auf die my-Variable zugegriffen.

In $defs stehen alle Defines drin. In $hash wird also der Name des des aufrufenden Devices lokal hinterlegt und danach mit DevIO_IsOpen() der Status abgefragt.
$defs ist ein Hash. Ein Hash ist ein anderer Namen fuer ein assoziatives Array. Also eine ungeordnete Liste von Skalaren (Zahl oder String) die ueber einen Stringwert angesprochen (Lookup) werden koennen.

FHEM-Spezial:
In $defs findet man alle Devices, z.b. $defs{"Rolladen_Tuere"} beinhaltet das Device.
my @alle = keys %defs;
my @teilmenge = defInfo('TYPE=notify','NAME'); liefert ein array mit allen notify devices.
z.B. my @teilmenge = defInfo('NAME=Rollladen.*','NAME');

return "Device already open" if (defined($devState));
Sollte also das Device bereits im State "offen" sein, wird die connect-Routine abgebrochen. Dann erscheint in den Readings nicht Datum/Uhrzeit des Connects sondern die Meldung "Device already open".

# establish connection to websocket
# format must also include portnumber if a path is to be specified
$hash->{DeviceName} = AttrVal($name, "websocketURL", "wss:echo.websocket.org:443");

HASH-Operationen (Beispiel):
$href ={APR => 4,AUG => 8}; #anonymous hash
$el = $href->{APR}; $el = %{$href}{APR}; #access element of hash
$href2 = {%{$href1}}; #copy hash
if (ref($r) eq "HASH") {} #checks if $r points to hash

Dem Internal "DeviceName" wird das Ergebnis von AttrVal() zugewiesen. Bei mir ergab das:
DeviceName wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions

FHEM-Referenz:
AttrVal(<devicename>,<attribute>,<defaultvalue>)
Gibt das entsprechende Attribut des Gerätes zurück
{ Value("wz") }
{ OldValue("wz") }
{ time_str2num(OldTimestamp("wz")) }
{ ReadingsVal("wz", "measured-temp", "20")+0 }
{ ReadingsTimestamp("wz", "measured-temp", 0)}
{ AttrVal("wz", "room", "none") }

Das Attribut websocketURL ist bei mir wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions. Somit erklaert sich auch der Eintrag bei DeviceName. "wss:echo.websocket.org:443" ist nur der Defaultwert.

Man haette zum Testen auch die folgenden beiden verwenden/eintragen koennen.
There are free test servers that we can use to experiment with a WebSocket client, such as:

Hoppscotch – wss://echo-websocket.hoppscotch.io (GUI)
λ if else – wss://ws.ifelse.io (GUI)

Both provide a GUI for testing via a browser. The former sends a timestamp to the client every second but doesn’t respond to client messages. The latter is a standard echo service that sends a copy of each received message back to the client. Both make sense in testing.

Da curl nicht nativ websocket-Kommunikation unterstuetzt kann man auf folgende Tool ausweichen. Auch chrome bietet ein Websocket-Client-Plugin.
*wssh3
*websocat
*wscat

# special headers needed for Tibber, see also Developer Tools in Browser
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';
$hash->{header}{'Host'} = 'websocket-api.tibber.com';
$hash->{header}{'Origin'} = 'https://developer.tibber.com';

# callback function when "select()" signals data for us
# websocket Ping/Pongs are treated in DevIo but still call this function

$hash->{directReadFn} = sub () {
my $hash = $defs{$name};

# we can read without closing the DevIo, because select() signalled data
my $buf = DevIo_SimpleRead($hash);

# if read fails, close device
if(!defined($buf)) {
DevIo_CloseDev($hash);
$buf = "not_connected";
}

#Log(3, "$name:$reading: websocket data: >>>$buf<<<");

# only update our reading if buffer is not empty and if last update is older than minInterval
if ($buf ne "") {
my $websocketDataAge = ReadingsAge($name, "websocketData", 3600);
my $minInterval = AttrVal($name, "minInterval", 0);
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);

readingsBeginUpdate($hash);
readingsBulkUpdate($hash, "websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);
readingsBulkUpdate($hash, "websocketData", "$buf") if (!$isNext);
readingsEndUpdate($hash, 1);
}
};

Die Callback-Funktion wird direkt, ohne Namen, in das/den (?) Hash unter directReadFn abgelegt.
Die Callback-Funktion:
Hier wird mit Hilfe der Funktion DevIo_SimpleRead() die Rueckmeldung des Server eingelesen. Siehe [https://wiki.fhem.de/wiki/DevIo]
Hinweis zum Logging in FHEM: [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#Logging]
Die eigentliche Aktivitaet geschieht in den sieben Zeilen am Ende der Callback-Fkt.
ReadingsAge(<devicename>,<reading>,<defaultvalue>) #gibt das Alter des Readings in Sekunden zurück.
AttrVal hatten wir schon.
isNext bekommt seinen Wert aus dem durch einen REGEX geliefert Wert des Buffers. Beispiel ($match) = ($dirty =~ /^(.*)$/s);

Die Funktion readingsBeginUpdate() bereitet die Definition mit dem Hash $hash auf ein Update von Readings vor. Dies betrifft insbesondere das Setzen von Umgebungsvariablen sowie dem aktuellen Zeitstempel als Änderungszeitpunkt. Der Aufruf dieser Funktion ist notwendig um eigentliche Updates mit der Funktion readingsBulkUpdate() auf der gewünschten Definition durchführen zu können. [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#readingsBeginUpdate]

Die Funktion readingsEndUpdate() beendet den Bulk-Update Prozess durch die Funktionen readingsBeginUpdate() & readingsBulkUpdate() und triggert optional die entsprechenden Events sämtlicher erzeugter Readings für die Definition $hash. Desweiteren werden nachgelagerte Tasks wie bspw. die Erzeugung von User-Readings (Attribut: userReadings), sowie die Erzeugung des STATE aufgrund des Attributs stateFormat durchgeführt. Sofern $do_trigger gesetzt ist, werden alle anstehenden Events nach Abschluss getriggert.

# open DevIo websocket
DevIo_OpenDev($hash, 0, undef, sub(){
my ($hash, $error) = @_;
return "$error" if ($error);

my $token = AttrVal($name, "token", "???");

DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);
});

Das ist die eigentliche Kontaktaufnahme.

Dies dient vermutlich dazu, bis zum ersten Empfang von Daten, das Reading websocketDate zu leeren.

return POSIX::strftime("%H:%M:%S",localtime(time()));

Zum Abschluss ercheint dann im Reading connect die aktuelle Zeit.

readingsBulkUpdate($hash, "websocketData", "");

=====disconnect=====

<syntaxhighlight lang="python" line>
disconnect:cmd:.disconnect {
my $hash = $defs{$name};
RemoveInternalTimer($hash);
DevIo_SimpleRead($hash);
DevIo_CloseDev($hash);
return POSIX::strftime("%H:%M:%S",localtime(time()));
</syntaxhighlight>

Erlaeuterung:

*Die Funktion RemoveInternalTimer löscht möglicherweise noch anstehende Timer welche mit dem Übergabeparameter $arg gescheduled sind. Optional kann man zusätzlich die Suche auf eine bestimmte Funktion $functionName weiter einschränken. [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#RemoveInternalTimer]

*Die Funktion DevIo_SimpleRead() liest anstehende Daten für die Verbindung von $hash ein und gibt diese zurück. [https://wiki.fhem.de/wiki/DevIo#DevIo_SimpleRead()]

*Die Funktion DevIo_CloseDev() schließt eine evtl. geöffnete Verbindung für die Definition $hash. [https://wiki.fhem.de/wiki/DevIo#DevIo_CloseDev()]

*POSIX:: [https://metacpan.org/pod/POSIX#strftime]

=====onDisconnect=====
TODO

=====onConnectionAck=====
TODO

=====onNextLiveMeasurement=====
TODO

===JavaScript===
Zum Eingewoehnen:

<syntaxhighlight lang=javascript>
// WebSocket-Verbindung herstellen
const socket = new WebSocket('ws://echo.websocket.org');

// Event-Handler für Verbindungsereignisse
socket.onopen = function(event) {
console.log('WebSocket-Verbindung hergestellt.');
// Nachricht senden, sobald die Verbindung hergestellt ist
socket.send('Hallo Server!');
};

socket.onmessage = function(event) {
console.log('Nachricht vom Server erhalten:', event.data);
};

socket.onclose = function(event) {
console.log('WebSocket-Verbindung geschlossen.');
};

socket.onerror = function(error) {
console.error('WebSocket-Fehler aufgetreten:', error);
};
</syntaxhighlight>

Und jetzt das Gerippe fuer Tibber mit Haut versehen:

<syntaxhighlight lang=javascript>
const WebSocket = require('ws');

const query = `subscription {
liveMeasurement(homeId: "96a14971-525a-4420-aae9-e5aedaa129ff") {
timestamp
power
accumulatedConsumption
minPower
maxPower
averagePower
voltagePhase1
currentL1
accumulatedCost
currency
}
}`;

// WebSocket-Verbindung herstellen
const socket = new WebSocket('wss://websocket-api.tibber.com/v1-beta/gql/subscriptions',['graphql-transport-ws'], {
headers: {
'Content-Type': 'application/json',
'User-Agent': 'NodeJS tibberview',

}
});

// Event-Handler für Verbindungsereignisse
socket.onopen = function(event) {
console.log("WebSocket-Verbindung hergestellt.");
// Nachricht senden, sobald die Verbindung hergestellt ist
const connectionQuery = {
type: "connection_init",
payload: {
token: "5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE",
}
};

socket.send(JSON.stringify(connectionQuery));
console.log("Verbindung zum 'Tibber feed' hergestellt.");
};

socket.onmessage = function(event) {
console.log("Nachricht vom Server erhalten:", event.data);
const msg = JSON.parse(event.data);

if (msg.type === "connection_ack") {
console.log("Tibber ACK empfangen: ", msg);

const realtimeDataQuery = {
id: "96a14971-525a-4420-aae9-e5aedaa129ff",
type: "subscribe",
payload: { query }
};

socket.send(JSON.stringify(realtimeDataQuery));
}
else if (msg.type === "next") {
if (!msg.payload.data) {
console.log("⚠ Nachricht hat keinen Inhalt.");
return;
}
const data = msg.payload.data.liveMeasurement;
socket.emit("data", data);
} else {
console.log("Nachrichteninhalt: ", msg)
}
};

socket.onclose = function(event) {
console.log('WebSocket-Verbindung geschlossen.');
};

socket.onerror = function(error) {
console.error('WebSocket-Fehler aufgetreten:', error);
};

</syntaxhighlight>

Das Programm erzeugte folgende Ausgabe:
<syntaxhighlight lang=bash>
worker:/mnt/1.5T_RAID/Programme/JavaScript/WebSocket # node tibberclient_demo.js
WebSocket-Verbindung hergestellt.
Verbindung zum 'Tibber feed' hergestellt.
Nachricht vom Server erhalten: {"type":"connection_ack"}
Tibber ACK empfangen: { type: 'connection_ack' }
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:48.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.6,"voltagePhase1":230.1,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:51.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.3,"voltagePhase1":229.8,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:52.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.3,"voltagePhase1":230,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:53.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.2,"voltagePhase1":230.3,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:54.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.1,"voltagePhase1":230.3,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:55.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306,"voltagePhase1":230.2,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:56.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306,"voltagePhase1":229.8,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:57.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.9,"voltagePhase1":229.9,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:58.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.8,"voltagePhase1":230.1,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:59.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.8,"voltagePhase1":230.4,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:47:00.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.7,"voltagePhase1":230.1,"currentL1":2.7,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:47:01.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.6,"voltagePhase1":229.9,"currentL1":2.7,"accumulatedCost":11.672781,"currency":"SEK"}}}}
^C
</syntaxhighlight>

An der Stelle mache ich jetzt einen Ausflug in PHP.

===PHP===
Nachdem der Websocket-Kontakt mit JavaScript funktioniert hat, kommt jetzt ein Serverprogramm was folgendes tun soll.

*Abfrage der Basisdaten
*Objekt Types Builder
*Mutation
*Websocket Subsrciption

TODO

===Python===

Quelle: https://github.com/Danielhiversen/pyTibber

Client-Beispiel mit eingesetzem DEMO_TOKEN und user_agent
Obwohl DEMO_TOKEN in tibber.py definiert ist, wird es nicht uebernommen.
<syntaxhighlight lang=python>
import tibber.const
import tibber
import asyncio

async def start():
tibber_connection = tibber.Tibber(tibber.const.DEMO_TOKEN, user_agent="worker")
await tibber_connection.update_info()
print(tibber_connection.name)

home = tibber_connection.get_homes()[0]
await home.fetch_consumption_data()
await home.update_info()
print(home.address1)

await home.update_price_info()
print(home.current_price_info)

# await tibber_connection.close_connection()

loop = asyncio.run(start())
</syntaxhighlight>

<syntaxhighlight lang=python>
import tibber.const
import asyncio

import aiohttp
import tibber

def _callback(pkg):
print(pkg)
data = pkg.get("data")
if data is None:
return
print(data.get("liveMeasurement"))

async def run():
async with aiohttp.ClientSession() as session:
tibber_connection = tibber.Tibber(tibber.const.DEMO_TOKEN, websession=session, user_agent="worker")
await tibber_connection.update_info()
home = tibber_connection.get_homes()[0]
await home.rt_subscribe(_callback)

while True:
await asyncio.sleep(10)

loop = asyncio.run(run())
</syntaxhighlight>

Tibber Pulse (API)

2026-04-10T06:07:58Z

Chris T. Ludwig: /* Installation */

=Allgemeines=
Da ich aktuell vom Energieversorger einen zweiten Hausanschluss (40kW :-() gelegt bekommen habe und ich für die Wallboxen zur Foerderung einen 100% Oekostrom haben musste, habe ich kurzerhand einen Vertrag mit Tibber (mal zum Testen) abgeschlossen.

=Installation=
Pulse IR und Bridge
[[Datei:Tibber Pulse IR und Bridge.png|mini|Tibber Pulse IR und Bridge]]
Eigentlich verlief die Installation problemlos. Fuer mich war allerdings der Assistent in der Tibber-App zu kindisch. Das ist eher was für Apple-User. Ich haette mir an der ein oder anderen Stelle mehr Hardcore-Infos gewuenscht. Da der mehrstufige Prozess (WLAN-Bridge-Pulse-Zaehler) doch einige Solperfallen enthaelt, ist es fuer mich eher frustrierend jedesmal bei einem Fehler zurueck auf Los geschickt zu werden. Das geht definitiv besser. Ist aber wieder ein Beispiel, dass die Informatiker-Jobs heute nur noch durch 5-jaehrige Schimpansen (ungelernte ;-)) besetzt werden.

Bei mir gab es letztendlich nur einen gravierenden Fehler. Von den mitgelieferten Akkus des Pulse war einer defekt. Bei mir sind das zwei AA-Zellen auf LiBasis! Ein Nachladen mit einem Lithium-1.5V-Lader hat keinen Erfolg gebracht. Erst der Austausch gegen 2 neue Zellen war erfolgreich.

=App=
[[Datei:TibberAppIcon.png|mini|TibberAppIcon]]
Die App find ich ziemlich verquer. Sobald Rechnungsanschrift und Installationsorte unterschiedlich sind, geht das Chaos los. Auch der Support tut sich dann schwer. Ich traue mich gar nicht so richtig weitere Vertraege abzuschlieszen.
Alles ueber die App machen zu wollen/muessen ist ... Das gehoert fuer mich ins WebUserPortal.

Was echt nervt ist, dass sich gefühlt jeden Monat das LookandFeel aendert. Schon die dritte oder vierte Designaenderung des Homescreens (Zuhause).

=API=
Da die App eher suboptimal ist, habe ich recht zuegig damit angefangen mir die notwendigen Infos ueber die API auf eine Infoseite im Intranet zu holen. Ein Integration in FHEM steht noch aus.

=Erste Schritte=

Uebersicht [https://developer.tibber.com/docs/overview]

Zusammenfassung: Die Plattform wird über GraphQL verfügbar gemacht, eine Technologie, die von Facebook konzipiert und entwickelt wurde.

==Was ist GraphQL?==

[https://de.wikipedia.org/wiki/GraphQL Wikipedia]

[https://github.com/graphql GraphQL]

===ChatGPT zu GraphQL===

GraphQL ist eine von Facebook entwickelte Abfragesprache und Laufzeitumgebung für APIs (Application Programming Interfaces). Im Gegensatz zu traditionellen RESTful APIs, bei denen die Client-Anwendung verschiedene Endpunkte aufruft, um Daten abzurufen oder zu manipulieren, ermöglicht GraphQL dem Client, genau die Daten abzurufen, die er benötigt, indem er eine einzige Abfrage an den Server sendet.

Hier sind einige Hauptmerkmale von GraphQL:

'''Declarative Datenabfrage''': Der Client spezifiziert genau, welche Daten er vom Server erhalten möchte, indem er eine GraphQL-Abfrage definiert, die die benötigten Felder und deren Struktur beschreibt. Dadurch kann der Client genau die Daten erhalten, die er benötigt, ohne Overfetching oder Underfetching.
'''Typsystem''': GraphQL definiert ein Typsystem, das die Struktur und den Typ der Daten beschreibt, die von der API zurückgegeben werden können. Dies ermöglicht eine strikte Typisierung und verbesserte Dokumentation.
'''Single-Endpoint-Architektur''': Im Gegensatz zu RESTful APIs, die oft mehrere Endpunkte für verschiedene Ressourcentypen haben, hat eine GraphQL-API normalerweise nur einen Endpunkt, über den alle Abfragen und Mutationen gesendet werden.
'''Echtzeitfähigkeit''': GraphQL unterstützt auch Abonnements, die es ermöglichen, Daten in Echtzeit zu empfangen, wenn sich etwas ändert. Dies ist besonders nützlich für Anwendungsfälle wie Live-Chats, Benachrichtigungen und Echtzeit-Dashboard-Aktualisierungen.
'''Entwicklungserfahrung''': GraphQL bietet eine verbesserte Entwicklererfahrung, da Clients genau die Daten erhalten können, die sie benötigen, und Entwickler APIs schneller entwickeln können, ohne sich um Versionierung oder unerwartete Seiteneffekte durch Änderungen an der Backend-API kümmern zu müssen.

Insgesamt bietet GraphQL eine flexible, effiziente und moderne Möglichkeit, APIs zu entwerfen und zu verwenden, die den Anforderungen moderner Anwendungen besser gerecht wird als traditionelle RESTful APIs.

Auf der Tibber-Seite heiszt es:

The GraphQL query language is basically about selecting fields on objects.

Was dies bedeutet kommt weiter unten. Weiter heiszt es auf der Tibber Seite.

GraphQL ist eine Abfragesprache für Ihre(? unsere) API und eine serverseitige Laufzeitumgebung zum Ausführen von Abfragen mithilfe eines Typsystems, das Sie für Ihre Daten definieren. GraphQL ist nicht an eine bestimmte Datenbank oder Speicher-Engine gebunden und wird stattdessen durch Ihren vorhandenen Code und Ihre Daten unterstützt.

Mit der Uebersetzung von Google hadere ich noch. Der Satz kommt vermutlich ursrpruenglich von Facebook und wurde von Tibber 1:1 uebernommen.

Der naechste Satz gibt schon mehr Aufschluss:
Tibber hat sich für GraphQL als API entschieden, weil es unseren Integratoren und uns selbst Flexibilitaet bietet. Die Moeglichkeit, die gewuenschten Daten genau zu definieren, macht die Nutzung wesentlich einfacher als herkoemmliche [https://www.ibm.com/de-de/topics/rest-apis REST-basierte APIs]. Es ist auch sehr schoen, dass die serverseitige Implementierung von GraphQL sehr gut mit unserer Microservice-Architektur zusammenspielt :-)

Zum Einstieg nutze ich den [https://developer.tibber.com/explorer Api Explorer im TibberDev]. Nachdem man sich dort einen Personal Token angelegt hat, kann's direkt losgehen. Der [https://developer.tibber.com/explorer GraphiQL] hat auch eine Autovervollstaendigung. Sehr praktisch.
[[Datei:TibberDevAccount.png|mini|TibberDevAccount]]
Die Root-Types sind
*query: Query
*mutation: RootMutation
*subscription: RootSubscription
*fragment feht irgendwie in der Doc

Der Aufbau ist recht simpel und das Doc in knapp einer Stunde durchprobiert. So dass ich dann schnell an dem Punkt angelangt bin, dass ich ein Programm (PHP, Python oder JavaScript) brauche welches die fuer mich interessanten Daten in meine MySQL-DB uebertraegt. Ob ich zuerst anzeige und dann speichere, also sozusagen ueber die Datenbank puffere, oder umgekehrt muss ich noch festlegen.

===ChatGPT zum Subprotokoll===

Das Subprotokoll "graphql-transport-ws" ist ein WebSocket-Subprotokoll, das speziell für die Kommunikation zwischen Client und Server in GraphQL-Anwendungen entwickelt wurde. Es basiert auf dem WebSocket-Protokoll, das eine bidirektionale, persistente Verbindung zwischen einem Client und einem Server ermöglicht.

Im Kontext von GraphQL wird "graphql-transport-ws" verwendet, um GraphQL-Abfragen, Mutationen und Abonnements über WebSocket-Verbindungen zu übertragen. Im Gegensatz zum traditionellen HTTP-Protokoll, das eine separate Anfrage-Antwort-Struktur hat, ermöglicht WebSocket eine kontinuierliche Kommunikation zwischen Client und Server, was besonders nützlich ist, wenn Echtzeit-Aktualisierungen benötigt werden, wie bei Abonnements in GraphQL.

Das Subprotokoll "graphql-transport-ws" definiert spezifische Nachrichtenformate und Handshake-Verfahren, die für die GraphQL-Kommunikation über WebSockets erforderlich sind. Durch die Verwendung dieses Subprotokolls können Entwickler GraphQL-Anwendungen erstellen, die von den Echtzeitfähigkeiten von WebSocket profitieren, ohne auf die Vorteile und Flexibilität von GraphQL verzichten zu müssen.

==Mehrfacher Hinweis Subprotokolwechsel Dezember 2022==

Die TibberAPI unterstuetzte zunaechst GraphQL-Websocket-Subscriptions mithilfe des Unterprotokolls graphql-ws. Diese Bibliothek wird/wurde jedoch archiviert und nicht mehr gepflegt. Daher wurde am 31. Maerz 2022 die Unterstützung für das Unterprotokoll graphql-transport-ws hinzugefuegt.

Die Unterstuetzung für das alte Protokoll wird im Dezember 2022 entfernt. Gleichzeitig aendert sich auch die URL für die Verbindung zum Websocket-Server. Zuvor konnte die Verbindung unter '''wss://api.tibber.com/v1-beta/gql/subscriptions''' hergestellt werden. Nach der Aenderung muss die URL ueber GraphQL abgefragt werden (siehe Beispiel unten) und der Client muss das Unterprotokoll graphql-transport-ws unterstuetzen.

<syntaxhighlight code=xml>
Frage:
{
viewer {
websocketSubscriptionUrl
}
}

Antwort:
{
"data": {
"viewer": {
"websocketSubscriptionUrl": "wss://websocket-api.tibber.com/v1-beta/gql/subscriptions"
}
}
}
</syntaxhighlight>

==Anfragenbegrenzung==
Zum Schutz der API gilt eine Ratenbegrenzung von 100 Anfragen in 5 Minuten pro IP-Adresse. Beachten Sie, dass die Preise einmal täglich am Nachmittag berechnet werden (für Norwegen und Schweden sind sie zunächst vorläufig und werden später möglicherweise mit geringfügigen Änderungen nach Bestätigung der Wechselkurse endgültig festgelegt). Sie können „priceInfo.today“ und „priceInfo.tomorrow“ verwenden, um sie im Voraus abzurufen, anstatt nur „priceInfo.current“ für die aktuelle Stunde zu verwenden.

=In medias res=
Zum Starten empfiehlt die Tibber-API-Doc, die fundamentalen Konzepte von GraphQL, die Kommunikation mit der API und den Explorer.

Um die nachfolgenden Beispiele schnell zu verstehen, hier der Link zur [https://developer.tibber.com/docs/reference API-Referenz]

Bei der GraphQL-Abfragesprache geht es im Wesentlichen um die Auswahl von Feldern in Objekten.

Auf der Docs-Reference-Seite gibt es einen interessanten Hinweis:
This reference is auto-generated from https://api.tibber.com

Es koennte als eine URL geben, die einem die aktuelle '''Tibber GraphQL Schema Reference''' direkt zur Auswertung ausgibt. Der Umweg ueber das Parsen der HTML-Ausgabe ginge zur Not natuerlich auch.

==Objekt Typen==

Die Begriffsdifferenzierung Objekt und Object Types ist mir derzeit noch nicht klar. Ich werde wohl um die allgemeine [https://github.com/graphql/graphql-spec Spec von GraphQL] nicht herumkommen:-(

Bei 'Home' wird von einem Objekttyp gesprochen. Klar ist man hat Objekte, die mit dem Schluesselwort type eingeleitet und dann beschrieben werden.

Einige Felder sind Skalare (Boolesche Werte, Zeichenfolgen, Ganzzahlen, Gleitkommazahlen), waehrend andere Objekttypen sind (Adresse, LegalEntity). Eine GraphQL-Abfrage muss vollstaendig auf Skalarebene sein. D.h. in einer Abfrage duerfen die abgefragten Felder keine Objekte (keine weiteren Objekttypen) sein, sondern hierarchisch heruntergebrochen auf weitere Inhalte bis es Skalare sind.

<syntaxhighlight lang=xml>
This query is valid:

{
homes{
id
}
}

This is not:

{
homes{
id
owner <- hier ist der Fehler. Dies ist kein Skalar!
}
}

The owner field is an object type and you would need to specify which scalar fields you would like returned:

{
homes{
id
owner{
name
}
}
}
</syntaxhighlight>

==query Datenabfrage (read)==

query->viewer

Zuerst mit homes die Zaehlerplatz-iD holen und dan mit home (id: "<ID>") nur die data dazu holen.

Hello World;-)
{
viewer {
login
name
userId
accountType
home (id: "1cdd8b6d-956c-447f-9b95-9a57801eaf4c") {
id
features {
realTimeConsumptionEnabled
}
subscriptions {
id
}
currentSubscription {
id
}
meteringPointData {
consumptionEan
gridCompany
gridAreaCode
priceAreaCode
productionEan
energyTaxType
vatType
estimatedAnnualConsumption
}
owner {
id
}
mainFuseSize
}
websocketSubscriptionUrl
}
}

Interessant fand ich z.B.

"priceAreaCode": "Amprion",

"estimatedAnnualConsumption": 500

"mainFuseSize": null

und was da noch alles an Daten einzutragen ist.
size: Int
The size of the home in square meters

==mutation Datenveraenderung (write)==

Mutationen gibt es nur 3, wobei die erste bei mir entfaellt.

sendMeterReading(input: MeterReadingInput!): MeterReadingResponse!
Send meter reading for home (only available for Norwegian users)

updateHome(input: UpdateHomeInput!): Home!
Update home information

sendPushNotification(input: PushNotificationInput!): PushNotificationResponse!
Send notification to Tibber app on registered devices

==subscription==

Subscription hat nur 2 Felder, wobei dauerhaft nur das erste interessant ist.

liveMeasurement(homeId: ID!): LiveMeasurement
Subscribe to real-time measurement stream from Pulse or Watty device

testMeasurement(homeId: ID!): LiveMeasurement
Subscribe to test stream

<syntaxhighlight lang=xml>
subscription{
liveMeasurement(homeId: "<homeID>"){
timestamp
power
lastMeterConsumption
accumulatedConsumption
accumulatedProduction
accumulatedConsumptionLastHour
accumulatedProductionLastHour
accumulatedCost
accumulatedReward
currency
minPower
averagePower
maxPower
powerProduction
powerReactive
powerProductionReactive
minPowerProduction
maxPowerProduction
lastMeterProduction
powerFactor
voltagePhase1
voltagePhase2
voltagePhase3
currentL1
currentL2
currentL3
signalStrength
}
}
</syntaxhighlight>

==fragment==

?

Dazu habe ich bisher keine weiteren Infos gefunden.

=Programmierung=

Bei der Programmierung steht bei mir hier die Client-Programmierung im Vordergrund.

==Query/Mutation==

Die Abfragen und Aenderungen zu programmieren sind schnell erledigt.

Der Einstieg auf der Konsole gelingt mit curl recht gut.

<syntaxhighlight lang=bash>
curl \
-H "Authorization: Bearer 5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE \
-H "Content-Type: application/json" \
-X POST \
-d 'mutation{ sendMeterReading(input:{homeId:"some home id", reading: 123}){time reading }}' https://api.tibber.com/v1-beta/gql
</syntaxhighlight>

==Subscription==

Die Subscriptions sind schon ein wenig anspruchsvoller zu programmieren als Query und Mutation (QuM).
Ist QuM eine simple http-Anfrage mit einer Antwort im JSON-Format, ist es bei den Subscriptions ein Websocket, der einmal geoeffnet in unregelmaeszigen Abstaenden JSON-Pakete liefert.

===Anforderungen für Websocket-Abonnement-Clients===

* Clients muessen den User-Agent-Header festlegen, wenn sie die GraphQL-API aufrufen und eine Websocket-Verbindung oeffnen. Sowohl die Plattform als auch die Treiberversion muessen angegeben werden. Z.B. Homey/10.0.0 com.tibber/1.8.3
* Clients müssen das Unterprotokoll graphql-transport-ws implementieren
* Clients müssen Jitter und exponentielles Backoff implementieren, wenn sie Anfragen an die API wiederholen
* Clients müssen die WebSocket-Server-URL dynamisch abfragen

===Best Practices für die Implementierung von WebSocket-Abonnement-Clients===

Bei der Implementierung eines Clients zum Abonnieren von Live-Daten sind einige Szenarien zu beruecksichtigen:
* Keine Daten aufgrund von Netzwerkproblemen: Es kann sinnvoll sein, einen Wiederverbindungsmechanismus zu implementieren, falls mehrere Minuten lang keine Daten empfangen wurden. Bei einem erneuten Versuch muss zunaechst die alte Websocket-Verbindung zerstoert und ordnungsgemaeszer Jitter und exponentielle Verzoegerung implementiert werden.
* Ein Echtzeitgeraet wird moeglicherweise entfernt. Es wird empfohlen, vor dem erneuten Verbinden immer zu ueberpruefen, ob home.features.realTimeConsumptionEnabled einen echten Wert hat.
* Eine WebSocket-Verbindung kann aufgrund eines ungueltigen Authentifizierungstokens verboten sein (z. B. weil ein Benutzer möglicherweise sein Tibber-Konto entfernt hat). In diesem Fall darf der Client es nicht mit demselben Token erneut versuchen. Stattdessen muss der Autorisierungsprozess erneut ausgeführt werden, wobei der Benutzer neue Anmeldeinformationen eingibt.
* Es kann zu einem Neustart der Tibber-Websocket-API kommen, was bedeutet, dass die Verbindung mit dem "Code 1001" und dem Grund "Going away" geschlossen wird. In diesem Fall kann der Client nach einer zufälligen Verzoegerung von 1 bis 60 Sekunden (Jitter angewendet) die Verbindung wiederherstellen, um zu vermeiden, dass alle Clients gleichzeitig die Verbindung wiederherstellen.

In PHP habe ich wenig bis gar nichts gefunden. Ich wollte mir auch einfach die Nutzung einer GraphQL-Library ersparen. Python habe ich erst einmal an den Schluss verschoben und einem Integration in FHEM den Vorzug gegeben.

===Perl (FHEM)===
Hier der Code der tatsaechlich funktioniert, obwohl er an ein paar Stellen nicht so vorgeht wie ich aus den Tibber-Docs erwartet hatte.

HINWEIS: Dies ist der "nackte" Perl-Code. In der "Originaldatei" sind noch die "FHEM-Escapes" doppelter Strichpunkt und Zeilenfolgezeichen \ enthalten. Eine Eingabe ueber die FHEM-Kommandozeile hat bei mir nicht funktioniert. Erst das direkte Einkopieren in die fhem.conf zeigte das nachfolgende, funktionierende Ergebnis.

<syntaxhighlight lang="perl" line>
connect:cmd:.connect {
my $hash = $defs{$name};
my $devState = DevIo_IsOpen($hash);
return "Device already open" if (defined($devState));

# establish connection to websocket
# format must also include portnumber if a path is to be specified
$hash->{DeviceName} = AttrVal($name, "websocketURL", "wss:echo.websocket.org:443");

# special headers needed for Tibber, see also Developer Tools in Browser
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';
$hash->{header}{'Host'} = 'websocket-api.tibber.com';
$hash->{header}{'Origin'} = 'https://developer.tibber.com';

# callback function when "select()" signals data for us
# websocket Ping/Pongs are treated in DevIo but still call this function
$hash->{directReadFn} = sub () {
my $hash = $defs{$name};

# we can read without closing the DevIo, because select() signalled data
my $buf = DevIo_SimpleRead($hash);

# if read fails, close device
if(!defined($buf)) {
DevIo_CloseDev($hash);
$buf = "not_connected";
}

#Log(3, "$name:$reading: websocket data: >>>$buf<<<");

# only update our reading if buffer is not empty and if last update is older than minInterval
if ($buf ne "") {
my $websocketDataAge = ReadingsAge($name, "websocketData", 3600);
my $minInterval = AttrVal($name, "minInterval", 0);
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);

readingsBeginUpdate($hash);
readingsBulkUpdate($hash, "websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);
readingsBulkUpdate($hash, "websocketData", "$buf") if (!$isNext);
readingsEndUpdate($hash, 1);
}
};

# open DevIo websocket
DevIo_OpenDev($hash, 0, undef, sub(){
my ($hash, $error) = @_;
return "$error" if ($error);

my $token = AttrVal($name, "token", "???");

DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);
});
readingsBulkUpdate($hash, "websocketData", "");

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
disconnect:cmd:.disconnect {
my $hash = $defs{$name};
RemoveInternalTimer($hash);
DevIo_SimpleRead($hash);
DevIo_CloseDev($hash);

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onDisconnect {
my $myState = ReadingsVal($name, "state", "???");
my $myData = ReadingsVal($name, "websocketData", "???");
return if ($myState ne "disconnected" and $myData ne "not_connected");

## timer callback function, called after a few seconds to initiate a reconnect
my $timerFunction = sub() {
my ($hash) = @_;
my $devState = DevIo_IsOpen($hash);

# only re-connect if device is not connected
readingsSingleUpdate($hash, "cmd", "connect", 1) if (!defined($devState));
};
my $hash = $defs{$name};
RemoveInternalTimer($hash, $timerFunction);

# wait a random time before reconnect (exponential backoff TBD):
my $rwait = int(rand(200)) + 30;
InternalTimer(gettimeofday() + $rwait, $timerFunction, $hash);
readingsBulkUpdate($hash, "cmd", "reconnect attempt in $rwait seconds");

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onConnectionAck:websocketData:.*connection_ack.* {
#websocketData contains the string "connection_ack"
Log(3, "$name:$reading: got connection ack");

# do not proceed if connection is lost
my $hash = $defs{$name};
my $devState = DevIo_IsOpen($hash);
return "Device not open" if (!defined($devState));

readingsBulkUpdate($hash, "cmd", "got connection ack");

my $homeId = AttrVal($name, "homeId", "???");
my $myId = AttrVal($name, "myId", "???");

# build the query, do it in pieces, the comma at the end caused perl errors
# so we put it together in this not very elegant way
my $json = '{ "id":"'. $myId .'", "type":"subscribe"'.", ";
$json .= '"payload":{';
$json .= '"variables":{}'.", ";
$json .= '"extensions":{}'.", ";
$json .= '"query":"subscription { liveMeasurement( homeId: \"'.$homeId.'\" ) ';
$json .= '{ timestamp power lastMeterConsumption accumulatedConsumption accumulatedProduction ';
$json .= 'accumulatedProductionLastHour accumulatedCost accumulatedReward currency minPower averagePower maxPower ';
$json .= 'powerProduction powerReactive powerProductionReactive minPowerProduction maxPowerProduction lastMeterProduction ';
$json .= 'powerFactor voltagePhase1 voltagePhase2 voltagePhase3 signalStrength }}"';
$json .= '}}';

#send the string via websocket as ASCII
Log(3, "$name:$reading: sending JSON: >>>$json<<<");
DevIo_SimpleWrite($hash, $json, 2);

return POSIX::strftime("%H:%M:%S",localtime(time()));
},
onNextLiveMeasurement:websocketData:.*next.*payload.*data.*liveMeasurement.* {
#websocketData contains next-live-measurement-data
my $val = ReadingsVal($name, "websocketData", "{}");
my %res = %{json2nameValue($val, undef, undef, "payload_data_liveMeasurement.*")};

my $ret = "got values for:\n";
foreach my $k (sort keys %res) {
$ret .= "$k\n";
readingsBulkUpdate($hash, makeReadingName($k), $res{$k});
}
return $ret;
}
</syntaxhighlight>

====Code Analyse====

Es gibt 5 Eintrittspunkte:
* connect
* disconnect
* onDisconnect
* onConnectionAck
* onNextLiveMeasurement

Die ersten beiden legen die Befehlsfolgen für ein Start-Kommando (set cmd connect, bzw. set cmd disconnect) oder Stop-Kommando fest.
Die letzten 3 reagieren auf die entsprechenden Events.
=====connect=====

Lexikalische Variablen mittels my, bzw. my()

Jede Variable, die mit our deklariert oder auch "einfach so" ohne eine Deklaration verwendet wird, wird in die Symboltabelle des jeweils aktuellen Packages aufgenommen.
Deklariert man dagegen eine Variable mit dem Operator my, so wird die entsprechende Variable in einer anderen Tabelle abgelegt, auf die kein expliziter Zugriff möglich ist.
Neben der Tatsache, daß my-Variablen in einer eigenen Tabelle verwaltet werden, ist von besonderer Bedeutung, daß sie nur einen recht beschränkten Gültigkeitsbereich besitzen. Eine durch my erzeugte Variable steht nur in dem aktuellen Block (definiert durch geschweifte Klammern "{...}"), der aktuellen Datei oder innerhalb eines Arguments von eval() zur Verfügung. Außerhalb davon existieren diese Variablen nicht, es ist also (im Gegensatz zu our-Variablen) auch mit Hilfe des Package-Namens dort kein Zugriff möglich
Es kann in einem Package durchaus zwei Variablen gleichen Namens geben: eine in der Symboltabelle und eine, die durch einen Aufruf von my entstanden ist. In einem solchen Falle wird bei einfacher Verwendung des Bezeichners auf die my-Variable zugegriffen.

In $defs stehen alle Defines drin. In $hash wird also der Name des des aufrufenden Devices lokal hinterlegt und danach mit DevIO_IsOpen() der Status abgefragt.
$defs ist ein Hash. Ein Hash ist ein anderer Namen fuer ein assoziatives Array. Also eine ungeordnete Liste von Skalaren (Zahl oder String) die ueber einen Stringwert angesprochen (Lookup) werden koennen.

FHEM-Spezial:
In $defs findet man alle Devices, z.b. $defs{"Rolladen_Tuere"} beinhaltet das Device.
my @alle = keys %defs;
my @teilmenge = defInfo('TYPE=notify','NAME'); liefert ein array mit allen notify devices.
z.B. my @teilmenge = defInfo('NAME=Rollladen.*','NAME');

return "Device already open" if (defined($devState));
Sollte also das Device bereits im State "offen" sein, wird die connect-Routine abgebrochen. Dann erscheint in den Readings nicht Datum/Uhrzeit des Connects sondern die Meldung "Device already open".

# establish connection to websocket
# format must also include portnumber if a path is to be specified
$hash->{DeviceName} = AttrVal($name, "websocketURL", "wss:echo.websocket.org:443");

HASH-Operationen (Beispiel):
$href ={APR => 4,AUG => 8}; #anonymous hash
$el = $href->{APR}; $el = %{$href}{APR}; #access element of hash
$href2 = {%{$href1}}; #copy hash
if (ref($r) eq "HASH") {} #checks if $r points to hash

Dem Internal "DeviceName" wird das Ergebnis von AttrVal() zugewiesen. Bei mir ergab das:
DeviceName wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions

FHEM-Referenz:
AttrVal(<devicename>,<attribute>,<defaultvalue>)
Gibt das entsprechende Attribut des Gerätes zurück
{ Value("wz") }
{ OldValue("wz") }
{ time_str2num(OldTimestamp("wz")) }
{ ReadingsVal("wz", "measured-temp", "20")+0 }
{ ReadingsTimestamp("wz", "measured-temp", 0)}
{ AttrVal("wz", "room", "none") }

Das Attribut websocketURL ist bei mir wss:websocket-api.tibber.com:443/v1-beta/gql/subscriptions. Somit erklaert sich auch der Eintrag bei DeviceName. "wss:echo.websocket.org:443" ist nur der Defaultwert.

Man haette zum Testen auch die folgenden beiden verwenden/eintragen koennen.
There are free test servers that we can use to experiment with a WebSocket client, such as:

Hoppscotch – wss://echo-websocket.hoppscotch.io (GUI)
λ if else – wss://ws.ifelse.io (GUI)

Both provide a GUI for testing via a browser. The former sends a timestamp to the client every second but doesn’t respond to client messages. The latter is a standard echo service that sends a copy of each received message back to the client. Both make sense in testing.

Da curl nicht nativ websocket-Kommunikation unterstuetzt kann man auf folgende Tool ausweichen. Auch chrome bietet ein Websocket-Client-Plugin.
*wssh3
*websocat
*wscat

# special headers needed for Tibber, see also Developer Tools in Browser
$hash->{header}{'Sec-WebSocket-Protocol'} = 'graphql-transport-ws';
$hash->{header}{'Host'} = 'websocket-api.tibber.com';
$hash->{header}{'Origin'} = 'https://developer.tibber.com';

# callback function when "select()" signals data for us
# websocket Ping/Pongs are treated in DevIo but still call this function

$hash->{directReadFn} = sub () {
my $hash = $defs{$name};

# we can read without closing the DevIo, because select() signalled data
my $buf = DevIo_SimpleRead($hash);

# if read fails, close device
if(!defined($buf)) {
DevIo_CloseDev($hash);
$buf = "not_connected";
}

#Log(3, "$name:$reading: websocket data: >>>$buf<<<");

# only update our reading if buffer is not empty and if last update is older than minInterval
if ($buf ne "") {
my $websocketDataAge = ReadingsAge($name, "websocketData", 3600);
my $minInterval = AttrVal($name, "minInterval", 0);
my $isNext = ($buf =~ /.*id.*type.*next.*payload.*data.*liveMeasurement.*/s);

readingsBeginUpdate($hash);
readingsBulkUpdate($hash, "websocketData", "$buf") if ($isNext && $websocketDataAge > $minInterval);
readingsBulkUpdate($hash, "websocketData", "$buf") if (!$isNext);
readingsEndUpdate($hash, 1);
}
};

Die Callback-Funktion wird direkt, ohne Namen, in das/den (?) Hash unter directReadFn abgelegt.
Die Callback-Funktion:
Hier wird mit Hilfe der Funktion DevIo_SimpleRead() die Rueckmeldung des Server eingelesen. Siehe [https://wiki.fhem.de/wiki/DevIo]
Hinweis zum Logging in FHEM: [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#Logging]
Die eigentliche Aktivitaet geschieht in den sieben Zeilen am Ende der Callback-Fkt.
ReadingsAge(<devicename>,<reading>,<defaultvalue>) #gibt das Alter des Readings in Sekunden zurück.
AttrVal hatten wir schon.
isNext bekommt seinen Wert aus dem durch einen REGEX geliefert Wert des Buffers. Beispiel ($match) = ($dirty =~ /^(.*)$/s);

Die Funktion readingsBeginUpdate() bereitet die Definition mit dem Hash $hash auf ein Update von Readings vor. Dies betrifft insbesondere das Setzen von Umgebungsvariablen sowie dem aktuellen Zeitstempel als Änderungszeitpunkt. Der Aufruf dieser Funktion ist notwendig um eigentliche Updates mit der Funktion readingsBulkUpdate() auf der gewünschten Definition durchführen zu können. [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#readingsBeginUpdate]

Die Funktion readingsEndUpdate() beendet den Bulk-Update Prozess durch die Funktionen readingsBeginUpdate() & readingsBulkUpdate() und triggert optional die entsprechenden Events sämtlicher erzeugter Readings für die Definition $hash. Desweiteren werden nachgelagerte Tasks wie bspw. die Erzeugung von User-Readings (Attribut: userReadings), sowie die Erzeugung des STATE aufgrund des Attributs stateFormat durchgeführt. Sofern $do_trigger gesetzt ist, werden alle anstehenden Events nach Abschluss getriggert.

# open DevIo websocket
DevIo_OpenDev($hash, 0, undef, sub(){
my ($hash, $error) = @_;
return "$error" if ($error);

my $token = AttrVal($name, "token", "???");

DevIo_SimpleWrite($hash, '{"type":"connection_init","payload":{"token":"'.$token.'"}}', 2);
});

Das ist die eigentliche Kontaktaufnahme.

Dies dient vermutlich dazu, bis zum ersten Empfang von Daten, das Reading websocketDate zu leeren.

return POSIX::strftime("%H:%M:%S",localtime(time()));

Zum Abschluss ercheint dann im Reading connect die aktuelle Zeit.

readingsBulkUpdate($hash, "websocketData", "");

=====disconnect=====

<syntaxhighlight lang="python" line>
disconnect:cmd:.disconnect {
my $hash = $defs{$name};
RemoveInternalTimer($hash);
DevIo_SimpleRead($hash);
DevIo_CloseDev($hash);
return POSIX::strftime("%H:%M:%S",localtime(time()));
</syntaxhighlight>

Erlaeuterung:

*Die Funktion RemoveInternalTimer löscht möglicherweise noch anstehende Timer welche mit dem Übergabeparameter $arg gescheduled sind. Optional kann man zusätzlich die Suche auf eine bestimmte Funktion $functionName weiter einschränken. [https://wiki.fhem.de/wiki/DevelopmentModuleAPI#RemoveInternalTimer]

*Die Funktion DevIo_SimpleRead() liest anstehende Daten für die Verbindung von $hash ein und gibt diese zurück. [https://wiki.fhem.de/wiki/DevIo#DevIo_SimpleRead()]

*Die Funktion DevIo_CloseDev() schließt eine evtl. geöffnete Verbindung für die Definition $hash. [https://wiki.fhem.de/wiki/DevIo#DevIo_CloseDev()]

*POSIX:: [https://metacpan.org/pod/POSIX#strftime]

=====onDisconnect=====
TODO

=====onConnectionAck=====
TODO

=====onNextLiveMeasurement=====
TODO

===JavaScript===
Zum Eingewoehnen:

<syntaxhighlight lang=javascript>
// WebSocket-Verbindung herstellen
const socket = new WebSocket('ws://echo.websocket.org');

// Event-Handler für Verbindungsereignisse
socket.onopen = function(event) {
console.log('WebSocket-Verbindung hergestellt.');
// Nachricht senden, sobald die Verbindung hergestellt ist
socket.send('Hallo Server!');
};

socket.onmessage = function(event) {
console.log('Nachricht vom Server erhalten:', event.data);
};

socket.onclose = function(event) {
console.log('WebSocket-Verbindung geschlossen.');
};

socket.onerror = function(error) {
console.error('WebSocket-Fehler aufgetreten:', error);
};
</syntaxhighlight>

Und jetzt das Gerippe fuer Tibber mit Haut versehen:

<syntaxhighlight lang=javascript>
const WebSocket = require('ws');

const query = `subscription {
liveMeasurement(homeId: "96a14971-525a-4420-aae9-e5aedaa129ff") {
timestamp
power
accumulatedConsumption
minPower
maxPower
averagePower
voltagePhase1
currentL1
accumulatedCost
currency
}
}`;

// WebSocket-Verbindung herstellen
const socket = new WebSocket('wss://websocket-api.tibber.com/v1-beta/gql/subscriptions',['graphql-transport-ws'], {
headers: {
'Content-Type': 'application/json',
'User-Agent': 'NodeJS tibberview',

}
});

// Event-Handler für Verbindungsereignisse
socket.onopen = function(event) {
console.log("WebSocket-Verbindung hergestellt.");
// Nachricht senden, sobald die Verbindung hergestellt ist
const connectionQuery = {
type: "connection_init",
payload: {
token: "5K4MVS-OjfWhK_4yrjOlFe1F6kJXPVf7eQYggo8ebAE",
}
};

socket.send(JSON.stringify(connectionQuery));
console.log("Verbindung zum 'Tibber feed' hergestellt.");
};

socket.onmessage = function(event) {
console.log("Nachricht vom Server erhalten:", event.data);
const msg = JSON.parse(event.data);

if (msg.type === "connection_ack") {
console.log("Tibber ACK empfangen: ", msg);

const realtimeDataQuery = {
id: "96a14971-525a-4420-aae9-e5aedaa129ff",
type: "subscribe",
payload: { query }
};

socket.send(JSON.stringify(realtimeDataQuery));
}
else if (msg.type === "next") {
if (!msg.payload.data) {
console.log("⚠ Nachricht hat keinen Inhalt.");
return;
}
const data = msg.payload.data.liveMeasurement;
socket.emit("data", data);
} else {
console.log("Nachrichteninhalt: ", msg)
}
};

socket.onclose = function(event) {
console.log('WebSocket-Verbindung geschlossen.');
};

socket.onerror = function(error) {
console.error('WebSocket-Fehler aufgetreten:', error);
};

</syntaxhighlight>

Das Programm erzeugte folgende Ausgabe:
<syntaxhighlight lang=bash>
worker:/mnt/1.5T_RAID/Programme/JavaScript/WebSocket # node tibberclient_demo.js
WebSocket-Verbindung hergestellt.
Verbindung zum 'Tibber feed' hergestellt.
Nachricht vom Server erhalten: {"type":"connection_ack"}
Tibber ACK empfangen: { type: 'connection_ack' }
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:48.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.6,"voltagePhase1":230.1,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:51.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.3,"voltagePhase1":229.8,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:52.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.3,"voltagePhase1":230,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:53.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.2,"voltagePhase1":230.3,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:54.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306.1,"voltagePhase1":230.3,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:55.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306,"voltagePhase1":230.2,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:56.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2306,"voltagePhase1":229.8,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:57.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.9,"voltagePhase1":229.9,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:58.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.8,"voltagePhase1":230.1,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:46:59.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.8,"voltagePhase1":230.4,"currentL1":2.6,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:47:00.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.7,"voltagePhase1":230.1,"currentL1":2.7,"accumulatedCost":11.672781,"currency":"SEK"}}}}
Nachricht vom Server erhalten: {"id":"96a14971-525a-4420-aae9-e5aedaa129ff","type":"next","payload":{"data":{"liveMeasurement":{"timestamp":"2024-03-17T08:47:01.000+01:00","power":0,"accumulatedConsumption":20.258,"minPower":0,"maxPower":5150,"averagePower":2305.6,"voltagePhase1":229.9,"currentL1":2.7,"accumulatedCost":11.672781,"currency":"SEK"}}}}
^C
</syntaxhighlight>

An der Stelle mache ich jetzt einen Ausflug in PHP.

===PHP===
Nachdem der Websocket-Kontakt mit JavaScript funktioniert hat, kommt jetzt ein Serverprogramm was folgendes tun soll.

*Abfrage der Basisdaten
*Objekt Types Builder
*Mutation
*Websocket Subsrciption

TODO

===Python===

Quelle: https://github.com/Danielhiversen/pyTibber

Client-Beispiel mit eingesetzem DEMO_TOKEN und user_agent
Obwohl DEMO_TOKEN in tibber.py definiert ist, wird es nicht uebernommen.
<syntaxhighlight lang=python>
import tibber.const
import tibber
import asyncio

async def start():
tibber_connection = tibber.Tibber(tibber.const.DEMO_TOKEN, user_agent="worker")
await tibber_connection.update_info()
print(tibber_connection.name)

home = tibber_connection.get_homes()[0]
await home.fetch_consumption_data()
await home.update_info()
print(home.address1)

await home.update_price_info()
print(home.current_price_info)

# await tibber_connection.close_connection()

loop = asyncio.run(start())
</syntaxhighlight>

<syntaxhighlight lang=python>
import tibber.const
import asyncio

import aiohttp
import tibber

def _callback(pkg):
print(pkg)
data = pkg.get("data")
if data is None:
return
print(data.get("liveMeasurement"))

async def run():
async with aiohttp.ClientSession() as session:
tibber_connection = tibber.Tibber(tibber.const.DEMO_TOKEN, websession=session, user_agent="worker")
await tibber_connection.update_info()
home = tibber_connection.get_homes()[0]
await home.rt_subscribe(_callback)

while True:
await asyncio.sleep(10)

loop = asyncio.run(run())
</syntaxhighlight>