From Waveshare Wiki
Jump to: navigation, search
 
(11 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|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=https://www.waveshare.com/4.2inch-e-Paper-B.htm}}]]
 
|img2=[[File:4.2inch-e-paper-module-b-3.jpg|300px|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=http://www.waveshare.com/4.2inch-e-paper-module-b.htm}}]]
 
|caption=400x300, 4.2inch EPD panel
 
|caption2=400x300, 4.2inch EPD module, three-color, SPI interface
 
|category=[[:Category:OLEDs / LCDs|OLEDs / LCDs]], [[:Category:LCD|LCD]]
 
|brand=Waveshare
 
|{{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| 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">
 
=Overview=
 
==Version==
 
<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>
 
  
==Features==
+
<div style="background-color: #343434;text-align: center;color: white;padding: 20px;margin: 8px;">
*Dimension: 4.2inch
+
=4.2inch e-Paper Module (B) Manual=
*Outline Dimension (Raw panel): 90.1mm x 77.0mm x 1.18mm
 
*Outline Dimension (Driver board): 103.0mm x 78.5mm
 
*Display Size: 84.8mm x 63.6mm
 
*Operating Voltage: 3.3V/5V
 
*Interface: SPI
 
*Dot Pitch: 0.212 x 0.212
 
*Resolution: 400 x 300
 
*Display Color: Black, White, Red
 
* Grey Level: 2
 
*Full Refresh Time: 15s
 
*Refresh Power: 38.4mW(Typ.)
 
*Standby Current: <0.01uA (almost none)
 
*Note:
 
1.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
 
 
 
2. 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==
 
[[File:1.54inch-e-paper-manual-1.png|400px]]
 
 
 
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, slave receives
 
*Timing: CPHL=0, CPOL=0 (SPI0)
 
[Remarks] For specific information about SPI, you can search for information online.<big>
 
 
 
==Working principle==
 
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 suspended 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''')
 
===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 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:<br />
 
[[file:e-paper_hardware_work_1.png]]<br />
 
 
 
*For 4.2inch e-paper B, it is red and black, we need to split the picture into 2 pictures, one black and white picture, one red and white picture, because one register controls the black and white display during transmission, and the other register is the control red and white
 
show. 4.2 1 byte of black and white part controls 8 pixels, 1 byte of red and white part controls 8 pixels
 
For example, suppose there are 8 pixels, the first 4 are red, and the last 4 are black:
 
They need to be split into a black and white picture and a red and white picture. Both pictures have 8 pixels, but the first four pixels of the black and white picture are white, the last 4 pixels are black, and the first 4 pixels of the red and white picture are black. pixels are red, the last four pixels are white
 
[[File:02.png]]
 
 
 
If we specify that white is stored as 1 and red or black is stored as 0, then we have the following representation:
 
[[File:03.png]]
 
 
 
And 1 byte of black and white part controls 8 pixels, and 1 byte of red and white part controls 8 pixels, then it can be expressed as follows:
 
[[File:111.png]]
 
==Precautions==
 
#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/>
 
 
 
{{Raspberry Pi Guides for SPI e-Paper}}
 
 
</div>
 
</div>
<div class="tabbertab" title="User Guides of Jetson Nano">
+
<p></p>
{{Jetson Nano Guides for SPI e-Paper}}
+
{{ContentGrid|grid-gap=25px
</div>
+
|content =
<div class="tabbertab" title="User Guides of STM32">
+
{{StudyCard
{{STM32 Guides for SPI e-Paper}}
+
|img=[[File:E-Paper_Introduction_4.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Overview]]
</div>
+
|heading = Introduction
<div class="tabbertab" title="User Guides of Arduino">
+
|content = Parameters, principles, and precautions
{{Arduino Guides for SPI e-Paper}}
+
}}
</div>
+
{{StudyCard
<div class="tabbertab" title="User Guides of ESP32">
+
|img=[[File:Rapberry Pi.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Working_With_Raspberry_Pi]]
{{ESP32 Guides for SPI e-Paper}}
+
|heading = Working with Raspberry Pi
</div>
+
|content = User guides for the development demo of C language, Python
<div class="tabbertab" title="User Guides of ESP8266">
+
}}
{{ESP8266 Guides for SPI e-Paper}}
+
{{StudyCard
</div>
+
|img=[[File:Arduino00.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Working_With_Arduino]]
<!--
+
|heading = Working with the Arduino
=== Display a Frame (DisplayFrame) ===
+
|content = User guides for the development demo based on Arduino UNO R3
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: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
Note:
+
|content = User guides for the development demo of C language, 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:Sunrise X3 Pi.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Working_With_Sunrise_X3_Pi]]
0xC3:8 pixels □□■■■■□□
+
|heading = Working with Sunrise X3 Pi
0x00:8 pixels ■■■■■■■■
+
|content = User guides for the development demo based on Python
0xFF:8 pixels □□□□□□□□
+
}}
0x66:8 pixels ■□□■■□□■
+
{{StudyCard
</pre>
+
|img=[[File:STM321.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Working_With_STM32]]
* This module doesn’t support partial refresh.
+
|heading = Working with the STM32
* The refresh rate of this module is slow, and it will flicker for several times during refreshing (about 15s). Please be patient.
+
|content = User guides for the development demo based on STM32CubeMX
-->
+
}}
<div class="tabbertab" title="Resources">
+
{{StudyCard|img=[[File:E-Paper_ESP32.jpg|110px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#ESP32.2F8266]]
=Resources=
+
|heading = Working with ESP32/8266
 
+
|content = User guides for ESP32/8266}}
==Documentation==
+
{{StudyCard
*[https://www.waveshare.com/w/upload/2/20/4.2inch-e-paper-module-b-user-manual-en.pdf User Manual]
+
|img=[[File:Resource0.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Resources]]
{{Commom Instruction of SPI e-paper}}
+
|heading = Resources
* [[:File:4.2inch_e-Paper_Schematic.pdf|Schematic]]
+
|content = Documentation, procedures and data sheets, etc
 
+
}}
==Demo code==
+
{{StudyCard
*[https://github.com/waveshare/e-Paper Github]
+
|img=[[File:FAQ01.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#FAQ]]
 
+
|heading = FAQ
==Datasheets==
+
|content = e-Paper frequently asked questions
* [[:File:4.2inch-e-paper-b-specification.pdf|Datasheets]]
+
}}
 
+
{{StudyCard
==Related Resources==
+
|img=[[File:support00.jpg|121px|link=https://www.waveshare.com/wiki/4.2inch_e-Paper_Module_(B)_Manual#Support]]
Notice:<br />
+
|heading = Support
The projects listed are all made and shared by the project owners, Waveshare isn't responsible for project either the update.<br />
+
|content = Technical support
*[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