From Waveshare Wiki
Jump to: navigation, search
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Infobox item
|name=2.9inch Touch e-Paper HAT
|img=[[File:2.9inch-Touch-e-Paper-HAT-1.jpg|300px|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=}}]]
|caption=2.9inch Touch EPD HAT For Raspberry Pi, 296×128 Pixels, Black / White, SPI Interface
|category=[[:Category:OLEDs / LCDs|OLEDs / LCDs]], [[:Category:LCD|LCD]]
|{{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}=display
|website_cn=[ 官方中文站点]
|website_en=[ Waveshare website]
{{Product List|OLEDs / LCDs/e-Paper}}
<div class="tabber">
<div class="tabbertab" title="Introduction">
*Size: 2.9inch
*Outline dimensions(Module): 89.1mm × 42.7mm
*Outline dimensions(Driver Board): 79.50mm × 37.50mm
*Display area: 66.89mm × 29.05mm
*Operating Voltage: 3.3V/5V
*Communication interface: SPI
*Dot pitch: 0.227 * 0.226
*Resolution: 296×128 pixels
*Display color: black, white
*Grey scale: 2
*Partial refresh time: 0.3s
*Full refresh time: 2s
*Refresh power: 26.4mW(typ.)
*Touchpoints: 5 (MAX)
*Touch type: Capacitive touch
*Touch interfaced: I2C
*Touch panel: Toughened Glass
*Refresh time: The refresh time is experimental test data, there will have some deviation from the actual refresh time, so please refer to the actual refresh time. The e-paper will flicker during the full refresh process, this is a normal phenomenon.
*Power consumption: The power consumption data is experimental test data. The actual power consumption will have a certain deviation due to the existence of the driver board and the actual usage. Please refer to the actual refresh power consumption.
===SPI Communication protocol===
Note: Different from the traditional SPI protocol, the data line from the slave to the master is hidden since the device only has a display requirement.
* CS is slave chip select, when CS is low, the chip is enabled.
* DC is data/command control pin, when DC = 0, write command, when DC = 1, write data.
* SCLK is the SPI communication clock.
* SDIN is the data line from the master to the slave in SPI communication.
* Timing: CPHL=0, CPOL=0 (SPI0
===Working protocol===
<div style="background-color: #343434;text-align: center;color: white;padding: 20px;margin: 8px;">
This product is an E-paper device adopting the image display technology of Microencapsulated Electrophoretic Display, MED. The initial approach is to create tiny spheres, in which the charged color pigments are suspending in the transparent oil and would move depending on the electronic charge. The E-paper screen displays 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. ('''Note that the e-Paper cannot support updating directly under sunlight''')
=2.9inch Touch e-Paper HAT Manual=
===Pixel & Byte===
We define the pixels in a monochrome picture, 0 is black and 1 is white.<br />
White:□,Bit 1<br />
Black:■:Bit 0<br />
*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<br />
*For example, If we set first 8 pixels to black and the last 8 pixels to white, we show it by codes, they will be 16 bit as below:<br />
[[file:e-paper_hardware_work_1.png]]<br />
For computer, the data is saved in MSB format:<br />
[[file:e-paper_hardware_work_2.png]]<br />
So we can use two bytes for 16 pixels.<br />
#For the screen that supports partial update, please note that you cannot refresh the screen with the partial mode all the time. After several partial updating, you need to fully refresh the screen once. Otherwise, the screen display effect will be abnormal, which cannot be repaired!<br/>
#Because of the different batches, some of them have aberrations. Store the e-Paper right side up will reduce it. And if the e-Paper didn't be refreshed for a long time, it will become more and more reddish/yellowish. Please use the demo code to refresh the e-paper several times in this case.<br/>
#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 the e-Paper. Otherwise, the screen will remain in a high voltage state for a long time, which will damage the e-Paper and cannot be repaired!<br/>
#When using the e-Paper, 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, the ink screen should be brushed and stored. (Refer to the datasheet for specific storage environment requirements)<br/>
#After the screen enters sleep mode, the sent image data will be ignored, and it can be refreshed normally only after initializing again.<br/>
#Control the 0x3C or 0x50 (refer to the datasheet for details) register to adjust the border color. In the routine, you can adjust the Border Waveform Control register or VCOM AND DATA INTERVAL SETTING to set the border.<br/>
#If you find that the created image data is displayed incorrectly on the screen, it is recommended to check whether the image size setting is correct, change the width and height settings of the image and try again.<br/>
#The working voltage of the e-Paper 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 working environments. The old version can only support 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)<br/>
#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<br/>
#The screen of e-Paper is relatively fragile, please try to avoid dropping, bumping, and pressing hard.<br/>
#We recommend that customers use the sample program provided by us to test with the corresponding development board after they get the screen.<br/>
<div class="tabbertab" title="Working with Pi">
{{Hardware/Software setting for touch e-paper HAT}}
|content =
|heading = Introduction
|content = Parameters, principles and precautions}}
{{StudyCard|img=[[File:Rapberry Pi.jpg|110px|link=]]
<div class="tabbertab" title="Codes description">
|heading = Working with Raspberry Pi
{{touch e-Paper Codes Description}}
|content = User guides for the development demo of C language, Python}}
<div class="tabbertab" title="Resources">
|heading = API Analysis
|content = User guides for C and Python demos}}
|heading = Resources
{{Commom Instruction of SPI e-paper}}
|content = Documentation, procedures and data sheets, etc}}
* [ Schematic]
===Demo code===
<!--  * [ Demo code](只更新github) -->
|heading = FAQ
* [ Github]
|content = e-Paper frequently asked questions}}
* [ 2.9inch e-Paper Specification V2]
|heading = Support
|content = Technical support
<div class="tabbertab" title="FAQ">
<!--{{e-Paper FAQ}}-->
{{e-Paper FAQ}}
<div class="tabbertab" title="Support">

Latest revision as of 02:58, 18 November 2022

2.9inch Touch e-Paper HAT Manual

E-Paper Introduction 4.jpg


Parameters, principles and precautions
Rapberry Pi.jpg

Working with Raspberry Pi

User guides for the development demo of C language, Python

API Analysis

User guides for C and Python demos


Documentation, procedures and data sheets, etc


e-Paper frequently asked questions


Technical support