- 1 Windows installers
- 2 Drivers
- 3 Firmware
- 4 Example files
- 5 Limitations and TODOs
- 6 FAQ
- 7 Building from source
In order to use libsigrok (via a sigrok frontend) on Windows, you need to install the proper driver for the respective device.
If your device is connected through a (virtual) COM port, libsigrok doesn't need a special driver. Please install the driver as provided by the manufacturer. If you are unsure, you can check if your device appears at the "Ports (COM&LPT)" section of the Windows Device Manager.
Device specific USB driver
The device specific USB driver shipped with the vendor software is not going to work in almost all cases. You will need to install the WinUSB driver.
For installing the WinUSB driver 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 (Vista or higher) supported Windows versions (zadig.exe). Both 32 and 64 bit Windows versions are supported. 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).
If you already installed the vendor driver previously, you need to run Zadig and switch to the WinUSB driver (see above). There's no need to uninstall or deactivate the vendor driver manually, Zadig will handle all of this.
See also the Zadig wiki page for more information.
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.
These files can be used to conveniently test various frontend features and protocol decoders, and so on.
Limitations and TODOs
The table below lists some of the known remaining issues.
|openbench-logic-sniffer||The OLS (and other compatible devices such as Buspirate) only work once in PulseView, subsequent acquisitions fail (bug #563).|
|serial port code||There may be an issue still in the serial port handling on Windows (bug #341). Needs to be investigated.|
|file saving||Saving .sr files doesn't seem to work, at least in some situations (bug #570). Needs to be investigated.|
See the current list of Windows issues in Bugzilla for the full list.
I cannot start sigrok-cli or PulseView: error Oxc0150002
This happens if you don't have the Microsoft Visual C++ 2008 Redistributable Package installed. Usually this is already installed on most machines since various other software packages also need this. If you didn't yet install it (or no other software package automatically installed it for you) you will see the Oxc0150002 error and sigrok-cli and/or PulseView will not start.
The root cause for this is that the above download will install the otherwise missing file msvcr90.dll (and possibly others) which is required for running sigrok frontends. The requirement is imposed by python32.dll to be more specific, which we use/need for running protocol decoders.
My device is not found or usable (USB/driver/firmware/hardware issues)
- You need to place the proper firmware and/or FPGA bitstream file(s) for your device (if any) into the respective directory where the frontend expects them. See above for details.
- You need to install the correct vendor driver and/or use Zadig to assign the WinUSB driver to your device. See above for details.
- Be careful into which USB port you plug the device. Windows assigns drivers to USB devices based on their serial number, and as a fallback (if the device doesn't have a USB serial number) it assigns drivers per USB port. That means (for example) that if you assigned the WinUSB driver using Zadig while your device was attached to a certain physical USB port, that assignment will not be available when you plug the same device into another USB port! You'll have to do the WinUSB driver assignment again (using Zadig) for that new USB port!
- If you use certain inexpensive FX2-based logic analyzers, please do not use the USB cable that they shipped with. Those USB cables seems to be of a consistently very bad quality and cause all kinds of strange issues. Use another USB cable of which you are sure that it is working well.
Building from source
Note: This should generally not be necessary for users, please just use the provided nightly installers (see above).
Cross-compile using MXE
Native builds are generally not supported by us! Yes, they can work in theory (see below), but it means a lot of hassle compared to a cross-compile using the above script, and native builds are not really well-tested by us.
Native build using MSYS2
If you do want to build the sigrok subprojects natively on a Windows system (instead of using the cross-compile method, see above) we recommend you use MSYS2. More information is available on the MSYS2 introduction and the MSYS2 installation pages.
$ pacman -Sy $ pacman -S git autoconf automake libtool make pkg-config wget patch mingw-w64-i686-toolchain \ mingw-w64-i686-glib2 mingw-w64-i686-glibmm mingw-w64-i686-libusb mingw-w64-i686-check mingw-w64-i686-boost \ mingw-w64-i686-libzip mingw-w64-i686-doxygen mingw-w64-i686-python3 mingw-w64-i686-python3-numpy \ mingw-w64-i686-python3-gobject mingw-w64-i686-python3-setuptools mingw-w64-i686-swig mingw-w64-i686-qt4 mingw-w64-i686-cmake
Afterwards, you can open a new MSYS2 MinGW32 shell (do not use the MSYS Shell, that won't work as expected!) and build the sigrok subprojects pretty much like on any Linux system.
- This is still work in progress, not all parts are fully working, tested, or supported yet!
- MSYS2 currently doesn't ship with all packages we want. E.g. the following are missing: autoconf-archive, libftdi1, librevisa.
- There may be a few bugs that need to be fixed in sigrok subprojects first. Examples: bug #533.