leeyuentuen / alfen_wallbox

Alfen wallbox - Home Assistant Component
MIT License
64 stars 12 forks source link

Alfen Wallbox - HomeAssistant Integration

This is a custom component to allow control of Alfen Wallboxes in HomeAssistant.

The component is a fork of the Garo Wallbox custom integration and egnerfl custom integration

Screenshot 2023-07-02 at 18 09 47

Screenshot 2023-07-02 at 18 09 58

Screenshot 2023-07-02 at 18 10 13

Example of running in Services: Note; The name of the configured charging point is "wallbox" in these examples.

Changing Green Share %

service: alfen_wallbox.set_green_share
data:
  entity_id: number.wallbox_solar_green_share
  value: 80

Changing Comfort Charging Power in Watt

service: alfen_wallbox.set_comfort_power
data:
  entity_id: number.wallbox_solar_comfort_level
  value: 1400

Enable phase switching

service: alfen_wallbox.enable_phase_switching
data:
  entity_id: switch.wallbox_enable_phase_switching

Disable phase switching

service: alfen_wallbox.disable_phase_switching
data:
  entity_id: switch.wallbox_enable_phase_switching

Enable RFID Authorization Mode

service: alfen_wallbox.enable_rfid_authorization_mode
data:
  entity_id: select.wallbox_authorization_mode

Disable RFID Authorization Mode

service: alfen_wallbox.disable_rfid_authorization_mode
data:
  entity_id: select.wallbox_authorization_mode

Reboot wallbox

service: alfen_wallbox.reboot_wallbox
data:
  entity_id: alfen_wallbox.garage

After reverse engineering the API myself I found out that there is already a Python libary wrapping the Alfen API. https://gitlab.com/LordGaav/alfen-eve/-/tree/develop/alfeneve

https://github.com/leeyuentuen/alfen_wallbox/wiki/API-paramID

Installation

Install using HACS (recommended)

If you do not have HACS installed yet visit https://hacs.xyz for installation instructions.\ In HACS, go to the Integrations section and add the custom repository via the 3 dot menu on the top right. Enter https://github.com/leeyuentuen/alfen_wallbox in the Repository field, choose the Integration category, then click add.\ Hit the big + at the bottom right and search for Alfen Wallbox. Click it, then click the download button.\

Install manually

Clone or copy this repository and copy the folder 'custom_components/alfen_wallbox' into '/custom_components/alfen_wallbox'

Configuration

Once installed the Alfen Wallbox integration can be configured via the Home Assistant integration interface where you can enter the IP address of the device.

Home Assistant Energy Dashboard

The wallbox can be added to the Home Assistant Energy Dashboard using the _meter_reading sensor.