Citect for Windows, Version 5.xx MICRXNET Driver, User Information

Transcription

1 Citect for Windows, Version 5.xx MICRXNET Driver, User Information

2 Driver version history Version Modified By Details 1.00 Ma Lijun Original Ma Lijun Modification Ma Lijun Add a hint Ma Lijun Change range of WA from 0-45 to 1-45 in Reference:Data Types Ma Lijun Modify Reference: Data Types Ma Lijun Add citect data format FILED Copyright 1999 Ci Technologies Page: 2

3 Contents 1. USER INFORMATION APPLICATION NOTES FOR DEVICE FFU170B AND NC1L-ET Overview Setup guide Hints, Tips, and Frequently asked questions Reference: Required components Reference: Communications forms Reference: Wiring diagrams Reference: Data types DRIVER REFERENCE Description Driver generated error codes Parameters, options, and settings Advanced DRIVER IMPLEMENTATION DEVELOPMENT RESOURCES Documents Software / Hardware...17 Copyright 1999 Ci Technologies Page: 3

4 1. User information This driver aims to support the FUJI Micrex-F series PLCs that could work with FUJI FFU170B or NC1L-ET1 Ethernet communication module. 1.1 Application notes for Device FFU170B and NC1L-ET1 Manufacturer Device name Communications method Detail FUJI ELECTRIC, JAPAN FFU170B, which is FUJI MICREX-F series Ethernet Interface Module and could be used with F120S/F140S/F150S, FDL120A, FTL0101H series PLC NC1L-ET1, which is FUJI MIECREX-F series Ethernet Interface Module and could be used with F70/F70S series PLC TCP/IP, Ethernet(10Base5/10Base2/10BaseT) Overview The FFU170B (or NC1L-ET1) is mounted on the base of the Micrex-F F120S/F140S/F150S/FDL120A/FTL0101H (or F70/F70S for NC1L-ET1), connects the PLC to the Ethernet LAN. The modules use standard TCP/IP protocol to exchange data with other nodes (such as citect PC). Ethernet Card 10Base5/10Base2/10BaseT FFU170B or NC1L-ET1 Ethernet interface module Micrex-F F120S / F140S / F150S / or F70 / F70S Series PLC Setup guide Step 1. Hard switch Settings 1). Setting communication condition On the front panel of the module, there are four switches for communication condition setting. SW Switch Recommend set to SW4 OFF Meaning SW3 OFF Unused 0FF SW2 OFF OFF: normal operating mode ON: loop-back test mode OFF: permit the writing from other node into PLC ON: forbid the writing from other node into PLC Copyright 1999 Ci Technologies Page: 4

5 SW1 ON OFF: when timeout occurs, closes the communication circuit ON: when timeout occurs, does not close communication circuit 2). Setting lowest byte of IP address These switches are on the rear panel of the module. They give the lowest byte of IP address. High 4 bits (0-F) Low 4 bits (0-F) The high 3 bytes of IP address are set in File No.0. Refer to Module initialisation_parameters for more. 3). Select communication media For NC1L-ET1, there is one switch on the front panel for communication media selection. It is used for selecting 10BaseT or 10Base2. 10BASE 2 T For FFU170B, there are two switches on the front panel for communication media selection. The AUI/TPI switch is used for selecting AUI (10Base5, 10Base2) or TPI (10BaseT), AUI setting requires the use of the 10Base5/2 switch. The 10Base5/2 switch is for selecting 10Base5 or 10Base2, it need not be used when the AUI/TPI switch is set to TPI. AUI TPI AUI/TPI switch Base5/2 switch Step 2. Communication parameter register setting In the FFU170B or NC1L-ET1 module, there are several File areas that are used for the parameter setting and data exchange between this module and the CPU. File No.0 is for communication parameter setting and its address range is from 0 to 675. The Copyright 1999 Ci Technologies Page: 5

