ProSoft Technology MVI69L-MBTCP User manual

MVI69L-MBTCP
CompactLogix™Platform
Modbus TCP/IP®Lite
Communication Module
March 11, 2022
USER MANUAL

MVI69L-MBTCP ♦ CompactLogix™ Platform Contents
Communication Module User Manual
ProSoft Technology, Inc. Page 2 of 139
Your Feedback Please
We always want you to feel that you made the right decision to use our products. If you have suggestions,
comments, compliments or complaints about our products, documentation, or support, please write or call
us.
How to Contact Us
ProSoft Technology, Inc.
[phone]
[phone] (Fax)
www.prosoft-technology.com
[email protected]
MVI69L-MBTCP User Manual
For public use.
March 11, 2022
ProSoft Technology®is a Registered Trademark of ProSoft Technology, Inc. All other brand or product
names are or may be trademarks of, and are used to identify products and services of, their respective
owners.
Content Disclaimer
This documentation is not intended as a substitute for and is not to be used for determining suitability or
reliability of these products for specific user applications. It is the duty of any such user or integrator to
perform the appropriate and complete risk analysis, evaluation and testing of the products with respect to
the relevant specific application or use thereof. Neither ProSoft Technology nor any of its affiliates or
subsidiaries shall be responsible or liable for misuse of the information contained herein. Information in this
document including illustrations, specifications and dimensions may contain technical inaccuracies or
typographical errors. ProSoft Technology makes no warranty or representation as to its accuracy and
assumes no liability for and reserves the right to correct such inaccuracies or errors at any time without
notice. If you have any suggestions for improvements or amendments or have found errors in this
publication, please notify us.
No part of this document may be reproduced in any form or by any means, electronic or mechanical,
including photocopying, without express written permission of ProSoft Technology. All pertinent state,
regional, and local safety regulations must be observed when installing and using this product. For reasons
of safety and to help ensure compliance with documented system data, only the manufacturer should
perform repairs to components. When devices are used for applications with technical safety requirements,
the relevant instructions must be followed. Failure to use ProSoft Technology software or approved software
with our hardware products may result in injury, harm, or improper operating results. Failure to observe this
information can result in injury or equipment damage.
Copyright © 2022 ProSoft Technology, Inc. All Rights Reserved.
For professional users in the European Union
If you wish to discard electrical and electronic equipment (EEE), please contact your dealer or
supplier for further information.
Prop 65 Warning –Cancer and Reproductive Harm –www.P65Warnings.ca.gov

MVI69L-MBTCP ♦ CompactLogix™ Platform Contents
Communication Module User Manual
ProSoft Technology, Inc. Page 3 of 139
Important Safety Information
North America Warnings
A This Equipment is Suitable For Use in Class I, Division 2, Groups A, B, C, D or Non-Hazardous
Locations Only.
B Warning –Explosion Hazard –Substitution of Any Components May Impair Suitability for Class I,
Division 2.
C Warning –Explosion Hazard –Do Not Disconnect Equipment Unless Power Has Been Switched Off Or
The Area is Known To Be Non-Hazardous.
D The subject devices are powered by a Switch Model Power Supply (SMPS) that has regulated output
voltage of 5 VDC.
ATEX Warnings and Conditions of Safe Usage:
Power, Input, and Output (I/O) wiring must be in accordance with the authority having jurisdiction
A Warning - Explosion Hazard - When in hazardous locations, turn off power before replacing or wiring
modules.
B Warning - Explosion Hazard - Do not disconnect equipment unless power has been switched off or the
area is known to be non-hazardous.
C These products are intended to be mounted in an IP54 enclosure. The devices shall provide external
means to prevent the rated voltage being exceeded by transient disturbances of more than 40%. This
device must be used only with ATEX certified backplanes.
DO NOT OPEN WHEN ENERGIZED
Agency Approvals & Certifications
Please visit our website: www.prosoft-technology.com

