Fuji FRENICmega Ethernet Manual
Fuji FRENICmega Ethernet Manual
Fuji FRENICmega Ethernet Manual
OPC-G1-ETH
Multiprotocol Ethernet Interface
August 5, 2011
Part #10821 © 2011 Fuji Electric
OPC-G1-ETH Multiprotocol Ethernet Interface Instruction Manual
Fuji Electric reserves the right to make changes and improvements to its products without providing
notice.
Notice to Users
No complex software or hardware system is perfect. Bugs may always be present in a system of any
size. In order to prevent danger to life or property, it is the responsibility of the system designer to
incorporate redundant protective mechanisms appropriate to the risk involved.
1
Preface
Thank you for purchasing the OPC-G1-ETH Multiprotocol Ethernet Interface. This instruction manual
has been prepared to help you connect your FRENIC-Mega inverter to a variety of Ethernet control
networks.
This instruction manual does not contain inverter usage instructions. Please refer to this instruction
manual in conjunction with the FRENIC-Mega Instruction Manual (INR-SI47-1457-E) in order to become
familiar with the proper handling, installation and operation of this product. Improper handling or
installation procedures may result in incorrect operation or premature product failure.
Related Publications
Listed below are publications that are recommended for reference in conjunction with this instruction
manual.
• RS-485 Communication User's Manual ........... (MEH448)
• FRENIC-Mega Instruction Manual ................... (INR-SI47-1457-E)
These documents are subject to change without notice. Please be sure to refer to the most recent
available versions.
Safety precautions
Please read this instruction manual thoroughly prior to proceeding with installation, connections,
operation, or maintenance and inspection. Additionally, ensure that all aspects of the system are fully
understood, and familiarize yourself with all safety information and precautions before operating the
inverter.
Safety precautions in this instruction manual are classified into the following two categories:
Failure to heed the information contained under the CAUTION title can also result in serious
consequences. These safety precautions are of utmost importance and must be observed at all times.
2
Installation and wiring
• To avoid electrical shock, remove all power from the inverter and wait at least five minutes prior to
starting installation. Additionally, confirm that the DC link bus voltage as measured between the P
(+) and N (-) terminals is less than 25 VDC.
• Installation should be performed only by qualified personnel.
• To avoid electrical shock, do not operate the inverter with the front cover or wiring cover removed,
as accidental contact with exposed high-voltage terminals and internal components may occur.
• To prevent explosions or similar damage, ensure that all cables are properly connected to the
correct terminals, and observe all wiring polarity indicators.
Operation
• To avoid electrical shock, do not open the front cover of the inverter while power is on or while the
inverter is running.
• To avoid electrical shock, do not operate switches with wet hands.
• If the inverter’s function codes are incorrectly configured, or configured without adequate
understanding of the FRENIC-Mega Instruction Manual (INR-SI47-1457-E) and FRENIC-Mega
User's Manual (MEH642), the motor may rotate with a torque or at a speed not permitted for the
machine. Confirm the settings of all function codes prior to running the inverter.
3
Maintenance, inspection, and parts replacement
• To avoid electrical shock, remove all power from the inverter and wait at least five minutes prior to
starting inspection. Additionally, confirm that the DC link bus voltage as measured between the P
(+) and N (-) terminals is less than 25 VDC.
• Maintenance, inspection, and parts replacement should be performed only by qualified personnel.
• Remove all watches, rings and other metallic objects prior to starting work.
• To avoid electrical shock or other injuries, always use insulated tools.
Disposal
• Contact the local or state environmental agency in your area for details on the disposal of
electrical components and packaging.
Other
• Do not attempt to modify the equipment: doing so may cause electrical shock or injuries.
• For clarity purposes, illustrations in this manual may be drawn with covers or safety guards
removed. Ensure all covers and safety guards are properly installed prior to starting operation.
• Do not perform hi-pot tests on the equipment.
• Performing a data initialization (function code H03) may reset all inverter function codes to their
factory default settings. After performing this operation, remember to reenter any custom function
code values prior to starting operation.
Icons
The following icons are used throughout this manual:
Indicates information which, if not heeded, can result in the product not operating to full
efficiency, as well as information concerning incorrect operations and settings which may
result in accidents.
Indicates information that can prove handy when performing certain settings or operations.
4
− TABLE OF CONTENTS −
1 PRE-OPERATION INSTRUCTIONS............................................................. 8
1.1 Product Overview .................................................................................................... 8
1.2 Unpacking and Product Confirmation .................................................................. 9
1.2.1 Shipment Confirmation....................................................................................................... 9
1.2.2 Component Overview....................................................................................................... 10
1.3 LED Indicators ....................................................................................................... 12
1.3.1 Network Status LED ......................................................................................................... 12
1.3.2 Module Status LED .......................................................................................................... 12
1.3.3 Ethernet Link/Activity LEDs .............................................................................................. 12
1.3.4 Ethernet Speed LEDs ...................................................................................................... 12
1.4 Environmental Specifications .............................................................................. 12
2 INSTALLATION .......................................................................................... 13
2.1 Pre-Installation Instructions ................................................................................. 13
2.2 Installation Procedure .......................................................................................... 13
5
5.5.3 Timeout Configuration ...................................................................................................... 32
5.5.4 Submitting Changes ......................................................................................................... 33
5.5.5 Reinitialize Prompt ........................................................................................................... 33
5.6 EtherNet/IP Tab ..................................................................................................... 34
5.6.1 Information Window ......................................................................................................... 34
5.6.2 Device Identification ......................................................................................................... 34
5.6.3 Run/Idle Flag Behavior..................................................................................................... 35
5.6.4 Class 1 (I/O) Data Configuration Arrays ........................................................................... 35
5.6.5 Submitting Changes ......................................................................................................... 36
5.6.6 Reinitialize Prompt ........................................................................................................... 36
5.7 Modbus Tab ........................................................................................................... 37
5.7.1 Information Window ......................................................................................................... 37
5.7.2 Supervisory Timer Selection ............................................................................................ 37
5.7.3 Register Remap Configuration ......................................................................................... 38
5.7.4 Submitting Changes ......................................................................................................... 39
5.7.5 Reinitialize Prompt ........................................................................................................... 39
5.8 Alarm Tab ............................................................................................................... 40
5.8.1 Information Window ......................................................................................................... 40
5.8.2 Email Configuration .......................................................................................................... 41
5.8.3 Alarm Configuration ......................................................................................................... 42
5.8.4 Submitting Changes ......................................................................................................... 43
5.9 Dashboard Tab ...................................................................................................... 44
5.9.1 Information Window ......................................................................................................... 44
5.9.2 Virtual Keypad.................................................................................................................. 45
5.9.3 Gauge Window Navigation ............................................................................................... 46
5.9.4 Gauge Window Configuration .......................................................................................... 46
5.9.5 Submitting Changes ......................................................................................................... 49
5.10 Customizing the Embedded Web Server ............................................................ 50
5.10.1 Customization Overview .................................................................................................. 50
5.10.2 XTPro Overview ............................................................................................................... 50
5.10.3 XTPro Web Browser-Based Implementation .................................................................... 51
5.10.4 XTPro HMI-Based Implementation ................................................................................... 52
5.10.5 XTPro Supported Commands .......................................................................................... 52
6
8.2.4 ControlLogix Example: I/O Messaging ............................................................................. 66
8.2.5 ControlLogix Example: Generic Default I/O Add-On Instruction ....................................... 69
8.2.6 ControlLogix Example: AC/DC Drive Profile Add-On Instruction ...................................... 71
8.2.7 Explicit Messaging Tag Reference ................................................................................... 73
8.2.8 ControlLogix Explicit Messaging Example: Read a Function Code Block ......................... 74
8.2.9 ControlLogix Explicit Messaging Example: Read a Single Function Code ....................... 79
8.2.10 ControlLogix Explicit Messaging Example: Multiple MSG Instructions ............................. 79
8.2.11 ControlLogix Explicit Messaging Example: Reading and Writing...................................... 80
8.3 Allen Bradley CSP ................................................................................................. 81
8.3.1 Overview .......................................................................................................................... 81
8.3.2 Tag Reference ................................................................................................................. 81
8.3.3 SLC-5/05 Example: Read a Register Block ...................................................................... 83
8.3.4 SLC-5/05 Example: Read a Single Register..................................................................... 86
8.3.5 SLC-5/05 Example: Multiple MSG Instructions................................................................. 87
8.3.6 SLC-5/05 Example: Reading and Writing ......................................................................... 88
8.4 BACnet/IP ............................................................................................................... 89
8.4.1 Protocol Implementation Conformance Statement ........................................................... 89
8.4.2 Supported Objects ........................................................................................................... 92
8.4.3 Supported Object Details ................................................................................................. 94
9 TROUBLESHOOTING ................................................................................ 95
7
1 PRE-OPERATION INSTRUCTIONS
1.1 Product Overview
The OPC-G1-ETH Ethernet multiprotocol communication interface allows information to be transferred
seamlessly between a FRENIC-Mega inverter and several different Ethernet-based fieldbus networks
with minimal configuration requirements. The interface installs directly onto the inverter, and presents
two RJ-45 jacks with an embedded 10/100BaseT Ethernet switch for connection to the Ethernet
network. In addition to the supported fieldbus protocols, the interface also hosts a fully-customizable
embedded web server, which provides access to inverter information via a standard web browser for
remote monitoring, configuration and control.
Before using the interface, please familiarize yourself with the product and be sure to thoroughly read
the instructions and precautions contained in this manual. In addition, please make sure that this
instruction manual is delivered to the end user of the interface, and keep this instruction manual in a safe
place for future reference or unit inspection.
Note that different interface firmware versions may provide varying levels of support for the various
protocols. When using this manual, therefore, always keep in mind the release date of the firmware
version running on your interface as it must match this manual’s respective release date in order for all
documented aspects to apply.
Supported Protocols
The interface currently provides server support for the following fieldbus protocols:
• Modbus/TCP Server
• EtherNet/IP Server
• Allen Bradley CSP Server (also known as “PCCC” and “AB Ethernet”)
• BACnet/IP Server
Ethernet Ports
IEEE 802.3 10/100BaseT Ethernet compliant. Shielded RJ45 connectors accept standard CAT5-type 8-
conductor unshielded twisted-pair (UTP) patch cables. MDI/MDI-X auto-crossover allows the use of any
combination of straight-through and cross-over Ethernet cables. Supports multiple simultaneous
protocols.
USB Port
USB 2.0 port with mini-B connector provides composite USB device functionality. USB connection
allows for product identification and firmware updating. Additionally, the OPC-G1-ETH enumerates as a
standard USB mass storage device (“flash drive”) for configuration file copying and web page
customization.
8
Network Timeout Action
A configurable network timeout action can be programmed that allows inverter function codes to have
their own unique "fail-safe" conditions in the event of a network interruption. Refer to section 5.5.3.
Field-Upgradeable
As new firmware becomes available, the interface can be upgraded in the field by the end-user via USB.
Refer to section 7.3 for more information.
9
1.2.2 Component Overview
Figure 3 and Figure 4 provide an overview of the important interface card components.
MAC Address
Positioning notch
USB port
10
Port 1 and Port 2 Ethernet Jacks
Either jack can freely be used star topology networks (with external swich). In linear topologies, a series
of OPC-G1-ETH cards can be connected together by daisy-chaining one of the ports to the next inverter
in line.
MAC Address
Barcode sticker that indicates the card’s unique Ethernet MAC Address. The MAC Address can be used
to identify specific cards discovered with the Fuji Finder application (refer to section 4.3).
Positioning Notch
Aligns with the positioning key on the inverter chassis to ensure that the interface card is installed into
the correct communication port (refer to section 2.2).
USB Port
USB 2.0 port with mini-B connector. Used to access the card via the Fuji Finder program (refer to
section 4.5) and as a USB flash drive (refer to section 7.1).
11
1.3 LED Indicators
1.3.1 Network Status LED
• Conforms to the prescribed “network status LED” behavior as dictated in the EtherNet/IP
specification, Volume 2, Chapter 9.
Item Specification
Indoors, less than 1000m above sea level, do not expose to direct
Operating Environment
sunlight or corrosive / explosive gasses
12
2 INSTALLATION
2.1 Pre-Installation Instructions
• To avoid electrical shock, remove all power from the inverter and wait at least five minutes prior to
starting installation. Additionally, confirm that the DC link bus voltage as measured between the P
(+) and N (-) terminals is less than 25 VDC.
• Installation should be performed only by qualified personnel.
• To avoid electrical shock, do not operate the inverter with the front cover or wiring cover removed,
as accidental contact with exposed high-voltage terminals and internal components may occur.
• To prevent explosions or similar damage, ensure that all cables are properly connected to the
correct terminals, and observe all wiring polarity indicators.
Before installing the interface card, perform all wiring for the main circuit terminals and
control circuit terminals.
1. Remove the front cover from the inverter to expose the control printed circuit board (control PCB).
As shown in Figure 5, there are three option connection ports (A-port, B-port and C-port). The
OPC-G1-ETH card is mechanically keyed for, and can only be installed into, the A-port (bottom-
most) position.
To remove the front cover, refer to the FRENIC-MEGA Instruction Manual, Chapter 2, Section
2.3. The keypad enclosure must also be opened on 30kW and larger inverters.
13
2. Rest the left-hand side of the interface card on the control PCB’s A-port mounting support. Align
the positioning notch on the interface card with the A-port positioning key, and then slide the
interface card to the left to engage the key into the notch. Refer to step c in Figure 6.
3. Rotate the right-hand side of the interface card downward to engage connector CN1 (on the back
of the interface card) into the A-port connector (CN4) on the inverter’s control PCB. Ensure that
the connectors are fully engaged. Refer to step d in Figure 6.
To ensure that the interface card is fully aligned and seated into the communication
port, be sure to perform steps c and d in the proper order. Failure to do so may
lead to insufficient connector insertion and result in contact failure.
Positioning Key
4. Install the two M3 x 6mm screws included with the kit into the standoff mounting holes located at
the upper-left and lower-right hand corners of the interface card. Tighten the screws to secure the
interface card to the control board PCB. Refer to Figure 7.
5. Connect the network cables as necessary. Insert the Ethernet cables into the Ethernet jacks,
making sure that they are fully seated. Ensure that the cables are routed in such a way that they
will not be pinched and are not located near any power-carrying wiring, such as the inverter’s input
power or motor wires.
6. Reinstall all covers removed in step 1. Take a moment to confirm that the Ethernet cables are not
being pinched and are not routed near any power-carrying wiring.
14
3 INVERTER FUNCTION CODE SETTINGS
Depending on the desired operation of the overall application, the inverter function codes listed in Table
2 are important for proper operation of the end-to-end communication system. Although there may be
many other function codes that will require configuration for your specific application, it is important to
understand the manner in which the following function codes will impact successful control of the
inverter.
For further details regarding these function codes, please refer to the FRENIC-Mega
Instruction Manual (INR-SI47-1457-E), Chapter 5 "FUNCTION CODES", FRENIC-Mega
User’s Manual, “y codes: Link Functions”, and RS-485 Communication User's Manual
(MEH448), Chapter 5, Section 5.2 "Data Formats."
Setting Default
Code Name
Range Value
When the inverter is controlled from the network, a selection of reference commands (S?? function
codes) are available for controlling the inverter’s speed. If multiple reference commands are being
modified from the network, then the interface card invokes a hierarchy to determine which reference is to
be passed to the inverter as its main reference command.
The S?? function code hierarchy is as follows, listed from highest to lowest priority:
• S01 (frequency reference / per-unit)
• S05 (frequency reference / Hz)
• S19 (speed command)
• S02 (torque command)
• S03 (torque current command)
• S13 (PID command)
The highest-priority S?? function code with a non-zero value will be used as the inverter’s main
reference command.
15
3.2 Inverter Reaction to Network Timeout Conditions
Function codes o27 and o28 specify the inverter’s reaction when a network timeout occurs. Table 3 lists
the settings for o27 and o28.
Table 3: Inverter Reaction to Network Timeout Conditions (Function Codes o27 and o28)
o27 Value o28 Value Inverter reaction when a timeout occurs Remarks
0,
--- Immediately coast to a stop and trip er5.
4 to 9
After the time specified by o28, coast to a stop
1 0.0s to 60.0s
and trip er5.
If the communications link is restored within the
time specified by o28, ignore the
2 0.0s to 60.0s
communications error. After the timeout, coast
to a stop and trip er5.
3, Maintain present operation, ignoring the
---
13 to 15 communications error (no er5 trip).
Inverter function code
Immediately decelerate to a stop. Trip er5
10 --- F08 specifies the
after stopping.
deceleration time.
After the time specified by o28, decelerate to a
11 0.0s to 60.0s Same as above.
stop. Trip er5 after stopping.
If the communications link is restored within the
time specified by o28, ignore the
12 0.0s to 60.0s Same as above.
communications error. After the timeout,
decelerate to a stop and trip er5.
Immediately turns the run command OFF (no
13 ---
er5 trip).
Issues a command to run the motor in a Forward rotation must
14 ---
forward direction (no er5 trip). be enabled.
Issues a command to run the motor in a Reverse rotation must
15 ---
reverse direction (no er5 trip). be enabled.
16
4 FUJI FINDER APPLICATION
The Fuji Finder application is a Microsoft Windows® -based PC program which provides several
configuration and maintenance utilities for the OPC-G1-ETH, such as Ethernet-based IP address
configuration and USB-based firmware updating. The Fuji finder installation files are located on the CD-
ROM included with the OPC-G1-ETH kit.
4.1 Installation
The Fuji Finder setup will install all required files and USB device drivers. Note that the Fuji Finder
program should be installed before connecting any OPC-G1-ETH devices to the computer’s USB
port, as the program contains product-specific USB drivers that must be installed on the
computer prior to initial connection of the target device.
17
Select the install folder
Select the folder where you want the Fuji Finder to be installed (Figure 9).
18
Wait while the configuration utility is being installed (Figure 11)
If you are prompted by the operating system during this stage that it can’t verify the publisher of this
driver software, choose “Install this driver software anyway”.
Installation complete
19
4.2 USB Driver Installation
By using a USB mini-B cable, an OPC-G1-ETH card can be connected to the PC, powered, and
updated. This section explains setting up the PC to work with an OPC-G1-ETH.
After the Fuji Finder application is installed, the PC will be able to automatically install the appropriate
USB driver when an OPC-G1-ETH card is connected via USB. Note that the Fuji Finder application
must be installed prior to connecting an OPC-G1-ETH card to the PC: the PC will not be able to
automatically install the USB driver until the Fuji Finder installation is complete.
The following sections will provide an overview of the USB driver installation procedure for Windows XP
and Windows 7. Other versions of Windows may have slightly different procedures.
4.2.1 Windows XP
If this is the first time connecting the card to your computer, the operating system will prompt you to
install the card’s USB driver.
Select “No, not this time“ when prompted for Windows to connect to Windows Update (Figure 13).
20
Select Recommended Install
Accept the default action (Figure 14).
The Wizard Will Search for the Appropriate Driver (Figure 15)
21
Device Installation Complete
The device driver has been successfully installed (Figure 16). Click Finish to close the wizard.
Because the OPC-G1-ETH interface card is a USB composite device (which is to say that it presents
multiple virtual representations to the computer), after the vendor-specific USB driver has been installed
as detailed above, Windows will then additionally identify the device as a USB mass storage device
(also known as a “flash drive” or “removable disk”), and automatically install the default Windows USB
mass storage device drivers. Once this is completed, the operating system may automatically pop up a
Windows Explorer window showing the file contents of the OPC-G1-ETH’s on-board filesystem (Figure
17). This window can be closed at this time if desired.
22
4.2.2 Windows 7
Enhancements in Windows 7 automate the installation of USB drivers to such a degree that no user
interaction should be required. When the OPC-G1-ETH card is initially connected to the computer, the
operating system should automatically locate and install the appropriate USB driver. Once completed,
the operating system may display a dialog box similar to that shown in Figure 18.
Because the OPC-G1-ETH interface card is a USB composite device (which is to say that it presents
multiple virtual representations to the computer), after the vendor-specific USB driver has been installed
as detailed above, Windows will then additionally identify the device as a USB mass storage device
(also known as a “flash drive” or “removable disk”), and automatically install the default Windows USB
mass storage device drivers. Once this is completed, the operating system may automatically pop up an
AutoPlay window showing the options available for the removable disk (Figure 19). This window can be
closed at this time if desired.
23
4.3 Overview
The “Fuji Finder” application is a simple Windows PC program, which when executed discovers all OPC-
G1-ETH cards on the current Ethernet subnet, regardless of whether or not their network parameters are
currently compatible with the subnet upon which they reside. The utility is also used to update firmware.
These functions are accessed via two tabs available on the Finder application main program window
(refer to Figure 20 and Figure 21.)
24
4.4 Ethernet Tab
All devices discovered on the current Ethernet subnet can be organized in ascending or descending
order by clicking on the desired sort header (Product, IP Address, MAC Address or Application
Firmware). The buttons on the left side of the window perform the following actions:
Update IP Settings: Allows configuration of the static IP parameters. Refer to section 4.6 for more
information.
Open Web: Opens a web browser page of the selected device. Refer to section 5.
Reboot Device: Reboots the currently-selected interface card. The Finder application will then
automatically rescan the network.
Note that in order for the Finder application to discover devices on the Ethernet subnet, certain UDP
traffic must be allowed in and out of the computer, and firewall applications (such as Windows Firewall)
are often configured to block such traffic by default. If the Finder is unable to discover any devices on the
current subnet, be sure to check the computer’s firewall settings during troubleshooting, and add an
exception to the firewall configuration if necessary. The Finder application uses UDP port 4334.
View Files: Provides access to the on-board file system with Windows Explorer. Refer to section 7.1.
Reboot Device: Reboots the interface card. The Finder will automatically detect the card once it has
completed rebooting.
1. Connect the interface card to the same Ethernet subnet on which the computer resides and apply
power to the inverter in which it is installed.
5. Configure the IP Address Settings with the desired IP Address, Subnet Mask and Default
Gateway in the appropriate boxes. Click the Update IP Settings button to apply the changes.
6. A popup dialog box will prompt you to reboot. Click Yes. The dialog box will automatically close
when the device is done rebooting.
7. The Finder application will automatically rescan the network. Confirm that the new IP address has
been accepted by the device.
25
5 EMBEDDED WEB SERVER
5.1 Overview
The interface contains an embedded web server (also known as an HTTP server), which allows users to
access the inverter’s internal data in a graphical manner with web browsers such as Microsoft Internet
Explorer or Mozilla Firefox. In this way, the inverter can be monitored, configured and controlled from
across the room or from across the globe.
In order to view the interface’s factory-default web page, the free Adobe (formerly Macromedia) Flash
Player browser plug-in is required. If the plug-in is not already installed on your computer, then your
browser will automatically be redirected to the appropriate Adobe download web site when you initially
attempt to access the interface’s web page. Alternatively, the plug-in can be downloaded directly from
http://www.adobe.com. Always ensure that you have the latest version of the Flash Player installed: if
some aspect of the web page does not appear to be displayed properly, installing the latest Flash Player
update usually resolves the problem.
To access an interface’s embedded web server, either use the finder application (refer to section 4) and
select the “Open Web” button when the target unit is highlighted, or just directly enter the target unit’s IP
address into the address (URL) field of your web browser. Refer to Figure 22 for a representative
screenshot of the web server interface.
In order to access the web server and view the function code values, destination TCP ports 80 and 2000
must be accessible from the client computer. If an “XML socket connection failed” error message is
displayed in the information window, and no function code values are shown, this is typically indicative of
port 2000 being blocked by a firewall or Ethernet router situated between the client computer and the
interface card.
26
5.2 Page Select Tabs
The web interface is subdivided into several different “tabs” of associated information, much the same as
how folders in a filing cabinet are arranged. Refer to Figure 23. To change tabs, just click on the tab you
wish to view. The title of the currently-selected tab is red. Note that because different protocols are
supported by the interface with different firmware images, not all tabs may be accessible with the
firmware image currently loaded. The titles of tabs that are not accessible are grayed-out, and clicking
them has no effect.
27
Control Functions of Frequency: C function codes are available.
Motor 1 Parameters: P function codes are available.
The first column of the Function Code List shows the inverter function code designation that is normally
used when accessing a given function code via the inverter’s keypad. Note that this column is for user
convenience and inverter user’s manual cross-reference.
The second column of the Function Code List shows the register number for the corresponding function
code. Certain protocols require the use of a register number to access the function code (refer to section
6). The third column contains the function code descriptions, which are used by the filter function. The
last column performs two functions: it displays the current value of the function code, and (for writable
function codes) also allows changing the function code’s value by clicking on the number in the value
column and entering the new value.
28
Some items to keep in mind when interacting with the Function Code List are:
• When entering new function code values, be sure that the number being entered is appropriate for
the currently-selected radix (refer to section 5.3.5): for example, an entered value of “1000” in
hexadecimal is equal to 4096 in decimal.
• If desired, the column widths can be changed by dragging the vertical bars that separate the header
row’s cells to a different position.
• If you begin changing a function code value and then decide to abandon the change, pressing the
ESC key on your keyboard will abandon the change and redisplay the current function code value.
• When editing a function code value, clicking someplace off the entry cell is equivalent to hitting the
ENTER key.
Once a filter has been entered, it will continue to be applied to all information normally displayed in the
Function Code List for as long as the filter term is left in the filter entry box. Continuing the previous
example where we filtered on the root term “volt” in the monitor data 1 group, we can then easily apply
this filter to all available function codes simply by selecting the “All” function code group. The Function
Code List will now display all command, monitor, configuration etc. function codes that contain the root
term “volt”.
To remove the filter, delete any characters contained in the filter entry box and then click the “filter”
button.
Similarly, when “HEX” is selected, the “value” column heading will be “Value (Hexadecimal)”, current
function code values will be displayed in hexadecimal, and values to be written to function codes must
be entered in hexadecimal format. For example, to turn on bit #10 in the inverter’s operation command
word, enter the hexadecimal number 0400.
29
5.4 BACnet Tab
The BACnet tab provides for the configuration of the device on a BACnet/IP network. Refer to Figure 29.
30
5.4.3 Submitting Changes
Whenever either of the BACnet
configuration elements (Device Name or
Device ID) has been changed, the “submit”
button located in the left-hand portion of
Figure 32: Submit BACnet Changes
the web page must be clicked in order to
write these settings to the interface card’s
filesystem. Refer to Figure 32.
31
5.5 Config Tab
The Config tab provides access to various configuration items. Refer to Figure 34.
32
There are two separate elements that comprise the
timeout configuration (refer to Figure 37):
For example, Figure 37 shows a timeout time of 10s, and one timeout entry assignment. If a protocol
that makes use of timeout processing triggers a timeout event, then a value of 2000 will automatically be
written to inverter function code S05 (the frequency command). Provided the inverter has a valid “run”
command and is currently configured to use the network frequency command as its master frequency
command, it will ramp to 20.00Hz.
If timeout/failsafe processing is not desired, just clear the “function code” fields for all indexes (disabled).
This is the default condition.
“DEC” and “HEX” selection buttons are also available, and allow changing the “value” column data
display and entry radix between decimal and hexadecimal formats, respectively. These buttons provide
the ability to interact with the various inverter function codes in their most natural radix (e.g. a
hexadecimal command word vs. a decimal frequency command value).
33
5.6 EtherNet/IP Tab
The EtherNet/IP tab provides access to configuration items related to communication on an EtherNet/IP
network. Refer to Figure 39.
34
5.6.3 Run/Idle Flag Behavior
EtherNet/IP clients (such as PLCs) have
the option of adding a 32-bit “run/idle”
header to all class 1 (I/O) data packets
sent to devices. Bit 0 of this header is
called the “run/idle flag” by the EtherNet/IP
specification, and is intended to signify Figure 42: Run/Idle Flag Behavior Selection
when the client is in a “running” state or an
“idle” state. A running state (run/idle flag = Run) is indicated whenever the client is performing its normal
processing (e.g. scanning its ladder logic). An idle state (run/idle flag = Idle) is indicated otherwise. For
example, Allen Bradley ControlLogix PLCs will set their run/idle flag to Idle whenever their processor
keyswitch is placed in the “PROG” position, presumably in preparation to receive a new application
program from RSLogix.
The behavior of EtherNet/IP devices when they receive I/O data from a controller with the run/idle flag
set to Idle is not specified in the EtherNet/IP specification. The interface card allows the option of two
different behavioral responses when a run/idle flag = Idle condition is received, depending on the state of
the checkbox indicated in Figure 42.
• If the checkbox is cleared (default setting), then the interface card will maintain the last I/O data
values received from the client. For example, if the inverter was being commanded to run prior to
the run/idle flag being set to Idle, then it will continue to run.
• If the checkbox is checked, then the interface card will invoke its user-configured timeout
processing (refer to section 5.5.3).
Each of the function code array locations Figure 43: EtherNet/IP Class 1 (I/O) Data Configuration
are numbered 0-31 in the “word offset”
column. Clicking on a box in an array allows the user to enter a function code that will be referenced at
that location when data is either consumed from the controller or produced to the network. If an attempt
is made to enter an invalid function code, an error dialog box will appear. A blank value indicates that no
function code is referenced at that location, which will cause the corresponding consumed data to be
ignored and produced data to be a default value of 0.
As an example, looking at the default configuration shown in Figure 43, we can see that each array
contains two defined function codes. Therefore, up to 4 “meaningful” bytes of data can be both received
and sent (the qualifier “meaningful” is used here because the connection sizes configured in the
35
controller may request larger consumed and/or produced data sizes, but all unreferenced consumed
data will be ignored, and all unreferenced produced data will contain dummy “0” values). The first word
(two bytes) of consumed data will be written to function code S06 (operation command register) and the
second word will be written to function code S05 (frequency command). Similarly, the first word of
produced data will contain the value of function code M14 (status register) and the second word will
contain the value of function code M09 (output frequency).
36
5.7 Modbus Tab
The Modbus tab provides access to configuration items related to communication on a Modbus/TCP
network. Refer to Figure 45.
37
5.7.3 Register Remap Configuration
At times, it may be convenient to access inverter registers (function codes) in bulk Modbus transactions.
This may be especially true in situations where it is desired to access certain registers that are natively
non-contiguous. For example, if it were desired to read the inverter’s operating frequency (function code
M09, register 2058), DC link bus voltage (function M21, register 2070), and operation status (function
code M14, register 2063), this could be accomplished in two different ways:
1. Implement three separate Modbus read transactions, each one reading one register only, or
2. Implement one single Modbus read transaction, starting at register 2058 for a quantity of 13
registers. Then, pick out the registers of interest and ignore the rest of the response data.
While both of these methods will certainly work, neither one of them is optimized for the task at hand,
which is to access three specific register values. A fully optimized solution can be realized, however, by
making use of the interface card’s Modbus register remapping capabilities. This mechanism operates by
allocating a block of 50 user-configurable registers (5001..5050) that remap to other inverter registers. In
this way, non-contiguous inverter registers can be grouped together in any order and accessed
efficiently via the Modbus/TCP “read multiple registers” and “write multiple registers” function codes. The
net effect is one of being able to transfer larger blocks of registers using fewer Modbus transactions,
which results in improved network utilization and simpler data manipulation code on the Modbus master
device.
Figure 48 shows the register remap configuration array. Clicking on an entry field in the “Func Code”
column allows the user to enter an inverter function code that will then be accessible at the register
indicated in the adjacent “Register” column. A blank assignment in the “Func Code” column indicates
that no inverter function code is remapped at that location, which results in written values being ignored
and read values returned as a default value of 0. Note that remapped inverter registers (function codes)
are still accessible at their original locations: remapping simply provides an additional means of
accessing the original register’s value.
As an example, the configuration shown in Figure 48 reveals that a total of five inverter registers
(function codes) have been remapped. Function code S06, register 1799 (operation command word) has
been remapped to register 5001. Function code S05, register 1798 (frequency command) has been
remapped to register 5002. Function code M09, register 2058 (output frequency) has been remapped to
register 5003. Function code M21, register 2070 (DC link bus voltage) has been remapped to register
5004. Function code M14, register 2063 (operation status word) has been remapped to register 5005.
With this configuration, it is now possible to efficiently interact with these five non-contiguous inverter
registers via just two Modbus “read/write multiple registers” transactions. Writing to the frequency
command and command word can be accomplished with a single “write multiple registers” transaction
by writing a quantity of two registers starting at register 5001. Similarly, reading the output frequency,
DC link bus voltage and operation status word (in that order) can be accomplished with a single “read
multiple registers” transaction by reading a quantity of three registers starting at register 5003.
38
5.7.4 Submitting Changes
Whenever the Modbus configuration has been
changed, the “submit” button located on the right-hand
portion of the web page must be clicked in order to
write these settings to the interface card’s filesystem.
Refer to Figure 49. Figure 49: Submit Configuration Changes
39
5.8 Alarm Tab
The Alarm tab provides a configurable mechanism by which the interface card can autonomously
monitor any available inverter function code and send emails to up to four recipients when a certain
condition is detected. The alarm conditions have both value and time constraints, and can be configured
to retrigger at a fixed interval as long as the alarm condition continues to be satisfied. Twenty
individually-configurable alarms are available. Refer to Figure 50.
40
5.8.2 Email Configuration
In order for an alarm trigger to successfully send a
notification email, some network settings must first be
configured properly (refer to Figure 52).
• DIGEST-MD5
• CRAM-MD5
• LOGIN
• PLAIN
The highest priority authentication mechanism that is supported by the email server will be used.
41
5.8.3 Alarm Configuration
The interface supports twenty independently-configurable alarms. As shown in Figure 54, each alarm
has a variety of configuration elements, which will be explained further below.
Alarm Selection: This drop-down box allows the selection of one of the twenty available alarms. When
an alarm is selected, that alarm’s current configuration parameters will be populated in the alarm
configuration box.
“Enable” Check Box: If checked, this alarm is active and will be evaluated every second. If unchecked,
this alarm is inactive and will therefore not be evaluated.
Func Code: Enter the inverter function code that this alarm will continuously monitor. For example, the
alarm displayed in Figure 54 is configured to monitor M14, which is the operation status register.
Logical Comparison: Choose a comparison operator which will be used to compare the current value
of the indicated “Func Code” with the reference “Comparison Value”. Available selections are “less than”
(<), “less than or equal to” (<=), “greater than” (>), “greater than or equal to” (>=), “not equal to” (!=), and
“equal to” (=).
Comparison Value: The reference comparison value is comprised of two subcomponents: a “Mask”
field and a “Value” field. Each time the alarm is evaluated, the current value of the indicated “Func Code”
is first bit-wise “AND”ed with the “Mask” field. The resulting derived value is then compared with the
“Value” field by way of the “Logical Comparison” operator. While the “Mask” field is always a
hexadecimal number, the display and entry radix of the “Value” field can be changed between decimal
and hexadecimal with the associated “DEC” and “HEX” buttons.
Function codes that correspond to “analog” process variables (e.g. frequencies, voltages, etc.) should
typically have their “Mask” fields set to 0xFFFF, which causes all data bits to be retained for the “Value”
field comparison. For function codes that correspond to “enumerated” process variables (e.g. status
words where each bit of the function code indicates a different item), however, the “Mask” can be
chosen to single out one or more specific data bits of the function code. For example, the “Mask” value
of 0x0800 displayed in Figure 54 isolates bit #11 of the operation status register, which indicates
whether or not an inverter alarm exists. The “Value” field is also set to a hexadecimal value of 0x0800,
so the alarm condition will be evaluated as “true” when bit #11 of the operation status register equals 1.
The Condition Must Remain True For A Minimum Of: Alarm analysis processing is performed by the
interface card once per second. Enter the number of seconds that the condition must be continuously
evaluated as “true” for the alarm to be triggered. A time of 0 seconds means that just a single evaluation
of “true” will immediately trigger the alarm.
Send Additional Reminders While The Condition Remains True: If this check box is unchecked,
then only one email transmission event will occur when an alarm condition is triggered: further email
transmissions will not be attempted for this alarm unless the alarm condition is first evaluated as “false”
(which resets the alarm), and then once again is triggered by a subsequent event.
42
If this check box is checked, then as long as the alarm condition continues to be evaluated as “true”,
subsequent email transmissions will be automatically retriggered every indicated number of minutes for
a maximum of the indicated number of times. If at any time during the subsequent transmissions the
alarm condition is evaluated as “false”, then the alarm will be reset and email transmissions for this
alarm will stop (until the next time the alarm is triggered, of course).
Subject: Enter a string of up to 128 characters in length which will appear in the “subject” line of the
alarm email. The body of the alarm email is empty.
Note that because these configuration elements are read from the filesystem only when the interface
card boots up, the act of submitting configuration changes will also reset the interface card. Please allow
10 seconds for the interface card to reboot, at which time it will then be operating with the recently-
submitted configuration. Refer to Figure 55.
43
5.9 Dashboard Tab
The Dashboard Tab provides access to a virtual keypad, as well as a variety of gauges, meters and
graphs that can be configured to provide an at-a-glance graphical overview of critical application
variables in real-time. A total of 10 gauge windows are available (two at a time), and each gauge window
can be configured to display any scanned function code’s value via one of six different gauge types.
User-defined engineering units, scaling and range limits are also configurable. Refer to Figure 56.
44
5.9.2 Virtual Keypad
A “virtual keypad” is displayed on the left-hand side of the dashboard tab, and acts as an interface for
several useful pieces of control and monitor information. For an overview of the virtual keypad interface,
refer to Figure 58. Note that it is recommended to suspend all external protocol-based communications
with PLC’s, etc when using the virtual keypad, as other protocols may simultaneously be writing to the
inverter’s frequency command and operation command word, resulting in seemingly unpredictable
behavior.
Frequency
Operation
command entry box
command buttons
“Write frequency
command to
inverter” button
General-purpose
Operation status
input terminal
bits
command buttons
Output frequency display: Indicates the current output frequency of the inverter in large red numbers,
as reported by inverter function code M09. The image in Figure 58 indicates that the associated inverter
is currently running at 23.58Hz.
Frequency command entry box: Allows the user to enter a new frequency command for the inverter,
which is subsequently scaled and written to inverter function code S05 when the “SET” button is clicked.
“SET” button: Clicking this button will scale and write the value contained in the frequency command
entry box to inverter function code S05. Note that the inverter will use this frequency command as its
master frequency reference only when configured accordingly (refer to section 3.1).
General-purpose input terminal command buttons: These buttons (labeled “X1” through “X9”) map
to the corresponding bits in the inverter’s operation command word (function code S06, bit #2 .. bit #10).
The usage of these bits varies depending on the configuration of inverter function codes E01 to E09.
When a given button is clicked and shown in its depressed state, the corresponding bit is set to a “1”.
When clicked again (and therefore shown in its non-depressed state), the corresponding bit is set to a
“0”. As an example, the image in Figure 58 shows X1..X7 as OFF (“0”), and X8 and X9 as ON (“1”). Note
that controlling these operation command word bits will only affect the inverter when it is configured
accordingly (refer to section 3.1).
Operating status display: Indicates the current state of the inverter based on bits in the inverter
operation status register (function code M14). Possible displays include “STOP”, “FWD”, “REV” and
“FAULT”.
Operation command buttons: Clicking on these buttons enables different control actions to be
imposed on the inverter, as follows:
• FWD: sets bit #0 (“FWD”) and clears bit #1 (“REV”) in the operation command word (function code
S06).
45
• REV: sets bit #1 (“REV”) and clears bit #0 (“FWD”) in the operation command word (function code
S06).
• STOP: clears both bit #0 (“FWD”) and bit #1 (“REV”) in the operation command word (function
code S06).
• RESET: writes a value of “1” to function code S14 (alarm reset command). This will reset a faulted
inverter regardless of the current operation command mode (H30, Y98 etc.) Note that if the inverter
was running (the “FWD” or “REV” buttons were the last buttons pressed on the virtual keypad
before the fault occurred), the STOP button must be clicked prior to clicking the RESET button in
order to clear the FWD and REV bits in the operation command word. The inverter will ignore reset
commands issued through function code S14 as long as a valid run command still exists in the
operation command word.
Note that the inverter will follow the FWD, REV and STOP button commands only when configured
accordingly (refer to section 3.1).
Hovering the cursor over the virtual LEDs will bring up a tooltip which provides a brief
summary of the indicated function. Refer to Figure 59.
Gauge Selector: A drop-down selection box in the upper left-hand corner of the gauge window, which
allows the user to select the type of gauge that will be displayed.
Title: A text entry box located above the gauge, in which the user can enter a descriptive gauge title
comprised of up to 16 characters.
Units: A text entry box in which the user can enter an engineering units string comprised of up to 8
characters. This units string will be appended to all locations in the gauge window that display the
designated function code’s current value.
Function Code: The designated function code whose value is to be reflected on the gauge. Note that
only scanned function codes may be displayed in Dashboard gauges (refer to section 6.2 for a
discussion of scanned function codes).
Multiplier: The multiplier value is a floating-point number that is used to scale the raw value of a function
code. As its name suggests, the multiplier value is multiplied by the designated function code’s current
raw value in order to calculate the gauge’s indicated value. Negative values can also be used if desired.
Min Value: The gauge’s minimum indicated value. Negative values can be used if desired (e.g. if a
negative Multiplier attribute is used to generate a negative indicated value). Not all gauges allow
adjustment of the min value.
46
Max Value: The gauge’s maximum indicated value. Similar to the Min Value attribute, negative values
can be used if desired. Indicated value characteristics can even be inverted by setting the Max Value
attribute to a value less than the Min Value attribute.
Update Button: Clicking the update button will apply the current configuration attribute settings to the
gauge. Note, however, that simply updating the gauge’s current display properties does not write these
settings to the interface card’s filesystem. To save the current configuration of all the gauge windows to
the filesystem, the Dashboard tab’s “submit” button must be selected (refer to section 5.9.5).
Current Value: The current indicated value of the designated function code is numerically displayed with
the configured Units string at the bottom of each gauge window.
47
Pos/Neg Meter: Refer to Figure 64. Similar
to the “meter” gauge, this type of meter also
implements a common panel meter-type
display format, but in this instance the
indicated value can be positive or negative
(two’s complement interpretation). In other
words, raw function code values of 0..0x7FFF
equate to 0..3276710, and values of
0x8000..0xFFFF equate to -32768..-1.
Because the meter placard is always
centered around zero, the “Min Value”
attribute is not configurable, and the “Max
Value” attribute is used for both the maximum
positive indicated value as well as the
maximum negative indicated value. Figure 64: Pos/Neg Meter
48
At times, it may be convenient to zoom in on a particular gauge or meter in order to more
clearly see the indicator, or to fill the computer screen with a particular gauge’s image.
This can be easily accomplished with the web browser’s Flash Player plug-in by right-
clicking on the gauge and selecting the desired zoom level (refer to Figure 67).
49
5.10 Customizing the Embedded Web Server
5.10.1 Customization Overview
It is possible for end-users to customize the embedded web server in order to create their own
application-specific or corporate “look and feel”. Knowledge of authoring dynamic web content is
required. Using windows explorer, it is possible to load customized web server content into the “WEB”
folder on the interface card’s file system (refer to section 7.2). Usually, this web server content contains
programming which implements the XML socket-based XTPro protocol (refer to section 5.10.2). Via
XTPro, the embedded web server can gain access to any inverter parameter and the interface card file
system resources, and manipulate them as required.
Notes
• There is an XML file located in the “WEB” folder called “frenicMegaParam.xml”, which contains
definitions for all inverter function codes that are available via the interface card. This file must not
be removed, as it contains the definition of all available parameters not only for active web server
content, but also for the interface card itself. All other files in the “WEB” folder may be deleted or
replaced if desired by the user.
• The default HTML file targeted by the web server is “index.htm”. Therefore, when customizing the
web server content, ensure that initial file “index.htm” exists.
• All files accessed by the web server itself must reside in the “WEB” folder. Note that this does not
restrict active web server content to using only the “WEB” folder, however, as XTPro “read_file”
and “write_file” commands can access any existing location on the file system.
• If the factory-default “WEB” folder contents need to be recovered (if they are accidentally deleted,
for example), they can be downloaded from the device’s product page on the internet.
• Two simultaneous web server sessions are supported. Note that the number of available
simultaneous web server sessions is independent of the number of available simultaneous XTPro
XML sockets.
XTPro is a request/response protocol that provides services specified by commands. For more
information on XTPro, refer to the separate XTPro Specification. This section will cover the device-
specific implementation of the XTPro protocol.
50
5.10.3 XTPro Web Browser-Based Implementation
A representative implementation based upon using a web browser as the client is detailed in Figure 69.
In this scenario, the client application is developed by using an active web server authoring tool (such as
Adobe Flash®). The active content is then embedded into one or more HTML files and loaded onto the
device’s file system (refer to section 5.10.1 for detailed information regarding customization of the web
server content). Accessing the device’s web server via a standard web browser then loads the active
content, which initiates communication with the server.
Programmer authors
active web page
2 content (via Adobe
Content is loaded onto Flash, etc.)
server device’s file
system for web server
File System
Device
6
Client initiates XTPro http://192.168.16.111
5
<xreq> requests
<read_data> Active content
<ref>Pr_2</ref> XML socket (port 2000)
</read_data> executes and
XTPro Server
</xreq> establishes
XML socket
7
Server responds to http://192.168.16.111
8
<xresp>
<read_data>
client’s requests
<ref>Pr_2</ref>
<val>123</val> XML socket (port 2000)
:
</xresp>
51
5.10.4 XTPro HMI-Based Implementation
A representative implementation based upon a stand-alone HMI client is detailed in Figure 70. In this
scenario, the client application is developed by using tools provided by the HMI manufacturer, and is
hosted independently of the actual server device.
Programmer authors 2
HMI (client) content
Content is loaded
onto HMI device
Server
Device
4
Client initiates XTPro 3
<xreq> requests
<read_data> HMI content
<ref>Pr_2</ref> XML socket (port 2000)
</read_data> executes and
XTPro Server
</xreq> establishes
XML socket
5
Server responds to 6
<xresp>
<read_data>
client’s requests
<ref>Pr_2</ref>
<val>123</val> XML socket (port 2000)
:
</xresp>
Notes
• Two simultaneous XTPro connections are available.
52
6 FUNCTION CODE NUMBERING AND BEHAVIOR
6.1 Register Numbers
All accessible inverter function codes can be referenced by their Modbus register indexes, as defined in
the RS-485 User’s Manual (MEH448), section 3 (Table 3.2). These same register numbers are used
when accessing function codes via certain Ethernet protocols (i.e. Modbus/TCP, AB CSP). The terms
“function code” and “register” refer to data stored on the inverter and will be used interchangeably
throughout this documentation. The max supported register number is 4964. Because the RS-485
User’s Manual contains information for several Fuji inverter families, the relevant information will be
paraphrased here for the specific case of the FRENIC-Mega.
All inverter function codes are exposed as register indexes according to a mathematical conversion
formula which combines two elements (a function code group number and function code offset) to create
a unique register number for each function code. Each function code group (“E” / Extension Terminal
Functions, for example) is assigned a specific function code group number (refer to Table 5). Each
function code also has an offset number, which is the function code without the leading letter (the offset
number for function code E05, for example, is 5). To determine the register number for a given function
code, therefore, the group number is first multiplied by 256, then added to the offset number plus 1. This
operation is expressed mathematically via Equation 1.
As an example, let’s calculate the register number for output frequency (function code M09). According
to Table 5, the group number for the “M” function code group is 8. It is also evident that the offset
number for M09 is 9. Inserting the group number and offset number into Equation 1, we arrive at the
result indicated in Equation 2.
While manually calculating all of the register numbers for the function codes of interest is certainly
possible by using Equation 1, it may be more convenient to simply reference the “Register” column on
the monitor tab of the default web interface (refer to section 5.3.3).
Note that not all of the available registers that exist in the interface card’s register map have
corresponding function codes that exist in the inverter. In other words, if a read from or write to a register
number that does not correspond to an existing inverter function code takes place, the read/write may be
successful (depending on the specific register accessed; refer to section 6.2), but the data will have no
meaning. This feature is beneficial in situations where the accessing of non-contiguous registers can be
made more efficient by accessing an all-inclusive block of registers (some of which correspond to
inverter function codes and some of which do not), while only manipulating those in your local
programming that are known to exist.
53
Table 5: Function Code-to-Register Conversion Examples
Fundamental
F 0 F07 (acceleration time 1): (0 x 256) + 7 + 1 = 8
Functions
Extension
E Terminal 1 E98 (terminal [FWD] function): (1 x 256) + 98 + 1 = 355
Functions
Control
C 2 C20 (jogging frequency): (2 x 256) + 20 + 1 = 533
Functions
Motor 1
P 3 P03 (motor 1 rated current): (3 x 256) + 3 + 1 = 772
Parameters
High
H Performance 4 H11 (deceleration mode): (4 x 256) + 11 + 1 = 1036
Functions
Motor 2
A 5 A05 (motor 2 torque boost): (5 x 256) + 5 + 1 = 1286
Parameters
Operational
o 6 o01: (6 x 256) + 1 + 1 = 1538
Functions
Command
S 7 S05 (frequency command): (7 x 256) + 5 + 1 = 1798
Data
Motor 4
r 10 r02 (motor 2 base frequency): (10 x 256) + 6 + 1 = 2563
Parameters
Application
J 13 J03 (PID proportional gain): (13 x 256) + 3 + 1 = 3332
Functions 1
Z Alarm Data 2 17 Z53 (3rd last alarm torque): (17 x 256) + 53 + 1 = 4406
Motor 3
b 18 b12 (motor 3 starting frequency): (18 x 256) + 12 + 1 = 4621
Parameters
Application
d 19 d24 (zero speed control): (19 x 256) + 24 + 1 = 4889
Functions 2
54
6.2 Scanned Function Codes
The interface card provides network access to the specified list of function codes contained in the
frenicMegaParam.xml file located in the “WEB” folder of the interface card’s file system. These function
codes are constantly being “scanned” by the interface card, which is to say that they are constantly
being read and/or written (as applicable), and their current values are therefore mirrored in the interface
card’s internal memory. Only those function codes specified in the frenicMegaParam.xml file will
represent meaningful values.
The principle disadvantage of scanned function codes is that write data checking is not available. This
means that when the value of a scanned function code is modified via a network protocol or via the web
browser’s monitor tab, the interface card itself is not able to determine if the new value will be accepted
by the inverter (the value may be out-of-range, or the inverter may be in a state in which it will not accept
new values being written via communications, etc.) For example, if a write is performed to a scanned
command function code with a data value that is out-of-range, the interface card will not generate a
corresponding error. However, if end-to-end confirmation of such data writes is required, then the
function code can be read over the network at a later time to confirm that the written value “took hold” in
the inverter. If the value was not accepted by the inverter, then the unsuccessful write can be observed
by reading the current (unchanged) value of the function code during a subsequent network transaction.
If the unsuccessful write was initiated via the web browser’s monitor tab, then the displayed function
code will revert back to its original value automatically.
Accesses to any function code (?00..?99, where “?” is any valid function code group letter from Table 5)
will always be successful. Even if an inverter function code corresponding to a given register does not
exist in the frenicMegaParam.xml file, the interface card still maintains a placeholder location in its
internal mirroring memory for that function code. This feature allows for the block access of non-
contiguous registers (function codes) as described in section 6.1. Care must be taken to utilize only the
function codes that are known to exist and that are also specified in the frenicMegaParam.xml file.
55
Table 7: Structure of “Operation status” (Function code M14)
56
7 FILE SYSTEM & FIRMWARE
7.1 Overview
The interface card’s on-board filesystem is used to store files for use by the application firmware.
Currently, the application firmware’s main use of the filesystem is to store XML-encoded configuration
files and the embedded web server. The XML-encoded configuration files dictate the characteristics of
the various protocols and features. Each protocol that requires configuration will have its own XML file
stored on the filesystem. For easy identification, the filename will begin with the corresponding protocol
which it configures. For example, a BACnet/IP configuration file’s filename will begin with “bips”, and an
EtherNet/IP file will begin with “eips”.
Whenever the configuration for a specific protocol is completed, it is suggested that a backup copy of the
configuration file be downloaded from the unit to a PC. One reason for this is in case it becomes
necessary to restore a previous configuration at a later time. Another reason is that it may be desirable
to load multiple units with the same configuration, as a downloaded configuration file can be uploaded
again to any compatible unit, allowing the user to easily clone multiple units with the same configuration.
Each time the interface card boots up, it will search the filesystem for the configuration files required by
the protocols currently operating in the unit. If it does not find a required file, it will create one and
initialize it with factory-default values. Therefore, if it is ever desired to reset a protocol’s configuration to
factory-default values, this can be easily accomplished by simply deleting the appropriate configuration
file from the filesystem and rebooting the unit.
Note that the application firmware uses specific filenames for the configuration files. This means that if a
file with a different filename is loaded onto the unit, it will be stored correctly, but will not be used by the
application firmware. Similarly, if an existing configuration file’s filename is changed, then the unit will
again create a default configuration file at next boot-up, which will be stored in the filesystem alongside
the file with the changed name.
Configuration files are only read by the protocol drivers at unit boot-up. Therefore, if a new configuration
file is loaded onto a unit’s filesystem, that unit must be rebooted for the configuration file’s settings to
take effect. Rebooting a unit can be performed by power-cycling the inverter in which the card is
installed, or by selecting the “Reboot Device” button in the Finder utility.
The embedded web server is customizable and is located in the “WEB” folder. All web page related
items should reside in the “WEB” folder.
Interacting with the filesystem is performed via USB (using a mini-B USB cable) as the interface card
enumerates as a standard USB mass storage device “flash drive”. Users can interact with the files on
the interface card’s filesystem in the same manner as though they were traditional files stored on a local
or remote PC.
57
7.2 Windows Explorer
To use Microsoft Windows Explorer, first open either “Windows Explorer” or “My Computer”. Refer to
Figure 71. Note that the indicated procedure, prompts and capabilities outlined here can vary depending
on such factors as the installed operating system and service packs.
The interface card will typically be displayed as a removable medium such as a Removable Disk. Refer
to Figure 72.
Figure 71:
Accessing
Windows Explorer
Figure 72: Removable Disk with Windows Explorer
Windows Explorer will then display the filesystem’s contents (refer to Figure 73.) You can now perform
normal file manipulation actions on the available files and folders (cut, copy, paste, open, rename, drag-
and-drop transfers etc.) in the same manner as though you were manipulating any traditional file and
folder stored on your computer’s hard drive.
58
7.3 Loading New Application Firmware
The interface card’s embedded firmware resides in flash memory that can be updated in the field.
Firmware updates may be released for a variety of reasons, such as custom firmware implementations,
firmware improvements and added functionality as a result of user requests. Additionally, it may be
necessary to load different firmware onto the unit in order to support various protocols.
We are continually striving to enhance the functionality and flexibility of our products, and therefore
periodically release new embedded firmware to achieve these goals and meet customer requests. Flash
firmware files and all related documentation (such as updated user manuals) can be requested from
technical support. It is suggested that users first check with technical support, and then periodically
afterwards to determine if new firmware has been released and is available to upgrade their units.
59
8 PROTOCOL-SPECIFIC INFORMATION
This section will discuss topics that are specific to each of the supported protocols.
8.1 Modbus/TCP
8.1.1 Overview
The interface card supports Schneider Electric’s Modbus/TCP protocol, release 1.0. The interface is
conformance class 0 and partial class 1 and class 2 compliant, and allows up to 8 simultaneous
Modbus/TCP client connections (sockets). Other notes of interest are:
• Supported Modbus/TCP functions are indicated in Table 8.
Function
Function Modbus/TCP Class
Code
1 Read coils 1
5 Write coil 1
• To calculate the register number for a function code, refer to section 6.1.
• Inverter registers can be addressed as either holding registers (4X references) or input registers (3X
references). For example, accessing the output frequency involves accessing holding register
42058 or input register 32058 (i.e. offset 2058). Please note that the most significant digit (4 or 3) is
only used as a naming convention for holding registers and input registers. When accessing the
output frequency, specify a register value of 2058 (not 42058 or 32058).
• Specific bits within inverter registers can be accessed as either coils (0X references) or discrete
inputs (1X references).
• Because the transaction is handled locally within the interface card, write data checking is not
available for scanned registers/function codes (refer to section 6.2.) For example, if a write is
performed to a register with a data value that is out-of-range of the corresponding function code, no
Modbus exception will be immediately returned.
• The “unit identifier” (UI) field of the request packets is ignored.
• The socket timeout time is determined by the “timeout” setting on the web server’s “Config” tab
(refer to section 5.5.3). This means that if a particular open socket experiences no activity for more
than the timeout time setting, then the interface assumes that the client or network has experienced
some sort of unexpected problem, and will close that socket.
• Because the socket timeout determination is performed on a per-socket basis, note that a certain
degree of caution must be exercised when using the network timeout feature to avoid “nuisance”
timeouts from occurring. Specifically, do not perform inadvisable behavior such as sending a
request from the master device to the interface, and then closing the socket prior to successfully
receiving the unit’s response. The reason for this is because the interface will then experience an
error when attempting to respond via the now-closed socket, which will immediately trigger the
timeout action. Always be sure to manage socket life cycles “gracefully”, and do not abandon
outstanding requests.
• If a socket timeout occurs (regardless of whether it was due to a communication lapse or abnormal
socket error), the driver will trigger a timeout event as described in section 5.5.3.
60
• If the drive is configured to cause a trip (section 3.2), a Modbus TCP socket must first be
successfully established before the trip can be cleared.
Arithmetically, the discrete-to-register/bit relationship can be described as follows: For any given
discrete, the register in which that discrete resides can be determined by Equation 3.
⎢ discrete + 15 ⎥
register = ⎢ ⎥ Equation 3
⎣ 16 ⎦
Where the bracket symbols “⎣ ⎦” indicate the “floor” function, which means that any fractional result (or
“remainder”) is to be discarded, with only the integer value being retained.
Also, for any given discrete, the targeted bit in the register in which that discrete resides can be
determined by Equation 4.
Where “discrete” ∈[1…65535], “bit” ∈[0…15], and “%” is the modulus operator, which means that any
fractional result (or “remainder”) is to be retained, with the integer value being discarded (i.e. it is the
opposite of the “floor” function).
For clarity, let’s use Equation 3 and Equation 4 in a calculation example. Say, for instance, that we are
going to read coil #34. Using Equation 3, we can determine that coil #34 resides in register #3, as
⎣3.0625⎦ = ⎣3 r1⎦ = 3. Then, using Equation 4, we can determine that the bit within register #3 that coil
#34 targets is (34-1)%16 = 1, as 33%16 = mod(2 r1) = 1. Therefore, reading coil #34 will return the value
of register #3, bit #1.
61
8.2 EtherNet/IP
8.2.1 Overview
The EtherNet/IP protocol is an application-level protocol implemented on top of the Ethernet TCP/IP and
UDP/IP layers. It shares its object model with ControlNet and DeviceNet through the Common Industrial
Protocol (CIP). This protocol allows the transfer of data and I/O over Ethernet.
EtherNet/IP incorporates both the TCP and UDP layers of Ethernet in the transmission of data. Because
TCP/IP is a point-to-point topology, EtherNet/IP uses this layer only for explicit messaging; i.e. those
messages in which the data field carries both protocol information and instructions for service
performance. With explicit messaging, nodes must interpret each message, execute the requested task
and generate responses. These types of messages can be used to transmit configuration, control and
monitor data.
The UDP/IP protocol layer, which has the ability to multicast, is used for implicit (I/O) messaging. With
I/O messaging, the data field contains only real-time I/O data; no protocol information is sent because
the meaning of the data is pre-defined at the time the connection is established, which in turn minimizes
the processing time of the node during run-time. I/O messages are short and have low overhead, which
allows for the time-critical performance needed by controllers.
The interface card supports both explicit and I/O messaging. Further, two different types of I/O
messaging are supported. One type (invoked when the client opens a connection to the interface using
assembly instances 20 & 70 or 21 & 71) is included with the implementation of the AC/DC drive profile,
and requires no user configuration. The other type, however, is entirely user-configurable, and is invoked
when the client opens a connection to the interface using assembly instances 100 and 150.
The following sections demonstrate specific examples of how to use EtherNet/IP to transfer data
between the inverter and Allen-Bradley Logix-brand PLCs.
62
8.2.2 ODVA AC/DC Drive Profile
The interface card supports the ODVA AC/DC drive profile. No special EtherNet/IP configuration of the
interface card is required when using the AC/DC drive profile: all that is needed is that the controller
must target either assembly instances 20 & 70 or 21 & 71 in its connection parameters.
The AC/DC drive profile implementation provides support for several required CIP objects, which are
specified in Table 9. While the various supported attributes of all of these objects are accessible via
explicit messaging, the main intent of using the AC/DC drive profile is to interact with the predefined
input and output assembly instances via an I/O connection. The structure of these assembly instances is
defined by the EtherNet/IP specification in order to engender interoperability among different vendor’s
products. This section will focus primarily on the format of the AC/DC drive profile I/O assemblies
supported by the interface card, and the inverter data which their various constituent elements map to.
Output Instances
Table 10: Output Instances 20 and 21 Detail
Instance Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
Fault Run
0
Reset Fwd
1
20
2 Speed Reference (Low Byte)
1
21
2 Speed Reference (Low Byte)
Run Rev: reverse rotation command (0=reverse rotation off, 1=reverse rotation on). Maps to inverter
function code S06, bit 1 (function code S06 / operation command word, REV bit).
Fault Reset: Inverter reset command (0=no action, 0→1 rising edge=reset). Maps to inverter function
code S06, bit 15 (function code S06 / operation command word, RST bit).
63
NetCtrl: Not used (value is ignored).
NetRef: Not used (value is ignored).
Speed Reference: Inverter speed reference in RPM. Maps to function code S05 (frequency command).
The speed reference component of the AC/DC drive profile output instances is always in units of RPM.
Therefore, the interface card applies the RPM-to-Hz conversion indicated in Equation 5 in order to
determine the appropriate frequency command value (in units of Hz) to be written to function code S05.
The “number of motor poles” term which appears in the numerator of Equation 5 is obtained from the
setting of inverter function code P01 (Motor number of poles). Note that the value of P01 is read by the
interface card only at boot-up, so if the value of this function code is changed, then the interface card
must be rebooted in order for it to read the new value from the inverter.
Input Instances
Instance Byte Bit 7 Bit 6 Bit 5 Bit 4 Bit 3 Bit 2 Bit 1 Bit 0
0 Running1 Faulted
1
70
2 Speed Actual (Low Byte)
Ref Ctrl
At Running2 Running1
0 from From Ready Warning Faulted
Reference (REV) (FWD)
Net Net
71 1 Drive State
Faulted: Inverter fault signal (0=not faulted, 1=faulted). Maps to function code M14, bit 11 (operation
status word, ALM bit).
Running1 (FWD): Running forward status signal (0=not running forward, 1=running forward). Maps to
function code M14, bit 0 (operation status word, FWD bit).
Running2 (REV): Running reverse status signal (0=not running reverse, 1=running reverse). Maps to
function code M14, bit 1 (operation status word, REV bit).
Ready: Inverter ready signal (0=not ready, 1=ready). The Ready bit will be 1 whenever the Drive State
attribute (see below) is in the Ready, Enabled or Stopping state.
CtrlFromNet: This bit is not used (it is always 0).
64
Drive State: Indicates the current state of the Control Supervisor Object state machine. Refer to the
ODVA EtherNet/IP specification (object library) for detailed information on the Control Supervisor Object
state machine.
Speed Actual: Inverter operating speed in RPM. Maps to function code M09 (output frequency). The
speed actual component of the AC/DC drive profile input instances is always in units of RPM. Therefore,
the interface card applies the Hz-to-RPM conversion indicated in Equation 6 in order to determine the
appropriate operating speed (in units of RPM) to be written to the network.
Hz x 120
RPM = Equation 6
number of motor poles
The “number of motor poles” term which appears in the denominator of Equation 6 is obtained from the
setting of inverter function code P01 (Motor number of poles). Note that the value of P01 is read by the
interface card only at boot-up, so if the value of this function code is changed, then the interface card
must be rebooted in order for it to read the new value from the inverter.
3) Right click on the I/O Configuration node in the controller organizer view and choose “New
Module…”
4) The “Select Module” window will open.
5) Under “Communications”, select “1756-ENBT/A”, and click OK. Refer to Figure 75.
65
9) Switch to online mode. Right click on the 1756-ENBT/A module in the I/O Configuration and
choose “Properties”.
10) Select the Port Configuration tab from the Module Properties dialog box.
11) Confirm that the IP Address, Subnet Mask and Gateway Address fields are configured correctly.
The IP Address must match the IP Address entered when the new module was first created. Refer
to Figure 77.
12) Apply any changes to the settings using the “Set” button.
13) You should now be able to confirm that the 1756-ENBT/A module is configured properly by (for
example) opening the module’s web interface in a web browser.
66
2) Right click on the 1756-ENBT/A node under the I/O Configuration in the controller organizer view
and choose “New Module…”
3) Choose “Generic Ethernet Module” in the Select Module dialog box and click “OK”. Refer to Figure
78.
4) The module properties dialog box will open (refer to Figure 79). Enter a Name and Description
which will allow easy identification of the inverter on the network (the tags created in RSLogix 5000
will be derived from this Name). Because all inverter data is stored as 16-bit function code values,
change the “Comm Format” selection to “Data-INT”. Enter the IP address of the targeted interface
card.
In the “Connection Parameters” portion of the dialog box, enter the following information:
Input: The Input Assembly is the collection of monitor data that is produced by the interface card
and is received as an input to the PLC. Its structure is defined by the Produced Data Configuration
as described in section 5.6.4. The Input Assembly Instance must be set to 150 when connecting to
the vendor-specific I/O assembly instances (or 70/71 when using the ODVA AC/DC drive profile),
and the size must be set to the number of 16-bit function codes that we wish to receive from the
interface card. For the purposes of this example, we are assuming that the produced configuration
67
array is defined as shown in Figure 43, with two relevant function codes (M14 and M09). We
therefore set the Input Size to 2.
Output: The Output Assembly is the collection of command & configuration data that is sent as an
output from the PLC and consumed by the interface card. Its structure is defined by the Consumed
Data Configuration as described in section 5.6.4. The Output Assembly Instance must be set to
100 when connecting to the vendor-specific I/O assembly instances (or 20/21 when using the
ODVA AC/DC drive profile), and the size must be set to the number of 16-bit function codes that
we wish to send to the interface card. For the purposes of this example, we are assuming that the
consumed configuration array is defined as shown in Figure 43, with two relevant function codes
(S06 and S05). We therefore set the Output Size to 2.
Configuration: The Configuration Assembly Instance is unused, and its instance number and
size are therefore irrelevant (you can just enter “1” and “0”, respectively).
Confirm the setting of the Requested Packet Interval (RPI). The RPI defines the amount of time (in
milliseconds) between data exchanges across an I/O connection. The smallest RPI supported by
the interface card is 2ms. However, the lowest recommended RPI is 10ms.
68
We can directly interact with these tags in order to
control and monitor the inverter. In Figure 83, for
example, we can see that the first 16-bit word of output
data (Fuji_Inverter:O.Data[0]) has been set to a
hexadecimal value of 0x0001. Referring back to Figure
43, we can see that the first element of the consumed
data configuration references function code S06, which
is the inverter’s operation command register. A value of
0x0001, therefore, means that the FWD (run forward)
bit has been turned ON.
Figure 82: Online Module Status
Similarly, we can see that the second 16-bit word of
output data (Fuji_Inverter:O.Data[1]) has been set to a
decimal value of 3558. Once again referring back to Figure 43, we can see that the second
element of the consumed data configuration references function code S05, which is the inverter’s
frequency command register. A value of 3558, therefore, equates to a frequency command of
35.58Hz.
The input data from the inverter shows similar expected results. Values of 0x1021 and 3558
corresponding to M14 (status register) and M09 (output frequency), respectively, are consistent
with the inverter running at the parameters commanded by the output tag.
3) Double click “Controller Tags” in the controller organizer view and select the “Edit Tags” tab at the
bottom.
69
4) Create the tags in Figure 85.
6) Right click on the first ladder logic rung in the MainRoutine window and select “Add Ladder
Element...”
7) The “Add Ladder Element” window appears.
8) Select the generic default I/O add-on instruction in the Add-On folder. Refer to Figure 86.
70
Figure 87: Configure Generic Default AOI
11) The program is now complete.
1) Complete all the steps in section 8.2.4. Please note that the Assembly Input Instance must be
changed to 71 and the Assembly Output Instance must be changed to 21. Refer to Figure 88.
2) Right click on “Add-On Instructions” in the controller organizer view and select “Import.Add-On
Instruction”. Browse and import the AC/DC drive profile add-on instruction. Refer to Figure 89.
71
Figure 89: AC/DC Drive Profile Add-On Instruction
3) Double click “Controller Tags” in the controller organizer view and select the “Edit Tags” tab at the
bottom.
6) Right click on the first ladder logic rung in the MainRoutine window and select “Add Ladder
Element...”
8) Select the AC/DC drive profile add-on instruction in the Add-On folder. Refer to Figure 91.
9) Click OK.
72
10) Edit the add-on instruction according to Figure 92.
Any given scanned or non-scanned function code can be accessed with its own unique tag name, or an
array tag can be used to access a group of function codes with one PLC instruction. Tag names are
generated according to the following structure:
Where
[function code group] is a 1-character field, and is the ASCII character for the function code’s group.
Refer to Table 5.
[function code offset] is a 2-character field corresponding to the function code offset. If the offset is
less than 10, it must be pre-pended by 0. Valid offsets are “00” to “99”.
Examples
Write “acceleration time 1” ..................................................................................... F07
Write “frequency command” ................................................................................... S05
Read “operation status” ......................................................................................... M14
Read “output power” .............................................................................................. W22
To read data from the interface card, the application PLC program must reference a “source element”
from which to start reading and the “number of elements” to read. The “source element” will be a tag
name constructed according to the naming convention shown above. The “source element” can be
either a base tag (such as “M01”), or an offset from a base tag (such as “M01[8]”, which starts at
function code M01 + 8 = function code M09, the inverter’s output frequency register).
73
In a similar manner, to write data to the interface card, the application PLC program must reference a
“destination element” to which to start writing and the “number of elements” to write. Again, the
“destination element” will be a tag name constructed according to the naming convention shown above.
Whether reading or writing, the “number of elements” can be any quantity of function codes from 1 to the
maximum allowable length.
f) Collapse the “connection” tag again by clicking on the “-“ sign next to the tag name.
g) Select the “Edit Tags” tab again. Create another new tag by entering “data_array” in the next
blank Name field, and change its Data Type by typing in “INT[73]” in the Data Type field. This
tag is an array of INTs that will be able to hold up to 73 16-bit function codes from the
inverter. Always make sure that the destination tag size is large enough to hold all elements
to be read.
74
2) Add a MSG instruction to the main
program.
e) Click OK.
a) Edit the “Message Control” field on the MSG instruction to use the previously-created
“connection” tag. Refer to Figure 97.
b) Click the message configuration button (“…”) in the MSG instruction. The “Message
Configuration” window will open. Refer to Figure 98.
75
Figure 98: MSG Instruction Configuration
ii) In the "Source Element” field, enter the read tag you wish to access (refer to section
8.2.5.) In this example, we will be reading a total of 21 function codes beginning at
function code M01 (per-unit frequency reference – final command).
iii) Enter the Number Of Elements to read. In this example, we will read 21 function codes.
iv) For the Destination Element, either directly type in “data_array[50]”, or select element
#50 in the data_array tag via the drop-down box (refer to Figure 99). The destination
could be any offset in the data_array tag, as long as the offset plus the Number Of
Elements (21) does not exceed the tag’s defined size (73).
• Local_ENB is the name of the 1756-ENBx module in the local chassis (we
named ours “EIP” in section 8.2.3),
• 2 is the Ethernet port of the 1756-ENBx module in the local chassis, and
• target_IP_address is the IP address of the target node.
In our example, this path would be entered as “EIP,2,192.168.16.28”.
ii) If “Cache Connections” is enabled (checked), the connection remains open after
transmission. If disabled (unchecked), the connection is opened before and closed
76
after every transmission. For efficiency, it is recommended to enable “Cache
Connections”.
e) Click “OK” to close the MSG Configuration dialog. At this stage, MainRoutine should look like
Figure 101.
a) Double-click on the XIO element located to the left of the MSG block. In the drop-down box,
double-click on the “connection.EN” field. Refer to Figure 102. This configuration causes the
MSG instruction to automatically retrigger itself when it completes. While this is acceptable
for the purposes of this example, it can produce high network utilization. In actual practice, it
may be desirable to incorporate additional logic elements to allow triggering the MSG
instruction at a specific rate or under specific conditions.
a) To view the values of the function codes being read from the interface card, double-click
“Controller Tags” in the controller organizer view.
d) 21 function code values starting at function code M01 are being continuously read from the
interface card and placed in the 21 sequential offsets of data_array starting at the 50th offset
(data_array[50]). In Figure 104, we can see that data_array[50] (function code M01 / per-unit
frequency reference – final command) has a value of 11860 (11860/20000 = 59.3% of max
frequency), data_array[58] (function code M09 / output frequency) has a value of 3558
(35.58Hz), etc.
77
Figure 102: Configure XIO Element
78
8.2.9 ControlLogix Explicit Messaging Example: Read a Single Function Code
The configuration and execution for reading a single function code is in general identical to that required
for reading a block of function codes as detailed in section 8.2.8. The only difference is in the
configuration of the MSG instruction. Figure 105 shows an example MSG instruction’s Configuration tab,
which will read a single tag (function code M14, the inverter’s operation status register) and place it in
the first element (offset 0) of data_array.
The configuration and execution for implementing multiple MSG instructions is in general identical to that
required for implementing just one MSG instruction. Each MSG instruction will require its own message
controller tag. In the case of read MSG instructions, more than one instruction may use the same
Destination Element tag, but the storage locations must not overlap. Figure 106 shows an example of
two MSG instructions, each accessing different read tags. It is evident from this logic that
“rd_connection” and “rd_connection2” are the two independent message controller tags created for
these instructions.
79
8.2.11 ControlLogix Explicit Messaging Example: Reading and Writing
Often times, applications may need to both read data from and write data to the inverter. At a minimum,
this will require two MSG instructions and two message controller tags. Figure 107 shows an example of
three MSG instructions, one for reading and two for writing (the inverter’s frequency command and
operation command word). The only item of note that differentiates this example from the multiple-read
example in section 8.2.10 is the addition of the en_xx_wr XIC elements. The reason for the addition of
these elements is that while reading from a remote device is often continuously performed (monitoring),
data is typically written to the remote device only when necessary (i.e. when the value to write has
changed). This conserves both network bandwidth and potentially EEPROM lifespans on the target
device. The en_xx_wr elements in this example, therefore, would typically be replaced in an actual
application program by user-provided logic that controls the conditions under which write operations
would be performed.
Note that when writing data via explicit messaging, use caution to ensure that the commanded function
codes are not also simultaneously being commanded in the background via I/O messaging.
Indeterminate behavior can occur if MSG instructions and background I/O data transfers are both writing
to the same function codes. In other words, if the I/O messaging example procedure detailed in section
8.2.4 has already been implemented, and the same program is now being modified to implement explicit
messaging, then it is recommended to inhibit the target module by selecting the “Inhibit Module”
checkbox in the Connection tab of the Module Properties dialog.
80
8.3 Allen Bradley CSP
8.3.1 Overview
Ethernet-enabled Allen-Bradley legacy PLCs (such as the PLC5E and SLC-5/05 series) use a protocol
called CSP (Client Server Protocol) to communicate over the Ethernet network. The flavor of CSP used
by these PLCs is also known as “PCCC” (Programmable Controller Communication Commands) and
“AB Ethernet”. The interface card supports CSP for direct connectivity to these PLCs.
Since CSP relies on the use of EtherNet/IP class 3 messaging, timeout events also apply to CSP
connections. If a connection timeout or socket-level error occurs, the driver will trigger a timeout event as
described in section 5.5.3.
The formula to calculate which register (function code) is targeted in the interface card is provided in
Equation 7.
Refer to chapter 6 for converting function codes to register numbers. In Equation 7, “target register”
∈[1…4964], “file number” ∈[10…59] (which means N10…N59), and “offset” is restricted only by the
limitations of the programming software (but is a value of 4964 max). Table 12 provides some examples
of various combinations of file/section numbers and offsets/elements which can be used to access
inverter registers. Note that there are multiple different combinations of file/section numbers and
offsets/elements that will result in the same inverter register being accessed.
Table 12: CSP Target Register Examples
N10 2 2
N12 62 262
N27 98 1798
N59 64 4964
In addition to providing access to the inverter registers in their “standard” numerical locations as
mentioned above, the registers can also be accessed in a special “assembly object” type format by
targeting integer file N60. What this means is that when N60 is targeted for reading, what is actually
returned by the interface card is the user-defined register data as ordered by the EtherNet/IP produced
data configuration array (refer to section 5.6.4). Similarly, when N60 is targeted for writing, the written
data is disseminated to the inverter’s registers according to the definition contained in the EtherNet/IP
consumed data configuration array. By appropriate configuration of the EtherNet/IP consumed and
produced data configuration arrays, therefore, bulk access to non-contiguous but frequently-used
inverter registers can be conveniently provided by performing only one read and/or write instruction
targeting file N60.
Because both the EtherNet/IP consumed and produced register configuration arrays are comprised of
32 function code definitions, the targeted “offset/element” must be within the range of 0 to 31 inclusive.
Refer to Table 13 for some examples of N60 accesses.
81
Table 13: Examples of EtherNet/IP-Style Bulk Access via File N60
0 1st 32
: : :
th
15 16 16
: : :
nd
31 32 1
The application PLC program uses a MSG instruction that is configured with a “Data Table Address”
from which to start the access and a “Size in Elements” which determines the number of items to access
(read or write). The “Data Table Address” is constructed by selecting a “File/Section Number” and an
“Offset/Element” according to Equation 7. For example, a “File/Section Number” of N27 and
“Offset/Element” of 99 = N27:99, which corresponds to register 1799 (the inverter’s operation command
register, function code S06).
82
8.3.3 SLC-5/05 Example: Read a Register Block
This example program will show how to continuously read a block of registers from the inverter with a
single MSG instruction. Only one read request is outstanding at any given time.
b) Select the “XIO” instruction from the “Bit” classification, then click OK. Refer to Figure 112.
83
Figure 111: MSG Instruction Selection
a) Set the “Read/Write” field to “Read”, “Target Device” field to “PLC5”, “Local/Remote” field to
“Local”, and “Control Block” to “N20:0”.
b) Upon hitting the <ENTER> key while in the “Control Block” entry box, the MSG Properties
dialog box should appear (or it can be opened by clicking on the “Setup Screen” button at the
bottom of the MSG instruction). Refer to Figure 113.
c) In this example, we will be reading a total of 25 registers beginning at N30:50 (register 2050 /
function code M01). To configure this, under “This Controller” set the “Data Table Address”
field to N18:1, set the “Size in Elements field” to 25, and set the “Channel” field to 1
(Ethernet).
d) Under “Target Device”, set the “Data Table Address” field to N30:50 (starting target
register=2050) and set the “MultiHop” field to Yes to cause the “MultiHop” tab to appear.
e) Under the “MultiHop” tab settings, set the “To Address” in the first row to the inverter’s IP
address, and the “To Address” in the second row to 0. Refer to Figure 114.
f) Close the dialog box. At this point, the program should appear as shown in Figure 115.
84
Figure 113: MSG Configuration, "General" Tab
85
6) Assign a tag to the XIO element.
a) Double-click on the XIO element located to the left of the MSG block. Type in N20:0/15
(MSG instruction’s enable bit). This configuration causes the MSG instruction to
automatically retrigger itself when it completes. While this is acceptable for the purposes of
this example, it can produce high network utilization. In actual practice, it may be desirable to
incorporate additional logic elements to allow triggering the MSG instruction at a specific rate
or under specific conditions.
Figure 117: Monitoring the Data Being Read from the Inverter
86
Figure 118: Read the Inverter’s Output Frequency Register
The configuration and execution for implementing multiple MSG instructions is in general identical to that
required for implementing just one MSG instruction. Each MSG instruction will require its own message
control file. In the case of read MSG instructions, more than one instruction may use the same data file
to store the received register values, but the storage locations must not overlap. Figure 119 shows an
example of two MSG instructions, each accessing different target integer files. It is evident from this logic
that N20 and N21 are the two independent message control files created for these instructions.
87
8.3.6 SLC-5/05 Example: Reading and Writing
Often times, applications may need to both read data from and write data to the inverter. At a minimum,
this will require two MSG instructions and two message control files. Figure 120 shows an example of
two MSG instructions, one for reading and one for writing. Note that the “Read/Write” field of each of the
MSG instructions is set according to their function.
Figure 121 shows the configuration details of the “write” MSG instruction. Note that this instruction will
only be writing to one inverter register: namely, register 1798 (function code S05 / frequency command).
The source Data Table Address in this case is N18:30.
88
8.4 BACnet/IP
• The interface card supports the BACnet/IP (Annex J) protocol over Ethernet via UDP port 47808.
• The BACnet driver does not trigger timeout events (section 5.5.3).
Segmentation Capability:
None
89
LonTalk, (Clause 11), medium: ______
Other: ______
Is static device binding supported? (This is currently for two-way communication with MS/TP slaves and
certain other devise.) Yes No
Networking Options:
Datatypes Supported:
The following table summarizes the datatypes that are accepted (in the case of a write property service)
and returned (in the case of a read property service) when targeting the present value property of each
supported object type.
Service
Object Type
Read Property Write Property
Notes:
• The Null data type is used to relinquish a previously-commanded entry at the targeted priority in the
priority array.
• When writing to Binary Output objects, all non-zero values are interpreted as a “1”.
90
Object Types/Property Support Table
Table 14: BACnet Object Types /Properties Supported
Object Type
Property Binary Binary Analog Analog
Device
Input Output Input Output
Object Identifier R R R R R
Object Name R R R R R
Object Type R R R R R
System Status R
Vendor Name R
Vendor Identifier R
Model Name R
Firmware Revision R
Appl Software Revision R
Protocol Version R
Protocol Revision R
Services Supported R
Object Types Supported R
Object List R
Max APDU Length R
Segmentation Support R
APDU Timeout R
Number APDU Retries R
Max Master
Max Info Frames
Device Address Binding R
Database Revision R
Present Value R W R W
Status Flags R R R R
Event State R R R R
Reliability R R R R
Out-of-Service R R R R
Units R R
Priority Array R R
Relinquish Default R R
Polarity R R
Active Text R R
Inactive Text R R
R – readable using BACnet services
W – readable and writable using BACnet services
91
8.4.2 Supported Objects
Table 15: Binary Input Object Instance Summary
Active/
Instance ID Object Name Description
Inactive Text
92
Table 16: Binary Output Object Instance Summary
Active/
Instance ID Object Name Description
Inactive Text
93
8.4.3 Supported Object Details
94
9 TROUBLESHOOTING
Although by no means exhaustive, Table 19 provides possible causes behind some of the most common
errors experienced when using the interface card.
“MODULE STATUS”
LED is flashing red
with an “x-y-z” 3-
Firmware-
blink sequence. The Contact technical support for further assistance.
generated error
number of LED
flashes indicates an
error code.
Message on a web
XML socket TCP port 2000 is blocked by a firewall, router or some
server tab
connection failed other intermediate network equipment.
information window
Writing to command
Unable to control and frequency
the inverter via function Confirm that the applicable inverter function codes are
network codes/registers has set to allow network control (refer to section 3.1).
communications no apparent effect
on inverter operation
95
47520 Westinghouse Dr.
Fremont, CA 94539
Tel: 510.440.1060
Fax: 510.440.1063
http://www.fujielectric.com/fecoa/