docs/configuration-quick-start-guide.md

   1 ## INITIAL CONFIGURATION
   2
   3 Once you have assembled your antenna tracker you have to do a initial setup in order to get it working. Try to apply these steps in same order to do it with success:
   4
   5 1.- **Enable OLED display** (Features --> Display).
   6
   7 2.- **Configure pan0** value (the stop pulse for pan servo).
   8
   9 You may use up/down arrows until pan servo stops. If it stops within a range, you must caluclate the midpoint: pan0 = ( A + B ) / 2 where A and B are the stop pulses between both extrems.
  10
  11 The above two steps may be performed in a single one by clicking on "Calibrate pan" button. This is also useful in order to set min_pan_speed parameter, which is the increment necesary to reach the limits of the stop pulse range, so the pan servo may start moving.
  12
  13 3.- **Calibrate Compasss** by clicking "Calibrate mag".
  14
  15 The antenna tracker will spin for 10 seconds in the same direction in order to perform the calibration. The direction of rotation depends on the value of calibration pulse parameter. This pulse is the same one used for servo pan calibration.
  16
  17 After configuring pan0 and calibrating the magnetometer, we have to be sure that the corresponding "Calibrated" checkboxes are activated, otherwise the tracker will not move. These checkboxes are useful if we want to test the telemetry but we still do not want to move the servos.
  18
  19 4.- **Configure OFFSET** parameter.
  20
  21 If when giving the command to point north the tracker remains some degrees out of phase, yo must set offset parameter with that value (whithin 0 to 360 degrees). You may adjust it with the up and down arrows as well.
  22
  23 5.- **Configure tilt parameters**, so that the servo tilt remains horizontal (tilt0) and vertical (tilt90).
  24
  25 6.- **Select protocol and baud rate** to which you want the tracker to work.
  26
  27 AUTODETECT feature may be activated in order to detect the protocol automatically. It is very useful if you have several aircrafts with different telemetry system.
  28
  29 The baud rate selected must be the same as the one you have configured for your bluetooth modules. Also remember that once you modify the baud rate, next time you want to connect from the configurator you have to to select same baud rate value from the drop-down list before clicking on "Connect" button.
  30
  31 7.- **Configure automatic home**.
  32
  33 In case of not using Local GPS, and avoiding to use buttons to set home position, configure the following parameters in the Telemetry section:
  34
  35 Min Sats: 6 minimum, the higher, if your GPS takes many satellites, the better.
  36 Home: AUTO (From telemetry).
  37
  38 8.- **Configure start traking** parameters.
  39
  40 The default values for distance and altitude might be a bit high. Try 5 for distance and 2 for altitude. Remember that tracking will start when the aircraft has overcome that fence. Once it lands and returns within those limits, the tracking ends.
  41
  42 While the aircraft is within those limits, the menu and home buttons function as menu and home, so you may access the menu and change options, set and reset home, or change and set the data screen shown on the display. But when the aircraft is out of those limits, the tracking starts, and buttons now perform the function of offset trim, which acts on the parameter offset_trim (between -20 and 20 degrees). This value is displayed on the OLED (telemetry screen).
  43
  44 9.- **Configure PID**
  45
  46 By default, the antenna tracker has feature NOPID enabled. It works out of the box, and it is more than probability that it is not necessary to configure any of its parameters. With NOPID control enabled the tracking will experience a slight lag with respect the aircraft, especially if it receives position packets at a low frequency.
  47
  48 Yo can use NOPID control for simulations and first real flights. But if you want more precision you will have to properly configure the PID for pan servo. The will get into action once feature NOPID is disabled.
  49
  50 [<< Go back](README.md)