From Waveshare Wiki
Jump to: navigation, search
 
(25 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Infobox item
+
{{#tweekihide:firstHeading|sidebar-left|sidebar-right}}__NOTOC__
|name=2.9inch e-Paper (B)
 
|name2=2.9inch e-Paper Module (B)
 
|img=[[File:2.9inch-e-Paper-B-1.jpg|300px|link=https://www.waveshare.com/2.9inch-e-Paper-B.htm]]
 
|img2=[[File:2.9inch-e-paper-module-b-4.jpg|300px|link=http://www.waveshare.com/2.9inch-e-paper-module-b.htm]]
 
|caption=296x128, 2.9inch EPD panel
 
|caption2=296x128, 2.9inch EPD module, three-color, SPI interface
 
|category=[[:Category:OLEDs / LCDs|OLEDs / LCDs]], [[:Category:LCD|LCD]]
 
|brand=Waveshare
 
|{{#urlget:amazon|default}}=display
 
|website_cn=[http://www.waveshare.net/shop/2.9inch-e-Paper-Module-B.htm 官方中文站点]
 
|website_en=[http://www.waveshare.com/2.9inch-e-paper-module-b.htm Waveshare website]
 
|interface1=SPI
 
|related=
 
{{Product List|OLEDs / LCDs/e-Paper}}
 
}}
 
<div class="tabber">
 
<div class="tabbertab" titile="Introduction">
 
==About the versions==
 
<font backgound=white; color=#DD1223>
 
The 2.9inch e-Paper (B) raw panel was updated to the V3 version. The controller and the driver codes are different and the codes of the two versions are not compatible with each other. Except for the software, the outline of the two versions is the same. If you are the regulars of this display, please note that you need to update your driver codes with the new version refer to our new examples for the V3 version. if your the first time buy and use this display, just need to download and use the new V3 examples. The V2 version has a "V3" sticker on the backside of the display panel. Please confirm the version by the sticker.
 
</font>
 
 
 
==Introduction ==
 
{{E-Paper Raw Panel}}
 
 
 
296x128, 2.9inch EPD (Electronic Paper Display) module, three-color, SPI interface
 
  
{{Amazon|{{#urlget:amazon|default}}=display
+
<div style="background-color: #343434;text-align: center;color: white;padding: 20px;margin: 8px;">
|More = [http://www.waveshare.com/product/2.9inch-e-paper-module-b.htm More]}}
+
=2.9inch e-Paper Module (B) Manual=
= Interfaces =
 
{|class="wikitable"
 
|-
 
| VCC || 3.3V
 
|-
 
| GND || GND
 
|-
 
| DIN || SPI MOSI
 
|-
 
| CLK || SPI SCK
 
|-
 
| CS || SPI chip select (Low active)
 
|-
 
| DC || Data/Command control pin (High for data, and low for command)
 
|-
 
| RST || External reset pin (Low for reset)
 
|-
 
| BUSY || Busy state output pin (Low for busy)
 
|}
 
= Working principle =
 
; Introduction
 
----
 
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 display patterns by reflecting the ambient light, so it has no background light requirement. ('''Note that the e-Paper cannot support updating directly under sunlight''')
 
=== Communication protocol ===
 
[[File:1.54inch-e-paper-manual-1.png|400px]]
 
 
 
Note: Different from the traditional SPI protocol, the data line from the slave to the master is hidden since the device only has 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.
 
SPI communication has data transfer timing, which is combined by CPHA and CPOL.
 
# CPOL determines the level of the serial synchronous clock at idle state. When CPOL = 0, the level is Low. However, CPOL has little effect to the transmission.
 
# CPHA determines whether data is collected at the first clock edge or at the second clock edge of serial synchronous clock; when CPHL = 0, data is collected at the first clock edge.
 
* There are 4 SPI communication modes. SPI0 is commonly used, in which CPHL = 0, CPOL = 0.
 
As you can see from the figure above, data transmission starts at the first falling edge of SCLK, and 8 bits of data are transferred in one clock cycle. In here, SPI0 is in used, and data is transferred by bits, MSB first.
 
 
</div>
 
</div>
<div class="tabbertab" title="User Guides of Pi">
+
<p></p>
 
+
{{ContentGrid|grid-gap=25px
We provide several examples for testing, you first test the e-Paper by following the guides. If your developing board is different, you need to write your codes yourself by following the resources.
+
|content =
{{Raspberry Pi Guides for SPI e-Paper}}
+
{{StudyCard
</div>
+
|img=[[File:E-Paper_Introduction_4.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Overview]]
<div class="tabbertab" title="User Guides of Jetson Nano">
+
|heading = Introduction
{{Jetson Nano Guides for SPI e-Paper}}
+
|content = Parameters, principles, and precautions
</div>
+
}}
<div class="tabbertab" title="User Guides of STM32">
+
{{StudyCard
{{STM32 Guides for SPI e-Paper}}
+
|img=[[File:Rapberry Pi.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Working_With_Raspberry_Pi]]
</div>
+
|heading = Working with Raspberry Pi
<div class="tabbertab" title="User Guides of Arduino">
+
|content = User guides for the development demo of C language, Python
{{Arduino Guides for SPI e-Paper}}
+
}}
</div>
+
{{StudyCard
<div class="tabbertab" title="User Guides of ESP32">
+
|img=[[File:Arduino00.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Working_With_Arduino]]
{{ESP32 Guides for SPI e-Paper}}
+
|heading = Working with the Arduino
</div>
+
|content = User guides for the development demo based on Arduino UNO R3
<div class="tabbertab" title="User Guides of ESP8266">
+
}}
{{ESP8266 Guides for SPI e-Paper}}
+
{{StudyCard
</div>
+
|img=[[File:Jetson Arduino00.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Working_With_Jetson_Nano]]
<!--
+
|heading = Working with the Jetson Nano
=== Display a Frame (DisplayFrame) ===
+
|content = User guides for the development demo of C language, Python
DisplayFrame is used to send a frame to module, and the screen will refresh and display it.
+
}}
 +
{{StudyCard
 +
|img=[[File:Sunrise X3 Pi.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Working_With_Sunrise_X3_Pi]]
 +
|heading = Working with Sunrise X3 Pi
 +
|content = User guides for the development demo based on Python
 +
}}
 +
{{StudyCard
 +
|img=[[File:STM321.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Working_With_STM32]]
 +
|heading = Working with the STM32
 +
|content = User guides for the development demo based on STM32CubeMX
 +
}}
  
Process: Send command data start transmission 1 -> Send data of dark area -> Send command data start transmission 2 -> Send data of red area -> Refresh the screen.
+
{{StudyCard|img=[[File:E-Paper_ESP32.jpg|110px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#ESP32.2F8266]]
Note:
+
|heading = Working with ESP32/8266
* One frame consist of images of black area and red area, so we need to send two images for displaying one frame,
+
|content = User guides for ESP32/8266}}
* 1 byte = 8 pixels, doesn’t support Gray scale (Can only display black and white). A bit set stands for a white pixel, otherwise a bit reset stands for black/red.
 
  
For example:
+
{{StudyCard
<pre>
+
|img=[[File:Resource0.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Resources]]
0xC3:8 pixels □□■■■■□□
+
|heading = Resources
0x00:8 pixels ■■■■■■■■
+
|content = Documentation, procedures and data sheets, etc
0xFF:8 pixels □□□□□□□□
+
}}
0x66:8 pixels ■□□■■□□■
+
{{StudyCard
</pre>
+
|img=[[File:FAQ01.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#FAQ]]
* This module doesn’t support partial refresh.
+
|heading = FAQ
* The refresh rate of this module is slow, and it will flicker for several times during refreshing (about 15s). Please be patient.
+
|content = e-Paper frequently asked questions
-->
+
}}
<div class="tabbertab" title="Resources">
+
{{StudyCard
== Resources ==
+
|img=[[File:support00.jpg|121px|link=https://www.waveshare.com/wiki/2.9inch_e-Paper_Module_(B)_Manual#Support]]
 
+
|heading = Support
= Documentation =
+
|content = Technical support
*[https://www.waveshare.com/w/upload/5/55/2.9inch-e-paper-module-b-user-manual-en.pdf User Manual]
+
}}
{{Commom Instruction of SPI e-paper}}
+
}}
* [[:File:2.9inch_e-Paper_Schematic.pdf|Schematic]]
 
 
 
= Demo code =
 
*[https://github.com/waveshare/e-Paper Github]
 
 
 
= Datasheets =
 
* [[:File:2.9inch-e-paper-b-specification.pdf|Datasheets]]
 
*[https://www.waveshare.com/w/upload/a/af/2.9inch-e-paper-b-v3-specification.pdf 2.9inch e-Paper B V3 Specification]
 
 
 
=Related Resources=
 
This is a post in Arduino Form about our SPI e-Paper thanks to ZinggJM, maybe you want to refer to.
 
*[https://forum.arduino.cc/index.php?topic=487007.0 Waveshare e-Paper display with SPI]
 
</div>
 
<div class="tabbertab" title="FAQ">
 
== FAQ ==
 
<!--{{e-Paper FAQ}}-->
 
{{e-Paper FAQ}}
 
</div>
 
</div>
 
==Support==
 
{{Service00}}
 

Latest revision as of 06:13, 24 March 2023


2.9inch e-Paper Module (B) Manual

E-Paper Introduction 4.jpg

Introduction

Parameters, principles, and precautions
Rapberry Pi.jpg

Working with Raspberry Pi

User guides for the development demo of C language, Python
Arduino00.jpg

Working with the Arduino

User guides for the development demo based on Arduino UNO R3
Jetson Arduino00.jpg

Working with the Jetson Nano

User guides for the development demo of C language, Python
Sunrise X3 Pi.jpg

Working with Sunrise X3 Pi

User guides for the development demo based on Python
STM321.jpg

Working with the STM32

User guides for the development demo based on STM32CubeMX
E-Paper ESP32.jpg

Working with ESP32/8266

User guides for ESP32/8266
Resource0.jpg

Resources

Documentation, procedures and data sheets, etc
FAQ01.jpg

FAQ

e-Paper frequently asked questions
Support00.jpg

Support

Technical support