MCT SM AutomationManager

®

R&S CMW-KT014 Automation Manager Software Manual

(<3P×Z)

1203.3273.42 ─ 07

t n e m e r u s a e M & t s e T

l a u n a M e r a w t f o S

This manual describes the following options: ●

R&S®CMW-KT014, Automation Manager

© 2012 Rohde & Schwarz GmbH & Co. KG Muehldorfstr. 15, 81671 Munich, Germany Phone: +49 89 41 29 - 0 Fax: +49 89 41 29 12 164 E-mail: [email protected] Internet: http://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. The following abbreviations are used throughout this manual: R&S ® is abbreviated as R&S.

This manual describes the following options: ●

R&S®CMW-KT014, Automation Manager

© 2012 Rohde & Schwarz GmbH & Co. KG Muehldorfstr. 15, 81671 Munich, Germany Phone: +49 89 41 29 - 0 Fax: +49 89 41 29 12 164 E-mail: [email protected] Internet: http://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. The following abbreviations are used throughout this manual: R&S ® is abbreviated as R&S.

R&S CMW-KT014

Contents

Contents 1

Introduct Introduction..... ion............... ..................... ...................... ...................... ...................... ...................... ..................... ..................... ............5 .5

2

Related Related Documenta Documentation... tion............. ..................... ..................... ..................... ..................... .................... ..................6 ........6

3

Fundamen Fundamental tal Concepts. Concepts............... ............................ ............................ ........................... ........................... .................7 ...7

3.1

MMI/EMMI MMI/EMMI Command Command Routing. Routing........ .............. ............. ............. .............. ............. ............. .............. ............. ............. .............. ............. ...........7 .....7

3.2

MMI Command Command Process Processing.. ing.......... ................ ................ ................ ................ ................ ................ ................ ............... ............... ...............1 .......10 0

3.3 3.3

EMMI EMMI/A /AT T Com Comma mand nd Proc Proces essi sin ng................................................................................11

3.4

Respo Respons nse e Antici Anticipat pation ion.... ........ ........ ...... ...................................................................................11 .................................................................................11

4

Key Key Feat Featur ures es.. ..... ..... ..... ...... ..... ..... ...... ........................................................................12

5

New New Featu Feature res. s.... ...... ...... ...... ...... ...... ..... .....................................................................14 ...................................................................14

6

The The Use Userr Int Inter erfa face ce... ...... ...... ...... ........................................................................15

6.1

Main Main Window Window.... ........ ........ ........ ....... ....... ........ ....... ....................................................................................15 .................................................................................15

6.1.1 6.1.1

Forward Forward Conversion Conversion Pane...... Pane............... ................. ................. ................. ................. ................. ................. ................. ................ ................. ..........15 .15

6.1.2 6.1.2

Reverse Reverse Conversio Conversion n Pane........ Pane................ ................ ............... ............... ................ ................ ................ ................ ................ ................ .............1 .....16 6

6.1.3 6.1.3

Session Session Log Pane..... Pane............. ............... .............. ............... ............... .............. ............... ............... .............. .............. ............... ............... .............. ............1 .....17 7

6.2

Menus... Menus.......... ............. ............. .............. .............. .............. ............. ............. .............. .............. .............. ............. ............. .............. .............. ............. ............. ............1 .....18 8

6.2.1 6.2.1

File Menu..... Menu............. ................ ................ ................ ................ ................ ................ ................ ............... ............... ................ ................ ................ ................ ..........18 ..18

6.2.2 6.2.2

Edit Menu....... Menu.............. .............. .............. ............... ............... .............. .............. .............. ............... ............... .............. .............. .............. ............... ............... ..........1 ...19 9

6.2.3 6.2.3

View Menu...... Menu............. ............... ................ ................ ................ ................ ................ ................ ................ ................ ................ ................ ................ .............. .......22 .22

6.2.4 6.2.4

Tools Tools Menu...... Menu.............. ................ ............... ............... ................ ................ ................ ................ ................ ................ ................ ................ ................ .............. ......23 23

6.2.5 6.2.5

Help Menu....... Menu.............. .............. ............. ............. .............. .............. .............. .............. .............. .............. .............. .............. .............. .............. ............. ............ .......29 .29

7

Esse Essent ntia ials ls of Usag Usage. e.... ...... ...... ......................................................................30 ...................................................................30

7.1

Licen Licensin sing.. g..... ....... ........ ........ ........ ........ ........ ........ ....... ....................................................................................30 .................................................................................30

8

Tips.. Tips...... ........ ........ ........ ........ ........ ........ ........ ....... ......................................................................33 ...................................................................33

9

Regu Regula larr Expr Expres essi sion on Par Parse ser.................................................................34 r.................................................................34

10 Regu Regula larr Expr Expres essi sion on Refe Refer r ence ence (Abbreviated) ..................................36 Glossary: Abbreviations......................................................................38 Abbreviations......................................................................38 Index......................................................................................................40

Software Manual 1203.3273.42 ─ 07

3

R&S CMW-KT014


Contents

4

R&S CMW-KT014

Introduction

1 Introduction Welcome to the R&S Automation Manager which can be installed on the mobile communication testers (MCT) R&S CRTU-W, R&S CRTU-G and R&S CMW500, and on R&S CMW-CU Control Unit and personal computers. The R&S Automation Manager allows you to automatically run test scripts or test cases on the MCT, also named as System Simulator in this document. The R&S Automation Manager intercepts Man Machine Interface (MMI) and Electrical Man Machine Interface (EMMI) commands routed to an RS232-C or TCP/IP port of the R&S MCT and translates them into User Equipment (UE) specific commands or triggers appropriate actions on an UE specific adaptor. The following sections cover the following issues: after a description of the Fundamental Concepts behind the test case automation approach, the Key Features and New Features are introduced, followed by a tour through the User Interface elements. The purpose of the section titled Essentials of Usage is to get you started with this software tool, focusing on the essential functions of this application, for example loading and maintaining UE specific profiles, configuring the connections to the MCT and the UE, and starting and terminating a monitoring session. Tips on how to use R&S Automation Manager efficiently, information on the Regular Expressions and a list of Abbreviations conclude this document.

