Rohde & Schwarz SGU100A User Manual Download Page 52

Understanding the R&S SGMA-GUI Software

R&S

®

SGU100A

50

User Manual 1176.7726.02 ─ 09

6.1.2

 

Setup Menu

The setup menu provides access to dialogs for setting the general settings of the soft-
ware, like dialogs for managing the connected instruments or dialogs providing infor-
mation about the installed options.

6.1.2.1

 

Configure Instruments

This dialog is the central point for managing the instrument that is configured and oper-
ated via the R&S SGMA-GUI. New instruments can be created and appended to the
list of available instruments. Connection settings can be edited, instruments can be
removed from the list or they can be deactivated, but kept in the list for further use.

Refer to 

Chapter 6.4.2, "Handling Instruments in the R&S SGMA-GUI"

on page 61

for information on how to configure and manage instruments in R&S SGMA-GUI.

Available Instruments

This section comprises a list of configured instruments. Each instrument is represented
by a "Symbolic Name" which is also displayed in the main panel and an "Instrument
Type". It is also displayed whether the instrument is activated in the R&S SGMA-GUI
and hence displayed in the main panel or not.

Remote command: 

:INSTruments:COUNt?

 

on page 69

:INSTruments:NAME

 

on page 70

:INSTruments:TYPE

 

on page 72

:INSTruments:ACTive[:STATe]

 

on page 69

Scan

Triggers a scan function and searches for instruments connected to the remote com-
puter via all the available interfaces. During the scan process, a progress bar is dis-
played.

Operating Menu and Toolbar

Summary of Contents for SGU100A

Page 1: ...R S SGU100A SGMA Upconverter User Manual User Manual Version 09 1176772602 ÚÛJ2 ...

Page 2: ...ohde Schwarz GmbH Co KG Mühldorfstr 15 81671 München Germany Phone 49 89 41 29 0 Fax 49 89 41 29 12 164 Email info rohde schwarz com Internet www rohde schwarz com Subject to change Data without tolerance limits is not binding R S is a registered trademark of Rohde Schwarz GmbH Co KG Trade names are trademarks of the owners 1176 7726 02 Version 09 R S SGU100A Throughout this manual products from R...

Page 3: ...sic Safety Instructions and the product documentation in a safe place and pass them on to the subsequent users Riesgo de lesiones y daños en el instrumento El instrumento se debe usar de manera adecuada para prevenir descargas eléctricas incendios lesiones o daños materiales No abrir la carcasa del instrumento Lea y cumpla las Instrucciones de seguridad elementales suministradas con el instrumento...

Page 4: ...die Produktdokumentation gut auf und geben Sie diese an weitere Benutzer des Produkts weiter Risque de blessures et d endommagement de l appareil L appareil doit être utilisé conformément aux prescriptions afin d éviter les électrocutions incendies dommages corporels et matériels N ouvrez pas le boîtier de l appareil Lisez et respectez les consignes de sécurité fondamentales fournies avec l appare...

Page 5: ...1 Putting into Operation 14 2 1 1 EMI Suppression 15 2 1 2 Unpacking and Checking the Instrument 15 2 1 3 Accessory List 16 2 1 4 Placing or Mounting the Instrument 16 2 1 5 Switching the Instrument On and Off 17 2 1 6 Function Check 19 2 1 7 Default Settings 19 2 2 Linux Operating System 20 2 3 Connecting an External PC and Devices 20 2 3 1 Installing the R S SGMA GUI Software 21 2 3 2 Connecting...

Page 6: ...Direct Connection 42 5 2 2 Connection in a Company Network 43 5 2 3 Connection with a PCIe Switch 46 6 Understanding the R S SGMA GUI Software 48 6 1 Operating Menu and Toolbar 48 6 1 1 File Menu 49 6 1 2 Setup Menu 50 6 1 2 1 Configure Instruments 50 6 1 2 2 Add Edit Instruments 52 6 1 2 3 Versions Options Dialog 54 6 1 2 4 Reset SGMA GUI 55 6 1 2 5 Remote 55 6 1 3 Help 56 6 2 Info Dialog and Mes...

Page 7: ...Dialog 66 6 5 Remote Control of the R S SGMA GUI 67 6 5 1 Configuring Instruments in the R S SGMA GUI 67 6 5 2 R S SGMA GUI Settings 68 6 5 3 List of R S SGMA GUI Commands 72 7 Upconverter Settings 73 7 1 Frequency Settings 73 7 2 Level and Power On Settings 73 7 2 1 RF Level 74 7 2 2 Attenuator 76 7 2 3 Power On EMF 78 7 2 4 ALC 78 7 3 I Q Modulation and Signal Impairment 79 7 3 1 I Q Impairments...

Page 8: ...gnals with an R S SGS and an R S SGU Upconverter 104 9 2 How to Restore the LAN Connection to an Instrument 106 9 3 How to Switch between the Operating States 107 9 4 How to Use Computer Names 109 9 5 How to Install a New Firmware Version on the Instrument 110 9 6 How to Activate Options 111 9 7 How to Manually Set a PCIe Direct Connection between an R S SGS and an R S SGU 111 10 Network and Remot...

Page 9: ...er and the Instrument 127 10 3 5 Enabling Fast Settings 128 10 4 Advanced Remote Control Using Fast Socket 128 10 4 1 Setting Up a Remote Control Connection via Fast Socket 129 10 4 2 Installing the Protocol Driver 130 10 4 3 Enabling Fast Settings 130 10 5 LXI Configuration 130 10 5 1 Default State of the Network Settings 131 10 5 2 LXI Browser Settings 131 10 5 3 LAN Configuration 132 10 5 3 1 I...

Page 10: ...Conventions 159 11 10 2 Extensions for User Files 160 11 10 3 Examples 160 11 10 4 Remote Control Commands 161 11 11 OUTPut Subsystem 167 11 12 SOURce Subsystem 169 11 13 SOURce IQ Subsystem 170 11 14 SOURce Local Oscillator Subsystem 172 11 15 SOURce POWer Subsystem 174 11 16 SOURce PULM Subsystem 178 11 17 STATus Subsystem 179 11 18 SYSTem Subsystem 182 11 19 TEST Subsystem 192 11 20 UNIT Subsys...

Page 11: ...A 3 3 3 Boolean Parameters 210 A 3 3 4 Text Parameters 210 A 3 3 5 Character Strings 210 A 3 3 6 Block Data 210 A 3 4 Overview of Syntax Elements 211 A 3 5 Structure of a Command Line 212 A 3 6 Responses to Queries 213 A 4 Command Sequence and Synchronization 214 A 4 1 Preventing Overlapping Execution 214 A 5 Status Reporting System 215 A 5 1 Hierarchy of the Status Registers 215 A 5 2 Structure o...

Page 12: ... 5 7 1 Service Request 221 A 5 7 2 Serial Poll 222 A 5 7 3 Query of an instrument status 222 A 5 7 4 Error Queue 222 A 5 8 Reset Values of the Status Reporting System 223 A 6 General Programming Recommendations 223 B Telnet program examples 225 Index 230 ...

Page 13: ... R S SGMA GUI to set up and control one or more R S SGU instruments simultaneously from one remote computer available for Windows and Linux systems 1 2 Documentation Overview This section provides an overview of the R S SGU user documentation Unless speci fied otherwise you find the documents on the R S SGU product page at www rohde schwarz com manual sgu100a 1 2 1 Getting Started Manual Introduce...

Page 14: ...th the R S SGU in secure areas It is avail able for download on the Internet 1 2 5 Basic Safety Instructions Contains safety instructions operating conditions and further important information The printed document is delivered with the instrument 1 2 6 Data Sheets and Brochures The data sheet contains the technical specifications of the R S SGU It also lists the options and their order numbers and...

Page 15: ...ser interface ele ments All names of graphical user interface elements on the screen such as dialog boxes menus options buttons and softkeys are enclosed by quotation marks Keys Key and knob names are enclosed by square brackets Filenames commands program code Filenames commands coding samples and screen output are distin guished by their font Input Input to be entered by the user is displayed in ...

Page 16: ...Notice that the data sheet may specify additional operating conditions Risk of instrument damage due to inappropriate operating conditions Specific operating conditions are required to ensure accurate measurements and to avoid damage to the instrument Observe the information on appropriate operating conditions provided in the basic safety instructions and the instrument s data sheet Instrument dam...

Page 17: ...re not overloaded 2 1 1 EMI Suppression Electromagnetic interference EMI may affect the measurement results To suppress generated Electromagnetic Interference EMI Use suitable shielded cables of high quality For example use double shielded RF and LAN cables Note USB cables are of varying and often poor quality Therefore check the qual ity of each individual USB cable as described in the service ma...

Page 18: ...ause injury 2 1 3 Accessory List The instrument comes with the following accessories Power cable Getting started printed manual 2 1 4 Placing or Mounting the Instrument The R S SGU is designed for use under laboratory conditions either on a bench top or in a rack using a rack adapter kit order number see data sheet Bench top operation If the R S SGU is operated on a bench top the surface should be...

Page 19: ... stack smaller instruments on the top the overall load imposed on the lowest instrument must not exceed 250 N If the instruments have foldable feet fold them in completely Rack mounting The R S SGU can be installed in a rack using a rack adapter kit Order No see data sheet The installation instructions are part of the adapter kit Risk of instrument damage due to insufficient airflow in a rack If y...

Page 20: ...wer supplied and the R S SGU initiates its startup procedure In standby state the button is orange The standby power mode keeps the power switch circuits and the remote control system active Start up and booting The instrument boots the operating system and starts the instrument firmware During the booting process the green POWER ON STAND BY key blinks If the previous session was terminated regula...

Page 21: ...er with a brief error description For an in depth identification of the error press the SGMA GUI Info button In response a description of the errors is displayed For more information refer to the Error Messages section in the user manual 2 1 7 Default Settings When the instrument is switched on it is not the preset state that is active but rather the instrument state that was set before the instru...

Page 22: ...e manual operation via the R S SGMA GUI software on the connected PC Both the remote control and the manual operation of the instrument require an external controller For the prerequisites and the instructions on how to configure an external controller for remote control refer to the user manual A brief introduction to the remote control capabilities is provided in Chapter 10 Network and Remote Co...

Page 23: ...y with each update To install the R S SGMA GUI the following hardware and soft ware requirements have to be met Table 2 1 Hardware and software requirements Requirement Remark One of the following operating sys tems Windows Vista Windows 7 Windows 8 8 1 Windows 10 Linux R S SGMA GUI has to be installed on one of the supported operat ing systems Also the version of the operating system must be stil...

Page 24: ... SGMA GUI_V VV VVV VVV The script file identifies and removes all currently installed R S SGMA GUI soft ware items 2 3 2 Connecting a Remote PC via LAN The R S SGU is equipped with a network interface and can be connected to an Ether net LAN local area network The interface can be used for example To connect an external computer for manual control of the instrument by the R S SGMA GUI software To ...

