[Tutorial] Installare Xiaomi Miot Auto su Home Assistant

Guida passo-passo con esempio pratico per l’acquario Xiaomi MYG100

Perché usare Xiaomi Miot Auto?

Xiaomi Miot Auto è un’integrazione personalizzata che sfrutta il protocollo MIoT per aggiungere quasi tutti i dispositivi Xiaomi a Home Assistant con pochissimi clic[21][22].
Rispetto alle integrazioni ufficiali, offre:

• Interfaccia in italiano invece che cinese o inglese.
• Controllo locale o cloud a scelta, con aggiornamenti rapidi degli stati[24].
• Accesso a servizi avanzati (set_property, call_action) utili per automazioni complesse.

Prerequisiti

1. Home Assistant 2023.4 (o superiore) con permessi da amministratore.
2. HACS installato e funzionante – guida dedicata.
3. Account GitHub per l’autenticazione HACS.
4. Credenziali Xiaomi (utente, password e regione: cn, de, i2, ru, sg, us).

Installazione tramite HACS

1. Apri HACS › Integrations.
2. Clicca Explore & Download Repositories (+) e cerca “Xiaomi Miot Auto”.
3. Seleziona il repository di al-one e premi Download[21].
4. Riavvia Home Assistant (Impostazioni › Sistema › Riavvia).
5. Dopo il riavvio vai su Impostazioni › Dispositivi e Servizi › Aggiungi integrazione e cerca di nuovo “Xiaomi Miot Auto”.

Metodo di connessione

• Automatico – Scelta consigliata: la componente decide se usare LAN o cloud[22].
• Locale – Solo dispositivi compatibili MIoT in rete locale.
• Cloud – Necessario per BLE, ZigBee o dispositivi MiIO legacy.

Esempio pratico: acquario Xiaomi MYG100

Il modello MYG100 è un acquario smart da 20 L con filtro a 5 stadi, luci RGB, pompa autosifonante e alimentatore automatico[6][9].
Nell’app Mi Home l’interfaccia è disponibile solo in cinese; con Miot Auto invece otteniamo tutte le entità tradotte e controllabili in italiano.

Entità principali create

Automazione di esempio (alimenta i pesci alle 08:00)

- alias: "Alimenta pesci mattino"
  trigger:
    platform: time
    at: "08:00:00"
  action:
    service: xiaomi_miot.call_action
    data:
      entity_id: switch.myg100_feeder
      siid: 4
      aiid: 1

Demo video

Guarda il mio test pratico su YouTube per vedere l’acquario MYG100 gestito in italiano con Home Assistant:

Risoluzione problemi comuni

• Dispositivo non rilevato – Controlla rete Wi-Fi e server regione, poi riavvia Home Assistant[36].
• Errori di autenticazione – Verifica username/password Mi Home; se usi 2FA disattivala temporaneamente[24].
• Funzioni mancanti – Alcuni modelli espongono solo subset di comandi via MIoT-Spec[21].

Aggiornare Xiaomi Miot Auto

1. Apri HACS › Integrations.
2. Cerca “Xiaomi Miot Auto” → se appare Update, clicca e conferma.
3. Esegui un Riavvio Completo di Home Assistant.

Conclusione

Con Xiaomi Miot Auto puoi controllare l’acquario smart MYG100 (e decine di altri dispositivi) direttamente da Home Assistant in lingua italiana, creare automazioni avanzate e centralizzare la domotica su un’unica dashboard.
Ricorda di mantenere HACS e l’integrazione sempre aggiornati per accedere alle nuove funzioni e alle correzioni di bug.