The R&S Automation Manager is a generic and customizable application that in principle can be used with all types of UEs. Yet, its scope is limited to those UEs that provide a straight forward command conversion for all MMI and EMMI/AT commands that may be issued by a test case. If a UE e.g. does not provide an EMMI command for switching on and/or off, it may be possible to use an additional channel to control an external device such as a remotely controlled power supply. If this is not sufficient, automated TC execution may simply not be possible by making use of only this tool. Rather, some dedicated solution with additional command interpreters needs to be considered.


5

Related Documentation

R&S CMW-KT014

2 Related Documentation Rohde & Schwarz provides a comprehensive documentation set. Depending on the instrument you are using (R&S CMW500 or R&S CRTU-W), you will find related documentation in different places: ●

R&S CMW500: The R&S Automation Manager manual is part of the R&S CMW500

protocol testing documentation. You will find the complete set of manuals on the documentation CD-ROM (1202.3863.08). The Quick Start Guide for R&S CMW500 Protocol Testing (1202.3857.62) is delivered as printed manual. It contains a list of all manuals in its "Documentation Map". The Quick Start Guide introduces to protocol testing and provides a short description of all R&S software products contained in the R&S protocol testing tool chain for C++ R&D testing. ●

R&S CRTU-W: Related manuals are contained in the Software Manuals folder of

the product's installation DVD. Most of the Rohde & Schwarz software products provide a Help system. For information on how to access the R&S Automation Manager's help system, see chapter 6.2.5, "Help Menu", on page 29.


6

Fundamental Concepts

R&S CMW-KT014

MMI/EMMI Command Routing

3 Fundamental Concepts To best use the features of R&S Automation Manager, read this chapter. It explains the fundamental concepts behind the software. The primary purpose of the R&S Automation Manager is to automatically run test cases on an R&S MCT (System Simulator). From time to time, a test case issues an MMI or EMMI (AT) command to put the UE into a new appropriate state. In a manual testing environment, the commands are displayed on a screen, and an operator is required to perform the appropriate actions on the UE. To cope with high numbers of complex test cases within a reasonable amount of time and in addition to allow for overnight or weekend regressions, these commands need to be executed without human interaction. The R&S Automation Manager provides this automation functions. This section describes the basic concepts of test case automation and introduces the following important elements comprising an automation approach: MMI/EMMI Command Routing, MMI Command Processing, EMMI/AT Command Processing and Response Anticipation. If you are interested in a more detailed description of requirements and features of an automated test environment for TTCN-based signaling conformance test cases, refer to the following manuals: ●

For R&S CRTU-W/M: "TTCN Software" manual, chapter "Test Cases Automation"

●

For R&S CMW500: "R&S CMW500 Protocol Testing - Test Setups and Use Cases" manual. This manual also provides information on how to use automation when working with Medium Level and Low Level Application Programming Interface based scenarios.

These elements are described in the following sections: ● ● ● ●

MMI/EMMI Command Routing..................................................................................7 MMI Command Processing.....................................................................................10 EMMI/AT Command Processing.............................................................................11 Response Anticipation............................................................................................11

3.1 MMI/EMMI Command Routing The following figures depict the routing context of MMI and EMMI commands in various manual and semi- or fully automated test architectures. The figure 3-1 depicts a test configuration which requires an operator for reading and interpreting commands displayed on a screen. The interaction to the UE may be established by directly using the UE’s operating keys (e.g. to switch on or off the UE, or to initialize a call by dialing a number), or by using a terminal program (mainly for rendering AT commands).


7


R&S CMW-KT014


Rohde & Schwarz System Simulator

Test Case

MMI commands

Screen

AT commands

Terminal Program, e.g. HyperTerm RS-232-C, USB, TCP/IP, IrDA, ...

Tester

RF

Device under Test

Fig. 3-1: Manual test architecture with operator interaction

The figure 3-2 depicts a test configuration which makes use of the R&S Automation Manager running on the System Simulator. The connection to the test case should be a (local) TCP/IP connection. This is the default configuration setting for both the System Simulator and the R&S Automation Manager.


8


R&S CMW-KT014


Rohde & Schwarz System Simulator

Test Case

MMI commands AT commands

TCP/IP

Automation Manager TCP/IP IEE488 RS-232-C

External Device (e.g. PSU)

RS-232-C, USB, TCP/IP

Tester

RF

Device under Test

Fig. 3-2: Automated test architecture with local Automation Manager

The R&S Automation Manager might also be run on a separate computer (see figure 3-3). In this case, either an RS232-C connection (when available) or a TCP/IP connection might be chosen. Rohde & Schwarz System Simulator

Test Case

MMI commands AT commands

RS-232-C, TCP/IP

Automation Manager RS-232-C, USB, TCP/IP, IrDA, ...

Tester

RF

TCP/IP IEE488 RS-232-C

External Device (e.g. PSU)

Device under Test 3G UE

Fig. 3-3: Automated test architecture with remote Automation Manager


9

R&S CMW-KT014


MMI Command Processing

