Difference between revisions of "Windows"

From sigrok
Jump to navigation Jump to search
(Most devices and drivers work fine (I tested a handful of them), only list the limitations/TODOs.)
Line 1: Line 1:
[[File:Pulseview win jtag.png|right|thumb|320px|[[PulseView]] on Windows]]
[[File:Pulseview win jtag.png|right|thumb|320px|[[PulseView]] on Windows]]
== Status ==
We intend to fully support all major operating systems in sigrok, including Windows. However, we're not quite there, yet. Various portability issues need to be addressed still. The tables below list the current Windows status of the various hardware drivers.
=== Supported ===
{| border="0" style="font-size: smaller" class="alternategrey sigroktable"
|-
!Logic analyzer
!Windows status
|-
| [[ASIX SIGMA]]/[[ASIX SIGMA|SIGMA2]]
| bgcolor="lime" | Should work fine using libftdi + libusb-0.1-win32 (not runtime-tested yet, though).
|-
| [[ChronoVu LA8]]
| bgcolor="lime" | Works fine using libftdi + libusb-0.1-win32.
|-
| Demo driver
| bgcolor="lime" | Works fine.
|-
| [[IKALOGIC ScanaPLUS]]
| bgcolor="lime" | Works fine using libftdi + libusb-0.1-win32.
|-
| [[ZEROPLUS Logic Cube LAP-C(16032)]]
| bgcolor="lime" | Works fine using libusb-1.0.
|-
| [[ZEROPLUS LAP-16128U ]]
| bgcolor="lime" | Should works fine using libusb-1.0 (not runtime-tested yet, though).
|}
=== Work in progress ===
{| border="0" style="font-size: smaller" class="alternategrey sigroktable"
|-
!Logic analyzer
!Windows status
|-
| [[ARMFLY Mini-Logic ]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Braintechnology USB Interface V2.x]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Braintechnology USB-LPS]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[CWAV USBee SX]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Dangerous Prototypes Buspirate]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[EE Electronics ESLA100]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[IKALOGIC Scanalogic-2]]
| bgcolor="red" | HID-based, we need to use HIDAPI.
|-
| [[Lcsoft Mini Board]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Logic Shrimp]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[MCU123 Saleae Logic clone]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[MCU123 USBee AX Pro clone]]
| bgcolor="lime" | Works fine.
|-
| [[Openbench Logic Sniffer]]
| bgcolor="orange" | Serial port portability fixes required (partially implemented, but unfinished).
|-
| [[Robomotic BugLogic 3]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Robomotic MiniLogic]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Saleae Logic]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Link Instruments MSO-19‎]]
| bgcolor="orange" | Doesn't compile due to libudev dependency. TODO: Make libudev optional.
|- bgcolor="#6699ff"
!Mixed-signal oscilloscope
!Windows status
|-
| [[ARMFLY AX-Pro]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[EE Electronics ESLA201A]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[XZL_Studio AX]]
| bgcolor="lime" | Should work fine - please test.
|- bgcolor="#6699ff"
!Oscilloscope
!Windows status
|-
| [[Fluke ScopeMeter 199B]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Hantek DSO-2090]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Rigol DS1052E]]
| bgcolor="orange" | USB connection not supported yet, serial connection partially working.
|-
| [[Rigol DS1102E]]
| bgcolor="orange" | USB connection not supported yet, serial connection partially working.
|- bgcolor="#6699ff"
!Multimeter
!Windows status
|-
| All serial port based DMMs
| bgcolor="lime" | Should work fine - please test.
|-
| All uni-t-dmm based DMMs
| bgcolor="red" | HID-based, we need to use HIDAPI.
|-
| All victor-dmm based DMMs
| bgcolor="red" | HID-based, we need to use HIDAPI.
|- bgcolor="#6699ff"
!Sound level meter
!Windows status
|-
| [[CEM DT-8852]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Colead SL-5868P]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Kecheng KC-330B]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[Tondaj SL-814]]
| bgcolor="lime" | Should work fine - please test.
|- bgcolor="#6699ff"
!Thermometer
!Windows status
|-
| [[Lascar Electronics EL-USB-2]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[MIC 98581]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[MIC 98583]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[UNI-T UT325]]
| bgcolor="red" | HID-based, we need to use HIDAPI.
|-
| [[Voltcraft K204]]
| bgcolor="lime" | Should work fine - please test.
|- bgcolor="#6699ff"
!Hygrometer
!Windows status
|-
| [[Lascar Electronics EL-USB-2]]
| bgcolor="lime" | Should work fine - please test.
|-
| [[MIC 98583]]
| bgcolor="lime" | Should work fine - please test.
|- bgcolor="#6699ff"
!Datalogger
!Windows status
|-
| [[Lascar Electronics EL-USB-CO]]
| bgcolor="lime" | Should work fine - please test.
|}


