r2cloud icon indicating copy to clipboard operation
r2cloud copied to clipboard

Decode satellite signals on Raspberry PI or any other 64-bit CPU.

About Build Status Quality Gate Status Discussions

r2cloud can track and decode various radio signals from satellites such as:

  • APT (weather satellite)
  • LRPT (weather satellite)
  • Cubesats (FSK, BPSK, QPSK, AFSK, AX.25, AX100 &etc)

Screenshots (r2cloud-ui)

    

Principal diagram

diagram

Assemble base station

Base station might include different hardware components. Please check recommended bill of materials. This is very basic setup, but it is guaranteed to be working.

Installation

  1. Install r2cloud
  • From the image. This is the easiest way to install r2cloud on Raspberry PI. It will require brand new SD card:

    • Download the latest official image
    • Insert SD card into the card reader and flash it. You could use Etcher to do this
    • Insert SD card into the card reader and create file r2cloud.txt in the root directory. This file should contain any random string. This string is a login token. This token will be used during initial setup.
  • Or from repository binaries:

    • Login via SSH and create r2cloud.txt file in /boot directory. This file should contain any random string. This string is a login token. This token will be used during initial setup.
    • Execute the following commands:
sudo apt-get install dirmngr lsb-release
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys A5A70917
sudo bash -c "echo 'deb http://apt.leosatdata.com $(lsb_release --codename --short) main' > /etc/apt/sources.list.d/r2cloud.list"
sudo apt-get update
sudo apt-get install r2cloud
  1. Open https://raspberrypi.local address.
  2. Accept self-signed certificate. This is unique certificate that was generated during installation. Once setup is complete, you could enable proper SSL using Letsencrypt.

Main features

  • Autonomous:
    • Ability to operate without internet connection
    • synchronize state once connection restored
    • new decoders could be added after auto-update
  • Integration with external systems:
  • Decode satellite signal right after reception
    • full list of supported satellite is available at jradio
    • display images if they supported by the satellite
  • Multiple devices
  • Security
    • safe to expose administration UI to the internet

Detailed features could be found in the documentation.

Contribution

Please read our guidelines.

Contact

Please follow @r2cloud1 at twitter to get the latest updates or join conversations at github discussions.

Troubleshooting guide

Frequent errors are combined in the troubleshooting guide.