R&S®SMW200A Creating Tutorials
Contents
1. DISPlay FOCus lt ObjectName gt used to highlight parameters These SCPI commands use internal identifiers lt ObjectName gt and are not described here The SCPI commands are pro vided for the sake of completeness The content have been formatted for better reading lt p gt lt b gt Goal lt b gt Generating a simple WCDMA 3GPP QPSK 45 amp deg Offset signal with the help of the Custom Digital Modulation functionality lt p gt lt p gt lt b gt Required options lt b gt R amp S SMW base unit lt p gt lt p gt lt b gt Initial situation lt b gt Configuration performed in tutorial 01 UnmodulatedSignal lt p gt lt p gt Changed parameters are highlighted in orange lt p gt scpi recommended preset the instrument and close all dialogs RST disp dial clos all disp foc command highlights the BB block disp foc Baseband A disp mess In the block diagram select Baseband A Highlight the Baseband A button disp foc gt gt gt gt Baseband A BUTTON disp mess Navigate to the section Misc gt Custom Digital Mod and select it disp foc clk gt gt gt gt _Baseband A BUTTON Open the Custom Dig Mod dialog disp dial open BasebandDigitalModMainSqSSAsto disp mess The Custom Digital Modulation dialog opens Recommended order 1 Highlight the parameter 2 Display a message 3 Send the SCPI command disp foc gt gt gt gt IdPDbDmstan HO CO S0 DO COMBO ME2. asctosx0 yl46ghiswi ag oF DISPlay MESSage Select General gt set ace to standard gt WCDMNA 3GPP ade SOURcel BE DM STiANdard WIGP 20 R SOURcel bBB DM 5STATe 1 25 DbISPlay bIALog CPEN BasebandbigitalModMain q352A5t55m35Wy1465h5395 wees 29 DISPlay DIaALog OPEN BasebandbigitalModMainsg5 25t05x35 714655395 wees 30 DISPlay DIALog CLOSe BasebandDigitalModMaingg ja ad OUTFut1 5TATe 1 Fig 3 2 Example of a partly revised tutorial file Line 1 6 Description displayed on tutorial s start Line 7 11 Empty lines improves readability Line 8 Mandatory the instruments recognizes tutorial files by the string SCPI Line 9 10 Recommended at the beginning of a tutorial Line 12 14 Comments Line 20 25 Recommended structure show an info message open the dialog or the tab send the required SCPI command to set the parameter Highlighting elements and inserting a blinking cursor The methods and options introduced in the previous sections are sufficient to present a new instrument s feature User guidance can be additionally improved through ele ments highlighting To highlight elements on the user interface the tutorials make use of the special SCPI command DISPlay FOCus lt ObjectName gt The user interface identifiers lt ObjectName gt are company confidential information that can be retrieved only by the software developers Application Sheet 1MAD 46 M Niederhaus 06 2015 0
3. the specified dialog To determine the dialog identifier use the command DISPlay DIALOG ID Setting parameters lt Dialogld gt string Usage Setting only Closes all open dialogs Recommended in the beginning of any tutorial Usage Event DISPlay MESSage lt MessageText gt Defines a text that will be displayed in the Info line The text is displayed until the Next Step button is pressed Parameters lt MessageText gt string enclosed in apostrophes To highlight a part of the text use the standard HTML elements see Overview of the supported HTML elements on page 14 Example DISPlay MESSage For lt i gt intra band lt i gt 2x2x2 scenario tap on the I Q Stream Mapping tap 5 Learn More About the R amp S SMW For a comprehensive description of the R amp S SMW capabilities and features including the remote control refer to e the R amp S SMW embedded help e the R amp S SMW user manual The latest version is available for download at the product homepage http www rohde schwarz com product SMW200A html How to Test Your Tutorial 6 Annex Example Source code of a tutorial file tut The following is the source code of the tutorial file 02 Digital lyModtlalcd gt ignal uc The source code follows the recommended tutorial s structure It includes comments that are the lines starting with the hash sign The source code includes also the SCPI commands
4. 1 gt Password 3 Enter the Protection Level 1 password The default password is 123456 To start the integrated recording function of the instrument 1 Press the SETUP key and select Help gt Tutorials Tutorials 2 Inthe Tutorials dialog select Create The SCPI recording function is started 3 Perform the configuration steps that need explanation The R amp S SMW tracks the changes automatically Tip If you perform an unnecessary step or make an undesired setting no need to terminate or restart recording Redundant or wrong information can be removed at a later stage see To revise the recorded file and add additional information on page 9 4 After the configuration is completed terminate the recording That is left click to access the context menu and select Stop automatic SCPI recording oi Stop automatic SCPI recording The SCPI Sequence dialog opens and displays the SCPI list with the remote con trol commands Tracked are not only the settings but also the interactions with the instrument like opening and closing of dialogs and tabs How to Start the Integrated Recording Function SCPI Sequence DISPlay DIALog CLOSe CSmwDig_TutorialScpi DISPlay DIALog CLOSe SMUMenu SOURce1 FREQuency CW 1955000000 SOURce1 POWer POWer 20 DISPlay DIALog OPEN BasebandDigitalModMain q A t0 x0 y146 h1 w1 SOURce1 BB DM STANdard W3GP SOURce1 BB DM STATe 1 DISPlay DIALog OPEN BasebandDigi
5. 3 10 How to Test Your Tutorial 3 3 How to Test Your Tutorial To store the file and transfer it to the instrument gt Use one of the standard methods and transfer the tut file to the var user directory of the instrument or start the tut file from a connected USB memory stick For step by step instructions refer to section Files and Data Management in the R amp S SMW user manual or use the embedded help of the instrument To start the tutorial 1 Select SETUP gt Help gt Tutorial 2 Select File gt User Defined and select the tutorial file If the file contains a description it is displayed 3 Select Start Related Remote Control Commands DEP m Bl Eins a aa E dared ame a EA A E E E E A 11 DISPlay DIALOg OPEN A 11 DISPESYDIAL SEE DEE een nenne anne 12 DISPlay DIALOg CLOS GALL o ccccinsssisizenceentabigidd denen ee 12 DOPIN MNES AOE oera E E E Aa a 12 DISPlay DIALog ID Returns the dialog identifiers of the open dialogs in a string separated by blanks Return values lt DialogldList gt lt dialog ID 1 gt lt gt lt dialog ID 2 gt lt gt lt gt lt dialog ID n gt Usage Query only DISPlay DIALog OPEN lt Dialogld gt Opens the specified dialog To determine the dialog identifier use command DI Play DIALO ID Setting parameters lt Dialogld gt string Usage Setting only How to Test Your Tutorial DISPlay DIALog CLOSe lt Dialogld gt Closes
6. NU disp mess Select General gt Set acc to standard gt WCDMA 3GPP sourl bb dm standard W3GP Highlight subsequently two parameters disp foc IdPDbDmSymbRate HO CO S0 DO How to Test Your Tutorial d1sprEoE gt gt gt gt 1IdFDbEnTod ng HO CO 50 DO COMBO BOX disp mess The Symbol Rate and Coding are set accordingly d sprr9e gt gt gt 5 gt TdPdDbDnStare BO CO 50 DO SWITCH disp mess Select General gt State gt On to enable signal generation sourl bb dm stat 1 Removes the highlighting dispi rec disp mess Tap on the Modulation tab disp dial open BasebandDigitalModMainsqgSSASt5 disp foc gt gt gt gt IdPDbDmModType HO CO SO DO COMBO MENU disp mess Note the used Modulation Type observe the constellation diagram and close the dialog disp dial clos BasebandDigitalModMainSqSSASt0O disp foc I Q Mod A disp mess The instrument activates automatically I Q Mod A uses the internal trigger and clock signals and disp foc Baseband A disp mess generates a WCDMA 3GPP signal modulated with a QPSK 45 deg Offset modulation Overview of the supported HTML elements Block elements e lt p gt a paragraph of text e lt ul gt unordered list list items are displayed with a bullet Inline elements used for styling purposes e g to emphasize a range of text e lt i gt emphasis displayed in italic type lt b gt emphasis displayed in bold type
7. R amp SESMW200A Creating Tutorials and Interactive Examples Application Sheet 1MAD 46 M Niederhaus 06 2015 03 un dp m Test amp M Application Sheet This manual describes firmware version FW 3 20 261 xx and later of the R amp S SMW200A 2015 Rohde amp Schwarz GmbH amp Co KG Muhldorfstr 15 81671 M nchen Germany Phone 49 8941 29 0 Fax 49 89 41 29 12 164 E mail info rohde schwarz com Internet www rohde schwarz com Subject to change Data without tolerance limits is not binding R amp S is a registered trademark of Rohde amp Schwarz GmbH amp Co KG Trade names are trademarks of the owners The following abbreviations are used throughout this manual R amp S SMW200A is abbreviated as R amp S SMW O a A Q N Contents vynat are TUtCONAIS Zearra NEA EEA EEA 3 How fo Start a TUlOrlAl 00 0m HRG aiara aiaia 3 Creating Custom Interactive Examples u 2 200 2002000n000n0nan00n0 6 Related Remote Control CommandsS 222002n00n n00nnnnnn nenn 11 Learn More About the R amp S SMW u 22u0022000 n0nnnnnnnnnnn nun nnn nn 12 PAG E E E E A E E E 13 What are Tutorials Tutorials are text files with small file size and a mandatory file extension tut A tutorial file contains the mandatory string scpi followed by a sequence of SCPI commands A set of tutorials is embedded in the software The R amp S SMW
8. elect If the file contains a description it is displayed Tutorials 30_LTE_CA_2x2MIMO_CrossSched Goal Generating a 2x2MIMO LTE signal with carrier aggregation and cross carrier scheduling Knowledge on operating the instrument and background information on LTE are assumed Required options R amp S SMW equipped with 2xR amp S SMW B10 2xR amp S SMW K55 2xR amp S SMW B14 1xR amp S SMW K 4 1xR amp S SMW B13T 2xR amp S SMW B103 Changed parameters are highlighted in orange 5 Use the default mode that is Execution Mode gt Interactive 6 Tap on the Start button 7 Observe the information displayed in the Info line bottom of the display 1 Information on the performed action 2 Progress bar 3 Next Step confirms the execution of the step 4 Stop terminates the tutorial 8 To execute a subsequent step select the Next Step button A blinking cursor indicates the block or parameter affected by the step Mode The instrument performs the configurations step by step and expects your confir mation Dialogs are opened and closed changed parameters are highlighted in orange Additional information is displayed in the Info line 3 1 How to Start the Integrated Recording Function To stop the tutorial The demonstration can be terminated at any time gt Select the Stop button The demonstration stops You may reopen the Tut
9. nd comments to simplify the reading To add internal comments start a line with the hash sign e Use the DISPlay MESSage command to include lines with information that will be displayed to the users Application Sheet 1MAD 46 M Niederhaus 06 2015 03 9 R amp S SMW200A Creating Custom Interactive Examples f Add a description that will be displayed on tutorial start Ideally it should describe the goal and list the required options 1 lt pr lt b gt Goal lt hb gt Generating a simple WCDMA 3GFF QOPSE 45 deq Offset 2 signal with the help of the Custom Digital Modulation functionality lt s p gt 3 lt po lt h gt Required options lt b gt Res SMW base unit lt p gt 4 lt pe lt ch gt Initial situation lt b gt 5 configuration performed in tutorial Ol UnmodulatedSignal lt p gt 6 lt p gt rChanged parameters are highlighted in orange lt p gt ii a K scpr Ba RST 10 DISPlay DIlaLog CLOSe aLL LI 12 Split long messages into parts 13 DISFPlay MESSage To set the frequency on the Status Bar tap the A Freg field 14 Message cont 15 DISFlay MESSage Enter 1 955 and press the GHz Key 16 SOURcel FREQuency cW 1955000000 Lg 15 SOURcel PoWer PoWer 20 LS z0 DISPlay MES5age In the block diagram select Baseband A Gal DISPFlay MESSage Navigate to the section Misc gt lustom Digital Mod and select it oe DISPlay DIALog CFPEN BasebandDigitalModMaing gs
10. ndard methods and transfer this file to your PC For example use an USB memory stick or mount the var user directory of the R amp S SMW in the explorer of your PC For step by step instructions refer to section Files and Data Management in the R amp S SMW user manual or use the embedded help of the instrument 3 2 How to Revise the Recorded File To revise the recorded file and add additional information 1 Use a text editor and open the recorded file e g my tutorial tut LISFPlay DIAlLog CLOSe Camublg Tutorialscpi DISFlay bDIALog CLOSe SMUMenu SOUEcel FREQuencoy cW 1955000000 SOoURcel F Wer PQ Wer 20 DISFPlay DIALog CPEN BasebandbigitalNodMain gy55A5t05x0syv1465hl5wl SOURCel EB DM STANdard W3GR SOUFRcel BB DM STATe 1 TISPlaw DIALog CPEN BasebandbigitalModMain q35A rt55x35171465h539 vaga DISFPlay DIALog OPEN BasebandbigitalModMain yg5525t05x35yv1465h5395 wae TISPlawr DIALog CLOSe BasebandfigitalModMainsgssa OUTTPut1 5TiATe 1 1 a 6 im H e Oo 2 Add the mandatory key string scpi It must be the first SCPI command in the file 3 We also recommend that you a Add the RST command right after the scpi string b Use the DISPlay DIALog CLOSe ALL to close all opened dialogs c Remove unnecessary SCPI commands For example delete the commands DISPlay DIALog CLOSe CSmwDlg TutorialScpi and DISPlay DIALog CLOSe SMUMenu without substitution d Add empty lines a
11. not recommended for text in the Info line lt span gt text can be displayed in a different color or on a colored background Example lt P gt lt b gt Required options lt b gt R amp S SMW equipped with lt p gt lt ul gt lt li gt first optionslli gt lt li gt second optionslli gt lt ul gt DISPlay MESSage This the beginning of a lt i gt tutorial lt i gt DISPlay MESSage Press the lt span style background color blue gt SETUP lt span gt key DISPlay MESSage lt span style color red gt End of tutorial lt span gt
12. orials dialog and start another file or exit the tutorial mode To use the demonstration mode 1 Start the tutorials as described in To start a tutorial in an interactive step by step mode on page 3 2 Inthe Tutorials dialog select Execution Mode gt Auto Looped 3 sec The configurations are performed automatically and your interaction is not required Dialogs are opened and closed changed parameters are highlighted in orange Additional information is displayed in the Info line Creating Custom Interactive Examples The R amp S SMW provides a dedicated Create Tutorials function that makes use of the integrated SCPI recording function of the instrument While configuring the instrument this function tracks the settings and automatically creates SCPI lists with the required remote control commands To create your own tutorial Perform the following main steps 1 Start the integrated recording function of the instrument 2 Revise the recorded file add mandatory and additional information 3 Store the tutorial file transfer it to the instrument and play it How to Start the Integrated Recording Function The Create Tutorials function is a password protected function that requires the Pro tection Level 1 password How to Start the Integrated Recording Function To unlock the Protection Level 1 1 On the instrument s front panel press the SETUP key 2 Select Security gt Protection gt Protection Level
13. searches for custom tutorial files in the var user directory or on a connected USB memory stick When a tutorial file is started the R amp S SMW performs the configurations step by step Dialogs are opened and closed automatically changed parameters are highlighted in orange Additional background information or explanation on the performed actions may also be displayed You may use the tutorials functionality to create interactive examples and demonstra tions if for instance e the R amp S SMW provides a new functionality that needs to be explained to different users like for example colleagues or customers there is a particular configuration or a comprehensive feature that needs a demon stration e your goal is to impart knowledge and skills e g that the users are able to imitate the required steps and understand the process How to Start a Tutorial A set of tutorials is embedded in the software To start a tutorial in an interactive step by step mode 1 Press the SETUP key on the front panel 2 Scroll down in the list tap on the Help section to expand it and tap on Tutorials Help Manual Index The Tutorials dialog opens 3 Select File gt Load Predefined Tutorial Select Tutorial File 08_LTESignal_Basics 09_MIMO_GettingStarted 30_LTE_CA_2x2MIMO_CrossSched 90_BBPowerMeas_Cont Acquisition 91_BBPowerMeas_GatedAcauisition 4 Tap on a tutorial from the list and confirm with S
14. talModMain q S A t5 x3 y146 h539 w888 DISPlay DIALog OPEN BasebandDigitalModMain q A t0 x3 y146 h539 w888 DISPlay DIALog CLOSe BasebandDigitalModMain q A OUTPut1 STATe 1 Remove Last SCPI Command Fig 3 1 SCPI Sequence dialog 1 SCPI commands for setting of parameters 2 dedicated SCPI commands for user interface control For a description of the dedicated SCPI commands see chapter 4 Related Remote Control Commands on page 11 Export the recorded SCPI sequence as a plain SCPI text file and transfer the file to your PC 1 Inthe SCPI Sequence dialog select Export and export the SCPI list as a plain SCPI text file with a user defined name e g my tutorial SCPI Recording Export Plain SCPI DISPlay DIALog CLOSe SMUMenu SO0URcel FREQuency CW 1955000000 SOURcel POWer POWer 20 DISPlay DlALog OPEN BasebandDigitalModMain q A t0 x0 y146 h1 Swi SOURcel BB DM STANdard W3GP SsOURce1 BB DM STAlTe 1 DISPlay DIALog OPEN BasebandDigitalModMain q A t5 x3 y 146 h539 wee3 DISPlay DIALog OPEN BasebandDigitalModMain q A t0 x3 y 1 46 h539 we8s DISPlay DIALog CLOSe BasebandDigitalModMain q A DISPlay DIALog CLOSe CSmwDlg_TutoralScpi OUTPut1 5TATe 1 R amp S SMW200A Creating Custom Interactive Examples Per default the text file is stored in the var user directory of the instrument The mandatory file extension tut is assigned automatically 2 Use one of the sta
Download Pdf Manuals
Related Search