Difference between revisions of "GeoLink Configuration"

Revision as of 13:47, 21 December 2020

1 GeoLink Support

GeoLink is supported from firmware version 2.5. In order to utilize all the functions it is necessary to enable the support in the Spirit Settings - General tab first. After enabling, save the settings and re-power the model.

2 Compass Calibration

All GeoLink modules were fully tested and calibrated. The only thing pilot might need is to re-calibrate Compass. Compass is crucial for determining heading of the model for a proper navigation through space. Compass is sensing Earth's magnetic field (Geomagnetic field) and in this way it can determine heading at any time. Unfortunately Geomagnetic field is different everywhere. Thus if model will be operated outside the Czech Republic it is highly recommended to perform New Calibration. GeoLink modules are factory calibrated for the Czech Republic.

2.1 How to check

To verify that GeoLink is calibrated correctly for your area, please launch the Spirit Settings and open GeoLink settings window. At Info tab you can see current Heading value.

Please place the model or just GeoLink to the North as close as possible, so that flight direction of the model is front of the arrow. Ideally compare to an analogue compass.

When heading to North, you should see approximately 90 +/- 4°. Measured value should not be far from this. If so, please perform Compass Calibration again.

We recommend to not use a smart devices for compass heading comparison. These are usually not calibrated at all nor allow the calibration. An analogue compass is the best for comparison.

2.2 Odd behavior

If Compass calibration is wrong you will notice that features such as Geo-fence, Return to Home, Position Hold are not working precisely. For example when Return to Home is engaged and model reached programmed Home position, the model could move in a circle manner around that spot, instead of stable hovering. The bigger is circle, the bigger is Compass heading error. If you can observe this behavior always, then it is clear sign that you need to re-calibrate the Compass.

2.3 Calibration process

In order to perform the calibration it is necessary to enter Spirit Settings/GeoLink/Module and click the Calibration request button. Now you can disconnect power and USB interface cable from the model.

1. During following power up of the model you will immediately notice 3 series of rapid LED flashing on the GeoLink. This always signalize module is in the Calibration mode.
2. The Status LED will be indicating progress of the calibration then. Start moving with the model in all possible directions and angles to mimic a sphere. Any LED flash will indicate that a new calibration data were acquired.
3. Rotate with the module as long until you will see periodic LED flashing. At this point the calibration is finished. After following re-power the module is ready for operation.
   

For 600+ class helicopters we recommend to perform calibration while GeoLink is not mounted. In that way it can be more comfortable and easier.
Calibration should be done ideally at the flying field but can be performed usually indoor as well.

Spirit Setings will not see GeoLink during Calibration mode. Calibration will not finish until it is fully done. If power is turned off while calibration is not finished, the calibration process will start from the beginning after next power up.

3 How to configure

As the first step pilot has to decide what GeoLink feature he want to use. To find how each feature is working please visit Features page. Pilot can enable multiple features at the same time if needed.

Check feature you would like to use in the Aid tab of the GeoLink window. After enabling, available parameters for the particular feature will be accessible. By these parameters behavior of selected feature can be customized to fulfill a needs. For the first tries we recommend to use a default values.

3.1 Triggering

You can verify if triggering mechanism is working correctly even before actual flight by checking the Aid tab. If a feature is engaged you will see ACTIVE or in other case Inactive.

For safety reasons do not engage any GeoLink feature before model is in the air at appropriate altitude.

3.1.1 Stabi function

By default all GeoLink features are engaged as soon as a Stabi function is active. For example if Coaxial or Rescue mode is engaged the GeoLink feature is engaged as well and complement operation of a Stabi function by acting simultaneously. We recommend to set Stabi/Function to Coaxial mode for Geo-fence, Return to Home and Position Hold features.

3.1.2 Dedicated GeoLink channel

Alternatively you can assign a GeoLink feature to any free channel in the General/Channels window. In the right part of the Spirit Settings software select which feature you would like to assign. (for example F: Return to Home). Then select appropriate channel which will be used for engaging. You can use same channel for multiple features at the same time.

4 Geo-fence

To enable this feature it is required to tick the CheckBox in the GeoLink window/Aid tab.

4.1 Usage

