background image

 

Real Time Automation, Inc. 

27 

1-800-249-1612 

 

 

 

 

 

 

Example #3 - Parsing a message using the Parsing Delimiter option and Start Location and Length: 

In this example, we are s

eparating the fields in the string “12.25,SP100,temp setpoint” using the comma 

delimiter, the start, and length fields. The first value is being parsed from the 1

st

 character for a length of 

2 and stored into an integer data type. The second value is being parsed from the 3

rd

 character of the 

second comma-parsed field for the remainder of that field and stored into an integer data type. The 
third value is being parsed starting from the 1

st

 character of the third comma-parsed field for that entire 

field and stored into a string. All 3 fields need to be present for the message to be valid. The output is 
seen below: 

 

Summary of Contents for 460A

Page 1: ...Real Time Automation Inc 1 1 800 249 1612 Firmware Version 8 7 22 460A 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: ...Receive Data Operation Mode 19 Transmit Data 20 Transmit Data Triggering Methods 21 ASCII Configuration Technology Triggering Method 23 ASCII Configuration ASCII Parsing 25 ASCII Configuration ASCII Parsing Examples 26 ASCII Configuration ASCII Concatenating 28 ASCII Configuration ASCII Concatenating Examples 30 ASCII Configuration ASCII Message Counter 32 Mapping Transferring Data Between Devices...

Page 4: ...on Security Levels 53 Security Log In 54 Security Log Out 54 Email Configuration 55 Alarm Configuration 56 Diagnostics Alarm Status 58 Alarms Active 58 Alarms Clear 59 Change of State COS Configuration 60 Diagnostics Info 61 Diagnostics Mapping 61 Diagnostics ASCII 62 LED Configuration 67 Configuration Files 68 Export Configuration 68 Import Configuration 68 Save and Replace Configuration Using SD...

Page 5: ... 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 6: ... 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 7: ...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 8: ...Real Time Automation Inc 8 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 9: ... 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 10: ...nge under the DIN Rail 3 While pressing the 460A 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 11: ...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 12: ...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 13: ...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 14: ...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 15: ...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 16: ...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 17: ... new ASCII device 2 The Enable check box should be selected for the device 3 Port Select which port is being used for communication This port must be configured on the Port USB or TCP IP depending on your product Configuration page If it has not yet been configured it will not display in this dropdown 4 Enter a Device Label to identify the device within the gateway 5 LED Inactivity Timeout Enter t...

Page 18: ...age Length varies in size then use a timeout to call the message complete rather than message length You can also use End Delimiters below to call a message complete 4 Number of Start Delimiters Select the number of delimiters that the gateway should look for before the gateway processes the data 5 Select Start Delimiters Select the Start Delimiters that the gateway should look for 6 Number of End...

Page 19: ...radley PLC Next time the operator scans the same barcode HelloWorld The ASCII side gathers the data but the data didn t change so it will not be sent over to the ETC portion of the RTA gateway The operator scans 1234567890 with the barcode scanner The ASCII side of the RTA gateway will process the data and since the data has changed it will be sent over to ETC and sent over to the PLC Mark Data Ne...

Page 20: ...device 4 Delay Between Messages Enter the amount of time in ms that the gateway waits before verifying a Change of State of the ASCII message OR will start the Transmit Timeout 5 Number of Start Delimiters Select the number of delimiters that will be added onto the beginning of the ASCII string 6 Select Start Delimiters Select the Start Delimiters that should be added to the ASCII string 7 Number ...

Page 21: ...e s hello Send hello again nothing will happen because of the RTA Change of State Rule b Option 2 Technology Triggering A USB TCP WI This method is chosen if the Transmit Timeout field is left at 0 and the Trigger Variables as described in ASCII Configuration Technology Triggering Method section of this manual are mapped This will disable Change of State This method is recommended if your product ...

Page 22: ...gy Triggering Method section of this manual are also mapped Example 3 From the PLC send a message of hello based on whatever gets Triggered first the 3000ms Timeout or the Trigger data point the ASCII device will get updated If the Trigger data point is not updated the then the RTA gateway will send the data every x ms to the ASCII device See below for more examples in the ASCII Configuration Tech...

Page 23: ... but messages can still be sent via the Cyclic method if configured For more information on the ASCII Triggering Methods please see the Transmit Data Triggering Methods section of this user guide How the triggering method works The example shown below is our 460PS A TCP USB 1 The mating protocol sends a numbered value to the ASCII TransTrigger diagnostic variable This value must be different from ...

Page 24: ...ransTrigger is between 1 65534 AND the value IS equal to the TransHandshake diagnostic variable then no new message will transmit until Slot 12 0 triggers again RTA460 Display Data Example d If TransTrigger is between 1 65534 AND the value IS NOT equal to the TransHandshake diagnostic variable then a new message will be transmitted The value in TransTrigger will then be moved to TransHandshake TIA...

