OpenSourceSDRLab
  • Home
  • Forum
  • Shop
  • Official Site
  • About
PlutoSky

GNU Radio QPSK Modulation and Demodulation on PlutoSky P1

Learn QPSK modulation and demodulation with GNU Radio, from constellation simulation and packetized text transfer to a PlutoSky P1 SDR hardware link.

  • OpenSourceSDRLab

OpenSourceSDRLab Team

Nov 12, 2026 • min read • 58 views
GNU Radio QPSK Modulation and Demodulation on PlutoSky P1

Experimental Preparation and File Structure

Hardware Checklist

Component

Requirements and Description

PlutoSky P1

Acts as the QPSK transmitter or receiver; verify that the device is accessible via USB or network.

PlutoSDR

Second SDR device for signal reception and result verification.

Antenna

Select transmitting and receiving antennas suitable for the experimental frequency band; keep a proper distance between the transmitter and receiver to prevent input overload at the receiving end.

USB Data Cables ×2

One connects the DATA port of PlutoSky P1, and the other connects the 5V‑IN power‑supply port to prevent the device from rebooting due to insufficient power supply.

Software Checklist

Software

Purpose

Ubuntu 20.04

Run GNU Radio and the IIO driver module for PlutoSDR

GNU Radio

open and run the three GRC flow-graph projects

iio_info -s

Query the IIO context address of PlutoSky P1 to verify device detection

Experimental Files and Flow Graphs

File Name

Purpose

QPSK_mod_demod.grc

Basic QPSK simulation with channel model

QPSK_file.grc

QPSK text transmission simulation

QPSK_file_Pluto.grc

Integrated transmit & receive based on PlutoSky P1

input.txt

Text input file

Principles of QPSK Modulation

QPSK (Quadrature Phase Shift Keying) employs four complex carriers with distinct phases to represent four symbols. Each symbol carries 2 bits. Therefore, for an identical bit rate, the symbol rate of QPSK is half that of BPSK. The complex baseband symbols are expressed as:

Equation for the four QPSK carrier phases

The practical bit-to-symbol mapping is implemented by digital.psk_4()[1]. The constellation points lie on a single circle in the complex plane; all four points share the same amplitude with a phase separation of 90°. Although its constellation geometry resembles that of 4QAM, the mapping and modulation interpretation follow the definition of phase-shift keying for QPSK.

Four QPSK constellation points labeled with their corresponding two-bit symbols
Carrier waveform and modulated QPSK waveform for successive two-bit symbols

QPSK four-point constellation diagram: each two-bit symbol corresponds to a different carrier phase.

Simulation of QPSK Modem Using GNU Radio

Flow Graph Loading and Verification

Open QPSK_mod_demod.grc. In the transmit chain, the vector source generates test byte sequences. The bit repacking block splits each 8‑bit byte into 2‑bit QPSK symbols. The Unpacked to Packed block rearranges the bit stream, and the Throttle (old) block controls the flow rate, before the signal is fed into the constellation modulator to generate the QPSK complex baseband signal. A parallel branch from Char To Float to QT GUI Time Sink is used for time-domain waveform observation and does not affect the main modulation link.

After passing through the channel model where noise and frequency offset are added, the modulated signal enters the receiver chain. It sequentially goes through polyphase clock synchronization, constellation decoding, symbol mapping and bit repacking to recover the original bytes.

GNU Radio flowgraph for QPSK modulation, channel modeling, clock synchronization, and demodulation

Block

Function

Vector Source

Repeatedly generate the test byte sequence [0, 1, 2, 3, 15]

Repack Bits 8→2

Convert 8-bit byte stream into QPSK symbol stream with 2 bits per symbol

Unpacked to Packed

Repack bits in 2-bit chunks for the time-domain observation branch, not for main modulation

Constellation Modulator

Map symbols to complex baseband IQ samples according to QPSK constellation and perform upsampling

Channel Model

Simulate channel noise and frequency offset; default noise voltage 0.063, frequency offset 0

PFB Clock Sync

Recover symbol timing, resample and output one sample per symbol

Constellation Decoder + Map

Recover carrier phase, make symbol decisions and reverse symbol mapping

Analysis of Simulation Results

After execution, the source time-domain window displays the repacked QPSK symbol sequence, and the demod window shows the symbol sequence recovered after synchronization and demodulation.

GNU Radio time-domain plots comparing the transmitted source sequence and recovered demodulated sequence

The upper plot group contains two time-domain waveforms: the demod trace is the recovered baseband sequence after QPSK demodulation, while the source trace is the original transmitted bit sequence. The symbol edges of the two sequences align properly, indicating that the polyphase timing loop is locked and symbol timing is recovered correctly. The lower plot is the QPSK constellation diagram after demodulation. Four distinct, tightly clustered constellation clouds can be observed. The well-converged constellation points verify that the symbol timing recovery module works properly.

Recovered QPSK constellation showing four clustered symbol groups

QPSK Text Transmission Simulation Based on GNU Radio

Transmitter and Receiver Link

Open QPSK_file.grc. The File Source reads text data from input.txt; Stream to Tagged Stream segments the input stream into 19-byte data packets; Protocol Formatter generates packet headers; Tagged Stream Mux concatenates the headers and payloads. The stream then undergoes 8-bit to 2-bit bit repacking and QPSK modulation, and passes through a channel model with additive noise. At the receiver, polyphase clock synchronization (PFB), Costas carrier synchronization, and constellation decoding are carried out. The 2-bit symbols are converted back into 8-bit bytes, and the recovered byte stream is finally written to QPSK_file_text_output.txt.

GNU Radio flowgraph for packetized QPSK text transmission through a simulated noisy channel

Text Transmission Results

Run the QPSK_file.grc flowgraph and stop it after approximately 4.1 seconds. The output file QPSK_file_text_output.txt is created in the working directory. After the synchronization loop locks, the recovered text can be observed in the file:

Recovered hello world text sequence displayed from the output file

The recovered content matches the original text stored in input.txt. It verifies that the complete chain including packet framing, QPSK modulation, noisy channel transmission, timing & carrier synchronization, demodulation and byte reconstruction works correctly, and reliable text transmission via QPSK is realized.

QPSK Text Transmission: PlutoSky P1 Transmitter and Receiver

Integrated Flowgraph for PlutoSky P1

Open QPSK_file_Pluto.grc. On the transmitter side, text data is read from input.txt and processed with frame formatting, QPSK symbol mapping and root-raised-cosine (RRC) pulse shaping before feeding into the PlutoSDR Sink. On the receiver side, complex baseband samples are acquired from PlutoSDR Source. The signal goes through PFB clock synchronization, linear equalizer with CMA adaptive algorithm, 4th-order Costas loop, QPSK constellation decision, access code correlation and byte reassembly. Finally, the recovered byte stream is written to QPSK_file_Pluto_text_output.txt.

Integrated GNU Radio QPSK transmitter and receiver flowgraph using PlutoSDR hardware
Measured QPSK transmit spectrum and received four-point constellation from the PlutoSDR link

Result Analysis

Wait for transmission to finish, locate the output file QPSK_file_Pluto_text_output.txt and open it with Notepad for inspection.

Recovered hello world text output from the PlutoSky P1 QPSK link

The demodulation of the measured link is normal. The output file can completely restore the input hello world text sequence from the transmitter. Frame tag transmission, clock synchronization, carrier recovery, equalization and frame acquisition modules all operate stably. The function of the entire QPSK communication link is verified

Key Parameters

Parameter

Setting

Center frequency

2.4 GHz

Pluto sample rate

1.5 MS/s

RF bandwidth

1 MHz

Baseband sample rate

100 kS/s

Samples per symbol

15

CMA linear equalizer

15 taps, modulus=1, step size=0.01, sps=1

Costas Loop

order=4

Contents
    Copying is disabled for this article.
    XC7Z100-ADRV9009 User Manual
    PlutoSky

    XC7Z100-ADRV9009 User Manual

    Set up the XC7Z100-ADRV9009 SDR platform, verify ADRV9009 connectivity, run GNU Radio modulation experiments, and inspect RF signals with IIO Oscilloscope.
    Nov 18, 2026 • 33 views
    GeekRF One User Manual
    PlutoSky

    GeekRF One User Manual

    Set up the GeekRF One 2T2R SDR on Windows and Ubuntu: drivers, IIO Oscilloscope, GNU Radio, SDR#, SDRangel, a TF card boot image and on-board flash firmware.
    Nov 17, 2026 • 40 views
    Pluto+ SDR User Manual
    PlutoSky

    Pluto+ SDR User Manual

    User manual for Pluto+, a Zynq-7010 + AD9363 2T2R SDR with Gigabit Ethernet and SD boot: Windows and Ubuntu setup, the AD9361 unlock and DFU recovery.
    Nov 15, 2026 • 158 views

    OpenSourceSDRLab builds SDR, FPGA and wireless hardware, and has been testing and documenting it for engineers and radio enthusiasts since 2018.

    Shop

    • OpenSourceSDRLab Store
    • Shipping
    • Returns & Refunds

    Community

    • Forum
    • Discord
    • GitHub
    • YouTube
    • Reddit

    Blog

    • About Us
    • Categories
    • Archives
    • support@opensourcesdrlab.com
    © 2026 OpenSourceSDRLab. All rights reserved. Powered by Halo