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
Â
