Home Assistant

Opmerking

De evcc-app voor Home Assistant is een community-integratie en wordt niet officieel ondersteund door de evcc-maintainers.

Bij een fout zijn belangrijke gegevens namelijk niet eenvoudig op te vragen, omdat evcc cli in de app ontbreekt.

Datamigratie

Let op: op 16 februari 2025 hebben we met versie 0.200.1 de paden in de app aangepast, zodat ze overeenkomen met de richtlijnen van Home Assistant.

Sindsdien worden de volgende paden in de app gekoppeld:

• /homeassistant/ -> verwijst naar /homeassistant/ of /config/ in Home Assistant.
• /config/ -> verwijst naar /addon_configs/49686a9f_evcc/ in Home Assistant.

Als u bijwerkt vanaf een oudere versie, wordt uw configuratiebestand automatisch naar de nieuwe map gekopieerd. We kopiëren de database alleen als die ook in /config/ stond. Als die in /data/ stond, blijft hij daar. We voegen .migrated toe aan de oude bestanden. Die kunt u daarna handmatig verwijderen.

Deze handleiding beschrijft de installatie van evcc als Home Assistant-app. Anders dan bij de Linux-installatie of de Docker-installatie hebt u hier geen kennis van de opdrachtregel nodig.

Vereisten

U hebt een Home Assistant-installatie nodig waarin de app store is ingeschakeld. Afhankelijk van uw installatietype is deze functie mogelijk niet beschikbaar. Zie de documentatie van Home Assistant voor meer informatie.

Installatie

Release

De huidige stabiele versie.

1. Repository automatisch toevoegen: klik op de volgende knop, daarna op Link openen en vervolgens op Toevoegen.
2. Repository handmatig toevoegen:
   1. Klik op Instellingen → Apps → App installeren
   2. Klik op de drie puntjes → Repositories
   3. Voeg de repository-URL toe en klik op Toevoegen

      https://github.com/evcc-io/hassio-addon

3. Laad de webpagina opnieuw
4. Zoek de app evcc en klik erop
5. Klik op de knop Installeren

Nightly

De huidige ontwikkelversie. Deze wordt dagelijks bijgewerkt en kan instabiel zijn. Hoewel deze naast de releaseversie kan worden geïnstalleerd, kan er maar één versie tegelijk draaien. Als u de nightly-versie gebruikt, veranderen de paden en Docker-containernamen uit deze handleiding: in plaats van evcc moet u dan evcc-nightly gebruiken.

1. Repository automatisch toevoegen: klik op de volgende knop, daarna op Link openen en vervolgens op Toevoegen.
2. Repository handmatig toevoegen:
   1. Klik op Instellingen → Apps → App installeren
   2. Klik op de drie puntjes → Repositories
   3. Voeg de repository-URL toe en klik op Toevoegen

      https://github.com/evcc-io/hassio-addon

3. Laad de webpagina opnieuw
4. Zoek de app evcc (nightly) en klik erop
5. Klik op de knop Installeren

Configuratie

evcc kan op twee manieren worden geconfigureerd:

Webinterface (aanbevolen)

Ga in de app evcc naar het tabblad Info en schakel In zijbalk weergeven in (de evcc-interface staat dan op http://your-ha-instance-ip-address:7070).

Ga naar het tabblad Configuratie en kies uw werkmap (voorbeeld):

- sqlite_file: /data/evcc.db

Laat het gedeelte Netwerk ongewijzigd.

Start de app. Open daarna de evcc-interface via de zijbalk:

• U wordt gevraagd een beheerderswachtwoord in te stellen.
• Daarna kunt u uw apparaten direct via de webinterface configureren.
• Instellingen worden automatisch in de database opgeslagen.

Configuratiebestand (traditioneel)

U kunt ook een configuratiebestand evcc.yaml gebruiken.

Ga naar het tabblad Configuratie en voeg het configuratiebestand toe aan uw werkmap:

- config_file: /config/evcc.yaml
- sqlite_file: /data/evcc.db

Maak een evcc-configuratiebestand evcc.yaml aan in de hoofdconfiguratiemap van uw app (/addon_configs/49686a9f_evcc). Als deze map niet bestaat, maak hem dan handmatig aan.

Om het configuratiebestand aan te maken of te bewerken, hebt u verschillende mogelijkheden:

• Visual Studio Code: open linksboven het hamburgermenu, kies File → Open Folder… en selecteer /addon_configs/49686a9f_evcc
• File Editor: zorg dat de optie Enforce Basepath in de app-configuratie is uitgeschakeld, herstart de app en navigeer naar /addon_configs/49686a9f_evcc
• Advanced SSH & Web Terminal: navigeer naar /addon_configs/49686a9f_evcc en gebruik bijv. nano

Zie Configuratie voor details over het aanmaken van het configuratiebestand.

Als u het systeem in demomodus wilt zien, start evcc dan met de parameter --demo. Zie de CLI-referentie voor meer informatie.

Updates

Het bijwerken naar de nieuwste versie van evcc is opgenomen in het updateproces van Home Assistant.

Geavanceerde tips

Voor de volgende functies hebt u SSH-toegang tot Home Assistant nodig. Die krijgt u bijv. met de hierboven genoemde SSH-app.

• Installeer Advanced SSH & Web Terminal.
• Schakel secure mode uit in de app-configuratie.
• Herstart de app.
• Open de gebruikersinterface van de app.

Hoe krijg ik toegang tot de evcc-database?

Toon de bestanden in /data:

docker exec addon_49686a9f_evcc ls -la /data

Kopieer evcc.db naar /addon_configs/49686a9f_evcc:

docker cp addon_49686a9f_evcc:/data/evcc.db /addon_configs/49686a9f_evcc/

Hoe gebruik ik de evcc-CLI?

Open een shell in de evcc-Docker-container:

docker exec -it addon_49686a9f_evcc /bin/sh

Voer evcc-CLI-commando’s uit (hier als voorbeeld checkconfig):

evcc -c /config/evcc.yaml checkconfig

Sluit de shell in de evcc-Docker-container als u klaar bent:

exit

Hoe gebruik ik mijn externe adapter / HAT in de evcc-app voor Home Assistant (Home Assistant OS, Raspberry Pi)?

Als uw Home Assistant-apparaat dicht bij uw meters staat (bijv. voor zonne-energie, thuisbatterij of net), kunt u de gegevens ook direct via Modbus ophalen (bijv. via USB).

Daarvoor moet u externe apparaten in Home Assistant vrijgeven, zodat ook de evcc-app ze kan gebruiken. Haal hiervoor het commentaarteken weg voor de regel uart = 1 in het bestand config.txt op de opstartpartitie van Home Assistant OS.

/config.txt

uart = 1

Na een herstart zou uw apparaat beschikbaar moeten zijn voor de evcc-app (waarschijnlijk als /dev/ttyS0 of /dev/ttyUSB).

Volgende stap: integratie

Zodra uw systeem draait, kunt u de integratie tussen evcc en Home Assistant instellen. Onder Integraties → Home Assistant vindt u meer informatie. U kunt evcc-gegevens in Home Assistant visualiseren of automatiseringen op basis van evcc maken.