®
R&S
QuickStep
Test Executive Software
User Manual
(;ÛÌG2)
1177622302
Version 11
User Manual
This manual applies to the following options:
●
R&S QuickStep Test Executive Software (1528.9010.02)
●
Development option for R&S QuickStep Test Executive Software
(1528.9026.02)
●
R&S QuickStep license dongle and key card (1528.9003.02)
The firmware of the instrument uses several valuable open source software packages. For information,
see the "Open Source Acknowledgment" document, which is available for download from the customer
web section on GLORIS, the global Rohde & Schwarz information system: https://extranet.rohde-
schwarz.com.
Rohde & Schwarz would like to thank the open source community for their valuable contribution to embedded computing.
© 2019 Rohde & 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.
1177.6223.02 | Version 11 | R&S®QuickStep
The following abbreviations are used throughout this manual: R&S® is abbreviated as R&S.
R&S®QuickStep
Contents
Contents
1 Welcome................................................................................. 9
1.1 Key Features......................................................................................... 9
1.2 Software Components, Product Licensing.......................................11
1.3 Documentation....................................................................................12
1.4 Typographic Conventions.................................................................. 13
1.5 Using the Help.....................................................................................14
1.5.1 Accessing the Help............................................................................... 14
1.5.2 Navigating in the Help...........................................................................15
2 What's New...........................................................................16
3 Introduction to QuickStep...................................................20
3.1 Typical Test Setup...............................................................................20
3.2 Graphical User Interface.................................................................... 21
3.2.1 Test Execution.......................................................................................22
3.2.2 Test Plan Editor.....................................................................................23
3.2.3 Results Viewer...................................................................................... 24
3.2.4 Test Procedure Editor........................................................................... 26
3.2.5 System Configurator............................................................................. 27
3.3 Block Function Development............................................................ 29
4 Concepts.............................................................................. 30
4.1 Test Structures and Their Relations..................................................30
4.2 Test Project..........................................................................................32
4.3 Test Execution Phases....................................................................... 33
4.4 Test Plans............................................................................................ 35
4.4.1 Test Sequence with Several Test Procedures.......................................36
3User Manual 1177.6223.02 ─ 11
R&S®QuickStep
4.4.2 Single-Line Sweep................................................................................ 36
4.5 Test Procedures.................................................................................. 38
4.5.1 Blocks & Connectivity........................................................................... 39
4.5.2 More about Test Execution Phases...................................................... 40
4.5.3 Block Functions.....................................................................................42
4.5.4 Connections between Block Functions, Control Structures.................. 45
4.5.5 Parallel and Synchronized Test Execution ...........................................48
4.6 System Configuration.........................................................................50
4.7 Setting Parameter Values by References......................................... 52
4.8 Handling of RF Attenuations............................................................. 57
4.8.1 General Methods.................................................................................. 58
Contents
4.8.2 Compensation of RF Attenuations via System Configuration Paths.....59
4.9 Limit Handling..................................................................................... 61
4.10 DUT Handling...................................................................................... 66
4.11 Result Handling...................................................................................71
4.11.1 Charts................................................................................................... 71
4.11.2 Live View Results..................................................................................72
4.11.3 Reports................................................................................................. 73
5 Preparing for Use.................................................................85
5.1 Required Hardware, Software and Firmware................................... 85
5.2 Installation........................................................................................... 87
5.2.1 Licensing Tasks.....................................................................................87
5.2.2 Installing QuickStep.............................................................................. 90
5.2.3 Installing Optional Software and Firmware........................................... 92
5.2.4 Updating License Keys......................................................................... 93
5.3 Network Configuration....................................................................... 95
5.4 Determining Input and Output Attenuations.................................... 97
4User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Contents
6 Operation..............................................................................99
6.1 Starting QuickStep..............................................................................99
6.2 Executing a Test Project...................................................................101
6.3 Adding a Parameter Sweep to a Test Plan......................................103
6.4 Setting Values by Reference............................................................ 104
6.4.1 Reference to a Test Procedure Parameter......................................... 104
6.4.2 Reference to a Test Project Parameter...............................................106
6.4.3 Reference to a Result Parameter....................................................... 106
6.4.4 Other References................................................................................108
6.5 Using a Block Function Result as Input for Another Block Function
............................................................................................................ 108
6.6 Building a Test Procedure................................................................ 110
6.7 Evaluating Test Results.................................................................... 111
6.8 Building a System Configuration.................................................... 113
6.9 Using System Configuration Parameters....................................... 114
6.10 Displaying a Result Curve in a Chart.............................................. 116
6.11 Showing Live View Results.............................................................. 119
6.12 Creating a Report Definition............................................................ 120
6.13 Creating or Modifying a Style Sheet for Reports........................... 123
6.14 Setting Up a Report Including a Subreport.................................... 125
6.15 Using a Shortcut for Test Execution............................................... 127
6.16 Getting Support on Problems..........................................................128
7 Block Development........................................................... 129
7.1 Block Development Concepts......................................................... 130
7.1.1 Block Definition................................................................................... 130
7.1.2 Programming Structures..................................................................... 133
7.1.3 Call and Reply of Block Functions...................................................... 136
5User Manual 1177.6223.02 ─ 11
R&S®QuickStep
7.1.4 Code Implementation..........................................................................140
7.1.5 Device Parameters............................................................................. 146
7.1.6 Extension Blocks.................................................................................148
7.1.7 Block Functions for Direct DLL Call (C# only).....................................150
7.1.8 Quality Control, Logging, Exception/Error Handling........................... 156
7.1.9 Script Block Functions........................................................................ 161
7.1.10 User-Defined GUI............................................................................... 166
7.2 Procedures Related to Block Development................................... 169
7.2.1 Overview: Implementation of New Functionality ................................ 170
7.2.2 Creating a New Block and Adding a Function.................................... 172
7.2.3 Calling a Block Function from Another Block......................................175
Contents
7.2.4 Using Device Parameters................................................................... 178
7.2.5 Developing Block Functions for Direct DLL Call................................. 180
7.2.6 Debugging During Block Development............................................... 185
7.2.7 Debugging During Test Execution.......................................................187
7.2.8 Running QuickStep in Command Line Mode......................................190
7.2.9 Re-Using an R&S Forum Script.......................................................... 190
7.2.10 Creating and Integrating a User-Defined GUI.....................................195
8 Application Examples....................................................... 197
8.1 Calculator.......................................................................................... 198
8.1.1 Test Procedure....................................................................................198
8.1.2 Results................................................................................................ 198
8.2 Control Statements...........................................................................199
8.3 DC PowerSupplies............................................................................ 200
8.3.1 Test Setup and Usage of Components............................................... 201
8.3.2 Test Procedure....................................................................................201
8.4 Dual Instance Power Sensors..........................................................202
6User Manual 1177.6223.02 ─ 11
R&S®QuickStep
8.4.1 Test Setup and Usage of Components............................................... 202
8.4.2 Test Procedure....................................................................................202
8.5 Forum Scripting................................................................................ 203
8.6 Fourier................................................................................................204
8.7 Matlab Scripting................................................................................ 205
8.8 Network Analyzer..............................................................................207
8.8.1 Test Setup and Usage of Components............................................... 207
8.8.2 Test Procedure....................................................................................207
8.8.3 Test Plan, Results............................................................................... 208
8.9 OSP Switching Unit.......................................................................... 209
8.9.1 Test Setup and Usage of Components............................................... 209
Contents
8.9.2 Test Procedure....................................................................................209
8.9.3 Results................................................................................................ 210
8.10 Reporting........................................................................................... 211
8.11 RTO Oscilloscope............................................................................. 211
8.11.1 Test Setup........................................................................................... 211
8.11.2 Test Procedure....................................................................................212
8.12 Signal Analyzer................................................................................. 212
8.12.1 Test Procedure....................................................................................212
8.13 Visualization...................................................................................... 215
8.14 Positioner Block Solution................................................................ 216
9 Reference........................................................................... 217
9.1 Graphical User Interface (GUI).........................................................217
9.1.1 Top Menu Bar......................................................................................217
9.1.2 General GUI Features.........................................................................219
9.1.3 Test Execution.....................................................................................224
9.1.4 Testplan Editor.................................................................................... 227
7User Manual 1177.6223.02 ─ 11
R&S®QuickStep
9.1.5 Results Viewer.................................................................................... 242
9.1.6 Test Procedure Editor......................................................................... 249
9.1.7 System Configurator........................................................................... 264
9.2 Command Line Interface (CLI).........................................................270
9.3 Block Development Tool.................................................................. 273
9.3.1 Block Generator.................................................................................. 273
9.3.2 Block Definition File Editor.................................................................. 276
9.3.3 Tabs within the Block Definition File Editor......................................... 278
9.3.4 Info Window........................................................................................ 285
9.4 Block Library..................................................................................... 285
9.4.1 Instrument Blocks............................................................................... 285
Contents
9.4.2 Other Blocks....................................................................................... 292
9.4.3 Special Parameter Groups..................................................................307
Annex..................................................................................308
A File Extensions and File Locations..................................308
B Supported Test Instruments............................................. 310
C MIPI RFFE Communication............................................... 311
C.1 Installing the SignalCraft Scout Driver........................................... 314
D Control Interfaces and Protocols..................................... 316
Glossary: Abbreviations and Terms................................ 318
Index................................................................................... 323
8User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Welcome
Key Features
1 Welcome
Welcome to the R&S QuickStep Test Executive software! QuickStep provides a
high-speed test sequencer in combination with a powerful graphical user interface
for the parameterization and control of test execution. Test procedures are
designed in a graphical editor as flow charts based on the provided or additionally
developed test functions.
QuickStep lets you set up and run test plans – sequences of individual tests
together with scheduling and execution information –, to build test procedures and
to evaluate the test results. During test execution, QuickStep controls the test
equipment.
QuickStep includes example test projects for typical test conditions and hardware
setups. It offers facilities to adapt given test plans and their execution schedules
and to develop new ones. Customer extensions can easily be integrated, e.g. for
exploiting or developing special test algorithms.
If you only use the QuickStep OTA basic application (installed with QuickStep,
QS-ATSCAL license required), most test executive features are hidden at the GUI
but used in the background. For details, see the QuickStep ATSCAL OTA Testing
user manual.
1.1 Key Features
General features:
●
High performance:
QuickStep causes a minimum processing overhead. The test execution speed
is comparable to native C++/C# code. Parallel execution of code is supported.
●
User-friendly handling:
Configurations are done via graphical user interface (GUI) and intuitive handling (for example drag & drop). Standard tests need only a minimum configuration effort.
●
High flexibility and wide application range:
– Examples and reference test cases are available and ready to run.
The test packages are optimized regarding time consumption.
9User Manual 1177.6223.02 ─ 11
R&S®QuickStep
– QuickStep is not confined to a certain set of test instruments since stan-
dard communication interfaces are used for controlling the test equipment.
3rd-party instruments are easily integrated.
– Customer-defined test setups and test conditions are supported.
– QuickStep is appropriate for production tests (particularly due to high per-
formance) as well as for test development purposes.
●
Support for developing test functionality and easy integration of customer
code
Test plan / test procedure configuration:
●
Static and dynamic parameter references
●
Convenient set and sweep functions
●
Limit handling
●
Configuration of preparatory and finishing test phases (for example for instrument initialization) around sequences of test steps
Welcome
Key Features
●
Dynamic control statements (loops, if conditions, jumps)
Test results and execution protocol:
●
Diagram for result plots
●
Histogram view for statistical analysis
●
Configurable result charts and live view results
●
Configurable reports
●
Test execution protocol viewer
System configuration management:
●
Graphical representation of the test setup
●
Intuitive building of system configurations with elements from a library
●
Parameter and path mapping for multiple test setups
Development of new tests:
●
Intuitive building of test procedures via flow charts of blocks from a library
●
Control structures (conditions, "If", "Or") and dependencies
●
GUI supported generation of source code templates for new test functions
●
Powerful API to support standard functionality
●
Microsoft Visual Studio® based test function development with C++ or C#
10User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Software Components, Product Licensing
●
Debugging support: Breakpoints allow to pause a test run on well-defined
steps and block functions; single step execution mode is provided
●
Usage and extension of R&S Forum, MATLAB and Python scripts
●
Support of user-defined dialogs implemented with Windows Forms or WPF
●
Standalone usage of block DLLs
Welcome
1.2 Software Components, Product Licensing
The software has the following components:
●
Test Executive Software
Includes the complete functionality to define tests based on the provided block
functions, to run tests and analyze the results.
Type: R&S QS-APP, included option keys: R&S QS-EXE, R&S QS-EDI
●
Development Option
Enables the creation of new block functions. The Block Development Tool provides the complete interface to integrate user code into QuickStep via MS Visual Studio projects.
Type: R&S QS-DEV, option key: R&S QS-DEV, included option key: R&S QSDBG
Additionally required type: R&S QS-APP
●
OTA Basic Application
Provides the OTA ATSCAL view for easy and integrated control of OTA (over
the air) RF radiation testing, particularly for calibration and antenna measurements in combination with an ATS1000. No configuration of a testplan or test
procedure is needed. Test results (total radiated power, gain, radiation pattern)
are also displayed in the view including polar and 3D chart.
Type: R&S QS-ATSCAL, option key: R&S QS-ATSCAL
Additionally required type: R&S QS-APP
●
ATSDRV Positioner Driver Package
Provides the functionality to control an ATS-CCP1 antenna positioner with
turntable and one antenna boom.
Type: R&S QS-ATSDRV, free of charge
The licensing is realized with a License Dongle (R&S QS-DGL) and controlled
with the R&S license server. The license dongle consists of a smart card and a
USB smart card reader. If the license dongle is connected with a USB port at the
PC where QuickStep runs, the local R&S license server (contained in the Quick-
11User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Documentation
Step installation package) manages the licensing. If connected to a server in the
network (particularly for using floating licenses), an R&S license server at that
server is needed for managing the licenses.
Welcome
1.3 Documentation
PDF documentation
The pdf documents are included on the product's USB stick. Most documents are
also accessible after QuickStep installation via the Windows "Start" button and
the folder "R&S QuickStep > Documentation" or via the QuickStep Help menu.
Additionally, the Getting Started is provided as printed document.
The pdf documentation consists of the following documents:
●
Getting Started
Provides basic information about the product and how to install it.
●
User Manual
Provides detailed information about the features of the application and how to
install, configure and use the application. The manual includes descriptions of
the applied mechanisms, step-by-step procedures showing how to carry out
typical tasks, a reference chapter where the GUI elements and their usage are
described, and application examples.
●
OTA Testing User Manual
User manual that is specialized for the OTA ATSCAL component of QuickStep.
●
Release Notes
Contains the most current information on the application, for example latest
changes, news, restrictions.
●
Training Manuals
Provide detailed descriptions how to use QuickStep based on instructive
examples. The descriptions include step-by-step procedures and many hints
on practical usage.
– User Training: Covers all topics related to the usage of QuickStep – except
for the development of new blocks.
– Developer Training: Covers the tasks for developing functional blocks.
Code examples illustrating how user-defined block functions are devel-
oped. The example code can be copied and inserted in programming files
12User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Welcome
Typographic Conventions
in MS Visual Studio; therefore two versions of the training manual exist:
one for programming in C++, one for programming in C#.
●
Quick Reference
Lists the typically required API functions on a poster.
●
ActiveReports User Guide
Describes how to use the ReportDesigner which is accessible via the Test
Procedure Editor's toolbar. The ReportDesigner allows to create and edit
report definitions and styles for the QuickStep reporting functionality.
Help, CHM documentation
●
The context-sensitive help system is embedded in QuickStep. Press the
"Help" button or the F1 key to access the help from the graphical user interface.
●
The QuickStep API description is a help system describing the classes and
files for block development. It is accessible via the Windows "Start" button and
the folder "R&S QuickStep > Help and Manuals" or via the QuickStep Help
menu.
●
Developer documentation (CHM files) of the provided R&S base blocks for reuse of the block functions for the development of 3rd party blocks.
1.4 Typographic Conventions
This document uses the following typographic conventions to make information
easier to access and understand.
Table 1-1: Typographic conventions
Convention Description
"Reference"
"GUI element"
"Menu name > com-
mand"
[KEY] [Capital] letters indicate key names. Example: CTRL key.
Input Letters in italic indicate a value you must type in as shown. Example:
"Quotation-marks" enclose references or graphical user interface
citations to other documentation parts.
The > symbol indicates a path or an order to follow for making selections on the GUI.
Example: On the taskbar, click "Start > All Programs > ...".
5400.
code
Letters in fixed-width font indicate file names, commands,
or program code.
13User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Welcome
Using the Help
Convention Description
Link Letters in blue font indicate links that you can follow (underlined).
Links to the Glossaries are not underlined.
emphasis Letters in boldface indicate emphasized words.
<variable> Angle brackets enclose variable values. Example: <release>.
| Vertical bar indicates alternate selections - the bar means "or".
... Ellipsis indicates nonessential information omitted from the example.
1.5 Using the Help
The help system is integrated into the software. The help system is an integral
part of the product's framework and thus provides information about all application parts that are officially released, independendly of whether the applications
are installed or licensed, or not.
1.5.1 Accessing the Help
Use one of the following options to access the help. Depending on the specific
help calls, several help windows may open in parallel.
●
F1 key
Opens the help. If the selected GUI element provides context-sensitive help,
opens the related help topic.
For example, if a tab is selected, F1 will open a reference description for the
tab.
●
Menu bar
The "Help > R&S QuickStep Help" item opens the Online help ("Help" provides links to other documents, too).
Using ToolTips
Move the pointer over an element to display a short description of it.
14User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Welcome
Using the Help
1.5.2 Navigating in the Help
As in most help systems, you can use common tabs to find the information of
interest. You find the tabs in the left pane: "Contents", "Index" and "Search". The
icons in the toolbar provide further navigation support, see the following table.
Table 1-2: Help menu
Command Description
"Hide"/"Show" Hides or shows the left pane.
"Previous" Opens the previous page of the help directory.
"Next" Opens the next page of the help directory.
"Back" Opens the topics you visited before.
"Home" Shows the start page of the help (legal notice).
"Print" Lets you print the current topic or the selected heading and all
subtopics.
15User Manual 1177.6223.02 ─ 11
R&S®QuickStep
What's New
2 What's New
This document is related to version 5.0 of QuickStep and later.
The following sections list the main changes in the document since version 4.65.
For more details, see the Release Notes.
Test Procedure Editor
●
Block colors:
– Blocks newly created in the "Blocks & Connectivity" section get a default
color which you can change in the "Properties" pane. The same block
color is displayed for all test execution phases.
– Disabled blocks (see below) are displayed in grey color.
– Block functions that carry an execution condition are displayed with blue
frame.
●
Block context menu: Has been extended, for example with alignment and
resizing options.
●
Disabling a block (main area):
16User Manual 1177.6223.02 ─ 11
R&S®QuickStep
What's New
You can enable/disable all functions of a block via context menu. If disabling
was applied, the block turns grey. Afterwords you can use the "Enabled"
checkbox in the "Properties" pane to enable just the selected block function;
consequently the block gets its color again.
To enable/disable several blocks in one step, select them and use the context
menu.
●
Connecting a block automatically:
If you drag a block from the "Block Library" into the main area over an existing
block that has no outgoing connection yet, the new block can automatically be
connected to the existing block by dropping the block. The connection is directed from the existing block to the new block.
●
Alignment features (main area):
– Grid and snapping to grid
– Snapping to item
Figure 2-1: Snap to item
– Alignment of blocks and other items
17User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Licensing
What's New
Floating licenses can be used to unlock QuickStep functionalities. Occupation of
a floating license is controlled from the "Settings" menu with the new items
"Enable/Disable License Occupation" and "Set License Occupation Time".
The licensing is handled with the R&S license server web application (contained
in the QuickStep installation package). See Licensing Tasks for details.
Command line operation
New options are provided for using QuickStep without GUI in a command line
interface (CLI, via Command Prompt window). See Command Line Interface
(CLI) for a description of the command options.
18User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Block development
Pythons scripts can be used as functions of a script block.
What's New
19User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Introduction to QuickStep
Typical Test Setup
3 Introduction to QuickStep
This chapter provides a brief overview over QuickStep for a first orientation. The
given information is not comprehensive and not represented with full complexity.
3.1 Typical Test Setup
Figure 3-1: Schematic test setup (DUT: Device under Test)
Characteristics:
●
QuickStep runs on a PC and controls the test instruments.
●
QuickStep basically commands a sequence of test steps where the values of
one or several test parameters are varied. The results for each test step are
collected and presented within QuickStep.
●
Typically, SCPI commands sent over LAN (or GPIB) control the test instruments. Any other remote control interface might be adapted.
●
The test instruments can be of any type. Examples are generators, analyzers,
power supplies, power sensors, switching devices. The number of used test
instruments is not limited.
●
One or more test instruments provide test signals as input for the DUT. Vice
versa, one or several test instruments gather signals or data from the DUT.
Examples:
– A generator instrument provides an RF signal to the DUT. QuickStep
defines the properties of the RF signal to be transmitted.
– An analyzer instrument receives RF signals from the DUT and measures
their properties. QuickStep gets the results from the analyzer.
– A power supply with variable voltage powers the DUT.
20User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Introduction to QuickStep
Graphical User Interface
3.2 Graphical User Interface
All operational tasks for configuring and executing tests are carried out on the PC.
When starting QuickStep, the "QuickStep" window – the graphical user interface
(GUI) – opens.
Figure 3-2: GUI overview
1 = Menu bar
2 = Tabs
3 = Toolbar
4 = Navigation / browser / library
5 = Main pane
6 = Secondary pane
The GUI is structured with a menu bar, tabs, a toolbar and several panes. The
content to be displayed is distributed in several tabs. The selected tab defines
which type of information is displayed in the different panes. See the descriptions
below for information on the content for single tabs. The entries in the toolbar also
depend on the selected tab.
21User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Introduction to QuickStep
Graphical User Interface
3.2.1 Test Execution
This view becomes relevant when the current test is executed. You can start the
test run and control the test execution.
Figure 3-3: Test Execution
1 = Start the test execution
2 = See and control the execution progress
3 = View the logged messages
4 = Select the block function flow chart of interest
5 = Inspect the current block function
Progress bar
The progress bar shows how far the test has been executed. You can control test
execution, for example resume test execution after a halt due to a breakpoint in
the test plan.
Log Viewer
The Log Viewer protocols the events occurred during operation of QuickStep,
particularly after starting the test execution. The messages are color-coded.
22User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Introduction to QuickStep
Graphical User Interface
Test Procedure Debugger
The "Test Procedure Debugger" allows to check the values of parameters during
test run. It includes the Test Procedure Browser from the Test Procedure Editor
for selecting the block function diagram that contains the block function of interest.
The debugger works together with the progress bar during test run. You can proceed in the test execution step by step with the "Step" button. If you have defined
breakpoints for test steps (to be done in the Testplan Editor) and have clicked the
"Continue" button, the test execution is halted at each breakpoint until you click
"Continue" again.
3.2.2 Test Plan Editor
The "Test Plan Editor" is the initial view of QuickStep. The user prepares a list of
test steps and starts the test execution from the toolbar.
Figure 3-4: Testplan Editor
1 = Select a sequence of test steps (or define groups and sequences)
2 = Inspect and edit the sequence of test steps
3 = Edit parameter values
4 = Start the test plan
23User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Central test step table
In the table, each test step is represented in one row, the columns display the
related parameters. Parameter values can directly be edited in the table after a
double-click.
Each test step is connected to a test procedure by the entry in the "Test Procedure" column. The parameter set of each test step is dynamically adapted
according to the selected test procedure. If test procedure parameters are modified in the test procedure editor, the modifications get effective in the test plan editor after clicking "Update Test Project" or when the test is started.
Powerful sweep and set functions allow quick generation of parameter sweeps for
efficient parameter setting of multiple test steps. Multi-parameter sweeps might
be defined within one single test step. Prioritization might be used to keep control
on the order of the parameter sweeps within nested loops.
Introduction to QuickStep
Graphical User Interface
Panes on the right-hand side
In the "Test Step Parameters" tab, the parameters of a test step are displayed in
vertical order for a better overview and providing a more convenient way to edit
parameters without scrolling. The "TPR Options" tab contains parameters for the
whole test, for example repetitions. The "Test Step Limits" tab shows the configured limits for measurement results.
Regarding test development, various settings for logging and debugging are
offered. Breakpoints for debugging and single-step execution can be enabled for
specific test steps.
Test Project Browser on the left-hand side
Multiple test step parameter tables are organized in a tree structure for keeping
an overview of large tests. Control structures can be applied to sequences of test
steps, their parameters are configured in the right pane. "Test Project Parameters" contains static and dynamic global parameters to be configured in the middle pane.
3.2.3 Results Viewer
The results of a test run are displayed in the "Results Viewer".
24User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Figure 3-5: Results Viewer
Introduction to QuickStep
Graphical User Interface
1 = Select a result file
2 = Inspect the result table and select one or more result columns
3 = Inspect the diagram representation of the results for the selected column(s)
4 = Inspect the distribution of result values and check the statistical evaluation
Results File Browser on the left-hand side
The "Result File Browser" helps to keep an overview of large sets of result data.
Each test run generates a new time-stamped folder with a complete set of result
files with tab-separated measurement and timing results. When testing several
DUTs in "Continuous Run" mode, a separate subfolder is created for each DUT. If
results of the type trace are generated, these are also collected in a DUT-specific
subfolder. Additionally, a copy of the test plan and the execution log is stored as a
reference.
When selecting a result file in the Result File Browser, its content is shown as
table in the central area. TestStepsResults.log is the main result file con-
taining the results for each test step. ExecutionProtocol ... .txt contains
all logged messages with timestamp and origin.
Central Results Table
The central "Results Table" shows the results in a table. In case
TestStepsResults.log has been selected, each test step is presented in one
row and each result parameter in one column. If one or several result parameters
25User Manual 1177.6223.02 ─ 11
R&S®QuickStep
in the results table are selected, the results over the test steps (or other configurable running variables) are represented in the diagram on the right-hand side.
Each column of the table offers powerful sort and filter functions. An export filter
makes it possible to export a subset of the table as CSV or XLS file. In case the
table shows the content of the execution protocol, it is possible to export and
reuse SCPI sequences within other test environments. References to specific
results can be created via right-click. These can then be used in the "Test Procedure Editor".
Analysis panes on the right-hand side
The "Diagram" pane plots the data of a single or multiple columns that are
selected within the result table. Scatter plots are possible, since any result parameter can be selected for the x-axis of the plot. Results can be assigned to colorcoded groups by selecting an additional grouping parameter. Delta markers are
available for measurements.
Introduction to QuickStep
Graphical User Interface
If results of the trace type are selected, an adopted diagram pane is available.
Traces files can also be loaded directly into the central results table and displayed
with the standard results viewer. Zoom in and out is supported by mouse click,
mouse wheel and diagram bars. A right-click menu offers access to additional
settings.
The "Histogram & Statistics" pane provides a histogram pane and statistical
analysis of the result data that is selected within the result table.
3.2.4 Test Procedure Editor
A test procedure basically defines what functionality is executed when the test
steps connected to the test procedure are carried out. The blocks which can be
used for a test are managed in the "Blocks & Connectivity" part. The test flow for
each procedure is then set up as flowchart with a graphical editor, based on a
library of provided functions or user-developed functions.
26User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Introduction to QuickStep
Graphical User Interface
Figure 3-6: Test Procedure Editor
1 = Select an execution phase
2 = Drag a new block function into the main pane
3 = Select block functions, add block function dependencies, select a block function
4 = Edit the parameters of the selected block function
Control elements such as "If", "Or", “Fork” and “Join” are available to handle execution branches and loops. Conditions achieve a conditional execution of test
functions. All test function parameters can be made available for test parameterization within the test plan editor. Existing test procedures can be modified or
extended without source code development. The right-click menu provides
accesss to additional features like automatic alignment or changing the block
instance. If a new block function is dropped directly on an existing block function
without a successor, the new block function is automatically connected.
The toolbar provides access to tools for developing blocks, handling SCPI commands for connected test instruments, designing reports and integrating scripts.
3.2.5 System Configurator
The "System Configurator" reflects the test setup and can be used for setting the
device- and connection-specific parameters as occurring with the test setup.
27User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Figure 3-7: System Configurator
1 = Drag a symbol into the main area
2 = Connect the symbols
3 = Select an element
4 = Edit the properties (parameters) of the selected element
Introduction to QuickStep
Graphical User Interface
The main pane displays the used devices (test instruments, components, even
attenuators) and connections. You drag devices from the "Device Library" on the
left pane into the main pane. Then you draw connections between the devices.
On the right side in the "Properties" pane, you can see and edit the properties of
the currently activated device.
The system configurator facilitates the handling of several use cases:
●
Assistance for building up a VISA connection to a test instrument.
●
Automatic calculation of the RF path loss during test execution. Attenuations/
losses for individual components of the system are defined, then one or more
connections and system components are assigned to an RF path.
●
Easy switching between several test benches. Therefore, the system configuration contains the configuration for each of them.
●
Management of system-dependent parameters like connection IDs.
Using these features in a test plan is optional, the "System Configurator" can also
be left empty.
28User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Introduction to QuickStep
Block Function Development
3.3 Block Function Development
The Block Development Tool is provided for defining new test blocks, test functions and the associated function parameters. Based on these definitions, Microsoft Visual Studio C++ or C# projects with source code templates are automatically generated. The templates just have to be extended with user code in order
to create user-specific test functions. The newly developed test functions are
available in the test procedure editor after compilation.
Figure 3-8: Main section of the Block Development Tool
The QuickStep API (application programming interface) offers a comprehensive
set of functions for data exchange with other functions, logging of results and
other frequently required tasks. Even users with limited software development
experience can implement new test functions with just a few lines of code. Development experts can exploit all capabilities of Visual Studio for development of
complex test functions.
29User Manual 1177.6223.02 ─ 11
R&S®QuickStep
Test Structures and Their Relations
Concepts
4 Concepts
4.1 Test Structures and Their Relations
Test plans, test procedures and blocks
QuickStep organizes a test configuration with the following main structures:
●
Test plan: Contains a sequence of test steps, each one using a set of parameter values, and scheduling information. Each test step is connected with a
test procedure. Multiple test procedures for different test purposes may be
used in one test plan.
●
Test procedure: Defines the test functionality to be applied within a test step.
A test procedure is structured by a flowchart of block functions (see below)
which execute application software. The block functions can be arranged with
certain control structures.
●
Block: Contains a set of functions and one function is selected. A function fulfills a certain task and provides the parameters for user input. Often, a block
reflects the functionality of a test instrument. But it can also represent instrument-independent functions ("software block") or only parts of an instrument's
functionality. User-specific block functions can be developed with C++ or C#
or with scripts (Python, Matlab, Forum).
This structure keeps the test steps free from the real test equipment functionality.
The concept of blocks carrying functions allows you to provide, adapt and
develop test algorithms optimized for special test equipment and test conditions.
The blocks in a test procedure can be arranged in parallel or in sequence or in
combination with decision functions.
Figure 4-1: Logical representation of a test (principle)
30User Manual 1177.6223.02 ─ 11
Loading...