PARTECIPA ALLA RETE
Una guida per misurare temperatura, umidità e H₂S con la configurazione verificata del progetto, 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.
La configurazione provata usa un modulo acquistato come Fosensor FS01701, con elemento marcato FS4EC/H2S-100 e scheda circolare SENSOR EC V1.5. La comunicazione e l’invio al sito sono stati verificati su questa installazione: non equivalgono a una taratura certificata.
Il modulo risponde a richieste Modbus RTU su UART TTL a 3,3 V, a 9600 baud, 8N1. Il firmware usa soltanto la funzione di lettura 03. Non occorrono MQ-136, ADS1115 o un convertitore RS485 per i pin RXD/TXD di questa variante.
| 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.
DAL PROGETTO ALLA PRIMA CENTRALINA
Le prime prove prendono forma: un contenitore stampato in 3D ospita la scheda ESP32, il sensore di temperatura e umidità e il modulo H₂S. Queste foto documentano l’assemblaggio e la prima collocazione del prototipo.
Prototipo in fase di test. Le fotografie documentano la costruzione, non una certificazione delle misure o della protezione dalle intemperie. Le letture delle centraline restano dati di collaudo fino al completamento delle verifiche. La raccolta delle segnalazioni dei cittadini è pienamente operativa.
Seleziona una foto per aprirla a dimensione intera.
Scollega l’USB prima di intervenire. Segui la serigrafia dei piedini, non l’orientamento delle foto. Le indicazioni valgono per la scheda verificata: altre varianti richiedono il proprio manuale.
| Modulo H₂S | ESP32 ESP-32S |
|---|---|
| Vin/VCC, pin 1 | 5 V / VIN della scheda di sviluppo alimentata via USB, dopo verifica della tensione |
| GND, pin 2 | GND comune |
| RXD, pin 7 | TX2 / GPIO17 |
| TXD, pin 8 | RX2 / GPIO16 |
| Pin 3–6 | Lasciare scollegati |
Alimentazione del modulo: 3,7–5,5 V; segnali UART: 3,3 V. Non applicare 5 V ai GPIO. Collegare anche RXD del modulo: in questa configurazione il sensore risponde alla richiesta del microcontrollore e la sola ricezione non basta.
La richiesta documentata è 01 03 00 00 00 04 44 09: legge concentrazione, stato allarme, numero di decimali e fondo scala. Il programma controlla indirizzo, formato e CRC16 prima di utilizzare il dato e non invia comandi di scrittura o calibrazione.
Il modulo provato restituisce decimali = 0 e registro fondo scala 100: i dati di concentrazione arrivano quindi come ppm interi. La risoluzione effettiva di 1 ppm è stata confermata dal venditore il 7 novembre 2026. Sul sito le singole letture di questo modulo vengono visualizzate senza decimali; eventuali cifre aggiuntive stampate in console non aumentano la capacità di misura. Uno zero non dimostra assenza assoluta di H₂S e non esclude concentrazioni sotto il passo di lettura.
La risoluzione di 0,1 ppm della scheda commerciale non corrisponde a quella confermata per il modulo consegnato. Il venditore precisa che una diversa configurazione richiede intervento sul firmware interno e ricalibrazione in fabbrica; non è ottenibile aggiungendo decimali nel programma ESP32. Non è stata confermata la possibilità di misurare 0,001 ppm. La conversione usa il registro dei decimali; non si divide arbitrariamente per dieci e non si modifica la configurazione per ottenere cifre apparenti.
Il registro di stato osservato è 0x0500. I bit alti sono indicati come non utilizzati nel manuale ricevuto: il loro significato resta da chiarire con il produttore. Il firmware riporta lo stato grezzo in console; non lo interpreta come un allarme gas o una garanzia di assenza di guasti.
Attendere almeno tre minuti di riscaldamento dopo l’alimentazione. Il manuale prescrive inoltre almeno 48 ore di stabilizzazione prima dell’uso: il primo intervallo non sostituisce la stabilizzazione. Lasciare intatta e libera la membrana superiore; non fissare il sensore con silicone, colle o solventi a contatto con il modulo. Per il fissaggio usare supporti meccanici appropriati.
https://espressif.github.io/arduino-esp32/package_esp32_index.json.aria_pulita_web/aria_pulita_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.
INVIA_H2S_AL_SITO = true e ricarica lo sketch conservando il tuo secrets.h. Per impostazione iniziale è false: l’H₂S si legge in console, il sito riceve temperatura e umidità.HTTP 200, {"ok":true} e la comparsa del dato nella scheda della centralina.Lo stato software valid indica il superamento dei controlli di comunicazione e dei limiti implementati, non una certificazione della misura. Il sistema è sperimentale e non sostituisce un rilevatore di sicurezza certificato.
| Messaggio o problema | Controllo |
|---|---|
| Nessuna risposta H₂S | Controlla alimentazione, massa comune, RXD sensore → TX2 e TXD sensore → RX2; non lasciare il ponte di prova RX2–TX2. Verifica variante e indirizzo Modbus. Non usare comandi di altri produttori. |
| Caratteri illeggibili | Monitor seriale a 115200 baud; UART del sensore a 9600 baud: sono due velocità distinte. |
| 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.
Riferimento per la variante installata: Henan Fosen, Electrochemical Series Gas Sensor Module, User Manual, sezioni 2.3 e 3. Il manuale va richiesto al produttore per la scheda effettivamente acquistata. La pagina commerciale non sostituisce il protocollo della variante.
Riferimenti tecnici di produttori e sviluppatori, non fonti governative. Guida aggiornata il 7 novembre 2026 sulla base del manuale Fosen ricevuto e della prova della centralina del progetto. Il firmware pubblico deriva dall’esempio della rete; la compilazione sulla configurazione Arduino del partecipante e il collaudo fisico restano necessari.