EhiPi · Manuale Utente · 2025

EhiQlock

Il tempo, detto a parole.

Orologio a parole fatto a mano, costruito attorno a un micro ESP: niente cifre, solo frasi di luce in italiano. Sincronizzazione NTP, rilevamento presenza e interfaccia web.

SONOÈLEHORE
LUNAQUATTRO
TREOTTONOVE
CINQUEDIECI
MEZZOGIORNO
MEZZANOTTEP
SEIDUESETTE
UNDICIEMENO
EIUNLQUARTO
VENTICINQUE
DIECIEMEZZO
····
Display word clock Il display LED illumina le parole per comporre l'orario in italiano — come "SONO · LE · TRE · E · UN · QUARTO". La griglia 11x11 comprende 121 LED per le parole, più 4 LED nella dodicesima riga centrale che indicano i minuti aggiuntivi.

Cos'è EhiQlock

EhiQlock è un orologio a LED che mostra l'ora in italiano attraverso parole illuminate su una griglia 11×11. Non ci sono lancette né cifre digitali: sono le parole stesse a comporre frasi come "SONO LE TRE E VENTICINQUE".

⏱ Sincronizzazione NTP automatica 👁 Rilevamento presenza radar 💡 Luminosità adattiva 🌐 Interfaccia web integrata 🎛 4 pulsanti fisici 📡 Wi-Fi 2.4 GHz

L'orologio si connette alla tua rete Wi-Fi e sincronizza l'ora automaticamente ogni 24 ore. Può spegnersi da solo quando non c'è nessuno nella stanza, e regolare la luminosità in base alla luce ambientale.

Prima accensione e configurazione Wi-Fi

Al primo avvio, EhiQlock crea una propria rete Wi-Fi per permetterti di configurarlo. Segui questi passaggi:

1
Connettiti alla rete dell'orologio

Cerca una rete Wi-Fi chiamata EhiQlock-XXXX (dove XXXX è un codice univoco del tuo dispositivo). Connettiti con il tuo smartphone o computer.

2
Apri il captive portal

In molti casi si apre automaticamente una pagina di configurazione. Se non si apre, vai su http://192.168.4.1 nel browser.

3
Inserisci le credenziali Wi-Fi

Seleziona la tua rete domestica dall'elenco, inserisci la password e clicca su Salva. L'orologio si riavvia automaticamente.

4
Attendi la connessione

Una volta connesso, l'ora viene sincronizzata via NTP e il display mostra l'orario corrente.

5
Accedi all'interfaccia web

Dal browser della tua rete domestica, vai su http://ehiqlock-XXXX.local. Oppure scansiona il QR code presente sul retro del dispositivo per aprirla direttamente.

ℹ️  EhiQlock supporta solo reti Wi-Fi 2.4 GHz. Se il router usa la banda 5 GHz, assicurati che la banda 2.4 sia attiva.

Funzioni dei pulsanti

EhiQlock ha 4 pulsanti fisici, ciascuno con un colore identificativo. Ogni pulsante supporta tre tipi di pressione:

Tipo Come si fa
Breve Premi e rilascia rapidamente
Lunga Tieni premuto finché non si attiva (~1 secondo)
Prolungata Dopo la pressione lunga, continua a tenere premuto

Pulsante 1 — Blu

Breve Cambia colore del display (cicla tra i colori disponibili)
Lunga Accende/Spegne il display
Prolungata Reset di fabbrica - Cancella configurazione e credenziali Wi-Fi

Pulsante 2 — Giallo

Breve Diminuisce la luminosità di un livello
Lunga Attiva/Disattiva il rilevamento presenza
Prolungata Avvia il test dei LED, poi riavvia il dispositivo

Pulsante 3 — Bianco

Breve Aumenta la luminosità di un livello
Lunga Attiva/Disattiva la luminosità adattiva
Prolungata Cambia il livello di log (OFF → INFO → DEBUG → OFF)

Pulsante 4 — Verde

