Configuration EVCC¶

Vue d'ensemble¶

EVCC (Electric Vehicle Charge Controller) est installé sur le LXC 132 (elec-proxmox) et gère la charge intelligente de la Nissan Ariya en fonction de la production solaire, avec intégration à Home Assistant via MQTT.

Installation¶

Paramètre	Valeur
LXC	132 (elec-proxmox)
Noeud	proxmox (192.168.1.32)
Version	0.300.5+
Port	7070
Service	systemd (evcc.service)
Config	`/etc/evcc.yaml`
MQTT	192.168.1.152:1883

Équipements intégrés¶

Équipement	Modèle	Intégration
Borne	Wallbox Pulsar Plus 22kW	API Cloud myWallbox
Grid Meter	Zendure Hub 3CT (à venir)	API Cloud / MQTT
PV	Zendure SolarFlow 800+	API Cloud
Batterie	Zendure AB2000 + SolarFlow 800+	API Cloud
Véhicule	Nissan Ariya 87 kWh	Nissan Connect API

Accès¶

Interface Web¶

http://<IP_LXC_132>:7070

Ligne de commande¶

# Depuis vscode-proxmox
ssh root@192.168.1.32 "pct exec 132 -- evcc -v"
ssh root@192.168.1.32 "pct exec 132 -- evcc status"

Service systemd¶

ssh root@192.168.1.32 "pct exec 132 -- systemctl status evcc"
ssh root@192.168.1.32 "pct exec 132 -- systemctl restart evcc"

Configuration¶

Le fichier de configuration EVCC est situé dans /etc/evcc.yaml.

Documentation complète : Voir evcc-wallbox-config.md pour la configuration détaillée.

Configuration complète¶

# =============================================================================
# EVCC Configuration - Maison avec Wallbox Pulsar Plus
# =============================================================================

network:
  port: 7070

# -----------------------------------------------------------------------------
# MQTT - Publication vers Home Assistant
# -----------------------------------------------------------------------------
mqtt:
  broker: 192.168.1.152:1883  # Broker HA (Zigbee2MQTT)
  topic: evcc
  # user: ""     # Si authentification requise
  # password: ""

# -----------------------------------------------------------------------------
# Site - Configuration globale
# -----------------------------------------------------------------------------
site:
  title: Maison
  meters:
    grid: grid_meter
    pv:
      - zendure_pv
    battery:
      - zendure_battery
  residualPower: 100  # Marge de sécurité en W

# -----------------------------------------------------------------------------
# Compteurs (Meters)
# -----------------------------------------------------------------------------
meters:
  # Compteur réseau via Zendure Hub 3CT (à venir)
  # Alternative temporaire : Power Boost EM340 via Wallbox
  - name: grid_meter
    type: template
    template: zendure-solarflow
    usage: grid
    account: votre@email.com
    password: votre_mot_de_passe

  # Production solaire Zendure SolarFlow 800+
  - name: zendure_pv
    type: template
    template: zendure-solarflow
    usage: pv
    account: votre@email.com
    password: votre_mot_de_passe

  # Batterie Zendure AB2000 + SolarFlow 800+
  - name: zendure_battery
    type: template
    template: zendure-solarflow
    usage: battery
    account: votre@email.com
    password: votre_mot_de_passe

# -----------------------------------------------------------------------------
# Chargeurs (Chargers)
# -----------------------------------------------------------------------------
chargers:
  - name: wallbox
    type: template
    template: wallbox
    user: "votre_email@domain.com"  # Compte myWallbox
    password: "votre_mot_de_passe"
    cache: 5m

# -----------------------------------------------------------------------------
# Véhicules (Vehicles)
# -----------------------------------------------------------------------------
vehicles:
  - name: ariya
    type: template
    template: nissan
    title: Nissan Ariya
    user: "votre_email@nissan.com"
    password: "votre_mot_de_passe"
    region: EU
    capacity: 87  # kWh
    phases: 3
    cache: 15m

# -----------------------------------------------------------------------------
# Points de charge (Loadpoints)
# -----------------------------------------------------------------------------
loadpoints:
  - title: Wallbox Garage
    charger: wallbox
    vehicle: ariya
    mode: pv
    priority: 2  # Après batterie Zendure (priority: 1)
    phases: 3
    minCurrent: 6   # 4.1 kW minimum
    maxCurrent: 32  # 22 kW maximum
    soc:
      poll:
        mode: charging
        interval: 5m
      min: 20   # Charge forcée si SoC < 20%
      target: 80  # Objectif quotidien
    enable:
      delay: 1m
      threshold: 0
    disable:
      delay: 5m
      threshold: 0

# -----------------------------------------------------------------------------
# Tarification
# -----------------------------------------------------------------------------
tariffs:
  currency: EUR
  grid:
    type: fixed
    price: 0.22  # €/kWh
  feedin:
    type: fixed
    price: 0.10  # €/kWh

interval: 10s

Intégration MQTT¶

EVCC publie automatiquement toutes ses données sur le broker MQTT configuré. Ces données sont ensuite disponibles dans Home Assistant.

Topics publiés¶

Topic	Description	Type
`evcc/loadpoints/1/chargePower`	Puissance de charge (W)	number
`evcc/loadpoints/1/chargedEnergy`	Énergie session (kWh)	number
`evcc/loadpoints/1/charging`	En charge	boolean
`evcc/loadpoints/1/connected`	Véhicule connecté	boolean
`evcc/loadpoints/1/mode`	Mode actuel	pv/minpv/now/off
`evcc/loadpoints/1/vehicleSoc`	SoC véhicule (%)	number
`evcc/loadpoints/1/vehicleRange`	Autonomie (km)	number
`evcc/site/gridPower`	Puissance réseau (W)	number
`evcc/site/pvPower`	Production PV (W)	number
`evcc/site/batteryPower`	Puissance batterie (W)	number
`evcc/site/batterySoc`	SoC batterie (%)	number