MVI69L-MBTCP ♦ CompactLogix™ Platform Contents
Communication Module User Manual
ProSoft Technology, Inc. Page 4 of 139
Contents
Your Feedback Please....................................................................................................................... 2
How to Contact Us.............................................................................................................................. 2
Important Safety Information.............................................................................................................. 3
1Start Here 7
1.1 System Requirements .............................................................................................. 7
1.2 Package Contents .................................................................................................... 8
1.3 Setup Jumper............................................................................................................ 8
1.4 Installing the Module in the Rack.............................................................................. 9
2Add-On Instruction 12
2.1 Installing ProSoft Configuration Builder.................................................................. 12
2.2 Generating the AOI (.L5X) File in ProSoft Configuration Builder ........................... 13
2.2.1 Creating a New Project in PCB............................................................................... 13
2.2.2 Exporting the .L5X File from PCB........................................................................... 15
2.3 Creating a New RSLogix 5000 Project................................................................... 17
2.4 Creating the Module in an RSLogix 5000 Project................................................... 18
2.4.1 Installing an Add-On Profile.................................................................................... 18
2.4.2 Creating a Module in the Project Using an Add-On Profile .................................... 20
2.4.3 Creating a Module in the Project Using a Generic 1769 Module Profile ................ 23
2.5 Importing the Add-On Instruction............................................................................ 26
2.6 Adding Multiple Modules in the Rack (Optional)..................................................... 29
2.6.1 Adding a New Module in PCB ................................................................................ 29
2.6.2 Adding a new module in RSLogix 5000.................................................................. 31
3MVI69L-MBTCP Configuration 37
3.1 Basic PCB Functions.............................................................................................. 37
3.1.1 Creating a New PCB Project and Exporting an .L5X File....................................... 37
3.1.2 Renaming PCB Objects.......................................................................................... 37
3.1.3 Editing Configuration Parameters........................................................................... 38
3.1.4 Printing a Configuration File ................................................................................... 40
3.2 Module Configuration Parameters.......................................................................... 41
3.2.1 Module.................................................................................................................... 41
3.2.2 MBTCP Servers...................................................................................................... 42
3.2.3 MBTCP Client x ...................................................................................................... 44
3.2.4 MBTCP Client x Commands................................................................................... 46
3.2.5 Ethernet 1 ............................................................................................................... 49
3.2.6 Static ARP Table .................................................................................................... 50
3.3 Downloading the Configuration File to the Processor ............................................ 51
3.4 Uploading the Configuration File from the Processor............................................. 54
4Backplane Data Exchange 57
4.1 Backplane Data Transfer........................................................................................ 58
4.2 Normal Data Transfer ............................................................................................. 59
4.2.1 Write Block: Request from the Processor to the Module........................................ 59
4.2.2 Read Block: Response from the Module to the Processor..................................... 59

MVI69L-MBTCP ♦ CompactLogix™ Platform Contents
Communication Module User Manual
ProSoft Technology, Inc. Page 5 of 139
4.2.3 Read and Write Block Transfer Sequences ........................................................... 60
4.3 Data Flow Between the Module and Processor ..................................................... 61
4.3.1 Server Driver Overview........................................................................................... 61
4.3.2 Client Driver Overview............................................................................................ 63
5Using Controller Tags 65
5.1 Controller Tags ....................................................................................................... 65
5.1.1 MVI69L-MBTCP Controller Tags............................................................................ 66
5.2 User-Defined Data Types (UDTs)........................................................................... 67
5.2.1 MVI69L-MBTCP User-Defined Data Types............................................................ 67
5.3 Controller Tag Overview......................................................................................... 69
5.3.1 MBTCP.CONFIG .................................................................................................... 69
5.3.2 MBTCP.DATA......................................................................................................... 69
5.3.3 MBTCP.CONTROL................................................................................................. 70
5.3.4 MBTCP.STATUS.................................................................................................... 75
5.3.5 MBTCP.UTIL........................................................................................................... 78
6Diagnostics and Troubleshooting 80
6.1 Ethernet LED Indicators.......................................................................................... 80
6.2 LED Status Indicators............................................................................................. 81
6.2.2 Troubleshooting the LEDs...................................................................................... 82
6.3 Connecting the PC to the Module's Ethernet Port.................................................. 83
6.3.1 Setting Up a Temporary IP Address....................................................................... 84
6.4 Connecting to the Diagnostics Menu in ProSoft Configuration Builder .................. 86
6.4.1 Diagnostics Menu ................................................................................................... 88
6.4.2 Monitoring General Information.............................................................................. 88
6.4.3 Monitoring Network Configuration Information....................................................... 89
6.4.4 Monitoring Backplane Status Information............................................................... 89
6.4.5 Modbus Server Driver Information.......................................................................... 90
6.4.6 Monitoring Data Values in the Module’s Database................................................. 91
6.4.7 Modbus Client Driver Information........................................................................... 91
6.5 Communication Error Codes .................................................................................. 92
6.5.1 Standard Modbus Protocol Exception Code Errors................................................ 92
6.5.2 Module Communication Error Codes ..................................................................... 92
6.5.3 Command List Entry Errors .................................................................................... 92
6.5.4 MBTCP Client-Specific Errors ................................................................................ 92
6.6 Connecting to the Module’s Webpage.................................................................... 93
7Reference 94
7.1 Product Specifications ............................................................................................ 94
7.1.1 General Specifications - Modbus Client/Server...................................................... 94
7.1.2 Hardware Specifications......................................................................................... 95
7.2 About the Modbus Protocol .................................................................................... 96
7.2.1 Modbus Client......................................................................................................... 96
7.2.2 Modbus Server........................................................................................................ 96
7.2.3 Commands Supported by the Module.................................................................... 97
7.2.4 Read Coil Status (Function Code 01)..................................................................... 98
7.2.5 Read Input Status (Function Code 02)................................................................... 99
7.2.6 Read Holding Registers (Function Code 03)........................................................ 100
7.2.7 Read Input Registers (Function Code 04)............................................................ 101
7.2.8 Force Single Coil (Function Code 05) .................................................................. 102

