Revision as of 08:27, 5 September 2018

Introduction

This document will teach you how to use EPD-132R EVK to display image.

Preparation

EVK Components

2.4G Wi-Fi AP

Prepare a 2.4G Wi-Fi AP.

Win7 PC

Prepare a win7 PC.

Setup TFTP server

1. Make sure PC connect to 2.4G Wi-Fi AP and get IP address
2. Recommend used tftpd64
3. Set the process reference link  https://www.youtube.com/watch?v=YdVEonLMWYs

Python Environment Setup

1. Download and install Python (must use Python 2.7.x Windows x86)
2. Set the variables of Widows environment path: add “C:\Python27;C:\Python27\Scripts” to path  
3. Download and install python PIL package
4. Download and unzip picture transformation tool "BmpToPixel_EPD-132R.py"

Bmp Image To EPD Format

1. Run BmpToPixel_D73.py <source BMP image filename> <output filename> in cmd window
   • source BMP image filename: the image file to be converted
   • output filename: converted file name(recommend to use "esl" as the extension)
   • Bmp size must comply with EPD resolution 1600 x 1200
   • Bmp file: mono color/16 color/256 color/24bits bitmap format
   • Ex: BmpToPixel_D73.py EVK_03.bmp EVK_03.esl
2. Type BmpToPixel.bat to use batch conversion in directory
3. Copy output files to tftp Base Directory 

WISE-ED22 Setup

1. Download and install WISE-ED22 driver
2. Update WISE-ED22 FW for EPD-132 project.
3. Connected to PC via a micro USB cable, the Device  Manager will appear mbed Serial Port

EVK Setup

Hardware Setup

       Follow steps and picture below to setup the hardware

1. Connected EPD FPC to mainboard
2. Connected Wi-Fi antenna to mainboard
3. Connected ED22 board to mainboard via FFC cable
4. Connected ED22 board to PC via micro USB cable
5. Connected power cable to mainboard USB1(CN3)

Command Console Setting

Start a serial tool(use tera term in this), and make the communication setting as shown below.

EVK Start

Press “RST” button, the screen will show as below

Example : Download and Refresh Image

Example Architecture

The example architecture is as below

Launch TFTP Service

1. PC join to Wi-Fi AP
2. Lunch tftpd64.exe and select "Tftp Server" tab
3. Check image folder, image file size must be 960000 byte​ 

​              ​​

4. Select tftp server IP

EVK Join to Wi-Fi AP

1. EVK operates in command mode, you must start a serial tool.
2. type join  <SSID> <encryption> [key]
   • SSID, encryption protocol and key consistent with Wi-Fi AP setting
   • Ex: join RT66 wpa2_aes 12345678
3. Get IPv4 IP if join successful

Download Images to Flash

tftp <ip> <filename> <flash index> [-r] 

• ​​ip: tftp server ip
• filename: image file name 
• flash index: range 0~3, that have maximum  4 images(0~3) be saved in flash 
• -r : immediate refresh after download complete
• Ex: tftp 192.168.8.178 example_2.esl  1 -r

Refresh Image

epd_disp <-f flash index | -i internal image index>

• -f: display image that read from flash, range 0~3 
• -i: display internally generated image, range 0~4    
      0: fully black
      1: full white
      2: full red
      3: black/white/red vertical stripes
      4: black/white/red horizontal stripes
• Ex: epd_disp -f 1
• Ex: epd_disp -i 4 

EVK Carousel Mode

carousel<-e | -p | -s | -t >

• -e <1 / 0 > : set carousel mode
  • ​​1: enable, 0: disable
  • ​Ex: carousel -e 1 // enable carousel mode.
• -p <P0 P1...Pn> : edit carousel page 
  • ​P0~Pn: carousel page, n>0, n<14
  • Ex: carousel -p 1 2 5 8 10 // set carousel page 1, 2, 5, 8, 10
  • Ex: carousel -p 1 1 1 3 3 3 6 // you can use same page when use partial update
• -s <Sn start-X start-Y Image-W image-H mode> : edit carosuel setting  
  • ​Sn: carousel sequence number, associated with the -p order, n>0, n<16 
  • start-X: refresh X coordinate
  • start-Y: refresh Y coordinate
  • image-W: refresh width
  • image-H: refresh height
  • mode: refresh mode, 0: CG mode(by default), 1: DU mode(only usu in B/W panel), 2: Rolling mode(only usu in B/W panel)
  • Ex: carousel -s 1 0 0 1600 1200 0 // S1 (x,y)=(0,0) (w,h)=(1600,1200) use CG mode
