SAILOR 900 VSAT UCLI - Polaris Electronics A/S iNFINITI (OpenAMIP) iDirect Evolution (OpenAMIP)...

White Paper SAILOR® 900 VSAT – UCLI Author. Henrik Møller

1/20

Doc no.: 95-136158-G

Introduction:

This document describes the UCLI (User Command Line Interface) used to manually control the SAILOR 900 VSAT via telnet and get status information. UCLI is introduced in the SAILOR 900 VSAT software version 1.20.

Intended readers:

► VSAT System integrators

Basis information:

Access to the UCLI is via TCP/IP telnet (port 23). When the telnet session is started the ACU will prompt for username and password. Access is granted using the username: admin and the admin password (default: 1234). Same as the username/password used in the web MMI of the SAILOR 900 VSAT. See example here:

The UCLI is intended to be used with following modem profiles: ► iDirect iNFINITI (Serial) ► iDirect Evolution (Serial) ► COMTECH CDM 570L ► COMTECH CDM 625 These modem profiles has manual configuration of the satellite information and can therefore be altered using the UCLI. If the UCLI is used together with a modem profile with ABS (Automatic Beam Switching) then most of the parameters will be read-only as these are set automatically by the modem. ABS modem profile counts following modem profiles: ► iDirect iNFINITI (OpenAMIP) ► iDirect Evolution (OpenAMIP) ► COMTECH CDM 570L and ROSS ► STM Satlink 2900

TECHNICAL DOCUMENT SAILOR® 900 VSAT – UCLI


2/20

Here is an example of how to configure a modem profile with iDirect Evolution for manual configuration:

Here is an example of a satellite profile which can then be altered using the UCLI.


3/20

UCLI command set:

The following pages describe each UCLI command in details.

HELP Command

The help command shows the command set for the UCLI:


4/20

SATELLITE Command:

The satellite command shows the command set for altering the satellite information:

Changes done to the satellite profile is first stored in volatile memory and not active until the UCLI command config activate is issued which saves the configuration in non-volatile memory and activate the settings. Below schema describes the different satellite commands, parameters and a short description of the function.

Message Parameter Description

satellite Parameters to do with pointing of the antenna

Name

(read-only)

Read name / identifier for the satellite, presented as satellite profile name on the dashboard in the SAILOR 900 VSAT web MMI.

lon 1W Set the longitude position of the satellite: 1.0W or 1.0E or -1.0 for west and 1.0 for east are allowed

skew 3.7 Skew of the satellite can be –XX.X° to +XX.X°. Set an additional skew offset of the satellite. Some satellite has additional skew because they have been placed different in the orbit. E.g. Optus satellites in Australia are offset -45 degrees. Most satellites have 0 degree skew offset.

max_inc 2.5 Maximum inclination of satellite 0.0° to X.X° Sets the maximum inclination of the used satellite. Some satellites are old and are therefore moving in larger circles in space. Setting the max_inc will add this to the SAILOR 900 VSAT acquisition window size used to find the satellite.

rx_pol v Rx polarization can be v or h for vertical or horizontal polarization.

tx_pol h Tx pol can either be defined as vertical / horizontal / x-pol / co-pol [v | h | L | r] (capital ‘L’ for reading clarity)


5/20

ele_cut_off 5 Minimum elevation cut off 0° to XX° Set the elevation referenced to earth where the SAILOR 900 VSAT must shut off transmission. This is an FCC requirement. The elevation cut off depends on how much power is transmitted and which coding is used. Please refer to the SAILOR 900 VSAT installation manual for further information.

rx_lo

(read only)

Read out the Rx LO / LNB LO. In the range 9.6 GHz to 11.3 GHz.

rx_rf_freq 12.123456 9.75 Set the Ku-band rx frequency together with LNB Lo frequency. RF frequency within 10.7 – 12.75 GHz. LNB Lo frequency within 9.6 GHz – 11.3 GHz. The SAILOR 900 VSAT supports any LNB Lo!

