460ETCMRS - Protocol Gateway Product User Guide Software Build Date: January 15th, 2015 Version 3 Real Time Automation, Inc.
Trademarks CompactLogix, ControlLogix, & PLC-5 are registered trademarks of Rockwell Automation, Inc. EtherNet/IP is a trademark of the ODVA. MicroLogix, RSLogix 500, and SLC are trademarks of Rockwell Automation, Inc. Microsoft, Windows, and Internet Explorer are registered trademarks of Microsoft Corporation. BACnet® is a registered trademark of American Society of Heating, Refrigerating and Air-Conditioning Engineers (ASHRAE).
Overview ....................................................................................................................................................... 5 Required Tools and Data ............................................................................................................................... 6 Powering The Gateway ................................................................................................................................. 7 Accessing the Main Page...................
Diagnostics – Alarm Status...................................................................................................................... 45 Alarms – Active ....................................................................................................................................... 45 Alarms – Clear ......................................................................................................................................... 46 Change of State (COS) Configuration .................
Overview The 460ETCMRS gateway connects up to 5 Allen Bradley PLC’s to a Modbus RTU Master device. By following this guide, you will be able to configure the 460ETCMRS gateway. You will set the gateway’s network settings, configure device specific parameters for initial operation, and integrate the device into your application. For further customization and advanced use, please reference the appendices located on the CD.
Required Tools and Data You will need the following tools: The gateway The provided CD-ROM o IPSetup.exe can also be downloaded: http://www.rtaautomation.com/product/460-gateway-support/ A PC with an internet browser o Browser configuration is Firefox / Internet Explorer / Google Chrome compatible The supplied Ethernet crossover cable A 7-30 VDC power source Real Time Automation, Inc.
Powering The Gateway The following steps will allow you to properly and safely power the gateway. Warning improper wiring will cause unit failure Use the Barrel Connector OR the Screw Terminals power connection, NOT both 1. Connect a 24VDC power source to the gateway. a. The unit draws 125 mA at 24VDC b. The gateway has a voltage operating range from 8-30VDC, 24VDC is recommended.
Accessing the Main Page The following steps will allow you to connect to the browser based configuration of the gateway. 1. Using the supplied crossover cable, connect the gateway to your PC. 2. Insert the provided CD-ROM. 3. Run the IPSetup.exe program from the CD-ROM. 4. Configure the IP Settings of the gateway to be on the same subnet as your PC. 5. Click Launch Webpage. The Main page should appear. Default IP Address is 192.168.0.100. Default Subnet is 255.255.255.0. Real Time Automation, Inc.
Error: Main Page Does Not Launch If the Main Page does not launch please verify the following: 1. Check that the PC is set for a Static IP Address a. Open a MS-DOS Command Prompt b. Type “ipconfig” and press enter c. Note the PC’s IP Address, Subnet, and Default Gateway i. An invalid IP Address would be: 169.254.x.x 2. The gateway must be on the same Network/Subnet as the PC Once you have both devices on the same network, you should be able to ping the gateway using a MSDOS Command Prompt.
Main Page The main page is where important information about your gateway and its connections are displayed. Mode (orange box below): Running Mode: - Protocol communications are enabled - Configuration cannot be changed during Running Mode.
Device Configuration The device configuration area is where you assign the device description, IP address, and other network parameters. Changes can only be made when the gateway is in Configuration Mode. Click the Edit button to make these changes. Once you are done configuring the Description and the Network Settings, click the Save Parameters button. If you are changing the IP Address of the gateway, the change will not take effect until the unit has been rebooted.
Port Configuration The Port Configuration page is where you set port specific parameters. These settings must match the settings of the device(s) that you are connecting to. When you have completed your port configuration, click the Save Parameters button. The default jumper configurations are setup for the following serial modes: Port 0 - RS485 Port 1 - RS232 If you require a different serial mode, please refer to the Hardware_Jumper_Configuration.pdf on the CD to make jumper changes.
Allen-Bradley PLC Configuration Click the Allen-Bradley PLC button to access the configuration page. 1) Delay Between Messages: Enter the length of time to delay between read and write scan line requests (ms). 2) Response Timeout: Enter the amount of time the gateway should wait before a timeout is issued for a read/write request (ms). 3) Delay Between Connect Attempts: Enter the amount of time the gateway should wait between attempts to connect to the PLC.
External PLC Configuration The bottom area of the Allen-Bradley PLC Configuration page lets you configure up to 5 PLCs. There are two ways to configure this protocol: • Auto-Server Mode(Default) • Manual Mode NOTE: You may go back and forth between modes, but when reverting from Manual Mode to AutoServer Mode, all changes made in Manual Mode will be discarded. Real Time Automation, Inc.
External PLC Configuration: Auto-Server Mode (Default) While in Auto-Server mode the # of scan lines and the actual scan lines themselves cannot be edited. Auto-Server Mode looks at the other protocol and then configures the Scan Lines within the PLC to match. The PLC Tag/File Names and Data Types will be defined after the other protocol is configured.
1. For additional PLC’s, click the Add PLC button and follow instructions under Manual Mode for each additional device. -Auto-Server Mode only affects PLC 1. 2. The Enable check box should be selected for the device. 3. Enter a Device Label to identify the device within the gateway. 4. Enter the IP Address of the PLC, the Controller Slot (Integrated Ethernet, use Slot 0), and select the PLC Type. The Controller Slot is the slot where the Controller is located, not the Ethernet Card being used.
External PLC Configuration: Manual Mode 1. Click the Edit Scan Lines button to switch from Auto-Server Mode to Manual Mode. Once clicked the button will read Auto-Configure PLC. The fields under the Scan Lines can now be edited. a. When prompted, click OK to confirm mode change or Cancel to remain in Auto Mode. b. Click OK again to keep current Scan Line settings or click Cancel to discard the current configuration. 2. For additional PLC’s, click the Add PLC button.
Configuring Read and Write Scan Lines Follow these steps to manually configure Read and Write Scan Lines. 1) Click the View Read Scan Lines or View Write Scan Lines button. 2) Enter the Tag/File Name that is set up within the PLC. This Tag/FileName must exist at the Controller Scope - not the Program Scope. -If you wish to start from a point other than the base, add [#] to the end of the Tag/File Name to specify which point is the starting point.
Modbus RTU Slave Configuration Click the Modbus RTU Slave button to access the configuration page. 1) Serial Port: Select which serial port is being used for communication. This port must be configured on the Port Configuration page. If it has not yet been configured, it will display Disabled after the Port descriptions in this dropdown. 2) Enter a Device Label to identify the device within the gateway.
Modbus RTU Slave Configuration-Data Groups The bottom area of the Modbus RTU Slave Configuration page lets you configure up to 100 Data Groups for both Read/Write. There are two ways to configure this protocol: • Auto-Slave Mode(Default) • Manual Mode NOTE: You may go back and forth between modes, but when reverting from Manual Mode to AutoSlave Mode, all changes made in Manual Mode will be discarded. Real Time Automation, Inc.
Modbus RTU Slave Data Group Configuration: Auto-Slave Mode (Default) While in Auto-Slave mode the # of data groups and the actual data groups themselves cannot be edited. Auto-Slave Mode looks at the other protocol and then configures the Data Groups to match. The Data Formats will be defined after the other protocol is configured. The data will be configured according to the following rules: • Any Coils, 8 Bit Signed/Unsigned, or 1/8/16/32 Bit Binary Packs data will be mapped as 0x Coil Status.
Modbus RTU Slave Data Group Configuration: Manual Mode 1. Click the Edit Data Groups button to switch from Auto-Slave Mode to Manual Mode. Once clicked the button will read Auto-Configure Slave. The fields under the Data Groups can now be edited. a. When prompted, click OK to confirm mode change or Cancel to remain in Auto Mode. b. Click OK again to keep current Data Group settings or click Cancel to discard the current configuration. 2. Enter the number of Read Data Groups and Write Data groups. 3.
EX: 4x Hold Reg (String) with a Starting Address of 1 for a length of 5 Registers This means that Register 1 will hold the length of the string and Registers 2-5 will hold the string contents. This string can contain a max of 8 characters. c. Enter a Starting Address (1-based). d. Enter the # of Points to write. This will allocate the number of the data type selected. Real Time Automation, Inc.
Mapping - Transferring Data between Devices There are 5 ways to move data from one protocol to the other. You can combine any of the following options to customize your gateway as needed. Option 1 – Data Auto-Map: The gateway will automatically take the data type (excluding strings) from one protocol and look for the same data type defined in the other protocol. If there isn’t a matching data type, the gateway will map the data to the largest available data type. See Data Auto-Map section for more details.
Display Mapping and Values The Display Data and Display String pages are where you can view the actual data for each mapping that is set up. Display Data Click the Display Data button to view how the data is mapped and what the values of each mapping are. Here you will see how each data point (excluding strings) is mapped. To view, select the device from the dropdown menu and click View to generate the information regarding that device.
If there are values of “- -“ on this page, it indicates that the source has not yet been validated and no data is being sent to the destination. The example below reflects the Modbus to PLC flow of data. The Modbus (right side) is the source and the PLC (left side) is the destination. • The 460 gateway has received valid responses from Modbus registers 400001-400005 and therefore can pass the data on to the PLC tag called MC2PLC_INT.
Display String Click the Display String button to view how the string data types are mapped and what the values of each string are. Here you will see how each string from each protocol is mapped to the other. To view, select the source or destination group and the String from the dropdown menu to generate the information regarding that device. The string data will be displayed in both hex and ASCII.
Data and String Mapping – Auto-Map The Auto-Map function looks at both of the protocols and will map the data between the two protocols as best as it can so that all data is mapped. Inputs of like data types will map to outputs of the other protocols like data types first. If a matching data type cannot be found, then the largest available data type will be used. Only when there is no other option is data truncated and mapped into a smaller data type.
Data Mapping – Explanation Below are the different parts that can be modified to make up a data mapping. 1. Enable (red box above): Check to enable mapping. If not checked, this mapping is skipped. 2. Source Field (yellow box above) : a. Group - Select the data group you set up in the protocol config to use for this mapping. b. Start - This is the starting point for this mapping. c. End - This is the final point to be included for this mapping. 3. Manipulation Area (green box above) : a.
Data Mapping – Adding Diagnostic Information Data Mapping offers 5 different types of information in addition to any scan lines specified for each protocol. IMPORTANT NOTE: Only add Diagnostic Information AFTER both sides of the gateway have been configured. If changes to either protocol are made after diagnostic information has been added to the mapping table, it is necessary to verify all mappings. Remapping may be necessary. 1. Temporary Ram (Int 64) a.
may be beneficial to know if a Server/Slave device is down. By using this Network Bitmap Status you can expose the connection statuses of individual devices. b. 0x00000002 shows that only device 2 is connected c. 0x00000003 shows that only devices 1 and 2 are connected d. 0x00000004 shows that only device 3 is connected 5. Status_XY a. There are two Statuses provided, one for each protocol. This gives access to the overall status of that Protocol.
Recoverable Faults: Hex: 0x01 0x02 0x00FF0000 (bit 16-23)3rd byte Bit Position: 16 17 Non-Recoverable Faults Hex: Bit Position: Decimal: Explanation: 65,536 131,072 recoverable fault - timed out recoverable fault - Slave err 0xFF000000 (bit 24-31)4th byte Decimal: 0x01 24 16,777,216 0x02 25 33,554,432 0x04 26 67,108,864 0x08 27 134,217,728 0x10 0x20 28 29 268,435,456 536,870,912 Explanation: nonrecoverable fault – task fatal err nonrecoverable fault – config missing nonrecoverable f
String Mapping – Explanation Below are the different parts that can be modified to make up a string mapping. String data types can only be mapped to other string data types. There is no manipulation that can be done on the string. 1. Enable (red box above): Check to enable mapping. If not checked, this mapping is skipped. 2. Source Field (yellow box above) : a. Group - Select the string data group you set up in the protocol config to use for this mapping. b.
Mapping – Auto-Map Mode to Manual-Map Mode To transition from Auto-Map mode to Manual-Map mode, click the Edit Mapping button. After you click this button, you will be prompted to confirm if this is really what you want to do. Click OK to proceed to Manual Map mode or click Cancel to remain in Auto-Map mode. There are 2 options on how to proceed from here. 1) To keep the mappings that are already configured press OK. a.
Mapping – Manual-Map Mode to Auto-Map Mode To transition from Manual-Map mode to Auto-Map mode, click the Auto Map Mode button. After you click this button, you will be prompted to confirm if this is really what you want to do. Click OK to proceed to delete all current mappings and go to Auto-Map mode. Click Cancel to keep all mappings and remain in Manual-Map mode. NOTE: Once you revert back to Auto-Map mode there is no way to recover the mappings you lost. Any mappings you added will be deleted as well.
View Data Mapping as Text The View as Text page displays the point to point mapping(s) you set up in the Data Mapping section. This will also display any manipulation(s) that are configured. Each line on this page will read as follows: Mapping number: source point Len: Number of points mapped -> manipulation (if blank then no manipulation) -> destination point If you are looking for a specific point to see if it is mapped, you can do a find in this text box for your point in question.
View String Mapping as Text The View as Text page displays the string mapping(s) you set up in the String Mapping section. Each line on this page will read as follows: Mapping number: source point -> Copy -> destination point If you are looking for a specific point to see if it is mapped, you can do a find in this text box for your point in question. Example: you defined 20 String Tags in the PLC and want to see if “Test_String” in the Logix PLC is mapped.
Security Configuration You can configure Security for 3 administrators, 5 users, and 1 guest. THIS IS NOT A TOTAL SECURITY FEATURE The security feature offers a way to password protect access to diagnostics and configuration on the network. The security feature does not protect against “Air Gap” threats. If the gateway can be physically accessed, security can be reset. All security can be disabled if physical contact can be made.
Security Configuration-Security Levels Each webpage in our gateway can have a separate security level associated with it for each user. Security Levels: 1. Full Access: Capability to view and configure a web page. 2. View Access: Capability to view a web page, but cannot configure parameters. 3. No Access: No capability of viewing the web page and page will be removed from Navigation. Real Time Automation, Inc.
Security - Log In Username: Name of the user to login. Password: Password of the user to login. Log In: If login is successful, the user will be redirected to the Main Page. Send Password to Email: Sends the specified User’s Password to the email configured for that user. Display Hint: Displays the hint specified for the User if one was set up. Reset Password: This is used to reset security settings. Confirm reset password must be selected to confirm this action.
Security - Log Out Once a user is done with a session they may click logout at the top of any page. The user may also be logged out for inactivity based off of the Log Out Timer specified during the configuration. Closing the browser is not sufficient to log out. Real Time Automation, Inc.
Email Configuration You can configure up to 10 email addresses. 1. 2. 3. 4. 5. 6. SMTP Mail Username: The email address that the smtp server has set up to use. SMTP Mail Password: If authentication is required, enter the smtp Server’s password (Optional). SMTP Server: Enter the Name of the SMTP Server or the IP Address of the Server. From E-mail: Enter the e-mail that will show up as the sender. To E-mail: Enter the e-mail that is to receive the e-mail. E-mail Group: Choose a group for the user.
Alarm Configuration 1. Alarm Delay upon Powerup: At Powerup, the gateway will have values of ‘0’ stored for all data. This may cause alarms to trigger before these values are updated by the mating protocols. Set this field to provide needed time to update fields before considering values for alarms. 2. Enter the number of alarms to configure and click Set Max # Alarms to generate those lines. 3. In the Data Point Section: a. Top dropdown: select the Data Group.
5. In the Clear Error Section: a. Select the Clear Error Operation. Available options are <, >, <=, >=, !=, ==, and Change of State (COS). This is the operation that will be used to compare the Data Point value against the Error Value to determine if the alarm needs to be cleared. b. Select the Clear Error Value. -Ex: Ticks Since Powerup >= 5000. This will clear the alarm after 5000 ticks have elapsed since the unit powered up. 6. Enter an Alarm Name.
Diagnostics – Alarm Status Alarm Status will only display under the Diagnostic menu tab if at least 1 Alarm is enabled. 1. # Alarms Enabled: This is a count of enabled alarms. 2. # Alarms Active: This is how many alarms are presently active (set). 3. Last Active Alarm: This is the last alarm that the gateway detected. 4. Clear # of Times Active: This will reset all alarms ‘# of Times Active’ to 0. 5. Alarm #: The reference number to the given alarm on the alarm setup page. 6. Name: The name of the alarm. 7.
Alarms – Clear When an alarm is cleared, the following will occur: 1. A one-time notification will be sent to the email associated with the alarm. a. For duplicate emails to occur, the alarm must become active and then be cleared again. 2. Total # Alarms Active will decrement. Last Active Alarm will not be changed. 3. Status of the Individual Alarm will be reset to OK. Real Time Automation, Inc.
Change of State (COS) Configuration The gateway, by default only writes when data has changed. The gateway also waits to write any data to the destination until the source protocol is successfully connected. Default values should fit most applications. Change these values with caution as they affect performance. 1. Stale Data Timer: If the data has not changed within the time allocated in this Stale Data Timer, the data will be marked as stale within the gateway and will force a write request to occur.
Diagnostics Info The Diagnostic page is where you will be able view the gateway’s translations and protocol specific status information. For protocol specific diagnostic information, refer to the next three pages. Diagnostics – Data and String Mapping The Diagnostics->Diagnostic Info->System section displays the number of translations that are enabled, for both Data and String data types, the number of mappings that have an error, and the first mapping that has an error.
Diagnostics – Allen-Bradley PLC Select the Allen-Bradley PLC in the dropdown menu on the Diagnostic page to view a breakdown of the diagnostics and common strings that are displayed on the page. You may also view individual counters by selecting the device in the All PLC’s dropdown menu and clicking View. Device Status - This will only display when viewing All PLC’s. 1. 2. 3. 4. Connected – The gateway is connected to all of the PLC’s that are configured and enabled.
LED Status - This is the Status for All PLC’s or the specific PLC selected. 1. Connected (Solid Green) – All of the enabled PLC devices are connected and running. 2. Not Connected (Flashing Green) – No PLC’s are enabled. a. Verify Allen-Bradley PLC settings and ensure that the Enable checkbox is checked for the appropriate device(s). 3. Connection Timeout (Flashing Red) – The gateway cannot open a connection to 1 or more of the enabled PLC’s. a.
Diagnostics – Modbus RTU Slave Select the Modbus RTU Slave in the dropdown menu on the Diagnostic page. Additional diagnostic information can be found by clicking on the Help button. Clear All Values - This will only affect Displayed Values. 1. This will return all values displayed to 0 and clear the status string. 2. If Viewing Modbus RTU Slave, this will only clear the values for the Modbus RTU Slave section of the gateway. Device Status 1. Connected - A Modbus RTU Master has a connection for the gateway.
Diagnostics – Modbus RTU Slave LED Status: 1. Good Communication (Solid Green) – The gateway is connected to a Modbus RTU Master and communicating as expected. 2. Not Connected (Flashing Green) – The gateway has never been connected to a Modbus RTU Master. 3. Fatal Error (Solid Red) – The port configured does not match the port configured within the Modbus RTU configuration page. 4. Connection Timeout (Flashing Red) – The gateway has lost a connection to the Modbus RTU Master. Variables: 1.
LED Configuration To modify the behavior of the LEDs on the 460 gateway, navigate to Other->Setup LEDs. The LED Configuration page lets you configure the LEDs on the gateway. Each LED may be set to Disabled, Protocol 1, or Protocol 2. If either Protocol is a Master/Client, you may set the LED to represent either all Slaves/Servers configured in our gateway or a particular Slave/Server device. To select a particular Slave/Server device: a) Select the protocol in the left dropdown menu.
Configuration Files To access the configuration files in the 460 gateway, navigate to other->Export/Import Config. Export Configuration The export tool allows you to save your gateway configuration for backup or to be exported into another gateway. This file is named rta_cfg.rtax by default. Network settings will not be saved in this configuration since they must be unique for each gateway. Upon clicking the Save Configuration to File button, you will be prompted to select a location to save the file.
Utilities The Utilities screen displays information about the gateway including Operation Time, File System Usage, Memory Usage, and Memory Block Usage. Here you can also: • • • • • • • View the Revisions of the Software for each Stack. View all of the Flash Files within the gateway. Identify your device by clicking the Start Flashing LED’s button. By clicking this button, the two diagnostic LED’s will flash red and green.
Completing the Installation You have now set up your gateway for communication and are ready to place the device in your application. Support for your device is available any time. Toll free: 800-249-1612 Email: support@rtaautomation.com Real Time Automation, Inc.