> For the complete documentation index, see [llms.txt](https://klipper.3dwork.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://klipper.3dwork.io/klipper/instalacion/klipper-en-orange-pi-zero-plus.md).

# Klipper en Orange Pi Zero Plus

Klipper es un sistema extremadamente flexible que puede correr un múltiples dispositivos y uno de ellos pueden ser una Orange Pi Zero Plus.

## Orange Pi Zero Plus

La Orange Pi Zero Plus es un SBC (Single Board Computer) que pese a que en su nombre parezca equivaler a una Raspberry Pi Zero no lo es dado que usa un diseño y medidas totalmente diferente además de diferencias a nivel de electrónica como su MCU.

<figure><img src="/files/V02EfVO24fQLjzqlFuUk" alt=""><figcaption></figcaption></figure>

En todo caso y dada la versatilidad de Klipper puede ser una alternativa al uso de Raspberry Pi. A continuación podéis encontrar sus especificaciones:

<figure><img src="/files/xhO6t3ruPPeuC62DBHm5" alt=""><figcaption></figcaption></figure>

## Instalación del OS Armbian

La Orange Pi Zero Plus dispone de su propia distribución del sistema operativo llamado [Armbian y que podéis descargar desde aquí](https://www.armbian.com/orange-pi-zero-plus/). En todo caso en nuestro ejemplo [usamos una variante de este (Jammy) que podéis descargar su última versión desde aquí](https://redirect.armbian.com/orangepizeroplus/Jammy_current).

Una vez que ya tenemos descargada nuestra imagen y usando [Raspberry Pi Imager](https://www.raspberrypi.com/software/) la aplicaremos a nuestra SD:

<figure><img src="/files/tUDs7k0jIh0sJT0KXT9Q" alt=""><figcaption></figcaption></figure>

Al cabo de unos minutos y si todo ha ido correctamente ya tendremos nuestra SD preparada con el OS. Procederemos a instalar la SD en el lector de nuestra Orange Pi Zero Plus y la alimentaremos desde un cable USB desde nuestro ordenador para que arranque.

Pasados unos minutos nuestro ordenador debería disponer de un nuevo puerto COM:

<figure><img src="/files/D3Q4ZZzT8nyNe3Lx20fl" alt=""><figcaption></figcaption></figure>

Ahora abriremos [**PuTTY**](https://www.putty.org/) o cualquier otro cliente terminal y configuraremos una nueva conexión Serial usando el COM detectado anteriormente:

<figure><img src="/files/OQQk9vc0e42Jx6ZZC7aY" alt=""><figcaption></figcaption></figure>

Una vez conectados lo primero que nos solicitará será la **configuración del password del usuario root** y seguidamente el **sistema de comandos que elegiremos BASH y posteriormente configurar un usario, en nuestro caso es importante que se llame pi, y el password del usuario pi**:

{% hint style="warning" %}
**Es importante que creemos un usuario pi ya que de no hacerlo algunos procesos que seguiremos más adelante pueden no funcionar correctamente.**
{% endhint %}

<figure><img src="/files/djwzJ67N0VrlHoseT2jq" alt=""><figcaption></figcaption></figure>

El siguiente paso será un asistente para la configuración de nuestra red tanto cableada como WiFi:

<figure><img src="/files/EO7L3fpr5o0V1mdtMDmX" alt=""><figcaption></figcaption></figure>

Como último paso tendremos que seleccionar nuestra configuración de idioma:

<figure><img src="/files/V1MhvlUeQGGum7qTMmgv" alt=""><figcaption></figcaption></figure>

## Instalando Klipper en nuestra Orange Pi Zero Plus

Ahora que ya tenemos el sistema base en nuestra Orange Pi Zero Plus comenzaremos a instalar Kiauh:

```
sudo apt-get install git -y
su pi
cd ~
git clone https://github.com/th33xitus/kiauh.git
cd kiauh
chmod +x kiauh.sh scripts/*
./kiauh.sh
```

{% hint style="info" %}
Con estos comandos hacemos...

* Instalamos git para la gestión de repositorios
* Cambiaremos el usuario de root a pi
* 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`
{% endhint %}

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

![](/files/-MXc9jJ34k3tY72wl0wC)

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

![](/files/-MXcAMHvEpQSFCFNWIks)

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

![](/files/-MXcAxgaZBvUd5PAx74G)

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

![](/files/LAYfiDramUOCjWoyGaKA)

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.

Para acceder a nuestra interfaz verificaremos su IP además de que se conectó nuestra Orange correctamente a nuestra red usando el comando ifconfig:

<figure><img src="/files/OpGTeoRat6gzK1LU8j8M" alt=""><figcaption></figcaption></figure>

Ahora que ya tenemos identificada nuestra IP iremos a nuestro navegador y accederemos a nuestra UI:

<figure><img src="/files/rwPhU6fnz7Xds7Q2g8aw" alt=""><figcaption></figcaption></figure>

Ahora como siguiente paso deberíamos obtener el serial-id de nuestra electrónica y generar el firmware Klipper para poder aplicarlo y controlar la electrónica, tenéis información del proceso [**aquí**](/klipper/instalacion.md#creando-nuestro-firmware-klipper).
