Effectiview Manual V1.2a
Effectiview Manual V1.2a
effectiView - User
Manual
Sitek S.p.A.
eV Manual
Ver. 1.00
Manual
Contents
1 Introduction ..................................................................................................................... 10
1.1 Getting Started ................................................................................................... 10
1.1.1 Documentation Conventions .............................................................................. 11
1.2 Project Development Steps ............................................................................... 12
1.3 Installing eV Designer ........................................................................................ 13
1.3.1 System Requirements ........................................................................................ 13
1.3.2 Software Installation eV Designer ...................................................................... 13
1.4 Using eV Designer ............................................................................................. 15
1.4.1 Main Menus ........................................................................................................ 15
1.4.2 Toolbars ............................................................................................................. 27
1.4.3 Project Manager ................................................................................................. 35
1.4.4 Screen Manager................................................................................................. 43
1.4.5 Popup Menus ..................................................................................................... 45
2 Creating Projects ............................................................................................................. 48
2.1 Project Information and Protection..................................................................... 48
2.1.1 The range limitation of the PanelMaster/eV Designer software ........................ 50
2.2 Global Settings ................................................................................................... 51
2.2.1 Languages ......................................................................................................... 52
2.2.2 Font Templates .................................................................................................. 53
2.2.3 Picture Database................................................................................................ 54
2.2.4 Sound Database ................................................................................................ 59
2.2.5 Text Database .................................................................................................... 61
2.3 Working with Tags.............................................................................................. 64
2.3.1 Types of Tags .................................................................................................... 64
2.3.2 Opening and Closing Tags Editor ...................................................................... 64
2.3.3 Creating Tags by Tags Editor ............................................................................ 65
2.3.4 Importing and Exporting Tags ............................................................................ 68
2.3.5 Adding/Deleting/Renaming Tag Groups ............................................................ 68
3 Creating Panel Applications ............................................................................................ 69
3.1 Setting up the Panel Application ........................................................................ 69
3.1.1 General Settings ................................................................................................ 70
3.1.2 Custom Settings ................................................................................................. 73
3.1.3 Activating Multiple Overlapped Buttons by One Touch ..................................... 75
3.1.4 Specifying Default Folder for File I/O ................................................................. 76
3.2 Working with Keys .............................................................................................. 78
3.2.1 Default Settings for the Panel Application ......................................................... 78
3.2.2 Settings for a Screen.......................................................................................... 79
3.2.3 Key Usage Table Settings ................................................................................. 80
3.2.4 Usage Settings for a Key ................................................................................... 82
3.3 Internal Memory ................................................................................................. 87
3.3.1 Types of Internal Memory .................................................................................. 87
3.3.2 Index Registers .................................................................................................. 87
3.3.3 System Memory ................................................................................................. 88
3.3.4 Setting up Internal Memory ................................................................................ 90
3.4 Communication Links ......................................................................................... 91
3.4.1 Types of Communication Links .......................................................................... 91
3.4.2 General Settings ................................................................................................ 94
3.4.3 Parameter Settings (Serial Port) ........................................................................ 97
3.4.4 Parameter Settings (Ethernet Port).................................................................... 98
3.4.5 Sub-link Settings ................................................................................................ 99
3.4.6 Sharing Data among Panels Using Data Sharer ............................................. 100
3.4.7 Using General Device (COM) to Communicate with Unsupported Devices .... 101
3.5 Sound Table ..................................................................................................... 104
3.6 Command Block and Status Words ................................................................. 106
3.6.1 Types of Command Block and Status Words .................................................. 106
1 Introduction
Welcome to eV Designer
The configuration software for eV Designer and effectiView HMI products
Thank you for purchasing eV Designer. This manual describes eV Designer operation procedures and details about
each feature.
Notes
1) Sitek makes every attempt to provide the user with functionality and usability of the Product and accuracy of its
documentation. However, if you should find any errors or omissions in this manual, please contact Sitek Spa.
2) Regardless of the above provisions, Sitek Spa shall not be held responsible for any damages or third party claims
resulting from the use of this product.
3) Difference may occur between the descriptions found in this manual and the actual functioning of this product. For
the latest information, please refer to the provided data files (i.e. readme.txt files, etc) or other Sitek Spa
documentation.
Precautions
1) Do not use the touch panel switch as an emergency stop switch. For safety reasons, it is required that all
industrial machinery and systems must be equipped with a mechanical, manually-operated emergency stop
switch.
2) Do not use the touch panel switch that could result in human injury or equipment damage. Failure with the touch
panel, the processing unit, and the cables that makes the output stuck at ON or OFF could result in a serious
accident.
Set up project
Create a project
protection
Local
macros
Download current
panel application
Run
Minimum OS requirements :
Windows 2000 SP4
Windows XP SP2 (for all flavors of XP such as Home, Media Center, Tablet PC)
Windows Server 2003
Windows Vista
will be added to your desktop. eV Designer also appears on the Windows start menu under Start > All
Programs > eV Designer.
■ Technical Support
For the questions about the eV Designer software, contact Sitek by sending an email to the following address:
techsupp@sitek.it.
Please include as much information as possible, including a description of the irregularity, the type of PC and panel
that you have, any other software that was running when the problem occurred, and the sequence of steps that led to
the problem.
■ Limitations
You may not reverse engineer, decompile, or disassemble the eV Designer SOFTWARE, except and only the extent
that such activity is expressly permitted by applicable law notwithstanding this limitation.
The eV Designer SOFTWARE is licensed as a single product, its component parts may not be separated for use on
more than one COMPUTER.
In no event shall Sitek be liable for any special, incidental, indirect or consequential damages of any kind, or any
damages whatsoever resulting from loss of use, data or profits, whether or not advised of e possibility of damage, and
on any theory of liability, arising out of or in connection with the use of the eV Designer SOFTWARE.
Make Same Width Make the selected objects have the same width as the reference
Size object.
Height Make the selected objects have the same height as the reference
object.
Both Make the selected objects have the same width and height as the
reference object.
Nudge Left Nudge the selection left. When the Snap to Grid option is not
selected, all objects of the selection move one pixel left. When the
Snap to Grid option is selected, each object of the selection moves
left to where its upper-left corner aligns to the nearest grid point.
Right Nudge the selection right. When the Snap to Grid option is not
selected, all objects of the selection move one pixel right. When
the Snap to Grid option is selected, each object of the selection
moves right to where its upper-left corner aligns to the nearest grid
point.
Up Nudge the selection up. When the Snap to Grid option is not
selected, all objects of the selection move one pixel up. When the
Snap to Grid option is selected, each object of the selection moves
up to where its upper-left corner aligns to the nearest grid point.
Down Nudge the selection down. When the Snap to Grid option is not
selected, all objects of the selection move one pixel down. When
the Snap to Grid option is selected, each object of the selection
moves down to where its upper-left corner aligns to the nearest
grid point.
Continued
Set Order Start the order setting process for the objects of the active screen.
Object Open the property sheet of the selected object.
Properties...
Save as Save the selected object as the default object for the type of that
Default object. Default objects are saved in the Objects category of the
object library.
Save to Object Save the selected object to the object library.
Library...
Save as Global Save the selected object as the global object which is saved in the
Object… Global category of the object library. Global Objects can be used
for the Global Object Containers.
Note:
1. To select a reference object from the selection, use [Ctrl+Click].
2. To add an object to the selection, use [Shift+Click].
New Screen... Create a new screen for the current panel application.
Screen Properties Open the screen property dialog box for the current screen.
Horizontal Line Get ready to place a copy of the default horizontal line on a screen.
Vertical Line Get ready to place a copy of the default vertical line on a screen.
Round Rectangle Get ready to place a copy of the default round rectangle on a screen.
Clipped Rectangle Get ready to place a copy of the default clipped rectangle on a screen.
Pie Get ready to place a copy of the default pie shape on a screen.
Text Get ready to place a copy of the default text object on a screen.
Picture Get ready to place a copy of the default picture object on a screen.
Run Online Simulation Run online simulation for the current application.
Set Transparent Open the Set Transparent Communication dialog box.
Communication...
Start Transparent Start the transparent communication.
Communication
End Transparent End the transparent communication.
Communication
Update OS0 through BIOS Update the system program OS0 of the target panel
through its BIOS. This operation is useful when the system
programs of the target panel were destroyed.
Export Text... Export the text of the current application to a PTX file.
Import Text... Import the text in a PTX file for the selected application.
PM TextEditor Run the PM TextEditor program to edit the text of a PTX
file.
New Screen Create a new screen for the current panel application.
Screen Properties Open the screen property dialog box for the current screen.
Make the previous screen of the current screen in terms of screen number
Previous Screen
the current screen.
Make the next screen of the current screen in terms of screen number the
Next Screen
current screen.
Off (State 0) Show the Off state of all the objects on the current screen.
On (State 1) Show the On state of all the objects on the current screen.
Compile the current application to build the runtime data. You can download
Compile the runtime data to the target panel. With the runtime data the target panel
can perform exactly what you programmed for the application.
Download
Download data using the existing settings to the target panel immediately
Immediately
Run Offline
Run offline simulation for the current application.
Simulation
Bit Button Get ready to place a copy of the default bit button on a screen.
Word Button Get ready to place a copy of the default word button on a screen.
Screen Button Get ready to place a copy of the default screen button on a screen.
Page Selector Get ready to place a copy of the default page selector on a screen.
Function Button Get ready to place a copy of the default function button on a screen.
Keypad Button Get ready to place a copy of the default keypad button on a screen.
Scroll Button Group Get ready to place a copy of the default scroll button group on a screen.
Scroll Bar Get ready to place a copy of the default scroll bar on a screen.
Radio Button Group Get ready to place a copy of the default radio button group on a screen.
Step Button Get ready to place a copy of the default step button on a screen.
Toggle Switch Get ready to place a copy of the default toggle switch on a screen.
Multistate Switch Get ready to place a copy of the default multistate Switch on a screen.
Slide Switch Get ready to place a copy of the default slide switch on a screen.
Numeric Entry Get ready to place a copy of the default numeric entry on a screen.
ASCII String Entry Get ready to place a copy of the default ASCII string entry on a screen.
Bit Lamp Get ready to place a copy of the default bit lamp on a screen.
Multistate Lamp Get ready to place a copy of the default multistate lamp on a screen.
Numeric Display Get ready to place a copy of the default numeric display on a screen.
ASCII String Display Get ready to place a copy of the default ASCII string display on a screen.
Message Display Get ready to place a copy of the default message display on a screen.
Time Display Get ready to place a copy of the default time display on a screen.
Date Display Get ready to place a copy of the default date display on a screen.
Day-of-week Display Get ready to place a copy of the default day-of-week display on a screen.
Dynamic Circle Get ready to place a copy of the default dynamic circle on a screen.
Dynamic Rectangle Get ready to place a copy of the default dynamic rectangle on a screen.
GIF Display Get ready to place a copy of the default GIF display on a screen.
Picture Display Get ready to place a copy of the default picture display on a screen.
Animated Graphic Get ready to place a copy of the default animated graphic on a screen.
Bar Graph Get ready to place a copy of the default bar graph on a screen.
Line Chart Get ready to place a copy of the default line chart on a screen.
Circular Bar Graph Get ready to place a copy of the default circular bar graph on a screen.
Scatter Chart Get ready to place a copy of the default scatter chart on a screen.
Alarm Display Get ready to place a copy of the default alarm display on a screen.
Historic Data Table Get ready to place a copy of the default historic data table on a screen.
Historic Event Table Get ready to place a copy of the default historic event table on a screen.
Historic Trend Graph Get ready to place a copy of the default historic trend graph on a screen.
Operation Log Display Get ready to place a copy of the default operation log display on a screen.
Recipe Selector Get ready to place a copy of the default recipe selector on a screen.
Recipe Table Get ready to place a copy of the default recipe table on a screen.
Sublink Table Get ready to place a copy of the default sublink Table on a screen.
USB Camera View Get ready to place a copy of the default USB camera view on a screen.
Horizontal Line Get ready to place a copy of the default horizontal line on a screen.
Vertical Line Get ready to place a copy of the default vertical line on a screen.
Round Rectangle Get ready to place a copy of the default round rectangle on a screen.
Clipped Rectangle Get ready to place a copy of the default clipped rectangle on a screen.
Pie Get ready to place a copy of the default pie shape on a screen.
Text Get ready to place a copy of the default text object on a screen.
Picture Get ready to place a copy of the default picture object on a screen.
Border Color Select a color for the border of the selected shape.
BG Color Select a color for the background of the selected solid shape.
FG/Pattern Color Select a color for the pattern of the selected solid shape.
Language Select a language that you are defining the text for.
Center Position Position the text at the center location within the object.
Horizontal Position Change the horizontal position of the text within the object.
Vertical Position Change the vertical position of the text within the object.
Align Left Align the text to the left of the text body.
Align Right Align the text to the right of the text body
External Label
Change the position of the external label.
Position
Snap to Grid Select or deselect the option of aligning objects to the grid points.
Make Same Width Make the selected objects have the same width as the reference object.
Make Same Height Make the selected objects have the same height as the reference object.
Make the selected objects have the same width and height as the reference
Make Same Size
object.
Nudge Left Nudge the selection left. When the Snap to Grid option is not selected, all objects
of the selection move one pixel left. When the Snap to Grid option is selected,
each object of the selection moves left to where its upper-left corner aligns to the
nearest grid point.
Nudge Right Nudge the selection right. When the Snap to Grid option is not selected, all
objects of the selection move one pixel right. When the Snap to Grid option is
selected, each object of the selection moves right to where its upper-left corner
aligns to the nearest grid point.
Nudge Up Nudge the selection up. When the Snap to Grid option is not selected, all objects
of the selection move one pixel up. When the Snap to Grid option is selected,
each object of the selection moves up to where its upper-left corner aligns to the
nearest grid point.
Nudge Down Nudge the selection down. When the Snap to Grid option is not selected, all
objects of the selection move one pixel down. When the Snap to Grid option is
selected, each object of the selection moves down to where its upper-left corner
aligns to the nearest grid point.
Continued
Auto Text Resizing Select or deselect the option of automatic text resizing.
Select/Import
Select a picture from a eV Designer provided picture library.
from Library
Select or deselect the option that parts of the picture are transparent. The
Transparent
transparent parts are pixels having the specified transparent color.
Transparent
Select a color as the transparent color.
Color
Select or deselect the option that the picture is toned with the specified
Tone
toning color.
Fit to Object Stretch the picture so it has the same size as the object.
Center Position the picture at the center location within the object.
Horizontal
Change the horizontal position of the picture within the object.
Position
Vertical Position Change the vertical position of the picture within the object.
Background
Select a color for the background of the object.
Color
Coordinate of the cursor; (x, y) Size of the selected object; (width x height)
Type of the selected object Coordinate of the selected object; (x, y) Zooming factor of the screen view
The Project Manager is a dockable window with a project tree. You can manage your project with it easily. To open
the Project Manager, check the Project Manager menu item in the View menu. The following is an example of the
Project Manager. In this example, the project MyProject has two panel applications: MyAP_1 and MyAp_2.
Languages node
Project node
Passwords node
Alarms node
Screen node
■ Global Node ( )
The Global node has seven sub-nodes. You can do the following with the Global node:
1) Double-click it to expand or collapse the list of its sub-nodes.
■ Languages Node ( )
You can do the following with the Languages node:
1) Double-click it to open the Languages dialog box.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Properties... Open the Languages dialog box.
■ Links Node ( )
The Links node has one Internal Memory sub-node and can have up to 16 Link sub-nodes. You can do the following
with the Links node:
1) Double-click it to expand or collapse the list of its sub-nodes.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Add Link Create a new communication link.
Driver Open communication driver list dialog box which lists all the supported communication drivers. In the
Link… dialog box, you can export the driver list to the .csv file.
■ Link Node ( )
A Link node is associated with a communication link. You can do the following with the Link node:
1) Double-click it to open the Link Properties dialog box of the associated communication link.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Rename Rename the associated communication link.
Delete Delete the associated communication link.
Properties... Open the Link Properties dialog box of the associated communication link.
■ Tags Node ( )
You can do the following with the Tags node:
1) Double-click it to open the Tags window.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Open Open the Tags window.
■ Setup Node ( )
The Setup node has four sub-nodes. You can do the following with the Setup node:
1) Double-click it to expand or collapse the list of its sub-nodes.
■ Clock Node ( )
You can do the following with the Clock node:
1) Double-click it to open the Clock dialog box.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Properties... Open the Clock dialog box.
■ Passwords Node ( )
You can do the following with the Passwords node:
1) Double-click it to open the Passwords dialog box.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Properties... Open the Passwords dialog box.
■ Screen Node ( )
Each Screen node is associated with a screen of the panel application. You can do the following with the Screen
node:
1) Double-click it to open the associated screen if the screen is not opened yet.
2) Double-click it to open the property sheet of the associated screen if the screen is already opened.
3) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Open Open the associated screen.
Delete Delete the associated screen.
Properties Open the property sheet of the associated screen.
Export Screen... Export the associated screen to an SNF file.
■ Alarms Node ( )
The Alarms node can have many Discrete Alarm Block sub-nodes and Analog Alarm Block sub-nodes. You can do
the following with the Alarms node:
1) Double-click it to open the Alarm Properties dialog box.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Add Discrete Alarm Block Create a new discrete alarm block.
Add Analog Alarm Block Create a new analog alarm block.
Import Alarm Block... Import an alarm block from an ALM file.
Properties Open the Alarm Properties dialog box.
■ Recipes Node ( )
The Recipes node can have many Recipe Block sub-nodes. Each Recipe Block sub-node is associated with a recipe
block of the panel application. You can do the following with the Recipes node:
1) Double-click it to expand or collapse the list of its sub-nodes.
2) Right-click it to get a popup menu with the following menu item:
Menu Item Description
Add Recipe Block Create a new recipe block.
■ Macros Node ( )
The Macros node can have many Macro sub-node. Each Macro node is associated with a macro of the panel
application. You can do the following with the Macros node:
1) Double-click it to expand or collapse the list of its sub-nodes.
2) Right-click it to get a popup menu with the following menu items.
Menu Item Description
Add Macro... Create a new macro.
Import Macro... Import a macro from an MCR file.
■ Macro Node ( )
Each Macro node is associated with a macro of the panel application. You can do the following with the Macro node:
1) Double-click it to open the editing window of the associated macro.
2) Right-click it to get a popup menu with the following menu items.
Menu Item Description
Open Open the editing window of the associated macro.
Close Close the editing window of the associated macro.
Rename Rename the associated macro.
Delete Delete the associated macro.
Export Macro... Export the associated macro to an MCR file.
The Screen Manager is a dockable window. You can manage the screens of your project with it easily. To open the
Screen Manager, check the Screen Manager menu item in the View menu. The following is an example of the Screen
Manager that lists the screens of the application EV-104 of the project.
The name of the current panel
application. You can select another
panel application of the project to
view.
You can right-click the Screen Manager to get the popup menu with the following menu items:
Save as Default Save the selected object as the default object for the type of that
object. Default objects are saved in the Objects category of the
object library.
Save to Object Save the selected object to the object library.
Library…
Save as Global Save the selected object as the global object which is saved in the
Object… Global category of the object library. Global Objects can be used
for the Global Object Containers.
Save Current Screen
Save the current screen to a picture file.
as Picture…
Screen Properties Open the screen property dialog box for the current screen.
■ For pipelines
Screen Properties Open the screen property dialog box for the current screen.
2 Creating Projects
You can get the project information and set up passwords to protect your project, the password table and the global
macros by using the Project information & Protection dialog box. To open the dialog box, you can do one of the
followings:
1) In the eV Designer's Project Manager tool window, double-click the Project node ( ).
2) In the eV Designer's menu bar, click Project to bring up the Project sub-menu. Click Information & Protection… in
the Project sub-menu.
The following is an example of the Project Information and Protection dialog box.
Global settings are the settings that can be used by all panel applications in the same project. They are accessible
and modifiable throughout your project. The global settings help a designer to construct a project that can be flexible
and easy to update. Designers can make changes to the overall design of the panel application by revising the global
settings directly.
You can complete all the global settings in the corresponding dialog box. To open the dialog box, you can double-click
the related node in the Global node in the eV Designer's Project Manager tool window, or you can click Project to
bring up the Project sub-menu in the eV Designer's menu bar, and then click the related command in the Project sub-
menu.
■ Languages
Described in Section 2.2.1.
■ Font Templates
Described in Section 2.2.2.
■ Picture Database
Described in Section 2.2.3.
■ Sound Database
Described in Section 2.2.4.
■ Text Database
Described in Section 2.2.5.
■ Global Tags
Described in Section 2.3.
■ Global Macros
Described in Chapter 14.
This section describes how to set up the languages for the project using the Languages dialog box. Each panel
application in the project can have up to 10 languages for the screen texts. The following is an example of the
Languages dialog box.
The following table describes each property in the Languages dialog box.
Property Description
Number of language Specifies how many languages the project will have.
Language The index of the language.
Name Specifies a name for a language. The name must be unique within the project.
Character Set Specifies the character set for a language to determine how to translate the bytes in the
text into characters on the screen.
Import... Click it to import the languages settings from a LNG file.
Export... Click it to export the languages settings to a LNG file.
OK Click it to close the dialog box and accepts all changes.
Cancel Click it to close the dialog box and discard all changes.
The following table describes how to read or use each of the items in the dialog box.
Item Description
Language Specifies the language that you are working for.
Template List Lists the font templates of the selected language. You can select a font
template here as the current template.
Current Name The name of the current template.
Template Windows Font Specifies the Windows font for the current template.
Font Style Specifies the font style for the current template.
Size Specifies the size for the current template.
Underline Specifies if the Underline feature is selected for the current template.
Strikeout Specifies if the Strikeout feature is selected for the current template.
Update Click it to update the selected template using the new settings.
Import... Click it to import the font templates from an FTF file.
Export... Click it to export the font templates to an FTF file.
OK Click it to close the dialog box and accepts all changes.
Cancel Click it to close the dialog box and discard all changes.
■ Importing Pictures
You need to import a picture before you can use it for the project. There are 5 ways to import pictures:
1) Use the Picture Database dialog box to import one picture at a time from a picture file. The types of importable
picture files include: BMP, JPG, GIF, and WMF.
2) Use the Picture Database dialog box to import many pictures at a time from a picture database (PDB) file.
3) Use the Picture Database dialog box to import one or many pictures at a time by dragging the pictures files from
the Windows Explorer to Picture Database list.
4) Click the icon to select and import a picture file when you specify a picture in a dialog box or a property
sheet.
5) Click the icon to select and import a picture in a picture database file when you specify a picture in a dialog
box or a property sheet.
■ Exporting Pictures
You can export the pictures of the project so the other projects can share those pictures by importing them. There are
2 ways to export pictures:
1) Use the Picture Database dialog box to export one picture at a time to a picture file.
2) Use the Picture Database dialog box to export many pictures at a time to a picture database (PDB) file.
A picture group is a collection of pictures. Each picture in a picture group represents one state. When a picture group
is displayed as the picture shape for an object, the picture that corresponds to the current object state is shown. This
is the main benefit of using a picture group as the object shape because it can show each object state with a different
picture.
When a picture group is used as the shape for buttons or switches, you may want it to have a different look when it is
pressed. In order to support the pressed look, a picture group needs two pictures for each state; one picture is for the
normal (released) look and another picture is for the pressed look.
For example, a 3-state multi-state switch needs a picture group that contains 6 pictures as its picture shape if the
pressed look is required.
The following is an example of a picture group supporting 3 states and the pressed look.
Picture Group State Pictures
0 (Normal/Released)
0 (Pressed)
1 (Normal/Released)
1 (Pressed)
2 (Normal/Released)
2 (Pressed)
The following table describes how to read or use each of the items in the dialog box.
Item Description
Pictures Lists the pictures and picture groups of the project. You can select a picture or a picture group
as the current selection. You can also make multiple selections.
View Shows the current selection. If the selection is a picture group, the first picture of the group will
be shown.
OK Closes the dialog box and accepts all changes to the picture database.
Cancel Closes the dialog box and discards all changes to the picture database.
Import... Imports a picture from a picture file. The types of importable picture files include: BMP, JPG,
GIF, and WMF.
Import Imports pictures from a picture database (PDB) file.
From...
Export... Exports the current picture to a picture file.
Export To... Exports the current selection to a picture database (PDB) file.
Add Group Adds one picture group to the picture database.
Add Item Imports a picture from a picture file and adds the picture to the current picture group.
Item Description
Add From... Imports pictures from a picture database (PDB) file and adds those pictures to the current
picture group.
Move Up Moves the selection down in the list
Move Down Moves the selection up in the list
Delete Delete the selection.
Color Select Dithering or Nearest Color as the color conversion method.
Conversion If the color resolution of a picture is not compatible with the target panel, the application compiler
will use the specified method to convert the picture data so it can be displayed without too much
color distortion at runtime.
Support Available when the selection is a picture group. Check this item so the current picture group
Pressed Look supports the pressed look. When a picture group supports the pressed look, it needs two
pictures for each state; one picture is for the normal (released) look and another picture is for the
pressed look.
Transparent Check this item to enable the transparent feature of the selection; if the selection is a picture, the
picture will be transparent for the specified transparent color; if the selection is a picture group,
all the pictures of the picture group will be transparent for the specified transparent color. Note
that this feature is effective only when a picture or a picture group is shown as the picture shape
for an object.
It is a common practice to make a picture transparent for a certain color so the picture can be
shown as a non-rectangle shape. The following are some examples:
Original Picture Transparent Picture Shown
Color
Transparent Available when the Transparent item is checked. Select a color for the transparent color.
Color
Rename Click this button to rename the current picture or the current picture group.
You can use a function button to play a sound or stop playing sound. For details, please see Section 5.4.1 Basic
Operations of function buttons
You can use Execute General Command ($C2.f) command flag setting in Command Block to play a sound. For
details, please see Section 3.6.7 Using General Commands.
■ Importing Sounds
You need to import a sound before you can use it for the project. There are two ways to import sounds:
1) Use the Sound Database dialog box to import one sound at a time from a sound file. The types of importable
sound files include: WAV.
2) Use the Sound Database dialog box to import many sounds at a time from a sound database (SDB) file.
■ Exporting Sounds
You can export the sounds of the project so the other projects can share those sounds by importing them. There are 2
ways to export sounds:
1) Use the Sound Database dialog box to export one sound at a time to a sound file.
2) Use the Sound Database dialog box to export many sounds at a time to a sound database (SDB) file.
The following table describes how to read or use each of the items in the dialog box.
Item Description
Sounds Lists the sounds of the project. You can select a sound as the current selection. You can also
make multiple selections.
Sound Shows the sound information of the current selection such as sound format and the length.
Information
You can click to start playing the sound. Click to pause playing the sound. Click to
stop playing the sound.
OK Closes the dialog box and accepts all changes to the sound database.
Cancel Closes the dialog box and discards all changes to the sound database.
Import... Imports a sound from a sound file. The types of importable sound files include: WAV.
Import Imports sounds from a sound database (SDB) file.
From...
Export... Exports the current sound to a sound file.
Export To... Exports the current selection to a sound database (SDB) file.
Rename Click this button to rename the current sound.
Delete Delete the selection.
Move Up Moves the selection down in the list
Move Down Moves the selection up in the list
The Text Database is a dockable window. With the Text Database, you can manage the texts in multiple languages of
your project easily. To open the Text Database, check the Text Database menu item in the Project menu or double
click the Text Database node in the Global in PM Project Manager tool window.
The following is an example of the Text Database that lists the texts in all the languages of the project.
File to Table Icon Table to File Icon Table to Application Icon Application to Table
Icon
To edit a text, you need to select a text row first by left-click anywhere in it, and then
click the cell of the row to bring up the edit box. In the edit box, you can type the text.
To stop or confirm editing, you can click anywhere outside the selected row.
Exports texts from the selected table to a text file (.txt file).
Table Name
Application Name
Exports texts from a panel application of the project to the selected table.
You can right-click the Text Database to get the popup menu with the following menu items:
Menu Item Description
Cut Cut the selected text and put it on the Clipboard.
Copy Copy the selected text and put it on the Clipboard.
Paste Insert the text on the Clipboard to the current table.
Delete Delete the selected text.
<Language name> Check the language name to display the text of objects in the
selected language.
A tag represents a single input or output variable monitored or controlled by the system. By changing tags, you can
use any PLC or controller without re-developing the application. This chapter explains how you can define and
manage tags by tags editor.
After the tag is created in tags editor, you can use it in your application by Select Tag Dialog Box. Please see Section
4.4.3.3 Selecting Tags for details. Or you can specify the tag by yourself. The format of a tag is Link Number\Tag
Group Name\Tag Name.
For example:
Tags Description
1\MONITOR\CORE Indicates a local tag named CORE DISPLAY in MONITOR tag group of link 1
DISPLAY
0\BOT\DECLARE Indicates a local tag named DECLARE in BOT tag group of internal memory
0\_ALARM SHOW Indicates a global tag named _ALARM SHOW of internal memory
Note that the maximum text amount of the tag/tag group name is 48 characters. You are allowed to define not only
tags for the link but also the tags for a tag group of the link.
In EV Designer, there are two types of tags: global tags and local tags.
■ Global Tag
A global tag is a tag that can be used by all panel applications in the same project. With global tags, the panel
applications in the same projects can share the common address declaration without having to keep and maintain the
same set of tags locally.
Note that a global tag can be only associated with internal variables.
■ Local Tag
A local tag is a tag that can be only used by the panel application which the tag is located in.
Tag Groups
Tag explorer displays links, recipes, data loggers and their tag groups if any. From tags explorer, you can:
■ Open a tag group of a link for editing by clicking the node
■ Import and export tags of a link
Described in Section 2.3.4
■ Add new groups to a link and delete or rename the existing tag groups
Described in Section 2.3.5
■ View tags (Data Items) of recipes and data loggers.
If there are any recipes or data loggers in the application, the tag editor will display their data items as the tags. All
the data items (tags) for the recipes or data loggers are read only in the tag editor. If you want to edit the data items
(tags), please use the corresponding dialog box.
Tag list window displays all the tags related to selected tag group. In the tag list window, you can:
■ Make switching between tag groups by clicking the window tab
■ Click any column header to sort the list
■ Add a tag by defining the tag name and then click any other cells to edit the elements of the tag
■ Cut, copy, paste and delete selected tags using menu commands or key combination
You can right-click the number column to display a popup menu of editing commands. The editing commands
available depend on what the pointer is pointing to.
■ Exporting Tags
If you have tags you want to reuse in another application panel, you can export the tags of the selected tag group as a
.csv file. You may do the following:
1) Locate the tag group you would like to export
2) Right-click on the tag group to display the item's "popup menu"; and then click Export Tags..., the second menu
item.
3) If you want to save tags in a different folder, locate and open the folder first. then click Save.
You can export all the tags of the internal memory or a link as a .csv file by right-clicking on the internal memory or a
link item and then using the Export All Tags command on the popup menu.
You can set up the panel application with the General Setup dialog box. There are five ways to open the dialog box:
1) In the eV Designer's Project Manager tool window, double-click the Panel Application node ( ).
2) In the eV Designer's Project Manager tool window, right-click the Panel Application node ( ) to bring out the
popup menu and select General Setup menu item.
3) In the eV Designer's Project Manager tool window, double-click the General Setup Node ( ) in Panel
Application > Setup
4) In the eV Designer's Project Manager tool window, right-click the General Setup Node ( ) in Panel Application
> Setup to bring out the popup menu and select Properties menu item.
5) In the eV Designer's menu bar, click Panel to bring up the Panel sub-menu. Click General Setup…in the Panel
sub-menu.
The General Setup dialog box contains the following pages. Some of the pages appear only when they are needed.
■ General
Described in Section 3.1.1.
■ Custom
Described in Section 3.1.2.
■ Keys
Described in Section 3.1.3.
■ Startup Macro / Main Macro / Event Macro / Time Macro
Described in Section 14.2.6.
This section describes how to define the general settings for a panel application. The following is an example of the
General page of the General Setup dialog box.
Item Description
Application Name The name of the panel application.
Model The model of the target panel.
Click to bring up the Panel Model dialog box which helps you to select a
model by specifying the size, resolution and orientation of the display.
The following is a sample of Panel Model dialog box
Battery Backed RAM Specifies the size of the battery backed RAM installed in the target panel.
Use External Keypad Available if the target panel supports the custom designed external keypad.
For example PV037-LSK, PV037V-LSK, PL037-LSK…
Select this option if the application uses a custom designed external keypad.
Start Up Screen Specifies the first screen of the application that the target panel will display
after power up.
Delay Time Specifies the time that the target panel will delay to run the application.
Display Check this option if you want the target panel to display countdown while it is
Countdown waiting for the expiry of the Delay Time.
Language Specifies the language that the application will display the text for after power
up.
Login Required Check this option if you want the target panel to get a valid password from the
operator before it displays the first screen.
Default User Available when the Login Required is not selected. Specifies the user level as
Level the initial user level for the application. When the target panel starts the
application, it sets the current user level to the initial user level.
Idle Display Idle Check this option if you want the target panel to display the Idle Screen when
Processing Screen the target panel has not been operated by the operator for the specified
amount of time. The specified amount of time is called the idle time.
Idle Time The amount of time that will be used to decide if the idle screen should be
displayed.
Idle Screen Specifies the screen that will be displayed as the idle screen.
Change User Check this option if you want the target panel to change the current user level
Level when the idle screen is displayed.
Idle User Level Available when the Change User Level is selected. Specifies the user level
that will be the current user level when the idle screen is displayed.
Screen Saver Specifies the screen saver time. The target panel will turn off its backlight
Time when it has not been operated by the operator for the specified amount of
time.
Continued
#2 1, 2, 3, ... and 59
seconds
#3 1, 2, 3, ... and 59 minutes The macro is run at 0 second.
#4 1, 2, 3, ... and 24 hours The macro is run on the clock.
If the application needs a Time macro, check the item of an appropriate Time
macro and specify the time interval for that Time macro.
Print Printer Specifies the type of printer that the application will use.
Port Specifies the port of the target panel that will connect to the printer.
This section describes how to define the customization settings for a panel application. The following is an example of
the Custom page of the General Setup dialog box.
Item Description
Decimal Use Check this item if you want the application to use the custom keypad instead of
Number custom the built-in keypad for the entry of decimal numbers.
Keypad keypad
Window Specify the window screen that is designed as the decimal number keypad.
Screen
Hexadecimal Use Check this item if you want the application to use the custom keypad instead of
Number custom the built-in keypad for the entry of hexadecimal numbers.
Keypad keypad
Window Specify the window screen that is designed as the hexadecimal number keypad.
Screen
Octal Use Check this item if you want the application to use the custom keypad instead of
Number custom the built-in keypad for the entry of octal numbers.
Keypad keypad
Window Specify the window screen that is designed as the octal number keypad.
Screen
Continued
eV Manual V1.2a - 17.03.2010
73
Manual
Item Description
Character Keypad Use custom Check this item if you want the application to use the custom keypad
keypad instead of the built-in keypad for the entry of characters.
Window Specify the window screen that is designed as the character keypad.
Screen
Password Keypad Use custom Check this item if you want the application to use the custom keypad
keypad instead of the built-in keypad for the entry of passwords.
Window Specify the window screen that is designed as the password keypad.
Screen
Default Folder for File I/O This field is available only when the target panel is PanelExpress.
There are 4 kinds of default folder that you can select for your
application. They are Same as Application File, Pre-assigned, New Per
Day, New Per Month. Please see Section 3.1.4 for details
Touch Operation Use custom Check this item if you want the application to display the custom sign
Disabled Sign sign instead of the built-in sign when the touch operation of an object is
disabled.
Picture Specify the picture that is to replace the built-in sign.
Transparent Select this item if you want parts of the custom sign to be transparent.
T. Color Specify the transparent color.
Time/Date Format Date The date format that the target panel will use to output date information
for Text Files to text files.
Time The time format that the target panel will use to output time information
to text files.
User Level Set Time/Date The minimum user level that is required to set the time and date of the
Required in Panel target panel through the target panel's Panel Setup menu.
Setup
Prohibit uploading and copying of the Check this option if you want to prohibit uploading and copying of the
panel application stored in the HMI unit panel application stored in the HMI unit.
1. The types of buttons that support this feature include: Bit Button, Toggle Switch, Screen Button, Function Button,
Word Button, Multi-state Switch, and Keypad Button.
2. The first button, i.e. the top-most button, can only be a bit button, a toggle switch, a word button, a multi-state
switch, or a keypad button. The button can not have the optional property of Minimum Hold Time or Operator
Confirmation. If the button is a bit button, a toggle switch, or a keypad button, it can not have any macro. If the
button is a word button, it can not be configured for Enter Value or Enter Password. If the button is a multi-state
switch, it can not be configured as a List or Drop-down List.
3. The underlying buttons that have the optional property of Minimum Hold Time or Operator Confirmation will not be
activated.
4. An underlying bit button that is configured for Momentary ON or Momentary OFF will not be activated. However if
that bit button is the second button and the first button is a keypad button, it can be activated. An underlying bit
button that has any macro will not be activated.
5. An underlying toggle switch that has any macro will not be activated.
6. An underlying multi-state switch that is configured as a List or Drop-down List will not be activated.
7. A function button can only be the last button, i.e. the bottom-most button. All the buttons that are under a function
button will not be activated.
8. A screen button can only be the last button. All the buttons that are under a screen button will not be activated.
9. A word button that is configured for Enter Value or Enter Password can only be the last button. All the buttons that
are under such button will not be activated.
10. The maximal number of buttons that can be indirectly activated by one touch is 10.
The default folder will be used for a file I/O operation when one of the following two conditions exists:
1) The command issued for the operation does not require the specification of a filename.
2) The command issued for the operation requires a filename and the specified filename contains no path
information.
To specify the default folder, you need go to the “Custom” page of the “Panel General Setup” dialog box. To go there,
select the menu item “General Setup” in the submenu “Panel” to get the dialog box, then click the “Custom” tab.
Another way to get the dialog box is to double-click the “Panel General Setup” node on the project tree.
On the “Custom” page, you can specify the desired default folder in the “Default Folder for File I/O” group according to
the following rules:
1) If you want the folder of your application file (.pe2 or .pl2 file) to be the default folder, select “Same as Application
File” in the “Option” combo box.
For applications with this selection running on HMI units, because the applications are not stored in any file and
under any directory, the root directory of the USB memory stick will be used as the default folder instead.
2) If you want to use a specific folder that will exist at run-time as the default folder, select “Pre-assigned” in the
“Option” combo box and specify the folder in the “Folder” edit box.
Note that the specified folder must exist at the run-time or the file I/O operations will fail.
Example:
Folder Name Format Folder Path <Prefix> Date Default Folder Name
<Prefix>yymmdd C: ABC December 19, 2008 C:\ABC081219
<Prefix>yyyymmdd D:\NEO ABC_ December 19, 2008 D:\NEO\ABC_20081219
<Prefix>yyMMMdd C: XYZ January 10, 2009 C:\XYZ09JAN10
<Prefix>yyyyMMMdd D:\123 XYZ_ January 10, 2009 D:\123\XYZ_2009JAN10
4) If your application needs a new default folder every month, select “New Per Month” in the “Option” combo box and
specify the following 3 items:
A) Folder Path: The path for the new folder. The system will create a new default folder under
the specified path
every month.
B) Folder Name Format: The format to create a default folder name.
C) <Prefix>: The string to be used as the prefix of the new default folder names. Note that only
ASCII characters are allowed.
Example:
Folder Name Format Folder Path <Prefix> Date Default Folder Name
<Prefix>yymm C: ABC December 19, 2008 C:\ABC0812
<Prefix>yyyymm D:\NEO ABC_ December 19, 2008 D:\NEO\ABC_200812
<Prefix>yyMMM C: XYZ January 10, 2009 C:\XYZ09JAN
<Prefix>yyyyMMM D:\123 XYZ_ January 10, 2009 D:\123\XYZ_2009JAN
Some of the target panels are key type. Those key type panels carry external keys that you can press to perform the
defined operations.
To assign or change the operation of the keys in the panel application, you can use the following two ways:
You can do the default settings of the keys for the panel application in General Setup property sheet. To open the
General Setup property sheet, please see Section 3.1 Setting up the Panel Application for details. The General Setup
property sheet provides you the Keys page to set up the keys as default.
The following is an example of the Keys page and Usage Setup dialog in General Setup property sheet.
There are two parts in the above illustration: Key Usage Table and Usage Setup Dialog.
■ Key Usage Table
A table lists all the keys of the target panel and their default usages. The key usage table here is empty (Usages for
key and key combination are none) initially after the panel application is created. For details about Key Usage Table,
please see Section 3.2.3
■ Usage Setup Dialog
A floating dialog box allows you specify the usage for the selected key or key combination. You can left-click the cell
in the key usage table to bring up the dialog. For details about Usage Setup Dialog, please see Section 3.2.4.
The following is an example of the Keys page and Usage Setup dialog in Screen Properties property sheet.
There are two parts in the above illustration: Key Usage Table and Usage Setup Dialog.
■ Key Usage Table
A table lists all the keys of the target panel and their usages in a screen. The key usage table here is the same as the
one in the Keys page of the General Setup property sheet initially after the screen is created. For details about Key
Usage Table, please see Section 3.2.3
The following table lists key type panels and their available keys.
Property Description
Use Default Check this option if you want to use the default setting in the Keys page of the General Setup
property sheet. The field is only available in the Keys page of the Screen Properties property
sheet.
Usage Select a usage for the key or key combination. There are 7 choices: None, Bit Button, Function
Button, Keypad Button, Multistate Switch, Screen Button and Word Button.
Bit Button If the usage is Bit Button, you need to specify the following properties:
Property Description
Function Select the operation for the bit button. There are 5 choices: Set ON, Set
OFF, Momentary ON, Momentary OFF, and Invert.
For details, see Section 5.1.1 Basic Operations
Write Address Specifies the bit variable to be operated.
Click to enter an address for this field. Click to select a tag for this
field.
ON Macro Check this option if you want the button to have an ON macro. Select a
macro from the dropdown list. This option is available when the bit button
operation is Set ON, Momentary ON, or Momentary OFF.
OFF Macro Check this option if you want the button to have an OFF macro. Select a
macro from the dropdown list. This option is available when the bit button
operation is Set OFF, Momentary ON, or Momentary OFF.
Property Description
Function If the usage is Function Button, you need to specify the following properties:
Button Property Description
Function Specifies the operation that you want the function button to perform. About the
available operations, see Section 5.4.1 Basic Operation.
Keypad If the usage is Keypad Button, you need to specify the following properties:
Button Property Description
Enter Select this item if the button is used to input the specified character to the keypad
Character buffer.
Character Available when the Enter Character is selected. Specifies the character to be
entered in the keypad buffer.
Enter Select this item if the button is used to issue the specified command to the keypad
Command buffer.
Command Available when the Enter Command is selected. Specifies the command to be
issued to the keypad buffer. There are four commands available:
Command Description
Enter Completes the data entry and sends the input string to the
associated object or the system.
Escape Cancels the data entry operation.
Clear Clears the keypad buffer.
Backspace Removes the last character in the keypad buffer.
Multistate If the usage is Multistate Switch, you need to specify the following properties:
Switch Property Description
State Type The state type of the monitored variable. There are two options: Value and LSB.
For details, see Section 4.4.1.1 State Types
Data Type The data type of the variables specified in this page.
Write Specifies the variable to be controlled.
Address
Click to enter an address for this field. Click to select a tag for this field.
Total State Specifies the number of valid states that the monitored variable has.
Note: The last state is state N-1 when the Total States is N.
Next State Specifies the method of calculating the next state for the Button control type.
+1 means the next state is the current state plus one when the current state is not
the last state. When the current state is the last state, the next state is state 0.
-1 means the next state is the current state minus one when the current state is
not state 0. When the current state is state 0, the next state is the last state.
This section describes how to set up and use the internal memory for the panel application.
The following table describes the types of memory space that can exist or always exist in the internal memory.
Type Address Format Description
Regular user Word: $Un The size of this memory space is settable.
memory Bit: $Un.b; b: 0~f
Battery backed Word: $Nn This memory space is available when the target panel is equipped with
user memory Bit: $Nn.b; b: 0~f battery backed RAM. The size of this memory space is settable.
System Word: $Sn This memory space keeps the system maintained data and information.
memory Bit: $Sn.b; b: 0~f See Section 3.3.3 for details.
Index registers Word: $In The index registers are provided to support the indirect addressing. To
Bit: $In.b; b: 0~f know how to specify indirect address by using index register, please
see Section 3.3.2 for details.
Command Word: $CBn This memory space is allocated for storing the data read from the
block Bit: $CBn.b; b: 0~f specified command block.
The index registers are battery backed if the panel has battery backed memory. The index registers are cleared to
zero when the panel application is updated.
You can use the index registers to specify the indirect address. With the support of indirect addressing, an object or
macro can be designed to access different sets of data at run time.
Examples
1) The word address W[$I30] is equivalent to W2000 when the value of $I30 is 2000.
2) The word address $U[$I0+123] is equivalent to $U223 when the value of $I0 is 100.
3) The bit address $U[$I2].a is equivalent to $U0.a when the value of $I2 is 0.
4) The word address [$I2]:W100 is equivalent to 3:W100 when the value of $I2 is 3.
5) The bit address [$I0]: W[$I1+10].f is equivalent to 5:W20.f when the values of $I0 and $I1 are 5 and 10
respectively.
Notes:
1) It is your responsibility to make sure that the values in the index registers will result in valid addresses at
runtime. PM
Designer has no way to check the validity of the using of index registers.
2) The offset values must be a positive number and the maximum offset value is 65535.
3) Only $I0~$I15 can be used for the node address (PLC address) and no offset value is allowed.
4) Make sure the PLC driver you are going to use supports the indirect addressing.
Communication Status
Value Meaning Value Meaning
0 OK 13 Invalid request
1 Overrun error 14 Device busy
2 Break error 15 Unknown error
3 Parity error 16 Link disabled
4 Framing error 17 Initialization failure
5 No response 18 Failed to send data
6 Unrecognized response 19 Failed to receive data
7 Timeout 20 Failed to open connection
8 Inactive CTS 21 Connection not ready
9 Checksum error 22 Invalid sub-link
10 Command rejected 23 Invalid COM port
11 Invalid address 24 Error
12 Invalid range 255 Uncertain
You can use the Internal Memory dialog box to define the sizes of the regular user memory and the battery backed
user memory. To open the Internal Memory dialog box, you can do one of followings:
1) In the eV Designer's Project Manager tool window, double-click the Internal Memory Node ( ) in Panel
Application > Links
2) In the eV Designer's Project Manager tool window, right-click the Internal Memory Node ( ) in Panel
Application > Links to bring out the popup menu and select Properties menu item.
This section describes how to set up communication links for the panel application to access the data of external
devices.
The following table describes the three types of communication links that the panel application can have.
[Example 1] The panel uses an RS232 direct link to talk with the specified device directly.
[Example 2] The panel uses an RS485 direct link to talk with the specified devices directly.
[Example 3] The panel uses an Ethernet direct link to talk with the specified device directly.
Continued
Continued
This section describes how to define the general settings for the communication links using the General page of the
Link Properties dialog box. The following is an example of the General page that defines a direct link.
The following is an example of the General page that defines a communication service link.
Continued
When the Link Type is Communication Service (Ethernet), select one of the following
servers.
Service Description
N-to-1 Master You need to specify a direct link of the application as the data
link for the service in the Data Link field. The link can connect up
to 8 PM panels and allow those panels to communicate with the
device connected by the specified data link indirectly. The
panels served by the link must use an indirect link to accept the
service.
When the Link Type is Indirect Link and the Indirect Link Server Location is specified,
the indirectly connected device is shown here.
Link Port Select a port for this link.
Sub-links When an RS485 communication line has many devices connected to it, the logical
connection of a device on the link with the PM panel is called a sub-link.
This field is available when the Link Type is Direct Link (COM). Select this option if this
link will connect to many devices and you want to identify, monitor, or control the
communication with each connected device.
Data Link Select a direct link of the application as the data link for the communication service
when the Link Type is Communication Service.
Indirect Panel Select the panel application that provides the communication service for this indirect
Link Application link.
Server Link Select the communication service link provides the communication service for this
Location indirect link.
Record Check this option if you want the communication status of the link or the link’s sub-links
communication status to be recorded in the operation log. The recordable types of status include: Enabled,
in operation log Disabled, Failed, and Recovered. The operation log display can show the logged
communication status.
Check Word The panel will read the specified word once in a while to check if the connection of the
link is good.
The duration of showing The communication error message box will hide and show according to the specified
eV Manual V1.2a - 17.03.2010
96
Manual
a communication error duration. If the duration is 0, the error message box will not show.
message
This section describes how to set up the communication parameters for the serial communication links using the
Parameter page of the Link Properties dialog box.
The following is an example of the Parameter page for a The following is an example of the Parameter page for a
serial direct link. N-to-1 master.
The following table describes each property in the Parameter page of the Link Properties dialog box for a serial link.
Property Description
Baud Rate The baud rate used.
Data Bits The number of data bits used.
Parity The scheme of parity used.
Stop Bits The number of stop bits used.
Panel Address The address of the target panel.
PLC Address The address of the connected device.
Timeout Time The maximum time allowed for the communication driver to wait for the reply from the
connected device. When the elapsed time exceeds the Timeout Time, the
communication driver assumes the communication failed.
Command Delay If the Command Delay is 0, the communication driver sends the next request
immediately to the connected device after it received the reply of the last request. If the
Command Delay is nonzero, the communication driver delays the specified time before
sending the next request to the connected device.
Retry Count The number of times that the communication driver will retry to get a successful reply
from the connected device for each request. If the number is zero, the communication
driver will use a default retry count.
Specify N-to-1 This button is available when the link is a N-to-1 master. Click this button to bring up the
Connection Slave N-to-1 Connection Slave Panels dialog box. You can define the slave panels of the N-to-
Panels 1 connection in the dialog box.
Specify Other Data This button is available when the link is a direct link and the connected device is Data
Sharing Panels Sharer (RS485). Click this button to bring up the Other Data Sharing Panels dialog box.
eV Manual V1.2a - 17.03.2010
97
Manual
You can define the other data sharing panels in the dialog box.
This section describes how to set up the communication parameters for the Ethernet links using the Parameter page
of the Link Properties dialog box. The following is an example of the Parameter page for an Ethernet direct link.
The following table describes each property in the Parameter page of the Link Properties dialog box for an Ethernet
link.
Property Description
IP Address The IP address of the connected device.
Use Default Port Check this option if the default IP port is used
Port Specifies the IP port used
Node Address Specifies the node address of the connected device.
Timeout Time The maximum time allowed for the communication driver to wait for the reply from the
connected device. When the elapsed time exceeds the Timeout Time, the communication
driver assumes the communication failed.
Command Delay If the Command Delay is 0, the communication driver sends the next request immediately to
the connected device after it received the reply of the last request. If the Command Delay is
nonzero, the communication driver delays the specified time before sending the next request
to the connected device.
Retry Count The number of times that the communication driver will retry to get a successful reply from
the connected device for each request. If the number is zero, the communication driver will
use a default retry count.
This section describes how to define the sub-links for the direct links using the Sub-link page of the Link Properties
dialog box. The following is an example of the Sub-link page.
The following table describes each property in the Sub-link page of the Link Properties dialog box for a direct link.
Property Description
Number of sub-links Specifies how many devices the link will connects as sub-links.
Language Specifies the current language for the Name field.
Name The name of the selected sub-link for the language specified in the Language field.
Node Address The address of the selected sub-link. The address must be a unique number within all the
sub-links.
Initial State The initial communication state for the selected sub-link. If the state is On, the panel will
communicate with the sub-link after running the application. If the state is Off, the panel
will not communicate with the sub-link until the communication state is turn On in a sub-
link table.
Show error If this option is checked, the communication error message will be shown when the
message selected sub-link encounters communication errors. If this option is unchecked, no error
message will be shown for any communication errors.
The data sharer is a virtual device. It allows data sharing among up to 16 PM panels on an Ethernet or an RS485
network. Each of the PM panels can have up to 256 words of data to share.
To set up the communication for the data sharing, create a direct link and select Data Sharer (UDP) or Data Sharer
(RS485) of PanelMaster as the connected device. The panel address that you can set in the Parameter page of the
Link Properties dialog box must be unique for each sharing panels as it is used to identify the shared data.
The communication driver for the link connecting to Data Sharer is responsible for broadcasting the panel's shared
data on the network. For example, if the panel address of a panel is 10 and the number of the link connecting to Data
Sharer is 2, the following Macro command will cause the communication driver to broadcast the corresponding data
on the network.
The communication driver receives the broadcasted shared data on the network automatically. It has a block of
memory to store the shared data. To access a word, use the following address, where m is the panel address and n is
the word number of that panel’s shared data.
To access a bit, use the following address, where b is a hexadecimal number representing the bit number in the
specified word.
1. Select PanelMaster->General Device(COM) as the destination controller in Link Properties dialog box.
2. Write your own communication protocol by macro commands. The following is an example:
The sound table contains all the sounds used by the panel application. The sound table is empty initially after the
panel application is created.
You can use the sound only if the target panel is PanelExpress. In the PanelExpress application, you can use function
button with play sound operation to play the specified sound.
Before using the sound in the panel application, you need to import or add a sound into the Sound Table.
To open the Sound Table dialog box, please do one of the followings:
1) In the eV Designer's Project Manager tool window, double-click the Sound Table ( ) node in Panel
Application.
2) In the eV Designer's Project Manager tool window, right-click the Sound Table ( ) node to bring out the popup
menu and select Properties menu item.
2) On the Panel menu, click Sound Table…
The following table describes how to read or use each of the items in the dialog box.
Item Description
Sounds Lists the sounds for the panel application. You can select a sound as the current selection. You
can also make multiple selections. To select a sound, click the row on its header column of that
sound in the list. To select multiple rows, click the row on its header column and use Ctrl + Click
to add a row to the selection.
The following table describes each column in the sound list.
Column Description
Number The number of the sound in the sound list. The number is an unsigned
integer starting from 0. It must be unique in the panel application. You can
click the cell and then edit the number.
Name The name of the sound. You can click the cell to select a sound predefined
in the Sound Database from the drop down list. To know how to predefine
sounds in Sound Database, please see Section 2.1.3.
Type Displays the type of the sound.
OK Closes the dialog box and accepts all changes to the sound table.
Cancel Closes the dialog box and discards all changes to the sound table.
Import… Imports a sound from a sound file. The types of importable sound files include: WAV only.
Add Adds a sound from the Sound Database to the end of the sound table. To know how to use
Sound Database, please see Section 2.1.3.
Insert Inserts a sound from the Sound Database before the selection. To know how to use Sound
Database, please see Section 2.1.3. This button is available when the selection is made.
Delete Deletes all the selections. This button is available when the selection is made.
Move Up Moves the selection one item down in the list. This button is available when the selection is
made.
Move Down Moves the selection one item up in the list. This button is available when the selection is made.
Your can command the panel to do a variety of things using the command block. The command block is a block of
words in your controller or the internal memory. The panel scans the control block periodically and performs the
specified operations according to the contents of the control block. You can decide the size of the command block, the
command words that are required in the command block, and the rate of scanning the command block, so the
overhead of reading the command block is minimized.
The panel can provide its status information to you by writing status values to the status words. The status words are
in your controller or the internal memory. You can decide the status words that are required for your application so the
panel will not waste time to output useless status values.
3.6.1.1 Type A
■ Type A Command Block
You can have the following command words for the application and their orders in the command block are adjustable.
Note: To activate any of the above functions, you need to change the corresponding command bit from Off to On.
The panel does not reset the command bit, so you have to reset the command bit before commanding the panel to
perform the same function again. You should keep the state of the command bit long enough so the panel can detect
the change. The best way is to use the corresponding acknowledge bit in the Command Status Word. The panel
turns on the acknowledge bit when it detect the change. It is safe to reset the command bit when you see the
acknowledge bit turns on. The panels turns off the acknowledge bit when it sees the command bit turns off.
You can have the following command words for the application.
Bit Description
0~9 Specifies the screen to be displayed.
11~13 Specifies the language that the panel displays for.
000: The panel does nothing.
001: The panel changes the language to language 1.
010: The panel changes the language to language 2.
...
111: The panel changes the language to language 7.
14 If this bit is On, the panel turns off the back light of the display.
15 If this bit is On, the panel turns on the back light of the display.
Note: To activate any of the above functions, you need to change the corresponding command bit from Off to On.
The panel does not reset the command bit, so you have to reset the command bit before commanding the panel to
perform the same function again. You should keep the state of the command bit long enough so the panel can detect
the change. The best way is to use the corresponding acknowledge bit in the Command Status Word. The panel
turns on the acknowledge bit when it detect the change. It's safe that you reset the command bit when you see the
acknowledge bit turns on. The panels turns off the acknowledge bit when it sees the command bit turns off.
You can have the following status words for the application.
Status Word Description
Whenever the panel switches the main screen, it sets this word to the number of
Screen Status Word
the current main screen.
Contains the acknowledge bits for the command flags of Command Flag
Command Flag Ack. Word
Register.
Current Recipe Number Word Stores the current recipe number of recipe block #0.
The command words and status words you can have for the application are the same as the H (Binary) type.
However, the values in the following words must be in BCD format: Screen Number Register, Recipe Number
Register, Screen Status Word, and Current Recipe Number Word.
This section describes how to define the general settings for the command words and the status words using the
General page of the Command & Status dialog box. The following is an example of the General page.
Property Description
Type Select one of the following three types of control block and status words for your
application:
A, H (Binary), H (BCD)
Use Command Block Check this item if the application needs any of the command words.
Read Address Specifies the address of the command block.
Size Specifies the size of the command block.
Scan Time Select one of the following rate for the panel to scan the command block:
1 second, 0.5 second, 0.25 second
Command Bit Shows the valid address range of the bits in the command block. Note that the
Block Address application can only read the bits.
Image Range
Word Shows the valid address range of the words in the command block. Note that the
Address application can only read the words.
Range
This section describes how to configure the type A command block using the Command Block page of the Command
& Status dialog box. The following is an example of the Command Block page.
The following table describes each property in the Command Block page.
Property Description
Command Arrangement Select Default if you want the command words to be in the default order
Word in the command block. Select Custom if you want to arrange each
command word in the command block by yourself.
Screen Switching Check this option so you can use the word to change the main screen or
Register display a window screen by setting the word to the number of the desired
screen.
Reset SSR to Zero If this option is selected, the panel always resets the Screen Switching
Register to zero when it detects a nonzero value is in the word. If this
option is not selected, the panel resets the Screen Switching Register to
zero only when the specified screen is valid and not displayed yet.
Parameter One Register Check this option so you can this word to specify the No. 1 parameter for
the specified operation.
Command Flags #0 ~ #15 Check this option so you can use the command flags to request the
(Command Flag Word) panel to do the specified operations.
Trigger Bits #0 ~ #15 Check this option if you need any of the trigger bits in the word for your
(Low Trigger Word) application.
Parameter Two Register Check this option so you can this word to specify the No. 2 parameter for
the specified operation.
Trigger Bits #16 ~ #31 Check this option if you need any of the trigger bits in the word for your
(High Trigger Word) application.
Continued
Property Description
Command Print Screen (#8) Check this option so you can use command flag #8 to request the panel
Flag to print the specified screen.
You need to specify the following:
1) Parameter One Register: the number of the screen to be printed
Note1: The top screen is printed if the number is zero or there is no
Parameter One Register.
Note2: The operation of printing a screen that is not the top screen is not
supported by PL035/037/057/058
Backlight On (#9) Check this option so you can use command flag #9 to request the panel
to turn its backlight on.
Backlight Off (#10) Check this option so you can use command flag #10 to request the panel
to turn its backlight off.
Set Current User Level Check this option so you can use command flag #11 to request the panel
(#11) to set the current user level to the specified one.
You need to specify the following:
1) Parameter One Register: the user level
Close All Window Check this option so you can use command flag #12 to request the panel
Screens (#12) to close all window screens.
Execute General Check this option so you can use command flag #15 to request the panel
Command (#15) to perform the specified operation. See the section 3.6.7 Using General
Commands for details.
This section describes how to configure the type A status words for your application using the Status Word page of
the Command & Status dialog box. The following is an example of the Status Word page.
The following table describes when and what the panel will write to each status word.
Status Word Description
Command Flag Ack. Bits #0 ~ The panel will write the states of all the effective command flags to this word
#15 whenever there is any state change occurring on the effective command flags.
Trigger Ack. Bits #0 ~ #15 The panel will write the states of trigger bits #0 ~ #15 to this word whenever
there is any state change occurring on trigger bits #0 ~ #15.
Trigger Ack. Bits #16 ~ #31 The panel will write the states of trigger bits #16 ~ #31 to this word whenever
there is any state change occurring on trigger bits #16 ~ #3.
Current Screen Number Word The panel will write the number of the current main screen to this word
whenever the main screen changes.
Current Recipe Block ID Word The panel will write the current recipe block ID to this word whenever a
different recipe block becomes the current recipe block.
Current Recipe Number Word The panel will write the current recipe number of the current recipe block to
this word whenever a different recipe becomes the current recipe of the
current recipe block.
Current User Level Word The panel will write the current user level to this word whenever the current
user level changes.
Current Language Word The panel will write the current language number to this word whenever it
changes the language.
This section describes how to configure the type H command block using the Command Block page of the Command
& Status dialog box. The following is an example of the Command Block page.
Continued
Property Description
Reset SNR to Zero If this option is selected, the panel always resets the Screen Number
Register to zero when it detects a nonzero value is in the word . If this
option is not selected, the panel resets the Screen Number Register to
zero only when the specified screen is valid and not displayed yet.
Command Flag Register You can use the command flags to request the panel to do the specified
operations.
Recipe Number Register When you use command flag #5 to set the current recipe number for
recipe block #0, you need to specify the recipe number in this word.
Comman Clear Alarm History (#0) Check this option so you can use command flag #0 to request the panel
d Flag to clear the alarm history.
Clear Alarm Counts (#1) Check this option so you can use command flag #1 to request the panel
to clear the alarm counts.
Write Recipe To PLC (#4) Check this option so you can use command flag #4 to request the panel
to write the current recipe of recipe block #0 to the specified address
which is defined in the Recipe Block dialog box.
Set Current Recipe Check this option so you can use command flag #5 to request the panel
Number (#5) to set the current recipe number for recipe block #0.
You need to specify the following:
1) Recipe Number Register: the recipe number
Read Recipe From PLC Check this option so you can use command flag #6 to request the panel
(#6) to read a recipe from the specified address which is defined in the
Recipe Block dialog box and use that recipe to replace the current
recipe of recipe block #0.
Sound Buzzer (#7) Check this option so you can use command flag #7 to request the panel
to sound its buzzer.
Trigger Bit #4 (#8) Check this option so command flag #8 will be used as trigger bit #4.
Trigger Bit #5 (#9) Check this option so command flag #9 will be used as trigger bit #5.
This section describes how to configure the type H status words for your application using the Status Word page of
the Command & Status dialog box. The following is an example of the Status Word page.
In the Status Word page, check the needed status words for your application and specify a word variable that will
receive the status value for each checked status word.
The following table describes when and what the panel will write to each status word.
Status Word Description
Screen Status Word The panel will write the number of the current main screen to this word
whenever the main screen changes.
Command Flag Ack. Word The panel will write the states of all the effective command flags to this word
whenever there is any state change occurring on the effective command
flags.
Current Recipe Number Word The panel will write the current recipe number of recipe block #0 to this word
whenever a different recipe becomes the current recipe of recipe block #0.
This section describes how to use the general commands provided by the type A command block. To issue a general
command, specify necessary parameters in the parameter registers and then turn on command flag #15 in Command
Flag Register.
You can request the panel to perform the following file operations using the general command and the default
filename:
Parameter One
Parameter Two Register
Operation Register Default Filename Format
(Data ID)
(Operation code)
Save logged data to TXT file 1 ID of the data logger DL<ID>_<Date>_<Time>.txt
(0~15)
Save logged data to CSV file 14 ID of the data logger DL<ID>_<Date>_<Time>.csv
(0~15)
Save logged alarms to TXT 2 (Not required) AL_<Date>_<Time>.txt
file
Save logged alarms to CSV 15 (Not required) AL_<Date>_<Time>.csv
file
Save alarm counts to TXT file 3 (Not required) AC_<Date>_<Time>.txt
Save alarm counts to CSV file 16 (Not required) AC_<Date>_<Time>.csv
Save recipe data to TXT file 4 ID of the recipe block RB<ID>.txt
(0~15)
Save recipe data to CSV file 17 ID of the recipe block RB<ID>.csv
(0~15)
Save recipe data to DAT file 5 ID of the recipe block RB<ID>.dat
(0~15)
Print screen to BMP file (256 6 Number of the screen S<ID>_<Date>_<Time>.bmp
colors)
If the target panel is PE, the
color resolution follows the
setting of the PC
Print screen to BMP file (64K 7 Number of the screen S<ID>_<Date>_<Time>.bmp
colors)
If the target panel is PE, Print
screen to JPG file
Save logged operations to 9 (Not required) OL_<Date>_<Time>.txt
TXT file
Save logged operations to 18 (Not required) OL_<Date>_<Time>.csv
CSV file
Save logged data to LDF file 10 ID of the data logger DL<ID>_<Date>_<Time>.ldf
(0~15)
Take picture and save it to 12 ID of the USB camera CAM<ID>_<Date>_<Time>.b
BMP file (0~3) mp
Take picture and save it to 13 ID of the USB camera CAM<ID>_<Date>_<Time>.jpg
JPG file (0~3)
Note for default filename format:
<ID>: ID of the data logger, ID of the recipe block, ID of the USB camera, or number of the screen
<Date>: date when saving the data; format is YYMMDD
<Time>: time when saving the data; format is hhmmss
This section describes how to define the clock operations for the panel application using the Clock dialog box. The
following is an example of the Clock dialog box.
The following table describes each property in the Passwords dialog box.
Property Description
Write Write Time/date to Select this option so the panel will write time and date information to the
PLC specified variable.
Time/date Data Type Select one of the following data type for the output time and data information.
Data Type Description
6 BCD bytes The following shows the data structure.
Byte No. Content
0 Minute; 0~59
1 Hour; 0~23
2 Day; 1~31
3 Month; 1~12
4 Year; 00~99
5 Day-of-week; 0(Sunday)~6(Saturday)
Note: All the values are in BCD format.
Continued
Write Address Specifies the variable that will receive the output time and date information.
Write Timed When this item is selected, the panel writes time and date information to the
Operation specified variable periodically at a rate specified in the Interval field. You can
specify an interval between 1 and 255 minutes.
Triggered When this item is selected, the panel writes time and date information to the
specified variable whenever the specified trigger bit changes from Off to On.
Continued
Property Description
Read Synchronize Panel Select this option so the panel will read time and date information from the
with PLC specified variable and adjust its clock accordingly.
Time/date Data Type Specifies the data type for the input time and data information. For details, see
the description of the Time/date Data Type field of the Write group.
Read Address Specifies the variable that the panel will read the time and date information.
Do not run panel The password keypad will close automatically when it gets no input from the
application until the operator for the specified time.
restart
synchronization is
done successfully
Read Timed When this item is selected, the panel reads time and date information from the
Operation specified variable periodically at a rate specified in the Interval field. You can
specify an interval between 1 and 255 minutes.
Triggered When this item is selected, the panel reads time and date information from the
specified variable whenever the specified trigger bit changes from Off to On.
Increase Hour Select this option so you can increase the panel's clock by one by changing the
specified trigger bit from Off to On.
Decrease Hour Select this option so you can decrease the panel's clock by one by changing
the specified trigger bit from Off to On.
This section describes how to set up the passwords for the panel application using the Passwords dialog box. The
following is an example of the Passwords dialog box.
The following table describes each property in the Passwords dialog box.
Property Description
Password The Password column contains 8 fields. You can specify the password for a user level
in the corresponding field. A password is a positive integer up to 8 digits. A password
must be unique within the application.
Comment The Comment column contains 8 editable fields. You can type the comment for a
password or user level in the corresponding field.
9 Check this item if you want the developer password to be the password with the
highest privilege.
Automatic login for The password keypad will display to get a password with a higher user level when the
operations requiring a operator touches an object that requires a higher user level than the current one to
higher user level perform the programmed operation.
Login Trigger Bit When the specified trigger bit changes from Off to On, the password keypad will
display to get a password. The operator can enter a valid password or cancel the
password keypad.
Logout Trigger Bit When the specified trigger bit changes from Off to On, the current user level is reset to
0.
Login Timeout The password keypad will close automatically when it gets no input from the operator
for the specified time.
The following table describes how each type of the screen opens, closes and displays.
Types Description
Normal Screen A screen that will be shown up when it is selected to be a startup screen or a screen button
with open screen/previous screen operation is pressed.
Usually the normal screen can not be closed until the other normal screen is opened.
The normal screen is also called a main screen that displays only one at a time in the panel.
The screen size depends on the panel model and it is fixed.
Window A screen that appears in the following situation:
Screen Screen button with open screen operation is pressed
Selected to be a startup screen
OPEN_WS macro command is used.
Alarm is active or clear if display screen option in the discrete/analog alarm block is
selected
Page selector object is used
Custom keypad is needed
Usually the window screen stays on the normal screen until you press the close button on the
title bar or use screen button or CLOSE_WS macro command to close. It then disappears.
Usually the menu screen stays on the normal screen or window screen until you press
anywhere outside the menu screen or use screen button to close. It then disappears.
Note: In each panel application, both the screen name and the screen number have to be unique.
■ Opening Screens
To open a screen, you can do one of the followings:
1) In the Project Manager tool window, double click the screen you want to open
2) On the Screen menu, click Open Screen… In the Open Screen dialog box, select one or multiple screens and
click Open button to open all the selected screens.
The following is an example of Open Screen dialog box.
To set up a current screen, an opened screen which is on the top, you can do one of the followings:
1) In the Project Manager tool window, double click the current screen.
2) Right click the blank area on the current screen, and then click Screen Properties… on the popup menu.
3) On the Screen menu, click Screen Properties…
The Screen Properties dialog box contains the following pages. Some of the pages appear only when they are
needed.
■ General
Described in Section 3.10.3.1.
■ Background
Described in Section 3.10.3.2.
■ Keys
Described in Section 3.2.2.
■ Open Macro / Close Macro / Cycle Macro
Described in Section 14.2.6.
This section describes how to define the general settings for a screen. The following is an example of the General
page of the Screen Properties dialog box.
Property Description
Width Specifies the width (in pixels) of the screen. This field is available to edit when
the Type is Window Screen and Menu Screen.
Height Specifies the height (in pixels) of the screen. This field is available to edit when
the Type is Window Screen and Menu Screen.
Shown on Display Center Check this option if you want the window screen is shown on display center. This
field is available when the Type is Window Screen.
Shown At Check this option if you want the window screen is shown at the specified
position. This field is available when the Type is Window Screen.
X Specifies the X coordinate of the window screen’s upper-left corner in pixel on
the normal screen.
Y Specifies the Y coordinate of the window screen’s upper-left corner in pixel on
the normal screen.
Title Bar Select this option if you want the window screen to have a title bar to show the
specified title when the Type is Window Screen.
Close Button Select this option if you want the window screen to have a close Button when the
Type is Window Screen and the Title Bar field is checked.
Language Select a language so you can view and edit the settings of the title for that
language. This field is available when the Type is Window Screen and Title Bar
field is checked.
Title Specifies the title for the Title Bar. This field is available when the Type is
Window Screen and Title Bar field is checked.
Base <Check Box> Check this option if you want to have a base screen for the current screen
Screen <Combo Box> Specifies the screen to be a base screen. This field is available when the Base
Screen is checked.
OPEN Macro Check this item if you want the screen to have the OPEN macro.
An Open Macro is run once when the associated screen is being opened. The
target panel will not display the screen until the Open Macro terminates. You can
use OPEN macro to initialize global data and settings for the screen.
CLOSE Macro Check this item if you want the screen to have the CLOSE macro.
A Close Macro is run once when the associated screen is being closed. The
target panel will not erase the screen until the Close Macro terminates.
CYCLE <Check Box> Check this item if you want the screen to have the CYCLE macro.
Macro A Cycle Macro is run all the time while the associated screen is open. The target
panel runs Cycle Macros cyclically, i.e. it will run a Cycle Macro starting from the
first command again each time after it completes the processing of the last
command of the macro or when it encounters an END command in the middle of
the macro. And the cycle macro terminates immediately if the screen is closed.
Cycle Macro Specifies the delay time in 0, 100, 200, 300, 400, 500, 600, 700, 800, 900, 1000
Delay Time milli-second for the cycle macro.
Print Whole Screen Check this item if you want to print the whole screen by Command Flag or
Function Button or Macro Command
Upper-left Specifies the X and Y coordinates in pixel for the upper-left corner of the screen’s
printing area. The field is available when Whole Screen item is unchecked.
Lower-Right Specifies the X and Y coordinates in pixel for the lower-right corner of the
screen’s printing area. The field is available when Whole Screen item is
unchecked.
Position on Specifies the X and Y coordinates in millimeters for the position where the
Paper specified area of the screen will print on paper..
Continued
Background Page
This section describes how to define the background of a screen. The following is an example of the Background
page of the Screen Properties dialog box.
This section describes how to export a screen and import a screen regardless of the panel model and screen size.
■ Importing a screen
1) Right-click the panel application > Screens item in the Project Manager tool window to bring out the popup menu
and then use the Import Screen… command on the popup menu
4) Click the *.snf file you want to create a new screen from. If you want to open a screen that was saved in a
different folder, locate and open the folder first.
5) Click Open.
■ Exporting a screen
If you have screen you want to reuse, you can export the screen as a .snf file. You may do the following:
4) In the Project Manager tool window, click the screen you would like to export
5) Right-click on the screen to display the screen item's "popup menu"; and then click Export Screen..., the fourth
menu item.
6) If you want to save a macro in a different folder, locate and open the folder first. then click Save.
After Copying or Cutting, you can paste the screen by right clicking the blank area on any of the screen and then
using Paste Screen command on the popup menu or using the Paste Screen command On the Screen menu.
■ Deleting a Screen
To delete a screen which is opened and activated, right click the blank area on the screen, and then click Delete
Screen on the popup menu or use the Delete Screen command on the Screen menu.
To delete a screen from project manager tool window, local the screen you would like to delete and then right-click on
the screen node to use the Delete command on the popup menu. You will be asked to confirm the deleting operation.
4 Designer Screens
eV Designer provides a drawing tool you can use to create simple or elaborate drawing shapes such as lines,
rectangles, circles, arcs etc.
To create a drawing shape, click the shape on the Draw Toolbar (See Section 1.3.2.3 Draw Toolbar for details), or use
the command on the Draw menu (See Section 1.3.1.3 Draw menu for details) and then move the mouse to the
position you want to place the shape and click the left button. To set up a drawing shape, double-click the shape to
bring up the corresponding properties dialog that you can set up the color and style of the line/outlined, pattern,
FG/BG Color…of the shape.
Note: If you don’t see the Draw Toolbar as below in the lower left corner of the program window, please click Draw
Toolbar command on the View menu.
The following table describes each property in the Dot dialog box.
Property Description
Style
5. You can click the following icons in the Draw toolbar to modify the properties of the dot.
Click Icon To
1. In the Draw menu or Draw toolbar, click Line to draw a straight line. You can also click Horizontal
Line to draw a horizontal line or click Vertical Line to draw a vertical line.
2. Move the cursor onto the screen where you want to draw a line. A line with default settings will display and
move along with the cursor.
3. Click the desired position on the screen to place the line. The start point of the line will be at the clicked
position.
4. Drag the handle at the start point to adjust the position of the start point. Drag the handle at the end point to
adjust the position of the end point.
The picture on the left shows the two handles of a line. Position the mouse
pointer over one of the handles. When the cursor turns to be , drag the handle
until the line has the length and slope you want.
5. Left-click and hold down the mouse button until the cursor becomes cross icon to move the line.
6. Double-click the line to bring up the Line dialog box and then modify the settings of the line. The following is
a sample of Line dialog box.
Color Controlled Check this option if the color of the line will be controlled by the specified
By Bit bit.
State Select the state that you want to view or define the color for.
Color Specifies the line color for the selected state.
Control Bit Specifies the bit that controls the color.
Click to enter the bit address. Click to enter the bit tag.
Start / Start/End Point Select this option if you want the line to have a shape at the start/end
End point.
Point
Type Clicks the dropdown list to select the type for Start/End Point
Filled Select this option if you want the shape to be filled with the line color.
Size Specifies the shape size.
Terminal X1 The X coordinate of the start point.
Y1 The Y coordinate of the start point.
X2 The X coordinate of the end point.
Y2 The Y coordinate of the end point.
Visibility Visibility Check this option if the line will be shown or hidden by the specified bit.
Control Controlled By Bit
Control Bit Specifies the bit that shows or hides the object.
Click to enter the bit address. Click to enter the bit tag.
Visible State Specifies the state (On or Off) that makes the line visible.
7. You can click the following icons in the Draw toolbar to modify the properties of the line.
Click Icon To
The picture on the left shows all the blue and black handles of a
polyline. Position the mouse pointer over one of the handles. When the
cursor turns to be or or or , drag the handle until the polyline
is the shape and size you want.
7. Right-click anywhere on the polyline and use the Insert Point command on the object popup menu to
insert a new point for the polyline. Or right-click the existing point of the polyline and use the Delete Point
command on the object popup menu to delete the point.
Popup menu Description
Add a point at the specified position.
Insert Point
Delete Point
The following table describes each property in the Polyline dialog box.
Property Description
Line Style Specifies the style of the polyline.
Color Controlled Check this option if the color of the polyline will be controlled by the
By Bit specified bit.
State Select the state that you want to view or define the color for.
Color Specifies the line color for the selected state.
Control Bit Specifies the bit that controls the color.
Click to enter the bit address. Click to enter the bit tag.
Start Start Point Select this option if you want the polyline to have a shape at the start
Point point.
Type Specifies the shape type.
Filled Select this option if you want the shape to be filled with the line color.
Size Specifies the shape size.
End End Point Select this option if you want the polyline to have a shape at the end point.
Point
Type Specifies the shape type.
Filled Select this option if you want the shape to be filled with the line color.
eV Manual V1.2a - 17.03.2010
138
Manual
Size Specifies the shape size.
Description
Property
Profile Left The X coordinate of the upper-left corner of the bounding rectangle of the
polyline.
Top The Y coordinate of the upper-left corner of the bounding rectangle of the
polyline.
Width The width of the bounding rectangle of the polyline.
Height The height of the bounding rectangle of the polyline.
Visibility Visibility Check this option if the polyline will be shown or hidden by the specified
Control Controlled By Bit bit.
Control Bit Specifies the bit that shows or hides the polyline.
Click to enter the bit address. Click to enter the bit tag.
Visible State Specifies the state (On or Off) that makes the line visible.
9. You can click the following icons in the Draw toolbar to modify the properties of the polyline.
Click Icon To
1. In the Draw menu or Draw toolbar, click Rectangle to draw a normal rectangle. You can also click
Round Rectangle to draw a round rectangle or click Clipped Rectangle to draw a clipped
rectangle.
2. Move the cursor onto the screen where you want to draw a rectangle. A rectangle with default settings will
display and move along with the cursor.
3. Click the desired position on the screen to place the rectangle. The upper-left corner of the rectangle will be
at the clicked position.
4. Drag one handle of the rectangle at a time to resize the rectangle.
The picture on the left shows the eight handles of a rectangle. Position the mouse pointer
over one of the handles. When the cursor turns to be or or or , drag the
handle until the rectangle is the shape and size you want.
5. Double-click the rectangle to bring up the Rectangle dialog box and then modify the settings of the
rectangle. The following is a sample of Rectangle dialog box.
Specifies the type of the rectangle. There are three types: Normal, Round, or Clipped.
Normal Round Clipped
Type
Property Description
Number Specifies the size of the clipped corners if the rectangle is a clipped rectangle. Specifies the
of Dots radius of the round corners if the rectangle is a round rectangle.
Continued
6. You can click the following icons in the Draw toolbar to modify the properties of the rectangle.
Click Icon To
Select a color for painting the white part of the fill pattern.
Select a color for painting the black part of the fill pattern.
5. Position the mouse pointer over the handle on the center of the circle. When the cursor turns to be , left-
click the center and hold down the button to move the circle.
6. Double-click the circle to bring up the Circle dialog box and then modify the settings of the circle.
Property Description
Color Color Controlled Check this option if the color of the circle will be controlled by the
Control By Bit specified bit.
Control Bit Specifies the bit that controls the color.
Click to enter the bit address. Click to enter the bit tag.
State Select the state that you want to view or define the colors for.
Outline Outlined Check this option if you want the circle to be outlined.
Color Specifies the outline color for the selected state.
Solid Solid Check this option if you want the circle to be solid. A solid circle is filled
with the specified pattern and colors.
Pattern Specifies the fill pattern for the selected state.
FG Color Specifies the color for the selected state that will be used for painting the
black part of the fill pattern.
BG Color Specifies the color for the selected state that will be used for painting the
white part of the fill pattern.
Profile X The X coordinate of the center of the circle.
Y The Y coordinate of the center of the circle.
Radius The radius of the circle.
Visibility Visibility Check this option if the circle will be shown or hidden by the specified bit.
Control Controlled By Bit
Control Bit Specifies the bit that shows or hides the circle.
Click to enter the bit address. Click to enter the bit tag.
Visible State Specifies the state (On or Off) that makes the circle visible.
7. You can click the following icons in the Draw toolbar to modify the properties of the circle.
Click Icon To
Select a color for painting the white part of the fill pattern.
Select a color for painting the black part of the fill pattern.
The picture on the left shows the eight handles of an ellipse. Position the mouse
pointer over one of the handles. When the cursor turns to be or or or ,
drag the handle until the rectangle is the shape and size you want.
5. Double-click the ellipse to bring up the Ellipse dialog box and then modify the settings of the ellipse.
The following is a sample of the Ellipse dialog box.
The following table describes each property in the Ellipse dialog box.
Property Description
Color Color Controlled Check this option if the color of the ellipse will be controlled by the
Control By Bit specified bit.
Control Bit Specifies the bit that controls the color.
Click to enter the bit address. Click to enter the bit tag.
State Select the state that you want to view or define the colors for.
Continued
6. You can click the following icons in the Draw toolbar to modify the properties of the ellipse.
Click Icon To
Select a color for painting the white part of the fill pattern.
Select a color for painting the black part of the fill pattern.
The picture on the left shows the handles of an arc. The blue handles are for shaping
the arc. The black handles of the two ends of the arc are for changing the ends' angles.
The black handle at the center of the arc is for forcing the arc to be a part of a circle.
Position the mouse pointer over one of the handles. When the cursor turns to be or
or or , drag the handle until the arc is the shape and size you want.
5. Double-click the arc to bring up the Arc dialog box and then modify the settings of the arc.
The following is a sample of Arc dialog box.
The following table describes each property in the Arc dialog box.
Property Description
Color Specifies the color of the arc.
Profile Left The X coordinate of the upper-left corner of the bounding rectangle of the arc.
Top The Y coordinate of the upper-left corner of the bounding rectangle of the arc.
Width The width of the bounding rectangle of the arc.
Height The height of the bounding rectangle of the arc.
6. You can click the following icons in the Draw toolbar to modify the properties of the arc.
Click Icon To
1. In the Draw menu or Draw toolbar, click Pie to draw a pie shape.
2. Move the cursor onto the screen where you want to draw a pie shape. A pie shape with default settings will
display and move along with the cursor.
3. Click the desired position on the screen to place the pie shape. The upper-left corner of the bounding
rectangle of the pie shape will be at the clicked position.
4. Drag one handle of the pie shape at a time to change the pie shape.
The picture on the left shows the handles of a pie shape. The blue handles are
for changing the pie shape. The black handles of the two ends of the arc are for
changing the ends' angles. The black handle at the center of the arc is for forcing
the arc to be a part of a circle.
Position the mouse pointer over one of the handles. When the cursor turns to be
or or or , drag the handle until the pie is the shape and size you want.
5. Double-click the pie shape to bring up the Pie dialog box and then modify the settings of the pie shape.
The following table describes each property in the Pie dialog box.
Property Description
Outline Outlined Check this option if you want the pie shape to be outlined.
Color Specifies the outline color.
Solid Solid Check this option if you want the pie shape to be solid. A solid pie shape is filled
with the specified pattern and colors.
Pattern Specifies the fill pattern.
FG Specifies the color that will be used for painting the black part of the fill pattern.
Color
BG Specifies the color that will be used for painting the white part of the fill pattern.
Color
Profile Left The X coordinate of the upper-left corner of the bounding rectangle of the pie
shape.
Top The Y coordinate of the upper-left corner of the bounding rectangle of the pie
shape.
eV Manual V1.2a - 17.03.2010
149
Manual
Width The width of the bounding rectangle of the pie shape.
Height The height of the bounding rectangle of the pie shape.
6. You can click the following icons in the Draw toolbar to modify the properties of the pie shape
Click Icon To
Select a color for painting the white part of the fill pattern.
Select a color for painting the black part of the fill pattern.
The picture on the left shows the handles of a polygon. The blue
handles are for resizing the polygon. The black handles are for moving
the vertices of the polygon.
Position the mouse pointer over one of the handles. When the cursor
turns to be or or or , drag the handle until the polygon is the
shape and size you want.
7. Right-click anywhere on the polygon and use the Insert Point command on the object popup menu to
insert a new point for the polygon. Or right-click the existing point of the polygon and use the Delete Point
command on the object popup menu to delete the point.
Insert Point
Delete Point
The following table describes each property in the Polygon dialog box.
Property Description
Color Color Controlled Check this option if the color of the polygon will be controlled by the
Control By Bit specified bit.
Specifies the bit that controls the color.
Control Bit
Click to enter the bit address. Click to enter the bit tag.
State Select the state that you want to view or define the colors for.
Outline Outlined Check this option if you want the polygon to be outlined.
Thickness Specifies the thickness of the outline.
Color Specifies the outline color for the selected state.
Solid Check this option if you want the polygon to be solid. A solid polygon is
Solid
filled with the specified pattern and colors.
Pattern Specifies the fill pattern for the selected state.
Specifies the color for the selected state that will be used for painting the
FG Color
black part of the fill pattern.
Specifies the color for the selected state that will be used for painting the
BG Color
white part of the fill pattern.
Continued
9. You can click the following icons in the Draw toolbar to modify the properties of the polygon.
Click Icon To
Select a color for painting the white part of the fill pattern.
Select a color for painting the black part of the fill pattern.
Note 1: You can use the Text toolbar to modify the properties of the text object's text instantly.
Note 2: You can use the Draw toolbar to modify the properties of the text object's shape instantly.
Tip: By default, the Auto Text Resizing on the Edit menu is checked and the related icon on the Edit
toolbar is
sunken. If you don’t want to resize the text when resizing the object, you need to uncheck the Auto Text
Resizing command on the Edit menu or click the sunken icon on the Edit toolbar to make the font
size fixed.
This section describes how to define the general settings for text objects.
The above is an example of the General page of the Text Object dialog box.
Position
Border Spacing The margin (in pixels) to the border of the object’s shape for the text body.
Line Spacing The distance (in pixels) between two adjacent lines of the text.
Character
The distance (in pixels) between two adjacent characters of the text.
Spacing
The following table describes each property in the Picture Object dialog box.
Property Description
The name of the picture that the object displays. You can use the drop-down list to
select a picture from the picture database.
Click to select a picture from a file. After the selection, eV Designer imports the
Name picture of the selected file and saves the picture in the picture database.
Click to bring up the Select/Import from Library dialog box. Select a picture from a
picture library file. After the selection, eV Designer imports the selected picture from the
selected library and saves the picture in the picture database.
View Shows the processed result of the selected picture according to the current settings.
Continued
eV Manual V1.2a - 17.03.2010
157
Manual
Property Description
Check this item so the picture can change its size automatically to just fit
Fit to Object
inside the object.
Check this item to make parts of the picture transparent. The transparent
Transparent parts are pixels whose colors are identical to the specified transparent color.
This item is available when the picture is not a black and white picture.
The transparent color. This item is available when the picture is not a black
Transparent Color
and white picture.
The color to paint the black part of a black and white picture. This item is
FG Color
available when the picture is a black and white picture.
The color to paint the white part of a black and white picture. This item is
BG Color
available when the picture is a black and white picture.
Flip/Rotate Specifies the method to flip or rotate the picture before drawing it. There are
8 options:
Method Description
0° Do nothing
90° Rotates the picture clockwise by 90 degree
180° Rotates the picture clockwise by 180 degree
270° Rotates the picture clockwise by 270 degree
X Flips the picture over X axis
90° & X Rotates the picture clockwise by 90 degree and flips it over
X Axis
Y Flips the picture over Y axis
90° & Y Rotates the picture clockwise by 90 degree and flips it over
Y Axis
Tone Check this item to tone the picture.
Toning Color The color to tone the picture.
Visibility Visibility Check this option if the picture will be shown or hidden by the specified bit.
Control Controlled By Bit
Control Bit Specifies the bit that shows or hides the picture object.
Click to enter the bit address. Click to enter the bit tag.
Visible State Specifies the state (On or Off) that makes the picture visible.
Profile Left The X coordinate of the upper-left corner of the object.
Top The Y coordinate of the upper-left corner of the object.
Width The width of the object.
Height The height of the object.
Redraw Click this button to redraw the object on the screen with the current settings.
Dynamic Dynamic Check this item if you want the numbers of the scale ticks and the range of the scale
Range Range marks to be dynamic, i.e. to be controlled by the specified variable.
Parameter Specifies the variable that controls the numbers of the scale ticks and the range of the
Block scale marks. The variable is an array of four double-words (8 words). The following table
describes the data members of the array.
Word # Data Type Description
0, 1 32-bit unsigned integer The number of major ticks. The allowable range of
this number is between 2 and 101.
2, 3 32-bit unsigned integer The number of divisions between two adjacent
major ticks. The allowable range of this number is
between 1 and 100.
4, 5 32-bit signed integer The minimum of the scale marks.
6, 7 32-bit signed integer The maximum of the scale marks.
Example
Assume a scale’s dynamic range control block is $U100. The following macro commands
makes that scale look like this:
$U100 = 3 (UD) // The number of major ticks.
$U102 = 5 (UD) // The number of sub-divisions.
$U104 = 0 (SD) // The minimum of the scale marks.
$U106 = 100 (SD) // The maximum of the scale marks.
Color The color of the scale. To specify the color, click the corresponding Color icon and select
a color from the Color palette.
Number of Major Ticks The number of major ticks. The minimum you can specify is two.
Number of Sub The number of divisions between two adjacent major ticks. The minimum you can specify
Divisions is one.
Minor Tick Length The length of minor ticks.
Axis Check this item if you want the scale to have an axis.
Marks Marks Check this option if you want the scale to have marks.
Font The font of the marks.
Minimum The minimum of the marks. It is a 32-bit integer.
Maximum The maximum of the marks. It is a 32-bit integer.
Total Digits The total digits to be displayed for the marks.
Fractional The number of fractional digits for the marks. For example, when the Maximum is 5000,
Digits the Total Digits is 4, and the Fractional Digits is 2, the mark for the Maximum will be 50.00.
Reverse Check this option if you want the marks of the scale to show in reverse order. In normal
Order order, the maximal mark is at the right end or top end of the scale. In reverse order, the
eV Manual V1.2a - 17.03.2010
160
Manual
maximal mark is at the left end or bottom end of the scale.
Note: Only 23 types of the objects can be placed in the cells of the table. The supported objects are Picture,
Dot, Text, Bit Button, Toggle Switch, Word Button, Multistate Switch, Screen Button, Function Button,
Keypad Button, Numeric Display, Numeric Entry, ASCII String Display, ASCII String Entry, Bit Lamp,
Multistate Lamp, Time Display, Date Display, Day-of-Week Display, Message Display, Bar Graph, Picture
Display, GIF Display, Advanced Numeric Display.
5. Click the cell inside the table. If the cell contains the object, there will be the icon on the upper-left corner
of the cell. The following is an example shown you how to edit the object in the table.
6. Position the mouse point over one of the grid lines. When the cursor turns to be or , drag the line until
the column is the width and the row is the height you want.
Note: You can adjust the width of the column when the Distribute columns evenly is not selected in the
general page of the Table dialog box. And you can adjust the height of the row when the Distribute rows
evenly is not selected in the general page of the Table dialog box.
7. Double-click anywhere inside the table, exclusive of the icon, to bring up the Table dialog box and then
define the settings for the table. This dialog box contains the following two pages:
■ General
Described in Section 4.1.13.1.
■ Cell
Described in Section 4.1.13.2.
The following table describes each property in the General page of the Table dialog box.
Property Description
ID The object’s identifier. It is generated when the object is created and is
unchangeable. The identifier is unique within the screen where the object is on.
The format of the ID’s for the tables is TBLnnnn.
Note You can type a note for the object.
Shape settings For details about the following properties, see Section 4.3.4 Setting up the Shape
of an Object. , Border Color, BG Color
Cell Number of rows Specifies the number of rows in the table.
Number of Specifies the number of columns in the table.
columns
Distribute rows Check this option if you want the rows of the table to be distributed evenly always.
evenly Uncheck this option if you want to adjust the heights of the rows.
Distribute columns Check this option if you want the columns of the table to be distributed evenly
evenly always. Uncheck this option if you want to adjust the widths of the columns.
Drag and drop Check this option so you can drag and drop an object into a cell of the table. Note
that not all kinds of objects can be placed in the cells of the table.
Grid Vertical Check this option if you want the table to have vertical grid lines.
Horizontal Check this option if you want the table to have horizontal grid lines.
Style Specifies the style for the grid lines.
The following table describes each property in the Cell page of the Table dialog box. To make the buttons available,
you need to select a row. To select a row, left-click the (Row, Column) column.
Property Description
(Row,Column) The location of the cell.
Object The type of the specified object. If the field is empty, the cell has no object inserted and it is
called empty cell.
Click the button to bring up the properties dialog box of the specified object and define the
settings of the object for the selected cell. The button is available when the Object field is not
empty.
Margin The distance in pixels between the object boundary and the cell border. Select a number
between 0 and 10.
Delete Click the button to clear the contents of the selected cell. The button is available when the
selected cell is non-empty.
Insert Click the button to bring up the Select Object Dialog Box shown above. And select an object
type listing in the dialog to create a new object for the selected cell. The button is available
when the selected cell is empty.
Note: The table won’t allow to insert the type of an object which is not listed in the dialog.
Move Up Click the button to move the selected cell before the previous cell. It will not be available when
multiple rows are selected or no row is selected or the first row is selected.
Move Down Click the button to move the selected cell after the next cell. It will not be available when
multiple rows are selected or no row is selected or the last row is selected.
In this section you will learn how to select the objects first and then move around, copy, or edit the selections without
affecting the rest of the screen.
Each of the selected objects will have blue square-shaped tabs around it. The object with solid tabs is the reference
object.
To group the selection, click on the edit toolbar, or use the Group command on the Edit menu or on the object
popup menu. After you have grouped a selection that includes at least two objects, you can copy, move and resize all
objects in a group as a single unit. Or you can select an object within the group and change the properties without
ungrouping. You can also save the group to the object library and use this object group in the animated graphic.
To ungroup the selected group, click on the edit toolbar, or use the Ungroup command on the Edit menu or on
the object popup menu. After ungrouping the objects, the objects within the group will be restored to the single ones.
■ Resizing Objects
The square-shaped tabs around your object can be re-sized. You can resize by clicking on the square-shaped tabs
located at the corners and the middle sections of the bound rectangle area, holding the mouse button down, when the
cursor turns to be or or or , dragging the mouse to change the size of the selection. Release the mouse
button when the selection is the size you want it to be. You can make it bigger or smaller, and achieve a distorted
effect by "squashing" or "stretching" the selection to make it either wider/narrower or taller/shorter than its original
proportions.
Tip: You can’t resize more than one object at a time unless you group multiple objects before resizing.
To automatically scale the text of the object when resizing the object, click on the edit toolbar if it is raised, or use
the Auto Text Resizing command on the Edit menu.
To pin the selection so it can not move, click on the edit toolbar, or use the Pin command on the Edit menu or on
the object popup menu.
To unpin the selection so it can move again, click on the edit toolbar, or use the Unpin command on the Edit
menu or on the object popup menu.
Tip: Pinning objects can still be resized.
To copy the selection from the current screen and places it on the Windows clipboard, press Ctrl+C, or click
on the standard toolbar, or use the Copy command on the Edit menu or on the object popup menu.
To cut the selection from the screen, press Ctrl+X, or click on the standard toolbar, or use the Cut command on
the Edit menu or on the object popup menu.
After Copying or Cutting, you can paste the selection by pressing Ctrl+V, or click on the standard toolbar, or use
the Paste command on the Edit menu or on the object popup menu.
To copy and paste the selection by mouse, press and hold down Ctrl key,
and then left-click the selection and hold down the button. When the cursor
turns to be , drag the mouse to copy the selection to another area of the
screen. The picture on the right shows the example.
Tip: Cut and Paste are good for moving objects around in the screen or to another screen.
Copy and Paste are good for duplication objects for current screen or some others screens.
By pasting multiple times on the current screen, you can achieve a cascading effect.
By pasting once to the different screen, the position of the pasted object will be same as the copied object
in the different screen.
■ Deleting Objects
To delete the selection, press Del or use the Delete command on the Edit menu or on the object popup menu. When
you use Delete, whatever is in the selection will be deleted.
■ Undo
To reserve the last action, press Ctrl+Z, or use the Undo command on the Edit menu.
■ Redo
To reapply the actions that were previously canceled by the Undo command. press Ctrl+Z, or use the Redo command
on the Edit menu.
■ Keyboard Shortcuts
【Ctrl+O
Open Project 【Ctrl+C】 Copy 【Ctrl+F】 Find
】
eV Manual V1.2a - 17.03.2010
168
Manual
【Ctrl+S】 Save 【Ctrl+V】 Paste 【Ctrl+R】 Replace
【Ctrl+Click+move
【Ctrl+Z】 Undo Copy & Paste 【Ctrl+A】 Select All
】
【Shift+Click
【Ctrl+Y】 Redo 【Del】 Delete Multiple Select
】
【Ctrl+Click
Reference Object Select
】
Preview
addresses
To Grid Select or deselect the option of aligning objects to the grid points.
Nudge the selection left. When the Snap to Grid option is not selected, all objects
of the selection move one pixel left. When the Snap to Grid option is selected,
Left
each object of the selection moves left to where its upper-left corner aligns to the
nearest grid point.
Nudge the selection right. When the Snap to Grid option is not selected, all objects
of the selection move one pixel right. When the Snap to Grid option is selected,
Right
each object of the selection moves right to where its upper-left corner aligns to the
nearest grid point.
Nudge
Nudge the selection up. When the Snap to Grid option is not selected, all objects
of the selection move one pixel up. When the Snap to Grid option is selected, each
Up
object of the selection moves up to where its upper-left corner aligns to the nearest
grid point.
Nudge the selection down. When the Snap to Grid option is not selected, all
objects of the selection move one pixel down. When the Snap to Grid option is
Down
selected, each object of the selection moves down to where its upper-left corner
aligns to the nearest grid point.
Width Make the selected objects have the same width as the reference object.
Make
Same Height Make the selected objects have the same height as the reference object.
Size
Make the selected objects have the same width and height as the reference
Both
object.
Start the order setting process for the objects of the active screen. For
Set Order
details, please see Section 4.2.6.1 Changing the Order of Objects
The object order is also the display order. If the screen contains overlapping the objects, change the order will
change the display sequence of the objects. The objects that come later in the order are always displayed on top of
any overlapping objects that precede them in the order.
■ Viewing order
To view the current order of all objects in the screen, click Set Order on the Edit menu.
■ Changing order
To change the order for all objects in the screen
1) On the Edit menu, click Set Order
A Number in the upper-left corner of each object shows its place in the current order
2) Set the order by clicking each object in the order you want to display the object. The ordering number starts
from 1.
3) Click the blank field on the screen to exit Set Order mode
If the screen running on 037-LSK, click the down or right direction key to move the selection in 2-4-6-8-10-12-14-16-
18 -20-29 sequence. If the screen running on the touch panel, click function button to move the selection in the
same sequence. The text objects with 1,3,5…order number are not data entry object, so they won’t receive the
selection and don’t list in the sequence.
There are four common components of object appearance. They are described in the following table:
Appearance Component Description
Shape The shape of an object can either be a graphical shape or a picture shape.
The following are examples of graphical shapes
eV Designer provides many graphical shapes for you to choose. For details, see
Section 4.3.3 Selecting a Graphical Shape. The color or the pattern of a graphical
shape is dependent on the state of the associated object. You need to specify the color
or pattern settings of a graphical shape for each state of the associated object. For
details, see Section 4.3.1 Selecting a Color and Section 4.3.2 Selecting a Pattern.
If you want an object to have a picture shape, check the item Picture Shape in the
General Page of the object’s property dialog box. You can select a picture from the
picture database or import a picture from a library file for the shape of an object. Any
picture with the format of BMP, JPG, or WMF can be a picture shape. When a picture is
used as a shape, the shape is state independent, i.e. the same look appears for all
(object) states. If you want a picture shape to display the object state and/or show the
touch action, you need to select a picture group as the shape. For details of picture
groups, see Section 2.1.3.3 Picture Groups
To know how to set a shape, see Section 4.3.4 Setting up the Shape of an Object.
Inner Label An inner label is a label inside the associated object. It has the same number of states
as the associated object. You need to specify the text settings and the picture settings
of an inner label for each (object) state. Inner labels are language dependent. You need
to specify the text of an inner label for each language too. Note that not all objects can
have inner labels and some objects can just have text or a picture in their inner label.
To know how to set an inner label, see Section 4.3.5 Label Settings.
VFTA (Visual Feedback A button or switch can give the operator one of the following visual feedback when it is
for Touch Action) touched:
Visual Description
Feedback
Sunken Shifts the inner label to the lower-right corner by one or two
pixels.
Back Fills the area inside the border of the shape with the shape’s FG
Color.
Outline Outlines the object with the shape’s FG Color.
External Label An external label is a label outside but attached to the associated object. Unlike inner
labels, external labels are state independent. They have the same look for all (object)
states. However, external labels are language dependent. You need to set the text of an
external label for each language. External labels are touch insensitive. Touching an
external label will not activate the associated object. Note that not all objects can have
an external label.
To know how to set an external label, see Section 4.3.8 External Label Settings.
eV Manual V1.2a - 17.03.2010
174
Manual
The following table shows the common appearance components that each object type can have:
Shape Inner Label
External
Object Types Graphical Picture VFTA
Text Picture Label
Shape Shape
Bit Button, Toggle Switch, Screen Button, Word
Button, Multi-state Switch, Radio Button Group
● ● ● ● ● ●
Function Button, Keypad Button, Page Selector ● ● ● ● ●
Step Button ● ● ● ● ●
Bit Lamp, Multi-state Lamp, ● ● ● ● ●
Message Display ● ● ●
Picture Display ● ● ●
Day-of-week Display ● ●
Meter ● ●
Slide Switch, Numeric Entry, Numeric Display,
Advanced Numeric Display, ASCII Character ● ●
Entry, ASCII Character Display, Bar Graph
Time Display, Date Display, Pie Graph, Line
Chart, Scatter Chart, Alarm Display, Historic Data
Display, Historic Trend Graph, Single Record Line ●
Chart, Operation Log Display, Recipe Selector,
Recipe Table, Sub-link Table, Static Text, Table
Animated Graphic ●
The orders of drawing the common appearance components are shown in the following table with examples:
Step Draw Example 1 Example 2 Description
Final Appearance
(When untouched)
Final Appearance
(When touched)
■ Color Palette
With the Color palette, you can: 1) Select a color from a set of predefined colors, 2) Customize a set of user colors,
and 3) Select a color from a set of user colors.
Usually, you click a Color icon to bring up the Color palette. The following shows the pages of the Color palette.
On page 1, the yellow block is outlined to indicate that it is the current selection. To select a color, click on that color
block. To select a page, click on that page’s number tab. To cancel the operation click on any position other than the
color blocks and the number tabs. Page 1, 2, and 3 contain the predefined colors. Page 4 contains the user colors. To
customize user colors, click to bring up the Define Custom Color dialog box as shown below.
■ Pattern Palette
With the Pattern palette, you can select a pattern from a set of predefined patterns. Usually, you click a Pattern icon to
bring up the Pattern palette as shown below.
The “big dashes” block is outlined to indicate that it is the current selection. To select a pattern, click on that pattern
block. To cancel the operation, click on any position other than the pattern blocks.
In an object’s property dialog box, you can click the shape button to bring up the Shape palette. With the
Shape palette, you can select a graphical shape as the shape of the associated object.
■ Shape Palette
With the Shape palette, you can select a graphical shape for an object. Usually, you click to bring up the
Shape palette. The Shape palette contains several pages of graphical shapes. To select a graphical shape, click on
that graphical shape. To select a page, click on that page’s number tab. To cancel the operation, click the close button
to close the Shape palette.
There are four sets of graphical shapes available for your applications. Each of them is suitable for certain kinds of
objects. The Shape palette shows the set that is suitable for the type of the concerned object. The four sets of shapes
are shown below.
The following table describes each property that may be required for the settings of an object’s shape.
Property Description
Picture Shape Check this option if you want the object to have a picture shape instead of a graphical shape.
This option is available when the object can have a picture shape.
Click this button to specify the shape of the object. When the Picture Shape is checked, the
Select/Import from Library dialog box will display. Otherwise the Shape palette will display.
VFTA The type of VFTA (Visual Feedback for Touch Action).
Test VFTA Click this button to view the selected VFTA.
Border Color The border color of the graphical shape. Click the corresponding Color icon to specify the color.
Pattern The pattern that is used to fill the area inside the border of the graphical shape for the current
(object) state. To specify the pattern, click the corresponding Pattern icon and select a pattern
from the Pattern palette. This item is available when the area inside the graphical shape needs
be painted.
FG Color The color that is used to paint the black part of the pattern for the current (object) state. When
the solid white pattern is selected, this color is not used. When a picture shape is used, this color
is used for the outline mode with VFTA.
Example 1 Example 2
To specify the color, click the corresponding Color icon and select a color from the Color palette.
This item is available when the area inside the graphical shape needs be painted.
BG Color The color that is used to paint the white part of the pattern for the current object state. To specify
the color, click the corresponding Color icon and select a color from the Color palette. This item
is available when the area inside the graphical shape needs be painted.
The property sheets of the above mentioned objects provide you the Label page to set up the inner label. If an object
has only one state, the Label page has the Text sub-page and the Picture sub-page for you to set up the text and the
picture of the inner label respectively. If an object has two states, the Label page has the following four sub-pages:
Sub-page For Setting
OFF Text Text of state 0 (Off)
OFF Picture Picture of state 0 (Off)
ON Text Text of state 1 (On)
ON Picture Picture of state 1 (On)
You can use the Label page to set the inner label of an object that can have at most two states.
The following is an example of the Label page.
Property Description
The language that you are setting
Language
the text for.
The margin (in pixels) to the
Border Spacing border of the object’s shape for
both the text body and picture.
Use the text of Check this item so the inner label
the first always shows the text of the first
language for all language regardless of what the
other current language is.
languages
Click this tab to bring up the Text
Text tab
sub-page.
Click this tab to bring up the
Picture tab
Picture sub-page.
Click this tab to bring up the OFF
OFF Text tab
Text sub-page.
Click this tab to bring up the ON
ON Text tab
Text sub-page.
OFF Picture Click this tab to bring up the OFF
tab Picture sub-page.
Click this tab to bring up the ON
ON Picture tab
Picture sub-page.
The following table describes each property in the Text sub-page, OFF Text sub-page, and ON Text sub-page.
Property Description
Copy from Note Click this button to replace the current text by the text of Note in the General page.
Copy to ON Click this button to use the current text to replace the text of ON state.
State
Copy to OFF Click this button to use the current text to replace the text of OFF state.
State
Font The font of the text. You can use the drop-down list to select a font.
Click to bring up the Font Templates dialog box and select a font for the text. You can
change the font templates before selecting a font in that dialog box.
Color The color of the text. To specify the color, click the corresponding Color icon and select a
color from the Color palette.
Blink Check this item so the text will blink.
Transparent Check this item to make the background of the characters transparent.
BG Color The background color of the text.
Line Spacing The distance (in pixels) between two adjacent lines of the text.
Character The distance (in pixels) between two adjacent characters of the text.
Property Description
The alignment of the text.
Shape BG Color The BG color of the object’s shape for the current state.
Shape BG
The BG color of the object’s shape for the current state.
Color
The property sheets of the above mentioned objects provide you the Text page to set up the text of the inner label.
The following is an example of the Text page.
Position
Shape BG Color The BG color of the object’s shape for the current state.
Line Spacing The distance (in pixels) between two adjacent lines of the text.
Character Spacing The distance (in pixels) between two adjacent characters of the text.
The property sheets of the above mentioned objects provide you the Picture page to define the picture settings of the
objects. The following is an example of the Picture page.
Shape BG The BG color of the object’s shape for the current state.
Color
You can use the External Label page in an object's property sheet to set up the external label of that object. The
following is an example of the External Label page.
The following table describes each property in the External Label page.
Property Description
Plate Style Specifies the plate type of the external label. There are four plate types as shown
below:
Plate Type Example
Transparent,
Flat,
Outlined
Raised
Continued
eV Manual V1.2a - 17.03.2010
189
Manual
Property Description
Position Specifies the position of the external label relative to the object. There are four
positions as shown below:
Position Example
Top
Left
Right
Bottom
Color The border color of the plate. To specify the color, click the corresponding Color
Border
icon and select a color from the Color palette.
The color of the plate. To specify the color, click the corresponding Color icon and
Plate
select a color from the Color palette.
The color of the text. To specify the color, click the corresponding Color icon and
Text
select a color from the Color palette.
Language The language that you are setting the text for.
Font <Drop-down List> The font of the text for the current language
Click this button to bring up the Font Templates dialog box and select a font for
the text. You can change the font templates before selecting a font in that dialog
box.
Text <Edit Box> The text for the current language.
Click this button to bring up the Text Source dialog box and select a string for the
current text. You can change the text database before selecting a string in that
dialog box.
Spacing Border The distance (in pixels) between the plate border and the text body.
Line The distance (in pixels) between two adjacent lines of the text.
Character The distance (in pixels) between two adjacent characters of the text.
You can assign a positive integer for each state in that dialog box. To edit the value, click the row of that state on its
value column.
You can use the Move Up button and the Move Down button to adjust the position of state values. To move up or
move down the state values, you need to make a selection first. To select a state, click the header column. To select
multiple rows, click the header column and use Ctrl+Click to add a row to the selection.
If the touch operation is to be enabled by a bit, you need to specify that bit and the bit
value that enables the touch operation.
If the touch operation is to be enabled by the current user level, you need to specify
the lowest user level that is required to enable the touch operation.
Select and set this feature in the Advanced page of the Bit Button dialog box.
Requiring the minimum hold The touch operation will not be activated until the button is pressed and held down for
time the specified Minimum Hold Time.
Select and set this feature in the Advanced page of the Bit Button dialog box.
Requiring the operator A confirmation dialog box displays when the button is activated to about to set a bit.
confirmation The button will proceed to set that bit if the operator selects “Yes” to confirm the
operation. The touch operation will be cancelled if the operator selects “No” to reject
the operation or the operator does not respond within the Maximum Waiting Time.
Select and set this feature in the Advanced page of the Bit Button dialog box.
Notifying a bit of the touch The notification is performed after the touch operation is done. You need to specify
operation the bit to be notified and the bit value to be used for the notification.
Select and set this feature in the Advanced page of the Bit Button dialog box.
Logging the touch operations The time and data when the touch operation occurs, the new value that is written to
the bit, and the predefined text can be recorded in the operation log with this feature.
Select and set this feature in the Advanced page of the Bit Button dialog box.
Showing and hiding an object The visibility of an object can be controlled either by a specified bit or by the current
user level, i.e. an object can be shown and hidden dynamically by any of those two
methods.
If the visibility is to be controlled by a bit, you need to specify that bit and the bit value
that shows the object.
If the visibility is to be controlled by the current user level, you need to specify the
lowest user level that is required to show the visibility.
For easy to read, we usually use “internal variable” instead of “internal bit variable” when
referring to a bit if there is no ambiguity.
Internal word variable An internal variable that refers to a word in the internal memory.
The variables can also be used to refer to a double-word, a block of bytes (byte array), a
block of words (word array), and a block of double-words (double-word array).
For easy to read, we usually use “internal variable” instead of “internal word variable”
when referring to a word or a block of memory space if there is no ambiguity,
External memory The memory spaces or the collections of addressable devices in the controllers that can
be accessed by the panel application through communication links.
External variable An address or a tag referring to an address of a space in the external memory.
External bit variable An external variable that refers to a bit in the external memory.
For easy to read, we usually use “external variable” instead of “external bit variable” when
referring to a bit if there is no ambiguity.
External word variable An external variable that refers to a word in the external memory.
The variables can also be used to refer to a double-word, a block of bytes (byte array), a
block of words (word array), and a block of double-words (double-word array) if the
access unit of the associated addresses is word. If the access unit is double-word, you
can only use the variable to refer to a double-word or a block of memory space with a
length of a multiple of 4 (bytes).
For easy to read, we usually use “external variable” instead of “external word variable”
when referring to a word or a block of memory space if there is no ambiguity,
Variable An internal variable or an external variable.
Bit variable An internal bit variable or an external bit variable.
Word variable An internal word variable or an external word variable.
Double-word variable An internal variable or an external variable that refers to a double-word.
Byte array variable An internal variable or an external variable that refers to a byte array.
Word array variable An internal variable or an external variable that refers to a word array.
Double-word array variable An internal variable or an external variable that refers to a double-word array.
Tag A name that stands for an address of the internal memory or the external memory. It also
specifies the data type and scan rate of the data in the memory location it refers to.
Propert Description
y
Link Click the down arrow and select a link from the drop down
list.
PLC Click the down arrow and select a value between 0 and 255
Address or an indirect address between [$I0] and [$I15] as the PLC
Address. If the indirect address is used, the plc address can
be dynamic changed.
Location Click the down arrow and select an item from the drop down
Type list as the location type.
Address Specify the address.
Input
keypad Buttons Description
Clears all the texts in the address field.
Tag group
Selected tag
Note: All the listed tags and tag groups are created in the Tags Editor. To create a tag, please see Section 2.3
Working with Tags.
Major
Marks ticks
You can use the Scale page in an object's property sheet to set up the scale of that object. The following is an
example of the Scale page of the bar Graph.
Top Bottom
Left Right
Inner Outer
Color The color of the scale. To specify the color, click the corresponding Color icon and select a
color from the Color palette.
Number of Major The number of major ticks. The minimum you can specify is two.
Ticks
Number of Sub The number of divisions between two adjacent major ticks. The minimum you can specify
Divisions is one.
Axis Check this item if you want the scale to have an axis.
Marks Marks Check this option if you want the scale to have marks.
Font The font of the marks.
Dynamic Check this option if you want the minimum and maximum of the marks to be controlled by
Range the dynamic range parameter block of the associated object at runtime.
Minimum The minimum of the marks. It is a 32-bit integer.
Maximum The maximum of the marks. It is a 32-bit integer.
Total Digits The total digits to be displayed for the marks.
Fractional The number of fractional digits for the marks. For example, when the Maximum is 5000,
Digits the Total Digits is 4, and the Fractional Digits is 2, the mark for the Maximum will be 50.00.
The following are examples of the Advanced page for different objects:
Property Description
Touch Enabled by Bit Check this option so the touch operation of the numeric entry will be enabled and
Operation disabled by the specified bit.
Control Control Bit Specifies the bit that enables and disables the touch operation.
Click to enter a bit address. Click to select a bit tag.
Enabling State Specifies the state (On or Off) that enables the touch operation.
Enabled by Check this item so the touch operation of the numeric entry will be enabled and
User Level disabled by the current user level.
Lowest Specifies the lowest user level that is required to enable the touch operation.
Enabling User
Level
Show Check this option so the touch operation disabled sign will be shown on the
Disabled Sign numeric entry when the touch operation is disabled.
Continued
Property Description
Invisible Check this option so the object will be invisible always.
Note: The touch operation is still enabled with this setting.
Controlled Controlled by Bit Check this option so the object will be shown and hidden by the specified bit.
by Bit Control Bit Specifies the bit that will show or hide the object.
Click to enter the bit address. Click to enter the bit tag.
Visible State Specifies the state (On or Off) that makes the object visible.
Controlled Controlled by Check this option so the object will be shown and hidden by the current user
by User User Level level.
Level Lowest Visible Specifies the lowest user level that is required to show the object.
User Level
Dimension Left Specifies the X coordinate of the object’s upper-left corner on the screen.
Top Specifies the Y coordinate of the object’s upper-left corner on the screen.
Width Specifies the width (in pixels) of the object.
Height Specifies the height (in pixels) of the object.
Click this button to redraw the object with the new settings.
You can touch a bit button to change the state of the specified bit.
Select these options in the General Page. Specify and edit the ON macro in the ON Macro
page. Specify and edit the OFF macro in the OFF Macro page.
Note: When an ON macro or OFF macro is specified, the associated bit setting operation is not
performed until the macro is completely executed. So it is important to keep ON and OFF
macros as short as possible in order not to delay the bit setting operation.
Touch The touch operation can be enabled or disabled either by a specified bit or by the current user
Operation level. Select and set this option in the Advanced page.
Control
Minimum Hold The touch operation of the button will not be activated until the button is pressed and held down
Time for the specified time period (Minimum Hold Time). Set this option in the Advanced page.
Operator This option is available for the following bit button operations:
Confirmation Set ON, Set OFF, Set ON Pulse, Set OFF Pulse, and Invert.
The Confirmation box will display when the button is touched. If the operator selects “Yes” in
the Confirmation box, the button will proceed to perform its operation. If the operator selects
“No” or the operator does not respond within the specified time period (Maximum Waiting
Time), the button will stop performing its operation.
Select and set this option in the Advanced page.
Notification The button can be configured to notify a bit of the completion of the bit setting operation when
the button is pressed. Select and set this option in the Advanced page.
Operation Each touch operation of the button can be recorded in the operation log. Select and set this
Logging option in the Advanced page.
Invisible The button can be invisible and still touch operable. Select this option in the Visibility page.
Visibility Control The button can be shown or hidden either by a specified bit or by the current user level. Select
and set this option in the Visibility page.
Write Specifies the bit variable to be operated when the Address Type is Bit.
Address Specifies the word variable that contains the bit to be operated when the Address Type is
Word.
Specifies the double-word variable that contains the bit to be operated when the Address
Type is Double-word.
Click this icon to bring up the Address Input Keypad and specify the desired address for the
Write Address field.
Click this icon to bring up the Select Tag dialog box and select the desired tag for the Write
Address field.
Bit Specifies which bit of the variable specified in Write Address field is to be operated.
Number
Minimum Pulse The minimum width of the pulse that the Momentary ON and Momentary OFF operations
Width must generate. There are six choices available: 0.05, 0.1, 0.2, 0.3, 0.4, and 0.5 second.
Pulse Width The width of the pulse generated by the Set ON Pulse and Set OFF Pulse operations.
There are six choices available: 0.05, 0.1, 0.2, 0.3, 0.4, and 0.5 second.
Monitor Check this option if you want the bit button to monitor a specified bit and display its state.
Monitor Address Specifies that the Monitor Address is identical to the Write Address. With this item checked,
identical to Write you don’t need to specify the Monitor Address again. This item is available when the option
Address Monitor is checked.
Monitor Monitor Specifies the bit variable to be monitored when the Address Type is Bit.
Address Address Specifies the word variable that contains the bit to be monitored when the Address Type is
Word.
Specifies the double-word variable that contains the bit to be monitored when the Address
Type is Double-word.
Click this icon to bring up the Address Input Keypad and specify the desired address for the
Monitor Address field.
Click this icon to bring up the Select Tag dialog box and select the desired tag for the
Monitor Address field.
ON Macro Check this option if you want the button to have an ON macro. Specify and edit the ON
macro in the ON Macro page. This option is available when the bit button operation is Set
ON, Set ON Pulse, Momentary ON, or Momentary OFF.
OFF Macro Check this option if you want the button to have an OFF macro. Specify and edit the OFF
macro in the OFF Macro page. This option is available when the bit button operation is Set
OFF, Set OFF Pulse, Momentary ON, or Momentary OFF.
Key The hard key that is used to operate the bit button. This item is available only when the
target panel has hard keys.
You can touch a toggle switch to toggle the state of the specified bit.
The difference between a toggle switch and a bit button performing Invert operation is described below:
1) A toggle switch performs the toggle operation by writing the inverse state of the monitored bit to the destination bit.
2) A bit button performs the Invert operation by inverting the destination bit directly regardless of the monitored bit.
5.2.1 Settings
You can complete all the settings of a toggle switch in the Toggle Switch property sheet. This sheet contains the
following seven pages. Some of the pages appear only when they are needed.
■ General
Described in Section 5.2.2.
■ Label
Described in Section 4.3.5.
■ Advanced
Described in Section 4.4.5.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
■ On Macro
Described in Section 14.2.6.
■ OFF Macro
Described in Section 14.2.6.
The above is an example of the General page of the Toggle Switch property sheet.
The following table describes each property in the General page.
Property Description
The object’s identifier. It is generated when the object is created. The identifier is unique within the
ID
screen where the object is on. The format of the ID’s for toggle switches is TSnnnn.
Note You can type a note for the object.
For details about the following properties, see Section 4.3.4 Setting up the Shape of an Object..
Shape settings
Picture Shape, , VFTA, , Border Color, Pattern, FG Color, BG Color
Check this option if you want the object to have an external label. Set up the external label in the
External Label
External Label page.
Continued
Options Description
Change User Level The button can be configured to change the current user level.
The button can be configured to acknowledge the associated alarm of the screen where it
Acknowledge Alarm is on. You can configure an alarm to display an (alarm) screen and the associated alarm
of a screen is the alarm that displays the screen.
Indicate Screen The button can be configured to indicate that the specified screen is opened. The
Already Opened indication is done by exchanging the button’s FG color with its text color.
You can specify a macro that will be run when the screen button is activated to perform its
operation. Select this option in the General page. Specify and edit the macro in the Macro
page.
Macro
Note: The screen switching operation will not be performed until the macro is completely
executed. So it is important to keep the macro as short as possible to not delay the
operation.
Touch Operation The touch operation can be enabled or disabled either by a specified bit or by the current
Control user level. Select and set this option in the Advanced page.
The touch operation of the button will not be activated until the button is pressed and held
Minimum Hold Time down for the specified time period (Minimum Hold Time). Select and set this option in the
Advanced page.
The screen button can be configured to notify a bit of the completion of the screen
Notification
switching operation. Select and set this option in the Advanced page.
Each touch operation of the button can be recorded in the operation log. Select and set
Operation Logging
this option in the Advanced page.
The button can be invisible and still touch operable. Select this option in the Visibility
Invisible
page.
The button can be shown or hidden either by a specified bit or by the current user level.
Visibility Control
Select and set this option in the Visibility page.
You can complete all the settings of a screen button in the Screen Button property sheet. This sheet contains the
following six pages. Some of the pages appear only when they are needed.
■ General
Described in Section 5.3.4.
■ Label
Described in Section 4.3.5.
■ Advanced
Described in Section 4.4.5.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
■ Macro
Described in Section 14.2.6.
The above is an example of the General page of the Screen Button dialog box.
You can touch a function button to perform the specified built-in function provided by the target panel.
The following operation options can be added to a function button to make it more informative, secure, and useful.
You need to select and set these options in the Function Button property sheet.
Options Description
Macro You can specify a macro that will be run when a file is successfully opened. Select this
option in the General page. Specify and edit the macro in the Macro page.
Touch Operation The touch operation can be enabled and disabled either by a specified bit or by the
Control current user level. Select and set this option in the Advanced page.
Minimum Hold Time The touch operation of the button will not be activated until the button is pressed and held
down for the specified time period (Minimum Hold Time). Set this option in the Advanced
page.
Operator Confirmation The Confirmation box will display when the button is touched. If the operator selects “Yes”
in the Confirmation box, the button will proceed to perform its operation. If the operator
selects “No” or the operator does not respond within the specified time period (Maximum
Waiting Time), the button will stop performing its operation.
Select and set this option in the Advanced page.
Notification The button can be configured to notify a bit when the specified operation is performed
successfully. Select and set this option in the Advanced page.
Operation Logging Each touch operation of the button can be recorded in the operation log. Select and set
this option in the Advanced page.
Invisible The button can be invisible and still touch operable. Select this option in the Visibility
page.
Visibility Control The button can be shown or hidden either by a specified bit or by the current user level.
Select and set this option in the Visibility page.
You can complete all the settings of a function button in the Function Button property sheet. This sheet contains the
following five pages. Some of the pages appear only when they are needed.
■ General
Described in Section 5.4.4.
■ Label
Described in Section 4.3.5.
■ Advanced
Described in Section 4.4.5.
■ Visibility
Described in Section 4.4.6.
■ Macro
Described in Section 14.2.6.
The above are an example of the General page of the Function Button dialog box.
You can touch the knob of a slide switch and move the knob to select a desired value. The selected value is written to
the specified variable when you release the knob.
Selected Value
Knob
Scale
The above are two examples of slide switches. The right one shows a slide switch whose knob is being touched.
You specify the variable to be controlled, the minimum of the variable, and the maximum of the variable for a slide
switch. The variable is monitored and its value combined with the specified minimum and maximum determines the
knob position of the slide switch. You can touch and move the knob to select a desired value. The selected value is
shown when the knob is being held. When you release the knob, the selected value is written to the specified variable.
You can choose one of the following four directions for a slide switch:
Direction Description
Upward The knob can move vertically. The knob is at the top end when the variable value is equal to or greater
than the specified maximum. The knob is at the bottom end when the variable value is equal to or less
than the specified minimum. When the variable value is between the maximum and minimum, the knob
is at a proportional position between the top end and the bottom end.
Downward The knob can move vertically. The knob is at the bottom end when the variable value is equal to or
greater than the specified maximum. The knob is at the top end when the variable value is equal to or
less than the specified minimum. When the variable value is between the maximum and minimum, the
knob is at a proportional position between the bottom end and the top end.
Leftward The knob can move horizontally. The knob is at the left end when the variable value is equal to or
greater than the specified maximum. The knob is at the right end when the variable value is equal to or
less than the specified minimum. When the variable value is between the maximum and minimum, the
knob is at a proportional position between the left end and the right end.
Rightward The knob can move horizontally. The knob is at the right end when the variable value is equal to or
greater than the specified maximum. The knob is at the left end when the variable value is equal to or
less than the specified minimum. When the variable value is between the maximum and minimum, the
knob is at a proportional position between the right end and the left end.
5.5.3 Settings
You can complete all the settings of a slide switch in the Slide Switch dialog box. This dialog box contains the
following five pages. Some of the pages appear only when they are needed.
■ General
Described in Section 5.5.4.
■ Scale
Described in Section 4.4.4.
■ Advanced
Described in Section 4.4.5.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
The above is an example of the General page of the Slide Switch dialog box.
Continued
The following table shows the data arrangement of the parameter block when the
data type is 16-bit and the scale of the slide switch is dynamic.
Word Parameter
0 The minimum of the variable
1 The maximum of the variable
2, 3 The minimum of the mark for the scale; 32-bit integer number
4, 5 The maximum of the mark for the scale; 32-bit integer number
The following table shows the data arrangement of the parameter block when the
data type is 32-bit and the scale of the slide switch is not dynamic.
Word Parameter
0, 1 The minimum of the variable
2, 3 The maximum of the variable
The following table shows the data arrangement of the parameter block when the
data type is 32-bit and the scale of the slide switch is dynamic.
Word Parameter
0, 1 The minimum of the variable
2, 3 The maximum of the variable
4, 5 The minimum of the mark for the scale; 32-bit integer number
6, 7 The maximum of the mark for the scale; 32-bit integer number
You can touch a word button to set a value to the specified variable.
The following operation options can be added to a word button to make it more informative, secure, and useful. You
need to select and set these options in the Word Button dialog box.
Options Description
Touch Operation The touch operation can be enabled or disabled either by a specified bit or by the current
Control user level. Select and set this option in the Advanced page.
Minimum Hold Time The touch operation of the button will not be activated until the button is pressed and held
down for the specified time period (Minimum Hold Time). Set this option in the Advanced
page.
Operator The Confirmation box will display when the button is touched. If the operator selects “Yes”
Confirmation in the Confirmation box, the button will proceed to perform its operation. If the operator
selects “No” or the operator does not respond within the specified time period (Maximum
Waiting Time), the button will stop performing its operation.
Select and set this option in the Advanced page.
Note that this option is not available for the Enter Password operation.
Notification The button can be configured to notify a bit of the completion of the specified operation.
Select and set this option in the Advanced page.
Operation Logging Each touch operation of the button can be recorded in the operation log. Select and set
this option in the Advanced page.
Invisible The button can be invisible and still touch operable. Select this option in the Visibility
page.
Visibility Control The button can be shown or hidden either by a specified bit or by the current user level.
Select and set this option in the Visibility page.
5.6.3 Settings
You can complete all the settings of a word button in the Word Button property sheet. This sheet contains the
following five pages. Some of the pages appear only when they are needed.
■ General
Described in Section 5.6.4.
■ Label
Described in Section 4.3.5.
■ Advanced
Described in Section 4.4.5.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
The above is an example of the General page of the Word Button property sheet.
Activation Button Down Select this item so the touch operation will be activated when the button is touched.
Button Up Select this item so the touch operation will be activated when the button is released.
Key The hard key that is used to operate the word button. This item is available when the
target panel has hard keys.
You can use a multi-state switch to change the state of the specified variable.
Drop-down The multi-state switch is a drop-down list. It displays the text of the current state and a button with
List the down arrow symbol as shown in the following example.
When the button is touched, the switch list displays a list box beneath itself as shown in the
following example.
The list box lists the text of all states of the switch one state per line starting from state 0. The text
of the current state is highlighted. If the desired state is not in the view, you can use the scroll bar
attached to the right side of the list to scroll the text. When you select a desired state by touching
its text, the switch writes the value of the selected state to the specified variable and closes the list
box.
If you want to cancel the operation when the list box is showing, touch anywhere other than the
text in the list box.
Continued
When the button is touched, the switch list displays a list box above itself as shown in the following
example.
The list box lists the text of all states of the switch one state per line starting from state 0. The text of
the current state is highlighted. If the desired state is not in the view, you can use the scroll bar
attached to the right side of the list to scroll the text. When you select a desired state by touching its
text, the switch writes the value of the selected state to the specified variable and closes the list box.
If you want to cancel the operation when the list box is showing, touch anywhere other than the text
in the list box.
Options Description
Touch Operation The touch operation can be enabled and disabled either by a specified bit or by the
Control current user level. Select and set this option in the Advanced page.
Minimum Hold Time The touch operation of the switch will not be activated until the switch is pressed and held
down for the specified time period (Minimum Hold Time). Set this option in the Advanced
page.
Notification The switch can be configured to notify a bit of the completion of the specified operation.
Select and set this option in the Advanced page.
Operation Logging Each data change performed by the switch can be recorded in the operation log. Select
and set this option in the Advanced page.
Invisible The switch can be invisible and still touch operable. Select this option in the Visibility
page.
Visibility Control The switch can be shown or hidden either by a specified bit or by the current user level.
Select and set this option in the Visibility page.
You can press a button of a radio button group to change the state of the controlled variable.
Options Description
Touch Operation The touch operation of the radio button group can be enabled and disabled either by a
Control specified bit or by the current user level. Select and set this option in the Advanced page.
Minimum Hold Time The touch operation will not be activated until a button of the radio button group is pressed
and held down for the specified time period (Minimum Hold Time). Set this option in the
Advanced page.
Operation Logging Each data change performed by the radio button group can be recorded in the operation
log. Select and set this option in the Advanced page.
Visibility Control The radio button group can be shown or hidden either by a specified bit or by the current
user level. Select and set this option in the Visibility page.
Data Type The data type of the variables specified in this page.
Write Write Specifies the variable to be controlled.
Address Address
Click this icon to bring up the Address Input Keypad and specify an address for this property.
Click this icon to bring up the Select Tag dialog box and select a tag for this property.
Total States Specifies the number of valid states that the controlled variable has.
Current The settings to highlight the button of the current state.
State BG The color to replace the shape’s BG color for highlighting.
Color
Text The color to replace the text color for highlighting.
Color
Button Spacing The distance in pixels between two adjacent radio buttons.
Custom State Value Click this button to define the state value for each state when the State Type is Custom. For
details, see Section 4.4.1.2 Setting the Custom States of an Object.
A keypad button inputs a character to the keypad buffer or issues a command to the keypad buffer when it is pressed.
You can use keypad buttons to create your own keypads.
5.9.2 Settings
You can complete all the settings of a keypad button in the Keypad Button dialog box. This dialog box contains the
following four pages. Some of the pages appear only when they are needed.
■ General
Described in Section 5.9.4.
■ Label
Described in Section 4.3.5.
■ Visibility
Described in Section 4.4.6.
■ Macro
Described in Section 14.2.6.
Key The hard key that is used to operate the keypad button. This item is available only when the target
panel has hard keys.
Macro Check this option if you want the button to have a macro. Specify and edit the macro in the Macro
Keypad Display
Allowable input range display
Keypad Buttons
Note:
Monitor Address: $S230
Total Characters: 24 (or less)
Font: Any font
Alignment: Any (Center recommended)
Character Set: ASCII code (7 bits)
Code Size: Byte
Scroll Page Right Scrolls the content displayed by the associated object to the right by one page.
Scroll Right Scrolls the content displayed by the associated object to the right.
Scroll Left Scrolls the content displayed by the associated object to the left.
Scroll Page Left Scrolls the content displayed by the associated object to the left by one page.
Scroll To Left End Scrolls the content displayed by the associated object to the left end.
Pause This is a toggle switch. It stops the auto-scrolling of the content displayed by the
associated object when it is touched. When you touch it again, it resumes the
auto-scrolling operation.
A scroll button group with the vertical button alignment can have the following buttons:
Button Example Description
Scroll To Top End Scrolls the content displayed by the associated object to the top end.
Scroll Page Up Scrolls the content displayed by the associated object to the top by one page.
Scroll Up Scrolls the content displayed by the associated object to the top.
Scroll Down Scrolls the content displayed by the associated object to the bottom.
Scroll Page Down Scrolls the content displayed by the associated object to the bottom by one
page.
Scroll To Bottom Scrolls the content displayed by the associated object to the bottom end.
End
Pause This is a toggle switch. It stops the auto-scrolling of the content displayed by the
associated object when it is touched. When you touch it again, it resumes the
auto-scrolling operation.
5.9.7 Settings
You can complete all the settings of a scroll button group in the Scroll Button Group dialog box. This dialog box
contains the following two pages.
■ General
Described in Section 5.10.4.
■ Visibility
Described in Section 4.4.6.
You can use a scroll bar to scroll the content displayed by the associated object. The associated objects include
Historic Data Display, Historic Message Display, Historic Trend Display, Operation Log Display, Alarm Display, Recipe
Table, and Sub-link Table.
The following operation option can be added to a scroll bar. You need to select and set this option in the Scroll Bar
property sheet.
Options Description
Visibility Control The scroll bar can be shown or hidden either by a specified bit or by the current user
level. Select and set this option in the Visibility page.
5.10.3 Settings
You can complete all the settings of a scroll bar in the Scroll Bar property sheet. This sheet contains the following two
pages.
■ General
Described in Section 5.11.4.
■ Visibility
Described in Section 4.4.6.
Property Description
ID The object’s identifier. It is generated when the object is created. The identifier is
unique within the screen where the object is on. The format of the ID’s for the scroll
bars is SBRnnnn.
Note You can type a note for the scroll button group.
Type The type of the scroll bar. There are two types; horizontal and vertical.
Associated Object ID The ID of the object that you will use the scroll bar to scroll its content. You can
select the associated object from this drop-down list which shows the ID’s of the
objects on the same screen that support the scroll operation.
Bar Color The color of the scroll bar.
Legend Color The color of the legend for the buttons of the scroll bar.
You can press a step button to writes the value of the button’s next state to the specified variable.
Unlike most kinds of objects, a step button displays all the states at once with the current state highlighted instead of
displaying just the current state. A step button can let the operators know all the available states and what the next
state will be when they touch it.
The state of a step button is determined by the value of the specified variable and the specified state type. When a
step button is pressed, it calculates the value of the next state and writes that value to the specified variable. The next
state is the current state plus one when the current state is not the last state. When the current state is the last state,
the next state is state 0.
The following operation options can be added to a step button to make it more informative, secure, and useful. You
need to select and set these options in the Step Button property sheet.
Options Description
Touch Operation The touch operation of the step button can be enabled and disabled either by a specified
Control bit or by the current user level. Select and set this option in the Advanced page.
Minimum Hold Time The touch operation will not be activated until the step button is pressed and held down for
the specified time period (Minimum Hold Time). Set this option in the Advanced page.
Operation Logging Each data change performed by the step button can be recorded in the operation log.
Select and set this option in the Advanced page.
Visibility Control The step button can be shown or hidden either by a specified bit or by the current user
level. Select and set this option in the Visibility page.
You can complete all the settings of a step button in the Step Button property sheet. This sheet contains the following
six pages. Some of the pages appear only when they are needed.
■ General
Described in Section 5.12.4.
■ Text
Described in Section 4.3.6.
■ Picture
Described in Section 4.3.7.
■ Advanced
Described in Section 4.4.5.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
Right To Left
Top To Bottom
Bottom To Top
Data Type The data type for the variable in the Write Address field. The supported types are: 16-bit
Unsigned Integer, 16-bit BCD, 32-bit Unsigned Integer, and 32-bit BCD.
Continued
Total States Specifies the number of states that the step button can display and process.
Separator Color The color of the lines that are drawn between two states.
Highlight The settings to highlight the text of the current state.
Current
State BG The color to replace the BG color of the current state.
Color
Text The color to replace the text color of the current state.
Color
Custom State Click this button to define the state value for each state of the step button when the State
Value… Type is Custom. For details, see Section 4.4.1.2 Setting the Custom States of an Object.
In a page selector, you can press a tab to view the associated page (window screen).
You can configure a page selector to contain up to 8 window screens. Each of the specified window screens is a page
and each page has an associated tab. You can specify the text and picture for each tab. At runtime, a page selector
shows one of the specified pages in its viewing area. You can select a desired page to view by pressing the
associated tab.
5.11.6 Settings
You can complete all the settings of a page selector in the Page Selector property sheet. This sheet contains the
following three pages.
■ General
Described in Section 5.13.3.
■ Text
Described in Section 4.3.6.
■ Picture
Described in Section 4.3.7.
6 Lamps
A bit lamp has two states, i.e. state 0 (Off) and state 1 (On). You can set the appearance of a bit lamp for each of the
two states. At runtime, a bit lamp displays with the appearance settings corresponding to the state of the monitored
bit.
The following operation option can be added to a bit lamp. You need to select and set this option in the Bit Lamp
property sheet.
Options Description
Visibility Control The object can be shown or hidden either by a specified bit or by the current user level.
Select and set this option in the Visibility page.
3.1.3. Settings
You can complete all the settings of a bit lamp in the Bit Lamp property sheet. This sheet contains the following four
pages. Some of the pages appear only when they are needed.
■ General
Described in Section 6.1.4.
■ Label
Described in Section 4.3.5.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
The above is an example of the General page of the Bit Lamp dialog box.
Monitor Specifies the bit variable to be monitored when the Address Type is Bit.
Address Specifies the word variable that contains the bit to be monitored when the Address
Type is Word.
Specifies the double-word variable that contains the bit to be monitored when the
Address Type is Double-word.
Click this icon to bring up the Address Input Keypad and specify the desired address
for the Monitor Address field.
Click this icon to bring up the Select Tag dialog box and select the desired tag for the
Monitor Address field.
Bit Number Specifies which bit of the variable specified in the Monitor Address field is to be
monitored.
A multi-state lamp can have up to 256 states. The maximum number of states that a multi-state lamp can have is
determined by the state type and the data type of the monitored variable. The following table shows the maximum in
each case.
16-bit Variable 32-bit variable
State Bit 2 2
Type Value 256 256
LSB 16 33
You need to specify the number of states for a multi-state lamp and the number must not exceed the allowed
maximum. You can set the appearance of a multi-state lamp for each of its states. At runtime, a multi-state lamp
displays with the appearance settings corresponding to the state of the monitored variable. The state of the monitored
variable is determined by the state type and value of the variable.
The following operation option can be added to a multi-state lamp. You need to select and set this option in the Multi-
state Lamp property sheet.
Options Description
Visibility Control The object can be shown or hidden either by a specified bit or by the current user level.
Select and set this option in the Visibility page.
You can complete all the settings of a multi-state lamp in the Multi-state Lamp property sheet. This dialog box contains
the following five pages. Some of the pages appear only when they are needed.
■ General
Described in Section 6.2.4.
■ Text
Described in Section 4.3.6.
■ Picture
Described in Section 4.3.7.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
You need to specify the number of states for a message display and the number must not exceed the allowed
maximum. You can set the text (message) for each state. At runtime, a message display shows the message
corresponding to the state of the monitored variable. The state of the monitored variable is determined by the state
type and value of the variable.
Note: The differences between Message Display and Lamps are:
The lamps can display either text or picture or both of them, but message display can only display text. Both of the
message display and lamps can display predefined text by changing the value of the monitored variable. But only the
message display can perform as a marquee controlled by the value of the monitored variable and the specified
running speed.
Visibility Control The object can be shown or hidden either by a specified bit or by the current user level. Select
and set this option in the Visibility page.
3.3.3. Settings
You can complete all the settings of a message display in the Message Display dialog box. This dialog box contains
the following four pages. Some of the pages appear only when they are needed.
■ General
Described in Section 7.9.4.
■ Text
Described in Section 4.3.6.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
You can enter a value and change the specified variable using a numeric entry.
Options Description
Scaling The value of the monitored variable will be displayed in a scaled manner. The following is
the scaling formula.
DisplayedValue = MonitoredValue * Gain + Offset
If the option is selected, the entered value will be scaled by the following formula with the
same coefficients (Gain and Offset) before it is output.
OutputValue = (EnteredValue – Offset) / Gain
Select and set this option in the Advanced page.
Note: The Gain and Offset are 32-bit floating point numbers. They have at most 6
significant digits. The rounding and truncation errors may happen.
Range Check The numeric entry will verify the entered value according to the specified maximum and
minimum. If the entered value is not within the allowable range, the value will not be
output. Select and set this option in the Advanced page.
Note 1: When the scaling option is selected, the output value instead of the entered value
is verified.
OutputValue = (EnteredValue – Offset) / Gain
Note 2: When the scaling option is selected, the allowable maximum and minimum shown
on the numeric keypad are the scaled version of the specified maximum and minimum.
ScaledMaximum = Maximum * Gain + Offset
ScaledMinimum = Minimum * Gain + Offset
Touch Operation You can enable or disable the touch operation of the object by the specified bit or by the
Control current user level. Select and set up this option in the Advanced page.
Timeout If the keypad for the data entry receives no input for the specified time period, the data
entry operation will be cancelled.
Notification The Object will notify the specified bit of a successful data entry operation. Select and set
up this option in the Advanced page.
Operator Confirmation When a value is entered by the operator, the Confirmation box will display for the operator
confirmation. If the operator selects “Yes”, the object will write the entered data to the
specified variable. If the operator selects “No” or the operator does not respond within the
specified time period (Maximum Waiting Time), the data entry operation will be cancelled.
Select and set up this option in the Advanced page.
Operation Logging The entered value and the time of the data entry will be recorded. Select and set up this
option in the Advanced page.
Visibility Control You can show or hide the object by the specified bit or by the current user level. Select
and set up this option in the Visibility page.
Write Address Specifies the destination variable where the entered value will be written to.
Click to enter an address for this field. Click to select a tag for this field.
Monitor Specifies that the monitored variable is the same as the destination variable. With this item checked,
Address you don’t need to specify the monitored variable in the Monitor Address field.
identical to
Write Address
Monitor Specifies the monitored variable.
Address
Click to enter an address for this field. Click to select a tag for this field.
Font The font of the displayed value.
Text Color The color of the displayed value.
Total Digits The number of digits to be displayed.
Note: This property applies to the display of the initial value, the allowable minimum, and the
allowable maximum on the numeric keypad.
Continued
Example 2:
Total Fractional Entered Output
Display Type
Digits Digits Value Value
32-bit Floating Point 4 2 12.34 12.34
32-bit Floating Point 4 2 123.4 Error!
16-bit Signed Decimal 5 2 123.45 12345
16-bit Signed Decimal 5 2 -0.05 -5
16-bit Signed Decimal 5 2 3 300
Note: This property applies to the display of the initial value, the allowable minimum, and the
allowable maximum on the numeric keypad.
Alignment The alignment of the displayed value. There are three types of alignment: Left, Center, and Right.
Justification The justification of the displayed value. There are three types of justification:
Option Description
Zero Suppress The leading digits will not display when they are 0.
Leading Zeros All digits will display.
Leading Spaces The leading digits will display as blank character when they are 0.
Data Entry Specifies how to enter a value for the numeric entry at runtime. There are two options:
Option Description
Pop-up Keypad You can bring up the keypad by pressing the numeric entry and
enter a value with the keypad.
On-screen Keypad You can move the cursor by using the function buttons with the
and/or Function operation of Select Next Data Entry Object or Select Previous Data
Keys Entry Object to select the numeric entry. If there is an on-screen
keypad you can enter a value for the numeric entry right away. You
can also use the function buttons with the operation of Increase
Value By One or Decrease Value By One to change the value of the
destination variable.
Note: When On-screen Keypad and/or Function Keys option is selected, you can only enter a value
for the numeric entry with the input focus. To set the input focus on the corresponding object, you
need to click the object first.
You can use a numeric display to show the value of the specified variable.
Options Description
Scaling The value of the monitored variable will be scaled by the following formula before it is
displayed.
DisplayedValue = MonitoredValue * Gain + Offset
Select and set this option in the Advanced page.
Note: The Gain and Offset are 32-bit floating point numbers. They have at most 6
significant digits. The rounding and truncation errors may happen.
Range Display You can specify a low limit and a high limit for the numeric display. The limits can be
constants or variables. At runtime, when the value of the monitored variable is below the
low limit, the numeric display shows the value with the text color and the BG color set for
the low limit. When the value of the monitored variable is over the high limit, the numeric
display shows the value with the text color and the BG color set for the high limit.
Visibility Control You can show and hide the numeric display by the specified bit or the current user level.
Select and set this option in the Visibility page.
7.2.2 Settings
You can complete all the settings of a numeric display in the Numeric Display property sheet. This sheet contains the
following four pages. Some of the pages appear only when they are needed.
■ General
Described in Section 7.2.3.
■ Advanced
Described in Section 7.2.4.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
Alignment The alignment of the displayed value. There are three types of alignment: Left, Center, and
Right.
Justification The justification of the displayed value. There are three types of justification:
Option Description
Zero Suppress The leading digits will not display when they are 0.
Leading Zeros All digits will display.
Leading Spaces The leading digits will display as blank character when they are 0.
Options Description
Range Display The advanced numeric display can support up to 10 fixed ranges or 3 variable ranges.
You can define the text color, the BG color, and the lower bound for each range. At
runtime, the advanced numeric display uses the color settings for the range to which the
value belongs to display the value.
Range Check The advanced numeric display will verify the entered value according to the specified
maximum and minimum. If the entered value is not within the allowable range, the value
will not be output. Select and set this option in the Range page.
Note: If the output expression or the output macro is defined, the converted value stored
in the variable $W instead of the entered value is verified.
Touch Operation You can enable and disable the touch operation of the advanced numeric display by the
Control specified bit or the current user level. Select and set this option in the Advanced page.
Timeout The keypad displayed for the advanced numeric display will be closed and the data entry
operation will be cancelled after the keypad receives no input for the specified time period.
Notification The advanced numeric display will notify the specified bit when it finishes outputting the
entered value. Select and set this option in the Advanced page.
Operator Confirmation The Confirmation box will be displayed when a value is entered for the advanced numeric
display. If the operator selects “Yes” in the Confirmation box, the advanced numeric
display will write the entered value to the specified variable. If the operator selects “No” or
the operator does not respond within the specified time period (Maximum Waiting Time),
the advanced numeric display will cancel the data entry operation.
Select and set this option in the Advanced page.
Operation Logging The time, the entered value, and the predefined operation message will be recorded when
the advanced numeric display outputs the entered value. Select and set this option in the
Advanced page.
Visibility Control You can show and hide the advanced numeric display by the specified bit or the current
user level. Select and set this option in the Visibility page.
Example 2:
Total Fractional Entered Output
Display Type
Digits Digits Value Value
32-bit Floating Point 4 2 12.34 12.34
32-bit Floating Point 4 2 123.4 Error!
16-bit Signed Decimal 5 2 123.45 12345
16-bit Signed Decimal 5 2 -0.05 -5
16-bit Signed Decimal 5 2 3 300
Note: This property applies to the display of the initial value, the allowable minimum, and the
allowable maximum on the numeric keypad.
eV Manual V1.2a - 17.03.2010
278
Manual
Property Description
Alignment The alignment of the displayed value. There are three types of alignment: Left, Center, and
Right.
Justification The justification of the displayed value. There are three types of justification:
Option Description
Zero Suppress The leading digits will not display when they are 0.
Leading Zeros All digits will display.
Leading Spaces The leading digits will display as blank character when they are 0.
You can enter a string for a variable using a character entry. If the target panel is a PC, you can also use this object to
enter a Unicode string.
Option Description
Touch Operation You can enable or disable the touch operation of the object by the specified bit or by the
Control current user level. Select and set up this option in the Advanced page.
Timeout If the keypad for the data entry receives no input for the specified time period, the data
entry operation will be cancelled.
Notification The Object will notify the specified bit of a successful data entry operation. Select and set
up this option in the Advanced page.
Operator Confirmation When a character string is entered by the operator, the Confirmation box will display for
the operator confirmation. If the operator selects “Yes”, the object will write the entered
data to the specified variable. If the operator selects “No” or the operator does not
respond within the specified time period (Maximum Waiting Time), the data entry
operation will be cancelled.
Select and set up this option in the Advanced page.
Operation Logging The entered character string and the time of the data entry will be recorded. Select and
set up this option in the Advanced page.
Visibility Control You can show or hide the object by the specified bit or by the current user level. Select
and set up this option in the Visibility page.
7.4.2 Settings
You can complete all the settings of a character entry in the Character Entry property sheet. This sheet contains the
following four pages. Some of the pages appear only when they are needed.
■ General
Described in Section 7.4.3.
■ Advanced
Described in Section 7.4.4.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
You can use a character display to display the string stored in a variable. This object can display Unicode string if the
target panel is a PC.
Note: The difference between a character display and a text object is:
A character display is used to either display text, to request text, or to do both. The text of the Character display is not
allowed to be set at design time but can easily be done at run time. You can specify the text by changing its defined
variable.
A text object can be used to create a label at design time which is a short text that accompanies other control to
indicate what it is used for. It can not be changed at run time.
7.5.2 Settings
You can complete all the settings of a character display in the Character Display property sheet. This sheet contains
the following three pages. Some of the pages appear only when they are needed.
■ General
Described in Section 7.5.3.
■ Visibility
Described in Section 4.4.6.
■ External Label
Described in Section 4.3.8.
7.6.1 Settings
You can complete all the settings of a time display in the Time Display property sheet. The following is an example of
the sheet.
7.7.1 Settings
You can complete all the settings of a date display in the Date Display property sheet. The following is an example of
the sheet.
7.8.1 Settings
You can complete all the settings of a day-of-week display in the Day-of-week Display property sheet. This sheet
contains the following two pages.
■ General
Described in Section 7.8.2.
■ Text
Described in Section 4.3.6.
Note: When using the Text page to specify the text for each day, note that state 0 corresponds to Sunday, state 1
corresponds to Monday, and so on.
Property Description
ID The object’s identifier. It is generated
when the object is created. The identifier
is unique within the screen where the
object is on. The format of the ID’s for the
day-of-week displays is DWnnnn.
Note You can type a note for the object.
Shape For details about the following properties,
settings see Section 4.3.4 Setting up the Shape
of an Object. , Border Color,
Pattern, FG Color, BG Color
Day Select a day from 0 to 6 so you can view
and set the Pattern, FG Color, and BG
Color for that day. Day 0 corresponds to
Sunday; day 1 corresponds to Monday,
and so on.
Bipolar Bar
( Monitored Value = 60
Middle Point = 50 )
A bar graph can also have scale, forward markers, backward markers and percentage display.
Major Ticks Sub Divisions
Forward Markers
Monitored Value
Monitored Value = 60
The color of a mark:
LT Color = Light Red
EQ Color = Yellow
GT Color = Light Green
Mark’s Value
Select and set Forward Marker option in the F. Marker page.
Select and set Backward Marker option in the B. Marker page.
Range You can specify a low limit and a high limit for a bar graph. The limits can be constants or variables. At
Display runtime, when the monitored value is equal to or below the low limit, the bar graph shows the bar with
the FG color and the BG color set for the low limit. When the monitored value is equal to or over the
high limit, the bar graph shows the bar with the FG color and the BG color set for the high limit.
Low Limit = 20
High Limit = 80
Low BG Color = Light Blue
High BG Color = Light red
Monitored Value
Select and set this option in the Advanced page.
Continued
8.1.3 Settings
You can complete all the settings of a bar graph in the Bar Graph property sheet. This sheet contains the following
four pages.
■ General
Described in Section 8.1.4.
■ Scale
Described in Section 4.3.2.
■ F. Marker
Described in Section 8.1.5.
■ B. Marker
Described in Section 8.1.5.
■ Advanced
Described in Section 8.1.6.
■ Visibility
Described in Section 4.3.4.
The above is an example of the General page of the Bar Graph dialog box.
Property Description
Monitor Specifies the variable to be monitored.
Address
Click to enter an address for this field. Click to select a tag for this field.
Dynamic Check this option so the minimum and the maximum of the monitored variable will be specified at
Range runtime. When this option is selected, the minimum and maximum of the marks for the scale of the
bar graph can be specified at runtime too. The data that specifies the above two ranges should be
set and arranged correctly in a memory block called the dynamic range parameter block. You need
to specify the dynamic range parameter block for the bar graph in the Dynamic Range Parameter
Block field.
Dynamic Specifies the variable that stores the dynamic range parameter block for the bar graph when the
Range
Dynamic Range is selected. Click to enter an address for this field. Click to select a tag for
Parameter
this field.
Block
The following table shows the data arrangement of the parameter block when the data type is 16-
bit and the scale of the bar graph is not dynamic.
Word Parameter
0 The minimum of the monitored variable
1 The maximum of the monitored variable
The following table shows the data arrangement of the parameter block when the data type is 16-
bit and the scale of the bar graph is dynamic.
Word Parameter
0 The minimum of the monitored variable
1 The maximum of the monitored variable
2, 3 The minimum of the mark for the scale; 32-bit integer number
4, 5 The maximum of the mark for the scale; 32-bit integer number
The following table shows the data arrangement of the parameter block when the data type is 32-
bit and the scale of the bar graph is not dynamic.
Word Parameter
0, 1 The minimum of the monitored variable
2, 3 The maximum of the monitored variable
The following table shows the data arrangement of the parameter block when the data type is 32-
bit and the scale of the bar graph is dynamic.
Word Parameter
0, 1 The minimum of the monitored variable
2, 3 The maximum of the monitored variable
4, 5 The minimum of the mark for the scale; 32-bit integer number
6, 7 The maximum of the mark for the scale; 32-bit integer number
Min. Specifies the minimum of the monitored variable when the Dynamic Range is not selected.
Max. Specifies the maximum of the monitored variable when the Dynamic Range is not selected.
Bipolar Bar Check this option so the bar graph will display the difference between the monitored value and the
value specified in the Middle Point field.
Middle Point Specifies the reference value/point for the bipolar bar.
Pie Pattern Select a pattern for the bar graph. The pattern will be used to fill the bar. When the pattern is filled
in the bar, the black part of the pattern is painted with the color specified in the Bar FG Color field
and the white part of the pattern is painted with the color specified in the Bar BG Color field.
Pie FG Select a color for painting the black part of the specified pattern.
The following table describes each property in the Forward Marker page and the Backward Marker page.
Property Description
Number of Marks Specifies the maximum number of marks this marker can support.
Location Select Up or Down for the location of the marker when the bar direction is Leftward or
Rightward. Select Left or Right for the location of the marker when the bar direction is Upward
or Downward.
Forward/Backward Specifies the variable that stores the marker control block.
Marker Control
Block Click to enter an address for this field. Click to select a tag for this field.
The following table shows the data arrangement of the marker control block when the data type
is 16-bit.
Word Description
0 Specifies the actual number of marks that the marker will display.
1 The value of mark 1.
2 The value of mark 2
… …
12 The value of mark 12
The following table shows the data arrangement of the marker control block when the data type
is 32-bit.
Word Description
0,1 Specifies the actual number of marks that the marker will display.
2,3 The value of mark 1.
4,5 The value of mark 2
eV Manual V1.2a - 17.03.2010
296
Manual
… …
24,25 The value of mark 12
Note: The data format of the mark values should be the same as that of the monitored variable.
Property Description
Mark Style
No. 1 ~ Specifies the mark style. There are four mark styles:
No. 12 Border Color The border color of the mark.
LT Color The fill color of the mark when the monitored value is less than the mark’s value.
EQ Color The fill color of the mark when the monitored value is equal to the mark’s value.
GT Color The fill color of the mark when the monitored value is greater than the mark’s value.
If the bipolar bar is used, the percentage formula when Value > Middle Point is:
Percentage = (Value – Middle Point) / (Max. - Middle Point) * 100%
the percentage formula when Value < Middle Point is:
Percentage = -(Middle Point - Value) / (Middle Point - Min.) * 100%
The Value is the current value of the monitored variable. The Max. and Min.
defines the value range of the monitored variable and are defined in the General
page of the property sheet.
Text Color Select a color for the percentage display.
Font Select a fixed size font for the percentage display.
8.2 Meters
Span and 270° & 45° 270° & 315° 270° & 225° 270° & 135°
Origin
Example
Span and 180° & 90° 180° & 0° 180° & 270° 180° & 180°
Origin
Example
Span and 90° & 90° 90° & 0° 90° & 270° 90° & 180°
Origin
Span and 90° & 45° 90° & 315° 90° & 225° 90° & 135°
Origin
Example
Options Description
Range Display
The meter can display the low range mark and the high range mark along its swing path.. The
limits for range marks can be specified at runtime by the designated variables. Select and set
this option in the Range page.
Scale
The meter can have a scale. Select and set this option in the Scale page.
Visibility Control The meter can be shown or hidden either by a specified bit or by the current user level. Select
and set this option in the Visibility page.
The above is an example of the General page of the Meter property sheet.
eV Manual V1.2a - 17.03.2010
300
Manual
The following table describes each property in the General page.
Property Description
ID The object’s identifier. It is generated when the object is created. The identifier is unique
within the screen where the object is on. The format of the ID’s for the meters is Mnnnn.
Note You can type a note for the object.
Picture Picture Check this option if you want to use a picture for the meter’s shape. You can use a picture
Shape Shape to customize your own meter. For example:
+ =
Note: If the Picture Shape is checked, Shape…,Border Color and BG Color field are not
available to be used.
<Drop-down The name of the picture. You can use the drop-down list to select a picture from the picture
List> database.
Click this icon to select a picture file. After the selection, the picture of the selected file is
imported and saved in the picture database.
Click this icon to bring up the Select/Import from Library dialog box. Select a picture from a
picture library file. After the selection, the selected picture is imported and saved in the
picture database.
Graphical shape For details about the following properties, Section 4.3.1.4 Setting up the Shape of an
settings
Object. , Border Color, BG Color
Swing Specifies the types of swing. For details, see Section 8.2.1 Basic Operation.
The swing styles on the left are more
spacing saving because their needle can
be located outside the shape by changing
the position of Center X or Center Y.
Direction Specifies the direction that the needle moves. Now only the Clockwise is available.
Data Type The data type of the monitored variable. The supported data types include: 16-Bit
Unsigned Integer, 32-Bit Unsigned Integer, 16-Bit Signed Integer, 32-Bit Signed Integer,
16-Bit BCD, 32-Bit BCD, 32-Bit Floating Point, 16-Bit Signed BCD (LMB), 32-Bit Signed
BCD (LMB), 16-Bit Signed BCD (LMD), and 32-Bit Signed BCD (LMD).
Monitor Address Specifies the variable to be monitored.
Click to enter an address for this field. Click to select a tag for this field.
Continued
The following table shows the content of the parameter block when the data type is 16-bit
and the scale of the meter is dynamic.
Word Parameter
0 The minimum of the monitored variable
1 The maximum of the monitored variable
2, 3 The minimum of the mark for the scale; 32-bit integer number
4, 5 The maximum of the mark for the scale; 32-bit integer number
The following table shows the content of the parameter block when the data type is 32-bit
and the scale of the meter is not dynamic.
Word Parameter
0, 1 The minimum of the monitored variable
2, 3 The maximum of the monitored variable
The following table shows the content of the parameter block when the data type is 32-bit
and the scale of the meter is dynamic.
Word Parameter
0, 1 The minimum of the monitored variable
2, 3 The maximum of the monitored variable
4, 5 The minimum of the mark for the scale; 32-bit integer number
6, 7 The maximum of the mark for the scale; 32-bit integer number
Min. Specifies the minimum of the monitored variable when the Dynamic Range is not selected.
Max. Specifies the maximum of the monitored variable when the Dynamic Range is not selected.
Needle Color Select a color for the needle.
Swing Radius You can adjust the radius for the swing of the needle. This field specifies the offset to be
Adjustment added to the default radius.
Angle You can adjust the span for the swing of the needle. This field specifies the offset to be
added to the default span.
Center X You can adjust the horizontal position for the pivot of the needle. This field specifies the
offset to be added to the default horizontal position.
Center Y You can adjust the vertical position for the pivot of the needle. This field specifies the offset
to be added to the default vertical position.
Span and 360° & 90° 360° & 0° 360° & 270° 360° & 180°
Origin
Example
Span and 270° & 45° 270° & 315° 270° & 225° 270° & 135°
Origin
Example
Span and 180° & 90° 180° & 0° 180° & 270° 180° & 180°
Origin
Example
Span and 90° & 90° 90° & 0° 90° & 270° 90° & 180°
Origin
Example
Span and 90° & 45° 90° & 315° 90° & 225° 90° & 135°
Origin
8.3.3 Settings
You can complete all the settings of a circular bar graph in the Circular Bar Graph property sheet. This sheet contains
the following four pages.
■ General
Described in Section 8.3.4.
■ Scale
Described in Section 4.3.2.
■ Advanced
Described in Section 4.3.3.
■ Visibility
Described in Section 4.3.4.
This section describes how to define the general settings for a circular bar graph.
The above is an example of the General page of the Circular Bar Graph property sheet.
The following table shows the content of the parameter block when the data type is 16-bit and
the scale of the circular bar graph is dynamic.
Word Parameter
0 The minimum of the monitored variable
1 The maximum of the monitored variable
2, 3 The minimum of the mark for the scale; 32-bit integer number
4, 5 The maximum of the mark for the scale; 32-bit integer number
The following table shows the content of the parameter block when the data type is 32-bit and
the scale of the circular bar graph is not dynamic.
Word Parameter
0, 1 The minimum of the monitored variable
2, 3 The maximum of the monitored variable
The following table shows the content of the parameter block when the data type is 32-bit and
the scale of the circular bar graph is dynamic.
Word Parameter
0, 1 The minimum of the monitored variable
2, 3 The maximum of the monitored variable
4, 5 The minimum of the mark for the scale; 32-bit integer number
6, 7 The maximum of the mark for the scale; 32-bit integer number
Min. Specifies the minimum of the monitored variable when the Dynamic Range is not selected.
Max. Specifies the maximum of the monitored variable when the Dynamic Range is not selected.
Bar Pattern Select a pattern for the circular bar graph. The pattern will be used to fill the arc/circular strip of
the circular bar graph. When the pattern is filled in the circular bar graph, the black part of the
pattern is painted with the color specified in the Bar FG Color field and the white part of the
pattern is painted with the color specified in the Bar BG Color field.
Bar FG Color Select a color for painting the black part of the specified pattern.
Bar BG Color Select a color for painting the white part of the specified pattern.
A line chart displays a set of data by drawing a data point for each datum and drawing a line that connects all the data
points in sequence. The vertical position of a data point is determined by the value of the associated datum. The
horizontal position of a data point is determined by the order of the associated datum in the data set.
A line chart can display up to 8 sets of data. The following example shows a line chart that displays 3 sets of data.
A line chart can provide a cursor for you to select desired data points. The cursor of the line chart is a vertical line
segment. The user can move the cursor horizontally within a line chart to the desired data point(s). The values of the
selected data points can be displayed and output to an internal variable called Cursor Data Receiving Buffer.
8.4.3 Settings
You can complete all the settings of a line chart in the Line Chart dialog box. This dialog box contains the following
four pages.
■ General
Described in Section 8.4.4.
■ Pen
Described in Section 8.4.5.
■ XY Axis
Described in Section 8.4.6.
■ Visibility
Described in Section 4.3.4.
Number of Data Sets Specifies how many data sets that the line chart will read. The line chart displays one line for
each data set. A line chart can display up to 8 lines.
Maximum Number of Specifies the maximum number of data points that the line chart will read for every data set.
Data Points Per Data A line chart can display up to 255 data points for one data set.
Set Note: The actual number of data points for every data set must be specified at runtime. The
actual number must not exceed the maximum number.
Continued
Direction Specifies the direction that the line chart draws the data points.
Show Mark Check this option so the line chart will put a square mark on every data point.
Show Line Check this option so the line chart will display a line connecting all the data points of a data
set in sequence.
Clear Trigger The bit variable that will trigger the line chart to clear its content when its state changes from
off to on. Click to enter an address for this field. Click to select a tag for this field.
Cursor Show Check this option so the line chart will display a cursor. You can touch and drag the cursor to
Cursor the data point(s) that you want to select.
Cursor Select a color for the cursor.
Color
Value Select a font for displaying the values of the selected data point(s).
Display
Font
Cursor The variable that will receive the value(s) of the selected data point(s). It must be a piece of
Data the internal memory.
Receiving
Buffer Click to enter an address for this field. Click to select a tag for this field.
The following table shows the data arrangement of the buffer when the data type is 16-bit.
Word Description
0 The sequence number of the cursor selected data in the data set
1 The value of the selected data point of data set 1.
2 The value of the selected data point of data set 2.
… …
8 The value of the selected data point of data set 8.
The following table shows the data arrangement of the buffer when the data type is 32-bit.
Word Description
0~1 The sequence number of the cursor selected data in the data set
2,3 The value of the selected data point of data set 1.
4,5 The value of the selected data point of data set 2.
… …
16,17 The value of the selected data point of data set 8.
Continued
The following table shows the data arrangement of the parameter block when the data type
is 32-bit.
Word Description
0,1 The minimum of the mark for the X axis; 32-bit integer number
2,3 The maximum of the mark for the X axis; 32-bit integer number
4,5 The minimum of the mark for the Y axis; 32-bit integer number
6,7 The maximum of the mark for the Y axis; 32-bit integer number
8,9 The minimum for pen #1; 32-bit integer number, 32-bit unsigned integer number,
or 32-bit floating point number
10,11 The maximum for pen #1; (Same as above)
12,13 The minimum for pen #2; (Same as above)
14,15 The maximum for pen #2; (Same as above)
… …
36,37 The minimum for pen #8; (Same as above)
38,39 The maximum for pen #8; (Same as above)
The following table describes each property in the Pen page. Note that pen #1 is for data set 1; pen #2 is for data set
2; and so on.
Property Description
Pen #1 Dynamic Check this option so the minimum and the maximum of the associated data set will be
~ Pen Range specified at runtime. This option is available when the Dynamic Range option in the
#8 General page is selected.
Min. The minimum of the associated data set. This property is available when the Dynamic
Range option is not selected.
Max. The maximum of the associated data set. This property is available when the Dynamic
Range option is not selected.
Mark Size Select a size for the data point mark. The selection is valid when the Show Mark option in
the General page is selected.
Line Style Select a style for the connecting lines. The selection is valid when the Show Line option in
the General page is selected.
Color Select a color for the connecting lines.
Show Value Select one of the following methods for displaying the selected data point value.
Show Value Description
(None) Does not display the data point value.
Original Displays the data point value without modification.
Scaled Displays the corresponding Y axis value of the data point.
The selection is valid when the Show Cursor option in the General page is selected.
A scatter chart displays a set of data by drawing a data point for each datum and drawing a line that connects all the
data points in sequence. Each datum is a coordinate that contains an X value and a Y value. The vertical position of a
data point is determined by the X value of the associated datum. The horizontal position of a data point is determined
by the Y value of the associated datum.
A scatter chart can display up to 8 sets of data. The following example shows a scatter chart that displays 3 sets of
data.
You can complete all the settings of a scatter chart in the Scatter Chart dialog box. This dialog box contains the
following four pages.
■ General
Described in Section 8.5.4.
■ Pen
Described in Section 8.5.5.
■ XY Axis
Described in Section 8.4.6.
■ Visibility
Described in Section 4.3.4.
Number of Specifies how many data sets that the scatter chart will display. A scatter chart can display up to 8
Data Sets sets of data.
Maximum Specifies the maximum number of data points that the scatter chart will display for every data set. A
Number of scatter chart can display up to 255 data points for one data set.
Data Points Note: The actual number of data points for every data set is specified at runtime. The actual number
Per Data Set must not exceed the maximum number.
Show Mark Check this option so the scatter chart will show a square mark on every data point.
Show Line Check this option so the scatter chart will display a line between two adjacent data points of a data
set.
Clear Trigger The bit variable that triggers the scatter chart to clear its content when its state changes from off to
on. Click to enter an address for this field. Click to select a tag for this field.
Continued
eV Manual V1.2a - 17.03.2010
322
Manual
Property Description
Cursor Show Cursor Check this option so the scatter chart will display a cursor. You can touch and drag the
cursor within the chart.
Cursor Color Select a color for the cursor.
Dynamic Dynamic Check this option so the minimum and the maximum for the X and Y values of each data
Range Range set can be specified at runtime. When this option is selected, the minimum and
maximum of the marks for the X axis and Y axis can be specified at runtime too. The
data that specifies the above two ranges should be set and arranged correctly in a
memory block called the dynamic range parameter block. You need to specify the
dynamic range parameter block in the Dynamic Range Parameter Block field.
Dynamic Specifies the variable that stores the dynamic range parameter block for the line chart
Range when the Dynamic Range is selected.
Parameter
Block Click to enter an address for this field. Click to select a tag for this field.
The following table shows the data arrangement of the parameter block when the data
type is 16-bit.
Word Description
0,1 The minimum of the mark for the X axis; 32-bit integer number
2,3 The maximum of the mark for the X axis; 32-bit integer number
4,5 The minimum of the mark for the Y axis; 32-bit integer number
6,7 The maximum of the mark for the Y axis; 32-bit integer number
8 The minimum of X values for pen #1; 16-bit integer number or 16-bit
unsigned integer number
9 The maximum of X values for pen #1; (Same as above)
10 The minimum of Y values for pen #1; (Same as above)
11 The maximum of Y values for pen #1; (Same as above)
12 The minimum of X values for pen #2; (Same as above)
13 The maximum of X values for pen #2; (Same as above)
… …
38 The minimum of Y values for pen #8; (Same as above)
39 The maximum of Y values for pen #8; (Same as above)
The following table shows the data arrangement of the parameter block when the data
type is 32-bit.
Word Description
0,1 The minimum of the mark for the X axis; 32-bit integer number
2,3 The maximum of the mark for the X axis; 32-bit integer number
4,5 The minimum of the mark for the Y axis; 32-bit integer number
6,7 The maximum of the mark for the Y axis; 32-bit integer number
8,9 The minimum of X values for pen #1; 32-bit integer number, 32-bit
unsigned integer number, or 32-bit floating point number
10,11 The maximum of X values for pen #1; (Same as above)
12,13 The minimum of Y values for pen #1; (Same as above)
14,15 The maximum of Y values for pen #1; (Same as above)
… …
64,65 The minimum of X values for pen #8; (Same as above)
66,67 The maximum of X values for pen #8; (Same as above)
68,69 The minimum of Y values for pen #8; (Same as above)
eV Manual V1.2a - 17.03.2010
323
Manual
70,71 The maximum of Y values for pen #8; (Same as above)
The following table describes each property in the Pen page. Note that pen #1 is for data set 1; pen #2 is for data set
2; and so on.
Property Description
Pen Dynamic Check this option so the minimum and the maximum for the X and Y values of the
#1 ~ Range associated data set will be specified at runtime. This option is available when the
Pen Dynamic Range option in the General page is selected.
#8 X Min. The X minimum of the associated data set. This property is available when the Dynamic
Range option is not selected.
X Max. The X maximum of the data value of the associated data set. This property is available
when the Dynamic Range option is not selected.
Y Min. The Y minimum of the associated data set. This property is available when the Dynamic
Range option is not selected.
Y Max. The Y minimum of the associated data set. This property is available when the Dynamic
Range option is not selected.
Mark Size Select a size for the data point mark. The selection is valid when the Show Mark option in
the General page is selected.
Line Style Select a style for the connecting lines. The selection is valid when the Show Line option in
the General page is selected.
Color Select a color for the connecting lines.
9 Animated Objects
9.1 Pipelines
Flow Effect
Up T Connector
Left T Connector
L Connector
Selected Pipe
7. Right-click anywhere on the pipeline and use the Insert Connector command on the object popup menu to
insert a new T/ Cross connector for the pipeline. Or right-click the existing connector or pipe of the pipeline and use
the Delete Pipe Segment command on the object popup menu to delete the connector and its connected pipe.
Popup menu Description
Add a Up/Down T or Cross connector to the specified position on the horizontal pipe.
Insert Connector
Add a Left/Right T or Cross connector to the specified position on the vertical pipe
Delete Pipe
Segment
9.1.3 Settings
You can complete all the settings of a pipeline in the Pipeline property sheet. This sheet contains the following three
pages.
■ General
Described in Section 9.1.4.
■ Pipe
Described in Section 9.1.5.
■ Visibility
Described in Section 4.3.4.
2D Type 2
2D Type 3
3D Type 1
3D Type 2
Shading Select a shading method when the Type is “3D Type 1” or “3D Type 2”. There
Flow Effect Default Select a set of symbols as the default symbols for the flow effect. There are 12
Symbols available sets:
Click to make all pipes of the pipeline use the default color
for the follow symbols.
You can change the size, position, and/or color of a dynamic circle at runtime.
9.2.2 Settings
You can complete all the settings of a dynamic circle in the Dynamic Circle property sheet. This sheet contains the
following two pages.
■ General
Described in Section 9.2.3.
■ Visibility
Described in Section 4.3.4.
Property Description
Monitor Address Specifies the variable that controls the dynamic circle.
Click to enter an address for this field. Click to select a tag for this field.
The following table shows the data arrangement of the variable.
Data Type 16-Bit Unsigned Int. 32-Bit Unsigned Int.
16-Bit Signed Int. 32-Bit Signed Int.
Controllable 16-Bit BCD 32-Bit BCD
Center
Radius W0 FG Color W0,1 FG Color
FG Color
Center
Radius W0 Radius W0,1 Radius
FG Color
Center
W0 Radius W0,1 Radius
Radius
W1 FG Color W2,3 FG Color
FG Color
Center
W0 X W0,1 X
Radius
W1 Y W2,3 Y
FG Color
Center W0 X W0,1 X
Radius W1 Y W2,3 Y
FG Color W2 FG Color W4,5 FG Color
Center W0 X W0,1 X
Radius W1 Y W2,3 Y
FG Color W2 Radius W4,5 Radius
W0 X W0,1 X
Center
W1 Y W2,3 Y
Radius
W2 Radius W4,5 Radius
FG Color
W3 FG Color W6,7 FG Color
The 64K-color HMI models, such as PV080, PV084, PV104 and PV121, use one word to specify a color. The color
word contains the three color components: red, green, and blue. The format to store the three color components of a
color is described below.
Example
Color Red Green Blue Hex. Value Decimal Value
Black 0 0 0 0000H 0
Blue 0 0 16 0010H 16
Green 0 32 0 0400H 1024
Cyan 0 32 16 0410H 1040
Red 16 0 0 8000H 32768
Magenta 16 0 16 8010H 32784
Brown 16 32 0 8400H 33792
Dark gray 16 32 16 8410H 33808
Gray 24 48 24 C618H 50712
Light blue 0 0 31 001FH 31
Light green 0 63 0 07E0H 2016
Light cyan 0 63 31 07FFH 2047
Light red 31 0 0 F800H 63488
Light magenta 31 0 31 F81FH 63519
Yellow 31 63 0 FFE0H 65504
White 31 63 31 FFFFH 65535
The following table lists the color index values used by the 256-color HMI models, such as PV035-TST and PV057-
TST. You can use the color index values to specify the desired colors for your application.
You can change the size, position, and/or color of a dynamic rectangle at runtime.
9.3.2 Settings
You can complete all the settings of a dynamic rectangle in the Dynamic Rectangle property sheet. This sheet
contains the following two pages.
■ General
Described in Section 9.3.3.
■ Visibility
Described in Section 4.3.4.
Property Description
Monitor Address Specifies the variable that controls the dynamic rectangle.
Click to enter an address for this field. Click to select a tag for this field.
The following table shows the data arrangement of the monitored variable.
Data Type 16-Bit Unsigned Int. 32-Bit Unsigned Int.
16-Bit Signed Int. 32-Bit Signed Int.
Controllable 16-Bit BCD 32-Bit BCD
Position
Size W0 FG Color W0,1 FG Color
FG Color
Position
W0 Width W0,1 Width
Size
W1 Height W2,3 Height
FG Color
Position
W0 X W0,1 X
Size
W1 Y W2,3 Y
FG Color
Position W0 X W0,1 X
Size W1 Y W2,3 Y
FG Color W2 FG Color W4,5 FG Color
W0 X W0,1 X
Position
W1 Y W2,3 Y
Size
W2 Width W4,5 Width
FG Color
W3 Height W6,7 Height
W0 X W0,1 X
Position W1 Y W2,3 Y
Size W2 Width W4,5 Width
FG Color W3 Height W6,7 Height
W4 FG Color W8,9 FG Color
Property Description
Anchor Point Select one of the following our corners of the dynamic rectangle that will not
move when its size changes: Upper Left, Upper Right, Lower Left, and Lower
Right. This item is available when the Size is controllable but the Position is
not controllable.
Rectangle Solid Solid Check this option if you want the dynamic rectangle to be filled with the
selected pattern.
Pattern Select a pattern for filling the dynamic rectangle.
FG Color Select a color for painting the black part of the pattern. This item is available
when the Pattern is not solid white.
BG Color Select a color for painting the white part of the pattern.
Border Border Check this option if you want the dynamic rectangle to have a border.
Border The border color.
Color
You can use a GIF display to show a GIF image and control the animation of that image.
Options Description
Visibility Control You can show or hide a GIF display by a specified bit or the current user level. Select and
set up this option in the Visibility page.
9.4.2 Settings
You can complete all the settings of a GIF display in the GIF Display property sheet. This sheet contains the following
two pages.
■ General
Described in Section 9.4.3.
■ Visibility
Described in Section 4.3.4.
Property Description
ID The object’s identifier. It is generated when the object is created. The identifier is unique within the
screen where the object is on. The format of the ID’s for the GIF displays is GDnnnn.
Note You can type a note for the object.
Graphic Select a GIF image for the GIF display. You can use the drop-down list to select a GIF image from
the picture database. You can click to select a GIF image from a file. You can click to select
a GIF image from a library file. If the selected GIF image is not from the picture database, it is
imported and saved in the picture database.
Continued
You need to specify the number of states for a picture display and the number must not exceed the allowable
maximum. You can define a picture for each state. At runtime, a picture display shows the picture corresponding to
the state of the monitored variable. The state of the monitored variable is determined by the state type and value of
the variable.
Options Description
Visibility Control You can show or hide a picture display by a specified bit or the current user level. Select and set
up this option in the Visibility page.
9.5.3 Settings
You can complete all the settings of a picture display in the Picture Display property sheet. This sheet contains the
following three pages.
■ General
Described in Section 9.5.4.
■ Picture
Described in Section 4.3.1.7.
■ Visibility
Described in Section 4.3.4.
An animated graphic can change its image and move along a specified path automatically. You can also change the
position and image of an animated graphic at runtime by a specified variable. You can use BMP/JPG/GIF/Object
Group for the animated graphics.
9.6.2 Settings
You can complete all the settings of an animated graphic in the Animated Graphic property sheet. This sheet contains
the following five pages. Some of the pages appear only when they are needed.
■ General
Described in Section 9.3.3.
■ Picture
Described in Section 4.3.1.7.
■ GIF
Described in Section 9.3.4.
■ Path
Described in Section 9.3.5.
■ Visibility
Described in Section 4.3.4.
Property Description
ID The object’s identifier. It is generated when the object is created. The identifier is
unique within the screen where the object is on. The format of the ID’s for the
animated graphics is AGnnnn.
Note You can type a note for the object.
Total States The number of graphic states. You can specify a picture for each state. The
animated graphic displays the associated picture for the current state.
State Control Select one of the following methods to control the state of the animated graphic.
State Control Description
Automatic The animated graphic changes the state in sequence
starting from state 0 at a rate specified in the Change Rate
field. When the current state is the last state, it will change
back to state 0.
Position The state is determined by where the animated graphic is.
In the Path page, you can define the associated state for
each path point. For details, see Section 9.6.5 Path
Settings.
Dynamic The state is determined at run time by the variable
specified in the Monitor Address field.
The animated graphic displays the associated picture for the current state.
Change Rate (Hz) Select a rate when the State Control is Automatic or the Graphic Type is GIF.
Continued
Select one of the following path types for the animated graphic:
Path Type Description
Still The animated graphic does not move.
You can also position the mouse pointer over one of the points. When the
cursor turns to be , drag the point to the position you want.
Dynamic The position of the animated graphic is determined at runtime by the variable
specified in the Monitor Address field. The data elements of the variable that
specify the position are X and Y. They specify the coordinate of the position.
$U100: State
$U101: X
$U102: Y
Dynamic; The position of the animated graphic is determined at runtime by the variable
Predefined specified in the Monitor Address field. The data element of the variable that
Positions specifies the position is Point. It specifies which point of the predefined path
that the animated graphic should move to.
Continued
eV Manual V1.2a - 17.03.2010
348
Manual
Property Description
Effect Marquee Check this option if you want the current picture of the animated graphic to scroll
into both ends of its path. This option is available when the Path Type is Horizontal
Line or Vertical Line.
Duplicate Check this option so the current picture of the animated graphic will be duplicated
Picture by a specified number of times. All the copies will display and move together. This
option is available when the Marquee option is selected.
Number of Specifies how many copies should be made for the Duplicate Picture option.
Copies
Monitor Address Specifies the variable that controls the animated graphic.
Click to enter an address for this field. Click to select a tag for this field.
The following table shows the data arrangement of the variable:
Data Type 16-Bit Unsigned Int. 32-Bit Unsigned Int.
16-Bit Signed Int. 32-Bit Signed Int.
Settings 16-Bit BCD 32-Bit BCD
W0 X W0,1 X
Path Type = Dynamic
W1 Y W2,2 Y
Path Type =
Dynamic; Predefined W0 Point W0,1 Point
Positions
W0 State W0,1 State
State Control = Dynamic
W1 X W2,3 X
Path Type = Dynamic
W2 Y W4,5 Y
State Control = Dynamic
Path Type = W0 State W0,1 State
Dynamic; Predefined W1 Point W2,3 Point
Positions
Data Type The data type of the variable that controls the animated graphic. The supported
data types include: 16-bit Unsigned Integer, 32-bit Unsigned Integer, 16-bit Signed
Integer, 32-bit Signed Integer, 16-bit BCD, and 32-bit BCD.
To create an object group, you can first group the selected objects and then save the group into the object library.
To use the object group, you can click the button in the Picture page to bring up the Copy Object from Object
Library dialog box. In the dialog, you can pick up an existing object group for the animated graphic.
Any modifications such as moving the group, resizing the group, deleting the group… will be applied to the objects of
the group at the same time. However, each object in the group can have its own properties. You can double click the
icon to bring up the properties dialog box of the corresponding object and then define the settings of object.
The following is an example shown you how to edit the object group for the animated graphic. The object group
includes a numeric entry, a numeric display and a picture object. They will move along with a set of connected lines.
At the same time, the value of numeric entry and the numeric display will be changed.
1. Set up the animated graphic with the object group as its graphic.
End point
Start
point
To modify the path, drag path points to desired positions. You can insert a path point by right-clicking at the desired
position on the path and clicking Insert Point on the popped up menu. To delete a path point, right-click at the path
point and click Delete Point on the popped up menu. Use the Path page to define all the properties of the path.
The following is an example of the Path page.
In this chapter we will explain how recipes in EV Designer can be set up, stored and transferred. We also describe
how to configure the basic functions and recipe objects (recipe selector and recipe table) used for recipes.
10.1 Recipes
■ Recipe Block
A recipe block is a memory block stored recipe data as a two dimensional array in the panel. The memory size of each
recipe block is the product of the size of a recipe by number of recipes in word. You can create up to 16 recipe blocks
for your application. Each recipe block can contain at most 65535 recipes. Each recipe can have as many as 4096
words of data.
■ Recipe
A recipe is a group of data items. You can use a recipe number or a recipe name to index a recipe in the
corresponding recipe block.
The recipe number is a sequence number between 0 and number of recipes. It is unique among all recipes of the
recipe block. The current recipe number of the recipe block m is saved in the current recipe number register $RNm
(m: The recipe block ID).
The recipe name can be represented by a specified ASCII or Unicode String data item of the recipe. To specify an
ASCII or Unicode String data item as the recipe name, you need to open the dialog box of a recipe block and set the
data type of the related data item into ASCII String or Unicode String in the data item page. For details about recipe
data item settings, please see Section 10.5.2.
■ Recipe Data Item
A data item is a word or words of data used to represent an application related data or a machine setup parameter
used in process and production control. You can specify the format such as name, data type, size, scaling and range
check for each data item in recipe block dialog box.
The following is a sample of a recipe block with 3 recipes and each recipe has 8 data items.
A recipe
A data Item
■ Recipe Data
There are two types of recipe data: TXT Data and PRD Data. These recipes can be transferred between PC and HMI
or between HMI and USB Memory Stick/Micro SD card directly.
Recipe Description
Data
TXT Data Can be created and edited in Microsoft Excel or text editor software (e.g., Notepad)
PRD Data Binary Data created in EV Designer
Can be edited in RecipeEditor
Assume there are two recipe blocks (Recipe Block 0 and Recipe Block 9) in an application.
Recipe Block 0 has 3 recipes and each recipe has 4 data items named A,B,C and D.
Recipe Block 9 has 2 recipes and each recipe has 3 data items named E,F and G.
The following illustration gives an overview of recipe data flow and recipe memory allocation.
Recipe Data flow Memory allocation
Recipe Block 0
Recipe 2
Recipe Block 9
Recipe 1Addr. Data Item
Recipe 1
Addr. R0:8
Data Item A
Recipe 0 R0:9 B Addr. Data Item
Addr. DataR0:4 A
Item R0:10 C R9:3 E
PC R0:5 B R9:4 F
R0:0 A R0:11 D
R0:6 C Recipe 0G
R9:5
R0:1 B
R0:7 D Addr. Data Item
R0:2 C
R9:0 E
R0:3 D
R9:1 F
R9:2 G
By FB ( ) or Recipe Block 0
Recipe 2
Macro ( ) Recipe Block 9
Recipe 1Addr. Data Item
Recipe 1
Addr. R0:8
Data Item A
Recipe 0 R0:9 B Addr. Data Item
Flash Addr. DataR0:4 A
Item R0:10 R9:3 E
C
ROM R0:5 B R9:4 F
R0:0 A R0:11 D
R0:6 C Recipe 0G
R9:5
R0:1 B
R0:7 D Addr. Data Item
PM R0:2 C
R9:0 E
(HMI) R0:3 D
R9:1 F
R9:2 G
By FB ( ) Current Recipe
(Function Button) By FB ( ) or
CB and SW ( ) Recipe Block 9
Set recipe block
Recipe 1 number to 9
Addr. Data Item
CR9:0 E
CR9:1 F $RN9
CR9:2 m
G
5
MicroSD Card
■ Transfer recipes
Described in Section 10.4
To run the DTH, choose Start > Programs > EV Designer > Data Transfer Helper (DTH).
To change current recipe number, the PLC first sets the Parameter Two Register to the desired recipe block and the
Parameter One Register to the desired recipe number, then turns on the Set Current Recipe Number (#2) command
flag. Also $RNm (Current Recipe Number Register, m: Recipe Block ID) of the panel can be changed by the PLC.
To update a recipe in the panel, the PLC first sets the Parameter Two Register to the desired recipe block and the
Parameter One Register to the desired recipe number, then turns on the Read Recipe From PLC (#3) command flag.
The panel reads data in Recipe Block to update the specified recipe in the panel.
To receive a recipe, the PLC first sets the Parameter Two Register to the desired recipe block and Parameter One
Register to the desired recipe number, then turns on the Write Recipe To PLC (#4) command flag. The panel sends
the specified recipe data to the Recipe Block in PLC.
Note: You do not need to specify the recipe block if the application has only one recipe block.
Note: To make the above operation work, the specified recipe block must exist, or the panel ignores the request.
And the specified recipe number in the Parameter One Register must be between 0 and the maximum recipe
number - 1.If the Parameter One Register is greater than or equal to the maximum recipe number, the panel
ignores the request.
You can set up a recipe block with the Recipe Block dialog box. There are two ways to open the dialog box of a recipe
block:
1) In the EV Designer's Project Manager window, right-click the node of the desired Recipe Block and select
Properties.
2) In the EV Designer's menu bar, click Panel to bring up the Panel sub-menu. Click Recipes in the Panel sub-menu
to bring up the Recipe Block pop-up menu. Select Properties in the pop-up menu to bring up the recipe block list of
the current panel application. Select the recipe block in the list.
The Recipe Block dialog box contains the following two pages:
■ General
Described in Section 10.5.1.
■ Data Item
Described in Section 10.5.2.
Continued
eV Manual V1.2a - 17.03.2010
361
Manual
Property Description
Current Recipe The address range of the internal memory in the panel that the current recipe
locates.
Range Type Address Format Description
Bit Address Range $CRm:n.b Each bit address in the range
b: 0~f refers to a bit of a recipe word in
the current recipe of the
specified recipe block.
Word Address Range $CRm:n Each word address in the range
refers to a recipe word in the
current recipe of the specified
recipe block.
Current Recipe $RNm An internal register of the panel
Number Register that specifies the current recipe
number of the specified recipe
block.
Legend: m = Recipe Block ID; n = The Number of Recipe Word, b = Bit Number;
Need space in flash ROM to Check this option if you need the space in flash ROM to save the backup recipes.
save backup
Do not use battery backed Check this option so the memory of the recipes will be located in ordinary RAM
RAM and the recipe memory will be cleared whenever the target panel is powered up. If
this option is not selected, the memory of the recipes will be located in the battery
backed RAM. The recipe data will not be lost after power down if the battery
backed RAM is used for the recipes.
The Data Item page contains two parts. The left part is the data item list that shows the address and name of each
data item in a row. The right part shows the properties of the selected data item. To select a data item, click the row of
that data item in the data item list. The following table describes each property of the data item.
Property Description
Address You can use the address shown here to refer to the latest value of the data item.
Name Specifies the name of the data item for the language specified in the Language field.
Language Select a language so you can view and edit the name of the data item for that
language.
Data Type The data type of the data item. The supported data types include: 16-Bit Unsigned
Integer, 32-Bit Unsigned Integer, 16-Bit Signed Integer, 32-Bit Signed Integer, 16-Bit
BCD, 32-Bit BCD, 32-Bit Floating Point, ASCII String, and Unicode String.
Note that Unicode String is supported for PanelExpress only.
Continued
eV Manual V1.2a - 17.03.2010
363
Manual
Property Description
Display Type The display type for the value of the data item. The following table shows the available
display types for each data type.
Data Type Available Display Types
16-Bit Unsigned Integer 16-Bit Unsigned Decimal, 16-Bit Hexadecimal, 16-Bit Octal
32-Bit Unsigned Integer 32-Bit Unsigned Decimal, 32-Bit Hexadecimal, 32-Bit Octal
16-Bit Signed Integer 16-Bit Signed Decimal
32-Bit Signed Integer 32-Bit Signed Decimal
16-Bit BCD 16-Bit Unsigned Decimal
32-Bit BCD 32-Bit Unsigned Decimal
32-Bit Floating Point 32-Bit Floating Point
ASCII String ASCII String
Unicode String Unicode String
Total Digits Specifies the number of digits to be displayed for the value of the data item.
Fractional Digits Specifies how to display the fractional part for the value of the data item. When the Display
Type is 32-bit Floating Point, this property specifies the number of fractional digits to be
displayed. When the Display Type is not 32-bit Floating Point, this property specifies not only
the number of fractional digits to be displayed but also the number of least significant digits
to be displayed as the fractional part. With this feature, an integer can be shown as a fixed
point number.
Example:
Total Fractional Sampled Displayed
Display Type
Digits Digits Value Value
32-bit Floating Point 4 2 12.34 12.34
32-bit Floating Point 4 2 123.4 23.40
16-bit Signed Decimal 5 2 12345 123.45
16-bit Signed Decimal 5 2 -5 -0.05
Scaling Check this option if you want the value of the data item to be displayed in a scaled manner.
The following is the scaling formula:
DisplayedValue = SampledValue * Gain + Offset
Note: The Gain and Offset are 32-bit floating point numbers. They have at most 6 significant
digits. The rounding and truncation errors may happen.
Gain Available when the Scaling option is checked. Specifies the Gain used in the scaling formula.
Offset Available when the Scaling option is checked. Specifies the Offset used in the scaling
formula.
Range Check Check this option if you want the data item to verify the entered value according to the
specified minimum and maximum. If the entered value is not within the allowable range, the
entered value will not be output.
Min Specifies the minimum value.
Max Specifies the maximum value.
When the button is touched, the recipe selector displays a list box beneath itself as shown in the
following example.
The list box lists the index strings of all recipes of the recipe block. One index string per line. The
index string of the current recipe is highlighted. If the desired recipe is not in the view, you can use
the scroll bar attached to the right side of the list to scroll the index string. When you select a desired
recipe by touching its index string, the recipe selector writes the recipe number of the selected
recipe to current recipe number register and closes the list box.
If you want to cancel the operation when the list box is showing, touch anywhere other than the
index string in the list box.
10.6.3 Settings
You can complete all the settings of a recipe selector in the Recipe Selector property sheet. This sheet contains the
following three pages.
■ General
Described in Section 10.6.4.
■ Advanced
Described in Section 4.4.5.
■ Visibility
Described in Section 4.4.6.
Recipe Block Select the recipe block whose recipe is to be selected by the Recipe Selector
object.
Recipe Name Select a data item from the list as the recipe name. You can select any data
items with ASCII String data type as the name of the recipe from the drop
down list.
Sort by Recipe Name Check this option to automatically sort all recipe names added to the list box.
Font The font of the displayed string.
Text Color The color of the displayed string.
The above is an example of the recipe table with horizontal view. The first row displays the data item
name of each column. The other rows display one recipe per row. The first column displays recipe
number. You can create scroll button groups or scroll bars to scroll the contents.
Vertical Displays the recipes column by column and recipe data items row by row.
View
The above is an example of the recipe table with vertical view. The first column displays the data item
name of each row. The other columns display one recipe per column. The first row displays the recipe
number. You can create scroll button groups or scroll bars to scroll the contents.
Current Displays the recipe data items of the current recipe row by row.
Recipe
The above is an example of the current recipe. The first column displays the data item name of each
row. The other column displays the current recipe. You can create scroll button groups or scroll bars to
scroll the contents.
10.7.3 Settings
You can complete all the settings of a recipe table in the Recipe Table property sheet. This sheet contains the
following three pages.
■ General
Described in Section 10.7.4.
■ Data Item
Described in Section 10.7.5.
■ Visibility
Described in Section 4.4.6.
Allows operator input Check this option if you allow the operator to update the value of the recipe
data item.
Recipe Block Select the recipe whose collected data is to be displayed by the object.
Title Language Select a language so you can view and edit the settings of the title row for that
language.
Font Select a font for the title text.
Color Select a color for the title text.
Background Color Select a color for the background of the title row.
Recipe Number Specifies the title for the recipe number column.
Grid Vertical Check this option if you want the object to have vertical grids.
Horizontal Check this option if you want the object to have horizontal grids.
Color Select a color for the grids.
Data Font Select a font for displaying data.
Default Color Select a color as the default color for displaying data.
Set Default Color to Click this button to set the colors of all the data items to the Default Color.
All Data Items
Recipe Color Select a color for the recipe number.
Number
Line Spacing Specifies the extra space in pixels for two adjacent rows in the table.
Item Spacing Specifies the extra space for every column in the table.
The following table describes each property in the Data Item page.
Property Description
Language Select a language so you can view and edit the settings for that language.
Row #n Name The name of data item #n. The data item names are defined in the Data Item page of the
of the Data Logger dialog box.
propert Display Check this option if you want the object to display data item #n.
y table
Color Select a color for displaying data item #n.
Alignment The alignment for displaying data item #n. There are three types of alignment: Left,
Center, and Right.
Justificatio The justification for displaying data item #n. There are three types of justification:
n Option Description
Zero Suppress The leading digits will not display when they are 0.
Leading Zeros All digits will display.
Leading Spaces The leading digits will display as blank character when they are 0.
Move Up Click the button to move the selected data item before the previous data item. The Move
Up button will help you to reorder the display sequence of the data items It will not be
available when multiple rows are selected or no row is selected.
Move Down Click the button to move the selected data item after the next data item. The Move Down
button will help you to reorder the display sequence of the data items It will not be
available when multiple rows are selected or no row is selected.
In order to use alarm display for your application, you need to set up alarm processing first and then define an alarm
block. This chapter describes how to set up the alarm processing and alarm block. It also describes how to configure
the alarm display to show alarm history, alarm count, active alarm and alarm marquee.
You can use command flag setting in command block or function button to request the panel to clear alarm history or
clear alarm count.
To know how to set up the command flag in command block, please see Section 3.5.1 Command Block and Status
Words. To know how to define a function button, please see Section 5.4.1 Basic Operations of function buttons.
You can set up the alarm processing with the Alarm Properties dialog box. In this dialog, you can determine the
required memory for alarm logging buffer, choose default color and font for the alarm message, specify how to save
the alarm history records to a text file and configure the global alarm marquee if you want to show it on the screen. To
open the dialog box of alarm processing, please double click the node named Alarms in the EV Designer's Project
Manager tool window. The following is an example of the Alarm Properties dialog box.
The table below describes each property in the Alarm Properties dialog.
Property Description
Alarm Logging Size The maximum number of records that the alarm logging buffer can hold. For
st st
Buffer example, 100 means when the 101 alarm happens, the 1 record will be
overwritten.
Required The size of the alarm logging buffer. The unit is byte. The formula to calculate
non-volatile the size is: Alarm Logging Buffer Size = Number of Records * 20 + 16
memory
Continued
Alarm Marquee
Properties Click the button to bring up the Alarm Display dialog box to set up the properties
of the global alarm marquee. Please see Section 11.4.4 for details.
To export a discrete alarm block, right-click the node of the desired discrete alarm block and then select Export Alarm
Block…. in the EV Designer's Project Manager window.
To export an analog alarm block, right-click the node of the desired analog alarm block and then select Export Alarm
Block…. in the EV Designer's Project Manager window.
For example, the following embedded variable in the appended text will display the 32-bit floating point number
stored in W300 with the format of 4 total digits and 1 fractional digit.
If the value of W300 is 123.456 when the alarm occurs, the following text will be appended to its alarm message:
5. Note that the embedded variable specified in the appended text of the first language will be used in the appended
text of all other languages no matter what embedded variables are specified in those appended text.
You can set up a discrete alarm block with the Discrete Alarm Block dialog box. There are two ways to open the dialog
box:
1) In the EV Designer's Project Manager window, move the mouse to the node of the desired discrete alarm
block and
double click the node or right-click the node and then select Properties.
2) In the EV Designer's menu bar, click Panel to bring up the Panel sub-menu. Click Discrete Alarm Block in the
Panel
sub-menu to bring up the Discrete Alarm Block pop-up menu. Select Properties in the pop-up menu to bring up
the discrete alarm block list of the current panel application. Select the desired discrete alarm block in the list.
11.4.1 Settings
Use the dialog box to define all the settings for a discrete alarm block. The following is an example of the discrete
alarm block dialog.
Read Interval Specifies the period between 1 to 3600 seconds that the panel reads Alarm Block and checks the
state of every bit in the block. The shorter the Read Interval is, the faster the alarm display object
will be refreshed, but it will make other objects refresh slower.
To specify all discrete alarms, you need to do the setting on the discrete alarm list and discrete alarm properties field.
The discrete alarm list located on the bottom-left part of the dialog shows all the discrete alarms in the alarm block.
The discrete alarm properties field located on the right of the list shows all the properties of the selected discrete
alarm.
The following table describes each column in the discrete alarm list.
Column Description
No. The number of the discrete alarm in the alarm block.
Address/Bit No./Value If the type is Bits or Random Bits, the column shows the address of the discrete
alarm; If the type is Bits of Word Device, the column shows the bit no of the
discrete alarm. If the type is Word Value, the column shows the value of the
discrete alarm.
Use Check this option if you want to use discrete alarm #n.
Message Displays specified alarm message in selected language.
The following table describes each property for the selected discrete alarm.
Property Description
Address/Bit No./Value Indicates the status of its corresponding alarm. The meaning of the field depends on
the selected type.
Field Name Type Description
Address Bits Shows the address of the selected discrete alarm
Bit No. Bits of Word Shows the bit no of the selected discrete alarm
Device
Value Word Value Shows the value of the selected discrete alarm
Address Random Specifies the bit variable of the selected discrete
Bits
alarm. Click to enter an address. Click to
select a tag.
Alarm State Specify the alarm state to indicate the corresponding alarm is active. If 1(On) is
selected, a bit with high (on) state indicates the corresponding alarm is active. And a
bit with low (off) state indicates the corresponding alarm is clear.
Level Select a level for the alarm between 1 and 8.
ID Specifies the alarm ID The maximum length of the ID is 6 characters.
Message Language Select an existing language that you are setting the message for.
Import Click the button to import the texts of *.csv file and saves the texts as the alarm
All… messages for the current language.
Export All… Click the button to export all the messages for selected language to *.csv file.
Text Specifies the text for the current language. The text will be shown when the alarm is
active.
Appended Specifies the appended text for the current language. For details, please see
Text Section 11.3.4 Embedding Variable in the Appended Text of Alarm Message.
Record alarm Check this option if you want to record the alarm in the alarm display object.
Sound Buzzer Check this option if you want the panel to play sound buzzer when the alarm is
active or clear.
Display message Check this option if you want the panel to display message automatically when the
alarm is active or clear. This field can be checked only when the Display screen is
unchecked.
Display <Check Check this option if you want the panel to display a window screen automatically
screen Box> when the alarm is active or clear. This field can be checked only when the Display
message is unchecked.
Select a window screen to display when the alarm is active or clear. The field is
available when the Display Screen is selected. Note that only Window Screens will
be available for selecting. Please see ?.? to create a window screen.
Required <Check Check this option if you want the operator to acknowledge an alarm. When an alarm
Acknowledge Box> become active, the panel display alarm message or screen with ACK button if
- Required Acknowledgement is selected. The operator should press the ACK button
ment to acknowledge the alarm and have the panel start to refresh the current screen
again. This field is available when either Display message or Display screen is
selected.
Record ACK Check this option if you want to record ACK in the alarm display object
You can set up an analog alarm block with the Analog Alarm Block dialog box. There are two ways to open the dialog
box:
1) In the EV Designer's Project Manager window, move the mouse to the node of the desired analog alarm block
and
double click the node or right-click the node and then select Properties.
2) In the EV Designer's menu bar, click Panel to bring up the Panel sub-menu. Click Analog Alarm Block in the
Panel
sub-menu to bring up the Analog Alarm Block pop-up menu. Select Properties in the pop-up menu to bring up the
analog alarm block list of the current panel application. Select the desired analog alarm block in the list.
11.5.1 Settings
Use the dialog box to define all the settings for an analog alarm block. The following is an example of the analog
alarm block dialog.
Read Specifies the starting address of an alarm block to monitor the status of alarms.
Address
Click to enter an address for this field. Click to select a tag for this field.
Block Size Specifies the block size of an alarm block. The unit is word. The maximum block size you can
specify depends on the type you select.
Type Maximum block size
Continuous Words 16
Random Words 64
Read Interval Specifies the period between 1 to 3600 seconds that the panel reads Alarm Block and checks the
state of every bit in the block. The shorter the Read Interval is, the faster the alarm display object
will be refreshed, but it will make other objects refresh slower.
To specify all analog alarms, you need to do the setting on the analog alarm list and analog alarm properties field.
The analog alarm list located on the bottom-left part of the dialog shows all the analog alarms in the alarm block. The
analog alarm properties field located on the right of the list shows all the properties of the selected analog alarm.
The following table describes each column in the analog alarm list.
Column Description
No. The number of the analog alarm in the alarm block.
Address Shows the address of the analog alarm.
Use Check this option if you want to use analog alarm #n.
Message Displays specified alarm message in selected language.
You need to make selection before editing the analog alarm. To select an analog alarm, click the row of that alarm in
the list. To select multiple rows, click the row on its header column and use Ctrl + Click to add a row to the selection.
If multiple rows are selected, any modification on the common properties such as Level, Record alarm, Sound Buzzer,
Display message, Display screen, Required Acknowledgement, Record ACK, Notification, Tip Screen…will apply to all
selected analog alarms
Property Description
Required <Check Box> Check this option if you want the operator to acknowledge an alarm. When an
Acknowledge- alarm become active, the panel display alarm message or screen with ACK
ment button if Required Acknowledgement is selected. The operator should press
the ACK button to acknowledge the alarm and have the panel start to refresh
the current screen again. This field is available when either Display message
or Display screen is selected.
Record ACK Check this option if you want to record ACK in the alarm display object
Notification Check this option if you want to notify the specified bit when the ACK button is
clicked.
Bit Specifies the bit that receives the notification.
Tip Screen <Check Box> Check this option if you want to display a screen when you select the
corresponding alarm on the alarm display object.
Select a window screen as the tip screen
Play multimedia Check this option if you want the panel to play multimedia when the alarm is
active or clear.
File Name Specifies the file name of the multimedia
The above is an example of the alarm history display. The first row is the title row. It displays the title of
each column. The other rows display one alarm record per row. You can create scroll button groups or
scroll bars to scroll the contents. An alarm history display can have seven columns. The following table
describes the content of each column for an alarm record.
Column Description
Date The date when the record is created. This column is optional.
Time The time when the record is created. This column is optional.
Alarm Block ID The ID of the alarm block in which the associated alarm is defined. This column
is optional.
Alarm Level The level of the associated alarm. This column is optional.
Alarm ID The ID of the associated alarm. This column is optional.
Alarm Status The type of the alarm record. There are three types of alarm records.
Type Description
Active An Active record is created when an alarm is activated.
ACK An ACK record is created when an alarm is acknowledged.
CLR A CLR record is created when an alarm is cleared.
The text color of a row is determined by the type of the alarm record.
Continued
The above is an example of an alarm count display. The first row is the title row. It displays the title of
each column. The other rows display one alarm per row. You can create scroll button groups or scroll
bars to scroll the contents. An alarm count display can have five columns. The following table
describes the content of each column for an alarm.
Column Description
Alarm Block ID The ID of the alarm block in which the alarm is defined. This column is optional.
Alarm Level The level of the alarm. This column is optional.
Alarm ID The ID of the alarm. This column is optional.
Alarm Count The number of occurrences of the alarm.
Alarm The message of the alarm. This column is optional.
Message
The above is an example of an active alarm display. The first row is the title row. It displays the title of
each column. The other rows display one active alarm per row. You can create scroll button groups or
scroll bars to scroll the contents. An active alarm display can have six columns. The following table
describes the content of each column for an active alarm.
Column Description
Date The date when the alarm is activated.
Time The time when the alarm is activated.
Alarm Block ID The ID of the alarm block in which the alarm is defined. This column is optional.
Alarm Level The level of the alarm. This column is optional.
Alarm ID The ID of the alarm. This column is optional.
Alarm The message of the alarm. This column is optional.
Message
The above is an example of an alarm marquee. You can place the following texts in front of the alarm
messages.
Text Description
Alarm Block ID The ID of the alarm block in which the alarm is defined.
Alarm Level The level of the alarm.
Alarm ID The ID of the alarm.
The text color for an alarm is determined by the level of that alarm.
Note: You can sort the list of an alarm display at runtime by touching the title of the column that you want it to be the
sort field. Touching the same title again changes the sort order from the ascending order to the descending order or
vice versa. The columns that can be a sort field include: Date, Time, Alarm Block ID, Alarm Level, Alarm ID, Alarm
Status, and Alarm Count.
Options Description
Visibility You can show and hide an alarm display by a specified bit or the current user level. Select and set
Control this option in the Visibility page.
11.6.3 Settings
You can complete all the settings of an alarm display in the Alarm Display dialog box. This dialog box contains the
following two pages.
■ General
Described in Section 11.4.3.
■ Visibility
Described in Section 4.4.6.
Property Description
Text Sort Type Specifies how the alarm display sorts its list initially. This field is available
when the Type is not Alarm Marquee.
Note: When you want an alarm display to sort its list by the contents of a
column at runtime, simply touch the title of that column and the alarm display
will sort its list right away.
Language Select a language so you can view and edit the language dependent settings
in the Text group for that language. The language dependent properties in the
Text group include Font and Alarm Status Abbreviation.
Font Select a font for the text.
Property Description
Sampling Timed The data logger samples data periodically at a rate specified in the Interval field.
Method You can specify an interval between 1 second and 65535 seconds for the Interval
field. For example, if you want the data logger to sample data every 5 seconds,
specify 5 for the Interval field.
Triggered The data logger samples data once whenever the trigger bit specified in the
Trigger Bit field changes from Off to On.
Clocked The data logger samples data at fixed moments specified in the At Each field.
There are six sets of fixed moments available for the At Each field.
At Each Fixed Moments
1x Every minute at 0 second
5x The following moments of every hour: 00:00, 05:00, 10:00, 15:00,
20:00, 25:00, 30:00, 35:00, 40:00, 45:00, 50:00, 55;00
10x The following moments of every hour: 00:00, 10:00, 20:00, 30:00,
40:00, 50:00
15x The following moments of every hour: 00:00, 15:00, 30:00, 45:00
30x The following moments of every hour: 00:00, 30:00
60x Every hour on the hour
Timed (sub- The data logger samples data periodically at a rate specified in the Interval field.
second) You can select an interval between 0.1 second and 0.9 second for the Interval
field. For example, if you want the data logger to sample data every 0.5 second,
select 0.5 for the Interval field.
The sub-second sampling requires high data acquisition performance. As there
are many factors that can affect the performance, it is not guaranteed that the
specified sampling rate can be attained.
Load from The data logger does not sample data. It receives the data loaded from an LDF
.LDF File file.
Sample Full Stop Sampling Check the option if you want the data logger to stop sampling data when the
Processing logging buffer is full.
Notify Check the option if you want the data logger to set the bit specified in the Bit field
to On when the number of collected samples exceeds the limit specified in the Full
Limit field.
Bit Available when the Notify field is checked. Specifies the bit for the sample full
notification. Click to enter an address for this field. Click to select a tag for
this field.
Full Limit Available when the Notify field is checked. Select a percentage as the full limit.
When the ratio of collected samples to the maximum samples specified in the
Number of Samples field exceeds the percentage, the data logger sets the bit
specified in the Bit field to On.
External Clear Buffer Check this option so the data logger can be controlled to clear its logging buffer by
Control the trigger bit specified in the Trigger Bit field.
Trigger Bit Available when the Clear Buffer option is checked. Select a trigger bit that will
control the data logger to clear its logging buffer. The data logger clears its logging
buffer when the trigger bit changes from Off to On.
Enable Check this option so the data logger can be enabled and disabled by the enabling
Property Description
Save Data Save Data to Check this option so the data logger will write the newly collected data to a
to File File specified file periodically. Each time when the data logger performs this operation,
it writes only the data that are not saved to a file before.
File Type The type of file to save the logged data.
File Type Description
.CSV/.TXT The logged data are saved in CSV or text format. You can use any
text editor to view the logged data. Most importantly you can use
Microsoft Excel to import the logged data from such files directly.
.LDF The logged data are saved in a binary format than can only be
used by a data logger that has exactly the same data definition.
This file type allows you to view and operate historic data loaded
from files.
Operation Specifies how to open a file to save the logged data.
Type Operation Type Description
Create Creates a new file with the specified filename to save the
logged data.
Append or If the specified file exists, appends the logged data to that
Create file; otherwise creates a new file with the specified filename
to save the logged data.
Time to Save Specifies the period to save the logged data. There are nine kinds of period
available:
Available Period
Every hour on the hour
Every 8 hours (00:00, 08:00,
16:00)
Every 12 hours (00:00, 12:00)
Every day at 00:00
Every day at 08:00
Every day at 12:00
Every Sunday at 00:00
Every Monday at 00:00
Every month's first day at 00:00
Filename The filename or the prefix of the filename of the file to save the logged data. The
extension name must be "txt" when the File Type is ".TXT". The extension name
must be "ldf" when the File Type is ".LDF".
Property Description
Display Type The display type for the value of the data item. The following table shows the available
display types for each data type.
Data Type Available Display Types
16-Bit Unsigned Integer 16-Bit Unsigned Decimal, 16-Bit Hexadecimal, 16-Bit Octal
32-Bit Unsigned Integer 32-Bit Unsigned Decimal, 32-Bit Hexadecimal, 32-Bit Octal
16-Bit Signed Integer 16-Bit Signed Decimal
32-Bit Signed Integer 32-Bit Signed Decimal
16-Bit BCD 16-Bit Unsigned Decimal
32-Bit BCD 32-Bit Unsigned Decimal
32-Bit Floating Point 32-Bit Floating Point
ASCII String ASCII String
Unicode String Unicode String
Total Digits Specifies the number of digits to be displayed for the value of the data item.
Fractional Digits Specifies how to display the fractional part for the value of the data item. When the Display
Type is 32-bit Floating Point, this property specifies the number of fractional digits to be
displayed. When the Display Type is not 32-bit Floating Point, this property specifies not only
the number of fractional digits to be displayed but also the number of least significant digits
to be displayed as the fractional part. With this feature, an integer can be shown as a fixed
point number.
Example:
Display Type Total Fractional Sampled Displayed
Digits Digits Value Value
32-bit Floating Point 4 2 12.34 12.34
32-bit Floating Point 4 2 123.4 23.40
16-bit Signed Decimal 5 2 12345 123.45
16-bit Signed Decimal 5 2 -5 -0.05
Scaling Check this option if you want the value of the data item to be displayed in a scaled manner.
The following is the scaling formula:
DisplayedValue = SampledValue * Gain + Offset
Note: The Gain and Offset are 32-bit floating point numbers. They have at most 6 significant
digits. The rounding and truncation errors may happen.
Gain Available when the Scaling option is checked. Specifies the Gain used in the scaling formula.
There are three ways to write the logged data of a data logger to an LDF file:
1) You can use a function button to perform “Copy Logged Data To .LDF File”. The button writes all the logged data
of the specified data logged to an LDF file.
2) You can use the Command Block to request this operation.
3) You can configure a data logger to write its collected data to an LDF file automatically with preset time interval.
To view the logged data of an LDF file, you need to load the data of that LDF file into a data logger first. A data logger
is able to receive the data from an LDF file only when:
1) The definitions of the data items of the LDF file and the data logger are identical, and
2) The number of samples of the LDF file is not greater than the number of samples of the data logger.
The viewing objects for an LDF file should be configured for the data logger that is able to receive the data from that
LDF file.
You can use a historic data table to list the values of the data collected by a data logger.
The above is an example of the historic data table. The first row is the title row. It displays the title of each column.
The other rows display one data record per row. You can create scroll button groups or scroll bars to scroll the
contents. The titles of data columns are the names of data items defined in the Data Item page of the Data Logger
dialog box.
Options Description
Visibility You can show and hide a historic data table by a specified bit or the current user level. Select and
Control set this option in the Visibility page.
12.2.3 Settings
You can set up a historic data table with the Historic Data Table dialog box. There are three ways to open the dialog
box of an object:
1) Double-click the object.
2) Right-click the object to bring up the Object pop-up menu. Select Properties in the pop-up menu.
3) In the Object List window, double-click the row that shows the information of the object.
You can complete all the settings of a historic data table in the Historic Data Table dialog box. This dialog box
contains the following three pages.
■ General
Described in Section 12.2.4.
■ Data Item
Described in Section 12.2.5.
■ Visibility
Described in Section 4.4.6.
eV Manual V1.2a - 17.03.2010
397
Manual
12.2.4 General Settings
This section describes how to define the general settings for a historic data table. The following is an example of the
General page.
There are two data sources you can select for Historic Trend Graphs, Historic
Data Tables, and Single Record Line Charts.
When "Data Logger" is selected as the data source for an object of such
kinds, that object displays the sampled data stored in the logging buffer of the
associated data logger.
When "File" is selected as the data source for an object of such kinds, that
object displays the sampled data stored in the specified file buffer.
One HMI can have up to 16 file buffers and each file buffer is identified by an
unique number between 0 and 15.
You can create a function button to load the sampled data stored in a file.
1) Select "Load Logged Data From File" as the operation of that function
button.
2) Select the file extension type. Both CSV and TXT are supported now.
3) Specify the associated data logger.
4) Specify the file buffer to save the loaded data.
5) Specify the size of the file buffer. The size is the maximum number of
samples that the file buffer can hold.
File Buffer ID Specify the File Buffer ID if the data source is a file. To specify a file buffer ID
for a file, you can use Load Logged Data From File operation of the function
button. Please see Section 5.4 Performing Built-in Function Using Function
Buttons for details.
Title Title Select this option if you want the object to display a title row.
Language Select a language so you can view and edit the settings of the title row for
that language.
Font Select a font for the title text.
Color Select a color for the title text.
Date Specifies the title for the Date column.
Time Specifies the title for the Time column.
Background Color Select a color for the background of the title row.
Grid Vertical Check this option if you want the object to have vertical grids.
Horizontal Check this option if you want the object to have horizontal grids.
Color Select a color for the grids.
Data Font Select a font for displaying data.
Default Color Select a color as the default color for displaying data.
Set Default Color to Click this button to set the colors of all the data items to the Default Color.
All Data Items
Time/Date Date Check this option if you want the object to display the Date column. You need
Display to select a format for displaying the date.
Time Check this option if you want the object to display the Time column. You need
to select a format for displaying the time.
Color Select a color to displaying Time/Date.
Display Relative Check this option if you want the object to display a relative measure of time.
Time
Line Spacing Specifies the extra space in pixels for two adjacent rows in the table.
The following table describes each property in the Data Item page.
Property Description
Language Select a language so you can view and edit the settings for that language.
Row #n Name The name of data item #n. The data item names are defined in the Data Item page of the
of the Data Logger dialog box.
propert Display Check this option if you want the object to display data item #n.
y table
Color Select a color for displaying data item #n.
Alignment The alignment for displaying data item #n. There are three types of alignment: Left,
Center, and Right.
You can use a Historic Trend Graph to display the values of the data collected by a data logger as a trend graph.
Cursor
A historic trend graph can display up to 16 curves. The above is an example of the historic trend graph with two
curves. A historic trend graph can provide a cursor for you to estimate the value in the desired time
12.3.3 Settings
You can set up a historic trend graph with the Historic Trend Graph dialog box. There are three ways to open the
dialog box of an object:
1) Double-click the object.
2) Right-click the object to bring up the Object pop-up menu. Select Properties in the pop-up menu.
3) In the Object List window, double-click the row that shows the information of the object.
The Historic Trend Graph dialog box contains the following four pages:
■ General
eV Manual V1.2a - 17.03.2010
401
Manual
Described in Section 12.3.4.
■ Curve
Described in Section 12.3.5.
■ Axis
Described in Section 12.3.6.
■ Visibility
Described in Section 4.4.6.
Property Description
Data Source Select data logger or file as the source of the collected data.
File Buffer ID Specify the File Buffer ID if the data source is a file. To specify a file buffer ID for a file,
you can use Load Logged Data From File operation of the function button. Please see
Section 5.4 Performing Built-in Function Using Function Buttons for details.
Number of Curves Specifies the number of curves.
Cursor <Check Check this option so the historic trend graph will display a cursor. You can touch and
box> drag the cursor to the data point(s) that you want to select.
Cursor Select a color for the cursor.
Color
Value Select a font for displaying the values of the selected data point(s).
Display
Font
Date Check this option if you want to display date on the left top of the historic trend graph
object. You need to select a format for displaying the date.
The format of how the date is displayed. There are 12 kinds of format available:
dd/mm/yy, mm/dd/yy, yy/mm/dd, dd.mm.yy, mm.dd.yy, yy.mm.dd, dd-mm-yy, mm-dd-
yy, yy-mm-dd, dd-MMM-yy, MMM-dd-yy, and yy-MMM-dd.
Note: dd: 01~31 (day); mm: 01~12 (month); yy: 00~99 (year); MMM: JAN~DEC
(month)
Time Check this option if you want the object to display the Time on the left top corner. You
need to select a format for displaying the time.
Time/Date Select a color to displaying Time/Date.
Color
Dynamic Dynamic When this option is selected, the following three ranges can be specified at runtime:
Range Range The minimum and the maximum for the Y values of each curve
The maximum time duration for X axis
The minimum and maximum of the marks for the Y axis
The data that specifies the above three ranges should be set and arranged correctly in
a memory block called the dynamic range parameter block. You need to specify the
dynamic range parameter block in the Dynamic Range Parameter Block field.
Continued
Property Description
Support Zoom Check this option so zoom option will be supported at the runtime. You may use the
function button to zoom in or zoom out the historic trend graph at the runtime. This
field is available only when the Dynamic Range field is not checked.
Display Relative Time Check this option if you want the object to display a relative measure of time.
Time/Date/Tick Color Select a color for the X axis and its ticks.
Y Axis Number of Major The number of major divisions for the Y axis. The minimum you can specify
Divisions is one.
Number of Sub- The number of divisions between two adjacent major ticks. The minimum
divisions you can specify is one.
Show Ticks Check this option if you want the Y axis to have ticks.
Show X-axis Grid Select this option if you want the Y axis to have horizontal grids.
Grid Color Select a color for the horizontal grids.
Y Axis Show Marks Check this option if you want the major ticks to have marks.
Mark Font The font of the marks.
Dynamic Range Check this option if you want the minimum and maximum of the marks to be
controlled by the dynamic range parameter block of the associated object at
runtime.
Minimum The minimum of the marks. You can specify a 32-bit signed integer.
Maximum The maximum of the marks. You can specify a 32-bit signed integer.
Total Digits The total digits to be displayed for the marks.
Fractional Digits The number of fractional digits for the marks. For example, when the
Maximum is 5000, the Total Digits is 4, and the Fractional Digits is 2, the
mark for the Maximum will be 50.00.
Position Select a position to locate the scale. The scale can be displayed on the left
or on the right or on the both side.
Mark/Tick Color Select a color for the marks and ticks.
You can number the predefined events of your application, use a word in the controller or the target panel to store the
number of the current event at runtime, and have a data logger in the target panel to collect the value of that word.
This is a way to record the events of your application. You can use the historic event table to display the event history.
Each message defined for the historic event table is associated with an event by the message/event number.
In the above example, the historic data table and the historic event table display the same historic data in different
ways.
You can complete all the settings of a historic event table in the Historic Event Table dialog box. This dialog box
contains the following three pages.
■ General
Described in Section 12.4.4.
■ Message
Described in Section 12.4.5.
■ Visibility
Described in Section 4.4.6.
Property Description
Title Title Select this option if you want to have a title row.
Language Select a language so you can view and edit the settings of the title row for that
language.
Font Select a font for the title text.
Color Select a color for the text.
Date Specifies the title for the Date column.
Time Specifies the title for the Time column.
Message Specifies the title for the Message column.
Background Select a color for the background of the title row.
Color
Grid Vertical Check this option if you want the object to display vertical grids.
Horizontal Check this option if you want the object to display horizontal grids.
Color Select a color for the grids.
Message Font Select a font for displaying messages.
Default Select a color as the default message color.
Color
Set Default Click this button to set the colors of all the messages to the Default Color.
Color To All
Messages
Date/Time Date Check this option if you want the object to display the Date column. You need to
Display select a format for displaying the date.
Time Check this option if you want the object to display the Time column. You need to
select a format for displaying the time.
Line Spacing Specifies the extra space in pixels for two adjacent rows in the table.
You can use a single record line chart to display the values of the data collected by a data logger as a line chart.
Cursor
Reference line
Connected line
A single record line chart can display up to 255 data points. The above is an example of the single record line chart
with 8 data points. A single record line chart can provide a cursor for you to estimate the value in the desired pointer.
12.5.3 Settings
You can set up a single record line chart with the Single Record Line Chart dialog box. There are three ways to open
the dialog box of an object:
1) Double-click the object.
2) Right-click the object to bring up the Object pop-up menu. Select Properties in the pop-up menu.
3) In the Object List window, double-click the row that displays the information of the object.
The Single Record Line Chart dialog box contains the following four pages:
■ General
Described in Section 12.5.2.
■ Pen
Described in Section 12.5.3.
■ Axis
Described in Section 12.5.4.
■ Visibility
Described in Section 4.3.6.
The selection is valid when the Show Cursor option in the General page is selected.
Reference Min. The minimum of the associated data set. This property is available when the Dynamic
Data Pen Range option is not selected.
Max. The maximum of the associated data set. This property is available when the Dynamic
Range option is not selected.
Mark Size Select a size for the data point mark. The selection is valid when the Show Mark option
in the General page is selected.
Line Style Select a style for the connecting lines. The selection is valid when the Show Line option
in the General page is selected.
Color Select a color for the connecting lines.
Show Value Select one of the following methods for displaying the selected data point value.
Show Value Description
(None) Does not display the data point value.
Original Displays the data point value without modification.
Scaled Displays the corresponding Y axis value of the data point.
The selection is valid when the Show Cursor option in the General page is selected.
Line segment color Check this option to set the line segment color individually in the following list window.
selectable individually The list window has three columns. The first column is line segment number. The second
column is color setting for the data line. The third column is the color setting for reference
line.
13 Operation Logging
This chapter describes how to set up the operation logging and configure the operation log display to show the
operation loggers.
EV Designer also lets user clear the operation logging buffer by the function button. To know how to define a function
button to clear the operation history, please see Section 5.4.1 Basic Operations of function buttons.
You can set up the operation logging with the Operation Logging dialog box. In this dialog, you can determine the
required memory for operation logging buffer, specify how to save the operation logs to a text file. To open the dialog
box, please double click the node named Operation Logging in the EV Designer’s Project Manager tool window or use
Operation Logging… command on the Panel menu. The following is an example of the Operation logging dialog box.
The table below describes each property in the Operation Logging Properties dialog.
Property Description
Enable <Check Box> Check this option to enable the operation logging.
operatio Buffer Size The size of operation logging buffer. The unit is K words. The buffer size can
n logging be specified between 1 and 512 K words.
Approximate The maximum number of operation loggers that the operation logging buffer
number of can hold. The formula to calculate the approximate number is: Number =
operations can be Buffer Size * 1024 * 2 / 64
logged
Save <Check Box> Check this option so the newly operation loggers will be written to a specified
Data to file periodically. Each time when performing the saving, the panel writes only
File the operation loggers that are not saved to a file before.
File Name The filename or the prefix of the filename of the file to save the operation
loggers. The operation loggers are saved in text format and the file extension
name must be “.txt”. You can use any text editor and Microsoft Excel to view
the operation loggers directly. This item is available when the option Save
Data to File is checked.
Time to Save Specifies the period to save the operation loggers. This item is available when
the option Save Data to File is checked. There are nine kinds of period
available: Every hour on the hour ; Every 8 hours (00:00, 08:00, 16:00) ;
Every 12 hours (00:00, 12:00) Every day at 00:00; Every day at 08:00; Every
day at 12:00; Every Sunday at 00:00; Every Monday at 00:00; Every month's
first day at 00:00.
The above is an example of the operation log display. The first row is the title row. It displays the title of each column.
The other rows display one operation per row. You can create scroll button groups or scroll bars to scroll the
contents. An operation log display can have three columns. The following table describes the content of each column
for an operation log display.
Column Description
Date The date when the record is created. This column is optional.
Time The time when the record is created. This column is optional.
Message The message of the associated operation. This column is optional.
The text color and font of a row is determined by the settings in the General Page.
Options Description
Visibility You can show and hide an operation log display by a specified bit or the current user level. Select
Control and set this option in the Visibility page.
13.3.3 Settings
You can complete all the settings of an operation log display in the Operation Log Display dialog box. This dialog box
contains the following two pages.
■ General
Described in Section 13.3.3.
■ Visibility
Described in Section 4.4.6.
14 Using Macros
This chapter explains how you can write macros to perform operations on the PM. A macro contains a sequence of
macro commands and acts as a simple computer program when it is run by the PM. With macros, some tasks such as
scheduling, data exchanges, conditional operations, and sequential operations that are hard to be performed by the
objects can be easily achieved.
Note: Do not use macros to control systems that can cause life-threatening and serious injury.
Note: The real-time OS in PM (HMI) needs to manage multiple tasks at the same time when the application is
running. In order not to affect the whole performance, please keep the macro as short as possible.
Note: The macros execute individually and are unaware of the other macros. When sharing common variables
between macros, your application might have possible conflicts. Consider an application where the cycle macro
updates the value of an address which is used by the event macro. If the event macro alters the address value
before the cycle macro uses that address, the result of the cycle macro will be incorrect.
■ Global Macro
A global macro is a macro that can be used by all panel applications in the same project. With global macros, the
panel applications in the same projects can share the common functions without having to keep and maintain the
same set of macros locally.
You can set up a password in Project Information & Protection dialog box to protect the global macros. If the global
macros are under protection, you need to enter password to get off the protection before using them in your
application.
Note that only internal variables can be used in global macros.
■ Local Macro
A local macro is a macro that can be only used by the panel application which the macro is located in.
■ Sub-macro
A sub-macro is a macro that other macros can run it by using CALL command. When the PM encounters a CALL
command while running a macro, it stops running that macro and starts to run the called sub-macro. The last
command of a sub-macro must be a RET command which terminates the sub-macro and returns the control to the
calling macro. You can also place RET commands at any locations as you want. The PM will resume the execution of
the calling macro starting from the command following the CALL command when the called sub-macro terminates and
returns.
By implementing common functions in sub-macros for other macros to use, your macros can be modularized,
sharable, easy to read, and easy to maintain.
■ Startup Macro, Main Macro, Event Macro, Time Macro for the application
■ Open Macro, Cycle Macro, Close Macro for the screen
■ On Macro, Off Macro, Object Macro for the object
Select the macro that works best for the occasion you want the macro to run, and for the purpose you want the macro
to do.
Run the Macro: Use:
When the application starts Startup Macro
This macro is run only once when the application starts. The PM will not display the
start-up screen until the macro terminates. You can use Startup Macro to initialize
global data and settings for your application. Specify Startup Macro in Panel
General Setup dialog box.
When importing a file as the macro, the file name will be the macro name as default.
In each panel application, the local macro name has to be unique, but a local macro name can be the same as a
global macro name.
Note: You can only select one macro to delete at one time. If the macro you want to delete is used by the application
or the object, you will be asked to confirm the deleting operation.
Property Description
Macro Name Select an existing local macros or global macros from the drop-down list. The following is a
sample in the dropdown list
Local Macros
New… Click the button to bring out the New Macro dialog box to create a new and blank local
macro.
Continued
Click anywhere on
the window frame to
drag out the window.
Properties A floating dialog allows you specify the macro command. For details, see Section 14.3.2.
The macro command properties dialog can be moved to anywhere and resized to any size
you want. But it can’t be closed until the dialog is closed.
In EV Designer, all the macros can be written in the macro development environment that is composed of two
elements: Macro Editor Window and Macro Command Properties Tool Window.
You will see the following sample of the Macro Development Environment when opening a macro from Project
Manager,
Macro Command
Macro Editor Window
Properties Tool
■ Editing Macro
With the macro editor, you can cut, copy, and paste selected text using menu commands, key combination or drag-
and-drop operations. You can also undo and redo selected editing actions.
You can right-click to display a popup menu of editing commands. The editing commands available depend on what
the pointer is pointing to.
Comments are notes to be ignored when running the macro commands. Macro supports both single-line comments
and block comments. Single-line comments begin with two forward slashes (//) and run to the end of the line.
The following is an example of a macro command followed by a single-line comment.
IF $U0.0 (B) // Key Down
Block comments begin with an opening delimiter (/*) and run to a closing delimiter (*/). Comments do not nest.
The following is an example of a block comment.
/* $N1001=WH2021
$N1010=$N1001 */
To specify a hexadecimal number, use either the h or H suffix. For example, 12abH and 3ABh are valid hexadecimal
numbers. You can also use either the “0x” or “0X” prefix. For example, 0x1278abc and 0XFFFF0000 are valid
hexadecimal numbers.
To specify a binary number, use either b or B suffix. For example, 001100111b and 11110000B are valid binary
numbers.
For decimal numbers, in most cases, you just type the numbers as they are to specify the constants. However, the
ambiguity exists when a constant is the same as a valid external variable. For example, if a panel application has a
link to a Modicon ModBus slave device, it is impossible to tell whether the number 40001 is a constant or a word
address of the controller. To avoid this kind of ambiguity, use the following methods to explicitly declare that a number
is a constant:
1) Use K, k, D, or d suffix for an integer number. For example, -123K and -123d are valid specifications of constant -
123.
2) Use either the f or F suffix for a decimal number with decimal point. For example, -12.3F and -12.3f are valid
specifications of constant -12.3.
The Macro Command Properties Tool Window help you add and modify a macro command quickly and easily.
If you open a macro from Project Manager or Menu Item, the Macro Properties Tool Window will be opened as a
docking window. You can easily configure the dockable tool window to show or hide automatically or tab link with
other tool windows or dock against the edges, or float over. When the Macro Editor is opened, you can also choose to
open or close the Macro Command Properties Tool Window by clicking the [Macro Command Properties] menu item
under [View] menu.
If you open the macro from object's configuration dialog box, the Macro Properties Tool Window will float besides the
Macro Editor and it can be moved to anywhere but can't be closed.
The following table describes each property in the macro command properties tool window.
Property Description
Command Clicks the dropdown list box to bring up the macro command selection dialog, In the
dialog, navigates the keyword of macro commands through tabs and sections by moving
the mouse and then clicks the selection. The format of the selected macro command will
be shown in the dropdown list after the dialog is closed. To cancel the operation, click
anywhere outside the macro command selection dialog.
Data Type Selects the data type for the macro command from the dropdown list. Different macro
command supports different data types. The supported data types for each macro
command are some of the followings: (S) 16-bit Signed, (U) 16-bit Unsigned, (SD) 32-bit
Signed, (UD) 32-bit Unsigned, (F) 32-bit Floating Point, (B) Bit.
Parameter <Edit Specifies the bit variable when the Data Type is (B).
Box> Specifies the word variable when the Data Type is (U)/(S).
Specifies the double-word variable when the Data Type is (UD)/(SD)/(F).
Clicks this icon to bring up the Address Input Keypad and specify the desired address for
the Variable field.
Clicks this icon to bring up the Select Tag dialog box and select the desired tag for the
Variable field.
Macro Command Help Shows the operation, parameter type of the selected macro command.
Note that any modification in the dialog will change the current macro command in the Macro Editor.
■ Notations
3) U, S, UD, SD, F, B: Used for indicating the types of data a macro command can support.
Abbreviation Data Type
U 16-bit Unsigned Integer
S 16-bit Signed Integer
UD 32-bit Unsigned Integer
SD 32-bit Signed Integer
F 32-bit Floating Point
B Bit
■ Terminology
Terminology Definition
Internal memory The memory space in the PM that can be accessed by the panel application. For example,
the user memory $U, the non-volatile memory $N, the system memory $S, and the recipe
memory $R are all parts of the internal memory.
Internal variable An address or a tag referring to an address of a space in the internal memory.
Internal bit variable An internal variable that refers to a bit in the internal memory.
For easy to read, we usually use “internal variable” instead of “internal bit variable” when
referring to a bit if there is no ambiguity.
Internal word variable An internal variable that refers to a word in the internal memory.
The variables can also be used to refer to a double-word, a block of bytes (byte array), a
block of words (word array), and a block of double-words (double-word array).
For easy to read, we usually use “internal variable” instead of “internal word variable” when
referring to a word or a block of memory space if there is no ambiguity,
External memory The memory spaces or the collections of addressable devices in the controllers that can be
accessed by the panel application through communication links.
Continued
eV Manual V1.2a - 17.03.2010
433
Manual
Terminology Definition
External variable An address or a tag referring to an address of a space in the external memory.
External bit variable An external variable that refers to a bit in the external memory.
For easy to read, we usually use “external variable” instead of “external bit variable” when
referring to a bit if there is no ambiguity.
External word An external variable that refers to a word in the external memory.
variable The variables can also be used to refer to a double-word, a block of bytes (byte array), a
block of words (word array), and a block of double-words (double-word array) if the access
unit of the associated addresses is word. If the access unit is double-word, you can only use
the variable to refer to a double-word or a block of memory space with a length of a multiple
of 4 (bytes).
For easy to read, we usually use “external variable” instead of “external word variable” when
referring to a word or a block of memory space if there is no ambiguity,
Expression
Type Abbreviation Description
Arithmetic AE Sequences of operators and parameters that
Expression are used for computing a value from the
parameters.
Comparison CE Sequences of operators and parameters that
Expression are used for comparing value from the
parameters.
EV Designer provides the following types of operators for macro expressions:
Operators Name or Meaning Grouping Used for
() Parentheses Left to right AE/CE
* Multiplication Left to right AE
/ Division Left to right
% Modulus Left to right
+ Addition Left to right
- Subtraction Left to right
<< Left shift Left to right
>> Right shift Left to right
< Less than Left to right CE
> Greater than Left to right
<= Less than or equal to Left to right
>= Greater than or equal to Left to right
== Equality Left to right
!= Inequality Left to right
& Bitwise AND Left to right AE
^ Bitwise exclusive OR Left to right
| Bitwise inclusive OR Left to right
&& Logical AND Left to right CE
|| Logical OR Left to right CE
= Assignment Right to left AE/CE
Note: The above table lists the operators in order of precedence (from highest to lowest
precedence). Operators in the same segment of the table have equal precedence and are
evaluated in the given order in an expression unless explicitly forced by parentheses.
14.4.2.1 Assignment ( = )
Format P1 = P2 Data Type U/S/UD/SD/F/B
Function Assigns the value of P2 to P1.
P1 (I/E) The destination.
P2 (I/E/C/AE) The source.
Example 1 $U2 = 123.45 (F) /* Assign 123.45 to $U2 (and $U3) */
Example 2 $U100.f = 1 (B) /* Turn on the specified bit */
Example 3 W60 = ($U30 + $W50 - 1000) / 2 (SD) /* Write the result of the arithmetic expression to W60. */
Example 4 V0.0 = 2\M0 (B) /* Assign the bit value of M0 of link 2 to the bit V0.0 of link 1*/
14.4.2.3 ""
Format P1 = "P2"
Function Copies the quoted ASCII character string P2 to P1. Note that the string is a null terminated
string. If the length of the string is N then N+1 bytes will be copied to P1 and the last byte is 0.
P1 (I) The location to save the result.
P2 (A) The quoted ASCII character string.
Example 1 $U60 = "TEST" /* The null character (00h) will be moved to the low byte of $U62 */
Example 2 $U20 = "ABCDE" /* The null character (00h) will be moved to the high byte of $U22 */
14.4.2.4 MOV
Format P1 = MOV(P2,P3) Data Type U
Function Copies P3 words of P2 to P1.
P1 (I/E) The starting location of the memory to receive the copy.
P2 (I/E) The starting location of the memory to be copied.
P3 (I/C) The number of words to be copied.
Example 1 $U100 = MOV($U200, 16) /* Copy the 16 words starting from $U200 to $U100 */
Example 2 W60 = MOV($U200, $U2) /* Copy the word array starting from $U200 with the size specified in
$U2 to W60.*/
Example 3 $U10 = MOV(2\D100,10) /* Copy D100 ~ D109 of link 2 to $U10 ~ $U19.*/
14.4.3.1 Addition ( + )
Format P1 = P2 + P3 Data Type U/S/UD/SD/F
Function Adds P2 and P3 and saves the result in P1.
P1 (I/E) The location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U100 = $U101 + $U102 (U)
Example 2 W100 = 0.3*$U0 + 0.1*$U2 + 0.6*$U4 (F)
14.4.3.2 Subtraction ( - )
Format P1 = P2 - P3 Data Type U/S/UD/SD/F
Function Subtracts P3 from P2 and saves the result in P1.
P1 (I/E) The location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U100 = $U101 - $U102 (U)
Example 2 W100 = 0.3*$U0 - 10.75 (F)
14.4.3.3 Multiplication ( * )
Format P1 = P2 * P3 Data Type U/S/UD/SD/F
Function Multiplies P2 by P3 and saves the product in P1.
P1 (I/E) The location to save the product. If the product is overflow, the higher bits exceeding the limit will
be truncated and the remaining bits will be stored in P1.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U100 = $U102 * 0x192
Example 2 W100 = ($U0 + $U2) * ($U4 + $U6) (F)
14.4.3.5 Modulus ( % )
Format P1 = P2 % P3 Data Type U/S/UD/SD
Function Divides P2 by P3 and saves the remainder in P1.
P1 (I/E) The location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U100 = $U30 % 16(U)
Example 2 W100 = $U200 % ($U402 + $U106) (SD)
14.4.5 Calculation
14.4.5.1 MAX
Format P1 = MAX(P2,P3) Data Type U/S/UD/SD/F
Function Sets P1 to the larger value of P2 and P3.
P1 (I/E) The location to save the result.
P2,P3(I/E/C) The operands.
Example 1 $U100 = MAX(100, 200) /* Set $U100 to 200 */
14.4.5.2 MIN
Format P1 = MIN(P2,P3) Data Type U/S/UD/SD/F
Function Sets P1 to the smaller value of P2 and P3.
P1 (I/E) The location to save the result.
P2,P3(I/E/C) The operands.
Example 1 $U100 = MIN(100, 200) /* Set $U100 to 100 */
14.4.5.3 BMAX
Format P1 = BMAX(P2,P3) Data Type U/S/UD/SD/F
Function Finds the maximum in an array starting from P2 with P3 elements and saves the result in P1.
P1 (I) The location to save the result.
P2 (I) The starting location of the array.
P3 (I/C) The size of the array.
Example 1 $U100 = BMAX($U200, 16) (F) /* Find the maximum among 16 floating point numbers starting
from $U200 and save the result in $U100 */
14.4.5.4 BMIN
Format P1 = BMIN(P2,P3) Data Type U/S/UD/SD/F
Function Finds the minimum in an array starting from P2 with P3 elements and saves the result in P1.
P1 (I) The location to save the result.
P2 (I) The starting location of the array.
P3 (I/C) The size of the array.
Example 1 $U100 = BMIN($U200, 60) (F) /* Find the minimum among 60 floating point numbers starting
from $U200 and save the result in $U100 */
14.4.5.5 SUM
Format P1 = SUM(P2,P3) Data Type U/S/UD/SD/F
Function Calculates the sum of the value in an array starting from P2 with P3 elements and saves the
result in P1.
P1 (I) The location to save the result.
P2 (I) The starting location of the array.
P3 (I/C) The size of the array.
Example 1 $U100 = SUM($U200, 16) (F) /* Calculate the sum of 16 floating point numbers starting from
$U200 and save the result in $U100 */
14.4.5.6 XSUM
Format P1 = XSUM(P2,P3) Data Type U/UD
Function Calculates one element XOR (Bitwise Exclusive OR) sum of all the P3 elements in an array
starting from P2 and saves the result in P1.
P1 (I) The location to save the result.
P2 (I) The starting location of the array.
P3 (I/C) The size of the array.
Example 1 $U100 = XSUM($U200, 5) (UD) /* Perform XOR sum of 5 32-bit unsigned numbers starting from
$U200 and save the result in $U100. Another expression of XOR sum is $U100 = $U200 ^
$U202 ^ $U204 ^ $U206 ^ $U208 (UD) */
$U100 =1001B
$U101 =1100B
$U102 =0110B
$U120 = XSUM($U100,3) /* $U120=0011B */
14.4.5.7 SWAP
Format SWAP(P1,P2) Data Type U
Function Swaps the low byte and high byte of every word in a word array starting from P1 with P2 words.
P1 (I) The starting location of the array.
P2 (I/C) The size of the array.
Example 1 $U120=1111111100000000B
$U121=1000000100000000B
SWAP($U120, 2) /* The value of $U120 will be 0000000011111111B, The value of $U121 will
be 000000010000001B */
14.4.6.1 BCD
Format P1 = BCD(P2) Data Type U/UD
Function Converts binary number P2 to a BCD number and saves the result in P1.
P1 (I/E) The location to save the result.
P2 (I/E/C) The binary number to be converted.
Example 1 $U100 = BCD(0x1234) (U) /* The value of $U100 will be 1234. */
14.4.6.2 BIN
Format P1 = BIN(P2) Data Type U/UD
Function Converts BCD number P2 to a binary number and saves the result in P1.
P1 (I/E) The location to save the result.
P2 (I/E/C) The BCD number to be converted.
Example 1 $U100 = BIN(1234) (U) /* The value of $U100 will be 0x1234. */
14.4.6.3 DW
Format P1 = DW(P2) Data Type U/S
Function Converts 16-bit number P2 to a 32-bit number and saves the result in P1.
P1 (I/E) The location to save the result.
P2 (I/E/C) The 16-bit number to be converted.
Example 1 $U100 = DW(12345) (S) /* The value of $U100 will be 12345 and the value of $U101 will be 0. */
Example 2 $U200 = DW(-12345) (S) /* The value of $U200 will be -12345 and the value of $U201 will be
0xFFFF. */
14.4.6.4 W
Format P1 = W(P2) Data Type UD/SD
Function Converts 32-bit number P2 to a 16-bit number and saves the result in P1. The truncation error
may occur.
P1 (I/E) The location to save the result.
P2 (I/E/C) The 32-bit number to be converted.
Example 1 $U100 = W(0x12345678) (UD) /* The value of $U100 will be 0x5678 */
Example 2 $U200 = W(-12345) (SD) /* The value of $U200 will be -12345 */
14.4.6.6 W2B
Format P1 = W2B(P2,P3) Data Type U
Function Converts a word array P2 with P3 elements to a byte array and saves the result in the byte array
P1. The conversion discards the high byte of every element of the word array to form a byte
array with the same number of elements. The array size can not exceed 256.
P1 (I) The location (or the word array) to save the result.
P2 (I) The word array to be converted.
P3 (I/C) The size of the word array.
Example 1 $U200 = 0x45FA
$U201 = 0xEB29
$U202 = 0xC781
$U100 = W2B($U200, 3) /* Convert 3 words starting from $U200 to 3 bytes starting from
$U100, $U100 will be 0x29FA and the low byte of $U101 will be 0x81*/
14.4.6.7 A2X
Format P1 = A2X(P2) Data Type U
Function Converts a 4-digit hex number in ASCII character form to a binary number and saves the result
in P1. The character of the fourth digit is in the first word of the word array P2 and the characters
of the other digits are in the following words in sequence.
P1 (I) The location to save the result.
P2 (I) The word array that contains the characters to be converted.
Example 1 $U20 = 49 // '1'
$U21 = 50 // '2'
$U22 = 69 // 'E'
$U23 = 70 // 'F'
$U100 = A2X($U20) /* The value of $U100 will be 0x12EF. */
14.4.6.9 W2F
Format P1 = W2F(P2) Data Type U/S
Function Converts 16-bit number P2 to a floating point number and saves the result in P1.
P1 (I/E) The location to save the result.
P2 (I/E/C) The 16-bit number to be converted.
Example 1 $U200 = W2F($U10) (S)
14.4.6.10 D2F
Format P1 = D2F(P2) Data Type UD/SD
Function Converts 32-bit number P2 to a floating point number and saves the result in P1.
P1 (I/E) The location to save the result.
P2 (I/E/C) The 32-bit number to be converted.
Example 1 $U200 = D2F($U10) (SD)
14.4.6.11 F2W
Format P1 = F2W(P2) Data Type F
Function Converts floating point number P2 to a 16-bit number and saves the result in P1.
P1 (I/E) The location to save the result.
P2 (I/E/C) The floating point number to be converted.
Example 1 $U200 = F2W($U10) (F)
14.4.6.12 F2D
Format P1 = F2D(P2) Data Type F
Function Converts floating point number P2 to a 32-bit number and saves the result in P1.
P1 (I/E) The location to save the result.
P2 (I/E/C) The floating point number to be converted.
Example 1 $U200 = F2D($U10) (F)
14.4.7.1 IF ==
Format IF P2 == P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this IF command when P2 is equal to
P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.2 IF !=
Format IF P2 != P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this IF command when P2 is not equal
to P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.3 IF >
Format IF P2 > P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this IF command when P2 is greater
than P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.4 IF >=
Format IF P2 >= P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this IF command when P2 is greater
than or equal to P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.5 IF <
Format IF P2 < P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this IF command when P2 is less than
P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.6 IF <=
Format IF P2 <= P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this IF command when P2 is less than
or equal to P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.7 IF &
Format IF P2 & P3 Data Type U/UD
Function Executes the commands in the command block following this IF command when the result of
Bitwise AND between P2 and P3 is non-zero.
P2,P3 (I/E/C/AE) The operands.
14.4.7.8 IF !&
Format IF !(P2 & P3) Data Type U/UD
Function Executes the commands in the command block following this IF command when the result of
Bitwise AND between P2 and P3 is zero.
P2,P3 (I/E/C/AE) The operands.
14.4.7.9 IF <bit>
Format IF P2 Data Type B
Function Executes the commands in the command block following this IF command if the condition P2 is
true (1/On).
P2 (I/E/CE) The condition.
14.4.7.10 IF !<bit>
Format IF !P2 Data Type B
Function Executes the commands in the command block following this IF command if the condition P2 is
false (0/Off).
P2 (I/E/CE) The condition.
14.4.7.11 ELIF ==
Format ELIF P2 == P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this ELIF command when P2 is equal
to P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.12 ELIF !=
Format ELIF P2 != P3 Data Type U/S/UD/SD/F
Function Executes the commands in the command block following this ELIF command when P2 is not
equal to P3.
P2,P3 (I/E/C/AE) The operands.
14.4.7.21 ELSE
Format ELSE
Function This command specifies the begin of the default command block that will be executed if none of
the conditions in the preceding IF and/or ELIF commands is true. This is not an executable
command.
14.4.7.22 ENDIF
Format ENDIF
Function This command specifies the end of a command block, which begins at the command following
the matching IF, ELIF, or ELSE command. This is not an executable command.
Example IF-Command Structures:
Commands and
Description
Structures
IF <condition> Runs the command block between IF and ENDIF when the
… condition is true, otherwise ignores the command block.
ENDIF
IF <condition> Runs the command block between IF and ELSE when the
… condition is true, otherwise runs the command block between
ELSE ELSE and ENDIF.
…
ENDIF
IF <condition> Runs the command block between IF and the first ELIF and
… ignores all the following commands in the structure when
ELIF <condition_2> condition 1 is true, otherwise examines condition 2. Runs the
… command block between the first ELIF and the second ELIF and
ELIF <condition_3> ignores all the following commands in the structure when
. condition 2 is true, otherwise checks condition 3. Repeats the
. same operation until condition N is processed. If none of the
. conditions are true, no command block in this structure is run.
ELIF <condition_N>
…
ENDIF
IF <condition> Runs the command block between IF and the first ELIF and
… ignores all the following commands in the structure when
ELIF <condition_2> condition 1 is true, otherwise examines condition 2. Runs the
… commands block between the first ELIF and the second ELIF
ELIF <condition_3> and ignores all the following commands in the structure when
. condition 2 is true, otherwise checks condition 3. Repeats the
. same operation until condition N is processed. Runs the
ELIF <condition_N> command block between ELSE and ENDIF if none of the
… conditions are true.
ELSE
…
ENDIF
Note that there can be up to 20 nested IF-command structures.
14.4.8.1 JMP
Format JMP P1
Function Unconditionally jumps to the program point specified by label P1.
P1 (CS) The label of the program point.
Example 1 IF $U10 == 0
JMP SKIP /* Skip the command "$U20 = $U10 / 2". */
ENDIF
$U20 = $U10 / 2
SKIP:
$U10 = 1
14.4.8.2 <label>
Format P1:
Function This is not an executable command. The P1 is the label of the program point where it is
positioned.
P1 (CS) The character string as the label of the program point. Remember to have the character ':' after
the label.
Example 1 IF $U10 == 0
JMP SKIP /* Skip the command "$U20 = $U10 / 2" */
ENDIF
$U20 = $U10 / 2
SKIP:
$U10 = 1
14.4.8.3 JMP ==
Format JMP(P1,P2 == P3) Data Type U/S/UD/SD/F
Function Jumps to the program point specified by label P1 when P2 is equal to P3.
P1 (CS) The label of the program point.
P2,P3 (I/E/C/AE) The operands.
14.4.8.4 JMP !=
Format JMP(P1,P2 != P3) Data Type U/S/UD/SD/F
Function Jumps to the program point specified by label P1 when P2 is not equal to P3.
P1 (CS) The label of the program point.
P2,P3 (I/E/C/AE) The operands.
14.4.8.13 CALL
Format CALL P1
Function Goes to sub-macro P1.
P1 (Sub-macro The sub-macro to be called.
name)
Example 1 CALL CommonFunction_01 /* Go to sub-macro named CommonFuncation_01 */
14.4.8.14 RET
Format RET
Function Returns to the calling macro. This command can only be used in sub-macros.
14.4.8.15 FOR
Format FOR P2 Data Type U
Function Runs the commands within the FOR loop by P1 times. A FOR loop is enclosed by a matching
pair of FOR and NEXT commands. There can be up to 20 nested FOR loops.
P1 (I/C) Total times to run the FOR loop
Example 1 FOR 10
$U100 = $U100 + 1 /* This command will be executed 10 times */
FOR 12
$U200 = $U200 + 1 /* This command will be executed 120 times */
NEXT
NEXT
14.4.8.16 NEXT
Format NEXT
Function This command indicates the end of a FOR loop. It is not an executable command.
Example 1 Example:
$U1 = 10
$U2 = 12
FOR $U1
$U100 = $U100 + 1 /* This command will be executed 10 times. */
FOR $U2
$U200 = $U200 + 1 /* This command will be executed 120 times. */
NEXT
NEXT
14.4.8.18 END
Format END
Function Indicates the end of macro and stops the macro in the current cycle. It can be put anywhere in a
macro to stop the macro at any point. If the macro is a cyclic macro, such as the Main macro
and the Cycle macros, it is stopped just in the current cycle and will be run again starting from
the first command in the next cycle.
14.4.9.1 SET_T
Format SET_T(P1,P2) Data Type U
Function Starts the timer P1 using the timer control block in P2.
P1 (C) The ID of the timer. There are 8 timers available and the IDs are 0 to 7.
P2 (I) The starting location of the memory block (or word array) that is used as a Timer Control Block for the
timer. The structure of the Timer Control Block is shown below:
Word No. Data Item Description
0 Type of operation 0: One-shot; 1: Square-wave
1 Current timer value The timer increases the value of this word by 1 every
100ms.
2 Timer limit When the current timer value reaches the timer limit, the
timer will perform one of the following operations according
to the type of operation:
1) If the type of operation is One-shot (0), sets the time-up
flag to 1, resets the current timer value to 0, and stops itself.
2) If the type of operation is Square-wave (1), toggles the
time-up flag, resets the current timer value to 0, and
continues the timing operation.
3 Time-up flag This word will be set to 0 or 1 when the current timer value
is equal to the timer limit.
The timer will use the associated Timer Control Block as its private memory, so do not use any words in
the block for other purposes.
A Timer Control Block requires 4 words.
Example 1 $U100 = 1 /* Type of operation is Square-wave. */
$U101 = 0 /* Initialize the current timer value to 0. */
$U102 = 5 /* Timer limit is 0.5 second (5*100ms). */
$U103 = 0 /* Initialize the time-up flag to 0. */
SET_T(3, $U100) /* Use timer #3 to generate a 1 Hz square wave on $U103.0 */
14.4.9.2 STOP_T
Format STOP_T(P1) Data Type U
Function Stops the timer P1.
P1 (C) The ID of the timer.
Example 1 STOP_T(1) /* Stop timer #1 */
14.4.9.3 WAIT_T
Format WAIT_T(P1) Data Type U
Function Waits for the time-up of timer P1. The macro command following this one will not be executed
until the timer reaches its limit.
P1 (C) The ID of the timer.
Example 1 $U100 = 0 /* Type of operation is One-shot. */
$U101 = 0 /* Initialize the current timer value to 0. */
$U102 = 5 /* Timer limit is 0.5 second (5*100ms). */
$U103 = 0 /* Initialize the time-up flag to 0. */
SET_T(7, $U100) /* Starts timer #7 as a 0.5 second timer. */
WAIT_T(7) /* Wait 0.5 second */
14.4.10.1 KB_MCR
Format KB_MCR(P1) Data Type U
Function Accepts or ignores the character/command currently input by the associated keypad button.
This command must be used only in a macro that is run by a keypad button. A keypad button
runs the specified macro when it is pressed. You can use this command in a keypad button
macro to accept or ignore the current input of that button.
P1 (I/C) The value or the location that holds the value to determine the acceptance of the keypad button
input. If the value is 0, the input will be accepted; Otherwise the input will be ignored.
Example 1 KB_MCR(1) /* Ignore the current input */
14.4.10.2 KPD_TEXT
Format KPD_TEXT(P1) Data Type U
Function The memory block (or byte array) that contains the null-terminated ASCII character string to be
used to initialize the keypad display and buffer.
P1 (I) The memory block (or byte array) that contains the null-terminated ASCII character string to be
used to initialize the keypad display and buffer.
Example 1 $U100 = "initial text"
KPD_TEXT($U100) /* Initialize the keypad display and buffer using the string "initial text". */
14.4.11.1 RB2ROM
Format P1 = RB2ROM(P2 ) Data Type U
Function Saves the data of recipe block P2 to the flash ROM and saves the completion code in P1.
P1 (I) The word to receive the completion code. If the completion code is 0, the operation succeeded;
Otherwise the operation failed.
P2 (I/C) The ID of the recipe block to be saved. The option "Need space in flash ROM to save backup"
must be selected for the recipe block.
Example 1 $U10 = RB2ROM(3) /* Save recipe block #3 to the flash ROM. */
14.4.11.2 ROM2RB
Format P1 = ROM2RB(P2 ) Data Type U
Function Restores the data of recipe block P2 from the flash ROM and saves the completion code in P1.
P1 (I) The word to receive the completion code. If the completion code is 0, the operation succeeded;
Otherwise the operation failed.
P2 (I/C) The ID of the recipe block to be restored. The option "Need space in flash ROM to save
backup" must be selected for the recipe block.
Example 1 $U10 = ROM2RB(3) /* Restore recipe block #3 from the flash ROM. */
14.4.11.3 REF_RCP_OBJ
Format REF_RCP_OBJ(P1 ) Data Type U
Function Refreshes the recipe objects associated with the specified recipe block P1. The recipe objects
include recipe selectors and recipe tables. You can use this command to update the display of
associated objects after changing the data of a recipe block in a macro program.
P1 (I/C) The ID of the associated recipe block.
Example 1 REF_RCP_OBJ(3) /* Refresh the recipe objects associated with recipe block #3 */
14.4.12.1 EN_LINK
Format EN_LINK(P1,P2,P3) Data Type U
Function Enables communication link P1 or sub-link P2 of communication link P1 when P3 is 1. Disables
the specified communication link or sub-link when P3 is 0.
P1 (I/C) The number of the communication link to be enabled or disabled.
P2 (I/C) The node address of the sub-link to be enabled or disabled. If the specified communication link
has no sub-link, this parameter is ignored. If the specified communication link has sub-links and
you want to enable or disable the link itself, set this parameter to 0.
P3 (I/C) To enable the specified communication link or sub-link, set this parameter to 1. To disable the
specified communication link or sub-link, set this parameter to 0.
Example 1 ENABLE_LINK(1, 20, 0) /* Disable the sub-link, whose node address is 20, of communication
link 1. */
14.4.12.2 LINK_STS
Format P1 = LINK_STS(P2,P3 ) Data Type U
Function Gets the status of communication link P2 or the sub-link P3 of communication link P2 and saves
the result in P1.
P1 (I/C) The word to receive the status of the specified communication link or sub-link. The status is a
16-bit value. The following table lists the meaning of each status value.
Status Value Meaning Status Value Meaning
0 OK 14 Device busy
1 Overrun error 15 Unknown error
2 Break error 16 Link disabled
3 Parity error 17 Initialization failure
4 Framing error 18 Failed to send data
5 No response 19 Failed to receive data
6 Unrecognized 20 Failed to open connection
response
7 Timeout 21 Connection not ready
8 Inactive CTS 22 Invalid sub-link
9 Checksum error 23 Invalid COM port
10 Command rejected 24 Error
11 Invalid address 255 Condition uncertain
12 Invalid range 65535 Failed to get status
13 Invalid request
14.4.13.1 GET_RTC
Format GET_RTC(P1 ) Data Type U
Function Gets the data of the real time clock and saves the result in P1.
P1 (I) The starting location of the memory block that is used as an RTC data block to receive the
operation result. The structure of the RTC data block is shown below:
Data Item Data Type/Size Word No.
Second 16-bit Unsigned Integer 0
Minute 16-bit Unsigned Integer 1
Hour 16-bit Unsigned Integer 2
RTC adjustment 16-bit Signed Integer 3
Day 16-bit Unsigned Integer 4
Month 16-bit Unsigned Integer 5
Year 16-bit Unsigned Integer 6
Day of week 16-bit Unsigned Integer 7
Second: 0~59; Minute: 0~59; Hour: 0~23; RTC adjustment: -63~63; Day: 1~31; Month: 1~12;
Year: 0(2000)~99(2099); Day of week: 0(Sunday)~6(Saturday)
An RTC data block requires 8 words.
Example 1 GET_RTC($U100) /* Get the data of the real time clock. The second will be in $U100 and the
day-of-week will be in $U107. */
14.4.13.2 SET_RTC
Format SET_RTC(P1 ) Data Type U
Function Sets the real time clock using the data in P1.
P1 (I) The starting location of the memory block that is used as an RTC data block to contain the new
settings for the real time clock. See the description of GET_RTC to know the structure of the
RTC data block.
Example 1 $U100 = 0 // Second
$U101 = 30 // Minute
$U102 = 8 // Hour
$U103 = 0 // Adjustment
$U104 = 1 // Day
$U105 = 7 // July
$U106 = 10 // Year 2010
$U107 = 4 // Thursday
SET_RTC($U100) /* Set the real time clock to 8:30:00 July 1st 2010 Thursday */
14.4.13.3 SYS
Format SYS(P1,P2,P3) Data Type U
Function Requests system service P1 with the arguments P2 and P3. This command is reserved for
system use.
P1 (I) The code of the system service.
P2,P3 (I/C) The arguments of the system service.
14.4.14.1 OPEN_WS
Format OPEN_WS P1 Data Type U
Function The number of the window screen to be opened. This command will not open the specified
screen if it is a normal screen or menu screen. The macro commands following this command
will not be executed until the opened window screen is closed. Also, when a screen's Cycle
macro is waiting for the closing of the window screen opened by this command, that screen can
not be closed or switched by any means.
P1 (I/C) The number of the window screen to be opened. If the screen number indicates to normal
screen or menu screen, no screen will be opened.
14.4.14.2 CLOSE_WS
Format CLOSE_WS
Function Closes the window screen that was opened by the macro command OPEN_WS.
14.4.15.1 FILE_IO
Format P1 = FILE_IO(P2,P3 ) Data Type U
Function Performs the file operation specified by P2 and P3 using default filename and saves the completion code
in P1.
P1 (I) The word to receive the completion code of the operation. If the completion code is 0, the operation
succeeded; otherwise the operation failed.
P2,P3 P2 specifies the type of file operation. P3 specifies the ID of the data source. The following table
(I/C) describes how to set P2 and P3.
File Operation P2 P3 Default Filename Format
Save Logged Data (.txt) 1 Data logger ID DL<ID>_<Date>_<Time>.txt
Save Logged Data (.csv) 14 (0~15) DL<ID>_<Date>_<Time>.csv
Note:
<ID>: ID of the data logger, ID of the recipe block, ID of the USB camera, or number of the screen
<Date>: The date when saving the data. <Time>: The time when saving the data.
You can select the formats of <Date> and <Time> on the Custom page in the General Setup dialog box.
P4 (I) The byte array that contains the specified filename or full pathname. The name must be a valid
Windows pathname with ASCII characters only. The character string must be null terminated
and each character occupies one byte. The maximum length of the string is 127. All the folders
stated in the full pathname must already exist or the file operation will fail.
14.4.15.3 MKDIR
Format P1 = MKDIR(P2 )
Function Creates a new directory with the specified name P2 and saves the result to P1.
P1 (I) The word to receive the completion code of the operation. If the completion code is 0, the
operation succeeded; otherwise the operation failed.
P2 (I) The byte array that contains the name of the new directory. The name must be a valid directory
name with or without pathname and has only ASCII characters in it.
14.4.15.5 READ_FILE
Format P1 = READ_FILE(P2,P3,P4 ) Data Type U
Function Reads P4 bytes from file P2 to buffer P3 and saves the result in P1.
P1 (I) The word to receive the number of bytes that were actually read. If the operation failed, the
number is 65535 (0xFFFF).
P2 (I) The file handle of the file to be read.
P3 (I) The memory block to receive the data read from the file.
P4 (I/C) Number of bytes to be read from the file. The maximum you can specify is 32767(0x7FFF).
Example 1 $U200 = READ_FILE($U100,$U150,20) /* Read 20 bytes from the file specified by the file
handle in $U100 and saves the data in the memory block starting from $U150. */
14.4.15.7 CLOSE_FILE
Format P1 = CLOSE_FILE(P2,P3 ) Data Type U
Function Closes an opened file P2 and saves the completion code in P1.
P1 (I) The word to receive the completion code of the operation. If the completion code is 0, the
operation succeeded; Otherwise the operation failed.
P2 (I) The file handle of the file to be closed.
Example 1 $U200=CLOSE_FILE($U100) /* Close the file specified by the file handle in $U100. */
14.4.15.8 DELETE_FILE
Format P1 = DELETE_FILE(P2 ) Data Type U
Function Deletes a file named P2 and saves the completion code in P1.
P1 (I) The word to receive the completion code of the operation. If the completion code is 0, the
operation succeeded; Otherwise the operation failed.
P2 (I) The byte array that contains the filename or the full pathname of the file to be deleted. The
name is a null-terminated string and has only ASCII characters in it.
Example 1 $U10 = “test.txt”
$U200 = DELETE_FILE($U10) /* Delete the file “test.txt”. */
14.4.15.9 RENAME_FILE
Format P1 = RENAME_FILE(P2,P3 ) Data Type U
Function Renames file P2 with new name P3 and saves the completion code in P1.
P1 (I) The word to receive the completion code of the operation. If the completion code is 0, the
operation succeeded; Otherwise the operation failed.
P2 (I) The byte array that contains the filename or the full pathname of the file to be renamed. The
name is a null-terminated string and has only ASCII characters in it.
P3 (I) The byte array that contains the new filename. The name is a null-terminated string and has
only ASCII characters in it.
Example 1 $U10 = “test.txt”
$U50 = “new.txt”
$U200 = RENAME_FILE($U10, $U50) /* Rename the file “test.txt” to “new.txt”. */
P3 (I) The starting location of the memory block that is used as a Volume Information Block to receive
the operation result. The structure of the Volume Information Block is shown below:
Data Item Data Type/Size Word No.
Volume name Byte array with 32 elements 0 through 15
Volume size 32-bit Unsigned Integer 16 and 17
Free size 32-bit Unsigned Integer 18 and 19
Drive ID 16-bit Unsigned Integer 20
The volume name is a null-terminated character string. The maximum allowable size is 31
characters.
Both the unit of volume size and the unit of free size are 1024 bytes.
A Volume Information Block requires 21 words.
Example 1 $U100 = GET_VOL_INFO(0, $U0) /* Get the volume information of the current drive. The
volume name will be stored in $U0 through $U15. The size of the drive will be stored in $U16
and $U17. The free size of the drive will be stored in $U18 and $U19. The ID of the current
drive will be stored in $U20. */
14.4.16.1 ==
Format P1 = P2 == P3 Data Type U/S/UD/SD/F/B
Function Sets bit P1 to 1 if P2 is equal to P3, otherwise sets P1 to 0.
P1 (I/E) The bit location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U3.3 = ($U10 + $U20) == 25.75 (F)
14.4.16.2 !=
Format P1 = P2 != P3 Data Type U/S/UD/SD/F/B
Function Sets bit P1 to 1 if P2 is not equal to P3, otherwise sets P1 to 0.
P1 (I/E) The bit location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U3.3 = ($U10 + $U20) != -700 (S)
14.4.16.3 >
Format P1 = P2 > P3 Data Type U/S/UD/SD/F
Function Sets bit P1 to 1 if P2 is greater than P3, otherwise sets P1 to 0.
P1 (I/E) The bit location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U3.3 = ($U10 + $U20) > $U30 (UD)
14.4.16.4 >=
Format P1 = P2 >= P3 Data Type U/S/UD/SD/F
Function Sets bit P1 to 1 if P2 is greater than or equal to P3, otherwise sets P1 to 0.
P1 (I/E) The bit location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U3.3 = ($U10 + $U20) >= 25.75 (F)
14.4.16.5 <
Format P1 = P2 < P3 Data Type U/S/UD/SD/F
Function Sets bit P1 to 1 if P2 is less than P3, otherwise sets P1 to 0.
P1 (I/E) The bit location to save the result.
P2,P3 (I/E/C/AE) The operands.
Example 1 $U3.3 = ($U10 + $U20) < 25.75 (F)
14.4.16.6 <=
Format P1 = P2 <= P3 Data Type U/S/UD/SD/F
Function Sets bit P1 to 1 if P2 is less than or equal to P3, otherwise sets P1 to 0.
P1 (I/E) The bit location to save the result.
P2,P3 (I/E/C/AE) The operands.
eV Manual V1.2a - 17.03.2010
462
Manual
Example 1 $U3.3 = ($U10 + $U20) <= 25.75 (F)
14.4.17.1 STRCPY
Format STRCPY(P1, P2 )
Function Copies the string in P2 to P1.
P1 (I) The byte array that receives a copy of the string in P2. The byte array must be large enough to
hold the string and the null terminator.
P2 (I) The source, i.e. the byte array that contains the null-terminated string to be copied.
Example 1 $U10 = “ABCDE”
STRCPY($U20, $U10)
After the command STRCPY is executed, the byte array $U20 contains the string “ABCDE” and
the memory content is like the following:
Word Low Byte High Byte
$U20 'A' 'B'
$U21 'C' 'D'
$U22 'E' 0
14.4.17.2 STRCAT
Format STRCAT(P1, P2 )
Function Appends string in P2 to string in P1.
P1 (I) The byte array that contains a null-terminated string to which the command appends P2. The
byte array must be large enough to hold both strings and the null terminator.
P2 (I) The byte array that contains a null-terminated string to be appended to the string in P1.
Example 1 $U10 = “ABC”
$U20 = “12345”
STRCAT($U10, $U20) /* After this command is executed, the byte array $U10 contains
“ABC12345” */
Example 2 $U100 = “C:\MyFolder\”
$U130 = “Test”
$U140 = “.txt“
STRCAT($U100, $U130)
STRCAT($U100, $U140) /* After this command is executed, the byte array $U100 contains
“C:\MyFolder\Test.txt” */
14.4.17.4 NUM2STR
Format P1 = NUM2STR(P2,P3 ) Data Type U/UD
Function Converts the number in P2 to a string with P3 characters and saves the result in P1.
P1 (I) The byte array that stores the result.
P2 (I/C) The number or the location that holds the number to be converted.
P3 (I/C) Specifies the exact number of characters that the result should have. If the number of digits of P2
is less than P3, the result is padded on the left with zeros. If the number of digits of P2 exceeds
P3, the higher digits are truncated. If P3 is 0, there is no limitation on the length of the result.
Example 1 $U120 = 123
$U100 = NUM2STR($U120, 0) (U) /* After this command is executed, the byte array $U100
contains “123”. */
Example 2 $U120 = 1234567 (UD)
$U100 = NUM2STR($U120, 10) (UD) /* After this command is executed, the byte array $U100
contains “0001234567”. */
Example 3 $U120 = 1234567 (UD)
$U100 = NUM2STR($U120, 5) (UD) /* After this command is executed, the byte array $U100
contains “34567”. */
14.4.17.5 TIME2STR
Format P1 = TIME2STR(P2 ) Data Type U
Function Converts the current system time to a string using the format specified by P2 and saves the
result in P1.
P1 (I) The byte array that stores the result.
P2 (I/C) Specifies the desired conversion format.
Format P2 Value Remark
hhmmss 0 hh: hour(00~23); mm: minute(00~59); ss: second(00~59)
hhmm 1 hh, mm: same as above
Example 1 $U10 = TIME2STR(0) /* Assume that the current system time is 12:30:59. After this command is
executed, the byte array $U10 contains “123059”. */
Example 1 $U10 = DATE2STR(0) /* Assume that the current system date is December 7, 2008. After this
command is executed, the byte array $U10 contains “081207”. */
Example 2 $U20 = DATE2STR(3) /* Assume that the current system date is December 31, 2008. After this
command is executed, the byte array $U20 contains “08DEC”. */
14.4.17.7 TD2STR
Format P1 = TD2STR(P2 ) Data Type U
Function Converts the current system time and date to a string using the format specified by P2 and
saves the result in P1.
P1 (I) The byte array that stores the result.
P2 (I/C) Specifies the desired conversion format.
P2
Format Remark
Value
YYMMDD_hhmmss 0 YY: year (00~99); MM: month(01~12); DD: day(01~31)
hh: hour(00~23); mm: minute(00~59) ; ss: second(00~59)
YYMMMDD_hhmmss 1 YY, DD, hh, mm, ss: same as above
MMM: month(JAN~DEC)
YYMMDD_hhmm 2 YY, DD, hh, mm: same as above; MM: month(01~12)
YYMMMDD_hhmm 3 YY, DD, hh, mm: same as above;
MMM: month(JAN~DEC)
Example 1 $U10 = TD2STR(0) /* Assume that the current system date is December 7, 2008 and the current
system time is 15:18:30. After this command is executed, the byte array $U10 contains
“081207_151830". */
Example 2 $U20 = TD2STR(3) /* Assume that the current system date is December 31, 2008 and the
current system time is 13:30:00. After this command is executed, the byte array $U20 contains
“08DEC31_1330”. */
14.4.17.8 I2A
Format P1 = I2A(P2,P3 ) Data Type U/S/UD/SD
Function Converts the integer number in P2 to a string and saves the result in P1. The string is generated
according to the format specified by P3 and P4.
P1 (I) The byte array that stores the result. The result is a null terminated string.
P2 (I/C) The integer number or the location that holds the integer number to be converted.
P3 (I/C) Specifies the maximum number of digits the string can have.
P4 (I/C) Specifies where to insert a decimal point in the string. A decimal point is inserted to the left of the
nth digit when P4 is n. No decimal point is inserted when P4 is 0.
Example 1 $U120 = 123
$U100 = I2A($U120, 5, 0) /* After this command is executed, the byte array $U100 contains
“123”. */
Example 2 $U120 = 1234567 (UD)
$U100 = I2A($U120, 6, 2) (UD) /* After this command is executed, the byte array $U100 contains
“2345.67”. */
Example 3 $U120 = -12345 (S)
$U100 = I2A($U120, 5, 1) (UD) /* After this command is executed, the byte array $U100 contains
“-1234.5”. */
14.4.17.9 A2I
Format P1 = A2I(P2,P3,P4 ) Data Type U/S/UD/SD
Function Converts the string P2 to an integer value and saves the result in P1.
P1 (I) The location that stores the result. The result is 0 when there is any conversion error.
P2 (I) The byte array that holds the string to be converted.
P3 (I/C) Specifies the length of the string. It is allowed to specify 0 for P3. When P3 is 0, the string must
be a null terminated string.
P4 (I/C) Specifies how many fractional digits in the string are to be converted.
Example 1 $U120 = “123”
$U100 = A2I($U120, 0, 0) /* After this command is executed, the value in word $U100 is 123. */
Example 2 $U120 = “1234567”
$U100 = A2I($U120, 6, 0) (UD) /* After this command is executed, the value in double word
$U100 is 123456. */
Example 3 $U120 = “-123.45”
$U100 = A2I($U120, 0, 2) (S) /* After this command is executed, the value in word $U100 is -
12345. */
14.4.17.10 F2A
Format P1 = F2A(P2,P3 ) Data Type F
Function Converts the floating point number in P2 to a string and saves the result in P1. The string is
generated according to the format specified by P3 and P4.
P1 (I) The byte array that stores the result. The result is a null terminated string.
P2 (I/C) The floating point number or the location that holds the floating point number to be converted.
P3 (I/C) Specifies the number of integral digits the string can have.
P4 (I/C) Specifies the number of fractional digits the string can have.
Example 1 $U120 = 123.45 (F)
$U100 = F2A($U120, 5, 2) /* After this command is executed, the byte array $U100 contains
“123.45”. */
Example 2 $U120 = 1234 (F)
$U100 = F2A($U120, 6, 2) (UD) /* After this command is executed, the byte array $U100
contains “1234.00”. */
Example 3 $U120 = -1234.5 (S)
$U100 = F2A($U120, 5, 1) (UD) /* After this command is executed, the byte array $U100
contains “-1234.5”. */
14.4.17.11 A2F
Format P1 = A2F(P2,P3 ) Data Type F
Function Converts the string P2 to a floating point number and saves the result in P1.
P1 (I) The location that stores the result. The result is 0 when there is any conversion error.
P2 (I) The byte array that holds the string to be converted.
P3 (I/C) Specifies the length of the string. It is allowed to specify 0 for P3. When P3 is 0, the string must
be a null terminated string.
Example 1 $U120 = “123.4”
$U100 = A2F($U120, 0) /*The value of the floating point number in double word $U100 is 123.4.
*/
Example 2 $U120 = “1234567”
$U100 = A2F($U120, 6) (UD) /* The value of the floating point number in double word $U100 is
123456. */
Example 3 $U120 = “-123.45”
$U100 = A2F($U120, 0) (S) /* The value of the floating point number in double word $U100 is -
123.45. */
14.4.18.1 RUN
Format RUN(P1) Data Type -
Function Runs the executable P1 which is on the same PC. This command is available for PanelExpress
only.
P1 (I/A) The name of the executable to be run.
Example 1 RUN "ABC.exe" /* Run the program ABC */
Example 2 $U10 = "XYZ.bat"
RUN $U10 /* Run the batch file XYZ */
14.4.18.2 RUNW
Format P1 = RUNW(P2) Data Type -
Function Runs the executable P2 which is on the same PC and saves the result in P1. Note that the
macro command following this one will not be executed until the program is closed. This
command is available for PanelExpress only.
P1 (I) The word to receive the result.
P2 (I/A) The name of the executable to be run.
Example 1 $U10 = RUNW "ABC.exe" /* Run the program ABC and use $U10 to get the result. */
IF $U10 == 0 /* If the result is 0 then run the batch file XYZ. */
$U20 = "XYZ.bat"
$U11 = RUNW $U20 /* Run the batch file XYZ. */
ENDIF
14.4.19.1 PRINT
Format P1 = PRINT(P2,P3 ) Data Type U
Function Sends P3 bytes of data stored in byte array P2 to the printer and saves the completion code in P1.
P1 (I) The word to receive the completion code of the operation. The following table describes the meanings
of the completion codes.
Code Description
0 Succeeded
1 Printer not ready
3 System error
4 Printer busy
7 No printer
specified
P2 (I) The starting location of the byte array that stores the data to be sent to the printer.
P3 (I/C) The length in byte of the data to be sent to the printer.
Example 1 $U10 = "This is a test."
$U20 = PRINT($U10, 15) /* Send the string “This is a test.” to the printer. */
$U10 = 10
$U20 = PRINT($U10, 1) /* Send the line-feed character to the printer */
$U10 = 12
$U20 = PRINT($U10, 1) /* Send the form-feed character to the printer */
Example 2 $U10 = 0x401b /* ESC, '@' */
$U20 = PRINT($U10, 2) /* Send the initialization command to the EPSON printer */
Appendix A text.