/**************************************************************************** * * Copyright (c) 2013-2019 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 using namespace time_literals; class MulticopterRateControl : public ModuleBase, public ModuleParams, public px4::WorkItem { public: MulticopterRateControl(bool vtol = false); ~MulticopterRateControl() 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; /** * initialize some vectors/matrices from parameters */ void parameters_updated(); void updateActuatorControlsStatus(const actuator_controls_s &actuators, float dt); void publishTorqueSetpoint(const matrix::Vector3f &torque_sp, const hrt_abstime ×tamp_sample); void publishThrustSetpoint(const hrt_abstime ×tamp_sample); RateControl _rate_control; ///< class for rate control calculations uORB::Subscription _battery_status_sub{ORB_ID(battery_status)}; uORB::Subscription _landing_gear_sub{ORB_ID(landing_gear)}; uORB::Subscription _manual_control_setpoint_sub{ORB_ID(manual_control_setpoint)}; uORB::Subscription _control_allocator_status_sub{ORB_ID(control_allocator_status)}; uORB::Subscription _v_control_mode_sub{ORB_ID(vehicle_control_mode)}; uORB::Subscription _v_rates_sp_sub{ORB_ID(vehicle_rates_setpoint)}; uORB::Subscription _vehicle_angular_acceleration_sub{ORB_ID(vehicle_angular_acceleration)}; uORB::Subscription _vehicle_land_detected_sub{ORB_ID(vehicle_land_detected)}; uORB::Subscription _vehicle_status_sub{ORB_ID(vehicle_status)}; uORB::SubscriptionInterval _parameter_update_sub{ORB_ID(parameter_update), 1_s}; uORB::SubscriptionCallbackWorkItem _vehicle_angular_velocity_sub{this, ORB_ID(vehicle_angular_velocity)}; uORB::Publication _actuators_0_pub; uORB::Publication _actuator_controls_status_0_pub{ORB_ID(actuator_controls_status_0)}; uORB::PublicationMulti _controller_status_pub{ORB_ID(rate_ctrl_status)}; uORB::Publication _v_rates_sp_pub{ORB_ID(vehicle_rates_setpoint)}; uORB::Publication _vehicle_thrust_setpoint_pub{ORB_ID(vehicle_thrust_setpoint)}; uORB::Publication _vehicle_torque_setpoint_pub{ORB_ID(vehicle_torque_setpoint)}; orb_advert_t _mavlink_log_pub{nullptr}; vehicle_control_mode_s _v_control_mode{}; vehicle_status_s _vehicle_status{}; bool _actuators_0_circuit_breaker_enabled{false}; /**< circuit breaker to suppress output */ bool _landed{true}; bool _maybe_landed{true}; float _battery_status_scale{0.0f}; perf_counter_t _loop_perf; /**< loop duration performance counter */ matrix::Vector3f _rates_sp; /**< angular rates setpoint */ float _thrust_sp{0.0f}; /**< thrust setpoint */ hrt_abstime _last_run{0}; int8_t _landing_gear{landing_gear_s::GEAR_DOWN}; float _energy_integration_time{0.0f}; float _control_energy[4] {}; DEFINE_PARAMETERS( (ParamFloat) _param_mc_rollrate_p, (ParamFloat) _param_mc_rollrate_i, (ParamFloat) _param_mc_rr_int_lim, (ParamFloat) _param_mc_rollrate_d, (ParamFloat) _param_mc_rollrate_ff, (ParamFloat) _param_mc_rollrate_k, (ParamFloat) _param_mc_pitchrate_p, (ParamFloat) _param_mc_pitchrate_i, (ParamFloat) _param_mc_pr_int_lim, (ParamFloat) _param_mc_pitchrate_d, (ParamFloat) _param_mc_pitchrate_ff, (ParamFloat) _param_mc_pitchrate_k, (ParamFloat) _param_mc_yawrate_p, (ParamFloat) _param_mc_yawrate_i, (ParamFloat) _param_mc_yr_int_lim, (ParamFloat) _param_mc_yawrate_d, (ParamFloat) _param_mc_yawrate_ff, (ParamFloat) _param_mc_yawrate_k, (ParamFloat) _param_mpc_man_y_max, /**< scaling factor from stick to yaw rate */ (ParamFloat) _param_mc_acro_r_max, (ParamFloat) _param_mc_acro_p_max, (ParamFloat) _param_mc_acro_y_max, (ParamFloat) _param_mc_acro_expo, /**< expo stick curve shape (roll & pitch) */ (ParamFloat) _param_mc_acro_expo_y, /**< expo stick curve shape (yaw) */ (ParamFloat) _param_mc_acro_supexpo, /**< superexpo stick curve shape (roll & pitch) */ (ParamFloat) _param_mc_acro_supexpoy, /**< superexpo stick curve shape (yaw) */ (ParamBool) _param_mc_bat_scale_en, (ParamInt) _param_cbrk_rate_ctrl ) matrix::Vector3f _acro_rate_max; /**< max attitude rates in acro mode */ };