Relatórios de Bugs e Funcionalidades

Todos os relatórios de bugs, solicitações de funcionalidades e discussões devem ir para o repositório GitHub da integração.

Verificar Atualizações

Verificar o HACS garante que a versão mais recente da integração esteja em execução antes de abrir um problema. Um bug relatado ou uma funcionalidade solicitada pode já estar presente em uma versão recente.

Verifique a FAQ Primeiro

Dispositivos não suportados, falhas de login/conexão e travamentos ou falta de memória do Home Assistant já estão cobertos na página FAQ e não são bugs.

Abrir um Problema no GitHub

Solicitar uma Funcionalidade

Novas ideias de funcionalidades e melhorias são sempre bem-vindas.

É necessário uma descrição clara da ideia, o raciocínio por trás de sua utilidade e a funcionalidade prevista. Mockups, esboços ou exemplos de outros aplicativos, como o aplicativo oficial Dreame, facilitam solicitações de mudanças visuais ou de comportamento.

Solicitar Suporte a Novo Modelo Opcional

O processo de adicionar suporte a novos modelos de dispositivos é semi-automático e incluído em cada nova versão de integração. Embora geralmente seja suficiente apenas aguardar pelas próximas versões, uma solicitação de Suporte a Novo Modelo pode ser aberta, se necessário.

Ao solicitar suporte para um novo dispositivo, as seguintes informações são necessárias:

• Versão do Home Assistant
• Número do Modelo do Dispositivo
• Registro de Dispositivo Não Suportado (Isso deve ser extraído dos registros do Home Assistant e fornecido na issue)

Antes de abrir a solicitação, certifique-se de que a versão mais recente da integração esteja instalada, o Home Assistant tenha sido reiniciado e as listas de dispositivos suportados/não suportados da documentação tenham sido verificadas.

Fazendo uma Pergunta

Para dúvidas gerais ou discussões que não sejam bugs ou solicitações de recursos, uma issue de Pergunta pode ser aberta para pedir ajuda ou esclarecimento sobre o projeto.

Reportando um Bug

Fornecer informações claras e detalhadas quando ocorrer comportamento inesperado acelera o processo de resolução. Ao abrir um relatório de bug, as seguintes informações são necessárias:

• Nome do Modelo (por exemplo, dreame.vacuum.p2028)
• Versão do Firmware (por exemplo, 1156)
• Versão do Home Assistant
• Tipo de configuração
• Erros ou avisos dos registros do Home Assistant (se aplicável)

Obter Logs de Depuração

Resolver problemas de conexão, entidades ausentes ou estados inesperados requer revisar o que a integração realmente registrou. Habilitar o registro de depuração captura muito mais detalhes do que o nível de log padrão.

O registro de depuração agora pode ser facilmente habilitado diretamente na interface do usuário do Home Assistant sem editar arquivos de configuração. Para instruções detalhadas sobre como habilitá-lo e baixar os logs, consulte o oficial Documentação de Solução de Problemas do Home Assistant.

Proteger Dados Sensíveis

O arquivo completo homeassistant.log contém informações sensíveis, como senhas, tokens ou identificadores pessoais de outras integrações. Extrair e compartilhar apenas as partes relacionadas a dreame_vacuum protege esses dados. O arquivo de log completo não deve nunca ser enviado publicamente sem revisar seu conteúdo.