GxEPD2

GxEPD2

用於 SPI 電子紙顯示器的 Arduino 顯示庫

• 使用 Adafruit_GFX 提供完整的圖形和文字支持

• 適用於大連固德顯示的SPI電子紙顯示器

• 和 Waveshare 的 SPI 電子紙板

重要提示：

• 顯示面板適用於 3.3V 電源和 3.3V 數據線
• 切勿將數據線直接連接到 5V Arduino 資料接腳，使用例如 4k7/10k 電阻分壓器
• 僅串聯電阻不足以可靠運作（透過保護二極體產生回授效應）
• 4k7/10k 電阻分壓器可能無法與扁平電纜延長線或 Waveshare 4.2 板一起使用，請使用電平轉換器
• 不要忘記連接 GND
• 實際的 Waveshare 顯示板現在具有電平轉換器和串聯調節器，可安全使用 5V
• 對於具有電平轉換器的板，在 ESP8266 的 SS 上使用 3k3 下拉
• 請注意，如果透過 3.3V Arduino 引腳供電，7.5 吋電子紙顯示器將無法可靠運作
• 請注意，具有“聰明”重設電路的 Waveshare 板可能需要縮短重設脈衝
• 對於具有「聰明」重置電路的 Waveshare 板使用init(115200, true, 2, false)
• 請注意，具有「聰明」重設電路的 Waveshare 板需要 ESP8266 上的 RST 上 1k 上拉，或不同的引腳
• 請注意，新的 Waveshare 通用電子紙原始面板驅動程式 HAT Rev 2.3 需要將 PWR 連接到 VCC 或驅動為高電平
• 請參閱 https://www.waveshare.com/wiki/E-Paper_Driver_HAT

分頁繪圖、圖片循環

• 該庫使用分頁繪圖來限制 RAM 使用並應對缺少的單像素更新支持
• 緩衝區大小可以在應用程式中透過模板參數 page_height 選擇，請參閱 GxEPD2_Example
• 分頁繪圖以圖片循環的形式實現，如 U8G2 (Oliver Kraus)
• 請參閱 https://github.com/olikraus/u8glib/wiki/tpictureloop
• 分頁繪圖也可以使用drawPaged()和drawCallback()來實現，就像在GxEPD中一樣
• // GxEPD style paged drawing; drawCallback() is called as many times as needed
• void drawPaged(void (*drawCallback)(const void*), const void* pv)
• 分頁繪製是使用圖片循環或drawCallback內的Adafruit_GFX方法完成的

全螢幕緩衝區支持

• 透過設定模板參數page_height來選擇全螢幕緩衝區顯示高度
• 使用 Adafruit_GFX 方法繪製到全螢幕緩衝區，無需圖片循環或 drawCallback
• 然後呼叫方法display()

低階點陣圖繪圖支持

• 控制器記憶體和螢幕的位圖繪製支援可用：
• 透過將呼叫轉發到基底顯示類別的模板類別實例方法
• 或直接使用基底顯示類別的實例並直接呼叫其方法

支援 Arduino 論壇主題：

• Waveshare 電子紙顯示 SPI：http://forum.arduino.cc/index.php?topic=487007.0
• 適用於 Arduino 的良好顯示電子紙：https://forum.arduino.cc/index.php?topic=436411.0
• 請注意，這些主題已關閉。僅供參考。
• 為 https://forum.arduino.cc/c/using-arduino/displays/23 中的每個問題建立一個新主題

文件說明

• GxEPD2 使用 Adafruit_GFX 進行圖形和文字支持，那裡有詳細記錄
• GxEPD2使用有意義的方法名稱，並在頭文件中有一些註釋
• 請參閱頭檔 GxEPD2_BW.h、GxEPD2_3C.h 和 GxEPD2_GFX.h
• 有關分頁繪圖和圖片循環的概念，請參閱：
• https://github.com/olikraus/u8glib/wiki/tpictureloop

關於問題和拉取請求的說明

• 問題應在 Arduino 論壇顯示中報告。
• GitHub 上的問題已停用；虛假問題太多了。
• 不歡迎拉取請求，不會被合併。
• 拉取請求無法停用，但會關閉。
• 請在 Arduino 論壇展示中放置有關有趣的叉子添加的資訊。

Good Display 支援的 SPI 電子紙面板：

