GENESIS脚本培训

1、深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量在 genesis2000 编程中，我们需要很多 genesis 自身已经定义的变量，并且在变量后面跟上不同的参数，会得到 genesis 里面很多的内定值（比如层的属性），使用这些内定值会使我们的程序编写简单，且让程序更有价值，下面我们将详细讲述这部分内容。作者：刘才林第 1 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS

2、2000 内定变量4.1：info 简介：在 genesis2000 中，我们可以通过 info 指令得到 genesis database 里面的各种信息，我们可以把这些信息写到程序里面，实现 genesis 自动化，info 指令格式如下：COMinfo,args = -t -e -d -p , -s serial_number-o options helpout_file=/out_file, write_mode = source/out_file在 我 们 把 info 写 进 程 序 时 ， 为 书 写 方 便 ， 我 们 把 它 简 写 为 DO_INFO ， 这 个 简 写 别

3、 名 在 $GENESIS_DIR/sys/hooks/script_start.csh 中已自动定义，其定义的内容如下：alias DO_INFO set IFILE = /tmp/info.$; COM info,out_file=$IFILE,write_mode=replace,args= !:* ; source $IFILE; rm $IFILE如果你发现DO_INFO不能使用，则可按照上面内容进行定义：4.2：info参数定义：在上面我们讲述info的格式，它的参数有4个，如下：(1):out_file定义将信息输出文件的路径及文件名，如/tmp/info(2):units设置输

4、出资料的单位，是inch还是mm。(3):write_mode，设置输出到文件是追加到原来的文件，还是替换原来的文件。(4):args设置抽取datebase那一部分的信息：由以下8个选项组合定义：t设置获取信息实体项目名称：如matrixe设置获取信息实体项目路径：如JOB/matrixd设置获取信息实体项目中的数据类别：如matrix中的ROWm设置获取信息的方式是以程序的方式输出还是以显示的方式输出p设置获取信息实体项目中的数据参数，如step中的x,yo设置获取信息实体项目中的选项，多用于checklists设置仅获取信息数组中的那一组，用序号表示help输出帮助文件。下面我们详细讲述

5、各参数的意义：4.2.1：out_fieout_file参数是设置输出文件的路径及路径名，它以纯文本的方式存储，例如：我们写一个名为info的脚本，程序内容如下：COM info,out_file=/tmp/info,args= -t layer -e $JOB/pcs/drill -m script,write_mode=replace则我们会在/tmp目录下找到名为info的文本文件，打开后可看见如下内容：set gCONTEXT = boardset gTYPE = drillset gPOLARITY = positiveset gSIDE = noneset gDRL_START =

6、 silkcset gDRL_END = silksset gFOIL_SIDE = noneset gSHEET_SIDE = noneset gROW = 9作者：刘才林第 2 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量set gIS_CHANGED = yes我们可以看出里面包含很多关于datebase的信息。4.2.2:write_mode:write_mode是我们输出文件模式，是将内容追加到以前的文件，还是替换以前的文件，append为追

7、加，replace为替换，根据我们的需要写为不同的模式：例如我们要输出layer的参数，以替换的方式输出，则程序内容如下：COM info,out_file=/tmp/info,args= -t layer -e $JOB/pcs/drill -m script,write_mode=replace当我们打开/tmp/info文件就可以看到所有$JOB/pcs/drill中所有关于层的信息，以前/tmp/info所有的内容都将被清除。如果我们要输出layer的参数，以追加方式输出，其程序内容如下：COM info,out_file=/tmp/info,args= -t layer -e $JO

8、B/pcs/drill -m script,write_mode=append我们再次打开/tmp/info文件就可以看到两次关于$JOB/pcs/drill层的信息。4.2.3：args中-t选项：我们在前面讲述-t为设置获取信息实体项目名称，除我们要取得帮助内容外，其它的程序都应有-t这个选项，这个选项后面可跟以下参数。attributes属性信息job料号信息ncset钻孔输出信息step实体信息check分析报告信息layer层信息notes注记信息symbol符号信息comp元件层信息matrix矩阵信息panel_classes拼版精灵信息wheelwheel文件信息eda设计信息

9、netlist网络对比信息rootroot信息etsetetset信息ncrset铣输出信息stackup叠板信息camtek-aoisetcamtek-aoiset信息mania_aoisetmania_aoiset 信息范例：（1）：取得料号信息：COM info,out_file=/tmp/info,args= -t job e $JOB我们会得到当前料号的信息，其内容如下：set gSTEPS_LIST = (pcs panel)set gSYMBOLS_LIST = ()作者：刘才林第 3 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作

10、者：刘才林 网站：第四章GENESIS2000 内定变量set gWHEELS_LIST = ()set gMATRIX_LIST = (matrix)set gSTACKUPS_LIST = (ttt)set gTEMPLATES_LIST = ()set gATTRname = (.comment .customer .global_camtek_aoiset .technology .primary_side .design_origin_x .design_origin_y .board_thickness)set gATTRval= (top00

11、0.000000)set gFORMS_LIST = (autocool autogh ex ff)set gFLOWS_LIST = (fgg genesis gggfgg)set gIS_CHANGED = no4.2.4：args的-e选项：-e选项为设置获取信息实体项目路径，也就是我们获取信息的路径，如果我们不写路径，程序就无法搞清楚你要获取那部分的信息，你也许会说这样会输出所有database的信息，但实际上是不可能，我想你也不需要这样做。所以我们要指定路径:如$JOB/$STEP/drill等。其中因root为最高目录，而不需要定义路径，其余实体皆需要定义正确路径。下面我们给出每种

12、实体路径的范例：（1）：root(不需要路径)COM info,out_file=/tmp/info,args= -t root（2）：job:COM info,out_file=/tmp/info,args= -t job e $JOB（3）：attributes:COM info,out_file=/tmp/info,args= -t attributes e $JOB （4）：ncset:COM info,out_file=/tmp/info,args= -t ncset e $JOB/pcs/drill/dd （5）：setp:COM info,out_file=/tmp/info,a

13、rgs= -t step e $JOB/step （6）：check:COM info,out_file=/tmp/info,args= -t check e $JOB/step/check1 （7）：layer:COM info,out_file=/tmp/info,args= -t layer e $JOB/pcs/drill （8）：notes:COM info,out_file=/tmp/info,args= -t notes e $JOB/pcs/drill/notes （9）：symbol:COM info,out_file=/tmp/info,args= -t symbol e

14、$JOB/shiyan （10）：comp：COM info,out_file=/tmp/info,args= -t comp e $JOB/pcs/top/1 （11）：matrix：COM info,out_file=/tmp/info,args= -t matrix e $JOB/matrix （12）：panel_classes：COM info, out_file=/tmp/info,args= -t panel_classes e $JOB （13）：wheel：作者：刘才林第 4 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘

15、才林 网站：第四章GENESIS2000 内定变量COM info,out_file=/tmp/info,args= -t wheel e $JOB/xxx （14）：eda：COM info,out_file=/tmp/info,args= -t eda e $JOB/step（15）：netlist：COM info,out_file=/tmp/info,args= -t netlist e $JOB/step/netlistname （16）：etset：COM info,out_file=/tmp/info,args= -t etset e $JO

16、B/step/etsetname (17)：ncrset：COM info,out_file=/tmp/info,args= -t ncrset e $JOB/$STEP/rout/ncrset （18）：stackup：COM info,out_file=/tmp/info,args= -t stackup e $JOB/stackup4.2.5:args的-d选项：-d选项是设置获取信息实体项目中的数据类别，几乎每一个实体中都有很多类别，如step中就有17个类别，因为我们会经常用到这些类别，下面我们给出常用的实体数据类别：(1):rootJOB_LIST(array)读取料号列表信息(2

17、)：jobSTEPS_LIST (Array)读取steps列表信息SYMBOLS_LIST (Array)读取symbols列表信息WHEELS_LIST (Array)读取wheels列表信息MATRIX_LIST (Array)读取matrix列表信息STACKUPS_LIST (Array)读取stackups列表信息TEMPLATES_LIST (Array)读取templates列表信息ATTR (Array)读取属性相关信息FORMS_LIST (Array)读取forms列表信息FLOWS_LIST (Array)读取flows列表信息 CHANGES (Free text o

18、utput) 读取改变而未保存的内容 IS_CHANGED读取料号是否已经改变而未保存(3)：stepDATUM读取基准点信息LIMITS读取图形的最大坐标NUM_SR读取拼版里面有几种排版SR (Array)读取排版信息SR_LIMITS读取排版坐标信息NUM_REPEATS读取有多少个拼版REPEAT (Array)读取每个pcs的排版信息PROF_LIMITS读取profile的坐标信息 PROF (Free text output)读取profile的每个点信息ACTIVE_AREA读取激活图形区域信息LAYERS_LIST (Array)读取层列表信息CHECKS_LIST (Arr

19、ay)读取分析列表信息NETS_LIST (Array)读取网络列表信息ATTR (Array)读取属性列表信息ETSETS_LIST (Array)读取etset列表信息作者：刘才林第 5 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量 IS_CHANGED PROF_LENGTH(4):symbol LIMITS FILL SYMS_HIST (Array) FEAT_HIST ATTR (Array) FEATURES(5):layer CONTE

20、XT TYPE POLARITY SIDE DRL_START DRL_END FOIL_SIDE SHEET_SIDE ROW LIMITS SYMS_HIST (Array) FEAT_HIST SLOT_HIST NUM_TOOL TOOL (Array) TOOL_SLOTS TOOL_THICK TOOL_USER ATTR (Array) FEATURES NCSETS_LIST AOISETS_LIST NCRSETS_LIST LPD LPM IS_CHANGED(6): wheel DCODE（7）：matrix NUM_ROWS NUM_COLS NUM_LAYERS读取料

21、号是否已经改变而未保存读取profile的总长度symbol的最小和最大坐标填充的距离存在部件列表读取部件列表信息属性信息部件详细信息层属性是board还是 misc层的属性（drill）层的极性(polarity)层为板的top还是bottom面或者为inner钻孔的起始层钻孔的结束层计算层在芯板的top面还是bottom面（此时不算comp和sold层，L2将被算为top面，L3将被算为bottom面）和FOIL_SIDE功能相似，不过加上comp和sold层（此时L2将被算为bottom面）层排在第几行层里面内容最小和最大坐标symbol列表部件列表信息槽孔列表信息刀具总数刀具信息钻孔管

22、理器对槽孔设计信息钻孔管理器的板厚信息钻孔管理应用参数属性信息部件详细信息钻孔输出列表AOI列表铣输出列表读取输出gerber的参数读取输出光绘的参数读取料号是否已经改变而未保存各D码详细参数有多少个rows有多少个cols有多少个非空的层作者：刘才林第 6 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量NUM_STEPS有多少个非空的stepROW (Array)层的详细信息COL (Array)组的详细信息ATTR (Array)matrix属性参数

23、（8）：check:CHK_ATTR运行详细属性列表，分为name、val、exists三个栏位。LAST_TIME最后运行时间DURATION运行所用时间NUM_ACT分析中项目的总个数TITLEcheck标题STATUS是否已经运行ERFERF参数内容MEAS详细报告分析结果REPORT将问题按类别和范围进行分类统计并报告 MEAS_DISP_ID报告问题点相对应的层(9): attributesNUM_ATR属性总数ATR (Array)属性详细信息FORCE_LIB获取用户属性4.2.6：args的-m选项：-m选项是设置输出的格式是以显示内容的方式还是以程序的方式：（1）：以程序的方

24、式输出如下：COM info,out_file=/tmp/info,args=-t matrix e $JOB/matrix m scripts得到的结果如下：set gNUM_ROWS =13set gNUM_COLS =4set gNUM_LAYERS=13set gNUM_STEPS = 3set gCOLcol=(1234)set gCOLtype=(step stepstep empty)set gCOLstep_name=(pcspanel dd)set gATTRname =()set gATTRval =()（2）：以显示的方式输出，如下：COM info,out_file=/

25、tmp/info,args=-t matrix e $JOB/matrix m scripts得到的结果如下：NUM_ROWS=13NUM_COLS=4NUM_LAYERS=13NUM_STEPS=3COL1:col=1,type=step,step_name=pcsCOL2:col=2,type=step,step_name=panelCOL3:col=3,type=step,step_name=ddCOL4:col=4,type=empty,step_name=作者：刘才林第 7 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站

26、：第四章GENESIS2000 内定变量4.2.7：args的-p选项：-p选项是设置我们要获取那些参数信息，这个选项将我们获得的信息更详细，或者说利用参数让程序仅仅输出我们想要的信息，我们可以使用“+”号同时获取几个参数的信息，不过只有一部分数据类别有参数，举例说明：COM info,out_file=/tmp/info,args= -t step e $JOB/pcs m display d DATUM p x 得到内容：DATUM :X = 0如果我们不用-p参数：COM info,out_file=/tmp/info,args= -t step e

27、 $JOB/pcs m display d DATUM 得到内容：DATUM：x=0,y=04.2.8:args的-o选项-o是info指令中的选项，常用于check，且在check中必须指定我们要得到chicklist中的那一个项目的信息（checklist中的项目按排列顺序来定）：（1）：check中-o的参数有以下几个内容：action读取checklist中的第几个项目信息（用1，2，3数字表示）categoryERF参数中的那个项目，如P2Pseverity读取报告等级，如Rlayer读取报告为那一层index信息报告是否跟序号（2）：针对其它部分的-o参数：break_sr拼版里所

28、有的信息select选择的部件break_feat所有部件的详细信息4.2.9：args的-s选项：-s是设置在获取信息时，仅获取那一组信息，我们通过上面的学习知道，很多的信息输出都是一个数组，有的时候我们只需要获取那一组信息，则用-s的选项。如-s 2就为获取第2组的信息，下面我们以范例来详细说明：读取钻孔的信息,不加-s选项：COM info,out_file=/tmp/info,args= -t layer e $JOB/pcs/drill d tool得到的结果：set gTOOLnum= (123)set gTOOLcount= (51010)set gTOOLshape= (hol

29、eholehole)set gTOOLtype= (platedplatedplated)set gTOOLtype2= (standardstandardstandard)set gTOOLmin_tol= (000)set gTOOLmax_tol= (000)set gTOOLfinish_size= (40-0-0)set gTOOLdrill_size= (43.31025)set gTOOLbit= (1.10)set gTOOLslot_len= (000)下面我们只要第2组的信息，则程序如下：COM info,out_file=/tmp/info,args= -t layer

30、e $JOB/pcs/drill d tool s 2作者：刘才林第 8 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量set gTOOLnum= (2)set gTOOLcount= (10)set gTOOLshape= (hole)set gTOOLtype= (plated)set gTOOLtype2= (standard)set gTOOLmin_tol= (0)set gTOOLmax_tol= (0)set gTOOLfinish_siz

31、e= (-0)set gTOOLdrill_size= (10)set gTOOLbit= ()set gTOOLslot_len= (0)4.3：获取信息详解：在前面我们讲述了info的参数，各种选项如何使用，也提到获取信息的数据类别，下面我们将以范例的方式描述从datebase获取一些常用的信息。4.3.1：root的范例(1):获取的为datebase中所有的料号名称。COM info,out_file=/tmp/info,args= -t rootset gJOBS_LIST = (dd fdf ff gg hh sdff sdffff shiyan)4.3.2:job的范例：(1)：

32、获取flows的列表信息:COM info,out_file=/tmp/info,args t job e $JOB d FLOWS_LIST set gFLOWS_LIST = (fgg genesis gggfgg)(2): 获取froms的列表信息：COM info,out_file=/tmp/info,args t job e $JOB d FROMS_LISTset gFORMS_LIST = (autocool autogh ex ff)（3）：获取step的列表信息：COM info,out_file=/tmp/info,args t job e $JOB d STEPS_LIS

33、T set gSTEPS_LIST = (pcs panel)(4)：获取symbol的列表信息：COM info,out_file=/tmp/info,args t job e $JOB d SYMBOLS_LIST set gSYMBOLS_LIST = (fff panel_sym-inn_even_vent ttt tttd)(5):获取料号是否改变内容：COM info,out_file=/tmp/info,args t job e $JOB d IS_CHANGED set gIS_CHANGED = no4.3.3:matrix的范例：(1):获取组的信息，获取的信息有组号、组属

34、性、组名称。COM info,out_file=/tmp/info,args t matrix e $JOB/matrix d COLset gCOLcol=(123)setgCOLtype=(stepstepempty)setgCOLstep_name =(pcspanel)(2):获取我们当前的料号总共有多少个step:COM info,out_file=/tmp/info,args t matrix e $JOB/matrix d NUM_COLSset gNUM_COLS = 3(3):获取当前料号matrix的ROW的信息：其中获取的信息有，层所在行数、层是否为空、层的名称、层是作者

35、：刘才林第 9 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量board还是misc、层的属性、层的正负极性、层排列在板那边、钻孔的开始层、钻孔的最结束层、层按芯板分在那面（以内层为芯板），层加上外层排列在top还是bottom面。COM info,out_file=/tmp/info,args t matrix e $JOB/matrix d ROWset gROWrow=(1234567)set gROWtype=(layerlayerlayerla

36、yerlayerlayerlayer)set gROWname=(smccompl2soldsmssilksdrill)set gROWcontext=(boardboardboardboardboardboardboard)set gROWlayer_type =(solder_masksignalpower_ground signalsolder_mask silk_screen drill )set gROWpolarity= (positivepositive negativepositive negativenegativepositive)set gROWside=(toptopi

37、nnerbottombottombottomnone)set gROWdrl_start=(smc)set gROWdrl_end=(silks)set gROWfoil_side=(nonetoptopbottomnonenonenone)set gROWsheet_side =(nonetopbottombottomnonenonenone)（4）：获取matrix中有几个有用的层：COM info,out_file=/tmp/info,args t matrix e $JOB/matrix d NUM_LAYERS set gNUM_LAYERS = 74.3.4：step的范例：（1）

38、：获取层的列表：COMinfo,out_file=/tmp/info,args= -t step e $JOB/pcs d LAYER_LIST set gLAYERS_LIST = (smc comp l2 sold sms silks drill)(2):读取profile的最小和最大的坐标：COM info,out_file=/tmp/info,args= -t step e $JOB/pcs d PROF_LIMITS set gPROF_LIMITSxmin = 0set gPROF_LIMITSymin = 0set gPROF_LIMITSxmax = 5set gPROF_LI

39、MITSymax = 5(3):获取拼版信息：获取的信息有：拼版内step名称、step的基准点的位置、step的拼版间距、step的拼版个数、拼版的旋转角度、拼版是否镜像、拼版最小和最大位置。COM info,out_file=/tmp/info,args= -t step e $JOB/pcs d SRset gSRstep= (pcs)set gSRxa= (1.6346219 )作者：刘才林第 10 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量

40、set gSRya= (8.0510925 )set gSRdx= (5.12)set gSRdy= (5.12)set gSRnx= (3)set gSRny= (2)set gSRangle= (90)set gSRmirror= (no)set gSRxmin= (1.6346219 )set gSRymin= (3.0510925 )set gSRxmax= (16.8746219)set gSRymax= (13.1710925)（4）：获取基准点的位置：COM info,out_file=/tmp/info,args= -t step e $JOB/pcs d DATUM set

