MAV'RIC
/home/travis/build/lis-epfl/MAVRIC_Library/drivers/gps.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 gps.hpp
00034  *
00035  * \author MAV'RIC Team
00036  * \author Julien Lecoeur
00037  *
00038  * \brief Abstract class for GPS
00039  *
00040  ******************************************************************************/
00041 
00042 
00043 #ifndef GPS_HPP_
00044 #define GPS_HPP_
00045 
00046 #include <cstdint>
00047 #include <cstdbool>
00048 #include <array>
00049 
00050 #include "util/coord_conventions.hpp"
00051 
00052 
00053 typedef enum
00054 {
00055     FIX_ERR  = 0,
00056     FIX_NONE = 1,
00057     FIX_2D   = 2,
00058     FIX_3D   = 3,
00059     FIX_DGPS = 4,
00060     FIX_RTK  = 5,
00061 } gps_fix_t;
00062 
00066 class Gps
00067 {
00068 public:
00075     virtual bool update(void) = 0;
00076 
00082     virtual bool init(void) = 0;
00083 
00084 
00088     virtual void configure(void) = 0;
00089 
00090 
00096     virtual float last_update_us(void) const = 0;
00097 
00098 
00104     virtual float last_position_update_us(void) const = 0;
00105 
00106 
00112     virtual float last_velocity_update_us(void) const = 0;
00113 
00114 
00120     virtual global_position_t position_gf(void) const = 0;
00121 
00122 
00128     virtual float horizontal_position_accuracy(void) const = 0;
00129 
00130 
00136     virtual float vertical_position_accuracy(void) const = 0;
00137 
00138 
00144     virtual std::array<float, 3> velocity_lf(void) const = 0;
00145 
00146 
00152     virtual float velocity_accuracy(void) const = 0;
00153 
00154 
00160     virtual float heading(void) const = 0;
00161 
00162 
00168     virtual float heading_accuracy(void) const = 0;
00169 
00170 
00176     virtual uint8_t num_sats(void) const = 0;
00177 
00178 
00184     virtual gps_fix_t fix(void) const = 0;
00185 
00186 
00192     virtual bool healthy(void) const = 0;
00193 };
00194 
00195 
00199 static inline bool task_gps_update(Gps* gps)
00200 {
00201     return gps->update();
00202 };
00203 
00204 #endif /* GPS_HPP_ */
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Friends Defines