MCT SM AutomationManager

R&S CMW-KT014Automation ManagerSoftware Manual

Softw

are Ma

nual

(

This manual describes the following options: R&SCMW-KT014, Automation Manager

2012 Rohde & Schwarz GmbH & Co. KGMuehldorfstr. 15, 81671 Munich, GermanyPhone: +49 89 41 29 - 0Fax: +49 89 41 29 12 164E-mail: [email protected]: http://www.rohde-schwarz.comSubject 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.

ContentsR&S CMW-KT014

3Software Manual 1203.3273.42 07

Contents1 Introduction............................................................................................52 Related Documentation.........................................................................63 Fundamental Concepts.........................................................................7

3.1 MMI/EMMI Command Routing......................................................................................73.2 MMI Command Processing........................................................................................103.3 EMMI/AT Command Processing................................................................................113.4 Response Anticipation...............................................................................................11

4 Key Features.........................................................................................125 New Features........................................................................................146 The User Interface................................................................................15

6.1 Main Window...............................................................................................................156.1.1 Forward Conversion Pane............................................................................................156.1.2 Reverse Conversion Pane............................................................................................166.1.3 Session Log Pane.........................................................................................................17

6.2 Menus...........................................................................................................................186.2.1 File Menu......................................................................................................................186.2.2 Edit Menu......................................................................................................................196.2.3 View Menu....................................................................................................................226.2.4 Tools Menu...................................................................................................................236.2.5 Help Menu.....................................................................................................................29

7 Essentials of Usage.............................................................................307.1 Licensing.....................................................................................................................30

8 Tips........................................................................................................339 Regular Expression Parser.................................................................34

10 Regular Expression Reference (Abbreviated) ..................................36Glossary: Abbreviations......................................................................38Index......................................................................................................40

ContentsR&S CMW-KT014


IntroductionR&S CMW-KT014


1 IntroductionWelcome to the R&S Automation Manager which can be installed on the mobile com-munication testers (MCT) R&S CRTU-W, R&S CRTU-G and R&S CMW500, and on R&SCMW-CU Control Unit and personal computers. The R&S Automation Manager allowsyou to automatically run test scripts or test cases on the MCT, also named as SystemSimulator in this document.The R&S Automation Manager intercepts Man Machine Interface (MMI) and ElectricalMan Machine Interface (EMMI) commands routed to an RS232-C or TCP/IP port of theR&S MCT and translates them into User Equipment (UE) specific commands or triggersappropriate actions on an UE specific adaptor.The following sections cover the following issues: after a description of the FundamentalConcepts behind the test case automation approach, the Key Features and New Fea-tures 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 thissoftware tool, focusing on the essential functions of this application, for example loadingand 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 RegularExpressions and a list of Abbreviations conclude this document.

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

Related DocumentationR&S CMW-KT014


2 Related DocumentationRohde & Schwarz provides a comprehensive documentation set. Depending on theinstrument you are using (R&S CMW500 or R&S CRTU-W), you will find related docu-mentation 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 thedocumentation CD-ROM (1202.3863.08). The Quick Start Guide for R&S CMW500Protocol Testing (1202.3857.62) is delivered as printed manual. It contains a list ofall manuals in its "Documentation Map". The Quick Start Guide introduces to protocoltesting and provides a short description of all R&S software products contained in theR&S protocol testing tool chain for C++ R&D testing.

R&S CRTU-W: Related manuals are contained in the Software Manuals folder ofthe product's installation DVD.

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

Fundamental ConceptsR&S CMW-KT014


3 Fundamental ConceptsTo best use the features of R&S Automation Manager, read this chapter. It explains thefundamental concepts behind the software.The primary purpose of the R&S Automation Manager is to automatically run test caseson an R&S MCT (System Simulator). From time to time, a test case issues an MMI orEMMI (AT) command to put the UE into a new appropriate state. In a manual testingenvironment, the commands are displayed on a screen, and an operator is required toperform the appropriate actions on the UE. To cope with high numbers of complex testcases within a reasonable amount of time and in addition to allow for overnight or week-end regressions, these commands need to be executed without human interaction. TheR&S Automation Manager provides this automation functions.This section describes the basic concepts of test case automation and introduces thefollowing important elements comprising an automation approach: MMI/EMMI CommandRouting, MMI Command Processing, EMMI/AT Command Processing and ResponseAnticipation.

If you are interested in a more detailed description of requirements and features of anautomated test environment for TTCN-based signaling conformance test cases, refer tothe 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 whenworking with Medium Level and Low Level Application Programming Interface basedscenarios.

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 RoutingThe following figures depict the routing context of MMI and EMMI commands in variousmanual and semi- or fully automated test architectures.The figure 3-1 depicts a test configuration which requires an operator for reading andinterpreting commands displayed on a screen. The interaction to the UE may be estab-lished by directly using the UEs operating keys (e.g. to switch on or off the UE, or toinitialize a call by dialing a number), or by using a terminal program (mainly for renderingAT commands).

MMI/EMMI Command Routing



Rohde & Schwarz System Simulator

Test Case

Tester Device under Test

Screen

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

RF

Terminal Program, e.g. HyperTerm

MMI commandsAT commands

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

The figure 3-2 depicts a test configuration which makes use of the R&S AutomationManager 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 SystemSimulator and the R&S Automation Manager.





Test Case

Tester

RS-232-C, USB, TCP/IP

RF Device under Test

Automation ManagerTCP/IP


ExternalDevice

(e.g. PSU)TCP/IPIEE488RS-232-C

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

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


Test Case

TesterDevice under Test

3G UE

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

RF

Automation Manager


RS-232-C, TCP/IPExternalDevice

(e.g. PSU)TCP/IPIEE488RS-232-C

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




An additional license is required when R&S Automation Manager is run on a separatePC.

To switch over from manual to automated testing, MMI and EMMI commands need to berouted to an RS232-C port or TCP/IP Port, from where they can be read and processedby the R&S Automation Manager, and eventually be forwarded to the device under testor an inserted additional adapter.Of course, once the routing via RS232-C port or TCP/IP port is selected, both R&S ProjectExplorer and R&S Automation Manager need to be configured in a consistent way, i.e.the R&S Project Explorers port to the R&S Automation Manager and the R&S AutomationManagers port are required to be configured identically. Here, the physical connectionbetween System Simulator and Automation Manager is of major interest. One can choosebetween 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&SProject Explorer".

For R&S CRTU-W/M only When using ETSI/MCC160 TTCN test cases, the logical switchto change over from manual to partial or full automation support is an R&S extensionPIXIT value called px_EMMISupportLevel of type ENEUMERATION, which may be setto one of DISABLED, ENABLED, or EXTENDED. This value may be defined in ATSspecific 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-2-based), LTE 3GPP TS 36.523 (TTCN-3-based) and GSM 3GPP TS 51.010-1 conform-ance test cases is specified in the R&S Test Case Explorer. For more information, referto the "R&S Test Case Explorer" manual or help.

