forked from gnuradio/gnuradio
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
139 lines (92 loc) · 4.44 KB
/
README
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
#
# Copyright 2001-2007,2009,2012 Free Software Foundation, Inc.
#
# This file is part of GNU Radio
#
# GNU Radio is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 3, or (at your option)
# any later version.
#
# GNU Radio is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with GNU Radio; see the file COPYING. If not, write to
# the Free Software Foundation, Inc., 51 Franklin Street,
# Boston, MA 02110-1301, USA.
#
Welcome to GNU Radio!
Please see http://gnuradio.org for the wiki, bug tracking,
and source code viewer.
If you've got questions about GNU Radio, please subscribe to the
discuss-gnuradio mailing list and post your questions there.
http://gnuradio.org/redmine/projects/gnuradio/wiki/MailingLists
There is also a "Build Guide" in the wiki that contains OS specific
recommendations:
http://gnuradio.org/redmine/projects/gnuradio/wiki/BuildGuide
The bleeding edge code can be found in our git repository at
http://gnuradio.org/git/gnuradio.git/. To checkout the latest, use
this command:
$ git clone git://git.gnuradio.org/gnuradio
For information about using Git, please see:
http://gnuradio.org/redmine/projects/gnuradio/wiki/DevelopingWithGit
How to Build GNU Radio:
For more complete instructions, see the "Building GNU Radio" page in
the GNU Radio manual (can be built or found online at
http://gnuradio.org/doc/doxygen/build_guide.html).
See these steps for a quick build guide.
(1) Ensure that you've satisfied the external dependencies. These
dependencies are listed in the manual's build page and are not
presented here to reduce duplication errors.
See the wiki at http://gnuradio.org for details.
(2) Building from cmake:
$ mkdir $(builddir)
$ cd $(builddir)
$ cmake [OPTIONS] $(srcdir)
$ make
$ make test
$ sudo make install
That's it!
Options:
Useful options include setting the install prefix and the build type:
-DCMAKE_INSTALL_PREFIX=<directory to install to>
-DCMAKE_BUILD_TYPE="<type>"
Currently, GNU Radio has a "Debug" type that builds with '-g -O2'
useful for debugging the software and a "Release" type that builds
with '-O3', which is the default.
-------------------------------------------------------------------------------
KNOWN INCOMPATIBILITIES
GNU Radio triggers bugs in g++ 3.3 for X86. DO NOT USE GCC 3.3 on
the X86 platform. g++ 3.2, 3.4, and the 4.* series are known to work well.
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
NOTES
-------------------------------------------------------------------------------
To run the examples you may need to set PYTHONPATH. Note that the
prefix and python version number in the path needs to match your
installed version of python.
$ export PYTHONPATH=/usr/local/lib/python2.7/dist-packages
You may want to add this to your shell init file (~/.bash_profile if
you use bash).
Another handy trick if for example your fftw includes and libs are
installed in, say ~/local/include and ~/local/lib, instead of
/usr/local is this:
$ export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/local/lib
$ make CPPFLAGS="-I$HOME/local/include"
Sometimes the prerequisites are installed in a location which is not
included in the default compiler and linker search paths. This
happens with pkgsrc and NetBSD. To build, tell configure to use these
locations:
LDFLAGS="-L/usr/pkg/lib -R/usr/pkg/lib" CPPFLAGS="-I/usr/pkg/include" ./configure --prefix=/usr/gnuradio
-------------------------------------------------------------------------------
Legal Matters
-------------------------------------------------------------------------------
Some files have been changed many times throughout the
years. Copyright notices at the tops of these files list which years
changes have been made. For some files, changes have occurred in many
consecutive years. These files may often have the format of a year
range (e.g., "2006 - 2011"), which indicates that these files have had
copyrightable changes made during each year in the range, inclusive.