sysmac ethernet daserver users guide - faweb · pdf file5.1 tutorial ... wonderware intouch...
TRANSCRIPT
SYSMAC Ethernet DAServer
Users Guide
Revision 2D
Jan. 2017
Precautions about the Document
(1) Operate the product only after you have thoroughly read the document and understood the contents.
(2) This document describes the details of the product and is not guaranteed to meet your specific objectives.
(3) No part of this document shall be reproduced or reprinted without the prior written permission.
(4) The information in this document is subject to change without notice.
(5) Contents of this document apply to program version 2.0 and later.
Liability Limitations of the Product
(1) Takebishi Corporation makes no warranties concerning the product, unless stated in the warranty guidelines.
(2) Takebishi Corporation disclaims, without limitation, all liability for any loss or damage of any kind, direct or
indirect, to the customers or any third parties caused by the use of this product or by unexpected defects in the
product.
About This Software
(1) You may use this software by installing it on one specific computer. If you wish to install the software on another
computer and use it, purchase another copy.
(2) You may not copy the software for any reason other than backup.
(3) Store the CD (media) which contains the software safely.
(4) You may not reverse engineer, decompile, or disassemble the software.
(5) You may not allow any third parties to use the whole or a part of the software by transferring, exchanging, or
shifting it without the prior permission.
(6) The specifications for this software are subject to change without notice.
Copyright
Copyright of the program and online manual contained in the CD belongs to Takebishi Corporation. You may not copy,
transfer, or distribute (including distribution on the network) the contents of the CD to any third parties. You may not
register or record the contents to video tape or other media without the prior permission.
Trademarks
(1) ArchestrA and InTouch are trademarks of Wonderware Corporation.
(2) SYSMAC is trademarks of Omron Corporation.
(3) Windows and EXCEL are trademarks of Microsoft Corporation.
(4) All other company names, product names, and trademarks belong to their respective owners.
Table of Contents
1. Introduction ............................................................................................................................................................................................5
1.1 Overview ...........................................................................................................................................................................................5
1.2 Features ............................................................................................................................................................................................5
1.3 PLC Communications Protocols ..................................................................................................................................................5
1.4 Application Communication Protocols........................................................................................................................................6
2. Composition ...........................................................................................................................................................................................7
2.1 System Configuration ....................................................................................................................................................................7
2.2 System Requirements ....................................................................................................................................................................8
2.2.1 Computer System ....................................................................................................................................................................8
2.2.2 PLC System ..............................................................................................................................................................................8
3. Installation .............................................................................................................................................................................................9
3.1 Procedure ..........................................................................................................................................................................................9
3.2 Installed Files ............................................................................................................................................................................... 14
3.3 License Certification .................................................................................................................................................................... 15
3.3.1 Serial Number ....................................................................................................................................................................... 15
3.3.2 Hardware Key ....................................................................................................................................................................... 15
3.3.3 License status and application operation ........................................................................................................................ 15
3.3.4 Using License Manager ....................................................................................................................................................... 16
3.4 Uninstallation ............................................................................................................................................................................... 20
4. Specifications ...................................................................................................................................................................................... 22
4.1 General Specification .................................................................................................................................................................. 22
4.2 Access Name (Tagname)............................................................................................................................................................. 23
4.3 Access Range ................................................................................................................................................................................. 24
4.4 Device Type and Item Name ..................................................................................................................................................... 25
4.5 Expanded Tagname .................................................................................................................................................................... 26
4.5.1 Not Specified .......................................................................................................................................................................... 27
4.5.2 Bit Position Read in Word Device (: 00 ~ : 15) ................................................................................................................. 27
4.5.3 32-bit Signed Integer (: D) ................................................................................................................................................... 27
4.5.4 16-bit BCD (: B) ..................................................................................................................................................................... 27
4.5.5 32-bit BCD (: C) ..................................................................................................................................................................... 27
4.5.6 Floating Point (: R) ............................................................................................................................................................... 27
4.5.7 16-bit Unsigned Integer (: U) .............................................................................................................................................. 27
4.5.8 Character String (: S) ........................................................................................................................................................... 28
4.5.9 Text Decimal (: A) .................................................................................................................................................................. 28
4.5.10 Text Hexadecimal (: H) ...................................................................................................................................................... 28
4.5.11 Batch File Write (.F) ........................................................................................................................................................... 28
4.6 System Tag .................................................................................................................................................................................... 29
4.6.1 Global System Tag ................................................................................................................................................................ 29
4.6.2 Device Specific System Tag................................................................................................................................................. 29
4.6.3 Device Group Specific System Tag .................................................................................................................................... 30
4.6.4 Redundant Device Specific System Tag ........................................................................................................................... 31
5. Configuration ...................................................................................................................................................................................... 32
5.1 Tutorial ........................................................................................................................................................................................... 32
5.2 DAServer Manager Configuration ........................................................................................................................................... 38
5.2.1 Global Parameters................................................................................................................................................................ 38
5.2.2 Adapter Configuraiton ......................................................................................................................................................... 40
5.2.3 PLC Configuration ............................................................................................................................................................... 43
5.2.4 Redundancy Configuration................................................................................................................................................. 47
5.3 DCOM Configuration ................................................................................................................................................................. 49
5.3.1 Overview................................................................................................................................................................................. 49
5.3.2 Procedure ............................................................................................................................................................................... 51
5.3.3 Notes on Windows XP/SP2 ................................................................................................................................................. 57
5.4 Access from InTouch .................................................................................................................................................................... 61
5.5 DDE Access from Microsoft EXCEL ........................................................................................................................................ 62
5.6 DDE Access from Visual Basic 6.0 ........................................................................................................................................... 63
5.7 OPC Access from Visual Basic 6.0 ............................................................................................................................................ 64
6. SYSMAC Ethernet Unit Configuration ........................................................................................................................................ 65
6.1 Hardware Configuration ............................................................................................................................................................ 65
6.1.1 IP Address .............................................................................................................................................................................. 65
6.1.2 Node No .................................................................................................................................................................................. 65
6.1.3 Unit No ................................................................................................................................................................................... 65
6.2 Software Configuration (CX-Programmer) ............................................................................................................................ 66
6.2.1 I/O Table (Definition of IP Address and Port No) ........................................................................................................... 66
6.2.2 Routing Table (Definition of Network No.) ...................................................................................................................... 68
7. Troubleshooting .................................................................................................................................................................................. 69
7.1 Version Information..................................................................................................................................................................... 69
7.2 Connectivity with PLC ............................................................................................................................................................... 69
7.3 WindowViewer (InTouch) Communication Status ............................................................................................................... 69
7.4 Attention of TCP/IP communication ........................................................................................................................................ 70
7.5 Error Messages ............................................................................................................................................................................ 71
7.5.1 Application Messages ........................................................................................................................................................... 71
7.5.2 Error Message Causes and Solutions ............................................................................................................................... 73
7.5.3 Frequently Asked Questions .............................................................................................................................................. 74
7.5.4 Winsock Error Codes ........................................................................................................................................................... 76
7.6 Diagnostics Functions ................................................................................................................................................................. 77
7.6.1 LOG Flag ................................................................................................................................................................................ 77
7.6.2 Diagnostics ............................................................................................................................................................................. 79
8. Addendum ........................................................................................................................................................................................... 86
8.1 DDE Test Client (Visual Basic) ................................................................................................................................................. 86
8.2 OPC Sample Program (Visual Basic) ...................................................................................................................................... 88
8.3 OPC Test Client ............................................................................................................................................................................ 89
8.4 User Support................................................................................................................................................................................. 90
Introduction
- 5 -
1. Introduction This User’s Guide describes the functions and operation of SYSMAC Ethernet DAServer (hereafter referred to as
DAServer).
Media CD of DAServer contains the DAServer software, online manual, and a sample program. The manuals are not
available in hard copy.
1.1 Overview DAServer is the Microsoft Windows application program that acts as a communications protocol server. It allows
other Windows application programs to access data in OMRON PLC SYSMAC via Ethernet. It supports DDE,
FastDDE, SuiteLink, and OPC as the communication protocols.
*DAServer is intended for use with Wonderware InTouch (Version 7.11 Patch 02 and later).
1.2 Features DAServer provides the following features:
- The ability to use multiple application communications protocols (OPC/SuiteLink/DDE/FastDDE/NetDDE)
simultaneously.
- The ability to be configured remotely.
- Extensive RAS functions.
- The ability to add tags beforehand and import/export them
- The ability to add new application-level protocols on the fly
1.3 PLC Communications Protocols DAServer supports FINS Protocol of OMRON SYSMAC-CJ/CS Series, CV/CVM1 Series and C Series PLCs. FINS
Protocol defines the communication protocol of OMRON SYSMAC Series PLCs. It allows external applications to
access the internal memory of PLCs.
Introduction
- 6 -
1.4 Application Communication Protocols SYSMAC DAServer uses 5 types of protocols (OPC, SuiteLink, DDE, FastDDE, NetDDE) to communicate with client
applications.
OPC
OPC (OLE for Process Control) is a standard interface based upon Microsoft’s OLE/COM technology. This standard
makes possible interoperability between automation/control applications, field systems/devices and business/office
applications.
Traditionally software/application developers had to create custom drivers to exchange data with field devices. But OPC
defines a common interface and provide the reusability of HMI, SCADA and control/custom applications.
OPC uses DCOM (Distributed COM) for remote communications via the network.
SuiteLink
SuiteLink is a TCP/IP based protocol designed by Wonderware. It provides data integrity and high throughput.
It provides the following features:
- Ability to provide client applications with a time stamp and quality indicator on all data values.
- High throughput.
- Microsoft’s standard network transport protocol TCP/IP
DDE
DDE is a protocol which provides applications in the Windows environment with two-way communication: Send/receive
data and instructions to/from each other. With it, client applications send a request, DAServer sends data according to
the request.
FastDDE
FastDDE is a protocol which simplifies and packs Wonderware’s proprientry DDE messages into a single Microsoft
DDE message.It improves efficiency and performance by reducing the total number of DDE transactions required
between a client and a server.
NetDDE
NetDDE is a protocol which extends the standard DDE functionality for communication over networks and enables
communication between applications running on different computers connected via networks or modems.
Composition
- 7 -
2. Composition System configuration of DAServer is provided below.
2.1 System Configuration
DAServer
Wonderware InTouch Microsoft VisualStudio
LOCAL PC REMOTE PC
Wonderware InTouch
Ethernet
SYSMAC-CJ/CS/CV/C
- You can access the PLCs on Ethernet from InTouch on a local PC or custom application (VC/VB). You can
access other stations on Ethernet via the station connected on Ethernet.
- You can access DAServer on another node from the application on a remote PC to get the PLC data.
- You can configure/diagnose DAServer that is running on another node from SMC (System Management
Console) on a remote PC.
Composition
- 8 -
2.2 System Requirements
2.2.1 Computer System
The following hardware and software are required to run DAServer:
Description
Computer PC running Windows
Basic OS*
Windows 10 Version 1607
Windows 8/ Windows 8.1
Windows 7
Windows Vista
Windows Server 2012(R2)
Windows Server 2008(R2)
Memory Min. 1GB
HDD Min. 100MB
Drive CD-ROM drive
LAN Adapter Adapter that runs on Windows
* Performance has been confirmed on Japanese and English OS’. Please test carefully before using the system on
an OS other than Japanese and English OS’.
* There are following limitations for Windows 8/7/Vista/2012/2008.
- Unsupported NetDDE.
- Run execution file directory because service program are not available with DDE.
- Does not use both interface, DDE and OPC at a same time.
2.2.2 PLC System
DAServer supports the following PLCs.
CPU Units*1 Ethernet Units
SYSMAC-CJ Series
CJ2H
CJ2M
CJ1G
CJ1H
CJ1M
CJ2H-CPUnn-EIP (CPU Port)
CJ2M-CPUnn (CPU Port)
CJ1W-ETN21/11
CJ1M-CPU13/12/11-ETN
SYSMAC-CS Series CS1G, CS1H, CS1D CS1D-ETN21D, CS1W-ETN21
CS1W-ETN21/11/01
SYSMAC-CP Series
CP1H CP1W-CIF41*2
CJ1W-ETN21/11
CP1L CPU Built-in Ethernet Port*2
CS1W-EIP21*2, NSJW-ETN21*2
SYSMAC-CV Series CVM1(D), CV500/1000/2000 CV500-ETN01
SYSMAC-C Series
C200HE, C200HG, C200HX
CQM1H, CPM1A, CPM2A
CPM2C, C1000H, C2000H
-----
*1 You can access PLCs without Ethernet Unit only via other network, such as accessing PLCs on Control Link through
other station on Ethernet
*2 There is limited by the specifications of the unit., refer to 4.3.
Installation
- 9 -
3. Installation
3.1 Procedure (1) Insert the DAServer CD into the CD drive to launch the installer. Select “Install DAServer” from the display.
There is something that the installation starts without displaying this screen according to the product.
Important
You must have Administrator rights to set up DAServer.
Installation
- 10 -
(2)If your computer doesn’t fill with precondition, the following window may be displayed. Install displayed lists and
press “Next.”
(3) If a FactorySuite product is already installed, the following dialog may be displayed. Click OK.
(4) When the InstalShield Wizard is displayed, press “Next.”
Installation
- 11 -
(5) If you agree with the License Agreement, check “I agree” and press “Next.”
(6) Enter user information and press “Next.”
Important
Please input the serial number that has been described to the product accurately.
If inputting invalid serial number, following dialog will be displayed.
Installation
- 12 -
(7) After input valid serial number, the following dialog will be displayed. Select where you wish to install the system
or components you wish to install as may be necessary.
(8) Preparation for installation is now complete. Press “Install” to start installation.
(9) If no FactorySuite product is installed, the following dialog may be displayed. Click OK.
Installation
- 13 -
(10) When installation is completed correctly, the following dialog will be displayed. Press “Finish.”
Installation
- 14 -
3.2 Installed Files The installer installs the following files:
File Name Destination Comment
SysmacEthernet.exe Install Folder DAServer itself
SysmacEthernet.dll Install Folder DAServer itself
SysmacEthernet.pdf Install Folder Online manual
SysmacEthernet.aaRUL Install Folder DAServerdefinition file
SysmacEthernet.aaCFG Install Folder DAServer configuration file
CFG_TAKEBISHI_LAN.dll Install Folder Dialog library
CFG_TAKEBISHI_ETN.dll Install Folder Dialog library
LicMan.exe Install Folder License Manager
Register.bat Install Folder Registry registration file
UnRegister.bat Install Folder Registry unregistration file
DdeSample.xls Install Folder EXCEL sample
OPC Client.exe Install Folder OPC client test tool
DDE Client Sample Install Folder¥Sample¥VbSampleDde¥*.* VB6.0 project
OPC Client Sample Install Folder¥Sample¥VbSampleOpc¥*.* VB6.0 project
Wonderware Common components may be installed in addition to the files listed above.
Installation
- 15 -
3.3 License Certification This section explains the procedure to install the regular license by using License Manager.
License Certification is the procedure that adds the license information to the product which runs as regular product.
The licensing agreement of our software product grants the right to install and use the product in one specific PC.
3.3.1 Serial Number
The serial number is a unique number assigned when the customer buys the license. When in installation, the
customer should accurately input this serial number, which can be displayed by License Manager.
3.3.2 Hardware Key
Some types of product request the hardware key. In this case, it is necessary to install both the serial number and the
hardware key in the same PC to execute the application. Input the serial number accurately when in installation, and
connect the hardware key to a PC.
3.3.3 License status and application operation
The following table shows the status of the license under each situation and the operation of the application.
Operation can be confirmed with the icon of SMC.
SMC Icon License Status Application Operation
Valid License Run without the restriction.
Invalid License Run as demo mode for only one hour.
Stop communication after one hour.
Term License
Run for 14 days after installation.
Install the license code within a period of 14 days.
Stop communication after the specified period has passed.
Temporary License Run as demo mode for 30 days after installation.
Stop communication after the specified period has passed.
Expiration License Stop communication beacause the specified period has passed.
Installation
- 16 -
3.3.4 Using License Manager
Start License Manager
From the Start Menu select “DAServer” -> “License Manager” to start the license certification tool.
If status is displayed as "OK", the license is valid. In this case it is not necessary to operate the following.
Installation of hardware key
If status is displayed as "HASP", it is necessary to install the hardware key.
Install the hardware key in a PC, and restart the license manager.
If status is displayed as "OK", the license is valid. In this case it is not necessary to operate the following.
Installation
- 17 -
Get the license code
If status is displayed as "TERM", it is necessary to get and install the license code within 14 days.
The license code can be got by WEB, Mail and FAX.
WEB
Please input and transmit serial number, computer ID and necessary information from the user registration page
on our WEB site.
We will inform of the license code by e-mail.
URL http://www.faweb.net/asp/registration.aspx
Please transmit serial number, computer ID and a necessary information (company name, name, phone number
and mail address) to us with the e-mail subject as "FAWEB:License".
We will inform of the license code with mail.
Mail Address [email protected]
FAX
Please fill in Serial No., computer ID and necessary information on the user registration form and fax it to us.
We will inform of the license code with FAX.
FAX +81-75-325-2273
Installation
- 18 -
Install License
Select the product in License Manager and right-click on it. From the popup menu select “Install License”.
Input the acquired license code into "License Code", and press OK button.
If the license code is certified, status becomes "OK".
Installation
- 19 -
Transfer License
The license can be transferred from a source PC in which the license is installed to the other destination PC. The
application is developed, evaluated with the development machine, and it is possible to shift to the destination machine.
1. First, before transferring License, install the product on destination PC.
Confirm the computer ID in the destination PC’s display below.
2. Next, in the source PC’s display below select the product with Status displayed “OK” and right-click on it.
From the popup menu select ”Transfer License”.
3. Input the computer ID of the destination PC into the source PC.
4. Then press “Transfer” button. The license code is displayed corresponding to the destination PC.
Caution: After this operation is done, the license in the source PC becomes invalid.
5. Install the license code above on the destination PC. Then transferring License is completed.
Installation
- 20 -
3.4 Uninstallation To uninstall DAServer, select “SYSMAC Ethernet DAServer” from “Add/Remove Programs” on the Control Panel.
Important
Please you must run “Unregister.bat” of Install path as administrator before uninstllation, if the operating system
uses User Accoutn Control (UAC).
Installation
- 21 -
If you select “Change,” the following dialog will be displayed to allow you to modify or repair the contents of installation.
Specifications
- 22 -
4. Specifications This section describes the specifications of DAServer.
4.1 General Specification
Description
Service Activation Yes
Max. Number ofAdapters/Ports 62 adapters
Max. Number of PLCs 62 units/adapter
Supported Protocols DDE, FastDDE, NetDDE, SuiteLink, OPCDA2.05A
Devices That Can Be Accessed CIO, WR, HR, AR, LR, T, C, DM, EM
Tag Alias Yes (defined in “Device Items” of SMC)
DDE DDE Application Name SysmacEthernet
DDE Topic Name Arbitrary
OPC
Program ID Takebishi.SysmacEthernet.1
Class ID 0CC1EAC9-3A06-4A05-00AE-396F7F65B002
OPC Access Path Not supported
OPC Item ID Adapter name, device name and tagname are specified with
delimiter
Data Type
VT_BOOL Boolean
VT_I2 16-bit signed integer
VT_UI2 16-bit unsigned integer
VT_I4 32-bit signed integer
VT_R4 32-bit signed real
VT_BSTR Character string
Expansion Format
1-bit boolean
Word device bit position specification
16-bit signed integer
16-bit unsigned integer
32-bit signed integer
16-bit BCD
32-bit BCD
Floating point
Character string
Text-format decimal
Text-format hexadecimal
PLC
Communication
Communication Code Binary
Communication Protocol FINS command
Communication Commands Batch Read / Batch Write
Note
“Maximum number of adapters” and “maximum number of PLCs” mean the maximum number that can be defined
on the software.
Specifications
- 23 -
4.2 Access Name (Tagname) How to access DAServer depends on the way a client application communicates with it.
OPC
To access an OPC item, the OPC client needs to connect to DAServer, create an OPC group, and register tags. DAServer
supports Public OPC groups, which are shared across multiple clients to improve the performance of the entire system.
In case of OPC communications, Access Name consists of 6 elements: node name, program name, group name, device
group, link name and item name. The following briefly describes the respective elements:
Node Name Computer name on the network
Program ID The name of the program that provide the client application with data element. OPC server
has the name with a unique identifier (ProgID)
DAServer is named “Takebishi.SysmacEthernet.1.”
Group Name The OPC group created from the client application for organizing a collection of items based
on the update rate
Link Name Set of hierarchy node names defined by the DAServer manager
Item Name A name that consists of a PLC device name (such as register, relay, timer, and counter) and an
extension.
For example, if you wish to access data memory (DM) 0 of PLC “PLC1”, adapter “PORT1”, of DAServer on the local
node, the Tagname will be “PORT1.PLC1.DM0.”
DDE/SuiteLink
In the case of DDE/SuiteLink communications, Access Name consists of 4 elements node name, application name, topic
name and item name. The following briefly describes respective elements:
Node Name Computer name on the network
Application Name The name of the program that provide the client application with data element. DAServer is
named “SysmacEthernet.”
Topic Name Name of the accessed PLC information defined by DAServer manager. The name is used in
all communications with the PLC. You can define multiple topic names for the same PLC to
poll different points at different rates.
Item Name A name that consists of a PLC device name (such as register, relay, timer and counter) and an
extension.
Note
SYSMAC device names listed on the following page can be used as item names. You may define an alias of the
device name on the “DeviceItems” tab on SMC’s “PLC Configuration” page.
Specifications
- 24 -
4.3 Access Range DAServer accesses PLCs by using the FINS protocol. The table below shows the range of the maximum access of the
FINS protocol at read/write.
Accessing Station Max. Read Points Max. Write Points
Discrete Word Discrete Word
Ethernet connection 1998 999 1992 996
Controller Link connection 1998 999 1992 996
SYSMAC LINK connection 538 269 534 267
SYSWAY connection 538 269 534 267
DeviceNet connection 538 269 534 267
Note
- "Max. Read Points" in the table is applied to normal polling process.
- "Max. Write Points" in the table is applied to the time of writing in the expanded tag, which is not accessed bits
but accessed only words.
- When accessing PLCs via multiple networks, the range of the maximum point is limited to the smallest value of
the maximum points of accessed network
- CP1L Series / CP1W-CIF41 has limit to access points. Please specify Bit R/W is 538, Word R/W 269.
Important
Because SYSMAC does not support the random write, usually you can write by each point.
Be careful for a large amount of writing. It can increase the communication traffics, and make the response of PLC
lower.
Specifications
- 25 -
4.4 Device Type and Item Name See below for a list of the PLC device types and the corresponding item names that can be specified and registered
under an alias.
Bit Device
Item
Name Device Type Type Note
TIM Timer up flag Dec
CNT Counter up flag Dec
Word Device
Item
Name Device Type Type Note
CIO Channel I/O (input and output relay) Dec
WR Internal auxiliary relay Dec
HR Hold relay Dec
AR Special auxiliary relay Dec Cannot write in AR0 ~ AR447.
LR Link relay Dec Only for SYSMAC-C Series.
T Timer current value Dec
C Counter current value Dec
DM Data memory Dec Also accessible by the Item Name ‘D’
EM Expanded data memory Dec Specify bank number in decimal. For example specify
“EM10:10000” when accessing the bank A1000.
Note
-Device range depends on your CPU type.
- When accessing CIO, WR, HR, AR, LR by each bit, use the expanded tag name ‘Bit position read/write in
word device’. For example, Specify ‘CIO3:15’, when accessing the 15th bit of CIO channel 3.
Table for read / write bits access
Some PLCs do not support writing bits for some devices. For more details refer to the table below.
Item
Name Device Type CS/CJ Series CV Series C Series
CIO Channel I/O (input and output relay) OK NG NG
WR Internal auxiliary relay OK NG NG
HR Hold relay OK NG NG
AR Special auxiliary relay OK - NG
LR Link relay - - NG
T Timer current value - - NG
C Counter current value - - NG
DM Data memory OK NG NG
EM Expanded data memory OK NG NG
Note
-C/CV Series does not support writing bits. You can write only by channel.
-you can not write bits in timer/counter current value.
Specifications
- 26 -
4.5 Expanded Tagname See the table below and the next pages to specify an expanded tagname. Put a separator between the tagname and
expanded character string.
Expansion Description Note
None Word device : 16-bit signed integer
Bit device: boolean
: 00~: 15 Bit position read in word device: boolean Cannot write / No bit device specification
: D 32-bit signed integer
: B 16-bit BCD
: C 32-bit BCD
: R floating point
: U 16-bit unsigned integer
: Sxxx character string “xxx” is the number of access points (numeric value
between 1 and 1023)
: Axxx text Dec “xxx” is the number of access points (numeric value
between 1 and 1023)
: Hxxx text Hex “xxx” is the number of access points (numeric value
between 1 and 511)
: Fxxx File Batch Write “xxx” is the number of access points (numeric value
between 1 and 1023)
*Access points must be below the “Access Range” defined in the Device Specification(previous page).
Note
A colon “:” or a dot “.” can be used as a separator. But when using InTouch, a dot has a special meaning as a tag
variable name. In that case, register the tag variable name and item name differently.
(Example) tag variable name “DM100_D” -> item name “DM100.D”
Specifications
- 27 -
4.5.1 Not Specified
When the tagname is not expanded (tagname + device number only), word device will be a 16-bit signed integer type,
and the bit device will be a Boolean. For data register number 1000, it will be “DM1000.”
4.5.2 Bit Position Read in Word Device (: 00 ~ : 15)
By specify a separator and a number after the tagname (word device), you can read bits in a word device. A bit device is
not expanded. This tag is only for read, not for write.
For example, “DM99: 0” indicates the 0th bit of DM99, and “DM100: 15” indicates the 15th bit of DM100.
4.5.3 32-bit Signed Integer (: D)
By specify “: D” after the tagname, you can read/write the register value as a 32-bit signed integer.
For example, “DM100: D” will access DM100 and DM101 as double word.
4.5.4 16-bit BCD (: B)
By specify “: B” after the tagname, you can read the register value after a BCD to BIN conversion, and write the value
after a BIN to BCD conversion.
For example, specifying “D100: B” when reading, 1234 (Hex) stored in D100 is converted into “1234 (Dec).” Specifying
“D100: B” when writing, 5678(Dec) is converted into 5678 (Hex).
4.5.5 32-bit BCD (: C)
By specify “: C” after the tagname, you can read the register value as a 32-bit BCD value after a BCD to BIN conversion,
and write the value after a BIN to BCD conversion.
For example, specifying “DM100: C” when reading, 1234 (Hex) stored in DM100 is converted into 1234 (Dec).
Specifying “DM100: C” when writing, 5678 (Dec) is converted into 5678 (Hex).
4.5.6 Floating Point (: R)
By specify “: R” after the tagname, you can read/write the register value as a 32-bit real data.
For example, Specifying “DM10: R”, “0x42F6CCCD” stored in DM10 and DM11 is read “123.4” as floating point data.
4.5.7 16-bit Unsigned Integer (: U)
By specify “: U” after the tagname, you can read/write the register value as an unsigned integer.
For example, specifying “DM0: U”, “-5536” stored in DM0 is read as “60000.”
Specifications
- 28 -
4.5.8 Character String (: S)
By specify “: Sxxx” ( xxx is the number of accessed register points: 1 ~ 1023) after the tagname, you can read/write the
register value as a character string. When "Register R/W Points" of the PLC Configuration screen doesn't come up to
"1023", the point set by "Register R/W Points" becomes the maximum value. To access a character string tag with
InTouch, use an I/O Message type tag.
For example, specify “DM100: S5” to handle the data in DM100~DM104 as character string. When you create an I/O
Message type tag with the tagname “DS” and item name “DM0:S5” using InTouch and execute “DS = ABCDEFGHIJ”,
the result is “DM0=0x4241, DM1=0x4443, DM2=0x4645, DM3=0x4847, DM4=0x4A49”.
4.5.9 Text Decimal (: A)
By specify “: Axxx” (xxx is the number of accessed register points: 1 ~ 1023) after the tagname, you can read/write the
register value as text decimal. When "Register R/W Points" of the PLC Configuration screen doesn't come up to "1023",
the point set by "Register R/W Points" becomes the maximum value. When poking, the maximum size of value is 2047
bytes. To access a character string tag with InTouch, use an I/O Message type tag.
For example, specify “DM100: A3” to handle DM100~DM102 as text decimal. When “DM0=1234, DM1=100, DM2=1“ is
in PLC and you create an I/O Message tag with a tagname “DM0A” and item name “DM0:A3” using InTouch and
access it, "1234,100,1" will be stored in “DM0A.” This data is a 16-bit signed integer. If anything other numbers than
(0~9) is included in the write character string, the subsequent values are ignored.
4.5.10 Text Hexadecimal (: H)
By specify “: Hxxx” ( xxx is the number of accessed register points: 1 ~ 511) after the tagname, you can read/write the
register value as text hexadecimal. When "Register R/W Points" of the PLC Configuration screen doesn't come up to
"511", the point set by "Register R/W Points" becomes the maximum value. To access a character string tag with
InTouch, use an I/O Message type tag.
For example, specify “DM100: H3” to handle DM100~DM102 as text hexadecimal. When “DM0=0x1234, DM1=0x567,
DM2=0x1” is in PLC and you create an I/O Message tag with a tagname “DH” and item name “DM0:H3” using
InTouch and access it, "123405670001" will be stored in “DH.” If anything other numbers than (0~9, A~F) is included
in the write character string, the character is handled as “0.”
4.5.11 Batch File Write (.F)
By specify ": Fxxx" ( xxx is the number of accessed register points: 1 ~ 1023) after the tagname, you can write the value
in CSV file in batch to PLC. You create text file as CSV format and write the path to the tag when excuting POKE
command. When "Register R/W Points" of the PLC Configuration screen doesn't come up to "1023", the point set by
"Register R/W Points" becomes the maximum value. This type is write-only and the reading value always space
character. To access the tag with InTouch, use an I/O Message type tag.
For example, specify "DM1: F64" to handle DM1 ~ DM64 as CSV file. When poking values of tag1 ~ tag64 in batch,
you create an I/O Message tag with a tagname "DMFILE" and item name "DM1: F64" using InTouch and execute
following script.
FileWriteFields("C:¥TEST.CSV", 0, "tag1", 64);
DMFILE = "C:¥TEST.CSV";
You should use the value as the range of 16 bit register.
Specifications
- 29 -
4.6 System Tag System tag is a special tag whose information is set by the server.. Tagname starts with “$SYS$.”
4.6.1 Global System Tag
Item Type Attribute Description
$SYS$Licensed BOOL Read
Stores the information of whether appropriate DAServer license
exists.
(TRUE when yes, FALSE when no)
4.6.2 Device Specific System Tag
Item type Attribute Description
$SYS$Status BOOL Read
Indicates the status of communication with the PLC.
(TRUE when good, FALSE when bad)
For a DDE or SuiteLink client, the status is for each hierarchy
level.
For an OPC client, the status is for all hierarchy levels.
* At the root of each hierarchy, the status is always GOOD
(TRUE).
* This does not indicate if an error has occurred in each item.
$SYS$ErrorCode DWORD Read
Stores a detailed error code.
“0” when good.
“non-0” when there is an error.
$SYS$ErrorText STRING Read Stores an error character string.
$SYS$StoreSettings WORD Read/Write
If the client changes the update interval in SYS$UpdateInterval
and writes a “1” to this system tag, the new update rate is saved
in the configuration file. And if the file is saved correctly, this
system tag is cleared to “0.”
If the client changes the update interval in
$SYS$UpdateInterval but does not write a “1” to
$SYS$StoreSettings, DAServer will keep the same update
interval as before until it is restarted.
When reading, this tag is always “0”.
Specifications
- 30 -
4.6.3 Device Group Specific System Tag
Item Type Attribute Description
$SYS$UpdateInterval DWORD Read/Write
Stores the current update interval in milliseconds.
When you specify “0,” none of the tags in this topic will be
updated.
Valid range is 0~2147483647.
$SYS$MaxInterval DWORD Read Stores the maximum value of the update interval.
$SYS$WriteComplete WORD Read/Write
Stores the write status.
“0” when there is a write request.
“1” when all the write processes are done (completed/failed).
$SYS$ReadComplete WORD Read/Write
Stores the read status.
“1” when all active tags are read at least once.
“0” when at least one tag is added. If the read operation of the
tag is successful, it will be “1,” and “-1” if it fails.
Writing a “0” to this tag resets the read status of all items.
And when all the read processes are completed, it will be “1” or
“-1.”
$SYS$ItemCount DWORD Read Stores the number of added tags.
$SYS$ActiveItemCount DWORD Read Stores the number of active tags.
$SYS$ErrorCount DWORD Read
Stores the number of tags that have had an error (quality flag
is anything other than GOOD).
$SYS$PollNow BOOL Read/Write
This system tag is used to update all tags at once separate from
the update interval.
Writing “1” to this system tag rereads all tags.
This operation is valid even when the update interval is set to
“0.”
Specifications
- 31 -
4.6.4 Redundant Device Specific System Tag
Item Type Attribute Description
$SYS$ForceFailover BOOL Read/Write
By set to ‘1’, DAServer should force this device to switch
to secondary device.
$SYS$ActiveDevice STRING Read
DAServer stores active device name such as
“New_Adapter_000.New_PLC_000.”
$SYS$StandbyDevice STRING Read
DAServer stores standby device name such as
“New_Adapter_001.New_PLC_000.”
$SYS$PrimaryDeviceStatus BOOL Read
DAServer stores communication status for primary
device. It contains the value of $SYS$Status.
$SYS$SecondaryDeviceStatus BOOL Read
DAServer stores communication status for standby
device. It contains the value of $SYS$Status.
$SYS$FailoverTime STRING Read DAServer stores GMT time when failover was occurred.
$SYS$FailoverReason STRING Read
This system item will show the reason for the failover.
The value text indicate to "ForceFailover" or the value of
the system item $SYS$ErrorText
Configuration
- 32 -
5. Configuration You must configure the DAServer Manager (hereafter referred to as DAServer manager) on the System Management
Console (hereafter referred to as SMC) to use DAServer. Launch SMC from “Windows Start Menu” ->”Programs”
->”Wonderware” ->”System Management Console.” Configure the hardware and software, such as device hierarchy
and simulation modes, before you start DAServer.
5.1 Tutorial This section describes the steps to use DAServer quickly. Detailed description of each step will be provided later.
1. Installation/configuration of Ethernet adapter
Install the Ethernet adapter and open the “Local Area Connection Properties” page from the Control Panel.
Configuration
- 33 -
Open the TCP/IP properties page and configure the IP address, host name, etc.
2. Installing the product
Run Setup.exe on the CD and install SYSMAC Ethernet DAServer.
Important
You must have Administrator rights to install SYSMAC Ethernet DAServer.
Configuration
- 34 -
3. Starting up SMC
From the Start menu, select ”Programs” ->”Wonderware” ->”System Management Console” to start SMC.
Expand the DAServer manager tree in SMC and select “Takebishi.SysmacEthernet.1” (it should be under DAServer
Manager if it is installed correctly) on the left pane.
- DAServer exists under the Local node as “Takebishi.SysmacEthernet.1.”
- See the DAS Control Client documentation for general information about operations in this snap-in environment.
Configure DAServer. Before proceeding, determine the hierarchical structure of the network/PLC environment.
4. Global Parameters
Select “Configuration” to display the Global Parameters View on the right pane. Configure the default update interval,
write process type, etc. here.
Note
The default Poke Mode settings for the DAServer is "Optimization Mode." When write operation is repeated
continuously, only the last value will actually be written. For more details, see the DAServre manager document.
Important
Grayed-out global parameters indicate the functions that are not supported.
Configuration
- 35 -
5. Adapter Configuration
Right mouse click on “Configuration” and select “Add Adapter Object” from the pop-up menu on the left pane.
A default hierarchy tree called “New_Adapter_000” will be created. Its configuration view will be displayed on the
right pane. Configure the IP address, port number, etc. here.
Configuration
- 36 -
6. PLC Configuration
Right mouse click on “New_Adapter_000” and select “Add PLC Object” from the pop-up menu on the left pane.
- A default hierarchy tree called “New_PLC_000” will be created.
- Its configuration view will be displayed on the right pane. Configure the network number, CPU number, etc. here.
7. Configuring Topic Name
You can create a group on each hierarchy.
Open the “Device Groups” tab in configuration view, right mouse click and select “Add” from the pop-up menu.
Note
If you have two SMCs running and open the same configuration view from another instance, the second instance will
be locked until the first instance is closed (it will not be saved).
Configuration
- 37 -
8. Activate DAServer
Before connecting from the client application, right mouse click on “Takebishi.SysmacEthernet.1” from the DAServer
manager and execute “Activate Server” to start DAServer.
Note
When using OPC, DAServer automatically starts when you connect from the client.
9. Auto Service
To run DAServer as a Windows service program, right mouse click on “Takebishi.SysmacEthernet.1” and select
“Configure As Service” ->”Auto Service.”
Configuration
- 38 -
5.2 DAServer Manager Configuration
5.2.1 Global Parameters
Click on “Configuration” under “Takebishi.SysmacEthernet.1” to display the Global Parameters View.
Configurable Fields
Item Default Value Description
Device Group Update Interval 500 ms
Define the polling interval of the <Default> device group.
When accessing using OPC, it will be processed as the
<Default> group. UpdateInterval of OPC will be the
interval between events.
Slow Poll Interval 10000 ms Define the slow poll interval when a communication error
has occurred.
Transaction to Subscription Ratio 1
Define the maximum number of messages that can be
processed simultaneously when multiple polling messages
exist.
Transaction Message Timeout 60000 ms Define the message transaction timeout.
Server Protocol Timer 50 ms Define the process interval within the server.
Diagnostic Backlog Size 20 Define the backlog size of the diagnostic transaction display.
Maximum Queued Transactions 75 Define the maximum number of outstanding transactions in
each of the three transaction queues (read, write, refresh.)
Maximum Queued Updates 1 Define the number of outstanding subscription updates for
an individual item.
DDE/SuiteLink Timer Tick 50 ms Define the time between processing DDE/SL client requests.
Configuration
- 39 -
Item Default Value Description
Poke Mode Optimization
Mode
Define the process that takes place when there are multiple
write requests to one item at the same time:
ControlMode: Writes all requests.
TransitionMode: Writes only the first, second, and last
requests.
OptimizationMode: Writes only the last value.
Case Sensitive OFF Determine the case (upper or lower) of group and item
names.
Device Group Cache OFF A different group can share the cache as long as it has the
same item ID (for future expansion).
Simulation Mode OFF Select the operation in simulation mode.
System Items ON Select whether or not system tags can be used.
Unique Device Groups ON Authorize the use of the same topic name.
*Grayed-out fields indicate unavailable functions.
Configuration
- 40 -
5.2.2 Adapter Configuraiton
This section describes how to configure the adapter.
New Adapter Configuration
See below for how to create a new adapter configuration:
1. Click on “Takebishi.SysmacEthernet.1” on left pane.
2. Right mouse click on “Configuration” and select ”Add Adapter Object” from the pop-up menu.
3. A default adapter called “New_Adapter_000” is created. You can select an arbitrary adapter name.
4. You may create and define multiple adapter configurations when you wish to communicate with multiple PLCs.
Configuration
- 41 -
Configurable Fields
Configure the Ethernet communication on the Adapter Configuration page.
Field Default Value Description
Protocol UDP/IP Select the protocol used to communicate with the PLC (TCP/IP or UDP/IP).
Adapter IP Address 0.0.0.0 (* 1)
IP address of the PC LAN adapter in decimal value. Specify “0.0.0.0” when
using one LAN adapter or DHCP system. Specify a unique value when
using multiple LAN adapters or specifying an explicit IP address.
Adapter Port No. 0 (* 2)
PC port number in decimal value. Regularly, “0” is specified. When you
specify your own port number using UDP/IP or or use TCP/IP full passive,
specify this field within the range 1024 ~ 65535.
PLC IP Address 192.168.0.1 Enter the IP address of the connected PLC in decimal value.
PLC Port No. 9600
Enter the port number of the connected PLC in decimal value. Specify the
port number defined by a parameter or ladder program. Valid range is 0 ~
65535.
Configuration
- 42 -
Item Default Value Description
Reply Timeout 3000 ms
Define the reply timeout after the request message is sent. When Reply
Timeout expires, a timeout error occurs. Valid range is 50 ~ 60000.
Simulation Mode OFF Select whether or not to run DAServer in simulation mode without
connecting to the PLC.
Simulation Type Random
Random :Tag value is changed every time. Write data is ignored.
Fixed Value :Tag value is always 0. Write data is ignored.
Shared Memory :Tag value is fixed. Write data is reflected.
Use Redundant
Communication OFF
Please turn on the check box and set the parameter on standby Ethernet
when you use redundant communication.
* 1 When you specify “0.0.0.0,” it will use the IP address of the LAN adapter that is found first.
* 2 When you specify “0,” OS automatically assigns a port that is not used.
Redundancy Communication
When "Use Redundant Communication" is checked, redundant communication becomes effective. The
communication route dynamically changes into the subsystem (parameter in the right of the screen) when the trouble
occurs in the main system (left parameter in communication tools of the screen) so that there is no response from PLC
even if prescribed times is retried. Similarly, it changes into the main system when communication error occurs in the
subsystem.
* When the communication route changes, the communication is continued by the route.
(Never automatically return to the main system side)
Primary System Sub System Primary System Sub System
Configuration
- 43 -
5.2.3 PLC Configuration
This section describes how to configure the PLC you wish to access (hereafter referred to as PLC configuration).
New PLC Configuration
1. Right mouse click on any adapter and select “Add PLC Object” from the pop-up menu.
2. A default PLC called “New_PLC_000” is created. You can select an arbitrary PLC name.
3. Define multiple devices if you wish to access other stations via the connected PLC.
Configuration
- 44 -
Configurable Fields
Configure PLC type, etc. here.
Item Default Value Description
PLC Type CJ/CS PLC type you wish to access (SYSMAC-CJ/CS, CV/CVM1, C Series )
Network No. (PLC) 1 Specify the Network No. of the connected PLC.
Node No. (PLC) 1 Specify the Node No. of the connected PLC.
Unit No. (PLC) 0 Specify the Unit No. of the accessed module. Usually set to“0”.
Network No. (PC) 1 Specify the net work No. of the PC
Node No. (PC) 2 Specify the Node No. of the PC.
Unit No. (PC) 0 Specify the Unit No. of the PC. Usually set to “0”.
Configuration
- 45 -
Item Default Value Description
Coil R/W Size 996
Specify the maximum number of points of regular read and expanded write
in a bit device.
Register R/W Size 996
Specify the maximum number of points of regular read and expanded write
in a word item.
Coil Write Size 1 Cannot configure
Register Write Size 1 Cannot configure
Note
Please refer to Chapter 4.3 "Access Range" for details of the access point.
Configuring Topic Name
Open the “Device Groups” tab and configure the topic name used for DDE/SuiteLink communication.
Right mouse click on the view to display a pop-up menu. Select “Add” to create a new topic and select an arbitrary
name and update interval.
Item Default Value Description
Name --- Define the topic name used for DDE/ SuiteLink communication.
Update Interval 1000 ms Define the update interval for DDE/ SuiteLink communication.
Configuration
- 46 -
Configuring Tag Name
Open the “Device Items” tab and add the tagname (alias of the actual device).
Right mouse click on the view to display a pop-up menu. Select “Add” to create a new tag and select an arbitrary name
and reference address.
Item Default Value Description
Name --- Define the tagname.
Item Reference --- Define the real device name.
Tag Import/Export
You may import and export tags from the pop-up menu. You can export the tag information as a CSV file, edit it on
Excel, for example, and import it back to save some trouble.
Configuration
- 47 -
5.2.4 Redundancy Configuration
This section describes how to configure the redundancy switching target PLC dynamically.
New Redundancy Configuration
1. Create some Adapter/PLC configurations
2. Right mouse click on any adapter and select “Add REDUNDANT_DEVICE Object” from the pop-up menu.
3. A default configuration called “New_REDUNDANT_DEVICE_000” is created. You can select an arbitrary name.
Configuration
- 48 -
Configurable Fields
Item Default Value Description
Primary Device ---- Pop-up “Device Browser” and select a hierarchy as primary device.
Secondary Device ---- Pop-up “Device Browser” and select a hierarchy as secondary device.
Ping Item ----
A Ping item must be specified and be a valid tag in both the primary and
secondary controllers to determine the connection status for $SYS$Status.
The Ping item can be a static item in the device such as a firmware version
or processor type. If the Ping item is invalid or does not exist in the controller,
the failover operation may not work correctly as the value of $SYS$Status
may continue to stay as FALSE in the standby device.
Configuring Topic Name
Configure topic name and tag name as same as aboved operations.
Configuration
- 49 -
5.3 DCOM Configuration This section describes how to configure DCOM to connect from a remote computer using OPC. The examples provided
in this section are typical configuration examples. Please modify each setting based on your system security needs.
Note
Please refer to related documents on OS for more details on DCOM.
5.3.1 Overview
Client user must be authenticated on the machine on which the OPC server is running in order to enable DCOM
connection. Authentication of the client machine user is normally done by configuring the same user account and the
same password on both machines running in a work group. From the user account on the client machine, you log on
to the local PC, remote log on to the server machine, and run the OPC server. The following description provides an
example of configuration on the OPC server machine, unless otherwise indicated.
See below for a configuration example of using DCOM:
Machine Field Simple Secure
Server
Authentication Level None Connect
Start Access Right Everyone Arbitrary user name
Access Right Everyone Arbitrary user name
Identity Interactive User Interactive user/Launching user
Client Pre-defined Authentication Level None None
* “Simple” configuration is for when security is not emphasized.
To use DCOM in a Windows XP workgroup environment, start “Local Security Policy” from Administrative Tools and
set “Network Access: Sharing and security model for local accounts” to “Classic.” This step is not required when you
wish to use DCOM in the domain environment.
Configuration
- 50 -
Important
You can not connect via DCOM if checking the “Internet Connecting firewall” in property window of “Local Area
Connection” on Windows Server 2003 / Windows XP. So you should not check this option button.
When Windows XP/SP2 is used, DCOM can be connected by making the firewall effective by setting security.
Please see 5.3.3 "Notes on Windows XP/SP2" for details of the setting.
Configuration
- 51 -
5.3.2 Procedure
Start DCOM Configuration Utility
From the Start menu, select “Run” and enter “DCOMCNFG.EXE” to launch the DCOM configuration utility.
Note
You must log on with Administrator rights to configure DCOM.
Configuration
- 52 -
Default Properties
Combined utilities start on Windows XP. Navigate through “Component Services” -> “Computer” -> “My Computer.”
Right mouse click on “My Computer,” open the Properties page from the pop-up menu, and select the “Default
Properties” tab. On Windows 2000, start DCOMCNFG and select the “Default Properties” tab.
* Check the “Enable Distributed COM on this Computer” check box.
* Set “Default Authentication Level” to “Connect.”
* Set “Default Impersonation Level” to “Identify.”
Important
On the client machine, set “Default Authentication Level” to “None.”
Configuration
- 53 -
DAServer-specific Properties (General)
Right mouse click on ”0CC1EAC9-3A06-4A05-00AE-396F7F65B002” from the “Applications” tab for Windows 2000
and “DCOM Config” under “My Computer” for Windows XP, and select Properties from the pop-up menu.
* Set the “Authentication Level” to “None.”
Configuration
- 54 -
DAServer-specific Properties (Location)
Select the “Location” tab.
*Check “Run application on this computer.”
Configuration
- 55 -
DAServer-specific Properties (Security)
On Windows XP, the following page opens. Select “Customize” in each field and press “Edit.” On Windows 2000,
select “Use Custom Access Permissions” and press “Edit.”
*Add “Everyone” and “SYSTEM” to “launch permissions,” “access permissions,” and “configuration permissions.”
Configuration
- 56 -
DAServer-specific Properties (ID/Identity)
Select the “ID” tab on Windows XP and “Identity” tab on Windows 2000 and specify the user account that runs the
application.
Select “This User” and specify a user that has Administrator rights. Or select “System Account” to run it as a service
program. When launching DAServer as a service, it becomes a “System Account,” and you cannot specify it as an
“Interactive User” or “Launching User.”
Configuration
- 57 -
5.3.3 Notes on Windows XP/SP2
"Windows firewall" becomes effective if service pack 2 is applied to Windows XP, and neither the DCOM connection
through LAN nor the browsing of the server list that uses the OPCENUM function can be done in the setting of default.
Because the white paper goes out of OPC Foundation, notes when service pack 2 is applied to Windows XP will
recommend often reading.
Please select "Advanced" tab on the property screen of the local area connection, and push "Settings" button.
In Windows XP/SP2, the Windows firewall is effectively set by default. It explains the method of connecting DCOM
with DAServer with the firewall made effective since it the next pages.
Configuration
- 58 -
Exceptions
The application to pass the firewall can be specified in "Exceptions" tab. And push "Add Programs" button and add
"SysmacEthernet.exe". Moreover, to browse the installed server list from another node with the OPCENUM function,
add "OpcEnum.exe".
In addition, port "135" of "TCP" used with DCOM pushing "Add Port" button is added.
Configuration
- 59 -
COM Security
Because the COM security is strengthened when Windows XP/SP2 is applied, the change in the DCOM setting is
needed.
"DCOMCNFG.EXE" is started from the command line or "Component Service" is opened from the management tool of
control panel, and "COM security" tab is selected.
The dialog opens when "Edit limits" button of "Access permit" is pushed. "ANONYMOUS LOGON" is selected to access
OPCEnum.exe remotely, and "Remote Access" is set to "Allow".
Configuration
- 60 -
The dialog opens when "Edit limits" button of "Access permit of starting and making actively" is pushed.
"Everyone" is selected, and "Remote Launch" and "Remote Activation" are set to "Allow".
Configuration
- 61 -
5.4 Access from InTouch This section describes how to access DAServer from Wonderware InTouch.
The following dialog opens when you select “Access Name” from the “System” menu of InTouch.
* Enter “SysmacEthernet” as “Application Name.”
* Enter the name set to “Device Groups” from the DAServer manager as “Topic Name”.
* Select “DDE” or “SuiteLink” for the protocol.
When DAServer has not been activated or the topic name does not exist, the following message may be displayed when
you launch InTouch Viewer.
This dailog will be not shown by set "Start local servers" in configuration dailog of InTouch WindowViewer to OFF.
Configuration
- 62 -
5.5 DDE Access from Microsoft EXCEL Enter “=application name|topic name!item name” in the cell in order to access DAServer from an EXCEL sheet. See
below for an example of accessing the topic name “PLC1” data memory “DM0”:
Use the EXCEL macro and DDE POKE command to describe as follows:
Chn = DDEInitiate("SysmacEthernet", "topic name")
DDEPoke Chn, "item name", Data_Reference
DDETerminate (Chn)
Note
- Chn indicates the return value of the INITIATE command.
- Data_Reference uses the ID of the cell written to with POKE.
- Use the TERMINATE command when done to close the channel.
- Delay the TERMINATE command by 10 minutes in order to ensure POKE is executed.
- For other access methods, refer to the sample program included with the product.
Configuration
- 63 -
5.6 DDE Access from Visual Basic 6.0 Paste text box control and label control to a form and configure DDE properties. Set LinkMode to “Automatic” to read
the value to the TEXT property.
Property Name Description Sample Setting
LinkTopic DDE application name + "|” + topic name SysmacEthernet|PLC1
LinkItem DDE item name DM0
LinkMode DDE communication mode (0: none, 1: automatic link,
2: manual link)
1
Sample Code to Read Values from the PLC
Sample Code to Write Values to the PLC
Configuration
- 64 -
5.7 OPC Access from Visual Basic 6.0 Details of OPC access are clearly defined. Main steps are as follows:
1. Get OPC server list
2. Connect to OPC server
3. Generate Group Object (configure update interval)
4. Add tags
5. Read/write values
6. Disconnect
Details of OPC programming will not be covered in this document. For more details, please refer to the sample
program for OPC access that will be set up in “Install Folder¥Sample¥VbSampleOpc” when you install the product.
Important
An application developed using Visual Basic cannot explicitly specify Outprocess. It calls DAServer as
InProcServer. Therefore, you cannot use OPC connection when you connect from multiple OPC clients or use
DDE/SuiteLink connection on InTouch. Please use DDE connection in that case.
SYSMAC Ethernet Unit Configuration
- 65 -
6. SYSMAC Ethernet Unit Configuration This chapter describes the configuration on the PLC side. Refer to the PLC manual for more details.
Important
Before DAServer communicates with SYSMAC Ethernet Unit, configure IP address/Port No., Network No., Node
No. and Unit No. of SYSMAC PLC.
6.1 Hardware Configuration
6.1.1 IP Address
The function of IP Address is to identify nodes on Ethernet. The older types of SYSMAC Ethernet Unit than
CS1W-ETN21 and CJ1W-ETN21 have 8 switches on the back. Configure each digit of IP address within ranges from
00 to FF with the switches. If you use CS1W-ETN21 and CJ1W-ETN21, refer to Software configuration in following
pages.
The following figure shows correspondence of rotary switches to each digit of IP address.
6.1.2 Node No
The function of Node No. is to identify each Ethernet Unit when multiple Ethernet Units are connected in the same
LAN. Configure the Node No. switches on the back within ranges from 01 to FE in hexadecimal (1 ~ 254 in decimal).
Be careful not to overlap with Node No. of other Ethernet Unit in the same LAN.
Note
As to an address translation, when using automatic generation of address, set Node No. to the same value as the last
value of IP address of Ethernet Unit.
If you set Node No. to the different value, you have to use “IP Address Table System” or “Combination System”.
6.1.3 Unit No
The function of Unit No. is to identify the CPU Advanced Unit attached to the CPU Unit. Set the rotary switch “Unit
No.” on the front of the Ethernet Unit within the range from 0 to F. Be careful not to overlap with Unit No. of other
CPU Advanced Unit attached to the same CPU Unit.
SYSMAC Ethernet Unit Configuration
- 66 -
6.2 Software Configuration (CX-Programmer) You need to configure I/O Table and PC Routing Table for Ethernet communication. This section describes how to
configure SYSMAC-CJ1 Series. Refer to the users guide for other types of PLC.
6.2.1 I/O Table (Definition of IP Address and Port No)
1. First, make online connection from CX-Programmer to the PLC. (If I/O Table has not configured yet, connect to the
port of the CPU by serial communication. Or if the I/O Table is configured, connect by Ethernet)
Note
When using CS1W-ETN21 and CJ1W-ETN21, Set the IP address to “192.168.250.Node address” by default.
2. From the project screen double-click on “IO Table” to display the I/O table dialog.
3. From “Option” menu select “Transfer from the PLC” to read the communication Unit of PLC.
SYSMAC Ethernet Unit Configuration
- 67 -
4. Right-click on “Ethernet Unit” in I/O Table, and from the popup menu select “Unit Setup.” Then following dialog is
shown. Configure IP address, subnet mask, Port No. etc. of Ethernet Unit here.
Note
Port No. of both TCP and UDP are set to “9600” by default. Change the Port No. as needed.
5. For accessing on TCP/IP, it is needed to configure "Auto-alocated FINS node" and set Keep-Alive to "Valid."
6. Transfer the Ethernet Unit configuration to the PLC. And reset the Ethernet Unit to enable the new configuration.
SYSMAC Ethernet Unit Configuration
- 68 -
6.2.2 Routing Table (Definition of Network No.)
Routing Table is the table to select the communication path for FINS message when using FINS communication
service. Configure Network No. according to the following directions.
1. Start CX-Programmer, and from “Tool” menu select “Network configuration Tool”. Then “PC Network
Configuration Tool (PC Routing Table)” is shown.
2. To connect to PC, select “NewPLC1” shown as Project Devices in the dialog. And from “PLC” menu select “Open”.
After that, from “Routing Table” menu, select “Setup.” Then “Routing Table” is shown. Right-click on Unit No. of
the interface unit (which is set with the rotary switches on the front) in “SIOU” Tab. And select “Insert CPU
SIOU”. On followingdialog, enter Local Network Number.
3. In this way the operation is complete to register Unit No.4 of Ethernet Unit as Network No. ”1”.
Troubleshooting
- 69 -
7. Troubleshooting This chapter describes troubleshooting of DAServer.
7.1 Version Information Version information of DAServer is output to SMC’s LogViewer at startup. You may also check the version
information as follows:
1. Find SysmacEthernet.dll under Install Folder from Explorer.
2. Right mouse click on the file name and select Properties.
3. Click on the Version tab in the dialog box.
4. DAServer version is displayed.
7.2 Connectivity with PLC The system tag, $SYS$Status, can be used to monitor the status of communications with the PLC. This item is set to 0
when communication with the PLC fails and to 1 when communication is successful.
Note
For DDE/SuiteLink clients, only one $SYS$Status exists per topic. For OPC clients, $SYS$Status can be accessed at
all hierarchy levels. $SYS$Status at the root level of the whole hierarchy tree is always “1.”
Enter the following DDE reference formula in the appropriate place in your client:
=SysmacEthernet|PLC1!$SYS$Status
SysmacEthernet: name of the DAServer application
PLC1: topic name defined by the DAServer manager
$SYS$Status: item name (system tag) that monitors the status of connectivity with the PLC
Note
If it cannot establish connectivity with the PLC, DAServer will retry the operation three times and goes into slow
polling mode. If timeout error occurs, DAServer immediately goes into slow polling mode.
7.3 WindowViewer (InTouch) Communication Status The InTouch WindowViewer supports a built-in topic name called IOStatus (formerly “DDEStatus” with InTouch7.x)
that can be used to monitor the status of I/O communication. For example, IOStatus is set to “0” when this I/O
communication is normal and to “1” when an error occurs.
The status of communications between the PLC and InTouch can be read into Excel by entering the following DDE
reference formula in a cell on a spreadsheet:
=View|DDEStatus!PLC1 or
=View|IOStatus!PLC1
View: InTouch application name
DDEStatus/IOStatus: topic name in which the status of communications between DAServer and InTouch is stored
PLC1: access name defined as the access destination in InTouch
*This is an example of when the access name to topic name “IO Status” is defined as “PLC1” and Item Name (Boolean)
is defined as “PLC1” also.
Troubleshooting
- 70 -
7.4 Attention of TCP/IP communication When communication error, collision or cutting cable happened on TCP/IP, DAServer wait for the reply message for
configured time. After this time, it will be timeour error occured.DAServer will add to wait for number of times. On
communication is failed, DAServer close active connection and try to communicate again. At this time, SYSMAC
should be LISN status. You should configure the 'TCP/IP Keep-Alive.
(Sample configuration of ‘TCP/IP Keep-Alive’)
'TCP/IP Keep-Alive' function checks to be host computer by ACK packet after stopped communication. If not found,
SYSMAC close the active port and wait new connection.
# On above mentioned sample, SYSMAC check the connection for each 1 minute. That is, SYSMAC send ACK packet
after stopped communication by power down or the breaking of a wire and check to exist host computer.
If not, SYSMAC close the port and become to LISN status.
# Default value is configured after 120 minutes after communication stopped. This means that the communication
can not return for 120 minutes.
Troubleshooting
- 71 -
7.5 Error Messages
7.5.1 Application Messages
See below for a list of messages DAServer sends to SMC:
Message Starting SYSMAC Ethernet DAServer Ver1.00.00 Build on Mar. 07, 2004
Description Displays the version information and other information when DAServer starts up.
Message Ethernet Information : Protocol=UDPIP Host=0.0.0.0(0) PLC= 192.168.0.1(5000)
Timeout=3000 Retry=3 Simulated=0
Description Displays the communication parameter information when the PLC is connected.
Message [PORT1]Target Information:CPUType=3 PLC/Net=1 Node=2 Unit=0, PC/Net=1 Node=1 Unit=0
Description Displays the PLC setting when the PLC is connected.
Message [PORT1]Connection Success
Description Connection to the PLC was successful.
Message [PORT1]Connection Close
Description Connection to the PLC has been closed.
Message [PORT1]Connect Error (Winsock=10061)
Description
Connection to the PLC was unsuccessful. PORT indicates the port name, and Winsock indicates
the error code of Windows Sockets.
Message [PORT1]Response Timeout
Description Sent a request message to the PLC but it timed out.
Message Response Error(Code=4031h)
Description
Sent a request message to the PLC but received a response that includes an error code. CODE
indicates the error code returned from the PLC (refer to the manual of the PLC for more details
on error codes).
Message [PORT1]Send Error (Winsock=10054)
Description
Send message failed. PORT indicates the port name, and Winsock indicates the error code of
Windows Sockets.
Troubleshooting
- 72 -
Message [PORT1]Receive Error (Winsock=10054)
Description
Receive message failed. PORT indicates the port name, and Winsock indicates the error code of
Windows Sockets.
Message Board has data at command send time: (Size=1024)
Description
Cleared the receive queue because data remained in the queue at send time. Size indicates the
data size.
Message Over size message received(8193 bytes)
Description Received message is over size. Value between parentheses indicates the size of the message.
Message Invalid access range (TAG=DM0.A500, MAX: 480<500)
Description
Access point is out of the access range. Value between parentheses indicates the maximum
access points < specified points.
Message Invalid tag name(DMX0)
Description Tagname string is invalid. Name between parentheses indicates the tagname.
Message Invalid device number(DM3FF)
Description Device number string is invalid. DeviceName between parentheses indicates the tagname.
Message Invalid block number string(EM:3)
Description Block number string is invalid. Name between parentheses indicates the tagname.
Message Invalid expanded string(DM0.F)
Description Expanded string is invalid. Name between parentheses indicates the tagname.
Message Invalid format(Point=1025, Bit=0, Str=DM0.A1025)
Description
Maximum number of points for access all exceeds 1024. Or specification of bit location is invalid.
Point indicates the access points, Bit indicates the bit location, and Str indicates the tagname.
Troubleshooting
- 73 -
7.5.2 Error Message Causes and Solutions
See below for a list of error messages and their possible causes and solutions.
Message [PORT1]Connect Error (Winsock=10061)
Cause/Solution
During TCP/IP communication, connection is still open on the PLC or port is not specified on the
PLC (not in LISN state). Reset the PLC or configure the appropriate program/parameter.
Message [PORT1]Connect Error (Winsock=10060)
Cause/Solution
Accessed an IP address that does not exist when TCP/IP communication is used. Check the
network devices such as HUB or configure the correct IP address.
Message Response Error(Code=FFFFh)
Cause/Solution Received error replies from the PLC.
Message Response Error (ICF=FFh)
Cause/Solution Received the packet containing invalid ICF(Information Control Field).
Message [PORT1]Receive Error (Winsock=10054)
Cause/Solution
This may occur when the PLC disconnects the connection. For example, this may occur when
the power to PLC is turned off.
Message [PORT1]Response Timeout
Cause/Solution
Generally, this occurs when the cable is disconnected or the power to HUB is turned off. This
also occurs when the PLC has not opened the corresponding port for UDP/IP communication.
Check the network devices or specify an appropriate port number.
Troubleshooting
- 74 -
7.5.3 Frequently Asked Questions
See below for a list of frequently asked questions and corresponding answers.
Question After some TCP/IP communication, I could no longer connect to the PLC unless I reset it.
Response
This error occurs frequently when a cable is unexpectedly disconnected. TCP connection
remains on the PLC. Change the protocol to UDP/IP, or implement the heartbeat function.
Question Does it support DHCP?
Response
It automatically recognizes the DHCP syste when only one adapter is used and the local IP
address is set to “0.0.0.0.”
Question Can you use multiple LAN adapters?
Response
If you allocate static IP addresses, you may enter the IP address for each adapter to recognize
them.
Question I can PING a PLC but cannot communicate with it.
Response
IP address is configured correctly, but the PLC has not set the port to wait open. Please confirm
the Ethernet configuration of the PLC.
Question I would like to back up DAServer. Where is the configuration file?
Response Back up “SysmacEthernet.aaCFG” which is in installed directory.
Question I got a wrong device number error. How can you tell which tag is causing the error?
Response
You can check the list of added tags from SMC’s diagnostics screen. Check the tags that are in
red.
Question Is there a limit to the number of PLCs you can access?
Response
You can define as many as you want, as long as it is within the resource range. However, the
more destinations there are, the slower the communication rate.
Question Can you run DAServer as a Windows service program?
Response
You can configure the service startup from SMC’s DAServer manager. With a service program,
the program is already running even before you log in.
Question How can you tell from the client if DAServer is communicating correctly?
Response
System Tag “$SYS$Status” is set to “1” during the communication and “0” when the
communication stops. You can monitor this tag to see if a communication error has occurred.
Troubleshooting
- 75 -
Question Can you import/export tags?
Response
You can import/export tags from the “Device Item” tab on the PLC Configuration screen of SMC’s
DAService manager.
Question When you access from InTouch by DDE, what will the application name be?
Response
Specify “SysmacEthernet” as an application name.
Prog. ID to connect by OPC will be “Takebishi.SysmacEthernet.1.”
Question I get an error when I connect from multiple OPC clients.
Response
DAServer runs as InProcServer by default when CoCreateInstance is called. When you connect
from multiple clients, it must be executed as OutProcServer. Configure service startup or
activate DAServer before you connect the clients. You can avoid this error by specifying
CLSCTX_LOCAL_SERVER as the third argument.
If you specify CLSCTX_ALL, DAServer will run as InProcServer, so you can only connect from
one client. In this case, you cannot activate DAServer from SMC ahead of time.
Troubleshooting
- 76 -
7.5.4 Winsock Error Codes
See below for a list of Window Sockets error codes. Refer to MSDN for more details.
Code Title Description
10035 WSAEWOULDBLOCK Nonblocking socket. Cannot complete connection.
10036 WSAEINPROGRESS Blocking operation is currently executing.
10038 WSAENOTSOCK Socket operation on nonsocket.
10039 WSAEDESTADDRREQ Destination address required.
10040 WSAEMSGSIZE Message too long.
10048 WSAEADDRINUSE Address already in use.
*This may occur when the local port is not set to “0.”
10049 WSAEADDRNOTAVAIL Cannot assign requested address.
*This may occur when the cable is disconnected.
10050 WSAENETDOWN Network is down. This error may be reported at any time if the Windows
Sockets implementation detects an underlying failure.
10051 WSAENETUNREACH Network is unreachable.
10052 WSAENETRESET Network dropped connection on reset.
10053 WSAECONNABORTED Software caused connection abort.
10054 WSAECONNRESET Connection reset by peer.
*This may occur when the PLC is reset or power is turned off.
10055 WSAENOBUFS No buffer space available.
10056 WSAEISCONN Socket is already connected.
10057 WSAENOTCONN Socket is not connected.
10058 WSAESHUTDOWN Cannot send after socket shutdown.
10060 WSAETIMEDOUT Connection timed out.
*This may occur when the Ethernet line or PLC program is inappropriate.
10061 WSAECONNREFUSED
Connection refused.
*This may occur when the connection remains on the PLC.
*Clear this error by restting the PLC CPU or turning open request signal off.
Troubleshooting
- 77 -
7.6 Diagnostics Functions You may use DAServer’s diagnostics functions to investigate communication problems and display diagnostics
messages. Refer to the DAServer Manager manual for more details on diagnostics.
7.6.1 LOG Flag
DAServer outputs information such as error messages to SMC’s LogViewer. LogViewer logs only the messages that
were specified by the LOG flag. In order to log communication errors and other information, check “DASTrace” of the
LOG flag.
Select “Log Flags” from the “Operation” menu while the LogViewer is displayed in order to configure the LOG flags.
Select “SysmacEthernet” from the tree view and set each flag displayed on the right pane. Other than the flags that
are checked by default, three flags described on the next page can be configured.
Troubleshooting
- 78 -
The following three LOG flags can be configured on DAServer.
LOG Flag Description
DASTrace Logs DAServer’s general information.
DASReceive Logs messages that DAServer received from the PLC.
DASSend Logs messages that DAServer sent to the PLC.
Note
It is recommended that DASTrace be always ON. Turn on DASReceive and DASSend only during errors, for
leaving them on regularly increases the data size.
When you turn on DASReceive/DASSend, the following messages will be dumped.
Troubleshooting
- 79 -
7.6.2 Diagnostics
When DAServer starts up, the following six diagnostics groups are displayed: Client Groups,” “Structure,”
“Transactions,” “Statistics,” “Message,” and “Device Groups.” Use these groups to diagnose registeration information
of DAServer tags and OPC access status, etc.
Troubleshooting
- 80 -
Client Groups
Client Groups diagnoses the client groups accessed from outside. You can monitor the number of items, number of
active tags, number of errors, group status, etc. on this screen.
You can also monitor information on each added tag, such as item name, value, quality flag, and timestamp. Device
with an error (such as device that is out of range) is displayed in red.
Troubleshooting
- 81 -
Structure
DAServer’s name space has several levels. You can check the hierarchy structure on the Structure screen. You can
also monitor the number of registered items, errors, and R/W attributes of each level.
On each level, a list of added tags is displayed. You can monitor the value, timestamp, quality, and number of
messages.
Troubleshooting
- 82 -
Transaction
You can monitor the transaction information on the Transaction screen. In the sample provided below, the
transactions occurred in the order of write request, read request, refresh request, and write request.
You can also see that the first transaction wrote a “1” in “TAG1.”
Troubleshooting
- 83 -
Statistics
DAServer’s general data is displayed on the Statistics screen. There is no subtree. You can check the server status,
DAS engine version, start time, current time, number of client groups, and errors from this screen.
Troubleshooting
- 84 -
Messages
Information on each message is displayed on the Messages screen. In the sample provided below, there are 5 items
registered to the first message, 1 item to the second, and an error occurred on the third message.
Item name, quality information, message ID, location, and other information registered to each message is displayed.
Troubleshooting
- 85 -
Device Groups
You can see the information on each device group, such as the update interval, quality flag, and message ID on the
Device Groups screen.
You can check such information as value, timestamp, quality flag, and message ID on this screen.
Addendum
- 86 -
8. Addendum
8.1 DDE Test Client (Visual Basic) The product includes a sample client program (Visual Basic) for DDE communication. Use it to check the
communication with DAServer or as a sample program.
Operation
1. Define DDE Topic Name on the DAServer manager.
2. Start “Takebishi.SysmacEthernet.1” on the DAServer manager.
3. Select AppName (application name) and TopicName (topic name) and press “Connect.” Select “SysmacEthernet”
for the application name, and enter the topic name defined on the DAServer manager.
4. Enter the tagname (device name) in Item Name and press “Request” to read the value. If you press “Auto Read,” it
reads the value regularly.
5. Enter a value in Data and press “Poke” to write the value to the PLC.
6. Select the device type if you wish to use ASCII and double word, for example, select the device number in Number,
access points in Points, and access type in Type to enable regular read, automatic read, and write.
7. Press “DisConnect” to disconnect from the server.
Addendum
- 87 -
Simultaneous access to multiple DAServers, topics, and items
Press “EXPAND” to display the expanded screen. You can access multiple servers and topics simultaneously on this
screen.
The operation is the same as the previous page.
1. Press “Connect/DisConnect” to connect or disconnect.
2. “Request” to read,” “AutoRead” to enable automatic read.
3. “Poke” to write.
Addendum
- 88 -
8.2 OPC Sample Program (Visual Basic) The product includes a sample client program (Visual Basic) for OPC communication. Use it to check the
communicationwith DAServer or as a sample program.
Operation
1. List of OPC servers that are installed on the PC are displayed. Select “Takebishi. SysmacEthernet.1” and press
“Connect” to display the tree structure on the right pane. Navigate through to the desired level (display of
“DeviceGroupName,” “Port Name” + “PLC Name”) by double-clicking.
2. Enter the tagname you wish to access (in the sample provided above, DM0, DM1…) and press “Add Group.”
3. Press “Auto READ” for automatic read, “Sync READ” for synchronous read, and “ASyncREAD” for asynchronous
read.
4. You can enter a value in Value next to the checked tagname and press “Sync WRITE” for synchronous write and
“Async WRITE” for asynchronous write.
5. Change the update rate of automatic read by entering a different update rate in “Update Rate” and pressing
“Change.”
6. Press “DisConnect” to disconnect from the server.
Addendum
- 89 -
8.3 OPC Test Client The product includes a sample client program for OPC communication. Use it to check the communication with
DAServer from the OPC custom interface. The source code of this client is not provided.
Select Server Screen
Start the OPC test client from “Start Menu” >> “DAServer”. And “Takebishi OPC Client” is displayed.
From “OPC” menu, Click “Connect” on the server and select “Takebishi.SysmacEthernet.1” from the OPC server list.
Add Item Screen
Select “Add Item” to browse the information defined on DAServer. Select a hierarchy structure and add a tag.
Operation
You can monitor the tags on the screen and right mouse click to write and select other operations.
Addendum
- 90 -
8.4 User Support User support service is provided to registered users. Please contact User Support for any questions on DAServer
configuration and operation.
When you contact User Support, please have the following information ready:
- Product name, serial number (listed on the CD/user registration form)
- PLC CPU type, communication unit model
- Client software type (InTouch/ArchestrA), Version/SP
Note
Please note that we may not be able to answer non-DAServer questions, such as hardware and device driver
configuration, sample program (sequence program, Visual Basic, EXCEL) codes and programming.
TAKEBISHI Corporation
User Support
29 Mamedacho Nishikyogoku Ukyoku Kyoto 615-8501, Japan
Phone: +81-75-325-2261 FAX +81-75-325-2273
Business Hours: 9:00 ~ 12:00 / 13:00 ~ 17:00 (Japanese Local Time Zone)
E-mail: [email protected]
Product Information: http://www.faweb.net/
10088-2D Jan.2017
SYSMAC Ethernet DAServer
Users Guide