Configuration EVCC pour Wallbox Pulsar Plus¶

Vue d'ensemble¶

Cette documentation détaille la configuration d'EVCC pour piloter la Wallbox Pulsar Plus avec le module Power Boost EM340 et intégrer la charge solaire intelligente avec l'installation Zendure existante.

Prérequis¶

EVCC installé sur LXC 132 (version 0.300.5+)
Wallbox Pulsar Plus connectée au Wi-Fi
Compte myWallbox actif
Broker MQTT disponible (Zigbee2MQTT existant)

Configuration complète¶

Fichier `/etc/evcc.yaml`¶

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

network:
  port: 7070

# -----------------------------------------------------------------------------
# MQTT - Publication des données 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 Power Boost EM340
  - name: grid_meter
    type: template
    template: wallbox-powerboost
    # Le Power Boost est lu via la Wallbox automatiquement

  # Production solaire Zendure (existant)
  - name: zendure_pv
    type: template
    template: zendure-hyper
    usage: pv
    # Credentials Zendure Cloud (depuis config existante)

  # Batterie Zendure (existant)
  - name: zendure_battery
    type: template
    template: zendure-hyper
    usage: battery
    # Credentials Zendure Cloud (depuis config existante)

# -----------------------------------------------------------------------------
# Chargeurs (Chargers)
# -----------------------------------------------------------------------------
chargers:
  - name: wallbox
    type: template
    template: wallbox
    user: "votre_email@domain.com"  # Compte myWallbox
    password: "votre_mot_de_passe"  # Mot de passe myWallbox
    cache: 5m  # Cache pour réduire les appels API
    # serial: "WBXXXXXXXX"  # Optionnel : numéro de série spécifique

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

# -----------------------------------------------------------------------------
# Points de charge (Loadpoints)
# -----------------------------------------------------------------------------
loadpoints:
  - title: Wallbox Garage
    charger: wallbox
    vehicle: ariya
    mode: pv  # Mode par défaut : solaire uniquement
    priority: 2  # Après batterie Zendure (priority: 1)
    phases: 3
    minCurrent: 6  # 4.1 kW minimum en triphasé
    maxCurrent: 32  # 22 kW maximum
    soc:
      poll:
        mode: charging  # Interroger SoC uniquement en charge
        interval: 5m
      min: 20  # Charge forcée si SoC < 20%
      target: 80  # Objectif quotidien
    enable:
      delay: 1m  # Délai avant activation
      threshold: 0  # Pas de seuil minimum
    disable:
      delay: 5m  # Délai avant désactivation
      threshold: 0

# -----------------------------------------------------------------------------
# Tarification (optionnel)
# -----------------------------------------------------------------------------
tariffs:
  currency: EUR
  grid:
    type: fixed
    price: 0.22  # €/kWh (ajuster selon contrat)
  feedin:
    type: fixed
    price: 0.10  # €/kWh (revente, si applicable)

# -----------------------------------------------------------------------------
# Interface utilisateur
# -----------------------------------------------------------------------------
interval: 10s  # Rafraîchissement interface

# -----------------------------------------------------------------------------
# Sponsorship (optionnel, débloque certaines fonctionnalités)
# -----------------------------------------------------------------------------
# sponsortoken: "votre_token"

Configuration par sections¶

Section MQTT¶

La section MQTT permet à EVCC de publier toutes ses données sur le broker existant :

mqtt:
  broker: 192.168.1.152:1883
  topic: evcc

Topics publiés : - evcc/status - État général - evcc/loadpoints/1/mode - Mode actuel (pv, minpv, now, off) - evcc/loadpoints/1/chargePower - Puissance de charge - evcc/loadpoints/1/chargedEnergy - Énergie chargée - evcc/loadpoints/1/vehicleSoc - SoC véhicule - evcc/site/gridPower - Puissance réseau - evcc/site/pvPower - Production PV - evcc/site/batteryPower - Puissance batterie

Section Charger (Wallbox)¶

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

Paramètre	Description
`user`	Email du compte myWallbox
`password`	Mot de passe myWallbox
`cache`	Durée de cache (réduire si besoin de réactivité)
`serial`	Numéro de série (optionnel, si plusieurs bornes)

Section Loadpoint¶

loadpoints:
  - title: Wallbox Garage
    charger: wallbox
    vehicle: ariya
    mode: pv
    priority: 2
    phases: 3
    minCurrent: 6
    maxCurrent: 32

Paramètre	Description	Valeur
`mode`	Mode par défaut	`pv`, `minpv`, `now`, `off`
`priority`	Priorité vs batterie	1 = haute, 2+ = basse
`phases`	Nombre de phases	1 ou 3
`minCurrent`	Courant minimum	6A (4.1 kW tri)
`maxCurrent`	Courant maximum	32A (22 kW tri)

Section SoC¶

soc:
  poll:
    mode: charging
    interval: 5m
  min: 20
  target: 80

Paramètre	Description
`poll.mode`	Quand interroger : `charging`, `connected`, `always`
`poll.interval`	Fréquence d'interrogation
`min`	SoC minimum (charge forcée si inférieur)
`target`	SoC cible (arrêt charge si atteint)

Modes de charge¶

Mode	Comportement	Cas d'usage
pv	Charge uniquement avec surplus solaire	Quotidien, maximise autoconsommation
minpv	Charge minimale (6A) + surplus	Besoin d'un peu de charge garantie
now	Charge immédiate au maximum (32A)	Besoin urgent, départ imminent
off	Charge désactivée	Pas de charge souhaitée

Commandes utiles¶

Vérifier la configuration¶

# Se connecter au LXC EVCC
ssh root@192.168.1.32 "pct exec 132 -- bash"

# Tester la configuration
evcc configure

# Tester le chargeur
evcc charger

# Tester le compteur
evcc meter

# Tester le véhicule
evcc vehicle

# État complet
evcc status

Appliquer les modifications¶

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

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

# Vérifier les logs
ssh root@192.168.1.32 "pct exec 132 -- journalctl -u evcc -f"

API REST¶

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

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

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

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

Intégration avec l'existant¶

Priorités recommandées¶

1. Batterie Zendure (priority: 1)
   └── Se charge en priorité avec le surplus
2. Wallbox Ariya (priority: 2)
   └── Se charge avec le surplus restant

Flux d'énergie type¶

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

Troubleshooting¶

Erreurs courantes¶

Erreur	Cause	Solution
`charger not reachable`	Wallbox hors ligne	Vérifier Wi-Fi
`invalid credentials`	Compte myWallbox	Vérifier email/password
`vehicle offline`	Nissan Connect	Attendre ou forcer refresh
`battery outdated`	Zendure déconnecté	Vérifier tokens Zendure

Logs utiles¶

# Logs temps réel
journalctl -u evcc -f

# Logs avec niveau debug
journalctl -u evcc -f | grep -E "(ERROR|WARN|charger|wallbox)"

# Dernières 100 lignes
journalctl -u evcc -n 100 --no-pager