【Verilog】WaveDrom 时序图实战:从语法到高级配置

Wavedrom-时序图神器 WaveDrom是基于WaveDrom引擎和WaveJSON格式的数字时序图的实时编辑器,拥有独立的安装包以及vscode插件。WaveDrom是一款Javascript应用程序,它可以用来描述数字时序图,通过自己编写描述的语言实时生成时序图。 阅读详情

1. 为什么Verilog开发者需要WaveDrom?

如果你写过Verilog,肯定有过这样的经历:费了老大劲写完一段状态机或者总线协议,想跟同事或者导师解释清楚时序关系,结果发现“只可意会,不可言传”。用文字描述?“在第三个时钟上升沿后,当ready信号拉高且valid信号为1时,数据被锁存”。画图?打开Visio或者Draw.io,一个个矩形去拖拽、对齐、画箭头,一个简单的时序图可能就得折腾半小时,一旦需要修改,更是牵一发而动全身,简直让人抓狂。

我刚开始做FPGA项目时,就深受其苦。直到我发现了WaveDrom,感觉像是打开了一扇新世界的大门。它不是什么复杂的图形软件,而是一个基于JSON的文本描述语言。你只需要用简单的代码描述出时钟、信号的高低变化,它就能自动生成清晰、专业的交互式时序图。对于Verilog开发者来说,这简直是量身定做的神器。你想啊,我们整天和代码、信号打交道,用写代码的方式画图,再自然不过了。修改起来也极其方便,改几行“波形代码”,图片就自动更新了,这和我们写RTL代码、看仿真波形的逻辑是完全一致的。

更重要的是,WaveDrom生成的图可以直接嵌入网页,是交互式的。你可以用鼠标悬停查看数据值,缩放观察细节,这对于设计文档、技术博客或者项目汇报来说,体验提升不是一星半点。它能把枯燥的时序说明,变成一目了然的动态图表。接下来,我就带你从最基础的语法开始,一步步玩转WaveDrom,画出那些能让你的设计文档闪闪发光的专业时序图。

2. 5分钟上手:你的第一个WaveDrom时序图

别被“JSON”、“配置”这些词吓到,WaveDrom的核心语法简单到超乎想象。我们从一个最基础的例子开始,你甚至不需要安装任何软件。

2.1 在线编辑器的魔力

最快捷的方式是直接访问WaveDrom的官方在线编辑器。打开浏览器,输入WaveDrom Editor的网址,你就能看到一个左右分屏的界面。左边是代码编辑区,右边是实时渲染的波形图。这种“所见即所得”的方式,对于学习语法来说再友好不过了。我强烈建议你边读边动手,把下面的例子敲进去,立刻就能看到效果。

2.2 理解核心结构:信号(Signal)与波形(Wave)

所有WaveDrom图都围绕一个核心的JSON对象构建。最基本的结构长这样:

{ signal: [
  { name: ‘clk‘, wave: ‘P...‘ },
  { name: ‘data‘, wave: ‘01.0‘ }
]}

我来拆解一下:

  • signal:这是一个数组,里面包含了你要画的所有信号线。
  • name:信号的名字,比如 clk, rst_n, data_valid,会显示在波形图的左侧。
  • wave:这是灵魂所在!它是一个字符串,里面的每一个字符都代表信号在一个时间单元(你可以暂时理解为一个基础时钟周期)的状态。

那么,字符代表什么意思呢?记住这几个最常用的就够应付80%的场景了:

  • 0: 低电平
  • 1: 高电平
  • x: 不定态(高阻或冲突,常用红色表示)
  • z: 高阻态
  • .: 保持上一个状态。这个点非常实用,比如你想画一个持续了3个周期的高电平,不用写 111,写 1.. 就行了,更简洁。
  • p, P, n, N: 专门用于画时钟。p/n 画的是小写的时钟波形(先低后高/先高后低),P/N 画的是大写的时钟波形(带上升沿和下降沿的标识线),通常我们用 P 和 N 更多。

