ESP32-S3 + RGB/MIPI-display + GT911 + LVGL: complete ontwikkelhandleiding

Door het technische team van Kadi Display |  www.kadidisplay.com

Waarom ESP32-S3 + GT911 + LVGL een populaire HMI-combinatie is voor de industrie

De ESP32-S3 is uitgegroeid tot een van de meest praktische microcontrollers voor compacte HMI-producten, omdat hij Wi-Fi, Bluetooth LE, een dual-core Xtensa LX7 CPU met een kloksnelheid tot 240 MHz, ruime ondersteuning voor extern Flash/PSRAM en voldoende randapparatuur voor kleine tot middelgrote GUI-projecten combineert. Voor engineers die een goedkope industriële touchscreenmonitor bouwen, betekent dit dat de processor communicatie, besturingslogica en een moderne LVGL-gebruikersinterface kan uitvoeren zonder de kosten of complexiteit van een volledig Linux-platform.

Bij veel embedded displayprojecten gebruikt de displayzijde een RGB TFT LCD of een parallelle interface, terwijl de touchzijde een capacitieve controller zoals de GT911 via I²C gebruikt. LVGL bevindt zich vervolgens boven de hardwarelaag en verwerkt widgets, schermen, gebaren, knoppen, schuifregelaars, grafieken en touchgebeurtenissen. Deze stack is aantrekkelijk voor compacte industriële terminals, smart home-panelen, HMI's voor fabrieken, kleine PLC-achtige dashboards, IoT-gateways, interfaces voor EV-laders en embedded monitoringschermen.

De reden waarom GT911 zo vaak opduikt, is eenvoudig: het is een volwaardige capacitieve multitouch-controller die gebruikt wordt in veel industriële touchmodules van 4,3 inch, 5 inch, 7 inch en op maat gemaakte modules. Hij communiceert via I²C, ondersteunt interruptgestuurde touch-rapportage en kan met een relatief kleine driverlaag in LVGL worden geïntegreerd. De sleutel zit hem niet alleen in het aansluiten van SDA en SCL; een betrouwbare opstart is afhankelijk van de timing van de reset, de adresselectie, de mapping van touchcoördinaten en een correcte registratie van het invoerapparaat in LVGL.

Bij de selectie van een displaymodule is het belangrijk om te weten dat de ESP32-S3 doorgaans goed geschikt is voor SPI-, 8080 parallel- en RGB LCD-projecten. Native MIPI DSI is een ander verhaal. Kadi Display's technische handleiding voor MIPI-interfaceondersteuning Merk op dat de ESP32-S3 geen ingebouwde MIPI DSI-zender heeft; als een ontwerp echt MIPI DSI vereist, hebben ontwikkelaars meestal een bridge-IC of een andere processorfamilie nodig.

Hardwarearchitectuur: Wat is nu precies met wat verbonden?

Een typisch industrieel displayproject met de ESP32-S3 bestaat uit vier lagen: de ESP32-S3 host-microcontroller, het displaypaneel, het GT911 capacitieve touchscreen en de LVGL GUI-laag. De host draait ESP-IDF, LVGL, de displaydriver, de touchdriver, applicatielogica, Wi-Fi of BLE, en soms industriële communicatieprotocollen zoals MQTT, Modbus, CAN of RS485.

Het beeldscherm is meestal SPI, 8080 parallel of RGB op de ESP32-S3. Voor HMI-projecten van 800 x 480 pixels is RGB gebruikelijk omdat het continu pixeldata via de LCD-interface kan doorgeven. De GT911 capacitieve touchcontroller is aangesloten via I²C, met extra RESET- en INT-pinnen. LVGL communiceert niet rechtstreeks met de GT911. Het roept een callback-functie aan voor een geregistreerd invoerapparaat, waarna uw driver de GT911-data leest, deze omzet naar LVGL-coördinaten en rapporteert of het scherm is ingedrukt of losgelaten.

Deze scheiding is belangrijk. Veel problemen met aanraakfunctionaliteit worden toegeschreven aan LVGL, terwijl de werkelijke oorzaak ligt in hardwaretiming, instabiele voeding, onjuiste I²C-pull-upwaarden, een onjuiste resetsequentie of een verkeerde weergavecoördinaat. Een betrouwbaar industrieel ESP32-display vereist een duidelijke scheiding tussen het opstarten van het display, het opstarten van de aanraakfunctionaliteit en de LVGL-integratie.

RGB versus MIPI op ESP32-S3: kies eerst het juiste weergavepad.

