Bibliothek zum programmieren
Für das programmieren des Displays verwende ich die Bibliothek von Waveshare. Diese kannst du kostenfrei vom GitHub Repository https://github.com/waveshare/e-Paper herunterladen und in der Arduino IDE über "Sketch" > "Bibliothek einbinden" > "ZIP Bibliothek hinzufügen ..." einbinden.
Beispiel I - Ausgabe von "Hallo Welt!"
Im ersten Beispiel, wollen wir nun den Text "Hallo Welt!" auf dem Display anzeigen.
Zunächst benötigen wir die Bibliotheken zur Kommunikation mit dem Display.
#include
#include "epd1in54.h"
#include "epdpaint.h"
Zusätzlich benötigen wir zwei Platzhalter für die Farbe Schwarz = 0 und Weiß = 1, diese Platzhalter werden später vom Compiler durch die entsprechenden Werte ersetzt.
#define COLORED 0
#define UNCOLORED 1
Erstellen von Objekten für das spätere schreiben von Daten
unsigned char image;
Paint paint(image, 0, 0);
Epd epd;
prüfen ob das Display korrekt initialisiert wurde
Serial.begin(9600);
if (epd.Init(lut_full_update) != 0) {
Serial.print("e-Paper init failed");
return;
} else {
Serial.print("e-Paper init ok");
}
löschen des Inhalts auf dem Display
epd.ClearFrameMemory(0xFF);
epd.DisplayFrame();
epd.ClearFrameMemory(0xFF);
epd.DisplayFrame();
drehen des Displays um 90° und definieren der Zeichenfläche von 200 x 40 Pixel
paint.SetRotate(ROTATE_0);
paint.SetWidth(200);
paint.SetHeight(40);
Füllen der Zeichenfläche mit der Hintergrundfarbe "weiß"
paint.Clear(UNCOLORED);
schreiben des Textes "Hallo Welt!" auf die Zeichenfläche und setzen des Frames
paint.DrawStringAt(10, 4, "Hallo Welt!", &Font12, COLORED);
epd.SetFrameMemory(paint.GetImage(), 0, 10, paint.GetWidth(), paint.GetHeight());
Es stehen die Schriftgrößen 8, 12, 16, 20, und 24 zur Verfügung.
zuletzt, aktivieren des Frames
epd.DisplayFrame();
delay(2000);
Der gesamte Sketch:
#include
#include "epd1in54.h"
#include "epdpaint.h"
#include "imagedata.h"
#define COLORED 0
#define UNCOLORED 1
unsigned char image;
Paint paint(image, 0, 0);
Epd epd;
void setup() {
Serial.begin(9600);
if (epd.Init(lut_full_update) != 0) {
Serial.print("e-Paper init failed");
return;
} else {
Serial.print("e-Paper init ok");
}
epd.ClearFrameMemory(0xFF);
epd.DisplayFrame();
epd.ClearFrameMemory(0xFF);
epd.DisplayFrame();
paint.SetRotate(ROTATE_0);
paint.SetWidth(200);
paint.SetHeight(40);
paint.Clear(UNCOLORED);
paint.DrawStringAt(10, 4, "Hallo Welt!", &Font12, COLORED);
epd.SetFrameMemory(paint.GetImage(), 0, 10, paint.GetWidth(), paint.GetHeight());
epd.DisplayFrame();
delay(2000);
}
void loop() {}
Hier nun der Quellcode zum bequemen Download:
Beispiel II - zeichnen von Geometrischen Figuren
In diesem Abschnitt möchte ich dir zeigen, wie du einfache geometrische Figuren auf dem 1,54 Zoll E-Paper Display zeichnest.
Ein E-Paper Display ist eigentlich dafür ausgelegt Texte und Grafiken wie in einer Tageszeitung anzuzeigen und daher ist die Aktualisierung des Displays dementsprechend träge.
Möchtest du also Geometrische Figuren als Animation drehen usw. dann empfehle ich dir ein TFT oder OLED Display zu verwenden.
Methoden zum zeichnen von einfachen Geometrischen Figuren
An dem bereits bekannten Paint Objekt gibt es die Methoden:
void DrawPixel(int x, int y, int colored);
void DrawLine(int x0, int y0, int x1, int y1, int colored);
void DrawHorizontalLine(int x, int y, int width, int colored);
void DrawVerticalLine(int x, int y, int height, int colored);
void DrawRectangle(int x0, int y0, int x1, int y1, int colored);
void DrawFilledRectangle(int x0, int y0, int x1, int y1, int colored);
void DrawCircle(int x, int y, int radius, int colored);
void DrawFilledCircle(int x, int y, int radius, int colored);
siehe https://github.com/waveshare/e-Paper/blob/master/Arduino/epd1in54/epdpaint.h
Kreise
Zunächst zeichnen wir einen einen einfachen Kreis und einen gefüllten Kreis.
Als Grundgerüst verwende ich den bereits bekannten Quellcode aus dem ersten Beispiel.
//definieren der Zeichenfläche
paint.SetWidth(64);
paint.SetHeight(64);
//Hintergrundfarbe unserer Zeichenfläche
paint.Clear(UNCOLORED);
//einen Kreis zeichnen,
//Koordinate X = 15, Y = 15,
//Durchmesser 10
//Farbe schwarz
paint.DrawCircle(15, 15, 10, COLORED);
//schreiben der Zeichenfläche (64 x 64) auf dem Display von
//der Koordinate X = 60, Y = 30
epd.SetFrameMemory(paint.GetImage(), 60, 30, paint.GetWidth(), paint.GetHeight());
paint.Clear(UNCOLORED);
paint.DrawFilledCircle(15, 15, 10, COLORED);
epd.SetFrameMemory(paint.GetImage(), 60, 90, paint.GetWidth(), paint.GetHeight());
Rechtecke
Wie man Kreise zeichnet wissen wir nun, bei einem Rechteck benötigen wir neben der ersten Koordinate auch eine zweite. Aus der letzten Koordinate berechnet sich somit die Kantenlänge des Rechtecks.
//definieren der Zeichenfläche
paint.SetWidth(64);
paint.SetHeight(64);
//Hintergrundfarbe unserer Zeichenfläche
paint.Clear(UNCOLORED);
//einfaches Rechteck zeichnen
//Koordinate "start" X = 15, Y = 15
//Koordinate "ende" X = 30, Y = 30
//Farbe schwarz
paint.DrawRectangle(15,15, 30,30, COLORED);
epd.SetFrameMemory(paint.GetImage(), 30, 90, paint.GetWidth(), paint.GetHeight());
//gefülltes Rechteck zeichnen
//Koordinate "start" X = 15, Y = 15
//Koordinate "ende" X = 30, Y = 30
//Farbe schwarz
paint.DrawFilledRectangle(15,15, 30,30, COLORED);
epd.SetFrameMemory(paint.GetImage(), 60, 90, paint.GetWidth(), paint.GetHeight());
epd.DisplayFrame();
Linien
Um Linien zu zeichnen benötigen wir wiederum zwei Koordinaten einmal für den Start und zum anderen für das Ende.
Es gibt "normale" Linien mit zwei zu definierbaren Koordinaten (start & ende), mit dieser Art Linie können auch Winkel erzeugt werden. Des Weiteren gibt es horizontale und vertikale Linien diese kommen mit jeweils einer Koordinate daher benötigen aber zusätzlich die Länge bzw. die Breite in Pixel.
//definieren der Zeichenfläche
paint.SetWidth(64);
paint.SetHeight(64);
//Hintergrundfarbe unserer Zeichenfläche
paint.Clear(UNCOLORED);
//"normale" Linie mit
//Koordinate "start" X = 15, Y = 15,
//Koordinate "ende" X = 45, Y = 45
//Farbe schwarz
paint.DrawLine(15, 15, 45, 45, COLORED);
epd.SetFrameMemory(paint.GetImage(), 60, 30, paint.GetWidth(), paint.GetHeight());
//Hintergrundfarbe unserer Zeichenfläche
paint.Clear(UNCOLORED);
//"normale" horizontale Linie mit
//Koordinate X = 15, Y = 15,
//Länge 30
//Farbe schwarz
paint.DrawHorizontalLine(15, 15, 30, COLORED);
epd.SetFrameMemory(paint.GetImage(), 60, 60, paint.GetWidth(), paint.GetHeight());
//Hintergrundfarbe unserer Zeichenfläche
paint.Clear(UNCOLORED);
//"normale" horizontale Linie mit
//Koordinate X = 15, Y = 15,
//Höhe 30
//Farbe schwarz
paint.DrawVerticalLine(15, 15, 30, COLORED);
epd.SetFrameMemory(paint.GetImage(), 60, 90, paint.GetWidth(), paint.GetHeight());
Quellcode
Hier nun der gesamte Quellcode zum zweiten Beispiel zum Download
Video
