Instalación

Que 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.

Si elegimos instalar nuestro host Klipper en una Raspberry Pi, es aconsejable al menos una Raspberry Pi 3B/Zero W 2 o superior.

También es importante que el cargador que alimente esta sea el oficial o uno adecuado para alimentar estos tipos de disposivos.

En otros dispositivos similares como Orange Pi, Odroid, Banana, etc los requerimientos van a ser similares.

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.

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.

No nos hacemos cargo de cualquier daño, problema o fallo que se pueda ocasionar siguiendo estas guías, todos los pasos han sido probados o son las instrucciones de los propios fabricantes/desarrolladores y no deberían de ocasionar fallos.

Se intentan mantener al día pero puede darse el caso que, por actualizaciones, estos pasos puedan variar sin previo aviso.

Estás haciendo estos cambio bajo tu propia responsabilidad!!!

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.

Pricipalmente contamos con dos distribuciones: MainsailOS especialmente indicada para usuarios que comienzan con Klipper, RatOS para usuarios más experimentados en Klipper y que puedan 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.

La selección de la imagen de Raspberry Pi OS 32b o 64b dependerá que nuestra Pi la soporte:

Normalmente la instalación de la versión 32b suele ser más segura aunque actualmente los diferentes componentes de Klipper así como sus dependencias (Python) soportan sin problema entornos de 32/64b

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

Descargaremos la última versión de MainsailOS desde aquí.

En el caso que utilicemos Raspberry Pi Imager directamente desde sus opciones podremos elegir que se descargue MainsailOS desde la opción CHOOSE OS:

Descomprimiremos el zip donde obtendremos un .img
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)

ESTE PROCESO BORRARÁ TODO EL CONTENIDO DE NUESTRA SD.

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.

Una vez tengamos instalado nuestro Klipper os sugerimos continuar con la guía de primeros pasos en Klipper donde veremos como conectarnos al interfaz web, SSH, primeras comprobaciones y ajustes, etc...

Kiauh : Instalando Klipper de forma manual asistida

Kiauh es un grandísimo avance para Klipper. Kiauh permite mediante unos sencillos menus instalar Klipper y sus principales componentes de una forma sencilla:

Instalación de Klipper
Instalar Moonraker (API que permite interactuar con Klipper por terceros como Mailsail, Fluidd o KlipperScreen)
Instalación de diferentes interfaces web como Mailsail, Fluidd, Duet Web Control o Octoprint
Instalar KlipperScreen (un fork de OctoScreen para Klipper)
Actualizar todos los componentes (Octoprint de ser instalado se gestionará directamente desde el mismo)
Eliminar cualquier componente
Hacer un backup del sistema
Preparar el firmware Klipper para nuestra MCU (placa de la impresora)
Detectar el serial donde comunicar con nuestras MCU

Puedes encontrar un listado completo de las características aquí.

Kiauh se hace una herramienta indispensable en el caso que optemos por una distribución Linux que no cuente preinstalados los componentes Klipper.

Preparación de nuestro host Klipper

ESTE PASO ES NECESARIO SI NO HEMOS OPTADO POR UTILIZAR UNA DISTRIBUCIÓN CON TODO INSTALADO COMO LAS ANTERIORES SUGERIDAS.

ESTE PROCESO NO ES ACONSEJABLE PARA USUARIOS SIN UN MINIMO EXPERIENCIA EN LINUX O KLIPPER.

Para poder instalar Klipper debemos preparar nuestro host Klipper. Esta guía no va a entrar en detalle este paso tan solo haremos un listado rápido de los pasos a seguir basados en un host como Raspberry Pi:

Descargaremos una imagen de Raspberry Pi OS Lite y la "quemaremos2 en nuestra SD usando BalenaEtcher o Raspberry Pi Imager. Tienes información detallada de los pasos a seguir aqui. En el caso que no uses una Pi usaremos la imagen del sistema más adecuado a nuestro host

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

Verificaremos que nuestro host Klipper arranca y podemos conectarnos por red wifi o cable
Habilitaremos SSH y verificaremos que podemos conectar por SSH
En el caso que nuestro host Klipper sea una Pi:
1. Ejecutaremos sudo raspi-config
  1. Haremos un reset del password por defecto
  2. configuraremos el hostname si queremos
Ejecutaremos sudo apt-get update y sudo apt-get upgrade para actualizar nuestra pi

La selección de la imagen de Raspberry Pi OS 32b o 64b dependerá que nuestra Pi la soporte:

Instalando Kiauh

Ahora que ya tenemos el sistema base en nuestro host Klipper, esta actualizado y podemos conectarnos por SSH a ella comenzaremos a instalar Kiauh

sudo apt-get install git -y
sudo apt-get update && sudo apt-get install git -y
cd ~ && git clone https://github.com/dw-0/kiauh.git
./kiauh/kiauh.sh

Con estos comandos hacemos...

Instalamos git para la gestión de repositorios
Clonamos el repositorio de Kiauh
Permitimos que los scripts descargados puedan ser ejecutados
Ejecutamos Kiauh

Si necesitamos volver a lanzar Kiauh en el futuro podemos ir a home/pi/kiauh (o el path de instalación elegido) y ejecutar ./kiauh.sh

Una vez hemos realizado el proceso completo y lanzamos Kiauh deveriamos ver un menú como este:

En el caso que vengas de la instalación de una distribución con todo pre-instalado como MainsailOS/RatOS/FluiddOS no es necesario que realices los siguientes pasos de instalación de otros componentes de Klipper ya que estos ya estarán instalados.

Instalando Klipper y Moonraker

