SATFEED SAF SF

SATFEED SAF SF

 Sets/gets fields given a feed index.  The feed index is either zero or one.
 If the field is omitted then all fields are returned with their values.  If
 a field is given then only that field and value is shown.

Form:

 Command Handler: SYSD
 SATFEED|SAF|SF [FEED INDEX] [FIELD] [VALUE]

 [FEED INDEX] is either 0 or 1
 [FIELD] Refer to Names given below
 [VALUE] Refer to Valid Arguments below

   Name (terse, verbose): 1, TYPE
   Range (min, max):      0, 1
   Supported Boards:      PC72xx, NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           DVB-S
                          1           DVB-S2


   Name (terse, verbose): 1, TYPE
   Range (min, max):      0, 2
   Supported Boards:      DTMA2910
   Valid Arguments:       Terse:      Verbose:
                          0           DVB-S
                          1           DVB-S2
                          2           AUTO


   Name (terse, verbose): 0, ACTIVE
   Range (min, max):      0, 1
   Supported Boards:      PC72xx, DTMA2910
   Valid Arguments:       Terse:      Verbose:
                          0           NO
                          1           YES


   Name (terse, verbose): 2, SAT_LBAND
   Range (min, max):      950, 2150 (units in MHz)
   Supported Boards:      PC72xx, NTC7044, DTMA2910
   Valid Arguments:       Any number within given range
   Description:           Allows the operator to enter the L-Band frequency within
                          the range from 950MHz to 2.15GHz. The value entered in
                          this field is used with the Local Oscillator frequency to
                          calculate the Downlink frequency using the following rules.
                          If Downlink < Local Oscillator, then Downlink - Local
                          Oscillator = │L-Band│. If Downlink > Local Oscillator, then
                          Downlink - Local Oscillator = L-Band.


   Name (terse, verbose): 6, SAT_SYMRATE
   Range (min, max):      1, 45 (units in MSps)
   Supported Boards:      PC72xx
   Valid Arguments:       Any number within given range
   Description:           Symbol Rate is defined for digital communications as the
                          number of symbols per second. The amount of data per symbol
                          is dependant upon the modulation type, e.g. QPSK, 8PSK, etc.

   Name (terse, verbose): 6, SAT_SYMRATE
   Range (min, max):      0.256, 45 (units in MSps)
   Supported Boards:      NTC7044
   Valid Arguments:       Any number within given range
   Description:           Symbol Rate is defined for digital communications as the
                          number of symbols per second. The amount of data per symbol
                          is dependant upon the modulation type, e.g. QPSK, 8PSK, etc.

   Name (terse, verbose): 6, SAT_SYMRATE
   Range (min, max):      1, 65 (units in MSps)
   Supported Boards:      DTMA2910
   Valid Arguments:       Any number within given range
   Description:           Symbol Rate is defined for digital communications as the
                          number of symbols per second. The amount of data per symbol
                          is dependant upon the modulation type, e.g. QPSK, 8PSK, etc.

   Name (terse, verbose): 8, SAT_ACQRANGE
   Range (min, max):      -10, 10 (units in KHz)
   Supported Boards:      PC72xx
   Valid Arguments:       Any number within given range
   Description:           Allows the operator to select the range of frequencies that
                          the RF tuner will sweep through to acquire the carrier.
                          Ex. If the desired carrier is at 1.080GHz and the Acquisition
                          Range is set to 5kHz, the RF tuner will sweep through
                          1.080GHz ± 2.5kHz to acquire the carrier.


   Name (terse, verbose): 8, SAT_ACQRANGE
   Range (min, max):      0.05, 7.5 (units in KHz)
   Supported Boards:      NTC7044
   Valid Arguments:       Min/Max range changes based on TYPE and SAT_SYMRATE:
                          TYPE=DVB-S:
                             Min = SAT_SYMRATE / 10
                             Max = 7.5
                          TYPE=DVB-S2:
                             Min = 0.05
                             Max = 1.5 * SAT_SYMRATE  (Note: Max still caps at 7.5)
   Description:            Acquisition Range is defined as the range of frequencies
                           that the tuner will scan in order to achieve carrier
                           synchronization. It is understood that increasing the
                           value for acquisition range will allow locking more easily
                           on an unstable frequency but will also increase demodulator
                           synchronization time. For the Newtec 7044 A/B, the formula
                           for acquisition range is symbol rate dependent; carrier
                           acquisition range (peak-to-peak) is 50kHz to 7.5 MHz: if
                           a carrier has symbol rate < 5 Mbaud, then A.R. = 1.5 x baudrate max
                           and if >5 Mbaud the A.R. = 7.5 MHz max.

                           For example, suppose the carrier has L-band frequency at 1.0GHz
                           and the symbol rate = 3MS/s, then the "Acquisition Range" is
                           4.5MHz; the receiver will sweep from 997.75MHz to 1002.25MHz (1MHz)
                           to acquire the carrier.

                           If the carrier is 1.0GHz with a symbol rate of 30MS/s, then
                           the "Acquisition Range" is 7.5MHz; the receiver will sweep
                           from 996.25MHz to 1003.75MHz to acquire the carrier.


   Name (terse, verbose): 8, SAT_ACQRANGE
   Range (min, max):      0.5, 5 (units in MHz)
   Supported Boards:      DTMA2910
   Valid Arguments:       Any number within given range.
   Description:           Acquisition Range is defined as the range of frequencies
                          that the tuner will scan in order to achieve carrier
                          synchronization. It is understood that increasing the
                          value for acquisition range will allow locking more easily
                          on an unstable frequency but will also increase demodulator
                          synchronization time.


   Name (terse, verbose): 10, MOD
   Range (min, max):      0, 22
   Supported Boards:      PC72xx
   Valid Arguments:       Terse:      Verbose:
                          0           DSS_1/2
                          1           DSS_2/3
                          2           DSS_6/7
                          3           DVBS_1/2
                          4           DVBS_2/3
                          5           DVBS_3/4
                          6           DVBS_5/6
                          7           DVBS_7/8
                          8           QPSK_1/2
                          9           QPSK_3/5
                          10          QPSK_2/3
                          11          QPSK_3/4
                          12          QPSK_4/5
                          13          QPSK_5/6
                          14          QPSK_7/8
                          15          QPSK_8/9
                          16          QPSK_9/10
                          17          8PSK_3/5
                          18          8PSK_2/3
                          19          8PSK_3/4
                          20          8PSK_5/6
                          21          8PSK_8/9
                          22          8PSK_9/10
   Description:           This control allows the operator to select
                          the expected modulation mode and FEC code rate.


   Name (terse, verbose): 10, MOD
   Range (min, max):      0, 36
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:       Verbose:
                          0            NO_FEC
                          1            QPSK_1/2
                          2            QPSK_2/3
                          3            QPSK_3/4
                          4            QPSK_5/6
                          5            QPSK_6/7
                          6            QPSK_7/8
                          7            QPSK_AUTO (DVB-S only)
                          8            QPSK_1/4
                          9            QPSK_1/3
                          10           QPSK_2/5
                          11           QPSK_3/5
                          12           QPSK_4/5
                          13           QPSK_8/9
                          14           QPSK_9/10
                          15           16APSK_2/3
                          16           16APSK_3/4
                          17           16APSK_4/5
                          18           16APSK_5/6
                          19           16APSK_8/9
                          20           16APSK_9/10
                          21           32APSK_3/4
                          22           32APSK_4/5
                          23           32APSK_5/6
                          24           32APSK_8/9
                          25           32APSK_9/10
                          26           16QAM_3/4
                          27           16QAM_7/8
                          28           16QAM_AUTO (not a valid argument)
                          29           8PSK_3/5
                          30           8PSK_2/3
                          31           8PSK_3/4
                          32           8PSK_AUTO (DVB-S only)
                          33           8PSK_5/6
                          34           8PSK_8/9
                          35           8PSK_9/10
                          36           AUTO (sets CCM to AUTO-CCM)
   Description:           This control allows the operator to select
                          the expected modulation mode and FEC code
                          rate. This control is not available when CCM
                          is in Auto.


   Name (terse, verbose): 13, ROLLOFF
   Range (min, max):      0, 2
   Supported Boards:      PC72xx
   Valid Arguments:       Terse:      Verbose:
                          3           20%
                          4           25%
                          5           35%
   Description:           The rolloff selection will determine the shape of
                          the input filter. The occupied bandwidth of the modulated
                          signal is the symbol rate multiplied by (1+α) where
                          alpha (α) is the rolloff factor. By using a lower alpha,
                          carriers can be spaced closer together on a given transponder
                          or an increased symbol rate can be realized for a given bandwidth.


   Name (terse, verbose): 13, ROLLOFF
   Range (min, max):      0, 6
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           5%  **
                          1           10% **
                          2           15% **
                          3           20%    (DVB-S2 only)
                          4           25%
                          5           35%
                          6           AUTO  (DVB-S only)
   Description:           The Rolloff selection will determine the shape of
                          the input filter. The occupied bandwidth of the modulated
                          signal is the symbol rate multiplied by (1+α) where
                          alpha (α) is the rolloff factor. By using a lower alpha,
                          carriers can be spaced closer together on a given transponder
                          or an increased symbol rate can be realized for a given bandwidth.

  ** Available only for NTC7044.AB with Firmware 1.35 and greater, or NTC7044.BB with Firmware: 2.30 and greater.
     Please contact customer support if you have any of these tuner boards, and need help upgrading the Tuner Firmware.


   Name (terse, verbose): 14, RATE_PRI
   Range (min, max):      0, 2
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           INTERFACE
                          1           SYMBOL
                          2           AUTO-CCM


   Name (terse, verbose): 15, SPECINV [DEPRECATED]
   Range (min, max):      0, 3
   Supported Boards:      PC72xx
   Valid Arguments:       Terse:      Verbose:
                          0           NORMAL
                          1           INVERT
                          2           BOTH_NORMAL
                          3           BOTH_INVERT
   Description:           RF Spectrum Inversion occurs in cases where the downlink (received
                          frequencies) frequency that is applied to (LNB) mixer is less than
                          the (LNB) local oscillator frequency. If the Downlink
                          frequency < Local Oscillator, then spectrum inversion occurs. If the
                          Downlink frequency > Local Oscillator frequency, then spectrum inversion
                          does not occur.

                          This command has been Deprecated.  It still reports a value and acts normally
                          for gets and sets but the actual functionality has been removed in favor
                          of forcing BOTH_INVERT which acts as an AUTO mode.


   Name (terse, verbose): 15, SPECINV [DEPRECATED]
   Range (min, max):      0, 3
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           NORMAL
                          1           INVERT
                          2           AUTO
   Description:           RF Spectrum Inversion occurs in cases where the downlink (received
                          frequencies) frequency that is applied to (LNB) mixer is less than
                          the (LNB) local oscillator frequency. If the Downlink
                          frequency < Local Oscillator, then spectrum inversion occurs. If the
                          Downlink frequency > Local Oscillator frequency, then spectrum inversion
                          does not occur.

                          This command has been Deprecated.  It still reports a value and acts normally
                          for gets and sets but the actual functionality has been removed in favor
                          of forcing AUTO.


   Name (terse, verbose): 12, FRAMETYPE
   Range (min, max):      0, 3
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           SHORT
                          1           NORMAL
                          2           AUTO      (Not a valid argument, read back only)
                          3           N/A       (Not a valid argument, read back only)
   Description:           The longer 64,800-bit FEC frame provides better protection but introduces
                          more latency compared to the shorter 16,200-bit FEC frame. Therefore, the
                          short FEC frame should be chosen in applications where latency is critical
                          and the longer frame should be used to optimize protection.


   Name (terse, verbose): 11, PILOT
   Range (min, max):      0, 1
   Supported Boards:      PC72xx, NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           OFF
                          1           ON
   Description:           DVB-S2 allows the option of inserting bursts of pilot tones that are very robust
                          and prevents the carrier recovery system from failing prematurely. However, when
                          pilots are enabled, the total data rate throughput is reduced by approximately 3.0%.


   Name (terse, verbose): 9, CCM
   Range (min, max):      0, 2
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           CCM
                          1           AUTO-CCM
                          2           ACM
   Description:           When the Constant Coding and Modulation (CCM) option is selected, the same modulation
                          mode and FEC is used for all physical layer framing. The advantage of using DVB-S2 in
                          the CCM mode is the improved protection that is achieved by utilizing the new inner
                          and outer codes. Another advantage is the 30 percent increase in capacity that is
                          realized while using the method. If Auto-CCM is selected, the receiver will detect and
                          configure the Modulation Mode, Pilot, and Frame Type.


   Name (terse, verbose): 5, DOWNLINK
   Range (min, max):      0, 0 (units in MHz, range is any value that does not cause LBAND to go out of range)
   Supported Boards:      PC72xx, NTC7044, DTMA2910
   Valid Arguments:       Any number within given range
   Description:           Allows the operator to enter the satellite downlink frequency. The value for the Downlink
                          frequency is used with the Local Oscillator frequency to calculate the L-Band frequency.
                          The Downlink and Local Oscillator frequencies can be used to determine if spectrum
                          inversion occurs using the following rules. If the Downlink frequency is less than the
                          Local Oscillator frequency, then spectrum inversion does occur. If the Downlink frequency
                          is greater than the Local Oscillator frequency, then spectrum inversion does not occur.


   Name (terse, verbose): 3, LO
   Range (min, max):      0, 6
   Supported Boards:      PC72xx, NTC7044, DTMA2910
   Valid Arguments:       Terse:      Verbose:
                          0           C_5150
                          1           KU_10750
                          2           KU_10600
                          3           KU_9750
                          4           KU_9600
                          5           C_MANUAL
                          6           KU_MANUAL
                          7           KU_10000
                          8           KU_11300
   Description:           The Local Oscillator (L.O.) control specifies the frequency of the LNB local oscillator.
                          The standard L.O. frequencies for “C” and “Ku” bands are 5.150GHz and 10.750GHz respectfully
                          although, some other variants are included. If the desired L.O. frequency is not listed,
                          select either C: Manual or Ku: Manual and enter the L.O. frequency in the Manual L.O. field.
                          The Local Oscillator and Downlink frequencies can also be used to determine if spectrum
                          inversion occurs using the following rules. If the Downlink frequency is less than the Local
                          Oscillator frequency, then spectrum inversion does occur. If the Downlink frequency is greater
                          than the Local Oscillator frequency, then spectrum inversion does not occur.


   Name (terse, verbose): 4, LO_VALUE
   Range (min, max):      0, 0 (no range)
   Supported Boards:      PC72xx, NTC7044, DTMA2910
   Valid Arguments:       Any number within given range
   Description:           Allows manual entry of the LNB Local Oscillator frequency provided that either C: Manual or
                          Ku: Manual is selected from the Local Oscillator pulldown menu.


   Name (terse, verbose): 17, SAT_RF_GAIN
   Range (min, max):      0, 7
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           0,0
                          1           0,4.2
                          2           0,8.4
                          3           0,12.6
                          4           4,0
                          5           4,4.2
                          6           4,8.4
                          7           4,12.6
   Description:           Controls the pre-filter amplification for stage 1 and stage 2. The verbose arguments to this command
                          take gain in dB of the form <stage_1>,<stage_2>.  The default is 0,0 meaning both stage 1 and 2 are 0dB

   Name (terse, verbose): 18, SAT_BB_GAIN
   Range (min, max):      0, 3
   Supported Boards:      NTC7044
   Valid Arguments:       Terse:      Verbose:
                          0           0
                          1           4.2
                          2           8.4
                          3           12.6
   Description:           Controls the post-filter baseband digital gain in dB. The default is 4.2.

   Name (terse, verbose): 19, ISI_CTRL
   Supported Boards:      NTC7044/OD6000
   Valid Arguments:       Terse:      Verbose:
                          0           DISABLED/SINGLESTREAM
                          1           ENABLED/MULTISTREAM
                          2           NA/SINGLESTREAM (NO RESTART)
   Description:           Controls ISI (input stream selection).

   Name (terse, verbose): 20, ISI
   Supported Boards:      NTC7044, DTMA2910
   Range (min, max):      00, 255
   Description:           Gets/Sets the ISI value (input stream identifier).
                          Note: This entry must be at least two characters.  Values less than ten (10)
                          must have a leading zero, e.g.,  01, 02, 03, ...

   Name (terse, verbose): 21, TS_DEMOD_CTRL
   Supported Boards:      DTMA2910
   Valid Arguments:       Terse:      Verbose:
                          0           DISABLED
                          1           ENABLED
   Description:           Controls transport stream output.

   Name (terse, verbose): 22, S2X_ROLLOFF
   Supported Boards:      DTMA2910
   Valid Arguments:       Terse:      Verbose:
                          0           DISABLED
                          1           ENABLED
   Description:           S2X Rolloff will allow the tuner to operate in an optimized mode for roll-offs of 15% or less.
                          When disabled, it will operate in standard 20% - 35% as defined by the incoming S2 BBHeader.
                          Due to modulation manufacturers providing backwards compatibility during S2 to S2X migration,
                          this must be manually configured for the best 5%, 10% and 15% roll-off performance.

   Name (terse, verbose): 23, DEMODCFG_PLS_CODE
   Supported Boards:      DTMA2910
   Valid Arguments:       Terse:      Verbose:
                          0           DEFAULT
                          1           CODE1
                          2           CODE2
   Description:           DEMODCFG_PLS_CODE configures Physical Layer Scrambling

