# 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://labs.3dwork.io/reviews-guias/electronica/bigtreetech-skr/pantallas-bigtreetech-skr.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.