Home » Domotica Fai da te » Sonoff » Sonoff Mini e Basic R3 DIY + Tasmota firmware: guida in italiano

Sonoff Mini e Basic R3 DIY + Tasmota firmware: guida in italiano

Sonoff Tasmota firmware: guida completa in italiano

Grazie ai modelli Sonoff Mini, Basic R3, RF R3 e D1 dotati di modalità DIY, l’aggiornamento al firmare Tasmota e’ diventato alla portata di quasi tutti non dovendo fare modifiche sul dispositivo. Scopri come installare il firmware Tasmota grazie alla mia guida completa in italiano.

Leggi anche i miei articoli su Sonoff Basic R3 e Sonoff Mini.

Firmware Tasmota

Tasmota e’ un firmware open-source per dispositivi smart basati sul chip ESP8266 come i popolari interruttori WiFi Sonoff e gli emergenti Shelly.

Il firmware Tasmota, sostituendo quello originale del dispositivo, può essere utilizzato per le motivazioni seguenti:

  • possibilità di gestione totalmente in locale dei dispositivi mediante interfaccia web senza passare, attraverso il collegamento ad internet, da servizi cloud come eWeLink o Shelly Cloud
  • utilizzo di protocolli standard come HTTP ed MQTT
  • disponibilità di funzionalità aggiuntive
  • facilita’ di integrazione con sistemi open-source per la domotica come openHABHome Assistant e Domoticz
  • supporto ad Alexa

Installare il firmware Tasmota su un dispositivo non e’ un’operazione esattamente alla portata di tutti poiché richiede di:

  • disporre di un convertitore da USB TTL per collegare il vostro PC al dispositivo
  • dei pin header da saldare sulla scheda del dispositivo mediante un saldatore elettrico a stagno
  • dei cavallotti / jumper wire Dupont di collegamento
Sonoff firmware Tasmota

Firmware Tasmota e Sonoff DIY

A partire dall’uscita dei modelli Sonoff Mini, Basic R3 e RF R3 e’ possibile installare il firmware Tasmota senza dover fare alcun intervento hardware. Questa procedura non e’ applicabile ai modelli precedenti non dotati di modalità DIY.

Attualmente i dispositivi Sonoff che supportano la modalità DIY sono i seguenti:

Questa procedura di aggiornamento a Tasmota ha un rischio: non viene effettuato un backup del firmware ITead originale. Quindi non sarete in grado di tornare alla situazione di fabbrica del vostro Sonoff.

Personalmente ho provveduto all’aggiornamento al firmware Tasmota dei miei esemplari di Sonoff Mini e Basic R3.

Sonoff Basic R3 e Mini Tasmota
Sonoff Basic R3 e Sonoff Mini

Come installare il firmware Tasmota su Sonoff Mini, Basic R3, RF R3 e D1 DIY

Per eseguire l’aggiornamento dei nostri Sonoff Mini, Basic R3, RF R3 o D1 col firmware Tasmota la procedura da seguire è parzialmente diversa in base alla versione di firmware Sonoff presente sul dispositivo:

Firmware SonoffModalità DIY / API PROTOCOL
Firmware < 3.1.0Non disponibile
3.1.0 <= Firmware < 3.5.01.4
Firmware >= 3.5.02.1

Nella pratica il set di API implementato a seconda della versione di firmare è diverso: per approfondire le differenze potete leggere Sonoff DIY mode API protocol.

In particolare con la versione DIY 2.1, ovvero firmare Sonoff a partire dalla 3.5.0, la procedura iniziale risulta decisamente più semplice evitando interventi sul dispositivo ed innumerevoli passi iniziali.

Get SONOFF D1 dimmer light switch integrated into your own home automation platform

Tasmota firmware download

Il primo passo comunque è quello di effettuare il download del file corretto contenente il firmware Tasmota. E’ molto importante che scegliate quello corretto, perché in caso di corruzione del dispositivo l’unica strada sarà quella di utilizzare il collegamento fisico dal PC.

