Indice guide JoyReef
Tutte le guide utente, raggruppate per importanza. Inizia dalle 🟢 fondamentali, poi 🟡 importanti, infine 🔵 avanzate man mano che ti servono.
🟢 Fondamentali
Senza queste guide il sistema non parte. Percorso obbligato per tutti, da fare in ordine.
| # | Guida | A cosa serve |
|---|---|---|
| 01 | Shopping list | Cosa comprare prima di iniziare: controller, sonde, prese, accessori |
| 02 | Primo avvio del controller | Apertura della scatola, montaggio fisico, prime accensioni |
| 03 | Firmware + configurazione WiFi | Connettere il controller alla tua rete WiFi di casa |
| 03b | Flash firmware e connessione WiFi — tutti i device | Processo di flash e connessione WiFi valido per controller, doser, fish-feeder e pH |
| 04 | Vasca e sensori | Creare una vasca sul portale e assegnare i ruoli ai sensori |
| 05 | Prese smart Tasmota | Configurare le smart plug per controllare riscaldatore, pompe, ecc. |
🟡 Importanti
Quasi tutti vorranno attivare queste funzionalità. Senza, il sistema funziona ma rende molto meno (niente automatismi reali, nessun alert in caso di problemi).
| # | Guida | A cosa serve |
|---|---|---|
| 06 | Rabbocco automatico (ATO) | Rabbocca acqua dolce automaticamente quando il livello scende |
| 07 | Controllo temperatura | Gestione automatica di riscaldatore (e ventola/chiller) con isteresi |
| 08 | Cambio acqua automatico | Scarico + riempimento programmati settimanalmente |
| 14 | Eventi e timeline | Pagina di consultazione: cosa è successo in vasca, grafici, log filtrabili |
| 15 | Notifiche email | Avvisi via email per eventi critici (ATO fault, riscaldatore guasto, ecc.) |
🔵 Avanzate
Opzionali per setup specifici o operazioni occasionali. Affronta solo quelle che ti servono davvero.
Integrazioni chimiche
| # | Guida | A chi serve |
|---|---|---|
| 18 | Device pH | Chi vuole monitorare il pH o usare Reattore di calcio / Titolazione KH: la sonda pH è ora un device dedicato |
| 10 | Reattore di calcio | Chi ha un reattore CaCO₃ + CO₂ per integrare Ca/KH |
| 11 | Pompe dosometriche (6 canali) | Chi usa Balling, kalkwasser, oligoelementi, batteri, ecc. |
| 12 | Titolazione KH automatica | Chi ha dosometrica con sonda pH + reagente per misurare il KH automaticamente |
| 22 | Titolatore KH: costruzione e messa in servizio | Chi ha una dosometrica JoyReef con 3 canali liberi e vuole costruirsi il titolatore KH (stampa 3D + sensore di colore): lista della spesa, montaggio, messa in servizio |
Monitoraggio
| # | Guida | A chi serve |
|---|---|---|
| 20 | Device EC / Salinità | Chi vuole misurare la salinità con una sonda EC (target 34-36 ppt): la sonda si immerge solo per la misura |
Alimentazione
| # | Guida | A chi serve |
|---|---|---|
| 21 | Mangiatoia WP8621 | Chi vuole una mangiatoia automatica dentro JoyReef ed è disposto ad aprirla, saldare tre fili e sostituirne il firmware |
Diagnostica
| # | Guida | A chi serve |
|---|---|---|
| 13 | Energy & Health | Chi vuole alert "intelligenti" su riscaldatore/risalita/skimmer basati su consumo elettrico |
Automazioni custom
| # | Guida | A chi serve |
|---|---|---|
| 09 | Automazioni avanzate ⏸️ in arrivo | Chi vuole creare automazioni personalizzate oltre le routine pre-confezionate |
Manutenzione firmware
| # | Guida | A chi serve |
|---|---|---|
| 16 | Installazione firmware via USB | Prima installazione, recovery di un device bricked, downgrade a versione specifica |
| 16b | Flash con adattatore seriale CP2102 | Chi ha una dosometrica senza porta USB, o deve recuperare una scheda che non risponde |
| 17 | Aggiornamenti OTA | Aggiornamento periodico via portale, senza cavi |
Migrazione dal vecchio portale
| # | Guida | A chi serve |
|---|---|---|
| 19 | Migrazione dal vecchio portale | Chi ha una dosometrica sul vecchio portale (iot.joy-reef.com): aggiornamento firmware + collegamento al nuovo portale |
Come usare questa documentazione
- Sei nuovo? Inizia da 01 — Shopping list e segui in ordine fino alla 05.
- Hai il sistema base funzionante? Affronta le 🟡 importanti (06-08, 14-15) per attivare gli automatismi reali.
- Hai un caso specifico? Vai direttamente alla guida 🔵 avanzata che ti interessa.
Tutte le guide sono disponibili anche in PDF stampabile sotto apps/portal/public/guides/.