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:

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

  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)

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

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

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.

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.

Última actualización