# R&S SFM TV test transmitter

class pymeasure.instruments.rohdeschwarz.sfm.SFM(adapter, name='Rohde&Schwarz SFM', **kwargs)

  Bases: `SCPIMixin`, `Instrument`

  Represents the Rohde&Schwarz SFM TV test transmitter interface for interacting with the instrument.

  Note

  The current implementation only works with the first system in this unit.

  Further source extension for system 2-6 would be required.

  The intermodulation subsystem is also not yet implemented.

  property R75_out

    A bool property that controls the use of the 75R output (if installed)

    Value | Meaning
    --- | ---
    False | 50R output active (N)
    True | 75R output active (BNC)

    refer also to chapter 3.6.5 of the manual

  property TV_country

    A string property that controls the country specifics of the video/sound system to be used

    Possible values are:

    Value | Meaning
    --- | ---
    BG_G | BG General
    DK_G | DK General
    I_G | I General
    L_G | L General
    GERM | Germany
    BELG | Belgium
    NETH | Netherlands
    FIN | Finland
    AUST | Australia
    BG_T | BG Th
    DENM | Denmark
    NORW | Norway
    SWED | Sweden
    GUS | Russia
    POL1 | Poland
    POL2 | Poland
    HUNG | Hungary
    CHEC | Czech Republic
    CHINA1 | China
    CHINA2 | China
    GRE | Great Britain
    SAFR | South Africa
    FRAN | France
    USA | United States
    KOR | Korea
    JAP | Japan
    CAN | Canada
    SAM | South America

    Please confirm with the manual about the details for these settings.

  property TV_standard

    A string property that controls the type of video standard

    Possible values are:

    Value | Lines | System
    --- | --- | ---
    BG | 625 | PAL
    DK | 625 | SECAM
    I | 625 | PAL
    K1 | 625 | SECAM
    L | 625 | SECAM
    M | 525 | NTSC
    N | 625 | NTSC

    Please confirm with the manual about the details for these settings.

  property basic_info

    A String property containing information about the hardware modules installed in the unit

  property beeper_enabled

    A bool property that controls the beeper status,

    refer also to chapter 3.6.8 of the manual

  calibration(number=1, subsystem=None)

    Function to either calibrate the whole modulator, when subsystem parameter is omitted, or calibrate a subsystem of the modulator.

    Valid subsystem selections: “NICam, VISion, SOUNd1, SOUNd2, CODer”

  channel_down_relative()

    Decreases the output frequency to the next low channel/special channel based on the current country settings

  property channel_sweep_start

    A float property controlling the start frequency for channel sweep in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property channel_sweep_step

    A float property controlling the start frequency for channel sweep in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property channel_sweep_stop

    A float property controlling the start frequency for channel sweep in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property channel_table

    A string property controlling which channel table is used

    Possible selections are:

    Value | Meaning
    --- | ---
    DEF | Default channel table
    USR1 | User table No. 1
    USR2 | User table No. 2
    USR3 | User table No. 3
    USR4 | User table No. 4
    USR5 | User table No. 5

    refer also to chapter 3.6.6.1 of the manual

  channel_up_relative()

    Increases the output frequency to the next higher channel/special channel based on the current country settings

  coder_adjust()

    Starts the automatic setting of the differential deviation

    refer also to chapter 3.6.6.4 of the manual

  property coder_id_frequency

    A int property that controls the frequency of the identification of the coder

    valid range 0 .. 200 Hz

  property coder_modulation_degree

    A float property that controls the modulation degree of the identification of the coder

    valid range: 0 .. 0.9

  property coder_pilot_deviation

    A int property that controls deviation of the pilot frequency of the coder

    valid range: 1 .. 4 kHz

  property coder_pilot_frequency

    A int property that controls the pilot frequency of the coder

    valid range: 40 .. 60 kHz

  property cw_frequency

    A float property controlling the CW-frequency in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property date

    A list property for the date of the RTC in the unit

  property event_reg

    Content of the event register of the Status Operation Register refer also to chapter 3.6.7 of the manual

  property ext_ref_base_unit

    A bool property for the external reference for the basic unit

    Value | Meaning
    --- | ---
    False | Internal 10 MHz is used
    True | External 10 MHz is used

  property ext_ref_extension

    A bool property for the external reference for the extension frame

    Value | Meaning
    --- | ---
    False | Internal 10 MHz is used
    True | External 10 MHz is used

  property ext_vid_connector

    A string property controlling which connector is used as the input of the video source

    Possible selections are:

    Value | Meaning
    --- | ---
    HIGH | Front connector - Hi-Z
    LOW | Front connector - 75R
    REAR1 | Rear connector 1
    REAR2 | Rear connector 2
    AUTO | Automatic assignment

  property external_modulation_frequency

    A int property that controls the setting for the external modulator frequency

    valid range: 32 .. 46 MHz

  property external_modulation_power

    A int property that controls the setting for the external modulator output power

    valid range: -7..0 dBm

    refer also to chapter 3.6.6.5 of the manual

  property external_modulation_source

    A bool property for the modulation source selection

    refer also to chapter 3.6.6.8 of the manual

  property frequency

    A float property controlling the frequency in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property frequency_mode

    A string property controlling which the unit is used in

    Possible selections are:

    Value | Meaning
    --- | ---
    CW | Continuous wave mode
    FIXED | fixed frequency mode
    CHSW | Channel sweep
    RFSW | Frequency sweep

    Note

    selecting the sweep mode, will start the sweep imemdiately!

  property gpib_address

    A int property that controls the GPIB address of the unit

    valid range: 0..30

  property high_frequency_resolution

    A property that controls the frequency resolution,

    Possible selections are:

    Value | Meaning
    --- | ---
    False | Low resolution (1000Hz)
    True | High resolution (1Hz)

  property level

    A float property controlling the output level in dBm,

    - Minimum -99dBm

    - Maximum 10dBm (depending on output mode)

    refer also to chapter 3.6.6.2 of the manual

  property level_mode

    A string property controlling the output attenuator and linearity mode

    Possible selections are:

    Value | Meaning | max. output level
    --- | --- | ---
    NORM | Normal mode | +6 dBm
    LOWN | low noise mode | +10 dBm
    CONT | continuous mode | +10 dBm
    LOWD | low distortion mode | +0 dBm

    Contiuous mode allows up to 14 dB of level setting without use of the mechanical attenuator.

  property lower_sideband_enabled

    A bool property that controls the use of the lower sideband

    refer also to chapter 3.6.6.10 of the manual

  property modulation_enabled

    A bool property that controls the modulation status

  property nicam_IQ_inverted

    A bool property that controls if the NICAM IQ signals are inverted or not

    Value | Meaning
    --- | ---
    False | normal (IQ)
    True | inverted (QI)

  property nicam_additional_bits

    A int property that controls the additional data in the NICAM modulator

    valid range: 0 .. 2047

  property nicam_audio_frequency

    A int property that controls the frequency of the internal sound generator

    valid range: 0 Hz .. 15 kHz

  property nicam_audio_volume

    A float property that controls the audio volume in the NICAM modulator in dB

    valid range: 0..60 dB

  property nicam_bit_error_enabled

    A bool property that controls the status of an artificial bit error rate to be applied

  property nicam_bit_error_rate

    A float property that controls the artificial bit error rate.

    valid range: 1.2E-7 .. 2E-3

  property nicam_carrier_enabled

    A bool property that controls if the NICAM carrier is switched on or off

  property nicam_carrier_frequency

    A float property that controls the frequency of the NICAM carrier

    valid range: 33.05 MHz +/- 0.2 Mhz

  property nicam_carrier_level

    A float property that controls the value of the NICAM carrier

    valid range: -40 .. -13 dB

  property nicam_control_bits

    A int property that controls the additional data in the NICAM modulator

    valid range: 0 .. 3

  property nicam_data

    A int property that controls the data in the NICAM modulator

    valid range: 0 .. 2047

  property nicam_intercarrier_frequency

    A float property that controls the inter-carrier frequency of the NICAM carrier

    valid range: 5 .. 9 MHz

  property nicam_mode

    A string property that controls the signal type to be sent via NICAM

    Possible values are:

    Value | Meaning
    --- | ---
    MON | Mono sound + NICAM data
    STER | Stereo sound
    DUAL | Dual channel sound
    DATA | NICAM data only

    refer also to chapter 3.6.6.6 of the manual

  property nicam_preemphasis_enabled

    A bool property that controls the status of the J17 preemphasis

  property nicam_source

    A string property that controls the signal source for NICAM

    Possible values are:

    Value | Meaning
    --- | ---
    INT | Internal audio generator(s)
    EXT | External audio source
    CW | Continuous wave signal
    RAND | Random data stream
    TEST | Test signal

  property nicam_test_signal

    A int property that controls the selection of the test signal applied

    Value | Meaning
    --- | ---
    1 | Test signal 1 (91 kHz square wave, I&Q 90deg apart)
    2 | Test signal 2 (45.5 kHz square wave, I&Q 90deg apart)
    3 | Test signal 3 (182 kHz sine wave, I&Q in phase)

  property normal_channel

    A int property controlling the current selected regular/normal channel number valid selections are based on the country settings.

  property operation_enable_reg

    Content of the enable register of the Status Operation Register

    Valid range: 0…32767

  property output_voltage

    A float property controlling the output level in Volt,

    Minimum 2.50891e-6, Maximum 0.707068 (depending on output mode) refer also to chapter 3.6.6.12 of the manual

  property questionable_event_reg

    Content of the event register of the Status Questionable Operation Register

  property questionable_operation_enable_reg

    Content of the enable register of the Status Questionable Operation Register

    Valid range 0…32767

  property questionanble_status_reg

    Content of the condition register of the Status Questionable Operation Register

  property remote_interfaces

    A string property controlling the selection of interfaces for remote control

    Possible selections are:

    Value | Meaning
    --- | ---
    OFF | no remote control
    GPIB | GPIB only enabled
    SER | RS232 only enabled
    BOTH | GPIB & RS232 enabled

  property rf_out_enabled

    A bool property that controls the status of the RF-output

  property rf_sweep_center

    A float property controlling the center frequency for sweep in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property rf_sweep_span

    A float property controlling the sweep span in Hz,

    - Minimum 1 kHz

    - Maximum 1 GHz

  property rf_sweep_start

    A float property controlling the start frequency for sweep in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property rf_sweep_step

    A float property controlling the stepwidth for sweep in Hz,

    - Minimum 1 kHz

    - Maximum 1 GHz

  property rf_sweep_stop

    A float property controlling the stop frequency for sweep in Hz

    - Minimum 5 MHz

    - Maximum 1 GHz

  property scale_volt

    A string property that controls the unit to be used for voltage entries on the unit

    Possible values are: AV,FV, PV, NV, UV, MV, V, KV, MAV, GV, TV, PEV, EV, DBAV, DBFV, DBPV, DBNV, DBUV, DBMV, DBV, DBKV, DBMAv, DBGV, DBTV, DBPEv, DBEV

    refer also to chapter 3.6.9 of the manual

  property serial_baud

    A int property that controls the serial communication speed ,

    Possible values are: 110,300,600,1200,4800,9600,19200

  property serial_bits

    A int property that controls the number of bits used in serial communication

    Possible values are: 7 or 8

  property serial_flowcontrol

    A string property that controls the serial handshake type used in serial communication

    Possible values are:

    Value | Meaning
    --- | ---
    NONE | no flow-control/handshake
    XON | XON/XOFF flow-control
    ACK | hardware handshake with RTS&CTS

  property serial_parity

    A string property that controls the parity type used for serial communication

    Possible values are:

    Value | Meaning
    --- | ---
    NONE | no parity
    EVEN | even parity
    ODD | odd parity
    ONE | parity bit fixed to 1
    ZERO | parity bit fixed to 0

  property serial_stopbits

    A int property that controls the number of stop-bits used in serial communication,

    Possible values are: 1 or 2

  property sound_mode

    A string property that controls the type of audio signal

    Possible values are:

    Value | Meaning
    --- | ---
    MONO | MOnoaural sound
    PIL | pilot-carrier + mono
    BTSC | BTSC + mono
    STER | Stereo sound
    DUAL | Dual channel sound
    NIC | NICAM + Mono

  property special_channel

    A int property controlling the current selected special channel number valid selections are based on the country settings.

  property status_info_shown

    A bool property that controls if the display shows information during remote control

  status_preset()

    partly resets the SCPI status reporting structures

  property status_reg

    Content of the condition register of the Status Operation Register

  property subsystem_info

    A String property containing information about the system configuration

  property system_number

    A int property for the selected systems (if more than 1 available)

    - Minimum 1

    - Maximum 6

  property time

    A list property for the time of the RTC in the unit

  property vision_average_enabled

    A bool property that controls the average mode for the vision system

  property vision_balance

    A float property that controls the balance of the vision modulator

    valid range: -0.5 .. 0.5

  property vision_carrier_enabled

    A bool property that controls the vision carrier status

    refer also to chapter 3.6.6.9 of the manual

  property vision_carrier_frequency

    A float property that controls the frequency of the vision carrier

    valid range: 32 .. 46 MHz

  property vision_clamping_average

    A float property that controls the operation point of the vision modulator

    valid range: -0.5 .. 0.5

  property vision_clamping_enabled

    A bool property that controls the clamping behavior of the vision modulator

  property vision_clamping_mode

    A string property that controls the clamping mode of the vision modulator

    Possible selections are HARD or SOFT

  property vision_precorrection_enabled

    A bool property that controls the precorrection behavior of the vision modulator

  property vision_residual_carrier_level

    A float property that controls the value of the residual carrier

    valid range: 0 .. 0.3 (30%)

  property vision_sideband_filter_enabled

    A bool property that controls the use of the VSBF (vestigal sideband filter) in the vision modulator

  property vision_videosignal_enabled

    A bool property that controls if the video signal is switched on or off

