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 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_ */