1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
|
[]()
# lxi-tools - open source LXI tools
[](https://circleci.com/gh/lxi-tools/lxi-tools/tree/master)
[](https://github.com/lxi-tools/lxi-tools/releases)
[](https://repology.org/project/lxi-tools/versions)
[](https://www.codefactor.io/repository/github/lxi-tools/lxi-tools)
<!-- [](https://github.com/lxi-tools/lxi-tools) -->
## 1. Introduction
lxi-tools are open source software tools for managing network attached LXI
compatible test instruments such as modern oscilloscopes, power supplies,
spectrum analyzers etc.
Features include automatic discovery of test instruments, sending SCPI
commands, grabbing screenshots from supported instruments, benchmarking SCPI
message performance, and powerful scripting for test automation. Both a
commandline tool and a GUI tool are available.
lxi-tools rely on [liblxi](https://github.com/lxi-tools/liblxi) for all
communication.
### 1.1 What is LXI?
LAN eXtensions for Instrumentation (LXI) is a standard developed by the LXI
Consortium, an industry consortium that maintains the LXI specification and
promotes the LXI Standard. The LXI standard defines the communication protocols
for modern instrumentation and data acquisition systems using Ethernet.
Visit www.lxistandard.org for more details.
Please notice that lxi-tools is not affiliated with the LXI consortium - it is
an independent open source community effort.
### 1.2 Motivation
To make better and simpler open source tools for managing network attached LXI
compatible test instruments.
## 2. Features
* Automatically discover test instruments on local network via VXI11 or mDNS
* Send SCPI commands and receive responses
* Automatically grab screenshots from supported instruments
* Benchmark request/response performance of instruments
* Support for manually adding instruments in case they are undiscoverable
* Powerful Lua scripting support for advanced automation
- Simple script editor with syntax highlighting
- Simple API which supports
- Connecting/disconnecting remote test instruments
- Send SCPI commands to connected test instruments and receive responses
- Clock sources for managing elapsed time
- Log data to CSV files
- Charts for graphically presenting captured data live in various chart types:
- Line
- Scatter
- Number
- Angular gauge
- Linear gauge
- Charts can be saved in PNG or CSV format
* Command-line and GUI tool available
* Interactive command-line mode
* Dump received response in hexadecimal format
## 3. Usage
### 3.1 lxi-gui
The lxi-gui application provides some of the same features as the commandline
tool and more but presents them in a modern GUI frontend.
<p align="center">
<img src="images/lxi-gui-scpi.png">
<em>SCPI mode - easily explore SCPI features of your instruments</em>
<img src="images/lxi-gui-search.png">
<em>Search for instruments - using standard broadcast discovery or mDNS</em>
<img src="images/lxi-gui-screenshot.png">
<em>Screenshot mode - easily grab display screenshots from supported instruments</em>
<img src="images/lxi-gui-benchmark.png">
<em>Benchmark mode - measure the message response performance of your instruments</em>
<img src="images/lxi-gui-script.png">
<em>Script mode - program your LXI compatible instruments in a powerful clean cut Lua script environment</em>
<img src="https://raw.githubusercontent.com/lxi-tools/lxi-tools/master/images/lxi-gui-script-in-action.png">
<em>Script mode in action plotting voltage levels from a DC power supply to line chart and CSV/PNG files</em>
</p>
### 3.2 lxi
The commandline interface of the lxi application is described in the output
from 'lxi --help':
```
Usage: lxi [--version] [--help] <command> [<args>]
-v, --version Display version
-h, --help Display help
Commands:
discover [<options>] Search for devices
scpi [<options>] <scpi-command> Send SCPI command
screenshot [<options>] [<filename>] Capture screenshot
benchmark [<options>] Benchmark
run <filename> Run Lua script
Discover options:
-t, --timeout <seconds> Timeout (default: 3)
-m, --mdns Search via mDNS/DNS-SD
Scpi options:
-a, --address <ip> Device IP address
-p, --port <port> Use port (default: VXI11: 111, RAW: 5025)
-t, --timeout <seconds> Timeout (default: 3)
-x, --hex Print response in hexadecimal
-i, --interactive Enter interactive mode
-r, --raw Use raw/TCP
Screenshot options:
-a, --address <ip> Device IP address
-t, --timeout <seconds> Timeout (default: 15)
-p, --plugin <name> Use screenshot plugin by name
-l, --list List available screenshot plugins
Benchmark options:
-a, --address <ip> Device IP address
-p, --port <port> Use port (default: VXI11: 111, RAW: 5025)
-t, --timeout <seconds> Timeout (default: 3)
-c, --count <count> Number of request messages (default: 100)
-r, --raw Use raw/TCP
```
#### 3.2.1 Example - Discover LXI devices on available networks
```
$ lxi discover
Searching for LXI devices - please wait...
Broadcasting on interface lo
Broadcasting on interface eth0
Found "RIGOL TECHNOLOGIES,DS1104Z,DS1ZA1234567890,00.04.03.SP2" on address 10.42.1.20
Found "RIGOL TECHNOLOGIES,DP831,DP8F1234567890,00.01.14" on address 10.42.1.67
Broadcasting on interface wlan0
Found 2 devices
```
#### 3.2.2 Example - Send SCPI command to an instrument
```
$ lxi scpi --address 10.42.1.20 "*IDN?"
RIGOL TECHNOLOGIES,DS1104Z,DS1ZA1234567890,00.04.03
```
To dump response to file simply do:
```
$ lxi scpi --address 10.42.1.20 "*IDN?" > response.txt
```
#### 3.2.3 Example - Capture screenshot from a Rigol 1000z series oscilloscope
```
$ lxi screenshot --address 10.42.1.20 --plugin rigol-1000z
Saved screenshot image to screenshot_10.42.1.20_2017-11-11_13:45:47.png
```
Or using plugin autodetection simply:
```
$ lxi screenshot --address 10.42.1.20
Loaded rigol-1000 screenshot plugin
Saved screenshot image to screenshot_10.42.1.20_2017-11-11_13:46:02.png
```
#### 3.2.4 Example - Capture screenshot and convert it to any image format
By default the format of the captured screenshot image is dictated by which
screenshot plugin and instrument are in play. However, it is possible to write
the screenshot image to stdout and pipe it directly to other tools for image
processing.
For example, use ImageMagicks convert tool to automatically convert any
screenshot image to JPG:
```
$ lxi screenshot --address 10.42.1.20 - | convert - screenshot.jpg
```
#### 3.2.5 Example - List available screenshot plugins
```
$ lxi screenshot --list
Name Description
keysight-ivx Keysight InfiniVision 2000X/3000X series oscilloscope
lecroy LeCroy WavePro oscilloscopes
rigol-1000z Rigol DS/MSO 1000z series oscilloscope
rigol-2000 Rigol DS/MSO 2000 series oscilloscope
rigol-dg4000 Rigol DG 4000 series function generator
rigol-dm3000 Rigol DM 3000 series digital multimeter
rigol-dp800 Rigol DP 800 series power supply
rigol-dsa Rigol DSA 700/800 series spectrum analyzer
rs-hmo1000 Rohde & Schwarz HMO 1000 series oscilloscope
siglent-sdm3000 Siglent SDM 3000/3000X series digital multimeter
siglent-sdg Siglent SDG 1000X/2000X/6000X series waveform generator
siglent-sds Siglent SDS 1000X/2000X series oscilloscope
siglent-ssa3000x Siglent SSA 3000X series spectrum analyzer
tektronix-2000 Tektronix DPO/MSO 2000 series oscilloscope (experimental)
```
#### 3.2.6 Example - Benchmark instrument request/response performance
```
$ lxi benchmark --address 10.42.1.20
Benchmarking by sending 100 ID requests. Please wait...
Result: 24.7 requests/second
```
## 4. Installation
### 4.1 Installation using package manager (Linux)
lxi-tools comes prepackaged for various GNU/Linux distributions. Please consult
your package manager tool to find and install lxi-tools.
If you would like to see lxi-tools included in your favorite distribution,
please reach out to their package maintainers team.
### 4.2 Installation using snap (Linux)
Install latest stable version:
```
$ snap install lxi-tools
```
Install bleeding edge:
```
$ snap install lxi-tools --edge
```
### 4.3 Installation using homebrew (MacOS, Linux)
If you have [homebrew](http://brew.sh) installed:
```
$ brew install lxi-tools
```
### 4.4 Installation using Windows installer (Windows - experimental)
Install using the latest Windows installer found [here](https://github.com/lxi-tools/lxi-tools-windows-installer/releases).
### 4.5 Installation using Linux on Windows with WSL2 (Windows)
If you have [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install)
installed you can simply use snap to install lxi-tools in the Ubuntu WSL:
```
$ snap install lxi-tools
```
### 4.6 Installation from source
The latest source releases can be found [here](https://github.com/lxi-tools/lxi-tools/releases).
To compile and install successfully from source you need to first install the
following dependencies:
* liblxi
* libreadline
* liblua
* libgtk
* libadwaita
* gtksourceview
* bash-completion
Install steps:
```
$ meson setup build
$ meson compile -C build
$ meson install -C build
```
See meson\_options.txt for which features to enable/disable.
Note: The meson install steps may differ depending on your specific system.
## 5. Tested instruments
The tools are tested to work successfully with the following LXI compatible
instruments:
| Instrument | Working features | Note |
|-----------------------------------|----------------------------|-------------------------------|
| AimTTi CPX400DP | [scpi] | Use RAW/TCP, port 9221 |
| AimTTi PL303-P | [scpi] | Use RAW/TCP, port 9221 |
| Chroma 63205A | [discover+scpi] | Use RAW/TCP, port 2101 |
| ITECH IT6018C | [discover+scpi] | |
| GW-INSTEK PSW800 | [scpi] | Use RAW/TCP, port 2268 |
| Keysight Technologies PSA E4446A | [discover+scpi+screenshot] | |
| Keysight Technologies PXA N9030A | [discover+scpi+screenshot] | |
| Keysight Technologies DSO 6054A | [discover+scpi+screenshot] | |
| Keysight Technologies AWG 33612A | [discover+scpi+screenshot] | |
| Keysight Technologies DMM 34461A | [discover+scpi+screenshot] | |
| Keysight Technologies DMM L4411A | [discover+scpi] | |
| Keysight Technologies MSO-X 3024T | [discover+scpi+screenshot] | |
| Keysight Technologies MSO-X 6004A | [discover+scpi+screenshot] | |
| Kikusui Electronics PMX35-3A | [discover+scpi] | |
| LeCroy WavePro ZI-a | [discover+scpi+screenshot] | |
| Rigol Technologies DG1062Z | [discover+scpi+screenshot] | |
| Rigol Technologies DG4062 | [discover+scpi+screenshot] | |
| Rigol Technologies DG4102 | [discover+scpi+screenshot] | |
| Rigol Technologies DG4162 | [discover+scpi+screenshot] | |
| Rigol Technologies DL3021 | [discover+scpi] | |
| Rigol Technologies DP831 | [discover+scpi+screenshot] | |
| Rigol Technologies DP832 | [discover+scpi+screenshot] | |
| Rigol Technologies DM3058 | [discover+scpi] | |
| Rigol Technologies DM3068 | [discover+scpi+screenshot] | |
| Rigol Technologies DS1074Z+ | [discover+scpi+screenshot] | |
| Rigol Technologies DS1104Z | [discover+scpi+screenshot] | |
| Rigol Technologies DS2302 | [discover+scpi+screenshot] | |
| Rigol Technologies DSA815 | [discover+scpi+screenshot] | |
| Rigol Technologies MSO1104Z | [discover+scpi+screenshot] | |
| Rigol Technologies MSO2302A | [discover+scpi+screenshot] | |
| Rigol Technologies MSO4024 | [discover+scpi+screenshot] | |
| Rigol Technologies MSO4054 | [discover+scpi+screenshot] | |
| Rigol Technologies MSO5074 | [discover+scpi+screenshot] | |
| Rohde & Schwarz CMW 270 | [discover+scpi] | |
| Rohde & Schwarz HMC 8012 | [discover+scpi+screenshot] | |
| Rohde & Schwarz HMC 8043 | [discover+scpi+screenshot] | |
| Rohde & Schwarz HMO 1202 | [discover+scpi+screenshot] | |
| Rohde & Schwarz HMO 3054 | [scpi+screenshot] | |
| Rohde & Schwarz NGE 100 | [discover+scpi+screenshot] | |
| Rohde & Schwarz NGM 202 | [discover+scpi+screenshot] | |
| Rohde & Schwarz NGL 202 | [discover+scpi+screenshot] | |
| Rohde & Schwarz RTB 2004 | [discover+scpi+screenshot] | |
| Rohde & Schwarz RTH 1004 | [discover+scpi+screenshot] | |
| Rohde & Schwarz RTM 3004 | [discover+scpi+screenshot] | |
| Rohde & Schwarz ZNL3 | [discover+scpi] | |
| Siglent Technologies SDG1032X | [discover+scpi+screenshot] | |
| Siglent Technologies SDG2122X | [discover+scpi+screenshot] | |
| Siglent Technologies SDG2042X | [discover+scpi+screenshot] | |
| Siglent Technologies SDG6052 | [discover+scpi+screenshot] | |
| Siglent Technologies SDS1152CML | [discover+scpi+screenshot] | |
| Siglent Technologies SDS1202X-E | [discover+scpi+screenshot] | |
| Siglent Technologies SDS1204X-E | [discover+scpi+screenshot] | |
| Siglent Technologies SDS2304X | [discover+scpi+screenshot] | |
| Siglent Technologies SDM3045X | [discover+scpi+screenshot] | |
| Siglent Technologies SDM3055 | [discover+scpi+screenshot] | |
| Siglent Technologies SDM3055-SC | [discover+scpi+screenshot] | |
| Siglent Technologies SDM3065X | [discover+scpi+screenshot] | |
| Siglent Technologies SPD1168X | [scpi] | |
| Siglent Technologies SPD3303X-E | [scpi] | |
| Siglent Technologies SSA3032X | [discover+scpi+screenshot] | |
| Siglent Technologies SVA1032X | [discover+scpi+screenshot] | |
| Tektronix TDS3034B | [discover+scpi+screenshot] | |
| Tektronix MDO3024 | [discover+scpi] | |
| Tektronix 4 Series MSO | [discover+scpi] | |
| Tektronix MSO56 | [discover+scpi+screenshot] | |
Notes:
* Feel free to add tested instruments to the list via GitHub pull request or report via GitHub issue.
* The [lxi-tools wiki](https://github.com/lxi-tools/lxi-tools/wiki/) provides further information regarding test instruments, including known issues and SCPI commands.
## 6. Documentation
## 6.1 lxi
The lxi commandline tool is documented in its included manpages.
## 6.2 Lua script API
The lxi-tools Lua script API is documented [here](doc/lua-api.txt).
## 7. Contributing
lxi-tools is open source. If you want to help out with the project please feel
free to join in.
All contributions (bug reports, code, doc, ideas, etc.) are welcome.
Please use the github issue tracker and pull request features.
Also, if you find this free open source software useful please feel free to
consider making a donation of your choice:
[](https://www.paypal.me/lundmar)
## 8. Support
Submit bug reports [here](https://github.com/lxi-tools/lxi-tools/issues).
## 9. Website
Visit [lxi-tools.github.io](https://lxi-tools.github.io)
## 10. Wiki
Visit wiki [here](https://github.com/lxi-tools/lxi-tools/wiki/).
## 11. License
This code is released under BSD-3, commonly known as the 3-clause (or
"modified") BSD license.
## 12. Authors
Created and maintained by Martin Lund \<martin.lund@keep-it-simple.com>
See the AUTHORS file for full list of contributors.
## 13. Sponsors
A big thank you to the following sponsors that have donated test equipment to
support the lxi-tools open source effort:
* Siglent Technologies - www.siglent.com
* KIKUSUI Electronics Corp. - www.kikusui.co.jp
|
