📋 Attività DomoApp

Obiettivo

Rilevare un evento sismico analizzando i dati del giroscopio e dell'accelerometro della scheda. Quando viene rilevato un movimento anomalo (vibrazione), attivare un segnale di allarme composto da bip sonori e luci rosse lampeggianti. L'allarme si disattiva automaticamente quando il movimento cessa.

Passi per lo sviluppo

• Leggere i dati del giroscopio — Utilizzare il metodo SDK per leggere i valori degli assi X, Y, Z dal sensore giroscopico. Il metodo restituisce i dati in formato JSON.
• Definire una soglia di attivazione — Stabilire un valore soglia (ad esempio, accelerazione > 1.5g o variazione angolare > 50°/s) oltre il quale il sistema considera il movimento come "anomalo". Sperimentare con la scheda per trovare il valore migliore.
• Polling periodico — Implementare un loop (o un timer schedulato) che legge i valori del giroscopio ogni 100-200 ms per avere una rilevazione reattiva.
• Attivare l'allarme sonoro — Quando la soglia viene superata, utilizzare il metodo SDK per attivare il buzzer con una frequenza allarmante (es. 2000 Hz, durata 300 ms, ripetuto).
• Attivare le luci rosse lampeggianti — Accendere i LED in rosso (R=255, G=0, B=0), spegnere dopo 300 ms, riaccendere dopo 300 ms, creando un effetto lampeggiante.
• Disattivare l'allarme — Quando le letture del giroscopio tornano sotto la soglia per almeno 2-3 secondi consecutivi, spegnere buzzer e LED.

Suggerimenti tecnici

• Usare un filtro a media mobile (media degli ultimi N campioni) per evitare falsi positivi da singoli picchi isolati.
• Testare l'allarme scuotendo fisicamente la scheda e osservando la pagina Test MQTT per vedere i valori raw del giroscopio.
• Prevedere un comando MQTT per abilitare/disabilitare il monitoraggio sismico dall'app web.

Obiettivo

Monitorare la qualità dell'aria rilevata dal sensore della scheda. Quando i livelli indicano la presenza di fumo o gas, attivare un allarme con bip sonori e luci rosse lampeggianti. L'allarme si disattiva quando la qualità dell'aria torna ai livelli normali.

Passi per lo sviluppo

• Leggere i dati del sensore di qualità dell'aria — Utilizzare il metodo SDK appropriato per ottenere i valori del sensore ambientale. I dati includono indicatori di qualità dell'aria (TVOC, eCO2, ecc.).
• Definire le soglie di allarme — Stabilire i livelli critici: ad esempio, TVOC > 500 ppb o eCO2 > 1000 ppm. Consultare le specifiche del sensore per i range normali.
• Polling periodico — Leggere il sensore ogni 1-2 secondi. La qualità dell'aria cambia più lentamente rispetto alle vibrazioni, quindi un intervallo più lungo è sufficiente.
• Attivare l'allarme — Come per il terremoto: buzzer con bip intermittenti + LED rossi lampeggianti.
• Livelli di gravità — Implementare almeno 2 livelli: attenzione (LED arancioni, bip lento) e pericolo (LED rossi, bip veloce).
• Disattivare l'allarme — Quando i valori scendono sotto la soglia per almeno 10 secondi consecutivi.

Suggerimenti tecnici

• Il sensore potrebbe necessitare di un breve periodo di riscaldamento (warm-up) dopo l'accensione. Le prime letture potrebbero non essere accurate.
• Implementare un log storico dei valori letti, utile per il debug e per visualizzarli nell'app web (Gruppo 4).
• Prevedere un comando per impostare le soglie da remoto, così il Gruppo 4 potrà inserire un pannello di configurazione.

Obiettivo

Quando viene rilevato un movimento in casa, la scheda deve scattare 3 foto in rapida successione e inviare un segnale di allarme via WhatsApp utilizzando le API GREEN-API.

Passi per lo sviluppo