MVI69L-MBTCP ♦ CompactLogix™ Platform Contents
Communication Module User Manual
ProSoft Technology, Inc. Page 6 of 139
7.2.9 Preset Single Register (Function Code 06).......................................................... 103
7.2.10 Diagnostics (Function Code 08) ........................................................................... 104
7.2.11 Force Multiple Coils (Function Code 15) .............................................................. 106
7.2.12 Preset Multiple Registers (Function Code 16)...................................................... 107
7.3 Floating-Point Support.......................................................................................... 108
7.3.1 ENRON Floating-Point Support............................................................................ 109
7.3.2 Configuring Floating-Point Data Transfer............................................................. 109
7.4 Function Blocks..................................................................................................... 115
7.4.1 Event Command Blocks ....................................................................................... 116
7.4.2 Client Status Request/Response Blocks.............................................................. 117
7.4.3 Event Sequence Request Blocks ......................................................................... 118
7.4.4 Event Sequence Command Error Status Blocks.................................................. 119
7.4.5 Get Queue and Event Sequence Block Counts Block ......................................... 120
7.4.6 Command Control Blocks..................................................................................... 121
7.4.7 Add Event with Data for Client Blocks.................................................................. 122
7.4.8 Get Event with Data Status Block......................................................................... 123
7.4.9 Get General Module Status Data Block................................................................ 124
7.4.10 Set Driver and Command Active Bits Block ......................................................... 126
7.4.11 Get Driver and Command Active Bits Block......................................................... 127
7.4.12 Pass-through Formatted Block for Functions 6 and 16 with Word Data Block .... 128
7.4.13 Pass-through Formatted Block for Functions 6 and 16 with Float Data Block..... 129
7.4.14 Pass-through Formatted Block for Function 5...................................................... 130
7.4.15 Pass-through Formatted Block for Function 15.................................................... 131
7.4.16 Pass-through Formatted Block for Function 23.................................................... 132
7.4.17 Pass-through Block for Function 99 ..................................................................... 133
7.4.18 Set Module Time Using Received Time Block ..................................................... 134
7.4.19 Pass Module Time to Processor Block................................................................. 135
7.4.20 Reset Status Block ............................................................................................... 136
7.4.21 Warm-boot Control Block...................................................................................... 136
7.4.22 Cold-boot Control Block........................................................................................ 137
7.5 Ethernet Cable Connections................................................................................. 138
7.5.1 Ethernet Cable Specifications............................................................................... 138
7.5.2 Ethernet Performance........................................................................................... 138
8Support, Service & Warranty 139
8.1 Contacting Technical Support............................................................................... 139
8.2 Warranty Information ............................................................................................ 139

