LabSat 4 is equipped with an Ethernet interface that facilitates remote control over a Local Area Network (LAN).
Remote control can be accomplished using simple text-based commands through the Telnet protocol.
If you wish to control LabSat 4 using the C# programming language, an API is available which will further simplify connection and control.
Contact your local LabSat distributor or contact Racelogic Support to get more information about the LabSat remote control information pack.
You can access and control LabSat 4 remotely with most terminal software applications that support a PORT 23 Telnet connection. When it has been connected, you can manually enter commands into a terminal program to remotely control LabSat 4. Commands are linked with the ‘:’ character and are executed on receipt of the carriage return character.
LabSat 4 is connected to the network via a standard Ethernet cable plugged into the RJ45 Ethernet connector on the rear panel. LabSat 4 can operate with a fixed IP address or with the DHCP protocol, where an IP address is automatically obtained from a network server. Contact your network administrator for advice on the best solution for your application.
You can access the network configuration options via the menu under SETUP.
- LAN
- DHCP – Tick to select/deselect.
When DHCP is deselected, the following manual options will be available:- IP Address – Set the IP Address manually.
- SUBNET MASK – Set the SUBNET MASK manually.
- DEFAULT GATEWAY – Set the DEFAULT GATEWAY manually.
- DHCP – Tick to select/deselect.
After changing any network settings, you must power-cycle LabSat 4 to reconnect to the network.
You can check the connection to your LabSat 4 by using the Ping command from the Windows command prompt along with the IP address set in the device.
An example of the Ping command with the successful response from the connected LabSat 4.
Click on a command category below to see more information about the relevant commands.
See the subsections for a detailed explanation of each command.
| Command | Function |
|---|---|
| PLAY | Play a file. You can addFROMandFORoptions to define start position as the number of seconds into the file and also the duration of replay in seconds. |
| REC (Record) | Record a file. You can add theFORoption to define the duration of the recording in seconds. |
| ATTN (Attenuation) | Set output attenuation. Attenuation level in dB. |
| MUTE | Mute all channels. |
| CONF (Configuration) | Used to configure menu options and read current user configurations. |
| TYPE | Return all text from theAboutmenu, for example, the serial number and unit type. |
| MEDIA | Media storage functions. Used to list files on media, change directories or delete files. |
| HELP | Display a list of commands for the current level. Example:HELP: |
| MON (Monitor) | Monitor functions such as request levels, switch, and raw NMEA output. |
| FIND | Beep and flash display. For example, identifying a single unit among multiple units: The backlight should flash 500 on then 500 ms off and beep 500 ms on / 500 ms off for a total of 5 seconds. |
| SHUTDOWN | Powers down the LabSat 4 unit. |
Note: For all commands (except MEDIA:LIST), inserting a ‘?’ character in place of a setting value will cause the unit to respond with the data.
Example:
PLAY:?<CR> will return <filename><CR> of the current file if it is playing, else ERR<CR>.
Tip
<CR> means carriage return which is the ASCII character 0x0D or char(13) but not the individual characters ‘<’ ‘C’ ‘R’ ‘>’.
If manually typing commands in a Telnet terminal, <CR> simply means pressing the Enter key.
Tip
<CR> means carriage return which is the ASCII character 0x0D or char(13) but not the individual characters ‘<’ ‘C’ ‘R’ ‘>’.
If manually typing commands in a Telnet terminal, <CR> simply means pressing the Enter key.
| Command | Specification |
|---|---|
| PLAY:FILE: | Replay the file from start to end. |
| PLAY:FILE: | Replay the file from the start point for the defined duration. |
| PLAY:FILE: | Replay a file from a selected time to the end. |
| PLAY:FILE: | Replay file from a selected time and for a defined duration. |
| PLAY:STOP | Stop the replay. |
| PLAY:? | Query the replay status. Replay:File Name & Duration Stream:SatGen Streaming & Duration |
| Command | Specification |
|---|---|
| REC | Record with default file name. |
| REC:FILE: | Record with a user-defined file name. |
| REC:FOR: | Record with default file name for a set duration. |
| REC:FILE: | Record with a user-defined file name for a set duration. |
| REC:STOP | Stop the recording. |
| REC:? | Query the record status (name & current duration). |
| Command | Specification |
|---|---|
| ATTN: | Add attenuation on replay (all the signals being replayed). |
| ATTN:CH1: | Add attenuation on individual channels. |
| ATTN:? | Returns the unit's attenuation settings. |
| Command | Specification |
|---|---|
| MUTE:Y | Mute all RF channels. |
| MUTE:N | Unmute all RF channels. |
| MUTE:CH1: | Mute individual RF channels. |
| Command | Specification |
|---|---|
| MEDIA:LIST | Show all files on the media. |
| MEDIA:CHDIR: | Open a directory (cannot skip folders). |
| MEDIA:CHDIR:.. | Go back one directory. |
| MEDIA:CHDIR:\ | Go back to root of the media. |
| MEDIA:DELETE: | Delete a file. |
You can use the Help keyword to display the currently available commands for each level of the tree.
If you type HELP<CR>, the currently available commands on that level would be:
- help
- ?
- ATTN
- CONF
- FIND
- MEDIA
- MON
- MUTE
- PLAY
- REC
- TYPE
If you type HELP:CONF<CR> you will see the available commands for CONF:
- CONS
- PLAY
- SETUP
- ?
You can then see the list of SETUP options, by typing HELP:CONF:SETUP<CR>:
- DISP
- PSAV
- EXT
- TIME
- DIGI
- CAN
Notes:
You can make individual channel changes by only stating the required channel in the command.
Should be entered in bits or with the prefix K or M for kbit and Mbit.
| Command | Specification |
|---|---|
| CONF:CONS:NUM_CH:<1/2/3> | Specify the number of channels. |
| CONF:CONS:QUAN_A:<1/2/4/8/12>* | Specify the Quantization setting for channel A. |
| CONF:CONS:QUAN_B:<1/2/4/8/12>* | Specify the Quantization setting for channel B. |
| CONF:CONS:QUAN_C:<1/2/4/8/12>* | Specify the Quantization setting for channel C. |
| CONF:CONS:BW_MAX:<10/16/20/24/28/30/32/36/40/44/48/52/56/60> | Specify the max bandwidth. |
| CONF:CONS:BW_DIV_A:<1/2/3/4/6> | Specify the bandwidth divider for channel A. |
| CONF:CONS:BW_DIV_B:<1/2/3/4/6> | Specify the bandwidth divider for channel B. |
| CONF:CONS:BW_DIV_C:<1/2/3/4/6> | Specify the bandwidth divider for channel C. |
| CONF:CONS:FREQ_A: | Specify the Frequency for channel A. |
| CONF:CONS:FREQ_B: | Specify the Frequency for channel B. |
| CONF:CONS:FREQ_C: | Specify the Frequency for channel C. |
| CONF:CONS:RX_MGC_EN:(0) | Disable Manual Gain Control. |
| CONF:CONS:RX_MGC_EN:(1) | Enable Manual Gain Control. |
| CONF:CONS:RX_MGC_VAL:XX | Set gain level - XX represents the required level. |
| CONF:PLAY:LOOP:Y | Enable scenarios to be replayed continuously. |
| CONF:PLAY:LOOP:N | Disable continuous replay. |
| CONF:PLAY:PAUSE: | Create a pause between each replay. |
| CONF:SETUP:DISP:CONT: | Changing the display contrast. |
| CONF:SETUP:SOUNDS:Y | Enable all unit sounds. |
| CONF:SETUP:SOUNDS:N | Disable all unit sounds. |
| CONF:SETUP:PSAV:Y | Enabling power save mode. |
| CONF:SETUP:PSAV:N | Disabling power save mode. |
| CONF:SETUP:CLKREF:EXT:Y | Enable external clock reference. |
| CONF:SETUP:CLKREF:OCXO | Enable the OCXO. |
| CONF:SETUP:CLKREF:TCXO | Enable the TCXO. |
| CONF:SETUP:TIME:UTC:Y | Enabling UTC time. |
| CONF:SETUP:TIME:MAN: | Set time manually. |
| CONF:SETUP:DIGI:CH1: | Configure digital channel 1. |
| CONF:SETUP:DIGI:CH2: | Configure digital channel 2. |
| CONF:SETUP:DIGI:CH3: | Configure digital channel 3. |
| CONF:SETUP:DIGI:CH4: | Configure digital channel 4. |
| CONF:SETUP:DIGI:CH1:OFF** | Disable digital channel 1. |
| CONF:SETUP:DIGI:CH2:OFF** | Disable digital channel 2. |
| CONF:SETUP:DIGI:CH3:OFF** | Disable digital channel 3. |
| CONF:SETUP:DIGI:CH4:OFF** | Disable digital channel 4. |
| CONF:SETUP:CAN:LOGFILE:Y** | Enable arbitrated CAN recording. |
| CONF:SETUP:CAN:LOGFILE:N** | Disable arbitrated CAN recording. |
| CONF:SETUP:CAN:REPLAYFILE:Y** | Enable arbitrated CAN replay. |
| CONF:SETUP:CAN:REPLAYFILE:N** | Disable arbitrated CAN replay. |
| CONF:SETUP:CAN:CH1:BAUD: | Setting the baud rate on channel 1**. |
| CONF:SETUP:CAN:CH2:BAUD: | Setting the baud rate on channel 2**. |
| CONF:SETUP:CAN:ACK:Y** | Enables CAN acknowledge. |
| CONF:SETUP:CAN:ACK:N** | Disables CAN acknowledge. |
| CONF:SETUP:CLKREF:OUT_DELAY | Used to align the reference clock phases on Primary and Secondary units duringMulti-Syncoperation. |
| CONF:? | Returns the unit's configuration. |
Model Limitations
*The available quantization options will depend on the LabSat 4 model.
**LabSat 4 Lite models cannot record/replay external signals.
| Command | Specification |
|---|---|
| MON:NMEA:ON | Enable live NMEA stream. |
| MON:NMEA:OFF | Disable live NMEA stream. |
| MON:SAT | Request CNO. |
| MON:LOC | Request time, height, lat & long. |