]> sigrok.org Git - libsigrok.git/blobdiff - README.devices
configure.ac: Bump package version to 0.2.2.
[libsigrok.git] / README.devices
index 290357f5da227cb16223ce05768246995e02a93b..f28462a02977a2dc2d5da968fd98d7ed0be67e8d 100644 (file)
@@ -42,22 +42,36 @@ The following drivers/devices require a firmware upload upon connection:
    These can be extracted from the vendor's Windows drivers using a tool
    from our 'sigrok-util' repository/project.
 
+ - saleae-logic16: The Saleae Logic16 needs a firmware file for the
+   Cypress FX2 chip in the device, as well as two FPGA bitstream files.
+   These can be extracted from the vendor's Linux application using a tool
+   from our 'sigrok-util' repository/project.
+
 The following drivers/devices do not need any firmware upload:
 
  - agilent-dmm
  - alsa
  - brymen-dmm
+ - cem-dt-885x
+ - center-3xx
  - chronovu-la8
  - colead-slm
  - demo
  - fluke-dmm
+ - ikalogic-scanalogic2
+ - ikalogic-scanaplus
+ - kecheng-kc-330b
  - lascar-el-usb
+ - link-mso19
  - mic-985xx
+ - norma-dmm
  - openbench-logic-sniffer
  - rigol-ds1xx2
  - serial-dmm
+ - teleinfo
  - tondaj-sl-814
  - uni-t-dmm
+ - uni-t-ut32x
  - victor-dmm
  - zeroplus-logic-cube
 
@@ -80,11 +94,16 @@ The following drivers/devices require a serial port specification:
 
  - agilent-dmm
  - brymen-dmm
+ - cem-dt-885x
+ - center-3xx
  - colead-slm
  - fluke-dmm
+ - link-mso19
  - mic-985xx
+ - norma-dmm
  - openbench-logic-sniffer
  - serial-dmm
+ - teleinfo
  - tondaj-sl-814
 
 The following drivers/devices do not require a serial port specification:
@@ -95,9 +114,14 @@ The following drivers/devices do not require a serial port specification:
  - demo
  - fx2lafw
  - hantek-dso
+ - ikalogic-scanalogic2
+ - ikalogic-scanaplus
+ - kecheng-kc-330b
  - lascar-el-usb
  - rigol-ds1xx2
+ - saleae-logic16
  - uni-t-dmm
+ - uni-t-ut32x
  - victor-dmm
  - zeroplus-logic-cube
 
@@ -194,6 +218,10 @@ When using any of the UT-D04 USB/HID cables you have to use the respective
 driver _without_ the '-ser' drivername suffix (internally all of these models
 are handled by the 'uni-t-dmm' driver).
 
+You also need to specify the USB vendor/device IDs of the cable.
+Autodetection is not possible here, since various other products use the
+USB VID/PID of those cables too, and there is no way to distinguish them.
+
 Since the UT-D04 cables are USB based (but don't use a USB-to-serial chip)
 there is no need to specify a serial port via 'conn', of course.
 However, the user running the frontend does also need to have permissions
@@ -201,8 +229,8 @@ to access the respective USB device (see above).
 
 Examples (sigrok-cli):
 
- $ sigrok-cli --driver uni-t-ut61e ...
- $ sigrok-cli --driver voltcraft-vc820 ...
+ $ sigrok-cli --driver uni-t-ut61e:conn=1a86.e008 ...
+ $ sigrok-cli --driver voltcraft-vc820:conn=04fa.2490 ...
 
 
 UNI-T UT-D04 cable issue on Linux
@@ -241,9 +269,13 @@ a short list for convenience:
  - RadioShack 22-812: Press and hold "SELECT" and "RANGE" together.
  - TekPower TP4000ZC: Briefly press the "RS232" button.
  - UNI-T UT61D: Press the "REL/RS232/USB" button for roughly 1 second.
+ - UNI-T UT325: Briefly press the "SEND" button (as per manual). However, it
+   appears that in practice you don't have to press the button (at least on
+   some versions of the device), simply connect the device via USB.
  - V&A VA18B: Keep the "Hz/DUTY" key pressed while powering on the device.
  - Victor 70C: Press the "REL/RS232" button for roughly 1 second.
  - Victor 86C: Press the "REL/RS232" button for roughly 1 second.
+ - Voltcraft VC-830: Press the "REL/PC" button for roughly 2 seconds.
 
 
 ALSA driver
@@ -260,6 +292,16 @@ We might write additional drivers to make a similar functionality available
 on other OSes at some point.
 
 
+Link Instruments MSO-19
+-----------------------
+
+The driver for the Link Instruments MSO-19 mixed-signal oscilloscope (MSO)
+is currently using libudev (which is a library for the Linux-specific udev
+system). Thus, this driver can currently only compile and work on Linux.
+
+We plan to fix this though, so that it'll work on all other OSes, too.
+
+
 ChronoVu LA8 USB VID/PIDs
 -------------------------