• GDEW0102T4 1.02" 黑白 80x128，UC8175
• DEPG0150BN 1.50" 黑白 200x200，SSD1681，例如 LILYGO® TTGO T5 V2.4.1 1.50 英寸
• GDEP015OC1 1.54" 黑白 200x200，IL3829，不再提供
• GDEH0154D67 1.54" 黑白 200x200，SSD1681，替代 GDEP015OC1
• GDEW0154T8 1.54 吋黑白 152x152，UC8151 (IL0373)
• GDEW0154M09 1.54 吋黑白 200x200，JD79653A
• GDEW0154M10 1.54 吋黑白 152x152，UC8151D，DES
• GDEY0154D67 1.54" 黑白 200x200, SSD1681
• GDEW0154Z04 1.54" 黑白/紅 200x200，IL0376F，不再提供
• GDEH0154Z90 1.54" 黑白/紅 200x200，SSD1681，取代 GDEW0154Z04
• GDE0213B1 2.13" 黑白 122x250，IL3895，已淘汰
• GDEH0213B72 2.13" 黑白 122x250，SSD1675A (IL3897)，取代 GDE0213B1
• GDEH0213B73 2.13" 黑白 122x250，SSD1675B，GDE0213B1、GDEH0213B72 的新替代品
• GDEM0213B74 2.13" 黑白 122x250, SSD1680
• GDEW0213I5F 2.13" 黑白 104x212，UC8151 (IL0373)，柔性
• GDEW0213T5D 2.13" 黑白 104x212，UC8151 (IL0373)
• GDEW0213M21 2.13 吋黑白 104x212，UC8151 (IL0373)，DES
• GDEW0213Z16 2.13" 黑白/紅 104x212，UC8151 (IL0373)
• GDEW0213Z19 2.13" 黑白/紅 104x212，UC8151D
• GDEY0213Z98 2.13" 黑白 122x250, SSD1680
• GDEY0213F51 2.13" 4色 122x250, JD79661
• DEPG0213BN 2.13" 黑白 122x250, SSD1680, 例如 LILYGO® TTGO T5 V2.3.1 2.13 英寸
• GDEY0213B74 2.13" 黑白 122x250, SSD1680
• GDEW026T0 2.6 吋黑白 152x296，UC8151 (IL0373)
• GDEW026M01 2.6 吋黑白 152x296，UC8151 (IL0373)，DES
• DEPG0266BN 2.66" 黑白 152x296，SSD1680，例如 LILYGO® TTGO T5 2.66 英寸
• GDEY0266Z90 2.66" 黑白 152x296，SSD1680
• GDEY0266F51H 2.66" 4色 184x460, JD79667
• GDEW027C44 2.7" 黑白 176x264，IL91874
• GDEW027W3 2.7 吋黑白 176x264，EK79652 (IL91874)
• GDEY027T91 2.7" 黑白 176x264, SSD1680
• GDEH029A1 2.9 吋黑白 128x296，SSD1608 (IL3820)
• GDEW029T5 2.9 吋黑白 128x296，UC8151 (IL0373)
• GDEW029T5D 2.9 吋黑白 128x296，UC8151D
• GDEW029I6FD 2.9" 黑白 128x296，UC8151D，靈活
• GDEM029T94 2.9" 黑白 128x296, SSD1680
• GDEW029M06 2.9 吋黑白 128x296，UC8151D，DES
• GDEW029Z10 2.9" 黑白 128x296，UC8151 (IL0373)
• GDEH029Z13 2.9" 黑白 128x296，UC8151D
• GDEM029C90 2.9" 黑白 128x296，SSD1680
• DEPG0290BS 2.9" 黑白 128x296，SSD1680，例如 LILYGO® TTGO T5 V2.4.1 2.9"
• GDEY029T94 2.9" 黑白 128x296, SSD1680
• GDEY029T71H 2.9" 黑白 168x384, SSD1685
• GDEY029F51H 2.9" 4色 168x384, JD79667
• Waveshare3吋4色3.0吋4色168x400
• GDEQ031T10 3.1" 黑白 240x320，UC8253
• ED037TC1 3.7" 黑白 280x480, SSD1677, Waveshare 3.7"
• GDEW0371W7 3.7 吋黑白 240x416，UC8171 (IL0324)
• GDEW042T2 4.2 吋黑白 400x300，UC8176 (IL0398)
• GDEW042M01 4.2 吋黑白 400x300，UC8176 (IL0398)，DES
• GDEW042Z15 4.2" 黑白 400x300，UC8176 (IL0398)
• GDEQ042Z21 4.2" 黑白/紅 400x300，UC8276，（Waveshare V2）
• GDEY042Z98 4.2" 黑白 400x300, SSD1683
• GDEY042T81 4.2" 黑白 400x300, SSD1683
• GDEY0420F51 4.2" 4色 400x300, HX8717
• GDEQ0426T82 4.26" 黑白 800x480, SSD1677
• Waveshare437inch4color Waveshare 4.37" 4 色電子紙顯示器 512x368
• ACeP565​​ 5.65" Waveshare 5.65" 7色電子紙顯示器 600x448
• GDEP0565D90 5.65" 7色 600x448
• GDEY0579T93 5.79" 黑白 792x272, SSD1683
• GDEY0579Z93 5.79" 黑白 792x272, SSD1683
• GDEY0579F51 5.79" 4 色 792x272, HX8717
• GDEW0583T7 5.83 吋黑白 600x448，UC8159c (IL0371)
• GDEW0583T8 5.83 吋黑白 648x480、EK79655 (GD7965)
• GDEW0583Z83 5.83" 黑白/紅 648x480，EK79655 (GD7965)
• GDEQ0583T31 5.83" 黑白 648x480，UC8179
• GDEQ0583Z31 5.83" 黑白 648x480，UC8179C
• GDEY073D46 7.3" 800x480 7色
• GDEP073E01 7.3" 800x480 7色
• ACeP730 7.3" Waveshare 7 色電子紙顯示器 800x480, PhotoPainter
• GDEW075T8 7.5 吋黑白 640x384，UC8159c (IL0371)
• GDEW075T7 7.5 吋黑白 800x480、EK79655 (GD7965)
• GDEY075T7 7.5 吋黑白 800x480，UC8179 (GD7965)
• GDEW075Z09 7.5 吋黑白 640x384，UC8159c (IL0371)
• GDEW075Z08 7.5 吋黑白 800x480、EK79655 (GD7965)
• GDEH075Z90 7.5" 黑白 880x528，SSD1677
• GDEM102T91 10.2" 黑白 960x640, SSD1677
• GDEM1085T51 10.85 黑白 1360x480、JD79686AB
• GDEH116T91 11.6" 黑白 960x640, SSD1677
• GDEY116Z91 11.6 吋黑白/紅 960x640，SSD1677
• GDEY116F51 11.6" 4色 960x640, SSD2677
• GDEW1248T3 12.48 吋黑白 1304x984，UC8179
• GDEY1248Z51 12.48 吋黑白/紅 1304x984，UC8179
• GDEM133T91 13.3" 黑白 960x680, SSD1677
• GDEM133Z91 13.3" 黑白/紅 960x680，SSD1677

