RTA 460ETCBM-NNA1, Product User Manual

Page 1: ...1 Firmware Version 8 7 22 460ETCBM NNA1 Protocol Gateway Product User Guide ...

Page 2: ...sion or limitation of incidental or consequential damages therefore the limitations set forth in this agreement may not apply to you No patent liability is assumed by Real Time Automation with respect to use of information circuits equipment or software described in this manual Government End Users If this software is acquired by or on behalf of a unit or agency of the United States Government thi...

Page 3: ...adley PLC Configuration 18 External PLC Configuration 19 External PLC Configuration Auto Configure 20 Auto Configure Group by Device vs Auto Configure Group by Data Type 21 Group by Device Default Method 21 Group by Data Type 21 External PLC Configuration Manual Configure Mode 22 Configuring Read and Write Scan Lines 24 Access Program Scope Tags 27 Optimized Trigger Guide 28 BACNet MS TP Master Co...

Page 4: ...ion Triggering 52 Security Configuration 54 Security Configuration Security Levels 55 Security Log In 56 Security Log Out 56 Email Configuration 57 Alarm Configuration 58 Diagnostics Alarm Status 60 Alarms Active 60 Alarms Clear 61 Change of State COS Configuration 62 Diagnostics Info 63 Diagnostics Mapping 63 Diagnostics Allen Bradley PLC 64 Diagnostics BACnet MS TP Master 67 LED Configuration 71...

Page 5: ...Real Time Automation Inc 5 1 800 249 1612 Utilities 76 ...

Page 6: ... 7 4 9 1 20 Features Added 1 BMS BM DFM DS DM TCP USB PBS have been ported to the latest base software 2 TCP BMS BM now Available on N2E and N2EW hardware Platform 3 New ASCII Mode Available on TCP A USB WI protocols 4 User Guides updated with more examples Bug Fixes 1 Improved Data Mapping and String Mapping performance 2 Improved functionality performance on EC ETC ES MC MS BS BC A WI PS protoco...

Page 7: ...e to configure the 460ETCBM NNA1 gateway For further customization and advanced use please reference the appendices located on the CD or online at http www rtautomation com product 460 gateway support If at any time you need further assistance do not hesitate to call Real Time Automation support Support Hours are Monday Friday 8am 5pm CST Toll free 1 800 249 1612 Email support rtautomation com ...

Page 8: ...ch as LEDs For these sections be sure to identify the hardware platform you are using To find which hardware platform you are using 1 Look on the front or back label of the unit for the part number 2 On the webpage inside the gateway navigate to the dropdown menu under Other and select Utilities Click the Listing of Revisions button The full part number is displayed here Once you have the full par...

Page 9: ...Real Time Automation Inc 9 1 800 249 1612 Hardware NNA1 Powering the Gateway 1 Connect a 12 24 VDC power source to the gateway Red Wire Black Wire a The unit draws 175mA 12 V ...

Page 10: ... port specific parameters These settings must match the settings of the device s that you are connecting to Only 1 mode can be configured for this hardware Below are the wiring pinouts for each mode When you have completed your port configuration click the Save Parameters button RS232 pinouts RS485 pinouts ...

Page 11: ...e under the DIN Rail 3 While pressing the 460ETCBM NNA1 against the rail press up to engage the spring loaded lower clip and rotate the unit parallel to the DIN Rail 4 Release upward pressure Removing Follow these steps to remove your interface converter 1 Press up on unit to engage the spring loaded lower clip 2 Swing top of the unit away from DIN Rail DIN Rail Spring Loaded Lower Clip ...

Page 12: ...rogram from the CD ROM 3 Find unit under Select a Unit a Change Gateway s IP address to match that of your PC if DHCP has failed i You will know DHCP has failed if the gateway s IP address is AutoIP at 169 254 X Y ii If successful it will say DHCP d at ex 192 168 0 100 or however your DCHP Client is set up b If you do not see the gateway in this tool then your PC is most likely set up as a static ...

