Cadence Vmanager （一）—— Regression操作指南

已于 2023-11-29 16:16:20 修改
阅读量1.6k 收藏 12
点赞数 4
分类专栏： Vmanager使用心得 文章标签： Cadence vmanager vsif file IC验证 regression
于 2023-11-26 18:49:26 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ZhangShuHuai11/article/details/134631107
版权

目录

1. Regression功能使用指南

1.1 NTF格式介绍

1.1.1 NTF的BNF（巴克斯范式）描述

1.1.1.1 {属性：值}定义

1.1.1.2类别

1.1.1.3语法

1.1.2 NTF的预处理（#include，环境变量获取）

1.1.3 NTF的限制

1.1.4 NTF的错误处理

1.2 vsif文件中有效的container

1.2.1 session {…}

1.2.2 group/test {…}

1.2.2.1 auto_scan_args

1.2.2.2 bundle_group

1.2.2.3 code_coverage

1.2.2.4 count

1.2.2.5 repetition

1.2.2.6 copied_files

1.2.2.7 depends_on

1.2.2.8 details

1.2.2.9 drm_job_priority_vmgr

1.2.2.10 dut_name

1.2.2.11 exit_on

1.2.2.12 fully_directed

1.2.2.13 gui_mode

1.2.2.14 linked_files

1.2.2.15 pre_group_script

1.2.2.16 pre_run_script

1.2.2.17 primary_run

1.2.2.18 post_group_script

1.2.2.19 post_run_script

1.2.2.20 post_simulate_script

1.2.2.21 revision

1.2.2.22 run_mode

1.2.2.23 run_script

1.2.2.24 scan_script

1.2.2.25 seed

1.2.2.26 sim_args

1.2.2.27 sv_seed

1.2.2.28 sve_name

1.2.2.29 timeout

1.2.2.30 verbosity

1.2.2.31 vplan_ref

1.2.2.30 waveform

1.2.2.31 write_metrics

1.3 vsif文件中环境变量的设置

1.3.1 $ENV环境变量

1.3.2 $RUN_ENV环境变量

1.3.3 $DIR环境变量

1.3.4 SVE文件的编写

1.4 采用vmgr执行regression的具体操作流程

1. Regression功能使用指南

1.1 NTF格式介绍

Cadence的Vmanager工具采用vsif类型的文件作为regression的输入文件，采用vplanx/csv类型的文件作为vplan的输入文件，vplanx、vsif文件采用标准的嵌套文本格式（NTF），NTF是一种元格式，类似于XML，本文有关于Vmanager采用的NTF格式的介绍如下：

  1. NTF的BNF（巴克斯范式）描述
  2. NTF的预处理（#include，环境变量）
  3. NTF的限制
  4. NTF的错误处理

1.1.1 NTF的BNF（巴克斯范式）描述

BNF可以理解为专门用于描述（定义）语言的元语言，就是用书面文字的方式来定义编程语言，多出现在各种语言的官方文档中，比如Python官方文档：

NTF的BNF格式如下：

  1. 容器（container）的标识符取决于文件类型，比如：
    1. vsif files--session，group，test
    2. vplan files--import，section，perspective，coverage，extend，instantiate，within
  2. 标识符不区分大小写；
  3. 可以在任何BNF元素之间自由使用空白。若要保留名称或属性值中的空格，需要将其放在双引号中；
  4. 使用“//”或者“--”可以注释掉该行；
  5. 容器（container）的关闭符号“}”后面的分号“;”是可选的；
  6. vManager在读取文件时从字符串中删除引号；
  7. 有关{属性（attribute）: 值（value）}的完整说明，可以参阅attribute : value；
  8. NTF 中没有前向引用（需要按顺序定义属性）。例如，在 vplan 文件中，必须首先定义section属性，然后定义views属性，然后定义section的扩展属性 within 属性。
1.1.1.1 {属性：值}定义

使用“:”定义一个属性的具体值。

1.1.1.2类别

属于容器的成员变量（可以把容器理解为一个类，属性就是该类的成员变量，值就是成员变量的具体值）

1.1.1.3语法

attribute_name: attribute-value；

  • attribute_name 是仅包含字母数字字符和下划线字符的标识符。attribute_name中不允许有空格，但允许在attribute_name前后使用空格。attribute_name区分大小写。session属性的name必须与所有的test属性的name不同。换言之，不能在test和session中使用相同的attribute_name。
  • attribute_value可以为空或者按如下语法：
    1. 字符串，可选用引号括起来，如果attribute_value在引号中，则删除引号，保留引号中的内容。如果attribute_value不在引号中，则删除初始和最终空格，并将任何多个空格替换为一个空格。
    2. 注意（所有字符串属性（预定义和用户定义）限制为 32672 个字符。当尝试输入超过 32672 个字符时（在所有方法中 - vsif、edit、scanning），该值将被截断并以“ ..."代替.）
      1. vManager沿 $VMANAGER_PATH 搜索file的完整或部分路径名
      2. 多行文本，按如下方式括起来<text></text>，<text>必须是第一行中的第一个非空格标记，并且</text>必须是最后一行中的最后一个非空白标记。<text> 和</text>可能出现在同一行上，尽管这相当于在实际文本周围使用双引号。
      3. 举例：如下2个dut_error含义相同：
    3. 注意，后定义的容器内属性会覆盖以前的属性。

1.1.2 NTF的预处理（#include，环境变量获取）

