LISYclock Config Editor – Manuale d’uso

Versione 1.11 | Lingua: Italiano

Indice

1. Panoramica
2. Requisiti & Avvio
3. Operazioni sui file
4. Scheda: Clock
5. Scheda: General
6. Scheda: Events
7. Scheda: GI LEDs
8. Scheda: Attract Mode
9. Scheda: TTS Settings
10. Scheda: Update
11. Scheda: Debug
12. config.txt – Formato & Struttura
13. Suggerimenti & Note

1. Panoramica

Il LISYclock Config Editor è uno strumento per modificare comodamente il file di configurazione config.txt del LISYclock.

• Applicazione standalone: un singolo file LISYclock_config_editor.html, nessun server, nessun passaggio di build
• Basta aprire LISYclock_config_editor.html nel browser e iniziare
• Supporta il caricamento/scaricamento diretto sull’hardware LISYclock via IP (HTTP) o USB

2. Requisiti & Avvio

Browser

Avvio

1. Aprire LISYclock_config_editor.html dalla directory del progetto localmente nel browser (doppio clic o File → Apri)
2. L’applicazione si avvia immediatamente con una configurazione predefinita vuota

Importante: Per la comunicazione diretta con il LISYclock via IP (scheda “Clock”), il file deve essere aperto tramite file:// – non tramite HTTPS. I browser bloccano le richieste HTTP dalle pagine HTTPS per ragioni di sicurezza. La modalità USB funziona indipendentemente da come il file è stato aperto.

3. Operazioni sui file

I pulsanti nella barra di navigazione (in alto) controllano tutte le operazioni sui file:

Il nome del file corrente viene visualizzato al centro della barra di navigazione. Finché non è aperto alcun file, appare “— nessun file aperto —”.

4. Scheda: Clock

Questa scheda consente la comunicazione diretta con l’hardware LISYclock. Scegliere tra la Modalità IP (WiFi) e la Modalità USB (cavo USB).

Modalità di connessione

Selezionare il tipo di connessione tramite i pulsanti radio in cima alla scheda:

Modalità IP

Inserire l’indirizzo IP del proprio LISYclock (ad es. 192.168.1.42). L’indirizzo viene salvato nel browser e viene precompilato automaticamente alla successiva apertura.

Un clic su Connect Clock verifica la raggiungibilità dell’orologio:

In caso di connessione riuscita vengono visualizzati la versione del firmware e la versione API. Se la versione API non corrisponde alla versione attesa, viene visualizzato un avviso (le funzioni potrebbero comunque essere parzialmente utilizzabili).

Modalità USB

Fare clic su Connect USB per stabilire la connessione. Il punto di stato indica lo stato:

Nota: L’orologio si riavvia una volta quando si fa clic su Connect USB. Questo è normale — il riavvio attiva l’handshake USB. Attendere che lo stato mostri Connected.

Test connessione WiFi (solo modalità USB)

In modalità USB, fare clic su Test WiFi Connection per inviare le credenziali WiFi dalla scheda General all’orologio e verificare la connessione. Il punto di stato mostra il risultato.

Configurazione

Impostazione dell’ora

Un clic su Set Clock Time from PC sincronizza l’ora dell’orologio con la data e l’ora correnti del PC.

Riavvio

Un clic su Reboot Clock riavvia il LISYclock. Una finestra di conferma previene riavvii accidentali.

Caricamento file

Trasferire qualsiasi file (ad es. MP3, batch) sulla scheda SD dell’orologio.

Gestione file sulla scheda SD

• Usare Refresh per caricare l’elenco file corrente dalla scheda SD
  • L’elenco mostra nome, dimensione e data di modifica di ogni file
  • I singoli file possono essere scaricati, rinominati o eliminati

Log di protocollo (solo modalità USB)

In modalità USB, viene mostrato un pannello di log di protocollo con tutte le comunicazioni seriali tra l’editor e l’orologio.

Avviso HTTPS

Se l’editor viene aperto tramite un URL HTTPS, il browser blocca tutte le richieste HTTP verso l’orologio (modalità IP). Soluzione: aprire LISYclock_config_editor.html localmente tramite file://.

5. Scheda: General

Impostazioni generali del LISYclock.

Impostazioni WiFi

Le credenziali WiFi vengono salvate in config.txt. Usare Test WiFi Connection nella scheda Clock (modalità USB) per verificare che le credenziali funzionino.

Luminosità del display

Valore da 0 (scuro) a 7 (luminosità massima). Corrisponde alla chiave di configurazione DISP_BRIGHT.

Server FTP

Fuso orario

Esempio per l’Europa centrale con ora legale:

CET-1CEST,M3.5.0,M10.5.0/3

Stringhe dei giorni della settimana

Se abilitato, l’orologio mostra i nomi localizzati dei giorni della settimana. Ognuno dei 7 campi (domenica–sabato) può avere al massimo 6 caratteri. Le voci più corte vengono automaticamente completate con spazi fino a 6 caratteri.

Esempio (Italiano): Dom, Lun, Mar, Mer, Gio, Ven, Sab

6. Scheda: Events

Gli eventi definiscono le azioni temporizzate del LISYclock.

Tipi di evento

Formato orario

L’orario di un evento viene specificato come HH:MM:W o HH:MM-GG.MM.AAAA. * sta per “qualsiasi” in ogni campo.

Modalità giorno della settimana: HH:MM:W

Modalità data: HH:MM-GG.MM.AAAA

Attiva quando nel campo giorno della settimana è selezionato * (data). Il campo data appare quindi in aggiunta.