Controleer voordat u GT911-code schrijft of weergave interfaceDit voorkomt een van de meest voorkomende ontwerpfouten: het kiezen van een beeldscherm dat de processor niet native kan aansturen. RGB is vaak de beste optie voor ESP32-S3 HMI-schermen in de grootteklasse van 4,3 tot 7 inch. Het ondersteunt continue pixelstreaming en is geschikt voor statische dashboards, instellingenpagina's, grafieken en eenvoudige animaties.

Voor een ESP32 industrieel display biedt RGB een vloeiendere gebruikersinterface dan SPI bij hogere resoluties, maar het vereist meer GPIO-pinnen, nauwkeurige timing, framebufferplanning en voldoende PSRAM-bandbreedte. SPI blijft zinvol voor kleinere displays, terwijl 8080 parallel een tussenoplossing kan zijn voor bepaalde modules. Als het gekozen display alleen MIPI ondersteunt, zijn er drie praktische opties: een bridge-IC gebruiken, een displaymodule kiezen met RGB/SPI/parallelle ingang, of overstappen naar een processor met native ondersteuning. MIPI DSI steun.

Om die reden is de meest gangbare ontwikkelingsroute voor ESP32-S3 HMI-projecten ESP32-S3 + RGB LCD + GT911 + LVGL. Deze configuratie biedt een goede balans tussen kosten, ontwikkelcomplexiteit, schermgrootte en responsiviteit van de gebruikersinterface.

GT911 Bedradingschecklist: I²C, RESET, INT, Voeding en Pull-Ups

De integratie van de GT911 is alleen eenvoudig als de bedrading correct is. De minimaal benodigde aansluitingen omvatten SDA, SCL, RESET, INT, VDD en GND. De PWM-lijn voor de achtergrondverlichting is voor de display-/achtergrondverlichtingsdriver en mag niet worden verward met de aansturing van het touchscreen. In een industriële touchscreenmonitor moeten de I²C-lijnen voor de aanraakfunctionaliteit kort zijn, verbonden met een stabiele massa en zoveel mogelijk gescheiden van de ruisgevoelige schakelpaden voor de achtergrondverlichting en RGB-verlichting.

De RESET-pin is essentieel in een robuust ontwerp. Deze pin biedt de host een gecontroleerde manier om de touchcontroller opnieuw op te starten, het I²C-adres te selecteren en te herstellen van abnormale opstarttoestanden. De INT-pin is bovendien meer dan alleen een interruptlijn. Tijdens een reset speelt deze pin een rol bij de adresselectie op veel GT911-modules. Na een reset kan deze pin worden gebruikt als ingang om nieuwe touchdata te detecteren.

Pull-up weerstanden vormen een andere verborgen bron van storingen. Te zwak, en de signaalovergangen worden traag. Te sterk, en de stroom neemt onnodig toe. Voor korte 3,3 V printplaatsporen zijn waarden rond de 2,2 kΩ tot 4,7 kΩ gangbare uitgangspunten, maar de juiste waarde hangt af van de buscapaciteit, de kabellengte, de routing op de printplaat en of andere I²C-apparaten dezelfde bus delen.

GT911 I²C-adresselectie: de meest voorkomende opstartfout

De GT911 verschijnt doorgaans op een van de twee 7-bits I²C-adressen: 0x5D of 0x14. Het adres wordt tijdens de reset geselecteerd met behulp van de INT-pin. Dit is waar veel gevallen van mislukte GT911-initialisatie beginnen. Technici scannen de I²C-bus, zien geen apparaat en gaan ervan uit dat de controller defect is. In werkelijkheid kan de INT/RST-timing het andere adres hebben geselecteerd, of de INT-pin kan tijdens de reset zwevend zijn.

Een typische resetprocedure is als volgt: configureer RESET en INT als uitgangen, stuur INT hoog of laag om het doeladres te kiezen, trek RESET laag, wacht, laat RESET los, wacht tot de controller is opgestart en verander INT vervolgens terug naar ingang als de interruptmodus wordt gebruikt. Ga er niet vanuit dat alle GT911-panelen hetzelfde resetgedrag vertonen. Sommige FPC-modules bevatten pull-upweerstanden, andere niet, en sommige displayfabrikanten leiden INT anders.

De veiligste werkwijze is om beide adressen in het stuurprogramma te implementeren en ze beide te scannen tijdens de eerste debugfase. Als uw eerste I²C-scan 0x5D vindt, vergrendel dit adres dan pas in het productiestuurprogramma nadat u het gedrag bij een koude start, een softwarematige reset, het in- en uitschakelen van de stroom en het flashen van de firmware hebt bevestigd.

ESP-IDF-projectstructuur voor LVGL + GT911