41、gDATUMx = 0set gDATUMy = 0（5）：获取cheklist的列表：COM info,out_file=/tmp/info,args= -t step e $JOB/pcs d CHICKS_LISTset gCHECKS_LIST = (cdr_signal_lyr_chk fls_basic_analysis fls_basic_cleanup)4.3.5：layer的范例：（1）：部件的详细信息：COM info,out_file=/tmp/info,args= -t layer e $JOB/pcs/comp d FEATURES# Layer - comp fea

42、tures data #P 2.7680673 1.982353 r40 P 0 0 N#P 2.8090673 1.982353 r40 P 0 0 N#P 2.8500673 1.982353 r40 P 0 0 N#P 2.8910673 1.982353 r40 P 0 0 N#P 2.9320673 1.982353 r40 P 0 0 N#P 2.9730673 1.982353 r40 P 0 0 N#P 3.0140673 1.982353 r40 P 0 0 N#P 3.0550673 1.982353 r40 P 0 0 N#P 3.0960673 1.982353 r40

43、 P 0 0 N#P 3.1370673 1.982353 r40 P 0 0 N#S P 0#OB 1.538655511811 2.842016830709 I#OS 1.538655511811 3.942016830709#OS 2.832773228346 3.942016830709#OS 2.832773228346 2.842016830709#L 4.6488344 3.245333 6.3774058 3.1713835 r2 P 0#L 4.6488344 3.243033 6.3774058 3.1690835 r2 P 0#L 4.6488344 3.240733 6

44、.3774058 3.1667835 r2 P 0#L 4.6488344 3.238433 6.3774058 3.1644835 r2 P 0（2）：读取钻孔的信息：读取的信息有刀具、个数、形状、属性（plated等）、属性2（standard 等）、孔径正负公差、钻孔尺寸、成品尺寸、钻孔bit、槽孔长度。作者：刘才林第 11 页共 28 页完成于 2008/3 月深圳PCB培训网 GENESIS2000脚本培训课程 作者：刘才林 网站：第四章GENESIS2000 内定变量COM info,out_file=/tmp/info,args= -tlay

45、er e $JOB/pcs/comp d TOOLset gTOOLnum= (123)set gTOOLcount= (51010)set gTOOLshape= (holeholehole)set gTOOLtype= (platedplatedplated)set gTOOLtype2= (standardstandardstandard)set gTOOLmin_tol= (000)set gTOOLmax_tol= (000)set gTOOLfinish_size= (40-0-0)set gTOOLdrill_size= (43.31025)set gTOOLbit= (1.10

46、)set gTOOLslot_len= (000)（3）：读取部件的列表信息：得到线部件多少个、焊盘部件多少个、铜面部件多少个、文字部件多少个、圆弧部件多少个、总共多少个部件。COM info,out_file=/tmp/info,args= -t layer e $JOB/pcs/comp d FEAT_HISTset gFEAT_HISTline= 0set gFEAT_HISTpad= 25set gFEAT_HISTsurf= 0setgFEAT_HISTarc=0setgFEAT_HISTtext=0set gFEAT_HISTtotal = 25(4): 读取symbol的信息：得

47、到symbol的大小、各symbol的线的个数、各symbol的焊盘的个数、各symbol的圆弧的个数COM info,out_file=/tmp/info,args=-t layer e $JOB/pcs/comp d FEAT_HISTset gSYMS_HISTsymbol= (r2r40)set gSYMS_HISTline= (110000)setgSYMS_HISTpad=(0110)setgSYMS_HISTarc=(00)（5）：读取层的极性：COM info,out_file=/tmp/info,args= -t layer e $JOB/pcs/comp d POLARITY set gPOLARITY = positive4.3.6：check范例：（1）：读取ERF参数：会得到各ERF的信息：COM info,out_file=/tm