Introduzione

RavenCore è un firmware unificato per dispositivi Sonoff e altri, con aggiornamenti OTA e alcune settaggi utente.

Installazione con OTA

1. Scarica otaboot.bin, rboot.bin e blank_config.bin.

2. Collega il tuo dispositivo al tuo adattatore FTDI in flash-mode (di solito tenendo premuto il pulsante del tuo dispositivo mentre lo colleghi).

3. Usa esptool.py per flashare il tuo dispositivo:

Primo, erase flash:

esptool.py -p /dev/your_ESPPort erase_flash

Di solito la tua ESPPorta è qualcosa tipo /dev/tty.USB0000

Poi, imposta il tuo dispositivo in flash-mode di nuovo, e flash il nuovo firmware:

esptool.py -p /dev/your_ESPPort --baud 115200 write_flash -fs 1MB -fm dout -ff 40m \ 0x0 rboot.bin 0x1000 blank_config.bin 0x2000 otaboot.bin

Nota: Se usi una vecchia versione di esptool, devi cambiare -fs 1MB con -fs 8m.

4. Devi configurare la rete wifi e la repository OTA. Per configurare le impostazioni wifi, il disposizitov genera la sua rete Wifi in modalità AP. Devi collegarti a questa rete per impostare la rete wifi. Semplicemente prendi il tuo dispositivo iOS, vai in impostazioni - Wi-Fi, e cerca una rete con LCM- seguito dagli ultimi dati del tuo MAC address, collegati a questa e attendi qualche secondo fino a quando appare una finestra web che mostra tutte le reti wifi che il tuo dispositivo ho trovato. Seleziona la tua rete ed inserisci la password. Non toccare ancora il pulsante Join!!

Ora devi configurare anche la repository OTA. È molto importante che la configuri correttamente, perché in futuro non potrai cambiala (Se sbagli qualcosa, dovrai effettuare nuovamente un erase e ri-flashare il firmware).

•  OTA repository:

RavenSystem/ravencore

•  OTA binary file:

main.bin

5. Per finire la parte iniziale del setup, clicca sul pulsante Join ed attendi circa 7 minuti perché il processo finisca (Durante l’installazione il dispositivo non mostrerà nulla ed i pulsanti non funzioneranno). Al termine il LED si accende per pochi secondi e potrai aggiungere il tuo accessorio ad Homekit usando l’applicazione Casa.

Nota: Se la procedura fallisce, devi cominciare nuovamente il processo partendo dal punto 2.

Installazione senza OTA

Scarica main.bin dalla Binary Releases, rboot.bin e blank_config.bin.

Quindi, continua con il punto 2 di Installazione sostituendo otaboot.bin con main.bin e ignorando la parte di configurazione di OTA.

HomeKit setup

Nel tuo dispositivo iOS, apri l’app Casa e segui la normale procedura per aggiungere un nuovo accessorio.

Codice per il pairing:

021-82-017

Il pairing del dispositivo richiede circa 30 secondi. Non appena il pairing è terminato, il LED si accende per qualche secondo.

Nota: se il pairing fallisce puoi spegnere il tuo dispositivo, riaccenderlo e iniziare nuovamente l’operazione di nuovo (le impostazioni Wifi restano salvate).

Ripristino del dispositivo alle impostazioni di fabbrica

Entro i primi 2 minuti dall’accensione del dispositivo, attendi circa 10 secondi al fine di consentirgli di effettuare correttamente il boot e poi:

Attiva/disattiva rapidamente l’interruttore esterno, 10 volte in 3 secondi.

Tutte le impostazioni configurate vengono rimosse ed il dispositivo si riavvia. Verranno rimosse le impostazioni di Homekit e wifi ed il tuo dispositivo ritornerà in modalità Access Point per riconfigurare il wifi (ora la rete si chiama RavenCore- seguito dagli ultimi valori del MAC address), ma non verranno rimosse le impostazioni della repository OTA.

Riconnessione alla rete Wi-Fi