3.2 MMI Command ProcessingMMI commands are used within a test case to inform the test operator of certain testconditions or to ask the operator to perform a task which might not be easily remote-controlled in the device under test.The most common and frequently used examples of MMI commands are the followingrequests: "Please switch off the UE" and "Please switch on the UE" at the beginning ofa test case. Assuming that the UE supports e.g. the special "AT+CFUN" command, theR&S Automation Managers task would be to intercept the plain text switch off and onrequests, and render the AT+CFUN=0 or AT+CFUN=1 commands to the UE instead.

MMI Command Processing



3.3 EMMI/AT Command ProcessingEMMI/AT commands are defined in TS 27.007 and provide a standardized command setfor controlling various UE functions, such as "dialing a number", "establishing a dataconnection", "setting QoS parameters", etc., so in most cases it will be sufficient to simplyforward the AT command to the UE.

3.4 Response AnticipationUsually, the AT modem interface of a certain user equipment is designed so that upon arequest a certain action is started, and after this action is finished, an appropriateresponse is sent back indicating the success of the action, or error codes that are asso-ciated to certain error conditions.On the other hand, most AT command dialogs in ETSI/MCC160 releases of TTCN ATSesare designed such that a UE response is expected before the action is executed. To avoida dead lock in these situations, the R&S Automation Manager should be configured tofirst anticipate the expected response, then send it back to the SS, and eventually discardthe UEs true response. Response anticipation can be configured in R&S AutomationManager by adding an action to first acknowledge the command by send "OK" to theSystem Simulator.

