Page 1
Proprietary RailFly Mark I Users Guide Revision: A04 Date: 01/10/2019 Copyright 2019 Convergent Communications, Inc. All Rights Reserved...
Page 2
Proprietary Copyright 2019 Convergent Communications, Inc.
Page 3
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: REVISION HISTORY Revision Primary Author(s) Description Date Completed Nathan Redden Draft 03/05/2012 David L. Hill Updated design, added warnings 04/04/2013 David L. Hill Minor text updates to warnings 08/05/2013 Nathan Redden...
1. OVERVIEW 1.1. URPOSE This document details the setup and use of the RailFly Mark I Wayside Information Unit (WIU), intended for use in reporting the status of rail switches in dark territory for Positive Train Control (PTC) operation. 1.2.
HMAC-SHA1 calculated using the configuration CRC-32 that is unique to that location. 5. The restriction of RailFly Mark I to monitor a single side of a switch at a location where there is no valid PTC route on the other side of the switch (e.g. intermediate location in...
Page 13
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Figure 1-2. Solar powered installation of RailFly. The RailFly system has the ability to enter a very low power state while not transmitting messages. In this state, the RailFly Sensor and Master consume 5mA of current at 12V. If a data radio with a sleep mode is used (e.g.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 2. WARNINGS This section details important warnings critical to the safe installation and operation of RailFly. 2.1. INGLE IDE OF WITCH IMITATION Warning! RailFly is limited to installation on a single side of a switch where the opposite side of the switch does not represent a more permissive route for the locomotive.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 2.6. ROPER CCEPTANCE ESTING EQUIRED URING NSTALLATION Warning! RailFly locations must be properly tested and verified during installation. WIU Address, CRC-32 and HMAC values are critical to safe operation of RailFly.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 3. QUICK START This section describes how to quickly setup and configure the RailFly Mark1 device. 3.1. OWER THE DEVICE Attach the power leads to a 9-16 VDC power source. If successful, the green LED on the front of the device will illuminate.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 3.7. ETURN EVICE TO PERATING Press and hold the button on the front of the Mark 1 device for more than 1 second, then release. If successful, the red LED will stop blinking and go out and the green LED will illuminate. The green LED may go out after a few seconds as the device enters low-power mode.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4. RAILFLY CONFIGURATOR The “RailFly Configurator” program is used in conjunction with the configuration dongle to setup and configure the RailFly Mark 1 device. It can also be used to convert old version 1 Configurator files to version 2 Configurator files.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.1. The File menu contains the options to save and retrieve RailFly configuration information as a file. Configuration files can be used to retain a copy of the configuration of a RailFly Mark 1 device externally to the device or to use to configure multiple devices that have similar configurations.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Figure 4-3. Save Menu. The Save Menu allows for the saving to a file of a Master or Sensor configuration. Only the correct Master or Sensor file type will be highlighted. Once Master or Sensor is selected, a file selection dialog box will be displayed to type in a save file name.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Figure 4-6. Export XML Entry Form. Time Stamp 4.1.4.1. The date and time of the creation of the schema file. Default: The time stamp of when the Export XML Schema menu option was clicked.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: WIU Name 4.1.4.3. A user defined text name to describe this sensor location. Default: “RailFly” followed by the sensor’s currently configured RailFly ID Beacon Flag 4.1.4.4. User entered Flag indicating whether the Master is configured to beacon continuously. The RailFly configuration dongle cannot configure 2 devices simultaneously, so the Master’s...
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Application Program CRC 4.1.4.9. This is the PTC application program CRC for configuration management use in hex format. Device Status Config SCAC 4.1.4.10. SCAC code for the railroad that this configuration table belongs to.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.2. ONNECTION Figure 4-7. Connection Menu. The Connection Menu allows for the selection of the Configuration Dongle by its assigned COM Port. The bolded COM ports are detected by the RailFly Configurator as valid Configuration Dongles.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.3. EBUG Figure 4-8. Debug Menu. Clicking on the Debug Menu displays the Debug Window. Clicking on the Debug Menu again will hide the Debug Window. The Debug Window displays communication data between the Configuration Dongle and the RailFly Mark 1 device that is being configured.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.4.1. Master Configuration Figure 4-9. Master Configuration. 4.4.1.1. Config File Path The full path to the loaded or saved template file of the Master configuration of the Mark 1 Device. This is a read-only field.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.4.1.3. Config File Timestamp The timestamp when the template file was last saved. This is a read-only field. 4.4.1.4. Config Name User defined name for this configuration in the template file.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Default: 1 Values: 1-253 4.4.1.11. Number to Poll Number of Sensors that are setup to communicate with the Master. Default: 1 Values: 1-8 4.4.1.12. Operating Mode The Operating Mode sets either Normal (Low Power) Mode, or Continuous Mode. See section 4.4.3 and 4.4.4 below for a full description of operation in these two modes.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: low power mode, the CNA will queue beacon requests. The Master will get the beacon requests when it wakes from low power mode after the duration of the sleep time.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.4.2. Sensor Configuration Figure 4-10. Sensor Configuration. 4.4.2.1. Config File Path The full path to the loaded or saved template file of the Sensor configuration of the Mark 1 Device. This is a read-only field.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.4.2.2. Config File Name The File Name of the loaded or saved template file of the Sensor configuration of the Mark 1 Device. This is a read-only field. 4.4.2.3. Config File Timestamp The timestamp when the template file was last saved.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Default: <Empty/Disabled> Values: Character string of a-z and 0-9 4.4.2.11. WIU Address This is the unique WIU Address sent in WIU Status (Beacon) messages from this Sensor to identify the message in the WIU network.
Page 34
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.4.3. Normal (Low Power) Mode In Normal Mode, beaconing only occurs when requested by the CNA. At the end of each Sleep Time, the Master awakes and checks with the CNA to determine if beaconing should begin. The Master will wait up to the Listen Time for a response from the CNA.
Page 36
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.4.4. Continuous Mode In continuous mode, all Sensors will beacon at the Beacon Rate. The beacon sent will have the TTL bit set, see Beacon Bit Time description above. The Listen Time is used by the Master to determine how often to request time updates from the CNA.
Page 38
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.4.5. Get Config The Get Config button must be clicked to read the configuration from a RailFly Mark 1 device. In order to read the configuration, the device must be in configuration mode. To set a device into configuration mode, press and hold the button on the device for more than 1 second and release.
Page 39
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.5. RACE Figure 4-13. Trace Tab. The Trace Tab allows for monitoring the communication between a Master and its Sensors on a given channel. 4.5.1. Start Trace/Stop Trace The Start Trace/Stop Trace button begins and ends a trace session.
Page 40
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.5.2. ||/> (Pause/Resume) The Pause/Resume button temporarily stops and restarts the trace session. 4.5.3. C (Clear) The Clear button deletes the trace data in the Trace Output window. 4.5.4. Raw mode Normally, the messages traced are decoded to show the RailFly ID of the source and destination as well as the message type.
Page 41
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: The RailFly ID of the message source. 4.5.6.1.6. Message Type The message type of the message. CHL – Challenge: Sent by Master to RailFly ID 255 (all Sensors) to begin the process of the Sensors generating a status message.
Page 42
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.6. OOPBACK Figure 4-14. Loopback Tab. The Loopback Tab allows for testing of Sensors by sending a series of test packets from the configuration dongle to the Sensor and waiting for a response back from the Sensor. Statistics are then calculated on the number of packets received.
Page 43
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.6.1. RailFly ID The RailFly ID of the Sensor to send the loopback packets from the configuration dongle. Default: 1 Values: 1-8 4.6.2. Packets Number of test packets to send to the Sensor.
Page 44
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 4.6.6.3. inDB Average RF Power in dBm of the packets received by the configuration dongle from the Sensor. 4.6.6.4. outQ Average link quality of the RF packets sent by the configuration dongle. A value of 127 means that the packet was lost.
Page 45
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Default: 5 Values: 1-10 4.7.3. Power The Power is the transmit power of the configuration dongle in dBm. The Power is only used in the Configuration and Loopback tabs. The Trace tab only listens to the communication between a Master and its Sensors and does not require the configuration dongle to transmit.
Page 46
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 5. RAILFLY KEYCRYPT RailFly KeyCrypt allows administrators to update the HMAC required by a RailFly Sensor. The HMAC can be saved in an encrypted form in a configuration file that can be imported by the RailFly Configurator to initialize or modify a Sensor’s HMAC, without revealing the...
Page 48
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 5.1.2. Configuration Area The area in the upper part of Figure 5-1 where various configuration values are shown. This is just below the Menu area and includes all entries down to the “Encrypt” button. Some values can be explicitly changed.
Page 49
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 5.3. ONFIGURATION 5.3.1. Key File Path The full path of the KeyCrypt file. This field is only set by the KeyCrypt application. 5.3.2. Key File Name The File Name of the KeyCrypt file. This field is only set by the KeyCrypt application.
Page 50
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Use File->Hide RC2 to make this invisible. This is a user defined RC2 Key used by some legacy tools to encrypt and decrypt the HMAC. The RC2 Key is also stored in an encrypted format in encrypted version 1 HMAC files using an internal AES encryption, and is decrypted by the RailFly Configurator before using it to decrypt the encrypted version 1 HMAC.
Page 51
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Master/ KeyCrypt Polling for status Sensors Request SSH Session Open SSH Session "sroute" command "sroute" response If got response Parse "sroute" response for display else Timed out, no response Show error message display no...
Page 52
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Master/ KeyCrypt Sensor Request SSH Session Open SSH Session SCP File Transfer Close SSH HCS Transfer KeyCrypt Done When Sensor comes online, update. If held more than timeout, delete request.
Page 53
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 5.4.4. Timeout secs The number of seconds before a “Send File” or “Refresh” times out. A longer timeout value might be required at some remote sites. 5.4.5. Send File This button sends the data displayed in the configuration area to the CNA defined by the communications area IP address, User ID, and Password.
Page 54
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 6.1. OWER The RailFly Master and Sensor are designed to be powered by 9-16 VDC. A transient voltage suppressor provides 60A of overcurrent protection. A voltage regulator capable of supplying 100mA converts the 9-16 VDC input voltage to a conditioned 3.3 VDC output.
Page 55
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 6.5. UTTON AND The RailFly hardware platform includes two LEDs, one red and one green, and a button. The red LED flashes when the unit is in configuration mode. The green LED is lit during operation and extinguished during low-power mode.
Page 56
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7. COMMUNICATIONS NETWORK ADAPTER (CNA) Figure 7-1. RailFly interface diagram. The CNA provides an interface with the ITC network and routes communication to the associated Masters and Sensors. It also provides timing signals from an attached GPS or from the ITC network.
Page 58
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Figure 7-3. Platform CNA1513 in CNA config utility SNMP Tab. 7.1.1. CNA id A read-only parameter that contains the protocol platform of the CNA. Default = 0x1513. 7.1.2. Version This read-only parameter specifies the software version of the CNA. If additions or changes to the parameter set are implemented, the version will change.
Page 59
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.3. Debug Provides the user a method to control the type (and amount) of diagnostic data for viewing and logging while performing maintenance and troubleshooting. The Debug value is entered as a hexadecimal byte with valid entry settings from 00 to FF. The value entered will "or"...
Page 60
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.5. Description Null-terminated text field for customer use. NOTE: The description parameter value must be surrounded by double quotes (“”). Values: Any string value between 0 and 63 characters. Default = ""...
Page 61
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: LAN 1 – Gateway 7.1.9. The IP address of the attached network’s router for the CNA’s Ethernet Port J5. NOTE: The CNA must be rebooted in before changes to this parameter will take effect.
Page 62
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.13. LAN 2 – Gateway The IP address of the attached network’s router for the CNA’s Ethernet Port J6. NOTE: The CNA must be rebooted in before changes to this parameter will take effect.
Page 63
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: NOTE: The CNA must be rebooted in before changes to this parameter will take effect. Default: LAN2 (J6) Values: LAN1 (J5), LAN2 (J6) 7.1.18. Use serial port When checked, communication occurs to a Master or an MDS radio attached directly to the J2-C serial port.
Page 64
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Default: 0.0.0.0 7.1.22. Target – Port This option is only available when the “Use serial port” box is unchecked. This is the UDP port of the MDS radio at the IP Address configured above.
Page 65
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.27. Keepalive time The Keepalive time is the amount of time in seconds to wait since the last Class D message before sending a Keepalive to the Class D server. If any Class D message has been sent or received, the Keepalive timer is reset.
Page 66
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.33. Class C IP Multicast IP address that the CNA listens for the Class C time messages. Default 239.255.0.5 7.1.34. Nak retries The number of times to retry sending a Class D message if a Class D Nak is received with an error code that allows for retries.
Page 67
3. Click on the Online menu and select the “Sensor Monitor…” option. 4. Click the Get Status button on the CCI RailFly sensor monitor Message box. The status will then be displayed for the sensor. If the sensor is active, the box will illuminate green.
Page 68
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.41. QOS EMP QOS value for beacons in response to a Get Status request. 7.1.42. Enable TELNET Enables or disables telnet access to the CNA. 7.1.43. VTERM 1 baud rate Sets baud rate for virtual terminal 1 on port J4-A NOTE: The CNA must be rebooted in before changes to this parameter will take effect.
Page 69
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.47. SNMP sysName The sysName parameter contains a user-defined, null-terminated text field. The maximum length of the field is 32 characters including the NULL character. NOTE: The CNA must be rebooted in before changes to this parameter will take effect.
Page 70
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: Default = 1000 priority The priority is a configurable integer to indicate the priority of the Heartbeat notification. Values: 0-255 Default = 1 (inform) period The Period is a configurable integer to indicate the expected period, in minutes, of the Heartbeat notification.
Page 71
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 7.1.52. SNMP Failed Login The SNMP Failed Login alarm sends notifications when there are three consecutive failed login attempts on the CNA. Parameters: enabled Enables or disables the Failed Login alarm.
Page 72
Proprietary Rev: RailFly Mark I Users Guide Page: Free run See section 13.4 CCI-CNA1513-MIB of the CNA2000 User Manual for a full description of the Time source Alarm format. Parameters: enabled Enables or disables the Time Source Change Alarm ...
Sensor has changed, or the HMAC update of a Sensor generated an error. Sensor ID, Sensor WIU Address, Sensor status, and HMAC UIDs are sent in the notification. See section 13.4 CCI-CNA1513-MIB of the CNA2000 User Manual for a full description of the Sensor Update Alarm format.
The Master Health Report Alarm indicates the health of a given master. Master Cluster ID, Master ID, and the (TBD health statistics) are sent in the notification. See section 13.4 CCI-CNA1513-MIB of the CNA2000 User Manual for a full description of the Master Health Report Alarm format.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 8. MDS SD4 RADIO The MDS SD4 radio extends the distance that wired serial communication can provide as well as allow for multiple Masters to be controlled by a single CNA1513. One radio, called the Access point, is connected directly to the CNA via a serial connection or the CNA1513 is configured with the UDP IP address and port of the radio.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: NOTE: It is recommended that the transmit and receive frequencies not be set to the same value. 8.1.1.2. Device Settings Figure 8-2. SD4 radio Configuration – Device Settings 8.1.1.2.1. Enable Sleep Configure this value to OFF for Access points and ON for Remote radios.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: 8.1.1.3.3. Time-to-live (s) The recommended value for time-to-live is 1. 8.1.2. Communication Ports Click on the Communication Ports menu underneath the Configuration tab in order to access the follow settings.
Date: 01/10/2019 Proprietary Rev: RailFly Mark I Users Guide Page: APPENDIX A: REFERENCES, DEFINITIONS, ACRONYMS, AND ABBREVIATIONS REFERENCED DOCUMENTS ITC PTC WIU Specification. MDS SD Series Technical Manual. A.2. DEFINITIONS, ACRONYMS, AND ABBREVIATIONS Association of American Railroads Advanced Encryption Standard...