TTsuite-WAVE-DSRC First Steps User s Guide

Transcription

1 TTsuite-WAVE-DSRC General Information This user s guide helps you to download and install TTworkbench, and leads you through configuring and running test cases of TTsuite-WAVE-DSRC. For a successful proceeding please follow the instructions step by step! If you need any assistance, please contact Spirent s customer care department: Mr. Dirk Borowski Manager Support Services Phone: support@spirent.com spirent.com

2 Table of Content 1. Requirements Test Environment and Test Suite Hardware Requirements Upper Tester Implementation Get TTworkbench and TTsuite-WAVE-DSRC Installation TTworkbench TTsuite-WAVE-DSRC Load Test Campaign Configuration Parameter View (Module Parameters) Running Test Cases Analysis Saving Configurations and Test Results Details Core Language Editor (CL Editor) TTthree (TTCN-3 Compiler) TTman (Test Execution Management) Documents Appendix..13 spirent.com i

3 1. Requirements 1.1. Test Environment and Test Suite TTworkbench is the TTCN-3 execution platform needed to run the test solution TTsuite-WAVE-DSRC. System Requirements Operating Systems: Microsoft Windows 7/8/10 Linux (GTK2, x86-32, x86-64) Java 2 Platform: Version 8 JDK Download at We strongly recommend using the above Java JDK. With other Java versions the TTworkbench will not work correctly! Memory: 2 GB (8 GB recommended) 1.2. Hardware Requirement CohdaWireless MK5 or other DSRC Proxy Implementation Required version of MK5 firmware and DSRC proxy: Please refer to FAQ spirent.com 3/13

4 1.3. Upper Tester Implementation For Upper Tester implementation requests, please refer to the WAVE-DSRC Test Control Interface (TCI) Specifications. 2. Get TTworkbench and TTsuite-WAVE-DSRC License File Before you download TTworkbench and TTsuite-WAVE-DSRC, make sure you received a valid license file. Otherwise please contact our sales team at ttworkbench-sales@spirent.com. Please use Spirent s Customer Service Center at Step 1 In case you are not registered yet, go to and fill in the registration form. The support team will check your data and notify you about your approval. Step 2 Login at Spirent s CSC and click on the download app tab on the left side. Step 3 Select the product line TTworkbench and filter for categories and operating system. Download the purchased TTworkbench version. Step 4 Select the release type Controlled Release. Click on folder TTsuites for TTworkbench and download the TTsuite-WAVE-DSRC. 3. Installation 3.1. TTworkbench Step 1 Windows Platform: Double click on TTworkbench-xxx-installer.exe (to be found on desktop or selected directory). Linux Platform: Use command line java -jar TTworkbench-xxx-installer.jar spirent.com 4/13

5 Step 2 Follow the pop up installation wizard Browse for the valid license file already saved in your favored directory. (TTsuite-WAVE-DSRC and TTworkbench require a valid license file for execution.) Step 3 Start TTworkbench from created desktop icon or menu entry. Step 4 Start a new workspace by accepting the default workspace location on request or choose an existing one TTsuite-WAVE-DSRC Step 5 In the TTworkbench menu, click on menu item Help Install New Software Step 6 Click Add Archive. Choose the downloaded installation file TTsuite_Wave-DSRC_archived-site.zip. Click Select All Next Next. Accept the terms of license agreements. Finish and confirm to restart TTworkbench. spirent.com 5/13

6 Step 7 After restart, you can import the installed TTsuite-WAVE-DSRC. Close the welcome tab. In the project view, just click on the right mouse button, go to menu File Import TTCN-3 TTCN-3 Test Solution Projects. Select the installed test solution projects and choose TTsuite-WAVE-DSRC Finish. Further details about installation you can find in the integrated User s Guide. Click on Help Help Contents Spirent TTworkbench User's Guide. 4. Load Test Campaign Step 1 Open the TTsuite-WAVE-DSRC folder in the Package Explorer (TTCN-3 Development Perspective). Step 2 In the project root folder, double click on the test campaign loader file IEEE_1609_x.clf (with the icon ). (The perspective will automatically switch into the TTCN-3 Execution Management.) spirent.com 6/13

7 Take IEEE_1609_3.clf as example and you will see the test cases listed as in the picture below. 5. Configuration Please configure your TTsuite-WAVE-DSRC according to the protocol and your local settings. You can use our MBS (Message Building System) to ease it up. For further details about Test Suite Parameters, please refer to the parameter description and the integrated user s guide. Click on Help Help Contents Using TTsuite-WAVE-DSRC. 5.1 Parameter View (including Module Parameters) In the Parameter View of the Execution Management you find different parameters to change the settings for your individual test configuration. Please click on the right mouse button over the parameter view or use the MBS button to open the Message Building System dialogue. spirent.com 7/13