Se la rete Wi-Fi diventa irraggiungibile, il dispositivo continuerà a cercare automaticamente la rete fino a quando questa non sarà disponibile e sarà in grado di connettersi.

Ritorno alla modalità Wi-Fi AP

In caso di mancanza di alimentazione, al suo ripristino il dispositivo cercherà di collegarsi alla rete wifi impostata. Se dopo 5 minuti la rete è irraggiungibile, il dispositivo entrerà in modalità AP consentendoti di collegarti e riconfigurare le impostazioni wifi.

Impostazioni utente

RavenCore può essere personalizzato usando l’app Eve per HomeKit.

Impostazioni Comuni

Show Setup [di base impostato su: ON]

Il reboot del dispositivo è obbligatorio ad ogni modifica. Se la voce reboot è impostata su ON, un riavvio del dispositivo viene effettuata dopo 5 secondi.

Mostra un accessorio virtuale che ti consente di configurare l’accessorio pincipale.

IMPORTANTE: Si consiglia vivamente di disabilitare questa impostazione al termine della configurazione.

Board Type [di base impostato su: 1]

Riavvio obbligatorio se modificato.

Puoi scegliere tra le seguenti tipologie di schede:

1. Layout della scheda classica Sonoff: usa GPIO14.
2. Nuovo layoit della scheda Sonoff: usa GPIO2 invece di GPIO14. Il Device Type 10 ha le GPIO del relè e pulsante invertite.
3. Layout della scheda Shelly: devi configurare scheda e dispositivo prima di collegare Shelly alla 230VAC.
4. Layout della nuova scheda Sonoff: usa GPIO3/RX al posto della GPIO14.
5. Shelly 2.5.

- GPIO0 e GPIO2 devono essere liberi o alimentati per consentire all’ESP di avviarsi.

Device Type [di base impostato su: 1]

Riavvio obbligatorio se modificato.

Puoi scegliere tra le seguenti tipologie di dispositivi:

1. 1. Interruttore 1 canale
2. 2. Interruttore 2 canali
3. 3. Presa + pulsante
4. 4. Interruttore 4 canali
5. 5. Termostato
6. 6. Interruttore Basic + Sensore temperatura
7. 7. Valvola acqua
8. 8. Porta garage
9. 9. Presa + pulsante + Sensore temperatura
10. 10. ESP01 Interruttore + pulsante
11. 11. Interruttore 3 canali
12. 12. Tapparella
13. 13. Serratura
14. 14. Luci RGB/W
15. 15. Pulsante Stateless
16. 16. Sensori (non ancora disponibile).

Button Filter [di base impostato su: 0]

Riavvio obbligatorio se modificato.

Determina il grado di durezza del filtro interferenze utilizzato per gestire pulsanti, interruttori e sensori reed.

0 è il valore più tenue, con una risposta rapida e 200 è il più duro con una risposta lenta. Valori più alti sono raccomandati quando si usano i sensori invece dei pulsanti (porta del garage e meccanismo di blocco)

Reboot [di base impostato su: OFF]

Se impostato su ON, il riavvio avviene dopo 5 secondi.

Wifi IP Addr

Mostra l’attuale indirizzo IP del dispositivo all’interno della rete locale.

Wifi Reset [di base impostato su: OFF]

Riavvio obbligatorio se modificato.

Impostalo su ON se desideri rimuovere le attuali impostazioni wifi al prossimo riavvio. Il dispositivo entrerà in modalità AP, consentendo di connetterti e riconfigurare le impostazioni wifi.

Firmware Update [di base impostato su: OFF]

Quando è impostato su ON, dopo 5 secondi il dispositivo si riavvia e carica il firmware OTA che cercherà una nuova versione del firmware su GitHub. Se viene trovata una nuova versione, questa verrà scaricata ed installat (questo processo può richiedere qualche minuto). If a new version is found, it will be downloaded and installed (This process can take some minutes). Dopo averlo attivato, chiudi l’app EVE, apri l’app Casa ed attendi che l’accessorio sia nuovamente “disponibile”.

