wiki/configuration-compass.md

   1 ## Compass
   2
   3 u360gts requires a compass sensor for tracking. When a compass is pressent, is calibrated and all configurator parameters which affects its behavior are properly configured, the antenna tracker will move automaticaly its heading to try to point to the gps position received from aircraft.
   4
   5
   6 ## Supported Sensors
   7
   8 In the moment of writting this document, u360gts supports only HMC5883L compass sensor. Supported boards with built in mag are HMC5883L. But if you need to install an external compass, you must select products with the chip marked as L883. Avoid buying sensors with chip marked as AD because they are not supported yet. To be sure about what you are buying you must ask the seller, because he might be providing not supported chips while in the product description is specified HMC5883L.
   9
  10 <img src="https://github.com/raul-ortega/u360gts/blob/master/wiki/img/supported_mag.jpg" width="525" />
  11
  12 u360gts firmware can detect the compass. To check if the compass of your board (or the external one) is the supported one, in CLI window of configurator type the command "status". The response will show HMC5883 if it is detected.
  13
  14 <img src="https://github.com/raul-ortega/u360gts/blob/master/wiki/img/CLI_status_mag.jpg" width="433" />
  15
  16
  17 ## Wiring
  18
  19 Take a look to [wiring schematics](https://github.com/raul-ortega/u360gts/blob/master/wiki/install-wiring-schematics.md) to get more information about how to connect an external mag.
  20
  21
  22 ## Configuration
  23
  24 ### Calibration
  25
  26 u360gts locks pan servo movement if the compass is not pressent or if its not calibrated. You may calibrate the compass at home for the first time, but some times might be necesary to calibrate it again in the flight field.
  27
  28 Note: Before mag calibration you should [configure the pan servo](https://github.com/raul-ortega/u360gts/blob/master/wiki/configuration-pan-servo.md).
  29
  30 To calibrate the compass from configurator go to Configuration -> Mag, and clic on Calibrate Mag button.
  31
  32 <img src="https://github.com/raul-ortega/u360gts/blob/master/wiki/img/mag_configuration.jpg" width="527" />
  33
  34 The controller will send the calibration pulse to the servo, and it will start spinning. During 10 seconds the controller will retrieve data from the sensor and will calculate magzero x, y and z values. Then the controller sends the stop pulse to the servo, it will stop spinning and calibration will be finished.
  35
  36 If you are using configurator version 4.0 or higher, than the "Calibration done" toggle button should be shown as on. If you are using an older version of the configurator, then check the box "calibrated".
  37
  38 **Note:** When calibration pulse is lower than central stop pulse, the tracker spins **counter clock wise** for the calibration process. And when calibration pulse is greater than stop pulse, the tracker spins clock wise. **If the tracker does not spin as described during compass calibration process**, then your **pan servop is reversed**. You may solve it executing these commands from CLI:
  39
  40 ```
  41 set pan_inverted=on
  42 save
  43 ```
  44
  45 Alternatively you may do a hardware mod which consist on inverting the polarity of the wires directly connected to the motor (do the mod under your own risk).**
  46
  47 ### Offset
  48
  49 When entering in configuration mode, the tracker tries to point to 0 degrees (north). If it does not, but you configured pan servo and and calibrated the mag, you will need to adjust offset parameter.
  50
  51 If you mounted the controller with the magnetometer aligned to north, you may not need to touch this parameter, unless you want to adjust it even better.
  52
  53 But if you mounted the controller in a different position, because you needed to place the micro usb connector to the side of the enclosure, then you need to configure this parameter.
  54
  55 e.g set offset to 90 if the board/mag is rotated 90 degrees.
  56
  57 ### External Mag Alignment
  58
  59 When using external mag, you have to be sure that the magnetometer is aligned with the arrow of the board pointing to the front and it is not placed upside down. If it is rotated and/or flipped, then you have to configure the align_mag parameter with one of this values:
  60
  61 DEFAULT
  62 CW0
  63 CW90
  64 CW180
  65 CW270
  66 CW0FLIP
  67 CW90FLIP
  68 CW180FLIP
  69 CW270FLIP
  70
  71
  72 ### Magnetic Declination
  73
  74 To change magnetic declination you have to set correct declination of your spesific location, which can be found [here](www.magnetic-declination.com).
  75
  76 If your magnetic declination readings are e.g. +3° 34' , the value entered in the u360gts configurator is 334. For west declination, use a minus value, e.g. for 1° 32' W, the value entered in the u360gts configurator is -132. In all cases (both CLI and GUI), the least significant digits are minutes, not decimal degrees.
  77
  78 [<< Go back](https://github.com/raul-ortega/u360gts/blob/master/wiki/index.md)