About

Collection of High Altitude Balloon projects for Zinoo science center:

• zinoo-liepaja: Custom built ATMega328p based payload tracker firmware.
• zinoo-lora: LoRa-based payload tracker firmware. It uses Arduino Uno + Dragino LoRa/GPS shield.
• zinoo-lora-ground: LoRa-based ground station firmware. It uses Arduino Uno + Dragino LoRa/GPS shield.

Getting Started

If you cloned this repository, please make sure to update all the dependencies by executing

git submodule init
git submodule update

Please install PlatformIO to build the firmware (see Installation guide), e.g. by executing

sudo -H pip install -U platformio

To use the telemetry upload script, the pyserial library is required. You can install it by executing

sudo -H pip install -U pyserial

Note that you might want to skip the sudo -H in front of these commands, depending on your setup.

sudo pip install -r requirements.txt

Building and uploading

To build zinoo-lora and zinoo-lora-ground, change directory to the corresponding project and execute

pio run

The zinoo-lora project builds several variants of the firmware (see the project definition file zinoo-lora/platformio.ini). To upload the code to an Arduino board, connect it and execute

pio run -t upload -e <variant>

Where <variant> is currently one of uno_z71, uno_z72, uno_z73 or uno_z74. Variants are defined in the project definition file.

To upload the zinoo-lora-ground project, you can simply execute

pio run -t upload

Upload to habhub

The script habhub-upload.py can be used to monitor, log, and upload received telemetry to the habhub platform. To do that, you need to specify the receiver callsign and the serial port device of the connected Arduino board, e.g.

python habhub-upload.py GROUND-1 /dev/ttyUSB0

The script will echo all strings received from the serial port, as well as automatically attempt to upload strings beginning with $$. All displayed information is also logged into a timestamped logfile, which is created in the current working directory.