Capita a volta che il dispositivo resti all’interno del processo di aggiornamento OTA (no modalità AP e nessuna risposta). Se premi il pulsante del tuo dispositivo ed il led non si accende, questo è ancora nel processo OTA e l’unica soluzione senza aggiornarlo è quella di aspettare 5 minuti, spegnerlo ed accenderlo ed attendere ancora 5 minuti, Riprova premendo il pulsante fino a quando non si accende il led, indicando che il dispositivo ha caricato il firmware Ravencore anziché il firmware OTA.

Puoi visualizzare il numero della versione del firmware nell’app Casa, nei dettagli del tuo accessorio.

Se hai effettuato la procedura di flash diretta del firmware Ravencore senza OTA, questa opzione non è disponibile.

Install BETA [di base impostato su: OFF]

Consente di installare una versione BETA e testare le nuove funzionalità. Le versioni BETA sono contrassegnate come pre-release.

Log output [di base impostato su: 1]

Riavvio obbligatorio se modificato.

Se stai utilizzando un dispositivo collegato alla 230VAC è consigliato di impostarlo su 0.

Opzioni possibili:

1. 0. OFF
2. 1. UART
3. 2. Non in uso/Riservato

Init State SW[1-4] [di base impostato su: 0]

Questa opzione ti consente di impostare lo stato iniziale di ciascun interruttore:

1. 0. Off
2. 1. On
3. 2. Ultimo stato
4. 3. Opposto dell’ultimo stato

Reverse SW[1-4] [Di base impostato su: OFF]

Configura il relè nello stato opposto di quello mostrato su Homekit.

External Toggle[1-2] [Di base impostato su: 0]

Riavvio obbligatorio se modificato.

Usa un pulsante o interruttore addizionale connesso sulla GPIO14 e GND. Incorpora un filtro software per evitare interferenze AC.

1. 0. Non usato
2. 1. Usa un pulsante on pulsante touch
3. 2. Usa un interruttore

Inching Time[1-4] [di base impostato su: 0]

Configura il tempo di attivazione temporanea dei relè 1-4. Non disponibile per tutti i tipi di dispositivi.

Imposta su 0 per disabilitare.

Dummy Switch [di base impostato su: OFF]

Riavvio obbligatorio se modificato.

Se impostato su On, crea un interruttore Homekit virtuale che non controlla alcun relè e viene visualizzato come accessorio aggiuntivo. Questo risulta utile per la creazione di automazioni complesse.

Importante: il dummy switch ha una funzione diversa quando viene utilizzato con il dispositivo Porta garage o Serratura.

Init State DM ed Inching Time DM possono essere configurati allo stesso modo degli interruttori normali.

1. Interruttore 1 canale

Un singolo interruttore Homekit. Funziona bene con qualsiasi modello Sonoff e Shelly-1 per controllare 1 relè.

2. Interruttore 2 canali

Un doppio interruttore Homekit. Funziona bene con Sonoff Dual, Touch T1 2CH, Shelly 2 e Shelly 2.5.

Nel Sonoff Dual i pin interni BUTTON 0 e BUTTON 1 funzionano e possono essere configurati con l’opzione External Toggle. Il pulsante integrato può attivare il relè 1 con una singola pressione ed il relè 2 con una doppia pressione.

Nel Sonoff Touch T1 2CH, External Toggle 1 e 2 devono essere impostati su 1 per far funzionare i pulsanti tattili integrati.

Nota importante: l'utilizzo di External Toggle 1 = 2 richiede hardware aggiuntivo per evitare l'impostazione su LOW BUTTON 0 (GPIO0) ed entrare in modalità flash (vedi Board type per ottenere una soluzione software).

3. Presa + pulsante

Una singola presa HomeKit combinata con un pulsante Homekit Stateless. Ideale per Sonoff S20, Sonoff S22 e Sonoff S26. Si può utilizzare anche con Sonoff Basic o Sonoff TH.

Stateless HomeKit Button fa parte di un altro accessorio chiamato "Stateless Switch", che dispone di 3 eventi configurabili dall'utente nell'app Home (pressione singola, doppia pressione e pressione prolungata).

