sigrok - User contributions [en]

RDTech RD series

2020-09-05T21:04:48Z

Karlp:

{{Infobox power supply
| image = [[File:RD6006 frontpanel.png|180px]]
| name = Riden RD6006
| status = in progress
| source_code_dir = rdtech-dps
| channels = 1
| connectivity = serial over USB/WiFi/TTL (3.3V)
| features = programmable presets, values, output, over-(voltage,current,power) thresholds.


}}

'''Please note: This page is a work in progress, more to come.'''

== Hardware ==
[[File:rd6006_detail.jpg|512px]]

* MCU: STM32F103
* U13: 2Pai Semi π122U31 Dual channel digital isolator
* U12: Gainsil GS8332 Dual Op-Amp
* U11: Winchiphead CH340E USB to serial
* U8: Winbond W25Q32JV 32MBit (4MB) SPI Flash
* U6: Fujitsu MB85RC04V 4KBit (512B) FRAM
* U1: Titan Micro TM1650 LED Driver
* U5/U0: M5333B? 3.3V regulator?

'''J2 Connector Pinout:'''

{{chip_8pin
|1=VDD
|2=BOOT0
|3=GND
|4=PA14 (SWCLK)
|5=PA13 (SWDIO)
}}


'''WiFi Header Pinout:''':

{{chip_8pin
|1=NC
|2=3.3V
|3=(??) EN
|4=GND
|5=NC
|6=TXD (PA9 / UART1 TXD)
|7=RXD (PA10 / UART1 RXD)
|8=VCC
}}


== Protocol ==

