From 7b5dbbc8c60e3cbc66da60935707114ba7ce30dd Mon Sep 17 00:00:00 2001 From: laemmy Date: Fri, 12 Jan 2018 13:40:56 +0100 Subject: [PATCH] Update README.md --- README.md | 36 +++++++++++++++++++++++++++++------- 1 file changed, 29 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 3b0a74b..22cf8de 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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 + + + + + + + +