Page 25: ...k connection and activates the required drivers By default the instrument is configured to use dynamic TCP IP configuration and obtain all address information automatically Setting up a dedicated network connection If your network does not support DHCP you can set a dedicated network connection between a stand alone PC and a R S SGU Prerequisite the computer and the R S SGU are turned on and runni...

Page 26: ...s area for Zeroconf By default the instrument is configured to use dynamic TCP IP configuration and obtain all address information automatically This means that it is safe to establish a physical connection to the LAN without any previous instrument configuration Assigning a static IP address to the R S SGU Prerequisites A connection is established between the R S SGU and the controller with insta...

Page 27: ...indows system Help 2 3 2 3 Automatically Adding Instruments to the SGMA GUI For information on how to install the R S SGMA GUI software refer to Chapter 2 3 1 Installing the R S SGMA GUI Software on page 21 1 For each new instrument perform the following steps a Connect the instrument to the network b Press the POWER ON STAND BY key to switch on the instrument c Wait until the POWER ON STAND BY LE...

Page 28: ...he R S SGU the R S SGU acts as a USB device To connect the controller to the USB interface of the R S SGU always connect the USB type Micro B connector to the R S SGU Refer to the documentation of the con troller to find out which USB connector type you can connect to the controller The Figure 2 1 illustrates schematically the required connector type to emphasize on the different connector shape F...

Page 29: ...s schematically the required connector type to emphasize on the different connector shape Figure 2 2 USB type Micro A connectors If you connect an R S SGS to an R S SGU via a USB cable perform the steps as described in Chapter 5 2 Setups for Connecting an R S SGS and an R S SGU on page 41 Using a USB Adapter You can use a USB adapter to customize the connectors of a USB cable to the require ments ...

Page 30: ...in Chapter 3 2 Rear Panel Tour on page 30 As the R S SGU is inten ded to be remote controlled the front panel of the R S SGU contains no display but mostly LEDs to inform you about the status of the instrument The user interface can be displayed on a remote PC station used to manually remote control the instrument Figure 3 1 Front panel view POWER ON STAND BY The POWER ON STAND BY key switches the...

Page 31: ...ed or power fail ure Blinking orange indicates a running process e g calibration self test No light indicates that no errors or warnings have occurred For details on errors or warnings refer to the graphical user interface on a remote PC SGMA GUI Info For more information refer to the Error Messages section in the user manual LAN The LAN key indicates if a LAN connection is established Green LED i...

Page 32: ...he connectors refer to the data sheet Figure 3 2 Rear panel view Risk of damaging components Always use an appropriate 8 mm torque wrench to tighten SMA connectors Limit the tightening torque to 60 Ncm Never use an open end wrench PCI Express Connector The PCIe Peripheral Component Interconnect Express single lane interface allows remote control with optimized speed For details see Chapter 2 3 3 C...

Page 33: ...puter you can perform a firmware update manual operation via the R S SGMA GUI software or for remote control of the instrument The connection to the remote computer can be direct or via a network For details see Chapter 2 3 2 Connecting a Remote PC via LAN on page 22 RF OUT Provides an RF 50 Ohm signal output NOTICE Maximum input levels Do not overload the RF output The maximum permis sible back f...

Page 34: ...The I OUT and Q OUT SMA female type connectors are for direct output of the ana log I Q signal NOTICE Maximum input levels Do not overload the I and Q inputs The maximum permissible voltage is 1V For details refer to the data sheet Note The I Q modulator requires the hardware optionR S SGU B120V B140V AC supply and power switch The AC supply and power switch allow you to connect the R S SGU to the...

Page 35: ...the following example the instrument is manually operated via the R S SGMA GUI software The R S SGU in this example is a base unit equipped with the frequency option R S SGU B120 Configuring the R S SGU to upconvert a CW signal generated by the R S SGS As a prerequisite for this example the R S SGMA GUI software has to be installed on a remote PC Figure 4 1 Example of a test setup for upconverting...

Page 36: ...oftware The main panel provides a quick access to the main settings of the configured and activated instruments The display shows one row per instrument with the instru ment specific settings The rows comprise the instrument the connection state the used frequency and power level and the state of the RF output and the modulator 5 In the R S SGMA GUI main panel the green indicator in front of the i...

Page 37: ...U from the list and set Available Instruments Select On to enable it as an extension A green status indicator Connected indicates the successfully established remote connection between the R S SGS ant the R S SGU The R S SGMA GUI indicates the extended frequency range of the R S SGS and the activated extension mode 9 Select Test Signal Connections Test to trigger a check of all required signal con...

Page 38: ...ect SGMA GUI R S SGS Freq 40 GHz Lev 30 dBm 11 Select SGMA GUI SGS RF State On to enable the output of the CW sig nal The extension adopts these values and states automatically and generates a CW signal with RF 40 GHz and Level 20 dBm The signal is output at the RF OUT connector on the rear panel of the R S SGU R S SGU as an Extension to the R S SGS ...

Page 39: ...s wave CW signal The signal in this example is provided by an incompatible signal generator local oscillator In the following example the instrument is manually operated via the R S SGMA GUI software The R S SGU in this example is a base unit equipped with the frequency option R S SGU B120 Configuring the R S SGU to convert a CW signal As a prerequisite for this example the R S SGMA GUI software h...

Page 40: ...in settings of the configured and activated instruments The display shows one row per instrument with the instru ment specific settings The rows comprise the instrument the connection state the used frequency and power level and the state of the RF output and the modulator 5 In the R S SGMA GUI main panel the green indicator in front of the instrument s name confirms that there is a connection bet...

Page 41: ...anges The 15 GHz signal is output at the LO OUT connector at the rear panel of the R S SGU Identifying a specific instrument If several instruments are active in the R S SGMA GUI use one of the device identifi cation functions to identify a specific device Select SGMA GUI Instrument Name Setup Remote Remote Channels Device Identify The green LAN LED on the front panel of the instrument blinks Pres...

Page 42: ...l Operation from the R S SGMA GUI The following example represents a basic configuration of the R S SGU operated manually by the configuration software R S SGMA GUI The configuration software is installed on a remote PC and controls several instruments The instruments are con nected to the remote PC over different remote control interfaces Any combination of the used interfaces is possible Figure ...

Page 43: ...he compatible R S Signal Generator acts as a controller to the R S SGU The generator performs all required settings automatically depending on the required output signal parameters The Figure 5 3 shows a configuration example of the R S SGU directly controlled by an R S SGS For a detailed description of the connecting possibilities refer to Chap ter 5 2 Setups for Connecting an R S SGS and an R S ...

Page 44: ... Figure 5 4 Direct connection of an R S SGS and an R S SGU Figure 5 4 Direct connection of an R S SGS and an R S SGU 1 Connect the R S SGS and the R S SGU directly using one of the following options a USB cable Use a Type Micro A connector for R S SGS and a Type Micro B connector for R S SGU See also Chapter 2 3 4 Connecting a Controller or a USB Device via USB on page 26 b LAN cable No additional...

Page 45: ...evision of your instrument in the SGMA GUI Instrument Name Hardware Config dialog If instrument is not automatically added as an extension If the R S SGU is not automatically added as an extension you can do that manually in the SGMA GUI R S SGS Name Extension dialog If the R S SGU is not listed in the list of Available Instruments you can press Scan Start to find the instrument 5 2 2 Connection i...

Page 46: ...GU The POWER ON STANDBY keys have to be green and not blinking 3 Press the ID keys on the front panels of the R S SGS and the R S SGU 4 On the connected remote PC start the R S SGMA GUI software application The main panel of the application and the configure instruments dialog open Both instruments are added automatically to the instruments list and to the main panel of the R S SGMA GUI software N...

Page 47: ...extension dialog If the R S SGU is not auto matically shown in this dialog press Scan Start to find the instrument 7 Select the R S SGU from the list and set Available Instruments Select On to enable it as an extension A green status indicator Connected indicates the successfully established remote connection between the R S SGS ant the R S SGU The R S SGMA GUI indicates the extended frequency ran...

Page 48: ... is marked as faulty a red line is crossing the blue connec tion line check whether the cables are connected properly Check also if the con nection cables are functioning properly Figure 5 6 A faulty connection between an R S SGU and an R S SGS 5 2 3 Connection with a PCIe Switch The R S SGS and the R S SGU can be connected through a PCIe switch as shown in Figure 5 7 This setup is recommended for...

Page 49: ...green and not blinking 4 Switch on the computer 5 On the computer start one of the following a The R S SGMA GUI b An application program for remote control of the instruments 6 Manually or remotely activate the R S SGU as an extension to the R S SGS The logical connection between an R S SGS and an R S SGU is established by the driver layer of a program e g the R S SGMA GUI or the library PCIeContr...

Page 50: ...ys loads the previously used settings so you can continue your work in the next session 6 1 Operating Menu and Toolbar On the top of the main panel there are the menu bar the toolbar and the info bar with the corresponding Info button Some of the functions are accessible via the toolbar with its icons below the menu selection line The dialogs are built using elements e g selection lists checkboxes...

Page 51: ...ttings e g frequency and level settings are stored locally on the particular instrument itself These instruments settings are saved automatically in a predefined directory and loaded by default when starting the instrument again The files with instrument settings are not accessible Save Standard quick save of the settings of the current session if a filename previously has been applied If not the ...

Page 52: ...kept in the list for further use Refer to Chapter 6 4 2 Handling Instruments in the R S SGMA GUI on page 61 for information on how to configure and manage instruments in R S SGMA GUI Available Instruments This section comprises a list of configured instruments Each instrument is represented by a Symbolic Name which is also displayed in the main panel and an Instrument Type It is also displayed whe...

Page 53: ...ist of Available Instruments Export Opens the standard file save browser for saving the list of the available instruments in a mapping file The mapping files have the file extension map so the filename typed in is automatically equipped with this extension A mapping file provides a cross reference between the instruments symbolic names and their respective remote control parameters The information...

Page 54: ...able instruments it may be due to the prefixes written in this field You can perform another scan while leaving this field empty Remote command INSTruments SCAN HNPRefix on page 71 6 1 2 2 Add Edit Instruments The dialog provides access to the main instrument s settings such as Symbolic Name Instrument Type and connection settings Refer to Chapter 6 4 2 Handling Instruments in the R S SGMA GUI on ...

Page 55: ...trol over PCIe or Socket the lock request is performed on a higher application level Note It is recommended to lock the instrument before further configuration Locked instruments are not found by the scan function The instrument has to be unlocked to allow operation from another remote PC Note The two functions Exclusive Access and monitoring are mutually exclusive Disable Exclusive Access if the ...

Page 56: ...See also Chapter 10 1 5 GPIB Interface IEC IEEE Bus Interface on page 121 Remote command INSTruments GPIB BOARd on page 71 Serial Number Enters the serial number as instrument s identification while using the USB or PCIe interfaces for remote control Remote command INSTruments SERial on page 71 OK Confirms the settings and closes the dialog Apply Confirms the settings Cancel Discards settings and ...

