[riot-notifications] [RIOT-OS/RIOT] black/white e-Paper/e-Ink display driver (#12509)
Jean Pierre Dudey
notifications at github.com
Mon Nov 2 11:21:13 CET 2020
Finally made it work on an `esp32-wroom-32` board with the following patch (with a previous `git rebase master`):
<details>
<summary>0001-fixup-epd_bw_spi-add-generic-black-and-white-SPI-e-P.patch</summary>
```patch
>From d7a2b5f36b52b13970758371017d6d6f559d451c Mon Sep 17 00:00:00 2001
From: Jean Pierre Dudey <me at jeandudey.tech>
Date: Mon, 2 Nov 2020 11:14:47 +0100
Subject: [PATCH] fixup! epd_bw_spi: add generic black and white SPI e-Paper
display driver
---
drivers/epd_bw_spi/epd_bw_spi.c | 23 +++++++++++-------
.../epd_bw_spi/include/epd_bw_spi_params.h | 24 ++++++++++++++++++-
drivers/include/epd_bw_spi.h | 7 ++++++
3 files changed, 45 insertions(+), 9 deletions(-)
diff --git a/drivers/epd_bw_spi/epd_bw_spi.c b/drivers/epd_bw_spi/epd_bw_spi.c
index c1c407a40..6f76537a3 100644
--- a/drivers/epd_bw_spi/epd_bw_spi.c
+++ b/drivers/epd_bw_spi/epd_bw_spi.c
@@ -64,7 +64,7 @@ void epd_bw_spi_wait(epd_bw_spi_params_t *p, uint32_t usec)
while (gpio_read(p->busy_pin)) {}
}
else {
- DEBUG("[epd_bw_spi] wait: for %lu microseconds\n", usec);
+ DEBUG("[epd_bw_spi] wait: for %"PRIu32"microseconds\n", usec);
xtimer_usleep(usec);
}
}
@@ -114,9 +114,10 @@ int epd_bw_spi_init(epd_bw_spi_t *dev,
void epd_bw_spi_display_init(epd_bw_spi_t *dev)
{
+ epd_bw_spi_hwreset(dev);
+
le_uint16_t y_data[2] = { 0 };
uint8_t y_size;
-
if (dev->controller.size_y <= 255) {
y_data[0].u8[0] = dev->size_y - 1;
y_size = 2;
@@ -179,7 +180,7 @@ void epd_bw_spi_deactivate(epd_bw_spi_t *dev)
void epd_bw_spi_init_full(epd_bw_spi_t *dev)
{
epd_bw_spi_display_init(dev);
- epd_bw_spi_set_area(dev, 0, 200, 0, 200);
+ epd_bw_spi_set_area(dev, 0, dev->size_x, 0, dev->size_y);
epd_bw_spi_write_cmd(&dev->params, EPD_BW_SPI_CMD_WRITE_LUT_REGISTER,
dev->controller.lut_full, dev->controller.lut_size);
}
@@ -301,18 +302,24 @@ void epd_bw_spi_sleep(epd_bw_spi_t *dev)
}
void epd_bw_spi_wake(epd_bw_spi_t *dev)
+{
+ epd_bw_spi_hwreset(dev);
+
+ /* Turn off sleep mode */
+ uint8_t data[] = { 0x00 };
+ epd_bw_spi_write_cmd(&dev->params, EPD_BW_SPI_CMD_DEEP_SLEEP_MODE, data, 1);
+ epd_bw_spi_wait(&dev->params, EPD_BW_SPI_WAIT_RESET);
+}
+
+void epd_bw_spi_hwreset(epd_bw_spi_t *dev)
{
/* Give a low pulse on the reset pin */
if (dev->params.rst_pin != GPIO_UNDEF) {
gpio_clear(dev->params.rst_pin);
xtimer_usleep(EPD_BW_SPI_WAIT_RESET);
gpio_set(dev->params.rst_pin);
+ xtimer_usleep(EPD_BW_SPI_WAIT_RESET);
}
-
- /* Turn off sleep mode */
- uint8_t data[] = { 0x00 };
- epd_bw_spi_write_cmd(&dev->params, EPD_BW_SPI_CMD_DEEP_SLEEP_MODE, data, 1);
- epd_bw_spi_wait(&dev->params, EPD_BW_SPI_WAIT_RESET);
}
void epd_bw_spi_swreset(epd_bw_spi_t *dev)
diff --git a/drivers/epd_bw_spi/include/epd_bw_spi_params.h b/drivers/epd_bw_spi/include/epd_bw_spi_params.h
index a0590ff40..544ad0a27 100644
--- a/drivers/epd_bw_spi/include/epd_bw_spi_params.h
+++ b/drivers/epd_bw_spi/include/epd_bw_spi_params.h
@@ -37,7 +37,7 @@ extern "C" {
#define EPD_BW_SPI_PARAM_SPI_CLK (SPI_CLK_5MHZ)
#endif
#ifndef EPD_BW_SPI_PARAM_CS
-#define EPD_BW_SPI_PARAM_CS (GPIO_UNDEF)
+#define EPD_BW_SPI_PARAM_CS (SPI_CS_UNDEF)
#endif
#ifndef EPD_BW_SPI_PARAM_DC
#define EPD_BW_SPI_PARAM_DC (GPIO_UNDEF)
@@ -84,6 +84,15 @@ static const uint8_t epd_bw_spi_il3829_lut_default_part[] = {
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
0x13, 0x14, 0x44, 0x12, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 };
+/**
+ * @brief Waveform lookup table for a full display refresh for SSD1608
+ * (HINK-E0154A05 e-Paper).
+ */
+static const uint8_t epd_bw_spi_ssd1608_hink_e0154a05_lut_default_full[] = {
+ 0x02, 0x02, 0x01, 0x11, 0x12, 0x12, 0x22, 0x22, 0x66, 0x69,
+ 0x69, 0x59, 0x58, 0x99, 0x99, 0x88, 0x00, 0x00, 0x00, 0x00,
+ 0xF8, 0xB4, 0x13, 0x51, 0x35, 0x51, 0x51, 0x19, 0x01, 0x00 };
+
/**
* @brief Configuration for IL3829 e-paper display controller
*/
@@ -108,6 +117,19 @@ static const uint8_t epd_bw_spi_il3829_lut_default_part[] = {
.lut_part = epd_bw_spi_il3829_lut_default_part, \
}
+/**
+ * @brief Configuration for SSD1608 (HINK-E0154A05) e-paper display controller
+ */
+#define EPD_BW_SPI_CONTROLLER_SSD1608_HINK_E0154A05 { \
+ .vcom = 0xA8, \
+ .size_x = 240, \
+ .size_y = 320, \
+ .lut_size = sizeof epd_bw_spi_ssd1608_hink_e0154a05_lut_default_full, \
+ .lut_full = epd_bw_spi_ssd1608_hink_e0154a05_lut_default_full, \
+ /* NOTE: uses this one of IL3829 for partial updates */ \
+ .lut_part = epd_bw_spi_il3829_lut_default_part, \
+}
+
/**
* @brief Default controller definition
*/
diff --git a/drivers/include/epd_bw_spi.h b/drivers/include/epd_bw_spi.h
index a64165771..8f6767ed3 100644
--- a/drivers/include/epd_bw_spi.h
+++ b/drivers/include/epd_bw_spi.h
@@ -233,6 +233,13 @@ void epd_bw_spi_sleep(epd_bw_spi_t *dev);
*/
void epd_bw_spi_wake(epd_bw_spi_t *dev);
+/**
+ * @brief Perform a hardware reset of the device.
+ *
+ * This will make the IC registers to be on POR values.
+ */
+void epd_bw_spi_hwreset(epd_bw_spi_t *dev);
+
/**
* @brief Perform a soft reset of the device.
*
--
2.17.1
```
</details>
With the example code of `tests/driver_epd_bw_spi`:
```make
include ../Makefile.tests_common
BOARD ?= nucleo-f411re
USEMODULE += xtimer
USEMODULE += epd_bw_spi
CFLAGS += -DDISPLAY_X=200
CFLAGS += -DDISPLAY_Y=200
CFLAGS += -DEPD_BW_SPI_CONTROLLER=EPD_BW_SPI_CONTROLLER_SSD1608_HINK_E0154A05
CFLAGS += -DEPD_BW_SPI_PARAM_CS=GPIO23
CFLAGS += -DEPD_BW_SPI_PARAM_DC=GPIO16
CFLAGS += -DEPD_BW_SPI_PARAM_RST=GPIO17
CFLAGS += -DEPD_BW_SPI_PARAM_BUSY=GPIO21
CFLAGS += -DSPI0_MOSI=GPIO18
CFLAGS += -DSPI0_SCK=GPIO5
CFLAGS += -DSPI0_CS=GPIO23
include $(RIOTBASE)/Makefile.include
```
--
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/RIOT-OS/RIOT/pull/12509#issuecomment-720379356
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.riot-os.org/pipermail/notifications/attachments/20201102/55d849cb/attachment-0001.htm>
More information about the notifications
mailing list