Waveshare 支援的 SPI 電子紙面板和卡牌：與 Good Display 比較，相同的面板

其他支援的面板

• GYE042A87 4.2" 黑白 400x300, SSD1683 (HINK-E042-A07-FPC-A1)
• SE0420NQ04 4.2" 黑白 400x300，UC8276C (OPM042A2_V1.0)
• ED060SCT 6" 灰階，在 Waveshare 電子紙 IT8951 驅動程式 HAT 上
• ED060KC1 6" 灰階，1448x1072，在 Waveshare 電子紙 IT8951 驅動程式 HAT 上
• ED078KC2 7.8" 灰階，1872x1404，採用 Waveshare 電子紙 IT8951 驅動程式 HAT
• ES103TC1 10.3" 灰階，1872x1404，採用 Waveshare 電子紙 IT8951 驅動程式 HAT

我可以而且只會支持我擁有的電子紙面板！

• 我可以接受小組捐款來增加對 GxEPD2 的支持。
• 但任何時候都只有很少的面板，而且只有來自已知來源的面板。
• 添加支援將根據需要花費盡可能多的時間。

版本1.6.0

• 更新了對 GDEY029T94 的支援：修復了部分刷新問題
• 更新了對 GDEY042T81 的支援：修復了 2024 年面板版本的快速完全刷新
• 更新了對 GDEP073E01 的支援：修復了其本機顏色值的顏色映射
• 更新了 GxEPD2_display_selection_new_style.h：新增了 Arduino Nano Every、Arduino Nano ESP32、Arduino Nano IoT。

版本1.5.9

• 在 GDEY075T7 init 中新增了省電命令 (PWS)（抖動位圖問題）
• 新增了對 GDEY0579T93 5.79" 黑白 792x272、SSD1683 的支持
• 新增了對 GDEY0579Z93 5.79" 黑白/紅 792x272、SSD1683 的支持
• 增加了對 GDEY0579F51 5.79" 4 色 792x272、HX8717 的支持
• GDEY0579F51 具有部分視窗尋址能力，
• 但沒什麼用，因為控制器緩衝區在刷新期間被修改
• GDEY0579F51 無法使用部分視窗刷新，刷新為全螢幕
• 新增了對 GDEY042Z98 4.2" 黑白/紅 400x300、SSD1683 的支持
• GDEY042Z98具有「快速」全刷新並支援快速黑白部分刷新
• 增加了對 GDEP073E01 7.3" 800x480 7 色的支持

版本1.5.8

• 增加了對 GDEP0565D90 5.65" 7 色 600x448 的支持
• 增加了對 GDEY116F51 11.6" 4 色 960x640、SSD2677 的支持
• 新增了對 GDEY029T71H 2.9" 黑白 168x384、SSD1685 的支持

版本1.5.7

• 增加了對 GDEY0213F51 2.13" 4 色 122x250、JD79661 的支持
• 新增了對 GDEM1085T51 10.85 黑白 1360x480、JD79686AB 的支持

版本1.5.6

• 持續修復和添加的版本
• 增加了對 GYE042A87 4.2" 黑白 400x300 的支持
• 增加了對 SE0420NQ04 4.2" 黑白 400x300 的支持
• 增加了對 GDEQ0583Z31 5.83" 黑白/紅 648x480 的支持
• 新增了對 GDEM102T91 10.2" 黑白 960x640、SSD1677 的支持
• 新增了對 GDEY116Z91 11.6" 黑白/紅 960x640、SSD1677 的支援
• 新增了對 GDEM133T91 13.3" 黑白 960x680、SSD1677 的支持
• 新增了對 GDEM133Z91 13.3" 黑白/紅 960x680、SSD1677 的支援
• 改進了 SE0420NQ04 的差分刷新
• 改進了 SE0420NQ04 的全面刷新
• 固定驅動程式類別 GxEPD2_213.cpp

版本1.5.5

• 更新了 7 色驅動程式類別（設計清理已修復）
• 注意：Waveshare PhotoPainter 不適用於 MBED Pico 軟體包
• 注意：對於 PhotoPainter 使用套件 https://github.com/earlephilhower/arduino-pico

版本1.5.4

• 新增了對 GDEQ031T10 3.1" 黑白 240x320 的支持
• 更新了對 GDEY075T7 7.5" 黑白 800x480 的支持
• 將驅動程式類別 GxEPD2_750_YT7 重新命名為 GxEPD2_750_GDEY075T7
• 實際的GDEY075T7面板具有快速全刷新能力
• 新增了對 Waveshare 7.3" 7 色、驅動程式類別 GxEPD2_730c_ACeP_730 的支持
• 添加了對帶有 RPi Pico RP2040 的 Waveshare 7.3" 7 色 PhotoPainter 的支持
• 更新了 SSD 控制器的黑白驅動程式類
• 更新了 7 色驅動程式類別（設計清理）