Page 57: ...UI to its factory preset settings The connected instruments are not affected by this preset To preset one specific instrument to its factory preset settings select SGMA GUI Instrument Name Setup Factory Preset Refer to Chapter 8 9 Factory Preset on page 101 for an overview of the settings affected by this function 6 1 2 5 Remote Access SGMA GUI Setup Remote SCPI Port Sets the port number of the LA...

Page 58: ... online help can be reached via the menu SGMA GUI Help Contents A search for keywords within the help function is available via menu item SGMA GUI Help Index 6 2 Info Dialog and Messages in the Info Bar A few operating states and the current messages are displayed in the info line For information on messages in greater detail and their management an Info dialog can be opened 6 2 1 Info Dialog The ...

Page 59: ...es refer to Chapter 6 4 5 Managing Mes sages in the Info Dialog on page 66 Function Description Delete Clears the highlighted message This button is available only if the history of the messages is displayed Delete All Clears all messages This button is available only if the history of the messages is displayed Del volatile Clears all brief messages This button is available only if the history of ...

Page 60: ...displayed if an error occurs that impairs further program operation The error signaled by a permanent message must be eliminated before correct software operation can be ensured The message is displayed until the error is eliminated It covers the status display in the info line After error elimination the message automatically disappears and is also recorded in the history 6 3 Main Panel The main ...

Page 61: ...ready state on page 108 Instrument locked The red state indication together with the message Instrument Locked in the Info line indicates that the instrument is locked for Exclusive Access from another SGMA GUI or controller The instrument is performing a time consuming operation e g a selftest Maximum Frequency The numbers in the rectangular box on the left of the instrument s name indicate the m...

Page 62: ...instrument The value is calculated as follows PEP Level Crest Factor Remote command SOURce POWer PEP on page 177 Level Level Offset Sets the RF level at the RF output connector of the selected instrument If you set a level offset it will be indicated in the R S SGMA GUI main panel by a change in the name of this parameter from Level to Level Offset Note The SCPI command SOURce POWer LEVel IMMediat...

Page 63: ...dling Instruments in the R S SGMA GUI This section provides information on how to configure and manage instruments in the R S SGMA GUI For reference information about all provided settings in the user interface refer to the corresponding sections Chapter 6 1 2 1 Configure Instruments on page 50 and Chapter 6 1 2 2 Add Edit Instruments on page 52 Chapter 6 1 2 3 Versions Options Dialog on page 54 C...

Page 64: ...s and to close the dialog or press the Apply but ton to confirm the settings 10 Click the Cancel button to discard settings and to close the dialog 6 4 2 3 How to Scan for New Instruments 1 In the R S SGMA GUI main panel select Setup Instruments The Configure Instruments dialog opens 2 Click the Scan button to trigger the instrument to scan all remote channel interfa ces for connected instruments ...

Page 65: ...the settings and confirm with OK The edited settings are applied 6 4 2 6 How to Delete an Instrument 1 In the R S SGMA GUI main panel select Setup Instruments The Configure Instruments dialog opens 2 Select the instrument to be deleted and click the Delete button The selected instrument is deleted from the list of Available Instruments 6 4 2 7 How to Delete All Instruments 1 In the R S SGMA GUI ma...

Page 66: ...the complete name of the instrument written without spaces How to query the hostname of the instrument 1 Find the individual serial number on rear of the instrument e g 100021 2 Build the default hostname For the R S SGU with serial number 100021 the default hostname is rssgu100a100021 For instructions on how to change the default hostname refer to Chapter 9 4 How to Use Computer Names on page 109...

Page 67: ...e following Check whether the instrument is correctly connected to the external PC on which you work with the R S SGMA GUI Check if the instrument is configured in the R S SGMA GUI and perform if neces sary the steps described in Chapter 6 4 2 Handling Instruments in the R S SGMA GUI on page 61 Select SGMA GUI Setup Instruments check the state of the instrument in the Configure Instruments Availab...

Page 68: ...he highlighted mes sage is displayed How to display all messages In the Info dialog click the History button A history of all messages that have occurred since the R S SGMA GUI software was started is listed in the upper dialog pane The most recent message is dis played first How to delete an error message In the Info dialog select the highlighted message and click the Delete button Tip This butto...

Page 69: ... the following example we assume that a remote PC with installed R S SGMA GUI on it is connected to a LAN and that the remote PC and the instruments are switched on For more information refer to Chapter 2 3 Connecting an External PC and Devices on page 20 Trigger the scan function to search for instruments connected to the remote computer via all of the available interfaces INSTruments SCAN HNPRef...

Page 70: ... in the list i e the instruments with symbolic names SGS 100006 Export the configuration into a mapping file INSTruments MAPPing FILE d mapping_files mapping map Enable exclusive access for the selected instrument INSTruments EACCess STATe Response 0 0 0 INSTruments EACCess STATe ON 0FF 0FF Locks the first instrument 6 5 2 R S SGMA GUI Settings This section comprises the SCPI commands provided to ...

Page 71: ...page 50 INSTruments COUNt Queries the number of the currently available instruments Return values Count float Range 0 to 12 Example See Chapter 6 5 1 Configuring Instruments in the R S SGMA GUI on page 67 Usage Query only Manual operation See Available Instruments on page 50 INSTruments EACCess STATe State Locks the instruments meaning the instrument is reserved and can be operated exclusively fro...

Page 72: ...ymbolicNameInstr 1 SymbolicNameInstr 2 Example See Chapter 6 5 1 Configuring Instruments in the R S SGMA GUI on page 67 Manual operation See Available Instruments on page 50 INSTruments REMote CHANnel Channel Sets the hardware interface used by the remote channel Parameters Channel List of CHAR Data Channellnstr 1 Channellnstr 2 The available interfaces are LAN USB SOCKET PCIe GPIB HiSLIP Example ...

Page 73: ...interfaces Parameters State number 1 triggers the scan function 0 aborts the running scan proc ess The query command returns 1 as long as scan is running 0 indi cates completed scan process Example See Chapter 6 5 1 Configuring Instruments in the R S SGMA GUI on page 67 Manual operation See Scan on page 50 INSTruments SCAN HNPRefix Prefix Sets the prefix the searched host names begin with Paramete...

Page 74: ...TypeInstr 1 TypeInstr 2 Example See Chapter 6 5 1 Configuring Instruments in the R S SGMA GUI on page 67 Manual operation See Available Instruments on page 50 6 5 3 List of R S SGMA GUI Commands INSTruments ACTive STATe 69 INSTruments COUNt 69 INSTruments EACCess STATe 69 INSTruments GPIB ADDRess 71 INSTruments GPIB BOARd 71 INSTruments MAPPing FILE 70 INSTruments NAME 70 INSTruments REMote CHANne...

Page 75: ...quency range of 10 MHz to 40 GHz To access this dialog select SGMA GUI Instrument Name Frequency Configuring the RF frequency To change the RF frequency of the selected instrument perform one of the follow ing a Select SGMA GUI main panel Freq and enter the desired frequency b Select SGMA GUI Instrument Name Frequency Phase Frequency and enter the desired frequency You have to confirm the changes ...

Page 76: ... signal 7 2 1 RF Level To access the RF level settings select SGMA GUI Instrument Name Level RF Level This dialog comprises settings like the RF level and level limit Level Level Offset Sets the RF level at the RF output connector of the selected instrument If you set a level offset it will be indicated in the R S SGMA GUI main panel by a change in the name of this parameter from Level to Level Of...

Page 77: ...imum Remote command SOURce POWer LMODe on page 175 Setting Characteristic Selects the characteristic for the level setting For some general applications the instrument operation can be optimized by choosing one of the predefined level setting characteristics Auto The instrument provides the highest dynamic range and the fastest setting times according to the data sheet The RF signal is shortly bla...

Page 78: ...pt is made to set a level above this limit and the level at the RF out put is confined to the upper limit However the level indication is not influenced The value is not affected by an instrument preset function This parameter is influenced only by the Factory Preset and its factory value is equal to the upper limit Remote command SOURce POWer LIMit AMPLitude on page 177 Readjust Recalculates the ...

Page 79: ...overranged or underranged level errors increase considerably and the warning Level under overrange appears in the info line The spectral purity of the output signal decreases with high attenuation Remote command OUTPut AMODe on page 167 Level Range If Attenuator Mode Fixed is selected displays the level range in which the level is set without interruption Remote command OUTPut AFIXed RANGe LOWer o...

Page 80: ...ument is switched on Previous Setting When the instrument is switched on the output takes the same state as it had when the instrument was switched off Remote command OUTPut STATe PON on page 168 7 2 4 ALC To access the automatic level control ALC settings select SGMA GUI Instru ment Name Level ALC Automatic level control can be used with almost all applications especially I Q modulation It only h...

Page 81: ... detector It is recommended to use the Auto mode default Auto Automatic detector selection Recommended mode of operation Low Low sensitivity detector selected This setting is intended for signals with high internal electronic levels Med Medium sensitivity detector selected This setting corresponds to normal mode It is intended for signals with medium internal electronic levels High High sensitivit...

Page 82: ...cation of all I Q amplitudes by a common factor The effect is equivalent to two identical I and Q gain factors The effect of an increased gain factor in the I Q constellation diagram is shown below Figure 7 1 Effect of an increased amplitude in the I Q constellation diagram An I gain multiplies the I amplitudes by a factor leaving the Q amplitudes unchanged A Q gain has the opposite effect Differe...

Page 83: ...odulator Possi ble reasons are interfering signals at the RF carrier frequency e g an unsuppressed RF carrier subchannel The effect of a positive I and Q offset in the I Q constellation diagram is shown below Figure 7 3 I offset left and Q offset right in the I Q constellation diagram 7 3 1 3 Quadrature Offset Changes the phase angle between the I and Q vectors from the ideal 90 degrees while the ...

Page 84: ...e and the analog wideband I Q input Mod State Switches the I Q modulation on and off Remote command SOURce IQ STATe on page 170 Crest Factor Sets the crest factor of the I Q modulation signal The crest factor gives the difference in level between the peak envelope power PEP and average power value RMS in dB This value is necessary for the generation of the correct output power at the RF output i e...

Page 85: ...dulator select SGMA GUI Instrument Name I Q Settings Analog Impairments Comprises the settings like I Q offset and quadrature offset State Activates deactivates I Q impairments If activated the settings for offset gain imbalance and quadrature offset become effec tive Note It is recommended to switch automatic level control to the Off Table mode as otherwise level errors may occur Remote command S...

Page 86: ...centage Negative values have the opposite effect Remote command SOURce IQ IMPairment IQRatio on page 170 Quadrature Offset Sets the quadrature offset see Chapter 7 3 1 3 Quadrature Offset on page 81 Remote command SOURce IQ IMPairment QUADrature ANGLe on page 171 7 4 Pulse Modulation Setting The R S SGU offers pulse modulation using external pulse signals The external pulse signal has to be connec...

