Xiaomi Miot Auto è l’integrazione custom più potente e completa per portare l’intero ecosistema Xiaomi all’interno di Home Assistant. Sviluppata dalla community e disponibile su HACS, questa integrazione utilizza il protocollo MIoT-Spec per comunicare automaticamente con migliaia di dispositivi Xiaomi, supportando connessioni Wi-Fi, Bluetooth, Bluetooth Mesh e Zigbee.
Con oltre 5.500 stelle su GitHub e 782 fork, Xiaomi Miot Auto è diventata la soluzione di riferimento per chi desidera un’integrazione nativa, stabile e ricca di funzionalità dei dispositivi Xiaomi in Home Assistant.
Cos’è il protocollo MIoT-Spec e perché è importante
MIoT-Spec (Xiaomi IoT Specification) è lo standard proprietario progettato da Xiaomi per descrivere le funzionalità degli smart device secondo il modo di connessione, le caratteristiche funzionali del prodotto e gli scenari d’uso. Questo protocollo standardizza la comunicazione tra dispositivi, rendendo possibile un’integrazione automatica senza dover scrivere codice specifico per ogni modello.
A differenza dell’integrazione ufficiale Xiaomi Miio inclusa in Home Assistant, che supporta solo una gamma limitata di dispositivi, Xiaomi Miot Auto sfrutta le specifiche MIoT per riconoscere e configurare automaticamente praticamente qualsiasi dispositivo dell’ecosistema Mi Home. Questo include robot aspirapolvere, purificatori d’aria, lampadine, sensori, termostati, telecamere, condizionatori, umidificatori e centinaia di altri prodotti.
Dispositivi supportati: l’ecosistema completo Xiaomi
Xiaomi Miot Auto supporta una lista impressionante di categorie di dispositivi:
- Robot aspirapolvere e lavapavimenti: tutti i modelli Roborock, Mi Robot Vacuum, Dreame, inclusi i più recenti con mappatura laser, svuotamento automatico e lavaggio mop.
- Purificatori d’aria: Mi Air Purifier 2, 2S, 3H, 3C, 4, 4 Pro, Air Purifier Pro, con controllo completo di velocità ventola, modalità, timer e monitoraggio qualità aria.
- Lampadine e illuminazione: Yeelight, Philips Xiaomi, Mi LED Desk Lamp, strip LED, lampadari smart con controllo luminosità, temperatura colore e RGB.
- Sensori: sensori temperatura, umidità, movimento, apertura porta/finestra, perdite d’acqua, fumo, gas, sia Zigbee che Bluetooth.
- Climatizzazione: condizionatori Mi Smart Air Conditioner, termostati, ventilatori smart, umidificatori e deumidificatori.
- Elettrodomestici intelligenti: lavatrici, asciugatrici, forni a microonde, bollitori, pentole elettriche, friggitrici ad aria.
- Gateway e hub: Xiaomi Gateway 2, Gateway 3, Aqara Hub, Multimode Gateway per gestire dispositivi Zigbee.
- Telecamere di sicurezza: Mi Home Security Camera 360°, 1080p, 2K, con streaming video e rilevamento movimento.
- Dispositivi Bluetooth Mesh: lampadine, sensori e interruttori che utilizzano il protocollo Bluetooth Mesh proprietario Xiaomi.
La lista completa dei dispositivi supportati è consultabile sul repository GitHub ufficiale, costantemente aggiornato dalla community.
Installazione di Xiaomi Miot Auto tramite HACS
L’installazione di Xiaomi Miot Auto richiede HACS (Home Assistant Community Store), il marketplace delle integrazioni custom. Se non hai ancora installato HACS, dovrai farlo seguendo la guida ufficiale disponibile sul sito hacs.xyz.
Passo 1: Aggiungi il repository a HACS
Apri Home Assistant e vai su HACS dalla barra laterale. Clicca sui tre puntini nell’angolo in alto a destra e seleziona “Custom repositories”. Incolla l’URL del repository https://github.com/al-one/hass-xiaomi-miot e seleziona “Integration” come categoria.
Passo 2: Installa l’integrazione
Torna alla schermata principale di HACS, clicca su “Integrations” e cerca “Xiaomi Miot Auto” nella barra di ricerca. Seleziona l’integrazione e clicca su “Download” nell’angolo in basso a destra. HACS scaricherà automaticamente tutti i file necessari nella cartella custom_components/xiaomi_miot.
Passo 3: Riavvia Home Assistant
Dopo il completamento del download, è obbligatorio riavviare Home Assistant per caricare la nuova integrazione. Vai su Impostazioni > Sistema > Riavvia e attendi il riavvio completo del sistema.
Installazione alternativa via terminale
Per utenti avanzati che preferiscono il terminale, è disponibile uno script di installazione automatica:
wget -q -O - https://cdn.jsdelivr.net/gh/al-one/hass-xiaomi-miot/install.sh | bash -
Questo comando scarica ed esegue lo script di installazione che copia automaticamente i file nella directory corretta.
Configurazione dell’integrazione: account Mi vs host/token
Xiaomi Miot Auto offre due modalità di configurazione principali, adatte a scenari d’uso diversi.
Metodo 1: Integrazione tramite account Mi (consigliato)
Questo è il metodo più semplice e completo, ideale per chi ha numerosi dispositivi Xiaomi. Vai su Impostazioni > Dispositivi e Servizi > Aggiungi Integrazione e cerca “Xiaomi Miot Auto”. Seleziona “Add devices using Mi Account” e inserisci le credenziali del tuo account Xiaomi (email/telefono e password).
Selezione del server: è fondamentale selezionare il server corretto in base alla regione del tuo account Xiaomi:
-
cn: Cina (predefinito)
-
de: Germania
-
i2: India
-
ru: Russia
-
sg: Singapore
-
us: Stati Uniti
Se il tuo account è stato creato in Italia tramite l’app Mi Home europea, il server corretto è de (Germania).
Modalità di connessione: dalla versione 0.4.4, l’integrazione permette di scegliere tra tre modalità:
- Automatic (consigliato): il sistema aggiorna regolarmente l’elenco dei dispositivi che supportano MIoT-Spec in LAN e utilizza automaticamente la connessione locale per quelli compatibili. Questa è la modalità più intelligente perché ottimizza latenza e privacy senza configurazioni manuali.
- Local: tutti i dispositivi filtrati utilizzeranno connessione locale. Ideale per chi vuole controllo offline completo, ma attenzione: dispositivi che non supportano MIoT in LAN risulteranno non disponibili.
- Cloud: tutti i dispositivi utilizzano connessione cloud. Consigliata per dispositivi MiiO, Bluetooth e Zigbee che non supportano connessione locale diretta.
Metodo 2: Integrazione tramite host/token
Questa modalità è adatta per singoli dispositivi che supportano il protocollo MIoT-Spec in LAN. Richiede l’indirizzo IP del dispositivo e il token di autenticazione, recuperabili tramite app di terze parti come “Mi Home Token Extractor” o analizzando il traffico di rete.
Vai su Aggiungi Integrazione > Xiaomi Miot Auto > Add device using host/token. Inserisci l’indirizzo IP e il token a 32 caratteri esadecimali del dispositivo.
Configurazione avanzata: cloud, traduzioni e personalizzazioni
Xiaomi Miot Auto offre opzioni di configurazione avanzate per utenti esperti, gestibili tramite file configuration.yaml.
Configurazione Xiaomi Cloud per dispositivi locali
Se hai aggiunto dispositivi tramite host/token ma desideri abilitare funzionalità cloud (come streaming telecamere o controllo remoto), puoi configurare l’account Xiaomi nel file configuration.yaml:
xiaomi_miot: username: tuo_account_xiaomi password: tua_password server_country: de # Cambia in base alla tua regione
Dopo aver salvato il file, riavvia Home Assistant e vai su Impostazioni > Dispositivi e Servizi > Xiaomi Miot Auto > Opzioni > Abilita miot cloud.
Traduzioni personalizzate
L’integrazione include un sistema di traduzioni che converte i nomi tecnici cinesi in etichette comprensibili:
xiaomi_miot:
language: zh # Utilizza il dizionario integrato (solo cinese)
translations:
# Dizionario globale
idle: 'In attesa'
busy: 'In funzione'
# Dizionario specifico per modalità ventola
fan.mode:
'straight wind': 'Vento diretto'
'natural wind': 'Vento naturale'
# Dizionario per livelli asciugatura lavatrice
washer.drying_level:
moist: 'Leggermente umido'
extra: 'Extra asciutto'
Personalizzazione entità avanzata
Puoi personalizzare il comportamento di singole entità tramite il file customize.yaml:
# customize.yaml light.xiaomi_bedroom_lamp: miot_local: true # Forza lettura/scrittura locale miot_cloud: false # Disabilita cloud vacuum.xiaomi_vacuum_mop: miio_properties: battery,state # Aggiungi proprietà MiiO cover.xiaomi_curtain: closed_position: 5 # Considera chiuso sotto 5% deviated_position: 2 # Deviazione posizione ±2% motor_reverse: true # Inverti direzione motore
Creazione di sotto-entità personalizzate
Una funzionalità potente di Xiaomi Miot Auto è la possibilità di creare sotto-entità basate su proprietà MIoT specifiche:
# customize.yaml climate.xiaomi_air_conditioner: sensor_properties: temperature,humidity # Crea sensori separati switch_properties: power,eco_mode # Crea interruttori light.xiaomi_desk_lamp: number_properties: brightness,color_temp # Crea controlli numerici
Questa funzione è utile per esporre controlli granulari in dashboard Lovelace o utilizzare singole proprietà in automazioni complesse.
Esempi pratici di automazioni
Automazione 1: Purificatore d’aria basato su qualità AQI
automation:
- alias: "Accendi purificatore se AQI elevato"
trigger:
- platform: numeric_state
entity_id: sensor.xiaomi_air_purifier_aqi
above: 100
action:
- service: fan.set_preset_mode
target:
entity_id: fan.xiaomi_air_purifier
data:
preset_mode: "auto"
- service: fan.turn_on
target:
entity_id: fan.xiaomi_air_purifier
Automazione 2: Robot aspirapolvere quando esci
automation:
- alias: "Avvia pulizia quando esco"
trigger:
- platform: state
entity_id: person.mario
from: "home"
to: "not_home"
for: "00:05:00"
condition:
- condition: time
after: "09:00:00"
before: "18:00:00"
- condition: state
entity_id: vacuum.xiaomi_vacuum
state: "docked"
action:
- service: vacuum.start
target:
entity_id: vacuum.xiaomi_vacuum
Automazione 3: Lampadine sincronizzate al tramonto
automation:
- alias: "Luci calde al tramonto"
trigger:
- platform: sun
event: sunset
offset: "-00:30:00"
action:
- service: light.turn_on
target:
entity_id:
- light.xiaomi_bedroom_lamp
- light.xiaomi_living_room
data:
brightness: 180
color_temp: 400
Confronto: Xiaomi Miot Auto vs Xiaomi Miio vs Xiaomi Gateway 3
Per aiutarti a scegliere l’integrazione giusta, ecco un confronto dettagliato:
Xiaomi Miio (integrazione ufficiale)
-
Installazione facile (integrazione nativa)
-
Nessuna configurazione HACS richiesta
-
Supporta solo dispositivi limitati
-
Meno funzionalità avanzate
Xiaomi Miot Auto (HACS)
-
Installazione semplice via HACS
-
Supporta migliaia di dispositivi
-
Modalità automatica locale/cloud
-
Altamente personalizzabile
-
Richiede HACS installato
Xiaomi Gateway 3 (HACS)
-
Controllo locale completo
-
Latenza bassissima (~1 secondo)
-
Funziona offline
-
Richiede Xiaomi Gateway 3 specifico
-
Configurazione più complessa per dispositivi non supportati
Verdetto: per la maggior parte degli utenti, Xiaomi Miot Auto rappresenta il miglior compromesso tra semplicità, compatibilità e funzionalità. Se possiedi principalmente dispositivi Bluetooth Mesh e desideri controllo locale assoluto, considera Xiaomi Gateway 3.
Risoluzione problemi comuni
Errore “Device model is unknown”
Questo errore si verifica quando l’integrazione non riconosce il modello del dispositivo. Soluzione: aggiorna Xiaomi Miot Auto all’ultima versione disponibile su HACS, poiché vengono aggiunti nuovi modelli regolarmente.
Dispositivi Zigbee non funzionano
I sensori Zigbee richiedono un gateway Xiaomi per funzionare. Assicurati di aver configurato l’integrazione con l’account Mi che include il gateway. Per controllo locale ottimale, considera l’integrazione Xiaomi Gateway 3.
Latenza elevata nel controllo dispositivi
Se utilizzi la modalità Cloud, la latenza può raggiungere 15 secondi o più. Soluzione: passa alla modalità Automatic o Local nelle opzioni dell’integrazione per abilitare il controllo locale quando possibile.
Dispositivi non rilevati dopo configurazione
Verifica che il server_country sia corretto per il tuo account Xiaomi. Account europei richiedono “de”, non “cn” (Cina).
Integrazione non compare dopo installazione HACS
Dopo l’installazione da HACS, è obbligatorio riavviare Home Assistant. Se persiste, verifica che i file siano stati copiati correttamente in custom_components/xiaomi_miot.
Aggiornamento e manutenzione
Xiaomi Miot Auto riceve aggiornamenti frequenti con nuovi dispositivi supportati e correzioni bug. Per aggiornare:
-
Apri HACS > Integrations
-
Cerca “Xiaomi Miot Auto”
-
Se disponibile, clicca su “Update”
-
Riavvia Home Assistant dopo l’aggiornamento
È consigliabile controllare gli aggiornamenti almeno una volta al mese per beneficiare delle ultime migliorie.
Considerazioni sulla privacy e sicurezza
La modalità Local garantisce che i comandi non transitino sui server Xiaomi, mantenendo la comunicazione confinata alla rete domestica. Tuttavia, alcuni dispositivi (specialmente Bluetooth Mesh e Zigbee) richiedono obbligatoriamente connessione cloud.
Per massimizzare la privacy:
-
Utilizza la modalità Automatic o Local quando possibile
-
Isola i dispositivi Xiaomi su una VLAN separata
-
Configura regole firewall per bloccare connessioni cloud indesiderate
-
Considera l’utilizzo di Xiaomi Gateway 3 per controllo 100% locale
Xiaomi Miot Auto rappresenta la soluzione più completa e matura per integrare l’ecosistema Xiaomi in Home Assistant. Con supporto a migliaia di dispositivi, modalità automatica intelligente che bilancia controllo locale e cloud, e personalizzazioni avanzate per utenti esperti, questa integrazione HACS è diventata uno standard de facto nella community.
L’installazione tramite HACS richiede pochi minuti, la configurazione con account Mi è immediata, e le automazioni si creano con la stessa facilità di qualsiasi integrazione nativa. Che tu abbia un singolo robot aspirapolvere o decine di dispositivi sparsi per casa, Xiaomi Miot Auto li porterà tutti sotto il controllo unificato di Home Assistant.