版本1.5.3

• 新增了對 GDEQ0426T82 4.26" 黑白 800x480 的支持
• 增加了對 GDEY0266F51H 2.66" 4 色 184x460 的支持
• 增加了對 GDEY029F51H 2.9" 4 色 168x384 的支持
• 增加了對 GDEY0420F51 4.2" 4 色 400x300 的支持
• 增加了對 Waveshare 3.00" 4 色電子紙顯示器 168x400 的支持
• 更新了對 Waveshare 4.37" 4 色電子紙顯示器 512x368 的支持
• 4 色顯示器具有部分視窗尋址和刷新功能
• GDEY042T91更名為新正式名稱GDEY042T81

版本1.5.2

• 增加了對 Waveshare 4.37" 4 色電子紙顯示器 512x368 的支持
• 修正了 __has_include 測試（對於不支援 __has_include 的軟體包）
• 新增了 WIDTH_VISIBLE 以確保 2.13 吋黑白 122x250 的正確圖形寬度
• 新增了 end() 方法，以釋放 SPI 並將所有引腳重設為 INPUT

版本1.5.1

• 新增了對 GDEY0154D67 1.54" 黑白 200x200 的支持
• 新增了對 GDEY0213B74 2.13" 黑白 128x250 的支持
• 更新了對 GDEY027T91 2.7" 黑白 176x264 的支持
• 將 GDEY027T91 的驅動程式類別重新命名為 GxEPD2_270_GDEY027T91
• 新增了對 GDEY029T94 2.9" 黑白 128x296 的支持
• 新增了對 GDEY042T91 4.2" 黑白 400x300 的支持
• 新增了對 GDEQ0583T31 5.83" 黑白 648x480 的支持
• 這些面板具有快速完全刷新功能
• 可以在類別標頭中停用快速完全刷新以供低溫使用
• 增加了對 GDEY073D46 7.3" 800x480 7 色的支持
• 所有這些新面板均由 Good Display 捐贈
• 新增了 __has_include 測試到 GxEPD2_BW.h、GxEPD2_3C.h、GxEPD2_7C
• 這允許刪除或擱置未使用的驅動程式類別以加快編譯速度
• 多項修復和改進

版本1.5.0

• 新增了對 GDEY075T7 7.5" 黑白 800x480 的支持
• 更新了 GxEPD2_Example，新增了用於 Waveshare ESP32 驅動板的 HSPI
• 更新了 GxEPD2_SD_AVR_Example，修復了 BMP 處理
• 更新了 GxEPD2_SD_Example，修復了 BMP 處理，添加了用於 Waveshare ESP32 驅動板的 HSPI
• 更新了 GxEPD2_SerialFlash_Example，修復了 BMP 處理
• 更新了GxEPD2_SerialFlash_Loader，更新了https憑證並使用
• 更新了 GxEPD2_Spiffs_Example，修復了 BMP 處理
• 更新了GxEPD2_Spiffs_Loader，更新了https憑證並使用
• 新增了 GxEPD2_WiFi_CertStore_Example，在 ESP8266 上使用 BearSSL CertStore，就像瀏覽器一樣
• 新增了 GxEPD2_WiFi_CertStore_Loader，下載根憑證（從 Mozilla）到 ESP8266 flash
• 更新了 GxEPD2_WiFi_Example，修復了 BMP 處理，更新了 https 憑證和使用
• 更新了 GxEPD2_WS_ESP32_Driver，新增了用於 Waveshare ESP32 驅動板的 HSPI

版本1.4.9

• 將缺少的建構函式行加入 GxEPD2_display_selection.h
• 在 GxEPD2_display_selection.h 中的註釋中添加了面板詳細信息
• 在 README.md 中的支援的 SPI 電子紙面板中添加了面板詳細信息

版本1.4.8

• 新增了對 GDEY027T91 2.7" 黑白 176x264 的支持
• 增加了對 GDEY1248Z51 12.48" 黑白/紅 1304x984 的支持
• 面板固定名稱 DEPG0150BN
• 更新了 GxEPD2_WiFi_Example 中 GitHub 下載的憑證和指紋

版本1.4.7

• 添加了對 DEPG0150BN 1.50" 黑白 200x200 的支持，例如 LILYGO® TTGO T5 V2.4.1 1.50 英寸
• 添加了對 DEPG0213BN 2.13" 黑白 128x250 的支持，例如 LILYGO® TTGO T5 V2.3.1 2.13 英寸
• 添加了對 DEPG0266BN 2.66" 黑白 152x296 的支持，例如 LILYGO® TTGO T5 2.66 英寸
• 增加了對 DEPG0290BS 2.9" 黑白 128x296 的支持，例如 LILYGO® TTGO T5 V2.4.1 2.9"
• 在 Waveshare e-Paper IT8951 驅動程式 HAT 上新增了對 ES103TC1 10.3" 灰階、1872x1404 的支持

版本1.4.6

• 增加了對 GDEY0266Z90 2.66" 黑白/紅 152x296 的支持
• 新增了對 GDEW0583Z83 5.83" 黑白/紅 648x460 的支持

