1.9inch Segment e-Paper Module Manual

From Waveshare Wiki
Jump to: navigation, search
1.9inch Segment e-Paper
1.9inch Segment e-Paper Module.jpg
1.9inch Segment e-Paper Module
1.9inch Segment e-Paper Module02.jpg
{{{name3}}}

{{{name4}}}

{{{name5}}}

Overview

Feature

  • Dimension: 1.9 inch
  • Outline dimension (raw panel): 49.35 × 32.11 × 1.13 mm
  • Outline dimension (driver board): 51 × 34 mm
  • Display dimension: 41.35 × 28.11 mm
  • Working voltage: 3.3V/5V
  • Communication interfaces: IIC
  • Segment code: 91 segments
  • Display color: Black, White
  • Gray level: 2
  • Partial refreshing time: 0.3 s
  • Full refreshing time: 2s
  • Refresh Power Consumption: <5mW (typ.)
  • Standby current: <0.01uA (close to0)
  • Note:
    • Refresh time: The refresh time is the experimental results, the actual refresh time will have errors, and the actual effect shall prevail. There will be a flickering effect during the global refresh process, this is a normal phenomenon.
    • Power consumption: The power consumption data is the experimental results. The actual power consumption will have a certain error due to the existence of the driver board and the actual use situation. The actual effect shall prevail.

SPI Communication Timing

1.54inch-e-paper-manual-1.png
Since the ink screen only needs to be displayed, the data cable (MISO) sent from the machine and received by the host is hidden here.

  • CS: Slave chip select, when CS is low, the chip is enabled.
  • DC: data/command control pin, write command when DC=0; write data when DC=1.
  • SCLK: SPI communication clock.
  • SDIN: SPI communication master sends, the slave receives.
  • Timing: CPHL=0, CPOL=0 (SPI0).

[Remarks] For specific information about SPI, you can search for information online.

E-ink Refresh Principle

Working Principle

This product is an E-paper device adopting the image display technology of Microencapsulated Electrophoretic Display. The basic principle is that charged nanoparticles suspended in a liquid migrate under the action of an electric field. The E-paper screen display patterns by reflecting the ambient light, so it has no background light requirement. Under ambient light, the E-paper screen still has high visibility with a wide viewing angle of 180 degrees. It is the ideal choice for E-reading.

Pixel & Byte

We define the pixels in a monochrome picture, 0 is black and 1 is white.
White:□: Bit 1
Black:■: Bit 0

  • The dot in the figure is called a pixel. As we know, 1 and 0 are used to define the color, therefore we can use one bit to define the color of one pixel, and 1 byte = 8pixels
  • For example, If we set the first 8 pixels to black and the last 8 pixels to white, we show it by codes, they will be 16 bit as below:

E-paper hardware work 1.png

For computer, the data is saved in MSB format:
E-paper hardware work 2.png
So we can use two bytes for 16 pixels.

Segment Code Table

1.9inch Segment e-Paper Module Spec01.jpg

Number correspondence table (without decimal point):
0: 0 x bf, 0 x 1f
1: 0 x 1f (position 1), 0 x 00, 0 x 1f (other positions)
2: 0 x fd, 0 x 17
3: 0 x f5, 0 x 1f
4: 0 x 47, 0 x 1f
5: 0 x f7, 0 x 1d
6: 0 x ff, 0 x 1d
7: 0 x 21, 0 x 1f
8: 0 x ff, 0 x 1f
9: 0 x f7, 0 x 1f
The decimal point and % are the 5th place in the 4th, 8th, and 10th positions respectively.
The 13th position can display Celsius (0 x 05) and Fahrenheit (0 x 06), the 0th position is the bottom line, the 1st position is the middle line, the 2nd position is other displays, the 3rd position shows the Bluetooth logo, and the 4th position Bit shows the power identification, number 14 is useless.