在 vsif 文件中，可以使用任何标准 C++ 指令。有关详细信息，请参阅标准 C++ 指令。在其他 NTF 文件中，可以在文件中的任何位置添加 #include 指令。vManager 将 include 指令视为文件内容写入其中。

#include语法如下：

  • 包含的文件必须用双引号括起来。
  • 每个 include 指令都必须写在仅包含自身的一行中。
  • 不允许在 include 指令的末尾使用分号。
  • include 指令中允许使用环境变量。使用类似 shell 的语法 $ENV_VAR 或 ${ENV_VAR}。
  • 不要在 #include 指令中使用 vsif 指令 $ENV（）、$RUN_DIR、$DIR（） 或 $ATTR（）。

如果未将包含的文件指定为绝对路径，vManager 将搜索以下目录：

  • 包含文件的目录（包含 #include 指令或 import {} 的文件）。
  • 运行vManager 的目录。
  • $VMANAGER_PATH 环境变量指定的任何目录。

1.1.3 NTF的限制

  • 如果数据本身带<text>这个字符的话，vManager就不能编译在<text> </text>标识符之间的数据。
  • NTF 容器必须在打开它们的文件中关闭。如果在一个文件中打开容器，则无法在包含的文件中关闭它。
  • 例如，不支持以下内容：

1.1.4 NTF的错误处理

解析 NTF 文件时，可能有两种类型的错误：

  • NTF 不兼容错误 -- 文件不是 NTF 格式。
  • 特定于应用程序的错误 -- 文件采用 NTF 格式，但根据正在读取的格式，其中的数据是错误的。例如，编写“seed： 123”是有效的 NTF 语法，把seed作为vsif中的container的{属性:值}是正确的，但seed放在vplan 中会产生错误。

1.2 vsif文件中有效的container

vsif 文件指定要在单个session中运行的一个或多个test。为了支持 vsif 文件的链接，一个 vsif 文件中允许有多个session容器。

vsif 文件还允许以下语法：

  • 标准 C++ 编译器指令，包括 #include、#define、#ifdef 和 #ifndef；
  • 属性值指令，包括 $ENV、$RUN_ENV、$ATTR 和 $DIR；

以下是 vsif 文件中的有效 NTF 容器：

对于上面每个容器，它可以容纳的用户定义属性数是有限制的。如下：

其中：

  • other types包括：path，duration，enum，long，double，boolen。
  • other containters包括：test，group，session，run，session_output。

1.2.1 session {…}

在session容器中可以定义如下属性：

1.2.2 group/test {…}

在group/test中可以定义如下属性：

1.2.2.1 auto_scan_args
  1. 描述：将用户参数传递给自动扫描命令（尤其是 vm_scan.pl）；
  2. 语法：auto_scan_args: arguments
  3. 举例：

group long_tests {

  auto_scan_args: -max_patterns 50;

}

  1. 解释：日志扫描分两个步骤执行：
  • 在 vsif 中执行由 scan_script 属性定义的扫描规范
  • 使用 Xcelium 等 Cadence 工具时自动完成补充扫描。

虽然第一步由用户定义，但第二步是自动完成的。使用auto_scan_args属性，用户可以将参数传递给在互补扫描中执行的vm_scan.pl命令。指定为此属性的值的参数将追加到原始 vm_scan.pl 命令中。

1.2.2.2 bundle_group
  1. 描述：将组作为单个 DRM 作业执行
  2. 语法：bundle_group:boolean（默认为FAUSE）
  3. 解释：boolean 是一个布尔值。如果为 TRUE，则整个group（包括pre_session和post_session脚本）以及grouptest的整个子层次结构将捆绑到一个 DRM 作业中。如果为 FALSE（默认值），则不应用用户定义的捆绑规范。
1.2.2.3 code_coverage
  1. 描述：打开或关闭代码覆盖率收集
  2. 语法：code_coverage:string, 其中string 可以为用双引号或不加引号的<text></text>括起来的任何字符串。如果不加引号，则字符串只能包含字母数字字符、下划线、点或斜杠。
  3. 例子：

                

     4.解释：如果在 vsif 中定义此属性，vManager 会将该定义导出为环境变量 （BRUN_CODE_COVERAGE）。但是，仿真器不会自动拾取此信息。您必须在运行脚本中将其传递给模拟器。例如：

        xrun -svseed $BRUN_SV_SEED $BRUN_CODE_COVERAGE $BRUN_HDL_FILES

1.2.2.4 count
  1. 描述：指定test的运行次数
  2. 语法：count : int
  3. 例子：
  4. 解释：此属性指定您希望在单个session中执行test的次数。如果使用 seed 或 sv_seed 属性指定多个种子，则运行的测试数等于种子总数乘以 repetitions 属性的值。如果种子数与 count 属性表示的数字不匹配，则会选择一个随机种子，vManager 会发出警告。有关count和repetition的综合效果的示例，见repetition。作为一般准则，建议不要在单个session中启动超过 10,000 次运行。此属性不支持使用 $RUN_ENV。
  5. 注意：如果seed属性结合count属性使用，将会以如下规则为准：
    1. 当seed具有单个值时，运行次数将等于 count 的值；
    2. 当seed具有多个值时，运行次数将等于seed数；
    3. 如果seed数与count数匹配，则 vManager 将运行该数目的测试；
    4. 如果seed数小于count数，则 vManager 将运行所有seed测试，然后对超出的count数使用随机seed。
    5. 如果seed数大于count数，则 vManager 将运行所有seed测试（忽略count）。
    6. seed中的重复值将仅计数一次。例如：

        

        下例中的seed有重复，根据规则4和1，等同于采用positive_gen_random种子一次，随机种子4次，运行5次

        

        下例中seed有5个（1重复），count只有2个，根据规则6，相当于有4个种子，再根据规5，运行4次

        