Breve Imposta la luminosità al valore centrale (livello 5)
Lunga Attiva/Disattiva Sleep Time
Prolungata Sincronizzazione manuale dell'ora via NTP
⚠️ Attenzione — Reset di fabbrica
Il reset di fabbrica (pulsante 1, pressione prolungata) è irreversibile. Cancella tutte le configurazioni salvate, incluse le credenziali Wi-Fi. L'orologio si riavvierà in modalità pairing.
ℹ️  Rilevamento presenza — Versione Plex: disponibile su tutti i modelli dotati di sensore radar. L'opzione è accessibile dall'interfaccia web e tramite pulsante, se disponibile. Il display si spegne automaticamente dopo 10 minuti senza movimento.
ℹ️  Rilevamento presenza — Versione Metal: questa versione non è dotata di sensore radar. L'opzione Check Presence non è disponibile né nell'interfaccia web né tramite pulsante.
ℹ️  Luminosità adattiva: regola automaticamente il display in base alla luce ambientale rilevata dal sensore fotoresistivo integrato.
ℹ️  Sincronizzazione NTP: la pressione prolungata del pulsante 4 forza una sincronizzazione immediata. Richiede connessione Wi-Fi attiva; in assenza di rete, l'orario viene mantenuto dal modulo RTC interno.

Dashboard e controllo remoto

EhiQlock include un webserver integrato accessibile da qualsiasi browser nella stessa rete Wi-Fi. Da qui puoi monitorare e configurare tutto senza toccare l'orologio.

Accesso al pannello di controllo

Connettiti alla stessa rete Wi-Fi dell'orologio e apri il browser all'indirizzo:

http://ehiqlock-XXXX.local

Sostituisci XXXX con il codice del tuo dispositivo. Se non ricordi il codice, scansiona il QR code presente sul retro del dispositivo per aprire direttamente l'interfaccia.

Cosa puoi fare dall'interfaccia web

  • Monitorare stato in tempo reale (ora, temperatura, luce ambientale, presenza)
  • Cambiare colore e luminosità dei LED
  • Abilitare o disabilitare rilevamento presenza e luminosità adattiva
  • Visualizzare statistiche: ultimo sync NTP, uptime, memoria libera
  • Configurare Sleep Time, timezone e altre modalità avanzate
  • Controllare e installare aggiornamenti firmware OTA

Struttura dell'interfaccia

L'interfaccia è organizzata in tre tab, visibili solo quando il dispositivo è connesso alla rete Wi-Fi:

Tab Contenuto
WiFi Rete connessa, indirizzo IP, forza del segnale. Pulsante per disconnettersi e cambiare rete.
Parametri Tutte le impostazioni del dispositivo: luminosità, colore, display, rilevamento presenza, luminosità adattiva, livello log, timezone, sleep time.
Sistema Stato in tempo reale (LED, radar, orologio, sensori), informazioni di sistema (MAC, firmware, heap), aggiornamento firmware OTA, riavvio.

Impostazioni e funzionalità avanzate

Impostazioni principali

Impostazione Valori Descrizione
Colore LED Palette ID 1-N Seleziona il colore del display tra quelli disponibili
Luminosità 1 (min) - 9 (max) Livello manuale di luminosità dei LED
Display ON/OFF On/Off Abilita o disabilita la visualizzazione dell'ora
Rilevamento presenza On/Off Il radar spegne il display dopo 10 min senza movimento. Solo Versione Plex — non disponibile sulla Versione Metal (priva di sensore radar).
Luminosità adattiva On/Off Il sensore di luce ambientale regola automaticamente la luminosità
Sleep Time On/Off + ora inizio/fine Spegne il display in una fascia oraria programmata (es. 22:00–08:00)
Timezone 5 opzioni Fuso orario: Roma/Berlino/Madrid · Londra · Atene/Bucarest · New York · UTC
Canale OTA Stable / Beta Canale di aggiornamento firmware: Stable per versioni consolidate, Beta per le ultime novità
Aggiornamenti automatici On/Off Il dispositivo controlla e installa automaticamente nuove versioni ogni 24 ore
Livello Log OFF/INFO/DEBUG Per diagnostica avanzata via seriale USB

Sincronizzazione oraria

L'orologio si sincronizza automaticamente ogni 24 ore con i server NTP. Se la sincronizzazione fallisce, riprova ogni 5 minuti fino al successo. L'ora viene memorizzata nel modulo RTC interno (DS3231) e persiste anche in caso di riavvio o mancanza di connessione.

ℹ️  Per forzare una sincronizzazione immediata, usa la pressione prolungata del pulsante 4 (Verde), oppure il pulsante dedicato nell'interfaccia web.