The feature can be engaged at any given time by a command from your radio. It is important to decide in which way the feature can be engaged as there are two options.

1. To engage with Stabi function - in this case the feature is engaged when programmed Stabi function is engaged. This mean you do not need to assign any other switch than when used for e.g. Stabilisation mode
2. To engage with assigned GeoLink channel - it is required to assign F: GeoLink Geo-fence function in the General/Channels to an available channel.

Please make sure that Geo-fence Area was defined. Four points must be programmed. The Spirit Settings will display right order to program all points.

4.2 Modes

If Geo-fence is engaged by assigned GeoLink channel there is possibility to use tri-state switch also for programming of a new Geo-fence area. In the Channels window you will be able to see Function as On (1), Off and On (2) which is corresponding to 100%, 0% and -100% channel value.

When On (1) is displayed it mean that at this point Geo-fence is engaged and flight area is restricted. The model will return upon exceeding the area to the center of the area. Then pilot have to touch the aileron or elevator stick in order to continue in flight.

When On (2) is displayed the unit is in a programming mode which allow to overwrite current Geo-fence to the new with position at which the model currently is. Please note that it will not work if model is flying or if GNSS signal is very weak.

4.3 New Geo-fence programming

It is possible to program the Geo-fence either with the Spirit Settings by selecting 4 points at the Map. Or there is possibility to use GeoLink channel to do so even if you are out of a computer.

If assigned GeoLink channel is used you have to set On (2) function state and keep it on for at least 2 seconds. At this period Status LED of the Spirit unit will turn off and after 2 seconds new Geo-fence point is programmed. Pilot has to define four points that will determine new area. To program all four points pilot have to engage the programming four times. Only once all points are programmed the Status LED of the Spirit unit will turn On which will signalize success. New area is applied immediately.

5 Altitude Limit

To enable this feature it is required to tick the CheckBox in the GeoLink window/Aid tab.

5.1 Usage

The feature can be engaged at any given time by a command from your radio. It is important to decide in which way the feature can be engaged as there are two options.

1. To engage with Stabi function - in this case the feature is engaged when programmed Stabi function is engaged. This mean you do not need to assign any other switch than when used for e.g. Stabilisation mode
2. To engage with assigned GeoLink channel - it is required to assign F: GeoLink Altitude Limit function in the General/Channels to an available channel.

5.1.1 Triggering Acceleration

This parameter is key for engaging the Rescue mode fast enough if your model is approaching towards the ground. The faster is descending velocity, the faster the Rescue is engaged. This mean that the Rescue can be engaged above configured Minimum limit to save the model safely. If model is approaching the Minimum limit slowly then the rescue is engaged at configured level. Low Triggering Acceleration value is causing only minor difference.

6 Return to Home

To enable this feature it is required to tick the CheckBox in the GeoLink window/Aid tab.

6.1 Usage

The feature can be engaged at any given time by a command from your radio. It is important to decide in which way the feature can be engaged as there are two options.

1. To engage with Stabi function - in this case the feature is engaged when programmed Stabi function is engaged. This mean you do not need to assign any other switch than when used for e.g. Stabilisation mode
2. To engage with assigned GeoLink channel - it is required to assign F: GeoLink Return to Home function in the General/Channels to an available channel.

Please make sure that Home spot was defined in the Map tab.

6.2 Modes

If Return to Home is engaged by assigned GeoLink channel there is possibility to use tri-state switch also for programming of a new Home spot. In the Channels window you will be able to see Function as On and Off states. When Off is visible the feature is not used in any sense. When On is visible you can enter several modes of the feature.

6.2.1 On (1)

Channel value 57% - 100% : When On (1) is displayed it mean that at this point Return to Home is engaged and model will move to the Home spot. This is what you might want to engage during flight.

6.2.2 On (2)

Channel value -100% - -62% : When On (2) is displayed the unit is in a programming mode which allow to overwrite current Home spot to the new with position at which the model currently is. Change will affect all Banks - if used. Please note that it will not work if model is flying or if GNSS signal is very weak.

6.2.3 On (3)

