Dispositivi supportati

Device Type	API
Alfen Battery Container (250 kWh – 2 MWh)	✅

---

Passaggi di configurazione

1. Credenziali API

   • Recupera la chiave API e l'ID della batteria nel portale Greener.
   • Sono necessari per gli "Input Utente" del driver.

2. Aggiungi il dispositivo

   • In Integrazioni → Aggiungi dispositivo seleziona Greener API per il Controllo della Batteria Alfen.
   • Inserisci la chiave API e l'ID della batteria esattamente come fornito.
   • Conferma → il contenitore appare con SOC e potenza.

3. Opzionale – controllo del setpoint
   Quando la modalità Smart-Grid è abilitata, il driver invia un set-point di potenza costante (positivo = carica, negativo = scarica) a
   /control/batteries/<ID>/command/set_constant_power_setpoint.

---

Metriche esposte

Chiave	Descrizione	Unità
actualPowerTot_W	Potenza della batteria (+ = scarica)	W
stateOfCharge_frac	Stato di Carica (0–1)	–
importedEnergyDeltaTot_Wh	Energia caricata Δ	Wh
exportedEnergyDeltaTot_Wh	Energia scaricata Δ	Wh

---

Risoluzione dei problemi

• 401 Non autorizzato – controlla la stringa della chiave API (senza spazi, lunghezza completa).
• 404 su ID della batteria – verifica l'identificatore esatto GREENER_XXX.
• Potenza non aggiornata – l'API Greener fornisce nuovi dati ogni ~10 s;
  assicurati che il traffico HTTPS in uscita (443) sia consentito.

---

Risorse utili

• Documentazione Greener –
  https://www.greener.nu/en/batteries