Response:

 SATFEED RESPONSE
   Verbose- "OK\r\n" to acknowledge receipt of command, or
            "ERROR- [Description]\r\n" if error, ending command
   Terse-   "0\r\n" to acknowledge receipt of command, or
            "[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
   "\r\n" concludes modify responses (empty line)

Examples:


Command to view all fields for all feeds (Adtec tuner):
*.SYSD SAF
OK
Tuner[0]:
ACTIVE= YES
TYPE= DVB-S2
SAT_LBAND= 1080
LO= C_5150
LO_VALUE= 5150
DOWNLINK= 4070
SAT_SYMRATE= 5
SAT_ACQRANGE= 8
MOD= QPSK_3/4
PILOT= OFF
ROLLOFF= 20
Tuner[1]:
ACTIVE= YES
TYPE= DVB-S2
SAT_LBAND= 1080
LO= C_5150
LO_VALUE= 5150
DOWNLINK= 4070
SAT_SYMRATE= 30
SAT_ACQRANGE= 1
MOD= 8PSK_5/6
PILOT= OFF
ROLLOFF= 35



Command to set feed 0 active to no:
*.SYSD SAF 0 ACTIVE NO
OK


Command to set feed 0 active to no (terse):
*.SYSD SF 0 0 0
0


Command to get feed 0 mod:
*.SYSD SAF 0 MOD
OK
Tuner[0]:
MOD= 8PSK_5/6


Command to save feed 0 (does not persist to non-volatile memory!):
*.SYSD SAF 0 SAVE

To persist SAF settings to non-volatile memory commit them via sysd's config save command:
*.SYSD CF SAVE

Command to load feed 0 (will read from volatile memory):
*.SYSD SAF 0 LOAD


Command to load feed 1 with config saved at 0:
*.SYSD SAF 1 LOAD 0

Notes:

Output of this command depends on which board (NTC7044 (NEWTEC), or PC72xx (ADTEC))
is installed.  Refer to the form section for lists of fields and values for each
board.

Also note that it is possible for some values to return N/A when they are not
applicable.  For example, PILOT is only available in DVB-S2 so it will show N/A
whenever TYPE=DVB-S.  PILOT, FRAMETYPE, and MOD will also show N/A if CCM=AUTO-CCM.
SAT_RF_GAIN and SAT_BB_GAIN will always show N/A if the tuner's software version
is < 1.19 (see SUP command to view this value).
S2X_ROLLOFF will always show N/A if the tuner's software version is < 1.12.

The SAF 1 command doesn't function when a NTC board is in use.(See SUP command to
view what board is in use).

Created By: Adtec Digital