OpenSourceSDRLab
  • Home
  • Forum
  • Shop
  • Official Site
  • About
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.

  • OpenSourceSDRLab

OpenSourceSDRLab Team

Nov 17, 2026 • min read • 40 views
GeekRF One User Manual

Introduction

GeekRF One is a software-defined radio of the OpenSourceSDRLab PlutoSky series. It transmits and receives from 70 MHz to 6 GHz with 2 transmit and 2 receive channels in full duplex, and adds Gigabit Ethernet and a TF card slot. The design is derived from the Analog Devices ADALM-PLUTO and improves it in the following ways:

  • Antennas: 2×2 MIMO
  • Network: Gigabit Ethernet, supported by the ZED + FMCOMMS3 port
  • Clock accuracy: 0.5 ppm TCXO, VCTCXO supported
  • Storage: TF card slot

Note: Use the device in accordance with your local laws and regulations.

Main Features

GeekRF One SDR in its aluminium alloy case

Fig. 1 The GeekRF One

The GeekRF One has four RF channels: 2 for transmit and 2 for receive. It has two USB Type-C connectors, one for OTG and one for the serial console, and a Gigabit Ethernet connector. The specifications are shown in the following pictures.

GeekRF One RF, data, interface and other specifications

Fig. 2 GeekRF One hardware and interfaces

Comparison of the GeekRF One with the ADALM-PLUTO

Fig. 3 GeekRF One specifications compared with the ADALM-PLUTO

Firmware and Downloads

The firmware files used in this manual are published on GitHub and in the OpenSourceSDRLab download center:

  • GitHub (firmware, Quick Start Guide, SHA-256 checksums): https://github.com/OpenSourceSDRLab/GeekRF-One
  • Download center: https://www.opensourcesdrlab.cn/en/download.html#p=geekrf-one
FileContents
GeekRF-One_TF-card-boot-files.zipBOOT.BIN and image.ub for the TF card system (and uImage, the Linux kernel alone, which the steps in this manual do not need)
GeekRF-One_flash-firmware_v0.37.zipthe burn_flash folder, the PlutoSDR firmware v0.37 (plutosdr-fw-v0.37) and UPDATE.BAT for the on-board flash

Technical Support and Community

If you have a question about the GeekRF One, contact OpenSourceSDRLab through any of these channels:

  • Email: support@opensourcesdrlab.com
  • Forum: https://forum.opensourcesdrlab.com
  • Discord: https://discord.gg/nnxY6DkmvT
  • Blog and user manuals: https://blog.opensourcesdrlab.com

When you ask for help, please tell us how the device is connected (OTG port, or Serial port and Ethernet), whether it boots from the TF card or from the on-board flash, and the software you use.

Windows Tutorials

Windows version: Windows 11 64-bit or Windows 10 64-bit

Hardware: GeekRF One

Software:

  • Analog Devices IIO Oscilloscope
  • GNU Radio
  • SDR# (SDRSharp)
  • SDRangel

The GeekRF One has also been tested with MATLAB R2024a.

Device Connection Methods

Before installing and testing the software, connect the device to the computer. There are two ways to do this: with a network cable and a USB Type-C cable, or with a USB Type-C cable only.

Method 1: network cable and USB cable. Connect the GeekRF One to the computer with a Gigabit Ethernet cable, and connect a USB Type-C cable to the Serial connector. With this method the computer finds the GeekRF One faster than with method 2. In Device Manager (right-click This PC › Manage › Device Manager › Ports (COM & LPT)), two new COM ports named USB Serial Port appear; they belong to the GeekRF One.

GeekRF One connected with an Ethernet cable and a USB cable to the Serial port

Device Manager showing the two USB Serial Port COM ports of the GeekRF One

Method 2: USB cable only. Connect one USB Type-C cable to the OTG connector. The computer needs about 10–20 seconds to find the GeekRF One. In Device Manager, one new COM port named Generic Serial Console appears.