Een overzichtelijk ESP32-S3 + LVGL-project moet bestanden scheiden op basis van hun verantwoordelijkheid. De displaydriver moet het RGB-lcd-scherm, de framebuffer, de achtergrondverlichting en de LVGL-displayflush-callback initialiseren. De touchdriver moet I²C initialiseren, de GT911 resetten, de touchcoördinaten uitlezen, de GT911-statusregisters wissen wanneer nodig en de schone touchstatus teruggeven aan LVGL.

Een praktische projectstructuur kan de volgende bestanden bevatten: app_main.c, display_rgb.c, touch_gt911.c, lvgl_port.c en een UI-map. Door deze lagen gescheiden te houden, verloopt het debuggen sneller, omdat elk probleem een ​​duidelijke plek heeft. Als het scherm niet ververst, begin dan met het beeldschermstuurprogramma. Als de touchcontroller niet wordt gedetecteerd, begin dan met I²C en reset de timing. Als raw touch werkt, maar de knoppen niet reageren, controleer dan de LVGL-registratie van het invoerapparaat.

Het invoermodel van LVGL verwacht een callback die de invoerstatus rapporteert. Uw GT911-driver leest een punt, converteert dit naar de huidige schermoriëntatie en geeft het resultaat door aan LVGL als PRESSED of RELEASED. LVGL moet coördinaten ontvangen in dezelfde oriëntatie als de schermbuffer. Als het LCD-scherm is gedraaid, gespiegeld of ondersteboven is gemonteerd, moeten de aanraakcoördinaten worden getransformeerd voordat ze aan LVGL worden doorgegeven.

GT911 Touch-gegevens uitlezen: De driverlaag

Een GT911-leesroutine volgt normaal gesproken een eenvoudig patroon: lees het aanraakstatusregister, controleer of er een geldig aanraakpunt beschikbaar is, lees de coördinatengegevens, converteer ruwe coördinaten naar weergavecoördinaten, wis de statusvlag indien nodig en retourneer de druk-/loslaatstatus naar LVGL. De exacte registernamen en byte-indeling moeten altijd worden gecontroleerd aan de hand van de GT911-programmeerhandleiding en de specifieke moduleconfiguratie van de fabrikant van het aanraakpaneel.

In de praktijk is het eerste doel niet het integreren van gebaren. Het eerste doel is om betrouwbaar ruwe coördinaten af ​​te drukken. Raak de vier hoeken en het midden van het scherm aan. Controleer of de waarden consistent veranderen en of de maximale waarden overeenkomen met het actieve gebied van de sensor. Pas nadat de ruwe data stabiel is, kun je LVGL-mapping, filtering en gebarenfunctionaliteit toevoegen.

Vermijd het kopiëren van willekeurige drivercode zonder de schermresolutie, coördinatenoriëntatie en I²C-adresselectie te controleren. Een driver die is geschreven voor een scherm van 1024 x 600 pixels kan weliswaar compileren voor een scherm van 800 x 480 pixels, maar produceert dan gespiegelde, geschaalde of afwijkende coördinaten.

Coördinatenmapping: Wanneer aanraken wel werkt, maar verkeerd aanvoelt

Een van de meest frustrerende problemen met LVGL-touchbediening is wanneer de GT911 touchpunten rapporteert, maar de coördinaten niet overeenkomen met het scherm. De gebruiker tikt op een knop aan de linkerkant en LVGL reageert aan de rechterkant. Boven en onder zijn omgewisseld. X en Y zijn verwisseld. Slechts een deel van het scherm reageert. Dit zijn meestal problemen met het coördinatensysteem, geen defecten aan de touchcontroller.

De displaycontroller, de LVGL-rotatie-instelling, de fysieke LCD-oriëntatie en de GT911-configuratie moeten allemaal overeenkomen. Als dit niet het geval is, moet de coördinatenmapping worden toegepast na het uitlezen van de GT911, maar vóór het rapporteren aan LVGL. Veelgebruikte transformaties zijn onder andere x = breedte – 1 – x, y = hoogte – 1 – y, het verwisselen van X en Y, of het toepassen van een schaal en een offset.

Voor de ontwikkeling van hoogwaardige embedded GUI's is het belangrijk om transformaties niet blindelings te hardcoderen. Print de ruwe GT911-coördinaten op de vier hoeken van het paneel. Bepaal vervolgens of het probleem te maken heeft met verwisseling, spiegeling, schaling of verschuiving. Deze eenvoudige test kan urenlang misleidend debuggen in LVGL voorkomen.

Initialisatievolgorde: een betrouwbare opstartsequentie