Esempi

Controlli

• + Add Event (pulsante in alto a destra): Aggiunge un nuovo evento in fondo alla lista
• ✕ (a destra di un evento): Rimuove quell’evento

7. Scheda: GI LEDs

Definisce i colori iniziali dei LED GI (Illuminazione Generale).

Campi per ogni riga LED

Il selettore colore e i campi RGB sono sincronizzati: una modifica nel selettore aggiorna i campi RGB e viceversa.

Controlli

• + Aggiungi LED: Aggiunge una nuova voce LED in fondo alla lista
• ✕: Rimuove questa voce LED

8. Scheda: Attract Mode

Configura l’illuminazione dell’Attract Mode (luci animate in standby) in 5 gruppi (AT1–AT5).

Ogni gruppo è visualizzato come pannello accordion richiudibile.

Impostazioni per gruppo

• + Aggiungi LED: Aggiunge una nuova voce LED al gruppo
• ✕: Rimuove una voce LED dal gruppo

9. Scheda: TTS Settings

Impostazioni per la funzione Text-to-Speech (utilizza il servizio WIT.ai).

Il token API di WIT.ai si ottiene dopo la registrazione gratuita su wit.ai.

10. Scheda: Update

La scheda Update offre tre modi per aggiornare il firmware del LISYclock.

Carica file firmware locale (solo modalità IP)

1. Selezionare un file .bin del firmware con il pulsante di selezione file
2. Fare clic su Update & Reboot — il file viene trasferito sulla scheda SD come update.bin e l’orologio si riavvia automaticamente per applicare l’aggiornamento

Oppure seleziona da lisy.dev

1. Prima connettersi all’orologio nella scheda Clock (modalità IP) in modo che l’editor conosca la versione hardware
2. Fare clic su Fetch versions — appare un menu a tendina con tutti i file firmware corrispondenti da lisy.dev
3. Selezionare la versione desiderata dal menu a tendina
4. Fare clic su Update & Reboot — il file viene scaricato da lisy.dev e trasferito all’orologio

Se è selezionata una versione dal server, ha la precedenza su un file selezionato localmente.

Flash via USB – installazione completa (solo modalità USB)

Fare clic su Flash via USB per scrivere il pacchetto firmware completo (bootloader, firmware binary, tabella delle partizioni e dati OTA) direttamente sull’ESP32 tramite USB. Nessuna connessione WiFi richiesta.

Solo Chrome/Edge. Durante il flashing viene mostrato un log di avanzamento sotto il pulsante. Non scollegare il cavo USB fino al completamento dell’operazione.

11. Scheda: Debug

La scheda Debug fornisce una console seriale USB grezza per utenti avanzati e sviluppatori.

Connessione

Selezionare il Baud Rate (predefinito: 115200) e il Reset Delay (predefinito: 1500 ms), quindi fare clic su CONNECT. Il punto di stato indica lo stato della connessione:

Gli stati dei segnali DTR/RTS sono mostrati nell’angolo in alto a destra.

Opzioni

Fine riga

Selezionare la terminazione di riga aggiunta ai comandi inviati: NL (\n), CR+NL, CR o None.

Console

La console mostra tutto l’output seriale dell’ESP32 con righe codificate a colori: - Verde: dati ricevuti - Arancione: messaggi di sistema - Rosso: errori - Grigio scuro: messaggi di avvio (quando Boot Logs è abilitato)

12. config.txt – Formato & Struttura

Formato base

KEY=value

• Ogni riga contiene una chiave e un valore, separati da =
• Un # all’inizio di una riga disabilita la riga (senza eliminarla)
• Le maiuscole/minuscole dei nomi delle chiavi sono normalizzate nell’editor

Regole speciali

Estratto di esempio

WIFI_ENABLE=yes
WIFI_SSID="MiaRete"
WIFI_PWD="MiaPassword"
DISP_BRIGHT=5
#FTP_USER=lisy
#FTP_PWD=lisy
# TIMEZONE="CET-1CEST,M3.5.0,M10.5.0/3"
EVENT_SYNC_TIME=2:0:*,10
EVENT_SAY_TIME=14:12:*,"italian"
EVENT_TTS=8:0:*,"Buongiorno!"

13. Suggerimenti & Note

• Usare Chrome o Edge: Solo questi browser supportano la File System Access API per le finestre di dialogo native apri/salva e la Web Serial API per la modalità USB. In Firefox e Safari appaiono invece selettori file standard o link di download; la modalità USB non è disponibile.

• Aprire localmente per l’accesso IP: Se la comunicazione con il LISYclock in modalità IP non funziona, verificare che LISYclock_config_editor.html sia aperto tramite file:// (localmente) e non tramite https://.

• FTP come alternativa: Il config.txt completato può anche essere trasferito sulla scheda SD dell’orologio tramite FTP (se il server FTP è abilitato nella configurazione).

• Chiavi sconosciute: Se l’editor incontra chiavi sconosciute durante il caricamento, le ignora e mostra un banner di avviso con le righe interessate. Non vengono mantenute al salvataggio. Se si hanno estensioni personalizzate nel config.txt, eseguirne prima un backup separato.

• Nessuna funzione annulla: L’editor non dispone di una funzione annulla. In caso di modifiche accidentali, riaprire il file (senza salvare prima) ripristinerà lo stato precedente.

• Connessione USB condivisa: Una connessione USB stabilita nella scheda Clock viene automaticamente condivisa con la scheda Debug e viceversa. Esiste sempre una sola connessione USB simultanea.

Creato per LISYclock Config Editor v1.11