Precautions

  1. For E-paper displays that support partial refresh, please note that you cannot refresh them with the partial refresh mode all the time. After refreshing partially several times, you need to fully refresh EPD once. Otherwise, the display effect will be abnormal, which cannot be repaired!
  2. It is a normal phenomenon that the three-color EPD will have a certain color difference in different batches. Hence, It is recommended to use the program to clear all the pictures on the EPD and store it facing up. Please clear the screen several times before powering on.
  3. Note that the screen cannot be powered on for a long time. When the screen is not refreshed, please set the screen to sleep mode or power off it. Otherwise, the screen will remain in a high voltage state for a long time, which will damage the e-Paper and cannot be repaired!
  4. When using the e-Paper display, it is recommended that the refresh interval be at least 180s, and refresh at least once every 24 hours. If the e-Paper is not used for a long time, you should use the program to clear the screen before storing it. (Refer to the datasheet for specific storage environment requirements.)
  5. After the screen enters sleep mode, the sent image data will be ignored, and it can be refreshed normally only after initializing again.
  6. The working voltage of the e-Paper display is 3.3V. If you buy the raw panel and you need to add a level convert circuit for compatibility with 5V voltage. The new version of the driver board (V2.1 and subsequent versions) has added a level processing circuit, which can support both 3.3V and 5V. The old version only supports a 3.3V working environment. You can confirm the version before using it. (The one with the 20-pin chip on the PCB is generally the new version.)
  7. The FPC cable of the screen is relatively fragile, pay attention to bending the cable along the horizontal direction of the screen when using it, and do not bend the cable along the vertical direction of the screen.
  8. The screen of e-Paper is relatively fragile, please try to avoid dropping, bumping, and pressing hard.
  9. We recommend that customers use the sample program provided by us to test with the corresponding development board.

Raspberry Pi

Provides BCM2835, WiringPi, IO, RPI (Python) libraries and demos.

Hardwware Connection

If the e-Paper you have is the HAT version which has 40pin GPIO, you can directly attach the e-Paper HAT on Raspberry Pi, otherwise, you can connect your e-Paper to Raspberry Pi by an 8pins cable provided.
To connect the e-Paper, you can follow the table below:

Raspberry Pi Pin Connection
e-Paper Raspberry Pi
BCM2835 Board
VCC 3.3V 3.3V
GND GND GND
SDA SDA.1 3
SCL SCL.1 5
RST 4 7
BUSY 17 11

1.9inch Raspberry Pi Guides01.jpg

Enable I2C Interface

The communication interface of e-Paper is SPI, to use it, we should firstly enable the SPI interface.
Open terminal of Raspberry Pi, and open the configuration by the following command:
sudo raspi-config
Choose Interfacing Options -> SPI -> Yes
Restart Raspberry Pi
sudo reboot

RPI open spi.png

Install libraries

Note: If you use the Bullseye image, please use "apt" instead of "apt-get" to install libraries, the Bullseye image could only support ptyhon3.


Open the terminal of Raspberry Pi and run the following commands to install corresponding libraries:

  • Install BCM2835 libraries
#Open the Raspberry Pi terminal and run the following command
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 libraries
#Open the Raspberry Pi terminal and run the following command
sudo apt-get install wiringpi
#For Raspberry Pi systems after May 2019 (earlier than before, you may not need to execute), you may need to upgrade:
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, the installation is wrong
#Bullseye branch system use 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, it means that there is an installation error
  • Install Python2 libraries
 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 RPi.GPIO
 sudo pip install spidev
  • Install Python3 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 RPi.GPIO
sudo pip3 install spidev

Download Test Program

Open the terminal of Raspberry Pi and execute:

sudo apt-get install p7zip-full
wget  https://www.waveshare.com/w/upload/f/f6/E-Paper-Segment-Code.zip
7z x E-Paper-Segment-Code.zip -O./e-Paper
cd e-Paper/RaspberryPi/

Run the Program

Please execute the following commands under RaspberryPi_JetsonNano, otherwise the directory will not be indexed;

C

  • Open main.c to select the screen of the corresponding size:
cd c
sudo nano examples/main.c 

If you are using 1.9inch Segment e-paper, please remove the "//" in front of the "EPD_1IN9_test()" function, then press Ctrl+c, press Y and Enter to save and exit, as shown in the figure: (The picture may be updated Not in time, the specific demo shall prevail.)
1.9inch Raspberry Pi Guides02.jpg
You can view test programs for all screen sizes, sorted by size:
1.9 inches:
EPD_1in9_test(): corresponds to the 1.9inch Segment e-paper test program;

  • Note: The above time is for reference only, please refer to the screen logo for the specific version.

  • Compile again and wait for seconds:
Return to the c directory and run the following command
make clean
make
sudo ./main

Python

PS: The system of the Bullseye branch only supports Python3.
  • Enter the python program directory and run the command ls -al
cd python
ls -al

1.9inch Raspberry Pi Guides03.jpg
You can view test programs for all screen sizes, sorted by size:
1.9 inches:
The 1inch9_E-paper directory corresponds to the 1.9inch Segment e-paper test program;

  • Note: The above time is for reference only, please refer to the screen logo for the specific version.

  • Just run the program corresponding to the screen, the program supports python2/3, take 1.54 V2 as an example:
# python2
cd 1in9_E-paper
sudo python main.py
# python3
cd 1in9_E-paper
sudo python3 main.py

STM32

The program provided is based on STM32F103RBT6, so you should connect it according to the pins of STM32F103RBT6. If you want to port the program, you must connect it based on the actual pins.

Hardware Connection

STM32F103RB pin
e-Paper STM32
VCC 3.3V
GND GND
SDA PB9/D14
SCL PB8/D15
RST PA9/D8
BUSY PA8/D7

Take our XNUCLEO-F103RB as an example, the connection is as follows:
1.9inch STM32 Guides02.jpg

Software

The demos are developed based on the HAL library. Download the program, find the STM32 program file directory, and open epd-demo.uvprojx in the STM32\STM32-F103ZET6\MDK-ARM directory to see the program.
1.9inch STM32 Guides01.jpg
Open main. c and you can see all the test programs. Remove the comment in front of the test program of the corresponding screen, and then recompile and download.
1.9inch STM32 Guides03.jpg
You can view test programs for all screen sizes, sorted by size:
1.9 inches:
EPD_1in9_test(): Corresponds to 1.9inch Segment e-paper test program

  • Note: The above time is for reference only, please refer to the screen logo for the specific version.

Arduino

All demos have been tested in Arduino uno. If you use Arduino in different models, you need to check the connection of the pins.

Hardware Connection

Arduino pins
e-Paper Arduino UNO Mega2560
Vcc 5V 5V
GND GND GND
SDA SDA SDA
SCL SCL SCL
RST D8 D8
BUSY D7 D7

1.9inch Segment e-Paper Module-Aduino.jpg

Install Compile Software (Windows)

Arduino IDE installation

Run the Program

Please download E-paper-segment-code and unzip it. Arduino program is in "~/Arduino/…"
1.9inch Arduino Guides02.jpg
Please open the corresponding program according to the EPD model.
1.9inch Arduino Guides03.jpg
You can view test programs for all screen sizes, sorted by size:
1.9 inches:
EPD_1in9: Corresponds to 1.9inch segment e-paper test program;

  • Note: The above time is for reference only, please refer to the screen logo for the specific version.

For example, 1.54inch e-Paper Module. Open the epd1in54 folder and run the epd1in54.ino file.
Open the program, and select the development board model Arduino UNO.
1.9inch Arduino Guides04.jpg
Choose the corresponding COM.
1.9inch Arduino Guides05.jpg
Then click to compile and download.
1.9inch Arduino Guides06.jpg

Resource

Documentation

Program

Datasheet

FAQ

Question about Software

 Answer:
Install the imaging library using the command sudo apt-get install python-imaging.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
Install the imaging library using the command sudo apt-get install python-imaging.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
In this case, the customer needs to reduce the position of the round brush and clear the screen after 5 rounds of refreshing (increasing the voltage of VCOM can improve the color, but it will increase the afterimage).
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
The process of re-awakening the e-ink screen is actually the process of re-powering on the power. Therefore, when the EPD wakes up, it must first clear the screen, so as to avoid the afterimage phenomenon to the greatest extent.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
*It may be caused by the unsuccessful spi driver.

1. First check whether the wiring is correct.
2. Check whether the spi is turned on and whether the parameters are configured correctly (spi baud rate, spi mode and other parameters).

{{{3}}}
{{{4}}}

{{{5}}}


Question about Hardware

 Answer:
Yes, now there is a level conversion chip onboard, supporting 3.3V drive.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
The rated input voltage of the ink screen is 2.3~3.6V. If it is a 5V system, level conversion is required. In addition, the voltage should not be lower than 2.5V, so as not to affect the display effect of the ink screen.

Device selection can use the model in the schematic diagram we provide or choose according to the data sheet.

