README.md

   1 # u360gts (amv-open360tracker 32bits)
   2
   3 This is the 32 bits version of the "continuous 360 degree rotating antenna tracker system" for FPV. This project has been developed and maintained by users of the [FPV spanish community](http://www.aeromodelismovirtual.com/showthread.php?t=34530).
   4
   5 Please, we encourage you to read all the documentation before using this firmware in your devices, otherwhise they could be dammaged. In the wiki you'll find detailled information about how to install and configure it with success.
   6
   7 ## Hardware platform
   8
   9 This firmware has been developed for controllers based on STM32F series microprocessors, which fit the technical specifications of the popular NAZE32 flight controller. By now, it has been tested on the **Flip32** flight controller which incorporates the magnetometer, but it could work on other NAZE32 based boards like with external magnetometer.
  10
  11 # Features
  12
  13 * 360 degree continous rotation.
  14 * Multiprotocol.
  15 * Automatic protocol eetection.
  16 * Acceps up to 10 Hz of input telemetry frequency.
  17 * Protocol conversion and fordwarding.
  18 * Fully and easy configurable with [u360gts-configurator](https://github.com/raul-ortega/u360gts-configurator) (cross platform) and serial console (CLI mode).
  19 * Tilt easing.
  20 * Automatic home position (with local GPS).
  21 * Detailled status data on OLED display.
  22 * Battery monitoring.
  23 * RSSI signal strength on OLED display.
  24 * Setup menu on OLED display.
  25 * Acurate PID control system.
  26 * Position estimation system.
  27 * Sound alarms through out a buzzer.
  28 * 4 Serial ports, with dynamic assignment.
  29
  30
  31 **360 DEGREE CONTINOUS ROTATION**
  32
  33 With this firmware you can move your antenna continually in a range of 360 degrees, without the need of moving back. Using an slipring and 360 degree servos, or normal servos modified to be able of doing it, the firware will give the orders for reaching the target in an acurate and fast way.
  34
  35 **MULTIPROTOCOL AND AUTOMATIC PROTOCOL DETECTION**
  36
  37 This firmware provides an **all in one antenna tracker controller system**, it is able to work with several telemetry protocols. You can configure your antenna tracker to detect automátically the telemetry protocol that your aircraft is streaming (if you configured the appropieated baud rate, otherwhise you have to select the apropiated baud rate in the setup menu on the OLED display once you are at the flying field). Now you have one antenna tracker system for all your aircrafts!
  38
  39 These are the protocols that are supported (and automatically detected):
  40
  41 - **MFD**
  42 - **GPS TELEMETRY (DIRECT NMEA from GPS)**
  43 - **MAVLINK**
  44 - **RVOSD**
  45 - **FRSKY D**
  46 - **FRSKY X (Smartport)**
  47 - **LTM (Light Telemetry)**
  48 - **PITLAB**
  49
  50 **INPUT TELEMETRY AT HIGH FREQUENCY**
  51
  52 This antenna tracker system is capable of reading input telemetry packets sended from the aircraft at a frequency up to 10 times per seconds.
  53
  54 **PROTOCOL CONVERSION AND FORWARDING**
  55
  56 With this firmware, you have the possibility to convert the input telemetry datato differents protocols formats, and fordward the frames to externals devices.
  57
  58 - **MAVLINK**
  59 - **MFD**
  60 - **NMEA**
  61
  62 Examples:
  63
  64 * Your aircrafat sends GPS direct telemetry frames to the antenna tracker, and it converts and send mavlink packets to Mission Planner or Droidplanner app.
  65 * Your aircrafat sends GPS direct telemetry frames to the antenna tracker, and it converts and send NMEA GPGGA and GPRMC frames to Oruxmaps app.
  66 * The received telemetry data is converted to MFD protocol to manage an MFD antenna tracker.
  67
  68 **CROSS PLATFORM CONFIGURATOR**
  69
  70 Yo can configure and interact with the antenna tracker through the [u360gts-configurator](https://github.com/raul-ortega/u360gts-configurator), a cross platform  app which will facilitate setting parameters, control operations, and test its behavior by simulation.
  71
  72 **COMMAND LINE INTERFACE**
  73
  74 Yo also can configure and interact with the antenna tracker through a Command Line Interface (CLI) from any serial console, as well as for example some app over Bluetooth.
  75
  76 **TILT EASING**
  77
  78 The tilt  movement has been improved by adding easing effects at the beginning and smoothing at the end. This will avoid damaging the tilt servo and other mechanisms when using heavy and larger antennas. This feature doesn't affect the accuracy and speed in the movements of the pan servo.
  79
  80 **AUTOMATIC HOME POSITION**
  81
  82 You can connect a NMEA or UBLOX GPS device to the controller to automatically set the home position before starting the tracking. Nonetheless, the user has full control and can reject the home position to get a more accurate one.
  83
  84 **OLED DISPLAY**
  85
  86 Telemetry data, local gps status, battery monitoring and other usefull information, are displayed on an OLED display.
  87
  88 Now you can select the ingoing telemetry protocol,baud rate, enable/disable features, and other parameter settings through the setup menu on the OLED display.
  89
  90 **RSSI SIGNAL STRENGTH ON DISPLAY**
  91
  92 The rssi signal can be provided from video or control receiver. The percentage of signal strength is shown on the display with a higer level of detail when the value is lower than a prefixed value by the user.
  93
  94 **POSITION ESTIMATION SYSTEM**
  95
  96 It implements a position estimation system which provides 3 estimation modes. It is very useful in case of telemetry at low frecuency.
  97
  98 **4 SERIAL PORTS**
  99
 100 These STM32 microprocessor series based boards incorporate 2 UARTS (serial ports 0 and 1). This firmware provides the way to activate 2 extra virtual ports (softserial) which can be used for different purposes. They can be assigned dynamically for the different functions the antenna tracker can perform.
 101
 102 [See more information about this project](http://www.u360gts.com/)
 103
 104 # u360gts Firmware Releases
 105
 106 [https://github.com/raul-ortega/u360gts/releases](https://github.com/raul-ortega/u360gts/releases)