Port to the new bindings.
[sigrok-meter/gsi.git] / README
blobf54cf4b1db7a6f02c6ffcc3132247c7fffebf0ae
1 -------------------------------------------------------------------------------
2 README
3 -------------------------------------------------------------------------------
5 The sigrok project aims at creating a portable, cross-platform,
6 Free/Libre/Open-Source signal analysis software suite that supports various
7 device types (such as logic analyzers, oscilloscopes, multimeters, and more).
9 sigrok-meter is a special-purpose GUI for libsigrok (written in Python3, using
10 PyGObject and GTK+3) which supports certain classes of test & measurement
11 devices that usually provide slowly-updating measurement values, such as
12 multimeters or dataloggers.
14 It does specifically NOT support logic analyzers, oscilloscopes, and
15 mixed-signal oscilloscopes (MSOs).
18 Status
19 ------
21 There have been no official tarball releases, yet.
23 Distro packagers should NOT package this, yet.
26 Requirements
27 ------------
29  - git
30  - Python >= 3.0
31  - PyGObject
32  - GTK+ >= 3.0
33  - libsigrok >= 0.2.0 (including the Python bindings)
36 Building and installing
37 -----------------------
39 In order to get the sigrok-meter source code and build it, run:
41  $ git clone git://sigrok.org/sigrok-meter
42  $ cd sigrok-meter
43  $ ./sigrok-meter
45 For installing sigrok-meter:
47  TODO.
49 See INSTALL or the following wiki page for more (OS-specific) instructions:
51  http://sigrok.org/wiki/Building
54 Copyright and license
55 ---------------------
57 sigrok-meter is licensed under the terms of the GNU General Public License
58 (GPL), version 3 or later.
60 While some individual source code files are licensed under the GPLv2+, and
61 some files are licensed under the GPLv3+, this doesn't change the fact that
62 the program as a whole is licensed under the terms of the GPLv3+ (e.g. also
63 due to the fact that it links against GPLv3+ libraries).
65 Please see the individual source files for the full list of copyright holders.
68 Mailing list
69 ------------
71  https://lists.sourceforge.net/lists/listinfo/sigrok-devel
74 IRC
75 ---
77 You can find the sigrok developers in the #sigrok IRC channel on Freenode.
80 Website
81 -------
83  http://sigrok.org/wiki/Sigrok-meter