EMMI/AT Command Processing

Key FeaturesR&S CMW-KT014


4 Key FeaturesR&S Automation Manager serves as an operator replacement in an automated test caseexecution 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 sessionDefinition and Maintenance of UE Specific Command Conversion ProfilesAs various MMI and EMMI/AT commands might need to be translated in a different wayfor different UEs, a user specified list is maintained along with the dedicated profile of acertain UE. This list can be maintained by adding, modifying, and removing commandsas required by developing new or maintaining existing test cases. Each command canhave a list of actions associated with it such as sending a command to a specific com-munications channel or sending a specific response to the System Simulator. No auto-matic response is sent back to the System Simulator as in previous versions of R&SAutomation Manager. R&S Automation Manager does not differentiate between differenttypes of commands but tries to match any received command against the defined com-mand conversions in sequential order. A default command can be defined which is onlyevaluated after all other conversions have failed to match.

Regular Expression ParserR&S Automation Manager uses a regular expression parser to match defined commandconversions against received commands. The regular expression parser allows similarcommands to be handled by a single defined command conversion however sincereceived commands are matched against the defined command conversion in the orderin which they are listed it important to define the most specialized regular expression firstand the more generalized ones later.

ExampleIf a command conversion has an expression defined asAT\+CMMIREQ=\"Begin of TestCase (.+)\"A received command ofAT+CMMIREQ="Begin of TestCase 7.2.1"Would match this command conversion. The text 7.2.1 could then be used in a definedaction 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 infor-mation about defining commands. \ is required to delimit some special characters suchas + and in the example.

Key FeaturesR&S CMW-KT014


Multiple Action ExecutionA list of actions to execute can be defined for each command conversion allowing severaldevices to be controlled when one command is received. This allows much greater flex-ibility in responding to certain commands and is most useful for switch on or off whenpower supplies need to be controlled as well the UE or for certain commands whichtranslate into several AT commands.

Conversion of Responses from External DevicesSome test cases expect information to be returned from the UE in a specific format. Areverse 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 returnedto the System Simulator.

Configuration of System Simulator, UE and External Device ConnectionsAs the connections to the System Simulator, UE and external devices do not vary often,this information is also stored along with a UEs dedicated profile.

Monitoring MMI/EMMI Commands During a Test SessionAll commands sent to and received from the tool, including intermediate actions, aredisplayed in the Session Log pane. Switching over to the Session Log pane after clickingthe Start button in the Command Settings pane allows easy tracking of the messagestransferred from the System Simulator to the UE or other devices command interfaceand vice versa.

New FeaturesR&S CMW-KT014


5 New FeaturesSupported Channel TypesR&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

The User InterfaceR&S CMW-KT014


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

6.1 Main WindowThe main window has two areas: Monitor Test SetupThe Monitor area allows for the test session to be started by clicking the Start button orstopped by clicking the Stop button.The Test Setup area allows for the communications settings and connections to the UEor external devices to be tested.

Window PanesBelow the two areas above mentioned, there are three panes provided: Forward Conversion pane; see figure 6-1 on page 16 Reverse Conversionpane; see figure 6-2 on page 17 Session Log pane; see figure 6-3 on page 18

6.1.1 Forward Conversion PaneThe left hand side of the Forward Conversion Pane displays all commands of a UEspecific profile that will be received from the R&S MCT and need to be translated duringa test session with this UE. Each forward conversion is specified with a regular expressionwhich will match to the command as scanned and identified from the R&S MCT.The right hand side of the pane displays the list of actions that will be carried out whenthe selected command is received and should include the response to send to the R&SMCT 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 detailedconfigurations, to handle timing issues or associated user specific actions.For a detailed description of the forward conversion configurations, refer to the descriptionof the chapter 6.2, "Menus", on page 18.

If commands are received that are not matched in the conversion table, a match to thedefault forward conversion (highlighted in red) will be attempted. If this match also fails,no action will be taken. The regular expression (.+) which evaluates one or more characterof any type is recommended as the default conversion to match anything not explicitlydefined.

Main Window



Fig. 6-1: Forward Conversion pane

6.1.2 Reverse Conversion PaneThe Reverse Conversion pane is very similar to the forward conversion pane but is usedto define conversions for responses read from any connected devices other than the R&SMCT such as the UE.

Main Window



Fig. 6-2: Reverse Conversion pane

6.1.3 Session Log PaneOnce a test session is started, the message transfer between the R&S MCT, UE andexternal devices via the R&S Automation Manager are displayed in the Session Logpane. According to the Forward and Reverse Conversion tables, arriving commandsfrom the R&S MCT will be translated into UE specific commands and sent to the specifiedcommunications channel. The other configuration parameters are also applied, e.g. tim-ing port access manipulations like execution or response delays, etc.

Received commands that are not matched in the conversion table are displayed in theSession Log pane with the text Info : Command not found using default handler. If nomatch is made to the default command then no other action will be displayed in the ses-sion log pane.

Main Window



Fig. 6-3: Session Log pane

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

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

6.2.1 File MenuWith the functions of the File menu, maintenance of UE specific profiles is supported ona file level. The File menu comprises choices to create a new profile, open an existingone, save the current one, save the current one as an alternative file, or to directly exitR&S Automation Manager. In addition, a history list of recently loaded files is displayedfor direct opening of these files without the need to explicitly browse to its dedicatedlocation.

Menus



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

NewIf the New command is selected, the current profile is closed without any change andan empty Forward Conversion pane is displayed, referring to a new profile which is stillUntitled (see also the task bar contents).

OpenSelect the Open command to browse for a profile stored in the file system.

SaveSelect the Save command to save the currently loaded profile to its original location inthe file system.

Save AsSelect the Save As command to browse for a dedicated location and to save the profilewith a new file name.

Exit

Use the Save or Save As functions before exiting, otherwise your changes of thecurrently loaded profile are lost.

Select Exit to immediately close the R&S Automation Manager.

6.2.2 Edit MenuWith the functions of the Edit menu, maintenance of UE specific profiles is supported ona 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

Menus



To make use of theAdd Command function of the Edit menu, just click on that function.For the other Modify and Remove Command functions, one of the existing commandtranslations must previously have been selected by means of clicking on one of theentries 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 AddCommand on the Edit menu. A dialog window will be displayed to allow a detailed spec-ification 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 beused within defined commands and replacements to be built from the regular expressionparser. Please read section in chapter 9, "Regular Expression Parser", on page 34 formore information.

Each Action is defined as a replacement command, two delays to be applied before andafter the action and a channel over which to send the replacement. While the Beforedelay defines the time between receiving the R&S MCT Command (or completion of theprevious action) and sending the Replacement, the After delay defines the time betweensending the replacement and processing the next action. The Channel selects over whichcommunications channel to send the replacement command.Table 6-1: Forward Command buttonsButton 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 tostore 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 commandA list of actions to execute can be defined for each command conversion allowing severaldevices to be controlled when one command is received. This allows much greater flex-ibility in responding to certain commands and is most useful for switch on or off whenpower supplies need to be controlled as well or for certain commands which translateinto several AT commands.

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 FieldsField/Flag Description

Expression This is the MMI/EMMI request command sent from the R&S MCT. When the R&S Automation Man-ager receives an MMI/EMMI request command, it will search the list of commands in the profile tryingto 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, theduplicate commands will not be processed by the R&S Automation Manager. This allows for situationswhere the command to switch on or off a UE is actually the same. If a test case switches off the UEat the beginning and end then when the next test case is run a second switch off command will bereceived resulting in the sequence of on or off being invalid. Ignoring the duplicate command in thissituation 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. Withoutthis response the test case would not continue execution and should be used to just acknowledgethe command was completed.

