These modem profiles has manual configuration of the satellite information and can therefore be altered using the UCLI.

Transcription

1 TECHNICAL DOCUMENT Doc no.: 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 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 /20

2 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. 2/20

3 UCLI command set: The following pages describe each UCLI command in details. HELP Command The help command shows the command set for the UCLI: 3/20

4 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) 4/20

5 ele_cut_off 5 rx_lo (read only) rx_rf_freq rx_if_freq tx_lo (read only) tx_rf_freq tx_if_freq 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. Read out the Rx LO / LNB LO. In the range 9.6 GHz to 11.3 GHz. Set the Ku-band rx frequency together with LNB Lo frequency. RF frequency within GHz. LNB Lo frequency within 9.6 GHz 11.3 GHz. The SAILOR 900 VSAT supports any LNB Lo! 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 frequency is fixed at 12.8 GHz for SAILOR 900 VSAT. Set the RF frequency used for tx. Valid range is GHz to 14.5 GHz. 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. satellite name<cr><lf> Thor 1W<cr><lf> 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. satellite lon -37.5<cr><lf> 5/20

6 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. satellite skew -45<cr><lf> 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: satellite max_inc 2.5<cr><lf> 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. satellite rx_pol v<cr><lf> 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. satellite tx_pol h<cr><lf> 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. satellite ele_cut_off 10<cr><lf> 6/20

7 SATELLITE RX_POL Command: SYNTAX: satellite rx_lo Satellite rx_lo reads out the LNB Lo frequency. satellite rx_lo<cr><lf> GHz<cr><lf> 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. satellite rx_rf_freq <cr><lf> 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 MHz = 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. satellite rx_if_freq <cr><lf> 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 GHz = 10 GHz MHz SATELLITE TX_LO command: SYNTAX: satellite tx_lo Satellite tx_lo reads out the BUC Lo frequency. satellite tx_lo<cr><lf> GHz<cr><lf> 7/20

8 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. satellite tx_rf_freq <cr><lf> 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) MHz = 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. satellite tx_if_freq <cr><lf> 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 GHz = 12.8 GHz MHz 8/20

9 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. Message Parameter Description 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. MODEM NAME command: SYNTAX: modem name 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. Reads out the modem name presented as modem profile name on the dashboard in the SAILOR 900 VSAT web MMI. modem name<cr><lf> idirect Evolution<cr><lf> 9/20

10 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. modem model<cr><lf> idirect Evolution ser<cr><lf> 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 10/20

11 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. Message Parameter Description 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: [ ] 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: [ ] A NID of 0 disables the NID check. rx_rf_freq 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 GHz. 11/20

12 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. track mode narrow 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. track dvb_sym 27.5<cr><lf> 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. track dvb_nid 71<cr><lf> 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. track rx_rf_freq <cr><lf> 12/20

13 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. Message Parameter Description 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 Print all tracking status information: (read-only) Vessel heading Azimuth relative Elevation relative Polarization skew GPS position event_list Print entire list of active events (read-only) STATUS SYSTEM command: SYNTAX: status system Status system command prints out the present system status. status system<cr><lf> Tracking<cr><lf> Here are some examples of possible status messages: Acquisition Tracking Lineup SW Upload ADU POST Ready Blocked Zone 13/20

14 STATUS TRACK_ALL command: SYNTAX: status track_all Status track_all command prints out the present tracking information. status track_all<cr><lf> Antenna heading <cr><lf> Antenna azi_rel : 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> STATUS EVENT_LIST command: SYNTAX: status event_list Status event_list command prints out the active events. status event<cr><lf> 1. Blocking Zone ADM WARNING 11:20: ON<cr><lf> 14/20

15 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. Message Parameter Description System executes system commands Info Print out system information: (read-only) 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 system restart<cr><lf> Please wait, system is rebooting. <cr><lf> SYSTEM INFO command: SYNTAX: system info system info<cr><lf> Software version : 1.20 build 41<cr><lf> ACU part name : TT-7016A<cr><lf> ACU S/N : <cr><lf> ADU part name : TT-7009A<cr><lf> ADU S/N : <cr><lf> 15/20

