neues Modul 50_Alfen.pm zur Steuerung von Alfen Wallboxen über die HTTPS API

[mahil]

Hallo,

im Anhang findet ihr ein Modul zur Steuerung einer Alfen Wallbox über die HTTPS API.

Prinzipiell kann man eine Alfen Wallbox auch über Modbus steuern. Dazu ist aber meist eine eigene Lizenz notwendig, welche mal schlappe 200€ kostet. Die Steuerung über die HTTPS API ist kostenlos.

Folgendes ist über dieses Modul möglich:

• Einstellen des maximalen Ladestroms je Phase
• Umstellung zwischen 1-/3- phasigem Laden. Um dies während einer Ladesession durchführen zu können wird mindestens die Wallbox Firmware 6.4.0-4210 benötigt.
• Reboot der Wallbox
• verschiedene Wallbox Parameter zyklisch auslesen und anzeigen
• Setzen der Wallbox Logindaten

Entwickelt und getestet wurde dieses Modul mit einer Alfen Eve Single Pro-Line und der Firmware 5.8.1-4123 und 6.4.0-4210. Soweit mir bekannt, ist zur Steuerung über die HTTPS API mindestens eine Firmware >= 5.x notwendig. Ab 5.x wurde auch ein Usermanagement eingeführt.

Installation

• Kopieren der angehängten Datei in euer Modulverzeichnis, normalerweise /opt/fhem/FHEM
• Anlegen eines Gerätes mit
  
  Code Auswählen Erweitern
  define <name> Alfen <IP of wallbox> <interval to query the wallbox>
• Setzen des Wallbox Passworts
  
  Code Auswählen Erweitern
  set <name> password <Wallbox password>
• falls der Wallbox User nicht admin lautet, muss dieser noch angepasst werden
  
  Code Auswählen Erweitern
  set <name> user <Wallbox user>

Falls dieses Modul bei euch läuft, wäre ein kurzes Feedback über den Wallbox Typ und die Firmware hilfreich.

Hilfreich bei der Entwicklung dieses Moduls war die Dokumentation des Homeassistant Alfen Addons.

Updates

• 05.07.2023: Version 1.1, Umstellung der Kommunikation zur Wallbox von LWP auf HttpUtils_NonblockingGet
• 12.07.2023: Version 1.2, Lesen der maximal einstellbaren Leistung von der Wallbox, Serialisierung mehrerer get/set Befehle

[betateilchen]

Du solltest in Deinem "Modul" besser die Standardverfahren für die Kommunikation verwenden, die FHEM von Haus aus bereitstellt (HTTPutils.pm, DevIo.pm usw.) anstatt das alles selbst nachbauen zu wollen.

[mahil]

Du solltest in Deinem "Modul" besser die Standardverfahren für die Kommunikation verwenden, die FHEM von Haus aus bereitstellt (HTTPutils.pm, DevIo.pm usw.) anstatt das alles selbst nachbauen zu wollen.

Ist mein erstes FHEM Modul . Werde ich mir genauer anschauen. Danke für den Hinweis.

[rudolfkoenig]

Das Problem mit LWP ist, dass es FHEM auf diverse Weise blockieren kann (Name-Lookup, Connect, Daten holen).

HttpUtils_NonblockingGet tut das nicht, man benutzt sie, wenn man HTTP (oder HTTPS) Abfragen hat.
DevIo.pm ist fuer die "direkte" TCP/IP Kommunikation, ohne HTTP "Overhead".

[mahil]

Das Problem mit LWP ist, dass es FHEM auf diverse Weise blockieren kann (Name-Lookup, Connect, Daten holen).

HttpUtils_NonblockingGet tut das nicht, man benutzt sie, wenn man HTTP (oder HTTPS) Abfragen hat.
DevIo.pm ist fuer die "direkte" TCP/IP Kommunikation, ohne HTTP "Overhead".

