Segnalazione Bug e Funzionalità

Tutte le segnalazioni di bug, richieste di funzionalità e discussioni vanno a repository GitHub dell'integrazione.

Controlla gli Aggiornamenti

Controllare HACS garantisce che l'ultima versione dell'integrazione sia in esecuzione prima di aprire un problema. Un bug segnalato o una funzionalità richiesta potrebbe già esistere in una versione recente.

Controlla prima le FAQ

Dispositivi non supportati, fallimenti di login/connessione e crash di Home Assistant o esaurimento della memoria sono già trattati nella pagina FAQ e non sono bug.

Apri un Problema su GitHub

Richiedere una Funzionalità

Idee per nuove funzionalità e miglioramenti sono sempre benvenute.

È richiesta una descrizione chiara dell'idea, le motivazioni della sua utilità e la funzionalità prevista. Mockup, schizzi o esempi da altre app, come l'app ufficiale Dreame, facilitano le richieste di cambiamenti visivi o comportamentali.

Richiedere il Supporto per un Nuovo Modello Opzionale

Il processo di aggiunta del supporto per nuovi modelli di dispositivi è semi-automatico e incluso in ogni nuova release dell'integrazione. Sebbene di solito sia sufficiente attendere le prossime versioni, può essere aperta una richiesta di Supporto Nuovo Modello se necessario.

Quando si richiede il supporto per un nuovo dispositivo, sono richieste le seguenti informazioni:

• Versione di Home Assistant
• Numero del modello del dispositivo
• Registro Dispositivo Non Supportato (Questo deve essere estratto dai log di Home Assistant e fornito nel ticket)

Prima di aprire la richiesta, assicurarsi che sia installata l'ultima versione dell'integrazione, che Home Assistant sia stato riavviato e che siano stati consultati gli elenchi di dispositivi supportati/non supportati nella documentazione.

Porre una Domanda

Per domande generali o discussioni che non riguardano bug o richieste di funzionalità, può essere aperto un ticket di tipo Domanda per chiedere aiuto o chiarimenti sul progetto.

Segnalazione di un Bug

Fornire informazioni chiare e dettagliate quando si verifica un comportamento imprevisto accelera il processo di risoluzione. Quando si apre un report di bug, sono richieste le seguenti informazioni:

• Nome Modello (ad es., dreame.vacuum.p2028)
• Versione Firmware (ad es., 1156)
• Versione di Home Assistant
• Tipo di configurazione
• Errori o avvisi dai log di Home Assistant (se applicabile)

Ottieni Log di Debug

Risolvere problemi di connessione, entità mancanti o stati imprevisti richiede la revisione di ciò che l'integrazione ha effettivamente registrato. Abilitare il logging di debug cattura molti più dettagli rispetto al livello di log predefinito.

Il logging di debug può ora essere facilmente abilitato direttamente dall'interfaccia utente di Home Assistant senza modificare i file di configurazione. Per istruzioni dettagliate su come abilitarlo e scaricare i log, si prega di fare riferimento all'ufficiale Documentazione di risoluzione dei problemi di Home Assistant.

Proteggi i dati sensibili

Il file completo homeassistant.log contiene informazioni sensibili, come password, token o identificativi personali di altre integrazioni. Estrarre e condividere solo le parti relative a dreame_vacuum protegge questi dati. L'intero file di log non dovrebbe mai essere caricato pubblicamente senza averne prima esaminato il contenuto.