Weintek
Weintek
Weintek
Ver. 5.01.02
1.
5.2.1.
8.3.1.
1-1
1.2.
1-2
1-3
Insert the CD-ROM into your CD-ROM drive. The computer will automatically install
EasyBuilder Pro driver. Or, you can manually execute [Autorun.exe] file under the root
directory. The installation screen is shown as the following figure.
2.
1-4
3.
Remove the old version of EasyBuilder Pro if needed, and click [Next].
4.
Designate a new folder for EasyBuilder Pro installation or use the recommended folder
then click [Next].
5.
Select a start menu folder to save the programs shortcut. Click [Browse] to designate a
folder or use the recommended folder then click [Next].
1-5
6.
Users will be enquired if there are any additional tasks to be done. For example: [Create a
desktop icon]. Select it if needed then click [Next] to continue.
7.
Please check if the setting is correct. If any changes need to be made, click [Back] to
change the setting or click [Install] to start installation.
1-6
8.
Installation processing.
9.
1-7
10. The EasyBuilder shortcut can be found in [Start] [All Programs] [EasyBuilder Pro].
The description of each item in EasyBuilder Pro menu:
Installed file
Description
Administrator Tool
Easy Access
EasyBuilder Pro
EasyConverter
EasyDiagnoser
EasyPrinter
EasySimulator
Executes simulation.
EasySystemSetting
EasyWatch
Recipe Editor
Release Note
Structure Editor
Utility Manager
Note
2-1
Utility Manager
2. Utility Manager
This chapter explains how to use Utility Manager.
2.1.
2.2.
2.3.
2.4.
2.5.
2.6.
2-2
Utility Manager
2.1. Overview
After installing EasyBuilder Pro, double click [Utility Manager] shortcut on the desktop to start.
Utility Manager is for launching several utilities and it is a stand-alone program.
Utilities
Description
Select Model
Select your HMI model. Please note that if the model is incorrect,
certain features may not work correctly.
Design
2-3
Utility Manager
Publish
Maintenance
See 29 Pass-through.
Download: Download project file to HMI via Ethernet.
Upload: Upload files on HMI to PC via Ethernet.
Build Download Data for SD/USB Disk:
Build the data to be saved in SD card / USB drive and then insert
the device to HMI to download the data. This feature is not
supported by cMT Series.
EasyPrinter, Backup/Printer Server: A backup/printer server on PC,
which receives backups from HMI and run a defined batch to
convert, or HMI screenshots to print out on PC.
Administrator Tools: Allows storing the data of [User Accounts],
[USB Security Key], [e-Mail SMTP Server Settings], and [e-Mail
Contacts] to USB. This feature is not supported by cMT Series.
See 36 Administrator Tools.
cMT Viewer: Connect to a cMT-SVR machine. PC acts as a display
terminal for cMT-SVR.
Data/Event log Information: Connect with HMI via USB cable or
Ethernet to check the number of history files in HMI. This feature is
not supported by cMT Series.
EasyAccess 1.0: Control remote HMI instantly and conveniently no
matter which corners in the world you are. You can find more
Data Conversion
Run
Edit
2-4
Utility Manager
Set the download password. To use masking password, select [Mask] check box.
Note
Please remember the password, otherwise, while restoring HMI default settings, the
project files and data in HMI will be completely erased.
Reboot HMI
Reboot the HMI without unplugging. After reboot, the system returns to the initial state. Set
the correct IP address when rebooting HMI via Ethernet.
Data/Event Log File Information
After setting, connect with HMI to check the number of history files in HMI.
2-5
Utility Manager
2-6
Utility Manager
Note
If only the history files are downloaded, it is necessary to reboot HMI to update files.
2.4. Transfer
2.4.1. Download
Download files to HMI via Ethernet or USB cable.
Setting
Description
Firmware
Project
RW / RW_A
Recipe database
Data log
2-7
Utility Manager
2.4.2. Upload
Upload files from HMI to PC via Ethernet or USB cable. Click [Browse] and assign the file path
before uploading.
2-8
Utility Manager
Setting
Description
Event log
Extended Memory
(EM)
For information about [Project], [RW / RW_A], [Recipe database] or [Data log], see 2.4.1
Download in this chapter.
Note
The file will be uploaded to PC in .exob format. Please decompile it into editable .emtp file
first and open the .emtp file in EasyBuilder Pro.
2.5. Simulation
2.5.1. Off-line Simulation / On-line Simulation
Off-line simulation: Simulate project operation on PC without any connection.
On-line simulation: Simulate project operation on PC and PLCs are directly connected with PC.
Note
When using [On-line simulation] on PC, if the target device is a local PLC (the PLC directly
connected to PC), there is a 10 minutes simulation limit.
Before executing On-line/Off-line Simulation, please select the source .exob file.
When executing On-line/Off-line Simulation, right click to use these functions:
Setting
Description
Exit simulation
Stop simulating.
Run EasyDiagnoser
Screenshot
2-9
Utility Manager
2.6. Pass-Through
This function allows the PC application to connect PLC via HMI. In this case, the HMI works like
a converter.
3-1
3.2.
3.3.
3.4.
3.5.
3.6.
3-2
3.1. Overview
The following is the process of creating a project.
1. Create a new project file.
2. Save and compile the project file.
3. Run On-line or Off-line simulation.
4. Download the project file to HMI.
The following describes each process.
3.
Click [New].
4.
Configure parameters.
3-3
5.
6.
3-4
7.
In EasyBuilder Pro toolbar click [File] [Save] to save the .emtp file.
In EasyBuilder Pro toolbar click [Tools] [Compile] to compile .emtp file as .exob file,
which could be downloaded to HMI. This also checks if the project can run correctly.
Note
3.
For cMT-SVR, the project file extension is .cmtp, and the compiled file extension is .cxob.
To use multiple languages, all languages must be configured in Label Tag Library first.
When downloading the project to HMI, select the needed languages only. A successful
compilation is shown in the following figure.
3-5
Note
When using On-line Simulation on PC, if the target device is the PLC directly connected to
PC, there is a 10-minute simulation limit.
3-6
Setting
Description
Start Button
Project
Search
History
System
Note
3.6.1.
1.
In EasyBuilder Pro toolbar, click [Tools] [Download]. Make sure that all the settings are
2.
correct.
Select [Ethernet], set password and HMI IP.
3-7
Setting
Firmware
Description
Font files
Reset recipe/
event log/
data sampling/
recipe database/
operation log/
user-defined
startup screen
Reboot HMI after
download
Automatically
using current
settings to
download after
compiling
Note
For cMT-SVR, the [Firmware] and [Font files] check boxes are not available.
3.
4.
3-8
5.
Click [Download].
6.
When finished, next time when [Download] is clicked, EasyBuilder Pro will automatically
compile and download the project to the latest target HMI.
3.6.2.
1.
2.
On PC, select the HMI name and start downloading. To use [Search], enter the HMI name
first to search for the HMI. [Search all] searches for all HMIs in the same subnet network.
3-9
3.6.3.
Select USB cable to download project to HMI. The way of setting is same as 3.6.1 Configure in
EasyBuilder Pro. Before downloading via USB cable, please make sure the USB driver is
installed. Go to [Computer Management] [Device Manager] to check if USB driver is installed.
If it is not installed, please refer to installation steps to install manually.
3.6.4.
The following explains how to download project file by using USB drive or SD card.
1. On EasyBuilder Pro toolbar click [Tools] [Build Download Data for SD / USB Disk].
3-10
2.
3.
4.
After password is confirmed, it will show the directories in the external device. (pccard: SD
Card; usbdisk: USB Drive)
5.
Select the directory that contains project, and then click [OK] to start downloading.
Note
Please select the parent directory of the generated files when downloading. For the
structure above, please select disk_a_1, not mt8000ie.
You may click [System Settings] to save the hardware settings configured in EasyBuilder
Pro into SD card or USB disk, and then download the settings file to HMI. See 4 Hardware
Settings for more information.
4-1
Hardware Settings
4. Hardware Settings
This chapter explains HMI settings.
4.1.
4.2.
4.3.
4.4.
4.5.
4.6.
4-2
Hardware Settings
4.1. Overview
This chapter discusses the HMI settings.
Click the icon to download the cMT-SVR User Manual if needed.
Please confirm your internet connection before downloading the document.
Description
CPU (Green)
COM (Blue)
4-3
Hardware Settings
Description
CPU (Green)
COM (Blue/Red)
+ disappears and the touch screen parameters will be stored in HMI system.
After calibration, confirm to restore the default password, select [Yes].
Confirm to restore the default password again by typing [yes] and clicking [OK]. The
project files and history records stored in HMI will all be removed. (The default Local
Password is 111111. However, other passwords, such as Download/Upload passwords
have to be reset.)
The following lists the DIP switch settings of different models. Please see the relevant
installation instruction.
eMT / iE
Mode
Touch Screen Calibration Mode
OFF
ON
OFF
OFF
OFF
OFF
ON
OFF
OFF
OFF
OFF
ON
Reserved
OFF
OFF
OFF
OFF
Normal
4-4
Hardware Settings
Note
The state of DIP Switch 4 on each unit may be different. If it should be ON when out from
factory, the Dip Switch 4 would be set ON and cut off. If it should be OFF, the Dip Switch 4
would be set OFF but the switch is not cut.
mTV
cMT-SVR
SW1 SW2
ON ON
Mode
Restore factory default
ON
OFF
OFF
ON
OFF
OFF
Normal mode
SW1 SW2
ON ON
Mode
Restore factory default
ON
OFF
OFF
ON
OFF
OFF
Normal mode
4.5.1.
System register [LB-9020] can also enable/disable system setting toolbar. When [LB-9020]
is set ON, the toolbar is displayed, and set OFF to hide the toolbar.
System Setting
Set or modify system parameters. Confirm password for security first. The factory default
password is 111111.
4-5
Hardware Settings
Network
When downloading project file to HMI via Ethernet,
set the correct IP of the target HMI. You can obtain
an IP address automatically or enter the IP address
manually.
Time / Date
Set HMI local time/date.
Security
Password protection, the default is 111111. Please
click the buttons to set the passwords, and finish
password confirmation.
[Password for entering system]
[Password for uploading project]
[Password for downloading project]
[Password for uploading history data]
History
Clears history data in HMI.
4-6
Hardware Settings
HMI name
Set HMI name to be used when download/upload
project.
Firmware setting
Upgrade firmware and select the display mode. The
display mode will take effect at next reboot.
VNC server
Remote HMI monitoring and controlling via
Ethernet.
[Start VNC single-connection]
Allows connection with one VNC client.
[Start VNC multi-connection]
Allows connection with multiple VNC clients.
Connecting more VNC clients may slow down the
communication speed.
Please see the settings steps in the later part.
Miscellaneous
Rotary switch for adjusting LCD brightness.
[Popup download window]
If selected, after inserting USB disk or SD card to
HMI, the Upload / Download dialog box is displayed.
[Restart after download/upload]
If selected, restarts HMI automatically after
uploading / downloading project.
4-7
Hardware Settings
Note
4.5.2.
If there is no activity of VNC client for more than one hour, HMI system will log out
automatically.
The mTV Series does not support VNC server.
System Information
4-8
Hardware Settings
4.6. EasySystemSetting
EasySystemSetting allows updating hardware system settings by using SD card or USB drive.
The feature is available for HMI OS version 20131106 or later. The following explains how to
update HMI IP address by using SD card or USB drive.
1.
On EasyBuilder Pro toolbar click [Tools] [Build Download Data for SD / USB Disk], and
then select [Use system setting] check box.
2.
3.
4.
Setting
Import
Description
Export
Default
Restore default.
4-9
Hardware Settings
5.
Click [Build] button in [USB Disk/CF Card/SD Card Data] dialog box to generate the file for
6.
7.
Press [Load System setting] and then the [Download Config Settings] message appears.
The project file will be updated after finishing system settings.
5-1
5.5.
5.6.
5.7.
5.8.
5.9.
5.10.
5.11.
5.12.
5-2
5.1. Overview
Launch EasyBuilder Pro, in the main menu select [Edit] [System Parameters] to open the
[System Parameter Settings] dialog box. System Parameter Settings are divided into several
tabs as shown in the following figures. These tabs will be introduced respectively in this
chapter.
eMT, iE, XE, mTV Series
cMT Series
5.2. Device
Parameters in this tab determine the attributes of each device connected with HMI. The device
can be a Local / Remote HMI / PLC. When creating a new project file, there is a default device
"Local HMI" which indicates the HMI that will be updated and programmed. To change the
relevant device settings, click [System Parameter Settings] [Settings] to open [Device
Properties] dialog box.
EasyBuilder Pro V5.01.02
5-3
5.2.1.
Local PLC means the PLC is connected to the local HMI. To control/connect a Local PLC, add
this type of device first. Click [System Parameter Settings] [New] to open [Device Properties]
dialog box. For example, when connecting Mitsubishi FX0s/FX0n/FX1s/FX1n/FX2 as a Local
PLC:
Setting
Description
Name
HMI / PLC
Location
PLC type
PLC I/F
5-4
Timeout
If the communication has been disconnected for more
than preset time limit configured in [Timeout] (in sec),
Window No. 5 will pop up and show PLC No Response
message.
Turn around delay
While sending the next command to PLC, HMI will delay
the sending according to the time interval set in [Turn
around delay]. This may influence the efficiency of the
communication between HMI and PLC. Default value is
0.
Note: If the PLC used is SIEMENS S7-200 Series, it is
recommended to assign 5 to [Turn around delay] and
30 to [Send ACK delay].
If the interface used is [Ethernet], click [Device
Properties] [Settings] and the [IP Address Settings]
dialog box opens. Please set correct PLC IP address
and port number.
5-5
Default
station no.
use station
no. variable
5-6
Use
broadcast
command
5-7
Max. read The maximum data size to read from the device at one
command
time. Unit: word
size (words)
Max. write The maximum data size to write to the device at one time.
command
Unit: word.
size (words)
After all settings are completed, a new device named Local PLC 1 is added to the *Device list+.
Note
When using cMT-SVR, select Local HMI in [System Parameter Settings] dialog box and
then click [New PLC] to add a Local PLC 1 under Local HMI.
5.2.2.
Remote PLC is a PLC being connected to a remote HMI. To control a remote PLC, add this
type of device first. Please click [System Parameter Settings] [New] to open [Device
Properties] dialog box. For example, use SIEMENS S7-200 as the Remote PLC:
5-8
Setting
Description
HMI or PLC
Location
PLC Type
PLC I/F
The interface used for Remote PLC. If the remote PLC uses a
COM port, select [RS-232], [RS-485 2W], or [RS485 4W].
COM
PLC default
station no.
After all settings are completed, a new device named Remote PLC 1 is added to the *Device
list].
5-9
Note
5.2.3.
When using cMT-SVR, select the defined Remote HMI 1 in [System Parameter Settings]
dialog box and then click [New PLC] to add a Remote PLC 1 under Remote HMI 1.
Remote HMI is the HMI other than Local HMI, and PC is also a Remote HMI. To control a
Remote HMI, add this type of device first. Click [System Parameter Settings] [New] to open
[Device Properties] dialog box as shown in the following figure:
5-10
Setting
Description
HMI or PLC
Location
After all settings are completed, a new device named Remote HMI 1 is added to the [Device
list].
5-11
Note
When using cMT-SVR, in [System Parameter Settings] dialog box click [New HMI] to add a
Remote HMI 1.
5.3. Model
Configure the [HMI model], [Timer], [Printer] and [Scroll bar] settings.
5-12
Note
When using cMT-SVR, configure only [HMI model], [HMI station no.], and [Port no.].
Setting
Description
HMI model
5-13
Port no.
Support cMT
Viewer
communication
protocol
Timer
Clock source
Set the source device of the clock/time information. It is
used by [Data Sampling], [Event Log], etc.
Printer
Type
A printer can be connected with the HMI. The HP PCL Series
EasyBuilder Pro V5.01.02
5-14
Set the width of Scroll Bar, when the size of the object is too
small to display the contents, a scroll bar is displayed in the
object. This feature can be applied to objects that allow
scrolling, such as Alarm Display, Event Display, History Data
Display, and Option List.
Pass through
5.4. General
Configure the properties related to screen display.
5-15
Setting
Description
Fast
selection
button
Screen saver
5-16
Option
Event
Keyboard
Project
protection
Screen saver
If the screen is left untouched and reaches the time limit
set here. The current screen will automatically switch to a
window assigned in [Saver window no.].The setting unit is
minute. If [none] is set, this feature is disabled.
Saver window no.
To assign a window for screen saver.
Startup window no.
Designate the window shown when start up HMI.
Common window
The objects in the common window (Window No. 4) will be
shown in each base window. This determines that the
objects in common window are placed above or below the
objects in the base window.
Object layout
If [Control] mode is selected, when operating HMI,
[Animation] and [Moving Shape] objects will be displayed
above other kinds of objects neglecting the sequence that
the objects are created. If [Nature] mode is selected, the
display will follow the sequence that the objects are
created, the first created will be displayed first.
RW_A enabled
Enable or disable recipe data RW_A. Enable this, the
objects can then control RW_A .The size of RW_A is 64K.
Extra no. of events
The default number of the events in the system is 1000. For
additional number of events, modify this setting. The
maximal is 10000.
The window number in which the keyboard is placed.
When using Numeric Input or ASCII Input objects, the type
of keyboards can be selected. Up to 32 keyboards can be
added. To design a keyboard, a window should be
designated for creating it. Press [add] after creating, and
add the window to the list.
See 12 Keyboard Design and Usage.
Caret color
Set the color of caret that appears when entering data in
Numeric Input and Word Input objects.
Projects can be restricted to be executed by a specific HMI.
See 30 Project Protection.
5-17
Note
cMT Series does not support [Fast selection button] and [Keyboard].
Some features are duplicated from system registers, such as, [Hide system setting bar
(LB-9020)], [Hide mouse cursor (LB-9018)], [Disable buzzer (LB-9019)], [Prohibit remote HMI
connecting to this machine (LB-9044)], and [Disable upload function (LB-9033)]. Users can also
set these features via system tag.
To select a system tag, select [Address] [System tag] check box when adding a new object and
then select the [Device Type].
To browse all the system tags, Select [Library] [Tag] [System] from the main menu of
EasyBuilder Pro.
5-18
Setting
Description
Auto logout
Prohibit password
remote-read operation
(or set LB9053 ON)
Prohibit password
remote-write operation
(or set LB9054 ON)
Sound control
5-19
VNC Server
LW protection
RW protection
If selected, displays a
disconnection icon on relevant
objects when failing to
communicate with PLC.
This icon will be shown in the
lower right corner of the
object.
Set the password to log in VNC server.
If [Monitor mode] check box is selected, the
HMI connected via VNC can only be monitored
but not controlled.
If select [Disable LW/RW remote-write] check
boxes and set the protect range in [LW/RW
range], values within the protected range
cannot be adjusted using Remote HMI.
Through this technology, users can easily
access to any HMI connected to the internet
and operate them on PC just like holding touch
screen in hand.
Easy Access does not transmit updated graphic
images directly but only the real time data.
This makes transmission really quick and
efficient. Please refer to EasyAccess Manual
for more information.
Note
5.6. Security
Parameters in this tab configure the user passwords and security classes. There are two
authentication modes: General Mode and Enhanced Security Mode.
For more information, see 10 Security.
5-20
5.6.1.
General Mode
Up to 12 sets of user and password are available. Password should be one non-negative integer.
Once the password is entered, the objects that the user can operate are classified.
There are six security classes available: A to F.
If [None] is selected for an object, every user can access this object.
For example, when the security class of User No. 3 is set as the preceding figure, User No. 3
could only access objects of classes A, B, C and none.
Users can set password to protect the project (.emtp) files. The password set here must be
entered when editing the project file.
Select [Enable] then click [Setting] to set the password.
Before editing a project, a popup window is shown for entering the password. Only when the
password is correct can the user edit this project.
5.6.2.
At most 11 users can be set here. An [Administrator] user is provided in this mode. An
[Administrator] has all privileges and can operate all object classes. User passwords must be
alphanumeric and each user can have up to 12 classes: A to L.
5-21
Setting
Description
Select operable
classes for each
user
Administrator
Control address
Execute auto.
Login/logout
when insert an
USB key into HMI
5-22
Note
cMT Series only supports Enhanced Security Mode, but does not support [Execute auto.
Login/Logout when insert an USB key into HMI.]
5.7. Font
5.7.1.
The non-ASCII fonts are listed here. When using non-ASCII characters or double byte characters
(including Simplified or Traditional Chinese, Japanese, or Korean) which are not listed in [Fonts
for non-ascii strings] table, EasyBuilder Pro will select a font from the list to substitute for it
automatically.
EasyBuilder Pro V5.01.02
5-23
The non-ASCII fonts in Windows can be added to the [Fonts for non-ascii strings] table.
Decide the space between lines in the text in [Line spacing] field.
Select [Support Arabic, Persian, Hebrew, and Thai, alphabets] check box to correctly display
these alphabets.
5.7.2.
cMT Series
This tab lists the fonts used in WINDOWS and the corresponding fonts displayed on iPad.
5-24
Extended Memory is numbered from EM0 to EM9. It works in a way similar to other device
types (i.e. LW or RW address). Users can simply select from [Device type] list while adding a
new object. Size of each extended memory is up to 2G word.
Extended memories are saved as files in [SD card] or [USB disk]. [EM0] to [EM9] are saved as
em0.emi to em9.emi respectively. Users can use RecipeEditor.exe to open these files and
edit the data in the extended memory.
Data in extended memory will not be erased when power is cut, which means next time when
start up HMI again, data in the extended memory remains the same as before power off. This is
similar to recipe data (RW, RW_A). The difference is that users can specify the location to store
data. (SD card, USB disk)
When the device of extended memory does not exist and to read data in it, the data content
will be 0; to write data to a device that does not exist, the "PLC no response" message will be
shown in HMI.
Users can insert or remove the external device to or from HMI without cutting the HMI power
to update or take data in extended memory.
EasyBuilder Pro V5.01.02
5-25
Setting
Description
Output
settings
Orientation
Set how will words or pictures be printed out, [horizontal]
or [vertical].
Printer size
Set to print out in [Original size] or to [Fit to printer
margins].
Margin
Set the top, bottom, right and left margin width.
IP address
Assign the IP address of the printer via network.
Communication
settings
5-26
5.10.
Time Synchronization
Setting
Description
Execute time
synchronization
when HMI starts
with
the
5-27
5.11.
Network time
server
Update interval
Setting
Description
SMTP Settings
5-28
Name:
Specify the sender name or use HMI name.
Mail Address:
Setting e-mail address.
Click [Open Contact settings] to open the following dialog to edit contacts:
Setting
Description
Contact list
Group
Information
Group up contacts.
No. of groups:
Set no. of contact groups, according to the number, the
groups are named from A to P and up to 16 groups can be
set.
Current group:
Displays the group that includes the contacts above.
Comment:
Enter a description for the current group.
5.12.
Recipes
5-29
Setting
Description
Recipes List
New
Settings
Delete
Click [Settings]:
Setting
Description
Name
Display Type
6-1
Window Operations
6. Window Operations
This chapter describes different types of windows and how to create, set and delete a window.
6.1.
6.2.
6.3.
6-2
Window Operations
6.1. Overview
A window is a basic element in a project. With a window, all kinds of information like objects,
pictures, and texts can be displayed on HMI screen. In total, 1997 windows numbered from 3 ~
1999 in EasyBuilder Pro can be built and edited.
Base Window
The most frequently used window, except for main screen, it can also be:
A background of other windows.
A keyboard window.
A pop-up window of Function Key object.
A pop-up window of Direct Window and Indirect Window objects.
A screen saver.
Note
6.2.2.
Base Window should be in same size as the HMI screen. Therefore, the resolution of the
base window should be set to the resolution of HMI.
Fast Selection Window
Window no. 3 is the default Fast Selection Window. This window can co-exist with base
window. Generally, it is used to place the frequently-used buttons on the lower-left side or the
lower-right side on the screen. Please create window no. 3 first, and set the relevant properties
in [System Parameter Settings] [General] tab. Apart from showing or hiding fast selection
window with the button on the screen, there are system registers to do so:
[LB-9013] Fast Selection window control [hide(ON)/show(OFF)]
[LB-9014] Fast Selection button control [hide(ON)/show(OFF)]
[LB-9015] Fast Selection window/button control [hide(ON)/show(OFF)]
Note
6-3
Window Operations
6.2.3.
Common Window
Window no. 4 is the default Common Window. Objects in this window will be displayed in
other base windows, not including pop-up windows. Therefore, the common objects in
different windows are often placed in common window.
When operating HMI, select [Function Key] [Change common window] to change the source
of common window.
In menu [Option] [Preferences] select whether or not to [Display Common Window objects
on Base Windows] when editing a project. This can avoid overlapping objects in base window
with objects in common window.
6.2.4.
6-4
Window Operations
Note
6-5
Window Operations
6.3.1.
Setting
Description
Name
The name appears on the title bar and also in window tree.
Window no.
Can be 3 to 1999.
Size
Underlay
window
6-6
Window Operations
Pop-up
window
Monopoly
Title bar
Note
The objects in underlay window cannot be edited from the base window that displays
them. To edit those objects, please open the underlay window where they are located.
When the window number of the underlay window used by the base window is identical
to the pop-up window, the pop-up window is disabled.
When base window and pop-up window use the same underlay window, the objects in
the underlay window cannot be displayed in pop-up window.
Or, from the main menu click [Window] [Open Window] and then click [New] and select the
type of the window and click [OK].
6-7
Window Operations
6.3.2.
7-1
Event Log
7. Event Log
This chapter explains how to set and use Event Log.
7.1.
7.2.
7.3.
7-2
Event Log
7.1. Overview
The following are the basic steps to use Event Log:
1. Define event content and trigger condition.
2. Trigger event according to the condition.
3. Save the event log to the specified device.
4. View the process of event by using the relevant objects.
This chapter will explain how to set and use Event Log.
Setting
Description
Category
7-3
Event Log
History
files
Paste
Paste
(Add Mode)
7.2.2.
cMT Series
Setting
Description
Category
7-4
Event Log
History
files
Paste
Paste
(Add Mode)
Note
To remove SD card or USB disk, event log data can be synchronized by using control
address first.
7-5
Event Log
7.2.3.
Excel Editing
Click on the Excel icon in Event Log setting dialog box to open the Excel template for a
reference of editing. This template is under the installation directory, the file name is
EventLogExample.xls. This template includes the ready-made dropdown lists and validation
mechanism.
Note
[System tag] and [User-defined tag] cannot be set to true simultaneously, otherwise, the
system will view the User-defined tag to be a System tag, and [User-defined tag] to be
false. If setting [Device type] to [User-defined tag], please set [System tag] to false.
When setting [User-defined tag] to true, if the system compares the [Device type] with
the user-defined tag in the system, and no suitable tag is found, the system will set the
[User-defined tag] in event log to false
[Color] format is R:G:B, each should be an integer form 0 to 255.
Before importing Label Library / Sound Library, please make sure the library names exist in
the system.
7-6
Event Log
Setting
Description
Category
Priority
level
Delay time
for event
monitoring
when HMI
resets
This feature is used to set the delay time of Event Log after
HMI reboot, in order to avoid false alarm that occurs upon
HMI reboot due to uninitialized values. This feature is often
used with [Dynamic condition value]. The delay time only
occurs once upon HMI reboot.
Read
address
The system reads data from this address to check if the event
matches the trigger condition.
Notification
7-7
Event Log
Condition
When [Bit] is selected, Event Log will detect the state of a Bit
address.
When [Word] is selected, Event Log will detect the value of a
Word address to check if it is greater than, less than, or
equals to a specified value. See Example 1 and Example 2.
Dynamic condition value
Allows online change of the comparison value for trigger
condition when the condition is a Word address type. If
[Read/Condition use different addresses] is not selected, the
source of condition value will be the next consecutive address
from [Read address].
Read/Condition use different addresses
Allows selecting the Word address type to be the source of
condition value.
Example 1
Example 2
7-8
Event Log
Message Tab
Setting
Description
Content
Font / Color
The font and color can be set differently for each event.
The setting determines the font and color shown in
[Alarm Bar], [Alarm Display] or [Event Display] objects.
Event/Alarm
Display object
Sound
7-9
Event Log
Address of
WATCH 1 ~ 8
Example 3
The data of the LW register can be used in the content displayed when an event is triggered:
Format: %#d (% -> initial sign, # -> address, d -> end sign)
When an event is triggered, if the value in LW-20 is 13:
Setting: High Temperature = %20d Display: High Temperature = 13
Example 4
The data in the specified address when the event is triggered can be included in the content
displayed. The address should be set to the [Read address] of Event Log, take MODBUS RTU 4x
address as an example:
Format: $#d ($ -> initial sign, # -> address, d -> end sign)
When an event is triggered, if the value in MODBUS 4x-15 is 42:
Setting: High Temperature = $15d Display: High Temperature = 42
7-10
Event Log
e-Mail Tab
Please enable this function in [System Parameter Settings] [e-Mail] first.
Setting
Description
Recipients
Subject
Message
Attach
8-1
Data Sampling
8. Data Sampling
This chapter explains how to set and use Data Sampling.
8.1.
8.2.
8.3.
8.4.
8.5.
8-2
Data Sampling
8.1. Overview
After defining how the data is sampled, by sampling time, address, or data length, the sampled
data can be saved to the designated location, such as HMI memory, SD card, or USB disk. Trend
Display and History Data Display objects can be used to display sampling records.
8-3
Data Sampling
cMT Series
Setting
Description
Sampling mode
Time-based
Samples data in a fixed frequency. The [Sampling time
interval] can be set from 0.1 second(s) to 120 mins.
Trigger-based
Triggers data sampling by the status of a designated bit
address.
Mode Conditions to trigger Data Sampling:
[OFF -> ON] Triggers sampling when the status of the
address changes from OFF to ON.
[ON -> OFF] Triggers sampling when the status of the
address changes from ON to OFF.
[OFF <-> ON] Triggers sampling when the status of the
address changes.
Set ON/OFF after triggered
If selected, after triggering Data Sampling, the system will
set the designated bit address back to ON/OFF state.
Read address
Data Record
(Real-time)
8-4
Data Sampling
Data Format
Data of different formats in consecutive registers can be
sampled. As shown in the following figure: LW-0 (16-bit
Unsigned), LW-1 (32-bit Float), and LW-3 (16-bit
Unsigned).
Auto. stop
This function depends on the arrangement of different
objects and modes.
Clear real-time
data address
Hold address
Control
address
(cMT Series)
History files
8-5
Data Sampling
Note
A Data Sampling may include more than one type of records. Data Sampling can retrieve
different types of records at the same time. For example, if define three types of data, 4
words in total, the system retrieves a 4-word data each time from the designated address to
be the content in one Data Sampling.
When using [Each file consists of all records of a day] and set [Preservation limit] to 2 files,
the data of yesterday and the day before yesterday will be kept. Data that is not built in this
period will be deleted to prevent the storage space from running out.
When using [Customized file handling] and set [Preservation limit] to 2 files, not only the
currently sampled file, another 2 newest files (3 files in total) will be kept. The rest of the
data will be deleted to prevent the storage space from running out.
When running simulation on PC, all data sampling will be saved to the datalog folder in
C:\EBPro\ [Storage Location] \datalog. If you change the data format of data sampling,
delete the previous data records in the installation directory to prevent the system from
reading the old records.
EasyBuilder Pro V5.01.02
8-6
Data Sampling
8.3.1.
This feature depends on the arrangement of different objects and modes. (Set [Max. data
records] to n.)
Object
[Auto. stop] not selected
[Auto. stop] selected
Trend DisplayReal time
Trend DisplayHistorical
History Data
Display
Data Sampling
Irrelevant.
The figure illustrates how the data is sampled in Trend Display Real Time mode when [Auto.
stop check] box is not selected. Set the number of data records to 10, when the 11th data is
generated, the earliest record is deleted and the newest record is added.
8.3.2.
This feature can be used to customize naming and management of data sampling files (*.dtl).
8-7
Data Sampling
Setting
Description
File creation
Automatic mode
A new file will be created when the name of an existing
file is changed.
Trigger mode
A new file will be created according to the [Trigger
method] settings.
Trigger method
8-8
Data Sampling
File name
Note
If both [Limit by number of data records] and [Dynamic format] check boxes are selected,
before startup HMI, please enter the name in the designated register for Dynamic Format,
otherwise, it is impossible the reach the Max. data records in a file, and the data sampling
file will not be generated.
A data sampling file (*.dtl) cannot be written when its size exceeds 4MB.
When a new file is generated, the systm will first detect if the filename already exists. If the
file name does exist, the newly sampled data will be appended to the existing file.
Real-time data
For other series, when displaying the sampled data in Trend Display object, it is necessary to
select from Real-time mode or History mode and the two modes cannot simultaneously be
displayed in one object.
cMT Series allows displaying history data and at the same time updates real-time data in one
Trend Display or History Data Display object. The data saved in the external device can be
EasyBuilder Pro V5.01.02
8-9
Data Sampling
updated.
The rule of synchronizing the data saved in the external device:
1. When the sampled data reaches 10000 records, HMI will automatically saves data to the
external device and deletes the earliest 1000 records in HMI.
2. If the external device is removed from HMI, and inserted back again at the time when the
sampled data is under 9000 records, the data generated during the time the external
device is removed is saved in HMI and is not cleared. If the data exceeds 9000 records
during the time the external device is removed, the earlier data is cleared and cannot be
synchronized even to insert the external device back to the HMI.
3. If there already exists sampled data in the external device, the new data is appended
without overwriting the original data each time in synchronization.
Tap the
2.
3.
4.
9-1
9.5.
9-2
9.1. Overview
The basic steps to create an object:
1. Selecting the PLC device and setting the read/write address.
2. Using Shape Library and Picture Library.
3. Setting label text.
4. Adjusting profile size.
This chapter explains the basic settings of an object.
Setting
Description
PLC name
Device type
Address
System tag
9-3
Index register
For more information about System Tag, see 22 System Reserved Words and Bits.
For more information about Index Register, see 11 Index Register.
For more information about Tag Library, see 16 Address Tag Library.
9-4
Setting
Description
Shape Library
Select [Use shape] check box and select a shape from the
library. See next page.
Inner
Select this check box to set the inner part of a shape. Click
the drop down button to select a color or customize a
color and click [Add to Custom Colors]. EasyBuilder Pro will
save this color.
Frame
Select this check box to set the frame of a shape. Click the
drop down button to select a color.
Inner Pattern
Duplicate these
attributes to
every state
9-5
9.3.1.
Shape manager
Click *Shape Library+ button to open the [Shape manager] dialog box. The currently selected
shape is highlighted yellow.
The illustration above provides information of one of the Shapes in the Shape Library:
Shape5
Name of the shape.
States: 2
Number of states of the shape.
Objects: 1 This shape is used by 1 object in the project.
The illustration above shows the shape has two states, State 0 and State 1, and contains only
inner but not frame. When finished, click [OK], and the object will use the selected shape.
9.3.2.
Pictures manager
Click *Picture Library+ button to open the [Pictures manager] dialog. The currently selected
picture is highlighted yellow.
9-6
Setting
Description
Use label
Use label
library
Use bitmap
font
Select this check box to convert the label text into bitmap
format.
Label Library
Font
9-7
Color
Size
Align
Blink
[Right]
Italic
Use Italic font.
Underline
Use Underline font.
Movement
Direction
Set the direction of the marquee effect. The directions
include: [No movement], [Left], [Right], [Up], [Down].
Continuous
Specify how the marquee effect is displayed.
If not selecting this check box, the next text appears only
when the previous text disappears completely.
Speed
Adjust the speed of the text movement.
Content
9-8
Tracking
Duplicate this
label to other
state
Setting
Description
Position
Pinned
When this check box is selected, the position and the size
of the object cannot be changed.
[X] and [Y]
The coordinates of the position of the object in the editing
screen.
Size
10-1
10-2
10.1.
Overview
This chapter discusses the protection for operations provided by setting up user passwords and
security classes. There are two authentication modes:
General Mode
Enhanced Security Mode
Each mode will be introduced later.
To set up the protection system, please:
1. Set user password and operable classes.
2. Set object class for objects.
An object belongs only to one security class. Setting the object class to None means any user
can operate this object.
10.2.
The security parameters can be found in [Edit] [System Parameter Settings] [Security]. Two
modes are available: General Mode and Enhanced Security Mode.
10.2.1.
General Mode
Up to 12 sets of user and password are available. A password should be one non-negative
integer. There are six security classes: A to F.
Once the password is entered, the objects that the user can operate are classified. As shown
below, User 1 can only operate objects with class A or class C.
Note
10-3
10.2.2.
10-4
10.3.
The Control Address is used for login and account management. The Control Address can only
be assigned to LW register on Local HMI, and 20 consecutive registers will be used. To log in
using Control Address, please select to log in by [user name] or [user index].
Please set [user name] and [password] in [System Parameter Settings] [Security] [Enhanced
security mode] in advance.
10.3.1.
When control address is set to LW-n, where n is an arbitrary number, the following addresses
will be designated:
Address
LW-n (1 word)
LW-n + 1 (1 word)
Tag Name
command
command
execution
result
user index
Description
Commands to be executed: Login, Logout,
Add/Setting/Delete Accounts, etc.
Displays the result of executing
commands.
Note
In Enhanced Security Mode, if cMT-SVR Series model is used, the Control Address can only
be assigned to PLW register of Local HMI.
10-5
10.3.2.
Commands
Command
Log in by user name
3
4
Log out
Change the password
of current logged-in
user
Add an account
5
6
Add a temporary
account
Delete an existing
account by user
name
Delete an existing
account by user index
Setting the privilege
of an existing account
by user name
Setting the privilege
of an existing account
by user index
Setting the password
of an existing account
by user name
Setting the password
of an existing account
by user index
Read the privilege of
an existing account
by user name
Read the privilege of
an existing account
by user index
8
9
10
11
12
13
14
Corresponding Address
Set [user name] and [password] first. After
entering the user name and password, the
system will check if they are valid in
[System Parameter Settings] [Security]
[Enhanced security mode].
Set [user index] and [password] first.
Please refer to 10.4.4 Enhanced Security
Mode with Option List Object.
Set [user name] and [password] first.
Please fill in the original password in [user
name] and new password in [password].
Set [user name], [password] and [user
privilege] first.
Set [user name], [password], [user
privilege], and [user index] first. The index
is for specifying an effective time period
(minutes). If 0 is specified, this account is
valid until HMI is turned off.
Set [user name] first.
10-6
Note
Add a temporary account: The difference between general accounts and temporary
accounts is that temporary accounts will not be stored in the system; therefore, it is
invalid after HMI turned off. The temporary accounts will be automatically deleted when
they are expired.
Delete the existing account: The currently logged in account cannot be deleted.
Offline/Online Simulation: Simulate using the account settings in the program. Any
modifications of the account during simulation will not be reserved for next simulation.
admin: Default administrator account, cannot be deleted, has all privileges and cannot be
changed.
System Register LW-10754: Displays current user name.
System Register PLW-10754: Displays current user name. (Only available for cMT-SVR)
10.3.3.
After the command is executed, the system will store the result code to control address LW-n +
1. The listed result codes below are shown in hexadecimal format.
Result Codes
(0x001)
(0x002)
(0x004)
(0x008)
(0x010)
(0x020)
(0x040)
(0x080)
(0x100)
(0x200)
Note
Users can add a new event in Event (Alarm) Log, and designate the [Read address] to LW-n
+ 1 [command execution result]. Open [Message] tab [Text] [Content] and specify the
message to be displayed in Event Display Object for showing command execution result.
10-7
10.4.
10.4.1.
The user accounts can be set using other tools we provide, apart from the settings in [System
Parameter Settings] [Security] tab. Administrator Tools can also be used to set user accounts.
Administrator Tools can be found in the installation directory. After the program starts, select
the [User Accounts] check box. Up to 127 accounts can be added.
10-8
When finished, insert the external device to HMI, and press Function Key to import accounts. If
[Overwrite] is selected, the existing accounts will be overwritten with new accounts and
automatically log out after importing. If select [Delete file after importing user accounts] check
box, the system will delete the account data saved in the external device after importing. If the
[Effective Time] in Administrator Tools is specified, the importing can only be done in the time
limit specified. The imported accounts will not be deleted by system when the effective time
ends.
10.4.2.
Instead of entering user name and password to login, a key can be used to do so. In EasyBuilder
Pro installation directory, launch Administrator Tools, select [USB Security Key] check box. The
account information uses the predefined data in [System Parameter Settings] [Security].
10-9
Note
Please note that the user accounts used for USB Security Key must already exist in HMI.
For more information, see 36 Administrator Tools.
USB Security Key can be stored in USB disk or SD card, and create a Function Key to log in by
USB Security Key as shown below:
10-10
When finished, insert the external device to HMI, and press Function Key to log in using USB
Security Key. If the [Effective Time] in Administrator Tools is specified, the login can only be
done in the time limit specified. The system will log out automatically when the key expires.
10.4.3.
As shown below, in [System Parameter Settings], select [Enable] check box for [Execute auto.
Login / logout when insert an USB key into HMI].
This function allows automatic login / logout using an USB security key. Insert the USB disk in
which the key is saved to HMI to log in, and remove the USB disk to log out. The login / logout
status will be written into a designated address, the result codes of login / logout:
0x00: No Action
0x01: Login Succeeds
0x04: Login Fails
0x08: Login Succeeds
0x10: Logout Fails
EasyBuilder Pro V5.01.02
10-11
For more information about USB Security Key, see 36 Administrator Tools.
Note
When Auto Login / Logout is enabled, log in by [Function Key] object is not possible, but it
is still possible to log in / out with a designated control address.
This function does not support On-line / Off-line simulation.
Only the USB Security Key saved in USB disk is valid.
Click the icon to download the demo project that explains how to use USB Security Key to
log in / out. Please confirm your internet connection before downloading the demo project.
10.4.4.
Enhanced Security Mode uses Control Address LW-n + 2 as account index. With Option List
Object, account names and privileges can be displayed. Users can select whether or not to
display the account privileges and secret users in Option List. Secret users are set to be hidden
in [System Parameter Settings] [Security] [Enhanced Security Mode]; their account names
will be hidden in Option List if [Secret user] check box is not selected. If the control address is
set to LW-0, the monitor address for index of Option List is designated to LW-2.
Click the icon to download the demo project that explains more about Enhanced Security
Mode. Please confirm your internet connection before downloading the demo project.
10-12
10.5.
Setting
Safety control
Description
Interlock
10-13
User
restriction
10.6.
10-14
2.
3.
10-15
Note
Password input: If the password is incorrect, [LB-9060] will be ON; if the password is
correct, [LB-9060] will be OFF. All user passwords (User 1 to User 12) can be obtained
from system registers [LW-9500] ~ [LW-9522], 24 words in total.
Changing password directly on HMI: When [LB-9061] is set ON, the system will read data
in [LW-9500] ~ [LW-9522] to update user password. The new password will be used in
future operations. Please note that the user operable object classes will not be changed
due to the change of password.
11-1
Index Register
11-2
Index Register
11.1.
Overview
EasyBuilder Pro provides Index Registers for changing addresses flexibly. With Index Registers,
user can change the objects read/write address directly on HMI without changing its settings.
There are 32 Index Registers, divided into 16-bit and 32-bit.
The corresponding address of 16-bit Index Register 0 to 15: LW-9200 (16bit) to LW-9215 (16bit)
The maximum offset range is 65536 words.
The corresponding address of 32-bit Index Register 16 to 31: LW-9230 (32bit) to LW-9260
(32bit)
The maximum offset range is 4294967296 words.
When using [Index register], the address is designated by the following equation:
The constant set in [Address] + the value in the chosen Index Register.
Note
11.2.
Index Registers work for the Word registers. For Bit registers, adding 1 to the value in the
Index Register, the offset is 16 bits.
The following explains the way to designate the register while Index Register is used.
If not selecting [Index register] check box and set address to [LW-10]. The system will directly
EasyBuilder Pro V5.01.02
11-3
Index Register
If select [Index register] check box and set [Index] to [INDEX 0 (16-bit)]. The system will read /
write [LW(10 + value in Index Register 0)].
If the data in [LW-9200] is 5, the designated address is [LW(10+5)] = [LW-15].
11-4
Index Register
Example 1
The following shows an example of using a Word register and select [Index register]. If the
value in [LW-0] is 0, in [LW-10] is 3, and in [LW-20] is 6, the result is:
If the value in Index 0 (LW-9200) is 10, then [LW0 + Index 0] = read [LW-10] = 3.
Example 2
The following shows an example of using a Bit register and select [Index register].
If the state of [LB-16] is ON, and the state of [LB-32] is OFF.
Since 1 Word = 16 Bit, adding 1 in Index Register, the offset is 16 bits.
If Index 6 (LW-9206) is set to 1, then switch [LB-0 + Index6] reads LB-16 which is in ON state.
If Index 6 (LW-9206) is set to 2, then switch [LB-0 + Index6] reads LB-32 which is in OFF state.
11-5
Index Register
Note
When using Index Registers for Bit register, the offset is 16 bits. For example, if the Bit
register is LB-0, and set the value in Index Register to 1, then LB-16 will be activated. If set
the value in Index Register to 2, then LB-32 will be activated.
Click the icon to download the demo project. Please confirm your internet connection.
12-1
12-2
12.1.
Overview
Numeric Input and ASCII Input objects need keyboard as an input tool. Both numeric keyboard
and ASCII keyboard are created with Function Key object. Apart from the keyboards provided
by EasyBuilder Pro, you can create the keyboard if needed.
The types of the keyboards are:
UNICODE Keyboard
Note
cMT Series uses the built-in keyboard of iPad which cannot be customized. Please skip this
chapter if cMT Series is used.
12.2.
1.
Create and open a window for the new keyboard. For example, set to window no. 200.
2.
Adjust the height and width of window no. 200 and create a variety of Function Key
objects in [ASCII/UNICODE mode].
12-3
3.
Select a suitable picture for each Function Key object and place a picture object at the
bottom layer as a background.
4.
Select [System Parameter Settings] [General] [Keyboard] [Add] to add window no.
200. Up to 32 keyboards can be added.
5.
After the keyboard window is added, when you create Numerical Input and ASCII Input
objects, 200. Keyboard can be found in *Data Entry+ *Keyboard+ *Window no.+. The
EasyBuilder Pro V5.01.02
12-4
[Popup position] is for designating the display position of the keyboard on the HMI screen.
The system divides the screen into 9 areas.
6.
Select 200.Keyboard. When you press Numerical Input or ASCII Input objects on the
screen, window no. 200 will pop up. You can press the keys on the keyboard to enter
data.
12-5
12.3.
1.
Create a Direct Window object and set a read address to activate it.
In [General] [Attribute] select [No title bar] and the correct [Window No.].
2.
Open the [Profile] tab to set the same size as the created keyboard window.
3.
Create a Numeric Input object, and dont select [Use a popup keypad] check box.
12-6
4.
Create a Set Bit object, set address to [LB-0] and set [Set style] to [Set ON]. Overlay it on
the Numeric Input object. Pressing the Numeric Input object will open the keyboard
window.
5.
Add Set Bit objects on the [Enter] and [ESC] Function Key objects respectively. Set address
to [LB-0] and [Set style] to [Set OFF]. In this way when pressing either [Enter] or [ESC] key
will close the keyboard window.
12.4.
You can also place a fixed keyboard on the screen instead of popup keyboard or Direct Window.
This type of keyboard cant be moved or closed.
1.
2.
3.
Create a Numeric Input object, in [Data Entry] [Keyboard] dont select [Use a popup
keypad] check box.
Use Function Key objects to design the keyboard and place it on the screen.
Press the Numeric Input object and enter a value with Function Key objects directly.
12-7
12.5.
The following steps explain how to create a UNICODE keyboard with Function Key objects.
1. Place an ASCII Input object on the window and select [Use UNICODE] check box.
2. Create Function Key objects as shown in the following figure, and an [Enter] key. A simple
UNICODE keyboard is created.
Note
You can group up the elements of the designed keyboard and save to Group Library for
future use.
13-1
Objects
13. Objects
This chapter explains how to use different objects.
13.1.
13.2.
13.3.
13.4.
13.5.
13.6.
13.7.
13.8.
13.9.
13.10.
13.11.
13.12.
13.13.
13.14.
13.15.
13.16.
13.17.
13.18.
13.19.
13.20.
13.21.
13.22.
13.23.
13.24.
13.25.
13.26.
13.27.
13.28.
13.29.
13.30.
13.31.
13.32.
13-2
Objects
13-3
Objects
13.1.
Bit Lamp
13.1.1.
Overview
Bit Lamp object displays the state of a designated bit address. If the bit state is OFF, the State 0
shape will be displayed. If the bit state is ON, the State 1 shape will be displayed.
13.1.2.
Configuration
Click the Bit Lamp icon on the toolbar to open a Bit Lamp object property dialog box. Set up
the properties, press OK button, and a new Bit Lamp object will be created.
General Tab
13-4
Objects
Setting
Description
Comment
Read address
Blinking
13-5
Objects
13.2.
Word Lamp
13.2.1.
Overview
Word Lamp object displays the state according to the value of a designated word register. Up to
256 states are available. When the value of the register is 0, State 0 appearance of the object is
displayed, and with the register value being 1 the object displays State 1, and so on.
13.2.2.
Configuration
Click the Word Lamp icon on the toolbar to open a Word Lamp object property dialog box. Set
up the properties, press OK button, and a new Word Lamp object will be created.
13-6
Objects
General Tab
Setting
Description
Comment
Mode / Offset
13-7
Objects
LSB
Convert the value from decimal to binary. The least significant
active bit in a binary data word selects the state displayed.
Decimal
0
Read address
Attribute
Binary
0000
0001
0010
0011
0100
0101
0110
0111
1000
Displayed state
State 0 displayed. All the bits are 0.
State 1 displayed. The least significant
active bit is bit 0.
State 2 displayed. The least significant
active bit is bit 1.
State 1 displayed. The least significant
active bit is bit 0.
State 3 displayed. The least significant
active bit is bit 2.
State 1 displayed. The least significant
active bit is bit 0.
State 2 displayed. The least significant
active bit is bit 1.
State 1 displayed. The least significant
active bit is bit 0.
State 4 displayed. The least significant
active bit is bit 3.
Note
In [Label] tab, Language 1 determines the relevant settings of the font. For Language 2~8,
only the font size can be changed and other settings follow Language 1.
13-8
Objects
13-9
Objects
13.3.
Set Bit
13.3.1.
Overview
The Set Bit object provides two operation modes: manual or automatic. Manual mode can
trigger a designated bit address to change the state between ON and OFF when the object is
touched. In automatic mode, the bit is automatically activated when a pre-defined condition
occurs; touching the button will not be effective.
13.3.2.
Configuration
Click the Set Bit icon on the toolbar to open a Set Bit object property dialog box. Set up the
properties, press OK button, and a new Set Bit object will be created.
General Tab
Setting
Description
Write address
13-10
Objects
Mode / Offset
Macro
Momentary
Periodical toggle
Set ON when
window opens
Set ON when
window closes
window opens.
window closes.
Set ON when
Set the bit ON when the backlight is turned
backlight on
ON.
(N/A for cMT)
Set OFF when
Set the bit OFF when the backlight is turned
backlight on
ON.
(N/A for cMT)
Set ON when
Set the bit ON when the backlight is turned
backlight off
OFF.
(N/A for cMT)
Set OFF when
Set the bit OFF when the backlight is turned
backlight off
OFF.
(N/A for cMT)
Set Bit object can trigger the start of a Macro routine when the
Macro has been created in advance.
For more information, see 18 Macro References.
Trigger mode
13-11
Objects
13.4.
Set Word
13.4.1.
Overview
The Set Word object provides two operation modes: manual or automatic. Manual mode can
change the value in a designated word address when the object is touched. In automatic mode,
the word register is automatically activated when a pre-defined condition occurs; touching the
button will not be effective.
13.4.2.
Configuration
Click the Set Word icon on the toolbar to open a Set Word object property dialog box. Set up
the properties, press OK button, and a new Set Word object will be created.
General Tab
13-12
Objects
Setting
Description
Write address
Notification
Attribute
Set Style
Select the button action from the drop down list, see Example 2.
Dynamic limits
Set the [Bottom limit] and [Upper limit] by a designated register,
see Example 1.
Example 1
Set the [Bottom limit] and [Upper limit] by a designated register. When Dynamic Address is
LW-n, where n is an arbitrary number, the rule of setting Upper / Bottom limit is:
Content
16-bit
32-bit
Dynamic address
LW-n
LW-n
Bottom limit
LW-n
LW-n
Upper limit
LW-n+1
LW-n+2
When Dynamic Address is LW-100, the rule of setting Upper / Bottom limit is:
Content
16-bit
32-bit
Dynamic address
LW-100
LW-100
Bottom limit
LW-100
LW-100
Upper limit
LW-101
LW-102
Example 2
The available button actions are:
Write constant value
Preset a register with the value entered. Each time when the button is pressed, it writes the
[Set value] to the designated register. Data format is as set by the [Write address]; it can be
16-bit BCD, 32-bit BCD, 32-bit float. As shown below, when the button is pressed, preset the
register with 12.
EasyBuilder Pro V5.01.02
13-13
Objects
13-14
Objects
Periodic JOG++
This automatic function increases the value in the register by a set amount: [Inc. value], at a set
rate: [Time interval], to the [Upper limit]. As shown below, the system will automatically
increase the value in the register by 1 every 0.5 second, till the value is 10. Then the value
returns to 0 and add 1 every 0.5 second again.
Automatic JOG++
This automatic function increases the value in the register by a set amount: [Inc. value], at a set
rate: [Time interval], to the [Upper limit].then holds this value. As shown below, the system will
automatically increase the value in the register by 1 every 0.5 second, till the value is 10, and
then stop.
Automatic JOG--
This automatic function decreases the value in the register by a set amount: [Dec. value], at a
set rate: [Time interval], to the [Bottom limit].then holds this value. As shown below, the
system will automatically increase the value in the register by 1 every 0.5 second, till the value
is 10, and then stop.
13-15
Objects
Periodic bounce
Increases the word address value to the [Upper limit] by a [Inc. value] at a set rate in [Time
interval], then decreases to the [Bottom limit] by the same value at the same rate. As shown
below, the system will increase the value in the designated register by 1 every 0.5 second, till
the value is 10, and then decrease the value by 1 every 0.5 second till the value is 0 whenever
the screen is active.
Periodic step up
Step up to the [High limit] by [Inc. value] at a set rate in [Time interval], then reset immediately
to the [Low limit]. The action repeats whenever the screen is active. As shown below, the
system will increase the value in the designated register by 1 every 0.5 second, till the value is
10, and then reset to 0 and increase again, and the action repeats.
Step down to the [Low limit] by [Dec. value] at a set rate in [Time interval], then reset
immediately to the [High limit]. The action repeats whenever the screen is active. As shown
below, the system will decrease the value in the designated register by 1 every 0.5 second, till
the value is 0, and then reset to 10 and decrease again, and the action repeats.
13-16
Objects
Cyclic JOGEach time when the button is pressed, decrease the word address value to the [Bottom limit]
by [Dec. value] then reset to the [Upper limit]. As shown below, each time when pressing the
button, the system will decrease the value in the designated register by 1, till the value is 0,
and then reset to 10 and decrease again by pressing the button.
Cyclic JOG++
When the button is held longer than a set time in [JOG delay], it increases the value in a
register by a set amount in [Inc. value] at a set rate in [JOG speed], to the [Upper limit], then
reset to the [Bottom limit]. As shown below, when the button is held longer than 0.5 second,
increase the value in the designated register by 1 every 0.1 second, till the value is 10, and then
EasyBuilder Pro V5.01.02
13-17
Objects
Cyclic JOG- When the button is held longer than a set time in [JOG delay], decrease the value in a register
by a set amount in [Dec. value] at a set rate in [JOG speed], to the [Bottom limit], then reset to
the [Upper limit]. As shown below, when the button is held longer than 0.5 second, decrease
the value in the designated register by 1 every 0.1 second, till the value is 0, and then reset to
10 and decrease again by holding the button.
13-18
Objects
13.5.
Function Key
13.5.1.
Overview
The Function Key object can be used for several tasks, such as switching between windows,
keypad design, Macro execution, screen hardcopy, and setting USB security key.
13.5.2.
Configuration
Click the Function Key icon on the toolbar to open a Function Key object property dialog box.
Set up the properties, press OK button, and a new Function Key object will be created.
General Tab
cMT Series
13-19
Objects
Setting
Description
Activate
after button
is released
Change
window
Execute
Macro
Select this check box to execute one of the Macros from the drop
down list that has already been configured by users.
EasyBuilder Pro V5.01.02
13-20
Objects
Window title
bar
Hard copy
screen to
USB disk, SD
card or
Print the current window. Before using this function, choose a printer
model in [System Parameter Settings] [Model] [Printer].
If a monochrome printer is used, selecting [grayscale] can provide a
better print result, but the text may not be clearly printed. To
printer
Screen hard
copy
(cMT Series)
Acknowledge
all events
(alarms)
(cMT Series)
Import user
data / Use
[USB
Security Key]
13-21
Objects
Data Position
Select the external device to store data from [SD card] or [USB disk].
Account import mode
If [Overwrite] is selected, the existing accounts will be overwritten
with new accounts in the external device after importing. If [Append]
is selected, HMI will append more accounts while the old accounts
still exist.
Delete file after importing user accounts
If select this check box, the system will delete the account data saved
in the external device after importing, this can prevent the account
data from leaking out.
Notification
Note
[Overwrite] is the only option when importing the e-mail contacts. This means that all
existing contacts will be removed first, and then the new contacts are added.
For more information, see 6 Window Operations, 12 Keypad Design and Usage, 36
Administrator Tools.
13-22
Objects
13.6.
Toggle Switch
13.6.1.
Overview
Toggle Switch object is a combination of Bit Lamp object and Set Bit object. The appearance of
the object is controlled by the ON / OFF state of the read bit address. As well, pressing the
button sets the value in the bit address according to the settings.
13.6.2.
Configuration
Click the Toggle Switch icon on the toolbar to open a Toggle Switch object property dialog. Set
up the properties, press OK button, and a new Toggle Switch object will be created.
General Tab
13-23
Objects
Setting
Description
Comment
Read address
Write address
Attribute
Macro
Momentary
Toggle Switch object can trigger the start of a Macro routine when
the Macro has been created in advance.
For more information, see 18 Macro References.
13-24
Objects
13.7.
Multi-State Switch
13.7.1.
Overview
Multi-state Switch object is a combination of Word Lamp object and Set Word object. The
appearance of the object is controlled by the value of the read word address. As well, pressing
the button sets the value in the word address according to the settings.
13.7.2.
Configuration
Click the Multi-State Switch icon on the toolbar to open a Multi-State Switch object property
dialog box. Set up the properties, press OK button, and a new Multi-State Switch object will be
created.
General Tab
cMT Series
13-25
Objects
Setting
Description
Comment
Model /
Offset
Read address
Write address
Attribute
Switch style
Select the objects operation mode, see Example 1.
User-defined mapping
The value placed in the write register of each selection, the action
taken when an illegal value is entered, and error notification to a
designated bit address can be set.
13-26
Objects
current state.
Jump to error state
If an illegal value is entered, Multi-state Switch will jump to the
error state.
Error notification
If an illegal value is entered, automatically set the value placed in
the designated register.
Send
notification
after writing
After the system successfully writes data to PLC, the designated bit
address will be set On/Off.
successfully
Error handling
(cMT-SVR
Series)
Example 1
JOG+
Increase the value of a designated register by 1 each time when pressing the button, till the
value equals to [No. of states]. A cyclic action can be enabled. As shown below, each time
when pressing the button, the state number will add 1 start from state 0, till state 4 ([no. of
state]-1), and returns to 0 and step up again.
JOGDecrease the value of the designated register by 1 each time when pressing the button, till the
value equals to 0. A cyclic action can be enabled. As shown below, each time when pressing the
button, the state number will minus 1 start from state 4 ([no. of state]-1), till state 0, and
returns to state 4 and step down again.
13-27
Objects
13.8.
Slider
13.8.1.
Overview
Slider object is used to change the value in a designated word register address by moving the
slide on the screen.
13.8.2.
Configuration
Click the Slider icon on the toolbar to open a Slider object property dialog box. Set up the
properties, press OK button, and a new Slider object will be created.
General Tab
Setting
Description
Write address
13-28
Objects
Slider object. Users can also set address in [General] tab while
adding a new object.
Notification
Watch
address
When moving the roller, the new value written to the word register
address can be displayed in real time.
Outline Tab
Setting
Description
Attribute
Direction
Select the direction of the slider. (Right, Up, Left, Down)
EasyBuilder Pro V5.01.02
13-29
Objects
Resolution
Sets the value change in the word register for each step of the
Slider. For example, if set to 10, the register value changes by 10
points for each increment or decrement on the Slider.
Constant
Sets the range of the Slider. For example, If set [Low limit] to 5, and
[High limit] to 100, the Slider will enter values between 5 and 100.
Address
Set the [Low/High limit] by a designated register, see Example 1.
Coarse increment
Apart from moving the roller to change the value as in [Resolution],
if this option is selected, the word value will increase / decrease by
the [Increment] value each time the object is touched.
Slider button
type
13-30
Objects
Example 1
Set the low or high limit by a designated register. When write address is LW-n, where n is an
arbitrary number, the rule of setting limits is:
Content
16-bit
32-bit
Address
LW-n
LW-n
Low limit
LW-n
LW-n
High limit
LW-n+1
LW-n+2
16-bit
32-bit
Address
LW-100
LW-100
Low limit
LW-100
LW-100
High limit
LW-101
LW-102
13-31
Objects
13.9.
Numeric
13.9.1.
Overview
Numeric object can be used to input or display the value of a designated word register.
13.9.2.
Configuration
Click the Numeric icon on the toolbar to open a Numeric object property dialog box. Set up the
properties, press OK button, and a new Numeric object will be created.
General Tab
13-32
Objects
Setting
Allow input
Read / Write
use different
address
Read address
Description
If selected, the input features and relevant settings are enabled.
Set [Read address] and [Write address] differently.
Click [Setting] to select the [PLC name], [Address], [Device type],
[System tag], [Index register] of the word device that displays the
value. Users can also select a tag defined in Address Tag Library..
Write address
Select the [PLC name], [Device type], [Address] of the word device
that system writes to.
Notification
Notification
on invalid
input
13-33
Objects
Setting
Description
Mode
Touch
Used when data entry is initiated by touching the screen object.
Bit control
Used when data entry is enabled by turning ON a designated bit,
and entry ends when the bit goes OFF.
Allow input
bit address
Specify a bit address that enables or ends data entry. The order of
data entry is specified in [Input order] and an external USB
keyboard is needed for data entry. For cMT-SVR, use iPads
keyboard.
Input order
Keyboard
(For eMT, iE,
XE, mTV
Series)
Note
13-34
Objects
Example 1
This example demonstrates how to use [Input Order] and [Group] to perform continuous input
in several Numeric objects. After entering data in one object, entry will be passed to the next
input order object which is in the same group.
1. Create three Numeric objects, and set [Input order] to 1, 2, and 3 respectively. Include
the three objects in [Group 1] as shown in the following figure.
LW-0
LW-1
LW-2
Group1
Order1
2.
Order2
Order3
When finish entering data in the last object, to end data entry of all objects, please select
[Stop sequential input function after input] check box.
13-35
Objects
Setting
Description
Display
Data Format
Set the data format of a designated word register. The selections
include: BCD, HEX, Binary, Unsigned, Signed, Float. 16-bit uses 1
word where 32-bit uses two words.
Mask
If selected, any values entered will be hidden by displaying them as
****.
Number of
digits
13-36
Objects
Display
format
tab will be disabled. Each * sign represents each digit that will be
displayed in the Numeric object. Apart from * signs, extra texts
can be entered in the [Format] field, for example: kg.
The numeric value represented by * sign will be displayed from
the highest digit to the lowest in the Numeric object.
Truncated digits
Specify the number of digis to be truncated, from the lowest digit to
the highest.
The number of * signs = [Left of decimal Pt.]-[Truncated digits]
Please see the following examples:
Scaling
Interpolation
If this check box is selected, [Engineering low] and [Engineering
high] boxes appear. Values entered in these boxes correspond to the
display range required. The setting also requires [Input low] and
[Input high] in the limits section. See Example 2.
Test: Preview the result of Interpolation. See Example 2.
Dynamic scales: Set the [Engineering low] and [Engineering high] by
a designated register. See Example 4.
Macro subroutine (Not available for cMT Series)
The value read from or written to the register can be computed by
macro subroutines selected in [Read conversion] and [Write
conversion]. The macro subroutines should be diefined in Macro
EasyBuilder Pro V5.01.02
13-37
Objects
Function Library. To use this feature, see 13.9.2.1 The rule of using
Macro subroutine.
Other options
(For cMT
Series)
Limits
This section allows users to apply display limits to the values held in
the input register. The color when the register value is outside limits
can be set.
Direct
Sets the limits by entering values in [Input low] and [Input high]. If
the value entered is outside the limits, the value in the register
cannot be changed.
Dynamic limits
Set the limits by a designated register, see Example 5.
Use alarm
color
Low limit
When the value in the register is outside the [Low limit], display
digits by the color set.
High limit
When the value in the register is outside the [High limit], display
digits by the color set.
Blink
When the value in the register is outside either limit, the digits flash.
short
16-bit Signed
Int
32-bit Signed
EasyBuilder Pro V5.01.02
13-38
Objects
unsigned short
unsigned int
float
32-bit Float
For example, if the data format of the numeric object is 16-bit Unsigned, only the
corresponding Macro data type: unsigned short, is available.
Examples:
sub char test(unsigned short a) // (Correct)
sub char test(char a) // (Incorrect)
Supports only the local HMI address.
Examples:
GetData(var, "Local HMI", LB, 0, 1) // (Correct)
GetData(var, "MODBUS RTU", 0x, 0, 1) // (Incorrect)
The following system defined functions are unable to be invoked:
ASYNC_TRIG_MACRO, SYNC_TRIG_MACRO, DELAY, FindDataSamplingDate,
FindDataSamplingIndex, FindEventLogDate, FindEventLogIndex, INPORT, INPORT2, OUTPORT,
PURGE, TRACE
The following statements are not supported:
For-Next, While-Wend
Example 2
If [Interpolation] is selected, the scaling equation is as the following:
If A indicates the original data and B indicates the displayed data:
B = [Engineering low] + (A - [PLC low]) ratio
where, ratio = ([Engineering high] - [Engineering low]) / ([PLC high] - [PLC low])
As shown below, the original data is 15, after conversion, 40 will be displayed.
13-39
Objects
Click [Test] button to preview the result of Interpolation. Enter a value in [PLC] field as shown in
the following figure, for example, enter value 15, and the result, which is 40, will be displayed.
Example 3
If the numeric format selected is not Float and decimal point is used, the decimal place of the
converted result will not be adjusted automatically, please adjust [Engineering high] to
correctly place the decimal point of the result gained in [Interpolation] mode. Please see the
illustration below.
1. Create two Numeric objects, set [Right of decimal Pt.] to 1 and select [Interpolation]
method for one of the objects as shown in the following figure.
13-40
Objects
2.
Enter value 123, the object set to [Interpolation] displays 246.0 instead of 24.6.
3.
To move the decimal point one place to the left, adjust [Engineering high] as shown in the
following figure.
Example 4
If [Interpolation] is selected, set the [Engineering low] and [Engineering high] by a designated
register. When Dynamic Address is LW-n, where n is an arbitrary number, the rule of setting
[Engineering low] and [Engineering high] is:
13-41
Objects
Content
16-bit
Dynamic address
LW-n
Engineering low
LW-n
Engineering high
LW-n+1
When address is LW-100, the rule of setting limits is:
Content
Dynamic address
Engineering low
Engineering high
16-bit
LW-100
LW-100
LW-101
32-bit
LW-n
LW-n
LW-n+2
32-bit
LW-100
LW-100
LW-102
Example 5
Set the limits by a designated register. When [Address] is LW-n, where n is an arbitrary number,
the rule of setting limits is:
Content
16-bit
Address
LW-n
Low limit
LW-n
High limit
LW-n+1
When address is LW-100, the rule of setting limits is:
Content
Address
Low limit
High limit
16-bit
LW-100
LW-100
LW-101
32-bit
LW-n
LW-n
LW-n+2
32-bit
LW-100
LW-100
LW-102
Example 6
The following demonstrates how to use [Macro subroutine] for scaling when configuring
Numeric object.
The following two macros are used, one for [Read conversion] and one for [Write conversion].
1.
Create two Numeric objects: NE_0 and NE_1 and use the same control address. Select
[Macro subroutine] for NE_1.
13-42
Objects
2.
Enter 0 in NE_0 then NE_1 will execute [Read conversion]. The value gained will be 10.
3.
Enter 80 in NE_1, [Write conversion] is executed and the value gained will be 70. NE_0
displays 70.
Note
If executing [Read conversion] and [Write conversion] by the same numeric object, the
value entered in this object is computed by the Macro subroutine of [Write conversion]
first, and then the result is computed by the Macro subroutine of [Read conversion]. In
EasyBuilder Pro V5.01.02
13-43
Objects
Setting
Description
Color
When the value is within the limits, display digits using color set in
this tab.
Align
Size
13-44
Objects
13.10. ASCII
13.10.1. Overview
ASCII object can be used to input or display ASCII or UNICODE characters held in designated
word registers.
13.10.2. Configuration
Click the ASCII icon on the toolbar to open an ASCII object property dialog box. Set up the
properties, press OK button, and a new ASCII object will be created.
General Tab
13-45
Objects
Setting
Allow input
Description
Mask
Use UNICODE
Reverse
high/low byte
Read address
No. of words
Select the maximum number of words to be displayed.
Note
An UNICODE character uses 1 word, and an ASCII character uses 1 byte. Therefore 1 word
can be used as 1 UNICODE character or 2 ASCII characters. (1 word equals to 2 bytes)
13-46
Objects
Font Tab
Setting
Description
Attribute
13-47
Objects
Click the Indirect Window icon on the toolbar to open the object property dialog box. Set up
the properties, press OK button, and a new Indirect Window object will be created.
General Tab
cMT Series
13-48
Objects
Setting
Description
Read address
Attribute
Style
Set the display style of the pop-up window. There are two styles:
No title bar
The pop-up window has no title bar and cannot be dragged.
Use window
no. offset
Sets the offset of the window number for selecting the pop-up
window. The window number of the pop-up window is calculated
by the value in the word register added to the offset. For example,
assume the value in the register is 20 and offset is 5, the pop-up
window number will be 25.
Auto. adjust
window size
Example 1
Here is an example of using Indirect Window. The setting is shown in the following figure, set
the address to LW-0 which assigns the window number. Create window no. 11 and 12 first.
1. Create an Indirect Window object, set address to LW-0, and select [Auto. adjust window
size].
EasyBuilder Pro V5.01.02
13-49
Objects
2.
3.
4.
5.
Enter value 11 in LW-0, the pop-up window displayed is window no. 11.
Enter value 12 in LW-0, the pop-up window displayed is window no. 12.
Enter value 0 in LW-0, the pop-up window is closed.
To close the pop-up window, apart from entering 0 in the designated word register, another
way is to place a Function Key object in the pop-up window, and set the key to [Close window].
Note
13-50
Objects
Click the Direct Window icon on the toolbar to open a Direct Window object property dialog
box. Set up the properties, press OK button, and a new Direct Window object will be created.
General Tab
cMT Series
13-51
Objects
Setting
Description
Read address
Attribute
Style
Define the pop-up window style. Two styles are available, [No title
bar] and [With title bar].
Window no.
Set the pop-up window number.
Example 1
Here is an example to explain how to use the Direct Window object. The following figure shows
the settings of the Direct Window object. In the example, use LB-10 to call up window no. 35.
If the state of LB-10 turns to ON, window no. 35 will pop up; if the state of LB-10 turns to OFF,
window no. 35 will be closed, as shown in the following figure.
13-52
Objects
Note
The system does not allow opening the same window with two Direct (or Indirect) Windows
in one base window.
If the pop up window has monopoly property enabled, then when the window pops up, all
background windows may not be operated until the monopolizing window has been closed.
13-53
Objects
Click the Moving Shape icon on the toolbar to create a Moving Shape object. Set up the
properties, press OK button, and a new Moving Shape object will be created.
General Tab
Setting
Description
Read address
13-54
Objects
also set the address in [General] tab while adding a new object.
Attribute
Display ratio
Limit address
The objects moving range can be set by adjusting the data in the
designated register, see Example 1.
Example 1
Supposed that the objects moving range is limited by register LW-n, the addresses in the
following table are used to limit the moving range.
13.13.2.1.
Data format
16-bit
32-bit
[Min. X] address
LW-n
LW-n
[Max. X] address
LW-n+1
LW-n+2
[Min. Y] address
LW-n+2
LW-n+4
[Mas. Y] address
LW-n+3
LW-n+6
Illustration of Modes
Data format
16-bit
32-bit
Object state
LW-n
LW-n
LW-n+1
LW-n+2
Y axis only
The object is only allowed to move along the Y-axis. The moving distance ranges from [Min. Y]
to [Max. Y].
EasyBuilder Pro V5.01.02
13-55
Objects
Data format
16-bit
32-bit
Object state
LW-n
LW-n
LW-n+1
LW-n+2
X & Y axis
The object is allowed to move along the X-axis and Y-axis. The moving range in X and Y
directions is defined by [Min. X], [Max. X] and [Min. Y], [Max. Y] respectively.
Data format
16-bit
32-bit
Object state
LW-n
LW-n
LW-n+1
LW-n+2
LW-n+2
LW-n+4
For example, if the objects read address is LW-100 and the data format is [16-bit Unsigned],
LW-100 is used to control the objects state, LW-101 is used to control the objects moving
distance on the X-axis, and LW-102 is used to control the objects moving distance on the Y-axis.
The following figure shows that the objects read address is LW-100 and initial position is (100,
50). To move the object to the position (160,180) and change its state to State 2, assign 2 to
LW-100, 160-100 = 60 to LW-101, 180-50 = 130 to [LW102].
13-56
Objects
X axis w/ scaling
The object moves in X-axis only with scaling. Suppose that the value of the designated register
is DATA, the system uses the following equation to calculate the moving distance on the X-axis.
[Scaling high]-[Scaling low]
Displacement=(Data-[Input low])
[Input high]-[Input low]
Data format
16-bit
32-bit
Object state
LW-n
LW-n
LW-n+1
LW-n+2
Y axis w/ scaling
The object is for Y axis movement with scale, and the equation to calculate the moving
distance on the Y-axis is the same as the one in [X axis w/ scaling].
Data format
16-bit
32-bit
Object state
LW-n
LW-n
LW-n+1
LW-n+2
13-57
Objects
13.14. Animation
13.14.1. Overview
Animation object is defined by a pre-defined point set and states. Animation object will then
move to a given point in a given state defined by designated registers. The object state and
position depend on current value of two consecutive registers. The first register controls the
state of the object and the second register controls the position along the predefined path.
13.14.2. Configuration
Click the Animation icon on the toolbar. First, create the pre-defined path. Move the mouse to
each moving position, and click the left button to define positions one by one. When it is done,
right click on the screen, set up the properties, press OK button, and a new Animation object
will be created.
To change the objects attributes, double click on the object to open Animation Objects
Properties dialog box.
13-58
Objects
General Tab
Setting
Description
Attribute
No. of states
Configure the number of states for this object.
Controlled by register
Use the designated registers to control the objects state and
position. See Example 1.
Based upon time interval
The objects state and position will change from time to time. *Time
interval attributes] is used to set the time interval for states and
positions.
13-59
Objects
Example 1
The objects state and position are determined by the registers, and the addresses must be
configured correctly, as in the following table:
Data format
16-bit
32-bit
Object state
LW-n
LW-n
Object position
LW-n+1
LW-n+2
For example, if the designated register is LW-100 and the data format is [16-bit Unsigned], then
LW-100 represents objects state, LW-101 represents position. In the picture below, LW-100 = 2,
LW-101 = 3, so the objects state is 2 and position is 3.
13-60
Objects
Profile Tab
Setting
Description
Trajectory
Note
Since multiple pictures might be used by an [Animation] object, [Set to original dimension]
will not return all pictures to the original size.
13-61
Objects
Click Bar Graph icon on the toolbar to open Bar Graph dialog box. Select properties, click OK
button, a new Bar Graph object is created.
General Tab
Setting
Description
Read address
13-62
Objects
Outline Tab
Setting
Description
Attribute
Type
Choose either [Normal] or [Offset]. If [Offset] is selected, an
original value [Origin] must be entered for reference.
Direction
Determine the bar graph direction. Available options are [Up],
[Down], [Right], and [Left].
Zero / Span
The percentage of filling can be calculated by the formula, see
Example 1.
Bar width ratio (%)
It is the ratio of bar to object width. The figure below shows two
ratios, 100% and 50%.
13-63
Objects
Bar
Set the bars frame and background color, bar style, and bar color.
color/style
Target
indicator
When the register value meets the condition, the color of filled
area will change to the target color, see Example 2.
Alarm
If the register value is larger than [High limit], the color of filled
indicators
area will change to [High color]. If the register value is smaller than
[Low limit], the color will change to [Low color].
Dynamic
taget/alarm
/zero(span)
When [Enable] is selected, the [Low limit] and [High limit] of [Alarm
indicator] and the [Target Value] of [Target indicator] will use
designated registers, which is shown in their respective fields see
Example 3.
Example 1
The percentage of filling can be calculated by the following formula:
Percentage of filling =
Assume [Offset] is selected. If (Register value [Zero]) is greater than 0, the bar will fill up from
[Origin]. If (Register value Zero) is less than 0, the bar will be drawn below [Origin].
For example, [Origin] is 5, [Span] is 10, and [Zero] is 0.
For different value in read address, it will display as below:
If the value at read address is 4:
If the value at read address is 8:
13-64
Objects
Example 2
When the register value meets the following condition, the color of filled area will change to
the target color.
[Target Value] - *Tolerance+ Register value *Target Value+ + [Tolerance]
Assume [Target Value] is 5 and [Tolerance] is 1. As shown below, if the register value is equal to
or larger than 4 (=5-1) and equal to or less than 6 (=5+1), the filled areas color of the bar will
change to the target color.
Example 3
If [Dynamic target/alarm] is enabled, [Low limit] and [High limit] of [Alarm indicator] are
defined by designated registers as shown in the following table. Furthermore, if [Dynamic
zero/span] is used, [Zero], [Span] and [Origin] will be defined by designated registers. Assume
the address is LW-n, the limits are:
Data format
16-bit
32-bit
LW-n
LW-n
LW-n+1
LW-n+2
Target
LW-n+2
LW-n+4
Zero
LW-n+3
LW-n+6
Span
LW-n+4
LW-n+8
Origin
LW-n+5
LW-n+10
13-65
Objects
Click the Meter Display icon on the toolbar to open the Meter Display dialog box. Set the
objects attributes and then click OK to create a new Meter Display object.
13.16.2.1.
General Tab
Setting
Description
Read address
13-66
Objects
Outline Tab
Setting
Description
Degree
Sets the objects start degree and end degree measured clockwise
from the 12 oclock position. The angle range is 0 to 360 degrees.
The following shows meters of different settings.
13-67
Objects
Background
[Start degree] = 40
[End degree] = 140
Transparent
When selected, the object will not display the background and profile
color.
Tick marks
Pointer
Pin point
13-68
Objects
Limits Tab
Setting
Description
Value
Sets the objects display range. Meter Display object will use the
value of [Zero] and [Span] and the value of register to calculate the
pointers position. See Example 1.
Range limits
13-69
Objects
Dynamic Limits
The low limit and high limit are set by registers. See Example 2.
Scale label
16-bit
32-bit
Low limit
LW-n
LW-n
High limit
LW-n+1
LW-n+2
For instance, when address is LW-100, the rule of setting limits is:
Content
16-bit
32-bit
Low limit
LW-100
LW-100
High limit
LW-101
LW-102
13-70
Objects
13.16.2.2.
cMT Series
General Tab
Setting
Description
Style
Three options are available: [Custom], [Style 1], and [Style 2]. Click
on the text to configure the properties. If [Custom] is selected, set
the properties such as [Pointer], [Pin point], [Background picture],
etc.
EasyBuilder Pro V5.01.02
13-71
Objects
Setting
Outline
The following is the outline of Style 1 when [Full circle], [Half
circle], or [Quarter circle] is selected.
Angle
Enable
animation
Value
Read address
Indicator
Rotation
Rotates the background picture clockwise according to the angles
set.
Color
Sets the color of the background picture of meter.
Sets the range to label the scale, 0to 360clockwise or
counterclockwise from the twelve oclock position.
Full circle
If selected, the full circle is drawn according to the selected
direction and the start angle. The limits are determined by the
value set in [Minimum] and [Maximum] field under [Value].
If selected, the pointer slides to the designated position when the
read value changes; if not selected, the pointer directly points to
the designated position when the read value changes.
Sets the lower and upper limits of the meter.
Displays the value in meter according to the value in the designated
word register.
Sets the style of pointer and pin point. If [Custom] is selected, the
direction of the pointer must points upward to correctly display.
EasyBuilder Pro V5.01.02
13-72
Objects
Range limit
Scale
13-73
Objects
Click the Trend Display icon on the toolbar to open a Trend Display object property dialog box.
Set up the properties, press OK button, and a new Trend Display object will be created.
13.17.2.1.
General Tab
Button
Description
Go to the earliest sampling data.
Go to the previous time interval.
Click to stop auto-scrolling. When the new sampling data is
generated, the display does not scroll, nor is the new data outside
the display range displayed.
Click to start auto-scrolling. The display scrolls as the new sampling
data is generated.
Go to the next time interval.
Go to the latest sampling data.
13-74
Objects
Setting
Description
Data
Sampling
Object index
Trend type
13-75
Objects
latest file is record 0 (typically the data sampled today), the second
latest file is record 1, and so on. If the value of designated register
in [History control] is n, the Trend Display object will display data
record n.
Here is an example to explain [History control]. If the designated
register is LW-0, and the sampling data files available are
pressure_20061120.dtl, pressure_20061123.dtl,
pressure_20061127.dtl, and pressure_20061203.dtl, and it is
2006/12/3 today, based on the value of LW-0, the sampling data
file which will be selected by [Trend Display] is shown as follows:
Value of LW-0
pressure_20061203.dtl
pressure_20061127.dtl
pressure_20061123.dtl
pressure_20061120.dtl
If use with Option List object and select data source as [Dates of
historical data], the history data will be sorted by date and
displayed in Option List object, see 13.29 Option List.
Pixel
Time
Select [Time] for [X axis time range] and go to [Trend] [Grid] and
EasyBuilder Pro V5.01.02
13-76
Objects
enable [Time scale]. Please refer to [Time scale] in the later section.
Dynamic
distance
between data
samples/
Dynamic X
axis time
range
Refresh data
automatically
Hold control
disabled.
When scrolling to the previous data, the automatic refresh
feature is disabled, the
button is shown.
If [Refresh data automatically] check box is selected, when
change back to the window, the display is refreshed, ignoring
the control buttons. For example, select [Refresh data
automatically], and scroll to the previous data, the automatic
refresh feature is disabled. In this case, changing to another
window and then change back will still refresh the display.
If [Refresh data automatically] check box is not selected when
building the project, the feature can still be enabled by
pressing
button on HMI. In this case, the automatic
refresh feature is disabled, that is, even when change back to
the current window, the display will not be refreshed.
When the register is set ON, suspend the update of Trend Display. It
does not stop the sampling process of Data Sampling object. This
setting is available only in Real-time mode.
Watch line
Use the *Watch line+ function to display a watch line when user
touches the Trend Display object. It will also export the sampling
data at the position of watch line to the designated word device
and use Numeric objects to display the results, as shown in the
following figure.
13-77
Objects
[Watch line] can also export sampling data with multiple channels.
The system will consecutively write each channel to the specified
address and the following addresses, in the same order as in [Data
Sampling] object. The address assigned to [Watch line] is the start
address, and sampling data for each channel will be exported to
the word devices starting from start address. If the data format of
each channel is different, the corresponding address of each
channel is arranged from the first to the last. If the watch register is
LW-300, watch function will export each channels data to the
following addresses:
Register
Time stamp
output
Channel
Data format
LW-300
LW-301
LW-303
LW-305
Note
13-78
Objects
13.17.2.2.
cMT Series
General Tab
The Trend Display on cMT Series combines Real-time mode and History mode. Drag left to
scroll the Trend Display to view history data and drag right to view the latest sampling data.
Pinch two fingers together to zoom out Trend Display or spread them apart to zoom in.
Zoom In
Zoom Out
For more information about how sampling data is saved, see 8 Data Sampling.
13-79
Objects
Setting
Description
Data
Sampling
Object index
Millimeter
See 13.1.2.1.
Time
See 13.1.2.1.
Watch line
See 13.1.2.1.
13-80
Objects
Trend Tab
Setting
Description
Frame /
Background
Show scroll
controls
Grid
Set the number of dividing lines and the line color. The number of
divisions depends on the setting in General tab.
X-axis interval
The number of vertical grid lines.
Select [Pixel] / [Millimeter] in General tab:
Select how many sampling point will be included between two
vertical grid lines.
Select [Time] in General tab:
Select the time range between two vertical grid lines.
Y-axis interval
The number of horizontal grid lines.
13-81
Objects
Time scale
Select [Enable] check box to display the time scale along the x axis.
Format
The available time scale formats: HH:MM or HH:MM:SS.
Font / Color / Size
Select the font, font color, and font size of the time scale.
The default font size is 8.
Time / Date
The time of latest sampling data will be marked on the top left
corner of the object. This group box is used to set the time display
format and font color.
Channel Tab
13-82
Objects
Setting
Description
Y scale
Channel
16-bit
32-bit
Low limit
LW-n
LW-n
High Limit
LW-n+1
LW-n+2
For example, if LW-100 is used here, the low limit and the high limit
will be read from:
Data Format
16-bit
32-bit
Low limit
LW-100
LW-100
High Limit
LW-101
LW-102
13-83
Objects
Example 1
The example explains how to zoom in or zoom out Trend Display. The feature described is not
available for cMT Series.
In Channel tab select [Dynamic limits] check box. If the [Address] is set to LW-n, then LW-n
controls the low limit where LW-n+1 controls the high limit.
Set [Address] to LW-0 and create two Numeric objects for entering the low / high limit. The
address that controls the low limit is LW-0; the address that controls the high limit is LW-1.
Lets suppose the data is between 0 and 30; set the [Low limit] to 0 and the [High limit] to 30,
the trend curve is displayed as shown in the following figure.
To zoom out the Trend Display, enter a value greater than 30 in [High limit] as shown in the
following figure.
To zoom in the Trend Display, enter a value less than 30 in [High limit] as shown in the following
figure.
13-84
Objects
13.17.2.3.
Y Scale Usage
This feature is only available for cMT Series. The scale along the Y axis of a specific channel can
be displayed. To enable Y Scale, [Grid] should first be enabled in [Trend] tab. Y Scale can be
configured on the iPad as shown in the following steps.
1.
Tap the
2.
3.
13-85
Objects
13.18.2. Configuration
Click the History Data Display icon on the toolbar to open a History Data Display object
property dialog box. Set up the properties, press OK button, and a new History Data Display
object will be created.
13-86
Objects
General Tab
Setting
Data
Sampling
object index
Grid
Description
Select a Data Sampling object as the source data.
Shows grids between rows and columns.
Color
Change the color of grids.
Column interval
Change the width of each column. The figures below are the
examples.
13-87
Objects
Profile color
Time / Date
Enable or disable showing the time and date and configure its
format.
Time ascending
Put earlier data at the top and the latest data at the bottom.
Time descending
Put the latest data at the top and the earlier data at the bottom.
History
Control
(eMT, iE, XE,
mTV Series)
The history files are sorted by date and each file is given an index.
The latest one is assigned index 0 (in most cases: today), the
second latest file is assigned index 1, and so on. [History Control] is
used to specify the history data to be shown.
Note
When using cMT-SVR, use the filter icon in the upper-right corner of History Data Display
object on iPad to select the date and display the data.
13-88
Objects
Setting
Channel
Description
Each History Data Display object can display up to 64 channels.
Check [Display] to select the channels to be shown on the screen.
In the figure above, there are 4 channels (channel 0 to channel 3) in
the Data Sampling object, and only Ch.0 and Ch.3 are selected. The
data formats are shown next to channel name. The data format of
each channel is decided by the corresponding Data Sampling
objects. The result is shown below:
13-89
Objects
Title Tab
Setting
Use title
Description
Title
background
Transparent
When selected, hide the background for title area.
Color
Set the background color of title.
Defines the text to be shown on the title.
Label Tag Library can be used for title in order to display the title in
multiple languages. Click [Setting] and select [Use label library].
Setting
13-90
Objects
Note
During off-line simulation, if the format of sampling data has been changed, please delete
previous data records in C:\[EasyBuilder Pro directory]\HMI_memory\datalog to prevent
the system from misinterpreting the old data records.
13-91
Objects
13-92
Objects
General Tab
Setting
Description
Comment
No. of
channel
Set the no of channel for this object. Each channel represents one
data block. The maximal number of channels is 12.
Cursor Line
Channel
Control
address
13-93
Objects
Limit
devices in each data block, i.e. the number of data. The maximum
value is 1024.
Data storage start address
If [Offset to start address] is enabled, the [Offset value storage
address] will be set as [Control address] + 2.
If select 16-bit data format, the address for each data will be start
address, start address + 1, start address + 2 and so on.
If select 32-bit data format, the address for each data will be start
address, start address + 2, start address + 4 and so on.
For more information about control address, see Example 2 to 5.
Set the minimum and maximum limit for the curve.
Note
The system can draw at most N curves, where N = 32 divided by the number of channel.
Example 1
How to use watch (Cursor Line) feature
Use Watch function to check the value of any point of the curve. When the user touches
[Data Block] object, it will display a cursor line, and the system will write the index and value
of that data on the cursor line to the designated address.
Data Format
Index Value
Channel 1 Value
Channel 2 Value
16-bit
Address
Address + 1
Address + 2
32-bit
Address
Address + 2
Address + 4
When watch address is set to LW-n, the value written into LW-n represents the channel index
number to be called up. (Start form 0)
Note
[Data Index] is a 16 bit unsigned integer. When the designated register of cursor line is 32
bit device, it will be stored in the bit 0-15.
If the channel to be viewed has no data, 0 will be displayed, as shown below. In the
example, there is no data in channel 1, when the cursor points at Data 4, 0 will be
displayed as shown below.
13-94
Objects
Example 2
How to show a data block
1. Write the number of data to *No. of data address+, i.e. Control address+1
2. Store the data consecutively beginning at [Data storage start address].
3. Write 1 to [Control address] to draw the curve without cleaning the plot. All previous
4.
Note
Do not change the content of [Control address], [No. of data address] and [Data storage
start address] between step 3 and step 4 above as doing so might cause error for the
trend curve plot.
13-95
Objects
Example 3
How to clear the graph
1. Write 2 to [Control address], all the trend curves will be cleared.
2. The system will write 0 to [Control address] after the trend curve is cleared.
Example 4
How to clear the previous trend curve and display new one
1.
2.
3.
4.
Write the number of data to [No. of data address], i.e. control address+1
Store the data consecutively beginning at [Data storage start address].
Write 3 to [Control address], the previous trend curves will be cleared and the new
content in data block will be plotted on the screen.
The system will write 0 to [Control address] after the trend curve has been plotted.
Example 5
How to use offset mode
If [Offset to start address] is selected, [Control address], [No. of data address], and [Offset
value storage address] will use 3 consecutive addresses.
For example, assume the total number of channels is 3 (start from 0 to 2), and the [Control
address] are LW-0, LW-100, and LW-200, respectively. Then, the other addresses will be set as
follows: (In the example, format 16-bit Unsigned is used and [Offset value storage address] are
all m).
13-96
Objects
Item
Channel 0
Channel 1
Channel 2
Control Address
LW-0
LW-100
LW-200
No. of data
address
LW-1
LW-101
LW-201
Offset value
storage address
LW-2 (=m)
LW-102 (=m)
LW-202 (=m)
Data 1
LW-0+m
LW-100+m
LW-200+m
Data 2
LW-1+m
LW-101+m
LW-201+m
The following figure on the left shows the result when offset mode is not used while the figure
on the right shows the result when offset mode is used.
Note
When [Control address] is set to LW-n, [No. of data address] and [Offset value storage
address] are as follows:
Data Type
16-bit
32-bit
Control address
LW-n
LW-n
LW-n+1
LW-n+2
LW-n+2
LW-n+4
If the control registers are 32-bit devices, only bit 0-15 will be used for control purpose, bit
16-31 will be ignored. (as illustrated below)
When the value in [Control address] is not zero, the system will read [No. on data address]
and [Offset value storage address].
It is recommended to use [Offset to start address] for data block display with multiple
channels and the same device type. As shown in the following figure, The control words of
13-97
Objects
channel 1 is located from LW-n, the control words of channel 2 is located from LW-n+3,
and so on.
Display Area
Setting
Description
Description
Data samples
Configure the maximal number of data samples (points) to be
displayed.
EasyBuilder Pro V5.01.02
13-98
Objects
Samples to scroll
Configure the number of data samples being scrolled.
Enable scroll switch
Clicking
Clicking
Profile
Grid
Channel
13-99
Objects
13.20. XY Plot
13.20.1. Overview
XY Plot object is used to display values for two variables (x,y) for a set of data, where the data
comes from word registers. Up to 32 channels can be displayed simultaneously. This object
facilitates data observation and analysis. Additionally, negative numbers can be displayed as
well.
13.20.2. Configuration
Click the XY Plot icon on the toolbar to open a [XY Plot] object property dialog box.
General Tab
13-100
Objects
Setting
Description
Direction
No. of
channels
Control
address
Channel
Read Address
PLC name
Select a PLC which will be the source of [X data] and [Y data] and
designate a read address.
The format of the data register blocks used for the display channels
depends on whether [Separated address for X and Y data] and/or
[Dynamic limits] has been selected. See Example 1.
Dynamic
limits
13-101
Objects
Example 1
The format of the data register blocks used for the display channels depends on whether
[Separated address for X and Y data] has been selected, and if [Dynamic limits] has been
selected. The following explains the situations where 16-bit register is used:
If [Separated address for X and Y data] is not selected, and set [Read address] to LW-n:
Select [Dynamic limits]
X data
Y data
X data
Y data
Low Limit
LW-n
LW-n+2
Constant
Constant
High Limit
LW-n+1
LW-n+3
Constant
Constant
st
LW-n+4
LW-n+5
LW-n+0
LW-n+1
nd
2 data
LW-n+6
LW-n+7
LW-n+2
LW-n+3
3rd data
LW-n+8
LW-n+9
LW-n+4
LW-n+5
LW-n+10
LW-n+11
LW-n+6
LW-n+7
1 data
th
4 data
If [Separated address for X and Y data] is selected, and set [X data] to LW-m, [Y data] to
LW-n:
Select [Dynamic limits]
X data
Y data
X data
Y data
Low Limit
LW-m+0
LW-n+0
Constant
Constant
High Limit
LW-m+1
LW-n+1
Constant
Constant
1 data
LW-m+2
LW-n+2
LW-m+0
LW-n+0
2nd data
st
LW-m+3
LW-n+3
LW-m+1
LW-n+1
rd
LW-m+4
LW-n+4
LW-m+2
LW-n+2
th
LW-m+5
LW-n+5
LW-m+3
LW-n+3
3 data
4 data
Example 2
When [Dynamic limits] is not selected, the Low and High limits can be set. The Low and High
limits are used for calculating X and Y range in percentage.
Scale (%) =
If [Separated address for X and Y data] is not selected and the address is LW-n, the
corresponding limits are retrieved from the addresses as shown in the following table.
Data format
16-bit
32-bit
LW-n
LW-n
LW-n+1
LW-n+2
LW-n+2
LW-n+4
LW-n+3
LW-n+6
EasyBuilder Pro V5.01.02
13-102
Objects
Example 3
If [Dynamic limits] is selected, a zoom effect can be created by changing the setting of Low /
High Limits.
In the following example, XL=X low limit, XH=X high limit, YL=Y low limit, YH=Y high limit, and
XY, XY1, XY2 are three XY data. When changing the high limits of X and Y axis, the result is
shown below:
Original
Note
For cMT Series, on the screen of the visualization device directly pinch two fingers
together to zoom out or spread them apart to zoom in.
X and Y data can be set to different formats. For example: If X data uses 16-bit unsigned, Y
data uses 32-bit signed, please note the address setting.
When using a Tag PLC, such as AB tag PLC, X and Y must be in the same format. When
using different formats a warning will be shown.
13-103
Objects
Setting
Description
Profile color
Curve
For each channel select the properties of color, width, and line
style.
Maker
There are four different types of XY plot. The result is shown below:
13-104
Objects
See Example 4.
Reference line
Example 4
The curve shown in the following figure is drawn with 7 points numbered from P0 to P6.
The steps the system draws the X-axis Projection are:
1. Calculates the two points in X-axis (X0, 0) and (X6, 0).
2. Link all the points in the order of (X0, 0), P0 P6, (X6, 0) and returns to (X0, 0) at last.
3. Fill out all enclosed areas.
Note
13-105
Objects
Click the Alarm Display or Alarm Bar icon on the toolbar to open the object property dialog box.
Set up the properties, press OK button, and a new object will be created.
General Tab
The difference between these two objects is that Alarm Display allows an [Acknowledge
address] and a [Scrolling control address] to be set.
13-106
Objects
Setting
Description
Enable
acknowledge
function
Scrolling
control
address
Note
When using cMT-SVR, press and hold the event on the screen to acknowledge an event;
drag a finger on the screen to scroll.
13-107
Objects
Alarm Tab
Setting
Description
Include
categories
Scroll speed
This selection is only available for Alarm Bar. Select one of the
speed settings at which the messages scroll.
Format
Time ascending
Latest alarm is placed last in the list (the bottom).
Time descending
Latest alarm is placed first in the list (the top).
Display order
Select the items to be displayed and use the up and down arrow
buttons to adjust the display order of the alarms.
Date
Displays the date tag with each alarm message. The four formats of
date tag:
MM/DD/YYDD/MM/YYDD/MM/YYYY/MM/DD
EasyBuilder Pro V5.01.02
13-108
Objects
Time
Displays the time tag with each alarm message. The four formats of
time tag:
HH:MM:SSHH:MMDD:HH:MMHH
Font Tab
Set the font size or select [Italic].
The font, color, and content of the alarm messages displayed in Alarm Bar and Alarm Display
objects are set in Alarm (Event) Log object:
Objects
13-109
13.22.2. Configuration
Click the Event Display icon on the toolbar to open an Event Display object property dialog box.
Set up the properties, press OK button, and a new Event Display object will be created.
13-110
Objects
General Tab
13.22.2.1.
Setting
Description
Mode
Acknowledge
address
13-111
Objects
History
Control
13-112
Objects
Control
address
Scrolling
control
address
13-113
Objects
13.22.2.2.
cMT-SVR Series
For cMT-SVR, all the events occur are displayed and updated in real-time.
Press the filter icon in the upper-right corner of the object and set the start and end date. If the
dates are not set, all the events are displayed.
13-114
Objects
Setting
Description
Include
categories
Acknowledge
style
Max. event
no.
Color
Grid
Displays a grid of rows and columns in the object. The color of the
grid lines can be selected.
Format
Time ascending
Latest event is placed last in the list (the bottom).
Time descending
Latest event is placed first in the list (the top).
EasyBuilder Pro V5.01.02
13-115
Objects
Font Tab
In Real-time mode: Users may select Italic font and set the font size. The font is displayed
according to the setting in Event Log object.
In History mode: Users may select Italic font and set the font size, font and color, or tick the
[Font from label library] check box.
13-116
Objects
Click the Data Transfer (Trigger-based) icon on the toolbar to open the property dialog box. Set
up the properties, press OK button, and a new Data Transfer (Trigger-based) object will be
created.
General Tab
cMT Series
13-117
Objects
Setting
Description
Source
address
Destination
address
Attribute
No. of words
The number of words to be transferred from [Source Address] to
[Destination Address]. The unit is word.
Mode
Touch trigger
Press the object to activate data transfer operation.
External trigger
The data transfer operation is activated when the state of the
designated bit address changes.
There is a further selection to make of whether the data transfer
operation is activated after Off to ON, ON to OFF transition, or at
both of the changes of state.
Trigger
address
Note
When using Data Transfer Trigger Based object, place the control bit addresses in the
same window in order to trigger Data Transfer. If the Data Transfer Trigger Based object is
placed in the common window, when the state of the control bit addresses placed in any
window changes, Data Transfer is triggered.
13-118
Objects
13.24. Backup
13.24.1. Overview
Backup object can transmit recipe data (RW, RW_A), event log, recipe database, sampling data,
and operation log to an external device (SD card, USB disk), in a specified time range or format.
For example, when the event log is saved in a SD card, a USB disk can be inserted when HMI
power is still ON, and use Backup object to copy the data into USB disk from SD card, and then
remove USB disk without turning off HMI power. The data saved in USB disk can be used on PC
for analyzing. When the system is backing up, the state of system register [LB-9039] is set ON.
With [e-Mail] option, information can be sent to configured email contacts.
13.24.2. Configuration
For eMT, iE, XE, mTV Series, click Backup icon on the toolbar to open a [Backup] object
property dialog box. Set up the properties, press OK button, and a new Backup object will be
created.
For cMT Series, click Backup icon on the toolbar to open a [Backup] object managing dialog box,
click [New] to open a [Backup] object property dialog box. Set up the properties, press OK
button, and a new Backup object will be created.
13-119
Objects
General Tab
cMT Series
Setting
Description
Source
Backup
position
Select the destination where the source files will be saved to.
SD card / USB disk
The external device connected to HMI.
If using cMT series, SD card and USB disk can only save [RW],
[RW_A], and [Recipe database].
Remote printer/backup server (eMT, iE, XE, mTV Series)
To select this, enable MT remote printer/backup server at: [Menu]
[Edit] [System Parameters] [Printer/Backup Server].
Please note that [Operation log] backup can only be saved to
Remote printer/backup server. To save into a SD card or USB drive,
13-120
Objects
0 = Event is triggered
1 = Event is acknowledged
2 = Event returns to normal
EasyConverter can be used to easily convert HMI Event Log File
(.evt) and HMI Data Log File (.dtl) to .xls or .csv format.
SQLite Database File (.db)
cMT Series:
SQLite Database File (.db)
Comma Separated Values (.csv)
Range
Within
Select the number of days. For example, [Yesterday] is selected at
[Start], and [2 day(s)] is selected here, which means the files
EasyBuilder Pro V5.01.02
13-121
Objects
obtained yesterday and the day before yesterday will be backed up.
Select [All] to save all files in the system, the maximum is 90 days.
Trigger
(eMT, iE, XE,
mTV Series)
Mode
There are three ways to activate Backup function.
Touch trigger
Touch the object to activate backup operation.
External trigger (bit)
Register a bit device to trigger the backup operation.
Select whether the backup operation is activated after Off to ON,
ON to OFF transition, or at both of the changes of state.
External trigger (word)
Users can specify the number of days to backup data using [Trigger
address]. [Trigger address] usage (suppose LW-n is used):
LW-n: Will start to back up when the value changes from 0 to 1.
LW-n+1: The start date of backup.
LW-n+2: The number of days for backup. (The maximum: 90 days).
Trigger
address
(cMT Series)
When the state of the designated register is set ON, the backup
operation is activated. When the backup operation is done, the
state of the designated register is set OFF.
Note
All history files should have been saved in memory, either HMI memory, USB disk or SD
card. Otherwise, the Backup object will not work.
The maximum number of days for backup is 90 days. (Not including cMT Series)
For cMT Series, see 7 Event Log and 8 Data Sampling that explain the mechanism of
13-122
Objects
Advance Tab
Setting
Description
Serial number
Options
Note
13-123
Objects
Click the Media Player icon on the toolbar to open a Media Player object property dialog box.
Set up the properties, press OK button, and a new Media Player object will be created.
General Tab
Setting
Description
Control
address
Selected
Designate a word register to control the object operations.
EasyBuilder Pro V5.01.02
13-124
Objects
Ext. device
Attribute
Not selected
No manual control. Video will be played automatically when the
designated window opens.
Command (control address + 0)
Enter a value in the Command register to designate which action is
executed.
Parameter 1 (control address + 1)
Enter a value in Parameter 1 associated with each command action.
Parameter 2 (control address + 2)
Enter a value in Parameter 2 associated with each command action.
Status (control address + 3)
Indicates the status or errors.
File index (control address + 4)
The file number in the designated folder. It is recommended to file
the video name with a number.
Start time (control address + 5)
The start time of the video (second). 0, normally.
End time (control address + 6)
The end time of the video (second). (The time length of the video)
Update video playing time
If enabled, the elapsed playing time of video will be written into
[Playing time] register at a rate set by [Update period] in seconds.
Update period
Update period of [Playing time], range from 1 to 60 (second).
Playing time (control address + 7)
The elapsed playing time of video (Second). Normally between
start time and end time.
Play video files in SD card / USB disk.
Folder name
The folder name of video files stored in SD card or USB disk. Files
must be stored in root directory. Subdirectories wont be accepted.
(For example, example\ex is an invalid directory.)
[Folder name] cannot be empty, must be alpha-numeric, and all in
ASCII character.
Auto. repeat
When finish playing all the video files, replay from the first file.
Ex: Video 1 > Video 2 > Video 1 > Video 2
Background
The background color of the object.
Note
The data format for control address is 16-bit Unsigned or 16-bit Signed. If using 32-bit
EasyBuilder Pro V5.01.02
13-125
Objects
Note
Note
13-126
Objects
Note
Parameter 1 (target time) must be less than the ending of time or it plays the last second.
Forward
[Command] = 7
[Parameter 1] = target time (second)
[Parameter 2] = ignore (set 0)
Note
Going forward to the designated second in [Parameter 1]. If the video is paused, the
forwarding action will be started by playing.
When the designed time is later than the end time, it plays the last second.
Backward
[Command] = 8
[Parameter 1] = target time (second)
[Parameter 2] = ignore (set 0)
Note
Going Backward to the designated second in [Parameter 1], if the video is paused, the
backward action will be started by playing.
When the designed time is earlier than the beginning time, it plays from beginning.
Adjust volume
[Command] = 9
[Parameter 1] = volume (0 ~ 128)
[Parameter 2] = ignore (set 0)
Note
13-127
Objects
Note
When playing a video the system sets [File Open (bit00)] and [File Playing (bit01)] to ON. If the
file cannot be found, or an invalid command is entered, the Command Error bit 08 is set ON. If
the file format is not supported, or a disk I/O error occurs, during playback (for example, USB
disk unplugged), the File Error bit 09 is set ON.
(0 = closed, 1 = opened)
(0 = not playing, 1 = playing)
(0 = accepted, 1 = incorrect)
(0 = accepted, 1 = incorrect)
Note
The figure shows the status value associated with each state:
Stop = 0, Pause = 1, Playing = 3
[Command], [Parameter 1], and [Parameter 2] are write addresses. All others are read
only.
13-128
Objects
Preview Tab
Users can test whether the video format is supported by using the preview function.
Setting
Description
Forward << /
Backward >>
Play / Pause
Stop
Stop playing and close the video file. To test another video, please
stop playing the current video first.
Load
Note
Click the icon to download the demo project. Please confirm your internet connection
before downloading the demo project.
13-129
Objects
cMT Series
13-130
Objects
13.26.2.1.
General Tab
Click the [New] button in the Data Transfer management dialog box.
Setting
Description
Attribute
Address type
Select the data type, either [Bit] or [Word].
No. of bits /No. of words
When [Bit] is selected in [Address type], set the number of bits
transferred each time when data transfer is triggered.
When [Word] is selected in [Address type], set the number of
words transferred each time when data transfer is triggered.
Interval
Select the time interval of data transfer, for example, when 3
seconds is set, the system will transfer data every 3 seconds.
Specifying a short time interval or a big number of data to transfer
may cause an overall performance of system decrease. Therefore, it
is recommended that users choose a longer time interval and a
smaller amount of data to transfer.
When a short interval is inevitable, be aware of the interval must
be longer than the data transfer operation. For example, if the data
transfer operation takes 2 seconds, set the interval longer than 2
seconds.
Source
address
13-131
Objects
Destination
address
13.26.2.2.
General Tab
Click the [New] button in the Data Transfer management dialog box, and open [Bit trigger] tab.
Setting
Description
Source
address
Destination
address
No. of word
Set the number of words transferred each time when data transfer
is triggered.
Trigger
Set the register that controls data transfer and select the trigger
address
mode.
Trigger mode
Trigger data transfer when the state of the designated register
changes from Off to ON, ON to OFF, or at both of the changes of
state.
13-132
Objects
Click the PLC Control icon on the toolbar to open the PLC Control Object management dialog
box. To add a PLC Control object, click [New], set up the properties, press OK button and a new
PLC Control object will be created.
Click [New] and the following dialog box appears. See 13.27.2.1 Type of Control.
Note
The [PLC Control] and [Backlight Control] options are not available for cMT Series.
EasyBuilder Pro V5.01.02
13-133
Objects
13.27.2.1.
Type of Control
Change window
Setting
Description
Select the check box and select a window offset, the new
window no. to change to will be the value in [Trigger address]
plus the offset. For example, if [Trigger address] is LW-0 and
offset is set to -10. When the value in LW-0 is 25, the system
will change to window no. 15 (25-10=15). The range of the
offset is -1024 to 1024. The [Clear data after window changed]
check box is not available if [Use window no. offset] is selected.
Note
If [LB-9017] is set ON, the write-back function will be disabled, the new window number is
not written back into a designated address.
Place a valid window number in the designated trigger address to change the base screen to
the new window number. The new window number is written back into the designated
address.
For example, if current window is window no. 10, and [Trigger address] is set to LW-0,
When LW-0 is changed to 11, the system will change the current window to window no. 11,
EasyBuilder Pro V5.01.02
13-134
Objects
Trigger address
Write address
16-bit BCD
Address
Address + 1
32-bit BCD
Address
Address + 2
16-bit Unsigned
Address
Address + 1
16-bit Signed
Address
Address + 1
32-bit Unsigned
Address
Address + 2
32-bit Signed
Address
Address + 2
Action
Four consecutive word registers are used as described in the following table:
Address
Purpose
Description
[Trigger
address]
Determine the
direction of data
transfer
[Trigger
address] +1
[Trigger
address] +2
Offset to the
start address of
PLC register
13-135
Objects
address + 4 + n].
Take an OMRON PLC as an
example:
If [Trigger address] uses DM-100,
[Trigger address + 2] will be
DM-102. If the value in DM-102 is
5, the start address of data source
would be DM-109 (100 + 4 + 5 =
109).
[Trigger
Offset to the
address] +3
start address of
LW or RW
memory in HMI
Example 1
To use PLC Control object to transfer 16 words data in OMRON PLC, starting from address
DM-100, to the HMI address, starting from RW-200. The setting is shown below:
1. Firstly, create a PLC Control object, set [Type of control] to [General PLC control], and set
2.
3.
[Trigger address] to DM-10, that is, to use the four sequential registers start from DM-10
to control data transfer.
Confirm the data size and the offset addresses.
Set DM-11 to 16, since the number of words to transfer is 16 words.
Set DM-12 to 86, which indicates the address of data source is DM-100 (100=10+4+86).
Set DM-13 to 200, which indicates the destination address is RW-200.
Set DM-10 according to the direction of data transfer.
If set DM-10 to 1, the data will be transferred from PLC to HMI RW register,
If set DM-10 to 3, the data will be transferred from HMI RW register to PLC.
13-136
Objects
Sound control
When the state of the designated [Trigger address] changes, the HMI will play the sound
selected from the sound library. There is a further selection determines whether the sound is
played after Off to ON, ON to OFF transition, or at both of the changes of state.
Execute macro program
Select a pre-defined Macro from the drop-down list. When the state of the designated [Trigger
address] changes, the selected Macro is executed. There is a further selection determines
whether the Macro is executed after Off to ON, ON to OFF transition, or at both of the changes
of state. If select [Always active when ON], the macro will be executed repeatedly. (The
shortest time interval between runs is 0.5 second.)
Screen hardcopy
When the state of the designated [Trigger address] changes, print the selected screen. If select
[SD card] or [USB disk] as [Printer], a hardcopy folder will be generated in the selected
external device for saving the printed screen in JPG format. The name of the JPG files starts
from yyyymmdd_0000.
To print the screen using a printer, go to System Parameter Settings Model tab and set the
printer.
To print the screen using a remote printer, go to System Parameter Settings Printer/Backup
Server tab and configure the parameters.
There are three options to specify the source window for hardcopy:
EasyBuilder Pro V5.01.02
13-137
Objects
Description
Folder name
File name
Note
The [Printer] setting is not available for cMT Series. The window hardcopy file is saved in
iPad Photo folder.
EasyBuilder Pro V5.01.02
13-138
Objects
A background printing procedure is performed when the printed window is not the
current base window.
If the hard-copied window is a background window, its [Direct Window] and [Indirect
Window] objects will not be printed.
When using a dynamic format name, the system will use a _ sign as a substitute for
invalid symbols.
When using a dynamic format name, if screen hardcopy is triggered without specifying
the format first, the system will save the file in the default directory, which is:
hardcopy\yymmdd_0000.JPG
13-139
Objects
13.28. Scheduler
13.28.1. Overview
Scheduler object turns bits ON/OFF, or writes values to word registers at designated start times.
It works on a weekly basis.
13.28.2. Configuration
Click the Scheduler icon on the toolbar to open the Scheduler management dialog box, click
[New] to open the Scheduler property setting dialog box.
Example 1
A motor is scheduled to power - ON at 9:00 and power OFF at 18:00, Monday to Friday.
We are using LB-100 to control the motor state. LB-100 will be set ON at 9:00 and OFF at 18:00.
1. Click the Scheduler icon on the toolbar to open the Scheduler management dialog box,
click [New].
2. In [General] tab, select [Bit ON] in [Action mode] and set [Action address] to LB-100.
3.
13-140
Objects
4.
Enter [Start] time as 9:00:00 and select Monday to Friday. Do not select [Setting on
5.
6.
individual day].
Enter [End] time as 18:00:00 and select [Enable termination action] check box.
Click [OK], a new Scheduler object will be created on the [Scheduler] list.
Example 2
A thermal heater is scheduled to heat up to 90C at 08:00 and cool down to 30C at 17:00,
Monday to Friday. LW-100 is used to store the set point value.
1. Click the Scheduler icon on the toolbar to open the Scheduler management dialog box,
click [New].
2. In [General] tab, select [Word write] in [Action mode] and set [Action address] to LW-100.
3. Select [Constant] for [Word write value settings] and enter 90 in [Start value].
4.
5.
6.
7.
8.
13-141
Objects
General Tab
Setting
Description
Power ON
start/end
action
Disabled
When the HMI is powered ON at a time later than the start time,
the start action will not be performed, but the termination action
will be performed. When the termination action is not defined, the
scheduled range is not recognized and no action is performed.
13-142
Objects
Action mode
Bit OFF
At the start time, set the designated bit OFF. At the end time, set
the designated bit ON.
Example: Start time : 09:00:00 End time : 17:00:00
Word write
The [Write start value] entered here is transferred to the
designated [Action address] word register at the start time. At end
time, the [Write end value] entered here is written to the [Action
address]. The valued can be entered manually or be set by using
[Address] mode. In [Address] mode, the value in the specified
address is the start value where the value in [Address + 1] is the
end value.
Example: Device address: LW-100
Start time: 09:00:00 End time: 17:00:00
Write start value: 10 Write end value: 0
Use register: If control address is LW-n, then enter 10 in LW-n and
enter 0 in LW-(n+1).
13-143
Objects
Note
Only is an [End time] is set in the [Time set] tab will the [Write end value] box appear.
Time Set
Specify start time and end time. [Constant] allows specifying a date or period and time.
[Address] allows controlling the time by the designated address.
Constant
Setting on individual day
If [Setting on individual day] is selected
The same start time and end time can be assigned to different days of the week.
13-144
Objects
Note
Start and end time must be entered.
Start and end time must be on a different time, or same time but different day.
If [Setting on individual day] is not selected
Start time and end time entered must start and end within 24-hours.
Note
Start time and end time must be on a different time, different day.
If an end time is earlier than a start time, the end action will occur in the next day.
Address
The scheduler object retrieves the start/end time and day of week information from word
registers, enabling all parameters to be set and changed under PLC or user control.
Designated as the top address in a block of 11 sequential registers which are used to store time
setting data.
The format of the 11 word registers should normally be 16-unsigned integer. If a 32-bit word
address is chosen, only bits 0-15 are effective, and bits 16-31 should be written as zero.
The following describes each register.
Control (Time setting address + 0)
When [Control] bit is ON, the HMI will read and update [Action mode], [Start time], and [End
time] values.
13-145
Objects
Note
HMI will not regularly read the data from [Action mode] (address + 2) to [End time]
(address + 10). Please turn [Control] ON when the settings are changed.
Status (Time setting address + 1)
When the read operation is completed, Bit00 of this register turns ON. If time data read is out
of range or incorrect in any way Bit01 turns ON.
Note
After the scheduler reads the data and the status is turned ON (The value in [Address + 1]
= 01), the control bit must be turned OFF (address = 0). The status bit and error bit will be
turned OFF (10) at the same time.
13-146
Objects
Note
If [Enable termination action] is OFF, all 11 registers are still read but end time is ignored.
If [Setting on individual day] is ON, make sure that all start end times are entered. If more
than one start / end day bit is ON, and error will occur.
Start/End Day (Start Day: Time setting address + 3, End Day: Time setting address + 7)
Designates which day of week is used to trigger the start or end action.
Start/End Time (Start Time: Time setting address + 4 to + 6, End Time: Time setting address +
8 to + 10)
Hour: 0 23 Minute: 0 59 Second: 0 - 59
Values outside these ranges will cause error.
Note
16-bit unsigned integer format must be used; BCD format is not supported here.
End time depends on [Action mode] (address + 2). [Enable termination action] (Bit 00)
and [Setting individual day] (Bit 01) are related:
13-147
Objects
Prohibit tab
Before the scheduled action is performed, the HMI will read the specified bit state. If it is ON,
the scheduled start/end action will be skipped. Otherwise, it will be performed normally.
Note
[Write start/end value] and [Prohibit] bit is read only once before start action. After that,
even to change the state of [Prohibit] bit or [Write start/end value], the end action and
the value written will not be affected. Also, to read data of [Write start/end value] and
[Prohibit] bit, there is a delay of start action due to the communication.
Each time RTC data is changed, scheduler list entries that possess both start and end
times will be checked for in-range or out-range conditions. For in-range, the start action
will occur. If the end action is not set, the new range is not recognized, the action will not
occur.
If several Scheduler objects are set to the same start time or end time, the action is
performed in ascending order of the schedule number.
In [Time Set] [Address] mode, the system will read [Control] word regularly. The length
of the period depends on the system.
In [Time Set] [Address] mode, when start time and end time is out- range, error occurs
in the set action time. (Note: BCD is not an acceptable format)
In [Time Set] [Address] mode, the action will not start up until the first time the time
data is successfully updated.
13-148
Objects
13.29.2. Configuration
Click the Option List icon on the toolbar to open an Option List object property dialog box. Set
up the properties, press OK button, and a new Option List object will be created.
13-149
Objects
General Tab
Setting
Description
Attribute
Monitor
address
13-150
Objects
Send
notification
after writing
successfully
Note
For cMT Series, the [Dates of historical data] and the [write when button is released]
selections are not available.
13.29.2.1.
Predefine
Option List object can be used with historical data display objects, such as Trend Display object,
History Data Display object and Event Display object to control which history file should be
EasyBuilder Pro V5.01.02
13-151
Objects
shown. The figure below is an example of Option List used with Trend Display.
Setting
Description
Type
Two options are available: [Event (Alarm) log] and [Data sampling].
Date
Set the date format. YYYY means a four digits year (EX: 2012), YY
means a two digits year (EX: 12), MM means month and DD means
day.
Data
Sampling
object
Enable
[delete
history data]
function
Note
In [Dates of historical data] mode, since the system automatically reads the historical data
and finds the date information, it is not necessary to configure in the [Mapping] tab.
The error message displayed in Option List can be modified in [Mapping] tab.
Item address
The list will be read from the given [Item address] and controlled by [Control address]. The
following options will be available:
13-152
Objects
Setting
Description
Control
address
Item address
Note
The UNICODE characters used here should be used by Text object, so that EasyBuilder Pro
will compile the needed fonts and download these fonts to HMI, then the UNICODE
letters can be correctly displayed.
[The number of items] multiplied by [The Length of each item] must be less than 1024
words.
The system automatically disables [Mapping] tab in [Item address] mode.
EasyBuilder Pro V5.01.02
13-153
Objects
User account
If [Enhanced Security] mode is enabled, [User account] would appear in the [Source of item
data] and it lists the names of users.
Setting
Description
Sort
Display
Note
The address that controls user index is [Control Address +2 (LW-n+2)] which is set in
[System Parameters] [Security] [Enhanced Security].
Mapping Tab
This table displays all available states/items, their item data and values. To change the number
of available items, please go to [Option list tab] [Attribute] [Item no.].
13-154
Objects
Setting
Item
Value
Item data
Import item
data from
recipe record
Description
The system lists all available items. Each item represents a state
that will be displayed in the list. This field is read-only.
Here user can assign value for each item, basing on the following
two criteria:
For reading: If the value in [Monitor address] is changed, the object
selects the first-matched item. If no item is matched, the status
goes to error state and signals the notification bit register (if
requested).
For writing: The system writes this value to [Monitor address] when
user selects an item.
Text displayed for each item. The Option List object displays the
text of all items in the list for users to review and select.
This feature is enabled when select [Recipe-Selection] as [Monitor
address]. Click [Import item data from recipe record] to open the
[Recipe Records] setting dialog box. Select [Item data source], the
data belonging to the selected column will all be imported to
Option List object.
13-155
Objects
Error state
Set default
Error
notification
13-156
Objects
13.30. Timer
13.30.1. Overview
Timer object is a switch that can be used to control the mode to count time. The modes are
explained later. Timer object uses the following 6 variables:
Timer Variable
Type
Description
Bit
Bit
Bit
Word
Word
Bit
13.30.2. Configuration
Click the Timer icon on the toolbar to open the property dialog box as shown in the following
figure.
13-157
Objects
Note
[Constant preset time] is only available for cMT series.
If use cMT Series, clicking the Timer icon on the toolbar will open the Timer managing window,
click [New] to configure.
On delay
Mode
Register
Input bit (IN): The main switch of Timer.
Measurement bit (TI): Turns ON when the Timer
begins counting time.
Output bit (Q): Turns ON when the Timer finishes
counting time.
Preset time (PT): Presets a time before the Timer
begins counting time.
Elapsed time (ET): Displays the elapsed time.
Description
Period 1: When the IN turns ON, TI turns ON and the ET starts counting. The Q remains OFF.
Period 2: When the ET equals to the PT, the TI turns OFF and the Q turns ON.
Period 3: When the IN turns OFF, the Q turns OFF and the ET is reset to 0.
Period 4: When the IN turns ON, the TI turns ON and the ET starts counting. The Q remains
OFF.
Period 5: Turns IN OFF before the ET reaches the PT, the TI turns OFF, and the ET is reset to 0.
Since the ET doesnt reach the PT, the Q remains OFF.
13-158
Objects
Off delay
Mode
Register
Input bit (IN): The main switch of Timer.
Measurement bit (TI): Turns ON when the Timer
begins counting time.
Output bit (Q): Turns OFF when the Timer finishes
counting time.
Preset time (PT): Presets a time before the Timer
begins counting time.
Elapsed time (ET): Displays the elapsed time.
Description
Period 1: When the IN turns ON, the TI remains OFF and the Q turns ON, the ET is reset to 0.
Period 2: When the IN turns OFF, the TI turns ON and the Q remains ON, the ET starts
counting.
Period 3: When the ET equals to the PT, the Q and TI turn OFF.
Period 4: When the IN turns ON, the TI remains OFF and the Q turns ON, the ET is reset to 0.
Period 5: When the IN turns OFF, the TI turns ON and the Q remains ON, the ET starts
counting.
Period 6: Turns the IN to ON before the ET reaches the PT, the TI turns OFF, the Q remains
ON, and the ET is reset to 0,.
Pulse
Mode
Register
Input bit (IN): The main switch of Timer.
Measurement bit (TI): Turns ON when the Timer
begins counting time.
Output bit (Q): Turns ON when the Timer begins
counting time and turns OFF when the Timer
finishes counting time.
Preset time (PT): Presets a time before the Timer
begins counting time.
Elapsed time (ET): Displays the elapsed time.
Description
Period 1: When the IN turns ON, the TI and Q turn ON simultaneously, and the ET starts
counting.
Period 2: When the ET equals to PT, the TI and Q turn OFF simultaneously. Since IN is turned
OFF when counting time, the ET is reset to 0.
Period 3: When the IN turns ON, the TI and Q turn ON simultaneously, and the ET starts
counting.
Period 4: When the ET equals the PT, the TI and Q turn OFF simultaneously.
EasyBuilder Pro V5.01.02
13-159
Objects
Accumulated ON delay
Mode
Register
Input bit (IN): The main switch of Timer.
Measurement bit (TI): Turns ON when the Timer
begins counting time.
Output bit (Q): Turns ON when the Timer finishes
counting time.
Preset time (PT): Presets a time before the Timer
begins counting time.
Elapsed time (ET): Displays the elapsed time.
Reset bit (R): Resets ET to 0
Description
Period 1: When the IN turns ON, the TI turns ON and the elapsed time ET starts counting, the
Q remains OFF.
Period 2: When the IN turns OFF, if the ET doesnt reach the PT, the TI turns OFF, and at the
same time the Q remains OFF. The ET is in the retentive state.
Period 3: When the IN turns ON, the TI turns ON. The timer measurement starts again and
the ET starts counting from the kept value. The Q remains OFF.
Period 4: When the ET reaches the PT, the TI turns OFF and the Q turns ON.
Period 5: When the IN turns OFF, the Q turns OFF. Turning ON the reset bit R will reset the ET
to 0, and then the reset bit turns OFF.
Accumulated OFF delay
Mode
Register
Input bit (IN): The main switch of Timer.
Measurement bit (TI): Turns ON when the Timer
begins counting time.
Output bit (Q): Turns OFF when the Timer finishes
counting time.
Preset time (PT): Presets a time before the Timer
begins counting.
Elapsed time (ET): Displays the elapsed time.
Reset bit (R): Resets ET to 0
Description
Period 1: When the IN turns ON, the TI remains OFF and the Q turns ON.
Period 2: When the IN turns OFF, the TI turns ON and the Q remains ON. The ET starts
counting.
Period 3: When the IN turns ON, the TI and Q remain ON, and the ET is in the retentive state.
Period 4: When the IN turns OFF again, the ET starts counting from the kept value.
Period 5: When the ET equals to the PT, the TI and Q turn OFF simultaneously. Turning ON
the reset bit R will reset the ET to 0, and then the reset bit turns OFF.
EasyBuilder Pro V5.01.02
13-160
Objects
Click the Video In icon on the toolbar to open the property dialog box. Set up the properties,
press OK button, and a new Video In object will be created.
General Tab
Analog Video Systems
USB Camera
13-161
Objects
Setting
Description
Input channel
Encode
format
Capture
address
Storage Device
Analog video
system
USB
Camera
Record time
Set a period of time to capture the images.
System
Method
Analog video
system
triggered: YYYYMMDDhhmmss@.jpg
For example, set *Record time+ Before and
After to 5 seconds. When the state of [Capture
address] changes from OFF to ON, the system will
start capturing one image per second, from 5
seconds before the triggering time to 5 seconds
after the triggering time, which is 11 images in
total including the one captured at the triggering
moment.
EasyBuilder Pro V5.01.02
13-162
Objects
Control
address
USB
Camera
Address
Value
LW-n
0
1
Command
13-163
Objects
Note
About analog video systems:
Only one channel can be opened at a time.
Real-time images can still be captured when Video In is paused.
Recommended analog video systems and resolutions:
1:1
50%
NTSC
720 x 480
360 x 240
PAL
720 x 576
360 x 288
13-164
Objects
System Message
Setting
Description
Dialog Size
Confirmation
required
13-165
Objects
[Label Library] for [Message], the use of Label Library for [OK] and
[Cancel] buttons can be enabled.
Deny
write-command
Allow
write-command
Note
cMT-SVR does not support adjusting dialog size and using system tag LB-9196.
13-166
Objects
Click the Recipe View icon on the toolbar to open a Recipe View object property dialog box. Set
up the properties, press OK button, and a new Recipe View object will be created.
General Tab
cMT Series
13-167
Objects
The name of each part of the Recipe View object is shown in the following figure.
Setting
Description
Recipe table
Choose the recipe name or look for other recipes from the
drop-down list.
The item name assigned in [System Parameter Setting] [Recipe].
Transparent
If selected, the title row has no shading; the color selection is not
available.
The frame and background color of the object can be set.
Transparent
Select to hide the background, the color selection is not available.
The dividing lines between columns and rows.
Enable
Select to show the grid.
Title
Profile
Grid
(N/A for cMT)
Selection
Control
(N/A for cMT)
Default sort
method
Note
There are 4 system registers that can be used to view/update/add/delete recipe database:
Selection
Current selection of record in Recipe View object, and it is numbered from zero. If the first
record is chosen, the value of Selection will be 0. When the value of Selection is changed,
the corresponding values will be updated, such as No, Timer_1, Timer_2, as shown
in the following figure.
13-168
Objects
Count
Show the number of records in current recipe.
Command
Enter certain value will send command to the selected record.
Enter 1: Add a new recipe record next to the currently selected one.
Enter 2: Update the selected recipe record.
Enter 3: Delete the selected recipe record.
Enter 4: Delete all recipe records.
Result
View the result of executing commands.
Displays 1: Command successfully executed.
Displays 2: The selected record does not exist.
Displays 4: Unknown command.
Displays 8: Records reach limit (10000 records), no new records can be added.
Please go to [System Parameter Settings] [Recipes] tab to create the recipe data
before using Recipe View object. See 5 System Parameter Settings.
About creating recipes, see 24 Recipe Editor.
13-169
Objects
Example 1
In this example, a recipe database is created to be displayed by Recipe View object. When you
select a recipe record on Recipe View object, the value of [Selection] and the corresponding
values will change accordingly. When finish designing, you can modify the recipe database by
entering a value in [Command].
1.
2.
Use Recipe Records to create a number of records as shown in the following figure.
13-170
Objects
3.
4.
5.
Create a Recipe View object and use the recipe database created in the preceding steps.
Create 4 Numeric objects using registers Selection, Count, Command, and Result.
Create corresponding input objects for No, Name, Timer_1, , Timer_4, Speed.
For example, Name is an ASCII item with size 10. Create an ASCII object and set device
type to RECIPE Name.
6.
7.
As shown above, Mars is selected and the corresponding items are also updated. There
are 5 records so the Count displays 5. Try selecting different rows of the Recipe View
object. Fields Name, Timer_1, will change accordingly.
Try the following operations:
Add:
To add current data as a new record, enter 1 in Command.
Update:
To update recipe database, enter 2 in Command.
Delete:
To delete the selected record, enter 3 in Command.
8.
13-171
Objects
Example 2
In this example, [RECIPE_Bit] can be used to read / write individual bits of Recipe data.
Although BOOL type items cannot be added to Recipe Database, individual bit access of 16bit /
32bit data is possible.
As shown in the following figure, select [RECIPE_Bit] for the read address of Bit object and
point to the target item, and then the available Bit selections will be displayed. In this manner,
Recipe Database can be used to record, read, and write bit data.
13-172
Objects
Click on the Flow Block icon on the toolbar or select [Objects] [Flow Block] to create object.
General Tab
Setting
Description
Reverse
direction
The blocks flow in the direction the object is drawn (the blue
arrow). If select this check box, the blocks flow in the opposite
direction.
13-173
Objects
Dynamic
Read address
speed
The direction and speed at which the blocks flow can be controlled
by a designated register. The valid rage is -25 to 25. When a
negative value is entered, the blocks flow in a reversed direction.
Setting
Displays the address and format of the designated register. [System
register], [Index register], and [Tag Library] can be set here.
Flow speed
Outline Tab
For setting the outline property of Flow Block. The following illustration shows each item.
Setting
Description
Pipe
Sets the properties of the pipe within which the blocks flow. The
background color, border width and color can be set. When the
[Border] check box is selected, the background color must be set.
EasyBuilder Pro V5.01.02
13-174
Objects
Block
Sets the properties of blocks. Width, length, interval and color can
be set here.
Note
If both [Reverse direction] and [Dynamic speed] check boxes are selected in [General] tab,
when entering a negative value in the designated register of dynamic speed, the blocks
flow in the direction the object is drawn.
To avoid the pipe lines from overlapping when drawing a turn, there is a minimum width
planned at each turn. As shown in Fig. 34.1, the sign on the cross cursor defines the
minimum width. Fig. 34.2 demonstrates that each turn is drawn in the minimum width.
(Fig. 34.1)
(Fig. 34.2)
The valid range of the length, width, and height of the Flow Block can be adjusted
according to the size of the object drawn and the size of the window.
As shown in the following figure, when the size of the Flow Block is larger, the valid range
is restricted to prevent the flow block from exceeding the window size. When the size of
the object is smaller, the adjustment range will be larger.
To prevent the flow block from overlapping itself, when the distance between two lines is
shorter (Section A), the valid range is restricted. When the distance is longer (Section B),
the adjustment range will be larger.
13-175
Objects
Example 1
The demonstration below shows how to use [Dynamic speed] to control the direction and
speed of Flow Block by a designated word register.
1. Create a Flow Block object and select [Dynamic speed] check box. Set [Address] to LW-0,
and set the format to 16-bit Signed.
2.
Create a Numeric object, set [Address] to LW-0. The high limit is 25, and the low limit is
-25. The format is 16-bit Signed.
3.
Execute simulation or download the project to HMI. When entering a positive value in
LW-0, the blocks flow in the direction the section is drawn. A larger value indicates a faster
speed. When a negative value is entered, the blocks flow in a reversed direction, and the
smaller value indicates a faster speed. When 0 is entered, it stops flowing.
Click the icon to download the demo project. Please confirm your internet connection.
13-176
Objects
Overview
Operation Log records users operation steps and displays the record in real-time. When an
error occurs, use operation log to analyze the problem. The backup tables can be used to
review the process in order to resolve the errors.
13.35.1.2.
Configuration
Select the objects to be recorded. Click [Objects] on the main menu, point to [Operation Log],
click [Operation Log Settings], and then select [Enable operation log function] check box.
13-177
Objects
Setting
Description
Object
When Operation Log is enabled, the objects with write function are
listed in the setting dialog box sorted by window numbers.
[Filter]: By clicking
icon, the objects with write function are
listed. Users can filter out the objects that need not to be recorded,
and the log displays only the selected objects.
Enable
Comment
13-178
Objects
Select all
Selects all the listed objects. If [Filter] is used, clicking [Select all]
only selects the objects in the list.
Discard all
Storage
settings
Control
address
13-179
Objects
Note
Operation Log can only record the operation of the objects that are manually triggered.
Objects that cannot be manually triggered are not recorded, such as Time Based Data
Transfer object.
When running off-line or on-line simulation, Operation Log is stored under EasyBuilder
installation directory: HMI_memory\operationlog\operationlog.db
Triggering Macro with a Set Bit object generates two records, the triggering of bit and the
triggering of Macro.
Overview
Configuration
Before using Operation Log View, please follow the steps described in the preceding
part to finish Operation Log Settings. Click [Objects] on the main menu, point to
[Operation Log], and then click [Operation Log View].
General Tab
13-180
Objects
Title
Selection
Control
Profile
Frame &
Background
Grid
Setting
Description
Title
Profile
Grid
Sets the color of the dividing lines between the columns and rows.
Enable: If selected, displays the grid, otherwise, hides the grid.
Selection
control
Font
13-181
Objects
Title Tab
Setting
Description
Title
Sort
Display order
Date / Time
Sets the format of date and time displayed in Operation Log View
object.
Overview
Operation Log Printing can generate an Operation Log sheet by printing out using a printer or
by saving as JPEG file into an external device. Before using this function, please go to Operation
Log Settings to finish the settings.
13-182
Objects
13.35.3.2.
Configuration
Select Enable [Operation Log] printing check box and click [Settings] button to open the
Operation Log Printing dialog box.
General Tab
13-183
Objects
Setting
Description
Printer
Orientation
Font
Sets the font and the font size to of the Operation Log sheet. The
following table lists the corresponding size.
Range
Size
Title
Content
Large
20 pt.
16 pt.
Middle
16 pt.
12 pt.
Small
12 pt.
8 pt.
Trigger
address
Preview
13-184
Objects
Layout Tab
Description
Title
Sets the content of the title. The title is limited to one line.
Printed on all pages
If selected, the title is shown on each page; otherwise, the title is
shown on the first page.
Header
Sets the content of the header. The header can have 5 lines in
maximum.
Printed on all pages
If selected, the header is shown on each page; otherwise, the
header is shown on the first page.
Footer
Sets the content of the footer. The footer can have 5 lines in
maximum.
Printed on all pages
If selected, the footer is shown on each page; otherwise, the footer
is shown on the last page.
Date/Time
Page number
13-185
Objects
Content Tab
Setting
Description
Title
Sort
Time ascending
The latest record is placed at the bottom.
Time descending
The latest record is placed at the top.
Date/Time
13.35.3.3.
Demonstration
Example 1
The following demonstration explains how to create an Operation Log project.
1. Create a Toggle Switch object and a Numeric object on window number 10.
2. Go to Operation Log Settings; enable the Toggle Switch object and Numeric object on
window number 10.
13-186
Objects
3.
4.
Click the icon to download the demo project. Please confirm your internet connection.
Example 2
Upload Operation Log to PC by using Utility Manager or use Backup object to send the file by
email.
Upload by Utility Manager
1. Open Utility Manager, click [Upload].
2. Select [Operation log], enter file name and HMI IP, and then click [Upload].
13-187
Objects
1.
2.
For more information about e-Mail settings, see 5 System Parameter Settings.
13-188
Objects
Click the Combo Button icon on the toolbar to open a Combo Button object property dialog
box. Set up the properties, press OK button, and a new Combo Button object will be created.
13-189
Objects
General Tab
Setting
Description
Lamp
13-190
Objects
Actions
There are four types of actions: [Delay], [Set Bit], [Set Word], and
[Change window]. A combo button can execute up to 20 actions.
Change the order of the actions.
Copy
Paste
Delete
Delay
Delays the action for a few seconds. A combo button can set one
[Delay] action only.
Set Bit
Sets the designated bit ON or OFF.
Set style
Description
Set ON
Set ON the designated bit of the device.
Set OFF
Set OFF the designated bit of the device.
Toggle
Momentary
Set Word
Sets the value in the designated register.
Set style
Description
Write
Writes a constant value to the designated
Constant
register.
Value
JOG+
Increases value in register by a set amount in
[Inc. value] each time when the button is
pressed, to the [Upper limit].
JOG-
Dynamic
limits
Change Window
Switch to the designated window. A combo button can only set one
[Change Window] action, and this action is always the last one
executed.
13-191
Objects
13.37.2. Configureation
Click the Circular Trend Display icon on the toolbar to open the property dialog box. Set up the
properties, press OK button, and a new Circular Trend Display object will be created.
13-192
Objects
General Tab
Setting
Description
Data Sampling
Type
13-193
Objects
13-194
Objects
Distance
Defines the time length that the circle represents, the unit
is hour, the range is 1 to 24 (hours).
Start position
(Down)
(Left)
Dynamic X-axis
time range
Zoom in / out
Hold control
History control
13-195
Objects
Watch line
Value in LW-0
20061203.dtl
20061127.dtl
20061123.dtl
20061120.dtl
Channel
Data Format
16-bit Unsigned
1 Word
LW-0
32-bit Unsigned
2 Words
LW-1
32-bit Signed
2 Words
LW-3
16-bit Signed
1 Word
LW-5
13-196
Objects
13-197
Objects
Setting
Description
Profile
Frame
Sets the color of the frame of the object.
Background
Sets the color of the background of the object.
Show scroll controls
The scroll controls are displayed for scrolling to view
the sampling data of other time range. The
minimum scrolling unit is determined by the setting
of [Distance] in General tab. If [Show scroll controls]
check box is not selected, the earlier data cannot be
viewed when exceeding the specified [Distance].
For example: Set [Distance] to 1 (hour.), then
sampling data earlier than one hour is not displayed.
Grid
13-198
Objects
division is 15 minutes.
Channel scale
If enabled, displays the channel scale. The color of
the font which labels the channel scale corresponds
to the setting of the trend curve of each channel.
Time / Date
Time
Sets the display format of time.
Date
Sets the display format of date.
Channel Tab
Setting
Description
Channel
Sets the style and the color of the trend curve, and
the upper and lower limit of data that can be drawn
on the trend curve. Up to 8 channels are supported
simultaneously.
EasyBuilder Pro V5.01.02
13-199
Objects
Channel Visibility
Control
Data format
16-bit
32-bit
Lower limit
LW-n
LW-n
Upper limit
LW-n+1
LW-n+2
LW_bit-000
OFF
YES
LW_bit-001
ON
NO
LW_bit-002
ON
NO
LW_bit-003
OFF
YES
LW_bit-004
OFF
YES
13-200
Objects
Click the Picture View icon on the toolbar to open the property dialog box. Set up the
properties, press OK button, and a new Picture View object will be created.
General Tab
13-201
Objects
Setting
Description
Outline
File position
Select the file source of the picture files from [SD card] or
[USB disk].
Directory
Select the directory where the picture files are saved. If
the selected directory is not the [Root directory], please
enter the [Directory name].
Please note that if the [Directory name] is left empty, the
file source will be the root directory.
Note
The file name must be all in ASCII characters, and the Unicode characters are not
supported.
The supported picture formats are: .jpg, .bmp, .gif, .png.
13-202
Objects
Click the File Browser icon on the toolbar, or select Tools File Browser to open a File Brower
object property dialog box and set up the properties.
General Tab
13-203
Objects
Setting
Description
Current directory.
Outline Tab
Setting
Description
Folder position
File type
Font / Background
/ Color
Note
The file name and the directory of the selected file will be written to the designated
address, but changing the contents of the designated address will not change the selected
file in the File Browser.
EasyBuilder Pro V5.01.02
13-204
Objects
The system will read the folder path address and file name address when the HMI is
restarted or when an external device is inserted to the unit. If valid data is can be read
from the designated address, the system will then automatically navigate to the
appropriate directory and highlight the file according to the data read. If [Folder path
address] is not enabled, the data at Full (folder + file name) address will be read.
13-205
Objects
13.40.2. Configuration
Click the Recipe Import/Export icon on the toolbar to open the Recipe Import/Export Object
management dialog box. To add a Recipe Import/Export object, click [New], set up the
properties, press OK button and a new Recipe Import/Export object will be created.
13-206
Objects
General Tab
Setting
Description
File position
Recipe
Control address
13-207
Objects
Other: Error
File name address
Example 1
The following is an example on recipe export/import settings.
1.
2.
3.
4.
Field
Setting
File position
USB disk
Recipe
Control address
LW-100
LW-200
LW-250
Create two ASCII Input objects. Set address to LW-200 and LW-250 respectively.
Enter the file name in LW-200: 2015_recipe.csv
Enter the folder path in LW-250: Setting
Use a Set Word object to write value 3 to LW-100. Then, Recipe_A will be exported to the
USB disk, in the Setting/2015_recipe.csv file.
Note
When performing Export (no overwrite) command, if the target file already exists, the
export operation will be canceled, and the result value will be set to 4.
14-1
14-2
14.1.
Overview
EasyBuilder Pro provides Shape Library and Picture Library for visual effects on objects.
Picture Manager provides two modes: [Project] and [Library]. Pictures in [Project] mode will be
stored in .emtp project file. Pictures in [Library] mode will be stored in EasyBuilder Pro libraries,
or the user-defined directory.
Each Shape or Picture includes up to 256 states. This chapter explains how to build Shape
Library and Picture Library.
For more information about using libraries while creating an object, see 9 Object General
Properties.
14.2.
Shapes are vector graphics constructed by lines, curves or polygons. A Shape can have more
than one state, and each state includes two parts: frame and inner, as shown in the following
figure.
State 0
State 1
Frame
Inner
14.2.1.
Shape manager
An object can use frame, inner or both. Click [Call up Shape Library], and the [Shape manager]
dialog box appears.
14-3
Setting
Description
Project
Library
New library
Unattach library
Copy to project
Background
Place
14-4
More options
Copy
Paste
Insert transparent
state
Delete
Clean
OK
Cancel
Help
Note
The color of [Inner] and [Frame] can be selected in Shape Library. The selection of [Pattern
Style] is only available in System Frame / System Button Library.
14-5
14.2.2.
The following explains how to create a new Shape Library and add a Shape with two states into
the library.
1. Click [New library] and enter the name of the new Shape Library.
2.
3.
Click [Open], a popup dialog appears; click [Yes] to create the file.
A new Shape Library [new_lib] is added in [Shape manager]. This library is empty as
shown in the following figure.
4.
Add a state to the selected Shape. First, use the drawing tools to draw a frame and inner
in the window and select the frame to add to the Shape Library.
14-6
5.
6.
Click [Save to Shape Library] button in the toolbar, select [new_lib], and select a number
in this library. The selected number is highlighted yellow.
Save the Shape as [Frame], select [Insert], and click [Save].
Setting
Description
Inner
Frame
Save to library
Save as Frame
Saves the Shape as a frame.
Save as Inner
Saves the Shape as inner.
EasyBuilder Pro V5.01.02
14-7
Insert
Inserts the Shape to be a new state.
Replace
Replaces a state with this Shape.
Save
7.
The following shows that a state of the Shape is added, and is defined as a frame.
8.
Create the shape to be saved as inner. Select the shape drawn in the window.
9.
Click [Save to Shape Library] button in the toolbar, select [new_lib], and select the same
number as in creating the frame in this library. The selected number is highlighted yellow.
10. Save the Shape as [Inner], select [Replace], and click [Save].
EasyBuilder Pro V5.01.02
14-8
11. A state of a Shape can include [Inner], [Frame], or both. The state 0 of the Shape shown in
the following figure includes both frame and inner. Click [OK], the state 0 of the Shape is
created.
12. Follow the steps of creating state 0 and insert a new state set to state 1 as shown in the
following figure. The Shape now has two states, click [OK] to finish setting.
14-9
14.3.
14.3.1.
Picture manager
Click [Call up Picture Library] button in the toolbar and the [Picture manager] dialog box
appears.
Setting
Description
Project
Library
New library
14-10
Unattach library
Copy to project
Background
More picture
libraries
Export
Modify
Paste
Insert
transparent state
New
Delete
Clean
OK
Cancel
Help
Note
The supported picture formats are .bmp, .jpg, .gif, .dpd, .svg and .png. When adding a gif
animation file in Picture Library, the loop times of this animated Picture can be set.
14-11
14.3.2.
1.
2.
3.
Click [Open], a popup dialog appears; click [Yes] to create the file.
A new Picture Library [new_lib] is added in [Picture manager]. This library is empty as
shown in the following figure.
4.
Draw the two pictures below to represent state 0 and state 1 respectively.
5.
Select [new_lib], and select a number in this library. The selected number is highlighted
yellow.
EasyBuilder Pro V5.01.02
14-12
6.
7.
When the following dialog box is shown, select [Enable] check box to use transparent
color. Set to RGB (121, 121, 121), the corresponding color in the picture below will be
transparent. Or, click on a desired area with mouse to be the transparent area, the system
will show the RGB of the clicked area automatically.
8.
To set transparent color, select [Enable] check box first, and then click an area in the
picture. The RGB value of that area is shown and it will be transparent. The displayed
picture is shown as in the preceding figure.
The Picture of state 0 is created. Follow the steps of creating state 0 to create state 1 by
clicking [New] as shown in the following figure.
9.
14-13
10. When finished, a complete Picture is created, click [OK]. In [Picture manager] dialog box it
shows that the newly added Picture Number 0 is a bitmap picture with two states.
14.3.3.
The following example explains how to import a Picture into the library by pasting the picture
from the clipboard.
1. Copy the following picture to the clipboard.
2.
14-14
3.
Note
Transparent color can only be set for .bmp, .dpd, and .jpg picture files.
15-1
15-2
15.1.
Overview
The Label Tag Library feature enables a multi-language environment. When multiple languages
are required, users can create the Label Tag Library and then select a suitable label in the
project. The project will display the corresponding language in runtime based on the settings.
EasyBuilder Pro supports up to 8 different languages simultaneously. This chapter will explain
how to create and use the Label Tag Library.
15.2.
Click [Library] [Label] on the toolbar and the [Label Tag Library] dialog box appears.
Setting
Description
Language no.
New
Settings
State no.
15-3
Note
15.3.
2.
Click [OK] and a new label is added to the Label Tag Library. Select the label and click
[Settings] to edit its content.
3.
15-4
4.
Select [Label Tag Library] [Font] to view each label which contains different fonts for
different languages. You can also enter the font description in the Comment field.
15.4.
When there are defined labels in the Label Library, the labels can be found in the objects
[Label] tab. Select [Use label library] check box, and select the label from the pull-down list
[Label tag].
15-5
When a tag is selected, the content of the selected tag is shown in the [Content] field in its
corresponding font style. Please note that from Language 2 to Language 24 can only be set the
Font [Size], the others such as [Color], [Align], [Blink], etc. will follow the settings of Language
1.
15.5.
Settings of Multi-Language
When displaying the texts in multiple languages, the system register *LW-9134]: language
mode should be used too.
The value of [LW-9134] is ranged from 0 to 23 (cMT Series is from 0 to 7). Different values
correspond to different languages.
If not all languages are selected to compile and download, [LW-9134] will work differently.
For example, user defines 5 different languages in the Label Library:
1: English, 2: Traditional Chinese, 3: Simplified Chinese, 4: French, 5: Korean
If only Language 1, Language 3, and Language 5 are selected to compile then the
corresponding values of [LW-9134] are:
0: English, 1: Simplified Chinese, 2: Korean
Please follow the steps to use multiple languages.
1. Create a Text object and select [Use label library] checkbox.
15-6
2.
Create a Numeric Input Object and use the system register [LW-9134].
3.
4.
The simulation is shown as followed: If the value of [LW-9134] is changed, the content of
the Text object will be changed.
15-7
Note
For cMT Series, at most 8 different languages can be downloaded to the HMI.
When selecting the HMI model: cMT, [LW-9134] is used to change the language mode on
cMT model, while [PLW-9134] is to change the language mode on iPad.
Click the icon to download the demo project that illustrates how to use the Option List
object to switch between multiple languages. Please confirm your internet connection before
downloading the demo project.
16-1
16-2
16.1.
Overview
Generally it is recommended to define the commonly used addresses in Address Tag Library
when starting to build a project. It not only avoids accidental reuse of addresses but also
improves project readability.
16.2.
Click [Library] [Tag] on the toolbar and the [Address Tag Library] dialog box appears.
Setting
Description
Customized
System
New
Settings
Export CSV
Import CSV
Export EXCEL
Import EXCEL
16-3
1.
Setting
Description
Comment
Tag name
PLC name
Address type
Device type
Address
Data format
Conversion
(Use Macro)
When enabled, the data format that the address tag will
be converted into can be specified. Macro subroutines can
be selected to do read/write conversion.
Read / Write
convertion
16-4
2.
16.3.
Click [OK], a newly added tag can be found in the [User-defined tags] library.
1.
2.
3.
4.
5.
6.
16-5
7.
When finished, the window tree will show the address tag name used by the object.
17-1
17-2
17.1.
Overview
Recipe Data refers to the data stored in RW and RW_A addresses. The way of reading and
writing these addresses is the same as operating a word register. The difference is that recipe
data is stored in flash memory, when restarting HMI, the latest data records in RW and RW_A
are kept.
The size of recipe data a RW address can store is 512K words, and RW_A is 64K words. Users
can update recipe data with SD card, USB disk, USB cable or Ethernet and use the data to
update PLC data. Recipe Data can also be uploaded to PC; furthermore, PLC data can be saved
in recipe data. The following explains the ways of transferring recipe data.
17.2.
17-3
17.3.
1.
2.
3.
4.
Note
17.4.
When download data is successfully built, two folders can be found: history and emt3000.
emt3000 is for storing project file; history is for storing recipe data and data sampling /
event log records.
Use [Data Transfer (Trigger-based) Object] to transfer recipe data to a specific address, or save
the data of this address in [RW] and [RW_A].
17-4
17.5.
Setting
Description
Source address
Destination address
Attribute
In order to prolong the life span of HMI flash memory, the system will automatically save the
recipe data to HMI every minute. To avoid losing data when turning HMI off during the interval
of saving data, system register [LB-9029: Save all recipe data to machine (set ON)] is provided.
Set ON LB-9029 will make the system save recipe data once. Set ON [LB-9028: Reset all recipe
data (set ON)], the system will clear all recipe data.
18-1
Macro Reference
18.5.
18.6.
18.7.
18.8.
18.9.
18.10.
18.11.
18.12.
18.13.
18.14.
18-2
Macro Reference
18.1.
Overview
Macros provide the additional functionality your application may need. Macros are automated
sequences of commands that are executed at run-time. Macros allow you to perform tasks
such as complex scaling operations, string handling, and user interactions with your projects.
This chapter describes syntax, usage, and programming methods of macro commands.
18.2.
Select All
Toggle Bookmark / Previous Bookmark / Next Bookmark / Clear All Bookmarks
Toggle All Outlining
Security -> Use execution condition
Periodical execution
Execute one time when HMI starts
The instructions in the following part show you how to use these functions.
1. Open the macro editor; youll see the line numbers displayed on the left-hand side of the
edit area.
18-3
Macro Reference
2.
Right click on the edit area to open the pop-up menu as shown in the following figure.
Disabled operations are colored grey, which indicates that it is not possible to use that
function in the current status of the editor. For example, you should select some text to
enable the copy function, otherwise it will be disabled. Keyboard shortcuts are also
shown.
3.
The toolbar provides [Undo], [Redo], [Cut], [Copy], [Paste], [Toggle Bookmark], [Next
Bookmark], [Previous Bookmark] and [Clear All Bookmarks] buttons.
4.
Any modification will enable the [Undo] function. [Redo] function will be enabled after
the undo action is used. To perform the undo/redo, right click to select the item or use the
keyboard shortcuts. (Undo: Ctrl+Z, Redo: Ctrl+Y).
18-4
Macro Reference
5.
Select a word in the editor to enable the [Cut] and [Copy] function. After [Cut] or [Copy] is
performed, [Paste] function is enabled.
6.
Use [Select All] to include all the content in the edit area.
7.
If the macro is too long, use bookmarks to manage and read the code with ease. The
following illustration shows how it works.
Move your cursor to the position in the edit area where to insert a bookmark. Right click,
select [Toggle Bookmark]. There will be a blue little square that represents a bookmark on
the left hand side of edit area.
18-5
Macro Reference
If there is already a bookmark where the cursor is placed, select [Toggle Bookmark] to
8.
18-6
Macro Reference
9.
Right click to select [Toggle All Outlining] to open all folded macro code blocks.
10. Sometimes the outlining might be incorrect since that the keywords are misjudged as
shown in the following figure. To solve this problem, right click and select [Update All
Outlining].
11. The statements enclosed in the following keywords are called a block of the macro
code:
Function block: sub end sub
Iterative statements:
i.
for next
ii.
while wend
Logical statements:
i.
if end if
Selective statements: select case end select
12. When [Periodical execution] is checked, this macro will be triggered periodically.
18-7
Macro Reference
13. Select [Security] [Use execution condition] [Settings] to enable security settings:
[Disable when Bit is ON]: When Bit is ON, this macro is disabled.
[Disable when Bit is OFF]: When Bit is OFF, this macro is disabled.
14. Select [Execute one time when HMI starts], this macro will be executed once when HMI
starts up.
18.3.
Configuration
A macro contains statements. The statements contain constants, variables and operations. The
statements are put in a specific order to create the desired output.
A macro has the following structure:
Global Variable Declaration
----------------------------------- Optional
----------------------------------- Optional
macro_command main()
Local Variable Declarations
------------------------------------ Required
[Statements]
end macro_command
------------------------------------ Required
Macro must have one and only one main function which is the execution start point of macro.
The format is:
macro_command main()
end macro_command
18-8
Macro Reference
Local variables are used within the main macro function or in a defined function block. Its
value remains valid only within the specific block.
Global variables are declared before any function blocks and are valid for all functions in the
macro. When local variables and global variables have the same declaration of name, only the
local variables are valid.
The following example shows a simple macro which includes a variable declaration and a
function call.
macro_command main()
short pressure = 10
// local variable declaration
SetData(pressure, "Allen-Bradley DF1", N7, 0, 1) //
end macro_command
18.4.
Syntax
18.4.1.
function calling
18.4.1.1. Constants
Constants are fixed values and can be directly written into statements. The formats are:
Constant Type
Note
Decimal integer
Example
345, -234, 0, 23456
Hexadecimal
ASCII
a, "data", "name"
Boolean
true, false
18-9
Macro Reference
Description
Range
bool (boolean)
1 bit (discrete)
0, 1
char (character)
8 bits (byte)
+127 to -128
16 bits (word)
+32767 to -32768
int (integer)
+2147483647to -2147483648
unsigned char
8 bits (byte)
0 to 255
unsigned short
16 bits (word)
0 to 65535
unsigned int
0 to 4,294,967,295
Declaring Variables
Variables must be declared before being used. To declare a variable, specify the type before
the variable name.
Example:
int
short
float
unsigned short
a
b, switch
pressure
c
Declaring Arrays
Macros support one-dimensional arrays (zero-based index). To declare an array of variables,
specify the type and the variable name followed by the number of variables in the array
enclosed in brackets *+. The length of an array could be 1 to 4096. (Macros only support at
most 4096 variables per macro).
Example:
int
short
float
a[10]
b[20], switch[30]
pressure[15]
The minimum array index is 0 and the maximum is (array size 1).
Example:
char data [100]
// array size is 100
EasyBuilder Pro V5.01.02
18-10
Macro Reference
In this case, the minimum of array index is 0 and maximum of array index is 99 (=100-1)
Variable and Array Initialization
There are two ways variables can be initialized:
By statement using the assignment operator (=)
Example:
int a
float b[3]
a = 10
b[0] = 1
During declaration
char a = 5, b = 9
The declaration of arrays is a special case. The entire array can be initialized during declaration
by enclosing comma separated values inside curly brackets ,-.
Example:
float data[4] = {11, 22, 33, 44} // now data*0+ is 11, data*1+ is 22.
18.4.2.
Operators
Description
Example
Assignment operator
pressure = 10
Description
Example
Addition
A=B+C
Subtraction
A=BC
Multiplication
A=B*C
Division
A=B/C
A=B%5
Description
Example
<
Less than
if A < 10 then B = 5
<=
if A <= 10 then B = 5
>
Greater than
if A > 10 then B = 5
>=
if A >= 10 then B = 5
==
Equal to
if A == 10 then B = 5
<>
Not equal to
if A <> 10 then B = 5
=
Arithmetic Operators
Comparison Operators
18-11
Macro Reference
Logic Operators
Description
Example
Logical AND
or
Logical OR
xor
Logical Exclusive OR
not
Logical NOT
if not A then B = 5
and
Shift and bitwise operators are used to manipulate bits of signed/unsigned character and
integer variables. The priority of these operators is from left to right within the statement.
Shift Operators
<<
Description
Example
A = B << 8
A = B >> 8
of positions
Bitwise Operators
Description
Example
&
Bitwise AND
A = B & 0xf
Bitwise OR
A=B|C
Bitwise XOR
A=B^C
Ones complement
A = ~B
Assignment
Reserved Keywords
The following keywords are reserved for system. These keywords cannot be used as variable,
array, or function names.
+, -, *, /, %, >=, >, <=, <, <>, ==, and, or, xor, not, <<, >>,=, &, |, ^, ~
exit, macro_command, for, to, down, step, next, return, bool, short, int, char, float, void, if,
EasyBuilder Pro V5.01.02
18-12
Macro Reference
then, else, break, continue, set, sub, end, while, wend, true, false
SQRT, CUBERT, LOG, LOG10, SIN, COS, TAN, COT, SEC, CSC, ASIN, ACOS, ATAN, BIN2BCD,
BCD2BIN, DEC2ASCII, FLOAT2ASCII, HEX2ASCII, ASCII2DEC, ASCII2FLOAT, ASCII2HEX, FILL, RAND,
DELAY, SWAPB, SWAPW, LOBYTE, HIBYTE, LOWORD, HIWORD, GETBIT, SETBITON, SETBITOFF,
INVBIT, ADDSUM, XORSUM, CRC, INPORT, OUTPORT, POW, GetError, GetData, GetDataEx,
SetData, SetDataEx, SetRTS, GetCTS, Beep, SYNC_TRIG_MACRO, ASYNC_TRIG_MACRO, TRACE,
FindDataSamplingDate, FindDataSamplingIndex, FindEventLogDate, FindEventLogIndex
StringGet, StringGetEx, StringSet, StringSetEx, StringCopy, StringMid, StringDecAsc2Bin,
StringBin2DecAsc, StringDecAsc2Float, StringFloat2DecAsc, StringHexAsc2Bin,
StringBin2HexAsc, StringLength, StringCat, StringCompare, StringCompareNoCase, StringFind,
StringReverseFind, StringFindOneOf, StringIncluding, StringExcluding, StringToUpper,
StringToLower, StringToReverse, StringTrimLeft, StringTrimRight, StringInsert
18-13
Macro Reference
18.5.
Statement
18.5.1.
Definition Statement
This covers the declaration of variables and arrays. The formal construction is as follows:
type
name
type
name[constant]
This defines an array variable called name with size as constant and type as type.
Example:
int B[10]
18.5.2.
Assignment Statement
Assignment statements use the assignment operator to move data from the expression on the
right side of the operator to the variable on the left side. An expression is the combination of
variables, constants and operators to yield a value.
VariableName
Example
A=2
18.5.3.
Expression
Logical Statements
18-14
Macro Reference
Example:
if a == 2 then
b=1
else
b=2
end if
Block Format
If <Condition> then
[Statements]
else if <Condition-n> then
[Statements]
else
[Statements]
end if
Example:
if a == 2 then
b=1
else if a == 3 then
b=2
else
b=3
end if
Syntax description
if
<Condition>
then
[Statements]
else if
<Condition-n>
else
end if
18-15
Macro Reference
18.5.4.
Selective Statements
The select-case construction can be used like multiple if-else statements and perform selected
actions depending on the value of the given variable. When the matched value is found, all the
actions below will be executed until a break statement is met. The syntax is as follows:
Format without a Default Case
Select Case [variable]
Case [value]
[Statements]
break
end Select
Example:
Select Case A
Case 1
b=1
break
end Select
Format with a Default Case (Case else)
Select Case [variable]
Case [value]
[Statements]
break
Case else
[Statements]
break
end Select
Example:
Select Case A
Case 1
b=1
break
Case else
b=0
break
end Select
EasyBuilder Pro V5.01.02
18-16
Macro Reference
[variable]
Case else
break
end Select
18.5.5.
Iterative Statements
Iterative statements control loops and repetitive tasks depending on condition. There are two
types of iterative statements.
18-17
Macro Reference
[Counter]
<StartValue>
to/down
<EndValue>
step
next
[Counter]
[StepValue]
[Statements]
18-18
Macro Reference
continue
return [value]
wend
18.6.
Function Blocks
Function blocks are useful for reducing repetitive codes. It must be defined before use and
supports any variable and statement type. A function block could be called by putting its name
followed by parameters in parenthesis. After the function block is executed, it returns the value
to the caller function where it is used as an assignment value or as a condition. A return type is
not required in function definition, which means that a function block does not have to return
a value. The parameters can also be ignored in function definition while the function has no
need to take any parameters from the caller. The syntax is as follows:
Function definition with return type
18-19
Macro Reference
18-20
Macro Reference
end sub
macro_command main()
int a = 10, b = 20
Add(a, b)
end macro_command
or:
sub Add()
int result, x=10, y=20
result = x +y
end sub
macro_command main()
Add()
end macro_command
Syntax description
sub
type
Optional. This is the data type of value that the function returns. A
function block is not always necessary to return a value.
Optional. The parameters hold values that are passed to the function.
The passed parameters must have their type declared in the parameter
field and assigned a variable name.
For example: sub int MyFunction(int x, int y). x and y would be integers
passed to the function. This function is called by a statement that looks
similar to this: ret = MyFunction(456, pressure) where pressure must
be integer according to the definition of function.
Notice that the calling statement can pass hard coded values or
variables to the function. After this function is executed, an integer
values is return to ret.
Variables that are used in the function block must be declared first.
This is in addition to passed parameters. In the above example x and y
are variables that the function can used. Global variables are also
available for use in function block.
Statements to execute
(parameters)
Local variable
declaration
[Statements]
[return [value]]
end sub
Optional. Used to return a value to the calling statement. The value can
be a constant or a variable. Return also ends function block execution.
A function block is not always necessary to return a value, but, when
the return type is defined in the beginning of the definition of function,
the return command is needed.
Must be used to end a function block.
EasyBuilder Pro V5.01.02
18-21
Macro Reference
18.7.
EasyBuilder Pro has many built-in functions for retrieving and transferring data to the PLC, data
management and mathematical functions.
18.7.1.
Mathematical Functions
SQRT
Name
SQRT(source, result)
Syntax
Description Calculate the square root of source and store the result into result.
source can be a constant or a variable. result must be a variable.
source must be a nonnegative value.
macro_command main()
Example
float source, result
SQRT(15, result)
source = 9.0
SQRT(source, result)// result is 3.0
end macro_command
CUBERT
Name
CUBERT(source, result)
Syntax
Description Calculate the cube root of source and store the result into result.
source can be a constant or a variable. result must be a variable.
source must be a nonnegative value.
macro_command main()
Example
float source, result
CUBERT (27, result) // result is 3.0
source = 27.0
CUBERT(source, result)// result is 3.0
end macro_command
POW
Name
POW(source1, source2, result)
Syntax
Description Calculate source1 to the power of source2.
source1 and source2 can be a constant or a variable.
result must be a variable.
source1 and source2 must be a nonnegative value.
EasyBuilder Pro V5.01.02
18-22
Macro Reference
Example
macro_command main()
float y, result
y = 0.5
POW (25, y, result) // result = 5
end macro_command
SIN
Name
SIN(source, result)
Syntax
Description Calculate the sine of source (degree) into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
SIN(90, result)//
result is 1
source = 30
SIN(source, result)//
result is 0.5
end macro_command
COS
Name
COS(source, result)
Syntax
Description Calculate the cosine of source (degree) into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
COS(90, result)// result is 0
source = 60
GetData(source, "Local HMI", LW, 0, 1)
COS(source, result)// result is 0.5
end macro_command
TAN
Name
TAN(source, result)
Syntax
Description Calculate the tangent of source (degree) into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
TAN(45, result)// result is 1
18-23
Macro Reference
source = 60
TAN(source, result)//
result is 1.732
end macro_command
18-24
Macro Reference
COT
Name
COT(source, result)
Syntax
Description Calculate the cotangent of source (degree) into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
COT(45, result)//
result is 1
source = 60
COT(source, result)//
result is 0.5774
end macro_command
SEC
Name
SEC(source, result)
Syntax
Description Calculate the secant of source (degree) into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
SEC(45, result)//
result is 1.414
source = 60
SEC(source, result)//
end macro_command
CSC
Name
CSC(source, result)
Syntax
Description Calculate the cosecant of source (degree) into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
CSC(45, result)// result is 1.414
source = 30
CSC(source, result)//
result is 2
end macro_command
18-25
Macro Reference
ASIN
Name
ASIN(source, result)
Syntax
Description Calculate the arc sine of source into result (degree).
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
ASIN(0.8660, result)//
result is 60
source = 0.5
ASIN(source, result)//
result is 30
end macro_command
ACOS
Name
ACOS(source, result)
Syntax
Description Calculate the arc cosine of source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
ACOS(0.8660, result)// result is 30
source = 0.5
ACOS(source, result)// result is 60
end macro_command
ATAN
Name
ATAN(source, result)
Syntax
Description Calculate the arc tangent of source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
float source, result
ATAN(1, result)//
result is 45
source = 1.732
ATAN(source, result)// result is 60
end macro_command
18-26
Macro Reference
LOG
Name
LOG (source, result)
Syntax
Description Calculates the natural logarithm of a number.
source can be either a variable or a constant. result must be a variable.
macro_command main()
Example
float source = 100, result
LOG (source, result)//
end macro_command
LOG10
Name
LOG10(source, result)
Syntax
Description Calculates the base-10 logarithm of a number.
source can be either a variable or a constant. result must be a variable.
macro_command main()
Example
float source = 100, result
LOG10 (source, result) // result is 2
end macro_command
RAND
Name
RAND(result)
Syntax
Description Calculates a random integer and save into result.
result must be a variable.
macro_command main()
Example
short result
RAND (result) //result is not a fixed value when executes macro every time
end macro_command
18-27
Macro Reference
18.7.2.
Data Transformation
BIN2BCD
Name
BIN2BCD(source, result)
Syntax
Description Transforms a binary-type value (source) into a BCD-type value (result).
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
short source, result
BIN2BCD(1234, result)// result is 0x1234
source = 5678
BIN2BCD(source, result)//
result is 0x5678
end macro_command
BCD2BIN
Name
BCD2BIN(source, result)
Syntax
Description Transforms a BCD-type value (source) into a binary-type value (result).
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
short source, result
BCD2BIN(0x1234, result)//
result is 1234
source = 0x5678
BCD2BIN(source, result)//
result is 5678
end macro_command
DEC2ASCII
Name
DEC2ASCII(source, result[start], len)
Syntax
Description Transforms a decimal value (source) into an ASCII string and save it to an array
(result).
len represents the length of the string and the unit of length depends on
results type., i.e. if results type is char (the size is byte), the length of the
string is (byte * len). If results type is short (the size is word), the length of
the string is (word * len), and so on.
The first character is put into result[start], the second character is put into
result[start + 1], and the last character is put into result[start + (len -1)].
source and len can be a constant or a variable. result must be a variable. start
must be a constant.
macro_command main()
Example
EasyBuilder Pro V5.01.02
18-28
Macro Reference
short source
char result1[4]
short result2[4]
char result3[6]
source = 5678
DEC2ASCII(source, result1[0], 4)
// result1[0] is '5', result1[1] is '6', result1[2] is '7', result1[3] is '8'
// the length of the string (result1) is 4 bytes( = 1 * 4)
DEC2ASCII(source, result2[0], 4)
// result2[0] is '5', result2[1] is '6', result2[2] is '7', result2[3] is '8'
// the length of the string (result2) is 8 bytes( = 2 * 4)
source=-123
DEC2ASCII(source3, result3[0], 6)
// result1[0] is '-', result1[1] is '0', result1[2] is '0', result1[3] is '1'
// result1[4] is '2', result1[5] is '3'
// the length of the string (result1) is 6 bytes( = 1 * 6)
end macro_command
HEX2ASCII
Name
HEX2ASCII(source, result[start], len)
Syntax
Description Transforms a hexadecimal value (source) into ASCII string saved to an array
(result).
len represents the length of the string and the unit of length depends on
results type., i.e. if results type is char (the size is byte), the length of the
string is (byte * len). If results type is short (the size is word), the length of
the string is (word * len), and so on.
source and len can be a constant or a variable. result must be a variable. start
must be a constant.
macro_command main()
Example
short source
char result[4]
source = 0x5678
HEX2ASCII (source, result[0], 4)
// result[0] is '5', result[1] is '6', result[2] is '7', result[3] is '8'
end macro_command
18-29
Macro Reference
FLOAT2ASCII
Name
FLOAT2ASCII(source, result[start], len)
Syntax
Description Transforms a floating value (source) into ASCII string saved to an array (result).
len represents the length of the string and the unit of length depends on
results type., i.e. if results type is char (the size is byte), the length of the
string is (byte * len). If results type is short (the size is word), the length of
the string is (word * len), and so on.
source and len can be a constant or a variable. result must be a variable. start
must be a constant.
macro_command main()
Example
float source
char result[4]
source = 56.8
FLOAT2ASCII (source, result[0], 4)
// result[0] is '5', result[1] is '6', result[2] is '.', result[3] is '8'
end macro_command
ASCII2DEC
Name
ASCII2DEC(source[start], result, len)
Syntax
Description Transforms a string (source) into a decimal value saved to a variable (result).
The length of the string is len. The first character of the string is source[start].
source and len can be a constant or a variable. result must be a variable. start
must be a constant.
macro_command main()
Example
char source[4]
short result
source[0] = '5'
source[1] = '6'
source[2] = '7'
source[3] = '8'
ASCII2DEC(source[0], result, 4) //
result is 5678
end macro_command
18-30
Macro Reference
ASCII2HEX
Name
ASCII2HEX (source[start], result, len)
Syntax
Description Transforms a string (source) into a hexadecimal value saved to a variable
(result).
The length of the string is len. The first character of the string is source[start].
source and len can be a constant or a variable. result must be a variable. start
must be a constant.
macro_command main()
Example
char source[4]
short result
source[0] = '5'
source[1] = '6'
source[2] = '7'
source[3] = '8'
ASCII2HEX (source[0], result, 4) // result is 0x5678
end macro_command
ASCII2FLOAT
Name
ASCII2FLOAT(source[start], result, len)
Syntax
Description Transforms a string (source) into a float value saved to a variable (result).
The length of the string is len. The first character of the string is source[start].
source and len can be a constant or a variable. result must be a variable. start
must be a constant.
macro_command main()
Example
char source[4]
float result
source[0] = '5'
source[1] = '6'
source[2] = '.'
source[3] = '8'
ASCII2FLOAT (source[0], result, 4) // result is 56.8
end macro_command
18-31
Macro Reference
18.7.3.
Data Manipulation
FILL
Name
FILL(source[start], preset, count)
Syntax
Description Sets the first count elements of an array (source) to a specified value (preset).
source and start must be a variable, and preset can be a constant or variable.
macro_command main()
Example
char result[4]
char preset
FILL(result[0], 0x30, 4)
// result[0] is 0x30, result[1] is 0x30, , result[2] is 0x30, , result[3] is 0x30
preset = 0x31
FILL(result[0], preset, 2) //
end macro_command
SWAPB
Name
SWAPB(source, result)
Syntax
Description Exchanges the high-byte and low-byte data of a 16-bit source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
short source, result
SWAPB(0x5678, result)// result is 0x7856
source = 0x123
SWAPB(source, result)//
result is 0x2301
end macro_command
SWAPW
Name
SWAPW(source, result)
Syntax
Description Exchanges the high-word and low-word data of a 32-bit source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
int source, result
SWAPW (0x12345678, result)// result is 0x56781234
source = 0x12345
SWAPW (source, result)//
result is 0x23450001
end macro_command
EasyBuilder Pro V5.01.02
18-32
Macro Reference
LOBYTE
Name
LOBYTE(source, result)
Syntax
Description Retrieves the low byte of a 16-bit source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
short source, result
LOBYTE(0x1234, result)// result is 0x34
source = 0x123
LOBYTE(source, result)//
result is 0x23
end macro_command
HIBYTE
Name
HIBYTE(source, result)
Syntax
Description Retrieves the high byte of a 16-bit source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
short source, result
HIBYTE(0x1234, result)// result is 0x12
source = 0x123
HIBYTE(source, result)//
result is 0x01
end macro_command
LOWORD
Name
LOWORD(source, result)
Syntax
Description Retrieves the low word of a 32-bit source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
int source, result
LOWORD(0x12345678, result)//
source = 0x12345
LOWORD(source, result)//
result is 0x5678
result is 0x2345
end macro_command
18-33
Macro Reference
HIWORD
Name
HIWORD(source, result)
Syntax
Description Retrieves the high word of a 32-bit source into result.
source can be a constant or a variable. result must be a variable.
macro_command main()
Example
int source, result
HIWORD(0x12345678, result)// result is 0x1234
source = 0x12345
HIWORD(source, result)//
result is 0x0001
end macro_command
18.7.4.
Bit Transformation
GETBIT
Name
GETBIT(source, result, bit_pos)
Syntax
Description Gets the state of designated bit position of a data (source) into result.
result value will be 0 or 1.
source and bit_pos can be a constant or a variable.
result must be a variable.
macro_command main()
Example
int source, result
short bit_pos
GETBIT(9, result, 3)// result is 1
source = 4
bit_pos = 2
GETBIT(source, result, bit_pos)//
result is 1
end macro_command
18-34
Macro Reference
SETBITON
Name
SETBITON(source, result, bit_pos)
Syntax
Description Changes the state of designated bit position of a data (source) to 1, and put
changed data into result.
source and bit_pos can be a constant or a variable.
result must be a variable.
macro_command main()
Example
int source, result
short bit_pos
SETBITON(1, result, 3)// result is 9
source = 0
bit_pos = 2
SETBITON (source, result, bit_pos)//
result is 4
end macro_command
SETBITOFF
Name
SETBITOFF(source, result, bit_pos)
Syntax
Description Changes the state of designated bit position of a data (source) to 0, and put in
changed data into result.
source and bit_pos can be a constant or a variable.
result must be a variable.
macro_command main()
Example
int source, result
short bit_pos
SETBITOFF(9, result, 3)// result is 1
source = 4
bit_pos = 2
SETBITOFF(source, result, bit_pos)//
result is 0
end macro_command
18-35
Macro Reference
INVBIT
Name
INVBIT(source, result, bit_pos)
Syntax
Description Inverts the state of designated bit position of a data (source), and put changed
data into result.
source and bit_pos can be a constant or a variable. result must be a variable.
macro_command main()
Example
int source, result
short bit_pos
INVBIT(4, result, 1)// result = 6
source = 6
bit_pos = 1
INVBIT(source, result, bit_pos)// result = 4
end macro_command
18.7.5.
Communication
DELAY
Name
DELAY(time)
Syntax
Description Suspends the execution of the current macro for at least the specified interval
(time). The unit of time is millisecond.
time can be a constant or a variable.
macro_command main()
Example
int time == 500
DELAY(100)// delay 100 ms
DELAY(time)// delay 500 ms
end macro_command
18-36
Macro Reference
ADDSUM
Name
ADDSUM(source[start], result, data_count)
Syntax
Description Adds up the elements of an array (source) from source[start] to source[start +
data_count - 1] to generate a checksum. Puts in the checksum into result.
result must be a variable. data_count is the amount of the accumulated
elements and can be a constant or a variable.
macro_command main()
Example
char data[5]
short checksum
data[0] = 0x1
data[1] = 0x2
data[2] = 0x3
data[3] = 0x4
data[4] = 0x5
ADDSUM(data[0], checksum, 5)//
checksum is 0xf
end macro_command
XORSUM
Name
XORSUM(source[start], result, data_count)
Syntax
Description Uses an exclusion method to calculate the checksum from source[start] to
source[start + data_count - 1]. Puts the checksum into result. result must be a
variable. data_count is the amount of the calculated elements of the array and
can be a constant or a variable.
macro_command main()
Example
char data[5] = {0x1, 0x2, 0x3, 0x4, 0x5}
short checksum
XORSUM(data[0], checksum, 5)//
checksum is 0x1
end macro_command
CRC
Name
CRC(source[start], result, data_count)
Syntax
Description Calculates 16-bit CRC of the variables from source[start] to source[start +
data_count - 1]. Puts in the 16-bit CRC into result. result must be a variable.
data_count is the amount of the calculated elements of the array and can be a
constant or a variable.
macro_command main()
Example
char data[5] = {0x1, 0x2, 0x3, 0x4, 0x5}
short 16bit_CRC
18-37
Macro Reference
16bit_CRC is 0xbb2a
end macro_command
OUTPORT
Name
OUTPORT(source[start], device_name, data_count)
Syntax
Description Sends out the specified data from source[start] to source[start + count -1] to
PLC via a COM port or the ethernet.
device_name is the name of a device defined in the device table and the device
must be a Free Protocol-type device.
data_count is the amount of sent data and can be a constant or a variable.
To use an OUTPORT function, a Free Protocol device must be created first as
Example
follows:
The device is named MODBUS RTU Device. The port attribute depends on the
setting of this device. (the current setting is 19200,E, 8, 1)
Below is an example of executing an action of writing single coil (SET ON) to a
MODBUS device.
macro_command main()
char command[32]
short address, checksum
FILL(command[0], 0, 32)//
command initialization
force bit on
CRC(command[0], checksum, 6)
18-38
Macro Reference
LOBYTE(checksum, command[6])
HIBYTE(checksum, command[7])
// send out a Write Single Coil command
OUTPORT(command[0], "MODBUS RTU Device", 8)
end macro_command
INPORT
Name
INPORT(read_data[start], device_name, read_count, return_value)
Syntax
Description Reads data from a COM port or the ethernet. These data is stored to
read_data[start]~ read_data[start + read_count - 1].
device_name is the name of a device defined in the device table and the device
must be a Free Protocol-type device.
read_count is the required amount of reading and can be a constant or a
variable.
If the function is used successfully to get sufficient data, return_value is 1,
otherwise is 0.
Below is an example of executing an action of reading holding registers of a
Example
MODBUS device.
// Read Holding Registers
macro_command main()
char command[32], response[32]
short address, checksum
short read_no, return_value, read_data[2]
FILL(command[0], 0, 32)//
FILL(response[0], 0, 32)
command initialization
18-39
Macro Reference
18-40
Macro Reference
Example
will be stored in HMI buffer memory for the next read operation, in order to
prevent losing data. The description of device_name is the same as OUTPORT.
read_count stores the length of the data read each time.
receive_len stores the length of the data received, this must be a variable.
receive_len total length cant exceed the size of response.
macro_command main()
short wResponse[6], receive_len
INPORT3(wResponse[0], "Free Protocol", 6, receive_len)
// read 6 words
end if
end macro_command
GetData
GetData(read_data[start], device_name, device_type, address_offset,
data_count)
or
GetData(read_data, device_name, device_type, address_offset, 1)
Description Receives data from the PLC. Data is stored into read_data[start]~
read_data[start + data_count - 1].
data_count is the amount of received data. In general, read_data is an array,
but if data_count is 1, read_data can be an array or an ordinary variable. Below
are two methods to read one word data from PLC.
Name
Syntax
macro_command main()
short read_data_1[2], read_data_2
GetData(read_data_1*0+, FATEK KB Series, RT, 5, 1)
GetData(read_data_2,
FATEK KB Series, RT, 5, 1)
end macro_command
Device_name is the PLC name enclosed in the double quotation marks () and
this name has been defined in the device list of system parameters as follows
(see FATEK KB Series):
18-41
Macro Reference
Device_type is the device type and encoding method (binary or BCD) of the PLC
data. For example, if device_type is LW_BIN, it means the register is LW and the
encoding method is binary. If use BIN encoding method, _BIN can be ignored.
If device_type is LW_BCD, it means the register is LW and the encoding method
is BCD.
Address_offset is the address offset in the PLC.
For example, GetData(read_data_1*0+, FATEK KB Series, RT, 5, 1) represents
that the address offset is 5.
If address_offset uses the format N#AAAAA, N indicates that PLCs station
number is N. AAAAA represents the address offset. This format is used while
multiple PLCs or controllers are connected to a single serial port. For example,
GetData(read_data_1*0+, FATEK KB Series, RT, 2#5, 1) represents that the
PLCs station number is 2. If GetData() uses the default station number defined
in the device list as follows, it is not necessary to define station number in
address_offset.
The number of registers actually read from depends on both the type of the
EasyBuilder Pro V5.01.02
18-42
Macro Reference
Example
macro_command main()
float f
GetData(f, "MODBUS", 6x, 2, 1)
end macro_command
macro_command main()
bool a
bool b[30]
short c
short d[50]
int e
int f[10]
double g[10]
18-43
Macro Reference
// get 20 words (10 integer values) from LW-0 ~ LW-19 to variables f[0] ~ f[9]
// since each integer value occupies 2 words
GetData(f*0+, Local HMI, LW, 0, 10)
// get 2 words from LW-2 ~ LW-3 to the variable f
GetData(f, Local HMI, LW, 2, 1)
end macro_command
GetDataEx
GetDataEx(read_data[start], device_name, device_type, address_offset,
data_count)
or
GetDataEx(read_data, device_name, device_type, address_offset, 1)
Description Receives data from the PLC and continue executing next command even if no
response from this device.
Descriptions of read_data, device_name, device_type, address_offset and
data_count are the same as GetData.
Name
Syntax
Example
macro_command main()
bool a
bool b[30]
short c
short d[50]
int e
int f[10]
double g[10]
// get the state of LB2 to the variable a
GetDataEx (a, Local HMI, LB, 2, 1)
// get 30 states of LB0 ~ LB29 to the variables b[0] ~ b[29]
GetDataEx (b*0+, Local HMI, LB, 0, 30)
// get one word from LW-2 to the variable c
GetDataEx (c, Local HMI, LW, 2, 1)
// get 50 words from LW-0 ~ LW-49 to the variables d[0] ~ d[49]
GetDataEx (d*0+, Local HMI, LW, 0, 50)
// get 2 words from LW-6 ~ LW-7 to the variable e
// note that he type of e is int
GetDataEx (e, Local HMI, LW, 6, 1)
//
get 20 words (10 integer values) from LW-0 ~ LW-19 to f[0] ~ f[9]
EasyBuilder Pro V5.01.02
18-44
Macro Reference
macro_command main()
short send_data_1[2] = { 5, 6}, send_data_2 = 5
SetData(send_data_1*0+, FATEK KB Series, RT, 5, 1)
SetData(send_data_2, FATEK KB Series, RT, 5, 1)
end macro_command
device_name is the PLC name enclosed in the double quotation marks () and
this name has been defined in the device list of system parameters.
device_type is the device type and encoding method (binary or BCD) of the PLC
data. For example, if device_type is LW_BIN, it means the register is LW and the
encoding method is binary. If use BIN encoding method, _BIN can be ignored.
If device_type is LW_BCD, it means the register is LW and the encoding method
is BCD.
address_offset is the address offset in the PLC.
For example, SetData(read_data_1*0+, FATEK KB Series, RT, 5, 1) represents
that the address offset is 5.
If address_offset uses the format N#AAAAA, N indicates that PLCs station
number is N. AAAAA represents the address offset. This format is used while
multiple PLCs or controllers are connected to a single serial port. For example,
SetData(read_data_1*0+, FATEK KB Series, RT, 2#5, 1) represents that the PLCs
station number is 2. If SetData () uses the default station number defined in the
device list, it is not necessary to define station number in address_offset.
The number of registers actually sends to depends on both the type of the
send_data variable and the value of the number of data_count.
18-45
Macro Reference
type of read_data
data_count
actual number of
16-bit register send
char (8-bit)
1
1
char (8-bit)
2
1
bool (8-bit)
1
1
bool (8-bit)
2
1
short (16-bit)
1
1
short (16-bit)
2
2
int (32-bit)
1
2
int (32-bit)
2
4
float (32-bit)
1
2
float (32-bit)
2
4
When a SetData() is executed using a 32-bit data type (int or float), the function
will automatically send int-format or float-format data to the device. For
example,
Example
macro_command main()
float f = 2.6
SetData(f, "MODBUS", 6x, 2, 1)
device
end macro_command
macro_command main()
int i
bool a = true
bool b[30]
short c = false
short d[50]
int e = 5
int f[10]
for i = 0 to 29
b[i] = true
next i
for i = 0 to 49
d[i] = i * 2
next i
for i = 0 to 9
f [i] = i * 3
next i
// set the state of LB2
SetData(a, Local HMI, LB, 2, 1)
18-46
Macro Reference
Example
macro_command main()
int i
bool a = true
bool b[30]
short c = false
short d[50]
int e = 5
int f[10]
for i = 0 to 29
b[i] = true
next i
for i = 0 to 49
d[i] = i * 2
next i
18-47
Macro Reference
for i = 0 to 9
f [i] = i * 3
next i
// set the state of LB2
SetDataEx (a, Local HMI, LB, 2, 1)
// set the states of LB0 ~ LB29
SetDataEx (b*0+, Local HMI, LB, 0, 30)
// set the value of LW-2
SetDataEx (c, Local HMI, LW, 2, 1)
// set the values of LW-0 ~ LW-49
SetDataEx (d*0+, Local HMI, LW, 0, 50)
// set the values of LW-6 ~ LW-7, note that the type of e is int
SetDataEx (e, Local HMI, LW, 6, 1)
// set the values of LW-0 ~ LW-19
// 10 integers equal to 20 words, since each integer value occupies 2 words.
SetDataEx (f*0+, Local HMI, LW, 0, 10)
end macro_command
Name
Syntax
Description
Example
GetError
GetError (err)
Get an error code.
macro_command main()
short err
char byData[10]
GetDataEx(byData[0], MODBUS RTU, 4x, 1, 10)// read 10 bytes
// if err is equal to 0, it is successful to execute GetDataEx()
GetErr(err)// save an error code to err
end macro_command
PURGE
Name
PURGE (com_port)
Syntax
Description com_port refers to the COM port number which ranges from 1 to 3. It can be
either a variable or a constant. This function is used to clear the input and
output buffers associated with the COM port.
macro_command main()
Example
EasyBuilder Pro V5.01.02
18-48
Macro Reference
int com_port=3
PURGE (com_port)
PURGE (1)
end macro_command
SetRTS
Name
SetRTS(com_port, source)
Syntax
Description Set RTS state for RS232.
com_port refers to the COM port number. It can be either a variable or a
constant. source can be either a variable or a constant.
This command raise RTS signal while the value of source is greater than 0 and
lower RTS signal while the value of source equals to 0.
macro_command main()
Example
char com_port=1
char value=1
SetRTS(com_port, value) // raise RTS signal of COM1 while value>0
SetRTS(1, 0) // lower RTS signal of COM1
end macro_command
18-49
Macro Reference
GetCTS
Name
GetCTS(com_port, result)
Syntax
Description Get CTS state for RS232.
com_port refers to the COM port number. It can be either a variable or a
constant. result is used for receiving the CTS signal. It must be a variable.
This command receives CTS signal and stores the received data in the result
variable. When the CTS signal is pulled high, it writes 1 to result, otherwise, it
writes 0.
macro_command main()
Example
char com_port=1
char result
GetCTS(com_port, result) // get CTS signal of COM1
GetCTS (1, result) // get CTS signal of COM1
end macro_command
18.7.6.
StringGet
StringGet(read_data[start], device_name, device_type, address_offset,
data_count)
Description Receives data from the PLC. The String data is stored into read_data[start]~
read_data[start + data_count - 1]. read_data must be a one-dimensional char
array.
Data_count is the number of received characters, it can be either a constant or
a variable.
Device_name is the PLC name enclosed in the double quotation marks () and
this name has been defined in the device list of system parameters as follows
(see FATEK KB Series):
Name
Syntax
Device_type is the device type and encoding method (binary or BCD) of the PLC
data. For example, if device_type is LW_BIN, it means the register is LW and the
encoding method is binary. If use BIN encoding method, _BIN can be ignored.
If device_type is LW_BCD, it means the register is LW and the encoding method
is BCD.
EasyBuilder Pro V5.01.02
18-50
Macro Reference
Example
The number of registers actually read from depends on the value of the
number of data_count since that the read_data is restricted to char array.
type of read_data
data_count
actual number of
16-bit register read
char (8-bit)
1
1
char (8-bit)
2
1
1 WORD register(16-bit) equals to the size of 2 ASCII characters. According to
the above table, reading 2 ASCII characters is actually reading the content of
one 16-bit register.
macro_command main()
char str1[20]
//
18-51
Macro Reference
18-52
Macro Reference
StringSet
StringSet(send_data[start], device_name, device_type, address_offset,
data_count)
Description Send data to the PLC. Data is defined in send_data[start]~ send_data[start +
data_count - 1]. send_data must be a one-dimensional char array.
data_count is the number of sent characters, it can be either a constant or a
variable.
device_name is the PLC name enclosed in the double quotation marks () and
this name has been defined in the device list of system parameters.
device_type is the device type and encoding method (binary or BCD) of the PLC
data. For example, if device_type is LW_BIN, it means the register is LW and the
encoding method is binary. If use BIN encoding method, _BIN can be ignored.
If device_type is LW_BCD, it means the register is LW and the encoding method
is BCD.
address_offset is the address offset in the PLC.
For example, StringSet(read_data_1*0+, FATEK KB Series, RT, 5, 1) represents
that the address offset is 5.
If address_offset uses the format N#AAAAA, N indicates that PLCs station
number is N. AAAAA represents the address offset. This format is used while
multiple PLCs or controllers are connected to a single serial port. For example,
StringSet(read_data_1[0], FATEK KB Series, RT, 2#5, 1) represents that the
PLCs station number is 2. If SetData () uses the default station number defined
in the device list, it is not necessary to define station number in address_offset.
Name
Syntax
The number of registers actually sends to depends on the value of the number
of data_count, since that send_data is restricted to char array.
type of
read_data
char (8-bit)
char (8-bit)
data_count
1
2
actual number of
16-bit register send
1
1
18-53
Macro Reference
Example
macro_command main()
char str1[10]=abcde
// Send 3 words to LW-0~LW-2
// Data are being sent until the end of string is reached.
// Even though the value of data_count is larger than the length of string
// , the function will automatically stop.
StringSet(str1[0], "Local HMI", LW, 0, 10)
end macro_command
StringSetEx
StringSetEx (send_data[start], device_name, device_type, address_offset,
data_count)
Description Send data to the PLC and continue executing next command even if no
response from this device.
Descriptions of send_data, device_name, device_type, address_offset and
data_count are the same as StringSet.
macro_command main()
Example
char str1[20]=abcde
short test=0
Name
Syntax
18-54
Macro Reference
end macro_command
StringCopy
success = StringCopy (source, destination[start])
or
success = StringCopy (source[start], destination[start])
Description Copy one string to another. This function copies a static string (which is
enclosed in quotes) or a string that is stored in an array to the destination
buffer.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
destination[start] must be an one-dimensional char array.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of source string exceeds the max. size of destination buffer, it returns
false and the content of destination remains the same.
The success field is optional.
macro_command main()
Example
char src1[5]="abcde"
char dest1[5]
bool success1
success1 = StringCopy(src1[0], dest1[0])
// success1=true, dest1="abcde"
Name
Syntax
char dest2[5]
bool success2
success2 = StringCopy("12345", dest2[0])
// success2=true, dest2="12345"
char src3[10]="abcdefghij"
char dest3[5]
bool success3
success3 = StringCopy(src3[0], dest3[0])
// success3=false, dest3 remains the same.
char src4[10]="abcdefghij"
char dest4[5]
bool success4
success4 = StringCopy(src4[5], dest4[0])
// success4=true, dest4="fghij"
end macro_command
18-55
Macro Reference
StringDecAsc2Bin
success = StringDecAsc2Bin(source[start], destination)
or
success = StringDecAsc2Bin(source, destination)
Description This function converts a decimal string to an integer. It converts the decimal
string in source parameter into an integer, and stores it in the destination
variable.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
Destination must be a variable, to store the result of conversion.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
source string contains characters other than 0 to 9, it returns false.
The success field is optional.
macro_command main()
Example
char src1[5]="12345"
int result1
bool success1
success1 = StringDecAsc2Bin(src1[0], result1)
// success1=true, result1 is 12345
Name
Syntax
char result2
bool success2
success2 = StringDecAsc2Bin("32768", result2)
// success2=true, but the result exceeds the data range of result2
char src3[2]="4b"
char result3
bool success3
success3 = StringDecAsc2Bin (src3[0], result3)
// success3=false, because src3 contains characters other than 0 to 9
end macro_command
18-56
Macro Reference
StringBin2DecAsc
Name
success = StringBin2DecAsc (source, destination[start])
Syntax
Description This function converts an integer to a decimal string. It converts the integer in
source parameter into a decimal string, and stores it in the destination buffer.
Source can be either a constant or a variable.
Destination must be an one-dimensional char array, to store the result of
conversion.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of decimal string after conversion exceeds the size of destination buffer,
it returns false.
The success field is optional.
macro_command main()
Example
int src1 = 2147483647
char dest1[20]
bool success1
success1 = StringBin2DecAsc(src1, dest1[0])
// success1=true, dest1=2147483647
short src2 = 0x3c
char dest2[20]
bool success2
success2 = StringBin2DecAsc(src2, dest2[0])
// success2=true, dest2="60"
int src3 = 2147483647
char dest3[5]
bool success3
success3 = StringBin2DecAsc(src3, dest3[0])
// success3=false, dest3 remains the same.
end macro_command
18-57
Macro Reference
StringDecAsc2Float
success = StringDecAsc2Float (source[start], destination)
or
success = StringDecAsc2Float (source, destination)
Description This function converts a decimal string to floats. It converts the decimal string
in source parameter into float, and stores it in the destination variable.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
Destination must be a variable, to store the result of conversion.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
source string contains characters other than 0 to 9 or ., it returns false.
The success field is optional.
macro_command main()
Example
char src1[10]="12.345"
float result1
bool success1
success1 = StringDecAsc2Float(src1[0], result1)
// success1=true, result1 is 12.345
Name
Syntax
float result2
bool success2
success2 = StringDecAsc2Float("1.234567890", result2)
// success2=true, but the result exceeds the data range of result2, which
// might result in loss of precision
char src3[2]="4b"
float result3
bool success3
success3 = StringDecAsc2Float(src3[0], result3)
// success3=false, because src3 contains characters other than 0 to 9 or
// .
end macro_command
18-58
Macro Reference
StringFloat2DecAsc
Name
success = StringFloat2DecAsc(source, destination[start])
Syntax
Description This function converts a float to a decimal string. It converts the float in source
parameter into a decimal string, and stores it in the destination buffer.
Source can be either a constant or a variable.
Destination must be an one-dimensional char array, to store the result of
conversion.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of decimal string after conversion exceeds the size of destination buffer,
it returns false.
The success field is optional.
macro_command main()
Example
float src1 = 1.2345
char dest1[20]
bool success1
success1 = StringFloat2DecAsc(src1, dest1[0])
// success1=true, dest1="1.2345"
float src2 = 1.23456789
char dest2 [20]
bool success2
success2 = StringFloat2DecAsc(src2, dest2 [0])
// success2=true, but it might lose precision
float src3 = 1.2345
char dest3[5]
bool success3
success3 = StringFloat2DecAsc(src3, dest3 [0])
// success3=false, dest3 remains the same.
end macro_command
18-59
Macro Reference
StringHexAsc2Bin
success = StringHexAsc2Bin (source[start], destination)
or
success = StringHexAsc2Bin (source, destination)
Description This function converts a hexadecimal string to binary data. It converts the
hexadecimal string in source parameter into binary data, and stores it in the
destination variable.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
Destination must be a variable, to store the result of conversion.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
source string contains characters other than 0 to 9, a to f or A to F, it
returns false.
The success field is optional.
macro_command main()
Example
char src1[5]="0x3c"
int result1
bool success1
success1 = StringHexAsc2Bin(src1[0], result1)
// success1=true, result1 is 3c
Name
Syntax
short result2
bool success2
success2 = StringDecAsc2Bin("1a2b3c4d", result2)
// success2=true, result2=3c4d.The result exceeds the data range of
// result2
char src3[2]="4g"
char result3
bool success3
success3 = StringDecAsc2Bin (src3[0], result3)
// success3=false, because src3 contains characters other than 0 to 9
// , a to f or A to F
end macro_command
18-60
Macro Reference
StringBin2HexAsc
Name
success = StringBin2HexAsc (source, destination[start])
Syntax
Description This function converts binary data to a hexadecimal string. It converts the
binary data in source parameter into a hexadecimal string, and stores it in the
destination buffer.
Source can be either a constant or a variable.
Destination must be an one-dimensional char array, to store the result of
conversion.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of hexadecimal string after conversion exceeds the size of destination
buffer, it returns false.
The success field is optional.
macro_command main()
Example
int src1 = 20
char dest1[20]
bool success1
success1 = StringBin2HexAsc(src1, dest1[0])
// success1=true, dest1="14"
short src2 = 0x3c
char dest2[20]
bool success2
success2 = StringBin2HexAsc(src2, dest2[0])
// success2=true, dest2="3c"
int src3 = 0x1a2b3c4d
char dest3[6]
bool success3
success3 = StringBin2HexAsc(src3, dest3[0])
// success3=false, dest3 remains the same.
end macro_command
18-61
Macro Reference
StringMid
success = StringMid (source[start], count, destination[start])
or
success = StringMid (string, start, count, destination[start])
Description Retrieve a character sequence from the specified offset of the source string and
store it in the destination buffer.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]). For source[start], the start offset of
the substring is specified by the index value. For static source string(source),
the second parameter(start) specifies the start offset of the substring.
The count parameter specifies the length of substring being retrieved.
Destination must be an one-dimensional char array, to store the retrieved
substring.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of retrieved substring exceeds the size of destination buffer, it returns
false.
The success field is optional.
macro_command main()
Example
char src1[20]="abcdefghijklmnopqrst"
char dest1[20]
bool success1
success1 = StringMid(src1[5], 6, dest1[0])
// success1=true, dest1="fghijk"
Name
Syntax
char src2[20]="abcdefghijklmnopqrst"
char dest2[5]
bool success2
success2 = StringMid(src2[5], 6, dest2[0])
// success2=false, dest2 remains the same.
char dest3[20]="12345678901234567890"
bool success3
success3 = StringMid("abcdefghijklmnopqrst", 5, 5, dest3[15])
// success3= true, dest3="123456789012345fghij"
end macro_command
18-62
Macro Reference
StringLength
length = StringLength (source[start])
or
length = StringLength (source)
Description Obtain the length of a string. It returns the length of source string and stores it
in the length field on the left-hand side of = operator.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
The return value of this function indicates the length of the source string.
macro_command main()
Example
char src1[20]="abcde"
int length1
length1= StringLength(src1[0])
// length1=5
Name
Syntax
18-63
Macro Reference
StringCat
success = StringCat (source[start], destination[start])
or
success = StringCat (source, destination[start])
Description This function appends source string to destination string. It adds the contents
of source string to the last of the contents of destination string.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
Destination must be an one-dimensional char array.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of result string after concatenation exceeds the max. size of destination
buffer, it returns false.
The success field is optional.
macro_command main()
Example
char src1[20]="abcdefghij"
char dest1[20]="1234567890"
bool success1
success1= StringCat(src1[0], dest1[0])
// success1=true, dest1="123456790abcdefghij"
Name
Syntax
18-64
Macro Reference
StringCompare
ret = StringCompare (str1[start], str2[start])
ret = StringCompare (string1, str2[start])
ret = StringCompare (str1[start], string2)
ret = StringCompare (string1, string2)
Description Do a case-sensitive comparison of two strings.
The two string parameters accept both static string (in the form: string1) and
char array (in the form: str1[start]).
This function returns a Boolean indicating the result of comparison. If two
strings are identical, it returns true. Otherwise it returns false.
The ret field is optional.
macro_command main()
Example
char a1[20]="abcde"
char b1[20]="ABCDE"
bool ret1
ret1= StringCompare(a1[0], b1[0])
// ret1=false
Name
Syntax
char a2[20]="abcde"
char b2[20]="abcde"
bool ret2
ret2= StringCompare(a2[0], b2[0])
// ret2=true
char a3 [20]="abcde"
char b3[20]="abcdefg"
bool ret3
ret3= StringCompare(a3[0], b3[0])
// ret3=false
end macro_command
18-65
Macro Reference
StringCompareNoCase
ret = StringCompareNoCase(str1[start], str2[start])
ret = StringCompareNoCase(string1, str2[start])
ret = StringCompareNoCase(str1[start], string2)
ret = StringCompareNoCase(string1, string2)
Description Do a case-insensitive comparison of two strings.
The two string parameters accept both static string (in the form: string1) and
char array (in the form: str1[start]).
This function returns a Boolean indicating the result of comparison. If two
strings are identical, it returns true. Otherwise it returns false.
The ret field is optional.
macro_command main()
Example
char a1[20]="abcde"
char b1[20]="ABCDE"
bool ret1
ret1= StringCompareNoCase(a1[0], b1[0])
// ret1=true
Name
Syntax
char a2[20]="abcde"
char b2[20]="abcde"
bool ret2
ret2= StringCompareNoCase(a2[0], b2[0])
// ret2=true
char a3 [20]="abcde"
char b3[20]="abcdefg"
bool ret3
ret3= StringCompareNoCase(a3[0], b3[0])
// ret3=false
end macro_command
18-66
Macro Reference
StringFind
position = StringFind (source[start], target[start])
position = StringFind (source, target[start])
position = StringFind (source[start], target)
position = StringFind (source, target)
Description Return the position of the first occurrence of target string in the source string.
The two string parameters accept both static string (in the form: source) and
char array (in the form: source[start]).
This function returns the zero-based index of the first character of substring in
the source string that matches the target string. Notice that the entire
sequence of characters to find must be matched. If there is no matched
substring, it returns -1.
macro_command main()
Example
char src1[20]="abcde"
char target1[20]="cd"
bool pos1
pos1= StringFind(src1[0], target1[0])
// pos1=2
Name
Syntax
char target2[20]="ce"
bool pos2
pos2= StringFind("abcde", target2[0])
// pos2=-1
char src3[20]="abcde"
bool pos3
pos3= StringFind(src3[3], "cd")
// pos3=-1
end macro_command
18-67
Macro Reference
StringReverseFind
position = StringReverseFind (source[start], target[start])
position = StringReverseFind (source, target[start])
position = StringReverseFind (source[start], target)
position = StringReverseFind (source, target)
Description Return the position of the last occurrence of target string in the source string.
The two string parameters accept both static string (in the form: source) and
char array (in the form: source[start]).
This function returns the zero-based index of the first character of substring in
the source string that matches the target string. Notice that the entire
sequence of characters to find must be matched. If there exists multiple
substrings that matches the target string, function will return the position of
the last matched substring. If there is no matched substring, it returns -1.
macro_command main()
Example
char src1[20]="abcdeabcde"
char target1[20]="cd"
bool pos1
pos1= StringReverseFind(src1[0], target1[0])
// pos1=7
Name
Syntax
char target2[20]="ce"
bool pos2
pos2= StringReverseFind("abcdeabcde", target2[0])
// pos2=-1
char src3[20]="abcdeabcde"
bool pos3
pos3= StringReverseFind(src3[6], "ab")
// pos3=-1
end macro_command
18-68
Macro Reference
StringFindOneOf
position = StringFindOneOf (source[start], target[start])
position = StringFindOneOf (source, target[start])
position = StringFindOneOf (source[start], target)
position = StringFindOneOf (source, target)
Description Return the position of the first character in the source string that matches any
character contained in the target string.
The two string parameters accept both static string (in the form: source) and
char array (in the form: source[start]).
This function returns the zero-based index of the first character in the source
string that is also in the target string. If there is no match, it returns -1.
macro_command main()
Example
char src1[20]="abcdeabcde"
char target1[20]="sdf"
bool pos1
pos1= StringFindOneOf(src1[0], target1[0])
// pos1=3
Name
Syntax
char src2[20]="abcdeabcde"
bool pos2
pos2= StringFindOneOf(src2[1], "agi")
// pos2=4
char target3 [20]="bus"
bool pos3
pos3= StringFindOneOf("abcdeabcde", target3[1])
// pos3=-1
end macro_command
18-69
Macro Reference
StringIncluding
success = StringIncluding (source[start], set[start], destination[start])
success = StringIncluding (source, set[start], destination[start])
success = StringIncluding (source[start], set, destination[start])
success = StringIncluding (source, set, destination[start])
Description Retrieve a substring of the source string that contains characters in the set
string, beginning with the first character in the source string and ending when a
character is found in the source string that is not in the target string.
The source string and set string parameters accept both static string (in the
form: source) and char array (in the form: source[start]).
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of retrieved substring exceeds the size of destination buffer, it returns
false.
macro_command main()
Example
char src1[20]="cabbageabc"
char set1[20]="abc"
char dest1[20]
bool success1
success1 = StringIncluding(src1[0], set1[0], dest1[0])
// success1=true, dest1="cabba"
Name
Syntax
char src2[20]="gecabba"
char dest2[20]
bool success2
success2 = StringIncluding(src2[0], "abc", dest2[0])
// success2=true, dest2=""
char set3[20]="abc"
char dest3[4]
bool success3
success3 = StringIncluding("cabbage", set3[0], dest3[0])
// success3=false, dest3 remains the same.
end macro_command
18-70
Macro Reference
StringExcluding
success = StringExcluding (source[start], set[start], destination[start])
success = StringExcluding (source, set[start], destination[start])
success = StringExcluding (source[start], set, destination[start])
success = StringExcluding (source, set, destination[start])
Description Retrieve a substring of the source string that contains characters that are not in
the set string, beginning with the first character in the source string and ending
when a character is found in the source string that is also in the target string.
The source string and set string parameters accept both static string (in the
form: source) and char array (in the form: source[start]).
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of retrieved substring exceeds the size of destination buffer, it returns
false.
macro_command main()
Example
char src1[20]="cabbageabc"
char set1[20]="ge"
char dest1[20]
bool success1
success1 = StringExcluding(src1[0], set1[0], dest1[0])
// success1=true, dest1="cabba"
Name
Syntax
char src2[20]="cabbage"
char dest2[20]
bool success2
success2 = StringExcluding(src2[0], "abc", dest2[0])
// success2=true, dest2=""
char set3[20]="ge"
char dest3[4]
bool success3
success3 = StringExcluding("cabbage", set3[0], dest3[0])
// success3=false, dest3 remains the same.
end macro_command
18-71
Macro Reference
StringToUpper
success = StringToUpper (source[start], destination[start])
success = StringToUpper (source, destination[start])
Description Convert all the characters in the source string to uppercase characters and
store the result in the destination buffer.
The source string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of result string after conversion exceeds the size of destination buffer, it
returns false.
macro_command main()
Example
char src1[20]="aBcDe"
char dest1[20]
bool success1
success1 = StringToUpper(src1[0], dest1[0])
// success1=true, dest1="ABCDE"
Name
Syntax
char dest2[4]
bool success2
success2 = StringToUpper("aBcDe", dest2[0])
// success2=false, dest2 remains the same.
end macro_command
StringToLower
success = StringToLower (source[start], destination[start])
success = StringToLower (source, destination[start])
Description Convert all the characters in the source string to lowercase characters and store
the result in the destination buffer.
The source string parameter accepts both static string (in the form: "source")
and char array (in the form: source[start]).
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of result string after conversion exceeds the size of destination buffer, it
returns false.
Name
Syntax
18-72
Macro Reference
Example
macro_command main()
char src1[20]="aBcDe"
char dest1[20]
bool success1
success1 = StringToUpper(src1[0], dest1[0])
// success1=true, dest1="abcde"
char dest2[4]
bool success2
success2 = StringToUpper("aBcDe", dest2[0])
// success2=false, dest2 remains the same.
end macro_command
StringToReverse
success = StringToReverse (source[start], destination[start])
success = StringToReverse (source, destination[start])
Description Reverse the characters in the source string and store it in the destination buffer.
The source string parameter accepts both static string (in the form: "source")
and char array (in the form: source[start]).
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of reversed string exceeds the size of destination buffer, it returns false.
macro_command main()
Example
char src1[20]="abcde"
char dest1[20]
bool success1
success1 = StringToUpper(src1[0], dest1[0])
// success1=true, dest1="edcba"
Name
Syntax
char dest2[4]
bool success2
success2 = StringToUpper("abcde", dest2[0])
// success2=false, dest2 remains the same.
end macro_command
18-73
Macro Reference
StringTrimLeft
success = StringTrimLeft (source[start], set[start], destination[start])
success = StringTrimLeft (source, set[start], destination[start])
success = StringTrimLeft (source[start], set, destination[start])
success = StringTrimLeft (source, set, destination[start])
Description Trim the leading specified characters in the set buffer from the source string.
The source string and set string parameters accept both static string (in the
form: source) and char array (in the form: source[start]).
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of trimmed string exceeds the size of destination buffer, it returns false.
macro_command main()
Example
char src1[20]= "# *a*#bc"
char set1[20]="# *"
char dest1[20]
bool success1
success1 = StringTrimLeft (src1[0], set1[0], dest1[0])
// success1=true, dest1="a*#bc"
Name
Syntax
18-74
Macro Reference
StringTrimRight
success = StringTrimRight (source[start], set[start], destination[start])
success = StringTrimRight (source, set[start], destination[start])
success = StringTrimRight (source[start], set, destination[start])
success = StringTrimRight (source, set, destination[start])
Description Trim the trailing specified characters in the set buffer from the source string.
The source string and set string parameters accept both static string (in the
form: source) and char array (in the form: source[start]).
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of trimmed string exceeds the size of destination buffer, it returns false.
macro_command main()
Example
char src1[20]= "# *a*#bc# * "
char set1[20]="# *"
char dest1[20]
bool success1
success1 = StringTrimRight(src1[0], set1[0], dest1[0])
// success1=true, dest1="# *a*#bc"
Name
Syntax
18-75
Macro Reference
StringInsert
success = StringInsert (pos, insert[start], destination[start])
success = StringInsert (pos, insert, destination[start])
success = StringInsert (pos, insert[start], length, destination[start])
success = StringInsert (pos, insert, length, destination[start])
Description Insert a string in a specific location within the destination string content. The
insert location is specified by the pos parameter.
The insert string parameter accepts both static string (in the form: source)
and char array (in the form: source[start]).
The number of characters to insert can be specified by the length parameter.
This function returns a Boolean indicating whether the process is successfully
done or not. If successful, it returns true, otherwise it returns false. If the
length of string after insertion exceeds the size of destination buffer, it returns
false.
macro_command main()
Example
Name
Syntax
18-76
Macro Reference
18.7.7.
RecipeGetData
Name
RecipeGetData(destination, recipe_address, record_ID)
Syntax
Description Get Recipe Data. The gained data will be stored in destination, and must be a
variable. recipe_address consists of recipe name and item name:
recipe_name.item_name. record_ID specifies the ID number of the record in
recipe being gained.
macro_command main()
Example
int data=0
char str[20]
int recordID
bool result
recordID = 0
result = RecipeGetData(data, "TypeA.item_weight", recordID)
// From recipe "TypeA" get the data of the item item_weight in record 0.
recordID = 1
result = RecipeGetData(str[0], "TypeB.item_name", recordID)
// From recipe "TypeB" get the data of the item item_name in record 1.
end macro_command
RecipeQuery
Name
RecipeQuery (SQL_command, destination)
Syntax
Description Use SQL statement to query recipe data. The number of records of query result
will be stored in the destination. This must be a variable. SQL command can be
static string or char array. Example:
RecipeQuery(SELECT * FROM TypeA, destination)
or
RecipeQuery(sql[0], destination)
SQL statement must start with SELECT * FROM followed by recipe name and
query condition.
macro_command main()
Example
int total_row=0
char sql[100]="SELECT * FROM TypeB"
bool result
result = RecipeQuery("SELECT * FROM TypeA", total_row)
// Query Recipe "TypeA". Store the number of records of query result in
total_row.
result = RecipeQuery(sql[0], total_row)
// Query Recipe "TypeB". Store the number of records of query result in
total_row.
18-77
Macro Reference
end macro_command
RecipeQueryGetData
Name
RecipeQueryGetData (destination, recipe_address, result_row_no)
Syntax
Description Get the data in the query result obtained by RecipeQuery. This function must
be called after calling RecipeQuery, and specify the same recipe name in
recipe_address as RecipeQuery.
result_row_no specifies the sequence row number in query result
macro_command main()
Example
int data=0
int total_row=0
int row_number=0
bool result_query
bool result_data
result_query = RecipeQuery("SELECT * FROM TypeA", total_row)
// Query Recipe "TypeA". Store the number of records of query result in
total_row.
if (result_query) then
for row_number=0 to total_row-1
result_data = RecipeQueryGetData(data, "TypeA.item_weight", row_number)
next row_number
end if
end macro_command
RecipeQueryGetRecordID
Name
RecipeQueryGetRecordID (destination, result_row_no)
Syntax
Description Get the record ID numbers of those records gained by RecipeQuery. This
function must be called after calling RecipeQuery.
result_row_no specifies the sequence row number in query result, and write
the obtained record ID to destination.
macro_command main()
Example
int recordID=0
int total_row=0
int row_number=0
bool result_query
bool result_id
result_query = RecipeQuery("SELECT * FROM TypeA", total_row)
// Query Recipe "TypeA". Store the number of records of query result in
total_row.
if (result_query) then
for row_number=0 to total_row-1
result_id = RecipeQueryGetRecordID(recordID, row_number)
EasyBuilder Pro V5.01.02
18-78
Macro Reference
next row_number
end if
end macro_command
RecipeSetData
Name
RecipeSetData(source, recipe address, record_ID)
Syntax
Description Write data to recipe. If success, returns true, else, returns false.
recipe_address consists of recipe name and item name:
recipe_name.item_name.
record_ID specifies the ID number of the record in recipe being modified.
macro_command main()
Example
int data=99
char str[20]="abc"
int recordID
bool result
recordID = 0
result = RecipeSetData(data, "TypeA.item_weight", recordID)
// set data to recipe "TypeA", where item name is "item_weight" and the
record ID is 0.
recordID = 1
result = RecipeSetData(str[0], "TypeB.item_name", recordID)
// set data to recipe "TypeB", where item name is "item_name" and the record
ID is 1.
end macro_command
18.7.8.
Miscellaneous
Beep
Name
Beep ()
Syntax
Description Plays beep sound.
This command plays a beep sound with frequency of 800 hertz and duration of
30 milliseconds.
macro_command main()
Example
Beep()
end macro_command
18-79
Macro Reference
Buzzer
Name
Buzzer ()
Syntax
Description Turn ON / OFF the buzzer.
Example
char on = 1, off = 0
Buzzer(on)
//
SYNC_TRIG_MACRO
Name
SYNC_TRIG_MACRO(macro_id or name)
Syntax
Description Trigger the execution of a macro synchronously (use macro_id or macro name
to designate this macro) in a running macro.
The current macro will pause until the end of execution of this called macro.
macro_id can be a constant or a variable.
macro_command main()
Example
char ON = 1, OFF = 0
SetData(ON, Local HMI, LB, 0, 1)
SYNC_TRIG_MACRO(5)//
SYNC_TRIG_MACRO(macro_1)
18-80
Macro Reference
ASYNC_TRIG_MACRO
Name
ASYNC_TRIG_MACRO (macro_id or name)
Syntax
Description Trigger the execution of a macro asynchronously (use macro_id or macro name
to designate this macro) in a running macro.
The current macro will continue executing the following instructions after
triggering the designated macro; in other words, the two macros will be active
simultaneously.
macro_id can be a constant or a variable.
macro_command main()
Example
char ON = 1, OFF = 0
SetData(ON, Local HMI, LB, 0, 1)
ASYNC_TRIG_MACRO(5)//
ASYNC_TRIG_MACRO(macro_1)
18-81
Macro Reference
Example
The length of output string is limited to 256 characters. The extra characters
will be ignored.
The argument part is optional. One format specification converts exactly one
argument.
macro_command main()
char c1 = a
short s1 = 32767
float f1 = 1.234567
TRACE(The results are) // output: The results are
TRACE(c1 = %c, s1 = %d, f1 = %f, c1, s1, f1)
// output: c1 = a, s1 = 32767, f1 = 1.234567
end macro_command
FindDataSamplingDate
return_value = FindDataSamplingDate (data_log_number, index, year, month,
day)
or
FindDataSamplingDate (data_log_number, index, year, month, day)
Description A query function for finding the date of specified data sampling file according to
the data sampling no. and the file index. The date is stored into year, month and
day respectively in the format of YYYY, MM and DD.
Name
Syntax
18-82
Macro Reference
Example
FindDataSamplingIndex
return_value = FindDataSamplingIndex (data_log_number, year, month, day,
index)
or
FindDataSamplingIndex (data_log_number, year, month, day, index)
Description A query function for finding the file index of specified data sampling file
according to the data sampling no. and the date. The file index is stored into
index. year, month and day are in the format of YYYY, MM and DD respectively.
Name
Syntax
18-83
Macro Reference
Example
macro_command main()
short data_log_number = 1, year = 2010, month = 12, day = 10, index
short success
// if there exists a data sampling file named 20101210.dtl, with data sampling //
number 1 and file index 2.
// the result after execution: success == 1 and index == 2
success = FindDataSamplingIndex (data_log_number, year, month, day, index)
end macro_command
18-84
Macro Reference
FindEventLogDate
return_value = FindEventLogDate (index, year, month, day)
or
FindEventLogDate (index, year, month, day)
Description A query function for finding the date of specified event log file according to file
index. The date is stored into year, month and day respectively in the format of
YYYY, MM and DD.
The event log files stored in the designated position (such as HMI memory
storage or external memory device) are sorted according to the file name and
are indexed starting from 0. The most recently saved file has the smallest file
index number. For example, if there are four event log files as follows:
EL_20101210.evt
EL_20101230.evt
EL_20110110.evt
EL_20110111.evt
The file index are:
EL_20101210.evt -> index is 3
EL_20101230.evt -> index is 2
EL_20110110.evt -> index is 1
EL_20110111.evt -> index is 0
return_value equals to 1 if referred data sampling file is successfully found,
otherwise it equals to 0.
index can be constant or variable. year, month, day and return_value must be
variable. return_value is optional.
macro_command main()
Example
short index = 1, year, month, day
short success
Name
Syntax
18-85
Macro Reference
FindEventLogIndex
return_value = FindEventLogIndex (year, month, day, index)
or
FindEventLogIndex (year, month, day, index)
Description A query function for finding the file index of specified event log file according
to date. The file index is stored into index. year, month and day are in the
format of YYYY, MM and DD respectively.
The event log files stored in the designated position (such as HMI memory
storage or external memory device) are sorted according to the file name and
are indexed starting from 0. The most recently saved file has the smallest file
index number. For example, if there are four event log files as follows:
EL_20101210.evt
EL_20101230.evt
EL_20110110.evt
EL_20110111.evt
The file index are:
EL_20101210.evt -> index is 3
EL_20101230.evt -> index is 2
EL_20110110.evt -> index is 1
EL_20110111.evt -> index is 0
return_value equals to 1 if referred data sampling file is successfully found,
otherwise it equals to 0.
index can be constant or variable. year, month, day and return_value must be
variable. return_value is optional.
macro_command main()
Example
short year = 2010, month = 12, day = 10, index
short success
Name
Syntax
18.8.
18.8.1.
Click on
[Macro Manager] icon on the tool bar in EasyBuilder Pro to open Macro
Manager dialog box as follows.
18-86
Macro Reference
In Macro Manager, all macros compiled successfully are displayed in Macro list, and all
macros under development or cannot be compiled are displayed in Macro under
development. The following is a description of the various buttons.
Setting
Description
New
Delete
Edit
Copy
Paste
OK
Cancel
Library
18-87
Macro Reference
2.
Press the [New] button to create an empty macro and open the macro editor. Every macro
has a unique number defined at [Macro ID], and must have a macro name, otherwise an
error will appear while compiling.
3.
Design your macro. To use built-in functions (like SetData() or Getdata()), press [Get/Set
FN] button to open API dialog box and select the function and set essential parameters.
18-88
Macro Reference
4.
After the completion of a new macro, press [Compile] button to compile the macro.
5.
If there is no error, press [Exit] button and a new macro macro_test will be in Macro
list.
18-89
Macro Reference
18.8.2.
Execute a Macro
1.
2.
Note
If [Set Bit] uses [Periodic Toggle], the macro will be executed every time [Set Bit] toggles.
1.
2.
On the [General] tab of the [Function Key] dialog, select the [Execute Macro] option.
Select the macro to execute. The macro will execute one time when the button is
activated.
1.
2.
18.9.
When editing Macro, to save time of defining functions, user may search for the needed from
built-in Macro Function Library. However, certain functions, though frequently used, may not
be found there. In this case, user may define the needed function and save it for future use.
Next time when the same function is required, the saved functions can be called from [Macro
Function Library] for easier editing. Additionally, [Macro Function Library] greatly enhances the
portability of user-defined functions. Before building a function please check the built-in
functions or online function library to see if it exists.
18-90
Macro Reference
18.9.1.
Open a project in HMI programming software, the default Function Library File will be read
automatically and the function information will be loaded in. At this moment if a user-defined
function is called, the relevant .mlb file must be imported first.
1. Default Function Library File Name: MacroLibrary (without filename extension)
2.
3.
18-91
Macro Reference
4.
When opening HMI programming software, only the functions in Default Function Library
will be loaded in, to use functions in .mlb files, please import them first.
18.9.2.
1.
2.
18-92
Macro Reference
3.
At least check one from [Library] or [Build-in] and select the function to be used.
4.
The description displayed in API dialog box is the same as written in Function Editor.
5.
Select the function to be used, fill in the corresponding variables according to the data
type.
6.
Upon completion of the steps above, user-defined functions can be used freely without
defining the same functions repeatedly.
EasyBuilder Pro V5.01.02
18-93
Macro Reference
18.9.3.
1.
Open macro management dialog, click [Library] to open [Macro Function Library] dialog
box.
2.
A list of functions is shown. When the project is opened, the software will load all the
functions in the Default Function Library.
3.
18-94
Macro Reference
return_type indicates the type of the return value. If this value does not exist, this column will
be omitted. function_name indicates the name of the function. N in parameter_typeN stands
for the number of parameter types. If this function does not need any parameter, this column
will be omitted.
2.
3.
4.
Edit the function description to describe what the specification is, how to use etc.
After editing, click [Compile] and [Save] to save this function to the Library. Otherwise, a
warning is shown.
EasyBuilder Pro V5.01.02
18-95
Macro Reference
5.
Note
The total size of data type can be declared in a function is 4096 bytes.
Function name must only contain alphanumeric characters, and cannot start with a
number.
18-96
Macro Reference
2.
Click [Yes] to confirm, [No] to cancel the deletion. Click [Yes] to delete MAX_SHORT
function.
3.
Double click the function to be modified can also enter Function Editor.
4.
18-97
Macro Reference
2.
For example, import a function library math.mlb which contains a function test1. Click
[Open].
3.
When importing a function which already exists in the Library, a confirmation pop-up will
be shown. The buttons are:
18-98
Macro Reference
[Yes to all]: Overwrite using all the imported functions with the same name.
4.
[No to all]: Cancel the importing of all the functions with the same name.
The imported functions will be saved in Default Function Library, so if math.mlb file is
deleted, test1 will still exist in the Library, even restarting EasyBuilder Pro.
Export the function from Function Library and save as .mlb file. Click [Export].
2.
18-99
Macro Reference
3.
A math.mlb file can be found under export directory. This file contains 4 functions: ADD,
4.
2.
3.
4.
The maximum storage space of local variables in a macro is 4K bytes. So the maximum
array size of different variable types are as follows:
char
a[4096]
bool
b[4096]
short
c[2048]
int
d[1024]
float
e[1024]
A maximum of 255 macros are allowed in an EasyBuilder Pro project.
A macro may cause the HMI unresponsive. Possible reasons are:
A macro contains an infinite loop with no PLC communication.
The size of an array exceeds the storage space in a macro.
The PLC communication speed affects the running time for the macro to execute. Also,
too many macros may slow down the communication between HMI and PLC.
18-100
Macro Reference
1.
First, create a new device in the device table. The device type of the new device is set to
Free Protocol and named with MODBUS RTU device as follows:
2.
The interface of the device (PLC I/F) uses [RS-232]. If a MODBUS TCP/IP device is
connected, the interface should be [Ethernet] with correct IP and port number as follows:
Suppose that the HMI will read the data of 4x_1 and 4x_2 on the device. First, utilize OUTPORT
to send out a read request to the device. The format of OUTPORT is:
OUTPORT(command[start], device_name, cmd_count)
Since MODBUS RTU device is a MODBUS RTU device, the read request must follow MODBUS
RTU protocol. The request usesReading Holding Registers (0x03) command to read data. The
following picture displays the content of the command. (The items of the station number (byte
0) and the last two bytes (CRC) are ignored).
EasyBuilder Pro V5.01.02
18-101
Macro Reference
Depending on the protocol, the content of a read command as follows (The total is 8 bytes):
command[0]: station number
(BYTE 0)
command[1]: function code
(BYTE 1)
command[2]: high byte of starting address
command[3]: low byte of starting address
command[4]: high byte of quantity of registers
command[5]: low byte of quantity of registers
(BYTE 2)
(BYTE 3)
(BYTE 4)
(BYTE 5)
(BYTE 6)
(BYTE 7)
char command[32]
short address, checksum
FILL(command[0], 0, 32) //
initialize command[0]~command[31] to 0
is 0x3)
LOBYTE(checksum, command[6])
HIBYTE(checksum, command[7])
Lastly, use OUPORT to send out this read request to PLC.
OUTPORT(command[0], MODBUS RTU Device, 8) //
After sending out the request, use INPORT to get the response from PLC. Depending on the
protocol, the content of the response is as follows (the total byte is 9):
EasyBuilder Pro V5.01.02
18-102
Macro Reference
(BYTE 0)
(BYTE 1)
(BYTE 2)
(BYTE 3)
(BYTE 4)
(BYTE 5)
(BYTE 6)
(BYTE 7)
(BYTE 8)
18-103
Macro Reference
initialize command[0]~command[31] to 0
LOBYTE(checksum, command[6])
HIBYTE(checksum, command[7])
OUTPORT(command[0], "MODBUS RTU Device", 8 )// send request
INPORT(response[0], "MODBUS RTU Device", 9, return_value)// read response
if (return_value > 0 and response[1] == 0x3) then
read_data[0] = response[4] + (response[3] << 8)//
read_data[1] = response[6] + (response[5] << 8)//
4x_1
4x_2
18-104
Macro Reference
address = 0
HIBYTE(address, command[2])
LOBYTE(address, command[3])
command[4] = 0xff//
command[5] = 0
force 0x_1 on
CRC(command[0], checksum, 6)
LOBYTE(checksum, command[6])
HIBYTE(checksum, command[7])
OUTPORT(command[0], "MODBUS RTU Device", 8)// send request
INPORT(response[0], "MODBUS RTU Device", 8, return_value)// read response
end macro_command
Macro Reference
18-105
18-106
Macro Reference
For example
macro_command main ) //
missing (
18-107
Macro Reference
18-108
Macro Reference
18-109
Macro Reference
for example, b = 4 + a
next a
end macro_command
(C41) float variables cannot be contained in shift calculation
(C42) function must return a value
(C43) function should not return a value
(C44) float variables cannot be contained in calculation
(C45) PLC address error
(C46) array size overflow (max. 4k)
(C47) macro command entry function is not only one
18-110
Macro Reference
Macro Reference
18-111
for i = 0 to 4 step 1
if (a[0] == 400) then
GetData(a*0+,Device 1, 4x, 0,9)
GetData(b*0+,Device 1, 4x, 11,10)
end If
next i
end macro_command
Macro Reference
18-112
i = fun(a, b)
SetData(i, Local HMI, LB, 16, 1)
end macro_command
if statement
macro_command main()
int k[10], j
for j = 0 to 10
k[j] = j
next j
if k[0] == 0 then
SetData(k*1+, Device 1, 4x, 0, 1)
end if
if k[0] == 0 then
SetData(k*1+, Device 1, 4x, 0, 1)
else
SetData(k*2+, Device 1, 4x, 0, 1)
end if
if k[0] == 0 then
SetData(k*1+, Device 1, 4x, 1, 1)
else if k[2] == 1 then
SetData(k*3+, Device 1, 4x, 2, 1)
end If
if k[0] == 0 then
SetData(k*1+, Device 1, 4x, 3, 1)
else if k[2] == 2 then
SetData(k*3+, Device 1, 4x, 4, 1)
else
SetData(k*4+, Device 1, 4x, 5, 1)
end If
end macro_command
18-113
Macro Reference
macro_command main()
char i = 0
int a[13], b[14], c = 4848
b[0] = 13
while b[0]
a[i] = 20 + i * 10
if a[i] == 120 then
c =200
break
end if
i=i+1
wend
SetData(c, Device 1, 4x, 2, 1)
end macro_command
Macro Reference
18-114
if c == 200 then
SetData(c, Device 1, 4x, 2, 1)
break
end if
wend
end macro_command
Array
macro_command main()
int a[25], b[25], i
b[0] = 13
for i = 0 to b[0] step 1
a[i] = 20 + i * 10
next i
SetData(a*0+, Device 1, 4x, 0, 13)
end macro_command
18-115
Macro Reference
2.
Secondly, add a Numeric Display object and a Function Key object in window no. 10 of the
project. The Function Key object is used to execute macro_0.
3.
4.
Lastly, compile the project and execute [Off-line simulation] or [On-line simulation].
When processing simulation on PC, right click and select Run EasyDiagnoser in the
pop-up menu.
18-116
Macro Reference
5.
When EasyDiagnoser is not able to connect with HMI, [Logger] window displays content
as shown in the following figure:
6.
The possible reason of not being able to get connection with HMI can be failure in
executing simulation on PC. Another reason is that the Port No. used in project for
simulation on PC is incorrect (or occupied by system). Please change Port No. as shown,
compile project then do simulation again.
7.
In EasyDiagnoser, the Port No. should be set the same as the Port No. in the project.
18-117
Macro Reference
The three consecutive ports of the project port no. are preserved for HMI communication.
In the setting above as an example, Port No. is set as 8005. Port 8005, 8006 and 8007
should be reserved. In this case when executing simulation on PC, please make sure that
these ports are not occupied by other programs.
TRACE Syntax List
TRACE
Name
TRACE(format, argument)
Syntax
Description Use this function to send specified string to the EasyDiagnoser. Users can print
out the current value of variables during run-time of macro for debugging.
When TRACE encounters the first format specification (if any), it converts the
value of the first argument after format and outputs it accordingly.
format refers to the format control of output string. A format specification,
which consists of optional (in [ ]) and required fields (in bold), has the following
form:
%[flags] [width] [.precision] type
Each field of the format specification is described as below:
flags (optional):
+
width (optional):
A nonnegative decimal integer controlling the minimum
number of characters printed.
precision (optional):
A nonnegative decimal integer which specifies the precision and
the
number of characters to be printed.
type:
C or c
: specifies a single-byte character.
d
: signed decimal integer.
i
: signed decimal integer.
o
: unsigned octal integer.
u
: unsigned decimal integer.
X or x
: unsigned hexadecimal integer.
E or e
: Signed value having the form. [ ]d.dddd e [sign]ddd where d
is a single decimal digit, dddd is one or more decimal digits, ddd i exactly
three decimal digits, and sign is + or .
f
: Signed value having the form [ ]dddd.dddd, where dddd is
one or more decimal digits.
The length of output string is limited to 256 characters.
EasyBuilder Pro V5.01.02
18-118
Macro Reference
Example
8.
9.
end macro_command
Use LB-9059 to disable MACRO TRACE function (when ON). When set ON, the output
message of TRACE won't be sent to EasyDiagnoser.
Users can directly execute EasyDiagnoser.exe from Utility Manager. In Utility Manager,
current HMI on line will be listed; users can simply select the HMI to be watched. Please
note that Project Port should be the same as Port No. used in project file.
10. Download the project to HMI and start the project. If EasyDiagnoser is unable to get
connection with the HMI to be watched, it is possible that HMI power is not ON, or Port
No. is incorrect. This may cause EasyDiagnoser to connect then disconnect with HMI
continuously. Please check the Port No. in EasyDiagnoser settings.
11. When EasyDiagnoser succeeds in connecting with HMI, simply execute macro_0, [Output]
window will then display the output of the TRACE function.
18-119
Macro Reference
18-120
Macro Reference
The string abcdef is stored in LW-0~LW-2 as follows (LB represents low byte and HB
represents high byte):
The ASCII Input object reads 1 word (2 bytes) at a time as described in the previous chapter.
Suppose an ASCII Input object is set to read 3 words as shown in the above example, it can
actually read at most 6 ASCII characters since that one ASCII character occupies 1 byte.
The functionality of each string operation function is described in the following table:
Function name
Description
StringGet
StringGetEx
StringSet
StringSetEx
StringCopy
StringMid
Retrieve a substring.
StringDecAsc2Bin
StringBin2DecAsc
StringDecAsc2Float
StringFloat2DecAsc
StringHexAsc2Bin
StringBin2HexAsc
StringLength
StringCat
StringCompare
StringCompareNoCase
StringFind
StringReverseFind
StringFindOneOf
StringIncluding
18-121
Macro Reference
StringExcluding
StringToUpper
StringToLower
StringToReverse
StringTrimLeft
StringTrimRight
StringInsert
For more detailed information of the above string operation functions, please check out the
Built-In Function Block section. In order to demonstrate the powerful usage of string
operation functions, the following examples will show you step by step how to create
executable project files using the new functions; starts from creating a macro, ends in
executing simulation.
1. To read (or write) a string from a device:
Create a new macro:
The first function StringGet is used to read a string from LW-0~LW-19, and store it into the str
array. The second function StringSet is used to output the content of str array.
Add one
ASCII Input object and one
Function Key object in window 10 of the project.
The settings of these objects are shown as below. Function Key object is used to execute
macro_0.
18-122
Macro Reference
Lastly, use
[Compile] to compile the project and execute
[Off-line simulation] or
[On-line simulation]. Follow the steps below to operate the executing project:
Step 2.
Input string.
Press GO button.
Step 3.
Output string.
Step 1.
2.
Initialization of a string.
Create a new macro and edit the content:
18-123
Macro Reference
The data enclosed in double quotation mark () is viewed as a string. str1 is initialized as
a string while str2 is initialized as a char array. The following snapshot of simulation shows
the difference between str1 and str2 using two ASCII Input objects.
Macro compiler will add a terminating null character (\0) at the end of a string. The
function StringSet will send each character of str1 to registers until a null character is
reached. The extra characters following the null character will be ignored even if the data
count is set to a larger value than the length of string.
On the contrary, macro compiler will not add a terminating null character (\0) at the end
of a char array. The actual number of characters of str2 being sent to registers depends on
3.
18-124
Macro Reference
The first two StringGet functions will read the strings input by users and store them into
arrays named name_input and password_input separately. Use the function
StringCompare to check if the input account name and password are matched. If the
account name is matched, name_match is set true; if the password is matched,
password_match is set true. If both name_match and password_match are true, output
the string Success! Access Accepted.. Otherwise, output the string Fail! Access Denied..
Add ASCII Input
and Function Key
objects in window 10 of the project. The
settings of these objects are shown as below. Function Key object is used to execute
macro_1.
Object 2
Object 3
Object 1
Object 4
Object 1: Function Key
Select [Execute macro] and Macro: [ID:000] macro_1.
18-125
Macro Reference
Lastly, use
[Compile] to compile the project and execute
[Off-line simulation] or
[On-line simulation]. Follow the steps below to operate the executing project:
Macro Reference
18-126
18-127
Macro Reference
On MACRO editing window theres the *Password protect+ selection, tick it and click *Set
password+ to set a password less than or equals to 10 characters (support ASCII character
only, ex. a$#*hFds).
After setting MACRO password, users will have to input correct password when opening
MACRO editing window. EasyBuilder Pro should be rebooted for typing the password again
after 3 incorrect attempts.
Note
When MACRO is password protected, de-compilation of EXOB file will not be able to
restore MACRO contents.
19-1
19-2
19.1.
Overview
Once the HMI is configured as a MODBUS device, the data of HMI can be read or written via
MODBUS protocol.
As shown in the following figure, the HMI is configured as a MODBUS device (also called
MODBUS Server). The HMI, PC or other devices can use MODBUS protocol to read or write
HMI data via Ethernet or RS-232 / RS-485 interface.
19.2.
1.
2.
If [PLC I/F] is set to [RS-232] or [RS-485], please select [COM] (COM 1 ~ COM 3) and set
correct communication parameters as shown in the following figure. MODBUS Server
EasyBuilder Pro V5.01.02
19-3
[Station no.] is set to 1. Click [Settings], the maximum LW address range read / written by
Modbus Client can be set. When the object in the project uses a LW register, the Modbus
Client will not be able to read or write an address that is not within the specified range.
The [Port no.] of MODBUS Server and HMI must be the same. To change the port number,
please set in the [Model] tab.
19-4
3.
When finished, MODBUS Server is listed in [Device] tab. The configuration of MODBUS
device is completed. Compile the .emtp file and download the compiled .exob file to the
HMI, then HMI data can be read or written by using MODBUS protocol.
Note
19.3.
For cMT-SVR, if [Ethernet] PLC interface is chosen, then enter the port number.
Two HMIs can be configured as one MODBUS client and one MODBUS server to communicate
and exchange data.
1. Add a new device in clients device list. If the client chooses [Ethernet] PLC interface, set
[PLC type] to MODBUS TCP/IP and fill in the correct *IP address] (the IP of MODBUS
Server), [Port no.], and [Station no.].
19-5
If the client chooses [RS-232] or [RS-485] PLC interface, the [PLC type] must be set to
MODBUS RTU, and its communication parameters also must be configured correctly.
19-6
2.
When finished, click [OK], then a new device MODBUS RTU is listed in the [Device] tab.
3.
In the setting page of each object, select MODBUS RTU in *PLC name+, and set the
address of MODBUS RTU.
Since the server is an HMI, the corresponding read and write addresses are listed below
0x/1x (1 ~ 12096)
3x/4x/5x (1 ~ 9999)
3x/4x/5x (10000 ~ 65535)
19.4.
LB (0 ~ 12095)
LW (0 ~ 9998)
RW (0 ~ 55535)
EasyBuilder Pro provides the following system registers to change MODBUS Server station
number online.
19.5.
LW-9541
LW-9542
LW-9543
LW-9544
In the EasyBuilder Pro, the address types of MODBUS protocol are 0x, 1x, 3x, 4x, 5x, 6x, 3x_bit
and 4x_bit. MODBUS RTU function codes are listed below:
0x:
Coils
19-7
1x:
Discrete Inputs
3x:
Input Registers
4x:
Holding Register
5x
6x
3x_bit
4x_bit
20-1
20-2
20.1.
Overview
HMI can connect with barcode reader via the following interfaces:
USB
COM port
To connect a barcode reader, please add a new device by the following steps.
20.2.
1.
In EasyBuilder Pro [Edit] [System Parameter Settings] [Device list], add a new device.
2.
20-3
Setting
Timeout
Description
COM
Baud rate
Data bits
Parity
Stop bits
Terminator
CR/LF
STX/ETX
Other
None
If this check box is selected, HMI will save all the data to
the designated address of barcode reader.
20-4
Address Type
Address Name
Description
Bit
FLAG
RESET
CONNECT_STAT
US
BARCODE
RESULT
Example 1
The following is a setting example, the barcode is 9421007480830. BARCODE 0 is the address
of Numeric Display Object (BYTES) and BARCODE 1 ~ n is the address of ASCII Display object
(BARCODE).
20-5
In the example the data stored in the barcode reader address is listed in the following table:
Barcode Reader Address
Data
BARCODE 0
13 bytes (decimal)
However, the data saved is 14 bytes = 7 words.
It is because when the number of bytes is an
odd number, the system adds a byte (0x00) to
make it an even number.
BARCODE 1
3439 (HEX)
BARCODE 2
3132 (HEX)
BARCODE 3
3030 (HEX)
BARCODE 4
3437 (HEX)
BARCODE 5
3038 (HEX)
BARCODE 6
3338 (HEX)
BARCODE 7
0030 (HEX)
Note
HMI can only connect with one USB barcode reader. When the device list in the project
includes this kind of device, the system register LB-9064: [enable USB barcode device
(disable keyboard) (when ON)] is set ON. To enable USB keyboard again and stop using
USB barcode reader, please set LB-9064 OFF.
Click the icon to download the demo project. Please confirm your internet connection.
21-1
21-2
21.1.
Overview
Use RJ45 crossover cable and without hub, but this is limited to point-to-point connection
(HMI to HMI or PC to HMI).
Through Ethernet network, the system provides the following methods for data transmission:
HMI to HMI communication.
PC to HMI communication.
Operating the PLC connected to another HMI.
21.2.
To exchange data between one HMI and another HMI, add a new remote HMI device in
[System Parameter Settings]. If there are 2 HMIs (HMI A and HMI B), in order to use a Set Bit
object on HMI A to control [LB-0] on HMI B, the setting of the project of HMI A is explained in
the following part.
1.
Set the IP address of the two HMIs, for example, HMI A: 192.168.1.1, HMI B: 192.168.1.2.
EasyBuilder Pro V5.01.02
21-3
2.
In [System Parameter Settings] [Device list], add a remote HMI B (IP: 192.168.1.2).
3.
Create a Set Bit Object, select HMI B in [PLC name] to control the address of the remote
HMI.
Note
21.3.
PC to HMI Communication
With On-line Simulation, PC can collect data from HMI through Ethernet network and save the
data files to PC. To connect PC with two HMIs (HMI A and HMI B), the setting of the project on
PC is explained in the following part.
1.
2.
Set the IP address of the two HMIs, for example, HMI A: 192.168.1.1, HMI B: 192.168.1.2.
In [System Parameter Settings] [Device list], add a remote HMI A (IP: 192.168.1.1) & HMI
EasyBuilder Pro V5.01.02
21-4
B (IP: 192.168.1.2).
3.
Create a Set Bit Object, select HMI A in [PLC name] to control the address of the remote
HMI A. Same for the HMI B.
Note
21.4.
Through Ethernet network, PC or HMI can operate the PLC that is connected to another HMI. If
PLC is connected to COM 1of HMI B, when using PC or HMI A to read PLC data, the setting of
the project of PC or HMI A is explained in the following part.
21-5
21.4.1.
1.
2.
3.
Create a Set Bit Object, select PLC on HMI B in [PLC name] to control the PLC connected
with the remote HMI B.
21-6
21.4.2.
1.
2.
3.
In the project of HMI B, go to [System Parameter Settings] [Device list], click [New PLC],
set [Name] to PLC on HMI B. Set correct parameters.
21-7
4.
When finished, a remote PLC can be found under Remote HMI 1. Local HMI 1 stands for
HMI A, Remote HMI 1 stands for HMI B, and Remote PLC 1 is connected with HMI B.
5.
Create a Set Bit Object, select PLC on HMI B in [PLC name] to control the PLC connected
with the remote HMI B.
Note
Remote HMI in a cMT-SVR project must be a cMT-SVR machine. Thus, a cMT-SVR cannot
communicate with PLCs connected with other series, such as eMT, mTV-series.
22-1
System Registers
22-2
System Registers
22-3
System Registers
22.1.
Overview
Some Word and Bit addresses are reserved in EasyBuilder Pro. These registers are reserved for
different functions. This chapter introduces different types of registers.
The C letter in the register tables stands for Control, which means that this register not
only allows write operation, but also can be controlled by Macro or a remote HMI.
22-4
System Registers
22.2.
22.2.1.
Bits
Register
Device Type
Range
Format
Local Bits
LB
0 ~ 12095
DDDDD
Local Word
Bits
LW_BIT
0~
1079915
DDDDDdd
DDDDD: address
dd: bit no. (00 ~ 15)
Retentive Bit
Index
RBI
0 ~ 65535f
DDDDDh
DDDDD: address
h: bit no. (0 ~ f)
Use LW-9000 as Index
Register, and
correspond to RW_Bit
Retentive
Word
Bits
RW_Bit
0~
524287f
DDDDDh
DDDDD: address
h: bit no. (0 ~ f)
Retentive A
RW_A_Bit
0 ~ 65535f
DDDDDh
Word
Bits
22.2.2.
DDDDD: address
h: bit no. (0 ~ f)
Words
Register
Device Type
Range
Format
Local Words
LW
0 ~ 10799
DDDDD
Retentive
Words
RW
0 ~ 524287
DDDDDD
Retentive
RWI
0 ~ 65535
DDDDD
Word
Index
Retentive A
Words
RW_A
0 ~ 65535
DDDDD
Extended
Memory
Words
EM0 ~ EM9
0~
1073741823
DDDDDDDDDD
22-5
System Registers
22.3.
System Registers
22.3.1.
HMI Time
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-11958
LB-12055
LW-9010
R/W
R/C
R/C
LW-9011
R/W
R/C
R/C
LW-9012
R/W
R/C
R/C
LW-9013
R/W
R/C
R/C
LW-9014
R/W
R/C
R/C
LW-9015
R/W
R/C
R/C
LW-9016
LW-9017
R/W
R/C
R/C
LW-9018
R/W
R/C
R/C
LW-9019
R/W
R/C
R/C
LW-9020
R/W
R/C
R/C
LW-9021
R/W
R/C
R/C
LW-9022
R/W
R/C
R/C
LW-9023
LW-9030
LW-9048
R/W
R/C
R/C
LW-9049
R/W
R/C
R/C
Note
1.
2.
3.
22-6
System Registers
22.3.2.
HMI Operation
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-9018
R/W
R/C
R/C
LB-9019
disable/enable buzzer
R/W
R/C
R/C
LB-9020
R/W
R/C
R/C
LB-9033
R/W
R/C
*Note 1
LB-9040
LB-9041
LB-9047
LB-9048
reboot-HMI protection
R/W
R/C
R/C
LB-9062
LB-9063
R/W
R/C
R/C
R/W
R/C
LB-11959
R/W
R/C
R/C
LB-12051
R/W
R/C
R/C
LW-9007
LW-9008
LW-9025
LW-9026
LW-9027
LW-9028
LW-9040
LW-9051
R/W
R/C
R/C
LW-9080
R/W
R/C
R/C
LW-9081
R/W
R/C
R/C
LW-9199
R/W
R/C
R/C
LW-9350
LW-10884
R/W
R/C
R/C
LW-11155
LW-11157
LW-11159
22-7
System Registers
Note
1.
2.
3.
4.
5.
After changing the settings, please reboot HMI for the updates to take effect.
Use LW-9040 together with LB-9040 ~ LB-9041 to adjust the backlight brightness, range: 0
~ 31.
Only supported by eMT Series. When the battery voltage level, indicated by LW-9008,
drops below 2.8V, battery replacement is recommended.
When multiple mTV or cMT-SVR devices are used, this register can be triggered to make
the LED indicator blink for identifying the device.
LB-9064: Enable USB barcode device (disable keyboard).
Click the icon to download the demo project. Please confirm your internet connection.
22.3.3.
Touch Position
Address
LW-9041
Description
(16bit) : touch status word(bit 0 on = user is touching the
screen)
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
R
LW-9042
LW-9043
LW-9044
LW-9045
Click the icon to download the demo project that explains how to how to trigger relevant
registers to change page with finger slide. Please confirm your internet connection.
22.3.4.
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-12041
R/W
R/C
R/C
LB-12094
R/W
R/C
R/C
LB-12095
R/W
R/C
R/C
LW-9125
R/W
R/C
R/C
LW-9126
R/W
R/C
R/C
LW-9127
R/W
R/C
R/C
LW-9128
R/W
R/C
R/C
LW-9129
R/W
R/C
R/C
LW-9130
R/W
R/C
R/C
22-8
System Registers
LW-9131
R/W
R/C
R/C
LW-9132
R/W
R/C
R/C
LW-9133
LW-9135
LW-9136
LW-9137
LW-9138
LW-9139
LW-9140
LW-9141
R/W
R/C
R/C
LW-10750
R/W
R/C
R/C
LW-10751
R/W
R/C
R/C
LW-10752
R/W
R/C
R/C
LW-10753
R/W
R/C
R/C
LW-10786
R/W
R/C
R/C
LW-10787
R/W
R/C
R/C
LW-10788
R/W
R/C
R/C
LW-10789
R/W
R/C
R/C
LW-10790
R/W
R/C
R/C
LW-10791
R/W
R/C
R/C
LW-10792
R/W
R/C
R/C
LW-10793
R/W
R/C
R/C
LW-10794
R/W
R/C
R/C
LW-10795
R/W
R/C
R/C
LW-10796
R/W
R/C
R/C
LW-10797
R/W
R/C
R/C
LW-10798
LW-10799
LW-10800
LW-10801
LW-10802
LW-10803
LW-10804
IP0
LW-10805
LW-10806
22-9
System Registers
IP2
LW-10807
LW-10808
LW-10809
LW-10810
LW-10811
LW-10812
R/W
R/C
R/C
Note
1.
22.3.5.
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LW-9100
LW-9116
LW-9118
LW-9120
LW-9122
LW-9123
LW-9124
22.3.6.
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-9035
LB-9036
LB-9037
LB-12048
LB-12050
22-10
System Registers
LW-9070
LW-9071
LW-9072
LW-9074
LW-9076
Click the icon to download the demo project that explains how to use LW-9072 ~ LW-9076
with Backup Object. Please confirm your internet connection.
22.3.7.
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-9028
LB-9029
LB-9460
EM0's storage device (SD card) does not exist (when ON)
LB-9461
EM1's storage device (SD card) does not exist (when ON)
LB-9462
EM2's storage device (SD card) does not exist (when ON)
LB-9463
EM3's storage device (SD card) does not exist (when ON)
LB-9464
EM4's storage device (SD card) does not exist (when ON)
LB-9465
EM5's storage device (SD card) does not exist (when ON)
LB-9466
EM6's storage device (SD card) does not exist (when ON)
LB-9467
EM7's storage device (SD card) does not exist (when ON)
LB-9468
EM8's storage device (SD card) does not exist (when ON)
LB-9469
EM9's storage device (SD card) does not exist (when ON)
LB-9470
EM0's storage device (USB disk) does not exist (when ON)
LB-9471
EM1's storage device (USB disk) does not exist (when ON)
LB-9472
EM2's storage device (USB disk) does not exist (when ON)
LB-9473
EM3's storage device (USB disk) does not exist (when ON)
LB-9474
EM4's storage device (USB disk) does not exist (when ON)
LB-9475
EM5's storage device (USB disk) does not exist (when ON)
LB-9476
EM6's storage device (USB disk) does not exist (when ON)
LB-9477
EM7's storage device (USB disk) does not exist (when ON)
LB-9478
EM8's storage device (USB disk) does not exist (when ON)
LB-9479
EM9's storage device (USB disk) does not exist (when ON)
22-11
System Registers
22.3.8.
Data Sampling
Address
LB-9025
Description
delete the earliest data sampling file on HMI memory (set
ON)
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
W
LB-9026
LB-9027
LB-9034
ON)
LB-11949
LB-11950
LB-11951
LB-11952
delete the earliest data sampling file on USB disk (set ON)
LB-11953
LB-11954
LW-9063
LW-9064
LW-10489
LW-10490
LW-10492
LW-10493
Note
1.
The registers for deleting or updating data samplings do not work during simulation on
PC.
22.3.9.
Event Log
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9021
LB-9022
delete the earliest event log file on HMI memory (set ON)
LB-9023
LB-9024
LB-9034
ON)
LB-9042
22-12
System Registers
LB-9043
LB-11940
LB-11941
LB-11942
LB-11943
delete the earliest event log file on USB disk (set ON)
LB-11944
LB-11945
LW-9060
LW-9061
LW-9450
R/W
R/C
R/C
LW-9451
R/W
R/C
R/C
LW-9452
R/W
R/C
R/C
LW-9453
R/W
R/C
R/C
LW-9454
R/W
R/C
R/C
LW-9455
R/W
R/C
R/C
LW-10480
LW-10481
LW-10483
LW-10484
Note
1.
2.
If LW-9450 ~ LW-9455 are used to get Event Log time, please enable in [system
parameters] [General].
The registers for deleting or updating event logs do not work during simulation on PC.
Click the icon to download the demo project that explains how to use the system registers
LW-9450 to LW-9455 to be the time tag of event log. Please confirm your internet connection.
22.3.10. Station Number Variables
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LW-10000
(usage : var0#address)
R/W
R/C
R/C
LW-10001
(usage : var1#address)
R/W
R/C
R/C
LW-10002
(usage : var2#address)
R/W
R/C
R/C
LW-10003
(usage : var3#address)
R/W
R/C
R/C
LW-10004
(usage : var4#address)
R/W
R/C
R/C
LW-10005
(usage : var5#address)
R/W
R/C
R/C
22-13
System Registers
LW-10006
(usage : var6#address)
R/W
R/C
R/C
LW-10007
(usage : var7#address)
R/W
R/C
R/C
LW-10008
(usage : var8#address)
R/W
R/C
R/C
LW-10009
(usage : var9#address)
R/W
R/C
R/C
LW-10010
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
(usage :
var10#address)
LW-10011
(usage :
var11#address)
LW-10012
(usage :
var12#address)
LW-10013
(usage :
var13#address)
LW-10014
(usage :
var14#address)
LW-10015
(usage :
var15#address)
Click the icon to download the demo project. Please confirm your internet connection.
22.3.11. Index Registers
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LW-9200
R/W
R/C
R/C
LW-9201
R/W
R/C
R/C
LW-9202
R/W
R/C
R/C
LW-9203
R/W
R/C
R/C
LW-9204
R/W
R/C
R/C
LW-9205
R/W
R/C
R/C
LW-9206
R/W
R/C
R/C
LW-9207
R/W
R/C
R/C
LW-9208
R/W
R/C
R/C
LW-9209
R/W
R/C
R/C
LW-9210
R/W
R/C
R/C
LW-9211
R/W
R/C
R/C
LW-9212
R/W
R/C
R/C
LW-9213
R/W
R/C
R/C
LW-9214
R/W
R/C
R/C
22-14
System Registers
LW-9215
R/W
R/C
R/C
LW-9230
R/W
R/C
R/C
LW-9232
R/W
R/C
R/C
LW-9234
R/W
R/C
R/C
LW-9236
R/W
R/C
R/C
LW-9238
R/W
R/C
R/C
LW-9240
R/W
R/C
R/C
LW-9242
R/W
R/C
R/C
LW-9244
R/W
R/C
R/C
LW-9246
R/W
R/C
R/C
LW-9248
R/W
R/C
R/C
LW-9250
R/W
R/C
R/C
LW-9252
R/W
R/C
R/C
LW-9254
R/W
R/C
R/C
LW-9256
R/W
R/C
R/C
LW-9258
R/W
R/C
R/C
LW-9260
R/W
R/C
R/C
Click the icon to download the demo project. Please confirm your internet connection.
22.3.12. MODBUS Server Communication
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-9055
LB-9056
LB-9057
LB-9058
LB-12052
R/W
R/C
R/C
LW-9270
LW-9271
1)
LW-9272
LW-9275
LW-9276
LW-9277
22-15
System Registers
(COM 2)
LW-9280
LW-9281
LW-9282
LW-9285
LW-9286
LW-9287
LW-9288
LW-9541
R/W
R/C
R/C
LW-9542
R/W
R/C
R/C
LW-9543
R/W
R/C
R/C
LW-9544
R/W
R/C
R/C
LW-9570
server)
LW-9572
LW-9574
LW-9576
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9030
R/W
R/C
R/C
LB-9031
R/W
R/C
R/C
LB-9032
R/W
R/C
R/C
LB-9065
R/W
R/C
R/C
LB-9066
R/W
R/C
R/C
LB-9067
R/W
R/C
R/C
LW-9550
R/W
R/C
R/C
22-16
System Registers
LW-9551
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
2:19200,11:28800,3:38400,4:57600,..)
LW-9552
LW-9553
LW-9554
R/W
R/C
R/C
LW-9555
R/W
R/C
R/C
LW-9556
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
(7:1200,8:2400,0:4800,1:9600,10:14400,
2:19200,11:28800,3:38400,4:57600,..)
LW-9557
LW-9558
LW-9559
R/W
R/C
R/C
LW-9560
R/W
R/C
R/C
LW-9561
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
(7:1200,8:2400,0:4800,1:9600,10:14400,
2:19200,11:28800,3:38400,4:57600,..)
LW-9562
LW-9563
LW-9564
R/W
R/C
R/C
LW-9565
R/W
R/C
R/C
LW-9566
R/W
R/C
R/C
LW-9567
R/W
R/C
R/C
LW-10500
R/W
R/C
R/C
LW-10501
R/W
R/C
R/C
LW-10502
R/W
R/C
R/C
LW-10503
R/W
R/C
R/C
LW-10504
R/W
R/C
R/C
LW-10505
R/W
R/C
R/C
LW-10506
R/W
R/C
R/C
LW-10507
R/W
R/C
R/C
LW-10508
R/W
R/C
R/C
LW-10509
R/W
R/C
R/C
LW-10510
R/W
R/C
R/C
22-17
System Registers
LW-10511
R/W
R/C
R/C
LW-10512
R/W
R/C
R/C
LW-10513
R/W
R/C
R/C
LW-10514
R/W
R/C
R/C
LW-10515
R/W
R/C
R/C
LW-10516
R/W
R/C
R/C
LW-10517
R/W
R/C
R/C
Link type)
LW-10518
R/W
R/C
R/C
LW-10519
R/W
R/C
R/C
LW-10520
R/W
R/C
R/C
LW-10521
R/W
R/C
R/C
LW-10522
R/W
R/C
R/C
Link type)
LW-10523
R/W
R/C
R/C
LW-10524
R/W
R/C
R/C
LW-10525
R/W
R/C
R/C
LW-10526
R/W
R/C
R/C
LW-10527
R/W
R/C
R/C
Link type)
LW-10528
R/W
R/C
R/C
LW-10529
R/W
R/C
R/C
LW-10530
R/W
R/C
R/C
LW-10531
R/W
R/C
R/C
LW-10532
R/W
R/C
R/C
Link type)
LW-10533
R/W
R/C
R/C
LW-10534
R/W
R/C
R/C
LW-10535
R/W
R/C
R/C
LW-10536
R/W
R/C
R/C
LW-10537
R/W
R/C
R/C
Link type)
LW-10538
R/W
R/C
R/C
LW-10539
R/W
R/C
R/C
LW-10655
R/W
R/C
R/C
LW-10656
R/W
R/C
R/C
LW-10657
R/W
R/C
R/C
22-18
System Registers
LW-10658
R/W
R/C
R/C
LW-10659
R/W
R/C
R/C
22-19
System Registers
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-9150
R/W
R/C
R/C
LB-9151
R/W
R/C
R/C
LB-9152
R/W
R/C
R/C
LB-9200
R/W
R/C
R/C
LB-9201
R/W
R/C
R/C
LB-9202
R/W
R/C
R/C
LB-9203
R/W
R/C
R/C
LB-9204
R/W
R/C
R/C
LB-9205
R/W
R/C
R/C
LB-9206
R/W
R/C
R/C
LB-9207
R/W
R/C
R/C
LB-9455
R/W
R/C
R/C
LB-9500
R/W
R/C
R/C
LB-9501
R/W
R/C
R/C
LB-9502
R/W
R/C
R/C
LB-9503
R/W
R/C
R/C
LB-9504
R/W
R/C
R/C
LB-9505
R/W
R/C
R/C
LB-9506
R/W
R/C
R/C
LB-9507
R/W
R/C
R/C
LB-9755
R/W
R/C
R/C
LB-9800
R/W
R/C
R/C
LB-9801
R/W
R/C
R/C
LB-9802
R/W
R/C
R/C
LB-9803
R/W
R/C
R/C
LB-9804
R/W
R/C
R/C
LB-9805
R/W
R/C
R/C
LB-9806
R/W
R/C
R/C
LB-9807
R/W
R/C
R/C
LB-10055
R/W
R/C
R/C
LB-12030
LB-12031
LB-12032
22-20
System Registers
LB-12033
LB-12034
LB-12035
LB-12036
LB-12037
LB-12038
LW-9351
LW-9352
LW-9353
Note
1.
The ON state of COM is for checking if COM is occupied by other program during
simulation on PC.
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9153
R/W
R/C
R/C
LB-9154
R/W
R/C
R/C
LB-9155
R/W
R/C
R/C
LB-9156
R/W
R/C
R/C
LB-9157
R/W
R/C
R/C
LB-9158
R/W
R/C
R/C
LB-9189
R/W
R/C
R/C
LB-10070
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
LB-10072
LB-10073
LB-10074
LB-10075
LB-10099
22-21
System Registers
parameters changed on-line (set ON)
LB-10100
R/W
R/C
R/C
LB-10400
R/W
R/C
R/C
LB-10700
R/W
R/C
R/C
LB-11000
R/W
R/C
R/C
LB-11300
R/W
R/C
R/C
LB-11600
R/W
R/C
R/C
LB-11900
R/W
R/C
R/C
LB-11901
R/W
R/C
R/C
LB-11902
R/W
R/C
R/C
LB-11903
R/W
R/C
R/C
LB-11904
R/W
R/C
R/C
LB-11905
R/W
R/C
R/C
LB-11906
R/W
R/C
R/C
LB-11939
R/W
R/C
R/C
LW-9354
LW-9355
LW-9356
LW-9357
LW-9389
LW-9600
R/W
R/C
R/C
LW-9601
R/W
R/C
R/C
LW-9602
R/W
R/C
R/C
LW-9603
R/W
R/C
R/C
LW-9604
R/W
R/C
R/C
LW-9605
R/W
R/C
R/C
LW-9606
R/W
R/C
R/C
LW-9607
R/W
R/C
R/C
LW-9608
R/W
R/C
R/C
LW-9609
R/W
R/C
R/C
LW-9610
R/W
R/C
R/C
LW-9611
R/W
R/C
R/C
LW-9612
R/W
R/C
R/C
LW-9613
R/W
R/C
R/C
LW-9614
R/W
R/C
R/C
22-22
System Registers
LW-9615
R/W
R/C
R/C
LW-9616
R/W
R/C
R/C
LW-9617
R/W
R/C
R/C
LW-9618
R/W
R/C
R/C
LW-9619
R/W
R/C
R/C
LW-9620
R/W
R/C
R/C
LW-9621
R/W
R/C
R/C
LW-9622
R/W
R/C
R/C
LW-9623
R/W
R/C
R/C
LW-9624
R/W
R/C
R/C
LW-9625
R/W
R/C
R/C
LW-9626
R/W
R/C
R/C
LW-9627
R/W
R/C
R/C
LW-9628
R/W
R/C
R/C
LW-9629
R/W
R/C
R/C
LW-9765
R/W
R/C
R/C
LW-9766
R/W
R/C
R/C
LW-9767
R/W
R/C
R/C
LW-9768
R/W
R/C
R/C
LW-9769
R/W
R/C
R/C
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9190
R/W
R/C
R/C
LB-9191
R/W
R/C
R/C
LW-9390
22-23
System Registers
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-12080
R/W
R/C
R/C
LB-12081
R/W
R/C
R/C
LB-12100
R/W
R/C
R/C
LB-12101
R/W
R/C
R/C
LB-12102
R/W
R/C
R/C
LB-12103
R/W
R/C
R/C
LB-12104
R/W
R/C
R/C
LB-12105
R/W
R/C
R/C
LB-12106
R/W
R/C
R/C
LB-12107
R/W
R/C
R/C
LB-12108
R/W
R/C
R/C
LB-12109
R/W
R/C
R/C
LB-12354
R/W
R/C
R/C
LW-9392
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9068
R/W
R/C
R/C
LB-9069
R/W
R/C
R/C
LB-9070
R/W
R/C
R/C
LB-9071
R/W
R/C
R/C
LB-9072
R/W
R/C
R/C
LB-9073
R/W
R/C
R/C
LB-9074
R/W
R/C
R/C
LB-9075
R/W
R/C
R/C
LB-9099
R/W
R/C
R/C
LB-9100
R/W
R/C
R/C
LB-9101
R/W
R/C
R/C
LB-9102
R/W
R/C
R/C
LB-9103
R/W
R/C
R/C
LB-9104
R/W
R/C
R/C
22-24
System Registers
LB-9105
R/W
R/C
R/C
LB-9106
R/W
R/C
R/C
LB-9107
R/W
R/C
R/C
LB-9148
R/W
R/C
R/C
LB-9149
R/W
R/C
R/C
(set ON)
LW-9800
R/W
R/C
R/C
LW-9801
R/W
R/C
R/C
LW-9802
R/W
R/C
R/C
LW-9803
R/W
R/C
R/C
LW-9804
R/W
R/C
R/C
LW-9805
R/W
R/C
R/C
LW-9806
R/W
R/C
R/C
LW-9807
R/W
R/C
R/C
LW-9808
R/W
R/C
R/C
LW-9809
R/W
R/C
R/C
LW-9810
R/W
R/C
R/C
LW-9811
R/W
R/C
R/C
LW-9812
R/W
R/C
R/C
LW-9813
R/W
R/C
R/C
LW-9814
R/W
R/C
R/C
LW-9815
R/W
R/C
R/C
LW-9816
R/W
R/C
R/C
LW-9817
R/W
R/C
R/C
LW-9818
R/W
R/C
R/C
LW-9819
R/W
R/C
R/C
LW-9820
R/W
R/C
R/C
LW-9821
R/W
R/C
R/C
LW-9822
R/W
R/C
R/C
LW-9823
R/W
R/C
R/C
LW-9824
R/W
R/C
R/C
LW-9825
R/W
R/C
R/C
LW-9826
R/W
R/C
R/C
LW-9827
R/W
R/C
R/C
LW-9828
R/W
R/C
R/C
LW-9829
R/W
R/C
R/C
LW-9830
R/W
R/C
R/C
22-25
System Registers
LW-9831
R/W
R/C
R/C
LW-9832
R/W
R/C
R/C
LW-9833
R/W
R/C
R/C
LW-9834
R/W
R/C
R/C
LW-9835
R/W
R/C
R/C
LW-9836
R/W
R/C
R/C
LW-9837
R/W
R/C
R/C
LW-9838
R/W
R/C
R/C
LW-9839
R/W
R/C
R/C
LW-9895
R/W
R/C
R/C
LW-9896
R/W
R/C
R/C
LW-9897
R/W
R/C
R/C
LW-9898
R/W
R/C
R/C
LW-9899
R/W
R/C
R/C
LW-9905
R/W
R/C
R/C
LW-9906
R/W
R/C
R/C
LW-9907
R/W
R/C
R/C
LW-9908
R/W
R/C
R/C
LW-9909
R/W
R/C
R/C
LW-9910
R/W
R/C
R/C
LW-9911
R/W
R/C
R/C
LW-9912
R/W
R/C
R/C
LW-9913
R/W
R/C
R/C
LW-9914
R/W
R/C
R/C
LW-9915
R/W
R/C
R/C
LW-9916
R/W
R/C
R/C
LW-9917
R/W
R/C
R/C
LW-9918
R/W
R/C
R/C
LW-9919
R/W
R/C
R/C
LW-9920
R/W
R/C
R/C
LW-9921
R/W
R/C
R/C
LW-9922
R/W
R/C
R/C
LW-9923
R/W
R/C
R/C
LW-9924
R/W
R/C
R/C
LW-9925
R/W
R/C
R/C
LW-9926
R/W
R/C
R/C
LW-9927
R/W
R/C
R/C
22-26
System Registers
LW-9928
LW-9929
R/W
R/C
R/C
R/W
R/C
R/C
LW-9930
R/W
R/C
R/C
LW-9931
R/W
R/C
R/C
LW-9932
R/W
R/C
R/C
LW-9933
R/W
R/C
R/C
LW-9934
R/W
R/C
R/C
LW-9935
R/W
R/C
R/C
LW-9936
R/W
R/C
R/C
LW-9937
R/W
R/C
R/C
LW-9938
R/W
R/C
R/C
LW-9939
R/W
R/C
R/C
LW-9940
R/W
R/C
R/C
LW-9941
R/W
R/C
R/C
LW-9942
R/W
R/C
R/C
LW-9943
R/W
R/C
R/C
LW-9944
R/W
R/C
R/C
LW-9945
R/W
R/C
R/C
LW-9946
R/W
R/C
R/C
LW-9947
R/W
R/C
R/C
LW-9948
R/W
R/C
R/C
LW-9949
R/W
R/C
R/C
LW-9950
R/W
R/C
R/C
LW-9951
R/W
R/C
R/C
LW-9952
R/W
R/C
R/C
LW-9953
R/W
R/C
R/C
LW-9954
R/W
R/C
R/C
LW-9955
R/W
R/C
R/C
LW-9956
R/W
R/C
R/C
LW-9957
R/W
R/C
R/C
LW-9958
R/W
R/C
R/C
LW-9959
R/W
R/C
R/C
LW-9960
R/W
R/C
R/C
LW-9961
R/W
R/C
R/C
LW-9962
R/W
R/C
R/C
LW-9963
R/W
R/C
R/C
LW-9964
R/W
R/C
R/C
22-27
System Registers
LW-9995
R/W
R/C
R/C
LW-9996
R/W
R/C
R/C
LW-9997
R/W
R/C
R/C
LW-9998
R/W
R/C
R/C
LW-9999
R/W
R/C
R/C
Description
(16bit) : IP0 of the HMI connecting to remote PLC 1 (IP
address = IP0:IP1:IP2:IP3)
LW-10051
LW-10052
LW-10053
LW-10054
LW-10055
LW-10056
LW-10057
LW-10058
LW-10059
LW-10060
LW-10061
LW-10062
LW-10063
LW-10064
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
22-28
System Registers
LW-10065
LW-10066
LW-10067
LW-10068
LW-10069
LW-10205
LW-10206
LW-10207
LW-10208
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
LW-10209
R/W
R/C
R/C
LW-10300
R/W
R/C
R/C
LW-10301
R/W
R/C
R/C
LW-10302
R/W
R/C
R/C
LW-10303
R/W
R/C
R/C
LW-10304
R/W
R/C
R/C
LW-10305
R/W
R/C
R/C
LW-10306
R/W
R/C
R/C
LW-10307
R/W
R/C
R/C
LW-10308
R/W
R/C
R/C
LW-10309
R/W
R/C
R/C
LW-10310
R/W
R/C
R/C
LW-10311
R/W
R/C
R/C
LW-10312
R/W
R/C
R/C
LW-10313
R/W
R/C
R/C
LW-10314
R/W
R/C
R/C
LW-10315
R/W
R/C
R/C
LW-10316
R/W
R/C
R/C
LW-10317
R/W
R/C
R/C
LW-10318
R/W
R/C
R/C
22-29
System Registers
LW-10319
R/W
R/C
R/C
LW-10455
R/W
R/C
R/C
LW-10456
R/W
R/C
R/C
LW-10457
R/W
R/C
R/C
LW-10458
R/W
R/C
R/C
LW-10459
R/W
R/C
R/C
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9044
R/W
R/C
R/C
LB-9053
R/W
R/C
R/C
LB-9054
R/W
R/C
R/C
LB-9196
R/W
R/C
R/C
LB-9197
R/W
R/C
R/C
LB-9198
R/W
R/C
R/C
LB-9199
R/W
R/C
R/C
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LW-9400
LW-9401
LW-9402
LW-9403
LW-9404
LW-9405
LW-9406
LW-9407
LW-9449
LW-9490
22-30
System Registers
22.3.22. Driver ID
Address
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LW-9300
LW-9301
LW-9302
LW-9303
LW-9331
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LW-10700
R/W
R/C
R/C
LW-10704
R/W
R/C
R/C
LW-10708
R/W
R/C
R/C
LW-10715
R/W
R/C
R/C
LW-10719
R/W
R/C
R/C
LW-10723
R/W
R/C
R/C
LW-10730
R/W
R/C
R/C
LW-10734
R/W
R/C
R/C
LW-10738
R/W
R/C
R/C
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9192
R/W
R/C
R/C
LB-11960
R/W
R/C
R/C
LB-11961
R/W
R/C
R/C
LB-11962
R/W
R/C
R/C
LB-11963
R/W
R/C
R/C
LB-11964
R/W
R/C
R/C
LB-11965
R/W
R/C
R/C
LB-11966
R/W
R/C
R/C
LB-11967
R/W
R/C
R/C
LB-12023
R/W
R/C
R/C
LB-12082
R/W
R/C
R/C
ON)
22-31
System Registers
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9013
FS window control[hide(ON)/show(OFF)]
R/W
R/C
R/C
LB-9014
FS button control[hide(ON)/show(OFF)]
R/W
R/C
R/C
LB-9015
FS window/button control[hide(ON)/show(OFF)]
R/W
R/C
R/C
22.3.26. EasyAccess
Address
Description
LB-9051
LB-9052
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
R/W
R/C
R/C
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LW-10820
R/W
R/C
R/C
LW-10821
R/W
R/C
R/C
LW-10826
R/W
R/C
R/C
LW-10828
LW-10829
LW-11170
R/W
R/C
R/C
R/W
R/C
R/C
(EasyAccess 2.0)
LW-11171
LW-11172
R/W
R/C
R/C
LW-11173
R/W
R/C
R/C
LW-11174
R/W
R/C
R/C
LW-11175
R/W
R/C
R/C
LW-11176
R/W
R/C
R/C
LW-11177
R/W
R/C
R/C
(EasyAccess 2.0)
LW-11178
R/W
R/C
R/C
LW-11194
R/W
R/C
R/C
22-32
System Registers
Description
LB-10069
LB-12040
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
R/W
R/C
R/C
LW-9770
R/W
R/C
R/C
LW-9771
R/W
R/C
R/C
LW-9772
R/W
R/C
R/C
LW-9773
R/W
R/C
R/C
LW-9774
R/W
R/C
R/C
R/W
R/C
R/C
*Note 1
LW-9780
Note
1.
When change settings using LW-9774 and LW-9780, please reboot HMI for the new
settings to take effect.
Click the icon to download the demo project. Please confirm your internet connection.
Description
(16bit) : pass-through source COM port (1~3 : COM 1~COM
3)
LW-9902
LW-9903
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
LW-9904
LW-10850
LW-10851
22-33
System Registers
LW-10852
LW-10853
LW-10854
LW-10855
LW-10856
LW-10857
LW-10858
LW-10859
LW-10860
LW-10861
LW-10862
LW-10863
LW-10864
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LB-12088
R/W
R/C
R/C
LB-12089
R/W
R/C
R/C
LB-12090
R/W
R/C
R/C
22-34
System Registers
to HMI (when ON)(OS version 20120621 or later supports
only)
LB-12092
LB-12093
LW-9530
R/W
R/C
R/C
R/W
R/C
R/C
R/W
R/C
R/C
Note
1.
To change VNC mode, use LB-12092 to stop and then restart VNC to update the setting.
Description
LB-9046
LW-9046
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
R
R/W
R/C
Note
1.
When change HMI Key using LW-9046, please reboot HMI for the new settings to take
effect.
Click the icon to download the demo project. Please confirm your internet connection.
Description
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
LW-11160
LW-11161
LW-11162
LW-11163
LW-11164
LW-11165
LW-11166
LW-11167
LW-11168
LW-11169
22-35
System Registers
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LB-9050
user logout
LB-9060
password error
LB-9061
LW-9082
R/W
R/C
R/C
function)
LW-9219
R/W
R/C
R/C
LW-9220
(32bit) : password
R/W
R/C
R/C
LW-9222
LW-9500
R/W
R/C
R/C
LW-9502
R/W
R/C
R/C
LW-9504
R/W
R/C
R/C
LW-9506
R/W
R/C
R/C
LW-9508
R/W
R/C
R/C
LW-9510
R/W
R/C
R/C
LW-9512
R/W
R/C
R/C
LW-9514
R/W
R/C
R/C
LW-9516
R/W
R/C
R/C
LW-9518
R/W
R/C
R/C
LW-9520
R/W
R/C
R/C
LW-9522
R/W
R/C
R/C
LW-10754
PLW-10754
Note
1.
22-36
System Registers
22.3.34. Macro
Address
Description
LB-9059
LW-10900
Read(R)/Write(W)/Control(C)
Local
Macro Remote
HMI
HMI
R/W
R/C
R/C
LW-10902
LW-10903
LW-10904
LW-10905
LW-10906
LW-10907
LW-10908
LW-10909
LW-11154
Note
1.
22-37
System Registers
Description
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
LW-9002
LW-9004
LW-9052
R/W
R/C
R/C
object
PLW-9052
LW-9150
LW-9540
22.3.36. Miscellaneous
Address
LB-9000~
Description
initialized as ON
LB-9009
Read(R)/Write(W)/Control(C)
Local
Macro
Remote
HMI
HMI
R/W
R/C
R/C
LB-9010
LB-9011
LB-9012
LB-9016
LB-9017
R/W
R/C
R/C
LB-9039
LB-9045
LB-9049
R/W
R/C
R/C
LB-12053
LB-12054
LW-9006
LW-9024
R/W
R/C
R/C
LW-9032
R/W
R/C
R/C
memory *Note 3
LW-9050
PLW-9050
LW-9134
R/W
R/C
R/C
PLW-9134
R/W
R/C
R/C
22-38
System Registers
LW-9216
LW-9900
R/W
R/C
R/C
Note
1.
2.
When LB-9049 watch dog function is enabled, if theres a failure in the communication,
HMI will reboot 10 seconds later.
To display texts on objects in multiple languages, except for using Label Library, the system
reserved register [LW-9134: language mode] is needed. The value range in LW-9134 is 0 ~
23 (PLW-9134 is 0~7). The values in LW-9134 relates to the languages downloaded to HMI.
LW-9134 value and language correspondence vary according to the languages selected
during project compilation and download.
For example: If 5 languages are defined by user in Label Library as Language 1 (Traditional
Chinese), Language 2 (Simplified Chinese), Language 3 (English), Language 4 (French), and
Language 5 (Japanese). If only Language 1, 3, 5 are downloaded, the corresponding
language of the value in LW-9134 will be 0 Language 1 (Traditional Chinese), 1
Language 3 (English), 2 Language 5 (Japanese). The following demo project explains
how to switch languages using Option List Object and LW-9134.
3.
Click the icon to download the demo project. Please confirm your internet connection.
The default name of the backup data folder will be the HMI name.
23-1
23-2
23.1.
SP-M, D, E, F
Description
Serial printers, please configure communication
parameters to match the printer. [Pixels of width]
must be correctly set and cant exceed printer
default setting:
100 pixels for 1610 series printers.
220 pixels for 2407, 4004 series printers.
The driver uses EPSON ESC Protocol for Serial
Micro Printer.
23-3
Axiohm A630
SPRT
EPSON TM-L90
EPSON TM-T70
BRIGHTEK WH-A19
23-4
BRIGHTEK WH-E19
BRIGHTEK WH-E22
Supported models:
E22R10-00E725: Same as A7 16 impact printer.
A7 represents A72R90-31E72A.
E221R90-00E11740GA: Serial printer, connects
through RS-485 port, please use a RS232-to-RS485
converter.
BRIGHTEK WH-C1/C2
23-5
23.2.
1.
To connect Remote Printer Server, set the parameters in [System Parameter Settings]
[Printer/Backup Server].
23-6
2.
Start printing.
Or, use PLC Control [Screen hardcopy] to start printing with a designated bit address.
24-1
Recipe Editor
24-2
Recipe Editor
24.1.
Overview
24.2.
1.
2.
3.
Setting
Description
Address range
Data format
24-3
Recipe Editor
4.
Click [Add] to enter a description of the data type, and select data format. When selecting
[String], please enter the length (words) and select [ASCII] or [Unicode].
5.
In this example, the total length of data format is 13 words. Each 13 words will be one set
of recipe data.
The first set: product no. = address 0, Name = address 1 ~ 10, Store No.= address 11 ,
Category = address 12;
The second set: product no. = address 13, Name = address 14 ~ 23, Store No.=
address 24, Category = address 25;and so on.
24-4
Recipe Editor
Note
24.3.
1.
After editing recipe data, it can be saved as .rcp, .emi, or .csv files. The .rcp files can
be downloaded to HMI using Utility Manager or external devices (USB drive or SD
card). The .emi files can be saved directly to the external device which is inserted to
HMI as extended memory (EM).
2.
When finished, Recipe Records can be opened in main menu [Library] [Recipe
Records]. In the example shown below, there are Recipe1 and Recipe2. Three items are
shown on the right hand side. The names of recipe come from System Parameter Settings.
24-5
Recipe Editor
3.
Setting
Description
Recipes:
Add
Delete
Up / Down Arrows
To define recipes according to the specified format, click [Add] button above the record
list to insert a new record and start editing each item. When click on the item, the item
format will be shown under the record list. This helps users to fill in each item with legal
value. Click [OK] to confirm and save the records.
24-6
Recipe Editor
Note
25-1
EasyConverter
25. EasyConverter
This Chapter explains how to use EasyConverter.
25.1.
25.2.
25.3.
25.4.
25-2
EasyConverter
25.1.
Overview
EasyConverter reads the Data Sampling file, Event Log file, and Operation Log file in HMI and
convert the files to Excel format.
From Utility Manager click [EasyConverter].
From EasyBuilder Pro menu select [Tool] [Data/Event Log Converter].
25.2.
1.
If the Data Sampling file format is .db, and the file includes data of more than one day, the
data to be viewed can be specified by selecting a date range. (If the file format is .dtl,
please skip this step.)
2.
The following is the setting dialog box, please set based on actual needs.
25-3
EasyConverter
3.
Click [OK], the Data Sampling layout is shown in the following figure. Click [Export to Excel].
The file will be converted to Excel format.
4.
25-4
EasyConverter
25.3.
1.
If the Event Log file format is .db, and the file includes data of more than one day, the data
to be viewed can be specified by selecting a date range.
(If the file format is .evt, please skip this step.)
2.
If the .db file of Event Log contains multiple languages, the language to be viewed can be
specified. (If the file format is .evt, please skip this step.)
3.
Click [OK], the Event Log layout is shown in the following figure. Click [Export to Excel].
The file will be converted to Excel format.
4.
25-5
EasyConverter
Note
25.4.
The "Event" column can be found. 0-> Event triggered; 1-> Event acknowledged; 2-> Event
returns to normal.
1.
If the Operation Log file includes data of more than one day, the data to be viewed can be
specified by selecting a date range.
2.
Click [OK], the Operation Log layout is shown in the following figure. Click [Export to Excel].
The file will be converted to Excel format.
3.
25-6
EasyConverter
25.5.
1.
2.
Click [Add File] to add the files to be converted. If click [OK] without selecting [Combine to
a file], the files will be exported to separate Excel files.
3.
If [Combine to a file] is selected, the files will be separated into different sheets of one
Excel file as shown in the following figure.
EasyBuilder Pro V5.01.02
25-7
EasyConverter
25.6.
Scaling Function
The equation of scaling new value = [(value + A) x B] + C, and users can set the values of A, B,
and C.
A -> lower limit of the value ; B -> [(scaled max) - (scaled min) / (upper limit) - (lower limit)] ; C
-> scaled min.
For example, here is a voltage data with a format of 16-bit unsigned (range: 0 ~ 4096).
To convert the data to volt, range form -5V to +5V, the new value = [(value + 0) x 0.0024] + (-5).
25-8
EasyConverter
Before scaling:
After scaling:
The settings described earlier can be saved and loaded next time. The extension name of the
setting file is *.lgs.
26-1
EasyPrinter
26. EasyPrinter
This chapter explains the setup steps of EasyPrinter.
26.1.
26.2.
26.3.
26.4.
26-2
EasyPrinter
26.1.
Overview
EasyPrinter is a Win32 application and can only run on MS Windows 2000 / XP / Vista / 7 / 8. It
enables HMI to output screen hardcopies to a remote PC via Ethernet. The following explains
how to use EasyPrinter.
on the market.
Multiple HMIs can share one printer so users dont have to prepare printers for each HMI.
Additionally, EasyPrinter can also be a backup server. Users can use Backup objects on HMI to
copy history files such as Data Sampling records and Event Log to a remote PC via Ethernet.
Please see the following illustration:
26-3
EasyPrinter
26.2.
Users can make screen hardcopies with a Function Key object. The hardcopies will be
transferred to the Remote Printer Server via Ethernet and then printed out.
26.2.1.
In EasyPrinters main menu, select [Options] [Settings] and the following dialog box appears:
1.
2.
3.
4.
26-4
EasyPrinter
1.
2.
3.
4.
In EasyPrinter main menu select [File] [Enable Output] to output any incoming print
request.
26.2.2.
26-5
EasyPrinter
3.
4.
5.
6.
Under [Output settings] set appropriate values for left / top / right / bottom margins. (The
margins are all set to 15mm in the example.)
Under [Communication settings] fill in the [IP address] of the printer server according to
the settings in EasyPrinter. Set [Port] to 8005, *User name+ to admin and *Password+ to
111111.
Click [OK].
In EasyBuilder Pro main menu select [Objects] [Button], select [Function Key], select
[Screen hardcopy] and set [Printer] to [MT Remote Printer/Backup Server].
7.
Place the Function Key object in the common window (window no. 4) so that screen
8.
Note
26-6
EasyPrinter
26.3.
Backup objects can upload historical data and Operation Log to remote backup server.
26.3.1.
In EasyPrinters main menu, select [Objects] [Settings] and the following dialog box will
appear:
1.
2.
3.
26-7
EasyPrinter
4.
1.
2.
3.
4.
26.3.2.
26-8
EasyPrinter
3.
Under [Communication settings] fill in the [IP address] of the printer server according to
the settings in EasyPrinter. Set the [Port] to 8005, *User name+ to admin and
*Password+ to 111111. (Note: These are default values.)
4.
Click [OK].
In EasyBuilder Pros main menu, select [Objects] [Backup] and the following dialog box
appears:
26-9
EasyPrinter
2.
3.
4.
5.
6.
7.
8.
Under [Source] select [Historical event log] (or [RW], [RW_A] if needed.)
Under [Backup position] select [Remote printer/backup server].
Under [Range] select [Today] and [All] (or other options if needed.)
Under [Trigger] select [Touch trigger].
Click [OK].
Place the [Backup] object in the common window (window no. 4), and users will be able
to make backups anytime when needed.
Compile and download the project to HMI. Press the Backup object on the screen to make
a backup of the history data.
Note
26-10
EasyPrinter
26.4.
EasyPrinter main menu is divided into 5 parts as shown in the following figure:
Area
Name
Description
Job List
Download Progress
Preview
Properties
Logger
26-11
EasyPrinter
26.4.2.
Operation Guide
Description
File
Enable Output
If selected, EasyPrinter processes the tasks one by one,
otherwise, EasyPrinter stores the tasks in memory.
Edit
Edit
Edits screen hardcopy by setting [Orientation], [Scaling] and
[Margins].
Delete
Deletes the selected tasks permanently.
Select All
Selects all tasks from [Job List].
View
Properties Bar
Shows or hide the Property Window.
Preview Bar
Shows or hide the Preview Window.
Download Bar
In [Download Progress] Window, the mode to display download
progress can be set by clicking the header of the [progress]
column as shown in the following figure:
Logger Bar
EasyPrinter can reserve up to 10,000 messages in Message
Window. If a new message comes in, the oldest message will be
deleted.
Options
Note
EasyPrinter can only reserve up to 128 MB of task data in memory. If the memory is full,
any request coming in afterwards will be rejected. Users must either operate [Enable
Output] or delete some tasks to make room for new tasks.
EasyBuilder Pro V5.01.02
26-12
EasyPrinter
Setting
Description
Server
Naming
Convention
for HMI
Folder
26-13
EasyPrinter
In Hardcopy Tab:
Setting
Description
Output
Print out to
EasyPrinter prints out the hardcopy result with the specified
printers.
Save to files in
EasyPrinter converts the hardcopy result into a bitmap file and
EasyBuilder Pro V5.01.02
26-14
EasyPrinter
saves it in the specified directory. The bitmap files are found at:
[Specified Path] \ [HMI Folder] \ yymmdd_hhmm.bmp
For example, when a hardcopy request is given at 17:35:00,
12/Jan/2009, the bitmap file will be named 090112_1735.bmp.
And if there is another bitmap file generated within the same
minute, it will be named 090112_1735_01.bmp and so on.
In Backup Tab:
Setting
Description
Output
26-15
EasyPrinter
Note
26.5.
EasyPrinter provides a conversion tool to convert the uploaded Data Sampling and Event Log
history files to .csv files automatically. To do so, please select [Enable] under [Convert Batch
File] to make EasyPrinter convert the history files.
In the following illustration, the conversion is actually executed by EasyConverter. EasyPrinter
simply follows the criteria in Convert Batch File and activates EasyConverter with proper
arguments to achieve the conversion.
Note
26.5.1.
EasyConverter is another Win32 application that converts history data into .csv or MS
Excel .xls files. Users can find it in the EasyBuilder Pro installation directory.
Users requesting this function must ensure EasyPrinter and EasyConverter are placed in
the same directory.
The Default Value of Convert Batch File
26-16
EasyPrinter
1: EasyConverter /c 20090112.dtl
A file named 20090112.csv is created.
The criteria of the default Convert Batch File:
1. Convert all Data Sampling history files (.dtl) into .csv files.
2. Convert all Event Log history files (.evt) into .csv files.
Note
$(Pathname) in the second argument stands for the full path name of the file. In the
previous case, EasyPrinter replaces it with:
[Specified Path] \ [HMI Folder] \ [datalog] \ [Folder name of the Data-Sampling object] \
20090112.dtl
EasyPrinter interprets the Convert Batch File in line basis, that is, each line forms a
criterion.
Any two arguments should be separated by a comma.
Every argument should be put in double quotes.
Do not put any comma inside an argument.
For more information, see 25 Easy Converter.
26.5.2.
Specialized Criteria
26-17
EasyPrinter
26.5.3.
26.5.4.
EasyPrinter examines criterion in descending order every time a file is uploaded. Once the file
meets a criterion, it stops the examination and starts over for the next file. Therefore, users
should place the criterion with a wider range downward in the Convert Batch File and place the
more specific criteria upward. For example:
"evt", "EasyConverter /c $(Pathname)"
"dtl", "EasyConverter /c $(Pathname)"
"dtl", "EasyConverter /c $(Pathname)", "192.168.1.26"
"dtl", "EasyConverter /c $(Pathname)", "my_HMI_01"
"dtl", "EasyConverter /c $(Pathname)", "my_HMI_02"
"dtl", "EasyConverter /s Voltage.lgs $(Pathname)", "*", Voltage"
The correct order of examination would be: (from bottom to top)
"dtl", "EasyConverter /s Voltage.lgs $(Pathname)", "*", Voltage"
"dtl", "EasyConverter /c $(Pathname)", "my_HMI_02"
"dtl", "EasyConverter /c $(Pathname)", "my_HMI_01"
"dtl", "EasyConverter /c $(Pathname)", "192.168.1.26"
"dtl", "EasyConverter /c $(Pathname)"
"evt", "EasyConverter /c $(Pathname)"
27-1
EasySimulator
27. EasySimulator
This chapter explains how to use EasySimulator.
27.1. Overview ..................................................................................................................... 27-2
27.2. Steps to setup EasySimulator ..................................................................................... 27-2
27-2
EasySimulator
27.1.
Overview
EasySimulator allows a project to be run in the On- or Off-line simulator without having to start
the simulator from EasyBuilder Pro. To do this, please prepare the required files and follow the
steps to setup EasySimulator.
27.2.
1.
2.
3.
4.
Line number
Description
Note
The required files can be found in the EasyBuilder Pro installation directory. Please install
EasyBuilder Pro first then copy the required files to your PC.
If EasySimulator.exe is not activated, please check if the installation directory is correct.
If the Failed to open project file: No such file or directory dialog box appears, this
indicates that there is an error of the .exob file path, please check again.
28-1
Multi-HMI Communication
28-2
Multi-HMI Communication
28.1.
Overview
Multi-HMI Communication means that a HMI connects with a remote HMI via COM port, and
read the data in the PLC connected to the remote HMI as shown in the following figure.
The PLC is connected with HMI 1, and HMI 1 is connected with HMI 2 via COM port, so that
HMI 2 can read the data in PLC through HMI 1.
The following parts explain how to create the projects used in HMI 1 and HMI 2 by using
EasyBuilder Pro.
28.2.
The following is the settings of HMI 1 in [System Parameter Settings] [Device List].
1.
2.
Since COM 1 of HMI 1 connects to PLC; the device list must include [Local PLC 1], and set
the correct parameters. In this example the connected PLC is FATEK FB Series.
COM 3 of HMI 1 is used to receive commands from HMI 2; a new device must be added
[Master-Slave Server] for setting communication properties of COM 3.
The parameters of COM 3 in the example are set to 115200, E, 8, 1, and uses RS232.
These parameters are not required to be the same as PLC settings, but the [Data bits]
must be set to 8. In general, a higher baud rate is recommended for HMI 2 to efficiently
read PLC data.
28-3
Multi-HMI Communication
28.3.
The following is the settings of HMI 2 in [System Parameter Settings] [Device List].
Since the PLC that HMI 2 reads is connected with HMI 1, thus for HMI 2, PLC is a remote device.
Therefore, it is necessary to add a [Remote PLC] into the device list. In this example the
connected PLC is FATEK FB Series. The way to create [*Remote PLC 1] is described in the
following steps.
1.
Add a new device. Set [PLC type] to [FATEK FB Series] and [PLC default station no.] must
be set in accordance with the connected PLC.
2.
Correctly set the parameters. Since COM 1 of HMI 2 connects with COM 3 of HMI 1
instead of directly connect with PLC, the settings of PLC will be ignored. HMI 2 COM 1 and
HMI 1 COM 3 must set to the same communication parameters and interfaces. As shown
in the following figure, use RS232, and set parameters to [115200, E, 8, 1].
28-4
Multi-HMI Communication
3.
For HMI 2, PLC is a remote device, change [Location] to [Remote], and select [COM port]
to connect remote HMI (HMI 1).
4.
When finished, a new device [Remote PLC] can be found in the [Device List]. This device
has a * symbol, which means, even if it contains Remote in the name, it actually gives
commands and gets replies through a local COM port, and therefore the connection with
PLC can be checked from a local system register. [*Remote PLC 1], [*Remote PLC 2],
[*Remote PLC 3] and [Local PLC 1], [Local PLC 2], [Local PLC 3] use the same system
registers from the listed below.
28-5
Multi-HMI Communication
Register
Description
LB-9150
LB-9151
LB-9152
LB-9200~
LB-9455
LB-9500~
LB-9755
LB9200 indicates the connection state with PLC (station no. 0), and
LB9201 indicates the connection state with PLC (station no. 1) and so on.
When ON, indicates the connection state is normal.
When OFF, indicates disconnection with PLC.
Set ON again, the system will then try to connect with PLC.
These local registers indicate the connection states with PLC (through
COM2).
LB9500 indicates the connection state with PLC (station no. 0), and
LB9501 indicates the connection state with PLC (station no. 1) and so on.
When ON, indicates the connection state is normal.
When OFF, indicates disconnection with PLC.
Set ON again, the system will then try to connect with PLC.
LB-9800~
LB-10055
28.4.
These local registers indicate the connection states with PLC (through
COM3).
LB9800 indicates the connection state with PLC (station no. 0), and
LB9801 indicates the connection state with PLC (station no. 1) and so on.
When ON, indicates the connection state is normal.
When OFF, indicates disconnection with PLC.
Set ON again, the system will then try to connect with PLC.
EasyBuilder Master-Slave Protocol enables MT500 to exchange data with eMT3000 local data
via the connected PLC.
28.4.1.
1.
28-6
Multi-HMI Communication
2.
3.
28.4.2.
1.
Settings in EasyBuilder500
In [System Parameter Settings], set [Multiple HMI] to Slave, set [HMI-HMI link speed] to
115200.
Note
28-7
Multi-HMI Communication
2.
Double click PLC Address View.exe to check PLC ID No. and fill in [Parameter 1] of
EasyBuilder.
3.
Connect HMIs via Com Port RS-232, the communication is then enabled.
28-8
Multi-HMI Communication
Note
There will always be a PLC selected in MT500 system parameter settings, in this case, even
to read/write eMT3000 local data, the ID of the selected PLC of MT500 system parameters
must also be filled in EasyBuilder [Parameter 1].
When using S7-200, S7-300 drivers, since MT500 reverses the high bytes and the low
bytes, this will cause MT500 to misread eMT3000 local data, therefore this way is not
available in Master-Slave Mode.
The Comparison between MT500 and eMT3000:
Bit/Word
MT500
eMT3000
Range
Ms_RB
RW_Bit
Ms_LB
LB
dddd: 0~9999
Ms_RW
RW
ddddd: 0~65535
Ms_LW
LW
dddd: 0~9999
29-1
Pass-through
29. Pass-through
This chapter explains how to set up Pass-through mode.
29.1.
29.2.
29.3.
29.4.
29.5. SIEMENS S7-200 PPI and S7-300 MPI Pass-through Settings ..................................... 29-8
29-2
Pass-through
29.1.
Overview
The Pass-through feature allows PC applications to control PLC via HMI. In this case the HMI is
an adaptor.
The Pass-through feature provides two modes:
Ethernet
COM port
Click [Pass-through] in Utility Manager to open the setting dialog box.
29.2.
Ethernet Mode
29.2.1.
Before using [Ethernet] mode, please check if Weintek virtual serial port driver has been
installed.
1. Open Utility Manager to check if the driver has been installed. If it shows [Please install
weintek virtual serial port driver], please click [Install].
2.
If the dialog below pops up during installation asking for verification, please click
[Continue Anyway].
29-3
Pass-through
3.
When finished, the [Virtual COM Port (PC <-> PLC)] field displays the virtual COM port
used.
29.2.2.
1.
2.
To change the number of virtual serial port, click [Virtual Serial Port] to open [Port Settings]
[Advanced].
29.2.3.
After installing the virtual serial port driver, follow the steps to use Ethernet mode of
pass-through feature.
1. Set the IP address of the HMI connected with PLC.
2. Set the communication port and the serial port that connects HMI with PLC.
3. Click [Apply], to apply the settings.
29-4
Pass-through
4.
When running PC application, set COM port to the used virtual serial port. For example, in
Mitsubishi application, if the virtual serial port is COM 3, set [PC side I/F Serial setting]
[COM port] to COM 3.
5.
With the correct configurations, upon execution of PLC application on PC, HMI will be
EasyBuilder Pro V5.01.02
29-5
Pass-through
29.3.
There are two ways to enable [COM port] mode of Pass-through feature.
Using Utility Manager.
Using system registers.
LW-9901: pass-through source COM port (1 ~ 3: COM 1 ~ COM 3)
LW-9902: pass-through destination COM port (1 ~ 3: COM 1 ~ COM 3)
29.3.2.
1.
29-6
Pass-through
Setting
Description
HMI IP
HMI IP address.
Baud rate /
Data bits /
Parity /
Stop bits
Note
When pass-through feature is no longer needed, click [Stop Pass-through] to stop it. HMI
will then resume communication with PLC.
29-7
Pass-through
29.3.3.
Mode
Description
Unknown
Normal
Pass-through
Note
29.4.
Pass-through Control
Generally speaking, during pass-through, HMI closes its connection with the PLC until the
pass-through mode ends. However, certain PLC drivers allow communications between HMI
and PLC in pass-through mode.
To see whether a driver supports concurrent communication, see PLC Connection Guide.
Pass-through control is controlled by LW-9903. The following table shows valid LW-9903 values
and their features.
LW-9903
Description
0 (Default)
29-8
Pass-through
Note
29.5.
Due to speed limitation, users may wish to set LW-9903 to 2 to enhance the speed of
program download/upload in pass-through mode.
EasyBuilder Pro supports SIEMENS S7-200 PPI and S7-300 MPI pass-through feature.
29.5.1.
Launch EasyBuilder Pro, go to [System Parameter Settings] [Device list], and then add
SIEMENS S7-200 PPI or S7-300 MPI device. Click [Pass-Through Settings] and the following
dialog box appears.
29.5.2.
Setting
Description
Disable pass-through
Designate client IP
Confirm that the HMI used in pass-through communication is started and connected to the
network. Launch STEP 7 Micro/Win, open [Communications] dialog box, and then search for
the HMI IP address. Connect the HMI to communicate.
29-9
Pass-through
29.5.3.
In Utility Manager run [Pass-Through], in [HMI Mode] select MPI ISOTCP to install virtual
serial port driver. Set the HMI IP address and the COM port that connects PLC, and then
start Pass-through.
2.
In STEP 7, go to [Option] [Set PG/PC Interface]. Confirm that the interface used is PC
EasyBuilder Pro V5.01.02
29-10
Pass-through
Adapter(MPI), and then click [Properties]. Select the same COM port as the virtuel serial
port. In the example COM 4 is used.
3.
When finished, STEP 7 can be used to Upload / Download PLC program via HMI.
29.5.3.2. Ethernet
1.
In STEP 7 go to [Option] [Set PG/PC Interface]. As shown in the following figure, select
TCP/IP(Auto) -> the name of the network interface card.
29-11
Pass-through
2.
Go to [PLC] [Update station to PG], in [Target Station] select [Can be reached by means
of gateway]. From left to right columns enter MPI, PLC station number, S7 Subnet ID, and
HMI IP address. When finished, S7 can upload PLC program to STEP 7 via HMI.
29.5.4.
System registers from LW-10850 to LW-10864 are used to set or indicate pass-through status of
SIEMENS devices.
For more information see 22 System Registers.
During pass-through mode, LW-10864 indicates errors and LW-10865 displays error code. The
following table lists the error codes, the description of each code, and the possible reason.
EasyBuilder Pro V5.01.02
29-12
Pass-through
Description
Successfully executed
Prohibit client from connecting
HMI
3
4
Invalid communication
protocol
Invalid PLC station number
5
6
Delayed communication
Busy communication
Possible Reason
HMI is already running
pass-through and wont accept any
request from other client.
When LW-10850 is set to 1, the
client IP for connecting HMI is
different from the IP specified in
LW-10858 ~ LW-10861.
Incorrect setting in LW-10853.
The PLC station number specified in
LW-10852 does not exist.
PLC connection failure.
PLC does not accept pass-through
request, please confirm PLC
settings.
Environment setup failure.
30-1
Project Protection
30-2
Project Protection
30.1.
Overview
The copyright of program design must be protected. This chapter discusses how to protect the
projects by settings in EasyBuilder Pro.
Note
30.2.
The protected projects cannot be decrypted by the factory since they are encrypted by
users, therefore, please remember your password.
EXOB Password
After editing a project (.emtp), users can compile the project to .exob format. The .exob file can
be downloaded to HMI. Password can be set to protect the .exob file in [EXOB password] when
compiling. (Password range: 0 ~ 4294967295)
A password will be required when attempting to decompile the .exob file back to .emtp file. If
the password is entered incorrectly for three times, please restart EasyBuilder Pro.
30-3
Project Protection
30.3.
Decompilation is Prohibited
After a project (.emtp) is done editing, users can compile the project to .exob format. The .exob
file can be downloaded to HMI. If [Decompilation is prohibited] check box is selected when
compiling, the setting in [EXOB password] will be ignored. Furthermore, the .exob file cannot
be decompiled to .emtp file.
30.4.
EasyBuilder Pro provides a system reserved register [LB-9033]. When this register is set ON,
the .exob file cannot be uploaded. If attempting to upload an .exob file with this register set
ON, the file obtained after uploading is 0 byte, and cannot be decompiled. Please reboot HMI
for the changed setting to take effect.
30.5.
Project Key
30-4
Project Protection
If the [Enable] check box is selected under [Project protection], please set the [Project key]
(password range: 0 ~ 4294901750). System registers LW-9046 ~ LW-9047 (32-bit) can be used
to set the [HMI key] for HMI. The values in LW-9046 and LW-9047 cannot be read or written by
a remote device. The .exob file obtained after compiling can only be executed on HMI when
[HMI key] and [Project key] match. If the keys dont match, LB-9046 is set ON. To change [HMI
key], please reboot HMI.
Note
When [HMI key] and [Project key] dont match, HMI and PLC cannot communicate.
Click the icon to download the demo project. Please confirm your internet connection.
30.6.
EMTP Password
After a project (.emtp) is done editing, a password can be set to protect the .emtp file. In
[System parameter] [Security] tab, select [Enable] check box under [Project password] and
click [Settings] (password range: 1 ~ 4294967295).
The password will be required when attempting to open the .emtp file.
Note
When using Window Copy function, if the source file is protected by EMTP password,
please enter the correct password for the system to execute window copy.
EasyBuilder Pro V5.01.02
31-1
Memory Map
31-2
Memory Map
31.1.
Overview
Memory Map communication protocol is similar to IBM 3764R, and it is used when the
memory data transferred seldom between two devices. When setting the two devices, one is
set as Master, and another is Slave. Generally, Master and Slave do not communicate unless
the data in the assigned address has changed. Once the data is synchronized, the
communication will stop. The purpose of Memory Map is to keep the consistency of the
assigned part of data between two devices (Master and Slave).
The corresponding addresses of Master and Slave devices should have the same property as
MW (MB) address type. The size of MW (MB) in HMI is 10,000 words.
MB and MW indicate the same area of memory, for example, MB0~MBf correspond to the bits
of MW0, MB10~MB1f correspond to MW1, as shown in the following table:
31.2.
Device Type
Format
Range
MB
DDDDh
DDDD:0~4095 h:0~f(hex)
MW
DDDD
DDDD:0~9999
PIN Settings
When using Memory Map communication protocol, the Master and Slave must have the same
communication parameters. The wiring is shown in the following table:
(the # will be distinct depends on the type of PLC or controller.)
COM Port
Device
Pin Mapping
RS-232
Master
TX(#)
RX(#)
GND(#)
Slave
RX(#)
TX(#)
GND(#)
COM Port
Device
Pin Mapping
RS-485 (4W)
Master
TX+(#)
TX-(#)
RX+(#)
RX-(#)
GND(#)
Slave
RX+(#)
RX-(#)
TX+(#)
TX-(#)
GND(#)
31-3
Memory Map
31.3.
Communication Flowchart
31-4
Memory Map
Note
31.4.
Address Types
Format
Description
0
1
2
0x02
0x##
0x##
0x00
(or 0x01)
0x10, 0x03
0x##
4, 5
6
31-5
Memory Map
The format of the commands that controls MW are listed in the following table:
MW Commands
Offset(byte)
Format
Description
0
1
2
0x01
0x##
0x##
0x##
4 to 4+n-1
0x##(L),0x##(H)
0x##(L),0x##(H)
4+n,
4+n+1
4+n+2
0x10
0x03
0x##
31.4.1.
Communication Examples
Example 1
If Master sets the data of MW-3 to 0x0a, Master will build communication with Slave
immediately due to the data changed, so Slave will update its MW-3 to 0x0a, the procedure is:
1. Master sends STX(0x02h).
2. Slave receives STX(0x02h) from Master, and sends ACK(0x06h) to Master.
3. Master receives ACK(0x06h) from Slave.
4.
31-6
Memory Map
Offset(byte)
Format
0
1
2
3
4, 5
6, 7
8
0x01
0x03
0x00
0x02
0x0a, 0x00
0x10, 0x03
0x19
Description
5.
6.
When finish communicating, Master sends the updated data in MW to Slave, and Slave
synchronizes its MW data with Master.
Example 2
If the data includes 0x10; please notice the change in data format.
If MW-10 of Slave is set to 0x10, Slave will build communication with Master immediately, and
Master will update its MW-10 to 0x10, the procedure is:
1. Slave sends STX(0x02h)
2. Master receives STX(0x02h) from Slave, and sends ACK(0x06h) to Slave.
3. Slave receives ACK(0x06h) from Master
4. Slave sends 0x01,0x10,0x10,0x00,0x02,0x10,0x10,0x00,0x10,0x03,0x10 as shown in the
following table:
Offset(byte)
Format
Description
0
1
2
3
4
5
6
7
8
9
10
0x01
0x10
0x10
0x00
0x02
0x10
0x10
0x00
0x10
0x03
0x10
The checksum,
0x01^0x10^0x10^0x00^0x02^0x10^0x
10^0x00^0x10^0x03=0x10
5. Master receives data from Slave and sends ACK(0x06h) to Slave.
6. Slave receives ACK(0x06h) from Master.
Slave sends the updated data in MW to Master, and Master synchronizes its MW data with
Slave.
EasyBuilder Pro V5.01.02
31-7
Memory Map
31.5.
Settings
The following explains how to connect two HMIs using Memory Map protocol.
Note
31.5.1.
1.
2.
If the type of these two HMIs are different, please create different project files, or, after
setting the first HMI, directly change to the type of the second HMI in [Edit] [System
Parameter Settings] [Model], and then compile and download the project to the second
HMI.
Steps to Add a Memory Map Device
Launch EasyBuilder Pro, select [New], and the model of HMI.
Click [Edit] form the main menu, click [System Parameter Settings], and select [Device] tab,
4.
5.
3.
31-8
Memory Map
6.
7.
Note
For eMT3000 and MT8000 Series, select [Memory Map] in the PLC type setting.
[Data bit] must set to 8 bits.
All the settings of the two HMIs must be the same.
31.5.2.
Object Settings
Add two objects in window no. 10, a Toggle Switch and a Multi-state Switch:
Create a Toggle Switch Object as shown in the following steps.
1. Set the [PLC name] of read address and write address to [Memory Map].
2. Set [Address] to MB-0.
3. Set [Switch style] to [Toggle]. (The picture and label of the object can be selected).
31-9
Memory Map
31.5.3.
Set the [PLC name] of read address and write address to [Memory Map].
Set [Address] to MW-1.
Set [Cyclical] to [Enable]. (The picture and label of the object can be selected).
When pressing the button in one of the HMIs, the status of another one will also be changed.
The way to connect a HMI with a controller is similar to the example above. The data in the
same addresses of the two devices are kept identical.
EasyBuilder Pro V5.01.02
32-1
32-2
32.1.
Overview
Apart from saving the history data from an HMI to your PC by using SD card, USB disk or
EasyPrinter, the FTP Server can also do the backup. After downloading a project to the HMI,
the FTP Server can be used to backup or update the history data and the recipe data, but not
able to delete those data.
32.2.
1.
2.
On PC, enter the HMI IP address: ftp://192.168.1.123/ (example), then log in by the user
name: uploadhis, and enter the HMI [history upload password] (if not changed, the
default password is 111111). Or, directly enter ftp://uploadhis:111111@192.168.1.123/
3.
After entering the IP address,the ftp address: ftp://192.168.1.123 and its folders are
shown as below:
32-3
32.3.
1.
2.
3.
1.
2.
1.
2.
Note
Since the recipe data is automatically saved per minute, after updating recipe.rcp or
recipe_a.rcp, the HMI must be rebooted within one minute or the saving will be failed.
The HMI can be rebooted by the system registers: [LB-9047] (reboot HMI) and [LB9048]
(reboot HMI protection). You can set [LB-9048] ON first, and then set [LB-9047] ON to
reboot the HMI.
33-1
EasyDiagnoser
33. EasyDiagnoser
This chapter explains how to use EasyDiagnoser.
33.1.
33.2.
33.3.
33.4.
33-2
EasyDiagnoser
33.1.
Overview
EasyDiagnoser is a tool for detecting the error in the communication of HMI with PLC.
33.2.
Configuration
Or, during On-line simulation, right click and select [Run EasyDiagnoser] to open
EasyDiagnoser. EasyDiagnoser will monitor the communication between PC and PLC.
33-3
EasyDiagnoser
3.
When finished, click [OK], EasyDiagnoser dialog box is shown in the following figure.
33.3.
EasyDiagnoser Settings
33.3.1.
Main Menu
Item
Description
File
Save As
The communication data can be saved as .xls file which can be
opened by Excel.
Exit
Exits current file.
View
Options
33-4
EasyDiagnoser
Activity Area
In the activity area, users can observe the communication between HMI and PLC.
Item
Description
Command
Read + Write
Displays Read and Write information in activity area.
Read
Displays only Read information in activity area.
33-5
EasyDiagnoser
Write
Displays only Write information in activity area.
Device
All
Displays the information of Local HMI and PLC.
If command is set to Read + Write, the Read and Write
information of Local HMI and PLC will be displayed in the
activity area.
If command is set to Read, the Read information of Local
HMI and PLC will be displayed in the activity area.
If command is set to Write, the Write information of Local
HMI and PLC will be displayed in the activity area.
Local HMI
Displays the information of Local HMI.
If command is set to Read + Write, the Read and Write
information of Local HMI will be displayed in the activity
area.
If command is set to Read, the Read information of Local
HMI will be displayed in the activity area.
If command is set to Write, the Write information of Local
HMI will be displayed in the activity area.
PLC
Displays the information of PLC.
If command is set to Read + Write, the Read and Write
information of PLC will be displayed in the activity area.
If command is set to Read, the Read information of PLC
will be displayed in the activity area.
If command is set to Write, the Write information of PLC
will be displayed in the activity area.
Station
Address
Type
Range
Capture
Error
33-6
EasyDiagnoser
33.3.3.
Polling Packages
Item
Description
Package ID
Device
Station
Index
Address /
Length
Displays the device type and the size of the package (in
words).
Item
Description
Object
Screen
ID
Address
33-7
EasyDiagnoser
Note
Click [Package ID], the device station number will be displayed in the 3rd column.
Double click [Package ID] then select [object] to display the position of the object.
For example, select [Numeric Input] and the screen no. displays 10.
This shows that this object is in window no. 10 in the project and will be marked with pink
frame on HMI as shown in the following figures
33-8
EasyDiagnoser
33.3.4.
Devices
33.3.5.
With Macro Trace function, the executing status of Macro can be seen.
In the illustration below, for [ID 1, Ln 7] and [ID 1, Ln 12]
ID 1 represents Macro name.
Ln 7 and Ln 12 represent that data are in the 7th and 12th line of Macro.
33-9
EasyDiagnoser
33.4.
Error Code
In the activity area, users can find the reason of error through the error codes listed below.
0: Normal
1: Time out
2: Fail Error
12: Ignore
When error occurs, error message will be shaded red as shown in the following figure.
The error code is 1 since the PLC is disconnected with HMI.
The error code is 12 since PLC No Response message window is shown.
33-10
EasyDiagnoser
33.5.
Window Adjustment
Users can drag or use the smart docking icons in editing window to place the windows to a
desired position.
Note
34-1
34-2
34.1.
Overview
34.2.
1.
2.
34-3
3.
4.
In the object setting dialog, select the PLC type, and select a controller tag.
34-4
34.3.
2.
Enter the name of the data type. [Description] field can be left blank. To add a member,
click [Add].
34-5
3.
Enter the name and the data type then click [OK].
4.
After adding all members, click [OK]. The new data type will be added to the list of data
types.
5.
After changing the name or description of a data type, click [OK] to update.
34-6
34.4.
Steps to Paste
1.
When adding a patch of members, this function allows users to add multiple data in one
step. First, click the [Paste] button.
2.
Type in data name, and then enter data type, separated by Space key or Tab key. It is
recommended that data be directly copied and pasted from RSLogix5000 to avoid errors.
Users can click [Sample] for a formatting example.
3.
Copy the needed Name and Data defined in RSLogix such as one shown above. Paste the
content in the editing window, as shown in the following figure.
34-7
4.
34.5.
Click [OK] to finish setting, and return to the main menu to check the added data.
Miscellaneous Functions
Revising member data
Double click the member to be revised, or click the member then click [Edit].
Deleting member data
Select the data to be deleted then click [Delete]. To delete all members of a data type,
press and hold the Delete button on the keyboard and then click the [Delete] button in
the dialog box.
Deleting a data type
Select the data type from the list on the left and then press the Delete key on the
keyboard.
Load from Default
To start over from default settings, click [Load from Default] button.
Save to Default
Saves data type settings to default for use in other projects.
EasyBuilder Pro V5.01.02
34-8
34.6.
Module-Defined
The exported CSV file will not list tags that are associated with module-defined structure.
Please define the tags manually by following the steps below.
1.
34-9
2.
In Structure Editor, right click [Module-Defined], and then click [New Data Type]. In [New
Data Type] [Name], enter the Module-Defined name.
34-10
3.
Click [Paste], and paste the data type information in the dialog box.
34-11
4.
Select a member and then click [Edit]. Since the data of the modules allows bit-wise
operation, [Binary Access] should be selected, then click [OK] to return to Structure Editor.
5.
35-1
EasyWatch
35. EasyWatch
This chapter explains how to use EasyWatch.
35.1.
35.2.
35.3.
35.4.
35-2
EasyWatch
35.1.
Overview
EasyWatch allows users to monitor the HMI or the PLC address values via Ethernet from the PC,
or to invoke the Macro for debugging, remote monitoring, and controlling.
For example, In EasyBuilder Pro, after creating a Numeric Input Object, you can set its address
to LW-10, and set the same address in EasyWatch. The value of LW-10 will be shown in
EasyWatch when successfully connecting.
Note
When the system register [LB-9044 (disable remote control)] or [System Parameter
Settings] [System Setting] [Prohibit remote HMI connecting to this machine] is enabled,
the feature of monitoring in EasyWatch will be unavailable.
35.2.
Configuration
35.2.1.
Basic Functions
Item
Description
File
35-3
EasyWatch
Objects
Help
35.2.2.
Item
Description
New
Open
Save
Cut
Copy
Paste
Run
Stop
35-4
EasyWatch
Delete
Add Monitor
Add Marco
HMI
Help Topics
35.3.
Monitor Settings
35.3.1.
Adding a Monitor
Monitor Settings
Setting
Description
Name
35-5
EasyWatch
HMI
PLC
Address
Address Type
Update Cycle
35.3.3.
1.
Or, select [Use Local HMI] checkbox to use the project on PC as a monitoring device.
2.
Select a target HMI or PLC. If one HMI is selected, you can directly control the local HMI.
35-6
EasyWatch
If one PLC is selected, click [I/F Setting] and select [Com Port] to choose a COM port.
Or, click [I/F Setting] and select [Ethernet] to set the IP address.
3.
Set the object address and its address type for being monitored.
EasyBuilder Pro V5.01.02
35-7
EasyWatch
4.
When a Word address is selected, set the address type to [Numeric] or [String].
[Numeric]: Select the data format of the monitor address.
[String]: Select the data format from [ANSI], [UNICODE], and [High/Reversed]. Set [No. of
Word] for reading the number of WORD.
5.
Set the update interval of the monitor object. The range can be set from 500ms to
5000ms.
35-8
EasyWatch
35.4.
Macro Settings
35.4.1.
Adding a Macro
Macro Settings
Setting
Description
Name
HMI
Macro Type
Macro
35.4.3.
1.
2.
35-9
EasyWatch
For example, if [Cycle Active] is set to 5 seconds, when executing a macro, the next time
to execute the macro object will be 5 seconds later.
3.
[Sleep]: Set the time interval between the executions of two Macros. Click [Add] or
[Replace] to add or replace the Macros from the list.
35.5.
HMI Manager
35.5.1.
35-10
EasyWatch
35.5.2.
HMI Manager
Setting
Description
Add
Select a target HMI. If the target HMI does not exist, add a
new device, see 35.3.3 Steps to add a new monitor.
Modify
Remove
35-11
EasyWatch
35.6.
Object List
35.6.1.
Setting
Description
Name
Status
HMI / PLC
Address
Address Type
Update Cycle
Value
35-12
EasyWatch
35.6.2.
Renaming the page: Double-click on the page name and enter a new name.
Positioning the column headers: Drag and drop the column headers to the desired
location.
36-1
Administrator Tools
36-2
Administrator Tools
36.1.
Overview
Administrator Tools allows storing the data of [User Accounts], [USB Security Key], [e-Mail
SMTP Server Settings], and [e-Mail Contacts] to USB. With EasyBuilder Pro user accounts and
e-Mail function, the data built can be imported to HMI by Function Key object set to Import
user data / Use [USB Security Key]. The portability and convenience is greatly improved.
Launch Administrator Tools, select the check boxes in [Save] column to enable the selected
functions introduced in this chapter.
36.2.
User Accounts
36.2.1.
Select [User Accounts] check box and complete the relevant settings.
36-3
Administrator Tools
Settings
Description
Secret
User Name
Password
Class A to L
Add
Remove
Import
Export
Effective Time
Save to USB
36-4
Administrator Tools
Note
1.
2.
36.2.2.
1.
Click [Add] to create a new account. Click [Remove] to delete the selected account. Select
[Secret] check box to define the account as a secret user. Type in [User name] and
[Password] and check the privilege from [Class A] to [Class L] check boxes.
2.
To back up the data, click [Export]. Click [Use Password] to protect the data, next time
when click [Import] to import the backup data, a password is required.
3.
If under [Effective Time], the [Restrict the using terms] check box is selected, only during
the specified time period can the users import account data to HMI. If not selected, users
EasyBuilder Pro V5.01.02
36-5
Administrator Tools
4.
36.2.3.
When finished, click [Save to USB], select the location of USB and then click [Create]. If
successful, the Generated successfully! message is shown.
The following steps explain how to create a Function Key to import data in EasyBuilder Pro.
1. Select Import user data/Use [USB Security Key] in Function Key setting dialog box, and
then click [Settings].
2.
Under [Function mode] select [Import user accounts]. Select the device that stores the
data in [Data position]. Select [Overwrite] under [Account import mode]; HMI will only
store the account data imported this time. Select [Append], HMI will store the accounts
imported this time and those already exist. Select [Delete file after importing user
accounts] check box to delete the source files after importing.
EasyBuilder Pro V5.01.02
36-6
Administrator Tools
Click the icon to download the demo project that explains how to import user accounts by
using Function Key. Please confirm your internet connection.
36.3.
36.3.1.
With the predefined user login information, the USB Security Key can be used to log in directly.
36-7
Administrator Tools
Settings
Description
User Name
Password
Confirm
Effective Time
Save to USB
Note
1.
36.3.2.
1.
Type in the existing user name and password. Type the password again in [Confirm] field
for password confirmation.
2.
Under [Effective Time] if [Restrict the using terms] check box is selected, only during the
specified time period can users log in using USB Security Key. If not selected, users can log
in using USB Security Key at any time.
3.
When finished, click [Save to USB], select the location of USB and then click [Create]. If
successful, the Generated successfully! massage is shown.
36-8
Administrator Tools
36.3.3.
The following steps explain how to create a Function Key to enable USB Security Key in
EasyBuilder Pro. By touching the object, the USB Security Key is enabled for login.
1. Select Import user data/Use [USB Security Key] in Function Key setting dialog box, and
then click [Settings].
2.
Under [Function mode] select [Use USB Security Key to Login]. Select the device that
stores the data in [Data position].
36-9
Administrator Tools
Click the icon to download the demo project that explains how to enable login using USB
Security Key by using Function Key. Please confirm your internet connection.
36.4.
Select [e-Mail SMTP Server Settings] check box to complete the relevant settings.
36.4.1.
1.
Mail Settings
Description
SMTP Server
Port
User name
Password
Confirm
Sender Information
Description
Name
Mail address
Save to USB
36-10
Administrator Tools
2.
When finished, click [Save to USB], select the location of USB and then click [Create]. If
successful, the Generated successfully! massage is shown.
36.5.
e-Mail Contacts
36.5.1.
36-11
Administrator Tools
Settings
Description
Add
Remove
Removes a contact.
No. of groups
Current group
Description
Group description.
Import
Export
Save to USB
Note
1.
2.
3.
From Group A to P, when [No. of groups] is 1, only Group A will exist, when added to
2, Group A and Group B will exist, and so on.
36.5.2.
1.
2.
36-12
Administrator Tools
3.
Press the up or down arrows of the spin box of [No. of groups] to add new groups. If add
to 2, Group B can be found. Repeat step 1 and step 2 to add contacts into groups.
4.
After adding all the e-mail contacts, click [Export] to back up the data for future use and
5.
modification. Next time when needed, click [Import] to import the backup data.
When finished, click [Save to USB], select the location of USB and then click [Create]. If
successful, the Generated successfully! massage is shown.
36-13
Administrator Tools
36.5.3.
The following steps explain how to create a Function Key to import e-Mail contacts.
1. Select Import user data/Use [USB Security Key] in Function Key setting dialog box, and
then click [Settings].
2. Under [Function mode] select [Import e-mail settings and contacts]. Select the device that
stores the data in [Data position].
Click the icon to download the demo project that explains how to import e-mail settings
and contacts by using Function Key. Please confirm your internet connection.
EasyBuilder Pro V5.01.02
37-1
37-2
37.1.
Overview
To access the data of the PLC connected to HMI with SCADA software (Supervisory Control and
Data Acquisition), the former way was to transfer PLC data to the HMIs local address first, and
then use MODBUS TCP/IP protocol on PC to read HMI local address to get PLC data. Now by
using MODBUS TCP/IP Gateway provided by EasyBuilder, the mapping of MODBUS address to
PLC address can be defined first, and then one can directly use MODBUS TCP/IP protocol to
access PLC data.
37.2.
37-3
3.
Click [Address Mapping Tables] button and the following default tables will be displayed.
Modify the tables if needed or add new tables.
37-4
4.
For example, to access the data in the 50 consecutive registers of FATEK FB Series PLC
starting from register D-0, configure the settings as shown in the following figure.
(1)
(2)
Select the device type of the registers to be mapped, in the example select [Word].
Select the mode to access the data in the mapped register, in the example set to
(3)
(4)
(5)
(6)
[Read/Write].
Set the start address of MODBUS, in the example set to 4x-1.
Set the start address of the mapped PLC, in the example set to D-0.
Set the range size of address mapping, in the example set to 50.
If needed, select high/low byte swap (AB->BA) or high/low word swap
(ABCD->CDAB).
The above figure shows that MODBUS Server 4x-1 ~ 4x-50 registers are mapped to FATEK
FB Series PLC D-0 ~ D-49 registers.
5.
When finished, the data of FATEK FB Series PLC D-0 ~ D-49 registers are now accessible by
using MODBUS TCP/IP protocol to send read / write command to 4x-1 ~ 4x-50 registers.
37-5
37.3.
Definition
Normal
The defined register range must not overlap between different mapping tables.
If [MODBUS TCP/IP Gateway] is enabled, EasyBuilder will cancel the original mapping
between MODBUS Server and HMI register. That includes:
(1) 0x, 1x mapped to LB
(2) 3x, 4x mapped to LW, RW
Therefore, to access data in LB or LW register via 0x, 1x, 3x, 4x, configure the Address
Mapping Table again. The following figure is an example.
37-6
SCADA can only read / write the register defined in one Address Mapping Table at one
time, that is, the same MODBUS command cannot access the data in the registers defined
in different Address Mapping Tables.
As shown in the above figure, in Mapping Table 1 set MODBUS 4x-1 to access register
D-200, table size 99 words, and in Mapping Table 2 set MODBUS 4x-100 to access register
R-0, table size 100 words. If using SCADA to send a command to read from 4x-1 to 4x-199,
table size 199 words, since the range spans two different tables, the command will not be
accepted by HMI. Instead, access the data with two separate commands (4x-1~4x-99 and
4x-100~4x-199), each reading only from one table as shown in the following figure.
38-1
EasyDownload
38. EasyDownload
This chapter explains how to setup EasyDownload.
38.1. Overview ..................................................................................................................... 38-2
38.2. Configuration .............................................................................................................. 38-2
38-2
EasyDownload
38.1.
Overview
EasyDownload allows downloading the project data file built in EasyBuilder Pro via Ethernet or
USB cable. In EasyBuilder Pro main menu select [Tools] and then select [Build Data for USB Disk
or SD Card Download] to build the data file before running EasyDownload.
38.2.
Configuration
Settings
Description
RW
RW_A
Recipe database
Ethernet
USB cable
Send the file to HMI via USB cable. Please make sure that
the USB driver is correctly installed.
IP
38-3
EasyDownload
Name
Search
Search All
Reset recipe
Reset recipe database
Delete startup screen
Reset event log
Reset data log
Settings
Note
Take eMT3000 Series as an example, the built download data directory has the following
structure. Please select the parent directory of the generated file when downloading.
Parent directory
First subdirectory
emt3000
001
002
Pub
Second subdirectory
driver
font
39-1
Data Security
39-2
Data Security
39.1.
Overview
Data Security allows setting restrictions on the write operations that modify local Word or Bit
register data. To do so, open [System Parameter Settings] [Device] tab, select [Local HMI] and
then click [Security...] button.
39.2.
Configuration
39-3
Data Security
Setting
Description
LW protection \
Prohibit remote-write
operation of remote HMI
or MODBUS client
RW protection \
Prohibit remote-write
Click [Data Security] button to set the restrictions on the write operations that modify local
Word or Bit register data.
39.2.1.
39-4
Data Security
Setting
Description
Description
Address Mode
Min. value
Max. value
Disable remote-write
operation
Used only in
remote-write
operation
39-5
Data Security
As shown in the preceding figure, the remote HMI will not be able to write to LW-0, and when
the value written to the local address is greater than 10, the value 10 is written instead, and
the notification bit LB-0 will be set ON.
39.2.2.
Setting
Description
Description
Address Mode
Set ON only
39-6
Data Security
Disable remote-write
operation
Used only in
remote-write
operation
Notification
As shown in the preceding figure, the remote HMI can only set ON LB-10, while the local HMI is
not restricted. If the remote HMI attempts to set LB-10 OFF, the system will trigger notification
bit LB-0 ON.
A-1
Appendix A.
Comparison of HMI Software Features
Series
Project Size
eMT
64MB
cMT
32MB
mTV
64MB
iE
16MB
XE
64MB
64MB
(*3)
64MB
16MB
(*6)
Project Protection
(*4)
Enhanced Security
N/A
N/A
Media Player
(*1)
N/A
N/A
N/A
Audio Output
(*5)
N/A
N/A
N/A
(*2)
N/A
N/A
N/A
N/A
USB CAM
N/A
N/A
Flow Block
Combo Button
Picture View
N/A
File Browser
Recipe Import/Export
CAN Bus
N/A
N/A
N/A
(*7)
VNC
N/A
N/A
N/A
N/A
(*8)
N/A
N/A
EasySystemSetting
N/A
Video Input
A-2
Note
1.
2.
3.
4.
5.
6.
7.
8.