1.2.2.5 repetition
  1. 描述：为test或group中的test将run的次数定义一个乘数
  2. 语法：repetition:unit(int为非负数，默认值为1)
  3. 例子：将会复制my_file文件到run目录下。
  4. 解释：此属性用于将文件复制到 session/group/run 目录。
1.2.2.6 copied_files
  1. 描述：要复制到 session/group/run 目录中的文件。
  2. 语法：copied_files:pathname，其中pathname 是要复制到 session/group/run 目录的文件的完整路径。
  3. 例子：将会复制my_file文件到run目录下。
  4. 解释：此属性用于将文件复制到 session/group/run 目录。
1.2.2.7 depends_on
  1. 描述：在测试之间创建依赖关系。
  2. 语法：depends_on:pathname，其中pathname 是相对路径（使用 ../[../]name shell 格式），该test或group必须在运行当前test之前完成其执行。vsif 中test和group的相对路径名必须是唯一的。。
  3. 例子：下例中要求group2的pre_group要在group3所有jobs完成后执行。
  4. 解释：每个session都在具有依赖关系的阶段中执行。可以在test之间、group之间或test与group之间定义其他依赖关系。这些依赖项通过指定在test或group中的test可以运行之前必须完成的test来充当阻止操作。由于可以通过将group嵌套在其他group中来隐式定义依赖关系，也可以通过添加 depends_on 属性来显式定义依赖关系，因此可能会出现依赖关系冲突。例如，以下 vsif 包含依赖矛盾（循环依赖）：

    一方面，由于 group2 嵌套在 group1 中，因此隐式组依赖关系要求 group1 的pre_group脚本在 group2 的jobs开始运行之前完成其执行。

    另一方面，由于 group1 显式依赖于 group2 ，因此所有 group2 的jobs都必须在 group1 的pre_group脚本开始之前完成其执行。

  6. 注意：vmanager运行器会在开始运行之前识别到依赖关系的矛盾并报错。
  7. 例如：如下的vsif文件中定义了2个显示依赖关系

         

1.2.2.8 details
  1. 描述：用于描述一个test的用途、目的。
  2. 语法：details:<text>text</text>
  3. 解释：如果在与此属性相同的test或group容器中定义的任何test也被标识为具有 vplan_ref vsif 属性或 directed_test vplan 属性的定向测试，则 vManager 会在“验证计划”窗格中显示此文本作为说明。。
1.2.2.9 drm_job_priority_vmgr
  1. 描述：指定 DRM 作业优先级。
  2. 语法：drm_job_priority_vmgr:int，其中int 是一个整数值。有效值的范围因 DRM 而异。vManager 不会验证此处指定的值，如果值无效，job提交将失败。没有默认值。因此，如果未指定值，则会为job分配默认优先级（由 DRM 配置）。
  3. 例子：
  4. 解释：通过设定该属性以指定DRM jobs的优先级。
1.2.2.10 dut_name
  1. 描述：指定DUT名字。
  2. 语法：dut_name：string
  3. 例子：
  4. 解释：通过设定该属性以指定DUT名字。
1.2.2.11 exit_on
  1. 描述：定义Specman退出条件。
  2. 语法：exit_on:option，其中option可为 normal_stop , error , all.
  3. 例子：
  4. 解释：该属性只对Specman工具生效。
1.2.2.12 fully_directed
  1. 描述：指定这是完全定向的测试。
  2. 语法：fully_directed:boolean，默认值为FALSE
  3. 例子：
  4. 解释：完全定向测试仅在session的第一次迭代中运行一次。
1.2.2.13 gui_mode
  1. 描述：打开或关闭交互模式。
  2. 语法：gui_mode:string
  3. 例子：
  4. 解释：如果在 vsif 中定义此属性，vManager 会将该定义导出为环境变量 （BRUN_GUI_MODE）。但是，仿真器不会自动拾取此信息。您必须在运行脚本中将其传递给仿真器。
1.2.2.14 linked_files
  1. 描述：要链接到 session/group/run 目录的文件。。
  2. 语法：linked_files: pathname
  3. 例子：会在run目录下产生一个连接文件，连接到my_file
  4. 解释：此属性用于在 session/group/run 目录中创建指向文件系统中其他文件的链接。
1.2.2.15 pre_group_script
  1. 描述：在调用一组test之前的pre_group阶段执行任何 shell 命令。
  2. 语法：pre_group_script:pathname，pathname应为绝对或相对路径；
  3. 例子：
  4. 解释：在调用group中的任何test之前，可以使用此属性运行任何脚本。
  5. 注意：pre_group_script属性的解析度是本地的。换言之，该定义仅适用于本组，而不适用于任何子组。此属性不能在任何重新运行方案中使用，因为它不会复制到 vsof。要扫描pre_group日志，请将 scan 命令附加到pre_group_script。示例：
    1. ​​​​​​​
1.2.2.16 pre_run_script
  1. 描述：在调用run之前执行任何 shell 脚本。
  2. 语法：pre_run_script:pathname，pathname应为绝对或相对路径；
  3. 例子：
    1. ​​​​​​​
  4. 解释：在调用test之前，可以使用此属性运行任何脚本。