Page 87: ...Instrument Name Pulse Modulation Connector Trigger Comprises the settings necessary to configure the signal at the multi purpose TRIG connector in the external trigger mode Trigger Connector Mode Determines the signal at the input output of the multi purpose TRIG connector Signal Valid Output of high signal to mark valid frequency and level settings Not Signal Valid Output of high signal to mark t...

Page 88: ... an incompatible LO and an R S SGU follow these steps Setting the signal of the R S SGU 1 Set the parameters of the R S SGU like frequency and level in the R S SGMA GUI as needed 2 Open the SGMA GUI Instrument Name Ext Local Oscillator dialog and read the settings for Frequency and Level 3 Apply the required changes to the LO 4 Press the Confirm External LO Settings button to confirm that you have...

Page 89: ...an externally provided pulse modulation signal Used when an external pulse modulator source is provided at the connector Remote command CONNector TRIGger OMODe on page 155 7 7 Preset Calls up a defined instrument setup All parameters and switching states are preset also those of inactive operating modes The default instrument settings provide a reproducible initial basis for all other settings How...

Page 90: ...ument Name Preset func tion Power on settings Level dialog Network settings Setup dialog Password and settings protected by passwords Setup dialog To preset the R S SGMA GUI itself and all configured instruments to their predefined state use the SGMA GUI File New function SCPI command SYSTem PRESet on page 150 Preset ...

Page 91: ... affect signal generation Access Select SGMA GUI Instrument Name Setup and select the required dialog 8 1 Hardware Configuration Querying information about the installed assemblies Select SGMA GUI Instrument Name Setup Hardware Config In the Hardware Config dialog the installed assemblies together with their var iants and revision states can be displayed for servicing purposes Hardware Configurati...

Page 92: ...s It is divided into the sec tions Common Assembly RF Assembly Assembly The tables list the installed assemblies Assembly Name of the assembly Part Number Part Number of the assembly Serial Number Serial number of the assembly Revision Revision state of assembly Remote command SYSTem HARDware ASSembly dir SNUMber on page 191 Hardware Configuration ...

Page 93: ...t the installed options and software version Select SGMA GUI Instrument Name Setup Software Options The Software Options dialog shows the firmware version of the instrument soft ware and all installed hardware and software options The dialog is divided into the following sections Firmware Hardware Software Loaded Modules Software Options ...

Page 94: ...nstalled hardware and software options Option Short name of the option Designation Name of the option Licenses Number of licenses Expiration Date For regular options Permanent is indicated in this column Some options are available as trial versions This column shows their expi ration date After this date the option is no longer available on the instrument Loaded Modules Section Loaded Modules is p...

Page 95: ...nctions 1 Select SGMA GUI main panel Instrument Name Setup Protection The Protection dialog provides access to the unlocking of protected service func tions authorized personnel of R S Service Departments only 2 To deactivate the protection the correct password has to be entered After the instrument has been switched on the protection levels 1 to 4 are automatically activated Enter Protection Leve...

Page 96: ...is provided in the Security dialog To access the Security dialog select SGMA GUI Instrument Name Setup Security The menu is divided into the password sections and the security settings section In the password section the passwords for securing a controlled access to the instrument are defined and changed A change of passwords for the operating system and security password requires the entry of the...

Page 97: ... Change User Password Enter the new password for conformation The new password is only valid after the Change Password button is pressed Change Password Change User Password Changes the password accordingly Change Security Password Note It is highly recommended to change the default security password before con necting the instrument to the network The security password is for example required whe...

Page 98: ...nnection is a prerequisite for the remote control of the instrument via VNC FTP or SAMBA Security Password Security Settings Enters the password that is required to enable or to disable the settings protected by a security password The default is 123456 Note It is highly recommended to change the default security password before con necting the instrument to the network To change the security pass...

Page 99: ...nsuming operation This feature accelerates the update process and the required restart of the external PC can be executed once after the update operation of all instruments is completed Security Password Enters the password that is required to enable or to disable the settings protected by a security password The default is 123456 Note It is highly recommended to change the default security passwo...

Page 100: ...I Instrument Name Setup Network Settings The dialog provides access to the network settings like settings about the general net work environment and specific identification of the computer in the network The dialog also displays an indication whether the instrument is connected to the network or not Restart Network Shuts down the network connection of the instrument and then re establishes the con...

Page 101: ...s resets the Address Mode to its default value Auto DHCP Auto DHCP The IP address is assigned automatically The network used must support automatic assignment of IP address via DHCP or APIPA Zeroconf to use this function Static The IP address is assigned manually Remote command SYSTem COMMunicate NETWork IPADdress MODE on page 186 IP Address Displays the IP address To enter the IP address manually...

Page 102: ...y on page 188 Apply Applies the network settings to the instrument 8 8 Remote Channels The Remote dialog provides access to the settings for remote control To access this dialog select SGMA GUI Instrument Name Setup Remote Visa Resource Strings Indicates the VISA resource strings used for remote control of the instrument A sepa rate string is provided for remote control via the different interface...

Page 103: ...ettings to their factory state Note Because Factory Preset resets the Remote Channel Settings and Network Settings to the default values executing factory preset via remote control may termi nate the connection to the instrument if these settings had been configured to values different to the default ones The factory preset function resets nearly all instrument settings In addition to the regu lar...

Page 104: ...e frequency range in the R S SGMA GUI Risk of invalid adjustment after changing the Eco Mode The switching off and on of the doubler stage changes the thermal conditions in the instrument In order to achieve correct adjustment of the instrument make sure that the instrument is warm before performing adjustments The warm up time is 30 minutes The state of this parameter is not affected by an instru...

Page 105: ...A GUI Instrument Name Diagnostic Tests Keyboard Test Use this function to check the proper operation of all front panel elements If Keyboard Test is enabled all front panel LEDs except the POWER ON are orange The exact test procedure is described in the service manual SCPI command TEST KEYBoard STATe on page 193 Diagnostic and Tests ...

Page 106: ...ements refer to Chapter 2 3 2 1 Connecting the Instrument to the Network on page 22 Chapter 2 3 1 Installing the R S SGMA GUI Software on page 21 Chapter 2 3 2 3 Automatically Adding Instruments to the SGMA GUI on page 25 9 1 How to Generate I Q Signals with an R S SGS and an R S SGU Upconverter Options R S SGS B112V and R S SGU B120V B140V are required for the I Q mod ulation To generate an I Q m...

Page 107: ...f the R S SGU c Connect the I Q OUT of the R S SGS to the I and Q connectors of the R S SGS d Connect the RF OUT of the R S SGS to the LO IN of the R S SGU e Connect the TRIG connectors of the R S SGS and the R S SGU f Connect the RF OUT of the R S SGU to the RF IN of the signal analyzer 2 Select SGMA GUI main panel R S SGS Extension Tip Steps 3 to 5 can be omitted if the R S SGS and a single R S ...

Page 108: ...ignal connections The diagram displays the connection state of the tested connections 7 Select SGMA GUI R S SGS Freq 20 GHz Lev 30 dBm and enable RF State On The extension adopts these values and states automatically Generated is an I Q signal with RF 20 GHz and Level 30 dBm 9 2 How to Restore the LAN Connection to an Instrument If the LAN connection to an instrument configured to use a static IP ...

Page 109: ...an overview of the operating states of the instruments and how to trigger the switch over between them Figure 9 2 Operating states RESTart STANdby SCPI commands Setup Standby Setup Restart Shut Down Instru ments and Exit R S SGMA GUI controls POWER ON STANDBY POWER SWITCH ON OFF Hardkey controls on the front rear panel of the instrument The Table 9 1 provides a short description of the operating s...

Page 110: ...strument name is green The green POWER ON STAND BY key is on To switch the instrument to standby state Use one of the following a On the remote PC select SGMA GUI Instrument Name Setup Standby b Press the POWER ON STAND BY key on the front panel of the instrument c Send the SCPI command SYSTem REBoot The current instruments settings are automatically stored The instrument switches to a power savin...

Page 111: ...biguous computer name Each instrument is delivered with an assigned computer name but this name can be changed For instruction on how to find out the default computer name refer to Chapter 6 4 3 Finding Out the Default Hostname of the Instrument on page 64 To query and change a computer name To avoid violations and to make use of the easy identification provided by the computer name it is recommen...

Page 112: ...e firmware file and automatically starts the update proce dure During the update the message Updating Firmware is displayed in the Info line The update process is indicated by an LED running light Note The update procedure requires a restart of the instrument The restart is per formed automatically The instrument is not accessible during that time 6 Wait until the message Updating Firmware disappe...

Page 113: ... Options A firmware update before the activation of the SW option may be required Refer to the description of the SW option for the required firmware version See also Chapter 9 5 How to Install a New Firmware Version on the Instrument on page 110 for instruction on how to update the firmware version 1 Select SGMA GUI main panel Instrument Name Setup Install SW Options 2 Select Option Key and enter...

Page 114: ...nt on page 127 for cable requirements and setup information 2 Switch on the R S SGS and the R S SGU 3 Select SGMA GUI main panel Instrument Name Setup Maintainance 4 Select Operation PCIe Interface Mode 5 Select PCIe Interface Mode Root Complex 6 Restart your instrument for the changes to take place The PCIe connection between the R S SGS and the R S SGU is established and the instruments can be u...

Page 115: ...NSTR VXI 11 TCPIP host address inst0 INSTR Library VISA socket communication Raw Ethernet simple Telnet TCPIP host address LAN device name port SOCKET Library VISA or socket controller A LAN connector is located on the rear panel of the instrument The interface is based on TCP IP and supports various protocols For details see Chapter 10 1 2 LAN Interface on page 116 USB USBTMC USB vendor ID produc...

Page 116: ...d follow the SCPI syntax rules The instrument supports the SCPI version 1999 The SCPI standard is based on standard IEEE 488 2 and aims at the standardi zation of device specific commands error handling and the status registers The tuto rial Automatic Measurement Control A tutorial on SCPI and IEEE 488 2 from John M Pieper R S order number 0002 3536 00 offers detailed information on concepts and d...

Page 117: ...f SOUR FREQ 2GHz n VXI 11 viOpen TCPIP rssgu100a100010 inst0 INSTR viPrintf SOUR FREQ 2GHz n HiSLIP viOpen TCPIP rssgu100a100010 hislip0 INSTR viPrintf SOUR FREQ 2GHz n USBTMC viOpen USB 0x0aad 0x00ce 1000010 INSTR viPrintf SOUR FREQ 2GHz n Remote control program using instrument driver VISA available Figure 10 3 Remote control program using instrument driver VISA available Remote Control Interfac...

Page 118: ...e control program using instrument driver VISA not available Protocol Remote control program Socket rssgu_init TCPIP rssgu100a100010 5025 SOCKET rssgu_SetFrequency 2e9 PCIe rssgu_init PCIe 0x162f 0x132e 1000010 INSTR rssgu_SetFrequency 2e9 10 1 2 LAN Interface To be integrated in a LAN the instrument is equipped with a LAN interface consisting of a connector a network interface card and protocols ...