Page 25: ...rror will be flagged if the actual number of fields is less than this value 3 Parsing Delimiter This defines the delimiter that will be used to parse an ASCII message If delimiters are not present select UNUSED and use the length fields to parse the message 4 Start Location Length a If a Parsing Delimiter is used the Start Location will be the first character of the data field The Length will be t...

Page 26: ...In this example we are separating the fields in the string 12 25 SP100 temp setpoint using the start and length parameters The first value is being parsed from the 1st character for a length of 5 and stored into a float data type The second value is being parsed from the 7th character for a length of 5 characters and stored into a string data type The third value is being parsed starting from the ...

Page 27: ... value is being parsed from the 1st character for a length of 2 and stored into an integer data type The second value is being parsed from the 3rd character of the second comma parsed field for the remainder of that field and stored into an integer data type The third value is being parsed starting from the 1st character of the third comma parsed field for that entire field and stored into a strin...

Page 28: ... appear between each of the fields select UNUSED 3 Data Type Select the data type of the parsed value a Signed and Unsigned 8 16 32 64 Bit Integers b 32 64 Bit Floating Points c String in order to use a String data type must be selected in the other protocol Cannot concatenate an Integer to a String d Constant String 4 Internal Tag Name Constant Name a If Data Type other than Constant String is se...

Page 29: ...eroes Spaces or Nothing to the remaining character placeholders The padding will occur to the left of the value 8 Add Delim Used when a Concatenating Delimiter is selected Check to add the Concatenating Delimiter to the end of that field 9 Sample Result This will display an example of how the data will output This will not display live data It provides an example of the string structure NOTE Sampl...

Page 30: ...00A0 3 Field 3 32 bit int represented as Trans_Field03 It will output as an integer with a max of 10 characters padded with spaces and a comma will be added to the end of the value o EX ____123456 shown with _ s to see spaces 4 Field 4 32 bit float represented as Trans_Field04 It will output as a float with 2 decimal places with a max of 10 characters padded with zeros and a comma will be added to...

Page 31: ...th the following delimiters then a sample result is pictured below Example 1 Sample Result This use case is sending data via 5 PLC tags Using the Concatenating setup example and the Transmit example the ASCII data will display within your ASCII device shown as the example below ...

Page 32: ...ng the Data Mapping webpage It is mapped just like the Status_XY variable described in the Data Mapping Adding Diagnostic Information section of this user guide Example For this example the other protocol in the gateway is the Allen Bradley PLC As you can see from the picture below the RecvCount for ASCII Device 1 is mapped to the first index of a PLC tag array called test_cnt The data type of thi...

Page 33: ...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 34: ...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 35: ...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 36: ...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 37: ...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 38: ...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 39: ...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 40: ...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 41: ...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 42: ...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 43: ...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 44: ...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 45: ...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 46: ...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 47: ...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 48: ...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 49: ... 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 50: ...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 51: ...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 52: ...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 53: ...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 54: ...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 55: ...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 56: ...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 57: ...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 58: ...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 59: ...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 60: ...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 61: ...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 62: ...c 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 ASCII Port this will only clear the values for Port This will reduce the All ASCII values indirectly Clear Buffers T...

Page 63: ...configured b Verify the port configured matches the port enabled LED Status This is the Status for All ASCII or the specific ASCII device selected 1 Solid Green Connected The gateway is receiving transmitting data within the inactivity period for all the ASCII devices that are configured and enabled 2 Flashing Green Not Connected First Time Scan Start up state No messages have been received or tra...

Page 64: ... Msg Timeout to be less than what you currently have set 7 Successful Parsed Messages a Number of messages that are complete and have been successfully parsed 8 Failed Parsed Messages a Number of messages that are complete but have not been parsed successfully Status Strings These are the values for All ASCII or the ASCII device selected 1 Queued Messages a The gateway will hold up to 20 configura...

Page 65: ...mplete message the gateway received from the ASCII device processed and sent to the other protocol Next Message to Send from Queue 2 This is the next complete message that the gateway has already received and processed from the ASCII device and will be sent next to the other protocol Current Message being Received from ASCII 1 The current data that the gateway is receiving Data needs to hit one of...

Page 66: ... ASCII device Note The concatenated delimiters are not displayed in this message but will be transmitted with the message Send Data from Gateway to ASCII Used for testing only Character limit of 1024 1 Enter a message to send to your ASCII device 2 Can be used to test communication and test formatting of messages ...

Page 67: ...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 68: ...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 69: ...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 70: ...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 71: ...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 72: ...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: