Main Page: Difference between revisions

From GNU Radio
Jump to navigation Jump to search
(Added an example of a flowgraph, to make the main page look a little nicer)
(correct link to GNU Radio Leadership)
 
(59 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[File:Stage2 grc.png|upright=1.2|thumb|right|Example GNU Radio Flowgraph]]
[[File:FunCube_2_meter_NB_FM_fg.png|upright=1.8|thumb|right|Example 2 meter NBFM receiver]]


GNU Radio is a free & open-source software development toolkit that provides signal processing blocks to implement software radios. It can be used with readily-available low-cost external RF hardware to create software-defined radios, or without hardware in a simulation-like environment. It is widely used in hobbyist, academic and commercial environments to support both wireless communications research and real-world radio systems.
GNU Radio is a free & open-source software development toolkit that provides signal processing blocks to implement software radios. It can be used with readily-available low-cost external RF hardware to create software-defined radios, or without hardware in a simulation-like environment. It is widely used in hobbyist, academic and commercial environments to support both wireless communications research and real-world radio systems.
GNU Radio is licensed under the GNU General Public License (GPL) version 3 or later. All of the code is copyright of the Free Software Foundation.


= Getting started =
= Getting started =


If you've never touched GNU Radio before, these pages will get you started with a running installation of GNU Radio and will show you how to take your first steps with this software radio tool.
If you've never touched GNU Radio before, these pages will get you started with a running installation of GNU Radio and will show you how to take your first steps with this software radio tool.
The recommended way to get started with GNU Radio is to read the '''[[Guided Tutorials|Guided Tutorials]]'''.