Das Problem mit blockieren bei FHEM ist mir durchaus bekannt. Ich dachte das allerdings durch den Aufruf von BlockingCall zu umgehen. Alle LWP Zugriffe sollten damit in einem geforkten Prozess laufen und damit sollte dann der Hauptprozess nicht blockiert werden. Nochmal Danke für die Hinweise. Ich werde das entsprechend umarbeiten.

[rudolfkoenig]

Das Problem mit blockieren bei FHEM ist mir durchaus bekannt. Ich dachte das allerdings durch den Aufruf von BlockingCall zu umgehen.

BlockingCall ist die "Holzhammer-Methode", wenn keine bessere Alternativen zur Verfuegung stehen.
HttpUtils_NonblockingGet ist effizienter, und "nebenwirkungsfrei".

[mahil]

BlockingCall ist die "Holzhammer-Methode", wenn keine bessere Alternativen zur Verfuegung stehen.
HttpUtils_NonblockingGet ist effizienter, und "nebenwirkungsfrei".

Habe das mit HttpUtils_NonblockingGet mal ausprobiert, aber leider nicht zum Laufen gebracht.

Prinzipiell ist bei der Kommunikation mit der Alfen Wallbox der Ablauf wie folgt:

• Login
• Datenabfrage bzw. setzen von Wallbox Parametern
• Logout

Dies muss über mehrere HTTPS Aufrufe realisiert werden. Die Verbindung darf dazwischen nicht geschlossen werden. Damit die Verbindung zwischen den Abfragen nicht geschlossen wird, muss bei der Kommunikation über LWP 'keep_alive' gesetzt werden:

Code Auswählen Erweitern

$ua = LWP::UserAgent->new(keep_alive => 1);
Gleiches habe ich bei HttpUtils_NonblockingGet gesetzt:

Code Auswählen Erweitern

my $param = {
    timeout    => 5,
    hash       => $hash,
    keepalive  => 1,
    loglevel   => 1,
    sslargs    => { SSL_verify_mode => 0},
    callback   => \&Alfen_ParseHttpResponse,
    actions    => $actions # Liste der noch durchzuführenden Aktionen (Login, Datenabfrage, Logout), wird in Alfen_ParseHttpResponse ausgewertet
    ..... die Parameter zur auszuführenden Aktion, beim ersten Aufruf z.B. die Loginparameter
  };
HttpUtils_NonblockingGet($param);
In Alfen_ParseHttpResponse wird dann das Abfrageergebnis ausgewertet und falls in $param->{'actions'} noch ein Eintrag steht, die nächste HTTPS Abfrage ausgelöst.

Das Login hat so auch funktioniert. Bei den anderen Abfragen bekomme ich einen 'HTTP response code 401'. Der FHEM Log sieht dazu wie folgt aus:

Code Auswählen Erweitern

2023.07.03 19:48:40.870 1: performing HttpRequest of type login
2023.07.03 19:48:40.871 2: HttpUtils url=https://192.168.2.91/api/login NonBlocking via https
2023.07.03 19:48:40.871 1: IP: 192.168.2.91 -> 192.168.2.91
2023.07.03 19:48:41.568 2: HttpUtils request header:
POST /api/login HTTP/1.0
Host: 192.168.2.91
User-Agent: fhem
Accept-Encoding: gzip,deflate
Connection: keep-alive
Content-Type: application/json
Content-Length: 62

2023.07.03 19:48:41.973 1: https://192.168.2.91/api/login: HTTP response code 200
2023.07.03 19:48:41.973 2: HttpUtils https://192.168.2.91/api/login: Got data, length: 0
2023.07.03 19:48:41.974 2: HttpUtils response header:
HTTP/1.1 200 OK
Content-Type: alfen/json; charset=UTF-8
Connection: keep-alive
Content-Length: 0
2023.07.03 19:48:41.974 1: parsing HTTPS request
2023.07.03 19:48:41.974 1: init next HTTPS request
2023.07.03 19:48:41.974 1: performing HttpRequest of type get_props
2023.07.03 19:48:41.975 2: HttpUtils url=https://192.168.2.91/api/prop?ids=2221_16 NonBlocking via https
2023.07.03 19:48:41.975 1: IP: 192.168.2.91 -> 192.168.2.91
2023.07.03 19:48:42.664 2: HttpUtils request header:
GET /api/prop?ids=2221_16 HTTP/1.0
Host: 192.168.2.91
User-Agent: fhem
Accept-Encoding: gzip,deflate
Connection: keep-alive
Authorization: Basic YWRtaW46ZjJHcW02TFBxL3FDQ2hMVGQ4c241MFBVeTJrPQ==
Content-Type: application/json

