[SV] 宏的使用，待总结 - bulaqi/IC-DV.github.io GitHub Wiki

• 单行宏：
  

• 多行宏： \ 连接多行，最后一行没有
  
  注意：在行尾的反斜杠“ \ ”之后不能有空格或字符，否则编译器会报错。

• 你和你的团队成员建立一个宏库。
• 为该库中的宏使用命名约定，例如 <*>_utils（print_byte_utils，等）。
• 将其放在一个名为macro_utils.sv的文件中，并将其include到base package中。
• 在适当的情况下使用这些宏，而不是重复代码，成为您的验证方法论的一部分。

• 宏名称
  宏名称的唯一规则是您可以使用除编译器指令以外的任何名称，即，define, ifdef, endif, else, elseif, include等关键字不能使用。

• 宏定义符号名称:反引号和引号 + 双反引号 + 反斜杠，反引号和双引号

  1. ` ” (Backtick and Quotes)反引号和引号
     

   `append_front_bad-接受一个参数MOD，期望宏将导致两个字符串MOD和".master"的连接。但是由于使用双引号，输出结果是字符串“MOD.master”，参数没有被替换。

   `append_front_good-这是`append_front_bad的正确版本。通过在双引号前使用反勾号，我们告诉编译器在宏被展开时必须替换参数MOD。

2. （Double Backtick）双反引号 本质上是分隔符标记，它帮助编译器清楚地区分宏文本中的参数和字符串的其余部分。
   我们可以看到ARG1 = 3用于形成变量的名称。（即m_mst_3和mst_3_lcl）

 几个例子综合理解` ”和``的作用。

append_front_2a and 2b-空格字符（' '）和句点字符（'.'）是自然标记定界符，即，编译器可以清楚地标识宏文本中的参数。
`append_front_2c_bad-如果参数附加了非空格或非句点字符，例如`"MOD_master`"中的下划线'_'，则编译器将无法确定参数字符串的MOD结尾。
在`append_front_2c_good中``创建一个在MOD和之间的定界符_master，这就是为什么MOD要正确标识和替换的原因。
`append_middle还有`append_end另外两个示例展示了这一点。
`append_front_3-可以``在自然标记定界符（即空格或句点）之前或之后放置一个，但这没有效果。// 个人表示怀疑，可以测试下

3. \" （Slashes, Ticks and Quotes）反斜杠，反引号和双引号
   

4. 其他
   - 您可以在宏中调用宏。 - 允许在宏中使用注释，这没有什么不同。 - fdef也允许在宏定义中使用，对此也没有什么不同

5. 传递Args
   注意事项:

    1.参数可以具有默认值。 \
    2.您可以通过将该位置保留为空来跳过参数，即使该位置没有默认值也是如此。请参阅``test2(,,)`示例2中显示的内容。  
    3.查看``debug1`并``debug2`。如果您的参数是一个字符串，则是否需要将参数括在双引号中的决定取决于该参数在宏文本中的替换位置。在中``debug1`，MODNAME在宏文本中的引号内，因此program-block在调用宏时我没有将字符串括在引号中。而``debug2`传递的参数是"program-block"因为MODNAME在宏文本中出现在引号之外。 \ 

6. 宏的风格指南
   - 如果使用宏定义a function或task使用大写宏名称和小写参数名称。 - 如果使用宏定义class，代码片段等等-使用小写宏名和大写参数名称。 - 宏名称中的单词用下划线分隔。

7. 语法总结
   - 整个团队遵循编码风格一致性。
   - 定义函数和任务的宏使用大写宏名称和小写宏参数。
   - 使用带下划线的单词。
   - 使用小写宏名称和大写其他所有参数定义例如类，代码段等宏。
   - 在使用宏时要谨慎，过度使用可能会使代码不可读。
   - 知道", ``和 \ 符号的作用。
   - 宏定义是全局的。在类中定义宏并不意味着它仅对该类可见。
   - 在编译log中当心宏重新定义警告。
   - 编写宏时，请使用本文中的示例作为参考\

如果设计验证工程师想要覆盖具有相同宽度的多个变量的walk0 / walk1库(bins)，则他/她可以为需要的walk1 / walk0覆盖库(bins)中的所有此类信号创建并使用宏。\

• 宏定义：
  
• 宏用法：
  

在验证项目中，很多时候需要在不同的地方编写相同的覆盖范围，例如，在主(master)组件和从属(slave)组件中编写相同的代码。我们可以为覆盖组(Covergroup)定义可以在所有此类组件中使用的通用宏
宏定义:

宏用法：

"STRING"是"bus_cg_macro"宏的参数。无论在何处使用宏，都应考虑"STRING"参数来替换覆盖组(Covergroup)、覆盖点(Coverpoints)及其库(bins)。

需要检查在主(master)和从(slave)中，如果不存在复位，则信号值在每个时钟周期都保持变化。我们可以定义一个宏并将其同时用于主(master)和从(slave)
宏定义：
宏用法：
\

在自检寄存器的写/读测试中，每次读取后，都会根据预期的读取数据检查读取值。考虑到设计的复杂性，我们可能有多个模块，并且对于每个模块，我们可能都有相应的寄存器测试。对于每个此类测试，我们都可以使用一个通用的宏进行自我检查
自检宏：
宏用法：

用于覆盖多个地方相同的程序块代码的宏。
程序块的宏：

宏用法：

https://blog.csdn.net/weixin_42905573/article/details/109006871