imported>Ve7fet |
|
| (44 intermediate revisions by 7 users not shown) |
| Line 1: |
Line 1: |
| − | The Micro-Node RTCM and VOTER interfaces are typically used with AllStar in voting/simulcast applications. They MAY be used for ANY repeater interface application, through the chan/voter channel driver.
| + | = Introduction = |
| | | | |
| − | The VOTER is the original through-hole board designed by Jim Dixon for this application. It is open-source, and the relevant Gerber files and BoM to build it are available. | + | The Radio Thin Client Module (RTCM) is [http://www.micro-node.com/thin-m1.shtml commercially available] hardware for interfacing radios to an AllStarLink computer. |
| | | | |
| − | The [http://www.micro-node.com/thin-m1.shtml Micro-Node Radio Thin Client Module (RTCM)] is the commercial version of the VOTER. It uses surface mount parts (SMT), but is functionally equivalent to the original VOTER.
| + | <gallery mode=nolines> |
| | + | File:Rtcm2-750.jpg |
| | + | File:Rtcm1-750.jpg |
| | + | File:Rtcm3-750.jpg |
| | + | </gallery> |
| | | | |
| − | In general, the two terms (RTCM/VOTER) are used interchangeably, as they operate the same, and use the same firmware (mostly, see below).
| + | The Micro-Node RTCM (and [[VOTER-Hardware | VOTER]]) interfaces are typically used with AllStar in voting/simulcast applications. They '''MAY''' be used for '''ANY''' repeater interface application, through the <code>chan_voter</code> channel driver, as they are primarily a Radio over IP (ROIP) adapter. |
| | | | |
| − | This page will highlight some of the operational concerns, quirks, bugs, and other items of interest that relate to these interfaces. Much of the information has been gleaned off the AllStar mail list, comes from personal experience, or comes from notes in the firmware source code.
| + | The [[VOTER]] is the original [[VOTER-Hardware | through-hole board]] designed by Jim Dixon (SK) for this application. It is open-source, and the relevant Gerber files and BoM to build it are [https://github.com/AllStarLink/Voter/blob/master/VOTER-pcb/voter-cad-rev-a.zip available]. |
| | | | |
| | + | The [http://www.micro-node.com/thin-m1.shtml Micro-Node Radio Thin Client Module (RTCM)] is the commercial version of the VOTER. It uses surface mount parts (SMT), but is functionally equivalent to the original [[VOTER-Hardware | VOTER]]. In general, the two terms (RTCM/VOTER) are used interchangeably, as they operate the same, and use the same firmware (mostly, see below). |
| | | | |
| − | =Firmware=
| |
| − | The firmware in the RTCM and VOTER is the same, except it is compiled for the specific dsPIC that is installed in each. As such, the firmware is specific to the VOTER or the RTCM, and is NOT interchangeable (it won't boot in the wrong device). Firmware for the RTCM is denoted by "smt" in the filename.
| |
| | | | |
| − | The VOTER uses a dsPIC33FJ128GP802 and the RTCM uses a dsPIC33FJ128GP804.
| + | = Firmware = |
| | | | |
| − | There are '''two parts''' to the firmware, a bootloader, and then the actual firmware file. The bootloader starts when power is applied, and allows you to talk to the dsPIC and load new firmware files over ethernet. If the bootloader is not intercepted by the loading tool, it will continue to boot the current firmware file.
| + | See the [[RTCM_Firmware_upgrading | firmware upgrade]] page for information on upgrading the firmware. |
| | | | |
| − | All new boards will need to have the bootloader installed first, followed by a firmware file. You '''can''' load a firmware file directly (.hex) in to the dsPIC, but then you will not have any of the bootloader remote loading features.
| |
| | | | |
| − | The current bootloader (.cof file) is available here: https://github.com/AllStarLink/voter/tree/master/voter-bootloader (the -smt file is for the RTCM). It needs to be loaded with a PICKit programmer.
| + | = Board Layout = |
| | | | |
| − | Current firmware (.cry file) is available here: https://github.com/AllStarLink/voter/tree/master/board-firmware . They are loaded with the EBLEX C30 Programmer.
| + | == Connectors and Switches == |
| | | | |
| − | There are multiple "flavors" of firmware available. See below for further explanation of what all the options mean.
| + | <pre> |
| | + | J1 - ICSP Programming Header |
| | + | P1 - Radio |
| | + | P2 - Console/GPS |
| | + | SW1 - Reset (Momentary) |
| | + | SW2-1 - Init EEPROM |
| | + | SW2-2 - Calibrate Squelch |
| | + | SW2-3 - Calibrate Diode |
| | + | SW2-4 - RX Level LEDs |
| | + | </pre> |
| | | | |
| − | The DSPBEW versions have Jim's DSP/BEW feature enabled. Note that due to the size of this feature, the diagnostics menu is NOT available in this version.
| |
| | | | |
| − | The CHUCK versions have Chuck Henderson's RSSI and Squelch modifications enabled. This is probably the version that most user's will want to use in production.
| + | === J1 - ICSP Programming Header (6 pin MTA-100) === |
| | | | |
| | + | <pre> |
| | + | 1 - MCLR |
| | + | 2 - +3.3Vdc |
| | + | 3 - GND |
| | + | 4 - PGD (Program Data) |
| | + | 5 - PGC (Program Clock) |
| | + | 6 – NU |
| | + | </pre> |
| | | | |
| − | ==Compiling Environment==
| |
| − | If you look in the [https://github.com/AllStarLink/voter/blob/master/votersystem.pdf votersystem.pdf], you will find a procedure to modify and load the bootloader in to the dsPIC of a VOTER board.
| |
| | | | |
| − | Unfortunately, there is an important step '''missing''' in that procedure, which is covered below.
| + | === P1 - Radio Connector Pinout (DB9 Male) === |
| | | | |
| − | In addition, the old links for the MPLAB software are dead, so let's update this info and get you going.
| + | <pre> |
| − | | + | 1 - + VIn (7-24 Volts DC). |
| − | Currently (Feb 2017), you can get the required software from:
| + | 2 - Transmit Audio Out |
| − | :http://www.microchip.com/development-tools/downloads-archive
| + | 3 - Receive (discriminator) Audio In |
| − | | + | 4 - External CTCSS Input (optional) |
| − | Download MPLAB IDE 32-bit Windows v8.66:
| + | 5 - Gnd |
| − | :http://ww1.microchip.com/downloads/en/DeviceDoc/MPLAB_IDE_v8_66.zip
| + | 6 - Gnd |
| − | :http://dvswitch.org/files/AllStarLink/Voter/MPLAB_IDE_v8_66.zip
| + | 7 - /PTT Out (open-collector, active-low) |
| | + | 8 - Gnd |
| | + | 9 – Gnd |
| | + | </pre> |
| | | | |
| − | Download MPLAB C Compiler for PIC24 and dsPIC DSCs v3.31 '''NOT v.3.25''':
| |
| − | :http://ww1.microchip.com/downloads/en/DeviceDoc/mplabc30-v3_31-windows-installer.exe
| |
| − | :http://dvswitch.org/files/AllStarLink/Voter/mplabc30-v3_31-windows-installer.exe
| |
| | | | |
| − | Optionally, install Windows Virtual PC and XP Mode. This is getting to be pretty old software, so running it under XP Mode may be a good idea, so we can keep it isolated (install it in a virtual machine). It does run fine in Windows 7.
| + | === P2 - Console/GPS Connector Pinout (DB15 Female) === |
| | | | |
| − | To setup the compile/build environment, follow these steps:
| |
| − | *Run the MPLAB IDE installer. You don't need to install the HI-TECH C Compiler at the end (click no)
| |
| − | *Run the MPLAB C Compiler installer
| |
| − | *Select Legacy Directory Name
| |
| − | *'''Select Lite Compiler'''
| |
| − | *Go to: https://github.com/AllStarLink
| |
| − | *Follow the links to: voter --> Clone or Download --> Download Zip. That will get you voter-master.zip which is a download of the whole VOTER tree from GitHub.
| |
| − | *Extract it somewhere (ie. in the XP Mode Virtual PC)
| |
| − | *Launch the MPLAB IDE
| |
| − | *Go to Configure --> Settings --> Projects and de-select one-to-one project mode.
| |
| − |
| |
| − |
| |
| − | ==Bootloader==
| |
| − | If you need to load the bootloader in to a fresh board, you will need to follow these steps:
| |
| − | *Go to Project --> Open --> voter-bootloader.mcp --> Open (it is in the voter-bootloader folder of the GitHub source)
| |
| − | *Go to File --> Import --> voter-bootloader --> ENC_C30.cof --> Open '''This step is missing from the original procedure.'''
| |
| − | *Remove JP7 on the VOTER Board. This is necessary to allow programming by the PICKit2/PICKit3 device.
| |
| − | *Attach the PICKIT2/PICKit3 device to J1 on the VOTER board. Note that Pin 1 is closest to the power supply modules (as indicated on the board).
| |
| − | *If you have not already selected a programming device, go to Programmer --> Select Device and choose PICKit3 (or PICKit2, depending on what you are using).
| |
| − | *Go to Programmer --> Program. This will program the bootloader firmware into the PIC device on the board.
| |
| − |
| |
| − | If you want to change the default IP address from 192.168.1.11 in the bootloader:
| |
| − | *Select View --> Program Memory (from the top menu bar)
| |
| − | *Hit Control-F (to "find") and search for the digits "00A8C0".
| |
| − | *These should be found at memory address "03018".
| |
| − |
| |
| − | The "A8C0" at 03018 represents the hex digits C0 (192) and A8 (168) which are the first two octets of the IP address. The six digits to enter are 00 then the SECOND octet of the IP address in hex then the FIRST octet of the IP address in hex.
| |
| − |
| |
| − | The "0B01" at 0301A represents the hex digits 0B (11) and 01 (1) which are the second two octets of the IP address. The six digits to enter are 00 then the FOURTH octet of the IP address in hex then the THIRD octet of the IP address in hex.
| |
| − |
| |
| − | Once you have modified the address to your desired IP, follow the programming procedure (above).
| |
| − |
| |
| − |
| |
| − | ==Firmware==
| |
| − | To compile the firmware (if you want to make custom changes):
| |
| − | *Go to Project --> Open --> navigate to board-firmware and open the .mcp file for the flavor of firmware you want to compile. They are in the board-firmware folder of the GitHub source.
| |
| − | *'''NOTE''': the .mcp files with the "smt" suffix are for the RTCM (built with SMT parts). The non-smt files are for the ORIGINAL through-hole VOTER boards. The difference is that the VOTER uses a dsPIC33FJ128GP802 and the RTCM uses a dsPIC33FJ128GP804.
| |
| − | *Go to Project --> Build Configuration and select "Release". This may not be necessary (I don't believe that option is used in the firmware), but it removes the compiler option of __DEBUG being passed, so theoretically it would build "normal" firmware.
| |
| − | *Go to Configure --> Select Device and choose the appropriate device for your board from the Device list. If you don't select the right one, the board will not boot. Select dsPIC33FJ128GP802 for the VOTER, and dsPIC33FJ128GP804 for the RTCM.
| |
| − | *Now, if you go to Project --> Build All it should compile everything and show you "Build Succeeded".
| |
| − |
| |
| − | A .cry file should be in the board-firmware folder. You can load this with the ENC Loader.
| |
| − |
| |
| − | There is also a .hex file in there that you could load with a programmer... but that would wipe the bootloader... so don't do that.
| |
| − |
| |
| − |
| |
| − | ==Chuck Squelch==
| |
| − | If you want to enable "Chuck Squelch", open the HardwareProfile.h and un-comment #define CHUCK.
| |
| − |
| |
| − | You may also want to go down to Line 291 in Voter.c (right click on the window, go to Properties --> "C" File Types --> Line Numbers) and tack on CHUCK after 1.60 (the current version number) so that when you load this firmware, the version will be shown as 1.51CHUCK, and you'll know that Chuck Squelch is compiled in. We should probably make that more automagic in the future...
| |
| − |
| |
| − |
| |
| − | ==DSP/BEW==
| |
| − | If you want to compile the DSPBEW version, open the DSPBEW project file instead.
| |
| − |
| |
| − |
| |
| − | =DSP/BEW Firmware Version=
| |
| − | DSP BEW Firmware is mutually exclusive with the diagnostic menu. There is not enough space for both, if you load the DSP/BEW firmware, you will '''NOT''' have a diag menu.
| |
| − |
| |
| − | BEW stands for Baseband Examination Window.
| |
| − |
| |
| − | Typically, the discriminator of an FM communications receiver produces results containing audio spectrum from the "sub-audible" range (typically < 100 Hz) to well above frequencies able to be produced by modulating audio. These higher frequencies can be utilized to determine signal quality, since they can only contain noise (or no noise, if a sufficiently strong signal is present).
| |
| − |
| |
| − | For receivers (such as the Motorola Quantar, etc) that do not provide sufficient spectral content at these "noise" frequencies (for various reasons), The "DSP/BEW (Digital Signal Processor / Baseband Examination Window)" feature of the RTCM firmware may be utilized.
| |
| − |
| |
| − | These receivers are perfectly capable of providing valid "noise" signal with no modulation on the input of the receiver, but with strong modulation (high frequency audio and high deviation), it severely interferes with proper analysis of signal strength.
| |
| − |
| |
| − | This feature provides a means by which a "Window" of baseband (normal audio range) signal is examined by a DSP and a determination of whether or not sufficient audio is present to cause interference of proper signal strength is made. During the VERY brief periods of time when it is determined that sufficient audio is present to cause interference, the signal strength value is "held" (the last valid value previous to the time of interference) until such time that the interfering audio is no longer present.
| |
| − |
| |
| − | The DSP/BEW feature is selectable, and '''should not''' be used for a receiver that does not need it.
| |
| − |
| |
| − | A note on the Motorola SLR5700 per VE7FET. DSP/BEW definitely makes a difference on what AllMon reports for the signal strength of received signals. It is less reactive when DSP/BEW = 1 than with it set to 0. We'll have to see what the real world trials show. It might be better to leave it off.
| |
| − |
| |
| − |
| |
| − | =Chuck Squelch=
| |
| − | "Chuck Squelch" are a couple firmware changes made by Chuck Henderson, WB9UUS.
| |
| − |
| |
| − | Pre-compiled firmware versions including this option are available on [https://github.com/AllStarLink/voter/tree/master/board-firmware GitHub]. See above on how it is enabled/compiled, if you are rolling your own firmware modifications.
| |
| − |
| |
| − | One of the changes fixes an issue with weak signals producing RSSI readings all over the place. It is caused by a 16 bit value that was overflowing (it is the RSSI change in the firmware). It results in rock-solid RSSI values being reported, even on barely or non-readable signals. '''This change will likely be rolled in to a permanent fix in a future firmware release.'''
| |
| − |
| |
| − | The other firmware change changes how the squelch responds (looks at the noise in the last two audio samples) and makes the "Micor squelch" action work better.
| |
| − |
| |
| − | You may also want to consider the following changes in /etc/asterisk/voter.conf:
| |
| | <pre> | | <pre> |
| − | ;Comment out:
| + | 1 - NC |
| − | ;thresholds =
| + | 2 - Console Transmit Data |
| − | | + | 3 - Console Receive Data |
| − | ;and set:
| + | 4 - NC |
| − | linger = 0
| + | 5 - Gnd |
| | + | 6 - GPS Receive Data |
| | + | 7 - PTT Out |
| | + | 8 - Gnd |
| | + | 9 - NC |
| | + | 10 - Console Request To Send (RTS) |
| | + | 11 - Console Clear To Send (CTS) |
| | + | 12 - NC |
| | + | 13 - GPS Power Output (5Vdc @ 800ma MAX) |
| | + | 14 - GPS Transmit Data |
| | + | 15 – External Reset |
| | </pre> | | </pre> |
| | | | |
| − | ==Squelch Issues==
| |
| − | *If anyone is off frequency a little bit, that will make the voice talk off worse. Double check that the repeater and the users are all on frequency.
| |
| − | *Don't use narrow bandwidth on the repeater receiver.
| |
| − | *Make sure that the discriminator audio is not rolled off even a little bit at the high end. There should not be resistors in series or capacitors to ground between the discriminator chip output pin and the voter board input, for best results.
| |
| | | | |
| | + | === SW1 - Reset === |
| | | | |
| − | =RTCM/VOTER LED's=
| + | Depress SW1 momentarily to reset the RTCM. |
| − | RX LED on the RTCM/VOTER will flash (same rate as ACT LED) if you have External CTCSS enabled, and the received signal has the wrong (or no) valid PL.
| |
| | | | |
| | | | |
| − | =Debug Options= | + | === SW2 - DIP Switch === |
| − | The VOTER/RTCM firmware supports some additional debugging information that can be turned on.
| |
| | | | |
| − | From the source code, the different Debug Options are listed as:
| |
| | <pre> | | <pre> |
| − | 1 - Alt/Main Host change notifications | + | SW2-1 - Init EEPROM |
| − | 2 - Ignore HWlock (GGPS only) | + | SW2-2 - Calibrate Squelch |
| − | 4 - GPS/PPS Failure simulation (GGPS only)
| + | SW2-3 - Calibrate Diode |
| − | 8 - POCSAG H/W output disable (GGPS only)
| + | SW2-4 - RX Level LEDs |
| − | 16 - IP TOS Class for Ubiquiti
| |
| − | 32 - GPS Debug
| |
| − | 64 - Fix GPS 1 second off
| |
| − | 128 - Fix GPS 1 month off (WTF,O??)
| |
| | </pre> | | </pre> |
| | | | |
| − | Not sure what they all do, but that is what they are. Here are the most common ones used:
| |
| − | *"Alt/Main Host change notifications" shows when the connection to the Asterisk server changes state.
| |
| − | *"IP TOS Class for Ubiquity" marks the IP headers from the RTCM/VOTER '''TO''' the network with ToS C0/DSCP 48 (UBNT shows this as 802.1p Class 6 (Voice <10mS
| |
| − | latency). Other sources show this as a Network Control TOS.) If you enable this, you also will want to have "utos=y" in your voter.conf to mark the packets from the network '''TO''' the RTCM/VOTER. We will probably change this option to mark the packets by default in a future version.
| |
| − | *"GPS Debug" will print NMEA or TSIP debug strings from the connected GPS.
| |
| − |
| |
| − | The way this works is you add together the options you want to enable.
| |
| − |
| |
| − | Want to enable GPS Debug and IP ToS, set debug to 48.
| |
| − |
| |
| − | Just want to turn on GPS Debug, set debug to 32.
| |
| − |
| |
| − | Just want ToS turned on, set debug to 16.
| |
| | | | |
| | + | SW2-1 "Initialize configuration parameters in EEPROM" (factory reset). If ON when firmware starts, the operating parameters in the EEPROM will be set to default values. The system activity LED (LD1, green) will stay off for aproximately 4 seconds, then stay on steady to indicate that the initialization process is complete. Afterwards, the switch may be TURNED OFF and the system will continue running normally. Note, if SW2-3 is ON during this procedure, the “Diode Calibration” process will also occur. |
| | | | |
| − | =TX Level Setting=
| |
| − | *Send 1kHz@3kHz on-channel in to the RX
| |
| − | *Set the RX up so it reads 3kHz deviation on the RTCM's built in console meter
| |
| − | *Now set the TX level '''pot''' to get 3kHz out of the transmitter (No PL)
| |
| | | | |
| − | Now change the modulation from 1kHz tone to 800Hz followed by 1.8kHz and verify that the deviation level doesn't change as the tone frequency changes. '''Changing levels indicates a pre/de-emphasis issue.'''
| + | SW2-2 On to calibrate squelch. With the receiver connected and its antenna removed, switch on SW2-2. In the next few seconds the "Receive Signal Indicator" (LD3, Green) will flash on and off, then (hopefully) on steady. This indicates that the squelch calibration has occurred successfully. If unsuccessful, the LED will flash either fast to indicate that the discriminator noise level is too high, or slowly to indicate that the discriminator noise level is too low. Note, if SW2-3 is ON during this procedure, the "Diode Calibration" process will also occur. |
| | | | |
| − | If using PL you have to account for that deviation, unless you filter it out with your IFR (test set).
| |
| | | | |
| | + | SW2-3 On to perform "Diode Calibration". This may only be done in conjunction with a configuration parameter initialization (see SW2-1, above), or a "Squelch Calibration" (see SW2-2, above). |
| | | | |
| − | =GPS=
| |
| − | The RTCM/VOTER will work with most GPS available. It requires either NMEA or Trimble TSIP binary data. It only receives data '''from''' the GPS (GPS TX), it does not send anything '''to''' the GPS.
| |
| | | | |
| − | The firmware is specifically written to talk to Trimble Thunderbolt receivers using Trimble's TSIP binary data interface, however, other Trimbles GPS receivers that talk TSIP are generally compatible.
| + | SW2-4 On to temporarily re-purpose LD4 and LD5 to allow for visual indication of RX input level. With SW2-4 on, LD5 will indicate (by brightness) if the RX level is too low, and LD4 will indicate (by brightness) if the RX level is too high. So the idea is to tune R36 so that there is minimal brightness on both LD4 and LD5 (like a null, more or less). Alternatively, [[VOTER-Menus#97_RX_Level_Display | Menu 97]] on the console gives a more graphical method of setting the Rx input level. |
| | | | |
| | | | |
| − | ==NMEA Sentences== | + | == LED Designations == |
| − | If you are using an NMEA GPS (as opposed to a Trimble using the TSIP binary interface), the RTCM/VOTER is looking for the following NMEA sentences:
| |
| | | | |
| | <pre> | | <pre> |
| − | $GPGGA
| + | LD1 - Heartbeat |
| − | $GPGSV
| + | LD2 - PTT |
| − | $GPRMC
| + | LD3 - COS On solid is valid Rx signal, flashing is without CTCSS |
| | + | LD4 - GPS On solid is GPS received and locked, flashing is GPS received, lock in progress |
| | + | LD5 - HOST |
| | </pre> | | </pre> |
| | | | |
| | | | |
| − | ==GPS Lock==
| + | The COS (RX) LED on the RTCM will flash (same rate as Heartbeat LED) if you have External CTCSS enabled, and the received signal has the wrong (or no) valid PL. |
| − | The GPS led will go solid regardless of the connection LED. That '''has''' to happen or it won't connect to the Asterisk server. | |
| − | | |
| − | It is not unusual for it to take up to 20 mins to get a GPS lock LED (ie. using a Trimble Thunderbolt) after any reboot.
| |
| | | | |
| | | | |
| − | ==GPS De-sense== | + | == Jumpers == |
| − | If you are having odd loss of lock issues, consider you may have interference to your GPS antenna from strong RF nearby. A note from Jesse Lloyd:
| |
| | | | |
| | <pre> | | <pre> |
| − | I also had crazy problems with poor signal on my GPS when I set it up sitting in a window, and once installed at site I had the GPS antenna maybe 6 ft from the VHF antenna, and after some troubleshooting found it was getting swamped with RF and loosing lock.
| + | JP1 - Discriminator Level Boost |
| − | | + | JP2 - 20dB Pad |
| − | I found the debug setting of 32 useful in the RTCM, you can see a hex output of the GPS status.
| + | JP3 - Output Amp Power Source |
| | + | JP4 - GPS TX RS-232/TTL Select |
| | + | JP5 - GPS RX RS-232/TTL Select |
| | + | JP6 - Not Used |
| | + | JP7 - Bootloader Programming |
| | </pre> | | </pre> |
| | | | |
| | | | |
| − | ==GPS Issues== | + | === JP1 - Discriminator Level Boost === |
| − | ===Trimble Thunderbolt=== | |
| − | You may find your Trimble Thunderbolt is showing the incorrect date at the moment. It could be showing the year as 1997. This is due to the date in the Thunderbolt being reported incorrectly.
| |
| | | | |
| − | '''This can cause some of your voting receivers to not connect, if they are used with other GPS in your system.''' If you have '''ALL''' Thunderbolts, or '''NO''' Thunderbolts, you are probably fine. If you have '''ALL''' Thunderbolts, the date/time is probably wrong, but they will ALL be wrong, so they will connect.
| + | Insert if low discriminator level. If squelch cannot self-calibrate with JP1 removed (too low), try with JP1 inserted. |
| | | | |
| − | GPS Time is a continuous counting time scale beginning at the January 5, 1980 to January 6, 1980 midnight. It is split into two parts: a time of week measured in seconds from midnight Sat/Sun and a week number. The time of week is transmitted in an unambiguous manner by the satellites, but only the bottom 10 bits of the week number are transmitted. This means that a receiver will see a week number count that goes up steadily until it reaches 1023 after which it will “roll over” back to zero, before steadily going up again. Such a week rollover will occur approx. every 20 years. The last week rollover occurred in 1999 and the next one will be in 2019.
| |
| | | | |
| − | The Thunderbolt manual states:
| + | '''Note:''' this jumper affects the squelch calibration circuit only. Not to be confused with JP2, which is the pad for the receive audio. |
| − | <pre>
| |
| − | The ThunderBolt adjusts for this week rollover by adding 1024 to any week number reported by GPS which is less than week number 936 which began on December 14, 1997. With this technique, the ThunderBolt will provide an accurate translation of GPS week number and TOW to time and date until July 30, 2017.
| |
| − | </pre>
| |
| | | | |
| − | As such, the Trimble Thunderbolt has a firmware issue with the GPS Week rollover that manifested itself on July 30, 2017, causing the date to become incorrect.
| |
| | | | |
| − | We have added a brute-force fix starting in RTCM/VOTER firmware >=1.51. It fixes the Thunderbolts, we have not done extensive testing to see how it affects other TSIP receivers.
| + | === JP2 - 20dB Pad === |
| | | | |
| | + | Insert to attenuate discriminator input level by 20db. This pad affects the '''receive audio level'''. See the [[#Receive Level Input Calibration | Receive Level Input Calibration]] section. |
| | | | |
| − | ===Garmin===
| |
| − | ====Garmin 18x LVC Wiring Issues====
| |
| − | If you have issues with your GPS 18x LVC not talking to the RTCM/VOTER, it may not be hooked up to the RTCM correctly.
| |
| | | | |
| − | The Garmin pin labeling is backwards to what you may think. See below. You probably need to swap pins 6 and 14.
| + | === JP3 - Output Amp Power Source === |
| | | | |
| − | <pre>
| + | Selects power source for output audio amplifier. 1-2 is to power it from the 5VDC power supply. 2-3 is to power it directly from Vin. |
| − | RTCM GPS 18x LVC
| |
| − | 6 GRX <-- Rx Data 6 Green
| |
| − | 7 GPPS <-- Pulse Output 1 Yellow
| |
| − | 8 GND Ground 3 Black
| |
| − | 8 GND Ground 5 Black
| |
| − | 13 +5V -->Vin 2 Red
| |
| − | 14 GTX --> TX Data 4 White
| |
| − | </pre>
| |
| | | | |
| − | Log into the RTCM and do 98 and you should see something like this:
| |
| | | | |
| − | <pre>
| + | === JP4 - GPS TX RS-232/TTL Select === |
| − | Current Time: Sun Apr 20, 2014 04:37:02.820
| |
| − | Last Rx Pkt System time: 04/20/2014 03:55:35.580, diff: 2487260 msec
| |
| − | Last Rx Pkt Timestamp time: 04/20/2014 03:55:32.064, diff: 3515 msec
| |
| − | Last Rx Pkt index: 160, inbounds: 1
| |
| − | </pre>
| |
| | | | |
| | + | Selects GPS Serial transmit level. 1-2 RS232 Level, 2-3 TTL (5V) Level. |
| | | | |
| − | ====Garmin and the RTCM====
| |
| − | Beware when buying newer Garmin GPS's to use with the Micro-Node RTCM.
| |
| | | | |
| − | The RTCM expects a 5V PPS signal.
| + | === JP5 - GPS RX RS-232/TTL Select === |
| | | | |
| − | Newer Garmin's (GPS 18X, 18X LVC, etc.) MAY NOT output 5V, and can cause issues. '''Check the Garmin datasheet'''.
| + | Selects GPS Serial receive level. 1-2 RS232 Level, 2-3 TTL (5V) Level. |
| | | | |
| − | The VOTER is designed to accept both 3.3V or 5V signals, and ''should'' work fine.
| |
| | | | |
| | + | === JP6 – Not used === |
| | | | |
| − | ==No GPS/Mixed Mode==
| |
| − | You do not need a timing source to use an RTCM if you don’t want to vote. That’s called Mix Mode.
| |
| | | | |
| − | Having the PPS Polarity set to 2 tells the RTCM you do not have a GPS. That forces the RTCM to become a mix (non-voting) client. Turn it on, save it, and restart. A simple voter.conf would look like this:
| + | === JP7 - Bootloader Programming === |
| | | | |
| − | <pre>
| + | This jumper only needs to be removed when programming the bootloader in the dsPIC using the ICSP header. |
| − | [general]
| |
| − | port = 667
| |
| − | password = BLAH
| |
| | | | |
| − | [1000]
| |
| − | Site1 = pswrd1,master,transmit
| |
| − | Site2 = pswrd2,transmit
| |
| − | </pre>
| |
| | | | |
| | + | == Potentiometers == |
| | | | |
| − | ==Mixed Client Error==
| |
| − | "I am getting this error in Asterisk":
| |
| | <pre> | | <pre> |
| − | WARNING[2368]: chan_voter.c:4511 voter_reader: Voter client master timing source mobile1 attempting to authenticate as mix client!!
| + | R22 - Squelch adjustment |
| | + | R36 - Rx Input Level |
| | + | R10 - Tx Output Level |
| | </pre> | | </pre> |
| | | | |
| − | A mixed client error means the voter.conf file is expecting an RTCM to try and connect with a GPS IP packet (ie. has '''master''' in it in voter.conf), but the RTCM isn't
| |
| − | sending a GPS IP packet. So its a mismatch between voter.conf and Option 10 in the RTCM.
| |
| − |
| |
| − | If you want to use a mix client (non-voted), make sure that receiver's configuration line in voter.conf '''does not''' have the '''master''' option set.
| |
| − |
| |
| − |
| |
| − | ==GPS Debug==
| |
| − | To turn on GPS Debugging, set the Debug Option Level in the RTCM/VOTER to 32.
| |
| − |
| |
| − | See [[#Debug Options]] levels for more information on how this works.
| |
| − |
| |
| − |
| |
| − | =Ubiquity ToS=
| |
| − | See https://help.ubnt.com/hc/en-us/articles/205231750-airMAX-How-is-QoS-and-prioritization-handled-by-airMAX-
| |
| − |
| |
| − | So, if we set ToS/DSCP in the header to C0, then Ubiquity (and other gear watching ToS) ''should'' prioritize the packets. This sets the DSCP to 110 000 aka 48. UBNT shows this as 802.1p Class 6 (Voice <10mS latency). Other sources show this as a Network Control TOS.
| |
| − |
| |
| − | There is an option in voter.conf to turn this on (utos=y). However, this only controls packets being sent from Asterisk '''TO''' the RTCM.
| |
| − |
| |
| − | If you want to tag packets from the RTCM '''TO''' Asterisk, you need to set the RTCM debug option level to 16 (see [[#Debug Options]] for how this works).
| |
| − |
| |
| − | At some point we should probably change the default behaviour of the RTCM firmware to mark the packets and use the debug setting to '''disable''' ToS. That change (if you wanted to compile your own firmware) would be:
| |
| − |
| |
| − | <pre>
| |
| − | Change line 90 in IP.c
| |
| | | | |
| − | From:
| + | = Related Pages = |
| − | #define IP_SERVICE ((AppConfig.DebugLevel & 16) ? 0xc0 : (IP_SERVICE_ROUTINE | IP_SERVICE_N_DELAY))
| |
| | | | |
| − | To:
| + | Documentation on the VOTER/RTCM is extensive, and as such, has been split across multiple pages. They are usually linked, where appropriate, throughout the content. However, here are all the related pages that are available: |
| − | #define IP_SERVICE ((AppConfig.DebugLevel & 16) ? (IP_SERVICE_ROUTINE | IP_SERVICE_N_DELAY) : 0xc0)
| |
| − | </pre>
| |
| | | | |
| − | This changes the conditional expression from if the debug level is 16 to mark the packets with DSCP 48 to if the debug level is 16, mark the packets routine (DSCP 0).
| + | *[[VOTER | Main VOTER Page]] |
| | + | *[[VOTER-Hardware | Original VOTER Hardware Documentation]] |
| | + | *[[VOTER-Menus | Menu Structure and Definitions]] |
| | + | *[[RTCM_Firmware_upgrading | Firmware Upgrading]] |
| | + | *[[VOTER-Audio | Audio Interfacing and Configuration]] |
| | + | *[[VOTER-GPS | GPS Interfacing and Configuration]] |
| | + | *[[Voter.conf | <code>voter.conf</code> Documentation]] |
| | + | *[[RTCM_Channel_Driver | <code>chan/voter</code> and Asterisk Console Documentation]] |
| | + | *[[VOTER-Simulcasting | Simulcasting Configuration]] |
| | + | *[[VOTER-Buffers | Buffer Tuning]] |
| | + | *[[Quantar_RTCM | Interfacing to the Motorola Quantar]] |
Introduction
The Radio Thin Client Module (RTCM) is commercially available hardware for interfacing radios to an AllStarLink computer.
The Micro-Node RTCM (and VOTER) interfaces are typically used with AllStar in voting/simulcast applications. They MAY be used for ANY repeater interface application, through the chan_voter channel driver, as they are primarily a Radio over IP (ROIP) adapter.
The VOTER is the original through-hole board designed by Jim Dixon (SK) for this application. It is open-source, and the relevant Gerber files and BoM to build it are available.
The Micro-Node Radio Thin Client Module (RTCM) is the commercial version of the VOTER. It uses surface mount parts (SMT), but is functionally equivalent to the original VOTER. In general, the two terms (RTCM/VOTER) are used interchangeably, as they operate the same, and use the same firmware (mostly, see below).
Firmware
See the firmware upgrade page for information on upgrading the firmware.
Board Layout
Connectors and Switches
J1 - ICSP Programming Header
P1 - Radio
P2 - Console/GPS
SW1 - Reset (Momentary)
SW2-1 - Init EEPROM
SW2-2 - Calibrate Squelch
SW2-3 - Calibrate Diode
SW2-4 - RX Level LEDs
1 - MCLR
2 - +3.3Vdc
3 - GND
4 - PGD (Program Data)
5 - PGC (Program Clock)
6 – NU
P1 - Radio Connector Pinout (DB9 Male)
1 - + VIn (7-24 Volts DC).
2 - Transmit Audio Out
3 - Receive (discriminator) Audio In
4 - External CTCSS Input (optional)
5 - Gnd
6 - Gnd
7 - /PTT Out (open-collector, active-low)
8 - Gnd
9 – Gnd
P2 - Console/GPS Connector Pinout (DB15 Female)
1 - NC
2 - Console Transmit Data
3 - Console Receive Data
4 - NC
5 - Gnd
6 - GPS Receive Data
7 - PTT Out
8 - Gnd
9 - NC
10 - Console Request To Send (RTS)
11 - Console Clear To Send (CTS)
12 - NC
13 - GPS Power Output (5Vdc @ 800ma MAX)
14 - GPS Transmit Data
15 – External Reset
SW1 - Reset
Depress SW1 momentarily to reset the RTCM.
SW2 - DIP Switch
SW2-1 - Init EEPROM
SW2-2 - Calibrate Squelch
SW2-3 - Calibrate Diode
SW2-4 - RX Level LEDs
SW2-1 "Initialize configuration parameters in EEPROM" (factory reset). If ON when firmware starts, the operating parameters in the EEPROM will be set to default values. The system activity LED (LD1, green) will stay off for aproximately 4 seconds, then stay on steady to indicate that the initialization process is complete. Afterwards, the switch may be TURNED OFF and the system will continue running normally. Note, if SW2-3 is ON during this procedure, the “Diode Calibration” process will also occur.
SW2-2 On to calibrate squelch. With the receiver connected and its antenna removed, switch on SW2-2. In the next few seconds the "Receive Signal Indicator" (LD3, Green) will flash on and off, then (hopefully) on steady. This indicates that the squelch calibration has occurred successfully. If unsuccessful, the LED will flash either fast to indicate that the discriminator noise level is too high, or slowly to indicate that the discriminator noise level is too low. Note, if SW2-3 is ON during this procedure, the "Diode Calibration" process will also occur.
SW2-3 On to perform "Diode Calibration". This may only be done in conjunction with a configuration parameter initialization (see SW2-1, above), or a "Squelch Calibration" (see SW2-2, above).
SW2-4 On to temporarily re-purpose LD4 and LD5 to allow for visual indication of RX input level. With SW2-4 on, LD5 will indicate (by brightness) if the RX level is too low, and LD4 will indicate (by brightness) if the RX level is too high. So the idea is to tune R36 so that there is minimal brightness on both LD4 and LD5 (like a null, more or less). Alternatively, Menu 97 on the console gives a more graphical method of setting the Rx input level.
LED Designations
LD1 - Heartbeat
LD2 - PTT
LD3 - COS On solid is valid Rx signal, flashing is without CTCSS
LD4 - GPS On solid is GPS received and locked, flashing is GPS received, lock in progress
LD5 - HOST
The COS (RX) LED on the RTCM will flash (same rate as Heartbeat LED) if you have External CTCSS enabled, and the received signal has the wrong (or no) valid PL.
Jumpers
JP1 - Discriminator Level Boost
JP2 - 20dB Pad
JP3 - Output Amp Power Source
JP4 - GPS TX RS-232/TTL Select
JP5 - GPS RX RS-232/TTL Select
JP6 - Not Used
JP7 - Bootloader Programming
JP1 - Discriminator Level Boost
Insert if low discriminator level. If squelch cannot self-calibrate with JP1 removed (too low), try with JP1 inserted.
Note: this jumper affects the squelch calibration circuit only. Not to be confused with JP2, which is the pad for the receive audio.
JP2 - 20dB Pad
Insert to attenuate discriminator input level by 20db. This pad affects the receive audio level. See the Receive Level Input Calibration section.
JP3 - Output Amp Power Source
Selects power source for output audio amplifier. 1-2 is to power it from the 5VDC power supply. 2-3 is to power it directly from Vin.
JP4 - GPS TX RS-232/TTL Select
Selects GPS Serial transmit level. 1-2 RS232 Level, 2-3 TTL (5V) Level.
JP5 - GPS RX RS-232/TTL Select
Selects GPS Serial receive level. 1-2 RS232 Level, 2-3 TTL (5V) Level.
JP6 – Not used
JP7 - Bootloader Programming
This jumper only needs to be removed when programming the bootloader in the dsPIC using the ICSP header.
Potentiometers
R22 - Squelch adjustment
R36 - Rx Input Level
R10 - Tx Output Level
Related Pages
Documentation on the VOTER/RTCM is extensive, and as such, has been split across multiple pages. They are usually linked, where appropriate, throughout the content. However, here are all the related pages that are available:
