Skip to content

v2.3

Latest

Choose a tag to compare

@alanbjohnston alanbjohnston released this 21 Sep 18:20
· 10 commits to master since this release

This new version has many new features and capabilities and also supports Pi OS (Debian) Bookworm for the first time.

Major changes:

  • new PacSat mode 8, a digital store-and-forward satellite using 1200bps AX.25 packets. Ground Station is Pacsat Ground Station See https://CubeSatSim.org/pacsat for more info
  • PacSat mode includes telemetry packets with the same information as FSK and BPSK which is sent as a binary 1200bps packet and can be decoded in the Pacsat Ground Station
  • Command and Control support for PacSat mode with 8# or MODE=G
  • simulated Doppler shift for non-continuous transmit modes (does not work for FSK, BPSK, or FUNcube modes). Two versions Simulated and Radio Control. See https://CubeSatSim.org/doppler for more info
  • in Doppler shift mode, CW mode is true CW (USB or CW decoding) and flashed blue LED with dots and dashes. Uses rpitx tone
  • web Dashboard using OliveTin for GUI to execute commands
  • WiFi Access Point with hotspot.ini file that can be customized
  • NetworkManager for WiFi configuration
  • support for Debian Bookworm rpicam-still
  • logs one time or real-time
  • new logs for pacsat, frequency control, and doppler frequency
  • same script installs and updates software. Update can also switch to a new branch by including the branch name as a parameter
  • pushbutton now systemd instead of based on pi_power_button
  • new payload code that implements YPR Yaw Pitch and Roll readings from MPU6050 in FoxTelem and APRS
  • transmit frequency can be in amateur radio 70cm band or 2m band. If in 2m band, rptix transmitter is used
  • for modes where the configured transmit frequency is not used (Cross band repeater or Doppler Radio Control) the CW ID is sent twice. The first time it is sent at the configured transmit frequency as the callsign and QSY and then a second time at the other frequency as per normal.
  • telemetry now handles BME temperatures less than zero Celsius as zero
  • fixed a bug that with Lite board generated zombie processes that caused transmissions to stop after a few hours

Additional code:

  • pi_pacsat for the PacSatSim
  • pacsat_telem for PacSat telemetry
  • gpredict and rigctl for Radio Control Doppler
  • FT857d for emulation for Radio Control Doppler
  • ttyd for a web terminal interface

Config improvements:

  • volume control for microphone so it can be adjusted for Cross Band Repeater, Command and Control, and PacSat
  • maxcpus setting to control how many cores used. Default is 2 for Pi Zero 2
  • displays doppler frequency in config
  • displays presence of TXC, USB sound card, RTL-SDR, and Pi OS version in config
  • all commands can be done using command line without prompts
  • shows Pi boot file configurations
  • take a camera image for PacSat mode

Ground Station Improvements (included in the latest FIABv4 Beta image https://cubesatsim.org/download/fiabv4-beta.iso.zip):

  • ground station auto-tune for the RTL-SDR
  • Pacsat Ground Station is now fully configured for the PacSat mode of the CubeSatSim
  • Pacsat Ground Station supports either RTL-SDR for listen-only mode or a Lite board for transmit and receive
  • supports raspi-config selection of default browser between Chromium and Firefox. But Pi 4 uses Chromium by default and Pi 5 uses Firefox by default
  • Pacsat Ground Station popup for configuration of ground station and remote satellite and frequencies

There are some new Quick Start Guides to help with these new modes and features:
https://github.com/alanbjohnston/CubeSatSim/wiki/Quick-Start-Guides

A disk image for a 16 GB micro SD card is available for download: https://cubesatsim.org/download/cubesatsim-v2.3.iso.zip

To use the release Source Code zip file below, follow these steps after downloading the file (or wget https://github.com/alanbjohnston/CubeSatSim/archive/refs/tags/v2.3.zip)

cd
unzip v2.3.zip
mv CubeSatSim-2.3 CubeSatSim
cd CubeSatSim
./install

Alternatively, you can do these commands to update an existing version with git:

cd
cd CubeSatSim
git pull --no-rebase
git checkout master
./update

You should run the update command again after the reboot just to be sure everything was installed.

Note that this update won't move you from Pi OS version Bullseye to Bookworm - to do this you need to do a complete install or use the disk image.

For the Raspberry Pi Pico on the Main board, there are is updated code with this release. However, the older Pico code is also fully compatible, so you don't need to update unless you want the new Yaw/Pitch/Roll telemetry. The binary UF2 file Payload_BME280_MPU6050_YPR.ino.rpipicow.uf2 is included with this release (https://github.com/alanbjohnston/CubeSatSim/releases/download/v2.3/Payload_BME280_MPU6050_YPR.ino.rpipicow.uf2) and should work with a Pico or Pico W board. To install it, follow these steps:

Plug your Raspberry Pi Pico or Pico W into your computer using the micro USB port while holding down the BOOTSEL button (white button on the Pico). It should mount as a drive RPI-RP2.
Drag the .UF2 file from this release to the Pico flash drive
You can monitor the serial output using Arduino or a terminal emulator such as PUTTY to see the log files or make configuration changes.

What's Changed

New Contributors

Full Changelog: v2.2...v2.3