search

VirusPilot / stratux-pi4

Stratux Europe on a Pi3, Pi4, Pi5 or Pi Zero 2 W based on a fresh 64bit RasPiOS Image
20 stars 6 forks source link

readme

Build a Stratux Europe on a Pi3, Pi4, Pi5 or Pi Zero 2W based on a fresh 64bit RasPiOS Lite Image

stratux-pi4-standard

based on https://github.com/b3nn0/stratux

stratux-pi4-viruspilot

based on my fork https://github.com/VirusPilot/stratux with the following modifications compared to the "standard" version:

please use these scripts with caution and only on a fresh 64bit RasPiOS Lite Image, because:

prepare script for Pi3, Pi4, Pi5 or Pi Zero 2W:

start build process

login with ssh as pi user with the above set password, then:

sudo su

standard version:

cd ~/
apt update
apt full-upgrade -y
sudo bash -c "$(wget -nv -O - https://raw.githubusercontent.com/VirusPilot/stratux-pi4/master/setup-pi4-standard.sh)"

viruspilot version:

cd ~/
apt update
apt full-upgrade -y
sudo bash -c "$(wget -nv -O - https://raw.githubusercontent.com/VirusPilot/stratux-pi4/master/setup-pi4-viruspilot.sh)"

optional components:

enabling Persistent logging on Stratux settings page is required!

SkyDemon related Remarks

Limitations/Modifications/Issues

Remarks - SDR programming simple mode

Remarks - SDR programming expert mode (1)

During boot, Stratux tries to identify which SDR to use for which traffic type (ADS-B, OGN) - this is done by reading the "Serial number" entry in each SDRs. You can check or modify these entries as described below, it is recommended for programming to only plug in one SDR at a time, connect the appropriate antenna and label this combination accordingly, e.g. "868" for OGN.

stxstop (stop Stratux from claiming the SDRs)
rtl_eeprom

will report something like the following:

Current configuration:
__________________________________________
Vendor ID:              0x0bda
Product ID:             0x2838
Manufacturer:           Realtek
Product:                RTL2838UHIDIR
Serial number:          stx:868:0
Serial number enabled:  yes
IR endpoint enabled:    yes
Remote wakeup enabled:  no
__________________________________________

This SDR is obviosly programmed for Stratux (stx), OGN (868MHz), and a ppm correction of "0", the ppm can be modified later, see below. If your SDR comes pre-programed (it would be labled with e.g. with "1090") there is no need to program it.

You can program the Serial number entry with the following command:

rtl_eeprom -s stx:1090:0

to prepare it e.g. for ADS-B (1090MHz) use. A reboot is necessary to activate the new serial number.

If for some reasons an error occurs while programming, please consider preparing the SDR with the default values:

rtl_eeprom -g realtek

At this point you can already test your SDR and receive ADS-B traffic with the following command:

rtl_adsb -V

Or listen to you favorite FM radio station (my station below is at 106.9MHz) by pluging in a headset and run the following command:

rtl_fm -M fm -f 106.9M -s 32000 -g 60 -l 10 - | aplay -t raw -r 32000 -c 1 -f S16_LE

Remarks - SDR programming expert mode (2)

During boot, Stratux furthermore reads the ppm correction from the SDR Serial number, e.g. if the Serial number is stx:1090:28 then the ppm used by Stratux is +28. If the appropriate ppm for the SDR is unknown, here are the steps to find out (again it is useful to have only one SDR plugged in to avoid confusion):

stxstop (in case Stratux is already running)

kal -s GSM900 and note donw the channel number with the highest power (e.g. 4)

kal -b GSM900 -c 4 and note down the average absolute error (e.g. 16.325 ppm)

Once you have found the appropriate ppm (e.g. +16 as in the example above), the SDR Serial number needs to be programmed once again:

rtl_eeprom -s stx:868:16
reboot

For more information on how to use kal please visit https://github.com/steve-m/kalibrate-rtl/blob/master/README.md