An additional license is required when R&S Automation Manager is run on a separate PC. To switch over from manual to automated testing, MMI and EMMI commands need to be routed to an RS232-C port or TCP/IP Port, from where they can be read and processed by the R&S Automation Manager, and eventually be forwarded to the device under test or an inserted additional adapter. Of course, once the routing via RS232-C port or TCP/IP port is selected, both R&S Project Explorer and R&S Automation Manager need to be configured in a consistent way, i.e. the R&S Project Explorer’s port to the R&S Automation Manager and the R&S Automation Manager’s port are required to be configured identically. Here, the physical connection between System Simulator and Automation Manager is of major interest. One can choose between RS232-C (serial or COM port), if available, and TCP/IP. For more details about this connection, refer to the "MCT Tools" manual, chapter "R&S Project Explorer". For R&S CRTU-W/M only When using ETSI/MCC160 TTCN test cases, the logical switch to change over from manual to partial or full automation support is an R&S extension PIXIT value called px_EMMISupportLevel of type ENEUMERATION, which may be set to one of DISABLED, ENABLED, or EXTENDED. This value may be defined in ATS specific PICS/PIXIT files, and enable or disable a flag in the testercase ASP messages, being interpreted. For more information on PICS/PIXIT files, refer to the "Base Softeware (MCT Tools)" manual, chapter "R&S PICS/PIXIT Editor". On the R&S CMW500, the automation level of WCDMA 3GPP TS 34.123 (TTCN-2based), LTE 3GPP TS 36.523 (TTCN-3-based) and GSM 3GPP TS 51.010-1 conformance test cases is specified in the R&S Test Case Explorer. For more information, refer to the "R&S Test Case Explorer" manual or help.

3.2 MMI Command Processing MMI commands are used within a test case to inform the test operator of certain test conditions or to ask the operator to perform a task which might not be easily remotecontrolled in the device under test. The most common and frequently used examples of MMI commands are the following requests: "Please switch off the UE" and "Please switch on the UE" at the beginning of a test case. Assuming that the UE supports e.g. the special "AT+CFUN" command, the R&S Automation Manager’s task would be to intercept the plain text switch off and on requests, and render the “AT+CFUN=0” or “AT+CFUN=1” commands to the UE instead.


10

R&S CMW-KT014


EMMI/AT Command Processing

3.3 EMMI/AT Command Processing EMMI/AT commands are defined in TS 27.007 and provide a standardized command set for controlling various UE functions, such as "dialing a number", "establishing a data connection", "setting QoS parameters", etc., so in most cases it will be sufficient to simply forward the AT command to the UE.

3.4 Response Anticipation Usually, the AT modem interface of a certain user equipment is designed so that upon a request a certain action is started, and after this action is finished, an appropriate response is sent back indicating the success of the action, or error codes that are associated to certain error conditions. On the other hand, most AT command dialogs in ETSI/MCC160 releases of TTCN ATSes are designed such that a UE response is expected before the action is executed. To avoid a dead lock in these situations, the R&S Automation Manager should be configured to first anticipate the expected response, then send it back to the SS, and eventually discard the UE’s true response. Response anticipation can be configured in R&S Automation Manager by adding an action to first acknowledge the command by send "OK" to the System Simulator.


11

Key Features

R&S CMW-KT014

4 Key Features R&S Automation Manager serves as an operator replacement in an automated test case execution environment. Its main features are: ●

Definition and maintenance of UE Specific command conversion profiles

●

Regular expression parser

●

Multiple action execution

●

Conversion of responses from external devices

●

Configuration of System Simulator, UE and external device connections

●

Monitoring MMI/EMMI commands during a test session

Definition and Maintenance of UE Specific Command Conversion Profiles

As various MMI and EMMI/AT commands might need to be translated in a different way for different UEs, a user specified list is maintained along with the dedicated profile of a certain UE. This list can be maintained by adding, modifying, and removing commands as required by developing new or maintaining existing test cases. Each command can have a list of actions associated with it such as sending a command to a specific communications channel or sending a specific response to the System Simulator. No automatic response is sent back to the System Simulator as in previous versions of R&S Automation Manager. R&S Automation Manager does not differentiate between different types of commands but tries to match any received command against the defined command conversions in sequential order. A default command can be defined which is only evaluated after all other conversions have failed to match. Regular Expression Parser

R&S Automation Manager uses a regular expression parser to match defined command conversions against received commands. The regular expression parser allows similar commands to be handled by a single defined command conversion however since received commands are matched against the defined command conversion in the order in which they are listed it important to define the most specialized regular expression first and the more generalized ones later. Example

If a command conversion has an expression defined as AT\+CMMIREQ=\"Begin of TestCase (.+)\"

A received command of AT+CMMIREQ="Begin of TestCase 7.2.1"

Would match this command conversion. The text 7.2.1 could then be used in a defined action by referencing $1 as in the action below TestCase $1 Started Read the section in chapter 9, "Regular Expression Parser", on page 34 for more information about defining commands. “\” is required to delimit some special characters such as + and “ in the example.


12

R&S CMW-KT014

Key Features

Multiple Action Execution

A list of actions to execute can be defined for each command conversion allowing several devices to be controlled when one command is received. This allows much greater flexibility in responding to certain commands and is most useful for switch on or off when power supplies need to be controlled as well the UE or for certain commands which translate into several AT commands. Conversion of Responses from External Devices

Some test cases expect information to be returned from the UE in a specific format. A reverse conversion list can also be defined and by using the regular expression parser, responses from external devices can be converted to the required format and returned to the System Simulator. Configuration of System Simulator, UE and External Device Connections

As the connections to the System Simulator, UE and external devices do not vary often, this information is also stored along with a UE’s dedicated profile. Monitoring MMI/EMMI Commands During a Test Session

All commands sent to and received from the tool, including intermediate actions, are displayed in the Session Log pane. Switching over to the Session Log pane after clicking the Start button in the Command Settings pane allows easy tracking of the messages transferred from the System Simulator to the UE or other device’s command interface and vice versa.


13

New Features

R&S CMW-KT014

5 New Features Supported Channel Types

R&S Automation Manager supports two additional channels ●

VISA: Allows use of the R&S CMW500 GPIB control interface.

●

CMW-ZASB : Allows use of the R&S CMW-ZASB Automation Switch Box.

Additional Features ●

Configurable connection retry for RS232-C channels

●

Configurable delay when using the channel test to evaluate new commands

●

Microsoft Windows 7 support


14

The User Interface

R&S CMW-KT014

Main Window

6 The User Interface This section describes the user interface of the R&S Automation Manager.

6.1 Main Window The main window has two areas: ●

Monitor

●

Test Setup

The Monitor area allows for the test session to be started by clicking the Start button or stopped by clicking the Stop button. The Test Setup area allows for the communications settings and connections to the UE or external devices to be tested. Window Panes

