Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
laemmy authored Jan 12, 2018
1 parent e851694 commit 7b5dbbc
Showing 1 changed file with 29 additions and 7 deletions.
36 changes: 29 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ This project was started because I need a simple way to check the range of the L

The igate.py receive data over the air from a serial attached data modem. This script is forwarding received APRS-Packets to APRS-IS (http://www.aprs-is.net/) and print receive to stdout.

# Hardware Requierements

* 2 Computers with Linux and Python 3 (Raspberry Pi zero work great)
* 2 LoRa Data Radio Modems (tested with DRF1278DM from Dorji)
* at least one UART to USB Adapter
* if you use desktop and laptop and no Raspberry Pi you need three UART to USB adapters

You need at least two serial data modems like the Dorji DRF1278DM and two computers. For running tracker.py you need also a GPS module.

# Quickstart
Expand All @@ -14,19 +21,34 @@ Clone repository and copy configuration template.

git clone https://github.com/laemmy/APRS-via-LoRa-Gateway.git
cp config-template.txt config.txt

Edit **config.txt** and enter your Callsign, APRS-IS passcode and serial interface.

This script is written for Python 3 and using **aprslib**. Please install this library with the following command.
Install **aprslib** on both computers.

pip3 install aprslib

To start just enter

./igate.py
Edit **config.txt** on your Igate-Computer and enter your Callsign, APRS-IS passcode and serial interface in section [IGATE].
Then edit **config.txt** on your Tracker-Computer and enter your Callsign, APRS-IS passcode and serial interface section [TRACKER].

The **igate.py** print all recieved packets to **stdout** and forward them to the APRS-IS. At the moment there is no daemon mode. Please use **screen** to run it in background.
Execute **igate.py** on your Igate-Computer to start it.

./igate.py

To quit just press **CONTROL+C**

## Setup APRS Tracker

Setup the tracking Raspberry Pi is more complex. **tracker.py** is grabbing the data from gpsd. For running gpsd you need a GPS module which is connected to your computer. Please follow this guide for setting up GPS module on Raspberry Pi

https://learn.adafruit.com/adafruit-ultimate-gps-hat-for-raspberry-pi/use-gpsd

If you have everything setup correctly please use **cgps -s** to check gps location. Everything fine? The just start **tracking.py** and move around to do range testing of your LoRa-Modems










0 comments on commit 7b5dbbc

Please sign in to comment.