Page 119: ...of the Instrument on page 64 LAN device name defines the protocol and the instance number of a subinstru ment INSTR indicates the instrument resource class optional The IP address host address computer name is used by the programs to identify and control the instrument It is automatically assigned by the DHCP server the first time the device is registered on the network Alternatively you can also ...

Page 120: ...R The DNS host name is rssgu100a100021 the valid resource string is TCPIP rssgu100a100021 hislip0 HiSLIP TCPIP rssgu100a100021 inst0 VXI 11 A raw socket connection can be established using TCPIP 10 113 11 91 5025 SOCKET 10 1 2 2 HiSLIP Protocol The HiSLIP High Speed LAN Instrument Protocol is the successor protocol for VXI 11 for TCP based instruments specified by the IVI foundation The protocol u...

Page 121: ...le network communication using sockets The socket communication also referred to as Raw Ethernet communication does not require a VISA installation on the remote controller side The simplest way to establish socket communication is to use the built in telnet pro gram The telnet program is part of every operating system and supports communica tion with the software on a command by command basis Soc...

Page 122: ... a description of how to set up a remote control connection via PCIe and the permitted cables Via PCI Express some commands can be sent to the instrument with optimized speed memory mapped remote control e g frequency or level settings This allows mini mum setup time PCIe resource string The syntax of the used PCIe resource string is PCIe vendor ID product ID serial number INSTR where PCIe denotes...

Page 123: ...he controller must address the instrument with the GPIB bus channel GPIB provides channel addresses from 0 to 30 The GPIB resource string is GPIB address INSTR where GPIB denotes the used interface address indicates the used channel INSTR indicates the instrument resource class optional Note If the VISA implementation supports the GPIB interface you can optionally define the VISA instrument contro...

Page 124: ... main panel Instrument name Setup Remote Channels The Remote Channel Settings dialog shows all specified resource strings of the supported remote control interfaces 10 2 2 Example Remote Control over LAN Using Socket Communication This section provides an example on how to establish a remote control connection over telnet protocol and a simple sockets based program example that can be further deve...

Page 125: ... name of the R S SGU and the number of the port configured for remote control via telnet Tip The R S SGU uses the port number 5025 for remote connection via Telnet The connection to the instrument is set up and remote control commands can be sent 2 Even if the cursor is not visible on the screen enter blind a remote control com mand and confirm with Enter 10 3 Advanced Remote Control Using PCIe Th...

Page 126: ...ver possible currently only for the parameters frequency level RF state modulator state and sends SCPI messages in all other cases Remote control programs written for PCIe will without modifications also run if one of the other control channels LAN or USB is used 10 3 1 Setting Up a Remote Control Connection via PCIe To set up a remote control connection vie PCIe perform the following steps 1 Down...

Page 127: ... 3 3 1 Building and Installing the Hardware Driver The hardware driver defines the way to communicate with the instrument via PCIe interface For Windows operating systems the hardware driver is installed automatically together with the installation of the R S SGMA GUI software See also section Installation of R S SGMA GUI Software in the getting started man ual For Linux operating system the sourc...

Page 128: ...ve these two files to usr lib or lib directory Windows operating system To make the libraries accessible perform one of the following a Copy these two files to the folder of your executable b Copy these two files to the WINDOWS system32 folder 10 3 3 3 Building a Program The help file rssgu_vxi chm shows all functions of the instrument which you can use in your own remote control program An exampl...

Page 129: ...q Quit f value Set frequency f Query frequency l value Set level l Query level r value Set RF state value 0 1 ON OFF r Query RF state If you enter an additional optional command SguDriverDemo executes it and enters a loop waiting for further commands Example TCPIP 10 111 11 44 5025 SOCKET Lists the available commands 10 3 4 Connecting the Controller and the Instrument A PCIe connector is provided ...

Page 130: ...U as an upconverter to the R S SGS the R S SGS acts as a controller to the R S SGU For a description of how to connect the instruments refer to Chapter 5 2 Setups for Connecting an R S SGS and an R S SGU on page 41 10 3 5 Enabling Fast Settings To enable the special PCI express feature fast settings enable the function rssgu_UseFastSettings ViSession instrumentHandle ViBoolean fastEnabled ViBoolea...

Page 131: ...act the files on a remote PC as described in Chapter 10 3 2 Download the Drivers on page 124 Windows operating systems To set up a remote control connection via fast socket for Windows operating systems perform the following steps 1 Connect the controller and the instrument see Chapter 2 3 2 Connecting a Remote PC via LAN on page 22 2 Install the protocol driver to the controller see Chapter 10 4 ...

Page 132: ...operties to open the Local Area Connection Properties dialog 4 Click Install to open the Select Network Feature Type dialog 5 Select Protocol and select Add 6 In the Select Network Protocol dialog select Have Disk Navigate to the directory where the driver is saved and click OK to install the driver 10 4 3 Enabling Fast Settings To enable the fast settings for the fast socket call function rssgu_U...

Page 133: ... LxiWebIfc The LAN reset also resets the following parameters for the R S SGU Parameter Value Hostname Instrument specific host name Description Signal generator Negotiation Auto detect VXI 11 discovery Enabled The LAN settings are configured using the instrument s LXI Browser Settings 10 5 2 LXI Browser Settings To access the instrument via the web browser Note Do not add the missing zeros in the...

Page 134: ...Rohde Schwarz home page 10 5 3 LAN Configuration The LAN Configuration web page displays all mandatory LAN parameters and allows their modification It comprises the following navigation entries IP Configuration 132 Advanced Config 132 Ping Client 133 SCPI Remote Trace 133 10 5 3 1 IP Configuration The IP configuration web page displays all mandatory LAN parameters and allows their modification The...

Page 135: ... 3 3 Ping Client The Ping Client page provides the ping utility to verify the connection between the LXI compliant instrument and another device The ping is initiated from the instrument Using the ICMP echo request and echo reply packets the function checks whether the communication with a device via LAN is working Ping is useful for the diagnosis of IP network or router failures To initiate a pin...

Page 136: ...ns The following columns are available if no column filter is applied Rec record number of the message within the message log MT indicates the type of the message Possible values and related message contents are incoming command outgoing response to a query E error message highlighted by red color T execution time i e time required by the instrument to process the com mand internally I number of t...

Page 137: ...lled A typical configuration consists of one monitor controllers and instruments The moni tor is the remote PC on which the R S SGMA GUI is installed and the controller is the remote PC on which the application program runs Simultaneous control of an instrument from a controller and a monitor may lead to colli sions whenever both the controller and the monitor utilize the same remote channel These...

Page 138: ...ver two different hardware interfaces Figure 10 5 Example of a setup for remote control monitoring Connecting and configuring the monitoring PCs In the Setup Security Security Settings dialog check the state of the LAN and USB interfaces and enable them if necessary 1 Connect the monitoring PC to the instrument Note Choose the hardware interface considering the limitations described in Table 10 2 ...

Page 139: ...te Control Operation R S SGU100A 137 User Manual 1176 7726 02 09 5 Open the corresponding dialogs in the R S SGMA GUI Observe the status of the parameters Using the R S SGMA GUI to Monitor the Remote Control Operation ...

Page 140: ...ed as Return values Conformity Commands that are taken from the SCPI standard are indicated as SCPI con firmed All commands used by the R S SGU follow the SCPI syntax rules Asynchronous commands A command which does not automatically finish executing before the next com mand starts executing overlapping command is indicated as an Asynchronous command Reset values RST Default parameter values that ...

Page 141: ...mended to lock the instrument for remote control from the selected con troller prior to further configuration Use the LOCK command for this purpose 11 1 1 Performing General Tasks for Instrument Setup In the following example we assume that a remote PC is connected to the instrument the remote PC and the instrument are switched on and a connection between them is established Reset the instrument f...

Page 142: ...Tem EMODe EM1 Unlock the instrument UNL 12345 11 1 2 Generating an I Q Modulated Signal In the following example we assume that a remote PC is connected to the instrument the remote PC and the instrument are switched on and a connection between them is established An external analog signal is provided at the I and Q connectors of the instrument Reset the instrument first RST CLS Lock the instrumen...

Page 143: ...tion SOURce IQ STATe ON SOURce IQ IMPairment STATe ON SOURce IQ IMPairment LEAKage I 1 SOURce IQ IMPairment LEAKage Q 1 SOURce IQ IMPairment IQRatio 1 SOURce IQ IMPairment QUADrature ANGLe 2 SOURce IQ CREStfactor 0 05 Enable output of the generated signal at the RF connector OUTPut STATe ON OUTPut STATe PON UNCH Query LO frequency and power values and set LO LOSCillator FREQuency LOSCillator POWer...

Page 144: ...t to the controller LOCK 12345 Lock the instrument to avoid interference by other controllers Use an arbitrary number Response 1 Request granted i e the instrument is locked Abort program if request is refused Query the level that can be set without adjustments of the attenuator OUTPut AFIXed RANGe LOWer OUTPut AFIXed RANGe UPPer Optimizing the quality characteristics of the RF signal SOURce POWer...

Page 145: ...usting Network and Remote Channel Settings In the following example we assume that a remote PC is connected to the instrument the remote PC and the instrument are switched on and a connection between them is established Reset the instrument first RST CLS Lock the instrument to the controller LOCK 12345 Lock the instrument to avoid interference by other controllers Use an arbitrary number Response ...

Page 146: ...NETWork IPADdress MODE Response AUTO SYSTem COMMunicate NETWork IPADdress Response 10 113 10 187 SYSTem COMMunicate NETWork IPADdress SUBNet MASK Response 255 255 0 0 SYSTem COMMunicate NETWork IPADdress GATeway Response 10 113 0 1 Unlock the instrument UNL 12345 11 2 Common Commands Common commands are described in the IEEE 488 2 IEC 625 2 standard These commands have the same effect and are empl...

Page 147: ...alue Event status enable Sets the event status enable register to the specified value The query returns the con tents of the event status enable register in decimal form Parameters Value Range 0 to 255 ESR Event status read Returns the contents of the event status register in decimal form and then sets the reg ister to zero Return values Contents Range 0 to 255 Usage Query only IDN Identification ...

Page 148: ...ing commands have been executed which is useful for command synchronization OPT Option identification query Queries the options included in the instrument For a list of all available options and their description refer to the data sheet Return values Options The query returns a list of options The options are returned at fixed positions in a comma separated string A zero is returned for options th...

Page 149: ...memory using the command SAV with the associated number It also activates the instrument settings which are stored in a file and loaded using the MMEMory LOAD number file_name extension command RST Reset Sets the instrument to a defined default status The default settings are indicated in the description of commands The command is equivalent to SYSTem PRESet Usage Setting only SAV Number Save Stor...

Page 150: ...In particular TRG generates a manual trigger signal This common command complements the commands of the TRIGger subsystem Usage Event WAI Wait to continue Prevents servicing of the subsequent commands until all preceding commands have been executed and all signals have settled see also command synchronization and OPC Usage Event 11 3 General Commands REMote OPMode 148 LOCK 149 UNLock 149 REMote OP...