Below the two areas above mentioned, there are three panes provided:

6.1.1

●

Forward Conversion pane; see figure 6-1 on page 16

●

Reverse Conversion pane; see figure 6-2 on page 17

●

Session Log pane; see figure 6-3 on page 18

Forward Conversion Pane The left hand side of the Forward Conversion Pane displays all commands of a UE specific profile that will be received from the R&S MCT and need to be translated during a test session with this UE. Each forward conversion is specified with a regular expression which will match to the command as scanned and identified fr om the R&S MCT. The right hand side of the pane displays the list of actions that will be carried out when the selected command is received and should include the response to send to the R&S MCT and the command to send to UE. Each action consists of the translated command, the communications channel over which to send the translation and some more detailed configurations, to handle timing issues or associated user specific actions. For a detailed description of the forward conversion configurations, refer to the description of the chapter 6.2, "Menus", on page 18. If commands are received that are not matched in the conversion table, a match to the default forward conversion (highlighted in red) will be attempted. If this match also fails, no action will be taken. The regular expression (.+) which evaluat es one or more character of any type is recommended as the default conversion to match anything not explicitly defined.


15

R&S CMW-KT014

The User Interface

Main Window

Fig. 6-1: Forward Conversion pane

6.1.2

Reverse Conversion Pane The Reverse Conversion pane is very similar to the forward conversion pane but is used to define conversions for responses read from any connected devices other than the R&S MCT such as the UE.


16

R&S CMW-KT014

The User Interface

Main Window

Fig. 6-2: Reverse Conversion pane

6.1.3 Session Log Pane Once a test session is started, the message transfer between the R&S MCT, UE and external devices via the R&S Automation Manager are displayed in the Session Log pane. According to the Forward and Reverse Conversion tables, arriving commands from the R&S MCT will be translated into UE specific commands and sent to the specified communications channel. The other configuration parameters are also applied, e.g. timing port access manipulations like execution or response delays, etc. Received commands that are not matched in the conversion table are displayed in the Session Log pane with the text “Info : Command not found using default handler”. If no match is made to the default command then no other action will be displayed in the session log pane.


17

R&S CMW-KT014

The User Interface

Menus

Fig. 6-3: Session Log pane

Having setup the UE, R&S MCT and external devices connections, you may start the test session by clicking the Start button in the Monitor area of the main window.

6.2 Menus This section describes in detail the R&S Automation Manager menus.

6.2.1

File Menu With the functions of the File menu, maintenance of UE specific profiles is supported on a file level. The File menu comprises choices to create a new profile, open an existing one, save the current one, save the current one as an alternative file, or to directly exit R&S Automation Manager. In addition, a history list of recently loaded files is displayed for direct opening of these files without the need to explicitly browse to its dedicated location.


18

R&S CMW-KT014

The User Interface

Menus

Fig. 6-4: Content of the file menu (example)

New…

If the New… command is selected, the current profile is closed without any change and an empty Forward Conversion pane is displayed, referring to a new profile which is still “Untitled” (see also the task bar contents). Open…

Select the Open… command to browse for a profile stored in the file system. Save

Select the Save… command to save the currently loaded profile to its original location in the file system. Save As…

Select the Save As… command to browse for a dedicated location and to save the profile with a new file name. Exit

Use the Save… or Save As… functions before exiting, otherwise your changes of the currently loaded profile are lost. Select Exit to immediately close the R&S Automation Manager.

6.2.2

Edit Menu With the functions of the Edit menu, maintenance of UE specific profiles is supported on a command level. The Edit menu comprises choices to add a new command translation, modify an existing one and to remove an existing one.

Fig. 6-5: Content of the edit menu


19

The User Interface

R&S CMW-KT014

Menus

To make use of the Add Command function of the Edit menu, just click on that function. For the other Modify and Remove Command functions, one of the existing command translations must previously have been selected by means of clicking on one of the entries in the Forward or Reverse Conversion panes with the left mouse button. 6.2.2.1

Add Command

To add a new command translation to the currently loaded profile, just select the Add Command on the Edit menu. A dialog window will be displayed to allow a detailed specification of Command received from the R&S MCT and the Actions to be carried out (e.g. send to the UE or external devices). Commands and Replacements use a regular expression parser to allow wild cards to be used within defined commands and replacements to be built from the regular expression parser. Please read section in chapter 9, "Regular Expression Parser", on page 34 for more information. Each Action is defined as a replacement command, two delays to be applied before and after the action and a channel over which to send the replacement. While the Before delay defines the time between receiving the R&S MCT Command (or completion of the previous action) and sending the Replacement, the After delay defines the time between sending the replacement and processing the next action. The Channel selects over which communications channel to send the replacement command. Table 6-1: Forward Command buttons Button

Description

Add

Adds a new action with the settings defined in the fields above the Actions list.

Edit

Edits the selected Action, once changes have been made use the Apply button to store the changes.

Remove

Deletes the currently selected action.

Move Up / Move Down Moves the currently selected action up or down in the order of actions.

Multiple actions executed for each received command

A list of actions to execute can be defined for each command conversion allowing several devices to be controlled when one command is received. This allows much greater flexibility in responding to certain commands and is most useful for switch on or off when power supplies need to be controlled as well or for certain commands which translate into several AT commands.


20

The User Interface

R&S CMW-KT014

Menus

Fig. 6-6: Add Command - Forward Conversion dialog

The following is a brief description of the all fields in the Add Command dialog: Table 6-2: Command Dialog Specification Fields Field/Flag

Description

Expression

This is the MMI/EMMI request command sent from the R&S MCT. When the R&S Automation Manager receives an MMI/EMMI request command, it will search the list of commands in the profile trying to match the defined regular expression. If found, it will then execute the corresponding actions.

Ignore Duplicate Commands

