Indice | Avanti: ChangeLog →

ACRouter — Controller router solare open source

Router di potenza AC intelligente per la gestione dell'energia solare

Funzionalità • Hardware • Avvio rapido • Modi • Docs • Contribuire

Cos'è ACRouter?

ACRouter è un controller open source che reindirizza automaticamente l'energia solare in eccesso verso carichi resistivi (come scaldacqua) invece di immetterla in rete. Vi aiuta a massimizzare l'autoconsumo della vostra energia solare e ridurre i costi elettrici.

Perché ACRouter?

Comportamento giornaliero tipico di un impianto FV connesso alla rete con carico scaldacqua.

Funzionalità

⚡ Monitoraggio della potenza in tempo reale

• Misurazione della tensione AC (sensore ZMPT107)
• Monitoraggio della corrente multicanale (fino a 3× sensori SCT-013/ACS-712)
• ADC a 12 bit con DMA per alta precisione
• Ciclo di aggiornamento di 200 ms (5 misurazioni/secondo)

🎛️ Controllo intelligente del carico

• Dimmerizzazione AC con taglio di fase (controllo continuo 0–100 %)
• Basato su TRIAC, sincronizzato al passaggio per lo zero
• Più modalità operative per diversi scenari
• Algoritmi anti-sfarfallio

📱 Configurazione semplice

• Access point WiFi integrato per la configurazione
• Dashboard web moderna (Material UI)
• REST API per l'integrazione
• Console seriale per utenti avanzati
• Tutte le impostazioni salvate in memoria non volatile

🔌 Hardware flessibile

• Pin GPIO configurabili tramite interfaccia web
• Supporto per vari tipi di sensori
• Più canali dimmer
• Uscite relè per carichi on/off

Dashboard web

The web interface provides:
- Real-time metrics — Voltage, current, power for all channels
- Mode selection — One-click switching between modes
- Manual control — Slider for direct dimmer control
- WiFi settings — Network scanning and connection
- Hardware config — GPIO pin assignment without reflashing

Console seriale per utenti avanzati

• Visualizzazione delle metriche in tempo reale
• Riga di comando per la configurazione dei parametri hardware e del dispositivo
• Selezione della modalità operativa

Vedere 🗺️ Comandi — guida completa ai comandi del terminale seriale e REST API per ACRouter.

Hardware

Scheda controller

ACRouter funziona su schede di sviluppo basate su ESP32 progettate per il controllo della potenza AC.

Sensori

Dimmer e controllo

💡 Nota: ACRouter è progettato per funzionare con l'hardware di rbdimmer.com e qualsiasi modulo DIY open source.

Modalità operative

ACRouter supporta 6 modalità operative per diversi casi d'uso:

• Le modalità AUTO ed ECO sono le modalità principali di routing solare nei sistemi connessi alla rete.

Modalità AUTO — Il cuore del routing solare

☀️ Solar: 3000W    🏠 House: 800W    ⚡ Grid: -2200W (export!)
                              ↓
                    ACRouter detects export
                              ↓
                    Increases dimmer → heats water
                              ↓
☀️ Solar: 3000W    🏠 House: 800W    🔥 Heater: 2200W    ⚡ Grid: 0W ✓

Avvio rapido

1. Flash del firmware

# Clone the repository
git clone https://github.com/robotdyn-dimmer/ACRouter.git
cd ACRouter

# Set up ESP-IDF environment
. $HOME/esp/esp-idf/export.sh

# Build and flash
idf.py set-target esp32
idf.py build
idf.py -p /dev/ttyUSB0 flash monitor

2. Connettersi ad ACRouter

Dopo il flash, il dispositivo crea una rete WiFi:

3. Configurare tramite interfaccia web

1. Connettersi alla rete WiFi di ACRouter
2. Aprire il browser: http://192.168.4.1
3. Configurare i pin GPIO dell'hardware
4. Connettersi al WiFi di casa
5. Selezionare la modalità AUTO e iniziare a risparmiare energia!

Documentazione

REST API

ACRouter espone una REST API per l'integrazione con sistemi domotici:

# Get current status
curl http://192.168.4.1/api/status

# Set mode to AUTO
curl -X POST http://192.168.4.1/api/mode -d '{"mode": 1}'

# Get power metrics
curl http://192.168.4.1/api/metrics

Vedere la Documentazione API per l'elenco completo degli endpoint.

Cosa ACRouter NON è

• Non è un inverter a batteria
• Non è una presa intelligente o un controller a relè
• Non è un dispositivo certificato di protezione della rete
• Non è adatto a carichi induttivi o elettronici

Avviso di sicurezza

⚠️ AVVISO: Questo progetto utilizza tensione di rete (110V/230V AC)

• L'installazione deve essere eseguita da un elettricista qualificato
• Usare sempre un'adeguata separazione galvanica
• Installare interruttori automatici e protezione differenziale (RCD/GFCI) appropriati
• Usare solo con carichi resistivi (elementi riscaldanti)
• Non adatto a motori, LED o dispositivi elettronici

Contribuire

We welcome contributions! Here's how you can help:

• 🐛 Segnalare bug — Aprire una issue con i dettagli
• 💡 Suggerire funzionalità — Condividere idee nelle discussioni
• 📝 Migliorare la documentazione — Correggere refusi, aggiungere esempi
• 🔧 Inviare codice — Fare fork, sviluppare e creare una pull request

Si prega di leggere le nostre Linee guida per i contributi prima di inviare.

Comunità

• GitHub Issues — Segnalazioni di bug e richieste di funzionalità
• Discussions — Domande e supporto della community
• Wiki — Configurazioni contribute dalla community

Licenza

ACRouter è software open source. Vedere LICENSE per i dettagli.

Ringraziamenti

• RBDimmer — Piattaforma hardware e libreria dimmer LIBRARY
• ESP-IDF — Framework di sviluppo IoT di Espressif
• ArduinoJson — Libreria JSON per sistemi embedded
• Comunità — Contributori e tester

Fatto con ⚡ per la comunità dell'energia solare

⭐ Metti una stella al progetto • 🐛 Segnala un problema • 💬 Discuti

Indice | Avanti: ChangeLog →