From 59232887b462f9b28e570b2903be03942424b01e Mon Sep 17 00:00:00 2001
From: loradar <56890699+loradar@users.noreply.github.com>
Date: Thu, 11 Jun 2020 17:24:35 +1000
Subject: [PATCH] Create README.md

---
 Configuration 2 (RAK831)/README.md | 32 ++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 Configuration 2 (RAK831)/README.md

diff --git a/Configuration 2 (RAK831)/README.md b/Configuration 2 (RAK831)/README.md
new file mode 100644
index 0000000..3c3e079
--- /dev/null
+++ b/Configuration 2 (RAK831)/README.md	
@@ -0,0 +1,32 @@
+# _LoRadar_ (Configuration 2)
+
+## Hardware used
+This configuration setup uses the following hardware:
+- **Single board computer:** Raspberry Pi 3
+- **LoRa module:** RAK831, a gateway accessory from RAK wireless suitable for both 915 MHz and 923 MHz ISM frequency bands was used to capture LoRa packets
+- **Antenna:** A 1/2 wave 860-960 MHz antenna with 2 dBi gain attached to the LoRa module
+- **Connection bridge:** Mini PCI-e to USB adaptor to connect between the Raspberry Pi and mTAC-LORA-915A (https://techship.com/products/mpcie-to-usb-adapter-card/)
+- **Storage:** 32 GB microSD card inserted to the Raspberry Pi for data storage
+
+## Software used
+- **libloragw library:** (https://github.com/Lora-net/lora_gateway/tree/master/libloragw) was used for the Raspberry Pi to access the LoRa card and configure radio frequencies
+- **Packet logger:** (https://github.com/Lora-net/lora_gateway/tree/master/util_pkt_logger) This software records all LoRa packets received by the LoRa card and outputs in csv format every hour.
+
+*The Raspberry Pi has been configured to initiate the 'Packet logger software' upon powering on and obtaining the correct time via the Internet (A delay of 5 minutes has been placed).*
+
+## Instructions
+1) Download the Raspberry Pi (RPi) image according to the frequency bandplan of interest:  
+- 915 frequency: https://drive.google.com/file/d/152h2gsr0qCEwhxA85HMopOMlC9T-ab5G/view?usp=sharing
+- 923 frequency: https://drive.google.com/file/d/1C8UnJD_nmafLdlegIELojVEpTFHHc2O4/view?usp=sharing
+2) Flash the image onto an SD card, using _balenaEtcher_ (https://www.balena.io/etcher/)
+3) Insert the SD card into the RPi and power it on, and the data collection should commence in 5 minutes (It is recommended that you connect the RPi to a wired or wireless network so that the correct time can be obtained)
+
+## Information extraction (Requires Internet Connection)
+To extract the information, follow the steps below:
+1) Download the _Ver2\_LoRadar\_Extractor.py_ python script from above and place it in the _Downloads_ folder of the Raspberry Pi
+2) Open a terminal and enter the following commands to install the required libraries:  
+`sudo apt-get install python3-matplotlib --assume-yes`  
+`sudo apt-get install python3-pandas --assume-yes`
+3) Open the python script with _Python 3 (IDLE)_
+4) Run the module (Requires Internet Connection)
+5) Upon successful extraction, a csv file will be created in the same directory as the _Ver2\_LoRadar\_Extractor.py_ python script