Xiaomi Gateway v3: Apertura Telnet e integrazione in Home Assistant
Con la seguente guida, vogliamo spiegare come aggiungiere il Gateway Xiaomi V3 ad Home Assistant.
Tutta la parte riguardante l’integrazione di questo Gateway è descritta nel wiki del del componente, ma come sempre succede sorgono dei dubbi a riguardo.
Cercherò di mettere insieme alcune informazioni di base su questo processo.
Va sottolineato che nessuna delle seguenti azioni sarebbe stata possibile senza gli appassionati che hanno trovato un modo per attivare il telnet nel gateway, hanno sviluppato un componente per Home Assistant, creato un firmware personalizzato e scritto lo script per installarli.
Attenzione!
Al momento è possibile abilitare il telnet, e di conseguenza aggiungere il gateway ad Home Assistant, su qualsiasi versione firmware con la metodologia software, senza eseguire assolutamente saldature o altre modifiche hardware.
Dati tecnici:
Xiaomi Gateway 3 (lumi.gateway.mgl03) supporta ZigBee 3, BLE, BT Mesh, WiFi e HomeKit.
L’hardware principale del gateway è rappresentato dai seguenti chip:
CPU + WiFi RTL8197FS
Flash NAND 128 Mb
EFR32MG ZigBee 3
MHCB03P Bluetooth 5
Dispone di 2 antenne in velcro per WiFi ,antenne per Bluetooth e ZigBee.
Esistono 2 versioni gateway: ZNDMWG0 3 LM (per il mercato Cinese) e ZNDMWG0 2 LM (per quello Europeo).
L’unica differenza tra loro è la spina di connessione alla rete elettrica
Il supporto ad Home Assistant è fornito da un componente installabile da HACS XiaomiGateway3 personalizzato il quale dipende dalla versione del firmware del vostro dispositivo.
Firmware
Elenco di firmware attualmente conosciuti (la versione può essere rilevata dopo aver aggiunto il gateway a alll’app proprietaria Mi Home).
Con la seguente lista si conferma che il gateway puoi essere integrato senza nessun tipo di modifica:
v1.4.7_0063, v1.4.7_0065, v1.4.7_0115, v1.4.7_0160, v1.5.0_0026, v1.5.1_0032.
Importante!
Fino ad oggi , solo due versioni di firmware potevano essere considerate per l’integrazione:
Ver.1.4.6_0012 (ufficiale o personalizzata) .
Ad oggi l’autore dell’integrazione consiglia di usare una versione minima v1.4.7_0063 poiché tutto lo sviluppo è stato effettuato per questo.
Ver. v1.5.1_0032 (versione MOD) – L’ultima disponibile, per chi ama aggiornare alll’ultima versione.
In generale ora il componente funziona con tutte le versioni firmware sbloccando il telnet.
Integrazione
Grazie all’autore dell’integrazione AlexxIt, l’aggiunta del gateway è un processo molto più semplice. Tutto si riduce all’installazione del componente (manualmente nella cartella custom_components o tramite HACS ) e al riavvio di Home Assistant.
Dopodiché da impostazioni , integrazioni è necessario aggiungere due istanze ” Xiaomi Gateway 3 “, la prima per l’account Mi Cloud (“Aggiungi account Mi Cloud”).
Necessario per riuscire ad entrare in possesso del token dispositivo.
La seconda integrazione è per integrare direttamente il gateway.
Va digitato successivamente IP del Gateway e il token recuperato precedentemente.
Se il firmware nel vostro gateway e’ incluso tra questi :
1.4.4_0003
1.4.5_0012
1.4.5_0016
1.4.6_0012 – consigliato da AlexxIT
1.4.6_0030
Non è necessario inserire nessuna stringa personalizzata, basta lasciare i valori di default.
In caso contrario nella parte riguardante “Open Telent command” va inserita la seguenta stringa:
|
1 |
{"method":"set_ip_info","params":{"ssid":"\"\"","pswd":"123123 ; passwd -d admin ; echo enable > /sys/class/tty/tty/enable; telnetd"}} |
Stringa necessaria per riuscire ad aprire la porta telnet.
Quando si inserisce la seconda integrazione (gateway), è importante specificare correttamente il comando che aprirà il telnet su di essa, senza questa il gateway in Home Assistant non funzionerà.
Potrebbe succedere che l’integrazione non importi subito i vostri sensori accoppiati precedentemente nell’App. Mi Home
Niente paura, riavviatre il Gateway e Home Assistant…
Dopo aver aggiunto correttamente il gateway, non dimenticate di bloccare l’aggiornamento del firmware tramite App. Mi Home.
C’è sempre la possibilità che il gateway venga aggiornato a una nuova versione non più supportata. In alternativa e’ possbile bloccare gli aggiornamenti tramite Home Assistant in impostazione , dispositivi selezionando il gateway.
Approfondimenti
Oltre al firmware ufficiale installato “di fabbrica” , tramite app. Mi Home, gli appassionati hanno raccolto una serie di custom firmware. Contengono modifiche come telnet abilitato di default, una patch BT che consente di lavorare senza Internet, una patch HomeKit che consente di eseguire il downgrade del firmware, ecc. ecc.
L’elenco completo delle modifiche può essere trovato qui :
Firmware 1.51_0032_ mod20211108 e Firmware 1.5.1_0032 custom202111108 .
Il modo più semplice per installare una versione customizzata del firmware è descritto qui.
Ringraziamenti:
AlexxIT (autore del componente per Home Assistant)
Serrj_sv (ha trovato un modo per accedere via telnet)
icoderus (autore di script per il gateway via Linux )
@avbor (autore di alcune foto dell’articolo)
Per qualsiasi domanda o dubbio, vi ricordiamo le nostri fonti di supporto Telegram Facebook Forum .
 Sostienici, dona un caffè al nostro sito |
