docs/configuration-tilt-servo.md

   1 # Tilt Servo and Function Documentation
   2
   3 ## Tilt Servo Control Functions
   4
   5 Before exploring the configuration, it's essential to understand the functions that control the tilt servo in the u360gts system. The tilt servo system consists of three essential components. The tilt angle is determined by calculating the vertical tilt angle based on relative altitude and distance between the target and tracker, with a maximum limit of 90 degrees. The tilt servo's position is updated to align with the desired angle, and it can apply smoothing for movement if enabled. Additionally, the system manages its activity, making decisions about whether the tracking system should be active or in a resting state. This includes functionalities such as telemetry loss detection and tracking decisions based on relative distance and altitude.
   6
   7 ## Tilt Servo Configuration
   8
   9 Here are the configuration parameters that allow you to customize the tilt servo's operation:
  10
  11 - **tilt_pin**
  12   - Type: Integer
  13   - Valid Range: 0 to 7
  14   - Defines the pin number used to control the tilt servo on your hardware.
  15
  16 - **tilt0**
  17   - Type: Integer
  18   - Valid Range: 0 to 3000
  19   - Configures the PWM value corresponding to the 0-degree position of the tilt servo on your hardware.
  20
  21 - **tilt90**
  22   - Type: Integer
  23   - Valid Range: 0 to 3000
  24   - Defines the PWM value corresponding to the 90-degree position of the tilt servo on your hardware.
  25
  26 - **tilt_max_angle**
  27   - Type: Integer
  28   - Valid Range: 0 to 90
  29   - Configures the maximum angle to which the tilt servo can be tilted. This limits the tilt range.
  30
  31 ## Easing Effect
  32
  33 The u360gts firmware provides a smoothing effect for the tilt servo's movement, especially useful for large antennas. This smoothing effect involves the tilt servo moving with deceleration towards the end, creating a damping effect.
  34
  35 The image below illustrates the smoothing effect for the "Easing Out Quart" function, one of the available options.
  36
  37 ![Image 2](assets/images/outquarteasing-1400x1011-74.jpg)
  38
  39 ### Activate the Easing Effect
  40 To activate the Easing smoothing effect, use the following command:
  41 ```plaintext
  42 feature easing
  43 ```
  44 ### Deactivate the Easing Effect
  45
  46 To deactivate the Easing smoothing effect, use the following command:
  47 ```
  48 feature -easing
  49 ```
  50
  51 The following parameters allow you to adjust the smoothing of the tilt servo's movement:
  52
  53 - **easing**
  54   - Type: Integer
  55   - Valid Values: 0, 1, 2, 3, 4 (see Easing Functions section)
  56   - Selects the type of smoothing function applied to the tilt servo's movement. Options include no smoothing and two different smoothing types.
  57
  58 - **easing_steps**
  59   - Type: Integer
  60   - Valid Range: 0 to 100
  61   - Defines the number of steps used in the smoothing function (if enabled). More steps result in smoother movement but may require more processing resources.
  62
  63 - **easing_min_angle**
  64   - Type: Integer
  65   - Valid Range: 1 to 10
  66   - Configures the minimum angle required for the smoothing function to be applied. This avoids smoothing small changes in the tilt angle.
  67
  68 - **easing_millis**
  69   - Type: Integer
  70   - Valid Range: 1 to 100
  71   - Sets the time in milliseconds during which the smoothing function is applied to the tilt servo's movement.
  72
  73 ## Easing Functions
  74
  75 The u360gts firmware provides several easing functions that allow you to control the smoothing effect applied to the tilt servo's movement. These functions affect the rate of change of the tilt angle during tracking. Below are the available easing functions:
  76
  77 ![Image 3](assets/images/easing-1400x1160-27.png)
  78
  79 - **Ease Out Quart (1)**
  80   - This easing function produces a smooth deceleration effect towards the end of the tilt servo's movement. It results in a damping effect.
  81
  82 - **Ease Out Circular (2)**
  83   - EASE_OUT_CIRC creates a more linear slowing down effect compared to the quart function.
  84
  85 - **Ease Out Exponential (3)**
  86   - EASE_OUT_EXPO results in an exponential deceleration effect, gradually slowing down the tilt servo.
  87
  88 - **Ease Out Cubic (4)**
  89   - EASE_OUT_CUBIC creates a cubic deceleration effect, gradually slowing down the tilt servo's movement.
  90
  91 You can choose one of these easing functions to control the smoothing effect during tilt servo movement by configuring the `easing` parameter.
  92
  93 Please refer to the firmware documentation for more details on configuring and using these easing functions.
  94
  95 [<< Go back](README.md)