openhmi-pe getting started rev dd).pdf · 2004-09-02 · this openhmi se/pe, application...

OpenHMI SE/PEProfessional Edition

Application DevelopmentGetting Started

Revision Description Date P/N

A Manual Released 10/99 340065(A)B Revision 01/00 340065(B)C Revision 03/00 340065(C)D Revision 06/00 340065(D)

Brand or product names are trademarks or registered trademarks of their respective owners.

Windows and Windows NT are registered trademarks of Microsoft Corp. in the United States and other countries.

This document is copyrighted by Xycom Automation, Incorporated (Xycom Automation) and shall not be reproduced or copiedwithout expressed written authorization from Xycom Automation.

The information contained within this document is subject to change without notice. Xycom Automation does not guarantee theaccuracy of the information.

Table of Contents

iii

Table of Contents1. – Welcome to OpenHMI™ SE/PE for Windows® CE .................................... 5

Related Manuals ..................................................................................................................................................... 5Text Conventions Used in this Manual .................................................................................................................... 6

Mouse and Selection Conventions ....................................................................................................................... 6Windows Conventions......................................................................................................................................... 6

System Requirements.............................................................................................................................................. 7Configuration Package Contents ............................................................................................................................. 7OpenHMI SE (Standard Edition) Features ................................................................................................................ 8OpenHMI PE (Professional Edition) Features ........................................................................................................... 8OpenHMI SE/PE Software Installation..................................................................................................................... 9

Installing DesignStudio from the Installation CD-ROM......................................................................................... 9Creating Installation Floppy Disks ...................................................................................................................... 10Installing DesignStudio from Floppy Disks .......................................................................................................... 12

Starting DesignStudio............................................................................................................................................ 13Uninstalling OpenHMI SE/PE DesignStudio ........................................................................................................... 14

2. – Creating an Application and Configuring an I/O Driver ......................... 17Overview of the DesignStudio Interface ................................................................................................................ 17Creating a New Application .................................................................................................................................. 20Installing an I/O Driver ......................................................................................................................................... 21Creating a Display Screen...................................................................................................................................... 25

Inserting the screen........................................................................................................................................... 25Adding objects to the screen............................................................................................................................. 27

Adding a switch/pushbutton ......................................................................................................................... 27Adding a slider .............................................................................................................................................. 30Adding input/output text .............................................................................................................................. 32Adding a bitmap ........................................................................................................................................... 33Adding a bar graph ....................................................................................................................................... 34Adding a blinking light .................................................................................................................................. 36

Testing the Application ......................................................................................................................................... 37Downloading the Application to the Runtime Workstation .................................................................................... 38

Running the Application on your Development Computer ................................................................................. 38Connecting to the Runtime Station via Ethernet Cable ....................................................................................... 39Connecting to the Runtime Station via Serial Cable............................................................................................ 39Downloading the Application............................................................................................................................. 40

Reaching Technical Support .................................................................................................................................. 43Internet Access.................................................................................................................................................. 43E-mail................................................................................................................................................................ 43FAX................................................................................................................................................................... 44FAX-On-Demand System .................................................................................................................................. 44

5

1. – Welcome to OpenHMI™ SE/PE forWindows® CE

Welcome to the quickest and easiest way to create human-machine interface (HMI)applications for the Microsoft® Windows® CE operating system. Using OpenHMI™ SE/PEyou, the application developer, can create powerful, full-featured applications that exploitthe key features of Microsoft Windows CE.

The OpenHMI SE/PE application software consists of two parts: the development system(software running on a desktop, laptop, or industrial PC) and the runtime system (softwarerunning on an operator interface workstation). The runtime software is preloaded on theOpenHMI SE/PE workstation. You use the OpenHMI SE/PE development software,DesignStudio, on the development PC to create OpenHMI SE/PE application. Theapplication consists of animated operator-interface screens, configured drivers for the PLCsor other I/O devices to be controlled, a database of tags used in the application, andoptional modules such as alarm logic, trend charts, recipes, schedulers, and a securitysystem. The application can connect to industrial I/O systems and other Windows applicationsin the runtime environment.

After you complete an HMI application in DesignStudio, you download it to the runtimeworkstation and run it with the OpenHMI SE/PE runtime software. The workstationprocesses scanned data from connected devices according to parameters defined in theapplication and can react to, display, store, and upload the data.

This OpenHMI SE/PE, Application Development Getting Started manual is designed forfirst-time users of DesignStudio. Its objective is to allow you, the user, to quickly familiarizeyourself with the basic functions of DesignStudio.

• Chapter 1 contains basic information, installation, and uninstallation.

• Chapter 2 contains a tutorial that leads you through driver configuration and thecreation of a simple application.

This manual is written with the assumption that you are familiar with the Windows NTenvironment. If you are unfamiliar with Windows NT, we suggest that you select Help fromthe Windows desktop Start menu before you continue to work through this guide.

Note: Applications built with OpenHMI SE/PE software can only run on a XycomAutomation OpenHMI SE/PE workstation.

RELATED MANUALS

The OpenHMI SE/PE, Application Development Technical Reference manual is a morecomplete reference for DesignStudio. The OpenHMI SE/PE, Runtime Quickstart Guidemanual provides information on setting up an OpenHMI runtime workstation. The 3400Series, Hardware Reference and 3406 Workstation, Hardware Reference manuals providespecific runtime workstation hardware information.

6

TEXT CONVENTIONS USED IN THIS MANUAL

Throughout this manual certain terms are formatted in ways that indicate what type ofobject is being described. Some information is also segregated from the main text to helpyou to quickly read through this manual.

Titles, labels, and messages, other than those listed above, are indicated by italic text.Computer filenames and text to be entered by the user will appear a monospace font.Specific items that involve operator input (such as the Start menu button) and keyboardkeys (such as Enter) appear in a narrow bold typeface. Some other text (such as the wordNote) is bolded to emphasize it and draw your attention to it.

