Configuração com Conexão Local Não Recomendado

Este método deve ser usado para estabelecer uma conexão local direta com o aspirador robô sem depender de conectividade contínua com a nuvem. Para usar este método, o dispositivo deve ter sido adicionado com sucesso ao aplicativo oficial Xiaomi Home (disponível para iOS e Android) pelo menos uma vez para gerar um token válido. Além disso, ele deve permanecer vinculado à conta durante esta etapa de configuração para que a integração possa recuperar o endereço IP e o token necessários da nuvem.

Compatibilidade de Dispositivos

Este método de conexão é suportado exclusivamente para dispositivos fabricados antes de 2022 que são compatíveis com o aplicativo Xiaomi Home. Se um dispositivo não puder ser adicionado ao aplicativo Xiaomi Home, ele não irá expor uma API local em nenhuma circunstância com qualquer token.

Sem Suporte a Mapas Não Recomendado

Tecnicamente, não é possível recuperar dados de mapa através da API local. Como resultado, o método de conexão local fornece nenhum suporte a mapa, o que desativa completamente várias funcionalidades principais que dependem de dados de mapa, como Histórico limpeza, Restaurar mapa e Entidades de Sala dinâmicos. Como o mapa e suas funcionalidades dependentes são centrais para a funcionalidade principal da integração, este método de conexão é estritamente não recomendado. Para uma experiência completa e totalmente funcional, é altamente aconselhável utilizar um dos métodos de conexão em nuvem.

Recuperando IP e Token

Para configurar a conexão local, você deve fornecer manualmente o endereço IP e o token do dispositivo.

Requisito de Sub-rede

Por razões de segurança, o dispositivo somente responde a solicitações originadas de sua própria sub-rede. Portanto, o aspirador robô e o Home Assistant devem estar na mesma sub-rede para que a comunicação local funcione. Veja este artigo python-miio para solução de problemas relacionados a sub-redes cruzadas.

Método 1: Xiaomi Cloud Tokens Extractor Recomendado

Este é o método mais confiável. Ele funciona no Windows, macOS ou Linux, conectando-se diretamente aos servidores da nuvem da Xiaomi para recuperar os endereços IP e tokens de todos os dispositivos vinculados à conta simultaneamente.

1. Baixar a Ferramenta: Baixe a versão apropriada (por exemplo, .exe para Windows) do Xiaomi Cloud Tokens Extractor no GitHub.
2. Executar o Aplicativo: Execute o arquivo baixado para abrir uma interface de terminal.
3. Inserir Credenciais: Forneça o nome de usuário exato (Email ou Xiaomi ID) e a senha usados no aplicativo Xiaomi Home.
4. Selecionar Região do Servidor: Especifique a região do servidor correspondente ao aplicativo Xiaomi Home (por exemplo, de para Europa). Se a região for desconhecida, deixe o prompt em branco e pressione Enter para escanear todos os servidores disponíveis.
5. Recuperar o Token: A ferramenta exibirá uma lista de todos os dispositivos conectados à conta. Localize o aspirador alvo na lista e copie seu token correspondente de 32 caracteres.

Método 2: Aplicativo de Interface Gráfica para Desktop (Get_MiHome_devices_token)

Para usuários que preferem uma interface gráfica em vez de uma ferramenta de linha de comando, um aplicativo para desktop está disponível.

1. Baixar o Aplicativo: Baixe e instale o aplicativo Get_MiHome_devices_token do GitHub.
2. Login: Abra o aplicativo, insira as credenciais da conta Xiaomi e selecione a região do servidor apropriada.
3. Recuperar o Token: Uma vez autenticado, todos os dispositivos vinculados, juntamente com seus respectivos endereços IP e tokens, serão exibidos em formato de tabela.

Método 3: App Mi Home Modificado para Android Não Recomendado

Usuários Android podem utilizar uma versão modificada do aplicativo Mi Home para visualizar tokens diretamente na interface do aplicativo em seu dispositivo móvel.

1. Desinstalar o Aplicativo Original: Desinstale completamente o aplicativo oficial Mi Home do dispositivo Android. (Observação: Os dispositivos permanecerão vinculados com segurança à conta na nuvem).
2. Instalar o Aplicativo Modificado: Pesquise online pelo APK modificado "MiHome by Vevs", baixe a versão mais recente e instale no dispositivo.
3. Login: Abra o aplicativo modificado e faça login usando as credenciais da conta Xiaomi.
4. Recuperar o Token: Selecione o aspirador alvo para abrir sua interface de controle. Toque nos três pontos no canto superior direito para acessar as configurações, depois navegue até a seção Informações de Rede ou Configurações Gerais. O endereço IP do dispositivo e o token estarão diretamente visíveis nesta tela.