== Self-extracting installers ==
== Self-extracting installers ==
Line 208: Line 27:


You'll need to copy the extracted files into the '''firmware''' subfolder of the respective installation directory of [[sigrok-cli]] or [[Pulseview]], e.g. '''C:\Program Files\sigrok\sigrok-cli\firmware''' or '''C:\Program Files\sigrok\PulseView\firmware'''.
You'll need to copy the extracted files into the '''firmware''' subfolder of the respective installation directory of [[sigrok-cli]] or [[Pulseview]], e.g. '''C:\Program Files\sigrok\sigrok-cli\firmware''' or '''C:\Program Files\sigrok\PulseView\firmware'''.
== Limitations and TODOs ==
We intend to fully support all major operating systems in sigrok, including Windows. However, we're not quite there, yet. Various portability issues and TODOs need to be addressed still. The table below lists some of the known remaining issues.
{| border="0" style="font-size: smaller" class="alternategrey sigroktable"
|-
!Driver/device
!Windows status
|-
| ikalogic-scanalogic2
| bgcolor="red" | HID-based, we need to use HIDAPI.
|-
| openbench-logic-sniffer
| bgcolor="orange" | Serial port portability fixes required (partially implemented, but unfinished).
|-
| link-mso19‎
| bgcolor="orange" | Doesn't compile due to libudev dependency (Linux-only). TODO: Make libudev optional.
|-
| rigol-ds
| bgcolor="orange" | USB connection not supported yet (it's Linux-only), serial connection partially working.
|-
| uni-t-dmm
| bgcolor="red" | HID-based, we need to use HIDAPI.
|-
| victor-dmm
| bgcolor="red" | HID-based, we need to use HIDAPI.
|}


== Building from source ==
== Building from source ==


See [[Windows/Building]].
See [[Windows/Building]].

Revision as of 13:32, 5 January 2014

PulseView on Windows

Self-extracting installers

Work in progress. We don't provide pre-built installers for sigrok-cli and PulseView right now, but will do so in the near future, when a few issues have been sorted out.

Drivers

In order to use libsigrok (via a sigrok frontend) on Windows, you need to install the proper driver for the respective device. The driver shipped with the vendor software is not going to work in almost all cases.

For installing the drivers you can use the zadig executable from the libwdi project. There are two versions, one for Windows XP (zadig_xp.exe), and another one for all other supported Windows versions (zadig.exe). The sigrok-cli and PulseView installers ship with both zadig executable files for convenience (they're located in the installation directory of the respective application).

Devices where libsigrok uses libftdi (asix-sigma, chronovu-la8, ikalogic-scanaplus) will need the libusb-win32 driver, devices where libsigrok uses libusb-1.0 will need the WinUSB driver (all other USB devices).

Firmware

The Windows installers ship with all firmware files that are either open-source or where we have permission from the vendor to distribute them. Some devices will need other firmware which we cannot redistribute though. See the wiki page for the respective device on how you can extract those firmware files from the vendor's software.

You'll need to copy the extracted files into the firmware subfolder of the respective installation directory of sigrok-cli or Pulseview, e.g. C:\Program Files\sigrok\sigrok-cli\firmware or C:\Program Files\sigrok\PulseView\firmware.

Limitations and TODOs

We intend to fully support all major operating systems in sigrok, including Windows. However, we're not quite there, yet. Various portability issues and TODOs need to be addressed still. The table below lists some of the known remaining issues.

Driver/device Windows status
ikalogic-scanalogic2 HID-based, we need to use HIDAPI.
openbench-logic-sniffer Serial port portability fixes required (partially implemented, but unfinished).
link-mso19‎ Doesn't compile due to libudev dependency (Linux-only). TODO: Make libudev optional.
rigol-ds USB connection not supported yet (it's Linux-only), serial connection partially working.
uni-t-dmm HID-based, we need to use HIDAPI.
victor-dmm HID-based, we need to use HIDAPI.

Building from source

See Windows/Building.