Some text is segregated into Note and Caution boxes. Notes contain extra informationthat may make it easier to understand the nearby text, especially the text just before thenote. Cautions contain information necessary to prevent damage to the OpenHMIdevelopment station or workstation.

Mouse and Selection ConventionsA mouse isn’t the only pointing device; there are also keystrokes, touchscreens, etc. MostPCs used for application development will be running a version of Windows with a mouse,so this manual is written assuming mouse use. Generally, a PC mouse is set up so that theleft mouse button is the primary button and the right mouse button is the secondarybutton. Select and click refer to clicking on an object or item with the left (primary) mousebutton. Double-click refers to clicking twice rapidly on an object with the left mousebutton. Right-click refers to clicking on an object with the right (secondary) mouse button.

Select may also be used to indicate highlighting or specifying an item on the computerscreen with your pointing device. Selection with a touchscreen is usually the same asselection with a mouse, except that your finger is used to touch a screen object or section.Selection with a keyboard usually involves use of the Tab key to move around options, useof the Enter key to open menus and lists and to replace the double-click, and use of the Altkey and an underlined letter to select an object that has an underlined letter.

Dragging is holding down the appropriate mouse button after clicking, and moving themouse. Usually an outline of the object will move with the mouse pointer or the outline ofa shape will be defined by the movement of the mouse.

Windows ConventionsDialogs, or dialog boxes, are windows that allow you to input information. Text boxes arespaces in windows where text can be typed. A radio button is a white circle in which ablack dot appears or disappears when clicked by the mouse. A check box is a white squarein which a check appears or disappears when clicked by the mouse. Lists are panes (whiteboxes) in windows that contain many selectable options. Drop-down lists have arrows thatcan be clicked to show part or all of an otherwise concealed list.

In this manual, interface refers to the entire DesignStudio window. Dockable windows arewindows that can be dragged to an edge of the interface and merge with that edge.Toolbars are dockable windows that contain only buttons and text boxes. Buttons areicons in boxes that appear to be pressed when selected.

1– Welcome to OpenHMI™ SE/PE for Windows® CE

7

SYSTEM REQUIREMENTS

To develop an OpenHMI SE/PE application with the DesignStudio software, werecommend the following hardware and software:

• IBM-compatible computer with an Intel® 486 DX-compatible processor (minimum)

• Windows NT/95/98 operating system

• MS Internet Explorer 4.0. If you don't have this version, you can install the necessaryfiles by running the file 40comupd.exe found on the installation CD.

• Minimum of 32 MB of random-access memory (RAM)

• 30 MB of free hard disk space is required for the program without any applicationprograms; more is recommended

• 3.5" floppy drive

• CD-ROM drive (can be on a different computer)

• Standard keyboard with function keys F1 through F12

• Parallel printer port (optional)

• 100% IBM-compatible VGA or SVGA display adapter with 1 MB Video RAM (VRAM)

• Microsoft-compatible pointing device (e.g., mouse, trackball, joystick, touchscreen)

• One or two COM ports and adapters for downloading applications (optional)

• Ethernet connection for downloading applications (optional)

To run a developed application, you must have an OpenHMI SE/PE runtime workstationwith a runtime license.

CONFIGURATION PACKAGE CONTENTS

In addition to this Getting Started guide, your configuration package should contain thefollowing items:

� Read Me First sheet

� OpenHMI SE/PE Software (CD labeled OpenHMI SE/PE DesignStudio)

� Null modem serial cable

� Crossover Ethernet cable

� Registration card

� Documentation and Support Library CD-ROM

� OpenHMI SE/PE, Application Development Getting Started manual

8

OPENHMI SE (STANDARD EDITION) FEATURES

OpenHMI SE is the standard version of the OpenHMI for Windows CE family. It supportsthe following features:

• An integrated Windows environment with toolbars, dialogs, and menus.• Graphic operator instruments like pushbuttons, meters, sliders, switches, text and numeric

displays, and LED-style indicators.• Drawing functions to create custom displays.• Bitmap graphics importing.• Background bitmap layer creation and editing.• Application language translation.• Alarming, annunciation, and acknowledgement.• Real-time trending with up to eight variables.• Logical expressions and a scripting language with over 100 functions.• Screen and object password-protected runtime security (256 levels)• Online remote configuration and serial or Ethernet download capability• TCP/IP networking.• OPC I/O client support and drivers.• Database symbol import from Xycom Automation's ASIC-200, ASIC-300, and OpenCNTRL

PC-based control packages.• 1000 tag runtime.

Note: Features that are supported by OpenHMI SE/PE applications, but not byOpenHMI SE applications, will be pointed out by a note and the symbol to the left.

OPENHMI PE (PROFESSIONAL EDITION) FEATURES

OpenHMI SE/PE is a more full-featured version of the OpenHMI for Windows CE family. Inaddition to the features listed above for OpenHMI SE, it supports the following features:

• User-configurable screen object animation effects.• Historical trending and data logging.• Custom report generation to files.• Recipe file management.• Alarm date logging.• Event-driven math worksheets.• Event scheduler based on date, time, or data condition.• 4000 tag runtime.

Note: Features that are supported by OpenHMI SE/PE applications, but not byOpenHMI SE applications, will be pointed out by a note and the symbol to the left.


9

OPENHMI SE/PE SOFTWARE INSTALLATION

DesignStudio runs on the Microsoft Windows NT operating system. The installationprogram creates directories as needed, copies files to your hard drive, and creates theDesignStudio icons in a desktop folder. DesignStudio is packaged on a CD-ROM. You mayinstall the program from this CD-ROM or create installation 3.5" floppy disks.

There are four software components that can be installed from the DesignStudioinstallation CD-ROM.

