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 board)
  • 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 at low temperatures may cause color shift. It is recommended to let the screen stand at 25°C for 6 hours 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: CPHA=0, CPOL=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 black and white images, we can define black as 0 and white as 1. Thus, we have a way to represent colors:
  • White: □, corresponds to 1
  • Black: ■: corresponds to 0
• A point on an image is generally called a pixel. Since the color is either 1 or 0, 1 bit can represent a pixel: 1 Pixel = 1 bit. Therefore, one byte contains 8 pixels.
• Take 16 pixels as an example. Suppose the first 8 pixels are black and the last 8 pixels are white. We can consider pixels 1-16 correspond to bits 0 to 15, where 0 represents black and 1 represents white:
  
  
  For computers, data storage is typically Most Significant Bit (MSB) first, and one byte consists of only 8 bits. So, there is a slight adjustment:
  
  
  In this way, only 2 bytes are required to represent 16 pixels.
• Now suppose we have six colors, so at least three bits are needed to represent all colors. However, for ease of computation, we add a 0 in front, i.e., use four bits to represent the color of one pixel, so one byte (1 Byte) can represent two pixels. In fact, the controller of this module uses this method.
  
  
• Taking four pixels as an example, assume the colors of these four points are yellow, blue, red, and green in order. According to the table above, human logic would store them sequentially as:
  
  
• For a computer, data is stored with the most significant bit first and the least significant bit last, and one byte has only eight bits, so it is stored in bytes as:
  
  

Hardware Connection​

• Connect using the 9PIN cable. 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:
  # project-downloads.drogon.net has been discontinued. Please use the GitHub method below for installation.
  # wget https://project-downloads.drogon.net/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 example (skip if already downloaded)

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

  sudo apt-get install p7zip-full
  7z x 1.54inch_e-Paper_E.zip -O./1.54inch_e-Paper_E
  cd 1.54inch_e-Paper_E/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/1.54inch_e-Paper_E/RaspberryPi_JetsonNano
    

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

  # It is now in 1.54inch_e-Paper_E/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 example (skip if already downloaded)

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

  sudo apt-get install p7zip-full
  7z x 1.54inch_e-Paper_E.zip -O./1.54inch_e-Paper_E
  cd 1.54inch_e-Paper_E/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/1.54inch_e-Paper_E/RaspberryPi_JetsonNano
    

• Run the program

  # Make sure it is in 1.54inch_e-Paper_E/RaspberryPi_JetsonNano/ position
  cd python/examples/
  python3 epd_1in54e_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 and extract the example, and you will see the following content:
  
  
• Open the test program: 1.54inch_e-Paper_E/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​

• Connect using the 9PIN cable. 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 example (skip if already downloaded)

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

  sudo apt-get install p7zip-full
  7z x 1.54inch_e-Paper_E.zip -O./1.54inch_e-Paper_E
  cd 1.54inch_e-Paper_E/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/1.54inch_e-Paper_E/RaspberryPi_JetsonNano
    

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

  # It is now in 1.54inch_e-Paper_E/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 example (skip if already downloaded)

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

  sudo apt-get install p7zip-full
  7z x 1.54inch_e-Paper_E.zip -O./1.54inch_e-Paper_E
  cd 1.54inch_e-Paper_E/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/1.54inch_e-Paper_E/RaspberryPi_JetsonNano
    

• Run the program

  # Make sure it is in 1.54inch_e-Paper_E/RaspberryPi_JetsonNano/ position
  cd python/examples/
  python3 epd_1in54e_test.py

Hardware Connection​

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

STM32 Pin Mapping

Running the Program​

• In the Resources section download the example package, then unzip it and enter the 1.54inch_e-Paper_E directory to see the following contents:
  
  
• Use Keil to open epd-demo.uvprojx in the 1.54inch_e-Paper_E/STM32-F103ZET6/MDK-ARM.
• 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 and extract the example, and you will see the following content:
  
  
• Open the test program: 1.54inch_e-Paper_E\ESP32\ESP32.ino or 1.54inch_e-Paper_E\ESP32-S3\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. Examples​

• 1.54inch_e-Paper_E Examples (GitHub)

2. Hardware Resources​

• 1.54inch_e-Paper_E Driver Board Schematic

3. Technical Manuals​

• 1.54inch e-Paper (E) Datasheet

4. Software Tools​

• Arduino IDE Official Download Link
• Chinese Character Conversion Software
• Image2Lcd Image Bitmap Conversion Software

5. Other Resources​

• Creating Dithering Images with Photoshop
• API Analysis
• E-Paper Font Library Tutorial
• Image2Lcd Image Bitmap Conversion Steps
• pwnagotchi Porting Guide
• Raspberry Pi Getting Started Tutorial
• E-Paper Dashboard (Inkycal)
• Quectel-Pi e-Paper Reader
• GPS Tracker (papertrail)
• TuyaOpen e-Paper Driver
• ESP32-Arduino Official Documentation

Support

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

Email: services01@spotpear.com