Home
CUPANEL - Comfile Technology
Contents
1. gt gt Bkod Image gt gt Number of subdivisions 5 Indent Left o Top 10 Horiz 15 bottom jo Font Font Size 10 Font Face Tahoma Channels List Graph Color Display Value Value MN 0 0 100 i Start when page is loaded Demo mode 2 To have the Trend Graph read from the variable Amplitude right click the Trend Graph select the channel in the Channels List and click the Modify button to change its settings Edit Channel No of Divisions Display Value Range oo 100 Decimal Digits FS 4 Show Title vale Show Scale Thickness 3 Color Graph 1 Randomize li Synchronize with Graph Color Number N Notch E ve Device Value Range o 100 W Simulate as if the following value was read 3 Check the Compute value from formula checkbox and type the name of the variable in the textbox prefixed with a The prefix distinguishes variables from other text Now the Trend Graph will always display the value of the variable Amplitude Comfile Technology Inc CUPANEL User s Manual 39 of 64 100 a a mi i n 0 1 0 2 0 3 0 4 0 5 0 Time sec Execute the project When the Slider s value is adjusted the Trend Graph will reflect that adjustment System Variables The CUPANEL runtime predefines the following system variables po ETT ae The current minute SSS O The current minute The current second sys tick count The number of millis
2. Inc CUPANEL User s Manual Introduction The CUPANEL is an HMI Human Machine Interface touch panel development kit It includes an HMI touch controller and a WYSIWYG development tool the CUPANEL Editor for programming the touch controller However programming in the classical sense of the word is not required and this is what makes the CUPANEL so unique Using the powerful CUPANEL Editor and a personal computer users can create professional human machine interfaces by drawing controls i e buttons gauges graphs etc ON a Canvas representing the touch controller s screen These controls appearance and functionality can then be customized in great detail by selecting from a feature rich set of menu options that include RS 232 communication 1 Design an HMI user interface and configure the RS 232 communication settings with the CUPANEL Editor BT CuPanel Editor v3 07 File Edit Project Tools Help sare AA Pagel soox480 mopBus COMFILE Technology 1 Paget aS PO a Value EDS 6 3 50 9 8 ras E 1 3 0 0 oo 10 20 3 Time s 60 120 180 240 abo 120 aria hb gb 2 140 ES 2 180 240 300 eb E Ara 2 Use the CUPANEL Editor 3 Execute the user interface on to download the the touch controller as a interface to the standalone program that can CUPANEL touch communicate with and control a controller PLC Once the interface is created and the controls communication settings are
3. configured in the CUPANEL Editor the project can be downloaded to the touch panel and executed as a standalone program that can communicate with and control a PLC Programmable Logic Controller Comfile Technology Inc CUPANEL User s Manual 5 of 64 The CUPANEL touch controller features an 800x480 color touch screen capable of receiving input from a human user by touching the screen and displaying colorful output COMPILE Technology T a amp 25 la a d h io ii oe ado i e m mw ao i i W w i a ot The rear and side panels feature several interfaces RS232 Serial Ports USB Ethernet Audio SD Card for interfacing with a variety of electronic devices and electronic media But please note that at this time not all hardware features can be taken advantage of by the CUPANEL software Serial Ports RS 232 3 Channels Ethernet Not used USB port Not used USB port Connect to PC Not Used Com1 Mode DIP switc p DC12 24V Ower Switch Ca DC12 24V SD Card Audio Output Operating Mode DIP Switch OFF ON Comfile Technology Inc CUPANEL User s Manual 6 of 64 The CUPANEL currently comes in three different models Maa OO Description 7 Color TFT LCD Touch Screen 2 6 Million Colors Bezel type Case Indoor Use 2GB User Program Space SD Card CE KCC FCC Certified 7 Color TFT LCD Touch Screen 2 6 Million Colors Waterproof Front Panel Indoor amp Outdo
4. on and off Follow the following procedure to setup the CUBLOC lt _ Cubloc Studio c documents and settings imikelmy docum AE File Edit Device Run Setup Help E E gt w Dr a 3 S lel g amp ES A b mi E FI BASIC F2 LADDER Ladder Mnemonic 1 Const Device CB280 Using CUBLOC CB280 2 Opencom 1 38400 3 50 50 Serial Port Settings 4 Set Modbus 1 1 20 Modbus Settings Ramclear Make sure memory is clean 7 Usepin 0 Cut Use PO to light the LED 3 Set Ladder On Needed to make PO light LED 11 Do Keep running don t exit 12 Loor FW Id 6188252 OY 1 Using Cubloc Studio program the CUBLOC as shown above This will program the CUBLOC to communicate via RS 232 and Modbus over its serial port and enable I O port O PO to apply voltage to an LED See the CUBLOC s user s manual if you wish to learn more about programming the CUBLOC Comfile Technology Inc CUPANEL User s Manual 14 of 64 pp F z 3 i a E CUBLOC STUDY BOARD 1 a a a O A 0 Poo Ooo oo htt ed 2 Connect the CUBLOC s I O port O PO to LED O LEDO The image above illustrates how to accomplish this using a yellow jumper wire and the CUBLOC Study Board Then when voltage is applied to PO LEDO will light CUPANEL sree Ms e o ter 6 so CUBLOC Study Board ts PE i 3 Connect the CUBLOC s serial port to the CUPANEL s COM1 serial port and connect the C
5. option to Toggle Bit will cause PO s state to toggle between on and off when the button is pressed Comfile Technology Inc CUPANEL User s Manual 18 of 64 Downloading and Running the HMI User Interface on the Touch Controller Now that the HMI user interface has been designed and configured with the CUPANEL Editor it can be downloaded and executed on the CUPANEL touch controller IMPORTANT When a project is downloaded to the CUPANEL it is downloaded to the touch controller s SD Card Ensure an SD card is plugged into the touch controller before downloading Runtime Wer 3 09 Port Baud Rate 38400 Modbus Protocol RTU Parity None Data Bits ig Stop Bits f View Communication State Enable entering setup mode while operating YOU can enter this setup mode at any time by touching the upper right corner 5 times Clean Project Touch Calibration Select Language 1 Adjust the RS 232 settings on the CUPANEL touch controller to match that of the CUBLOC CuPanel Editor v3 09 File Edit Project Tools Help JA AE im Visit COMFILE Technology website ES a e A PS A enemas foad Project Data to CuPanel ActiveSync and USB cable are needed A Pagel 800x480 MODBUS LA a yr Page Settings Add Page ae 2 With the CUPANEL touch controller connected to the PC via USB download the project to the touch controller by clicking the lightning bolt icon in the CUPANEL Editor s toolbar Comfile Technology In
6. project on the PC as if it were running on the CUPANEL touch controller pa Download Downloads the project to the CUPANEL touch controller Comfile Technology Inc CUPANEL User s Manual 25 of 64 The Simulator When developing a user interface it is often necessary to test its functionality and make changes in a cyclical fashion This change gt test gt change cycle would incur a lot of time if each time a test was performed the project had to be downloaded to the touch controller The Simulator was developed to make this procedure far more efficient File Edit Project Tools Help 1 When testing a user interface it is not necessary to download it to the touch controller Rather click the Preview icon in the Toolbar to start the Simulator A CuPanel Run Time Module COMFILE Technology os Du Co Md oF 2 O cm 50 00m 00 l I l I A N ee Ci 1 0 2 0 4 0 40 5 0 Timels O 120 180 240 ado Bo 120 180 240 300 Bo 120 180 240 300 Runtime Ver 3 11 Settings COM4 38400 None 8 1 Status Timeout Timeout 0 609 3 609 seconds a ago BitRead Ox1000 4096 2 A new window will open with the user interface fully interactive Buttons can be clicked knobs can be turned lamps light etc It behaves identically to how it would behave if it were downloaded to the touch controller Comfile Technology Inc CUPANEL User s Manual 26 of
7. 64 Runtime Wer 3 11 Port com4 Baud Rate 38400 Modbus Protocol RTU Parity None Data Bits 8 Stop Bits 1 gt 3 Using the PC s serial ports the Simulator can also communicate with a PLC or other electronic device Click the Options button to open the RS 232 settings dialog Comfile Technology Inc CUPANEL User s Manual 27 of 64 Controls The Controls are the widgets that can be drawn on a page to provide the user interface s functionality Once drawn on the screen they can be moved resized and configured through a feature rich set of options The controls can be selected from the Control Toolbox on the left side of the CUPANEL Editor 1 Selector 2 Button 3 Lamp LED 4 Lever 5 Progress Bar 6 Slider Bar 7 Gauge 8 Knob 9 Trend Graph 10 Keypad 11 Image 12 Text 13 Watcher 14 Timer 15 Logger 16 Event Handler 17 Popup Window 18 Binder 19 Custom Control 1 Selector The Selector is not actually a control It is just a tool used to select controls already on the canvas To use select the Selector from the Control Toolbox and then click and drag over any control s already drawn on the canvas All of the controls within the Selector s rectangle will be selected 2 Button The Button Control is similar to buttons found in most other graphical user interfaces It performs an action when pressed Comfile Technology Inc CUPANEL User s Manual 28 of 64 3 Lamp LED The Lamp
8. Control is analogous to a lamp or LED Light Emitting Diode indicator that one might see on a machine or an appliance Is shows lit when on and unlit when off 4 The Lever The Lever Control is analogous to a typical toggle switch with an on and off state 5 Progress Bar A A O ee 0 60 120 180 240 300 The Progress Bar Control is similar to progress bars found in other graphical user interfaces It displays a progress meter showing how much of a task is completed and how much of a task remains It can be oriented horizontally or vertically 6 Slider Bar SSS 0 60 120 180 240 300 The Slider Bar Control allows the user to adjust a value within a finite range It can be oriented horizontally or vertically 7 Gauge The Gauge control is analogous to the gauges commonly found on instrument panels everywhere It is an output only control with a rich set of aesthetic customizations Comfile Technology Inc CUPANEL User s Manual 29 of 64 8 Knob 120 180 f 1 f 0 300 The Knob Control is analogous to knobs typically found on control panels and appliances Like the Slider Bar Control it is allows the user to adjust a value within a finite range 9 Trend Graph 10 0 8 6 Rod 6 3 5 0 gt 3 6 Eta 0 0 1 0 2 0 3 0 4 0 2 0 Time sec The Trend Graph Control is analogous to the screen on an oscilloscope It is an output control that displays a value read ove
9. Disclaimer of Liability Comfile Technology Inc is not responsible for special incidental or consequential damages resulting from any breach of warranty or under any legal theory including lost profits downtime goodwill damage to or replacement of equipment or property and costs or recovering reprogramming or reproducing any data stored in or use with Comfile Technology products Copyright amp Trademarks Copyright O 2006 2011 by Comfile Technology Inc All rights reserved CUBLOC is a registered trademark of Comfile Technology Inc WINDOWS is a trademark of Microsoft Corporation Other trademarks are of their respective owners Comfile Technology Inc CUPANEL User s Manual 2 of 64 Table of Contents Chapter LOVervIeW iii A AAA Naire nakai 4 MO CUCID ASAS nauarsels 5 Chapter 2 Getting Started iia a oa ouo anios 8 Connecting the CUPANEL to a Personal Computer PC cccc cece esse cece ee eee crnnnn rr 9 Connecting the CUPANEL TO a PEC ga ana ns 11 Contiguring Ene TOUCH Panels dd A AAA AA AAA 13 Ereating a USser Interact AN 14 Setting Up te CUBLOC aia ER eA 14 Designing and Configuring the HMI User Interface with the CUPANEL Editor 0ooccccccccccccccco oo 16 Downloading and Running the HMI User Interface on the Touch Controller ooo oooomooo 19 Chapters Tne CUPANEL Edo Ena da 22 TAE MAN WWIAGOW ad AAA ANOS 23 ANN 24 TS Ms OOO AN it A ops 25 MAS SMMC ALOL nia daa 26 CORTO rasa 28 LS
10. HMI Touch Panel Development Kit CUPANEL User s Manual Version 1 0 2011 02 18 Everything for Embedded Control COMPFILE TECHNOLOGY Comfile Technology Inc www cubloc com Copyright 1996 2010 Comfile Technology Comfile Technology Inc CUPANEL User s Manual 1 of 64 Notice This manual may be changed or updated without notice Comfile Technology Inc is not responsible for any actions taken outside the explanation of this manual This product is protected by patents across the world You may not change copy reproduce or translate it without the consent of Comfile Technology Inc Warranty Comfile Technology provides a one year warranty on its products against defects in materials and workmanship If you discover a defect Comfile Technology will at its option repair the product replace the product or refund the purchase price Simply return the product with a description of the problem and a copy of your invoice if you do not have your invoice please include your name and telephone number This warranty does not apply if the product has been modified or damaged by accident abuse or misuse 30 Day Money Back Guarantee If within 30 days of having received your product you find that it does not suit your needs you may return it for a refund Comfile Technology will refund the purchase price of the product excluding shipping handling costs This does not apply if the product has been altered or damaged
11. IEC da 28 ZA UN A tia ro odds 28 O A ee ene 29 EMS EEV AA A AI AAN ede 29 a A A a aea a aaie 29 A 29 E RO 29 O tac an wan ase ud sd a aad tees agg ed ea vod Cb hal oer A ict a Andon He ame a eo nase a Gea yu vk aa 30 9 TENA GD aia 30 COSE EVD ileso eens 30 A A vate ledaesawiuacou mete a a Gacdatevaatetabuxeedeweaeu mete neh E EA 31 T2 OG A 31 LS Watene eere a aapioe Mera ubebe esp nebnea veep lberarusenera baton seni aebedieneneoes ao 31 A A laa guaawanl cine a dieas 31 A ER 6 6 peewee entre terest ete A AE EE TE RO ger E E Creer Caer ore ere E area eee 32 To EVentnan dera rd is id 32 L PONUD VINO OW adan add 32 To UBINGED a 33 OE CUS ON CORTO Mido cbr E a E AE i eaooenrs 33 Drawno A COn lara a ada co a 34 CUSTOMIZING a Controls APpearante iia 35 A dees wacent le cevvnr inte dyna mninsc a a tarry deena ono a A 41 MOdbuUS C OMMUMCI CIO aaa A s 43 BIE REGIStEr BOUNO Control Sia AROS 43 WOraiRegISter BOUNO CONTO Serra co 43 TWOA AY BINAN sara aca psa las 44 Using the Binder Control to Reduce CONGESTION cccccccccccncccccccccncccnnnrcnnnn cnn nr rr rra nr arras 44 Events a a Event Ham Guin O isaac iii 45 Software LNStallation AR 47 PAstalling ACHVESYNCAWINGOWS AP Ta A A ASS 48 Installing Windows Mobile Device Center Windows Vista 7 cccccccccccccnncncncnnnrncnnnnnn nr 55 AStalina the CUPANEL Edito Rois Ad odas 60 Comfile Technology Inc CUPANEL User s Manual 3 of 64 Cnapter 1 Overview Comfile Technology
12. QA n is the number of digits to print Evaluation operator In a text field typing 1 2 equals 1 2 will print 1 2 equals 3 60 Degrees Celsius 140 Degrees Fahrenheit For example suppose a user interface required temperatures to be displayed in both Degrees Celsius and Degrees Fahrenheit Comfile Technology Inc CUPANEL User s Manual 41 of 64 Variables i Set variable whenever the slider is changed Key 5 Celsius Initial Value o if Save to File 1 Add a Slider to the canvas right click it and have it set the variable Celsius when changed Content f Custom text multifine Celsius Degrees Celsius 2 Add a Text Control and set its content as shown above to display the Slider s value in Degrees Celsius If the slider is adjusted to 60 this text will display 60 Degrees Celsius Content f Custom text multifine 3 Add a second Text Control and set its content as shown above with the formula Celsius 40 9 5 40 Degrees Fahrenheit to display the Slider s value in Degrees Fahrenheit If the slider is adjusted to 60 this text will display 140 Degrees Fahrenheit 100 60 Degrees Celsius z 140 Degrees Fahrenheit Execute the project Now when the Slider s value is adjusted the text boxes will update with the correct Celsius and Fahrenheit values Comfile Technology Inc CUPANEL User s Manual 42 of 64 Modbus Communication Most of the controls can be bound to a specifi
13. Technology Inc CUPANEL User s Manual 59 of 64 Installing the CUPANEL Editor Follow the following instructions to download and install the CUPANEL Editor These instructions will describe the procedure for Windows XP but the procedure is similar for Windows Vista and Windows 7 1 Download the CUPANEL Editor from http www cubloc com data 08 php 5 Setup CuPanel Editor Welcome to the CuPanel Editor Setup Wizard This will install CuPanel Editor v3 08 on your computer Itis recommended that you dose all other applications before continuing Click Mext to continue or Cancel to exit Setup 2 Run the downloaded file and the dialog above will appear Click the Next button Comfile Technology Inc CUPANEL User s Manual 60 of 64 5 Setup CuPanel Editor Select Destination Location Where should CuPanel Editor be installed O Setup will install CuPanel Editor into the following folder To continue dick Next If you would like to select a different folder cick Browse Browse Atleast 26 4 MB of free disk space is required 3 The installation program will then ask you to specify the location where you would like the CUPANEL Editor to be installed Keep the defaults or make changes to your liking and click the Next button 5 Setup CuPanel Editor Select Start Menu Folder Where should Setup place the program s shortcuts pa EA Setup will create the program s shortcuts in the following Start Menu
14. UPANEL to a PC via USB as shown above There will now be two connections to the CUPANEL s touch panel a USB connection to the PC and an RS 232 connection to the CUBLOC Study Board Comfile Technology Inc CUPANEL User s Manual 15 of 64 Designing and Configuring the HMI User Interface with the CUPANEL Editor With the CUPANEL properly connected to a PC and the CUBLOC study board a user interface project can be created with the CUPANEL Editor Follow CUPANEL Editor installation instructions in the Software Installation chapter to download and install the CUPANEL Editor GT CuPanel Editor v3 08 File Edit Project Tools Help dy des th D he Inquiries amp Bug report kmrt4 daum net pe wc ce Ets PO o o A A A a H i Pagel soox480 mopsus All Gapiin o i 6 Add Page 1 Once installed run the CUPANEL Editor BT CuPanel Editor v3 09 File Edit Project Tools Help Inquiries amp Bug report kmrt4 daum net UN A Pagel sooxw80 mopsus y Y Page Settings Add Page BA Select the Lamp Control 2 Draw the Lamp on the screen 2 Select a Lamp Control i e LED from the toolbar and draw it on the center of screen Comfile Technology Inc CUPANEL User s Manual 16 of 64 End CuPanel Editor v3 09 File Edit Project Tools Help 800x480 MODBUS yr Page Settings Add Page 1 Select the Button Control 2 Draw the Button on the screen ma F a 3 Select a Button Control from the toolbar an
15. ake your choice and click the OK button Comfile Technology Inc CUPANEL User s Manual 9 of 64 No project to run Please download from PC Touch upper right corner 5 times to enter setup mode 3 If no user interface project has yet been downloaded to the CUPANEL the CUPANEL will display the screen above This screen will be discussed in the section Configuring the Touch Panel amp Windows Mobile Device Center oa lu Home e View Tools Help Windows aie Ta Mobile Show Details Set up your device Get Outlook contacts calendar e mail and other information on your device Connect without setting up your device 4 With the CUPANEL powered on and properly connected to the PC ActiveSync or Windows Mobile Device Center will show a status of Connected The CUPANEL and the PC will then be able to communicate with one another Comfile Technology Inc CUPANEL User s Manual 10 of 64 Connecting the CUPANEL to a PLC Connecting the CUPANEL touch controller to a PC will enable the ability to create an HMI user interface project using the CUPANEL Editor and download it to the CUPANEL touch controller but eventually the CUPANEL touch controller will need to be interfaced to a PLC The touch controller can be connected to a PLC using any one of its three serial ports and supports three different communication protocols Modbus LS Master K CNET and Mitsubishi FX The following diagr
16. ams illustrate the necessary connections that will need to be made for each of these different protocols Connecting CUPANEL to Comfile Technology s TinyPLC or CUBLOC Modbus Comfile Technology Inc CUPANEL User s Manual 11 of 64 CUPANEL Master K CNET 0 see 0 O O Female Type Male Type Connecting CUPANEL to an LS Master K CNET device Connecting the CUPANEL to a Mitsubishi FX device Comfile Technology Inc CUPANEL User s Manual 12 of 64 Configuring the Touch Panel Once a physical connection is made between the CUPANEL s touch panel and a PLC the touch panel s RS 232 settings and other features can be configured No project to run Please download from PC Touch here 5 times to enter setup mode Touch upper right corner 5 times to enter setup mode 1 Turn on the CUPANEL touch controller When the screen above appears touch the upper right corner of the screen 5 times to enter setup mode Runtime Wer 3 09 Port COML Baud Rate 38400 y Modbus Protocol RTU Y Parity None Data Bits 8 Stop Bits 1 Iv View Communication State Y Enable entering setup mode while operating YOu can enter this setup mode at any time by touching the upper right corner 5 times WI Clean Project Touch Calibration Select Language a 2 Once in setup mode adjust the RS 232 settings to match that of your PLC or other device In addition to the RS 232 settings the following settings feature
17. c CUPANEL User s Manual 19 of 64 3 The user interface that was drawn in the CUPANEL Editor will then execute on the touch controller as a standalone program Comfile Technology Inc CUPANEL User s Manual 20 of 64 A ial outeut a D IM Ll CUBLOC STUDY BOARD 1 Soeg a errores NS a a a ial E a E E a oll E E sm S iil ie OA t i a Se MEE cicle gt A Touch the button on the CUPANEL touch controller LEDO will light on the CUBLOC study board and the Lamp Control will light on the CUPANEL touch controller Once the project data is downloaded to the touch controller the PC is no longer required The project will run as a standalone program and will be started each time the touch controller is powered on Comfile Technology Inc CUPANEL User s Manual 21 of 64 Cnapter 3 Tne CUPANEL Editor Comfile Technology Inc CUPANEL User s Manual The Main Window 1 Menu 4 Caption 5 Page Settings 6 Add Page 7 Page Order BT CuPanel Editor v3 08 ile Edit Project Tools Help 2 Toolbar HU A A Pagel soox480 mopBus ee Page Settings dorar Add Page MO 05 ae 8 Page 3 Control a fil View Toolbox o i ZA Lit g Y Va 9 Canvas Menu Main menu for conveniently accessing the CUPANEL Editor s features and settings Toolbar A set of icons exposing the CUPANEL Editor s most frequently used features Control Toolbox Th
18. c bit or word register on a PLC When the register s value changes any control bound to that register is updated to reflect the change Bit Register Bound Controls Modbus Address Dx 1000 Bit position Slave Address 1 Control Name The Lamp Control is a simple example It can be bound to a bit register on a PLC by configuring its Modbus properties In the image above the Lamp Control is bound to register 0x1000 on slave device 1 Whenever this register s value is ON the lamp will show lit If this register s value is OFF the lamp will show unlit Word Register Bound Controls Controls with the ability to show a range of values can be bound to word registers Modbus Address Device Value Range o 1024 The Gauge Is a good example of a control that can be bound to a word register In the image above the Gauge control is bound to word register 0x7000 on slave device 1 But in addition the range of valid values read from the PLC can also be specified In this example the Gauge expects to only receive values from 0 through 1024 The values read from the PLC may not always be the values that one would want to display to the user For example the gauge might read values from O through 1024 but these numbers might represent voltages from O to 12 Display Value Range 0 0 ru 12 0 For this reason word bound controls can be scaled by specifying the Display Value Range property In the image above the values 0 throu
19. d draw it just below the lamp E CuPanel Editor v3 09 Modbus Address oxo000 Bit position Slave Address 1 Control Name default Turn on the lamp when the following condition is satisfied Enable bit toggling Display Options Built in Image Custom Image Set Luminance Built in Images Qe o Proportion Heiaht Width a y 20 300 quis 4 Select the lamp right click it and choose Properties to open the Lamp s properties window Adjust the properties as shown in the screen above Modbus Address 0x0000 is the address of the CUBLOC s PO I O port The CUPANEL will read from this address and light this Lamp Control when PO is ON Adjust the Hue to O to make the LED red Comfile Technology Inc CUPANEL User s Manual 17 of 64 G CuPanel Editor v3 09 Edit Button Modbus Address ox0000 Bit position Slave Address 1 Control Name default Works when Pressed y Action to perform when pressed Variables Set the value whenever the button is clicked up Fe sa Display Options Built in Image Custom Image Set Luminance Simple Transparent 5 Select the Button right click it and choose properties to open the button s properties window Adjust the properties as shown in the screen above Once again Modbus Address 0x0000 is the address of the CUBLOC s PO I O port Setting the Action to perform when pressed
20. e Event Handler would be used to define the action of writing to the PLC when the time interval elapses The Timer Control is functional only and is therefore not displayed on the user interface at runtime Comfile Technology Inc CUPANEL User s Manual 31 of 64 15 Logger 2010 12 16 08 38 58 156 System Powered Off 2010 12 16 08 31 13 114 Error Cannot read from 0x7000 2010 12 16 08 21 20 854 Cleaning Finished 2010 12 16 08 10 08 235 Cleaning Started 2010 12 16 07 57 54 653 Alarm Control box temperature too high 2010 12 16 07 40 36 421 System Powered On The Logger Control keeps a running log of notable events that may occur while a system is running Use with the Event Handler Control to specify when and what to log 16 Event Handler The Event Handler Control is a powerful control used to define actions to perform when a certain event occurs Actions can be setting values writing to a PLC navigating to a new page etc just to name a few Events can be a Timer tick a Page load a button click etc An action defines what should be performed and an event defines when and or on what condition the action should be performed The Event Handler Control is functional only and is therefore not displayed on the user interface at runtime 17 Popup Window I am a popup window NN 7 The Popup Window Control is used to define a popup window to display under a certain condition The condition is configured in the Popup Windo
21. e list of controls i e widgets that can be drawn on the canvas Caption Adds a textual caption to the currently selected control Page Settings Opens the properties for the currently selected page Add Page Adds a new page to the user interface New pages will appear at the bottom of the page view Page Order Changes the order of pages in the Page View by moving the currently selected page up or down in the list Page View Shows a list of all the pages in the user interface Click a page to select it and double click it to display it on the canvas Right Click a page for even more options Canvas The selected page s screen on which controls can be drawn Comfile Technology Inc CUPANEL User s Manual 23 of 64 Menus File Menu New Project Creates a new CUPANEL project with an Edit Project Tools Help empty canvas New Project Ctrl 4 Open Project Opens an existing project from an Open Project Cil40 existing CUPANEL project file cnp Save Saves the current project If the project has never been saved it will prompt for a file name 1 Sample 1 cnp sample 1 cn Save AS Saves the current project under a new 2 sample_Eng cnp file name 3 sample cnp 4 most recently opened project files 4 IP 100WTOUCH cnp Closes the CUPANEL Editor Save As Exit Edit Menu Undoes the last edit operation File Project Tools Redoes and last edit operating that was Undo Ctl4 z ff undone Redo Ctrl Y Removes the curre
22. econds since the system booted sys untreated packet count The number of packets waiting to be sent Comfile Technology Inc CUPANEL User s Manual 40 of 64 Formulas Sometimes it is necessary to perform mathematical operations make logical decisions and format data in a user interface The CUPANEL Editor supports a rich set of mathematical bitwise logical and formatting operators and features specifically to support this need Mathematical Operators Addition Subtraction ij Multiplication Division Modulus Ox Hexadecimal prefix Ox0OA is a decimal 10 Bitwise Operators amp Boolean AND Boolean OR Logical Operators amp amp Logical AND Logical OR lt Less than lt Less than or equal gt Greater than gt Greater than or equal Equal I Not Equal Formatting Tells the formula parser to print value of variable If variable a stores the value 10 typing a in a text field will print a but typing a will print 10 d f Decimal Formatting If variable a stores the value 9 4 a 2 3 will print 09 400 d is the number of digits to print before the decimal point and f is the number of digits to print after the decimal point nh Hexadecimal Formatting lower case If variable a stores the value 10 a 3h will print 00a n is the number of digits to print nH Hexadecimal Formatting upper case If variable a stores the value 10 a 3H will print Q
23. f 64 Variables One of the most fundamental concepts in using the CUPANEL Editor is making use of variables A variable is just a named value that can be referred to by any control or page A variable can be read from in order to use the variable s value for some purpose or written to in order to change or update the variable s value Variables W Set variable whenever the slider is na Key Amplitude A variable can be defined in the properties of any control that can read from or write to a variable as shown in the image above The textbox is the variable s name in this case Amplitude The Initial Value is the variable s starting value The Save to File option is used to store the value to a file any time it is changed so it can be restored should the program be closed and restarted again Once a variable is defined it can be used anywhere in the user interface 0 1 0 2 0 3 0 4 0 5 0 Time sec For example suppose we wanted to adjust a variable s value with a Slider and display the value on a Trend Graph Variables M Set variable whenever the slider is changed en spe mave O BR 1 Right Click the Slider Control to open its properties Give the variable a name of Amplitude and an initial value of 0 Now when the Slider is adjusted the Slider s value will be written to the variable Amplitude Comfile Technology Inc CUPANEL User s Manual 38 of 64 Trend Graph Control Name default X Axis Time
24. folder To continue dick Next If you would like to select a different folder dick Browse Comfile Tools Browse 4 The installation program will then ask you to specify a Start Menu folder Keep the defaults or make changes to your liking and click the Next button Comfile Technology Inc CUPANEL User s Manual 61 of 64 5 Setup CuPanel Editor select Additional Tasks Which additional tasks should be performed Select the additional tasks you would like Setup to perform while installing CuPanel Editor then dick Next 5 The installation program will then ask you if you would like to create a desktop icon Keep the defaults or make changes to your liking and click the Next button 5 Setup CuPanel Editor Ready to Install Setup is now ready to begin installing CuPanel Editor on your computer Click Install to continue with the installation or dick Back if you want to review or change any settings Destination location CC Program Files ComfileTools TCuPanel Start Menu folder Comfile Tools Additional tasks Add icon Create desktop icon 6 The installation program will then inform you that all it is ready to install Click the Install button Comfile Technology Inc CUPANEL User s Manual 62 of 64 i Setup CuPanel Editor Installing Please wait while Setup installs CuPanel Editor on your computer Extracting files C Program Files ComfileTools CuPanel edito
25. gh 1024 as read from the PLC will be scaled to 0 0 through 12 0 when displayed on the screen Comfile Technology Inc CUPANEL User s Manual 43 of 64 Two Way Binding Those controls that can receive input from the user Button Slider Knob etc can also be bound to PLC registers In these cases when the user adjusts the control a value is written to the PLC But this binding is two way so if the register s value is updated by some other means besides the bound control the bound control will read register s value and update accordingly When many controls are bound to the PLC the communication channel can become congested For example if there are 8 Lamp Controls bound to bit registers 0x0000 through 0x0007 8 separate read operations will be issued Using the Binder Control to Reduce Congestion The Binder Control was created to alleviate some of this congestion Using the Binder Control several registers can be read simultaneously in one read operation by specifying a range of registers to read E Jax The Binder performs BIT READ or WORD READ operations on behalf of multiple controls thereby reducing redundancy and improving I O performance Binder Address Range Slave Address Bit OxO000 0x000F 1 Modify item Data Type Bit C Word Modbus Address 0x0000 e 0x0007 Slave Address 1 OK Cancel In the example above bit registers 0x0000 through 0x0007 will be read simultaneously in one read
26. he Control Toolbox 2 Click and drag the control on the canvas to the desired position and size a CuPanel Editor v3 11 File Edit Project Tools Help a bi Sh r Ber c o i 3 Release the mouse button and the control will appear as drawn Comfile Technology Inc CUPANEL User s Manual 34 of 64 Customizing a Control s Appearance The CUPANEL Editor has a rich set of features for customizing controls appearance These include fonts shapes colors gradients and even custom images Each control is unique in its appearance and features so each control s properties are different Font Font Tahoma Bold l Italic En Ml Controls that feature text of any kind will typically have properties for font style and color Caption Font Font Face Tahoma Font Color IN Bold Italic Font Size E E By ratio Horiz Align Vert Align Center Adjust Horiz a 0 Adjust Vert 4 0 Content In addition a caption can be added to any control Captions feature a richer set of customizations that include font style color size alignment positioning and more For multiline text type a carriage return The text can be static text that never changes or dynamic text that changes based on variables values See the Variables section for more information Comfile Technology Inc CUPANEL User s Manual 35 of 64 Built in Images Some controls feature built in images or presets that pro
27. ilyld 46F72DF1 E46A 4A5F A791 O9FO7AAA1914S8displaylang en TA File description Win32 Cabinet Self Extractor Company Microsoft Corporation File version 6 0 5624 1638 Date created 6 23 2010 1 42 PM Size 12 0 MB 2 Run the downloaded file gt Do you want to allow the following program to make changes to this computer Program name Windows Mobile Device Center Verified publisher Microsoft Corporation File origin Downloaded from the Internet Show details Change when these notifications appear 3 If you are presented with a User Account Control dialog click the Yes button Comfile Technology Inc CUPANEL User s Manual 55 of 64 Comfile Technology Inc a Driver Update 4 Windows Mobile Device Center will begin installing Wait for it to finish Windows Mobile based device support k Device driver software installed successfully Default Programs R Desktop Gadget Gallery E Internet Explorer 5 Korea Media Player Center EJ Korea Messenger Center E Windows Anytime Upgrade E Windows DVD Maker kag Windows Fax and Scan Windows Media Center Windows Media Player sx LA Y Windows Update 2 XPS Viewer di Accessories di Games Maintenance Startup CUPANEL User s Manual 5 When the installation is finished a message will appear in the system tray telling you that the installation was successful Mike Docu
28. ments Pictures Music Computer Control Panel Devices and Printers Default Programs Help and Support 6 Run Windows Media Device Center from the Windows Start Menu 56 of 64 MICROSOFT SOFTWARE LICENSE TERMS MICROSOFT WINDOWS MOBILE DEVICE CENTER 6 1 These license terms are an agreement between Microsoft Corporation or based on where you live one of its affiliates and you Please read them They apply to the software named above which includes the media on which you received it if any The terms also apply to any Microsoft Internet based services and r 7 Read the license agreement and if you agree click the Accept button Y Not Connected 8 Windows Mobile Device Center will open and will indicate a status of Not Connected Comfile Technology Inc CUPANEL User s Manual 57 of 64 9 Using a USB cable connect the CUPANEL to the PC A xX Device driver software installed successfully fa LA D _ m fa Nor cy po y O 10 Windows will begin installing a driver for the CUPANEL When it is finished a message will display in the system tray saying Your device is ready to use 58 of 64 CUPANEL User s Manual Comfile Technology Inc Windows w Mobile Y Connected 11 Windows Mobile Device Center will begin connecting with the CUPANEL When it is finished it will display a status of connected Comfile
29. ntly selected items s and saves them to the Cut Ctrl X clipboard 4 Copy Ctri C Saves the currently selected items s Paste Ctrl V to the clipboard without removing them saved to the clipboard Project Menu Preview Runs the current project on the File Edit Tools Help Simulator PC as if it were running on the T Preview Simulator Cirl R CUPANEL touch controller Data to CuPanel CUPANEL touch SOMEONE Project settings for editing Project Settings Opens the current project s E oso Tools Menu Editor Options Opens the CUPANEL Editor s File Edit Project Help settings for editing Editor Options AKA Aa Firmware Update Firmware Update Updates the CUPANEL touch controller s firmware Comfile Technology Inc CUPANEL User s Manual 24 of 64 The Toolbar U N e name A 1 New 3 Save 5 Copy 7 Preview Project Simulator 4 i gt f 2 Open 4 Cut 6 Paste 8 Download Project New Project Creates a new CUPANEL project with and empty canvas Open Project Opens an existing project from an existing CUPANEL project file cnp Save Saves the current project If the project has never been saved it will prompt for a file Cut Removes the currently selected item s and saves them on the system s clipboard Copy Saves the currently selected items s to the clipboard without removing them Paste Pastes a copy of the latest item s saved to the clipboard Preview Simulator Runs the current
30. obile en us downloads microsoft activesync download mspx setup s Type Windows Installer Package Author Microsoft Corporation Title Installation Database Subject Microsoft ActiveSync This installer database contains the logic and data required to install Microsoft Activesync Date Modified 6 16 2010 3 36 PM Size 7 52 MB 2 Run the downloaded file Open File Security Warning Do you want to run this file Mame setup msi Publisher Microsoft Corporation Type Windows Installer Package From C Documents and Settings AdrinistratoriDesktop While files from the Internet can be useful this file type can potentially harm your computer Only run software trom publishers wou trust What s the risk 3 Ifa Security Warning dialog box appears click the Run button Comfile Technology Inc CUPANEL User s Manual 48 of 64 ie Microsoft ActiveSync 4 5 Microsoft ActiveSync 4 5 Welcome to Microsoft ActiveSync 4 5 Setup Click Next to install Microsoft ActiveSync 4 5 on your computer 4 On the following screen click the Next button ig Microsoft ActiveSync 4 5 License Agreement Please read the Following license agreement carefully MICROSOFT SOFTWARE LICENSE TERMS MICROSOFT ACTIVESYNC 4 5 These license terms are an agreement between Microsoft Corporation or based on where you live one of its affiliates and you Please read ther They apply to the software named ab
31. operation alleviating the system of the 8 individual read operations that would occur without the binder Comfile Technology Inc CUPANEL User s Manual 44 of 64 Events and Event Handling Most graphical user interfaces facilitate their interactivity through the use of events and event handlers An event defines a specific condition that has occurred e g a button was clicked a variable changed a timer ticked etc An event handler is an action or series of actions to perform when the event occurs i e an event handler handles the event The CUPANEL Editor uses the Event Handler Control to bind events and event handlers to facilitate this functionality Event Handler Add Associate actions with events Event When Page Loaded When Page Loaded When Timer Ticked When Variable Changed When Button Clicked The Event Handler Control is capable of handling four different events When Page Loaded Occurs whenever a Page is shown on the screen When Timer Ticked Occurs whenever a timer s interval elapses When Variable Changed Occurs whenever a variable s value is updated When Button Clicked Occurs whenever a button is pressed is Action Edit action for this event Condition W No condition EA Action Type Set Variable hal Set Variable Set Multiple Variables Jump to Page Add to Remove from Logger Add to File Start Timer stop Timer Write to PLO Access Trend Graph Change Tex
32. or Use 2GB User Program Space SD Card CE KCC FCC Certified 10 2 Color TFT LCD Touch Screen 2 6 Million Colors Bezel type Case Indoor Use 2GB User Program Space SD Card CE KCC FCC Certified CPB102A Comfile Technology Inc CUPANEL User s Manual 7 of 64 Cnapter 2 Getting Started Comfile Technology Inc CUPANEL User s Manual This chapter will explain how to connect the CUPANEL touch controller to a PC and PLC install the necessary software and create a sample user interface Connecting the CUPANEL to a Personal Computer PC In order to create user interfaces for the CUPANEL you will need to connect the CUPANEL to a desktop laptop or other type of personal computer To connect a PC to the CUPANEL Microsoft s ActiveSync Windows XP or Windows Mobile Device Center Windows Vista and Windows 7 must be installed on your PC If your PC is running Windows XP follow the ActiveSync installation instructions in the Software Installation chapter If your PC is running Windows Vista or Windows 7 follow the Windows Mobile Device Center installation instructions in the Software Installation chapter 1 Once ActiveSync or Windows Mobile Device Center is installed turn the CUPANEL on and connect the CUPANEL touch controller to the PC with a USB Cable Language Selection Select Your Language 2 Turn on the touch controller and a dialog box will appear asking you to make a language selection M
33. ove which includes the media on which vou received it if any The terms also apply to any Microsoft hall I accept the terms in the license agreement O I do not accept the terms in the license agreement 5 Read the license agreement and if you agree accept the license agreement and click the Next button Comfile Technology Inc CUPANEL User s Manual 49 of 64 i Microsoft ActiveSync 4 5 Customer Information Please enter your information User Mame Comile Technology Organization Comfile Technology 6 On the Customer Information dialog enter the appropriate information in the User Name and Organization text boxes Then click the Next button ig Microsoft ActiveSync 4 5 Destination Folder Click Next to install to this Folder or click Change to install to a different Folder Install Microsoft ActiveSync 4 5 Eo CiProgram Files Microsoft ActiveSync volume Disk Size Available Required Differences ac 3965 BE 3606 34MB J6G E 7 On the Destination Folder dialog accept the default or change the destination folder Then click the Next button Comfile Technology Inc CUPANEL User s Manual 50 of 64 i Microsoft ActiveSync 4 5 Ready to Install the Program The wizard is ready to begin installation Setup is ready bo begin installing Microsoft ActiveSync 4 5 inal 8 A dialog will appear telling you that
34. r WFrxData Prset gage dat 7 The installation program will then begin copying the necessary files to your computer Wait for it to finish 5 Setup CuPanel Editor Completing the CuPanel Editor Setup Wizard Setup has finished installing CuPanel Editor on your computer The application may be launched by selecting the installed Click Finish to exit Setup 8 When the installation is finished the following screen will appear You can now run the CUPANEL editor Click the Finish button Comfile Technology Inc CUPANEL User s Manual 63 of 64 pm J CuPanel Editor v3 08 Ls Je 2 Page Settings Add Page 9 When the CUPANEL Editor is run the CUPANEL Editor s main window will appear Comfile Technology Inc CUPANEL User s Manual 64 of 64
35. r time on an x y coordinate plane It has a rich set of features including multiple channels colors and scale adjustments 10 Keypad 3 lt G CLEAR 9 ENTER CANCEL The Keypad Control is used to accept arbitrary numeric input from the user Comfile Technology Inc CUPANEL User s Manual 30 of 64 CUPANEEL COMFILE The Image Control is a purely aesthetic control It is used to add logos backgrounds photographs or any other graphic to the canvas to visually enhance the user interface 12 Text The Quick Brown Fox Jumped Over The Lazy Dog The Text Control is used to add messages labels or any other text to the user interface It has a rich set of customizations that include font size color and alignment 13 Watcher The Watcher Control is used to continuously read from a PLC or other electronic device monitoring the device s state and updating the user interface accordingly It accomplishes this by setting variables based on values read from the PLC It is functional only and is therefore not displayed on the user interface at runtime 14 Timer The Timer Control is used to create periodic events e g an event every n seconds Using the Event Handler Control actions can be attached to these events so they are performed whenever the Timer ticks i e Timer s interval elapses A common scenario is writing to a PLC every n seconds the Timer would be used to define the time interval n and th
36. s can also be configured a View Communication State Check this checkbox to show a communication status message in the upper left corner of the screen b Enable entering setup mode while operating If checked this feature enables the ability to enter setup mode at any time by touching the upper right corner of the screen 5 times If this is not checked you scan still enter setup mode by touching anywhere on the screen when the CUPANEL splash screen appears on startup c Clean Project Removes any projects that have been downloaded to the touch panel d Touch Calibration Runs the touch screen calibration application e Select Language Displays of list of user interface languages to select from If the correct physical connections and software configurations have been made the CUPANEL will then be able to communicate with a PLC Comfile Technology Inc CUPANEL User s Manual 13 of 64 Creating a User Interface The previous sections explained how to connect the CUPANEL touch controller to a PC and a PLC This section will explain how to create a very simple HMI user interface download it to the CUPANEL touch controller and execute it as a standalone program that communicates with the PLC This demonstration will use the CUBLOC CB280 and the CUBLOC study board as the PLC Setting Up the CUBLOC First the CUBLOC must be programmed to receive commands from the CUPANEL In this demonstration the program will simply toggle an LED
37. t The Event Handler Control is capable of executing 10 different actions when an event occurs 1 Set Variable Updates a variable with a new value 2 Set Multiple Variables Update more than one variable with new values 3 Jump to Page Transition to a specific page 4 Add to Remove from Logger Add a message to the Logger or clear the log Comfile Technology Inc CUPANEL User s Manual 45 of 64 5 Add to File Append data to a specified file 6 Start Timer Make a timer begin counting 7 Stop Timer Make a timer stop counting 8 Write to PLC Write to a specific register on a PLC 9 Access Trend Graph Starts or stops a Trend Graph 10 Change Text Updates a control s text Each action has its own unique set of options as each action is unique in its functionality The Event Handler Control can also place a condition and a repeat limitation on the action The condition can be a formula restricting when the action can be executed The repeat limitation specifies how often an action can be performed Comfile Technology Inc CUPANEL User s Manual 46 of 64 Software Installation Comfile Technology Inc CUPANEL User s Manual Installing ActiveSync Windows XP If you are running Windows XP please perform the following procedure to install ActiveSync 1 Download ActiveSync At the time of this writing the latest version was 4 5 and could be downloaded from http www microsoft com windowsm
38. vide the ability to choose from a list of styles shapes and color gradients e h93 Controls that feature graphics of some kind will typically feature some color adjustment features such as hue and saturation those controls that feature built in images raster graphics or the standard red R green G blue B values for those controls that are drawn as shapes vector graphics Released Pressed Luminance 401 a Luminance 07b Remove Load Remove Black Transparent Black For those user interfaces that require complete customization custom images can be assigned to the controls The image above shows a button being customized to display a power symbol and to show differently when it s pressed or released The images can be further customized by adjusting their luminance brightness and can even treat black or white pixels as transparent Comfile Technology Inc CUPANEL User s Manual 36 of 64 X Axis Time No of Divisions E Subdivision s x 5 Division s Division Width 1 0 Second s Time text format Show every tick with fixed values Scrall by 1 Subdivision s Decimal Digits 1 e Show Title Finally there are controls like the Knob Slider Gauge and Trend Graph that show scales These scales can be customized to specify the number of divisions subdivisions range of values and even where or how the scale is drawn Comfile Technology Inc CUPANEL User s Manual 37 o
39. w Control s properties but the actual content of the popup window is created as a Page Drawing a Popup Window Control on the canvas defines size of the popup window and location where the popup window will display I m a popup window textbox OK button Cancel button a When drawing a Popup Window Control on the canvas the controls in the in the Page to be displayed will show as green dotted lines It may be necessary to reposition the controls on the Page to ensure they fit within the popup window Comfile Technology Inc CUPANEL User s Manual 32 of 64 18 Binder The Binder Control was created strictly for performance and efficiency reasons It performs I O read operations on behalf of multiple controls thereby reducing redundancy and improving I O performance It is functional only and is therefore not displayed on the user interface at runtime 19 Custom Control The Custom Control was created to provide a way to extend the CUPANEL Editor with custom functionality If you are interested in this feature please contact Comfile Technology Comfile Technology Inc CUPANEL User s Manual 33 of 64 Drawing A Control CuPanel Editor v3 11 File Edit Project Tools Help my L T i e i a a a i ae UN i t Ue A Pagel e 2 Click and drag the AAA control on the canvas 1 Select the control Fe 4 To draw a control on the canvas 1 Select the control from t
40. you are ready to install the program Click the Install button i Microsoft ActiveSync 4 5 Installing Microsoft ActiveSync 4 5 The program features you selected are being installed Please wait while the Setup Wizard installs Microsoft ActiveSync 4 5 This may take several minutes Status Writing system registry values 9 A new dialog with a progress bar will then appear showing the status of the installation Wait for it to complete Comfile Technology Inc CUPANEL User s Manual 51 of 64 ig Microsoft ActiveSync 4 5 Microsoft ActiveSync 4 5 Setup is complete The Setup Wizard has successfully installed Microsoft ActiveSync 4 5 Click Finish to exit the wizard Cancel 10 When installation is complete a dialog will appear saying Microsoft ActivSync 4 5 Setup is complete Click the Finish button show Details 11 ActiveSync is now installed and you should see the ActiveSync icon in your system tray If you double click the system tray icon the ActiveSync window will display showing a status of Not Connected Comfile Technology Inc CUPANEL User s Manual 52 of 64 ate ooa e 6 gt n a oe oe es 0 o s eoeeee 0190006 Be tte 12 Using a USB cable connect the CUPANEL to the PC You will probably hear a few sounds from the PC and the CUPANEL as the connection is established New Partnership Set Up a Partnership Before
41. you can synchronize information between your mobile device and this computer you must set up a partnership between them Would you like to set up a partnership I T Ores Set up a partnership so that can synchronize a information between my device and this computer dont want to synchronize information Set up my device as a guest so that can copy or move information between my device and this computer 13 ActiveSync will then prompt you to create a partnership between the PC and the CUPANEL Make your selection If you re not sure just choose No Then click the Next button Comfile Technology Inc CUPANEL User s Manual 53 of 64 Microsoft ActiveSync File View Tools Help Schedule Explore show Details y A po R 4 54 PM 14 ActiveSync will then show a status of Connected and the ActiveSync system tray icon will change indicating the CUPANEL is connected to the PC Click the Explore icon Comfile Technology Inc CUPANEL User s Manual 54 of 64 Installing Windows Mobile Device Center Windows Vista 7 If you are running Windows Vista or Windows 7 please perform the following procedure to install Windows Mobile Device Center 1 Download Windows Mobile Device Center At the time of this writing the latest version was 6 1 and could be downloaded from http www microsoft com downloads details asox Fam
Download Pdf Manuals
Related Search
Related Contents
Ektron CMS400 User Manual - Ektron Product Documentation Samsung 225MW Наръчник за потребителя Understanding Electronic Test Equipment PDF Catalogue FDU・FDUV(PDF/1137KB) DX1000/DX1000N/DX2000 Custom Display User's Manual presentacion talco catalogo_ES 3 - Advance italia Coretalk user guide for recruiters Copyright © All rights reserved.
Failed to retrieve file