La versione di firmare Tasmota da scegliere per il download e’ tasmota-lite.bin come descritto nella pagina di documentazione Tasmota Sonoff DIY:

Tasmota Sonoff DIY
Tasmota Sonoff DIY

Il file binario pre-compilato utilizzato per effettuare il flash iniziale del firmware Tasmota su Sonoff Mini, Basic R3, RF R3 e D1 deve comunque avere una dimensione inferiore alla memoria libera sul dispositivo col firmware originale ITead pari a 508 kB.

Trovate i file binari pre-compilati relativi all’ultima versione del firmware Tasmota pronti pronti per il download in:

Verifica versione firmware device su eWeLink

Verificate ora mediante l’app eWeLink che la versione del firmware Sonoff del dispositivo e nel caso effettuate l’upgrade all’ultima versione disponibile per quello specifico dispositivo.

Ora, a seconda della versione di firmare Sonoff come anticipato, i passi da seguire relativi all’abilitazione della modalità DIY cambiano completamente.

Abilitazione modalità DIY

Dispositivo Sonoff con firmware < 3.5.0 (DIY API 1.4)

Per primo dobbiamo abilitare la modalità DIY sul nostro Sonoff Mini o Basic R3 eseguendo i passi seguenti:

  • aprire l’involucro in plastica del dispositivo
  • identificare sulla scheda i due pin
  • montare il jumper DIY sulla scheda
  • richiudere ed alimentare il dispositivo
  • creare un hotspot WiFi sullo smartphone

Verificate che il vostro smartphone sia collegato ad internet e create un hotspot WiFi a 2,4 GHz con nome rete sonoffDiy e password 20170618sn:

Il dispositivo confermerà il collegamento all’hotspot WiFi creato col vostro smartphone passando ad una sequenza di doppi lampeggi veloci del LED blu.

  • collegare il PC all’hotspot WiFi dello smartphone

Ora collegate anche il vostro PC Windows al medesimo hotspot WiFi creato sul vostro smartphone:

Sonoff Tasmota firmware italiano

Sul vostro smartphone Android dovreste vedere due dispositivi collegati all’hotspot WiFi (il PC Windows ed il Sonoff):

  • identificare l’indirizzo IP del dispositivo mediante una scansione di rete, ad esempio utilizzando un tool come Angry IP Scanner
Sonoff Basic R3 DIY REST API

Dispositivo Sonoff con firmware >= 3.5.0 (DIY API 2.1)

In questo caso non e’ assolutamente richiesto di aprire il dispositivo ed operare sul jumper ma si procede esclusivamente via software:

How to Turn on the DIY Mode for SONOFF Smart Switches
  • premere a lungo il pulsante a bordo del dispositivo per farlo passare in modalità di Accoppiamento Compatibile (AP) attivando un access point WiFi; la conferma viene data da un lampeggio veloce del LED sul device
  • collegare il PC o lo smartphone all’access point WiFi creato dal dispositivo Sonoff (del tipo ITEAD-XXXXXXX con password 12345678)
Pairing Sonoff eWeLink: modalità accoppiamento compatibile (AP)
  • configurare il collegamento WiFi del dispositivo al router di casa accedendo mediante PC o smartphone all’URL dell’interfaccia web http://10.10.7.1/; il dispositivo si riavvia e collegandosi alla rete WiFi appena configurata
  • verificare l’attivazione della modalità DIY e del collegamento del dispositivo al WiFi confermato dal lampeggio doppio con pausa
  • identificare l’indirizzo IP del dispositivo mediante una scansione di rete, ad esempio utilizzando un tool come Angry IP Scanner:
Sonoff Basic R3 DIY REST API

  • installare un’estensione per Chrome o Firefox come RESTer che vi consenta di invocare operazioni REST API sul dispositivo Sonoff direttamente dal vostro browser