Page 13: ...efault Gateway 2 The gateway must be on the same Network Subnet as the PC whether it s setup for DHCP or Static Once you have both devices on the same network you should be able to ping the gateway using a MS DOS Command Prompt The Screenshot above shows a gateway that is currently set to a static IP Address of 192 168 0 100 If you are able to successfully ping your gateway open a browser and try ...

Page 14: ...ted after every change Multiple changes can be made before a restart but they will not be committed until the gateway is restarted When all desired changes have been made press the Restart Now button The webpage will redirect to our rebooting page shown below The reboot can take up to 20 seconds o If the IP address has not been modified the gateway will automatically redirect to the main page o If...

Page 15: ...bled Configuration cannot be changed during Running Mode If changes are needed click the Configuration Mode button shown in the green box below Configuring Mode Protocol communication is stopped and no data is transmitted Configuration is allowed Navigation green box below You can easily switch between modes and navigate between pages Configuration Diagnostics and Other pages using the buttons on ...

Page 16: ...vice Configuration The device configuration area is where you assign the device description parameter Changes can only be made when the gateway is in Configuration Mode Once you are done configuring the Description click the Save Parameters button ...

Page 17: ...e Once you are done configuring 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 After reboot you must enter the new IP Address into the URL It is recommended to leave the DNS Gateway set to 0 0 0 0 and the Ethernet Link as Auto Negotiate If configuring the gateway to use E mail ...

Page 18: ...hernet port only 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 4 Dependency Protocol If enabled th...

Page 19: ...al Mode will be discarded 1 To add additional PLCs click the Select dropdown under Allen Bradley PLC Device List and select Add Generic PLC option a To remove a device navigate to the server to delete using the and buttons and click the Delete PLC button b To create a new PLC with the same parameters already configured from another PLC click the Select dropdown and select the Add from PLC X option...

Page 20: ...ay 32 bit 7 Any String Data Types will be mapped as String If the PLC is a MicroLogix SLC or PLC5E the data will be configured according to the following rules 1 Any 8 Bit Signed Unsigned and 16 Bit Signed Unsigned data will be mapped as Int 2 Any 32 Bit Signed Unsigned 32 Bit Float and 64 Bit Float data will be mapped as Real 3 Any Coils or 1 8 16 32 Bit Binary Packs will be mapped as Bit Array 1...

Page 21: ...the other protocol on the gateway and auto configures the data groups on the Allen Bradley PLC for all the data points within the other protocol Another way to view this option is to say that the data points allocated are packed together so there is very little wasted data space The data is packed or optimized Example Protocol A is a master client protocol that has 2 devices with the same setup De...

Page 22: ...or you want to modify the scan line s that already exist 4 To delete the scan lines that are already there and start over press Cancel 5 To add additional PLCs click the Select dropdown under Allen Bradley PLC Device List and select Add Generic PLC option a To remove a device navigate to the server to delete using the and buttons and click the Delete PLC button b To create a new PLC with the same ...

Page 23: ...nly maintain a connection when there is data needed to be transferred then Unconnected UCMM will work best if you are only writing to the PLC Connected Class 3 Explicit messaging relies on reserved resources to transfer data to from the PLC Connected Class 3 Explicit messaging is recommended if you are reading and writing and always want to keep that connection open to the PLC 10 Enter an Optimize...

Page 24: ...ce and close the connection until a Change of State Leaving it at Connected messaging once we receive data the RTA gateway will constantly be writing to the PLC to maintain that connection a 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 i Example A tag called ReadTag has dimension of 100 in the PLC By default ...

Page 25: ...e to the gateway See the Scan Line Data Limit section at the bottom of the page for the given max values a If using a CompactLogix or ControlLogix below are the scan line data limits b If using a ControlLogix Rev 32 CompactLogix 5380 or ControlLogix 5580 below are the scan line limits c If using Micrologix PLC below are the scan line limits ...

