From 7de29965059bc77b3617a1f1a0e256d81886216b Mon Sep 17 00:00:00 2001
From: jgromes <jan.gromes@gmail.com>
Date: Fri, 21 Jul 2023 18:35:48 +0200
Subject: [PATCH] [APRS] Added APRS over LoRa example

---
 .../APRS_Position_LoRa/APRS_Position_LoRa.ino | 95 +++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 examples/APRS/APRS_Position_LoRa/APRS_Position_LoRa.ino

diff --git a/examples/APRS/APRS_Position_LoRa/APRS_Position_LoRa.ino b/examples/APRS/APRS_Position_LoRa/APRS_Position_LoRa.ino
new file mode 100644
index 00000000..6b3053a1
--- /dev/null
+++ b/examples/APRS/APRS_Position_LoRa/APRS_Position_LoRa.ino
@@ -0,0 +1,95 @@
+/*
+   RadioLib APRS Position over LoRa Example
+
+   This example sends APRS position reports 
+   using SX1278's LoRa modem.
+
+   Other modules that can be used for APRS:
+    - SX127x/RFM9x
+    - SX126x/LLCC68
+    - SX128x
+
+   For default module settings, see the wiki page
+   https://github.com/jgromes/RadioLib/wiki/Default-configuration
+
+   For full API reference, see the GitHub Pages
+   https://jgromes.github.io/RadioLib/
+*/
+
+// include the library
+#include <RadioLib.h>
+
+// SX1278 has the following connections:
+// NSS pin:   10
+// DIO0 pin:  2
+// RESET pin: 9
+// DIO1 pin:  3
+SX1278 radio = new Module(10, 2, 9, 3);
+
+// or using RadioShield
+// https://github.com/jgromes/RadioShield
+//SX1278 radio = RadioShield.ModuleA;
+
+// create APRS client instance using the LoRa radio
+APRSClient aprs(&radio);
+
+void setup() {
+  Serial.begin(9600);
+
+  // initialize SX1278 with the settings necessary for LoRa iGates
+  Serial.print(F("[SX1278] Initializing ... "));
+  // frequency:                   433.775 MHz
+  // bandwidth:                   125 kHz
+  // spreading factor:            12
+  // coding rate:                 4/5
+  int state = radio.begin(433.775, 125, 12, 5);
+
+  // when using one of the non-LoRa modules for AX.25
+  // (RF69, CC1101, Si4432 etc.), use the basic begin() method
+  // int state = radio.begin();
+
+  if(state == RADIOLIB_ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code "));
+    Serial.println(state);
+    while(true);
+  }
+
+  // initialize APRS client
+  Serial.print(F("[APRS] Initializing ... "));
+  // symbol:                      '>' (car)
+  // callsign                     "N7LEM"
+  // SSID                         1
+  state = aprs.begin('>', "N7LEM", 1);
+  if(state == RADIOLIB_ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code "));
+    Serial.println(state);
+    while(true);
+  }
+}
+
+void loop() {
+  Serial.print(F("[APRS] Sending position ... "));
+  
+  // send a location with message and timestamp
+  // SSID is set to 1, as APRS over LoRa uses WIDE1-1 path by default
+  int state = aprs.sendPosition("GPS", 1, "4911.67N", "01635.96E", "I'm here!", "093045z");
+  delay(500);
+
+  // you can also send Mic-E encoded messages
+  state |= state = aprs.sendMicE(49.1945, 16.6000, 120, 10, RADIOLIB_APRS_MIC_E_TYPE_EN_ROUTE);
+  delay(500);
+
+  if(state == RADIOLIB_ERR_NONE) {
+    Serial.println(F("success!"));
+  } else {
+    Serial.print(F("failed, code "));
+    Serial.println(state);
+  }
+
+  // wait one minute before transmitting again
+  delay(60000);
+}