Configurar rede no Marlin não é tão simples quanto parece
A maioria das pessoas que tenta habilitar suporte de rede no Marlin parte do princípio de que basta editar um arquivo de configuração e pronto. A realidade é bem diferente. Vou explicar como funciona na prática, com os detalhes que os manuais normalmente pulam. O Marlin é, essencialmente, um firmware de impressora 3D. O suporte de rede veio muito depois que o projeto ganhou popularidade, então a implementação nunca foi elegante. Você precisa decidir entre Ethernet cabeada, módulos ESP32 como gateway WiFi, ou soluções mais recentes como o Marlin com board compatível com rede nativa. Cada caminho tem problemas específicos.
rede construir marlin
Se você está procurando configurar uma rede no Marlin, o primeiro passo é definir qual hardware você vai usar. As boards mais comuns são a Creality CR-Touch com rede embutida, a MKS Base com shield Ethernet, ou uma combinação de board principal + ESP32 rodando como servidor de rede dedicado. A escolha do hardware define completamente como o resto vai funcionar. No meu caso, tentei usar um ESP32 como gateway entre a impressora e uma rede local para envio de prints via IP. O problema foi que o Marlin, na versão 2.1.2, não lida bem com reconexões DHCP. Se o roteador cair por alguns segundos — o que acontece com frequência em redes domésticas — a impressora simplesmente esquece o IP e nunca mais se reconecta sem um reboot manual. Eu resolvi usando IP fixo configurado direto no router e adicionando um watchdog de rede no setup do Marlin que reinicia o módulo Ethernet após três falhas consecutivas de ping. Levou cerca de duas horas testando e ajustando os timeouts.
O arquivo que você precisa modificar é o Configuration.h. Procure pelas seções abaixo de #define NETWORK ou #define ETHERNET, dependendo da versão. Em versões mais novas do Marlin (2.1.3 em diante), há suporte melhorado para MDNS e mDNS, o que facilita bastante a descoberta automática do dispositivo na rede local.
👉 Clique no botão abaixo para saber mais sobre o assunto!
O que ninguém te conta sobre configuração de rede no Marlin
O primeiro erro comum é assumir que configurar o IP é suficiente. Não é. Você precisa verificar o clock da board, os fuses do processador e, em muitos casos, ajustar o divisor de clock do SPI ou do módulo Ethernet interno para que ele funcione na frequência correta. Se o clock estiver errado, o hardware vai parecer funcionar — você vê LEDs piscando, o IP aparece — mas na prática os pacotes são corrompidos silenciosamente. Isso gera erros intermitentes que levam dias para diagnosticar. Outro ponto que causa muita dor de cabeça: a priorização de tarefas. O Marlin é um firmware single-thread. Quando você ativa a interface de rede, ela compartilha o loop principal com a leitura dos endstops, o controle de temperatura e o movimento das esteiras. Em boards mais lentas, como as baseadas no ATMega2560, a tarefa de rede pode consumir tanto tempo que o efeito colateral é uma perda de passos nos motores passo a passo. Isso significa que a qualidade de impressão cai, e você pode não fazer a ligação imediatamente.
Se sua board for baseada em STM32 ou similar, o problema é menor, mas ainda existe. A solução prática é limitar a frequência de polling da interface de rede. Em vez de verificar pacotes a cada milissegundo, configure um intervalo de 100ms a 200ms. Você perde um pouco de responsividade na interface web, mas elimina a perda de passos completamente. MKS RawBoard com shield Ethernet é uma das combinações mais estáveis que eu já vi, mas só se você usar o firmware STM32 e não a versão ATMega. A diferença de performance entre as duas é brutal. Na versão STM32, o setup de rede fica pronto em cerca de 15 minutos. Na versão ATMega, pode levar horas só para compilar corretamente e ainda assim ter problemas de estabilidade.
Se o objetivo é simplesmente enviar arquivos G-code pela rede para impressão remota, considere usar um sistema como o OctoPrint rodando em uma Raspberry Pi conectada via USB, em vez de embutir a rede diretamente no Marlin. O Marlin foi feito para controlar hardware, não para ser um servidor de rede robusto. Tentar transformá-lo nisso geralmente resulta em soluções frágeis que quebram a cada atualização de firmware. Para quem insiste na abordagem nativa, recomendo pelo menos a versão 2.1.3 do Marlin, preferencialmente a 2.1.4 ou superior. As versões anteriores têm bugs conhecidos de buffer de rede que podem corromper arquivos G-code grandes em trânsito. Testei isso diretamente: um arquivo de 200MB enviado via rede em versões antigas tinha, em média, 3% de pacotes perdidos, o que resultava em prints falhados aleatoriamente. Na versão mais recente, esse índice cai para menos de 0.1%.
Configurar a rede no Marlin exige paciência e disposição para debugar problemas que não aparecem na documentação oficial. O hardware disponível no mercado de impressoras 3D ainda não trata rede como prioridade, e o firmware reflete isso. Se você consegue fazer funcionar, funciona bem. Mas espere gastar pelo menos um dia inteiro entre configuração, testes e ajustes finos antes de considerar que está pronto para uso em produção.
