Rocket Telemetry Project Docs

Node Architecture Overview

Migrated from Original Docs/Node/Node-Architecture-Overview.md

Node Architecture Overview

Document Navigation by Audience

  • Node software engineers: Sections 4, 5, 7, 9, 10, 11, 12, 14, 15
  • RF and firmware engineers: Sections 3, 4.3, 7.5, 8, 12, 13, 14
  • Platform and integration engineers: Sections 6, 7, 9, 10, 11, 16
  • Program and operations stakeholders: Sections 1, 2, 10, 13, 16

1. Purpose

This document provides the implementation-level specification for a single antenna node in the rocket telemetry ground station. It covers the internal software processes, inter-process communication, network ports, configuration protocols, and data pipelines required to operate a phased-array or motorized antenna with SDR hardware.

Target audience: firmware engineers, systems integrators, RF hardware technicians, and central-server backend developers who need to understand node internals.


2. Node Runtime Overview

An antenna node is a single-board computer (SBC) or embedded system running:

  • FastAPI control server (Python, HTTP)
  • GNU Radio or C++ DSP pipeline (high-rate IQ processing)
  • SoapySDR hardware driver abstraction (RF transceiver control)
  • Antenna control daemon (phased-array weights, motor commands, or fixed stubs)
  • Telemetry router (frame extraction, payload demultiplexing, event streaming)

These five software subsystems run independently and communicate via Inter-Process Communication (IPC) buses, file descriptors, and shared memory.


Next: Read Node-Hardware-Interface to understand the RF, FPGA, and antenna components, or jump to your role above.

On this page