Difference between revisions of "12.48inch e-Paper Module"
(→FAQ) |
|||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| + | <div class="wiki-pages jet-green-color"> | ||
{{infobox item| | {{infobox item| | ||
|name=12.48inch e-Paper | |name=12.48inch e-Paper | ||
| Line 31: | Line 32: | ||
==SPI Communication Timing== | ==SPI Communication Timing== | ||
| − | [[File:1.54inch-e-paper-manual-1.png| | + | [[File:1.54inch-e-paper-manual-1.png|thumb|right]] |
| − | |||
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. | 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 | *CS: Slave chip select, when CS is low, the chip is enabled | ||
| Line 39: | Line 39: | ||
*SDIN: SPI communication master sends, slave receives | *SDIN: SPI communication master sends, slave receives | ||
*Timing: CPHL=0, CPOL=0 (SPI0) | *Timing: CPHL=0, CPOL=0 (SPI0) | ||
| − | + | 【Remarks】For specific information about SPI, you can search for information online.<big><br/> | |
| + | If the display is misaligned or the partitions are out of sync, try reducing the SPI rate.<br/> | ||
==How e-Paper display== | ==How e-Paper display== | ||
| − | As we know, this display uses the SPI interface, however, there are two FPC cables. In fact, the 12.48inch e-Paper is combined | + | [[File:12.48inch e-paper-4part.png|thumb|right]] |
| + | As we know, this display uses the SPI interface, however, there are two FPC cables. In fact, the 12.48inch e-Paper is combined with four small e-Paper, therefore, to control the e-Paper, you should use four chip select pins.<br /> | ||
| − | * | + | *Refreshing Principle |
It works as below：<br /> | It works as below：<br /> | ||
| − | + | ||
We name the four areas as S2, M2, M1 and S1 respectively, in demo codes, we will send data to these four area in order.<br /> | We name the four areas as S2, M2, M1 and S1 respectively, in demo codes, we will send data to these four area in order.<br /> | ||
The resolution of S2 and M1 are same 648*492, and the resolution of M2 and S1 are the same 656*492.<br /> | The resolution of S2 and M1 are same 648*492, and the resolution of M2 and S1 are the same 656*492.<br /> | ||
Combine the four display we get the resolution of 12.48inch e-Paper: 1304*984<br /> | Combine the four display we get the resolution of 12.48inch e-Paper: 1304*984<br /> | ||
| − | + | [[File:12.48inch e-paper-4part2.png|thumb|right]] | |
| − | *Control | + | *How to Control |
They are four display indeed, therefore, we need to control four SPI salves：<br /> | They are four display indeed, therefore, we need to control four SPI salves：<br /> | ||
Generally, the control pins of e-Paper are MOSI, SCLK, CS and DC<br /> | Generally, the control pins of e-Paper are MOSI, SCLK, CS and DC<br /> | ||
| Line 58: | Line 60: | ||
To reduce pins, four displays use the same VCC, GND, MOSI and SCK pins. Every two displays use the same DC and RST pins.<br /> | To reduce pins, four displays use the same VCC, GND, MOSI and SCK pins. Every two displays use the same DC and RST pins.<br /> | ||
Therefore, there are total 16 pins for controlling the e-Paper:<br /> | Therefore, there are total 16 pins for controlling the e-Paper:<br /> | ||
| − | + | ||
*Codes analysis | *Codes analysis | ||
| Line 123: | Line 125: | ||
*[https://www.waveshare.com/w/upload/9/9a/12.48inch_e-Paper_Module_Code_RPI.7z Demo codes (Pi)] | *[https://www.waveshare.com/w/upload/9/9a/12.48inch_e-Paper_Module_Code_RPI.7z Demo codes (Pi)] | ||
*[https://github.com/waveshare/12.48inch-e-paper Github] | *[https://github.com/waveshare/12.48inch-e-paper Github] | ||
| − | + | ==Software== | |
| + | *[https://{{SERVERNAME}}/w/upload/3/36/Image2Lcd.7z Image2Lcd] | ||
| + | *[https://{{SERVERNAME}}/w/upload/c/c6/Zimo221.7z Font extraction software] | ||
===Datasheet=== | ===Datasheet=== | ||
*[https://www.waveshare.com/w/upload/f/f0/12.48inch_e-paper_Datasheet.pdf 12.48inch e-Paper datasheet] | *[https://www.waveshare.com/w/upload/f/f0/12.48inch_e-paper_Datasheet.pdf 12.48inch e-Paper datasheet] | ||
| Line 133: | Line 137: | ||
{{e-paper Hat FAQ}} | {{e-paper Hat FAQ}} | ||
| − | + | ||
{{Service00}} | {{Service00}} | ||
Latest revision as of 10:16, 15 June 2022
| ||
| ||
Introduction
Feature
- Dimension： 12.48inch
- Outline dimension (raw panel)：261.5mm × 211mm × 0.3mm
- Outline dimension (Acrylic case)：280mm x 229.5mm
- Display size：252.976mm × 190.896mm
- Working voltage：3.3V/5V
- Interface：SPI
- Dot pitch：0.194mm × 0.194mm
- Resolution：1304 x 984
- Display color：Black, white
- Grey level：2
- Full refresh time ：8s
- Refresh power ： 26.4mW(typ.)
- Standby current ：<0.01uA (almost none)
【Note】：
Refresh time：The data provided is experimental data, the actual time may be a little different.It is normal that the e-Paper blink when full updating.
Power：The power data is experimental data.
SPI Communication Timing
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.
If the display is misaligned or the partitions are out of sync, try reducing the SPI rate.
How e-Paper display
As we know, this display uses the SPI interface, however, there are two FPC cables. In fact, the 12.48inch e-Paper is combined with four small e-Paper, therefore, to control the e-Paper, you should use four chip select pins.
- Refreshing Principle
It works as below：
We name the four areas as S2, M2, M1 and S1 respectively, in demo codes, we will send data to these four area in order.
The resolution of S2 and M1 are same 648*492, and the resolution of M2 and S1 are the same 656*492.
Combine the four display we get the resolution of 12.48inch e-Paper: 1304*984
- How to Control
They are four display indeed, therefore, we need to control four SPI salves：
Generally, the control pins of e-Paper are MOSI, SCLK, CS and DC
And power and reset pins: VCC, GND, RST
Because e-Paper will flash when updating, there is a busy pin：BUSY
To reduce pins, four displays use the same VCC, GND, MOSI and SCK pins. Every two displays use the same DC and RST pins.
Therefore, there are total 16 pins for controlling the e-Paper:
- Codes analysis
To control the e-Paper, you should first reset and initialize registers. And then transmit image data to e-Paper and update.
Here we show you how to transmit the image data：
We take Black-white or Red-white image as a monochrome bitmap. One byte stands for 8 pixels.
S2 and M1: There are 648 pixels per raw, It needs 648/8 = 81 bytes. One display has 492 column,totally have 81 * 492 = 39852 bytes. The same as the M2 and S1: They totally have 40344 per display。
Registers 0x13 and 0x10 are used to control Black-white image data and Red image data transmitting, here we take two-color display as example
| Color | 0x10 | 0x13 |
| White | 0xFF | 0x00 |
| Black | 0x00 | 0x00 |
| Red | 0xFF/0x00 | 0xFF |
void EPD_12in48_Display(const UBYTE *Image)
{
int x,y;
//S1 part 648*492
EPD_S2_SendCommand(0x13);
for(y = 0; y < 492; y++)
for(x = 0; x < 81; x++) {
EPD_S2_SendData(*(Image + (y*163 + x)));
}
//M2 part 656*492
EPD_M2_SendCommand(0x13);
for(y = 0; y < 492; y++)
for(x = 81; x < 163; x++) {
EPD_M2_SendData(*(Image+ (y*163) +x));
}
//S1 part 656*492
EPD_S1_SendCommand(0x13);
for(y = 492; y < 984; y++)
for(x = 81; x < 163; x++) {
EPD_S1_SendData(*(Image+ (y*163) +x));
}
//M1 part 648*492
EPD_M1_SendCommand(0x13);
for(y = 492; y < 984; y++)
for(x = 0; x < 81; x++) {
EPD_M1_SendData(*(Image+ (y*163) +x));
}
EPD_12in48_TurnOnDisplay();
}
We provide demo codes for four popular hardware platforms, Raspberry Pi, Arduino UNO, STM32 and the ESP32. The product you receive may be pre-assembled, you need to remove the back panel and connect your device like Raspberry Pi.
Preface
How to Install
Since it was assembled by us when you got the product, it has a bottom plate, you need to take the screwdriver delivered to unscrew the screws on the back and put it into the main control.
- The Raspberry Pi, Arduino UNO, and ESP32 directly provide interface connections, and the specific control pins are introduced in the following sections.
- For STM32, the demo is based on the STM32F103ZET6 chip, which was tested using our Open103Z, and connected using the pin headers of the board.
Software Description
Raspberry Pi Programs
We provide two program drivers, C and Python
It takes about 8S to brush a frame of a picture in C language, and about 10S in python. In addition to the basic brushing effect, python also adds the ability to crawl the weather:
- For the foreign version, we use weather data crawled from https://www.msn.com/en-us/Weather/?day=1 webpage.
Arduino UNO
We provide a C program, and the .c suffix is changed to .cpp to be compatible with CPP.
Because the RAM of UNO is too small, 3 23LC1024 chips are used onboard to expand the memory of UNO. You need to build a picture of the whole picture and initialize it. For black and white pictures, you need 1304/8*984=160392 pieces Bytes, and a 23LC1024 can only have a maximum size of 128K. For black and white red, it needs 160392*2 = 320784 bytes, so 3 chips are needed, so the display speed of the whole frame picture is very slow, about 1 minute. to display a black and white image.
- The jumper cap needs to be connected to 5V.
STM32
We provide a C program
- Since STM32F103ZET6 has no interface for direct use, it needs to be connected with the delivered Dupont cable. For the specific connection method, please refer to the pin connection diagram below. There are only some examples here, because the STM32F103ZET6 cannot establish a complete image cache, only part of the screen routines.
ESP32
We provide a C program for the Arduino test program and an example that can be controlled using the web page
- Arduino: It can be used according to the corresponding ESP32 chapters. ESP32 cannot create a 1304/8*984 cache, so it is refreshed in a different way, 4304/8*492 data is transmitted at one time, and black and white needs to be transmitted twice. Black and white red transmission 4 times. The refresh speed of black and white is about 8S, and the refresh speed of black and white is about 16S.
- Web page control: Due to my limited skills, I develop web pages while learning the front-end. There may be some bugs in web page control, and you may not be able to complain, but the function can be completed in the end. The IP address will be displayed on the serial port. Under the same wifi, you can use the web page to open the IP address to control it, which will be described in detail in the subsequent chapters.
Raspberry Pi
Hardware connection
The pins used can be found on schematic according to codes
Enable SPI interface
Open terminal and type command
sudo raspi-config
Choose Interfacing Options -> SPI -> Yes. Then reboot the Raspberry Pi
sudo reboot
Libraries installation
- Install BCM2835
wget http://www.airspayce.com/mikem/bcm2835/bcm2835-1.68.tar.gz tar zxvf bcm2835-1.71.tar.gz cd bcm2835-1.71/ sudo ./configure && sudo make && sudo make check && sudo make install
- Install wiringPi
#Open the Raspberry Pi terminal and run the following command sudo apt-get install wiringpi #For Raspberry Pi systems after May 2019 (earlier than before, you may not need to execute), you may need to upgrade: wget https://project-downloads.drogon.net/wiringpi-latest.deb sudo dpkg -i wiringpi-latest.deb gpio -v # Run gpio -v and version 2.52 will appear. If it does not appear, the installation is wrong #Bullseye branch system use the following command: git clone https://github.com/WiringPi/WiringPi cd WiringPi ./build gpio -v # Run gpio -v and version 2.60 will appear. If it does not appear, it means that there is an installation error
- Install python2
sudo apt-get update sudo apt-get install python-pip sudo apt-get install python-pil sudo pip install RPi.GPIO sudo pip install spidev
- Install python3
sudo apt-get update sudo apt-get install python3-pip sudo apt-get install python3-pil sudo pip3 install RPi.GPIO sudo pip3 install spidev
Download
Open terminal and run commands to download codes
sudo apt-get install p7zip-full wget http://www.waveshare.net/w/upload/9/9a/12.48inch_e-Paper_Module_Code_RPI.7z 7z x 12.48inch_e-Paper_Module_Code_RPI.7z -r -o./12.48inch_e-Paper_Module_Code sudo chmod 777 -R 12.48inch_e-Paper_Module_Code cd 12.48inch_e-Paper_Module_Code
Run codes
- C codes
cd c sudo nano examples/main.c
- Confirm that which kind of 12.48inch e-Paper do you use. If you use the two-color display, modify the file as below
- If you use the tree-color display, modify the file as below
- Save then compile and run the code
sudo make clean sudo make sudo ./epd
- Python codes
- Open terminal and run the demo codes by commands:
cd python/examples
- For two-color version
sudo python epd_12in48_test.py
- For three-color version
sudo python epd_12in48B_test.py
- Python codes-Weather
cd python/examples
- For two-color display
sudo python Show_EN_Weather.py
- For three-color display
sudo python Show_EN_Weather.py B
- For help information
sudo python Show_EN_Weather.py help
Arduino
Hardware connection
You can directly insert the Arduino UNO to PCB
About the pins used:
Run codes
- Download demo codes from wiki and unzio it.
- Copy the 12in48 folder to the libraries directory which is under the installation directory of Arduino IDE.(The installation directory generally is C:\Program Files (x86)\Arduino\libraries)
- Open Ardunin IDE software, choose Tool->Board->Arduino UNO:
- Click File -> Examples -> EPD12in48 to opem demo cods
- If your e-Paper is two-color version, use the epd12in48-demo, otherwise, use the epd12in48b-demo
- Compile and download the codes to board
If you are using a black and white screen, select epd12in48-demo on the right
If you are using a black and white red screen, select epd12in48b-demo on the right
Finally, select the corresponding COM port, and then click Compile and Download.
- Note that the refresh process may take a long time. You can open the serial monitor to check the progress. Generally, it takes 1 minute for black and white, and 2 minutes for black and white.
STM32
The development board we use is Waveshare Open103Z. The project is developed based on STM32 HAL libraries.
Hardware connection
To assemble the Open32, you should connect it by wires provided.
About the pins used, you can refer to e-paper.ioc file.
Run codes
Open the project (~\STM32\NUCLEO-F103RB\MDK-ARM\e-paper.uvprojx), compile and download to developmen board. It requires about 10s for the two-color version and 20s for three-color display.
ESP32
The demo codes for ESP32 are developed with Arduino IDE as well.
Software setup
To develop ESP32, you should first set up the environment.
- Download the newest Arduino IDE from Arduino website: https://www.arduino.cc/en/Main/Software
- Download ESP32 pack from github: https://github.com/espressif/arduino-esp32/archive/master.zip . Unzip the achieve to [Arduino IDE installation direcotry]/Hardare/espressif/esp32 directory. (If you didn't find the path under the installation directory, please create the folders manually)
- Enter the tools folder, and run the get.exe file as administrator. After installing, Copy the esp32-epd-12in48 folder of ESP32 demo codes to [Arduino IDE installation directory]/Hardware/espressif/esp32/libraries
Hardware connection
Here we use Waveshare e-Paper ESP32 Driver Board as an example. Attach it on PCB.
About the pins used, you can refer to schematic and codes
Examples 1
Open Arduino IDE software, and find the examples on File->Examples
If you use two-color e-Paper, choose the epd12in48-demo, otherwise, use the epd12in48B-demo
WiFi example
As we know, ESP32 features WIFI, you can set it as master or slave. Here we provide demo codes that control the e-Paper on the web by WIFI.
- You need to first modify the wifi connection information. Open the Web_App.cpp file and modify the line 50 and line 51:
：
- Open wifi.ino file, compile and download it to your ESP32 board. Open Serial monitor to query the IP address
- Open the Chrome browser, and enter the web with the IP address
- Select the display type, here we take 12.48inch e-Paper (two-color version) as example:
- Click 12.48 e-Paper, and there are six functions provided. You can use them to draw points, lines and so on. On the top of the webpage, the type of e-Paper and display color are shown.
- The corresponding coordination of display is as below.
- Draw points
- Click Draw point then you will get the window as below.
- Draw lines
- Click Draw Line, you will get the window as below
- Draw Rectangle
- Click Draw Rectangle, you will get the window as below
- Draw circle
- Click Draw Circle, you will get the window as below
- Draw String
- Click Draw String, you will get the windows as below
- Display picture
- Click Show picture, you will get the window like below. Click upload image to choose a picture.
- Draw the page to bottom to check the original picture.
- Select a process algorithm, for two-color display, only the mono methods work.
- Finally, click the upload image button on left to upload image to e-Paper for displaying.
- You can open the Serial monitor of IDE to check the debug information
- You can also press F12 button to open the debug console of browser
Resources
Document
Demo codes
Software
Datasheet
Third-Party examples
- It is a "ESP-IDF component", you can drive the e-Paper with GFX and Fonts.
FAQ
Question about Software
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
1. First check whether the wiring is correct
2. Check whether the spi is turned on and whether the parameters are configured correctly (spi baud rate, spi mode and other parameters)
{{{5}}}
Question about Hardware
{{{5}}}
Device selection can use the model in the schematic diagram we provide or choose according to the data sheet.
{{{5}}}
{{{5}}}
Confirm whether the BUSY pin is normally initialized to input mode
It may be that there is no normal reset, try to shorten the duration of the low level during reset (because the power-off switch is added to the drive circuit, the reset low level is too long, which will cause the drive board to power off and cause the reset to fail)
If the busy function sends the 0x71 command, you can try to comment it out
{{{5}}}
Question about Screen
- 【Storage conditions】: Temperature range: below 30°C; Humidity range: below 55%RH; Maximum storage time: 6 months
- 【Transportation conditions】: Temperature range: -25~70°C; Maximum transportation time: 10 days
- 【After unpacking】: Temperature range: 20°C±5°C; Humidity range: 50±5%RH; Maximum storage time: Assemble within 72 hours
{{{5}}}
- Full brush: The electronic ink screen will flicker several times during the refresh process (the number of flickers depends on the refresh time), and the flicker is to remove the afterimage to achieve the best display effect
- Bureau brush: The electronic ink screen has no flickering effect during the refresh process. Users who use the partial brushing function note that after refreshing several times, a full brush operation should be performed to remove the residual image, otherwise the residual image problem will become more and more serious, or even damage the screen (currently only some black and white e-ink screens support partial brushing, please refer to product page description)
- refresh rate
- During use, it is recommended that customers set the refresh interval of the e-ink screen to at least 180 seconds (except products that support the local brush function)
- During the standby process (that is, after the refresh operation), it is recommended that the customer set the e-ink screen to sleep mode, or power off operation (the power supply part of the ink screen can be disconnected with an analog switch) to reduce power consumption and prolong the life of the e-ink screen. (If some e-ink screens are powered on for a long time, the screen will be damaged beyond repair.)
- During the use of the three-color e-ink screen, it is recommended that customers update the display screen at least once every 24 hours (if the screen remains the same screen for a long time, the screen burn will be difficult to repair)
- Full brush: The electronic ink screen will flicker several times during the refresh process (the number of flickers depends on the refresh time), and the flicker is to remove the afterimage to achieve the best display effect
- Application
- The e-ink screen is recommended for indoor use. If it is used outdoors, it is necessary to avoid direct sunlight on the e-ink screen, and at the same time, take UV protection measures, because charged particles will dry out under strong light for a long time, resulting in loss of activity and failure to refresh. This situation is irreversible. When designing e-ink screen products, customers should pay attention to determine whether the use environment meets the requirements of e-ink screen
- The e-ink screen is recommended for indoor use. If it is used outdoors, it is necessary to avoid direct sunlight on the e-ink screen, and at the same time, take UV protection measures, because charged particles will dry out under strong light for a long time, resulting in loss of activity and failure to refresh. This situation is irreversible. When designing e-ink screen products, customers should pay attention to determine whether the use environment meets the requirements of e-ink screen
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
Insufficient or unstable power supply leads to data loss
The data cable is too long to cause data loss, the extension cable should not exceed 20cm
{{{5}}}
Different batches of e-paper diaphragms and electrophoretic matrices require different voltage values when driving the display due to materials, manufacturing processes, etc. The waveform of the e-ink screen is reflected in the relationship between grayscale, voltage and temperature. Generally speaking, after each batch of electrophoresis matrix is generated, there will be a corresponding waveform file in the form of a .wbf file. The film manufacturer will provide the waveform file and electrophoresis matrix to the manufacturer of the electronic paper screen, and then the The manufacturer of electronic paper screen integrates the protection board, substrate and driver and then provides it to customers; if the waveform file does not correspond to the screen, it is likely that the display cannot be displayed or the display effect is unsatisfactory. Generally, the waveform file has OTP built into the driver IC of the ink screen when leaving the factory, and some programs we provide also call external waveform files to drive the e-ink screen.
{{{5}}}
{{{5}}}
One is to brush the background image first
The other is to alternately refresh old data and new data
{{{5}}}
{{{5}}}
{{{5}}}
Others
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
{{{5}}}
Support
If you require technical support, please go to the Support page and open a tickets.