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

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

通过 si 导出电路网表，实际上在 Virtuoso 中通过菜单 File - Export - CDL 和 Calibre LVS 中 Export from schematic viewer 也是通过 si 来导出电路网表的，下面讲下如何使用。

如何运行 si

下面是 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 网表的连接

Output/Run Directory 可以直接由输出网表的路径来决定。

编写脚本 export_cdl

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

点击查看完整代码

#!/bin/bash
#--------------------------
# Program  : export_cdl.sh
# Language : Bash
# Author   : YEUNGCHIE
# Version  : 2022.04.03
#--------------------------
HelpDoc(){
    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
}
 
for a in $@; do
    if [[ $a =~ ^-+h(elp)? ]]; then
        HelpDoc >&2
        exit 1
    fi
done
 
unset libName
unset cellName
unset viewName
unset netlistFile
unset cdslibFile
unset includeFile
unset includeFiles
unset connType
 
viewName='schematic'
connType='ansCdlHnlPrintInst'
 
# 命令行参数分析
while [[ -n $1 ]]; do
    case $1 in
        -lib)       shift;  libName=$1                      ;;
        -cell)      shift;  cellName=$1                     ;;
        -view)      shift;  viewName=$1                     ;;
        -file)      shift;  netlistFile=$1                  ;;
        -cdslib)    shift;  cdslibFile=$1                   ;;
        -include)   shift;  includeFile="$includeFile $1"   ;;
        -order)     connType='ansCdlSubcktCall'             ;;
        *)
            echo "Invalid option - '$1'" >&2
            echo "Try -h or -help for more infomation." >&2
            exit 1
        ;;
    esac
    shift
done
 
# 参数检查
if [[ ! ( -n $cdslibFile && -n $libName && -n $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
 
for f in $includeFile; do
    f=$(cd $(dirname $f); pwd -P)/$(basename $f)
    includeFiles="$includeFiles $f"
done
 
## 当网表文件名未定义时，设置默认文件名
if [[ -z $netlistFile ]]; then netlistFile="${cellName}.cdl" ; fi
 
runDir=$(dirname $netlistFile)
netlistFile=$(basename $netlistFile)
 
if [[ ! -w $runDir ]]; then
    echo "Cannot access run directory - $runDir" >&2
    exit 1
fi
 
# si.env 文件生成
cat > $runDir/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 = "$includeFiles"
auCdlDefNetlistProc = "$connType"
EOF
 
# 运行 si
si $runDir -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

相关拓展

• [ Shell ] 通过 Shell 脚本导出 CDL 网表 - YEUNGCHIE - 博客园 已完成

• [ Shell ] 通过 Shell 脚本导出 GDSII/OASIS 文件 - YEUNGCHIE - 博客园 已完成

• [ Calibre ] 脚本批量运行 LVS & DRC 的一个方法 - YEUNGCHIE - 博客园 未完成