1.2.2.17 primary_run
  1. 描述：指示所选运行是否为主运行。此属性的默认值为 false。
  2. 语法：primary_run:true
  3. 例子：
    1. ​​​​​​​
  4. 解释：只能在 collect 或 vsif 期间定义primary_run。之后，每当您进行analysis或export_merge时，您都会得到您设置的内容。此外，在数据库中有一组run后，可以手动将其中一个运行设置为主运行。《vManager 用户指南》的“收集运行”部分中也讨论了 PrimaryRun。
1.2.2.18 post_group_script
  1. 描述：在调用一组test之后的post_group阶段执行任何 shell 命令。
  2. 语法：post_group_script:pathname，pathname应为绝对或相对路径；
  3. 例子：
    1. ​​​​​​​
  4. 解释：在调用group中的所有test之后，可以使用此属性运行任何脚本。
  5. 注意：post_group_script属性的解析度是本地的。换言之，该定义仅适用于本组，而不适用于任何子组。此属性不能在任何rerun方案中使用，因为它不会复制到 vsof。要扫描pre_group日志，请将 scan 命令附加到pre_group_script。示例：
1.2.2.19 post_run_script
  1. 描述：scan脚本执行完成后执行任何 shell 命令。
  2. 语法：post_run_script:pathname，pathname应为绝对或相对路径；
  3. 例子：
    1. ​​​​​​​
  4. 解释：您可以使用此属性在scan脚本完成后和post_session脚本之前运行任何脚本。
1.2.2.20 post_simulate_script
  1. 描述：在run完成后，在调用scan脚本之前执行任何 shell 命令。
  2. 语法：post_simulate_script:pathname，pathname应为绝对或相对路径；
  3. 例子：
    1. ​​​​​​​
  4. 解释：可以使用此属性在单次run脚本完成后和调用scan脚本之前运行任何脚本。
1.2.2.21 revision
  1. 描述：提供每次运行的修订信息。。
  2. 语法：revision:string;其中，string可以被“”或者<text></text>括起来；
  3. 例子：
  5. 解释：此属性允许您查询特定修订版中的测试。例如，您可能希望查找在特定修订版中执行的所有运行。修订信息按以下模式输出到日志文件：revision 属性可以包含在group和test容器中。
1.2.2.22 run_mode
  1. 描述：指定运行模式。
  2. 语法：run_mode:string，其中string可以为batch，interactive，batch_debug，interactive_debug这四种；（默认为batch）
  3. 例子：
    1. ​​​​​​​
  4. 解释：运行器将 BRUN_RUN_MODE 环境变量设置为与 run_mode 属性相同的值。这允许 $BRUN_RUN_SCRIPT 根据需要调用命令行界面或图形界面，无论是否使用其他调试工具。
1.2.2.23 run_script
  1. 描述：指定使用 SVE 调用组合的simulator/vManager可执行文件的脚本。
  2. 语法：run_script:path，其中path为绝对路径或相对路径；（默认为batch）
  3. 例子：
    1. ​​​​​​​
  4. 解释：运行器希望 run_script 属性指定一个 shell 命令，该命令调用组合的 vManager 模拟器可执行文件并启动单个运行。例如，在vm_xor示例中，run_script属性设置为：/<INSTALL_DIR>/vmanager/vm_lib/vm_xsoc/scripts/run_ex_vm_xsoc.sh。运行脚本可以使用由各种 vsif 属性创建的所有环境变量，以及由 sve 文件设置的环境变量。例如，运行脚本可以根据 local_run.sh 中设置的 $BRUN_RUN_MODE 的值，调用具有或不具有其他调试工具的交互式或批处理运行。
1.2.2.24 scan_script
  1. 描述：指定用于扫描仿真输出以查找故障的脚本。
  2. 语法：scan_script:path，其中path为绝对路径或相对路径；（默认为batch）
  3. 例子：
    1. ​​​​​​​
  4. 解释：运行器期望 scan_script 属性指定一个 shell 脚本，该脚本扫描运行的标准输出，查找失败和其他特殊信息。该脚本使用各种筛选器文件中指定的模式来查找特定工具输出的消息。您可以修改这些筛选器文件或创建新的筛选器文件，以处理特定于项目的要求。使用 scan_script 属性时，必须显式指定筛选器。 您可以使用 vManager vm_scan.pl提供的基本scan脚本。有关预定义筛选器文件的完整列表，请参阅使用扫描脚本和预定义的筛选器文件。可以使用vmanager系统自带的标准filter，如以下几个：
1.2.2.25 seed
  1. 描述：指定一个test的seed。
  2. 语法：seed:value，value可以为一个32bit的整型变量，或一个整型集合。
    1. ​​​​​​​
  3. 例子：
    1. ​​​​​​​
  4. 解释：此属性指定运行器自动传递给 Specman 生成器的种子。通过传递特定种子，可以多次运行完全相同的测试。 需要注意的是，此处的 seed 属性将用作 VSOF 报告属性，而不是像 Specman 那样用作 VSIF 属性。最好使用sv_seed单独传递种子。
  5. 注意：如果为seed和sv_seed属性指定了多个种子，则只有以下组合是合法的：
    1. 两个seed都有单/随机值。
    2. 一个seed有多个值，而另一个seed只有一个值（随机或常量）。
    3. 两个seed具有完全相同数量的多个值。在这种情况下，运行的测试数是不同seed值的数量，并且seed被确定为成对。（第一个seed值与第一个sv_seed值配对，第二个seed值与第二个sv_seed值配对，依此类推）。
  6. 注意：运行器将每个测试的seed值写入 vsof，如下所示：
    • 如果在 vsif 中将种子指定为整数，则该值将写入本地 vsof。
    • 如果指定了 gen_random 或 positive_gen_random，则计算该值并将其写入本地 vsof。
    • 如果指定了 random，则在运行开始之前不会将任何值写入本地 vsof。
    • 在运行结束时，扫描脚本会查找运行中实际使用的种子，并将其写入 vsof。如果运行失败，并且扫描脚本未提取种子，则运行器写入的初始值生效。此行为使你能够使用应在该运行中使用的相同种子重新运行失败的运行。如果使用 random，并且运行失败，则重新运行将使用默认种子值，即 random。
    • 不建议对此属性使用 $RUN_ENV。
1.2.2.26 sim_args
  1. 描述：指定要在用户的运行脚本 $BRUN_SIM_ARGS 中使用的仿真参数。
  2. 语法：sim_args:arguments，其中arguments可以是任何仿真参数。
  3. 例子：
    1. ​​​​​​​
  4. 解释：此属性用于在用户的运行脚本 $BRUN_SIM_ARGS 中指定仿真参数。
1.2.2.27 sv_seed
  1. 描述：指定此测试的种子。
  2. 语法：sv_seed:value，value同seed属性。
  3. 例子：
    1. ​​​​​​​
  4. 解释：此属性指定任何代理（如 Incisive Simulator）的种子。如果在 vsif 中定义此属性，vManager 会将该定义导出为环境变量 （ BRUN_SV_SEED ）。但是，运行器不会自动将此值传递给代理。必须在 run-script 中显式传递它。例如：xrun -svseed $BRUN_SV_SEED $BRUN_HDL_，由于此行是在运行环境中执行的，因此定义了变量 BRUN_SV_SEED，因此会正确计算和传递。如果定义多个种子，则运行的测试数等于种子总数乘以重复属性的值。如果种子数与 count 属性表示的数字不匹配，vManager 将发出警告。
1.2.2.28 sve_name
  1. 描述：设置验证环境。
  2. 语法：sve_name:attribute-value，attribute-value 是 SVE 文件的绝对或相对路径名，扩展名为 .sve。输入 sve 文件的完整路径。
  3. 例子：
    1. ​​​​​​​
  4. 解释：sve 文件仅设置控制运行所需的环境变量;它不应包含其他命令。运行器在执行运行之前获取 SVE 文件。
1.2.2.29 timeout
  1. 描述：为一个run设置timeout时间。
  2. 语法：timeout:time，time 是一个非负数，表示终止运行前的秒数。如果此属性设置为 0，则禁用超时机制。默認值為900s
  3. 例子：
    1. ​​​​​​​
  4. 解释：timeout定义 run_script 属性中给定的命令的最长执行时间。在目标主机上调用运行时，测量开始。如果运行未在指定时间内完成，则会终止该运行并标记为错误。
1.2.2.30 verbosity
  1. 描述：打开或关闭vbt程度。
  2. 语法：verbosity:string。
  3. 例子：
    1. ​​​​​​​
  4. 解释：如果在 vsif 中定义此属性，vManager 会将该定义导出为环境变量 （ BRUN_VERBOSITY ）。但是，仿真器不会自动拾取此信息。您必须在运行脚本中将其传递给仿真器。例如：

        xrun -svseed $BRUN_SV_SEED $BRUN_VERBOSITY $BRUN_HDL_FILES

1.2.2.31 vplan_ref
  1. 描述：指定test所对应的vplan部分的名称。
  2. 语法：vplan_ref:pathname，pathname 是一个字符串，指定一个或多个验证计划部分的分层路径，格式为：[[/]section-name/...]节名[,...]该字符串可以包含 AWK 样式的通配符，以匹配不同的 vPlan 部分名称。如果在字符串中指定相对路径，则该选项将匹配以指定路径结尾的所有 vPlan 部分。例如，A/B 等同于 .*A/B。此选项区分大小写，但对空格不敏感。连续的空白将折叠成一个空格。。
  3. 例子：
  4. 解释：使用此属性可以指定定向测试所属的 vPlan 节的名称。可以输入多个 vPlan 部分，用逗号分隔。vManager 在 vPlan 窗格中显式加载的任何 vsif 文件中查找测试。如果未读取 vsif 文件，vManager 将搜索当前上下文中存在的测试。如果 vManager 找到测试或一组测试的vplan_ref属性，则会在 vPlan 的指定部分下显示这些测试的覆盖率结果。
1.2.2.30 waveform
  1. 描述：打开或关闭波形。
  2. 语法：waveform:string。
  3. 例子：
  5. 解释：如果在 vsif 中定义此属性，vManager 会将该定义导出为环境变量 （ BRUN_WAVEFORM ）。但是，仿真器不会自动拾取此信息。您必须在运行脚本中将其传递给仿真器。例如：xrun -svseed $BRUN_SV_SEED $BRUN_WAVEFORM $BRUN_HDL_FILES
1.2.2.31 write_metrics
  1. 描述：通过 vManager 控制覆盖率数据的生成。
  2. 语法：write_metrics:disable，应将 write_metrics 属性设置为禁用，以便通过 vManager 生成覆盖率衡量指标。 （默认为TRUE）
  3. 例子：
    1. ​​​​​​​
  4. 解释：如果 write_metrics 属性设置为禁用，则会生成 UXE 运行的覆盖率指标。

1.3 vsif文件中环境变量的设置

vmanager支持如下环境变量：

