5.0 KiB
INav - Safehomes
Introduction
The "Home" position is used for the landing point when landing is enabled or in an emergency situation. It is usually determined by the GPS location where the aircraft is armed.
For airplanes, the landing procedure is explained very well by Pawel Spychalski here.
One potential risk when landing is that there might be buildings, trees and other obstacles in the way as the airplance circles lower toward the ground at the arming point. Most people don't go the middle of the field when arming their airplanes.
Safehome
Safehomes are a list of GPS coordinates that identify safe landing points. You can define up to 8 safehomes for different locations you fly at. When the flight controller is armed, it checks the list of safehomes. The nearest safehome that is enabled and within safehome_max_distance (default 200m) of the current position is identified. The arming home location remains as home.
When RTH is activated, whether by radio failsafe, or using the RTH radio control mode, the safehome identified during arming will replace the home location. If RTH is turned off, either by regaining radio control or turning off the RTH radio control mode, the home location will return back to arming point.
The safehome operating mode is set using safehome_usage_mode. If OFF, safehomes will not be used. If RTH, the safehome will replace the arming location when RTH is activated, either manually or because of RX failsafe. If RTH_FS, the safehome will only be used for RX failsafe. This option can be changed using the OSD menu.
If you frequently use RTH to return back to the arming point, you may not want the aircraft to fly to the safehome. Let it do this at least once to confirm safehomes is working as expected. Afterward, set safehome_usage_mode = RTH_FS and the safehome will only be used for failsafe.
When using mode RTH_FS, you should confirm that your radio's failsafe configuration triggers the iNav failsafe mode. With many receivers, you have the ability to specify what signal to output during failsafe conditions.
When you are choosing safehome locations, ensure that the location is clear of obstructions for a radius more than 50m (nav_fw_loiter_radius). As the plane descends, the circles aren't always symmetrical, as wind direction could result in some wider or tighter turns. Also, the direction and length of the final landing stage is also unknown. You want to choose a point that has provides a margin for variation and the final landing.
If your safehome is not visible from your current location, use extra caution. A visual check of the safehome is recommend prior to flying. If the safehome is in use, you can use the OSD menu to disable safehome usage prior to your flight.
OSD Message when Armed
When the aircraft is armed, the OSD briefly shows ARMED and the current GPS position and current date and time.
If a safehome is selected, an additional message appears:
H - DIST -> SAFEHOME n <- New message
n is the Safehome index (0-7)
ARMED DIST is the distance from
GPS LATITUDE your current position to this safehome
GPS LONGITUDE
GPS PLUS CODE
CURRENT DATE
CURRENT TIME
The GPS details are those of the arming location, not the safehome. To draw your attention to a safehome being selected, the message flashes and stays visible longer.
If a safehome was found, but ``safehome_usage_modeisOFF, the message SAFEHOME FOUND; MODE OFF``` will appear.
OSD Message during RTH
If RTH is in progress to a safehome, the message "DIVERTING TO SAFEHOME" will be displayed.
CLI command safehome to manage safehomes
safehome - List all safehomes
safehome reset - Clears all safehomes.
safehome <n> <enabled> <lat> <lon> - Set the parameters of a safehome with index <n>.
Parameters:
<enabled>- 0 is disabled, 1 is enabled.<lat>- Latitude (WGS84), in degrees * 1E7 (for example 123456789 means 12.3456789).<lon>- Longitude.
Note that coordinates from Google Maps only have five or six decimals, so you need to pad zero decimals until you have seven before removing the decimal period to set the correct safehome location. For example, coordinates 54.353319 -4.517927 obtained from Google Maps need to be entered as 543533190 -45179270, coordiniates 43.54648 -7.86545 as 435464800 -78654500 and 51.309842 -0.095651 as 513098420 -00956510.
Safehomes are saved along with your regular settings and will appear in diff and dump output. Use save to save any changes, as with other settings.
safehome example
# safehome
safehome 0 1 543533190 -45179270
safehome 1 1 435464800 -78654500
safehome 2 1 513098420 -00956510
safehome 3 0 0 0
safehome 4 0 0 0
safehome 5 0 0 0
safehome 6 0 0 0
safehome 7 0 0 0