> 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/guias-instalacion-especificas-impresora-electronica/artillery-klipper/sw-x4-pro-plus.md).
# Sidewinder X4 Pro / X4 Plus
## Introducción
La **Artillery Sidewinder X4 Pro** y **X4 Plus** son impresoras 3D FDM con un **sistema completo Linux + Klipper integrado** directamente en la mainboard. No necesitas Raspberry Pi separada — todo funciona dentro de la impresora.
Esta guía es para **todos los niveles**: si nunca usaste SSH o Linux, no te preocupes. Explicaremos cada concepto paso a paso.
{% hint style="info" %}
**Lo mejor:** La mainboard Artillery STM32F407 ejecuta un pequeño sistema Linux + Klipper. Es como tener una computadora dentro de tu impresora.
{% endhint %}
> **Versión firmware base:** Artillery SW4-Pro firmware 1.5.3
>
> **Compatibilidad:** X4 Pro | X4 Plus
***
## Especificaciones Técnicas
### Mainboard & Sistema Integrado
| Componente | Especificación |
| ----------------------- | ----------------------------------------------- |
| **Mainboard** | Artillery Custom (STM32F407 + Linux SoC) |
| **MCU Principal** | STM32F407 (32-bit ARM Cortex-M4, 168 MHz) |
| **Almacenamiento** | eMMC 8GB estándar (upgrading a 32GB disponible) |
| **Red** | WiFi 2.4GHz + Ethernet (RJ45) |
| **Pantalla** | 4.3" LCD táctil integrada |
| **Sistema Operativo** | Linux minimalista (Buildroot) + Klipper |
| **Usuario SSH default** | `mks` / contraseña `makerbase` |
### ¿Qué significa todo esto?
* **STM32F407:** Microcontrolador potente (168 MHz) que controla motores y sensores
* **eMMC 8GB:** Almacenamiento rápido donde vive Linux y Klipper (como SSD pero integrado)
* **WiFi nativo:** Puedes acceder a tu impresora desde cualquier dispositivo en la red
* **Sistema Linux:** Corre un pequeño SO que ejecuta Klipper
* **Usuario SSH:** Acceso remoto por terminal (como controlar impresora por línea de comandos)
### Hardware de Impresión
* **Estructura:** Marco aluminio reforzado (resistente, no se dobla)
* **Plataforma:** 220 x 220 x 250mm (tamaño respetable para gama media)
* **Velocidad:** Hasta 200 mm/s de serie (con Klipper puedes alcanzar 250+ mm/s) — ver [Velocidad Máxima](/klipper/empezamos/velocidad-maxima.md)
* **Extrusor:** Direct Drive (filamento no pasa por tubo, control preciso)
* **Cama:** PEI + resistencia cerámica (calienta rápido, adhesión excelente)
***
## Pinout Mainboard MCU
### Diagrama Pinout Visual
 *Diagrama de pines de la mainboard Artillery. Estos pines controlan todos los componentes (motores, calentadores, ventiladores).*