• -t <Sn time> : set the interval between the next image
  • ​​Sn: carousel sequence number, associated with the -p order, n>0, n<16 
  • ​time: the unit is second.
  • Ex: carousel -t 1 5 // set S1 to S2 interval 5 second
•  A carousel example 
  • ​join ssid wpa2_aes password // join the AP router named "ssid"
  • tftp 192.168.8.178 BSD_00.esl 0 -r // load BSD_00.esl to page 0
  • tftp 192.168.8.178 BSD_01.esl 1 -r // load BSD_01.esl to page 3
  • tftp 192.168.8.178 BSD_02.esl 2 -r // load BSD_02.esl to page 6
  • carousel -p 0 3 3 3 6 6 6 // set carousel page P0(S0) P3(S1) P3(S2) P3(S3) P6(S4) P6(S5) P6(S6) 
  • carousel -s 0 0 0 1600 1200 0 // set S0 (x, y)=(0, 0), (w, h)=(1600, 1200), full update with CG mode
  • carousel -s 1 1095 50 140 240 0 // set S1 (x, y)=(1095, 50), (w, h)=(140, 240), partial update with CG mode
  • carousel -s 2 215 740 1230 85 0 // set S2 (x, y)=(215, 740), (w, h)=(1230, 85), partial update with CG mode
  • carousel -s 3 130 20 910 320 0 // set S3 (x, y)=(130, 20), (w, h)=(910, 320), partial update with CG mode
  • carousel -s 4 1095 50 140 240 0 // set S4 (x, y)=(1095, 50), (w, h)=(140, 240), partial update with CG mode
  • carousel -s 5 215 740 1230 85 0 // set S5 (x, y)=(215, 740), (w, h)=(1230, 85), partial update with CG mode
  • carousel -s 6 130 20 910 320 0 // set S6 (x, y)=(130, 20), (w, h)=(910, 320), partial update with CG mode
  • carousel -e 1 // enable carousel mode

EVK Command

Describes the EVK commands that you can use.

Command List

Command Description

• evk_info: Return EVK version
• epd_info: Return EPD model name, resolution and F/W version 
• get_mac_addr: Return EVK MAC address
• ping <dest> [-i <interval in ms>] [-n <number>] [-l <length>] 
  • Return ping reply time if successful
  • ping 8.8.8.8 -i 100 -n 5 -l 50
• join: Reference “EVK Join to Wi-Fi AP” 
• leave: leave an AP router
• tftp: Reference “Download Images to Flash”
• epd_disp: Reference "Refresh Image” 
• carousel: Reference  "Carousel Mode"
• led: set the led light or dark
  • led 1 0 ; turn-off led
  • led 1 1 ; turn-on led

BLE-WiFi Introducer Service

Ble-WiFi introducer service is a demonstration that set SSID and password to join network by phone. EVK will launch a BLE GATT server and advertise itself.
Then you need to manipulate on your phone.

Step 1: Install and launch the BLE Scanner app on iOS or Android.

Step 2:  Pull down the screen to rescan devices and it will list nearby BLE devices. Find the “WiFiInt” device and press CONNECT button.

Step 3:  If the connection is successful, you can see the picture below. Press  the "CUSTOM SERVICE" button.

Step 4: Find the UUID: ACA0EF7C-EEAA-48AD-9508-19A6F6B356 for SSID characteristic.

Step 5: Find the UUID: 40B7DE33-93E4-4C8B-A876-D833B415A6CE for Password characteristic then procedure as Step4.
        

Easy and Fast to Refresh Image via USB

Hardware Setup

Follow steps and picture below to setup the hardware

1. Connected EPD FPC to mainboard
2. Connected USB cable to mainboard USB2(CN2)

Tool Setup

1.  Download and unzip EPD-132R_CLItool
2. Click "IT8951_FWVersion.bat" to get EPD panel information

Download and Refresh Image

1. Click "IT8951_UpdateImage1.bat" to update "13.3inch-01.bmp" to EPD.
2. Click "IT8951_UpdateImage2.bat" to update "13.3inch-02.bmp" to EPD.
3. Open "IT8951_UpdateImage1.bat" and edit "13.3inch-02.bmp" for your image name.

• The image will not saved in flash

EVK Firmware Update

EVK 

Update To Development Kit