[ Shell ] 通过 Shell 脚本导出 CDL 网表

https://www.cnblogs.com/yeungchie/

通过 si 导出电路网表，实际上在 Virtuoso 中通过 export - cdl 和 Calibre LVS 的步骤中也是通过 si 来导出电路网表的，下面讲下如何使用。

command

下面是 si 的运行命令， $cdslibFile 为 cds.lib 文件。

si -batch -command netlist -cdslib $cdslibFile

si.env

在 si 的运行路径下需要提前准备好一个 si.env 文件，si 通过读取这个文件的内容来配置导出 cdl 所需要的信息。

文件的如何编写可以参考 help 文档：

• Virtuoso Shared Tools
  • Design Data Translators Reference
    • Design Translation Using CDL Out
      • Using CDL Out
        • Preparing the si.env File

简单看看就行，我一般是直接通过 GUI 界面尝试导出一份 cdl，然后在运行路径下会有一份 si.env 文件，下面是一个例子：

点击查看完整代码

simLibName = "stdcel"
simCellName = "TOP"
simViewName = "schematic"
simSimulator = "auCdl"
simNotIncremental = 't
simReNetlistAll = nil
simViewList = '("auCdl" "cdl" "schematic" "cmos_sch" "gate_sch" "cmos.sch" "gate.sch" "symbol")
simStopList = '("auCdl" "cdl")
hnlNetlistFileName = "TOP.cdl"
resistorModel = ""
shortRES = 2000.0
preserveRES = 't
checkRESVAL = 't
checkRESSIZE = 'nil
preserveCAP = 't
checkCAPVAL = 't
checkCAPAREA = 'nil
preserveDIO = 't
checkDIOAREA = 't
checkDIOPERI = 't
checkCAPPERI = 'nil
simPrintInhConnAttributes = 'nil
checkScale = "meter"
checkLDD = 'nil
pinMAP = 'nil
preserveBangInNetlist = 'nil
shrinkFACTOR = 0.0
globalPowerSig = ""
globalGndSig = ""
displayPININFO = 't
preserveALL = 't
setEQUIV = ""
incFILE = "./Subcircuit/3t_device.cdl"
auCdlDefNetlistProc = "ansCdlHnlPrintInst"

这个例子中导出的顶层电路单元是 stdcel/TOP/schematic，我们只关心其中几个常用的变量：

• simLibName ( Library Name ) stdcel
• simCellName ( Top Cell Name ) TOP
• simViewName ( View Name ) schematic
• hnlNetlistFileName ( Output CDL Netlist File )
• incFILE ( Include File )
• auCdlDefNetlistProc ( Analog Netlisting Type ) 这个变量决定 pin 的连接方式
  • ansCdlSubcktCall ( Connection By Order ) 顺序连接
  • ansCdlHnlPrintInst ( Connection By Name ) 命名端口连接，一般选择这个来保证 IP/Digital 网表的连接

Run Directory 直接由 si 的运行路径来决定。

export_cdl

明白了 si 的使用方法，现在可以写一个 shell 脚本，在 Terminal 操作，实现便捷地导出指定电路单元的 cdl 文件。

点击查看完整代码

#!/bin/bash
#--------------------------
# Program  : export_cdl.sh
# Language : Bash
# Author   : YEUNGCHIE
# Version  : 2022.04.03
#--------------------------
HelpInfo(){
    cat <<EOF
-------------------------------------------------
Export CDL ( Circuit Description Language ) File
-------------------------------------------------
Usage: export_cdl -cdslib cdslibFile -lib libName -cell cellName [ OPTIONS ]

    -cdslib     Path of cds.lib file
    -lib        Schematic top cell libName
    -cell       Schematic top cell cellName
    -view       Schematic top cell viewName ( Default: schematic )
    -file       Output netlist file name    ( Default: ./<cellName>.cdl )
    -include    Include subckt file name
    -order      Netlisting Type Connection By Order ( The default is By Name )
    -h, --help  Display this help

Examples:   export_cdl  -cdslib ./cds.lib  -lib Xeon  -cell X999  -include ./subckt.cdl

Output:     Netlist file: X999.cdl
EOF
}

viewName='schematic'
connType='ansCdlHnlPrintInst'

