Track new features, improvements, and bug fixes for the RemoteRF central server (remoterf-server) and edge host (remoterf-host) packages. For Python client and CLI release notes, see User Guide Releases.
ADALM-Pluto TX lockouts, built-in admin group, and local-time usage reporting
This release adds optional per-device ADALM-Pluto TX lockouts with admin-group override, a built-in admin user group covering every device, local-time reservation usage reporting for Global deployments, and host tunnel reliability fixes.
Improvements (3)
- Added optional per-device TX lockouts in
devices.yml(init:keys such astx_min_freq/tx_max_freq,tx_max_gain_db,tx_enabled,max_sample_rate,tx_allowed_channels,rx_min_freq/rx_max_freq, andpark_tx_lo) across all Pluto variants viaremoterf-device-core0.1.9, with fail-closed load validation, opt-inadmin_group_override, capability-gatedreservation_tagforwarding to edge hosts, and lockout-awareserverrf diagand startup checks. - Added a built-in
adminuser group seeded at startup that covers all devices (including newly added ones) and is protected from deletion, renaming, whitelist narrowing, expiration, and cluster or Global sharing; any pre-existing narrower or expiringadmingroup is automatically preserved asadmin-old-<id>. - Added local-time reservation usage reporting (
ReservationLocalBucketsandusage.localby local wall-clock hour, weekday, and timezone) in Global status reports, with automatic fallback when talking to older Global servers.
Fixes (1)
- Fixed host tunnel session handling so dropped congested sessions terminate their stream cleanly, stale heartbeats cannot mark a dropped host online, and slow session closes no longer run under the reservation lock.
Application integrations for USRPs, process supervision, and OAI gNB scaffold
This release introduces an opt-in application integration runtime for lab-local USRPs with Linux cgroup process supervision, chunked artifact fetching, configurable per-integration timeouts, and an OAI gNB adapter scaffold.
Improvements (3)
- Added an opt-in application integration runtime for serial-addressed, lab-local USRPs (disabled by default until explicitly enabled in
integrations.json) exposing the sevenintegration_*RPCs, hardware ownership handoff, and Linux cgroup-verified process supervision and cleanup. - Added chunked artifact fetching (up to 384 KiB per chunk with 256-entry / 256 MiB per-operation limits) and configurable per-integration
start_timeout_s,action_timeout_s, andstop_timeout_soperator bounds. - Added a bundled OpenAirInterface gNB adapter scaffold (
remoteRF_server.adapters.oai, IDorg.remoterf.oai) with operator-gateduser_codesupport for supervised L1 C plugin compilation and Python xApp runs.
Built-in device drivers, non-interactive admin CLI flags, and reserved-time accounting fixes
This release bundles native drivers for six additional device types, adds non-interactive CLI flags for group, code, and user management, and fixes RPC codec serialization and mid-slot reservation accounting.
Improvements (3)
- Bundled native drivers for
bluetooth,gps,krakensdr,rfbeam_kmd7,ti_awr6843, andwifiinremoterf-device-corewith optional per-driver dependency extras andserverrf schema served <type> [--json]inspection. - Added non-interactive CLI flags (
--yes,--json) forserverrf groups create|edit|remove,serverrf codes create|remove, andserverrf usersadministration. - Added per-device daily usage and transport path counters (
direct,relay,lan) for Global-shared devices.
Fixes (2)
- Fixed reserved-time accounting triggers so bookings made after a slot has started count only the remaining slot duration.
- Fixed RPC and v2 codec handling for nested
bytes, empty lists/tuples, and trailing NUL bytes in byte/string lists.
Unified serverrf CLI, tmux background console, and hardware diagnostics
This release unifies all bash and interactive serverrf commands, adds a persistent tmux console with live Unix-socket reloading, automated SDR self-tests (diag), approved schema registry downloads (schema), and remote Ed25519 administration (admins).
Improvements (3)
- Unified the
serverrfCLI and interactiveserver@remoterf:console into a single command table (config,certs,devices,hosts,groups,codes,users,reservations,global,schema,cluster,admins,db) with live Unix-socket reload/restart. - Added persistent
tmuxbackground session management (serverrf -sattaches,Ctrl-C/detachkeeps the server running,serverrf -s --daemonstarts detached) and an interactive first-run setup wizard. - Added automated hardware self-test diagnostics (
serverrf diag), approved community schema registry browsing and downloading (serverrf schema browse|download), hot database snapshots (serverrf db export), and Ed25519-authenticated remote administration (serverrf admins).
Multi-deployment routing and course enrollment quotas
This release adds handle resolution across interconnected RemoteRF deployments, per-group reservation quotas for classroom use, and backwards-compatible device type aliases.
Improvements (3)
- Added multi-deployment routing and handle resolution (
Name@deployment) for interconnected RemoteRF nodes. - Added per-group reservation quotas, enrollment code expiration windows, and administrative CLI subcommands in
serverrf. - Added rate limiting and structured error responses for non-interactive CLI and MCP clients.
Fixes (1)
- Fixed alias handling in
devices.ymlso legacydevice_type: plutoentries map cleanly toadalm_pluto.
Per-device RF safeguards and frequency exclusion bands
This release adds server-enforced frequency lockouts and transmit gain limits in devices.yml, along with faster offline host detection.
Improvements (2)
- Added configurable frequency exclusion bands, TX attenuation floors, and maximum gain limits per device in
devices.yml. - Improved host heartbeat monitoring and offline state reporting when edge hosts lose network connectivity.
Fixes (1)
- Fixed a race condition when canceling an active reservation while a client RPC stream is still open.
IDL schema registry and multi-host session routing
This release introduces the Interface Description Language (IDL) schema registry and distributed edge host routing architecture.
Improvements (3)
- Added automatic IDL schema hash verification and driver version matching between
serverrf,hostrf, and connected Python clients. - Added distributed RPC routing to support multiple remote
remoterf-hostnodes per server. - Added built-in device schemas for ADALM-Pluto, ADALM-Pluto MIMO, USRP 2901, USRP B205-mini, USRP N210, HackRF One, and RTL-SDR.
Initial public release of remoterf-server
Initial release of the central RemoteRF server daemon for university lab and classroom deployments.
Improvements (2)
- Added the core reservation scheduler, user group management, and token authentication in
serverrf. - Added TLS certificate management and SQLite/PostgreSQL persistence for user accounts and reservations.
ADALM-Pluto TX lockouts, per-reservation RPC tagging, and hardware access fencing
This release adds per-device ADALM-Pluto TX lockouts with fail-closed validation, capability-gated per-reservation RPC tagging across forwarded and direct paths, coordinated hardware access fencing during reloads, and improved tunnel-loss cleanup.
Improvements (3)
- Updated
remoterf-device-coreto0.1.9to enforce optional per-device ADALM-Pluto TX lockouts (tx_min_freq/tx_max_freq,tx_max_gain_db,tx_enabled,max_sample_rate,park_tx_lo, and relateddevices.ymlinit:keys) across all Pluto variants with opt-inadmin_group_overrideand fail-closed load validation. - Added capability-gated per-reservation tagging (
reservation_tag) acrossreservation_start, forwarded RPCs, and signed direct-host grants so mismatched frames are rejected and tunnel reconnects resync tag and override state without re-running device prepare. - Added coordinated hardware access fencing (
AccessTable) and bounded reservation-hook scheduling during device reloads, plus explicitunsupported_hostandinvalid_payloadrefusals for USRPintegration_*calls without disrupting active native UHD sessions.
Fixes (1)
- Fixed tunnel-loss teardown ordering so per-device reservation cleanup runs before closing Dynamic v2 bridge sessions after a dropped server connection.
Built-in native device drivers, Pluto MIMO rate helpers, and RPC codec fixes
This release bundles six additional native device drivers in remoterf-device-core, adds ADALM-Pluto MIMO filter rate helpers and RTL-SDR buffer reset fallback, and fixes nested bytes and list serialization.
Improvements (2)
- Bundled native drivers for
bluetooth,gps,krakensdr,rfbeam_kmd7,ti_awr6843, andwifiinremoterf-device-corewith optional dependency extras, serving them without requiring local files in thedrivers/directory. - Added ADALM-Pluto MIMO filter sample-rate and decimation/interpolation helpers (
get_rates,get/set_rx_dec8_filter_en,get/set_tx_int8_filter_en) and an RTL-SDRreset_bufferfallback.
Fixes (1)
- Fixed RPC and v2 codec serialization for nested
bytes, empty lists and tuples, and byte/string lists with trailing NUL bytes.
Internet-connected hosts, direct ICE/QUIC streaming, and Global relay sub-slots
This release enables hosts on Global Deployments to operate over the internet with automatic Global route fallback, direct client-to-host ICE/QUIC streaming, and dedicated SSH relay sub-slots.
Improvements (2)
- Added automatic fallback to a Global Deployment's published routes (
.well-known/remoterf-deployment) when the configured LAN address is unreachable, allowing hosts to operate off-LAN over the internet. - Added direct client-to-host ICE/QUIC connections and reverse-SSH Global relay sub-slots (
<host_id>--<deployment>.global.remoterf.net) with Ed25519 reservation grants and pinned CA certificate verification (--ca-sha256).
Automated SDR state cleanup and session teardown reset
This release improves hardware reliability between back-to-back reservations by resetting USB and Ethernet SDR state whenever a client session ends.
Improvements (2)
- Added automatic LO, gain, and buffer state cleanup in
hostrfwhen a client disconnects or a reservation expires. - Improved USB device re-enumeration recovery for ADALM-Pluto and RTL-SDR units on Linux edge hosts.
Fixes (1)
- Fixed stale lockfile handling when restarting the
hostrfsystemd service after an unclean shutdown.
UHD 4.10.0.0 runtime verification and watchdog recovery
This release adds runtime verification for UHD 4.10.0.0 on USRP hosts and improves heartbeat reconnection behavior.
Improvements (2)
- Added startup and session-open verification of UHD Python API
4.10.0.0for USRP 2901, USRP B205-mini, and USRP N210 devices. - Added automatic gRPC transport reconnection when the central server restarts.
Decorator-based IDL driver exposition and ARM64 edge host support
This release introduces the @idl_expose schema decorator pipeline and official support for Ubuntu Server 24.04 LTS on x86_64 and Raspberry Pi (aarch64) hosts.
Improvements (3)
- Added the
@idl_exposedecorator framework for exposing hardware driver methods and properties over RemoteRF's RPC pipeline. - Added support for Ubuntu Server 24.04 LTS on
x86_64workstations andaarch64Raspberry Pi edge hosts. - Added built-in host drivers for ADALM-Pluto, ADALM-Pluto MIMO, USRP (UHD), HackRF One, RTL-SDR, and custom Python device schemas.
Initial public release of remoterf-host
Initial release of the RemoteRF edge host daemon for managing USB- and LAN-attached ADALM-Pluto radios.
Improvements (1)
- Added the
hostrfdaemon for bridging local IIO/USB software-defined radios to a central RemoteRF server.