GeekRF One connected with one USB cable to the OTG port

Device Manager showing the Generic Serial Console COM port of the GeekRF One

PlutoSDR Driver Installation

Install the Analog Devices PlutoSDR USB drivers for Windows (PlutoSDR-M2k-USB-Drivers.exe), available from Analog Devices: https://github.com/analogdevicesinc/plutosdr-m2k-drivers-win/releases

PlutoSDR-M2k USB driver installer for Windows

PuTTY Installation and Test

Download and install PuTTY: https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html

PuTTY download page

Connect the GeekRF One to the computer as described in Device Connection Methods.

With method 1 (network cable and USB cable to the Serial port), open the second of the two new COM ports in PuTTY (COM16 in this example). Your port number may be different; check it in Device Manager.

PuTTY serial session on the second USB Serial Port

With method 2 (one USB cable to the OTG port), open the Generic Serial Console port (COM8 in this example).

PuTTY serial session on the Generic Serial Console port

Click Open. A terminal window opens:

PuTTY terminal window after opening the GeekRF One console

Press Enter once to get the login prompt:

GeekRF One Linux console in PuTTY

IIO Oscilloscope Installation and Test

Download IIO Oscilloscope from Analog Devices: https://github.com/analogdevicesinc/iio-oscilloscope/releases

IIO Oscilloscope release download page

After installation, double-click the IIO Oscilloscope shortcut to open it.

If the GeekRF One is connected with method 1 (Ethernet and a USB cable to the Serial port), IIO Oscilloscope opens the connection dialog (if it does not, click Settings › Connect). It scans for devices and shows the information of the device it finds. Click Connect to open the main window.

IIO Oscilloscope connection dialog with the GeekRF One found over Ethernet

With method 2 (one USB cable to the OTG port), the dialog finds the device in the same way; note that the device address is different from the Ethernet connection.

IIO Oscilloscope connection dialog with the GeekRF One found over USB

Then follow the steps in the next figures until the oscilloscope shows the time-domain waveform. This shows that the GeekRF One communicates with the computer and the data transfer works.

IIO Oscilloscope: click Enable All to select all channels

IIO Oscilloscope: click the Run button

IIO Oscilloscope showing the received time-domain waveform

GNU Radio Installation and Test

Download GNU Radio (radioconda) and choose the installer for your operating system: https://github.com/ryanvolz/radioconda/releases/tag/2024.05.29

radioconda installer download page

Build the following flowgraph in GNU Radio Companion. It is a basic receive test: set the receive frequency and connect the FMComms2/3/4 Source block to the two QT GUI Sink blocks.

GNU Radio Companion receive flowgraph with an FMComms2/3/4 Source

FMComms2/3/4 Source block properties

Click Generate to create the Python code, then click Run. The received signal is displayed.

GNU Radio QT GUI sinks showing the received signal

Notes:

  1. The sample rate must be between 520833 and 61440000; other values cause an error when the flowgraph runs.

    FMComms2/3/4 Source properties with the sample-rate assertion error

  2. If the GeekRF One is connected with one USB cable (OTG port), the IIO context URI is usb:x.x.x.

    IIO context URI set to a USB address USB address of the GeekRF One shown by IIO Oscilloscope

  3. If the device is connected through Ethernet and one USB cable (Serial port), the IIO context URI is by default a dynamic address in the form ip:analog.local.

    IIO context URI set to ip:analog.local Network address of the GeekRF One shown by IIO Oscilloscope

  4. Do not leave out the quotation marks when you enter the IIO context URI.
  5. The FMComms2/3/4 Source block can be replaced by the PlutoSDR Source block, with the same settings. The PlutoSDR Source block uses only one channel of the device; everything else works the same. Likewise, the FMComms2/3/4 Sink block can be replaced by the PlutoSDR Sink block.

Create a TF Card Boot Image

Note: the TF card shipped with the device has already been prepared and tested, so you do not need to make it yourself. This section explains how to do it if you need a new card.

1. Install Win32 Disk Imager

Download and install Win32 Disk Imager: https://win32diskimager.org/

Win32 Disk Imager installer

2. Download the Kuiper Linux image

Download the latest Analog Devices Kuiper Linux release: https://wiki.analog.com/resources/tools-software/linux-software/adi-kuiper_images/release_notes

Analog Devices Kuiper Linux release notes page

Open Win32 Disk Imager and follow the steps shown in the figure:

Writing the Kuiper image to the TF card with Win32 Disk Imager

Wait while the image is written to the TF card. This usually takes 10 to 15 minutes, depending on the card.

Win32 Disk Imager writing progress

When the Write Successful dialog appears, the image has been written.

Win32 Disk Imager Write Successful dialog

3. Replace the boot files

Unzip GeekRF-One_TF-card-boot-files.zip (see Firmware and Downloads) and copy BOOT.BIN and image.ub to the BOOT drive of the TF card you have just written, replacing the files there.

BOOT.BIN, image.ub and uImage boot files

BOOT drive of the TF card after copying the boot files

The TF card for the GeekRF One is ready. Insert it into the TF card slot of the device.

Flash the On-board Firmware

With the PlutoSDR firmware in the on-board flash, the GeekRF One works without a TF card. You need a TF card made as described in the previous section.

Caution: step 4 erases the whole on-board flash. Complete all the steps; until the last step is done, the device cannot start from the on-board flash.

  1. Unzip GeekRF-One_flash-firmware_v0.37.zip (see Firmware and Downloads). Connect the TF card to the computer with a card reader and copy the burn_flash folder to its BOOT drive.

    burn_flash folder in the firmware package

    burn_flash folder copied to the BOOT drive of the TF card

  2. If the two USB Serial Port entries do not appear in Device Manager, install the Digilent USB driver (install_digilent.exe, Digilent Inc.). It is included in AMD Vivado and Vivado Lab Edition.

    Digilent USB driver installer

  3. Insert the TF card into the GeekRF One. Connect the computer to the GeekRF One with a network cable and a USB cable to the Serial port.

    GeekRF One connected for flashing with an Ethernet cable and a USB cable to the Serial port

  4. Open the COM port in PuTTY (speed 115200). Power on the device and press any key before the countdown ends to stop in the U-Boot command line.

    PuTTY configuration: serial line, speed 115200, connection type Serial

    Enter the following commands one after the other:

    sf probe
    sf erase 0x0 0x2000000

    Stopping autoboot and entering sf probe and sf erase in the U-Boot command line

    sf erase finished in the U-Boot command line

  5. Power the GeekRF One off and on again (unplug the USB cable and plug it in again).

    The system on the TF card starts. When root@analog:~# appears in PuTTY, enter the following commands one after the other:

    mount /dev/mmcblk0p1 /mnt
    cd /mnt/burn_flash
    chmod +x autoconfig.sh
    ./autoconfig.sh
    sudo shutdown -h now

    autoconfig.sh writing the flash partitions

  6. When the device has shut down, disconnect the USB cable from the Serial port.
  7. Remove the TF card and connect a USB cable to the OTG port. On the computer, open the unzipped firmware folder (the one that contains UPDATE.BAT).

    GeekRF One connected with one USB cable to the OTG port for the firmware update

  8. When USB download gadget appears in Device Manager, right-click an empty area of the folder and click Open in Terminal.

    USB download gadget in Device Manager

    Open in Terminal command in the folder context menuUnzipped firmware folder with burn_flash, the firmware folder and UPDATE.BAT

  9. Enter the following command in the terminal (it needs the PlutoSDR USB drivers from PlutoSDR Driver Installation):
    .\UPDATE.BAT .\plutosdr-fw-v0.37\pluto.dfu

    UPDATE.BAT writing pluto.dfu to the GeekRF One

  10. Wait until the firmware has been written completely, then power the device off and on again. The LED flashes and the GeekRF One now works without a TF card.

    IIO Oscilloscope connection dialog showing the PlutoSDR firmware v0.37 on the GeekRF One

    IIO Oscilloscope main window connected to the GeekRF One

    PlutoSDR firmware console of the GeekRF One in PuTTY

SDR# Installation and Test

SDR# (SDRSharp) is a popular software-defined radio receiver for Windows. It works with the GeekRF One through the PlutoSDR plugin. To use SDR#, the GeekRF One must run from the on-board flash without a TF card (see Flash the On-board Firmware). Connect the OTG port.

Install SDR# and the PlutoSDR plugin

  1. Download the PlutoSDR plugin sdrsharp-plutosdr-0.5.4.zip from https://github.com/Manawyrm/sdrsharp-plutosdr/releases.
  2. Download the x86 version of SDR# that the plugin page links to: https://airspy.com/downloads/sdrsharp-x86-noskin.zip.
  3. Unzip both files into separate folders, then copy all files from the plugin folder into the SDR# folder and replace the existing files.
  4. Open FrontEnds.xml in the SDR# folder with Notepad, add the following line directly above </frontendPlugins>, and save the file:
    <add key="PlutoSDR" value="SDRSharp.PlutoSDR.PlutoSDRIO,SDRSharp.PlutoSDR" />
  5. Double-click SDRSharp.exe to start the program.

Receive FM broadcasts with SDR#

  1. Connect an antenna to the RX1 port.
  2. In the Source list at the top left, select PlutoSDR. If the GeekRF One is not listed, the plugin files were probably not copied completely, or the SDR# version does not match the plugin; download both again from the links above.
  3. Click the configure button next to the source. Set the URI (connection string) to usb: for a USB connection, or to ip:192.168.2.1 to use the network address of the PlutoSDR firmware over USB. Set Sample Rate to 4 MSPS.
  4. Enter the frequency of a local FM station, for example 103.9 MHz. In the Radio panel select WFM and set the bandwidth to 200000 (200 kHz).
  5. Click the play button. If the signal is weak, increase the gain. You should hear the broadcast.

SDRangel Installation and Test

SDRangel is an open-source SDR application with many demodulators and analysers. It supports the PlutoSDR and therefore the GeekRF One. Use the same setup as for SDR#: the on-board flash firmware and a USB cable to the OTG port.

Install SDRangel

  1. Download the Windows installer from the SDRangel releases page: https://github.com/f4exb/sdrangel/releases
  2. Right-click the installer and select Run as administrator. If User Account Control asks whether to allow the app to make changes to your device, click Yes.
  3. In the installation wizard click Next, accept the licence agreement and click Install.

Receive FM broadcasts with SDRangel

  1. Connect an antenna to the RX1 port.
  2. Start SDRangel. In the empty workspace, click the Add Receiver icon and select PlutoSDR from the list.
  3. In the device settings, set the sample rate to about 2.5 MS/s and the center frequency to a local FM station, for example 103.9 MHz. Click the play button to start the device. The spectrum and the waterfall are displayed.
  4. Click Add Channel and select Broadcast FM Demodulator. Adjust the channel settings if needed; you should hear the FM broadcast through your speakers.

Ubuntu Tutorial

Ubuntu Installation

You can use Ubuntu on a physical computer or in a virtual machine. A virtual machine is recommended because it makes debugging easier.

  1. To use a virtual machine, install a virtualisation program such as VMware Workstation Pro.
  2. Install Ubuntu 22.04 LTS (the current long-term support version at the time of writing): https://ubuntu.com/tutorials/install-ubuntu-desktop
  3. Install GNU Radio and the libiio tools:
    sudo apt-get install gnuradio
    sudo apt-get install libiio-utils

Installing libiio-utils in the Ubuntu terminal

libiio Installation and Test (USB connection)

  1. Connect the OTG port of the GeekRF One to the computer with a USB Type-C cable.

    GeekRF One connected to the OTG port for the Ubuntu USB test

  2. If you use a virtual machine, connect the GeekRF One to the virtual machine, as shown in the following figure:

    Connecting the GeekRF One USB device to the Ubuntu virtual machine

    Removable devices menu of the virtual machine with the Analog Devices device

  3. Enter lsusb in the terminal. An Analog Devices device in the list shows that Ubuntu is connected to the GeekRF One.

    lsusb output with the Analog Devices device

    lsusb output listing the GeekRF One

  4. Enter sudo iio_info -s to find the USB address of the device. In this example it is usb:3.6.0.

    Note: this command needs sudo. Without sufficient permissions the device is not found.

    sudo iio_info -s showing the USB address of the GeekRF One

    iio_info scan result with the GeekRF One context

libiio-utils installation finished in the Ubuntu terminal

GNU Radio Installation and Test

Test the communication and data transfer with GNU Radio in the same way as under Windows (see GNU Radio Installation and Test). Start GNU Radio Companion with sudo, for the reason given in the note above:

sudo gnuradio-companion

Ethernet Connection Test

  1. Connect the GeekRF One to the computer with a Gigabit Ethernet cable, and connect a USB Type-C cable to the Serial connector.

    GeekRF One connected over Ethernet and the Serial port for the Ubuntu network test

  2. Set a static IP address on the GeekRF One. Open the Linux console in PuTTY and open the network configuration file:
    sudo vi /etc/network/interfaces

    Default /etc/network/interfaces file on the GeekRF One

    Press i to edit the file and change it as shown in the following figure:

    /etc/network/interfaces with a static IPv4 address

    Press Esc, enter :wq and press Enter to save the file and exit. The device uses the static address after the next restart.

    Saving the network configuration in vi

  3. When the device uses a static IPv4 address, disable IPv6 on the computer's Ethernet adapter (see Appendix A). Otherwise the computer, and IIO Oscilloscope, keep connecting over IPv6. Then restart the network adapter, for example by disabling and enabling it.

    IIO Oscilloscope still connecting over an IPv6 address

    IIO Oscilloscope connecting over the static IPv4 address 192.168.2.2

  4. On the computer (Windows, or the Ubuntu virtual machine), set the IP address, netmask and gateway as shown in the following figures. The computer must be in the same subnet as the GeekRF One (192.168.2.x in this example):

    Static IPv4 settings of the computer's Ethernet adapter in Windows Static IPv4 settings in Ubuntu

  5. Check the network connection between the GeekRF One and the computer:

    Ping from Windows to the GeekRF One Ping from Ubuntu to the GeekRF One

Appendix A: Disable IPv6 on Windows

Windows 7, 8.1 and 10

  1. Right-click the network icon in the notification area and select Open Network & Internet settings.

    Open Network and Internet settings from the notification area

  2. Open Network and Sharing Center.

    Network and Sharing Center link

  3. Click your network adapter. To find the right adapter, unplug and plug in the network cable and see which adapter changes.

    Network adapter in Network and Sharing Center

  4. Click Properties.

    Network adapter status window with the Properties button

  5. Clear Internet Protocol Version 6 (TCP/IPv6), then click OK and Close.

    Internet Protocol Version 6 cleared in the adapter properties

Windows 11

  1. Click the search (magnifying glass) icon on the taskbar.

    Windows 11 taskbar search icon

  2. Type Network Connections and open the matching result.

    Searching for Network Connections in Windows 11

  3. Right-click your network adapter and click Properties.

    Network adapter context menu with Properties

  4. Clear Internet Protocol Version 6 (TCP/IPv6), then click OK and Close.

    Internet Protocol Version 6 cleared in Windows 11

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 • 157 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