Przyjrzyjmy się programowi. Część główna znajduje się w pliku main.cpp. Na początku kodu znajduje się załączenie bibliotek potrzebnych do działania programu:
|
1 2 3 4 5 6 7 8 |
#include <stdio.h> #include <stdlib.h> #include "epd2in7b.h" #include "imagedata.h" #include "epdpaint.h" #define COLORED 1 #define UNCOLORED 0 |
Następnie sprawdzane jest połączenie z wyświetlaczem. W przypadku braku poprawnego połączenia w konsoli zostanie wyświetlony błąd o treści e-Paper init failed. Obraz na ekranie jest również zerowany.
|
1 2 3 4 5 6 7 |
unsigned char* frame_buffer_black = (unsigned char*)malloc(epd.width / 8 * epd.height); unsigned char* frame_buffer_red = (unsigned char*)malloc(epd.width / 8 * epd.height); Paint paint_black(frame_buffer_black, epd.width, epd.height); Paint paint_red(frame_buffer_red, epd.width, epd.height); paint_black.Clear(UNCOLORED); paint_red.Clear(UNCOLORED); |
Następnie zapisywane są do bufora takie elementy jak: tekst E-papier Demo (czarna czcionka), Hello Word (biały tekst na czerwonym tle) oraz różne figury geometryczne:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
/* Draw something to the frame_buffer */ /* For simplicity, the arguments are explicit numerical coordinates */ paint_black.SetRotate(ROTATE_0); paint_red.SetRotate(ROTATE_0); paint_black.DrawStringAt(4, 50, "e-Paper Demo", &Font20, COLORED); paint_black.DrawRectangle(10, 130, 50, 180, COLORED); paint_black.DrawLine(10, 130, 50, 180, COLORED); paint_black.DrawLine(50, 130, 10, 180, COLORED); paint_black.DrawCircle(120, 150, 30, COLORED); paint_red.DrawFilledRectangle(10, 200, 50, 250, COLORED); paint_red.DrawFilledRectangle(0, 76, 176, 96, COLORED); paint_red.DrawFilledCircle(120, 220, 30, COLORED); paint_red.DrawStringAt(18, 80, "Hello world!", &Font16, UNCOLORED); |
Wykorzystano tutaj następujące funkcje:
- DrawStringAt – wyświetlanie tekstu
- DrawRectangle – wyświetlanie prostokąta (pustego w środku)
- DrawLine – wyświetlanie linni prostej
- DrawCircle – wyświetlanie okręgu
- DrawFilledRectangle – wyświetlanie prostokąta (wypełnionego)
- DrawFilledCircle – wyświetlanie koła (wypełnionego)
Każda funkcja posiada posiada posiada prefix określający kolor wyświetlanego elementu/tekstu:
- paint_red – kolor czerwony
- paint_black – kolor czarny
Funkcje do wyświetlania tekstu mają dodatkowo wybór wielkości czcionki: font8, font12, font20 lub font24.
Aby wyświetlić przygotowany bufor należy wywołać kod:
|
1 2 |
/* Display the frame_buffer */ epd.DisplayFrame(paint_black.GetImage(), paint_red.GetImage()); |
Na końcu programu znajduje się kod wyświetlający grafikę:
|
1 2 |
/* Display the image buffer */ epd.DisplayFrame(IMAGE_BLACK, IMAGE_RED); |
Kod opisujący wyświetlaną grafikę znajduje się w pliku imagedata.cpp.
Aby wyświetlić własną grafikę, należy ją odpowiednio przygotować. Można tego dokonać za pomocą prostego programu Image2Lcd (do pobrania z strony Waveshare – LINK lub w sekcji do pobrania). Po pobraniu oraz rozpakowaniu archiwum, należy uruchomić program:
Rysunek 4. Okno programu Image2Lcd
Uprzednio przygotowaną grafikę (o rozmiarze 264 x 176 pikseli), należy załadować do programu wybierając przycisk Open (najlepiej dysponować plikiem z rozszerzeniem .bmp). Po załadowaniu grafiki należy ustawić następujące parametry:
- Output file type: C array (*.c)
- Scan mode: Vertical Scan
- BitPixel: monochrome
- Max Width and Height: 264 x 176
- Zaznaczona opcja: Scan Right to Left
Nasz rysunek powinien wyglądać następująco:
Rysunek 5. Przerobiona grafika w programie Image2Lcd
Tak przygotowany plik musimy zapisać. Należy jeszcze przygotować grafikę dla barwy czerwonej. Jeżeli nie chcemy czerwonych elementów, tworzymy pustą grafikę i również zapisujemy jako C array.
Gdy już mamy przygotowane pliki C array dla barwy czarnej i czerwonej otwieramy plik imagedata.cpp (uprzednio tworząc jego kopię) np. w programie notepad++.
Teraz zamiast domyślnej grafiki, w miejsce
|
1 2 3 4 |
const unsigned char IMAGE_BLACK[5808] = { /* 0X01,0X01,0X08,0X01,0XB0,0X00, */ 0X00,0X00,0X00,0X00,0X00,0X03,0XFF,0XFF,0XFF,0XFF,0XFF,0XFF,0XFF,0XFF,0XFF,0X80, 0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X03,0XFF,0XFF,0XFF,0XFF, [...] |
Wklejamy przygotowaną przez nasz grafikę (należy przekopiować sam rysunek; nagłówek const unsigned char IMAGE_BLACK[5808] zachować).
Analogiczne postępujemy dla barwy czerwonej
|
1 2 3 4 5 |
const unsigned char IMAGE_RED[5808] = { /* 0X01,0X01,0X08,0X01,0XB0,0X00, */ 0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00, 0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00, 0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00, 0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00,0X00, |
Przenosimy plik imagedata.cpp do pamięci Raspberry pi oraz ponownie kompilujemy program poleceniem:
|
1 |
make |
Oraz uruchamiamy poleceniem:
|
1 |
sudo ./epd |
Jeżeli wszystko skompilowało się i uruchomiło bez błędów, na ekranie pojawi się logo portalu mikrokontroler:
Rysunek 6. Logo portalu mikrokontroler.pl na ekranie EPAPIER