Per utilizzare la normale funzione del pulsante per attivare / disattivare la presa, è necessario premere per 3 secondi.

4. Interruttore 4 canali

Crea un accessorio con 4 interruttori HomeKit, per Sonoff 4CH / Sonoff 4CH Pro.

Con Sonoff 4CH Pro, impostare gli interruttori DYP come segue:

• • S6: 1
• • K5: tutti 1
• • K6: tutti 0

5. Termostato

Un termostato HomeKit completamente funzionante, preimpostato con lettura del valore della temperatura ogni 30 secondi. Per Sonoff TH e S22, con sensore di temperatura/umidità.

Se si collega il riscaldamento, selezionare Heat mode, mentre se si collega un dispositivo di raffreddamento, selezionare Cool mode. La modalità automatica non funziona perché sia il Sonoff TH che il Sonoff S22 hanno soltanto 1 relè.

È possibile selezionare la modalità operativa utilizzando una singola pressione del pulsante del Sonoff. Il LED indicherà la modalità selezionata:

• • OFF: 1 lampeggio del LED
• • RISCALDAMENTO: 2 lampeggi del LED
• • RAFFREDDAMENTO: 3 lampeggi del LED

Se il sensore non funziona, il relè si spegne automaticamente ed il LED lampeggia 5 volte.

Type [di base impostato su: 0]

Riavvio obbligatorio se modificato.

1. 0. Rscaldamento/Raffreddamento
2. 1. Riscaldamento
3. 2. Raffreddamento

Init State TH [di base impostato su: 0]

Questa opzione ti consente di impostare lo stato iniziale nello stato di destinazione del termostato:

1. 0. Spento
2. 1. Riscaldamento
3. 2. Raffreddamento
4. 3. Ultimo stato

Sensor Type [di base impostato su: 2]

Riavvio obbligatorio se modificato.

Questa opzione ti consente di selezionare la tipologia di sensore di temperatura ed umidità collegato al tuo dispositivo (GPIO14/GPIO2):

1. 1. DHT11
2. 2. DHT22
3. 3. DS18B20
4. 4. Si7021

TH Period [di base impostato su: 30]

Riavvio obbligatorio se modificato.

Seleziona il valore in secondi dell'intervallo di acquisizione dei valori dal tuo sensore. Da 3 a 60 secondi.

Offset HUM [di base impostato su: 0]

Seleziona un valore di compensazione per calibrare il valore dell'umidità del sensore.

Offset TEMP [di base impostato su: 0]

Seleziona un valore di compensazione per calibrare il valore della temperature del sensore.

Deadband [di base impostato su: 0]

Seleziona una temperatura di deadband tra 0 and 3ºC per regolare il funzionamento del termostato.

6. Interruttore Basic + Sensore temperatura

Crea un interruttore HomeKit, un sensore di temperatura e un sensore di umidità. Per Sonoff TH e Sonoff S22, con sensore di temperatura/umidità.

Sensor Type [di base impostato su: 2]

Riavvio obbligatorio se modificato.

Questa opzione ti consente di selezionare la tipologia di sensore di temperatura ed umidità collegato al tuo dispositivo (GPIO14/GPIO2):

1. 1. DHT11
2. 2. DHT22
3. 3. DS18B20
4. 4. Si7021

TH Period [di base impostato su: 30]

Riavvio obbligatorio se modificato.

Seleziona il valore in secondi dell'intervallo di acquisizione dei valori dal tuo sensore. Da 3 a 60 secondi.

Offset HUM [di base impostato su: 0]

Seleziona un valore di compensazione per calibrare il valore dell'umidità del sensore.

Offset TEMP [di base impostato su: 0]

Seleziona un valore di compensazione per calibrare il valore della temperature del sensore.

7. Valvola Acqua

Usa il tuo dispositivo come una valvola d'acqua o un sistema di irrigazione HomeKit, con un timer incorporato:

Valve Type [di base impostato su: 0]

Riavvio obbligatorio se modificato.

