> For the complete documentation index, see [llms.txt](https://labs.3dwork.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://labs.3dwork.io/reviews-guias/electronica/bigtreetech-skr/pantallas-bigtreetech-skr.md).

# Pantallas BigtreeTech/SKR

Guía práctica paso a paso para instalar y configurar pantallas BigTreeTech en placas SKR con Marlin y Klipper.

***

## Introducción: Tipos de Pantallas y Conectividad

### ¿Qué tipos de pantallas existen?

Las pantallas modernas para impresoras 3D funcionan bajo **tres arquitecturas diferentes**. Es crucial entender cuál se adapta a tu sistema:

#### 1️⃣ **Pantallas Duales: Emulación + Modo Táctil**

Estas pantallas tienen **dos modos de funcionamiento independientes**:

* **Modo emulación (12864)**: Conectadas directamente a la placa (SPI o EXP1/EXP2), actúan como pantalla paralela tradicional. El firmware de la placa (Marlin/Klipper) dibuja directamente en ellas. Son **rápidas y responden sin latencia** porque la comunicación es directa.
* **Modo táctil (propietario)**: Ejecutan un **firmware independiente** que corre dentro de la pantalla. Este firmware recibe comandos via UART/serial desde la placa, y la pantalla dibuja su propia interfaz táctil interactiva. Los datos de los sensores táctiles se envían de vuelta a la placa por serie.

**Ventaja clave**: Puedes usar la MISMA pantalla en **modo emulación (SPI/EXP)** si el firmware táctil no se inicializa, o cambiar entre modos actualizando el firmware. Son extremadamente **versátiles y tolerantes a cambios de configuración**.

**Pantallas con esta arquitectura**:

* BTT TFT35 (todas las versiones: V2.0, V2.1, V3.0)
* BTT TFT24, TFT28
* BTT HDMI5 (cuando se usa en modo emulación, aunque es más moderna)

#### 2️⃣ **Módulo Host: Sistema Operativo Completo**

Estas pantallas **ejecutan un sistema operativo** (Linux, basado en Debian) y pueden:

* Funcionar como **host Klipper** — corren Klipper, Moonraker, y controlan directamente la impresora sin necesidad de Raspberry Pi
* Funcionar como **Octoprint** en Marlin — si prefieres una solución similar a OctoPrint tradicional
* Conectarse via **HDMI a un host existente** (Raspberry Pi, Orange Pi, etc.)

**Ventaja clave**: Una sola máquina hace todo. No necesitas placa + Raspberry aparte. Todo está integrado en la pantalla.

**Pantallas con esta arquitectura**:

* **BTT Pad 7** — Tablet 7" con CB1 integrado, Klipper/Moonraker preinstalados
* **BTT Pad 5** (HDMI5 versión nueva) — Similar pero 5"

#### 3️⃣ **Conexión Directa (SPI/EXP)**

Conectadas **directamente a los pines de la placa** (no a un host):

* **Emulación 12864** — La placa dibuja la interfaz, la pantalla solo muestra pixels
* **Muy baja latencia**, responden instantáneamente a inputs del firmware
* Requieren **menos recursos de la placa** (no es UART de alta velocidad)

**Pantallas con esta arquitectura**:

* BTT TFT35 SPI V2.1 (modo SPI puro)
* BTT TFT35 V3.0 (modo SPI + emulación)

![Ejemplo de conexión SKR 1.4](https://telegra.ph/file/bce3c24f2743531f19802.jpg)

***

## Opciones Recomendadas por Sistema

### Para Usuarios de Klipper

| Pantalla               | Tipo             | Conexión        | Ventaja                                   | Enlace                                                     |
| ---------------------- | ---------------- | --------------- | ----------------------------------------- | ---------------------------------------------------------- |
| **BTT Pad 7**          | Host             | HDMI            | Todo integrado, tablet 7", Klipper nativo | [Detalles →](#btt-pad-7--tablet-7-con-cb1-integrado)       |
| **BTT HDMI5 V1.2**     | Host + Emulación | HDMI            | 5" versátil, conecta a CM4/CB1            | [Detalles →](#btt-hdmi5--pantalla-hdmi-50)                 |
| **BTT TFT35 SPI V2.1** | Directo          | SPI             | Conexión directa a SKR, rápida            | [Detalles →](#btt-tft35-spi-v21--guía-completa)            |
| **BTT TFT35 V3.0**     | Dual             | SPI + Emulación | Firmware táctil OR emulación 12864        | [Detalles →](#btt-tft35-v30--dual-modo-emulacion-y-tactil) |

### Para Usuarios de Marlin

| Pantalla           | Tipo | Conexión        | Ventaja                       | Enlace                                                     |
| ------------------ | ---- | --------------- | ----------------------------- | ---------------------------------------------------------- |
| **BTT TFT35 V3.0** | Dual | SPI + Emulación | Versátil, soporta ambos modos | [Detalles →](#btt-tft35-v30--dual-modo-emulacion-y-tactil) |
| **BTT TFT24 V1.1** | Dual | SPI + Emulación | Más pequeña, suficiente       | [Detalles →](#btt-tft24--pantalla-24-dual)                 |
| **KlipperScreen**  | Host | HDMI/GPIO       | Para Raspberry Pi existente   | No aplica a esta guía                                      |

***

## Pantallas Duales: Firmware de Emulación y Modo Táctil

**Sección crítica**: Si tienes una **pantalla TFT35 V3.0, TFT24 o TFT28**, entender el firmware es esencial.

### ¿Cómo funciona el firmware táctil en pantallas duales?

La pantalla dual tiene **dos firmware posibles en su chip**:

1. **Firmware de emulación** (para SPI/EXP directo)
   * La placa Marlin/Klipper envía comandos SPI/paralelos
   * La pantalla dibuja lo que le dice la placa
   * No tiene interfaz táctil propia
   * Usa el firmware mínimo del chipset del controlador de pantalla
2. **Firmware táctil BTT personalizado** (modo propio)
   * La pantalla corre **su propio sistema**
   * Dibuja su propia interfaz bonita y táctil
   * Se comunica con la placa por **UART (serial)**
   * Los comandos táctiles se convierten a comandos Marlin/Klipper

### ¿Cuál firmware usar?

**Usa firmware táctil si:**

* Conectas la pantalla por **UART** a la placa (pines TX/RX)
* Quieres interfaz táctil interactiva bonita
* Tu placa soporta UART a esos pines (SKR, Manta, etc.)

**Usa firmware de emulación si:**

* Conectas por **SPI/EXP** directo a la placa
* El firmware táctil no inicia o da problemas
* Prefieres una pantalla simple y rápida

### Instalación del Firmware Táctil (Duales)

**Requisitos:**

* Tarjeta SD ≤8GB, formateada **FAT32**
* Lector SD en tu computadora
* Archivo del firmware `.bin` descargado

**Pasos:**

1. **Descarga el firmware**
   * Ve a: <https://github.com/bigtreetech/BIGTREETECH-TouchScreenFirmware/releases>
   * Descarga el binario para tu modelo (ej: `TFT35_V3.0.x_E3.bin`)
   * Si tienes idioma español, descarga también `language_es.ini`
2. **Prepara la tarjeta SD**

   ```
   SD:/
   ├── Firmware.bin    (renombra el .bin descargado a esto)
   ├── config.ini
   ├── language_es.ini (opcional)
   └── fonts/          (copia carpeta de fuentes si la incluye el firmware)
   ```
3. **Copia los archivos a SD**
   * Formatea SD en FAT32 en tu PC
   * Copia los archivos raíz
   * Cierra la sesión (eject en macOS/Linux, expulsar en Windows)
4. **Inserta SD en pantalla y reinicia**
   * Apaga la impresora
   * Inserta SD en la pantalla (ranura trasera o lateral)
   * Enciende → la pantalla detecta `Firmware.bin` automáticamente
   * **Espera 5-10 segundos**, verás progreso
   * Se reinicia automáticamente
5. **Verifica que el firmware se instaló**
   * Debería aparecer el **menú BTT táctil**
   * Si sigue mostrando caracteres raros, el firmware no se copió correctamente

**⚠️ Importante:**

* **Firmware + config + idioma DEBEN estar en raíz de SD**
* Si faltan archivos, la pantalla muestra caracteres raros o pantalla en blanco
* Si algo falla, crea archivo `reset.txt` en SD y reinicia (reset forzado)

***

## Detalle Técnico por Pantalla

### BTT TFT35 SPI V2.1 — Guía Completa

#### Especificaciones

| Parámetro      | Especificación               |
| -------------- | ---------------------------- |
| Pantalla       | 3.5" IPS, 480×320px          |
| Driver LCD     | ILI9488 (SPI)                |
| Driver Táctil  | NS2009 (I2C)                 |
| Alimentación   | 5V DC                        |
| Lógica         | 3.3V                         |
| Conexión       | FPC cable + XH 2.54          |
| Compatibilidad | Klipper nativo (SPI directo) |

#### Cables Necesarios

**Cable FPC (Flat Ribbon)**

* **Tipo**: Conector FPC 0.5mm, 14-pin aproximadamente
* **Función**: Transmite SPI (LCD) + I2C (táctil) + alimentación
* **Ubicación en pantalla**: Puerto FPC trasero (mini conector blanco)
* **Ubicación en placa**: Puerto TFT (varía por placa)
* **Longitud**: 20-30 cm típica

**Cable de Alimentación**

* **Tipo**: JST XH 2.54mm, 2 pines
* **Voltaje**: 5V DC (rojo = positivo, negro = GND)
* **Amperaje**: 0.5-1A típico
* **Ubicación**: Conector XH en la placa (marcado 5V o POWER)

#### Instalación en SKR 1.4 / SKR 1.3

**Conexión FPC:**

* Puerto TFT de la SKR (si existe)
* O soldadura manual de pines SPI:
  * MISO (pin 19) → MISO pantalla
  * MOSI (pin 18) → MOSI pantalla
  * CLK (pin 23) → CLK pantalla
  * CS (pin 25) → CS pantalla

**Alimentación:**

* 5V de la placa (si disponible) → XH 5V pantalla
* GND → GND pantalla

#### Configuración para Klipper

**En `printer.cfg`:**

```ini
[display]
lcd_type: st7789
rs_pin: gpio11
e_pin: gpio10
d0_pin: gpio9
d1_pin: gpio8
d2_pin: gpio7
d3_pin: gpio6
d4_pin: gpio5
d5_pin: gpio4
d6_pin: gpio3
d7_pin: gpio2
contrast: 40
```

(Los números de pin varían según tu MCU; consulta la documentación de Klipper para tu placa específica)

#### Troubleshooting

* **Pantalla en blanco**: Verifica que 5V y GND estén conectados correctamente
* **Pantalla con caracteres raros**: El firmware SPI no está cargado correctamente, reinicia
* **Táctil no funciona**: Verifica cable I2C separado (si uses táctil en SPI)

***

### BTT TFT35 V3.0 — Dual: Modo Emulación y Táctil

#### Especificaciones

| Parámetro    | Especificación                               |
| ------------ | -------------------------------------------- |
| Pantalla     | 3.5" TFT, 480×320px                          |
| Driver       | ILI9488 + SH1106 (emulación 12864)           |
| Alimentación | 5V DC                                        |
| Conexión     | FPC + XH (dual: SPI + UART)                  |
| Modos        | Emulación 12864 (SPI) O Táctil propio (UART) |

#### Esquemas de Conexión

![Esquema conexión SKR TFT35 V3](https://telegra.ph/file/aa9510b4e90f7d7856099.png)

![Esquema conexión SKR TFT35 E3 V3](https://telegra.ph/file/aa7a856f23c17cb924f54.png)

#### Modo Emulación (12864)

**Cuando usar:**

* Conectando a pines EXP1/EXP2 de la placa
* Queriendo máxima compatibilidad con Marlin heredado
* Si el firmware táctil da problemas

**Conexión mínima:**

```
SKR EXP1 → Pantalla FPC:
- GND
- 5V
- CS
- MOSI
- CLK
(pins exactos varían; ver manual SKR)
```

#### Modo Táctil (Firmware BTT)

**Cuando usar:**

* Conectando por UART (TX/RX) a la placa
* Queriendo interfaz táctil moderna
* Firmware táctil está configurado en el chip

**Instalación del firmware táctil**: Ver sección anterior [Firmware de Emulación y Modo Táctil](#pantallas-duales-firmware-de-emulación-y-modo-táctil)

#### Cambiar entre modos

1. **Entrar en modo firmware update**
   * Apaga impresora
   * Crea archivo `update.bin` en SD (vacío o con firmware anterior)
   * Inserta SD en pantalla
   * Enciende → pantalla detecta e inicia actualización
   * Espera a que termine
2. **Flashear firmware táctil**
   * Sigue pasos en sección firmware
3. **Revertir a emulación**
   * Si no tienes el `.bin` de emulación, contacta a BTT o descarga de su GitHub
   * Repite pasos 1-2 con firmware de emulación

***

### BTT TFT24 — Pantalla 2.4" Dual

#### Especificaciones

| Parámetro      | Especificación                 |
| -------------- | ------------------------------ |
| Pantalla       | 2.4" TFT, 320×240px            |
| Driver         | ST7789                         |
| Conexión       | Cable sencillo (FPC)           |
| Modos          | Emulación 12864 O Táctil       |
| Compatibilidad | Marlin + Klipper (ambos modos) |

#### Esquema de Conexión

![Esquema conexión SKR TFT24](https://telegra.ph/file/da039bfe8737627a23503.png)

#### Características

* **Más compacta** que TFT35, ideal para espacios reducidos
* Funciona igual que TFT35 V3.0: **dual emulación + táctil**
* Menos resolución pero suficiente para controlar impresora
* Ideal para impresoras Ender 3, SKR mini

#### Instalación

Identical a TFT35 V3.0, ver sección arriba.

***

### BTT Pad 7 — Tablet 7" con CB1 Integrado

#### Especificaciones

| Parámetro         | Especificación                     |
| ----------------- | ---------------------------------- |
| Pantalla          | 7" IPS, 1024×600px                 |
| Host              | CB1 (Módulo Compute similar a CM4) |
| SO                | Linux Debian                       |
| Conectividad      | Ethernet, USB, HDMI                |
| Klipper/Moonraker | **Preinstalado**                   |

#### Ventajas

* **Todo-en-uno**: No necesitas Raspberry Pi aparte
* Klipper y Moonraker **ya configurados**
* Interfaz **grande y clara**
* Se conecta a la impresora por **HDMI + USB (power)**

#### Conexión a la Impresora

**Conexión HDMI:**

* HDMI A (normal) → HDMI de la placa (si existe, ej: Manta E3 EZ)
* O HDMI convertidor USB si la placa no tiene HDMI

**Power:**

* USB-C en Pad 7 ← 5V desde placa o fuente aparte
* **No confundir**: HDMI NO proporciona power en bidireccional

#### Detalles Completos

Para información exhaustiva, ver: [**Review completa: Pad 7 — Tablet 7" con Klipper integrado**](https://3dwork.io/en/bigtreetech-pad-7-klipper/)

***

### BTT HDMI5 — Pantalla HDMI 5.0"

#### Especificaciones

| Parámetro      | Especificación                                         |
| -------------- | ------------------------------------------------------ |
| Pantalla       | 5" IPS, 800×480px                                      |
| Conexión       | HDMI (entrada), USB (power)                            |
| Compatible con | CM4, CB1, Raspberry Pi, Orange Pi, etc.                |
| Modos          | Host (con compute module) O Monitor (con host externo) |

#### Ventajas

* **HDMI universal**: Conecta a cualquier host con salida HDMI
* Táctil integrada
* Tamaño **versátil**: más grande que TFT35, más pequeño que Pad 7
* Puede funcionar como **tablet standalone** con module integrado

#### Instalación con CM4

1. Inserta CM4 en slot (debajo de la pantalla)
2. Conecta fuente USB-C
3. HDMI se conecta automáticamente al CM4
4. Arranca Linux, configura Klipper + Moonraker

#### Instalación como Monitor

1. Conecta HDMI desde host (Pi, Orange Pi, etc.)
2. Conecta USB-C para power
3. Funciona como pantalla/táctil del host

#### Detalles Completos

Para información exhaustiva, ver: [**Review completa: HDMI5 — Pantalla HDMI 5" para CM4/CB1**](https://3dwork.io/en/raspberry-pad-5-algo-mas-que-una-simple-pantalla/)

***

## Esquemas de Conexión (Resumen Visual)

![Resumen de conexiones para todas las pantallas SKR](/files/-MjdIaDsg3TRqf3-SwA3)

![Resumen de conexiones](/files/-MjdIv01uctU36_0Fxiq)

***

## Configuración: config.ini Detallado

### ¿Qué es config.ini?

Archivo de configuración que cada pantalla dual (TFT35 V3.0, TFT24, etc.) lee al iniciar. Define:

* Baudrate de comunicación UART
* Velocidad de actualización
* Tema visual
* Comportamiento de botones

### Ubicación

**Debe estar en raíz de SD:**

```
SD:/
├── Firmware.bin
├── config.ini    ← AQUÍ
└── language_es.ini
```

### Ejemplo: config.ini para SKR 1.4 + TFT35 V3.0

```ini
[uart]
; Puerto serie de comunicación
; Algunos valores típicos:
; 115200 = estándar
; 250000 = posible en algunos casos
baud_rate=115200

[display]
; Tipo de pantalla detectada
rotation=0
; 0 = normal
; 1 = rotada 90°
; 2 = rotada 180°
; 3 = rotada 270°

brightness=100
; 0-100, brillo de pantalla

[theme]
; Tema visual
; default, dark, light
theme=dark

[printer]
; Nombre de tu impresora (se muestra en pantalla)
name=My Printer
```

### Troubleshooting config.ini

* **"Invalid config.ini"**: Archivo corrupto, descárgalo nuevamente
* **Pantalla sigue mostrando basura**: Falta el archivo, cópialo a SD raíz
* **Baudrate no coincide**: Pantalla no se comunica con placa, ajusta a 115200 primero

***

## Marlin: Configuración para Pantallas

### Configuration.h Esencial

**Para TFT35 V3.0 en modo emulación:**

```cpp
// Pantalla
#define REPRAP_DISCOUNT_SMART_CONTROLLER
#define SDSUPPORT
#define SDCARD_CONNECTION SPI

// UART (si usas modo táctil)
#define SERIAL_PORT 1        // Puerto del firmware táctil
#define BAUDRATE 115200      // Debe coincidir con config.ini
```

**Para TFT24:**

```cpp
#define REPRAP_DISCOUNT_SMART_CONTROLLER
#define SDCARD_CONNECTION SPI
```

**Compilar y flashear:**

```bash
platformio run -e SKR_1_4        # Ajusta según tu placa
# Genera .bin en .pio/build/SKR_1_4/firmware.bin
```

![Tabla de configuración SKR](/files/-MjdJ-9vfZLbgr0GyR0U)

***

## Klipper: Configuración para Pantallas SPI

### printer.cfg para TFT35 SPI V2.1

```ini
[display]
lcd_type: st7789
rs_pin: gpio11
e_pin: gpio10
d0_pin: gpio9
d1_pin: gpio8
d2_pin: gpio7
d3_pin: gpio6
d4_pin: gpio5
d5_pin: gpio4
d6_pin: gpio3
d7_pin: gpio2
contrast: 40
```

**Nota**: Los números de GPIO dependen de tu MCU (STM32, RP2040, etc.). Consulta la documentación de Klipper para tu placa.

### Klipper nativo con Pad 7

Si usas Pad 7, Klipper ya está instalado. Solo necesitas:

1. Conectar HDMI a placa o adaptador
2. Conectar USB-C para power
3. El sistema arranca automáticamente

***

## Troubleshooting General

### Pantalla en blanco o sin respuesta

**Checklist:**

1. ¿Está 5V conectado correctamente? (Mide con multímetro)
2. ¿GND está conectado? (Imprescindible)
3. ¿SD está insertada? (Para firmware táctil)
4. ¿Datos (MOSI/CLK/CS) están bien? (Si modo SPI)

**Solución:**

* Revisa cada cable físicamente
* Desconecta y reconecta después de 10 segundos
* Reinicia la impresora completamente

### Caracteres raros, pixeles aleatorios

**Causa**: Firmware incorrecto o corrupción de datos en SPI

**Solución:**

1. Apaga impresora
2. Retira cable FPC unos segundos
3. Vuelve a conectar (asegúrate de que esté perpendicular)
4. Enciende nuevamente

### Táctil no responde (en modo dual)

**Si la pantalla se ve bien pero táctil no funciona:**

1. **En modo emulación**: Los botones táctiles NO funcionan, es normal. Solo SPI dibuja.
2. **En modo táctil**: Verifica que `config.ini` tenga baudrate correcto (115200 típico)
3. **Revisa conexión UART** (TX/RX si aplica)

### Firmware táctil no se instala ("Updating..." se queda ahí)

**Causa típica**: Archivo `Firmware.bin` corrupto o SD dañada

**Solución:**

1. Descarga el `.bin` nuevamente (asegúrate de que no esté truncado)
2. Formatea SD nuevamente en FAT32
3. Copia archivo renombrado a `Firmware.bin` exactamente
4. Inserta SD, espera 10 segundos mínimo antes de tocar nada

***

## FAQ — Preguntas Frecuentes

**¿Cuál es la pantalla "mejor" para Klipper?**

* Depende de tu caso: Si tienes espacio y presupuesto, Pad 7. Si necesitas algo compacto, TFT35 SPI V2.1. Si ya tienes Pi, HDMI5 como monitor.
* No hay una "mejor", cada una se adapta a necesidades diferentes.

**¿Puedo cambiar de firmware sin perder datos?**

* **SÍ** — los datos de la impresora están en la placa (EEPROM), no en la pantalla.
* Solo cambia la pantalla, la placa sigue igual.

**¿Firmware, fuentes e iconos DEBEN actualizarse juntos?**

* **SÍ** — si faltan fuentes verás caracteres raros
* **SÍ** — si faltan iconos verás espacios en blanco
* Todos los archivos DEBEN estar en SD y copiarse juntos

**¿Cómo cambiar idioma en pantalla dual?**

* Copia `language_es.ini` a SD
* Menú → Settings → Language
* Selecciona el idioma que instalaste

**¿Puedo usar pantalla Marlin en Klipper?**

* Técnicamente sí, pero **no recomendado**
* Mejor usa KlipperScreen en Raspberry Pi
* O usa TFT35 SPI V2.1 (diseñada para Klipper nativo)

**¿Cómo resetear pantalla a configuración por defecto?**

* Crea archivo `reset.txt` en raíz de SD
* Inserta SD y reinicia pantalla
* Se calibrará táctil automáticamente

***

## 9. Referencias y Recursos

**Documentación oficial y guías de instalación:**

* **Firmware oficial**: <https://github.com/bigtreetech/BIGTREETECH-TouchScreenFirmware>
* **Wiki BTT**: <https://global.bttwiki.com/>
* **Documentación oficial BTT**: <https://github.com/bigtreetech/docs>

**Reviews detalladas de pantallas en 3Dwork:**

* [**Review completa: Pad 7 — Tablet 7" con Klipper integrado**](https://3dwork.io/en/bigtreetech-pad-7-klipper/)
* [**Review completa: HDMI5 — Pantalla HDMI 5" para CM4/CB1**](https://3dwork.io/en/raspberry-pad-5-algo-mas-que-una-simple-pantalla/)

***

**Última actualización**: 2026-04-28