版本1.4.5

• 增加了對 GDEY0213Z98 2.13" 黑白/紅 122x250 的支持
• 使用 LOLIN 2.13" 三色電子墨水/電子紙 250x122 顯示器護罩進行測試
• https://www.aliexpress.com/item/1005003020667903.html

版本1.4.4

• 臨時更新以解決編譯器警告（全部適用於 AVR 的 GCC）

版本1.4.3

• 新增了選擇備用 HW SPI 通道和/或 SPI 設定的選項
• 透過驅動程式基底類別 GxEPD2_EPD 的 selectSPI(SPIClass& spi, SPISettings spi_settings) 方法
• 透過在呼叫顯示類別的 init() 之前呼叫 selectSPI
• 或者透過呼叫添加了這些參數的擴展 init() 方法
• 使用 Good Display DESPI-PICO 連接屏蔽對 RPi Pico RP2040 進行測試
• 更新了 GxEPD2_Example 以展示與 DESPI-PICO 的使用
• DESPI-PICO：請參閱 https://www.good-display.com/product/393.html

版本1.4.2

• 增加了對 Waveshare 3.7" 黑白板和麵板 ED037TC1 的支持
• ED037TC1 的波形表未經修改地取自 Waveshare 示範程式碼
• ED037TC1 與 GxEPD2 的刷新行為並不完美，無法解決
• 問題已解決：此面板的 DESPI-C02 上的 RESE 需要為 3 歐姆，Waveshare 原理圖是錯誤的
• 新增了 GDEH116T91 的差分刷新，波形表取自 ED037TC1
• GDEH116T91 的差分刷新看起來不錯；可以透過 hasFastPartialUpdate = false 來停用
• GDEW042T2 上差分刷新的維持階段增加

版本1.4.1

• 修復 Waveshare“聰明”重設電路：重設脈衝之前的電源控制器

版本1.4.0

• 將預設重設持續時間從 20ms 變更為 10ms
• 將重設後的延遲改為 10ms 或重設持續時間（以較高者為準），而不是 200ms
• 新增了 busyCallback 功能，以允許在等待 BUSY 終止期間服務定期操作
• // register a callback function to be called during _waitWhileBusy continuously.
• void setBusyCallback(void (*busyCallback)(const void*), const void* busy_callback_parameter = 0);
• 新增了範例 GxEPD2_RotaryUsingBusyCallback.ino

版本1.3.9

• 修復STM32官方封裝引腳號範圍（int16_t）
• 修復刷新（int16_t x，int16_t y，int16_t w，int16_t h）方法畫面交集

版本1.3.8

• 增加了對 GDEQ042Z21 4.2" 黑白 400x300 面板或 Waveshare 4.2" V2 黑白板的支援
• Waveshare 4.2" V2 b/w/r 板需要縮短的重設脈衝
• 增加了對 GDEW029I6FD 2.9" 黑白 128x296 柔性板的支持
• 對新樣式面板選擇的一些修復和改進

版本1.3.7

• 新增了對 GDEW0102T4 1.02" 黑白 80x128 面板或 Waveshare 1.02" 黑白板的支持
• GDEW0102T4 面板具有與其他 SPI 面板不同的連接器
• GDEW0102T4面板可與DESPI-C102連接模組一起使用
• https://buy-lcd.com/products/connection-board-demo-kit-for-102-inch-e-ink-display-despi-c102
• 我的測試是使用 Waveshare 1.02" 黑白板完成的

版本1.3.6

• 新增了對 Waveshare 2.9" 黑白 V2、驅動程式類別 GxEPD2_290_T94_V2 的支持
• Waveshare 2.9" 黑白 V2 使用 GDEM029T94 變體，在 OTP 中沒有部分更新 wft
• 驅動程式類別 GxEPD2_290_T94_V2 使用部分更新 wft 寫入暫存器
• 添加了 ESP8266 上帶有“聰明”復位電路或備用引腳的 RST 上拉註釋

版本1.3.5

• 新增了對 GDEM0213B74 122x250 黑白電子紙面板的支持
• 在 Waveshare e-Paper IT8951 驅動程式 HAT 上新增了對 ED078KC2、7.8" 灰階、1872x1404 的支持

版本1.3.4

• 增加了對 GDEH116T91 960x640 黑白電子紙面板的支持
• GDEH116T91只有全螢幕刷新，還沒有差分刷新的波表
• 新增了對處理器 Arduino Nano RP2040 連接到範例的支持
• 新增了適用於 3 色顯示器的通用快速黑白刷新 GDEW0213Z19、GDEW029Z13
• 新增了 GDEW0213Z19、GDEW029Z13 的範例 GxEPD2x_FastBlackWhiteOnColor.ino
• 隨後可能會評估其他具有快速黑白功能的三色面板

版本1.3.3

• GDEW0213Z19 新增黑白差分刷新方法
• GDEW029Z13 新增黑白差分刷新方法
• 最多可實現 100 次黑白快速刷新（導致背景略帶紅色）
• 新增了實驗範例 GxEPD2x_MixedTest 以進行概念驗證
• GxEPD2x_MixedTest 需要足夠的 RAM 來容納 2 個 GFXCanvas1 對象
• GxEPD2 中的通用 3 色混合刷新正在評估中，適用於有能力的面板

