Instalação

O Rayforge está disponível para Linux e Windows. Escolha sua plataforma abaixo e siga as instruções de instalação.

Selecione seu sistema operacional:

Escolha o método de instalação:

Pacote Snap

O pacote Snap funciona na maioria das distribuições Linux e inclui todas as dependências em um ambiente isolado.

Instalar Rayforge

sudo snap install rayforge

Conceder Permissões (Importante!)

Permissões Necessárias

A versão Snap executa em um ambiente isolado e requer concessão manual de permissões para acesso ao hardware.

Para Acesso à Porta Serial USB:

# Enable experimental hotplug support (one-time setup)
sudo snap set system experimental.hotplug=true

# Connect your laser via USB, then grant access
sudo snap connect rayforge:serial-port

Para Acesso à Câmera:

sudo snap connect rayforge:camera

Verificar Permissões

snap connections rayforge

Procure por serial-port na lista. Se mostrar "connected", você está pronto.

Verificar Instalação

✓

Iniciar Rayforge

Inicie o Rayforge no menu de aplicativos ou terminal. Você verá a janela principal com a área de trabalho e a barra de ferramentas.

✓

Verificar Versão

Verifique Ajuda - Sobre para confirmar a versão instalada.

✓

Conectar Sua Máquina

Conecte seu controlador de laser via USB e verifique se a porta serial aparece nas configurações de máquina do Rayforge.

dica

No Linux, os controladores de laser geralmente aparecem como /dev/ttyUSB0 ou /dev/ttyACM0.

Solução de Problemas

Problemas de permissão?

Se o seu dispositivo não for detectado, consulte o Guia de Permissões Snap. Guia de Permissões Snap

Porta serial ainda não funciona?

Reconecte o dispositivo USB: Desconecte seu controlador de laser, espere 5 segundos, conecte novamente.
Reiniciar Rayforge: Feche completamente e reinicie.
Verifique se o dispositivo existe:
```
ls -l /dev/ttyUSB* /dev/ttyACM*
```

Reinstale se necessário:

sudo snap remove rayforge
sudo snap install rayforge
sudo snap connect rayforge:serial-port

Precisa de Ajuda?

Para ajuda adicional, relate um problema no GitHub ou entre em nosso Discord. GitHub | Discord

Próximos Passos

Agora que o Rayforge está instalado, prossiga para Configuração Inicial para configurar sua máquina.