现在,把上面的代码贴到在线编辑器里,你会立刻看到一个简单的时钟信号 clk 和一个数据信号 data 的波形。是不是很简单?你已经掌握了最核心的语法。

2.3 添加数据标签(Data)

在数字电路中,总线上的数据值往往比电平本身更重要。WaveDrom可以很方便地为信号的特定周期标注数据值。这就要用到 data 属性。

看这个例子,它描述了一个简单的总线写操作:

{ signal: [
  { name: “clk“, wave: “P.....“ },
  { name: “cmd“, wave: “01.0..“, data: [“IDLE“, “WRITE“, “IDLE“] },
  { name: “addr“, wave: “x===x“, data: [“0x1000“, “0x1004“, “0x1008“] },
  { name: “wdata“, wave: “x===x“, data: [“0xDEAD“, “0xBEEF“, “0xCAFE“] }
]}

在这里,wave 字符串中的 = 字符表示“数据周期”,它通常显示为一个被框起来的区域。data 数组中的字符串会按顺序显示在这些数据周期对应的波形上方。这样,地址总线和数据总线的变化就一目了然了。这种表达方式在描述内存访问、总线传输协议(如 AXI、APB)时极其有用。

3. 进阶技巧:让时序图更清晰、更专业

掌握了基本语法后,你可能会觉得画出来的图有点“简陋”。别急,WaveDrom提供了一系列配置项,能让你的时序图变得和教科书里一样专业。

3.1 组织信号:分组(Groups)与留白

当一个接口信号很多时(比如一个完整的AXI总线),把所有信号平铺开来会显得很乱。这时可以使用分组功能。分组用数组 [] 来实现,可以把相关的信号组织在一起,并给这个组起个名字。

{ signal: [
  { name: ‘sys_clk‘, wave: ‘P..P..P‘ },
  [ “AXI Write Channel“,
    [ “Control“,
      { name: ‘AWVALID‘, wave: ‘01....0‘ },
      { name: ‘AWREADY‘, wave: ‘0.1..0.‘ }
    ],
    { name: ‘AWADDR‘, wave: ‘x===.x.‘, data: [‘ADDR1‘, ‘ADDR2‘] }
  ],
  {},
  [ “AXI Read Channel“,
    { name: ‘ARVALID‘, wave: ‘0...10.‘ },
    { name: ‘ARREADY‘, wave: ‘0..1.0.‘ }
  ]
]}

注意上面代码中的 [ “AXI Write Channel“, ... ] 就是一个分组,它还可以嵌套子分组(如 [ “Control“, ... ])。{} 表示一个空行,可以用来分隔不同的逻辑模块,让图纸的排版更有呼吸感,逻辑层次也更清晰。

3.2 控制时间尺度:周期(Period)与相位(Phase)

有时候,不同信号的时钟周期可能不同,或者存在相位差。WaveDrom的 period 和 phase 属性就是用来处理这种情况的。

  • period: 定义该信号一个“波”字符占用的时间单位数。默认是1。如果设置 period: 2,那么这个信号的一个周期(比如一个 P)就会占据两个标准时间单位的宽度。这常用于表示频率较低的时钟或使能信号。
  • phase: 定义信号的相位偏移。正数表示向左移动(超前),负数表示向右移动(滞后)。取值可以是小数,比如 0.5 表示偏移半个时间单位。

看一个DDR内存命令的模拟例子:

{ signal: [
  { name: “CK“, wave: “P“, period: 2 },
  { name: “CMD“, wave: “x=..=..=..“, data: [“ACT“, “NOP“, “RD“, “NOP“], phase: -0.25 },
  { name: “ADDR“, wave: “x===.....“, data: [“ROW“, “COL“], phase: -0.25 }
]}

这里,CK 时钟的周期被拉长了,而 CMD 和 ADDR 信号相对于时钟有一个轻微的右移(phase: -0.25),这非常真实地反映了实际电路中命令/地址总线相对于时钟沿的建立时间关系。