Seleziona la tipologia di icona da mostrare.

1. 0. Valvola Acqua
2. 1. Spruzzatore
3. 2. Doccia
4. 3. Rubinetto

Has Stop [di base impostato su: ON]

Riavvio obbligatorio se modificato.

Abilita il timer interno a fermare in automatico.

8. Porta garage

Converte il tuo dispositivo in un sistema Homekit per l'apertura della porta del garage.

Devi utilizzare un Sonoff SV con relè isolato. Puoi altresì utilizzare altri modelli Sonoff, come il Basic oppure il TH con il relè isolato (è necessario tagliare la pista), con soltanto un sensore collegato alla GPIO14 per verificare lo stato di chiusura della porta.

Connessioni:

• • GPIO14 - Sensore chiusura porta
• • GPIO4 - Sensore apertura porta (Opzionale, ma consigliato).
• • GPIO5 - Sensore di ostruzione porta (Optzionale. Quando una ostruzione è rilevata, il relè viene disabilitato).
• • Relè (isolato) - Pulsante per azionare il meccanismo della porta.

L'installazione di almeno il sensore di chiusura è importante affinchè homkeit possa conoscere lo stato in cui si trova la porta, quando ad esempio si utilizza un telecomando RF oppure un pulsante esterno. Inoltre, per questioni di sicurezza, si possono ricevere notifiche quando ad esempio la porta del garage viene aperta.

Quando viene attivato il sensore di ostruzione, il sistema HomeKit viene avvisato e il relè viene disabilitato per evitare possibili danni fino a quando l'ostruzione non viene rimossa.

Se il Dummy Switch è abilitato, è usato come sicura della Porta Garage

Has Opened Sensor [Di base impostato su: 0]

Riavvio obbligatorio se modificato.

Se un sensore è collegato alla GPIO14 indica lo stato della porta quando è completamente aperta..

Tipo Sensore:

1. 0. Non usato
2. 1. NO: Normalmente aperto
3. 2. NC: Normalmente chiuso

Has Stop [di base impostato su: ON]

Se vuoi impostare lo stop dell'apertura durante il movimento con la pressione del pulsante, devi impostarlo su ON.

Sensor Close NC [di base impostato su: OFF]

Riavvio obbligatorio se modificato.

Se il sensore sulla GPIO14 è NO (Normalmente aperto), imposta su OFF.

Se il sensore sulla GPIO14 è NC (Normalmente chiuso), imposta su ON.

With Button-Control [di base impostato su: OFF]

Per impostazione predefinita, il pulsante Sonoff incorporato (GPIO0) funziona solo per eseguire un ripristino di fabbrica (tenendolo premuto per 10 secondi); ma se si desidera usarlo per controllare la porta del garage, impostare su ON. Per motivi di sicurezza si consiglia di tenerlo spento, evitando qualsiasi tipo di interferenza oppure aperture indesiderate.

Working Time [di base impostato su: 20]

Se non viene utilizzato un sensore di apertura è necessario impostare il tempo impiegato dalla porta del garage per completare tale operazione. È obbligatorio impostare Has Opened Sensor su OFF. Il tempo è espresso in secondi.

9. Presa + Pulsante + Sensore temperatura

Per Sonoff S22 con sensore di temperatura ed umidità.

Stateless HomeKit Button fa parte di un altro accessorio chiamato "Stateless Switch", che dispone di 3 eventi configurabili dall'utente nell'app Home (pressione singola, doppia pressione e pressione prolungata).

Per utilizzare la normale funzione del pulsante per attivare / disattivare la presa, è necessario premere per 3 secondi.

Sensor Type [di base impostato su: 2]

Questa opzione ti consente di selezionare la tipologia di sensore di temperatura ed umidità collegato al tuo dispositivo (GPIO14/GPIO2):

1. 1. DHT11
2. 2. DHT22
3. 3. DS18B20
4. 4. Si7021

TH Period [di base impostato su: 30]

Riavvio obbligatorio se modificato.

Seleziona il valore in secondi dell'intervallo di acquisizione dei valori dal tuo sensore. Da 3 a 60 secondi.

