🔎 Quale versione scegliere?

Lo stesso ambiente, due modalità di preparazione.

💻 Prima di iniziare

Preparare il computer.

• 🐍 Python 3.10 o successivo: necessario per entrambi i pacchetti e non incluso.
• 🌐 Connessione Internet: necessaria per scaricare e preparare gli strumenti mancanti.
• 💾 Spazio disponibile: prevedi diversi GB per gli strumenti, soprattutto per ESP32.
• 🔌 Cavo USB dati: necessario per collegare la scheda al computer.
• 🧭 Chrome o Edge: da utilizzare per il monitor seriale.

🌐 Scarica Python per Windows dal sito ufficiale

👤 Versione singolo utente

Per il proprio computer.

Scarica il pacchetto personale ed estrai tutta la cartella prima di avviare ZZBlocks.

📥 Scarica ZIP singolo utente — 0.4.35 TEST

1. Installa Python, se non è già disponibile.
2. Scarica il file ZIP.
3. Clicca con il tasto destro sul file e scegli Estrai tutto.
4. Scegli una cartella personale in cui hai il permesso di scrivere.
5. Apri la cartella estratta ZZBlocks.
6. Avvia AVVIA_WINDOWS.bat.
7. Attendi l’apertura dell’editor nel browser.

🏫 Versione multiutente

Per i computer condivisi del laboratorio.

La distribuzione DIST permette di condividere programma e strumenti tra gli account del computer, mantenendo separati i dati personali degli utenti.

📥 Scarica ZIP multiutente — 0.4.35 TEST DIST

🛠️ Preparazione da parte dell’amministratore

1. Scarica ed estrai tutto lo ZIP.
2. Copia la cartella ZZBlocks in C:\Program Files\ZZBlocks.
3. Verifica che Python 3.10 o successivo sia disponibile per tutti gli account interessati.
4. Apri la cartella del programma, clicca con il tasto destro su PREPARA_STRUMENTI_PC.bat e scegli Esegui come amministratore.
5. Con Internet disponibile, attendi il messaggio Strumenti pronti per tutti gli utenti.
6. Clicca con il tasto destro su CREA_COLLEGAMENTO_TUTTI.bat e scegli Esegui come amministratore.
7. Accedi con un account standard e prova l’avvio dal collegamento sul desktop.

👩‍💻 Utilizzo quotidiano

Dopo la preparazione, ciascun utente può avviare ZZBlocks dal proprio account tramite il collegamento sul desktop, senza eseguirlo come amministratore.

🚀 Primo utilizzo

Dall’avvio al primo programma.

1. Avvia ZZBlocks e lascia aperta la finestra di avvio.
2. Seleziona la scheda: Arduino UNO, Arduino Mega oppure ESP32 WROOM.
3. Controlla lo stato degli strumenti e completa l’eventuale preparazione.
4. Apri un esempio semplice, come il lampeggio di un LED.
5. Collega la scheda con un cavo USB dati.
6. Verifica il programma e caricalo sulla scheda.
7. Per il monitor seriale, usa Chrome o Edge e autorizza l’accesso alla porta richiesta.

💾 Salvare i progetti

Conservare il proprio lavoro.

Esporta i progetti in formato .zzblocks e conservali in una tua cartella, separata da quella del programma.

• 📁 Usa nomi che descrivano il progetto.
• 💾 Salva una copia al termine di ogni attività.
• 🏫 Nei laboratori utilizza il percorso personale previsto dalla scuola.
• 🔄 Prima degli aggiornamenti, verifica di avere esportato il lavoro.

🔄 Aggiornare ZZBlocks

Passare a una nuova versione.

👤 Singolo utente

1. Esporta i progetti e chiudi ZZBlocks.
2. Scarica il nuovo pacchetto personale.
3. Estrailo completamente in una nuova cartella.
4. Avvia il nuovo AVVIA_WINDOWS.bat.
5. Apri i progetti salvati e verifica il funzionamento prima di eliminare la cartella precedente.

🏫 Multiutente — DIST