3.3 全局美化:皮肤(Skins)与缩放(Hscale)

图纸的样式也可以定制。这主要通过顶层的 config 对象来实现。

  • hscale: 水平缩放因子。默认是1。当你信号周期很多,图太挤的时候,可以设置 hscale: 2 让图变宽,更易读。反之,如果图太稀疏,可以设置小于1的值来压缩。
  • skin: 切换主题皮肤。除了默认的 default,还有 dark(深色背景)、lowkey(低调线条)和 narrow(窄间距)等可选。在制作演示文稿时,根据背景色选择一个合适的皮肤,视觉效果会更好。
{
  signal: [
    { name: “clk“, wave: “p....P....“ },
    { name: “data“, wave: “x===x===x“, data: [“A“, “B“, “C“] }
  ],
  config: { hscale: 2, skin: “dark“ }
}

试试这段代码,你会得到一个更宽敞、深色背景的波形图,非常适合在暗色主题的PPT中使用。

4. 高级实战:标注与交互

到了这里,你已经能画出很专业的静态时序图了。但WaveDrom还能做得更多——它可以添加丰富的标注,让图纸自己“说话”,解释关键的时间关系。

4.1 添加箭头与标注(Arrows and Edges)

这是WaveDrom非常强大的一个功能,用于显示信号之间的因果关系或时间约束。实现分为两步:

  1. 标记节点(Node): 在信号的 wave 字符串中,用 . 来表示一个普通的电平周期,但如果你在某个字符的位置用一个小写字母(如 a, b)替换了 .,那就表示你在这个时间点标记了一个“节点”。
  2. 连接边(Edge): 在JSON的 edge 数组里,描述这些节点之间的连接关系。
{
  signal: [
    { name: ‘clk‘, wave: ‘P....P..‘, node: ‘...a...b‘ },
    { name: ‘req‘, wave: ‘01....0.‘, node: ‘..c....d‘ },
    { name: ‘ack‘, wave: ‘0...1..0‘, node: ‘....e..f‘ }
  ],
  edge: [
    ‘a~c 触发‘,
    ‘c~e 等待‘,
    ‘e~b 响应‘,
    ‘b~d 完成‘,
    ‘d~f 结束‘
  ]
}

在上面的例子中,我们在 clk 的上升沿标记了 a 和 b,在 req 的上升沿和下降沿标记了 c 和 d,在 ack 的上升沿和下降沿标记了 e 和 f。然后在 edge 里,我们用 a~c 表示从节点 a 到节点 c 画一条带箭头的曲线,并标注文字“触发”。~ 表示画曲线,你也可以用 - 画直线,用 ~> 或 -> 画带箭头的线。通过这种方式,可以清晰地展示出“时钟上升沿触发请求,请求拉高后等待应答,应答在下一个时钟上升沿前返回”这样的完整时序逻辑。

4.2 添加图标题与时间轴(Head/Foot)

一份正式的文档,图表应该有标题和编号。WaveDrom的 head 和 foot 属性就是干这个的。

{
  signal: [
    { name: ‘clk‘, wave: ‘P..P..P‘ },
    { name: ‘data‘, wave: ‘x=..=..x‘, data: [‘D0‘, ‘D1‘] }
  ],
  head: {
    text: ‘图1: 突发数据传输时序‘,
    tick: 0,
    every: 2
  },
  foot: {
    text: ‘时钟周期‘,
    tock: 1,
    every: 2
  }
}
  • head: 定义图表顶部的区域。text 是标题。tick: 0 表示在时间轴0的位置上方(head区)画一个刻度标签。every: 2 表示每2个时间单元画一个标签。这样就会在0, 2, 4...的位置显示“0”, “2”, “4”...
  • foot: 定义图表底部的区域。tock: 1 表示在时间轴0和1之间(foot区)画一个刻度标签。结合 every: 2,会在1, 3, 5...的位置显示“1”, “3”, “5”...。foot 的 text 可以作为图的脚注或说明。

