From Waveshare Wiki
Jump to: navigation, search
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Infobox item
+
{{#tweekihide:firstHeading|sidebar-left|sidebar-right}}__NOTOC__
|name=4.2inch e-Paper (B)
 
|name2=4.2inch e-Paper Module (B)
 
|img=[[File:4.2inch-e-Paper-B-1.jpg|300px|lik=https://www.waveshare.com/4.2inch-e-Paper-B.htm]]
 
|img2=[[File:4.2inch-e-paper-module-b-3.jpg|300px|link=http://www.waveshare.com/4.2inch-e-paper-module-b.htm]]
 
|caption=400x300, 4.2inch E-Ink display raw panel
 
|caption2=400x300, 4.2inch E-Ink display 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/4.2inch-e-Paper-Module-B.htm 官方中文站点]
 
|website_en=[http://www.waveshare.com/4.2inch-e-paper-module-b.htm Waveshare website]
 
|interface1=SPI
 
|related=
 
{{Product List|OLEDs / LCDs/e-Paper}}
 
}}
 
<div class="tabber">
 
<div class="tabbertab" title="Introduction">
 
==About the versions==
 
<font backgound=white; color=#DD1223>
 
The 4.2inch e-Paper (B) raw panel was updated to the V2 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 V2 version. if your the first time buy and use this display, just need to download and use the new V2 examples. The V2 version has a "V2" sticker on the backside of the display panel. Please confirm the version by the sticker.
 
</font>
 
 
 
== Introduction ==
 
{{E-Paper Raw Panel}}
 
 
 
400x300, 4.2inch E-Ink display module, three-color, SPI interface
 
 
 
{{Amazon|{{#urlget:amazon|default}}=display
 
|More = [http://www.waveshare.com/product/4.2inch-e-paper-module-b.htm More]}}
 
 
 
= 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.  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''')
 
;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.
+
<div style="background-color: #343434;text-align: center;color: white;padding: 20px;margin: 8px;">
* CS is slave chip select, when CS is low, the chip is enabled.
+
=4.2inch e-Paper Module (B) Manual=
* 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/4.2inch_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/4.2inch_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/4.2inch_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/4.2inch_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
Process: Send command data start transmission 1 -> Send data of the black part of the image -> Send command data start transmission 2 -> Send data of the red part of the image -> Refresh the screen.
+
|img=[[File:Sunrise X3 Pi.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Working_With_Sunrise_X3_Pi]]
 
+
|heading = Working with Sunrise X3 Pi
Note:
+
|content = User guides for the development demo based on Python
* 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.
+
}}
For example:
+
{{StudyCard
<pre>
+
|img=[[File:STM321.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Working_With_STM32]]
0xC3:8 pixels □□■■■■□□
+
|heading = Working with the STM32
0x00:8 pixels ■■■■■■■■
+
|content = User guides for the development demo based on STM32CubeMX
0xFF:8 pixels □□□□□□□□
+
}}
0x66:8 pixels ■□□■■□□■
+
{{StudyCard|img=[[File:E-Paper_ESP32.jpg|110px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#ESP32.2F8266]]
</pre>
+
|heading = Working with ESP32/8266
* This module doesn’t support partial refresh.
+
|content = User guides for ESP32/8266}}
* The refresh rate of this module is slow, and it will flicker for several times during refreshing (about 15s). Please be patient.
+
{{StudyCard
-->
+
|img=[[File:Resource0.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Resources]]
<div class="tabbertab" title="Resources">
+
|heading = Resources
== Resources ==
+
|content = Documentation, procedures and data sheets, etc
 
+
}}
= Documentation =
+
{{StudyCard
*[https://www.waveshare.com/w/upload/2/20/4.2inch-e-paper-module-b-user-manual-en.pdf User Manual]
+
|img=[[File:FAQ01.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#FAQ]]
{{Commom Instruction of SPI e-paper}}
+
|heading = FAQ
* [[:File:4.2inch_e-Paper_Schematic.pdf|Schematic]]
+
|content = e-Paper frequently asked questions
 
+
}}
= Demo code =
+
{{StudyCard
*[https://github.com/waveshare/e-Paper Github]
+
|img=[[File:support00.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Support]]
 
+
|heading = Support
= Datasheets =
+
|content = Technical support
* [[:File:4.2inch-e-paper-b-specification.pdf|Datasheets]]
+
}}
 
+
}}
==Related Resources==
 
Notice:<br />
 
The projects listed are all made and shared by the project owners, Waveshare isn't responsible for project either the update.<br />
 
*[https://forum.arduino.cc/index.php?topic=487007.0 Waveshare e-Paper display with SPI]
 
:This is a post in Arduino Form about our SPI e-Paper thanks to ZinggJM, maybe you want to refer to.
 
*[https://github.com/aceisace/Inkycal Inkycal Project]
 
:This is the Inkycal project for reference.
 
== FAQ ==
 
<!--{{e-Paper FAQ}}-->
 
{{e-Paper FAQ}}
 
</div>
 
</div>
 
==Support==
 
{{Service00}}
 

Latest revision as of 06:26, 24 March 2023


4.2inch 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