Fuso orario

Il fuso orario è configurabile direttamente dall'interfaccia web nel tab Parametri, senza bisogno di modificare il firmware. Il dispositivo applica la modifica immediatamente e forza una risincronizzazione NTP. Le opzioni disponibili sono:

Aggiornamenti firmware

Il dispositivo supporta aggiornamenti Over-The-Air (OTA) accessibili dal tab Sistema dell'interfaccia web. Sono disponibili tre modalità:

Modalità Come funziona
Controlla aggiornamenti Verifica manualmente la disponibilità di una nuova versione sul canale selezionato (Stable o Beta). Se disponibile, chiede conferma prima di installare.
Aggiornamenti automatici Quando abilitato, il dispositivo controlla e installa automaticamente le nuove versioni ogni 24 ore.
Upload manuale .bin Permette di caricare direttamente un file firmware .bin compilato, utile per versioni non ancora rilasciate o per test.
ℹ️  Scegli il canale Beta solo se vuoi accedere alle funzionalità più recenti in sviluppo. Il canale Stable è consigliato per l'uso quotidiano.

Risoluzione problemi

📡
L'orologio non si connette al Wi-Fi I LED continuano a lampeggiare in modalità pairing
  1. Verifica che la password Wi-Fi sia corretta
  2. Assicurati che il router usi la banda 2.4 GHz (il 5 GHz non è supportato)
  3. Avvicina l'orologio al router durante la configurazione
  4. Esegui un factory reset (pulsante 1, pressione prolungata) e ripeti la procedura
🕐
L'ora visualizzata è sbagliata L'orario non corrisponde a quello reale
  1. Forza una sincronizzazione: pressione prolungata sul pulsante 4 (Verde)
  2. Verifica che l'orologio sia connesso a Internet dall'interfaccia web
  3. Controlla la data dell'ultimo sync NTP nell'interfaccia web
💡
Il display è troppo luminoso o troppo scuro Difficoltà di lettura in diverse condizioni di luce
  1. Regola manualmente con i pulsanti 2 (Giallo, diminuisce) e 3 (Bianco, aumenta)
  2. Attiva la luminosità adattiva: pressione lunga pulsante 3 (Bianco)
  3. Se l'adattiva non funziona bene: il sensore potrebbe essere coperto o sporco
👁
Il rilevamento presenza non funziona Il display rimane sempre acceso o sempre spento
  1. Verifica che il rilevamento presenza sia abilitato: pressione lunga pulsante 2 (Giallo)
  2. Controlla lo stato del radar nell'interfaccia web
  3. Il timeout è di 10 minuti: dopo 10 min senza movimento, il display si spegne
  4. Il sensore deve aver rilevato almeno una presenza dall'ultimo avvio per attivarsi
Il display non si accende Nessun LED acceso
  1. Verifica che il display non sia spento manualmente: pressione lunga pulsante 1 (Blu)
  2. Se il rilevamento presenza è attivo e non c'è movimento, il display è spento intenzionalmente
  3. Controlla alimentazione e collegamento USB

Factory Reset — procedura completa

⚠️ Operazione irreversibile
Il reset cancella tutte le configurazioni: Wi-Fi, colore, luminosità, e ogni altra impostazione. L'orologio torna come nuovo.
1

Tieni premuto il pulsante 1 (Blu) per circa 10 secondi (pressione prolungata)

2

I LED lampeggeranno e l'orologio si riavvierà automaticamente

3

L'orologio torna in modalità pairing — riappare la rete EhiQlock-XXXX

4

Ripeti la procedura di configurazione Wi-Fi dalla sezione "Prima accensione"

Specifiche tecniche

Microcontrollore
ESP8266 (Wemos D1 Mini)
Display
Matrice 11x11 + 4 LED per i minuti nella dodicesima riga (125 LED totali)
RTC
DS3231 con compensazione temperatura
Sensore luce
Fotoresistore analogico
Radar presenza
Sensore a microonde
Connettività
Wi-Fi 2.4 GHz (802.11 b/g/n)
Alimentazione
5V USB
Consumo
~5W (dipende dalla luminosità)

Supporto

Per segnalazioni di bug, richieste di funzionalità o supporto:

✉️  andrea.pepini@outlook.com