rx_if_freq 1200.123 9.75 Set the IF rx frequency together with the LNB Lo frequency. IF frequency within 950 MHz – 2150 MHz. LNB Lo frequency within 9.6 GHz – 11.3 GHz. The SAILOR 900 VSAT supports any LNB Lo!

tx_lo

(read only)

Tx LO frequency is fixed at 12.8 GHz for SAILOR 900 VSAT.

tx_rf_freq 14.123456 Set the RF frequency used for tx. Valid range is 13.75 GHz to 14.5 GHz.

tx_if_freq 1200.123 Set the IF frequency for tx. Valid range is 950 MHz to 1700 MHz.

SATELLITE NAME Command:

SYNTAX: satellite name Satellite name command will read out the satellite profile name. EXAMPLE: UCLI:/$ satellite name<cr><lf>

Thor 1W<cr><lf>

UCLI:/$

SATELLITE LON Command:

SYNTAX: satellite lon [<longitude degree (- for West)>] Satellite lon without parameter will read out the longitude position of the satellite used. Satellite lon with parameter will change the pointing to the new satellite longitude position. EXAMPLE: UCLI:/$ satellite lon -37.5<cr><lf>

OK<cr><lf>

UCLI:/$


6/20

SATELLITE SKEW Command:

SYNTAX: satellite skew [<skew degrees>] Satellite skew without parameter will read out the skew setting for the active satellite profile. Satellite skew with parameter will change the skew setting for the satellite profile. EXAMPLE: UCLI:/$ satellite skew -45<cr><lf>

OK<cr><lf>

UCLI:/$

SATELLITE MAX_INC:

SYNTAX: satellite max_inc [<inclination in degrees>] Satellite max_inc without parameter will read out the inclination for the active satellite profile. Satellite max_inc with parameter will set the inclination for the used satellite. EXAMLPE: UCLI:/$ satellite max_inc 2.5<cr><lf>

OK<cr><lf>

UCLI:/$

SATELLITE RX_POL Command:

SYNTAX: satellite rx_pol [< v | h >] Satellite rx_pol without parameter will read out the rx polarization for the active satellite profile. Satellite rx-pol with parameter will configure the rx polarization to either vertical or horizontal reception. EXAMPLE: UCLI:/$ satellite rx_pol v<cr><lf>

OK<cr><lf>

UCLI:/$

SATELLITE TX_POL Command:

SYNTAX: satellite tx_pol [< v | h >] Satellite tx_pol without parameter will read out the tx polarization for the active satellite profile. Satellite tx-pol with parameter will configure the tx polarization to either X-Pol or Co-Pol transmission. EXAMPLE: UCLI:/$ satellite tx_pol h<cr><lf>

OK<cr><lf>

UCLI:/$

SATELLITE ELE_CUT_OFF Command:

SYNTAX: satellite ele_cut_off [<elevation in degrees>] Satellite ele_cut_off without parameter will read out the elevation cut off for the active satellite profile. Satellite ele_cut_off with parameter will set the cut off elevation for the transmission. EXAMPLE: UCLI:/$ satellite ele_cut_off 10<cr><lf>

OK<cr><lf>

UCLI:/$


7/20

SATELLITE RX_POL Command:

SYNTAX: satellite rx_lo Satellite rx_lo reads out the LNB Lo frequency. EXAMPLE: UCLI:/$ satellite rx_lo<cr><lf>

10.250000 GHz<cr><lf>

UCLI:/$

SATELLITE RX_RF_FREQ command:

SYNTAX: satellite rx_rf_freq [<RF freq in GHz> <LNB Lo freq in GHz>] Satellite rx_rf_freq without parameter will read out the Ku-band rx frequency Satellite rx_rf_freq with parameters will configure the Ku-band rx frequency and LNB Lo frequency. EXAMPLE: UCLI:/$ satellite rx_rf_freq 11.567890 10.000000<cr><lf>

OK<cr><lf>

UCLI:/$

