MAV'RIC
/home/travis/build/lis-epfl/MAVRIC_Library/mission/mission_handler_landing.hpp
00001 /*******************************************************************************
00002  * Copyright (c) 2009-2016, MAV'RIC Development Team
00003  * All rights reserved.
00004  *
00005  * Redistribution and use in source and binary forms, with or without
00006  * modification, are permitted provided that the following conditions are met:
00007  *
00008  * 1. Redistributions of source code must retain the above copyright notice,
00009  * this list of conditions and the following disclaimer.
00010  *
00011  * 2. Redistributions in binary form must reproduce the above copyright notice,
00012  * this list of conditions and the following disclaimer in the documentation
00013  * and/or other materials provided with the distribution.
00014  *
00015  * 3. Neither the name of the copyright holder nor the names of its contributors
00016  * may be used to endorse or promote products derived from this software without
00017  * specific prior written permission.
00018  *
00019  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00020  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00021  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00022  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
00023  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00024  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
00025  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
00026  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
00027  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
00028  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
00029  * POSSIBILITY OF SUCH DAMAGE.
00030  ******************************************************************************/
00031 
00032 /*******************************************************************************
00033  * \file mission_handler_landing.hpp
00034  *
00035  * \author MAV'RIC Team
00036  * \author Matthew Douglas
00037  * \author Julien Lecoeur
00038  *
00039  * \brief The mission handler for the landing state
00040  *
00041  ******************************************************************************/
00042 
00043 
00044 #ifndef MISSION_HANDLER_LANDING_HPP_
00045 #define MISSION_HANDLER_LANDING_HPP_
00046 
00047 #include "status/state.hpp"
00048 #include "mission/mission_handler.hpp"
00049 
00050 /*
00051  * \brief The mission handler for the landing state
00052  */
00053 class Mission_handler_landing : public Mission_handler
00054 {
00055 public:
00059     typedef enum
00060     {
00061         DESCENT_TO_SMALL_ALTITUDE,                          
00062         DESCENT_TO_GND                                      
00063     } auto_landing_behavior_t;
00064 
00068     struct conf_t
00069     {
00070         float LPF_gain;                                     
00071         float desc_to_ground_altitude;                      
00072         float desc_to_ground_range;                         
00073     };
00074 
00075 
00083      Mission_handler_landing(   const INS& ins,
00084                                 State& state,
00085                                 conf_t config = default_config());
00086 
00087 
00098     virtual bool can_handle(const Waypoint& wpt) const;
00099 
00100 
00110     virtual bool setup(const Waypoint& wpt);
00111 
00112 
00122     virtual Mission_handler::update_status_t update();
00123 
00124 
00130     virtual bool write_flight_command(Flight_controller& flight_controller) const;
00131 
00132 
00138     virtual Mission_planner::internal_state_t handler_mission_state() const;
00139 
00140 
00146     static inline conf_t default_config();
00147 
00148 protected:
00149     Waypoint waypoint_;                                         
00150     bool is_landed_;                                            
00151     auto_landing_behavior_t auto_landing_behavior_;             
00152     float alt_lpf_;                                             
00153     float LPF_gain_;                                            
00154     float desc_to_ground_altitude_;                             
00155     float desc_to_ground_range_;                                
00156 
00157     const INS& ins_;                                            
00158     State& state_;                                              
00159 
00166     virtual bool write_desc_to_small_alt_flight_command(Flight_controller& flight_controller) const;
00167 
00174     virtual bool write_desc_to_ground_flight_command(Flight_controller& flight_controller) const;
00175 };
00176 
00177 
00178 Mission_handler_landing::conf_t Mission_handler_landing::default_config()
00179 {
00180     conf_t conf                                      = {};
00181 
00182     conf.LPF_gain                                    = 0.9f;
00183     conf.desc_to_ground_altitude                     = -5.0f;
00184     conf.desc_to_ground_range                        = 0.5f;
00185 
00186     return conf;
00187 };
00188 
00189 #endif // MISSION_HANDLER_LANDING_HPP_
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Defines