Updated INAV blackbox variables (markdown)
[inav.wiki.git] / AAT-Automatic-Antenna-Tracker.md
blobb67b3815154b1241b2bb7ba24922f1085269a0be
1 Since release 3.0, INAV directly supports embedded video telemetry data to drive the VirtualPilot Sentinel antenna tracker.
3 This enables the use of directional higher gain antennas to maintain higher quality video in all directions, provide the ability to use lower video transmission power or increase the maximum reception distance over traditional omnidirectional antennas. The AAT provides the benefit of maintaining a more accurate direction over manually mounted antennas without the concern of the aircraft moving outside of the antenna’s dominant reception area. 
5 ***
6 ## Configuring - iNAV 3.0 onwards (embedded support) 
7 * Requires minimum of INAV 3.0 and fonts installed
8 * Enable AAT telemetry in the cli: set osd_telemetry = ON
10 ## Configuring - iNAV earlier versions
11 * Check content at the link here: [INAV AAT for earlier versions](https://github.com/aat-sentinel/Documentation/blob/main/Sentinel%20AAT%20lite%20User%20Guide.pdf)
13 ## Testing 
14 As telemetry data is not normally visible, the telemetry data can be viewed on the OSD using a cli command:
15 * Enable AAT telemetry with second test line in the cli: set osd_telemetry = TEST
16 * Remember to change it back when finished: set osd_telemetry = ON (FC restart required)
18 ***
19 ## Description of operation 
20 * iNAV knows its home launch position, current position and altitude
21 * iNAV can calculate the pan and tilt information required by the antenna tracker
22 * The data is sent using video telemetry over an analogue signal
23 * The video telemetry is sent on OSD row 0 with only pixel line 0 used
24 * 30 bits of information are sent in each video frame which includes tilt angle, pan angle and error validation check
25 * Two font characters are used to represent a binary 0 or 1
27 Positives of using this telemetry method:
28 * Simple and reliable
29 * No hardware modules or extra wiring on aircraft
30 * Supports all RC TX - not limited to TX with telemetry
31 * Does not require unreliable bluetooth / wifi connections to tracker
32 * Not impacted by 2.4G RC /Video 
33 * Ultra-fast position updating – up to 30 hz
34 * Low size packet means higher tracking success rate in poor signal conditions
36 Negatives of using this telemetry method:
37 * Tracking data may be recorded by some DVR. Not usually visible in goggles / monitor
38 * The first row of OSD display becomes unavailable for OSD. However, this row is not usually fully visible
39 * This does not use tracker GPS location – so cannot be used in a moving vehicle
41 In the visualisation video below, you can see how the telemetry data is sent. This is a test mode as it is not usually visible in FPV goggles / recordings, however notice how the real telemetry line on pixel row zero is not visible.
43 [![Telemetry visualisation capture](https://img.youtube.com/vi/FMLUvc-tX4E/0.jpg)](https://youtu.be/FMLUvc-tX4E?t=20)
45 ***
46 ## Sentinel AAT for use with iNAV 
47 Further information on the Sentinel AAT is available by clicking on the image:
49 [![Sentinel AAT](https://static.rcgroups.net/forums/attachments/2/6/9/6/2/5/a14859253-253-TrackersRCG.png)](https://www.rcgroups.com/forums/showthread.php?3815901-New-product-low-cost-antenna-tracker-for-iNav-Betaflight-Ardupilot-KISS-etc)