PARTECIPA ALLA RETE
Una guida per partire con temperatura e umidità, provare il dispositivo e chiedere al gestore l’abilitazione alla rete Aria Pulita.
Concorda con il gestore il modello di scheda, i sensori e il punto di installazione. Il download del firmware non abilita automaticamente l’invio: ogni centralina richiede credenziali personali assegnate dal gestore.
Chiedi di aderireScarica il firmware di esempioLa configurazione documentata usa una scheda di sviluppo ESP32 ESP-32S e un DHT11 compatibile con alimentazione a 3,3 V. Il firmware del progetto invia una lettura ogni minuto.
Il DHT11 serve per osservazioni indicative delle condizioni locali: non misura la concentrazione di inquinanti.
Il modulo elettrochimico FS01701 è previsto per un’integrazione successiva. Il pacchetto scaricabile non contiene ancora una lettura H₂S verificata: non abilitarla nel pannello finché sensore, protocollo e firmware non saranno collaudati.
MQ-136 e ADS1115 non sono necessari per la configurazione DHT11 descritta qui.
| Componente | Indicazioni |
|---|---|
| Scheda ESP32 ESP-32S di sviluppo | Con collegamento USB e GPIO23 accessibile; se scegli un’altra famiglia ESP32, verifica prima piedinatura e compatibilità del programma. |
| Modulo DHT11 | Compatibile con 3,3 V e pin marcati VCC, DATA e GND. Per il sensore nudo a quattro pin serve anche un pull-up da 10 kΩ fra DATA e 3V3. |
| Cavetti e supporto | Per le prime prove una breadboard; per l’installazione definitiva collegamenti stabili e isolati. |
| Cavo USB dati e alimentatore USB | Adatti alla propria scheda. Il cavo deve trasferire dati per caricare il programma. |
| Rete Wi-Fi 2,4 GHz | Con accesso Internet; il programma usa anche la sincronizzazione dell’ora. |
| Protezione e supporto di installazione | Proteggi l’elettronica da acqua e condensa e lascia il sensore ventilato, schermato dal sole diretto. |
Non è un elenco di acquisto vincolante: verifica la compatibilità prima di ordinare. Questa guida non fissa prezzi dei componenti.
Spegni e scollega l’alimentazione prima dei collegamenti. Usa i nomi stampati sul modulo: l’ordine fisico dei pin cambia fra i produttori.
| DHT11 compatibile 3,3 V | Scheda ESP32 |
|---|---|
| VCC / + | 3V3 |
| GND / − | GND |
| DATA / OUT / S | GPIO23 |
Non applicare 5 V al GPIO dell’ESP32. Se il tuo modulo richiede 5 V o ha un collegamento diverso, fermati e verifica il circuito prima di usarlo con questa guida. Per un sensore nudo a quattro pin, il pin non collegato non va usato come uscita dati.
https://espressif.github.io/arduino-esp32/package_esp32_index.json.dht11_web/dht11_web.ino. Seleziona scheda e porta USB corrispondenti al tuo dispositivo.secrets.example.h in secrets.h, nella stessa cartella dello sketch. Compila soltanto la copia locale con il tuo Wi-Fi e le credenziali ricevute dal gestore.| Campo | Come ottenerlo |
|---|---|
WIFI_SSID e WIFI_PASSWORD | Nome e password del tuo Wi-Fi; non inviarli al progetto. |
DEVICE_ID | Identificativo univoco assegnato dal gestore. |
DEVICE_KEY | Chiave personale consegnata privatamente dal gestore. Non usare la chiave di un’altra centralina. |
ROOT_CA | Certificato pubblico per verificare HTTPS. L’esempio include ISRG Root X1: conferma con il gestore che sia ancora adatto alla catena del dominio. |
Il firmware invia a https://cittadellestelle.it/h2s/api/network-ingest.php. Non occorrono password del database, accesso cPanel o credenziali amministratore. Il certificato CA è pubblico; la chiave dispositivo è riservata. Non disattivare la verifica HTTPS.
Invio HTTP: 200 seguita da {"ok":true}.Il programma conserva al massimo 120 campioni nella RAM in attesa di invio: circa due ore a un campione al minuto. La coda viene persa al riavvio; non è un archivio permanente.
| Messaggio o problema | Controllo |
|---|---|
| Errore DHT11 | Verifica alimentazione, DATA su GPIO23, massa comune e pull-up se richiesto dal sensore. |
| Nessuna connessione Wi-Fi | Controlla rete 2,4 GHz, copertura, nome e password nella tua copia di secrets.h. |
| HTTP 401 | Chiedi al gestore di controllare identificativo, chiave e abilitazione della stazione. Non pubblicare la chiave per ricevere aiuto. |
| HTTP 400 | Controlla data/ora e configurazione dei sensori; una lettura respinta con questo codice viene scartata dal programma. |
| HTTP 503 o connessione HTTPS fallita | Verifica rete e orario; con il gestore controlla disponibilità del server e certificato CA. |
Tieni il sensore lontano dal calore dell’ESP32, da sole diretto e superfici calde. Evita contenitori sigillati intorno al sensore: impediscono il ricambio d’aria. Documenta altezza, schermatura e condizioni di installazione per permettere di interpretare le letture.
Controlla periodicamente alimentazione, cavi, protezioni e continuità dei campioni. Concorda con il gestore la precisione della posizione pubblicata, soprattutto se il dispositivo si trova presso un’abitazione. Le misurazioni sperimentali non sono certificazioni ambientali né dispositivi di sicurezza.
Scrivi a mimmo.marozzi@gmail.com indicando il tuo contatto, località indicativa, modello della scheda e dei sensori, disponibilità di Wi-Fi e alimentazione e tipo di collocazione proposto.
Non allegare password Wi-Fi, credenziali del server o chiavi di altre centraline. La posizione esatta e le credenziali si concordano privatamente. La richiesta non crea automaticamente un account o una centralina.
Il gestore decide l’abilitazione, verifica i campioni e controlla la pubblicazione della scheda. Le misure diventano consultabili soltanto dopo l’abilitazione e la pubblicazione della stazione. L’abilitazione non certifica da sola l’accuratezza del sensore.
Riferimenti tecnici di produttori e sviluppatori, non fonti governative. Guida predisposta il 31 ottobre 2026. Il firmware pubblico deriva dall’esempio della rete; la compilazione sulla configurazione Arduino del partecipante e il collaudo fisico restano necessari.