/* This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ #pragma once #include #include #include #include #include class AP_VisualOdom_Backend; #define AP_VISUALODOM_TIMEOUT_MS 300 class AP_VisualOdom { public: friend class AP_VisualOdom_Backend; AP_VisualOdom(); // get singleton instance static AP_VisualOdom *get_singleton() { return _singleton; } // external position backend types (used by _TYPE parameter) enum AP_VisualOdom_Type { AP_VisualOdom_Type_None = 0, AP_VisualOdom_Type_MAV = 1 }; // The VisualOdomState structure is filled in by the backend driver struct VisualOdomState { Vector3f angle_delta; // attitude delta (in radians) of most recent update Vector3f position_delta; // position delta (in meters) of most recent update uint64_t time_delta_usec; // time delta (in usec) between previous and most recent update float confidence; // confidence expressed as a value from 0 (no confidence) to 100 (very confident) uint32_t last_sensor_update_ms; // system time (in milliseconds) of last update from sensor uint32_t last_processed_sensor_update_ms; // timestamp of last sensor update that was processed }; // detect and initialise any sensors void init(); // should be called really, really often. The faster you call // this the lower the latency of the data fed to the estimator. void update(); // return true if sensor is enabled bool enabled() const; // return true if sensor is basically healthy (we are receiving data) bool healthy() const; // return a 3D vector defining the position offset of the camera in meters relative to the body frame origin const Vector3f &get_pos_offset(void) const { return _pos_offset; } // consume data from MAVLink messages void handle_msg(mavlink_message_t *msg); static const struct AP_Param::GroupInfo var_info[]; private: static AP_VisualOdom *_singleton; // state accessors const Vector3f &get_angle_delta() const { return _state.angle_delta; } const Vector3f &get_position_delta() const { return _state.position_delta; } uint64_t get_time_delta_usec() const { return _state.time_delta_usec; } float get_confidence() const { return _state.confidence; } uint32_t get_last_update_ms() const { return _state.last_sensor_update_ms; } // parameters AP_Int8 _type; AP_Vector3f _pos_offset; // position offset of the camera in the body frame AP_Int8 _orientation; // camera orientation on vehicle frame // reference to backends AP_VisualOdom_Backend *_driver; // state of backend VisualOdomState _state; }; namespace AP { AP_VisualOdom *visualodom(); };