Service d'affichage

Aperçu

Le service d'affichage est un wrapper global et thread-safe autour du pilote U8G2 pour un OLED SSD1306 128 × 64. Vous l'utilisez pour restituer le texte et les graphiques de n'importe quelle tâche sans scintillement ni déchirure. Un mutex FreeRTOS garantit un accès exclusif pendant que vous dessinez ; les fonctions d'assistance gèrent l'effacement des régions, l'actualisation partielle, le découpage et la mise en cache du texte.

Conditions préalables

• ESP32 avec interface I2C matérielle disponible
• Bibliothèque U8G2 intégrée à la compilation de votre micrologiciel
• FreeRTOS (pour le mutex d'affichage)
• Broches configurées pour SDA/SCL dans le Pins.h de votre carte

Configuration matérielle

Modèle de mise en page

L'écran est traité comme une grille de cellules de 8 × 8 pixels :

• Grille : 8 lignes × 16 colonnes
• Origine : (0,0) en haut à gauche
• Taille de cellule : 8 × 8 pixels

Régions

Sécurité des threads

Le service d'affichage fournit un mutex FreeRTOS. Verrouillez-le toujours avant de dessiner et déverrouillez-le lorsque vous avez terminé.

#pragma once
#include <freertos/FreeRTOS.h>
#include <freertos/semphr.h>

extern SemaphoreHandle_t displayMutex;

Modèle d'utilisation de base

// Acquire, draw, refresh affected region(s), release
if (xSemaphoreTake(displayMutex, portMAX_DELAY) == pdTRUE) {
  // ... drawing commands, e.g.:
  display.drawStr(x, y, "HELLO WORLD");

  // Call an appropriate refresh helper (see below)
  refreshPage();

  xSemaphoreGive(displayMutex);
}

Initialisation

Appelez initDisplay() une fois au démarrage.

#pragma once
void initDisplay();

if (xSemaphoreTake(displayMutex, portMAX_DELAY) == pdTRUE) {
  clearPage();
  display.setFont(u8g2_font_spleen5x8_mu);
  display.drawStr(0, 16, "SANITY PASS");
  refreshPage();
  xSemaphoreGive(displayMutex);
}

Aides à l'effacement

Effacez efficacement uniquement ce que vous envisagez de redessiner. Toutes les fonctions d'aide utilisent updateDisplayArea() en interne pour effectuer une actualisation partielle de la région affectée.

void clearHeader();
void clearIcons();
void clearFooter();
void clearTimeout();
void clearPage(bool includeFooter = false, bool includeHeader = false);

Aides à l'actualisation

Appelez une fonction d’actualisation après avoir modifié une région. Elle effectue une mise à jour minimale de l’affichage.

void refreshHeader();
void refreshIcons();
void refreshFooter();
void refreshTimeout();
void refreshPage(bool includeFooter = false, bool includeHeader = false);

Fonctions d'aide au contenu

setHeader()

Définit le texte de l'en-tête. Le service convertit la dernière valeur en majuscules et la met en cache pour éviter les redessins redondants.

void setHeader(String &text);

setFooter()

Définit le texte du pied de page aligné à gauche et à droite. Les deux sont en majuscules et mis en cache.

void setFooter(String &left, String &right);

• La chaîne gauche s'aligne sur le bord gauche de la région du pied de page
• La chaîne droite s'aligne sur le bord droit de la région du pied de page

drawWrappedText()

Dessinez du texte avec retour à la ligne automatique et alignement central en option.

int drawWrappedText(int x, int y, const String &text, bool center = false);

Modèles courants

Dessiner un écran complet

if (xSemaphoreTake(displayMutex, portMAX_DELAY) == pdTRUE) {
  clearPage();
  display.setFont(u8g2_font_spleen5x8_mu);
  display.drawStr(0, 16, "MAIN CONTENT");
  refreshPage();
  xSemaphoreGive(displayMutex);
}

Mettre à jour l'en-tête uniquement

if (xSemaphoreTake(displayMutex, portMAX_DELAY) == pdTRUE) {
  String headerText = "NEW HEADER"; // case‑insensitive; will be uppercased
  setHeader(headerText);
  // setHeader internally decides whether a refresh is required
  xSemaphoreGive(displayMutex);
}

Dessiner du texte centré avec retour automatique à la ligne

if (xSemaphoreTake(displayMutex, portMAX_DELAY) == pdTRUE) {
  clearPage();
  int lines = drawWrappedText(0, 16, "Long text that will wrap", /*center=*/true);
  (void)lines; // optionally use the line count
  refreshPage();
  xSemaphoreGive(displayMutex);
}

Directives de dessin

if (xSemaphoreTake(displayMutex, portMAX_DELAY) == pdTRUE) {
  // Drawing
  xSemaphoreGive(displayMutex);
}

clearPage();
display.drawStr(0, 16, "Content");
refreshPage();

// Full‑buffer clears cost time and cause visible flicker
// display.clearBuffer();

Considérations sur les performances

• Les mises à jour partielles ne redessinent que les régions que vous avez modifiées
• La mise en cache du texte évite les cycles de dessin/actualisation inutiles
• Le découpage maintient le dessin dans la région prévue et réduit le surdessin
• Les séquences protégées par mutex empêchent le déchirement d'image entre les tâches

Dépannage

Dépendances

Pages connexes