CubeSatSim, the AMSAT CubeSat Simulator

Go to file

alanbjohnston acab005f3b Update README.md		6 years ago
afsk	removed curl	6 years ago
arduino	Update README.md	7 years ago
ax5043	Added AX-5043 register documentation URL	7 years ago
cw	tx_freq_hz sets frequency and tx_channel sets channel -50k step	7 years ago
documentation	Create readme.txt	7 years ago
groundstation	auto loading chromium	7 years ago
kicad	schematic JPG upload	7 years ago
libs	added more samples, reorganized library, publishing library code	8 years ago
openwrt	Delete tl_tcp	7 years ago
python	from Howchoo / pi-power-button	6 years ago
sdr	Add files via upload	7 years ago
spacecraft	changed back	6 years ago
spreadsheet	Experimental spreadsheet for Windows Multimon-ng Decoding	7 years ago
systemd	Update README.md	6 years ago
wav	48k mono MS (16 bit little endian)	7 years ago
.gitignore	Add AFSK example	8 years ago
Makefile	removed libcurl	6 years ago
README.md	Update README.md	6 years ago
afsk.wav	resync	7 years ago
cw.wav	resync	7 years ago
demo.sh	fixe permissions	6 years ago
demo2.sh	changed to afsk only	6 years ago
fox-demo.sh	auto demo off, fox-demo.sh to be used	6 years ago
gpl.txt	Create gpl.txt	7 years ago

CubeSatSim

The CubeSat Simulator https://github.com/alanbjohnston/CubeSatSim/wiki is a low cost satellite emulator that run on solar panels and batteries, transmits UHF radio telemetry, has a 3D printed frame, and can be extended by additional sensors and modules. This project is sponsored by the not-for-profit Radio Amateur Satellite Corporation, AMSAT®.

Requires:

See the Wiki Software Install page for more details: https://github.com/alanbjohnston/CubeSatSim/wiki/Software-Install. To build and run the software on a Raspberry Pi 3B, 3B+, or Pi Zero W (Does NOT work on a Pi 4 since rpitx does not work on it yet):

sudo apt-get install wiringpi, git, libasound2-dev

git clone http://github.com/alanbjohnston/CubeSatSim.git

git checkout aprs-rpitx-v4

cd CubeSatSim

Edit the afsk/main.c file to set your amateur radio callsign, then

make rebuild

git clone https://www.github.com/wb2osz/direwolf

cd direwolf

make -j

(takes a while)

sudo make install

make install-rpi

Note that this last command may fail if you are using Raspbian Lite since there is no Desktop.

cd ~/CubeSatSim

git clone https://github.com/F5OEO/rpitx.git

cd rpitx

./install.sh

(Takes a while). It will prompt you if you want to modify /boot/config.txt file. Type a y and the script will complete.

cd ~/CubeSatSim

git clone https://github.com/Howchoo/pi-power-button.git

cd pi-power-button

cp ../python/listen-for-shutdown.py listen-for-shutdown.py

./pi-power-button/script/install

To make the demo.sh script run automatically on boot:

sudo cp /CubeSatSim/systemd/cubesatsim.service /etc/systemd/system/cubesatsim.service

sudo systemctl enable cubesatsim

Now reboot for all the changes to take effect:

sudo reboot now

After rebooting, to hear AFSK telemetry (X.25 data), tune your radio or SDR to 434.9 MHz FM, and you should receive telemetry from the CubeSat Sim:

CubeSatSim/radioafsk

This repository contains:

afsk - Code that sends telemetry in 1k2 AFSK X.25 format
arduino - Sample Arduino sketches to show how payload sensors can be interfaced to CubeSat Simulator
ax5043 - Source for a library of functions to communicate with the AX5043 and configure the AX5043.
cw - Code that sends telemetry in CW (Morse code) using AO-7 format
libs - External libraries
python - Python code for reading I2C sensors for current and temperature
spreadsheet - Spreadsheets for decoding and analyzing the Simulator telemetry (see https://github.com/alanbjohnston/CubeSatSim/wiki/Decoding-Telemetry for details)
wav - Wave audio files of CW or AFSK telemetry for listening or transmitting usng a CubeSat Simulator Lite
demo.sh - a shell script to run the Simulator on boot using systemd (see https://github.com/alanbjohnston/CubeSatSim/wiki/Software-Install#autoboot-configuration for how to configure the Pi)