Replacement This is the command that the R&S Automation Manager will send to the UE or external devices insteadof the received MMI/EMMI Command from the R&S MCT. To just accept e.g. MMI operator instruc-tions that do not require any interaction on the UE or external devices, just define an acknowledge-ment 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 Replace-ment command. (e.g.: if a UE is switched Off, it may take a while for it to complete its detach proce-dures. 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 Replace-ment command before reading a response and executing the next action (e.g.: if a UE is switchedOn, it may take a while for it to boot up. As a result any subsequent actions would need to be delayed)

Menus



Field/Flag Description

Channel This is to allow the communications channel, over which to send the command, to be selected. Thisallows 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 eachtime when sending each Replacement command. Otherwise the port is opened once and not closeduntil the session is ended. This option should be used when the channel connection will be lost andshould be re-established when the next command is sent. When a UE is switched off the connectionis often broken and the port should be released in this situation to avoid any problems when sendingthe next command.

Process Response If this flag is enabled the R&S Automation Manager will read the response from the Channel (afterthe post command delay) and attempt to match the response with the commands in the reverseconversion pane. If this flag is not enabled the R&S Automation Manager will read and discard anyresponse 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 donot 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 Com-mand dialog, a file browser opens which allows you to select a dedicated script or pro-gram 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 translationis loaded into the command dialog. With the same means as described in the Add Com-mand 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 conversionsby selecting the Remove Command function.

6.2.3 View MenuThe View menu will offer a choice to clear the contents of the Session Log pane.

Fig. 6-7: View Menu

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

Menus



Enable File LogSelect 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 LogSelect the Disable File Log function to stop logging of entries in the Session Log paneto file.

6.2.4 Tools MenuThe Tools menu will offer some choices to configure the communications channels andto 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. Thisdialog 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 com-

mandsFor a flexible layout of remote control scenarios, different types of channel types aredefined: RS232-C, TCP/IP, IEEE_488.1, IEEE_488.2, VISA and CMW-ZASB. Depend-ing on the selected channel type, the corresponding channel setup dialog is tailored toits 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 con-nected to the System Simulator and should be the default channel.

Menus



Fig. 6-9: RS232-C Channel Setup

The following table provides a brief description of the all settings in the Channel Setupdialog:

Table 6-3: Channel Setup dialog - settingsField Description

Channel List This is a list of defined communications channels. The channel name is used in the Command defi-nition to select where the replacement command is sent. The channel type defines the basic com-munications type and can be either RS232-C, TCP/IP, IEEE_488.1, IEEE_488.2, VISA or CMW-ZASB. The name and type of channel is configured when a new channel is added using the Addbutton. Existing channels can be deleted using the Remove button. Existing channels can be modifiedusing the Modify button. The specific channels configuration is displayed on the right hand side ofthe dialog.

New Channel This is where a new channel is defined before adding to the channel list. Configure a name so thatthe 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 bedefined via a combo box, presenting a suitable selection for the corresponding value. Two additionalparameters can be configured which are especially useful for USB virtual RS-232-C ports. Retryattempts sets the number of time that R&S Automation Manager will try to open a connection and theretry delay is the time R&S Automation Manager will wait between retries. If a USB virtual RS 232-Cport might be disconnected (e.g. when a device is switched off) this will allow it to be more reliablyreconnected. The channel must be released after the last valid communication to the RS-232-C portfor the retry mechanism to be successful.

IEEE_488.1 and IEEE_488.2Settings

Specify the settings for a GPIB channel. Specific channel parameters are primary address, secondaryaddress, 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.

Menus



Field Description

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

CMW-ZASB Settings Specify the settings for a CMW-ZASB channel. Specific channel parameters are the serial numberof the R&S CMW-ZASB automation switch box. The type plate showing the six-digit serial number islocated on the bottom of the R&S CMW-ZASB.The following commands are supported, and can be used in any combination:-usb1 onoff-usb2 onoff-gp1 onoff-gp2 onoff-trig1 onoff-trig2 onoff-port where is a decimal or hexadecimal (0xYY) value indicating the required status. Forexample, 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 usecompound 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 offSee the table 6-4 for supported port values.The individual port commands set the individual port but leaves all other ports as they were. Forexample, -usb1 on is an individual port command.The channel will return the current status in the hexadecimal notation 0xYY. For more informationabout 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 hexadecimalnotation. A port value sets on the specified ports and sets off all others.Table 6-4: CMW-ZASB channel, value list for the -port commandDecimal 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


7 0x07 USB 1, TRIG 1, TRIG 2

8 0x08 USB 2


10 0x0A USB 2, TRIG 2

11 0x0B USB 2, TRIG 1, TRIG 2

Menus



Decimal notation Hexadecimal notation Port status "on" for ports

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 GP 1, USB 2, TRIG 1, TRIG 2

28 0x1C GP 1, USB 1, USB 2

29 0x1D GP 1, USB 1, USB 2, TRIG 1

30 0x1E GP 1, USB 1, USB 2, TRIG 2

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 GP 2, USB 1, TRIG 1, TRIG 2

40 0x28 GP 2, USB 2

41 0x29 GP 2, USB 2, TRIG 1

42 0x2A GP 2, USB 2, TRIG 2

43 0x2B GP 2, USB 2, TRIG 1, TRIG 2

44 0x2C GP 2, USB 1, USB 2

Menus



Decimal notation Hexadecimal notation Port status "on" for ports

45 0x2D GP 2, USB 1, USB 2, TRIG 1

46 0x2E GP 2, USB 1, USB 2, TRIG 2

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 GP 1, GP 2, USB 1, TRIG 2

55 0x37 GP 1, GP 2, USB 1, TRIG 1, TRIG 2

56 0x38 GP 1, GP 2, USB 2

57 0x39 GP 1, GP 2, USB 2, TRIG 1

58 0x3A GP 1, GP 2, USB 2, TRIG 2

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)

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 EscapeSequences dialog which allows for configuration of custom escape sequence identifiersfor 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

