Migrazione dal vecchio portale

Tempo di lettura: ~8 minuti · Tempo di esecuzione: 20-40 minuti · Pubblico: chi ha una dosometrica collegata al vecchio portale (iot.joy-reef.com) — autocostruita o comprata

Il nuovo portale JoyReef è la nuova casa della dosometrica: il vecchio portale resta attivo, ma tutte le novità arrivano solo sul nuovo. Questa guida ti porta di là in due tappe: aggiorni il firmware della dosometrica e la colleghi al nuovo portale. Vale per tutti — sia che la dosometrica te la sia costruita, sia che l'abbia comprata. Nessuna fretta: migri quando vuoi tu.

1. Perché migrare

Il nuovo portale JoyReef non è un restyling: è un sistema nuovo, di cui la dosometrica è solo uno dei componenti.

• 📊 Dashboard e storico: dosaggi, eventi e grafici consultabili nel tempo
• 🧪 Integrazione vasca completa: la doser dialoga con sensori, sonde e automazioni (Balling, reattore di calcio, titolazione KH...)
• 🔔 Notifiche: avvisi se qualcosa non va
• 📱 App mobile e accesso da qualsiasi dispositivo
• 🔧 Sviluppo attivo: il vecchio portale non riceve più aggiornamenti, tutto il lavoro è sul nuovo

Il vecchio firmware non può parlare col nuovo portale: per questo la migrazione parte dall'aggiornamento del firmware.

⚠️ Cosa NON viene migrato automaticamente: i programmi di dosaggio e la calibrazione delle pompe restano sul vecchio sistema. Prima di iniziare, annotali (quantità giornaliere, orari, numero di dosi per canale): li reimposterai sul nuovo portale in pochi minuti.

2. Prima di iniziare

• ✅ Annota i tuoi programmi di dosaggio e i dati di calibrazione dal vecchio portale (vedi sopra)
• ✅ Crea un account sul nuovo portale: portal.joy-reef.com
• ✅ Tieni a portata la password del WiFi di casa: dopo l'aggiornamento la dosometrica andrà riconfigurata

Il firmware nuovo è lo stesso file per tutti e si scarica liberamente dalla pagina portal.joy-reef.com/usb-flash (bottone "Scarica .bin" della Dosometrica).

ℹ️ Hai comprato la dosometrica (non autocostruita)? Leggi prima la sezione 5: puoi richiedere il riconoscimento di "doser originale" e, se preferisci, fare un solo aggiornamento invece di due.

3. Tappa 1 — aggiorna il firmware

Tre percorsi, in ordine di comodità: prova l'A; se non funziona passa al B; il C copre tutti i casi rimasti (ed è anche la procedura di recovery).

Percorso A — dal browser, senza cavi

Le dosometriche con il firmware più datato hanno una pagina di aggiornamento nascosta, raggiungibile dal browser di casa:

1. Trova l'indirizzo IP della dosometrica sulla tua rete: apri la pagina di amministrazione del router e cerca tra i dispositivi connessi un device chiamato jrdoso (o ESP/Espressif)
2. Apri nel browser: http://INDIRIZZO-IP/update (esempio: http://192.168.1.42/update)
3. Se compare una pagina con un campo di upload firmware → sei nel percorso giusto. Se ottieni "pagina non trovata" o nessuna risposta → la tua doser non ha questa pagina: passa al percorso B
4. Scarica il .bin della Dosometrica da portal.joy-reef.com/usb-flash (bottone "Scarica .bin")
5. Nella pagina /update, seleziona il file appena scaricato e conferma
6. Attendi il caricamento senza chiudere la pagina né togliere corrente: al termine la doser si riavvia da sola

⚠️ Carica SOLO il file giusto. La pagina /update non fa nessun controllo: accetta qualunque file. Caricare un firmware sbagliato (es. quello del Controller) lascia la scheda senza firmware funzionante — recuperabile, ma solo col cavo (guida 16b). Il file giusto è il .bin Dosometrica scaricato dalla pagina /usb-flash del portale.

Quando l'upload è completato, compare questo messaggio e la scheda si riavvia da sola:

🔁 Dopo l'aggiornamento, resetta la scheda. A riavvio avvenuto, tieni premuto il tasto di reset per più di 8 secondi: la scheda torna allo stato di fabbrica ed è pronta per essere collegata al nuovo portale (Tappa 2).

⚠️ Attenzione: tutte le programmazioni precedenti saranno perse! Dosaggi, calibrazioni e impostazioni vengono cancellati: assicurati di averli annotati come indicato nella sezione 2.

Percorso B — via cavo USB

Se la tua scheda ha la porta USB: segui la guida 16 — Installazione firmware via USB. Tutto dal browser, ci vogliono 10 minuti.

Percorso C — via adattatore seriale (schede senza USB)

Se la tua scheda non ha la porta USB: serve un adattatore CP2102 da pochi euro, collegato a 4 pin della scheda. Segui la guida 16b — Flash con adattatore seriale CP2102.

💡 Come faccio a sapere quale percorso è il mio? Non serve saperlo prima: prova l'A (5 minuti, zero rischi — se la pagina non esiste non succede nulla). Se non va, guarda la scheda: c'è una presa USB? B. Non c'è? C.

4. Tappa 2 — collega la dosometrica al nuovo portale

Dopo l'aggiornamento la doser riparte "vergine": entro 30 secondi comparirà una rete WiFi chiamata joyreef-XXXXXX.

1. Segui la guida 03b — connessione WiFi dalla sezione 3: ti connetti alla rete joyreef-XXXXXX, si apre il portale di configurazione, inserisci WiFi di casa e credenziali del tuo account JoyReef
2. La doser compare tra i tuoi device sul portale
3. Configura canali, calibrazione e programmi di dosaggio con la guida 11 — Pompe dosometriche (è qui che ti servono i dati annotati all'inizio)

Fatto: la migrazione è completa. Da questo momento la dosometrica vive sul nuovo portale.

5. Hai comprato la dosometrica?

Se la tua doser è una scheda originale JoyReef (comprata, non autocostruita), ha diritto al firmware proprietario: la scheda viene riconosciuta sul portale come "Dosometrica JoyReef originale" e in futuro avrà sbloccate tutte le funzionalità premium, per sempre, senza abbonamento.

ℹ️ In beta non cambia nulla: oggi tutte le funzionalità sono aperte a tutti. Il riconoscimento serve per il futuro — non c'è nessuna fretta.

Come funziona:

1. Scrivici (vedi contatti sul portale) dicendo che hai una scheda originale da riconoscere
2. Ti chiederemo qualche verifica semplice: le credenziali del tuo vecchio account, una foto della scheda o la prova d'acquisto
3. Una volta verificato, ricevi il firmware proprietario da installare via cavo (guida 16 o 16b a seconda della scheda)

💡 Un solo flash invece di due: se ci scrivi prima di migrare, al posto del firmware pubblico installi direttamente quello proprietario e fai un passaggio solo. Conviene soprattutto se la tua scheda è senza USB (eviti di cablare il CP2102 due volte). Se invece hai già migrato col firmware pubblico, nessun problema: il proprietario si installa sopra quando vuoi.

6. Problemi comuni

7. Conclusione

Benvenuto sul nuovo portale. Da qui in poi la dosometrica è un cittadino di prima classe del sistema JoyReef: se hai una vasca da gestire per intero, il percorso completo parte dalla guida 01 — Shopping list; se ti interessa solo la doser, la guida 11 è casa tua.