KlipperXL: rode Klipper na Prusa XL sem tocar nos cabeçotes

A Prusa XL é uma das poucas toolchanger acessíveis do mercado, e até este ano ela vinha trancada no firmware fechado da própria Prusa. Em fevereiro de 2026, um desenvolvedor chamado Richard Crook soltou no GitHub o KlipperXL: um projeto que troca esse firmware pelo Klipper e comanda os cinco cabeçotes da impressora sem alterar uma linha do código dos toolheads.

É open source, licença GPLv3, e fala com os cinco Dwarf pelo mesmo protocolo MODBUS que a placa XLBuddy já usa de fábrica. O site alemão de notícias 3D 3druck noticiou o lançamento como a primeira substituição completa de firmware Klipper para a XL. Pra quem já vive no ecossistema Klipper, isso resolve um incômodo antigo de uma vez.

O que muda quando você troca o firmware

O firmware de fábrica da Prusa XL é controlado pela tela de 3,5 polegadas e pelo PrusaConnect, e esconde quase todos os parâmetros do usuário. O Klipper inverte essa lógica: joga o processamento pesado pra um computador externo (um Raspberry Pi) e deixa o microcontrolador só com o trabalho de tempo real. Como diz a própria documentação do Klipper, o firmware "combina o poder de um computador de uso geral com um ou mais microcontroladores".

Na prática, a telinha sai e entra uma interface de navegador: Mainsail ou Fluidd. Tudo passa a viver num arquivo de texto, o printer.cfg, com ajuste fino de aceleração, pressure advance, malha de mesa e macros que a interface da Prusa simplesmente não expõe.

Esse é o tradeoff de fundo, e vale dizer logo: você troca uma máquina que "só funciona" por uma que você precisa configurar. Quem nunca abriu um printer.cfg vai sentir o degrau.

Como o KlipperXL fala com os cinco cabeçotes

Aqui está o truque que faz o projeto existir. A Prusa XL usa uma placa principal chamada XLBuddy, com um chip STM32F407. O KlipperXL grava um Klipper customizado nessa placa e a transforma num mestre MODBUS RTU, que conversa com os cabeçotes Dwarf por uma linha RS485 a 230400 baud, exatamente como a Prusa faz internamente.

Do lado do Raspberry Pi (modelo 4 ou 5), um módulo Python chamado puppy_bootloader.py cuida da lógica fina: sequência de boot dos cabeçotes, troca de ferramenta, gerência de aquecedores, sondagem por célula de carga e calibração.

O detalhe que evita dor de cabeça é que os Dwarf continuam rodando o firmware Prusa de fábrica, sem nenhuma modificação. Segundo o repositório, "os cabeçotes Dwarf rodam firmware Prusa de fábrica, sem modificações". O KlipperXL só fala o protocolo que eles já entendem. Isso reduz o risco e mantém a troca de ferramenta na mesma sequência de doca (pegar, parquear, sacudir pra reencaixar) da máquina original.

Por baixo, o que torna tudo isso viável é um recurso nativo do Klipper: ele já sabe coordenar vários microcontroladores ao mesmo tempo, com endstop num MCU e motor em outro. KlipperXL leva esse conceito ao extremo, tratando cada Dwarf como um nó de sensores (acelerômetro e célula de carga) pendurado no barramento da XLBuddy.

O controle fino que você ganha

O ponto de migrar pra Klipper não é a interface bonita. É o nível de ajuste que vem junto, e que o firmware de fábrica tranca.

O input shaper roda por ferramenta, usando o acelerômetro embutido em cada Dwarf. Os valores que o autor publicou de uma XL de cinco cabeçotes servem de ponto de partida: EI a 60,2 Hz no eixo X, MZV a 23,0 Hz no eixo Y, com pressure advance de 0,025 e fluxo volumétrico máximo de 10 mm³/s em PLA a 215 °C. São números calibrados numa máquina específica, não garantia universal, mas economizam horas de tentativa e erro.

A sondagem de Z usa a célula de carga do próprio Dwarf, e a malha de mesa é adaptativa: mede só a área onde a peça vai ficar, não a mesa inteira. A mesa modular de 16 zonas (uma grade 4x4) ganha aquecimento adaptativo, que esquenta apenas os ladrilhos sob a peça e aplica um gradiente nas zonas vizinhas pra reduzir empeno.

