GrOsmoSDR

https://osmocom.org/projects/gr-osmosdr/wiki
Admin
GrOsmoSDR is a GNU Radio module that provides a unified software API for interfacing with various...
Tokens:4,910
Snippets:32
Trust Score:9.6
Update:1 month ago
Show doc for...
Tokens:
Raw
### Spectrum Browser usage examples

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Examples for running the osmocom_fft application with various hardware sources.

```bash
osmocom_fft -a rtl=0 -v -f 100e6 -s 2.4e6 -g 15
osmocom_fft -a rfspace -v
osmocom_fft -a bladerf -v
osmocom_fft -a hackrf -v
osmocom_fft -a uhd -v
osmocom_fft -a airspy -v
```

--------------------------------

### Build and install gr-osmosdr

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Compile the source code and install the binaries to the system.

```bash
make
sudo make install
sudo ldconfig
```

--------------------------------

### Signal generator usage examples

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Examples for running the osmocom_siggen and osmocom_siggen_nogui applications with various hardware sources.

```bash
osmocom_siggen -a hackrf -f 100e6 --sine
osmocom_siggen -a hackrf -f 100e6 --sweep -x 2M -y 1 -c34
osmocom_siggen_nogui -a hackrf -f 100e6 --sweep -x 2e6 -y 10 -v
osmocom_siggen_nogui -a uhd,subdev=A:0 -f 100e6 --sweep -x 2e6 -y 10 -s 4e6 -v
osmocom_siggen -a bladerf -f 1G --sweep -x 4M -y 1 -s 4M
```

--------------------------------

### CMake component summary output

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Example output from the CMake configuration step showing enabled and disabled components.

```text
-- ######################################################
-- # gr-osmosdr enabled components                         
-- ######################################################
--   * Python support
--   * Osmocom IQ Imbalance Correction
--   * sysmocom OsmoSDR
--   * FUNcube Dongle
--   * FUNcube Dongle Pro+
--   * IQ File Source
--   * Osmocom RTLSDR
--   * RTLSDR TCP Client
--   * Ettus USRP Devices
--   * Osmocom MiriSDR
--   * HackRF Jawbreaker
--   * nuand bladeRF
--   * RFSPACE Receivers
-- 
-- ######################################################
-- # gr-osmosdr disabled components                        
-- ######################################################
-- 
-- Building for version: v0.1.0-4-g37aba331 / 0.1.1git
-- Using install prefix: /usr/local
```

--------------------------------

### Configure build with CMake

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Create a build directory and run CMake to detect dependencies and configure the project.

```bash
mkdir build
cd build/
cmake ../
```

--------------------------------

### Build API documentation

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Generate the project's API documentation using Doxygen.

```bash
cd build/
cmake ../ -DENABLE_DOXYGEN=1
make -C docs
```

--------------------------------

### bladeRF Configuration Arguments

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Configuration parameters for bladeRF devices, including FPGA loading, buffer management, and clock settings.

```APIDOC
## bladeRF Configuration

### Description
Arguments used to configure bladeRF source and sink devices.

### Parameters
- **bladerf** (string) - Optional - Selects device by instance or serial number.
- **fpga** (string) - Optional - Path to FPGA bitstream file.
- **fpga-reload** (int) - Optional - Force FPGA reload (1).
- **buffers** (int) - Optional - Number of sample buffers (Default: 32).
- **buflen** (int) - Optional - Length of sample buffer in samples (Default: 4096).
- **transfers** (int) - Optional - Number of in-flight transfers.
- **stream_timeout_ms** (int) - Optional - Stream timeout in ms (Default: 3000).
- **loopback** (string) - Optional - Loopback mode (none, bb_txlpf_rxvga2, etc.).
- **verbosity** (string) - Optional - libbladeRF stderr verbosity level.
- **xb200** (string) - Optional - Filter selection.
- **smb** (float) - Optional - Frequency output on SMB connector.
- **tamer** (string) - Optional - Clock input mode (internal, external, external_1pps).
```

--------------------------------

### Clone the gr-osmosdr repository

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Initial step to download the source code from the Osmocom Gitea repository.

```bash
git clone https://gitea.osmocom.org/sdr/gr-osmosdr.git
cd gr-osmosdr/
```

--------------------------------

### bladeRF xb200 filter parameters and gain mappings

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Lists valid filter options for the xb200 parameter and provides the gain mapping ranges for bladeRF sink and source configurations.

```text
The following values are valid for the xb200 parameter:
"custom"  : custom band
"50M"     :  50MHz band
"144M"    : 144MHz band
"222M"    : 222MHz band
"auto3db" : Select fiterbank based on -3dB filter points
"auto"    : Select filerbank based on -1dB filter points (default)

gr-osmosdr <-> bladeRF gain mappings

Sink:
BB Gain: TX VGA1 [-35, -4]
IF Gain: N/A
RF Gain: TX VGA2 [0, 25]

Source:
RF Gain: LNA Gain {0, 3, 6}
IF Gain: N/A
BB Gain: : RX VGA1 + RX VGA2 [5, 60]
```

--------------------------------

### HackRF Configuration Arguments

Source: https://osmocom.org/projects/gr-osmosdr/wiki/GrOsmoSDR

Configuration parameters for HackRF devices, including device selection and antenna bias settings.

```APIDOC
## HackRF Configuration

### Description
Arguments used to configure HackRF source and sink devices.

### Parameters
- **hackrf** (string) - Optional - Device index or serial number.
- **bias** (int) - Optional - Antenna bias voltage in receive mode (0 or 1).
- **bias_tx** (int) - Optional - Antenna bias voltage in transmit mode (0 or 1).
- **buffers** (int) - Optional - Number of buffers (Default: 32).
```
Tokens:
Raw