AutoTest UT User Manual
Contents
1. Edit Run Test File f Create New Test File 1 Get ready workspace in HEW Test File 2 Ensure debugaing information is enabled 3 Downloaded user target program e g xxxxx abs C Edit Run Test File tio Desktop AutoTest sample Test File_50 xls cat Run Click OK to proceed Edit Test Cases Run Test Cases Test Case Setting AutoTest_UT Tool sample Test File_50 xls D Initialization Setting AutoTest _UT T m E Test Case No 51 51 Go to test case no Go Set Expected V Value D Value D Initialization Setting AutoTest UT T px O OOO O wa A lt TET a E wa eee a a wa eee a fel Nore nr AA A AA Ta Pee pw e fe es E a a p ee ep mw ow ivo Toned Copy Remove Main Menu No Enable Execution Break at Ox Set Get Wariable lt I Test File sample Test File 50 xls Select toolchain H85X H85 H8 Select platform H8 300HN Simulator Map File Y List File m E NEM NE E NEM NEN DE NN Test Status AutoTest_UT Tool sample Test Fil a E Status No Result Comments 1 SKIP at test item zi B3 2 SKIP at test item 11 3 SKIP at test item 3 _ Save 4 FAIL at test item 3 5 PASS 6 FAIL at test item 3 4 7 PASS 8 PASS 3 PASS 10 PASS 11 PASS 12 PASS 13 PASS 14 PASS 15 PASS 16 PAS2. Figure 18 Unit Test Supporting Test File Template Generator 24 N SAS Page 14 of 31 Enable Checkbox to set active inactive statue of the corresponding test item Execution Determine the action to take Reset go Go None Break at 0x Specify the breakpoint that user wants to break at Set Get Specify the mode of operation after BREAK either Set Get value Variable Specify the variable which user wants to set value into get value from Set Value D Specify the value to set to the variable Expected Value D Specify the expected value to compare with actual value Table 3 Test Item Fields Notes Setting NONE in Execution mode has the significance when user wants to set get multiple variables at one breakpoint The test file will be executed in sequence from the beginning Test Case 1 test item 1 to the very last test item User should determine the sequence of the entry carefully according to the real execution Some criteria of the valid format of the breakpoint address in the script are described below a b Memory address in hexadecimal format only The memory address must be written in one of these following formats 0x00001995 00001995 1995 The following formats are not permitted H 123a D 4666 O 11072 B 1001000111010 Line number is supported in the script e g L 295 The script does not accept format of Lxxx for line number The line number will depend on the list file so m
3. N SAS Page 27 of 31 5 1 16 Issue No selected platform ME AutoTest_UT Tool 1 Please select a platFarm Figure 39 No platform selected Resolution Select a valid platform from the option menu button for platform selection 5 1 17 Issue No selected map file ME AutoTest UT Toot R I j Please select a Map file Figure 40 No map file selected Resolution Select a map file using the button for browsing of map files before selecting a list file 5 1 18 Issue Could not locate obj file MM Autolest UT Tool A Could nat locate corresponding obj File under SECTION F in the map File Figure 41 Could not find corresponding object file Resolution The error might be due to selection of an invalid list file or the map file is not generated with the right conditions for the correct file contents User should check rebuild the workspace to generate the map file under the necessary conditions Refer to Section 2 1 for details If the problem lies in the selection of list file then user should select another list file in the workspace that is valid 24 N SAS Page 28 of 31 5 1 19 Issue Invalid list file specified MM AutoTest UT Tool A The selected list File is invalid Do you still wish to continue Keywords and line numbers will not be valid during running of test cases Mo Figure 42 The list file is invalid Resolution This dialog informs the user that the specifie
4. w coma Figure 36 Save data to file Resolution This dialog informs the user whether to save the current test cases data to file before proceeding with normal operations of the script Clicking Yes will prompt a Save As dialog for saving of the file 24 N SAS Page 26 of 31 Savein O AutoTest LIT Ex ES 2 sample Test File _50 xls My Recent Documents Desktop My Documents Mu M File name sample T est File 5 xls Save Places Save as type Microsoft Excel files xls Lancel Figure 37 Save As dialog After user has saved the file the script operation will proceed normally If the save 1s cancelled in the Save As dialog the script operation requested by the user will be cancelled as well e g returning to Main Window However clicking No when prompted to save changes to file will carry on with normal operations of the script without saving the data to a test file Clicking Cancel instead will cancel out the operations 5 1 15 Issue Save changes before exiting MM AutoTest UT Tool A Save changes to File before quitting wo coma Figure 38 Save data to file before quitting Resolution This operation of this dialog is similar to the one in Section 5 1 14 The only difference is that this dialog serves to inform user whether to save data to file before closing the script Refer to Section 5 1 14 on functions of the buttons 24
5. CENESAS C D D m 0 lt CO 5 C V Unit Test Supporting Tool User s Manual Software All information contained in these materials including products and product specifications represents information on the product at the time of publication and is subject to change by Renesas Electronics Corp without notice Please review the latest information published by Renesas Electronics Corp through various means including the Renesas Technology Corp website http www renesas com Renesas Electronics www renesas com Rev 1 04 Apr 2010 10 11 3 Notice All information rmcluded in this document 15 current as of the date this document is issued Such information however 15 subject to change without any prior nadice Before purchasing or using amy Remesas Electromecs products listed herem please confirm the latest product infomation with a Renesas Electronics sales office Also please pay regular and careful attention to additional and different information tn be disclosed by Renesas Electronics such as that disclosed through our website Renesas Electronics does not assume amy liability for infringement of patents copyrights or other intellectual property rights of third parties by or arismg from the use of E gnesas Electronics products or technical mformation described in this document No license express mmplied or otherwise 15 granted hereby under any patents copyrights or other imtellectual property rights
6. 5 1 Error in Script operation 5 1 1 Issue Absence of tcom package MM AutoTest UT Tool A Warning Package boom is nok Found in Tcl library The application will mow exit Figure 23 tcom file is absent Resolution Copy the tcom package provided into the directory lt HEW installation directory gt System Sec TCL Toolkit Lib see Figure 7 for more details 5 1 2 Issue Absence of TclCmds dat MH AutoTest_UT Tool X ES Missing TclCmds dat Figure 24 TclCmds dat is absent Resolution Copy the TclCmds dat to the directory containing the script see Figure 2 for more details 44 NC SAS Page 22 of 31 5 1 3 Issue File Open Error MM AutoTest UT Tool Ensure the path is correct and that the file is not in use by any application Figure 25 Read Write file error X File Open Error Z AutaTesk Sample Test File _1 txt Resolution The file might be missing or is locked for reading writing by an application in use Ensure the path is typed correctly in the former case If it is the latter close the application that is used to open the file 5 1 4 Issue No selected Test File ME AutoTest_UT Tool X 1 Please select a test File Figure 26 No test file selected Resolution Use the button in Main Window to select a test file 5 1 5 Issue Invalid Test File MM AutoTest UT Tool A Sample Test File 1 txt is mot a valid test File Figure 27 Non test file selected Resoluti
7. has to do the following before proceed with the script e Set the correct target platform e Close the selected Test File Excel file 4 3 Breakpoints in workspace Any breakpoints that are set in the workspace will be cleared when operating the script They would not be added to the breakpoints that are specified in the Excel file 4 4 Updating the Excel File Please take note that the cells in the general info table should not be moved from its cell location in the Excel file In addition no rows are to be inserted or deleted otherwise it will lead to some unexpected operational errors or some improper operations of the script If user change the cell column for some of the test item fields in the Excel file the column location needs to be updated in the general info table in the top left corner of the file Failure to do so will result in incorrect reading of the test cases data which will lead to undesirable operational errors in the script Also do take note that for a test item in the Excel file no test item field with the exception of result and remarks should be left empty Hence it is strongly recommended that any changes to the test cases data in the Excel file should be done through the script operation 4 5 Server busy When executing big Excel file 10 MB or over the script might take long time to reload the file and it displays server busy notification User can select Switch to or Retry At this situ
8. includes itz majority Mote 1 Esmesas Electronscs product s means amy product developed or manufactured by or for Renesas Electronics User s Manual Published by Renesas Electronics Singapore Pte Ltd Date April 9 2010 Version 1 04 00 Copyright C Renesas Electronics Singapore Pte Ltd All rights reserved Trademarks a General All brand or product names used in this manual are trademarks or registered trademarks of their respective companies or organizations b Specific Microsoft Windows is a registered trademark of Microsoft Corporation Pentium is a registered trademark of Intel LIMITED WARRANTY Renesas warrants its products to be manufactured in accordance with published specifications and free from defects in material and or workmanship The foregoing warranty does not cover damage caused by fair wear and tear abnormal store condition incorrect use accidental misuse abuse neglect corruption misapplication addition or modification or by the use with other hardware or software as the case may be with which the product is incompatible No warranty of fitness for a particular purpose is offered The user assumes the entire risk of using the product Any liability of Renesas is limited exclusively to the replacement of defective materials or workmanship DISCLAIMER RENESAS MAKES NO WARRANTIES EITHER EXPRESSED OR IMPLIED ORAL OR WRITTEN EXCEPT AS PROVIDED HEREIN INCLUDING WITHOUT LIMITATION THEREOF W
9. ARRANTIES AS TO MARKETABILITY MERCHANTABILITY FITNESS FOR ANY PARTICULAR PURPOSE OR USE OR AGAINST INFRINGEMENT OF ANY PATENT IN NO EVENT SHALL RENESAS BE LIABLE FOR ANY DIRECT INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY NATURE OR LOSSES OR EXPENSES RESULTING FROM ANY DEFECTIVE EMULATOR PRODUCT THE USE OF ANY EMULATOR PRODUCT OR ITS DOCUMENTATION EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES EXCEPT AS EXPRESSLY STATED OTHERWISE IN THIS WARRANTY THIS EMULATOR PRODUCT IS SOLD AS IS AND YOU MUST ASSUME ALL RISK FOR THE USE AND RESULTS OBTAINED FROM THE EMULATOR PRODUCT ENESAS All Rights Reserved This user s manual and emulator product are copyrighted and all rights are reserved by Renesas No part of this user s manual all or part any be reproduced or duplicated in any form in hardcopy or machine readable form by any means available without Renesas s prior written consent Other Important Things to Keep in Mind 1 Circuitry and other examples described herein are meant merely to indicate the characteristics and performance of Renesas Electronics s semiconductor products Renesas assumes no responsibility for any intellectual property claims or other problems that may result from applications based on the examples described herein 2 No license is granted by implication or otherwise under any patents or other rights of any third party or Renesas 3 MEDICAL APPLICATIONS Renesas Electronics s produ
10. E A o A I p A Te eV mo ca A CT A CT a usd O IE E 4 Me A E p A C E AA E pko n8 A E l E E A HE d EE 7 Te SS EEEEEEENNE E qu oS aE E A A AAA A Hoooesz Cs CT Cs CT SES _5 EE A E d ar E 1 0 s I E 4 lu cuo o IE p A pe EE Figure 11 The content of result column Page 7 of 31 The meanings of PASS FAIL SKIP and ABORT are as follow PASS The expected and final data match FAIL At least 1 expected and final data do not match SKIP The particular test case is skipped due to exceptions or user chooses to skip refer to Section 5 1 20 ABORT The particular test case is skipped due to test aborted refer to Section 5 1 21 Table 2 Content of the result column Page 8 of 31 3 Operation Guide After setting up the settings in Section 2 The Unit Test Supporting Tool can be executed The diagram below shows the overview of running the Unit Test Supporting Tool Page 9 of 31 Differences eme ix Select a fie to source Map Legh in 3 Ado ral Sree Teel vxvkspace ive Hy Fece f bbomie i to Test UT Tool wT td Documenti p LaS Toolkit Ckri4 Shift K g Disassembly Ctrl D CPU Symbol Graphic l Tet Senis 1 Code PerFormance ES Main Menu AutoTest UT T mn C Create New Test File E Before continuing X D Main Menu AutoTest_UT T E Please ensure the following are done before continuing
11. L T ERE TET Ud 20 4 Shifting of workspace to different CireCtOries ccccccccccccccccecceesessesseeeecceeeeeeeeeeeaeassesseseeeeeeeeeeeeeseeaasaassesseeseeeeeeess 20 A ES NE ee E see at O o o A e 08 o E 20 4 3 Breakpoints BURTON Pe T 20 A SEE CCS MESE E RU FO E 20 4 5 yeu OV NR E E 20 LO SO CU REDDUNT Tot 21 4 7 Key word and Ine number SUP PO ici 2 4 8 Running of Test Cases RH 21 AO ROEN CIR Tcr 21 AO Mine UMC TOUS T s 21 3 Error Messages nn o o o A 22 5 4 Error in Script OCT AU OM tiara dodne 22 5 1 1 Issue Absence of tcom package ccsssssssseeeeeeccccccccescaeeessssseeeeeecccecesessssaeaessssseeeeeeeceeeeeesssaaueaasssseeeeeeeeees 22 341 2 Issue ADSeHnEe DEPT OI PROS C oeustunosceaicdooauo donee velot oa alee T e Seat Seta edes uo NER iai 2 5 1 3 Issue Tilo Oca MO per pino 23 5 1 4 Issue No selected Tes 0 ile AU asausaaasacun E E 23 5 1 5 issues In E af ile ota 23 5 1 6 Issue Unable to create NOW TES CASS src ino rn edades 24 5 1 7 ISSUE Invalid express lOD iia ici 24 5 1 8 AAA 24 5 1 9 Issue Same source and destination indexes ccccceeeeeeeeseeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeees 25 5 L10 Issue rti mos ilmmm 25 5 1 11 Issue Start value larger than end Vale iii 25 5 1 12 Issue Exceeded range to c
12. S 17 PASS ie ips Main Menu 20 PASS y Exit Y Window Topmost Page 10 of 31 3 1 L Running the UT Tool Script Open the workspace to be tested 2 On the menu click on View TCL Toolkit 3 de File Edit view Project Build Debug Setup Differences Map Ctrl ShiFt Command Line Ckri L STL Toolkit Ctrl ShiFt K M Workspace AIHE A Output Alo Disassembly Ctrl D PU d Symbol b Graphic d Code d Performance Figure 13 Invoking Tcl Tk window Two windows will be invoked as shown E Console File Edit Help Console window Graphics window Figure 14 Tcl Tk Console and Graphics window ENESAS Page 11 of 31 4 In the console window click on the menu File gt Source and select the file UT Supporting Tool tcl which is located at the directory that user has specified Select a file to source Look in CO AutoTest simple Taal workspace S Ecormn My Recent ff autoTest_UT Tool tel Documents D esktop Sy Mu Documents hy Computer My Network File name Places Files of type Tel Scripts tel L ancel Figure 15 Selecting Unit Test Supporting Tool tcl 3 2 Features of Unit Test Supporting Tool Main Window 1 The following dialog box will be invoked User should do what is written refer to section 4 3 then click OK lll Before continuing Please ensure the following are done before cont
13. ake sure that the correct Ist file has been selected Keyword is supported in the script User can put keyword in one particular line in workspace and later on use the keyword to point at that line Similar to line number keyword information is stored in list file This method is very useful as user does not have to re input all breakpoints again should there be any changes in the workspace In order to differentiate a keyword from memory address or line number encapsulate the word using the following quotation marks e g sample word Copy dialog box will be displayed when user click Copy 24 N SAS Page 15 of 31 f Copy Test Case C Copy Test Item Source Test Case No h OR Destination Test Case No 2 Cancel C Copy Test Case f Copy Test Item Start Test ltem Mo I OF End Test Item Ma Cancel Figure 19 Copy Dialog Box Copy Test Case Copy the Source Test Case and insert in position of Destination Test Case Copy Test Item Copy the range of test items specified and paste them at the end of the current displayed Test Case Table 4 Copy options 3 Remove button will remove the current displayed Test Case 4 Main Menu button will bring user back to Main window 5 Go to test case no enables user to display particular test case 24 N SAS Page 16 of 31 3 4 Features of Unit Test Supporting Tool Setting Window iJ Initializatio
14. ancel will cancel out the exit operation 24 N SAS Page 31 of 31 Unit Test Supporting Tool CENESAS Renesas Electronics Corporation
15. ase be sare to implement safety measures tp guard them against the possibility of physical injury and injury or damage caused by fire m the event of the failure of a Renesas Electronics product such as safety design for hardware and software mcluding but not limited to redundancy fre control and malfunction prevention appropriate treatment for agg degradation or amy other appropriate measures Because the evaluation of macrocomputer software alone is very difficult please evaluate the safety of the final products or system manufactured by you Please contact a Renesas Electronics sales office for details as to environmental matters such as the environmental compatibility of each Renesas Electronics product igi ai tremens pbi tide ipic re laws and regulations that regulate the mecfusion or use of controlled substances imcbading without limitation the EU RoHS Directive Remesas Electronics assames no liability for damages or losses occurmmng as a rezult of your noncompliance with applicable Laws and regulations This document may not be reproduced or duplicated in any form in whole or m part without pror written consent of Renesas Electronics Please contact a Renesas Electronics sales office if you have any questions regardmz the mftormation contained m this document or Renesas Electronics products or if you have amy other inquiries Note 1 Esnesa Electronics as used in this document means Renesas Electronics Corporation and also
16. ate map file Options Link Library noprelink rom D A namessage dist CION FIGDIR S S IPR JECTMAME map naaptimize start L VELTTBL DINTTBL UU PResetPRG PIntPRG 080 Figure 6 Link Library Toolchain settings Category Output These settings will create the map and list file when user rebuilds the workspace Make sure the corresponding configuration and the correct target has been selected prior to re building 5 Copy the tcom package Version 3 9 into the lt HEW installation directory gt System Sec TCL Toolkit Lib directory as follows r Lib m m x File Edit View Favorites Tools Help ae sack tu 2 ya Search lis Falders Bee Address le CX Program Files Renesas hew system sec TCL ToolkitsLib v Go size Type File Folder File Folder Other Places File Folder File and Folder Tasks Ey TEL Toolkit El My Documents 4 My Computer J My Network Places Figure 7 tcom package location Page 4 of 31 2 2 Excel file format 2 2 1 Specification of Excel file An Excel file contains test cases data Each test case contains a maximum of 20 test items A maximum of 3 276 test cases will be supported in Excel workbook The number of all data parameters or return or global symbol is flexible However each test case should conform to a fixed format more details in Section 2 2 2 Page 5 of 31 2 2 2 Specification of General Info Table The following table
17. ation user should wait for a while 10 s and then click on Retry However user is not advised to operate the script with a big Excel file as it will affect the speed of the script Instead user can divide one big Excel file into several smaller Excel files 24 N SAS Page 20 of 31 4 6 Operator limitation Some restrictions on the use of the operator in the script e The script does not support the use of ampersand sz It does supports the name of a variable for set value column of the Excel file e Jt supports variable pointer e g var g in variable column of the Excel file and allows setting a new value to the pointer However it does not support setting a new value to the variable pointer without the asterisk e g var_g though it supports getting the actual value e It does not supports setting or getting the value for the name of an array e g symbol in variable column of the Excel file but it accepts symbol 1 99 66 e It does not accept arithmetic operation inside array e g symbol 1 1 symbol a 1 or symbol 1 However it accepts symbol 2 4 7 Keyword and line number support Keyword and line number support is restricted to the contents of the selected list file in the workspace The script does not support keywords and line numbers that are not found within the list file contents The selection of list file is restricted based on the file contents u
18. ctronics assumes no liability whatsoever for any damages incumed by vou rezultinz from errors im or omission from the m iormatian incbaded herein Renesas Electronics products are classified according to the following three quality grades Standard High Quality and Specific The recommended applications for each Eenesas Electronics product depends on the product s quality grade as Indicated below You must check the quality grade of each Renesas Electronscs product before using it m a particular application You may mot use amy Renesas Electronics product for amy application categorized as Specific without the prior written consent of Remesas Electronics Further you may not use amy Renesas Electronscs product for any application for which itis not intended without the prsor written consent of Renesas Electronics Renesas Electronics shall not be im amy way liable for any damages or losses mcurred by you or third parties arising from the use of any Renesas Eleciromios product for an application categorized as Specific or for which the product is not intended where you have failed to obtam the prior written consent of Renesas Electronics The quality grade of each Renesas Electronics product is Standard unless otherwise expressly specified in a Renesas Electronics data sheets or data books etc Standard Computers office equipment communications equipment test and measurement equipment audio and visual equipment bome ele
19. ctronsc appliances machime tools personal electronic equipment and maiustrial robots High Quality Transportation equipment automobiles trains ships etc y tafir control systems anti disaster systems amii crime systems safety equipment and medical equipment rot specifically designed for life support Specific Aurcrafi aerospace equipment submersible repeaters maclear reactor control systems medical equipment or systems for life support e g artificial hfe support devices or systems surgical implantations or healthcare mrervent un e g excision etc amd amy other applications or purposes that pose a direct threat to human life You should use the Renesas Electronics products described in this document within the range specified by Renesas Electronics especially with respect to the maxima im rating operating supply voltage range movement power voltaze range heat radiation characteristics installation and other product characteristics Renesas Electronics shall have no liability for malfunctions or damages arising out of the use of Remesas Electronscs products beyond such specified ranges Although Keresas Electronics endeavors to improve the quality and reliability of its products semscondurtor products have specific characteristics such as the occurrence of failure at a certam rate amd malfunctions under certain use conditions Further Renesas Electronics products are not subject tn radiation resistance design Ple
20. cts are not authorized for use in MEDICAL APPLICATIONS without the written consent of the appropriate officer of Renesas Electronics Asia Sales company Such use includes but is not limited to use in life support systems Buyers of Renesas Electronics s products are requested to notify the relevant Renesas Electronics Asia Sales offices when planning to use the products in MEDICAL APPLICATIONS Limited Anticipation of Danger Renesas cannot anticipate every possible circumstance that might involve a potential hazard The warnings in this user s manual and on the emulator product are therefore not all inclusive Therefore you must use the emulator product safely at your own risk ENESAS i PREFACE About this manual This user s guide is written for Unit Test Supporting Tool It describes the operation and usage of the Unit Test Supporting Tool Use this guide to get started using the Unit Test Supporting Tool Section 1 Section 2 Section 3 Section 4 Section 5 Assumptions Introduction Gives an introduction to the purpose of this tool and the general functionalities of the tool Getting Started Provides a step by step guide to Unit Test Supporting Tool setup Operation Guide Presents Unit Test Supporting Tool GUI environment It describes the different features and provides detailed description on each specific window Operation Restriction This sections shows notes on using Unit Test Suppor
21. d file at specified location is an invalid list file User can proceed with normal operations of the script by clicking Yes but any keywords and line numbers inputs in the test cases will not be recognized and will most likely lead toa SKIP result in the containing test case Otherwise user can choose not to proceed with the testing by clicking No and is allowed to change the selection of the list file 5 1 20 Issue PC not equal to specified breakpoint MM Autolest UT Tool A PE did not stop at the specified breakpoint 000854 Skip test case 2 Clicking Mo will abort test Yes Ma Figure 43 HEW execution did not stop at specified breakpoint Resolution This dialog serves to inform the user that the PC in HEW did not stop at the specified breakpoint in the particular test case User can choose to proceed with testing by clicking Yes but this will lead to a SKIP result in the specified test case Otherwise user should click No if he she wishes to abort the testing at that instance so as make changes to the parameters in the test cases in the Excel file 24 N SAS Page 29 of 31 5 1 21 Issue Stop Testing confirmation MM AutoTest UT Tool A Abort testing Yes Mo Figure 44 Abort testing confirmation Resolution This dialog appears whenever user clicks on the Stop button in Test Status window during testing Clicking Yes will abort the test and this will cause all
22. gram code in HEW 3 Get the return results and set it into Excel file 4 Implement to judge the results Pass Fail into Excel based on return results and expected results This is done via Tcl Toolkit thereafter named Tcl Tk window using a package tcom Communication path between Excel and HEW is as shown below Excel File amp TCL via tcom package lt gt HEW Figure 1 Communication path bewteen Excel file and HEW 1 2 System Requirement 1 Operating System Windows XP SP3 Vista 2 Microsoft Excel Office 2000 2003 2007 3 HEW Version v 4 05 01 and above Tcl Tk version v 1 03 03 014 Watch version v 2 13 00 041 Toolchain SH v 9 2 0 0 H8S H8 300 v 6 2 1 0 M16C v 5 44 00 Target SH Simulator H8 Simulator SH E10A USB Emulator H8 E8 Emulator H8 E10A USB Emulator M16C E8a Emulator M16C E100 Emulator Table 1 System Requirements for UT Tool Script Page 1 of 31 2 Getting Started 2 1 User Setup Requirements 1 Copy the following onto your local machine Ensure that these files are located in the same directory Unit Test Supporting Tool tcl logo64 gif TclCmds dat AutoTest UT EJE File Edit View Favorites Tools Help ae o Back P Bia P Search ar Folders Ei Address le C 4uboTest_LIT v 50 Al Mame Size Type e AutoTest_UT Tool tel 150KB TCL File C3 Make a new Folder ced 2KB GIF mep a TeclCrmds dat 4KE DAT File cd Publish this Folder to the weh El Share th
23. inuing 1 Get ready workspace in HEW 2 Ensure debugging information is enabled 3 Downloaded user target program e g Xxxxx abs 4 Microsoft Excel is installed Figure 16 Before Continuing window 24 N SAS Page 12 of 31 2 The Main Menu window is displayed There are two modes of operation the first is creating new test file and the second is editing or running an existing test file Main Menu i Create Mew Test File C Edit Run Test File Click OF to proceed Main Menu Create Mew Test File Edit Run Test File Test File ng RTSP M y Documents 5 ample SH_test xls Edit Test Cases Aun Test Cases Worksheets in selected file Iv main I sort Iw reverse Iw EnableAll Figure 17 Specify Test file For the first time select Create New Test File and click on OK to proceed 3 3 Features of Unit Test Supporting Tool Test Case Template Generator 1 Upon clicking OK the following dialog box is displayed Note The same dialog box will be displayed if user wants to edit the existing test file 24 N SAS Page 13 of 31 wl Test Case Setting AutoTest_UT Tool untitled E Test Case Ma 1 1 Go to test case no Go Sel Expected variable value D Value D No Enable Execution Break at s Set Get J D FF 3 4 FH FF PEE XE E A VE EM E E TEC Y om aaa yy Al Y EN Ww Topmast
24. is Folder File and Folder Tasks A Figure 2 The required files for running the script 2 Make sure that the workspace is available 3 Make sure that the Excel file is available The information regarding the Excel file format is detailed in Section 2 2 4 Make sure that the map and list file are created Open the workspace and set up the following settings via the menu Build gt SuperH RISC engine Standard Toolchain SuperH RISC engine Standard Toolchain Configuration C C Assembly Link Library Standard Library CPU t SimDebua_5H24 FPU_Cycle e Ee All Loaded Projects E E Request DOO Iw Generate list file Tab size 4 C source file M Contents C source file E a A b fl Iw C bject list Enable all PCM el ee we Statistics _ Linkage symbol file Source code listing TT After include expansion lt After macro expansion Options C C cou sh2a abject CONFIGDIR FILE LEAF obj debug dlistfile S CONFIGDIRAS FILELEAF Ist showzgaurce Include tab 4 gbr auto chgincpath Figure 3 C C Toolchain settings Category List Page 2 of 31 Super RISC engine Standard Toolchain Configuration SimDebug SH24 FPU_Cycle Category MES v Generate list file al E e Contents a C source tile e Show symbol Enable all F E Assembly source file Show reference Link bal Fil Linkage symbol file Show section Disab
25. le all Show cross reference Options Link Library naprelink rom D F namessage Jist C0 NFIGDIR iE PR JELTMAME map show symbol reference reference nooptimize Figure 4 Link Library Toolchain settings Category List By default the following setting should be enabled SuperH RISC engine Standard Toolchain Configuration CiL Assembly Link Library Standard Library CPU A SimDebug SH2 FPU Cycle E All Loaded Projects a 3 RESTE J B C source file Machine code aby Details C source file Iw Generate debug information Assembly source file CT tput director Linkage symbol file CONFIGDIAE Modify Category Options C C cpusshza object CONFIGDIFA E S FILELEAF J abi debug gbr auto chaincpath erorpath global_volatile U opt_range all infinite_loop 0 del vacant loop 0 Figure 5 C C Toolchain settings Category Object Page 3 of 31 SuperH RISC engine Standard Toolchain Configuration C C Assembly Link Library Standard Library CPU 4 i SimDebug SH2AFPU Cycle Category EM d Type of output file Stype via absolute L source file Data record header None la E C source file Assembly source file Debug information In output load module Linkage symbol file Show entries for Output file path I CON FIGDIR FS PROJECT MAME mot Modify Gener
26. n Setting AutoTest UT T m El Test File sample Test File 50 xls Select toolchain H85x H85 H8 Select platform He SO0HAN Simulator i Map File List File Click OK to begin running Main Menu Uk Figure 20 Initialization Setting Window 1 Toolchain and platform refers to toolchain and platform that is currently active in the opened workspace 2 Map File entry refers to map file of the active project in the current workspace 3 Last File entry refers to 1st file of one of the file in the active project e g main Ist Notes Map File and List File are needed to support line number and keyword in the Break at entry refer to Section 3 3 All entries toolchain platform Map File List File will be initialised automatically However user should confirm this default entry and change accordingly if it is not correct 24 N SAS Page 17 of 31 3 5 Features of Unit Test Supporting Tool Executing Test File Test Status AutoTest_UT Tool sample Test Fil m 2 E Status Ma Result Comments SKIF at test item 2 SKIF at test item 1 SKIF at test item 3 FAIL at test item 3 Pass FAIL at test item 13 41 Pass PASS PASS PASS Pass PASS PASS 1 2 3 A F E D B 3 progressing Iv window Topmost Figure 21 Status window when executing 1 The Unit Test Supporting Status window can be displayed on top by clicking o
27. n the Window always on top 2 The summary of Test Case execution will be displayed in real time 3 While the execution is still progressing Stop button is enabled to stop the whole Test Case execution When the execution 1s finished the other buttons will be enabled D Test Status AutoTest LIT Tool sample lest Fil E Status Result Comments FASS FASS FASS FASS FASS FASS FASS FASS FASS FASS PASS PASS PASS PASS PASS PASS PASS PASS Main Menu progressing finished Exit Iv Window Topmost Em Figure 22 Status window upon completion ENESAS Page 18 of 31 4 Save will save the result to the Test File 5 Main Menu will bring user back to Main Menu window 6 Exit enables user to quit the application Notes a If user does not save the result and choose to quit or to go back to Main Menu there will be a prompted dialog box confirming if user wants to discard the test result 24 N SAS Page 19 of 31 4 Operation Limitations 4 1 Shifting of workspace to different directories When workspace is shifted to a separate directory the script will still function normally but it may not be able to support keywords and line numbers This occurs when it is unable to locate the map file and list file previously selected If such problems occur select the map file and list file in the newly shifted workspace directory 4 2 Targets and Excel file User
28. nder Section P in the selected map file 4 8 Running of Test Cases During running of the test cases in the Test Status window avoid pressing the HEW functional keys e g F10 F11 If there is any occurrence of an error execution in the script that will result in user unable to close the Unit Test Supporting Tool window enter quit or exit in the Tcl Tk console to close the application The Tcl Tk console can be shown by pressing the F12 key Before running of the test cases it is strongly recommended that the HEW window be not minimised No minimisation of the HEW should be done during script execution in running the test cases as well to avoid any unexpected errors Thus it is advisable to set the Unit Test Supporting Tool to Window Topmost to prevent it from being obscured by the HEW 4 9 Radix of Watch window Do not change the default radix display for the Watch window If the display is set to any data representation other than Hex then the test results will fail 4 10 Inline Functions Keyword support for breakpoints in inline functions cannot be supported Before running of the test cases please disable the inline function declarations and re compile the user program 24 N SAS Page 21 of 31 5 Error Messages Error messages will be prompted as dialog boxes while user runs the script file Some form of guide will be provided in each dialog box to provide more detailed information
29. of Renesas Electronics or others You should not alter modify copy or otherwise misappropriate any Renesas Electronics product whether in whole or m part DL escriptians of circuits software and other related mtormatian in this document are provided only to illustrate the operation of semacandurtor products and application examples You are fully responsible for the incorporation of these circuits software and mfprmation in the design of your equipment Renesas Electronics assumes no resporsibility for amy losses mcurred by you ar third partes arising fram the use of these circuits software or information When exporting the products or technology described in this document you should comply with the applicable export control laws and regulations and follow the procedures required by such laws amd regulations You should pot use Renesas Electronics products or the technology described in this document for amy purpose relating to military applications or use by the military including but oot limited to the development of weapons of mass destruction Renesas Electronics products and technology may not be used for ar incorparated min any products or systems whose manufacture use ar sale is prohibited under any applicable domestic or foreign laws or regulations Renesas Electronics has used reasonable care m preparing the information mectuded in this document but Renesas Electronics does not warrant that such information is error free Remesas Ele
30. oint column Note that the format for each test case will have to conform to the settings as defined in the General Info Table Page 6 of 31 2 3 Overview of process flowchart Generally the UT Tool process flow can be described as follows Check Setup Execute Test Compare Environment Environment Case expected and Parameters actual results Figure 10 Overview of process flow 2 4 Excel file output After executing the script the final data will be written in Excel file After that the script will automatically compare this data and the expected data The comparison result will also be written at result column as PASS FAIL SKIP and ABORT Ed Microsoft Excel sample Test File 50v2 xls Est File Edit wiew Insert Format Tools Data Window Help Du E E ay 0 8 x 2 d G12 E irok war d z D ffrek uar d D fexpockuar_a d d0s5d an zzb HOSTS H nzzz H nzzk Mreskwar d 30 Mirckear z 5 gt Mfoexpe ct var _b 30 Po po Eoo E III Po A EIA OOOO PQ A Eo o oo 3 Po ee E 7777 5 55 4j PO fret uar d di i irok uar d ffoxpoct war b d L F gt 5 Y BE m m X ES i Boo pooo soo o i IE p qu 5 ae 1 ASA E 5 A E E E 1 0 0j Eo d o3 a ooossd Hroooes a Haor 6 Pee ov E E E d 0 E 1 0 s E E E ale 5 IE p A E He A QS E E qp A E qd Bo oo l I
31. on The selected file may not be a test file or the sheet name in the Excel file is renamed Use the button in Main Window to select a valid test file in the former case If it is the latter rename the Excel worksheet to AT TEST FILE Refer to Section 2 2 1 24 N SAS Page 23 of 31 5 1 6 Issue Unable to create new test case MM AutoTest UT Tool Unable to create new best case J Current test case must have at least 1 ikem to proceed The test item must have at least one entry Field input Figure 28 Cannot create new test case Resolution User should check whether the current test case has a test item input or that at least 1 text entry field has data 5 1 7 Issue Invalid expression Ml AutoTest_UT Tool X A Invalid expression Figure 29 The input is not a valid integer Resolution User should check whether the input at specified location is a valid integer Empty input will also be treated as invalid 5 1 8 Issue Out of range index ME AutoTest_UT Tool R Ld 1 Index is out of range Figure 30 The input is out of range Resolution User should check whether the input at specified location is within range of valid indexes 44 NC SAS Page 24 of 31 5 1 9 Issue Same source and destination indexes MM AutoTest UT Tool 1 The source and destination are the same Figure 31 Same src and dst inputs Resolution User should check whether the inputs at
32. opy 1fMs c cceeeeceeeeeecccccsscceesssseseseeseeececcccessecececsseseeeeeeceeeeceeeesseseeesaseees 26 5 1 13 Issue Remove test case confirmation ceccecceceeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeseeeeeeeeeeees 26 5 14 Issue Save changes to Test Fil iuiiieien e trt eoe P eoe hides eet px vac Iv ae ye oed rebel ve tbv veo vas ER SEA EVE EN PLE enaa 26 5 1 15 Issue Save changes before SX ITS escondida RI aii giia ariii i aaan inia idad 27 IO ASSURING SEITE C CC Ch Prado 28 5 1 17 LS ors ING SCC ICC map Tle AA re il HE EE EC e PE RO AE A 28 5 1 18 issues Could not locate 0D MS ca pa N ERER UER 28 5 1 19 issue Invalid list ile DECO RN 20 5 1 20 Issue PC not equal to specified breakpoint ooooooonnnnnnnnnnnnnnnnononononnnonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnns 20 5 1 21 Issue Stop Testing CONTA Orar 30 5 1 22 Issue Results existed in Test File ari dais 30 5 1 23 SUS AR SUI IES WOU Gy CU c 30 5 1 24 Issue Results not saved before exiting sess eene enne nnne nnn hn nn nnne eene s senses enn nnn nnns 3 V 21 N SAS 1 Introduction 1 1 Overview The purpose of the Unit Test Supporting Tool is to automate the Unit Test procedures General Functionalities of the Unit Test Supporting Tool includes 1 Access to an Excel file to set parameters in HEW 2 Execute pro
33. the two specfied locations are of different integer value 5 1 10 Issue Input exceeded limit AutoTest UT Tool E A Value cannot be more than 3 Figure 32 Limit 3 exceeded Resolution User should check whether the input at the specified location is less than or equal to the current limit specified 5 1 11 Issue Start value larger than end value MM AutoTest UT Tool Ld The start is larger than the the end Figure 33 Start larger than end Resolution User should check whether the start value input is less than or equal to the end value input at the specified locations 44 NC SAS Page 25 of 31 5 1 12 Issue Exceeded range to copy items Ml AutoTest_UT Tool wr Exceeded range Max 20 Figure 34 Exceeded range for copying of test items Resolution User should check whether there is enough blank item entries for copying the specified range of test items 5 1 13 Issue Remove test case confirmation MM Autolest UT Tool A Remove current Test Case No 51 cancel Figure 35 Remove test case data confirmation Resolution This dialog appears whenever user clicks the Remove button in the Test Case Setting window If user clicks OK in the dialog the current Test Case data will then be removed from memory Clicking Cancel will cancel the operation of removing the test case 5 1 14 Issue Save changes to Test File MM AutoTest UT Tool A Save changes to File
34. ting Tool Error Messages Provides a description on the error dialogs and also offers advice to assist user to input the correct setting This manual assumes that the user has a working knowledge of e High Performance Embedded Workshop Compiler Assembler and Linker e Microsoft Windows ENESAS i TABLE OF CONTENT ii DIETER EET T E l 1 1 OO A LO l 1 2 SE CUI RNIN PA E O UE E E O Em l PA Te EEE o E E uo TE 2 2 1 Ee SEQ As quiciera tna 2 Qe Excel Te gc T n e o o EEE E EEE EO E 5 2 2 1 Specification of Excel Mle nario A E EEEE 5 222 Specification Of General Info Table cocinar 6 2 9 Overview of process flowchart ccccccccccccccononononononnnnnnnnnnnnnnnnnnononn nono nn nennen sssnennn i rrr nn rer na aa uK enn n nnn nennen nnns 7 Pr E E o 7 OP EON Edo a E E E E E 9 3 1 Fomine UT Fool D e E E E E A E E 11 3 2 Features of Unit Test Supporting Tool Main Window oooccccccncnnnnnnccnnnnnnnnnnonnnnnnnnnnnnnnnnnnnononnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnns 12 3 3 Features of Unit Test Supporting Tool Test Case Template Generator ooooooooononcncnnnncnnnnnnnononononnnaninonnnnnnnnnnnnnnnos 13 3 4 Features of Unit Test Supporting Tool Setting WiNdOW cccccccccccccccncnnnnnononnnnnnnnnnnnnnnnnnnononnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnns 17 3 5 Features of Unit Test Supporting Tool Executing Test File occcccnccnnnnnnnononnnnnnnnnnnnnnnnnnnnononnnnononnnnnnnnnnnnnnnnnos 18 4 Operation WIA A
35. untested test cases to have the ABORT result Clicking No instead will resume testing 5 1 22 Issue Results existed in Test File Bl AutoTest UT Tool Test results already exists m Do vou want to overwrite iE ves o mw Figure 45 Overwrite existing results confirmation Resolution This dialog informs the user that the selected test file used for running the test cases within has previous test results saved into the file Clicking Yes in the dialog allows user to proceed with saving the current test results into the file overwriting the previous saved results Clicking No instead will cancel the save operation 5 1 23 Issue Results not saved MM AutoTest UT Tool A Exit to Main Menu without saving result Figure 46 Return to Main Menu confirmation Resolutions This dialog informs the user that the test results had not yet been saved before attempting to return to the Main Menu window of the script Clicking OK will proceed to return to Main window Clicking Cancel will cancel out the operation 24 NE SAS Page 30 of 31 5 1 24 Issue Results not saved before exiting MM AutoTest UT Tool A Do vau wish to exit without saving results ce Figure 47 Close script confirmation Resolution This dialog informs the user that the test results had not yet been saved before attempting to close the script Clicking OK will proceed to close the script Clicking C
36. will be inserted into the Excel file The starting position of the General Info table will be located at cell GENERAL INFO Items Row Col Test block 14 Max Items 20 Case No a Enable B Breakpoint C J J Variable E d Get Set E Total Cases 51 Exp SetValue F Casetested 0 Execution G Case passed 0 Resutt H Casefailed 0 Status I Caseskipped 0 Figure 8 Contents in the General Info Table E3 M crosoft Excel sample Test File_50 xls Ey le Edit View Insert Format Tools Data Window Help Ea d Fe ia 2 2 Arial EU E G H J 1 GERERA B GENER pal INFO 2 Items RowiCol 3 Test blodi4 Mazitems 20 7 Vanable D 9 9 GetSet E TotalCaseg5t 3 EzpiSet F CasetestedO 10 EzecutiolG CasepasseO 11 Result H Casefailedj0 12 Status CaseskippgO 13 M Case No Enable Breakpoint Variable Get Set Ezp 1 H 000232 Set Reset qo 16 1 17 H 000278 var a Get Status 5 M zl iset var d 0x1 ii keyword ware iset varc 50 fexpect var_a 999 D bet RENE SEE po Pp 33 1 E E e 34 HA A A Y ENG ro 2 2 o n2 n2 eo wn ow e no Figure 9 Excel worksheet General Info Table All data specified in the Excel file is treated as Decimal radix with the exception of the Breakp
Download Pdf Manuals
Related Search