This page describes the device driver and the device window for the AvL TracStar car mounted antenna controller.
Basic Operation
The following short description of operating the TracStar with the sat-nms software presumes you are already used to operate the TracStar using it's handheld terminal or indoor unit. If in doubt, consult the TracStar user manual.

The buttons at the bottom of the TracStar device window control the basic functions of the device:
Satellites page. In most cases this starts the full search procedure including compass calibration, reference satellite identification and peaking to the target satellite. When the TracStar successfully peaked the target satellite, the driver switches to jog mode and applies the polarization offset.To point the TracStar antenna to a satellite, you will typically perform the following steps:
Satellites page select two reference satellites.
Main page of the device window click 'POSITION'. The TracStar now wil start it's full positioning cycle, after typically 2 or 3 minutes the antenna os positioned to the satellite.Device window pages
The following table shows which device window pages are available with this individual device type. Tool-bar functions not mentioned here are described at the general description of device windows .
--- The main parameter page displays/controls the antenna pointing.
--- This page shows the readings of the GPS receiver, the inclinometer and the receive levels.
--- This page contains the identification parameters of the target satellite and the reference satellites.
--- This page gives access to a number of parameters which tell the TrackStar how to reach and identify satellites. You should only change these values if you are already used to tweak the TracStar's behaviour ba modifying it's 'LOCKVAL' parameter.
--- The faults page.
--- The device info page.
--- The maintenance page. The configuration parameters described below are set at this page.Configuration parameters
At the maintenance page of the device window there are a couple of configuration parameters which must be set to make the software talk to the antenna controller.
| parameter | description |
|---|---|
| freqMode | Main operation mode of the TracStar |
| jogspeed | The motor speed to be used when in jog mode. 2 or 3 degrees/sec are practicable values. |
| lnbGain | Receiver sensitivity. The default value is 100. May be adjusted if the level reading of strong satellites reaches the '2999'. |
| lnbOffset | A second receiver sensitivity parameter. |
| loFreqLow | The 11GHz band LO frequency. See the chapter 'Receive Band Switching' below for details. |
| loFreqHigh | The 12GHz band LO frequency. |
| lnbSwitchId | The parameter ID to send band switching commands to. Example: 'LNB-PSU.22kHz' |
| lnbSwitchLow | The command to send to the parameter ID above to switch to 11GHz band. |
| lnbSwitchHigh | The command to send to the parameter ID above to switch to 11GHz band. |
| scanLStart | Scan start frequency for the 11GHz band. |
| scanLStop | Scan stop frequency for the 11GHz band. |
| scanHStart | Scan start frequency for the 12GHz band. |
| scanHStop | Scan stop frequency for the 12GHz band. |
| rxBand | Selects 11/12GHz band. |
| Serial | Remember to set the line parameters for the serial interface connected to the TracStar. The TracStar expects 9600,E,8,1 . |
Receive Band Switching
The TracStar itself does not support a switch between two receive bands as commonly used in Europe. The sat-nms device driver add (limited) support for this. For this you require a LNB power supply which can be controlled by the VLC in order to switch the receive band. With the configuration setting above, configure the message ID and parameter values necessary to switch the band. Then, using the rxBand configuration parameter (it is available at the Satellites page as well), you may select the frequency band as required.
Any time you command the TracStar through the sat-nms software to position the antenna to the target satellite or to perform a sky scan, the driver first sets the receive band as selected and commands the LO frequency and scan start / stop frequencies configured for the selected receive band. satellite or to
As the TracStar itself is not aware of this extension, the following limitations apply:
The wildcard frequency 10799 MHz applies to both frequency bands, you may use it with the high frequency as well if you want to make the TracStar search any channel at this satellite.
Polarization Plane Handling
The TracStar provides a polarization plane parameter which turns the feed by 90 degree if set to vertical. The polarization angle displayed (and commanded) is meant as an offset to the selected polarization plane.
The polarization plane parameter only actively changes the feed angle if the TracStar is in jog mode. In IDLE / STOPPED mode the polarization setting is memorized, the setting is postponed until a POSITION command is given.
When positioning to a satellite, the TracStar applies a polarization offset which is calculated from the antenna's geodetic location and the satellite's orbit position. It does not know about the particular skew offset of the satellite. The sat-nms driver adds this feature to the satellite positioning procedure:
The parameter 'pol offs' refers to the skew offset of the target satellite. The parameter gets saved with each particular device (=satellite) preset. After the TracStar has successfully positioned the antenna to the target satellite, the driver switches to jog mode and applies the skew offset. This way you may use stored device presets as an instant setup for already polarization-optimized pointing.
ATTENTION: The TracStar does not honour the polarization plane parameter when performing a sky scan. The channel frequencies of the reference satellites always are searched at horizontal polarization. If you want to manage a list of frequencies found at vertical polarization, you have to search these frequencies manually, e.g. with a spectrum analyzer.
Device Presets
The device driver stores complete setups, including the target satellite parameters, all reference satellites and the selection of those. A device preset of the AvL-TracStar device is intended to act as a data file of all information required to point the antenna to a certain satellite. When the preset is recalled, the satellite parameters get programmed to the TracStar, but no positioning is commanded. Due to this fact, you may recall presets in order to view / edit / copy them without moving the antenna. Once you have recalled the preset with the satellite parameters you are looking for, click 'POSITION' to make the TracStar point the antenna to the selected satellite.
Variables defined by this device driver
| name | type | flags | range |
|---|---|---|---|
| info.driver | TEXT | R/O | StringRange R/O |
| lowLevel.cmd | TEXT | StringRange | |
| lowLevel.reply | TEXT | R/O | StringRange R/O |
| faults.99 | ALARM | R/O | AlarmFlagRange R/O (Communication) |
| faults.commstat | TEXT | R/O | StringRange R/O |
| info.type | TEXT | R/O | StringRange R/O |
| info.port | TEXT | R/O | StringRange R/O |
| info.frame | TEXT | R/O | StringRange R/O |
| info.serialno | TEXT | R/O | StringRange R/O |
| info.revision | TEXT | R/O | StringRange R/O |
| info.faultcode | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| internal.nsats | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| internal.oper | TEXT | R/O | StringRange R/O |
| internal.state | TEXT | R/O | StringRange R/O |
| internal.pstat | TEXT | R/O | StringRange R/O |
| internal.line1 | TEXT | R/O | StringRange R/O |
| internal.line2 | TEXT | R/O | StringRange R/O |
| internal.lofreq | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| internal.scan2 | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| internal.scan1 | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| internal.lok | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| internal.pl | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| config.freqMode | CHOICE | SETUP | EnumRange (USA USA-DVB EUROPE MIDEAST) |
| config.jogspeed | INTEGER | SAVE SETUP | IntegerRange (1 .. 5) |
| config.lnbGain | INTEGER | SETUP | IntegerRange (50 .. 300) |
| config.lnbOffset | INTEGER | SETUP | IntegerRange (0 .. 900) |
| config.loFreqLow | INTEGER | SAVE SETUP | IntegerRange (0 .. 0) |
| config.loFreqHigh | INTEGER | SAVE SETUP | IntegerRange (0 .. 0) |
| config.lnbSwitchId | TEXT | SAVE SETUP | StringRange |
| config.lnbSwitchLow | TEXT | SAVE SETUP | StringRange |
| config.lnbSwitchHigh | TEXT | SAVE SETUP | StringRange |
| config.scanLStart | INTEGER | SAVE SETUP | IntegerRange (0 .. 0) |
| config.scanLStop | INTEGER | SAVE SETUP | IntegerRange (0 .. 0) |
| config.scanHStart | INTEGER | SAVE SETUP | IntegerRange (0 .. 0) |
| config.scanHStop | INTEGER | SAVE SETUP | IntegerRange (0 .. 0) |
| config.rxBand | CHOICE | SAVE SETUP | EnumRange (LOW HIGH) |
| config.presetDefault | TEXT | R/O | StringRange R/O |
| azimuth | FLOAT | NOPRESET | DoubleRange (0.00 .. 0.00) |
| elevation | FLOAT | NOPRESET | DoubleRange (0.00 .. 0.00) |
| polarization | FLOAT | NOPRESET | DoubleRange (0.0 .. 0.0) |
| orbit | FLOAT | NOPRESET | DoubleRange (0.0 .. 0.0) |
| rxpolplane | CHOICE | SAVE | EnumRange (H V) |
| jogpolplane | CHOICE | NOPRESET | EnumRange (H V) |
| step | TEXT | NOPRESET | StringRange |
| jog | TEXT | NOPRESET | StringRange |
| stow | TEXT | NOPRESET | StringRange |
| deploy | TEXT | NOPRESET | StringRange |
| reset | TEXT | NOPRESET | StringRange |
| skyscan | TEXT | NOPRESET | StringRange |
| refresh | TEXT | NOPRESET | StringRange |
| selref | TEXT | NOPRESET | StringRange |
| evalPolOffset | TEXT | NOPRESET | StringRange |
| state.az | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.el | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.pl | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.aped | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.aoffs | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.nick | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.roll | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.longitude | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.latitude | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.magdev | FLOAT | R/O | DoubleRange R/O (0.00 .. 0.00) |
| state.height | FLOAT | R/O | DoubleRange R/O (0.0 .. 0.0) |
| state.gpsok | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.gpslock | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.azcal | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.ready | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.working | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.display | TEXT | R/O | StringRange R/O |
| state.mode | TEXT | R/O | StringRange R/O |
| state.positioning | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.stowing | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.jogmode | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.satfound | BOOLEAN | R/O | BooleanRange R/O (true false) |
| state.agc | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| state.snr | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| state.level | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| state.rxfreq | INTEGER | R/O | IntegerRange R/O (0 .. 0) |
| sat.name | TEXT | SAVE | StringRange |
| sat.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| sat.f1 | INTEGER | IntegerRange (0 .. 0) | |
| sat.f2 | INTEGER | IntegerRange (0 .. 0) | |
| sat.srate | INTEGER | IntegerRange (0 .. 0) | |
| sat.auto | TEXT | NOPRESET | StringRange |
| sat.ref1 | CHOICE | EnumRange (0 1 2 3 4 5 6 7 8 9 10 11 12) | |
| sat.ref2 | CHOICE | EnumRange (0 1 2 3 4 5 6 7 8 9 10 11 12) | |
| sat.poloffs.h | FLOAT | SAVE | DoubleRange (0.0 .. 0.0) |
| sat.poloffs.v | FLOAT | SAVE | DoubleRange (0.0 .. 0.0) |
| pointMode | CHOICE | EnumRange (DIRECT REFERENCE) | |
| satelliteScan | CHOICE | EnumRange (STRENGTH FREQUENCY) | |
| lockCondition | CHOICE | EnumRange (AGC AGC & SNR SNR ONLY) | |
| refFCondition | CHOICE | EnumRange (NONE SLOW F1 OR F2 F1 AND F2) | |
| datFCondition | CHOICE | EnumRange (NONE F1 OR F2 F1 AND F2) | |
| ref.1.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.1.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.1.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.1.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.1.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.1.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.1.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.1.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.1.auto | TEXT | NOPRESET | StringRange |
| ref.1.rxpol | TEXT | SAVE | StringRange |
| ref.2.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.2.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.2.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.2.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.2.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.2.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.2.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.2.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.2.auto | TEXT | NOPRESET | StringRange |
| ref.2.rxpol | TEXT | SAVE | StringRange |
| ref.3.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.3.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.3.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.3.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.3.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.3.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.3.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.3.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.3.auto | TEXT | NOPRESET | StringRange |
| ref.3.rxpol | TEXT | SAVE | StringRange |
| ref.4.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.4.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.4.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.4.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.4.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.4.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.4.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.4.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.4.auto | TEXT | NOPRESET | StringRange |
| ref.4.rxpol | TEXT | SAVE | StringRange |
| ref.5.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.5.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.5.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.5.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.5.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.5.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.5.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.5.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.5.auto | TEXT | NOPRESET | StringRange |
| ref.5.rxpol | TEXT | SAVE | StringRange |
| ref.6.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.6.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.6.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.6.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.6.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.6.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.6.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.6.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.6.auto | TEXT | NOPRESET | StringRange |
| ref.6.rxpol | TEXT | SAVE | StringRange |
| ref.7.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.7.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.7.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.7.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.7.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.7.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.7.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.7.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.7.auto | TEXT | NOPRESET | StringRange |
| ref.7.rxpol | TEXT | SAVE | StringRange |
| ref.8.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.8.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.8.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.8.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.8.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.8.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.8.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.8.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.8.auto | TEXT | NOPRESET | StringRange |
| ref.8.rxpol | TEXT | SAVE | StringRange |
| ref.9.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.9.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.9.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.9.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.9.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.9.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.9.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.9.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.9.auto | TEXT | NOPRESET | StringRange |
| ref.9.rxpol | TEXT | SAVE | StringRange |
| ref.10.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.10.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.10.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.10.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.10.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.10.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.10.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.10.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.10.auto | TEXT | NOPRESET | StringRange |
| ref.10.rxpol | TEXT | SAVE | StringRange |
| ref.11.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.11.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.11.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.11.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.11.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.11.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.11.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.11.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.11.auto | TEXT | NOPRESET | StringRange |
| ref.11.rxpol | TEXT | SAVE | StringRange |
| ref.12.location | FLOAT | DoubleRange (0.0 .. 0.0) | |
| ref.12.f1 | INTEGER | IntegerRange (0 .. 0) | |
| ref.12.f2 | INTEGER | IntegerRange (0 .. 0) | |
| ref.12.srate | INTEGER | IntegerRange (0 .. 0) | |
| ref.12.mode | CHOICE | EnumRange (SS FREQ) | |
| ref.12.qual | INTEGER | IntegerRange (0 .. 0) | |
| ref.12.used | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.12.available | BOOLEAN | R/O | BooleanRange R/O (true false) |
| ref.12.auto | TEXT | NOPRESET | StringRange |
| ref.12.rxpol | TEXT | SAVE | StringRange |
| faults.01 | ALARM | R/O | AlarmFlagRange R/O (Azimuth) |
| faults.02 | ALARM | R/O | AlarmFlagRange R/O (Polarization) |
| faults.03 | ALARM | R/O | AlarmFlagRange R/O (Elevation) |
| faults.04 | ALARM | R/O | AlarmFlagRange R/O (Base angle limit) |
| faults.05 | ALARM | R/O | AlarmFlagRange R/O (Reference satellite) |
| faults.06 | ALARM | R/O | AlarmFlagRange R/O (XPonder signal) |
| faults.07 | ALARM | R/O | AlarmFlagRange R/O (Compass) |
| faults.08 | ALARM | R/O | AlarmFlagRange R/O (Other fault) |