A porta não está listada

O que você vê

Você clica em Atualizar no seletor de portas e a lista não inclui sua máquina. Talvez outras portas apareçam, talvez nenhuma.

O que está acontecendo

O Beam Bench solicita ao sistema operacional as portas seriais disponíveis. O sistema operacional só lista as portas que consegue detectar, o que exige um driver funcional e um dispositivo conectado. Se a porta estiver ausente aqui, o sistema operacional também não a detecta.

Correção

Se a máquina estiver desligada ou desconectada

Óbvio, mas vale verificar. Conecte-a, ligue-a e clique em Atualizar.

Se o cabo for apenas para carregamento

Alguns cabos USB (especialmente os curtos que vêm em kits de carregadores) só transmitem energia, não dados. Troque-o por um cabo USB de dados comprovadamente funcional.

Se o driver estiver ausente (Windows)

Na maioria dos lasers de diodo e pequenos lasers de CO2, o chip USB-serial é CH340 ou CP210x. O driver não vem instalado no Windows por padrão.

• Abra o Gerenciador de Dispositivos.
• Se você vir "USB Serial" ou "Dispositivo desconhecido" com um aviso, precisa de um driver.
• Baixe o driver CH340 (pesquise por "CH340 driver Windows") ou o driver CP210x (driver Silicon Labs CP210x VCP) e instale-o.
• Após a instalação, desconecte e reconecte a máquina. A porta deverá aparecer agora.

Consulte problemas de driver no Windows.

Se a permissão for negada (Linux)

A porta pode existir, mas estar invisível para o seu usuário. Adicione-se ao grupo dialout:

sudo usermod -aG dialout $USER

Saia da sessão e entre novamente. A porta deverá aparecer agora.

Consulte permissões de porta serial no Linux.

Se "Mostrar todas as portas" puder ajudar

A aba Conexão de Configurações do dispositivo tem uma caixa de seleção Mostrar todas as portas quando algumas portas estão ocultas por filtro. Tente usá-la.

Se o macOS solicitou permissão

Algumas versões do macOS solicitam acesso à porta serial. Verifique em Ajustes do Sistema → Privacidade e Segurança se há uma solicitação do Beam Bench e aprove-a.

Verifique se a porta existe no nível do sistema operacional

Se o Beam Bench não a detectar, mas o sistema operacional sim, isso é um bug do Beam Bench; envie um relatório.

• macOS / Linux:

  ls /dev/cu.* /dev/tty.* /dev/ttyUSB* /dev/ttyACM*

• Windows: Gerenciador de Dispositivos → Portas (COM & LPT).

Se o sistema operacional também não a detectar, o problema é o cabo / driver / hardware, não o Beam Bench.

Ainda não conseguiu resolver?

• Painel de Diagnóstico de Conexão: mostra o que o Beam Bench detectou.
• problemas de driver no Windows.
• permissões de porta serial no Linux.
• Publique no grupo do Facebook informando o sistema operacional, a marca/modelo da máquina e o que o Gerenciador de Dispositivos / ls /dev/... mostra.