Klipper: o firmware que transfere a matemática para um computador

A arquitetura diferente do Klipper

Um firmware tradicional de impressora 3D, como o Marlin, roda inteiramente no microcontrolador da placa principal, um chip bastante fraco, feito para acionar motores e não para executar cálculos pesados. O Klipper muda esse arranjo: segundo a documentação oficial do projeto, os cálculos de trajetória e cinemática acontecem em um computador separado, geralmente um Raspberry Pi ou uma placa equivalente, que então envia comandos precisos ao microcontrolador, cuja única função é executá-los com, segundo essa mesma documentação, uma precisão de 25 microssegundos ou melhor.

Transferir a matemática para um computador mais potente permite trajetórias mais complexas sem sobrecarregar o microcontrolador, o que abre caminho para velocidades e acelerações maiores do que as de um firmware que faz tudo localmente, em um hardware idêntico. O Klipper continua sendo um software gratuito e de código aberto, lançado sob a licença GNU GPL v3 e disponível no repositório do projeto no GitHub, onde a comunidade de colaboradores mantém o código e a documentação.

Essa divisão tem uma contrapartida: o Klipper depende de um computador auxiliar em funcionamento, ao contrário de um firmware autônomo como o Marlin, que roda inteiramente na placa principal. Uma queda de energia ou um computador auxiliar mal alimentado pode interromper uma impressão de um jeito diferente de um firmware puramente embarcado, algo a ter em mente ao montar todo o conjunto.

Input shaping e pressure advance: os dois principais recursos

O input shaping compensa a ressonância mecânica: ele mede ou estima as frequências naturais da estrutura da impressora e então ajusta os comandos dos motores para reduzir o ringing (as ondas tênues visíveis perto de um canto agudo) e o ghosting causados pela vibração. Esse recurso, descrito na documentação do Klipper em Resonance Compensation, é um dos motivos mais citados por quem migra para esse firmware.

O pressure advance ajusta a pressão do material dentro do bico antecipando as mudanças de velocidade, reduzindo o escorrimento no início e no fim de um segmento de extrusão, o que aparece principalmente em cantos e detalhes finos. Os dois recursos são calibrados separadamente, geralmente por meio de impressões de teste, e um slicer compatível como o OrcaSlicer traz ferramentas dedicadas para executar essas calibrações sem mexer em um console de linha de comando.

Quais impressoras saem de fábrica com Klipper

Vários fabricantes agora instalam o Klipper por padrão, em vez de deixar a conversão por conta do comprador. A Creality K1 roda uma versão do Klipper adaptada pela Creality, com o código publicado em um repositório dedicado do projeto. A Sovol SV08, derivada da arquitetura Voron, também roda Klipper de fábrica, com o firmware e o código-fonte publicados pela Sovol.

A QIDI Q1 Pro também roda Klipper, com um fork do Klipper e um servidor Moonraker mantidos pela QIDI, segundo as páginas oficiais da empresa no GitHub. Segundo a página de produto da Elegoo, a Neptune 4 vem com o Klipper pré-instalado em uma placa ARM de 64 bits, ilustrando uma tendência mais ampla do mercado de entregar o Klipper nativamente em vez de tratá-lo como uma conversão reservada a usuários avançados.

Klipper de fábrica vs. conversão: o que muda

Uma impressora que já vem com Klipper chega configurada pelo fabricante, com perfis e uma interface feitos sob medida para aquele modelo, dispensando a etapa de configuração manual do printer.cfg. Uma conversão, por outro lado, significa instalar o Klipper por conta própria em uma impressora originalmente projetada para Marlin, o que envolve configurar pinos, sensores e cinemática manualmente a partir de um arquivo de configuração existente ou de um exemplo semelhante.

As versões do Klipper instaladas de fábrica às vezes são modificadas, bloqueadas ou ficam atrás da branch principal do projeto, um ponto levantado pela comunidade em torno de várias máquinas de consumo. Migrar para uma versão mais próxima do repositório oficial do projeto é possível em muitas dessas impressoras, mas dá mais trabalho do que uma simples atualização pela tela da impressora.