Page 26: ...Real Time Automation Inc 26 1 800 249 1612 d If using a SLC 5 05 or PLC5E below are the scan line limits 5 Click the Save Parameters button 6 Repeat for the other direction if needed ...

Page 27: ... additional syntax If you are using a tag that is defined within Program Scope then the tag name inside of the RTA gateway needs additional syntax for it to successfully communicate Example AnotherTag is created in the Program Scope called AnotherProgram To access this Program Scope tag within the RTA 460 you must use the following syntax Tag Name PROGRAM ProgramName TagName where Program Name Sco...

Page 28: ...fore setting the Handshake value equal to Trigger value How does this work 1 Read ETC Optimized Trigger tag until Change of State a Value 0 Enabled but Not valid value b Value 65535 Disabled 2 Map the ETC Optimized Trigger Source over to ETC Trigger Dest 3 If ETC Trigger value changes states mark all ETC Read Scan Lines Invalid 4 Read all ETC Read Scan Lines until ALL source read data is valid 5 E...

Page 29: ...pdate the RTA_Opt_Trigger PLC tag to 1 7 Now your ASCII device will be updated with the data 8 Increment the RTA_Opt_Trigger PLC tag 9 Your ASCII device will get update again regardless if data is new or not If your product is a Web Interface e g 460ETCWI acting only as a Client 1 On the WI configuration page change the Update Method to be Triggered 2 In the Data Mapping page manually add 2 additi...

Page 30: ...ite Scan line that updates the PLC with the Handshake from the RTAgateway Handshake tag can be unique to your PLC program 3 Within the ETC configuration setup a PLC tag that you can identify as your Optimization Trigger Optimized Trigger tag can be unique to your PLC program 4 In the Data Mapping page manually add 2 additional mappings identical to the example below 5 Update all your Read Scan Lin...

Page 31: ...pdate your Read Scan Line tag with new data 12 Increment the RTA_Opt_Trigger PLC tag again 13 Now your ASCII device will be updated with the new data 14 In a working application the Handshake tag in your PLC should match the Optimization Trigger tag ...

Page 32: ...imum MAC ID that the gateway will communicate with on the BACnet MS TP network This value should be equal to or greater than the largest MAC ID on the MS TP Network The gateway cannot communicate with any MAC ID that is greater than the value entered in this field In an ideal network this should match the other devices on the BACnet MS TP network 5 Enter a Name Description and Location for the gat...

Page 33: ...and click the Delete Slave button d Click Save Parameters to save your changes before a restart or going to another configuration page 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 unique Instance that matches the slave If this value doesn t match the gateway will timeout 5 Bit Pack Select the formatting of the...

Page 34: ...acterString Value 3 Enter a Starting Object 4 Enter the of consecutive objects to read for that object type You can enter a value of 1 to 128 Configuring Writes Scan Lines Follow these steps to manually configure Write Scan Lines 1 Select View Write Scan Lines if not already selected 2 Select an Object Type for each Scan Line Options include Analog Output Analog Value Binary Output Binary Value Mu...

Page 35: ...teway will automatically take the string data type from one protocol and map it into the other See String Auto Configure section for more details Option 3 Manual Configure Mappings If you don t want to use the Auto Configure Mappings function you must use the manual mapping feature to configure translations Option 4 Manipulation Scaling You can customize your data by using math operations scaling ...

Page 36: ...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 Then select either the Protocol 1 to Protocol 2 or Protocol 2 to Protocol 1 button correlating to the direction you wish to see t...

Page 37: ...I3 on BACnet NOTE If a data point is mapped twice only the first instance of it will show here EX If Modbus 400001 400040 from Slave 1 are both mapped to AI1 only 400001 will show as being mapped to AI1 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 Th...

Page 38: ...view the actual data mappings click the Edit Mapping button For more details see the Data Mapping Explanation section To view the data mappings purely as text click the View as Text button For more details see the View Data Mapping as Text section ...

