Difference between revisions of "GeoLink Configuration"
(34 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
<languages /> | <languages /> | ||
+ | |||
== <translate><!--T:1--> | == <translate><!--T:1--> | ||
Line 5: | Line 6: | ||
<translate><!--T:2--> | <translate><!--T:2--> | ||
− | GeoLink is supported | + | Spirit GeoLink module is supported by all Spirit units. 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.</translate> | After enabling, save the settings and re-power the model.</translate> | ||
Line 21: | Line 22: | ||
How to check</translate> === | How to check</translate> === | ||
− | <translate><!--T:6--> | + | <translate><!--T:99--> |
− | To verify that GeoLink is calibrated correctly for your area, please launch the ''Spirit Settings'' and open ''GeoLink settings'' window. | + | If your model will start to do a circles around a spot it should fly, then it is clear mark that the Compass Calibration is required. |
+ | |||
+ | <!--T:6--> | ||
+ | To precisely 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. | At '''Info tab''' you can see current Heading value. | ||
Line 28: | Line 32: | ||
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. | 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. | Ideally compare to an analogue compass. | ||
− | |||
− | |||
− | |||
<!--T:8--> | <!--T:8--> | ||
− | When heading to '''North''', you should see approximately '''90 +/- 4°'''. Measured value should not be far from this.</translate> | + | 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.</translate> |
{{Info|[[File:Info.png|18px|]] <translate><!--T:9--> | {{Info|[[File:Info.png|18px|]] <translate><!--T:9--> | ||
Line 54: | Line 55: | ||
<!--T:14--> | <!--T:14--> | ||
− | # | + | #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. |
− | # | + | #Blue GeoLink LED will be indicating progress of the calibration. GeoLink v2 will light up also Green LED when calibration is ongoing. |
− | #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.< | + | #Start moving with the model in all possible directions and angles to mimic a sphere. When Blue LED will flash then it will indicate a new calibration data were acquired. |
+ | #Rotate with the module as long until you will see periodic Blue LED flashing. At this point the calibration is finished. Green LED light of the GeoLink v2 will be turned Off. After following re-power the module is ready for operation. | ||
+ | |||
+ | <!--T:111--> | ||
+ | Successful calibration will end up only with periodic GeoLink LED light flashing. If you will not reach to this point then model was not rotated to all directions. During next power up new calibration will be started. This will happen for next 2 times if calibration will be not finished. If it is not finished even for the 3rd time then original calibration data will be used. | ||
+ | </translate> | ||
+ | |||
{{Info|[[File:Info.png|18px|]] <translate><!--T:15--> | {{Info|[[File:Info.png|18px|]] <translate><!--T:15--> | ||
For 600+ class helicopters we recommend to perform calibration while GeoLink is not mounted. In that way it can be more comfortable and easier.</translate><br/>[[File:Info.png|18px|]] <translate><!--T:16--> | For 600+ class helicopters we recommend to perform calibration while GeoLink is not mounted. In that way it can be more comfortable and easier.</translate><br/>[[File:Info.png|18px|]] <translate><!--T:16--> | ||
Line 62: | Line 69: | ||
<p></p> | <p></p> | ||
{{Quote|<translate><!--T:17--> | {{Quote|<translate><!--T:17--> | ||
− | 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 | + | '''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.</translate>}} |
+ | === Calibration Video === | ||
+ | |||
+ | Here you can find video from the calibration process. | ||
+ | |||
+ | [https://www.youtube.com/watch?v=skH0u2yV6_M&t=6s&ab_channel=FrankFussenegger Example video from the Calibration process] | ||
== <translate><!--T:18--> | == <translate><!--T:18--> | ||
Line 69: | Line 81: | ||
<translate><!--T:19--> | <translate><!--T:19--> | ||
− | As the first step pilot has to decide what GeoLink feature he want to use | + | As the first step pilot has to decide what GeoLink feature he want to use. |
− | Pilot can enable multiple features at the same time if needed. | + | Pilot can enable multiple features at the same time if needed. They can be combined, however for initial verification we recommend to enable only one function at a time. |
<!--T:20--> | <!--T:20--> | ||
− | + | Enable feature you would like to use in the Aid tab of the GeoLink window by ticking the Checkbox. | |
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. | 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.</translate> | For the first tries we recommend to use a default values.</translate> | ||
Line 81: | Line 93: | ||
<translate><!--T:22--> | <translate><!--T:22--> | ||
− | You can verify if triggering mechanism is working correctly even before actual flight by checking the Aid tab. | + | You can verify if triggering mechanism for any feature 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'''.</translate> | If a feature is engaged you will see '''ACTIVE''' or in other case '''Inactive'''.</translate> | ||
{{Quote|<translate><!--T:23--> | {{Quote|<translate><!--T:23--> | ||
− | For safety reasons | + | For safety reasons turn off all GeoLink features before lift off. Then in a safe altitude you can enable the feature carefully. All features can be instantly disengaged at any moment so you can continue in a normal flight.</translate>}} |
Line 94: | Line 106: | ||
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. | 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.</translate> | We recommend to set Stabi/Function to '''Coaxial''' mode for Geo-fence, Return to Home and Position Hold features.</translate> | ||
+ | <translate><!--T:100--> | ||
+ | We recommend to use this way only when you are out of a free channels.</translate> | ||
==== <translate><!--T:26--> | ==== <translate><!--T:26--> | ||
− | Dedicated GeoLink channel</translate> ==== | + | Dedicated GeoLink channel [Recommended]</translate> ==== |
<translate><!--T:27--> | <translate><!--T:27--> | ||
− | + | More strightforward way is to 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: GeoLink 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.</translate> | You can use same channel for multiple features at the same time.</translate> | ||
[[File:geolink-channels.png|center|thumb]] | [[File:geolink-channels.png|center|thumb]] | ||
− | == | + | == GeoLink functions == |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | == | + | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
+ | === <translate><!--T:28--> | ||
+ | Geo-fence</translate> === | ||
− | + | <translate><!--T:101--> | |
− | + | This feature allows to restrict flying area so that when flying over the model will return. Pilot can set a virtual fence in which the model is allowed to fly.</translate> | |
− | + | Visit [[GeoLink_Geofence|Geo-fence page]] to see all details about the function. | |
− | + | ||
− | + | === <translate><!--T:34--> | |
+ | Altitude Limit</translate> === | ||
− | + | <translate><!--T:102--> | |
− | + | If you are worried you will forget to engage the Rescue mode in time, this feature is what you are looking for.</translate> | |
− | + | Visit [[GeoLink_Altitude_Limit|Altitude Limit page]] to see all details about the function. | |
− | + | ||
− | <!--T: | + | === <translate><!--T:39--> |
− | + | Return to Home</translate> === | |
− | + | ||
+ | <translate><!--T:103--> | ||
+ | Whenever you will loose orientation, this function is the best option. You have to only engage the function with your transmitter and wait until the model returns to a defined position. | ||
− | + | <!--T:104--> | |
− | + | Visit [[GeoLink_Return_to_Home|Return to Home page]] to see all details about the function.</translate> | |
− | <translate><!--T: | + | === <translate><!--T:105--> |
− | + | Auto Landing</translate> === | |
− | + | <translate><!--T:106--> | |
+ | Whenever you want to land with the model you can use this feature to do so automatically.</translate> | ||
− | + | Visit [[GeoLink_Auto_Landing|Auto Landing page]] to see all details about the function. | |
− | + | ||
− | <translate><!--T: | + | === <translate><!--T:52--> |
− | + | Position Hold</translate> === | |
− | <!--T: | + | <translate><!--T:107--> |
− | + | If you are learning the basics this feature can help you significantly in maintaining required spot. If you are not strong in hovering the feature will do the job for you.</translate> | |
− | + | ||
− | + | Visit [[GeoLink_Position_Hold|Position Hold page]] to see all details about the function. | |
− | + | ||
− | <translate><!--T: | + | === <translate><!--T:57--> |
− | + | Altitude Hold</translate> === | |
− | + | ||
− | <!--T: | + | <translate><!--T:108--> |
− | + | If pilot is unable to maintain altitude the feature can control collective pitch automatically for him.</translate> | |
− | + | Visit [[GeoLink_Altitude_Hold|Altitude Hold page]] to see all details about the function. | |
− | + | ||
== <translate><!--T:66--> | == <translate><!--T:66--> | ||
Line 310: | Line 188: | ||
<translate><!--T:71--> | <translate><!--T:71--> | ||
− | Vertical gain affects features such as Altitude Limit and Altitude Hold.</translate> | + | 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.</translate> |
Line 322: | Line 200: | ||
| style="width: 33%;text-align:center;"| [[#up|↑<translate><!--T:74--> | | style="width: 33%;text-align:center;"| [[#up|↑<translate><!--T:74--> | ||
Up</translate>↑]] | Up</translate>↑]] | ||
− | | style="text-align:right;" | [[<translate><!--T: | + | | style="text-align:right;" | [[<translate><!--T:109--> |
− | + | GeoLink_Logging</translate>|<translate><!--T:110--> | |
− | + | Logging</translate> →]] | |
|} | |} | ||
---- | ---- | ||
</div> | </div> |
Latest revision as of 14:38, 15 September 2022
Contents
1 GeoLink Support
Spirit GeoLink module is supported by all Spirit units. 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
If your model will start to do a circles around a spot it should fly, then it is clear mark that the Compass Calibration is required.
To precisely 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.
- 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.
- Blue GeoLink LED will be indicating progress of the calibration. GeoLink v2 will light up also Green LED when calibration is ongoing.
- Start moving with the model in all possible directions and angles to mimic a sphere. When Blue LED will flash then it will indicate a new calibration data were acquired.
- Rotate with the module as long until you will see periodic Blue LED flashing. At this point the calibration is finished. Green LED light of the GeoLink v2 will be turned Off. After following re-power the module is ready for operation.
Successful calibration will end up only with periodic GeoLink LED light flashing. If you will not reach to this point then model was not rotated to all directions. During next power up new calibration will be started. This will happen for next 2 times if calibration will be not finished. If it is not finished even for the 3rd time then original calibration data will be used.
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.
2.4 Calibration Video
Here you can find video from the calibration process.
Example video from the Calibration process
3 How to configure
As the first step pilot has to decide what GeoLink feature he want to use. Pilot can enable multiple features at the same time if needed. They can be combined, however for initial verification we recommend to enable only one function at a time.
Enable feature you would like to use in the Aid tab of the GeoLink window by ticking the Checkbox. 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 for any feature 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 turn off all GeoLink features before lift off. Then in a safe altitude you can enable the feature carefully. All features can be instantly disengaged at any moment so you can continue in a normal flight.
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. We recommend to use this way only when you are out of a free channels.
3.1.2 Dedicated GeoLink channel [Recommended]
More strightforward way is to 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: GeoLink 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 GeoLink functions
4.1 Geo-fence
This feature allows to restrict flying area so that when flying over the model will return. Pilot can set a virtual fence in which the model is allowed to fly.
Visit Geo-fence page to see all details about the function.
4.2 Altitude Limit
If you are worried you will forget to engage the Rescue mode in time, this feature is what you are looking for.
Visit Altitude Limit page to see all details about the function.
4.3 Return to Home
Whenever you will loose orientation, this function is the best option. You have to only engage the function with your transmitter and wait until the model returns to a defined position.
Visit Return to Home page to see all details about the function.
4.4 Auto Landing
Whenever you want to land with the model you can use this feature to do so automatically.
Visit Auto Landing page to see all details about the function.
4.5 Position Hold
If you are learning the basics this feature can help you significantly in maintaining required spot. If you are not strong in hovering the feature will do the job for you.
Visit Position Hold page to see all details about the function.
4.6 Altitude Hold
If pilot is unable to maintain altitude the feature can control collective pitch automatically for him.
Visit Altitude Hold page to see all details about the function.
5 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.
5.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.
5.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.