{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
Yes, pay attention to the correct timing.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
Check if SPI communication is normal.

Confirm whether the BUSY pin is normally initialized to input mode.
It may be that there is no normal reset, try to shorten the duration of the low level during reset (because the power-off switch is added to the drive circuit, the reset low level is too long, which will cause the drive board to power off and cause the reset to fail). If the busy function sends the 0x71 command, you can try to comment it out.

{{{3}}}
{{{4}}}

{{{5}}}


Question about Screen

 Answer:
*【Working conditions】Temperature range: 0~50°C; Humidity range: 35%~65%RH.
  • 【Storage conditions】: Temperature range: below 30°C; Humidity range: below 55%RH; Maximum storage time: 6 months.
  • 【Transportation conditions】: Temperature range: -25~70°C; Maximum transportation time: 10 days.
  • 【After unpacking】: Temperature range: 20°C±5°C; Humidity range: 50±5%RH; Maximum storage time: Assemble within 72 hours.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
*refresh mode
    • Full brush: The electronic ink screen will flicker several times during the refresh process (the number of flickers depends on the refresh time), and the flicker is to remove the afterimage to achieve the best display effect.
    • Bureau brush: The electronic ink screen has no flickering effect during the refresh process. Users who use the partial brushing function note that after refreshing several times, a full brush operation should be performed to remove the residual image, otherwise the residual image problem will become more and more serious, or even damage the screen (currently only some black and white e-ink screens support partial brushing, please refer to product page description).
    • refresh rate
    • During use, it is recommended that customers set the refresh interval of the e-ink screen to at least 180 seconds (except products that support the local brush function).
    • During the standby process (that is, after the refresh operation), it is recommended that the customer set the e-ink screen to sleep mode, or power off operation (the power supply part of the ink screen can be disconnected with an analog switch) to reduce power consumption and prolong the life of the e-ink screen. (If some e-ink screens are powered on for a long time, the screen will be damaged beyond repair.)
    • During the use of the three-color e-ink screen, it is recommended that customers update the display screen at least once every 24 hours (if the screen remains the same screen for a long time, the screen burn will be difficult to repair).
  • Application
    • The e-ink screen is recommended for indoor use. If it is used outdoors, it is necessary to avoid direct sunlight on the e-ink screen, and at the same time, take UV protection measures, because charged particles will dry out under strong light for a long time, resulting in loss of activity and failure to refresh. This situation is irreversible. When designing e-ink screen products, customers should pay attention to determining whether the use environment meets the requirements of e-ink screen.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
Ideally, with normal use, it can be refreshed 1,000,000 times (1 million times).
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
Power on the development board for a long time, after each refresh operation, it is recommended to set the screen to sleep mode or directly power off processing, otherwise the screen may burn out when the screen is in a high voltage state for a long time.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
Yes, but you need to re-initialize the electronic paper with software.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
The display gray scale of electrophoretic electronic paper is determined by the spatial position of the particles in the microcapsule or microcup. The electrophoresis phenomenon occurs between black particles and white particles under the action of voltage. This voltage sequence that promotes the electrophoretic movement of the particles is the driving force of the electronic paper. waveform. The driving waveform is the core part of the electronic paper display, and the optimization of the driving waveform will directly affect the display effect of the display. The driving waveform file is used to describe the parameters formed by the voltage sequence that promotes the electrophoretic movement of the particles, and it needs to be called regularly when the electronic paper is refreshed.

Different batches of e-paper diaphragms and electrophoretic matrices require different voltage values ​​when driving the display due to materials, manufacturing processes, etc. The waveform of the e-ink screen is reflected in the relationship between grayscale, voltage and temperature. Generally speaking, after each batch of electrophoresis matrix is ​​generated, there will be a corresponding waveform file in the form of a .wbf file. The film manufacturer will provide the waveform file and electrophoresis matrix to the manufacturer of the electronic paper screen, and then the The manufacturer of electronic paper screen integrates the protection board, substrate and driver and then provides it to customers; if the waveform file does not correspond to the screen, it is likely that the display cannot be displayed or the display effect is unsatisfactory. Generally, the waveform file has OTP built into the driver IC of the ink screen when leaving the factory, and some programs we provide also call external waveform files to drive the e-ink screen.

{{{3}}}
{{{4}}}

{{{5}}}


Others

 Answer:
with film.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
0.5mm pitch, 8Pin.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
Cable socket 0.5-8pin rear flip type 2.0H (FPC connector).
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
The full brush initialization function needs to be added when the ink screen is switched from partial brush to full brush.
{{{3}}}
{{{4}}}

{{{5}}}


 Answer:
It may be a demo based on the BCM2835 library that has run the C language before. At this time, you need to restart the Raspberry Pi and then run the python demo.
{{{3}}}
{{{4}}}

{{{5}}}


Support

If you require technical support, please go to the Support page and open a ticket.