SCAPIN(1)                                                    CAO-VLSI Reference Manual                                                   SCAPIN(1)

NAME

       scapin - Scan path insertion

ORIGIN

       This  software  belongs  to  the  ALLIANCE CAD SYSTEM developed by the ASIM team at LIP6 laboratory of Universite Pierre et Marie CURIE, in
       Paris, France.

       Web : http://asim.lip6.fr/recherche/alliance/
       E-mail : alliance-users@asim.lip6.fr

SYNOPSIS

       scapin [-VRB] [-P file] Input_name Path_name Output_name

DESCRIPTION

       SCAPIN is an automatic scan path generator for gate level netlists.  SCAPIN inserts a scan path in the netlist Input_name and drives a  new
       netlist  Output_name.  This scan path contains all registers specified in the file Path_name.path (see below for the exact syntax).  SCAPIN
       adds also 3 new connectors in the netlist: scan_in, scan_out and scan_test in order to control the scan path.  Eventually  SCAPIN  adds  an
       output buffer before the output connector scan_out (option -B).

ENVIRONMENT VARIABLES

       MBK_WORK_LIB(1)
                 indicates the path to the read/write directory for the session.

       MBK_IN_LO(1)
                 indicates the input netlist file format.

       MBK_OUT_LO(1)
                 indicates the output netlist file format.

       SCAPIN_PARAM_NAME
                 indicates  the  location of a parameter file (with extention .scapin) containing the properties (ports name, models name etc ...)
                 of all cells needed for the scan path insertion.  (see below for the exact syntax)

OPTIONS

       -V        Sets verbose mode on.  Each step is displayed on the standard output.

       -R        All registers of the scan path are replaced by an equivalent scannable register cell (called reg-mux).  (With the default  option
                 a simple multiplexor is added just before all registers of the scan path).

       -B        Adds an output buffer before the output connector scan_out.

       -P file   Specifies  a  parameter  file (with extention .scapin) containing the properties of all cells needed for the scan path insertion.
                 (see below for the exact syntax)

                 # Example of .scapin file

                 BEGIN_MUX

                 MUX_MODEL        mx2_x2
                 MUX_SEL          cmd
                 MUX_INPUT_SEL    i1
                 MUX_INPUT_NSEL   i0
                 MUX_VDD          vdd
                 MUX_VSS          vss
                 MUX_OUTPUT       q

                 END_MUX

                 BEGIN_REG

                 REG_MODEL        sff1_x4
                 REG_CLK          ck
                 REG_INPUT        i
                 REG_VDD          vdd
                 REG_VSS          vss
                 REG_OUTPUT       q
                 REG_MUX          mx2_x2
                 REG_REG_MUX      sff2_x4

                 END_REG

                 BEGIN_REG_MUX

                 REG_MUX_MODEL        sff2_x4
                 REG_MUX_SEL          cmd
                 REG_MUX_INPUT_SEL    i1
                 REG_MUX_INPUT_NSEL   i0
                 REG_MUX_CLK          ck
                 REG_MUX_VDD          vdd
                 REG_MUX_VSS          vss
                 REG_MUX_OUTPUT       q
                 REG_MUX_MUX          mx2_x2
                 REG_MUX_REG          sff1_x4

                 END_REG_MUX

                 BEGIN_BUF

                 BUF_MODEL            buf_x2
                 BUF_INPUT            i
                 BUF_VDD              vdd
                 BUF_VSS              vss
                 BUF_OUTPUT           q

                 END_BUF

       Path_name Specifies a parameter file (with extention .path) containing an ordered list of all instances (registers) of the scan  path.   It
                 contains also the name of the 3 connectors scan_in, scan_out and scan_test.  (see below for the exact syntax)

                 # Example of .path file

                 BEGIN_PATH_REG

                 cs_0
                 cs_1
                 cs_2

                 END_PATH_REG

                 BEGIN_CONNECTOR

                 SCAN_IN      scin
                 SCAN_OUT     scout
                 SCAN_TEST    test

                 END_CONNECTOR

SEE ALSO

       MBK_IN_LO(1).  MBK_OUT_LO(1).  MBK_WORK_LIB(1).

BUG REPORT

       This tool is under development at the ASIM department of the LIP6 laboratory.
       We need your feedback to improve documentation and tools.

ASIM
/LIP6                                                          Juin 29, 2000                                                         SCAPIN(1)