/**************************************************************************** * * 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. * ****************************************************************************/ /** * @file ControlAllocator.hpp * * Control allocator. * * @author Julien Lecoeur */ #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 class ControlAllocator : public ModuleBase, public ModuleParams, public px4::WorkItem { public: ControlAllocator(); virtual ~ControlAllocator(); /** @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); /** @see ModuleBase::print_status() */ int print_status() override; void Run() override; bool init(); static constexpr uint8_t NUM_ACTUATORS = ControlAllocation::NUM_ACTUATORS; static constexpr uint8_t NUM_AXES = ControlAllocation::NUM_AXES; private: /** * initialize some vectors/matrices from parameters */ void parameters_updated(); void update_allocation_method(); void update_effectiveness_source(); void update_effectiveness_matrix_if_needed(bool force = false); void publish_actuator_setpoint(); void publish_control_allocator_status(); void publish_legacy_actuator_controls(); void publish_legacy_multirotor_motor_limits(); enum class AllocationMethod { NONE = -1, PSEUDO_INVERSE = 0, SEQUENTIAL_DESATURATION = 1, }; AllocationMethod _allocation_method_id{AllocationMethod::NONE}; ControlAllocation *_control_allocation{nullptr}; ///< class for control allocation calculations enum class EffectivenessSource { NONE = -1, MULTIROTOR = 0, STANDARD_VTOL = 1, TILTROTOR_VTOL = 2, }; EffectivenessSource _effectiveness_source_id{EffectivenessSource::NONE}; ActuatorEffectiveness *_actuator_effectiveness{nullptr}; ///< class providing actuator effectiveness // Inputs uORB::SubscriptionCallbackWorkItem _vehicle_torque_setpoint_sub{this, ORB_ID(vehicle_torque_setpoint)}; /**< vehicle torque setpoint subscription */ uORB::SubscriptionCallbackWorkItem _vehicle_thrust_setpoint_sub{this, ORB_ID(vehicle_thrust_setpoint)}; /**< vehicle thrust setpoint subscription */ // Outputs uORB::Publication _vehicle_actuator_setpoint_pub{ORB_ID(vehicle_actuator_setpoint)}; /**< actuator setpoint publication */ uORB::Publication _control_allocator_status_pub{ORB_ID(control_allocator_status)}; /**< actuator setpoint publication */ uORB::Publication _actuator_motors_pub{ORB_ID(actuator_motors)}; uORB::Publication _actuator_servos_pub{ORB_ID(actuator_servos)}; uORB::SubscriptionInterval _parameter_update_sub{ORB_ID(parameter_update), 1_s}; uORB::Subscription _airspeed_sub{ORB_ID(airspeed)}; /**< airspeed subscription */ matrix::Vector3f _torque_sp; matrix::Vector3f _thrust_sp; // float _battery_scale_factor{1.0f}; // float _airspeed_scale_factor{1.0f}; perf_counter_t _loop_perf; /**< loop duration performance counter */ hrt_abstime _last_run{0}; hrt_abstime _timestamp_sample{0}; DEFINE_PARAMETERS( (ParamInt) _param_ca_airframe, (ParamInt) _param_ca_method, (ParamBool) _param_ca_bat_scale_en, (ParamBool) _param_ca_air_scale_en, (ParamFloat) _param_ca_act0_min, (ParamFloat) _param_ca_act1_min, (ParamFloat) _param_ca_act2_min, (ParamFloat) _param_ca_act3_min, (ParamFloat) _param_ca_act4_min, (ParamFloat) _param_ca_act5_min, (ParamFloat) _param_ca_act6_min, (ParamFloat) _param_ca_act7_min, (ParamFloat) _param_ca_act8_min, (ParamFloat) _param_ca_act9_min, (ParamFloat) _param_ca_act10_min, (ParamFloat) _param_ca_act11_min, (ParamFloat) _param_ca_act12_min, (ParamFloat) _param_ca_act13_min, (ParamFloat) _param_ca_act14_min, (ParamFloat) _param_ca_act15_min, (ParamFloat) _param_ca_act0_max, (ParamFloat) _param_ca_act1_max, (ParamFloat) _param_ca_act2_max, (ParamFloat) _param_ca_act3_max, (ParamFloat) _param_ca_act4_max, (ParamFloat) _param_ca_act5_max, (ParamFloat) _param_ca_act6_max, (ParamFloat) _param_ca_act7_max, (ParamFloat) _param_ca_act8_max, (ParamFloat) _param_ca_act9_max, (ParamFloat) _param_ca_act10_max, (ParamFloat) _param_ca_act11_max, (ParamFloat) _param_ca_act12_max, (ParamFloat) _param_ca_act13_max, (ParamFloat) _param_ca_act14_max, (ParamFloat) _param_ca_act15_max ) };