• DesignStudio – You need to install DesignStudio to create OpenHMI SE/PEapplications. Installation instructions are given below for installing this programfrom the installation CD-ROM or from floppy disks.

• MS Internet Explorer 4.0 – This is not the full version of Microsoft Internet Explorer,but is instead .dll files necessary for DesignStudio installation. Install the40comupd.exe program only if you do not have version Microsoft InternetExplorer 4.0 or higher already installed on your computer. If you get message duringDesignStudio installation about not having the correct version of a .dll file, youwill need to install this program. If you need to install software with floppy disks,copy the 40comupd.exe file from the MSIExplore40 folder.

• Adobe Acrobat Reader – Install this program if you do not already have version 4.0 orhigher installed on your computer. You will need this reader in order to open thedocumentation .pdf files. If you need to install software from floppy disks, you willneed to find a way to install the reader. It is too large for a single floppy disk.Possible ways to install it include downloading it from the Adobe website andzipping and spanning the file across several disks.

Note: You will need Administrator privileges on a Windows NT workstation in order to beable to install any software, including DesignStudio.

Note: If you want to install DesignStudio from the CD-ROM and if your laptop or PC doesnot have an internal CD-ROM drive, make sure that you have a portable CD-ROM driveattached to the appropriate port and powered on and that you have the appropriate devicedrivers installed.

If you are installing from 3.5" floppy disks and you are not sure how to create theinstallation disks from the OpenHMI SE/PE CD-ROM, please follow the instructions in thesection titled Creating Installation Floppy Disks (p. 10). When you are finished, installDesignStudio following the instructions in the section titled Installing DesignStudiofrom Floppy Disk (p. 12).

Note: You may install a newer version of DesignStudio over an older version. Werecommend that you uninstall the older version first (see p. 14).

Installing DesignStudio from the Installation CD-ROM1. Power up the development computer and make sure that no programs are running.

2. Insert the installation CD-ROM into the CD-ROM drive or the first installation floppydisk into the 3.5" disk drive.

10

3. An autorun.inf file will run and a setup window will open. If the autorun.inf filedoesn't start, you can manually start it in Windows Explorer.

4. A Setup dialog box will inform you that the InstallShield® Wizard is loading, then the firstinstallation window will prompt you. Follow the instructions on the screen to proceedwith the installation. Read the Welcome screen and press Next > if you have satisfied itsconditions.

5. Read the license agreement. To accept the license agreement, choose Yes, I acceptagreement and select OK. You must accept the license agreement to continue with thesoftware installation.

6. At the CDKey window CD Key text box, enter the 18-digit registration number from thesticker affixed to your CD jewel case. After you have typed the eighteenth character,the OK button will become active. Select it to proceed. If you do not have a registrationnumber, you will be unable to install DesignStudio.

7. At the Choose Destination Location screen, select Next > unless you have a reason notto use the default file folder location. You can browse to a location and specify anonexistent folder that will then be created by the setup utility. If you do this, wesuggest that you name the folder DesignStudio.

8. At the Setup Type screen, choose the Typical radio button unless you have a reason tochoose the other options; select Next >.

9. At the Select Program Folder screen, select Next > unless you have a reason not to usethe default file folder name. The installation program will begin to copy program filesto your hard drive.

10. When prompted to restart Windows, you should select the Yes, I want to restart mycomputer now radio button and select OK.

11. When the computer has restarted, go to Starting DesignStudio (p. 13).

Creating Installation Floppy Disks1. Locate a computer with functioning CD-ROM and 3.5" floppy drives.


11

2. Insert the DesignStudio CD-ROM into the CD-ROM drive, close the setup window, andopen the contents of the CD-ROM in the My Computer window or in Windows NTExplorer (in the Programs submenu of the Start menu).

Note: These functions are documented in your Windows NT help. Please consult theWindows NT help if you have difficulty executing these steps.

3. Open the Install folder and determine how many disks you will need to format bylooking at the number of Disk<number> folders or the highest <number> value. Thisnumber will be referred to as N in the rest of these instructions. Example: If Disk12 isthe highest numbered folder, there will be 12 folders and N is 12.

4. Format the required number of 3.5" floppy disks and label them appropriately. (Wesuggest DesignStudio Installation Disk 1/N through DesignStudio InstallationDisk N/N.)

Note: You can format disks by double-clicking the My Computer icon (this may have adifferent name on your desktop), selecting the 3½ Floppy (A:) icon, selecting File thenFormat…, and following the directions in the Format A:\ dialog box.

5. Copy the contents of each folder into the appropriate disk. Example: Copy thecontents of the Disk1 folder to DesignStudio Installation Disk 1/N.

Note: Select the top file in the folder with the left mouse button, then hold downthe Shift key and tap the down arrow key (↓) until all files are selected. Click anddrag the selected files to the 3½ Floppy (A:) icon or right-click on the selected files,select Copy, right-click on the destination (3½ Floppy (A:)), and select Paste.

Note: You can write-protect your floppy disks by pushing up the movable plastic tabon the back of the disk (upper left corner), leaving an open rectangular hole throughthe disk. It is always a good idea to write-protect installation floppy disks.

6. Go to the next section to install DesignStudio from floppy disks.

12

Installing DesignStudio from Floppy Disks7. Follow the directions in the previous section to make the installation floppy disks.

8. Power up the development computer and make sure that no programs are running.

9. Insert the disk labeled DesignStudio Installation Disk 1/N (see previous section).

10. Select the Start button on the Taskbar, then select Run.