这个功能让生成的波形图完全可以达到出版级的标注水准。

5. 融入工作流:从代码到文档

画好了漂亮的时序图,最后一步就是把它用起来。WaveDrom的集成非常灵活。

保存与导出: 在线编辑器的左下角有保存按钮。你可以将图纸保存为 .svg 或 .png 格式的图片,插入到Word、PPT或PDF文档中。SVG是矢量格式,无限放大都不会模糊,是首选。

本地使用: 如果你更喜欢离线环境,或者想集成到脚本中自动生成文档,可以安装WaveDrom的命令行工具或Node.js包。这样你就可以在本地编辑一个 .js 或 .json 文件,然后用命令一键生成图片。对于需要频繁更新图纸的大型项目,这能节省大量时间。

与Markdown/文档工具结合: 由于WaveDrom代码本身就是一段JSON/JavaScript,它可以被很多文档工具直接解析。例如,在一些支持Mermaid的Markdown编辑器中,也有插件支持直接渲染WaveDrom代码块。更常见的做法是,将WaveDrom代码块放在HTML页面中,并引入WaveDrom的JS库,这样在网页里就能直接显示交互式波形。我在自己的项目文档和技术博客中就一直这么做,读者可以直接与波形图互动,体验非常好。

说到底,WaveDrom不仅仅是一个画图工具,它更是一种思维方式的延伸。它要求你像写代码一样严谨地描述时序,这个过程本身就能帮你理清设计中的模糊点。下次当你需要解释一个Verilog模块的接口时序时,别再费力用文字描述了,直接写一段WaveDrom代码吧,你会发现沟通效率成倍提升。

WaveDrom:开源时序图绘图插件 WaveDrom是一种用于描述时序图的开源工具和语言。它可以帮助用户以一种简单直观的方式来描述数字信号的时序行为,例如时钟、数据、使能信号等。WaveDrom通常用于硬件描述、数字电路设计、通信协议分析等领域。WaveDrom提供了一种基于JSON格式的描述语言,通过在JSON中定义时序波形的各个方面(如信号名称、波形类型、时序关系等),用户可以生成清晰、易读的时序图形。在WaveDrom中,用户可以描述波形的高低电平、信号的变化时刻、时钟周期等信息,以及信号之间的相对时间关系。 阅读详情

相关推荐

VScode中使用WaveDrom插件画时序图(波形图)