Menus



6.2.4.3 Monitor Start / Monitor Stop

The Monitor Start function starts a normal session log. This will make R&S AutomationManager enable the R&S MCT connection, that is, to listen to commands received viathis 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 theMonitor area of the main window.

Monitor StopThe Monitor Stop function will stop the session.

Selecting this function from the tools menu is identical to clicking the Stop button in theMonitor area of the main window.

6.2.5 Help MenuThe Help menu provides the option to display the help system (Help Topics) or theAbout dialog.

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

AboutThe About option provides information on, tool name, developer, software version andcopyright.

Menus

Essentials of UsageR&S CMW-KT014


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

7.1 LicensingRohde & Schwarz Mobile Communication Tester (MCT) software and test cases aresubject to license conditions. A special hardware and license keys are required to activatethem.For more information on how to generally license Rohde & Schwarz software options andon how to manage licenses, see the "MCT Licensing" manual or the "R&S License Proxy"help.

Starting R&S Automation ManagerThe 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 ProfileThere are two ways to load a profile. You can either open one of the recently loadedprofiles listed in the File menu, between the separators or go through the File - Opendialog. 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 yourneeds.

Licensing



Configuring the R&S MCT, UE and External Devices ConnectionsFollow the procedure below when configuring the ports for the R&S MCT, UE and externaldevices connections. As the R&S Automation Manager is a stand alone application, it isimportant 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 communi-cation port (default: 4754).The IP Address field should be 255.255.255.255 forthe SIMULATOR channel.

Serial Select this option, if the tool is running as a stand alone application in adifferent personal computer and is connected to the System Simulator using aSerial 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 TestsPrior to performing any automation, the connections to the UE can be tested by sendingthe 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 # AttentionAT+CGMM # Request Model IdentificationAT+CGMR # Request Revision IdentificationAT+CGMI # Request Manufacturer IdentificationAT+CIMI # Request International Mobile Subscriber IdentityAT+CGSN # Request Product Serial Number IdentificationAT+CBC # Battery StatusAT+CSQ # Signal QualityFor a detailed description of AT commands, refer to the 3GPP Technical SpecificationTS 27.007, AT Command Set for User Equipment (UE).

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

