Difference between revisions of "EPM-880 Application Notes"

From ESS-WIKI
Jump to: navigation, search
Line 32: Line 32:
 
We has been tested on host operating system as below
 
We has been tested on host operating system as below
  
#'''linux-ubuntu 16.04'''
+
#'''ubuntu 16.04'''
 
#'''OpenWrt'''
 
#'''OpenWrt'''
 
#'''windows(windows 7 or windows 10)'''
 
#'''windows(windows 7 or windows 10)'''
Line 131: Line 131:
 
3. libjepg
 
3. libjepg
  
Contact with Advantech product division get software package.
+
Contact with Advantech product division get more software information.
  
 
=== Xml parameter ===
 
=== Xml parameter ===
  
Before image display ,user have to configure xml of file path、file name、 slide_interval and waveform mode. Below is content of xml file
+
Before image display ,user have to configure xml of file path、file name、 slide_interval and waveform mode. Content of xml file as below.
  
 
   <?xml version="1.0"?>  
 
   <?xml version="1.0"?>  
Line 158: Line 158:
 
'''&lt;image path&gt;&nbsp;: ''' User should assign photo image path in operating system , application search image file under this path.
 
'''&lt;image path&gt;&nbsp;: ''' User should assign photo image path in operating system , application search image file under this path.
  
