零基础也能轻松上手用 WaveDrom 快速绘制专业数字时序图【免费下载链接】wavedrom.github.ioDigital timing diagram editor项目地址: https://gitcode.com/gh_mirrors/wa/wavedrom.github.io你肯定遇到过这种时刻好不容易调试通了接口想把时钟、读信号、数据总线的配合关系讲给同事听结果打开画图软件拖了半小时方框和箭头成品还是歪歪扭扭。或者你刚写完一段 RTL 代码想在文档里配一张像样的数字时序图却发现手头连个趁手的工具都没有。WaveDrom 就是为这个场景而生的——它是一个开源的时序图编辑器用几行 JSON 就能生成专业、清晰的数字时序图还能直接导出为矢量图。接下来我会带你从一次真实的汇报出发把 WaveDrom 的核心用法完整走一遍。先认清你的画布左侧写代码右侧看效果不用安装任何东西打开项目里的 editor.html 就能进入编辑器。第一眼的印象很朴素页面没有花哨的工具栏就是左右两栏——左边是代码编辑区右边是预览区。你每敲下一个字符右边的波形图就实时刷新一次。这个改一行、看一版的体验正是它效率高的根源传统画图工具是画一笔、调一点而 WaveDrom 是写代码、出图改个字符就能整体重排。接下来我们就用它解决实际问题。五步画出你的第一张时序图给同事讲清一次 SPI 读取假设你现在要讲的是主机拉低片选发出读命令从机在下一个时钟沿把数据送上总线。抛开一切术语我们只需五步。第一步把时钟摆上去时序图的地基是时钟。在左侧输入{ signal: [ { name: clk, wave: p...... } ]}右侧立刻出现一条方波。这里的wave是整张图的核心它是一串字符每个字符代表一个时间周期。p表示这一周期内有一次上升沿的时钟0是低电平、1是高电平、.表示维持上一个状态。所以p......就是一个时钟沿后面平铺六个周期。第二步加上片选和数据线光有时钟说明不了问题把片选和读命令加进来{ signal: [ { name: clk, wave: p...... }, { name: cs, wave: 10....0 }, { name: sdi, wave: x..x.., data: [CMD] } ]}留意sdi这行x表示未知/未定义表示总线上有稳定数据而data数组负责给这段波形贴上文字标签。于是 CMD 字样就稳稳地落在了那个的周期里。数据总线、地址总线、读写使能全是这么贴上去的。第三步让信号按你的节奏对齐实际协议里从机的应答信号往往滞后半个周期。给那根线加上phase: 0.5它就会整体错开半个时钟周期与真实时序严丝合缝。同理period: 2可以让一根线每两个周期才跳变一次模拟分频时钟。这两个参数是让波形图像真的的关键。第四步用分组和标题讲清故事零散摆着几根线读者很难看出谁属于谁。把相关信号包进一个带名字的数组就形成了分组{ signal: [ { name: clk, wave: p..Pp..P }, [Master, { name: cs, wave: 10....0 }, { name: sdi, wave: x..x.., data: [CMD] } ], {}, [Slave, { name: sdo, wave: x....x, data: [DATA] } ] ]}图里会出现Master和Slave两个框把主从两侧的交互一目了然地框出来。空对象{}则负责在两组信号之间留出视觉间隔。再加上一个head字段还能在图上加一行标题head: { text: SPI Read Transaction, tick: 0 }第五步导出收工菜单里点几下就能把成果存成 JSON 源文件、SVG 矢量图或 PNG 位图直接粘进文档和演示文稿。到这里你的第一张数字时序图已经完成用时不超过三分钟。进阶三招让同事以为你用了专业绘图软件基础玩法已经上手下面这三招才是 WaveDrom 拉开差距的地方。第一招用箭头画出因果链时序图最怕只画状态、不讲原因。WaveDrom 支持在波形上标记节点再用箭头把因果连起来{ signal: [ { name: A, wave: 01..0.., node: .a..e.. }, { name: B, wave: 0.1..0., node: ..b..d. } ], edge: [ a-b setup, b-|e hold ] }node字符串里的字母对应每个时间点的锚点edge数组则描述锚点之间怎么连线。-是直线箭头~是曲线-|是带T形头的建立时间标注。协议文档里最经典的 setup/hold 时间图用这个功能几行就能画出来。第二招一键切换整体观感同样一张图套不同的皮肤能适配完全不同的文档风格。项目 skins/ 目录下就有现成的皮肤在 JSON 里加一行即可切换config: { skin: narrow, hscale: 2 }narrow是紧凑布局适合页面空间紧张的地方hscale控制横向缩放波形太密看不清时调大它比任何拉伸截图都干净。想自定义配色照抄 skins/default.js 的写法改一版即可。第三招让数据自己跑进图里如果波形规律性很强比如格雷码计数器WaveDrom 甚至允许你在 JSON 里写一小段 JavaScript 动态生成波形。官方 tutorial.html 里就有一个用循环生成 5 位格雷码的例子。这意味着时序图可以和你的算法保持同源改参数即改图彻底告别手工数格子。避坑指南新手最常见的四个坎波形长度对不齐。同一张图里所有信号的wave字符串长度应当一致否则某些信号会提前结束看起来参差不齐。数清楚字符数或用.补齐到同一长度。逗号与引号翻车。WaveJSON 是严格的 JSON字段名必须用双引号数组元素之间必须逗号分隔最后一个元素后面不能有多余逗号。报错时先看是不是多了或少了逗号。忘记键位但找不到快捷键。编辑器里 CtrlS 是保存、CtrlO 是打开这是写死在 editor.html 里的习惯用快捷键的人可以先记住这两个。导出的图尺寸不对。PNG 导出的是当前预览区的渲染结果若嫌模糊先用config.hscale把图放大再导出而不是事后去拉伸图片。现在打开编辑器动手画一张看完这篇你缺的不是更多知识而是动手按几次键盘。把上面那个 SPI 例子敲进去改改波形字符、换换皮肤、加两条箭头手感立刻就有了。想系统看全所有符号和参数的含义翻一遍项目里的 tutorial.html 就能按步骤把每个特性过一遍需要离线使用把仓库 clone 到本地git clone https://gitcode.com/gh_mirrors/wa/wavedrom.github.io直接双击 editor.html 即可。三分钟一张图从今天起你的文档里不会再出现歪歪扭扭的手画时序图了。【免费下载链接】wavedrom.github.ioDigital timing diagram editor项目地址: https://gitcode.com/gh_mirrors/wa/wavedrom.github.io创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考