Sierra Radio Systems RadioRouter User Guide Version 1.1
Contents Overview Receiver board Rx hardware assembly instructions Transmitter board Junction box Tx hardware assembly instructions Control protocol and commands For more information, go to the Sierra Radio Systems web site at www.sierraradio.net or www.hamstack.com
RadioRouter Overview The RadioRouter is an active receive audio mixer and optional dry contact switching sub-system for transmitter interface switching. The RadioRouter comes in various configurations supporting from 4 to 8 receivers and optionally 2 or 4 transmitters. The Rx and Tx switching is controlled through the serial port. The master device that controls the RadioRouter can be any device that can generate RadioRouter control commands or OTRSP SO2R commands. Master devices include A PC program supplied with the RadioRouter that emulates a hardware control panel with text displays, virtual push buttons and virtual LEDs to display status. Optional hardware control panel with buttons, LEDs and an LCD which behaves the same as the PC program but in hardware. SO2R OTRSP compatible logging program such as WriteLog or WinTest. A dumb terminal Your own home brew hardware or program. The RadioRouter commands are outlined in this document to enable you to implement your own control program or hardware. Receiver Board Theory of Operation RadioRouter Rx board - The receiver mixer takes speaker output or line level audio, does DC isolation, buffering and gates the audio before going to an audio summing amp, then the audio is amplified with a built-in 10w speaker amp. Each audio channel can be manually switched or controlled through the RS232, RS485 or USB serial port. The RadioRouter is controlled by a PC running our RadioRouter control software. You can also use our Universal Control Head or a device of your own design to control the mixer through the serial port. The optional transmitter control board provides 14 dry contacts to switch mic audio, paddle, key, PTT, ALC or just about any signal up to 2 amps between multiple radios and a common IO port that connects to the main microphone, paddle, key etc. The supplied firmware supports the OTRSP (Open Two Radio Switching Protocol) serial command set used by many contesting programs. Rx Audio Input and Audio Levels The RadioRouter takes mono audio inputs from 4 audio sources. This is typically the speaker audio output from the receiver. Unlike other audio mixers, which only handle live level audio, the RadioRouter takes speaker audio and converts it to an internal line level for switching and mixing. The Rx audio is isolated from ground so both single and dual ended audio amplifiers can be used. The maximum input voltage should be kept below 8v p/p to avoid distortion. The audio level of each channel is still controlled by the volume control on the radio. A master audio level control is provided in the RadioRouter but is typically left at mid scale and generally not used. The master audio volume is a digital potentiometer which can be set with a value from 0 (off) to 255 (full volume) through the serial port along with all other commands.
RadioRouter Rx Channel Selection Each of the 4 audio channels can be enabled and disabled manually or under software control. Enabling an audio channel will pass the audio from the input buffer to the audio summing amplifier and speaker/headphone amplifier. Channel selection is performed by grounding the input control signal to each of the 4 audio switches. This can be done with a mechanical switch to ground or with a HamStack CPU board which is then connected to a PC or hardware control panel. Rx Audio Output Stage The RadioRouter audio output stage includes a built-in 10 watt audio amplifier that can drive a good quality mono communications speaker. The output passes through an output enable relay that can completely disconnect the output from the external speaker. A separate headphone output is provided and includes a high frequency rolloff filter to eliminate any potential hiss. The headphone output is also relay isolated to allow the headphone output to be completely disconnected from the headphones. Connections Audio Inputs Tip Speaker positive Ring Not used Sleeve Radio ground or speaker negative Speaker output Tip Speaker positive Ring Not used (default). Ring can be connected to the tip using the ring jumper spkr behind J8 Sleeve Speaker negative (ground) Headphone output Tip Headpohone positive if mono or left channel if stereo. Ring Not used (default). Ring can be connected to the tip using the ring jumper phone behind J8 Sleeve Speaker negative (ground) LED Indicators Five LEDs on the front of the Rx board provide system status and Rx radio port state. The first LED labeled Status on the chassis provides general system status. This LED will blink during system booting and configuration. When in normal operation, the Status LED is always on indicating power is on and the system is operating normally. More details on Status LED blinking later. Rx port 1-4 LEDs indicate which 4 Rx ports are enabled.
RadioRouter Rx Board Block Diagram Rx1 Rx2 Rx3 Input buffer and isolation 4 in 1 out Audio Switch Buffer & master volume digital pot 10w Speaker amp Speaker enable Speaker out Rx4 Low Pass Filter Phones enable Headphone out USB RS485 RS232 HamStack CPU LED Indicators Status 1 2 3 4 Switches +12v Input Power Supply
RadioRouter Serial Control Port The RadioRouter is normally controlled through the serial port. There are three types of serial connection available. An RS-485 network connection and a choice of either a RS-232 DB9 or mini- USB connector. RS-485 Connection This connection is provided on the RJ-45 8 pin modular jack. This jack provides the 2 wire RS-485 serial A/B signals plus power and ground. The pinout is standardized across many Sierra Radio products. RS-485 is similar to more common RS-232 in that you send ASCII characters asynchronously over the two wires. RS-485 differs from RS-232 in that it is a half-duplex connection, either sending or receiving, but not both at the same time. RS-485 has the significant advantage that you can run very long cables, up to 4,000 feet in length (versus the standard maximum of 50 of RS-232) and you can hang multiple devices on the same set of wires. This allows you to create a network of wired devices all listening and talking on the same serial network cable. The StationStack Control Protocol defines a device addressing scheme that makes this work. Every device, including a RadioRouter, PC, or control head has an address. Commands are sent from one device to another and ignored by all other devices. For example, you can single control head or program talking to multiple target devices such as a RadioRouter and a coax relay and a digital volt meter all on the same network. This provides a highly expandable shack control network. The Sierra Radio implementation of RS-485 defines not only the network addressing scheme but also the physical connection standard. We use commonly available ethernet cable and define the pin assignments so that multiple Sierra Radio products can all talk to eachother on the shack control network. In addition to the two data wires in the ethernet cable, we reserve two wires for power and ground. The power is typically +13.8 VDC from the shack power supply. This allows a control head or target control device like the RadioRouter to plug into the network and draw operating power from the network. This is especially handy when you have a remote device, like coax relay hundreds of feet from the shack or source of power. Both data and power will be sent to the remote device on the same ethernet cable. RS-232 OR USB The RadioRouter has room for only one additional connector on the back panel. Either a DB9 for RS232 or a mini-board with a mini-usb jack and USB to serial converter chip. At the time of ordering your RadioRouter, you must select the RS232 or USB option. Some people prefer USB because it will not require an external USB to RS-232 converter. Others prefer RS232 because it is slightly less expensive and is very common connection. Jumper Selection Regardless of the interface you choose, RS-485, RS232 or USB, you will have to place two jumpers in the JU5_Serial_Port jumper block. When selecting the serial interface of choice, you will be disconnecting the other serial port type. Having said that, you can always leave the RS-485 Tx jumper installed and send the output from the RadioRouter to both the RS-485 and RS-232/USB outputs. It is not possible to have both the RS-485 and RS-232/USB inputs hooked up at the same time.
RadioRouter Hacking the Stack We encourage people to use the RadioRouter in creative ways. The hardware and firmware was designed to be easily understandable allowing the user to customize the hardware configuration. We call this hacking the stack. Feel free to user multiple board in various configurations, write your own control software, have fun. Hacking The Stack - Turning the 4 port router into a an 8 port router The Rx board provides all the necessary connectors and signal isolation and signal buffering for 4 ports, however the core audio switch in the RadioRouter Rx board is actually a 8 input mixer. This means that with a second, partially-populated Rx board, you can expand the system to an 8 to 1 audio router / mixer. To do this, you need to populate the second Rx board with the connectors, isolation transformers, audio buffers and some extra connectors and a few miscellaneous parts. Additional connectors must be added to the first Rx board as well. The second Rx board is mounted under the first Rx board. The addition of a second Rx board makes the entire board stack too tall to fit the standard RadioRouter chassis box but the user can easily mount the board stack in a custom enclosure. Additional mounting holes are provided to make this easy. An 8 port configuration can also be used to route 4 stereo pairs by plugging the left channel into board 1 and the right channel into board 2. 4 Port Rx RadioRouter RX board 1 8 Port Rx RadioRouter RX board 1 RX board 2 Hacking The Stack - Manual port selection The Rx board can be used without a HamStack CPU board. To do this, Rx channel selection is done by grounding the audio mixer control switch inputs to enable the individual audio paths. The inputs are normally pulled up to +5v shutting off each channel. Solder pads are provided labeled Enable_1 through Enable_4 for this purpose. Additionally the digital potentiometer used for the master volume setting must be manually set to mid scale. This is done by inserting a jumper wire or shunt at the jumper position labeled MID next to U8, the digital potentiometer chip....
RadioRouter Rx Board Parts Placement
Tx Board 1 For Tx radio 1 and 2
RadioRouter Tx Board Option Overview The RadioRouter also supports transmitter switching with the optional Tx board. This board replaces the HamStack CPU board mounted to the Rx board and provides a 14 pole, 2 position dry-contact switch which allows the user to route up to 14 signals plus ground from a common set of user jacks to one of two transmitters. A second Tx board can be added to create a 4 transmitter switch. Electrical Signals The Tx board will route any 14 signals between the two DB15 radio connectors to the common DB15 user connection port. Simply put, the signal on radio port connector 1 pin 1 and radio port connector 2 pin 1 are switched back and forth and the currently selected radio s signal will be presented to the user connector pin 1. Signals can flow either way and must have a maximum current rating of 1 amp. Any signal the user chooses to switch can be wired up to any pin the user chooses. When using the RadioRouter Junction Box, the pins are pre-assigned as follows Pin Signal 1 Microphone + Note: Mic bias may be inserted on Tx board. 2 Microphone - 3 PTT 4 Paddle Dit 5 Paddle Dah 6 Spare 7 Radio A/B selection 8 Ground 9 Headphones Left 10 Headphones Right 11 Spare 12 Spare 13 Spare 14 Spare 15 Spare Radio Connection Cables Connections to the transmitters and the user devices such as microphone and paddle is made with cabled connected to the DB15 connectors. The user can make up a custom cable or use a RadioRouter cable and Junction Box. Custom Radio Cables A custom cable would have a male DB15 connector on one end to plug into the radio router and connectors mounted to the cable at the other end to connect to the radio. Custom User Device Cable The user device cable has a DB15 on one end and is connected directly to the user devices including microphones, paddles, etc.
Junction Box and Standard Cables To make the radio and user device connections easier, the optional Radio Junction Box kit provides a set of pre-wired DB15 to DB15 cables and three junction boxes. The junction box is a breakout board that connects the DB15 cable back to the router and a variety of ¼ jacks, a 3.5mm jack and solder pads. The Junction Box chassis has a flange mounting tab to allow for easy mounting to shelves, walls and under the operating desk. Using a Junction Box for radio connections The junction box provides jacks for the most common signals including microphone, paddle, and PTT. Off the shelf cables can be used to connect from the junction box to the connectors on the transmitter. Using a Junction Box for user devices The junction box provides jacks for the most common signals coming from user devices including microphone, paddle, and PTT. The user device junction box should be mounted to a convenient location where the operator can easily access the jacks such as under the operating desk. The most commonly used jacks are lined up along the front edge of the junction box including microphone input (3.5mm), PTT (¼ ), headphone output (¼ ) and paddle input (1/4 ). The back edge of the junction box includes the DB15 cable to connect back to the router, an extra PTT input jack (1/4 ) for a foot switch for a footswitch and the Radio A/B switch input (1/4 ). Radio A/B Jack While control of the router s transmitter selection is normally done through the serial port, the Radio A/B switch input provides an alternative way to select the transmitter. When you briefly ground the A/B input, the router s Tx selection will toggle between transmitter 1 and 2. Radio 1 Radio 2 User Connections This diagram illustrates one of the 14 switch circuits on the Tx routing board. 14 of the 15 pins are switched through dry contact relays. Selecting radio 1 will connect all pins from the radio 1 connector to the corresponding pin on the User Connection jack.
Connecting 4 Transmitters The RadioRouter can connect 4 transmitters by stacking two Tx boards. The circuit effectively looks like this Tx board #1 Radio 1 Radio 2 Same circuit 14 times User Connections Tx board #2 Note that when installing the second Tx board, there will be an extra User Connections DB9 connector. This connector can be left out or installed and not used. It does make a convenient place to tap into the signals going to the user devices like the microphone, paddle, etc. Radio 3 Same circuit 14 times Radio 4 This diagram illustrates one of the 14 switch circuits on the Tx routing board.s 14 of the 15 pins are switched through dry contact relays. Selecting radio 1 will connect all pins from the radio 1 connector to the corresponding pin on the User Connection jack.
RadioRouter Tx Board Parts Placement
RadioRouter Tx Board Assembly Instructions Most components are installed where shown on the component placement diagram. Please note the following special assembly instructions. Do not install components marked *Optional in the BOM Mask these solder pads for future component installation. On the Tx Board #1 For radio 1 and 2 J101A, J102A, J103A, J104A, J105A, J106A (outer row away from the CPU chip) These are all female single row header sockets facing up J101B, J102B, J103B, J104B, J105B, J106B (inner row closer to the CPU chip) are long male single row header pins facing down. They will mate to JxxxB on the Rx board. J5 Install 10 pin (2x5) female header socket J6 Install 10 pin (2x5) male long pin male header facing downward J9 & J10 Install 10 pin (2x5) female header sockets J11 Install 10 pin (2x5) male long pin male header facing downward On the Tx Board #2 For radio 3 and 4 J101A, J102A, J103A, J104A, J105A, J106A (outer row away from the CPU chip) These are long male single row header pins facing down. They will mate to JxxxB on the Tx1 board. J101B, J102B, J103B, J104B, J105B, J106B (inner row closer to the CPU chip) Not installed. Mask holes to allow future component installation. J5 Install 10 pin (2x5) male long pin male header facing downward J9 & J10 Install 10 pin (2x5) male long pin male header facing downward
Solder Connections Adding a jumper wire is required to connect the status LED on the rev 1.0 transmitter PCB as shown. Connect the jumper wire from the base of the stacking connector to the solder pad. J2 on Tx board 1 is a long pin male header connector. Feed the pins through the PCB and rest the connector s insulating block on the top of the PCB as shown. When soldering the connectors, make sure the plastic structure is flush with the surface of the PCB. Solder each pin carefully.
RadioRouter Tx Board #1 Bill of Materials Basic components required on the first Tx board Radio ports 1 & 2 C1 10 uf electrolytic C2 10 uf electrolytic C3 0.1 uf C4 0.1 uf C5 22 pf C6 22 pf C7 0.1 uf C8 10 uf electrolytic *Optional for mic bias C9 10 uf electrolytic *Optional for mic bias C10 1-10 uf electrolytic *Optional for mic bias D1 LED, T1 INS1 Crystal insulator J1 3.5mm stereo jack J2 DB15-F J3 DB15-F J4 DB15-F J5 2x5 female header socket J6 2x5 male header, long pins facing down J7 6 pin female SIP header socket J8 2x5 female header with shroud J9 2x5 female header socket J10 2x5 female header socket J11 2x5 male header, long pins facing down, inner row J101A 1x8 male header, long pins facing down, inner row J102A 1x8 male header, long pins facing down, inner row J103A 1x6 male header, long pins facing down, inner row J104A 1x8 male header, long pins facing down, inner row J105A 1x6 male header, long pins facing down, inner row J106A 1x8 male header, long pins facing down, inner row J101B 1x8 female header socket, facing up, outer row J102B 1x8 female header socket, facing up, outer row J103B 1x6 female header socket, facing up, outer row J104B 1x8 female header socket, facing up, outer row J105B 1x6 female header socket, facing up, outer row J106B 1x8 female header socket, facing up, outer row JU1 1x2 pin male header, labeled Bypass Mic_cap R1 270 R2 270 R3 4.7k *Optional for mic bias R5 4.7k *Optional for mic bias RP1 6 pin 10k SIP resistor pack with 5 bussed resistors RY1-RY14 DPDT 12v DC relay U2 7805 U3 74HC595 U4 ULN2803 U5 LM317Z, TO-92 footprint, *Optional for mic bias SOC3 16 pin DIP socket SOC4 18 pin DIP socket SW1 Pushbutton switch SW2 Pushbutton switch Y1 16 MHz crystal Optional Components for Mic bias circuit Not otherwise required C8 10 uf electrolytic C9 10 uf electrolytic C10 1-10 uf JU1 1x2 pin male header, labeled Bypass Mic_cap U5 LM317Z, TO-92 footprint
Tx Board 2 For radio ports 3 and 4 Tx board 2 only requires a few components including the relays and connectors. Install mounting screws and standoffs in these locations. Install two jumpers. Install long male header connectors Install long male header connectors
RadioRouter Tx Board #2 Bill of Materials Components required on the secondtx board Radio ports 3 & 4 J2 DB15-F J3 DB15-F J5 2x5 male header, long pins facing down J9 2x5 male header, long pins facing down J10 2x5 male header, long pins facing down J101B 1x8 male header, long pins facing up, outer row J102B 1x8 male header, long pins facing up, outer row J103B 1x6 male header, long pins facing up, outer row J104B 1x8 male header, long pins facing up, outer row J105B 1x6 male header, long pins facing up, outer row J106B 1x8 male header, long pins facing up, outer row RY1-RY14 DPDT 12v DC relay Components NOT INSTALLED Radio ports 3 & 4 C1 Not installed C2 Not installed C3 Not installed C4 Not installed C5 Not installed C6 Not installed C7 Not installed C8 Not installed C9 Not installed C10 Not installed D1 Not installed INS1 Not installed J1 Not installed J4 Not installed J6 Not installed J7 Not installed J8 Not installed J11 Not installed J101A Inner row not installed J102A Inner row not installed J103A Inner row not installed J104A Inner row not installed J105A Inner row not installed J106A Inner row not installed JU1 Not installed R1 Not installed R2 Not installed R3 Not installed R5 Not installed RP1 Not installed U2 Not installed U3 Not installed U4 Not installed U5 Not installed SOC3 Not installed SOC4 Not installed SW1 Not installed SW2 Not installed Y1 Not installed
RadioRouter Rear Panel Connections Tx Rx Radio A/B 3.5mm stereo jack for connection to an external pushbutton or footswitch input. Switch closure toggles between radio 1 and radio 2. Radio 1, 2 (Cable to Junction Box) Connections to each transmitter. Typically mic input, paddle input, PTT input, etc. May also be amp ALC, or user defined signals. Operator (Cable to Junction Box) Connections to station operator devices including microphone, paddle, etc. Rx1, Rx2, Rx3, Rx4 inputs Mono speaker or line level inputs to the Rx audio mixer / switch and speaker amp. Speaker out Amplified mono output of the audio mixer / switch. 10 watt audio output needs a nominal 8 ohm nonamplified speaker. Headphones out Buffered mono audio out of the mixer / switch. Includes low pass filter. RS485 One way to connect to a control head or PC to control the RadioRouter. Uses common ethernet cable. RS232 or USB The other way to connect to a PC to control the RadioRouter. The Rx board support either a DB9 for RS232 or a USB daughter board with a mini-usb connector.
StationStack Junction Box Parts Placement & Connections J1 3.5mm stereo jack J2, J3, J4, J5, J7 ¼ stereo jack J6 DB15 female connector J1 Tip Microphone + Ring n/c Sleeve Microphone J2 Tip PTT Ring n/c Sleeve Ground J3 Tip Dit Ring Dah Sleeve Ground J4 Tip Headphone tip Ring Headphone ring Sleeve Ground J5 Tip A/B radio selection Ring n/c Sleeve Ground J6 Radio interface cable Pin Signal 1 Microphone + Note: Mic bias may be inserted on Tx board. 2 Microphone - 3 PTT 4 Paddle Dit 5 Paddle Dah 6 No connection 7 Radio A/B selection 8 Ground 9 Headphones Left 10 Headphones Right 11 Spare 12 Spare 13 Spare 14 Spare 15 Spare J7 Tip PTT Footswitch Ring n/c Sleeve Ground
StationStack Junction Box Schematic
RADIOROUTER COMMAND SYNTAX Baud Rate The StationStack control protocol sends ASCII data at 9600 baud, non-inverted, 8 bits, no parity. The connection between devices can be changed to any baud rate supported by all devices. Just make sure all devices are set to the same speed. Command Packet A command packet is a string of text that is sent between the master PC or hardware control head and the RadioRouter or other device that is being controlled. A command packet is a string of ASCII characters that contains the payload to be transmitted from point A to point B and the additional characters necessary to provide synchronization, packet type identification, addressing, and error checking. The StationStack control protocol defines 4 packet formats. Most StationStack and HamStack devices will recognize all 4 formats. In each case, the command payload, is identical. The only difference is the characters around the command payload that route the payload to the right destination. Packet Types 1. Fully addressed packet /A09:MIX,XX1XXXXX:89 Sends the payload to a specific address with error checking. Typically used on a wired or wireless network with multiple target devices to be controlled. 2. Fully addressed w/o error checking /009:MIX,XX1XXXXX:XX Note: the second character 0 is a zero. Sends the payload to a specific address but ignores the error checking field. The packet must contain two characters in this position and they can be any arbitrary characters. Typically used on a wired or wireless network with multiple target devices to be controlled. This is a convenient way to manually send a command with a dumb terminal program to a specific device without having to calculate the CRC error check value. 3. Direct packet //MIX,XX1XXXXX Typically used in a direct connection between one master (PC or control head) and one target device (RadioRouter) to be controlled. This greatly simplifies the code on both ends and is also a convenient way to manually send commands from a dumb terminal. If multiple devices, even with different network addresses, are connected to the network, all devices will decode and execute this command. This can be a quick way to reset all devices on a network. Avoid using this command with multiple devices that will automatically generate a response to eliminate packet collisions on the network. 4. Raw packet MIX,XX1XXXXX This format is not generally used in StationStack or HamStack applications. It is only used to be compatible with foreign protocols. In the RadioRouter, this format is used when in SO2R mode.
RADIOROUTER COMMAND SYNTAX Fully Addressed Packet Format A fully addressed packet typical packet looks like this... /A09:MIX,XX1XXXXX:82<13> --------------------------------------------------------------------------------- Start Packet From To : Payload : CRC End of Type Address Address Value of Packet Packet --------------------------------------------------------------------------------- Start of Packet A forward slash character / is reserved for the start of packet framing indication. When a slave device sees the slash, it knows there is a new packet. Packet Type The packet type character defines the format of the packet and instructions for how the packet is to be interpreted. // Direct IE: //reset /A Addressed IE: /A12:reset:99 /0 Addressed no error checking IE: /012:reset:99 From Address / To Address The device address is a single printable ASCII character. While any character will work, by convention, the following characters are recommended and used for default values. 0 System master. Typically a PC. 1 Hardware control head 2-7 User assigned devices 8 GPIO board 9 RadioRouter #1 A-Z User assigned devices * Broadcast to all devices. We do not recommend using lower case letters or punctuation. Payload The payload is the command to be delivered to the target device. Payload contents are application dependent and will vary from device to device. There are commands typically found on all SRS devices including PING, STATUS, SETADDR, etc. in addition to application specific commands. Payloads may contain multiple arguments separated by commas. For example //LCD,2,5,Hello. In this case, the payload is LCD,2,5,Hello.
RADIOROUTER COMMAND SYNTAX End of Packet The end of packet character is a carriage return, ASCII byte value 013 (decimal). When an end of packet character is encountered, the input buffer is evaluated. The evaluation process identifies a packet by finding the start of packet synchronizing character / and extracts the buffer contents up to the end of packet character. The command parser then extracts the packet type, addresses, error check value and payload. The error check value is calculated and compared to the packet s error check value. If the values do not match, the buffer is flushed. If the packet is good, then the to address is examined. If the to address is the same value as the devices address, the payload will be dropped into the command decoding subroutine in the target device for evaluation and execution, if not, the packet is ignored and flushed from the buffer. If the payload is not recognized by the target device s command decoding subroutine, the command payload is flushed.
STATIONSTACK RADIOROUTER SUPPORTED COMMANDS RX mixer channel control Command MIX,<mask> Example //MIX,10X00000 Will turn on port 1, and turn off ports 2,4,5,6,7,8 Regardless of the current state port 3 will be unchanged Argument definition <mask> is a string of 8 characters that turn each mixer channel 1 8 on or off. 1 = port on 0 = port off X = do not change the current state of the channel Master receiver audio mixer volume Command VOL, <value> Example //VOL,100 Argument definition <value> is a number between 0 and 255 which will set the master volume. 0 = off and 255 is maximum volume. The default is typically 100 which is close to mid scale. Individual channel volume is set with the radio s volume control. Transmitter selection Command TXn (TX1, TX2, TX3, TX4) Example //TX1 Argument definition: none. Sets the focus of the transmitter board to transmitter 1 or 2 when using one transmitter board or between 1, 2, 3, or 4 when using two transmitter boards. Speaker control Command SPEAKER,<value> Example //SPEAKER,ON Definition Enable / disable speaker output. <value> can be one of the following strings ON or 1 = speaker enabled OFF or 0 = speaker disabled
STATIONSTACK RADIOROUTER SUPPORTED COMMANDS Operating Mode Selection Command MODE,<value> Example //MODE,1 Sets operating mode of the RadioRouter. Argument definition <value> is one of the following options 1 = Mode 1. Control head or PC virtual control head control (default) 2 = Mode 2. OTRSP SO2R compatible mode. Notes on Mode Usage Mode 1 StationStack Control Head or Control Head Software This is typically used with a PC virtual control head program or a hardware control head using the StationStack Control Protocol where the packets are either fully addressed (/A) type or direct (//) type. For example a direct command to turn on Rx port 1 would be //MIX,1XXXXXXX Mode 2 OTRSP Logging Computer Program This is used when the RadioRouter is being controlled from a contesting program such as WinTest or WriteLog using the Open Two Radio Switching Protocol (OTRSP). This format does not use any packet framing characters, like /A01:. The OTRSP commands are sent in raw form. A command payload of TX1 to select transmitter 1 is simply sent as TX1 from the logging program. Setting the Mode Manually with the Reset and Mode buttons The mode can also be set at boot time with the Reset and Mode buttons found on the CPU or Tx boards. When the RadioRouter powers up, it will flash the Status LED a few times indicating that power has been applied and it is going through its boot process. After about 5 seconds, the RadioRouter is booted and ready to be used. At this point the Status LED goes to a solid green indicating the normal on condition. To set the mode manually with these buttons, hold the Mode button down, then press the Reset button briefly, still holding the Mode button. After the Status LED initially flashes, a few seconds later the Status LED will then blink once. If you want to boot in mode 1, you have two seconds to let go of the Mode button at that point. If you want to boot in mode 2, continue holding down the Mode button. After the Status LED blinks twice, let go of the mode button. In a few seconds, the Status LED will send either the number 1 (. - - - -) or the number two (.. - - -) in CW indicating which mode was selected. Timing is critical. If you bounce you finger on one of the buttons or hold it down too long, you may set the wrong mode. Repeat the process to set it to the mode you want. Every time the mode is set, it will be stored in flash memory and when the device is re-booted, it will come up in the mode that was last set.
STATIONSTACK RADIOROUTER SUPPORTED COMMANDS Headphone output control Command PHONES,<value> Example //PHONES,ON Definition Enable / disable headphone output. <value> can be one of the following strings ON or 1 = headphones enabled OFF or 0 = headphones disabled OTRSP Compatible Commands This is an open standard protocol used to control hardware devices in an SO2R contest station. OTRSP is the Open Two Radio Switching Protocol. The RadioRouter supports the most common basic OTRSP commands that are used on popular logging programs including WinTest, W1MM and WriteLog. Supported OTRSP commands RX1 Listen to radio 1 RX1S Listen to radio 1 RX2 Listen to radio 2 RX2S Listen to radio 2 RX1R Listen to both 1 & 2 RX2R Listen to both 1 & 2?RX Returns the mode set TX1 Set tx focus to radio 1 TX2 Set tx focus to radio 2?TX Returns radio with focus?name Sets the name of the device to TEXT (up to 32 chars)?fw Returns the firmware version Command Example Definition PHONES,<value> //PHONES,ON Enable / disable headphone output. <value> can be one of the following strings ON or 1 = headphones enabled OFF or 0 = headphones disabled
STATIONSTACK RADIOROUTER SUPPORTED COMMANDS Administrative Commands Command Example Definition SETADDR,<string> //SETADDR,5 Sets the network address for the RadioRouter to <string>, where <string> is a single, printable ASCII character. The default address for the RadioRouter is 9 While the address character can be any single character we recommend the following guidelines for address programming. 0 Reserved for the controlling PC 1 Reserved for a hardware control head 2 9 Recommended for all user devices A Z Also available for user devices * Reserved for broadcast All others Punctuation is reserved for system use. Avoid lower case letters to prevent confusion and accidental upper case translation. Command Example Definition REBOOT //REBOOT This is a soft reboot command will re-start the RadioRouter. Command Example Definition PING //PING This will return the name, address and type of connected device. Command Example Definition ROLLCALL //ROLLCALL This will return the name, address and type of connected device from all devices on the network. Each device will wait for a short period of timebefore sending its response. The delay time is calculated based on the device address. For example an address of 5 will wait 5 * 100 ms = 500 ms. This will minimize or avoid collisions. Command Example Definition STATUS //STATUS This will return useful status information about the connected device.
STATIONSTACK RADIOROUTER SUPPORTED COMMANDS Control Head Commands These are commands that the master controlling device will respond to. The control head can be a physical control head or a virtual control head implemented in software on a PC. In either case, they should behave the same way. Command Example Definition LCD,<row>,<column>,<string> //LCD,2,5,W1AW The RadioRouter assumes an LCD of at least 2 rows and 20 columns. This command displays the text string W1AW <string> on row 2 starting at character position 5. The LCD command also responds to a special command CLS in the format //LCD,CLS The CLS argument will clear the LCD display screen Command Example Definition LED,<led_mask> //LED, 1100XXGGRRYY This command will set the state of the control head LEDs. The RadioRouter assumes 12 LED are available. The <led_mask> is a 12 character string that represents the state of each LED from #1 to #12. Each character can be one of the following values. Character Meaning What is displayed 1 On Green 0 <zero> Off Off G On Green O <letter O> Off Off R Red Not used Y Yellow Not used X No change What ever the previous state was Examples LED,111100001111 Turn on LEDs 1-4 and 9-12, turn off 5-8 LED,GGGRRRYYYOOO Set LED 1-3 Green, 4-6 Red, 7-9 Yellow, 10-12 off LED,XXXXGXXXXXXX Set LED 5 on, don t touch the others. Note, trailing X s can be left off and the control head will assume they are X. Example LED,XX1 is the same as LED,XX1XXXXXXXXX
Notes