Licensing



Terminating a Monitoring SessionTo terminate a monitoring session click the Stop button in the main window. You canthen close the R&S Automation Manager.

Licensing

TipsR&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. Thesample is configured to run on the R&S MCT through the TCP/IP connection con-trolling a device via a serial port.

The R&S Automation Manager is specially designed to cooperate with the R&S Proj-ect Explorer. As the R&S Automation Manager allows you to configure the R&S MCTconnection, i.e. the connection to the R&S MCT's Project Explorer, also the R&SProject Explorers connection to the R&S Automation Manager needs a matchingconfiguration. For more details about this connection, refer to the "MCT Tools" man-ual, chapter "R&S Project Explorer".

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

Be sure to have started the monitoring session in the R&S Automation Manger beforestarting a test case or a scenario. Otherwise MMI or EMMI commands might get loston 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 Termi-nation is enabled within R&S Project Explorers settings.

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

When communicating to devices which use USB Virtual RS-232-C ports, the actualport may not exist on Windows PC when the device is switched off. This can causeautomation failure. After sending a command to the device (or another device) whichwill 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 theChannel multiple times over a period of time when the next command needs to besent.

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

Regular Expression ParserR&S CMW-KT014


9 Regular Expression ParserCommand conversions may be specified with the help of regular expressions. A regularexpression is a string that describes or matches a set of strings, according to certainsyntax rules. Regular expressions are powerful means to significantly reduce the numberof conversion specifications. R&S Automation Manager uses regular expression match-ing for both Forward and Reverse Command conversion, thus allowing a flexible adap-tation between differing user equipment and test case or R&S MCT format requirements.

ExampleGiven a sequence of test cases, each of them indicating both start and stop events withan operator MMI command, containing an unique test case ID, the stop event additionallycontaining the (final) verdict. Due to test case automation reasons, each of the MMI com-mands shall be converted to a user defined format.With 200 test cases and 4 possible result verdicts, 1000 command conversions wouldhave to be specified without the help of regular expressions, as shown by the followingtable:

Command Replacement

AT+CMMIREQ="Begin of TestCase 1.1.1" TC 1.1.1 START ...

AT+CMMIREQ="End of TestCase 1.1.1 : VerdictPASS"

TC 1.1.1 STOP (PASS)

AT+CMMIREQ="End of TestCase 1.1.1 : VerdictFAIL"

TC 1.1.1 STOP (FAIL)

AT+CMMIREQ="End of TestCase 1.1.1 : VerdictINC"

TC 1.1.1 STOP (INC)

AT+CMMIREQ="End of TestCase 1.1.1 : VerdictNONE"

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 : VerdictPASS"

TC 7.2.19 STOP (PASS)

AT+CMMIREQ="End of TestCase 7.2.19 : VerdictFAIL"

TC 7.2.19 STOP (FAIL)

AT+CMMIREQ="End of TestCase 7.2.19 : VerdictINC"

TC 7.2.19 STOP (INC)

AT+CMMIREQ="End of TestCase 7.2.19 : VerdictNONE"

TC 7.2.19 STOP (NONE)

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

Regular Expression ParserR&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 con-version, the test case number is referenced through the use of $1. In the second one, thetest case number and final verdict are referenced through the use of $1and $2, respec-tively.

Some characters are escaped via the use of "\" because the regular expression parsermakes use of these characters if they are unescaped (e.g period, double quote, openingbrace, closing brace, etc.). The "+" character is interpreted by the regular expressionparser as a repetition sequence meaning match one or more occurrences of.

Regular Expression Reference (Abbreviated)R&S CMW-KT014


10 Regular Expression Reference (Abbreviated)Table 10-1: Regular Expression ReferenceLiteral 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 numberxxx

\xnn The ASCII character specified by the hexadecimalnumber 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 anumber from 0 to 9

\u Convert first character of replacement pattern touppercase

\U Convert entire replacement string to uppercase

\l Convert first character of replacement pattern to low-ercase

\L Convert entire replacement string to lowercase

Repetition

