/**************************************************************************** * * Copyright (c) 2013-2023 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. * ****************************************************************************/ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include using matrix::Eulerf; using matrix::Quatf; using uORB::SubscriptionData; using namespace time_literals; class FixedwingRateControl final : public ModuleBase, public ModuleParams, public px4::ScheduledWorkItem { public: FixedwingRateControl(bool vtol = false); ~FixedwingRateControl() override; /** @see ModuleBase */ static int task_spawn(int argc, char *argv[]); /** @see ModuleBase */ static int custom_command(int argc, char *argv[]); /** @see ModuleBase */ static int print_usage(const char *reason = nullptr); bool init(); private: void Run() override; uORB::SubscriptionCallbackWorkItem _vehicle_angular_velocity_sub{this, ORB_ID(vehicle_angular_velocity)}; uORB::SubscriptionInterval _parameter_update_sub{ORB_ID(parameter_update), 1_s}; uORB::Subscription _battery_status_sub{ORB_ID(battery_status)}; uORB::Subscription _manual_control_setpoint_sub{ORB_ID(manual_control_setpoint)}; uORB::Subscription _rates_sp_sub{ORB_ID(vehicle_rates_setpoint)}; uORB::Subscription _vehicle_control_mode_sub{ORB_ID(vehicle_control_mode)}; uORB::Subscription _vehicle_land_detected_sub{ORB_ID(vehicle_land_detected)}; uORB::Subscription _vehicle_status_sub{ORB_ID(vehicle_status)}; uORB::Subscription _vehicle_rates_sub{ORB_ID(vehicle_angular_velocity)}; uORB::SubscriptionMultiArray _control_allocator_status_subs{ORB_ID::control_allocator_status}; uORB::SubscriptionData _airspeed_validated_sub{ORB_ID(airspeed_validated)}; uORB::Publication _actuator_controls_status_pub; uORB::Publication _rate_sp_pub{ORB_ID(vehicle_rates_setpoint)}; uORB::PublicationMulti _rate_ctrl_status_pub{ORB_ID(rate_ctrl_status)}; uORB::Publication _vehicle_thrust_setpoint_pub; uORB::Publication _vehicle_torque_setpoint_pub; uORB::Publication _flaps_setpoint_pub{ORB_ID(flaps_setpoint)}; uORB::Publication _spoilers_setpoint_pub{ORB_ID(spoilers_setpoint)}; manual_control_setpoint_s _manual_control_setpoint{}; vehicle_control_mode_s _vcontrol_mode{}; vehicle_thrust_setpoint_s _vehicle_thrust_setpoint{}; vehicle_torque_setpoint_s _vehicle_torque_setpoint{}; vehicle_rates_setpoint_s _rates_sp{}; vehicle_status_s _vehicle_status{}; perf_counter_t _loop_perf; hrt_abstime _last_run{0}; float _airspeed_scaling{1.0f}; bool _landed{true}; float _battery_scale{1.0f}; float _energy_integration_time{0.0f}; float _control_energy[4] {}; float _control_prev[3] {}; bool _in_fw_or_transition_wo_tailsitter_transition{false}; // only run the FW attitude controller in these states // enum for bitmask of VT_FW_DIFTHR_EN parameter options enum class VTOLFixedWingDifferentialThrustEnabledBit : int32_t { YAW_BIT = (1 << 0), ROLL_BIT = (1 << 1), PITCH_BIT = (1 << 2), }; param_t _handle_param_vt_fw_difthr_en{PARAM_INVALID}; int32_t _param_vt_fw_difthr_en{0}; DEFINE_PARAMETERS( (ParamFloat) _param_fw_acro_x_max, (ParamFloat) _param_fw_acro_y_max, (ParamFloat) _param_fw_acro_z_max, (ParamInt) _param_fw_acro_yaw_en, (ParamFloat) _param_fw_airspd_max, (ParamFloat) _param_fw_airspd_min, (ParamFloat) _param_fw_airspd_stall, (ParamFloat) _param_fw_airspd_trim, (ParamBool) _param_fw_use_airspd, (ParamInt) _param_fw_arsp_scale_en, (ParamBool) _param_fw_bat_scale_en, (ParamFloat) _param_fw_dtrim_p_vmax, (ParamFloat) _param_fw_dtrim_p_vmin, (ParamFloat) _param_fw_dtrim_r_vmax, (ParamFloat) _param_fw_dtrim_r_vmin, (ParamFloat) _param_fw_dtrim_y_vmax, (ParamFloat) _param_fw_dtrim_y_vmin, (ParamFloat) _param_fw_man_p_sc, (ParamFloat) _param_fw_man_r_sc, (ParamFloat) _param_fw_man_y_sc, (ParamFloat) _param_fw_pr_ff, (ParamFloat) _param_fw_pr_i, (ParamFloat) _param_fw_pr_imax, (ParamFloat) _param_fw_pr_p, (ParamFloat) _param_fw_pr_d, (ParamFloat) _param_fw_rll_to_yaw_ff, (ParamFloat) _param_fw_rr_ff, (ParamFloat) _param_fw_rr_i, (ParamFloat) _param_fw_rr_imax, (ParamFloat) _param_fw_rr_p, (ParamFloat) _param_fw_rr_d, (ParamFloat) _param_fw_yr_ff, (ParamFloat) _param_fw_yr_i, (ParamFloat) _param_fw_yr_imax, (ParamFloat) _param_fw_yr_p, (ParamFloat) _param_fw_yr_d, (ParamFloat) _param_trim_pitch, (ParamFloat) _param_trim_roll, (ParamFloat) _param_trim_yaw, (ParamInt) _param_fw_spoilers_man ) RateControl _rate_control; ///< class for rate control calculations void updateActuatorControlsStatus(float dt); /** * Update our local parameter cache. */ int parameters_update(); void vehicle_manual_poll(); void vehicle_land_detected_poll(); float get_airspeed_and_update_scaling(); };