MAV'RIC
/home/travis/build/lis-epfl/MAVRIC_Library/sensing/ahrs.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 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_ */
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Defines