版本1.3.2

• 新增了對 GDEW0213T5D 104x212 黑白電子紙面板的支持
• 新增了對 GDEW029T5D 128x296 黑白電子紙面板的支持
• 新增了對 GDEW0213Z19 104x212 黑白/紅電子紙面板的支持
• 新增了對 GDEW029Z13 128x296 黑白/紅電子紙面板的支持
• GDEW0213Z19和GDEW029Z13皆僅支援全螢幕刷新（控制器問題）

版本1.3.1

• 增加了對 GDEM029C90 128x296 黑白電子紙面板的支持
• GDEM029C90的刷新時間非常長，約27秒
• GDEM029C90 具有控制器記憶體的部分更新（視窗尋址）
• GDEM029C90僅支援螢幕全刷新

版本1.3.0

• 增加了對 GDEM029T94 128x296 黑白電子紙面板的支持
• 新增了對 GDEW026M01 152x296 黑白新 DES 電子紙面板的支持
• 新款GDEW026M01 DES黑白電子紙面板具有更高的對比度和更寬的溫度範圍
• 正常溫度範圍支援差分刷新（快速部分更新）
• 透過設定 hasFastPartialUpdate = false 來停用擴展溫度下的差異刷新；
• GDEW026M01 的差分波形表是實驗性的，可能需要改進
• 對範例中的顯示選擇進行了重大更新，使添加更加容易：
• 舊樣式選擇現在位於單獨的包含檔案中 GxEPD2_display_selection.h
• 和 GxEPD2_display_selection_added.h
• 在包含檔案 GxEPD2_display_selection_new_style.h 中新增了新樣式顯示選擇
• 可以使用任一選擇方式。舊樣式旨在輕鬆複製建構函式行。

版本1.2.16

• 修復 GDEH0154D67，使其獨立於 OTP 版本工作（乒乓問題）

版本1.2.15

• 新增了對 GDEW0213M21 2.13" 104x212 黑白新 DES 電子紙面板的支持
• 新增了對 GDEW029M06 2.9" 128x296 黑白新 DES 電子紙面板的支援
• 新增了對 GDEW042M01 4.2" 400x300 黑白新 DES 電子紙面板的支援
• 這些新型 DES 黑白電子紙面板具有更高的對比度和更寬的溫度範圍
• 正常溫度範圍支援差分刷新（快速部分更新）
• 透過設定 hasFastPartialUpdate = false 來停用擴展溫度下的差異刷新；
• 我的GDEW042M01是初步版本，差分波形可能需要更新

版本1.2.14

• 在 Waveshare e-Paper IT8951 驅動程式 HAT 上新增了對 6" 1448x1072 ED060KC1 的支持
• 修正了 GxEPD2_WiFi_Example.ino：ESP8266 的新 GitHub 指紋、ESP32 的憑證
• GxEPD2_7C.h 中用於 7 色顯示的固定顏色鑑別器
• 在 GxEPD2_WiFi_Example、GxEPD2_Spiffs_Example 中加入了對 7 色顯示的多色支持，
• 和 GxEPD2_SD_Example、GxEPD2_SerialFlash_Example
• 修正了對 7 色顯示控制器的分頁寫入（交易和 CS 處理問題）
• 更多修復

版本1.2.13

• 增加了對 GDEH0154Z90 1.54" 200x200 黑白/紅的支持，取代 GDEW0154Z04
• GDEH0154Z90 有部分視窗尋址，但沒有部分視窗刷新
• 新增了一些缺少的建構函式範例，例如到期時的 IT8951 驅動程式 HAT
• 清理範例中的接線訊息

版本1.2.12

• 修復了 GxEPD2_MinimumExample.ino 以在白色上繪製黑色（白色上的白色是不可見的）
• 新增了範例 GxEPD2_HelloWorld.ino
• 更新了實際 Waveshare e-Paper ESP8266 驅動板的接線資訊和建構函式參數
• 新增了一些缺少的明確初始化程序（沒有人注意到，因為編譯器通常初始化簡單成員）

版本1.2.11

• 增加了對 Waveshare 5.65" 7 色電子紙顯示器 600x448 的支持
• 據了解，該顯示器的未知控制器不支援部分更新
• GxEPD2_7C 類別提供 7 色圖形支持
• 即使在 ESP32 上，7 色圖形支援也需要分頁
• 7 色圖形支援會導致 Arduino UNO 上的大量分頁，變得非常慢
• 對於彩色電子紙顯示器來說刷新速度相當快：12 秒

版本1.2.10

• 增加了對 GDEH075Z90 7.5" 黑白/紅 880x528 的支持
• GDEH075Z90的控制器支援部分更新，但刷新是全螢幕
• GDEH075Z90的控制器不支援差異更新（無論如何都不可能在3色上）
• 註：GDEH075Z90 的連接器是鏡像的； DESPI-C02 向下連接
• 新增了可選的初始化參數「reset_duration」（以毫秒為單位），與先前相同的預設值 20 毫秒
• reset_duration = 2 可能有助於 Waveshare 較新板的「聰明」重置電路

版本1.2.9

