// GxFont_GFX_Example : example to show the use of additional fonts rendering these fonts // // Author : J-M Zingg // // Version : see library.properties // // License: GNU GENERAL PUBLIC LICENSE V3, see LICENSE // // Library: https://github.com/ZinggJM/GxEPD // // NOTE: you need to SAVE the modified example to a saveable location for UTF-8 characters to work // e.g. for Umlauts // for use of additional fonts you need to enable these in file GxFont_GFX.h // and install the library // // selection of the additional fonts is done by the following methods: // // void setFont(const uint8_t *font); // selects rendering and fonts from library U8G2_FOR_ADAFRUIT_GFX // // void setFreeFont(const GFXfont *f = NULL); // selects rendering and fonts from library GxFont_GFX_TFT_eSPI // void void setTextFont(uint8_t font); // selects rendering and fonts from library GxFont_GFX_TFT_eSPI // // void setFont(uint8_t f); // selects rendering and fonts from library Adafruit_tfGFX // (no additional fonts, as all are now part of Adafruit_GFX, but fonts above 7bit character set) // // void setFont(const GFXfont *f = NULL); // reverts back to Adafruit_GFX FreeFonts // use setFont((void*)NULL); // to select Adafruit_GFX classic font // // these additions may not work with AVR Arduinos // // these additions are only partially tested; more tests and additions may follow // Supporting Arduino Forum Topics: // Waveshare e-paper displays with SPI: http://forum.arduino.cc/index.php?topic=487007.0 // Good Dispay ePaper for Arduino : https://forum.arduino.cc/index.php?topic=436411.0 // mapping suggestion from Waveshare SPI e-Paper to Wemos D1 mini // BUSY -> D2, RST -> D4, DC -> D3, CS -> D8, CLK -> D5, DIN -> D7, GND -> GND, 3.3V -> 3.3V // mapping suggestion from Waveshare SPI e-Paper to generic ESP8266 // BUSY -> GPIO4, RST -> GPIO2, DC -> GPIO0, CS -> GPIO15, CLK -> GPIO14, DIN -> GPIO13, GND -> GND, 3.3V -> 3.3V // mapping suggestion for ESP32, e.g. LOLIN32, see .../variants/.../pins_arduino.h for your board // NOTE: there are variants with different pins for SPI ! CHECK SPI PINS OF YOUR BOARD // BUSY -> 4, RST -> 16, DC -> 17, CS -> SS(5), CLK -> SCK(18), DIN -> MOSI(23), GND -> GND, 3.3V -> 3.3V // new mapping suggestion for STM32F1, e.g. STM32F103C8T6 "BluePill" // BUSY -> A1, RST -> A2, DC -> A3, CS-> A4, CLK -> A5, DIN -> A7 // mapping suggestion for AVR, UNO, NANO etc. // BUSY -> 7, RST -> 9, DC -> 8, CS-> 10, CLK -> 13, DIN -> 11 // mapping suggestion for Arduino MEGA // BUSY -> 7, RST -> 9, DC -> 8, CS-> 53, CLK -> 52, DIN -> 51 // mapping suggestion for Arduino DUE // BUSY -> 7, RST -> 9, DC -> 8, CS-> 77, CLK -> 76, DIN -> 75 // SPI pins are also on 6 pin 2x3 SPI header // include library, include base class, make path known #include // // NOTE: you need to SAVE the modified example to a saveable location for UTF-8 characters to work // e.g. for Umlauts // select the display class to use, only one //#include // 1.50" b/w //#include // 1.54" b/w //#include // 1.54" b/w 200x200, SSD1681 //#include // 1.54" b/w 152x152 UC8151 (IL0373) //#include // 1.54" b/w 200x200 JD79653A //#include // 1.54" b/w 152x152 UC8151D //#include // 1.54" b/w/r 200x200 //#include // 1.54" b/w/r 152x152 //#include // 1.54" b/w/r 200x200 SSD1681 //#include // 2.13" b/w 104x212 flexible //#include // 2.13" b/w //#include // 2.13" b/w new panel //#include // 2.13" b/w newer panel //#include // 2.13" b/w 128x250 SSD1680 //#include // 2.13" b/w/r //#include // 2.13" b/w/r UC8151D //#include // 2.13" b/w 104x212 UC8151D //#include // 2.13" b/w 128x250, SSD1680, TTGO T5 V2.4.1, V2.3.1 //#include // 2.9" b/w //#include // 2.9" b/w UC8151 (IL0373) //#include // 2.9" b/w UC8151D //#include // 2.9" b/w //#include // 2.9" b/w Waveshare variant, TTGO T5 V2.4.1 2.9" //#include // 2.9" b/w/r //#include // 2.9" b/w/r UC8151D //#include // 2.6" b/w //#include // 2.66" b/w 152x296, SSD1680, TTGO T5 V2.66, TTGO T5 V2.4.1 //#include // 2.7" b/w/r //#include // 2.7" b/w //#include // 2.7" b/w //#include // 3.7" b/w //#include // 4.2" b/w //#include // 4.2" b/w/r //#include // 5.83" b/w //#include // 7.5" b/w //#include // 7.5" b/w 800x480 //#include // 7.5" b/w/r //#include // 7.5" b/w/r 800x480 #if !defined(_GxFont_GFX_TFT_eSPI_H_) // FreeFonts from Adafruit_GFX #include #include //#include //#include #endif #if defined(_ADAFRUIT_TF_GFX_H_) #include #endif #include #include #if defined(ESP8266) // for SPI pin definitions see e.g.: // C:\Users\xxx\AppData\Local\Arduino15\packages\esp8266\hardware\esp8266\2.4.2\variants\generic\common.h GxIO_Class io(SPI, /*CS=D8*/ SS, /*DC=D3*/ 0, /*RST=D4*/ 2); // arbitrary selection of D3(=0), D4(=2), selected for default of GxEPD_Class GxEPD_Class display(io /*RST=D4*/ /*BUSY=D2*/); // default selection of D4(=2), D2(=4) #elif defined(ESP32) // for SPI pin definitions see e.g.: // C:\Users\xxx\Documents\Arduino\hardware\espressif\esp32\variants\lolin32\pins_arduino.h GxIO_Class io(SPI, /*CS=5*/ SS, /*DC=*/ 17, /*RST=*/ 16); // arbitrary selection of 17, 16 GxEPD_Class display(io, /*RST=*/ 16, /*BUSY=*/ 4); // arbitrary selection of (16), 4 // for LILYGO® TTGO T5 2.66 board uncomment next two lines instead of previous two lines //GxIO_Class io(SPI, /*CS=5*/ SS, /*DC=*/ 19, /*RST=*/ 4); // LILYGO® TTGO T5 2.66 //GxEPD_Class display(io, /*RST=*/ 4, /*BUSY=*/ 34); // LILYGO® TTGO T5 2.66 #elif defined(ARDUINO_ARCH_SAMD) // for SPI pin definitions see e.g.: // C:\Users\xxx\AppData\Local\Arduino15\packages\arduino\hardware\samd\1.6.19\variants\mkr1000\variant.h // C:\Users\xxx\AppData\Local\Arduino15\packages\arduino\hardware\samd\1.6.19\variants\mkrzero\variant.h GxIO_Class io(SPI, /*CS=*/ 4, /*DC=*/ 7, /*RST=*/ 6); GxEPD_Class display(io, /*RST=*/ 6, /*BUSY=*/ 5); #elif defined(ARDUINO_GENERIC_STM32F103C) && defined(MCU_STM32F103C8) // STM32 Boards(STM32duino.com) Generic STM32F103C series STM32F103C8 // for SPI pin definitions see e.g.: // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103c\variant.h // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103c\board\board.h // new mapping suggestion for STM32F1, e.g. STM32F103C8T6 "BluePill" // BUSY -> A1, RST -> A2, DC -> A3, CS-> A4, CLK -> A5, DIN -> A7 GxIO_Class io(SPI, /*CS=*/ SS, /*DC=*/ 3, /*RST=*/ 2); GxEPD_Class display(io, /*RST=*/ 2, /*BUSY=*/ 1); #elif defined(ARDUINO_GENERIC_STM32F103V) && defined(MCU_STM32F103VB) // STM32 Boards(STM32duino.com) Generic STM32F103V series STM32F103VB // for SPI pin definitions see e.g.: // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103vb\variant.h // C:\Users\xxx\Documents\Arduino\hardware\Arduino_STM32\STM32F1\variants\generic_stm32f103vb\board\board.h // Good Display DESPI-M01 // note: needs jumper wires from SS=PA4->CS, SCK=PA5->SCK, MOSI=PA7->SDI GxIO_Class io(SPI, /*CS=*/ SS, /*DC=*/ PE15, /*RST=*/ PE14); // DC, RST as wired by DESPI-M01 GxEPD_Class display(io, /*RST=*/ PE14, /*BUSY=*/ PE13); // RST, BUSY as wired by DESPI-M01 #else // for SPI pin definitions see e.g.: // C:\Users\xxx\AppData\Local\Arduino15\packages\arduino\hardware\avr\1.6.21\variants\standard\pins_arduino.h GxIO_Class io(SPI, /*CS=*/ SS, /*DC=*/ 8, /*RST=*/ 9); // arbitrary selection of 8, 9 selected for default of GxEPD_Class GxEPD_Class display(io /*RST=9*/ /*BUSY=7*/); // default selection of (9), 7 #endif #if defined(_GxGDEW0154Z04_H_) || defined(_GxGDEW0213Z16_H_) || defined(_GxGDEW029Z10_H_) || defined(_GxGDEW027C44_H_) || defined(_GxGDEW042Z15_H_) || defined(_GxGDEW075Z09_H_) #define HAS_RED_COLOR #endif void setup() { Serial.begin(115200); Serial.println(); Serial.println("setup"); display.init(115200); // enable diagnostic output on Serial Serial.println("setup done"); } void loop() { #if !defined(_ADAFRUIT_TF_GFX_H_) && !defined(_GxFont_GFX_TFT_eSPI_H_) && !defined(U8g2_for_Adafruit_GFX_h) showFont("FreeMonoBold12pt7b", &FreeMonoBold12pt7b); #endif #if defined(U8g2_for_Adafruit_GFX_h) showFont("u8g2_font_helvR14_tf", u8g2_font_helvR14_tf); // select u8g2 font from here: https://github.com/olikraus/u8g2/wiki/fntlistall delay(2000); showFont("u8g2_font_profont22_mr", u8g2_font_profont22_mr); // select u8g2 font from here: https://github.com/olikraus/u8g2/wiki/fntlistall delay(2000); #endif #if defined(_GxFont_GFX_TFT_eSPI_H_) showFreeFont("FreeMonoBold12pt7b", &FreeMonoBold12pt7b); delay(2000); //showFreeFont("NULL", NULL); showTextFont("Font 1", 1, 1); delay(2000); showTextFont("Font 1", 1, 2); delay(2000); showTextFont("Font 1", 1, 3); delay(2000); showTextFont("Font 2", 2, 1); delay(2000); showTextFont("Font 2", 2, 2); delay(2000); showTextFont("Font 2", 2, 3); delay(2000); showTextFont("Font 4", 4, 1); delay(2000); showTextFont("Font 4", 4, 2); delay(2000); showTextFont("Font 4", 4, 3); #endif #if defined(_ADAFRUIT_TF_GFX_H_) showFont("Open_Sans_Bold_12pt", OPENSANSBOLD_12); #endif delay(10000); } void showFont(const char name[], const GFXfont* f) { display.fillScreen(GxEPD_WHITE); display.setTextColor(GxEPD_BLACK); display.setFont(f); display.setCursor(0, 0); display.println(); display.println(name); display.println(" !\"#$%&'()*+,-./"); display.println("0123456789:;<=>?"); display.println("@ABCDEFGHIJKLMNO"); display.println("PQRSTUVWXYZ[\\]^_"); #if defined(HAS_RED_COLOR) display.setTextColor(GxEPD_RED); #endif display.println("`abcdefghijklmno"); display.println("pqrstuvwxyz{|}~ "); display.update(); delay(5000); } #if defined(U8g2_for_Adafruit_GFX_h) void showFont(const char name[], const uint8_t *f) { display.setRotation(0); display.fillScreen(GxEPD_WHITE); display.setFontMode(1); // use u8g2 transparent mode (this is default) display.setFontDirection(0); // left to right (this is default) display.setForegroundColor(GxEPD_BLACK); // apply Adafruit GFX color display.setBackgroundColor(GxEPD_WHITE); // apply Adafruit GFX color display.setFont(f); // select u8g2 font from here: https://github.com/olikraus/u8g2/wiki/fntlistall display.setCursor(0, 0); display.println(); display.println(name); display.println(" !\"#$%&'()*+,-./"); display.println("0123456789:;<=>?"); display.println("@ABCDEFGHIJKLMNO"); display.println("PQRSTUVWXYZ[\\]^_"); #if defined(HAS_RED_COLOR) display.setForegroundColor(GxEPD_RED); #endif display.println("`abcdefghijklmno"); display.println("pqrstuvwxyz{|}~ "); display.println("Umlaut ÄÖÜäéöü"); display.update(); } #endif #if defined(_ADAFRUIT_TF_GFX_H_) void showFont(const char name[], uint8_t f) { display.setRotation(0); display.fillScreen(GxEPD_WHITE); display.setTextColor(GxEPD_BLACK); display.setFont(f); display.setCursor(0, 0); display.println(); display.println(name); display.println(" !\"#$%&'()*+,-./"); display.println("0123456789:;<=>?"); display.println("@ABCDEFGHIJKLMNO"); display.println("PQRSTUVWXYZ[\\]^_"); #if defined(HAS_RED_COLOR) display.setTextColor(GxEPD_RED); #endif display.println("`abcdefghijklmno"); display.println("pqrstuvwxyz{|}~ "); display.update(); } #endif #if defined(_GxFont_GFX_TFT_eSPI_H_) void showFreeFont(const char name[], const GFXfont* f) { display.setRotation(0); display.fillScreen(GxEPD_WHITE); display.setTextColor(GxEPD_BLACK); display.setFreeFont(f); display.setCursor(0, 0); display.println(); display.println(name); display.println(" !\"#$%&'()*+,-./"); display.println("0123456789:;<=>?"); display.println("@ABCDEFGHIJKLMNO"); display.println("PQRSTUVWXYZ[\\]^_"); #if defined(HAS_RED_COLOR) display.setTextColor(GxEPD_RED); #endif display.println("`abcdefghijklmno"); display.println("pqrstuvwxyz{|}~ "); display.update(); } void showTextFont(const char name[], uint8_t f, uint8_t size) { display.setRotation(0); display.fillScreen(GxEPD_WHITE); display.setTextColor(GxEPD_BLACK, GxEPD_WHITE); display.setTextFont(f); display.setTextSize(size); display.setCursor(0, 0); display.println(); display.println(name); display.println(" !\"#$%&'()*+,-./"); display.println("0123456789:;<=>?"); display.println("@ABCDEFGHIJKLMNO"); display.println("PQRSTUVWXYZ[\\]^_"); #if defined(HAS_RED_COLOR) display.setTextColor(GxEPD_RED); #endif display.println("`abcdefghijklmno"); display.println("pqrstuvwxyz{|}~ "); display.update(); } #endif