Page 39: ...ups from a string click the dropdown menu to generate the information regarding that device The string data will be displayed in both Hex and ASCII only the ASCII data is sent The example below shows data that is coming from the source device A group will be displayed for each Parsing Concatenating String field that is configured In the Group drop down Line1 is defined on the ASCII Device configur...

Page 40: ...s Info drop down and navigating to ASCII Diagnostics page You will also have to select the port you want to view in the dropdown below ASCII To view the string mappings click the Edit Mapping button For more details see the String Mapping Explanation section NOTE Only String data types can be mapped to another String data type To view the string mappings purely as text click the View as Text butto...

Page 41: ...ion would look like my example below There are more detailed examples of what all the fields represent in the ASCII Parsing section The message is broken up into 3 Groups or Parsing fields To view the Entire message click on the Diagnostic drop down select Diagnostics Info Select ASCII click view select your Port Whole data will be in the Last Message Sent Diagnostic box ...

Page 42: ...data type If the Auto Configure function does not map the data as you want or you want to add modify the mappings you may do so by going into Manual Configure mode The following are examples of the Auto Configure function 1 This example shows a common valid setup a Both Source values were able to be mapped to a corresponding Destination value 2 This example shows how Auto Configure will make its b...

Page 43: ...t then only 1 operation is allowed c Select the Operation s to perform i Math Operations are performed in the order they are selected ii If more than one point is selected on the source the Math Operations will be performed on every point d Enter the value s for the operation Example of Add similar for Subtract Multiple Divide and MOD This will add a value of 10 to the source field before it is wr...

Page 44: ...case In this example Ram0 is scaled into Ram1 Ram1 is then increased by 5 and stored into Ram2 Ram0 and Ram2 could be considered a source or destination group 2 Temporary Ram Double a This is like the Temporary Ram Int 64 except manipulations will be conducted against the 64bit floating point to allow for large data 3 Ticks Per Second a The gateway operates at 200 ticks per second This equates to ...

Page 45: ...ays to map the NetBmpStat Option 1 Map the whole 32bit value to a destination Example below shows the NetBmpStat is going to an Analog BACnet object Using a connection of 5 Modbus Slave devices AI1 will show a value of 31 0000 Open a calculator with programmer mode and type in 31 this will represent bits 0 4 are on This mean all 5 devices are connected and running If using an AB PLC with a Tag def...

Page 46: ...ault 0x80 7 128 nonrecoverable fault For this example the ETC Status is mapped to a PLC tag called PLC_Status Example ETC Status is 0x00000013 19 decimal here is the break down Hex Bit Decimal Explanation 0x01 0 on 1 if we are a Master Client 0x02 1 on 2 connected 0 not connected 0x10 4 on 16 running usually added to connected Total 0x13 19 External Faults 0x0000FF00 bit 8 15 2nd byte Hex Bit Posi...

Page 47: ...le fault config err 0x10 28 268 435 456 Configuration Mode 0x20 29 536 870 912 No Ethernet Cable Plugged In For this example the MC Status is mapped to a PLC tag called MC_Status Example MC Status is 0x00010041 65601 decimal here is the break down we know that bytes 1 and 3 are being used so here is the break down Common Status Hex Bit Decimal Explanation 0x01 0 on 1 if we are a Master Client 0x40...

Page 48: ...e 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 String This is the string used for this mapping 3 Destination Field green box above a Group Select the string data group you set up in the protocol config to use for this mappi...

Page 49: ...nual Configure Mode or click Cancel to remain in Auto Configure Mappings Mode Once OK is clicked there are 2 options on how to proceed from here 1 To keep the mappings that are already configured press OK a You would want this option if you are adding additional mappings or you want to modify the mapping s that already exist 2 To delete the mappings that are already there and start over press Canc...

Page 50: ...top of the Mapping Configuration page and select Auto Configure Mappings Click OK to proceed to delete all current mappings and go back to Auto Configure Mappings Mode Click Cancel to keep all mappings and remain in Manual Configure Mode NOTE Once you revert to Auto Configure Mapping Mode there is no way to recover the mappings you lost Any mappings you previously have added will be deleted as wel...