Modbus RTU ([https://en.wikipedia.org/wiki/Modbus#Frame_formats Wikipedia]).
Serial baudrate defaults to 115200/8n1 and Modbus slave address defaults to 1. Both can be changed in the main menu at any time. There is also an option using WiFi instead of USB/Serial, which uses a fixed Baudrate of 115200/8n1.

Also see the [[RDTech_DPS_series]] page. External sources exist which combine communication to DPS as well as UM as well as RD devices in a single project. Protocols may be similar enough to make a common driver desirable.

== Resources ==

* User Manual on [http://myosuploads3.banggood.com/products/20191024/20191024040658RD6006Instruction10.22.pdf banggood] and [http://www.ruidengkeji.com/inst/RD6006.pdf vendor] sites
* [https://www.youtube.com/watch?v=spqa7qy5dEE Video Review]
* [https://www.eevblog.com/forum/testgear/ruideng-riden-rd6006-dc-power-supply/ EEVblog forum thread]
* [https://github.com/Baldanos/rd6006 RD6006 Python module]
* [https://github.com/msillano/RD6006-Super-power-supply PC control and logging]
* [https://github.com/tjko/riden-flashtool Python script for updating firmware]

== See also ==

* [[Programmable power supply]]
* [[Power supply comparison]]

[[Category:Device]]
[[Category:Power supply]]
[[Category:In progress]]

RDTech RD series

2020-09-05T21:01:50Z

Karlp:

{{Infobox power supply
| image = [[File:RD6006 frontpanel.png|180px]]
| name = Riden RD6006
| status = in progress
| source_code_dir = rdtech-dps
| channels = 1
| connectivity = serial over USB/WiFi/TTL (3.3V)
| features = programmable presets, values, output, over-(voltage,current,power) thresholds.


}}

'''Please note: This page is a work in progress, more to come.'''

== Hardware ==
[[File:rd6006_detail.jpg|512px]]

* MCU: STM32F103
* U13: 2Pai Semi π122U31 Dual channel digital isolator
* U12: Gainsil GS8332 Dual Op-Amp
* U11: Winchiphead CH340E USB to serial
* U8: Winbond W25Q32JV 32MBit (4MB) SPI Flash
* U6: Fujitsu MB85RC04V 4KBit (512B) FRAM
* U1: Titan Micro TM1650 LED Driver

'''J2 Connector Pinout:'''

{{chip_8pin
|1=VDD
|2=BOOT0
|3=GND
|4=PA14 (SWCLK)
|5=PA13 (SWDIO)
}}


'''WiFi Header Pinout:''':

{{chip_8pin
|1=NC
|2=3.3V
|3=(??) EN
|4=GND
|5=NC
|6=TXD (PA9 / UART1 TXD)
|7=RXD (PA10 / UART1 RXD)
|8=VCC
}}


== Protocol ==

Modbus RTU ([https://en.wikipedia.org/wiki/Modbus#Frame_formats Wikipedia]).
Serial baudrate defaults to 115200/8n1 and Modbus slave address defaults to 1. Both can be changed in the main menu at any time. There is also an option using WiFi instead of USB/Serial, which uses a fixed Baudrate of 115200/8n1.

Also see the [[RDTech_DPS_series]] page. External sources exist which combine communication to DPS as well as UM as well as RD devices in a single project. Protocols may be similar enough to make a common driver desirable.

== Resources ==

* User Manual on [http://myosuploads3.banggood.com/products/20191024/20191024040658RD6006Instruction10.22.pdf banggood] and [http://www.ruidengkeji.com/inst/RD6006.pdf vendor] sites
* [https://www.youtube.com/watch?v=spqa7qy5dEE Video Review]
* [https://www.eevblog.com/forum/testgear/ruideng-riden-rd6006-dc-power-supply/ EEVblog forum thread]
* [https://github.com/Baldanos/rd6006 RD6006 Python module]
* [https://github.com/msillano/RD6006-Super-power-supply PC control and logging]
* [https://github.com/tjko/riden-flashtool Python script for updating firmware]

== See also ==

* [[Programmable power supply]]
* [[Power supply comparison]]

[[Category:Device]]
[[Category:Power supply]]
[[Category:In progress]]

RDTech RD series

2020-09-05T20:58:22Z

Karlp:

{{Infobox power supply
| image = [[File:RD6006 frontpanel.png|180px]]
| name = Riden RD6006
| status = in progress
| source_code_dir = rdtech-dps
| channels = 1
| connectivity = serial over USB/WiFi/TTL (3.3V)
| features = programmable presets, values, output, over-(voltage,current,power) thresholds.


}}

'''Please note: This page is a work in progress, more to come.'''

== Hardware ==
[[File:rd6006_detail.jpg|512px]]

* MCU: STM32F103
* U13: 2Pai Semi π122U31 Dual channel digital isolator
* U12: Gainsil GS8332 Dual Op-Amp
* U8: Winbond W25Q32JV 32MBit (4MB) SPI Flash
* U6: Fujitsu MB85RC04V 4KBit (512B) FRAM
* U1: Titan Micro TM1650 LED Driver

'''J2 Connector Pinout:'''

{{chip_8pin
|1=VDD
|2=BOOT0
|3=GND
|4=PA14 (SWCLK)
|5=PA13 (SWDIO)
}}


'''WiFi Header Pinout:''':

{{chip_8pin
|1=NC
|2=3.3V
|3=(??) EN
|4=GND
|5=NC
|6=TXD (PA9 / UART1 TXD)
|7=RXD (PA10 / UART1 RXD)
|8=VCC
}}


== Protocol ==

Modbus RTU ([https://en.wikipedia.org/wiki/Modbus#Frame_formats Wikipedia]).
Serial baudrate defaults to 115200/8n1 and Modbus slave address defaults to 1. Both can be changed in the main menu at any time. There is also an option using WiFi instead of USB/Serial, which uses a fixed Baudrate of 115200/8n1.

Also see the [[RDTech_DPS_series]] page. External sources exist which combine communication to DPS as well as UM as well as RD devices in a single project. Protocols may be similar enough to make a common driver desirable.

== Resources ==

* User Manual on [http://myosuploads3.banggood.com/products/20191024/20191024040658RD6006Instruction10.22.pdf banggood] and [http://www.ruidengkeji.com/inst/RD6006.pdf vendor] sites
* [https://www.youtube.com/watch?v=spqa7qy5dEE Video Review]
* [https://www.eevblog.com/forum/testgear/ruideng-riden-rd6006-dc-power-supply/ EEVblog forum thread]
* [https://github.com/Baldanos/rd6006 RD6006 Python module]
* [https://github.com/msillano/RD6006-Super-power-supply PC control and logging]
* [https://github.com/tjko/riden-flashtool Python script for updating firmware]

== See also ==

* [[Programmable power supply]]
* [[Power supply comparison]]

[[Category:Device]]
[[Category:Power supply]]
[[Category:In progress]]

RDTech RD series

2020-09-05T20:58:03Z

Karlp:

{{Infobox power supply
| image = [[File:RD6006 frontpanel.png|180px]]
| name = Riden RD6006
| status = in progress
| source_code_dir = rdtech-dps
| channels = 1
| connectivity = serial over USB/WiFi/TTL (3.3V)
| features = programmable presets, values, output, over-(voltage,current,power) thresholds.


}}

'''Please note: This page is a work in progress, more to come.'''

== Hardware ==
[[File:rd6006_detail.jpg|512px]]

* MCU: STM32F103
* U12: Gainsil GS8332 Dual Op-Amp
* U11: 2Pai Semi π122U31 Dual channel digital isolator
* U8: Winbond W25Q32JV 32MBit (4MB) SPI Flash
* U6: Fujitsu MB85RC04V 4KBit (512B) FRAM
* U1: Titan Micro TM1650 LED Driver

'''J2 Connector Pinout:'''

{{chip_8pin
|1=VDD
|2=BOOT0
|3=GND
|4=PA14 (SWCLK)
|5=PA13 (SWDIO)
}}


'''WiFi Header Pinout:''':

{{chip_8pin
|1=NC
|2=3.3V
|3=(??) EN
|4=GND
|5=NC
|6=TXD (PA9 / UART1 TXD)
|7=RXD (PA10 / UART1 RXD)
|8=VCC
}}


== Protocol ==

Modbus RTU ([https://en.wikipedia.org/wiki/Modbus#Frame_formats Wikipedia]).
Serial baudrate defaults to 115200/8n1 and Modbus slave address defaults to 1. Both can be changed in the main menu at any time. There is also an option using WiFi instead of USB/Serial, which uses a fixed Baudrate of 115200/8n1.

Also see the [[RDTech_DPS_series]] page. External sources exist which combine communication to DPS as well as UM as well as RD devices in a single project. Protocols may be similar enough to make a common driver desirable.

== Resources ==

* User Manual on [http://myosuploads3.banggood.com/products/20191024/20191024040658RD6006Instruction10.22.pdf banggood] and [http://www.ruidengkeji.com/inst/RD6006.pdf vendor] sites
* [https://www.youtube.com/watch?v=spqa7qy5dEE Video Review]
* [https://www.eevblog.com/forum/testgear/ruideng-riden-rd6006-dc-power-supply/ EEVblog forum thread]
* [https://github.com/Baldanos/rd6006 RD6006 Python module]
* [https://github.com/msillano/RD6006-Super-power-supply PC control and logging]
* [https://github.com/tjko/riden-flashtool Python script for updating firmware]

== See also ==

* [[Programmable power supply]]
* [[Power supply comparison]]

[[Category:Device]]
[[Category:Power supply]]
[[Category:In progress]]

RDTech RD series

2020-09-05T20:56:06Z

Karlp:

{{Infobox power supply
| image = [[File:RD6006 frontpanel.png|180px]]
| name = Riden RD6006
| status = in progress
| source_code_dir = rdtech-dps
| channels = 1
| connectivity = serial over USB/WiFi/TTL (3.3V)
| features = programmable presets, values, output, over-(voltage,current,power) thresholds.


}}

'''Please note: This page is a work in progress, more to come.'''

== Hardware ==
[[File:rd6006_detail.jpg|512px]]

* MCU: STM32F103
* U12: Gainsil GS8332 Dual Op-Amp
* U8: Winbond W25Q32JV 32MBit (4MB) SPI Flash
* U6: Fujitsu MB85RC04V 4KBit (512B) FRAM
* U1: Titan Micro TM1650 LED Driver

'''J2 Connector Pinout:'''

{{chip_8pin
|1=VDD
|2=BOOT0
|3=GND
|4=PA14 (SWCLK)
|5=PA13 (SWDIO)
}}


'''WiFi Header Pinout:''':

{{chip_8pin
|1=NC
|2=3.3V
|3=(??) EN
|4=GND
|5=NC
|6=TXD (PA9 / UART1 TXD)
|7=RXD (PA10 / UART1 RXD)
|8=VCC
}}


== Protocol ==

Modbus RTU ([https://en.wikipedia.org/wiki/Modbus#Frame_formats Wikipedia]).
Serial baudrate defaults to 115200/8n1 and Modbus slave address defaults to 1. Both can be changed in the main menu at any time. There is also an option using WiFi instead of USB/Serial, which uses a fixed Baudrate of 115200/8n1.

Also see the [[RDTech_DPS_series]] page. External sources exist which combine communication to DPS as well as UM as well as RD devices in a single project. Protocols may be similar enough to make a common driver desirable.

== Resources ==

* User Manual on [http://myosuploads3.banggood.com/products/20191024/20191024040658RD6006Instruction10.22.pdf banggood] and [http://www.ruidengkeji.com/inst/RD6006.pdf vendor] sites
* [https://www.youtube.com/watch?v=spqa7qy5dEE Video Review]
* [https://www.eevblog.com/forum/testgear/ruideng-riden-rd6006-dc-power-supply/ EEVblog forum thread]
* [https://github.com/Baldanos/rd6006 RD6006 Python module]
* [https://github.com/msillano/RD6006-Super-power-supply PC control and logging]
* [https://github.com/tjko/riden-flashtool Python script for updating firmware]

== See also ==

* [[Programmable power supply]]
* [[Power supply comparison]]

[[Category:Device]]
[[Category:Power supply]]
[[Category:In progress]]

RDTech RD series

2020-09-05T20:52:26Z

Karlp: some more parts

{{Infobox power supply
| image = [[File:RD6006 frontpanel.png|180px]]
| name = Riden RD6006
| status = in progress
| source_code_dir = rdtech-dps
| channels = 1
| connectivity = serial over USB/WiFi/TTL (3.3V)
| features = programmable presets, values, output, over-(voltage,current,power) thresholds.


}}

'''Please note: This page is a work in progress, more to come.'''

== Hardware ==
[[File:rd6006_detail.jpg|512px]]

* MCU: STM32F103
* U12: Gainsil GS8332 Dual Op-Amp
* U8: Winbond W25Q32JV 32MBit (4MB) SPI Flash
* U6: Fujitsu MB85RC04V 4KBit (512B) FRAM

'''J2 Connector Pinout:'''

{{chip_8pin
|1=VDD
|2=BOOT0
|3=GND
|4=PA14 (SWCLK)
|5=PA13 (SWDIO)
}}


'''WiFi Header Pinout:''':

{{chip_8pin
|1=NC
|2=3.3V
|3=(??) EN
|4=GND
|5=NC
|6=TXD (PA9 / UART1 TXD)
|7=RXD (PA10 / UART1 RXD)
|8=VCC
}}


== Protocol ==

Modbus RTU ([https://en.wikipedia.org/wiki/Modbus#Frame_formats Wikipedia]).
Serial baudrate defaults to 115200/8n1 and Modbus slave address defaults to 1. Both can be changed in the main menu at any time. There is also an option using WiFi instead of USB/Serial, which uses a fixed Baudrate of 115200/8n1.

Also see the [[RDTech_DPS_series]] page. External sources exist which combine communication to DPS as well as UM as well as RD devices in a single project. Protocols may be similar enough to make a common driver desirable.

== Resources ==

* User Manual on [http://myosuploads3.banggood.com/products/20191024/20191024040658RD6006Instruction10.22.pdf banggood] and [http://www.ruidengkeji.com/inst/RD6006.pdf vendor] sites
* [https://www.youtube.com/watch?v=spqa7qy5dEE Video Review]
* [https://www.eevblog.com/forum/testgear/ruideng-riden-rd6006-dc-power-supply/ EEVblog forum thread]
* [https://github.com/Baldanos/rd6006 RD6006 Python module]
* [https://github.com/msillano/RD6006-Super-power-supply PC control and logging]
* [https://github.com/tjko/riden-flashtool Python script for updating firmware]

== See also ==

* [[Programmable power supply]]
* [[Power supply comparison]]

[[Category:Device]]
[[Category:Power supply]]
[[Category:In progress]]

Linux

2020-08-25T12:21:53Z

Karlp: need to be careful with qwt for fedora, fed32 can install a qt4 version

This page describes how to build/install the sigrok subprojects on Linux.

== Binaries ==

=== Distribution packages ===

Many Linux distributions ship with sigrok packages, see [[Downloads#Binaries_and_distribution_packages|Downloads]].

If the sigrok packages in your distro are rather old, you can also use the AppImage we provide (see below).

=== AppImage ===

We provide AppImages (see [https://appimage.org appimage.org] for details) for [[sigrok-cli]] and [[PulseView]] which make it very easy and convenient to use sigrok on somewhat recent Linux distributions (most distros newer than Ubuntu 16.04 LTS (Xenial Xerus) from around 2016 should work fine).

After downloading the AppImage (see [[Downloads#Binaries_and_distribution_packages|Downloads]]) you can run it by simply making it executable and executing it, for example:

$ '''chmod u+x PulseView-NIGHTLY-x86_64.AppImage'''
$ '''./PulseView-NIGHTLY-x86_64.AppImage'''

You might need to install the libsigrok '''udev rules files''' to be able to access some devices, see [[Building#Cannot_access_USB_.2F_serial_.2F_other_device]] for details.

== Building (script, recommended) ==

The most convenient method to build all of the sigrok subprojects from source is to use the '''sigrok-cross-linux''' script from the [https://sigrok.org/gitweb/?p=sigrok-util.git;a=tree;f=cross-compile/linux sigrok-util] repo. Despite the name, this script also does native builds out of the box.

The script assumes that you have installed all requirements of all sigrok subprojects, please check [[Building#Build_requirements]] for details.

$ '''git clone git://sigrok.org/sigrok-util'''
$ '''cd sigrok-util/cross-compile/linux'''
$ '''./sigrok-cross-linux'''

This will download the current git version of all required sigrok subprojects and build them, installing the results in '''$HOME/sr'''. You may want to check out the '''README''' and/or adapt the script to your needs (e.g. if you want to install elsewhere).

You can use the files from '''$HOME/sr''' using (for example) the [[Building#Installing_to_a_non-standard_directory_using_LD_LIBRARY_PATH|LD_LIBRARY_PATH method]].

== Building (manually) ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the '''README'''/'''INSTALL''' file (of the subproject you want to build) for the full list of requirements.
</div>

=== libserialport ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
$ '''sudo pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi1-dev check doxygen python-numpy \'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 20, 21, 22, 23)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel doxygen'''

:: For C++ bindings, add '''sudo yum install glibmm24-devel'''.
:: For Python bindings, add '''sudo yum install python-devel numpy pygobject3-devel swig'''.
:: For Fedora 23, you need as well: '''redhat-rpm-config''' and note that '''libusb1-devel''' is now '''libusbx-devel'''.

'''Arch'''

$ '''sudo pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
$ '''sudo pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''sudo zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
$ '''sudo pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libboost-test-dev libboost-serialization-dev \'''
'''libboost-filesystem-dev libboost-system-dev libqt5svg5-dev qtbase5-dev'''

'''Fedora (18, 19, 23, 27)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt5-devel'''

'''Arch'''
$ '''sudo pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

==== Troubleshooting ====

See [[PulseView#Building]] for more tips and FAQs.

=== SmuView ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libboost-dev python3-dev libqt5svg5-dev qtbase5-dev \'''
'''libqwt-qt5-dev'''

'''Fedora (18, 19, 23, 27, 32)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel python3-devel qt5-devel qwt-qt5-devel'''

'''Arch'''
$ '''sudo pacman -S git gcc make cmake libtool pkgconfig glib2 boost \'''
'''python qt5 qt5-base qt5-svg qwt'''

==== Building ====

$ '''git clone https://github.com/knarfS/smuview'''
$ '''cd smuview'''
$ '''mkdir build'''
$ '''cd build'''
$ '''cmake ../'''
$ '''make'''
$ '''sudo make install'''

==== Troubleshooting ====

See [[SmuView#Building]] for more tips and FAQs.

== FAQ ==

Make sure to also see the [[Building#FAQ|Building FAQ]] for subjects that are not specific to Linux.

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

=== Required library not found ===

See [[Building#Required_library_not_found|here]].

Linux

2018-01-30T13:06:06Z

Karlp: qt5-devel not qt-devel

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
$ '''sudo pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi1-dev check doxygen python-numpy \'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 20, 21, 22, 23)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel doxygen'''

:: For C++ bindings, add '''sudo yum install glibmm24-devel'''.
:: For Python bindings, add '''sudo yum install python-devel numpy pygobject3-devel swig'''.
:: For Fedora 23, you need as well: '''redhat-rpm-config''' and note that '''libusb1-devel''' is now '''libusbx-devel'''.

'''Arch'''

$ '''sudo pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
$ '''sudo pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''sudo zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
$ '''sudo pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libboost-test-dev libboost-serialization-dev \'''
'''libboost-filesystem-dev libboost-system-dev libqt5svg5-dev qtbase5-dev'''

'''Fedora (18, 19, 23, 27)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt5-devel'''

'''Arch'''
$ '''sudo pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

'''Hint''': If something goes wrong, you can see what make is doing by running:

$ '''make VERBOSE=1'''

== FAQ ==

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Hobby Components HCTEST0006

2018-01-24T20:49:41Z

Karlp: drop template link to "lsusb output" not relevant for fx2lafw stock device

{{Infobox logic analyzer
| image = [[File:Hobby components hctest0006 mugshot.png|180px]]
| name = Hobby Components HCTEST0006
| status = supported
| source_code_dir = fx2lafw
| channels = 8
| samplerate = 24MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.5V — 5.25V
| threshold = Fixed: VIH=2.0V—5.25V, VIL=-0.5V—0.8V
| memory = none
| compression = none
| website = [http://hobbycomponents.com/test/243-hobby-components-usb-8ch-24mhz-8-channel-logic-analyser hobbycomponents.com]
}}

The '''Hobby Components HCTEST0006''' is a USB-based, 8-channel logic analyzer with up to 24MHz sampling rate.

This device ships with the [http://sigrok.org/blog/sigrok-firmware-fx2lafw-013-released official sigrok fx2lafw VID/PID] in its I²C EEPROM, thus can (only) be used with the fully open-source [[fx2lafw]] firmware and the sigrok software stack.

== Hardware ==

* '''Main chip''': Cypress CY7C68013A-56LTXI (FX2LP)
* '''Input buffer''': NXP 74HC245 (markings: "NXP HC245 ED54008 TXD449E")
* '''256-byte I²C EEPROM''': Atmel AT24C02 (markings: "ATMEL450 24C02BN SU27 D")
* '''3.3V low-dropout voltage regulator''': Advanced Monolithic Systems AMS1117-3.3 (markings: "AMS1117 3.3 H1418")
* '''24MHz crystal''': 24.000

== Photos ==

== Protocol ==

This device (only) uses the open-source [[fx2lafw]] firmware with the corresponding USB protocol.

== Resources ==

* [http://hobbycomponents.com/test/243-hobby-components-usb-8ch-24mhz-8-channel-logic-analyser Hobby Components store page]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

LabNation SmartScope

2018-01-14T21:34:51Z

Karlp: add links to my progress so far

{{Infobox logic analyzer
| image = [[File:Lab nation smartscope mugshot.png|180px]]
| name = LabNation SmartScope
| status = planned
| source_code_dir =
| channels = 8
| samplerate = 100MHz
| samplerate_state = —
| triggers = low, high, rising, falling, edge
| voltages = ?
| threshold = Fixed: VIL=0.8V, VIH=2.0V
| memory = 4Msamples (8MByte SDRAM)
| compression = ?
| website = [https://www.lab-nation.com lab-nation.com]
}}

The '''LabNation SmartScope''' is a USB-based mixed-signal oscilloscope (100 MS/s, 45MHz bandwidth), 8-channel logic analyzer (100MHz), arbitrary waveform generator / function generator.

See [[LabNation SmartScope/Info]] for some more details (such as '''lsusb -v''' output) on the device.

== Hardware ==

* '''FPGA (3840 logic cells)''': [http://www.xilinx.com/products/silicon-devices/fpga/spartan-6/lx.html Xilinx XC6SXL4] ([http://www.xilinx.com/support/documentation/data_sheets/ds160.pdf datasheet])
* '''64Mbit SDRAM''': [http://www.alliancememory.com/datasheets/AS4C4M16S.asp Alliance Memory AS4C4M16S] ([http://www.alliancememory.com/pdf/dram/64M-AS4C4M16S.pdf datasheet])
* '''Dual-channel, 8-bit, 100Msps ADC''': [http://www.maximintegrated.com/en/products/analog/data-converters/analog-to-digital-converters/MAX19506.html Maxim MAX19506] ([http://datasheets.maximintegrated.com/en/ds/MAX19506.pdf datasheet])
* '''8-bit microcontroller with full-speed USB''': [http://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en533924 Microchip PIC18F14K50] ([http://ww1.microchip.com/downloads/en/DeviceDoc/41350E.pdf datasheet])
* '''Single-pole normally-closed SOP OptoMOS relay''': [http://www.ixysic.com/Products/SSRFormB.htm Ixys CPC1125N] ([http://www.ixysic.com/home/pdfs.nsf/www/CPC1125N.pdf/$file/CPC1125N.pdf datasheet])
* '''250MHz, rail-to-rail I/O, CMOS dual opamp''': [http://www.ti.com/product/opa2354 Texas Instruments OPA2354] ([http://www.ti.com/lit/gpn/opa2354 datasheet])
* '''Quad buffer/line driver with 3-state outputs''': [http://diodes.com/catalog/standard_logic_189/74lvc126a.html Diodes Incorporated 74LVC126A] ([http://diodes.com/datasheets/74LVC126A.pdf datasheet])
* 0480000 OCP1332 1725
* 4x CGA4V
* S03A

== Photos ==

<gallery>
File:Lab nation smartscope package top.jpg|Package, top
File:Lab nation smartscope package bottom.jpg|Package, bottom
File:Lab nation smartscope package contents.jpg|Package, contents
File:Lab nation smartscope cables probes.jpg|Cables and probes
File:Lab nation smartscope p6060.jpg|P6060 probe
File:Lab nation smartscope device top.jpg|Device, top
File:Lab nation smartscope device bottom.jpg|Device, bottom
File:Lab nation smartscope device probe connector.jpg|Probe connector
File:Lab nation smartscope device connector.jpg|Misc connectors
File:Lab nation smartscope pcb top.jpg|PCB, top
File:Lab nation smartscope pcb bottom.jpg|PCB, bottom
File:Lab nation smartscope pcb analog frontend.jpg|Analog frontend
File:Lab nation smartscope xilinx spartan6 xc6slx4.jpg|Xilinx XC6SLX4
File:Lab nation smartscope alliance as4c4m16s-7tcntr.jpg|Alliance AS4C4M16S
File:Lab nation smartscope maxim max19506.jpg|Maxim MAX19506
File:Lab nation smartscope microchip pic 18lf14k50-i-ss.jpg|Microchip 18LF14K50
File:Lab nation smartscope cpc1125n.jpg|Ixys CPC1125N
File:Lab nation smartscope 74lvc126a.jpg|74LVC126A
File:Lab nation smartscope oaci 45rc.jpg|TI OPA2354
</gallery>

== Protocol ==

== Progress ==
Detection and bitstream loading implemented in libsigrok driver. Scope init and acquisition WIP in python test code.
See https://github.com/karlp/libsigrok/tree/devel/labnation

== Resources ==

* [https://www.lab-nation.com/download Vendor software]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Oscilloscope]]
[[Category:Mixed-signal oscilloscope]]
[[Category:Planned]]

Main Page

2018-01-11T20:13:16Z

Karlp: add "downloads" to the start of the downloads section.

<table width="100%" valign="top"><tr valign="top"><td width="80%">
<div style="margin-bottom:1.5em; padding:0.5em 0.5em 0.5em 0.5em; background-color:#cfdfff; align:right; border:1px solid #aabbcc;">
The '''sigrok''' project aims at creating a '''portable, cross-platform, Free/Libre/Open-Source signal analysis software suite''' that supports various device types (e.g. [[Supported hardware#Logic_analyzers|logic analyzers]], [[Supported hardware#Oscilloscopes|oscilloscopes]], and [[Supported hardware|many more]]).

It is licensed under the terms of the '''GNU GPL, version 3 or later'''. Design goals and features include:


* '''Broad hardware support'''. Supports [[Supported hardware|many different devices]] (logic analyzers, oscilloscopes, multimeters, data loggers etc.) from various vendors.
* '''Cross-platform'''. Works on [[Linux]], [[Mac OS X]], [[Windows]], [[FreeBSD]], [[OpenBSD]], [[NetBSD]], [[Android]] (and on x86, ARM, Sparc, PowerPC, ...).
* '''Scriptable protocol decoding'''. Extendable with stackable [[protocol decoders]] written in Python 3.
* '''File format support'''. Supports various [[Input output formats|input/output file formats]] (binary, ASCII, hex, CSV, gnuplot, [http://en.wikipedia.org/wiki/Value_change_dump VCD], WAV, ...).
* '''Reusable libraries'''. Consists of the [[libsigrok]] and [[libsigrokdecode]] shared libraries which can be used by various frontends/GUIs.
* '''Various frontends'''. [[PulseView]] (LA GUI), [[sigrok-meter]] (DMM GUI), [[sigrok-cli]] (command-line), and other frontends all build upon the above libraries.

</div>

<div style="clear: both;">

<div style="margin-bottom:1.5em; padding:0.5em 0.5em 0.5em 0.5em; background-color:#cfdfff; align:right; border:1px solid #aabbcc;">
'''You can use sigrok to...'''

<div style="width: 50%; float: left;">
* ...log data from your multimeter
* ...have a $10 logic analyzer for examining logic circuits
* ...have a remote GUI for your oscilloscope
* ...perform measurements on signals
* ...make sense of digital signals with protocol decoders
</div>
<div style="width: 50%; float: right;">
* ...write custom protocol decoders in python
* ...remote-control your power supply
* ...remote-control whatever lab device you'd like to support
* ...write a quick-n-dirty automation tool for your particular needs
* ...have a framework/frontend for your home-made devices
</div>
<div style="clear: both;"></div>

</div>

<div style="clear: both;">

<div style="width: 50%; float: left; margin-bottom: 1em;">
{{Box|
BORDER = #8898bf|
BACKGROUND = #d1adf6|
WIDTH = 100%|
ICON = |
HEADING = [[File:Sigrok_stone.png]] [//sigrok.org/blog News]|
CONTENT =

<rss max=3 date="Y-m-d">https://sigrok.org/blog/rss.xml</rss>
See also: [[Current events]].

}}
</div>

<div style="width: 49%; float: right; margin-bottom: 1em;">
{{Box|
BORDER = #8898bf|
BACKGROUND = lime|
WIDTH = 100%|
ICON = |
HEADING = [[File:Sigrok_stone.png]] Supported hardware ([[:Category:Device|Browse by category...]])|
CONTENT =

[[Supported_hardware#Logic_analyzers|Logic analyzers]] · [[Supported_hardware#Mixed-signal_devices|Mixed-signal devices]] · [[Supported_hardware#Oscilloscopes|Oscilloscopes]] · [[Supported_hardware#Multimeters|Multimeters]] · [[Supported_hardware#LCR meters|LCR meters]] · [[Supported_hardware#Sound_level_meters|Sound level meters]] · [[Supported_hardware#Thermometers|Thermometers]] · [[Supported_hardware#Hygrometers|Hygrometers]] · [[Supported_hardware#Anemometers|Anemometers]] · [[Supported_hardware#Light meters|Light meters]] · [[Supported_hardware#Energy meters|Energy meters]] · [[Supported_hardware#DAQs|DAQs]] · [[Supported_hardware#Dataloggers|Dataloggers]] · [[Supported_hardware#Tachometers|Tachometers]] · [[Supported_hardware#Scales|Scales]] · [[Supported_hardware#Digital_loads|Digital loads]] · [[Supported_hardware#Function_generators|Function generators]] · [[Supported_hardware#Frequency_counters|Frequency counters]] · [[Supported_hardware#RF receivers|RF receivers]] · [[Supported_hardware#Spectrum_analyzers|Spectrum analyzers]] · [[Supported_hardware#Power_supplies|Power supplies]] · [[Supported_hardware#GPIB_interfaces|GPIB interfaces]]

See also: [[:Category:Device comparison|Device comparisons]], [[Device cables]], [[Multimeter ICs]], [[Connection parameters]]

}}
</div>

</div>

<div style="clear: both;">

<div style="width: 50%; float: left; margin-bottom: 1em;">
{{Box|
BORDER = #8898bf|
BACKGROUND = cyan|
WIDTH = 100%|
ICON = |
HEADING = [[File:Sigrok_stone.png]] Downloads and documentation|
CONTENT =

[[Downloads]] · [[Building]] · [[Linux]] · [[Mac OS X]] · [[Windows]] · [[FreeBSD]] · [[OpenBSD]] · [[NetBSD]] · [[Android]] · [[Embedded]] · [[Getting started]] · [[Input output formats]] · [[Protocol decoders]] · [[Probe comparison]] · [[GPIB]] · [[Logo]] · [[Press]]

}}
</div>

<div style="width: 49%; float: right; margin-bottom: 1em;">
{{Box|
BORDER = #8898bf|
BACKGROUND = #ff3333|
WIDTH = 100%|
ICON = |
HEADING = [[File:Sigrok_stone.png]] Subprojects|
CONTENT =

[[libserialport]] · [[libsigrok]] · [[libsigrokdecode]] · [[sigrok-cli]] · [[PulseView]] · [[sigrok-meter]]  · [[fx2lafw]] · [[gpibgrok]] · [[fx2grok]] · [[fpgalafw]] · [[Firmware]] · [[Example dumps]]

}}
</div>

<div style="clear: both;">

<div style="width: 50%; float: left; margin-bottom: 1em;">
{{Box|
BORDER = #8898bf|
BACKGROUND = yellow|
WIDTH = 100%|
ICON = |
HEADING = [[File:Sigrok_stone.png]] Getting in touch|
CONTENT =

Mailing list: [https://lists.sourceforge.net/lists/listinfo/sigrok-devel sigrok-devel] (archives: [https://www.mail-archive.com/sigrok-devel@lists.sourceforge.net/ MA], [https://sourceforge.net/p/sigrok/mailman/sigrok-devel/ SF], [http://news.gmane.org/gmane.comp.debugging.sigrok.devel Gmane]) · IRC: [http://webchat.freenode.net/?channels=%23sigrok&uio=MT1mYWxzZQ9a #sigrok@freenode] · Twitter: [https://twitter.com/sigrokproject @sigrokproject] · Google+: [https://plus.google.com/communities/109843678338531936878 sigrok community]

}}
</div>

<div style="width: 49%; float: right; margin-bottom: 1em;">
{{Box|
BORDER = #8898bf|
BACKGROUND = lightblue|
WIDTH = 100%|
ICON = |
HEADING = [[File:Sigrok_stone.png]] Development|
CONTENT =

[[Developers]] · [[Roadmap]] · [//sigrok.org/api/index.html API docs] ([//sigrok.org/api/libserialport/unstable/index.html sp] · [//sigrok.org/api/libsigrok/unstable/index.html sr]/[//sigrok.org/api/libsigrok/unstable/bindings/cxx/index.html cxx]/[//sigrok.org/api/libsigrok/unstable/bindings/python/index.html py]/[//sigrok.org/api/libsigrok/unstable/bindings/java/index.html java] · [//sigrok.org/api/libsigrokdecode/unstable/index.html srd]) · [//sigrok.org/gitweb/ Browse source code] ([https://github.com/sigrokproject GitHub mirror]) · [//sigrok.org/bugzilla/ Bug tracker] · [//sigrok.org/jenkins/ Jenkins] · [[GSoC|Summer of Code]] · [[Protocol decoder HOWTO]] · [[Protocol decoder API]] · [[Formats and structures]] · [[Hardware driver API]] · [[Portability]] · [[TODO]]

}}
</div>

</div>

<div style="clear: both;margin-top: 2em;">
----

'''IMPORTANT: Unless explicitly specified otherwise, all contents in this wiki (including text and images) are released under the CC-BY-SA 3.0 license. If you don't want that, please explicitly specify another free-ish license when adding pages/images!'''

</div>
__NOTOC__
__NOEDITSECTION__

Building

2016-11-22T12:22:36Z

Karlp: /* Installing to a non-standard directory using LD_RUN_PATH */

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.1 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* libieee1284 (optional, used by some drivers)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.4.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Ruby bindings''':

* libsigrokcxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Ruby >= 1.9.3 (including development files!)
* SWIG >= 3.0.8
* YARD (optional, only needed for the Ruby API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libsigrok >= 0.4.0
* libsigrokdecode >= 0.4.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* glibmm-2.4 (>= 2.28.0)
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.55 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-serialization
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.4.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.4.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

Alternatively, you could also use '''LD_LIBRARY_PATH''', see [[Building#Installing_to_a_non-standard_directory|below]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory using LD_LIBRARY_PATH ==

See below for some hints when you want to install sigrok sub-projects into non-standard directories.

In general, you'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_LIBRARY_PATH''' when running frontends (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

You can use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TGT=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Running: <tt>'''LD_LIBRARY_PATH=/blah/wop/lib /blah/wop/bin/sigrok-cli'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT .</tt>
** Running: <tt>'''LD_LIBRARY_PATH=$TGT/lib $TGT/bin/pulseview'''</tt>
* [[sigrok-meter]]:
** <tt>'''LD_LIBRARY_PATH=$TGT/lib PYTHONPATH=$TGT/lib/python2.7/site-packages ./sigrok-meter'''</tt>
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.

== Installing to a non-standard directory using LD_RUN_PATH ==

Instead of '''LD_LIBRARY_PATH''' approach it is possible to specify library search path directly using '''LD_RUN_PATH'''.

You'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_RUN_PATH''' during linking phase (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

Use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TGT=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE .</tt>

You can use '''readelf -d elf_file | grep RPATH''' to check if RPATH was successfully set.

Building

2016-11-22T12:22:25Z

Karlp:

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.1 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* libieee1284 (optional, used by some drivers)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.4.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Ruby bindings''':

* libsigrokcxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Ruby >= 1.9.3 (including development files!)
* SWIG >= 3.0.8
* YARD (optional, only needed for the Ruby API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libsigrok >= 0.4.0
* libsigrokdecode >= 0.4.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* glibmm-2.4 (>= 2.28.0)
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.55 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-serialization
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.4.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.4.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

Alternatively, you could also use '''LD_LIBRARY_PATH''', see [[Building#Installing_to_a_non-standard_directory|below]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory using LD_LIBRARY_PATH ==

See below for some hints when you want to install sigrok sub-projects into non-standard directories.

In general, you'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_LIBRARY_PATH''' when running frontends (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

You can use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TGT=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Running: <tt>'''LD_LIBRARY_PATH=/blah/wop/lib /blah/wop/bin/sigrok-cli'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT .</tt>
** Running: <tt>'''LD_LIBRARY_PATH=$TGT/lib $TGT/bin/pulseview'''</tt>
* [[sigrok-meter]]:
** <tt>'''LD_LIBRARY_PATH=$TGT/lib PYTHONPATH=$TGT/lib/python2.7/site-packages ./sigrok-meter'''</tt>
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.

== Installing to a non-standard directory using LD_RUN_PATH ==

Instead of '''LD_LIBRARY_PATH''' approach it is possible to specify library search path directly using '''LD_RUN_PATH'''.

You'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_RUN_PATH''' during linking phase (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

Use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TG=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE .</tt>

You can use '''readelf -d elf_file | grep RPATH''' to check if RPATH was successfully set.

Building

2016-11-22T12:22:00Z

Karlp: /* Installing to a non-standard directory using LD_RUN_PATH */

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.1 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* libieee1284 (optional, used by some drivers)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.4.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Ruby bindings''':

* libsigrokcxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Ruby >= 1.9.3 (including development files!)
* SWIG >= 3.0.8
* YARD (optional, only needed for the Ruby API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libsigrok >= 0.4.0
* libsigrokdecode >= 0.4.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* glibmm-2.4 (>= 2.28.0)
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.55 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-serialization
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.4.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.4.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

Alternatively, you could also use '''LD_LIBRARY_PATH''', see [[Building#Installing_to_a_non-standard_directory|below]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory using LD_LIBRARY_PATH ==

See below for some hints when you want to install sigrok sub-projects into non-standard directories.

In general, you'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_LIBRARY_PATH''' when running frontends (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

You can use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TGT=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Running: <tt>'''LD_LIBRARY_PATH=/blah/wop/lib /blah/wop/bin/sigrok-cli'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT .</tt>
** Running: <tt>'''LD_LIBRARY_PATH=$TGT/lib $TGT/bin/pulseview'''</tt>
* [[sigrok-meter]]:
** <tt>'''LD_LIBRARY_PATH=$TGT/lib PYTHONPATH=$TGT/lib/python2.7/site-packages ./sigrok-meter'''</tt>
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.

== Installing to a non-standard directory using LD_RUN_PATH ==

Instead of '''LD_LIBRARY_PATH''' approach it is possible to specify library search path directly using '''LD_RUN_PATH'''.

You'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_RUN_PATH''' during linking phase (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

Use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.
'''TG=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE .</tt>

You can use '''readelf -d elf_file | grep RPATH''' to check if RPATH was successfully set.

Building

2016-11-22T12:21:42Z

Karlp: add variable to make copy/paste easier

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.1 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* libieee1284 (optional, used by some drivers)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.4.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Ruby bindings''':

* libsigrokcxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Ruby >= 1.9.3 (including development files!)
* SWIG >= 3.0.8
* YARD (optional, only needed for the Ruby API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libsigrok >= 0.4.0
* libsigrokdecode >= 0.4.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* glibmm-2.4 (>= 2.28.0)
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.55 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-serialization
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.4.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.4.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

Alternatively, you could also use '''LD_LIBRARY_PATH''', see [[Building#Installing_to_a_non-standard_directory|below]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory using LD_LIBRARY_PATH ==

See below for some hints when you want to install sigrok sub-projects into non-standard directories.

In general, you'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_LIBRARY_PATH''' when running frontends (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

You can use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TGT=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Running: <tt>'''LD_LIBRARY_PATH=/blah/wop/lib /blah/wop/bin/sigrok-cli'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT .</tt>
** Running: <tt>'''LD_LIBRARY_PATH=$TGT/lib $TGT/bin/pulseview'''</tt>
* [[sigrok-meter]]:
** <tt>'''LD_LIBRARY_PATH=$TGT/lib PYTHONPATH=$TGT/lib/python2.7/site-packages ./sigrok-meter'''</tt>
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.

== Installing to a non-standard directory using LD_RUN_PATH ==

Instead of '''LD_LIBRARY_PATH''' approach it is possible to specify library search path directly using '''LD_RUN_PATH'''.

You'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_RUN_PATH''' during linking phase (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

Use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.
'''TG=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=/blah/wop'''</tt>
** Building: <tt>'''LD_RUN_PATH=$TGT/lib make'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE .</tt>

You can use '''readelf -d elf_file | grep RPATH''' to check if RPATH was successfully set.

Building

2016-11-22T11:16:11Z

Karlp: /* Installing to a non-standard directory using LD_LIBRARY_PATH */

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.1 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* libieee1284 (optional, used by some drivers)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.4.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Ruby bindings''':

* libsigrokcxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Ruby >= 1.9.3 (including development files!)
* SWIG >= 3.0.8
* YARD (optional, only needed for the Ruby API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libsigrok >= 0.4.0
* libsigrokdecode >= 0.4.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* glibmm-2.4 (>= 2.28.0)
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.55 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-serialization
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.4.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.4.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

Alternatively, you could also use '''LD_LIBRARY_PATH''', see [[Building#Installing_to_a_non-standard_directory|below]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory using LD_LIBRARY_PATH ==

See below for some hints when you want to install sigrok sub-projects into non-standard directories.

In general, you'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_LIBRARY_PATH''' when running frontends (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

You can use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TGT=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGT/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Running: <tt>'''LD_LIBRARY_PATH=/blah/wop/lib /blah/wop/bin/sigrok-cli'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT .</tt>
** Running: <tt>'''LD_LIBRARY_PATH=$TGT/lib $TGT/bin/pulseview'''</tt>
* [[sigrok-meter]]:
** <tt>'''LD_LIBRARY_PATH=$TGT/lib PYTHONPATH=$TGT/lib/python2.7/site-packages ./sigrok-meter'''</tt>
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.

== Installing to a non-standard directory using LD_RUN_PATH ==

Instead of '''LD_LIBRARY_PATH''' approach it is possible to specify library search path directly using '''LD_RUN_PATH'''.

You'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_RUN_PATH''' during linking phase (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

Use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop'''</tt>
** Building: <tt>'''LD_RUN_PATH=/blah/wop/lib make'''</tt>
** Installing: <tt>'''PYTHONPATH=/blah/wop/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=/blah/wop'''</tt>
** Building: <tt>'''LD_RUN_PATH=/blah/wop/lib make'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop'''</tt>
** Building: <tt>'''LD_RUN_PATH=/blah/wop/lib make'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=/blah/wop -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE .</tt>

You can use '''readelf -d elf_file | grep RPATH''' to check if RPATH was successfully set.

Building

2016-11-22T11:15:04Z

Karlp: use a var for /blah/wop to make copy/paste easier

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.1 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* libieee1284 (optional, used by some drivers)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.4.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Ruby bindings''':

* libsigrokcxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* Ruby >= 1.9.3 (including development files!)
* SWIG >= 3.0.8
* YARD (optional, only needed for the Ruby API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.4.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libsigrok >= 0.4.0
* libsigrokdecode >= 0.4.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* glibmm-2.4 (>= 2.28.0)
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.55 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-serialization
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.4.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.4.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

Alternatively, you could also use '''LD_LIBRARY_PATH''', see [[Building#Installing_to_a_non-standard_directory|below]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory using LD_LIBRARY_PATH ==

See below for some hints when you want to install sigrok sub-projects into non-standard directories.

In general, you'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_LIBRARY_PATH''' when running frontends (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

You can use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

'''TGT=/blah/wop'''
* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Installing: <tt>'''PYTHONPATH=$TGTlib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=$TGT'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig ./configure --prefix=$TGT'''</tt>
** Running: <tt>'''LD_LIBRARY_PATH=/blah/wop/lib /blah/wop/bin/sigrok-cli'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=$TGT/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=$TGT .</tt>
** Running: <tt>'''LD_LIBRARY_PATH=$TGT/lib $TGT/bin/pulseview'''</tt>
* [[sigrok-meter]]:
** <tt>'''LD_LIBRARY_PATH=$TGT/lib PYTHONPATH=$TGT/lib/python2.7/site-packages ./sigrok-meter'''</tt>
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.

== Installing to a non-standard directory using LD_RUN_PATH ==

Instead of '''LD_LIBRARY_PATH''' approach it is possible to specify library search path directly using '''LD_RUN_PATH'''.

You'll need to use '''PKG_CONFIG_PATH''' (so that pkg-config can find all required libraries at configure-/build-time) and '''LD_RUN_PATH''' during linking phase (so that all required libraries are found at runtime). For projects that use the libsigrok Python bindings you also need to use '''PYTHONPATH'''.

Use '''--prefix''' (for autotools-using projects, i.e. almost all of them) and '''-DCMAKE_INSTALL_PREFIX''' (for cmake-using projects, i.e. [[PulseView]]) to control where the built software shall be installed.

* [[libsigrok]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop'''</tt>
** Building: <tt>'''LD_RUN_PATH=/blah/wop/lib make'''</tt>
** Installing: <tt>'''PYTHONPATH=/blah/wop/lib/python2.7/site-packages make install'''</tt>
*** The '''PYTHONPATH''' is only necessary if you're building/installing the libsigrok Python bindings.
*** You may need to adapt the '''PYTHONPATH''' above, depending on your system and on your Python version.
* [[libsigrokdecode]]:
** Configuring: <tt>'''./configure --prefix=/blah/wop'''</tt>
** Building: <tt>'''LD_RUN_PATH=/blah/wop/lib make'''</tt>
* [[sigrok-cli]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop'''</tt>
** Building: <tt>'''LD_RUN_PATH=/blah/wop/lib make'''</tt>
* [[PulseView]]:
** Configuring: <tt>'''PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig cmake -DCMAKE_INSTALL_PREFIX:PATH=/blah/wop -DCMAKE_INSTALL_RPATH_USE_LINK_PATH=TRUE .</tt>

You can use '''readelf -d elf_file | grep RPATH''' to check if RPATH was successfully set.

Linux

2016-05-23T22:27:15Z

Karlp: cleaned up fedora a little

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi-dev check doxygen python-numpy\'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 20, 21, 22, 23)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel doxygen'''

For c++ bindings, add '''sudo yum install glibmm24-devel'''
for python bindings, add '''sudo yum install python-devel numpy pygobject3-devel swig'''

For Fedora 23, you need as well: '''redhat-rpm-config''' and note that '''libusb1-devel''' is now '''libusbx-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===
==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-test-dev libboost-thread-dev\'''
'''libboost-filesystem-dev libboost-system-dev'''

'''Fedora (18, 19, 23)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel'''

'''Arch'''
# '''pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_not_found|here]].

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_is_too_old|here]].

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Linux

2016-05-23T22:10:30Z

Karlp: new weird packages on fed23

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi-dev check doxygen python-numpy\'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 20, 21, 22, 23)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel doxygen'''

For c++ bindings, add '''sudo yum install glibmm24-devel'''
for python bindings, add '''sudo yum install python-devel numpy pygobject3-devel swig'''

For Fedora 23, you need as well: '''redhat-rpm-config''' and note that '''libusb1-devel''' is now '''libusbx-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===
==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-test-dev libboost-thread-dev\'''
'''libboost-filesystem-dev libboost-system-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Arch'''
# '''pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_not_found|here]].

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_is_too_old|here]].

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Building

2015-10-13T18:04:17Z

Karlp: /* Installing to a non-standard directory */

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.0 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.3.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (for the macro AX_CXX_COMPILE_STDCXX_11; only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.24.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* libsigrok >= 0.3.0
* libsigrokdecode >= 0.3.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.42 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.3.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.3.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro not found.
--- You won't be able to build the language bindings!

That means that the m4 macro used to detect C++11 support was not found. Use the package manager of your distribution/OS to install the package that included the macro. Most distributions package this file in a package called <tt>'''autoconf-archive'''</tt> or similar.

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old.
--- (found version <version>, at least 4 is required)
--- You won't be able to build the language bindings!

That means that the version of the macro included with your distribution/OS is too old. You can:
* Download the latest version of the macro from [https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx_11.html here], and use the <tt>'''ACLOCAL_PATH'''</tt> environment variable to point aclocal to the file:
$ '''ACLOCAL_PATH=/path/to/directory/containing/macro ./autogen.sh'''
* Download the latest version of the macro and overwrite the file included with your distribution, most often located in <tt>/usr/share/aclocal</tt>.

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory ==

Hoops to jump though: (WIP)

* libsigrok: Needs pkg-config fixes: <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop</tt> FIXME - pythonpath will be wrong here if you have python bindings enabled!
* libsigrokdecode: Nothing here, just <tt>$ ./configure --prefix=/blah/wop</tt>
* sigrok-cli: Needs pkg-config fixes: <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop</tt>
* pulseview: Needs pkg-config and prefix <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig/ cmake -DCMAKE_INSTALL_PREFIX:PATH=/blah/wop ..</tt>
* sigrok-meter: needs pythonpath _and_ LD_LIBRARY_DIR: <tt>LD_LIBRARY_PATH=/blah/wop/lib PYTHONPATH=/blah/wop/lib64/python2.7/site-packages/ ./sigrok-meter

Sigrok-meter

2015-10-13T18:03:06Z

Karlp: /* Requirements */

{{DISPLAYTITLE:sigrok-meter}}
[[File:Sigrok-meter-alpha.png|thumb|right|sigrok-meter (multiple devices)]]
'''sigrok-meter''' is a special-purpose GUI for [[libsigrok]] (written in Python 3, using Qt and the libsigrok Python bindings) which supports certain classes of test & measurement devices that usually provide slowly-updating measurement values, such as multimeters (DMMs) or dataloggers.

It does specifically '''not''' support logic analyzers, oscilloscopes, and mixed-signal oscilloscopes (MSOs).

It is licensed under the terms of the '''GNU GPL, version 3 or later'''.

<div style="background-color:#ff6666">
NOTE: sigrok-meter is work in progress and is not yet suitable for everyday use!
</div>

== Status ==

There have been no official tarball releases, yet.

Distro packagers should '''not''' package this, yet.

== Requirements ==

* git
* Python (2 or 3)
* PyQt4 or PySide (both need at least the QtCore and QtGui components)
* libsigrok >= 0.3.0 (including the Python bindings)

'''Fedora (22)'''
$ '''sudo dnf install python-pyside python[2|3]-pyqtgraph'''

== Getting the code ==

$ '''git clone git://sigrok.org/sigrok-meter'''

You can also [http://sigrok.org/gitweb/?p=sigrok-meter.git;a=tree browse the source code] via gitweb.

Linux

2015-10-13T15:21:15Z

Karlp: /* Installing the requirements */

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi-dev check doxygen python-numpy\'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 20, 21, 22)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel doxygen'''

For c++ bindings, add '''sudo yum install glibmm24-devel'''
for python bindings, add '''sudo yum install python-devel numpy pygobject3-devel swig'''

'''Arch'''
# '''pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===
==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-test-dev libboost-thread-dev\'''
'''libboost-filesystem-dev libboost-system-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Arch'''
# '''pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_not_found|here]].

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_is_too_old|here]].

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Building

2015-10-13T15:16:53Z

Karlp: /* Installing to a non-standard directory */

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.0 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.3.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (for the macro AX_CXX_COMPILE_STDCXX_11; only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.24.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* libsigrok >= 0.3.0
* libsigrokdecode >= 0.3.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.42 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.3.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.3.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro not found.
--- You won't be able to build the language bindings!

That means that the m4 macro used to detect C++11 support was not found. Use the package manager of your distribution/OS to install the package that included the macro. Most distributions package this file in a package called <tt>'''autoconf-archive'''</tt> or similar.

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old.
--- (found version <version>, at least 4 is required)
--- You won't be able to build the language bindings!

That means that the version of the macro included with your distribution/OS is too old. You can:
* Download the latest version of the macro from [https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx_11.html here], and use the <tt>'''ACLOCAL_PATH'''</tt> environment variable to point aclocal to the file:
$ '''ACLOCAL_PATH=/path/to/directory/containing/macro ./autogen.sh'''
* Download the latest version of the macro and overwrite the file included with your distribution, most often located in <tt>/usr/share/aclocal</tt>.

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory ==

Hoops to jump though: (WIP)

* libsigrok: Needs pkg-config fixes: <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop</tt> FIXME - pythonpath will be wrong here if you have python bindings enabled!
* libsigrokdecode: Nothing here, just <tt>$ ./configure --prefix=/blah/wop</tt>
* sigrok-cli: Needs pkg-config fixes: <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop</tt>
* pulseview: Needs pkg-config and prefix <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig/ cmake -DCMAKE_INSTALL_PREFIX:PATH=/blah/wop ..</tt>

Mcupro Logic16 clone

2015-09-04T00:56:39Z

Karlp: clarify details on 2015 version

{{DISPLAYTITLE:mcupro Logic16 clone}}
{{Infobox logic analyzer
| image = [[File:Mcupro_Logic16_overview.png|180px]]
| name = mcupro Logic16 clone
| status = supported
| source_code_dir = saleae-logic16
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.9V — 6V
| threshold = 1.5V (operates with 3.3V logic)
| memory = none
| compression = yes
| website = [http://www.aliexpress.com/store/product/USB-Logic-Analyzer-100M-max-sample-rate-16Channels-10B-samples-MCU-ARM-FPGA-debug-tool/614202_1916810169.html aliexpress.com]
}}

The '''mcupro Logic16 clone''' is a USB-based, 16-channel logic analyzer with 100/50/32/16MHz sampling rate (at 3/6/9/16 enabled channels).

This is a clone of the [[Saleae Logic16]].

See [[mcupro Logic16 clone/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware (Actel variant) ==

* '''FPGA''': [https://www.actel.com/documents/PA3_DS.pdf Actel A3P125]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal:''' 24.000MHz

== Hardware (Cylone variant) ==

* '''FPGA''': [https://www.altera.com/products/fpga/cyclone-series/cyclone/support.html#Cyclone-Device-Handbook--All-Sections- Altera Cyclone EP1C3T100]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' 100.000MHz
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' STCMCU 15F10, 8051 compatible

== Hardware (2015-1-8 variant) ==
PCB Marked "Saleae Logic 16 By MCUPro 2015-1-8" Readily identifiable by the irregular pcb traces, and switching power supplies
This comes in a different case, identical to the [[Noname_XL-LOGIC16-100M]].
* '''FPGA''': Markings ground off
* '''USB interface chip''': Markings ground off, but presumably a Cypress FX2 like all others. [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': Markings ground off
* '''3.3V voltage regulator''': Unrecognized switcher in sot23-5 (Seems to be 3.8V?!)
* '''1.5V voltage regulator''': Unrecognised switcher in sot23-5
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' Looks like 32Mhz?
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' Not required?

== Photos (Actel) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro_Logic16_top.jpeg|PCB, top
File:Mcupro_Logic16_bottom.jpeg|PCB, bottom
</gallery>

== Photos (Cyclone) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro Logic16 Variant2 top.jpg|PCB with Altera Cyclone, top
File:IMG 0207 v1.JPG|PCB with Altera Cyclone, bottom
File:Mcupro Logic16 Variant2 top flash+uC.jpg|PCB, top, 1MBit flash and STCMCU uC
</gallery>

== Photos (2015-1-8 variant) ==

<gallery>
File:Xl-logic16-100m-external.jpg|Device, top
File:Mcupro-2015-1-8-top-overview.jpg|PCB, top
File:Mcupro-2015-1-8-bottom-overview.jpg|PCB, bottom
</gallery>

== Protocol ==

See [[Saleae_Logic16#Protocol]].

== Firmware ==

;Alcatel variant
: This logic analyzer works with unmodified Saleae software. The Actel FPGA has on-chip flash storage, so it only requires an upload of Cypress FX2LP firmware in order to operate.
;Cyclone variant
: This logic analyzer works with unmodified Saleae software. The PCB contains a serial flash chip, so it only requires an upload of Cypress FX2LP firmware in order to operate.
;2015-1-8 variant
: Only requires an upload of Cypress FX2LP firmware to operate. Opensource binaries from [https://github.com/gregani/la16fw] work, but must be renamed to '''saleae-logic16-fx2.fw'''

The firmware extraction steps are identical to [[Saleae_Logic16#Firmware|steps for Saleae Logic16]], however you only need to have '''saleae-logic16-fx2.fw''' installed.

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

Noname XL-LOGIC16-100M

2015-09-03T22:36:10Z

Karlp:

{{Infobox logic analyzer
| image = [[File:Noname xl logic16 100m mugshot.png|180px]]
| name = Noname XL-LOGIC16-100M
| status = in progress
| source_code_dir = saleae-logic16
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.9V — 6V
| threshold = configurable: for 1.8V to 3.6V systems: VIH=1.4V, VIL=0.7V for 5V systems: VIH=3.6V, VIL=1.4V
| memory = none
| compression = yes
| website = [http://www.aliexpress.com/item/Free-Shipping-Saleae-24MHz-8Channels-Logic-Analyzer-Fully-Checked-Best-quality-Input-buffered/1731200392.html aliexpress.com]
}}

The '''Noname XL-LOGIC16-100M''' is a USB-based, 16-channel logic analyzer with up to 100MHz sampling rate.

It is labelled and sold as a [[Saleae Logic16]] clone, and comes with "modified" Saleae Logic software on a CD-ROM.

See [[Noname XL-LOGIC16-100M/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Variants in same case ==
The 2015-1-8 version of the [[Mcupro_Logic16_clone]] comes in the same case as this device. Unlike this device, the mcupro version works with sigrok!

== Hardware ==

A single Phillips head screw holds the case together. Most notable are the complete lack of test points or programming headers! There are some unpopulated resistor/capacitor pairs on the backside.

* '''FPGA''': [http://www.xilinx.com/support/index.html/content/xilinx/en/supportNav/silicon_devices/fpga/spartan-3a.html Xilinx Spartan-3A XC3S200A], 200K gates ([http://www.xilinx.com/support/documentation/data_sheets/ds529.pdf datasheeet])
* '''USB interface chip''': [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A-56PVXC (FX2LP)] ([http://www.cypress.com/?docID=34060 datasheet])
* '''I2C EEPROM''': 2Kbit [http://www.atmel.com/devices/AT24C02B.aspx Atmel 24C02B] (markings: "ATMEL317 24C02BN SU27 D") ([http://www.atmel.com/Images/doc5126.pdf datasheet])
* '''16-Bit 2.5V to 3.3V/3.3V to 5V level shifting transceiver with 3-state outputs''': [http://www.ti.com/product/SN74ALVC164245 TI SN74ALVC164245] ([http://www.ti.com/lit/gpn/sn74alvc164245 datasheet])
* '''3.3V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-3.3] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''1.2V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-1.2] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''Crystal:''' 24.000

Three LEDs (USB/green, COM/blue, and RUN/red) are on the board.

== Photos ==

<gallery>
File:Noname xl logic16 100m package.jpg
File:Noname xl logic16 100m device top.jpg
File:Noname xl logic16 100m device bottom.jpg
File:Noname xl logic16 100m device usb.jpg
File:Noname xl logic16 100m device connector.jpg
File:Noname xl logic16 100m pcb top.jpg
File:Noname xl logic16 100m pcb bottom.jpg
File:Noname xl logic16 100m xilinx spartan xc3s200a.jpg
File:Noname xl logic16 100m cypress fx2lp.jpg
File:Noname xl logic16 100m ti alvc164245.jpg
File:Noname xl logic16 100m atmel 24c02bn.jpg
File:Noname xl logic16 100m v05.jpg
File:Noname xl logic16 100m ams1117 33.jpg
File:Noname xl logic16 100m ams1117 12.jpg
</gallery>

'''Photos from another unit:'''

<gallery>
File:xl-logic16-100m-external.jpg
File:xl-logic16-100m-pcb-top.jpg
File:xl-logic16-100m-pcb-bottom.jpg
</gallery>

'''Photos from yet another unit (with JTAG and other resistor values):'''

<gallery>
File:Xl-logic16-100m-v2-external.jpg
File:Xl-logic16-100m-v2-top.jpg
File:Xl-logic16-100m-v2-bottom.jpg
</gallery>

'''Photos from yet another unit (with black case):'''

<gallery>
File:Xl logic16 100m black device top.jpg
File:Xl logic16 100m black pcb top.jpg
File:Xl logic16 100m black pcb bottom.jpg
</gallery>

== Firmware ==

You can use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=tree;f=firmware/saleae-logic16 sigrok-fwextract-saleae-logic16] tool to extract (from the "Logic" Linux binary) the FX2 firmware and the FPGA bitstreams, exactly [[Saleae Logic16|as for a real Saleae Logic16]]. Note, the md5sum of the FX2 firmware is identical to the original Saleae firmware, but the FPGA bitstreams are different. Attempting to connect to this device with the "modified" FPGA bitstream, which _works_ with the vendor supplied "modified" Logic software fails to load in sigrok, with a FPGA version mismatch. The FX2 firmware loads successfully, at least in as much as the LED blinks a heartbeat pattern as expected.

Update: July 4, 2015: marcus_c has written some open source fpga bitstream for spartan based logic16s, and _this_ bitstream does work with this device. However, at this time, binaries are not available. See [https://github.com/zeldin/logic16_bitstream] for the source.
Update: September 3, 2015 blight has an alternative open source fpga bitstream. It also works. See [https://github.com/gregani/la16fw] for both source and binaries

== Protocol ==

See [[Saleae Logic16#Protocol]].

== Resources ==

* Random aliexpress.com vendors: [http://www.aliexpress.com/item/Free-Shipping-Saleae-24MHz-8Channels-Logic-Analyzer-Fully-Checked-Best-quality-Input-buffered/1731200392.html vendor1], [http://www.aliexpress.com/item/Saleae-logic16-USB-100MHz-Real-Time-Logic-Analyzers/1856825810.html vendor2]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Planned]]

Noname XL-LOGIC16-100M

2015-07-04T10:36:33Z

Karlp: move to in progress, marcus_c's logic16 fpga bitstream works with this device

{{Infobox logic analyzer
| image = [[File:Noname xl logic16 100m mugshot.png|180px]]
| name = Noname XL-LOGIC16-100M
| status = in progress
| source_code_dir = saleae-logic16
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.9V — 6V
| threshold = configurable: for 1.8V to 3.6V systems: VIH=1.4V, VIL=0.7V for 5V systems: VIH=3.6V, VIL=1.4V
| memory = none
| compression = yes
| website = [http://www.aliexpress.com/item/Free-Shipping-Saleae-24MHz-8Channels-Logic-Analyzer-Fully-Checked-Best-quality-Input-buffered/1731200392.html aliexpress.com]
}}

The '''Noname XL-LOGIC16-100M''' is a USB-based, 16-channel logic analyzer with up to 100MHz sampling rate.

It is labelled and sold as a [[Saleae Logic16]] clone, and comes with "modified" Saleae Logic software on a CD-ROM.

See [[Noname XL-LOGIC16-100M/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Variants in same case ==
The 2015-1-8 version of the [[Mcupro_Logic16_clone]] comes in the same case as this device. Unlike this device, the mcupro version works with sigrok!

== Hardware ==

A single Phillips head screw holds the case together. Most notable are the complete lack of test points or programming headers! There are some unpopulated resistor/capacitor pairs on the backside.

* '''FPGA''': [http://www.xilinx.com/support/index.html/content/xilinx/en/supportNav/silicon_devices/fpga/spartan-3a.html Xilinx Spartan-3A XC3S200A], 200K gates ([http://www.xilinx.com/support/documentation/data_sheets/ds529.pdf datasheeet])
* '''USB interface chip''': [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A-56PVXC (FX2LP)] ([http://www.cypress.com/?docID=34060 datasheet])
* '''I2C EEPROM''': 2Kbit [http://www.atmel.com/devices/AT24C02B.aspx Atmel 24C02B] (markings: "ATMEL317 24C02BN SU27 D") ([http://www.atmel.com/Images/doc5126.pdf datasheet])
* '''16-Bit 2.5V to 3.3V/3.3V to 5V level shifting transceiver with 3-state outputs''': [http://www.ti.com/product/SN74ALVC164245 TI SN74ALVC164245] ([http://www.ti.com/lit/gpn/sn74alvc164245 datasheet])
* '''3.3V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-3.3] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''1.2V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-1.2] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''Crystal:''' 24.000

Three LEDs (USB/green, COM/blue, and RUN/red) are on the board.

== Photos ==

<gallery>
File:Noname xl logic16 100m package.jpg
File:Noname xl logic16 100m device top.jpg
File:Noname xl logic16 100m device bottom.jpg
File:Noname xl logic16 100m device usb.jpg
File:Noname xl logic16 100m device connector.jpg
File:Noname xl logic16 100m pcb top.jpg
File:Noname xl logic16 100m pcb bottom.jpg
File:Noname xl logic16 100m xilinx spartan xc3s200a.jpg
File:Noname xl logic16 100m cypress fx2lp.jpg
File:Noname xl logic16 100m ti alvc164245.jpg
File:Noname xl logic16 100m atmel 24c02bn.jpg
File:Noname xl logic16 100m v05.jpg
File:Noname xl logic16 100m ams1117 33.jpg
File:Noname xl logic16 100m ams1117 12.jpg
</gallery>

'''Photos from another unit:'''

<gallery>
File:xl-logic16-100m-external.jpg
File:xl-logic16-100m-pcb-top.jpg
File:xl-logic16-100m-pcb-bottom.jpg
</gallery>

'''Photos from yet another unit (with JTAG and other resistor values):'''

<gallery>
File:Xl-logic16-100m-v2-external.jpg
File:Xl-logic16-100m-v2-top.jpg
File:Xl-logic16-100m-v2-bottom.jpg
</gallery>

'''Photos from yet another unit (with black case):'''

<gallery>
File:Xl logic16 100m black device top.jpg
File:Xl logic16 100m black pcb top.jpg
File:Xl logic16 100m black pcb bottom.jpg
</gallery>

== Firmware ==

You can use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=tree;f=firmware/saleae-logic16 sigrok-fwextract-saleae-logic16] tool to extract (from the "Logic" Linux binary) the FX2 firmware and the FPGA bitstreams, exactly [[Saleae Logic16|as for a real Saleae Logic16]]. Note, the md5sum of the FX2 firmware is identical to the original Saleae firmware, but the FPGA bitstreams are different. Attempting to connect to this device with the "modified" FPGA bitstream, which _works_ with the vendor supplied "modified" Logic software fails to load in sigrok, with a FPGA version mismatch. The FX2 firmware loads successfully, at least in as much as the LED blinks a heartbeat pattern as expected.

Update: July 4, 2015: marcus_c has written some open source fpga bitstream for spartan based logic16s, and _this_ bitstream does work with this device. However, at this time, binaries are not available. See [https://github.com/zeldin/logic16_bitstream] for the source.

== Protocol ==

See [[Saleae Logic16#Protocol]].

== Resources ==

* Random aliexpress.com vendors: [http://www.aliexpress.com/item/Free-Shipping-Saleae-24MHz-8Channels-Logic-Analyzer-Fully-Checked-Best-quality-Input-buffered/1731200392.html vendor1], [http://www.aliexpress.com/item/Saleae-logic16-USB-100MHz-Real-Time-Logic-Analyzers/1856825810.html vendor2]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Planned]]

Protocol decoder:Mrf24j40

2015-07-02T15:44:03Z

Karlp: adding a pic of my own board per uwe's request

{{Infobox protocol decoder
| id = mrf24j40
| name = MRF24J40
| description = IEEE 802.15.4 2.4 GHz RF tranceiver chip
| status = supported
| license = GPLv2+
| source_code_dir = mrf24j40
| image =
| input = [[Protocol Decoder:spi|spi]]
| output = mrf24j40
| probes = —
| optional_probes = —
| options = —
}}

The '''mrf24j40''' protocol decoder decodes the [https://www.microchip.com/wwwproducts/Devices.aspx?dDocName=en027752 Microchip MRF24J40] IEEE 802.15.4 2.4 GHz RF tranceiver chip protocol.

== Hardware ==

See the [http://sigrok.org/gitweb/?p=sigrok-dumps.git;a=tree;f=spi/mrf24j40 spi/mrf24j40] directory for example capture files.

The radio itself is often used on modules, the MRF24J40MA and MB modules. They're lower level than an xbee, being radio only, but they are on 2.54mm pitch header pins, and are less than half the price. An example is shown below.

[[File:Mrf24j40-boxcar.jpg|500px]]

== Protocol ==

== Resources ==

* [http://ww1.microchip.com/downloads/en/DeviceDoc/39776C.pdf Datasheet]

[[Category:Protocol decoder]]
[[Category:SPI]]

File:Mrf24j40-boxcar.jpg

2015-07-02T15:40:38Z

Karlp: mrf24j40ma module mounted on a "boxcar" v4 prototype board https://github.com/karlp/karlnet/blob/master/nodes/boxcar

== Summary ==
mrf24j40ma module mounted on a "boxcar" v4 prototype board

https://github.com/karlp/karlnet/blob/master/nodes/boxcar
== Licensing ==
{{PD}}

Mcupro Logic16 clone

2015-06-07T20:55:26Z

Karlp: add pcb pics for 2015-1-8 version

{{DISPLAYTITLE:mcupro Logic16 clone}}
{{Infobox logic analyzer
| image = [[File:Mcupro_Logic16_overview.png|180px]]
| name = mcupro Logic16 clone
| status = supported
| source_code_dir = saleae-logic16
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.9V — 6V
| threshold = 1.5V (operates with 3.3V logic)
| memory = none
| compression = yes
| website = [http://www.aliexpress.com/store/product/USB-Logic-Analyzer-100M-max-sample-rate-16Channels-10B-samples-MCU-ARM-FPGA-debug-tool/614202_1916810169.html aliexpress.com]
}}

The '''mcupro Logic16 clone''' is a USB-based, 16-channel logic analyzer with 100/50/32/16MHz sampling rate (at 3/6/9/16 enabled channels).

This is a clone of the [[Saleae Logic16]].

See [[mcupro Logic16 clone/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware (Actel variant) ==

* '''FPGA''': [https://www.actel.com/documents/PA3_DS.pdf Actel A3P125]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal:''' 24.000MHz

== Hardware (Cylone variant) ==

* '''FPGA''': [https://www.altera.com/products/fpga/cyclone-series/cyclone/support.html#Cyclone-Device-Handbook--All-Sections- Altera Cyclone EP1C3T100]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' 100.000MHz
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' STCMCU 15F10, 8051 compatible

== Hardware (2015-1-8 variant) ==
PCB Marked "Saleae Logic 16 By MCUPro 2015-1-8" Readily identifiable by the irregular pcb traces, and switching power supplies
This comes in a different case, identical to the [[Noname_XL-LOGIC16-100M]].
* '''FPGA''': Markings ground off
* '''USB interface chip''': Markings ground off, but presumably a Cypress FX2 like all others. [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': Markings ground off
* '''3.3V voltage regulator''': Unrecognized switcher in sot23-5 (Seems to be 3.8V?!)
* '''1.5V voltage regulator''': Unrecognised switcher in sot23-5
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' Looks like 32Mhz?
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' Not required?

== Photos (Actel) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro_Logic16_top.jpeg|PCB, top
File:Mcupro_Logic16_bottom.jpeg|PCB, bottom
</gallery>

== Photos (Cyclone) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro Logic16 Variant2 top.jpg|PCB with Altera Cyclone, top
File:IMG 0207 v1.JPG|PCB with Altera Cyclone, bottom
File:Mcupro Logic16 Variant2 top flash+uC.jpg|PCB, top, 1MBit flash and STCMCU uC
</gallery>

== Photos (2015-1-8 variant) ==

<gallery>
File:Xl-logic16-100m-external.jpg|Device, top
File:Mcupro-2015-1-8-top-overview.jpg|PCB, top
File:Mcupro-2015-1-8-bottom-overview.jpg|PCB, bottom
</gallery>

== Protocol ==

See [[Saleae_Logic16#Protocol]].

== Firmware ==

;Alcatel variant
: This logic analyzer works with unmodified Saleae software. The Actel FPGA has on-chip flash storage, so it only requires an upload of Cypress FX2LP firmware in order to operate.
;Cyclone variant
: This logic analyzer works with unmodified Saleae software. The PCB contains a serial flash chip, so it only requires an upload of Cypress FX2LP firmware in order to operate.

The firmware extraction steps are identical to [[Saleae_Logic16#Firmware|steps for Saleae Logic16]], however you only need to have '''saleae-logic16-fx2.fw''' installed.

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

File:Mcupro-2015-1-8-bottom-overview.jpg

2015-06-07T20:44:01Z

Karlp:

== Licensing ==
{{PD}}

File:Mcupro-2015-1-8-top-overview.jpg

2015-06-07T20:41:38Z

Karlp:

== Licensing ==
{{PD}}

Noname XL-LOGIC16-100M

2015-06-06T00:52:54Z

Karlp:

{{Infobox logic analyzer
| image = [[File:Noname xl logic16 100m mugshot.png|180px]]
| name = Noname XL-LOGIC16-100M
| status = planned
| source_code_dir = saleae-logic16
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.9V — 6V
| threshold = configurable: for 1.8V to 3.6V systems: VIH=1.4V, VIL=0.7V for 5V systems: VIH=3.6V, VIL=1.4V
| memory = none
| compression = yes
| website = [http://www.aliexpress.com/item/Free-Shipping-Saleae-24MHz-8Channels-Logic-Analyzer-Fully-Checked-Best-quality-Input-buffered/1731200392.html aliexpress.com]
}}

The '''Noname XL-LOGIC16-100M''' is a USB-based, 16-channel logic analyzer with up to 100MHz sampling rate.

It is labelled and sold as a [[Saleae Logic16]] clone, and comes with "modified" Saleae Logic software on a CD-ROM.

See [[Noname XL-LOGIC16-100M/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Variants in same case ==
The 2015-1-8 version of the [[Mcupro_Logic16_clone]] comes in the same case as this device. Unlike this device, the mcupro version works with sigrok!

== Hardware ==

A single Phillips head screw holds the case together. Most notable are the complete lack of test points or programming headers! There are some unpopulated resistor/capacitor pairs on the backside.

* '''FPGA''': [http://www.xilinx.com/support/index.html/content/xilinx/en/supportNav/silicon_devices/fpga/spartan-3a.html Xilinx Spartan-3A XC3S200A], 200K gates ([http://www.xilinx.com/support/documentation/data_sheets/ds529.pdf datasheeet])
* '''USB interface chip''': [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A-56PVXC (FX2LP)] ([http://www.cypress.com/?docID=34060 datasheet])
* '''I2C EEPROM''': 2Kbit [http://www.atmel.com/devices/AT24C02B.aspx Atmel 24C02B] (markings: "ATMEL317 24C02BN SU27 D") ([http://www.atmel.com/Images/doc5126.pdf datasheet])
* '''16-Bit 2.5V to 3.3V/3.3V to 5V level shifting transceiver with 3-state outputs''': [http://www.ti.com/product/SN74ALVC164245 TI SN74ALVC164245] ([http://www.ti.com/lit/gpn/sn74alvc164245 datasheet])
* '''3.3V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-3.3] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''1.2V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-1.2] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''Crystal:''' 24.000

Three LEDs (USB/green, COM/blue, and RUN/red) are on the board.

== Photos ==

<gallery>
File:Noname xl logic16 100m package.jpg
File:Noname xl logic16 100m device top.jpg
File:Noname xl logic16 100m device bottom.jpg
File:Noname xl logic16 100m device usb.jpg
File:Noname xl logic16 100m device connector.jpg
File:Noname xl logic16 100m pcb top.jpg
File:Noname xl logic16 100m pcb bottom.jpg
File:Noname xl logic16 100m xilinx spartan xc3s200a.jpg
File:Noname xl logic16 100m cypress fx2lp.jpg
File:Noname xl logic16 100m ti alvc164245.jpg
File:Noname xl logic16 100m atmel 24c02bn.jpg
File:Noname xl logic16 100m v05.jpg
File:Noname xl logic16 100m ams1117 33.jpg
File:Noname xl logic16 100m ams1117 12.jpg
</gallery>

'''Photos from another unit:'''

<gallery>
File:xl-logic16-100m-external.jpg
File:xl-logic16-100m-pcb-top.jpg
File:xl-logic16-100m-pcb-bottom.jpg
</gallery>

'''Photos from yet another unit (with JTAG and other resistor values):'''

<gallery>
File:Xl-logic16-100m-v2-external.jpg
File:Xl-logic16-100m-v2-top.jpg
File:Xl-logic16-100m-v2-bottom.jpg
</gallery>

'''Photos from yet another unit (with black case):'''

<gallery>
File:Xl logic16 100m black device top.jpg
File:Xl logic16 100m black pcb top.jpg
File:Xl logic16 100m black pcb bottom.jpg
</gallery>

== Firmware ==

You can use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=tree;f=firmware/saleae-logic16 sigrok-fwextract-saleae-logic16] tool to extract (from the "Logic" Linux binary) the FX2 firmware and the FPGA bitstreams, exactly [[Saleae Logic16|as for a real Saleae Logic16]]. Note, the md5sum of the FX2 firmware is identical to the original Saleae firmware, but the FPGA bitstreams are different. Attempting to connect to this device with the "modified" FPGA bitstream, which _works_ with the vendor supplied "modified" Logic software fails to load in sigrok, with a FPGA version mismatch. The FX2 firmware loads successfully, at least in as much as the LED blinks a heartbeat pattern as expected.

== Protocol ==

See [[Saleae Logic16#Protocol]].

== Resources ==

* Random aliexpress.com vendors: [http://www.aliexpress.com/item/Free-Shipping-Saleae-24MHz-8Channels-Logic-Analyzer-Fully-Checked-Best-quality-Input-buffered/1731200392.html vendor1], [http://www.aliexpress.com/item/Saleae-logic16-USB-100MHz-Real-Time-Logic-Analyzers/1856825810.html vendor2]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Planned]]

Mcupro Logic16 clone

2015-06-06T00:51:18Z

Karlp:

{{DISPLAYTITLE:mcupro Logic16 clone}}
{{Infobox logic analyzer
| image = [[File:Mcupro_Logic16_overview.png|180px]]
| name = mcupro Logic16 clone
| status = supported
| source_code_dir = saleae-logic16
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.9V — 6V
| threshold = 1.5V (operates with 3.3V logic)
| memory = none
| compression = yes
| website = [http://www.aliexpress.com/store/product/USB-Logic-Analyzer-100M-max-sample-rate-16Channels-10B-samples-MCU-ARM-FPGA-debug-tool/614202_1916810169.html aliexpress.com]
}}

The '''mcupro Logic16 clone''' is a USB-based, 16-channel logic analyzer with 100/50/32/16MHz sampling rate (at 3/6/9/16 enabled channels).

This is a clone of the [[Saleae Logic16]].

See [[mcupro Logic16 clone/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware (Actel variant) ==

* '''FPGA''': [https://www.actel.com/documents/PA3_DS.pdf Actel A3P125]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal:''' 24.000MHz

== Hardware (Cylone variant) ==

* '''FPGA''': [https://www.altera.com/products/fpga/cyclone-series/cyclone/support.html#Cyclone-Device-Handbook--All-Sections- Altera Cyclone EP1C3T100]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' 100.000MHz
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' STCMCU 15F10, 8051 compatible

== Hardware (2015-1-8 variant) ==
PCB Marked "Saleae Logic 16 By MCUPro 2015-1-8" Readily identifiable by the irregular pcb traces, and switching power supplies
This comes in a different case, identical to the [[Noname_XL-LOGIC16-100M]].
* '''FPGA''': Markings ground off
* '''USB interface chip''': Markings ground off, but presumably a Cypress FX2 like all others. [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': Markings ground off
* '''3.3V voltage regulator''': Unrecognized switcher in sot23-5
* '''1.5V voltage regulator''': Unrecognised switcher in sot23-5
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' Looks like 32Mhz?
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' Not required?

== Photos (Actel) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro_Logic16_top.jpeg|PCB, top
File:Mcupro_Logic16_bottom.jpeg|PCB, bottom
</gallery>

== Photos (Cyclone) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro Logic16 Variant2 top.jpg|PCB with Altera Cyclone, top
File:IMG 0207 v1.JPG|PCB with Altera Cyclone, bottom
File:Mcupro Logic16 Variant2 top flash+uC.jpg|PCB, top, 1MBit flash and STCMCU uC
</gallery>

== Protocol ==

See [[Saleae_Logic16#Protocol]].

== Firmware ==

;Alcatel variant
: This logic analyzer works with unmodified Saleae software. The Actel FPGA has on-chip flash storage, so it only requires an upload of Cypress FX2LP firmware in order to operate.
;Cyclone variant
: This logic analyzer works with unmodified Saleae software. The PCB contains a serial flash chip, so it only requires an upload of Cypress FX2LP firmware in order to operate.

The firmware extraction steps are identical to [[Saleae_Logic16#Firmware|steps for Saleae Logic16]], however you only need to have '''saleae-logic16-fx2.fw''' installed.

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

Mcupro Logic16 clone

2015-06-06T00:49:28Z

Karlp: mcu pro 2015 version, first notes

{{DISPLAYTITLE:mcupro Logic16 clone}}
{{Infobox logic analyzer
| image = [[File:Mcupro_Logic16_overview.png|180px]]
| name = mcupro Logic16 clone
| status = supported
| source_code_dir = saleae-logic16
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = none (SW-only)
| voltages = -0.9V — 6V
| threshold = 1.5V (operates with 3.3V logic)
| memory = none
| compression = yes
| website = [http://www.aliexpress.com/store/product/USB-Logic-Analyzer-100M-max-sample-rate-16Channels-10B-samples-MCU-ARM-FPGA-debug-tool/614202_1916810169.html aliexpress.com]
}}

The '''mcupro Logic16 clone''' is a USB-based, 16-channel logic analyzer with 100/50/32/16MHz sampling rate (at 3/6/9/16 enabled channels).

This is a clone of the [[Saleae Logic16]].

See [[mcupro Logic16 clone/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware (Actel variant) ==

* '''FPGA''': [https://www.actel.com/documents/PA3_DS.pdf Actel A3P125]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal:''' 24.000MHz

== Hardware (Cylone variant) ==

* '''FPGA''': [https://www.altera.com/products/fpga/cyclone-series/cyclone/support.html#Cyclone-Device-Handbook--All-Sections- Altera Cyclone EP1C3T100]
* '''USB interface chip''': [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': [http://www.atmel.com/Images/doc3256.pdf Atmel 24C02N]
* '''3.3V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-3.3]
* '''1.5V voltage regulator''': [http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf Advanced Monolithic Systems AMS1117-1.5]
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' 100.000MHz
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' STCMCU 15F10, 8051 compatible

== Hardware (2015-1-8 variant) ==
PCB Marked "Saleae Logic 16 By MCUPro 2015-1-8" Readily identifiable by the irregular pcb traces, and switching power supplies
This comes in a different case, identical to the [Noname_XL-LOGIC16-100M].
* '''FPGA''': Markings ground off
* '''USB interface chip''': Markings ground off, but presumably a Cypress FX2 like all others. [http://www.cypress.com/?docID=45142 Cypress CY7C68013A]
* '''I2C EEPROM''': Markings ground off
* '''3.3V voltage regulator''': Unrecognized switcher in sot23-5
* '''1.5V voltage regulator''': Unrecognised switcher in sot23-5
* '''Crystal (FX2):''' 24.000MHz
* '''Crystal (FPGA):''' Looks like 32Mhz?
* '''FPGA Bitstream''' 25P10 1MBit SPI NOR flash, ST Microelectronics
* '''Bootstrap Controller''' Not required?

== Photos (Actel) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro_Logic16_top.jpeg|PCB, top
File:Mcupro_Logic16_bottom.jpeg|PCB, bottom
</gallery>

== Photos (Cyclone) ==

<gallery>
File:Mcupro_Logic16_case_top.jpeg|Device, top
File:Mcupro_Logic16_case_bottom.jpeg|Device, bottom
File:Mcupro Logic16 Variant2 top.jpg|PCB with Altera Cyclone, top
File:IMG 0207 v1.JPG|PCB with Altera Cyclone, bottom
File:Mcupro Logic16 Variant2 top flash+uC.jpg|PCB, top, 1MBit flash and STCMCU uC
</gallery>

== Protocol ==

See [[Saleae_Logic16#Protocol]].

== Firmware ==

;Alcatel variant
: This logic analyzer works with unmodified Saleae software. The Actel FPGA has on-chip flash storage, so it only requires an upload of Cypress FX2LP firmware in order to operate.
;Cyclone variant
: This logic analyzer works with unmodified Saleae software. The PCB contains a serial flash chip, so it only requires an upload of Cypress FX2LP firmware in order to operate.

The firmware extraction steps are identical to [[Saleae_Logic16#Firmware|steps for Saleae Logic16]], however you only need to have '''saleae-logic16-fx2.fw''' installed.

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

Protocol decoders

2015-05-30T22:45:11Z

Karlp: add RHTxx naming

This is a list of '''supported protocol decoders (PDs)''' and '''decoders which we might want to write in the future''' (or users might want to contribute).

See [[Protocol decoder API]] for details on how the decoders work in sigrok, and [[Protocol decoder HOWTO]] for a quick introduction about how to write your own decoders.

== Supported protocol decoders ==

Number of currently supported protocol decoders: '''49'''.

{| border="0" style="font-size: smaller" class="alternategrey sortable sigroktable"
|-
!Protocol
!Category
!Input IDs
!Output IDs
!Status
!Full name
!Description

{{pd|am230x|AM230x/DHTxx/RHTxx|Aosong AM230x/DHTxx|Aosong AM230x/DHTxx/RHTxx humidity/temperature sensor protocol.|Sensors|—|am230x|supported}}
{{pd|arm_etmv3|ARM ETMv3|ARM Embedded Trace Macroblock|Decode ETM instruction trace packets.|Flash/debug|uart|arm_etmv3|supported}}
{{pd|arm_itm|ARM ITM|ARM Instrumentation Trace Macroblock|Trace data from Cortex-M / ARMv7m ITM module.|Flash/debug|uart|arm_itm|supported}}
{{pd|arm_tpiu|ARM TPIU|ARM Trace Port Interface Unit|Filter TPIU formatted trace data into separate streams.|Flash/debug|uart|uart|supported}}
{{pd|avr_isp|AVR ISP|AVR in-system programming|Protocol for in-system programming Atmel AVR MCUs.|Flash/debug|spi|avr_isp|supported}}
{{pd|can|CAN|Controller Area Network|Field bus protocol for distributed realtime control.|Automotive|—|can|supported}}
{{pd|dcf77|DCF77|DCF77 time protocol|European longwave time signal (77.5kHz carrier signal).|Time signal|—|dcf77|supported}}
{{pd|ds1307|DS1307|Dallas DS1307|Realtime clock module protocol.|RTC|i2c|ds1307|supported}}
{{pd|edid|EDID|Extended Display Identification Data|Data structure describing display device capabilities.|PC|i2c|edid|supported}}
{{pd|eeprom24xx|24xx EEPROM|24xx I²C EEPROM|24xx series I²C EEPROM protocol.|Memory|i2c|eeprom24xx|supported}}
{{pd|guess_bitrate|Guess bitrate|Guess bitrate/baudrate|Guess the bitrate/baudrate of a UART (or other) protocol.|Other|—|guess_bitrate|supported}}
{{pd|i2c|I2C|Inter-Integrated Circuit|Two-wire, multi-master, serial bus.|Embedded|—|i2c|supported}}
{{pd|i2cdemux|I2C demux|I2C demultiplexer|Demux I2C packets into per-slave-address streams.|Embedded|i2c|''runtime decision''|supported}}
{{pd|i2cfilter|I2C filter|I2C filter|Filter out addresses/directions in an I2C stream.|Embedded|i2c|i2c|supported}}
{{pd|i2s|I2S|Integrated Interchip Sound|Serial bus for connecting digital audio devices.|Audio|—|i2s|supported}}
{{pd|ir_nec|IR NEC|IR NEC|NEC infrared remote control protocol.|IR|—|ir_nec|supported}}
{{pd|ir_rc5|IR RC-5|IR RC-5|RC-5 infrared remote control protocol.|IR|—|ir_rc5|supported}}
{{pd|jitter|Jitter|Timing jitter calculation|Retrieves the timing jitter between two digital signals.|Misc|—|jitter|supported}}
{{pd|jtag|JTAG|Joint Test Action Group (IEEE 1149.1)|Protocol for testing, debugging, and flashing ICs.|Flash/debug|—|jtag|supported}}
{{pd|jtag_stm32|JTAG / STM32|Joint Test Action Group / ST STM32|ST STM32-specific JTAG protocol.|Flash/debug|jtag|jtag_stm32|supported}}
{{pd|lm75|LM75|National LM75|National LM75 (and compatibles) temperature sensor protocol.|Sensors|i2c|lm75|supported}}
{{pd|lpc|LPC|Low-Pin-Count|Protocol for low-bandwidth devices on PC mainboards.|PC|—|lpc|supported}}
{{pd|maxim_ds28ea00|DS28EA00|Maxim DS28EA00 1-Wire digital thermometer|1-Wire digital thermometer with Sequence Detect and PIO.|Sensors|onewire_network|maxim_ds28ea00|supported}}
{{pd|midi|MIDI|Musical Instrument Digital Interface|Musical Instrument Digital Interface (MIDI) protocol.|Music|uart|midi|supported}}
{{pd|mlx90614|MLX90614|Melexis MLX90614|Infrared Thermometer protocol.|Sensors|i2c|mlx90614|supported}}
{{pd|mx25lxx05d|MX25Lxx05D|Macronix MX25Lxx05D|SPI (NOR) flash chip protocol.|SPI flash|spi, logic|mx25lxx05d|supported}}
{{pd|mxc6225xu|MXC6225XU|MEMSIC MXC6225XU|Digital Thermal Orientation Sensor (DTOS) protocol.|Sensors|i2c|mxc6225xu|supported}}
{{pd|nrf24l01|nRF24L01(+)|Nordic Semiconductor nRF24L01/nRF24L01+|2.4GHz transceiver chip.|Wireless|spi|nrf24l01|supported}}
{{pd|nunchuk|Nunchuk|Nintendo Wii Nunchuk|Nintendo Wii Nunchuk controller protocol.|Other|i2c|nunchuk|supported}}
{{pd|onewire_link|1-Wire link layer|1-Wire serial communication bus (link layer)|Bidirectional, half-duplex, asynchronous serial bus.|Embedded|—|onewire_link|supported}}
{{pd|onewire_network|1-Wire network layer|1-Wire serial communication bus (network layer)|Bidirectional, half-duplex, asynchronous serial bus.|Embedded|onewire_link|onewire_network|supported}}
{{pd|pan1321|PAN1321|Panasonic PAN1321|Bluetooth RF module with Serial Port Profile (SPP).|Bluetooth|uart|pan1321|supported}}
{{pd|parallel|Parallel|Parallel sync bus|Generic parallel synchronous bus.|Misc|—|parallel|supported}}
{{pd|pwm|PWM|Pulse-width modulation|Analog level encoded in duty cycle percentage.|Misc|—|pwm|supported}}
{{pd|rfm12|RFM12|RFM12 control protocol|HopeRF RFM12 wireless transceivers control protocol.|Wireless|spi|rfm12|supported}}
{{pd|rgb_led_spi|RGB LED (SPI)|RGB LED string decoder (SPI)|RGB LED string protocol (RGB values clocked over SPI).|LED|spi|rgb_led_spi|supported}}
{{pd|rtc8564|RTC-8564|Epson RTC-8564 JE/NB|Realtime clock module protocol.|RTC|i2c|rtc8564|supported}}
{{pd|sdcard_spi|SD card (SPI mode)|Secure Digital card (SPI mode)|Secure Digital card (SPI mode) low-level protocol.|Memory|spi|sdcard_spi|supported}}
{{pd|spdif|S/PDIF|Sony/Philips Digital Interface Format|Serial bus for connecting digital audio devices.|Audio|—|spdif|supported}}
{{pd|spi|SPI|Serial Peripheral Interface|Full-duplex, synchronous, serial bus.|Embedded|—|spi|supported}}
{{pd|stepper_motor|Stepper motor|Stepper motor position / speed|Absolute position and movement speed from step/dir.|Motors|—|stepper_motor|supported}}
{{pd|swd|SWD|Serial Wire Debug|Two-wire protocol for debug access to ARM CPUs.|Flash/debug|—|swd|supported}}
{{pd|tca6408a|TI TCA6408A|Texas Instruments TCA6408A|Texas Instruments TCA6408A 8-bit I²C I/O expander.|I/O expander|i2c|tca6408a|supported}}
{{pd|tlc5620|TI TLC5620|Texas Instruments TLC5620|Texas Instruments TLC5620 8-bit quad DAC.|DAC|—|tlc5620|supported}}
{{pd|uart|UART|Universal Asynchronous Receiver/Transmitter|Asynchronous, serial bus.|Embedded|—|uart|supported}}
{{pd|usb_packet|USB packet|Universal Serial Bus (LS/FS) packet|USB (low-speed and full-speed) packet protocol.|USB|usb_signalling|usb_packet|supported}}
{{pd|usb_signalling|USB signalling|Universal Serial Bus (LS/FS) signalling|USB (low-speed and full-speed) signalling protocol.|USB|—|usb_signalling|supported}}
{{pd|xfp|XFP|10 Gigabit Small Form Factor Pluggable Module (XFP)|Data structure describing device capabilities.|Networking|i2c|xfp|supported}}
{{pd|z80|Z80|Zilog Z80 CPU|Zilog Z80 microprocessor disassembly.|CPU|—|z80|supported}}

|}

== Possible candidates for future protocol decoders ==

{| border="0" style="font-size: smaller" class="alternategrey sortable sigroktable"
|-
!Protocol
!Category
!Input ID(s)
!Output ID(s)
!Status
!Description
!Comments

|-
| SA8807A
| Displays
| spi
|
| bgcolor="red" | 0%
| SPI-attached LCD. Datasheet: [http://pdf1.alldatasheet.com/datasheet-pdf/view/36922/SAMES/SA8807A.html Sames SA8807A].
|

|-
| EA eDIPTFT43-A
| Displays
| i2c
|
| bgcolor="red" | 0%
| I2C-attached LCD. Datasheet: [http://www.lcd-module.de/pdf/grafik/ediptft43-a.pdf EA eDIPTFT43-A].
|

|-
| Analog Devices AD7291
| ADC
| i2c
|
| bgcolor="red" | 0%
| I2C-attached ADC. Datasheet: [http://pdf1.alldatasheet.com/datasheet-pdf/view/318172/AD/AD7291.html Analog Devices AD7291].
|

|-
| Analog Devices ADS1258
| ADC
| spi
| ads1258
| bgcolor="orange" | 0%
| SPI-attached ADC.
| Planned (Uwe Hermann).

|-
| Microchip MCP3901
| ADC
| spi
| mcp3901
| bgcolor="orange" | 0%
| Can be controlled via a parallel protocol, or SPI, or I2C.
| Planned (Uwe Hermann).

|-
| JTAG / TMPA9xx
| Flash/debug
| jtag
| jtag_tmpa9xx
| bgcolor="red" | 0%
| Toshiba TMPA9xx specific JTAG protocol details.
|

|-
| USB transaction
| USB
| usb_packet
| usb_transaction
| bgcolor="yellow" | 30%
|
| Work in progress (Uwe Hermann).

|-
| USB transfer
| USB
| usb_transaction
| usb_transfer
| bgcolor="yellow" | 10%
|
| Work in progress (Uwe Hermann).

|-
| USB / HID
| USB
| usb_transfer
| usb_hid
| bgcolor="red" | 0%
|
|

|-
| USB / CDC
| USB
| usb_transfer
| usb_cdc
| bgcolor="red" | 0%
|
|

|-
| USB / USBTMC
| USB
| usb_transfer
| usb_usbtmc
| bgcolor="red" | 0%
|
|

|-
| Dallas DS1985
| Other
| onewire_network
|
| bgcolor="orange" | 0%
| Dallas DS1985 iButton (1-Wire) device.
| Planned (Uwe Hermann).

|-
| Microwire
| Embedded
| —
|
| bgcolor="red" | 0%
|
|

|-
| UNI/O
| Embedded
| —
|
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Synchronous_Serial_Interface SSI]
| Embedded
| —
|
| bgcolor="red" | 0%
| Synchronous Serial Interface
|

|-
| CompactFlash
| Memory
| —
|
| bgcolor="red" | 0%
|
|

|-
| MMC
| Memory
| —
|
| bgcolor="red" | 0%
|
|

|-
| Memory Stick
| Memory
| —
|
| bgcolor="red" | 0%
|
|

|-
| SmartMedia
| Memory
| —
|
| bgcolor="red" | 0%
|
|

|-
| xD-Picture Card
| Memory
| —
|
| bgcolor="red" | 0%
|
|

|-
| SD card (SD mode)
| Memory
| —
| sdcard_sd
| bgcolor="yellow" | 80%
|
| Work in progress (Uwe Hermann).

|-
| [https://en.wikipedia.org/wiki/ISO/IEC_7816 ISO 7816]
| Smartcards
| —
|
| bgcolor="red" | 0%
|
|

|-
| FlexRay
| Automotive
| —
|
| bgcolor="red" | 0%
| [http://en.wikipedia.org/wiki/Flexray FlexRay] is an automotive network communications protocol.
|

|-
| LIN
| Automotive
| —
|
| bgcolor="red" | 0%
| [http://en.wikipedia.org/wiki/Local_Interconnect_Network LIN] (Local Interconnect Network) is an automotive bus standard.
|

|-
| AVR PDI
| Flash/debug
| —
|
| bgcolor="red" | 0%
| Atmel Program and Debug Interface (PDI) protocol.
|

|-
| AVR TPI
| Flash/debug
| —
|
| bgcolor="red" | 0%
| Atmel Tiny Programming Interface (TPI) protocol.
|

|-
| FWH
| PC
| —
|
| bgcolor="red" | 0%
|
|

|-
| ISA
| PC
| —
|
| bgcolor="red" | 0%
|
|

|-
| PCI
| PC
| —
|
| bgcolor="red" | 0%
|
|

|-
| SMBus
| PC
| —
|
| bgcolor="red" | 0%
|
|

|-
| IDE
| PC
| —
|
| bgcolor="red" | 0%
|
|

|-
| SCSI
| PC
| —
|
| bgcolor="red" | 0%
|
|

|-
| PS/2
| PC
| —
|
| bgcolor="orange" | 0%
|
| Planned (Uwe Hermann).

|-
| [https://en.wikipedia.org/wiki/Platform_Environment_Control_Interface PECI]
| PC
| —
|
| bgcolor="red" | 0%
| Platform Environment Control Interface
|

|-
| [https://en.wikipedia.org/wiki/SVID SVID]
| PC
| —
|
| bgcolor="red" | 0%
| Serial Voltage Identification
|

|-
| AC'97
| Audio
| —
|
| bgcolor="orange" | 0%
|
| Planned (Uwe Hermann).

|-
| HD Audio
| Audio
| —
|
| bgcolor="red" | 0%
|
|

|-
| Nokia NRC17
| IR
| —
|
| bgcolor="red" | 0%
|
|

|-
| Sony SIRC
| IR
| —
|
| bgcolor="red" | 0%
|
|

|-
| Philips RC-6
| IR
| —
|
| bgcolor="red" | 0%
|
|

|-
| Philips RC-MM
| IR
| —
|
| bgcolor="red" | 0%
|
|

|-
| Philips RECS80
| IR
| —
|
| bgcolor="red" | 0%
|
|

|-
| [http://en.wikipedia.org/wiki/Infrared_Data_Association IrDA]
| Misc
| —
|
| bgcolor="red" | 0%
|
|

|-
| AT93C46
| EEPROM
| —
|
| bgcolor="red" | 0%
| Atmel AT93C46 serial EEPROM protocol
|

|-
| HD44780
| Displays
| —
|
| bgcolor="red" | 0%
| [http://en.wikipedia.org/wiki/HD44780_Character_LCD HD44780 character LCD] protocol
|

|-
| 7-segment display
| Displays
| —
|
| bgcolor="red" | 0%
|
|

|-
| [[Protocol_decoder:Pcf8814|PCF8814]]
| Displays
| —
| pcf8814
| bgcolor="yellow" | 50%
| Philips PCF8814 65 x 96 pixels matrix LCD driver
| Work in progress (Uwe Hermann).

|-
| [[Protocol_decoder:Pcf8814_lcd|PCF8814 LCD]]
| Displays
| pcf8814
| pcf8814_lcd
| bgcolor="yellow" | 50%
| Philips PCF8814 65 x 96 pixels matrix LCD driver
| Work in progress (Uwe Hermann).

|-
| GPIB
| Other
| —
| gpib
| bgcolor="orange" | 0%
| [https://en.wikipedia.org/wiki/IEEE-488 General purpose interface bus] (GPIB), a.k.a. IEEE-488.1.
| Planned (Uwe Hermann).

|-
| [https://en.wikipedia.org/wiki/DMX512 DMX512]
| Industrial Lighting
| —
| dmx512
| bgcolor="yellow" | 20%
| Digital MultipleX 512
| Work in progress (Uwe Hermann).

|-
| [https://en.wikipedia.org/wiki/Digital_Signal_Interface DSI]
| Industrial Lighting
| —
| dsi
| bgcolor="red" | 0%
| Digital Serial Interface
|

|-
| [http://en.wikipedia.org/wiki/Digital_Addressable_Lighting_Interface DALI]
| Industrial Lighting
| —
| dali
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/RDM_%28lighting%29 RDM]
| Industrial Lighting
| —
| rdm
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/NMEA_0183 NMEA 0183]
| GPS
| uart
| nmea0183
| bgcolor="red" | 0%
|
|

|-
| [[Protocol_decoder:Nmea2000|NMEA2000]]
| Marine
| can
| nmea2000
| bgcolor="red" | 0%
| [https://en.wikipedia.org/wiki/NMEA_2000 NMEA 2000 Wikipedia page]
|

|-
| [https://en.wikipedia.org/wiki/Digital_Command_Control DCC]
| Trains
| —
| dcc
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Train_Communication_Network MVB]
| Trains
| —
| mvb
| bgcolor="red" | 0%
| Multifunction Vehicle Bus
|

|-
| [https://en.wikipedia.org/wiki/Train_Communication_Network WTB]
| Trains
| —
| wtb
| bgcolor="red" | 0%
| Wire Train Bus
|

|-
| [https://en.wikipedia.org/wiki/C-Bus_%28protocol%29 C-Bus]
| Home automation
| —
| cbus
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/X10_%28industry_standard%29 X10]
| Home automation
| —
| x10
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/LonWorks LonWorks]
| Home automation
| —
| lonworks
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/S-Bus S-Bus]
| Home automation
| —
| sbus
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Meter-Bus M-Bus]
| Automation
| —
| mbus
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Modbus Modbus RTU]
| Automation
| uart
| modbus
| bgcolor="red" | 0%
|
| Work in progress (BartW on IRC).

|-
| [https://en.wikipedia.org/wiki/Modbus Modbus ASCII]
| Automation
| uart
| modbus
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Modbus Modbus TCP]
| Automation
| ip
| modbus
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Highway_Addressable_Remote_Transducer_Protocol HART protocol]
| Automation
| —
| hart
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/INTERBUS INTERBUS]
| Automation
| —
| interbus
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/DirectNET_Protocol DirectNET]
| Automation
| uart
| directnet
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/KNX_%28standard%29 KNX]
| Automation
| various
| knx
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Bacnet BACnet]
| Automation
|
| bacnet
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/OpenTherm OpenTherm]
| Automation
| —
| opentherm
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/EBUS_%28serial_buses%29 EBUS]
| Automation
| uart
| ebus
| bgcolor="red" | 0%
|
|

|-
| [https://en.wikipedia.org/wiki/Attachment_Unit_Interface AUI]
| Networking
| —
| aui
| bgcolor="red" | 0%
| Attachment Unit Interface
|

|-
| [https://en.wikipedia.org/wiki/Medium_Dependent_Interface MDI]
| Networking
| —
| mdi
| bgcolor="red" | 0%
| Medium Dependent Interface
|

|-
| [https://en.wikipedia.org/wiki/Media_Independent_Interface MII]
| Networking
| —
| mii
| bgcolor="red" | 0%
| Media Independent Interface
|

|-
| [https://en.wikipedia.org/wiki/Gigabit_Media_Independent_Interface#Gigabit_Media_Independent_Interface GMII]
| Networking
| —
| gmii
| bgcolor="red" | 0%
| Gigabit Media Independent Interface
|

|-
| [https://en.wikipedia.org/wiki/10_Gigabit_Media_Independent_Interface#10_Gigabit_Media_Independent_Interface XGMII]
| Networking
| —
| xgmii
| bgcolor="red" | 0%
| 10 Gigabit Media Independent Interface
|

|-
| [https://en.wikipedia.org/wiki/Management_Data_Input/Output MDIO]
| Networking
| —
| mdio
| bgcolor="red" | 0%
| Management Data Input/Output
| Work in progress (Aurel).

|-
| [https://en.wikipedia.org/wiki/Wiegand_interface Wiegand]
| RFID
| —
| wiegand
| bgcolor="red" | 0%
| Wiegand interface
|

|-
| [[Protocol_decoder:esp8266|ESP8266]]
| Wireless
| uart
| esp8266
| bgcolor="red" | 0%
| WiFi Serial Transceiver
|
|}

__FORCETOC__

Protocol decoder:Am230x

2015-05-30T20:36:56Z

Karlp: rht03 and renaming info

{{Infobox protocol decoder
| id = am230x
| name = AM230x/DHTxx/RHTxx
| description = Aosong AM230x/DHTxx/RHTxx humidity/temperature sensor protocol
| status = supported
| license = GPLv2+
| source_code_dir = am230x
| image = [[File:Aosong dht11 top.jpg|250px]]
| input = logic
| output = am230x
| probes = SDA
| optional_probes = —
| options = device
}}

The '''am230x''' protocol decoder decodes the [http://www.aosong.com/en/products/index.asp?classid=313&name=Humidity%20&%20temp%20Sensor/OEM Aosong AM230x/DHT11] temperature and humidity sensor single-wire protocol.

== Hardware ==

See the [http://sigrok.org/gitweb/?p=sigrok-dumps.git;a=tree;f=am230x am230x] directory for example capture files.

=== Models ===

{| border="0" style="font-size: smaller" class="alternategrey sortable sigroktable"
|-
!Model
!Microcontroller
!Temperature
!Humidity
!Datasheet

|-
| [http://www.aosong.com/en/products/details.asp?id=110 Aosong AM2301]
| Unknown SOIC-10
| ?
| ?
| [http://meteobox.tk/files/AM2301.pdf PDF]
|-
| [http://www.aosong.com/en/products/details.asp?id=117 Aosong AM2302]
| [http://www.st.com/web/catalog/mmc/FM141/SC1244/SS1010/LN754/PF215113 ST STM8S103F3] (8S103F3P6), SOIC-20
| analog
| analog
| [http://www.adafruit.com/datasheets/Digital%20humidity%20and%20temperature%20sensor%20AM2302.pdf PDF]
|-
| Aosong AM2303
| [http://www.st.com/web/catalog/mmc/FM141/SC1244/SS1010/LN754/PF215113 ST STM8S103F3] (8S103F3P6), SOIC-20
| [http://www.maximintegrated.com/en/products/analog/sensors-and-sensor-interface/DS18B20.html Dallas DS18B20]
| analog
| [http://www.aosong.com/asp_bin/Products/en/AM2303.pdf PDF]
|-
| [http://aosong.com/en/products/details.asp?id=121 Aosong AM2305]
| ?
| ?
| ?
| [http://www.aosong.com/asp_bin/Products/en/AM2305.pdf PDF]
|-
| [http://aosong.com/en/products/details.asp?id=115 Aosong AM2306]
| ?
| ?
| ?
| [http://www.aosong.com/asp_bin/Products/en/AM2306.pdf PDF]
|-
| Aosong AM2320
| ?
| ?
| ?
| ?
|-
| Aosong AM2321
| ?
| ?
| ?
| ?
|-
| Aosong AM2322
| ?
| ?
| ?
| ?
|-
| Aosong DHT11
| Unknown SOIC-14
| analog
| analog
| [http://akizukidenshi.com/download/ds/aosong/DHT11.pdf PDF]
|-
| RTH03
| ?
| ?
| ?
| https://www.sparkfun.com/products/10167

|}

These parts are often renamed or rebadged.

=== Aosong AM2301 ===

<gallery>
File:Aosong am2301 top.jpg|Device, top
File:Aosong am2301 bottom.jpg|Device, bottom
File:Am2301 pcb open.jpg|Device PCB, open
File:Am2301 pcb top.jpg|Device PCB, top
File:Am2301 pcb bottom.jpg|Device PCB, bottom
</gallery>

=== Aosong AM2302 ===

<gallery>
File:Aosong am2302 top.jpg|Device, top
File:Aosong am2302 bottom.jpg|Device, bottom
File:Aosong am2302 pcb top.jpg|PCB, top
File:Aosong am2302 pcb bottom.jpg|PCB, bottom
File:Aosong am2302 microcontroller.jpg|STM8S103F3 
File:Aosong am2302 sensor back.jpg|Sensor
File:Aosong am2302 debris.jpg|Debris
</gallery>

=== Aosong AM2303 ===

<gallery>
File:Aosong am2303 top.jpg|Device, top
File:Aosong am2303 bottom.jpg|Device, bottom
File:Aosong am2303 pcb top.jpg|PCB, top
File:Aosong am2303 pcb bottom.jpg|PCB, bottom
File:Aosong am2303 sensor.jpg|DS18B20
File:Aosong am2303 debris.jpg|Debris
</gallery>

=== Aosong DHT11 ===

<gallery>
File:Aosong dht11 top.jpg|Device, top
File:Aosong dht11 bottom.jpg|Device, bottom
File:Dht11 pcb open.jpg|Device PCB, open
File:Dht11 pcb top.jpg|Device PCB, top
File:Dht11 pcb bottom.jpg|Device PCB, bottom
</gallery>

== Protocol ==

A custom single-wire protocol (not to be confused with the Dallas 1-Wire protocol!) is used to get the measured values from the sensor.

The actual payload consists of a humidity value, a temperature value, and a checksum.

== Resources ==

* [http://www.aosong.com/en/home/index.asp Aosong website]
* [https://learn.adafruit.com/dht/ Adafruit: DHT sensor tutorial]
** [https://github.com/adafruit/DHT-sensor-library GitHub: Adafruit DHT-sensor-library]
* [http://playground.arduino.cc/Main/DHTLib arduino.cc: DHTLib] Contains a mapping of common renames

[[Category:Protocol decoder]]

Building

2015-05-16T15:05:21Z

Karlp:

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.0 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.3.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (for the macro AX_CXX_COMPILE_STDCXX_11; only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.24.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* libsigrok >= 0.3.0
* libsigrokdecode >= 0.3.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.42 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.3.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.3.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro not found.
--- You won't be able to build the language bindings!

That means that the m4 macro used to detect C++11 support was not found. Use the package manager of your distribution/OS to install the package that included the macro. Most distributions package this file in a package called <tt>'''autoconf-archive'''</tt> or similar.

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old.
--- (found version <version>, at least 4 is required)
--- You won't be able to build the language bindings!

That means that the version of the macro included with your distribution/OS is too old. You can:
* Download the latest version of the macro from [https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx_11.html here], and use the <tt>'''ACLOCAL_PATH'''</tt> environment variable to point aclocal to the file:
$ '''ACLOCAL_PATH=/path/to/directory/containing/macro ./autogen.sh'''
* Download the latest version of the macro and overwrite the file included with your distribution, most often located in <tt>/usr/share/aclocal</tt>.

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory ==

Hoops to jump though: (WIP)

* libsigrok: Nothing here, just <tt>$ ./configure --prefix=/blah/wop</tt> FIXME - pythonpath will be wrong here if you have python bindings enabled!
* libsigrokdecode: Nothing here, just <tt>$ ./configure --prefix=/blah/wop</tt>
* sigrok-cli: Needs pkg-config fixes: <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop</tt>
* pulseview: Needs pkg-config and prefix <tt>$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig/ cmake -DCMAKE_INSTALL_PREFIX:PATH=/blah/wop ..</tt>

Building

2015-05-16T15:02:09Z

Karlp:

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.0 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.3.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (for the macro AX_CXX_COMPILE_STDCXX_11; only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.24.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* libsigrok >= 0.3.0
* libsigrokdecode >= 0.3.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.42 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.3.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.3.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro not found.
--- You won't be able to build the language bindings!

That means that the m4 macro used to detect C++11 support was not found. Use the package manager of your distribution/OS to install the package that included the macro. Most distributions package this file in a package called <tt>'''autoconf-archive'''</tt> or similar.

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old.
--- (found version <version>, at least 4 is required)
--- You won't be able to build the language bindings!

That means that the version of the macro included with your distribution/OS is too old. You can:
* Download the latest version of the macro from [https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx_11.html here], and use the <tt>'''ACLOCAL_PATH'''</tt> environment variable to point aclocal to the file:
$ '''ACLOCAL_PATH=/path/to/directory/containing/macro ./autogen.sh'''
* Download the latest version of the macro and overwrite the file included with your distribution, most often located in <tt>/usr/share/aclocal</tt>.

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory ==

Hoops to jump though: (WIP)

* libsigrok: Nothing here, just '''./configure --prefix=/blah/wop''' FIXME - pythonpath will be wrong here!
* libsigrokdecode: Nothing here, just '''./configure --prefix=/blah/wop'''
* sigrok-cli: Needs pkg-config fixes: '''$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop'''
* pulseview: Needs pkg-config and prefix '''$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig/ cmake -DCMAKE_INSTALL_PREFIX:PATH=/blah/wop ..'''

Building

2015-05-16T14:33:10Z

Karlp: work in progress, needed to save

This page documents the build requirements for the sigrok subprojects, and contains links to OS-specific instructions to build them from source.

== Distribution packages and binaries ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]] for distribution packages of the sigrok subprojects and binary builds for various OSes.

See the instructions below if you want to build from source.

== Build requirements ==

=== libsigrok ===

'''Requirements for the C library''':

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.32.0
* libzip >= 0.10
* libserialport >= 0.1.0 (optional, used by some drivers)
* librevisa >= 0.0.20130412 (optional, used by some drivers)
* libusb-1.0 >= 1.0.16 (optional, used by some drivers)
** On [[FreeBSD]], this is an integral part of the FreeBSD libc, not an extra package/library.
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libftdi >= 0.16 or libftdi1 >= 1.0 (optional, used by some drivers)
* libgpib (optional, used by some drivers; only available on Linux)
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

'''Requirements for the C++ bindings''':

* libsigrok >= 0.3.0 (the libsigrok C library, see above)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* autoconf-archive (for the macro AX_CXX_COMPILE_STDCXX_11; only needed when building from git)
* doxygen (required for building the bindings, not only for C++ API docs!)
* graphviz (optional, only needed for the C++ API docs)
* Python (2 or 3) executable (development files are not needed)
* glibmm-2.4 (>= 2.32.0)

'''Requirements for the Python bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* Python >= 2.7 or Python >= 3 (including development files!)
* Python setuptools (for Python 2 or 3)
* pygobject >= 3.0.0 (for Python 2 or 3), a.k.a python-gi
* numpy (for Python 2 or 3)
* SWIG >= 2.0.0
* doxygen (optional, only needed for the Python API docs)
* graphviz (optional, only needed for the Python API docs)
* doxypy (optional, only needed for the Python API docs)

'''Requirements for the Java bindings''':

* libsigrokxx >= 0.3.0 (the libsigrok C++ bindings, see above)
* SWIG >= 2.0.0
* Java JDK (for JNI includes and the javac/jar binaries)
* doxygen (optional, only needed for the Java API docs)
* graphviz (optional, only needed for the Java API docs)

=== libsigrokdecode ===

* git (only needed when building from git)
* gcc (>= 4.0) or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.24.0
* Python >= 3.2
* check >= 0.9.4 (optional, only needed to run unit tests)
* doxygen (optional, only needed for the C API docs)
* graphviz (optional, only needed for the C API docs)

=== sigrok-cli ===

* git (only needed when building from git)
* gcc or clang
* make
* autoconf >= 2.63 (only needed when building from git)
* automake >= 1.11 (only needed when building from git)
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* libglib >= 2.28.0
* libsigrok >= 0.3.0
* libsigrokdecode >= 0.3.0

=== PulseView ===

* git (only needed when building from git)
* A C++ compiler with C++11 support (-std=c++11 option), e.g.
** g++ (>= 4.7)
** clang++ (>= 3.1)
* make
* libtool (only needed when building from git)
* pkg-config >= 0.22
** This is part of the standard [[OpenBSD]] install (not an extra package), apparently.
* cmake >= 2.8.6
* libglib >= 2.28.0
* Qt4 >= 4.5 or Qt5 (including the following components):
** Qt4: QtCore, QtGui, QtSvg
** Qt5: Qt5Core, Qt5Gui, Qt5Widgets, Qt5Svg
* libboost >= 1.42 (including the following libs):
** libboost-sytem
** libboost-filesystem
** libboost-thread
** libboost-test (optional, only needed to run unit tests)
* libsigrokcxx >= 0.3.0 (libsigrok C++ bindings)
* libsigrokdecode >= 0.3.0
* libsigrokandroidutils >= 0.1.0 (optional, only needed on Android)

== Building from source ==

See the OS-specific build instructions below if you want to build the sigrok subprojects from source:

* [[Linux]]
* [[Mac OS X]]
* [[Windows]]
* [[FreeBSD]]
* [[OpenBSD]]
* [[NetBSD]]
* [[Android]]
* [[Embedded]]

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro not found.
--- You won't be able to build the language bindings!

That means that the m4 macro used to detect C++11 support was not found. Use the package manager of your distribution/OS to install the package that included the macro. Most distributions package this file in a package called <tt>'''autoconf-archive'''</tt> or similar.

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

[[libsigrok]]'s <tt>'''autogen.sh'''</tt> outputs the following warning:

--- Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old.
--- (found version <version>, at least 4 is required)
--- You won't be able to build the language bindings!

That means that the version of the macro included with your distribution/OS is too old. You can:
* Download the latest version of the macro from [https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx_11.html here], and use the <tt>'''ACLOCAL_PATH'''</tt> environment variable to point aclocal to the file:
$ '''ACLOCAL_PATH=/path/to/directory/containing/macro ./autogen.sh'''
* Download the latest version of the macro and overwrite the file included with your distribution, most often located in <tt>/usr/share/aclocal</tt>.

=== Cannot open shared object file: No such file or directory ===

You get the following error:

error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Run '''ldconfig''' with the proper installation '''lib''' directory where you installed the sigrok related libraries, e.g.:

$ '''sudo ldconfig /usr/local/lib'''

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

You get the following error when trying to run [[libsigrok]]'s '''make install''' step:


TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files
error: bad install directory or PYTHONPATH

You are attempting to install a package to a directory that is not
on PYTHONPATH and which Python does not read ".pth" files from. The
installation directory you specified (via --install-dir, --prefix, or
the distutils default setting) was:

.../lib/python2.7/site-packages/

and your PYTHONPATH environment variable currently contains:

'''''''

Here are some of your options for correcting the problem:

* You can choose a different installation directory, i.e., one that is
on PYTHONPATH or supports .pth files

* You can add the installation directory to the PYTHONPATH environment
variable. (It must then also be on PYTHONPATH whenever you run
Python and want to use the package(s) you are installing.)

* You can set up the installation directory to support ".pth" files by
using one of the approaches described here:

https://pythonhosted.org/setuptools/easy_install.html#custom-installation-locations

Please make the appropriate changes for your system and try again.


This can be fixed using multiple ways (see text above), but the simplest is probably to run:

$ '''PYTHONPATH=.../lib/python2.7/site-packages make install'''

(replace the "..." with the correct path that is shown in your console output)

=== Cannot access USB / serial / other device ===

Please read [[libsigrok]]'s [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README.devices README.devices] file for any extra steps you may need to take to get your specific device working. This includes USB devices (you might need to use a udev rules file), serial devices (you might need permissions for accessing them), and various other devices (you might need firmware/bitstream files, or other things).

Also check the wiki page for [[Supported hardware|your respective device]] as well for more hints.

== Installing to a non-standard directory ==

Hoops to jump though: (WIP)

libsigrok: Nothing here, just '''./configure --prefix=/blah/wop''' FIXME - pythonpath will be wrong here!
libsigrokdecode: Nothing here, just '''./configure --prefix=/blah/wop'''
sigrok-cli: Needs pkg-config fixes: '''$ PKG_CONFIG_PATH=/blah/wop/lib/pkgconfig ./configure --prefix=/blah/wop'''

Linux

2015-05-16T14:15:22Z

Karlp: /* Installing the requirements */

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi-dev check doxygen python-numpy\'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 20, 21)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel'''

For c++ bindings, add '''sudo yum install glibmm24-devel'''
for python bindings, add '''sudo yum install pygobject3-devel swig'''

'''Arch'''
# '''pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===
==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-test-dev libboost-thread-dev\'''
'''libboost-filesystem-dev libboost-system-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Arch'''
# '''pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_not_found|here]].

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_is_too_old|here]].

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Linux

2015-05-16T14:15:08Z

Karlp: fix typo in glibmm24

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi-dev check doxygen python-numpy\'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 21)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel'''

For c++ bindings, add '''sudo yum install glibmm24-devel'''
for python bindings, add '''sudo yum install pygobject3-devel swig'''

'''Arch'''
# '''pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===
==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-test-dev libboost-thread-dev\'''
'''libboost-filesystem-dev libboost-system-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Arch'''
# '''pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_not_found|here]].

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_is_too_old|here]].

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Linux

2015-05-05T18:01:24Z

Karlp: more missing fedora requirements

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi-dev check doxygen python-numpy\'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 21)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig \'''
''' glib2-devel libzip-devel libusb1-devel libftdi-devel check-devel'''
For c++ bindings, add '''glib24mm-devel'''
for python bindings, add '''pygobject3-devel swig'''

'''Arch'''
# '''pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===
==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-test-dev libboost-thread-dev\'''
'''libboost-filesystem-dev libboost-system-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Arch'''
# '''pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_not_found|here]].

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_is_too_old|here]].

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Linux

2015-05-05T17:51:14Z

Karlp: add autoconf archive to the deps list for fedora

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

<div style="background-color:#ff6666">
'''IMPORTANT''': The following sections on installing build requirements are distro-specific examples and may or may not be out of date, depending on which distro you use. Please check the [[Building#Build_requirements|official build requirements list]] in the wiki or the current [http://sigrok.org/gitweb/?p=libsigrok.git;a=blob;f=README libsigrok README] for the full list of requirements.
</div>

=== libserialport ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu/Mint'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool'''

==== Building ====

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''

$ '''sudo apt-get install git-core gcc g++ make autoconf autoconf-archive \'''
'''automake libtool pkg-config libglib2.0-dev libglibmm-2.4-dev libzip-dev \'''
'''libusb-1.0-0-dev libftdi-dev check doxygen python-numpy\'''
'''python-dev python-gi-dev python-setuptools swig default-jdk'''

'''Fedora (18, 19, 21)'''

$ '''sudo yum install git gcc make autoconf autoconf-archive automake libtool pkgconfig glib2-devel \'''
'''libzip-devel libusb1-devel libftdi-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf autoconf-archive automake libtool \'''
'''pkg-config glib2 glibmm libzip libusb libftdi check doxygen python-numpy \'''
'''python-setuptools swig jdk8-openjdk'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

==== Device access ====

Please read [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|this FAQ entry]] for any extra steps you may need to take to get your specific device working.

<div style="background-color:#ff6666">
Please see [[Building#FAQ]] if you are sure that you installed all requirements properly but still encounter some issues.
</div>

=== libsigrokdecode ===
==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

'''Fedora (18, 19, 20)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2 python check'''

==== Building ====

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

==== Installing the [[Building#Build_requirements|requirements]] ====

'''Debian/Ubuntu''''
$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''OpenSuse'''
$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Arch'''
# '''pacman -S git gcc make autoconf automake libtool pkgconfig glib2'''

==== Building ====

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===
==== Installing the [[Building#Build_requirements|requirements]] ====
'''Debian/Ubuntu'''
$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-test-dev libboost-thread-dev\'''
'''libboost-filesystem-dev libboost-system-dev'''

'''Fedora (18, 19)'''
$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Arch'''
# '''pacman -S git gcc make cmake libtool pkgconfig glib2 boost qt5 \'''
'''qt5-base qt5-svg'''

==== Building ====

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''

== FAQ ==

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro not found ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_not_found|here]].

=== Warning: AX_CXX_COMPILE_STDCXX_11 macro is too old ===

See [[Building#Warning:_AX_CXX_COMPILE_STDCXX_11_macro_is_too_old|here]].

=== Cannot open shared object file: No such file or directory ===

See [[Building#Cannot_open_shared_object_file:_No_such_file_or_directory|here]].

=== TEST FAILED: .../lib/python2.7/site-packages/ does NOT support .pth files ===

See [[Building#TEST_FAILED:_....2Flib.2Fpython2.7.2Fsite-packages.2F_does_NOT_support_.pth_files|here]].

=== Cannot access USB / serial / other device ===

See [[Building#Cannot_access_USB_.2F_serial_.2F_other_device|here]].

Linux

2014-06-04T22:11:33Z

Karlp:

[[File:Sigrok-gtk-0.1.png|thumb|320px|right|sigrok-gtk 0.1.0 on Linux]]

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

=== libserialport ===

'''Building:'''

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config \'''
'''libglib2.0-dev libzip-dev libusb-1.0-0-dev libftdi-dev libudev-dev libasound2-dev check'''

Fedora (18, 19):

$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel \'''
'''libzip-devel libusb1-devel libftdi-devel libudev-devel alsa-lib-devel check-devel'''

Fedora 20:
As above, but replace '''libudev-devel''' with '''systemd-devel'''

OpenSuSE (12.2):

$ '''zypper install git gcc make autoconf automake libtool pkg-config glib2-devel \'''
'''libzip-devel libusb-1_0-devel libftdi1-devel libudev-devel alsa-devel check \'''
'''python3-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrokdecode ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

Fedora (18, 19, 20):

$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel check-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

Fedora (18, 19):

$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

OpenSuse (13.1):

$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-dev libboost-test-dev libboost-thread-dev libboost-filesystem-dev libboost-system-dev'''

Fedora (18, 19):

$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''


== Common problems ==

If you get this error:

sigrok-cli: error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Then you have to rebuild the links to your shared libraries:

$ '''sudo ldconfig /usr/local/lib'''

Linux

2014-06-04T21:49:56Z

Karlp: fedora 20 doesn't have libudev

[[File:Sigrok-gtk-0.1.png|thumb|320px|right|sigrok-gtk 0.1.0 on Linux]]

This page describes how to build/install the sigrok subprojects on Linux.

== Distribution packages ==

See [[Downloads#Binaries_and_distribution_packages|Downloads]].

== Building ==

=== libserialport ===

'''Building:'''

$ '''git clone git://sigrok.org/libserialport'''
$ '''cd libserialport'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrok ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config \'''
'''libglib2.0-dev libzip-dev libusb-1.0-0-dev libftdi-dev libudev-dev libasound2-dev check'''

Fedora (18, 19):

$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel \'''
'''libzip-devel libusb1-devel libftdi-devel libudev-devel alsa-lib-devel check'''

Fedora 20:
As above, but replace '''libudev-devel''' with '''systemd-devel'''

OpenSuSE (12.2):

$ '''zypper install git gcc make autoconf automake libtool pkg-config glib2-devel \'''
'''libzip-devel libusb-1_0-devel libftdi1-devel libudev-devel alsa-devel check \'''
'''python3-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/libsigrok'''
$ '''cd libsigrok'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== libsigrokdecode ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev python3-dev'''

Fedora (18, 19):

$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel python3-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/libsigrokdecode'''
$ '''cd libsigrokdecode'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== sigrok-cli ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core gcc make autoconf automake libtool pkg-config libglib2.0-dev'''

Fedora (18, 19):

$ '''sudo yum install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

OpenSuse (13.1):

$ '''zypper install git gcc make autoconf automake libtool pkgconfig glib2-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/sigrok-cli'''
$ '''cd sigrok-cli'''
$ '''./autogen.sh'''
$ '''./configure'''
$ '''make'''
$ '''sudo make install'''

=== PulseView ===

'''Installing the [[Building#Build_requirements|requirements]]:'''

Example on Debian/Ubuntu (please check your respective distro's package manager tool if you use other distros):

$ '''sudo apt-get install git-core g++ make cmake libtool pkg-config \'''
'''libglib2.0-dev libqt4-dev libboost-dev libboost-test-dev libboost-thread-dev libboost-filesystem-dev libboost-system-dev'''

Fedora (18, 19):

$ '''sudo yum install git gcc cmake libtool pkgconfig glib2-devel \'''
'''boost-devel qt-devel boost-devel'''

'''Building:'''

$ '''git clone git://sigrok.org/pulseview'''
$ '''cd pulseview'''
$ '''cmake .'''
$ '''make'''
$ '''sudo make install'''


== Common problems ==

If you get this error:

sigrok-cli: error while loading shared libraries: libsigrok.so.0: cannot open shared object file: No such file or directory

Then you have to rebuild the links to your shared libraries:

$ '''sudo ldconfig /usr/local/lib'''

Supported hardware

2014-01-30T20:29:34Z

Karlp: /* Logic analyzers */ fixing spelling of saleae in clone name

sigrok is intended as a flexible, cross-platform, and '''hardware-independent''' software suite, i.e., it supports various devices from many different vendors.

Here is a list of currently supported devices (various stages of completeness) and devices we plan to support in the near future.

The lists are sorted by category (supported: [[:Category:Supported|{{PAGESINCATEGORY:Supported|pages}}]], in progress: [[:Category:In progress|{{PAGESINCATEGORY:In progress|pages}}]], planned: [[:Category:Planned|{{PAGESINCATEGORY:Planned|pages}}]]), and alphabetically within those categories.

== Logic analyzers ==

<gallery widths="100px" heights="100px">
File:ARMFLY MINI LOGIC.png|link=ARMFLY Mini-Logic|[[File:Nuvola OK.png|16px]] [[ARMFLY Mini-Logic]] (8ch, 24MHz)
File:ASIX SIGMA 2.png|link=ASIX SIGMA|[[File:Nuvola OK.png|16px]] [[ASIX SIGMA]] (16ch, 200MHz)
File:Braintechnology_usb_interface_v26.png|link=Braintechnology USB Interface V2.x|[[File:Nuvola OK.png|16px]] [[Braintechnology USB Interface V2.x]] (8/16ch, 24/12MHz)
File:Braintechnology_usb_lps.png|link=Braintechnology USB-LPS|[[File:Nuvola OK.png|16px]] [[Braintechnology USB-LPS]] (8/16ch, 24/12MHz)
File:Chronovu la8 front.png|link=ChronoVu LA8|[[File:Nuvola OK.png|16px]] [[ChronoVu LA8]] (8ch, 100MHz)
File:Cwav_usbee_sx.png|link=CWAV USBee SX|[[File:Nuvola OK.png|16px]] [[CWAV USBee SX]] (8ch, 100MHz)
File:Buspirate_v3.png|link=Dangerous Prototypes Buspirate|[[File:Nuvola OK.png|16px]] [[Dangerous Prototypes Buspirate]] (5ch, 1MHz)
File:Dangerous prototypes irtoy top.jpg|link=Dangerous Prototypes USB IR Toy|[[File:Nuvola OK.png|16px]] [[Dangerous Prototypes USB IR Toy]] (1ch, 10kHz)
File:Eeelec xla esla100.png|link=EE Electronics ESLA100|[[File:Nuvola OK.png|16px]] [[EE Electronics ESLA100]] (8ch, 24MHz)
File:Ikalogic_scanalogic2.png|link=IKALOGIC Scanalogic-2|[[File:Nuvola OK.png|16px]] [[IKALOGIC Scanalogic-2]] (4ch, 20MHz)
File:Ikalogic scanaplus mugshot.png|link=IKALOGIC ScanaPLUS|[[File:Nuvola OK.png|16px]] [[IKALOGIC ScanaPLUS]] (9ch, 100MHz)
File:Kingst kqs3506 la16100.png|link=KingST KQS3506-LA16100|[[File:Nuvola OK.png|16px]] [[KingST KQS3506-LA16100]] (16ch, 100/50/32/16MHz @ 3/6/9/16ch)
File:Lcsoft-miniboard-front.png|link=Lcsoft Mini Board|[[File:Nuvola OK.png|16px]] [[Lcsoft Mini Board]] (8/16ch, 24/12MHz)
File:logic-shrimp-front.png|link=Logic Shrimp|[[File:Nuvola OK.png|16px]] [[Logic Shrimp]] (4ch, 20MHz)
File:Mcu123 saleae logic clone.png|link=MCU123 Saleae Logic clone|[[File:Nuvola OK.png|16px]] [[MCU123 Saleae Logic clone]] (8ch, 24MHz)
File:Usbee_ax_clone_front.png|link=MCU123 USBee AX Pro clone|[[File:Nuvola OK.png|16px]] [[MCU123 USBee AX Pro clone]] (8ch, 24MHz)
File:Openbench logic sniffer front.png|link=Openbench Logic Sniffer|[[File:Nuvola OK.png|16px]] [[Openbench Logic Sniffer]] (32ch, 100MHz)
File:Robomotic buglogic3.png|link=Robomotic BugLogic 3|[[File:Nuvola OK.png|16px]] [[Robomotic BugLogic 3]] (8ch, 24MHz)
File:Robomotic_minilogic.png|link=Robomotic MiniLogic|[[File:Nuvola OK.png|16px]] [[Robomotic MiniLogic]] (8ch, 24MHz)
File:Saleae Logic.png|link=Saleae Logic|[[File:Nuvola OK.png|16px]] [[Saleae Logic]] (8ch, 24MHz)
File:Saleae_Logic16_bottom.png|link=Saleae Logic16|[[File:Nuvola OK.png|16px]] [[Saleae Logic16]] (16ch, 100/50/32/16MHz @ 3/6/9/16ch)
File:Sysclk lwla1034 mugshot.png|link=Sysclk LWLA1034|[[File:Nuvola OK.png|16px]] [[Sysclk LWLA1034]] (34ch, 125MHz)
File:Wayengineer saleae16.png|link=WayEngineer Saleae16|[[File:Nuvola OK.png|16px]] [[WayEngineer Saleae16]] (16ch, 100/50/32/16MHz @ 3/6/9/16ch)
File:Zeroplus Logic Cube.png|link=ZEROPLUS Logic Cube LAP-C(16032)|[[File:Nuvola OK.png|16px]] [[ZEROPLUS Logic Cube LAP-C(16032)]] (16ch, 100MHz)
File:Zeroplus_lap-16128u.png|link=ZEROPLUS LAP-16128U|[[File:Nuvola OK.png|16px]] [[ZEROPLUS LAP-16128U]] (16ch, 200MHz)

File:Chronovu la16.png|link=ChronoVu LA16|[[File:Nuvola Orange.png|16px]] [[ChronoVu LA16]] (16ch, 200MHz)
File:Rockylogic_ant8.png|link=RockyLogic Ant8|[[File:Nuvola Orange.png|16px]] [[RockyLogic Ant8]] (8ch, 500MHz)
File:RockyLogic Ant18e.png|link=RockyLogic Ant18e|[[File:Nuvola Orange.png|16px]] [[RockyLogic Ant18e]] (8ch, 1GHz)

File:Acute_pkla1216.png|link=Acute PKLA-1216|[[File:Nuvola Red.png|16px]] [[Acute PKLA-1216]] (16ch, 200MHz)
File:Hantek 4032l mugshot.png|link=Hantek 4032L|[[File:Nuvola Red.png|16px]] [[Hantek 4032L]] (32ch, 400MHz)
File:Ideofy_la_08.png|link=Ideofy LA-08|[[File:Nuvola Red.png|16px]] [[Ideofy LA-08]] (8ch, 96/60/30MHz @ 2/4/8ch)
File:Intronix Logicport.png|link=Intronix Logicport LA1034|[[File:Nuvola Red.png|16px]] [[Intronix Logicport LA1034]] (34ch, 500MHz)
File:Sigrok_logo_no_text_transparent_512.png|link=Link Instruments LA-5580|[[File:Nuvola Red.png|16px]] [[Link Instruments LA-5580]] (80ch, 500MHz)
File:Microchip_pickit2.png|link=Microchip PICkit2|[[File:Nuvola Red.png|16px]] [[Microchip PICkit2]] (3ch, 1MHz)
File:Minila parport.png|link=MiniLA|[[File:Nuvola Red.png|16px]] [[MiniLA]] (32ch, 100MHz)
File:Minila_mockup.png|link=MiniLA Mockup|[[File:Nuvola Red.png|16px]] [[MiniLA Mockup]] (32ch, 100MHz)
File:Noname_la16_mugshot.png|link=Noname LA16|[[File:Nuvola Red.png|16px]] [[Noname LA16]] (16ch, 100MHz)
File:Xl-logic16-100m-external.jpg|link=Noname XL-LOGIC16-100M|[[File:Nuvola Red.png|16px]] [[Noname XL-LOGIC16-100M]] (Saleae Logic16 Clone)
File:Sysclk lwla1016.png|link=Sysclk LWLA1016|[[File:Nuvola Red.png|16px]] [[Sysclk LWLA1016]] (16ch, 100MHz)
File:Sysclk lwla2034 mugshot.png|link=Sysclk LWLA2034|[[File:Nuvola Red.png|16px]] [[Sysclk LWLA2034]] (34ch, 200MHz)
File:Techtools_digiview_dv1-100.png|link=TechTools DigiView DV1-100|[[File:Nuvola Red.png|16px]] [[TechTools DigiView DV1-100]] (18ch, 100MHz)
File:Xmos xtag2.png|link=XMOS XTAG-2|[[File:Nuvola Red.png|16px]] [[XMOS XTAG-2]] (?ch, 50MHz)
File:Sigrok_logo_no_text_transparent_512.png|link=ZEROPLUS Logic Cube LAP-C(322000)|[[File:Nuvola Red.png|16px]] [[ZEROPLUS Logic Cube LAP-C(322000)]] (32ch, 200MHz)
File:Zlg_la1032.png|link=ZLG LA1032|[[File:Nuvola Red.png|16px]] [[ZLG LA1032]] (32ch, 100MHz)
</gallery>

== Mixed-signal devices ==

<gallery widths=105px heights=105px>
File:Armfly_ax_pro.png|link=ARMFLY AX-Pro|[[File:Nuvola OK.png|16px]] [[ARMFLY AX-Pro]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 40MHz BW)
File:Sysclk ax pro mugshot.png|link=Sysclk AX-Pro|[[File:Nuvola OK.png|16px]] [[Sysclk AX-Pro]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 3MHz BW)
File:Esla201a.png|link=EE Electronics ESLA201A|[[File:Nuvola OK.png|16px]] [[EE Electronics ESLA201A]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 40MHz BW)
File:Rigol DS1052E.png|link=Rigol DS1000 Series|[[File:Nuvola OK.png|16px]] [[Rigol DS1000 Series|Rigol DS1000D Series]] (16ch, 2ch analog, 50-150MHz BW)
File:Rigol_VS5202D.png|link=Rigol VS5000 Series|[[File:Nuvola OK.png|16px]] [[Rigol VS5000 Series|Rigol VS5000D Series]] (16ch, 2ch analog, 20-200MHz BW
File:Xzl studio ax mugshot.png|link=XZL_Studio AX|[[File:Nuvola OK.png|16px]] [[XZL_Studio AX]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 40MHz BW)
File:BitScope BS10.png|link=BitScope BS10|[[File:Nuvola Orange.png|16px]] [[BitScope BS10]] (8ch, 40MHz; 2ch analog, 20MSa/s, ? BW)
File:Link Instruments MSO-19 front.png|link=Link Instruments MSO-19|[[File:Nuvola Orange.png|16px]] [[Link Instruments MSO-19]] (8ch, 200MHz; 1ch analog, 200MSa/s, 60MHz BW)

File:Agilent_MSO7104A.png|link=Agilent MSO7104A|[[File:Nuvola Red.png|16px]] [[Agilent MSO7104A]] (16ch, ?; 4ch analog, 2GSa/s, 100MHz BW)
File:Digilent_analog_discovery.png|link=Digilent Analog Discovery|[[File:Nuvola Red.png|16px]] [[Digilent Analog Discovery]] (16ch, 100MHz; 2ch analog, 100MSa/s, 5MHz BW)
File:Hantek_1008C.png|link=Hantek 1008C|[[File:Nuvola Red.png|16px]] [[Hantek 1008C]] (8ch)
File:Meilhaus_mephisto_scope1.png|link=Meilhaus MEphisto Scope1|[[File:Nuvola Red.png|16px]] [[Meilhaus MEphisto Scope1]] (16ch, 100kHz; 2ch analog, 1MSa/s, 500kHz BW)
File:Polabs_poscope_basic2.png|link=PoLabs PoScope Basic2|[[File:Nuvola Red.png|16px]] [[PoLabs PoScope Basic2]] (16ch, 8MHz; 2ch analog, 200kSa/s, ? BW)
File:QuantAsylum QA100.png|link=QuantAsylum QA100|[[File:Nuvola Red.png|16px]] [[QuantAsylum QA100]] (12ch; 2ch analog)
File:Sigrok_logo_no_text_transparent_512.png|link=XZL_Studio DX|[[File:Nuvola Red.png|16px]] [[XZL_Studio DX]] (16ch, 24MHz; 2ch analog)
</gallery>


1 Only the logic analyzer functionality is supported so far, analog support is work in progress. 


== Oscilloscopes ==

<gallery widths=100px heights=100px>
File:Agilent DSO1014A.png|link=Agilent DSO1000 Series|[[File:Nuvola OK.png|16px]] [[Agilent DSO1000 Series]] (2-4ch, 2GS/s, 60-200MHz BW)
File:Fluke_Scopemeter_199B.png|link=Fluke ScopeMeter 199B|[[File:Nuvola OK.png|16px]] [[Fluke ScopeMeter 199B]] (2ch, 2.5GS/s, 200MHz BW)
File:Hameg HMO2024.png|link=Hameg HMO Compact|[[File:Nuvola OK.png|16px]] [[Hameg HMO Compact | Hameg HMO Compact Series]] (2-4ch, 2GS/s, 70-200MHz BW)
File:Hantek DSO-2090.png|link=Hantek DSO-2090|[[File:Nuvola OK.png|16px]] [[Hantek DSO-2090]] (2ch, 100MS/s, 40MHz)
File:Rigol DS1052E.png|link=Rigol DS1000 Series|[[File:Nuvola OK.png|16px]] [[Rigol DS1000 Series | Rigol DS1000E Series]] (2ch, 1GS/s, 50-150MHz BW)
File:Rigol-ds2072 mugshot.png|link=Rigol DS2000 Series|[[File:Nuvola OK.png|16px]] [[Rigol DS2000 Series]] (2ch, 2GS/s, 70-200MHz BW)
File:Rigol_VS5202D.png|link=Rigol VS5000 Series|[[File:Nuvola OK.png|16px]] [[Rigol VS5000 Series]] (2ch, 20-200MHz BW)
File:Focussz_fosc21_mugshot.png|link=Focussz Fosc21|[[File:Nuvola Orange.png|16px]] [[Focussz Fosc21]] (2ch, 8kS/s, 3kHz BW)
File:Hantek dso2250 mugshot.png|link=Hantek DSO-2250|[[File:Nuvola Orange.png|16px]] [[Hantek DSO-2250]] (2ch, 250MS/s, 100MHz BW)
File:Hantek dso-5200a device front.png|link=Hantek DSO-5200A|[[File:Nuvola Orange.png|16px]] [[Hantek DSO-5200A]] (2ch, 250MS/s, 200MHz BW)
File:OsciPrime.png|link=Nexus-Computing OsciPrime|[[File:Nuvola Orange.png|16px]] [[Nexus-Computing OsciPrime]] (2ch, ?MS/s, 3.3MHz-8MHz BW)
File:Velleman PCSU1000.png|link=Velleman PCSU1000|[[File:Nuvola Orange.png|16px]] [[Velleman PCSU1000]] (2ch, 1GS/s, 50MHz BW)

File:Sigrok_logo_no_text_transparent_512.png|link=Hantek DSO-1200|[[File:Nuvola Red.png|16px]] [[Hantek DSO-1200]] (2ch, 500MS/s, 200MHz BW)
File:Fluke scopemeter123.png|link=Fluke ScopeMeter 123|[[File:Nuvola Red.png|16px]] [[Fluke ScopeMeter 123]] (2ch, 25MS/s, 20MHz BW)
File:Sigrok_logo_no_text_transparent_512.png|link=Owon SDS|[[File:Nuvola Red.png|16px]] [[Owon SDS]] Series (2ch, 0.5-3.2GS/s, 60-300MHz BW)
File:Picoscope 2203.png|link=Pico Technology PicoScope 2203|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 2203]] (40/20MS/s, 5MHz BW)
File:PicoScope_2205.png|link=Pico Technology PicoScope 2205|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 2205]] (200/100MS/s, 25MHz BW)
File:Picoscope 3206.png|link=Pico Technology PicoScope 3206|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 3206]] (200/100MS/s, 200MHz BW)
File:Picoscope 5203.png|link=Pico Technology PicoScope 5203|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 5203]] (1/0.5GS/s, 250MHz BW)
File:Usbduxfast.png|link=Incite Technology USB-DUXfast|[[File:Nuvola Red.png|16px]] [[Incite Technology USB-DUXfast]] (16ch, 3MHz, ? BW)
File:UNI-T UTD2042C.png|link=UNI-T UTD2042C|[[File:Nuvola Red.png|16px]] [[UNI-T UTD2042C]] (2ch, 500MS/s, 40MHz BW)
File:Voltcraft dso-220 usb.png|link=Voltcraft DSO-220|[[File:Nuvola Red.png|16px]] [[Voltcraft DSO-220]] (2ch, 60MS/s, 20MHz BW)
File:Voltcraft DSO-3062C.png|link=Voltcraft DSO-3062C|[[File:Nuvola Red.png|16px]] [[Voltcraft DSO-3062C]] (2ch, 1GS/s, 60MHz BW)
</gallery>

== Multimeters ==

<gallery widths="100px" heights="100px">
File:Sigrok_logo_no_text_transparent_512.png|link=Agilent U1231A|[[File:Nuvola OK.png|16px]] [[Agilent U1231A]] (6000 counts, USB/Bluetooth)
File:Agilent U1232A.png|link=Agilent U1232A|[[File:Nuvola OK.png|16px]] [[Agilent U1232A]] (6000 counts, USB/Bluetooth)
File:Sigrok_logo_no_text_transparent_512.png|link=Agilent U1233A|[[File:Nuvola OK.png|16px]] [[Agilent U1233A]] (6000 counts, USB/Bluetooth)
File:Sigrok_logo_no_text_transparent_512.png|link=BBC Goertz Metrawatt M2110|[[File:Nuvola OK.png|16px]] [[BBC Goertz Metrawatt M2110]] (30000 counts, RS232)
File:Bm_857_mugshot_500000.png|link=Brymen BM857|[[File:Nuvola OK.png|16px]] [[Brymen BM857]] (50000 counts, RS232)
File:Digitek_dt4000zc_device_front.png|link=Digitek DT4000ZC|[[File:Nuvola OK.png|16px]] [[Digitek DT4000ZC]] (4000 counts, RS232)
File:Fluke 187.png|link=Fluke 187/189|[[File:Nuvola OK.png|16px]] [[Fluke 187/189]] (50000 counts, RS232)
File:Fluke 287.png|link=Fluke 287/289|[[File:Nuvola OK.png|16px]] [[Fluke 287/289]] (50000 counts, RS232)
File:Gmc metrahit 14a logo.png|link=Gossen Metrawatt Metrahit 14A|[[File:Nuvola OK.png|16px]] [[Gossen Metrawatt Metrahit 14A]] (3100 counts, RS232)
File:Gossen Metrawatt Metrahit 16I small.png|link=Gossen Metrawatt Metrahit 16I|[[File:Nuvola OK.png|16px]] [[Gossen Metrawatt Metrahit 16I]] (3100 counts, RS232)
File:Gossen Metrawatt Metrahit 18S small.png|link=Gossen Metrawatt Metrahit 18S|[[File:Nuvola OK.png|16px]] [[Gossen Metrawatt Metrahit 18S]] (31000 counts, RS232)
File:100px_Idm103n.png|link=ISO-TECH IDM103N|[[File:Nuvola OK.png|16px]] [[ISO-TECH IDM103N]] (4000 counts, RS232)
File:Mastech mas345 device front.png|link=MASTECH MAS345|[[File:Nuvola OK.png|16px]] [[MASTECH MAS345]] (4000 counts, RS232)
File:Metex m4650cr mugshot.png|link=Metex M-4650CR|[[File:Nuvola OK.png|16px]] [[Metex M-4650CR]] (20000 counts, RS232)
File:Norma dm950.png|link=Norma DM950|[[File:Nuvola OK.png|16px]] [[Norma DM950]] (21000 counts, RS232)
File:Pce-pce-dm32.png|link=PCE PCE-DM32|[[File:Nuvola OK.png|16px]] [[PCE PCE-DM32]] (4000 counts, RS232)
File:Metex_me-31.png|link=PeakTech 3410|[[File:Nuvola OK.png|16px]] [[PeakTech 3410]] (4000 counts, RS232)
File:Peaktech 4370 device front.png|link=PeakTech 4370|[[File:Nuvola OK.png|16px]] [[PeakTech 4370]] (2000 counts, RS232)
File:Rs_22_168_mugshot.png|link=RadioShack 22-168|[[File:Nuvola OK.png|16px]] [[RadioShack 22-168]] (2000 counts, RS232)
File:Rs_22-805_front.png|link=RadioShack 22-805|[[File:Nuvola OK.png|16px]] [[RadioShack 22-805]] (4000 counts, RS232)
File:radioshack_22_812_front.png|link=RadioShack 22-812|[[File:Nuvola OK.png|16px]] [[RadioShack 22-812]] (4000 counts, RS232)
File:Siemens B1105 small.png|link=Siemens B1105|[[File:Nuvola OK.png|16px]] [[Siemens B1105]] (310000 counts, RS232)
File:Tecpel dmm8061.png|link=Tecpel DMM-8061|[[File:Nuvola OK.png|16px]] [[Tecpel DMM-8061]] (4000 counts, RS232/USB)
File:Tp4000zc_front.png|link=TekPower TP4000ZC|[[File:Nuvola OK.png|16px]] [[TekPower TP4000ZC]] (4000 counts, RS232)
File:Tenma 72-7745.png|link=Tenma 72-7745|[[File:Nuvola OK.png|16px]] [[Tenma 72-7745]] (4000 counts, RS232/USB)
File:Ut60e_-_front_-_alpha.png|link=UNI-T UT60E|[[File:Nuvola OK.png|16px]] [[UNI-T UT60E]] (4000 counts, RS232/USB)
File:Uni-t ut61b mugshot.png|link=UNI-T UT61B|[[File:Nuvola OK.png|16px]] [[UNI-T UT61B]] (4000 counts, RS232/USB)
File:Uni-t ut61c mugshot.png|link=UNI-T UT61C|[[File:Nuvola OK.png|16px]] [[UNI-T UT61C]] (6000 counts, RS232/USB)
File:Uni t ut61d device.png|link=UNI-T UT61D|[[File:Nuvola OK.png|16px]] [[UNI-T UT61D]] (6000 counts, RS232/USB)
File:Old ver front.png|link=UNI-T UT61E|[[File:Nuvola OK.png|16px]] [[UNI-T UT61E]] (22000 counts, RS232/USB)
File:Va_va18b.png|link=V&A VA18B|[[File:Nuvola OK.png|16px]] [[V&A VA18B]] (6000 counts, USB)
File:Va va40b mugshot.png|link=V&A VA40B|link=V&A VA40B|[[File:Nuvola OK.png|16px]] [[V&A VA40B]] (6000 counts, USB)
File:Victor 86c device front.png|link=Victor 86C|[[File:Nuvola OK.png|16px]] [[Victor 86C]] (4000 counts, USB)
File:Victor 70C.png|link=Victor 70C|[[File:Nuvola OK.png|16px]] [[Victor 70C]] (4000 counts, USB)
File:Voltcraft_M-3650D_transparent.png|link=Voltcraft M-3650D|[[File:Nuvola OK.png|16px]] [[Voltcraft M-3650D]] (2000 counts, RS232)
File:Voltcraft m4650cr.png|link=Voltcraft M-4650CR|[[File:Nuvola OK.png|16px]] [[Voltcraft M-4650CR]] (20000 counts, RS232)
File:Voltcraft vc820 device.png|link=Voltcraft VC-820|[[File:Nuvola OK.png|16px]] [[Voltcraft VC-820]] (4000 counts, RS232/USB)
File:Voltcraft vc830.png|link=Voltcraft VC-830|[[File:Nuvola OK.png|16px]] [[Voltcraft VC-830]] (6000 counts, RS232/USB)
File:Voltcraft vc840 device front.png|link=Voltcraft VC-840|[[File:Nuvola OK.png|16px]] [[Voltcraft VC-840]] (4000 counts, RS232/USB)

File:Tenma 72-1016.png|link=Tenma 72-1016|[[File:Nuvola Orange.png|16px]] [[Tenma 72-1016]] (6000 counts, RS232/USB)
File:Tenma 72-7730.png|link=Tenma 72-7730|[[File:Nuvola Orange.png|16px]] [[Tenma 72-7730]] (20000 counts, RS232/USB)
File:Tenma 72-7732.png|link=Tenma 72-7732|[[File:Nuvola Orange.png|16px]] [[Tenma 72-7732]] (40000 counts, RS232/USB)
File:Tenma 72-7750.png|link=Tenma 72-7750|[[File:Nuvola Orange.png|16px]] [[Tenma 72-7750]] (6000 counts, RS232/USB)
File:Tenma 72-9380A.png|link=Tenma 72-9380A|[[File:Nuvola Orange.png|16px]] [[Tenma 72-9380A]] (40000 counts, RS232/USB)
File:Voltcraft m-3650cr.png|link=Voltcraft M-3650CR|[[File:Nuvola Orange.png|16px]] [[Voltcraft M-3650CR]] (2000 counts, RS232)

File:Appa 107.png|link=APPA 107|[[File:Nuvola Red.png|16px]] [[APPA 107]] (4000 / 20000 counts, RS232)
File:Digitek dt8000.png|link=Digitek DT8000|[[File:Nuvola Red.png|16px]] [[Digitek DT8000]] (8000 counts, RS232)
File:Digitek dt80000.png|link=Digitek DT80000|[[File:Nuvola Red.png|16px]] [[Digitek DT80000]] (80000 counts, RS232)
File:Escort 179 device front.png|link=Escort 179|[[File:Nuvola Red.png|16px]] [[Escort 179]] (10000 counts, RS232)
File:Gossen metrahit 30m.png|link=Gossen-Metrawatt METRAHIT 30M|[[File:Nuvola Red.png|16px]] [[Gossen-Metrawatt METRAHIT 30M]] (1200000 counts, RS232/USB)
File:800px-Mastech m9803r device front.png|link=MASTECH M9803R|[[File:Nuvola Red.png|16px]] [[MASTECH M9803R]] (4000 counts, RS232)
File:Metrix mx53.png|link=Metrix MX53|[[File:Nuvola Red.png|16px]] [[Metrix MX53]] (50000 counts, RS232)
File:Metrix mx56c.png|link=Metrix MX56C|[[File:Nuvola Red.png|16px]] [[Metrix MX56C]] (50000 counts, RS232)
File:Sigrok_logo_no_text_transparent_512.png|link=Protek 6500|[[File:Nuvola Red.png|16px]] [[Protek 6500]] (50000 counts, RS232)
File:Voltcraft m3890dt usb.png|link=Voltcraft M-3890DT|[[File:Nuvola Red.png|16px]] [[Voltcraft M-3890DT]] (4000 counts, USB)
File:Voltcraft m4660a device front.png|link=Voltcraft M-4660A|[[File:Nuvola Red.png|16px]] [[Voltcraft M-4660A]] (20000 counts, RS232)
File:Voltcraft vc920.png|link=Voltcraft VC-920|[[File:Nuvola Red.png|16px]] [[Voltcraft VC-920]] (40000/4000 counts, RS232/USB)
File:Voltcraft vc940.png|link=Voltcraft VC-940|[[File:Nuvola Red.png|16px]] [[Voltcraft VC-940]] (40000/4000 counts, RS232/USB)
</gallery>

== LCR meters ==

<gallery widths="100px" heights="100px">
File:Voltcraft4080_2.png|link=Voltcraft 4080|[[File:Nuvola Orange.png|16px]] [[Voltcraft 4080]] (serial)
</gallery>

== Sound level meters ==

<gallery widths="100px" heights="100px">
File:CEM DT-8852.png|link=CEM DT-8852|[[File:Nuvola OK.png|16px]] [[CEM DT-8852]] (USB)
File:Colead SL-5868P.png|link=Colead SL-5868P|[[File:Nuvola OK.png|16px]] [[Colead SL-5868P]] (RS232)
File:Kecheng KC-330B.png|link=Kecheng KC-330B|[[File:Nuvola OK.png|16px]] [[Kecheng KC-330B]] (RS232)
File:Tondaj sl-814.png|link=Tondaj SL-814|[[File:Nuvola OK.png|16px]] [[Tondaj SL-814]] (USB)
File:Voltcraft_DL-161S.png|link=Voltcraft DL-161S|[[File:Nuvola Orange.png|16px]] [[Voltcraft DL-161S]] (USB)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (also: light-/thermo-/hygrometer; RS232)
File:Voltcraft_dl_160s.png|link=Voltcraft DL-160S|[[File:Nuvola Red.png|16px]] [[Voltcraft DL-160S]] (USB)
</gallery>

== Thermometers ==

<gallery widths="100px" heights="100px">
File:rs55ii.png|link=APPA 55II|[[File:Nuvola OK.png|16px]] [[APPA 55II]] (2xtemp, RS232)
File:EL-USB-2.png|link=Lascar Electronics EL-USB-2|[[File:Nuvola OK.png|16px]] [[Lascar Electronics EL-USB-2]] (1xtemp, 1xhum, USB)
File:Mic 98581.png|link=MIC 98581|[[File:Nuvola OK.png|16px]] [[MIC 98581]] (1xtemp, USB)
File:Mic 98583.png|link=MIC 98583|[[File:Nuvola OK.png|16px]] [[MIC 98583]] (1xtemp, 1xhum, USB)
File:Uni-t ut325 front.png|link=UNI-T UT325|[[File:Nuvola OK.png|16px]] [[UNI-T UT325]] (2xtemp, USB)
File:Voltcraft k204.png|link=Voltcraft K204|[[File:Nuvola OK.png|16px]] [[Voltcraft K204]] (4xtemp, RS232)
File:Elitech rc3.png|link=Elitech RC-3|[[File:Nuvola Red.png|16px]] [[Elitech RC-3]] (1xtemp, RS232)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (1xtemp, RS232)
File:Rding temper front.png|link=RDing TEMPer|[[File:Nuvola Red.png|16px]] [[RDing TEMPer]] (1xtemp, USB)
File:Rding temper gold device front.png|link=RDing TEMPer Gold|[[File:Nuvola Red.png|16px]] [[RDing TEMPer Gold]] (1xtemp, USB)
File:Rding temper1 device front.png|link=RDing TEMPer1|[[File:Nuvola Red.png|16px]] [[RDing TEMPer1]] (1xtemp, USB)
File:Pcsensor_temper1k2.png|link=RDing TEMPer1K2|[[File:Nuvola Red.png|16px]] [[RDing TEMPer1K2]] (1xtemp, USB)
File:Voltcraft dl-120th.png|link=Voltcraft DL-120TH|[[File:Nuvola Red.png|16px]] [[Voltcraft DL-120TH]] (1xtemp, USB)
File:Voltcraft dl-140th.png|link=Voltcraft DL-140TH|[[File:Nuvola Red.png|16px]] [[Voltcraft DL-140TH]] (1xtemp, USB)
</gallery>

== Hygrometers ==

<gallery widths="100px" heights="100px">
File:EL-USB-2.png|link=Lascar Electronics EL-USB-2|[[File:Nuvola OK.png|16px]] [[Lascar Electronics EL-USB-2]] (temp/humidity, USB)
File:Mic 98583.png|link=MIC 98583|[[File:Nuvola OK.png|16px]] [[MIC 98583]] (temp/humidity, USB)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (also: light-/soundlevelmeter; RS232)
File:Silabs si7005usb dgl eb top.jpg|link=SiLabs Si7005USB-Dongle|[[File:Nuvola Red.png|16px]] [[SiLabs Si7005USB-Dongle]] (USB)
</gallery>

== Anemometers ==

<gallery widths="100px" heights="100px">
File:Mastech ms6252b.png|link=MASTECH MS6252B|[[File:Nuvola Red.png|16px]] [[MASTECH MS6252B]] (USB)
</gallery>

== Light meters ==

<gallery widths="100px" heights="100px">
File:Lutron YK-2005LX.png|link=Lutron YK-2005LX|[[File:Nuvola Red.png|16px]] [[Lutron YK-2005LX]] (RS232)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (RS232)
</gallery>

== Energy meters ==

<gallery widths="100px" heights="100px">
File:Actaris_a14c5_teleinfo.png|link=EDF Teleinfo|[[File:Nuvola OK.png|16px]] [[EDF Teleinfo]] (USB)
</gallery>

== DAQs ==

<gallery widths="100px" heights="100px">
File:Ni usb 6008.png|link=NI USB-6008|[[File:Nuvola Red.png|16px]] [[NI USB-6008]] (8/2 analog inputs/outputs, 12 digital I/Os)
</gallery>

== Dataloggers ==

<gallery widths="100px" heights="100px">
File:EL-USB-CO.png|link=Lascar Electronics EL-USB-CO|[[File:Nuvola OK.png|16px]] [[Lascar Electronics EL-USB-CO]] (carbon monoxide (CO) logger, USB)
File:Gsg_indoor_air_monitor.png|link=GSG Indoor Air Monitor|[[File:Nuvola Red.png|16px]] [[GSG Indoor Air Monitor]] (air quality monitor, USB)
File:Maul_studio_i.png|link=MAUL studio i|[[File:Nuvola Red.png|16px]] [[MAUL studio i]] (weighing scale, RS232)
File:Voltcraft co-20.png|link=Voltcraft CO-20|[[File:Nuvola Red.png|16px]] [[Voltcraft CO-20]] (air quality monitor, USB)
</gallery>

== Function generators ==

<gallery widths="100px" heights="100px">
File:Hantek DDS-3X25 top.png|link=Hantek DDS-3X25|[[File:Nuvola Red.png|16px]] [[Hantek DDS-3X25]] (25MHz, PC-based, USB)
File:Siglent sdg1010 device front 8116.png|link=Siglent SDG1010|[[File:Nuvola Red.png|16px]] [[Siglent SDG1010]] (10MHz, USB)
</gallery>

== RF receivers ==

<gallery widths="100px" heights="100px">
File:Per vices noctar.png|link=Per Vices Noctar|[[File:Nuvola Red.png|16px]] [[Per Vices Noctar]] (100kHz-4GHz, IQ modulator/demodulator, PCIe)
</gallery>

== Spectrum analyzers ==

TODO.

== Power supplies ==

<gallery widths="100px" heights="100px">
File:Atten PPS3203T-3S.png|link=Atten PPS3203T-3S|[[File:Nuvola OK.png|16px]] [[Atten PPS3203T-3S]] (3ch, 2*0-32V, 1*0-6V at 0-3A, USB&RS232)
File:Sigrok logo no text transparent 512.png|link=ATTEN_ATZ9711|[[File:Nuvola Red.png|16px]] [[ATTEN ATZ9711]] (DC electronic load, 150W/0~30A/0~150V, USB)
File:Sigrok logo no text transparent 512.png|link=Conrad DIGI 35 CPU|[[File:Nuvola Red.png|16px]] [[Conrad DIGI 35 CPU]] (1ch, 0-35V/0-2.55A, RS232)
File:Manson hcs3202.png|link=Manson HCS-3202|[[File:Nuvola Red.png|16px]] [[Manson HCS-3202]] (1ch, 1-36V/0-10A, USB)
File:PS3005D front on.JPG|link=Velleman PS3005D|[[File:Nuvola Red.png|16px]] [[Velleman PS3005D]] (1ch, 0-30V/0-5A, USB&RS232)
</gallery>

== GPIB interfaces ==

<gallery widths="100px" heights="100px">
File:Beiming_s82357.png|link=Beiming S82357|[[File:Nuvola Red.png|16px]] [[Beiming S82357]] (hardware-based, USB)
File:ICS 488-USB.png|link=ICS 488-USB|[[File:Nuvola Red.png|16px]] [[ICS 488-USB]] (hardware-based, USB)
File:GPIB-USB 82357B clone.png|link=GPIB-USB 82357B clone|[[File:Nuvola Red.png|16px]] [[GPIB-USB 82357B clone]] (hardware-based, USB)
File:NI GPIB-ENET.png|link=National Instruments GPIB-ENET|[[File:Nuvola Red.png|16px]] [[National Instruments GPIB-ENET]] (hardware-based, Ethernet)
File:NI GPIB-USB-HS.png|link=National Instruments GPIB-USB-HS|[[File:Nuvola Red.png|16px]] [[National Instruments GPIB-USB-HS]] (hardware-based, USB)
File:Prologix-usb.png|link=Prologix GPIB-USB|[[File:Nuvola Red.png|16px]] [[Prologix GPIB-USB]] (firmware-based, USB)
</gallery>

== Potential other candidates ==

If you own any other logic analyzers, oscilloscopes, multimeters, dataloggers, ... and want to add support for them in sigrok (or donate/lend devices to developers), please let us know. We're always happy to add more hardware support! Join the [https://lists.sourceforge.net/lists/listinfo/sigrok-devel mailing list] or ask on [irc://chat.freenode.net/sigrok IRC #sigrok] if you want to help out.

__FORCETOC__

Noname XL-LOGIC16-100M

2014-01-29T15:42:45Z

Karlp:

{{Infobox logic analyzer
| image = [[File:xl-logic16-100m-external.jpg|180px]]
| name = Noname XL-LOGIC16-100M
| status = planned
| source_code_dir =
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = ?
| voltages = ?
| threshold = ?
| memory = ?
| compression = ?
| website = [http://www.aliexpress.com/item/Free-shipping-Saleae-Logic16-Saleae16-100MHz-logic-analyzer-real-USB-interface-V2/1399553156.html aliexpress.com]
}}

The '''XL-LOGIC16-100M''' is a USB-based, 16-channel logic analyzer with up to 100MHz sampling rate. It is labelled and sold as a [[Saleae Logic16]] Clone, and comes with "modified" Saleae Logic software on a cdrom. The existing Saleae Logic16 support in sigrok detects this device as an original, but fails to initialize the FPGA for capture. (at the time of writing)

See [[XL-LOGIC16-100M/Info]] for more details (such as '''lsusb -v''' output) about the device. (if ever desired)

== Hardware ==
A single phillips head screw holds the case together. The parts selection seem to be almost identical to the [[WayEngineer_Saleae16]] but that page doesn't have any internal photos for full comparison.

Most notable are the complete lack of test points or programming headers! There are some unpopulated resistor/capacitor pairs on the backside,

* '''FPGA''': [http://www.xilinx.com/support/index.html/content/xilinx/en/supportNav/silicon_devices/fpga/spartan-3a.html Xilinx Spartan-3A XC3S200A], 200K gates ([http://www.xilinx.com/support/documentation/data_sheets/ds529.pdf datasheeet])
* '''USB interface chip''': [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A-56PVXC (FX2LP)] ([http://www.cypress.com/?docID=34060 datasheet])
* '''I2C EEPROM''': 2Kbit [http://www.atmel.com/devices/AT24C02B.aspx Atmel 24C02B] (markings: "ATMEL317 24C02BN SU27 D") ([http://www.atmel.com/Images/doc5126.pdf datasheet])
* '''3.3V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-3.3] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''1.2V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-1.2] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''Crystal:''' 24.000

Three LEDs, USB (green) COM (blue) and RUN (red) are on the board.

== Photos ==

<gallery>
File:xl-logic16-100m-external.jpg
File:xl-logic16-100m-pcb-top.jpg
File:xl-logic16-100m-pcb-bottom.jpg
</gallery>

== Firmware ==

=== Firmware and FPGA bitstream usage ===

You can use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=tree;f=firmware/saleae-logic16 sigrok-fwextract-saleae-logic16] tool to extract (from the "Logic" Linux binary) the FX2 firmware and the FPGA bitstreams, exactly [[Saleae_Logic16 | as for a real Logic 16]]. Note, the md5sum of the fx2 firmware is identical to the original Saleae firmware, but the fpga bitstreams are different. Attempting to connect to this device with the "modified" fpga bitstream, which _works_ with the vendor supplied "modified" Logic software fails to load in sigrok, with a FPGA version mismatch. The fx2 firmware loads successfully, at least in as much as the LED blinks a heartbeat pattern as expected.

== Protocol ==

Presumably as per [[Saleae_Logic16 | Logic16]]

== Resources ==

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Planned]]

Noname XL-LOGIC16-100M

2014-01-29T15:38:32Z

Karlp:

{{Infobox logic analyzer
| image = [[File:xl-logic16-100m-external.jpg|180px]]
| name = Noname XL-LOGIC16-100M
| status = planned
| source_code_dir =
| channels = 3/6/9/16
| samplerate = 100/50/32/16MHz
| samplerate_state = —
| triggers = ?
| voltages = ?
| threshold = ?
| memory = ?
| compression = ?
| website = [http://www.aliexpress.com/item/Free-shipping-Saleae-Logic16-Saleae16-100MHz-logic-analyzer-real-USB-interface-V2/1399553156.html aliexpress.com]
}}

The '''XL-LOGIC16-100M''' is a USB-based, 16-channel logic analyzer with up to 100MHz sampling rate. It is labelled and sold as a [[Saleae Logic16]] Clone, and comes with "modified" Saleae Logic software on a cdrom.
The existing Saleae Logic16 support detects this device as an original, but fails to initialize the FPGA for capture.

See [[XL-LOGIC16-100M/Info]] for more details (such as '''lsusb -v''' output) about the device. (if ever desired)

== Hardware ==
A single phillips head screw holds the case together. The parts selection seem to be almost identical to the [[WayEngineer_Saleae16]] but that page doesn't have any internal photos for full comparison.

Most notable are the complete lack of test points or programming headers! There are some unpopulated resistor/capacitor pairs on the backside,

* '''FPGA''': [http://www.xilinx.com/support/index.html/content/xilinx/en/supportNav/silicon_devices/fpga/spartan-3a.html Xilinx Spartan-3A XC3S200A], 200K gates ([http://www.xilinx.com/support/documentation/data_sheets/ds529.pdf datasheeet])
* '''USB interface chip''': [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A-56PVXC (FX2LP)] ([http://www.cypress.com/?docID=34060 datasheet])
* '''I2C EEPROM''': 2Kbit [http://www.atmel.com/devices/AT24C02B.aspx Atmel 24C02B] (markings: "ATMEL317 24C02BN SU27 D") ([http://www.atmel.com/Images/doc5126.pdf datasheet])
* '''3.3V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-3.3] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''1.2V voltage regulator''': [http://www.advanced-monolithic.com/products/voltreg.html#1117 Advanced Monolithic Systems AMS1117-1.2] ([http://ams-semitech.com/attachments/File/AMS1117_20120314.pdf datasheet], [http://www.advanced-monolithic.com/pdf/ds1117.pdf older datasheet])
* '''Crystal:''' 24.000

Three LEDs, USB (green) COM (blue) and RUN (red) are on the board.

== Photos ==

<gallery>
File:xl-logic16-100m-external.jpg
File:xl-logic16-100m-pcb-top.jpg
File:xl-logic16-100m-pcb-bottom.jpg
</gallery>

== Firmware ==

=== Firmware and FPGA bitstream usage ===

You can use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=tree;f=firmware/saleae-logic16 sigrok-fwextract-saleae-logic16] tool to extract (from the "Logic" Linux binary) the FX2 firmware and the FPGA bitstreams, exactly [[Saleae_Logic16 | as for a real Logic 16]]. Note, the md5sum of the fx2 firmware is identical to the original Saleae firmware, but the fpga bitstreams are different. Attempting to connect to this device with the "modified" fpga bitstream, which _works_ with the vendor supplied "modified" Logic software fails to load in sigrok, with a FPGA version mismatch. The fx2 firmware loads successfully, at least in as much as the LED blinks a heartbeat pattern as expected.

== Protocol ==

Presumably as per [[Saleae_Logic16 | Logic16]]

== Resources ==

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Planned]]

Supported hardware

2014-01-29T15:21:33Z

Karlp: fixed image for xl-logic16-100m

sigrok is intended as a flexible, cross-platform, and '''hardware-independent''' software suite, i.e., it supports various devices from many different vendors.

Here is a list of currently supported devices (various stages of completeness) and devices we plan to support in the near future.

The lists are sorted by category (supported: [[:Category:Supported|{{PAGESINCATEGORY:Supported|pages}}]], in progress: [[:Category:In progress|{{PAGESINCATEGORY:In progress|pages}}]], planned: [[:Category:Planned|{{PAGESINCATEGORY:Planned|pages}}]]), and alphabetically within those categories.

== Logic analyzers ==

<gallery widths="100px" heights="100px">
File:ARMFLY MINI LOGIC.png|link=ARMFLY Mini-Logic|[[File:Nuvola OK.png|16px]] [[ARMFLY Mini-Logic]] (8ch, 24MHz)
File:ASIX SIGMA 2.png|link=ASIX SIGMA|[[File:Nuvola OK.png|16px]] [[ASIX SIGMA]] (16ch, 200MHz)
File:Braintechnology_usb_interface_v26.png|link=Braintechnology USB Interface V2.x|[[File:Nuvola OK.png|16px]] [[Braintechnology USB Interface V2.x]] (8/16ch, 24/12MHz)
File:Braintechnology_usb_lps.png|link=Braintechnology USB-LPS|[[File:Nuvola OK.png|16px]] [[Braintechnology USB-LPS]] (8/16ch, 24/12MHz)
File:Chronovu la8 front.png|link=ChronoVu LA8|[[File:Nuvola OK.png|16px]] [[ChronoVu LA8]] (8ch, 100MHz)
File:Cwav_usbee_sx.png|link=CWAV USBee SX|[[File:Nuvola OK.png|16px]] [[CWAV USBee SX]] (8ch, 100MHz)
File:Buspirate_v3.png|link=Dangerous Prototypes Buspirate|[[File:Nuvola OK.png|16px]] [[Dangerous Prototypes Buspirate]] (5ch, 1MHz)
File:Dangerous prototypes irtoy top.jpg|link=Dangerous Prototypes USB IR Toy|[[File:Nuvola OK.png|16px]] [[Dangerous Prototypes USB IR Toy]] (1ch, 10kHz)
File:Eeelec xla esla100.png|link=EE Electronics ESLA100|[[File:Nuvola OK.png|16px]] [[EE Electronics ESLA100]] (8ch, 24MHz)
File:Ikalogic_scanalogic2.png|link=IKALOGIC Scanalogic-2|[[File:Nuvola OK.png|16px]] [[IKALOGIC Scanalogic-2]] (4ch, 20MHz)
File:Ikalogic scanaplus mugshot.png|link=IKALOGIC ScanaPLUS|[[File:Nuvola OK.png|16px]] [[IKALOGIC ScanaPLUS]] (9ch, 100MHz)
File:Kingst kqs3506 la16100.png|link=KingST KQS3506-LA16100|[[File:Nuvola OK.png|16px]] [[KingST KQS3506-LA16100]] (16ch, 100/50/32/16MHz @ 3/6/9/16ch)
File:Lcsoft-miniboard-front.png|link=Lcsoft Mini Board|[[File:Nuvola OK.png|16px]] [[Lcsoft Mini Board]] (8/16ch, 24/12MHz)
File:logic-shrimp-front.png|link=Logic Shrimp|[[File:Nuvola OK.png|16px]] [[Logic Shrimp]] (4ch, 20MHz)
File:Mcu123 saleae logic clone.png|link=MCU123 Saleae Logic clone|[[File:Nuvola OK.png|16px]] [[MCU123 Saleae Logic clone]] (8ch, 24MHz)
File:Usbee_ax_clone_front.png|link=MCU123 USBee AX Pro clone|[[File:Nuvola OK.png|16px]] [[MCU123 USBee AX Pro clone]] (8ch, 24MHz)
File:Openbench logic sniffer front.png|link=Openbench Logic Sniffer|[[File:Nuvola OK.png|16px]] [[Openbench Logic Sniffer]] (32ch, 100MHz)
File:Robomotic buglogic3.png|link=Robomotic BugLogic 3|[[File:Nuvola OK.png|16px]] [[Robomotic BugLogic 3]] (8ch, 24MHz)
File:Robomotic_minilogic.png|link=Robomotic MiniLogic|[[File:Nuvola OK.png|16px]] [[Robomotic MiniLogic]] (8ch, 24MHz)
File:Saleae Logic.png|link=Saleae Logic|[[File:Nuvola OK.png|16px]] [[Saleae Logic]] (8ch, 24MHz)
File:Saleae_Logic16_bottom.png|link=Saleae Logic16|[[File:Nuvola OK.png|16px]] [[Saleae Logic16]] (16ch, 100/50/32/16MHz @ 3/6/9/16ch)
File:Sysclk lwla1034 mugshot.png|link=Sysclk LWLA1034|[[File:Nuvola OK.png|16px]] [[Sysclk LWLA1034]] (34ch, 125MHz)
File:Wayengineer saleae16.png|link=WayEngineer Saleae16|[[File:Nuvola OK.png|16px]] [[WayEngineer Saleae16]] (16ch, 100/50/32/16MHz @ 3/6/9/16ch)
File:Zeroplus Logic Cube.png|link=ZEROPLUS Logic Cube LAP-C(16032)|[[File:Nuvola OK.png|16px]] [[ZEROPLUS Logic Cube LAP-C(16032)]] (16ch, 100MHz)
File:Zeroplus_lap-16128u.png|link=ZEROPLUS LAP-16128U|[[File:Nuvola OK.png|16px]] [[ZEROPLUS LAP-16128U]] (16ch, 200MHz)

File:Chronovu la16.png|link=ChronoVu LA16|[[File:Nuvola Orange.png|16px]] [[ChronoVu LA16]] (16ch, 200MHz)
File:Rockylogic_ant8.png|link=RockyLogic Ant8|[[File:Nuvola Orange.png|16px]] [[RockyLogic Ant8]] (8ch, 500MHz)
File:RockyLogic Ant18e.png|link=RockyLogic Ant18e|[[File:Nuvola Orange.png|16px]] [[RockyLogic Ant18e]] (8ch, 1GHz)

File:Acute_pkla1216.png|link=Acute PKLA-1216|[[File:Nuvola Red.png|16px]] [[Acute PKLA-1216]] (16ch, 200MHz)
File:Hantek 4032l mugshot.png|link=Hantek 4032L|[[File:Nuvola Red.png|16px]] [[Hantek 4032L]] (32ch, 400MHz)
File:Ideofy_la_08.png|link=Ideofy LA-08|[[File:Nuvola Red.png|16px]] [[Ideofy LA-08]] (8ch, 96/60/30MHz @ 2/4/8ch)
File:Intronix Logicport.png|link=Intronix Logicport LA1034|[[File:Nuvola Red.png|16px]] [[Intronix Logicport LA1034]] (34ch, 500MHz)
File:Sigrok_logo_no_text_transparent_512.png|link=Link Instruments LA-5580|[[File:Nuvola Red.png|16px]] [[Link Instruments LA-5580]] (80ch, 500MHz)
File:Microchip_pickit2.png|link=Microchip PICkit2|[[File:Nuvola Red.png|16px]] [[Microchip PICkit2]] (3ch, 1MHz)
File:Minila parport.png|link=MiniLA|[[File:Nuvola Red.png|16px]] [[MiniLA]] (32ch, 100MHz)
File:Minila_mockup.png|link=MiniLA Mockup|[[File:Nuvola Red.png|16px]] [[MiniLA Mockup]] (32ch, 100MHz)
File:Noname_la16_mugshot.png|link=Noname LA16|[[File:Nuvola Red.png|16px]] [[Noname LA16]] (16ch, 100MHz)
File:Xl-logic16-100m-external.jpg|link=Noname XL-LOGIC16-100M|[[File:Nuvola Red.png|16px]] [[Noname XL-LOGIC16-100M]] (Salaea Logic16 Clone)
File:Sysclk lwla1016.png|link=Sysclk LWLA1016|[[File:Nuvola Red.png|16px]] [[Sysclk LWLA1016]] (16ch, 100MHz)
File:Sysclk lwla2034 mugshot.png|link=Sysclk LWLA2034|[[File:Nuvola Red.png|16px]] [[Sysclk LWLA2034]] (34ch, 200MHz)
File:Techtools_digiview_dv1-100.png|link=TechTools DigiView DV1-100|[[File:Nuvola Red.png|16px]] [[TechTools DigiView DV1-100]] (18ch, 100MHz)
File:Xmos xtag2.png|link=XMOS XTAG-2|[[File:Nuvola Red.png|16px]] [[XMOS XTAG-2]] (?ch, 50MHz)
File:Sigrok_logo_no_text_transparent_512.png|link=ZEROPLUS Logic Cube LAP-C(322000)|[[File:Nuvola Red.png|16px]] [[ZEROPLUS Logic Cube LAP-C(322000)]] (32ch, 200MHz)
File:Zlg_la1032.png|link=ZLG LA1032|[[File:Nuvola Red.png|16px]] [[ZLG LA1032]] (32ch, 100MHz)
</gallery>

== Mixed-signal devices ==

<gallery widths=105px heights=105px>
File:Armfly_ax_pro.png|link=ARMFLY AX-Pro|[[File:Nuvola OK.png|16px]] [[ARMFLY AX-Pro]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 40MHz BW)
File:Sysclk ax pro mugshot.png|link=Sysclk AX-Pro|[[File:Nuvola OK.png|16px]] [[Sysclk AX-Pro]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 3MHz BW)
File:Esla201a.png|link=EE Electronics ESLA201A|[[File:Nuvola OK.png|16px]] [[EE Electronics ESLA201A]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 40MHz BW)
File:Rigol DS1052E.png|link=Rigol DS1000 Series|[[File:Nuvola OK.png|16px]] [[Rigol DS1000 Series|Rigol DS1000D Series]] (16ch, 2ch analog, 50-150MHz BW)
File:Rigol_VS5202D.png|link=Rigol VS5000 Series|[[File:Nuvola OK.png|16px]] [[Rigol VS5000 Series|Rigol VS5000D Series]] (16ch, 2ch analog, 20-200MHz BW
File:Xzl studio ax mugshot.png|link=XZL_Studio AX|[[File:Nuvola OK.png|16px]] [[XZL_Studio AX]]1 (8ch, 24MHz; 2ch analog, 24MSa/s, 40MHz BW)
File:BitScope BS10.png|link=BitScope BS10|[[File:Nuvola Orange.png|16px]] [[BitScope BS10]] (8ch, 40MHz; 2ch analog, 20MSa/s, ? BW)
File:Link Instruments MSO-19 front.png|link=Link Instruments MSO-19|[[File:Nuvola Orange.png|16px]] [[Link Instruments MSO-19]] (8ch, 200MHz; 1ch analog, 200MSa/s, 60MHz BW)

File:Agilent_MSO7104A.png|link=Agilent MSO7104A|[[File:Nuvola Red.png|16px]] [[Agilent MSO7104A]] (16ch, ?; 4ch analog, 2GSa/s, 100MHz BW)
File:Digilent_analog_discovery.png|link=Digilent Analog Discovery|[[File:Nuvola Red.png|16px]] [[Digilent Analog Discovery]] (16ch, 100MHz; 2ch analog, 100MSa/s, 5MHz BW)
File:Hantek_1008C.png|link=Hantek 1008C|[[File:Nuvola Red.png|16px]] [[Hantek 1008C]] (8ch)
File:Meilhaus_mephisto_scope1.png|link=Meilhaus MEphisto Scope1|[[File:Nuvola Red.png|16px]] [[Meilhaus MEphisto Scope1]] (16ch, 100kHz; 2ch analog, 1MSa/s, 500kHz BW)
File:Polabs_poscope_basic2.png|link=PoLabs PoScope Basic2|[[File:Nuvola Red.png|16px]] [[PoLabs PoScope Basic2]] (16ch, 8MHz; 2ch analog, 200kSa/s, ? BW)
File:QuantAsylum QA100.png|link=QuantAsylum QA100|[[File:Nuvola Red.png|16px]] [[QuantAsylum QA100]] (12ch; 2ch analog)
File:Sigrok_logo_no_text_transparent_512.png|link=XZL_Studio DX|[[File:Nuvola Red.png|16px]] [[XZL_Studio DX]] (16ch, 24MHz; 2ch analog)
</gallery>


1 Only the logic analyzer functionality is supported so far, analog support is work in progress. 


== Oscilloscopes ==

<gallery widths=100px heights=100px>
File:Agilent DSO1014A.png|link=Agilent DSO1000 Series|[[File:Nuvola OK.png|16px]] [[Agilent DSO1000 Series]] (2-4ch, 2GS/s, 60-200MHz BW)
File:Fluke_Scopemeter_199B.png|link=Fluke ScopeMeter 199B|[[File:Nuvola OK.png|16px]] [[Fluke ScopeMeter 199B]] (2ch, 2.5GS/s, 200MHz BW)
File:Hameg HMO2024.png|link=Hameg HMO Compact|[[File:Nuvola OK.png|16px]] [[Hameg HMO Compact | Hameg HMO Compact Series]] (2-4ch, 2GS/s, 70-200MHz BW)
File:Hantek DSO-2090.png|link=Hantek DSO-2090|[[File:Nuvola OK.png|16px]] [[Hantek DSO-2090]] (2ch, 100MS/s, 40MHz)
File:Rigol DS1052E.png|link=Rigol DS1000 Series|[[File:Nuvola OK.png|16px]] [[Rigol DS1000 Series | Rigol DS1000E Series]] (2ch, 1GS/s, 50-150MHz BW)
File:Rigol-ds2072 mugshot.png|link=Rigol DS2000 Series|[[File:Nuvola OK.png|16px]] [[Rigol DS2000 Series]] (2ch, 2GS/s, 70-200MHz BW)
File:Rigol_VS5202D.png|link=Rigol VS5000 Series|[[File:Nuvola OK.png|16px]] [[Rigol VS5000 Series]] (2ch, 20-200MHz BW)
File:Focussz_fosc21_mugshot.png|link=Focussz Fosc21|[[File:Nuvola Orange.png|16px]] [[Focussz Fosc21]] (2ch, 8kS/s, 3kHz BW)
File:Hantek dso2250 mugshot.png|link=Hantek DSO-2250|[[File:Nuvola Orange.png|16px]] [[Hantek DSO-2250]] (2ch, 250MS/s, 100MHz BW)
File:Hantek dso-5200a device front.png|link=Hantek DSO-5200A|[[File:Nuvola Orange.png|16px]] [[Hantek DSO-5200A]] (2ch, 250MS/s, 200MHz BW)
File:OsciPrime.png|link=Nexus-Computing OsciPrime|[[File:Nuvola Orange.png|16px]] [[Nexus-Computing OsciPrime]] (2ch, ?MS/s, 3.3MHz-8MHz BW)
File:Velleman PCSU1000.png|link=Velleman PCSU1000|[[File:Nuvola Orange.png|16px]] [[Velleman PCSU1000]] (2ch, 1GS/s, 50MHz BW)

File:Sigrok_logo_no_text_transparent_512.png|link=Hantek DSO-1200|[[File:Nuvola Red.png|16px]] [[Hantek DSO-1200]] (2ch, 500MS/s, 200MHz BW)
File:Fluke scopemeter123.png|link=Fluke ScopeMeter 123|[[File:Nuvola Red.png|16px]] [[Fluke ScopeMeter 123]] (2ch, 25MS/s, 20MHz BW)
File:Sigrok_logo_no_text_transparent_512.png|link=Owon SDS|[[File:Nuvola Red.png|16px]] [[Owon SDS]] Series (2ch, 0.5-3.2GS/s, 60-300MHz BW)
File:Picoscope 2203.png|link=Pico Technology PicoScope 2203|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 2203]] (40/20MS/s, 5MHz BW)
File:PicoScope_2205.png|link=Pico Technology PicoScope 2205|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 2205]] (200/100MS/s, 25MHz BW)
File:Picoscope 3206.png|link=Pico Technology PicoScope 3206|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 3206]] (200/100MS/s, 200MHz BW)
File:Picoscope 5203.png|link=Pico Technology PicoScope 5203|[[File:Nuvola Red.png|16px]] [[Pico Technology PicoScope 5203]] (1/0.5GS/s, 250MHz BW)
File:Usbduxfast.png|link=Incite Technology USB-DUXfast|[[File:Nuvola Red.png|16px]] [[Incite Technology USB-DUXfast]] (16ch, 3MHz, ? BW)
File:UNI-T UTD2042C.png|link=UNI-T UTD2042C|[[File:Nuvola Red.png|16px]] [[UNI-T UTD2042C]] (2ch, 500MS/s, 40MHz BW)
File:Voltcraft dso-220 usb.png|link=Voltcraft DSO-220|[[File:Nuvola Red.png|16px]] [[Voltcraft DSO-220]] (2ch, 60MS/s, 20MHz BW)
File:Voltcraft DSO-3062C.png|link=Voltcraft DSO-3062C|[[File:Nuvola Red.png|16px]] [[Voltcraft DSO-3062C]] (2ch, 1GS/s, 60MHz BW)
</gallery>

== Multimeters ==

<gallery widths="100px" heights="100px">
File:Sigrok_logo_no_text_transparent_512.png|link=Agilent U1231A|[[File:Nuvola OK.png|16px]] [[Agilent U1231A]] (6000 counts, USB/Bluetooth)
File:Agilent U1232A.png|link=Agilent U1232A|[[File:Nuvola OK.png|16px]] [[Agilent U1232A]] (6000 counts, USB/Bluetooth)
File:Sigrok_logo_no_text_transparent_512.png|link=Agilent U1233A|[[File:Nuvola OK.png|16px]] [[Agilent U1233A]] (6000 counts, USB/Bluetooth)
File:Sigrok_logo_no_text_transparent_512.png|link=BBC Goertz Metrawatt M2110|[[File:Nuvola OK.png|16px]] [[BBC Goertz Metrawatt M2110]] (30000 counts, RS232)
File:Bm_857_mugshot_500000.png|link=Brymen BM857|[[File:Nuvola OK.png|16px]] [[Brymen BM857]] (50000 counts, RS232)
File:Digitek_dt4000zc_device_front.png|link=Digitek DT4000ZC|[[File:Nuvola OK.png|16px]] [[Digitek DT4000ZC]] (4000 counts, RS232)
File:Fluke 187.png|link=Fluke 187/189|[[File:Nuvola OK.png|16px]] [[Fluke 187/189]] (50000 counts, RS232)
File:Fluke 287.png|link=Fluke 287/289|[[File:Nuvola OK.png|16px]] [[Fluke 287/289]] (50000 counts, RS232)
File:Gmc metrahit 14a logo.png|link=Gossen Metrawatt Metrahit 14A|[[File:Nuvola OK.png|16px]] [[Gossen Metrawatt Metrahit 14A]] (3100 counts, RS232)
File:Gossen Metrawatt Metrahit 16I small.png|link=Gossen Metrawatt Metrahit 16I|[[File:Nuvola OK.png|16px]] [[Gossen Metrawatt Metrahit 16I]] (3100 counts, RS232)
File:Gossen Metrawatt Metrahit 18S small.png|link=Gossen Metrawatt Metrahit 18S|[[File:Nuvola OK.png|16px]] [[Gossen Metrawatt Metrahit 18S]] (31000 counts, RS232)
File:100px_Idm103n.png|link=ISO-TECH IDM103N|[[File:Nuvola OK.png|16px]] [[ISO-TECH IDM103N]] (4000 counts, RS232)
File:Mastech mas345 device front.png|link=MASTECH MAS345|[[File:Nuvola OK.png|16px]] [[MASTECH MAS345]] (4000 counts, RS232)
File:Metex m4650cr mugshot.png|link=Metex M-4650CR|[[File:Nuvola OK.png|16px]] [[Metex M-4650CR]] (20000 counts, RS232)
File:Norma dm950.png|link=Norma DM950|[[File:Nuvola OK.png|16px]] [[Norma DM950]] (21000 counts, RS232)
File:Pce-pce-dm32.png|link=PCE PCE-DM32|[[File:Nuvola OK.png|16px]] [[PCE PCE-DM32]] (4000 counts, RS232)
File:Metex_me-31.png|link=PeakTech 3410|[[File:Nuvola OK.png|16px]] [[PeakTech 3410]] (4000 counts, RS232)
File:Peaktech 4370 device front.png|link=PeakTech 4370|[[File:Nuvola OK.png|16px]] [[PeakTech 4370]] (2000 counts, RS232)
File:Rs_22_168_mugshot.png|link=RadioShack 22-168|[[File:Nuvola OK.png|16px]] [[RadioShack 22-168]] (2000 counts, RS232)
File:Rs_22-805_front.png|link=RadioShack 22-805|[[File:Nuvola OK.png|16px]] [[RadioShack 22-805]] (4000 counts, RS232)
File:radioshack_22_812_front.png|link=RadioShack 22-812|[[File:Nuvola OK.png|16px]] [[RadioShack 22-812]] (4000 counts, RS232)
File:Siemens B1105 small.png|link=Siemens B1105|[[File:Nuvola OK.png|16px]] [[Siemens B1105]] (310000 counts, RS232)
File:Tecpel dmm8061.png|link=Tecpel DMM-8061|[[File:Nuvola OK.png|16px]] [[Tecpel DMM-8061]] (4000 counts, RS232/USB)
File:Tp4000zc_front.png|link=TekPower TP4000ZC|[[File:Nuvola OK.png|16px]] [[TekPower TP4000ZC]] (4000 counts, RS232)
File:Tenma 72-7745.png|link=Tenma 72-7745|[[File:Nuvola OK.png|16px]] [[Tenma 72-7745]] (4000 counts, RS232/USB)
File:Ut60e_-_front_-_alpha.png|link=UNI-T UT60E|[[File:Nuvola OK.png|16px]] [[UNI-T UT60E]] (4000 counts, RS232/USB)
File:Uni-t ut61b mugshot.png|link=UNI-T UT61B|[[File:Nuvola OK.png|16px]] [[UNI-T UT61B]] (4000 counts, RS232/USB)
File:Uni-t ut61c mugshot.png|link=UNI-T UT61C|[[File:Nuvola OK.png|16px]] [[UNI-T UT61C]] (6000 counts, RS232/USB)
File:Uni t ut61d device.png|link=UNI-T UT61D|[[File:Nuvola OK.png|16px]] [[UNI-T UT61D]] (6000 counts, RS232/USB)
File:Old ver front.png|link=UNI-T UT61E|[[File:Nuvola OK.png|16px]] [[UNI-T UT61E]] (22000 counts, RS232/USB)
File:Va_va18b.png|link=V&A VA18B|[[File:Nuvola OK.png|16px]] [[V&A VA18B]] (6000 counts, USB)
File:Va va40b mugshot.png|link=V&A VA40B|link=V&A VA40B|[[File:Nuvola OK.png|16px]] [[V&A VA40B]] (6000 counts, USB)
File:Victor 86c device front.png|link=Victor 86C|[[File:Nuvola OK.png|16px]] [[Victor 86C]] (4000 counts, USB)
File:Victor 70C.png|link=Victor 70C|[[File:Nuvola OK.png|16px]] [[Victor 70C]] (4000 counts, USB)
File:Voltcraft_M-3650D_transparent.png|link=Voltcraft M-3650D|[[File:Nuvola OK.png|16px]] [[Voltcraft M-3650D]] (2000 counts, RS232)
File:Voltcraft m4650cr.png|link=Voltcraft M-4650CR|[[File:Nuvola OK.png|16px]] [[Voltcraft M-4650CR]] (20000 counts, RS232)
File:Voltcraft vc820 device.png|link=Voltcraft VC-820|[[File:Nuvola OK.png|16px]] [[Voltcraft VC-820]] (4000 counts, RS232/USB)
File:Voltcraft vc830.png|link=Voltcraft VC-830|[[File:Nuvola OK.png|16px]] [[Voltcraft VC-830]] (6000 counts, RS232/USB)
File:Voltcraft vc840 device front.png|link=Voltcraft VC-840|[[File:Nuvola OK.png|16px]] [[Voltcraft VC-840]] (4000 counts, RS232/USB)

File:Tenma 72-1016.png|link=Tenma 72-1016|[[File:Nuvola Orange.png|16px]] [[Tenma 72-1016]] (6000 counts, RS232/USB)
File:Tenma 72-7730.png|link=Tenma 72-7730|[[File:Nuvola Orange.png|16px]] [[Tenma 72-7730]] (20000 counts, RS232/USB)
File:Tenma 72-7732.png|link=Tenma 72-7732|[[File:Nuvola Orange.png|16px]] [[Tenma 72-7732]] (40000 counts, RS232/USB)
File:Tenma 72-7750.png|link=Tenma 72-7750|[[File:Nuvola Orange.png|16px]] [[Tenma 72-7750]] (6000 counts, RS232/USB)
File:Tenma 72-9380A.png|link=Tenma 72-9380A|[[File:Nuvola Orange.png|16px]] [[Tenma 72-9380A]] (40000 counts, RS232/USB)
File:Voltcraft m-3650cr.png|link=Voltcraft M-3650CR|[[File:Nuvola Orange.png|16px]] [[Voltcraft M-3650CR]] (2000 counts, RS232)

File:Appa 107.png|link=APPA 107|[[File:Nuvola Red.png|16px]] [[APPA 107]] (4000 / 20000 counts, RS232)
File:Digitek dt8000.png|link=Digitek DT8000|[[File:Nuvola Red.png|16px]] [[Digitek DT8000]] (8000 counts, RS232)
File:Digitek dt80000.png|link=Digitek DT80000|[[File:Nuvola Red.png|16px]] [[Digitek DT80000]] (80000 counts, RS232)
File:Escort 179 device front.png|link=Escort 179|[[File:Nuvola Red.png|16px]] [[Escort 179]] (10000 counts, RS232)
File:Gossen metrahit 30m.png|link=Gossen-Metrawatt METRAHIT 30M|[[File:Nuvola Red.png|16px]] [[Gossen-Metrawatt METRAHIT 30M]] (1200000 counts, RS232/USB)
File:800px-Mastech m9803r device front.png|link=MASTECH M9803R|[[File:Nuvola Red.png|16px]] [[MASTECH M9803R]] (4000 counts, RS232)
File:Metrix mx53.png|link=Metrix MX53|[[File:Nuvola Red.png|16px]] [[Metrix MX53]] (50000 counts, RS232)
File:Metrix mx56c.png|link=Metrix MX56C|[[File:Nuvola Red.png|16px]] [[Metrix MX56C]] (50000 counts, RS232)
File:Sigrok_logo_no_text_transparent_512.png|link=Protek 6500|[[File:Nuvola Red.png|16px]] [[Protek 6500]] (50000 counts, RS232)
File:Voltcraft m3890dt usb.png|link=Voltcraft M-3890DT|[[File:Nuvola Red.png|16px]] [[Voltcraft M-3890DT]] (4000 counts, USB)
File:Voltcraft m4660a device front.png|link=Voltcraft M-4660A|[[File:Nuvola Red.png|16px]] [[Voltcraft M-4660A]] (20000 counts, RS232)
File:Voltcraft vc920.png|link=Voltcraft VC-920|[[File:Nuvola Red.png|16px]] [[Voltcraft VC-920]] (40000/4000 counts, RS232/USB)
File:Voltcraft vc940.png|link=Voltcraft VC-940|[[File:Nuvola Red.png|16px]] [[Voltcraft VC-940]] (40000/4000 counts, RS232/USB)
</gallery>

== LCR meters ==

<gallery widths="100px" heights="100px">
File:Voltcraft4080_2.png|link=Voltcraft 4080|[[File:Nuvola Orange.png|16px]] [[Voltcraft 4080]] (serial)
</gallery>

== Sound level meters ==

<gallery widths="100px" heights="100px">
File:CEM DT-8852.png|link=CEM DT-8852|[[File:Nuvola OK.png|16px]] [[CEM DT-8852]] (USB)
File:Colead SL-5868P.png|link=Colead SL-5868P|[[File:Nuvola OK.png|16px]] [[Colead SL-5868P]] (RS232)
File:Kecheng KC-330B.png|link=Kecheng KC-330B|[[File:Nuvola OK.png|16px]] [[Kecheng KC-330B]] (RS232)
File:Tondaj sl-814.png|link=Tondaj SL-814|[[File:Nuvola OK.png|16px]] [[Tondaj SL-814]] (USB)
File:Voltcraft_DL-161S.png|link=Voltcraft DL-161S|[[File:Nuvola Orange.png|16px]] [[Voltcraft DL-161S]] (USB)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (also: light-/thermo-/hygrometer; RS232)
File:Voltcraft_dl_160s.png|link=Voltcraft DL-160S|[[File:Nuvola Red.png|16px]] [[Voltcraft DL-160S]] (USB)
</gallery>

== Thermometers ==

<gallery widths="100px" heights="100px">
File:rs55ii.png|link=APPA 55II|[[File:Nuvola OK.png|16px]] [[APPA 55II]] (2xtemp, RS232)
File:EL-USB-2.png|link=Lascar Electronics EL-USB-2|[[File:Nuvola OK.png|16px]] [[Lascar Electronics EL-USB-2]] (1xtemp, 1xhum, USB)
File:Mic 98581.png|link=MIC 98581|[[File:Nuvola OK.png|16px]] [[MIC 98581]] (1xtemp, USB)
File:Mic 98583.png|link=MIC 98583|[[File:Nuvola OK.png|16px]] [[MIC 98583]] (1xtemp, 1xhum, USB)
File:Uni-t ut325 front.png|link=UNI-T UT325|[[File:Nuvola OK.png|16px]] [[UNI-T UT325]] (2xtemp, USB)
File:Voltcraft k204.png|link=Voltcraft K204|[[File:Nuvola OK.png|16px]] [[Voltcraft K204]] (4xtemp, RS232)
File:Elitech rc3.png|link=Elitech RC-3|[[File:Nuvola Red.png|16px]] [[Elitech RC-3]] (1xtemp, RS232)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (1xtemp, RS232)
File:Rding temper front.png|link=RDing TEMPer|[[File:Nuvola Red.png|16px]] [[RDing TEMPer]] (1xtemp, USB)
File:Rding temper gold device front.png|link=RDing TEMPer Gold|[[File:Nuvola Red.png|16px]] [[RDing TEMPer Gold]] (1xtemp, USB)
File:Rding temper1 device front.png|link=RDing TEMPer1|[[File:Nuvola Red.png|16px]] [[RDing TEMPer1]] (1xtemp, USB)
File:Pcsensor_temper1k2.png|link=RDing TEMPer1K2|[[File:Nuvola Red.png|16px]] [[RDing TEMPer1K2]] (1xtemp, USB)
File:Voltcraft dl-120th.png|link=Voltcraft DL-120TH|[[File:Nuvola Red.png|16px]] [[Voltcraft DL-120TH]] (1xtemp, USB)
File:Voltcraft dl-140th.png|link=Voltcraft DL-140TH|[[File:Nuvola Red.png|16px]] [[Voltcraft DL-140TH]] (1xtemp, USB)
</gallery>

== Hygrometers ==

<gallery widths="100px" heights="100px">
File:EL-USB-2.png|link=Lascar Electronics EL-USB-2|[[File:Nuvola OK.png|16px]] [[Lascar Electronics EL-USB-2]] (temp/humidity, USB)
File:Mic 98583.png|link=MIC 98583|[[File:Nuvola OK.png|16px]] [[MIC 98583]] (temp/humidity, USB)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (also: light-/soundlevelmeter; RS232)
File:Silabs si7005usb dgl eb top.jpg|link=SiLabs Si7005USB-Dongle|[[File:Nuvola Red.png|16px]] [[SiLabs Si7005USB-Dongle]] (USB)
</gallery>

== Anemometers ==

<gallery widths="100px" heights="100px">
File:Mastech ms6252b.png|link=MASTECH MS6252B|[[File:Nuvola Red.png|16px]] [[MASTECH MS6252B]] (USB)
</gallery>

== Light meters ==

<gallery widths="100px" heights="100px">
File:Lutron YK-2005LX.png|link=Lutron YK-2005LX|[[File:Nuvola Red.png|16px]] [[Lutron YK-2005LX]] (RS232)
File:Pce_pce-222_front.png|link=PCE PCE-222|[[File:Nuvola Red.png|16px]] [[PCE PCE-222]] (RS232)
</gallery>

== Energy meters ==

<gallery widths="100px" heights="100px">
File:Actaris_a14c5_teleinfo.png|link=EDF Teleinfo|[[File:Nuvola OK.png|16px]] [[EDF Teleinfo]] (USB)
</gallery>

== DAQs ==

<gallery widths="100px" heights="100px">
File:Ni usb 6008.png|link=NI USB-6008|[[File:Nuvola Red.png|16px]] [[NI USB-6008]] (8/2 analog inputs/outputs, 12 digital I/Os)
</gallery>

== Dataloggers ==

<gallery widths="100px" heights="100px">
File:EL-USB-CO.png|link=Lascar Electronics EL-USB-CO|[[File:Nuvola OK.png|16px]] [[Lascar Electronics EL-USB-CO]] (carbon monoxide (CO) logger, USB)
File:Gsg_indoor_air_monitor.png|link=GSG Indoor Air Monitor|[[File:Nuvola Red.png|16px]] [[GSG Indoor Air Monitor]] (air quality monitor, USB)
File:Maul_studio_i.png|link=MAUL studio i|[[File:Nuvola Red.png|16px]] [[MAUL studio i]] (weighing scale, RS232)
File:Voltcraft co-20.png|link=Voltcraft CO-20|[[File:Nuvola Red.png|16px]] [[Voltcraft CO-20]] (air quality monitor, USB)
</gallery>

== Function generators ==

<gallery widths="100px" heights="100px">
File:Hantek DDS-3X25 top.png|link=Hantek DDS-3X25|[[File:Nuvola Red.png|16px]] [[Hantek DDS-3X25]] (25MHz, PC-based, USB)
File:Siglent sdg1010 device front 8116.png|link=Siglent SDG1010|[[File:Nuvola Red.png|16px]] [[Siglent SDG1010]] (10MHz, USB)
</gallery>

== RF receivers ==

<gallery widths="100px" heights="100px">
File:Per vices noctar.png|link=Per Vices Noctar|[[File:Nuvola Red.png|16px]] [[Per Vices Noctar]] (100kHz-4GHz, IQ modulator/demodulator, PCIe)
</gallery>

== Spectrum analyzers ==

TODO.

== Power supplies ==

<gallery widths="100px" heights="100px">
File:Atten PPS3203T-3S.png|link=Atten PPS3203T-3S|[[File:Nuvola OK.png|16px]] [[Atten PPS3203T-3S]] (3ch, 2*0-32V, 1*0-6V at 0-3A, USB&RS232)
File:Sigrok logo no text transparent 512.png|link=ATTEN_ATZ9711|[[File:Nuvola Red.png|16px]] [[ATTEN ATZ9711]] (DC electronic load, 150W/0~30A/0~150V, USB)
File:Sigrok logo no text transparent 512.png|link=Conrad DIGI 35 CPU|[[File:Nuvola Red.png|16px]] [[Conrad DIGI 35 CPU]] (1ch, 0-35V/0-2.55A, RS232)
File:Manson hcs3202.png|link=Manson HCS-3202|[[File:Nuvola Red.png|16px]] [[Manson HCS-3202]] (1ch, 1-36V/0-10A, USB)
File:PS3005D front on.JPG|link=Velleman PS3005D|[[File:Nuvola Red.png|16px]] [[Velleman PS3005D]] (1ch, 0-30V/0-5A, USB&RS232)
</gallery>

== GPIB interfaces ==

<gallery widths="100px" heights="100px">
File:Beiming_s82357.png|link=Beiming S82357|[[File:Nuvola Red.png|16px]] [[Beiming S82357]] (hardware-based, USB)
File:ICS 488-USB.png|link=ICS 488-USB|[[File:Nuvola Red.png|16px]] [[ICS 488-USB]] (hardware-based, USB)
File:GPIB-USB 82357B clone.png|link=GPIB-USB 82357B clone|[[File:Nuvola Red.png|16px]] [[GPIB-USB 82357B clone]] (hardware-based, USB)
File:NI GPIB-ENET.png|link=National Instruments GPIB-ENET|[[File:Nuvola Red.png|16px]] [[National Instruments GPIB-ENET]] (hardware-based, Ethernet)
File:NI GPIB-USB-HS.png|link=National Instruments GPIB-USB-HS|[[File:Nuvola Red.png|16px]] [[National Instruments GPIB-USB-HS]] (hardware-based, USB)
File:Prologix-usb.png|link=Prologix GPIB-USB|[[File:Nuvola Red.png|16px]] [[Prologix GPIB-USB]] (firmware-based, USB)
</gallery>

== Potential other candidates ==

If you own any other logic analyzers, oscilloscopes, multimeters, dataloggers, ... and want to add support for them in sigrok (or donate/lend devices to developers), please let us know. We're always happy to add more hardware support! Join the [https://lists.sourceforge.net/lists/listinfo/sigrok-devel mailing list] or ask on [irc://chat.freenode.net/sigrok IRC #sigrok] if you want to help out.

__FORCETOC__

File:Xl-logic16-100m-pcb-bottom.jpg

2014-01-29T15:20:32Z

Karlp: bottom side view of pcb for XL-LOGIC16-100M (Saleae Logic 16 clone)

== Summary ==
bottom side view of pcb for XL-LOGIC16-100M (Saleae Logic 16 clone)
== Licensing ==
{{PD}}