Topics de commande¶

Topic	Valeurs	Action
`evcc/loadpoints/1/mode/set`	pv, minpv, now, off	Change le mode
`evcc/loadpoints/1/minSoc/set`	0-100	SoC minimum
`evcc/loadpoints/1/targetSoc/set`	0-100	SoC cible

Configuration Home Assistant¶

Voir home-assistant-wallbox.md pour la configuration complète des entités MQTT dans Home Assistant.

Intégrations matérielles¶

Wallbox Pulsar Plus (installée)¶

La borne est connectée via l'API Cloud myWallbox :

chargers:
  - name: wallbox
    type: template
    template: wallbox
    user: "email@domain.com"
    password: "password"
    cache: 5m

Le Power Boost EM340 est automatiquement utilisé comme grid meter via la Wallbox.

Voir wallbox-pulsar-plus.md et power-boost-em340.md

Zendure (Hyper 2000 + SolarFlow)¶

EVCC se connecte à Zendure via l'API Cloud :

meters:
  - name: zendure_pv
    type: template
    template: zendure-hyper
    usage: pv
    # Credentials depuis config existante

Nissan Ariya¶

Connexion via Nissan Connect pour : - État de charge (SoC) - Autonomie restante - Contrôle de charge à distance

vehicles:
  - name: ariya
    type: template
    template: nissan
    user: "email@nissan.com"
    password: "password"
    region: EU
    capacity: 87

Modes de charge¶

Mode	Description
PV	Charge uniquement avec surplus solaire
Min+PV	Charge minimale + surplus
Now	Charge immédiate au maximum
Off	Charge désactivée

Priorités de charge¶

Le système de priorités permet de gérer l'allocation du surplus solaire :

Production solaire (4 kWc)
        │
        ├──► Consommation maison (en direct)
        │
        ├──► Batterie Zendure (priority: 1)
        │    └── Si surplus > 0 et SoC < 100%
        │
        └──► Wallbox Ariya (priority: 2)
             └── Si surplus > 4.1 kW et batterie pleine

Priority	Équipement	Condition
1	Batterie Zendure	Surplus > 0, SoC < 100%
2	Wallbox Ariya	Surplus > 4.1 kW (minimum triphasé)

Problèmes connus¶

Erreur "battery outdated"¶

[site] ERROR battery 1 power: outdated
[site] ERROR battery 1 soc: outdated

Cause probable : - Communication avec Zendure interrompue - Token API expiré - Problème réseau

Solution : 1. Vérifier la connectivité Zendure 2. Régénérer les tokens API 3. Redémarrer EVCC : systemctl restart evcc

Erreur "charger not reachable"¶

[charger] ERROR wallbox: not reachable

Cause probable : - Wallbox hors ligne (Wi-Fi) - Credentials myWallbox invalides - API cloud indisponible

Solution : 1. Vérifier connexion Wi-Fi de la borne 2. Vérifier credentials dans evcc.yaml 3. Tester API : curl -s https://api.wall-box.com/

Erreur "vehicle offline"¶

[vehicle] WARN ariya: offline

Cause probable : - Véhicule en mode veille - Session Nissan Connect expirée

Solution : 1. Ouvrir l'app Nissan Connect pour réveiller le véhicule 2. Attendre le prochain cycle de poll (15 min)

Commandes utiles¶

Depuis vscode-proxmox¶

# État actuel
ssh root@192.168.1.32 "pct exec 132 -- evcc status"

# Tester le chargeur
ssh root@192.168.1.32 "pct exec 132 -- evcc charger"

# Tester le compteur
ssh root@192.168.1.32 "pct exec 132 -- evcc meter"

# Tester le véhicule
ssh root@192.168.1.32 "pct exec 132 -- evcc vehicle"

# Logs temps réel
ssh root@192.168.1.32 "pct exec 132 -- journalctl -u evcc -f"

# Redémarrer le service
ssh root@192.168.1.32 "pct exec 132 -- systemctl restart evcc"

# Éditer la configuration
ssh root@192.168.1.32 "pct exec 132 -- nano /etc/evcc.yaml"

API REST¶

# État complet
curl -s http://<IP_LXC_132>:7070/api/state | jq

# État du loadpoint
curl -s http://<IP_LXC_132>:7070/api/loadpoints/1 | jq

# Changer le mode
curl -X POST http://<IP_LXC_132>:7070/api/loadpoints/1/mode/pv

# Définir SoC cible
curl -X POST http://<IP_LXC_132>:7070/api/loadpoints/1/target/soc/80

Test MQTT¶

# Écouter tous les messages EVCC
mosquitto_sub -h 192.168.1.152 -t "evcc/#" -v

# Changer le mode via MQTT
mosquitto_pub -h 192.168.1.152 -t "evcc/loadpoints/1/mode/set" -m "pv"

Documentation associée¶

zendure-3ct-evcc.md - Intégration Zendure Hub 3CT + EVCC
evcc-wallbox-config.md - Configuration détaillée Wallbox
wallbox-pulsar-plus.md - Documentation borne
power-boost-em340.md - Documentation compteur
home-assistant-wallbox.md - Intégration Home Assistant
borne-triphasee.md - Installation électrique