For the complete documentation index, see llms.txt. This page is also available as Markdown.

Instalación


Instalación

English: Use your browser's built-in translation — Chrome and Edge detect the language automatically and offer to translate the page.

¿Qué necesitamos?

  • Raspberry Pi o cualquier host que pueda correr Linux, normalmente se aconseja Raspberry Pi dado que la mayoría de distribuciones y herramientas son totalmente compatibles con ellas y en otros dispositivos se ha de realizar una instalación manual e incluso adaptar algunas partes.

  • SD, aconsejable que sea rápida y con espacio suficiente para almacenar el sistema y archivos gcode normalmente entre 16-64Gb que sea de Class 10 (velocidad).

  • Cable conexión entre nuestra Pi y nuestra electrónica/impresora, ya sea USB que es lo más normal o vamos a conectar usando USART u otro tipo de conexión como CAN disponer del cable correspondiente en cada caso. Es importante que este cable sea de la mayor calidad y que este quede correctamente conectado/fijado entre dispositivos para evitar que las vibraciones o movimientos de nuestra máquina puedan afectar a la conexión.

Guías para hosts alternativos

Además de Raspberry Pi, Klipper puede instalarse en otros dispositivos. Tenemos guías específicas para:

Antes de comenzar!!!

Por favor entiende que instalar Klipper en tu impresora require de cierta experiencia con impresoras 3d, hardware y software. Puede no ser una tarea trivial para gente que se acaba de iniciar en el mundo 3D o que no dispone de unos mínimos conocimientos ya que puedes romper tu impresora o pi durante el proceso

Lee antes la guía completa y entiende todos los pasos que explicamos. Si tienes cualquier duda del proceso por favor te aconsejamos unirte al grupo de Telegram https://t.me/Klipper_Firmware_ES donde seguro te echaran una mano.

Instalando Klipper usando imágenes preconfiguradas para Raspberry Pi

Aunque os mostraremos como instalar el sistema usando un sistema base de Raspberry también disponemos de distribuciones de Klipper con todo preinstalado que suele ser la alternativa más sencilla y rápida para tener nuestro Klipper montado en especial para usuarios sin experiencia en Linux o Klipper.

Principalmente contamos con varias distribuciones: MainsailOS especialmente indicada para usuarios que comienzan con Klipper, FluiddOS como alternativa a MainsailOS con interfaz Fluidd, y RatOS para usuarios más experimentados que quieran sacar provecho de su configuración modular y macros avanzadas.

Os aconsejamos instalar como complemente a cualquier distribución/imagen de Klipper que os sugerimos a continuación que os instaléis Kiauh ya que añade una serie de ayudas extras interesantes.

Una de las opciones es usar la distribución de Mainsail llamada MainsailOS:

  1. Descargaremos la última versión de MainsailOS desde aquí desde el apartado Assets que deberemos desplegar o hacer mostrar todos los que existen. Disponemos de soporte para basados en Raspberry y Armbian (OrangePi) que podemos identificar por el nombre fácilmente.

DESCARGA DE LA IMAGEN DESDE RASPBERRY PI IMAGER DIRECTAMENTE: En el caso que utilicemos Raspberry Pi Imager directamente desde sus opciones podremos elegir que se descargue MainsailOS desde la opción CHOOSE OS:

  1. Descomprimiremos el zip donde obtendremos un .img

  2. Utilizando BalenaEtcher o Raspberry Pi Imager escribiremos .img a nuestra SD (8GB o mayor además de idealmente que sea una SD de alta velocidad)

  • Colocaremos la SD en nuestro host y alimentaremos para que arranque.

  • Si usamos wifi, y no hicimos la configuración de esta en el caso de usar Raspberry Pi Imager, editaremos el fichero mainsailos-wpa-supplicant.txt donde añadiremos la información de nuestra red wifi.

  • Una vez todo iniciado comprobaremos que podemos acceder al interfaz web de Klipper, cuando encontremos la IP asignada de nuestra red a nuestro host, ya podremos conectar nuestra impresora a nuestro host.

Firmware Klipper manualmente

Una vez ya tenemos nuestro OS instalado y con Klipper, Moonraker y la interfaz que más nos guste instalada, es hora de pasar a crear nuestro firmware Klipper.

Ya que hemos Klipper este nos va a permitir de una forma muy sencilla a los diferentes pasos para realizar el proceso.

Creando el firmware