Offset HUM [di base impostato su: 0]

Seleziona un valore di compensazione per calibrare il valore dell'umidità del sensore.

Offset TEMP [di base impostato su: 0]

Seleziona un valore di compensazione per calibrare il valore della temperature del sensore.

10. ESP01 Interruttore + pulsante

Per ESP01 con un pulsante connesso alla GPIO0 ed un relè connesso alla GPIO2.

Il pulsante Stateless HomeKit fa parte di un altro accessorio chiamato "Stateless Switch", che dispone di 3 eventi configurabili dall'utente nell'app Home (pressione singola, doppia pressione e pressione prolungata).

Per utilizzare la normale funzione del pulsante per attivare / disattivare la presa, è necessario premere per 3 secondi.

11. Switch 3ch

Per Sonoff Touch T1 3ch.

12. Tapparella

Un driver completamente autonomo per la gestione di finestre, porte e tapparelle

Per Sonoff Dual, Touch T1 2CH, Shelly 2 e Shelly 2.5.

Richiede l'uso di un motore con finecorsa automatici.

Con External Toggle 1, puoi configurare il modo in cui funzioneranno entrambi i pulsanti/interruttori esterni. Ricordati che per Sonoff Touch, è necessario impostare su 1 per far funzionare i pulsanti tattili incorporati

Cover Type [di base impostato su: 0]

Riavvio obbligatorio se modificato.

1. 0. Taparella
2. 1. Finestra
3. 2. Porta

Time Open [di base impostato su: 30]

Riavvio obbligatorio se modificato.

Tempo necessario per completare l'operazione di totale apertura.

Time Close [Di base impostato su: 30]

Riavvio obbligatorio se modificato.

Tempo necessario per completare l'operazione di totale chiusura.

Boost [Di base impostato su: 0]

Modifica da effettuare soltanto quando la tapparella è totalmente chiusa.

Per impostazione predefinita, la posizione viene calcolata come lineare. Con questa opzione, è possibile modificare la curva della percentuale per calcolare la posizione reale della tapparella quando il meccanismo la fa muovere.

13. Serratura

Un accessorio che attiva un relè a tempo per l'apertura di una serratura. Studiato per l'utilizzo in un Sonoff SV, ma compatibile con qualsiasi modello Sonoff ad un relè o Shelly 1.

Se il Dummy Switch è abilitato, viene utilizzato per proteggere il meccanismo di blocco.

Has Opened Sensor [Di base impostato su: 0]

Riavvio obbligatorio se modificato.

Se un sensore è collegato alla GPIO4 indica lo stato della porta quando è completamente aperta.

Tipo Sensore:

1. 0. Non usato
2. 1. NO: Normalmente aperto
3. 2. NC: Normalmente chiuso

14. Luci RGB/W

Dispositivo per gestire una lampadina a colori PWM o una strisce led (es. Magic Home)

Pins R, G, B, W

Riavvio obbligatorio se modificato.

Imposta le porte GPIO usate dai pin RGBW. Se il pin W (bianco) non è usato, imposta su 0.

Non possono essere utilizzate le GPIO 6,7 e 8.

Pin Shelly RGBW2:

1. R: 15
2. G: 12
3. B: 14
4. W: 4 (opzionale: imposta su 0 se la tua striscia non ha il bianco)

Boost [di base impostato su: 0]

Aumenta l'intensità dei colori.

Imposta il livello di aumento del colore da 0 a 100%.

15. Pulsante Stateless

Il pulsante Stateless HomeKit è un accessorio che dispone di 3 eventi configurabili dall'utente nell'app Home (pressione singola, doppia pressione e pressione prolungata). Il pulsante deve essere collegato alla GND ed alla GPIO selezionata (Pin W)

Pin W

Riavvio obbligatorio se modificato.

Seleziona la GPIO utilizzata dal pulsante.

Non possono essere utilizzate le GPIO 6,7 e 8.

tradotto in italiano dalla guida originale pubblicata da José A. Jiménez su GitHub.