Voor een stabiel ESP32-S3 GT911 LVGL-project is de initialisatievolgorde belangrijk. Een betrouwbare volgorde is: initialiseer de voedingslijnen en de GPIO-pinnen voor de achtergrondverlichting, maar houd de achtergrondverlichting uitgeschakeld; initialiseer I²C; configureer de RESET- en INT-pinnen van de GT911; voer een hardware-reset en adresselectie uit op de GT911; scan of probe de GT911 op 0x5D en 0x14; initialiseer het RGB LCD-paneel en de framebuffer; initialiseer de LVGL-tick en de displaydriver; registreer het LVGL-touch-invoerapparaat; en schakel tot slot de achtergrondverlichting in na het eerste geldige frame.

Dit voorkomt een veelvoorkomend probleem voor de gebruiker: een fel wit of ruisend scherm verschijnt voordat de gebruikersinterface gereed is. Het scheidt ook het opstarten van de aanraakfunctionaliteit van het scherm, wat debuggen vereenvoudigt. Onjuiste RGB-timing kan flikkering, verschoven beelden, tearing of een instabiele schermverversing veroorzaken die op een LVGL-probleem lijkt. De timingwaarden van het LCD-scherm moeten overeenkomen met de specificaties in het specificatieblad van het paneel, inclusief de actieve resolutie, pixelklok, synchronisatiebreedte en porch-instellingen.

Bij industriële HMI-producten verbetert een gecontroleerde opstart ook de kwaliteitsbeleving. Een apparaat dat opstart met een schoon logo en vervolgens de applicatie start, voelt betrouwbaarder aan dan een apparaat dat willekeurige pixels laat knipperen voordat de grafische gebruikersinterface (GUI) verschijnt.

Veelvoorkomende problemen met de GT911 + LVGL en hoe je ze kunt oplossen

Een mislukte initialisatie van de GT911 betekent meestal dat de host niet met de controller kan communiceren. Begin met het controleren van de voeding, massa, reset-timing, INT-status, pull-upweerstanden en het I²C-adres. Verlaag de bussnelheid naar 100 kHz tijdens het opstarten. Scan zowel 0x5D als 0x14. Controleer de RESET-golfvorm indien mogelijk met een oscilloscoop of logische analysator.

Het probleem dat de GT911-touchscreenfunctie niet werkt in LVGL kan zich voordoen, zelfs als de I²C-communicatie wel werkt. Controleer in dat geval of LVGL het invoerapparaat heeft geregistreerd, of de leescallback wordt aangeroepen, of de driver de waarden PRESSED en RELEASED correct retourneert en of de coördinaten binnen de schermresolutie vallen. Voeg logberichten toe aan de callback voordat u hardwarewijzigingen doorvoert.

Onjuiste aanraakcoördinaten vereisen meestal een hermapping. Valse dubbelklikken of spookaanrakingen worden vaak veroorzaakt door ruis op de I²C-lijnen, een zwakke massa, interferentie van de backlight-driver, water op het afdekglas of onvoldoende filtering. RGB-display tearing tijdens LVGL-updates heeft meestal niets te maken met de GT911; het wijst vaak op een probleem met de framebufferstrategie, de PSRAM-bandbreedte of de LCD-timing.

Prestatieplanning: Wat de ESP32-S3 redelijkerwijs aankan.

De ESP32-S3 is krachtig voor een microcontroller, maar het is geen desktop-GPU. Een SPI-scherm van 240 x 320 is geen probleem. Een paneel van 480 x 480 is haalbaar. Een industriële RGB HMI van 800 x 480 is praktisch met een zorgvuldige planning van PSRAM en buffers. Hogere resoluties kunnen in sommige gevallen werken, maar ze worden dan gevoeliger voor bandbreedte en laten minder ruimte over voor Wi-Fi, animatie, datalogging en communicatietaken.

Voor industriële HMI's is 800 x 480 vaak de praktische bovengrens voor ESP32-S3 RGB-projecten. Het werkt prima voor dashboards, bedieningspanelen en statusschermen, vooral als de gebruikersinterface geen animaties of video's over het volledige scherm bevat. Gebruik waar mogelijk gedeeltelijke updates. Vermijd onnodige transparantie en grote geanimeerde widgets. Houd schermovergangen eenvoudig. Het doel is een betrouwbaar bedieningspaneel, geen animatiedemo in smartphonestijl.

Als de toepassing een resolutie van 1024 x 600 of hoger, een hoge framesnelheid, video of complexe grafieken vereist, overweeg dan of een Linux-compatibele processor of een native MIPI-platform op de lange termijn een betere keuze zou zijn.