* [[WhatIsGR|What is GNU Radio and why do I want it?]] - Read this if you really have no idea what this project is about.
* [[WhatIsGR|What is GNU Radio and why do I want it?]] - Read this if you really have no idea what this project is about.
* [[GNU_Radio_Live_SDR_Environment|GNU Radio Live SDR Environment]] - Get a bootable DVD/USB/Cloud image with a fully functional GNU Radio and a lot of examples.
* [[InstallingGR|Installing GNU Radio]] - This will explain all the steps to get a working installation of GNU Radio.
* [[InstallingGR|Installing GNU Radio]] - This will explain all the steps to get a working installation of GNU Radio.
* [[HowToUse|How do I use GNU Radio?]] - A short introduction to the possibilities you have as a GNU Radio user.
* [[Tutorials|Tutorials]] - The '''GNU Radio Academy''' is a complete course from beginner to advanced user.
* [[Tutorials|Tutorials]] - Several tutorials for varying skill levels.
* [[Chat|GNU Radio Community Chat]] - For real-time interaction, come join our chat rooms on [https://chat.gnuradio.org Matrix]
* [http://cgran.org The Comprehensive GNU Radio Archive Network (CGRAN)] - A list of 3rd party GNU Radio apps, check out some examples of what folks use GNU Radio to do.
* [[FAQ|Frequently Asked Questions]] - Check this page before asking questions on the mailing list.
* [[FAQ|Frequently Asked Questions]] - Check this page before asking questions on the mailing list.


= Documentation =
= Documentation =


The primary documentation is our [http://gnuradio.org/doc/doxygen/index.html C++ Manual], which includes a complete list of available blocks. It is based on Doxygen, using markup comments in the public header files.
* User Documentation
 
*# The [[Usage Manual]] contains information about various aspects of GNU Radio not specific to a certain block.
There also exists a less detailed [https://www.gnuradio.org/doc/sphinx/ Python Manual], which is primarily used for finding the Python versions of C++ functions/classes/blocks.  It is based on Sphinx to pull in both the Doxygen documentation as well as any formatted comments present in any Python files.
*# [[:Category:Block_Docs|List of Blocks]] (or just wiki search the block name)
 
* Developer Documentation
We also have a variety of [[Tutorials]]
*# Our [http://gnuradio.org/doc/doxygen/index.html C++ Manual and API Reference] includes documentation targeted for developers. It is based on Doxygen, using markup comments in the public header files.   
 
*# [[GNU Radio 3.10 OOT Module Porting Guide|3.9 to 3.10 OOT Module Porting Guide]]
Lastly, our Usage Manual contains information about various aspects of GNU Radio not specific to a certain block:
*# [[GNU Radio 3.9 OOT Module Porting Guide|3.8 to 3.9 OOT Module Porting Guide]]
* [[Handling Flowgraphs]]
*# [[GNU Radio 3.8 OOT Module Porting Guide|3.7 to 3.8 OOT Module Porting Guide]]
* [[Polymorphic Types (PMTs)]], which are heavily used in the stream tags and message passing interfaces
* [[Tutorials|Tutorials]] - Several tutorials for varying skill levels.
* [[Metadata Information]], which can be added to a raw IQ file
* [[Message Passing]], the method of passing control data, metadata, or packet structures between blocks
* [[Stream Tags]], an isosynchronous data stream that runs parallel to the main data stream
* [[Tagged Stream Blocks]], blocks that works on streamed, but packetized input data
* [[Logging]]
* [[Performance Counters]]
* [[Block Thread Affinity and Priority]]
* [[Configuration Files]], how GNU Radio defines and keeps persistent basic behavior
* [[VOLK Guide]], details about how GNU Radio performs efficient vector-optimized operations using SIMD
* [[GNURadioCompanion|The GNU Radio Companion (GRC)]], a GUI IDE for developing GNU Radio applications.


= Community & Communicating =
= Community & Communicating =
Line 44: Line 30:
There's a nice community of people involved in GNU Radio. Here's some pointers on how to connect with us.
There's a nice community of people involved in GNU Radio. Here's some pointers on how to connect with us.


* Our [[Code_of_Conduct|Code of Conduct]] describes our expectations for community participation.
* [[ReportingErrors|Asking Questions and Reporting Errors]] - We're helpful people, but '''we expect you to try to help yourself first.'''
* [[ReportingErrors|Asking Questions and Reporting Errors]] - We're helpful people, but '''we expect you to try to help yourself first.'''
* [[MailingLists|Mailing lists]] - Where most of the communication happens, but please read the previous article first.
* [[MailingLists|Mailing lists]] - Where most of the communication happens, but please read the previous article first.
* [[HowToGetInvolved|How to get involved]] - Do you want to help with the project, or simply become part of the GNU Radio Community? Read this!
* [[HowToGetInvolved|How to get involved]] - Do you want to help with the project, or simply become part of the GNU Radio Community? Read this!
* [[IRC|IRC]] - For a more real-time interaction, come join our chat room <code>#gnuradio</code> on Freenode.
* [[Chat|Chat]] - For a more real-time interaction, come join our chat rooms on [https://chat.gnuradio.org Matrix]
* [[MoreCommunity|More GNU Radio on the web and in social media]]
* [[MoreCommunity|More GNU Radio on the web and in social media]]
* [https://www.gnuradio.org/about/organization/ GNU Radio organizing members]
* [https://www.gnuradio.org/leadership/ GNU Radio Leadership]
* [[WorkingGroups|Working Groups]] - Communities of interest for various aspects of the GNU Radio ecosystem.
* [[WorkingGroups|Working Groups]] - Communities of interest for various aspects of the GNU Radio ecosystem.
* [[DevelopersCalls]] - The developers have monthly VoIP conferences which are open to join.
* [[DevelopersCalls]] - The developers have monthly VoIP conferences which are open to join.
* [[GNURadioConference|The GNU Radio Conference (GRCon)]] - archive pages: [http://gnuradio.org/grcon-2017/ 2017] | [http://gnuradio.org/grcon-2016/ 2016] | [http://www.trondeau.com/gnu-radio-conference-2015/ 2015] | [http://www.trondeau.com/gnu-radio-conference-2014/ 2014] | [http://www.trondeau.com/gnu-radio-conference-2013/ 2013] | [http://www.trondeau.com/gnu-radio-conference-2012/ 2012] | [http://www.trondeau.com/gnu-radio-conference-2011/ 2011]
* [[GNURadioConference|The GNU Radio Conference (GRCon)]] - archive pages: [http://gnuradio.org/grcon-2018/ 2018] | [http://gnuradio.org/grcon-2017/ 2017] | [http://gnuradio.org/grcon-2016/ 2016] | [http://www.trondeau.com/gnu-radio-conference-2015/ 2015] | [http://www.trondeau.com/gnu-radio-conference-2014/ 2014] | [http://www.trondeau.com/gnu-radio-conference-2013/ 2013] | [http://www.trondeau.com/gnu-radio-conference-2012/ 2012] | [http://www.trondeau.com/gnu-radio-conference-2011/ 2011]
* [[Archive of Hack Fests]]
* [[Archive of Hack Fests]] and miscellaneous [[Presentations]]
 
* We have a [[Calendar]] containing project calls and other events
* [https://calendar.google.com/calendar/embed?src=gnuradio.org_o5cbsdudkbk0f42ougcrcqgn00%40group.calendar.google.com&ctz=America/New_York GNU Radio Events Calendar] - [https://calendar.google.com/calendar/ical/gnuradio.org_o5cbsdudkbk0f42ougcrcqgn00%40group.calendar.google.com/public/basic.ics ICS Import Link]


= Developing GNU Radio =
= Developing GNU Radio =
Line 72: Line 58:
= Hardware =
= Hardware =


Hardware is strictly '''not''' part of GNU Radio, which is purely a software library. However, developing radio and signal processing code is even more fun when using hardware to actually transmit and receive, and GNU Radio supports several radio front-ends, either natively or through additional out-of-tree modules.
GNU Radio is purely a software library. However, developing radio and signal processing code is even more fun when using hardware to actually transmit and receive, and GNU Radio supports several radio front-ends, either natively or through additional out-of-tree modules. For a list of supported devices, see our [[Hardware]] page.
 
For a list of supported devices, see our [[Hardware]] page.


= Further information and 3rd party extensions =
= Further information and 3rd party extensions =
Line 80: Line 64:
There's more stuff to be found for GNU Radio on the web. Check these pages to find tutorials, code and other information on GNU Radio.
There's more stuff to be found for GNU Radio on the web. Check these pages to find tutorials, code and other information on GNU Radio.


* [http://cgran.org The Comprehensive GNU Radio Archive Network (CGRAN)]
* [[SuggestedReading|Suggested Reading]] - A list of non-GNU Radio-related literature, including good introductions to signal processing, radio engineering and software development.
* [[SuggestedReading|Suggested Reading]] - A list of non-GNU Radio-related literature, including good introductions to signal processing, radio engineering and software development.
* [[OtherCode|GNU Radio code on other servers]]
* [[ExternalDocumentation|Documentation and Videos for GNU Radio on other servers]]
* [[ExternalDocumentation|Documentation and Videos for GNU Radio on other servers]]
* [[OurUsers|Real world users]]
* [[OurUsers|Real world users]] and [[Support|Commercial Support/Training]]
* [[AcademicPapers|Selected Academic papers involving GNU Radio]]
* [[AcademicPapers|Selected Academic papers involving GNU Radio]]
* [[Support|Commercial support and training]]
* [[Presentations]]
* [[SampleData|Pre-recorded sample data]] - If you don't have a USRP, find real recorded signals for offline analysis here.
* [http://www.openbts.org OpenBTS] - An Open Source GSM interface. This is a separate project, with its own mailing list.
* [http://gqrx.dk/ GQRX] - Very nice spectrum analysis tool, powered by GNU Radio
* [http://gqrx.dk/ GQRX] - Very nice spectrum analysis tool, powered by GNU Radio

Latest revision as of 17:29, 17 April 2024

Example 2 meter NBFM receiver

GNU Radio is a free & open-source software development toolkit that provides signal processing blocks to implement software radios. It can be used with readily-available low-cost external RF hardware to create software-defined radios, or without hardware in a simulation-like environment. It is widely used in hobbyist, academic and commercial environments to support both wireless communications research and real-world radio systems.

Getting started

If you've never touched GNU Radio before, these pages will get you started with a running installation of GNU Radio and will show you how to take your first steps with this software radio tool.

Documentation

Community & Communicating

There's a nice community of people involved in GNU Radio. Here's some pointers on how to connect with us.

Developing GNU Radio

Using GNU Radio is nice, but the real fun comes with developing new components for GNU Radio or actually changing the core itself. If you want to write some code, read these articles first. Some of the tutorials are also relevant.

Hardware

GNU Radio is purely a software library. However, developing radio and signal processing code is even more fun when using hardware to actually transmit and receive, and GNU Radio supports several radio front-ends, either natively or through additional out-of-tree modules. For a list of supported devices, see our Hardware page.

Further information and 3rd party extensions

There's more stuff to be found for GNU Radio on the web. Check these pages to find tutorials, code and other information on GNU Radio.