Cirkit Designer Logo
Cirkit Designer
Your all-in-one circuit design IDE
Home / 
Component Documentation

How to Use Waveshare2.13 e-paper HAT v4: Examples, Pinouts, and Specs

Image of Waveshare2.13 e-paper HAT v4
Cirkit Designer LogoDesign with Waveshare2.13 e-paper HAT v4 in Cirkit Designer

Introduction

The Waveshare 2.13 e-Paper HAT v4 is a compact display module that leverages e-paper technology to deliver low-power, high-contrast visual output. With its 2.13-inch screen, this module is ideal for applications requiring static images, text, or graphical data. Its compatibility with Raspberry Pi and other microcontrollers makes it a versatile choice for a wide range of projects.

Explore Projects Built with Waveshare2.13 e-paper HAT v4

Use Cirkit Designer to design, explore, and prototype these projects online. Some projects support real-time simulation. Click "Open Project" to start designing instantly!
Battery-Powered Raspberry Pi and ESP32-CAM Smart Display with 7-inch WaveShare Touchscreen
Image of diagram: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
This circuit integrates a Raspberry Pi 4b, a 7-inch WaveShare display, an ESP32-CAM, and a Li-ion battery. The Raspberry Pi is powered by the Li-ion battery and interfaces with the ESP32-CAM via GPIO pins for data communication, while the WaveShare display is also powered by the same battery to provide visual output.
Cirkit Designer LogoOpen Project in Cirkit Designer
ESP8266 NodeMCU OLED Display: Wi-Fi Enabled Hello World Project
Image of oled: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
This circuit features an ESP8266 NodeMCU microcontroller connected to a 1.3-inch OLED display via I2C communication. The microcontroller initializes the display and renders basic graphics and text, demonstrating a simple interface for visual output.
Cirkit Designer LogoOpen Project in Cirkit Designer
Raspberry Pi 4B-Based Multi-Sensor Interface Hub with GPS and GSM
Image of Rocket: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
This circuit features a Raspberry Pi 4B interfaced with an IMX296 color global shutter camera, a Neo 6M GPS module, an Adafruit BMP388 barometric pressure sensor, an MPU-6050 accelerometer/gyroscope, and a Sim800l GSM module for cellular connectivity. Power management is handled by an MT3608 boost converter, which steps up the voltage from a Lipo battery, with a resettable fuse PTC and a 1N4007 diode for protection. The Adafruit Perma-Proto HAT is used for organizing connections and interfacing the sensors and modules with the Raspberry Pi via I2C and GPIO pins.
Cirkit Designer LogoOpen Project in Cirkit Designer
ESP32-C3 Battery-Powered Weather Station with E-Ink Display
Image of Micro Final Project: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
This circuit is a battery-powered weather station using an ESP32-C3 microcontroller, an E-Ink display, and two climate sensors (AHT21 and BMP280). It measures temperature, humidity, and pressure, displaying the data on the E-Ink screen, with a pushbutton to toggle between metric and imperial units.
Cirkit Designer LogoOpen Project in Cirkit Designer

Explore Projects Built with Waveshare2.13 e-paper HAT v4

Use Cirkit Designer to design, explore, and prototype these projects online. Some projects support real-time simulation. Click "Open Project" to start designing instantly!
Image of diagram: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
Battery-Powered Raspberry Pi and ESP32-CAM Smart Display with 7-inch WaveShare Touchscreen
This circuit integrates a Raspberry Pi 4b, a 7-inch WaveShare display, an ESP32-CAM, and a Li-ion battery. The Raspberry Pi is powered by the Li-ion battery and interfaces with the ESP32-CAM via GPIO pins for data communication, while the WaveShare display is also powered by the same battery to provide visual output.
Cirkit Designer LogoOpen Project in Cirkit Designer
Image of oled: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
ESP8266 NodeMCU OLED Display: Wi-Fi Enabled Hello World Project
This circuit features an ESP8266 NodeMCU microcontroller connected to a 1.3-inch OLED display via I2C communication. The microcontroller initializes the display and renders basic graphics and text, demonstrating a simple interface for visual output.
Cirkit Designer LogoOpen Project in Cirkit Designer
Image of Rocket: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
Raspberry Pi 4B-Based Multi-Sensor Interface Hub with GPS and GSM
This circuit features a Raspberry Pi 4B interfaced with an IMX296 color global shutter camera, a Neo 6M GPS module, an Adafruit BMP388 barometric pressure sensor, an MPU-6050 accelerometer/gyroscope, and a Sim800l GSM module for cellular connectivity. Power management is handled by an MT3608 boost converter, which steps up the voltage from a Lipo battery, with a resettable fuse PTC and a 1N4007 diode for protection. The Adafruit Perma-Proto HAT is used for organizing connections and interfacing the sensors and modules with the Raspberry Pi via I2C and GPIO pins.
Cirkit Designer LogoOpen Project in Cirkit Designer
Image of Micro Final Project: A project utilizing Waveshare2.13 e-paper HAT v4 in a practical application
ESP32-C3 Battery-Powered Weather Station with E-Ink Display
This circuit is a battery-powered weather station using an ESP32-C3 microcontroller, an E-Ink display, and two climate sensors (AHT21 and BMP280). It measures temperature, humidity, and pressure, displaying the data on the E-Ink screen, with a pushbutton to toggle between metric and imperial units.
Cirkit Designer LogoOpen Project in Cirkit Designer