Page 151: ...lock from the controller with the specified Controller ID Return values Value Number 0 request refused the instrument is already locked to another Lock Request Id i e to another controller 1 request granted Example LOCK 12345 Response 1 UNL 12345 Usage Query only Manual operation See Exclusive Access on page 53 UNLock Unlock Id Unlocks an instrument locked to a controller with Controller ID Unlock...

Page 152: ...nction see Chapter 7 7 Pre set on page 87 Example SYST PRES All instrument settings also the settings that are not currently active are reset to their default values Usage Setting only SYSTem FPReset The command triggers an instrument reset to the original state of delivery Only func tions that are protected by a password remain unchanged The factory preset function resets nearly all instrument se...

Page 153: ...truments the remote PC and the instruments are switched on and a connection between them is established The selftest of an R S SGU also requires a similiar instrumental setup You can per form the selftest and read its results using the commands TEST ALL STARt and TEST ALL RESult Calibration process of the R S SGU Figure 11 1 Calibration process of the R S SGU No physical connections between the in...

Page 154: ...GU Response Interpretation 1 CALibration LEVel STARt R S SGU starts the Level Adjustment 2 CALibration HREQuest PROG CREate Level Adjustment To do create a progress bar with a caption Level Adjustment 3 CALibration HREQuest OUTP STATe 1 To do activate the RF output of the LO 4 CALibration HREQuest PROG UPDate 5 The progress of the level adjustment is 5 5 CALibration HREQuest SOUR FREQ 15e9 SOUR PO...

Page 155: ...h the instrument is compliant OUTP STATe Number Shows the state required of the local oscillator SOUR FREQ Number Shows the frequency required of the local oscillator SOUR POW Number Shows the power required of the external local oscillator PROG CREate Text Asks the controller to create a progress bar PROG REName Text Asks the controller to rename the progress bar PROG REMove Asks the controller t...

Page 156: ...Starts an adjustment for the I Q modulator of the current frequency The I Q modulator is adjusted with respect to carrier leakage I Q imbalance and quadrature Query the result of the adjustment with the SCPI command CALibration IQModulator LOCal RESult See Calibration process of the R S SGU on page 151 for a step by step description of the calibration process Usage Event CALibration IQModulator LO...

Page 157: ...ed Usage Query only CALibration LEVel TEMPerature Queries the delta temperature since the last level adjustment Return values Temperature string Usage Query only 11 6 CONNector Subsystem CONNector TRIGger OMODe 155 CONNector TRIGger OMODe Mode Sets the operating mode of the trigger connector Parameters Mode SVALid SNValid PEMSource SVALid SNValid signal valid not valid PEMSource external pulse mod...

Page 158: ...ostic POINt CATalog to retrieve a list of the available test points For description of the test points see the service manual Query parameters Name string Return values Value number Default unit V or C Example See Chapter 11 1 1 Performing General Tasks for Instrument Setup on page 139 Usage Query only 11 8 Fast Speed Commands This section describes special commands that allow a fast frequency and...

Page 159: ...ata Reference is made to this in the descriptions of the commands FORMat BORDer 157 FORMat DATA 158 FORMat SREGister 158 FORMat BORDer Border Determines the sequence of bytes within a binary block This only affects blocks which use the IEEE754 format internally Parameters Border NORMal SWAPped NORMal The instrument expects with setting commands and sends with queries the least significant byte of ...

Page 160: ... data formats are explained in the description of the parameter types RST ASCii Example FORM ASC The data is transferred as ASCII data FORMat SREGister Format Determines the numerical format which is returned when the status registers are quer ied Parameters Format ASCii BINary HEXadecimal OCTal ASCii The register content is returned as a decimal number BINary The register content is returned as a...

Page 161: ...e optional file extension are separated by a dot All letters and numbers are permitted numbers are however not permitted at the beginning of the file name If possible special characters should not be used The use of the slashes and should be avoided since they are used in file paths A number of names are reserved for the operating system e g CLOCK CON AUX COM1 COM4 LPT1 LPT3 NUL and PRN In the R S...

Page 162: ... file extensions in the instrument Function Contents File suffix R S SGMA GUI Save As Open Software settings savrcl 11 10 3 Examples In these examples the current instrument setting is stored in the file test savrcltxt in the directory var user Storing and Loading Current Settings 1 Store the current setting in an intermediate memory with the number 4 This setting can be called using command RCL a...

Page 163: ...er Response 2 2 To query the number of files in the current or specified directory perform MMEM CAT LENG usb user Response 3 3 Create a new subdirectory for mass memory storage in the specified directory MMEM MDIR usb new 4 Copy the file state to a new file MMEM COPY var user state savrcltxt usb new 5 Rename the file state MMEM MOVE state savrcltxt state_new savrcltxt 6 Remove the test directory M...

Page 164: ...e of the file Possible suffixes are ASCii BINary DIRectory SizeFileN Size of the file in bytes Example See Working with Files and Directories on page 160 Usage Query only MMEMory CATalog LENGth Path Returns the number of files in the current or in the specified directory Query parameters Path string String parameter to specify the directory If the directory is omit ted the command queries the cont...

Page 165: ...ve or absolute If DestinationFile is not specified the SourceFile is copied to the current directory queried with the MMEMory CDIRectory command Note Existing files with the same name in the destination direc tory are overwritten without an error message Example See Working with Files and Directories on page 160 Usage Setting only SCPI confirmed MMEMory DATA Filename BinaryBlock MMEMory DATA Filen...

Page 166: ...ns the subdirectories of a particular directory Query parameters path String parameter to specify the directory If the directory is omit ted the command queries the content of the current directory queried with MMEMory CDIRectory command Return values Catalog file_entry Names of the subdirectories separated by colons The first two strings are related to the parent directory Example See Working wit...

Page 167: ...emory ApplicMemKb integer Application memory HeapUsedKb integer Used heap memory HeapAvailableKb integer Available heap memory Usage Query only MMEMory LOAD STATe SavRclStateNumb file_name Loads the specified file stored under the specified name in an internal memory After the file has been loaded the instrument setting must be activated using an RCL command Setting parameters SavRclStateNumb Dete...

Page 168: ...e file to be moved DestinationFile string String parameters to specify the name of the new file Example See Working with Files and Directories on page 160 Usage Event SCPI confirmed MMEMory MSIS Msis Defines the drive or network resource in the case of networks for instruments with windows operating system using msis MSIS Mass Storage Identification String Note Instruments with Linux operating sys...

Page 169: ... 160 Usage Event 11 11 OUTPut Subsystem OUTPut AMODe 167 OUTPut STATe 167 OUTPut STATe PON 168 OUTPut AFIXed RANGe LOWer 168 OUTPut AFIXed RANGe UPPer 168 OUTPut hw PROTection CLEar 169 OUTPut AMODe AMode Sets the mode of the attenuator Attenuator MODe at the RF output Parameters AMode AUTO FIXed AUTO The attenuator is switched automatically The level settings are made in the full range FIXed The ...

Page 170: ...ed Example See Chapter 11 1 2 Generating an I Q Modulated Signal on page 140 Manual operation See Power On State on page 78 OUTPut AFIXed RANGe LOWer Queries the minimum level which can be set without the attenuator being adjusted Return values Lower float Default unit dBm Example See Chapter 11 1 3 Advanced Task for Optimizing Perform ance on page 142 Usage Query only Manual operation See Level R...

Page 171: ...system on page 172 for a descrip tion of the setting process Usage Event Manual operation See Confirm External LO Settings on page 86 SOURce FREQuency CW FIXed Cw Sets the RF frequency at the RF output connector of the instrument Parameters Cw float Range 1E 6 to 40E 9 Increment 1E 3 RST 1E 9 Example See Chapter 11 1 2 Generating an I Q Modulated Signal on page 140 Manual operation See Frequency o...

Page 172: ...IQRatio 170 SOURce IQ IMPairment LEAKage I 171 SOURce IQ IMPairment LEAKage Q 171 SOURce IQ IMPairment QUADrature ANGLe 171 SOURce IQ IMPairment STATe 172 SOURce IQ CREStfactor 172 SOURce IQ STATe State Switches the I Q modulation on and off Parameters State 0 1 OFF ON RST 0 Example See Chapter 11 1 2 Generating an I Q Modulated Signal on page 140 Options R S SGU B120V B140V Manual operation See M...

Page 173: ...e I signal Q signal component Parameters Q float Range 5 to 5 Increment 0 01 RST 0 Default unit PCT Example See Chapter 11 1 2 Generating an I Q Modulated Signal on page 140 Options R S SGU B120V B140V Manual operation See Offset on page 83 SOURce IQ IMPairment QUADrature ANGLe Angle Sets the quadrature offset for the digital I Q signal Parameters Angle float Range 8 to 8 Increment 0 01 RST 0 Defa...

Page 174: ...ignal generator the R S SGU acts as an extension to the signal generator extending its frequency range In this setup a controller does not need to access the R S SGU directly Instead the signal generator acts as a controller to the R S SGU and depending on the required output signal parameters performs all required settings automatically For example if the signal generator is set to an output freq...

Page 175: ... SGU with the SCPI commands SOURce LOSCillator FREQuency and SOURce LOSCillator POWer 3 Interpret the result and apply the required changes to the LO 4 Send the SCPI command SOURce SETTings APPLy IMMediate to R S SGU to output the signal See Chapter 11 1 3 Advanced Task for Optimizing Performance on page 142 for an example SOURce LOSCillator FREQuency 173 SOURce LOSCillator POWer 173 SOURce LOSCil...

Page 176: ...stic 176 SOURce POWer LEVel IMMediate AMPLitude 176 SOURce POWer LEVel IMMediate OFFSet 176 SOURce POWer LIMit AMPLitude 177 SOURce POWer PEP 177 SOURce POWer POWer 177 SOURce POWer RANGe LOWer 178 SOURce POWer RANGe UPPer 178 SOURce POWer ALC STATe State Activates deactivates the automatic level control Parameters State 1 OFFTable ONTable ON RST ONTable Manual operation See State on page 79 SOURc...

Page 177: ...ps the output impedance constant during RF off RST MAX Manual operation See RF Off Mode on page 77 SOURce POWer ATTenuation SOVer OFFSet Offset Sets the switch over offset value of the attenuator Parameters Offset float RST 0 Manual operation See SATT Switch Over Offset on page 77 SOURce POWer LMODe LevMode Selects the level mode Parameters LevMode NORMal LNOise LDIStortion NORMal automatic select...

Page 178: ...Amplitude float Range 120 to 25 Increment 0 01 RST 10 Example See Chapter 11 1 3 Advanced Task for Optimizing Perform ance on page 142 Manual operation See Level Level Offset on page 60 SOURce POWer LEVel IMMediate OFFSet Offset Specifies the constant level offset of a downstream attenuator amplifier If a level offset is entered the level entered with SOURce POWer POWer no longer corresponds to th...