class pymeasure.instruments.rohdeschwarz.sfm.Sound_Channel(instrument, number)

  Bases: `object`

  Class object for the two sound channels

  refer also to chapter 3.6.6.7 of the user manual

  property carrier_enabled

    A bool property that controls if the audio carrier is switched on or off

  property carrier_frequency

    A float property that controls the frequency of the sound carrier

    valid range: 32 .. 46 MHz

  property carrier_level

    A float property that controls the level of the audio carrier in dB relative to the vision carrier (0dB)

    valid range: -34 .. -6 dB

  property deviation

    A int property that controls deviation of the selected audio signal

    valid range: 0 .. 110 kHz

  property frequency

    A int property that controls the frequency of the internal sound generator

    valid range: 300 Hz .. 15 kHz

  property modulation_degree

    A float property that controls the modulation depth for the audio signal (Note: only for the use of AM in Standard L)

    valid range: 0 .. 1 (100%)

  property modulation_enabled

    A bool property that controls the audio modulation status

    Value | Meaning
    --- | ---
    False | modulation disabled
    True | modulation enabled

  property preemphasis_enabled

    A bool property that controls if the preemphasis for the audio is switched on or off

  property preemphasis_time

    A int property that controls if the mode of the preemphasis for the audio signal

    Value | Meaning
    --- | ---
    50 | 50 us preemphasis
    75 | 75 us preemphasis

  property use_external_source

    A bool property for the audio source selection

    Value | Meaning
    --- | ---
    False | Internal audio generator(s)
    True | External signal source

  values(command, **kwargs)

    Reads a set of values from the instrument through the adapter, passing on any keyword arguments.