--  Telemtry script: RES Training App
--  #################################
--
--  version 9   30.07.2021
--  by ChrisOHara
--  OpenTX version 2.3.7
--  for Horus and Taranis radios (but may run on other openTX radios)
--  This Software is free
--
--  Information: Using a barometer this software is not allowed in official RES competion.
--
--  Requirements: Telemetry value "Alt" (so a barometer is required)
--                Momentary switch "sf" and "sg"
--                   (switches can be changed by altering software definitions, switchname_one and switchname_two)
-- 
--
--  Reaching 5m (starting height) you will hear a beep (1000 Hz).
--  During the following 10 seconds you can start the timer by operating momentary switch "sf" or "sg"
--     when plane is released from leash.
--  If you do not operate a switch  the  timer will start after 10 seconds on its own.
--  When timer starts you can hear a beep (2000Hz).
--
--  reaching landing height (2m) there is another beep (1000Hz).
--  During the next 10 seconds you can stop the timer by operating momentary switch "sf" or "sg"
--     when having contact with ground.
--  If you do not operate a switch the timer timer will stop after 10 seconds on its own.
--  When timer stops you can hear a beep (2000Hz).
--
--  Hint: If you do not use a swich  you will get the flighttime between 
--        5m (starting altidude) and 2m (landing altidude).
--
--  The script does use/define timer 1 on its own. (6 minutes, countdown)
--
--  There will be displayed the last flights. 
--      Horus: max is 2,6,8,19 depending on screen zone you select for widget
--      Taranis: max is 8
--
--  Information displayed:
--      Flight     =    number of flight (the newest flight is always number 0)
--      Time       =    Flighttime in seconds
--      Alt-S      =    starting altidude
--      Alt-F      =    maxmal altidude (during flight from start timer to stop timer)
--
--  Installation:
--      Horus: Copy /WIDGETS/res_H/main.lua and /SCRIPTS/TELEMETRY/res_H.lua   to the sd_card of your Horus.
--             Add the widget res_H to your telemetry screen.
--      Taranis: Copy /SCRIPTS/TELEMETRY/res_T.lua   to the sd_card of your Taranis.
--               Add the script res_T to your telemetry screen.
--
--  Errors: Scripts aborts when function getValue() is called with nil.
--  reason: Telemetry value "Alt" is not available or
--          one or both switches "sf" or "sg" are not available.(change script, define other switches
--          in "switchname_one" and/or "switchname_two")
--
-- 
--  Telemetry Script:  Trainingsprogramm für RES Flieger
--  ####################################################
--
--  version 9   30.07.2021
--  von ChrisOHara
--  OpenTX version 2.3.7
--  für Horus and Taranis radios (läuft aber eventuell auch auf anderen openTX Radios)
--  diese Software ist frei
--
--  Hinweis: Da ein Barometer verwendet wird, ist die Software nicht in einem RES Wettbewerb erlaubt.
--
--  Voraussetzungen:
--           Benötigt wird der Telemetriewert "alt"  (Höhe/Barometer).
--           Momentary Schalter "sf" oder "sg"
--             (kann im script verändert werden über switchname_one und switchname_two)
--  
--  Bei 5m (Starthöhe) ertönt ein Beep (1000 Hz).
--  Innerhalb der nächsten zehn Sekunden kann man durch Drücken der Tasten "sf" 
--    oder "sg" (beim Ausklinken des Seils) den Timer starten.
--  Drückt man keine Taste, wird der Timer automatisch nach zehn Sekunden gestartet.
--  Wenn der Timer startet, ertönt ein Beep (2000 Hz).
--  
--  Bei 2m (Landehöhe) ertönt wieder ein Beep (1000 Hz).
--  Innerhalb der nächsten zehn Sekunden kann man (bei Bodenberührung) durch Drücken der Tasten "sf" 
--    oder "sg" den Timer stoppen.
--  Drückt man keine Taste, wird der Timer automatisch nach zehn Sekunden gestoppt.
--  Wenn der Timer stopped, ertönt ein Beep (2000 Hz).
--  
--  Hinweis: Verzichtet man auf das Drücken der Tasten erhält man demzufolge die Zeit zwischen 
--           Starthöhe (5m) und Landehöhe (2m).
--  
--  Das Programm verwendet/definiert automatisch den Timer 1. (6 Minuten, countdown)
--
--  Es werden die Daten der letzen Flüge angezeigt. 
--      Horus: maximal 2,6,8,19 abhängig vom gewählen Bildschirmausschnitt für das Widget
--      Taranis: maximal 8
--
--  Installation:
--      Horus: Kopiere /WIDGETS/res_H/main.lua und /SCRIPTS/TELEMETRY/res_H.lua   auf die sd_card deiner Horus.
--             Füge das Widget res_H deinem Telemetry Screen hinzu.
--      Taranis: Kopiere /SCRIPTS/TELEMETRY/res_T.lua   auf die sd_card deiner Taranis.
--               Füge das Script res_H deinem Telemetry Screen hinzu.               
--
--  Angezeigte Infomation:
--	Flight    =    Flugnummer (der jüngste Flug ist immer 0)
--	Time      =    Flugzeit in Sekunden
--      Alt-S     =    Starthöhe (starten des Timers)
--      Alt-F     =    maximale Flughöhe (während des gesamten Fluges zwischen Timer-Start und Timer-Stop)
--
--  Fehler: Das Script bricht ab, wenn die Funktion getValue() mit "nil" aufgerufen wird.
--  Grund:  Der Telemetrie Wert "Alt" ist nicht verfügbar oder
--          einen oder beide Schalter "sf" oder "sg" gibt es nicht.(Script ändern, in "switchname_one"
--          und "switchname_two" andere Schalter eintragen) 
--
--  #######################################################################################################