VOTER-Menus

From AllStarLink Wiki
Revision as of 02:34, 30 January 2022 by VE7FET (talk | contribs) (Created page with "= Introduction = Both the VOTER and the RTCM run the same (similar) firmware. The menus are consistent between them both. This page ''should'' be consistent with the curren...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Introduction

Both the VOTER and the RTCM run the same (similar) firmware. The menus are consistent between them both.


This page should be consistent with the current options available in the current firmware.


Console Access

Serial Console access is provided by an RS-232 serial port at 57600 baud, 8 bits, No parity, 1 Stop Bit. It is also made available remotely (off-board) via TELNET. When TELNET-ing the default user is "admin" and the password is "radios".

VOTER System Serial # 1234 Remote Console Access

Login: admin
Password: radios

Logged in successfully, now joining console session...


When done with the console session, please use the 'q' command to disconnect. The local serial port and the TELNET (remote) user share the same (and only) console session.


Main Menu

Select the following values to View/Modify:

1  - Serial # (1694) (which is MAC ADDR 00:04:A3:00:04:D2)
2  - VOTER Server Address (FQDN) (n0call.dyndns.net)
3  - VOTER Server Port (667),  4  - Local Port (Override) (0)
5  - Client Password (madcow1),  6  - Host Password (BLAH)
7  - Tx Buffer Length (640)
8  - GPS Data Protocol (0=NMEA, 1=TSIP) (1)
81 - GPS Type (0=Normal TSIP, 1=Trimble Thunderbolt) (0)
82 - GPS Time Offset (seconds to add for correction) (0)
9  - GPS Serial Polarity (0=Non-Inverted, 1=Inverted) (0)
10 - GPS PPS Polarity (0=Non-Inverted, 1=Inverted, 2=NONE) (1)
11 - GPS Baud Rate (9600)
12 - External CTCSS (0=Ignore, 1=Non-Inverted, 2=Inverted) (0)
13 - COR Type (0=Normal, 1=IGNORE COR, 2=No Receiver) (0)
14 - Debug Level (16)
15  - Alt. VOTER Server Address (FQDN) ()
16  - Alt. VOTER Server Port (Override) (0)
17  - DSP/BEW Mode NOT SUPPORTED
18 - "Duplex Mode 3" (0=DISABLED, 1-255 Hang Time) (1/10 secs) (0)
19 - Simulcast Launch Delay (0) (approx 200 ns, 5 = 1us, > 0 to ENA SC)
97 - RX Level,  98 - Status,  99 - Save Values to EEPROM
i - IP Parameters menu, o - Offline Mode Parameters menu, s - Squelch menu
q - Disconnect Remote Console Session, r - reboot system, d - diagnostics

Enter Selection (1-19,81-82,97-99,i,o,s,r,q,d) :


Options

  • 1 - Serial Number, is an unsigned 16 bit number (0-65535) which defines the last 2 bytes of the MAC address of the ethernet interface. Be sure that the MAC address of the device is unique on the LAN to which it is connected (if you have more than one VOTER on the LAN, they must each have a different serial number/MAC address).
  • 2 - VOTER Server Address is the fully-qualified domain name (FQDN) DNS address, or the IP, of the VOTER (AllStarLink) server you want to connect to. If you use the FQDN here, you must set at least one DNS server on the IP Parameters menu.
  • 3 - VOTER Server Port is the UDP port that the VOTER Server is listening on. Remember to add a forwarding rule in your firewall, if you are connecting from outside your LAN (ie. over the Internet).
  • 4 - Local Port (Override) normally should be 0. This allows the specification of a UDP port number for the device to use locally (incoming traffic). If specified as 0, it uses the same port as the "Voter Server Port". Not tested. Presumably, this should allow incoming traffic to the VOTER to be on a different port than the standard VOTER Server Port, but it is unclear how the server would be configured to do that.
  • 5 - Client Password is the password option in voter.conf that is associated with the DISPLAY_NAME for this VOTER. When this VOTER connects to the host, and the host matches the Client Password to a configured DISPLAY_NAME, that device will be connected to chan_voter.
  • 6 - Host Password is the password of the Asterisk host, and must match the password setting in the [General] context in voter.conf.
  • 7 - Tx Buffer Length sets the transmit buffer length in samples (8000 samples per second, so 8 samples = 1 millisecond), plus overhead, of the Transmit Delay buffer. This should be set to the maximum expected network latency plus a little padding (800 samples is a good amount of padding, so setting the parameter to 3000 is probably a good place to start until you do buffer tuning) between the host and all the clients on the transmit side. It must be set long enough to allow for worst-case delay and jitter in the Internet path between the client and the host. Minimum setting is 800, maximum setting is 6400.
  • 8 - GPS Data Protocol determines whether your GPS speaks NMEA, or Trimble TSIP. The VOTER is looking for NMEA $GPGGA, $GPGSV, and $GPRMC sentences.
  • 81 - GPS Type is normally set to 0, if you are using a Trimble GPS other than a Thunderbolt. Option 1 selects specific firmware hacks to accommodate Thunderbolt quirks.
  • 82 - GPS Time Offset (seconds to add for correction) if you have some oddball situation where you need to add a fixed number of seconds to GPS time, this is where you would specify that. You should not normally need this option.
  • 9 - GPS Serial Polarity depending on if your GPS is TTL or RS-232, you will need to adjust this setting accordingly to get lock. GPS Lock in the 98 - Status menu should be a 1 when this is correct and the GPS is locked.
  • 10 - GPS PPS Polarity depending on if your GPS PPS signal is TTL or RS-232, you will need to adjust this setting accordingly. Option 2 is used if you are using "General-purpose" mode, and not using a GPS. Check the PPS BAD or Wrong Polarity on the 98 - Status menu. If it is a 1, try toggling this setting, because the VOTER can't lock to PPS.
  • 11 - GPS Baud Rate is set according to your GPS. Typically this would be 4800 for most NMEA GPS, and 9600 for most TSIP applications.
  • 12 - External CTCSS is set depending on if you are feeding an external CTCSS signal from your repeater in to the VOTER. If you are using carrier squelch, leave this as 0. If your receiver is decoding CTCSS, and you are feeding a signal in to the radio connector, set the proper polarity for your application. The VOTER is normally expecting the External CTCSS to be pulled to ground.
  • 13 - COR Type is normally set to 0. COR is determined in software (Squelch Calibration procedure). If you have External CTCSS configured, this would be the equivalent of AND squelch when set to 0, needing CTCSS AND COR to qualify the receiver. If set to 1, then you must be feeding an External CTCSS signal in, and have that option correctly optioned, to qualify the receiver on reception of the correct CTCSS tone only (in most situations, you probably don't want to do that). Option 2 applications are un-tested/not known.
  • 14 - Debug Level sets various debug settings in the firmware.
  • 15 - Alt. VOTER Server Address is the alternate VOTER Server Address, when a redundant host system is configured. Not normally used.
  • 16 - Alt. VOTER Server Port (Override) is the UDP port of the redundant host, if it is different than the standard port configured in setting 3. Not normally used.
  • 17 - DSP/BEW Mode will show NOT SUPPORTED for firmware built without DSP/BEW mode. Will allow DSP/BEW to be optionally enabled in firmware built with this option (-BEW firmware files).
  • 18 - "Duplex Mode 3" setting to anything other than 0 enables this function. Provides "in-cabinet" repeat functionality. Repeat audio loops through the RTCM and has almost zero delay because it does not have to traverse the network.
  • 19 - Simulcast Launch Delay (0) (approx 200 ns, 5 = 1us, > 0 to ENA SC)
  • 97 - RX Level
  • 98 - Status
  • 99 - Save Values to EEPROM
  • i - IP Parameters menu
  • o - Offline Mode Parameters menu
  • s - Squelch menu
  • q - Disconnect Remote Console Session
  • r - reboot system
  • d - diagnostics