If this flag is enabled and the R&S MCT sends the same Command consecutively multiple times, the duplicate commands will not be processed by the R&S Automation Manager. This allows for situations where the command to switch on or off a UE is actually the same. If a test case switches off the UE at the beginning and end then when the next test case is run a second switch off command will be received resulting in the sequence of on or off being invalid. Ignoring the duplicate command in this situation would avoid the UE being set in the wrong state.

Duplicated Response

This is the response to send to the R&S MCT if a duplicated command has been received. Without this response the test case would not continue execution and should be used to just acknowledge the command was completed.

Replacement

This is the command that the R&S Automation Manager will send to the UE or external devices instead of the received MMI/EMMI Command from the R&S MCT. To just accept e.g. MMI operator instructions that do not require any interaction on the UE or external devices, just define an acknowledgement to return to the R&S MCT.

Delay: Before

This is the time in milliseconds the R&S Automation Manager will wait before sending the Replacement command. (e.g.: if a UE is switched Off, it may take a while for it to complete its detach procedures. As a result any subsequent Switch On commands would need to be delayed)

Delay: After

This is the time in milliseconds the R&S Automation Manager will wait after sending the Replacement command before reading a response and executing the next action (e.g.: if a UE is switched On, it may take a while for it to boot up. As a result any subsequent actions would need to be delayed)


21

The User Interface

R&S CMW-KT014

Menus

Field/Flag

Description

Channel

This is to allow the communications channel, over which to send the command, to be selected. This allows commands to be sent to the UE or to other devices e.g. remote controllable power supply.

Release Port

If this flag is enabled the R&S Automation Manager will open and close the communication port each time when sending each Replacement command. Otherwise the port is opened once and not closed until the session is ended. This option should be used when the channel connection will be lost and should be re-established when the next command is sent. When a UE is switched off the connection is often broken and the port should be released in this situation to avoid any problems when sending the next command.

Process Response

If this flag is enabled the R&S Automation Manager will read the response from the Channel (after the post command delay) and attempt to match the response with the commands in the reverse conversion pane. If this flag is not enabled the R&S Automation Manager will read and discard any response from the Channel (after the post command delay).

Make Default Command

If this flag is enabled this command will only be matched against if all other defined commands do not match. This allows a default conversion to be specified.

Reverse

If this flag is enabled this command is a Reverse Conversion Command (Read Only)

With clicking the ... button next ot the Replacement field in the Add Forward Command dialog, a file browser opens which allows you to select a dedicated script or program to be executed instead of sending a Replacement command. 6.2.2.2

Modify Command

If the Modify Command option is selected, the currently highlighted command translation is loaded into the command dialog. With the same means as described in the Add Command function, the loaded command conversion may be edited. 6.2.2.3

Remove Command

Once a command conversion is selected, it can be removed from the list of conversions by selecting the Remove Command function.

6.2.3

View Menu The View menu will offer a choice to clear the contents of the Session Log pane.

Fig. 6-7: View Menu

Clear Session Log

Select the Clear Session Log function to clear the Session Log pane. If you got lost in the session log messages, this might be helpful, in particular if the session is started again.


22

The User Interface

R&S CMW-KT014

Menus

Enable File Log

Select the Enable File Log function to write all entries in the Session Log pane to a file. You can specify a name for this file. Disable File Log

Select the Disable File Log function to stop logging of entries in the Session Log pane to file.

6.2.4

Tools Menu The Tools menu will offer some choices to configure the communications channels and to play with the connected mobile to test it before running a true test session.

Fig. 6-8: Tools Menu

6.2.4.1

Channel Setup

Select Channel Setup from the Tools menu to display the Channel Setup dialog. This dialog allows the following: ●

configuration of the connection between R&S Automation Manager and R&S MCT

●

configuration of communication channels over which to send the replacement commands

For a flexible layout of remote control scenarios, different types of channel types are defined: RS232-C, TCP/IP, IEEE_488.1, IEEE_488.2, VISA and CMW-ZASB. Depending on the selected channel type, the corresponding channel setup dialog is tailored to its specific needs. The System Simulator is displayed in the channel list as the channel "SIMULATOR" . This channel should be configured according to how R&S Automation Manager is connected to the System Simulator and should be the default channel.


23

The User Interface

R&S CMW-KT014

Menus

Fig. 6-9: RS232-C Channel Setup

The following table provides a brief description of the all settings in the Channel Setup dialog: Table 6-3: Channel Setup dialog - settings Field

Description

Channel List

This is a list of defined communications channels. The channel name is used in the Command definition to select where the replacement command is sent. The channel type defines the basic communications type and can be either RS232-C, TCP/IP, IEEE_488.1, IEEE_488.2, VISA or CMWZASB. The name and type of channel is configured when a new channel is added using the Add button. Existing channels can be deleted using the Remove button. Existing channels can be modified using the Modify button. The specific channels configuration is displayed on the right hand side of the dialog.

New Channel

This is where a new channel is defined before adding to the channel list. Configure a name so that the device is easily identified and then select the communication medium to use with this channel. Select the type of channel from the list of available channel types the corresponding combo box.

RS232-C Settings

Specify the settings for the serial channel. Specific channel parameters are port number, baud rate, number of data bits, parity, number of stop bits and the flow control. Each of these fields may be defined via a combo box, presenting a suitable selection for the corresponding value. Two additional parameters can be configured which are especially useful for USB virtual RS-232-C ports. Retry attempts sets the number of time that R&S Automation Manager will try to open a connection and the retry delay is the time R&S Automation Manager will wait between retries. If a USB virtual RS 232-C port might be disconnected (e.g. when a device is switched off) this will allow it to be more reliably reconnected. The channel must be released after the last valid communication to the RS-232-C port for the retry mechanism to be successful.

IEEE_488.1 and IEEE_488.2 Settings

Specify the settings for a GPIB channel. Specific channel parameters are primary address, secondary address, and timeout value in milliseconds.

TCP/IP Settings

Specify the settings for a TCP/IP channel. Specific channel parameters are port ID and IP address.


24

The User Interface

R&S CMW-KT014

Menus

Field

Description

VISA Settings

Specify the settings for a VISA channel. Specific channel parameters are the resource string and timeout value in milliseconds. Example VISA Resource string: "GPIB0::24::INSTR" where "24" is the GPIB address of the instrument

CMW-ZASB Settings

Specify the settings for a CMW-ZASB channel. Specific channel parameters are the serial number of the R&S CMW-ZASB automation switch box. The type plate showing the six-digit serial number is located on the bottom of the R&S CMW-ZASB. The following commands are supported, and can be used in any combination: -usb1 on¦off -usb2 on¦off -gp1 on¦off -gp2 on¦off -trig1 on¦off -trig2 on¦off -port where is a decimal or hexadecimal (0xYY) value indicating the required status. For example, in decimal notation, -port 0 resets all ports to off , -port 63 sets all ports to on. You can set any port comination at once using the -port command. You may also use compound comands. For example, to first set all ports to on and then to set both USB ports to off, specify the following: -port 63 -usb1 off -usb2 off See the table 6-4 for supported port values. The individual port commands set the individual port but leaves all other ports as they were. For example, -usb1 on is an individual port command. The channel will return the current status in the hexadecimal notation 0xYY. For more information about the R&S CMW-ZASB, see the "R&S CMW-ZASB Automation Switch Box" manual.

The following table provides a complete list of port values in decimal and hexadecimal notation. A port value sets on the specified ports and sets off all others. Table 6-4: CMW-ZASB channel, value list for the -port command Decimal notation

Hexadecimal notation

Port status "on" for ports

0

0x00

None (reset all ports to off)

1

0x01

TRIG 1

2

0x02

TRIG 2

3

0x03

TRIG 1, TRIG 2

4

0x04

USB 1

5

0x05

USB 1, TRIG 1

6

0x06

USB 1, TRIG 2

7

0x07

USB 1, TRIG 1, TRIG 2

8

0x08

USB 2

9

0x09

USB 2, TRIG 1

10

0x0A

USB 2, TRIG 2

11

0x0B

USB 2, TRIG 1, TRIG 2


25

The User Interface

R&S CMW-KT014

Menus

Decimal notation



12

0x0C

USB 1, USB 2

13

0x0D

USB 1, USB 2, TRIG 1

14

0x0E

USB 1, USB 2, TRIG 2

15

0x0F

USB 1, USB 2, TRIG 1, TRIG 2

16

0x10

GP 1

17

0x11

GP 1, TRIG 1

18

0x12

GP 1, TRIG 2

19

0x13

GP 1, TRIG 1, TRIG 2

20

0x14

GP 1, USB 1

21

0x15

GP 1, USB 1, TRIG 1

22

0x16

GP 1, USB 1, TRIG 2

23

0x17

GP 1, USB 1, TRIG 1, TRIG 2

24

0x18

GP 1, USB 2

25

0x19

GP 1, USB 2, TRIG 1

26

0x1A

GP 1, USB 2, TRIG 2

27

0x1B


28

0x1C

GP 1, USB 1, USB 2

29

0x1D

GP 1, USB 1, USB 2, TRIG 1

30

0x1E


31

0x1F

GP 1, USB 1, USB 2, TRIG 1, TRIG 2

32

0x20

GP 2

33

0x21

GP 2, TRIG 1

34

0x22

GP 2, TRIG 2

35

0x23

GP 2, TRIG 1, TRIG 2

36

0x24

GP 2, USB 1

37

0x25

GP 2, USB 1, TRIG 1

38

0x26

GP 2, USB 1, TRIG 2

39

0x27


40

0x28

GP 2, USB 2

41

0x29

GP 2, USB 2, TRIG 1

42

0x2A

GP 2, USB 2, TRIG 2

43

0x2B


44

0x2C

GP 2, USB 1, USB 2


26

The User Interface

R&S CMW-KT014

Menus

Decimal notation



45

0x2D


46

0x2E


47

0x2F

GP 2, USB 1, USB 2, TRIG 1, TRIG 2

48

0x30

GP 1, GP 2

49

0x31

GP 1, GP 2, TRIG 1

50

0x32

GP 1, GP 2, TRIG 2

51

0x33

GP 1, GP 2, TRIG 1, TRIG 2

52

0x34

GP 1, GP 2, USB 1

53

0x35

GP 1, GP 2, USB 1, TRIG 1

54

0x36


55

0x37

GP 1, GP 2, USB 1, TRIG 1, TRIG 2

56

0x38

GP 1, GP 2, USB 2

57

0x39


58

0x3A


59

0x3B

GP 1, GP 2, USB 2, TRIG 1, TRIG 2

60

0x3C

GP 1, GP 2, USB 1, USB 2

61

0x3D

GP 1, GP 2, USB 1, USB 2, TRIG 1

62

0x3E

GP 1, GP 2, USB 1, USB 2, TRIG 2

63

0x3F

All (set all ports on)


27

R&S CMW-KT014

The User Interface

Menus

Fig. 6-10: IEEE_488.2 Channel Setup dialog

6.2.4.2

Escape Sequence Settings

Selecting Escape Sequence Settings from the Tools menu will display the Escape Sequences dialog which allows for configuration of custom escape sequence identifiers for use in the R&S MCT response field. The default escape sequences defined are for carriage return and for line feed.

Fig. 6-11: Escape Sequences


28

R&S CMW-KT014

The User Interface

Menus

6.2.4.3

Monitor Start / Monitor Stop

The Monitor Start function starts a normal session log. This will make R&S Automation Manager enable the R&S MCT connection, that is, to listen to commands received via this connection. This is also indicated by an appropriate message in the status bar. Selecting this function from the tools menu is identical to clicking the Start button in the Monitor area of the main window. Monitor Stop

The Monitor Stop function will stop the session. Selecting this function from the tools menu is identical to clicking the Stop button in the Monitor area of the main window.

6.2.5

Help Menu The Help menu provides the option to display the help system ( Help Topics) or the About dialog. Help Topics

The Help Topics option opens the R&S Automation Manager help system . Alternatively, press the F1 key to open the help system. About