Regular Expression Reference (Abbreviated)R&S CMW-KT014


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 morethan m times

Options

i Do-case insensitive matching

Grouping

() Group several items into a single unit that can be usedwith ?,+,*

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

Extended Regular Expression

(?|.) Matches but doesnt 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

Glossary: AbbreviationsR&S CMW-KT014


Glossary: AbbreviationsA

ASP: Abstract Service Primitives

AT: ATtention command

ATS: Abstract Test Suite

DDUT: Device Under Test

EEDGE: Enhanced Data Rates for GSM Evolution

EMMI: Electrical Man Machine Interface

GGERAN: GSM EDGE Radio Access Network

GPIB: General Purpose Interface Bus

GPRS: General Packet Radio Service

GSM: Global System for Mobile Communication

HHTML: HyperText Markup Language

IIP: Internet Protocol

MMCT: Mobile Communication Tester

MM: Mobility Management

MMI: Man Machine Interface

PPC: Personal Computer

PSU: Power Supply Unit

Glossary: AbbreviationsR&S CMW-KT014


QQoS: Quality of Service

SSAP: Service Access Points

TTC: Test Case

TCP: Transmission Control Protocol

TTCN: Tree and Tabular Combined Notation

UUE: User Equipment

UT: Upper Tester

UTRAN: Universal Terrestrial Radio Access Network

XXML: eXtensible Markup Language

IndexR&S CMW-KT014


Index AAbbreviations .................................................................. 38

CConfiguring the Connections ............................................ 31

EEdit menu ........................................................................ 19

Add Command .......................................................... 20Modify Command ...................................................... 22Remove Command .................................................... 22

EMMI/AT Command Processing ...................................... 11

FFeatures .......................................................................... 12File Menu ........................................................................ 18Forward Conversion Pane .............................................. 15Fundamental Concepts ...................................................... 7

HHelp menu

Help Topics ................................................................ 29Help system .................................................................... 29Help Topics ...................................................................... 29

KKey Features .................................................................... 12

LLicense key ...................................................................... 30Licensing .......................................................................... 30Loading a UE Specific Profile .......................................... 30

MMain Window .................................................................. 15MMI/EMMI Command Routing .......................................... 7MMI Command Processing .............................................. 10

PPerforming Special UE Tests .......................................... 31

RRegular Expression Parser .............................................. 34Response Anticipation .................................................... 11Reverse Conversion Pane ........................................ 16, 17

SSession Log Pane ............................................................ 17Starting ............................................................................ 30Starting a Monitoring Session .......................................... 31Supported Channel Types

CMW-ZASB .............................................................. 14VISA .......................................................................... 14

TTerminating a Monitoring Session .................................. 32Tips .................................................................................. 33Tools menu ...................................................................... 23

Channel Setup .......................................................... 23Escape Sequence Settings ...................................... 28Monitor Start / Monitor Stop ...................................... 29

UUser Interface .................................................................. 15

VView menu ...................................................................... 22

Clear Session Log .................................................... 22Disable File Log ........................................................ 23Enable File Log .......................................................... 23

WWindows Panes .............................................................. 15

CoverContents1 Introduction2 Related Documentation3 Fundamental Concepts3.1 MMI/EMMI Command Routing3.2 MMI Command Processing3.3 EMMI/AT Command Processing3.4 Response Anticipation

4 Key Features5 New Features6 The User Interface6.1 Main Window6.1.1 Forward Conversion Pane6.1.2 Reverse Conversion Pane6.1.3 Session Log Pane

6.2 Menus6.2.1 File Menu6.2.2 Edit Menu6.2.2.1 Add Command6.2.2.2 Modify Command6.2.2.3 Remove Command

6.2.3 View Menu6.2.4 Tools Menu6.2.4.1 Channel Setup6.2.4.2 Escape Sequence Settings6.2.4.3 Monitor Start / Monitor Stop

6.2.5 Help Menu

7 Essentials of Usage7.1 Licensing

8 Tips9 Regular Expression Parser10 Regular Expression Reference (Abbreviated) Glossary: Abbreviations Index

Documents

MCT SM AutomationManager