1.3.1 $ENV环境变量

  1. 描述：引用静态环境变量。此变量必须在调用 vManager 之前定义，并在解析 vsif 时使用。
  2. 语法：$ENV(env_var)
  3. 例子：
  4. 解释：使用 $ENV（） 指定的环境变量在解析 vsif 时在session启动期间进行评估。为了提供稳定的rerun环境，rerun时使用 $ENV 指令指定的属性的值与原始运行期间使用的值相同。在rerun测试之前更改环境变量对新运行没有影响。以下属性需要静态值，因此这些属性中使用的任何环境变量都必须使用 $ENV（） 指定：

1.3.2 $RUN_ENV环境变量

  1. 描述：引用仅在运行时已知的动态环境变量。此环境变量可以在 SVE 文件中定义，并在运行时由job使用。
  2. 语法：$RUN_ENV(env_var)
  3. 例子：
  4. 解释：使用 $RUN_ENV（） 指定的环境变量在run的执行阶段进行评估。使用此指令指定的值在rerun期间不稳定，并且会重新计算以重新执行run。例如，您可以在 sve 文件中设置使用 $RUN_ENV（） 指定的变量的值。vManager 支持表中所示的构造，用于引用 vsif 中的attribute。
    1. ​​​​​​​
  5. 评估：每个container的attribute值在 vsif 层次结构中最内层（最低）位置（“最内层优先”）进行评估。如果根本没有为层次结构定义attribute，则使用默认值。使用此指令给出的值在rerun期间重新计算，以便为新session/chain提供相关value。数据库中显示的最终值是展开所有属性引用后在运行期间使用的值。

  6. 如下例子中：由于test t的最内层优先原则，导致model_dir的路径被设置为dir2.

    1. ​​​​​​​

1.3.3 $DIR环境变量

注： 请使用 $DIR（），而不是使用 vManager 的运行包装脚本中设置的变量，例如 $BRUN_SESSION_DIR。

  1. 描述：keyword是session/chain/group/run之一。运行器将 $DIR（keyword）替换为指定目录的完整路径。
  2. 语法：$DIR(keyword)
  3. 例子：
  4. 注意：如果多个层次都定义了同样一个attribute，则服从最内层优先原则，如果在层次结构的级别上使用此指令，而该层次结构没有请求的目录（例如，在group内使用 $DIR（run）），则该值为空字符串。在下例中，组 g 的 model_dir 属性为 /model_dir，因为 $DIR（run） 在组容器中返回一个空字符串。$DIR（run） 为测试 t1 和测试 t2 正确扩展。测试 T1 继承组的 model_dir 属性，但对于测试 T2，此值将被覆盖。

1.3.4 SVE文件的编写

验证项目通常需要一个或多个验证环境（SVE）。通常，SVE 的某些特征被定义为 vsif 属性，而其他特征则被定义为 sve 文件中的环境变量。SVE 文件和 vsif 文件仅影响运行器启动的运行，它们不会影响当前对 vManager 的调用。在启动 vManager 之前，必须设置与 vManager 调用相关的所有环境变量，可以用作环境变量，也可以在 system.specman 文件中设置。

SVE 通常由以下部分定义：

  • 测试平台（通常为 e 或 SystemVerilog）；
  • DUT（通常为 HDL 或 C）；
  • 代理（通常为 IES）；
  • 基本工具集参数，例如build脚本、scan脚本和run脚本的名称；
  • 其他工具集参数，例如操作系统以及模拟器的名称和版本；

SVE文件的编写如下例：

TC_NAME="cpto_sw_v200_tc001_aes_enc"; export TC_NAME

在vsif文件中按照如下方式应用：

​​​​​​​

1.4 采用vmgr执行regression的具体操作流程

以CPTO项目为例，首先编写的vsif文件，如下所示：

session cpto_sw_v200_session {
    top_dir : $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/vm_test;
    drm : parallel_local;
    max_runs_in_parallel : 50;
    free_hosts : TRUE;
    create_debug_logs : TRUE;
    create_optimized_coverage_data : ALL_SESSION;
    output_mode: terminal;
    verification_scope : cpto_sw_v200_normal_test;
    description : <text>This session contains 50 tests run with seed=0000 used for cpto_sw_v200 BT verification !!!</text>;
    //pre_session_script : "" ;
    post_session_script : "make -f $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/makefile com";
    //model_dir : "$ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/cov/imc/cov_work/scope";
    local_top_dir : "$ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/vm_test/my_local_dir";
}

group cpto_sw_v200_single_aes_mode {
    bundle_group : FALSE;
    repetitions : 1;
    count : 1;
    sv_seed : 0000;
    gui_mode : "off";
    run_mode : "batch";
    //pre_group_script : ;
    //post_group_script : ;
    scan_script : "vm_scan.pl uvm.flt shell.flt ius.flt" ;
    dut_name : cpto_sw_v200 ;
    sve_name : "$ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/vm_test/env_var.sve" ;
    verbosity : "UVM_MEDIUM";
    waveform : "off";
    code_coverage : "-covfile $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/cov_config.ccf";

    test single_aes_enc {
        //pre_run_script : "";
        run_script : "make -f $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/makefile run tc=$RUN_ENV(TC_NAME) seed=$ATTR(sv_seed) fsdb=off vbt=$ATTR(verbosity)";
        //post_run_script : "";
        //copied_files : ;
        details : <text> Used for cpto single_aes_enc_mode test!!</text>;
    }

    test single_aes_dec_deckey {
        //pre_run_script : "";
        run_script : "make -f $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/makefile run tc=cpto_sw_v200_tc002_aes_dec_deckey seed=0000 fsdb=off vbt=$ATTR(verbosity)";
        //post_run_script : "";
        //copied_files : ;
        details : <text> Used for cpto single_aes_dec_deckey_mode test!!</text>;
    }

    test single_aes_dec_enckey {
        //pre_run_script : "";
        run_script : "make -f $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/makefile run tc=cpto_sw_v200_tc003_aes_dec_enckey seed=0000 fsdb=off vbt=$ATTR(verbosity)";
        //post_run_script : "";
        //copied_files : ;
        details : <text> Used for cpto single_aes_dec_enckey_mode test!!</text>;
    }

    test single_aes_key_gen {
        //pre_run_script : "";
        run_script : "make -f $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/makefile run tc=cpto_sw_v200_tc004_aes_key_gen seed=0000 fsdb=off vbt=$ATTR(verbosity)";
        //post_run_script : "";
        //copied_files : ;
        details : <text> Used for cpto key_gen_mode test!!</text>;
    }
}