6 address 0 to 19 is for module parameter setting. The address 20 to 675 is for individual connection parameter setting. These settings are detailed as follows: 1). Setting module initialisation parameters Buffer address Settings Default value 0 (L) The IP address of this module 1 (H) 2 TCP transmission timeout value (unit: 0.1 sec.) Max TCP end time value (unit: 0.1 sec) Response monitor timer value (unit: 0.1 sec) Server FTP command monitor timer value (unit: sec) File No.0 6 Client FTP data connection monitor timer value (unit 0.1 sec) 30 7 (L) Subnet mask 8 (H) 9 (L) Default gateway IP address 10 (H) 11 Unused area 19 (1). The IP address of this module Sets the IP address of this module. The IP address is set with binary value. The lowest byte must be set to 00h since it is set by hardware switches (Refer to Setting lowest byte of IP address). For example, if the IP address is A33BCCFAh ( ), the address 0 and 1 of the File No.0 should be set as follows: Address in File No.0 Value 0 CC00h 1 A33Bh And the hardware switches for the lowest byte should be set to FAh. (2). TCP transmission timeout value Sets the IP packet lifetime. (3). Max TCP end timer value This value sets the wait time that a temporary socket will be maintained after the local station has normally closed a TCP connection. (4). Response monitor timer value This value sets the predetermined time that the module will wait for a response to a transmitted command. (5). Server FTP command monitor timer This timer value sets the predetermined time after which a connection will automatically be shut down when a command is not received from a logged client. Copyright 1999 Ci Technologies Page: 6

7 Set to 0 to keep the connection open even if no command is received from client. This value is not used in this driver. (6). Client FTP data connection monitor timer This timer value sets the time that the module will wait for a server on another node to open a connection during client FTP communications. This value is not used in this driver. (7). Subnet mask This value sets the subnet mask. Set to 0000 when no sub-network is used. (8). Default gateway IP address When a gateway is needed, set this value to the IP address of the gateway with binary value. Set it to 0000 when a gateway is not used. 2). Setting individual connection parameters This module can have max 8 connections with other nodes. Each connection has its own parameter buffer area. Buffer address File No Connection No.1 Connection No.2 Connection No.8 User list for server FTP Every connection has a 50-word parameter buffer, detailed as follows: Relative address Content Default value 0 Communication mode 1 Port number 2 IP address of the destination node 3 4 Port number of the destination node 5 FFFFh Ethernet address of the destination 6 FFFFh node 7 FFFFh User name Password Copyright 1999 Ci Technologies Page: 7

8 Unused (1). Communication mode Bit Meaning Available Values Could be set to in this driver 0 Open method 00: active, 11: fullpassive, 00, 11, : unpassive 2 Unused Dummy byte 0:Yes, 1: No 0, 1 4 Unused Unused Unused Unused Protocol 0: TCP/IP, 1: UDP/IP 0 9 Text code 0: binary, 1: ASCII 0 A Data swap 0: No, 1: Yes 0 B unused 0 0 C Communication 000: fixed/common buffer 010 mode 001: general D E 010: command setting 100: server FTP/TFTP file transfer 101: client FTP/TFTP file transfer F Unused 0 0 Note: The bit 0 is the most significant bit in a word and the bit F is the least significant one. The value at value field is high bit first. It is recommended to set this word to 8004h. (2). Port number Setting the port number of this module. The range is from 0100h to FFFFh. (3). IP address of the destination node Setting the IP address of the destination node. (4). Port number of the destination node. Setting the port number of the destination node. (5). Ethernet address of the destination node Setting the Ethernet address of the destination node. If the destination node has ARP function, set it to FFFFFFFFFFFFH. (6). User name Not used in this driver. (7). Password Not used in this driver. Step 3. Creating PLC program Copyright 1999 Ci Technologies Page: 8

