Una TFT a color ST7735 en un Arduino
Avanzado
- 526componentes en el banco de trabajo
- 46placas funcionando ahora
- 1.00xtiempo real, en todas las placas
La ST7735 es el chip detrás de las pantallas a color de 1.8 pulgadas económicas: 128 por 160 píxeles, 65,536 colores, en una placa roja con ranura para tarjeta SD en la parte de atrás. Se comunica por SPI, así que necesita un reloj, una línea de datos y algunos pines de control, y la biblioteca de Adafruit ST7735 hace el resto.
El circuito de arriba es un Uno con dos pantallas a color: la ST7735 de 1.8 pulgadas en los pines SPI de hardware del Uno, y una ST7789 de 1.3 pulgadas en pines propios. Cada una dibuja un título y luego un pequeño cuadrado lo recorre con un color que cambia mientras avanza. Presiona Ejecutar y observa cómo la ST7735 enciende primero, y la ST7789 unos dos segundos después.
Lo que necesitas
- Un Arduino Uno
- Una TFT ST7735 de 1.8 pulgadas, 128x160 (la placa SPI roja)
- Una TFT ST7789 de 1.3 pulgadas, 240x240 (opcional, para la segunda mitad)
- Una protoboard y cables jumper
Cableado
| Componente y pin | Va a | Nota |
|---|---|---|
| ST7735 VCC | 5 V | La placa roja tiene un regulador para el chip |
| ST7735 GND | GND | |
| ST7735 SCK | Pin 13 | El reloj del SPI de hardware |
| ST7735 SDA | Pin 11 | Datos SPI (MOSI). No es I2C, aunque la etiqueta diga lo contrario |
| ST7735 CS | Pin 10 | Selección de chip |
| ST7735 A0 | Pin 9 | Lo que otras placas llaman DC: comando o datos |
| ST7735 RESET | Pin 8 | |
| ST7735 LED | 5 V | La luz de fondo |
| ST7789 SCL y SDA | A1 y A0 | SPI por software en cualquier pin |
| ST7789 DC y RES | Pines 7 y 6 | Esta placa no tiene pin CS |
Cómo se controla la pantalla
La ST7735 guarda toda la imagen en su propia memoria, 16 bits por píxel. Para dibujar, el Uno envía un comando que define una ventana (un rango de columnas y luego un rango de filas) y después transmite los colores de cada píxel dentro de ella. Por eso un cuadrado relleno es rápido y una imagen de pantalla completa es lenta: los bytes tienen que viajar por el cable en ambos casos.
El pin A0 (DC en la mayoría de las otras placas) le indica al chip qué bytes son comandos y cuáles son píxeles: bajo para un comando, alto para datos. CS en bajo significa "esto es para ti". La biblioteca controla ambos por ti, pero si alguno de los dos cables está flojo, nada tiene sentido para el chip y la pantalla permanece apagada.
Colors are 16-bit "565" numbers: 5 bits of red, 6 of green and 5 of blue. ST77XX_GREEN and the other names are ready-made ones, and color565(r, g, b) turns three 0 to 255 values into one, which is how the sketch makes its changing square.
El sketch
Adafruit_ST7735 small(10, 9, 8) recibe CS, DC y RESET y usa el SPI de hardware del Uno para el reloj y los datos, pines 13 y 11. initR(INITR_BLACKTAB) despierta al chip y lo configura para el panel, y luego las llamadas habituales de Adafruit GFX dibujan: fillScreen, setCursor, print, fillRect.
La ST7789 usa el constructor de cinco números, Adafruit_ST7789 square(-1, 7, A0, A1, 6): sin CS (-1), DC en 7, datos en A0, reloj en A1 y RES en 6. Al tener sus propios pines de reloj y datos, la biblioteca envía cada bit a mano, lo que funciona en cualquier pin y es mucho más lento que el SPI de hardware. Eso, junto con el arranque más largo de la ST7789, hace que encienda unos dos segundos después que la ST7735.
#include <SPI.h>
#include <Adafruit_GFX.h>
#include <Adafruit_ST7735.h>
#include <Adafruit_ST7789.h>
Adafruit_ST7735 small(10, 9, 8);
Adafruit_ST7789 square(-1, 7, A0, A1, 6); // no CS; DC, SDA, SCL, RES
void setup() {
small.initR(INITR_BLACKTAB);
small.fillScreen(ST77XX_BLACK);
small.setTextColor(ST77XX_GREEN);
small.setCursor(4, 4);
small.print("ST7735 128X160");
square.init(240, 240, SPI_MODE3);
square.setRotation(2);
square.fillRect(0, 0, 240, 40, ST77XX_BLUE);
square.setTextColor(ST77XX_WHITE);
square.setTextSize(2);
square.setCursor(8, 12);
square.print("ST7789 IPS");
}
void loop() {
// A block that walks around each screen, in a color that changes as it goes.
static uint8_t step = 0;
uint16_t color = Adafruit_ST7789::color565((uint8_t)(step * 16), 255 - step * 16, 128);
small.fillRect((int16_t)(8 + (step % 8) * 14), 40, 12, 12, color);
square.fillRect((int16_t)(10 + (step % 8) * 28), 120, 24, 24, color);
step = (uint8_t)((step + 1) % 16);
delay(100);
}Abrir este sketch en el editorSolo el código: el editor coloca la placa y los componentes que puede leer del sketch.
Pestaña negra, pestaña verde, pestaña roja
La memoria del chip es de 132 por 162, un poco más grande que el cristal de 128 por 160, y los fabricantes montan el cristal en posiciones ligeramente distintas dentro de ella. Marcan cuál con el color de la pestaña en la película protectora de la pantalla, y la biblioteca tiene una configuración de initR para cada una: INITR_BLACKTAB, INITR_GREENTAB y INITR_REDTAB, además de INITR_144GREENTAB para las cuadradas de 1.44 pulgadas.
Si eliges la equivocada, la imagen queda desplazada: una franja de ruido o negro en dos bordes, o el rojo y el azul intercambiados. Si eso es lo que ves, prueba las otras pestañas antes de sospechar del cableado. ¿Quitaste la película y perdiste la pestaña? Pruébalas una por una; una dibujará bordes limpios.
¿ST7735 o ST7789?
La ST7789 entiende casi los mismos comandos, así que el código apenas cambia, pero controla un cristal IPS más grande y nítido: 240 por 240 en las placas cuadradas de 1.3 pulgadas, 240 por 320 en otras. Los paneles IPS se ven igual desde cualquier ángulo, mientras que el cristal más económico de la ST7735 se destiñe al inclinarlo.
Muchas placas ST7789 de 1.3 pulgadas no tienen pin CS, así que el chip escucha cada reloj en sus cables. Si pones una en el mismo bus SPI que otra pantalla, tomará los bytes de esa pantalla como propios, y por eso la de aquí tiene pines propios. Además necesitan el modo SPI 3, el tercer número en init(240, 240, SPI_MODE3).
Para una pantalla todavía más grande, las placas de 2.4 y 2.8 pulgadas usan una ILI9341 a 240 por 320, con pantalla táctil en muchas de ellas. Abajo hay una página sobre ella.
Errores comunes
Pantalla oscura con la luz de fondo encendida. Normalmente A0 (DC) o CS no está conectado, o está conectado al pin equivocado. Desconecta cualquiera de los dos en el circuito de arriba y la ST7735 no mostrará nada.
Tratar SDA y SCK como I2C por los nombres. Son SPI: SDA va al pin 11 (MOSI) y SCK al pin 13 en un Uno.
La pestaña equivocada en initR, que produce imágenes desplazadas o bordes con ruido. Prueba las otras.
Alimentar los pines de señal a 5 V de forma permanente. El regulador de la placa roja le da 3.3 V al chip, pero los pines de señal llegan al chip directamente, y la ST7735 es un componente de 3.3 V. Muchas personas los usan con un Uno de 5 V de todos modos; un desplazador de nivel, o una placa de 3.3 V, es lo seguro.
Dejar RESET al aire. En el circuito de arriba el sketch arranca igual con RESET sin conectar, porque initR envía primero un reinicio por software, pero un pin flotante en una placa real puede captar ruido y reiniciar el chip al azar. Conéctalo a un pin o a VCC.
Redibujar toda la pantalla en cada ciclo. Un relleno completo de 128 por 160 son 40,960 bytes por el cable; dibuja solo lo que cambió.
Abre este circuito en el editor. Arduino Uno: una ST7735 y una ST7789, conectadas como se ejecuta al inicio de esta página. Cambia un componente o un valor y ejecútalo de nuevo.
Abrir el circuitoPreguntas
¿Cómo conecto una ST7735 a un Arduino Uno?
VCC a 5 V, GND a GND, SCK a 13, SDA a 11, CS a 10, A0 (DC) a 9, RESET a 8 y LED a 5 V. Luego Adafruit_ST7735 tft(10, 9, 8) y tft.initR(INITR_BLACKTAB).
¿Qué biblioteca necesito para la ST7735?
Adafruit ST7735 and ST7789 Library, junto con Adafruit GFX para las llamadas de dibujo. La misma biblioteca controla ambos chips.
¿Por qué mi pantalla ST7735 está blanca o en blanco?
Una pantalla blanca es la luz de fondo sin nada dibujado: revisa CS, A0 (DC) y RESET, y que el sketch llame a initR. Imágenes desplazadas o bordes con ruido significan la configuración de pestaña equivocada.
¿Puedo usar la ranura para tarjeta SD de la parte trasera?
Sí, en una placa real: comparte SCK, MOSI y MISO, con su propio pin CS. La placa simulada no incluye la tarjeta SD.
Sigue así
Ármalo en la vida real
Abre el editor, cambia un valor y mira cómo cambia el número con él. Nada que instalar y sin necesidad de cuenta.