Oppsett med Xiaomi Home-konto

Denne metoden bør brukes hvis robotstøvsugeren for øyeblikket administreres via Xiaomi Home-applikasjonen. For å sikre kompatibilitet kan det verifiseres mot den offisielle Xiaomi Home-appen tilgjengelig for iOS og Android.

Krav

• Legitimasjon: Må være nøyaktig brukernavn og passord som brukes for å logge inn i mobilapplikasjonen (ikke det offisielle nettstedet).
• Serverregion: Det valgte landet må samsvare med regionen der enheten er registrert i appen. Feil region vil resultere i feil som "innlogging mislyktes" eller "enhet ikke funnet".

Tredjepartsinnlogginger

Hvis kontoen ble opprettet ved hjelp av en tredjepartstjeneste (som Google eller Apple), må et dedikert passord genereres innenfor applikasjonens brukermeny først. Passord for tredjepartskontoer kan ikke brukes til autentisering.

Anbefaling om appvalg

Noen enheter kan konfigureres ved hjelp av enten Dreamehome- eller Xiaomi Home-applikasjonen. Med mindre en lokal tilkobling er strengt nødvendig, anbefales det sterkt å bruke Dreamehome-appen i stedet for Xiaomi Home for støttede enheter:

• Kamerastream: Kamerastream-funksjonen er ikke tilgjengelig for enheter konfigurert via Xiaomi Home.
• Push-oppdateringer: Dreamehome-tilkoblingen bruker Cloud Push for sanntidsoppdateringer, noe som eliminerer behovet for periodiske spørringer.

Foretrekk sky-alternativ

Under konfigurasjonstrinnet er et ekstra Foretrekk sky-alternativ tilgjengelig og er valgt som standard.

• Når krysset av (Standard): Tvinger all kommunikasjon gjennom skyen (hvis støttet av enheten). Dette er standardadferd fordi Xiaomi på nyere enheter har deaktivert lokale tilgangsmuligheter. Videre, hvis enheten og Home Assistant befinner seg på forskjellige subnett, vil lokal kommunikasjon feile.
• Når ikke krysset av (Anbefales for støttede oppsett): Integrasjonen henter den nødvendige token fra skyen, men etablerer en direkte lokal tilkobling med enheten (ligner på Lokal tilkobling-metoden). Dette gir fordelen av automatisk fornyelse av token og IP samtidig som all kommunikasjon (bortsett fra kartdata) forblir lokal. Hvis denne metoden resulterer i en "kan ikke nå enheten"-feil i det siste konfigurasjonstrinnet, bør konfigurasjonen prøves på nytt med Foretrekk Sky-alternativet kryss av.

  Krav til subnett

  Av sikkerhetsgrunner responderer enheten kun på forespørsler som kommer fra sitt eget subnett. Derfor må robotstøvsugeren og Home Assistant være på nøyaktig samme subnett for at lokal kommunikasjon skal fungere. Se denne python-miio-artikkelen for feilsøking av problemer på tvers av subnett.

Captcha-verifisering

Hvis Xiaomi Home-serverne markerer innloggingsforsøket eller IP-adressen som utrygg, vil et captcha-verifikasjonstrinn være nødvendig. Når dette skjer, må captcha-bildet løses for å gå videre til neste trinn.

To-faktorautentisering (2FA)

I tillegg til captcha kan et utrygt innloggingsforsøk også utløse to-faktorautentisering (2FA). Integrasjonen vil automatisk be om en 2FA-kode fra Xiaomi Home-serverne, som sendes til det registrerte telefonnummeret (prioritert) eller e-postadressen.

Denne koden må hentes og legges inn i konfigurasjonstrinnet for å fullføre innloggingen.

Begrensninger for 2FA

• Gyldighet på kode: Hvis konfigurasjonsvinduet lukkes og et nytt påloggingsforsøk gjøres, vil en ny 2FA-kode bli generert. Den sist mottatte koden må alltid brukes.
• Begrensning på forespørsler: Xiaomi begrenser strengt antallet 2FA-koder som kan etterspørres per dag. Gjentatte påloggingsforsøk kan føre til midlertidig blokkering.

Periodiske tilstandsoppdateringer

I motsetning til andre skyløsninger som støtter push-varsler, er Xiaomi Home-tilkoblingen helt avhengig av bakgrunnspolling for å hente siste tilstand. For å optimalisere nettverksbruk, beregnes pollingintervallet dynamisk basert på tiden som har gått siden siste tilstandsendring; forespørsler sendes ofte mens enheten aktivt kjører, men intervallet øker gradvis etter hvert som mer tid går mens enheten forblir inaktiv.

Re-autentisering

Integrasjonen lagrer sikkert en autentiseringstoken etter en vellykket innlogging for å kommunisere med sky-serverne. Hvis denne tokenen utløper eller blir ugyldiggjort av skyløsningen av en eller annen grunn, vil Home Assistant automatisk utløse en re-autentiseringsprosess, som ber om at kontoinformasjonen legges inn på nytt.