9 A tiny PLC program is needed to start the communication at PLC side. This program should include at least 3 parts: 1). Transfer parameters from CPU to the FFU170B or NC1L-ET1 module The parameter could be transferred from registers in CPU to File No.0 in FFU170B or NC1L-ET1 module with a MSGT instruction. 2). Initialise the FFU170B or NC1L-ET1 module. This could be done by setting the B70 to ON. If the initialisation has been finished successfully, the relay B30 will become ON, else the relay B31 will be ON. (This assumes that the FFU170B or NC1L-ET1 is installed in slot 1). 3). Open connection. This could be done by setting the corresponding open request relay (B58 to B5F, individually for connection 1 to 8) to ON. If connection is open successfully, the corresponding open completed relay (B18 to B1F) will become ON. (This assumes that the FFU170B or NC1L-ET1 is installed in slot 1) The following is a simple example. Parameters for Citect computer side is as: Protocol: TCP Port number: 2001 IP address: Parameters for module initialisation in PLC side is as: Buffer Settings address 0 The IP address of this module 1 File No.0 Value 2 TCP transmission timeout value Max TCP end time value Response monitor timer value Server FTP command monitor timer value Client FTP data connection monitor timer value Subnet mask Parameters for connection 1 in PLC side is as: Buffer Content Value Address 20 Communication mode 8004h 21 Port number 2000 File No.0 IP address of the destination node Port number of the destination node 2001 The code is as follows: page [ h 0000 LMOV WM0000 ] [ h C0A8 LMOV WM0001 ] [ d LMOV WM0002 ] Copyright 1999 Ci Technologies Page: 9

10 [ d LMOV WM0003 ] [ d LMOV WM0004 ] [ d LMOV WM0005 ] [ d LMOV WM0006 ] [ h FF00 LMOV WM0007 ] [ h FFFF LMOV WM0008 ] [ h 8004 LMOV WM0100 ] [ h 07D0 LMOV WM0101 ] [ h 000F LMOV WM0102 ] [ h C0A8 LMOV WM0103 ] [ h 07D1 LMOV WM0104 ] [ d LMOV WM0201 ] F0050 M201F ( S ) M201F [ MSGT 001 : 0000 : d : WM0200 ] [ DATA d ] [ DATA d ] [ DATA d ] [ DATA d ] [ DATA d ] M201F M201D ( S ) M201F ( R ) M201D M2002 M201D ( R ) M ( R ) M201E ( S ) M201E [ MSGT 001 : 0000 : d : WM0200 ] [ DATA d ] [ DATA d ] [ DATA d ] [ DATA d ] [ DATA d ] M201E M201C ( S ) M201E ( R ) M201C M2002 M201C ( R ) M ( R ) B ( S ) Copyright 1999 Ci Technologies Page: 10

11 B0030 B ( S ) B0018 W ( S ) M2015 B0018 T / [ TON ]--- B ( R ) T0005 B0058 B / ( S ) M ( R ) Hints, Tips, and Frequently asked questions When using TCP protocol with this driver, a slow response speed (more than 500ms for each request) may be suffered, though the PLC response speed is virtually about 60 to 90 ms. This is because of the TCP implementation in windows and in PLC. In the PLC response packet, the PUSH bit of TCP flag word is always set to 0, that will lead windows holds onto the application's recv() for about 500ms. So in the driver s view, the response speed will be more than 500 ms. To avoid that, a parameter could be set in windows registry. The path of the parameter is: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Afd\Parameters\Ign orepushbitonreceives This parameter should have a DWORD type. Create this field and set the value to 1. This parameter applies to Windows NT/2000, for Windows95/98, it is recommended to use UDP protocol. When two computers need to communicate with one PLC (such as when primary & standby servers have been defined in Citect), two connections with different TCP/IP port number must be defined in the PLC side Reference: Required components A standard Ethernet card and TCP/IP protocol, with IP address and sub-net mask set properly, should be installed in the computer before using this driver Reference: Communications forms Boards form Field Default Allowable values Board Name This field is user defined, and is not used by the driver. Board Type TCPIP Address 0 I/O Port BLANK Interrupt BLANK Special Opt BLANK Comment This field is user defined and is not used by the driver. Ports form Field Default Allowable values Copyright 1999 Ci Technologies Page: 11

12 Port Name This field is user defined and is not used by the driver. Port number BLANK Board name Refers to the board previously defined in boards form. Baud rate BLANK Data bits BLANK Stop bits BLANK Parity BLANK Special Opt Ia Pn T Comment This field is user defined and is not used by the driver. Note: In the Speicial Opt field: a is the destination IP address in standard internet dot format. (For example ) n the destination port number for the FFU170B or NC1L-ET1. (This is a decimal value, for example 2000) -T this is optional, force the driver to use TCP (the default), rather than UDP (-U) I/O Devices form Field Default Allowable values Name This field is user defined, and is not used by the driver. Number Must be unique, but is not used by the driver. Address BLANK Protocol MICRXNET Port name Refers to the port previously defined in ports form. Comment This field is user defined and is not used by the driver Reference: Wiring diagrams Standard Ethernet wiring method Reference: Data types IO Device Type Citect data format Citect data types In/Out relay WBa.c INT, BCD, LONG, Auxiliary relay WMa.c INT, BCD, LONG, Keep relay WKa.c INT, BCD, LONG, Special relay WFa.c INT, BCD, LONG, Annunciate relay WAa.c INT, BCD, LONG, Differential relay WDa.c INT, BCD, LONG, Description/Special Usage/Limitations/ Valid Ranges a: c:0-f a: c:0-f a: 0-63 c:0-f a: c:0-f a: 1-45 c:0-f a: 0-63 c:0-f Copyright 1999 Ci Technologies Page: 12

13 Step controller WSa BYTE a: sec timer W9Db LONG, b: current value Timer preset value TSb LONG, b: Timer current value TRb LONG, b: Counter preset CSb value LONG, b: Counter preset CRb value LONG, b: Data memory BDb.d LONG, LONG BCD b: d: 0-1F P-Link 1 st block P-Link 2 nd block P-Link 3 rd block P-Link 4 th block memory, memory, memory, memory, W20Da.c INT, BCD, LONG, W21Da.c INT, BCD, LONG, W22Da.c INT, BCD, LONG, W23Da.c INT, BCD, LONG, Direct IO W24Da.c INT, BCD, LONG, a: c: 0-F a: c: 0-F a: c: 0-F a: c: 0-F a: c:0-f Analog area W25Db.d LONG, b: d:0-1f Differential relay preceding value P-Link 1 st block P-Link 2 nd block P-Link 3 rd block P-Link 4 th block memory, memory, memory, memory, W26Da.c INT, BCD, LONG, W120Da.c INT, BCD, LONG, W121Da.c INT, BCD, LONG, W122Da.c INT, BCD, LONG, W123Da.c INT, BCD, LONG, a: 0-63 c:0-f a: c: 0-F a: c: 0-F a: c: 0-F a: c: 0-F Calender area W125Da.c INT, BCD a:0-5 c: 0-F Calender CAL.e BYTE e: YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, DOW File area FILEf/g INT, BCD, LONG, f: g: File area FILEDf/g LONG, f: g: Where: a b c Register address in word Register address in long word Bit address in a word Copyright 1999 Ci Technologies Page: 13

14 d e f g Bit address in a long word Calender field File number Word offset in a file Notes: Calender data type CAL is read only. All the other types are read & write. In citect, the bit number in a word of WB is opposite to the channel number that labelled on FUJI PLC DI/DO module, they have relations as the following table shows: Citect bit number F E D C B A DI/DO channel number A B C D E F Since NC1L-ET1 (FFU170B) uses part of WB area as handshake signals between CPU and itself, writing to the WB area covered by NC1L-ET1 (FFU170B), especially which direction is form CPU to NC1L-ET1 (FFU170B), may lead an irrecoverable communication interrupt. User MUST confirm that writing to WB will not stop the communication before doing it. Some area of WA (such as WA0, WA1, WA2, WA3) are used by CPU to indicate fatal or no-fatal errors, writing to those area may lead a stop of CPU s running. User MUST confirm that writing to WA will not stop the running of CPU before doing it. FILEf/g should be used when PLC File is defined as SI type (16 bit), while FILEDf/g is used when PLC File is defined as DI type or BD type (32 bit). Examples: Data Type Address Comment Data Type Address Comment DIGITAL WB9.D Channel 2 of DO module INTEGER WM188 Pulse counter Data Type INTEGER Address FILE30/12 Comment Water level of tank 1 Data Type Address Comment LONG BD100 Water flow set point Copyright 1999 Ci Technologies Page: 14

15 1.2 Driver reference Driver name Maximum array size 1 Detail MICRXNET 1696 bits Description This driver is used to communicate to F120S/F140S/F150S/F70/F70S series PLC, via FUJI MICREX-F series ethernet interface module FFU170B or NC1L-ET Driver generated error codes Driver Error Mapped to Meaning of Error Code Code (Generic Error label) (Hexadecimal) 0x112 GENERIC_WRITE_PROTECT Data is written in the program area. 0x120 GENERIC_INVALID_DATA_FORMAT Non existing command code. 0x121 GENERIC_INVALID_DATA_FORMAT Data is not arranged according to CMND. 0x122 GENERIC_GENERAL_ERROR Operable from loader, but not from personal computer for read/write. 0x124 GENERIC_INVALID_DATA_FORAMT Setting or non-existing module 0x132 GENERIC_ADDRESS_RANGE_ERROR Address exceeds module size Parameters, options, and settings Standard Parameters Parameter Default Allowable values Block (bytes) to 212 Delay (ms) 0 0 to 300 MaxPending 2 1 to 32 Polltime (ms) 0 0 to 300 Timeout (ms) to Retry 1 0 to 8 WatchTime (Sec) 30 0 to 128 Driver Specific Parameters Parameter Default Allowable values TimeOutCheckConst 5 2 to 10 MaxOutStanding 1 1 LocalIP BLANK Any valid IP address value LocalPort BLANK 256 to Equivalent to Maximum Request Length Copyright 1999 Ci Technologies Page: 15

16 Note: the parameter LocalIP and LocalPort is required only when the open method of the communication mode for a connection is set to 11 (fullpassive) (refer to Communication Mode) Advanced Driver generated statistics Number Label Description 0 No. REQ Number of requests 1 No. RES Number of responses 2 No. NAK RES Number of non acknowledge responses 3 No. INTR Number of receive interrupts Debug messages explained The debug messages are from the standard driver TraceTx and TraceRx functions. The message data will be displayed as it is. Read Command & Response Tue Apr 04 16:39: :06: Transmit Length D Tue Apr 04 16:39: :06: Received Length D D A8 C FF FF FF D0 07 0F 00 A8 C0 D Write Command & Response Tue Apr 04 16:44: :11: Transmit Length E Tue Apr 04 16:44: :11: Received Length E Bit Write Command & Response Tue Apr 04 16:46: :13: Transmit Length Tue Apr 04 16:46: :13: Received Length Tue Apr 04 16:46: :13: Transmit Length Tue Apr 04 16:46: :13: Received Length Copyright 1999 Ci Technologies Page: 16

17 2. Driver implementation 2.1 Development resources Documents MICREX-F user s manual Ehternet interface module Type FFU170B FEH097 MICREX-F user s manual Ehternet interface module Type NC1L-ET1 FFU170B FH097a (Japanese version) MICREX-F user s manual instructions FEH Software / Hardware 1. Micrex-F Loader Ver3.00 (type:flt-fdiat3e), which is a programming software for Micrex-F series PLC 2. Mircex-F FLT-ASFK Adapter (include FLC012A cable), which is used together with Micrex-F Loader software. 3. F120S (or F70S) PLC with FFU170B (or NC1L-ET1) installed. Copyright 1999 Ci Technologies Page: 17