NOTE: Setting the Ku-band rx frequency and LNB Lo will automatically configure the L-band rx frequency. E.g. Rx L-band freq = rx_rf_freq – LNB Lo 1567.890 MHz = 11.567890 GHz – 10 GHz

SATELLITE RX_IF_FREQ command:

SYNTAX: satellite rx_if_freq [<IF freq in MHz> <LNB Lo freq in GHz>] Satellite rx_if_freq without parameter will read out the L-band rx frequency Satellite rx_if_freq with parameters will configure the L-band rx frequency and LNB Lo frequency. EXAMPLE: UCLI:/$ satellite rx_if_freq 1567.890000 10.000000<cr><lf>

OK<cr><lf>

UCLI:/$

NOTE: Setting the L-band rx frequency and LNB Lo will automatically configure the Ku-band rx frequency. E.g. Rx Ku-band freq = LNB Lo + rx_if_freq 11.567890 GHz = 10 GHz + 1567.890000 MHz

SATELLITE TX_LO command:

SYNTAX: satellite tx_lo Satellite tx_lo reads out the BUC Lo frequency. EXAMPLE: UCLI:/$ satellite tx_lo<cr><lf>

12.800000 GHz<cr><lf>

UCLI:/$


8/20

SATELLITE TX_RF_FREQ command:

SYNTAX: satellite tx_rf_freq [<RF freq in GHz>] Satellite tx_rf_freq without parameter will read out the Ku-band tx frequency Satellite tx_rf_freq with parameters will set the Ku-band tx frequency. EXAMPLE: UCLI:/$ satellite tx_rf_freq 14.108300<cr><lf>

OK<cr><lf>

UCLI:/$

NOTE: Configuring the Ku-band tx frequency will automatically configure the L-band frequency. E.g: L-band frequency = Ku-band tx frequency – 12.8 GHz (BUC Lo) 1308.300000 MHz = 14.108300 GHz – 12.8 GHz

SATELLITE TX_IF_FREQ command:

SYNTAX: satellite tx_if_freq [<IF freq in MHz>] Satellite tx_if_freq without parameter will read out the L-band tx frequency. Satellite tx_if_freq with parameters will configure the L-band tx frequency. EXAMPLE: UCLI:/$ satellite tx_if_freq 1308.300000<cr><lf>

OK<cr><lf>

UCLI:/$

NOTE: Configuring the L-band tx frequency will automatically configure the Ku-band frequency. E.g: Ku-band frequency = 12.8 GHz (BUC Lo) + L-band frequency 14.108300 GHz = 12.8 GHz + 1308.300000 MHz


9/20

MODEM command:

The modem command shows the command set for the modem information:

Below schema describes the different modem commands, parameters and a short description of the function.


mod[em] Parameters for the modem command.

Name

(read only)

Read out the name of the modem that is selected. Configured for the modem profile in the web MMI of the SAILOR 900 VSAT.

Model

(read only)

Read out the model of the modem type that is selected. Configured for the modem profile in the web MMI of the SAILOR 900 VSAT.

MODEM NAME command:

SYNTAX: modem name Reads out the modem name presented as modem profile name on the dashboard in the SAILOR 900 VSAT web MMI. EXAMPLE: UCLI:/$ modem name<cr><lf>

iDirect Evolution<cr><lf>

UCLI:/$


10/20

MODEM MODEL command:

SYNTAX: modem model Reads out the modem model presented as VSAT modem on the dashboard in the SAILOR 900 VSAT web MMI. EXAMPLE: UCLI:/$ modem model<cr><lf>

iDirect Evolution ser<cr><lf>

UCLI:/$ Here is a list of the supported modem models: ► iDirect iNFINITI ser ► iDirect iNFINITI AMIP ► iDirect Evolution ser ► iDirect Evolution AMIP ► COMTECH CDM 570L ► COMTECH CDM 625L ► COMTECH CDM 570L/ROSS ► STM Satlink 2900 ► Generic modem


11/20

TRACK command:

The track command shows the command for configuring how the antenna should track a satellite:

Below schema describes the different modem commands, parameters and a short description of the function.