Aantekeningen over industrieel ontwerp: Voorbij het demonstratiebord

Een demonstratie van een werkend bureau is niet hetzelfde als een capacitief touchscreen industrieel displayVoor implementatie in het veld moet rekening worden gehouden met ESD-bescherming, afdekglas, optische verbindingen, achtergrondverlichting, stroomstabiliteit, EMI-layout, connectorvergrendeling, thermisch ontwerp en levenscyclusondersteuning. Touchpanels zijn interfaces die direct door mensen worden gebruikt, dus de connector- en afdekglasgebieden moeten worden beschermd tegen elektrostatische ontlading.

De dikte, hardheid, AG/AR/AF-coating en verlijming van het afdekglas beïnvloeden zowel de duurzaamheid als de aanraakgevoeligheid. Voor displays die buiten worden gebruikt of displays met een hoge helderheid, verbetert optische verlijming de leesbaarheid en de mechanische sterkte. PWM-dimmen moet zichtbare flikkering voorkomen en voor displays die buiten worden gebruikt, moet helderheidsregeling op basis van omgevingslicht worden overwogen.

Stroomstabiliteit verdient speciale aandacht. De ESP32-S3, het RGB-lcd-scherm, de achtergrondverlichting en het touchscreen mogen geen zwakke spanningsregelaar delen die tijdens wifi-transmissie of het opstarten van de achtergrondverlichting inzakt. RGB-lijnen schakelen continu, dus houd de I²C-interface van het touchscreen uit de buurt van snelle displaycircuits en de voedingscircuits van de achtergrondverlichting. Industriële betrouwbaarheid komt van deze details, niet alleen van het ontwikkelingsbord.

Samenvatting

Het aansluiten van een GT911 capacitief touchscreen op LVGL via een ESP32-S3 is niet moeilijk, maar het kan gemakkelijk misgaan als het project begint met gekopieerde drivercode in plaats van een duidelijk hardwareplan. De betrouwbare aanpak is om eerst een ESP32-S3-compatibele display-interface te kiezen, meestal RGB voor middelgrote HMI-schermen, vervolgens de GT911 te activeren via een gecontroleerde I²C-resetsequentie, het adres te bevestigen, de ruwe touchcoördinaten te verifiëren, deze te koppelen aan de LCD-oriëntatie en ten slotte de LVGL-inputcallback te registreren.

Bij industriële projecten begint het echte werk pas nadat de demo draait. ESD-bescherming, stroomstabiliteit, industriële TFT LCD-modulesDe timing van het display, de PSRAM-bandbreedte, de ruis van de achtergrondverlichting, de aanraakfiltering en de mechanische integratie bepalen of het product betrouwbaar blijft in de praktijk. Een overzichtelijke ESP32-S3 + RGB LCD + GT911 + LVGL-architectuur kan veel compacte industriële HMI-toepassingen ondersteunen, maar alleen als de display-interface, de aanraakcontroller en de LVGL-poort als één systeem zijn ontworpen.

GT911 bedradingsreferentietabel

Probleemoplossingsmatrix

Bronvermeldingen

Voor informatie over de Espressif ESP32-S3 en de ESP-IDF RGB LCD-documentatie werd gebruikgemaakt van de mogelijkheden van de microcontroller en de architectuur van het RGB LCD-scherm.

Het I²C-adres, het resetgedrag en de touchcontroller-concepten van de GT911 moeten worden geverifieerd aan de hand van de GT911-programmeerhandleiding en de specifieke configuratie van de leverancier van het touchpanel.

De callback-concepten voor invoerapparaten in LVGL werden afgestemd op de officiële documentatie van invoerapparaten in LVGL.

De technische pagina's van Kadi Display werden gebruikt als voorgestelde interne links voor informatie over de MIPI-interface, de selectie van de display-interface, industriële TFT LCD-modules en de integratie van capacitieve touchscreens voor industrieel gebruik.

Vrijwaring

Vrijwaring: Dit artikel is bedoeld voor technisch onderwijs en SEO/GEO-contentplanning. Het gedrag van GT911-registers, de resettiming, het coördinatenformaat en de I²C-adresselectie moeten worden geverifieerd aan de hand van de officiële GT911-programmeerhandleiding en het specifieke datasheet van de leverancier van het touchpanel. De prestaties van het ESP32-S3-display zijn afhankelijk van de ESP-IDF-versie, de PSRAM-configuratie, de LCD-timing, de framebufferstrategie, de PCB-layout en de applicatiebelasting. Merknamen zoals Espressif, ESP32, LVGL, Goodix en Kadi Display behoren toe aan hun respectievelijke eigenaren.