32 risposte
Apprezzo il tentativo ma una guida scritta così per me è inutilizzabile e frustrante, fare i riferimenti ad un sito esterno per citare la fonte è una cosa ottima ma non deve essere motivo di lasciare un articolo monco. Se devo stare ad aprire diecimila link per capire o avere pezzi di informazione preferisco andare direttamente su un’altra guida scritta per intero e completa che mi guida passo passo, soprattutto se sono un principiante.
Mi spiace che la guida non sia chiara e di suo gradimento/aiuto.
L’unica cosa che si deve fare per integrare lo Xiaomi V3 con firmware bloccato (c’è la listq) è inserire il codice :
“{“method”:”set_ip_info”,”params”:{“ssid”:”\”\””,”pswd”:”123123 ; passwd -d admin ; echo enable > /sys/class/tty/tty/enable; telnetd”}}” quando si procede all’integrazione.
I link servono solo esclusivamente per informazione, nel caso un utente “evoluto” volesse approfondire lo studio che è stato fatto per trovare lo sblocco della porta telnet che comnuica con Home Assistant.
In ogni caso se risulta difficile seguire la guida, e’ possibile integrare il Gateway con Homekit.
Ciao, io l’ho trovata ottima proprio perchè chiariva meglio gli aspetti legati ai modelli e ai fimware. Io suggerisco di aggiungere almeno un riferimento all’ottima modalità di debugging/troubleshooting offerta dallo strumento che è molto utile ma un po’ nascosta nell’articolo originale: https://github.com/AlexxIT/XiaomiGateway3#zigbee-and-ble-performance-table
Ti ringrazio,
sono d’accordo, la modalità che indichi è molto utile, ma paraliamo sempre di una modalità per un utente avanzato, visto che bisogna capirne l’utilità.
Nell’integrazione sono presenti molte altre funzioni che credo siano molto interessanti, ma che comunuqe consiglierei a un utente che abbia dimestichezza con Home Assistant.
Tipo :
https://github.com/AlexxIT/XiaomiGateway3#advanced-config
Guida ottima. Finalmente sono riuscito ad integrare il gateway V3 di xiaomi in modo completo. Precedentemente usavo l’integrazione homekit, che non vedeva i dispositivi bluetooth e limitava i dispositivi zigbee. Perfetto
Davvero ottima guida e molto chiara, inoltre funzionante al 100%…. il mio v3 hanripreso vita
Grazie
ho appena concluso l’inserimento del gateway. avendo però tutti i dispositivi sul server italia come posso fare per vederli? grazie
Se hai fatto l’integrazione correttamente come da guida e la porta telnet si è aperta, vengono importati tutti i device abbinati al Gateway indipendentemente dal server.
Una cosa non mi è chiara, se il mio gateway ha il firmware Ver. 1.4.7_0115 posso usare l’integrazione solo se ho un custom firmware, vero?
Il link per installare la versione mod del firmware non funziona, si potrebbe ripristinare?
Grazie
Visto il firmware che hai indicato il tuo non è il device corretto per questa guida. 😉
I link per i custom firmware danno errore 404. Cos’è possibile trovare una guida su come installare queste mod
Buongiorno,
link aggiornati.
Potrebbe aiutarti anche questa guida per il flash del firmware che decidi di installare:
“https://hassiohelp.eu/2021/05/14/xiaomi-gateway-v3-integriamolo-con-zigbee2mqtt-e-rendiamolo-indipendente-dal-cloud-xiaomi/”
Saluti
sapete dirmi se con questo tipo di modifica riuscirei comunque ad utilizzare i device mosquito repellent v2 (2021) WX10ZM, che al posto del bluetooth standard utilizzano la versione BLE MESH?
Devi controllare se quel tipo di device è supportato dal Gateway V3, in quanto non posseggo il Mosquitto Repellent per confermarti il funzionamento.
Il reparto Ble continua ad essere gestito tramite Mi Home App.
leggendo negli issue del repository github di alexxit sembra che sia possibile farlo…manca solo l’integrazione per avere le info sui consumabili….
E’ possibile disabilitare il segnale zigbee del Xiaomi Gateway v3?
Buongiorno,
non è possibile disabilitare il segnale Zigbee
buonasera a tutti, che voi sappiate il supporto ai firmware più recenti arriverà? io ho dovuto reinstallare tutto e nel frattempo il gateway aveva accesso l’autoaggiornamento (mannaggia a me) e ora sono alla 1.5.0_0102…
Non dovrestsi aver nessun problema …
Prova a collegarti via telnet e a flashare un firmware MOD… che ad ora è alla versione 1.5.1_0032.
Contattami via telegram che in caso ti spiego come flasharlo.
https://t.me/Alesoft73
Buon giorno a tutti, ottima guida.
Il mio problema è che dopo l’ aggiornamento e l’integrazione in HA , tutto ok, non vedo più i dispositivi accoppiati sia in HA che nell’ app.
Inoltre se tento di ri-accoppiarli o aggiungerne di nuovi il gateway mi va in accoppiamento per i consueti 60 secondi ma non recepisce nessun dispositivo che metto in accoppiamento.
Ho già fatto hard reset (10 volte tasto ) ma una volta riacquisto il gateway sull’app da lo stesso problema non acquisisce.
Devo buttare il gateway che per qualche motivo si è guastato durante l’aggiornamento?
Grazie per il vostro aiuto.
Buongiorno.
Hai inserito ultima versine del firmware ??
Perche’ con le piu’ vecchie versioni del firmware non funziona l’integrazione.
Non si butta mai nulla 🙂
Saluti
Buonasera, volevo sapere un’informazione, se io integro il gateway in home assistant, è possibile poi che il mio echo di alexa finalmente lo veda assieme ai sensori temperatura e Umidità sempre della xiaomi. Perché fin’ora non è possibile. Alexa non vede il gateway e i dati dei sensori. Grazie in anticipo
Buongiorno.
Potrai creare uno script con Home Asssitant da richiamare con una routine da Alexa per fargli dire la temperetua umidità ecc ecc…
Saluti
Buongiorno, scusate la mia ignoranza, ma non riesco proprio a fare nulla. Voglio integrare il gateway e i sensori temperatura e Umidità per poterli visionare su alexa. Ho visto che inserendo il tutto su home assistant posso poi creare uno script su alexa per poterli visionare.
Ma come si fa il tutto? Dove si scarica ghome assistant, come si fanno queste procedure elencate? (inserire gateway, tenente ecc) per favore spiegatemi e ditemi come scaricare il tutto.
Buongiorno.
Prima di tutto devi integrare il Gateway Xiaomi come da guida.
Poi devi creare gli script e relative routine le quali richiamano gli script ..ecc.. ecc..
Spiegarti come fare per fare uno script non è semplice, devi prendere confidenza con home assistant prima .
Ti consiglio di leggerti un po’ di doc on line inziando da questo :
https://www.home-assistant.io/integrations/script/
poi dovresti studiarti anche i template e i vari notify per alexa e google.
https://www.home-assistant.io/docs/configuration/templating/
https://www.home-assistant.io/integrations/notify/
https://www.home-assistant.io/integrations/google_assistant/
https://github.com/custom-components/alexa_media_player/wiki/Configuration
Insomma non è immediato come si crede. Un minimo di basi ci vogliono.
In caso scrivi nel gruppo https://t.me/HassioHelp , qualcuno ti aiuterà sicuramente.
Buonasera , con firmware v1.5.0_0026 quando cerco di inserire la seconda integrazione ( per il comando di apertura di telnet) me la rifiuta con un Unknown error occured, pur inserendo host e token corretti . Il comando di apertura telnet è rimasto invariato? non riesco ad uscirne.
Grazie
Andrea
Buonasera.
Ha aggiornato il custom da HACS all’ultima versione ??
Se non riesce ad entrare come root probabile che sia sbaglito o ip o token.
In ogni caso se vuole le giro il link della lista firmware supportati https://github.com/AlexxIT/XiaomiGateway3#supported-firmwares.
Saluti
Buonasera, vi chiedo un aiuto ho il GW Xiaomi 3 con firmware 1.5.4_0090 e non riesco ad utilizzare il metodo da voi sopra indicato, inserisco l’IP il token (caricato in automatico da Xiaomi gateway 3) ed inserisco il codice per aprire la telnet da voi indicato ma mi dà l’errore “Can’t connect to gateway” è colpa del firmware installato (credo sia l’ultimo) ? se si avete una guida per installare il custon o inserire un originale compatibile? ho provato anche la vostra guida per integrarlo con Z2M ma quando vado provo ad accedere al GW tramite Telnet come da guida mi da “Connessione rifiutata” ci sono delle attività preliminari da effettuare prima di provare l’accesso tramite telnet? grazie mille a chi mi darà supporto
Buongiorno, purtroppo il firmware 1.5.4_0090 non è ancora supportato per la modifica.
Stiamo parlando di firmware originale ovviamente.
Saluti
Grazie mille, c’è possibilità di installare comunque un Custom Fw o devo metterlo nel cassetto?
Guarda, l’unica via che mi viene in mente è provare un downgrade, ma devi saldare dei fili e non l’ho mai provato.
https://github.com/serrj-sv/lumi.gateway.mgl03/tree/main/uart_recovery
Da provare, oppure attendere che riescano a trovare la pssword di root del firmware in tuo possesso 😉
Comunque indago e vedo se trovo una soluzione, contattami pure in telegram https://t.me/Alesoft73 oppure nel nostro gruppo https://t.me/HassioHelp.
A presto!
Grazie mille!!! ci provo veramente gentile