Image of eBits Academy airquality illustration

Importera bibliotek – Serien om en luftkvalitetsstation, avsnitt 9

  • March 04, 2025
  • |
  • Teofil Corad

VIKTIGT – Manuell installation av TFT_eSPI-biblioteket krävs

Manuell installation:

  1. Ladda ner och packa upp den bifogade ZIP-filen.
  2. Gå till din Library-mapp och placera mappen TFT_eSPI där:
    • Linux: /home/{brugernavn}/Arduino/Libraries
    • Windows: C:\Users\{brugernavn}\Documents\Arduino\Libraries
    • MacOS: /Users/{brugernavn}/Documents/Arduino/Libraries
  3. Hämta ZIP-filen längst ner i lektionen (om den finns tillgänglig).

Lista över nödvändiga komponenter:

 

 


Lektionens syfte

Syftet med den här lektionen är att hjälpa dig att förstå begreppet bibliotek i Arduino IDE, deras betydelse för att förenkla koden och hur du installerar och hanterar dem korrekt. Detta lägger grunden för att arbeta med mer komplexa komponenter senare i kursen, som sensorer och skärmar, genom att använda bibliotekens funktioner.


Vad är bibliotek?

I Arduino-programmering är bibliotek samlingar av färdigskriven kod som gör det enklare att implementera funktioner utan att börja helt från grunden. I stället för att uppfinna hjulet på nytt hanterar biblioteken komplexa operationer på låg nivå, så att du kan fokusera på logiken i ditt program.

Exempel:

  • TFT-skärmar: Ett bibliotek hanterar kommunikationen med skärmen så att du inte själv behöver skriva koden på låg nivå som kommunicerar med skärmens styrenhet.
  • WiFi-anslutningar: Du behöver inte heller skriva kod manuellt för att upprätta en nätverksanslutning – WiFi-bibliotek kan automatisera processen.

Kort sagt hjälper bibliotek dig att fokusera på ditt projekt i stället för på hårdvarans detaljer.


Steg 1: Öppna Library Manager i Arduino IDE

Library Manager är en viktig funktion i Arduino IDE. Det är ett arkiv med bibliotek som gör det enkelt att söka efter, installera och hantera bibliotek för dina projekt.

  1. Öppna Library Manager:

    • I Arduino IDE klickar du på Sketch-menyn, sedan Include Libraryoch slutligen Manage Libraries…. Då öppnas Library Manager-fönstret.
  2. Söka efter bibliotek:

    • Överst i Library Manager-fönstret finns ett sökfält. Om du till exempel vill styra en TFT-skärm kan du söka efter TFT_eSPI-biblioteket.
  3. Installera bibliotek:

    • Klicka på biblioteket när du hittar det du behöver. Då visas en Install-knapp. Klicka på knappen för att installera biblioteket i din Arduino-miljö.
    • Du kan sedan använda biblioteket i din kod genom att inkludera det i din sketch med #include.

Den här processen gör att du slipper ladda ner och placera bibliotek i Arduino-mappen manuellt och gör arbetsflödet effektivare.


Steg 2: Importera och använda bibliotek

När du har installerat nödvändiga bibliotek via Library Manager kan du inkludera dem i dina sketchar med #include-direktivet högst upp i koden. Det talar om för kompilatorn att hämta biblioteket och dess funktioner.

Här är några exempel på hur du inkluderar viktiga bibliotek för projektet:

#include <WiFi.h>
#include <WebServer.h>
#include <Adafruit_AHTX0.h>
#include <math.h>
#include <TFT_eSPI.h>
#include <SPI.h>

När du inkluderar dessa bibliotek kan du använda deras färdiga funktioner. Till exempel:

  • Du kan använda tft.fillScreen() för att enkelt rensa eller ändra bakgrunden på skärmen.
  • Funktioner som tft.drawString() låter dig skriva ut text på skärmen utan att behöva tänka på kommunikationen på låg nivå.

Exempel på hur ett bibliotek används

För att visa hur bibliotek förenklar arbetet får du här ett snabbt exempel med TFT_eSPI-biblioteket för en TTGO T-Display. Målet är att initiera skärmen och skriva ut lite text.

#include <TFT_eSPI.h> // Inkluder TFT-biblioteket

TFT_eSPI tft = TFT_eSPI(); // Opret et display-objekt

void setup() {
  tft.init(); // Initialiser displayet
  tft.fillScreen(TFT_BLACK); // Ryd skærmen med sort baggrund
  tft.setTextColor(TFT_WHITE, TFT_BLACK); // Sæt tekstfarve
  tft.drawString("Welcome!", 10, 20, 4); // Skriv tekst på koordinaterne (10, 20) med skriftstørrelse 4
}

void loop() {
  // Her kan du opdatere skærmen med nye data
}

 

Med bara några rader kod gör biblioteket det möjligt att styra skärmen – initiera den, ange färger och skriva ut text – utan att du behöver förstå hur skärmens styrenhet fungerar internt.


Steg 3: Hantera och uppdatera bibliotek

Korrekt bibliotekshantering säkerställer att ditt projekt förblir funktionellt och uppdaterat. Här är några användbara tips:

  1. Uppdatera bibliotek:

    • Ibland kan du behöva uppdatera bibliotek för att säkerställa kompatibilitet med nya versioner av Arduino IDE eller få nya funktioner. I Library Manager kan du se om det finns uppdateringar för installerade bibliotek och uppdatera dem med ett enda klick.
  2. Avinstallera bibliotek:

    • Om du behöver ta bort ett bibliotek kan du avinstallera det via Library Manager. Hitta biblioteket och välj Uninstall.
  3. Lägga till bibliotek manuellt:

    • Ibland behöver du installera ett bibliotek manuellt om det inte finns i Library Manager. Då kan du ladda ner biblioteket som en ZIP-fil och använda Sketch > Include Library > Add .ZIP Library… för att installera det.

Steg 4: Vanliga biblioteksproblem och felsökning

  1. Library Not Found Error:

    • Om du får ett felmeddelande om att ett bibliotek inte kan hittas ska du kontrollera att det är korrekt installerat via Library Manager och att din #include-sats är rättstavad.
  2. Bibliotekskonflikter:

    • Ibland kan flera versioner av samma bibliotek skapa konflikter. Du kan lösa det genom att avinstallera äldre versioner eller ange vilken version du vill använda i Library Manager.
  3. Versionskompatibilitet:

    • Vissa bibliotek är beroende av specifika kortversioner eller versioner av Arduino IDE. Kontrollera alltid dokumentationen för att säkerställa att biblioteksversionen är kompatibel med din installation.

Sammanfattning

I den här lektionen har du introducerats till begreppet bibliotek i Arduino IDE. Bibliotek är kraftfulla verktyg som sparar tid och minskar komplexiteten genom att tillhandahålla färdigskrivna funktioner för hårdvarukomponenter och mycket annat. Du har nu lärt dig hur du söker efter, installerar och inkluderar bibliotek i dina sketchar med hjälp av Library Manager i Arduino IDE.

I kommande lektioner tittar vi närmare på hur du använder specifika bibliotek för att arbeta med hårdvara som sensorer och skärmar. Kunskapen om hur du hanterar bibliotek gör det enklare att lägga till mer avancerade funktioner i dina IoT-projekt.

Om mätningarna: Stationen i den här serien mäter temperatur och relativ luftfuktighet med AHT10. Det är mätningar av inomhusklimatet, inte direkta mätningar av CO2, VOC eller partiklar. Seriens benämning ”luftkvalitetsövervakning” ska förstås med denna begränsning.

Lämna en kommentar

Observera att kommentarer måste godkännas innan de publiceras.