Solução de problemas

Nenhuma porta aparece ao clicar em Instalar

Um cabo USB que só carrega e não transmite dados é a causa mais comum. Troque de cabo: de preferência o que veio com o dispositivo, ou qualquer um que você já usou para passar arquivos de um celular.

Se ainda assim não aparecer nada, pode faltar o driver da porta serial (veja Windows e Linux abaixo).

Windows: a porta não aparece, ou aparece “dispositivo desconhecido”

Adaptadores com chip CH340 (comum nos USB-TTL usados com as Sonoff) ou CP2102/CP210x precisam de driver:

CH340: wch.cn
CP210x: silabs.com

Depois de instalar, replugue o cabo e recarregue a página.

Linux: “Access denied”, ou a porta some ao abrir

O seu usuário provavelmente não está no grupo dialout (Debian/Ubuntu) ou uucp (Arch/Manjaro):

sudo usermod -a -G dialout $USER   # Debian/Ubuntu
sudo usermod -a -G uucp $USER      # Arch/Manjaro

Depois faça logout e login (ou reinicie) para o grupo valer.

A gravação falha no meio ou trava em “Connecting…”

Nas Sonoff (adaptador USB-TTL), confira se você segurou o botão ao plugar o USB, que é o que põe a placa em modo de gravação. Veja o guia da R4 ou da R2. Em placas com USB nativo (S2 Mini, S3), tente outro cabo ou uma porta USB direto no computador, sem hub.

Gravou, mas nunca pede a senha do Wi-Fi (Improv)

Comum nas Sonoff: diferente de placas com USB nativo, o adaptador USB-TTL genérico não tem os fios extras que deixam o navegador reiniciar a placa sozinho depois de gravar. Ela fica presa em modo de gravação, nunca roda o firmware novo, e o Improv nunca começa.

Solução: desconecte e reconecte o adaptador USB sem segurar o botão, para a placa iniciar o firmware normalmente.

Instalou, mas não aparece no grow.local

Confira se a senha do Wi-Fi digitada estava certa. Se estava errada, o dispositivo sobe uma rede própria de reserva: procure no celular um Wi-Fi com o nome do dispositivo, conecte e configure de novo.

Confira também se o dispositivo está na mesma rede Wi-Fi do GrowController. Redes de convidados ou isoladas costumam bloquear o mDNS entre dispositivos.

Se o seu GrowController não se chama grow (aba Sistema), ou se há mais de um na rede, o dispositivo pode estar procurando o controlador errado. Abra http://<nome-do-dispositivo>.local e confira o campo Controlador: ele precisa ser o <nome>.local do GrowController certo. O botão Procurar controladores, na mesma página, lista os que o dispositivo enxerga na rede. Se a lista vier vazia com o controlador ligado, a rede está bloqueando o mDNS (veja o parágrafo acima).

Quero ver o log serial do dispositivo

Este botão abre o console de log direto no navegador. É a mesma tecnologia da instalação, só que em modo leitura:

Seu navegador não suporta Web Serial — use Chrome ou Edge no computador.Acesso à porta serial bloqueado. Confira se a página está em HTTPS.