Beyond controlling standalone software-defined radios, RemoteRF lets research groups combine SDRs with custom RF peripherals in the same Python script, distribute radios across multiple rooms or field sites for site-specific wireless research, and share specialized hardware across a lab or collaborator network.
Multi-Instrument & Hardware-in-the-Loop Experiments
Many experimental wireless systems pair a baseband SDR with external RF hardware that must be stepped or tuned during an experiment:
Phased Arrays & Beamformers
Control phase shifters, beamformers, or reconfigurable surfaces alongside SDR captures to measure radiation patterns, test beam alignment, or characterize self-interference.
Programmable Attenuators & RF Switches
Step programmable attenuators or RF switches from Python to automate repeatable SNR sweeps, receiver tests, and calibration without changing physical cables.
Positioners & External Sensors
Coordinate turntables, positioners, or external sensors alongside SDRs and radars to automate angular measurements and dataset collection.
Using RemoteRF’s Custom Device Schema system, any Python-controllable instrument can be exposed on the server with @idl_expose. The client generates the Python driver automatically via ensure_driver, allowing a single script to control the custom instrument and an SDR together:
import numpy as np
from remoterf.drivers import ensure_driver
from remoterf.drivers.adalm_pluto import adi
# Connect to a reserved SDR and a custom phased-array controller
sdr = adi.Pluto(token="Pluto_00@mylab")
ensure_driver(token="PhasedArray_00@mylab")
from remoterf.drivers.phased_array_ctrl import PhasedArrayCtrl
array = PhasedArrayCtrl(token="PhasedArray_00@mylab")
sdr.sample_rate = int(4e6)
sdr.rx_lo = int(2450e6)
sdr.gain_control_mode_chan0 = "manual"
sdr.rx_hardwaregain_chan0 = 30
sdr.rx_buffer_size = 8192
# Sweep beam steering angles and record received IQ power at each angle
beam_profile = {}
for angle_deg in range(-45, 46, 5):
array.steering_angle_deg = float(angle_deg)
sdr.rx_destroy_buffer()
iq = sdr.rx().astype(np.complex64)
beam_profile[angle_deg] = float(np.mean(np.abs(iq) ** 2))
sdr.rx_destroy_buffer()See the Custom Device Schema Guide for full details on wrapping new instruments with @idl_register and @idl_expose.
Site-Specific & Multi-Environment Testbeds
Wireless propagation and interference depend heavily on the surrounding environment. RemoteRF supports site-specific wireless techniques at two scales:
- Multi-room & building-scale testbeds: Attach SDRs or custom peripherals to lightweight Linux nodes (such as Raspberry Pi units configured as RemoteRF hosts) placed in different rooms, hallways, floors, or outdoor locations. All hosts register with your central RemoteRF server, so a single Python script can transmit and receive across multiple locations.
- Cross-deployment evaluation: Because scripts use the same Python driver API across all RemoteRF deployments, you can run the same experiment across different testbeds by changing the device handle (e.g.,
Pluto_00@ucla) to evaluate how algorithms and models perform across environments.
Shared Lab Infrastructure
Running a RemoteRF server on a Linux machine in your lab lets your group maintain several ready-to-use hardware setups on the same server:
- Dedicated setups by handle: Keep cabled loopback, cross-device cabled, over-the-air, and MIMO setups wired and labeled so researchers can switch between setups in software.
- Per-device RF safety bounds: Configure allowed frequency bands, sample rates, and maximum transmit gains per device in
devices.ymlto protect external amplifiers, filters, and receivers. - Scoped access for lab members, courses & collaborators: Create separate user groups with custom device whitelists and reservation limits for graduate researchers, undergraduate courses, or external collaborators—either privately on your campus network/VPN or connected to the Global Network.
Next Steps
Step-by-step reference for wrapping custom SDRs, phased arrays, and lab instruments with @idl_expose.
Deploy remoterf-host on Raspberry Pi or Linux edge nodes across multiple rooms or field sites.
Install and configure remoterf-server, user groups, and per-device RF limits.