From Waveshare Wiki
Jump to: navigation, search
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Infobox item
|name=5.83inch e-Paper (B)
|name2=5.83inch e-Paper HAT (B)
<div style="background-color: #343434;text-align: center;color: white;padding: 20px;margin: 8px;">
|img=[[File:5.83inch-e-Paper-B-1.jpg|300px|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=}}]]
=5.83inch e-Paper HAT (B) Manual=
|img2=[[File:5.83inch-e-Paper-HAT-B-2.JPG|300px|{{Amazon_nolink|default={{#ifeq: {{#urlget:amazon|0}}|{{#urlget:Amazon|0}}| default|}}|url=link=}}]]
|caption=648x480, 5.83inch EPD panel, B/W/R
|caption2=648x480, 5.83inch EPD HAT for Raspberry Pi, SPI interface, B/W/R
|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">
The product has been updated to the V2 and supports 648x480 resolution (the V1 resolution is 600x448). The hardware structure and interface of the V2 are compatible with the V1, but the software needs to be updated
*Dimension: 5.83inch
*Outline Dimension (Raw panel): 125.40mm x 99.50mm x 1.18mm
|content =
*Outline Dimension (Driver board): 65mm x 30.2mm
*Display Size: 119.232(H) x 88.320(V) (V1:118.80mm x 88.26mm)
*Operating Voltage: 3.3V/5V
*Interface: SPI
*Dot Pitch: 0.184 x 0.184 (V1:0.198 x 0.197)
*Resolution: 648(H) x 480(V) (V1:600 x 448)
*Display Color: Black, White, Red
*Grey level: 2
*Full Refresh Time: 20s (V1:14s)
*Refresh Power: 26.4mW(Typ.)
*Standby Current: <0.01uA (almost none)
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==
|heading = Introduction
|content = Parameters, principles, and precautions
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
|heading = Start with Raspberry Pi
*SCLK: SPI communication clock
|content = Using BCM2835, WiringPi, file IO, RPI (Python) library development routines and instructions
*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 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 />
|heading = Start with the Jetson Nano
|content = Use C language, Python developed routines and instructions
Black and white processing of 5.83inch e-paper<br />
Because of the problem of the controller, it defines 0000b to indicate that the corresponding pixel is black, and 0011b to indicate that the corresponding pixel is white, which is 4bit = 1pixel, and the lower two bits of the 4bit are both 0 to display black. On the contrary, the lowest two bits of 4bit can be 1 at the same time. Display white, other data will cause the color of the pixel to be uncertain;<br />
|heading = Starting from the STM32
0x00: 2 pixels ■■
|content = Use STM32CubeMX to develop routines based on STM32F103ZET6 and their usage instructions
0x03: 2 pixels ■□
0x30: 2 pixels □■
0x33: 2 pixels
Taking 4 pixels as an example, we assume that the first 2 pixels are black and the last 2 pixels are white, then the logic of people is like this, which is stored in sequence<br />
For a computer, its data storage method is high-order first, low-order last, and a byte has only 8 bits, so it is stored in a byte like this<br />
[[File:06.png]]<br />
|img=[[File:Tinker Board 2硬件-test1.png|121px|link=]]
|heading = Starting from the Arduino
|content = Routines developed based on Arduino UNO R3 and their usage instructions
*5.83inch e-paper B three-color processing<br />
As explained earlier, other three-color screens are controlled by 2 registers, and this one is controlled by only 1 register. It still needs to transmit two pictures, one black and white and one red and white, and then the display will superimpose the two pictures.<br />
The above explains the black and white processing of 5.83-inch and 7.5-inch. If you are careful, you will find why the upper two bits of 4bit are not used. We use these two bits to represent red or yellow.<br />
|heading = Resources
Then we use two digits to represent:<br />
|content = Documentation, procedures and data sheets, etc
00b: white
01b: red
The upper two digits represent red, and the lower two digits represent black. If the dot is red, black will not be displayed, and the value of the lower two digits will be ignored, so the ink screen has the following definitions:<br />
0000b: black, the actual value is 0x0
0100b: red, the actual value is 0x4
0111b: red, the actual value is 0x4
0011b: white, the actual value is 0x3
The processing of a monochrome image is to save 1 pixel in 1bit, so 8 points of color are stored in one byte, but the above processing does 4bit represent a pixel:<br />
In order to facilitate understanding, assuming that there are 8 pixels, then displaying 8 pixels requires 8 pixels in red and white and 8 pixels in black and white, because 1 point is superimposed by two pixels, 8 Pixels are stored in 1 byte, and red and white and black and white occupy two bytes each. A 1 in a red-and-white picture indicates red, a 0 indicates white, a 0 in a black-and-white picture indicates black, and a 1 indicates white.<br />
[[File:07.png]]<br />
As mentioned above, for the data transmitted to the ink screen, 1 pixel needs to occupy 4 bytes, so the data of 8 points needs to be processed into 4 bytes to send:<br />
[[File:08.png]]<br />
|heading = FAQ
|content = e-Paper frequently asked questions
Because red has a high priority, the first four pixels are all red after superposition.<br />
|heading = Support
|content = Technical support
#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 class="tabbertab" title="User Guides of Jetson Nano">
{{Jetson Nano Guides for SPI e-Paper}}
<div class="tabbertab" title="User Guides of STM32">
{{STM32 Guides for SPI e-Paper}}
<div class="tabbertab" title="User Guides of Arduino">
{{Arduino Guides for SPI e-Paper}}
<div class="tabbertab" title="Resources">
* [ User Manual]
{{Commom Instruction of SPI e-paper}}
* [[:File:E-Paper-Driver-HAT-Schematic.pdf|Schematic]]
==Demo code==
*[ Github]
*[[:File:5.83inch e-Paper b Specification.pdf|Datasheet]]
*[ 5.83inch e-Paper (B) V2 Specification]
==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 />
*[ 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.
*[ Inkycal Project]
:This is the Inkycal project for reference.
==Related Products==
{{Product List|OLEDs / LCDs/e-Paper}}
<div class="tabbertab" title="FAQ">
{{e-paper Hat FAQ}}

Latest revision as of 10:23, 21 July 2022

5.83inch e-Paper HAT (B) Manual



Parameters, principles, and precautions

Start with Raspberry Pi

Using BCM2835, WiringPi, file IO, RPI (Python) library development routines and instructions

Start with the Jetson Nano

Use C language, Python developed routines and instructions

Starting from the STM32

Use STM32CubeMX to develop routines based on STM32F103ZET6 and their usage instructions
Tinker Board 2硬件-test1.png

Starting from the Arduino

Routines developed based on Arduino UNO R3 and their usage instructions


Documentation, procedures and data sheets, etc


e-Paper frequently asked questions


Technical support