Features​

• No backlight required; can retain the last displayed content for a long time after power-off
• Very low power consumption, mainly only consumes power during refresh
• Provides comprehensive supporting documentation: driver board schematic, Raspberry Pi / Jetson Nano / Arduino / STM32 / ESP32 example programs, etc.
• The following applies only to the module version (with driver HAT)
  • Designed based on the Raspberry Pi 40PIN GPIO interface, suitable for Raspberry Pi, Jetson Nano
  • Reserved SPI communication interface for easy connection to master controllers such as Raspberry Pi / Arduino / STM32 / ESP32
  • Onboard level shifter chip, compatible with 3.3V and 5V logic levels

Specifications​

• Refresh Time: The refresh time is based on experimental test data. The actual refresh time may vary; please refer to the actual performance. Flickering during the full refresh process is normal.
• Refresh Power Consumption: Power consumption data is based on experimental test data. Actual power consumption may vary due to the presence of the driver board and different usage conditions; please refer to the actual performance.
• Refreshing in low-temperature environments may cause color shift. The screen should be left stationary for 6 hours at 25°C before refreshing.

Communication Interface​

• CSB (CS): Slave chip select signal, active low. The chip is enabled when this signal is low.
• SCL (SCK/SCLK): Serial clock signal.
• D/C (DC): Data/Command control signal. A low level indicates a command is being written; a high level indicates data/parameters are being written.
• SDA (DIN): Serial data signal.
• Timing: CPOL=0, CPHA=0, i.e., SPI mode 0.
• Note: For specific information regarding SPI communication, you can search online for more details.

Working Principle​

The e-Paper used in this product employs "Microencapsulated Electrophoretic Display" technology for image display. The basic principle involves charged nanoparticles suspended in a liquid migrating under the influence of an electric field. The e-Paper display relies on reflecting ambient light to show patterns and does not require a backlight. Under ambient light, the e-Paper display is clearly visible, with a viewing angle approaching 180°. Therefore, e-Paper displays are ideal for reading.

Programming Principle​

For four-color e-Paper, we can understand it by analogy with a black‑and‑white 4‑grayscale display, but there are differences. To save memory, the e‑Paper compresses pixels:

• Black: 00b
• White: 01b
• Yellow: 10b
• Red: 11b Let's take 4 pixels as an example:
  
  
  Writing 0x1B into register 0x10 sets the four pixels on the e-Paper screen to black, white, yellow, and red respectively.

Precautions​

Image Processing​

• Image preparation and conversion for multi‑color e-Paper

Image Preparation​

Preparation

• Required software: Adobe PhotoShop CC, Paint

Introduction

• The Floyd‑Steinberg dithering algorithm is very suitable for displaying rich gradation when only a few colors are available. This allows for more color combinations and better shadow rendering of the original image. It is especially suitable for various use scenarios of e-Paper screens.
• The following describes how to convert a normal image into a Floyd‑Steinberg dithered image.
• If you are interested in the actual algorithm, you can look at our porting for ESP32 and ESP8266. Here, no further elaboration will be given.

Operation steps

• Preparation: Download Color table to your PC, and extract it to get the following file, we need to use N-color.act or 4-color.act, 6-color.act.
  
  
  1. Create a new Photoshop project, set the width and height according to the actual resolution of the e-Papre screen, and use RGB color in the color mode. If the screen resolution used is 800*480, change the width to 800 pixels and the height to 480 pixels.
     
     
  2. Prepare the corresponding materials, copy them into the project, and adjust parameters such as size and contrast (similar to the steps involved in general Photoshop image processing).
     
     
  3. Select File -> Save for Web in the format used for the Web and device.
     
     
  4. Select Load Color Table as shown below. Load the Color Table provided in the Preparation section.
     
     
  5. For seven-color pictures, load N-color.act, then click Save to save as a gif file. It is then converted to BMP format for use on this module.
     For four-color pictures, load 4-color.act, then click Save to save as a gif file. It is then converted to BMP format for use on this module.
     For six-color pictures, load 6-color.act, then click Save to save as a gif file. It is then converted to BMP format for use on this module.
     
     
     
  6. Open the GIF file with Paint, save it as a 24-bit BMP picture.
     
     
  7. The image is now ready. It can be used on the Raspberry Pi or e‑Paper Shield module via TF card, or converted into an array for use with other embedded devices as described in the next section.

Image Data Conversion​

Download Programs

