1PULSEVIEW(1) General Commands Manual PULSEVIEW(1)
2
6 PulseView - Qt-based LA/scope/MSO GUI for sigrok
7
9 pulseview [OPTIONS] [FILE]
10
12 PulseView is a cross-platform Qt-based GUI for the sigrok software
13 suite for test and measurement equipment such as logic analyzers,
14 oscilloscopes, MSOs, and more.
15
17 PulseView has very few command line options, as most configuration ele‐
18 ments are available from the GUI itself.
19 If the optional FILE argument is supplied, PulseView tries to open the
21 specified file. It has to be in the "libsigrok session" format (.sr)
22 unless -I is used to specify the input file format.
23 -l, --loglevel
25 Set the libsigrok and libsigrokdecode loglevel. At the moment
26 PulseView doesn't support setting the two loglevels indepen‐
27 dently. The higher the number, the more debug output will be
28 printed. Valid loglevels are:
29 0 None
31 1 Error
32 2 Warnings
33 3 Informational
34 4 Debug
35 5 Spew
36 -h, -?, --help
38 Show a help text and exit.
39 -V, --version
41 Show version information and exit.
42 -d, --driver <drivername>
44 Specify the capture device to connect to. If the --driver option
45 is not supplied, PulseView attempts to re-connect to the most
46 recently used device, or auto-detect available devices.
47 -D, --dont-scan
49 Usually PulseView automatically scans all drivers to find suit‐
50 able devices during program startup. This option disables the
51 auto-scan. Users can either specify the --driver option to pick
52 a device at startup, or interactively scan for devices after
53 PulseView has finished starting up.
54 -i, --input-file <filename>
56 Load input from a file. If the --input-format option is not sup‐
57 plied, PulseView attempts to load the file as a sigrok session
58 file.
59 -I, --input-format <format>
61 Specifies the format of the input file to be loaded.
62 -s, --settings <filename>
64 Load PulseView session setup to use with the input file. The
65 setup file must be in the "PulseView session setup" format
66 (.pvs).
67 -c, --clean
69 Prevents the previously used sessions to be restored from set‐
70 tings storage. This is useful if you want only a single session
71 with the file given on the command line instead of restoring all
72 previously used sessions as well.
73
75 f Zoom-to-fit.
76 s Enable / disable sticky scrolling. When enabled, the right edge
78 of the screen always shows the most recently captured data.
79 . Show / hide sampling points.
81 g Show / hide analog minor grid (in addition to the vdiv grid).
83 c Show / hide cursors.
85 d Show / hide protocol decoder selector.
87 b Toggle between coloured trace backgrounds and alternating
89 light/dark gray trace backgrounds.
90 SPACE Start / stop an acquisition.
92 Left/right arrow keys
94 Scroll left/right.
95 +/- Zoom in/out.
97 Up/down arrow keys
99 Zoom in/out.
100 Home/End
102 Jump to the start/end of the sample data.
103 1/2 Attach left/right side of the cursors to the mouse.
105 CTRL+o Open file.
107 CTRL+s Save as...
109 CTRL+r Save selected range as...
111 CTRL+g Group all currently selected traces into a trace group.
113 CTRL+u Ungroup the traces in the currently selected trace group.
115 CTRL+up/down arrow keys
117 Scroll down/up.
118 CTRL+q Quit, i.e. shutdown PulseView (closing all session tabs).
120 CTRL+w Close the current session tab.
122
124 PulseView exits with 0 on success, 1 on most failures.
125
127 sigrok-cli(1)
128
130 Please report any bugs via Bugzilla (http://sigrok.org/bugzilla) or on
131 the sigrok-devel mailing list (sigrok-devel@lists.souceforge.net).
132
134 PulseView is covered by the GNU General Public License (GPL), version 3
135 or later.
136
138 Please see the individual source code files.
139 This manual page was written by Uwe Hermann <uwe@hermann-uwe.de>. It
141 is licensed under the terms of the GNU GPL (version 2 or later).
142 March 31, 2020 PULSEVIEW(1)