• Rilevare il movimento — Utilizzare i dati del giroscopio/accelerometro (come nell'attività 1.1) oppure, se disponibile, un sensore PIR. Definire una soglia specifica per il "movimento in casa" (diversa da quella sismica).
• Scattare 3 foto — Al rilevamento, invocare il metodo SDK per scattare una foto. Ripetere 3 volte con un breve intervallo (es. 500 ms tra uno scatto e l'altro) per catturare sequenze dell'evento.
• Configurare GREEN-API — Registrarsi su green-api.com e ottenere le credenziali (ID istanza e token). GREEN-API permette di inviare messaggi WhatsApp tramite chiamate HTTP REST.
• Inviare la notifica WhatsApp — Effettuare una chiamata HTTP POST all'endpoint GREEN-API per inviare un messaggio contenente:
  • Testo di allarme: "⚠️ ALLARME: Movimento rilevato in casa! Ora: HH:MM:SS"
  • Le 3 foto scattate come allegati (inviarle come file o come URL se vengono salvate su un server)
• Anti-spam — Implementare un cooldown di almeno 30-60 secondi tra un allarme e l'altro per evitare invii multipli ravvicinati.

Esempio chiamata GREEN-API

// Endpoint per inviare messaggio di testo
POST https://api.green-api.com/waInstance{ID}/sendMessage/{TOKEN}
Content-Type: application/json

{
  "chatId": "39XXXXXXXXXX@c.us",
  "message": "⚠️ ALLARME: Movimento rilevato in casa!\nOra: 14:35:22\nFoto in arrivo..."
}

// Endpoint per inviare un file/immagine
POST https://api.green-api.com/waInstance{ID}/sendFileByUrl/{TOKEN}
Content-Type: application/json

{
  "chatId": "39XXXXXXXXXX@c.us",
  "urlFile": "https://url-della-foto.jpg",
  "fileName": "allarme_foto_1.jpg",
  "caption": "Foto 1 - Movimento rilevato"
}

Suggerimenti tecnici

• Salvare le credenziali GREEN-API in un file di configurazione, non hardcoded nel sorgente.
• Per inviare le foto via GREEN-API come URL, è necessario prima caricarle su un server accessibile (o usare l'endpoint sendFileByUpload per invio diretto).
• Testare il flusso completo: movimento → foto → invio → ricezione su WhatsApp.

Obiettivo

Le luci si accendono automaticamente quando il sensore rileva che la luminosità ambientale è bassa (ad esempio al tramonto o in una stanza buia), e si spengono quando la luminosità torna sopra la soglia.

Passi per lo sviluppo

• Leggere il sensore di luminosità — Utilizzare il metodo SDK per ottenere il valore di lux dall'ambiente. Il sensore restituisce un valore numerico (più alto = più luce).
• Definire la soglia di attivazione — Sperimentare con il sensore: ad esempio, soglia = 100 lux. Sotto questa soglia → luci accese; sopra → luci spente.
• Isteresi — Per evitare sfarfallio (luci che si accendono e spengono continuamente al confine della soglia), usare due soglie: accensione sotto 80 lux, spegnimento sopra 120 lux.
• Polling — Leggere il sensore ogni 2-5 secondi. Non serve una frequenza alta perché la luminosità cambia lentamente.
• Accendere i LED — Quando la soglia viene superata, accendere tutti i LED con un colore bianco caldo (es. R=255, G=200, B=100) o il colore scelto dall'utente (vedi attività 2.4).
• Spegnere i LED — Quando la luminosità risale, spegnere i LED con una transizione graduale (opzionale ma elegante).

Suggerimenti tecnici

• Esporre la soglia come parametro configurabile dall'app web, così il Gruppo 4 può creare uno slider nell'interfaccia.
• Inviare un messaggio MQTT con il valore di luminosità corrente, utile per il Gruppo 4 per visualizzare un grafico.

Obiettivo

Permettere all'utente di impostare un orario di accensione e un orario di spegnimento delle luci. Ad esempio: accensione alle 18:30, spegnimento alle 23:00.

Passi per lo sviluppo

• Ricevere i parametri via MQTT — Definire un topic MQTT (es. domoapp/luci/timer) sul quale l'app invia un payload JSON:

  {
    "accensione": "18:30",
    "spegnimento": "23:00",
    "colore": { "r": 255, "g": 200, "b": 100 },
    "attivo": true
  }

• Gestire l'orologio — La scheda deve conoscere l'ora corrente. Verificare se la scheda si sincronizza via NTP all'avvio, oppure ricevere l'ora dal server.
• Confronto orario — Ogni minuto, confrontare l'ora corrente con gli orari impostati. Se l'ora corrente è compresa nel range → luci accese; altrimenti → spente.
• Gestire il caso "a cavallo della mezzanotte" — Se accensione=22:00 e spegnimento=06:00, il range attraversa la mezzanotte. Gestire questo caso speciale.
• Persistenza — Salvare le impostazioni del timer in modo che sopravvivano a un riavvio della scheda (opzionale, ma utile).

Obiettivo

Le luci si accendono automaticamente quando viene rilevato un movimento (ad esempio, una persona entra in una stanza). Dopo un periodo di inattività, le luci si spengono.

Passi per lo sviluppo

• Rilevare il movimento — Utilizzare l'accelerometro/giroscopio come trigger di prossimità. In alternativa, se si scatta una foto periodica, usare un confronto rudimentale tra due frame successivi.
• Accendere le luci — All'evento di movimento, accendere i LED immediatamente.
• Timeout di spegnimento — Avviare un timer (es. 2 minuti). Se non viene rilevato ulteriore movimento entro il timeout, spegnere le luci.
• Reset del timer — Se viene rilevato nuovo movimento mentre le luci sono accese, resettare il countdown del timeout.
• Timeout configurabile — L'utente deve poter impostare la durata del timeout dall'app web (30 sec, 1 min, 2 min, 5 min…).

Suggerimenti tecnici

• Questa funzionalità può entrare in conflitto con l'accensione automatica (attività 2.1) e il timer (attività 2.2). Definire delle priorità: ad esempio, il timer manuale ha la priorità più alta, poi il movimento, poi la luminosità.

Obiettivo

L'utente può scegliere il colore delle luci tramite l'app web. Il colore scelto viene applicato a tutte le modalità di accensione (automatica, timer, movimento).

Passi per lo sviluppo

• Definire il topic MQTT per il colore — Ad esempio domoapp/luci/colore con payload:

  { "r": 255, "g": 100, "b": 50 }

• Applicare il colore — Quando si riceve il comando, memorizzare i valori RGB e utilizzarli come colore predefinito ogni volta che i LED vengono accesi.
• Colori predefiniti — Offrire una palette di colori preimpostati: bianco caldo, bianco freddo, rosso relax, blu notte, verde natura, ecc. Definire i valori RGB per ciascuno.
• Anteprima — Quando l'utente seleziona un colore dall'app, accendere momentaneamente i LED con quel colore per 3 secondi come anteprima.
• Effetti (bonus) — Implementare effetti speciali: rainbow (scorrimento colori), pulsazione lenta, disco (colori random veloci).

Suggerimenti tecnici

• Coordinarsi con il Gruppo 4 per il color picker nell'interfaccia web: l'ideale è un widget HTML5 <input type="color"> che restituisce valori esadecimali da convertire in RGB.
• Memorizzare l'ultimo colore scelto in modo persistente per non perderlo al riavvio.

Obiettivo

Permettere l'ascolto della radio in streaming dalla scheda ElioKit, con tutti i controlli: cambio stazione, regolazione volume, accensione e spegnimento.

Passi per lo sviluppo

• Lista stazioni radio — Creare un elenco di URL di stream radio (formato MP3/AAC). Esempi:

  // Stazioni radio italiane in streaming
  RTL 102.5:     http://streamingv2.shoutcast.com/rtl1025
  Radio Deejay:  https://streamcdnm10-dd782ed59e2a4e86aabf6fc508674b59.msvdn.net/live/S97044836/chunklist.m3u8
  RDS:           http://stream.rds.it/rds
  Radio 105:     http://icecast.unitedradio.it/Radio105.mp3

• Avviare la radio — Utilizzare il metodo SDK per avviare lo streaming audio passando l'URL della stazione selezionata.
• Cambio stazione — Fermare lo stream corrente e avviarne uno nuovo con l'URL della nuova stazione.
• Regolazione volume — Utilizzare il metodo SDK per impostare il volume (range 0-100).
• Accensione / Spegnimento — Un comando per avviare lo streaming e uno per fermarlo.
• Topic MQTT — Definire topic dedicati:
  • domoapp/radio/play — con payload: { "url": "http://...", "stazione": "RTL 102.5" }
  • domoapp/radio/stop
  • domoapp/radio/volume — con payload: { "volume": 75 }

Suggerimenti tecnici

• Alcuni stream richiedono headers HTTP specifici; verificare che l'SDK li supporti.
• Gestire l'errore di stream non disponibile e notificarlo all'app web.
• Inviare lo stato corrente (in riproduzione / stazione / volume) su un topic di risposta, utile al Gruppo 4 per aggiornare l'interfaccia.

Obiettivo

Implementare una sveglia programmabile: l'utente imposta un orario di sveglia, il numero di ripetizioni del suono e può spegnerla manualmente.

Passi per lo sviluppo

• Ricevere i parametri via MQTT — Topic: domoapp/sveglia/imposta con payload:

  {
    "ora": "07:30",
    "ripetizioni": 5,
    "suono": "buzzer",
    "attiva": true
  }

• Controllo orario — Verificare ogni 30 secondi se l'ora corrente corrisponde all'ora della sveglia impostata.
• Attivazione della sveglia — Quando scatta:
  • Emettere un bip con il buzzer (es. 1000 Hz per 500 ms, pausa 500 ms, ripetere)
  • Accendere i LED con un effetto "sunrise" (da spento → giallo chiaro → bianco brillante, gradualmente)
  • Ripetere il ciclo per il numero di volte impostato
• Spegnimento manuale — L'utente può inviare un comando domoapp/sveglia/stop per fermare la sveglia prima che completi tutte le ripetizioni.
• Snooze (bonus) — Posticipare la sveglia di 5 minuti con un comando domoapp/sveglia/snooze.

Suggerimenti tecnici

• Prevedere più sveglie (ad esempio un array di sveglie), ciascuna con i propri parametri.
• Considerare l'opzione di usare un suono MP3 al posto del buzzer, sfruttando il sistema audio della scheda.

Obiettivo

L'utente imposta un timer (conto alla rovescia). Alla scadenza, la scheda emette un bip e i LED si accendono di blu ogni 2 secondi. L'utente può disattivare il timer in qualsiasi momento.

Passi per lo sviluppo

• Ricevere il timer via MQTT — Topic: domoapp/timer/imposta con payload:

  {
    "durata_secondi": 300,
    "attivo": true
  }

• Countdown — Avviare un countdown interno. Opzionalmente, pubblicare ogni secondo il tempo rimanente su domoapp/timer/stato perché il Gruppo 4 possa mostrare il countdown nell'interfaccia.
• Alla scadenza:
  • Emettere un bip col buzzer (es. 1500 Hz, 200 ms)
  • Accendere i LED blu (R=0, G=0, B=255) per 1 secondo
  • Spegnere per 1 secondo
  • Ripetere il ciclo fino alla disattivazione
• Disattivazione — Topic: domoapp/timer/stop. Ferma il bip e spegne i LED.
• Timer multipli (bonus) — Supportare più timer contemporanei, ognuno con il proprio nome e durata.

Suggerimenti tecnici

• Pubblicare aggiornamenti sul topic di stato per consentire al Gruppo 4 di mostrare una barra di progresso o countdown nell'interfaccia.
• Gestire correttamente il caso in cui il timer viene reimpostato mentre uno è già attivo (cancellare il precedente e avviarne uno nuovo).

Obiettivo

L'utente scrive un messaggio di testo nell'app web e la scheda ElioKit lo riproduce come messaggio vocale attraverso lo speaker, utilizzando il sistema di Text-to-Speech (TTS).

Passi per lo sviluppo

• Ricevere il testo via MQTT — Topic: domoapp/messaggio/invia con payload:

  {
    "testo": "Ciao ragazzi, la cena è pronta!",
    "voce": "Bianca",
    "volume": 80
  }

• Invocare il TTS — Utilizzare il metodo SDK per inviare il testo al sistema Text-to-Speech della scheda. Il TTS converte il testo in audio e lo riproduce sullo speaker.
• Impostare il volume — Prima di riprodurre, impostare il volume desiderato.
• Feedback — Pubblicare un messaggio di conferma su domoapp/messaggio/stato (es. { "stato": "in_riproduzione" }, poi { "stato": "completato" }).
• Coda messaggi — Se arrivano più messaggi, metterli in coda e riprodurli uno alla volta.

Suggerimenti tecnici

• Il TTS potrebbe dipendere da un servizio cloud (es. AWS Polly). Verificare che la scheda sia connessa a Internet.
• Definire un limite di lunghezza del messaggio (es. max 200 caratteri) per evitare abusi.
• Coordinare con il Gruppo 4 per il campo di input nell'interfaccia, includendo la selezione della voce se disponibile.

Obiettivo

Progettare e realizzare la struttura base dell'applicazione web con Spring Boot, integrando un client MQTT per comunicare con la scheda.

Passi per lo sviluppo

• Creare il progetto Spring Boot — Usare Spring Initializr con le dipendenze:
  • spring-boot-starter-web — per le API REST e le pagine web
  • spring-boot-starter-thymeleaf — per il templating HTML (o usare un frontend separato in React/Vue)
  • spring-integration-mqtt — per la connessione MQTT
  • spring-boot-starter-websocket — per aggiornamenti real-time verso il browser
• Configurare il client MQTT — In application.properties:

  mqtt.broker.url=tcp://INDIRIZZO_BROKER:1883
  mqtt.client.id=domoapp-webapp
  mqtt.username=
  mqtt.password=
  mqtt.default.topic=domoapp/#

• Creare il servizio MQTT — Una classe @Service che:
  • Si connette al broker all'avvio
  • Sottoscrive i topic di risposta dalla scheda
  • Fornisce metodi per pubblicare comandi
  • Notifica i controller via eventi quando arrivano messaggi
• WebSocket per il real-time — Configurare WebSocket (con SockJS + STOMP) per inviare aggiornamenti live al browser quando arrivano dati dalla scheda.
• Struttura del progetto:

  src/main/java/com/domoapp/
  ├── DomoAppApplication.java          // Main
  ├── config/
  │   ├── MqttConfig.java              // Configurazione MQTT
  │   └── WebSocketConfig.java         // Configurazione WebSocket
  ├── service/
  │   ├── MqttService.java             // Invio/ricezione MQTT
  │   ├── SicurezzaService.java        // Logica Gruppo 1
  │   ├── LuciService.java             // Logica Gruppo 2
  │   └── IntrattenimentoService.java  // Logica Gruppo 3
  ├── controller/
  │   ├── DashboardController.java     // Pagina principale
  │   ├── SicurezzaController.java     // API Gruppo 1
  │   ├── LuciController.java          // API Gruppo 2
  │   └── IntrattenimentoController.java // API Gruppo 3
  └── model/
      ├── AllarmeConfig.java
      ├── LuciConfig.java
      ├── RadioConfig.java
      └── TimerConfig.java

Obiettivo

Creare le pagine web e le API REST per controllare tutte le funzionalità implementate dagli altri gruppi.

Pagine da realizzare

• Dashboard — Pagina principale con panoramica dello stato della casa: allarmi attivi, luci accese, radio in riproduzione, timer attivi. Utilizzare card o widget aggiornati in tempo reale via WebSocket.
• Pannello Sicurezza (Gruppo 1):
  • Toggle ON/OFF per monitoraggio terremoto
  • Toggle ON/OFF per monitoraggio fumo
  • Toggle ON/OFF per sorveglianza movimento
  • Slider per regolare le soglie di sensibilità
  • Visualizzazione ultime 3 foto scattate
  • Log degli allarmi recenti con timestamp
• Pannello Luci (Gruppo 2):
  • Toggle ON/OFF luci manuali
  • Toggle per modalità automatica (sensore luminosità)
  • Impostazione orario accensione/spegnimento (2 input time)
  • Toggle per accensione su movimento
  • Color picker per scegliere il colore
  • Palette colori predefiniti
  • Indicatore luminosità ambientale corrente
• Pannello Intrattenimento (Gruppo 3):
  • Player radio con lista stazioni, play/stop, slider volume
  • Impostazione sveglia: input orario, numero ripetizioni, ON/OFF
  • Timer: input durata, start/stop, countdown in tempo reale
  • Campo testo per messaggio vocale con pulsante "Invia"

API REST da esporre

// ── Sicurezza ──
POST   /api/sicurezza/terremoto/toggle     // { "attivo": true }
POST   /api/sicurezza/fumo/toggle          // { "attivo": true }
POST   /api/sicurezza/sorveglianza/toggle  // { "attivo": true }
GET    /api/sicurezza/allarmi              // Lista allarmi recenti
GET    /api/sicurezza/foto                 // Ultime foto scattate

// ── Luci ──
POST   /api/luci/toggle                    // { "accese": true }
POST   /api/luci/colore                    // { "r": 255, "g": 100, "b": 50 }
POST   /api/luci/auto                      // { "attivo": true, "soglia": 100 }
POST   /api/luci/timer                     // { "accensione": "18:30", "spegnimento": "23:00" }
POST   /api/luci/movimento                 // { "attivo": true, "timeout": 120 }

// ── Intrattenimento ──
POST   /api/radio/play                     // { "url": "http://...", "stazione": "RTL" }
POST   /api/radio/stop
POST   /api/radio/volume                   // { "volume": 75 }
POST   /api/sveglia/imposta                // { "ora": "07:30", "ripetizioni": 5 }
POST   /api/sveglia/stop
POST   /api/timer/imposta                  // { "durata_secondi": 300 }
POST   /api/timer/stop
POST   /api/messaggio/invia                // { "testo": "...", "voce": "Bianca" }

Suggerimenti tecnici

• Design responsive — L'app deve funzionare su desktop e mobile. Usare un framework CSS come Bootstrap 5 o Tailwind CSS.
• Coordinamento con i gruppi — Concordare i topic MQTT e i formati dei payload JSON con ogni gruppo. Documentare ogni contratto in modo chiaro.
• WebSocket — Utilizzare STOMP over WebSocket per ricevere aggiornamenti in tempo reale: stato allarmi, valore luminosità, countdown timer, stato radio.
• Gestione errori — Mostrare notifiche toast quando un'operazione fallisce o quando la scheda non risponde.
• Autenticazione (bonus) — Aggiungere un login base per proteggere l'accesso al pannello di controllo.