Tasmota Sonoff RESTer
RESTer
  • verificare la modalità DIY del dispositivo Sonoff invocando la seguente REST API seguente mediante RESTer:
Method:POST
URLhttp://<IP_del_dispositivo>:8081/zeroconf/info
Body{"data": {}}
Header Content-Typeapplication/json

che dovrà restituirà codice 200 OK e le informazioni sul dispositivo nel JSON di risposta. In caso negativo ripetete la procedura dall’inizio.

  • abilitare l’aggiornamento firmware mediante OTA sul dispositivo Sonoff invocando la REST API seguente mediante RESTer:
Method:POST
URLhttp://<IP_del_dispositivo>:8081/zeroconf/ota_unlock
Body{"data": {}}
Header Content-Typeapplication/json

che dovrà restituirà codice 200 OK. Potete ripetere il passo precedente per verificare se le informazioni sul dispositivo sono cambiate.

Qualche nota:

  • l’invocazione delle REST API Sonoff può essere fatta con lo strumento che preferite, come ad esempio il popolare tool di test Postman o direttamente mediante curl
  • la modalità di Accoppiamento Compatibile (AP) dei dispositivi Sonoff con l’app eWeLink può essere approfondita nel mio articolo su Sonoff pairing
  • la documentazione completa delle REST API si trova nella pagina ufficiale Sonoff DIY mode API protocol

Download e installazione DIY Tool su PC

Ora potete scaricare il software DIY Tool disponibile sul progetto GitHub Sonoff_Devices_DIY_Tools.

Sonoff DIY Tool
Sonoff DIY Tool

A differenza di quanto indicato sulla relativa pagina GitHub, questo tool funziona al momento con tutti i firmware e device che supportano la modalità DIY.

Il programma, eseguito sul vostro PC Windows, si collegherà direttamente al dispositivo a patto che siano collegati entrami al medesimo access point WiFi.

Eseguendolo compariranno subito in elenco i dispositivi collegati (uno in questo caso):

Sonoff DIY Mode Tool
Sonoff DIY Mode Tool

Avete diverse informazioni e funzioni disponibili lavorando in locale:

  • stato del dispositivo, comportamento all’accensione e configurazione della variazione graduale (inching)
  • accensione/spegnimento
  • impostazione dello stato all’accensione
  • impostazione della variazione graduale
  • informazioni generali ed intensità del segnale WiFi
  • modifica credenziali collegamento WiFi
  • aggiornamento del firmware (firmware flash)

Fate qualche prova per verificare che il Sonoff risponda ai comandi dal vostro PC.

Se siete smanettoni potete ottenere i medesimi risultati utilizzando RESTer ed invocando le singole REST API sul vostro dispositivo Sonoff. In questa tabella potete trovare un elenco di quelle disponibili:

Sonoff DIY REST APIFunzione
/zeroconf/switchAccensione o spegnimento dispositivo
/zeroconf/startupImpostazione stato all'accensione dispositivo (acceso/spento/ultimo stato)
/zeroconf/signal_strengthLettura intensità segnale WiFi sul dispositivo (in dBm)
/zeroconf/pulseAttivazione o disattivazione inching (variazione graduale)
Impostazione tempo di ritardo (in msec, solo multipli di 500)
/zeroconf/wifiImpostazione SSID e Password WiFi di collegamento del dispositivo
/zeroconf/ota_unlockAbilitazione aggiornamento firmware OTA
/zeroconf/ota_flashAggiornamento firmware dispositivo
/zeroconf/infoLettura informazioni dispositivo

Possiamo dunque ora comodamente caricare un firmware sul dispositivo dal nostro PC Windows senza dover fare collegamenti fisici !

Flash firmware Tasmota su device Sonoff Mini e Basic R3

Possiamo ora tornare al DIY Tool e cliccare su Firmware flash in alto a destra ottenendo questa finestra:

Selezionate il dispositivo mediante Flash device list ed il file col firmware scaricato in precedenza mediante Import firmware:

Sonoff Tasmota firmware italiano

Siete finalmente pronti a premere OK ed incrociare le dita:

Sonoff Tasmota firmware italiano

Nel caso la procedura di flash del firmware Tasmota rimanga bloccata allo 0%, vuol dire che il device non riesce a collegarsi ai server in cloud. Verificate che il vostro smartphone abbia la connessione internet attiva e che quindi la condivida sull’hotspot WiFi creato in precedenza.

Nel caso sia andato tutto correttamente otterrete questa finestra di conferma:

Sonoff Tasmota firmware italiano

Il vostro Sonoff Mini, Basic R3, RF3 o D1 ora e’ dotato di firmware Tasmota ! La conferma e’ data dalla comparsa di un nuovo hotspot WiFi creato dal vostro dispositivo Sonoff Tasmota:

Sonoff Tasmota firmware italiano

Per concludere l’operazione:

  • potete chiudere disattivare l’hotspot WiFi e chiudere tutte le finestre sul PC
  • spegnete il dispositivo Sonoff Mini o Basic R3 e, nel caso fosse presente, rimuovete il jumper DIY perché potrebbe interferire con funzioni del firmware Tasmota che utilizzano la GPIO16

Nel caso la barra di Progress non si muova dallo 0%, le cause potrebbero essere due:

  • Il vostro smartphone con l’hotspot WiFi non e’ connesso ad internet
  • Il vostro PC per qualche ragione ignota non e’ in grado di far eseguire il comando

Io ho riscontrato il secondo problema che ho risolto semplicemente ripetendo l’operazione da un portatile diverso dal mio.

Un paio di note:

Configurazione Sonoff Mini e Basic R3 post flash firmware a Tasmota

Collegate ora il vostro PC al nuovo hotspot WiFi, senza password, creato dal vostro Sonoff Mini o Basic R3 con firmware Tasmota ed il browser verrà ridiretto automaticamente alla pagina di configurazione dove specificare le credenziali del router WiFi di casa:

Ora e’ necessario cancellare qualsiasi contenuto della memoria flash del vostro Sonoff Mini o Basic R3 con Tasmota, mantenendo la configurazione WiFi, mediante il comando Reset 5 eseguito dalla console:

Sonoff Tasmota firmware italiano

Ora potete procedere effettuando la prima installazione sul vostro Sonoff Mini o Basic R3 della versione di firmware Tasmota che vi interessa, nel mio caso quella in lingua italiana, avendo però l’accortezza di effettuare di download del file binario prima sul PC da https://github.com/arendst/Tasmota/releases o http://ota.tasmota.com/tasmota/:

Tasmota Sonoff DIY

Effettuare il flash mediante l’interfaccia web del firmware Tasmota del Sonoff Mini o Basic R3 specificando il file in Aggiornamento tramite file locale:

Sonoff Tasmota Upgrade
Sonoff Tasmota Upgrade

NON effettuate il primo upgrade mediante OTA: in molti casi il dispositivo diventa irraggiungibile e diventa necessario l’aggiornamento mediante il collegamento via cavo.

Upgrade firmware Tasmota

Negli upgrade del firmware Tasmota successivi all’installazione iniziale, potete anche utilizzare l’aggiornamento via server web (via OTA): consiglio comunque fare download in locale per evitare dipendenze dalla stabilità del collegamento internet durante l’operazione di flash.

In fase di upgrade di Tasmota potrebbe accadervi di affrontare l’errore “Upload buffer miscompare”: questo significa che lo spazio disponibile sul dispositivo e’ inferiore alla dimensione del firmware che state caricando.

Per risolvere questo tipo di problema potete utilizzare la versione ad occupazione minima di memoria tasmota-minimal.bin che non vi farà perdere le impostazioni e permetterà di installare successivamente la versione desiderata.

Come potete vedere i miei Sonoff Mini e Basic R3 sono felicemente aggiornati alla versione Tasmota v9.2.0 (Julie):