track Parameters for tracking receiver.

mode dvb Set tracking receiver bandwidth or mode. The way the SAILOR 900 VSAT will track the satellite. Valid modes: [rssi | narrow | wide | dvb]

dvb_sym 22 Set the DVB mega symbols used in DVB mode for the built-in DVB-S2 receiver. Valid range: [0.1..99]

dvb_nid 0 Set the DVB NID to be verified by the built-in DVB-S2 tracking receiver, when using tracking mode DVB. Valid range: [0..65535] A NID of ‘0’ disables the NID check.

rx_rf_freq 12.123456 The frequency for the receiver to tune to, the user must verify that the frequency is in the same range as the modem rx_rf_frequency, above or below 11.7 GHz. Valid range is 10.7 GHz to 12.75 GHz.


12/20

TRACK MODE command:

SYNTAX: track mode [< rssi | narrow | wide | dvb >] Track mode without parameter will read out which tracking mode is used to track the satellite. Track mode with parameter will configure the tracking mode. EXAMPLE: UCLI:/$ track mode narrow

OK<cr><lf>

UCLI:/$

NOTE: ► RSSI – Will use the RSSI signal from the modem ► NARROW – Will use the built-in 300 KHz filter of the SAILOR 900 VSAT antenna (RECOMMENDED!) ► WIDE – Will use the wide band filter to track the satellite ► DVB – Will use the built-in DVB-S2 receiver of the SAILOR 900 VSAT antenna to track the satellite. Dvb_sym,

dvb_nid must also be configured.

TRACK DVB_SYM command:

SYNTAX: track dvb_sym [<Symbol Rate in mega symbols>] Track dvb_sym without parameter will read out the symbol rate used. Track dvb_sym with parameter will configure the symbol rate used to verify and track a transponder. EXAMPLE: UCLI:/$ track dvb_sym 27.5<cr><lf>

OK<cr><lf>

UCLI:/$

TRACK DVB_NID command:

SYNTAX: track dvb_nid [<NID>] Track dvb_nid without parameter will read out the NID used. Track dvb_nid with parameter will configure the NID used to verify and track a transponder. If set to 0 the NID will be omitted in the verification of the transponder. EXAMPLE: UCLI:/$ track dvb_nid 71<cr><lf>

OK<cr><lf>

UCLI:/$

TRACK RX_RF_FREQ command:

SYNTAX: track rx_rf_freq [<tracking frequency in GHz>] Track rx_rf_freq without parameter will read out the configured tracking frequency. Track rx_rf_freq with parameter will configure the tracking frequency. EXAMPLE: UCLI:/$ track rx_rf_freq 11.058900<cr><lf>

OK<cr><lf>

UCLI:/$


13/20

STATUS command:

The status command shows which commands to use for status information:

Below schema describes the different status commands, parameters and a short description of the function.


status Print out status information

System

(read-only)

Print system status: System state[Ready | Tracking |Acquisition |…] This is the same system status as can be seen in the web MMI dashboard of the SAILOR 900 VSAT.

track_all

(read-only)

Print all tracking status information:

Vessel heading

Azimuth relative

Elevation relative

Polarization skew

GPS position

event_list

(read-only)

Print entire list of active events

STATUS SYSTEM command:

SYNTAX: status system Status system command prints out the present system status. EXAMPLE: UCLI:/$ status system<cr><lf>

Tracking<cr><lf>

UCLI:/$

Here are some examples of possible status messages: ► Acquisition ► Tracking ► Lineup ► SW Upload ► ADU POST ► Ready ► Blocked Zone


14/20

STATUS TRACK_ALL command:

SYNTAX: status track_all Status track_all command prints out the present tracking information. EXAMPLE: UCLI:/$ status track_all<cr><lf>

Antenna heading : 0.0 deg. <cr><lf>

Antenna azi_rel : 211.6 deg. <cr><lf>

Antenna ele_rel : 21.6 deg. <cr><lf>

Antenna pol_rel : 17.6 deg. <cr><lf>

