Browse Source

update Telemetry.md (#7978)

master
Jonathan Hudson 3 years ago
committed by GitHub
parent
commit
b4d23ea68c
No known key found for this signature in database GPG Key ID: 4AEE18F83AFDEB23
  1. 39
      docs/Telemetry.md

39
docs/Telemetry.md

@ -10,10 +10,9 @@ Telemetry is enabled using the 'TELEMETRY' feature.
feature TELEMETRY
```
Multiple telemetry providers are currently supported, FrSky, Graupner
HoTT V4, SmartPort (S.Port) and LightTelemetry (LTM)
Multiple telemetry providers are currently supported, FrSky, Graupner HoTT V4, SmartPort (S.Port), LightTelemetry (LTM). MAVLink, IBUS, Crossfire and GSM SMS.
All telemetry systems use serial ports, configure serial ports to use the telemetry system required.
All telemetry systems use serial ports, configure serial ports to use the telemetry system required. Multiple telemetry streams may be enabled, but only one of each type, e.g. Smartport + LTM or MAVLink + CRSF.
## SmartPort (S.Port) telemetry
@ -204,50 +203,38 @@ Note: The SoftSerial ports may not be 5V tolerant on your board. Verify if you
## LightTelemetry (LTM)
LTM is a lightweight streaming telemetry protocol supported by a
number of OSDs, ground stations and antenna trackers.
LTM is a lightweight streaming telemetry protocol supported by a number of OSDs, ground stations and antenna trackers.
The INAV implementation of LTM implements the following frames:
* G-FRAME: GPS information (lat, long, ground speed, altitude, sat
info)
* G-FRAME: GPS information (lat, long, ground speed, altitude, sat info)
* A-FRAME: Attitude (pitch, roll, heading)
* S-FRAME: Status (voltage, current+, RSSI, airspeed+, status). Item
suffixed '+' not implemented in INAV.
* S-FRAME: Status (voltage, current+, RSSI, airspeed+, status). Item suffixed '+' not implemented in INAV.
* O-FRAME: Origin (home position, lat, long, altitude, fix)
In addition, in iNav:
* N-FRAME: Navigation information (GPS mode, Nav mode, Nav action,
Waypoint number, Nav Error, Nav Flags).
* N-FRAME: Navigation information (GPS mode, Nav mode, Nav action, Waypoint number, Nav Error, Nav Flags).
* X-FRAME: Extra information. Currently HDOP is reported.
LTM is transmit only, and can work at any supported baud rate. It is
designed to operate over 2400 baud (9600 in INAV) and does not
benefit from higher rates. It is thus usable on soft serial.
LTM is transmit only, and can work at any supported baud rate. It is designed to operate over 2400 baud (9600 in INAV) and does not benefit from higher rates. It is thus usable on soft serial.
A CLI variable `ltm_update_rate` may be used to configure the update
rate and hence band-width used by LTM, with the following enumerations:
A CLI variable `ltm_update_rate` may be used to configure the update rate and hence band-width used by LTM, with the following enumerations:
* NORMAL: Legacy rate, currently 303 bytes/second (requires 4800 bps)
* MEDIUM: 164 bytes/second (requires 2400 bps)
* SLOW: 105 bytes/second (requires 1200 bps)
For many telemetry devices, there is direction correlation between the
air-speed of the radio link and range; thus a lower value may
facilitate longer range links.
For many telemetry devices, there is direction correlation between the air-speed of the radio link and range; thus a lower value may facilitate longer range links.
More information about the fields, encoding and enumerations may be
found at https://github.com/iNavFlight/inav/wiki/Lightweight-Telemetry-(LTM).
More information about the fields, encoding and enumerations may be found [on the wiki](https://github.com/iNavFlight/inav/wiki/Lightweight-Telemetry-(LTM)).
## MAVLink telemetry
MAVLink is a very lightweight, header-only message marshalling library for micro air vehicles.
INAV supports MAVLink for compatibility with ground stations, OSDs and antenna trackers built
for PX4, PIXHAWK, APM and Parrot AR.Drone platforms.
MAVLink is a lightweight header-only message marshalling library for micro air vehicles. INAV supports MAVLink for compatibility with ground stations, OSDs and antenna trackers built for PX4, PIXHAWK, APM and Parrot AR.Drone platforms.
MAVLink implementation in INAV is transmit-only and usable on low baud rates and can be used over soft serial.
MAVLink implementation in INAV is transmit-only and usable on low baud rates and can be used over soft serial (requires 19200 baud). MAVLink V1 and V2 are supported.
## Cellular telemetry via text messages
@ -375,7 +362,7 @@ sensor 10 is of type GALT,
sensor 12 is of type GPS_LON,
sensor 13 is of type GPS_LAT,
sensor 14 is of type ACC_X,
sensor 15 is of type ACC_Y,
sensor 15 is of type ACC_Y,
sensor 16 is of type SPEED.
4.This same as 3, but support 4 byte sensors. (fix_updater_03_16_21_33_1 from https://github.com/qba667/FlySkyI6/tree/master/release):

Loading…
Cancel
Save