group cpto_sw_v200_ecb_mode {
    bundle_group : FALSE;
    repetitions : 1;
    count : 1;
    //sv_seed : 0000;
    gui_mode : "off";
    run_mode : "batch";
    //pre_group_script : ;
    //post_group_script : ;
    scan_script : "vm_scan.pl uvm.flt shell.flt ius.flt";
    dut_name : cpto_sw_v200 ;
    //sve_name : "*.sve" ;
    verbosity : "UVM_MEDIUM";
    code_coverage : "-covfile $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/cov_config.ccf";

    test ecb_enc {
        //pre_run_script : "";
        run_script : "make -f $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/makefile run tc=cpto_sw_v200_tc005_ecb_enc seed=0000 fsdb=off vbt=$ATTR(verbosity)";
        //post_run_script : "";
        //copied_files : ;
        details : <text> Used for cpto ecb_enc_mode test!!</text>;
    }

    test ecb_dec {
        //pre_run_script : "";
        run_script : "make -f $ENV(PROJ_SRC)/verification/bt/cpto_sw_v200/sim_xrun/makefile run tc=cpto_sw_v200_tc006_ecb_dec seed=0000 fsdb=off vbt=$ATTR(verbosity)";
        //post_run_script : "";
        //copied_files : ;
        details : <text> Used for cpto ecb_dec_mode test!!</text>;
    }
}

然后打开vmanager，在launch中载入刚刚编写的vsif文件：

回归开始执行：

在analysis中可以查看回归结果，在vsif中我们设置了一组session因此有一次回归，session下有2个group，分别对应两种不同的模式，group下有分别有4个、2个test，对应具体的测试用例，因此最终提交了6个回归：

选择对应的case还可以查看其log信息：

