Some devices supported by libsigrok need a firmware to be uploaded before the device can be used.
Getting firmware files
Getting non-distributable firmware files
Most firmware files are non-free and we have no permission to (re-)distribute them.
For these devices, please check the respective device wiki page (see Supported hardware for the full list). Usually there are instructions on how to extract the firmware file(s) from vendor software, vendor webpages, from USB logs, or using other means.
For some firmware files we provide scripts which can extract them from the vendor software for you.
$ git clone git://sigrok.org/sigrok-util $ cd sigrok-util/firmware
Please check the manpages of the scripts provided there for details.
Getting distributable firmware files
For some (but not all) devices there are publically available and redistributable firmware files in the sigrok-firmware git repository (i.e., the vendor was kind enough to allow redistribution):
$ git clone git://sigrok.org/sigrok-firmware
In order to install the firmware files:
$ cd sigrok-firmware $ ./autogen.sh $ ./configure $ make $ make install (as root or using sudo, if needed)
Getting open-source firmware files
See the fx2lafw page for details.
Where to put the firmware files
The place where you have to put firmware files (so that libsigrok, and thus any frontend such as sigrok-cli or PulseView) can find them, depends on your operating system and/or your sigrok install location.
Linux / FreeBSD / Mac OS X
- Inside the XDG_DATA_HOME directory: $HOME/.local/share/sigrok-firmware
- Inside the libsigrok install prefix, e.g.: $HOME/sr/share/sigrok-firmware (if you installed libsigrok into $HOME/sr)
- In /usr/local: /usr/local/share/sigrok-firmware
- In /usr: /usr/share/sigrok-firmware
On Windows place the files into the installation directory of the respective frontend. This depends on where you installed the frontend, of course. Defaults:
- PulseView: C:\Program Files (x86)\sigrok\PulseView\share\sigrok-firmware
- sigrok-cli: C:\Program Files (x86)\sigrok\sigrok-cli\share\sigrok-firmware
Some firmware files (those which we're allowed to redistribute) already come with the Windows EXE installers we provide, and don't need to be manually copied.
On Android place the files into the following directory on your device:
Some firmware files (those which we're allowed to redistribute) already come with the Android APK we provide, and don't need to be manually copied.