Understanding LAND Message in ArduPilot: Tuning Your Drone's Landing

TL;DR: The ArduPilot LAND message signifies a transition from flight to landing, triggered by parameters such as COM_DISARM_LAND set to 1. To optimize landing performance, adjust key parameters in the land detector configuration.

What is the LAND Message?

The LAND message in ArduPilot indicates that the drone is transitioning from flight to landing. This message is essential for ensuring smooth and controlled landings, allowing the autopilot to manage descent properly.

MSG LAND
TimeUS
Mode
Rsn

- TimeUS: Timestamp of the message. - Mode: Current flight mode (should be LAND). - Rsn: Reason for landing, indicating how the landing was initiated (e.g., pilot command, failsafe).

Key Takeaway: The LAND message is crucial for understanding the drone's landing behavior and identifying how it entered the landing mode.

Confirming it in Mission Planner

To confirm the LAND message in Mission Planner, navigate through the following sequence: 1. Open **Flight Data**. 2. Click on **DataFlash Logs** in the left sidebar. 3. Select **Review a Log** to load the desired log file. When analyzing the log, plot the following fields together to gain insights into landing behavior: - Plot MSG to see the landing messages. - Plot CTUN.Alt to observe altitude changes during descent. - Plot CTUN.ThO to analyze throttle output during landing.

Key Takeaway: Using Mission Planner, you can visualize the LAND message alongside altitude and throttle data to assess landing performance.

Confirming it in MAVExplorer

In MAVExplorer, you can visualize landing data using the following command:

MAV> graph MSG.Rsn CTUN.Alt

This command will plot the reason for landing alongside altitude changes. Analyzing this plot can help identify the circumstances under which the drone landed, providing valuable context for tuning landing performance.

Key Takeaway: MAVExplorer facilitates a deeper understanding of the landing process by allowing you to visualize key variables alongside the LAND message.

Why the LAND Message Happened — Ranked by What We See Most Often

Understanding the common causes of the LAND message can help you troubleshoot landing issues effectively:

1. Pilot Command: The most frequent cause is a manual command from the pilot, indicated by MODE Rsn=1. This means the pilot initiated the landing process intentionally.
2. Failsafe Activation: Automatic landings can occur due to various failsafe conditions. For example, low battery conditions may trigger MODE Rsn=4, prompting a safe landing.
3. Mission Completion: If the drone completes its mission, it may transition to land, marked by MODE Rsn=8. This indicates that the drone has reached the end of its planned route.
4. Throttle Command Loss: If the throttle command drops below FS_THR_VALUE, it can trigger landing. This is indicative of a loss of control signal.
5. Altitude Breach: If the drone exceeds its altitude limits due to incorrect configuration, it may trigger an auto-landing as a precaution.

Key Takeaway: Recognizing the reasons why the LAND message appears helps in diagnosing and addressing landing issues effectively.

Fixes for Optimizing Your Drone's Landing Behavior

To improve landing performance, consider the following remediation steps:

1. Set COM_DISARM_LAND = 1 to enable auto-disarming upon landing to ensure the drone is safely disarmed after touchdown.
2. Adjust FS_THR_VALUE = 975 to define the throttle threshold for triggering the failsafe. Ensure this value is appropriate for your receiver's output.
3. Review LAND_SPEED to manage descent speed. Adjust it for smoother landings based on your drone's characteristics.
4. Ensure BATT_LOW_VOLT is configured correctly to prevent premature landings due to battery warnings.
5. Fine-tune EK3_POS_I_GATE to set innovation gates for altitude, which can enhance altitude hold during landing.

Key Takeaway: These parameter adjustments can significantly improve the effectiveness and safety of your drone's landing behavior.

When This Isn't Actually a LAND Message

It’s essential to be aware of conditions that may appear similar but do not indicate a LAND message: - A sudden drop in altitude without LAND may be a result of a crash or loss of control, not a planned landing. - An unexpected transition could be due to an EKF failsafe, indicated by MODE Rsn=6, rather than a landing initiated by the pilot. - The presence of GPS_GLITCH messages may indicate issues that cause erratic behavior leading to unplanned landings.

Key Takeaway: Distinguishing genuine LAND messages from other events helps prevent misdiagnosis and unnecessary adjustments.

When LogHat Helps — and When It Doesn't

LogHat excels in analyzing logs to identify patterns and anomalies related to landing behaviors, providing insights into how adjustments can be made for improved performance. However, it cannot directly troubleshoot physical hardware issues or environmental factors affecting landing, such as wind conditions or terrain challenges.

Key Takeaway: While LogHat is a powerful tool for log analysis, it should be complemented with practical testing and field assessments for optimal drone performance.

What does the LAND message indicate in ArduPilot?

It indicates the drone's transition from flight to landing, either manually initiated by the pilot or triggered by a failsafe condition.

How can I improve my drone's landing performance?

By tuning key parameters within the land detector configuration, such as COM_DISARM_LAND and FS_THR_VALUE.

What happens if my drone lands unexpectedly?

Unexpected landings can be caused by a variety of factors, including low battery, signal loss, or EKF failsafes. Reviewing logs is essential for diagnosing these issues.

How can I confirm my drone is set to land properly in Mission Planner?

In Mission Planner, use the DataFlash Logs to review the LAND message and plot fields like CTUN.Alt and CTUN.ThO for insights.

What should I do if my drone's landing behavior is erratic?

Review and adjust key parameters, particularly those related to the land detector configuration, to ensure stable landings.

How does the LAND message relate to the failsafe system?

The LAND message can be triggered by failsafe conditions, indicating that the drone is landing due to low battery or other critical errors.

What is the significance of MODE Rsn values in the LAND message?

MODE Rsn values indicate the reason for landing, helping diagnose how and why the drone transitioned to landing mode.

For drone engineers and enthusiasts alike, tuning your drone's landing behavior is critical for safe operations. Utilize LogHat to analyze your flight logs, and make the necessary adjustments to optimize performance. With the right configurations, you can ensure stable, reliable landings every time.