The About option provides information on, tool name, developer, software version and copyright.


29

Essentials of Usage

R&S CMW-KT014

Licensing

7 Essentials of Usage This section is intended for first-time R&S Automation Manager users. It introduces essential operations such as starting the tool, loading a UE specific profile, configuring the connection ports to both the R&S MCT and the UE, potentially performing some UE tests, and eventually starting and terminating a session. All procedures are explained step-by-step. If you are unfamiliar with the basic concepts of R&S Automation Manager, refer to section in chapter 3, "Fundamental Concepts", on page 7 first.

7.1 Licensing Rohde & Schwarz Mobile Communication Tester (MCT) software and test cases are subject to license conditions. A special hardware and license keys are required to activate them. For more information on how to generally license Rohde & Schwarz software options and on how to manage licenses, see the "MCT Licensing" manual or the "R&S Lic ense Proxy" help. Starting R&S Automation Manager

The R&S Automation Manager is part of the R&S MCT program group. ●

Before starting R&S Automation Manager, make sure that the necessary serial ports (e.g. COM1) are not being used by any other applications (e.g. HyperTerminal).

●

To start R&S Automation Manager, click Start - Programs - R&S MCT - Automation Manager.

Fig. 7-1: R&S Automation Manager icon

Loading a UE Specific Profile

There are two ways to load a profile. You can either open one of the recently loaded profiles listed in the File menu, between the separators or go through the File - Open dialog. ●

Click Open… in the File menu.A file browser opens.

●

Navigate to the appropriate XML (UE profile) file. If no XML file is available, you need to create your own UE specific profile.

●

If available, select one of the profile files (extension XML) and click Open.The profile is loaded.

●

Select Forward Conversion pane for inspection or editing the profile. See chapter 6.2, "Menus", on page 18 with various functions for configuring a profile according to your needs.


30

Essentials of Usage

R&S CMW-KT014

Licensing

Configuring the R&S MCT, UE and External Devices Connections

Follow the procedure below when configuring the ports for the R&S MCT, UE and external devices connections. As the R&S Automation Manager is a stand alone application, it is important to select the method of connection to the System Simulator: ● ●

Select the menu Tools - Channel Setup. Configure the SIMULATOR channel (select Modify to change between TCP/IP and Serial ) – TCP/IP Select this option, if the tool is running along with the R&S Project Explorer in the System Simulator itself. Once selected, set the corresponding communication port (default: 4754).The IP Address field should be 255.255.255.255 for the SIMULATOR channel. –

Serial Select this option, if the tool is running as a stand alone application in a

different personal computer and is connected to the System Simulator using a Serial Cable. Once selected, set the appropriate R&S MCT settings: COM Port, Bits per Second, Data Bits, Parity, Stop Bits, and Flow Control ●

Add a channel for the UE you wish to control and set the appropriate UE settings: COM Port, Bits per Second, Data Bits, Parity, Stop Bits, and Flow Control.

Performing Special UE Tests

Prior to performing any automation, the connections to the UE can be tested by sending the blank AT command ("AT") and expecting a response "OK" from the UE. To do so, just click on the Test button. The true UE response is displayed in the Rsp field above. If the device needs additional time to respond this can be configured in the Delay field. This also allows easy experimentation to evaluate how much time is required. Example AT Commands:

AT # Attention AT+CGMM # Request Model Identification AT+CGMR # Request Revision Identification AT+CGMI # Request Manufacturer Identification AT+CIMI # Request International Mobile Subscriber Identity AT+CGSN # Request Product Serial Number Identification AT+CBC # Battery Status AT+CSQ # Signal Quality For a detailed description of AT commands, refer to the 3GPP Technical Specification TS 27.007, “AT Command Set for User Equipment (UE)”. Starting a Monitoring Session

Once the connection to the UE has been tested, the tool can now be initiated to monitor the R&S MCT port (TCP/IP or Serial). To do so, click the Start button in the main window.


31

R&S CMW-KT014

Essentials of Usage

Licensing

Terminating a Monitoring Session

To terminate a monitoring session click the Stop button in the main window. You can then close the R&S Automation Manager.


32

Tips

R&S CMW-KT014

8 Tips ●

A sample profile (Sample.xml) is supplied with many of the common conversions already defined. Check the communication settings for the device being automated, because this is machine and driver dependent and cannot be preconfigured. The sample is configured to run on the R&S MCT through the TCP/IP connection controlling a device via a serial port.

●

The R&S Automation Manager is specially designed to cooperate with the R&S Project Explorer. As the R&S Automation Manager allows you to configure the R&S MCT connection, i.e. the connection to the R&S MCT's Project Explorer, also the R&S Project Explorer’s connection to the R&S Automation Manager needs a matching configuration. For more details about this connection, refer to the "MCT Tools" manual, chapter "R&S Project Explorer".

●

Once all commands are saved in a suitable profile, load the profile, test again the connection to the UE and start monitoring the test session.

●

Be sure to have started the monitoring session in the R&S Automation Manger before starting a test case or a scenario. Otherwise MMI or EMMI commands might get lost on their path to the UE, and the test case or scenario is very likely to fail.

●

If you are using a TCP/IP connection from the R&S MCT, ensure that Send Termination is enabled within R&S Project Explorer’s settings.

●

Responses from other connected devices will only be translated when the Process Response flag is enabled in the action which sends to the device.

●

When communicating to devices which use USB Virtual RS-232-C ports, the actual port may not exist on Windows PC when the device is switched off. This can cause automation failure. After sending a command to the device (or another device) which will switch it off, the Channel should be released using “Release Port” in the Action. The Retry Attempts and Retry Delay can then be used to try to reconnect the Channel multiple times over a period of time when the next command needs to be sent.

●

The second GPIB interface optionally installed in an R&S CMW500 can be controlled using the VISA channel.


33

Regular Expression Parser

R&S CMW-KT014

