GNU Radio Companion (Old)Note These instructions are for GRC 0.70 and below. If you are using the GRC bundled with your gnuradio installation, please use this guide instead. The GNU Radio Companion is a preliminary graphical user interface which allows GNU Radio components to be put together graphically. It is currently under development by Josh Blum. GNU Radio Companion encompasses over 200 blocks from the GNU Radio Project. How it WorksBlocks are manually integrated into GRC via descriptive python definitions. The definitions are very flexible, and allow multiple GNU Radio blocks to be grouped into a single "super-block". A graphical interface allows the user to configure and connect these blocks into a flow graph. The flow graph is saved in an xml format. Another program reads this xml file and reconstructs the flow graph with native GNU Radio blocks. ComponentsFlow Graph: Signal Blocks: Parameters: Sockets: Connections: Variables: DownloadStableAn archive of all releases can be found here: Release Archive DevelopmentSee the current GRC guide. InstallationGRC dependencies: Any version of GNU Radio should work (however, I recommend the trunk for best support). If a block does not exist in a particular version, GRC will ignore the missing block. Installing GNU Radio will take care of most of GRC's dependencies. GRC needs wx support to run flow graphs, and gtk2 for its main GUI. The python XML module is essential, as all flow graphs and user preferences are saved to and loaded from xml. The package names for pyxml vary among software distributions. If GRC crashes with an XML related error, follow the cygwin + pyxml notes below.
Notes for Ubuntu Hardy Heron users: Ubuntu removed the xml.dom.ext package from their repositories. GRC 0.70 and below require this package. Solution: download the pyxml source. Unpack the source, and run "sudo python setup.py install" from the source directory. This issue has been fixed in the trunk and in future releases. Notes for Cygwin users: Install pygtk with the Cygwin setup.
For python-xml, download the pyxml
source. Notes for MacOSX users: Follow the Mac Install Instructions. Use mac ports (or whatever program you picked) to install the dependencies for GRC. Also, make sure to install wx-python 2.6.3 or 2.8.6, since 2.8.4 causes problems. Operating System Compatibility
InstructionsExecuting the ProgramIn the src folder, execute Modifying BlocksAdding a block: Moving a block: Rotating a block: Deleting a block: Connecting blocks: Modifying ParametersDouble click on a block or select it and choose properties from the edit menu. A dialog containing all the parameters for the signal block will appear. Some parameters are set via a drop down menu, most must be typed in as characters. These parameters are usually numeric, representing sampling rates, gains, and amplitudes. Numeric parameters may contain mathematical expressions with variables. Math ExpressionsA math expression may contain any number of variables, numbers, and
operators. There must be an operator between every number/variable. Possible
operators are See Help->Math Expressions in the Editor. Using VariablesThe variable window has 5 columns: variable name, default value, minimum value, maximum value, step size. Choose add to create a new variable entry. Choose remove to delete a selected variable entry. Any value in an entry can be edited by clicking on the input field in the selected row. Invalid changes to a cell are ignored. Variable names are case-sensitive and alpha-numeric, and they may contain hyphens. The first character must be a letter. The default value for the variable may be any string. Using Variables with RangesA variable with a range may be dynamically changed while the flow graph is executing. However, only signal block parameters, underlined in the signal block's properties window, can actually be altered while the flow graph is executing. For a ranged variable, the default, minimum, maximum, and step size values must be of type float or int. To make a variable with a range, simply type a number into the min or the max input field and the other fields will be filled in. The min must be less than or equal to the default, and the max must be greater than or equal to the default. To remove the range from a variable, just clear one of the input cells for min, max, or step and all cells will be cleared. Flow Graph Validation
Running a Flow GraphIf a flow graph is valid, all parameters are valid and all sockets are
connected. Choose run from the tool bar or press F5. A wx window will appear
with any sliders or graphs that were added. To stop the flow graph, close the wx
window, press stop in the tool bar, or press F7. Flow graphs can be run without
the interface by invoking the python interpreter on
OptionsThe options menu allows the user to adjust the window size, set user preferences, and view USRP information.
WishlistFeel free to add requests for new features and behaviors.
Screen ShotsFeel free to submit your own screen shots or flow graphs.
注: GNU Radio Companion (Old) (原文出处,翻译整理仅供参考!) |