MVI69L-MBTCP ♦ CompactLogix™ Platform Start Here
Communication Module User Manual
ProSoft Technology, Inc. Page 7 of 139
1 Start Here
To get the most benefit from this User Manual, the user should have the following skills:
Rockwell Automation®RSLogix™ software: launch the program, configure ladder
logic, and transfer the ladder logic to the processor
Microsoft Windows: install and launch programs, execute menu commands,
navigate dialog boxes, and enter data
Hardware installation and wiring: install the module, and safely connect Modbus
and CompactLogix devices to a power source and to the MVI69L-MBTCP module’s
Ethernet port
1.1 System Requirements
The MVI69L-MBTCP module requires the following minimum hardware and software
components:
Rockwell Automation CompactLogix®processor (firmware version 10 or higher), with
compatible power supply, and one free slot in the rack for the MVI69L-MBTCP
module.
Important: The MVI69L-MBTCP module has a power supply distance rating of 4 (L43 and L45 installations
on first 2 slots of 1769 bus). It consumes 450 mA at 5 Vdc.
The module requires 450 mA of available 5 Vdc power
Rockwell Automation RSLogix 5000 programming software version 16 or higher
Rockwell Automation RSLinx®communication software version 2.51 or higher
ProSoft Configuration Builder (PCB) (included)
ProSoft Discovery Service (PDS) (included in PCB)
Pentium®II 450 MHz minimum. Pentium III 733 MHz (or better) recommended
Supported operating systems:
oMicrosoft Windows 10
oMicrosoft Windows 7 Professional (32-or 64-bit)
oMicrosoft Windows XP Professional with Service Pack 1 or 2
oMicrosoft Windows Vista
oMicrosoft Windows 2000 Professional with Service Pack 1, 2, or 3
oMicrosoft Windows Server 2003
128 Mbytes of RAM minimum, 256 Mbytes of RAM recommended
100 Mbytes of free hard disk space (or more based on application requirements)
Note: The Hardware and Operating System requirements in this list are the minimum recommended to
install and run software provided by ProSoft Technology®. Other third party applications may have different
minimum requirements. Refer to the documentation for any third party applications for system requirements.

MVI69L-MBTCP ♦ CompactLogix™ Platform Start Here
Communication Module User Manual
ProSoft Technology, Inc. Page 8 of 139
1.2 Package Contents
The following components are included with the MVI69L-MBTCP module, and are all
required for installation and configuration.
Important: Before beginning the installation, please verify all of the following items are present.
Qty.
Part Name
Part Number
Part Description
1
MVI69L-MBTCP
Module
MVI69L-MBTCP
Modbus communication module
1.3 Setup Jumper
The Setup Jumper acts as "write protection" for the module’s firmware. In "write
protected" mode, the Setup pins are not connected, and the module’s firmware cannot
be overwritten. The module is shipped with the Setup jumper OFF. If an update of the
firmware is needed, apply the Setup jumper to both pins.
The following illustration shows the MVI69L-MBTCP jumper configuration, with the Setup
Jumper OFF.

MVI69L-MBTCP ♦ CompactLogix™ Platform Start Here
Communication Module User Manual
ProSoft Technology, Inc. Page 9 of 139
1.4 Installing the Module in the Rack
Make sure the processor and power supply are installed and configured before installing
the MVI69L-MBTCP module. Refer to the Rockwell Automation product documentation
for installation instructions.
Warning: Please follow all safety instructions when installing this or any other electronic devices. Failure to
follow safety procedures could result in damage to hardware or data, or even serious injury or death to
personnel. Refer to the documentation for each device to be connected to verify that suitable safety
procedures are in place before installing or servicing the device.
After the jumper placements are verified, insert the MVI69L-MBTCP into the rack. Use
the same technique recommended by Rockwell Automation to remove and install
CompactLogix modules.
Warning: This module is not hot-swappable! Always remove power from the rack before inserting or
removing this module, or damage may result to the module, the processor, or other connected devices.
1 Align the module using the upper and lower tongue-and-groove slots with the
adjacent module and slide forward in the direction of the arrow.
2 Move the module back along the tongue-and-groove slots until the bus connectors
on the MVI69 module and the adjacent module line up with each other.

MVI69L-MBTCP ♦ CompactLogix™ Platform Start Here
Communication Module User Manual
ProSoft Technology, Inc. Page 10 of 139
3 Push the module’s bus lever back slightly to clear the positioning tab and move it
firmly to the left until it clicks. Ensure that it is locked firmly in place.
4 Close all DIN-rail latches.

