🛠 Bonjour l'écran : premier texte sur le TFT 320×240

Objetivos

• Instalar el entorno Arduino para el M5Stack Core (paquete de tarjetas esp32, tarjeta « M5Stack-Core-ESP32 », velocidad de subida 921600).
• Instalar las bibliotecas M5Unified y M5GFX (la biblioteca clásica M5Stack está obsoleta).
• Mostrar texto en la pantalla de 2,0 pulgadas 320×240 con controlador ILI9342C.
• Comprender el ciclo setup / loop con M5.begin y el refresco parcial de la pantalla.

Material

• 1 kit M5Stack Core (Basic K001 o Gray K002, cualquier revisión).
• 1 cable USB-C (de datos, no solo de carga).
• PC con Arduino IDE y el gestor de tarjetas esp32 (URL del paquete: https://dl.espressif.com/dl/package_esp32_index.json).
• Nota: esta tarjeta no posee un LED de usuario controlable documentado; toda la retroalimentación visual pasa por la pantalla.

Código completo

// M5Stack Core (Basic/Gray/GO/FIRE) — M5Unified + M5GFX requis
#include <M5Unified.h>

void setup {
  Serial.begin(115200);
  auto cfg = M5.config;
  M5.begin(cfg);                 // initialise LCD ILI9342C, boutons, IP5306
  M5.Display.fillScreen(TFT_BLACK);
  M5.Display.setTextColor(TFT_YELLOW, TFT_BLACK);
  M5.Display.setTextSize(2);
  M5.Display.setCursor(10, 20);
  M5.Display.println("Hello M5Stack!");
  M5.Display.setTextSize(1);
  M5.Display.setCursor(10, 60);
  M5.Display.println("Ecran 320x240 ILI9342C");
  Serial.println("Affichage OK");
}

void loop {
  M5.update;
  static uint32_t compteur = 0;
  M5.Display.fillRect(10, 100, 200, 20, TFT_BLACK);
  M5.Display.setCursor(10, 100);
  M5.Display.printf("Secondes : %lu", compteur / 1000UL);
  compteur += 100;
  vTaskDelay(100 / portTICK_PERIOD_MS);
}

Verificación esperada

• La pantalla muestra « Hello M5Stack! » en amarillo sobre fondo negro, seguido de un contador de segundos que avanza.
• El monitor serie (115200 baudios) muestra « Affichage OK » después de pulsar el botón reset.
• Si la pantalla permanece negra, verifique que la tarjeta esté correctamente alimentada (botón rojo: clic simple = encender).

Errores frecuentes

• Ningún puerto COM: las revisiones recientes (v2.7) utilizan un puente USB CH9102F, las antiguas un CP2104/CP210X — controlador incorrecto = sin puerto serie.
• Tarjeta incorrecta seleccionada: elegir « M5Stack-Core-ESP32 » y velocidad de subida 921600.
• Colores invertidos (blanco/negro) en unidades anteriores a 2019.7 (pantalla TN): actualizar M5GFX, que detecta la revisión.
• Olvidar M5.begin: no se muestra nada y ningún botón responde.
• Confundir con un Core2/CoreS3: los pines difieren, este tutorial está dirigido a la generación Core (K001/K002).