Page 51: ... at register 1 and want to see if 400011 is mapped If it is not in this text box then it is not mapped and no data will be transferred This is the text display for the example shown under the Data Mapping Adding Diagnostic Information section String Mapping 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 Mappi...

Page 52: ...hake value is set equal to Trigger value 5 Map Handshake to reference data point Note is an internal reference to the Server Slave number you are settings up ex RTA Server Slave products can only be Trigger 1 and Handshake 1 since we are only 1 device If RTA is a Master Client then you can have a Trigger for each server slave connected too How do you set this up In this example I m using a 460MCBS...

Page 53: ...appings 4 The first mapping is going to be the Data Validation Triggering AO21 will write to the RTA MC Trigger 1 will mark data invalid 5 The second mapping the MC Handshake will increment that all data is validated and write to AI21 all data is validated The value of AI40 and AO21 should be the same ...

Page 54: ...max of 32 characters case sensitive a Re enter the Password 4 E mail In case the password was forgotten a user can have their password e mailed to them if e mail was configured 5 Hint A helpful reminder of what the password is 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 n...

Page 55: ...y 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 ...

Page 56: ...sword This is used to reset security settings Confirm reset password must be selected to confirm this action Once confirmed there is a 15 minute window to do a hard reset of the gateway by physically removing and restoring power from the gateway Once power is restored you may navigate to the IP address of the gateway as normal Security Log Out Once a user is done with a session they may click logo...

Page 57: ...o use 2 SMTP Mail Password If authentication is required enter the SMTP Server s password Optional 3 SMTP Server Enter the Name of the SMTP Server or the IP Address of the Server 4 From E mail Enter the e mail that will show up as the sender 5 To E mail Enter the e mail that is to receive the e mail 6 E mail Group Choose a group for the user This is used in other web pages Click the Save Parameter...

Page 58: ...ection a Top dropdown select the Data Group This dropdown menu will contain all groups that go from the gateway to the network b Lower dropdown select the Data Point s Specific Point This is used to select which point in the group will be monitored for alarms 4 In the Set Error Section a Select the Set Error Operation in the top dropdown menu Available options are and Change of State COS This is t...

Page 59: ...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 This will make the alarm unique and will be available in the Alarm Status page as well as in the email generated by the alarm 7 Select an email to associate this alarm with When an alarm is set it sends an email When an alarm is cleared it will a...

Page 60: ...rm 7 Status The current status of the alarm either OK or ALARM 8 of Times Active This count represents the number of times this alarm has become active If an alarm is triggered this count will increment Alarms Active While one or more alarms are active every page will display Alarms Active at the top of the page This will no longer be displayed if all active alarms have been cleared When an alarm ...

Page 61: ...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 ...

Page 62: ...This is to be used to prevent jitter Default value is 0ms This timer takes priority over the Stale Data Timer There is a separate timer per data mapping This timer is active only after the first write goes out and the first COS event occurs 3 Writes Before Reads If multiple writes are queued execute of Writes Before Reads before the next read occurs Default is 10 and should fit most applications W...

Page 63: ...Alarm that was active Common Errors 1 Destination or Source Point does not exist a Solution Re map the mapping 2 Source or Destination Pointer too small a There is not enough space on either the Source or the Destination for the data you want to copy This is typically seen when the Destination is smaller than the amount of data being transferred to it 3 Range Discard Min or Max Value a The actual ...

Page 64: ...Clear All Values This will only affect displayed values 1 This will reset all displayed values back to zero and clear the Status Strings Example If viewing Allen Bradley PLC ETC01 10 1 100 18 this will only clear the values for that specific PLC This will reduce the All PLC s values indirectly otherwise select All PLCs to clear all devices Device Status This will only display when viewing All PLCs...

