Sidewinder X4 Pro / X4 Plus

Guía completa de instalación y configuración de Klipper en Artillery Sidewinder X4 Pro/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.

Lo mejor: La mainboard Artillery STM32F407 ejecuta un pequeño sistema Linux + Klipper. Es como tener una computadora dentro de tu impresora.

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

• 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)

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.

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.

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.

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

Si Fluidd abre en chino, haz clic en el ícono ⚙️ (engranaje) en la esquina superior derecha y selecciona tu idioma.

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.

Primera vez con Klipper? Lee Primeros pasos con Klipper para una introducción completa al ecosistema.

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

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

Nota importante: Estos valores son referencias. Después necesitarás:

• Calibrar extrusor (E-steps)

• Ajustar temperaturas (PID)

• Nivelar cama

Eso lo cubrimos en la siguiente sección.

---

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

[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

Proceso:

En Fluidd → Control:

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

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

En printer.cfg, añade:

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

BED_MESH_CALIBRATE

Espera 3-5 minutos (la boquilla se moverá midiendo altura en cada punto).

Luego:

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

Para el Hotend (a 200°C):

En Fluidd → Control, terminal:

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

PID_CALIBRATE HEATER=heater_bed TARGET=60

Espera 15 minutos.

Al terminar ambas:

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:

[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

---

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: https://www.putty.org/

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:

ssh [email protected]
# 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:

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

# En tu PC (no en la impresora)
scp [email protected]:~/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:

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.

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

# 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

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

# 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 [email protected]:/home/mks/emmc-backup.img ~/

Restaurar desde backup (si impresora muere):

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

# 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

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: https://sourceforge.net/p/artillery-sw-x4-klipper-images/wiki/

• Documentación Klipper oficial: https://www.klipper3d.org/

• Fluidd Access: https://sourceforge.net/p/artillery-sw-x4-klipper-images/wiki/Fluidd%20Access/

• SSH Access: https://sourceforge.net/p/artillery-sw-x4-klipper-images/wiki/SSH%20Access/

• Klipper Update Guide: https://sourceforge.net/p/artillery-sw-x4-klipper-images/wiki/Klipper%20Update/

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 — Control de presión de filamento

• Configuración Klipper en laminadores — Integración con Cura, PrusaSlicer, etc.

• SKEW: Compensación chasis/cinemática — Corrección de distorsión

• Ajustes avanzados TMC (VFA) — Optimización de drivers de motor

• Backup Klipper — Salvaguardar tu configuración

---

Última actualización: 2026-05-05 Autor: HAL (Technical Writer - 3Dwork.io)

¡Ya tienes Klipper completamente configurado! Ahora toca experimentar, imprimir y disfrutar de impresiones más rápidas y silenciosas.