mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-07-25 13:57:42 +08:00
* feat(commander): add traffic avoidance system failsafe * test(commander): add tests for traffic avoidance failsafe * docs(parameters): add COM_ARM_TRAFF migration notes * fix(failsafe): use a shared header instead of hard-coding enum literals * fix(commander): clear stale traffic avoidance unhealthy flag when check disabled * refactor(failsafe): rename failsafe_mode_params.h to failsafe_action_modes.h * docs(adsb_flarm): fix formatting in traffic avoidance parameter table --------- Co-authored-by: Claudio Chies <chiesc@chies.com>
82 lines
3.4 KiB
C++
82 lines
3.4 KiB
C++
/****************************************************************************
|
|
*
|
|
* Copyright (c) 2026 PX4 Development Team. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
* 3. Neither the name PX4 nor the names of its contributors may be
|
|
* used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
|
|
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
|
|
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
|
|
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
|
|
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
|
|
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
|
|
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
****************************************************************************/
|
|
|
|
#include "trafficAvoidanceCheck.hpp"
|
|
|
|
#include "../../failsafe/failsafe_action_modes.h"
|
|
|
|
void TrafficAvoidanceChecks::checkAndReport(const Context &context, Report &reporter)
|
|
{
|
|
const auto mode = static_cast<traffic_avoidance::FailsafeMode>(_param_com_traff_avoid.get());
|
|
const bool enabled = traffic_avoidance::isEnabled(mode);
|
|
|
|
// Always update the flag, so that disabling the check also clears a previously-set flag
|
|
reporter.failsafeFlags().traffic_avoidance_unhealthy = enabled
|
|
&& !context.status().traffic_avoidance_system_present;
|
|
|
|
if (!enabled) {
|
|
return;
|
|
}
|
|
|
|
if (!context.status().traffic_avoidance_system_present) {
|
|
const bool block_arming = traffic_avoidance::blocksArming(mode);
|
|
const NavModes nav_modes = block_arming ? NavModes::All : NavModes::None;
|
|
const events::Log log_level = block_arming ? events::Log::Error : events::Log::Warning;
|
|
|
|
/* EVENT
|
|
* @description
|
|
* Traffic avoidance system (ADSB/FLARM) failed to report. Make sure it is setup and connected properly.
|
|
*
|
|
* <profile name="dev">
|
|
* Configured by <param>COM_TRAFF_AVOID</param> parameter.
|
|
* </profile>
|
|
*/
|
|
reporter.healthFailure(nav_modes, health_component_t::traffic_avoidance,
|
|
events::ID("check_traffic_avoidance_missing"),
|
|
log_level, "Traffic avoidance system missing");
|
|
|
|
if (reporter.mavlink_log_pub()) {
|
|
if (block_arming) {
|
|
mavlink_log_critical(reporter.mavlink_log_pub(), "Preflight Fail: Traffic avoidance system missing");
|
|
|
|
} else {
|
|
mavlink_log_warning(reporter.mavlink_log_pub(), "Traffic avoidance system missing");
|
|
}
|
|
}
|
|
}
|
|
|
|
if (context.status().traffic_avoidance_system_present) {
|
|
reporter.setIsPresent(health_component_t::traffic_avoidance);
|
|
}
|
|
}
|