← Torna alla landing

IL QUADERNO PRATICO / ECOBOT-3

Una prima prova.
Un nuovo punto di partenza.

Dal lavoro di gruppo al collegamento del robot: una guida essenziale per iniziare e risorse tecniche per approfondire.

01 / PREPARARE IL LABORATORIO

Una sfida piccola, tante idee.

Il percorso di Robotica Creativa mette al centro sperimentazione, collaborazione e possibilità di contribuire con ruoli diversi. Una prima consegna può essere: portare il veicolo da una linea di partenza a una zona di arrivo.

  1. Osservate e disegnate. Riconoscete telaio, ruote, alimentazione, attuatori e controllo. Scegliete i materiali di recupero utilizzabili e disegnate la vostra soluzione.
  2. Distribuite i ruoli. Progettista, montatore, collaudatore e narratore si alternano. Si può osservare, misurare o raccontare anche senza usare il computer o lavorare sui circuiti.
  3. Costruite e prevedete. Assemblate le parti predisposte. Rappresentate con parole, immagini o carte-comando ciò che il robot dovrebbe fare.
  4. Provate e confrontate. Segnate partenza e arrivo, misurate tempo e distanza e ripetete la prova. Cambiate una sola variabile quando possibile.
  5. Raccontate una scoperta. Conservate una tabella delle prove e preparate la carta d’identità del robot. Spiegate una modifica, il suo effetto e che cosa provereste dopo.

Alimentazioni, batterie e cablaggi vengono verificati dall’adulto. Componenti e strumenti si scelgono in base alla dotazione disponibile e alle esigenze del gruppo.

Cosa hai scoperto?

Quale contributo hai dato? Che cosa hai imparato da un compagno? Quale difficoltà ti ha suggerito una nuova prova? Le risposte possono essere scritte, orali o visuali.

02 / IL PRIMO AVVIO

Il robot ha già il firmware ECOBOT?

Sì: collegati e guida.

  1. Accendi il robot e individua il nome della sua rete Wi-Fi. La rete locale è aperta e non offre Internet.
  2. Nell’app scegli «Sì, vai alla guida», indica il nome della rete e conferma il collegamento richiesto da Android. Per la connessione manuale usa le impostazioni Wi-Fi del telefono e rimani sulla rete del robot.
  3. Dal browser, anche su iPhone o iPad, apri http://192.168.4.1/ dopo esserti collegato alla rete del robot.
  4. Prova i comandi sotto supervisione, inizialmente con ruote sollevate. Rilascia il joystick per fermare il robot; il pulsante STOP arresta e richiede una ripresa esplicita del controllo.

L’app richiede firmware con protocollo 2. Un firmware precedente non compatibile deve essere aggiornato tramite USB.

No: prepara la prima installazione.

Servono Android 10 o successivo, un telefono con USB host/OTG, un cavo dati e una scheda ESP8266 con almeno 4 MB di flash. Il firmware delle tre varianti è incluso nell’app. Segui la procedura dettagliata di flash USB.

  1. Togli alimentazione ai motori e collega la scheda al telefono.
  2. Scegli «No, installa via USB» e identifica la variante hardware corretta. Il driver motori non può essere rilevato automaticamente dalla porta USB.
  3. Conferma la sostituzione di firmware e impostazioni e autorizza il dispositivo USB. Attendi la verifica finale prima di scollegare.
  4. Se la scheda non dispone di reset automatico, segui il percorso BOOT manuale: tieni FLASH/BOOT, premi e rilascia RESET, poi rilascia FLASH.
  5. Al termine scegli «Passa alla guida» e collegati al Wi-Fi del robot.

Un modulo ESP-12E senza USB richiede un adattatore seriale a 3,3 V e il cablaggio di boot appropriato. Se la scrittura USB viene interrotta, ripeti l’installazione.

Disponibilità dell’app: la versione 1.0.0 è nella traccia di test interno; la versione 1.0.1 con informativa offline è il candidato successivo. Per il test contatta bytefullness@gmail.com.

03 / DENTRO IL FIRMWARE

Un programma, tre configurazioni.

Le sorgenti del firmware sono in C, nella cartella main/ del progetto. La build usa ESP8266_RTOS_SDK v3.4. Il firmware gestisce motori, servo, azioni, impostazioni e aggiornamento; espone il protocollo 2 e serve la pagina di guida dalla scheda.

Varianti hardware del firmware ECOBOT-3
Scheda e driverVariante da scegliere
D1 mini + MX1919Hd1mini_mx1919
ESP-12E + L293Desp12e_l293d
D1 mini + dual PWMd1mini_dual_pwm

La scheda scolastica originaria citava anche un driver L298N: non è una delle tre varianti attuali. Verifica modello del driver e cablaggio prima di scegliere l’immagine.

Controllo del movimento

Ogni comando appartiene a una sessione e ha un numero di sequenza e una conferma di ricezione. Lo STOP invalida la sessione; i comandi vecchi non possono rimettere in moto il robot. In assenza di aggiornamenti, il firmware attenua il comando dopo 700 ms e applica l’arresto al limite watchdog di 1.800 ms, più un ciclo di controllo.

Questi sono i comportamenti previsti e verificati nei test software. Tempi reali, direzione dei motori, servo e interruzioni del collegamento richiedono il collaudo del robot fisico.

Aggiornamento via Wi-Fi (OTA)

Dall’app o dalla pagina locale http://192.168.4.1/update, seleziona il solo file applicativo ecobot3_<variante>.bin. Le immagini USB complete non sono file OTA. Durante l’aggiornamento le uscite vengono fermate; il firmware controlla dimensione, integrità e corrispondenza della variante prima di cambiare la partizione di avvio.

Un upload incompleto conserva la selezione dell’applicazione precedente. Un’immagine formalmente valida ma non avviabile può richiedere il ripristino USB: non è previsto un rollback automatico garantito.

Compilazione da computer

Dalla radice dei sorgenti del progetto, su Linux x86-64:

tools/setup-firmware.sh
tools/build-firmware.sh d1mini_mx1919
tools/build-firmware.sh esp12e_l293d
tools/build-firmware.sh d1mini_dual_pwm
tools/test-firmware.sh

Il setup prepara le dipendenze in .tools/; le immagini sono in build/<variante>/. La guida tecnica scaricabile descrive toolchain, pin, flash da computer e build Android. I comandi vanno eseguiti nel repository completo, non nella sola cartella della landing.

Il Wi-Fi è aperto e il protocollo usa HTTP locale. Il blocco di sessione coordina i client e non autentica le persone collegate alla rete. Usa il robot in un contesto di laboratorio supervisionato.

04 / PER APPROFONDIRE

Tieni a portata le istruzioni.

Documentazione testuale del progetto, aggiornata alla preparazione della landing del 28 settembre 2026. Il registro distingue le verifiche software dalle prove hardware ancora da completare.

Le radici del progetto

Questa pagina riprende la scheda originale «Robotica Creativa» e il percorso «Robotica educativa e creativa – Costruire, provare, collaborare» per l’anno scolastico 2026/27, curato dal prof. Giuseppe David presso l’I.C. “Federico De Roberto” di Catania.

Sintesi Robotica Creativa – I.C. De Roberto Catania plesso Castaldi · Video del canale Scuole Aperte Catania.