Antenna gps_lat : 55.8 deg. <cr><lf>

Antenna gps_lon : 12.5 deg. <cr><lf>

UCLI:/$

STATUS EVENT_LIST command:

SYNTAX: status event_list Status event_list command prints out the active events. EXAMPLE: UCLI:/$ status event<cr><lf>

1. Blocking Zone ADM WARNING 11:20:54 2012-4-12

ON<cr><lf>

UCLI:/$


15/20

SYSTEM command:

The system command shows which system commands exist:

Below schema describes the different status commands, parameters and a short description of the function.


System executes system commands

Info

(read-only) Print out system information:

SW version

ACU Part name / S/N

ADU Part name / S/N

restart restart system SAILOR 900 VSAT will start up with POST (Power On Self-Test) and next point to the last used satellite.

SYSTEM RESTART command:

SYNTAX: system restart EXAMPLE: UCLI:/$ system restart<cr><lf>

Please wait, system is rebooting. <cr><lf>

UCLI:/$

SYSTEM INFO command:

SYNTAX: system info EXAMPLE: UCLI:/$ system info<cr><lf>

Software version : 1.20 build 41<cr><lf>

ACU part name : TT-7016A<cr><lf>

ACU S/N : 123456789<cr><lf>

ADU part name : TT-7009A<cr><lf>

ADU S/N : 123456789<cr><lf>

UCLI:/$


16/20

CONFIG command:

The config command shows config possibilities:

Below schema describes the different config commands, parameters and a short description of the function.


Config executes config commands

pending_list

(read-only)

Show pending changes. Changes that has been entered using the above UCLI commands. The changes are not activated yet! This is done using the “config activate” command.

current_list

(read-only)

Show current configuration. Active settings.

discard Discard all pending changes.

activate Saves and activates pending configuration

CONFIG PENDING_LIST command:

SYNTAX: config pending_list The config pending_list command will print the pending changes that are not activated yet. EXAMPLE: UCLI:/$ config pending_list<cr><lf>

6 pending changes. <cr><lf>

lon : -45.0 deg. <cr><lf>

tx_rf_freq : 14.108300 GHz<cr><lf>

rx_lo : 9.750000 GHz<cr><lf>

rx_rf_freq : 11.557900 GHz<cr><lf>

mode : narrow<cr><lf>

UCLI:/$

CONFIG CURRENT_LIST command:

SYNTAX: config current_list EXAMPLE: UCLI:/$ config current_list<cr><lf>

satellite name : TS7 STM Satlink 2900<cr><lf>

satellite lon : -22.0 deg.

satellite skew : 0.0 deg.

satellite max_inc : 0.0 deg.

satellite rx_pol : Horizontal

satellite tx_pol : Vertical (x-pol)


17/20

satellite ele_cut_off : 5.0 deg.

satellite rx_lo : 9.750000 GHz

satellite rx_rf_freq : 11.053750 GHz

satellite rx_if_freq : 1303.750000 MHz

satellite tx_lo : 12.800000 GHz

satellite tx_rf_freq : 13.800000 GHz

satellite tx_if_freq : 1000.000000 MHz

modem name : X5 iDirect AMIP

modem model : iDirect Evolution AMIP

track mode : narrow

track dvb_sym : 0.0 MS/s

track dvb_nid : 1083179024

track rx_rf_freq : 11.053750 GHz

antenna heading : 0.0 deg.

antenna azi_rel : 220.5 deg.

antenna ele_rel : 19.0 deg.

antenna pol_rel : 21.3 deg.

antenna gps_lat : 55.8 deg.

antenna gps_lon : 12.5 deg.

zone 1 azimuth_start : 1.0 deg.

zone 1 azimuth_end : 359.0 deg.

zone 1 elevation_start : -90.0 deg.

zone 1 elevation_end : 90.0 deg.

zone 1 tx_off : yes

zone 1 active : no





zone 2 tx_off : yes

zone 2 active : no





zone 3 tx_off : yes

