MAV'RIC
|
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 ahrs.hpp 00034 * 00035 * \author MAV'RIC Team 00036 * \author Gregoire Heitz 00037 * \author Julien Lecoeur 00038 * 00039 * \brief Interface for the estimated Attitude and Heading Reference System 00040 * 00041 ******************************************************************************/ 00042 00043 00044 #ifndef AHRS_HPP_ 00045 #define AHRS_HPP_ 00046 00047 #include <cstdint> 00048 #include <cstdbool> 00049 #include <array> 00050 00051 #include "util/coord_conventions.hpp" /* coord_conventions_get_yaw */ 00052 00053 extern "C" 00054 { 00055 #include "util/quaternions.h" 00056 } 00057 00061 class AHRS 00062 { 00063 public: 00064 00068 enum ahrs_state_t 00069 { 00070 AHRS_INITIALISING = 0, 00071 AHRS_LEVELING = 1, 00072 AHRS_CONVERGING = 2, 00073 AHRS_READY = 3, 00074 }; 00075 00081 virtual bool update(void) = 0; 00082 00083 00089 virtual float last_update_s(void) const = 0; 00090 00091 00099 virtual bool is_healthy(void) const = 0; 00100 00101 00107 virtual quat_t attitude(void) const = 0; 00108 00109 00115 virtual std::array<float,3> angular_speed(void) const = 0; 00116 00117 00123 virtual std::array<float,3> linear_acceleration(void) const = 0; 00124 00125 00131 virtual float yaw() const 00132 { 00133 return coord_conventions_get_yaw(attitude()); 00134 } 00135 00136 }; 00137 00138 #endif /* AHRS_HPP_ */