IC_SH
关注
  • 4
    点赞
  • 踩
  • 12
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
cadence vmanager（三）搭建vmanager server
weixin_63090979的博客
12-12 1507
cadence vmanager
cadence vmanager（七） vsif文件介绍
weiqi7777的博客
12-09 3760
vsif（verification session input format file），是vmanager启动一个session，必备的一个文件，该文件，指定了待运行的test。vmanager工具，会从该文件中，提取出test以及test的run命令，使用自带的runner去运行这些test的run命令，并且收集run的结果，最后集中显示。 vsif文件中，定义了如下的三个大的字段： se
cadence vmanager（四）vmanager软件使用介绍
weiqi7777的博客
11-26 7109
当建好一个vmanager server后，各个client就可以通过server的ip:端口号，连接server了。 连接server，有2种方式，一是普通用户模式，权限有限制，二是超级用户模式，权限没有限制。 一般情况下，超级用户模式，不运行回归，只是对server的工程进行配置，如用户的权限设置，工程的维护等。而普通用户模式，进行运行回归，数据查看。 我使用的vmanager工具的版本
cadence vmanager（五） vmanager启动方式
weiqi7777的博客
11-26 2570
vmanager提供了几种启动方式，使用以下命令，可以查看这几种方式。     vmanager –help 提供了4种启动方式： -gui：     启动图形化界面模式 -batch：     启动batch交互模式 -exec： 启动batch非交互模式，执行脚本 -ececdmd： 启动batch非交互模式，执行命令 一、-gui方式 这个是vmanag
Vmanager 工具回归测试用例
Sprite_Rat的博客
11-14 964
Vmanager 工具回归测试用例
vshiled manager使用手册
07-07
第一款安全产品是vShield Zones,它是vSphere初期发行版的一部分，提供了基本的虚拟网络安全。从那时起，VMware对vShield Zones进行了升级，增加了如下安全组件： vShield Manager，用于对vShield进行集中管理； vShield App，提供额外的虚拟网络安全； vShield Edge，对孤立的虚拟机提供安全和网关服务；以及 vShield Endpoint，对客户操作系统提供防病毒保护，只占用很少的资源。
cadence vmanager（二）vmanager工作模式
weiqi7777的博客
11-26 5871
一、vmanager的任务流程 vmanager的任务流程，如下图所示： 最开始，使用vplan建立验证计划，并且建立验证环境。 使用vmanager运行回归，之后分析faild的case，以及收集的metric，确定状态。 根据状态，判断，是否收敛，如果收敛，那么验证就结束了，可以signoff，如果验证没有收敛，那么就重新运行回归。 这里，就引出了vmanager的两大功能：
cadence vmanager(一) MDV介绍
weixin_42734227的博客
12-20 4290
内容大部分转载，自己添加了一些 cadence vmanager(一) MDV介绍 之前，无意之中，了解到这软件，开始学习，感受到这软件的强大，并且成功将该软件，用到了我们部门的flow中。因此，准备一系列的博文，来介绍下cadence的vmanager工具。强烈建议，做验证的团队，使用这个工具，并建立相应的flow。 在说，vmanager工具之前，首先要先介绍一下功能验证方法学。 一、功能...
cadence Project Manager
08-21
在使用cadence的Project Manager设计电路原理图时，有可能会遇到File下拉菜单中没有Edit Page/Symbols的情况，解决方法见word内。
cadence vmanager（八） vmanager生成文件说明
weiqi7777的博客
12-09 2102
vmanager在启动一个session之后，在生成很多文件，下面对这些文件，简要进行说明。 下图是vmanager文件层次结构： 顶层TOP-dir：是在vsif中，指定的session的顶层目录 chain_N：此次session，生成文件指定的位置，默认是chain_0，可以在启动vsif文件时，指定已存在的session，那么新的session产生的文件，就会生成在chain_
很实用的Cadence使用参考手册 共388页.pdf
07-26
很实用的Cadence使用参考手册 共388页，里面主要设计软件部分，会解析和IC设计的可以参考，做电路设计软件的也可以参考
Cadence17.4使用问题汇总
05-19
Cadence 17.4是一款广泛使用的电子设计自动化（EDA）工具，主要用于电路设计、布局布线等任务。以下是对标题和描述中提到的一些常见问题的详细解释： 1. **导入网表时的Long Name Size报错**：当网络名称长度超过...
Cadence原理图库设计指南.doc
12-02
《Cadence原理图库设计指南》是一份针对Cadence Allegro平台的新手入门教程，旨在指导用户如何有效地创建和管理自定义的原理图库。Cadence的Part Developer工具是进行库开发的核心，它支持用户构建包含元件符号、...
于争 博士 cadence视频教程
07-15
根据提供的文件信息，我们可以归纳出一系列与Cadence相关的知识点，特别是针对初学者所需掌握的核心概念和技术要点。以下是对这些知识点的详细阐述： ### Cadence基础知识 #### 1. Cadence概述 - **定义**：...
Cadence Virtuoso SPICE网表导入指南
01-12
本文档主要介绍在Cadence Virtuoso软件种将 SPICE网表导入指南
Cadence Sigrity Power DC 仿真操作流程
10-26
《Cadence Sigrity Power DC 仿真操作流程》是一本详细介绍如何使用Cadence Sigrity Power DC进行电源完整性分析的电子书。Sigrity PowerDC是Cadence公司的一款强大工具，专为解决高速数字设计中的电源完整性问题。...
cadence vmanager（十） vplan与vmanager结合使用的例子
weiqi7777的博客
12-09 4737
下面，用vplan与vmanager结合使用，来对一个验证环境，实现MDV的验证。 所验证的DUT，以及搭建的验证环境，是根据testbench.in网站上的systemverilog的demo来搭建的。demo的网站如下： http://www.testbench.in/SL_00_INDEX.html 本demo，是使用vmanager的本地模式，如果使用CS模式，去掉相应选项即可。
【System Verilog and UVM基础入门25】Cadence工具的使用
最新发布
TommiWei的博客
01-05 631
Vmanager使用第一讲
cadence vmanager（九） vplanner介绍
weiqi7777的博客
12-09 3217
验证计划，是整个验证的基础，这个会指导后面的验证过程。 cadence提供了vplanner工具，对验证计划的管理，并且还提供了，各个feature和环境中coverage，checker的对应。将来在vmanager中，可以可视化的看到，各个feature的验证情况以及进度。 一、vplanner软件的启动 vplan，也提供了sever-client的工作方式，如果只需要本地使用vpla
cadence sip设计指南
10-07
Cadence SIP设计指南是一个针对集成电路设计的规范和指导文件。SIP（System in Package）是一种集成了多个功能模块的封装技术，它通过在同一封装内集成不同功能模块，提高了系统的性能和密度。 Cadence SIP设计指南旨在帮助电路设计师在设计SIP模块时遵循一些最佳实践和规范。该指南涵盖了从布局、引脚分配、封装选择到电气特性和信号完整性等方面的设计要点。 首先，SIP设计指南强调了良好的封装布局。由于SIP封装内部有多个功能模块，及其相互之间需要进行良好的电磁屏蔽和隔离。在布局时，需要根据不同功能块之间的关系进行合理的组织和规划，以最小化干扰和信号完整性的问题。 其次，SIP设计指南提供了引脚分配的建议。由于将多个功能模块封装在同一SIP中，引脚数量相对较多。设计者需要根据各个功能模块的特性和通信需求，合理地分配引脚位置，以确保信号的可靠传输和相互之间的干扰最小化。 此外，SIP设计指南还涉及到封装选择的问题。设计者需要选择适合SIP模块的封装类型和尺寸，以保障整个SIP的性能和可靠性。该指南还介绍了不同类型封装（例如球栅阵列BGA和无铅封装等）的特点和适用范围。 最后，SIP设计指南还强调了电气特性和信号完整性的重要性。设计者需要关注信号传输的通道，如时钟信号的传输和功耗分配等。同时，需要采取一些电气仿真和分析工具来评估设备的特性，以确保系统在各种工作条件下的正常运行。 总而言之，Cadence SIP设计指南提供了一个详细而全面的指导框架，帮助电路设计师在设计SIP模块时遵循最佳实践和规范，以提高系统性能和可靠性。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值