TTA Documentation Release 1.15.2 MAGNA Telemotive GmbH Dec 18, 2019 CONTENTS 1 How to install TTA 1 1.1 Install steps................................................1 1.1.1 Follow the Installer Instructions................................2 1.1.2 Check if my installation is complete..............................4 1.1.3 Check if path is set.......................................6 1.1.4 Eclipse.............................................6 1.2 Basic Functionality............................................6 2 Getting Started Tutorial 7 2.1 Your first test run (use of the GUI)....................................7 2.2 Write Testcases (use of the IDE).....................................9 2.3 Configure your Test setup........................................9 3 How to test with TTA ? 11 3.1 Start the TTA GUI............................................ 11 3.2 Test cases database / Test cases pool................................... 11 3.3 Run a single test............................................. 12 3.4 Use of test parameters.......................................... 12 3.5 Build a test sequence........................................... 14 3.6 Build a test sequence with test parameters................................ 14 3.7 Run a test sequence........................................... 15 3.8 Run a test sequence randomly shuffled................................. 17 3.9 Open the test report........................................... 18 3.10 Control more than one computer with TTA............................... 18 3.11 Import tests from Git........................................... 18 3.12 Import tests from Apache Subversion.................................. 18 4 TTA test case generator 21 4.1 Start the script in Eclipse......................................... 21 4.2 Generate the test case in the GUI.................................... 21 4.3 Keyword Mapping............................................ 22 5 How to create a TTA test case script 23 5.1 Simple Test Case............................................. 23 5.2 Advanced Test Case........................................... 24 5.2.1 Execution order......................................... 25 5.2.2 Test step function naming conventions............................. 25 5.2.3 Test initialization........................................ 26 5.2.4 Test step documentation and reports.............................. 26 5.2.5 Assert functions......................................... 27 i 5.2.5.1 Arguments and return type.............................. 27 5.2.5.2 Multiple asserts per test step.............................. 28 5.2.5.3 Assert types / automatic sub steps........................... 29 5.2.5.4 Set a step result with an exception.......................... 29 5.2.6 Reporting............................................ 31 5.2.7 Error handling.......................................... 31 5.3 Assert functions reference........................................ 32 5.4 Simple Test Case reference........................................ 38 5.5 Advanced Test Case reference...................................... 39 6 Tutorial Testcase Parameters 41 6.1 Getting started:.............................................. 41 6.2 Operation................................................. 42 6.3 Additional Documentation........................................ 42 7 TTA Runner Reference 45 7.1 tta.runner.runner............................................. 45 7.2 Runner and Suite for Test Case execution................................ 47 7.2.1 tta.runner package reference.................................. 47 8 Reporting 52 8.1 Overall overview............................................. 52 8.1.1 Report Structure......................................... 52 8.1.2 Basic Usage........................................... 53 8.1.3 HTML report structure..................................... 54 8.1.4 PDF report structure...................................... 54 8.2 Single test case overview......................................... 54 8.3 Test run protocol............................................. 55 8.3.1 tta.reporting package reference................................. 55 8.4 tta.reporting.report............................................ 55 8.5 tta.reporting.bindings........................................... 57 8.6 tta.reporting.constants.......................................... 62 8.7 tta.reporting.htmlconverter........................................ 63 9 Device configuration 64 9.1 Telemotive data loggers......................................... 64 10 XML-Description of a test case 66 10.1 XML Structure.............................................. 66 10.2 Structure of a TestStep.......................................... 66 10.3 Example................................................. 67 11 TTA dynamic code completion 68 11.1 Trigger on Save.............................................. 68 11.2 Trigger on Open............................................. 68 12 TTA Lib Reference 69 12.1 tta.lib.catalog............................................... 69 12.1.1 tta.lib.catalog.MessageCatalogParser.............................. 69 12.1.2 tta.lib.catalog.fibex module................................... 70 12.1.3 tta.lib.catalog.arxml module.................................. 71 12.1.4 resulting dictionary (CAN)................................... 72 13 TTA Units Reference 74 13.1 tta.units.android.android......................................... 74 ii 13.2 tta.units.android.logcat.......................................... 76 13.2.1 Logcat Unit........................................... 76 13.2.2 basic logcat usage........................................ 78 13.2.3 Advanced logcat usage..................................... 79 13.3 tta.units.audio.............................................. 80 13.3.1 How to use the audio unit.................................... 80 13.3.1.1 Signal......................................... 80 13.3.1.2 Recorder........................................ 81 13.3.1.3 Player......................................... 81 13.3.1.4 Identification...................................... 82 13.3.1.5 Signal processing................................... 82 13.3.1.6 Speech processing................................... 83 13.3.1.7 Plotting........................................ 84 13.3.1.8 Module......................................... 84 13.4 tta.units.can.bpng............................................. 87 13.5 tta.units.can................................................ 89 13.5.1 CAN - CAN unit........................................ 89 13.5.2 CANMessage, CANMsgType - CAN messages........................ 90 13.5.3 Sending CAN messages.................................... 92 13.5.4 Receiving CAN messages................................... 92 13.5.5 CANFilter, CANFilterRange, CANFilterType - CAN filter for EventSources......... 93 13.6 tta.units.datalogger.datalogger...................................... 95 13.7 tta.units.ethernet............................................. 96 13.8 Ethernet Unit............................................... 96 13.8.1 Identify your Ethernet Interfaces................................ 97 13.8.2 Configure the Network Adapter................................ 97 13.8.3 Send Messages......................................... 98 13.8.3.1 Send single message.................................. 98 13.8.3.2 Send multiple data................................... 99 13.8.3.3 Send data contained in a pcap file........................... 100 13.8.4 Capture Packets......................................... 101 13.8.5 Convenience Functions..................................... 103 13.8.6 Ethernet Protocols....................................... 104 13.8.7 Ethernet............................................. 104 13.8.8 IP................................................ 105 13.8.9 ICMP.............................................. 106 13.8.10 ARP............................................... 107 13.8.11 UDP............................................... 108 13.8.12 TCP............................................... 108 13.8.13 DHCP.............................................. 109 13.8.14 SomeIP............................................. 110 13.8.15 SomeIPSD........................................... 110 13.8.16 RawPacket........................................... 111 13.9 tta.units.flash............................................... 111 13.9.1 Flash - Flash unit........................................ 112 13.9.1.1 Flash functions..................................... 112 13.9.1.2 Generic flash functions................................ 117 13.9.2 FlashResult........................................... 119 13.10 tta.units.ftp................................................ 120 13.10.1 FTP - FTP unit......................................... 120 13.11 tta.units.imagegrabber.imagegrabber................................... 121 13.11.1 ImageGrabber - image grabber unit.............................. 121 13.11.2 Drivers............................................. 121 13.12 tta.units.imageprocessing.animation................................... 123 iii 13.12.1 How to use the ImageprocessingAnimation unit........................ 123 13.12.1.1 Importing and comparing videos........................... 123 13.12.1.2 Searching specific frames............................... 123 13.12.1.3 Other Functions.................................... 124 13.12.2 Comparison Algorithms.................................... 124 13.13 tta.units.imageprocessing.warping.................................... 128 13.13.1 ImageProcessingWarping