16 CONFIG command: The config command shows config possibilities: Below schema describes the different config commands, parameters and a short description of the function. Message Parameter Description 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. config pending_list<cr><lf> 6 pending changes. <cr><lf> lon : deg. <cr><lf> tx_rf_freq : GHz<cr><lf> rx_lo : GHz<cr><lf> rx_rf_freq : GHz<cr><lf> mode : narrow<cr><lf> CONFIG CURRENT_LIST command: SYNTAX: config current_list config current_list<cr><lf> satellite name : TS7 STM Satlink 2900<cr><lf> satellite lon : deg. satellite skew satellite max_inc satellite rx_pol : Horizontal satellite tx_pol : Vertical (x-pol) 16/20

17 satellite ele_cut_off satellite rx_lo satellite rx_rf_freq satellite rx_if_freq satellite tx_lo satellite tx_rf_freq satellite tx_if_freq modem name modem model : 5.0 deg. : GHz : GHz : MHz : GHz : GHz : MHz : X5 idirect AMIP : idirect Evolution AMIP track mode : narrow track dvb_sym : 0.0 MS/s track dvb_nid : track rx_rf_freq : GHz antenna heading antenna azi_rel antenna ele_rel antenna pol_rel antenna gps_lat antenna gps_lon zone 1 azimuth_start zone 1 azimuth_end zone 1 elevation_start zone 1 elevation_end zone 1 tx_off zone 1 active zone 2 azimuth_start zone 2 azimuth_end zone 2 elevation_start zone 2 elevation_end zone 2 tx_off zone 2 active zone 3 azimuth_start zone 3 azimuth_end zone 3 elevation_start zone 3 elevation_end zone 3 tx_off zone 3 active zone 4 azimuth_start zone 4 azimuth_end zone 4 elevation_start zone 4 elevation_end zone 4 tx_off zone 4 active zone 5 azimuth_start zone 5 azimuth_end zone 5 elevation_start zone 5 elevation_end zone 5 tx_off zone 5 active zone 6 azimuth_start : deg. : 19.0 deg. : 21.3 deg. : 55.8 deg. : 12.5 deg. : 1.0 deg. : deg. : deg. : 90.0 deg. : yes : no : deg. : deg. : deg. : 90.0 deg. : yes : no : deg. : deg. : deg. : 90.0 deg. : yes : no : deg. : deg. : 90.0 deg. : yes : no : yes : no 17/20

18 zone 6 azimuth_end zone 6 elevation_start zone 6 elevation_end zone 6 tx_off zone 6 active zone 7 azimuth_start zone 7 azimuth_end zone 7 elevation_start zone 7 elevation_end zone 7 tx_off zone 7 active zone 8 azimuth_start zone 8 azimuth_end zone 8 elevation_start zone 8 elevation_end zone 8 tx_off zone 8 active : yes : no : 45.0 deg. : deg. : 5.0 deg. : yes : no : deg. : deg. : 90.0 deg. : yes : no CONFIG DISCARD command: SYNTAX: config discard The config discard command will clear all pending settings. config discard Pending changes were discarded. 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. config activate<cr><lf> Configuration successfully saved.<cr><lf> 18/20

19 ZONE command: The zone command shows possible zone commands: Below schema describes the different zone commands, parameters and a short description of the function. Message Parameter Description zone Parameters for tracking receiver. # azimuth Set azimuth angles of zone. valid numbers #: [ 1..8 ] valid angles: [ ] # elevation Set elevation angles of zone. valid angles: [ ] # 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. zone <cr><lf> Write 19/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. zone <cr><lf> Write 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. zone 1 tx on<cr><lf> Write ZONE # ACTIVE command: SYNTAX: zone <zone number> active [< yes no >] Zone <zone number> active with parameter will enable or disable that zone. zone 8 active no OK ZONE # command: SYNTAX: zone <zone number> Zone <zone number> command will print out the current settings for the zone. zone 8 zone 8 azimuth_start zone 8 azimuth_end zone 8 elevation_start zone 8 elevation_end zone 8 tx_off zone 8 active : deg. : deg. : 90.0 deg. : yes : no Thrane & Thrane contact details: Thrane & Thrane Distributors Information in this document is subject to change without notice and does not represent a commitment on the part of Thrane & Thrane A/S Thrane & Thrane A/S. All rights reserved. Printed in Denmark. 20/20