• Four‑color conversion application: Four‑color image conversion application
• E6 full‑color conversion application: [E6 full‑color image conversion application](https://files.waveshare.com/wiki/common/ConverterTo6color.zip E6 full-color picture conversion app)
• Seven‑color conversion application: Seven‑color image conversion application
• Source code: Program source code

Bug Resolution

• If you are using Windows 10/11 and have not installed VS (Microsoft Visual Studio) or other Microsoft development tools, you may encounter the following errors when using this program:
  
  
  
  
• This indicates that your computer is missing these two components. Solutions:
• 1. Install VS (Microsoft Visual Studio) or other Microsoft development tools (e.g., Visual C++ Redistributable).
• 2. Use the two component files
     
     
     Place these two files in the directory C:\Windows\System32, then restart your computer.

Conversion Steps

• Place the prepared image(s) and the corresponding .exe application in the same folder (multiple images can be placed).
• Drag and drop the image onto the .exe file; the program will convert the image into a .c file with a fixed name.
• Double‑click the .cmd file; the program will convert all images of the correct size in the folder into .c files with corresponding names.
• Single‑image conversion for four‑color (click image to see demonstration):
  
  
• Multiple‑image conversion for four‑color (click image to see demonstration):
  
  
• Single‑image conversion for seven‑color (click image to see demonstration):
  
  
• Multiple‑image conversion for seven‑color (click image to see demonstration):
  
  

Hardware Connection​

• When connecting to the Raspberry Pi, you can directly plug the board onto the 40PIN header, ensuring the pins are aligned correctly.
• If using a 9PIN cable, please refer to the pin mapping table below:
  • Raspberry Pi pin mapping

    e-Paper	Raspberry Pi Pin Mapping
    	BCM2835 Pin	Board Physical Pin Number
    VCC	3.3V	3.3V
    GND	GND	GND
    DIN	MOSI	19
    CLK	SCLK	23
    CS	CE0	24
    DC	25	22
    RST	17	11
    BUSY	24	18
    PWR	18	12

Enabling the SPI Interface​

• Open the Raspberry Pi terminal and enter the following command to access the configuration interface:

  sudo raspi-config
  

  Select Interfacing Options -> SPI -> Yes to enable the SPI interface

  
  

• Reboot the Raspberry Pi:

  sudo reboot
  

• Check /boot/config.txt, you should see that dtparam=spi=on has been written

  
  

• To ensure SPI is not occupied, it is recommended to temporarily disable other driver overlays. Use ls /dev/spi* to check the SPI occupancy. The terminal output /dev/spidev0.0 and /dev/spidev0.1 indicates that SPI is functioning normally.

  
  

Running the C Example​

• Install the lg library

  #Open the Raspberry Pi terminal and run the following commands:
  wget https://github.com/joan2937/lg/archive/master.zip
  unzip master.zip
  cd lg-master
  make
  sudo make install
  # For more information, please refer to the source code: https://github.com/gpiozero/lg
  
  Install gpiod library (optional)

  #Open the Raspberry Pi terminal and run the following commands:
  sudo apt-get update
  sudo apt install gpiod libgpiod-dev
  
  Install BCM2835 (optional)

  #Open the Raspberry Pi terminal and run the following commands:
  wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.71.tar.gz
  tar zxvf bcm2835-1.71.tar.gz 
  cd bcm2835-1.71/
  sudo ./configure && sudo make && sudo make check && sudo make install
  # For more information, please refer to the official website: http://www.airspayce.com/mikem/bcm2835/
  
  Install wiringPi (optional)

  #Open the Raspberry Pi terminal and run the following commands:
  sudo apt-get install wiringpi
  #For Raspberry Pi systems after May 2019 (those earlier may not require execution), an upgrade may be necessary:
  wget https://files.waveshare.com/wiki/common/wiringpi-latest.deb
  sudo dpkg -i wiringpi-latest.deb
  gpio -v
  # Run gpio -v and version 2.52 will appear. If it does not appear, there is an installation error.
  
  #Bullseye branch system uses the following command:
  git clone https://github.com/WiringPi/WiringPi
  cd WiringPi
  ./build
  gpio -v
  # Run gpio -v and version 2.60 will appear. If it does not appear, there is an installation error.
  

• Download the demo (skip if already downloaded)

  wget https://files.waveshare.com/wiki/4.26inch_e-Paper_G/4.26inch_e-Paper_G.zip
  unzip 4.26inch_e-Paper_G.zip -d 4.26inch_e-Paper_G
  cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  
  Alternative extraction method

  git clone https://github.com/waveshare/e-Paper.git
  cd e-Paper/E-paper_Separate_Program/4.26inch_e-Paper_G/RaspberryPi_JetsonNano
  
  Download the program via GitHub (alternative method, skip if already downloaded)

  • Accessing GitHub may not be very smooth at present. It is recommended to use the above method to download from our official website.

    sudo apt-get install p7zip-full
    7z x 4.26inch_e-Paper_G.zip -O./4.26inch_e-Paper_G
    cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
    

• Compile the program (Note: -j4 uses 4 threads for compilation; you can modify the number)

  # It is now in 4.26inch_e-Paper_G/RaspberryPi_JetsonNano
  cd c
  sudo make clean
  sudo make -j4
  

• Run the program

  sudo ./epd
  

Running the Python Example​

• Install libraries

  sudo apt-get update
  sudo apt-get install python3-pip
  sudo apt-get install python3-pil
  sudo apt-get install python3-numpy
  sudo pip3 install spidev
  
  Install libraries (python2)

  sudo apt-get update
  sudo apt-get install python-pip
  sudo apt-get install python-pil
  sudo apt-get install python-numpy
  sudo pip install spidev
  
  Install gpiozero library (pre-installed by default, if not, install using the following commands)

  sudo apt-get update
  # python3
  sudo apt install python3-gpiozero
  # python2
  sudo apt install python-gpiozero
  

• Download the demo (skip if already downloaded)

  wget https://files.waveshare.com/wiki/4.26inch_e-Paper_G/4.26inch_e-Paper_G.zip
  unzip 4.26inch_e-Paper_G.zip -d 4.26inch_e-Paper_G
  cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  
  Alternative extraction method

  sudo apt-get install p7zip-full
  7z x 4.26inch_e-Paper_G.zip -O./4.26inch_e-Paper_G
  cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  
  Download the program via GitHub (alternative method, skip if already downloaded)

  • Accessing GitHub may not be very smooth at present. It is recommended to use the above method to download from our official website.

    git clone https://github.com/waveshare/e-Paper.git
    cd e-Paper/E-paper_Separate_Program/4.26inch_e-Paper_G/RaspberryPi_JetsonNano
    

• Run the program

  # Make sure it is in 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  cd python/examples/
  python3 epd_5in0_test.py

Hardware Connection​

• Connect using the 9PIN cable. Refer to the pin mapping table below:
  • Arduino pin mapping

    e-Paper	Arduino UNO	Mega2560
    VCC	5V	5V
    GND	GND	GND
    DIN	D11	D51
    CLK	D13	D52
    CS	D10	D10
    DC	D9	D9
    RST	D8	D8
    BUSY	D7	D7
    PWR	D6	D6

Installing the IDE​

Arduino IDE Windows Installation Tutorial

Running the Program​

• In the Resources section download the demo package, then unzip it and enter the 4.26inch_e-Paper_G directory to see the following contents:
  
  
• Open the demo: 4.26inch_e-Paper_G\Arduino_R4\Arduino_R4.ino
  
  
• In the Arduino IDE toolbar (Tools), select the corresponding Board and Port:
  
  
• Finally, click Upload. A successful upload is shown below (Arduino 1.8.13):
  
  

Hardware Connection​

• The 40PIN header on the Jetson Nano is compatible with the Raspberry Pi's 40PIN header, and it provides a Jetson.GPIO library whose API is consistent with the Raspberry Pi's RPI.GPIO library. Therefore, the pin numbers used here are the same as those for the Raspberry Pi. When using the 40PIN interface, you can directly plug the module into the 40PIN header of the Jetson Nano.

• If using a 9PIN cable, please refer to the pin mapping table below:

  Jetson Nano pin mapping

  e-Paper	Jetson Nano Developer Kit
  	BCM2835 Pin	Board Physical Pin Number
  VCC	3.3V	3.3V
  GND	GND	GND
  DIN	10(SPI0_MOSI)	19
  CLK	11(SPI0_SCK)	23
  CS	8(SPI0_CS0)	24
  DC	25	22
  RST	17	11
  BUSY	24	18
  PWR	18	12

Running the C Example​

• Download the demo (skip if already downloaded)

  wget https://files.waveshare.com/wiki/4.26inch_e-Paper_G/4.26inch_e-Paper_G.zip
  unzip 4.26inch_e-Paper_G.zip -d 4.26inch_e-Paper_G
  cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  
  Alternative extraction method

  sudo apt-get install p7zip-full
  7z x 4.26inch_e-Paper_G.zip -O./4.26inch_e-Paper_G
  cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  
  Download the program via GitHub (alternative method, skip if already downloaded)

  • Accessing GitHub may not be very smooth at present. It is recommended to use the above method to download from our official website.

    git clone https://github.com/waveshare/e-Paper.git
    cd e-Paper/E-paper_Separate_Program/4.26inch_e-Paper_G/E-RaspberryPi_JetsonNano
    

• Compile the program (Note: -j4 uses 4 threads for compilation; you can modify the number)

  # It is now in 4.26inch_e-Paper_G/RaspberryPi_JetsonNano
  cd c
  sudo make clean
  sudo make JETSON -j4
  

• Run the program

  sudo ./epd
  

Running the Python Example​

• Install libraries

  sudo apt-get update
  sudo apt-get install python3-numpy
  sudo apt-get install python3-pip
  sudo pip3 install Jetson.GPIO
  

• Download the demo (skip if already downloaded)

  wget https://files.waveshare.com/wiki/4.26inch_e-Paper_G/4.26inch_e-Paper_G.zip
  unzip 4.26inch_e-Paper_G.zip -d 4.26inch_e-Paper_G
  cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  
  Alternative extraction method

  sudo apt-get install p7zip-full
  7z x 4.26inch_e-Paper_G.zip -O./4.26inch_e-Paper_G
  cd 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  
  Download the program via GitHub (alternative method, skip if already downloaded)

  • Accessing GitHub may not be very smooth at present. It is recommended to use the above method to download from our official website.

    git clone https://github.com/waveshare/e-Paper.git
    cd e-Paper/E-paper_Separate_Program/4.26inch_e-Paper_G/E-RaspberryPi_JetsonNano
    

• Run the program

  # Make sure it is in 4.26inch_e-Paper_G/RaspberryPi_JetsonNano/
  cd python/examples/
  python3 epd_5in0_test.py

Hardware Connection​

Use a 9PIN cable to connect, please refer to the pin corresponding table below:

STM32 Pin Mapping

Running the Program​

• Click to download the demo package, then unzip it and enter the 4.26inch_e-Paper_G directory to see the following contents:
  
  
• Use Keil to open epd-demo.uvprojx in the 4.26inch_e-Paper_G\STM32-F103ZET6\MDK-ARM directory
• Open the Keil compile toolbar (usually already open):
  
  
• Click Build.
  
  
• Ensure a suitable programmer is connected, then click Load to download the program to the microcontroller.

Hardware Connection​

ESP32 Pin Mapping

Environment Configuration​

Online installation requires the use of VPN software, while offline installation does not require the use of VPN software

• Install Online

Running the Program​

• In the Resources section download the demo package, then unzip it and enter the 4.26inch_e-Paper_G directory to see the following contents:
  
  
• Open the demo: 4.26inch_e-Paper_G\ESP32\ESP32.ino or 4.26inch_e-Paper_G\ESP32\ESP32-S3.ino
  
  
  
  
• In the Arduino IDE toolbar (Tools), select the corresponding Board and Port:
  
  
• If using a core like the ESP32-S3 with PSRAM, please enable PSRAM
  
  
• Finally, click Upload. A successful upload is shown below (Arduino 2.2.1):
  
  

1. Hardware Resources​

Driver Board Design Files

• Driver Board Schematic

2. Technical Manuals​

• 4.26inch e-Paper (G) Datasheet
• SSD2677 Datasheet

3. Demo​

• Github

4. Software Tools​

• Arduino:
  • Arduino IDE Official Download Link
  • ESP32-Arduino Official Documentation

5. Other Resource Links​

• Development Resources:

  • Creating Scatter Plots with Photoshop
  • API Analysis
  • Chinese Character Conversion Software
  • E-Paper Font Library Tutorial
  • Image2Lcd Image Bitmap Conversion Software
  • Image2Lcd Image Bitmap Conversion Steps
  • pwnagotchi Porting Guide

• Related Links:

  • Raspberry Pi Getting Started Tutorial
  • E-Paper Dashboard (Inkycal)
  • Quectel-Pi e-Paper Reader
  • GPS Tracker (papertrail)
  • TuyaOpen e-Paper Driver

Support

Monday-Friday (9:30-6:30) Saturday (9:30-5:30)

Email: services01@spotpear.com