system_verilog display format
1. 简介
-
$display 和 $write的区别:
- $display系的系统函数：会在输出的末尾自动添加换行符(newline character);
- $write系的系统函数：光标会停留在输出的末尾，不会自动换行。
-
$display 和 $write相同之处:
- 按照参数列表的顺序输出参数；
- 参数可以是引号内的字符串(quoted string literal)，表达式(expression) 和数值(value)；
- 未指定输出格式的 string 和未压缩的 byte 数据类型，将按照字符串类型输出；
- 其他未指定输出格式的数据类类型是非法的。
- 未指定 转义字符 输出特殊字符和特殊格式时，$dispaly 和 $write 的输出类型默认为 string。
2. 转义字符 （Escape sequences）
转义字符可以分为以下三类：
- ’ \ ’ 表示其后跟随：文字或者不可打印字符(Literal or Nonprintable Character);
- ’ % ’ 表示其后跟随：格式规范，为后续参数指定格式(Format Specification);
- ’ %% ’ 表示其后跟随：%字符 (percent sign character).
2.1 转义字符 ‘\’
| Escaped Sequence | Character Produced by Escaped Sequence |
|---|---|
| \n | newline character -> 换行符 |
| \t | tab character -> 制表符 |
| \\ | \ character -> 反斜杠 |
| \" | “ character -> 引号 |
| \v | vertical tab -> 纵向制表符 |
| \f | form feed -> 换页符 |
| \a | Bell -> 响铃 |
| %% | % character -> 百分号 |
| \ddd | (1)三位八进制指定的字符，0 ≤ d ≤ 7； (2)字符少于3位，输出非八进制数字； (3)大于\377出错； |
| \xdd | 两位十六进制数字指定的字符，0 ≤ d ≤ F |
注意： system_verilog中仅包含以上几种类型的转义字符(IEEE Std 1800TM-2017)，未出现于上表中的其他类型将输出原来字符。如转义字符’ \b ‘的输出结果为‘ b ’。这与 c 语言中不同， c 语言中的 ‘ \b ’为退格，而SV中为字符’ b '.
转义字符 >> 输出示例：
2.2 格式说明符 ‘%’
| Argument | Description |
|---|---|
| %h or %H | hexadecimal -> 十六进制 |
| %d or %D | decimal -> 十进制 |
| %o or %O | octal -> 八进制 |
| %b or %B | binary->二进制 |
| %c or %C | ASCII -> ASCII码 |
| %l or %L | Library binding information -> 库索引 |
| %t or %T | time->时间 |
| %u or %U | unformatted 2 value data ->二值类型 |
| %z or %Z | unformatted 4 value data ->四值类型 |
| %v or %V | net signal strength -> 线网型信号强度 |
| %m or %M | hierarchical name -> 层次名 |
| %p or %P | assignment pattern -> |
| %s or %S | string -> 字符串 |
- ‘%h’ ~ ‘%z’ 将整形数据显示为对应格式，应用比较常见，此处不再赘述；
- ‘%l’ 可以显示既定module的library信息，如果某module例化自library0，例化名称为module1，那么最终的打印信息格式为“ library0.module1 ” ；
- ‘%t’ 根据不同module的时间精度（precision）和时间单元（unit）显示的格式可能不同；
- ‘%u’ ‘%z’ 常用于$fwrite函数，用于向文件写入数据；其中%u不区分’x’和’z’数据，并将其映射为’0’；%z严格区分x和’z’数据，将其分别映射为’x’，‘z’。
| Argument | Description |
|---|---|
| %e or %E | exponential -> 指数型 |
| %f or %F | decimal ->十进制 |
| %g or %G | exponential or decimal (shorter one) |
数字类型 >> 输出示例：
2.3 数据显示尺寸
- 对表达式参数而言，写入输出文件的尺寸是自动调整的。例如：12 bit的数据在以 ‘hex’ 格式输出的时候自动调整为3个字符长度，以 ‘decimal’ 格式输出的时候，自动调整为4个字符长度，因为参数输出的最大值为FFF（hexadecimal）和4095（decimal）。
- 默认设置：以十进制显示的数据格式，参数首部的 ‘0’（leading zeros）会被自动替换成空格（space）；对其他格式而言，leading zeros 正常显示；ps：如上图第一行打印信息。
- 可以在%和字母之间插入域宽(field width)，改写显示的格式。注意：域宽只能是非负十进制整型常亮（non-negative decimal integer constant) ;
- field width == 0 ： 以最小位宽显示，去除首部的空格和0；
- field width == others ：以others的值显示位宽，不去除首部的空格和0；
- argument width < others: 向左扩展，增加位宽至others；(arguments 值靠在右侧)
- argument width > others: 显示完整数据位宽（> others）；
- decimal & string 向左扩展时，补空格 ’ '(space)，其他格式，补充 ‘0’.
数字尺寸 >> 输出示例：
2.4 ‘x’ & ‘z’ 态数据显示
-
十进制 显示规则 (decimal specification)
- 全部 bits 为 ‘x’ 态 : 单个小写 ‘x’ (single lowercase x);
- 全部 bits 为 ‘z’ 态：单个小写 ‘z’ (single lowercase z);
- 部分 bits 为 ‘x’ 态：单个大写 ‘X’ (single uppercase X);
- 部分 bits 为 ‘z’ 态：单个大写 ‘Z’ (single uppercase Z);
- 部分 bits 为 ‘x’ 态 & 部分 bits 为 ‘z’ 态：单个大写 ‘X’ (single uppercase X); (x takes precedence over z)
-
十六进制/八进制 显示规则 (hexadecimal/octal specification)
- 每 4 bits 为一组，映射 hex 的一位；每 3 bits 为一组，映射 octal 的一位; (single digit)
- 某组内全部 bits 为 ‘x’ 态 : 单个小写 ‘x’ (single lowercase x);
- 某组内全部 bits 为 ‘z’ 态：单个小写 ‘z’ (single lowercase z);
- 某组内部分 bits 为 ‘x’ 态：单个大写 ‘X’ (single uppercase X);
- 某组内部分 bits 为 ‘z’ 态：单个大写 ‘Z’ (single uppercase Z);
- 某组内部分 bits 为 ‘x’ 态 & 部分 bits 为 ‘z’ 态：单个大写 ‘X’ (single uppercase X); (x takes precedence over z)
-
二进制 显示规则 (binary specification)
- each bit 分别显示为 ‘0’ ‘1’ ‘x’ ‘z’;
‘x’ & ‘z’ 态 >> 输出示例：
2.5 强度显示格式
- %v or %V 格式定义用于显示 标量线网型数据 的强度。
- 标量线网型数据显示为三个字符(3-character)，前两个表示强度(strength character)，第三个代表参数当前的逻辑值(current logic character)；
- 逻辑字符和强度字符的可选范围如表2.5.1 和表2.5.2所示：
Table 2.5.1 Logic value of scalar nets
| Arguments | Description |
|---|---|
| 0 | value 0 -> 逻辑0 |
| 1 | value 1 -> 逻辑1 |
| X | unknown value -> 不定值 ‘x’ |
| Z | high-impedance -> 高阻 ‘z’ |
| L | 0 or high-impedance -> 0 或 ‘z’ |
| H | 1 or high-impedance -> 1 或 ‘z’ |
Table 2.5.2 Strength of scalar nets
| Mnemonics | Strength name | Strength levels |
|---|---|---|
| Su | Supply drive | 7 |
| St | Strong drive | 6 |
| Pu | Pull drive | 5 |
| La | Large capacitor | 4 |
| We | weak drive | 3 |
| Me | Medium capacitor | 2 |
| Sm | Small capacitor | 1 |
| Hi | High-impedance | 0 |
表2.5.2中定义了 4 种驱动强度和 3 种电荷存储强度：驱动强度与 gate output 和 continuous assignment有关；电荷存储强度用于 trireg 类型 net. (see clause 28 gate-level and switch-level modeling)
那么逻辑字符和强度字符如何配合使用呢？
-
对逻辑 ‘0’ 和 ‘1’ :
- 信号强度为定值时，使用助记符(mnemonic)表示强度字符；
- 信号强度为区间时，使用两位10进制数字表示强度字符范围(strength level中的等级，0~7)；
-
对不定值’x’ :
- 信号强度和逻辑’0’ & '1’相同时，使用助记符(mnemonic)表示强度字符；
- 信号强度和逻辑’0’ & '1’相同时，使用两位10进制数字分别表示逻辑 ‘0’ 和 ‘1’ 的强度(strength level中的等级)；
-
对于高阻态’z’
- 只能采用 0 等级的Hi，表示高阻 ‘z’ 态的信号强度；
-
对于 L 和 H：
- 只能使用助记符(mnemonic)表示信号强度；
信号强度 >> 输出示例：
2.6 层次名格式 (Hierarchical name)
- %m or %M 不接受参数输入。 相反，它使设计元素，子例程，命名块或标记语句的层次结构名称，该语句调用包含格式说明符的系统任务。 当某模块的许多实例调用系统任务时，%m可以指示具体哪个实例调用次任务。
2.7 Assignment pattern format
- ％p or %P 格式说明符可用于打印聚合表达式，例如解压缩结构，数组和联合(unpacked structure,array,unions).
- 对于解压缩的数据结构，遍历搜索该结构并打印找到的单值数据类型(single data type)，单值类型数据的输出需要遵循以下要求：
- 枚举类型：显示枚举类型的name (其值在enum类型的有效范围内)，否则显示value；
- 字符串：显示为双引号内的字符串形式(quoted string);
- 各种句柄：显示默认格式名字，如果为空句柄显示 null；
- 其他格式：按照未定义的默认格式显示。
- %0p 格式说明符使得unpacked structure,array,unions可以以更短的形式显示打印；
- %p 和 %0p 也可以用于打印单值表达式，此时显示结果和上述的几种显示格式相同。
Assignment pattern format >> 输出格式：
2.8 字符串格式
- ％s or %S 格式说明符用于将ASCII代码以字符样式打印。
- 对于出现在字符串中的每个％s，相应的参数应遵循参数列表中的字符串定义。
- 相关参数被映射为一个8位十六进制ASCII码序列，每8位代表一个字符。
- 如果参数是变量，则其值是右对齐的，以便该值的最右边的位是字符串中最后一个字符的LSB。
- 字符串末尾不需要终止字符或值，并且永远不会打印前导零(leading zeros)。
- 打印字符串时，一般使用%s即可满足要求，可以打印出全部字符。
>> IEEE Standard for SystemVerilog - Unified Hardware Design, Specification and Verification Language, 1800TM-2017
>> clause 21 Input/output system tasks and system functions
转载请注明出处！