2023.07.03 19:48:42.694 1: https://192.168.2.91/api/prop?ids=2221_16: HTTP response code 401
2023.07.03 19:48:42.694 1: parsing HTTPS request
2023.07.03 19:48:42.694 1: error while requesting https://192.168.2.91/api/prop?ids=2221_16 - https://192.168.2.91/api/prop?ids=2221_16: wrong authentication
2023.07.03 19:48:42.695 1: init next HTTPS request
2023.07.03 19:48:42.695 1: performing HttpRequest of type logout
2023.07.03 19:48:42.696 2: HttpUtils url=https://192.168.2.91/api/logout NonBlocking via https
2023.07.03 19:48:42.696 1: IP: 192.168.2.91 -> 192.168.2.91
2023.07.03 19:48:43.348 2: HttpUtils request header:
POST /api/logout HTTP/1.0
Host: 192.168.2.91
User-Agent: fhem
Accept-Encoding: gzip,deflate
Connection: keep-alive
Authorization: Basic YWRtaW46ZjJHcW02TFBxL3FDQ2hMVGQ4c241MFBVeTJrPQ==
Content-Type: application/json

2023.07.03 19:48:43.372 1: https://192.168.2.91/api/logout: HTTP response code 401
2023.07.03 19:48:43.372 1: parsing HTTPS request
2023.07.03 19:48:43.372 1: error while requesting https://192.168.2.91/api/logout - https://192.168.2.91/api/logout: wrong authentication

Beim Coding habe ich mich am Beispiel für HttpUtils_NonblockingGet() für Modulprogrammierer orientiert.

Das sieht für mich irgendwie aus, als ob der keep_alive nicht funktioniert. Hat hier jemand eine Idee, was ich noch probieren könnte?

Habe es in meiner Testumgebung auch mal mit HttpUtils_BlockingGet probiert. Hat leider auch nicht funktioniert:

Code Auswählen Erweitern

2023.07.03 20:14:35.858 1: performing HttpRequest of type login
2023.07.03 20:14:35.858 2: HttpUtils url=https://192.168.2.91/api/login Blocking via https
2023.07.03 20:14:36.560 2: HttpUtils request header:
POST /api/login HTTP/1.0
Host: 192.168.2.91
User-Agent: fhem
Accept-Encoding: gzip,deflate
Connection: keep-alive
Content-Type: application/json
Content-Length: 62

2023.07.03 20:14:37.133 1: https://192.168.2.91/api/login: HTTP response code 200
2023.07.03 20:14:37.134 2: HttpUtils https://192.168.2.91/api/login: Got data, length: 0
2023.07.03 20:14:37.134 2: HttpUtils response header:
HTTP/1.1 200 OK
Content-Type: alfen/json; charset=UTF-8
Connection: keep-alive
Content-Length: 0
2023.07.03 20:14:37.134 1: performing HttpRequest of type get_props
2023.07.03 20:14:37.134 2: HttpUtils url=https://192.168.2.91/api/prop?ids=2221_16 Blocking via https
2023.07.03 20:14:42.140 1: error while requesting https://192.168.2.91/api/prop?ids=2221_16 - https://192.168.2.91/api/prop?ids=2221_16: Can't connect(2) to https://192.168.2.91:443:  SSL wants a read first
2023.07.03 20:14:42.140 1: performing HttpRequest of type logout
2023.07.03 20:14:42.140 2: HttpUtils url=https://192.168.2.91/api/logout Blocking via https
2023.07.03 20:14:47.147 1: error while requesting https://192.168.2.91/api/logout - https://192.168.2.91/api/logout: Can't connect(2) to https://192.168.2.91:443:  SSL wants a read first
Hier bekomme ich allerdings eine andere Fehlermeldung.

