Summary of Contents for Rohde & Schwarz 1157.3458.02
Page 1
Test and Measurement Division Operating Manual Remote Control for R&S FSH R&S FSH-K1 1157.3458.02 R&S FSH – Firmware Version 11.0 1157.3564.12-08-...
Page 2
Dear Customer, R&S® is a registered trademark of Rohde & Schwarz GmbH & Co. KG. Trade names are trademarks of the owners. 1157.3564.12-08-...
R&S FSH-K1 Table of Contents Contents Enabling Remote Control Option R&S FSH-K1................1 Connecting PCs...........................2 Installation of the driver for the USB optical cable (R&S FSH-Z37) ..........2 Serial Port Configuration .......................2 Notational Conventions ........................3 Starting Remote Control Operation ....................3 Device Messages..........................4 Acknowledge Response <ack>...
Page 5
R&S FSH-K1 Table of Contents 1157.3564.12...
R&S FSH-K1 Enabling Remote Control Option R&S FSH-K1 Enabling Remote Control Option R&S FSH-K1 The R&S FSH spectrum analyzer can be fitted with the Remote Control Option R&S FSH-K1, which is enabled by entering a key code. The key code is based on the unique serial number of the instrument. To retrofit an option, enable it with a key code.
Connecting PCs R&S FSH-K1 Connecting PCs The R&S FSH can be remote controlled by a PC or Laptop equipped with an USB interface or a RS232 interface. RS232 optical interface The RS232 optical interface is used for connecting a PC or Laptop. The interface connector is located at the right-hand side of the R&S FSH, it can be accessed by folding out the support.
R&S FSH-K1 Notational Conventions Notational Conventions The following section describes the notational conventions as they are used throughout this document. Meta Symbol Specification Equals Separator for selectable items “...” Characters between “ “ are taken as they are, but the “ “ are excluded (example “,”...
Device Messages R&S FSH-K1 Device Messages The remote control command set of the R&S FSH can be grouped into three categories: • SET commands commands used program parameters instrument like center frequency, span, etc. • GET commands GET commands are used to query current settings and data from the instrument like center frequency, marker, trace data, etc.
R&S FSH-K1 Device Messages Functional Description of Commands The command strings and parameter strings are not case sensitive, eg ‘Freq’ is similar to ‘FREQ’. GET Command GET commands are used to query parameter settings or measured data from the instrument. Program syntax: get<cr>...
Page 12
Device Messages R&S FSH-K1 CMD Command CMD commands are used to initiate an action or a state transition on the instrument. Program syntax: cmd<cr> Response syntax: <ack><cr> Program syntax: <parameter>,<value><cr> <parameter> := <string> This is one of the commands defined in the following section <value>:= This field depends on the type of parameter, see the specific value descriptions...
R&S FSH-K1 Parameter Overview Parameter Overview In the following tables all parameters and commands are listed with the different measurement modes they are active in. Note: Parameters are not always available, this depends on the type of measurement selected and other settings. Get / Set Parameter Parameter ACCESSORY...
R&S FSH-K1 Parameter Overview CMD Commands Parameter CAL_DTF CAL_TGSCLRFL CAL_TGSCLTRN CAL_TGVECRFL CAL_TGVECTRN INIT LOCAL LVLADJUST MARKNXTPK MARKPK MARKMIN MARKTOCENT LIMDEL MARKTOLVL PRESET PWRTOREF RECALL REMOTE RESTART SAVE THROFF TRACETOMEM WAIT ZERO Note: When the instrument is in the state standby (Off) only the parameters IDN?, BAUD and MEAS are available.
Command Description R&S FSH-K1 Command Description General Commands Command Parameters Unit Comment IDN? GET command only BAUD 0...4 SET command only REMOTE LOCAL PRESET INIT WAIT STB? GET command only EXTINPUT 0, 1 SAVE <string> RECALL <string> EXTREF 0…3 GET command only DISPLAY 0...1 TEMP...
Page 19
R&S FSH-K1 Command Description BAUD (Serial baud rate) This command sets the serial interface baud rate. The default baud rate is 19.200 Baud. Value Baud rate 19.200 38.400 57.600 115.200 9.600 Example: set<cr> 0<cr> ‘set baud rate on 115.200 baud,3<cr> ‘responds ok with current baud rate 0<cr>...
Page 20
Command Description R&S FSH-K1 WAIT This command is used to synchronize with the end of a sweep. After sending the WAIT command the <ack> acknowledge is holdoff until the sweep is complete. Example: cmd<cr> 0<cr> ‘wait for end of sweep wait<cr>...
Page 21
R&S FSH-K1 Command Description EXTREF (External Reference status) This command returns the external reference status. Value Status external reference Disabled Out of range Catching Locked Example: get<cr> 0<cr> ‘get status of external reference extref<cr> ‘responds parameter ok 0<cr> ‘response status out of range 1<cr>...
Command Description R&S FSH-K1 Frequency and Span Settings Command Parameters Unit Comment FREQ <numeric value> FREQOFFS <numeric value> SPAN <numeric value> AUTOSPAN 0, 1 CHANNEL <numeric value> CHTABLE <string> FREQ (Frequency) This command sets the center frequency. The start and stop frequency of the instrument is defined by the current center frequency and span. Example: set<cr>...
Page 23
R&S FSH-K1 Command Description AUTOSPAN This command switches span mode AUTO on/off (Measure Mode: Channel Power or Occupied BW) Value Span Mode Auto Off Auto On Example: set<cr> 0<cr> ‘set Auto span On autospan,1<cr> ‘responds parameter ok 0<cr> CHANNEL (Channel Number) This command defines the channel number.
Command Description R&S FSH-K1 Amplitude Settings Command Parameters Unit Comment REFLVL <numeric value> Uses current unit REFLVLOFFS <numeric value> RANGE 0...20 DYNRANGE 0, 1 UNIT 0...8 RFINPUT 0, 1 PREAMP 0, 1 REFLVL (Reference Level) This command sets the reference level using the current unit. Example: set<cr>...
R&S FSH-K1 Command Description Bandwidth Settings Command Parameters Unit Comment AUTORBW 0, 1 0...10 AUTOVBW 0, 1 0...12 AUTOCISPRBW 0, 1 Receiver Mode only (R&S FSH-K3) CISPRBW 0…3 Receiver Mode only (R&S FSH-K3) AUTORBW (Auto Resolution Bandwidth ) This command switches the auto coupling of the resolution bandwidth on/off. If AUTORBW is active the current setting of the resolution bandwidth can be queried with the GET RBW command.
Page 28
Command Description R&S FSH-K1 AUTOVBW (Auto Video Bandwidth ) This command switches the auto coupling of the video bandwidth on/off. If AUTOVBW is active the current setting of the video bandwidth can be queried with the GET VBW command. Value Auto Video Bandwidth Example: set<cr>...
Page 29
R&S FSH-K1 Command Description AUTOCISPRBW (Auto CISPR Bandwidth ) This command switches the auto setting of the CISPR bandwidth on/off. If AUTOCISPRBW is active the current setting of the CISPR bandwidth can be queried with the GET CISPRBW command. This command is available in Receiver Mode only (R&S FSH-K3).
Command Description R&S FSH-K1 Sweep Settings Command Parameters Unit Comment AUTOSWPTIME 0, 1 SWPTIME <numeric value> Value 0: Auto SWPCONT 0, 1 TRIGSRC 0...3 TRIGLVL <numeric value> TRIGDEL <numeric value> AUTOSWPTIME (Auto Sweep Time ) This command switches the auto coupling of the sweep time on/off. If AUTOSWPTIME is active the current setting of the sweep time can be queried with the GET SWPTIME command.
Page 31
R&S FSH-K1 Command Description TRIGSRC (Trigger Source) This command selects the trigger source. Value Trigger Source Free run Video External - Rise External - Fall Example: set<cr> 0<cr> ‘set to video trigger trigsrc,1<cr> ‘responds parameter ok 0<cr> TRIGLVL (Trigger Level) This command defines the video trigger level (0…100%).
Command Description R&S FSH-K1 Trace Settings Command Parameters Unit Comment TRACEMODE 0..4 WRAPPHASE TRACEDET 0...6 TRACEAVG 2…999 TRACE <numeric value>,..GET command only TRACEBIN <value>,... GET command only TRACETOMEM CMD command only CCORRTRACE <numeric value>,..GET command only CCORRTRACEBIN <value>,... GET command only CTRACE <numeric value>,..
Page 33
R&S FSH-K1 Command Description TRACEDET (Trace Detector) This command defines the detector used. The Average and Quasi-Peak detector are available in Receiver Mode (R&S FSH-K3) only. Value Detector Auto Peak Min Peak Max Peak / Peak Sample Average Quasi-Peak Example: set<cr>...
Page 34
Command Description R&S FSH-K1 TRACEBIN (Trace Data Binary) This command reads out the trace data in binary format. Each sample consists of 4 bytes with the LSB send first. The 4 bytes represent the measured power in the current unit. The sample values are multiplied to provide the highest resolution possible. Value Binary values dBm * 1000...
Page 35
R&S FSH-K1 Command Description CCORRTRACE (Complex Corrected Trace Data) This command reads out the corrected magnitude and phase values (if applicable) in alphanumeric format. The magnitude unit is dB, the phase unit is radiants. Dependent on the wrap mode the wrapped or unwrapped phase values are provided.
Page 36
Command Description R&S FSH-K1 CTRACE (Complex Trace Data) This command reads out the raw (= uncorrected) magnitude and phase values in alphanumeric format. The magnitude unit is dBm, the phase unit is radiants. A complex trace consists of 301 magnitude and 301 phase values.
Page 37
R&S FSH-K1 Command Description MTRACE (Trace Data from saved Data Set) This command reads out the trace data in alphanumeric format from a previously saved data set. The current unit is used for the values. A trace consists of 301 data values. If the Auto Peak detector is used, both max and min values are returned (602 values: 301 min values then 301 max values).
Page 39
R&S FSH-K1 Command Description MARK1 (Marker) This command sets the marker to the specified position or queries the current marker value. The marker unit depends on the unit of the x-axis which can be Hz, seconds or meter/feet depending of the measurement mode.
Page 40
Command Description R&S FSH-K1 Example: set<cr> 0<cr> ‘set multi marker 2 to 100 MHz mark,2,100E6<cr> ‘responds parameter ok 0<cr> Example 2: get<cr> 0<cr> ‘query multi marker 2 value mark,2<cr> ‘responds parameter ok 0<cr> ‘returns Marker frequency and level 947.25e6,-79.28<cr> DELTA1ON (Deltamarker On) This command turns the marker on / off.
Page 41
R&S FSH-K1 Command Description DELTAON (Delta Multimarker On) This command turns the corresponding deltamarker on / off. DELTAON,1 is used for the deltamarker in normal and in multi marker mode. DELTAON,2 to DELTAON,6 are available in multi marker mode only Param 1 Param 2 Value...
Page 42
Command Description R&S FSH-K1 DELTAALLON (All Deltamarker On) This command turns all deltamarker on / off. This command is available in multi marker mode only. Value All Deltamarker Example: set<cr> 0<cr> ‘turns all deltamarker on deltaallon,1<cr> ‘responds parameter ok 0<cr> MARKALL? (Multimarker) This command queries the current list of multimarkers.
Page 43
R&S FSH-K1 Command Description MARKPK (Marker Peak) This command sets the current or corresponding marker to the peak (highest signal). Optional Value Marker 1…6 Marker 1…6 Example: cmd<cr> 0<cr> ‘set marker to peak markpk<cr> ‘responds parameter ok 0<cr> Example 2: cmd<cr>...
Page 44
Command Description R&S FSH-K1 MARKTOLVL (Marker Level To Reference Level) This command sets the current or corresponding marker level as reference level. Optional Value Marker 1…6 Marker 1…6 Example: cmd<cr> 0<cr> ‘set marker level to reference level marktolvl<cr> ‘responds parameter ok 0<cr>...
Page 45
R&S FSH-K1 Command Description MARKVOL (Marker Demodulation Volume) This command sets the volume of the demodulation AF output.The range is 1 to 100% in 1% steps. Example: set<cr> 0<cr> ‘set volume of AF output to 50% markvol,50<cr> ‘responds parameter ok 0<cr>...
Command Description R&S FSH-K1 Measurement Command Parameters Unit Comment MEAS 0…11 TRD1 <string> Not in Isotropic Antenna mode TRD1X <string> Isotropic Antenna mode only TRD1Y <string> Isotropic Antenna mode only TRD1Z <string> Isotropic Antenna mode only TRD2 <string> ACCESSORY <numeric value> LIMDEF <name>,<descripti on>,<x-unit>,<x-...
Page 47
R&S FSH-K1 Command Description MEAS (Measurement Mode) This command defines the measurement mode. Value Measurement Analyzer Tracking Generator (Model 13, 23 and 26) Power Sensor Channel Power Occupied Bandwidth TDMA Power Distance to Fault (R&S FSH-B1) Receiver Mode (R&S FSH-K3) Carrier / Noise Isotropic Antenna WCDMA BTS CDP...
Page 48
Command Description R&S FSH-K1 TRD1Y (Transducer Y – dBµV/m) This command selects a Y-direction transducer (dBµV/m only) for the Isotropic Antenna measurement. To turn a transducer off, use the string ‘NONE’: Example: set<cr> 0<cr> ‘selects transducer table “TS-EMF-Y” trd1y,ts-emf-y<cr> ‘responds parameter ok 0<cr>...
Page 49
R&S FSH-K1 Command Description LIMDEF (Define Limit Line) This command defines a limit line.The list of parameters are the following: <name>,<description>,<x-unit>,<x-scale>,<y-unit>,<x0>,<y0>[,...<xn>,<yn>] The parameter <name> and <description> are strings. The parameters x-unit and y-unit are listed in the tables below: Parameter x-unit: Value Unit Seconds...
Page 50
Command Description R&S FSH-K1 LIMDEL (Delete Limit Line) This command deletes a limit line. Example: cmd<cr> 0<cr> ‘deletes limit line “LIMIT” limdel,LIMIT<cr> ‘responds parameter ok 0<cr> LIMLIST (Available Limit Line List) This command returns the list with available limit lines Example: get<cr>...
Page 51
R&S FSH-K1 Command Description LIMCHKREMOTE (Limit Check Remote Message) This command enables the remote message (frequency/channel + level) on limit check and/or on threshold limit fail. The instrument will send a message (frequency/channel and level) every time the limit is exceeded. Value Limit Check Remote Limit Check –...
Command Description R&S FSH-K1 Tracking Generator This command set applies to model 13, model 23 and model 26 only. Command Parameters Unit Comment CAL_TGSCLRFL CMD command only CAL_TGSCLTRN CMD command only CAL_TGVECRFL CMD command only CAL_TGVECTRN CMD command only TRANSCAL GET command only REFLCAL GET command only...
Page 53
R&S FSH-K1 Command Description CAL_TGVECRFL (Calibrate Tracking Generator Vector Reflection) This command initiates a vector reflection calibration. This calibration contains three phases; OPEN phase, SHORT phase and a LOAD phase. Connect OPEN before initiating calibration command, after first phase reports ready connect SHORT and continue by issuing the command again. When OPEN calibration reports ready connect LOAD and resume calibration by issuing the command again.
Page 54
Command Description R&S FSH-K1 REFLCAL (Reflection Calibrated) This command queries the state of the reflection calibration. Value Reflection Cal Not calibrated Calibrated Example: get<cr> 0<cr> ‘query state of reflection calibration reflcal<cr> ‘responds parameter ok 0<cr> ‘response: reflection calibrated 1<cr> TRANSVECTCAL (Transmission Vector Calibrated) This command queries the state of the transmission vector calibration.
Page 55
R&S FSH-K1 Command Description TGLVL (Tracking Generator Level) This command defines the tracking generator output level. Applies to model 23 only. The only two numeric values which are valid are 0 and –20. Example: set<cr> 0<cr> ‘sets tracking generator output level to –20 dBm tglvl,-20<cr>...
Command Description R&S FSH-K1 Power Sensor Command Parameters Unit Comment <numeric value> GET command only REFL <numeric value> GET command only ZERO CMD command only PWRTOREF CMD command only MEASTIME 0...2 REFLUNIT 0, 1 R&S FSH-Z44 only PWRSSTD 0…7 R&S FSH-Z44 only PWR (Power Level) This command queries the power level measured by the sensor.
Page 57
R&S FSH-K1 Command Description MEASTIME (Measurement Time) This command defines the measurement time for the power sensor (R&S FSH-Z1 and R&S FSH-Z18). Value Measurement Time Short Normal Long Example: set<cr> 0<cr> ‘sets measurement time to “long” meastime,2<cr> ‘responds parameter ok 0<cr>...
Command Description R&S FSH-K1 Channel Power Command Parameters Unit Comment CHPWR <numeric value> GET command only CHPWRSTD 0…3 CHPWRCSTD <string> CHPWRUNIT 0…2 CHPWRBW <numeric value> LVLADJUST CMD command only CHPWR (Channel Power) This command queries the measured channel power. Example: get<cr>...
Page 59
R&S FSH-K1 Command Description CHPWRUNIT (Channel Power Unit) This command defines the unit used for the channel power measurement. Value Channel Power Unit dBmV dB\V Example: set<cr> 0<cr> ‘set unit to dBmV chpwrunit,1<cr> ‘responds parameter ok 0<cr> CHPWRBW (Channel Power Bandwidth) This command defines the bandwidth used for channel power measurements.
Command Description R&S FSH-K1 TDMA Power Command Parameters Unit Comment TDMAPWR <numeric value> GET command only TDMASTD 0…1 MEASTIME <numeric value> LVLADJUST CMD command only TDMAPWR (TDMA Power) This command queries the measured TDMA power. Example: get<cr> 0<cr> ‘query power level from sensor tdmapwr<cr>...
Page 63
R&S FSH-K1 Command Description MEASTIME (Measurement Time) This command defines the measurement time for the TDMA power measurement. Example: set<cr> 0<cr> ‘sets measurement time to 500 \s meastime,500E-6<cr> ‘responds parameter ok 0<cr> LVLADJUST (Level Adjust) This command initiates a level adjustment for the TDMA power measurement. Example: cmd<cr>...
Command Description R&S FSH-K1 Distance To Fault Measurement The DTF Measurement requires the option R&S FSH-B1. Command Parameters Unit Comment CABLEMOD <string> CABLELEN <numeric value> m / feet CAL_DTF DTFMODE 0...2 LENUNIT <meter> | <feet> CABLEMOD (Cable Model) This command selects the cable model. To turn cable model selection off, use the string ‘NONE’.
Page 65
R&S FSH-K1 Command Description DTFMODE (DTF Measurement Mode) Power) This command defines the measurement mode in DTF. Value Channel Power Standard Reflection Spectrum Example: set<cr> 0<cr> ‘set DTF mode to “Spectrum” dtfmode,2<cr> ‘responds parameter ok 0<cr> LENUNIT (Cable Length Unit) This command sets the cable length unit to meters or feet.
Command Description R&S FSH-K1 Receiver Mode The Receiver Mode requires the option R&S FSH-K3. Command Parameters Unit Comment CHANNEL <numeric value> CHMODE 0, 1 Fixed Channel Mode CHTABLE <string> LEVEL GET command only MEASTIME <numeric value> SCANMODE 0, 1 SCANSTART <numeric value>...
Page 67
R&S FSH-K1 Command Description LEVEL (Signal Level) This command queries the signal level measured (fixed frequency/channel mode only). Example: get<cr> 0<cr> ‘query signal level level<cr> ‘responds parameter ok 0<cr> ‘response: signal level 45.6<cr> MEASTIME (Measurement Time) This command defines the measurement time for the receiver mode. Example: set<cr>...
Page 68
Command Description R&S FSH-K1 SCANSTEP (Frequency Scan Step) This command defines the scan step frequency for the frequency scan mode. Example: set<cr> 0<cr> ‘sets scan step frequency to 200 kHz scanstep,200E3<cr> ‘responds parameter ok 0<cr> FREQSTART (Channel Scan Start Frequency) This command defines the start frequency for the channel scan mode.
Page 70
Command Description R&S FSH-K1 CNMEASMODE (Carrier Noise Measurement Mode) This command defines the kind of reference measurement mode if the reference measurement mode is selected. It is used for the carrier noise measurement. Value Measurement Mode Digital Tx Analog TV CW Tx Example: set<cr>...
Page 71
R&S FSH-K1 Command Description CNPWRDISP (Carrier Noise Power Display) This command turns the C/N power display on or off. Value Power Display Example: set<cr> 0<cr> cnpwrdisp,1<cr> ‘responds parameter ok 0<cr> CNREFPWR (Carrier Noise Ref Power) This command defines the reference power used for carrier noise measurements. Example: set<cr>...
Page 72
Command Description R&S FSH-K1 LVLADJUST (Level Adjust) This command initiates a level adjustment for carrier noise measurement. It is applied to the reference channel if the reference measurement is selected and it is applied to the noise channel if the noise measurement is selected.
R&S FSH-K1 Command Description WCDMA BTS CDP Measurement The WCDMA Measurement requires the option R&S FSH-K4. Command Parameters Unit Comment ANTDIV <numeric value> CARRFREQERR GET command only CPICHPWR <1…6> CPICHSLOTNR GET command only CPICHSYMEVM % rms GET command only PCCPCHPWR GET command only PCCPCHSYMEVM % rms...
Page 74
Command Description R&S FSH-K1 CPICHPWR (CPICH Power) This command retrieves the P-CPICH Power measurement result for WCDMA measurements. Unit is dBm. Optional Value Scrambling Code id 1…6 id 1…6 Example: get<cr> 0<cr> ‘get CPICH power of scrambling code nr id 1 cpichpwr<cr>...
Page 75
R&S FSH-K1 Command Description PCCPCHSYMEVM (P-CCPCH Symbol EVM) This command retrieves the P-CCPCH Symbol EVM measurement result for WCDMA measurements. Unit is % rms. Example: get<cr> 0<cr> pccpchsymevm<cr> ‘get P-CCPCH Symbol EVM ‘responds parameter ok 0<cr> ‘P-CCPCH Symbol EVM is 63.9 % rms 63.9<cr>...
Page 76
Command Description R&S FSH-K1 SSCHPWR (S-SCH Power) This command retrieves the S-SCH Power measurement result for WCDMA measurements. Unit is dBm. Example: get<cr> 0<cr> ‘get S-SCH Power sschpwr<cr> ‘responds parameter ok 0<cr> ‘S-SCH Power is -87.1 dBm -87.1<cr> SSCRCD (Secondary Scramble Code) This command defines the secondary part of the scrambling code.
Page 77
R&S FSH-K1 Command Description TOTPWR (Total Power) This command retrieves the total power measurement result for WCDMA measurements. Unit is dBm. Example: get<cr> 0<cr> ‘get total power totpwr<cr> ‘responds parameter ok 0<cr> ‘Total power is -87 dBm -87<cr> AUTOSDSNGL (Auto Scrambling Detection Single) This command starts the auto scrambling detection single.
Programming Examples R&S FSH-K1 Programming Examples The following examples are code snippets in Visual Basic (VB6). Initialize Communication with R&S FSH Public Function FSHInit(ByVal Port As Integer, ByVal Speed As Long, Optional ByVal ErrorCode As String) As Boolean Rem Initialize communication with FSH Rem Return TRUE if device initialization was successful Rem Return FALSE otherwise e.g.
Page 79
R&S FSH-K1 Programming Examples Send SET Command to R&S FSH Public Function FSHSet(ByVal Command As String) As Boolean Dim TempError As Integer InBuffer = vbNullString FSHSet = False With MainForm.FSHCommC .Output = "set" + vbCr TempError = Val(PollFSH) If TempError = 0 Then .Output = Command + vbCr TempError = Val(PollFSH) If TempError = 0 Then...
Page 80
Programming Examples R&S FSH-K1 Read Binary Trace Data from R&S FSH Public Function FSHGetTraceBin(ByRef Values() As Long) As Boolean Dim InBuffer As String Dim TempError As Integer InBuffer = vbNullString FSHGetTraceBin = False With MainForm.FSHCommC .Output = "GET" + vbCr TempError = Val(PollFSH) If TempError = 0 Then .Output = "TRACEBIN"...
Need help?
Do you have a question about the 1157.3458.02 and is the answer not in the manual?
Questions and answers