Common Applications

  • Digital signage and labels
  • IoT dashboards and displays
  • Low-power information panels
  • E-book readers
  • Smart home devices

Technical Specifications

Key Technical Details

Specification Value
Display Technology E-paper (EPD)
Screen Size 2.13 inches
Resolution 250 × 122 pixels
Display Colors Black, White, and Red
Interface SPI
Operating Voltage 3.3V / 5V
Power Consumption (Active) ~26.4mW
Power Consumption (Idle) ~0.017mW
Refresh Time ~2 seconds
Dimensions 65mm × 30.2mm

Pin Configuration

The Waveshare 2.13 e-Paper HAT v4 uses a 2×20 GPIO header for connection. Below is the pin configuration:

Pin Name GPIO Pin (Raspberry Pi) Description
VCC 2 (5V) or 1 (3.3V) Power supply
GND 6 Ground
DIN 19 (GPIO10, MOSI) SPI data input
CLK 23 (GPIO11, SCLK) SPI clock input
CS 24 (GPIO8, CE0) Chip select
DC 22 (GPIO25) Data/Command control
RST 11 (GPIO17) Reset
BUSY 18 (GPIO24) Busy status indicator

Usage Instructions

Connecting the e-Paper HAT to a Raspberry Pi

  1. Hardware Setup:

    • Align the Waveshare 2.13 e-Paper HAT v4 with the Raspberry Pi GPIO header.
    • Ensure the pins are properly connected as per the pin configuration table above.
    • Power on the Raspberry Pi.
  2. Software Setup:

    • Install the required libraries and dependencies:
      sudo apt update
      sudo apt install python3-pip
      pip3 install RPi.GPIO spidev
      
    • Clone the Waveshare e-Paper library:
      git clone https://github.com/waveshare/e-Paper
      cd e-Paper/RaspberryPi_JetsonNano/python
      
  3. Running a Demo:

    • Navigate to the example directory:
      cd examples
      
    • Run the demo script:
      python3 epd_2in13_V2_test.py
      

Example Code for Custom Display

Below is an example Python script to display custom text on the e-paper screen:

import sys
import os
from waveshare_epd import epd2in13_V2  # Import the e-paper library
from PIL import Image, ImageDraw, ImageFont  # For creating custom images
import time

try:
    # Initialize the e-paper display
    epd = epd2in13_V2.EPD()
    epd.init()
    epd.Clear(0xFF)  # Clear the display to white

    # Create a blank image for drawing
    image = Image.new('1', (epd.height, epd.width), 255)  # 1-bit mode, white background
    draw = ImageDraw.Draw(image)

    # Load a font and write text
    font = ImageFont.truetype('/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf', 18)
    draw.text((10, 10), 'Hello, e-Paper!', font=font, fill=0)  # Black text

    # Display the image on the e-paper
    epd.display(epd.getbuffer(image))
    time.sleep(2)

    # Put the display to sleep to save power
    epd.sleep()

except IOError as e:
    print(f"IOError: {e}")

except KeyboardInterrupt:
    print("Program interrupted")
    epd2in13_V2.epdconfig.module_exit()
    sys.exit()

Best Practices

  • Always ensure the e-paper module is connected securely to avoid loose connections.
  • Avoid frequent refreshes to minimize ghosting and extend the lifespan of the display.
  • Use the epd.sleep() function to reduce power consumption when the display is not in use.
  • Handle the module carefully to avoid damaging the delicate e-paper screen.

Troubleshooting and FAQs

Common Issues and Solutions

Issue Possible Cause Solution
Display not refreshing Incorrect wiring Verify pin connections.
Missing software dependencies Install required libraries.
Incorrect SPI configuration Enable SPI on Raspberry Pi.
Ghosting on the display Frequent refreshes Reduce refresh frequency.
Display not cleared before update Use epd.Clear() before updates.
Module not detected by software Incorrect GPIO pin mapping Check pin configuration.
Faulty module Test with another Raspberry Pi.

FAQs

  1. Can I use this module with Arduino?

    • Yes, but you will need to use the appropriate e-paper library for Arduino and connect the pins accordingly.
  2. What is the refresh rate of the display?

    • The refresh time is approximately 2 seconds. This is typical for e-paper technology.
  3. Can I display images on this module?

    • Yes, you can display monochrome or tri-color (black, white, red) images by converting them to the appropriate format.
  4. How do I clean the display?

    • Use a soft, dry cloth to gently wipe the screen. Avoid using liquids or abrasive materials.

By following this documentation, you can effectively integrate and utilize the Waveshare 2.13 e-Paper HAT v4 in your projects.