Para quem compra a primeira impressora, isso importa principalmente na hora de escolher o modelo: uma máquina que já vem com Klipper elimina essa questão no início, deixando a migração para uma versão mais recente para depois, quando o básico da calibração já for natural.

Vários microcontroladores, macros e um arquivo de configuração: o que a arquitetura permite além da velocidade

A documentação oficial do Klipper lista recursos que recebem menos atenção que o input shaping, mas moldam a experiência na mesma medida. Uma impressora pode ser controlada por vários microcontroladores, um para a extrusora, outro para os aquecedores, um terceiro para todo o resto, com o software host sincronizando os relógios deles: bastam algumas linhas extras no arquivo de configuração, e é por isso que máquinas recentes conseguem operar um cabeçote com um único cabo.

Toda a configuração fica em um arquivo de texto, sem necessidade de regravar o microcontrolador para alterar uma configuração, e esse mesmo arquivo aceita macros programáveis: novos comandos G-code definidos pelo usuário, cujo comportamento pode depender do estado da impressora. A documentação também menciona um servidor de API JSON integrado, sobre o qual interfaces web e aplicativos de terceiros são construídos.

Quanto ao desempenho, o projeto afirma que até um microcontrolador antigo de 8 bits ultrapassa 175,000 passos por segundo e que microcontroladores recentes chegam a vários milhões, com cada passo ainda agendado com precisão de 25 microssegundos. O código é descrito como independente de hardware e portável entre chips ARM, AVR e PRU, o que permite manter a placa principal de uma impressora existente e acrescentar apenas um computador auxiliar, como destaca o nosso guia sobre tipos de impressoras 3D.

Mainsail e Fluidd: rodando o Klipper pelo navegador

O Klipper não tem tela nem interface gráfica integrada: ele depende do Moonraker, uma API que expõe suas funções, e de uma interface web como Mainsail ou Fluidd para operar a impressora pelo navegador. Essas interfaces mostram a imagem da câmera, se houver uma instalada, os ajustes de temperatura, a lista de arquivos G-code e dão acesso a macros e a calibrações específicas do Klipper.

Em uma impressora que já sai de fábrica com Klipper, a tela sensível ao toque integrada costuma espelhar parte dessas funções em uma interface simplificada e própria da marca, enquanto Mainsail ou Fluidd continuam disponíveis em paralelo a partir de um computador ou celular na mesma rede, o que é prático para acompanhar uma impressão sem ficar ao lado da máquina.

O que saber antes de converter uma impressora existente

Instalar o Klipper em uma impressora feita para Marlin exige um computador auxiliar (um Raspberry Pi ou equivalente), uma placa principal compatível com o firmware de microcontrolador do Klipper e um arquivo de configuração correspondente àquele modelo específico, normalmente encontrado entre os exemplos que acompanham o projeto ou compartilhado pela comunidade. É uma mudança mais profunda no funcionamento da máquina do que uma simples atualização de firmware.

Uma conversão não oficial quase sempre foge do uso previsto pelo fabricante e pode afetar a garantia, algo que vale confirmar com o suporte antes de começar. Para uma primeira impressora, escolher um modelo que já vem com Klipper configurado elimina essa etapa e seus riscos, ao custo de uma seleção mais restrita do que todo o mercado de Marlin.

Fontes e limites

• Klipper — Visão geral (arquitetura host + microcontrolador)
• Klipper — Recursos (input shaper, pressure advance)
• GitHub — Klipper3d/klipper (repositório principal, licença)
• GitHub — CrealityOfficial/K1_Series_Klipper (firmware da Creality K1)
• Elegoo — Impressora 3D FDM Neptune 4 (Klipper pré-instalado)

Organizamos a documentação de fabricantes e da comunidade; não medimos esses produtos nós mesmos. O manual do seu modelo exato tem prioridade sobre as orientações gerais.