Embedded Files
AGGIORNAMENTO DEL 07/01/2021: L'ESP32 NON PUÒ PIÙ GESTIRE IL CALENDARIO PERCHÈ GOOGLE HA RIMOSSO LA POSSIBILITÀ DI FARLO MEDIANTE IL METODO DI AUTENTICAZIONE IMPIEGATO IN QUESTA GUIDA. PER MAGGIORI INFORMAZIONI https://developers.google.com/identity/protocols/oauth2/limited-input-device.
AGGIORNAMENTO DEL 07/01/2021: L'ESP32 NON PUÒ PIÙ GESTIRE IL CALENDARIO PERCHÈ GOOGLE HA RIMOSSO LA POSSIBILITÀ DI FARLO MEDIANTE IL METODO DI AUTENTICAZIONE IMPIEGATO IN QUESTA GUIDA. PER MAGGIORI INFORMAZIONI https://developers.google.com/identity/protocols/oauth2/limited-input-device.
AGGIORNAMENTO DEL 05-11-2020: A CAUSA DI UN ERRORE, LA FORMATTAZIONE DEL TITOLO DI UN EVENTO È STATA MODIFICATA DA "From: " + esp32_id (mittente) + " To: " + esp32_id (destinatario) IN "From_" + esp32_id (mittente) + "___ ___To_" + esp32_id (destinatario). IL CODICE SORGENTE È STATO AGGIORNATO.
AGGIORNAMENTO DEL 05-11-2020: A CAUSA DI UN ERRORE, LA FORMATTAZIONE DEL TITOLO DI UN EVENTO È STATA MODIFICATA DA "From: " + esp32_id (mittente) + " To: " + esp32_id (destinatario) IN "From_" + esp32_id (mittente) + "___ ___To_" + esp32_id (destinatario). IL CODICE SORGENTE È STATO AGGIORNATO.
Dal link bit.ly/3iqa6X1 è possibile scaricare una revisione del progetto trattato nella precedente guida del 26/03/2020 (ormai obsoleta per via di un aggiornamento delle Google API) per schede di sviluppo compatibili Arduino basate sull'ESP32; in particolar modo, sono state diminuite le allocazioni di memoria dinamiche (per maggiori informazioni si rimanda a adafruit.com/memories-of-an-arduino/optimizing-sram). Il download include:
Dal link bit.ly/3iqa6X1 è possibile scaricare una revisione del progetto trattato nella precedente guida del 26/03/2020 (ormai obsoleta per via di un aggiornamento delle Google API) per schede di sviluppo compatibili Arduino basate sull'ESP32; in particolar modo, sono state diminuite le allocazioni di memoria dinamiche (per maggiori informazioni si rimanda a adafruit.com/memories-of-an-arduino/optimizing-sram). Il download include:
- una libreria contenuta nella cartella "TEB", da inserire fra quelle di Arduino IDE ("TEB\Documentation\index.html" è una guida sintetica che potrebbe contenere imprecisioni);
- una libreria contenuta nella cartella "TEB", da inserire fra quelle di Arduino IDE ("TEB\Documentation\index.html" è una guida sintetica che potrebbe contenere imprecisioni);
- uno sketch d'esempio per Arduino IDE.
- uno sketch d'esempio per Arduino IDE.
Prima di poter compilare lo sketch, è necessario aggiungere le informazioni indicate nelle seguenti immagini.
Prima di poter compilare lo sketch, è necessario aggiungere le informazioni indicate nelle seguenti immagini.
Nel file "sketch.ino" vanno inserite le credenziali della propria rete WiFi.
Nel file "sketch.ino" vanno inserite le credenziali della propria rete WiFi.
Nel file "TEB_OAuth2.h" vanno inseriti i valori API key, client id e client secret, ottenibili seguendo la prima parte della guida di Google developers.google.com...oauth2/input-device#prerequisites.
Nel file "TEB_OAuth2.h" vanno inseriti i valori API key, client id e client secret, ottenibili seguendo la prima parte della guida di Google developers.google.com...oauth2/input-device#prerequisites.
Le figure sottostanti mostrano le principali personalizzazioni al codice sorgente, che non modificano il comportamento dello sketch.
Le figure sottostanti mostrano le principali personalizzazioni al codice sorgente, che non modificano il comportamento dello sketch.
Nel file "algorithm.h" le variabili "administrator_id" e "esp32_id" devono avere valori univoci.
Nel file "algorithm.h" le variabili "administrator_id" e "esp32_id" devono avere valori univoci.
Nel file "TEB_Development_Board.h" è possibile disabilitare il supporto al display, al led onboard o la modalità di debug.
Nel file "TEB_Development_Board.h" è possibile disabilitare il supporto al display, al led onboard o la modalità di debug.
Nel file "TEB_Buffers.h" è possibile settare le dimensioni dei buffer globali usati nella libreria.
Nel file "TEB_Buffers.h" è possibile settare le dimensioni dei buffer globali usati nella libreria.
Lo sketch d'esempio, così com'è scritto, prevede che un amministratore:
Lo sketch d'esempio, così com'è scritto, prevede che un amministratore:
crei nel proprio account Google un calendario con lo stesso titolo impostato nel file "algorithm.h" (variabile "calendar_summary"), relativo alle schede di sviluppo;
utilizzi una o più schede di sviluppo, ognuna con un valore "esp32_id" (file "algorithm.h") diverso.
La funzione setup() del file "sketch.ino":
La funzione setup() del file "sketch.ino":
esegue la connessione alla rete WiFi, il login al server Google e inizializza il calendario delle schede di sviluppo;
se presente, legge l'evento con titolo "From: Administrator To: All".
La funzione loop() di "sketch.ino" esegue ciclicamente il seguente algoritmo:
La funzione loop() di "sketch.ino" esegue ciclicamente il seguente algoritmo:
riavvia la scheda di sviluppo se ha perso il collegamento alla rete WiFi;
viene ricercato l'evento contenente nel titolo la stringa "To: " + esp32_id (ad esempio "To: ESP32-1"), con data e ora d'inizio più vecchie; se non viene trovato nulla, il ciclo torna al punto 1;
se la data e l'ora d'inizio sono già trascorse, l'evento viene cancellato, altrimenti il ciclo riprende dal punto 1;
viene creato un evento identico al precedente rimosso, ma con data e ora d'inizio traslate in avanti di circa 45 secondi.
Gli eventi del punto 2 devono avere come titolo "From: Administrator To: " + esp32_id (destinatario) oppure "From: " + esp32_id (mittente) + " To: " + esp32_id (destinatario); quelli del primo tipo vengono creati dall'amministratore, i secondi dalle schede di sviluppo. Può esserci al massimo un solo evento con titolo "From: Administrator To: All". Nel caso in cui si verificassero errori durante l'esecuzione dello sketch, il dispositivo viene riavviato.
Gli eventi del punto 2 devono avere come titolo "From: Administrator To: " + esp32_id (destinatario) oppure "From: " + esp32_id (mittente) + " To: " + esp32_id (destinatario); quelli del primo tipo vengono creati dall'amministratore, i secondi dalle schede di sviluppo. Può esserci al massimo un solo evento con titolo "From: Administrator To: All". Nel caso in cui si verificassero errori durante l'esecuzione dello sketch, il dispositivo viene riavviato.
In tal modo, modificando opportunamente le funzioni presenti nei file "sketch.ino", "algorithm.h", "algorithm.cpp" e le descrizioni degli eventi presenti nel calendario, è possibile personalizzare il comportamento delle schede di sviluppo.
In tal modo, modificando opportunamente le funzioni presenti nei file "sketch.ino", "algorithm.h", "algorithm.cpp" e le descrizioni degli eventi presenti nel calendario, è possibile personalizzare il comportamento delle schede di sviluppo.
Alcune precisazioni:
Alcune precisazioni:
- la data e l'ora di fine degli eventi non vengono considerate;
- la data e l'ora di fine degli eventi non vengono considerate;
- nelle descrizioni degli eventi non si possono inserire le stringhe "From: Administrator To: All" e "From: " + esp32_id;
- nelle descrizioni degli eventi non si possono inserire le stringhe "From: Administrator To: All" e "From: " + esp32_id;
- nella creazione di un evento è consigliato modificare solo i campi titolo, descrizione, date e ore d'inizio e di fine, onde evitare problemi durante l'esecuzione dello sketch;
- nella creazione di un evento è consigliato modificare solo i campi titolo, descrizione, date e ore d'inizio e di fine, onde evitare problemi durante l'esecuzione dello sketch;
- nel codice sorgente potrebbero esserci errori non gestiti.
- nel codice sorgente potrebbero esserci errori non gestiti.
È previsto il supporto per un display oled come quello mostrato nella pagina startingelectronics.org/tutorials...n5qQgRisBcSrohFCA, con l'unica differenza che lavora a 3,3 V; va collegato alla scheda di sviluppo come segue.
È previsto il supporto per un display oled come quello mostrato nella pagina startingelectronics.org/tutorials...n5qQgRisBcSrohFCA, con l'unica differenza che lavora a 3,3 V; va collegato alla scheda di sviluppo come segue.
Al primo avvio la scheda richiede l'accesso al proprio account Google, che viene riassunto di seguito.
Al primo avvio la scheda richiede l'accesso al proprio account Google, che viene riassunto di seguito.
1) La scheda si collega a Internet mediante rete WiFi.
1) La scheda si collega a Internet mediante rete WiFi.
2) Da un dispositivo collegato a Internet (ad esempio PC, smartphone, ...) è necessario aprire il link www.google.com/device e inserire il codice visualizzato sul display.
2) Da un dispositivo collegato a Internet (ad esempio PC, smartphone, ...) è necessario aprire il link www.google.com/device e inserire il codice visualizzato sul display.
4) Per autorizzare l'accesso è necessario cliccare su Allow.
4) Per autorizzare l'accesso è necessario cliccare su Allow.
5) Accesso effettuato.
5) Accesso effettuato.
6) La scheda mostra il login riuscito.
6) La scheda mostra il login riuscito.
La procedura di login non andrà ripetuta finché le credenziali memorizzate nell'ESP32 saranno valide.
La procedura di login non andrà ripetuta finché le credenziali memorizzate nell'ESP32 saranno valide.
L'immagine seguente raffigura un calendario con un evento "From: Administrator To: All" e uno "From: ESP32-1 To: ESP32-1"; quest'ultimo viene cancellato e ricreato ciclicamente dalla scheda di sviluppo.
L'immagine seguente raffigura un calendario con un evento "From: Administrator To: All" e uno "From: ESP32-1 To: ESP32-1"; quest'ultimo viene cancellato e ricreato ciclicamente dalla scheda di sviluppo.
Il video sottostante mostra il comportamento dell'ESP32 col display.
Il video sottostante mostra il comportamento dell'ESP32 col display.
Per la scrittura della libreria e dello sketch mi sono aiutato con gli esempi contenuti in Arduino IDE, le librerie OakOLED (supporto al display, di netguy204) e Time (gestione del tempo, di PaulStoffregen). Pertanto ringrazio i relativi autori.
Per la scrittura della libreria e dello sketch mi sono aiutato con gli esempi contenuti in Arduino IDE, le librerie OakOLED (supporto al display, di netguy204) e Time (gestione del tempo, di PaulStoffregen). Pertanto ringrazio i relativi autori.
Note:
Note:
1) il progetto non implementa tutti i sistemi di sicurezza moderni per la protezione dei dati, quindi è meglio evitare di inserire dati sensibili nelle informazioni scambiate tra la scheda di sviluppo e Internet;
1) il progetto non implementa tutti i sistemi di sicurezza moderni per la protezione dei dati, quindi è meglio evitare di inserire dati sensibili nelle informazioni scambiate tra la scheda di sviluppo e Internet;
2) le mie conoscenze di programmazione non sono molto elevate e punto a migliorarle nel tempo; prestate attenzione dunque, perché potreste trovare errori di programmazione e algoritmi sbagliati nel codice sorgente;
2) le mie conoscenze di programmazione non sono molto elevate e punto a migliorarle nel tempo; prestate attenzione dunque, perché potreste trovare errori di programmazione e algoritmi sbagliati nel codice sorgente;
3) il software è fornito "così com'è", senza alcun tipo di garanzia; non mi assumo nessuna responsabilità sulle conseguenze derivanti dall'uso delle informazioni contenute in questa pagina.
3) il software è fornito "così com'è", senza alcun tipo di garanzia; non mi assumo nessuna responsabilità sulle conseguenze derivanti dall'uso delle informazioni contenute in questa pagina.
Google Sites
Report abuse