Weergaveservice

Overzicht

De weergaveservice is een globale, threadveilige wrapper rond de U8G2-driver voor een 128×64 SSD1306 OLED. U gebruikt deze om tekst en grafische elementen vanuit elke taak weer te geven zonder flikkering of beeldscheuren. Een FreeRTOS-mutex garandeert exclusieve toegang terwijl u tekent; helperfuncties zorgen voor het wissen van regio's, gedeeltelijk vernieuwen, knippen en tekstcaching.

Vereisten

• ESP32 met hardware I2C beschikbaar
• U8G2-bibliotheek geïntegreerd in uw firmware-build
• FreeRTOS (voor de displaymutex)
• Pinnen geconfigureerd voor SDA/SCL in de Pins.h van uw bord

Hardwareconfiguratie

Indelingsmodel

Het scherm wordt behandeld als een raster van cellen van 8×8 pixels:

• Raster: 8 rijen × 16 kolommen
• Oorsprong: (0,0) linksboven
• Celgrootte: 8×8 pixels

Regio's

Threadveiligheid

De weergaveservice biedt een FreeRTOS-mutex. Vergrendel deze altijd voordat u tekent en ontgrendel de mutex wanneer u klaar bent.

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

extern SemaphoreHandle_t displayMutex;

Basisgebruikspatroon

// 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);
}

Initialisatie

Roep één keer initDisplay() op bij het opstarten.

#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);
}

Wishelpers

Wis efficiënt alleen wat u opnieuw wilt tekenen. Alle helpers gebruiken intern updateDisplayArea() om de getroffen regio gedeeltelijk te vernieuwen.

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

Vernieuwingshelpers

Roep een vernieuwingshelper op nadat u een regio hebt gewijzigd. Deze voeren minimale updates uit op het display.

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

Inhoudhelpers

setHeader()

Stelt de koptekst in. De service zet de laatste waarde om in hoofdletters en slaat deze op in de cache om onnodig opnieuw tekenen te voorkomen.

void setHeader(String &text);

setFooter()

Stelt de links- en rechts uitgelijnde voettekst in. Beide zijn in hoofdletters en in de cache opgeslagen.

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

• De linkertekenreeks wordt uitgelijnd met de linkerrand van het voettekstgebied
• De rechtertekenreeks wordt uitgelijnd met de rechterrand van het voettekstgebied

drawWrappedText()

Teken tekst met automatische tekstterugloop en optionele middenuitlijning.

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

Algemene patronen

Teken een volledig scherm

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

Werk alleen de koptekst bij

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);
}

Teken gecentreerde tekst met automatische regelafbreking

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);
}

Richtlijnen tekenen

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();

Prestatieoverwegingen

• Bij gedeeltelijke updates worden alleen de regio's opnieuw getekend die u hebt gewijzigd
• Tekstcaching vermijdt onnodige teken-/vernieuwingscycli
• Door te knippen blijft het tekenen binnen het beoogde gebied en wordt overtekenen beperkt
• Door mutex beveiligde reeksen voorkomen beeldscheuren midden in een frame tussen taken

Problemen oplossen

Afhankelijkheden

Gerelateerde pagina's