zone 3 active : no





zone 4 tx_off : yes

zone 4 active : no



zone 5 elevation_start : 0.0 deg.


zone 5 tx_off : yes

zone 5 active : no



18/20


zone 6 elevation_start : 0.0 deg.


zone 6 tx_off : yes

zone 6 active : no





zone 7 tx_off : yes

zone 7 active : no





zone 8 tx_off : yes

zone 8 active : no

UCLI:/$

CONFIG DISCARD command:

SYNTAX: config discard The config discard command will clear all pending settings. EXAMPLE: UCLI:/$ config discard

Pending changes were discarded.

UCLI:/$

CONFIG ACTIVATE command:

SYNTAX: config activate The config activate command will activate the pending settings and re-activate the satellite profile. The SAILOR 900 will start acquisition. EXAMPLE: UCLI:/$ config activate<cr><lf>

Configuration successfully saved.<cr><lf>

UCLI:/$


19/20

ZONE command:

The zone command shows possible zone commands:

Below schema describes the different zone commands, parameters and a short description of the function.


zone Parameters for tracking receiver.

# azimuth 350 10 Set azimuth angles of zone. valid numbers #: [ 1..8 ] valid angles: [ 0..360 ]

# elevation -10 20 Set elevation angles of zone. valid angles: [ 0..90 ]

# tx_off yes Enable or disable tx inside zone valid modes: [ yes | no ]

# active yes Enable or disable zone. valid options: [ yes | no ]

#

(read-only)

When only a zone number is entered, the current setting of that zone is printed. valid numbers #: [ 1..8 ]

(read-only) When zone is entered alone without a specific zone number all zones are printed.

ZONE # AZIMTUH command:

SYNTAX: zone <zone number> azimuth [<start angle> <end angle>] Zone <zone number> azimuth without any parameter will print out the current azimuth settings for the zone. Zone <zone number> azimuth with parameter will set the azimuth angles for the zone. EXAMPLE: UCLI:/$ zone 1 350 10<cr><lf>

Write OK<cr><lf>

UCLI:/$


20/20

ZONE # ELEVATION command:

SYNTAX: zone <zone number> elevation [<start angle> <end angle>] Zone <zone number> elevation without any parameter will print out the current elevation angles for the zone. Zone <zone number> elevation with parameter will set the elevation angles for the zone. EXAMPLE: UCLI:/$ zone 1 5 45<cr><lf>

Write OK<cr><lf>

UCLI:/$

ZONE # TX_OFF command:

SYNTAX: zone <zone number> tx [< yes | no >] Zone <zone number> tx without any parameter will print out the current tx setting for the zone. Zone <zone number> tx with parameter will enable or disable tx in that zone. EXAMPLE: UCLI:/$ zone 1 tx on<cr><lf>

Write OK<cr><lf>

UCLI:/$

ZONE # ACTIVE command:

SYNTAX: zone <zone number> active [< yes | no >] Zone <zone number> active with parameter will enable or disable that zone. EXAMPLE: UCLI:/$ zone 8 active no

OK

UCLI:/$

ZONE # command:

SYNTAX: zone <zone number> Zone <zone number> command will print out the current settings for the zone. EXAMPLE: UCLI:/$ zone 8





zone 8 tx_off : yes

zone 8 active : no

UCLI:/$

Thrane & Thrane contact details:

Thrane & Thrane Distributors http://www.thrane.com/Contact/Distributors.aspx

Information in this document is subject to change without notice and

does not represent a commitment on the part of Thrane & Thrane A/S.

© 2012 Thrane & Thrane A/S. All rights reserved. Printed in Denmark.

http://www.thrane.com/Contact/Distributors.aspx

SAILOR 900 VSAT UCLI - Polaris Electronics A/S iNFINITI (OpenAMIP) iDirect Evolution (OpenAMIP)...

Documents

Transcript of SAILOR 900 VSAT UCLI - Polaris Electronics A/S iNFINITI (OpenAMIP) iDirect Evolution (OpenAMIP)...