目录WaveDrom插件介绍WaveDrom的基本使用WaveDrom的进阶使用Reference WaveDrom插件介绍 在VScode应用商店中搜索Waveform Render,这个就相当于WaveDrom了: 左边键入代码,右边会自动生成时序图,非常好用: WaveDrom的基本使用 先看看实例代码: {signal: [ {name: 'clk', wave: 'p.....|...'}, {name: 'dat', wave: 'x.345x|=.x', data: ['head'

小火子的博客 2万+

Verilog:【7】超详细WaveDrom教程,时序图绘制利器,看这一篇就够了。

超详细WaveDrom教程,时序图绘制利器,看这一篇就够了。

Alex的技术博客 3万+

别再手动画波形了!用WaveDrom+Verilog快速生成专业时序图(附在线编辑器链接)

本文介绍了如何利用WaveDrom与Verilog结合,实现数字电路时序图的自动化生成,大幅提升硬件工程师的工作效率。通过代码化时序描述和智能转换技巧,解决了传统手动绘图效率低、修改成本高的问题,并提供了团队协作和性能优化的实用方案。

weixin_42651748的博客 245

开源波形图绘制工具WaveDromGen

WaveDromGen使用python3编写,是一款功能强大的开源波形绘制工具,可以用于绘制数字电路的各种波形。该工具提供了一种简单易用的语言来生成各种波形,使得用户可以轻松地创建自己所需要的波形。WaveDromGen不仅易于使用,而且完全免费,是非常实用的工具。

soc小白成长 4531

从波形草图到专业图表:手把手教你用WaveDrom的config和skin美化Verilog时序图

本文详细介绍了如何使用WaveDrom的config和skin功能优化Verilog时序图的美观性和专业性。通过布局优化(hscale参数调整)、主题定制(skin系统)和标注系统(head/foot文本标注)三大技巧,帮助工程师将基础波形转化为出版级质量的图表,提升技术文档的视觉效果和沟通效率。

weixin_30902251的博客 187

VSCode搭配WaveDrom插件:5分钟搞定专业时序图绘制(附常用符号速查表)

本文详细介绍了如何利用VSCode搭配WaveDrom插件快速绘制专业时序图,涵盖从基础配置到高级应用的完整指南。通过简洁的文本描述生成精确波形图,特别适合电子工程师在数字电路设计中高效表达时序逻辑,并附有常用符号速查表和实战案例。

weixin_27791839的博客 227

【Verilog】WaveDrom 的使用

WaveDrom 是一个很好用的画时序图的软件

Tranquil_ovo的博客 3236

别再截图了!用WaveDrom画Verilog时序图,一键导出SVG/PNG的保姆级指南

本文详细介绍了如何使用WaveDrom工具高效绘制Verilog时序图,并一键导出SVG/PNG格式。通过代码化绘图、版本控制和矢量输出等功能,WaveDrom解决了传统时序图绘制的精度不足、修改困难和格式局限等问题,大幅提升数字电路设计效率。

weixin_28683689的博客 115

如何快速掌握WaveDrom:硬件设计与Verilog时序验证的终极指南

WaveDrom是一款强大的数字时序图编辑器,专为硬件设计工程师和Verilog开发者打造。这个开源工具能够帮助你轻松创建专业的时序图,特别适合RTL(寄存器传输级)设计和时序验证。在前100个字的介绍中,我们明确了WaveDrom的核心功能:它是一个基于WaveJSON格式的实时时序图编辑器,能够直接在浏览器中渲染数字时序图,是硬件设计验证的得力助手。 ## 🔧 WaveDrom在硬件设计中

gitblog_00853的博客 649

别再纠结了!TimeGen vs WaveDrom 深度对比:硬件工程师和软件开发者到底该选谁?

本文深度对比了TimeGen和WaveDrom两大时序图工具,帮助硬件工程师和软件开发者根据工程需求做出最佳选择。TimeGen在硬件设计领域表现出色,提供精确的时序控制和Verilog代码生成能力,而WaveDrom则以轻量便捷和跨平台特性著称,适合文档编写和协作。文章还提供了混合使用策略和未来趋势分析,助力工程师提升工作效率。

weixin_30463341的博客 397

VS Code硬件设计插件全攻略:从语法高亮到Testbench生成,提升开发效率的10个技巧

本文详细介绍了如何利用VS Code插件生态打造高效的硬件设计工作流。通过配置Verilog-HDL插件实现语法高亮、实时语法检查与代码导航,并重点演示了模块自动例化和Testbench一键生成等核心技巧,结合代码对齐、自定义片段及波形可视化工具,全面提升Verilog/SystemVerilog开发效率。

weixin_27734811的博客 598

继续试用 Verilog Generator Skill:这次让它生成了一套 AXI-Stream UART

UART 算法本身并不复杂,但一旦把 AXI-Stream、背压、FIFO、参数化波特率、奇偶校验、停止位和接收错误都放进来,就不再是“写一个状态机”这么简单了。这也是我现在对这类 Skill 的看法:它已经很适合用来搭建一份结构完整、方便 review 的 RTL 初版,但最终是否正确,还是要靠 testbench、仿真、综合和人工检查说话。它当然还不能代替完整的 FPGA 开发流程,但作为 RTL 设计的起点,已经比直接让模型“吐代码”更容易控制,也更方便后续接入真实 EDA 工具。

qq_37510379的博客 383

硬件工程师画时序图,别再手画了!TimeGen 3.2保姆级教程,从安装到导出BMP文件

本文详细介绍了TimeGen 3.2时序图绘制工具的全流程使用指南,从安装配置到高级功能应用,帮助硬件工程师提升绘图效率。通过智能对齐信号、自动生成波形等专业功能,TimeGen 3.2可将原本耗时半天的绘图工作缩短至10分钟,是数字电路设计的必备工具。

weixin_30855099的博客 552

VSCode搭Verilog开发环境:5款插件+仿真配置+避坑指南

硬件描述语言开发长期依赖厂商IDE,编辑器体验与工具链绑定问题让Verilog开发者效率受限。以VSCode为核心的现代编辑器配合语言服务器、仿真器与波形工具,正成为FPGA和数字IC设计的主流工作流。本文从编辑器与工具链分层原理出发,介绍基于VSCode搭建Verilog开发环境的完整方法,涵盖语法高亮、跳转、语义检查、testbench自动生成、波形查看等关键环节。通过插件与外部工具的组合,开发者能够在代码编写阶段拦截低级错误,在仿真阶段快速定位问题,在文档阶段输出规范时序图。无论是高校课设、FPGA入

weixin_31815843的博客 245

告别Vivado原生编辑器:VS Code硬件开发环境搭建与插件配置指南(含避坑提示)

本文详细介绍了如何为硬件开发者搭建高效的VS Code开发环境,涵盖语法高亮、语法检查、自动例化和Testbench生成等核心功能配置。通过优化工作流和插件集成,显著提升FPGA/ASIC设计效率,解决传统EDA工具编辑器响应慢、功能单一等问题。

weixin_28836875的博客 378

移位寄存器分频原理与Verilog实现:从偶数到奇数分频

时钟分频是数字逻辑电路设计中的基础操作,广泛存在于FPGA开发、串行通信和时钟管理系统中。移位寄存器凭借其天然的延迟特性,成为实现分频功能的经典方案——每一级寄存器输出相对输入滞后一个时钟周期,通过反馈逻辑即可构建输出频率为输入整数分之一的分频器。偶数分频结构简单,而奇数分频若要保证50%占空比,则需借助双沿采样与相或合成等技巧。理解移位寄存器分频的核心原理,不仅有助于掌握时序电路设计本质,也为实际工程中的波特率生成、多相时钟产生和可编程分频器设计提供可靠思路。本文结合Verilog代码与Wavedrom时

weixin_31534091的博客 312

5款高效在线工具:从公式识别到时序图绘制的一站式解决方案

本文推荐5款高效在线工具,涵盖公式识别、编辑、时序图绘制等场景,解决科研与工程中的常见需求。重点介绍Mathpix Snip的LaTeX转换、draw.io的Visio替代方案以及WaveDrom的时序图绘制功能,这些工具均支持云端协作与多格式导出,显著提升工作效率。

weixin_33719619的博客 438

TensorFlow GPU版本安装步骤-Windows系统

本文由在Windows下安装TensorFlow GPU版本教程-优快云等整理得到。 目录 1、确认显卡是否支持CUDA 1.1 查看显卡信息 打开“设备管理器”,查看显卡信息,如下图所示: 由上图知,本电脑的显卡为NVIDIA Quadro P400. 1.2 查看支持CUDA的显卡 网址:https://developer.nvidia.com/cuda-gpus 经查询可知,该显卡支持CUDA,如下图所示: 2、安装CUDA 2.1 下载CUDA 网址:https://developer.nvi

x_lingyun的专栏 766
上一篇: WebRTC音频传输全流程解析:从采集到播放的实时通信实践
下一篇: 软件设计师考试必看:操作系统进程管理的5个高频考点解析(附PV操作实战)
普通网友
博客等级 码龄27年 205粉丝 1502原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明:

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

余额充值