Sonoff Tasmota v9.2.0 Julie

Template Tasmota

L’ultima operazione da effettuare è quella di applicare al vostro Sonoff Mini o Basic R3, il template Tasmota più opportuno per associare tra di loro funzioni, componenti e PIN GPIO:

GPIOComponente
Tasmota
Funzione
Sonoff Mini
Funzione
Sonoff Basic R3
0Button1 (17)Pulsante Pulsante
4Switch1 (9)S1/S2
12Relay1 (21)L Out L Out
13LED1 (56)LED di stato LED di stato
Template Tasmota Sonoff MiniTemplate Tasmota Sonoff Basic R3

Per applicare il template Tasmota al vostro Sonoff Mini o Basic R3 e’ sufficiente:

  • copiare la stringa relativa al proprio dispositivo dall’archivio template Tasmota
  • incollare nel campo Modello della pagina di Configurazione Extra, settando il flag Attivare e poi chiudere con Salva

Ultimo aggiornamento Amazon Affiliate 2021-09-20 at 11:48

26 commenti su “Sonoff Mini e Basic R3 DIY + Tasmota firmware: guida in italiano”

  1. Isidoro Fiore

    ciao. ho letto questa guida e finalmente mi sono convinto ad acquistare i mie sonoff mini per la mia casa. Super eccitato ho iniziato la scaletta per flashare i miei device, ma arrivato al punto in cui creo l’hotsopt dal cellulare, mi sono piantato: il sonoff non si collega alla rete creata. ho rifatto i passaggi precedenti e li ho ricontrollati più volte per paura di aver tralasciato qualcosa, ma in realtà ho fatto tutto alla lettera. Quale potrebbe essere il motivo? Spero riesca a darmi una dritta per passare oltre e portare a termine il mio piccolo progetto. Grazie anticipatamente.

  2. Buonasera, ho installato il firmware Tasmota per Sonoff Mini e l’ho installato su un pulsante a muro (non ho i classici interruttori 1/0) collegando S1 e S2.
    Ho inserito il template {“NAME”:”Sonoff Mini”,”GPIO”:[17,0,0,0,9,0,0,0,21,56,0,0,255],”FLAG”:0,”BASE”:1} , ma quando vado a premere il pulsante fisico a muro si accende la luce fino a che non lo rilascio.
    Sembra funzionare come se fosse un interruttore classico e non come un pulsante, ma non capisco come devo configurarlo affinché funzioni correttamente il pulsante. Può aiutarmi?
    Grazie mille

  3. Felice Sidari

    Ciao ho un hub di gestione Domotica della Ilevia che fra gli altri gestisce il gateway MQTT, e sul loro sito ho trovato le istruzioni per configurare gli Shelly. io invece ho dei Sonoff con firmware Tasmota, ma poiché non ne mastico di MQTT sto avendo difficoltà a tradurre i comandi presenti nella guida con le varie istruzioni trovate su internet per questo firmware(specialmente quelli presenti nel campo singolo, immagino che la seconda parte di ogni gruppo,debba essere uguale o quasi essendo linguaggio MQTT). dovrei usare i comandi cmd stat e tele, ma non so come. ho chiamato l’assistenza ma mi hanno solo detto che dovrebbe funzionare se il Sonoff è compatibile con MQTT. qualcuno riesce ad aiutarmi? nel link le istruzioni da inserire nel manager del server. http://support.ilevia.com/all/shelly/mqtt-protocol-shelly1-1pm-eve-automation-software/

    Topic read: è usato per ricevere lo stato del dispositivo
    Topic responce: è la risposta del dispositivo al server di automazione alla richiesta read.
    Topic write: Questo topic è usato per impostare un valore di un parametro del dispositivo
    Topic event: Questo topic è usato per mostrare lo stato del dispositivo nel caso cambi.

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *

Questo sito usa Akismet per ridurre lo spam. Scopri come i tuoi dati vengono elaborati.