[mifu]

Hallo,
hab gerade nach einer Alfen Sterunung gesucht und direkt gefunden. Super

So ich habe auch die Alfen Pro Line Single mit der Firmware 5.8.1-4123. Das Modul läuft so weit, ich kann die Daten auslesen.Laden muss ich mal noch ausprobieren.

[rudolfkoenig]

Das sieht für mich irgendwie aus, als ob der keep_alive nicht funktioniert. Hat hier jemand eine Idee, was ich noch probieren könnte?

keepalive sollte funktionieren, dafuer muss man beim zweiten Aufruf den gleichen $param an HttpUtils_NonblockingGet uebergeben, wie beim ersten mal.
Callback kann man aendern, genauso wie data und header.
Wichtig ist nur, dass die Gegenseite die Laenge der Antwortdaten mitgibt.

SSL_verify_mode = 0 ist die Voreinstellung.

[mahil]

keepalive sollte funktionieren, dafuer muss man beim zweiten Aufruf den gleichen $param an HttpUtils_NonblockingGet uebergeben, wie beim ersten mal.

Das mit dem gleichen $param war der Fehler. Ich hatte $param immer neu aufgebaut. Habe jetzt eine Version auf Basis von HttpUtils_NonblockingGet bereitgestellt. Vielen Dank für die Hilfestellung.

[Axxl]

Danke für das Modul ! Funktioniert bei mir auf Anhieb mit meiner Wallbox sehr gut.

[der.einstein]

Habe eine Alfen Eve Single Pro mit FW Version 6.6.0-4240.
Funktioniert super!
Vielen Dank für das Modul!

Falls wen das list interessiert:

Code Auswählen Erweitern

Internals:
   API        https://192.168.178.116/api
   CFGFN     
   DEF        192.168.178.116 600
   FUUID      66831a2a-f33f-4dde-8b80-73ecc19c761f202a
   IP         192.168.178.116
   Interval   600
   NAME       Wallbox
   NR         1676
   STATE      Normal Charging (16A/10451.70W)
   TYPE       Alfen
   eventCount 14
   name       Wallbox
   READINGS:
     2024-07-01 23:07:40   Active_Power_total 10451.70
     2024-07-01 23:07:40   Authorization_Method RFID
     2024-07-01 23:07:40   Current_L1      15.50
     2024-07-01 23:07:40   Current_L2      15.35
     2024-07-01 23:07:40   Current_L3      16.01
     2024-07-01 23:07:40   Enable_phase_switching 0
     2024-07-01 23:07:40   Firmware        6.6.0-4240
     2024-07-01 23:07:40   Max_Current_per_phase 16
     2024-07-01 23:07:40   Max_allowed_phases 3
     2024-07-01 23:07:40   Max_station_current_per_phase 32
     2024-07-01 23:07:40   Temperature     36.25
     2024-07-01 23:07:40   Voltage_L1      223.05
     2024-07-01 23:07:40   Voltage_L2      223.14
     2024-07-01 23:07:40   Voltage_L3      222.93
     2024-07-01 23:07:40   number_of_bootups 30
     2024-07-01 23:07:40   plug_state      Normal Charging
     2024-07-01 23:07:40   session_active  1
     2024-07-01 23:07:40   state           Normal Charging (16A/10451.70W)
     2024-07-01 23:07:40   system_uptime   51:49:9
     2024-07-01 23:07:40   total_kWh       6169.61
   actions:
   helper:
Attributes:
   group      Infrastruktur
   room       EG->Garage,System->Infrastruktur