• 新增了對 GDEW0154T8 1.54" 黑白 152x152 的支持
• 新增了對 GDEW0154M09 1.54" 黑白 200x200 的支持
• 新增了對 GDEW0154M10 1.54" 黑白 152x152 DES 的支持
• 新增了對 GDEW0583T8 5.83" 黑白 648x460 的支持
• 新增了使用庫 GFX_Root 的類別 GFX 而不是 Adafruit_GFX 的選項
• GDEW0154M10 上的差異更新是實驗性的，目前還沒有部分更新演示

版本1.2.8

• 提高了更大顯示器（3.71 吋及以上）的傳輸速度

版本1.2.7

• 修正 GDEH029A1 上初始畫面的分頁繪圖
• 有時，如果應用錯誤，正確就是錯誤的

版本1.2.6

• GDEW1248T3 的差分刷新略有改進
• 小修復

版本1.2.5

• 在 Waveshare 12.48 電子紙顯示框架上添加了對 GDEW1248T3 12.84" 黑白面板的支持
• 使用安裝在連接板上的 Waveshare Epaper ESP32 驅動板進行測試
• 使用安裝在連接板上的 Arduino UNO 進行測試，速度非常慢
• 無法與連接板上的 Arduino MEGA 配合使用，開關設定為 ICSP 並且引腳彎曲，原因未知
• 未使用其他處理器進行測試
• 注意：接線連接器位於電平轉換器的 5V 側！

版本1.2.4

• 增加了對 GDEH0154D67 1.54" 黑白的支持，替代 GDEP015OC1
• 新增了 GxEPD2_SerialFlash_Loader，用於 SPI-flash 的 WiFi 位圖下載器
• 新增了 GxEPD2_SerialFlash_Example，SPI 快閃記憶體範例，例如用於 Winbond 25Q16BVSIG
• 小修復和評論清理
• 修復上層的refresh(false)：完全刷新後加入powerOff()

版本1.2.3

• 修復了 2.13" 3 色和 2.9" 3 色電子紙的部分更新
• 可以使用屬性 usePartialUpdateWindow = false 停用部分更新
• 新增了 GxEPD2_GFX_Example 以顯示 GxEPD2_GFX 基底類別的用法
• 替換了 GxEPD2_MultiDisplayExample 程式碼，與 GxEPD2_GFX_MultiDisplayExample 程式碼相同
• 新增了 extras/examples/GxEPD2_T_MultiDisplayExample，使用模板函數的替代範例
• 主要和次要的修復，例如存在太久的拼寫錯誤

版本1.2.2

• 修復了 BMP 處理，例如由 ImageMagick 創建的 BMP
• 另請參閱 Arduino 論壇主題 https://forum.arduino.cc/index.php?topic=642343.0

版本1.2.1

• 新增了對 GDEW075T7 7.5" 黑白 800x480 的支持
• GDEW075T7 使用電荷平衡波形進行差分更新（1.6 秒）
• 新增了可選的 SW SPI 支持，請參閱 /extras/sw_spi/README
• 新增了 /extras/tests/GxEPD2_RefreshTests/GxEPD2_RefreshTests.ino，用於波形調整
• 小修復
• 請注意，如果透過 3.3V Arduino 引腳供電，7.5 吋電子紙顯示器將無法可靠運作

版本1.2.0

• 為 GDEW0371W7 3.7" 黑白 240x416 新增了「快速部分更新」（差異更新）
• 改進了 GDEW026T0 2.6" 黑白 152x256 的差分更新波形
• 修復了 GDEW042T2 4.2" 黑白 300x400 的初始化程式碼和改進的差異更新
• 請注意，所有差分刷新波形都是折衷方案（重影、大字體使用）
• 可以輕鬆更改這些顯示的差分波形參數以進行實驗
• 如果沒有維持階段，GDEW042T2 的背景將會呈現灰色
• GDEW042T2 在長期使用部分更新後需要多次全面刷新

版本1.1.10

• 增加了對 GDEH0213B73 2.13" 黑白的支持，取代 GDE0213B1、GDEH0213B72
• 新增了對 GDEW026T0 2.6" 黑白 152x256 的支持
• 新增了對 GDEW0371W7 3.7" 黑白 240x416 的支持
• 新增了對 GDEW075Z08 7.5" 黑白/紅 800x480 的支持
• GDEW075Z08 確實允許（緩慢）部分更新，設定 usePartialUpdate = false 以停用以獲得更好的映像
• 更改了 4.2" 黑白波形表，以獲得更好的實際面板效果

版本1.1.9

• 使用 SS 進行 CS 時 ESP8266 的注意事項：（接線建議）
• 如果您的板或擴充板具有電平轉換器，請將 4.7k 下拉從 GPIO15 連接到 GND
• 修復大型顯示器（使用 uint16_t 作為緩衝區索引）

版本1.1.8

• 修正 GxEPD2_WiFi_Example 中下載不完整的問題
• 將缺少的方法 displayWindow() 加到 GxEPD2_GFX 基類
• 修復和清理具有差異更新的面板的初始刷新
• 對於這些面板，初始刷新需要完全更新，而不是“快速部分更新”，
• 因為螢幕內容可能與「先前的緩衝區」內容不同。
• 在初次寫入控制器時新增控制器緩衝區的清理，以進行部分更新。

版本1.1.7

• 增強了對全緩衝、非分頁使用的支持，適用於具有足夠 RAM 的處理器
• 使用無效顯示（布林partial_update_mode = false）；對應GxEPD中的update()
• 使用新增的 void displayWindow(uint16_t x, uint16_t y, uint16_t w, uint16_t h);
• 使用新增的 writeImagePart(...)、drawImagePart(...)，由 displayWindow() 使用
• 新增了範例 GxEPD2_NotPagedExample.ino
• 一些修復，例如 setPartialWindow() 中的參數範圍檢查

