Links
Comment on page

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.
  • SD, aconsejable que sea rápida y con espacio suficiente para almacenar el sistema y archivos gcode normalmente entre 16-64Gb
  • 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

MainsailOS

Una de las opciones es usar la distribución de Mainsail llamada MainsailOS:
  1. 1.
    Descargaremos la última versión de MainsailOS desde aquí.
  2. 2.
    Descomprimiremos el zip donde obtendremos un .img
  3. 3.
    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.
Si usamos wifi, editaremos el fichero mainsailos-wpa-supplicant.txt donde añadiremos la información de nuestra red wifi.
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...

RatOS

Al igual que Mainsail RatOS de Ratrig también ha creado una distribución con todo instalado para sus máquinas basado en Mainsail y que sin duda aún sin tener una Ratrig, también tiene soporte por defecto para máquinas Voron y Prusa, las macros que incluyen puede ser una gran base para nuestro Klipper.
  1. 1.
    Descargaremos la última versión de RatOS desde aquí.
  2. 2.
    Descomprimiremos el zip donde obtendremos un .img
  3. 3.
    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.
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:
  1. 1.
    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
  2. 2.
    Verificaremos que nuestro host Klipper arranca y podemos conectarnos por red wifi o cable
  3. 3.
    Habilitaremos SSH y verificaremos que podemos conectar por SSH
  4. 4.
    En el caso que nuestro host Klipper sea una Pi:
    1. 1.
      Ejecutaremos sudo raspi-config
      1. 1.
        Haremos un reset del password por defecto
      2. 2.
        configuraremos el hostname si queremos
  5. 5.
    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:
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

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
cd ~
git clone https://github.com/th33xitus/kiauh.git
cd kiauh
chmod +x kiauh.sh scripts/*
./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.
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

Creando nuestro firmware Klipper

Una vez a tenemos nuestro OS instalado y con Klipper, Moonraker y la interfaz que mas 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

Manualmente
Kiauh
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
Accederemos a Kiauh desde SSH
Elegiremos la opción más adecuada para nuestra placa ya que en ocasiones nos interesará solamente hacer el Build del firmware para después extraerlo, Flash to aplicarlo a nuestra placa si es compatible con el proceso o Build + Flash que realizaría todo el proceso.
IMPORTANTE!!! En el caso de realizar el proceso Build + Flash tenemos que tener en cuenta el método de actualización de nuestra electrónica ya que Kiauh no es siempre compatible o puede dar problemas.
Os facilitamos la configuración para las electrónicas que hemos probado:
Generales Klipper
SKR
FYSETC
MKS
Desde el repositorio de Klipper podéis encontrar muchos ejemplos para diferentes electrónicas.

SKR Octopus PRO

Elegiremos las siguientes opciones dependiendo del procesador/version de nuestra Octopus:

SKR MINI E3 V3

Elegiremos las siguientes opciones dependiendo del procesador/version de nuestra Mini E3 v3:
Una vez tengamos todas las opciones ajustadas pulsaremos q para salir y "Yes" para almacenar la configuración, si lanzamos el proceso desde Kiauh nos realizará directamente el comando make.
Una vez terminado el compilado del firmware podremos encontrar el binario klipper.bin en el directorio /home/pi/klipper/out el cual podremos aplicar directamente por DFU o usando la SD tal como tenemos en nuestra guía.
Elegiremos las siguientes opciones dependiendo del procesador/version de nuestra Spider:
Si tu Spider es posterior al 23/6/2021 elige como Bootloader offset 32KiB bootloader.
Si tu Spider es anterior al 23/6/2021 elige como Bootloader offset 64KiB bootloader.
Una vez tengamos todas las opciones ajustadas pulsaremos q para salir y "Yes" para almacenar la configuracion, si lanzamos el proceso desde Kiauh nos realizará directamente el comando make.
Una vez terminado el compilado del firmware podremos encontrar el binario klipper.bin en el directorio /home/pi/klipper/out el cual podremos aplicar directamente por DFU o usando la SD tal como tenemos en nuestra guía.
MKS cuenta con un repositorio de ejemplos para Klipper que es de agradecer. Podéis encontrarlos en el siguiente link.
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.

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