Tem ainda recursos que poupam material. O spool join continua a impressão com outra ferramenta quando o filamento de uma acaba, remapeando os comandos na hora. E, pra quem gosta de afinar máquina, um LED estroboscópio na fita lateral, de 60 a 130 Hz, deixa visível a tensão de correia e a vibração fina enquanto a impressora trabalha.

O preço de abrir o firmware (e os limites)

Nada disso é de graça em termos de risco, e a máquina por baixo não é barata. A página oficial da Prusa lista a versão de um cabeçote por US$ 2.128,70, com volume de 360x360x360 mm e eletrônica xBuddy de 32 bits sobre STM32. A mesma página anuncia "uma redução de preço de até US$ 200 em 2026". Convertido e com importação, é fácil passar de R$ 15 mil na porta no Brasil, então mexer no firmware dela pede cabeça fria.

O aviso do repositório é direto: o software é fornecido "como está", sem garantia, e substituir o firmware de fábrica pode anular a garantia da impressora. O autor não se responsabiliza por dano nenhum.

Vale ler o estágio do projeto antes de gravar qualquer coisa. No momento desta análise, o KlipperXL somava 16 estrelas, 3 forks e 59 commits no GitHub, sem nenhum release oficial empacotado. É um projeto vivo e bem documentado, mas jovem, e esses números devem ter mudado quando você ler isto.

Dois limites de segurança merecem atenção. Pra gravar o firmware, a XLBuddy precisa entrar em modo DFU por um jumper físico na placa. E há travas no software: o teto de aceleração da Prusa XL é de 7000 mm/s², que o projeto recomenda nunca ultrapassar, e a mesa modular tem temperatura máxima de 120 °C imposta por código. O autor reforça uma regra de bancada que evita acidente: Z para mais desce a mesa (seguro), Z para menos sobe a mesa (risco de colisão com o bico).

Pra quem isso faz sentido

KlipperXL não é pra quem quer só apertar imprimir e sair de perto. O firmware da Prusa é dos mais polidos do mercado justamente porque esconde essa complexidade toda.

Faz sentido pra quem já vive no ecossistema Klipper, costuma rodar Voron ou outras máquinas sob Mainsail, e quer trazer o toolchanger da Prusa pra dentro desse fluxo: mesma interface, mesmos macros, mesmo controle por arquivo. A troca é clara. Você ganha controle e perde o suporte oficial e a rede de segurança do firmware de fábrica.

É também um lembrete de por que hardware com protocolo legível importa. O projeto só foi possível porque alguém entendeu o MODBUS que a Prusa usa entre placa e cabeçotes. Máquina aberta vira plataforma. Máquina trancada vira beco sem saída.

Perguntas frequentes

O KlipperXL é um produto oficial da Prusa?

Não. É um projeto independente, de Richard Crook (usuário racoutlaw no GitHub), distribuído sob licença GPLv3. A Prusa não dá suporte a ele.

Preciso modificar os cabeçotes Dwarf?

Não. Os Dwarf continuam com o firmware Prusa de fábrica. O KlipperXL conversa com eles pelo mesmo protocolo MODBUS que a própria Prusa usa internamente.

Funciona com menos de cinco ferramentas?

Sim. O projeto suporta a Prusa XL com qualquer número de cabeçotes, de 1 a 5.

Mexer nisso anula a garantia?

Pode anular. O projeto avisa que substitui o firmware de fábrica e que você assume todo o risco. Pense bem antes de fazer numa máquina nova.

Que hardware extra eu preciso?

Um Raspberry Pi 4 ou 5 pra rodar o módulo host em Python, além da XLBuddy com STM32F407 que já vem na impressora.

Dá pra voltar ao firmware da Prusa depois?

O repositório inclui um procedimento de recuperação por DFU pra reverter uma XLBuddy travada, mas é manual e por sua conta e risco.

Em que pé está o projeto?

Jovem e em desenvolvimento ativo. Foi lançado em fevereiro de 2026 e, no momento desta análise, ainda não tinha um release empacotado, só o código no repositório.

Onde ir agora

Se firmware aberto e ajuste fino de impressora é o seu tipo de assunto, vale entender os conceitos por trás disso antes de gravar qualquer coisa. Pressure advance, input shaper e malha de mesa aparecem em quase toda máquina moderna, da mais barata à XL. Comece pela nossa base de conhecimento sobre impressão 3D e chegue na bancada sabendo o que cada ajuste faz.