tsOS-vhf is an open-source software for reliable VHF radio tracking of (small) animals in their wildlife habitat.tsOS-vhf is an operating system distribution for trackIT stations that receive signals emitted by VHF tags mounted on animals and are built from low-cost commodity-off-the-shelf hardware.tsOS-vhf provides software components for VHF signal processing, system monitoring, configuration management, and user access. In particular, it records, stores, analyzes, and transmits detected VHF signals and their descriptive features, e.g., to calculate bearings of signals emitted by VHF radio tags mounted on animals or to perform animal activity classification.
The image of tsOS-vhf can be downloaded in the GitHub Releases section of this repository.
The base tsOS-vhf build consists of two stages. First, a base image is built, which installs all required software and might take some time to be build, see https://github.com/trackIT-Systems/tsOS-base. Secondly the custom software components and configuration files are copied and installed and tsOS-vhf.img is built.
$ docker-compose run --rm pimod pimod.sh tsOS-vhf.Pifile
### FROM https://github.com/trackIT-Systems/tsOS-base/releases/download/2024.07.2/tsOS-base-arm64-2024.07.2.zip
Fetching remote: https://github.com/trackIT-Systems/tsOS-base/releases/download/2024.07.2/tsOS-base-arm64-2024.07.2.zip
...As of September 2024, two versions of tsOS-vhf exist, build for armhf and arm64. The reasoning behind that is, that some camera software requires 32-bit libraries, which in turn have been required by BatRack.
tsOS-vhf.Pifile is using arm64 as their primary target. However there exist -armhf versions which create their 32-bit counterparts.
The system can be configured through different files in the /boot partition.
cmdline.txt holds the kernel boot commandline, which allows to configure the hostname in newer systemd versions. This behavioud is emulated and a hostname can be configured by setting systemd.hostname=trackIT-00001
Hold the configuration of pyradiotracking, see example config.
Mqttutil reports system statistics via MQTT, see example config.
A wireguard configuration can be set using this configuration file.
Files in this directory are loaded by mosquitto. E.g. mqtt brokers for reporting can be set using files in this folder.
If you are using tsOS-vhf in academia, we'd appreciate if you cited our scientific research paper. Please cite as "Höchst & Gottwald et al."
J. Höchst, J. Gottwald, P. Lampe, J. Zobel, T. Nauss, R. Steinmetz, and B. Freisleben, “trackIT OS: Open-source Software for Reliable VHF Wildlife Tracking,” in 51. Jahrestagung der Gesellschaft für Informatik, Digitale Kulturen, INFORMATIK 2021, Berlin, Germany, 2021.
@inproceedings{hoechst2021trackIT,
title = {{trackIT OS: Open-source Software for Reliable VHF Wildlife Tracking}},
author = {Höchst, Jonas and Gottwald, Jannis and Lampe, Patrick and Zobel, Julian and Nauss, Thomas and Steinmetz, Ralf and Freisleben, Bernd},
booktitle = {51. Jahrestagung der Gesellschaft f{\"{u}}r Informatik, Digitale Kulturen, {INFORMATIK} 2021, Berlin, Germany},
series = {{LNI}},
publisher = {{GI}},
month = sep,
year = {2021}
}