Para poder generar nuestro firmware Klipper manualmente:

  • Nos aseguraremos que tenemos instala la utilidad make

  • Una vez instalado make nos iremos a la carpeta klipper y lanzaremos el configurador para nuestro firmware

  • Configuraremos las opciones necesarias para nuestra electrónica, usando la tecla Q para salir del configurador y Y para guardar los cambios. Ej. SKR Mini E3 v3 aunque más abajo tenéis más ejemplos

  • Una vez ya tenemos la configuración de nuestra electrónica lista lanzaremos el proceso make para que se compile nuestro firmware:

  • Aplicaremos el firmware creado dependiendo de nuestra electrónica. En electrónicas modernas de 32b se suele copiar el firmware generado (por ejemplo con Filezilla y generando una conexión SFTP) .../out/klipper.bin a nuestro ordenador y de ahí a la SD con el nombre que sea necesario para nuestra electronica... para electrónicas SKR suele ser firmware.bin y para ver que se aplicó correctamente debería de cambiar a firmware.cur.

En determinados casos podremos actualizar la electrónica directamente por USB/USART:

Lanzaremos el comando ls para listar nuestra electrónica:

ls /dev/serial/by-id/*

Deberiamos obtener algo como...

/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0

Y utilizaremos ese identificador serial o serial ID para lanzar el comando flash:

sudo service klipper stop

make flash FLASH_DEVICE=/dev/serial/by-id/usb-1a86_USB2.0-Serial-if00-port0

sudo service klipper start

Os facilitamos la configuración para las electrónicas que hemos probado:

El repositorio oficial de Klipper incluye configuraciones para una amplia variedad de electrónicas y modelos de impresora. Entre ellos encontraréis:

  • BTT/SKR: generic-bigtreetech-*.cfg — SKR Mini E3, SKR Pico, Octopus, Manta, EBB CAN...

  • FYSETC: generic-fysetc-*.cfg — Spider, Cheetah, S6...

  • MKS: generic-mks-*.cfg — Robin Nano, Monster8, Rumba32...

  • Creality: printer-creality-*.cfg — Ender 3 y variantes, CR-10, Ender 5, CR-6 SE...

  • Elegoo: printer-elegoo-neptune2-2021.cfg, printer-elegoo-neptune3-pro-2023.cfg

  • Anycubic: printer-anycubic-*.cfg — Kobra Go, Kobra Plus, Vyper, i3 Mega, 4Max...

Firmware Klipper pre-generado desde Auto Builder 3Dwork

También contamos con un sistema de auto builder de firmware Klipper basado en nuestro bundle que compila, para las electrónicas soportadas, para diferentes electrónicas de forma diaria.

Del siguiente listado haremos click en nuestra electrónica y nos descargaremos el firmware Klipper compilado a aplicar en nuestra electrónica siguiendo las instrucciones del fabricante!!!

Katapult — Actualización de firmware sin SD

Katapult (antes CanBoot) es un bootloader para microcontroladores que permite actualizar el firmware Klipper directamente desde el host sin necesidad de extraer la SD ni usar DFU. Es especialmente útil para electrónicas con conexión CAN bus o USB.

¿Cuándo usar Katapult?

  • Electrónicas conectadas por CAN bus (EBB, U2C, etc.) — es prácticamente obligatorio

  • Cualquier electrónica donde quieras evitar sacar la SD para cada actualización

  • Setups con múltiples MCUs (placa principal + cabezal CAN)

Instalación básica

Después de compilar, el bootloader se aplica por DFU una única vez. Las actualizaciones posteriores se hacen desde el host:

Consulta la documentación oficial de Katapult y las guías específicas de tu electrónica para los parámetros correctos de menuconfig. Los ajustes varían según el modelo y la frecuencia del cristal.

Verificando la conexión

Ahora que tenemos nuestro firmware Klipper en nuestra electrónica procederemos a verificar que tenemos comunicación con ella, un paso previo y necesario antes de continuar con la configuración de Klipper.

Elegiremos el tipo de conexión entre nuestra electrónica y la Pi, normalmente y aconsejable USB:

En el caso que usemos Klipper por los pines GPIO deberemos habilitar la comunicación serial en nuestra pi, para simplificar el proceso teneis aqui unos comandos para que sea más sencillo:

sudo raspi-config nonint do_serial 2

echo dtoverlay=pi3-disable-bt | sudo tee -a /boot/config.txt

sudo reboot

En el caso que no detecte nuestra electrónica deberemos verificar el proceso de aplicar el firmware Klipper o el cableado:

En el este correcto nos listará un dispositivo, es importante anotarse este ya que lo necesitaremos más adelante:

Deberemos copiar lo marcado para usarlo en los ficheros de configuración de Klipper

En el caso que no realicemos el proceso desde Kiauh podemos usar el comando ls /dev/serial/by-id para listar los dispositivos conectados.

Conexión por CAN bus: Si tu electrónica usa CAN en lugar de USB, el dispositivo no aparecerá en /dev/serial/by-id. Para verificar la conexión CAN:

Esto listará los UUIDs de todos los dispositivos CAN detectados en la red. Apunta el UUID de tu electrónica, lo necesitarás en la sección [mcu] de printer.cfg:

Última actualización