summaryrefslogtreecommitdiff
path: root/README
blob: 6d20e172781b38825d01f893aa21b41e25b97e26 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
-------------------------------------------------------------------------------
README
-------------------------------------------------------------------------------

The sigrok project aims at creating a portable, cross-platform,
Free/Libre/Open-Source signal analysis software suite that supports various
device types (such as logic analyzers, oscilloscopes, multimeters, and more).

sigrok-test is a collection of various tools and files for testing sigrok.


Status
------

Work in progress.

Distro packagers should NOT package this!


Requirements
------------

 - git
 - gcc
 - make
 - autoconf >= 2.63
 - automake >= 1.11
 - pkg-config >= 0.22
 - libglib >= 2.24.0
 - Python >= 3.2
 - libsigrok >= 0.5.0
 - libsigrokdecode >= 0.5.0
 - python3-coverage


Building and usage
------------------

Assumption: libsigrok and libsigrokdecode are installed in $HOME/sr.
If they are in a standard location instead, you don't need the
PKG_CONFIG_PATH and LD_LIBRARY_PATH below.

In order to get the sigrok-test source code and build it, run:

 $ git clone git://sigrok.org/sigrok-test
 $ cd sigrok-test
 $ ./autogen.sh
 $ PKG_CONFIG_PATH=$HOME/sr/lib/pkgconfig ./configure \
	--with-decodersdir=/path/to/decoders
 $ make

This will test the decoders located at /path/to/decoders:

 $ LD_LIBRARY_PATH=$HOME/sr/lib ./decoder/pdtest -r -v -a


Copyright and license
---------------------

sigrok-test contains various tools that are licensed under different terms.

Some are licensed under the terms of the GNU GPL version 2 (or later),
others under the terms of the GNU GPL version 3 (or later).

Please see the individual source files for the full list of copyright holders
and the license that applies to the respective tool.


Mailing list
------------

 https://lists.sourceforge.net/lists/listinfo/sigrok-devel


IRC
---

You can find the sigrok developers in the #sigrok IRC channel on Freenode.


Website
-------

 http://sigrok.org