Home

User Manual - EndRun Technologies

1. gsysosctype gsyspasswd gsystimemode gsysversion ONE ae ee nn cas avs DD 27 Blank see 27 pluginopts RTM3204 GPS Timing Module User Manual upgradekernel 30 RS 232 Serial 1 0 Port Signal Definitions setgpscaldelay
2. setgpsdynmode setgpsrefpos setsigfltmask sigfitmask updaterootflag upgradegps HTTP Interface Description 32 EE SE 34 Receiver Oscillator Page
3. cpuoptsconfig gpscaldelay gpsdynmode gpsrefpos gpsstat gpstrkstat gpsversion gsyshwaddr
4. 55 Linux Operating System 55 Using Edit en thum a u ahua ua sS 56 ee cl 56 Disabling Protocols gt l n uu reset 57 Disable Telnet TIME and DAYTIME 57 DisableSNMPandHTIP 57 Os ds 58 ee 58 a ua asa 59 Timecode Formats 6l RIG BIZ ne E 61 ren ee 61 IEEE Standard 1344 1995 61 61 RTM3204 GPS Timing Module User Manual IEEE 1344 Bit Definition 62 Appendix F IPv6 Information 63 Enabling New IPv6 Capabilities 63 OpenSSH RE ER 63 aa ee 63 IPv6 Capable 00 64 IPv4 Only Protocols Zur En 64 Appendix G Third Party Software 65 GNU General Public License 65 Apache Software License
5. iii EndRun Contact Information iii Chapter One Introduction 1 yaaa ee 1 Overview a RE ee 1 Standard Features 2 2 eur ie dt 1 Secure Network Interface su sse ccc cc cece cece ee ee ee ee eee ence nennen nn 1 Free FLASH Upgrades 4 02 4244 ana a nn ne a na 1 GPS Timing How It Works 2 Whereto Bel ae tee EN ide 2 Chapter Two Basic Installation 3 Checking and Identifying the Hardware 3 Physical Description 4 Performing an Initial Site Survey 5 Installing the RTM3204 GPS Timing Module 6 Mount the RTM3204 GPS Timing Module 6 Connecting and Configuring Ethernet 7 Configuring Ethernet with the Serial Port 7 1 RS 232 Serial I O Port 7 Test the Serial Port 54 a na na 8 Using netconfig to Set Up Your IP 11
6. Al Upgrade Via The Network Serial Port 43 RTM3204 GPS Timing Module User Manual Performing the Linux Subsystem Upgrade 43 Recovering from a Failed Upgrade 44 Performing the Linux Kernel Upgrade 45 Performing the GPS Subsystem Upgrade 46 Problems with the GPS Subsystem Upgrade 47 Recover Commandi si re rer une es eh 48 Appendix Simple Network Management Protocol SNMP 49 SNMPv3 SEN 49 Enterprise Management Information Base MIB 49 Invocation of the SNMP daemon 50 Quick Start Configuration SNMPVI V2c 50 Change Default Community Strings Passwords 50 Configuring SNMPv1 Trap Generation 51 Configuring SNMPv2c Notifications and Informs 51 Configuration of SNMPv3 52 Disabling The SNMP 53 Appendix D
7. 70 Appendix Specifications 73 Special Modifications Changes for Customer Requirements 77 RTM3204 GPS Timing Module User Manual RTM3204 GPS Timing Module User Manual EndRun C SR TECHNOLOGIES Main Features ChapterOne Introduction The RTM3204 is a derivative of our standard product the Tycho GPS Frequency Reference As such the software operating system interface will contain references to Tycho GPS The RTM3204 GPS Timing Module includes 1 PPS 10M PPS and IRIG B as standard outputs plus an RS 232 serial port In addition a network port which includes many protocols including TELNET FTP DHCP SNMP HTTP and SSH is a standard feature The RTM3204 GPS Timing Module utilizes the GPS transmissions to precisely synchronize itself to Universal Coordinated Time UTC to the 100 nanoseconds level of accuracy The frequency of the internal oscillator is disciplined to match the frequency of the UTC timescale to better than 1 0 13 level of accuracy over 24 hour observation intervals The time and frequency outputs are coherent after initial GPS synchronization and synchronization is maintained via 20 bit DAC frequency con trol rather than phase stepping to provide excellent short term stability Overview The Timing Module is composed of a Global Positioning System GPS time and frequency engine integrated with an IBM PC compatible fanless c
8. D Page Descriptions Receiver Page Clock Page 1 0 Page CPU Options FORE ap RE TRS OAT suu 1 0 Page Plug In Options De tactician ce eile 0 US Pate I eae OD 37 37 37 Firmware Bogen une each Disabling The HTTP Protocol 38 Network Page Network IPv6 Page Network DNS Page Appendix Time Figure of Merit TFOM Appendix Upgrading the Firmware Al Upgrade Via The HTTP Interface
9. 6010 0041 000 Linux Kernel v2 4 26 1 0 Wed Aug 18 17 28 45 UTC 2004 BIOS provided physical RAM map BIOS 88 0000000000000000 000000000009 000 usable BIOS 88 0000000000100000 0000000002000000 usable 32MB LOWMEM available On node 0 totalpages 8192 zone 0 4096 pages zone 1 4096 pages zone 2 0 pages DMI not present Kernel command line config 11000001 initjffs 0 console ttyS0 19200 root dev mtdblock4 load_ramdisk 1 rw Initializing CPU 0 Calibrating delay loop 66 96 BogoMIPS Memory 30784k 32768k available 812k kernel code 1596k reserved 162k data 68k init 0k highmem Checking if this processor honours the WP bit even in supervisor mode Ok Dentry cache hash table entries 4096 order 3 32768 bytes Inode cache hash table entries 2048 order 2 16384 bytes Mount cache hash table entries 512 order 0 4096 bytes Buffer cache hash table entries 1024 order 0 4096 bytes Page cache hash table entries 8192 order 3 32768 bytes CPU AMD 486 DX 4 WB stepping 04 Checking hlt instruction OK POSIX conformance testing by UNIFIX PCI Using configuration type 1 PCI Probing PCI hardware 8 RTM3204 GPS Timing Module User Manual BASIC INSTALLATION PCI Probing PCI hardware bus 00 Linux NET4 0 for Linux 2 4 Based upon Swansea University Computer Society NET3 039 Initializing RT netlink socket Starting kswapd JFFS2 version 2 1 C 2001 Red Hat Inc designed by Ax
10. gpsstat This command allows the user to query the status of the GPS Subsystem During normal operation a Linux daemon SYSTIMED polls the GPS Subsystem every eight seconds The results of this poll are used to steer the system clock and are saved to a log file This command parses and formats the information contained therein and prints this fixed length string having these fields LKSTAT TFOM YEAR DOY HH MM SS sssssssss LS LF S N VCDAC C No FLTS Where LKSTAT isthe tracking status of the engine either LOCKED or NOTLKD TFOM A detailed explanation of TFOM is in Appendix A Time Figure of Merit Briefly TFOM indicates clock accuracy where 3 time error is lt 100 ns 4 time error is lt us 5 time error is lt 10 us 6 time error is lt 100 us 7 time error is lt 1 ms 8 time error is lt 10 ms 9 time error is gt 10 ms unsynchronized state if never locked to GPS YEAR is the year of the UTC timestamp of the most recent information received from the GPS Subsystem DOY is the day of year of the UTC timestamp of the most recent information received from the GPS Subsystem 21 RTM3204 GPS Timing Module User Manual CHAPTER THREE HH MM SS sssssssss is the hour minute second subsecond UTC timestamp of the most recent information received from the GPS Subsystem LS is the current number of leap seconds difference between the UTC and GPS timescales 13 at the time of this writing LF is the future at the
11. If you are using the RS 232 serial I O port to communicate with the RTM3204 you will be able to see the kernel generated boot messages when the unit reboots You should note the line Configuring eth0 as 192 168 1 245 if you have set up a static IP address or this line Attempting to configure eth0 by contacting a DHCP server if you are using DHCP It appears near the end of the kernel generated boot messages If you are using DHCP and are not using the RS 232 serial I O port you will have to check the DHCP configuration information maintained by your DHCP server to determine the expected IP address and log in to the RTM3204 Tycho using telnet or ssh to verify successful DHCP configuration Refer to the subsequent topics in this section Using Telnet and Using SSH for details on logging in to the RTM3204 that way Once you have logged in you may perform the following checks If you are not using DHCP the IP address shown should match the static IP address which you entered during the netconfig procedure If so log in as root at the login prompt and check the other configuration parameters using ifconfig Tycho GPS root gsys gt ifconfig etho Link encap Ethernet HWaddr 00 0E FE 00 00 34 inet addr 192 168 1 245 Bcast 192 168 1 247 Mask 255 255 255 248 UP BROADCAST RUNNING MULTICAST MTU 1500 Metric 1 RX packets 3779 errors 0 dropped 0 overruns 0 frame 0 TX packets 727 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 tx
12. You will then be prompted for the password which is endrun_1 and be granted root access to the system To leave super user mode issue the shell command exit Issuing exit again will close the telnet session Using SSH When establishing a ssh connection with your RTM3204 logging in directly as root is permitted When you log in as root via a ssh session with the RTM3204 this banner will be displayed EZ 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 202 Welcome to Tycho GPS SSH console on gsys your domain LE 2 2 k k k k k k k k k k k k k k k k k k 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 203 root gsys your domain s password Here you may log in as root with password endrun_1 After correctly entering the password the sign on message is shown It identifies the host system as Tycho and shows the software part number version and build date Tycho GPS 6010 0042 000 v 1 00 Fri Aug 20 14 17 44 UTC 2004 Tycho GPS root gsys gt This last line is the standard RTM3204 Tycho shell prompt The RTM3204 Tycho uses the bash shell which is the Linux standard full featured shell After configuring the unit you should change the passwords using the gsyspasswd command issued from the shell prompt Issuing exit will close the ssh session
13. RTM3204 GPS Timing Module User Manual 12 14 Kilian re Verify Network Configuration Check Network Operation A LS ae ee ae ee er Connecting Instruments to the RTM3204 16 apter Three Control and Status Commands 17 17 Available User Commands 10 General Linux Shell Operation Detailed Command Descriptions 19 accessconfiy RR 19 20 20 Me 20 20 2 2 23 23 24 24 24 24 gsystimemodeconfig 2D 25 EE EE ATIE RAE NANE TE EA Le cpuopis
14. You must also configure your terminal to use the correct baud rate number of data bits parity type and number of stop bits Be sure to turn off any hardware or software handshaking The settings for the RTM3204 are 19200 is the Baud Rate 8 is the number of Data Bits e None is the Parity 1 is the number of Stop Bits After configuring these parameters in your terminal apply power to the RTM3204 The RTM3204 is a derivative of our Tycho GPS Frequency Reference As such all the Linux scripts will contain references to the Tycho GPS After about 20 seconds your terminal should display a sequence of boot messages similar to these LE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 202 6010 0040 000 Linux Bootloader v1 00 08 17 2004 LE 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 202 Default root file system FACTORY To override and boot the UPGRADE partition type UPGRADE within 5 seconds These lines are the Linux bootloader boot prompt This prompt will timeout after 5 seconds and the Linux kernel and the factory default RTM3204 Tycho root file system will be loaded When the Linux kernel is loaded from FLASH memory into RAM a long list of kernel generated informational messages is displayed as the kernel begins execution and the various device drivers are initialized Booting Linux with FACTORY root file system
15. C Current Setting No Out Port D Current Setting No Out setantfltmask This command allows the user to enable or mask the GPS antenna fault Parameter for this command is either MASKED or ENABLED Setting this command to MASKED will prevent the antenna fault from creating an alarm condition Some installations may need to mask this fault due to special antenna situations like splitters or DC blocks that confuse the antenna detection circuit The factory default setting is ENABLED Set antfltmask MASKED RTM3204 Tycho response Antenna Fault Mask set to MASKED setgpscaldelay This command starts an interactive shell script that allows the user to change the clock calibration delay This setting is used to advance or retard the clock in order to compensate for antenna cable length or other external hardware Allowable range is 500000 to 500000 nanoseconds Set setgpscaldelay RTM3204 Tycho response Interactive shell script is started setgpsdynmode This command accepts a single argument ON or OFF to allow the user to set the dynamic mode of operation ofthe GPS Subsystem By default the unit is configured for static operation so this setting is OFF Ifthe RTM3204 will be mounted on a moving platform like a ship then this setting must be changed to ON The change takes place immediately and is stored non volatilely Set setgpsdynmode ON RTM3204 Tycho response GPS Dynamic Mode is ON setgpsrefpos This command starts an interactiv
16. GNU General Public License is intended to guarantee your freedom to share and change free software to make sure the software is free for all its users This General Public License applies to most of the Free Software Foundation s software and to any other program whose authors commit to using it Some other Free Software Foundation software is covered by the GNU Lesser General Public License instead You can apply it to your programs too When we speak of free software we are referring to freedom not price Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software and charge for this service if you wish that you receive source code or can get it if you want it that you can change the software or use pieces of it in new free programs and that you know you can do these things To protect your rights we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the 65 RTM3204 GPS Timing Module User Manual APPENDIX G recipients all the rights that you have You must make sure that they too receive or can get the source code And you must show them these terms so they know their rights We protect y
17. Tempus UPGRADE rootfs mtd Giving out device 5 to Tempus UPGRADE rootfs 0 00 0000 0 01000000 Tempus Hi BootLdr mtd Giving out device 6 to Tempus Hi BootLdr NET4 Linux TCP IP 1 0 for NET4 0 IP Protocols ICMP UDP TCP IGMP IP routing cache hash table of 512 buckets 4Kbytes TCP Hash tables configured established 2048 bind 2048 NET4 Unix domain sockets 1 0 SMP for Linux NET4 0 mtdblock_open ok RAMDISK Compressed image found at block 0 mtdblock_release ok VFS Mounted root ext2 filesystem Freeing unused kernel memory 68k freed INIT version 2 76 booting etce rc d rc S bin is a directory mtdblock_open ok mtdblock_open ok Loading GPS Fri Aug 20 00 53 54 2004 0 707128 seconds 2004 Setting system time using hwclock INIT Entering runlevel 3 9 RTM3204 GPS Timing Module User Manual CHAPTER TWO Entering multiuser Attempting to configure eth0 by contacting a DHCP server At this point if you do not have a DHCP server configured on your network the unit will time out and print these messages Tycho GPS DHCP Client was unable to find the DHCP Server Fix the problem and re boot or set up static IP address by running netconfig dnsdomainname Host name lookup failure none Then these messages are printed in either case Disabling IPv4 packet forwarding Starting daemons syslogd klogd inetd Starting the System Time daemon Starting the SNMP daemon Starting
18. are not IPv6 capable telnet client and server http ftp and dheped Due to their intrinsic insecurity telnet and ftp are repidly being deprecated and prob ably have little business running over an IPv6 network The address autoconfiguration capabilities of IPv6 make the DHCP protocol less important however it is likely that the new dhepv capability will appear in a future upgrade 64 RTM3204 GPS Timing Module User Manual EndRun C W TECHNOLOGIES GNU General Public License AppendixG Third Party Software The RTM3204 is running several different software products created and or maintained by open source projects Open source software comes with its own license These are printed out for your information below The license for the GNU software project requires that we provide you with a copy of all source code covered under the GNU Public License GPL at your request Please contact us with your request and we will mail it to you CD We will charge you a fee for our incurred expenses as allowed for in the license GNU GENERAL PUBLIC LICENSE Version 2 June 1991 Copyright C 1989 1991 Free Software Foundation Inc 51 Franklin Street Fifth Floor Boston MA 02110 1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed Preamble The licenses for most software are designed to take away your freedom to share and change it By contrast the
19. by a well designed receiver with a precision of a few nanoseconds The GPS time and frequency engine in the RTM3204 does just that Since signals from the GPS satellites are available at all locations on the globe you may deploy the RTM3204 GPS Timing Module virtually anywhere However you must be able to install an antenna with good sky visibility preferably on the rooftop Once continuously synchronized for at least 3 days the Timing Module can maintain microsecond level accuracy for about 24 hours without GPS reception by flywheeling on its Rubidium oscillator Rb If using the TCXO option this specifica tion is greatly reduced to the 10 millisecond level of accuracy 2 RTM3204 GPS Timing Module User Manual EndRun C W TECHNOLOGIES Checking and Identifying the Hardware Chapter Two Basic Installation This chapter will guide you through the most basic checkout and physical installation of your RTM3204 GPS Timing Module Subsequent chapters and appendices will give you the information needed to configure your installation for the maximum performance in your operating environment Though some familiarity with Linux or other Unix like operating systems would be helpful it is not essential When operating your Timing Module with its standard network interface basic familiarity with TCP IP networking protocols like ping telnet and tp is required Unpack and check all the items using the shipment packing list Contact the factor
20. come out and then press enter You will then see the come out every 3 seconds You then kill the previous cat command by entering kill You should see command prompt Now issue this command to re transfer the correct binary file upgradegps tmp 6010 0020 000_3 01 bin 48 RTM3204 GPS Timing Module User Manual EndRun C W TECHNOLOGIES SNMPv3 Security Enterprise Management Information Base MIB AppendixC Simple Network Management Protocol SNMP Your RTM3204 includes the NET SNMP version 5 3 1 implementation of an SNMP agent snmpd and a SNMP notification trap generation utility snmptrap It supports all versions of the protocol in use today SNMPv1 the original Internet standard SNMPv2c never reached standard status often called community SNMP and SNMPv3 the latest Internet standard The NET SNMP project has its roots in the Carnegie Mellon University SNMP implementation For more detailed information about the NET SNMP project and to obtain management software and detailed configuration information you can visit this website http www net snmp org An excellent book which describes operation and configuration of various SNMP managers and agents including the NET SNMP implementations is available from O Reilley amp Associates Essential SNMP Mauro amp Schmidt O Reilley amp Associates 2001 Ifyou are planning to operate with SNMPv3 it is highly recommended that you make use o
21. mode to binary get 6010 0020 000_3 01 bin transfer the file quit close the ftp session after the transfer If you are using ssh you may open another command window on the remote computer and securely transfer the GPS Subsystem image to the tmp directory using sep from the remote computer A command like this could be used scp p 6010 0020 000_3 01 bin root gsys your domain tmp Now issue the following command to the RTM3204 Tycho console to initiate the upload upgradegps tmp 6010 0020 000_3 01 bin This command is a script that performs the file transfer to the GPS engine It first tells the GPS en gine to enter the waiting for download mode and then prompts you with this line When you see the character hit lt enter gt to begin the upload Then it echos the serial port characters sent by the GPS engine to the console You should next see this message from the GPS engine Waiting for download using XMODEM 128 or XMODEM 1K both with CRC Control X will abort download After about 3 seconds you should see a capital C character appear When you do hit the lt enter gt key Now the script will initiate the XMODEM file transfer and display this message to the console Starting file upload should take about 90 seconds After about one minute you should see this message from the script sbin upgradegps line 26 27618 Terminated cat lt dev arm_user You should see the GPS sub system startup
22. never locked to GPS RTM3204 GPS Timing Module User Manual Enabling New IPv6 Capabilities EndRun DES ON TECHNOLOGIES AppendixF 1Pv6 Information EndRun Technologies understands that IPv6 is still in the experimental stage with essentially no mainstream deployment Customers who are not interested in IPv6 need not burden your system with it You have a choice of an IPv4 only kernel recommended or the IPv4 IPv6 kernel You may freely change this at any time with an easy software download from our website To determine which kernel resides in your RTM3204 Tycho check the firmware version using console port command cat proc version An IPv4 only kernel will have a part number and version similar to 6010 0041 000 ver 2 4 31 IPv4 An IPv4 IPv6 kernel will have a part number and version similar to 6010 0041 100 ver 2 4 31 IPv6 If you want to change your kernel please refer to Appendix B Upgrading The Firmware for instruc tions The following text refers to products with the IPv4 IPv6 kernel The presence of an IPv6 capable kernel will automatically enable most of the new IPv6 capabilities By default autoconfiguration of the ethernet interface via IPv6 Router Advertisements is enabled To disable acceptance of Router Advertisements or to configure a static IPv6 address and default IPv6 gateway you must run the interactive netconfig script This will allow you to configure your ethernet interface for both IPv4 and IPv6 operat
23. next UTC midnight number of leap seconds difference between the UTC and GPS timescales 13 at the time of this writing S is the Signal Processor State one of 0 Acquiring 1 GPS Locking 2 GPS Locked N is the number of GPS satellites being tracked 0 to 8 VCDAC _ is the 20 bit oscillator Voltage Control DAC word 0 to 1048575 with larger numbers implying higher oscillator frequency Typical range is 320000 to 640000 C No is the Carrier Signal to Noise Ratio 0 00 to 99 9 measured in dB in the GPS data rate bandwidth Typical range is 30 to 45 FLTS is the fault status which displays the current summary status of the GPS Subsystem The summary status is contained in sixteen bits which are displayed in four hexadecimal characters Assertion of any of these bits will also be indicated by illumination of the red LED Each bit of each character indicates the status of a subsystem component HE Jes z sr Jeo Char 0 FLASH Write FPGA Config No Signal DAC Control Fault Fault Time Out Over Range No Polling Events Time Input Fault GPS Comm Fault DAC Control Over Range This bit indicates that the electronic frequency control DAC for the oscillator has reached either the high 55000 or low 10000 limit while locked to the GPS sig nal Unless the unit is being subjected to out of specification environmental conditions this would indicate that the oscillator frequency has drifted near to the end of life region This
24. proper ownership and access permissions by using cp p when copying the files To control access via HTTP the user must edit the etc apache httpd conf file and add the equivalent deny followed by allow directives For example the default file contains these lines Controls who can get stuff from this server Order allow deny Allow from all lt Directory gt To restrict access to a specific host with IP address xxx xxx xxx xxx you would modify the directives as so Controls who can get stuff from this server Order allow deny Deny from all Allow from xxx xxx xxx xxx lt Directory gt You may completely disable any of the following protocols Telnet TIME DAYTIME SSH SNMP and HTTP Disable Telnet TIME and DAYTIME To disable Telnet TIME and DAYTIME use the inetdconfig command inetdconfig modi fies the etc inetd conf file which is read by inetd to start up various protocol server daemons when requests from remote hosts are received Currently three servers are configurable via inetdcon fig TIME and DAYTIME whose daemons are contained within the inetd daemon itself and in telnetd Any one or all of these may be enabled or disabled for start up Disable SNMP and HTTP To disable SNMP and HTTP edit a system start up script called etc rc d rc local This script starts several of the daemons running on the system You should follow the instructions contained in com ments in the file for disabling the snmpd
25. single argument passed on the command line the path to the previously uploaded kernel image file For example upgradekernel tmp 6010 0041 100 bzimage The kernel upgrade utility verifies the integrity of the file reads the kernel version information pres ents it to you and asks you to verify before replacing the old kernel image If you verify it will then erase the old image and write the new one in its place The erase and write operation takes about 10 seconds A power failure during the kernel erase and write operation would render your unit unbootable It is highly advisable to plug your unit into a UPS while performing the kernel upgrade 45 RTM3204 GPS Timing Module User Manual APPENDIX B Performing the GPS Subsystem Upgrade To perform this upgrade log in as the root user to the RTM3204 Tycho using either the local console serial I O port telnet or ssh and perform these operations Change the working directory to the tmp directory cd tmp If you are using tp to perform the upgrade transfer the previously downloaded file using binary transfer mode from the remote host to the working directory 4mp The GPS Subsystem image will be named with the software part number and version like 60 0 0020 000_3 01 bin When following the instructions below substitute the name of the actual GPS Subsystem image that you are installing for 6010 0020 000_3 01 bin ftp remote_host perform ftp login on remote host bin set transfer
26. stored on the system IMPORTANT To generate new keys stop the snmpa process delete the existing usmUser key lines from the file boot net snmp snmpd conf and then add new createuser lines Then reboot the system This example gives the simplest configuration to begin using SNMPv3 but doesn t make use of the full capabilities of the VACM in defining groups and views for fine grained access control The fac tory default etc snmpd conf file contains commented blocks of lines that can be uncommented to give you a basic configuration that uses the User based Security Model USM described in RFC 2274 and the View based Access Control Model VACM described in RFC 2275 The comments included in the file should help you in modifying it for your specific requirements To disable SNMP you need to edit a system start up script called etc rc d rc local This script starts several daemons You can either remove the line that lists SNMP or you can place a character at the beginning of the line so that it will not be executed A very compact editor is available on the Unison system called edit If you start edit without giving it a file name to open it will display its help screen showing all supported editing keystrokes IMPORTANT After editing ete re d re ocal you must it to the boot ete re d directory and reboot the system It is very important to retain the access mode for the file so be sure to use cp p when performing the cop
27. the standalone daemons snmpd and sshd to determine whether or not to grant access to a requesting host etc hosts allow and etc hosts deny These two files may contain configuration information for a number of protocol servers but in the RTM3204 Tycho only access control to the protocol server daemons in telnetd sshd and snmpd is configured As shipped from the factory these two files are empty When the user runs accessconfig these lines are added to the etc hosts deny file in telnetd ALL sshd ALL snmpd ALL This tells tepd to deny access to in telnetd and sshd to all hosts not listed in the etc hosts allow file The snmpd and sshd daemons also parse this file prior to granting access to a requesting host Then the user is prompted to enter a list of hosts that will be granted access to in telnetd sshd and snmpd These appear in the etc hosts allow as lines like this 5 0 RTM3204 GPS Timing Module User Manual Disabling Protocols SECURITY in telnetd 192 168 1 2 192 168 1 3 sshd 192 168 1 2 192 168 1 3 snmpd 192 168 1 2 192 168 1 3 This simple shell script handles the needs of most users however the syntax of these two files sup ports elaborate configuration possibilities which are beyond the capabilites of this simple shell script Advanced users who need these capabilities will need to edit these two files directly and then copy them to the boot etc directory See Using Edit above Be careful to maintain the
28. the system logfile manager Starting the system watchdog woof During this process the factory default TychoGPS_0 root file system is loaded from FLASH disk to an 16MB ramdisk and the remainder of the boot process completes At this point the RTM3204 Tycho login prompt is displayed 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 202 s Welcome to Tycho GPS console on gsys your domain Tue Feb 20 2001 21 47 03 UTC IRR He e e IRR k k K IR e e He Fe Fe REI REI REI REIKI REI He He He He e He He He KOK OK K R e K KOK KEIR ERE KOK K R R R R R K K gsys login Here you may log in as gsysuser with password Praecis or as the root user with password en 1 When logged in as gsysuser you may check status information and view log files but you will not be able to modify any system settings or view secure files In order to perform system setup procedures which includes configuring the IP network settings you must log in as the root user After correctly entering the password at this prompt password the sign on message is shown It identifies the host system as Tycho GPS and shows the software part number version and build date Tycho GPS 6010 0042 000 v 1 00 Wed May 9 14 17 44 UTC 2002 Tycho GPS root gsys gt This last line is the standard RTM3204 Tycho shell prompt Th
29. we sometimes make exceptions for this Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally NO WARRANTY 11 BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE THERE IS NO WARRANTY FOR THE PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE LAW EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESSED OR IMPLIED INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRAN TIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU SHOULD THE PROGRAM PROVE DEFECTIVE YOU ASSUME THE COST OF ALL NECES SARY SERVICING REPAIR OR CORRECTION 12 INNO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MAY MODIFY AND OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE BE LIABLE TO YOU FOR DAM AGES INCLUDING ANY GENERAL SPECIAL INCIDENTAL OR CONSEQUENTIAL DAM AGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES END OF TERMS AND
30. CONDITIONS 69 RTM3204 GPS Timing Module User Manual Apache Software License APPENDIX G The Apache server as implemented in the RTM3204 Tycho is cover by copyrights See the license at http www apache org licenses LICENSE 1 1 Information about Apache can be found at http httpd apache org The distribution and usage of Apache is allowed as long as the following copyright notice is included in our documentation This notice applies as if the text was explicitly included each file The Apache Software License Version 1 1 Copyright c 2000 The Apache Software Foundation rights reserved Redistribution and use in source and binary forms with or without modification are permitted provided that the following conditions are met 1 Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer 2 Redistributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution 3 The end user documentation included with the redistribution if any must include the following acknowledgment This product includes software developed by the Apache Software Foundation http www apache org Alternately this acknowledgment may appear in the software itself if and wherever s
31. ECTORS RIGHT ANGLE SMB AND POWER 2x MOUNTING HOLES 2x MOUNTING HOLES TAPPED 6 32 x 0 37 DEEP TAPPED 6 32 x 0 25 DEEP 0 50 x F BOTTOM VIEW 2x MOUNTING HOLES TAPPED 6 32 x 0 37 DEEP 77 RTM3204 GPS Timing Module User Manual APPENDIX H 78 RTM3204 GPS Timing Module User Manual EndRun ET au TECHNOLOGIES Special Modifications Changes for Customer Requirements From time to time EndRun Technologies will customize the standard RTM3204 GPS Timing Module for special customer requirements Ifyour unit has been modified then this section will describe what those changes are This section is blank 79 RTM3204 GPS Timing Module User Manual SPECIAL MODIFICATIONS 80 RTM3204 GPS Timing Module User Manual n IR un Santa Rosa CA USA TECHNOLOGIES ange Smarter Timing Solutions www endruntechnologies com
32. Environmental Temperature 0 to 50 Humidity 0 to 95 non condensing Storage Temperature 40 to 85 Optional Fixed Rate Output Signal Positive TTL pulse 500 Rate Preset at factory and cannot be changed Possible rates are 1 10 100 1K 10K 100K 1M 5M 10M PPS 1PPM 1PP2S or Synth Duty Cycle 50 except 1PPS which mimics the standard 1PPS Output Accuracy lt 10713 to UTC for 24 hour averaging times when locked Alignment Within 10 ns of the other TTL outputs in this unit except the optional DDS Stability See Stability Allan Deviation Table above Synthesized Rate option 1 PPS to 10 MPPS in 1 PPS steps with optional DDS Upgrade Optional Low Phase Noise Output Quantity 1 Output Frequency 10 MHz Output Level 10 dBm 1 dBm at 50Q Harmonics lt 40 dBc at 50Q Stability See Stability Allan Deviation Table for 10M PPS Output above Phase Noise dBc Hz 10 MHz Hz Rb HS Rb Spurs 1 80 10 100 120 100 135 115 1k 140 125 10k 140 125 100 k 140 110 76 RTM3204 GPS Timing Module User Manual SPECIFICATIONS Mounting Dimensions lt 10 50 gt lt 10 00 gt 2 00 In SIDE VIEW lt 9 70 gt 0 55 4 30 gt 4 30 gt j amp In REQUIRED CLEARANCE FOR MATING 4 00 3 00 CONN
33. HTTP interface is not available in the older RTM3204 Tycho models These models have a Linux Subsystem root file system RFS number of 6010 0042 000 To see the number enter the gsysversion command via the network serial port If you have one of the older RTM3204 Tycho models please proceed to the next section Upgrade Via The Network Serial Port The newer RTM3204 Tycho models have or can have the HTTP interface capability These models have a Linux Subsystem RFS number of 6010 0044 000 The HTTP interface was introduced at ver sion 5 50 of the Linux Subsystem software If you have one of the newer RTM3204 Tycho models and your current software version is at least 5 50 you may upgrade firmware via the web interface or the network serial port Software upgrades via the HTTP interface are simple with your choice of two methods 1 If your RTM3204 Tycho has access to the internet the HTTP interface can automatically retrieve the appropriate files from the FTP server at endruntechnologies com to temporary locations on the RTM3204 Tycho You will need to authenticate the root user name and password and follow the prompts from the HTTP interface to complete each upgrade one for the Linux Subsystem and the other for the GPS Subsystem IMPORTANT The domain name server IP address is required by the Apache web server When using net config see Chapter 3 Control and Status Commands to configure the TCP IP parameters be sure to config ure the n
34. Merit TFOM number The RTM3204 displays this num ber in the time of day fields printed by the gpsstat command see Chapter 3 The TFOM number indicates the level of accuracy that should be included in the interpretation of the time of day and ranges from 4 to 9 time error is lt 1 us time error is lt 10 us time error is lt 100 us time error is lt 1 ms time error is lt 10 ms time error is gt 10 ms unsynchronized state if never locked to GPS In all cases the RTM3204 reports this value as accurately as possible even during periods of GPS signal outage where the RTM3204 is unable to directly measure the relationship of its timing outputs to UTC During these GPS outage periods assuming that the RTM3204 had been synchronized prior to the outage the RTM3204 extrapolates the expected drift of the RTM3204 timing signals based on its knowledge of the characteristics of the internal Temperature Compensated Crystal Oscilla tor TCXO or Rubidium oscillator The extrapolated TFOM is based on a conservative estimate of the performance of the oscillator and should be considered worst case for a typical benign ambient temperature environment During periods of signal loss the GPS Subsystem will compute an extrapolated worst case time error as described above If the signal loss condition persists you will see the TFOM character change to indicate a gradually deteriorating accuracy of the timing outputs One
35. Prints the time mode settings in effect for the timecode or Se gsystimemodeconfig Interactive shell script that guides the user in configuring the time mode settings for the timecode or Serial Time output Al lows setting to the LOCAL GPS or UTC timescale and if LO CAL the setting of the offset to UTC and the Daylight Savings Time DST start and stop date time parameters gsysversion Prints the Linux Subsystem software version information to the console Prints help for RTM3204 commands not Linux 18 RTM3204 GPS Timing Module User Manual CONTROL AND STATUS COMMANDS inetdconfig Interactive shell script that allows the user to configure the list of protocol servers which are started by the inetd server daemon running in the RTM3204 netconfig Interactive shell script that allows the user to configure the IP network subsystem of the RTM3204 oscctrlstat Prints the oscillator disciplining parameters pluginopts The RTM3204 is a derivative of a rackmount product the Ty cho GPS This command will show that Slot 2 has 1 5 and 1PPS Output If the optional fixed rate output exists then it will also be shown setantfltmask Command to enable or mask the Antenna Fault setgpscaldelay An interactive script that allows the user to change the clock calibration delay setgpsdynmode Allows the user to set the dynamic mode of operation of the GPS Subsystem It may be ON or OFF setgpsrefpos Intera
36. Second Daylight Savings Local Time Offset Time Quality and Parity The IEEE 1344 table provided below shows each bit position with detailed information NASA 36 Bit NASA 36 bit time code is a 100 bit pulse width modulated format used to amplitude modulate a 1000 kHz sine wave carrier The information contained in the timecode is seconds minutes hours and days The format is used by several military ranges Reference IRIG Document 104 59 2137 The 2137 code is a 25 bit pulse width modulated format used to amplitude modulate a 1000 kHz sine wave carrier The information contained in the timecode is seconds minutes and hours The format is used by certain security organizations 61 RTM3204 GPS Timing Module User Manual APPENDIX E IEEE 1344 Bit Definition Bit Position Bit Definition Explanation 50 Year BCD P52 P53 P54 P55 P56 P57 P58 P59 P61 P62 P63 P64 P65 Y CC C CC C C Cs _ x Local oMetbinamy2 pot Po er re Per Pers Time quatty binary S Pa Time quality aps ps Refer to Appendix A Time Figure of Merit for detailed information Briefly 62 4 oa time error is lt 1 us time error is lt 10 us time error is lt 100 us time error is lt 1 ms time error is lt 10 ms time error is gt 10 ms unsynchronized state if
37. TECHNOLOGIES RTM3204 GPS Timing Module User Manual RTM3204 GPS Timing Module User Manual Preface Thank you for purchasing the RTM3204 GPS Timing Module Our goal in developing this product is to bring you a precise time and frequency reference that will quickly easily and reliably meet or ex ceed your system requirements Your new RTM3204 is fabricated using the highest quality materials and manufacturing processes available today and will give you years of troublefree service About EndRun Technologies EndRun Technologies is dedicated to the development and refinement of the technologies required to fulfill the demanding needs of the time and frequency community Our innovative engineering staff with decades of experience in the research and development of receiver technology for the Global Positioning System GPS has created our window mount GPS antenna and extended hold over oscillator control algorithms The instruments produced by EndRun Technologies have been selected as the timing reference for such rigorous applications as computer synchronization research institutions aerospace network quality of service monitoring satellite base stations and calibration laboratories EndRun Technologies is committed to fulfilling your precision timing needs by providing the most advanced reliable and cost effective time and frequency equipment available in the market today Trademark Acknowledgements IBM PC Linux NoteP
38. TM3204 Tycho response The passwd interactive utility starts gsysrootfs This command displays the currently booted root file system image It can be either TychoGPS_0 factory image or TychoGPS_1 field upgrade image Refer to Appendix B Upgrading the Firm ware for detailed instructions on performing the upgrade procedure Query gsysrootfs RTM3204 Tycho response BOOT_IMAGE TychoGPS_1 gsystimemode This command displays the current time mode settings for any optional timecode or Serial Time Out put The time mode setting can be UTC GPS or Local The Local Time Offset from UTC and the DST Start Stop parameters are only valid when the Time Mode is LOCAL A positive Local Time Offset implies a longitude east ofthe Greenwich time zone and that local time is ahead of UTC 24 RTM3204 GPS Timing Module User Manual CONTROL AND STATUS COMMANDS Query gsystimemode RTM3204 Tycho response Time Mode LOCAL Local Time Offset from UTC 16 half hours DST Start Month Apr Sunday 1st Hour 02 DST Stop Month Oct Sunday Last Hour 02 gsystimemodeconfig This command starts an interactive shell script that will allow the user to configure the time mode of any optional time code or Serial Time outputs Selections are UTC GPS or Local These settings have no effect on the operation of the underlying Linux operating system time It ALWAYS operates in UTC By default the unit is configured to operate in UTC If you need to modify this
39. To ensure security change the pass words or disable the protocols To change the passwords for SSH Telnet and HTTP use the gsyspasswd command To change the passwords community strings for SNMP see Appendix SNMP By default all users are allowed access via SSH Telnet and SNMP To restrict access via these protocols use the accessconfig command or edit etc hosts allow and etc hosts deny All users are allowed access via as well To restrict access via HTTP etc apache httpd conf to set up access by specific hosts To completely disable any or all of these protocols see Disabling Protocols below Note The RTM3204 is a derivative of our standard product the Tycho GPS Frequency Reference As such the operating system software will refer to Tycho The embedded Linux operating system running in the RTM3204 Tycho is based on kernel version 2 4 31 and version 10 of the Slackware Linux distribution As such it supports a complete set of security provisions e System passwords are kept in an encrypted file etc shadow which is not accessible by users other than root e Direct root logins are only permitted on the local RS 232 console or via SSH 5 RTM3204 GPS Timing Module User Manual Limiting Access APPENDIX D The secure copy utility scp eliminates the need to use the insecure ftp protocol for transferring program updates to the RTM3204 Tycho e HTTP may be completely disabled by configuration of etc rc d
40. Upgrade The RTM3204 Tycho is shipped from the factory with a kernel that is IPv4 only capable only If you want to upgrade your kernel to the IPv4 IPv6 capable one then you must first be sure that your root file system is version 2 60 or later To see the root file system version type gsysversion at the network serial port To upgrade your kernel log in as the root user to the RTM3204 Tycho using the local console serial VO port telnet or ssh and perform these operations If you are using tp to perform the upgrade transfer the previously downloaded file using binary transfer mode from the remote host to a temporary location on your RTM3204 Tycho using FTP The IPv6 kernel image will be named with the software part number like 6010 0041 100 bzimage When following the instructions below substitute the name of the actual kernel image that you are installing for 6010 0041 100 bzimage Issue these commands from the console of your RTM3204 Tycho ftp remote_host perform ftp login on remote host bin set transfer mode to binary get 6010 0041 100 bzimage tmp transfer the file quit close the ftp session after transfer If you are using ssh you may open a command window on the remote computer and securely transfer the root file system image using scp from the remote computer to your RTM3204 Tycho A command like this should be used scp p 6010 0041 100 bzimage root gsys your domain tmp The kernel upgrade utility is executed with a
41. User Manual THIRD PARTY SOFTWARE 8 Ifthe distribution and or use ofthe Program is restricted in certain countries either by patents or by copyrighted interfaces the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries so that distribution is permitted only in or among countries not thus excluded In such case this License incorporates the limitation as if written in the body of this License 9 The Free Software Foundation may publish revised and or new versions of the General Public License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns Each version is given a distinguishing version number If the Program specifies a version number of this License which applies to it and any later version you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Founda tion If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation 10 If you wish to incorporate parts of the Program into other free programs whose distribution condi tions are different write to the author to ask for permission For software which is copyrighted by the Free Software Foundation write to the Free Software Foundation
42. Using HTTP You may monitor the status of the RTM3204 via the HTTP interface For security reasons you may not change any settings via the HTTP interface See Chapter 4 HTTP Interface for more informa tion IMPORTANT SSH Telnet SNMP and HTTP are all enabled with default passwords To ensure security change the pass words or disable the protocols To change the passwords for SSH Telnet and HTTP use the gsyspasswa command To change the passwords community strings for SNMP see Appendix SNMP To disable Telnet use inetaconfig command To disable SSH SNMP and HTTP see Appendix D Security Disabling Protocols 15 RTM3204 GPS Timing Module User Manual CHAPTER TWO Connecting Instruments to the RTM3204 Front panel mounted SMB jacks provide the means of connecting your equipment to the RTM3204 The standard RTM3204 provides two precision output signals capable of driving properly terminated coaxial cables IPPS and 1OMPPS These signals are DC coupled and sourced from Advanced CMOS ACMOS drivers which are able to maintain output TTL levels into a 50 ohm load The third signal AM Code provides a DC coupled Vrms amplitude modulated timecode signal into a 50 ohm load Care should be taken not to short circuit these outputs or to connect them to other voltage sources 16 RTM3204 GPS Timing Module User Manual EndRun C W TECHNOLOGIES General Linux Shell Operation Chapter Three Control and Status Commands T
43. a signal loss fault will be asserted See Appendix Time Figure of Merit for more information By changing the TFOM Fault Level you control the point at which the time error will produce a signal loss fault which then creates an alarm condition The factory default setting is 9 which is the maxi mum TFOM value Set settfomfltlvl 6 RTM3204 Tycho response TFOM Fault Level set to 6 sigfltmask This command displays the current setting for the Signal Loss Fault Mask Query sigfltmask RTM3204 Tycho response Signal Loss Fault is ENABLED tfomflilvi This command displays the current setting for the TFOM Fault Level Query tfomfltlvl RTM3204 Tycho response 9 28 RTM3204 GPS Timing Module User Manual CONTROL AND STATUS COMMANDS updaterootflag This command allows the user to update the configuration of the Linux bootloader after a new root file system image has been uploaded to the UPGRADE root file system partition dev rootfs_1 of the RTM3204 Tycho FLASH disk It may also be used to reset the default back to the FACTORY root file system partition Refer to Appendix B Upgrading the Firmware for detailed instructions for performing the upgrade procedure One argument is accepted whose value is either 0 or 1 causing a flag to be set that will indicate to the bootloader which root file system image should be loaded by default If an argument value of 2 is given then the currently configured default root file system is shown Se
44. a sample transcript which illustrates the use of netconfig The entries made by the user are underlined and are provided purely for illustrative purposes You must provide equiva lent entries that are specific to your network Those shown here are appropriate for a typical network that does not use DHCP Start the configuration process by typing netconfig at the shell prompt Tycho GPS root gsys gt netconfig k k k k k k k k k k k k k k k k k k k k k k k k K K k k k K kO k KO KO K K kO k K KO KO KO O KO RO RO KO RO R RO KO RO RO KO RO O K O O KO KO RO O KO RO RO KO RO O RO RO O R Tycho GPS Network Configuration d d d d dd d ddd ddd ddk kkk KKK RK RER This script will configure the TCP IP network parameters for your Tycho GPS You will be able to reconfigure your system at any time by typing netconfig The settings you make now will not take effect until you restart your Tycho GPS so if you make a mistake just re run this script before re booting You will be prompted to enter your network parameters now HF gt ZZ 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 203 k k k k k k k k k 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 O DHCP Sett
45. ace GPS time is measured relative to UTC as maintained by the United States Naval Observa tory USNO and maintained synchronous with UTC USNO except that it does not suffer from the periodic insertion of leap seconds Such discontinuities would unnecessarily complicate the system s navigation mission Contained in the data transmitted from each satellite is the current offset between GPS time and UTC USNO This offset is composed of the current integer number of leap seconds difference and a small residual error that is typically less than 10 nanoseconds Each satellite in the constellation contains redundant cesium beam or rubidium vapor atomic frequen cy standards These provide the timebase for all transmissions from each satellite These transmis sions are monitored from ground stations located around the world and carefully measured relative to GPS time The results of these measurements for each satellite are then uploaded to that satellite so that they may be incorporated into the data contained in its transmissions The receiver can use this data to relate the time of arrival of the received transmissions from that satellite to GPS time All of this means that during normal operation the source of the timing information being transmit ted from each of the satellites is directly traceable to UTC Due to the nature of the GPS spread spectrum Code Division Multiple Access CDMA modulation scheme this timing information may be extracted
46. ad Timeserv UNIX Windows NT WordStar are registered trademarks of the respective holders Part No USM3204 0100 000 Revision 4 February 2012 Copyright EndRun Technologies 2005 2012 RTM3204 GPS Timing Module User Manual About This Manual This manual will guide you through simple installation and set up procedures Introduction The RTM3204 GPS Timing Module how it works where to use it its main features Basic Installation How to connect configure and test your RTM3204 GPS Timing Module Console Port Description of the Linux console commands for use over the network and serial ports If you detect any inaccuracies or omissions please inform us EndRun Technologies cannot be held responsible for any technical or typographical errors and reserves the right to make changes to the product and manuals without prior notice Warranty This product manufactured by EndRun Technologies is warranted against defects in material and workmanship for a period of two years from date of shipment under normal use and service During the warranty period EndRun Technologies will repair or replace products which prove to be defec tive For warranty service or repair this product must be returned to EndRun Technologies Buyer shall prepay shipping charges to send product to EndRun Technologies and EndRun Technologies shall pay shipping charges to return product to Buyer However if returned product proves to be operating normally no
47. allows the user to initialize and maintain the RTM3204 See Chapter 3 RS 232 Serial I O Port Signal Definitions for detailed information This SMB connector provides the PPS TTL output The pulse width is normally 1 millisecond wide when shipped from the factory but can be changed via console command cpuoptsconfig Other selections are 20 microseconds 100 milliseconds and 500 milliseconds See signal definition in Appendix H Specifications for the 1PPS output This SMB connector provides the 10 TTL output See signal definition in Appendix H Specifications for more information This SMB connector provides the amplitude modulated timecode output The timecode output is normally IRIG B122 when shipped from the factory but can be changed via the console command cpuoptsconfig Other selections are IRIG B123 IRIG B IEEE 1344 compliant NASA 36 and 2137 See signal definition in Appendix H Specifications for the AM Code output RTM3204 GPS Timing Module User Manual Performing an Initial Site Survey BASIC INSTALLATION EndRun TECHNOLOGIES GPS TIMING MODULE 10 100 BASE T 00 D0 C9 55 69 FC 3204 0 101 000 Made in USA REAR PANEL Spare Jack This spare is for the optional Fixed Rate Output or 10 MHz Low Phase Noise Output DC Power Input Jack This 2 position Jack provides connection to the DC power source See details in Appendix H Specifications 10 100Base T Jack This rear pa
48. ame server Only one name server is required two gives some redundancy The HTTP Interface will not start if this is configured incorrectly 41 RTM3204 GPS Timing Module User Manual APPENDIX B The following picture shows the Linux Subsystem RFS Upgrade page All fields are filled in with default values to download the appropriate software image from the EndRun Technologies website You can use these default values unless you want to point to a different FTP server EndRun Smarter Timing Solutions TECHNOLOGIES Receiver Faults Network Firmware Home Tycho GPS Frequency Reference Firmware Status Upgrade from a FTP server NTP Subsystem Upgrade File Name GPS Subsystem Upgrade Reboot 6010 0044 000 gz FTP Server Name Jendruntechnologies com FTP Login Name anonymous FTP Login Password rourPassword SUBMIT 2 If your RTM3204 Tycho does not have access to the internet you must first download the appro priate files from the endruntechnologies com website to the computer that you will be using later to access the RTM3204 Tycho via its HTTP interface Use the link shown above to get the files After saving the files use the RTM3204 Tycho HTTP interface to select the previously saved files for upload to the RTM3204 Tycho One for the Linux Subsystem and the other for the GPS Subsystem Then follow the remaining prompts from the HTTP interface to complete the upgrades You will need to auth
49. and httpd daemons Placing a character at the beginning of a line makes it a comment line so that it will not be executed See Using Edit above 57 RTM3204 GPS Timing Module User Manual OpenSSH APPENDIX D Disable SSH To disable SSH edit a system start up script called etc rc d rc inet2 This script starts several of the daemons running on the system You should follow the instructions contained in comments in the file for disabling the sshd daemon Placing a character at the beginning of a line makes it a comment line so that it will not be executed See Using Edit above IMPORTANT After editing etc rc d rc local and or etc rc d rc inet2 you must copy them to the boot etc rc d directory and reboot the system It is very important to retain the access mode for these files so be sure to use p when performing the copy During the boot process the files contained in the boot etc re d directory are copied to the working ete re d directory on the system RAM disk In this way the fac tory defaults are overwritten The secure shell protocol server running in the RTM3204 Tycho is based on the portable OpenSSH for Linux As such it supports both SSH1 and SSH2 protocol versions By default only SSH2 is en abled due to security issues with SSH1 For more information about this protocol and to obtain client software refer to the OpenSSH website http www openssh com An excellent book which describes operation and configu
50. as to the offer to distribute corresponding source code This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer in accord with Subsection b above The source code for a work means the preferred form of the work for making modifications to it For an executable work complete source code means all the source code for all modules it contains plus any associated interface definition files plus the scripts used to control compilation and installation of 67 RTM3204 GPS Timing Module User Manual APPENDIX G the executable However as a special exception the source code distributed need not include any thing that is normally distributed in either source or binary form with the major components com piler kernel and so on of the operating system on which the executable runs unless that component itself accompanies the executable If distribution of executable or object code is made by offering access to copy from a designated place then offering equivalent access to copy the source code from the same place counts as distribu tion of the source code even though third parties are not compelled to copy the source along with the object code 4 You may not copy modify sublicense or distribute the Program except as expressly provided un der this License Any attempt otherwise to copy modify sublicense or distribute the Program is void a
51. ault will be asserted See Appendix A Time Figure of Merit for more information You can change the TFOM Fault Level by using command settfomflt1vl By changing the TFOM Fault Level you control the point at which the time error will produce a signal loss fault which then creates an alarm condition The factory default setting is 9 Clock Calibration This field shows the clock calibration delay which is used to advance or retard the clock in order to compensate for antenna cable length or other external hardware Use the setGPScaldelay com mand to change this setting Receiver Oscillator Page This page shows receiver oscillator control information such as Oscillator Type This field shows the oscillator type that is installed in the RTM3204 Tycho It will be either a TCXO or a Rubidium The standard oscillator is the TCXO DAC Is the upper 16 bits of the oscillator voltage control DAC word 0 to 65535 with larger numbers implying higher oscillator frequency Typical range is 20000 to 38000 Measured Time Error The measured time error is the last measured time offset while locked Time Deviation This field shows the time deviation TDEV of measurements Oscillator Ageing Rate This field shows the regression computed oscillator ageing rate per day There is a several hour delay before the first measurement is shown Control Loop TAU This is the oscillator control loop averaging time constant Coast Duration The coast durati
52. awing in Appendix H Specifications for the mounting hole locations The RTM3204 internal temperature must not exceed 70 C as measured by the built in temperature sensor accessible via the oscctrlstat serial port command Internal temperature will remain in safe range if all conditions are met A Base plate is in good thermal contact with external enclosure B Ambient air temperature surrounding RTM3204 GPS Timing Module enclosure is lt 50 C C Adequate clearance around RTM3204 enclosure allows for free convection around cover D No additional thermal sources via adjacent mechanical contact Condition A must be met If condition B and or C and or D cannot be met as stated use built in tempera ture sensor to verify adequate operating margins RTM3204 GPS Timing Module User Manual BASIC INSTALLATION Connecting and Configuring Ethernet Connect one end of the CAT 5 patch cable supplied with your RTM3204 to the RJ 45 connector labeled 10 100BASE T Connect the other end of the patch cable to your network through a straight port on your hub Do not connect it to a crossover port on your hub By factory default the RTM3204 will attempt to configure the ethernet interface automatically via the Dynamic Host Configuration Protocol DHCP The RTM3204 will attempt to set the netmask its IP address the IP address of the default gateway the domain name and the IP addresses of any nameservers if the DHCP server i
53. b HS Rb 1 1x10 2x101 2x10 10 4x10 6 7x10 6 7x10 100 5x101 2 5 10 2 2x10 1000 6 5x10 1 4x10 1 9x10 10000 1x101 8x101 5x10 100000 1x103 1x10 1x10713 Time Code Output Signal Amplitude modulated AM 3 1 ratio Frequency 1 kHz Drive 1 Vrms into 500 User Selectable Formats IRIG B120 IEEE 1344 IRIG B122 IRIG B123 NASA 36 or 2137 74 RTM3204 GPS Timing Module User Manual SPECIFICATIONS Maintenance Console Signal I O port at RS 232 levels for secure local terminal access Parameters 19200 baud 8 data bits no parity 1 stop bit Supported IPv4 Network Protocols SSH server with secure copy utility SCP SNMP v1 v2c v3 with Enterprise MIB TIME and DAYTIME server TELNET client server FTP client DHCP client SYSLOG HTTP Supported IPv6 Network Protocols SSH server with secure copy utility SCP SNMP v1 v2c v3 with Enterprise MIB TIME and DAYTIME server SYSLOG Note See Appendix F IPv6 Information for details DC Power TCXO 9 5W Maximum 6W Typical 24VDC 20 0 5A Maximum Rubidium 25W maximum 12W typical 23 C 24 VDC 20 1 75A maximum Connector Molex Micro Fit 3 0 2 pin jack Mating Connector Molex 43025 0200 20 24 AWG Terminal Molex 43030 0002 Physical Chassis Size 2 00 H x 4 00 W x 10 00 D Antenna Size 3 5 Dia x 2 5 H Chassis Weight lt 3 Ib 1 35 kg 75 RTM3204 GPS Timing Module User Manual APPENDIX H
54. below In order to connect the Tycho to another computer a null modem adapter must be used The serial cable pro vided with the shipment is wired as a null modem adapter and can be used to connect the Tycho to your computer 300 RTM3204 GPS Timing Module User Manual EndRun C W TECHNOLOGIES Chapter Four HTTP Interface This chapter briefly describes the HTTP interface that resides on the RTM3204 GPS Timing Module The HTTP interface to the RTM3204 is a fast and easy to use graphical interface that is compliant with your standard web browser Simply point your browser to the IP address of the RTM3204 and login securely with HTTP Security conscious customers may disable the HTTP interface see the end of this Appendix Hor instructions Note The HTTP interface is not IPv6 compliant Note The RTM3204 is a derivative of our standard product the Tycho GPS Frequency Reference As such the software interface will contain references to Tycho GPS The HTTP interface is not available in older RTM3204 Tycho models The older models have a Linux Subsystem root file system RFS number of 6010 0042 000 To see the number enter the gsysversion command via the network serial port The newer RTM3204 Tycho models have or can have the HTTP interface capability These models have a Linux Subsystem RFS number of 6010 0044 000 The HTTP implementation in the RTM3204 Tycho uses HTTPS HTTP over SSL Secure Socket Layer SSL is a sublayer unde
55. c mode is OFF the RTM3204 will use its accurate reference position to implement Timing Receiver Autonomous Integrity Monitoring TRAIM for the utmost in reliability during any GPS system faults In addition single satellite operation is possible once an initial accurate position has been determined 20 RTM3204 GPS Timing Module User Manual CONTROL AND STATUS COMMANDS When the dynamic mode is ON only a very minimal TRAIM algorithm is in effect because the ac curate reference position is not static In addition a minimum of four satellites must be visible and only 3 D position fixes are used When the dynamic mode is ON the source reported for the accurate reference position by gpsrefpos is set to DYN Query gpsdynmode RTM3204 Tycho response OFF The accuracy and stability specifications in Appendix I Specifications assume a stationary plat form and an antenna with a full view of the sky Accuracy and stability performance will degrade in dynamic mode gpsrefpos This command displays the current GPS Subsystem reference position The source of the position which is one of UNK unknown DYN dynamic USR user entered or AVG 24 hour average of GPS fixes is displayed first The WGS 84 latitude and longitude in degrees minutes seconds format and the height above the WGS 84 reference ellipsoid in meters follow Query gpsrefpos RTM3204 Tycho response CURRENT REFERENCE POSITION AVG N38d26m36 11s W122d42m56 50s 00032 5 meters
56. command displays the current setting for the Antenna Fault Mask Query antfltmask RTM3204 Tycho response Antenna Fault is ENABLED cpuopts This command displays the current settings for the 1PPS and time code AM Code outputs Query cpuopts RTM3204 Tycho response CPU Option 1PPS is installed Current setting 20 microseconds CPU Option TIME CODE is installed Current Setting IRIG B122 cpuoptsconfig This command starts an interactive shell script that will allow the root user to change the settings of the 1PPS pulse width and the time code format Set cpuoptsconfig RTM3204 Tycho response Interactive shell script is started eraserootfs_1 This command erases the UPGRADE root file system FLASH partition in preparation for performing a Linux Subsystem firmware upgrade See Appendix Upgrading the Firmware for more infor mation Set eraserootfs_1 RTM3204 Tycho response Erase progress as percent is shown gpscaldelay This command displays the current calibration delay setting The allowable calibration delay range is 500000 to 500000 nanoseconds Query gpscaldelay RTM3204 Tycho resposne 0 nanoseconds gpsdynmode This command displays the current GPS Subsystem dynamic mode of operation It has two possible settings ON or OFF When it is ON it is assumed that the RTM3204 is installed on a moving plat form When it is OFF it is assumed that the RTM3204 is installed in a stationary location When the dynami
57. ctive shell script that prompts the user for an accurate reference position performs syntax and argument validity checking then passes the position to the GPS Subsystem setsigfltmask settfom tlvl sigfltmask tfomfitlvi updaterootflag Command to update the flag stored in FLASH that is read by the Linux bootloader at boot time to select operation with either the FACTORY or UPGRADE root file system upgradegps Shell script that facilitates the GPS Subsystem firmware up grade process upgradekernel Shell script that facilitates the Linux kernel firmware upgrade process Limited applicability Use with caution Detailed Command Descriptions accessconfig This command starts an interactive shell script that will allow the root user to configure limitation of telnet ssh and snmp access to the RTM3204 Tycho By default the unit is configured to allow access by all users If you need to limit telnet ssh or snmp access e g for security reasons you must run this script as root from either the RS 232 serial I O port or from a telnet or ssh session This script modifies these files etc hosts allow and etc hosts deny These are non volatilely stored in the FLASH disk boot etc directory You must reboot the RTM3204 Tycho after running this script for the changes to take effect Set accessconfig RTM3204 Tycho response Interactive shell script is started 19 RTM3204 GPS Timing Module User Manual CHAPTER THREE antfltmask This
58. d the server will continue to load protected by SSL The browser should display the Lock icon indicat ing that the page is protected by SSL To maximize security you should replace the SSL Certificate See Appendix D Security HTTP for details Below is a picture of the login page Smarter Timing Solutions TECHNOLOGIES Receiver Clock vo Faults Network Firmware Tycho GPS Frequency Reference Login first Navigation The main menu tabs across the top of each webpage allow you to navigate through the status infor mation in the RTM3204 Tycho while links on the lefthand side of each webpage provide subcategory navigation For example in the page below the main menu tabs are Home Receiver Clock I O Faults Net work and Firmware The subcategory links on this particular page are IPv4 IPv6 and DNS IPv4 is selected 32 RTM3204 GPS Timing Module User Manual Page Descriptions HTTP INTERFACE Smarter Timing Solutions EndRun TECHNOLOGIES Firmware Home Receiver Tycho GPS Frequency Reference IPv4 NETWORK STATUS DHCP Disabled static IP address IPv4 IPv6 Address 192 168 1 135 Gateway 192 168 1 1 Netmask 255 255 255 0 The top hand tabs and left side links are logically arranged for easy navigation The following table defines this relationship Home Overall RTM3204 Tycho Status Login Logout Information GPS Receiver Status R
59. ds COMMAND FUNCTION accessconfig Interactive shell script that guides the user in configuring telnet ssh and snmpd access to the RTM3204 that is lim ited to specific hosts The resulting etc hosts allow and etc hosts deny files are saved to the non volatile FLASH disk Factory default configuration allows access by all hosts Prints the current setting for the Antenna Fault Mask cpuopts Returns the current settings for any installed user selectable outputs from the CPU Module These are 1PPS and time code AM Code cpuoptsconfig An interactive script that allows the user to modify the settings for the IPPS and Time Code eraserootfs_1 Command to erase the UPGRADE root file system FLASH partition This must be executed prior to loading the new file system image during the Linux upgrade process gpsversion Prints the GPS firmware and FPGA version information to the console gsyshwaddr Prints the ethernet hardware address if the ethernet has been gsysosctype Prints the installed oscillator type gsyspasswd Allows the root user to change the password for the two con figured users on the RTM3204 gsysuser and root This script calls the standard Linux passwd binary and then saves the resulting etc shadow file to the non volatile FLASH disk gsysrootfs Prints the current root file system image either TychoGPS_0 factory default or TychoGPS_1 field upgrade which is run ning in the RTM3204 Tycho to the console gsystimemode
60. dule User Manual APPENDIX B If you are using ssh you may open a command window on the remote computer and securely transfer the root file system image using scp from the remote computer to your RTM3204 Tycho A command like this should be used scp p 6010 004x 000_3 00 gz root gsys your domain dev rootfs_1 Update the default file system partition by issuing this command on your RTM3204 Tycho updaterootflag 1 You should see this line displayed UPGRADE is the default root file system Now reboot the system by issuing this command at the shell prompt shutdown r now Wait about 90 seconds for the system to shutdown and reboot Then log in to the RTM3204 Tycho using telnet or ssh If all has gone well you should be able to log in the usual way After you have entered your password the system message will be displayed You should notice that it now indicates the software version and date of the upgrade that you previously downloaded You can also check this at any time by issuing gsysversion which will cause the system message to be re displayed You can also check to see which root file system image the system is currently booted under by issu ing this command at the shell prompt gsysrootfs Which should cause this to be printed to the console BOOT_IMAGE TychoGPS_1 If so and your unit seems to be operating normally you have successfully completed the upgrade If your unit does not boot up successfully and you are not abl
61. e RTM3204 Tycho uses the bash shell which is the Linux standard full featured shell After configuring the unit you should change the passwords using the gsyspasswd command issued from the shell prompt If you do not see characters displayed by your terminal program within 30 seconds after the unit is powered up you must troubleshoot your setup An incorrectly wired cable or incorrect port setting in your terminal emulation program are the most common problems Refer to Chapter 4 RS 232 Serial I O Port Signal Definitions for the signal connections for the RTM3204 10 RTM3204 GPS Timing Module User Manual BASIC INSTALLATION You must use a null modem cable or adapter if you are connecting the RTM3204 to another computer or other equipment configured as Data Terminal Equipment DTE The supplied cable is a null modem cable Once you have successfully established communications with the RTM3204 you may procede to configuring the network parameters Then you can communicate with the RTM3204 over the net work using telnet or ssh Using netconfig to Set Up Your IP The script file netconfig will configure the TCP IP network parameters for your RTM3204 If you want to have the HTTP Interface enabled in your RTM3204 then be sure to configure the name server IP address during the netconfig process The HTTP Interface will not start if this is configured incorrectly Only one name server is required two gives some redundancy The following is
62. e org It uses HTTPS HTTP over SSL with mod ssl the Apache interface to OpenSSL For more infor mation about this protocol refer to http www modssl org HTTP and SSL use two files for the default configuration located in etc apache These are httpd conf and ss conf Advanced users who need to modify the default configuration will need to edit these two files and copy them to the boot etc apache directory See Using Edit above For SSL it is recommended that new certificates are generated and installed on the Apache web server with mod_ssl The current certificates included are located in etc apache ssl ctr etc apache ssl csr and etc apache ssl key New certificates CSRs and private keys will need to be saved in boot etc apache ssl crt boot etc apache ssl csr and boot etc apache ssl key directories By default the Apache server configuration file httpd conf for httpd is factory configured It contains the configuration directives that give the server its instructions Although not required the directives may be changed by editing etc apache httpd conf and then copying it to boot etc apache Do not attempt to change the directives unless you have a real need to do so An excellent book which describes operation and configuration of the various HTTP directives and SSL configuration is Professional Apache Wainwright Wrox Press 1999 To disable HTTP see Disable SNMP and HTTP above 59 RTM3204 GPS Timing Module U
63. e shell script that will allow the user to set the accurate reference position ofthe RTM3204 By default the unit is configured to locate itself using the GPS satel 27 RTM3204 GPS Timing Module User Manual CHAPTER THREE lites In some situations visibility of the sky is limited and the unit will not be able to determine its position In this case the user must determine an accurate WGS 84 position by other means and input it using this command If you need to set the accurate reference position you must run this script as root The changes take place immediately Zf the GPS dynamic mode setting is ON see gpsdynmode setgpsdynmode commands then running this script will have no effect In addition to setting a new accurate reference position the user can also invalidate an existing one This will force the RTM3204 to re establish a new reference position using the GPS satellite constel lation Set setgpsrefpos RTM3204 Tycho response Interactive shell script is started setsigfitmask This command allows the user to enable or mask the Signal Loss Fault Parameter for this command is either MASKED or ENABLED Setting this command to MASKED will prevent a signal loss fault from creating an alarm condition The factory default setting is ENABLED Set sigfltmask MASKED RTM3204 Tycho response Signal Loss Fault Mask set to MASKED settfomflilvl This command allows the user to change the TFOM Fault Level This is the threshold at which
64. e to telnet or ssh into the system after 90 seconds then there has been some kind of problem with the upgrade It is possible that the file downloaded was corrupt or that you forgot to set your FTP download file mode to binary when downloading the file either from the EndRun Technologies website or when transferring it to the RTM3204 Tycho Recovering from a Failed Upgrade To restore your RTM3204 Tycho to a bootable state using the factory root file system you must use the serial I O port and reboot the RTM3204 Tycho by cycling the power Refer to Chapter 2 Con nect the Serial I O Port and Test the Serial I O Port for setup details When you have connected your terminal to the serial I O port apply power to the RTM3204 Tycho Pay close attention to the terminal window while the unit is rebooting After the Linux bootloader displays the message 44 RTM3204 GPS Timing Module User Manual UPGRADING THE FIRMWARE To override and boot the FACTORY partition type FACTORY within 5 seconds you must begin typing factory within five seconds to let the bootloader know that you are going to override the default root file system After you hit lt enter gt the bootloader will boot the factory root file system Watch the rest of the boot process to make sure that you have successfully recovered If the system boots normally then you should resolve the problems with the previous upgrade and re perform it Performing the Linux Kernel
65. eceiver Oscillator Clock Clock Stats _ T O Status Option CPU Options Plug In Options Fals Fault Status O 1 4 Network Status IPv4 IPv6 DNS Firmware Firmware Information Firmware Status Linux Subsystem Upgrade GPS Subsystem Upgrade Reboot Home Page This page contains general status information Data fields are UTC Time Shows the current hours minutes and seconds in UTC Date Shows the current UTC date Receiver Shows whether the GPS receiver is locked or not 33 RTM3204 GPS Timing Module User Manual CHAPTER FOUR TFOM Shows the current TFOM value See Appendix A Time Figure of Merit for more information System Status Shows if any system fault is present If a system fault exists go to the Faults Page to see which fault it is Receiver Page This page contains information related to the GPS Receiver Data fields are State Shows whether the GPS receiver is locked or not TFOM Shows the current TFOM value See Appendix A Time Figure of Merit for more information Satellite ID This field lists the satellites that are currently being tracked Up to 8 may be tracked at a time Average C No The carrier to noise ratio is an indicator of the GPS signal quality This number typically ranges from 30 to 45 dB when the Meridian is locked GPS Dynamic Mode This field shows whether the dynamic mode is set or not Dynamic mode should be OFF when the Meridian is in a static not moving position To c
66. enticate the root user name and password Upgrade from a local file that was previously downloaded from endruntechnologies com Browse SUBMIT Please wait after pressing Submit This may take about 60 seconds 42 RTM3204 GPS Timing Module User Manual Upgrade Via The Network Serial Port UPGRADING THE FIRMWARE In order to upgrade via the network or serial ports you will need to first download the appropri ate FLASH binary image file from the EndRun website After you have done this you are ready to upgrade your RTM3204 Tycho The firmware consists of two FLASH binary image files One of these is the firmware for the RTM3204 Tycho Linux Subsystem This firmware executes on the IBM compatible CPU and contains the embedded Linux operating system and application software The other file is the firmware for the GPS Subsystem Each of these files may be upgraded independently although some upgrades require both images to be modified together You will need to use tp or sep to transfer the binary image file s to the RTM3204 Tycho This means that you must place the previously downloaded file s in a place on your network which is ac cessible to the RTM3204 Tycho Performing the Linux Subsystem Upgrade There are two FLASH disk partitions which hold the compressed Linux root file system images These partitions are raw FLASH blocks have no file system and may not be mounted They are ac cessed through low level devices To p
67. er trapport to the end of the above line to override the default port setting Otherwise leave it blank Note Though the agent will recognize multiple trapsink lines within etc snmpd conf and send the generic SNMP coldStart or authenticationFailure traps to each destination the enterprise trap genera tion mechanism of the RTM3204 Tycho will only send a trap to the last declared trapsink in the file To have your RTM3204 Tycho send SNMPv2c notifications SMIv2 RFC 2578 or informs you must configure the communities and destinations by uncommenting and editing one or both of these lines in etc snmpd conf trap2sink trap2community trap2port informsink informcommunity informport where trap2community and informcommunity should be replaced by your communities and XXX xxx XXX XXX S the address or hostname of the destination host for receiving the notifica tions or informs generated by the RTM3204 Tycho By default the v2c trap or inform will be sent to port 162 You may optionally add another parameter trap2port or informport to the ends of the above lines to override the default port setting Otherwise leave it blank Note Though the agent will recognize multiple trap2sink or informsink lines within etc snmpd conf and send the generic SNMP coldStart or authenticationFailure notifications and informs to each destination the enterprise notification inform generation mechan
68. f both of these resources to familiarize yourself with the agent configuration concepts Prior to SNMPv3 SNMP had definite security inadequacies due to using two community names in a manner analogous to passwords that were transmitted over the network as clear text In addition since no mechanism existed for authenticating or encrypting session data any number of man in the middle data corruption replacement exploits were possible in addition to plain old snooping to learn the community names SNMPv3 implements the User based Security Model USM defined in RFC 2274 which employs modern cryptographic technologies to both authenticate multiple users and to encrypt their session data for privacy much in the same way that SSH does for remote login shell users In addition it implements the View based Access Control Model VACM defined in RFC 2275 This RFC defines mechanisms for limiting the access of multiple users having various security levels no authentication authentication or authentication plus privacy to specific views of the Structure of Management Information SMI object tree In addition to providing the SNMP variables contained in as described in RFC 1213 EndRun Technologies has implemented an enterprise MIB using the syntax of the SMI version 2 SMIv2 as described in RFC 2578 49 RTM3204 GPS Timing Module User Manual Invocation of the SNMP daemon Quick Start Configuration SNMPv1 v2c APPENDIX C N
69. fully locked to the GPS frequency Note If your unit has a Ru bidium oscillator upgrade then it will need 5 10 minutes of warmup before trying to acquire a signal 4 Then the green Sync Status LED will pulse at precisely a 1 Hz rate synchronized to UTC seconds with a short on duration relative to the off duration At this point the GPS time and frequency engine has fully synchronized and you may proceed to permanently mount the RTM3204 and its antenna in their desired locations If you are unable to achieve GPS lock after 24 hours call Customer Support 1 877 749 3878 for assistance This equipment has been tested and found to comply with the limits for a Class A digital device pursuant to part 15 ofthe FCC Rules These limits are designed to provide reasonable protection against harmful interference when the equipment is operated in a commercial environment This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the instruc tion manual may cause harmful interference to radio communications Operation of this equipment in a residential area is likely to cause harmul interference in which case the user will be required to correct the interference at his own expense Mount the RTM3204 GPS Timing Module Mount the unit in the desired location After mounting the unit and connecting the antenna cable verify that it still acquires and tracks a GPS signal Refer to the baseplate dr
70. g to change these settings 1 0 Page Plug In Options This page shows the installed 1PPS 10MPPS and any optional Fixed Rate Output Faults Page This page lists all possible fault conditions of the GPS Subsystem The various faults are described below FLASH This fault indicates that the microprocessor was unable to verify a write to the FLASH non volatile parameter storage area This should not ever occur under normal operation The unit should be returned to the factory for repair FPGA This fault indicates that the microprocessor was unable to configure the FPGA This would be a fatal fault and the unit should be returned to the factory for repair Signal This fault indicates that the unit has not been able to acquire a GPS signal for one hour while the Time Figure of Merit has been 9 the unsynchronized condition This could be due to a variety of reasons If there are no other faults that could explain the inability to receive a signal then there could be an or antenna failure or blockage If the condition persists indefinitely and a problem with the antenna is not evident the unit may need to be returned to the factory for repair 86 RTM3204 GPS Timing Module User Manual HTTP INTERFACE DAC This fault indicates that the electronic frequency control DAC for the oscillator has reached either the high 55000 or low 10000 limit while locked to the GPS signal Unless the unit is being subjected to out of specification enviro
71. ght satellite numbers is displayed one for each receiver channel Satellite number 0 is an invalid number and indicates that no satellite is being tracked on that channel Valid satellite numbers range from to 32 Query gpstrkstat RTM3204 Tycho response CURRENT SVs TRKD 08 11 13 22 31 00 00 00 gpsversion This command displays the firmware and hardware versions of the GPS Subsystem Query gpsversion RTM3204 Tycho response F W 1 00 FPGA 0202 23 RTM3204 GPS Timing Module User Manual CHAPTER THREE gsyshwaddr This command displays the ethernet hardware address if the IP network is properly configured Oth erwise it returns nothing Query gsyshwaddr RTM3204 Tycho response 00 D0 C9 25 78 59 gsysosctype This command displays the installed oscillator type It is one of TCXO MS OCXO HS OCXO or US OCXO The standard oscillator is the TCXO Query gsysosctype RTM3204 Tycho response Installed Oscillator is TCXO gsyspasswd This command allows the root user to change the passwords of the two configured users on the sys tem root and gsysuser Arguments passed to gsyspasswd on the command line are passed verba tim to the real passwd binary program When passwd returns the resulting modified etc shadow file is copied to the non volatile boot etc directory To change root password Set gsyspasswd RTM3204 Tycho response The passwd interactive utility starts To change csysuser password Set gsyspasswd csysuser R
72. gies Be sure the RMA number is clearly identified on the shipping container After the equipment has been received we will evaluate the problem and contact you with the cost to repair parts and labor and an estimate of the time necessary to complete the work Limitation of Liability The remedies provided herein are Buyer s sole and exclusive remedies EndRun Technologies shall not be liable for any direct indirect special incidental or consequential damages whether based on contract tort or any other legal theory EndRun Contact Information Address EndRun Technologies 2270 Northpoint Parkway Santa Rosa California 95407 U S A Phone 707 573 8633 Fax 707 573 8619 Sales 1 877 749 3878 or 707 573 8633 sales endruntechnologies com Support 1 877 749 3878 or 707 573 8633 support endruntechnologies com RTM3204 GPS Timing Module User Manual RTM3204 GPS Timing Module User Manual Table of Contents Preface ee ee ET i About EndRun Technologies i Trademark Acknowledgements i About This Manual ii E acy eae ee ii Limitation of Warranty ii Warranty Repair zen ee eat ili Repair After Warranty Expiration ili Limitation of Liability _
73. hange the dynamic mode setting use the gpsdyn mode command Reference Position Source The source of the reference position can be Unknown Dynamic User Entered or Average 24 hour average of GPS fixes To change the reference position source use the gpsrefpos command Reference Position Latitute Longitude and WGS 84 Height The WGS 84 latitude and longitude in degrees minutes seconds format and the height above the WGS 84 reference ellipsoid in meters is shown Last Position Fix Latitute Longitude and WGS 84 Height This field shows information for the most recent position fix The WGS 84 latitude and longitude in degrees minutes seconds format and the height above the WGS 84 reference ellipsoid in meters is shown Antenna Fault Mask This field shows the current setting for the Antenna Fault Mask When the antenna fault is masked this will prevent the antenna fault from creating an alarm condition Some installations may need to mask this fault due to special antenna situations like splitters To change the Antenna Fault Mask use the setantfltmask command Signal Fault Mask This field shows the current setting for the Signal Alarm Mask When the signal alarm is masked it 34 RTM3204 GPS Timing Module User Manual HTTP INTERFACE will prevent a signal loss fault from creating an alarm condition To change the signal alarm mask use the setsigfltmask command TFOM Fault Level This field shows the threshold at which a signal loss f
74. he RTM3204 Tycho you must first set up user information and access limits for those users in etc snmpd conf Uncomment and edit these two lines to define your v3 users and their access parameters rwuser root priv 1 rouser tychouser auth 1 3 6 1 4 1 13827 The first line defines a SNMPv3 read write user root whose minimum security level will be authenti cated and encrypted for privacy choices are noauth auth and priv and who will have read write ac cess to the entire iso 1 branch of the SMI object tree The second line defines a SNMPv3 read only user tychouser whose minimum security level will be authenticated but not encrypted and who will have read only access to the entire iso org 3 dod 6 internet 1 private 4 enterprises 1 endRun TechnologiesMIB 13827 branch of the SMI object tree After adding the user lines to etc snmpd conf copy it to the boot etc directory using cp The second file is located on the non volatile FLASH disk and is used by the SNMP agent to store persistent data that may be dynamic in nature This may include the values of the MIB II variables sysLocation sysContact and sysName as well as any configured SNMPv3 user crypto keys In order to use SNMPv3 you must configure user keys in this file for each SNMPv3 user that you have set up in etc snmpd conf To do this you must add lines to boot net snmp snmpd conf like these for each user createUser root MD5 endrun_1 DES endrun_1 createUser
75. his chapter describes the RTM3204 control and status commands The RTM3204 supports several application specific commands for performing initialization setup and for monitoring the perfor mance and status of the unit You do not need knowledge of Linux commands in order to operate the RTM3204 However the RTM3204 does support a subset of the standard Linux shell commands and utilities A wealth of information is available from a variety of sources on Linux Only the RTM3204 specific commands will be described in this chapter The serial I O port physical and elec trical characteristics are defined as well The RTM3204 is a derivative of our Tycho GPS Frequency Reference As such the user interface will refer to the Tycho GPS You do not need to know Linux in order to operate the RTM3204 However for those interested the command shell used by the RTM3204 is the Linux standard bash All commands and file names are case sensitive which is standard for Unix like operating systems If you are unfamiliar with Unix like operating systems and you would like to be able to more closely monitor or optimize the performance of your RTM3204 you should consult good Linux reference books like Linux in a Nutshell Seiver O Reilly amp Associates 1999 Running Linux Welsh Dalheimer amp Kaufman O Reilly amp Associates 1999 Or the web at http www tldp org 17 RTM3204 GPS Timing Module User Manual CHAPTER THREE Available User Comman
76. hour after the worst case time error has reached the value equivalent to a TFOM of TFOM Fault Level the red LED will illuminate The fault status field returned in the gpsstat command will have the appropriate bit set to indicate a loss of signal time out condition You may control the TFOM level at which a loss of signal alarm is generated by changing the TFOM Fault Level This can be done through the console port see the settfomfltlvl and tfomfltlvl commands in Chapter 3 Control and Status Commands The factory default setting for the TFOM Fault Level is 9 The TFOM Fault Level setting only affects the point at which the loss of signal alarm is asserted 39 RTM3204 GPS Timing Module User Manual APPENDIX A 40 RTM3204 GPS Timing Module User Manual Upgrade Via The HTTP Interface EndRun DS EN TECHNOLOGIES AppendixB Upgrading the Firmware Periodically EndRun Technologies will make bug fixes and enhancements to our products available for download from our website All such downloads are freely available to our customers without charge The RTM3204 is a derivative of our standard product the Tycho GPS Frequency Reference So when upgrading software please use the software for the Tycho GPS You may securely upgrade your Tycho firmware via the HTTP interface the network port or the serial port Software upgrades for the RTM3204 Tycho are available at this link http www endruntechnologies com upgradetyc htm The
77. ings Use a DHCP server to configure the ethernet interface yles nlo n HOST name setting Set the hostname of your Tycho GPS Only the base hostname is needed not the domain Enter hostname gsys DOMAIN name setting Set the domain name Do not supply a leading Enter domain name for gsys your domain 11 RTM3204 GPS Timing Module User Manual CHAPTER TWO STATIC IP ADDRESS setting Set the IP address for the Tycho GPS Example 111 112 113 114 Enter IP address for gsys aaa bbb ccc ddd 192 168 1 245 DEFAULT GATEWAY ADDRESS setting Set the default gateway address such as 111 112 113 1 you don t have a gateway just hit ENTER to continue Enter default gateway address aaa bbb ccc ddd 192 168 1 241 NETMASK setting Set the netmask This will look something like this 255 255 255 0 Enter netmask aaa bbb ccc ddd 255 255 255 248 Calculating the BROADCAST and NETWORK addresses Broadcast 192 168 1 247 Network 192 168 1 240 Your Tycho GPS s current IP address full hostname and base hostname 192 168 1 245 gsys your domain gsys DOMAIN NAMESERVER S address setting Will your Tycho GPS be accessing a nameserver yles n o y Set the IP address of the primary name server to use for domain your domain Enter primary name server IP address aaa bbb ccc ddd 192 168 1 1 Will your Tycho GPS be accessing a secondary nameserver yles n o y Set the IP address of the
78. ion Using the netconfig script has the advantage that you can also configure the hostname and domainname for the unit and any nameservers you may want it to have access to OpenSSH By default sshd is factory configured to listen on both IPv4 and IPv6 addresses It may be forced to listen on either IPv4 only or IPv6 only by editing the etc rc d rc inet2 startup script where sshd is started and then copying it to boot etc rc d Net SNMP By default snmpd is factory configured to listen on both IPv4 and IPv6 addresses This may be changed by editing etc rc d rc local and modifying the agent address argument passed to snmpd at start up and then copying it to boot etc rc d 68 RTM3204 GPS Timing Module User Manual APPENDIX F IPv6 Capable syslog ng To enable remote syslogging to an IPv6 host you will need to edit the new etc syslog ng conf file and copy it to boot etc At boot time the presence of both the syslog ng daemon and the boot etc syslog ng conf file will cause the new IPv6 capable syslog ng daemon to be started instead of the previous syslogd klogd pair of daemons These two files remain on the system for backward compatibility with customers existing etc syslog conf setups but they are not IPv6 capable If you are not currently directing your system logs to a remote host or you are not using IPv6 then there is little need or benefit to changing to syslog ng IPv4 Only Protocols There are several protocols which
79. is Communications AB Serial driver version 5 05c 2001 07 08 with MANY PORTS SHARE_IRQ SERIAL_PCI enabled ttyS00 at 0x03f8 irq 4 is a 16550A ttyS01 at 0x02f8 irq 3 is a 16550A ttyS02 at 0x03e8 irq 0 is a ST16654 ttyS03 at 0x02e8 irq 3 is a ST16654 sc520_wdt CBAR 0x800df 000 sc520_wdt MMCR Aliasing enabled sc520_wdt WDT driver for SC520 initialised RAMDISK driver initialized 16 RAM disks of 16384K size 1024 blocksize pcenet32 c v1 28 02 20 2004 tsbogend alpha franken de PCI Enabling device 00 0d 0 0000 gt 0003 pcnet32 PCnet FAST III 79C973 at 0x1000 00 Oe fe 00 00 33 tx_start_pt 0x0c00 220 bytes BCR18 9a61 BurstWrEn BurstRdEn NoUFlow SRAMSIZE 0x1700 SRAM_BND 0x0800 assigned IRQ 12 eth0 registered as PCnet FAST III 79C973 penet32 1 cards_found Tempus SC520 flash device 1000000 at 2000000 Amd Fujitsu Extended Query Table v1 3 at 0x0040 number of CFI chips 1 Creating 7 MTD partitions on Tempus SC520 Flash Bank 0x00000000 0x000e0000 Tempus kernel mtd Giving out device 0 to Tempus kernel 0x000e0000 0x00100000 Tempus Lo BootLdr mtd Giving out device 1 to Tempus Lo BootLdr 0x00100000 0x00200000 Tempus boot mtd Giving out device 2 to Tempus boot 0x00200000 0x00300000 Tempus logs mtd Giving out device 3 to Tempus logs 0x00300000 0x00900000 Tempus FACTORY rootfs mtd Giving out device 4 to Tempus FACTORY rootfs 0x00900000 0x00fe0000
80. is License If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations then as a consequence you may not distribute the Program at all For example if a patent license would not permit royalty free redistribution of the Program by all those who receive copies directly or indirectly through you then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Program If any portion of this section is held invalid or unenforceable under any particular circumstance the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices Many peo ple have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system it is up to the author donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License 68 RTM3204 GPS Timing Module
81. ism of the RTM3204 Tycho will only send a notification to the last declared trap2sink and an inform to the last declared in formsink in the file IMPORTANT After editing ete snmpd conf you must copy it to the boot ete directory and reboot the system It is very important to retain the access mode for the file readable only by root so be sure to use cp p when performing the copy During the boot process the files contained in the boot ete directory are cop ied to the working ete directory on the system RAM disk In this way the factory defaults are overwritten 51 RTM3204 GPS Timing Module User Manual Configuration of SNMPv3 APPENDIX C If you are planning to use SNMPv3 you should definitely make use of the two resources mentioned previously NET SNMP website and Essential SNMP and study them carefully There are rather elaborate configuration options available when you are using v3 The instruction presented here will give you the flavor of the configuration but definitely not the full scope of possibilities To access your RTM3204 Tycho via v3 of SNMP you will have to configure two files etc snmpd conf boot net snmp snmpd conf The first file contains static configuration parameters that the agent uses to control access and to determine where to send notifications traps Other aspects of the agent s operation are also configu rable in this file but you should not need to modify those To use the SNMPv3 capabilities of t
82. les to carry prominent notices stating that you changed the files and the date of any change 66 RTM3204 GPS Timing Module User Manual THIRD PARTY SOFTWARE b You must cause any work that you distribute or publish that in whole or in part contains or is de rived from the Program or any part thereof to be licensed as a whole at no charge to all third parties under the terms of this License c Ifthe modified program normally reads commands interactively when run you must cause it when started running for such interactive use in the most ordinary way to print or display an announce ment including an appropriate copyright notice and a notice that there is no warranty or else saying that you provide a warranty and that users may redistribute the program under these conditions and telling the user how to view a copy of this License Exception if the Program itself is interactive but does not normally print such an announcement your work based on the Program is not required to print an announcement These requirements apply to the modified work as a whole If identifiable sections of that work are not derived from the Program and can be reasonably considered independent and separate works in themselves then this License and its terms do not apply to those sections when you distribute them as separate works But when you distribute the same sections as part of a whole which is a work based on the Program the distribution of the whole m
83. message now If not you may need to check your binary file and re perform the procedure 46 RTM3204 GPS Timing Module User Manual UPGRADING THE FIRMWARE The first message should be ignored It is only reporting that one of the intermediate processes of the script execution has been terminated The next message informs you that the GPS engine file transfer has completed and that its start up messages should appear First the bootloader message will ap pear Tempus Bootloader 6010 0050 000 v 1 00 May 28 2004 17 31 05 In about ten seconds the GPS engine application start up messages should appear FW 6010 0020 000 v 1 00 Aug 18 2004 10 47 41 FPGA 6020 0005 000 v 0202 The firmware version should match that of the binary file that you uploaded At this point the up gradegps script terminates its execution and you will again have the standard RTM3204 Tycho console prompt After about one minute you should query the GPS firmware version using the command gpsversion The upgraded version information should be displayed Problems with the GPS Subsystem Upgrade Should you have difficulties with the upgrade due to a corrupt file power failure during upload or other accident do not be alarmed Even though you may have lost the existing application program the GPS engine bootloader program will remain intact On boot up it will check to see 1 valid ap plication program is in the FLASH memory If there is not it will immedia
84. nd will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 5 You are not required to accept this License since you have not signed it However nothing else grants you permission to modify or distribute the Program or its derivative works These actions are prohibited by law if you do not accept this License Therefore by modifying or distributing the Pro gram or any work based on the Program you indicate your acceptance of this License to do so and all its terms and conditions for copying distributing or modifying the Program or works based on it 6 Each time you redistribute the Program or any work based on the Program the recipient automat ically receives a license from the original licensor to copy distribute or modify the Program subject to these terms and conditions You may not impose any further restrictions on the recipients exercise of the rights granted herein You are not responsible for enforcing compliance by third parties to this License 7 If as a consequence of a court judgment or allegation of patent infringement or for any other reason not limited to patent issues conditions are imposed on you whether by court order agree ment or otherwise that contradict the conditions of this License they do not excuse you from the conditions of th
85. nel RJ 45 connector mates with the ethernet twisted pair cable from the network Using the status LED indicators it s easy to find out if your RTM3204 will work in your desired loca tion 1 Mount the antenna on the roof using the supplied mounting hardware Make sure that it is not blocked by large metallic objects closer than one meter 2 Connect the BNC plug on the end of the antenna cable to the supplied BNC jack to SMB plug adapter cable Connect the SMB plug end of the adapter cable to the antenna input jack on the RTM3204 GPS Timing Module 3 Connect the 24VDC terminal to the positive output of the DC power source Connect the GND terminal to the negative output of the DC power source The DC power source voltage must not exceed 32V This unit will not operate if the connections are reversed however it will not be damaged by a reverse connection Note that the GND terminal is connected to the chassis inside the unit Initially upon power up 1 The unit will light the red Alarm Status LED for about ten seconds 2 Then it will continuously light the green Sync Status LED 5 RTM3204 GPS Timing Module User Manual Installing the RTM3204 GPS Timing Module CHAPTER TWO 3 When the unit locks onto a GPS signal and begins to decode the timing data and adjust the local oscillator the green Sync Status LED will flash very rapidly about a 6 Hz rate until the data is fully decoded and the local oscillator is
86. nmental conditions this would indicate that the oscillator frequency has drifted near to the end of life region This should normally only occur after about ten years of opera tion The unit will continue to function until the oscillator frequency finally reaches one of the actual DAC endpoints The unit should be returned to the factory for oscillator replacement at the your convenience Antenna This fault indicates that the GPS antenna or downlead cable has a fault It indicates either an over or under current condition Usually it means that the antenna downlead cable is not plugged into the connector on the rear of the Meridian If the condition persists after checking the antenna downlead for obvious faults this is a fatal fault and the unit should be returned to the factory for repair Polling Events This fault indicates that the GPS Subsystem is not receiving polling request from the Linux Subsys tem This could be due to a hardware or software failure If the condition persists after cycling the power to the unit this is a fatal fault and the unit should be returned to the factory for repair Time Reference This fault indicates that the microprocessor received an erroneous time input from the GPS engine If the condition persists please report it to the factory 1 877 749 3878 Network Page This page shows the IPv4 network configuration Fields are DHCP By default the RTM3204 Tycho will configure itself using the Dynamic Host C
87. ode unlocked ESTERR is the estimated time error when in coast mode in seconds MEASERR is the last measured time offset while locked in seconds TIMEDEV is the time deviation TDEV of measurements in seconds AGERATE is the regression computed oscillator ageing rate per day several hour delay before the first measurements are displayed TAU is the oscillator control loop averaging time constant in seconds DAC The oscillator control DAC value indicates the frequency control setting The system automatically sets this value to remove frequency errors Values may range from 0 to 1048575 Values close to the maximum minimum will set the DAC fault flag that will appear in the fault status display The Time Status display will also indicate a fault condition TEMP is the internal temperature in C for OCXO and Rubidium oscillators only 26 RTM3204 GPS Timing Module User Manual CONTROL AND STATUS COMMANDS Query oscctrlstat RTM3204 Tycho response Oscctristat LKD 0 2 72e 09 2 72e 09 1 23 09 0 00e 00 235 2 524332 999 999 pluginopts This command displays the outputs for the installed option board The RTM3204 is a derivative of a rackmount product the Tycho The response to this command will show five option slots available but in the RTM3204 only one is used Slot 2 Query pluginopts RTM3204 Tycho response Digital Outputs is Installed 2xTTL Port A Current Setting 10M PPS Port B Current Setting 5M PPS Port
88. on please see lt http www apache org gt Portions of this software are based upon public domain software originally written at the National Center for Supercomputing Applications University of Illinois Urbana Champaign 71 RTM3204 GPS Timing Module User Manual APPENDIX 72 RTM3204 GPS Timing Module User Manual EndRun DS EN TECHNOLOGIES Appendix Specifications The following accuracy and stability specifications assume a stationary position not dynamic mode and the antenna mounted with a full view of the sky GPS Receiver L1 Band 1575 42 MHz 8 Channels C A Code Antenna TNC jack in base of antenna housing Zout 50Q Integral 35 dB gain LNA with bandpass filter for out of band interference rejection Rugged all weather housing capable of operation over 40 C to 85 C temperature extremes Mounting via 18 long PVC pipe with stainless steel clamps 50 low loss RG 59 downlead cable standard Extension cables and low noise pre amplifiers are available as options Local Oscillator TCXO is standard 2 5x10 over 20 to 70 Rubidium is option 1x10 over 20 to 70 High Stability Rubidium is option 1x107 over 20 to 70 Time to Lock lt 5 minutes typical TCXO lt 10 minutes typical Rb Network I O Rear panel RJ 45 jack AMD PC Net Fast III 10 100Base T ethernet System Status Indicator Sync LED Green LED pulses
89. on is the number of seconds in coast mode unlocked Estimated Time Error This field shows the estimated time error when in coast mode Internal Chassis Temperature This field shows the internal temperature in C 3 RTM3204 GPS Timing Module User Manual CHAPTER FOUR Clock Page This page shows the configuration of the RTM3204 Tycho except for any optional 1 which is listed on the I O page Fields are Time Mode This field shows the current time mode setting Possible settings are UTC GPS and LOCAL This setting affects the Time Code Output To change the time mode setting use the gsystimemodecon fig command via the network serial port Local Time Offset This field shows the offset from UTC and is only valid when the Time Mode is LOCAL A positive Local Time Offset implies a longitude east ofthe Greenwich meridian To change the local offset use the gsystimemodeconfig command Daylight Savings Time DST DST Start DST End The DST fields show whether DST is enabled and if so what the DST Start and Stop Times are For example in most of the U S A the DST Start Time is the 2nd Sunday in March at 2 a m The DST End Time is the 1st Sunday in November at 2 a m To change the DST settings use the gsys timemodeconfig command 1 0 Page CPU Options A basic RTM3204 has two options installed a 1PPS and time code AM Code This page shows the settings for the 1PPS pulse width and the time code format Use commands cpuoptsconfi
90. onfiguration Protocol DHCP If you need to set up static IP configuration you must use the netconfig command via the network serial port Thie field will show whether DHCP is enabled or disabled Address Gateway Netmask These fields show the settings for the IP address gateway and netmask To change these settings use the netconfig command via the network serial port Network IPv6 Page This page shows information related to the IPv6 network parameters If your RTM3204 Tycho does not have IPv6 then there will be no fields on this page For more information on IPv6 see Appendix F IPv6 Information Network DNS Page This page shows the IP address of the primary and secondary domain name servers 37 RTM3204 GPS Timing Module User Manual Disabling The HTTP Protocol CHAPTER FOUR Firmware Page The firmware status page shows part numbers and versions of the Linux Subsystem firmware root file system and kernel and the GPS Subsystem firmware Linux Subsystem Upgrade GPS Subsystem Upgrade These pages are used for upgrading the firmware You must be logged in as root in order to have access to these pages The latest released versions of RTM3204 Tycho firmware are freely avail able on the EndRun website For detailed information on how to perform the upgrade either via the network port the serial port or the HTTP interface see Appendix B Upgrading The Firmware Only the Linux Subsystem root file system RFS and GPS Sub
91. onvection cooled 133 MHz CPU with integral ethernet interface an RS 232 serial port a High Performance Rubidium Rb oscillator and a power supply Non volatile storage of the embedded Linux operating system and the application software is via FLASH memory Standard Features In addition to sourcing precision IPPS and 10MPPS timing references and an IRIG B timecode out put your Timing Module includes a serial port and a network port The RTM3204 can be managed via the network port or a local console on the RS 232 serial port See Chapter 3 Control and Status Commands for more information Secure Network Interface An ethernet port is provided as a standard feature of the RTM3204 GPS Timing Module with a wide variety of protocols including SNMP with Enterprise MIB SSH TELNET HTTP and FTP Refer to Chapter 2 Basic Installation for information to help you set up your network interface The inclusion of SNMP v3 and SSH provides a very secure network interface and allows you to safely perform monitoring and maintenance activities over the network Security conscious users can also disable any or all of the risky protocols such as HTTP Telnet Time and Daytime In addition access via SSH SNMP and Telnet can be restricted to specific hosts Refer to Appendix C SNMP and Ap pendix D Security for further information Free FLASH Upgrades Firmware and configurable hardware parameters are stored in non volatile FLASH memory so the Timing Mod
92. ote The RTM3204 is derivative ofthe Tycho GPS Frequency Reference As such the software interface will contain references to Tycho GPS TYCHO MIB Which is located on your RTM3204 Tycho in this ASCII file usr local share snmp mibs TY CHO MIB txt In addition to a complete set of GPS status objects the MIB defines two SMIv2 notification objects e GPS Fault Status change e GPS Time Figure of Merit change The SNMP daemon snmpd is started from the etc rc d rc local system start up script with this line snmpd m MIBNAME Ls d c etc snmpd conf By default it will listen on port 161 for SNMP queries from the network management system If you would like to have it listen on another port you could edit the file by adding p port to the end of this line where port is the number of the port you would like for the agent to listen on If you would like to disable starting of the snmpd daemon altogether you can either remove this line or place a character at the beginning of the line so that it will not be executed A very compact editor with WordStar command keystrokes is available on the system for this purpose edit If you start edit without giving it a file name to open it will display its help screen showing the supported keystrokes IMPORTANT After editing ete re d re ocal you must copy it to the boot etc rc d directory and reboot the system It is very important to retain the access mode for the file so be sure to u
93. our rights with two steps 1 copyright the software and 2 offer you this license which gives you legal permission to copy distribute and or modify the software Also for each author s protection and ours we want to make certain that everyone understands that there is no warranty for this free software Ifthe software is modified by someone else and passed on we want its recipients to know that what they have is not the original so that any problems intro duced by others will not reflect on the original authors reputations Finally any free program is threatened constantly by software patents We wish to avoid the dan ger that redistributors of a free program will individually obtain patent licenses in effect making the program proprietary To prevent this we have made it clear that any patent must be licensed for everyone s free use or not licensed at all The precise terms and conditions for copying distribution and modification follow GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING DISTRIBUTION AND MODIFICATION 0 This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License The Program below refers to any such program or work and a work based on the Program means either the Program or any derivative work under copyright law that is to say a work containing the Program or a po
94. queuelen 100 Interrupt 5 Base address 0x300 lo Link encap Local Loopback inet addr 127 0 0 1 Mask 255 0 0 0 UP LOOPBACK RUNNING MTU 3924 Metric 1 RX packets 170 errors 0 dropped 0 overruns 0 frame 0 TX packets 170 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 0 Pay particular attention to the settings shown for etho and in particular the Mask setting which should match that which is appropriate for your network Now check the remaining configuration parameters using route Tycho GPS root gsys gt route Kernel IP routing table Destination Gateway Genmask Flags Metric Ref Use Iface localnet 255 255 255 248 U 0 0 0 etho loopback x 255 0 0 0 U 0 0 0 lo default 192 168 1 241 0 0 0 0 UG 1 0 0 etho Here you are interested in the default gateway address It should match the appropriate one for your network If so then the ethernet interface of your RTM3204 has been successfully configured to operate on your network and you are ready to check operation of the RTM3204 over the network If not you should recheck your configuration and or repeat the netconfig procedure 13 RTM3204 GPS Timing Module User Manual CHAPTER TWO If you have configured a nameserver s for your network you may check that by issuing this shell command Tycho GPS root gsys gt cat etc resolv conf search your domain nameserver 192 168 1 1 nameserver 192 168 1 2 Which displays the contents of the etc resolv conf file containing
95. quipment will require service we will issue an RMA number You will be asked for contact information including your name address phone number and e mail address Ship the unit prepaid in the original container or a container of sufficient strength and protection to EndRun Technologies EndRun will not be responsible for damage incurred during shipping to us Be sure the RMA number is clearly identified on the shipping container Our policy is to fix or repair the unit within 5 business days If it is necessary to order parts or if other circumstances arise that require more than 5 days an EndRun service technician will contact you Loaner units are not included as part of the standard warranty Repair After Warranty Expiration If the warranty period has expired we offer repair services for equipment you have purchased from EndRun Call and ask for a customer service agent It is important to contact us first as many prob lems may be resolved with a phone call Please have the serial number of the unit and the nature of the problem available before you call Ifit is determined that the equipment has failed and you want EndRun to perform the repairs we will issue you an RMA number Ship the unit prepaid in the original container or a container of sufficient strength and protection to EndRun Technologies EndRun will not be responsible for damage incurred during shipping to us Customer is responsible for shipping costs to and from EndRun Technolo
96. r regular HTTP HTTPS enhances security because it encrypts and decrypts the requested and returned pages from the server The HTTP implementation is built from the standard Apache 1 3 33 distribution from http httpd apache org See Appendix D Security for information on changing the default HTTP configuration and SSL certificates IMPORTANT The domain name server IP address is required by the Apache web server When using netcon ig see Chapter 3 Control and Status Commands to configure the TCP IP parameters be sure to config ure the name server Only one name server is required two gives some redundancy The HTTP Interface will not start if this is configured incorrectly 31 RTM3204 GPS Timing Module User Manual HTTP Interface Description CHAPTER FOUR For security reasons the web pages on the RTM3204 Tycho show status information only You cannot reconfigure the RTM3204 Tycho except for upgrading firmware which is done with several security measures in place To reconfigure the RTM3204 Tycho you will need to use the network or serial port command line interface For proper operation your web browser must be configured to allow pop up windows and have Javascript enabled To get started with the web interface simply point your browser to the IP address of the Tycho and log in securely with HTTP For example http 192 168 1 1 A warning dialog page will be presented for the certificate Acknowledge the dialog page an
97. ration of the various SSH implementations including OpenSSH is available from O Reilley amp Associates SSH The Secure Shell Barrett amp Silverman O Reilley amp Associates 2001 In the interest of conserving scarce system memory resources only the secure shell server daemon sshd and the secure copy utility sep are implemented in RTM3204 Tycho This means that users on remote hosts may log in to the RTM3204 Tycho via an ssh client but users logged in on the RTM3204 Tycho are unable to log in to a remote host via ssh Since sep runs in concert with an ssh client the same limitations exist for its use i e users on remote hosts may transfer files to and from the RTM3204 Tycho via sep over ssh but users logged in on the RTM3204 Tycho are unable to transfer files to and from a remote host via sep over ssh The factory configuration contains a complete set of security keys for both SSH1 and SSH2 versions of the protocol RSA keys are supported by both versions and DSA keys are supported when using the SSH2 version In addition the RTM3204 Tycho is factory configured with a set of public keys for passwordless public key authentication of the root user To use this capability the corresponding set of private keys for each of the two SSH versions are provided in the boot root directory of the RTM3204 Tycho Three files contain these keys identity SSH1 id_rsa SSH2 and id_dsa SSH2 These must be copied to the user s root s
98. rc local e Access via SNMP is configurable to provide the security of the latest version 3 Internet standard which supports both view based access control and user based security using modern encryption techniques Previous versions vl and v2c supported access control essentially via passwords trans mitted over the network in plain text Refer to Appendix C Simple Network Management Protocol which is dedicated to configuration of SNMP for details e Individual host access to protocol server daemons such as in telnetd snmpd or sshd may be controlled by the tepa daemon and directives contained in the files etc hosts allow and etc hosts deny e Risky protocols like TIME DAYTIME and TELNET may be completely disabled by configura tion of the inetd super server daemon The last two topics are supported on the RTM3204 Tycho by a pair of shell scripts which ease con figuration for the inexperienced user of Unix like operating systems These are accessconfig and inetdconfig Using Edit A very compact editor with WordStar command keystrokes is available on the system for editing files edit If you start edit without giving it a file name to open it will display its help screen showing all supported keystrokes By default the unit is configured to allow access by all users via Telnet SSH and SNMP To ensure security you should restrict access by using the accessconfig command accessconfig modifies two files which are used by tepd and
99. rotect the factory root file system from accidental erasure or over writing the device node has been deleted The upgrade FLASH disk partition is accessed via dev rootfs_1 When performing an upgrade you will be copying the new image to this device Some browsers will automatically unzip the file when downloading from the website Please make sure that the downloaded file size matches what the website says it should be Upgrading the partition with a too large file size will cause problems To perform the upgrade log in as the root user to the RTM3204 Tycho using the local console serial I O port telnet or ssh and perform these operations First erase the upgrade partition by issuing this command at the shell prompt eraserootfs_1 If you are using tp to perform the upgrade transfer the previously downloaded file using binary transfer mode from the remote host to dev rootfs_1 on your RTM3204 Tycho using FTP The root file system image will be named with the software part number and version like 60 0 004x 000_ 3 00 gz When following the instructions below substitute the name of the actual root file system image that you are installing for 60 0 004x 000_3 00 gz Issue these commands from the console of your RTM3204 Tycho ftp remote_host perform ftp login on remote host bin set transfer mode to binary get 6010 004x 000_3 00 gz dev rootfs_1 transfer the file quit close the ftp session after transfer 43 RTM3204 GPS Timing Mo
100. rtion of it either verbatim or with modifications and or translated into another language Herein after translation is included without limitation in the term modification Each licensee is addressed as you Activities other than copying distribution and modification are not covered by this License they are outside its scope The act of running the Program is not restricted and the output from the Program is covered only if its contents constitute a work based on the Program independent of having been made by running the Program Whether that is true depends on what the Program does 1 You may copy and distribute verbatim copies of the Program s source code as you receive it in any medium provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty keep intact all the notices that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy of this License along with the Program You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in exchange for a fee 2 You may modify your copy or copies of the Program or any portion of it thus forming a work based on the Program and copy and distribute such modifications or work under the terms of Section 1 above provided that you also meet all of these conditions a You must cause the modified fi
101. ry file that was uploaded See Performing the GPS Upgrade in Appendix B Upgrading the Firmware for more information Set upgradegps tmp 6010 0020 000 bin RTM3204 Tycho response When you see the character hit lt enter gt to begin the upload Waiting for download using XMODEM 128 or XMODEM 1K both with CRC Control X will abort download ccc Starting file upload should take about 90 seconds sbin upgradegps line 26 27618 Terminated cat lt dev arm_user You should see the GPS subsystem startup message now If not you may need to check your binary file and re perform the procedure Tempus Bootloader 6010 0050 000 v 1 00 May 28 2004 17 31 05 FW 6010 0020 000 v 1 00 Aug 18 2004 10 47 41 FPGA 6020 0005 000 v 0202 29 RTM3204 GPS Timing Module User Manual CHAPTER THREE upgradekernel This script allows the user to change the Linux kernel firmware It requires one argument the path to the file to be uploaded to the RTM3204 Tycho Changing the Linux kernel firmware will enable IPv6 operation and should only be done if you have a requirement for IPv6 See Appendix F IPv6 Information and Performing the Linux Kernel Upgrade in Appendix B Upgrading the Firmware for more information Set upgradekernel tmp newkernelimage RTM3204 Tycho response Interactive shell script is started RS 232 Serial 1 0 Port Signal Definitions The RS 232 DB9M connector on the rear panel of the Tycho is wired as shown
102. s configured to provide them You may optionally configure the RTM3204 to also set its hostname via DHCP if your DHCP server is configured to provide it You can do this by running a simple shell script called netconfig after your unit is up on the network If your network does use DHCP for host configuration and you are in a hurry to get your RTM3204 up and running you may procede to Verifying Network Configuration to make sure that the network parameters were set up correctly Otherwise it is recommended that you read the following sections on use of the RS 232 serial I O port now since they will help you in debugging any problems that you may encounter with the automatic configuration via DHCP If your network does not use DHCP you will need to configure your ethernet interface using the RS 232 serial I O port The following sections contain brief descriptions on how to do that Configuring Ethernet with the Serial Port To configure your ethernet interface with the serial port after logging in as the root user you must run a simple shell script called netconfig from the bash shell prompt This shell script will prompt you for the needed information and perform some syntax checking on your inputs Then it will create or modify the appropriate files needed to configure the ethernet interface The following sections will guide you in setting up communications with the RTM3204 using its RS 232 serial I O port Connect the RS 232 Serial 1 0 Por
103. se cp p when performing the copy During the boot process the files contained in hoot etc rc d directory are copied to the work ing ete re d directory on the system RAM disk In this way the factory defaults are overwritten You should be able to compile the TYCHO MIB file on your SNMP management system and access the variables defined therein The factory default community names are TychoGPS for the read only community and endrun_1 for the read write community This is all that is required for opera tion under vl and v2c of SNMP Change Default Community Strings Passwords To ensure security you should change the default community names by editing etc snmpd conf and modifying these two lines 50 RTM3204 GPS Timing Module User Manual Configuring SNMPv1 Trap Generation Configuring SNMPv2c Notifications and Informs SIMPLE NETWORK MANAGEMENT PROTOCOL SNMP rwcommunity endrun_1 rocommunity TychoGPS To have your RTM3204 Tycho send SNMPv1 traps RFC 1215 you must configure the community and destination for SNMPv1 traps by uncommenting and editing this line in etc snmpd conf trapsink trapcommunity trapport where trapcommunity should be replaced by your community and xxx xxx xxx xxx is the IP address or hostname of the destination host for receiving the traps generated by the RTM3204 Tycho By default the trap will be sent to port 162 You may optionally add another paramet
104. secondary name server to use for domain your domain Enter secondary name server IP address aaa bbb ccc ddd 192 168 1 2 Setting up TCP IP Creating etc HOSTNAME Creating etc rc d rc inetl Creating etc networks Creating etc hosts Creating etc resolv conf 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 203 LA 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 203 The Tycho GPS network configuration has been updated Please re boot now for the changes to take effect k k k k k k k k k k k k k k k k k k k k k k k K K K O K K O K KO KO K KO R K KO KO O KO KO O KO RO RO KO KO RO KO KO R k K O O KO RO RO RO RO RO KOR RO RO O RO O RO RO O O k k k k k k k k k k k k k k k k k k k k k k k k k k 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 203 Verify Network Configuration If you have made changes to your network configuration using netconfig you should shutdown the RTM3204 and reboot it There are two ways to do this 1 Cycle power to the RTM3204 2 Issue the shutdown with reboot command at the shell prompt Tycho GPS root gsys gt shutdown r now 12 RTM3204 GPS Timing Module User Manual BASIC INSTALLATION
105. ser Manual APPENDIX D 0 RTM3204 GPS Timing Module User Manual EndRun KG ON TECHNOLOGIES Appendix E Timecode Formats A standard feature of your RTM3204 GPS Timing Module is a single timecode output available at the rear panel SMB connector identified as AM CODE A DC shift time code output is available via the optional Programmable TTL Output The output code format is selectable via a console command See cpuopts in Chapter 3 Control and Status Commands Each format is described below Time codes are commonly used to provide time information to external devices such as displays magnetic tape devices strip chart recorders and several types of embedded computer peripheral cards IRIG B122 This is the most widely used format and is normally the factory default for the AM Code output The IRIG B122 format is a 100 pps code and is used to amplitude modulate a 1000 kHz sine wave carrier The information contained in the timecode is seconds through day of year coded in Binary Coded Decimal BCD Reference IRIG Document 104 60 IRIG B123 In addition to the time information identified in B122 above this format also contains Straight Binary Seconds SBS of day SBS is provided at the end of the frame in the 17 bits starting in position 80 IEEE Standard 1344 1995 This standard provides for the addition of time status data in the control bit positions of IRIG B The information provided there is Unit and Tens of Years Leap
106. setting you must run this script as root Settings made using this command are non volatile Set gsystimemodeconfig RTM3204 Tycho response Interactive shell script is started gsysversion This command displays the firmware version and build date of the Linux Subsystem root file sys tem Query gsysversion RTM3204 Tycho response Tycho GPS 6010 0042 000 v 2 00 Wed Jan 16 22 38 21 UTC 2004 help This command displays a list of the RTM3204 Tycho commands not Linux commands To get help on a particular command you would type help followed by the command Query help RTM3204 Tycho response RTM3204 Tycho commands are displayed Query help gpsstat RTM3204 Tycho response Information specific to the gpsstat command is displayed inetdconfig This command starts an interactive shell script that will allow the user to configure the list of protocol servers which are started by the inetd server daemon running in the RTM3204 Tycho Three proto col servers may be configured TIME DAYTIME and TELNET By default the unit is configured to start all of these protocol servers If you need to disable start up of some or all ofthese e g for security reasons you must run this script as root from either the RS 232 serial I O port or from a telnet or ssh session This script modifies the etc inetd conf file which is non volatilely stored in the FLASH disk boot etc directory You must reboot the RTM3204 Tycho after running this script for
107. sh directory on their remote computer Be careful to maintain the proper ownership and access permissions by using ep p when copying the files They MUST be readable only by root The corresponding public keys by factory default resident in the root ssh direc tory of the RTM3204 Tycho Two files contain these keys authorized_keys SSH1 and authorized_ keys2 SSH2 Since the provided private keys are not passphrase protected the user should create a new set of keys after verifying operation with the factory default key sets After creating the new keys the 58 RTM3204 GPS Timing Module User Manual HTTP SECURITY public keys should be copied to the boot root ssh directory of the RTM3204 Tycho At boot time the RTM3204 Tycho will copy these to the actual root ssh directory of the system ramdisk thereby replacing the factory default set of public keys Advanced users wishing to modify the configuration of the sshd daemon should edit the etc sshd_ config file and then copy it to the boot etc directory of the RTM3204 Tycho Be careful to maintain the proper ownership and access permissions by using cp p when copying the file At boot time it will be copied to the etc directory of the system ramdisk thereby replacing the factory default configuration file To disable the SSH protocol see Disable SSH above The HTTP server in the RTM3204 Tycho is built from the standard Apache 1 3 33 distribution from http httpd apach
108. should normally only occur after about ten years of operation The unit will continue to function until the oscillator frequency finally reaches one of the actual DAC endpoints The unit should be returned to the factory for oscillator replacement at the customer s convenience Note The value referred to here is the upper 16 bits of a 20 bit DAC value No Signal Time Out This bit indicates that the unit has not been able to acquire a GPS signal for one hour while the Time Figure of Merit has been equal to the TFOM Fault Level see the sett fomfltlvl command This could be due to a variety of reasons If there are no other faults that could explain the inability to receive a signal then there could be an or antenna failure or blockage If the condition persists indefinitely and a problem with the antenna is not evident the unit may need to be returned to the factory for repair 22 RTM3204 GPS Timing Module User Manual CONTROL AND STATUS COMMANDS FPGA Config Fault This bit indicates that the microprocessor was unable to configure the FPGA This would be a fatal fault and the unit should be returned to the factory for repair FLASH Write Fault This bit indicates that the microprocessor was unable to verify a write to the FLASH non volatile parameter storage area This should not ever occur under normal opera tion The unit should be returned to the factory for repair GPS Comm Fault This bit indicates that the microprocessor is unable
109. system can be upgraded via the HTTP interface To upgrade the Linux Subsystem kernel see Appendix B Upgrading the Firmware Per forming the Linux Kernel Upgrade Reboot This page will allow you to perform a software reboot of both the Linux Subsystem and the GPS Subsystem This is normally used after a firmware upgrade but can be done anytime you wish to reset the RTM3204 Tycho To disable HTTP you need to edit a system start up script called etc rc d rc local This script starts several daemons You can either remove the line that lists HTTP or you can place a character at the beginning of the line so that it will not be executed A very compact editor with WordStar command keystrokes is available on the system for this purpose edit If you start edit without giving it a file name to open it will display its help screen showing the supported keystrokes IMPORTANT After editing etc rc d rc local you must copy it to the boot ete re d directory and reboot the system It is very important to retain the access mode for the file so be sure to use cp p when performing the copy During the boot process the files contained in boot etc re d directory are copied to the work ing ete re d directory on the system RAM disk In this way the factory defaults are overwritten 38 RTM3204 GPS Timing Module User Manual EndRun KG ON TECHNOLOGIES Appendix A Time Figure of Merit TFOM This appendix describes the Time Figure of
110. t You will need to use the RS 232 serial I O port if your network does not support the Dynamic Host Configuration Protocol DHCP In that case you must be able to configure the RTM3204 network parameters manually using the Linux console shell interface which is provided by this serial I O port Under certain conditions you may also need to use the RS 232 serial I O port if you encounter a problem while upgrading the firmware in your RTM3204 To test serial communications with the RTM3204 you will need either a VT 100 compatible terminal or a terminal emulation program running on your computer We will refer to either of these as termi nal for the remainder of this instruction 1 Disconnect power from the RTM3204 2 Connect one end of the DB9F to DB9F null modem adapter cable to the serial I O jack on the RTM3204 3 Connect the other end of the DB9F to DB9F null modem adapter cable to the terminal If the serial I O port on your terminal does not have a DB9M connector you may need to use an adapter Refer to Chapter 3 RS 232 Serial 1 0 Port Signal Definitions for details on the signal wiring Jf you are using a computer for your terminal remember which port you are using because you will need to know that in order to set up your terminal software 7 RTM3204 GPS Timing Module User Manual CHAPTER TWO Test the Serial Port You must configure your terminal to use the serial I O port you used in Connect the RS 232 Serial 1 0 Port
111. t updaterootflag 1 RTM3204 Tycho response UPGRADE is the default root file system Query updaterootflag 2 RTM3204 Tycho response UPGRADE is the default root file system upgradegps This script allows the user to upgrade the GPS Subsystem firmware It requires one argument the path to the binary file to be uploaded to the GPS engine It issues the commands over the serial port to the GPS Subsystem that are needed to start the X modem file transfer and then displays the responses from the GPS Subsystem to the console When the X modem C character appears indicating that the GPS Subsystem is ready to receive the file you must hit the lt ENTER gt key and the transfer will begin After about one minute it should complete at which point you should see the GPS Subsystem boot messages appear on the console From these you will be able to verify that the firmware was successfully upgraded In the example console output below lines which begin with are generated by the upgradegps script All other lines are from the GPS Subsystem with the exception of the shell message indicat ing that the process cat lt dev arm_user has been terminated which is normal In this example the character was received three times before the user hit the lt ENTER gt key to begin the transfer The last three lines are the boot messages that are sent by the GPS Subsystem as it comes up The firmware version should match that of the bina
112. t defective then Buyer shall pay for all shipping charges If Buyer is located outside the U S A then Buyer shall pay all duties and taxes if any Products not manufactured by EndRun Technologies but included as an integral part of a system e g peripherals options are warranted for ninety days or longer as provided by the original equipment manufacturer from date of shipment Limitation of Warranty The foregoing express warranty shall not apply to defects resulting from improper or inadequate maintenance by Buyer or User Buyer supplied software or interfacing unauthorized modification or misuse operation outside of the environmental specifications for the product or improper site prepa ration or maintenance TO THE EXTENT PERMITTED BY LAW THIS WARRANTY AND REMEMDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHER WARRANTIES REMEDIES AND CONDITIONS WHETHER ORAL OR WRITTEN STATUTORY EXPRESS OR IMPLIED AS PERMITTED BY APPLICABLE LAW ENDRUN SPECIFICALLY DISCLAIMS THE IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE RTM3204 GPS Timing Module User Manual Warranty Repair If you believe your equipment is in need of repair call EndRun Technologies and ask for a customer service agent It is important to contact us first as many problems may be resolved with a phone call Please have the serial number of the unit and the nature of the problem available before you call If it is determined that your e
113. tely go into the waiting for download mode You may verify this by issuing this command cat lt dev arm_user You should now see the C character being received every three seconds This is the character that the GPS engine bootloader sends to indicate to the XMODEM utility that it is wating for a download You may now retry the upload procedure assuming that you have corrected any original problem with the binary file First kill the cat command by typing CTRL C You should see a command prompt Now issue this command to re transfer the binary file upgradegps tmp 6010 0020 000_3 01 bin 47 RTM3204 GPS Timing Module User Manual APPENDIX B Recover Command Sometimes a user will attempt to download the wrong file to the GPS Subsystem When this happens the recovery method above will not work After issuing the cat command above you will not see a series of characters but instead you will see the bootloader message being output every few seconds In this case you need to use a different recovery procedure First make sure the above cat command is killed by typing CTRL C Then enter anew cat com mand as cat lt dev arm_user amp You should again be seeing the bootloader message every few seconds Tempus Bootloader 6010 0050 000 v 1 00 May 28 2004 17 31 05 Please type the following command but do not press enter echo e recover r gt dev arm_user Now wait until you see another bootloader message
114. the changes to take effect 25 RTM3204 GPS Timing Module User Manual CHAPTER THREE Set inetdconfig RTM3204 Tycho response Interactive shell script is started netconfig This command starts an interactive shell script that will allow the user to configure the IP network subsystem of the RTM3204 By default the unit is configured to configure itself using the Dynamic Host Configuration Protocol DHCP If you need to set up static IP configuration you must run this script as root from the RS 232 serial I O port during the installation process Refer to Chapter 2 Using netconfig to Set Up Your IP for details on the use of the command This script creates or modifies these files etc HOSTNAME etc hosts etc networks etc resolv conf and etc rc d rc inetl All of these are non volatilely stored in the FLASH disk boot etc directory You must reboot the RTM3204 Tycho after running this script for the changes to take effect Set netconfig RTM3204 Tycho response Interactive shell script is started oscctristat This command displays the current settings for the oscillator control parameters These parameters are used to discipline the oscillator The command formats the data and prints this fixed length string having these fields Oscctrlstat LKSTAT COAST ESTERR MEASERR TIMEDEV AGERATE TAU DAC TEMP Where LKSTAT is the GPS Subsystem control status either acquiring locking or locked COAST is the number of seconds in coast m
115. to establish commu nications with the GPS engine Please report this fault condition to the factory 1 877 749 3878 Time Input Fault This bit indicates that the microprocessor received an erroneous time input from the GPS engine If the condition persists please report it to the factory 1 877 749 3878 No Polling Events This bit indicates that the GPS Subsystem is not receiving polling re quest from the Linux Subsystem SYSTIMED daemon This could be due to a hardware or software failure If the condition persists after cycling the power to the unit this is a fatal fault and the unit should be returned to the factory for repair Antenna Fault This bit indicates that the GPS antenna or downlead cable has a fault It indicates either an over or under current condition Usually it means that the antenna downlead cable is not plugged into the connector on the rear of the RTM3204 If the condition persists after checking the antenna downlead for obvious faults this is a fatal fault and the unit should be returned to the factory for repair The example response indicates that there has been a period without tracking a GPS signal that ex ceeded the time out period that there was a FLASH Write Fault and that there is an Antenna Fault Query gpsstat RTM3204 Tycho response LOCKED TFOM 4 2001 092 04 48 56 347916732 13 13 2 7 28605 41 6 008A gpstrkstat This command displays the current GPS Subsystem satellite tracking status A list of ei
116. to indicate GPS lock status Network LED Amber LED pulses to indicate network activity Alarm LED Red LED indicates a serious fault condition exists 73 RTM3204 GPS Timing Module User Manual APPENDIX H 1 PPS Output 1 PPS Positive TTL pulse into 500 User Selectable Width 20 us 1 ms 100 ms 500 ms User Calibration 500 microseconds 1 nanosecond resolution Accuracy lt 20 nanoseconds RMS to GPS Time when locked lt 10 nanoseconds RMS to GPS Time when locked with 10 Nanosecond Calibration Option Alignment Within 10 ns of the other TTL outputs in this unit except the optional DDS Stability TDEV lt 10 ns lt 10 seconds Oy T lt 1 10713 1 10 secs Rise Time lt 2 ns Holdover Accuracy lt 5 microseconds to UTC for up to 24 hours after 72 hours locked to GPS with a maximum of 5 C peak peak variation in temperature with the Rubidium lt 1 microsecond with the High Stability Rubidium lt 100 nanoseconds to UTC Constraints in the official GPS specification prohibit claiming an ac curacy to UTC better than 100 nanoseconds 10M PPS Output Signal Positive TTL pulse into 50Q Accuracy lt 1x 10713 to UTC for 24 hour averaging times when locked Stability See Alignment Within 10 nanoseconds of the other TTL outputs in this unit Stability Allan Deviation Table below Stability Allan Deviation Table Does NOT pertain to the Synthesized Rates Optional DDS Outputs Tau in Seconds TCXO R
117. tychouser SHA TychoGPS The first line will cause the agent snmpd to create a user root who may be authenticated via Mes sage Digest Algorithm 5 MDS with password endrun_ and may use the Data Encryption Standard DES to encrypt the session data with passphrase endrun_1 The second line will cause a user tychouser to be created who may be authenticated using the Secure Hash Algorithm SHA with pass word TychoGPS_0 Passwords and passphrases must have a minimum of 8 characters or you will not be able to be authenticated 52 RTM3204 GPS Timing Module User Manual Disabling The SNMP Protocol SIMPLE NETWORK MANAGEMENT PROTOCOL SNMP IMPORTANT You must kill the snmpa process prior to editing hoot net snmp snmpd conf Otherwise the secret key creation may not complete properly Issue the command ps e to have the operating system dis play the list of running processes Look for the PID of the snmpa process and issue the kill command to stop it For example if the PID listed for the snmpa process is 53 then you would issue this command kill 53 You can verify that the process was terminated by re issuing the ps e command After rebooting the agent will read the boot net snmp snmpd conf configuration file and compute secret key s for each of the users and delete the createUser lines from the file It will then write the secret key s to the file These lines begin with the string usmuser In this way un encrypted passwords are not
118. uch third party acknowledgments normally appear 4 The names Apache and Apache Software Foundation must not be used to endorse or promote products derived from this software without prior written permission For written permission please contact apache apache org N 5 Products derived from this software may not be called Apache nor may Apache appear in their name without prior written permission ofthe Apache Software Foundation THIS SOFTWARE IS PROVIDED IS AND ANY EXPRESSED OR IMPLIED WARRANTIES INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT INDIRECT INCIDENTAL SPECIAL EXEMPLARY OR CONSEQUENTIAL DAMAGES INCLUDING BUT NOT 70 RTM3204 GPS Timing Module User Manual THIRD PARTY SOFTWARE USE DATA OR PROFITS OR BUSINESS INTERRUPTION HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY WHETHER IN CONTRACT STRICT LIABILITY OR TORT INCLUDING NEGLIGENCE OR OTHERWISE ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE This software consists of voluntary contributions made by many individuals on behalf of the Apache Software Foundation For more information on the Apache Software Foundati
119. ule can be easily upgraded in the field using HTTP FTP and TELNET or the local RS 1 RTM3204 GPS Timing Module User Manual GPS Timing How It Works Where to Use It CHAPTER ONE 232 serial I O port Secure upgrades are possible via SSH and SCP We make all firmware upgrades to our products available to our customers free of charge For firmware upgrade procedures refer to Appendix B Upgrading the Firmware The time and frequency engine in the RTM3204 receives transmissions from satellites that are operat ing in compliance with the Navstar GPS Interface Control Document ICD known as GPS ICD 200 It specifies the receiver interface needed to receive and demodulate the navigation and time transfer data contained in the GPS satellite transmissions The GPS navigation system requires a means of synchronizing the satellite transmissions throughout the constellation so that accurate receiver to sat ellite range measurements can be performed via time of arrival measurements made at the receiver For the purposes of locating the receiver measurements of the times of arrival of transmissions from at least four satellites are needed For accurate time transfer to a receiver at a known position recep tion of the transmissions from a single satellite is sufficient The GPS system designers defined system time to be GPS time GPS time is maintained by an ensemble of high performance cesium beam atomic frequency standards located on the earth s surf
120. user When you initiate a telnet session with the RTM3204 this banner will be displayed E22 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 202 Welcome to Tycho GPS telnet console on gsys your domain LE 2 k k k k k k k k k k k k k k k k k k k 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 203 gsys login Here you may log in as gsysuser with password Praecis When logged in as you may check status information and view log files but you will not be able to modify any system settings or view secure files After correctly entering the password at this prompt Password the sign on message is shown It identifies the host system as Tycho GPS and shows the software part number version and build date Tycho GPS 6010 0004 000 v 1 00 Wed May 16 14 17 44 UTC 2002 Tycho GPS root gsys gt 14 RTM3204 GPS Timing Module User Manual BASIC INSTALLATION This last line is the standard RTM3204 Tycho shell prompt The RTM3204 Tycho uses the bash shell which is the Linux standard full featured shell After configuring the unit you should change the passwords using the gsyspasswd command issued from the shell prompt To gain root access you must now issue the super user command at the shell prompt Tycho GPS root gsys gt su root
121. ust be on the terms of this License whose permissions for other licensees extend to the entire whole and thus to each and every part regardless of who wrote it Thus it is not the intent of this section to claim rights or contest your rights to work written entirely by you rather the intent is to exercise the right to control the distribution of derivative or collective works based on the Program In addition mere aggregation of another work not based on the Program with the Program or with a work based on the Program on a volume of a storage or distribution medium does not bring the other work under the scope of this License 3 You may copy and distribute the Program or a work based on it under Section 2 in object code or executable form under the terms of Sections and 2 above provided that you also do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distribution a complete machine readable copy of the corresponding source code to be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or c Accompany it with the information you received
122. y During the boot process the files contained in the boot etc rc d directory are copied to the work ing etc rc d directory on the system RAM disk In this way the factory defaults are overwritten 5 RTM3204 GPS Timing Module User Manual APPENDIX C 54 RTM3204 GPS Timing Module User Manual Linux Operating System EndRun DES ON TECHNOLOGIES AppendixD Security Your RTM3204 incorporates several important security features to prevent unauthorized tampering with its operation Many of these are standard multiple user access control features of the underlying Linux operating system which controls the RTM3204 Others are provided by the additional protocol servers selected for inclusion in your RTM3204 and the way that they are configured Secure user authentication and session privacy while performing routine monitoring and mainte nance tasks are provided by the OpenSSH implementations of the secure shell daemon sshd and its companion secure copy utility scp Secure monitoring via web browser is provided by the Apache implementation of the Hyper Text Transport Protocol HTTP with Secure Sockets Layer SSL daemon httpd The NET SNMP implementation of the Simple Network Management Proto col SNMP daemon snmpd conforms to the latest Internet standard known as SNMPv3 which also supports secure user authentication and session privacy IMPORTANT SSH Telnet SNMP and HTTP are all enabled with default passwords
123. y if anything is missing or damaged The RTM3204 GPS Timing Module shipment typically contains RTM3204 GPS Timing Module part 3204 0101 000 or 3204 variant e RTM3204 User Manual part 3204 0100 000 on CD part 5102 0001 000 Basic Cable Kit part 0648 0002 000 including RJ 45 to RJ 45 CAT 5 patch cable 2 meters DB9F to DB9F null modem serial I O cable Antenna Kit part 0610 0010 001 including GPS antenna Pipe clamps for outside antenna mounting Inside window mount kit 50 TNC BNC RG 59 U coaxial cable assembly Starter Kit part 0608 0003 001 including 6 SMB BNC adaptor cable qty 2 DC power connector and crimp pins 36 DC power cable 3 RTM3204 GPS Timing Module User Manual Physical Description CHAPTER TWO ANTENNA Sync LED Network LED Alarm LED Antenna Jack RS 232 Connector 1PPS Jack 10MPPS Jack AM Code Jack me AM CODE 10MPPS I PPS SPARE FRONT PANEL This green LED flashes to indicate synchronization status This amber LED illuminates when the RTM32304 is connected to the network and flashes when receiving or transmitting packets This red LED illuminates briefly at power up and thereafter whenever a serious fault condition exists This SMB connector mates with the downlead cable from the external antenna This DB 9M connector provides the RS 232 serial I O console interface to the RTM3204 This console
124. your domain name and the nam eserver IP address es to use for that domain Check Network Operation With your RTM3204 network parameters properly configured you are ready to test the setup using ping from a server or workstation that is able to access the network connected to the RTM3204 Alternatively you could ping one of your servers or workstations from the RTM3204 Tycho shell prompt to test the setup Once you have successfully established network communications with the RTM3204 you may per form all maintenance and monitoring activities via telnet and ftp The RTM3204 Tycho provides both client and server operation using telnet For security reasons as well as to reduce the memory footprint in the RTM3204 Tycho only client operation is supported using ftp Security conscious users will want to use ssh the secure shell replacement for telnet as the login means The companion utility sep provides a secure replacement for ftp as a means of transferring files to and from the RTM3204 Tycho Both of these protocols are supported in the RTM3204 via the OpenSSH implementations for Linux Refer to Appendix D Security for more information about the secure shell protocol Using Telnet When establishing a telnet connection with your RTM3204 logging in directly as root is not per mitted This is a security measure that makes it slightly more difficult to gain access by simply trying passwords since it is also necessary to know the name of a

User Manual - EndRun Technologies

Contents

Download Pdf Manuals

Related Search

Related Contents