### Pines Críticos Explicados
Cada pin STM32F407 controla una función específica:
| Función | Pins | ¿Qué hace? |
| --------------------- | --------- | ------------------------------------------- |
| **Motor X** | PA0-PA3 | Mueve carro izquierda/derecha |
| **Motor Y** | PA4-PA7 | Mueve cama adelante/atrás |
| **Motor Z** | PB0-PB3 | Mueve cabezal arriba/abajo |
| **Extrusor** | PB4-PB7 | Empuja filamento hacia boquilla |
| **Calentador Hotend** | PC0 | Calienta la boquilla (donde sale filamento) |
| **Calentador Cama** | PC1 | Calienta la plataforma de impresión |
| **Sensor Hotend** | PA0 (ADC) | Mide temperatura de boquilla |
| **Sensor Cama** | PA1 (ADC) | Mide temperatura de cama |
| **Ventilador Hotend** | PC2 | Enfría el hotend (crítico para calidad) |
| **Ventilador Cama** | PC3 | Enfría la cama entre impresiones |
***
## Primeros Pasos: Acceso a Fluidd
Fluidd es la **interfaz web de Klipper**. Es donde controlas todo tu impresora desde el navegador. Acceder a Fluidd es lo PRIMERO que debes hacer.
### Paso 1: Conectar a WiFi
Tu impresora necesita estar en tu red WiFi para que puedas acceder desde tu PC.
**En la pantalla táctil integrada de la impresora:**
1. **Enciende la impresora**
2. En la pantalla, toca **\[Menu]** (puede variar según revisión)
3. Navega a **\[Network]** o **\[Net]** o **\[WiFi]**
4. Selecciona tu red WiFi de la lista
5. Ingresa la contraseña WiFi
6. Espera a conectar (verás un ícono WiFi en la pantalla)
{% hint style="info" %}
**Si tu impresora tiene puerto Ethernet (RJ45):** Puedes conectar un cable de red directamente — es más rápido y estable que WiFi. Salta el paso WiFi.
{% endhint %}
### Paso 2: Encontrar la Dirección IP
Tu impresora ahora tiene una **dirección IP** (como su "dirección en internet" en tu red local). Necesitas esta dirección para acceder desde tu PC.
**En la misma pantalla de Network:**
Deberías ver algo como:
```
IP Address: 192.168.1.171
```
Anota este número. Es ÚNICO de tu impresora.
{% hint style="warning" %}
Si no ves la IP en la pantalla, busca en tu router (router admin page, típicamente 192.168.1.1) y busca "Artillery" en dispositivos conectados.
{% endhint %}
### Paso 3: Abrir Fluidd en el Navegador
Ahora es lo emocionante: abre tu navegador favorito (Chrome, Firefox, Safari) en tu PC y escribe:
```
http://192.168.1.171
```
(Reemplaza 171 con tu IP real)
Presiona Enter y **¡Fluidd aparecerá!** Verás:
* **Dashboard:** Temperatura en tiempo real, estado de impresión
* **Control:** Botones para mover ejes, controlar extrusor
* **Files:** Cargar archivos .gcode para imprimir
* **Config:** Editor para cambiar configuración
* **Temperature:** Gráficos de temperatura
* **History:** Registro de impresiones
{% hint style="success" %}
Si Fluidd abre en **chino**, haz clic en el ícono ⚙️ (engranaje) en la esquina superior derecha y selecciona tu idioma.
{% endhint %}
### Paso 4: Verificar que todo Funciona
En el **Dashboard de Fluidd**, deberías ver:
```
MCU: connected ✓
Temperature: hotend XX°C, bed XX°C
```
Si dice "connected", ¡perfectamente! Tu mainboard habla con Klipper.
Si dice "disconnected", hay un problema (veremos soluciones abajo).
***
## Configuración Básica de Printer
Ahora que accediste a Fluidd, necesitas configurar cómo funciona tu impresora. Esto se hace editando el archivo `printer.cfg`.
{% hint style="info" %}
**Primera vez con Klipper?** Lee [Primeros pasos con Klipper](/klipper/empezamos/puesta-en-marcha-inicial.md) para una introducción completa al ecosistema.
{% endhint %}
### ¿Qué es printer.cfg?
Es un archivo de **configuración de texto** que le dice a Klipper exactamente:
* Dónde están tus motores (en qué pines)
* Cuántos pasos son un milímetro
* Temperaturas máximas permitidas
* Dónde están los sensores
* Cómo funciona cada componente
Sin este archivo, Klipper no sabe nada de tu máquina.
### Acceder a printer.cfg en Fluidd
1. En Fluidd, ve a **Config** (arriba)
2. Haz clic en **printer.cfg**
3. Se abre el editor de texto
### Configuración Base para X4 Pro/Plus
Si tu printer.cfg está vacío o corrupto, **reemplázalo completamente** con esto:
```ini
# Artillery Sidewinder X4 Pro/Plus - Configuración Base Klipper
[printer]
kinematics: cartesian
max_velocity: 200
max_accel: 3000
max_z_velocity: 40
max_z_accel: 1000
# ========================================
# MOTORES STEPPERS (controlan movimiento)
# ========================================
# Eje X (movimiento izquierda-derecha)
[stepper_x]
step_pin: PA0
dir_pin: PA1
enable_pin: !PA2
microsteps: 16
rotation_distance: 40
endstop_pin: ^PA14
position_endstop: 0
position_max: 220
homing_speed: 50
# Eje Y (movimiento adelante-atrás)
[stepper_y]
step_pin: PA4
dir_pin: PA5
enable_pin: !PA6
microsteps: 16
rotation_distance: 40
endstop_pin: ^PA15
position_endstop: 0
position_max: 220
homing_speed: 50
# Eje Z (movimiento arriba-abajo)
[stepper_z]
step_pin: PB0
dir_pin: PB1
enable_pin: !PB2
microsteps: 16
rotation_distance: 8
endstop_pin: ^PB6
position_endstop: 0
position_max: 250
homing_speed: 10
# ========================================
# EXTRUSOR (empuja filamento)
# ========================================
[extruder]
step_pin: PB4
dir_pin: PB5
enable_pin: !PB6
microsteps: 16
rotation_distance: 4.5
nozzle_diameter: 0.4
filament_diameter: 1.75
heater_pin: PC0
sensor_type: Generic 3950
sensor_pin: PA0
control: pid
pid_Kp: 22.2
pid_Ki: 1.08
pid_Kd: 114
min_extrude_temp: 170
# ========================================
# CAMA CALIENTE (plataforma)
# ========================================
[heater_bed]
heater_pin: PC1
sensor_type: Generic 3950
sensor_pin: PA1
control: pid
pid_Kp: 54.27
pid_Ki: 0.77
pid_Kd: 959
min_temp: 0
max_temp: 130
# ========================================
# VENTILADORES
# ========================================
[fan]
pin: PC2
max_power: 1.0
kick_start_time: 0.1
off_below: 0.1
# ========================================
# PANTALLA LCD (opcional)
# ========================================
[display]
lcd_type: st7920
rs_pin: PD10
e_pin: PD11
d4_pin: PD12
d5_pin: PD13
d6_pin: PD14
d7_pin: PD15
encoder_pins: ^PD6,^PD7
click_pin: ^!PD8
```
**Después de pegar:**
1. Haz clic en **Save** (arriba a la derecha)
2. En Fluidd, ve a **Control** → presiona **Firmware Restart**
3. Espera 30 segundos a que reinicie
**Deberías ver temperatura en el dashboard.**
{% hint style="warning" %}
**Nota importante:** Estos valores son referencias. Después necesitarás:
* [Calibrar extrusor (E-steps)](/klipper/empezamos/calibracion-extrusor-e-steps.md)
* [Ajustar temperaturas (PID)](/klipper/empezamos/pid.md)
* [Nivelar cama](/klipper/empezamos/nivelacion-cama-manual.md)
Eso lo cubrimos en la siguiente sección.
{% endhint %}
***
## Configuración de Printer (Calibración y Tunning)
Una vez que printer.cfg funciona básicamente, vamos a afinar TODO para impresiones perfectas.
### Z Offset (Altura de Boquilla)
**¿Qué es?** La distancia exacta entre la boquilla y la cama cuando Z=0.
**¿Por qué importa?** Si está mal:
* Muy alto → filamento no toca la cama (no pega)
* Muy bajo → boquilla roza la cama (daña impresora)
**Más detalles:** Ver [Nivelación manual de cama](/klipper/empezamos/nivelacion-cama-manual.md) para técnicas avanzadas.
**Calibración Manual:**
En Fluidd → **Control**:
1. Presiona **\[Home All]** (pone impresora en origen)
2. En **Move**, baja **Z** manualmente hasta que:
* Puedas pasar un **papel de 0.1mm** bajo la boquilla
* Sientas **fricción** (resistencia del papel)
3. Anota el valor Z que ves (ej: -0.15)
En Fluidd → **Config** → **printer.cfg**, añade al final:
```ini
[gcode_macro HOME_Z]
gcode:
SET_GCODE_OFFSET Z=-0.15
```
(Reemplaza -0.15 con tu valor)
Luego presiona **Save & Restart**.
### Bed Level (Nivelado Manual de Cama)
**¿Qué es?** Ajustar los 4 tornillos bajo la cama para que esté plana.
**¿Por qué?** Si está torcida:
* Un lado toca la boquilla, el otro no
* Impresiones con calidad desigual
📚 **Guía completa:** [Nivelación manual de cama](/klipper/empezamos/nivelacion-cama-manual.md)
**Proceso:**
En Fluidd → **Control**:
```bash
# Home solo X e Y (no Z aún)
G28 X Y
# Ir a esquina 1 (frontal-izquierda)
G0 X30 Y30 F6000
```
Ahora **ajusta el tornillo bajo esa esquina** hasta que el papel tenga fricción.
**Repite en las otras 3 esquinas:**
```bash
G0 X190 Y30 F6000 # Frontal-derecha
G0 X190 Y190 F6000 # Trasera-derecha
G0 X30 Y190 F6000 # Trasera-izquierda
```
Ajusta cada tornillo **lentamente**. Esto toma 20-30 minutos en la primera vez.
### Bed Mesh (Compensación Automática)
**¿Qué es?** Si tu cama tiene pequeñas ondulaciones, Klipper las compensa automáticamente.
📚 **Profundizar:** [Malla nivelación de cama](/klipper/empezamos/malla-nivelacion-de-cama-klipper.md)
**En printer.cfg**, añade:
```ini
[bed_mesh]
speed: 120
horizontal_move_z: 5
mesh_min: 10, 10
mesh_max: 210, 210
probe_count: 5, 5
algorithm: bicubic
fade_start: 1
fade_end: 10
fade_target: 0
```
**Para generar el mesh:**
En Fluidd → **Control**, en terminal ejecuta:
```bash
BED_MESH_CALIBRATE
```
Espera 3-5 minutos (la boquilla se moverá midiendo altura en cada punto).
Luego:
```bash
SAVE_CONFIG
```
Klipper guardará el mapa de tu cama.
### Calibración PID (Control de Temperatura)
**¿Qué es PID?** Sistema automático que Klipper usa para mantener temperatura exacta.
**Sin PID:** Temperatura sube/baja inconsistentemente **Con PID calibrado:** Temperatura perfecta siempre
📚 **Aprende más:** [Guía completa PID](/klipper/empezamos/pid.md)
**Para el Hotend (a 200°C):**
En Fluidd → **Control**, terminal:
```bash
PID_CALIBRATE HEATER=extruder TARGET=200
```
Espera 10 minutos. Verás que se caliente, se enfríe, se caliente... Klipper está aprendiendo.
Al final:
```
PID parameters: pid_Kp=X pid_Ki=Y pid_Kd=Z
```
**Para la Cama (a 60°C):**
```bash
PID_CALIBRATE HEATER=heater_bed TARGET=60
```
Espera 15 minutos.
**Al terminar ambas:**
```bash
SAVE_CONFIG
```
Los valores se guardan automáticamente en printer.cfg.
### Tensión de Correas
**¿Qué es?** Las correas que mueven X e Y deben tener tensión correcta.
**Método simple:**
Presiona la correa en el medio entre dos puntos. Deberías sentir una **resistencia moderada** que corresponde a \~110-130 Hz (frecuencia de vibración).
* Si está muy floja → afloja el estribo de la correa
* Si está muy tensa → aprieta el estribo
Después de ajustar, imprime una pieza pequeña y mira si está recta.
### Fan Noise (Ventiladores Silenciosos)
Por defecto, ventiladores pueden ser ruidosos. Aquí los controlamos:
```ini
[fan]
pin: PC2
max_power: 1.0
kick_start_time: 0.1
off_below: 0.1
cycle_time: 0.010
[controller_fan mainboard_fan]
pin: PC3
max_power: 1.0
kick_start_time: 0.1
fan_speed: 0.5
idle_timeout: 30
heater: extruder, heater_bed
stepper: stepper_x, stepper_y, stepper_z, extruder
```
Esto hace que:
* Fan parte cooling se apaga cuando no se necesita
* Fan mainboard se adapta a carga de trabajo
* Resultado: mucho más silencio
***
## Sugerencias de Mods
### Refrigeración de Steppers
**Qué:** Disipadores de aluminio en motores **Por qué:** Motores más fríos = más potencia disponible **Costo:** \~10€ **Tiempo:** 15 minutos
Se pegan con adhesivo térmico. Especialmente útil si imprimes largas horas.
### Cable Management
**Qué:** Organizar cables con espirales de nylon **Por qué:** Mejor airflow, menos ruido, más profesional **Costo:** \~5€ **Tiempo:** 30 minutos
Mantén cables USB y potencia separados de motores.
### Upgrade de Cama
**Opciones:**
* **PEI magnetizada:** Cambios de plataforma ultrarápidos
* **Textil (Ultem):** Adhesión excelente sin pegamento
**Costo:** 30-50€ **Beneficio:** Nunca más limpieza de pegamento
### Input Shaper (Avanzado)
**Qué:** Acelerómetro ADXL345 que Klipper usa para calibrar vibraciones **Beneficio:** Impresiones más nítidas, sin artefactos **Costo:** 20€ **Dificultad:** Media (requiere soldadura)
📚 **Guía detallada:** [Input Shaper](/klipper/empezamos/input-shaper.md)
***
## OS Updates y Mantenimiento
### Acceso SSH: Cómo Conectarse Remotamente
**¿Qué es SSH?** Una forma segura de conectarte a la impresora **por terminal** (línea de comandos) desde tu PC.
Fluidd es interfaz gráfica. SSH es poder escribir comandos directamente.
**Pasos para conectar:**
#### En Windows:
1. **Descarga PuTTY:**
2. **Abre PuTTY**
3. En **Host Name**, escribe tu IP: `192.168.1.171`
4. En **Port**, asegúrate que dice `22`
5. Haz clic en **Open**
6. Verás una pregunta sobre la clave del servidor → presiona **Yes**
7. En el prompt, escribe:
```
login as: mks
password: makerbase
```
#### En Mac/Linux:
```bash
ssh mks@192.168.1.171
# Contraseña: makerbase
```
**Ahora estás dentro de la impresora por terminal.** Puedes escribir comandos.
Verás algo como:
```
mks@printer:~ $
```
Esto significa que estás conectado y puedes escribir comandos.
### Actualizar Firmware MCU (Klipper)
**¿Cuándo hacer esto?**
* Quieres nuevas características de Klipper
* Bugs fixes de seguridad
* Mejor rendimiento
**¿Qué pasa?** Compilamos Klipper en la mainboard y flasheamos el firmware STM32.
#### Paso 1: Hacer Backup (CRÍTICO)
Siempre haz backup antes de cambios:
```bash
# Conectado vía SSH
# Entrar como super-usuario (root)
sudo -i
# Cambiar a directorio de Klipper
cd /home/mks/klipper
# Hacer backup del firmware actual
stm32flash -r ~/backup-firmware-original.bin /dev/ttyS0
```
Esto guarda tu firmware original. Si algo sale mal, puedes restaurar.
**Transfiere este archivo a tu PC vía SCP (copia segura):**
```bash
# En tu PC (no en la impresora)
scp mks@192.168.1.171:~/backup-firmware-original.bin ~/
# Pedirá contraseña: makerbase
```
Ahora tienes backup en tu PC. Guardalo en lugar seguro.
#### Paso 2: Compilar Nuevo Firmware
**Vía SSH en la impresora:**
```bash
cd /home/mks/klipper
# Limpiar compilaciones previas
make clean
# Abrir menú de configuración
make menuconfig
```
**En el menú, selecciona:**
```
Microcontroller Architecture: STMicroelectronics STM32
Processor model: stm32f407
Clock reference: 8 MHz crystal
Communication interface: PA11/PA12
```
Presiona **Q** para salir, **Y** para guardar.
```bash
# Compilar (tarda 2-5 minutos)
make
```
Espera a ver:
```
Build complete
```
#### Paso 3: Flashear Firmware a Mainboard
**Lo crítico:** Poner mainboard en modo bootloader antes de flashear.
```bash
# Aún conectado vía SSH, ejecuta:
sudo -i
# Activar modo bootloader
echo 0 > /sys/class/gpio/gpio86/value
echo 0 > /sys/class/gpio/gpio83/value
# Instalar dfu-util si no está
apt install dfu-util
# Flashear
dfu-util -a 0 -i 0 -s 0x08000000:0x10000 -D /home/mks/klipper.bin
# Espera a ver: "File downloaded successfully"
```
#### Paso 4: Reiniciar y Verificar
```bash
# Salir de SSH
exit
```
Desconecta SSH y en Fluidd:
1. Ve a **Control**
2. Presiona **Firmware Restart**
3. Espera 30 segundos
En el dashboard deberías ver temperatura nuevamente. ✓ ¡Éxito!
### Backup y Restauración de eMMC
**¿Por qué?** Si algo se daña, puedes restaurar todo rápidamente.
**Hacer backup completo:**
```bash
# Vía SSH
sudo -i
# Verificar espacio (necesitas ~8GB libres)
df -h
# Hacer backup
dd if=/dev/mmcblk0 of=/home/mks/emmc-backup.img bs=1M
# Transferir a tu PC
# (En tu PC)
scp mks@192.168.1.171:/home/mks/emmc-backup.img ~/
```
**Restaurar desde backup (si impresora muere):**
```bash
# Vía SSH
dd if=/home/mks/emmc-backup.img of=/dev/mmcblk0 bs=1M
```
### Migrar a eMMC 32GB
Si necesitas más espacio (8GB → 32GB):
1. **Descargar imagen 32GB** desde SourceForge wiki
2. **Hacer backup actual** (ver arriba)
3. **Preparar nuevo módulo eMMC**
4. **Escribir imagen en nuevo módulo** con herramienta USB (Balena Etcher)
5. **Instalar nuevo módulo** en impresora
6. **Verificar:** `df -h` debería mostrar \~30GB
### Actualizar Linux en la Impresora
Mantener seguridad y rendimiento al día:
```bash
# Vía SSH
sudo -i
# Actualizar lista de paquetes
apt update
# Instalar actualizaciones
apt upgrade -y
# Reiniciar
reboot
```
***
## Troubleshooting
📚 **Para problemas no listados aquí:** Consulta [Klipper Troubleshooting](/klipper/troubleshooting.md)
### Fluidd no carga
**Checklist:**
1. ¿Impresora encendida?
2. ¿Conectada a WiFi? (verifica en pantalla LCD)
3. ¿IP correcta? (mira en Network)
4. ¿Escribiste `http://` no `https://`?
**Solución:** Reinicia impresora completamente.
### Temperatura no se actualiza
**Checklist:**
1. ¿Sensores conectados?
2. ¿`sensor_type: Generic 3950` en printer.cfg?
3. ¿Pines PA0 y PA1 en printer.cfg?
**Solución:** Verifica cables de temperatura en mainboard.
### Motor no se mueve
**Checklist:**
1. ¿Pines en printer.cfg correctos?
2. ¿Cable motor conectado?
3. ¿Motor hace ruido al presionar Home?
**Solución:** Verifica conexión de motor en mainboard.
### MCU disconnected
**Problema:** Klipper no se comunica con mainboard.
**Soluciones:**
1. Reinicia Klipper: **Firmware Restart** en Fluidd
2. Reconstruye: `make clean && make` vía SSH
3. Reflashea firmware si arriba no funciona
***
## Referencias
### Wikis y Documentación Externa
* **SourceForge Wiki Artillery:**
* **Documentación Klipper oficial:**
* **Fluidd Access:**
* **SSH Access:**
* **Klipper Update Guide:**
### Guías Complementarias en 3Dwork.io
Después de dominar esta guía, estas guías te ayudarán a optimizar tu impresora:
* [Pressure Advance](/klipper/empezamos/pressure-advance.md) — Control de presión de filamento
* [Configuración Klipper en laminadores](/klipper/empezamos/configuracion-klipper-en-laminadores.md) — Integración con Cura, PrusaSlicer, etc.
* [SKEW: Compensación chasis/cinemática](/klipper/empezamos/skew-compensacion-chasis-cinematica.md) — Corrección de distorsión
* [Ajustes avanzados TMC (VFA)](/klipper/empezamos/ajustes-avanzados-tmc-vfa.md) — Optimización de drivers de motor
* [Backup Klipper](/klipper/mejoras/backup-klipper.md) — Salvaguardar tu configuración
***
**Última actualización:** 2026-05-05 **Autor:** HAL (Technical Writer - 3Dwork.io)
{% hint style="success" %}
¡Ya tienes Klipper completamente configurado! Ahora toca experimentar, imprimir y disfrutar de impresiones más rápidas y silenciosas.
{% endhint %}