MVI69L-MBTCP ♦ CompactLogix™ Platform Start Here
Communication Module User Manual
ProSoft Technology, Inc. Page 11 of 139
5 Press the DIN-rail mounting area of the controller against the DIN-rail. The latches
will momentarily open and lock into place.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 12 of 139
2 Add-On Instruction
The .L5X file contains the Add-On Instruction (AOI), user-defined data types, controller
tags and ladder logic required to configure the MVI69L-MBTCP module. This file is
generated by ProSoft Configuration Builder software and imported into RSLogix 5000.
2.1 Installing ProSoft Configuration Builder
The ProSoft Configuration Builder installation file can be found on the product at our
website: www.prosoft-technology.com. The filename contains the version of PCB. For
example, PCB_4.1.0.4.0206.exe
Copy the installation file to the local hard drive and run the PCB.exe file to start the
InstallShield Wizard. Follow the InstallShield Wizard to properly install PCB.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 13 of 139
2.2 Generating the AOI (.L5X) File in ProSoft Configuration Builder
The following sections describe the steps required to set up a new configuration project
in ProSoft Configuration Builder (PCB), and to export the .L5X file for the project.
2.2.1 Creating a New Project in PCB
To begin, start the PCB software.PCB’s window consists of a tree view on the left, and
an information pane and configuration pane on the right side of the window.
The tree view consists of folders for Default Project and Default Location, with a Default
Module in the Default Location folder. The following illustration shows the ProSoft
Configuration Builder window with a new project.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 14 of 139
To add the MVI69L-MBTCP module to the project
1 In the tree view, right-click DEFAULT MODULE. Select CHOOSE MODULE TYPE from the
shortcut menu. This action opens the Choose Module Type dialog box.
2 In the Product Line Filter area of the dialog box, click the MVI69L radio button. In the
Select Module Type dropdown list, select MVI69L-MBTCP,and click OK to save the
settings and return to the ProSoft Configuration Builder window.
3 The MVI69L-MBTCP module icon will now be visible in the tree view.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 15 of 139
2.2.2 Exporting the .L5X File from PCB
1 Expand the MVI69L-MBTCP icon by clicking the [+] symbol beside it. Similarly,
expand the icon. Double-click the Module icon to open the Edit -
Module dialog box.
2 Edit the Slot Number indicating where the module will be placed in the 1769 bus. The
Slot Number parameter in the PCB configuration affects the format of the .L5X file
that is exported. This parameter identifies the residing slot of the module in the
CompactLogix rack.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 16 of 139
3 Click OK to close the Edit –Module dialog box. The .L5X file is now ready to be
exported to the PC/Laptop.
4 Right-click the MVI69L-MBTCP icon in the project tree and select EXPORT AOI FILE.
5 Save the .L5X file to the PC/Laptop in an easily found location, such as Windows
Desktop.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 17 of 139
2.3 Creating a New RSLogix 5000 Project
1 Open the FILE menu, and select NEW.
2 Select the CompactLogix processer model.
3 Select REVISION 16 or newer.
4 Enter a name for the processor, such as My_Controller.
5 Select the CompactLogix chassis type.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 18 of 139
2.4 Creating the Module in an RSLogix 5000 Project
In an RSLogix 5000 project, an Add-On Profile (AOP) can be used to specifically identify
the MVI69L-MBTCP when selecting the type of module to be installed in slot x. Add-On
Profiles are supported in RSLogix 5000 version 15 and newer.
If using an AOP is not an option, please see page 23 to install the module using a
Generic 1769 Module profile.
2.4.1 Installing an Add-On Profile
1 Download the MPSetup.exe file from the product webpage onto the local hard drive.
Make sure RSLogix 5000 and RSLinx has been shut down before installing the AOP.
2 Run the MPSetup.exe file to start the Setup Wizard. Follow the Setup Wizard to
properly install the AOP.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 19 of 139
3 Continue to follow the steps in the wizard to complete the installation.
4 Click Finish when complete. The AOP is now installed in RSLogix 5000. There is no
need to reboot the PC.

MVI69L-MBTCP ♦ CompactLogix™ Platform Add-On Instruction
Communication Module User Manual
ProSoft Technology, Inc. Page 20 of 139
2.4.2 Creating a Module in the Project Using an Add-On Profile
1 In RSLogix 5000, expand the I/O CONFIGURATION folder in the Project tree. Right-
click the appropriate communications bus and select NEW MODULE from the shortcut
menu.
This action opens the Select Module Type dialog box. In the Module Type Vendor
Filters area, uncheck all boxes except the ProSoft Technology box. A list of
ProSoft Technology modules will appear below.