background image

 

Real Time Automation, Inc. 

45 

1-800-249-1612 

 

 

 

 

 

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)

 

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 mapping.   

b)

 

String - This is the string where the data is being stored. 

Summary of Contents for 460MRSBMS

Page 1: ...Real Time Automation Inc 1 1 800 249 1612 Firmware Version 8 7 22 460MRSBMS NNA4 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: ... Default Method 20 Group by Data Type 20 Modbus RTU Slave Data Group Configuration Auto Configure 21 Modbus RTU Slave Data Group Configuration Manual Mode 22 Configure Read and Write Data Groups 23 BACnet MS TP Slave Configuration 24 BACnet MS TP Slave Configuration Data Groups 25 BACnet MS TP Slave Configuration Auto Configure Mode Default 26 BACnet MS TP Slave Configuration Manual Configure Mode...

Page 4: ...tion Triggering 49 Security Configuration 51 Security Configuration Security Levels 52 Security Log In 53 Security Log Out 53 Email Configuration 54 Alarm Configuration 55 Diagnostics Alarm Status 57 Alarms Active 57 Alarms Clear 58 Change of State COS Configuration 59 Diagnostics Info 60 Diagnostics Mapping 60 Diagnostics Modbus RTU Slave 61 Diagnostics BACnet MS TP Slave 64 LED Configuration 68 ...

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

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: ...ure the 460MRSBMS NNA4 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 NNA4 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: ...t 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 ...

Page 11: ...e under the DIN Rail 3 While pressing the 460MRSBMS NNA4 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: ... the RS485 network 4 Inactivity Timeout Amount of time the gateway will wait for a Read Write request before issuing a timeout 5 To enable data swapping select the required Swap Indicator If the bytes appear in the wrong order enable swapping to change the data This swapping does NOT change coils and their ordering inside the Bit Pack 6 Bit Pack Select the formatting of the Coil Status Input Statu...

Page 19: ...igure up to 100 data groups for both Read Write There are three ways to configure this protocol 1 Auto Configure Group by Device Default 2 Auto Configure Group by Data Type 3 Manual Mode NOTE You may go back and forth between modes but when reverting from Manual Mode to either of the two Auto Configure modes all changes made in Manual Mode will be discarded ...

Page 20: ...e other protocol on the gateway and auto configures the data groups on the Modbus RTU slave 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 Devic...

Page 21: ...Int or 32 Bit Uint matching signs whenever possible 4 Any 64 Bit Signed Unsigned data will be mapped as 4x Hold Reg 64 Bit Int or 64 Bit Uint matching signs whenever possible 5 Any 32 Bit Float will be mapped as 4x Hold Reg 32 Bit Float 6 Any 64 Bit Float will be mapped as 4x Hold Reg 64 Bit Float 7 Any String data types will be mapped as 4x Hold Reg String 8 The Read or Write direction depends on...

Page 22: ...e OK is clicked there are two options for how to proceed 3 To keep the data groups that are already configured press OK a You would want this option if you are adding additional data groups or you want to modify the data group s that already exist 4 To delete the data groups that are already there and start over press Cancel 5 Enter the number of Read Data Groups and or Write Data groups 6 Click t...

Page 23: ...tring Point Type If the mating protocol supports strings you may select string as a point type in Modbus With this point type 2 characters will be packed into a single register and the first register will be set aside for the length b 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 h...

Page 24: ...ater than the largest MAC ID on the MS TP network 5 Enter a unique Instance identifier for the gateway This value must be unique across the BACnet network 6 Inactivity Timeout Enter the amount of time in milliseconds the gateway should wait before a timeout state is declared If the BACnet MS TP master does not initiate communication within this time frame the BACnet MS TP LED will flash red and th...

Page 25: ... Data Type Default 2 Manual Configure Mode NOTE You may go back and forth between modes but when reverting from Manual Configure Mode to Auto Configure Mode all changes made in Manual Configure Mode will be discarded The setup in the example above will give you the following results 1 1 AI is created with the address of AI1 2 8 BIs are created with the addresses BI1 through BI8 3 500 AOs are creat...

Page 26: ...t Float data will be mapped as Analog Objects 2 Any Coils or 1 8 16 32 Bit Binary Packs will be mapped as Binary Objects 3 Any String Data Types will be mapped as CharacterString Value Objects 4 The input or output object direction depends on whether it is configured as a read or write on the other protocol 5 If the other protocol exceeds the number of analog binary or CharacterString value object...

Page 27: ...d object properties includes any default object names units and COV that are already configured press OK You would want this option if you are adding additional data groups or you want to modify the data group s that already exist ii To delete the current data groups and object properties includes any default object names units and COV that are already there and start over press Cancel 2 For each ...

