]> sigrok.org Git - libsigrok.git/blobdiff - README.devices
asix-sigma: fix incorrect pointer cast (non-aligned memory and endiannes issue)
[libsigrok.git] / README.devices
index 45b5c09b9535c98698895d99c6e0516c78b0adb7..a99fc7e2e95f8fb0e9783e99c7adf8f0022b533c 100644 (file)
@@ -42,25 +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
+ - rigol-ds
  - serial-dmm
+ - teleinfo
  - tondaj-sl-814
  - uni-t-dmm
+ - uni-t-ut32x
  - victor-dmm
  - zeroplus-logic-cube
 
@@ -84,12 +95,15 @@ 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:
@@ -101,9 +115,13 @@ The following drivers/devices do not require a serial port specification:
  - fx2lafw
  - hantek-dso
  - ikalogic-scanalogic2
+ - ikalogic-scanaplus
+ - kecheng-kc-330b
  - lascar-el-usb
- - rigol-ds1xx2
+ - rigol-ds
+ - saleae-logic16
  - uni-t-dmm
+ - uni-t-ut32x
  - victor-dmm
  - zeroplus-logic-cube
 
@@ -200,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
@@ -207,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
@@ -247,6 +269,9 @@ 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.
@@ -319,12 +344,12 @@ Example:
  $ sigrok-cli --driver ols:conn=/dev/ttyACM0 ...
 
 
-Rigol DS1xx2 oscilloscopes
---------------------------
+Rigol DS oscilloscopes
+----------------------
 
-The 'rigol-ds1xx2' driver (for the Rigol DS1052E and some other, similar DSOs)
-currently uses the Linux usbtmc kernel driver. This means it can currently
-only be built and used on Linux (i.e., it's non-portable).
+The 'rigol-ds' driver (for the Rigol DS series DSOs) currently uses the Linux
+usbtmc kernel driver. This means it can currently only be built and used on
+Linux (i.e., it's non-portable).
 
 The use of a kernel module also means it is dependent on the kernel version
 used, as well as on whether this specific module is available in the kernel.
@@ -335,4 +360,3 @@ module as opposed to a libusb-based driver that works in user-space.
 We plan to change the driver to use the 'librevisa' user-space shared
 library (which uses libusb) soon, which will fix all these issues and make
 the driver portable at the same time.
-