9.71 AvL-TracStar

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.

AvL-TracStar.gif

The buttons at the bottom of the TracStar device window control the basic functions of the device:

To point the TracStar antenna to a satellite, you will typically perform the following steps:

  1. At the tb-satellite.gif Satellites page select two reference satellites.
  2. Enter the parameters of the target satellite at the top of this page. Alternatively you may want to recall a device preset which contains these selections.
  3. At the tb-vlc.gif 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 .

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)