波形可视化新选择：WaveDromPy-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01129/article/details/147629260

波形可视化新选择：WaveDromPy

wavedrompy WaveDrom compatible python command line 项目地址: https://gitcode.com/gh_mirrors/wa/wavedrompy

在软件开发与文档编写过程中，我们经常需要可视化地展示时序图、逻辑电路和寄存器位场等信息。WaveDromPy 正是一个能够满足这些需求的强大工具。

项目介绍

WaveDromPy 是一个完全兼容 WaveDrom 的 Python 模块和命令行工具。WaveDrom 是一个原本用 JavaScript 实现的工具，可以用来生成波形图。如果你想在 Python 环境中生成波形图，或者不想为了使用 WaveDrom 而安装 Node.js 环境，WaveDromPy 就是一个理想的解决方案。

项目技术分析

WaveDromPy 实际上是将 WaveDrom 的 JavaScript 文件 WaveDrom.js 直接翻译成了 Python 代码，没有添加任何额外功能。其目标是实现完全兼容。这款工具能够直接将 WaveDrom 兼容的 JSON 文件转换为 SVG 格式。

项目及技术应用场景

时序图渲染

WaveDromPy 可以用来生成时序图，这在解释硬件与软件交互时特别有用。例如，在生成内存访问的时序图时，可以清晰地展示地址和控制信号的波形变化。

import wavedrom
svg = wavedrom.render("""
{ "signal": [
 { "name": "CK",   "wave": "P.......",                                              "period": 2  },
 { "name": "CMD",  "wave": "x.3x=x4x=x=x=x=x", "data": "RAS NOP CAS NOP NOP NOP NOP", "phase": 0.5 },
 { "name": "ADDR", "wave": "x.=x..=x........", "data": "ROW COL",                     "phase": 0.5 },
 { "name": "DQS",  "wave": "z.......0.1010z." },
 { "name": "DQ",   "wave": "z.........5555z.", "data": "D0 D1 D2 D3" }
]}""")
svg.saveas("demo1.svg")

示例 1

逻辑电路图绘制

此外，WaveDromPy 还能绘制逻辑电路图，这对于在教学或文档中展示逻辑运算的实现非常方便。

import wavedrom
svg = wavedrom.render("""
{ "assign":[
  ["out",
    ["|",
      ["&", ["~", "a"], "b"],
      ["&", ["~", "b"], "a"]
    ]
  ]
}""")
svg.saveas("demo2.svg")

示例 2

寄存器位场表示

WaveDromPy 也能够绘制寄存器的位场，这在描述硬件寄存器配置时非常有用。

import wavedrom
svg = wavedrom.render("""
{"reg": [
  { "name": "IPO",   "bits": 8, "attr": "RO" },
  {                  "bits": 7 },
  { "name": "<o>B</o><b>R<i>K</i></b>",   "bits": 5, "attr": "RW", "type": 4 },
  { "name": "CPK",   "bits": 1 },
  { "name": "Clear", "bits": 3 },
  { "bits": 8 }
]}""")
svg.saveas("demo3.svg")

示例 3