Channel value -61% - -38% : When On (3) is displayed the unit is in a programming mode which allow to overwrite current Home spot to the new with position at which the model currently is. Change will only active Bank - if Bank Switching is used. Please note that it will not work if model is flying or if GNSS signal is very weak.

6.2.4 On (4)

Channel value 27% - 56% : When On (4) is displayed it mean that at this point Return to Home is engaged and model will move to the Take-Off position. Take-Off position is programmed automatically during each Take-Off. This mode can be used stright with no Home position programming.

6.3 New Home position

It is possible to program the Home position either with the Spirit Settings by selecting a point at the Map. Or there is possibility to use GeoLink channel to do so even if you are out of a computer.

If assigned GeoLink channel is used you have to set On (2) function state and keep it on for at least 2 seconds. At this period Status LED of the Spirit unit will turn off and after 2 seconds new Home position is programmed. Once finished the LED must turn On again.

7 Auto Landing

To enable this feature it is required to tick the CheckBox in the GeoLink window/Aid tab.

In order to make the landing as safe as possible set the Landing Speed value. We recommend to start with a low values and increase it to a speed that is suitable for the model. With too high value the landing might be too hard. Default value of 25̤̤% should work well for the most models.

7.1 Usage

The feature can be engaged at any given time by a command from your radio. It is important to decide in which way the feature can be engaged as there are two options.

1. To engage with Stabi function - in this case the feature is engaged when programmed Stabi function is engaged. This mean you do not need to assign any other switch than when used for e.g. Stabilisation mode
2. To engage with assigned GeoLink channel - it is required to assign F: GeoLink Auto Landing function in the General/Channels to an available channel.

8 Position Hold

To enable this feature it is required to tick the CheckBox in the GeoLink window/Aid tab.

8.1 Usage

The feature can be engaged at any given time by a command from your radio. It is important to decide in which way the feature can be engaged as there are two options.

1. To engage with Stabi function - in this case the feature is engaged when programmed Stabi function is engaged. This mean you do not need to assign any other switch than when used for e.g. Stabilisation mode
2. To engage with assigned GeoLink channel - it is required to assign F: GeoLink Position Hold function in the General/Channels to an available channel.

9 Altitude Hold

To enable this feature it is required to tick the CheckBox in the GeoLink window/Aid tab.

9.1 Usage

The feature can be engaged at any given time by a command from your radio. It is important to decide in which way the feature can be engaged as there are two options.

1. To engage with Stabi function - in this case the feature is engaged when programmed Stabi function is engaged. This mean you do not need to assign any other switch than when used for e.g. Stabilisation mode
2. To engage with assigned GeoLink channel - it is required to assign F: GeoLink Altitude Hold function in the General/Channels to an available channel.

9.2 Modes

If Altitude Hold is engaged by assigned GeoLink channel there is possibility to use tri-state switch also for disabling Collective Pitch input. In the Channels window you will be able to see Function as On (1), Off and On (2) which is corresponding to 100%, 0% and -100% channel value.

When On (1) is displayed it mean that altitude in which the feature was engaged will be held. Pilot is still able to change Collective Pitch, but in a limited manner. Collective Pitch reaction will be slower than in a normal flight mode.

When On (2) is displayed it mean that altitude in which the feature was engaged will be held. Pilot is unable to change Collective Pitch by pitch stick. So that Collective Pitch steering is fixed and is changed only by GeoLink in order to hold right altitude.

10 Correction Gains

GeoLink features are doing a certain movements to achieve desired position of the model. These movements are small corrections which are dependent on parameters of the model. For very agile models these correction can be smaller. While for heavy and big models you might need bigger in order to reduce time required to achieve desired position.

10.1 Horiontal Gain

Horizontal gain affects features such as Geo-fence, Return To Home and Position Hold. For example if Return to Home feature is engaged and it takes too long to return at programmed home spot it is necessary to increase Horizontal correction. Too high value will result in excess (too visible) corrections even when model is maintaining spot on position.

10.2 Vertical Gain

Vertical gain affects features such as Altitude Limit and Altitude Hold. When model is oscillating in altitude it is necessary to decrease value until it will stop. It is recommended to adjust and check the behavior in no wind. Too high value will result in a more apparent oscillations. Starting with default gains is advised.