Page 28: ...er slave devices the RTA gateway is monitoring and sending over to the Build Automation System BAS to monitor you can configure the group to represent each device The image above displays 1 device if there are 5 total devices then you can call Group 1 Basement Group 2 1st Floor Group 3 Roof Top etc 3 Enter a Name to identify this object on the network 4 The combination of Group and Name should be ...

Page 29: ...Configure Mode these fields are not configurable You MUST be in Manual Configure Mode Follow these steps to configure binary inputs or outputs in Manual Configure Mode 1 Select Binary Input or Binary Output from the upper left dropdown menu 2 Select a Group to use a These group names are defined on this page under the Group Name dropdown menu 3 Enter a Name to identify this object on the network T...

Page 30: ...e these fields are not configurable You MUST be in Manual Configure Mode Follow these steps to configure CharacterString value reads or writes in Manual Configure Mode 1 Select CharacterString Value Read or CharacterString Value Write from the upper left dropdown menu a Select a Group to use 2 These group names are defined on this page under the Group Name dropdown menu 3 Enter a Name to identify ...

Page 31: ...ble The Group Name is designed to be used when there are multiple BACnet objects that have the same name This is useful when you have multiple identical devices connected on the other protocol Follow these steps to configure the Group Names in Manual Configure Mode 1 Select Group Name from the upper left dropdown menu 2 For each Group Name used in the previous setup change the name to your desired...

Page 32: ...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 33: ...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 34: ...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 35: ...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 36: ...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 37: ...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 38: ...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 39: ...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 40: ...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 41: ...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 42: ...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 43: ...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 44: ...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 45: ...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 46: ...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 47: ...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 48: ... 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 49: ...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 50: ...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 51: ...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 52: ...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 53: ...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 54: ...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 55: ...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 56: ...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 57: ...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 58: ...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 59: ...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 60: ...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 61: ...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 2 Not Connected a The Modbus RTU master has not initiated communication to the gateway b The Modbus RTU master has not communicated to the gateway in x milliseconds where x is the inactivity timeout specified in the Modbus RTU Slav...

Page 62: ...a connection to the Modbus RTU master Variables 1 FC01 Read Coil Status Modbus Function Code 1 Number of Read Coil Status requests received 2 FC02 Read Input Status Modbus Function Code 2 Number of Read Input Status requests received 3 FC03 Read Holding Registers Modbus Function Code 3 Number of Read Holding Registers requests received 4 FC04 Read Input Registers Modbus Function Code 4 Number of R...

Page 63: ...Number of Write Multiple Holding Register requests received 9 FC23 Read Write 4X Register Modbus Function Code 23 Number of Read Write Holding Registers requests received 10 Successful Responses Received Total number of read write messages sent by the gateway 11 Error Responses Received Total number of read write errors sent by the gateway 12 Timeouts Total number of inactivity timeouts that have ...

Page 64: ...ed The gateway is connected to a BACnet MS TP master 2 Not Connected The gateway is not connected to a BACnet MS TP master 3 Error Timeout If the Inactivity Timeout is set to non zero the gateway has not received a read write request in the amount of time specified by the inactivity timeout LED Status 1 Good Communication Solid Green Connected to a BACnet MS TP master 2 Never Connected Blink Green...

Page 65: ...ster 7 Read Property Response Sent Number of Read Property responses sent to the BACnet MS TP master 8 Read Multiple Property Response Sent Number of Read Property Multiple responses sent to the BACnet MS TP master 9 Write Property Response Sent Number of Write Property responses sent to the BACnet MS TP master 10 Write Multiple Property Response Sent Number of Write Property Multiple responses se...

Page 66: ... format the message how the gateway is expecting d Parameter Out of Range The BACnet MS TP master is asking for information outside of the gateway s defined range 4 BMS Message Error XXXXX The gateway is sending an error message due to the listed explanation a Inconsistent parameters i The BACnet MS TP master tried to write a priority that was out of range or reserved Priority 6 and was rejected i...

Page 67: ...e not had previous communication with on the network l Timeout BACnet MS TP message timed out m Resources busy BACnet MS TP message cannot be processed right now n Segmentation not supported BACnet MS TP message is too large to send in one message o Service not supported The BACnet MS TP master tried to perform a service that the gateway does not support p Abort Other BACnet MS TP message is abort...

Page 68: ...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 69: ...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 70: ...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 71: ...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 72: ...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 73: ...stored in the Flash File System within the gateway Identify your device by clicking the Start Flashing LEDs button By clicking this button the two diagnostic LEDs will flash red and green Once you have identified which device you are working with click the button again to put the LEDs back into running mode Configure the size of the log through the Log Configuration Bring the device back to its la...

Reviews: