2.7inch E Paper Hat User Manual En
2.7inch_e-paper_hat_user_manual_en
User Manual:
Open the PDF directly: View PDF 
.
Page Count: 25
| Download | |
| Open PDF In Browser | View PDF |
2.7inch e-Paper HAT User Manual 2.7inch e-Paper HAT User Manual Version Data Description V1.0 2017.05.17 Factory V2.0 2018.12.05 Notes 【Notes】 ⚫ Please read this manual before you use the e-Paper. Damage caused by wrong operations is not within the scope of the warranty ⚫ This manual shows you how to use the e-paper with the demo codes we provide. ⚫ The e-paper described in this manual is Module/HAT version. (Raw panel should work with driver board) ⚫ V2.0 All specification supplied herein are subject to change without notice at any time. 1 / 25 2.7inch e-Paper HAT User Manual CONTENT Type Description ....................................................................................................................................... 4 Notes ............................................................................................................................................................. 5 Overview....................................................................................................................................................... 7 Specification ....................................................................................................................................... 7 Interfaces ............................................................................................................................................. 8 Working Principle ...................................................................................................................................... 9 4-wire SPI ............................................................................................................................................. 9 Demo codes .............................................................................................................................................. 11 Download .......................................................................................................................................... 11 Raspberry Pi ...................................................................................................................................... 12 Hardware connection ............................................................................................................ 12 Copy examples to Raspberry Pi......................................................................................... 12 Libraries Installation .............................................................................................................. 13 Running demo codes ............................................................................................................ 15 Expected result ........................................................................................................................ 16 Arduino ............................................................................................................................................... 17 Hardware connection ............................................................................................................ 17 Running examples .................................................................................................................. 17 Expected result ........................................................................................................................ 18 STM32 ................................................................................................................................................. 19 Hardware connection ............................................................................................................ 19 V2.0 2 / 25 2.7inch e-Paper HAT User Manual Running example .................................................................................................................... 19 Expected result ........................................................................................................................ 19 Codes Description .......................................................................................................................... 20 Version ....................................................................................................................................... 20 C codes ....................................................................................................................................... 20 Python codes ........................................................................................................................... 23 Image Data Array .................................................................................................................................... 25 V2.0 3 / 25 2.7inch e-Paper HAT User Manual TYPE DESCRIPTION Generally, there are two version for every type of e-paper, one is raw panel, and another is Module/HAT version. Raw panel should work with driver board, if you are the first time to use Waveshare e-Paper, we recommend you the Module/HAT version or purchase a driver board separately. Module/HAT version has PCB which integrates driver circuit. You can connect 8Pin connector to MCU directly. Raw Panel (2.7inch e-Paper): Module Version (2.7inch e-Paper HAT): V2.0 4 / 25 2.7inch e-Paper HAT User Manual NOTES 1. For those e-Paper which support partial refresh, you cannot use partial refresh all the time. A full refresh should be done to clear screen after several times(partial refresh), otherwise, e-Paper will be damaged and cannot fixed. 2. Three-color e-Paper is normal to be a little ‘color’ . You can refresh it to white and keep it upward for storage. 3. The e-Paper cannot be powered on for long time, you must set e-Paper to sleep mode or power off when it needn’t refresh, otherwise, e-Paper keeps in high voltage status for long time, which will damage e-Paper and cannot be fixed. 4. We suggest you update e-Paper once every 24 hours or at least 10 days 1 to update again. Otherwise, ghost of the last content may cannot be cleared. 5. e-Paper ignores the data sent when it is in sleep mode, you need to initialize it for properly refreshing. 6. You can adjust border color by controlling 0x3C register. In some of demo codes, you can adjust Border Waveform Control or VCOM AND DATA INERTVAL SETTING registers. 7. If you find that the image data you made cannot be properly displayed on ePaper, please check the size of image, or change its width and height and try again. 1 For details of operating requirement, please refer to datasheet V2.0 5 / 25 2.7inch e-Paper HAT User Manual 8. The e-Paper cannot refresh directly under sunlight2. The refresh steps should be done indoor 9. For raw panel, its working voltage is 3.3V, note that when you designed you own driver board, level convert circuit is required if the working voltage of your board is 5V. Module/HAT version can support 5V voltage if the Module you buy is the new version which has been integrated convert circuit. 10. The FPC of the panel is fragile, please make sure that your bend it in correct way. 11. The glass raw panel is fragile, please do not falling, crashing or pressing hard. 12. We recommend you test the e-Paper with our demo code when you first time receive it. 2 e-Paper don’t have UV film, cannot work under sunlight directly V2.0 6 / 25 2.7inch e-Paper HAT User Manual OVERVIEW This is an E-Ink display module, 2.7inch, 264x176 resolution, with embedded ⚫ controller, communicating via SPI interface. Due to the advantages like ultra-low power consumption, wide viewing angle, ⚫ clear display without electricity, it is an ideal choice for applications such as shelf label, industrial instrument, and so on. We provide demo codes for you (Arduino, Raspberry Pi and STM32) ⚫ SPECIFICATION ⚫ Operating Voltage: 3.3V/5V3 ⚫ Working Temperature: 0~50°C ⚫ Interface: 3-wire SPI/4-wire SPI ⚫ Dimension: ◼ PCB: 85mm × 56mm ◼ Raw Panel: 70.42mm × 45.8mm ⚫ Display area: 57.288mm × 38.192mm ⚫ Dot pitch: 0.217 × 0.217 ⚫ Resolution: 264 × 176 ⚫ Display color: Black, White ⚫ Refresh time4: ◼ Full refresh: 6s 3 The voltage of every pins should be same 3.3V or 5V 4 These are experimental data; actual data may be different according to working situation V2.0 7 / 25 2.7inch e-Paper HAT User Manual Consumption5: ⚫ ◼ Refresh consumption: 26.4mW(typ.) ◼ Standby consumption: <0.017mW Viewing angle: >170° ⚫ INTERFACES 5 VCC ：3.3V/5V GND ：GND DIN ：SPI MOSI pin CLK ：SPI SCK pin CS ：SPI chip selection, low active DC ：Data/Command Selection（High: Data; Low: Command） RST ：Reset（Low active） BUSY ：Busy（Low active） These are experimental data; actual data may be different according to working situation V2.0 8 / 25 2.7inch e-Paper HAT User Manual 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 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 sunshine, the E-paper screen still has high visibility with a wide viewing angle of 180 degree. It is the ideal choice for E-reading. 4-WIRE SPI Different from the traditional SPI protocol 6, 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. ⚫ 6 You can search online for more information about traditional SPI protocol V2.0 9 / 25 2.7inch e-Paper HAT User 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. 1. 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. 2. 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. V2.0 10 / 25 2.7inch e-Paper HAT User Manual DEMO CODES DOWNLOAD Please visit Waveshare Wiki, search with key words “1.54inch e-Paper module. Download the demo code from wiki, Extract it and you can get these folders: Arduino7: Demo code for Arduino UNO; RaspberryPi: Demo codes for Raspberry Pi. (BCM2835, wiringPi and python) STM32: Demo code for STM32, control board is STM32F103ZET6 7 If you use other Arduino board, you should check if it is compatible with Arduino Uno, or modification is required. V2.0 11 / 25 2.7inch e-Paper HAT User Manual RASPBERRY PI There are four examples for Raspberry Pi, bcm2835, wiringPi, python2 and python3. HARDWARE CONNECTION Raspberry Pi e-Paper BCM2835 No. Board No. 3.3V 3.3V 3.3V GND GND GND DIN MOSI 19 CLK SCLK 23 CS CE0 24 DC 25 22 RST 17 11 BUSY 24 18 COPY EXAMPLES TO RASP BERRY PI 1. Insert SD card which has Raspbian installed to your PC V2.0 12 / 25 2.7inch e-Paper HAT User Manual 2. Copy RaspberryPi extracted to root directory (BOOT) of SD card 3. Power on your Raspberry Pi and open Terminal, you can find that the examples is listed in boot directory 4. Copy the RaspberryPi folder to /home/pi and change its execute permission. sudo cp -r /boot/RaspberryPi/ ./ sudo chmod 777 -R RaspberryPi/ LIBRARIES INSTALLATION To use demo codes, libraries should be installed first. BCM2835 LIBRARY Download link of the bcm2835 library: http://www.airspayce.com/mikem/bcm2835/ Download the library and copy it to raspberry pi without extracting. Open terminal of raspberry pi and install: V2.0 13 / 25 2.7inch e-Paper HAT User Manual sudo tar zxvf bcm2835-1.xx.tar.gz cd bcm2835-1.xx sudo ./configure make sudo make check sudo make install Note: xx is version of the library you download. For example, if the version is bcm2835-1.52, you should complete the command to: sudo tar zxvf bcm28351.52.tar.gz WIRINGPI LIBRARY Open Terminal and install wiringPi with commands below: sudo apt-get install git sudo git clone git://git.drogon.net/wiringPi cd wiringPi sudo ./build PYTHON2 LIBRARY Open Terminal and execute commands to install: sudo apt-get install python-pip sudo apt-get install python-pip sudo apt-get install python-imaging sudo pip install spidev V2.0 14 / 25 2.7inch e-Paper HAT User Manual sudo pip install RPi.GPIO PYTHON3 LIBRARY Open Terminal and install library with commands: sudo apt-get install python3-pip sudo apt-get install python-imaging sudo pip3 install spidev sudo pip3 install RPi.GPIO sudo pip3 install Pillow If you get the error while installing Pillow: ImportError: libopenjp2.so.7: cannot open shared object file: No such file or directory. Please install libopenjp2-7-dev with the command: sudo apt-get install libopenjp2-7-dev then try again. RUNNING DEMO CODES Enter folder of examples Running bcm2835 example: cd ~/RaspberryPi/bcm2835 #enter the example directory make #compile codes sudo ./epd #running Running wiringPi example: cd ~/RaspberryPi/wiringpi #enter the example directory make #Compile sudo ./epd #running V2.0 15 / 25 2.7inch e-Paper HAT User Manual Running python2 example: cd ~/RaspberryPi/python2 #enter example directory sudo python main.py #running Running python3 example: cd ~/RaspberryPi/python3 #enter example directory sudo python3 main.py #running EXPECTED RESULT After running example: 1) The screen is refresh to white 2) Display a picture 3) Draw circles and lines, text is displayed You can press ctrl and c at the same time to stop code. V2.0 16 / 25 2.7inch e-Paper HAT User Manual ARDUINO Note: If the driver board you bought is e-Paper shield, you can use the demo codes provided for e-Paper shield separately which can be downloaded in corresponding wiki. HARDWARE CONNECTION If you use other Arduino board instead of Arduino UNO, you should check if its interfaces are compatible with UNO. e-Paper Arduino UNO 3.3V 3V3 GND GND DIN D11 CLK D13 CS D10 DC D9 RST D8 BUSY D7 RUNNING EXAMPLES 1. Make sure you have installed Arduino IDE in your PC 2. Open Arduino project 3. Select correct Board and Port 4. Compile and upload to Arduino board V2.0 17 / 25 2.7inch e-Paper HAT User Manual EXPECTED RESULT 1) e-Paper is refreshed to white 2) Draw circles and lines, text is displayed V2.0 18 / 25 2.7inch e-Paper HAT User Manual STM32 The development board used is Open103z, project is based on HAL library. HARDWARE CONNECTION e-Paper Open103Z 3.3V 3V3 GND GND DIN PA7 CLK PA5 CS PA4 DC PA2 RST PA1 BUSY PA3 RUNNING EXAMPLE 1. Open STM32 project with keil V5 2. Compile and download the demo code to STM32 board EXPECTED RESULT 1) e-paper is refreshed to white 2) Display a picture 3) Draw circles and lines, display characters V2.0 19 / 25 2.7inch e-Paper HAT User Manual CODES DESCRIPTION VERSION The newest deme codes are V2.0 version, updated functions: 1) read pictures 2) python3 examples 3) update display function 4) fix bug that e-Paper cannot enter sleep mode C CODES Take bcm2835 codes as example: 1. Initialize pins and SPI interface: DEV_ModuleInit（）； 2. Initialize e-Paper and clear it: 3. Create an image buffer Create an image buffer and set its size as: Imagesize = EPD width/8 * EPD height. V2.0 20 / 25 2.7inch e-Paper HAT User Manual Paint_newImage: Create a paint for new image, parameter 1 is image buffer, parameter 2 and 3 is width and height of image, parameter 4 is color if image Paint_SelectImage: Select image 4. Read image and display Paint_SelectImage: Select image; Paint_Clear(WHITE): Set image color to white GUI_ReadBmp: read bmp for certain path. Parameter 1: the address of BMP picture locates, Parameter 2 and 3 is the display position x and y of BCM display. Note that if the picture read is bigger than the image buffer, the rest part cannot be displayed. EPD_Display: Send image data to e-paper and display 5. Read image data from array V2.0 21 / 25 2.7inch e-Paper HAT User Manual Paint_DrawBitBmp: send image data to e-paper. Because STM32 and Arduino cannot read picture directly, we need to first convert picture to data on PC 6. Drawing point, lines, rectangles, circles and characters Paint_DrawPoint: Drawing points, parameter 1 and 2 are position of the point, parameter 3 are color, parameter 4 are size, parameter 5 are style Paint_DrawLine: Drawing line, parameter 1 and 2 are begin position of line, parameter 3 and 4 are end position of line, parameter 5 is color, parameter 6 is style, parameter 7 is width of line Paint_DrawRectangle: Drawing rectangle, parameter 1 and 2 are begin position of rectangle, parameter 3 and 4 are end position of rectangle, parameter 5 is fill color, parameter 6 and 7 are style Paint_DrawCircle: Drawing circle, parameter 1 and 2 are position of center, V2.0 22 / 25 2.7inch e-Paper HAT User Manual parameter 3 is radius of circle, parameter 4 and 5 are style Paint_DrawString_EN: Display English characters, parameter 1 and 2 are position, parameter 3 is string, parameter 4 is font size, parameter 5 and 6 are background and font colors Paint_DrawString_CN: Display Chinese characters Paint_DrawNum: Display number, parameter 1 and 2 are position, parameter is number (int), parameter 4 is size, parameter 5 and 6 are background and font colors. 7. Sleep mode: It is recommended to add after refreshing. PYTHON CODES 1. Initialize e-Paper 2. Create image buffer using python image library V2.0 23 / 25 2.7inch e-Paper HAT User Manual 3. Drawing with python imageDraw library 4. Read picture and display 5. Sleep mode sleep mode is recommended to add after refreshing V2.0 24 / 25 2.7inch e-Paper HAT User Manual IMAGE DATA ARRAY 1.54inch8 e-paper can only display black and white color. 1) Open a picture and set it as monochrome picture with Paint software of Windows 2) Resize the picture to supported resolution (according to e-paper) 3) Use Image2Lcd.exe software to convert picture to C array (.c file) Open the picture in Image2Lcd.exe, configure: Output file type: C array (*.c) Scan mode: Horizon Scan BitsPixel: monochrome Max Width and Height: 200 200 Check Reverse color and click Save t generate the array. Copy to demo code for using. 8 Here take 1.54inch as example to show you how to create image data array V2.0 25 / 25
Source Exif Data:
File Type : PDF File Type Extension : pdf MIME Type : application/pdf PDF Version : 1.7 Linearized : No Page Count : 25 Language : zh-CN Tagged PDF : Yes XMP Toolkit : 3.1-701 Producer : Microsoft® Word 2016 Creator : 小四 林 Creator Tool : Microsoft® Word 2016 Create Date : 2018:12:24 18:00:52+08:00 Modify Date : 2018:12:24 18:00:52+08:00 Document ID : uuid:BC21186C-87BF-4557-9D31-DA75951B9201 Instance ID : uuid:BC21186C-87BF-4557-9D31-DA75951B9201 Author : 小四 林EXIF Metadata provided by EXIF.tools