SailTrack Ground is the ground station of the SailTrack system, it receives, stores and visualizes real-time data coming from the boat via a radio link. To learn more about the SailTrack project, please visit the project repository.
The SailTrack Ground module is based on a battery powered Raspberry Pi SBC running a custom version of the Raspberry Pi OS, namely, DietPi. For a more detailed hardware description of the module, please refer to the Bill Of Materials.
The module performs the following tasks:
- It receives data coming from the boat using LoRa.
- It creates the SailTrack Ground Network, the WiFi network to which connect in order to view the live dashboards.
- It runs the InfluxDB database, gathering all the measurements coming from the boat.
- It runs the Grafana server, for the visualization of real-time and logged metrics.
Follow the instructions below to get the SailTrack Ground OS correctly installed. If you encounter any problem, please open an issue.
- Download and extract the latest SailTrack Ground OS image.
- Insert the Raspberry Pi microSD card into the computer.
- Flash the downloaded
.imgfile into the SD card using a flashing tool such as balenaEtcher. - (OPTIONAL) Change the passwords from the default ones by modifying the
AUTO_SETUP_GLOBAL_PASSWORDand theSOFTWARE_WIFI_HOTSPOT_KEYin thedietpi.txtfile located inside the SD card. - Eject the SD card from the computer and insert it into the Raspberry Pi.
- Connect the Raspberry Pi to internet with an ethernet cable.
- Power on the Raspberry Pi. The first run setup will automatically start to download and configure the required packages. Note: this might take a few minutes, depending on the internet connection quality, follow the next step to check the installation progress.
- (OPTIONAL) Check the installation progress:
- Connect to the Raspberry Pi using a device connected to the same network:
The
ssh root@<raspberry-ip-address><raspberry-ip-address>can be found by checking the router administration dashboard or by using a tool such as Angry IP Scanner. The password is the default one (dietpi) or the one set in Step 4. - Dismiss the
DietPi first run setup is currently running on another screenmessage by hitting Ctrl + C. - Check the logs coming from the installation progress with the following command:
tail -f /var/tmp/dietpi/logs/dietpi-firstrun-setup.log
- Connect to the Raspberry Pi using a device connected to the same network:
- Wait until the
SailTrack-GroundNetWiFi network is visible, meaning that the installation process has been successfully completed.
Once the installation process has been successfully completed, you can use SailTrack Ground by following the steps below.
- Power on the module by pressing the power push button. Once the module is powered up, it will automatically start to receive measurments from the boat.
- Connect to the
SailTrack-GroundNetWiFi network with your pc, smartphone, tablet,... (password:sailtracknetor the one set in Step 4 of the installation). - Visit http://192.168.42.1:3001 (user:
admin, password:dietpior the one set in Step 4 of the installation) to connect to the Grafana dashboards to see real-time data and browse the database. To learn more about using Grafana, visit the official guide. Alternatively, you can plug SailTrack Ground to a monitor with an HDMI cable and the real-time dashboard will automatically be displayed. - To power off the module press and hold the power push button of the Ground module until the power light starts blinking.
Contributors are welcome. If you are a student of the University of Padova, please apply for the Metis Sailing Team in the website, specifying in the appliaction form that you are interested in contributing to the SailTrack Project. If you are not a student of the University of Padova, feel free to open Pull Requests and Issues to contribute to the project.
To learn more about contributing to this repository, check out the Developer's Guide.
Copyright © 2023, Metis Sailing Team. SailTrack Ground is available under the GPL-3.0 license. See the LICENSE file for more info.