# 命令行参数分析
while [[ -n $1 ]]; do
    if [[ -n $opt ]]; then
        case $opt in
            lib_opt)        libName=$1      ;;
            cell_opt)       cellName=$1     ;;
            view_opt)       viewName=$1     ;;
            file_opt)       netlistFile=$1  ;;
            cdslib_opt)     cdslibFile=$1   ;;
            include_opt)    includeFile=$1  ;;
        esac
        unset opt
    else
        case $1 in
            -lib)       opt='lib_opt'       ;;
            -cell)      opt='cell_opt'      ;;
            -view)      opt='view_opt'      ;;
            -file)      opt='file_opt'      ;;
            -cdslib)    opt='cdslib_opt'    ;;
            -include)   opt='include_opt'   ;;
            -order)
                connType='ansCdlSubcktCall'
            ;;
            -h|--help)
                HelpDoc >&2
                exit 1
            ;;
            *)
                echo "Invalid option - '$1'" >&2
                echo "Try -h or --help for more infomation." >&2
                exit 1
            ;;
        esac
    fi
    shift
done

# 参数检查
if [[ ! ( $cdslibFile && $libName && $cellName ) ]]; then
    ## 缺少必要参数时，打印 help 并退出
    HelpInfo >&2
    exit 1
elif [[ -f $cdslibFile ]]; then
    ## 将相对路径改为绝对路径
    cdslibDir=$(cd $(dirname $cdslibFile); pwd -P)
    fileName=$(basename $cdslibFile)
    cdslibFile="$cdslibDir/$fileName"
else
    ## 找不到 cds.lib 文件，打印报错
    echo "No such file - $cdslibFile" >&2
    echo "Try -h or --help for more infomation." >&2
    exit 1
fi

## 当网表文件名未定义时，设置默认文件名
if [[ ! $netlistFile ]]; then netlistFile="${cellName}.cdl" ; fi

# si.env 文件生成
cat > si.env <<EOF
simLibName = "$libName"
simCellName = "$cellName"
simViewName = "$viewName"
simSimulator = "auCdl"
simNotIncremental = 't
simReNetlistAll = nil
simViewList = '("auCdl" "cdl" "schematic" "cmos_sch" "gate_sch" "cmos.sch" "gate.sch" "symbol")
simStopList = '("auCdl" "cdl")
simNetlistHier = t
hnlNetlistFileName = "$netlistFile"
resistorModel = ""
shortRES = 2000.0
preserveRES = 't
checkRESVAL = 't
checkRESSIZE = 'nil
preserveCAP = 't
checkCAPVAL = 't
checkCAPAREA = 'nil
preserveDIO = 't
checkDIOAREA = 't
checkDIOPERI = 't
checkCAPPERI = 'nil
simPrintInhConnAttributes = 'nil
checkScale = "meter"
checkLDD = 'nil
pinMAP = 'nil
preserveBangInNetlist = 'nil
shrinkFACTOR = 0.0
globalPowerSig = ""
globalGndSig = ""
displayPININFO = 't
preserveALL = 't
setEQUIV = ""
incFILE = ""
auCdlDefNetlistProc = "$connType"
EOF

# 运行 si
si -batch -command netlist -cdslib $cdslibFile

status=$?

# 删除垃圾文件
if [[ -f .stimulusFile.auCdl ]]; then rm -rf .stimulusFile.auCdl ; fi
if [[ -f si.env              ]]; then rm -rf si.env              ; fi
if [[ -f netlist             ]]; then rm -rf netlist             ; fi
if [[ -d ihnl                ]]; then rm -rf ihnl                ; fi
if [[ -d map                 ]]; then rm -rf map                 ; fi

exit $status

运行方法

例：cdslib 文件为 ./cds.lib

1. 导出 verify 库中的 ad01d0 单元的电路网表。

   export_cdl -cdslib cds.lib -lib verify -cell ad01d0
   

   导出的 cdl 文件名为 ad01d0.cdl

2. 导出 verify 库中的 inv0d0 单元的电路网表，同时包含 subckt 网表文件 ./netlist，并指定 cdl 文件名为 inv.cdl 。

   export_cdl -cdslib ./cds.lib -lib verify -cell inv0d0 -include ./netlist
   

   导出的 cdl 文件名为 inv.cdl

相关拓展

[ Calibre ] 脚本批量运行 LVS DRC 的一套流程 - YEUNGCHIE - 博客园