1. Chiudi ZZBlocks in tutti gli account Windows.
2. Come amministratore, sostituisci la cartella del programma con quella della nuova versione DIST, mantenendo il percorso C:\Program Files\ZZBlocks.
3. Conserva gli strumenti condivisi presenti in C:\ProgramData\ZZBlocks\shared-tools.
4. Ripeti PREPARA_STRUMENTI_PC.bat soltanto se richiesto dalla nuova versione o se la preparazione precedente non era riuscita.
5. Verifica avvio, compilazione e caricamento da un account standard.

📚 Istruzioni incluse

Guide disponibili nei pacchetti.

• 📄 LEGGIMI.txt: indicazioni per il pacchetto personale.
• 🏫 LEGGIMI_DIST.txt: istruzioni della distribuzione multiutente.
• 🛠️ GUIDA_INSTALLAZIONE_LABORATORIO.txt: preparazione e aggiornamento dei PC condivisi.

Per il pacchetto multiutente di questa pagina, segui le istruzioni contrassegnate 0.4.35 TEST DIST.

Un ambiente, più schede

La stessa interfaccia per iniziare e sviluppare progetti sempre più articolati.

• 🔌 Arduino UNO: primi circuiti, sensori e attività di robotica.
• 🧩 Arduino Mega: progetti che richiedono più collegamenti e periferiche.
• 📡 ESP32 WROOM: robotica, comunicazioni wireless e IoT.

Dai blocchi al codice

Un percorso dalla programmazione visuale al linguaggio Arduino C++.

Componi il programma con i blocchi e consulta il codice generato per scoprire come le istruzioni visive vengono tradotte in codice.

• ⚙️ Setup: le operazioni iniziali, eseguite all’avvio.
• 🔁 Loop: le istruzioni ripetute durante il funzionamento.
• 🧠 Logica e controllo: condizioni, cicli, variabili e funzioni per costruire il progetto.

In locale, anche offline

Un ambiente eseguito sul computer, pensato per il lavoro in laboratorio.

Dopo aver installato e configurato gli strumenti necessari, puoi creare programmi, verificarli e caricarli sulla scheda anche senza connessione Internet.

Il programma ti accompagna

Indicazioni in italiano per seguire le operazioni in corso.

I messaggi di stato aiutano a capire cosa sta facendo ZZBlocks durante la verifica e il caricamento del programma.

Le indicazioni di compatibilità aiutano inoltre a riconoscere i vincoli della scheda e delle funzioni utilizzate.

Meno attese nelle prove

La cache di compilazione favorisce il lavoro per tentativi e miglioramenti.

ZZBlocks può riutilizzare i file già compilati, riducendo i tempi delle compilazioni successive quando le condizioni lo consentono.

Questo aiuta durante le attività in cui si modifica il programma, si carica sulla scheda e si osserva il risultato.

Osservare i dati

Dalle letture dei sensori alla loro rappresentazione.

• 💬 Monitor seriale: visualizza messaggi e misure inviati dalla scheda.
• 📈 Serial Plotter: osserva l’andamento delle grandezze attraverso i grafici.
• 🎛️ Dashboard locale: presenta i dati con indicatori e grafici.

Strumenti utili per confrontare misure, verificare ipotesi e interpretare i risultati degli esperimenti.

Dal LED all’IoT

Attività progressive per imparare costruendo.

• 💡 Primi circuiti: LED, pulsanti, buzzer e semafori.
• 🌡️ Sensori: temperatura, umidità, luminosità, distanza e altre grandezze.
• 🖥️ Display e periferiche: visualizzazione e registrazione delle misure.
• 🤖 Robotica: motori, servomotori e comandi a distanza.
• 📡 Comunicazioni con ESP32: Wi-Fi, Bluetooth, MQTT, Telegram ed ESP-NOW.

Nato a scuola

Dalle esigenze del laboratorio a uno strumento per imparare facendo.

ZZBlocks nasce dal lavoro di Davide Zizioli, docente di matematica e scienze nella scuola secondaria di primo grado, appassionato di coding e robotica educativa.

L’obiettivo è facilitare l’avvio dei progetti e accompagnare gradualmente la comprensione del codice, lasciando spazio alla sperimentazione e alla creatività.