11. The Run dialog box will appear. If X:\Setup appears in the Open text box, press Enteror select OK. If it does not appear, type X:\Setup and press Enter or select OK. (Xidentifies your drive; it will usually be A for your 3.5" disk drive.)

12. A Setup dialog box will inform you that the InstallShield® Wizard is loading, then the firstinstallation window will prompt you. Follow the instructions on the screen to proceedwith the installation. Read the Welcome screen and press Next > if you have satisfiedthe listed conditions.

13. Read the license agreement. To accept the license agreement, choose Yes, I acceptagreement and select OK. You must accept the license agreement to continue with thesoftware installation.


13

14. At the CDKey window CD Key text box, enter the 18-digit registration number from thesticker affixed to your CD jewel case. After you have typed the eighteenth character,the OK button will become active. Select it to proceed. If you do not have a registrationnumber, you will be unable to install DesignStudio.

15. At the Choose Destination Location screen, select Next > unless you have a reason notto use the default file folder location. You can browse to a location and specify anonexistent folder that will then be created by the setup utility. If you do this, wesuggest that you name the folder DesignStudio.

16. At the Setup Type screen, choose the Typical radio button unless you have a reason tochoose the other options; select Next >.

17. At the Select Program Folder screen, select Next > unless you have a reason not to usethe default file folder name. The installation program will begin to copy program filesto your hard drive.

18. You will be prompted for the next disk in a Setup Needs The Next Disk dialog box.Insert the correct disk into the disk drive and select Enter.

19. When prompted to restart Windows, you should select the Yes, I want to restart mycomputer now radio button and select OK.

20. When the computer has restarted, go to Starting DesignStudio (p. 13).

STARTING DESIGNSTUDIO

1. Double-click the DesignStudio shortcut icon on the desktop or select Programs fromthe Start menu, then select DesignStudio in the DesignStudio Tools submenu.

2. Select OK to acknowledge the Warning window message.

14

UNINSTALLING OPENHMI SE/PE DESIGNSTUDIO

Should you find it necessary to remove OpenHMI DesignStudio from your system, followthe instructions shown below:

1. Select the Start button on the Taskbar, select Settings, and then select Control Panel toopen the Control Panel window.

2. Double-click the Add/Remove Programs icon in the Control Panel window.

3. In the Add/Remove Programs Properties window select DesignStudio in the lowerpane list and then select the Add/Remove… button.

4. At the Confirm File Deletion dialog, select the Yes button.


15

5. The Uninstall Shield Wizard and the Remove Programs From Your Computer dialogwill open. When the message Uninstall successfully completed. appears, the OK button willbecome active. Select it.

6. You will see that DesignStudio is no longer in the lower pane of the Add/RemovePrograms Properties window. Close the window with the Cancel button or the closebutton ( ), then close the Control Panel window.

7. Open the Windows Explorer and browse to the directory that contained theDesignStudio directory.

8. Make sure that all of the DesignStudio files and folders have been deleted. Manuallydelete any that are left.

2 – Creating an Application

17

2. – Creating an Application andConfiguring an I/O Driver

This chapter starts with an overview of the DesignStudio interface followed by step-by-steptutorials in which you will configure an I/O driver and then go through the process ofcreating a working OpenHMI SE/PE application. For more detailed technical informationrefer to the OpenHMI SE/PE, Application Development Technical Reference manual.

This chapter is written with the assumption that you are familiar with Windows NT. If youare not, we suggest that you select Help from the Windows NT desktop Start menu beforecontinuing.

OVERVIEW OF THE DESIGNSTUDIO INTERFACE

When you start DesignStudio you see a screen that looks like this when maximized.

On startup, a grid on a white background in the workspace area and a toolbar on the rightside of the interface appears, indicating that there is an open screen. In the interface menubar, select File, then Close. The screen will close and the interface will look like thefollowing picture.

18

The blank darker gray area is your workspace. The rest of the interface below the toolbarsis taken up with dockable windows. The Workspace dockable window is located on the leftside of the interface, the Database Spy dockable window is located on the bottom of theinterface below the Workspace window, and the Output dockable window is located on thebottom edge and to the right of the Database Spy window.

If you right-click the mouse in most of the interface, you will get a popup menu that allowsyou to remove or replace items in the interface. When an item is checked or appears to bea depressed button, it is open and usable in the interface. Review the menus below. Themenu on the left appears if you right-click without opening a screen. The menu on theright appears if there is an open screen in the workspace (see Creating a Display Screenbelow).

The first three buttons of the popup menu can be used to toggle on or off the dockablewindows. Both menu images show that all three are open on the interface. These threebuttons also appear in the Standard toolbar at the top of the interface.

The lower set of check boxes toggles the appearance of the interface toolbars.

The Standard toolbar is located atthe top left of the interface.

DatabaseSpy

Workspacewindow

OutputWindow

Workspace


19

The Tag Properties toolbar is located to theright of the Standard toolbar.

The Execution Control toolbar is located at the topright of the interface.

The Tools toolbar is visible only if there is an open screen being edited. �It covers the right edge of the interface.

The Tools toolbar can be toggled to a different configuration �with bitmap editing tools that affect the display screenbackground layer, with the Change Toolbar button. �

Note: The Execution Control toolbar may appear below theStandard toolbar instead of its normal position. If this happens,select the double bars at the left end of the toolbar and drag itto the empty space to the right of the Tag Properties toolbar.This will increase the workspace size below the toolbars.

20

CREATING A NEW APPLICATION

1. On the top menu bar, select File, then New…. In the New dialog, select the Project tab.

2. Type the name of your application in the Application name box. The name for thisexample is GetStart. The application file automatically will be assigned a newdirectory of the same name in the Configuration file box. Select Browse to put this filesomewhere other than the root directory, if desired.

Note: Because not every program supports extended file names, we suggest you usefile names eight characters or less in length.

3. Select OK to save your changes. The Project Wizard dialog will appear. Select EmptyApplication and the 320 x 240 radio button, and select OK. This screen size can be seen onany monitor without closing any windows.


21

4. The Workspace window will now display the name of this new application file.

The next sections show you how to configure the I/O drivers for the application and howto set up a display screen.

INSTALLING AN I/O DRIVER

The OpenHMI SE/PE runtime software preloaded on your runtime workstation acquiresthe data values from PLCs and other I/O devices through I/O drivers. This section detailsI/O driver selection and configuration.

1. In the Workspace window, select the Comm tab.

2. Right-click the Drivers folder. A menu will appear with an Add/Remove drivers choice:

3. Select Add/Remove drivers and a Communication drivers dialog will appear:

4. Select the desired driver in the Available drivers list and then click the Select >> button.The driver will disappear from the Available drivers list and appear in the Selected driverslist. To remove a driver from the Selected drivers list, select it and click the >> Removebutton. For this demonstration, we are using the ModBus Protocol RTU/ASCII driver. Selectthe driver, then select OK to close the window and save your changes.

Note: You may also move specific drivers between the Available drivers and Selecteddrivers lists by double-clicking them.

22

Note: Other drivers have other parameters. If you need help with a driver, contact thePLC manufacturer or contact Xycom Automation (see Appendix A).

5. A boxed plus will appear beside the Drivers folder. Select the plus or double-click onthe Drivers word or folder and the folder will open and display subfolders for anyadded drivers. In this case a MODBU subfolder will appear. Right-click the MODBU folderand a menu with Insert and Settings choices will appear.

6. Select Settings. A Driver: Communication Parameters (Driver is MODBU in this case)dialog will appear. For this example, leave the default values. Station is the number ofthe development station and is fixed at 0. Leave this box blank or put 0 in it.

7. Type ASCII or RTU in the Protocol (ASCII or RTU) text box, which is specific to thisdriver. Custom Command (ERO:xxx) is also specific to this driver and enables the use ofthis driver with Ero equipment. Leave this text box blank.

8. Select Advanced. Leave all values at their default levels for this example and selectCancel. Select OK in the MODBU: Communication Parameters dialog to exit.


23

9. Right-click the MODBU folder again and select Insert. A window titled Modbu001.drvwill open in the workspace. There are no default values in this window. The window isdivided into two parts: a gray header with several fields and the body (which is in theform of a worksheet). Enlarge the Modbu001.drv window by selecting the maximizebutton ( ) in the upper right corner.

Note: This Modbu001.drv window, like several other windows, has minimize ( ),maximize ( ), and close ( ) buttons in the upper right-hand corner. If you select themaximize button, this window will fill any available space not taken up by taskbars andwindows. When maximized, the three buttons will not show up at the upper right-hand corner of the window, they will show up at the upper right-hand corner of theDesignStudio interface directly under the similar set of buttons for the interface.

10. In the header, type ExModbus in the Description box. Then type 1 in both the EnableRead When Idle and the Enable Write on Tag Change boxes. These are boolean values—1 isyes and 0 is no. Station is the number of the I/O device to be accessed by this driver.Most such lists start with one; put 1 here.

11. The Header box format in the Modbu001.drv window is driver specific. The format for aModBus protocol is <reference for the type of register>:<intialoffset for the first stored value>. Reference values are shown below.

ReferenceReferenceReferenceReference Type of RegisterType of RegisterType of RegisterType of Register

0X Coil Status

1X Input Status

3X Input Registers

4X Holding Registers

ID Slave ID Report

Example: 3X:10 signifies the input registers, with an offset of ten.

12. Type any one of the reference values into the Header box.

24

13. The spreadsheet at the bottom of the window lists the I/O tags. Type Sample0 in thefirst cell and tab to the next cell. Sample0 is a new tag, so a Question window appears.Select Yes and a New Tag window appears. This is a demonstration, so select OK toaccept the default parameters of Size 0 and Type Integer.

Now the cursor is in the second cell. Type 0 in this cell, because this is the offset forthe first data point. Tab to the next cell. The number in this Div column is the numberby which the initial value for Sample0 will be divided; type 10 here. The Add column isthe number that will be added to this divided number; type 2 here. For example, avalue of Sample0, from the I/O device, of 100 will be divided by 10 and 2 will be addedfor a final value of 12.

Tab to the next cell and repeat the same procedure for Sample1. The offset in theAddress column should be incremented by one to 1.

Note: You can also scale tag values to upper and lower limits. See the documentationfor more information.

14. Select the Modbu001.drv window exit button in the upper right corner to close thiswindow. Select Yes at the next window to save these changes. Select OK at the Save Aswindow.


25

15. This sheet will be saved in the MODBU folder. It is named 1: ExModbus, because it issheet one and because the text in the Description box is ExModbus. If you open theMODBU folder and right-click the sheet, a menu will appear with the options to Openthe sheet, allowing you to check or modify it, or to Delete the sheet.

16. Since the sample application developed in this tutorial does not use a driver, deletethe driver that you just added. Right-click the Drivers folder and select Add/RemoveDrivers.

17. Select the driver from the Selected drivers list and select >> Remove. Then select OK.The next section shows you how to create an application display screen.

CREATING A DISPLAY SCREEN

Note: Some objects in this screen can be created in OpenHMI SE applications and arenoted. Even if you have an OpenHMI SE application you can switch it to an OpenHMI PEapplication by changing the setting in the Target System field of the Options tab of ProjectSettings window opened in the Project 1 Settings menu.

An OpenHMI SE/PE application is a set of related windows or screens that are created inDesignStudio, the development environment. A window may occupy all or only a portion of thescreen as required by the application, but only one window may be displayed at a time in theWindows CE environment. Screens can be linked to and called from other screens. TheOpenHMI SE/PE runtime environment displays the screens and maintains communication links.

This part of the tutorial guides you through development of a simple HMI application. For moreexamples, look at the demo applications included with your software.

Inserting the screen

1. In the Workspace window, select the Graphics tab, right-click the Screens folder, andselect Insert.

26

2. A Screen Attributes window pops up. Type Example Display in the Description textbox and check the Enable Background check box to allow bitmaps to be used in thescreen background. Leave the Width box value at 320 and the Height box value at 240.Select the OK button.

3. The screen will appear in the gray workspace area of the interface. The Tools toolbarwill appear on the right side of the interface when the screen is inserted.

Note: Right-click any bare spot on the display screen and a menu pops up (see below).Select Screen Attributes to bring up the Screen Attributes window any time.

Note: The screen’s grid is there for layout purposes; it does not appear duringruntime. The Grid button on the Tools toolbar is used to toggle it on and off.


27

4. You may save the screen at any time by selecting the Save button on the Standardtoolbar or by selecting Save in the File menu. Type Screen1 at the File name prompt inthe Save As window and select the Save button.

5. A boxed plus appears beside the Screens folder in the Workspace window. Openingthe folder will show that Screen1.scr has been added to the folder contents. Right-click the screen file to see a menu with Open, Send to Library, or Delete options.

6. At this point, you should test the application (see the section titled Testing theApplication on p. 37).

Adding objects to the screen

Adding a switch/pushbutton

1. Select the Open Library button on the Standard toolbar to open the Library window.Select pushbtn in the list on the left side of the window, and double-click the on/offswitch pushbutton that is pictured below in the center of the window (the one withthe double line border that appears when the pointer touches a library object).

28

Note: You can also open the Library window with the Library symbol in the Graphics tabof the Workspace window. You can double-click it or right-click it and select Open.

2. The Library window will disappear when you double-click the switch. Select a spot onthe screen and a copy of the switch will appear. The eight tracker handles around itsignify that it is the selected object. Click-and-drag the switch to the spot in the displayshown below.

Now that you have an object on the screen, you can right-click it to get a menu:

Note: The black boxes can be used to resize an object. Move the mouse pointer over abox until arrows appear. Then click-and-drag to resize the box along the dimension(s)indicated by the arrows.

3. Right-click the switch and select Properties to open the Object Properties dialog. Selectthe drop-down list arrow and select Group of Symbols, then select the Replace… button.

Note: You may also open the Object Properties dialog by double-clicking the object.

The Object Properties dialog will change depending on which item is selected in thedrop-down list and depending on which buttons are active on the Tools toolbar.


29

If you click anywhere in the display that is not on an object, the Object Properties dialogwill disappear unless the check box at the upper left corner is selected, causing acheck to appear. Regardless of whether there is a check in this box, selecting the closebutton ( ) will close the dialog box.

Note: Select an object by clicking on it. An object or group of objects can also beselected by clicking and dragging a rectangular outline around the object(s).

4. In the white text box, replace BLINKSLOW with Auto. This replaces the tag associatedwith this pushbutton. Select OK.

5. Since Auto is a new tag, you will be prompted to create it and specify its properties. Inthe Question dialog, select Yes to create the new tag. In the New Tag dialog, selectBoolean in the Type drop-down list and select OK.

30

6. With the Replace dialog box open, select the Replace Strings tab. This tab allows you toreplace the character strings on the object. Type Aut in the text box to replace ON andMan in the text box to replace OFF. Select OK. The text on the switch will change.

7. If necessary, open the Object Properties dialog. Select Command in the drop-down list.Type Auto in the first Tag text box and NOT Auto in the first Expression text box.Select On Down in the drop-down list on the right and F1 in the Key drop-down list.

You have assigned the tag Auto to each click of the button on your screen. Selecting thebutton in the running (see the section titled Testing the Application on p. 37)application will toggle between Auto and NOT Auto. F1 will also toggle this value.

8. At this point, you should save the screen. You may also test the application (see thesection titled Testing the Application on p.37).

Adding a slider

1. Select the Open Library button to open the Library window, select sliders in the list, anddouble-click on the slider with the graduated scale shown below.


31

2. Position the mouse in your application screen and click. The slider will appear whereyou click. Move and resize it with the black boxes so that your screen looks like this:

3. Open the Object Properties dialog, select Group of Symbols on the drop-down list, andselect Replace…. Change #PV and AnalogValue_ to Analog1. When prompted,create the new integer tag Analog1. Select OK in the New Tag and Replace boxes.

4. At this point, you should save the screen.

32

Adding input/output text

1. Select the Text button on the Tools toolbar. Now place your cursor just below theswitch that you created earlier in this example. A blinking cursor will appear. Type anumber sign (#). Any text can be typed at the cursor, but only a number sign canbecome an input/output character in an application.

2. Now place your cursor just above the slider and type another number sign there.

3. Select the first number sign that you typed, below the switch, by highlighting it withyour cursor. Follow steps three and four to set the tag expression.

4. Select the Text Input/Output property button on the Tools toolbar. Open the ObjectProperties dialog and type Auto in the Tag/Expression text box. This ties the text outputto the value of Auto; the value of Auto (0 or 1) will be displayed in place of the numbersign when the application is running.

5. Select Text in the upper right drop-down list in the Object Properties dialog. Check theTransparent check box. Now the space around the text character is the same color asthe background. The same effect could be achieved by changing the BackColor, but theTransparent option is better because the light will change colors.

6. Select the number sign you typed above the slider by highlighting it with your cursorand follow steps three and four again, setting the tag expression to Analog1.



33

Adding a bitmap

1. Select the Change toolbar button on the Tools toolbar to change the Tools toolbar to itsbitmap-editing configuration. The screen will go blank. This is because you are nowediting the background of the screen. None of the previously inserted objects areeditable or visible while the bitmap editor Tools toolbar is toggled.

2. On the top menu bar of the DesignStudio interface, select Edit, then Paste from…. Inthe Open window, browse to c:\program files\designstudio (or the locationof DesignStudio that you designated during installation) by double-clicking folders inthe Folders window. Select the file xa_logo_2 color.bmp. After it appears in the Filename text box, select OK. The bitmap will appear at the upper left corner of the screen.

3. Click-and-drag the bitmap to the upper right corner of the screen.

4. Select the Change toolbar button again and the object-editing configuration of the Toolstoolbar will appear. The screen should now look like this:

34

Note: After you select the Change toolbar button to switch back to the object-editingTools toolbar, the bitmap will become a part of the background and not a separateobject that can be moved around. Make sure that you have the bitmap positionedproperly before you select the Change toolbar button.

5. At this point, you should save the screen and proceed to the next section to test theapplication.

Adding a bar graph

The following two screens, Creating a Bar Graph and Creating a Blinking Light,demonstrate color animation, which is a feature only available in OpenHMI PE. However,preconfigured LEDs and bar graphs can be added to applications from the DesignStudiolibrary for both OpenHMI SE and PE applications.

1. Go to the Tools toolbar and select the Filled rectangles button. Position the mouse atthe same height as the top of the slider and to the right of it, and select and drag themouse to form a narrow rectangle of approximately the same dimensions as therectangle in the center of the slider (see below).

2. Select the rectangle by double-clicking it, select the Bargraph button on the Toolstoolbar, and open the Object Properties dialog. Type Analog1 in the Tag/Expression textbox. This turns the rectangle you drew into a bar graph tied to the tag Analog1.


35

3. Select the Color Change button on the Tools toolbar. The Object Properties dialog willchange. Type Analog1 in the Tag/Expression text box. There are four Change Limit textboxes at the bottom of the dialog. Type 50 in the first, 75 in the one under that, and95 in the next. These are the threshold values of Analog1 at which the color next toeach Change Limit text box will be applied to the bar graph. Select each color box inturn and a Color dialog will appear. Double-click a green color for the first box, ayellow color for the second box, and a red color for the third box. When the value ofAnalog1 is less than 50, the color of the bar graph will be blue, the Foreground Colorspecified in the BarGraph Object Properties dialog (Step 2). At the value 50 the colorwill change to green, at 75 it will change to yellow, and at 95 it will change to red.


36

Adding a blinking light

1. Select the Ellipse button on the Tools toolbar, then select the display and drag themouse to form a circle over the number sign like the one shown below.

2. With the ellipse selected, select the Color Change button and open the ObjectProperties dialog. Type Auto in the Tag/Expression text box. This ties the switch tag tothe circle. Type 0 in the first change limit box and 1 in the second. These are the onlytwo values for Auto because it is a Boolean tag. Change the color for 0 to green and thecolor for 1 to red. Change the drop-down list beside the red box to SLOW. With theseparameters, the light will be green when the switch is at Aut (on) and it will be blinkingred when the switch is at Man (off).

3. In the Object Properties dialog, select Ellipse on the drop-down list. Check the Fill radiobutton and change the color to the same shade of green selected in the previous step.Now the light will blink red and green when the switch is at Man (off).

4. With the ellipse selected, select the Send to Back button on the Tools toolbar to causethe number sign to appear on top of the ellipse.



37

TESTING THE APPLICATION

1. On the top menu bar of DesignStudio, select Project, then Settings…, then the RuntimeDesktop tab. Type Screen1.scr in the Start-up screen text box, check the Menu checkbox if selected, and select OK. This makes Screen1.scr the default screen to beemulated and will start it with a CE runtime emulation menu bar.

2. Now select the Run Application button on the Execution Control toolbar. The CEViewemulation window should display the application. If you do this after first creating thescreen, you will see a blank white screen. If you do this after completing all of thesteps in the previous Creating a Display Screen section, you should see the screenbelow. If you select the switch, the switch should move, the light should change color,and the number in the light should change. You should also be able to move the sliderbutton with the mouse and watch the bar graph fill and change colors.

3. If you are using OpenHMI SE your screen will have a switch, a numerical display underthe switch, a slider and a numerical display over the slider. If you are using OpenHMIPE your screen will include a red flashing button with a numerical display, a bar graph,and a numerical display over the slider. OpenHMI PE users will also see the XycomAutomation bitmap at the upper right corner of the screen.

38

4. Select the Stop Application button to close the application.

Note: Sometimes, Background Tasks, Driver Runtime – Driver, or TCP/IP Server icons willremain running after the emulation window has closed. These icons are visible in thelower right-hand corner of the Windows NT desktop. Select the Stop Application buttonrepeatedly to close these icons or right-click them individually and select Exit.

5. You have now completed development of the test OpenHMI SE/PE application. Thenext section shows you how to download the application to the runtime workstation.

DOWNLOADING THE APPLICATION TO THE RUNTIME WORKSTATION

Decide whether you will run the application on a separate OpenHMI runtime workstationor on your development computer. If you are running the application on yourdevelopment computer go to Running the Application on your DevelopmentComputer. If you are downloading the application to an OpenHMI workstation using anEthernet cable or a serial cable, go to either Connecting to the Runtime Station viaEthernet Cable or Connecting to the Runtime Station via Serial Cable, respectively. Todownload the application after the development computer and the runtime workstationare connected, go to Downloading the Application.

Running the Application on your Development Computer1. Select the Execution Environment button on the Execution Control toolbar to open the

Execution Environment window.

2. Check the Local radio button and select Close. When you select the Run Applicationbutton, the application will run. It will appear in the CEView emulation window and youmust attach your I/O devices to the development computer.

Note: Local is the default setting that allows you to use the Run application button totest your application. If you select another choice in the Execution Environment window,you will be unable to use the Run application button to test your application on yourdevelopment computer.

Do not select a choice other than Local while the CEView emulation task is running.Doing this will stop the emulation but will not close the background tasks.


39

Connecting to the Runtime Station via Ethernet Cable1. Connect the development computer and runtime workstation using a crossover

Ethernet cable. One is provided with the OpenHMI SE/PE development package.

2. Follow the instructions in the OpenHMI SE/PE, Runtime Quickstart Guide manual toprepare the OpenHMI runtime station to receive the downloaded application.

3. Select the Execution Environment button on the Execution Control toolbar to open theExecution Environment window.

4. Select the Network IP radio button in the Target tab and type the runtime station IPaddress.

5. Go to the section titled Downloading the Application (p. 40).

Connecting to the Runtime Station via Serial Cable1. Connect the development computer and runtime workstation using a null modem

serial cable. One is provided with the OpenHMI SE/PE development package.

2. Follow the instructions in the OpenHMI SE/PE, Runtime Quickstart Guide manual toprepare the OpenHMI runtime station to receive the downloaded application.

3. Select the Execution Environment button on the Execution Control toolbar to open theExecution Environment window.

4. Select the Serial Port radio button in the Target tab and pick the appropriate COM portin the drop-down list.

40

5. Go to the section titled Downloading the Application.

Downloading the Application6. In the Execution Environment dialog, select Connect to connect to the runtime

workstation. When connected, the Status box will display Connected to CEVIEW <versionnumber>.

7. Select Install system files…. This installs and updates CEView files on the runtimeworkstation. When the Send to Target and Update Target windows close, select theApplication tab.

Note: The installation of system files can take several minutes.

Caution: Do not select Send To Target until you have specified a directory other thanthe root directory (the root directory is just a \ in the Target box). Sending theapplication to the workstation root directory will erase the Windows CE image (files)and render the computer inoperative until the Windows CE image is restored (3406)or reinstalled (3408, 3410, 3412).


41

8. Select the browse button and browse to the appropriate directory by double-clickingto open directories followed by double-clicking the appropriate directory so that itappears in the Current text box. (This is similar to moving through directories inWindows Explorer.) For the 3406 OpenHMI runtime workstation target, the directorythat holds the application subdirectory is \Storage Card\. For the 3408, 3410, and3412 OpenHMI runtime workstation targets, the directory is \Disk\. If you areupdating or reloading an application, you should then select the appropriatesubdirectory, which will have the same name as the application. Close the BrowseTarget Dialog Box. An example of a download directory is shown in the image above.If you are downloading a new application instead of updating an application, you mayneed to create a new directory.

9. You can do this by selecting the new directory button in the Browse Target dialog. Afteryou create the new directory you should select it so that it appears in the Current textbox. When you have the appropriate directory shown in the Current text box, select OK.The same directory will be shown in the Application tab Target text box.

10. After reading the Caution box under step 2, select Send To Target. After downloadingthe application, the Status text box message will be Application was updated with success.

Note: The Status text box shows the latest runtime workstation response to commandsgiven through the Execution Environment window.

42

11. You may Run or Stop the application on the runtime workstation from the ExecutionEnvironment dialog Application tab by selecting the appropriate button. You may alsoselect Close to exit the dialog and run the application independently on the runtimeworkstation. Before closing the Execution Environment window, you should disconnectthe runtime environment from the development environment using the Disconnectbutton in the Target tab. If you intend to test another application, you should alsoselect the Local radio button before closing the window. (See the Note in Running theApplication on your Development Computer for more information.)

Note: You do not need to stop a running application on the runtime workstation inorder to download an update or another application.

Appendix B – Technica l SupportREACHING TECHNICAL SUPPORT

Xycom Automation Technical Support offers a variety of support options to answer anyquestions on Xycom Automation products and their implementation.

In the USA (Saline, MI) 734.429.4971

800.ATXYCOM

In Canada (Mississauga, Ontario) 905.607.3400

In Northern Europe (Northampton, England) +44.1604.790.767

In Southern Europe (Turino, Italy) +39.011.770.53.11

Refer to the relevant chapter(s) in your OpenHMI SE/PE documentation for a possiblesolution to any problem you may have with your OpenHMI SE/PE system. If you find itnecessary to contact OpenHMI SE/PE Technical Support for assistance, please have thefollowing information ready:

1. Software serial number and workstation model number.

2. The version of OpenHMI SE/PE you are running.

3. The operating system type and version (i.e., Microsoft Windows NT version 4.0).

4. Exact wording of system error messages encountered.

5. Any relevant output listing from the Microsoft Diagnostic utility (MSD) or otherdiagnostic applications.

6. Details of attempts made to rectify the problem(s) and results.

7. The log number assigned from Xycom Automation Technical Support if this is anongoing problem.

8. The name of the Technical Support Engineer with whom you last spoke, if known.

Internet AccessXycom Automation provides both World Wide Web and e-mail access via the Internet. Toaccess the Xycom Automation Home Page, use http://www.xycomautomation.com. Thispage contains the newest product datasheets, OpenHMI SE/PE references by industrialsector, and application notes.

E-mailTo reach Xycom Automation Technical Support via email:

USA (Saline, MI) [email protected]

Canada [email protected]

Northern Europe [email protected]

Southern Europe [email protected]

44

FAXYou can fax your questions to Xycom Automation Technical Support at:

In the USA (Saline, MI) 734.429.1010

In Canada (Mississauga, Ontario) 905.607.0141

In Northern Europe (Northampton, England) +44.1604.790.722

In Southern Europe (Turino, Italy) +39.011.770.53.270

FAX-On-Demand SystemYou can request application notes and datasheets for a number of our products.

FAX-On-Demand 734.429.4971, extension 455

Xycom Automation, Inc.

734-429-4971 • Fax: 734-429-1010

http://www.xycomautomation.com

Canada Sales: 905-825-0281

Northern Europe Sales: +44-1604-790-767

Southern Europe Sales: +39-011-770-53-11

340065(D)340065(D)340065(D)340065(D)

openhmi-pe getting started rev dd).pdf · 2004-09-02 · this openhmi se/pe, application...

Documents