Skip to main content

Configure PpRx in the GUI

Phase 3 of 6Beginner tutorials

Generate a working .opt and .config pair so PpRx is ready to run on either your captured .bin or a live RadioLion stream. This is the third tutorial in Phase 3; the next tutorial, Process Data, finishes it.

Configure PpRx inputs and outputs in the GUI using the Configuration Generator.

Background​

PpRx requires two configuration files to run, each serving a distinct purpose:

  1. Options (.opt) file: controls I/O. It specifies the RF data source that PpRx reads, as well as the output files and devices it writes to.
  2. Configuration (.config) file: controls receiver behavior, including acquisition, tracking-loop, and estimator settings.

The RF data source specified in the .opt file can be either a live stream from RadioLion or a recorded .bin file from the previous tutorial for post-processing (replay mode).

PpRx is highly configurable through the .opt and .config files. To make initial file generation more approachable, Locus Lock includes a Configuration Generator in the GUI.

Configuration Generator​

The Locus Lock GUI includes a Configuration Generator utility. Open it with Run → Open Configuration Generator.

GUI Configuration Generator

Select the desired settings. Press the ? buttons to open information dialogs relevant to each field. Choose an output folder where the .opt and .config files will be written.

tip

For low-power host computers (e.g. Raspberry Pi), use the Low Processing Power setting.

Press the Generate and set .opt + .config button to generate and set these files as PpRx inputs within the GUI. For example, the generator may create files such as autogen_01.opt and autogen_01.config in the selected folder, then immediately load them into the Input/Output Overlay. Close the Configuration Generator dialog and verify the .opt and .config files are selected in the Input/Output Overlay.

GUI Configuration Generator

PpRx is now configured to run with the generated .opt and .config files. You can open and edit these files in a text editor using File → Edit Options File or File → Edit Configuration File from the menu bar.