TeamPracticalProjects · BobGlicksman · Jul 25, 2025 · Jul 25, 2025 · Jul 25, 2025 · Jul 25, 2025
diff --git a/Documents/LoRa_AT_Command_RYLR998_RYLR498_EN.pdf b/Documents/LoRa_AT_Command_RYLR998_RYLR498_EN.pdf
diff --git a/Documents/Low_Power_LoRa_Sensor_User_Manual.pdf b/Documents/Low_Power_LoRa_Sensor_User_Manual.pdf
diff --git a/Documents/Photon_2_Hub_and_Sensor_User_Manual.pdf b/Documents/Photon_2_Hub_and_Sensor_User_Manual.pdf
diff --git a/Documents/RYLR998_EN.pdf b/Documents/RYLR998_EN.pdf
diff --git a/LoRa_Experiments_Overview_Document.pdf b/LoRa_Experiments_Overview_Document.pdf
diff --git a/README.md b/README.md
@@ -1,59 +1,30 @@
 # LoRa_experiments
-## Tests of LoRA module (RYLR998) ranging and low power.
 
+This repository contains the results of a series of experiments that were performed using the Reyax RYLR998 LoRa module.
 The Reyax RYLR998 is an inexpensive LoRa "modem".  It can perform point to point wireless data communication with other such modules.
-
 The RYLR998 contains both a LoRa chip and a low power microcontroller.  A host microcontroller communicates with an RLYR998 using
 serial port "AT" commands, making the RYLR998 very easy to use.  In addition, the RYLR998 has a low power sleep mode that reduces current
 draw to about 10 microamps.  The use of LoRa for long distance, low volume data communication along with the ability to sleep the module
 when not transmitting suggests that these modules could be ideal for use as long range contact open/close sensors.
 
-The purpose of the tests documented in this repository is to explore the RYLR998 module capabilities in two respects:
-
-- Long range operation:  the ability of the module to successfully commmunicate from an outdoor location some distance from a house
-into a receiver located inside of the house.
-
-- Low power operation:  the ability of the module to be powered down when not needed to transmit a short message, in support
-of battery powered operation.
-
-
-There are two main folders in this repository:
-
-- Range_Testing: this folder contains a report and source code for range testing experiments.
-
-- Low_Power_Testing: this folder contains a report and source code for testing low power operation of the module. It also contains
-a spreadsheet to calculate battery life, based upon using an Attiny85 as the host microcontroller with a reset pulse generator circuit 
-to power it up for transmitting a short message and then powering the LoRa module down and then powering itself down until the next reset.
-
-## LoRa set up ##
-- LoRa AT command guide https://lemosint.com/wp-content/uploads/2021/11/Lora_AT_Command_RYLR998_RYLR498_EN.pdf
-- LoRa module we use https://reyax.com/products/RYLR498
+Our test results were very positive, leading to the development of deployable hardware and software.  This repository contains detailed information
+about a complete system, consisting of:
 
-Note that for these tests you need to program each LoRa module by hand using a terminal emulator and an FTDI module. Connect four
-pins from the FTDI to the LoRa module (leave the reset pin on the LoRa module unconnected):
+1. Low power, battery operated LoRa contact sensors.
 
-```
-FTDI       LoRa
-3v3        VDD
-TXD        RXD
-RXD        TXD
-GND        GND
-```
+2. Non-low power version of the LoRa sensors that are suitable for gathering and logging detailed range testing data.
 
-Plug the FTDI device into your laptop.
+3. An Internet connected Hub that communicates with the LoRa sensors.
 
-You can use the Arduino IDE Serial Monitor. With the IDE running go to Tools / Port and select the port of your FTDI device (it might be 
-something like `/dev/serial-1`). Then click the Serial Monitor button on the upper right of the Arduino IDE. This brings up a new window.
-In the bottom menu select "Both NL & CR" and "115200 baud". In the command window at the top type AT and click Send. You should get the 
-response +OK
+4. Other components that create a complete, integrated LoRa-based sensor system.
 
-Assuming you are now connected correctly to your LoRa module, perform the following commands:
-```
-AT+ADDRESS=0
-AT+NETWORKID=3
-```
-Do the same for your second LoRa module.
+This repository also memorializes earlier protoype hardware and software that was used in the incremental testing and development of the deployable
+hardware and software.
 
-  
+A complete overview of the project and of this repository is contained in the document:
 
+"LoRa_Experiments_Overview_Document".
 
+Note that this repository is not a complete project in and of itself.  However, it contains open-source details of the hardware and
+software that are used in subsequent, deployed projects.  These latter projects are documented in their own repositories that reference
+the designs documented herein.
diff --git a/Terms_of_Use_License_and_Disclaimer.pdf b/Terms_of_Use_License_and_Disclaimer.pdf