版本1.1.6

• 增加了對 GDEH0213B72 2.13" 黑白的支持，取代 GDE0213B1
• 將 IT8951 驅動程式 HAT 的 SPI 速度變更為 24MHz（寫入）、10MHz（讀取）
• 小修復，例如 GxEPD2_Example 中文字邊界框的居中

版本1.1.5

• 在 Waveshare e-Paper IT8951 驅動程式 HAT 上新增了對 6" ED060SCT 的支持
• 使用3.3V數據線，但5V電源（~80mA活動，~20mA待機，睡眠不起作用）
• 注意：5V供電需準確、強勁； USB 上的 5V 二極體（例如 Wemos D1 mini）不起作用！
• 請注意，IT8951 驅動程式 HAT 是特定於面板的，快閃記憶體由供應商參數化
• 這是初始版本

版本 1.1.4+

• 新增了 Waveshare ESP32 驅動板的 GxEPD2_WS_ESP32_Driver 範例

版本1.1.4

• 消除了“快速部分更新”的雙重刷新
• 將波表移至驅動程式類
• 新增了一個明確的 drawImage(...) 和 writeImage(...) 方法（用於刪除 1.1.3 的預設參數值）
• 新增了具有參數initial的init方法，用於在處理器深度睡眠喚醒後重新初始化
• 新增了初始化參數 pulldown_rst_mode，用於特殊的 RST 處理（waveshare 屏蔽不需要）

版本1.1.3

• GDEW029T5 和 GDEW0213I5F 的固定波表
• 修正了drawImage(...)重載方法簽章匹配歧義

版本1.1.2

• 新增了對 GDEW029T5 的支持
• 修復（新增）部分視窗的裁剪
• 修復（新增）完全更新後的 powerOff()（部分更新保持開機狀態）
• 添加了 hibernate() 以實現支援它的顯示器的最低功耗

版本1.1.1

• 2.7" 黑白 GDEW027W3，支援快速部分更新，基於新的示範程式碼波表
• 為 Arduino MEGA 新增了映射建議
• 注意：5V Arduino 使用分壓電阻，串聯電阻不夠可靠
• ConnectingHardware.md 已更新

版本1.1.0

• 增加了對 2.13 吋黑白 104x212 柔性顯示器的 GDEW0213I5F 的支持
• 更新了 GxEPD2_WiFi_Example 和 GxEPD2_Spiffs_Loader 以在 ESP8266 上使用 BearSSL，以進行大型位圖下載

版本1.0.9

• 加入 GxEPD2_U8G2_Fonts_Example，例如使用母音變音 ÄÖÜäéöü
• 注意：您需要將修改後的範例儲存到可儲存位置，UTF-8 字元才能正常運作

版本1.0.8

• 將 GxEPD2_SD_AVR_boards_added.h 加入到 GxEPD2_SD_AVR_Example
• 包含非 AVR 板的範例定義（低階顯示類別使用範例）

版本1.0.7

• 將 GxEPD2_boards_added.h 加入到 GxEPD2_Example
• 包含 Arduino DUE 和 MKR1000 的範例定義

版本1.0.6

• 將緩衝繪圖選項新增至 GxEPD2_WiFi_Example
• 允許與 1.54" 3 色 200x200 顯示器一起使用，對於小點陣圖也可能有用

版本1.0.5

• 將緩衝繪圖選項新增至 GxEPD2_SD_Example 和 GxEPD2_Spiffs_Example
• 允許與 1.54" 3 色 200x200 顯示器一起使用，對於小點陣圖也可能有用

版本1.0.4

• 新增 GxEPD2_GFX 基底類別支援（可選，可選，使用稍微多的程式碼）
• 基底類別 GxEPD2_GFX 可用來將引用或指標作為參數傳遞給顯示實例
• 新增GxEPD2_GFX_MultiDisplayExample，使用GxEPD2_GFX參考參數
• 修改 ESP8266 的 GxEPD2_MultiDisplayExample （模板問題：需要類別而不是類型名稱）

版本1.0.3

• 修復 GxEPD2_SD_Example 和 GxEPD2_SD_AVR_Example
• 新增GxEPD2_MultiDisplayExample（初步版本）

版本1.0.2

• 初始發布版本 1.0.2
• 使用 ESP8266、ESP32、STM32F103C8T6、AVR Arduino (Pro Mini 3.3V) 進行測試
• 1.54" 3色GxEPD2_154c可與AVR尋呼一起使用
• 程式空間中的波表，4.2" 黑白可與 GxEPD2_SD_AVR_Example 一起使用
• 已啟用問題並歡迎使用，請使用論壇主題獲取增強建議

版本1.0.1

• 預發布測試版本
• 新增了 GxEPD2_SD_AVR_Example，沒有圖形緩衝區以減少 RAM 使用（基本顯示類別使用）
• 到目前為止已禁用的問題，請改用 Arduino 論壇主題
• 在此版本中，1.54" 3 色 GxEPD2_154c 只能與全尺寸緩衝區一起使用（或無緩衝區基本顯示類別）

版本1.0.0

• 初步版本，正在建設中