tracker only functions and settings

Author: stronnag

LTM/crsf.lua

@@ -1,3 +1,18 @@
+--[[
+-- inav FrSky / CRSF Telemetry to LTM
+-- Designed for the Radiomaster TX16S UART set to 'LUA' and invoked via
+-- either a Global or Special Function
+--
+-- LTM can be used in INAV compatible ground stations such as mwp, ezgui or
+--  mission planner for inav, as well as antenna trackers e.g u360gts
+--
+-- Licence : GPL 3 or later
+--
+-- (c) Jonathan Hudson 2020
+-- https://github.com/stronnag/LTM-lua/
+--
+]]--
+
 local D,getTelemetryId = ...
 local C={}
 

README.md

@@ -14,24 +14,31 @@ Typical use case:
 ## Installation and Usage
 
 * Copy the script `ltm.lua` to the `SCRIPTS/FUNCTIONS' directory
-* Create a directory, `SCRIPTS/FUNCTIONS/LTM`; copy the file LTM/crsf.lua to that directory, such that the following directory structure is maintained; in particular `crsf.lua` is the `LTM` sub-directory:
+* Create a directory, `SCRIPTS/FUNCTIONS/LTM`; copy the files `LTM/crsf.lua` and `LTM/config.lua` to that directory, such that the following directory structure is maintained.
 ```
     ├── SCRIPTS
     │   ├── FUNCTIONS
     │   │   ├── ltm.lua
     │   │   ├── LTM
     │   │   │   ├── crsf.lua
+    │   │   │   ├── config.lua
 ```
 * Enable the script as a Global Function or model specific Special Function.
 
-Note that any Zip files in the release area will maintain this structure.
+Note that any Zip files in the release area will profile this directory structure.
 
 The script may be invoked either on an external stimulus e.g. `Telemetry` or on a switch. See the OpenTX / TX vendor documentation for details on configuring your radio.
 
 Note that the UARTs on the TX16S default to 115200 bps, so set BT devices accordingly.
 
 Note also that in OTX 2.3.9, a bug causes no power to be supplied to the TX16S UARTS; this is fixed in the 2.3.10 nightlies.
 
+## Configuration
+
+There are a few user editable settings in the file `LTM/config.lua`; currently the user must edit this file directly as no radio UI is provdied.
+
+In particular, the `onlyTracker` setting may be used to provide only GPS data for antenna trackers. See the comments in  `LTM/config.lua` for details.
+
 ## Audio
 
 The `audio` directory contains two synthesised voice files, `ltmon.wav` and `ltmoff.wav` that may be placed in `SOUNDS/en` and used to provide audible indications (via Special Functions) that LTM forwarding is enabled / disabled.

ltm.lua

@@ -4,19 +4,23 @@
 -- either a Global or Special Function
 --
 -- LTM can be used in INAV compatible ground stations such as mwp, ezgui or
---  mission planner for inav
+--  mission planner for inav, as well as antenna trackers e.g u360gts
 --
 -- Licence : GPL 3 or later
 --
 -- (c) Jonathan Hudson 2020
+-- https://github.com/stronnag/LTM-lua/
+--
 ]]--
 
+-- User editable settings -- see LTM/config.lua
+local S = {}
+-- Common data
 local D = {}
+-- CRSF specific data and functions
 local C = {}
-local lastt = 0
 
--- Debugging
-local LOGGER = false
+local lastt = 0
 
 local function openlog()
    local dt = getDateTime()
@@ -41,7 +45,7 @@ local function dolog(str)
 end
 
 local function mlog(ltm)
-   if LOGGER then
+   if S.LOGGER then
       D.fh = D.fh or openlog()
       io.write(D.fh, ltm)
    end
@@ -189,7 +193,7 @@ local function send_gframe()
 	 end
       end
    end
-   dolog(string.format("GFrame: Lat %.6f Lon %.6f Alt %.2f Spd %.1f fix %d sats %d hdop %d",		       D.lat, D.lon, D.alt, D.gspd, D.nfix, D.nsats, D.hdop))
+   dolog(string.format("\nGFrame: Lat %.6f Lon %.6f Alt %.2f Spd %.1f fix %d sats %d hdop %d",		       D.lat, D.lon, D.alt, D.gspd, D.nfix, D.nsats, D.hdop))
    ltm_gframe()
 end
 
@@ -280,7 +284,7 @@ local function send_aframe()
 	 D.roll = (270 - data.roll * 0.1) % 180
       end
    end
-   dolog(string.format("AFrame: pitch %d roll %d heading %d", D.pitch, D.roll, D.hdg))
+   dolog(string.format("\nAFrame: pitch %d roll %d heading %d", D.pitch, D.roll, D.hdg))
    ltm_aframe()
 end
 
@@ -341,6 +345,9 @@ local function init()
    if string.sub(r, -4) == "simu" then
       D.sim = true
    end
+
+   S = loadScript("/SCRIPTS/FUNCTIONS/LTM/config.lua")()
+   dolog("Tracker only " .. string.format("%s",S.onlyTracker))
    -- Testing Crossfire
    -- if D.sim then D.fm_id = 1 end
 
@@ -363,13 +370,13 @@ local function init()
       end
       dolog("Using Smartport")
    end
-   dolog("vid".." "..D.volt_id)
-   dolog("sat".." "..D.sat_id)
-   dolog("mode".." "..D.mode_id)
-   dolog("alt".." "..D.alt_id)
-   dolog("gps".." "..D.gps_id)
-   dolog("hdr".." "..D.hdg_id)
-   dolog("curr".." "..D.curr_id)
+   dolog("vid  "..D.volt_id)
+   dolog("sat  "..D.sat_id)
+   dolog("mode "..D.mode_id)
+   dolog("alt "..D.alt_id)
+   dolog("gps "..D.gps_id)
+   dolog("hdr "..D.hdg_id)
+   dolog("curr "..D.curr_id)
 end
 
 -- Main
@@ -383,17 +390,25 @@ local function run(event)
 	    rssi, r0, r1 = getRSSI()
 	 if rssi ~= nil then
 	    D.rssi = rssi
-	    send_aframe()
-	    if (D.mcount % 2) == 0 then
-	       send_gframe()
+	    if S.onlyTracker then
+	       if (D.mcount % 2) == 0 then
+		  send_gframe()
+	       else
+		  send_aframe()
+	       end
 	    else
-	       send_sframe()
-	       if D.mcount == 1 then
-		  send_oframe()
-	       elseif D.mcount == 5 then
-		  send_xframe()
+	       send_aframe()
+	       if (D.mcount % 2) == 0 then
+		  send_gframe()
 	       else
-		  send_nframe()
+		  send_sframe()
+		  if D.mcount == 1 then
+		     send_oframe()
+		  elseif D.mcount == 5 then
+		     send_xframe()
+		  else
+		     send_nframe() -- noop for now
+		  end
 	       end
 	    end
 	    D.mcount = (D.mcount + 1) % 10