Page 65: ...ing connection can be determined from the Network Bitmap Status value 4 Communication not attempted yet Flashing Red Specific Server Only No reads are configured and data needed for writes isn t valid yet 5 Dependency Error Flashing Red The dependent protocol is missing causing the communication to go to inactive a The other protocol must be connected Variables These are the values for All PLCs or...

Page 66: ...LC to the gateway Common Error Strings These are the values for All PLCs or the specific PLC selected 1 IP xxx xxx xxx xxx tagname 04 Path Segment Error The tag name is wrong or the tag is not defined as a controller scope tag 2 IP xxx xxx xxx xxx tagname 08 Service Not Supported The IP address or the slot number does not match with the PLC the gateway is setup to communicate with 3 IP xxx xxx xxx...

Page 67: ...aves dropdown and clicking View Additional diagnostic information can be found by clicking the Help button NOTE This page will auto refresh every five seconds with the latest data Clear All Values This will only affect displayed values 1 This will reset all displayed values back to zero and clear the Status Strings Example If viewing BACnet MS TP Master Slave Address this will only clear the value...

Page 68: ...is the Status for All Slaves or the specific slave selected 1 Solid Green Connected The gateway is connected to all the BACnet MS TP slaves that are configured and enabled 2 Flashing Green Not Connected The gateway has never been connected to a BACnet MS TP slave that is configured and enabled a Verify BACnet MS TP settings and ensure that the Enable checkbox is checked for the appropriate device ...

Page 69: ...ed if the BACnet MS TP device does not support Write Property Multiple WPM 4 RD Prop Multiple Request Number of Read Property Multiple requests sent to the BACnet MS TP devices 5 WR Prop Multiple Request Number of Write Property Multiple requests sent to the BACnet MS TP devices 6 RD WR Response Success Number of successful read or write responses received This value should be equal to RD Single W...

Page 70: ... established d Read Access Denied BACnet MS TP read request cannot be processed e Unknown Obj The gateway tried to access an object the slave does not support f Unknown Property The gateway tried to access a property the slave does not support for that object type g Unsupported Object Type The gateway tried to access an object type the slave does not support h Value out of range BACnet MS TP messa...

Page 71: ...ocol is a master client you may set the LED to represent either all slaves servers configured in the gateway or a slave server device To select a slave server device 1 Select the protocol in the left dropdown menu 2 Click Save Parameters to generate the second dropdown menu 3 Select the individual slave server in the right dropdown menu Click the Save Parameters button to commit the changes and re...

Page 72: ...ther device into the 460 gateway whenever it is in Configuration Mode Upon clicking the Choose File button you will be prompted to select a location from which to load the saved file Once the location is selected you can choose the Import Network Settings checkbox if you want to load the network settings of the configuration file or just load the configuration without the network setting If you ch...

Page 73: ...ntered an error while trying to load the saved configuration the gateway will indicate the first error it found and a brief description about it under the Load Configuration button Contact RTA Support with a screenshot of this error to further troubleshoot ...

Page 74: ...ay you wish to copy the configuration from 2 Power up the gateway you wish to copy the configuration to DO NOT INSERT SD CARD YET 3 Navigate to the webpage inside the unit 4 Navigate to the dropdown Other Utilities 5 If you are not currently in Mode Configuration go into Configuration Mode by clicking the Configuration Mode button at the top left hand side of the screen 6 Press the Revert to Manuf...

Page 75: ...n on the hardware 1 On the side of the gateway with the SD card slot there is a small pinhole Using a paperclip press the button through this pinhole and hold the button for at least 5 seconds 2 After 5 seconds the unit will acknowledge the command and LED 1 and LED 2 will start an alternate Blink Green quickly pattern 3 Release the button and the gateway will reset to default IP settings DHCP ...

Page 76: ...h File System within the gateway Iden fy your device by clicking the Start Flashing LEDs bu on By clicking this bu on the two diagnos c LEDs will flash red and green Once you have iden fied which device you are working with click the bu on again to put the LEDs back into running mode Configure the size of the log through the Log Configura on Bring the device back to its last power up se ngs Bring the ...