9 Regular Expression Parser Command conversions may be specified with the help of regular expressions. A regular expression is a string that describes or matches a set of strings, according to certain syntax rules. Regular expressions are powerful means to significantly reduce the number of conversion specifications. R&S Automation Manager uses regular expression matching for both Forward and Reverse Command conversion, thus allowing a flexible adaptation between differing user equipment and test case or R&S MCT format requirements. Example

Given a sequence of test cases, each of them indicating both start and stop events with an operator MMI command, containing an unique test case ID, the stop event additionally containing the (final) verdict. Due to test case automation reasons, each of the MMI commands shall be converted to a user defined format. With 200 test cases and 4 possible result verdicts, 1000 command conversions would have to be specified without the help of regular expressions, as shown by the following table: Command

Replacement

AT+CMMIREQ="Begin of TestCase 1.1.1"

TC 1.1.1 START ...

AT+CMMIREQ="End of TestCase 1.1.1 : Verdict PASS"

TC 1.1.1 STOP (PASS)

AT+CMMIREQ="End of TestCase 1.1.1 : Verdict FAIL"

TC 1.1.1 STOP (FAIL)

AT+CMMIREQ="End of TestCase 1.1.1 : Verdict INC"

TC 1.1.1 STOP (INC)

AT+CMMIREQ="End of TestCase 1.1.1 : Verdict NONE"

TC 1.1.1 STOP (NONE)

•••

•••

AT+CMMIREQ="Begin of TestCase 7.2.19"

TC 7.2.19 START ...

AT+CMMIREQ="End of TestCase 7.2.19 : Verdict PASS"

TC 7.2.19 STOP (PASS)

AT+CMMIREQ="End of TestCase 7.2.19 : Verdict FAIL"

TC 7.2.19 STOP (FAIL)

AT+CMMIREQ="End of TestCase 7.2.19 : Verdict INC"

TC 7.2.19 STOP (INC)

AT+CMMIREQ="End of TestCase 7.2.19 : Verdict NONE"

TC 7.2.19 STOP (NONE)

With the help of regular expressions, the number of command conversions could be reduced to only two, regardless of the true number of test cases or potential final verdicts:


34

Regular Expression Parser

R&S CMW-KT014

Command

Replacement

AT\+CMMIREQ=\"Begin of TestCase (.+)\"

TC $1 START \.\.\.

AT\+CMMIREQ=\"End of TestCase (.+) : Verdict (.+) TC $1 STOP $$2$ \"

The "(.+)" will match the test case number and final verdict. In the first command conversion, the test case number is referenced through the use of $1. In the second one, the test case number and final verdict are referenced through the use of $1and $2, respectively. Some characters are escaped via the use of "\" because the regular expression parser makes use of these characters if they are unescaped (e.g period, double quote, opening brace, closing brace, etc.). The "+" character is interpreted by the regular expression parser as a repetition sequence meaning match one or more occurrences of.


35

R&S CMW-KT014

Regular Expression Reference (Abbreviated)

10 Regular Expression Reference (Abbreviated) Table 10-1: Regular Expression Reference Literal Characters

\f

Form Feed

\n

New line

\r

Carriage Return

\t

Tab

\v

Vertical Tab

\a

Alarm (Bell)

\e

Escape

\xxx

The ASCII character specified by the octal number xxx

\xnn

The ASCII character specified by the hexadecimal number nn

Character Classes

[…]

Any one character between the brackets

[^…]

Any one or more characters not between the brackets

.

Any character except new line equivalent to [^\n]

\w

Any word character, equivalent to [a-zA-Z0-9_]

\W

Any non word character, equivalent to [^a-zA-z0-9_]

\s

Any white space character , equivalent to [ \t\n\r\f\v]

\S

Any non white space character , equivalent to [^ \t\n\r \f\v]

\d

Any digit, equivalent to [0-9]

\b

Literal backspace (special case)

Replacement

\

Turn off the special meaning of the following character

\n

Restore the text matched by the nth position. N is a number from 0 to 9

\u

Convert first character of replacement pattern to uppercase

\U

Convert entire replacement string to uppercase

\l

Convert first character of replacement pattern to lowercase

\L

Convert entire replacement string to lowercase

Repetition


36

R&S CMW-KT014

Regular Expression Reference (Abbreviated)

Literal Characters

?

Match zero or one occurrences of the previous item

+

Match one or more occurrences of the previous item

*

Match zero or more occurrences of the previous item

{n}

Match exactly n occurrences of the previous item

{n,}

Match the previous item n or more times

[n,m]

Match the previous item at least n times but no more than m times

Options

i

Do-case insensitive matching

Grouping

(…)

Group several items into a single unit that can be used with ?,+,*

|

Match either the sub expressions to the left or the sub expressions to the right

Extended Regular Expression

(?|….)

Matches but doesn’t return “….”

(?:i)

Change matching rules (see options)

Anchors

^

Match the beginning of the string

$

Match the end of the string

\b

Match word boundary

\B

Match a position that is not a word boundary


37

R&S CMW-KT014

Glossary: Abbreviations

Glossary: Abbreviations A ASP: Abstract Service Primitives AT: ATtention command ATS: Abstract Test Suite

D DUT: Device Under Test

E EDGE: Enhanced Data Rates for GSM Evolution EMMI: Electrical Man Machine Interface

G GERAN: GSM EDGE Radio Access Network GPIB: General Purpose Interface Bus GPRS: General Packet Radio Service GSM: Global System for Mobile Communication

H HTML: HyperText Markup Language

I IP: Internet Protocol

M MCT: Mobile Communication Tester MM: Mobility Management MMI: Man Machine Interface

P PC: Personal Computer PSU: Power Supply Unit


38

R&S CMW-KT014

Glossary: Abbreviations

Q QoS: Quality of Service

S SAP: Service Access Points

T TC: Test Case TCP: Transmission Control Protocol TTCN: Tree and Tabular Combined Notation

U UE: User Equipment UT: Upper Tester UTRAN: Universal Terrestrial Radio Access Network

X XML: eXtensible Markup Language


39

MCT SM AutomationManager

Recommend Documents