8 You can access the single parameter and the attributes of single fields in the dialogue. When finished, just click on OK to save the change. The changed parameters are called by the test system during runtime. You can run your test campaign with the new configuration at once without recompilation of your test cases. All test suites included in TTsuite-WAVE-DSRC have the same common part of parameters for configuring the test system to be able to communicate with the Device Under Test (DUT) via a DSRC proxy application and a TCI application. Please note! Please check the specific test suite chapters for any additional need for parameter adjustment: More information in TTworkbench Help Help Contents Using TTsuite-WAVE-DSRC. At least the following Common Configuration parameters need to be set subject to your local settings: TestSystemConfiguration Parameter PX_TS_IP_ADDRESS PX_TS_TCI_PORT_NUMBER PX_TS_DSRC_PORT_NUMBER Description The IP address of the test system. The UDP port number of the test system used for TCI communication. The UDP port number of the Test System for DSRC proxy Communication. TciConfiguration Parameter PX_DUT_TCI_IP_ADDRESS PX_DUT_TCI_PORT_NUMBER Description The IP address of the DUT used for TCI communication. The UDP port number of the DUT used for TCI communication. spirent.com 8/13

9 DSRCProxyConfiguration Parameter Description PX_DSRCPROXY_IP_ADDRESS The IP address of the DSRC proxy. PX_DSRCPROXY_PORT_NUMBER The UDP port number of the DSRC proxy. 6. Running Test Cases Execution: Double click on one test case or select one test case by single click and press the Execute tests button Analysis After execution, click on the TTCN-3 Graphical Logging tab. It shows the results of the execution as a graphical output. A single click on a send or receive message arrow provides further details of the TTCN-3 template representation in the Test Data View, which you see the received message compared to the expected TTCN-3 template. Mismatched values are marked red. Double click on send or receive arrows for the raw messages in the Dump View. spirent.com 9/13

10 Management View Result Analyzer Test Parametrization Graphical Online Logging 6.2. Saving Configurations and Test Results The current executed run of test cases can be saved in a *.tlz file by pressing the export button and selecting Export Log in the Management View. The generated *.tlz file (with the icon ) contains the current configuration (CLF) and the executed log traces. For reviewing, this file can be imported by pressing the import button and selecting Import Log. In order to generate a test report, use this button. Further details about execution and savings you can find in the integrated Users Guide, Chapter Using TTworkbench TTman. Click on Help Help Contents Spirent TTworkbench User's Guide. spirent.com 10/13

11 7. Details (for Development) 7.1. Core Language Editor (CL Editor) Each TTCN-3 file is view- and editable by double clicking in the CL Editor. As shown in Step 1 of 4. Running My First Test Case you find the TTCN-3 source code (*.ttcn3) in folder ttcn3. After opening the files, the source code will be syntactically checked and highlighted. In addition, an outline will be generated automatically and the go-to-declaration feature will be enabled. TTCN-3 Compiler/ Validate Buttons Outline Project View TTCN-3 Core Language Editor 7.2. TTthree (TTCN-3 Compiler) For recompiling all TTCN-3 files, please open the main module (with the icon double click. Press the Rebuild button. ) in the CL Editor by Please note! Compilation is only necessary if some test cases are changed or some new one is created. Otherwise, the generated *.jar files from TTCN-3 source are already available for execution. spirent.com 11/13

12 7.3. TTman (Test Execution Management) In order to execute test cases and configure parameters, the CLF has to be loaded into the Test Execution Management. In the project root folder, you will find several CLF files (with the icon 6.Running Test Cases. ). Please refer to chapter Further details can be found in the integrated Users Guide, Chapters Using TTworkbench CL Editor, Using TTworkbench TTthree and Using TTworkbench TTman. Click on Help Help Contents Spirent TTworkbench User's Guide. 8. Documents Please refer to following publications regarding WAVE-DSRC: Specifications Related Documentation Test Specifications All Test Specifications IEEE IEEE IEEE SAE J2945/1 DSRC Proxy DSRC Proxy Test Control Interface (TCI) TCI Interface spirent.com 12/13

13 9. Appendix Acronyms CL Editor CLF DSRC IUT MBS OS SUT TCI TLZ WAVE Core Language Editor Campaign Loader File Dedicated Short Range Communication Implementation Under Test Message Building System Operating System System Under Test Test Control Interface Test Logging Zip File Wireless Access Vehicular Environments Notes This document is subject to change without notice. Spirent Communications Michaelkirchstraße 17/ Berlin, Germany Phone Fax: ttworkbench-sales@spirent.com Internet: spirent.com/ttworkbench AMERICAS SPIRENT sales@spirent.com US Government & Defense info@spirentfederal.com spirentfederal.com EUROPE AND THE MIDDLE EAST +44 (0) emeainfo@spirent.com ASIA AND THE PACIFIC salesasia@spirent.com Spirent Communications, Inc. All of the company names and/or brand names and/or product names and/or logos referred to in this document, in particular the name Spirent and its logo device, are either registered trademarks or trademarks pending registration in accordance with relevant national laws. All rights reserved. Specifications subject to change without notice. Rev # 2018/06/14 13/13