'''&lt;img&gt;&nbsp;:''' User have to write the image name in xml file and application follow path and name to load image file. It can be assigned more than one &lt;img&gt; tag name between &lt;full_update&gt; and &lt;/full_update&gt; then following &lt;img&gt; tag to load image and display in sequence.
+
'''&lt;img&gt;&nbsp;:''' User have to write the image name in xml file and application follow path and name to load image file. It can be assigned more than one &lt;img&gt; tag name between &lt;full_update&gt; and &lt;/full_update&gt; then following &lt;img&gt; tag to load image and display in sequence. It's only support '''Bmp''' and '''jpg''' type.
  
 
'''&lt;stop&gt;''' Stop tag use to load image at once. Above mention stop tag in xml, application terminated after 1.bmp update done. In carousel mode stop tag must removed from xml.
 
'''&lt;stop&gt;''' Stop tag use to load image at once. Above mention stop tag in xml, application terminated after 1.bmp update done. In carousel mode stop tag must removed from xml.
Line 168: Line 168:
 
'''&lt;waveform_mode&gt;''' Waveform mode usually choose mode 2 for image update. waveform explicit detail see [[EPD-320_application_tech#Waveform_mode|Section 1.4 waveform mode]]
 
'''&lt;waveform_mode&gt;''' Waveform mode usually choose mode 2 for image update. waveform explicit detail see [[EPD-320_application_tech#Waveform_mode|Section 1.4 waveform mode]]
  
'''&lt;rotate&gt;''' There are 4 options 0 、90、180、270 angle to choose and rotate image following angle.
+
'''&lt;rotate&gt;''' There has 4 options 0 、90、180、270 of angle  
  
 
=== Application execution ===
 
=== Application execution ===
Line 182: Line 182:
 
Windows&nbsp;: '''"EPD_4Tcon.exe test.xml"'''
 
Windows&nbsp;: '''"EPD_4Tcon.exe test.xml"'''
  
Linux&nbsp;: $'''./EPD_4Tcon test.xml''' <!--[[File:Epd320 6 1.jpg|500px|execute EPD4tcon]]-->
+
Linux&nbsp;: $'''./EPD_4Tcon test.xml'''  
 +
 
 +
[[File:Epd320 6 1.jpg|500px|execute EPD4tcon]]
  
 
== Quick start ==
 
== Quick start ==
  
User reference
+
Following step to achieve different play mode.
  
 
=== Single display ===
 
=== Single display ===
Line 194: Line 196:
 
Step 1: Image path depends on user's defined. we defined path that is in /usr/local/photoImg in this example.
 
Step 1: Image path depends on user's defined. we defined path that is in /usr/local/photoImg in this example.
  
Step 2: we assume one picture that name is 1.bmp to display , we should put 1.bmp in image path and chaning img tag in xml.
+
Step 2: we assume one picture that name is 1.bmp to display , we should put 1.bmp in image path and put img tag in xml.
 
 
&lt;?xml version="1.0"?&gt;
 
  
 +
  &lt;?xml version="1.0"?&gt;
 
   <epd_config>
 
   <epd_config>
 
     <epd name="EPD 31.2">
 
     <epd name="EPD 31.2">
Line 209: Line 210:
 
         </image_name>
 
         </image_name>
 
         <slide_interval>0</slide_interval>
 
         <slide_interval>0</slide_interval>
         <en_set_temperature>0</en_set_temperature> <!-- Enable:1, Disable:0 -->
+
         <en_set_temperature>0</en_set_temperature>  
 
         <temperature>25</temperature>
 
         <temperature>25</temperature>
 
         <waveform_mode>2</waveform_mode>
 
         <waveform_mode>2</waveform_mode>
Line 216: Line 217:
 
   </epd_config>
 
   </epd_config>
  
Step 3:
+
Step 3: $'''./EPD_4Tcon test.xml'''
 +
 
 +
This application will stop after updating content of 1.bmp
  
 
=== Carousel mode ===
 
=== Carousel mode ===
 +
 +
Carousel mode is non-stop application except system signal , user could stop running procedure by SIGINT ,SIGKILL signal.
 +
 +
Below example is xml  in carousel mode that three images display in sequence every 10 sceonds
 +
 +
Step 1: Image path depends on user's defined. we defined path that is in /usr/local/photoImg in this example.
 +
 +
Step 2: There are three images to display , we should put 1.bmp,2.bmp,3.bmp in image path and put img tag in xml.
 +
 +
Step 3: Removed tag of <stop>.
 +
 +
Step 4: We defined every 10 seconds to change image and writing 10 at tag of <slide_interval>
 +
 +
&lt;?xml version="1.0"?&gt;
 +
  <epd_config>
 +
    <epd name="EPD 31.2">
 +
        <color>KW</color>     <!--KW/COLOR -->
 +
        <image_path>/usr/local/photoImg</image_path>
 +
        <image_name>
 +
          <full_update>
 +
              <img>1.bmp</img>
 +
              <img>2.bmp</img>
 +
              <img>3.bmp</img>
 +
          </full_update>
 +
        </image_name>
 +
        <slide_interval>10</slide_interval>
 +
        <en_set_temperature>0</en_set_temperature>
 +
        <temperature>25</temperature>
 +
        <waveform_mode>2</waveform_mode>
 +
        <rotate>180</rotate>
 +
  </epd>
 +
  </epd_config>

Revision as of 10:59, 13 April 2020

EPD-320 Application guide

This application provide user a way that image full update and carousel mode for EPD-320 panel display. user configure xml file follow setting rule.

Components LIST

Item

 Description
1  32” EPAPER
2  EPD-320 PCBA
3  cable

RTENOTITLE

SYSTEM ARCHITECURE

system diagram

System support

We has been tested on host operating system as below

  1. ubuntu 16.04
  2. OpenWrt
  3. windows(windows 7 or windows 10)

Waveform mode

There are six Waveform mode for image update and short name as below table. The mode parameter will use in update command.

mode 0 mode 1 mode 2 mode 3 mode 4 mode 5
INIT DU GC16 GCC16 A2 GL16

INIT(Global update WF) :

Initialize is used to completely clear the display, if it's left in an unknown state (i.e. if the previous image has been lost by a re-boot)

DU(Local update WF) :

Direct update Non-flashing waveform that can be used to update. it can update any changed graytone pixel to black or white only.

GC16(Global update WF) :

Grayscale clear, 16 levels A "flashy" waveform used for 16 level grayscale images. All the pixels are updated or cleared

GCC16( Global clear update WF) :

Grayscale Clear, 16 Levels A "more flashy" waveform used for 16 level grayscale images. All the pixels are updated or cleared.
This provides the best image appearance.

A2(Local update WF) :

animation, 2 Levels is a non-flashing waveform that can be used for fast updates and simple animation.
This wave form support black & white updates only.
image quality and ghosting is reduced in exchange for the response time.

GL16(Local update WF when white to white , Global update when 16 gray levels) :

The GL16 waveform is used to update anti-aliased text with reduced flash. GL16 should bed used only with Full Display Update..
The entire display except pixels staying in white will update as the new image is written. The GL16 waveform has 16 unique gray levels.

Push image application

Hardware prepare

1. Connected EPD FPC to mainboard

2. Connected micro USB cable to mainboard USB2(CN2) , usb port connect to computer usb port which installed windows or linux ubuntu

3. Connected 12V power cable to mainboard.

system diagram2

Software prepare

Windows

1. Download usb driver tool zadig usb tool

2.Execute zadig.exe and click Option->List All Devices

3.ITE T-CON appeared in list and click Replace Driver button , waiting installation until success

driver install

4.Repeat step 3 replace others ITE T-CON driver.

Linux

User must install library as below

1. Installed libusb 1.0.22.

2. Installed OpenCV 2.4.13.

3. libjepg

OpenWrt

software package has been integrate to latest Firmware on Hardware model of WISE-3270. Others hardware platform should install follow library

1. Installed libusb 1.0.22.

2. Installed OpenCV 2.4.13.

3. libjepg

Contact with Advantech product division get more software information.

Xml parameter

Before image display ,user have to configure xml of file path、file name、 slide_interval and waveform mode. Content of xml file as below.

 <?xml version="1.0"?> 
 <epd_config>
   <epd name="EPD 31.2">
       <color>KW</color>	    
       <image_path>D:\application\photoImg\</image_path>
       <image_name>
         <full_update>
             <img>1.bmp</img>
         </full_update>
         <stop>stop</stop>
       </image_name>
       <slide_interval>0</slide_interval>
       <en_set_temperature>0</en_set_temperature> 
       <temperature>25</temperature>
       <waveform_mode>2</waveform_mode>
       <rotate>180</rotate>
 </epd>
 </epd_config>

<image path> : User should assign photo image path in operating system , application search image file under this path.

<img> : User have to write the image name in xml file and application follow path and name to load image file. It can be assigned more than one <img> tag name between <full_update> and </full_update> then following <img> tag to load image and display in sequence. It's only support Bmp and jpg type.

<stop> Stop tag use to load image at once. Above mention stop tag in xml, application terminated after 1.bmp update done. In carousel mode stop tag must removed from xml.

<slide_interval>: Slide interval is delay time in second between every image display.

<set_temperature> user don't need configure temperature.

<waveform_mode> Waveform mode usually choose mode 2 for image update. waveform explicit detail see Section 1.4 waveform mode

<rotate> There has 4 options 0 、90、180、270 of angle

Application execution

User should check all information of xml is correct before execute application or it may cause error procedure.

1. Open command line

2. Change current directory to EPD_4TCON

3. Execute command EPD_4TCON with parameter xml file name

Windows : "EPD_4Tcon.exe test.xml"

Linux : $./EPD_4Tcon test.xml

execute EPD4tcon

Quick start

Following step to achieve different play mode.

Single display

This example showing how to configure xml for image display once on linux ubuntu 16.04.

Step 1: Image path depends on user's defined. we defined path that is in /usr/local/photoImg in this example.

Step 2: we assume one picture that name is 1.bmp to display , we should put 1.bmp in image path and put img tag in xml.

 <?xml version="1.0"?>
 <epd_config>
   <epd name="EPD 31.2">
       <color>KW</color>	    
       <image_path>/usr/local/photoImg</image_path>
       <image_name>
         <full_update>
             <img>1.bmp</img>
         </full_update>
         <stop>stop</stop>
       </image_name>
       <slide_interval>0</slide_interval>
       <en_set_temperature>0</en_set_temperature> 
       <temperature>25</temperature>
       <waveform_mode>2</waveform_mode>
       <rotate>180</rotate>
 </epd>
 </epd_config>

Step 3: $./EPD_4Tcon test.xml

This application will stop after updating content of 1.bmp

Carousel mode

Carousel mode is non-stop application except system signal , user could stop running procedure by SIGINT ,SIGKILL signal.

Below example is xml in carousel mode that three images display in sequence every 10 sceonds

Step 1: Image path depends on user's defined. we defined path that is in /usr/local/photoImg in this example.

Step 2: There are three images to display , we should put 1.bmp,2.bmp,3.bmp in image path and put img tag in xml.

Step 3: Removed tag of <stop>.

Step 4: We defined every 10 seconds to change image and writing 10 at tag of <slide_interval>

<?xml version="1.0"?>
 <epd_config>
   <epd name="EPD 31.2">
       <color>KW</color>	    
       <image_path>/usr/local/photoImg</image_path>
       <image_name>
         <full_update>
             <img>1.bmp</img>
             <img>2.bmp</img>
             <img>3.bmp</img>
         </full_update>
       </image_name>
       <slide_interval>10</slide_interval>
       <en_set_temperature>0</en_set_temperature> 
       <temperature>25</temperature>
       <waveform_mode>2</waveform_mode>
       <rotate>180</rotate>
 </epd>
 </epd_config>