Bar Swap

Review
Process &
ATF Audit tool
Reference manual for automatic
audit item, ATF Audit generator and
checker tool

Script usage for end-users

support

Process Review Scripts and Audit Tool Check

files were generated as part of the LV DA Tool
Project, developed by the DA Working Group
during Q4 2014. Team include peers from
Costa Rica, Guadalajara, Folsom and BA.
1

Table of Contents
Overview.................................................................................................................... 1
Completion criteria..................................................................................................... 1
Command line............................................................................................................ 1
Arguments.................................................................................................................. 2
Output data................................................................................................................ 3
Third Part scripts........................................................................................................ 4
Support....................................................................................................................... 4

Overview

Completion criteria

Command line
Bar Swap is an automated process to provide a better scenario for potential metal only
stepping ECOs, which is completed doing an opportunistic replacements of bar00 by
bar01 cells and disconnecting gcn/tcn/vcn layers of these cells, PEOs can implement
RTL or timing fixes without changes for these layers, saving mask regeneration for only.

This script reads the number of bar00/bar01 cells for given partition. Then use the
following acceptance criteria: Clean Partition must have a numbers of bar00 cells equal
to half of bar01 cells + 1.

$AUDIT/audit.bar_swap.pl
-mw_cel

<mw_cel name>

-build_path

<build directory>

-label

<library label name>

-flow_type

<library flow type name>

-atf

(yes|no)

-proj

<Gallery project>

-milestone

<milestone name>

Example:

$AUDIT/audit.bar_swap.pl
-proj bxtb0 -build_path $BUILD_PATH
-label nolabel
-flow_type eco_man_12 -atf yes
-mw_cel gtssmpar1 milestone basefill_done

Arguments-mw_cel:
(Required) milky_way cell with bar swap process completed.

-build_path:
(Required) Full path from user partition build directory (work area), you can use
$BUILD_PATH system variable.

-label:
(Required) library tag defined as directory name containing mw_cel, located at
$BUILD_PATH/dbs

-flow_type:
(Required) library tag defined as directory name containing mw_cel, located at
$BUILD_PATH/dbs/<label>/mdbs

-atf (yes|no):
(Required) special switch to determine ATF (Activity tracking file) audit creation.
Useful to call out audit sign off, as well prevent overwrite completed partitions audits.

-milestone
(Required) name of Audit closure milestone you are trying to reach, option will
depend of project and milestone.

Output data-proj:
(Required) Gallery project name. This input data may differ to $PROJECT
system variable. To find out this value, you can use Gallery tool File Select and
select your project under Active Project pop up window.

Script will create the following directory ($AUDIT /.audit/barswap_check) to keep a

record of latest run, the following files will be written:
${mw_cel}.ICC: Internal ICC command line used by $AUDIT/bundle.ICC_command_runner.pl
to open ICC design and read the number of bar00 and bar01,
barswap_result.log: Internal file used to stores the output from ${mw_cel}.ICC that include the
number of bar00/bar01 cells present in the design (partition).
${mw_cel}.barswap_check.log: Script output file, stores all user and run information, as well
final status. Its the input file to request the ATF sign off for this check, for this partition. Mw_cel
name will be used as part of the process to ensure consistency among ATF sign offs along each
milestone.

Third Part scripts

Support
$AUDIT/bundle.ICC_command_runner.pl:
This Perl Script is used to open a non GUI ICC system, and performs commands sent.
Log file of this script can be found at
$BUILD_PATH/.audit/bundle.ICC_command_runner, file name
<mw_cel>_barSwap_icc_output.log.
See reference manual of this script for more details.
$ATF_GEN_DIR/atf_gen.pl
-ward $BUIL_PATH -p $GALLERY_PROJECT -fub <mw_cel> -c bar_swap.cf d mi
<milestone>
This code will review and approve/deny ATF sign off generation.
$CHECKATF_DIR/checkAtf.pl
-p $GALLERY_PROJECT -mo latest -a bar_swap
-mi <milestone> -b <mw_cel> -d
This code print out current status of given ATF and mw_cel.

Please report any issue or share feedback to:

Project owner: Oscar Andres Munoz Alcazar.

Script developer: Victor Hugo Martinez.
ATF sign off developer: Adrian Manuel Cervantes Hernandez.
Reference manual owner: Oscar Andrs Munoz Alcazar.
DTS DA contact: Lari Jones