]> sigrok.org Git - sigrok-cli.git/blame - README
doc: update manpage for channel groups in --get/--config options
[sigrok-cli.git] / README
CommitLineData
34c6b368
UH
1-------------------------------------------------------------------------------
2README
3-------------------------------------------------------------------------------
4
5The sigrok project aims at creating a portable, cross-platform,
31dde8ac 6Free/Libre/Open-Source signal analysis software suite that supports various
cdcf09f6 7device types (such as logic analyzers, oscilloscopes, multimeters, and more).
34c6b368
UH
8
9sigrok-cli is a command-line tool written in C, which uses both libsigrok
10and libsigrokdecode to provide the basic sigrok functionality from the
11command-line. Among other things, it's useful for scripting purposes.
12
13
14Status
15------
16
cdcf09f6 17sigrok-cli is in a usable state and has had official tarball releases.
34c6b368
UH
18
19
20Requirements
21------------
22
7930408d 23 - git (only needed when building from git)
198487f6 24 - gcc or clang
2658103e 25 - make
7930408d
UH
26 - autoconf >= 2.63 (only needed when building from git)
27 - automake >= 1.11 (only needed when building from git)
28 - libtool (only needed when building from git)
2658103e 29 - pkg-config >= 0.22
3addebb2 30 - libglib >= 2.32.0
247d467a 31 - libsigrok >= 0.5.0
015d6589 32 - libsigrokdecode >= 0.6.0
34c6b368
UH
33
34
35Building and installing
36-----------------------
37
38In order to get the sigrok-cli source code and build it, run:
39
31dde8ac
BV
40 $ git clone git://sigrok.org/sigrok-cli
41 $ cd sigrok-cli
34c6b368
UH
42 $ ./autogen.sh
43 $ ./configure
44 $ make
45
46For installing sigrok-cli:
47
48 $ make install
49
2da49870 50See INSTALL or the following wiki page for more (OS-specific) instructions:
34c6b368 51
2da49870 52 http://sigrok.org/wiki/Building
34c6b368
UH
53
54
a8a380bd
UH
55Copyright and license
56---------------------
57
58sigrok-cli is licensed under the terms of the GNU General Public License
59(GPL), version 3 or later.
60
61While some individual source code files are licensed under the GPLv2+, and
62some files are licensed under the GPLv3+, this doesn't change the fact that
63the program as a whole is licensed under the terms of the GPLv3+.
64
65Please see the individual source files for the full list of copyright holders.
66
67
7f1cb96e
UH
68Mailing list
69------------
34c6b368
UH
70
71 https://lists.sourceforge.net/lists/listinfo/sigrok-devel
34c6b368
UH
72
73
74IRC
75---
76
77You can find the sigrok developers in the #sigrok IRC channel on Freenode.
78
79
80Website
81-------
82
cdcf09f6 83 http://sigrok.org/wiki/Sigrok-cli
34c6b368 84