Overview
This tool makes the test item generation easier for a large amount of STIL or VCD file conversion. This tool has following functions:
- Converts STIL or VCD files to patterns.
- Replaces the generated test condition values with variable.
- Adjusts timing restriction of the generated test condition.
- Adds a test item of each pattern to a work project.
- Updates pin group definition on adding a test item.
- Updates variable definition on adding a test item.
- Compiles the generated patterns.
- The generated work project is for MCU firmware only.
- The generated work project is generated in Standard mode.
For Expert mode, refer to “How to apply this tool to a work project made by expert mode”.
Notice
CLOUD TESTING SERVICE, INC. (“CTS”) PROVIDE THIS DOCUMENT, WITH FREE OF CHARGE, AS A REFERENCE FOR CUSTOMER(S) TO PREPARE ITS ORIGINAL SOFTWARE AND CIRCUIT USED IN CONNECTION WITH THE SUBSCRIPTION OF CTS’ SERVICE. CUSTOMER MAY DUPLICATE OR MODIFY SAMPLE PROGRAM AND CIRCUIT EXAMPLE IN THIS DOCUMENT OR ATTACHED SAMPLE PROGRAM AND CIRCUIT EXAMPLE; HOWEVER, CLOUD TESTING SERVICE, INC DO NOT GUARANTEE THAT ANY KIND OF FUNCTIONAL CONFORMITY AND/OR MALFUNCTION AND/OR ANY DAMAGES INCURRED DUE TO THE USE, OF THIS SAMPLE PROGRAM AND CIRCUIT EXAMPLE AND/OR ITS DERIVATIVE SOFTWARE AND CIRCUIT. CLOUD TESTING SERVICE, INC DEEM THAT THE CUSTOMER(S) RECOGNIZED AND AGREED TO THE TERMS OF USE SHOWN ABOVE WHEN CUSTOMER(S) RECEIVED THIS DOCUMENT OR ATTACHED SAMPLE PROGRAM AND CIRCUIT EXAMPLE.
Requirement
This tool requires the following licenses and tools.
- CloudTesting(TM) Lab
- STILReader for CX1000(for STIL conversion)
- CATVert-VCD for CX1000(for VCD conversion)
- gzip.exe(for gzipped STIL)
- Execution environment for Perl 5
Tool download
Download from here.
How to execute
This tool is executed at the Windows command prompt.
% atpg2cts.pl -stil samp.stil -file options.txt -template temp -cxproj temp.cxproj -compile
The following logs are displayed when executed.
atpg2cts.pl Version 1.00.00: start at Mon Jan 29 10:49:17 2018
execution folder: C:/sample
parameters: -stil samp.stil -file options.txt -template temp -cxproj temp.cxproj -compile
script log file: stil.log
listing file name by [-stil] option
file name: samp_1.stil
file name: samp_2.stil
2 file(s) to convert
samp_1.stil log file: samp_1.stilr.log
samp_1.stil: start conversion at Mon Jan 29 10:49:17 2018
samp_1.stil: end conversion at Mon Jan 29 10:49:25 2018
samp_2.stil log file: samp_2.stilr.log
samp_2.stil: start conversion at Mon Jan 29 10:49:25 2018
samp_2.stil: end conversion at Mon Jan 29 10:49:32 2018
CTLab_stilr: converted 2/2 file(s)
Execution diagram
This tool runs as the following diagram.
STIL/VCD conversion
STIL conversion
- Converts STIL files using STILReader for CX1000.
- The STIL file name or the folder name in where the STIL file exists is given with
-stiloption. - Dedicated STILReader option must be defined in the file that is given with
-fileoption. - Files generated by STILReader for CX1000 will be output in the folder that the script is executed.
Following options are available in STIL conversion.
| Options | Descriptions |
|---|---|
| -stil filename | Convert specified STIL file. |
| -stil foldername | Convert STIL files in specified folder. |
| -file option filename | Apply specified option file as option file for STIL Reader(1). |
| -allpinname | add prefix of pattern name to pin group all_pins. |
| -grpname | add prefix of pattern name to pin group other than all_pins. |
1:Allowable STILReader for CX1000 options will be shown as below.
| -nm | -scan | -basegrp | -pxrfilename | -errorcheck | -lf | -pingrp |
| -wfcmap | -makepinmap | -grpname | -pxr | -pinmap | -deledge | -tsoptimize |
| -allpname | -atpg | -tester | -tsmapfile | -wfcreport | -convopt | -var |
VCD conversion
- Convert VCD files using CATVert-VCD for CX1000.
- The VCD file name or the folder name in where the VCD file exists is given with
-vcdoption. - CDF(Conversion Definition File) used to CATVert-VCD for CX1000 must be prepared in advance, using CATVert Station is an easy way. The file is given with
-cdfoption. - Files generated by CATVert-VCD for CX1000 will be output in the folder that the script is executed.
- Does not support
-fileoption for CATVert-VCD for CX1000.
Following options are available in VCD conversion.
| Options | Descriptions |
|---|---|
| -vcd filename | Convert specified VCD file. |
| -vcd foldername | Convert VCD files in specified folder. |
| -cdf filename | Specify CDF file for CATVert-VCD for CX1000. |
Variable replacement for signal conditions
- Variable replacement for VIH, VIL, VOH, VOL and each timing set’s period value is available.
- Variable replacement is applied to “signal.csv“ generated from ”tcg.csv“.
Specify the following options to perform variable replacement.
| Options | Descriptions |
|---|---|
| -ts# variable | Replace the period of the timing set specified in “#.” When period is replaced, all signal timings of the timing set are replaced using equation below. New period value = variable nameNew timing value = (original timing value/original period value) * variable name |
| -vih variable | Replace VIH of all converted signals. If not specifed, “3.3” is set. |
| -vil variable | Replace VIL of all converted signals. If not specifed, “0.0” is set. |
| -voh variable | Replace VOH of all converted signals. If not specifed, “2.6” is set. |
| -vol variable | Replace VOL of all converted signals. If not specifed, “0.6” is set. |
Adjustment for timing restriction
- Confirmation and adjustment for timing restriction is available.
- Adjustment for timing restriction is effective when
-timing_chkoption is specified. - This function is unavailable when using
-tsoption or the timing value of specified STIL is described by variable.
Specify the following options to check and correct timing restrictions.
| Options | Descriptions |
|---|---|
| -timing_chk RATIO/DIFF | Check timing restriction.RATIO:Check if timing / period > 0.875 or not.DIFF:Check if period - timing < 1.25e-9 or not.RATIO and DIFF can not be used at the same time. |
| -timing_adj RATIO/DIFF | Adjust timing restriction.RATIO:Adjust timing to period * 0.875.DIFF:Adjust timing to period - 1.25E-9.RATIO and DIFF can not be used at the same time. |
Work project generation
Append new test items
- Copy .cxproj file specified by
-cxproj, add a test item of each pattern to the end of the test flow of copied .cxproj file. - The test name uses the each pattern name.
- The new test item copies a template test item which name is given by
-templateoption. Signal condition and pattern name are replaced. Replace TS name if TS mapping file exists.
Specify the following options and add test items.
| Options | Descriptions |
|---|---|
| -cxproj filename | Specify .cxproj filename to add test item. Specify .cxproj file made by Standard mode. |
| -template test item name | Specify the test item name to be used as a template when adding test items. Specify a test item made by Functional Testing IP. |
| -signal_ovw | Overwrite signal condition of template by the signal condition for each pattern. if not specified, insert the signal condition for each pattern to top of the signal condition of template. |
Update of pin group
- Updates pin group definition.
- If the pin group has already defined, the pins that compose the pin group are updated. If not defined, the pin group is appended.
- Pin definition is not updated. Pin definition is necessary to be set in the .cxproj file specified by
-cxorojoption in advance.
Update of Variable Definition
- Updates variable definition when variable is defined in original STIL file.
- If the variable has already defined, the variable and its value are not replaced. If not defined, the variable is appended.
- Array type variable is not supported.
Pattern compile
- Compiles patterns by
-compileoption.
Compile the pattern with the following options.
| Options | Descriptions |
|---|---|
| -compile | Compile patterns. |
Other options
The following options are available.
How to apply this tool to a work project created in expert mode
This tool is for a work project created in Standard mode, not available in a work project created in Expert mode. By the following process, it can be applied to work projects created in expert mode.
- Create new test item for the template (hereinafter referred to as A) in standard mode.
- Specify A to
-templateand execute the tool. - Load a work project created in Expert mode to CloudTesting(TM) Lab.
- By [Flow Item(F)]->[Append Flow Item From Other Work Project(A)] in Home Window’s menu, Select the work project generated at phase (2) and select test items to add.
Notice
- The generated work project is for MCU firmware only.
- The generated work project is generated in Standard mode.
- Work project file format is subject to change without notice.
- The script and the document are subject to change without notice.