Para nuestra guía vamos a usar Klipper que es el core del sistema y Moonraker que va a crear una API para poder gestionar la comunicación entre Klipper.

De las opciones del menú elegiremos la opción 1 para acceder al menú de instalación

Volveremos a elegir la opción 1 y comenzaremos el proceso de instalación:

Eligiremos compilar nuestro firmware
Por ahora no elegiremos actualizar nuestra MCU

Instalando un interfaz para acceder a Klipper

Existen diferentes formas de gestionar Klipper, recomendamos el uso de Mainsail o Fluidd, es posible usar Octoprint también pero creemos que no es la mejor opción salvo casos puntuales ya que es más de uso general y Mainsail/Klipper son desarrollos específicos para Klipper.

La instalación es bastante sencilla y similar a la que realizamos en el punto anterior tan solo seleccionando el interfaz que más nos guste y seguir el asistente/indicaciones.

Es importante comentar que podemos instalar diferentes interfaces siempre y cuando usemos un puerto diferente para cada uno, aquí Kiauh también nos ayuda.

Otra función muy interesante, en este caso de Mainsail, es que podemos usar el interfaz online y dar de alta nuestra impresora sin necesitar nada instalado aunque en ocasiones podemos perder alguna funcionalidad.

Mainsail

Para permitir que my.mainsail.xyz acceda a nuestra instalación local tenemos que permitir en nuestro moonraker.conf añadiendo o revisando que tengamos el siguiente codigo:

[authorization]
cors_domains:
    https://my.mainsail.xyz
    http://my.mainsail.xyz
    http://*.local
trusted_clients:
 10.0.0.0/8
 127.0.0.0/8
 169.254.0.0/16
 172.16.0.0/12
 192.168.0.0/16
 FE80::/10
 ::1/128

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

sudo apt install make

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

 cd ~/klipper
 make clean
 make menuconfig

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:

make

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

Aunque no es un dispositivo que solamos aconsejar, te invitamos a leer esta información que te puede ser interesante, os vamos a dar unas indicaciones para poder generar el firmware Klipper desde este dispositivo para poder añadir impresoras no soportadas por defecto.

Herramientas:

Cliente SSH siempre aconsejamos Terminus por ser multiplataforma, sencillo y no tiene coste para el uso de administrar tus máquinas con Klipper. También dispones de otras como Putty. Tenéis más información sobre qué es SSH aquí.
Utilidad sFTP para transferir ficheros desde la Sonic Pad, os aconsejamos WinSCP o Cyberduck
Acceso root a la Sonic Pad... dentro de los menús de esta... Setup > Advanced Options > Root Access

Pasos a seguir:

Abriremos nuestro cliente SSH (PuTTy) y pondremos la IP así como el nombre y usuario que obtuvimos en la Sonic Pad al activar el acceso root

Escribiremos cd /usr/share/klipper

Lanzaremos el comando make clean para limpiar cualquier configuración previa.

Ahora un make menuconfig

Tendremos un menú donde tendremos que elegir las opciones para nuestra electrónica, normalmente encontramos los parámetros básicos en los cfg de ejemplo que tenemos en el repositorio de Klipper en Github, en la parte inicial de los mismos

Una vez tengamos las opciones pulsaremos Q para salir y Y para guardar los cambios
Ejecutaremos el comando make

Esperaremos unos minutos a que el firmware se acabe de generar, este quedará dentro del directorio/path /out/klipper.bin... la extensión puede depender del modelo de electrónica que hayamos seleccionado

Ahora con el firmware Klipper creado y con el cliente sFTP, WinSCP por ejemplo, utilizando la IP y el usuario/contraseña que usamos para entrar en nuestra Sonic Pad por SSH nos conectaremos a esta e iremos al directorio/path /usr/share/klipper/out/ y descargaremos el firmware a nuestro ordenador
Seguiremos las instrucciones del fabricante de nuestra electrónica para aplicar el firmware a ella.
- en electrónicas de 32b normalmente renombraremos el firmware de klipper.bin a firmware.bin, algunas electrónicas pueden requerir otro nombre o que este no coincida con el último aplicado, colocaremos el fichero en una microSD (con formato FAT32/4096 e idealmente <2GB) y reiniciaremos la electrónica
- en electrónicas de 8b normalmente aplicaremos por USB el firmware desde un laminador como PrusaSlicer o Cura
Si se aplicó todo correctamente podremos pasar al paso siguiente, verificar la conexión entre nuestra Sonic Pad y nuestra electrónica/MCU
Recuerda que para añadir impresoras de terceros has de poner el nuevo printer.cfg en un USB (con formato FAT32/4096) en el conector USB2 (abajo izquierda) y la impresora conectada en el USB1 ajustando el printer.cfg

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

Desde el repositorio de Klipper podéis encontrar muchos ejemplos para diferentes electrónicas.

3Dwork Klipper Bundle:

Desde 3Dwork mantenemos un bundle para Klipper que incluye macros, configuraciones de máquinas, etc... entre ellas damos soporte a diferentes electrónicas que utilizando una macro podemos compilar nuestro firmware Klipper de una forma totalmente automatizada y sencilla.

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.

EL USO DE ESTOS FIRMWARE KLIPPER PRE-GENERADOS SON BAJO VUESTRA PROPIA RESPONSABILIDAD!!! Siempre aconsejamos que cada usuario cree por si mismo su firmware desde su host Klipper.

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!!!

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 firwmare Klipper o el cableado:

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

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

AnteriorKlipper SiguienteMúltiples instancias Klipper

Última actualización hace 9 días