Docs: fix incorrect 10m-above-home motor shutoff condition in LAND mode#7589
Docs: fix incorrect 10m-above-home motor shutoff condition in LAND mode#7589hritikkumar07 wants to merge 2 commits intoArduPilot:masterfrom
Conversation
|
this isn't related to the issue you mentionned |
| approximately one second: | ||
|
|
||
| - Motors are commanded to their lower limit by the vertical position controller | ||
| - Throttle mix is at minimum (``is_throttle_mix_min``) |
There was a problem hiding this comment.
what is this variable doing here ?
| - The airframe is not accelerating (earth-frame accel ≈ 0) | ||
| - Vertical speed is within 1 m/s of zero | ||
| - If a healthy rangefinder is available: altitude is below 2m | ||
| - Weight-on-Wheels (WoW) sensor (if present) confirms contact or is unknown |
There was a problem hiding this comment.
Disagree, Copter has Weight on Wheels landing gear feature and is used in code....this is correct
There was a problem hiding this comment.
If present confirm contact or is unknown?
That means nothing and isn't what we got on the code
There was a problem hiding this comment.
this code is in the path
#if AP_LANDINGGEAR_ENABLED
const bool WoW_check = (landinggear.get_wow_state() == AP_LandingGear::LG_WOW || landinggear.get_wow_state() == AP_LandingGear::LG_WOW_UNKNOWN);
#else
const bool WoW_check = true;
#endif
SET_LOG_FLAG(WoW_check, LandDetectorLoggingFlag::WOW);
if (motor_at_lower_limit && throttle_mix_at_min && !large_angle_request && !large_angle_error && accel_stationary && descent_rate_low && rangefinder_check && WoW_check)
There was a problem hiding this comment.
That english sentence isn't good. If you don't know what it is , you cannot understand
I don't think we should details strictly the code, just say something like WoW trigger
For example we don't say if rangefinder is present with data valid over 3 consecutive read under 2m etc.
Adding a note with reference to the landing detector file would be interesting too, so people can check in doubt
There was a problem hiding this comment.
Grammarly states that it is understandable in English, but could be improved:
"The Weight-on-Wheels (WoW) sensor (if present) confirms ground contact or has an unknown status."
And having general user noticeable effects listed is fine in my opinion, as long as they are not confusing to the user....and this user noticed some
| - Throttle mix is at minimum (``is_throttle_mix_min``) | ||
| - No large angle is being requested (roll/pitch target < 15°) | ||
| - No large angle error exists (attitude error < 30°) | ||
| - The airframe is not accelerating (earth-frame accel ≈ 0) |
There was a problem hiding this comment.
let's be accurate here"
| - The airframe is not accelerating (earth-frame accel ≈ 0) | |
| - The airframe is not accelerating downward > 1m/s/s ( >2 m/s/s if Weight on Wheels feature is enabled) |
Hwurzburg
left a comment
There was a problem hiding this comment.
fixed which issues this closes
| - No large angle error exists (attitude error < 30°) | ||
| - The airframe is not accelerating (earth-frame accel ≈ 0) | ||
| - Vertical speed is within 1 m/s of zero | ||
| - If a healthy rangefinder is available: altitude is below 2m |
There was a problem hiding this comment.
| - If a healthy rangefinder is available: altitude is below 2m | |
| - If a healthy rangefinder is available, and rangefinder altitude is below 2m |
| - Throttle mix is at minimum (``is_throttle_mix_min``) | ||
| - No large angle is being requested (roll/pitch target < 15°) | ||
| - No large angle error exists (attitude error < 30°) | ||
| - The airframe is not accelerating (earth-frame accel ≈ 0) |
There was a problem hiding this comment.
let's be accurate here"
| - The airframe is not accelerating (earth-frame accel ≈ 0) | |
| - The airframe is not accelerating downward > 1m/s/s ( >2 m/s/s if Weight on Wheels feature is enabled) |
| - No large angle is being requested (roll/pitch target < 15°) | ||
| - No large angle error exists (attitude error < 30°) | ||
| - The airframe is not accelerating (earth-frame accel ≈ 0) | ||
| - Vertical speed is within 1 m/s of zero |
There was a problem hiding this comment.
and here
| - Vertical speed is within 1 m/s of zero | |
| - Vertical speed is within 1 m/s of zero ( within 2 m/s if Weight on Wheels feature is enabled) |
|
|
Others are making changes in this area. Unless you update with the requested changes so I can merge, it will also need conflict resolution... |
Fixes #7577
Fixes #7574
The Note block incorrectly states that motor shutoff requires the copter
to be below 10m above home altitude. After reading land_detector.cpp,
no such check exists in update_land_detector().
LAND_ALT_LOW_M (10m default) only controls the descent speed transition
from LAND_SPD_HIGH_MS to LAND_SPD_MS, not the disarm condition.
Updated the Note block to reflect the actual landing detection conditions.