Page 179: ...the RF signal s peak envelope power at the DUT Return values PEP float Range 120 to 25 Increment 0 01 RST 10 Example see Chapter 11 1 3 Advanced Task for Optimizing Perform ance on page 142 Usage Query only Manual operation See PEP on page 60 SOURce POWer POWer Power Sets the level at the RF output connector This value does not consider a specified offset The command SOURce POWer LEVel IMMediate O...

Page 180: ...SOURce hw PULM STATe State Activates the pulse modulation Parameters State 0 1 OFF ON RST 0 Example PULM STAT ON activates pulse modulation Manual operation See State on page 85 SOURce hw PULM POLarity Polarity Sets the polarity of the pulse modulator signal This command is effective only for an external modulation signal Parameters Polarity NORMal INVerted NORMal The RF signal is suppressed durin...

Page 181: ...on EVENt 180 STATus OPERation NTRansition 180 STATus OPERation PTRansition 180 STATus PRESet 180 STATus QUEStionable CONDition 181 STATus QUEStionable ENABle 181 STATus QUEStionable EVENt 181 STATus QUEStionable NTRansition 181 STATus QUEStionable PTRansition 182 STATus QUEue NEXT 182 STATus OPERation CONDition Quieries the content of the CONDition part of the STATus OPERation register This part c...

Page 182: ...nsition string Example STAT OPER NTR 0 a transition from 1 to 0 in the condition part of the Status Opera tion register does not cause an entry to be made in the EVENt part STATus OPERation PTRansition Ptransition Sets the bits of the PTRansition part of the STATus OPERation register If a bit is set a transition from 0 to 1 in the condition part causes an entry to be made in the EVENt part of the ...

Page 183: ...byte These events can be used for a service request If a bit in the ENABle part is 1 and the correesponding EVENt bit is true a positive transition occurs in the summary bit This transition is reportet to the next higher level Parameters Enable string Example STAT QUES ENAB 1 Problems when performing an adjustment cause an entry to be made in the sum bit STATus QUEStionable EVENt Event Queries the...

Page 184: ...ter cause an entry to be made in the EVENt part STATus QUEue NEXT Queries the oldest entry in the error queue and then deletes it Positive error numbers denote device specific errors and negative error numbers denote error messages defined by SCPI If the error queue is empty 0 No error is returned The command is identical to SYSTem ERRor NEXT on page 185 Return values Next string Example STATus QU...

Page 185: ...189 SYSTem COMMunicate SERial RESource 189 SYSTem COMMunicate SERial BAUD 190 SYSTem COMMunicate SERial PARity 190 SYSTem COMMunicate SERial SBITs 190 SYSTem COMMunicate USB RESource 190 SYSTem HARDware ASSembly dir SNUMber 191 SYSTem MMEMory PATH USER 191 SYSTem OSYStem 191 SYSTem REBoot 191 SYSTem RESTart 191 SYSTem SHUTdown 192 SYSTem PROTect ch STATe 192 SYSTem STARtup COMPlete 192 SYSTem EMOD...

Page 186: ...es in the error queue and then deletes them Return values All string Returns the error numbers To retrieve the entire error text send the command SYSTem ERRor ALL 0 No error i e the error queue is empty Positive value Positive error numbers denote device specific errors Negative value Negative error numbers denote error messages defined by SCPI Example SYST ERR CODE ALL Queries all entries in the ...

Page 187: ...nly SYSTem ERRor NEXT Queries the error event queue for the oldest item and removes it from the queue Return values Next string Error event_number Error event_description Device depend ent info Error number and a short description of the error If the queue is empty the response is 0 No error Positive error numbers are instrument dependent Negative error numbers are reserved by the SCPI standard Vo...

Page 188: ...ery only SYSTem VERSion Queries the SCPI version the instrument s command set complies with Return values Version string Example SYST VERS queries the SCPI version Response 1996 The instrument complies with the SCPI version from 1996 Usage Query only SYSTem COMMunicate NETWork IPADdress IpAddress Sets the IP address Parameters IpAddress string Range 0 0 0 0 to ff ff ff ff Example SYSTem COMMunicat...

Page 189: ... Usage Event SYSTem COMMunicate NETWork STATus Queries the network configuration state Return values State 0 1 OFF ON Usage Query only SYSTem COMMunicate NETWork COMMon HOSTname Hostname Sets the individual host name of the R S SGU Note it is recommended that you do not change the host name in order to avoid prob lems with the networdk connection However if you change the host name be sure to use ...

Page 190: ...NETWork IPADdress SUBNet MASK 255 255 0 0 determines the subnet mask Manual operation See Subnet Mask on page 99 SYSTem COMMunicate NETWork RESource Queries the VISA resource string used for remote control of the instrument with VXI 11 protocol Return values Resource string Example SYSTem COMMunicate NETWork RESource Response TCPIP 192 1 2 3 INSTR Usage Query only Manual operation See Visa Resourc...

Page 191: ...YSTem COMMunicate SOCKet PORT 5030 specifies the socket port number Manual operation See SCPI Port on page 55 SYSTem COMMunicate SOCKet RESource Queries the VISA resource string for remote control via LAN interface using TCP IP socket protocol Return values Resource string Example SYSTem COMMunicate SOCKet RESource Response TCPIP 10 113 1 150 5025 SOCKET Usage Query only Manual operation See Visa ...

Page 192: ...D EVEN RST n a factory preset NONE Example SYST COMM SER PAR NONE Selects parity NONE SYSTem COMMunicate SERial SBITs SBits Sets the number of stop bits for the serial remote control interface Parameters SBits 1 2 RST n a factory preset 1 Example SYST COMM SER SBIT 2 Selects 2 stop bits SYSTem COMMunicate USB RESource Queries the VISA resource string for remote control via the USB interface Return...

Page 193: ...n page 90 SYSTem MMEMory PATH USER Queries the user directory that means the directory the instrument stores user files on Return values PathUser string Example SYSTem MMEMory PATH USER Response var user Usage Query only SYSTem OSYStem Queries the operating system of the instrument Return values OperSystem string Example SYSTem OSYStem Response Linux Usage Query only SYSTem REBoot Restarts the fir...

Page 194: ...sword for the first level is 123456 Example to activate protection level SYSTem PROTect1 STATe 1 internal adjustments or hostname cannot be changed to unlock protection level 1 SYSTem PROTect1 STATe 0 123456 internal adjustments are accessible SYSTem STARtup COMPlete Queries if the startup of the instrument is completed Return values Complete 0 1 OFF ON RST 0 Example SYST STAR COMP 1 the startup o...

Page 195: ...ue Improper use can destroy the assembly The respective hardware assembly responds directly to the TEST DIRect command any safety mechanisms are bypassed The command is intended for servicing purpo ses and should be used only by the Rohde Schwarz service personnel TEST ALL STARt 193 TEST ALL RESult 193 TEST KEYBoard STATe 193 TEST ALL STARt Starts a selftest Use the command TEST ALL RESult to quer...

Page 196: ...unit for power parameters This setting affects the GUI as well as all remote control commands that determine power values Parameters Power V DBUV DBM RST DBM Example UNIT POW V sets V as a default unit for all commands which determine power values 11 21 List of R S SGU Commands CALibration HREQuest 153 CALibration IQModulator LOCal RESult 154 CALibration IQModulator LOCal STARt 154 CALibration IQM...

Page 197: ...tion NTRansition 180 STATus OPERation PTRansition 180 STATus OPERation EVENt 180 STATus PRESet 180 STATus QUEStionable CONDition 181 STATus QUEStionable ENABle 181 STATus QUEStionable NTRansition 181 STATus QUEStionable PTRansition 182 STATus QUEStionable EVENt 181 STATus QUEue NEXT 182 SYSTem COMMunicate HISLip RESource 188 SYSTem COMMunicate NETWork IPADdress 186 SYSTem COMMunicate NETWork IPADd...

Page 198: ... SYSTem STARtup COMPlete 192 SYSTem VERSion 186 TEST ALL RESult 193 TEST ALL STARt 193 TEST KEYBoard STATe 193 UNIT ANGLe 194 UNIT POWer 194 UNLock 149 SOURce FREQuency CW FIXed 169 SOURce IQ CREStfactor 172 SOURce IQ IMPairment IQRatio 170 SOURce IQ IMPairment LEAKage I 171 SOURce IQ IMPairment LEAKage Q 171 SOURce IQ IMPairment QUADrature ANGLe 171 SOURce IQ IMPairment STATe 172 SOURce IQ STATe ...

Page 199: ...et 176 SOURce POWer LEVel IMMediate AMPLitude 176 SOURce SETTings APPLy IMMediate 169 SOURce TRAits COUNt 170 SOURce TRAits ch 169 SOURce hw PULM POLarity 178 SOURce hw PULM STATe 178 CLS 145 ESE 145 ESR 145 IDN 145 IST 146 OPC 146 OPT 146 PRE 146 PSC 146 RCL 147 RST 147 SAV 147 SRE 147 STB 148 TRG 148 WAI 148 List of R S SGU Commands ...

Page 200: ...ith the instrument can lead to electric shock Before cleaning the instru ment other than with a dry cloth make sure that the instrument is switched off and dis connected from all power supplies Instrument damage caused by cleaning agents Cleaning agents contain substances such as solvents thinners acetone etc acids bases or other substances Solvents can damage the front panel labeling plastic part...

Page 201: ...sheet If the instrument is to be stored for a longer period of time it must be protected against dust Repack the instrument as it was originally packed when transporting or shipping The two protective foam plastic parts prevent the control elements and connectors from being damaged The antistatic packing foil avoids any undesired electrostatic charging to occur If you do not use the original packa...

Page 202: ... the instrument The states are indicated for information only and do not neces sitate any action by the user Status Information displayed in the Info line AttFixed Attenuator fixed mode is active The uninterrupted level settings are made in a fixed range without attenuator switching The variation range is set automatically when this mode is activated The range is dis played with the parameter SGMA...

Page 203: ...ination the message automatically disappears and is also recorded in the history SCPI command SYSTem SERRor 13 3 SCPI Error Messages The SCPI error messages are the same in all SCPI instruments Detailed information and an overview of all error messages as defined in SCPI standard can be found in the corresponding documentation The errors are assigned negative numbers The error text being entered i...

Page 204: ...M data 204 Driver initialization failed Initialization of a driver fails when booting the instrument firmware The driver is not compatible with the hardware or software config uration of the instrument 241 No current list There is no list selected To execute the required opera tion a list has to be selected in the related dialog If no list is available a new list must be cre ated 242 Unknown list ...

Page 205: ...hat is not valid for the file type Check the file extension The file extension determines the data that is valid for this file type If the file extension is changed the lists are no longer recognized and the data are therefore inva lid 468 Cannot find directory Required folder cannot be found Check drive and path 469 No files found Folder is empty Device Specific Error Messages ...

Page 206: ...re different types of instrument messages depending on the direction they are sent Commands Instrument responses Commands Commands program messages are messages the controller sends to the instrument They operate the instrument functions and request information The commands are subdivided according to two criteria According to the effect they have on the instrument Setting commands cause instrumen...

