RTK GPS Base Station for Raspberry Pi

This application uses a Ublox ZED-F9P RTK GPS receiver to broadcast RTCM correction data to an NTRIP caster (such as RTK2GO or any SNIP service). Designed to run on a Raspberry Pi, it enables high-precision GPS corrections for rover devices.

Features

• NTRIP Server: Streams GPS correction data to an NTRIP caster.
• Web UI: Displays real-time location on a map and receiver status.
• Mode Control: Allows switching between Survey and Fixed modes.
• USB Connection: Uses a recompiled Ublox .NET driver to communicate with the ZED-F9P.

Installation Guide

To automate the setup process, follow these steps:

1. Download the install.sh script from the repository:

   wget https://raw.githubusercontent.com/anking/gps-station/main/install.sh -O install.sh

2. Move the script to the /home/pi directory:

   mv install.sh /home/pi/

3. Grant execution permissions:

   chmod +x /home/pi/install.sh

4. Run the installation script:

   /home/pi/install.sh

This will set up everything automatically for you. But if you prefer to do things manually or automatic install doesnt work follow steps below. You will need to put the correct credentials for the RTK Caster service inside the .env file. A sample file is included.

Pre-requisites

• Raspberry Pi 3 or above
• Install Node/NPM v18 or later

  sudo apt-get update
  curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
  sudo apt-get install -y nodejs
  node -v
  npm -v

• Install GIT (optional, if you want to copy build artifact onto RPi yourself)

  sudo apt update
  sudo apt install git -y
  git --version

Clone Repository

Clone this repo to your Raspberry Pi:

git clone [email protected]:anking/gps-station.git

Compile Driver for Ublox Zed-F9p and copy to gps-station

Pre compiled .net artifacts can be found here Place the artifacts into gps-station/f9p directory (ensure correct architecture 32/64-bit).

Instructions on how to compile yoursel are available in the README of the driver repository: zedf9p-server

Install Dependencies

npm i

Build the Application

npm run build

This will build the app and put artifacts into ./build

Run the Web Service Manually

npm start

The web service will require f9p driver execution permissions to spawn the driver process. Permissions should be assigned automatically, but if needed, set them manually:

chmod 744 ./build/f9p/Zedf9p

After starting, the network HTTP service will be available at:

[YOUR_IP / 192.168.0.11]:3000

---

Running as a System Service

Create a Symbolic Link for the Service

sudo ln -s /home/pi/gps-station/gpsstationweb.service /etc/systemd/system/gpsstationweb.service

Reload System Daemons

sudo systemctl daemon-reload

Enable the Service

sudo systemctl enable gpsstationweb

Manual Control

sudo systemctl start gpsstationweb
sudo systemctl stop gpsstationweb

Check Logs

journalctl -u gpsstationweb

Check Status

sudo systemctl status gpsstationweb

---

Auto-start Browser with Web Server Visible

Edit the autostart file:

sudo nano /etc/xdg/lxsession/LXDE-pi/autostart

Add the following line:

@chromium-browser --kiosk --disable-infobars --disable-session-crashed-bubble --noerrdialogs http://localhost:3000

---

Using Raspberry Pi 3.5" Screen

Refer to the Touchscreen README

---

F9P Device Driver Bypass / Using Str2Str

Alternatively, you can use str2str to transfer the F9P driver data directly to the location service. This service will connect directly to the F9p device(serial port) and merely transfer all the data it spits out to the SNIP caster server. For this, use location-streamer.service. More info is available in str2str/readme_old.txt.