Sawen_Blog

At the beginning, timing diagrams were drawn using Visio, but the line width was too difficult to standardize, looking quite ugly, so I learned to use waveform syntax to draw timing diagrams with code.

Start#

Install waveform render in Vscode or search for wavedrom on GitHub to install. Since Vscode is my commonly used editor, I chose to learn to use waveform by installing the plugin in Vscode.
Create a json file in Vscode with the content:

{

    "signal":[

        {"name":"clk","wave":"p....."},

        {"name":"data","wave":"010101"}

    ]

}

After selecting the following command in the command panel, you can view the rendering result:

Syntax#

Clock Signal#

• p represents a square wave starting at the rising edge
• n represents a square wave starting at the falling edge
• l represents low level
• h represents high level
• Uppercase letters will draw arrows at the edges of the square wave
  
  The timing diagram rendered by the code is:
  

Data Signal#

• 0 and 1

• x represents an unknown state

• = represents valid data, which can also be written as 2~9, displayed in different colors, and can use the data variable with a text label
  

• You can use | to indicate a segment of the signal is omitted
  
  period and phase variables are used to adjust timing

• The value of period should be a number n, representing horizontal scaling up or down proportionally

• The value of phase should be a number n, representing horizontal position adjustment, with the unit being one clock cycle:

  • If it is a positive number, it means moving left by n clock cycles
  • If it is a negative number, it means moving right by n clock cycles
    
    Multiple signals can be grouped using the ['group name', {...}, {...}, ...] syntax, and nesting is supported.
    After the timing diagram is completed, the image can also be modified. "config": { "hscale": n } means to horizontally scale the image by n times. "head":{ } and "foot":{ } represent adding some content above and below the timing diagram, respectively:

• The text variable should be set to a string, representing a line of text to be added

• The tick variable should be set to an integer, representing the display of sequence numbers at the starting point of the clock cycle, starting from n

• The tock variable should be set to an integer, representing the display of sequence numbers at the midpoint of the clock cycle, starting from n