Page 207: ...o to Local Transition to the local state manual control The instrument automatically returns to remote state when a remote command is sent UNLESS NREN was sent before GTR Go to Remote Enables automatic transition from local state to remote state by a subsequent remote command after NREN was sent GET Group Execute Trigger Triggers a previously active instrument function e g a sweep The effect of th...

Page 208: ...nt identification string A 3 2 Syntax for Device Specific Commands Not all commands used in the following examples are necessarily implemented in the instrument For demonstration purposes only assume the existence of the following commands for this section DISPlay WINDow 1 4 MAXimize Boolean FORMat READings DATA type length HCOPy DEVice COLor Boolean HCOPy DEVice CMAP COLor RGB red green blue HCOP...

Page 209: ...ntries without a suffix are interpreted as having the suffix 1 Example Definition HCOPy PAGE DIMensions QUADrant N Command HCOP PAGE DIM QUAD2 This command refers to the quadrant 2 Different numbering in remote control For remote control the suffix may differ from the number of the corresponding selec tion used in manual operation SCPI prescribes that suffix counting starts with 1 Suffix 1 is the ...

Page 210: ...e g blank The parameters required for each command and the allowed range of values are specified in the command description Allowed parameters are Numeric Values 208 Special Numeric Values 209 Boolean Parameters 210 Text Parameters 210 Character Strings 210 Block Data 210 A 3 3 1 Numeric Values Numeric values can be entered in any form i e with sign decimal point and exponent Values exceeding the ...

Page 211: ...ep The step width can be specified via an allocated step command for each parameter which can be set via UP and DOWN INF and NINF INFinity and negative INFinity NINF represent the numeric values 9 9E37 or 9 9E37 respectively INF and NINF are only sent as instrument respon ses NAN Not A Number NAN represents the value 9 91E37 NAN is only sent as a instrument response This value is not defined Possi...

Page 212: ...pe Query HCOP PAGE ORI Response LAND A 3 3 5 Character Strings Strings must always be entered in quotation marks or Example HCOP ITEM LABel Test1 HCOP ITEM LABel Test1 A 3 3 6 Block Data Block data is a format which is suitable for the transmission of large amounts of data For example a command using a block data parameter has the following structure FORMat READings DATA 45168xxxxxxxx The ASCII ch...

Page 213: ... mnemonics of a command The semicolon separates two commands of a command line It does not alter the path The comma separates several parameters of a command The question mark forms a query The asterisk marks a common command Quotation marks introduce a string and terminate it both single and double quotation marks are possible The hash symbol introduces binary octal hexadecimal and block data Bin...

Page 214: ...e two following commands with identical meaning can be created SENS BAND RES 1 SENS BWID RES 1 Mnemonics in square brackets are optional and may be inserted into the header or omitted Example HCOPy IMMediate HCOP IMM is equivalent to HCOP Parameters in curly brackets are optional and can be inserted once or several times or omitted Example SENSe LIST FREQuency numeric_value numeric_value The follo...

Page 215: ...ing to SCPI the responses to queries are partly subject to stricter rules than in standard IEEE 488 2 The requested parameter is transmitted without a header Example HCOP PAGE ORI Response LAND Maximum values minimum values and all other quantities that are requested via a special text parameter are returned as numeric values Example SENSe FREQuency STOP MAX Response 3 5E9 Numeric values are outpu...

Page 216: ...a cer tain order each command must be sent in a separate command line As a general rule send commands and queries in different program messages A 4 1 Preventing Overlapping Execution To prevent an overlapping execution of commands one of the commands OPC OPC or WAI can be used All three commands cause a certain action only to be carried out after the hardware has been set The controller can be for...

Page 217: ... Wait for a service request The service request indicates that the overlapped command has finished Event status register ESE 1 Set the OPC mask bit bit no 0 in the ESE ESE 1 2 Send the overlapped command without OPC OPC or WAI 3 Poll the operation complete state periodically with a timer using the sequence OPC ESR A return value LSB of 1 indicates that the overlapped command has finished A 5 Statu...

Page 218: ...d Event Status Summary Bit MAV Message Available in Output Queue QUES Questionable Status Summary Bit 2 Error Event Queue 1 0 not used Note This legend explains the abbreviations to the Status Byte Register The R S SGU uses the following status registers Status Byte STB and Service Request Enable SRE see Chapter A 5 3 Sta tus Byte STB and Service Request Enable Register SRE on page 219 Status Repo...

Page 219: ...in the overview Error Event Queue The error event queue contains all errors and events that have occurred in the past When reading the queue the instrument starts with the first occurred error event All status registers have the same internal structure SRE ESE The service request enable register SRE can be used as ENABle part of the STB if the STB is structured according to SCPI By analogy the ESE...

Page 220: ...d NTR bit decides whether the EVENt bit is set to 1 NTR bit 1 the EVENt bit is set NTR bit 0 the EVENt bit is not set This part can be written into and read as required Its contents are not affected by reading EVENt The EVENt part indicates whether an event has occurred since the last reading it is the memory of the condition part It only indicates events passed on by the transition filters It is ...

Page 221: ...n informative error mes sage This procedure is to be recommended since it considerably reduces the problems involved with remote control 3 QUEStionable status register summary bit The bit is set if an EVENt bit is set in the QUEStionable status register and the associated ENABle bit is set to 1 A set bit indicates a questionable instrument status which can be speci fied in greater detail by queryi...

Page 222: ...nce cannot be executed 3 Device dependent Error This bit is set if a device dependent error occurs An error message with a number between 300 and 399 or a positive error number which denotes the error in greater detail is entered into the error queue 4 Execution Error This bit is set if a received command is syntactically correct but cannot be performed for other reasons An error message with a nu...

Page 223: ...stem is to monitor the status of one or several devices in a measuring system To do this and react appropriately the controller must receive and evaluate the information of all devices The following standard methods are used Service request SRQ initiated by the instrument Serial poll of all devices in the bus system initiated by the controller to find out who sent an SRQ and why Query of a specifi...

Page 224: ...oller A 5 7 3 Query of an instrument status Each part of any status register can be read using queries There are two types of commands The common commands ESR IDN IST STB query the higher level registers The commands of the STATus system query the SCPI registers STATus QUEStionable The returned value is always a decimal number that represents the bit pattern of the queried register This number is ...

Page 225: ...ommand processing and input buffer Yes Yes Yes 1 The first command in a command line that immediately follows a PROGRAM MESSAGE TERMINA TOR clears the output buffer A 6 General Programming Recommendations Initial instrument status before changing settings Manual operation is designed for maximum possible operating convenience In con trast the priority of remote control is the predictability of the...

Page 226: ...lfunction The program should react appropriately to the service request Error queues The error queue should be queried after every service request in the controller pro gram as the entries describe the cause of an error more precisely than the status regis ters Especially in the test phase of a controller program the error queue should be queried regularly since faulty commands from the controller...

Page 227: ...etinet in h using namespace std typedef struct sockaddr_in SockAddrStruct typedef struct hostent HostInfoStruct class TcpClient public TcpClient TcpClient void connectToServer string hostname int port void disconnect void transmit string txString void receive string rxString string getCurrentHostName const int getCurrentPort const private string currentHostName int currentPort int currentSocketDes...

Page 228: ...int receiveBufferSize include netdb h include netinet in h include unistd h include TcpClient h TcpClient TcpClient currentHostName currentPort 0 currentSocketDescr 0 serverAddress currentHostInfo NULL clientIsConnected false receiveBufferSize 1024 TcpClient TcpClient currentHostInfo NULL void TcpClient connectToServer string hostname int port currentHostInfo gethostbyname hostname c_str if curren...

Page 229: ...g can t connect server n clientIsConnected true void TcpClient disconnect if clientIsConnected close currentSocketDescr currentSocketDescr 0 currentHostName currentPort 0 currentHostInfo NULL clientIsConnected false void TcpClient transmit string txString if clientIsConnected throw string connection must be established before any data can be sent n char transmitBuffer new char txString length 1 me...

Page 230: ...ile receiving data n rxString string receiveBuffer receiving receivedByteCount receiveBufferSize delete receiveBuffer string TcpClient getCurrentHostName const return currentHostName int TcpClient getCurrentPort const return currentPort TelnetClient cpp include iostream include TcpClient h void printUsage cout usage EthernetRawCommand server ip scpi command endl int main int argc char argv int err...

Page 231: ...1024 if useSingleCommand input singleCommand send string else cin getline buffer 1024 input buffer if input end terminate true if terminate client transmit input send string int qPos input find 0 receive string only when needed if qPos 0 string rcStr client receive rcStr cout rcStr endl if useSingleCommand terminate true catch const string errorString cout errorString endl client disconnect return...

Page 232: ...1 Brochures 12 C Case sensitivity SCPI 207 Change password 95 Cleaning 198 Clear status Remote 145 Colon 211 Comma 211 Command sequence recommendation 223 Remote 148 Commands 204 Brackets 211 Colon 211 Comma 211 Command line structure 212 Common 204 Double dagger 211 Instrument control 204 Overlapping 214 Question mark 211 Quotation mark 211 SCPI confirmed 204 Sequential 214 Syntax elements 211 Ve...

Page 233: ...0 External reference Connector 31 F Factory preset 101 Factory recovery See service manual 111 Fast settings 124 128 File list 162 Firmware update Select package 97 Several instruments 110 Update all 97 Firmware version 92 Floating licenses 92 Frequency 60 73 Limit to 6GHz 102 Frequency range extension 104 Function check 19 G Gain impairment 80 Gain imbalance 80 Gateway 100 Getting started 11 GPIB...

Page 234: ...ration 132 LAN configuration 132 Ping 133 Remote trace SCPI 133 Reset LCI 131 M Maintenance Accept 97 Operation 97 Malfunctions reacting 224 MAX 209 Message 56 Additional information 66 All messages 67 Brief 66 Deleting 66 Deleting all 66 Deleting brief 66 Displaying 66 Error 66 Message level 56 Messages Commands 204 Instrument 204 Instrument responses 205 Interface 204 MIMO Connector 31 MIN 209 M...

Page 235: ... Connect 113 Programming examples 138 Remote trace LXI 133 Rename File 166 Reset instrument settings 19 Reset values Remote 147 Resource string VISA 117 Resource strings 100 Restart 107 Restart network 98 RF frequency 73 RF level 74 Mode 75 RF ON Key 28 RF OUT Connector 31 RF output level 60 74 S Safety instructions 12 Save instrument settings 147 167 Save intermediate 147 SCPI Error messages 201 ...

Page 236: ...207 Syntax elements SCPI 211 System directory 159 T Telnet 113 Text paramters in remote commands 210 TRIG connector Signal 85 87 Trigger Connector 31 Event remote 148 Trigger connector mode 85 87 U UP 209 Update package Error 111 Updating R S SGMA GUI 21 USB Connecting 26 Connector 30 Interfaces 119 USB device 96 USB install See service manual 111 User manual 11 User name 95 V Vertical stroke 211 ...

Reviews: