Record your first timing diagram
We used a clock driving an 8-bit counter, the circuit from the clock guide.
Open the timing diagram
In the main window choose Simulate, then Timing diagram. The menu item is in the 5.0.0 Simulate menu (F46).
Check: A second window opens with the tabs Options and Timing diagram.
Choose the signals
On the Options tab click Add or Remove under Signals and Formats. The dialog is titled “Drag signals to select or rearrange”. In our circuit all four signals were already in the viewed list.
Check: The Signals to be viewed list holds the pins you want.
Pick Clocked mode and the clock
Logging Mode offers three modes; Clocked mode was selected. Clock Source showed CLK, and Clock Discipline was “capture on both edges”.
Check: Clock Source shows your clock and Clock Discipline is set.
Tick the clock
Click the main window, then press Ctrl+T for one half cycle, or Ctrl+K to run the clock. See Clock, ticks and simulation controls.
Check: The Timing diagram tab shows waveforms.
The Options tab of the timing diagram window. Boxes: Signals and Formats with an Add or Remove button, Logging Mode with Stop-motion mode, Continuous real-time mode and Clocked mode selected, Timing Options for Clocked mode with a time scale of 5.0 microseconds, a clock source CLK and a clock discipline of capture on both edges, and History with a Store unlimited history check box.
The dialog Drag signals to select or rearrange. Left list, Signals available in circuit: CLK, Counter, halt, Q. Right list, Signals to be viewed: CLK, Counter, Q and halt, each followed by a format in brackets. An OK button is at the bottom.
After eight presses of Ctrl+T, which is four clock cycles, the counter read 0000 0100 (F97).
The Timing diagram tab after four clock cycles. Rows: CLK with alternating 0 and 1, the counter as a bus, Q as a bus and halt at 0. The Signal Value column reads 0000 0100 for the counter and for Q. A toolbar above has an Add or Remove Signals button.
The three logging modes
The Options tab lists three modes (F97). The descriptions below are in our words, from the window’s own help text.
| Stop-motion mode | After the circuit settles, or at every change if you tick Capture fine-grained details. | Combinational circuits and step-by-step runs. |
|---|---|---|
| Continuous real-time mode | While the simulator runs, scaling each real second to a chosen amount of circuit time. | Watching a free-running circuit. |
| Clocked mode | At each clock edge, rising, falling or both, or during the high or low half, depending on Clock Discipline. | Counters and registers for lab reports. |
No rows match.
The fine-grained option adds the short pulses that appear while signals settle, drawn as if each gate delayed by the Gate delay value. The window says the setting was 200 ns, greyed out until the option is ticked. We did not build a glitch circuit, so we have no screenshot of one. The History box offers unlimited history or a number of recent values to store; we did not test either.
Reading the diagram
The left column lists each signal and its current value. Single-bit signals are drawn as high and low; buses are drawn as a band with the value written inside. The time scale in our run was 5.0 µs per tick, and a clock cycle was 2 ticks, so 10.0 µs. Our export of the same run, drawn here from the data Logisim wrote, with one column per half cycle:
Show values as a table
| half cycle | CLK | Counter |
|---|---|---|
| 0 | 0 | 00 |
| 1 | 1 | 01 |
| 2 | 0 | 01 |
| 3 | 1 | 02 |
| 4 | 0 | 02 |
| 5 | 1 | 03 |
| 6 | 0 | 03 |
| 7 | 1 | 04 |
| 8 | 0 | 04 |
We did not test the bus Expand and Format controls, zoom, or the cursor.
Export for a report
In the timing window choose File, then Export Image. The type list showed PNG, GIF, JPEG, TikZpicture (.tex), SVG and WaveDrom (.json). All six wrote a file for our counter; the PNG was 488 by 140 pixels (F97).
The export file chooser of the timing diagram. Fields Look In, File Name and Files of Type set to PNG Files. Buttons Export and Cancel.
The PNG written by the timing diagram export: four lanes for CLK, the counter, Q and halt, with the clock alternating and the counter bus changing at each rising edge.
The WaveDrom file is plain JSON that a WaveDrom viewer can draw. Ours, for the counter run: timing-counter-wavedrom.json. The release notes say export bugs were fixed in 5.0.0; we did not compare versions.
Log values to a file
We found no option in the 5.0.0 timing window to log to a file, and the Simulate menu has no Logging item. To keep the numbers, export WaveDrom and read the data lists in it. Classic Logisim 2.7.1 does have a file log, below. To turn recorded values into a test vector, see Test vectors when that guide is available.
Where did the “Start Chronogram” button go?
Old tutorials mention a Chronogram button. In the release notes for Logisim-evolution the chronogram work was merged in a 3.4.4 pre-release and described as working again in 3.5.0 (release history). In 5.0.0 it is a menu item, Simulate, then Timing diagram. The 5.0.0 strings still contain an older message, “Add ‘sysclk’ signal in Simulate->Chronogram…”, which we did not see in the window.
Timing diagrams in classic 2.7.1
Classic has no timing diagram. Simulate, then Logging, opens a window with three tabs, Selection, Table and File (F98). Selection lists the components and has Add, Change Radix, Move Up, Move Down and Remove buttons.
The Logging window of classic Logisim 2.7.1 on its Selection tab. The left list shows Clock, Counter, halt and Q. Buttons: Add, Change Radix, Move Up, Move Down, Remove and Close Window.
The File tab reads “File output disabled.” with an Enable button, a file box, a Select button and a ticked Include Header Line box.
The File tab of the classic 2.7.1 Logging window. It reads File output disabled, with a greyed-out Enable button, an empty File box, a Select button and a ticked Include Header Line box.
We did not write a log file, so we cannot describe its contents. For a waveform from classic, log to a file and draw it with an external tool, or use Logisim-evolution. See Classic Logisim 2.7.1 today.